@sorisdk/matcher 0.6.8 → 0.6.9

package/README.md

@@ -55,6 +55,38 @@ const session = new MatcherSession({
 });
 ```
 
+## Continuous recognition and reset
+
+Every query returns its matching result, including repeated material matches.
+`match`, `bestMatch`, and their variant methods share one event observer:
+continuous A → A emits one `match`, while A → B → A emits three. Material
+identity includes the fingerprint type. There is no material cooldown.
+
+Every successful observation resets the consecutive-miss counter and renews
+the run, even when its public event is suppressed. Two consecutive no-match
+results end the run and emit one `nomatch`; a single transient miss does not.
+A gap **greater than 30 seconds since the last successful observation** also
+ends continuity, including periods with no queries. This boundary is evaluated
+on the next query: a success emits a new `match` immediately, or a no-match
+emits `nomatch` without waiting for a second miss. The exported
+`MATCH_CONTINUITY_GAP_MS` is shared with Web activity reporting.
+
+Call `session.resetRecognitionState()` at an explicit input/capture boundary.
+It synchronously clears event suppression and invalidates pending queries from
+the previous run, retaining the loaded database. Invalidated queries return
+`null` (best-match methods) or `[]` (multi-match methods) without match/no-match
+events. Successful pack replacement and entry mutations also reset recognition
+state; a failed pack load retains the previous state and entries.
+
+The low-level generated WASM matcher always returns successful observations;
+event deduplication belongs to `MatcherSession`. Its existing
+`resetDistinctMatchState()` export remains available for compatibility.
+
+For source regression tests, build the package first with
+`corepack pnpm --filter @sorisdk/matcher build`, then run
+`corepack pnpm --filter @sorisdk/matcher test`. Tests include production WASM
+instantiated with the TypeScript session, using deterministic fingerprints.
+
 ## Pack loading
 
 `loadPack(...)` accepts:

package/dist/generated/core.d.ts

@@ -35,11 +35,21 @@ export class WasmMatcherEngine {
     matchQuery(database: WasmMatcherDatabase, query: Uint8Array, config?: any | null): any;
     matchQueryWithVariants(database: WasmMatcherDatabase, query: Uint8Array, pitch_query: any, config?: any | null, variant_config?: any | null): any;
     constructor();
+    /**
+     * Compatibility no-op: continuous-run deduplication belongs to MatcherSession.
+     * The binding returns every successful observation and retains no run state.
+     */
     resetDistinctMatchState(): void;
 }
 
 export function detectAudioMarker(pcm16_le: Uint8Array, sample_rate: number, config?: any | null): any;
 
+/**
+ * Explicit v1 policy; existing marker exports remain on the legacy policy.
+ * Result includes raw detection, normalized diagnostics and shared eligibility.
+ */
+export function detectAudioMarkerLevelRobust(pcm16_le: Uint8Array, sample_rate: number, config?: any | null, limits?: any | null): any;
+
 export function detectAudioMarkerWithLimits(pcm16_le: Uint8Array, sample_rate: number, config?: any | null, limits?: any | null): any;
 
 export function detectPatternMark(pcm16_le: Uint8Array, sample_rate: number, config?: any | null): any;

package/dist/generated/core.js

@@ -5,5 +5,5 @@ import { __wbg_set_wasm } from "./core_bg.js";
 __wbg_set_wasm(wasm);
 wasm.__wbindgen_start();
 export {
-    WasmMatcherDatabase, WasmMatcherEngine, detectAudioMarker, detectAudioMarkerWithLimits, detectPatternMark, detectPatternMarkWithLimits, estimatePitchRatio, estimatePitchRatioAgainstReference, estimatePitchRatioAgainstSpectralFeatures, extractPitchReference, extractSpectralShiftReference, init_matcher_wasm
+    WasmMatcherDatabase, WasmMatcherEngine, detectAudioMarker, detectAudioMarkerLevelRobust, detectAudioMarkerWithLimits, detectPatternMark, detectPatternMarkWithLimits, estimatePitchRatio, estimatePitchRatioAgainstReference, estimatePitchRatioAgainstSpectralFeatures, extractPitchReference, extractSpectralShiftReference, init_matcher_wasm
 } from "./core_bg.js";

package/dist/generated/core_bg.js

@@ -359,6 +359,10 @@ export class WasmMatcherEngine {
         WasmMatcherEngineFinalization.register(this, this.__wbg_ptr, this);
         return this;
     }
+    /**
+     * Compatibility no-op: continuous-run deduplication belongs to MatcherSession.
+     * The binding returns every successful observation and retains no run state.
+     */
     resetDistinctMatchState() {
         wasm.wasmmatcherengine_resetDistinctMatchState(this.__wbg_ptr);
     }
@@ -379,6 +383,23 @@ export function detectAudioMarker(pcm16_le, sample_rate, config) {
     return takeFromExternrefTable0(ret[0]);
 }
 
+/**
+ * Explicit v1 policy; existing marker exports remain on the legacy policy.
+ * Result includes raw detection, normalized diagnostics and shared eligibility.
+ * @param {Uint8Array} pcm16_le
+ * @param {number} sample_rate
+ * @param {any | null} [config]
+ * @param {any | null} [limits]
+ * @returns {any}
+ */
+export function detectAudioMarkerLevelRobust(pcm16_le, sample_rate, config, limits) {
+    const ret = wasm.detectAudioMarkerLevelRobust(pcm16_le, sample_rate, isLikeNone(config) ? 0 : addToExternrefTable0(config), isLikeNone(limits) ? 0 : addToExternrefTable0(limits));
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * @param {Uint8Array} pcm16_le
  * @param {number} sample_rate
@@ -599,6 +620,10 @@ export function __wbg_call_14b169f759b26747() { return handleError(function (arg
     const ret = arg0.call(arg1);
     return ret;
 }, arguments); }
+export function __wbg_call_a24592a6f349a97e() { return handleError(function (arg0, arg1, arg2) {
+    const ret = arg0.call(arg1, arg2);
+    return ret;
+}, arguments); }
 export function __wbg_done_9158f7cc8751ba32(arg0) {
     const ret = arg0.done;
     return ret;
@@ -618,10 +643,22 @@ export function __wbg_error_a6fa202b58aa1cd3(arg0, arg1) {
         wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
     }
 }
+export function __wbg_getOwnPropertyDescriptor_131bd582a45a6f5d(arg0, arg1) {
+    const ret = Object.getOwnPropertyDescriptor(arg0, arg1);
+    return ret;
+}
+export function __wbg_getPrototypeOf_a56da9261bbd1e5b(arg0) {
+    const ret = Object.getPrototypeOf(arg0);
+    return ret;
+}
 export function __wbg_get_1affdbdd5573b16a() { return handleError(function (arg0, arg1) {
     const ret = Reflect.get(arg0, arg1);
     return ret;
 }, arguments); }
+export function __wbg_get_6011fa3a58f61074() { 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;
@@ -716,10 +753,6 @@ 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_a6b02eb00b0f4ce2(arg0, arg1, arg2) {
     Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
 }
@@ -740,6 +773,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_static_accessor_GLOBAL_8cfadc87a297ca02() {
+    const ret = typeof global === 'undefined' ? null : global;
+    return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
+}
+export function __wbg_static_accessor_GLOBAL_THIS_602256ae5c8f42cf() {
+    const ret = typeof globalThis === 'undefined' ? null : globalThis;
+    return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
+}
+export function __wbg_static_accessor_SELF_e445c1c7484aecc3() {
+    const ret = typeof self === 'undefined' ? null : self;
+    return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
+}
+export function __wbg_static_accessor_WINDOW_f20e8576ef1e0f17() {
+    const ret = typeof window === 'undefined' ? null : window;
+    return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
+}
+export function __wbg_toStringTag_d6b1716c86d4892d() {
+    const ret = Symbol.toStringTag;
+    return ret;
+}
 export function __wbg_value_ee3a06f4579184fa(arg0) {
     const ret = arg0.value;
     return ret;
@@ -755,11 +808,16 @@ export function __wbindgen_cast_0000000000000002(arg0) {
     return ret;
 }
 export function __wbindgen_cast_0000000000000003(arg0, arg1) {
+    // Cast intrinsic for `Ref(Slice(U8)) -> NamedExternref("Uint8Array")`.
+    const ret = getArrayU8FromWasm0(arg0, arg1);
+    return ret;
+}
+export function __wbindgen_cast_0000000000000004(arg0, arg1) {
     // Cast intrinsic for `Ref(String) -> Externref`.
     const ret = getStringFromWasm0(arg0, arg1);
     return ret;
 }
-export function __wbindgen_cast_0000000000000004(arg0) {
+export function __wbindgen_cast_0000000000000005(arg0) {
     // Cast intrinsic for `U64 -> Externref`.
     const ret = BigInt.asUintN(64, arg0);
     return ret;

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

@@ -4,6 +4,7 @@ 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 detectAudioMarker: (a: any, b: number, c: number) => [number, number, number];
+export const detectAudioMarkerLevelRobust: (a: any, b: number, c: number, d: number) => [number, number, number];
 export const detectAudioMarkerWithLimits: (a: any, b: number, c: number, d: number) => [number, number, number];
 export const detectPatternMarkWithLimits: (a: any, b: number, c: number, d: number) => [number, number, number];
 export const estimatePitchRatio: (a: number, b: number, c: number) => [number, number, number];
@@ -27,7 +28,6 @@ export const wasmmatcherengine_bestMatch: (a: number, b: number, c: number, d: n
 export const wasmmatcherengine_bestMatchWithVariants: (a: number, b: number, c: number, d: number, e: any, f: number, g: number) => [number, number, number];
 export const wasmmatcherengine_detectAudioMarker: (a: number, b: any, c: number, d: number) => [number, number, number];
 export const wasmmatcherengine_detectAudioMarkerWithLimits: (a: number, b: any, c: number, d: number, e: number) => [number, number, number];
-export const wasmmatcherengine_detectPatternMark: (a: number, b: any, c: number, d: number) => [number, number, number];
 export const wasmmatcherengine_detectPatternMarkWithLimits: (a: number, b: any, c: number, d: number, e: number) => [number, number, number];
 export const wasmmatcherengine_estimatePitchRatio: (a: number, b: number, c: number, d: number) => [number, number, number];
 export const wasmmatcherengine_estimatePitchRatioAgainstReference: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number];
@@ -36,10 +36,11 @@ export const wasmmatcherengine_extractPitchReference: (a: number, b: number, c:
 export const wasmmatcherengine_extractSpectralShiftReference: (a: number, b: number, c: number, d: number) => [number, number, number];
 export const wasmmatcherengine_matchQuery: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
 export const wasmmatcherengine_matchQueryWithVariants: (a: number, b: number, c: number, d: number, e: any, f: number, g: number) => [number, number, number];
-export const wasmmatcherengine_new: () => number;
 export const wasmmatcherengine_resetDistinctMatchState: (a: number) => void;
+export const wasmmatcherengine_new: () => number;
 export const init_matcher_wasm: () => void;
 export const detectPatternMark: (a: any, b: number, c: number) => [number, number, number];
+export const wasmmatcherengine_detectPatternMark: (a: number, b: any, c: number, d: number) => [number, number, number];
 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_exn_store: (a: number) => void;

package/dist/index.d.ts

@@ -230,6 +230,7 @@ declare class MatcherSession {
     private matcher;
     private destroyed;
     private packLoadTail;
+    private recognitionGeneration;
     private readonly distinctMatchDeduper;
     constructor(options?: MatcherSessionOptions);
     on<T extends MatcherSessionEventName>(eventName: T, listener: MatcherSessionListener<T>): this;
@@ -255,6 +256,10 @@ declare class MatcherSession {
     detectAudioMarkerWithLimits(pcm16Le: Uint8Array, sampleRate: number, config: AudioMarkerConfig | undefined, limits: AudioMarkerLimits): Promise<AudioMarkerDetection>;
     matchWithVariants(query: Uint8Array, pitchQuery: VariantMatchQuery, config?: MatchConfig, variantConfig?: VariantMatchConfig): Promise<VariantMatch[]>;
     bestMatchWithVariants(query: Uint8Array, pitchQuery: VariantMatchQuery, config?: MatchConfig, variantConfig?: VariantMatchConfig): Promise<VariantMatch | null>;
+    /** End the current recognition run without removing loaded entries.
+     * Pending queries from the previous run cannot update event suppression state.
+     */
+    resetRecognitionState(): void;
     destroy(): void;
     private bootstrap;
     private ensureLiveReady;
@@ -268,4 +273,7 @@ declare function __setMatcherWasmModuleForTests(moduleLike: unknown): void;
 declare function __setMatcherEmbeddedPackForTests(bytes: Uint8Array): void;
 declare function __resetMatcherWasmForTests(): void;
 
-export { AUDIO_MARKER_INPUT_BUDGET_EXCEEDED_REASON, AUDIO_MARKER_WORK_BUDGET_EXCEEDED_REASON, AUDIO_MARKER_WORK_OVERFLOW_REASON, AudioFingerprintType, type AudioMarkerCode, type AudioMarkerConfig, type AudioMarkerDetection, type AudioMarkerLimits, DEFAULT_MAX_AUDIO_MARKER_DURATION_MILLIS, DEFAULT_MAX_AUDIO_MARKER_PCM_BYTES, DEFAULT_MAX_AUDIO_MARKER_SAMPLES, DEFAULT_MAX_AUDIO_MARKER_WORK_UNITS, DEFAULT_MAX_PACK_BYTES, 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, type PitchRatioEstimate, type PitchReferenceEstimate, type VariantDecision, type VariantDecisionStatus, type VariantMatch, type VariantMatchConfig, type VariantMatchQuery, __resetMatcherWasmForTests, __setMatcherEmbeddedPackForTests, __setMatcherWasmModuleForTests, initMatcher };
+/** Maximum gap between successful observations in one continuous material run. */
+declare const MATCH_CONTINUITY_GAP_MS = 30000;
+
+export { AUDIO_MARKER_INPUT_BUDGET_EXCEEDED_REASON, AUDIO_MARKER_WORK_BUDGET_EXCEEDED_REASON, AUDIO_MARKER_WORK_OVERFLOW_REASON, AudioFingerprintType, type AudioMarkerCode, type AudioMarkerConfig, type AudioMarkerDetection, type AudioMarkerLimits, DEFAULT_MAX_AUDIO_MARKER_DURATION_MILLIS, DEFAULT_MAX_AUDIO_MARKER_PCM_BYTES, DEFAULT_MAX_AUDIO_MARKER_SAMPLES, DEFAULT_MAX_AUDIO_MARKER_WORK_UNITS, DEFAULT_MAX_PACK_BYTES, type EntryMetadata, type InitMatcherOptions, type InitMatcherResult, MATCH_CONTINUITY_GAP_MS, type MatchConfig, type MatchResult, type MatcherEphemeralAuthOptions, type MatcherEphemeralAuthResult, type MatcherEphemeralKeyExchangeMetadata, type MatcherEphemeralKeyExchangeOptions, MatcherSession, type MatcherSessionEventMap, type MatcherSessionEventName, type MatcherSessionListener, type MatcherSessionOptions, type PackSource, type PitchRatioEstimate, type PitchReferenceEstimate, type VariantDecision, type VariantDecisionStatus, type VariantMatch, type VariantMatchConfig, type VariantMatchQuery, __resetMatcherWasmForTests, __setMatcherEmbeddedPackForTests, __setMatcherWasmModuleForTests, initMatcher };

package/dist/index.js

@@ -327,28 +327,31 @@ var AUDIO_MARKER_WORK_OVERFLOW_REASON = "detector_work_overflow";
 
 // src/match-deduper.ts
 var DEFAULT_NO_MATCH_CONFIRMATION_COUNT = 2;
+var MATCH_CONTINUITY_GAP_MS = 3e4;
 function getMatchIdentity(match) {
   return `${match.name}:${match.afpType}`;
 }
 var DistinctMatchDeduper = class {
   lastIdentity = null;
   pendingNoMatchCount = 0;
-  observe(best) {
+  lastObservedAt = null;
+  observe(best, now = Date.now()) {
+    const expired = this.lastObservedAt !== null && now - this.lastObservedAt > MATCH_CONTINUITY_GAP_MS;
     if (!best) {
       if (this.lastIdentity === null) {
         return { kind: "repeat", best: null };
       }
       this.pendingNoMatchCount += 1;
-      if (this.pendingNoMatchCount < DEFAULT_NO_MATCH_CONFIRMATION_COUNT) {
+      if (!expired && this.pendingNoMatchCount < DEFAULT_NO_MATCH_CONFIRMATION_COUNT) {
         return { kind: "repeat", best: null };
       }
-      this.lastIdentity = null;
-      this.pendingNoMatchCount = 0;
+      this.reset();
       return { kind: "nomatch" };
     }
     const nextIdentity = getMatchIdentity(best);
     this.pendingNoMatchCount = 0;
-    if (this.lastIdentity === nextIdentity) {
+    this.lastObservedAt = now;
+    if (!expired && this.lastIdentity === nextIdentity) {
       return { kind: "repeat", best };
     }
     this.lastIdentity = nextIdentity;
@@ -357,6 +360,7 @@ var DistinctMatchDeduper = class {
   reset() {
     this.lastIdentity = null;
     this.pendingNoMatchCount = 0;
+    this.lastObservedAt = null;
   }
 };
 
@@ -753,11 +757,6 @@ function normalizeResults(rawResults) {
 function normalizeVariantMatches(rawResults) {
   return rawResults.filter((item) => typeof item === "object" && item !== null).map((item) => normalizeVariantMatch(item));
 }
-function isInternallyDuplicatedBestMatch(result) {
-  return Boolean(
-    result && typeof result === "object" && result[INTERNAL_DUPLICATE_MATCH_FLAG] === true
-  );
-}
 function resolveFactory(moduleLike, names) {
   const fn = getCallable(moduleLike, names);
   return fn ? fn.bind(moduleLike) : null;
@@ -1050,6 +1049,7 @@ var MatcherSession = class {
   matcher = null;
   destroyed = false;
   packLoadTail = Promise.resolve();
+  recognitionGeneration = 0;
   distinctMatchDeduper = new DistinctMatchDeduper();
   constructor(options) {
     this.fetcher = options?.fetch;
@@ -1102,8 +1102,7 @@ var MatcherSession = class {
       }
       this.database = stagedDatabase;
       previousDatabase.destroy();
-      this.distinctMatchDeduper.reset();
-      this.matcher?.resetDistinctMatchState?.();
+      this.resetRecognitionState();
       this.events.emit("packload", {
         sourceType: normalized.sourceType,
         byteLength: normalized.bytes.byteLength
@@ -1116,8 +1115,7 @@ var MatcherSession = class {
     try {
       await this.ensureLiveReady();
       this.databaseOrThrow().addEntry(name, afpType, toUint8ArrayCopy(fingerprint));
-      this.distinctMatchDeduper.reset();
-      this.matcher?.resetDistinctMatchState?.();
+      this.resetRecognitionState();
     } catch (error) {
       handleError(this.events, "addEntry", error);
     }
@@ -1131,8 +1129,7 @@ var MatcherSession = class {
         toUint8ArrayCopy(fingerprint),
         metadata
       );
-      this.distinctMatchDeduper.reset();
-      this.matcher?.resetDistinctMatchState?.();
+      this.resetRecognitionState();
     } catch (error) {
       handleError(this.events, "addOrReplace", error);
     }
@@ -1141,8 +1138,7 @@ var MatcherSession = class {
     try {
       await this.ensureLiveReady();
       this.databaseOrThrow().setEntryVariantMetadata(name, encodedMetadata);
-      this.distinctMatchDeduper.reset();
-      this.matcher?.resetDistinctMatchState?.();
+      this.resetRecognitionState();
     } catch (error) {
       handleError(this.events, "setEntryVariantMetadata", error);
     }
@@ -1151,8 +1147,7 @@ var MatcherSession = class {
     try {
       await this.ensureLiveReady();
       this.databaseOrThrow().removeEntry(name);
-      this.distinctMatchDeduper.reset();
-      this.matcher?.resetDistinctMatchState?.();
+      this.resetRecognitionState();
     } catch (error) {
       handleError(this.events, "removeEntry", error);
     }
@@ -1161,8 +1156,7 @@ var MatcherSession = class {
     try {
       await this.ensureLiveReady();
       this.databaseOrThrow().clear();
-      this.distinctMatchDeduper.reset();
-      this.matcher?.resetDistinctMatchState?.();
+      this.resetRecognitionState();
     } catch (error) {
       handleError(this.events, "clear", error);
     }
@@ -1176,27 +1170,38 @@ var MatcherSession = class {
     }
   }
   async match(query, config) {
+    const generation = this.recognitionGeneration;
     try {
       await this.ensureLiveReady();
+      if (generation !== this.recognitionGeneration) {
+        return [];
+      }
       const safeQuery = toUint8ArrayCopy(query);
       this.events.emit("querystart", { queryByteLength: safeQuery.byteLength });
+      if (generation !== this.recognitionGeneration || this.destroyed) {
+        return [];
+      }
       const results = this.matcherOrThrow().findMatches(this.databaseOrThrow(), safeQuery, config);
-      this.emitDistinctMatchEvent(results[0] ?? null, safeQuery.byteLength, results);
+      this.emitDistinctMatchEvent(generation, results[0] ?? null, safeQuery.byteLength, results);
       return results;
     } catch (error) {
       handleError(this.events, "match", error);
     }
   }
   async bestMatch(query, config) {
+    const generation = this.recognitionGeneration;
     try {
       await this.ensureLiveReady();
+      if (generation !== this.recognitionGeneration) {
+        return null;
+      }
       const safeQuery = toUint8ArrayCopy(query);
       this.events.emit("querystart", { queryByteLength: safeQuery.byteLength });
-      const best = this.matcherOrThrow().bestMatch(this.databaseOrThrow(), safeQuery, config);
-      if (isInternallyDuplicatedBestMatch(best)) {
-        return best;
+      if (generation !== this.recognitionGeneration || this.destroyed) {
+        return null;
       }
-      this.emitDistinctMatchEvent(best, safeQuery.byteLength, best ? [best] : []);
+      const best = this.matcherOrThrow().bestMatch(this.databaseOrThrow(), safeQuery, config);
+      this.emitDistinctMatchEvent(generation, best, safeQuery.byteLength, best ? [best] : []);
       return best;
     } catch (error) {
       handleError(this.events, "bestMatch", error);
@@ -1346,10 +1351,17 @@ var MatcherSession = class {
     }
   }
   async matchWithVariants(query, pitchQuery, config, variantConfig) {
+    const generation = this.recognitionGeneration;
     try {
       await this.ensureLiveReady();
+      if (generation !== this.recognitionGeneration) {
+        return [];
+      }
       const safeQuery = toUint8ArrayCopy(query);
       this.events.emit("querystart", { queryByteLength: safeQuery.byteLength });
+      if (generation !== this.recognitionGeneration || this.destroyed) {
+        return [];
+      }
       const results = this.matcherOrThrow().findMatchesWithVariants(
         this.databaseOrThrow(),
         safeQuery,
@@ -1358,6 +1370,7 @@ var MatcherSession = class {
         variantConfig
       );
       this.emitDistinctMatchEvent(
+        generation,
         results[0]?.matchResult ?? null,
         safeQuery.byteLength,
         results.map((result) => result.matchResult)
@@ -1368,10 +1381,17 @@ var MatcherSession = class {
     }
   }
   async bestMatchWithVariants(query, pitchQuery, config, variantConfig) {
+    const generation = this.recognitionGeneration;
     try {
       await this.ensureLiveReady();
+      if (generation !== this.recognitionGeneration) {
+        return null;
+      }
       const safeQuery = toUint8ArrayCopy(query);
       this.events.emit("querystart", { queryByteLength: safeQuery.byteLength });
+      if (generation !== this.recognitionGeneration || this.destroyed) {
+        return null;
+      }
       const best = this.matcherOrThrow().bestMatchWithVariants(
         this.databaseOrThrow(),
         safeQuery,
@@ -1380,6 +1400,7 @@ var MatcherSession = class {
         variantConfig
       );
       this.emitDistinctMatchEvent(
+        generation,
         best?.matchResult ?? null,
         safeQuery.byteLength,
         best ? [best.matchResult] : []
@@ -1389,10 +1410,19 @@ var MatcherSession = class {
       handleError(this.events, "bestMatchWithVariants", error);
     }
   }
+  /** End the current recognition run without removing loaded entries.
+   * Pending queries from the previous run cannot update event suppression state.
+   */
+  resetRecognitionState() {
+    this.recognitionGeneration += 1;
+    this.distinctMatchDeduper.reset();
+    this.matcher?.resetDistinctMatchState?.();
+  }
   destroy() {
     if (this.destroyed) {
       return;
     }
+    this.resetRecognitionState();
     this.destroyed = true;
     this.matcher?.destroy();
     this.database?.destroy();
@@ -1456,7 +1486,10 @@ var MatcherSession = class {
     }
     return this.database;
   }
-  emitDistinctMatchEvent(best, queryByteLength, results) {
+  emitDistinctMatchEvent(generation, best, queryByteLength, results) {
+    if (generation !== this.recognitionGeneration || this.destroyed) {
+      return;
+    }
     const observation = this.distinctMatchDeduper.observe(best);
     if (observation.kind === "match") {
       this.events.emit("match", { results, best: observation.best });
@@ -1489,6 +1522,7 @@ export {
   DEFAULT_MAX_AUDIO_MARKER_SAMPLES,
   DEFAULT_MAX_AUDIO_MARKER_WORK_UNITS,
   DEFAULT_MAX_PACK_BYTES,
+  MATCH_CONTINUITY_GAP_MS,
   MatcherSession,
   __resetMatcherWasmForTests,
   __setMatcherEmbeddedPackForTests,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sorisdk/matcher",
-  "version": "0.6.8",
+  "version": "0.6.9",
   "description": "Browser WASM SDK for audio fingerprint matching",
   "type": "module",
   "main": "./dist/index.js",