@adaas/a-frame 0.1.1 → 0.1.2

package/dist/node/chunk-OMGYXCFM.mjs

@@ -0,0 +1,248 @@
+import { A_FRAME_DEFAULT_NAMESPACE_KEY, A_FrameNamespace } from './chunk-AMMQ76RJ.mjs';
+import { A_Fragment, A_Scope, A_Context, ASEID } from '@adaas/a-concept';
+
+var A_FrameIndex = class _A_FrameIndex extends A_Fragment {
+  constructor() {
+    if (_A_FrameIndex._instance)
+      return _A_FrameIndex._instance;
+    super({ name: "A_FrameIndex" });
+    // -------------------------------------------------------------------------------------
+    // ------------------------------ Instance State --------------------------------------
+    // -------------------------------------------------------------------------------------
+    this.definitions = /* @__PURE__ */ new Map();
+    this.namespaces = /* @__PURE__ */ new Map();
+    this.scope = new A_Scope({ name: "A_FrameIndexScope" });
+  }
+  static get instance() {
+    if (!_A_FrameIndex._instance) {
+      _A_FrameIndex._instance = new _A_FrameIndex();
+    }
+    return _A_FrameIndex._instance;
+  }
+  static get indexSize() {
+    return _A_FrameIndex.instance.indexSize;
+  }
+  static get scope() {
+    return A_Context.scope(this);
+  }
+  // ------------------------------------------------------------------------------------
+  // --------------------Static Access to Instance Methods-------------------------------
+  // ------------------------------------------------------------------------------------
+  static inherit(scope) {
+    _A_FrameIndex.instance.inherit(scope);
+  }
+  static addDefinition(def) {
+    _A_FrameIndex.instance.addDefinition(def);
+  }
+  static getDefinition(nameOrHash) {
+    return _A_FrameIndex.instance.getDefinition(nameOrHash);
+  }
+  static listDefinitions(filter) {
+    return _A_FrameIndex.instance.listDefinitions(filter);
+  }
+  static removeDefinition(def) {
+    _A_FrameIndex.instance.removeDefinition(def);
+  }
+  static addNamespace(namespace) {
+    _A_FrameIndex.instance.addNamespace(namespace);
+  }
+  static getDefaultNamespace() {
+    return _A_FrameIndex.instance.getDefaultNamespace();
+  }
+  static getNamespace(nameOrASEID) {
+    return _A_FrameIndex.instance.getNamespace(nameOrASEID);
+  }
+  static listNamespaces() {
+    return _A_FrameIndex.instance.listNamespaces();
+  }
+  static removeNamespace(namespace) {
+    _A_FrameIndex.instance.removeNamespace(namespace);
+  }
+  static search(vector, options = {}) {
+    return _A_FrameIndex.instance.search(vector, options);
+  }
+  /** Number of loaded records */
+  get indexSize() {
+    return this.definitions.size;
+  }
+  // static searchByText(
+  //     query: string,
+  //     channel: A_FrameChannel,
+  //     options: A_FrameSearchOptions = {},
+  // ): Promise<A_FrameDefinition_SearchResult[]> {
+  //     return A_FrameIndex.instance.searchByText(query, channel, options);
+  // }
+  // ------------------------------------------------------------------------------------
+  // ------------------------------ Instance Methods ------------------------------------
+  // ------------------------------------------------------------------------------------
+  inherit(scope) {
+    this.scope.inherit(scope);
+  }
+  addDefinition(def) {
+    this.scope.register(def);
+    const existingNamespace = this.namespaces.get(def.namespace.id);
+    if (!existingNamespace) {
+      this.addNamespace(def.namespace);
+    }
+    this.definitions.set(def.id, def);
+  }
+  getDefinition(name) {
+    for (const def of this.definitions.values()) {
+      if (def.name === name) {
+        return def;
+      }
+    }
+    return void 0;
+  }
+  listDefinitions(filter = {}) {
+    const namespaceName = filter.namespace ? typeof filter.namespace === "string" ? ASEID.isASEID(filter.namespace) ? new ASEID(filter.namespace).id : filter.namespace : filter.namespace.id : void 0;
+    const inheritFilters = filter.inherit ? Array.isArray(filter.inherit) ? filter.inherit : [filter.inherit] : void 0;
+    return [...this.definitions.values()].filter((r) => {
+      if (namespaceName && r.namespace.name !== namespaceName) return false;
+      if (inheritFilters && !this.matchesInheritanceFilters(r, inheritFilters)) return false;
+      return true;
+    });
+  }
+  removeDefinition(def) {
+    this.scope.deregister(def);
+  }
+  addNamespace(namespace) {
+    this.scope.register(namespace);
+    this.namespaces.set(namespace.id, namespace);
+  }
+  getNamespace(nameOrASEID) {
+    const targetKey = typeof nameOrASEID === "string" ? ASEID.isASEID(nameOrASEID) ? new ASEID(nameOrASEID).id : nameOrASEID : nameOrASEID.id;
+    return this.namespaces.get(targetKey);
+  }
+  getDefaultNamespace() {
+    let defaultNamespace = this.getNamespace(A_FRAME_DEFAULT_NAMESPACE_KEY);
+    if (!defaultNamespace) {
+      defaultNamespace = new A_FrameNamespace({
+        name: A_FRAME_DEFAULT_NAMESPACE_KEY
+      });
+      this.addNamespace(defaultNamespace);
+    }
+    return defaultNamespace;
+  }
+  listNamespaces() {
+    return [...this.namespaces.values()];
+  }
+  removeNamespace(namespace) {
+    this.scope.deregister(namespace);
+    this.namespaces.delete(namespace.id);
+  }
+  /**
+   * Search by a pre-computed embedding vector (cosine similarity).
+   */
+  search(vector, options = {}) {
+    const { topK = 10, namespace, minScore = 0, inherit } = options;
+    const inheritFilters = inherit ? Array.isArray(inherit) ? inherit : [inherit] : void 0;
+    const pool = [...this.definitions.values()].filter((r) => {
+      if (namespace && r.namespace.id !== namespace) return false;
+      if (inheritFilters && !this.matchesInheritanceFilters(r, inheritFilters)) return false;
+      return true;
+    });
+    const scored = pool.map((r) => ({
+      record: r,
+      score: this.cosineSimilarity(vector, r.vector)
+    }));
+    return scored.filter((s) => s.score >= minScore).sort((a, b) => b.score - a.score).slice(0, topK).map(({ record: r, score }) => ({
+      record: r,
+      score
+    }));
+  }
+  /**
+   * Test whether a definition's resolved constructor satisfies at least one
+   * of the provided inheritance filters (OR semantics).
+   *
+   * The constructor is resolved from the internal scope by the definition's
+   * name using `scope.resolveConstructor(name)` — the same mechanism the
+   * framework uses everywhere for class lookup.
+   *
+   * - `strict: false` (default) — any depth, using A_Context's O(1) indexed
+   *   inheritance map: `A_Context.isIndexedInheritedFrom(ctor, targetClass)`
+   * - `strict: true`            — direct child only:
+   *   `Object.getPrototypeOf(ctor) === targetClass`
+   *
+   * Definitions whose name cannot be resolved from the scope (e.g. restored
+   * from storage without a live container) never match.
+   */
+  matchesInheritanceFilters(def, filters) {
+    const ctor = this.scope.resolveConstructor(def.name);
+    if (!ctor) return false;
+    return filters.some((filter) => {
+      const targetClass = filter.class;
+      if (filter.strict) {
+        return Object.getPrototypeOf(ctor) === targetClass;
+      } else {
+        return A_Context.isIndexedInheritedFrom(ctor, targetClass);
+      }
+    });
+  }
+  // protected cosineSimilarity(vectorA: A_FrameVector, vectorB?: A_FrameVector): number {
+  //     const a = vectorA.values ?? new Float32Array();
+  //     const b = vectorB?.values ?? new Float32Array();
+  //     if (a.length !== b.length) {
+  //         throw new Error(`A_FrameIndex: dimension mismatch ${a.length} vs ${b.length}`);
+  //     }
+  //     let dot = 0, normA = 0, normB = 0;
+  //     for (let i = 0; i < a.length; i++) {
+  //         dot += a[i] * b[i];
+  //         normA += a[i] * a[i];
+  //         normB += b[i] * b[i];
+  //     }
+  //     const denom = Math.sqrt(normA) * Math.sqrt(normB);
+  //     return denom === 0 ? 0 : dot / denom;
+  // }
+  cosineSimilarity(a, b) {
+    if (!b) return 0;
+    const dot = a.dot(b);
+    const mag = a.magnitude() * b.magnitude();
+    return mag === 0 ? 0 : dot / mag;
+  }
+  euclideanDistance(a, b) {
+    this.assertSameLength(a, b);
+    let sum = 0;
+    for (let i = 0; i < a.length; i++) {
+      const diff = a.values[i] - b.values[i];
+      sum += diff * diff;
+    }
+    return Math.sqrt(sum);
+  }
+  nearest(query, vectors, limit = 1) {
+    return [...vectors].map((v) => ({
+      vector: v,
+      score: this.cosineSimilarity(query, v)
+    })).sort((a, b) => b.score - a.score).slice(0, limit).map((r) => r.vector);
+  }
+  rank(query, vectors) {
+    return vectors.map((v) => ({
+      vector: v,
+      score: this.cosineSimilarity(query, v)
+    })).sort((a, b) => b.score - a.score);
+  }
+  assertSameLength(a, b) {
+    if (a.length !== b.length) {
+      throw new Error(
+        `Embedding dimension mismatch: ${a.length} vs ${b.length}`
+      );
+    }
+  }
+  /**
+   * Search by plain text — sends the query to the embed server via channel first.
+   */
+  // async searchByText(
+  //     query: string,
+  //     channel: A_FrameChannel,
+  //     options: A_FrameSearchOptions = {},
+  // ): Promise<A_FrameDefinition_SearchResult[]> {
+  //     this.assertLoaded();
+  //     const resp = await channel.embed(query);
+  //     const queryEmbedding = new Float32Array(resp.data[0].embedding);
+  //     return this.search(queryEmbedding, options);
+  // }
+};
+
+export { A_FrameIndex };
+//# sourceMappingURL=chunk-OMGYXCFM.mjs.map
+//# sourceMappingURL=chunk-OMGYXCFM.mjs.map

package/dist/node/chunk-OMGYXCFM.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameIndex/A-FrameIndex.context.ts"],"names":[],"mappings":"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","file":"chunk-OMGYXCFM.mjs","sourcesContent":["import { A_Concept, A_Context, A_Dependency, A_Fragment, A_Scope, ASEID } from \"@adaas/a-concept\";\nimport { A_FrameVector } from \"../A-FrameVector/A-FrameVector.entity\";\nimport { A_FrameNamespace } from \"../A-FrameNamespace/A-FrameNamespace.entity\";\nimport { A_FrameDefinition_SearchResult, A_FrameInheritanceFilter, A_FrameListOptions, A_FrameSearchOptions } from \"./A-FrameIndex.types\";\nimport { A_FrameDefinition } from \"../A-FrameDefinition\";\nimport { A_FRAME_DEFAULT_NAMESPACE_KEY } from \"../A-FrameNamespace/A-FrameNamespace.constants\";\n\n\n\nexport class A_FrameIndex extends A_Fragment {\n\n    private static _instance: A_FrameIndex;\n\n    static get instance(): A_FrameIndex {\n        if (!A_FrameIndex._instance) {\n            A_FrameIndex._instance = new A_FrameIndex();\n        }\n        return A_FrameIndex._instance;\n    }\n\n    static get indexSize(): number {\n        return A_FrameIndex.instance.indexSize;\n    }\n\n\n    static get scope(): A_Scope {\n        return A_Context.scope(this);\n    }\n\n    // ------------------------------------------------------------------------------------\n    // --------------------Static Access to Instance Methods-------------------------------\n    // ------------------------------------------------------------------------------------\n    static inherit(scope: A_Scope) {\n        A_FrameIndex.instance.inherit(scope);\n    }\n    static addDefinition(def: A_FrameDefinition): void {\n        A_FrameIndex.instance.addDefinition(def);\n    }\n    static getDefinition(nameOrHash: string): A_FrameDefinition | undefined {\n        return A_FrameIndex.instance.getDefinition(nameOrHash);\n    }\n    static listDefinitions(filter: A_FrameListOptions): A_FrameDefinition[] {\n        return A_FrameIndex.instance.listDefinitions(filter);\n    }\n    static removeDefinition(def: A_FrameDefinition): void {\n        A_FrameIndex.instance.removeDefinition(def);\n    }\n    static addNamespace(namespace: A_FrameNamespace): void {\n        A_FrameIndex.instance.addNamespace(namespace);\n    }\n    static getDefaultNamespace(): A_FrameNamespace {\n        return A_FrameIndex.instance.getDefaultNamespace();\n    }\n    static getNamespace(nameOrASEID: string | ASEID): A_FrameNamespace | undefined {\n        return A_FrameIndex.instance.getNamespace(nameOrASEID);\n    }\n    static listNamespaces(): A_FrameNamespace[] {\n        return A_FrameIndex.instance.listNamespaces();\n    }\n    static removeNamespace(namespace: A_FrameNamespace): void {\n        A_FrameIndex.instance.removeNamespace(namespace);\n    }\n    static search(\n        vector: A_FrameVector,\n        options: A_FrameSearchOptions = {},\n    ): A_FrameDefinition_SearchResult[] {\n        return A_FrameIndex.instance.search(vector, options);\n    }\n\n    // -------------------------------------------------------------------------------------\n    // ------------------------------ Instance State --------------------------------------\n    // -------------------------------------------------------------------------------------\n\n    private definitions: Map<string, A_FrameDefinition> = new Map();\n\n    private namespaces: Map<string, A_FrameNamespace> = new Map();\n\n    private _index!: {\n\n        namespaceToDefinitions: WeakMap<A_FrameNamespace, Set<A_FrameDefinition>>,\n\n        definitionToNamespace: WeakMap<A_FrameDefinition, A_FrameNamespace>,\n    };\n    /**\n     * Scope where all definitions and namespaces are registered as dependencies, allowing for lookup by ASEID or constructor reference.\n     */\n    private scope!: A_Scope\n\n\n    constructor() {\n        if (A_FrameIndex._instance)\n            return A_FrameIndex._instance;\n\n        super({ name: 'A_FrameIndex' });\n\n        this.scope = new A_Scope({ name: 'A_FrameIndexScope' });\n    }\n\n    /** Number of loaded records */\n    get indexSize(): number {\n        return this.definitions.size;\n    }\n\n\n    // static searchByText(\n    //     query: string,\n    //     channel: A_FrameChannel,\n    //     options: A_FrameSearchOptions = {},\n    // ): Promise<A_FrameDefinition_SearchResult[]> {\n    //     return A_FrameIndex.instance.searchByText(query, channel, options);\n    // }\n\n\n    // ------------------------------------------------------------------------------------\n    // ------------------------------ Instance Methods ------------------------------------\n    // ------------------------------------------------------------------------------------\n    inherit(scope: A_Scope) {\n        this.scope.inherit(scope);\n    }\n\n    addDefinition(def: A_FrameDefinition): void {\n        this.scope.register(def);\n\n        const existingNamespace = this.namespaces.get(def.namespace.id);\n        if (!existingNamespace) {\n            this.addNamespace(def.namespace);\n        }\n\n        this.definitions.set(def.id, def);\n    }\n\n    getDefinition(name: string): A_FrameDefinition | undefined {\n        // Then try name lookup\n        for (const def of this.definitions.values()) {\n            if (def.name === name) {\n                return def;\n            }\n        }\n\n        return undefined;\n    }\n\n    listDefinitions(filter: A_FrameListOptions = {}): A_FrameDefinition[] {\n        const namespaceName = filter.namespace\n            ? typeof filter.namespace === 'string'\n                ? ASEID.isASEID(filter.namespace)\n                    ? new ASEID(filter.namespace).id\n                    : filter.namespace\n                : filter.namespace.id\n            : undefined;\n\n        const inheritFilters = filter.inherit\n            ? Array.isArray(filter.inherit) ? filter.inherit : [filter.inherit]\n            : undefined;\n\n        return [...this.definitions.values()].filter(r => {\n            if (namespaceName && r.namespace.name !== namespaceName) return false;\n            if (inheritFilters && !this.matchesInheritanceFilters(r, inheritFilters)) return false;\n            return true;\n        });\n    }\n\n    removeDefinition(def: A_FrameDefinition): void {\n        this.scope.deregister(def);\n    }\n\n    addNamespace(namespace: A_FrameNamespace): void {\n        this.scope.register(namespace);\n\n        this.namespaces.set(namespace.id, namespace);\n    }\n\n    getNamespace(nameOrASEID: string | ASEID): A_FrameNamespace | undefined {\n        const targetKey = typeof nameOrASEID === 'string'\n            ? ASEID.isASEID(nameOrASEID)\n                ? new ASEID(nameOrASEID).id\n                : nameOrASEID\n            : nameOrASEID.id;\n\n        return this.namespaces.get(targetKey);\n    }\n\n    getDefaultNamespace(): A_FrameNamespace {\n        // Ensure default namespace always exists\n        let defaultNamespace = this.getNamespace(A_FRAME_DEFAULT_NAMESPACE_KEY);\n        if (!defaultNamespace) {\n            defaultNamespace = new A_FrameNamespace({\n                name: A_FRAME_DEFAULT_NAMESPACE_KEY,\n            });\n            this.addNamespace(defaultNamespace);\n        }\n        return defaultNamespace;\n    }\n\n    listNamespaces(): A_FrameNamespace[] {\n        return [...this.namespaces.values()];\n    }\n\n    removeNamespace(namespace: A_FrameNamespace): void {\n        this.scope.deregister(namespace);\n        this.namespaces.delete(namespace.id);\n    }\n\n\n    /**\n     * Search by a pre-computed embedding vector (cosine similarity).\n     */\n    search(\n        vector: A_FrameVector,\n        options: A_FrameSearchOptions = {},\n    ): A_FrameDefinition_SearchResult[] {\n\n        const { topK = 10, namespace, minScore = 0, inherit } = options;\n\n        const inheritFilters = inherit\n            ? Array.isArray(inherit) ? inherit : [inherit]\n            : undefined;\n\n        const pool = [...this.definitions.values()].filter(r => {\n            if (namespace && r.namespace.id !== namespace) return false;\n            if (inheritFilters && !this.matchesInheritanceFilters(r, inheritFilters)) return false;\n            return true;\n        });\n\n        const scored = pool.map(r => ({\n            record: r,\n            score: this.cosineSimilarity(vector, r.vector),\n        }));\n\n        return scored\n            .filter(s => s.score >= minScore)\n            .sort((a, b) => b.score - a.score)\n            .slice(0, topK)\n            .map(({ record: r, score }) => ({\n                record: r,\n                score,\n            }));\n    }\n\n    /**\n     * Test whether a definition's resolved constructor satisfies at least one\n     * of the provided inheritance filters (OR semantics).\n     *\n     * The constructor is resolved from the internal scope by the definition's\n     * name using `scope.resolveConstructor(name)` — the same mechanism the\n     * framework uses everywhere for class lookup.\n     *\n     * - `strict: false` (default) — any depth, using A_Context's O(1) indexed\n     *   inheritance map: `A_Context.isIndexedInheritedFrom(ctor, targetClass)`\n     * - `strict: true`            — direct child only:\n     *   `Object.getPrototypeOf(ctor) === targetClass`\n     *\n     * Definitions whose name cannot be resolved from the scope (e.g. restored\n     * from storage without a live container) never match.\n     */\n    private matchesInheritanceFilters(\n        def: A_FrameDefinition,\n        filters: A_FrameInheritanceFilter[],\n    ): boolean {\n        const ctor = this.scope.resolveConstructor(def.name);\n        if (!ctor) return false;\n\n        return filters.some(filter => {\n            const targetClass = filter.class;\n            if (filter.strict) {\n                // Direct child: the immediate prototype must be exactly targetClass\n                return Object.getPrototypeOf(ctor) === targetClass;\n            } else {\n                // Any depth: use A_Context's indexed inheritance check (O(1))\n                return A_Context.isIndexedInheritedFrom(ctor, targetClass);\n            }\n        });\n    }\n\n    // protected cosineSimilarity(vectorA: A_FrameVector, vectorB?: A_FrameVector): number {\n    //     const a = vectorA.values ?? new Float32Array();\n    //     const b = vectorB?.values ?? new Float32Array();\n\n    //     if (a.length !== b.length) {\n    //         throw new Error(`A_FrameIndex: dimension mismatch ${a.length} vs ${b.length}`);\n    //     }\n    //     let dot = 0, normA = 0, normB = 0;\n    //     for (let i = 0; i < a.length; i++) {\n    //         dot += a[i] * b[i];\n    //         normA += a[i] * a[i];\n    //         normB += b[i] * b[i];\n    //     }\n    //     const denom = Math.sqrt(normA) * Math.sqrt(normB);\n    //     return denom === 0 ? 0 : dot / denom;\n    // }\n\n    cosineSimilarity(\n        a: A_FrameVector,\n        b?: A_FrameVector\n    ): number {\n        if (!b) return 0\n\n        const dot = a.dot(b)\n        const mag = a.magnitude() * b.magnitude()\n        return mag === 0 ? 0 : dot / mag\n    }\n\n    euclideanDistance(\n        a: A_FrameVector,\n        b: A_FrameVector\n    ): number {\n        this.assertSameLength(a, b)\n\n        let sum = 0\n        for (let i = 0; i < a.length; i++) {\n            const diff = a.values[i] - b.values[i]\n            sum += diff * diff\n        }\n        return Math.sqrt(sum)\n    }\n\n    nearest(\n        query: A_FrameVector,\n        vectors: readonly A_FrameVector[],\n        limit = 1\n    ): A_FrameVector[] {\n        return [...vectors]\n            .map(v => ({\n                vector: v,\n                score: this.cosineSimilarity(query, v),\n            }))\n            .sort((a, b) => b.score - a.score)\n            .slice(0, limit)\n            .map(r => r.vector)\n    }\n\n    rank(\n        query: A_FrameVector,\n        vectors: readonly A_FrameVector[]\n    ): Array<{ vector: A_FrameVector; score: number }> {\n        return vectors\n            .map(v => ({\n                vector: v,\n                score: this.cosineSimilarity(query, v),\n            }))\n            .sort((a, b) => b.score - a.score)\n    }\n\n    private assertSameLength(\n        a: A_FrameVector,\n        b: A_FrameVector\n    ) {\n        if (a.length !== b.length) {\n            throw new Error(\n                `Embedding dimension mismatch: ${a.length} vs ${b.length}`\n            )\n        }\n    }\n\n\n\n    /**\n     * Search by plain text — sends the query to the embed server via channel first.\n     */\n    // async searchByText(\n    //     query: string,\n    //     channel: A_FrameChannel,\n    //     options: A_FrameSearchOptions = {},\n    // ): Promise<A_FrameDefinition_SearchResult[]> {\n    //     this.assertLoaded();\n    //     const resp = await channel.embed(query);\n    //     const queryEmbedding = new Float32Array(resp.data[0].embedding);\n    //     return this.search(queryEmbedding, options);\n    // }\n\n}"]}

package/dist/node/chunk-OYZAQMKD.mjs

@@ -0,0 +1,263 @@
+import { A_Fragment } from '@adaas/a-concept';
+
+// src/lib/A-FrameStorage/A-FrameStorage.codec.ts
+var enc = new TextEncoder();
+var dec = new TextDecoder();
+var A_FrameStorageCodec = class _A_FrameStorageCodec extends A_Fragment {
+  constructor() {
+    super(...arguments);
+    this.enc = new TextEncoder();
+    this.dec = new TextDecoder();
+    // ─── Binary file format constants ────────────────────────────────────────────
+    // FILE LAYOUT (all multi-byte values are little-endian):
+    //   [HEADER 20B]
+    //     magic    4B = 0x454D424B ("EMBK")
+    //     version  1B = 0x01
+    //     count    4B (uint32)
+    //     dims     2B (uint16)
+    //     reserved 9B
+    //   [RECORD × count]
+    //     aseidLen 2B (uint16)  — variable-length primary entity ID
+    //     aseid    NB utf-8
+    //     nameLen  2B (uint16)
+    //     name     NB utf-8
+    //     vector   dims×4B Float32 LE
+    //     metaLen  4B (uint32)
+    //     meta     NB JSON
+    //   Encrypted on disk: [IV 12B][AuthTag 16B][Ciphertext]
+    this.A_FRAME_FILE_MAGIC = 1162691147;
+    this.A_FRAME_FILE_VERSION = 1;
+    this.A_FRAME_HEADER_SIZE = 20;
+  }
+  static get fileExtension() {
+    return ".aframe";
+  }
+  /** Returns the definitions file name for a given namespace id, e.g. `my-ns.definitions.aframe` */
+  getDefinitionsFileName(namespaceId) {
+    return `${namespaceId}.definitions${_A_FrameStorageCodec.fileExtension}`;
+  }
+  /** Returns the reserved namespaces index file name: `.namespaces.aframe` */
+  getNamespaceFileName() {
+    return `.namespaces${_A_FrameStorageCodec.fileExtension}`;
+  }
+  /** Glob pattern that matches all definitions files under a directory, e.g. `*.definitions.aframe` */
+  static get definitionsFilePattern() {
+    return `*.definitions${_A_FrameStorageCodec.fileExtension}`;
+  }
+  encodePayload(records) {
+    const parts = [];
+    if (records.some((r) => !r.embedding)) {
+      throw new Error("All records must have embeddings to be encoded");
+    }
+    const header = new Uint8Array(this.A_FRAME_HEADER_SIZE);
+    const headerView = new DataView(header.buffer);
+    headerView.setUint32(0, this.A_FRAME_FILE_MAGIC, true);
+    header[4] = this.A_FRAME_FILE_VERSION;
+    headerView.setUint32(5, records.length, true);
+    const dims = records[0]?.embedding.length ?? 0;
+    headerView.setUint16(9, dims, true);
+    parts.push(header);
+    for (const rec of records) {
+      const aseidBytes = enc.encode(rec.aseid.toString());
+      const nameBytes = enc.encode(rec.name);
+      const metaJson = JSON.stringify({
+        hash: rec.hash,
+        source: rec.source,
+        type: rec.type,
+        description: rec.description,
+        metadata: rec.metadata,
+        namespace: rec.namespace,
+        date: rec.date,
+        model: rec.model,
+        credentialId: rec.credentialId,
+        aFrameVersion: rec.aFrameVersion,
+        aFrameServerVersion: rec.aFrameServerVersion
+      });
+      const metaBytes = enc.encode(metaJson);
+      const recSize = 2 + aseidBytes.length + 2 + nameBytes.length + rec.embedding.length * 4 + 4 + metaBytes.length;
+      const recBuf = new Uint8Array(recSize);
+      const view = new DataView(recBuf.buffer);
+      let offset = 0;
+      view.setUint16(offset, aseidBytes.length, true);
+      offset += 2;
+      recBuf.set(aseidBytes, offset);
+      offset += aseidBytes.length;
+      view.setUint16(offset, nameBytes.length, true);
+      offset += 2;
+      recBuf.set(nameBytes, offset);
+      offset += nameBytes.length;
+      for (let i = 0; i < rec.embedding.length; i++) {
+        view.setFloat32(offset, rec.embedding[i], true);
+        offset += 4;
+      }
+      view.setUint32(offset, metaBytes.length, true);
+      offset += 4;
+      recBuf.set(metaBytes, offset);
+      parts.push(recBuf);
+    }
+    const total = parts.reduce((s, p) => s + p.length, 0);
+    const out = new Uint8Array(total);
+    let pos = 0;
+    for (const p of parts) {
+      out.set(p, pos);
+      pos += p.length;
+    }
+    return out;
+  }
+  decodePayload(data) {
+    if (data.length < this.A_FRAME_HEADER_SIZE) throw new Error("Corrupt index: too short for header");
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const magic = view.getUint32(0, true);
+    if (magic !== this.A_FRAME_FILE_MAGIC) throw new Error(`Corrupt index: bad magic 0x${magic.toString(16)}`);
+    const version = data[4];
+    if (version !== this.A_FRAME_FILE_VERSION) throw new Error(`Unsupported index version: ${version}`);
+    const count = view.getUint32(5, true);
+    const dims = view.getUint16(9, true);
+    const records = [];
+    let offset = this.A_FRAME_HEADER_SIZE;
+    for (let i = 0; i < count; i++) {
+      const aseidLen = view.getUint16(offset, true);
+      offset += 2;
+      const aseid = dec.decode(data.slice(offset, offset + aseidLen));
+      offset += aseidLen;
+      const nameLen = view.getUint16(offset, true);
+      offset += 2;
+      const name = dec.decode(data.slice(offset, offset + nameLen));
+      offset += nameLen;
+      const embedding = new Float32Array(dims);
+      for (let d = 0; d < dims; d++) {
+        embedding[d] = view.getFloat32(offset, true);
+        offset += 4;
+      }
+      const metaLen = view.getUint32(offset, true);
+      offset += 4;
+      const metaJson = dec.decode(data.slice(offset, offset + metaLen));
+      offset += metaLen;
+      const meta = JSON.parse(metaJson);
+      records.push({
+        aseid,
+        hash: meta.hash ?? aseid,
+        name,
+        type: meta.type,
+        embedding,
+        source: meta.source,
+        description: meta.description,
+        metadata: meta.metadata,
+        namespace: meta.namespace,
+        date: meta.date,
+        model: meta.model,
+        credentialId: meta.credentialId,
+        aFrameVersion: meta.aFrameVersion,
+        aFrameServerVersion: meta.aFrameServerVersion
+      });
+    }
+    return records;
+  }
+  encodeNamespacePayload(records) {
+    const parts = [];
+    if (records.some((r) => !r.embedding)) {
+      throw new Error("All records must have embeddings to be encoded");
+    }
+    const header = new Uint8Array(this.A_FRAME_HEADER_SIZE);
+    const headerView = new DataView(header.buffer);
+    headerView.setUint32(0, this.A_FRAME_FILE_MAGIC, true);
+    header[4] = this.A_FRAME_FILE_VERSION;
+    headerView.setUint32(5, records.length, true);
+    const dims = records[0]?.embedding.length ?? 0;
+    headerView.setUint16(9, dims, true);
+    parts.push(header);
+    for (const rec of records) {
+      const aseidBytes = enc.encode(rec.aseid.toString());
+      const nameBytes = enc.encode(rec.name);
+      const metaJson = JSON.stringify({
+        hash: rec.hash,
+        description: rec.description,
+        metadata: rec.metadata,
+        embeddedAt: rec.embeddedAt,
+        embeddingModel: rec.embeddingModel,
+        credentialId: rec.credentialId,
+        aFrameVersion: rec.aFrameVersion,
+        aFrameServerVersion: rec.aFrameServerVersion
+      });
+      const metaBytes = enc.encode(metaJson);
+      const recSize = 2 + aseidBytes.length + 2 + nameBytes.length + rec.embedding.length * 4 + 4 + metaBytes.length;
+      const recBuf = new Uint8Array(recSize);
+      const view = new DataView(recBuf.buffer);
+      let offset = 0;
+      view.setUint16(offset, aseidBytes.length, true);
+      offset += 2;
+      recBuf.set(aseidBytes, offset);
+      offset += aseidBytes.length;
+      view.setUint16(offset, nameBytes.length, true);
+      offset += 2;
+      recBuf.set(nameBytes, offset);
+      offset += nameBytes.length;
+      for (let i = 0; i < rec.embedding.length; i++) {
+        view.setFloat32(offset, rec.embedding[i], true);
+        offset += 4;
+      }
+      view.setUint32(offset, metaBytes.length, true);
+      offset += 4;
+      recBuf.set(metaBytes, offset);
+      parts.push(recBuf);
+    }
+    const total = parts.reduce((s, p) => s + p.length, 0);
+    const out = new Uint8Array(total);
+    let pos = 0;
+    for (const p of parts) {
+      out.set(p, pos);
+      pos += p.length;
+    }
+    return out;
+  }
+  decodeNamespacePayload(data) {
+    if (data.length < this.A_FRAME_HEADER_SIZE) throw new Error("Corrupt namespace index: too short for header");
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const magic = view.getUint32(0, true);
+    if (magic !== this.A_FRAME_FILE_MAGIC) throw new Error(`Corrupt namespace index: bad magic 0x${magic.toString(16)}`);
+    const version = data[4];
+    if (version !== this.A_FRAME_FILE_VERSION) throw new Error(`Unsupported namespace index version: ${version}`);
+    const count = view.getUint32(5, true);
+    const dims = view.getUint16(9, true);
+    const records = [];
+    let offset = this.A_FRAME_HEADER_SIZE;
+    for (let i = 0; i < count; i++) {
+      const aseidLen = view.getUint16(offset, true);
+      offset += 2;
+      const aseid = dec.decode(data.slice(offset, offset + aseidLen));
+      offset += aseidLen;
+      const nameLen = view.getUint16(offset, true);
+      offset += 2;
+      const name = dec.decode(data.slice(offset, offset + nameLen));
+      offset += nameLen;
+      const embedding = new Float32Array(dims);
+      for (let d = 0; d < dims; d++) {
+        embedding[d] = view.getFloat32(offset, true);
+        offset += 4;
+      }
+      const metaLen = view.getUint32(offset, true);
+      offset += 4;
+      const metaJson = dec.decode(data.slice(offset, offset + metaLen));
+      offset += metaLen;
+      const meta = JSON.parse(metaJson);
+      records.push({
+        aseid,
+        hash: meta.hash ?? aseid,
+        name,
+        embedding,
+        description: meta.description,
+        metadata: meta.metadata,
+        embeddedAt: meta.embeddedAt,
+        embeddingModel: meta.embeddingModel,
+        credentialId: meta.credentialId,
+        aFrameVersion: meta.aFrameVersion,
+        aFrameServerVersion: meta.aFrameServerVersion
+      });
+    }
+    return records;
+  }
+};
+
+export { A_FrameStorageCodec };
+//# sourceMappingURL=chunk-OYZAQMKD.mjs.map
+//# sourceMappingURL=chunk-OYZAQMKD.mjs.map

package/dist/node/chunk-OYZAQMKD.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameStorage/A-FrameStorage.codec.ts"],"names":[],"mappings":"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","file":"chunk-OYZAQMKD.mjs","sourcesContent":["/**\n * A-FrameStorage binary codec — shared between node and browser environments.\n *\n * Binary payload format (decrypted) — used for BOTH definition records and namespace records:\n *   [HEADER 20B]\n *     magic    4B = 0x454D424B (\"EMBK\")\n *     version  1B = 0x01\n *     count    4B (uint32 LE)\n *     dims     2B (uint16 LE)\n *     reserved 9B\n *   [RECORD × count]\n *     aseidLen 2B  (uint16 LE)\n *     aseid    NB  utf-8  (primary entity ID, e.g. \"app@root:123@v2\")\n *     nameLen  2B  (uint16 LE)\n *     name     NB  utf-8\n *     vector   dims×4B  Float32 LE\n *     metaLen  4B  (uint32 LE)\n *     meta     NB  JSON\n */\n\nimport { A_Fragment } from '@adaas/a-concept';\n\nimport type { A_FrameNamespace_Serialized } from '../A-FrameNamespace/A-FrameNamespace.types';\nimport { A_FrameDefinition_Serialized } from '../A-FrameDefinition/A-FrameDefinition.types';\nimport { A_FrameTargetType } from '../A-Frame/A-Frame.types';\n\nconst enc = new TextEncoder();\nconst dec = new TextDecoder();\n\n\nexport class A_FrameStorageCodec extends A_Fragment {\n\n    protected enc = new TextEncoder();\n    protected dec = new TextDecoder();\n\n    // ─── Binary file format constants ────────────────────────────────────────────\n    // FILE LAYOUT (all multi-byte values are little-endian):\n    //   [HEADER 20B]\n    //     magic    4B = 0x454D424B (\"EMBK\")\n    //     version  1B = 0x01\n    //     count    4B (uint32)\n    //     dims     2B (uint16)\n    //     reserved 9B\n    //   [RECORD × count]\n    //     aseidLen 2B (uint16)  — variable-length primary entity ID\n    //     aseid    NB utf-8\n    //     nameLen  2B (uint16)\n    //     name     NB utf-8\n    //     vector   dims×4B Float32 LE\n    //     metaLen  4B (uint32)\n    //     meta     NB JSON\n    //   Encrypted on disk: [IV 12B][AuthTag 16B][Ciphertext]\n    A_FRAME_FILE_MAGIC = 0x454d424b;\n    A_FRAME_FILE_VERSION = 0x01;\n    A_FRAME_HEADER_SIZE = 20;\n\n\n\n    static get fileExtension() {\n        return '.aframe';\n    }\n\n    /** Returns the definitions file name for a given namespace id, e.g. `my-ns.definitions.aframe` */\n    getDefinitionsFileName(namespaceId: string) {\n        return `${namespaceId}.definitions${A_FrameStorageCodec.fileExtension}`;\n    }\n\n    /** Returns the reserved namespaces index file name: `.namespaces.aframe` */\n    getNamespaceFileName() {\n        return `.namespaces${A_FrameStorageCodec.fileExtension}`;\n    }\n\n    /** Glob pattern that matches all definitions files under a directory, e.g. `*.definitions.aframe` */\n    static get definitionsFilePattern() {\n        return `*.definitions${A_FrameStorageCodec.fileExtension}`;\n    }\n\n\n    encodePayload(records: A_FrameDefinition_Serialized[]): Uint8Array {\n        const parts: Uint8Array[] = [];\n\n        if (records.some(r => !r.embedding)) {\n            throw new Error('All records must have embeddings to be encoded');\n        }\n\n        const header = new Uint8Array(this.A_FRAME_HEADER_SIZE);\n        const headerView = new DataView(header.buffer);\n        headerView.setUint32(0, this.A_FRAME_FILE_MAGIC, true);\n        header[4] = this.A_FRAME_FILE_VERSION;\n        headerView.setUint32(5, records.length, true);\n        const dims = records[0]?.embedding!.length ?? 0;\n        headerView.setUint16(9, dims, true);\n        // bytes 11-19: reserved (zeroed)\n        parts.push(header);\n\n        for (const rec of records) {\n            const aseidBytes = enc.encode(rec.aseid.toString());\n            const nameBytes = enc.encode(rec.name);\n            const metaJson = JSON.stringify({\n                hash: rec.hash,\n                source: rec.source,\n                type: rec.type,\n                description: rec.description,\n                metadata: rec.metadata,\n                namespace: rec.namespace,\n                date: rec.date,\n                model: rec.model,\n                credentialId: rec.credentialId,\n                aFrameVersion: rec.aFrameVersion,\n                aFrameServerVersion: rec.aFrameServerVersion,\n            });\n            const metaBytes = enc.encode(metaJson);\n\n            const recSize =\n                2 + aseidBytes.length +\n                2 + nameBytes.length +\n                rec.embedding!.length * 4 +\n                4 + metaBytes.length;\n\n            const recBuf = new Uint8Array(recSize);\n            const view = new DataView(recBuf.buffer);\n            let offset = 0;\n\n            view.setUint16(offset, aseidBytes.length, true); offset += 2;\n            recBuf.set(aseidBytes, offset); offset += aseidBytes.length;\n\n            view.setUint16(offset, nameBytes.length, true); offset += 2;\n            recBuf.set(nameBytes, offset); offset += nameBytes.length;\n\n            for (let i = 0; i < rec.embedding!.length; i++) {\n                view.setFloat32(offset, rec.embedding![i], true);\n                offset += 4;\n            }\n\n            view.setUint32(offset, metaBytes.length, true); offset += 4;\n            recBuf.set(metaBytes, offset);\n\n            parts.push(recBuf);\n        }\n\n        const total = parts.reduce((s, p) => s + p.length, 0);\n        const out = new Uint8Array(total);\n        let pos = 0;\n        for (const p of parts) { out.set(p, pos); pos += p.length; }\n        return out;\n    }\n\n    decodePayload(data: Uint8Array): A_FrameDefinition_Serialized[] {\n        if (data.length < this.A_FRAME_HEADER_SIZE) throw new Error('Corrupt index: too short for header');\n\n        const view = new DataView(data.buffer, data.byteOffset, data.byteLength);\n\n        const magic = view.getUint32(0, true);\n        if (magic !== this.A_FRAME_FILE_MAGIC) throw new Error(`Corrupt index: bad magic 0x${magic.toString(16)}`);\n\n        const version = data[4];\n        if (version !== this.A_FRAME_FILE_VERSION) throw new Error(`Unsupported index version: ${version}`);\n\n        const count = view.getUint32(5, true);\n        const dims = view.getUint16(9, true);\n\n        const records: A_FrameDefinition_Serialized[] = [];\n        let offset = this.A_FRAME_HEADER_SIZE;\n\n        for (let i = 0; i < count; i++) {\n            const aseidLen = view.getUint16(offset, true); offset += 2;\n            const aseid = dec.decode(data.slice(offset, offset + aseidLen)); offset += aseidLen;\n\n            const nameLen = view.getUint16(offset, true); offset += 2;\n            const name = dec.decode(data.slice(offset, offset + nameLen)); offset += nameLen;\n\n            const embedding = new Float32Array(dims);\n            for (let d = 0; d < dims; d++) {\n                embedding[d] = view.getFloat32(offset, true);\n                offset += 4;\n            }\n\n            const metaLen = view.getUint32(offset, true); offset += 4;\n            const metaJson = dec.decode(data.slice(offset, offset + metaLen)); offset += metaLen;\n            const meta = JSON.parse(metaJson) as {\n                hash?: string;\n                source: string;\n                description?: string;\n                type: A_FrameTargetType;\n                metadata?: Record<string, unknown>;\n                namespace: string;\n                date: string;\n                model: string;\n                credentialId: string;\n                aFrameVersion: string;\n                aFrameServerVersion: string;\n            };\n\n            records.push({\n                aseid,\n                hash: meta.hash ?? aseid,\n                name,\n                type: meta.type,\n                embedding,\n                source: meta.source,\n                description: meta.description,\n                metadata: meta.metadata,\n                namespace: meta.namespace,\n                date: meta.date,\n                model: meta.model,\n                credentialId: meta.credentialId,\n                aFrameVersion: meta.aFrameVersion,\n                aFrameServerVersion: meta.aFrameServerVersion,\n            });\n        }\n\n        return records;\n    }\n\n\n    encodeNamespacePayload(records: A_FrameNamespace_Serialized[]): Uint8Array {\n        const parts: Uint8Array[] = [];\n\n        if (records.some(r => !r.embedding)) {\n            throw new Error('All records must have embeddings to be encoded');\n        }\n\n        const header = new Uint8Array(this.A_FRAME_HEADER_SIZE);\n        const headerView = new DataView(header.buffer);\n        headerView.setUint32(0, this.A_FRAME_FILE_MAGIC, true);\n        header[4] = this.A_FRAME_FILE_VERSION;\n        headerView.setUint32(5, records.length, true);\n        const dims = records[0]?.embedding!.length ?? 0;\n        headerView.setUint16(9, dims, true);\n        parts.push(header);\n\n        for (const rec of records) {\n            const aseidBytes = enc.encode(rec.aseid.toString());\n            const nameBytes = enc.encode(rec.name);\n            const metaJson = JSON.stringify({\n                hash: rec.hash,\n                description: rec.description,\n                metadata: rec.metadata,\n                embeddedAt: rec.embeddedAt,\n                embeddingModel: rec.embeddingModel,\n                credentialId: rec.credentialId,\n                aFrameVersion: rec.aFrameVersion,\n                aFrameServerVersion: rec.aFrameServerVersion,\n            });\n            const metaBytes = enc.encode(metaJson);\n\n            const recSize =\n                2 + aseidBytes.length +\n                2 + nameBytes.length +\n                rec.embedding!.length * 4 +\n                4 + metaBytes.length;\n\n            const recBuf = new Uint8Array(recSize);\n            const view = new DataView(recBuf.buffer);\n            let offset = 0;\n\n            view.setUint16(offset, aseidBytes.length, true); offset += 2;\n            recBuf.set(aseidBytes, offset); offset += aseidBytes.length;\n\n            view.setUint16(offset, nameBytes.length, true); offset += 2;\n            recBuf.set(nameBytes, offset); offset += nameBytes.length;\n\n            for (let i = 0; i < rec.embedding!.length; i++) {\n                view.setFloat32(offset, rec.embedding![i], true);\n                offset += 4;\n            }\n\n            view.setUint32(offset, metaBytes.length, true); offset += 4;\n            recBuf.set(metaBytes, offset);\n\n            parts.push(recBuf);\n        }\n\n        const total = parts.reduce((s, p) => s + p.length, 0);\n        const out = new Uint8Array(total);\n        let pos = 0;\n        for (const p of parts) { out.set(p, pos); pos += p.length; }\n        return out;\n    }\n\n    decodeNamespacePayload(data: Uint8Array): A_FrameNamespace_Serialized[] {\n        if (data.length < this.A_FRAME_HEADER_SIZE) throw new Error('Corrupt namespace index: too short for header');\n\n        const view = new DataView(data.buffer, data.byteOffset, data.byteLength);\n\n        const magic = view.getUint32(0, true);\n        if (magic !== this.A_FRAME_FILE_MAGIC) throw new Error(`Corrupt namespace index: bad magic 0x${magic.toString(16)}`);\n\n        const version = data[4];\n        if (version !== this.A_FRAME_FILE_VERSION) throw new Error(`Unsupported namespace index version: ${version}`);\n\n        const count = view.getUint32(5, true);\n        const dims = view.getUint16(9, true);\n\n        const records: A_FrameNamespace_Serialized[] = [];\n        let offset = this.A_FRAME_HEADER_SIZE;\n\n        for (let i = 0; i < count; i++) {\n            const aseidLen = view.getUint16(offset, true); offset += 2;\n            const aseid = dec.decode(data.slice(offset, offset + aseidLen)); offset += aseidLen;\n\n            const nameLen = view.getUint16(offset, true); offset += 2;\n            const name = dec.decode(data.slice(offset, offset + nameLen)); offset += nameLen;\n\n            const embedding = new Float32Array(dims);\n            for (let d = 0; d < dims; d++) {\n                embedding[d] = view.getFloat32(offset, true);\n                offset += 4;\n            }\n\n            const metaLen = view.getUint32(offset, true); offset += 4;\n            const metaJson = dec.decode(data.slice(offset, offset + metaLen)); offset += metaLen;\n            const meta = JSON.parse(metaJson) as {\n                hash?: string;\n                description?: string;\n                metadata?: Record<string, unknown>;\n                embeddedAt: number;\n                embeddingModel?: string;\n                credentialId?: string;\n                aFrameVersion?: string;\n                aFrameServerVersion?: string;\n            };\n\n            records.push({\n                aseid,\n                hash: meta.hash ?? aseid,\n                name,\n                embedding,\n                description: meta.description,\n                metadata: meta.metadata,\n                embeddedAt: meta.embeddedAt,\n                embeddingModel: meta.embeddingModel,\n                credentialId: meta.credentialId,\n                aFrameVersion: meta.aFrameVersion,\n                aFrameServerVersion: meta.aFrameServerVersion,\n            });\n        }\n\n        return records;\n    }\n\n}\n\n\n"]}