@fluxpointstudios/orynq-sdk-storage-adapters 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Flux Point Studios
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/adapters/arweave/arweave-adapter.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Arweave Storage Adapter.
+ * Stores data permanently on the Arweave network.
+ */
+import type { StorageAdapter, StorageRef, StorableManifest, ArweaveAdapterConfig } from "../../types.js";
+/**
+ * Storage adapter for Arweave permanent storage.
+ */
+export declare class ArweaveAdapter implements StorageAdapter {
+    readonly type: "arweave";
+    private readonly gateway;
+    private readonly wallet;
+    private readonly timeoutMs;
+    private arweaveClient;
+    constructor(config: ArweaveAdapterConfig);
+    /**
+     * Store data on Arweave.
+     */
+    store(data: Uint8Array): Promise<StorageRef>;
+    /**
+     * Store a manifest on Arweave.
+     */
+    storeManifest(manifest: StorableManifest): Promise<StorageRef>;
+    /**
+     * Fetch data from Arweave.
+     */
+    fetch(ref: StorageRef): Promise<Uint8Array>;
+    /**
+     * Fetch a manifest from Arweave.
+     */
+    fetchManifest(ref: StorageRef): Promise<StorableManifest>;
+    /**
+     * Verify data integrity.
+     */
+    verify(ref: StorageRef): Promise<boolean>;
+    /**
+     * Check if a transaction is confirmed.
+     */
+    isConfirmed(ref: StorageRef): Promise<boolean>;
+    /**
+     * Get the gateway URL for a reference.
+     */
+    getGatewayUrl(ref: StorageRef): string;
+    private getArweaveClient;
+    private uploadData;
+    private extractTxId;
+}
+/**
+ * Create an Arweave storage adapter.
+ */
+export declare function createArweaveAdapter(config?: ArweaveAdapterConfig): ArweaveAdapter;
+//# sourceMappingURL=arweave-adapter.d.ts.map

package/dist/adapters/arweave/arweave-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arweave-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/arweave/arweave-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EAErB,MAAM,gBAAgB,CAAC;AAyBxB;;GAEG;AACH,qBAAa,cAAe,YAAW,cAAc;IACnD,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,OAAO,CAAC,aAAa,CAA4B;gBAErC,MAAM,EAAE,oBAAoB;IAMxC;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAsBlD;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IA0BpE;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAmCjD;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAe/D;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAU/C;;OAEG;IACG,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAYpD;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM;YAOxB,gBAAgB;YA0BhB,UAAU;IAqCxB,OAAO,CAAC,WAAW;CAcpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,oBAAyB,GAAG,cAAc,CAEtF"}

package/dist/adapters/arweave/arweave-adapter.js

@@ -0,0 +1,200 @@
+/**
+ * Arweave Storage Adapter.
+ * Stores data permanently on the Arweave network.
+ */
+import { StorageError, StorageException } from "../../types.js";
+import { sha256 } from "../../utils/content-addressing.js";
+/**
+ * Storage adapter for Arweave permanent storage.
+ */
+export class ArweaveAdapter {
+    type = "arweave";
+    gateway;
+    wallet;
+    timeoutMs;
+    arweaveClient;
+    constructor(config) {
+        this.gateway = config.gateway ?? "https://arweave.net";
+        this.wallet = config.wallet;
+        this.timeoutMs = config.timeoutMs ?? 60000;
+    }
+    /**
+     * Store data on Arweave.
+     */
+    async store(data) {
+        if (!this.wallet) {
+            throw new StorageException(StorageError.INVALID_CONFIG, "Arweave wallet required for storing data");
+        }
+        const hash = sha256(data, "chunk");
+        const txId = await this.uploadData(data, [
+            { name: "Content-Type", value: "application/octet-stream" },
+            { name: "poi-hash", value: hash },
+        ]);
+        return {
+            type: "arweave",
+            uri: `ar://${txId}`,
+            hash,
+            size: data.length,
+        };
+    }
+    /**
+     * Store a manifest on Arweave.
+     */
+    async storeManifest(manifest) {
+        if (!this.wallet) {
+            throw new StorageException(StorageError.INVALID_CONFIG, "Arweave wallet required for storing data");
+        }
+        const json = JSON.stringify(manifest, null, 2);
+        const data = new TextEncoder().encode(json);
+        const hash = manifest.manifestHash ?? sha256(data, "manifest");
+        const txId = await this.uploadData(data, [
+            { name: "Content-Type", value: "application/json" },
+            { name: "poi-hash", value: hash },
+            { name: "poi-session", value: manifest.sessionId },
+        ]);
+        return {
+            type: "arweave",
+            uri: `ar://${txId}`,
+            hash,
+            size: data.length,
+        };
+    }
+    /**
+     * Fetch data from Arweave.
+     */
+    async fetch(ref) {
+        const txId = this.extractTxId(ref.uri);
+        try {
+            // Try gateway first for faster access
+            const response = await fetch(`${this.gateway}/${txId}`, {
+                signal: AbortSignal.timeout(this.timeoutMs),
+            });
+            if (!response.ok) {
+                throw new Error(`Gateway fetch failed: ${response.status}`);
+            }
+            const buffer = await response.arrayBuffer();
+            return new Uint8Array(buffer);
+        }
+        catch (error) {
+            // Fall back to Arweave client
+            try {
+                const client = await this.getArweaveClient();
+                const data = await client.transactions.getData(txId, { decode: true });
+                if (typeof data === "string") {
+                    return new TextEncoder().encode(data);
+                }
+                return data;
+            }
+            catch (clientError) {
+                throw new StorageException(StorageError.FETCH_FAILED, `Failed to fetch from Arweave: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined);
+            }
+        }
+    }
+    /**
+     * Fetch a manifest from Arweave.
+     */
+    async fetchManifest(ref) {
+        const data = await this.fetch(ref);
+        const json = new TextDecoder().decode(data);
+        try {
+            return JSON.parse(json);
+        }
+        catch (error) {
+            throw new StorageException(StorageError.FETCH_FAILED, "Failed to parse manifest JSON", error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Verify data integrity.
+     */
+    async verify(ref) {
+        try {
+            const data = await this.fetch(ref);
+            const hash = sha256(data, "chunk");
+            return hash === ref.hash;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if a transaction is confirmed.
+     */
+    async isConfirmed(ref) {
+        const txId = this.extractTxId(ref.uri);
+        try {
+            const client = await this.getArweaveClient();
+            const status = await client.transactions.getStatus(txId);
+            return status.confirmed !== null;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get the gateway URL for a reference.
+     */
+    getGatewayUrl(ref) {
+        const txId = this.extractTxId(ref.uri);
+        return `${this.gateway}/${txId}`;
+    }
+    // === Private Methods ===
+    async getArweaveClient() {
+        if (this.arweaveClient) {
+            return this.arweaveClient;
+        }
+        try {
+            const ArweaveLib = await import("arweave");
+            const Arweave = ArweaveLib.default;
+            const gatewayUrl = new URL(this.gateway);
+            this.arweaveClient = Arweave.init({
+                host: gatewayUrl.hostname,
+                port: gatewayUrl.port ? parseInt(gatewayUrl.port, 10) : 443,
+                protocol: gatewayUrl.protocol.replace(":", ""),
+            });
+            return this.arweaveClient;
+        }
+        catch (error) {
+            throw new StorageException(StorageError.INVALID_CONFIG, "Arweave library not available. Install arweave to use Arweave adapter.", error instanceof Error ? error : undefined);
+        }
+    }
+    async uploadData(data, tags) {
+        if (!this.wallet) {
+            throw new StorageException(StorageError.INVALID_CONFIG, "Arweave wallet required");
+        }
+        const client = await this.getArweaveClient();
+        try {
+            const tx = await client.createTransaction({ data }, this.wallet);
+            for (const tag of tags) {
+                tx.addTag(tag.name, tag.value);
+            }
+            await client.transactions.sign(tx, this.wallet);
+            const response = await client.transactions.post(tx);
+            if (response.status !== 200 && response.status !== 202) {
+                throw new Error(`Transaction post failed: ${response.status}`);
+            }
+            return tx.id;
+        }
+        catch (error) {
+            throw new StorageException(StorageError.STORE_FAILED, `Arweave upload failed: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined);
+        }
+    }
+    extractTxId(uri) {
+        // ar://txid
+        if (uri.startsWith("ar://")) {
+            return uri.slice(5);
+        }
+        // https://arweave.net/txid
+        const match = uri.match(/arweave\.net\/(\w+)/);
+        if (match?.[1]) {
+            return match[1];
+        }
+        return uri;
+    }
+}
+/**
+ * Create an Arweave storage adapter.
+ */
+export function createArweaveAdapter(config = {}) {
+    return new ArweaveAdapter(config);
+}
+//# sourceMappingURL=arweave-adapter.js.map

package/dist/adapters/arweave/arweave-adapter.js.map

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

package/dist/adapters/arweave/index.d.ts

@@ -0,0 +1,2 @@
+export { ArweaveAdapter, createArweaveAdapter } from "./arweave-adapter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/arweave/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/arweave/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/adapters/arweave/index.js

@@ -0,0 +1,2 @@
+export { ArweaveAdapter, createArweaveAdapter } from "./arweave-adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/arweave/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/arweave/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/adapters/ipfs/index.d.ts

@@ -0,0 +1,3 @@
+export { IpfsAdapter, createIpfsAdapter } from "./ipfs-adapter.js";
+export { type PinningService, PinataPinningService, InfuraPinningService, Web3StoragePinningService, createPinningService, } from "./pinning-service.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/ipfs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/ipfs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EACL,KAAK,cAAc,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC"}

package/dist/adapters/ipfs/index.js

@@ -0,0 +1,3 @@
+export { IpfsAdapter, createIpfsAdapter } from "./ipfs-adapter.js";
+export { PinataPinningService, InfuraPinningService, Web3StoragePinningService, createPinningService, } from "./pinning-service.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/ipfs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/ipfs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAEL,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC"}

package/dist/adapters/ipfs/ipfs-adapter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * IPFS Storage Adapter.
+ * Stores data on IPFS with optional pinning service integration.
+ */
+import type { StorageAdapter, StorageRef, StorableManifest, IpfsAdapterConfig } from "../../types.js";
+/**
+ * Storage adapter for IPFS.
+ */
+export declare class IpfsAdapter implements StorageAdapter {
+    readonly type: "ipfs";
+    private readonly gateway;
+    private readonly apiEndpoint;
+    private readonly timeoutMs;
+    private readonly pinningService;
+    constructor(config: IpfsAdapterConfig);
+    /**
+     * Store data on IPFS.
+     */
+    store(data: Uint8Array): Promise<StorageRef>;
+    /**
+     * Store a manifest on IPFS.
+     */
+    storeManifest(manifest: StorableManifest): Promise<StorageRef>;
+    /**
+     * Fetch data from IPFS.
+     */
+    fetch(ref: StorageRef): Promise<Uint8Array>;
+    /**
+     * Fetch a manifest from IPFS.
+     */
+    fetchManifest(ref: StorageRef): Promise<StorableManifest>;
+    /**
+     * Verify data integrity.
+     */
+    verify(ref: StorageRef): Promise<boolean>;
+    /**
+     * Pin data on IPFS (via pinning service if configured).
+     */
+    pin(ref: StorageRef): Promise<void>;
+    /**
+     * Get the gateway URL for a reference.
+     */
+    getGatewayUrl(ref: StorageRef): string;
+    private addToIpfs;
+    private extractCid;
+}
+/**
+ * Create an IPFS storage adapter.
+ */
+export declare function createIpfsAdapter(config: IpfsAdapterConfig): IpfsAdapter;
+//# sourceMappingURL=ipfs-adapter.d.ts.map

package/dist/adapters/ipfs/ipfs-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipfs-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/ipfs/ipfs-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAcxB;;GAEG;AACH,qBAAa,WAAY,YAAW,cAAc;IAChD,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;gBAEhD,MAAM,EAAE,iBAAiB;IAUrC;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAYlD;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAcpE;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IA2BjD;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAe/D;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAU/C;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCzC;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM;YAOxB,SAAS;IA4CvB,OAAO,CAAC,UAAU;CAenB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAExE"}

package/dist/adapters/ipfs/ipfs-adapter.js

@@ -0,0 +1,186 @@
+/**
+ * IPFS Storage Adapter.
+ * Stores data on IPFS with optional pinning service integration.
+ */
+import { StorageError, StorageException } from "../../types.js";
+import { sha256 } from "../../utils/content-addressing.js";
+import { createPinningService } from "./pinning-service.js";
+/**
+ * Storage adapter for IPFS.
+ */
+export class IpfsAdapter {
+    type = "ipfs";
+    gateway;
+    apiEndpoint;
+    timeoutMs;
+    pinningService;
+    constructor(config) {
+        this.gateway = config.gateway.replace(/\/$/, "");
+        this.apiEndpoint = config.apiEndpoint?.replace(/\/$/, "");
+        this.timeoutMs = config.timeoutMs ?? 30000;
+        if (config.pinningService) {
+            this.pinningService = createPinningService(config.pinningService);
+        }
+    }
+    /**
+     * Store data on IPFS.
+     */
+    async store(data) {
+        const cid = await this.addToIpfs(data);
+        const hash = sha256(data, "chunk");
+        return {
+            type: "ipfs",
+            uri: `ipfs://${cid}`,
+            hash,
+            size: data.length,
+        };
+    }
+    /**
+     * Store a manifest on IPFS.
+     */
+    async storeManifest(manifest) {
+        const json = JSON.stringify(manifest, null, 2);
+        const data = new TextEncoder().encode(json);
+        const cid = await this.addToIpfs(data, `${manifest.sessionId}.json`);
+        const hash = manifest.manifestHash ?? sha256(data, "manifest");
+        return {
+            type: "ipfs",
+            uri: `ipfs://${cid}`,
+            hash,
+            size: data.length,
+        };
+    }
+    /**
+     * Fetch data from IPFS.
+     */
+    async fetch(ref) {
+        const cid = this.extractCid(ref.uri);
+        try {
+            const response = await fetch(`${this.gateway}/ipfs/${cid}`, {
+                signal: AbortSignal.timeout(this.timeoutMs),
+            });
+            if (!response.ok) {
+                throw new StorageException(StorageError.FETCH_FAILED, `Failed to fetch from IPFS: ${response.status} ${response.statusText}`);
+            }
+            const buffer = await response.arrayBuffer();
+            return new Uint8Array(buffer);
+        }
+        catch (error) {
+            if (error instanceof StorageException)
+                throw error;
+            throw new StorageException(StorageError.FETCH_FAILED, `Failed to fetch from IPFS: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Fetch a manifest from IPFS.
+     */
+    async fetchManifest(ref) {
+        const data = await this.fetch(ref);
+        const json = new TextDecoder().decode(data);
+        try {
+            return JSON.parse(json);
+        }
+        catch (error) {
+            throw new StorageException(StorageError.FETCH_FAILED, "Failed to parse manifest JSON", error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Verify data integrity.
+     */
+    async verify(ref) {
+        try {
+            const data = await this.fetch(ref);
+            const hash = sha256(data, "chunk");
+            return hash === ref.hash;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Pin data on IPFS (via pinning service if configured).
+     */
+    async pin(ref) {
+        const cid = this.extractCid(ref.uri);
+        if (this.pinningService) {
+            await this.pinningService.pin(cid);
+            return;
+        }
+        // Pin via local IPFS node
+        if (this.apiEndpoint) {
+            try {
+                const response = await fetch(`${this.apiEndpoint}/api/v0/pin/add?arg=${cid}`, {
+                    method: "POST",
+                    signal: AbortSignal.timeout(this.timeoutMs),
+                });
+                if (!response.ok) {
+                    throw new Error(`Pin failed: ${response.status}`);
+                }
+            }
+            catch (error) {
+                throw new StorageException(StorageError.PIN_FAILED, `Failed to pin CID ${cid}`, error instanceof Error ? error : undefined);
+            }
+        }
+    }
+    /**
+     * Get the gateway URL for a reference.
+     */
+    getGatewayUrl(ref) {
+        const cid = this.extractCid(ref.uri);
+        return `${this.gateway}/ipfs/${cid}`;
+    }
+    // === Private Methods ===
+    async addToIpfs(data, filename) {
+        // Try pinning service first
+        if (this.pinningService) {
+            return this.pinningService.upload(data, filename);
+        }
+        // Fall back to local IPFS node
+        if (!this.apiEndpoint) {
+            throw new StorageException(StorageError.INVALID_CONFIG, "No IPFS API endpoint or pinning service configured");
+        }
+        try {
+            const formData = new FormData();
+            // Create a new ArrayBuffer to ensure type compatibility
+            const buffer = new ArrayBuffer(data.byteLength);
+            new Uint8Array(buffer).set(data);
+            const blob = new Blob([buffer]);
+            formData.append("file", blob, filename ?? "data.bin");
+            const response = await fetch(`${this.apiEndpoint}/api/v0/add`, {
+                method: "POST",
+                body: formData,
+                signal: AbortSignal.timeout(this.timeoutMs),
+            });
+            if (!response.ok) {
+                throw new Error(`IPFS add failed: ${response.status}`);
+            }
+            const result = await response.json();
+            return result.Hash;
+        }
+        catch (error) {
+            if (error instanceof StorageException)
+                throw error;
+            throw new StorageException(StorageError.STORE_FAILED, `Failed to store on IPFS: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined);
+        }
+    }
+    extractCid(uri) {
+        // Handle ipfs:// URIs
+        if (uri.startsWith("ipfs://")) {
+            return uri.slice(7);
+        }
+        // Handle /ipfs/ paths
+        const match = uri.match(/\/ipfs\/(\w+)/);
+        if (match?.[1]) {
+            return match[1];
+        }
+        // Assume it's a raw CID
+        return uri;
+    }
+}
+/**
+ * Create an IPFS storage adapter.
+ */
+export function createIpfsAdapter(config) {
+    return new IpfsAdapter(config);
+}
+//# sourceMappingURL=ipfs-adapter.js.map

package/dist/adapters/ipfs/ipfs-adapter.js.map

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

package/dist/adapters/ipfs/pinning-service.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Pinning service integrations for IPFS.
+ * Supports Pinata, Infura, and web3.storage.
+ */
+import type { PinningServiceConfig } from "../../types.js";
+/**
+ * Abstract pinning service interface.
+ */
+export interface PinningService {
+    /**
+     * Upload data and return CID.
+     */
+    upload(data: Uint8Array, filename?: string): Promise<string>;
+    /**
+     * Pin an existing CID.
+     */
+    pin(cid: string): Promise<void>;
+    /**
+     * Unpin a CID.
+     */
+    unpin?(cid: string): Promise<void>;
+    /**
+     * Check if a CID is pinned.
+     */
+    isPinned?(cid: string): Promise<boolean>;
+}
+/**
+ * Pinata pinning service.
+ */
+export declare class PinataPinningService implements PinningService {
+    private readonly apiKey;
+    private readonly apiSecret;
+    private readonly endpoint;
+    constructor(config: PinningServiceConfig);
+    upload(data: Uint8Array, filename?: string): Promise<string>;
+    pin(cid: string): Promise<void>;
+    unpin(cid: string): Promise<void>;
+    isPinned(cid: string): Promise<boolean>;
+    private getAuthHeaders;
+}
+/**
+ * Infura IPFS pinning service.
+ */
+export declare class InfuraPinningService implements PinningService {
+    private readonly projectId;
+    private readonly projectSecret;
+    private readonly endpoint;
+    constructor(config: PinningServiceConfig);
+    upload(data: Uint8Array, filename?: string): Promise<string>;
+    pin(cid: string): Promise<void>;
+    unpin(cid: string): Promise<void>;
+    private getAuthHeaders;
+}
+/**
+ * web3.storage pinning service.
+ */
+export declare class Web3StoragePinningService implements PinningService {
+    private readonly token;
+    private readonly endpoint;
+    constructor(config: PinningServiceConfig);
+    upload(data: Uint8Array, filename?: string): Promise<string>;
+    pin(cid: string): Promise<void>;
+}
+/**
+ * Create a pinning service based on configuration.
+ */
+export declare function createPinningService(config: PinningServiceConfig): PinningService;
+//# sourceMappingURL=pinning-service.d.ts.map

package/dist/adapters/ipfs/pinning-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinning-service.d.ts","sourceRoot":"","sources":["../../../src/adapters/ipfs/pinning-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAG3D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7D;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;OAEG;IACH,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,MAAM,EAAE,oBAAoB;IAMlC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA+B5D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB/B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBjC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB7C,OAAO,CAAC,cAAc;CAWvB;AAED;;GAEG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,MAAM,EAAE,oBAAoB;IAMlC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA8B5D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB/B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBvC,OAAO,CAAC,cAAc;CASvB;AAED;;GAEG;AACH,qBAAa,yBAA0B,YAAW,cAAc;IAC9D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,MAAM,EAAE,oBAAoB;IAKlC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA8B5D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAyBtC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAmBjF"}