@fluxpointstudios/orynq-sdk-storage-adapters 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * PoI Storage Adapters
+ *
+ * Content-addressed storage backends for PoI SDK.
+ * Supports IPFS, S3, and Arweave.
+ *
+ * @example
+ * ```typescript
+ * import { IpfsAdapter, S3Adapter, ReplicatedStorageAdapter } from '@fluxpointstudios/orynq-sdk-storage-adapters';
+ *
+ * // Single adapter usage
+ * const ipfs = new IpfsAdapter({
+ *   gateway: 'https://ipfs.io',
+ *   pinningService: {
+ *     name: 'pinata',
+ *     apiKey: process.env.PINATA_API_KEY!,
+ *   },
+ * });
+ *
+ * const ref = await ipfs.store(data);
+ * console.log('Stored at:', ref.uri);
+ *
+ * // Replication across multiple backends
+ * const replicated = new ReplicatedStorageAdapter({
+ *   adapters: [ipfsAdapter, s3Adapter],
+ *   strategy: 'all',
+ * });
+ *
+ * const ref = await replicated.store(data);
+ * ```
+ *
+ * @packageDocumentation
+ */
+export type { StorageType, StorageRef, StorableManifest, StorageAdapter, IpfsAdapterConfig, PinningServiceConfig, S3AdapterConfig, ArweaveAdapterConfig, ArweaveWallet, BundlrConfig, ReplicationConfig, } from "./types.js";
+export { StorageError, StorageException } from "./types.js";
+export { IpfsAdapter, createIpfsAdapter, type PinningService, PinataPinningService, InfuraPinningService, Web3StoragePinningService, createPinningService, } from "./adapters/ipfs/index.js";
+export { S3Adapter, createS3Adapter, type S3Client, } from "./adapters/s3/index.js";
+export { ArweaveAdapter, createArweaveAdapter, } from "./adapters/arweave/index.js";
+export { sha256, sha256Raw, contentId, validateContentHash, parseIpfsCid, parseArweaveId, parseS3Key, buildStorageUri, HASH_DOMAIN_PREFIXES, type HashDomain, ReplicatedStorageAdapter, } from "./utils/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,YAAY,EACV,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,KAAK,cAAc,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,SAAS,EACT,eAAe,EACf,KAAK,QAAQ,GACd,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,MAAM,EACN,SAAS,EACT,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,KAAK,UAAU,EACf,wBAAwB,GACzB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,43 @@
+/**
+ * PoI Storage Adapters
+ *
+ * Content-addressed storage backends for PoI SDK.
+ * Supports IPFS, S3, and Arweave.
+ *
+ * @example
+ * ```typescript
+ * import { IpfsAdapter, S3Adapter, ReplicatedStorageAdapter } from '@fluxpointstudios/orynq-sdk-storage-adapters';
+ *
+ * // Single adapter usage
+ * const ipfs = new IpfsAdapter({
+ *   gateway: 'https://ipfs.io',
+ *   pinningService: {
+ *     name: 'pinata',
+ *     apiKey: process.env.PINATA_API_KEY!,
+ *   },
+ * });
+ *
+ * const ref = await ipfs.store(data);
+ * console.log('Stored at:', ref.uri);
+ *
+ * // Replication across multiple backends
+ * const replicated = new ReplicatedStorageAdapter({
+ *   adapters: [ipfsAdapter, s3Adapter],
+ *   strategy: 'all',
+ * });
+ *
+ * const ref = await replicated.store(data);
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { StorageError, StorageException } from "./types.js";
+// === IPFS Adapter ===
+export { IpfsAdapter, createIpfsAdapter, PinataPinningService, InfuraPinningService, Web3StoragePinningService, createPinningService, } from "./adapters/ipfs/index.js";
+// === S3 Adapter ===
+export { S3Adapter, createS3Adapter, } from "./adapters/s3/index.js";
+// === Arweave Adapter ===
+export { ArweaveAdapter, createArweaveAdapter, } from "./adapters/arweave/index.js";
+// === Utilities ===
+export { sha256, sha256Raw, contentId, validateContentHash, parseIpfsCid, parseArweaveId, parseS3Key, buildStorageUri, HASH_DOMAIN_PREFIXES, ReplicatedStorageAdapter, } from "./utils/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAiBH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE5D,uBAAuB;AACvB,OAAO,EACL,WAAW,EACX,iBAAiB,EAEjB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAElC,qBAAqB;AACrB,OAAO,EACL,SAAS,EACT,eAAe,GAEhB,MAAM,wBAAwB,CAAC;AAEhC,0BAA0B;AAC1B,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAErC,oBAAoB;AACpB,OAAO,EACL,MAAM,EACN,SAAS,EACT,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,eAAe,EACf,oBAAoB,EAEpB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Types for storage adapters.
+ */
+export type StorageType = "local" | "ipfs" | "s3" | "arweave";
+export interface StorageRef {
+    type: StorageType;
+    uri: string;
+    hash: string;
+    size: number;
+}
+/**
+ * Minimal manifest interface for storage operations.
+ * Compatible with ManifestV2 from flight-recorder.
+ */
+export interface StorableManifest {
+    formatVersion: string;
+    sessionId: string;
+    manifestHash?: string;
+    [key: string]: unknown;
+}
+export interface StorageAdapter {
+    readonly type: StorageType;
+    /**
+     * Store raw data.
+     */
+    store(data: Uint8Array): Promise<StorageRef>;
+    /**
+     * Store a manifest.
+     */
+    storeManifest(manifest: StorableManifest): Promise<StorageRef>;
+    /**
+     * Fetch data by reference.
+     */
+    fetch(ref: StorageRef): Promise<Uint8Array>;
+    /**
+     * Fetch a manifest by reference.
+     */
+    fetchManifest(ref: StorageRef): Promise<StorableManifest>;
+    /**
+     * Verify data integrity.
+     */
+    verify(ref: StorageRef): Promise<boolean>;
+    /**
+     * Delete data (optional).
+     */
+    delete?(ref: StorageRef): Promise<void>;
+    /**
+     * Pin data for persistence (optional).
+     */
+    pin?(ref: StorageRef): Promise<void>;
+}
+export interface IpfsAdapterConfig {
+    /**
+     * IPFS gateway URL for reading (e.g., "https://ipfs.io").
+     */
+    gateway: string;
+    /**
+     * IPFS API endpoint for writing (e.g., "http://localhost:5001").
+     * Required for storing data.
+     */
+    apiEndpoint?: string;
+    /**
+     * Pinning service configuration.
+     */
+    pinningService?: PinningServiceConfig;
+    /**
+     * Request timeout in milliseconds.
+     */
+    timeoutMs?: number;
+}
+export interface PinningServiceConfig {
+    name: "pinata" | "infura" | "web3.storage" | "custom";
+    apiKey: string;
+    apiSecret?: string;
+    endpoint?: string;
+}
+export interface S3AdapterConfig {
+    /**
+     * S3 bucket name.
+     */
+    bucket: string;
+    /**
+     * AWS region.
+     */
+    region: string;
+    /**
+     * Optional prefix for all keys.
+     */
+    prefix?: string;
+    /**
+     * AWS credentials.
+     */
+    credentials?: {
+        accessKeyId: string;
+        secretAccessKey: string;
+    };
+    /**
+     * Custom endpoint (for S3-compatible services).
+     */
+    endpoint?: string;
+    /**
+     * Enable server-side encryption.
+     */
+    serverSideEncryption?: boolean;
+    /**
+     * Presigned URL expiry in seconds (default: 3600).
+     */
+    presignedUrlExpiry?: number;
+}
+export interface ArweaveAdapterConfig {
+    /**
+     * Arweave gateway URL (default: "https://arweave.net").
+     */
+    gateway?: string;
+    /**
+     * JWK wallet for signing transactions.
+     */
+    wallet?: ArweaveWallet;
+    /**
+     * Bundlr/Irys configuration for bundled uploads.
+     */
+    bundlr?: BundlrConfig;
+    /**
+     * Request timeout in milliseconds.
+     */
+    timeoutMs?: number;
+}
+export interface ArweaveWallet {
+    kty: string;
+    n: string;
+    e: string;
+    d?: string;
+    p?: string;
+    q?: string;
+    dp?: string;
+    dq?: string;
+    qi?: string;
+}
+export interface BundlrConfig {
+    url: string;
+    currency: "arweave" | "matic" | "ethereum";
+    providerUrl?: string;
+}
+export interface ReplicationConfig {
+    /**
+     * Storage adapters to replicate to.
+     */
+    adapters: StorageAdapter[];
+    /**
+     * Strategy for handling failures.
+     */
+    strategy: "all" | "any" | "quorum";
+    /**
+     * Minimum number of successful stores for quorum strategy.
+     */
+    quorum?: number;
+    /**
+     * Retry configuration.
+     */
+    retry?: {
+        maxAttempts: number;
+        delayMs: number;
+        backoffMultiplier: number;
+    };
+}
+export declare enum StorageError {
+    STORE_FAILED = 2001,
+    FETCH_FAILED = 2002,
+    NOT_FOUND = 2003,
+    VERIFICATION_FAILED = 2004,
+    DELETE_FAILED = 2005,
+    PIN_FAILED = 2006,
+    TIMEOUT = 2007,
+    INVALID_CONFIG = 2008,
+    REPLICATION_FAILED = 2009
+}
+export declare class StorageException extends Error {
+    readonly code: StorageError;
+    readonly cause?: Error | undefined;
+    constructor(code: StorageError, message: string, cause?: Error | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,27 @@
+/**
+ * Types for storage adapters.
+ */
+// === Error Codes ===
+export var StorageError;
+(function (StorageError) {
+    StorageError[StorageError["STORE_FAILED"] = 2001] = "STORE_FAILED";
+    StorageError[StorageError["FETCH_FAILED"] = 2002] = "FETCH_FAILED";
+    StorageError[StorageError["NOT_FOUND"] = 2003] = "NOT_FOUND";
+    StorageError[StorageError["VERIFICATION_FAILED"] = 2004] = "VERIFICATION_FAILED";
+    StorageError[StorageError["DELETE_FAILED"] = 2005] = "DELETE_FAILED";
+    StorageError[StorageError["PIN_FAILED"] = 2006] = "PIN_FAILED";
+    StorageError[StorageError["TIMEOUT"] = 2007] = "TIMEOUT";
+    StorageError[StorageError["INVALID_CONFIG"] = 2008] = "INVALID_CONFIG";
+    StorageError[StorageError["REPLICATION_FAILED"] = 2009] = "REPLICATION_FAILED";
+})(StorageError || (StorageError = {}));
+export class StorageException extends Error {
+    code;
+    cause;
+    constructor(code, message, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = "StorageException";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmNH,sBAAsB;AAEtB,MAAM,CAAN,IAAY,YAUX;AAVD,WAAY,YAAY;IACtB,kEAAmB,CAAA;IACnB,kEAAmB,CAAA;IACnB,4DAAgB,CAAA;IAChB,gFAA0B,CAAA;IAC1B,oEAAoB,CAAA;IACpB,8DAAiB,CAAA;IACjB,wDAAc,CAAA;IACd,sEAAqB,CAAA;IACrB,8EAAyB,CAAA;AAC3B,CAAC,EAVW,YAAY,KAAZ,YAAY,QAUvB;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAEvB;IAEA;IAHlB,YACkB,IAAkB,EAClC,OAAe,EACC,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAc;QAElB,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF"}

package/dist/utils/content-addressing.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Content-addressing utilities for storage.
+ */
+/**
+ * Hash domain prefixes for content-addressed storage.
+ */
+export declare const HASH_DOMAIN_PREFIXES: {
+    readonly chunk: "poi-storage:chunk:v1|";
+    readonly manifest: "poi-storage:manifest:v1|";
+    readonly data: "poi-storage:data:v1|";
+};
+export type HashDomain = keyof typeof HASH_DOMAIN_PREFIXES;
+/**
+ * Compute SHA-256 hash with domain separation.
+ */
+export declare function sha256(data: Uint8Array, domain?: HashDomain): string;
+/**
+ * Compute SHA-256 hash without domain separation.
+ */
+export declare function sha256Raw(data: Uint8Array): string;
+/**
+ * Generate a content-addressed ID from data.
+ */
+export declare function contentId(data: Uint8Array): string;
+/**
+ * Validate that data matches a content hash.
+ */
+export declare function validateContentHash(data: Uint8Array, expectedHash: string, domain?: HashDomain): boolean;
+/**
+ * Parse an IPFS CID from a URI.
+ */
+export declare function parseIpfsCid(uri: string): string | undefined;
+/**
+ * Parse an Arweave transaction ID from a URI.
+ */
+export declare function parseArweaveId(uri: string): string | undefined;
+/**
+ * Parse an S3 key from a URI.
+ */
+export declare function parseS3Key(uri: string): {
+    bucket: string;
+    key: string;
+} | undefined;
+/**
+ * Build a storage URI from components.
+ */
+export declare function buildStorageUri(type: "ipfs" | "s3" | "arweave" | "local", id: string, options?: {
+    bucket?: string;
+}): string;
+//# sourceMappingURL=content-addressing.d.ts.map

package/dist/utils/content-addressing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-addressing.d.ts","sourceRoot":"","sources":["../../src/utils/content-addressing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,oBAAoB,CAAC;AAE3D;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,UAAmB,GAAG,MAAM,CAS5E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,GAAE,UAAmB,GAC1B,OAAO,CAGT;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAsBnF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,EACzC,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,MAAM,CAgBR"}

package/dist/utils/content-addressing.js

@@ -0,0 +1,101 @@
+/**
+ * Content-addressing utilities for storage.
+ */
+import { createHash } from "node:crypto";
+/**
+ * Hash domain prefixes for content-addressed storage.
+ */
+export const HASH_DOMAIN_PREFIXES = {
+    chunk: "poi-storage:chunk:v1|",
+    manifest: "poi-storage:manifest:v1|",
+    data: "poi-storage:data:v1|",
+};
+/**
+ * Compute SHA-256 hash with domain separation.
+ */
+export function sha256(data, domain = "data") {
+    const prefix = HASH_DOMAIN_PREFIXES[domain];
+    const prefixBytes = new TextEncoder().encode(prefix);
+    const combined = new Uint8Array(prefixBytes.length + data.length);
+    combined.set(prefixBytes, 0);
+    combined.set(data, prefixBytes.length);
+    return createHash("sha256").update(combined).digest("hex");
+}
+/**
+ * Compute SHA-256 hash without domain separation.
+ */
+export function sha256Raw(data) {
+    return createHash("sha256").update(data).digest("hex");
+}
+/**
+ * Generate a content-addressed ID from data.
+ */
+export function contentId(data) {
+    return sha256(data, "data");
+}
+/**
+ * Validate that data matches a content hash.
+ */
+export function validateContentHash(data, expectedHash, domain = "data") {
+    const actualHash = sha256(data, domain);
+    return actualHash === expectedHash;
+}
+/**
+ * Parse an IPFS CID from a URI.
+ */
+export function parseIpfsCid(uri) {
+    const match = uri.match(/ipfs:\/\/(\w+)/) ?? uri.match(/\/ipfs\/(\w+)/);
+    return match?.[1];
+}
+/**
+ * Parse an Arweave transaction ID from a URI.
+ */
+export function parseArweaveId(uri) {
+    const match = uri.match(/ar:\/\/(\w+)/) ?? uri.match(/arweave\.net\/(\w+)/);
+    return match?.[1];
+}
+/**
+ * Parse an S3 key from a URI.
+ */
+export function parseS3Key(uri) {
+    // s3://bucket/key/path
+    const s3Match = uri.match(/s3:\/\/([^\/]+)\/(.+)/);
+    if (s3Match) {
+        const bucket = s3Match[1];
+        const key = s3Match[2];
+        if (bucket !== undefined && key !== undefined) {
+            return { bucket, key };
+        }
+    }
+    // https://bucket.s3.region.amazonaws.com/key
+    const httpsMatch = uri.match(/https?:\/\/([^\.]+)\.s3\.[^\/]+\/(.+)/);
+    if (httpsMatch) {
+        const bucket = httpsMatch[1];
+        const key = httpsMatch[2];
+        if (bucket !== undefined && key !== undefined) {
+            return { bucket, key };
+        }
+    }
+    return undefined;
+}
+/**
+ * Build a storage URI from components.
+ */
+export function buildStorageUri(type, id, options) {
+    switch (type) {
+        case "ipfs":
+            return `ipfs://${id}`;
+        case "arweave":
+            return `ar://${id}`;
+        case "s3":
+            if (options?.bucket) {
+                return `s3://${options.bucket}/${id}`;
+            }
+            return `s3://${id}`;
+        case "local":
+            return `file://${id}`;
+        default:
+            return id;
+    }
+}
+//# sourceMappingURL=content-addressing.js.map

package/dist/utils/content-addressing.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { sha256, sha256Raw, contentId, validateContentHash, parseIpfsCid, parseArweaveId, parseS3Key, buildStorageUri, HASH_DOMAIN_PREFIXES, type HashDomain, } from "./content-addressing.js";
+export { ReplicatedStorageAdapter } from "./replication.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,SAAS,EACT,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,KAAK,UAAU,GAChB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,3 @@
+export { sha256, sha256Raw, contentId, validateContentHash, parseIpfsCid, parseArweaveId, parseS3Key, buildStorageUri, HASH_DOMAIN_PREFIXES, } from "./content-addressing.js";
+export { ReplicatedStorageAdapter } from "./replication.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,SAAS,EACT,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,eAAe,EACf,oBAAoB,GAErB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/utils/replication.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Replication utility for storing data across multiple storage backends.
+ */
+import type { StorageAdapter, StorageRef, StorableManifest, ReplicationConfig } from "../types.js";
+export interface ReplicationResult {
+    success: boolean;
+    refs: StorageRef[];
+    errors: Array<{
+        adapter: string;
+        error: Error;
+    }>;
+}
+/**
+ * Storage adapter that replicates data across multiple backends.
+ */
+export declare class ReplicatedStorageAdapter implements StorageAdapter {
+    readonly type: "local";
+    private readonly adapters;
+    private readonly strategy;
+    private readonly quorum;
+    private readonly retry;
+    constructor(config: ReplicationConfig);
+    /**
+     * Store data across all configured adapters.
+     */
+    store(data: Uint8Array): Promise<StorageRef>;
+    /**
+     * Store a manifest across all configured adapters.
+     */
+    storeManifest(manifest: StorableManifest): Promise<StorageRef>;
+    /**
+     * Fetch data from any adapter that has it.
+     */
+    fetch(ref: StorageRef): Promise<Uint8Array>;
+    /**
+     * Fetch a manifest from any adapter that has it.
+     */
+    fetchManifest(ref: StorageRef): Promise<StorableManifest>;
+    /**
+     * Verify data exists and is valid in at least one adapter.
+     */
+    verify(ref: StorageRef): Promise<boolean>;
+    /**
+     * Delete data from all adapters.
+     */
+    delete(ref: StorageRef): Promise<void>;
+    /**
+     * Pin data in all adapters that support pinning.
+     */
+    pin(ref: StorageRef): Promise<void>;
+    /**
+     * Get all storage references from a replication operation.
+     */
+    storeAll(data: Uint8Array): Promise<ReplicationResult>;
+    /**
+     * Store manifest to all adapters and return all references.
+     */
+    storeManifestAll(manifest: StorableManifest): Promise<ReplicationResult>;
+    private storeWithReplication;
+    private checkSuccess;
+    private retryOperation;
+    private sleep;
+}
+//# sourceMappingURL=replication.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replication.d.ts","sourceRoot":"","sources":["../../src/utils/replication.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,qBAAa,wBAAyB,YAAW,cAAc;IAC7D,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAIpB;gBAEU,MAAM,EAAE,iBAAiB;IAkBrC;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAuBlD;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAsBpE;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAgBjD;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgB/D;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAa/C;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB5C;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BzC;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI5D;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAMhE,oBAAoB;IA8BlC,OAAO,CAAC,YAAY;YAaN,cAAc;IAsB5B,OAAO,CAAC,KAAK;CAGd"}