@drop-ai/core 0.2.0 → 0.3.0

package/dist/storage/ExportPresetStorage.js

@@ -0,0 +1,121 @@
+import { ExportPreset, getBuiltInPresets } from '../domain/ExportPreset';
+const DB_NAME = 'drop-ai-daw';
+const DB_VERSION = 2;
+const PRESETS_STORE = 'exportPresets';
+/**
+ * IndexedDB storage for export presets.
+ * Follows the same pattern as SessionStorage.
+ */
+export class ExportPresetStorage {
+    constructor() {
+        this.dbPromise = null;
+    }
+    static getInstance() {
+        if (!ExportPresetStorage.instance) {
+            ExportPresetStorage.instance = new ExportPresetStorage();
+        }
+        return ExportPresetStorage.instance;
+    }
+    openDB() {
+        if (this.dbPromise)
+            return this.dbPromise;
+        this.dbPromise = new Promise((resolve, reject) => {
+            const request = indexedDB.open(DB_NAME, DB_VERSION);
+            request.onupgradeneeded = (event) => {
+                const db = request.result;
+                const oldVersion = event.oldVersion;
+                // Existing stores from version 1
+                if (oldVersion < 1) {
+                    if (!db.objectStoreNames.contains('sessions')) {
+                        const sessionsStore = db.createObjectStore('sessions', { keyPath: 'id' });
+                        sessionsStore.createIndex('name', 'name', { unique: false });
+                        sessionsStore.createIndex('modified', 'modified', { unique: false });
+                    }
+                    if (!db.objectStoreNames.contains('snapshots')) {
+                        const snapshotsStore = db.createObjectStore('snapshots', { keyPath: 'id' });
+                        snapshotsStore.createIndex('sessionId', 'sessionId', { unique: false });
+                        snapshotsStore.createIndex('created', 'created', { unique: false });
+                    }
+                }
+                // New store for version 2
+                if (oldVersion < 2) {
+                    if (!db.objectStoreNames.contains(PRESETS_STORE)) {
+                        const presetsStore = db.createObjectStore(PRESETS_STORE, { keyPath: 'id' });
+                        presetsStore.createIndex('name', 'name', { unique: false });
+                    }
+                }
+            };
+            request.onsuccess = () => resolve(request.result);
+            request.onerror = () => {
+                this.dbPromise = null;
+                reject(request.error);
+            };
+        });
+        return this.dbPromise;
+    }
+    /**
+     * Save a user preset.
+     */
+    async savePreset(preset) {
+        const db = await this.openDB();
+        const record = preset.toJSON();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(PRESETS_STORE, 'readwrite');
+            tx.objectStore(PRESETS_STORE).put(record);
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    /**
+     * Load a preset by ID.
+     */
+    async loadPreset(id) {
+        const db = await this.openDB();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(PRESETS_STORE, 'readonly');
+            const request = tx.objectStore(PRESETS_STORE).get(id);
+            request.onsuccess = () => {
+                const record = request.result;
+                resolve(record ? ExportPreset.fromJSON(record) : null);
+            };
+            request.onerror = () => reject(request.error);
+        });
+    }
+    /**
+     * List all saved user presets.
+     */
+    async listPresets() {
+        const db = await this.openDB();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(PRESETS_STORE, 'readonly');
+            const request = tx.objectStore(PRESETS_STORE).getAll();
+            request.onsuccess = () => {
+                var _a;
+                const records = ((_a = request.result) !== null && _a !== void 0 ? _a : []);
+                resolve(records.map(r => ExportPreset.fromJSON(r)));
+            };
+            request.onerror = () => reject(request.error);
+        });
+    }
+    /**
+     * Get all presets (built-in + user).
+     */
+    async getAllPresets() {
+        const builtIn = getBuiltInPresets();
+        const userPresets = await this.listPresets();
+        return [...builtIn, ...userPresets];
+    }
+    /**
+     * Delete a user preset by ID.
+     */
+    async deletePreset(id) {
+        const db = await this.openDB();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(PRESETS_STORE, 'readwrite');
+            tx.objectStore(PRESETS_STORE).delete(id);
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+}
+//# sourceMappingURL=ExportPresetStorage.js.map

package/dist/storage/ExportPresetStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExportPresetStorage.js","sourceRoot":"","sources":["../../src/storage/ExportPresetStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE/F,MAAM,OAAO,GAAG,aAAa,CAAC;AAC9B,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,aAAa,GAAG,eAAe,CAAC;AAEtC;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAI5B;QAFQ,cAAS,GAAgC,IAAI,CAAC;IAE/B,CAAC;IAEjB,MAAM,CAAC,WAAW;QACrB,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CAAC;YAChC,mBAAmB,CAAC,QAAQ,GAAG,IAAI,mBAAmB,EAAE,CAAC;QAC7D,CAAC;QACD,OAAO,mBAAmB,CAAC,QAAQ,CAAC;IACxC,CAAC;IAEO,MAAM;QACV,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC;QAE1C,IAAI,CAAC,SAAS,GAAG,IAAI,OAAO,CAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1D,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAEpD,OAAO,CAAC,eAAe,GAAG,CAAC,KAAK,EAAE,EAAE;gBAChC,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;gBAC1B,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;gBAEpC,iCAAiC;gBACjC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;oBACjB,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;wBAC5C,MAAM,aAAa,GAAG,EAAE,CAAC,iBAAiB,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;wBAC1E,aAAa,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;wBAC7D,aAAa,CAAC,WAAW,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;oBACzE,CAAC;oBACD,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;wBAC7C,MAAM,cAAc,GAAG,EAAE,CAAC,iBAAiB,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;wBAC5E,cAAc,CAAC,WAAW,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;wBACxE,cAAc,CAAC,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;oBACxE,CAAC;gBACL,CAAC;gBAED,0BAA0B;gBAC1B,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;oBACjB,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;wBAC/C,MAAM,YAAY,GAAG,EAAE,CAAC,iBAAiB,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;wBAC5E,YAAY,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;oBAChE,CAAC;gBACL,CAAC;YACL,CAAC,CAAC;YAEF,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAClD,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE;gBACnB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBACtB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC,CAAC;QACN,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAU,CAAC,MAAoB;QACxC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAE/B,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACzC,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;YACtD,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC1C,EAAE,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;YAChC,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAU,CAAC,EAAU;QAC9B,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QAC/B,OAAO,IAAI,OAAO,CAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxD,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;YACrD,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACtD,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE;gBACrB,MAAM,MAAM,GAAG,OAAO,CAAC,MAA0C,CAAC;gBAClE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3D,CAAC,CAAC;YACF,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,WAAW;QACpB,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QAC/B,OAAO,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnD,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;YACrD,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,MAAM,EAAE,CAAC;YACvD,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE;;gBACrB,MAAM,OAAO,GAAG,CAAC,MAAA,OAAO,CAAC,MAAM,mCAAI,EAAE,CAA2B,CAAC;gBACjE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxD,CAAC,CAAC;YACF,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,aAAa;QACtB,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7C,OAAO,CAAC,GAAG,OAAO,EAAE,GAAG,WAAW,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,YAAY,CAAC,EAAU;QAChC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QAC/B,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACzC,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;YACtD,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACzC,EAAE,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;YAChC,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/storage/SessionArchive.d.ts

@@ -0,0 +1,73 @@
+import { Signal } from '../lib/Signal';
+/**
+ * SessionArchive packages a session and all its referenced audio files
+ * into a single downloadable archive.
+ *
+ * In the browser context, this creates a custom binary bundle containing:
+ * - session.json (the serialized session state)
+ * - audio sources (all source audio files as blobs)
+ * - metadata.json (archive metadata)
+ *
+ * Binary format:
+ * [4 bytes magic: "DRPA"]
+ * [4 bytes version: 1]
+ * [4 bytes metadata JSON length]
+ * [metadata JSON]
+ * [4 bytes session JSON length]
+ * [session JSON]
+ * [4 bytes source count]
+ * For each source:
+ *   [4 bytes name length]
+ *   [name UTF-8]
+ *   [4 bytes blob size]
+ *   [blob data]
+ */
+export interface ArchiveMetadata {
+    version: string;
+    createdAt: string;
+    sessionName: string;
+    sourceCount: number;
+    totalSize: number;
+}
+export interface ExtractedArchive {
+    sessionData: string;
+    sources: Array<{
+        name: string;
+        blob: Blob;
+    }>;
+    metadata: ArchiveMetadata;
+}
+export declare class SessionArchive {
+    readonly progress: Signal<number>;
+    /**
+     * Create an archive from session data and audio sources.
+     *
+     * @param sessionData  JSON string of the serialized session.
+     * @param sources      Array of audio sources to include.
+     * @param metadata     Optional metadata overrides.
+     * @returns A Blob containing the packed archive.
+     */
+    createArchive(sessionData: string, sources: Array<{
+        name: string;
+        url: string;
+        blob: Blob;
+    }>, metadata?: Partial<ArchiveMetadata>): Promise<Blob>;
+    /**
+     * Extract an archive into session data and audio blobs.
+     *
+     * @param archiveBlob The archive Blob to extract.
+     * @returns The extracted session data, sources, and metadata.
+     * @throws Error if the archive format is invalid.
+     */
+    extractArchive(archiveBlob: Blob): Promise<ExtractedArchive>;
+    /**
+     * Get archive info without fully extracting all sources.
+     * Only reads the header and metadata section.
+     *
+     * @param archiveBlob The archive Blob to inspect.
+     * @returns The archive metadata.
+     * @throws Error if the archive format is invalid.
+     */
+    getArchiveInfo(archiveBlob: Blob): Promise<ArchiveMetadata>;
+}
+//# sourceMappingURL=SessionArchive.d.ts.map

package/dist/storage/SessionArchive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionArchive.d.ts","sourceRoot":"","sources":["../../src/storage/SessionArchive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;IAC7C,QAAQ,EAAE,eAAe,CAAC;CAC7B;AAMD,qBAAa,cAAc;IACvB,SAAgB,QAAQ,iBAAwB;IAEhD;;;;;;;OAOG;IACG,aAAa,CACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,EACzD,QAAQ,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;IAyGhB;;;;;;OAMG;IACG,cAAc,CAAC,WAAW,EAAE,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8ElE;;;;;;;OAOG;IACG,cAAc,CAAC,WAAW,EAAE,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC;CAwCpE"}

package/dist/storage/SessionArchive.js

@@ -0,0 +1,211 @@
+import { Signal } from '../lib/Signal';
+/** Magic bytes identifying a drop.ai archive: "DRPA" */
+const ARCHIVE_MAGIC = new Uint8Array([0x44, 0x52, 0x50, 0x41]); // "DRPA"
+const ARCHIVE_FORMAT_VERSION = 1;
+export class SessionArchive {
+    constructor() {
+        this.progress = new Signal();
+    }
+    /**
+     * Create an archive from session data and audio sources.
+     *
+     * @param sessionData  JSON string of the serialized session.
+     * @param sources      Array of audio sources to include.
+     * @param metadata     Optional metadata overrides.
+     * @returns A Blob containing the packed archive.
+     */
+    async createArchive(sessionData, sources, metadata) {
+        var _a, _b, _c;
+        this.progress.emit(0);
+        const encoder = new TextEncoder();
+        // Convert all source blobs to ArrayBuffers up front
+        const sourceBuffers = [];
+        let totalSourceSize = 0;
+        for (let i = 0; i < sources.length; i++) {
+            const data = await sources[i].blob.arrayBuffer();
+            sourceBuffers.push({ name: sources[i].name, data });
+            totalSourceSize += data.byteLength;
+            this.progress.emit((i + 1) / (sources.length + 2) * 0.5);
+        }
+        // Build metadata
+        const sessionBytes = encoder.encode(sessionData);
+        const archiveMetadata = {
+            version: (_a = metadata === null || metadata === void 0 ? void 0 : metadata.version) !== null && _a !== void 0 ? _a : '1.0.0',
+            createdAt: (_b = metadata === null || metadata === void 0 ? void 0 : metadata.createdAt) !== null && _b !== void 0 ? _b : new Date().toISOString(),
+            sessionName: (_c = metadata === null || metadata === void 0 ? void 0 : metadata.sessionName) !== null && _c !== void 0 ? _c : 'Untitled Session',
+            sourceCount: sources.length,
+            totalSize: 0, // Will be computed after assembly
+        };
+        const metadataBytes = encoder.encode(JSON.stringify(archiveMetadata));
+        // Calculate total size:
+        //   4 (magic) + 4 (version) +
+        //   4 (metadata len) + metadata +
+        //   4 (session len) + session +
+        //   4 (source count) +
+        //   for each source: 4 (name len) + name + 4 (blob size) + blob
+        let totalSize = 4 + 4 + 4 + metadataBytes.byteLength + 4 + sessionBytes.byteLength + 4;
+        for (const src of sourceBuffers) {
+            const nameBytes = encoder.encode(src.name);
+            totalSize += 4 + nameBytes.byteLength + 4 + src.data.byteLength;
+        }
+        // Update metadata with actual total size and re-encode
+        archiveMetadata.totalSize = totalSize;
+        const finalMetadataBytes = encoder.encode(JSON.stringify(archiveMetadata));
+        // Recalculate if metadata size changed
+        const sizeDiff = finalMetadataBytes.byteLength - metadataBytes.byteLength;
+        totalSize += sizeDiff;
+        this.progress.emit(0.6);
+        // Assemble the archive buffer
+        const buffer = new ArrayBuffer(totalSize);
+        const view = new DataView(buffer);
+        const bytes = new Uint8Array(buffer);
+        let offset = 0;
+        // Magic: "DRPA"
+        bytes.set(ARCHIVE_MAGIC, offset);
+        offset += 4;
+        // Format version
+        view.setUint32(offset, ARCHIVE_FORMAT_VERSION, true);
+        offset += 4;
+        // Metadata JSON length + data
+        view.setUint32(offset, finalMetadataBytes.byteLength, true);
+        offset += 4;
+        bytes.set(finalMetadataBytes, offset);
+        offset += finalMetadataBytes.byteLength;
+        // Session JSON length + data
+        view.setUint32(offset, sessionBytes.byteLength, true);
+        offset += 4;
+        bytes.set(sessionBytes, offset);
+        offset += sessionBytes.byteLength;
+        // Source count
+        view.setUint32(offset, sourceBuffers.length, true);
+        offset += 4;
+        this.progress.emit(0.7);
+        // Each source
+        for (let i = 0; i < sourceBuffers.length; i++) {
+            const src = sourceBuffers[i];
+            const nameBytes = encoder.encode(src.name);
+            // Name length + name
+            view.setUint32(offset, nameBytes.byteLength, true);
+            offset += 4;
+            bytes.set(nameBytes, offset);
+            offset += nameBytes.byteLength;
+            // Blob size + blob data
+            view.setUint32(offset, src.data.byteLength, true);
+            offset += 4;
+            bytes.set(new Uint8Array(src.data), offset);
+            offset += src.data.byteLength;
+            this.progress.emit(0.7 + ((i + 1) / sourceBuffers.length) * 0.25);
+        }
+        this.progress.emit(1.0);
+        return new Blob([buffer], { type: 'application/x-drop-archive' });
+    }
+    /**
+     * Extract an archive into session data and audio blobs.
+     *
+     * @param archiveBlob The archive Blob to extract.
+     * @returns The extracted session data, sources, and metadata.
+     * @throws Error if the archive format is invalid.
+     */
+    async extractArchive(archiveBlob) {
+        this.progress.emit(0);
+        const arrayBuffer = await archiveBlob.arrayBuffer();
+        const view = new DataView(arrayBuffer);
+        const bytes = new Uint8Array(arrayBuffer);
+        const decoder = new TextDecoder();
+        let offset = 0;
+        // Validate magic
+        if (bytes[0] !== ARCHIVE_MAGIC[0] ||
+            bytes[1] !== ARCHIVE_MAGIC[1] ||
+            bytes[2] !== ARCHIVE_MAGIC[2] ||
+            bytes[3] !== ARCHIVE_MAGIC[3]) {
+            throw new Error('Invalid archive: missing DRPA magic bytes');
+        }
+        offset += 4;
+        // Read format version
+        const formatVersion = view.getUint32(offset, true);
+        if (formatVersion !== ARCHIVE_FORMAT_VERSION) {
+            throw new Error(`Unsupported archive format version: ${formatVersion}`);
+        }
+        offset += 4;
+        this.progress.emit(0.1);
+        // Read metadata
+        const metadataLength = view.getUint32(offset, true);
+        offset += 4;
+        const metadataJson = decoder.decode(bytes.slice(offset, offset + metadataLength));
+        const metadata = JSON.parse(metadataJson);
+        offset += metadataLength;
+        this.progress.emit(0.2);
+        // Read session data
+        const sessionLength = view.getUint32(offset, true);
+        offset += 4;
+        const sessionData = decoder.decode(bytes.slice(offset, offset + sessionLength));
+        offset += sessionLength;
+        this.progress.emit(0.4);
+        // Read source count
+        const sourceCount = view.getUint32(offset, true);
+        offset += 4;
+        // Read each source
+        const sources = [];
+        for (let i = 0; i < sourceCount; i++) {
+            // Name length + name
+            const nameLength = view.getUint32(offset, true);
+            offset += 4;
+            const name = decoder.decode(bytes.slice(offset, offset + nameLength));
+            offset += nameLength;
+            // Blob size + blob data
+            const blobSize = view.getUint32(offset, true);
+            offset += 4;
+            const blobData = bytes.slice(offset, offset + blobSize);
+            offset += blobSize;
+            sources.push({
+                name,
+                blob: new Blob([blobData]),
+            });
+            this.progress.emit(0.4 + ((i + 1) / sourceCount) * 0.55);
+        }
+        this.progress.emit(1.0);
+        return { sessionData, sources, metadata };
+    }
+    /**
+     * Get archive info without fully extracting all sources.
+     * Only reads the header and metadata section.
+     *
+     * @param archiveBlob The archive Blob to inspect.
+     * @returns The archive metadata.
+     * @throws Error if the archive format is invalid.
+     */
+    async getArchiveInfo(archiveBlob) {
+        // We only need to read the header portion: magic (4) + version (4) +
+        // metadata length (4) + metadata. Read a generous initial chunk.
+        const headerSize = Math.min(archiveBlob.size, 64 * 1024); // up to 64KB
+        const headerSlice = archiveBlob.slice(0, headerSize);
+        const arrayBuffer = await headerSlice.arrayBuffer();
+        const view = new DataView(arrayBuffer);
+        const bytes = new Uint8Array(arrayBuffer);
+        const decoder = new TextDecoder();
+        let offset = 0;
+        // Validate magic
+        if (bytes[0] !== ARCHIVE_MAGIC[0] ||
+            bytes[1] !== ARCHIVE_MAGIC[1] ||
+            bytes[2] !== ARCHIVE_MAGIC[2] ||
+            bytes[3] !== ARCHIVE_MAGIC[3]) {
+            throw new Error('Invalid archive: missing DRPA magic bytes');
+        }
+        offset += 4;
+        // Read format version
+        const formatVersion = view.getUint32(offset, true);
+        if (formatVersion !== ARCHIVE_FORMAT_VERSION) {
+            throw new Error(`Unsupported archive format version: ${formatVersion}`);
+        }
+        offset += 4;
+        // Read metadata
+        const metadataLength = view.getUint32(offset, true);
+        offset += 4;
+        if (offset + metadataLength > arrayBuffer.byteLength) {
+            throw new Error('Archive header is truncated; cannot read metadata');
+        }
+        const metadataJson = decoder.decode(bytes.slice(offset, offset + metadataLength));
+        return JSON.parse(metadataJson);
+    }
+}
+//# sourceMappingURL=SessionArchive.js.map

package/dist/storage/SessionArchive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionArchive.js","sourceRoot":"","sources":["../../src/storage/SessionArchive.ts"],"names":[],"mappings":"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"}

package/dist/storage/SessionTemplate.d.ts

@@ -1,12 +1,81 @@
 import { Session } from '../domain/Session';
-/**
- * Describes a session template.
- */
+import { TrackType } from '../domain/Track';
+import { Signal } from '../lib/Signal';
+export interface TrackTemplate {
+    name: string;
+    type: TrackType;
+    color?: string;
+    plugins?: Array<{
+        pluginId: string;
+        params?: Record<string, number>;
+    }>;
+    armed?: boolean;
+    monitorMode?: string;
+}
 export interface SessionTemplate {
     id: string;
     name: string;
     description: string;
-    trackCount: number;
+    category: 'recording' | 'mixing' | 'mastering' | 'production' | 'podcast' | 'custom';
+    sampleRate: number;
+    tempo: number;
+    timeSignature: [number, number];
+    tracks: TrackTemplate[];
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Manages session templates — predefined track / routing configurations
+ * that users can instantiate to quickly bootstrap new sessions.
+ *
+ * Includes a set of built-in factory templates (recording, podcast,
+ * mixing, mastering, production) and supports user-created custom
+ * templates.
+ */
+export declare class SessionTemplateManager {
+    private _templates;
+    readonly templatesChanged: Signal<void>;
+    constructor();
+    /**
+     * Add a new template. An `id`, `createdAt`, and `updatedAt` are generated
+     * automatically.
+     */
+    addTemplate(template: Omit<SessionTemplate, 'id' | 'createdAt' | 'updatedAt'>): SessionTemplate;
+    /**
+     * Update an existing template. Only the supplied fields are merged; the
+     * `updatedAt` timestamp is refreshed automatically.
+     */
+    updateTemplate(id: string, updates: Partial<SessionTemplate>): void;
+    /**
+     * Remove a template by ID.
+     */
+    removeTemplate(id: string): void;
+    /**
+     * Get a single template by ID.
+     */
+    getTemplate(id: string): SessionTemplate | undefined;
+    /**
+     * Get all registered templates.
+     */
+    getAllTemplates(): SessionTemplate[];
+    /**
+     * Get templates filtered by category.
+     */
+    getTemplatesByCategory(category: string): SessionTemplate[];
+    /**
+     * Snapshot a Session into a reusable template.
+     */
+    static createFromSession(session: Session, name: string, description: string): SessionTemplate;
+    static getDefaultTemplates(): SessionTemplate[];
+    /**
+     * Serialize all templates to a JSON string.
+     */
+    serialize(): string;
+    /**
+     * Restore a SessionTemplateManager from a JSON string produced by
+     * `serialize()`.
+     */
+    static deserialize(json: string): SessionTemplateManager;
 }
 /**
  * Returns the list of available session templates.
@@ -16,7 +85,7 @@ export declare function getTemplates(): SessionTemplate[];
  * Create a new Session from a template.
  *
  * Each template pre-configures tracks with default names, colors,
- * and routing through the master bus.
+ * armed state, and routing through the master bus.
  */
 export declare function createFromTemplate(templateId: string): Session;
 //# sourceMappingURL=SessionTemplate.d.ts.map

package/dist/storage/SessionTemplate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionTemplate.d.ts","sourceRoot":"","sources":["../../src/storage/SessionTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACtB;AA0BD;;GAEG;AACH,wBAAgB,YAAY,IAAI,eAAe,EAAE,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CA4C9D"}
+{"version":3,"file":"SessionTemplate.d.ts","sourceRoot":"","sources":["../../src/storage/SessionTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAS,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAIvC,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,CAAC;IACvE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;IACrF,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAUD;;;;;;;GAOG;AACH,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,UAAU,CAA2C;IAE7D,SAAgB,gBAAgB,eAAsB;;IAWtD;;;OAGG;IACH,WAAW,CACP,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,GAClE,eAAe;IAalB;;;OAGG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAenE;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMhC;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIpD;;OAEG;IACH,eAAe,IAAI,eAAe,EAAE;IAIpC;;OAEG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE;IAM3D;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACpB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GACpB,eAAe;IA4BlB,MAAM,CAAC,mBAAmB,IAAI,eAAe,EAAE;IA+H/C;;OAEG;IACH,SAAS,IAAI,MAAM;IAOnB;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB;CAU3D;AAID;;GAEG;AACH,wBAAgB,YAAY,IAAI,eAAe,EAAE,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAsB9D"}