@sorisdk/matcher 0.1.2 → 0.1.4

package/README.md

@@ -14,6 +14,11 @@ npm install @sorisdk/matcher
 
 Vite-based apps need `vite-plugin-wasm`.
 
+The default loader is intended to work in both Vite dev/build and Nuxt client production bundles. If you need to override wasm loading explicitly, pass either:
+
+- `loader: () => import("@sorisdk/matcher/generated/core.js")`
+- `wasmModule: await import("@sorisdk/matcher/generated/core.js")`
+
 ## Minimal example
 
 ```ts
@@ -33,6 +38,21 @@ await session.addEntry(
 const result = await session.match(new Uint8Array([1, 2, 3]));
 
 console.log(result.best);
+console.log(await session.getEntryMetadata("demo-track"));
+```
+
+## Advanced wasm loading
+
+```ts
+import { MatcherSession, initMatcher } from "@sorisdk/matcher";
+
+await initMatcher({
+  loader: () => import("@sorisdk/matcher/generated/core.js")
+});
+
+const session = new MatcherSession({
+  wasmModule: await import("@sorisdk/matcher/generated/core.js")
+});
 ```
 
 ## Pack loading
@@ -48,3 +68,13 @@ console.log(result.best);
 - `URL`
 
 If you want campaign events and browser recognition flow on top of matching, use `@sorisdk/web-audio`.
+
+## Metadata lookup
+
+Audiopack footer metadata is available through explicit lookup rather than being
+embedded in `MatchResult`.
+
+```ts
+const best = await session.bestMatch(queryBytes);
+const metadata = best ? await session.getEntryMetadata(best.name) : null;
+```

package/dist/default-loader.js

@@ -0,0 +1,5 @@
+import * as generatedModule from "./generated/core.js";
+
+export default async function defaultWasmLoader() {
+  return generatedModule;
+}

package/dist/generated/core.d.ts

@@ -5,8 +5,9 @@ export class WasmMatcherDatabase {
     free(): void;
     [Symbol.dispose](): void;
     addEntry(name: string, afp_type: number, buffer: Uint8Array): void;
-    addOrReplace(name: string, afp_type: number, buffer: Uint8Array): void;
+    addOrReplace(name: string, afp_type: number, buffer: Uint8Array, metadata?: any | null): void;
     clear(): void;
+    getEntryMetadata(name: string): any;
     loadPackBytes(bytes: Uint8Array): void;
     loadPackBytesAppend(bytes: Uint8Array): void;
     constructor();

package/dist/generated/core.js

@@ -1,7 +1,7 @@
 /* @ts-self-types="./core.d.ts" */
-
 import * as wasm from "./core_bg.wasm";
 import { __wbg_set_wasm } from "./core_bg.js";
+
 __wbg_set_wasm(wasm);
 wasm.__wbindgen_start();
 export {

package/dist/generated/core_bg.js

@@ -28,13 +28,14 @@ export class WasmMatcherDatabase {
      * @param {string} name
      * @param {number} afp_type
      * @param {Uint8Array} buffer
+     * @param {any | null} [metadata]
      */
-    addOrReplace(name, afp_type, buffer) {
+    addOrReplace(name, afp_type, buffer, metadata) {
         const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
         const ptr1 = passArray8ToWasm0(buffer, wasm.__wbindgen_malloc);
         const len1 = WASM_VECTOR_LEN;
-        const ret = wasm.wasmmatcherdatabase_addOrReplace(this.__wbg_ptr, ptr0, len0, afp_type, ptr1, len1);
+        const ret = wasm.wasmmatcherdatabase_addOrReplace(this.__wbg_ptr, ptr0, len0, afp_type, ptr1, len1, isLikeNone(metadata) ? 0 : addToExternrefTable0(metadata));
         if (ret[1]) {
             throw takeFromExternrefTable0(ret[0]);
         }
@@ -42,6 +43,19 @@ export class WasmMatcherDatabase {
     clear() {
         wasm.wasmmatcherdatabase_clear(this.__wbg_ptr);
     }
+    /**
+     * @param {string} name
+     * @returns {any}
+     */
+    getEntryMetadata(name) {
+        const ptr0 = passStringToWasm0(name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.wasmmatcherdatabase_getEntryMetadata(this.__wbg_ptr, ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * @returns {number}
      */
@@ -149,11 +163,11 @@ if (Symbol.dispose) WasmMatcherEngine.prototype[Symbol.dispose] = WasmMatcherEng
 export function init_matcher_wasm() {
     wasm.init_matcher_wasm();
 }
-export function __wbg_Error_2e59b1b37a9a34c3(arg0, arg1) {
+export function __wbg_Error_960c155d3d49e4c2(arg0, arg1) {
     const ret = Error(getStringFromWasm0(arg0, arg1));
     return ret;
 }
-export function __wbg_Number_e6ffdb596c888833(arg0) {
+export function __wbg_Number_32bf70a599af1d4b(arg0) {
     const ret = Number(arg0);
     return ret;
 }
@@ -164,46 +178,68 @@ export function __wbg_String_8564e559799eccda(arg0, arg1) {
     getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
 }
-export function __wbg___wbindgen_boolean_get_a86c216575a75c30(arg0) {
+export function __wbg___wbindgen_bigint_get_as_i64_3d3aba5d616c6a51(arg0, arg1) {
+    const v = arg1;
+    const ret = typeof(v) === 'bigint' ? v : undefined;
+    getDataViewMemory0().setBigInt64(arg0 + 8 * 1, isLikeNone(ret) ? BigInt(0) : ret, true);
+    getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
+}
+export function __wbg___wbindgen_boolean_get_6ea149f0a8dcc5ff(arg0) {
     const v = arg0;
     const ret = typeof(v) === 'boolean' ? v : undefined;
     return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
 }
-export function __wbg___wbindgen_debug_string_dd5d2d07ce9e6c57(arg0, arg1) {
+export function __wbg___wbindgen_debug_string_ab4b34d23d6778bd(arg0, arg1) {
     const ret = debugString(arg1);
     const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
     const len1 = WASM_VECTOR_LEN;
     getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
 }
-export function __wbg___wbindgen_in_4bd7a57e54337366(arg0, arg1) {
+export function __wbg___wbindgen_in_a5d8b22e52b24dd1(arg0, arg1) {
     const ret = arg0 in arg1;
     return ret;
 }
-export function __wbg___wbindgen_is_null_344c8750a8525473(arg0) {
+export function __wbg___wbindgen_is_bigint_ec25c7f91b4d9e93(arg0) {
+    const ret = typeof(arg0) === 'bigint';
+    return ret;
+}
+export function __wbg___wbindgen_is_function_3baa9db1a987f47d(arg0) {
+    const ret = typeof(arg0) === 'function';
+    return ret;
+}
+export function __wbg___wbindgen_is_null_52ff4ec04186736f(arg0) {
     const ret = arg0 === null;
     return ret;
 }
-export function __wbg___wbindgen_is_object_40c5a80572e8f9d3(arg0) {
+export function __wbg___wbindgen_is_object_63322ec0cd6ea4ef(arg0) {
     const val = arg0;
     const ret = typeof(val) === 'object' && val !== null;
     return ret;
 }
-export function __wbg___wbindgen_is_undefined_c0cca72b82b86f4d(arg0) {
+export function __wbg___wbindgen_is_string_6df3bf7ef1164ed3(arg0) {
+    const ret = typeof(arg0) === 'string';
+    return ret;
+}
+export function __wbg___wbindgen_is_undefined_29a43b4d42920abd(arg0) {
     const ret = arg0 === undefined;
     return ret;
 }
-export function __wbg___wbindgen_jsval_loose_eq_3a72ae764d46d944(arg0, arg1) {
+export function __wbg___wbindgen_jsval_eq_d3465d8a07697228(arg0, arg1) {
+    const ret = arg0 === arg1;
+    return ret;
+}
+export function __wbg___wbindgen_jsval_loose_eq_cac3565e89b4134c(arg0, arg1) {
     const ret = arg0 == arg1;
     return ret;
 }
-export function __wbg___wbindgen_number_get_7579aab02a8a620c(arg0, arg1) {
+export function __wbg___wbindgen_number_get_c7f42aed0525c451(arg0, arg1) {
     const obj = arg1;
     const ret = typeof(obj) === 'number' ? obj : undefined;
     getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
 }
-export function __wbg___wbindgen_string_get_914df97fcfa788f2(arg0, arg1) {
+export function __wbg___wbindgen_string_get_7ed5322991caaec5(arg0, arg1) {
     const obj = arg1;
     const ret = typeof(obj) === 'string' ? obj : undefined;
     var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -211,9 +247,21 @@ export function __wbg___wbindgen_string_get_914df97fcfa788f2(arg0, arg1) {
     getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
 }
-export function __wbg___wbindgen_throw_81fc77679af83bc6(arg0, arg1) {
+export function __wbg___wbindgen_throw_6b64449b9b9ed33c(arg0, arg1) {
     throw new Error(getStringFromWasm0(arg0, arg1));
 }
+export function __wbg_call_14b169f759b26747() { return handleError(function (arg0, arg1) {
+    const ret = arg0.call(arg1);
+    return ret;
+}, arguments); }
+export function __wbg_done_9158f7cc8751ba32(arg0) {
+    const ret = arg0.done;
+    return ret;
+}
+export function __wbg_entries_e0b73aa8571ddb56(arg0) {
+    const ret = Object.entries(arg0);
+    return ret;
+}
 export function __wbg_error_a6fa202b58aa1cd3(arg0, arg1) {
     let deferred0_0;
     let deferred0_1;
@@ -225,11 +273,23 @@ export function __wbg_error_a6fa202b58aa1cd3(arg0, arg1) {
         wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
     }
 }
+export function __wbg_get_1affdbdd5573b16a() { return handleError(function (arg0, arg1) {
+    const ret = Reflect.get(arg0, arg1);
+    return ret;
+}, arguments); }
+export function __wbg_get_8360291721e2339f(arg0, arg1) {
+    const ret = arg0[arg1 >>> 0];
+    return ret;
+}
+export function __wbg_get_unchecked_17f53dad852b9588(arg0, arg1) {
+    const ret = arg0[arg1 >>> 0];
+    return ret;
+}
 export function __wbg_get_with_ref_key_6412cf3094599694(arg0, arg1) {
     const ret = arg0[arg1];
     return ret;
 }
-export function __wbg_instanceof_ArrayBuffer_ff7c1337a5e3b33a(arg0) {
+export function __wbg_instanceof_ArrayBuffer_7c8433c6ed14ffe3(arg0) {
     let result;
     try {
         result = arg0 instanceof ArrayBuffer;
@@ -239,7 +299,17 @@ export function __wbg_instanceof_ArrayBuffer_ff7c1337a5e3b33a(arg0) {
     const ret = result;
     return ret;
 }
-export function __wbg_instanceof_Uint8Array_4b8da683deb25d72(arg0) {
+export function __wbg_instanceof_Map_1b76fd4635be43eb(arg0) {
+    let result;
+    try {
+        result = arg0 instanceof Map;
+    } catch (_) {
+        result = false;
+    }
+    const ret = result;
+    return ret;
+}
+export function __wbg_instanceof_Uint8Array_152ba1f289edcf3f(arg0) {
     let result;
     try {
         result = arg0 instanceof Uint8Array;
@@ -249,42 +319,70 @@ export function __wbg_instanceof_Uint8Array_4b8da683deb25d72(arg0) {
     const ret = result;
     return ret;
 }
-export function __wbg_isSafeInteger_ea83862ba994770c(arg0) {
+export function __wbg_isArray_c3109d14ffc06469(arg0) {
+    const ret = Array.isArray(arg0);
+    return ret;
+}
+export function __wbg_isSafeInteger_4fc213d1989d6d2a(arg0) {
     const ret = Number.isSafeInteger(arg0);
     return ret;
 }
-export function __wbg_length_0c32cb8543c8e4c8(arg0) {
+export function __wbg_iterator_013bc09ec998c2a7() {
+    const ret = Symbol.iterator;
+    return ret;
+}
+export function __wbg_length_3d4ecd04bd8d22f1(arg0) {
+    const ret = arg0.length;
+    return ret;
+}
+export function __wbg_length_9f1775224cf1d815(arg0) {
     const ret = arg0.length;
     return ret;
 }
+export function __wbg_new_0c7403db6e782f19(arg0) {
+    const ret = new Uint8Array(arg0);
+    return ret;
+}
 export function __wbg_new_227d7c05414eb861() {
     const ret = new Error();
     return ret;
 }
-export function __wbg_new_4f9fafbb3909af72() {
-    const ret = new Object();
+export function __wbg_new_34d45cc8e36aaead() {
+    const ret = new Map();
     return ret;
 }
-export function __wbg_new_a560378ea1240b14(arg0) {
-    const ret = new Uint8Array(arg0);
+export function __wbg_new_682678e2f47e32bc() {
+    const ret = new Array();
     return ret;
 }
-export function __wbg_new_f3c9df4f38f3f798() {
-    const ret = new Array();
+export function __wbg_new_aa8d0fa9762c29bd() {
+    const ret = new Object();
     return ret;
 }
-export function __wbg_now_88621c9c9a4f3ffc() {
+export function __wbg_next_0340c4ae324393c3() { return handleError(function (arg0) {
+    const ret = arg0.next();
+    return ret;
+}, arguments); }
+export function __wbg_next_7646edaa39458ef7(arg0) {
+    const ret = arg0.next;
+    return ret;
+}
+export function __wbg_now_a9b7df1cbee90986() {
     const ret = Date.now();
     return ret;
 }
-export function __wbg_prototypesetcall_3e05eb9545565046(arg0, arg1, arg2) {
+export function __wbg_prototypesetcall_a6b02eb00b0f4ce2(arg0, arg1, arg2) {
     Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
 }
+export function __wbg_set_3bf1de9fab0cd644(arg0, arg1, arg2) {
+    arg0[arg1 >>> 0] = arg2;
+}
 export function __wbg_set_6be42768c690e380(arg0, arg1, arg2) {
     arg0[arg1] = arg2;
 }
-export function __wbg_set_6c60b2e8ad0e9383(arg0, arg1, arg2) {
-    arg0[arg1 >>> 0] = arg2;
+export function __wbg_set_fde2cec06c23692b(arg0, arg1, arg2) {
+    const ret = arg0.set(arg1, arg2);
+    return ret;
 }
 export function __wbg_stack_3b0d974bbf31e44f(arg0, arg1) {
     const ret = arg1.stack;
@@ -293,17 +391,26 @@ export function __wbg_stack_3b0d974bbf31e44f(arg0, arg1) {
     getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
 }
+export function __wbg_value_ee3a06f4579184fa(arg0) {
+    const ret = arg0.value;
+    return ret;
+}
 export function __wbindgen_cast_0000000000000001(arg0) {
     // Cast intrinsic for `F64 -> Externref`.
     const ret = arg0;
     return ret;
 }
-export function __wbindgen_cast_0000000000000002(arg0, arg1) {
+export function __wbindgen_cast_0000000000000002(arg0) {
+    // Cast intrinsic for `I64 -> Externref`.
+    const ret = arg0;
+    return ret;
+}
+export function __wbindgen_cast_0000000000000003(arg0, arg1) {
     // Cast intrinsic for `Ref(String) -> Externref`.
     const ret = getStringFromWasm0(arg0, arg1);
     return ret;
 }
-export function __wbindgen_cast_0000000000000003(arg0) {
+export function __wbindgen_cast_0000000000000004(arg0) {
     // Cast intrinsic for `U64 -> Externref`.
     const ret = BigInt.asUintN(64, arg0);
     return ret;
@@ -427,6 +534,15 @@ function getUint8ArrayMemory0() {
     return cachedUint8ArrayMemory0;
 }
 
+function handleError(f, args) {
+    try {
+        return f.apply(this, args);
+    } catch (e) {
+        const idx = addToExternrefTable0(e);
+        wasm.__wbindgen_exn_store(idx);
+    }
+}
+
 function isLikeNone(x) {
     return x === undefined || x === null;
 }

package/dist/generated/core_bg.wasm.d.ts

@@ -4,8 +4,9 @@ export const memory: WebAssembly.Memory;
 export const __wbg_wasmmatcherdatabase_free: (a: number, b: number) => void;
 export const __wbg_wasmmatcherengine_free: (a: number, b: number) => void;
 export const wasmmatcherdatabase_addEntry: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
-export const wasmmatcherdatabase_addOrReplace: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+export const wasmmatcherdatabase_addOrReplace: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
 export const wasmmatcherdatabase_clear: (a: number) => void;
+export const wasmmatcherdatabase_getEntryMetadata: (a: number, b: number, c: number) => [number, number, number];
 export const wasmmatcherdatabase_length: (a: number) => number;
 export const wasmmatcherdatabase_loadPackBytes: (a: number, b: number, c: number) => [number, number];
 export const wasmmatcherdatabase_loadPackBytesAppend: (a: number, b: number, c: number) => [number, number];
@@ -18,8 +19,9 @@ export const wasmmatcherengine_resetDistinctMatchState: (a: number) => void;
 export const init_matcher_wasm: () => void;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
-export const __wbindgen_free: (a: number, b: number, c: number) => void;
+export const __wbindgen_exn_store: (a: number) => void;
+export const __externref_table_alloc: () => number;
 export const __wbindgen_externrefs: WebAssembly.Table;
+export const __wbindgen_free: (a: number, b: number, c: number) => void;
 export const __externref_table_dealloc: (a: number) => void;
-export const __externref_table_alloc: () => number;
 export const __wbindgen_start: () => void;

package/dist/index.d.ts

@@ -8,6 +8,14 @@ interface MatchConfig {
     scoreThreshold?: number;
     gapThreshold?: number;
 }
+interface EntryMetadata {
+    id?: string | null;
+    name?: string | null;
+    title?: string | null;
+    image?: string | null;
+    type?: string | null;
+    [key: string]: unknown;
+}
 interface MatchResult {
     name: string;
     score: number;
@@ -125,9 +133,10 @@ declare class MatcherSession {
     ready(): Promise<void>;
     loadPack(source: PackSource): Promise<void>;
     addEntry(name: string, afpType: AudioFingerprintType, fingerprint: Uint8Array): Promise<void>;
-    addOrReplace(name: string, afpType: AudioFingerprintType, fingerprint: Uint8Array): Promise<void>;
+    addOrReplace(name: string, afpType: AudioFingerprintType, fingerprint: Uint8Array, metadata?: EntryMetadata | null): Promise<void>;
     removeEntry(name: string): Promise<void>;
     clear(): Promise<void>;
+    getEntryMetadata(name: string): Promise<EntryMetadata | null>;
     match(query: Uint8Array, config?: MatchConfig): Promise<MatchResult[]>;
     bestMatch(query: Uint8Array, config?: MatchConfig): Promise<MatchResult | null>;
     destroy(): void;
@@ -142,4 +151,4 @@ declare function __setMatcherWasmModuleForTests(moduleLike: unknown): void;
 declare function __setMatcherEmbeddedPackForTests(bytes: Uint8Array): void;
 declare function __resetMatcherWasmForTests(): void;
 
-export { AudioFingerprintType, type InitMatcherOptions, type InitMatcherResult, type MatchConfig, type MatchResult, type MatcherEphemeralAuthOptions, type MatcherEphemeralAuthResult, type MatcherEphemeralKeyExchangeMetadata, type MatcherEphemeralKeyExchangeOptions, MatcherSession, type MatcherSessionEventMap, type MatcherSessionEventName, type MatcherSessionListener, type MatcherSessionOptions, type PackSource, __resetMatcherWasmForTests, __setMatcherEmbeddedPackForTests, __setMatcherWasmModuleForTests, initMatcher };
+export { AudioFingerprintType, type EntryMetadata, type InitMatcherOptions, type InitMatcherResult, type MatchConfig, type MatchResult, type MatcherEphemeralAuthOptions, type MatcherEphemeralAuthResult, type MatcherEphemeralKeyExchangeMetadata, type MatcherEphemeralKeyExchangeOptions, MatcherSession, type MatcherSessionEventMap, type MatcherSessionEventName, type MatcherSessionListener, type MatcherSessionOptions, type PackSource, __resetMatcherWasmForTests, __setMatcherEmbeddedPackForTests, __setMatcherWasmModuleForTests, initMatcher };

package/dist/index.js

@@ -289,11 +289,8 @@ function getCallable(obj, names) {
   return null;
 }
 var defaultLoader = async () => {
-  const generatedModuleUrl = new URL("./generated/core.js", import.meta.url);
-  return import(
-    /* @vite-ignore */
-    generatedModuleUrl.href
-  );
+  const loaderModule = await import("./default-loader.js");
+  return loaderModule.default();
 };
 var INTERNAL_DUPLICATE_MATCH_FLAG = "__matcherDuplicate";
 var WrappedDatabase = class {
@@ -310,12 +307,12 @@ var WrappedDatabase = class {
     }
     fn.call(this.inner, name, afpType, fingerprint);
   }
-  addOrReplace(name, afpType, fingerprint) {
+  addOrReplace(name, afpType, fingerprint, metadata) {
     const fn = getCallable(this.inner, ["addOrReplace", "add_or_replace"]);
     if (!fn) {
       throw new Error("WASM database is missing addOrReplace");
     }
-    fn.call(this.inner, name, afpType, fingerprint);
+    fn.call(this.inner, name, afpType, fingerprint, metadata);
   }
   removeEntry(name) {
     const fn = getCallable(this.inner, ["removeEntry", "remove_entry"]);
@@ -350,6 +347,17 @@ var WrappedDatabase = class {
     }
     appendFn.call(this.inner, bytes);
   }
+  getEntryMetadata(name) {
+    const fn = getCallable(this.inner, ["getEntryMetadata", "get_entry_metadata"]);
+    if (!fn) {
+      throw new Error("WASM database is missing getEntryMetadata-compatible method");
+    }
+    const raw = fn.call(this.inner, name);
+    if (!raw || typeof raw !== "object") {
+      return null;
+    }
+    return normalizeEntryMetadata(raw);
+  }
   destroy() {
     const fn = getCallable(this.inner, ["destroy", "free"]);
     if (fn) {
@@ -380,15 +388,18 @@ var WrappedMatcher = class {
     if (!raw) {
       return null;
     }
-    if (typeof raw === "object" && raw !== null && raw.duplicate === true && raw.best) {
-      const normalized = normalizeResult(raw.best);
-      Object.defineProperty(normalized, INTERNAL_DUPLICATE_MATCH_FLAG, {
-        value: true,
-        enumerable: false,
-        configurable: false,
-        writable: false
-      });
-      return normalized;
+    if (typeof raw === "object" && raw !== null) {
+      const duplicateResult = raw;
+      if (duplicateResult.duplicate === true && duplicateResult.best) {
+        const normalized = normalizeResult(duplicateResult.best);
+        Object.defineProperty(normalized, INTERNAL_DUPLICATE_MATCH_FLAG, {
+          value: true,
+          enumerable: false,
+          configurable: false,
+          writable: false
+        });
+        return normalized;
+      }
     }
     return normalizeResult(raw);
   }
@@ -412,6 +423,26 @@ function normalizeResult(raw) {
     afpType
   };
 }
+function normalizeEntryMetadata(raw) {
+  const {
+    _id: legacyId,
+    id,
+    kind,
+    type,
+    title,
+    name,
+    image,
+    ...rest
+  } = raw;
+  return {
+    ...rest,
+    ...id !== void 0 || legacyId !== void 0 ? { id: String(id ?? legacyId) } : {},
+    ...name !== void 0 ? { name: name == null ? null : String(name) } : {},
+    ...title !== void 0 ? { title: title == null ? null : String(title) } : {},
+    ...image !== void 0 ? { image: image == null ? null : String(image) } : {},
+    ...type !== void 0 || kind !== void 0 ? { type: type == null && kind == null ? null : String(type ?? kind) } : {}
+  };
+}
 function normalizeResults(rawResults) {
   return rawResults.filter((item) => typeof item === "object" && item !== null).map((item) => normalizeResult(item));
 }
@@ -557,10 +588,15 @@ var MatcherSession = class {
       handleError(this.events, "addEntry", error);
     }
   }
-  async addOrReplace(name, afpType, fingerprint) {
+  async addOrReplace(name, afpType, fingerprint, metadata) {
     try {
       await this.ensureLiveReady();
-      this.databaseOrThrow().addOrReplace(name, afpType, toUint8ArrayCopy(fingerprint));
+      this.databaseOrThrow().addOrReplace(
+        name,
+        afpType,
+        toUint8ArrayCopy(fingerprint),
+        metadata
+      );
       this.distinctMatchDeduper.reset();
       this.matcher?.resetDistinctMatchState?.();
     } catch (error) {
@@ -587,6 +623,14 @@ var MatcherSession = class {
       handleError(this.events, "clear", error);
     }
   }
+  async getEntryMetadata(name) {
+    try {
+      await this.ensureLiveReady();
+      return this.databaseOrThrow().getEntryMetadata(name);
+    } catch (error) {
+      handleError(this.events, "getEntryMetadata", error);
+    }
+  }
   async match(query, config) {
     try {
       await this.ensureLiveReady();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sorisdk/matcher",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Browser WASM SDK for audio fingerprint matching",
   "type": "module",
   "main": "./dist/index.js",
@@ -40,7 +40,7 @@
   "scripts": {
     "build:wasm": "node ../../scripts/build-wasm-package.mjs matcher",
     "build:assets": "node ./scripts/copy-assets.mjs",
-    "build": "tsup src/index.ts --format esm --dts && pnpm run build:wasm && pnpm run build:assets",
+    "build": "tsup src/index.ts --format esm --dts && pnpm run build:wasm && pnpm run build:assets && node ../../scripts/write-default-loader.mjs packages/matcher ./generated/core.js",
     "test": "vitest run",
     "test:watch": "vitest"
   }