@adaas/a-frame 0.0.22 → 0.1.1

package/src/lib/A-FrameStorage/A-FrameStorage.codec.ts

@@ -0,0 +1,338 @@
+/**
+ * A-FrameStorage binary codec — shared between node and browser environments.
+ *
+ * Binary payload format (decrypted) — used for BOTH definition records and namespace records:
+ *   [HEADER 20B]
+ *     magic    4B = 0x454D424B ("EMBK")
+ *     version  1B = 0x01
+ *     count    4B (uint32 LE)
+ *     dims     2B (uint16 LE)
+ *     reserved 9B
+ *   [RECORD × count]
+ *     aseidLen 2B  (uint16 LE)
+ *     aseid    NB  utf-8  (primary entity ID, e.g. "app@root:123@v2")
+ *     nameLen  2B  (uint16 LE)
+ *     name     NB  utf-8
+ *     vector   dims×4B  Float32 LE
+ *     metaLen  4B  (uint32 LE)
+ *     meta     NB  JSON
+ */
+
+import { A_Fragment } from '@adaas/a-concept';
+
+import type { A_FrameNamespace_Serialized } from '../A-FrameNamespace/A-FrameNamespace.types';
+import { A_FrameDefinition_Serialized } from '../A-FrameDefinition/A-FrameDefinition.types';
+import { A_FrameTargetType } from '../A-Frame/A-Frame.types';
+
+const enc = new TextEncoder();
+const dec = new TextDecoder();
+
+
+export class A_FrameStorageCodec extends A_Fragment {
+
+    protected enc = new TextEncoder();
+    protected 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]
+    A_FRAME_FILE_MAGIC = 0x454d424b;
+    A_FRAME_FILE_VERSION = 0x01;
+    A_FRAME_HEADER_SIZE = 20;
+
+
+
+    static get fileExtension() {
+        return '.aframe';
+    }
+
+
+    getFileName(namespace: string) {
+        return `${namespace}${A_FrameStorageCodec.fileExtension}`;
+    }
+
+    getNamespaceFileName() {
+        return `__namespaces${A_FrameStorageCodec.fileExtension}`;
+    }
+
+
+    encodePayload(records: A_FrameDefinition_Serialized[]): Uint8Array {
+        const parts: Uint8Array[] = [];
+
+        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);
+        // bytes 11-19: reserved (zeroed)
+        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: Uint8Array): A_FrameDefinition_Serialized[] {
+        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: A_FrameDefinition_Serialized[] = [];
+        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) as {
+                hash?: string;
+                source: string;
+                description?: string;
+                type: A_FrameTargetType;
+                metadata?: Record<string, unknown>;
+                namespace: string;
+                date: string;
+                model: string;
+                credentialId: string;
+                aFrameVersion: string;
+                aFrameServerVersion: string;
+            };
+
+            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: A_FrameNamespace_Serialized[]): Uint8Array {
+        const parts: Uint8Array[] = [];
+
+        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: Uint8Array): A_FrameNamespace_Serialized[] {
+        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: A_FrameNamespace_Serialized[] = [];
+        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) as {
+                hash?: string;
+                description?: string;
+                metadata?: Record<string, unknown>;
+                embeddedAt: number;
+                embeddingModel?: string;
+                credentialId?: string;
+                aFrameVersion?: string;
+                aFrameServerVersion?: string;
+            };
+
+            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;
+    }
+
+}
+
+

package/src/lib/A-FrameStorage/A-FrameStorage.component.ts

@@ -0,0 +1,191 @@
+import { A_Component, A_Context, A_Scope } from '@adaas/a-concept';
+import { A_FrameNamespace_Serialized } from '../A-FrameNamespace/A-FrameNamespace.types';
+import { A_FrameStorageFeatures } from './A-FrameStorage.constants';
+import { A_FrameStorageOperation } from './A-FrameStorageOperation.context';
+import { A_FrameStorageError } from './A-FrameStorage.error';
+import { A_FrameStorageDestroyDefinitionsOperation, A_FrameStorageDestroyDefinitionsOperationParams, A_FrameStorageDestroyDefinitionsOperationResult, A_FrameStorageDestroyNamespacesOperation, A_FrameStorageDestroyNamespacesOperationParams, A_FrameStorageDestroyNamespacesOperationResult, A_FrameStorageLoadDefinitionsOperation, A_FrameStorageLoadDefinitionsOperationParams, A_FrameStorageLoadDefinitionsOperationResult, A_FrameStorageLoadNamespacesOperation, A_FrameStorageLoadNamespacesOperationParams, A_FrameStorageLoadNamespacesOperationResult, A_FrameStorageSaveDefinitionOperation, A_FrameStorageSaveDefinitionOperationParams, A_FrameStorageSaveDefinitionOperationResult, A_FrameStorageSaveNamespaceOperation, A_FrameStorageSaveNamespaceOperationParams, A_FrameStorageSaveNamespaceOperationResult } from './A-FrameStorage.types';
+import { A_FrameDefinition_Serialized } from '../A-FrameDefinition/A-FrameDefinition.types';
+
+
+export class A_FrameStorage extends A_Component {
+
+    async saveDefinitions(definitions: Array<A_FrameDefinition_Serialized>): Promise<A_FrameStorageSaveDefinitionOperation> {
+        const context = new A_FrameStorageOperation<A_FrameStorageSaveDefinitionOperationParams, A_FrameStorageSaveDefinitionOperationResult>({
+            records: definitions
+        });
+
+        const executionScope = new A_Scope({
+            name: 'A_FrameStorage.saveDefinitions',
+            fragments: [context]
+        })
+            .inherit(A_Context.scope(this));
+
+        try {
+            await this.call(A_FrameStorageFeatures.SaveDefinitions, executionScope);
+            executionScope.destroy();
+
+            return context;
+        } catch (error) {
+
+            context.fail(new A_FrameStorageError({
+                title: A_FrameStorageError.SaveDefinitionFailed,
+                description: `Failed to save definition records.`,
+            }));
+
+            executionScope.destroy();
+
+            return context;
+        }
+    }
+
+    async loadDefinitions(namespaceId: string, definitionId: string): Promise<A_FrameStorageLoadDefinitionsOperation> {
+        const context = new A_FrameStorageOperation<A_FrameStorageLoadDefinitionsOperationParams, A_FrameStorageLoadDefinitionsOperationResult>({
+            namespaceId,
+        });
+
+        const executionScope = new A_Scope({
+            name: 'A_FrameStorage.loadDefinitions',
+            fragments: [context]
+        })
+            .inherit(A_Context.scope(this));
+
+        try {
+            await this.call(A_FrameStorageFeatures.LoadDefinitions, executionScope);
+            executionScope.destroy();
+
+            return context;
+        } catch (error) {
+
+            context.fail(new A_FrameStorageError({
+                title: A_FrameStorageError.LoadDefinitionsFailed,
+                description: `Failed to load definition records.`,
+            }));
+
+            executionScope.destroy();
+
+            return context;
+        }
+    }
+
+
+    async destroyDefinitions(namespaceId: string, definitionId: string): Promise<A_FrameStorageDestroyDefinitionsOperation> {
+        const context = new A_FrameStorageOperation<A_FrameStorageDestroyDefinitionsOperationParams, A_FrameStorageDestroyDefinitionsOperationResult>({
+            namespaceId,
+            definitionId
+        });
+
+        const executionScope = new A_Scope({
+            name: 'A_FrameStorage.destroyDefinitions',
+            fragments: [context]
+        })
+            .inherit(A_Context.scope(this));
+
+        try {
+            await this.call(A_FrameStorageFeatures.DestroyDefinitions, executionScope);
+            executionScope.destroy();
+
+            return context;
+        } catch (error) {
+
+            context.fail(new A_FrameStorageError({
+                title: A_FrameStorageError.DestroyDefinitionsFailed,
+                description: `Failed to destroy definition records.`,
+            }));
+
+            executionScope.destroy();
+
+            return context;
+        }
+    }
+
+
+
+    async saveNamespaces(namespaces: A_FrameNamespace_Serialized[]): Promise<A_FrameStorageSaveNamespaceOperation> {
+        const context = new A_FrameStorageOperation<A_FrameStorageSaveNamespaceOperationParams, A_FrameStorageSaveNamespaceOperationResult>({
+            records: namespaces
+        });
+
+        const executionScope = new A_Scope({
+            name: 'A_FrameStorage.saveNamespaces',
+            fragments: [context]
+        })
+            .inherit(A_Context.scope(this));
+
+        try {
+            await this.call(A_FrameStorageFeatures.SaveNamespaces, executionScope);
+            executionScope.destroy();
+
+            return context;
+        } catch (error) {
+
+            context.fail(new A_FrameStorageError({
+                title: A_FrameStorageError.SaveNamespaceFailed,
+                description: `Failed to save namespace records.`,
+            }));
+
+            executionScope.destroy();
+
+            return context;
+        }
+    }
+
+    async loadNamespaces(
+        namespaceIds: string[]
+    ): Promise<A_FrameStorageLoadNamespacesOperation> {
+        const context = new A_FrameStorageOperation<A_FrameStorageLoadNamespacesOperationParams, A_FrameStorageLoadNamespacesOperationResult>({
+            namespaces: namespaceIds
+        });
+
+        const executionScope = new A_Scope({
+            name: 'A_FrameStorage.loadNamespaces',
+            fragments: [context]
+        })
+            .inherit(A_Context.scope(this));
+
+        try {
+            await this.call(A_FrameStorageFeatures.LoadNamespaces, executionScope);
+            executionScope.destroy();
+
+            return context;
+        } catch (error) {
+
+            context.fail(new A_FrameStorageError({
+                title: A_FrameStorageError.LoadNamespacesFailed,
+                description: `Failed to load namespace records.`,
+            }));
+
+            executionScope.destroy();
+
+            return context;
+        }
+    }
+
+    async destroyNamespaces(namespacesIds: string[]): Promise<A_FrameStorageDestroyNamespacesOperation> {
+        const context = new A_FrameStorageOperation<A_FrameStorageDestroyNamespacesOperationParams, A_FrameStorageDestroyNamespacesOperationResult>({
+            namespaces: namespacesIds
+        });
+
+        const executionScope = new A_Scope({
+            name: 'A_FrameStorage.destroyNamespaces',
+            fragments: [context]
+        })
+            .inherit(A_Context.scope(this));
+
+        try {
+            await this.call(A_FrameStorageFeatures.DestroyNamespaces, executionScope);
+            executionScope.destroy();
+
+            return context;
+        } catch (error) {
+
+            context.fail(new A_FrameStorageError({
+                title: A_FrameStorageError.DestroyNamespacesFailed,
+                description: `Failed to destroy namespace records.`,
+            }));
+
+            executionScope.destroy();
+
+            return context;
+        }
+    }
+}

package/src/lib/A-FrameStorage/A-FrameStorage.constants.ts

@@ -0,0 +1,11 @@
+
+
+export const A_FrameStorageFeatures = {
+    SaveDefinitions: '_A_FRAME_STORAGE_SAVE',
+    LoadDefinitions: '_A_FRAME_STORAGE_LOAD',
+    DestroyDefinitions: '_A_FRAME_STORAGE_DESTROY',
+    
+    SaveNamespaces: '_A_FRAME_STORAGE_SAVE_NAMESPACES',
+    LoadNamespaces: '_A_FRAME_STORAGE_LOAD_NAMESPACES',
+    DestroyNamespaces: '_A_FRAME_STORAGE_DESTROY_NAMESPACES',
+} as const

package/src/lib/A-FrameStorage/A-FrameStorage.error.ts

@@ -0,0 +1,13 @@
+import { A_Error } from "@adaas/a-concept";
+
+
+
+export class A_FrameStorageError extends A_Error {
+    static readonly SaveDefinitionFailed = 'SaveDefinitionFailed';
+    static readonly LoadDefinitionsFailed = 'LoadDefinitionsFailed';
+    static readonly DestroyDefinitionsFailed = 'DestroyDefinitionsFailed';
+    static readonly SaveNamespaceFailed = 'SaveNamespaceFailed';
+    static readonly LoadNamespacesFailed = 'LoadNamespacesFailed';
+    static readonly DestroyNamespacesFailed = 'DestroyNamespacesFailed';
+
+}

package/src/lib/A-FrameStorage/A-FrameStorage.types.ts

@@ -0,0 +1,98 @@
+import { A_FrameDefinition } from "../A-FrameDefinition";
+import { A_FrameDefinition_Serialized } from "../A-FrameDefinition/A-FrameDefinition.types";
+import { A_FrameNamespace_Record, A_FrameNamespace_Serialized } from "../A-FrameNamespace/A-FrameNamespace.types";
+import { A_FrameStorageOperation } from "./A-FrameStorageOperation.context";
+
+
+export interface IA_FrameStorage {
+
+    saveDefinitions(definitions: Array<A_FrameDefinition_Serialized>): Promise<A_FrameStorageSaveDefinitionOperationResult>;
+
+    loadDefinitions(namespaceId: string, definitionId: string): Promise<A_FrameStorageLoadDefinitionsOperationResult>;
+
+    destroyDefinitions(namespaceId: string, definitionId: string): Promise<A_FrameStorageDestroyDefinitionsOperationResult>;
+
+
+
+    saveNamespaces(namespaces: A_FrameNamespace_Serialized[]): Promise<A_FrameStorageSaveNamespaceOperationResult>;
+
+    loadNamespaces(): Promise<A_FrameStorageLoadNamespacesOperationResult>;
+
+    destroyNamespaces(namespaceId: string): Promise<A_FrameStorageDestroyNamespacesOperationResult>;
+}
+
+
+// ===================================================================
+// ------------------- Definitions Operations -------------------
+// ===================================================================
+// -------------------- Save Definition Operation --------------------
+export type A_FrameStorageSaveDefinitionOperationParams = {
+    records: A_FrameDefinition_Serialized[];
+};
+
+export type A_FrameStorageSaveDefinitionOperationResult = {
+    saved: number;
+};
+
+// -------------------- Load Definitions Operation --------------------
+export type A_FrameStorageLoadDefinitionsOperationParams = {
+    namespaceId: string;
+};
+
+export type A_FrameStorageLoadDefinitionsOperationResult = {
+    records?: A_FrameDefinition_Serialized[];
+};
+
+// -------------------- Destroy Definitions Operation --------------------
+export type A_FrameStorageDestroyDefinitionsOperationParams = {
+    namespaceId: string;
+    definitionId: string;
+}
+
+export type A_FrameStorageDestroyDefinitionsOperationResult = {
+    records: Array<A_FrameDefinition_Serialized>;
+}
+
+
+// ──────────────────────────────────────────────────────────────────────────────
+
+export type A_FrameStorageSaveDefinitionOperation = A_FrameStorageOperation<A_FrameStorageSaveDefinitionOperationParams, A_FrameStorageSaveDefinitionOperationResult>;
+
+export type A_FrameStorageLoadDefinitionsOperation = A_FrameStorageOperation<A_FrameStorageLoadDefinitionsOperationParams, A_FrameStorageLoadDefinitionsOperationResult>;
+
+export type A_FrameStorageDestroyDefinitionsOperation = A_FrameStorageOperation<A_FrameStorageDestroyDefinitionsOperationParams, A_FrameStorageDestroyDefinitionsOperationResult>;
+
+// ===================================================================
+// ------------------- Namespace Operations -------------------
+// ===================================================================
+// -------------------- Save Namespaces Operation --------------------
+export type A_FrameStorageSaveNamespaceOperationParams = {
+    records: A_FrameNamespace_Serialized[];
+}
+
+export type A_FrameStorageSaveNamespaceOperationResult = {
+    success: boolean;
+}
+// -------------------- Load Namespaces Operation --------------------
+export type A_FrameStorageLoadNamespacesOperationParams = {
+    namespaces?: string[];
+}
+
+export type A_FrameStorageLoadNamespacesOperationResult = {
+    records: A_FrameNamespace_Serialized[];
+}
+// -------------------- Destroy Namespaces Operation --------------------
+export type A_FrameStorageDestroyNamespacesOperationParams = {
+    namespaces: string[];
+}
+
+export type A_FrameStorageDestroyNamespacesOperationResult = {
+    success: boolean;
+}
+
+
+export type A_FrameStorageSaveNamespaceOperation = A_FrameStorageOperation<A_FrameStorageSaveNamespaceOperationParams, A_FrameStorageSaveNamespaceOperationResult>;
+
+export type A_FrameStorageLoadNamespacesOperation = A_FrameStorageOperation<A_FrameStorageLoadNamespacesOperationParams, A_FrameStorageLoadNamespacesOperationResult>;
+
+export type A_FrameStorageDestroyNamespacesOperation = A_FrameStorageOperation<A_FrameStorageDestroyNamespacesOperationParams, A_FrameStorageDestroyNamespacesOperationResult>;