@adaas/a-frame 0.0.21 → 0.0.23

package/dist/node/chunk-3ONWH75E.mjs

@@ -0,0 +1,257 @@
+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";
+  }
+  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;
+  }
+};
+
+export { A_FrameStorageCodec };
+//# sourceMappingURL=chunk-3ONWH75E.mjs.map
+//# sourceMappingURL=chunk-3ONWH75E.mjs.map

package/dist/node/chunk-3ONWH75E.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameStorage/A-FrameStorage.codec.ts"],"names":[],"mappings":"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","file":"chunk-3ONWH75E.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\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-3TD2PEDZ.mjs

@@ -0,0 +1,53 @@
+import { A_Entity } from '@adaas/a-concept';
+
+// src/lib/A-FrameVector/A-FrameVector.entity.ts
+var A_FrameVector = class _A_FrameVector extends A_Entity {
+  static get concept() {
+    return "a-frame";
+  }
+  constructor(values) {
+    super();
+    this.values = values instanceof Float32Array ? values : new Float32Array(values);
+  }
+  get length() {
+    return this.values.length;
+  }
+  magnitude() {
+    let sum = 0;
+    for (let i = 0; i < this.values.length; i++) {
+      sum += this.values[i] ** 2;
+    }
+    return Math.sqrt(sum);
+  }
+  normalize() {
+    const mag = this.magnitude();
+    if (mag === 0) return this;
+    const normalized = new Float32Array(this.length);
+    for (let i = 0; i < this.length; i++) {
+      normalized[i] = this.values[i] / mag;
+    }
+    return new _A_FrameVector(normalized);
+  }
+  dot(other) {
+    this.assertSameLength(other);
+    let sum = 0;
+    for (let i = 0; i < this.length; i++) {
+      sum += this.values[i] * other.values[i];
+    }
+    return sum;
+  }
+  assertSameLength(other) {
+    if (this.length !== other.length) {
+      throw new Error(
+        `Embedding dimension mismatch: ${this.length} vs ${other.length}`
+      );
+    }
+  }
+  toArray() {
+    return Array.from(this.values);
+  }
+};
+
+export { A_FrameVector };
+//# sourceMappingURL=chunk-3TD2PEDZ.mjs.map
+//# sourceMappingURL=chunk-3TD2PEDZ.mjs.map

package/dist/node/chunk-3TD2PEDZ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameVector/A-FrameVector.entity.ts"],"names":[],"mappings":";;;AAEO,IAAM,aAAA,GAAN,MAAM,cAAA,SAAsB,QAAA,CAAS;AAAA,EAExC,WAAW,OAAA,GAAkB;AACzB,IAAA,OAAO,SAAA;AAAA,EACX;AAAA,EAIA,YAAY,MAAA,EAAiC;AACzC,IAAA,KAAA,EAAM;AACN,IAAA,IAAA,CAAK,SAAS,MAAA,YAAkB,YAAA,GAC1B,MAAA,GACA,IAAI,aAAa,MAAM,CAAA;AAAA,EACjC;AAAA,EAEA,IAAI,MAAA,GAAiB;AACjB,IAAA,OAAO,KAAK,MAAA,CAAO,MAAA;AAAA,EACvB;AAAA,EAEA,SAAA,GAAoB;AAChB,IAAA,IAAI,GAAA,GAAM,CAAA;AACV,IAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,IAAA,CAAK,MAAA,CAAO,QAAQ,CAAA,EAAA,EAAK;AACzC,MAAA,GAAA,IAAO,IAAA,CAAK,MAAA,CAAO,CAAC,CAAA,IAAK,CAAA;AAAA,IAC7B;AACA,IAAA,OAAO,IAAA,CAAK,KAAK,GAAG,CAAA;AAAA,EACxB;AAAA,EAEA,SAAA,GAA2B;AACvB,IAAA,MAAM,GAAA,GAAM,KAAK,SAAA,EAAU;AAC3B,IAAA,IAAI,GAAA,KAAQ,GAAG,OAAO,IAAA;AAEtB,IAAA,MAAM,UAAA,GAAa,IAAI,YAAA,CAAa,IAAA,CAAK,MAAM,CAAA;AAC/C,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,IAAA,CAAK,QAAQ,CAAA,EAAA,EAAK;AAClC,MAAA,UAAA,CAAW,CAAC,CAAA,GAAI,IAAA,CAAK,MAAA,CAAO,CAAC,CAAA,GAAI,GAAA;AAAA,IACrC;AAEA,IAAA,OAAO,IAAI,eAAc,UAAU,CAAA;AAAA,EACvC;AAAA,EAEA,IAAI,KAAA,EAA8B;AAC9B,IAAA,IAAA,CAAK,iBAAiB,KAAK,CAAA;AAE3B,IAAA,IAAI,GAAA,GAAM,CAAA;AACV,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,IAAA,CAAK,QAAQ,CAAA,EAAA,EAAK;AAClC,MAAA,GAAA,IAAO,KAAK,MAAA,CAAO,CAAC,CAAA,GAAI,KAAA,CAAM,OAAO,CAAC,CAAA;AAAA,IAC1C;AACA,IAAA,OAAO,GAAA;AAAA,EACX;AAAA,EAEQ,iBAAiB,KAAA,EAAsB;AAC3C,IAAA,IAAI,IAAA,CAAK,MAAA,KAAW,KAAA,CAAM,MAAA,EAAQ;AAC9B,MAAA,MAAM,IAAI,KAAA;AAAA,QACN,CAAA,8BAAA,EAAiC,IAAA,CAAK,MAAM,CAAA,IAAA,EAAO,MAAM,MAAM,CAAA;AAAA,OACnE;AAAA,IACJ;AAAA,EACJ;AAAA,EAGA,OAAA,GAAoB;AAChB,IAAA,OAAO,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,MAAM,CAAA;AAAA,EACjC;AACJ","file":"chunk-3TD2PEDZ.mjs","sourcesContent":["import { A_Entity } from \"@adaas/a-concept\"\n\nexport class A_FrameVector extends A_Entity {\n\n    static get concept(): string {\n        return 'a-frame';\n    }\n\n    readonly values: Float32Array\n\n    constructor(values: number[] | Float32Array) {\n        super();\n        this.values = values instanceof Float32Array\n            ? values\n            : new Float32Array(values)\n    }\n\n    get length(): number {\n        return this.values.length\n    }\n\n    magnitude(): number {\n        let sum = 0\n        for (let i = 0; i < this.values.length; i++) {\n            sum += this.values[i] ** 2\n        }\n        return Math.sqrt(sum)\n    }\n\n    normalize(): A_FrameVector {\n        const mag = this.magnitude()\n        if (mag === 0) return this\n\n        const normalized = new Float32Array(this.length)\n        for (let i = 0; i < this.length; i++) {\n            normalized[i] = this.values[i] / mag\n        }\n\n        return new A_FrameVector(normalized)\n    }\n\n    dot(other: A_FrameVector): number {\n        this.assertSameLength(other)\n\n        let sum = 0\n        for (let i = 0; i < this.length; i++) {\n            sum += this.values[i] * other.values[i]\n        }\n        return sum\n    }\n\n    private assertSameLength(other: A_FrameVector) {\n        if (this.length !== other.length) {\n            throw new Error(\n                `Embedding dimension mismatch: ${this.length} vs ${other.length}`\n            )\n        }\n    }\n\n\n    toArray(): number[] {\n        return Array.from(this.values)\n    }\n}\n"]}

package/dist/node/chunk-442DXGOD.mjs

@@ -0,0 +1,16 @@
+// src/helpers/Hash.helper.ts
+var A_FrameHashHelper = class {
+  // ─── Hash (FNV-1a 32-bit, no external deps) ──────────────────────────────────
+  static fnv1a(str) {
+    let hash = 2166136261;
+    for (let i = 0; i < str.length; i++) {
+      hash ^= str.charCodeAt(i);
+      hash = hash * 16777619 >>> 0;
+    }
+    return hash.toString(16).padStart(8, "0");
+  }
+};
+
+export { A_FrameHashHelper };
+//# sourceMappingURL=chunk-442DXGOD.mjs.map
+//# sourceMappingURL=chunk-442DXGOD.mjs.map

package/dist/node/chunk-442DXGOD.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/helpers/Hash.helper.ts"],"names":[],"mappings":";AAEO,IAAM,oBAAN,MAAwB;AAAA;AAAA,EAG3B,OAAO,MAAM,GAAA,EAAqB;AAC9B,IAAA,IAAI,IAAA,GAAO,UAAA;AACX,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,GAAA,CAAI,QAAQ,CAAA,EAAA,EAAK;AACjC,MAAA,IAAA,IAAQ,GAAA,CAAI,WAAW,CAAC,CAAA;AACxB,MAAA,IAAA,GAAQ,OAAO,QAAA,KAAgB,CAAA;AAAA,IACnC;AACA,IAAA,OAAO,KAAK,QAAA,CAAS,EAAE,CAAA,CAAE,QAAA,CAAS,GAAG,GAAG,CAAA;AAAA,EAC5C;AACJ","file":"chunk-442DXGOD.mjs","sourcesContent":["\n\nexport class A_FrameHashHelper {\n\n    // ─── Hash (FNV-1a 32-bit, no external deps) ──────────────────────────────────\n    static fnv1a(str: string): string {\n        let hash = 2_166_136_261; // offset basis\n        for (let i = 0; i < str.length; i++) {\n            hash ^= str.charCodeAt(i);\n            hash = (hash * 16_777_619) >>> 0; // keep 32-bit unsigned\n        }\n        return hash.toString(16).padStart(8, \"0\");\n    }\n}"]}

package/dist/node/chunk-6EFXNUL4.mjs

@@ -0,0 +1,6 @@
+// package.json
+var version = "0.0.22";
+
+export { version };
+//# sourceMappingURL=chunk-6EFXNUL4.mjs.map
+//# sourceMappingURL=chunk-6EFXNUL4.mjs.map

package/dist/node/chunk-6EFXNUL4.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../package.json"],"names":[],"mappings":";AAEE,IAAA,OAAA,GAAW","file":"chunk-6EFXNUL4.mjs","sourcesContent":["{\n  \"name\": \"@adaas/a-frame\",\n  \"version\": \"0.0.22\",\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      \"import\": \"./dist/node/index.mjs\",\n      \"require\": \"./dist/node/index.cjs\",\n      \"types\": \"./dist/node/index.d.ts\"\n    },\n    \"./core\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/core.d.mts\",\n        \"import\": \"./dist/browser/core.mjs\"\n      },\n      \"import\": \"./dist/node/core.mjs\",\n      \"require\": \"./dist/node/core.cjs\",\n      \"types\": \"./dist/node/core.d.ts\"\n    },\n    \"./bundle\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/bundle.d.mts\",\n        \"import\": \"./dist/browser/bundle.mjs\"\n      },\n      \"import\": \"./dist/node/bundle.mjs\",\n      \"require\": \"./dist/node/bundle.cjs\",\n      \"types\": \"./dist/node/bundle.d.ts\"\n    },\n    \"./channel\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/channel.d.mts\",\n        \"import\": \"./dist/browser/channel.mjs\"\n      },\n      \"import\": \"./dist/node/channel.mjs\",\n      \"require\": \"./dist/node/channel.cjs\",\n      \"types\": \"./dist/node/channel.d.ts\"\n    },\n    \"./crypto\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/crypto.d.mts\",\n        \"import\": \"./dist/browser/crypto.mjs\"\n      },\n      \"import\": \"./dist/node/crypto.mjs\",\n      \"require\": \"./dist/node/crypto.cjs\",\n      \"types\": \"./dist/node/crypto.d.ts\"\n    },\n    \"./definition\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/definition.d.mts\",\n        \"import\": \"./dist/browser/definition.mjs\"\n      },\n      \"import\": \"./dist/node/definition.mjs\",\n      \"require\": \"./dist/node/definition.cjs\",\n      \"types\": \"./dist/node/definition.d.ts\"\n    },\n    \"./dynamic-feature\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/dynamic-feature.d.mts\",\n        \"import\": \"./dist/browser/dynamic-feature.mjs\"\n      },\n      \"import\": \"./dist/node/dynamic-feature.mjs\",\n      \"require\": \"./dist/node/dynamic-feature.cjs\",\n      \"types\": \"./dist/node/dynamic-feature.d.ts\"\n    },\n    \"./dynamic-structure\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/dynamic-structure.d.mts\",\n        \"import\": \"./dist/browser/dynamic-structure.mjs\"\n      },\n      \"import\": \"./dist/node/dynamic-structure.mjs\",\n      \"require\": \"./dist/node/dynamic-structure.cjs\",\n      \"types\": \"./dist/node/dynamic-structure.d.ts\"\n    },\n    \"./env\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/env.d.mts\",\n        \"import\": \"./dist/browser/env.mjs\"\n      },\n      \"import\": \"./dist/node/env.mjs\",\n      \"require\": \"./dist/node/env.cjs\",\n      \"types\": \"./dist/node/env.d.ts\"\n    },\n    \"./index\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/frame-index.d.mts\",\n        \"import\": \"./dist/browser/frame-index.mjs\"\n      },\n      \"import\": \"./dist/node/frame-index.mjs\",\n      \"require\": \"./dist/node/frame-index.cjs\",\n      \"types\": \"./dist/node/frame-index.d.ts\"\n    },\n    \"./logger\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/logger.d.mts\",\n        \"import\": \"./dist/browser/logger.mjs\"\n      },\n      \"import\": \"./dist/node/logger.mjs\",\n      \"require\": \"./dist/node/logger.cjs\",\n      \"types\": \"./dist/node/logger.d.ts\"\n    },\n    \"./namespace\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/namespace.d.mts\",\n        \"import\": \"./dist/browser/namespace.mjs\"\n      },\n      \"import\": \"./dist/node/namespace.mjs\",\n      \"require\": \"./dist/node/namespace.cjs\",\n      \"types\": \"./dist/node/namespace.d.ts\"\n    },\n    \"./storage\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/storage.d.mts\",\n        \"import\": \"./dist/browser/storage.mjs\"\n      },\n      \"import\": \"./dist/node/storage.mjs\",\n      \"require\": \"./dist/node/storage.cjs\",\n      \"types\": \"./dist/node/storage.d.ts\"\n    },\n    \"./vector\": {\n      \"browser\": {\n        \"types\": \"./dist/browser/vector.d.mts\",\n        \"import\": \"./dist/browser/vector.mjs\"\n      },\n      \"import\": \"./dist/node/vector.mjs\",\n      \"require\": \"./dist/node/vector.cjs\",\n      \"types\": \"./dist/node/vector.d.ts\"\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.14\"\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"]}