feat: add barcode scanner plugin (#536)

plugins/barcode-scanner/guest-js/index.ts

@@ -0,0 +1,75 @@
+// Copyright 2019-2023 Tauri Programme within The Commons Conservancy
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-License-Identifier: MIT
+
+import { invoke } from "@tauri-apps/api/tauri";
+
+export type PermissionState = "granted" | "denied" | "prompt";
+
+export enum Format {
+  QRCode = "QR_CODE",
+  UPC_A = "UPC_A",
+  UPC_E = "UPC_E",
+  EAN8 = "EAN_8",
+  EAN13 = "EAN_13",
+  Code39 = "CODE_39",
+  Code93 = "CODE_93",
+  Code128 = "CODE_128",
+  Codabar = "CODABAR",
+  ITF = "ITF",
+  Aztec = "AZTEC",
+  DataMatrix = "DATA_MATRIX",
+  PDF417 = "PDF_417",
+}
+
+export interface ScanOptions {
+  cameraDirection?: "back" | "front";
+  formats?: Format[];
+  windowed?: boolean;
+}
+
+export interface Scanned {
+  content: string;
+  format: Format;
+  bounds: unknown;
+}
+
+/**
+ * Start scanning.
+ * @param options
+ */
+export async function scan(options?: ScanOptions): Promise<Scanned> {
+  return await invoke("plugin:barcodeScanner|scan", { ...options });
+}
+
+/**
+ * Cancel the current scan process.
+ */
+export async function cancel(): Promise<void> {
+  return await invoke("plugin:barcodeScanner|cancel");
+}
+
+/**
+ * Get permission state.
+ */
+export async function checkPermissions(): Promise<PermissionState> {
+  return await invoke<{ camera: PermissionState }>(
+    "plugin:barcodeScanner|checkPermissions",
+  ).then((r) => r.camera);
+}
+
+/**
+ * Request permissions to use the camera.
+ */
+export async function requestPermissions(): Promise<PermissionState> {
+  return await invoke<{ camera: PermissionState }>(
+    "plugin:barcodeScanner|requestPermissions",
+  ).then((r) => r.camera);
+}
+
+/**
+ * Open application settings. Useful if permission was denied and the user must manually enable it.
+ */
+export async function openAppSettings(): Promise<void> {
+  return await invoke("plugin:barcodeScanner|openAppSettings");
+}