20644: Implement Camera API

Co-authored-by: Han T. <[email protected]>

Author: andy-chhuon

.changeset/slimy-foxes-hide.md

@@ -0,0 +1,5 @@
+---
+'@shopify/ui-extensions': minor
+---
+
+Add Camera API types

packages/ui-extensions/src/surfaces/point-of-sale/api.ts

@@ -14,6 +14,13 @@ export type {ActionApi, ActionApiContent} from './api/action-api/action-api';
 export type {StandardApi} from './api/standard/standard-api';
 export type {ActionTargetApi} from './api/action-target-api/action-target-api';
 
+export type {
+  CameraApi,
+  CameraApiContent,
+  CameraMediaOptions,
+  CameraMediaResponse,
+} from './api/camera-api/camera-api';
+
 export type {
   ConnectivityStateSeverity,
   ConnectivityState,

packages/ui-extensions/src/surfaces/point-of-sale/api/action-target-api/action-target-api.ts

@@ -1,7 +1,9 @@
 import {ScannerApi} from '../scanner-api/scanner-api';
 import {StandardApi} from '../standard/standard-api';
+import {CameraApi} from '../camera-api/camera-api';
 
 export type ActionTargetApi<T> = {[key: string]: any} & {
   extensionPoint: T;
 } & StandardApi<T> &
-  ScannerApi;
+  ScannerApi &
+  CameraApi;

packages/ui-extensions/src/surfaces/point-of-sale/api/camera-api/camera-api.ts

@@ -0,0 +1,51 @@
+export interface CameraMediaOptions {
+  /**
+   * The camera that will be active when the camera interface first opens.
+   * - `'user'`: The front-facing camera
+   * - `'environment'`: The rear-facing camera
+   * @defaultValue 'environment'
+   */
+  facingMode?: 'user' | 'environment';
+  /**
+   * The maximum width (0 to 1080) of the image in pixels. Resizes the image to this width if it is larger.
+   * @defaultValue 1080
+   */
+  maxWidth?: number;
+  /**
+   * The maximum height (0 to 1080) of the image in pixels. Resizes the image to this height if it is larger.
+   * @defaultValue 1080
+   */
+  maxHeight?: number;
+  /**
+   * The quality of the image returned. Percentile value between 0 and 1.
+   * @defaultValue 0.9
+   */
+  quality?: number;
+}
+
+export interface CameraMediaResponse {
+  /** The image data as base64 string. */
+  base64: string;
+  /** The width of the image in pixels. */
+  width: number;
+  /** The height of the image in pixels. */
+  height: number;
+  /** The file size of the image in bytes. */
+  fileSize: number;
+  /** The MIME type of the image. */
+  type: string;
+}
+
+export interface CameraApiContent {
+  /**
+   * Launch the device's camera to take a photo.
+   *
+   * @param options the options for the camera media.
+   * @returns Promise<CameraMediaResponse> that resolves when the POS has necessary permissions to access the camera and the media is captured.
+   */
+  takePhoto: (options?: CameraMediaOptions) => Promise<CameraMediaResponse>;
+}
+
+export interface CameraApi {
+  camera: CameraApiContent;
+}