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

package/dist/geolocationManager-Cs50eRlC.d.ts

@@ -0,0 +1,156 @@
+import { t as Manager } from "./Manager-CJ3G2zqi.js";
+import { t as ActorRefFrom } from "./Actor-CGEelYtQ.js";
+
+//#region ../infra/src/capabilities/IGeolocationCapability.d.ts
+type GeolocationCoords = {
+  latitude: number;
+  longitude: number;
+};
+type IGeolocationCapability = {
+  getCurrentPosition(): Promise<GeolocationCoords>;
+};
+//#endregion
+//#region src/modules/geolocation/types.d.ts
+/**
+ * Configuration options for the Geolocation module.
+ *
+ * @example
+ * ```typescript
+ * const config: GeolocationConfig = {
+ *   allowUserToSkipGeolocation: true,
+ * };
+ * ```
+ */
+type GeolocationConfig = {
+  /**
+   * Whether the user is allowed to skip geolocation capture.
+   * When true, a skip button is shown on the permission-denied screen.
+   * Backend field name from flow/workflow configuration.
+   * @default false
+   */
+  allowUserToSkipGeolocation?: boolean;
+};
+//#endregion
+//#region src/modules/geolocation/geolocationStateMachine.d.ts
+type GeolocationDeviceType = 'ios' | 'android' | 'desktop';
+declare const geolocationMachine: any;
+type GeolocationMachine = typeof geolocationMachine;
+//#endregion
+//#region src/modules/geolocation/geolocationActor.d.ts
+type CreateGeolocationActorOptions = {
+  config: GeolocationConfig;
+  geolocation?: IGeolocationCapability;
+};
+type GeolocationActor = ActorRefFrom<GeolocationMachine>;
+//#endregion
+//#region src/modules/geolocation/geolocationManager.d.ts
+
+/** Geolocation manager is in initial state, waiting for `request()` to be called */
+type GeolocationIdleState = {
+  status: 'idle';
+};
+/** Browser geolocation permission prompt is active */
+type GeolocationRequestingState = {
+  status: 'requestingLocation';
+};
+/** Coordinates are being submitted to the backend */
+type GeolocationSubmittingState = {
+  status: 'submitting';
+};
+/**
+ * Location successfully acquired — call `continue()` to proceed
+ * @property location - Location name returned from backend, or null
+ */
+type GeolocationAcquiredState = {
+  status: 'locationAcquired';
+  location: string | null;
+};
+/**
+ * User denied geolocation permission — shows device-specific instructions
+ * @property deviceType - Used by UI to render the correct instruction panel
+ * @property canSkip - Whether the skip button should be shown
+ */
+type GeolocationPermissionDeniedState = {
+  status: 'permissionDenied';
+  deviceType: GeolocationDeviceType;
+  canSkip: boolean;
+};
+/** Geolocation flow completed successfully */
+type GeolocationFinishedState = {
+  status: 'finished';
+};
+/**
+ * Union of all possible geolocation manager states.
+ *
+ * @example
+ * ```typescript
+ * const state = geolocationManager.getState();
+ * if (state.status === 'locationAcquired') {
+ *   console.log(state.location);
+ * }
+ * if (state.status === 'permissionDenied') {
+ *   console.log(state.deviceType); // 'ios' | 'android' | 'desktop'
+ * }
+ * ```
+ */
+type GeolocationState = GeolocationIdleState | GeolocationRequestingState | GeolocationSubmittingState | GeolocationAcquiredState | GeolocationPermissionDeniedState | GeolocationFinishedState;
+/**
+ * Creates a geolocation manager for headless or UI-driven usage.
+ *
+ * @example Headless usage
+ * ```typescript
+ * const manager = createGeolocationManager({ config: { allowUserToSkipGeolocation: true } });
+ * manager.subscribe((state) => console.log(state.status));
+ * manager.request();
+ * ```
+ */
+declare function createGeolocationManager(options: CreateGeolocationActorOptions): Manager<GeolocationState> & {
+  /**
+   * Initiates the browser geolocation permission request.
+   * Transitions from 'idle' to 'requestingLocation'.
+   */
+  request(): void;
+  /**
+   * Confirms the acquired location and completes the module.
+   * Should be called when state is 'locationAcquired'.
+   */
+  continue(): void;
+  /**
+   * Skips geolocation when the user has denied permission.
+   * Only works when `config.allowUserToSkipGeolocation` is true.
+   */
+  skip(): void;
+  /**
+   * Resets the manager back to initial state.
+   */
+  reset(): void;
+};
+/**
+ * Creates a geolocation manager from a pre-built actor.
+ * Use this when overriding the machine via `.provide()` for custom backends
+ * or for story-isolation testing.
+ */
+declare function createGeolocationManagerFromActor(actor: GeolocationActor): Manager<GeolocationState> & {
+  /**
+   * Initiates the browser geolocation permission request.
+   * Transitions from 'idle' to 'requestingLocation'.
+   */
+  request(): void;
+  /**
+   * Confirms the acquired location and completes the module.
+   * Should be called when state is 'locationAcquired'.
+   */
+  continue(): void;
+  /**
+   * Skips geolocation when the user has denied permission.
+   * Only works when `config.allowUserToSkipGeolocation` is true.
+   */
+  skip(): void;
+  /**
+   * Resets the manager back to initial state.
+   */
+  reset(): void;
+};
+type GeolocationManager = ReturnType<typeof createGeolocationManager>;
+//#endregion
+export { GeolocationActor as a, createGeolocationManagerFromActor as i, GeolocationState as n, geolocationMachine as o, createGeolocationManager as r, GeolocationConfig as s, GeolocationManager as t };

package/dist/{geolocationStateMachine-BWjrMGS_.esm.js → geolocationStateMachine-BYfOOOG0.esm.js}

@@ -1,7 +1,7 @@
-import { t as api } from "./api-DUZwyz0o.esm.js";
-import { t as endpoints } from "./endpoints-BM2_j_IE.esm.js";
-import { r as isIOS, t as isAndroid } from "./platform-BfoqeM61.esm.js";
-import { a as fromPromise, r as assign, t as setup } from "./xstate.esm-Dkm1jy5u.esm.js";
+import { t as api } from "./api-DsbUi7TO.esm.js";
+import { t as endpoints } from "./endpoints-BzMJFAPV.esm.js";
+import { r as isIOS, t as isAndroid } from "./platform-uIVQUnJP.esm.js";
+import { a as fromPromise, r as assign, t as setup } from "./xstate.esm-Bomq1a0z.esm.js";
 
 //#region src/modules/geolocation/geolocationServices.ts
 async function addGeolocation(params, signal) {

package/dist/{getDeviceClass-rXKlXywy.esm.js → getDeviceClass-DGGzzfqm.esm.js}

@@ -1,4 +1,4 @@
-import { t as getDeviceInfo } from "./getDeviceClass-C0zrM97a.esm.js";
+import { t as getDeviceInfo } from "./getDeviceClass-DavNdcxh.esm.js";
 
 //#region src/internal/device/getDeviceClass.ts
 function getDeviceClass() {

package/dist/getDeviceData-TrKM8NPh.esm.js

@@ -0,0 +1,101 @@
+import { i as getParsedUserAgent } from "./browserSimulation-TsSoavQv.esm.js";
+
+//#region ../infra/src/device/getDeviceData.ts
+const HIGH_ENTROPY_HINTS = new Set([
+	"model",
+	"platformVersion",
+	"fullVersionList",
+	"brands",
+	"platform"
+]);
+function getFallbackDeviceInfo() {
+	const parsed = getParsedUserAgent();
+	return {
+		device: { model: parsed.device.model },
+		os: {
+			name: parsed.os.name,
+			version: parsed.os.version
+		},
+		browser: {
+			name: parsed.browser.name,
+			version: parsed.browser.version
+		}
+	};
+}
+function sanitizeString(value) {
+	return value?.trim() || void 0;
+}
+function extractPrimaryBrandInfo(fullVersionList, brands) {
+	const primaryBrand = fullVersionList?.[0] || brands?.[0];
+	return {
+		name: sanitizeString(primaryBrand?.brand),
+		version: sanitizeString(primaryBrand?.version)
+	};
+}
+async function getHighEntropyDeviceInfo(userAgentData) {
+	const highEntropyValues = await userAgentData.getHighEntropyValues(Array.from(HIGH_ENTROPY_HINTS));
+	const { name: browserName, version: browserVersion } = extractPrimaryBrandInfo(highEntropyValues.fullVersionList, userAgentData.brands);
+	return {
+		device: { model: sanitizeString(highEntropyValues.model) },
+		os: {
+			name: sanitizeString(highEntropyValues.platform),
+			version: sanitizeString(highEntropyValues.platformVersion)
+		},
+		browser: {
+			name: browserName,
+			version: browserVersion
+		}
+	};
+}
+const checkForUnbrandedBrowser = (browser) => {
+	const userAgent = typeof navigator !== "undefined" ? navigator.userAgent : "";
+	const fallback = getFallbackDeviceInfo();
+	if (!userAgent) return browser;
+	try {
+		return {
+			...browser,
+			name: fallback.browser.name,
+			version: fallback.browser.version
+		};
+	} catch {
+		return {
+			...browser,
+			name: "Unknown",
+			version: "Unknown"
+		};
+	}
+};
+function mergeDeviceInfo(fallback, enhanced) {
+	return {
+		device: { model: enhanced.device?.model || fallback.device.model },
+		os: {
+			name: enhanced.os?.name || fallback.os.name,
+			version: enhanced.os?.version || fallback.os.version
+		},
+		browser: checkForUnbrandedBrowser({
+			name: enhanced.browser?.name || fallback.browser.name,
+			version: enhanced.browser?.version || fallback.browser.version
+		})
+	};
+}
+function isUserAgentClientHintsSupported(navigator$1) {
+	return Boolean(navigator$1.userAgentData?.getHighEntropyValues && typeof navigator$1.userAgentData.getHighEntropyValues === "function");
+}
+async function getDeviceFingerprintInfo() {
+	if (typeof navigator === "undefined") return {
+		device: {},
+		os: {},
+		browser: {}
+	};
+	const customNavigator = navigator;
+	const fallbackInfo = getFallbackDeviceInfo();
+	if (!isUserAgentClientHintsSupported(customNavigator)) return fallbackInfo;
+	try {
+		return mergeDeviceInfo(fallbackInfo, await getHighEntropyDeviceInfo(customNavigator.userAgentData));
+	} catch {
+		return fallbackInfo;
+	}
+}
+
+//#endregion
+export { getDeviceFingerprintInfo as t };

package/dist/government-validation.d.ts

@@ -1,6 +1,7 @@
-import { t as Manager } from "./Manager-B2OEDYqf.js";
-import "./Actor-fIPLXfoi.js";
-import { t as OtpValidationErrors } from "./otp-BHJnjEEc.js";
+import "./StateMachine-C_AY4cs7.js";
+import { t as Manager } from "./Manager-CJ3G2zqi.js";
+import "./Actor-CGEelYtQ.js";
+import { t as OtpValidationErrors } from "./otp-M4iy57XY.js";
 
 //#region src/modules/government-validation/types.d.ts
 type GovernmentValidationConfig = {

package/dist/government-validation.esm.js

@@ -1,10 +1,11 @@
-import "./BrowserTimerProvider-BVgutW_b.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 { c as createManager, s as createActor } from "./xstate.esm-Dkm1jy5u.esm.js";
-import { t as OTP_CODE_LENGTH } from "./otp-D87RTwrx.esm.js";
-import { t as governmentValidationMachine } from "./governmentValidationStateMachine-BoF7U1of.esm.js";
+import "./BrowserTimerProvider-CHloo0eQ.esm.js";
+import "./api-DsbUi7TO.esm.js";
+import { n as createManagerInstrumentation, t as topLevelStateName } from "./events-CqGY1yMq.esm.js";
+import { n as eventModuleNames } from "./types-ElOJAGaM.esm.js";
+import "./endpoints-BzMJFAPV.esm.js";
+import { l as createManager, s as createActor } from "./xstate.esm-Bomq1a0z.esm.js";
+import { t as OTP_CODE_LENGTH } from "./otp-Bfnzf7I3.esm.js";
+import { t as governmentValidationMachine } from "./governmentValidationStateMachine-CwoPPO8b.esm.js";
 
 //#region src/modules/government-validation/governmentValidationActor.ts
 function createGovernmentValidationActor(options) {

package/dist/{governmentValidationStateMachine-BoF7U1of.esm.js → governmentValidationStateMachine-CwoPPO8b.esm.js}

@@ -1,8 +1,8 @@
-import { t as BrowserTimerProvider } from "./BrowserTimerProvider-BVgutW_b.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, i as fromCallback, r as assign, t as setup } from "./xstate.esm-Dkm1jy5u.esm.js";
-import { n as computeOtpValidationErrors, r as isOtpComplete } from "./otp-D87RTwrx.esm.js";
+import { t as BrowserTimerProvider } from "./BrowserTimerProvider-CHloo0eQ.esm.js";
+import { t as api } from "./api-DsbUi7TO.esm.js";
+import { t as endpoints } from "./endpoints-BzMJFAPV.esm.js";
+import { a as fromPromise, i as fromCallback, r as assign, t as setup } from "./xstate.esm-Bomq1a0z.esm.js";
+import { n as computeOtpValidationErrors, r as isOtpComplete } from "./otp-Bfnzf7I3.esm.js";
 
 //#region src/modules/government-validation/governmentValidationServices.ts
 async function processGovernmentValidation(signal) {

package/dist/home.d.ts

@@ -1,9 +1,12 @@
-import { t as Manager } from "./Manager-B2OEDYqf.js";
-import "./camera-biGPWlmx.js";
-import "./types-Z9wv19v2.js";
-import "./types-DYZja-k9.js";
-import { t as EmptyConfig } from "./types-Dv-9WPJX.js";
-import * as xstate783 from "xstate";
+import "./StateMachine-C_AY4cs7.js";
+import { t as Manager } from "./Manager-CJ3G2zqi.js";
+import "./camera-CNVUo-bC.js";
+import "./types-DgGlgyZT.js";
+import "./types-D_IceWxT.js";
+import "./canvas-CJUmoXSD.js";
+import "./createFaceAvatar-B8pFpy6o.js";
+import { t as EmptyConfig } from "./types-BsYXnC5s.js";
+import * as xstate1051 from "xstate";
 
 //#region src/modules/home/types.d.ts
 type HomeConfig = EmptyConfig;
@@ -35,41 +38,41 @@ type HomeContext = {
 type HomeInput = {
   config: EmptyConfig;
 };
-declare const homeMachine: xstate783.StateMachine<HomeContext, {
+declare const homeMachine: xstate1051.StateMachine<HomeContext, {
   type: "LOAD";
 } | {
   type: "COMPLETE";
 } | {
   type: "RESET";
-}, {}, never, never, never, never, "idle" | "finished" | "main", string, HomeInput, xstate783.NonReducibleUnknown, xstate783.EventObject, xstate783.MetaObject, {
+}, {}, never, never, never, never, "idle" | "finished" | "main", string, HomeInput, xstate1051.NonReducibleUnknown, xstate1051.EventObject, xstate1051.MetaObject, {
   readonly id: "home";
   readonly initial: "idle";
   readonly context: ({
     input
   }: {
     spawn: {
-      <TSrc extends never>(logic: TSrc, ...[options]: never): xstate783.ActorRefFromLogic<never>;
-      <TLogic extends xstate783.AnyActorLogic>(src: TLogic, ...[options]: xstate783.ConditionalRequired<[options?: ({
+      <TSrc extends never>(logic: TSrc, ...[options]: never): xstate1051.ActorRefFromLogic<never>;
+      <TLogic extends xstate1051.AnyActorLogic>(src: TLogic, ...[options]: xstate1051.ConditionalRequired<[options?: ({
         id?: never;
         systemId?: string;
-        input?: xstate783.InputFrom<TLogic> | undefined;
+        input?: xstate1051.InputFrom<TLogic> | undefined;
         syncSnapshot?: boolean;
-      } & { [K in xstate783.RequiredLogicInput<TLogic>]: unknown }) | undefined], xstate783.IsNotNever<xstate783.RequiredLogicInput<TLogic>>>): xstate783.ActorRefFromLogic<TLogic>;
+      } & { [K in xstate1051.RequiredLogicInput<TLogic>]: unknown }) | undefined], xstate1051.IsNotNever<xstate1051.RequiredLogicInput<TLogic>>>): xstate1051.ActorRefFromLogic<TLogic>;
     };
     input: HomeInput;
-    self: xstate783.ActorRef<xstate783.MachineSnapshot<HomeContext, {
+    self: xstate1051.ActorRef<xstate1051.MachineSnapshot<HomeContext, {
       type: "LOAD";
     } | {
       type: "COMPLETE";
     } | {
       type: "RESET";
-    }, Record<string, xstate783.AnyActorRef | undefined>, xstate783.StateValue, string, unknown, any, any>, {
+    }, Record<string, xstate1051.AnyActorRef | undefined>, xstate1051.StateValue, string, unknown, any, any>, {
       type: "LOAD";
     } | {
       type: "COMPLETE";
     } | {
       type: "RESET";
-    }, xstate783.AnyEventObject>;
+    }, xstate1051.AnyEventObject>;
   }) => {
     config: EmptyConfig;
   };

package/dist/home.esm.js

@@ -1,6 +1,7 @@
-import "./api-DUZwyz0o.esm.js";
-import { n as eventModuleNames, s as createManagerInstrumentation } from "./events-DN-u67gb.esm.js";
-import { c as createManager, s as createActor, t as setup } from "./xstate.esm-Dkm1jy5u.esm.js";
+import "./api-DsbUi7TO.esm.js";
+import { n as createManagerInstrumentation } from "./events-CqGY1yMq.esm.js";
+import { n as eventModuleNames } from "./types-ElOJAGaM.esm.js";
+import { l as createManager, s as createActor, t as setup } from "./xstate.esm-Bomq1a0z.esm.js";
 
 //#region src/modules/home/homeStateMachine.ts
 const homeMachine = setup({ types: {

package/dist/http.esm.js

@@ -1,4 +1,4 @@
-import { n as getApi, t as api } from "./api-DUZwyz0o.esm.js";
-import "./http-CfVTgMfU.esm.js";
+import { n as getApi, t as api } from "./api-DsbUi7TO.esm.js";
+import "./http-BkiUT7EB.esm.js";
 
 export { api, getApi };