@adaas/a-frame 0.0.22 → 0.1.1

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../package.json"],"names":[],"mappings":";AAEE,IAAA,OAAA,GAAW","file":"chunk-OYC6L5NX.mjs","sourcesContent":["{\n  \"name\": \"@adaas/a-frame\",\n  \"version\": \"0.1.0\",\n  \"description\": \"A-frame is index build engine for A-Concept ecosystem. It provides a way to build index structures for A-Concept basics\",\n  \"license\": \"Apache-2.0\",\n  \"author\": {\n    \"name\": \"ADAAS YAZILIM LİMİTED ŞİRKETİ\",\n    \"email\": \"contact-us@adaas.org\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/ADAAS-org/adaas-a-frame/issues\"\n  },\n  \"homepage\": \"https://github.com/ADAAS-org/adaas-a-frame#readme\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/ADAAS-org/adaas-a-frame.git\"\n  },\n  \"bin\": {\n    \"a-frame\": \"./dist/index.cjs\"\n  },\n  \"exports\": {\n    \".\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/index.d.mts\",\n        \"import\": \"./dist/browser/index.mjs\"\n      },\n      \"types\": \"./dist/node/index.d.ts\",\n      \"import\": \"./dist/node/index.mjs\",\n      \"require\": \"./dist/node/index.cjs\"\n    },\n    \"./core\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/core.d.mts\",\n        \"import\": \"./dist/browser/core.mjs\"\n      },\n      \"types\": \"./dist/node/core.d.ts\",\n      \"import\": \"./dist/node/core.mjs\",\n      \"require\": \"./dist/node/core.cjs\"\n    },\n    \"./bundle\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/bundle.d.mts\",\n        \"import\": \"./dist/browser/bundle.mjs\"\n      },\n      \"types\": \"./dist/node/bundle.d.ts\",\n      \"import\": \"./dist/node/bundle.mjs\",\n      \"require\": \"./dist/node/bundle.cjs\"\n    },\n    \"./channel\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/channel.d.mts\",\n        \"import\": \"./dist/browser/channel.mjs\"\n      },\n      \"types\": \"./dist/node/channel.d.ts\",\n      \"import\": \"./dist/node/channel.mjs\",\n      \"require\": \"./dist/node/channel.cjs\"\n    },\n    \"./crypto\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/crypto.d.mts\",\n        \"import\": \"./dist/browser/crypto.mjs\"\n      },\n      \"types\": \"./dist/node/crypto.d.ts\",\n      \"import\": \"./dist/node/crypto.mjs\",\n      \"require\": \"./dist/node/crypto.cjs\"\n    },\n    \"./definition\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/definition.d.mts\",\n        \"import\": \"./dist/browser/definition.mjs\"\n      },\n      \"types\": \"./dist/node/definition.d.ts\",\n      \"import\": \"./dist/node/definition.mjs\",\n      \"require\": \"./dist/node/definition.cjs\"\n    },\n    \"./dynamic-feature\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/dynamic-feature.d.mts\",\n        \"import\": \"./dist/browser/dynamic-feature.mjs\"\n      },\n      \"types\": \"./dist/node/dynamic-feature.d.ts\",\n      \"import\": \"./dist/node/dynamic-feature.mjs\",\n      \"require\": \"./dist/node/dynamic-feature.cjs\"\n    },\n    \"./dynamic-structure\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/dynamic-structure.d.mts\",\n        \"import\": \"./dist/browser/dynamic-structure.mjs\"\n      },\n      \"types\": \"./dist/node/dynamic-structure.d.ts\",\n      \"import\": \"./dist/node/dynamic-structure.mjs\",\n      \"require\": \"./dist/node/dynamic-structure.cjs\"\n    },\n    \"./env\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/env.d.mts\",\n        \"import\": \"./dist/browser/env.mjs\"\n      },\n      \"types\": \"./dist/node/env.d.ts\",\n      \"import\": \"./dist/node/env.mjs\",\n      \"require\": \"./dist/node/env.cjs\"\n    },\n    \"./index\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/frame-index.d.mts\",\n        \"import\": \"./dist/browser/frame-index.mjs\"\n      },\n      \"types\": \"./dist/node/frame-index.d.ts\",\n      \"import\": \"./dist/node/frame-index.mjs\",\n      \"require\": \"./dist/node/frame-index.cjs\"\n    },\n    \"./logger\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/logger.d.mts\",\n        \"import\": \"./dist/browser/logger.mjs\"\n      },\n      \"types\": \"./dist/node/logger.d.ts\",\n      \"import\": \"./dist/node/logger.mjs\",\n      \"require\": \"./dist/node/logger.cjs\"\n    },\n    \"./namespace\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/namespace.d.mts\",\n        \"import\": \"./dist/browser/namespace.mjs\"\n      },\n      \"types\": \"./dist/node/namespace.d.ts\",\n      \"import\": \"./dist/node/namespace.mjs\",\n      \"require\": \"./dist/node/namespace.cjs\"\n    },\n    \"./storage\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/storage.d.mts\",\n        \"import\": \"./dist/browser/storage.mjs\"\n      },\n      \"types\": \"./dist/node/storage.d.ts\",\n      \"import\": \"./dist/node/storage.mjs\",\n      \"require\": \"./dist/node/storage.cjs\"\n    },\n    \"./vector\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/vector.d.mts\",\n        \"import\": \"./dist/browser/vector.mjs\"\n      },\n      \"types\": \"./dist/node/vector.d.ts\",\n      \"import\": \"./dist/node/vector.mjs\",\n      \"require\": \"./dist/node/vector.cjs\"\n    }\n  },\n  \"keywords\": [\n    \"adaas\",\n    \"a-frame\",\n    \"ai index\",\n    \"embeddings\",\n    \"a-concept\",\n    \"rag\"\n  ],\n  \"sideEffects\": false,\n  \"nodemonConfig\": {\n    \"ignore\": [\n      \"**/*.test.ts\",\n      \"**/*.spec.ts\",\n      \".git\",\n      \"node_modules\"\n    ],\n    \"watch\": [\n      \"src\",\n      \"examples\"\n    ],\n    \"exec\": \"node -r tsconfig-paths/register -r ts-node/register \",\n    \"ext\": \"ts, js\"\n  },\n  \"scripts\": {\n    \"test\": \"jest --detectOpenHandles\",\n    \"test:browser\": \"jest --config jest.config.browser.ts --detectOpenHandles\",\n    \"start\": \"nodemon ./tests/example-usage.ts\",\n    \"start:test\": \"node -r tsconfig-paths/register -r ts-node/register ./index.ts\",\n    \"release\": \"npm run test && npm run build && git add . && git commit -m \\\"new version created :: $(cat package.json | grep version | head -1  | awk -F: '{ print $2 }'  | sed 's/[\\\",]//g')\\\" && npm version patch && npm publish --access public\",\n    \"version\": \"echo git add .\",\n    \"postversion\": \"git push --no-verify && git push --tags --no-verify && echo \\\"\\n======Version Pushed Successfully=====\\n\\\" \",\n    \"echo-version\": \"echo $npm_package_version\",\n    \"build\": \"tsup --config tsup.config.ts\"\n  },\n  \"dependencies\": {\n    \"@adaas/a-concept\": \"^0.3.15\"\n  },\n  \"devDependencies\": {\n    \"@types/chai\": \"^4.3.14\",\n    \"@types/jest\": \"^29.5.12\",\n    \"@types/mocha\": \"^10.0.6\",\n    \"@types/node\": \"^24.9.1\",\n    \"chai\": \"^5.1.0\",\n    \"dotenv\": \"^16.6.1\",\n    \"jest\": \"^29.7.0\",\n    \"jest-environment-jsdom\": \"^29.7.0\",\n    \"mocha\": \"^10.4.0\",\n    \"nodemon\": \"^3.1.4\",\n    \"ts-jest\": \"^29.1.2\",\n    \"ts-node\": \"^10.9.2\",\n    \"tsconfig-paths\": \"^4.2.0\",\n    \"tscpaths\": \"^0.0.9\",\n    \"tsup\": \"^8.5.0\"\n  },\n  \"directories\": {\n    \"doc\": \"docs\",\n    \"test\": \"tests\"\n  }\n}\n"]}

package/dist/node/chunk-QFHZIG7Y.cjs

@@ -0,0 +1,25 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+
+exports.__decorateClass = __decorateClass;
+exports.__decorateParam = __decorateParam;
+exports.__require = __require;
+//# sourceMappingURL=chunk-QFHZIG7Y.cjs.map
+//# sourceMappingURL=chunk-QFHZIG7Y.cjs.map

package/dist/node/chunk-QFHZIG7Y.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-QFHZIG7Y.cjs"}

package/dist/node/chunk-QFUZVN4Y.cjs

@@ -0,0 +1,259 @@
+'use strict';
+
+var aConcept = require('@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 aConcept.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";
+  }
+  getFileName(namespace) {
+    return `${namespace}${_A_FrameStorageCodec.fileExtension}`;
+  }
+  getNamespaceFileName() {
+    return `__namespaces${_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;
+  }
+};
+
+exports.A_FrameStorageCodec = A_FrameStorageCodec;
+//# sourceMappingURL=chunk-QFUZVN4Y.cjs.map
+//# sourceMappingURL=chunk-QFUZVN4Y.cjs.map

package/dist/node/chunk-QFUZVN4Y.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameStorage/A-FrameStorage.codec.ts"],"names":["A_Fragment"],"mappings":"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","file":"chunk-QFUZVN4Y.cjs","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\n    getFileName(namespace: string) {\n        return `${namespace}${A_FrameStorageCodec.fileExtension}`;\n    }\n\n    getNamespaceFileName() {\n        return `__namespaces${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"]}

package/dist/node/chunk-R2H234YO.cjs

@@ -0,0 +1,8 @@
+'use strict';
+
+// package.json
+var version = "0.1.0";
+
+exports.version = version;
+//# sourceMappingURL=chunk-R2H234YO.cjs.map
+//# sourceMappingURL=chunk-R2H234YO.cjs.map

package/dist/node/chunk-R2H234YO.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../package.json"],"names":[],"mappings":";;;AAEE,IAAA,OAAA,GAAW","file":"chunk-R2H234YO.cjs","sourcesContent":["{\n  \"name\": \"@adaas/a-frame\",\n  \"version\": \"0.1.0\",\n  \"description\": \"A-frame is index build engine for A-Concept ecosystem. It provides a way to build index structures for A-Concept basics\",\n  \"license\": \"Apache-2.0\",\n  \"author\": {\n    \"name\": \"ADAAS YAZILIM LİMİTED ŞİRKETİ\",\n    \"email\": \"contact-us@adaas.org\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/ADAAS-org/adaas-a-frame/issues\"\n  },\n  \"homepage\": \"https://github.com/ADAAS-org/adaas-a-frame#readme\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/ADAAS-org/adaas-a-frame.git\"\n  },\n  \"bin\": {\n    \"a-frame\": \"./dist/index.cjs\"\n  },\n  \"exports\": {\n    \".\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/index.d.mts\",\n        \"import\": \"./dist/browser/index.mjs\"\n      },\n      \"types\": \"./dist/node/index.d.ts\",\n      \"import\": \"./dist/node/index.mjs\",\n      \"require\": \"./dist/node/index.cjs\"\n    },\n    \"./core\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/core.d.mts\",\n        \"import\": \"./dist/browser/core.mjs\"\n      },\n      \"types\": \"./dist/node/core.d.ts\",\n      \"import\": \"./dist/node/core.mjs\",\n      \"require\": \"./dist/node/core.cjs\"\n    },\n    \"./bundle\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/bundle.d.mts\",\n        \"import\": \"./dist/browser/bundle.mjs\"\n      },\n      \"types\": \"./dist/node/bundle.d.ts\",\n      \"import\": \"./dist/node/bundle.mjs\",\n      \"require\": \"./dist/node/bundle.cjs\"\n    },\n    \"./channel\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/channel.d.mts\",\n        \"import\": \"./dist/browser/channel.mjs\"\n      },\n      \"types\": \"./dist/node/channel.d.ts\",\n      \"import\": \"./dist/node/channel.mjs\",\n      \"require\": \"./dist/node/channel.cjs\"\n    },\n    \"./crypto\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/crypto.d.mts\",\n        \"import\": \"./dist/browser/crypto.mjs\"\n      },\n      \"types\": \"./dist/node/crypto.d.ts\",\n      \"import\": \"./dist/node/crypto.mjs\",\n      \"require\": \"./dist/node/crypto.cjs\"\n    },\n    \"./definition\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/definition.d.mts\",\n        \"import\": \"./dist/browser/definition.mjs\"\n      },\n      \"types\": \"./dist/node/definition.d.ts\",\n      \"import\": \"./dist/node/definition.mjs\",\n      \"require\": \"./dist/node/definition.cjs\"\n    },\n    \"./dynamic-feature\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/dynamic-feature.d.mts\",\n        \"import\": \"./dist/browser/dynamic-feature.mjs\"\n      },\n      \"types\": \"./dist/node/dynamic-feature.d.ts\",\n      \"import\": \"./dist/node/dynamic-feature.mjs\",\n      \"require\": \"./dist/node/dynamic-feature.cjs\"\n    },\n    \"./dynamic-structure\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/dynamic-structure.d.mts\",\n        \"import\": \"./dist/browser/dynamic-structure.mjs\"\n      },\n      \"types\": \"./dist/node/dynamic-structure.d.ts\",\n      \"import\": \"./dist/node/dynamic-structure.mjs\",\n      \"require\": \"./dist/node/dynamic-structure.cjs\"\n    },\n    \"./env\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/env.d.mts\",\n        \"import\": \"./dist/browser/env.mjs\"\n      },\n      \"types\": \"./dist/node/env.d.ts\",\n      \"import\": \"./dist/node/env.mjs\",\n      \"require\": \"./dist/node/env.cjs\"\n    },\n    \"./index\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/frame-index.d.mts\",\n        \"import\": \"./dist/browser/frame-index.mjs\"\n      },\n      \"types\": \"./dist/node/frame-index.d.ts\",\n      \"import\": \"./dist/node/frame-index.mjs\",\n      \"require\": \"./dist/node/frame-index.cjs\"\n    },\n    \"./logger\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/logger.d.mts\",\n        \"import\": \"./dist/browser/logger.mjs\"\n      },\n      \"types\": \"./dist/node/logger.d.ts\",\n      \"import\": \"./dist/node/logger.mjs\",\n      \"require\": \"./dist/node/logger.cjs\"\n    },\n    \"./namespace\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/namespace.d.mts\",\n        \"import\": \"./dist/browser/namespace.mjs\"\n      },\n      \"types\": \"./dist/node/namespace.d.ts\",\n      \"import\": \"./dist/node/namespace.mjs\",\n      \"require\": \"./dist/node/namespace.cjs\"\n    },\n    \"./storage\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/storage.d.mts\",\n        \"import\": \"./dist/browser/storage.mjs\"\n      },\n      \"types\": \"./dist/node/storage.d.ts\",\n      \"import\": \"./dist/node/storage.mjs\",\n      \"require\": \"./dist/node/storage.cjs\"\n    },\n    \"./vector\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/vector.d.mts\",\n        \"import\": \"./dist/browser/vector.mjs\"\n      },\n      \"types\": \"./dist/node/vector.d.ts\",\n      \"import\": \"./dist/node/vector.mjs\",\n      \"require\": \"./dist/node/vector.cjs\"\n    }\n  },\n  \"keywords\": [\n    \"adaas\",\n    \"a-frame\",\n    \"ai index\",\n    \"embeddings\",\n    \"a-concept\",\n    \"rag\"\n  ],\n  \"sideEffects\": false,\n  \"nodemonConfig\": {\n    \"ignore\": [\n      \"**/*.test.ts\",\n      \"**/*.spec.ts\",\n      \".git\",\n      \"node_modules\"\n    ],\n    \"watch\": [\n      \"src\",\n      \"examples\"\n    ],\n    \"exec\": \"node -r tsconfig-paths/register -r ts-node/register \",\n    \"ext\": \"ts, js\"\n  },\n  \"scripts\": {\n    \"test\": \"jest --detectOpenHandles\",\n    \"test:browser\": \"jest --config jest.config.browser.ts --detectOpenHandles\",\n    \"start\": \"nodemon ./tests/example-usage.ts\",\n    \"start:test\": \"node -r tsconfig-paths/register -r ts-node/register ./index.ts\",\n    \"release\": \"npm run test && npm run build && git add . && git commit -m \\\"new version created :: $(cat package.json | grep version | head -1  | awk -F: '{ print $2 }'  | sed 's/[\\\",]//g')\\\" && npm version patch && npm publish --access public\",\n    \"version\": \"echo git add .\",\n    \"postversion\": \"git push --no-verify && git push --tags --no-verify && echo \\\"\\n======Version Pushed Successfully=====\\n\\\" \",\n    \"echo-version\": \"echo $npm_package_version\",\n    \"build\": \"tsup --config tsup.config.ts\"\n  },\n  \"dependencies\": {\n    \"@adaas/a-concept\": \"^0.3.15\"\n  },\n  \"devDependencies\": {\n    \"@types/chai\": \"^4.3.14\",\n    \"@types/jest\": \"^29.5.12\",\n    \"@types/mocha\": \"^10.0.6\",\n    \"@types/node\": \"^24.9.1\",\n    \"chai\": \"^5.1.0\",\n    \"dotenv\": \"^16.6.1\",\n    \"jest\": \"^29.7.0\",\n    \"jest-environment-jsdom\": \"^29.7.0\",\n    \"mocha\": \"^10.4.0\",\n    \"nodemon\": \"^3.1.4\",\n    \"ts-jest\": \"^29.1.2\",\n    \"ts-node\": \"^10.9.2\",\n    \"tsconfig-paths\": \"^4.2.0\",\n    \"tscpaths\": \"^0.0.9\",\n    \"tsup\": \"^8.5.0\"\n  },\n  \"directories\": {\n    \"doc\": \"docs\",\n    \"test\": \"tests\"\n  }\n}\n"]}

package/dist/node/chunk-RRLTGGM7.cjs

@@ -0,0 +1,209 @@
+'use strict';
+
+var chunkKLG6HKFU_cjs = require('./chunk-KLG6HKFU.cjs');
+var aConcept = require('@adaas/a-concept');
+
+var A_FrameIndex = class _A_FrameIndex extends aConcept.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 aConcept.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 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" ? aConcept.ASEID.isASEID(filter.namespace) ? new aConcept.ASEID(filter.namespace).id : filter.namespace : filter.namespace.id : void 0;
+    return [...this.definitions.values()].filter((r) => !namespaceName || r.namespace.name === namespaceName);
+  }
+  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" ? aConcept.ASEID.isASEID(nameOrASEID) ? new aConcept.ASEID(nameOrASEID).id : nameOrASEID : nameOrASEID.id;
+    return this.namespaces.get(targetKey);
+  }
+  getDefaultNamespace() {
+    let defaultNamespace = this.getNamespace(chunkKLG6HKFU_cjs.A_FRAME_DEFAULT_NAMESPACE_KEY);
+    if (!defaultNamespace) {
+      defaultNamespace = new chunkKLG6HKFU_cjs.A_FrameNamespace({
+        name: chunkKLG6HKFU_cjs.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 } = options;
+    const pool = namespace ? [...this.definitions.values()].filter((r) => r.namespace.id === namespace) : [...this.definitions.values()];
+    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
+    }));
+  }
+  // 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);
+  // }
+};
+
+exports.A_FrameIndex = A_FrameIndex;
+//# sourceMappingURL=chunk-RRLTGGM7.cjs.map
+//# sourceMappingURL=chunk-RRLTGGM7.cjs.map

package/dist/node/chunk-RRLTGGM7.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameIndex/A-FrameIndex.context.ts"],"names":["A_Fragment","A_Scope","ASEID","A_FRAME_DEFAULT_NAMESPACE_KEY","A_FrameNamespace"],"mappings":"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","file":"chunk-RRLTGGM7.cjs","sourcesContent":["import { 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_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 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: {\n        namespace?: string | A_FrameNamespace\n    }): 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: {\n        namespace?: string | A_FrameNamespace\n    } = {}): 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        return [...this.definitions.values()].filter(r => !namespaceName || r.namespace.name === namespaceName);\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 } = options;\n\n        const pool = namespace\n            ? [...this.definitions.values()].filter(r => r.namespace.id === namespace)\n            : [...this.definitions.values()];\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    // 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}"]}