@archlast/server 0.0.1

package/dist/storage/manager.js

@@ -0,0 +1,416 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageManager = exports.STORAGE_STAGING_COLLECTION = exports.STORAGE_NAMES_COLLECTION = exports.STORAGE_OBJECTS_COLLECTION = void 0;
+const async_hooks_1 = require("async_hooks");
+const crypto_1 = require("crypto");
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+// Collections for storage metadata
+exports.STORAGE_OBJECTS_COLLECTION = "_storage_objects";
+exports.STORAGE_NAMES_COLLECTION = "_storage_names";
+exports.STORAGE_STAGING_COLLECTION = "_storage_staging";
+/**
+ * StorageManager
+ *
+ * - Content-addressed (SHA-256) immutable objects
+ * - Staging with transactional commit/rollback
+ * - Document Store-backed metadata (_storage_objects, _storage_staging, _storage_names)
+ * - Pluggable backend (FS or S3 for actual blob storage)
+ *
+ * Dashboard support:
+ * - Persist an optional human-friendly `file_name` for each object
+ * - Provide listing APIs (cursor/pagination can be added later)
+ */
+class StorageManager {
+    backend;
+    stagingDir;
+    db;
+    logger;
+    txScope = new async_hooks_1.AsyncLocalStorage();
+    constructor(options) {
+        this.backend = options.backend;
+        this.db = options.db;
+        this.stagingDir = options.stagingDir ?? "./data/storage/.staging";
+        this.logger = options.logger;
+    }
+    /**
+     * Run storage operations within a transactional scope.
+     * Staged blobs are committed only if `fn` resolves; rolled back on rejection.
+     */
+    async withTransaction(txId, fn) {
+        return this.txScope.run({ txId, staged: [] }, async () => {
+            try {
+                const result = await fn();
+                await this.commit();
+                return result;
+            }
+            catch (err) {
+                await this.rollback();
+                throw err;
+            }
+        });
+    }
+    /**
+     * Store a stream/blob/uint8array. Content-addressed by SHA-256.
+     * If called inside withTransaction, it stages and defers commit;
+     * otherwise it finalizes immediately.
+     */
+    async store(stream, options) {
+        return this.storeWithName(stream, options);
+    }
+    /**
+     * Store an object while preserving a human-friendly filename for dashboards.
+     *
+     * Note: Storage is still content-addressed; filename is metadata only.
+     */
+    async storeWithName(stream, options) {
+        await (0, promises_1.mkdir)(this.stagingDir, { recursive: true });
+        const tempName = `stage-${(0, crypto_1.randomUUID)()}`;
+        const tempPath = (0, path_1.join)(this.stagingDir, tempName);
+        try {
+            // Buffer the entire payload to ensure predictable hashing and writing
+            const arrayBuffer = stream instanceof Uint8Array
+                ? stream.buffer.slice(stream.byteOffset, stream.byteOffset + stream.byteLength)
+                : stream instanceof Blob
+                    ? await stream.arrayBuffer()
+                    : await new Response(stream).arrayBuffer();
+            const hash = (0, crypto_1.createHash)("sha256").update(new Uint8Array(arrayBuffer)).digest("hex");
+            const size = arrayBuffer.byteLength;
+            const id = hash;
+            const meta = { size, contentType: options?.contentType, hash };
+            const fileName = typeof options?.fileName === "string" && options.fileName.trim().length > 0
+                ? options.fileName
+                : null;
+            await this.logger.log({
+                timestamp: Date.now(),
+                level: "info",
+                kind: "system",
+                message: "Storage store buffered payload",
+                context: {
+                    id,
+                    size,
+                    contentType: options?.contentType,
+                    fileName: fileName ?? undefined,
+                },
+            });
+            await Bun.write(tempPath, arrayBuffer);
+            await this.logger.log({
+                timestamp: Date.now(),
+                level: "info",
+                kind: "system",
+                message: "Storage store wrote temp file",
+                context: { id, tempPath },
+            });
+            const scope = this.txScope.getStore();
+            if (scope) {
+                // Insert staging entry
+                await this.db.insert(exports.STORAGE_STAGING_COLLECTION, {
+                    objectId: id,
+                    txId: scope.txId,
+                });
+                scope.staged.push({ tempPath, finalId: id, meta });
+                if (fileName) {
+                    // Persist filename immediately
+                    const existingName = await this.db.findFirst(exports.STORAGE_NAMES_COLLECTION, {
+                        where: { objectId: { eq: id } },
+                    });
+                    if (!existingName) {
+                        await this.db.insert(exports.STORAGE_NAMES_COLLECTION, {
+                            objectId: id,
+                            fileName,
+                        });
+                    }
+                }
+                await this.logger.log({
+                    timestamp: Date.now(),
+                    level: "info",
+                    kind: "system",
+                    message: "Staged storage object",
+                    context: { id, size, staged: true, fileName: fileName ?? undefined },
+                });
+                return id;
+            }
+            await this.logger.log({
+                timestamp: Date.now(),
+                level: "info",
+                kind: "system",
+                message: "Storage store finalizing object",
+                context: { id, size, fileName: fileName ?? undefined },
+            });
+            await this.finalizeOne({ tempPath, finalId: id, meta });
+            if (fileName) {
+                const existingName = await this.db.findFirst(exports.STORAGE_NAMES_COLLECTION, {
+                    where: { objectId: { eq: id } },
+                });
+                if (existingName) {
+                    await this.db.update(exports.STORAGE_NAMES_COLLECTION, existingName._id, {
+                        fileName,
+                    });
+                }
+                else {
+                    await this.db.insert(exports.STORAGE_NAMES_COLLECTION, {
+                        objectId: id,
+                        fileName,
+                    });
+                }
+            }
+            return id;
+        }
+        catch (err) {
+            await this.logger.log({
+                timestamp: Date.now(),
+                level: "error",
+                kind: "system",
+                message: "Storage store failed",
+                context: { error: err instanceof Error ? err.message : String(err) },
+            });
+            await this.safeDeleteTemp(tempPath).catch(() => { });
+            throw err;
+        }
+    }
+    async getUrl(id, options) {
+        if (typeof this.backend.signUrl === "function") {
+            return this.backend.signUrl(id, options?.expiresInSeconds ?? 60);
+        }
+        throw new Error("URL signing is not supported by the active storage backend");
+    }
+    async open(id) {
+        const exists = await this.exists(id);
+        if (!exists) {
+            throw new Error(`Storage object not found: ${id}`);
+        }
+        return this.backend.get(id);
+    }
+    async delete(id) {
+        const obj = (await this.db.findFirst(exports.STORAGE_OBJECTS_COLLECTION, {
+            where: { objectId: { eq: id } },
+        }));
+        if (!obj) {
+            return;
+        }
+        if (obj.refCount > 1) {
+            await this.db.update(exports.STORAGE_OBJECTS_COLLECTION, obj._id, {
+                refCount: obj.refCount - 1,
+            });
+            return;
+        }
+        // refCount == 1 -> delete
+        await this.db.delete(exports.STORAGE_OBJECTS_COLLECTION, obj._id);
+        // Also delete associated name
+        const nameDoc = (await this.db.findFirst(exports.STORAGE_NAMES_COLLECTION, {
+            where: { objectId: { eq: id } },
+        }));
+        if (nameDoc) {
+            await this.db.delete(exports.STORAGE_NAMES_COLLECTION, nameDoc._id);
+        }
+        await this.backend.delete(id);
+    }
+    async getMetadata(id) {
+        const obj = (await this.db.findFirst(exports.STORAGE_OBJECTS_COLLECTION, {
+            where: { objectId: { eq: id } },
+        }));
+        if (!obj)
+            return null;
+        return { size: obj.size, contentType: obj.contentType ?? undefined, hash: obj.hash };
+    }
+    /**
+     * Dashboard/admin helper to retrieve an optional human-friendly filename.
+     */
+    async getFileName(id) {
+        const nameDoc = (await this.db.findFirst(exports.STORAGE_NAMES_COLLECTION, {
+            where: { objectId: { eq: id } },
+        }));
+        const name = nameDoc?.fileName ?? null;
+        return typeof name === "string" && name.trim().length > 0 ? name : null;
+    }
+    async exists(id) {
+        const obj = await this.db.findFirst(exports.STORAGE_OBJECTS_COLLECTION, {
+            where: { objectId: { eq: id } },
+        });
+        return !!obj;
+    }
+    /**
+     * List storage objects for dashboards/admin tools.
+     * Returns the id (content hash), optional file_name, and basic meta.
+     */
+    async list(options) {
+        const limit = Math.max(1, Math.min(500, options?.limit ?? 50));
+        const offset = Math.max(0, options?.offset ?? 0);
+        const objects = await this.db.findMany(exports.STORAGE_OBJECTS_COLLECTION, {
+            take: limit,
+            skip: offset,
+        });
+        const items = [];
+        for (const obj of objects) {
+            const nameDoc = (await this.db.findFirst(exports.STORAGE_NAMES_COLLECTION, {
+                where: { objectId: { eq: obj.objectId } },
+            }));
+            items.push({
+                id: obj.objectId,
+                fileName: nameDoc?.fileName ?? null,
+                size: obj.size,
+                contentType: obj.contentType ?? null,
+                hash: obj.hash,
+                refCount: obj.refCount,
+            });
+        }
+        return items;
+    }
+    /**
+     * Garbage collect objects whose ref_count == 0 (safety: run after ref cleanup).
+     */
+    async deleteUnreferenced() {
+        const objects = (await this.db.findMany(exports.STORAGE_OBJECTS_COLLECTION, {
+            where: { refCount: { lte: 0 } },
+        }));
+        for (const obj of objects) {
+            await this.backend.delete(obj.objectId);
+            await this.db.delete(exports.STORAGE_OBJECTS_COLLECTION, obj._id);
+            const nameDoc = (await this.db.findFirst(exports.STORAGE_NAMES_COLLECTION, {
+                where: { objectId: { eq: obj.objectId } },
+            }));
+            if (nameDoc) {
+                await this.db.delete(exports.STORAGE_NAMES_COLLECTION, nameDoc._id);
+            }
+        }
+        return objects.length;
+    }
+    /**
+     * Remove staging entries for a transaction id (and delete temp files).
+     * Useful for cleanup of abandoned tx.
+     */
+    async cleanupStaging(txId) {
+        const where = txId ? { txId: { eq: txId } } : {};
+        const stagingDocs = (await this.db.findMany(exports.STORAGE_STAGING_COLLECTION, {
+            where,
+        }));
+        for (const doc of stagingDocs) {
+            const tempPath = this.tempPathFor(doc.objectId);
+            await this.safeDeleteTemp(tempPath);
+            await this.db.delete(exports.STORAGE_STAGING_COLLECTION, doc._id);
+        }
+        return stagingDocs.length;
+    }
+    // --- Internal helpers ---
+    async commit() {
+        const scope = this.txScope.getStore();
+        if (!scope || scope.staged.length === 0)
+            return;
+        for (const staged of scope.staged) {
+            // Remove staging marker
+            const stagingDoc = (await this.db.findFirst(exports.STORAGE_STAGING_COLLECTION, {
+                where: {
+                    and: [{ objectId: { eq: staged.finalId } }, { txId: { eq: scope.txId } }],
+                },
+            }));
+            if (stagingDoc) {
+                await this.db.delete(exports.STORAGE_STAGING_COLLECTION, stagingDoc._id);
+            }
+            const existing = (await this.db.findFirst(exports.STORAGE_OBJECTS_COLLECTION, {
+                where: { objectId: { eq: staged.finalId } },
+            }));
+            if (existing) {
+                await this.db.update(exports.STORAGE_OBJECTS_COLLECTION, existing._id, {
+                    refCount: existing.refCount + 1,
+                });
+                // backend already has blob if previously committed; no upload
+                await this.safeDeleteTemp(staged.tempPath);
+            }
+            else {
+                const stream = Bun.file(staged.tempPath).stream();
+                await this.backend.put(staged.finalId, stream, staged.meta);
+                await this.db.insert(exports.STORAGE_OBJECTS_COLLECTION, {
+                    objectId: staged.finalId,
+                    hash: staged.meta.hash,
+                    size: staged.meta.size,
+                    contentType: staged.meta.contentType ?? null,
+                    refCount: 1,
+                });
+                await this.safeDeleteTemp(staged.tempPath);
+            }
+        }
+        scope.staged = [];
+    }
+    async rollback() {
+        const scope = this.txScope.getStore();
+        if (!scope)
+            return;
+        // Drop staging markers and temp files
+        const stagingDocs = (await this.db.findMany(exports.STORAGE_STAGING_COLLECTION, {
+            where: { txId: { eq: scope.txId } },
+        }));
+        for (const doc of stagingDocs) {
+            await this.db.delete(exports.STORAGE_STAGING_COLLECTION, doc._id);
+        }
+        for (const staged of scope.staged) {
+            await this.safeDeleteTemp(staged.tempPath);
+        }
+        scope.staged = [];
+    }
+    async finalizeOne(staged) {
+        const existing = (await this.db.findFirst(exports.STORAGE_OBJECTS_COLLECTION, {
+            where: { objectId: { eq: staged.finalId } },
+        }));
+        if (existing) {
+            await this.logger.log({
+                timestamp: Date.now(),
+                level: "info",
+                kind: "system",
+                message: "Storage finalize found existing object",
+                context: { id: staged.finalId, refCount: existing.refCount },
+            });
+            await this.db.update(exports.STORAGE_OBJECTS_COLLECTION, existing._id, {
+                refCount: existing.refCount + 1,
+            });
+            await this.safeDeleteTemp(staged.tempPath);
+            await this.logger.log({
+                timestamp: Date.now(),
+                level: "info",
+                kind: "system",
+                message: "Incremented storage ref count",
+                context: { id: staged.finalId, refIncrement: 1 },
+            });
+            return;
+        }
+        await this.logger.log({
+            timestamp: Date.now(),
+            level: "info",
+            kind: "system",
+            message: "Storage finalize uploading to backend",
+            context: { id: staged.finalId, size: staged.meta.size },
+        });
+        const stream = Bun.file(staged.tempPath).stream();
+        await this.backend.put(staged.finalId, stream, staged.meta);
+        await this.logger.log({
+            timestamp: Date.now(),
+            level: "info",
+            kind: "system",
+            message: "Storage finalize wrote to backend",
+            context: { id: staged.finalId },
+        });
+        await this.db.insert(exports.STORAGE_OBJECTS_COLLECTION, {
+            objectId: staged.finalId,
+            hash: staged.meta.hash,
+            size: staged.meta.size,
+            contentType: staged.meta.contentType ?? null,
+            refCount: 1,
+        });
+        await this.safeDeleteTemp(staged.tempPath);
+        await this.logger.log({
+            timestamp: Date.now(),
+            level: "info",
+            kind: "system",
+            message: "Storage object finalized",
+            context: { id: staged.finalId, size: staged.meta.size },
+        });
+    }
+    async safeDeleteTemp(path) {
+        await (0, promises_1.rm)(path, { force: true }).catch(() => { });
+    }
+    tempPathFor(id) {
+        // Heuristic: staged file likely under stagingDir; cannot reconstruct name with randomness
+        return (0, path_1.join)(this.stagingDir, id);
+    }
+}
+exports.StorageManager = StorageManager;
+//# sourceMappingURL=manager.js.map

package/dist/storage/manager.js.map

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

package/dist/storage/s3-backend.d.ts

@@ -0,0 +1,30 @@
+import type { StorageBackend, StorageId, StorageMeta } from "./types.js";
+type S3Options = {
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    region?: string;
+    endpoint?: string;
+    bucket?: string;
+    basePath?: string;
+};
+/**
+ * S3-compatible storage backend using Bun's built-in S3 client.
+ *
+ * - Streaming uploads/downloads
+ * - Presigned URL support via client.presign
+ * - Immutability enforced at the caller (content-addressed ids)
+ */
+export declare class S3StorageBackend implements StorageBackend {
+    private readonly client;
+    private readonly bucket;
+    private readonly basePath;
+    constructor(options?: S3Options);
+    put(id: StorageId, stream: ReadableStream, meta: StorageMeta): Promise<void>;
+    get(id: StorageId): Promise<ReadableStream>;
+    delete(id: StorageId): Promise<void>;
+    exists(id: StorageId): Promise<boolean>;
+    signUrl(id: StorageId, expiresInSeconds: number): Promise<string>;
+    private keyFor;
+}
+export default S3StorageBackend;
+//# sourceMappingURL=s3-backend.d.ts.map

package/dist/storage/s3-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-backend.d.ts","sourceRoot":"","sources":["../../src/storage/s3-backend.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE,KAAK,SAAS,GAAG;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,cAAc;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,GAAE,SAAc;IAiB7B,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5E,GAAG,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC;IAS3C,MAAM,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpC,MAAM,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAMvC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMvE,OAAO,CAAC,MAAM;CAGjB;AAED,eAAe,gBAAgB,CAAC"}

package/dist/storage/s3-backend.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3StorageBackend = void 0;
+const bun_1 = require("bun");
+/**
+ * S3-compatible storage backend using Bun's built-in S3 client.
+ *
+ * - Streaming uploads/downloads
+ * - Presigned URL support via client.presign
+ * - Immutability enforced at the caller (content-addressed ids)
+ */
+class S3StorageBackend {
+    client;
+    bucket;
+    basePath;
+    constructor(options = {}) {
+        const accessKeyId = options.accessKeyId ?? process.env.S3_ACCESS_KEY_ID ?? "";
+        const secretAccessKey = options.secretAccessKey ?? process.env.S3_SECRET_ACCESS_KEY ?? "";
+        const region = options.region ?? process.env.S3_REGION ?? "us-east-1";
+        const endpoint = options.endpoint ?? process.env.S3_ENDPOINT;
+        this.bucket = options.bucket ?? process.env.S3_BUCKET ?? "archlast-storage";
+        this.basePath = (options.basePath ?? process.env.S3_BASE_PATH ?? "").replace(/\/+$/, "");
+        this.client = new bun_1.S3Client({
+            accessKeyId,
+            secretAccessKey,
+            region,
+            endpoint,
+            bucket: this.bucket,
+        });
+    }
+    async put(id, stream, meta) {
+        const key = this.keyFor(id);
+        const file = this.client.file(key);
+        await file.write(new Response(stream), { type: meta.contentType });
+    }
+    async get(id) {
+        const key = this.keyFor(id);
+        const file = this.client.file(key);
+        if (!(await file.exists())) {
+            throw new Error(`Storage object not found: ${id}`);
+        }
+        return file.stream();
+    }
+    async delete(id) {
+        const key = this.keyFor(id);
+        const file = this.client.file(key);
+        await file.delete();
+    }
+    async exists(id) {
+        const key = this.keyFor(id);
+        const file = this.client.file(key);
+        return file.exists();
+    }
+    async signUrl(id, expiresInSeconds) {
+        const key = this.keyFor(id);
+        const file = this.client.file(key);
+        return file.presign({ expiresIn: expiresInSeconds, method: "GET" });
+    }
+    keyFor(id) {
+        return this.basePath ? `${this.basePath}/${id}` : id;
+    }
+}
+exports.S3StorageBackend = S3StorageBackend;
+exports.default = S3StorageBackend;
+//# sourceMappingURL=s3-backend.js.map

package/dist/storage/s3-backend.js.map

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

package/dist/storage/types.d.ts

@@ -0,0 +1,56 @@
+export type StorageId = string;
+export interface StoreOptions {
+    contentType?: string;
+}
+/**
+ * Options for storing an object while preserving an optional human-friendly filename.
+ * This does NOT affect storage identity; ids remain content-addressed.
+ */
+export interface StoreWithNameOptions extends StoreOptions {
+    fileName?: string;
+}
+export interface GetUrlOptions {
+    expiresInSeconds?: number;
+}
+/**
+ * Public storage API exposed to app developers.
+ * Mirrors Convex Storage surface: store, getUrl, open, delete, exists.
+ */
+export interface Storage {
+    store(stream: ReadableStream | Blob | Uint8Array, options?: StoreOptions): Promise<StorageId>;
+    getUrl(id: StorageId, options?: GetUrlOptions): Promise<string>;
+    open(id: StorageId): Promise<ReadableStream>;
+    delete(id: StorageId): Promise<void>;
+    exists(id: StorageId): Promise<boolean>;
+}
+/**
+ * Internal metadata tracked for each stored object.
+ * - size: byte length
+ * - contentType: optional MIME type
+ * - hash: content-addressed SHA-256 hex digest
+ */
+export interface StorageMeta {
+    size: number;
+    contentType?: string;
+    hash: string;
+}
+/**
+ * Backend abstraction to support pluggable storage (FS, S3, etc.).
+ * Implementations must be streaming-capable and content-addressable.
+ */
+export interface StorageBackend {
+    put(id: StorageId, stream: ReadableStream, meta: StorageMeta): Promise<void>;
+    get(id: StorageId): Promise<ReadableStream>;
+    delete(id: StorageId): Promise<void>;
+    exists(id: StorageId): Promise<boolean>;
+    signUrl?(id: StorageId, expiresInSeconds: number): Promise<string>;
+}
+/**
+ * Reference tracking hooks for GC integration.
+ * Implementations are responsible for incrementing/decrementing ref counts.
+ */
+export interface StorageReferenceTracker {
+    trackReference(id: StorageId): Promise<void>;
+    untrackReference(id: StorageId): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,WAAW,YAAY;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACpB,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9F,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChE,IAAI,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7C,MAAM,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3C;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,GAAG,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtE;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACpC,cAAc,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,gBAAgB,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD"}

package/dist/storage/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":""}

package/dist/utils/http.d.ts

@@ -0,0 +1,16 @@
+/**
+ * HTTP utility functions for content disposition and MIME types
+ */
+/**
+ * Create RFC 5987 compliant Content-Disposition header for file downloads
+ * Supports both legacy (filename) and modern (filename*) parameters for browser compatibility
+ * Edge/Chrome require proper encoding, Firefox is more lenient
+ */
+export declare function createContentDisposition(fileName: string): string;
+/**
+ * Get file extension from MIME type
+ * Edge/Chrome need explicit file extensions in Content-Disposition filename
+ * while Firefox can infer from Content-Type header
+ */
+export declare function getExtensionFromMimeType(mimeType?: string): string;
+//# sourceMappingURL=http.d.ts.map

package/dist/utils/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAoClE"}