@sorisdk/matcher 0.1.0 → 0.1.2

package/LICENSE.md

@@ -0,0 +1,50 @@
+Software Use License Agreement
+
+Copyright (c) iPlateia Inc. All rights reserved.
+
+This Software Use License Agreement ("Agreement") is a binding agreement between iPlateia Inc. ("Company") and the person or entity that installs, accesses, or uses this package ("Licensee").
+
+By installing, copying, accessing, or using the package, Licensee agrees to be bound by this Agreement. If Licensee does not agree, Licensee must not install, access, or use the package.
+
+1. Grant of License
+
+Subject to Licensee's full compliance with this Agreement, the Company grants Licensee a limited, non-exclusive, non-transferable, non-sublicensable, revocable license to use the package in object code or compiled form solely for Licensee's internal business use or other use expressly authorized by the Company.
+
+2. Restrictions
+
+Licensee must not, and must not permit any third party to:
+
+- modify, adapt, translate, alter, or create derivative works of the package;
+- reverse engineer, decompile, disassemble, decode, or otherwise attempt to derive the source code, underlying ideas, algorithms, file formats, or trade secrets of the package, except to the limited extent such restriction is prohibited by mandatory law;
+- copy, publish, distribute, transmit, disclose, sublicense, assign, sell, rent, lease, lend, transfer, pledge, or otherwise make the package available to any third party;
+- remove, obscure, or alter any copyright, trademark, confidentiality, or proprietary notice contained in the package;
+- use the package in violation of applicable law, public policy, or the Company's usage conditions;
+- use the package to disclose survey content, logs, technical information, or other service-related information to any third party.
+
+3. Ownership and Reservation of Rights
+
+The package is licensed, not sold. The package, including all intellectual property rights in and to the package, remains the exclusive property of the Company and its licensors. No rights are granted except as expressly stated in this Agreement.
+
+4. Confidentiality
+
+Any non-public information obtained through access to or use of the package, including technical materials, performance information, documentation, data formats, and service-related content, is confidential. Licensee must keep such information strictly confidential and must not disclose it to any third party without the Company's prior written consent.
+
+5. Changes, Suspension, and Termination
+
+The Company may modify, suspend, restrict, or discontinue all or part of the package at any time if reasonably required for operational, technical, security, or business reasons. If Licensee breaches this Agreement, the Company may immediately suspend or terminate this Agreement and Licensee's right to use the package. Upon termination, Licensee must immediately stop using the package and delete all copies in Licensee's possession or control.
+
+6. Disclaimer
+
+To the maximum extent permitted by law, the package is provided on an "as is" and "as available" basis without warranties of any kind, whether express, implied, statutory, or otherwise, including any implied warranties of merchantability, fitness for a particular purpose, title, non-infringement, accuracy, availability, or uninterrupted operation.
+
+7. Limitation of Liability
+
+To the maximum extent permitted by law, the Company will not be liable for any indirect, incidental, special, consequential, exemplary, or punitive damages, or for any loss of profits, revenues, business, goodwill, data, or use, arising out of or related to this Agreement or the package, even if advised of the possibility of such damages.
+
+8. Governing Law
+
+This Agreement is governed by the laws of the Republic of Korea, without regard to conflict of laws principles.
+
+9. Entire Agreement
+
+This Agreement constitutes the entire agreement between Licensee and the Company regarding the package and supersedes all prior or contemporaneous understandings relating to the package.

package/README.md

@@ -1,23 +1,43 @@
 # @sorisdk/matcher
 
-High-level browser/worker matcher session wrapper for the NADA wasm matcher runtime.
+WebAssembly package for matching fingerprint bytes against pack data in the browser.
 
-## API
+Most web integrations should use `@sorisdk/web-audio` for a simpler end-to-end flow. This package is intended for lower-level cases where you want to control fingerprint generation and matching yourself.
+
+Public integration guide: https://docs.soriapi.com/ko/integration/web
+
+## Installation
+
+```bash
+npm install @sorisdk/matcher
+```
+
+Vite-based apps need `vite-plugin-wasm`.
+
+## Minimal example
 
 ```ts
 import { MatcherSession, AudioFingerprintType, initMatcher } from "@sorisdk/matcher";
 
 await initMatcher();
+
 const session = new MatcherSession();
 await session.ready();
 
-await session.addEntry("track-1", AudioFingerprintType.Livestream, new Uint8Array([1, 2, 3]));
-const results = await session.match(new Uint8Array([1, 2, 3]));
+await session.addEntry(
+  "demo-track",
+  AudioFingerprintType.Livestream,
+  new Uint8Array([1, 2, 3])
+);
+
+const result = await session.match(new Uint8Array([1, 2, 3]));
+
+console.log(result.best);
 ```
 
-### Pack loading
+## Pack loading
 
-`loadPack` accepts:
+`loadPack(...)` accepts:
 
 - `Uint8Array`
 - `ArrayBuffer`
@@ -27,30 +47,4 @@ const results = await session.match(new Uint8Array([1, 2, 3]));
 - `string`
 - `URL`
 
-String/URL/Request sources use `fetch`.
-
-When you call `loadPack(...)`, the matcher package first performs an internal baseline-model load
-step, then applies your account/material pack. This internal step is hidden from callers; the
-public flow stays `initMatcher(...)` then `session.loadPack(yourPackSource)`.
-
-### Events
-
-- `ready`
-- `packloadstart`
-- `packload`
-- `querystart`
-- `match`
-- `nomatch`
-- `error`
-- `destroy`
-
-## Testing
-
-```bash
-pnpm --dir packages/matcher test
-```
-
-## Notes
-
-- This package build emits wasm-bindgen output into `dist/generated/`.
-- The same public API works on the main thread and in Dedicated Workers.
+If you want campaign events and browser recognition flow on top of matching, use `@sorisdk/web-audio`.

package/dist/generated/core_bg.js

@@ -149,11 +149,11 @@ if (Symbol.dispose) WasmMatcherEngine.prototype[Symbol.dispose] = WasmMatcherEng
 export function init_matcher_wasm() {
     wasm.init_matcher_wasm();
 }
-export function __wbg_Error_83742b46f01ce22d(arg0, arg1) {
+export function __wbg_Error_2e59b1b37a9a34c3(arg0, arg1) {
     const ret = Error(getStringFromWasm0(arg0, arg1));
     return ret;
 }
-export function __wbg_Number_a5a435bd7bbec835(arg0) {
+export function __wbg_Number_e6ffdb596c888833(arg0) {
     const ret = Number(arg0);
     return ret;
 }
@@ -164,46 +164,46 @@ 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_c0f3f60bac5a78d1(arg0) {
+export function __wbg___wbindgen_boolean_get_a86c216575a75c30(arg0) {
     const v = arg0;
     const ret = typeof(v) === 'boolean' ? v : undefined;
     return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
 }
-export function __wbg___wbindgen_debug_string_5398f5bb970e0daa(arg0, arg1) {
+export function __wbg___wbindgen_debug_string_dd5d2d07ce9e6c57(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_41dbb8413020e076(arg0, arg1) {
+export function __wbg___wbindgen_in_4bd7a57e54337366(arg0, arg1) {
     const ret = arg0 in arg1;
     return ret;
 }
-export function __wbg___wbindgen_is_null_0b605fc6b167c56f(arg0) {
+export function __wbg___wbindgen_is_null_344c8750a8525473(arg0) {
     const ret = arg0 === null;
     return ret;
 }
-export function __wbg___wbindgen_is_object_781bc9f159099513(arg0) {
+export function __wbg___wbindgen_is_object_40c5a80572e8f9d3(arg0) {
     const val = arg0;
     const ret = typeof(val) === 'object' && val !== null;
     return ret;
 }
-export function __wbg___wbindgen_is_undefined_52709e72fb9f179c(arg0) {
+export function __wbg___wbindgen_is_undefined_c0cca72b82b86f4d(arg0) {
     const ret = arg0 === undefined;
     return ret;
 }
-export function __wbg___wbindgen_jsval_loose_eq_5bcc3bed3c69e72b(arg0, arg1) {
+export function __wbg___wbindgen_jsval_loose_eq_3a72ae764d46d944(arg0, arg1) {
     const ret = arg0 == arg1;
     return ret;
 }
-export function __wbg___wbindgen_number_get_34bb9d9dcfa21373(arg0, arg1) {
+export function __wbg___wbindgen_number_get_7579aab02a8a620c(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_395e606bd0ee4427(arg0, arg1) {
+export function __wbg___wbindgen_string_get_914df97fcfa788f2(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,7 +211,7 @@ export function __wbg___wbindgen_string_get_395e606bd0ee4427(arg0, arg1) {
     getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
 }
-export function __wbg___wbindgen_throw_6ddd609b62940d55(arg0, arg1) {
+export function __wbg___wbindgen_throw_81fc77679af83bc6(arg0, arg1) {
     throw new Error(getStringFromWasm0(arg0, arg1));
 }
 export function __wbg_error_a6fa202b58aa1cd3(arg0, arg1) {
@@ -229,7 +229,7 @@ export function __wbg_get_with_ref_key_6412cf3094599694(arg0, arg1) {
     const ret = arg0[arg1];
     return ret;
 }
-export function __wbg_instanceof_ArrayBuffer_101e2bf31071a9f6(arg0) {
+export function __wbg_instanceof_ArrayBuffer_ff7c1337a5e3b33a(arg0) {
     let result;
     try {
         result = arg0 instanceof ArrayBuffer;
@@ -239,7 +239,7 @@ export function __wbg_instanceof_ArrayBuffer_101e2bf31071a9f6(arg0) {
     const ret = result;
     return ret;
 }
-export function __wbg_instanceof_Uint8Array_740438561a5b956d(arg0) {
+export function __wbg_instanceof_Uint8Array_4b8da683deb25d72(arg0) {
     let result;
     try {
         result = arg0 instanceof Uint8Array;
@@ -249,11 +249,11 @@ export function __wbg_instanceof_Uint8Array_740438561a5b956d(arg0) {
     const ret = result;
     return ret;
 }
-export function __wbg_isSafeInteger_ecd6a7f9c3e053cd(arg0) {
+export function __wbg_isSafeInteger_ea83862ba994770c(arg0) {
     const ret = Number.isSafeInteger(arg0);
     return ret;
 }
-export function __wbg_length_ea16607d7b61445b(arg0) {
+export function __wbg_length_0c32cb8543c8e4c8(arg0) {
     const ret = arg0.length;
     return ret;
 }
@@ -261,31 +261,31 @@ export function __wbg_new_227d7c05414eb861() {
     const ret = new Error();
     return ret;
 }
-export function __wbg_new_5f486cdf45a04d78(arg0) {
-    const ret = new Uint8Array(arg0);
+export function __wbg_new_4f9fafbb3909af72() {
+    const ret = new Object();
     return ret;
 }
-export function __wbg_new_a70fbab9066b301f() {
-    const ret = new Array();
+export function __wbg_new_a560378ea1240b14(arg0) {
+    const ret = new Uint8Array(arg0);
     return ret;
 }
-export function __wbg_new_ab79df5bd7c26067() {
-    const ret = new Object();
+export function __wbg_new_f3c9df4f38f3f798() {
+    const ret = new Array();
     return ret;
 }
-export function __wbg_now_16f0c993d5dd6c27() {
+export function __wbg_now_88621c9c9a4f3ffc() {
     const ret = Date.now();
     return ret;
 }
-export function __wbg_prototypesetcall_d62e5099504357e6(arg0, arg1, arg2) {
+export function __wbg_prototypesetcall_3e05eb9545565046(arg0, arg1, arg2) {
     Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
 }
-export function __wbg_set_282384002438957f(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_stack_3b0d974bbf31e44f(arg0, arg1) {
     const ret = arg1.stack;
     const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sorisdk/matcher",
-  "version": "0.1.0",
-  "description": "Browser-friendly WASM matcher session for NADA",
+  "version": "0.1.2",
+  "description": "Browser WASM SDK for audio fingerprint matching",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -30,16 +30,8 @@
     "matcher"
   ],
   "author": "comfuture",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/iplateia/nada.git",
-    "directory": "packages/matcher"
-  },
-  "homepage": "https://github.com/iplateia/nada/tree/main/packages/matcher",
-  "bugs": {
-    "url": "https://github.com/iplateia/nada/issues"
-  },
+  "license": "SEE LICENSE IN LICENSE.md",
+  "homepage": "https://docs.soriapi.com/ko/integration/web",
   "devDependencies": {
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",