@adaas/a-frame 0.1.1 → 0.1.2

package/dist/node/bundle.cjs

@@ -1,7 +1,8 @@
 'use strict';
 
-var chunkQFUZVN4Y_cjs = require('./chunk-QFUZVN4Y.cjs');
-var chunkR2H234YO_cjs = require('./chunk-R2H234YO.cjs');
+var chunk3SLICJ3L_cjs = require('./chunk-3SLICJ3L.cjs');
+var chunkYVX4W6SI_cjs = require('./chunk-YVX4W6SI.cjs');
+var chunkHELNAM5Y_cjs = require('./chunk-HELNAM5Y.cjs');
 require('./chunk-QFHZIG7Y.cjs');
 var fs = require('fs/promises');
 var path = require('path');
@@ -29,44 +30,88 @@ var fs__namespace = /*#__PURE__*/_interopNamespace(fs);
 var path__namespace = /*#__PURE__*/_interopNamespace(path);
 
 // src/lib/A-FrameBundle/A-FrameBundle.constants.ts
-var A_FRAME_BUNDLE_VERSION = 1;
+var A_FRAME_BUNDLE_VERSION = 2;
 var A_FRAME_BUNDLE_DEFAULT_FILENAME = "a-frame-bundle.json";
 
 // src/lib/A-FrameBundle/A-FrameBundle.builder.env-node.ts
 var A_FrameBundleBuilder = class extends aConcept.A_Component {
-  /** Read all `.aframe` files from a storage directory and serialise them. */
+  constructor() {
+    super(...arguments);
+    this.codec = new chunk3SLICJ3L_cjs.A_FrameStorageCodec();
+  }
+  /** Read, decrypt and decode all `.aframe` files from a storage directory. */
   async build(opts) {
-    const ext = chunkQFUZVN4Y_cjs.A_FrameStorageCodec.fileExtension;
-    const namespacesFile = `__namespaces${ext}`;
+    const storageDir = opts.storageDir ?? ".aframe";
+    const namespacesFile = this.codec.getNamespaceFileName();
+    const defSuffix = `.definitions${chunk3SLICJ3L_cjs.A_FrameStorageCodec.fileExtension}`;
     let entries;
     try {
-      entries = await fs__namespace.readdir(opts.storageDir);
+      entries = await fs__namespace.readdir(storageDir);
     } catch (err) {
       if (err?.code === "ENOENT") {
-        throw new Error(`A-Frame storage directory not found: ${opts.storageDir}`);
+        throw new Error(`A-Frame storage directory not found: ${path__namespace.resolve(storageDir)}`);
       }
       throw err;
     }
-    const aframeFiles = entries.filter((f) => f.endsWith(ext));
-    let namespaces = null;
-    const definitions = {};
+    const aframeFiles = entries.filter((f) => f === namespacesFile || f.endsWith(defSuffix));
+    const records = {};
+    const namespaceRecords = [];
     for (const file of aframeFiles) {
-      const buf = await fs__namespace.readFile(path__namespace.join(opts.storageDir, file));
-      const b64 = buf.toString("base64");
+      const raw = await fs__namespace.readFile(path__namespace.join(storageDir, file));
+      let plain;
+      try {
+        plain = await chunkYVX4W6SI_cjs.A_FrameCrypto.decryptBytes(new Uint8Array(raw), opts.encryptionKey);
+      } catch {
+        throw new Error(
+          `Failed to decrypt "${file}". Ensure encryptionKey matches the key used when the files were written.`
+        );
+      }
       if (file === namespacesFile) {
-        namespaces = b64;
+        const decoded = this.codec.decodeNamespacePayload(plain);
+        for (const r of decoded) {
+          namespaceRecords.push({
+            aseid: r.aseid,
+            hash: r.hash,
+            name: r.name,
+            description: r.description,
+            metadata: r.metadata,
+            embedding: Array.from(r.embedding ?? []),
+            embeddedAt: r.embeddedAt,
+            embeddingModel: r.embeddingModel,
+            credentialId: r.credentialId,
+            aFrameVersion: r.aFrameVersion,
+            aFrameServerVersion: r.aFrameServerVersion
+          });
+        }
       } else {
-        const id = file.slice(0, -ext.length);
-        definitions[id] = b64;
+        const namespaceId = file.slice(0, -defSuffix.length);
+        const decoded = this.codec.decodePayload(plain);
+        records[namespaceId] = decoded.map((r) => ({
+          aseid: r.aseid,
+          name: r.name,
+          hash: r.hash,
+          type: r.type,
+          source: r.source,
+          description: r.description,
+          metadata: r.metadata,
+          namespace: r.namespace,
+          embedding: Array.from(r.embedding ?? []),
+          date: r.date,
+          model: r.model,
+          credentialId: r.credentialId,
+          aFrameVersion: r.aFrameVersion,
+          aFrameServerVersion: r.aFrameServerVersion,
+          aFrameMeta: r.aFrameMeta
+        }));
       }
     }
     return {
       bundleVersion: A_FRAME_BUNDLE_VERSION,
-      aFrameVersion: chunkR2H234YO_cjs.version || "0.0.0",
+      aFrameVersion: chunkHELNAM5Y_cjs.version || "0.0.0",
       serverVersion: opts.serverVersion,
       builtAt: (/* @__PURE__ */ new Date()).toISOString(),
-      namespaces,
-      definitions
+      records,
+      namespaceRecords
     };
   }
   /** Write the bundle to disk as a JSON file. */
@@ -76,11 +121,11 @@ var A_FrameBundleBuilder = class extends aConcept.A_Component {
   }
   /**
    * Emit a TypeScript module that exports the bundle as a typed constant.
-   * Useful for bundlers that prefer TS imports over JSON imports.
+   * Ideal for Vite/Webpack/esbuild projects that tree-shake TS imports.
    */
   async writeTS(bundle, outFile) {
     const banner = "// AUTO-GENERATED by @adaas/a-frame \u2014 do not edit.\n";
-    const body = `import type { A_FrameBundle } from '@adaas/a-frame';
+    const body = `import type { A_FrameBundle } from '@adaas/a-frame/bundle';
 
 export const A_FRAME_BUNDLE: A_FrameBundle = ${JSON.stringify(bundle, null, 2)} as A_FrameBundle;
 `;

package/dist/node/bundle.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/A-FrameBundle/A-FrameBundle.constants.ts","../../src/lib/A-FrameBundle/A-FrameBundle.builder.env-node.ts"],"names":["A_Component","A_FrameStorageCodec","fs","path","version"],"mappings":"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","file":"bundle.cjs","sourcesContent":["/** Current bundle format revision. Bumped on incompatible structural changes. */\nexport const A_FRAME_BUNDLE_VERSION = 1;\n\n/** Default file name when none is provided to the CLI. */\nexport const A_FRAME_BUNDLE_DEFAULT_FILENAME = 'a-frame-bundle.json';\n","import * as fs from 'node:fs/promises';\nimport * as path from 'node:path';\nimport { A_Component } from '@adaas/a-concept';\nimport { A_FrameBundle } from './A-FrameBundle.types';\nimport { A_FRAME_BUNDLE_VERSION } from './A-FrameBundle.constants';\nimport { A_FrameStorageCodec } from '../A-FrameStorage/A-FrameStorage.codec';\nimport * as pkg from '../../../package.json';\n\n\nexport interface A_FrameBundleBuilderOptions {\n    /** Source directory containing the encrypted `*.aframe` files (Node storage). */\n    storageDir: string;\n    /** Server version to embed in the bundle metadata. */\n    serverVersion: string;\n}\n\n\n/**\n * A_FrameBundleBuilder — Node-only build-time helper.\n *\n * Reads the encrypted `*.aframe` files produced by Node storage and packages\n * them into a single JSON (or generated TypeScript module) artifact that ships\n * with the browser bundle. The browser bootstrap then seeds these blobs into\n * `A_FrameBrowserStorageBlobs` so that read-only `definition.load()` /\n * `namespace.load()` calls work without a filesystem.\n */\nexport class A_FrameBundleBuilder extends A_Component {\n\n    /** Read all `.aframe` files from a storage directory and serialise them. */\n    async build(opts: A_FrameBundleBuilderOptions): Promise<A_FrameBundle> {\n        const ext = A_FrameStorageCodec.fileExtension; // \".aframe\"\n        const namespacesFile = `__namespaces${ext}`;\n\n        let entries: string[];\n        try {\n            entries = await fs.readdir(opts.storageDir);\n        } catch (err: any) {\n            if (err?.code === 'ENOENT') {\n                throw new Error(`A-Frame storage directory not found: ${opts.storageDir}`);\n            }\n            throw err;\n        }\n\n        const aframeFiles = entries.filter(f => f.endsWith(ext));\n\n        let namespaces: string | null = null;\n        const definitions: Record<string, string> = {};\n\n        for (const file of aframeFiles) {\n            const buf = await fs.readFile(path.join(opts.storageDir, file));\n            const b64 = buf.toString('base64');\n\n            if (file === namespacesFile) {\n                namespaces = b64;\n            } else {\n                const id = file.slice(0, -ext.length);\n                definitions[id] = b64;\n            }\n        }\n\n        return {\n            bundleVersion: A_FRAME_BUNDLE_VERSION,\n            aFrameVersion: (pkg as any).version || '0.0.0',\n            serverVersion: opts.serverVersion,\n            builtAt: new Date().toISOString(),\n            namespaces,\n            definitions,\n        };\n    }\n\n    /** Write the bundle to disk as a JSON file. */\n    async writeJSON(bundle: A_FrameBundle, outFile: string): Promise<void> {\n        await fs.mkdir(path.dirname(path.resolve(outFile)), { recursive: true });\n        await fs.writeFile(outFile, JSON.stringify(bundle, null, 2));\n    }\n\n    /**\n     * Emit a TypeScript module that exports the bundle as a typed constant.\n     * Useful for bundlers that prefer TS imports over JSON imports.\n     */\n    async writeTS(bundle: A_FrameBundle, outFile: string): Promise<void> {\n        const banner = '// AUTO-GENERATED by @adaas/a-frame — do not edit.\\n';\n        const body =\n            `import type { A_FrameBundle } from '@adaas/a-frame';\\n\\n` +\n            `export const A_FRAME_BUNDLE: A_FrameBundle = ${JSON.stringify(bundle, null, 2)} as A_FrameBundle;\\n`;\n        await fs.mkdir(path.dirname(path.resolve(outFile)), { recursive: true });\n        await fs.writeFile(outFile, banner + body);\n    }\n\n    /** Convenience: detect output format by extension and write. */\n    async writeAuto(bundle: A_FrameBundle, outFile: string): Promise<void> {\n        if (/\\.tsx?$/.test(outFile)) return this.writeTS(bundle, outFile);\n        return this.writeJSON(bundle, outFile);\n    }\n}\n"]}
+{"version":3,"sources":["../../src/lib/A-FrameBundle/A-FrameBundle.constants.ts","../../src/lib/A-FrameBundle/A-FrameBundle.builder.env-node.ts"],"names":["A_Component","A_FrameStorageCodec","fs","path","A_FrameCrypto","version"],"mappings":"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","file":"bundle.cjs","sourcesContent":["/** Current bundle format revision. Bumped on incompatible structural changes. */\nexport const A_FRAME_BUNDLE_VERSION = 2;\n\n/** Default file name when none is provided to the CLI. */\nexport const A_FRAME_BUNDLE_DEFAULT_FILENAME = 'a-frame-bundle.json';\n","import * as fs from 'node:fs/promises';\nimport * as path from 'node:path';\nimport { A_Component } from '@adaas/a-concept';\nimport { A_FrameBundle, A_FrameBundleDefinitionRecord, A_FrameBundleNamespaceRecord } from './A-FrameBundle.types';\nimport { A_FRAME_BUNDLE_VERSION } from './A-FrameBundle.constants';\nimport { A_FrameStorageCodec } from '../A-FrameStorage/A-FrameStorage.codec';\nimport { A_FrameCrypto } from '../A-FrameCrypto/A-FrameCrypto.component.env-node';\nimport * as pkg from '../../../package.json';\n\n\nexport interface A_FrameBundleBuilderOptions {\n    /**\n     * Source directory containing the encrypted `*.aframe` files (Node storage).\n     * Defaults to `.aframe/` in the current working directory.\n     */\n    storageDir?: string;\n    /** Server version to embed in the bundle metadata. */\n    serverVersion: string;\n    /**\n     * AES-256-GCM encryption key used when the `.aframe` files were written.\n     * This is the `encryptionKey` returned by the A-Frame server credentials API.\n     * Required so the builder can decrypt the files and produce plain-JSON records.\n     */\n    encryptionKey: string;\n}\n\n\n/**\n * A_FrameBundleBuilder — Node-only build-time helper.\n *\n * Reads the encrypted `*.aframe` files produced by Node storage, decrypts them\n * with the provided key, and packages the decoded definition/namespace records\n * into a single JSON artifact that ships with the browser bundle.\n *\n * The output bundle stores plain records (no encryption). The browser bootstrap\n * seeds these directly into `A_FrameBrowserStorageBlobs` so that definitions\n * load without any server connection or encryption key.\n *\n * Usage:\n * ```ts\n * import { A_FrameBundleBuilder } from '@adaas/a-frame/bundle';\n *\n * const builder = new A_FrameBundleBuilder();\n * const bundle = await builder.build({\n *   storageDir: '.aframe',\n *   serverVersion: '1.0.0',\n *   encryptionKey: process.env.A_FRAME_ENCRYPTION_KEY!,\n * });\n * await builder.writeAuto(bundle, 'src/generated/a-frame-bundle.ts');\n * ```\n */\nexport class A_FrameBundleBuilder extends A_Component {\n\n    private codec = new A_FrameStorageCodec();\n\n    /** Read, decrypt and decode all `.aframe` files from a storage directory. */\n    async build(opts: A_FrameBundleBuilderOptions): Promise<A_FrameBundle> {\n        const storageDir = opts.storageDir ?? '.aframe';\n        const namespacesFile = this.codec.getNamespaceFileName();   // '.namespaces.aframe'\n        const defSuffix = `.definitions${A_FrameStorageCodec.fileExtension}`; // '.definitions.aframe'\n\n        let entries: string[];\n        try {\n            entries = await fs.readdir(storageDir);\n        } catch (err: any) {\n            if (err?.code === 'ENOENT') {\n                throw new Error(`A-Frame storage directory not found: ${path.resolve(storageDir)}`);\n            }\n            throw err;\n        }\n\n        // Accept both the namespace index and definition files\n        const aframeFiles = entries.filter(f => f === namespacesFile || f.endsWith(defSuffix));\n\n        const records: Record<string, A_FrameBundleDefinitionRecord[]> = {};\n        const namespaceRecords: A_FrameBundleNamespaceRecord[] = [];\n\n        for (const file of aframeFiles) {\n            const raw = await fs.readFile(path.join(storageDir, file));\n            let plain: Uint8Array;\n            try {\n                plain = await A_FrameCrypto.decryptBytes(new Uint8Array(raw), opts.encryptionKey);\n            } catch {\n                throw new Error(\n                    `Failed to decrypt \"${file}\". Ensure encryptionKey matches the key used when the files were written.`\n                );\n            }\n\n            if (file === namespacesFile) {\n                const decoded = this.codec.decodeNamespacePayload(plain);\n                for (const r of decoded) {\n                    namespaceRecords.push({\n                        aseid: r.aseid,\n                        hash: r.hash,\n                        name: r.name,\n                        description: r.description,\n                        metadata: r.metadata,\n                        embedding: Array.from(r.embedding ?? []),\n                        embeddedAt: r.embeddedAt,\n                        embeddingModel: r.embeddingModel,\n                        credentialId: r.credentialId,\n                        aFrameVersion: r.aFrameVersion,\n                        aFrameServerVersion: r.aFrameServerVersion,\n                    });\n                }\n            } else {\n                // Strip '.definitions.aframe' suffix to recover the namespace id\n                const namespaceId = file.slice(0, -defSuffix.length);\n                const decoded = this.codec.decodePayload(plain);\n                records[namespaceId] = decoded.map(r => ({\n                    aseid: r.aseid,\n                    name: r.name,\n                    hash: r.hash,\n                    type: r.type,\n                    source: r.source,\n                    description: r.description,\n                    metadata: r.metadata,\n                    namespace: r.namespace,\n                    embedding: Array.from(r.embedding ?? []),\n                    date: r.date,\n                    model: r.model,\n                    credentialId: r.credentialId,\n                    aFrameVersion: r.aFrameVersion,\n                    aFrameServerVersion: r.aFrameServerVersion,\n                    aFrameMeta: r.aFrameMeta,\n                }));\n            }\n        }\n\n        return {\n            bundleVersion: A_FRAME_BUNDLE_VERSION,\n            aFrameVersion: (pkg as any).version || '0.0.0',\n            serverVersion: opts.serverVersion,\n            builtAt: new Date().toISOString(),\n            records,\n            namespaceRecords,\n        };\n    }\n\n    /** Write the bundle to disk as a JSON file. */\n    async writeJSON(bundle: A_FrameBundle, outFile: string): Promise<void> {\n        await fs.mkdir(path.dirname(path.resolve(outFile)), { recursive: true });\n        await fs.writeFile(outFile, JSON.stringify(bundle, null, 2));\n    }\n\n    /**\n     * Emit a TypeScript module that exports the bundle as a typed constant.\n     * Ideal for Vite/Webpack/esbuild projects that tree-shake TS imports.\n     */\n    async writeTS(bundle: A_FrameBundle, outFile: string): Promise<void> {\n        const banner = '// AUTO-GENERATED by @adaas/a-frame — do not edit.\\n';\n        const body =\n            `import type { A_FrameBundle } from '@adaas/a-frame/bundle';\\n\\n` +\n            `export const A_FRAME_BUNDLE: A_FrameBundle = ${JSON.stringify(bundle, null, 2)} as A_FrameBundle;\\n`;\n        await fs.mkdir(path.dirname(path.resolve(outFile)), { recursive: true });\n        await fs.writeFile(outFile, banner + body);\n    }\n\n    /** Convenience: detect output format by extension and write. */\n    async writeAuto(bundle: A_FrameBundle, outFile: string): Promise<void> {\n        if (/\\.tsx?$/.test(outFile)) return this.writeTS(bundle, outFile);\n        return this.writeJSON(bundle, outFile);\n    }\n}\n\n"]}

package/dist/node/bundle.d.mts

@@ -1,18 +1,58 @@
 import { A_Component } from '@adaas/a-concept';
+import { c as A_FrameTargetType, D as DefinitionExtractedMeta } from './A-FrameDefinition.types-BT02yAhQ.mjs';
+import './A-FrameNamespace.entity-BDg1FUgo.mjs';
+import './vector.mjs';
 
+/**
+ * JSON-serializable definition record (embedding stored as number[] instead of Float32Array).
+ */
+interface A_FrameBundleDefinitionRecord {
+    aseid: string;
+    name: string;
+    hash: string;
+    type: A_FrameTargetType;
+    source?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    namespace: string;
+    /** Float32 embedding serialized as a plain number array. */
+    embedding: number[];
+    date: string;
+    model: string;
+    credentialId: string;
+    aFrameVersion: string;
+    aFrameServerVersion: string;
+    aFrameMeta?: DefinitionExtractedMeta;
+}
+/**
+ * JSON-serializable namespace record (embedding as number[]).
+ */
+interface A_FrameBundleNamespaceRecord {
+    aseid: string;
+    hash: string;
+    name: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    /** Float32 embedding serialized as a plain number array. */
+    embedding: number[];
+    embeddedAt: number;
+    embeddingModel?: string;
+    credentialId?: string;
+    aFrameVersion?: string;
+    aFrameServerVersion?: string;
+}
 /**
  * Serialized A-Frame bundle artifact.
  *
- * Built by `A_FrameBundleBuilder` from a Node storage directory at build time
- * (see CLI `--bundle <out>`). Loaded by `A_FrameBrowserStorageBlobs.seedFromBundle()`
- * at app startup in the browser.
+ * Built by `A_FrameBundleBuilder` from a Node storage directory at build time.
+ * Loaded by `A_FrameBrowserStorageBlobs.seedFromBundle()` at app startup in the
+ * browser — no server connection or encryption key required at runtime.
  *
- * Storage blobs are kept in their AES-256-GCM encrypted form — the consuming
- * browser app must obtain the encryption key out-of-band (typically by
- * authenticating against the A-Frame server with the user's token).
+ * The bundle stores decoded definition and namespace records in plain JSON so
+ * that the browser can hydrate embeddings without calling the A-Frame server.
  */
 interface A_FrameBundle {
-    /** Bundle format version. Currently 1. */
+    /** Bundle format version. Currently 2. */
     bundleVersion: number;
     /** A-Frame client library version that produced the bundle. */
     aFrameVersion: string;
@@ -21,40 +61,64 @@ interface A_FrameBundle {
     /** Build timestamp (ISO 8601). */
     builtAt: string;
     /**
-     * Base64-encoded contents of the `__namespaces.aframe` index file.
-     * `null` when no namespaces have been persisted yet.
+     * Decoded definition records grouped by namespace id.
+     * The `embedding` field contains the raw Float32 values as a plain number[].
      */
-    namespaces: string | null;
+    records: Record<string, A_FrameBundleDefinitionRecord[]>;
     /**
-     * Map of namespace id (file basename without extension) → base64-encoded
-     * contents of the corresponding `<namespace>.aframe` file.
+     * Decoded namespace records (from `__namespaces.aframe`).
      */
-    definitions: Record<string, string>;
+    namespaceRecords: A_FrameBundleNamespaceRecord[];
 }
 
 interface A_FrameBundleBuilderOptions {
-    /** Source directory containing the encrypted `*.aframe` files (Node storage). */
-    storageDir: string;
+    /**
+     * Source directory containing the encrypted `*.aframe` files (Node storage).
+     * Defaults to `.aframe/` in the current working directory.
+     */
+    storageDir?: string;
     /** Server version to embed in the bundle metadata. */
     serverVersion: string;
+    /**
+     * AES-256-GCM encryption key used when the `.aframe` files were written.
+     * This is the `encryptionKey` returned by the A-Frame server credentials API.
+     * Required so the builder can decrypt the files and produce plain-JSON records.
+     */
+    encryptionKey: string;
 }
 /**
  * A_FrameBundleBuilder — Node-only build-time helper.
  *
- * Reads the encrypted `*.aframe` files produced by Node storage and packages
- * them into a single JSON (or generated TypeScript module) artifact that ships
- * with the browser bundle. The browser bootstrap then seeds these blobs into
- * `A_FrameBrowserStorageBlobs` so that read-only `definition.load()` /
- * `namespace.load()` calls work without a filesystem.
+ * Reads the encrypted `*.aframe` files produced by Node storage, decrypts them
+ * with the provided key, and packages the decoded definition/namespace records
+ * into a single JSON artifact that ships with the browser bundle.
+ *
+ * The output bundle stores plain records (no encryption). The browser bootstrap
+ * seeds these directly into `A_FrameBrowserStorageBlobs` so that definitions
+ * load without any server connection or encryption key.
+ *
+ * Usage:
+ * ```ts
+ * import { A_FrameBundleBuilder } from '@adaas/a-frame/bundle';
+ *
+ * const builder = new A_FrameBundleBuilder();
+ * const bundle = await builder.build({
+ *   storageDir: '.aframe',
+ *   serverVersion: '1.0.0',
+ *   encryptionKey: process.env.A_FRAME_ENCRYPTION_KEY!,
+ * });
+ * await builder.writeAuto(bundle, 'src/generated/a-frame-bundle.ts');
+ * ```
  */
 declare class A_FrameBundleBuilder extends A_Component {
-    /** Read all `.aframe` files from a storage directory and serialise them. */
+    private codec;
+    /** Read, decrypt and decode all `.aframe` files from a storage directory. */
     build(opts: A_FrameBundleBuilderOptions): Promise<A_FrameBundle>;
     /** Write the bundle to disk as a JSON file. */
     writeJSON(bundle: A_FrameBundle, outFile: string): Promise<void>;
     /**
      * Emit a TypeScript module that exports the bundle as a typed constant.
-     * Useful for bundlers that prefer TS imports over JSON imports.
+     * Ideal for Vite/Webpack/esbuild projects that tree-shake TS imports.
      */
     writeTS(bundle: A_FrameBundle, outFile: string): Promise<void>;
     /** Convenience: detect output format by extension and write. */
@@ -62,8 +126,8 @@ declare class A_FrameBundleBuilder extends A_Component {
 }
 
 /** Current bundle format revision. Bumped on incompatible structural changes. */
-declare const A_FRAME_BUNDLE_VERSION = 1;
+declare const A_FRAME_BUNDLE_VERSION = 2;
 /** Default file name when none is provided to the CLI. */
 declare const A_FRAME_BUNDLE_DEFAULT_FILENAME = "a-frame-bundle.json";
 
-export { A_FRAME_BUNDLE_DEFAULT_FILENAME, A_FRAME_BUNDLE_VERSION, type A_FrameBundle, A_FrameBundleBuilder, type A_FrameBundleBuilderOptions };
+export { A_FRAME_BUNDLE_DEFAULT_FILENAME, A_FRAME_BUNDLE_VERSION, type A_FrameBundle, A_FrameBundleBuilder, type A_FrameBundleBuilderOptions, type A_FrameBundleDefinitionRecord, type A_FrameBundleNamespaceRecord };

package/dist/node/bundle.d.ts

@@ -1,18 +1,58 @@
 import { A_Component } from '@adaas/a-concept';
+import { c as A_FrameTargetType, D as DefinitionExtractedMeta } from './A-FrameDefinition.types-BA_pLGpo.js';
+import './A-FrameNamespace.entity-HDXcLGcS.js';
+import './vector.js';
 
+/**
+ * JSON-serializable definition record (embedding stored as number[] instead of Float32Array).
+ */
+interface A_FrameBundleDefinitionRecord {
+    aseid: string;
+    name: string;
+    hash: string;
+    type: A_FrameTargetType;
+    source?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    namespace: string;
+    /** Float32 embedding serialized as a plain number array. */
+    embedding: number[];
+    date: string;
+    model: string;
+    credentialId: string;
+    aFrameVersion: string;
+    aFrameServerVersion: string;
+    aFrameMeta?: DefinitionExtractedMeta;
+}
+/**
+ * JSON-serializable namespace record (embedding as number[]).
+ */
+interface A_FrameBundleNamespaceRecord {
+    aseid: string;
+    hash: string;
+    name: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    /** Float32 embedding serialized as a plain number array. */
+    embedding: number[];
+    embeddedAt: number;
+    embeddingModel?: string;
+    credentialId?: string;
+    aFrameVersion?: string;
+    aFrameServerVersion?: string;
+}
 /**
  * Serialized A-Frame bundle artifact.
  *
- * Built by `A_FrameBundleBuilder` from a Node storage directory at build time
- * (see CLI `--bundle <out>`). Loaded by `A_FrameBrowserStorageBlobs.seedFromBundle()`
- * at app startup in the browser.
+ * Built by `A_FrameBundleBuilder` from a Node storage directory at build time.
+ * Loaded by `A_FrameBrowserStorageBlobs.seedFromBundle()` at app startup in the
+ * browser — no server connection or encryption key required at runtime.
  *
- * Storage blobs are kept in their AES-256-GCM encrypted form — the consuming
- * browser app must obtain the encryption key out-of-band (typically by
- * authenticating against the A-Frame server with the user's token).
+ * The bundle stores decoded definition and namespace records in plain JSON so
+ * that the browser can hydrate embeddings without calling the A-Frame server.
  */
 interface A_FrameBundle {
-    /** Bundle format version. Currently 1. */
+    /** Bundle format version. Currently 2. */
     bundleVersion: number;
     /** A-Frame client library version that produced the bundle. */
     aFrameVersion: string;
@@ -21,40 +61,64 @@ interface A_FrameBundle {
     /** Build timestamp (ISO 8601). */
     builtAt: string;
     /**
-     * Base64-encoded contents of the `__namespaces.aframe` index file.
-     * `null` when no namespaces have been persisted yet.
+     * Decoded definition records grouped by namespace id.
+     * The `embedding` field contains the raw Float32 values as a plain number[].
      */
-    namespaces: string | null;
+    records: Record<string, A_FrameBundleDefinitionRecord[]>;
     /**
-     * Map of namespace id (file basename without extension) → base64-encoded
-     * contents of the corresponding `<namespace>.aframe` file.
+     * Decoded namespace records (from `__namespaces.aframe`).
      */
-    definitions: Record<string, string>;
+    namespaceRecords: A_FrameBundleNamespaceRecord[];
 }
 
 interface A_FrameBundleBuilderOptions {
-    /** Source directory containing the encrypted `*.aframe` files (Node storage). */
-    storageDir: string;
+    /**
+     * Source directory containing the encrypted `*.aframe` files (Node storage).
+     * Defaults to `.aframe/` in the current working directory.
+     */
+    storageDir?: string;
     /** Server version to embed in the bundle metadata. */
     serverVersion: string;
+    /**
+     * AES-256-GCM encryption key used when the `.aframe` files were written.
+     * This is the `encryptionKey` returned by the A-Frame server credentials API.
+     * Required so the builder can decrypt the files and produce plain-JSON records.
+     */
+    encryptionKey: string;
 }
 /**
  * A_FrameBundleBuilder — Node-only build-time helper.
  *
- * Reads the encrypted `*.aframe` files produced by Node storage and packages
- * them into a single JSON (or generated TypeScript module) artifact that ships
- * with the browser bundle. The browser bootstrap then seeds these blobs into
- * `A_FrameBrowserStorageBlobs` so that read-only `definition.load()` /
- * `namespace.load()` calls work without a filesystem.
+ * Reads the encrypted `*.aframe` files produced by Node storage, decrypts them
+ * with the provided key, and packages the decoded definition/namespace records
+ * into a single JSON artifact that ships with the browser bundle.
+ *
+ * The output bundle stores plain records (no encryption). The browser bootstrap
+ * seeds these directly into `A_FrameBrowserStorageBlobs` so that definitions
+ * load without any server connection or encryption key.
+ *
+ * Usage:
+ * ```ts
+ * import { A_FrameBundleBuilder } from '@adaas/a-frame/bundle';
+ *
+ * const builder = new A_FrameBundleBuilder();
+ * const bundle = await builder.build({
+ *   storageDir: '.aframe',
+ *   serverVersion: '1.0.0',
+ *   encryptionKey: process.env.A_FRAME_ENCRYPTION_KEY!,
+ * });
+ * await builder.writeAuto(bundle, 'src/generated/a-frame-bundle.ts');
+ * ```
  */
 declare class A_FrameBundleBuilder extends A_Component {
-    /** Read all `.aframe` files from a storage directory and serialise them. */
+    private codec;
+    /** Read, decrypt and decode all `.aframe` files from a storage directory. */
     build(opts: A_FrameBundleBuilderOptions): Promise<A_FrameBundle>;
     /** Write the bundle to disk as a JSON file. */
     writeJSON(bundle: A_FrameBundle, outFile: string): Promise<void>;
     /**
      * Emit a TypeScript module that exports the bundle as a typed constant.
-     * Useful for bundlers that prefer TS imports over JSON imports.
+     * Ideal for Vite/Webpack/esbuild projects that tree-shake TS imports.
      */
     writeTS(bundle: A_FrameBundle, outFile: string): Promise<void>;
     /** Convenience: detect output format by extension and write. */
@@ -62,8 +126,8 @@ declare class A_FrameBundleBuilder extends A_Component {
 }
 
 /** Current bundle format revision. Bumped on incompatible structural changes. */
-declare const A_FRAME_BUNDLE_VERSION = 1;
+declare const A_FRAME_BUNDLE_VERSION = 2;
 /** Default file name when none is provided to the CLI. */
 declare const A_FRAME_BUNDLE_DEFAULT_FILENAME = "a-frame-bundle.json";
 
-export { A_FRAME_BUNDLE_DEFAULT_FILENAME, A_FRAME_BUNDLE_VERSION, type A_FrameBundle, A_FrameBundleBuilder, type A_FrameBundleBuilderOptions };
+export { A_FRAME_BUNDLE_DEFAULT_FILENAME, A_FRAME_BUNDLE_VERSION, type A_FrameBundle, A_FrameBundleBuilder, type A_FrameBundleBuilderOptions, type A_FrameBundleDefinitionRecord, type A_FrameBundleNamespaceRecord };

package/dist/node/bundle.mjs

@@ -1,40 +1,85 @@
-import { A_FrameStorageCodec } from './chunk-3ONWH75E.mjs';
-import { version } from './chunk-OYC6L5NX.mjs';
+import { A_FrameStorageCodec } from './chunk-OYZAQMKD.mjs';
+import { A_FrameCrypto } from './chunk-UPA7VN4R.mjs';
+import { version } from './chunk-SKIEPTFS.mjs';
 import './chunk-OI76LHVT.mjs';
 import * as fs from 'fs/promises';
 import * as path from 'path';
 import { A_Component } from '@adaas/a-concept';
 
 // src/lib/A-FrameBundle/A-FrameBundle.constants.ts
-var A_FRAME_BUNDLE_VERSION = 1;
+var A_FRAME_BUNDLE_VERSION = 2;
 var A_FRAME_BUNDLE_DEFAULT_FILENAME = "a-frame-bundle.json";
 
 // src/lib/A-FrameBundle/A-FrameBundle.builder.env-node.ts
 var A_FrameBundleBuilder = class extends A_Component {
-  /** Read all `.aframe` files from a storage directory and serialise them. */
+  constructor() {
+    super(...arguments);
+    this.codec = new A_FrameStorageCodec();
+  }
+  /** Read, decrypt and decode all `.aframe` files from a storage directory. */
   async build(opts) {
-    const ext = A_FrameStorageCodec.fileExtension;
-    const namespacesFile = `__namespaces${ext}`;
+    const storageDir = opts.storageDir ?? ".aframe";
+    const namespacesFile = this.codec.getNamespaceFileName();
+    const defSuffix = `.definitions${A_FrameStorageCodec.fileExtension}`;
     let entries;
     try {
-      entries = await fs.readdir(opts.storageDir);
+      entries = await fs.readdir(storageDir);
     } catch (err) {
       if (err?.code === "ENOENT") {
-        throw new Error(`A-Frame storage directory not found: ${opts.storageDir}`);
+        throw new Error(`A-Frame storage directory not found: ${path.resolve(storageDir)}`);
       }
       throw err;
     }
-    const aframeFiles = entries.filter((f) => f.endsWith(ext));
-    let namespaces = null;
-    const definitions = {};
+    const aframeFiles = entries.filter((f) => f === namespacesFile || f.endsWith(defSuffix));
+    const records = {};
+    const namespaceRecords = [];
     for (const file of aframeFiles) {
-      const buf = await fs.readFile(path.join(opts.storageDir, file));
-      const b64 = buf.toString("base64");
+      const raw = await fs.readFile(path.join(storageDir, file));
+      let plain;
+      try {
+        plain = await A_FrameCrypto.decryptBytes(new Uint8Array(raw), opts.encryptionKey);
+      } catch {
+        throw new Error(
+          `Failed to decrypt "${file}". Ensure encryptionKey matches the key used when the files were written.`
+        );
+      }
       if (file === namespacesFile) {
-        namespaces = b64;
+        const decoded = this.codec.decodeNamespacePayload(plain);
+        for (const r of decoded) {
+          namespaceRecords.push({
+            aseid: r.aseid,
+            hash: r.hash,
+            name: r.name,
+            description: r.description,
+            metadata: r.metadata,
+            embedding: Array.from(r.embedding ?? []),
+            embeddedAt: r.embeddedAt,
+            embeddingModel: r.embeddingModel,
+            credentialId: r.credentialId,
+            aFrameVersion: r.aFrameVersion,
+            aFrameServerVersion: r.aFrameServerVersion
+          });
+        }
       } else {
-        const id = file.slice(0, -ext.length);
-        definitions[id] = b64;
+        const namespaceId = file.slice(0, -defSuffix.length);
+        const decoded = this.codec.decodePayload(plain);
+        records[namespaceId] = decoded.map((r) => ({
+          aseid: r.aseid,
+          name: r.name,
+          hash: r.hash,
+          type: r.type,
+          source: r.source,
+          description: r.description,
+          metadata: r.metadata,
+          namespace: r.namespace,
+          embedding: Array.from(r.embedding ?? []),
+          date: r.date,
+          model: r.model,
+          credentialId: r.credentialId,
+          aFrameVersion: r.aFrameVersion,
+          aFrameServerVersion: r.aFrameServerVersion,
+          aFrameMeta: r.aFrameMeta
+        }));
       }
     }
     return {
@@ -42,8 +87,8 @@ var A_FrameBundleBuilder = class extends A_Component {
       aFrameVersion: version || "0.0.0",
       serverVersion: opts.serverVersion,
       builtAt: (/* @__PURE__ */ new Date()).toISOString(),
-      namespaces,
-      definitions
+      records,
+      namespaceRecords
     };
   }
   /** Write the bundle to disk as a JSON file. */
@@ -53,11 +98,11 @@ var A_FrameBundleBuilder = class extends A_Component {
   }
   /**
    * Emit a TypeScript module that exports the bundle as a typed constant.
-   * Useful for bundlers that prefer TS imports over JSON imports.
+   * Ideal for Vite/Webpack/esbuild projects that tree-shake TS imports.
    */
   async writeTS(bundle, outFile) {
     const banner = "// AUTO-GENERATED by @adaas/a-frame \u2014 do not edit.\n";
-    const body = `import type { A_FrameBundle } from '@adaas/a-frame';
+    const body = `import type { A_FrameBundle } from '@adaas/a-frame/bundle';
 
 export const A_FRAME_BUNDLE: A_FrameBundle = ${JSON.stringify(bundle, null, 2)} as A_FrameBundle;
 `;