@incodetech/core 2.1.0-rc.1 → 2.1.0-rc.2

package/dist/document-capture.esm.js

@@ -1,16 +1,16 @@
-import "./WasmUtilProvider-BKWm8rSA.esm.js";
-import "./api-CESGtpbH.esm.js";
-import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-Dvvriq9l.esm.js";
-import "./endpoints-BeTK0Mlt.esm.js";
-import "./platform-SKvEfCBh.esm.js";
-import { c as createManager, s as createActor } from "./xstate.esm-C9wncMQa.esm.js";
-import "./MotionSensorProvider-Bx7Mpzt0.esm.js";
-import "./permissionServices-Doec4X5L.esm.js";
-import "./camera-DJWm3V4g.esm.js";
-import "./ITimerCapability-CB0I1Uf2.esm.js";
-import "./backCameraStream-D7Wo4Nbx.esm.js";
-import "./permissionGuards-D0wGddy7.esm.js";
-import { n as DOCUMENT_CAPTURE_ERROR_CODES, t as documentCaptureMachine } from "./documentCaptureStateMachine-CUTUzUw_.esm.js";
+import "./WasmUtilProvider-CIu373BZ.esm.js";
+import "./api-DUZwyz0o.esm.js";
+import { n as eventModuleNames, o as topLevelStateName, s as createManagerInstrumentation } from "./events-DN-u67gb.esm.js";
+import "./endpoints-BM2_j_IE.esm.js";
+import "./platform-BfoqeM61.esm.js";
+import { c as createManager, s as createActor } from "./xstate.esm-Dkm1jy5u.esm.js";
+import "./MotionSensorProvider-C9fPAJdS.esm.js";
+import "./permissionServices-CPDboRoE.esm.js";
+import "./camera-x4LjGTjZ.esm.js";
+import "./ITimerCapability-BvH0pDwp.esm.js";
+import "./backCameraStream-iftkf3rd.esm.js";
+import "./permissionGuards-D-Z-lgNj.esm.js";
+import { n as DOCUMENT_CAPTURE_ERROR_CODES, t as documentCaptureMachine } from "./documentCaptureStateMachine-MpwpJO7t.esm.js";
 
 //#region src/modules/document-capture/documentCaptureActor.ts
 function createDocumentCaptureActor(options) {
@@ -19,6 +19,66 @@ function createDocumentCaptureActor(options) {
 
 //#endregion
 //#region src/modules/document-capture/documentCaptureManager.ts
+/**
+* Maps a document-capture state-machine snapshot to the exact Figma
+* "Tracked Events" screen name. Source: POA / Document Capture Figma file
+* (`https://www.figma.com/design/cbFXiChmJ8cWQDHwVghBqJ/Document-Capture---Latest-Design?node-id=5140-36443`).
+* Family is `documentCapture.*` with three sub-families:
+*
+* - `documentCapture.tutorial.*` — tutorial / next-page surfaces.
+* - `documentCapture.capture.*` — camera capture path (when
+*   `config.captureMode === 'camera'`).
+* - `documentCapture.upload.*` — file upload path (when
+*   `config.captureMode === 'file'`).
+* - `documentCapture.errors.*` — recoverable / exhausted error surfaces.
+*
+* The mapper returns Figma-verbatim strings (e.g.
+* `'documentCapture.upload.reviewFile'`) which the adapter emits as-is on
+* `event.screen`. See `docs/patterns/INSTRUMENTATION.md` for the contract.
+*
+* Figma sub-states the state machine does not surface as discrete states
+* (intentionally not mapped here — they collapse into the section's primary
+* screen until the SM surfaces them):
+*
+* - `documentCapture.tutorial.{default,uploadOnlySelector,methodSelectionWeb,nativeMethodSelectionOnWeb,methodSelectionNative}`
+*   — UI sub-states of the tutorial step driven by config or platform. The
+*   SM only knows `captureMode`, not the explicit selector or platform
+*   variant; the mapper collapses these onto `tutorial.captureOnly` (camera)
+*   and `tutorial.uploadOnly` (file).
+* - `documentCapture.capture.{filled,commonIssues}` — UI sub-states of
+*   `capturing` (file selected / common issues hint).
+* - `documentCapture.upload.{selectFromLibrary,selectFromFiles}` — the SM
+*   has a single `capturing` state for file mode that collapses these.
+* - `documentCapture.errors.noConnection` — requires network-error
+*   classification at the `failure` boundary; not yet wired.
+*
+* `permissions`/`initCamera`/`finalizing` are intentionally unmapped — the
+* Figma canvas does not define screens for them and falling back to the
+* generic `<module>.<state>` default is the better signal for analytics.
+* `closed` is intentionally unmapped (terminal user-dismissed state —
+* handled by `moduleClosed`).
+*/
+function getDocumentCaptureScreenName(snapshot) {
+	const stateName = topLevelStateName(snapshot.value);
+	if (stateName === void 0) return void 0;
+	const isFileMode = snapshot.context.config.captureMode === "file";
+	switch (stateName) {
+		case "tutorial": return isFileMode ? "documentCapture.tutorial.uploadOnly" : "documentCapture.tutorial.captureOnly";
+		case "capturing": return isFileMode ? "documentCapture.upload.selectFromFiles" : "documentCapture.capture.default";
+		case "preview": return isFileMode ? "documentCapture.upload.reviewFile" : "documentCapture.capture.reviewPhoto";
+		case "uploading": return isFileMode ? "documentCapture.upload.analyzing" : "documentCapture.capture.analyzing";
+		case "success":
+		case "finished": return isFileMode ? "documentCapture.upload.success" : "documentCapture.capture.success";
+		case "failure": return (snapshot.context.attemptsRemaining ?? 0) > 0 ? "documentCapture.errors.genericError" : "documentCapture.errors.genericErrorExhausted";
+		case "nextPage": {
+			const nextPageType = snapshot.context.nextPageType;
+			if (nextPageType === "required") return "documentCapture.tutorial.nextPageMandatory";
+			if (nextPageType === "optional") return "documentCapture.tutorial.nextPageOptional";
+			return;
+		}
+		default: return;
+	}
+}
 function getPermissionStatus(snapshot) {
 	if (snapshot.matches({ permissions: "learnMore" })) return "learnMore";
 	if (snapshot.matches({ permissions: "requesting" })) return "requesting";
@@ -174,7 +234,10 @@ function createDocumentCaptureManager(options) {
 		actor: createDocumentCaptureActor(options),
 		mapState,
 		createApi,
-		instrumentation: createManagerInstrumentation(eventModuleNames.document, { getErrorPayload: getDocumentCaptureErrorPayload })
+		instrumentation: createManagerInstrumentation(eventModuleNames.document, {
+			getEventScreenName: getDocumentCaptureScreenName,
+			getErrorPayload: getDocumentCaptureErrorPayload
+		})
 	});
 }
 

package/dist/document-upload.d.ts

@@ -1,11 +1,11 @@
-import { t as Manager } from "./Manager-BHn8wH8K.js";
-import "./Actor-Y0_Fj-KL.js";
-import "./camera-SRBpPq2X.js";
-import { n as DocumentUploadContext, r as DocumentUploadInput, t as DocumentUploadConfig } from "./types-Bj9hdFjU.js";
-import * as xstate294 from "xstate";
+import { t as Manager } from "./Manager-B2OEDYqf.js";
+import "./Actor-fIPLXfoi.js";
+import "./camera-biGPWlmx.js";
+import { n as DocumentUploadContext, r as DocumentUploadInput, t as DocumentUploadConfig } from "./types-Z9wv19v2.js";
+import * as xstate593 from "xstate";
 
 //#region src/modules/document-upload/documentUploadStateMachine.d.ts
-declare const documentUploadMachine: xstate294.StateMachine<DocumentUploadContext, {
+declare const documentUploadMachine: xstate593.StateMachine<DocumentUploadContext, {
   type: "START";
 } | {
   type: "CAPTURE";
@@ -18,52 +18,52 @@ declare const documentUploadMachine: xstate294.StateMachine<DocumentUploadContex
 } | {
   type: "CLOSE";
 }, {
-  [x: string]: xstate294.ActorRefFromLogic<xstate294.PromiseActorLogic<void, {
+  [x: string]: xstate593.ActorRefFromLogic<xstate593.PromiseActorLogic<void, {
     imageBase64: string;
     documentType: string;
     onProgress: (progress: number) => void;
-  }, xstate294.EventObject>> | xstate294.ActorRefFromLogic<xstate294.PromiseActorLogic<MediaStream, void, xstate294.EventObject>> | undefined;
-}, xstate294.Values<{
+  }, xstate593.EventObject>> | xstate593.ActorRefFromLogic<xstate593.PromiseActorLogic<MediaStream, void, xstate593.EventObject>> | undefined;
+}, xstate593.Values<{
   uploadDocument: {
     src: "uploadDocument";
-    logic: xstate294.PromiseActorLogic<void, {
+    logic: xstate593.PromiseActorLogic<void, {
       imageBase64: string;
       documentType: string;
       onProgress: (progress: number) => void;
-    }, xstate294.EventObject>;
+    }, xstate593.EventObject>;
     id: string | undefined;
   };
   initCamera: {
     src: "initCamera";
-    logic: xstate294.PromiseActorLogic<MediaStream, void, xstate294.EventObject>;
+    logic: xstate593.PromiseActorLogic<MediaStream, void, xstate593.EventObject>;
     id: string | undefined;
   };
-}>, xstate294.Values<{
+}>, xstate593.Values<{
   setError: {
     type: "setError";
-    params: xstate294.NonReducibleUnknown;
-  };
-  clearError: {
-    type: "clearError";
-    params: xstate294.NonReducibleUnknown;
+    params: xstate593.NonReducibleUnknown;
   };
   setStream: {
     type: "setStream";
-    params: xstate294.NonReducibleUnknown;
+    params: xstate593.NonReducibleUnknown;
   };
   setImageAndClearError: {
     type: "setImageAndClearError";
-    params: xstate294.NonReducibleUnknown;
+    params: xstate593.NonReducibleUnknown;
   };
   setProgress: {
     type: "setProgress";
-    params: xstate294.NonReducibleUnknown;
+    params: xstate593.NonReducibleUnknown;
+  };
+  clearError: {
+    type: "clearError";
+    params: xstate593.NonReducibleUnknown;
   };
   stopStream: {
     type: "stopStream";
-    params: xstate294.NonReducibleUnknown;
+    params: xstate593.NonReducibleUnknown;
   };
-}>, never, never, "error" | "idle" | "uploading" | "closed" | "finished" | "initCamera" | "capturing", string, DocumentUploadInput, xstate294.NonReducibleUnknown, xstate294.EventObject, xstate294.MetaObject, {
+}>, never, never, "error" | "idle" | "uploading" | "closed" | "finished" | "initCamera" | "capturing", string, DocumentUploadInput, xstate593.NonReducibleUnknown, xstate593.EventObject, xstate593.MetaObject, {
   readonly id: "documentUpload";
   readonly initial: "idle";
   readonly context: ({
@@ -72,67 +72,67 @@ declare const documentUploadMachine: xstate294.StateMachine<DocumentUploadContex
     spawn: {
       <TSrc extends "uploadDocument" | "initCamera">(logic: TSrc, ...[options]: ({
         src: "uploadDocument";
-        logic: xstate294.PromiseActorLogic<void, {
+        logic: xstate593.PromiseActorLogic<void, {
           imageBase64: string;
           documentType: string;
           onProgress: (progress: number) => void;
-        }, xstate294.EventObject>;
+        }, xstate593.EventObject>;
         id: string | undefined;
       } extends infer T ? T extends {
         src: "uploadDocument";
-        logic: xstate294.PromiseActorLogic<void, {
+        logic: xstate593.PromiseActorLogic<void, {
           imageBase64: string;
           documentType: string;
           onProgress: (progress: number) => void;
-        }, xstate294.EventObject>;
+        }, xstate593.EventObject>;
         id: string | undefined;
       } ? T extends {
         src: TSrc;
-      } ? xstate294.ConditionalRequired<[options?: ({
+      } ? xstate593.ConditionalRequired<[options?: ({
         id?: T["id"] | undefined;
         systemId?: string;
-        input?: xstate294.InputFrom<T["logic"]> | undefined;
+        input?: xstate593.InputFrom<T["logic"]> | undefined;
         syncSnapshot?: boolean;
-      } & { [K in xstate294.RequiredActorOptions<T>]: unknown }) | undefined], xstate294.IsNotNever<xstate294.RequiredActorOptions<T>>> : never : never : never) | ({
+      } & { [K in xstate593.RequiredActorOptions<T>]: unknown }) | undefined], xstate593.IsNotNever<xstate593.RequiredActorOptions<T>>> : never : never : never) | ({
         src: "initCamera";
-        logic: xstate294.PromiseActorLogic<MediaStream, void, xstate294.EventObject>;
+        logic: xstate593.PromiseActorLogic<MediaStream, void, xstate593.EventObject>;
         id: string | undefined;
       } extends infer T_1 ? T_1 extends {
         src: "initCamera";
-        logic: xstate294.PromiseActorLogic<MediaStream, void, xstate294.EventObject>;
+        logic: xstate593.PromiseActorLogic<MediaStream, void, xstate593.EventObject>;
         id: string | undefined;
       } ? T_1 extends {
         src: TSrc;
-      } ? xstate294.ConditionalRequired<[options?: ({
+      } ? xstate593.ConditionalRequired<[options?: ({
         id?: T_1["id"] | undefined;
         systemId?: string;
-        input?: xstate294.InputFrom<T_1["logic"]> | undefined;
+        input?: xstate593.InputFrom<T_1["logic"]> | undefined;
         syncSnapshot?: boolean;
-      } & { [K_1 in xstate294.RequiredActorOptions<T_1>]: unknown }) | undefined], xstate294.IsNotNever<xstate294.RequiredActorOptions<T_1>>> : never : never : never)): xstate294.ActorRefFromLogic<xstate294.GetConcreteByKey<xstate294.Values<{
+      } & { [K_1 in xstate593.RequiredActorOptions<T_1>]: unknown }) | undefined], xstate593.IsNotNever<xstate593.RequiredActorOptions<T_1>>> : never : never : never)): xstate593.ActorRefFromLogic<xstate593.GetConcreteByKey<xstate593.Values<{
         uploadDocument: {
           src: "uploadDocument";
-          logic: xstate294.PromiseActorLogic<void, {
+          logic: xstate593.PromiseActorLogic<void, {
             imageBase64: string;
             documentType: string;
             onProgress: (progress: number) => void;
-          }, xstate294.EventObject>;
+          }, xstate593.EventObject>;
           id: string | undefined;
         };
         initCamera: {
           src: "initCamera";
-          logic: xstate294.PromiseActorLogic<MediaStream, void, xstate294.EventObject>;
+          logic: xstate593.PromiseActorLogic<MediaStream, void, xstate593.EventObject>;
           id: string | undefined;
         };
       }>, "src", TSrc>["logic"]>;
-      <TLogic extends xstate294.AnyActorLogic>(src: TLogic, ...[options]: xstate294.ConditionalRequired<[options?: ({
+      <TLogic extends xstate593.AnyActorLogic>(src: TLogic, ...[options]: xstate593.ConditionalRequired<[options?: ({
         id?: never;
         systemId?: string;
-        input?: xstate294.InputFrom<TLogic> | undefined;
+        input?: xstate593.InputFrom<TLogic> | undefined;
         syncSnapshot?: boolean;
-      } & { [K in xstate294.RequiredLogicInput<TLogic>]: unknown }) | undefined], xstate294.IsNotNever<xstate294.RequiredLogicInput<TLogic>>>): xstate294.ActorRefFromLogic<TLogic>;
+      } & { [K in xstate593.RequiredLogicInput<TLogic>]: unknown }) | undefined], xstate593.IsNotNever<xstate593.RequiredLogicInput<TLogic>>>): xstate593.ActorRefFromLogic<TLogic>;
     };
     input: DocumentUploadInput;
-    self: xstate294.ActorRef<xstate294.MachineSnapshot<DocumentUploadContext, {
+    self: xstate593.ActorRef<xstate593.MachineSnapshot<DocumentUploadContext, {
       type: "START";
     } | {
       type: "CAPTURE";
@@ -144,7 +144,7 @@ declare const documentUploadMachine: xstate294.StateMachine<DocumentUploadContex
       type: "RETRY";
     } | {
       type: "CLOSE";
-    }, Record<string, xstate294.AnyActorRef | undefined>, xstate294.StateValue, string, unknown, any, any>, {
+    }, Record<string, xstate593.AnyActorRef | undefined>, xstate593.StateValue, string, unknown, any, any>, {
       type: "START";
     } | {
       type: "CAPTURE";
@@ -156,7 +156,7 @@ declare const documentUploadMachine: xstate294.StateMachine<DocumentUploadContex
       type: "RETRY";
     } | {
       type: "CLOSE";
-    }, xstate294.AnyEventObject>;
+    }, xstate593.AnyEventObject>;
   }) => {
     config: DocumentUploadConfig;
     stream: undefined;
@@ -226,7 +226,7 @@ declare const documentUploadMachine: xstate294.StateMachine<DocumentUploadContex
           } | {
             type: "CLOSE";
           };
-          self: xstate294.ActorRef<xstate294.MachineSnapshot<DocumentUploadContext, {
+          self: xstate593.ActorRef<xstate593.MachineSnapshot<DocumentUploadContext, {
             type: "START";
           } | {
             type: "CAPTURE";
@@ -238,7 +238,7 @@ declare const documentUploadMachine: xstate294.StateMachine<DocumentUploadContex
             type: "RETRY";
           } | {
             type: "CLOSE";
-          }, Record<string, xstate294.AnyActorRef>, xstate294.StateValue, string, unknown, any, any>, {
+          }, Record<string, xstate593.AnyActorRef>, xstate593.StateValue, string, unknown, any, any>, {
             type: "START";
           } | {
             type: "CAPTURE";
@@ -250,7 +250,7 @@ declare const documentUploadMachine: xstate294.StateMachine<DocumentUploadContex
             type: "RETRY";
           } | {
             type: "CLOSE";
-          }, xstate294.AnyEventObject>;
+          }, xstate593.AnyEventObject>;
         }) => {
           imageBase64: string;
           documentType: string;

package/dist/document-upload.esm.js

@@ -1,11 +1,11 @@
-import { t as api } from "./api-CESGtpbH.esm.js";
-import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-Dvvriq9l.esm.js";
-import { t as endpoints } from "./endpoints-BeTK0Mlt.esm.js";
-import "./platform-SKvEfCBh.esm.js";
-import { a as fromPromise, c as createManager, r as assign, s as createActor, t as setup } from "./xstate.esm-C9wncMQa.esm.js";
-import { i as stopCameraStream } from "./camera-DJWm3V4g.esm.js";
-import "./ITimerCapability-CB0I1Uf2.esm.js";
-import { n as getBackCameraStream } from "./backCameraStream-D7Wo4Nbx.esm.js";
+import { t as api } from "./api-DUZwyz0o.esm.js";
+import { n as eventModuleNames, s as createManagerInstrumentation } from "./events-DN-u67gb.esm.js";
+import { t as endpoints } from "./endpoints-BM2_j_IE.esm.js";
+import "./platform-BfoqeM61.esm.js";
+import { a as fromPromise, c as createManager, r as assign, s as createActor, t as setup } from "./xstate.esm-Dkm1jy5u.esm.js";
+import { i as stopCameraStream } from "./camera-x4LjGTjZ.esm.js";
+import "./ITimerCapability-BvH0pDwp.esm.js";
+import { n as getBackCameraStream } from "./backCameraStream-iftkf3rd.esm.js";
 
 //#region src/modules/document-upload/documentUploadServices.ts
 async function uploadDocument({ imageBase64, documentType, onProgress, signal }) {
@@ -195,7 +195,7 @@ function createDocumentUploadManager(options) {
 		actor: createDocumentUploadActor(options),
 		mapState,
 		createApi,
-		instrumentation: createManagerInstrumentation(eventModuleNames.document)
+		instrumentation: createManagerInstrumentation(eventModuleNames.documentUpload)
 	});
 }
 

package/dist/{documentCaptureStateMachine-CUTUzUw_.esm.js → documentCaptureStateMachine-MpwpJO7t.esm.js}

@@ -1,10 +1,10 @@
-import { t as api } from "./api-CESGtpbH.esm.js";
-import { t as endpoints } from "./endpoints-BeTK0Mlt.esm.js";
-import { a as fromPromise, r as assign, t as setup } from "./xstate.esm-C9wncMQa.esm.js";
-import { n as invokeRequestPermissionActor, t as checkPermission } from "./permissionServices-Doec4X5L.esm.js";
-import { i as stopCameraStream } from "./camera-DJWm3V4g.esm.js";
-import { n as getBackCameraStream } from "./backCameraStream-D7Wo4Nbx.esm.js";
-import { r as resolveStoredPermissionResult, t as isReadyForCaptureFromPermission } from "./permissionGuards-D0wGddy7.esm.js";
+import { t as api } from "./api-DUZwyz0o.esm.js";
+import { t as endpoints } from "./endpoints-BM2_j_IE.esm.js";
+import { a as fromPromise, r as assign, t as setup } from "./xstate.esm-Dkm1jy5u.esm.js";
+import { n as invokeRequestPermissionActor, t as checkPermission } from "./permissionServices-CPDboRoE.esm.js";
+import { i as stopCameraStream } from "./camera-x4LjGTjZ.esm.js";
+import { n as getBackCameraStream } from "./backCameraStream-iftkf3rd.esm.js";
+import { r as resolveStoredPermissionResult, t as isReadyForCaptureFromPermission } from "./permissionGuards-D-Z-lgNj.esm.js";
 
 //#region src/modules/document-capture/types.ts
 const PROCESSING_TYPE_MAP = {

package/dist/dynamic-forms.d.ts

@@ -1,5 +1,5 @@
-import { t as Manager } from "./Manager-BHn8wH8K.js";
-import "./Actor-Y0_Fj-KL.js";
+import { t as Manager } from "./Manager-B2OEDYqf.js";
+import "./Actor-fIPLXfoi.js";
 
 //#region src/modules/dynamic-forms/types.d.ts