videobook-engine 5.0.1 → 5.3.2

package/dist/search-provider-access.js

@@ -0,0 +1,42 @@
+import { EngineFault } from "./store.js";
+export function guardSearchProvider(source, consent = {}, isActive = () => true) {
+    const downloads = source.networkAccess?.modelDownloads;
+    const inference = source.networkAccess?.inference;
+    const allowDownloads = consent.modelDownloads === true;
+    const allowInference = consent.inference === true;
+    const validate = () => {
+        if (typeof downloads !== "boolean" || typeof inference !== "boolean") {
+            throw new EngineFault({ code: "INVALID_INPUT", message: "Search provider must declare networkAccess.modelDownloads and networkAccess.inference as booleans" });
+        }
+        if (!isActive()) {
+            throw new EngineFault({ code: "OFFLINE", message: "Search provider registration has been revoked" });
+        }
+        if (source.networkAccess?.modelDownloads !== downloads || source.networkAccess?.inference !== inference) {
+            throw new EngineFault({ code: "INVALID_INPUT", message: "Search provider network declaration changed; register it again with application consent" });
+        }
+        if ((downloads && !allowDownloads) || (inference && !allowInference)) {
+            throw new EngineFault({ code: "OFFLINE", message: "Search provider network access requires application consent" });
+        }
+    };
+    const provider = Object.create(source);
+    for (const method of ["prepare", "embedText", "embedImage", "embedVideo", "embedAudio"]) {
+        const operation = Reflect.get(source, method);
+        if (typeof operation !== "function")
+            continue;
+        Object.defineProperty(provider, method, {
+            value: async (...args) => {
+                validate();
+                return Reflect.apply(operation, source, args);
+            },
+        });
+    }
+    return {
+        provider, validate,
+        matches: (candidate, grant) => candidate === source
+            && candidate.networkAccess?.modelDownloads === downloads
+            && candidate.networkAccess?.inference === inference
+            && (grant.modelDownloads === true) === allowDownloads
+            && (grant.inference === true) === allowInference,
+    };
+}
+//# sourceMappingURL=search-provider-access.js.map

package/dist/search-provider-access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-provider-access.js","sourceRoot":"","sources":["../src/search-provider-access.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAMzC,MAAM,UAAU,mBAAmB,CACjC,MAAS,EACT,UAAiC,EAAE,EACnC,WAA0B,GAAG,EAAE,CAAC,IAAI;IAEpC,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC;IACvD,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC;IAClD,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,KAAK,IAAI,CAAC;IACvD,MAAM,cAAc,GAAG,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC;IAClD,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,IAAI,OAAO,SAAS,KAAK,SAAS,IAAI,OAAO,SAAS,KAAK,SAAS,EAAE,CAAC;YACrE,MAAM,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,mGAAmG,EAAE,CAAC,CAAC;QACjK,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;YAChB,MAAM,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC,CAAC;QACvG,CAAC;QACD,IAAI,MAAM,CAAC,aAAa,EAAE,cAAc,KAAK,SAAS,IAAI,MAAM,CAAC,aAAa,EAAE,SAAS,KAAK,SAAS,EAAE,CAAC;YACxG,MAAM,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,yFAAyF,EAAE,CAAC,CAAC;QACvJ,CAAC;QACD,IAAI,CAAC,SAAS,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,6DAA6D,EAAE,CAAC,CAAC;QACrH,CAAC;IACH,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAM,CAAC;IAC5C,KAAK,MAAM,MAAM,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,CAAU,EAAE,CAAC;QACjG,MAAM,SAAS,GAAY,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvD,IAAI,OAAO,SAAS,KAAK,UAAU;YAAE,SAAS;QAC9C,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE;YACtC,KAAK,EAAE,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;gBAClC,QAAQ,EAAE,CAAC;gBACX,OAAO,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAY,CAAC;YAC3D,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,SAAS,KAAK,MAAM;eAC9C,SAAS,CAAC,aAAa,EAAE,cAAc,KAAK,SAAS;eACrD,SAAS,CAAC,aAAa,EAAE,SAAS,KAAK,SAAS;eAChD,CAAC,KAAK,CAAC,cAAc,KAAK,IAAI,CAAC,KAAK,cAAc;eAClD,CAAC,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,KAAK,cAAc;KACnD,CAAC;AACJ,CAAC"}

package/dist/similarity.d.ts

@@ -1,4 +1,63 @@
-import { type SimilarityApi } from "./engine-types.js";
+import type { MediaOperationOptions } from "./engine-types.js";
+import { type SimilarityApi, type SimilarityAudioConfig, type SimilarityAudioEmbeddingProvider, type SimilarityConfig, type SimilarityEmbeddingProvider, type SimilarityTextChunk, type SimilarityTextConfig, type SimilarityTextEmbeddingProvider } from "./engine-types.js";
 import { EngineContext } from "./context.js";
+import type { ModelWorkerConfiguration } from "./model-worker-protocol.js";
 export declare function createSimilarityApi(context: EngineContext): SimilarityApi;
+export declare function createInlineSimilarityProvider(configuration: ModelWorkerConfiguration): LocalClipProvider | LocalClapAudioProvider | LocalTextProvider;
+declare class LocalClipProvider implements SimilarityEmbeddingProvider {
+    private readonly dataDir;
+    private readonly config;
+    get networkAccess(): {
+        modelDownloads: boolean;
+        inference: boolean;
+    };
+    get embeddingSpace(): string;
+    readonly dimensions = 512;
+    private embedder;
+    constructor(dataDir: string, config: SimilarityConfig);
+    prepare(options?: MediaOperationOptions): Promise<void>;
+    embedImage(sourcePath: string, options?: MediaOperationOptions): Promise<Float32Array>;
+    embedVideo(sourcePath: string, options?: MediaOperationOptions): Promise<{
+        vector: Float32Array;
+        frameCount: number;
+    }>;
+    private loadEmbedder;
+    private embedImages;
+}
+declare class LocalClapAudioProvider implements SimilarityAudioEmbeddingProvider {
+    private readonly dataDir;
+    private readonly sharedConfig;
+    private readonly config;
+    get networkAccess(): {
+        modelDownloads: boolean;
+        inference: boolean;
+    };
+    get embeddingSpace(): string;
+    readonly dimensions = 512;
+    private processor;
+    private model;
+    private sampleRate;
+    private maxSamples;
+    constructor(dataDir: string, sharedConfig: SimilarityConfig, config: SimilarityAudioConfig);
+    prepare(options?: MediaOperationOptions): Promise<void>;
+    embedAudio(sourcePath: string, options?: MediaOperationOptions): Promise<Float32Array>;
+    private loadModel;
+}
+declare class LocalTextProvider implements SimilarityTextEmbeddingProvider {
+    private readonly dataDir;
+    private readonly sharedConfig;
+    private readonly config;
+    get networkAccess(): {
+        modelDownloads: boolean;
+        inference: boolean;
+    };
+    get embeddingSpace(): string;
+    readonly dimensions = 384;
+    private embedder;
+    constructor(dataDir: string, sharedConfig: SimilarityConfig, config: SimilarityTextConfig);
+    prepare(options?: MediaOperationOptions): Promise<void>;
+    embedText(text: string, options?: MediaOperationOptions): Promise<SimilarityTextChunk[]>;
+    private loadEmbedder;
+}
+export {};
 //# sourceMappingURL=similarity.d.ts.map

package/dist/similarity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"similarity.d.ts","sourceRoot":"","sources":["../src/similarity.ts"],"names":[],"mappings":"AAoBA,OAAO,EAKL,KAAK,aAAa,EAiBnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EAKd,MAAM,cAAc,CAAC;AAyJtB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAGzE"}
+{"version":3,"file":"similarity.d.ts","sourceRoot":"","sources":["../src/similarity.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,gCAAgC,EACrC,KAAK,gBAAgB,EACrB,KAAK,2BAA2B,EAShC,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,EAErC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EAKd,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAgK3E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAGzE;AA6vCD,wBAAgB,8BAA8B,CAAC,aAAa,EAAE,wBAAwB,kEAOrF;AAED,cAAM,iBAAkB,YAAW,2BAA2B;IAO1D,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,IAAI,aAAa;;;MAA4F;IAC7G,IAAI,cAAc,WAAuE;IACzF,QAAQ,CAAC,UAAU,OAAsB;IACzC,OAAO,CAAC,QAAQ,CAAgC;gBAG7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,gBAAgB;IAGrC,OAAO,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,YAAY,CAAC;IAO1F,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC;QACjF,MAAM,EAAE,YAAY,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;YA4CY,YAAY;YA2BZ,WAAW;CAkB1B;AAED,cAAM,sBAAuB,YAAW,gCAAgC;IAUpE,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAXzB,IAAI,aAAa;;;MAAsI;IACvJ,IAAI,cAAc,WAAuE;IACzF,QAAQ,CAAC,UAAU,OAA4B;IAC/C,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,UAAU,CAA6B;gBAG5B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,gBAAgB,EAC9B,MAAM,EAAE,qBAAqB;IAG1C,OAAO,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,YAAY,CAAC;YA2BlF,SAAS;CAoDxB;AAED,cAAM,iBAAkB,YAAW,+BAA+B;IAO9D,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IARzB,IAAI,aAAa;;;MAAsI;IACvJ,IAAI,cAAc,WAAuE;IACzF,QAAQ,CAAC,UAAU,OAA2B;IAC9C,OAAO,CAAC,QAAQ,CAAoC;gBAGjC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,gBAAgB,EAC9B,MAAM,EAAE,oBAAoB;IAGzC,OAAO,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;YA6BpF,YAAY;CA2B3B"}