@incodetech/core 2.2.0-rc.8 → 2.3.0-rc.0

package/dist/warmup-Cis2p6O0.d.ts

@@ -0,0 +1,128 @@
+//#region ../infra/src/wasm/wasmAssets.d.ts
+type WasmSource = string | ArrayBuffer | Uint8Array;
+type WasmGlueModule = {
+  Module?: unknown;
+};
+type WasmGlueLoader = () => Promise<WasmGlueModule>;
+type WasmPipeline = 'selfie' | 'onDeviceSelfie' | 'idCapture' | 'videoSelfie' | 'videoSelfieId';
+declare const WASM_MODEL_FILES: {
+  readonly idCapture: "id_capture_2_01_fp16.ortmodelv2";
+  readonly idFiqa: "id_fiqa_19a81a0b9bf6492eb03b4667f6db4c85_fp16.ortmodelv2";
+  readonly idFaceDetector: "id_facedetector_v2_1_fp16.ortmodelv2";
+  readonly barcode: "barcode_enhance_896x224_fp16.ortmodelv2";
+  readonly selfie: "selfie_bf_angles_192x192_opset9_fp16.ortmodelv2";
+  readonly faceAttributes: "face_attributes_v1_3_fp16.ortmodelv2";
+  readonly faceOcclusion: "face_occlusion_v0_2_fp16.ortmodelv2";
+  readonly mlsRegressor: "mls_regressor_4773007c657b4f05a460321456740d0f_fp16.ortmodelv2";
+  readonly liveness: "ondevice_physical_liveness_v2_1_fp16.ortmodelv2";
+  readonly ageEstimation: "age_estimation_v2_2_2_fp16.ortmodelv2";
+};
+type WasmModelName = keyof typeof WASM_MODEL_FILES;
+//#endregion
+//#region ../infra/src/wasm/apiUtilities.d.ts
+declare global {
+  interface Window {
+    Module?: WasmGlueFactory;
+    wasmArrayBuffer: Uint8Array | null;
+  }
+}
+/** Opaque handle for the loaded WASM module instance. */
+type WasmModule = Record<string, unknown>;
+type WasmGlueFactory = (options?: Readonly<{
+  wasmBinary?: Uint8Array;
+}>) => Promise<WasmModule>;
+/**
+ * Binary and glue configuration for one WASM module instance.
+ *
+ * The ML pipeline and HTTP client share this object because both consumers
+ * use the same memoized module.
+ */
+type WasmModuleConfig = {
+  /** URL or bytes for the standard WASM binary. */
+  wasmPath: WasmSource;
+  /**
+   * URL or bytes for the SIMD WASM binary.
+   *
+   * When omitted, the loader uses `wasmPath` and skips the SIMD attempt.
+   */
+  wasmSimdPath?: WasmSource;
+  /** URL of the JavaScript glue paired with `wasmPath`. */
+  glueCodePath: string;
+  /**
+   * URL of the JavaScript glue paired with `wasmSimdPath`.
+   *
+   * When omitted or empty, the loader derives a sibling `.js` URL from
+   * `wasmSimdPath`.
+   */
+  glueCodeSimdPath?: string;
+  /** Lazy ES-module loader for the standard JavaScript glue. */
+  loadGlue?: WasmGlueLoader;
+  /** Lazy ES-module loader for the SIMD JavaScript glue. */
+  loadGlueSimd?: WasmGlueLoader;
+  /**
+   * Enables the SIMD-first load attempt.
+   *
+   * Defaults to `true`. If SIMD loading fails, the loader uses the standard
+   * binary and glue pair.
+   */
+  useSimd?: boolean;
+};
+//#endregion
+//#region ../infra/src/wasm/warmup.d.ts
+type WasmModelsConfig = {
+  /** Root URL that contains the model files. */
+  modelsBasePath?: string;
+  /** Fully resolved source for each model filename. */
+  modelUrls?: Readonly<Record<string, WasmSource>>;
+  /**
+   * Optional non-SIMD model sources paired with {@link modelUrls}. Used only
+   * when SIMD initialization falls back to the standard WASM binary.
+   */
+  legacyModelUrls?: Readonly<Record<string, WasmSource>>;
+  /** Prevents unresolved models from falling back to the Incode CDN. */
+  selfHosted?: boolean;
+};
+type WarmupConfig = WasmModuleConfig & WasmModelsConfig & {
+  /** Root URL of a directory that contains binaries, glue, and models. */
+  basePath?: string;
+  /** Pipelines whose model bundles load during this warmup. */
+  pipelines?: readonly WasmPipeline[];
+  /** Model filename overrides for individual pipelines. */
+  pipelineModels?: Partial<Record<WasmPipeline, string[]>>;
+  /**
+   * @deprecated Compatibility-only hint. The pinned runtime accepts either
+   * value without changing native initialization or fingerprint lifecycle.
+   */
+  onDeviceMode?: boolean;
+};
+/**
+ * Preloads WASM binary and ML models at app startup.
+ * Runs asynchronously - app can continue while WASM loads in background.
+ *
+ * Model files are automatically loaded based on the pipeline type.
+ * By default, models are expected in a 'models' subdirectory relative to the WASM binary.
+ *
+ * @param config - Configuration for WASM warmup
+ * @returns Promise that resolves when WASM is ready
+ *
+ * @example
+ * ```ts
+ * // Basic usage - models loaded from /wasm/v2/models/
+ * warmupWasm({
+ *   wasmPath: '/wasm/v2/ml-wasm.wasm',
+ *   glueCodePath: '/wasm/v2/ml-wasm.js',
+ *   pipelines: ['selfie', 'idCapture'],
+ * });
+ *
+ * // With explicit models path
+ * warmupWasm({
+ *   wasmPath: '/wasm/v2/ml-wasm.wasm',
+ *   glueCodePath: '/wasm/v2/ml-wasm.js',
+ *   modelsBasePath: 'https://cdn.example.com/wasm/v2/models',
+ *   pipelines: ['selfie'],
+ * });
+ * ```
+ */
+declare function warmupWasm(config: WarmupConfig): Promise<void>;
+//#endregion
+export { WASM_MODEL_FILES as a, WasmPipeline as c, WasmModuleConfig as i, WasmSource as l, WasmModelsConfig as n, WasmGlueLoader as o, warmupWasm as r, WasmModelName as s, WarmupConfig as t };

package/dist/wasm.d.ts

@@ -1,16 +1,40 @@
-import { n as WasmPipeline, r as warmupWasm, t as WarmupConfig } from "./warmup-Dv2alr2-.js";
-import { i as initializeWasmUtil, l as upgradeToWasmHttpClient, n as WasmConfig, r as ensureWasmPipelines, s as setWasmConfig } from "./setup-BgoWtvIS.js";
+import { a as WASM_MODEL_FILES, c as WasmPipeline, l as WasmSource, o as WasmGlueLoader, r as warmupWasm, s as WasmModelName, t as WarmupConfig } from "./warmup-Cis2p6O0.js";
+import { c as setWasmConfig, i as initializeWasmUtil, n as WasmConfig, r as ensureWasmPipelines, s as resolveWasmConfigForPipelines, u as upgradeToWasmHttpClient } from "./setup-Cv-JM9QC.js";
 //#region ../infra/src/wasm/wasmDefaults.d.ts
 /** The WASM version bundled and tested with this SDK release. */
-declare const DEFAULT_WASM_VERSION = "v2.14.07-post7-post3";
+declare const DEFAULT_WASM_VERSION = "v2.14.50-post1";
+type UrlWasmConfig = WarmupConfig & {
+  wasmPath: string;
+  wasmSimdPath: string;
+  glueCodePath: string;
+  glueCodeSimdPath: string;
+  modelsBasePath: string;
+};
 /** Builds a WarmupConfig from a directory that mirrors the ml-wasm-kit CDN layout. */
-declare function buildWasmConfigFromBasePath(basePath: string): WarmupConfig;
+declare function buildWasmConfigFromBasePath(basePath: string): UrlWasmConfig;
 /** Builds the standard WarmupConfig from the Incode CDN. */
-declare function buildDefaultWasmConfig(): WarmupConfig;
+declare function buildDefaultWasmConfig(): UrlWasmConfig;
 /**
  * Merges optional WASM path overrides with CDN defaults. Explicit non-blank
  * paths take precedence. Blank override strings log a warning and fall back to defaults.
  */
 declare function resolveWasmConfig(overrides?: Partial<WarmupConfig>): WarmupConfig;
 //#endregion
-export { DEFAULT_WASM_VERSION, type WasmConfig, type WasmPipeline, buildDefaultWasmConfig, buildWasmConfigFromBasePath, ensureWasmPipelines, initializeWasmUtil, resolveWasmConfig, setWasmConfig, upgradeToWasmHttpClient, warmupWasm };
+//#region src/defineWasm.d.ts
+type DefineWasmOptions = {
+  pipelines: readonly WasmPipeline[];
+  wasm: WasmSource;
+  wasmSimd?: WasmSource;
+  glue: WasmGlueLoader;
+  glueSimd?: WasmGlueLoader;
+  models: Partial<Record<WasmModelName, WasmSource>>;
+  /**
+   * Optional non-SIMD model package. When supplied, it must include the same
+   * eager and lazy models as {@link models}; the loader selects it only after
+   * a failed SIMD initialization.
+   */
+  legacyModels?: Partial<Record<WasmModelName, WasmSource>>;
+};
+declare function defineWasm(options: DefineWasmOptions): WasmConfig;
+//#endregion
+export { DEFAULT_WASM_VERSION, type DefineWasmOptions, WASM_MODEL_FILES, type WasmConfig, type WasmModelName, type WasmPipeline, type WasmSource, buildDefaultWasmConfig, buildWasmConfigFromBasePath, defineWasm, ensureWasmPipelines, initializeWasmUtil, resolveWasmConfig, resolveWasmConfigForPipelines, setWasmConfig, upgradeToWasmHttpClient, warmupWasm };

package/dist/wasm.esm.js

@@ -1,4 +1,36 @@
-import { a as resolveWasmConfig, n as buildDefaultWasmConfig, r as buildWasmConfigFromBasePath, t as DEFAULT_WASM_VERSION } from "./wasmDefaults-DTUrftxR.esm.js";
-import { s as warmupWasm } from "./safeStorage-Ep56I-f_.esm.js";
-import { a as setWasmConfig, n as initializeWasmUtil, s as upgradeToWasmHttpClient, t as ensureWasmPipelines } from "./setup-CXj5ozZN.esm.js";
-export { DEFAULT_WASM_VERSION, buildDefaultWasmConfig, buildWasmConfigFromBasePath, ensureWasmPipelines, initializeWasmUtil, resolveWasmConfig, setWasmConfig, upgradeToWasmHttpClient, warmupWasm };
+import { g as WASM_PIPELINE_MODEL_NAMES, m as WASM_PIPELINE_LAZY_MODEL_NAMES, p as WASM_MODEL_FILES } from "./wasmWebClient-B7baE-Wf.esm.js";
+import { a as resolveWasmConfigForPipelines, c as upgradeToWasmHttpClient, d as buildDefaultWasmConfig, f as buildWasmConfigFromBasePath, m as resolveWasmConfig, n as initializeWasmUtil, o as setWasmConfig, t as ensureWasmPipelines, u as DEFAULT_WASM_VERSION } from "./setup-msLybMbC.esm.js";
+import { o as warmupWasm } from "./warmup-CUUnwYxe.esm.js";
+//#region src/defineWasm.ts
+function requiredModels(pipelines) {
+	const models = /* @__PURE__ */ new Set();
+	for (const pipeline of pipelines) {
+		for (const model of WASM_PIPELINE_MODEL_NAMES[pipeline]) models.add(model);
+		for (const model of WASM_PIPELINE_LAZY_MODEL_NAMES[pipeline]) models.add(model);
+	}
+	return models;
+}
+function defineWasm(options) {
+	if (options.wasmSimd === void 0 !== (options.glueSimd === void 0)) throw new Error("[Incode SDK] wasmSimd and glueSimd must be provided together.");
+	for (const model of requiredModels(options.pipelines)) {
+		if (options.models[model] === void 0) throw new Error(`[Incode SDK] The self-hosted WASM configuration is missing the "${model}" model.`);
+		if (options.legacyModels !== void 0 && options.legacyModels[model] === void 0) throw new Error(`[Incode SDK] The self-hosted non-SIMD WASM configuration is missing the "${model}" model.`);
+	}
+	const modelUrls = {};
+	for (const [name, source] of Object.entries(options.models)) if (source !== void 0) modelUrls[WASM_MODEL_FILES[name]] = source;
+	const legacyModelUrls = {};
+	for (const [name, source] of Object.entries(options.legacyModels ?? {})) if (source !== void 0) legacyModelUrls[WASM_MODEL_FILES[name]] = source;
+	return {
+		wasmPath: options.wasm,
+		wasmSimdPath: options.wasmSimd,
+		loadGlue: options.glue,
+		loadGlueSimd: options.glueSimd,
+		useSimd: options.wasmSimd !== void 0,
+		pipelines: [...options.pipelines],
+		modelUrls,
+		legacyModelUrls: options.legacyModels === void 0 ? void 0 : legacyModelUrls,
+		selfHosted: true
+	};
+}
+//#endregion
+export { DEFAULT_WASM_VERSION, WASM_MODEL_FILES, buildDefaultWasmConfig, buildWasmConfigFromBasePath, defineWasm, ensureWasmPipelines, initializeWasmUtil, resolveWasmConfig, resolveWasmConfigForPipelines, setWasmConfig, upgradeToWasmHttpClient, warmupWasm };

package/dist/{wasmDsFlagSync-BqUCwLY8.esm.js → wasmDsFlagSync-B2e8p268.esm.js}

@@ -1,4 +1,4 @@
-import { c as mlWasmJSApi_default } from "./safeStorage-Ep56I-f_.esm.js";
+import { a as utilityWasmApi } from "./safeStorage-B-trhxg6.esm.js";
 //#region ../infra/src/wasm/wasmDsFlagSync.ts
 /**
 * Sets the Deepsight (ds) flag that the WASM utility API receives on every
@@ -6,7 +6,7 @@ import { c as mlWasmJSApi_default } from "./safeStorage-Ep56I-f_.esm.js";
 * localStorage (the wasm module stopped reading it in v2.14.07-post7-post2).
 */
 function setWasmDsFlagSync(enabled) {
-	mlWasmJSApi_default.setDsEnabled(enabled);
+	utilityWasmApi.setDsEnabled(enabled);
 }
 //#endregion
 export { setWasmDsFlagSync as t };