@decaf-ts/integrations 0.1.3 → 0.1.4

package/lib/cjs/blob/ipfs/IpfsBlobStoreService.cjs

@@ -0,0 +1,182 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IpfsBlobStoreService = void 0;
+/**
+ * @module integrations/blob/ipfs/service
+ * @summary IPFS blob store service.
+ * @description Blob store backed by an IPFS (Kubo) node. Because the blob API is key/value CRUD-like
+ * and IPFS is content-addressed, an IpfsKeyIndex maps logical keys to CIDs.
+ */
+const kubo_rpc_client_1 = require("kubo-rpc-client");
+const core_1 = require("@decaf-ts/core");
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+const BlobStoreService_js_1 = require("./../core/BlobStoreService.cjs");
+const BlobValue_js_1 = require("./../core/BlobValue.cjs");
+const IpfsKeyIndex_js_1 = require("./IpfsKeyIndex.cjs");
+class IpfsBlobStoreService extends BlobStoreService_js_1.BlobStoreService {
+    async initialize(...args) {
+        const { log } = (await this.logCtx(args, "initialize", true)).for(this.initialize);
+        const config = this.getConfigFromArgs(...args);
+        const apiUrl = config.apiUrl || "http://localhost:5001";
+        const client = (0, kubo_rpc_client_1.create)({ url: apiUrl });
+        this.index = (0, IpfsKeyIndex_js_1.createIpfsKeyIndex)(config.keyIndex);
+        this._config = config;
+        this._client = client;
+        log.verbose(`Initialized IPFS blob store ${config.sourceId}`);
+        return { config, client };
+    }
+    async put(key, value, options = {}, ...args) {
+        const { log } = (await this.logCtx(args, "put", true)).for(this.put);
+        log.verbose(`Putting blob ${key}`);
+        const physicalKey = this.physicalKey(key);
+        if (this.config.encryptedOnly && options.metadata?.encrypted !== "true") {
+            throw new db_decorators_1.ValidationError("IPFS blob store requires encrypted payloads");
+        }
+        if (options.ifNotExists && (await this.has(key))) {
+            throw new db_decorators_1.ConflictError(`Blob already exists: ${key}`);
+        }
+        const buffer = await (0, BlobValue_js_1.collectToBuffer)(value);
+        if (options.expectedSha256) {
+            const sha256 = await (0, BlobValue_js_1.computeSha256)(buffer);
+            if (options.expectedSha256 !== sha256) {
+                throw new db_decorators_1.ValidationError(`Checksum mismatch for ${key}`);
+            }
+        }
+        try {
+            const addResult = await this.client.add(buffer);
+            const cid = addResult.cid.toString();
+            const size = addResult.size;
+            if (this.config.pinByDefault !== false) {
+                try {
+                    await this.client.pin.add(cid);
+                }
+                catch (e) {
+                    log.silly(`Pin failed for ${cid}: ${e.message}`);
+                }
+            }
+            const metadata = {
+                contentLength: size,
+                sha256: undefined,
+                cid,
+                contentType: options.contentType,
+                custom: options.metadata,
+            };
+            await this.index.set(physicalKey, cid, metadata);
+            return {
+                key,
+                uri: `ipfs://${cid}`,
+                provider: this.provider,
+                sourceId: this.sourceId,
+                metadata,
+            };
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+    }
+    async get(key, options = {}, ...args) {
+        const { log } = (await this.logCtx(args, "get", true)).for(this.get);
+        log.verbose(`Getting blob ${key}`);
+        const physicalKey = this.physicalKey(key);
+        const cid = await this.index.get(physicalKey);
+        if (!cid) {
+            throw new db_decorators_1.NotFoundError(`Blob not found: ${key}`);
+        }
+        const metadata = await this.index.stat(physicalKey);
+        const catIterable = this.client.cat(cid);
+        void options;
+        return {
+            key,
+            value: (0, BlobValue_js_1.toAsyncIterable)(catIterable),
+            uri: `ipfs://${cid}`,
+            provider: this.provider,
+            sourceId: this.sourceId,
+            metadata,
+        };
+    }
+    async has(key, ...args) {
+        const { log } = (await this.logCtx(args, "has", true)).for(this.has);
+        log.verbose(`Checking blob ${key}`);
+        const physicalKey = this.physicalKey(key);
+        return Boolean(await this.index.get(physicalKey));
+    }
+    async stat(key, ...args) {
+        const { log } = (await this.logCtx(args, "stat", true)).for(this.stat);
+        log.verbose(`Statting blob ${key}`);
+        const physicalKey = this.physicalKey(key);
+        try {
+            return await this.index.stat(physicalKey);
+        }
+        catch {
+            throw new db_decorators_1.NotFoundError(`Blob not found: ${key}`);
+        }
+    }
+    async delete(key, ...args) {
+        const { log } = (await this.logCtx(args, "delete", true)).for(this.delete);
+        log.verbose(`Deleting blob ${key}`);
+        const physicalKey = this.physicalKey(key);
+        const cid = await this.index.get(physicalKey);
+        if (cid) {
+            try {
+                await this.client.pin.rm(cid);
+            }
+            catch (e) {
+                log.silly(`Unpin failed for ${cid}: ${e.message}`);
+            }
+        }
+        await this.index.delete(physicalKey);
+    }
+    async copy(fromKey, toKey, options = {}, ...args) {
+        const { log } = (await this.logCtx(args, "copy", true)).for(this.copy);
+        log.verbose(`Copying blob ${fromKey} to ${toKey}`);
+        const source = await this.get(fromKey);
+        return this.put(toKey, source.value, options);
+    }
+    async list(options = {}, ...args) {
+        const { log } = (await this.logCtx(args, "list", true)).for(this.list);
+        log.verbose("Listing blobs");
+        const prefix = options.prefix ? this.physicalKey(options.prefix) : undefined;
+        return this.index.list(prefix, options.limit, options.cursor);
+    }
+    async url(key, options = {}, ...args) {
+        const { log } = (await this.logCtx(args, "url", true)).for(this.url);
+        log.verbose(`Building url for blob ${key}`);
+        if (options.operation && options.operation !== "get") {
+            throw new core_1.UnsupportedError("IPFS does not support PUT urls through this API");
+        }
+        const physicalKey = this.physicalKey(key);
+        const cid = await this.index.get(physicalKey);
+        if (!cid) {
+            throw new db_decorators_1.NotFoundError(`Blob not found: ${key}`);
+        }
+        if (!this.config.gatewayUrl) {
+            throw new core_1.UnsupportedError("No IPFS gateway configured");
+        }
+        return {
+            url: `${this.config.gatewayUrl.replace(/\/$/, "")}/ipfs/${cid}`,
+            method: "GET",
+            expiresAt: new Date(Date.now() + (options.expiresInSeconds ?? 300) * 1000),
+        };
+    }
+    parseError(error) {
+        const err = error;
+        if (err instanceof db_decorators_1.NotFoundError ||
+            err instanceof db_decorators_1.ConflictError ||
+            err instanceof db_decorators_1.ValidationError ||
+            err instanceof db_decorators_1.InternalError) {
+            return err;
+        }
+        const message = err.message || "Unknown error";
+        const lower = message.toLowerCase();
+        if (lower.includes("not found") || lower.includes("does not exist")) {
+            return new db_decorators_1.NotFoundError(err);
+        }
+        if (lower.includes("already exists") || lower.includes("conflict")) {
+            return new db_decorators_1.ConflictError(err);
+        }
+        return new db_decorators_1.InternalError(`IPFS error: ${message}`);
+    }
+}
+exports.IpfsBlobStoreService = IpfsBlobStoreService;
+//# sourceMappingURL=IpfsBlobStoreService.js.map
+//# sourceMappingURL=IpfsBlobStoreService.cjs.map

package/lib/cjs/blob/ipfs/IpfsBlobStoreService.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob/ipfs/IpfsBlobStoreService.cjs","sourceRoot":"","sources":["blob/ipfs/IpfsBlobStoreService.js"],"names":[],"mappings":"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"}

package/lib/cjs/blob/ipfs/IpfsKeyIndex.cjs

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createIpfsKeyIndex = createIpfsKeyIndex;
+/**
+ * @module integrations/blob/ipfs/key-index
+ * @summary IPFS key index abstraction.
+ * @description Maps logical blob keys to content-addressed CIDs since the blob API is key/value CRUD-like
+ * while IPFS is content-addressed.
+ */
+const core_1 = require("@decaf-ts/core");
+const MemoryIpfsKeyIndex_js_1 = require("./MemoryIpfsKeyIndex.cjs");
+const PostgresIpfsKeyIndex_js_1 = require("./PostgresIpfsKeyIndex.cjs");
+const LocalJsonIpfsKeyIndex_js_1 = require("./LocalJsonIpfsKeyIndex.cjs");
+function createIpfsKeyIndex(config) {
+    switch (config.provider) {
+        case "memory":
+            return new MemoryIpfsKeyIndex_js_1.MemoryIpfsKeyIndex();
+        case "postgres":
+            return new PostgresIpfsKeyIndex_js_1.PostgresIpfsKeyIndex(config.connectionRef);
+        case "local-json":
+            return new LocalJsonIpfsKeyIndex_js_1.LocalJsonIpfsKeyIndex(config.path);
+        default:
+            throw new core_1.UnsupportedError(`Unsupported IPFS key index provider: ${config.provider}`);
+    }
+}
+//# sourceMappingURL=IpfsKeyIndex.js.map
+//# sourceMappingURL=IpfsKeyIndex.cjs.map

package/lib/cjs/blob/ipfs/IpfsKeyIndex.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob/ipfs/IpfsKeyIndex.cjs","sourceRoot":"","sources":["blob/ipfs/IpfsKeyIndex.js"],"names":[],"mappings":";;AAUA,gDAWC;AArBD;;;;;GAKG;AACH,yCAAkD;AAClD,mEAA6D;AAC7D,uEAAiE;AACjE,yEAAmE;AACnE,SAAgB,kBAAkB,CAAC,MAAM;IACrC,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtB,KAAK,QAAQ;YACT,OAAO,IAAI,0CAAkB,EAAE,CAAC;QACpC,KAAK,UAAU;YACX,OAAO,IAAI,8CAAoB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAC1D,KAAK,YAAY;YACb,OAAO,IAAI,gDAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClD;YACI,MAAM,IAAI,uBAAgB,CAAC,wCAAwC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9F,CAAC;AACL,CAAC;AACD,wCAAwC"}

package/lib/cjs/blob/ipfs/LocalJsonIpfsKeyIndex.cjs

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalJsonIpfsKeyIndex = void 0;
+/**
+ * @module integrations/blob/ipfs/local-json-index
+ * @summary Local JSON-file-backed IPFS key index (stub).
+ * @description Documented placeholder; full file implementation is deferred per the spec.
+ */
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+class LocalJsonIpfsKeyIndex {
+    constructor(path) {
+        this.path = path;
+        if (!path) {
+            throw new db_decorators_1.InternalError("LocalJsonIpfsKeyIndex requires a path");
+        }
+    }
+    async get(key) {
+        throw new db_decorators_1.InternalError(`Implement local JSON IPFS key lookup for ${key} at ${this.path}`);
+    }
+    async set(key, cid, metadata) {
+        throw new db_decorators_1.InternalError(`Implement local JSON IPFS key set for ${key} (cid=${cid}, metadata=${JSON.stringify(metadata)}) at ${this.path}`);
+    }
+    async delete(key) {
+        throw new db_decorators_1.InternalError(`Implement local JSON IPFS key delete for ${key} at ${this.path}`);
+    }
+    async list(prefix, limit, cursor) {
+        throw new db_decorators_1.InternalError(`Implement local JSON IPFS key list (prefix=${prefix}, limit=${limit}, cursor=${cursor}) at ${this.path}`);
+    }
+    async stat(key) {
+        throw new db_decorators_1.InternalError(`Implement local JSON IPFS key stat for ${key} at ${this.path}`);
+    }
+}
+exports.LocalJsonIpfsKeyIndex = LocalJsonIpfsKeyIndex;
+//# sourceMappingURL=LocalJsonIpfsKeyIndex.js.map
+//# sourceMappingURL=LocalJsonIpfsKeyIndex.cjs.map

package/lib/cjs/blob/ipfs/LocalJsonIpfsKeyIndex.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob/ipfs/LocalJsonIpfsKeyIndex.cjs","sourceRoot":"","sources":["blob/ipfs/LocalJsonIpfsKeyIndex.js"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,2DAAwD;AACxD,MAAa,qBAAqB;IAC9B,YAAY,IAAI;QACZ,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,MAAM,IAAI,6BAAa,CAAC,uCAAuC,CAAC,CAAC;QACrE,CAAC;IACL,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,GAAG;QACT,MAAM,IAAI,6BAAa,CAAC,4CAA4C,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ;QACxB,MAAM,IAAI,6BAAa,CAAC,yCAAyC,GAAG,SAAS,GAAG,cAAc,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/I,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,GAAG;QACZ,MAAM,IAAI,6BAAa,CAAC,4CAA4C,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM;QAC5B,MAAM,IAAI,6BAAa,CAAC,8CAA8C,MAAM,WAAW,KAAK,YAAY,MAAM,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACvI,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAG;QACV,MAAM,IAAI,6BAAa,CAAC,0CAA0C,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7F,CAAC;CACJ;AAtBD,sDAsBC;AACD,iDAAiD"}

package/lib/cjs/blob/ipfs/MemoryIpfsKeyIndex.cjs

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryIpfsKeyIndex = void 0;
+class MemoryIpfsKeyIndex {
+    constructor() {
+        this.values = new Map();
+    }
+    async get(key) {
+        return this.values.get(key)?.cid;
+    }
+    async set(key, cid, metadata) {
+        this.values.set(key, {
+            cid,
+            metadata: { ...metadata, cid },
+        });
+    }
+    async delete(key) {
+        this.values.delete(key);
+    }
+    async list(prefix = "", limit = 1000, cursor) {
+        const all = Array.from(this.values.keys())
+            .filter((k) => (prefix ? k.startsWith(prefix) : true))
+            .sort();
+        const startIndex = cursor ? Number(cursor) : 0;
+        const slice = all.slice(startIndex, startIndex + limit);
+        const nextCursor = startIndex + limit < all.length ? String(startIndex + limit) : undefined;
+        return {
+            items: slice.map((key) => ({
+                key,
+                metadata: this.values.get(key)?.metadata,
+            })),
+            cursor: nextCursor,
+        };
+    }
+    async stat(key) {
+        const entry = this.values.get(key);
+        if (!entry) {
+            throw new Error(`Blob not found: ${key}`);
+        }
+        return entry.metadata;
+    }
+}
+exports.MemoryIpfsKeyIndex = MemoryIpfsKeyIndex;
+//# sourceMappingURL=MemoryIpfsKeyIndex.js.map
+//# sourceMappingURL=MemoryIpfsKeyIndex.cjs.map

package/lib/cjs/blob/ipfs/MemoryIpfsKeyIndex.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob/ipfs/MemoryIpfsKeyIndex.cjs","sourceRoot":"","sources":["blob/ipfs/MemoryIpfsKeyIndex.js"],"names":[],"mappings":";;;AAAA,MAAa,kBAAkB;IAC3B;QACI,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;IAC5B,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,GAAG;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;IACrC,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ;QACxB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;YACjB,GAAG;YACH,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE;SACjC,CAAC,CAAC;IACP,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,GAAG;QACZ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM;QACxC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;aACrC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aACrD,IAAI,EAAE,CAAC;QACZ,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,GAAG,KAAK,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,UAAU,GAAG,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5F,OAAO;YACH,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACvB,GAAG;gBACH,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ;aAC3C,CAAC,CAAC;YACH,MAAM,EAAE,UAAU;SACrB,CAAC;IACN,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAG;QACV,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,KAAK,CAAC,QAAQ,CAAC;IAC1B,CAAC;CACJ;AAtCD,gDAsCC;AACD,8CAA8C"}

package/lib/cjs/blob/ipfs/PostgresIpfsKeyIndex.cjs

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresIpfsKeyIndex = void 0;
+/**
+ * @module integrations/blob/ipfs/postgres-index
+ * @summary Postgres-backed IPFS key index (stub).
+ * @description Documented placeholder; full SQL implementation is deferred per the spec.
+ */
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+class PostgresIpfsKeyIndex {
+    constructor(connectionRef) {
+        this.connectionRef = connectionRef;
+        if (!connectionRef) {
+            throw new db_decorators_1.InternalError("PostgresIpfsKeyIndex requires a connectionRef");
+        }
+    }
+    async get(key) {
+        throw new db_decorators_1.InternalError(`Implement Postgres IPFS key lookup for ${key}`);
+    }
+    async set(key, cid, metadata) {
+        throw new db_decorators_1.InternalError(`Implement Postgres IPFS key set for ${key} (cid=${cid}, metadata=${JSON.stringify(metadata)})`);
+    }
+    async delete(key) {
+        throw new db_decorators_1.InternalError(`Implement Postgres IPFS key delete for ${key}`);
+    }
+    async list(prefix, limit, cursor) {
+        throw new db_decorators_1.InternalError(`Implement Postgres IPFS key list (prefix=${prefix}, limit=${limit}, cursor=${cursor})`);
+    }
+    async stat(key) {
+        throw new db_decorators_1.InternalError(`Implement Postgres IPFS key stat for ${key}`);
+    }
+}
+exports.PostgresIpfsKeyIndex = PostgresIpfsKeyIndex;
+//# sourceMappingURL=PostgresIpfsKeyIndex.js.map
+//# sourceMappingURL=PostgresIpfsKeyIndex.cjs.map

package/lib/cjs/blob/ipfs/PostgresIpfsKeyIndex.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob/ipfs/PostgresIpfsKeyIndex.cjs","sourceRoot":"","sources":["blob/ipfs/PostgresIpfsKeyIndex.js"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,2DAAwD;AACxD,MAAa,oBAAoB;IAC7B,YAAY,aAAa;QACrB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,aAAa,EAAE,CAAC;YACjB,MAAM,IAAI,6BAAa,CAAC,+CAA+C,CAAC,CAAC;QAC7E,CAAC;IACL,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,GAAG;QACT,MAAM,IAAI,6BAAa,CAAC,0CAA0C,GAAG,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ;QACxB,MAAM,IAAI,6BAAa,CAAC,uCAAuC,GAAG,SAAS,GAAG,cAAc,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7H,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,GAAG;QACZ,MAAM,IAAI,6BAAa,CAAC,0CAA0C,GAAG,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM;QAC5B,MAAM,IAAI,6BAAa,CAAC,4CAA4C,MAAM,WAAW,KAAK,YAAY,MAAM,GAAG,CAAC,CAAC;IACrH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAG;QACV,MAAM,IAAI,6BAAa,CAAC,wCAAwC,GAAG,EAAE,CAAC,CAAC;IAC3E,CAAC;CACJ;AAtBD,oDAsBC;AACD,gDAAgD"}

package/lib/cjs/blob/ipfs/index.cjs

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @module integrations/blob/ipfs
+ * @summary IPFS blob store exports.
+ * @description Re-exports the IPFS blob store service and key-index abstraction.
+ */
+__exportStar(require("./IpfsBlobStoreService.cjs"), exports);
+__exportStar(require("./IpfsKeyIndex.cjs"), exports);
+__exportStar(require("./MemoryIpfsKeyIndex.cjs"), exports);
+__exportStar(require("./PostgresIpfsKeyIndex.cjs"), exports);
+__exportStar(require("./LocalJsonIpfsKeyIndex.cjs"), exports);
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map

package/lib/cjs/blob/ipfs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob/ipfs/index.cjs","sourceRoot":"","sources":["blob/ipfs/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;GAIG;AACH,4DAA0C;AAC1C,oDAAkC;AAClC,0DAAwC;AACxC,4DAA0C;AAC1C,6DAA2C;AAC3C,iCAAiC"}