@worldcoin/idkit-core 4.0.7 → 4.0.9-dev.648eacc

package/README.md

@@ -56,19 +56,19 @@ const request = await IDKit.request({
 const qrUrl = request.connectorURI;
 ```
 
-**Available presets:** `orbLegacy`, `documentLegacy`, `secureDocumentLegacy`, `selfieCheck`
+**Available presets:** `orbLegacy`, `documentLegacy`, `secureDocumentLegacy`, `selfieCheckLegacy`
 
 Selfie check preset example:
 
 ```typescript
-import { IDKit, selfieCheck } from "@worldcoin/idkit-core";
+import { IDKit, selfieCheckLegacy } from "@worldcoin/idkit-core";
 
 const request = await IDKit.request({
   app_id: "app_xxxxx",
   action: "my-action",
   rp_context: rpContext,
   allow_legacy_proofs: false,
-}).preset(selfieCheck({ signal: "user-123" }));
+}).preset(selfieCheckLegacy({ signal: "user-123" }));
 ```
 
 ## Handling the Result

package/dist/index.cjs

@@ -392,14 +392,14 @@ function hashSignal(signal) {
     wasm.__wbindgen_export4(deferred2_0, deferred2_1, 1);
   }
 }
-function __wasm_bindgen_func_elem_605(arg0, arg1) {
-  wasm.__wasm_bindgen_func_elem_605(arg0, arg1);
+function __wasm_bindgen_func_elem_972(arg0, arg1, arg2) {
+  wasm.__wasm_bindgen_func_elem_972(arg0, arg1, addHeapObject(arg2));
 }
-function __wasm_bindgen_func_elem_968(arg0, arg1, arg2) {
-  wasm.__wasm_bindgen_func_elem_968(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_609(arg0, arg1) {
+  wasm.__wasm_bindgen_func_elem_609(arg0, arg1);
 }
-function __wasm_bindgen_func_elem_1353(arg0, arg1, arg2, arg3) {
-  wasm.__wasm_bindgen_func_elem_1353(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+function __wasm_bindgen_func_elem_1357(arg0, arg1, arg2, arg3) {
+  wasm.__wasm_bindgen_func_elem_1357(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
 }
 var __wbindgen_enum_RequestCache = ["default", "no-store", "reload", "no-cache", "force-cache", "only-if-cached"];
 var __wbindgen_enum_RequestCredentials = ["omit", "same-origin", "include"];
@@ -887,6 +887,35 @@ var IDKitBuilder = class _IDKitBuilder {
       wasm.__wbindgen_add_to_stack_pointer(16);
     }
   }
+  /**
+   * Builds a v1 (legacy) native payload from a preset (synchronous, no bridge connection).
+   *
+   * Used by the native transport when the World App only supports verify v1.
+   * Only legacy presets produce valid v1 payloads (constraints always have
+   * `Deprecated` verification level and will fail).
+   *
+   * # Errors
+   *
+   * Returns an error if the preset is invalid or v1 payload construction fails.
+   * @param {any} preset_json
+   * @returns {any}
+   */
+  nativePayloadV1FromPreset(preset_json) {
+    try {
+      const ptr = this.__destroy_into_raw();
+      const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+      wasm.idkitbuilder_nativePayloadV1FromPreset(retptr, ptr, addHeapObject(preset_json));
+      var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+      var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+      var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+      if (r2) {
+        throw takeObject(r1);
+      }
+      return takeObject(r0);
+    } finally {
+      wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+  }
   /**
    * Creates a new builder for uniqueness requests
    * @param {string} app_id
@@ -1562,7 +1591,7 @@ function __wbg_get_imports() {
         const a = state0.a;
         state0.a = 0;
         try {
-          return __wasm_bindgen_func_elem_1353(a, state0.b, arg02, arg12);
+          return __wasm_bindgen_func_elem_1357(a, state0.b, arg02, arg12);
         } finally {
           state0.a = a;
         }
@@ -1772,7 +1801,7 @@ function __wbg_get_imports() {
     return addHeapObject(ret);
   };
   imports.wbg.__wbindgen_cast_02740531cfdb05fe = function(arg0, arg1) {
-    const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_604, __wasm_bindgen_func_elem_605);
+    const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_608, __wasm_bindgen_func_elem_609);
     return addHeapObject(ret);
   };
   imports.wbg.__wbindgen_cast_2241b6af4c4b2941 = function(arg0, arg1) {
@@ -1796,7 +1825,7 @@ function __wbg_get_imports() {
     return addHeapObject(ret);
   };
   imports.wbg.__wbindgen_cast_f23235b6472d5cf3 = function(arg0, arg1) {
-    const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_967, __wasm_bindgen_func_elem_968);
+    const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_971, __wasm_bindgen_func_elem_972);
     return addHeapObject(ret);
   };
   imports.wbg.__wbindgen_object_clone_ref = function(arg0) {
@@ -1880,21 +1909,32 @@ var MINIAPP_VERIFY_ACTION = "miniapp-verify-action";
 function isInWorldApp() {
   return typeof window !== "undefined" && Boolean(window.WorldApp);
 }
+function getWorldAppVerifyVersion() {
+  const cmds = window.WorldApp?.supported_commands;
+  if (!Array.isArray(cmds)) return 1;
+  const verify = cmds.find((c) => c.name === "verify");
+  return verify?.supported_versions?.includes(2) ? 2 : 1;
+}
 var _requestCounter = 0;
 var _activeNativeRequest = null;
-function createNativeRequest(wasmPayload, config, signalHashes = {}) {
+function createNativeRequest(wasmPayload, config, signalHashes = {}, version) {
   if (_activeNativeRequest?.isPending()) {
     console.warn(
       "IDKit native request already in flight. Reusing active request."
     );
     return _activeNativeRequest;
   }
-  const request2 = new NativeIDKitRequest(wasmPayload, config, signalHashes);
+  const request2 = new NativeIDKitRequest(
+    wasmPayload,
+    config,
+    signalHashes,
+    version
+  );
   _activeNativeRequest = request2;
   return request2;
 }
 var NativeIDKitRequest = class {
-  constructor(wasmPayload, config, signalHashes = {}) {
+  constructor(wasmPayload, config, signalHashes = {}, version) {
     this.connectorURI = "";
     this.resolved = false;
     this.cancelled = false;
@@ -1948,7 +1988,7 @@ var NativeIDKitRequest = class {
       }
       const sendPayload = {
         command: "verify",
-        version: 2,
+        version,
         payload: wasmPayload
       };
       const w = window;
@@ -2180,8 +2220,8 @@ function secureDocumentLegacy(opts = {}) {
 function documentLegacy(opts = {}) {
   return { type: "DocumentLegacy", signal: opts.signal };
 }
-function selfieCheck(opts = {}) {
-  return { type: "SelfieCheck", signal: opts.signal };
+function selfieCheckLegacy(opts = {}) {
+  return { type: "SelfieCheckLegacy", signal: opts.signal };
 }
 function createWasmBuilderFromConfig(config) {
   if (!config.rp_context) {
@@ -2244,15 +2284,23 @@ var IDKitBuilder2 = class {
    */
   async constraints(constraints) {
     await initIDKit();
-    const wasmBuilder = createWasmBuilderFromConfig(this.config);
     if (isInWorldApp()) {
-      const wasmResult = wasmBuilder.nativePayload(constraints);
+      const verifyVersion = getWorldAppVerifyVersion();
+      if (verifyVersion < 2) {
+        throw new Error(
+          "verify v2 is not supported by this World App version. Use a legacy preset (e.g. orbLegacy()) or update the World App."
+        );
+      }
+      const wasmBuilder2 = createWasmBuilderFromConfig(this.config);
+      const wasmResult = wasmBuilder2.nativePayload(constraints);
       return createNativeRequest(
         wasmResult.payload,
         this.config,
-        wasmResult.signal_hashes ?? {}
+        wasmResult.signal_hashes ?? {},
+        2
       );
     }
+    const wasmBuilder = createWasmBuilderFromConfig(this.config);
     const wasmRequest = await wasmBuilder.constraints(
       constraints
     );
@@ -2264,7 +2312,7 @@ var IDKitBuilder2 = class {
    * Presets provide a simplified way to create requests with predefined
    * credential configurations.
    *
-   * @param preset - A preset object from orbLegacy(), secureDocumentLegacy(), documentLegacy(), or selfieCheck()
+   * @param preset - A preset object from orbLegacy(), secureDocumentLegacy(), documentLegacy(), or selfieCheckLegacy()
    * @returns A new IDKitRequest instance
    *
    * @example
@@ -2275,15 +2323,37 @@ var IDKitBuilder2 = class {
    */
   async preset(preset) {
     await initIDKit();
-    const wasmBuilder = createWasmBuilderFromConfig(this.config);
     if (isInWorldApp()) {
-      const wasmResult = wasmBuilder.nativePayloadFromPreset(preset);
-      return createNativeRequest(
-        wasmResult.payload,
-        this.config,
-        wasmResult.signal_hashes ?? {}
-      );
+      const verifyVersion = getWorldAppVerifyVersion();
+      if (verifyVersion === 2) {
+        const wasmBuilder2 = createWasmBuilderFromConfig(this.config);
+        const wasmResult = wasmBuilder2.nativePayloadFromPreset(preset);
+        return createNativeRequest(
+          wasmResult.payload,
+          this.config,
+          wasmResult.signal_hashes ?? {},
+          2
+        );
+      }
+      try {
+        const wasmBuilder2 = createWasmBuilderFromConfig(this.config);
+        const wasmResult = wasmBuilder2.nativePayloadV1FromPreset(preset);
+        return createNativeRequest(
+          wasmResult.payload,
+          this.config,
+          wasmResult.signal_hashes ?? {},
+          1
+        );
+      } catch (err) {
+        if (err instanceof Error && String(err.message).includes("v1 payload")) {
+          throw new Error(
+            "verify v2 is not supported by this World App version. Use a legacy preset (e.g. orbLegacy()) or update the World App."
+          );
+        }
+        throw err;
+      }
     }
+    const wasmBuilder = createWasmBuilderFromConfig(this.config);
     const wasmRequest = await wasmBuilder.preset(
       preset
     );
@@ -2341,8 +2411,8 @@ var IDKit = {
   secureDocumentLegacy,
   /** Create a DocumentLegacy preset for World ID 3.0 legacy support */
   documentLegacy,
-  /** Create a SelfieCheck preset for face verification */
-  selfieCheck
+  /** Create a SelfieCheckLegacy preset for face verification */
+  selfieCheckLegacy
 };
 
 // src/lib/platform.ts
@@ -2389,4 +2459,4 @@ exports.isReactNative = isReactNative;
 exports.isWeb = isWeb;
 exports.orbLegacy = orbLegacy;
 exports.secureDocumentLegacy = secureDocumentLegacy;
-exports.selfieCheck = selfieCheck;
+exports.selfieCheckLegacy = selfieCheckLegacy;

package/dist/index.d.cts

@@ -84,27 +84,31 @@ type IDKitSessionConfig = {
 };
 
 interface OrbLegacyPreset {
+    /** This preset only returns World ID 3.0 proofs. Use it for compatibility with older IDKit versions. */
     type: "OrbLegacy";
     signal?: string;
 }
 
 interface SecureDocumentLegacyPreset {
+    /** This preset only returns World ID 3.0 proofs. Use it for compatibility with older IDKit versions. */
     type: "SecureDocumentLegacy";
     signal?: string;
 }
 
 interface DocumentLegacyPreset {
+    /** This preset only returns World ID 3.0 proofs. Use it for compatibility with older IDKit versions. */
     type: "DocumentLegacy";
     signal?: string;
 }
 
-interface SelfieCheckPreset {
+interface SelfieCheckLegacyPreset {
+    /** This preset only returns World ID 3.0 proofs. Use it for compatibility with older IDKit versions. */
     /** Preview: Selfie Check is currently in preview. Contact us if you need it enabled. */
-    type: "SelfieCheck";
+    type: "SelfieCheckLegacy";
     signal?: string;
 }
 
-type Preset = OrbLegacyPreset | SecureDocumentLegacyPreset | DocumentLegacyPreset | SelfieCheckPreset;
+type Preset = OrbLegacyPreset | SecureDocumentLegacyPreset | DocumentLegacyPreset | SelfieCheckLegacyPreset;
 
 
 
@@ -339,8 +343,7 @@ interface IDKitRequest {
 /**
  * Creates an OrbLegacy preset for World ID 3.0 legacy support
  *
- * This preset creates an IDKit request compatible with both World ID 4.0 and 3.0 protocols.
- * Use this when you need backward compatibility with older World App versions.
+ * This preset only returns World ID 3.0 proofs. Use it for compatibility with older IDKit versions.
  *
  * @param opts - Optional configuration with signal
  * @returns An OrbLegacy preset
@@ -357,8 +360,7 @@ declare function orbLegacy(opts?: {
 /**
  * Creates a SecureDocumentLegacy preset for World ID 3.0 legacy support
  *
- * This preset creates an IDKit request compatible with both World ID 4.0 and 3.0 protocols.
- * Use this when you need backward compatibility with older World App versions.
+ * This preset only returns World ID 3.0 proofs. Use it for compatibility with older IDKit versions.
  *
  * @param opts - Optional configuration with signal
  * @returns A SecureDocumentLegacy preset
@@ -375,8 +377,7 @@ declare function secureDocumentLegacy(opts?: {
 /**
  * Creates a DocumentLegacy preset for World ID 3.0 legacy support
  *
- * This preset creates an IDKit request compatible with both World ID 4.0 and 3.0 protocols.
- * Use this when you need backward compatibility with older World App versions.
+ * This preset only returns World ID 3.0 proofs. Use it for compatibility with older IDKit versions.
  *
  * @param opts - Optional configuration with signal
  * @returns A DocumentLegacy preset
@@ -391,26 +392,25 @@ declare function documentLegacy(opts?: {
     signal?: string;
 }): DocumentLegacyPreset;
 /**
- * Creates a SelfieCheck preset for face verification
+ * Creates a SelfieCheckLegacy preset for face verification
  *
  * Preview: Selfie Check is currently in preview.
  * Contact us if you need it enabled.
  *
- * This preset requests face credentials in v4 constraints.
- * In legacy compatibility fields, it maps to verification level "face".
+ * This preset only returns World ID 3.0 proofs. Use it for compatibility with older IDKit versions.
  *
  * @param opts - Optional configuration with signal
- * @returns A SelfieCheck preset
+ * @returns A SelfieCheckLegacy preset
  *
  * @example
  * ```typescript
  * const request = await IDKit.request({ app_id, action, rp_context, allow_legacy_proofs: false })
- *   .preset(selfieCheck({ signal: 'user-123' }))
+ *   .preset(selfieCheckLegacy({ signal: 'user-123' }))
  * ```
  */
-declare function selfieCheck(opts?: {
+declare function selfieCheckLegacy(opts?: {
     signal?: string;
-}): SelfieCheckPreset;
+}): SelfieCheckLegacyPreset;
 /**
  * Builder for IDKit requests
  *
@@ -440,7 +440,7 @@ declare class IDKitBuilder {
      * Presets provide a simplified way to create requests with predefined
      * credential configurations.
      *
-     * @param preset - A preset object from orbLegacy(), secureDocumentLegacy(), documentLegacy(), or selfieCheck()
+     * @param preset - A preset object from orbLegacy(), secureDocumentLegacy(), documentLegacy(), or selfieCheckLegacy()
      * @returns A new IDKitRequest instance
      *
      * @example
@@ -520,8 +520,8 @@ declare const IDKit: {
     secureDocumentLegacy: typeof secureDocumentLegacy;
     /** Create a DocumentLegacy preset for World ID 3.0 legacy support */
     documentLegacy: typeof documentLegacy;
-    /** Create a SelfieCheck preset for face verification */
-    selfieCheck: typeof selfieCheck;
+    /** Create a SelfieCheckLegacy preset for face verification */
+    selfieCheckLegacy: typeof selfieCheckLegacy;
 };
 
 /**
@@ -546,4 +546,4 @@ declare const isWeb: () => boolean;
  */
 declare const isNode: () => boolean;
 
-export { type AbiEncodedValue, type ConstraintNode, type CredentialRequestType, type CredentialType, type DocumentLegacyPreset, IDKit, type IDKitCompletionResult, type IDKitErrorCode, IDKitErrorCodes, type IDKitRequest, type IDKitRequestConfig, type IDKitResult, type IDKitResultSession, type IDKitSessionConfig, type OrbLegacyPreset, type Preset, type ResponseItemSession, type ResponseItemV3, type ResponseItemV4, type RpContext, type SecureDocumentLegacyPreset, type SelfieCheckPreset, type Status$1 as Status, type WaitOptions, documentLegacy, isNode, isReactNative, isWeb, orbLegacy, secureDocumentLegacy, selfieCheck };
+export { type AbiEncodedValue, type ConstraintNode, type CredentialRequestType, type CredentialType, type DocumentLegacyPreset, IDKit, type IDKitCompletionResult, type IDKitErrorCode, IDKitErrorCodes, type IDKitRequest, type IDKitRequestConfig, type IDKitResult, type IDKitResultSession, type IDKitSessionConfig, type OrbLegacyPreset, type Preset, type ResponseItemSession, type ResponseItemV3, type ResponseItemV4, type RpContext, type SecureDocumentLegacyPreset, type SelfieCheckLegacyPreset, type Status$1 as Status, type WaitOptions, documentLegacy, isNode, isReactNative, isWeb, orbLegacy, secureDocumentLegacy, selfieCheckLegacy };

package/dist/index.d.ts

@@ -84,27 +84,31 @@ type IDKitSessionConfig = {
 };
 
 interface OrbLegacyPreset {
+    /** This preset only returns World ID 3.0 proofs. Use it for compatibility with older IDKit versions. */
     type: "OrbLegacy";
     signal?: string;
 }
 
 interface SecureDocumentLegacyPreset {
+    /** This preset only returns World ID 3.0 proofs. Use it for compatibility with older IDKit versions. */
     type: "SecureDocumentLegacy";
     signal?: string;
 }
 
 interface DocumentLegacyPreset {
+    /** This preset only returns World ID 3.0 proofs. Use it for compatibility with older IDKit versions. */
     type: "DocumentLegacy";
     signal?: string;
 }
 
-interface SelfieCheckPreset {
+interface SelfieCheckLegacyPreset {
+    /** This preset only returns World ID 3.0 proofs. Use it for compatibility with older IDKit versions. */
     /** Preview: Selfie Check is currently in preview. Contact us if you need it enabled. */
-    type: "SelfieCheck";
+    type: "SelfieCheckLegacy";
     signal?: string;
 }
 
-type Preset = OrbLegacyPreset | SecureDocumentLegacyPreset | DocumentLegacyPreset | SelfieCheckPreset;
+type Preset = OrbLegacyPreset | SecureDocumentLegacyPreset | DocumentLegacyPreset | SelfieCheckLegacyPreset;
 
 
 
@@ -339,8 +343,7 @@ interface IDKitRequest {
 /**
  * Creates an OrbLegacy preset for World ID 3.0 legacy support
  *
- * This preset creates an IDKit request compatible with both World ID 4.0 and 3.0 protocols.
- * Use this when you need backward compatibility with older World App versions.
+ * This preset only returns World ID 3.0 proofs. Use it for compatibility with older IDKit versions.
  *
  * @param opts - Optional configuration with signal
  * @returns An OrbLegacy preset
@@ -357,8 +360,7 @@ declare function orbLegacy(opts?: {
 /**
  * Creates a SecureDocumentLegacy preset for World ID 3.0 legacy support
  *
- * This preset creates an IDKit request compatible with both World ID 4.0 and 3.0 protocols.
- * Use this when you need backward compatibility with older World App versions.
+ * This preset only returns World ID 3.0 proofs. Use it for compatibility with older IDKit versions.
  *
  * @param opts - Optional configuration with signal
  * @returns A SecureDocumentLegacy preset
@@ -375,8 +377,7 @@ declare function secureDocumentLegacy(opts?: {
 /**
  * Creates a DocumentLegacy preset for World ID 3.0 legacy support
  *
- * This preset creates an IDKit request compatible with both World ID 4.0 and 3.0 protocols.
- * Use this when you need backward compatibility with older World App versions.
+ * This preset only returns World ID 3.0 proofs. Use it for compatibility with older IDKit versions.
  *
  * @param opts - Optional configuration with signal
  * @returns A DocumentLegacy preset
@@ -391,26 +392,25 @@ declare function documentLegacy(opts?: {
     signal?: string;
 }): DocumentLegacyPreset;
 /**
- * Creates a SelfieCheck preset for face verification
+ * Creates a SelfieCheckLegacy preset for face verification
  *
  * Preview: Selfie Check is currently in preview.
  * Contact us if you need it enabled.
  *
- * This preset requests face credentials in v4 constraints.
- * In legacy compatibility fields, it maps to verification level "face".
+ * This preset only returns World ID 3.0 proofs. Use it for compatibility with older IDKit versions.
  *
  * @param opts - Optional configuration with signal
- * @returns A SelfieCheck preset
+ * @returns A SelfieCheckLegacy preset
  *
  * @example
  * ```typescript
  * const request = await IDKit.request({ app_id, action, rp_context, allow_legacy_proofs: false })
- *   .preset(selfieCheck({ signal: 'user-123' }))
+ *   .preset(selfieCheckLegacy({ signal: 'user-123' }))
  * ```
  */
-declare function selfieCheck(opts?: {
+declare function selfieCheckLegacy(opts?: {
     signal?: string;
-}): SelfieCheckPreset;
+}): SelfieCheckLegacyPreset;
 /**
  * Builder for IDKit requests
  *
@@ -440,7 +440,7 @@ declare class IDKitBuilder {
      * Presets provide a simplified way to create requests with predefined
      * credential configurations.
      *
-     * @param preset - A preset object from orbLegacy(), secureDocumentLegacy(), documentLegacy(), or selfieCheck()
+     * @param preset - A preset object from orbLegacy(), secureDocumentLegacy(), documentLegacy(), or selfieCheckLegacy()
      * @returns A new IDKitRequest instance
      *
      * @example
@@ -520,8 +520,8 @@ declare const IDKit: {
     secureDocumentLegacy: typeof secureDocumentLegacy;
     /** Create a DocumentLegacy preset for World ID 3.0 legacy support */
     documentLegacy: typeof documentLegacy;
-    /** Create a SelfieCheck preset for face verification */
-    selfieCheck: typeof selfieCheck;
+    /** Create a SelfieCheckLegacy preset for face verification */
+    selfieCheckLegacy: typeof selfieCheckLegacy;
 };
 
 /**
@@ -546,4 +546,4 @@ declare const isWeb: () => boolean;
  */
 declare const isNode: () => boolean;
 
-export { type AbiEncodedValue, type ConstraintNode, type CredentialRequestType, type CredentialType, type DocumentLegacyPreset, IDKit, type IDKitCompletionResult, type IDKitErrorCode, IDKitErrorCodes, type IDKitRequest, type IDKitRequestConfig, type IDKitResult, type IDKitResultSession, type IDKitSessionConfig, type OrbLegacyPreset, type Preset, type ResponseItemSession, type ResponseItemV3, type ResponseItemV4, type RpContext, type SecureDocumentLegacyPreset, type SelfieCheckPreset, type Status$1 as Status, type WaitOptions, documentLegacy, isNode, isReactNative, isWeb, orbLegacy, secureDocumentLegacy, selfieCheck };
+export { type AbiEncodedValue, type ConstraintNode, type CredentialRequestType, type CredentialType, type DocumentLegacyPreset, IDKit, type IDKitCompletionResult, type IDKitErrorCode, IDKitErrorCodes, type IDKitRequest, type IDKitRequestConfig, type IDKitResult, type IDKitResultSession, type IDKitSessionConfig, type OrbLegacyPreset, type Preset, type ResponseItemSession, type ResponseItemV3, type ResponseItemV4, type RpContext, type SecureDocumentLegacyPreset, type SelfieCheckLegacyPreset, type Status$1 as Status, type WaitOptions, documentLegacy, isNode, isReactNative, isWeb, orbLegacy, secureDocumentLegacy, selfieCheckLegacy };

package/dist/index.js

@@ -389,14 +389,14 @@ function hashSignal(signal) {
     wasm.__wbindgen_export4(deferred2_0, deferred2_1, 1);
   }
 }
-function __wasm_bindgen_func_elem_605(arg0, arg1) {
-  wasm.__wasm_bindgen_func_elem_605(arg0, arg1);
+function __wasm_bindgen_func_elem_972(arg0, arg1, arg2) {
+  wasm.__wasm_bindgen_func_elem_972(arg0, arg1, addHeapObject(arg2));
 }
-function __wasm_bindgen_func_elem_968(arg0, arg1, arg2) {
-  wasm.__wasm_bindgen_func_elem_968(arg0, arg1, addHeapObject(arg2));
+function __wasm_bindgen_func_elem_609(arg0, arg1) {
+  wasm.__wasm_bindgen_func_elem_609(arg0, arg1);
 }
-function __wasm_bindgen_func_elem_1353(arg0, arg1, arg2, arg3) {
-  wasm.__wasm_bindgen_func_elem_1353(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+function __wasm_bindgen_func_elem_1357(arg0, arg1, arg2, arg3) {
+  wasm.__wasm_bindgen_func_elem_1357(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
 }
 var __wbindgen_enum_RequestCache = ["default", "no-store", "reload", "no-cache", "force-cache", "only-if-cached"];
 var __wbindgen_enum_RequestCredentials = ["omit", "same-origin", "include"];
@@ -884,6 +884,35 @@ var IDKitBuilder = class _IDKitBuilder {
       wasm.__wbindgen_add_to_stack_pointer(16);
     }
   }
+  /**
+   * Builds a v1 (legacy) native payload from a preset (synchronous, no bridge connection).
+   *
+   * Used by the native transport when the World App only supports verify v1.
+   * Only legacy presets produce valid v1 payloads (constraints always have
+   * `Deprecated` verification level and will fail).
+   *
+   * # Errors
+   *
+   * Returns an error if the preset is invalid or v1 payload construction fails.
+   * @param {any} preset_json
+   * @returns {any}
+   */
+  nativePayloadV1FromPreset(preset_json) {
+    try {
+      const ptr = this.__destroy_into_raw();
+      const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+      wasm.idkitbuilder_nativePayloadV1FromPreset(retptr, ptr, addHeapObject(preset_json));
+      var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+      var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+      var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+      if (r2) {
+        throw takeObject(r1);
+      }
+      return takeObject(r0);
+    } finally {
+      wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+  }
   /**
    * Creates a new builder for uniqueness requests
    * @param {string} app_id
@@ -1559,7 +1588,7 @@ function __wbg_get_imports() {
         const a = state0.a;
         state0.a = 0;
         try {
-          return __wasm_bindgen_func_elem_1353(a, state0.b, arg02, arg12);
+          return __wasm_bindgen_func_elem_1357(a, state0.b, arg02, arg12);
         } finally {
           state0.a = a;
         }
@@ -1769,7 +1798,7 @@ function __wbg_get_imports() {
     return addHeapObject(ret);
   };
   imports.wbg.__wbindgen_cast_02740531cfdb05fe = function(arg0, arg1) {
-    const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_604, __wasm_bindgen_func_elem_605);
+    const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_608, __wasm_bindgen_func_elem_609);
     return addHeapObject(ret);
   };
   imports.wbg.__wbindgen_cast_2241b6af4c4b2941 = function(arg0, arg1) {
@@ -1793,7 +1822,7 @@ function __wbg_get_imports() {
     return addHeapObject(ret);
   };
   imports.wbg.__wbindgen_cast_f23235b6472d5cf3 = function(arg0, arg1) {
-    const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_967, __wasm_bindgen_func_elem_968);
+    const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_971, __wasm_bindgen_func_elem_972);
     return addHeapObject(ret);
   };
   imports.wbg.__wbindgen_object_clone_ref = function(arg0) {
@@ -1877,21 +1906,32 @@ var MINIAPP_VERIFY_ACTION = "miniapp-verify-action";
 function isInWorldApp() {
   return typeof window !== "undefined" && Boolean(window.WorldApp);
 }
+function getWorldAppVerifyVersion() {
+  const cmds = window.WorldApp?.supported_commands;
+  if (!Array.isArray(cmds)) return 1;
+  const verify = cmds.find((c) => c.name === "verify");
+  return verify?.supported_versions?.includes(2) ? 2 : 1;
+}
 var _requestCounter = 0;
 var _activeNativeRequest = null;
-function createNativeRequest(wasmPayload, config, signalHashes = {}) {
+function createNativeRequest(wasmPayload, config, signalHashes = {}, version) {
   if (_activeNativeRequest?.isPending()) {
     console.warn(
       "IDKit native request already in flight. Reusing active request."
     );
     return _activeNativeRequest;
   }
-  const request2 = new NativeIDKitRequest(wasmPayload, config, signalHashes);
+  const request2 = new NativeIDKitRequest(
+    wasmPayload,
+    config,
+    signalHashes,
+    version
+  );
   _activeNativeRequest = request2;
   return request2;
 }
 var NativeIDKitRequest = class {
-  constructor(wasmPayload, config, signalHashes = {}) {
+  constructor(wasmPayload, config, signalHashes = {}, version) {
     this.connectorURI = "";
     this.resolved = false;
     this.cancelled = false;
@@ -1945,7 +1985,7 @@ var NativeIDKitRequest = class {
       }
       const sendPayload = {
         command: "verify",
-        version: 2,
+        version,
         payload: wasmPayload
       };
       const w = window;
@@ -2177,8 +2217,8 @@ function secureDocumentLegacy(opts = {}) {
 function documentLegacy(opts = {}) {
   return { type: "DocumentLegacy", signal: opts.signal };
 }
-function selfieCheck(opts = {}) {
-  return { type: "SelfieCheck", signal: opts.signal };
+function selfieCheckLegacy(opts = {}) {
+  return { type: "SelfieCheckLegacy", signal: opts.signal };
 }
 function createWasmBuilderFromConfig(config) {
   if (!config.rp_context) {
@@ -2241,15 +2281,23 @@ var IDKitBuilder2 = class {
    */
   async constraints(constraints) {
     await initIDKit();
-    const wasmBuilder = createWasmBuilderFromConfig(this.config);
     if (isInWorldApp()) {
-      const wasmResult = wasmBuilder.nativePayload(constraints);
+      const verifyVersion = getWorldAppVerifyVersion();
+      if (verifyVersion < 2) {
+        throw new Error(
+          "verify v2 is not supported by this World App version. Use a legacy preset (e.g. orbLegacy()) or update the World App."
+        );
+      }
+      const wasmBuilder2 = createWasmBuilderFromConfig(this.config);
+      const wasmResult = wasmBuilder2.nativePayload(constraints);
       return createNativeRequest(
         wasmResult.payload,
         this.config,
-        wasmResult.signal_hashes ?? {}
+        wasmResult.signal_hashes ?? {},
+        2
       );
     }
+    const wasmBuilder = createWasmBuilderFromConfig(this.config);
     const wasmRequest = await wasmBuilder.constraints(
       constraints
     );
@@ -2261,7 +2309,7 @@ var IDKitBuilder2 = class {
    * Presets provide a simplified way to create requests with predefined
    * credential configurations.
    *
-   * @param preset - A preset object from orbLegacy(), secureDocumentLegacy(), documentLegacy(), or selfieCheck()
+   * @param preset - A preset object from orbLegacy(), secureDocumentLegacy(), documentLegacy(), or selfieCheckLegacy()
    * @returns A new IDKitRequest instance
    *
    * @example
@@ -2272,15 +2320,37 @@ var IDKitBuilder2 = class {
    */
   async preset(preset) {
     await initIDKit();
-    const wasmBuilder = createWasmBuilderFromConfig(this.config);
     if (isInWorldApp()) {
-      const wasmResult = wasmBuilder.nativePayloadFromPreset(preset);
-      return createNativeRequest(
-        wasmResult.payload,
-        this.config,
-        wasmResult.signal_hashes ?? {}
-      );
+      const verifyVersion = getWorldAppVerifyVersion();
+      if (verifyVersion === 2) {
+        const wasmBuilder2 = createWasmBuilderFromConfig(this.config);
+        const wasmResult = wasmBuilder2.nativePayloadFromPreset(preset);
+        return createNativeRequest(
+          wasmResult.payload,
+          this.config,
+          wasmResult.signal_hashes ?? {},
+          2
+        );
+      }
+      try {
+        const wasmBuilder2 = createWasmBuilderFromConfig(this.config);
+        const wasmResult = wasmBuilder2.nativePayloadV1FromPreset(preset);
+        return createNativeRequest(
+          wasmResult.payload,
+          this.config,
+          wasmResult.signal_hashes ?? {},
+          1
+        );
+      } catch (err) {
+        if (err instanceof Error && String(err.message).includes("v1 payload")) {
+          throw new Error(
+            "verify v2 is not supported by this World App version. Use a legacy preset (e.g. orbLegacy()) or update the World App."
+          );
+        }
+        throw err;
+      }
     }
+    const wasmBuilder = createWasmBuilderFromConfig(this.config);
     const wasmRequest = await wasmBuilder.preset(
       preset
     );
@@ -2338,8 +2408,8 @@ var IDKit = {
   secureDocumentLegacy,
   /** Create a DocumentLegacy preset for World ID 3.0 legacy support */
   documentLegacy,
-  /** Create a SelfieCheck preset for face verification */
-  selfieCheck
+  /** Create a SelfieCheckLegacy preset for face verification */
+  selfieCheckLegacy
 };
 
 // src/lib/platform.ts
@@ -2373,4 +2443,4 @@ function isValidHex(s) {
   return /^[0-9a-fA-F]+$/.test(s);
 }
 
-export { IDKit, IDKitErrorCodes, documentLegacy, hashSignal2 as hashSignal, isNode, isReactNative, isWeb, orbLegacy, secureDocumentLegacy, selfieCheck };
+export { IDKit, IDKitErrorCodes, documentLegacy, hashSignal2 as hashSignal, isNode, isReactNative, isWeb, orbLegacy, secureDocumentLegacy, selfieCheckLegacy };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@worldcoin/idkit-core",
-  "version": "4.0.7",
+  "version": "4.0.9-dev.648eacc",
   "description": "Core IDKit SDK for World ID - Pure TypeScript, no dependencies",
   "type": "module",
   "main": "./dist/index.cjs",