@decaf-ts/integrations 0.1.3 → 0.2.0

package/lib/esm/blob/azure/AzureBlobStoreService.js

@@ -0,0 +1,288 @@
+/**
+ * @module integrations/blob/azure/service
+ * @summary Azure Blob storage service.
+ * @description Blob store backed by Azure Blob Storage via @azure/storage-blob.
+ */
+import { BlobServiceClient, generateBlobSASQueryParameters, BlobSASPermissions, } from "@azure/storage-blob";
+import { DefaultAzureCredential } from "@azure/identity";
+import { AuthorizationError, ConnectionError, ForbiddenError, UnsupportedError, } from "@decaf-ts/core";
+import { ConflictError, InternalError, NotFoundError, ValidationError, } from "@decaf-ts/db-decorators";
+import { BlobStoreService } from "./../core/BlobStoreService.js";
+import { collectToBuffer, computeSha256, toAsyncIterable } from "./../core/BlobValue.js";
+export class AzureBlobStoreService extends BlobStoreService {
+    async initialize(...args) {
+        const { log } = (await this.logCtx(args, "initialize", true)).for(this.initialize);
+        const config = this.getConfigFromArgs(...args);
+        if (!config.container) {
+            throw new InternalError("AzureBlobStoreService requires a container");
+        }
+        if (config.connectionString) {
+            this.blobServiceClient =
+                BlobServiceClient.fromConnectionString(config.connectionString);
+        }
+        else {
+            const endpoint = config.endpoint || `https://${config.accountName}.blob.core.windows.net`;
+            this.blobServiceClient = new BlobServiceClient(endpoint, new DefaultAzureCredential());
+        }
+        const client = this.blobServiceClient.getContainerClient(config.container);
+        this._config = config;
+        this._client = client;
+        log.verbose(`Initialized Azure 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 blobName = this.physicalKey(key);
+        if (options.ifNotExists) {
+            if (await this.has(key)) {
+                throw new ConflictError(`Blob already exists: ${key}`);
+            }
+        }
+        const buffer = await collectToBuffer(value);
+        if (options.expectedSha256) {
+            const sha256 = await computeSha256(buffer);
+            if (options.expectedSha256 !== sha256) {
+                throw new ValidationError(`Checksum mismatch for ${key}`);
+            }
+        }
+        try {
+            const blockBlobClient = this.client.getBlockBlobClient(blobName);
+            const response = await blockBlobClient.uploadData(buffer, {
+                blobHTTPHeaders: options.contentType
+                    ? { blobContentType: options.contentType }
+                    : undefined,
+                metadata: options.metadata,
+            });
+            const metadata = {
+                contentType: options.contentType,
+                contentLength: buffer.length,
+                etag: response.etag,
+                versionId: response.versionId,
+                custom: options.metadata,
+            };
+            return {
+                key,
+                uri: this.uri(key, "azure-blob", response.versionId ? `version=${response.versionId}` : undefined),
+                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 blobName = this.physicalKey(key);
+        try {
+            const blobClient = this.client.getBlobClient(blobName);
+            const downloadResponse = await blobClient.download(options.range?.start, options.range
+                ? (options.range.end ?? undefined) !== undefined
+                    ? (options.range.end ?? undefined) - (options.range?.start ?? 0) + 1
+                    : undefined
+                : undefined);
+            const metadata = {
+                contentType: downloadResponse.contentType,
+                contentLength: downloadResponse.contentLength,
+                etag: downloadResponse.etag,
+            };
+            const readable = downloadResponse.readableStreamBody;
+            return {
+                key,
+                value: toAsyncIterable(readable),
+                uri: this.uri(key, "azure-blob"),
+                provider: this.provider,
+                sourceId: this.sourceId,
+                metadata,
+            };
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+    }
+    async has(key, ...args) {
+        const { log } = (await this.logCtx(args, "has", true)).for(this.has);
+        log.verbose(`Checking blob ${key}`);
+        try {
+            const blobClient = this.client.getBlobClient(this.physicalKey(key));
+            return Boolean(await blobClient.exists());
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+    }
+    async stat(key, ...args) {
+        const { log } = (await this.logCtx(args, "stat", true)).for(this.stat);
+        log.verbose(`Statting blob ${key}`);
+        try {
+            const blobClient = this.client.getBlobClient(this.physicalKey(key));
+            const props = await blobClient.getProperties();
+            return {
+                contentType: props.contentType,
+                contentLength: props.contentLength,
+                etag: props.etag,
+                custom: props.metadata,
+            };
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+    }
+    async delete(key, ...args) {
+        const { log } = (await this.logCtx(args, "delete", true)).for(this.delete);
+        log.verbose(`Deleting blob ${key}`);
+        try {
+            const blobClient = this.client.getBlobClient(this.physicalKey(key));
+            await blobClient.delete();
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+    }
+    async copy(fromKey, toKey, options = {}, ...args) {
+        const { log } = (await this.logCtx(args, "copy", true)).for(this.copy);
+        log.verbose(`Copying blob ${fromKey} to ${toKey}`);
+        try {
+            const sourceClient = this.client.getBlobClient(this.physicalKey(fromKey));
+            const targetClient = this.client.getBlobClient(this.physicalKey(toKey));
+            const poller = await targetClient.beginCopyFromURL(sourceClient.url);
+            await poller.pollUntilDone();
+            const props = await targetClient.getProperties();
+            const metadata = {
+                contentType: options.contentType ?? props.contentType,
+                contentLength: props.contentLength,
+                etag: props.etag,
+                custom: options.metadata,
+            };
+            return {
+                key: toKey,
+                uri: this.uri(toKey, "azure-blob"),
+                provider: this.provider,
+                sourceId: this.sourceId,
+                metadata,
+            };
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+    }
+    async list(options = {}, ...args) {
+        const { log } = (await this.logCtx(args, "list", true)).for(this.list);
+        log.verbose("Listing blobs");
+        const prefix = this.physicalKey(options.prefix ?? "");
+        try {
+            const items = [];
+            const maxPageSize = options.limit ?? undefined;
+            for await (const blob of this.client.listBlobsFlat({
+                prefix: prefix || undefined,
+                includeMetadata: true,
+            })) {
+                items.push({
+                    key: blob.name,
+                    metadata: {
+                        contentLength: blob.properties.contentLength,
+                        etag: blob.properties.etag,
+                        contentType: blob.properties.contentType,
+                        custom: blob.metadata,
+                    },
+                });
+                if (maxPageSize && items.length >= maxPageSize)
+                    break;
+            }
+            return { items };
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+    }
+    async url(key, options = {}, ...args) {
+        const { log } = (await this.logCtx(args, "url", true)).for(this.url);
+        log.verbose(`Building url for blob ${key}`);
+        const blobName = this.physicalKey(key);
+        const operation = options.operation ?? "get";
+        const expiresIn = options.expiresInSeconds ?? 300;
+        try {
+            const blobClient = this.client.getBlobClient(blobName);
+            const credential = this.blobServiceClient.credential;
+            let url;
+            if (credential && typeof credential.accountName === "string") {
+                const sasToken = generateBlobSASQueryParameters({
+                    containerName: this.config.container,
+                    blobName,
+                    permissions: BlobSASPermissions.from({
+                        read: operation === "get",
+                        create: operation === "put",
+                        write: operation === "put",
+                    }),
+                    startsOn: new Date(),
+                    expiresOn: new Date(Date.now() + expiresIn * 1000),
+                    contentType: options.contentType,
+                }, credential).toString();
+                url = `${blobClient.url}?${sasToken}`;
+            }
+            else {
+                const token = await blobClient.generateSasUrl({
+                    permissions: BlobSASPermissions.from({
+                        read: operation === "get",
+                        create: operation === "put",
+                        write: operation === "put",
+                    }),
+                    expiresOn: new Date(Date.now() + expiresIn * 1000),
+                    contentType: options.contentType,
+                });
+                url = token;
+            }
+            return {
+                url,
+                method: operation === "put" ? "PUT" : "GET",
+                expiresAt: new Date(Date.now() + expiresIn * 1000),
+                headers: options.contentType
+                    ? { "Content-Type": options.contentType }
+                    : undefined,
+            };
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+    }
+    parseError(error) {
+        const err = error;
+        if (err instanceof NotFoundError ||
+            err instanceof ConflictError ||
+            err instanceof AuthorizationError ||
+            err instanceof ForbiddenError ||
+            err instanceof ValidationError ||
+            err instanceof ConnectionError ||
+            err instanceof UnsupportedError ||
+            err instanceof InternalError) {
+            return err;
+        }
+        const message = err.message || "Unknown error";
+        const lower = message.toLowerCase();
+        const statusCode = err?.statusCode || err?.$metadata?.httpStatusCode;
+        const code = err?.code;
+        if (lower.includes("blobnotfound") || statusCode === 404 || lower.includes("not found") || code === "BlobNotFound") {
+            return new NotFoundError(err);
+        }
+        if (statusCode === 409 || lower.includes("conflict") || lower.includes("already exists")) {
+            return new ConflictError(err);
+        }
+        if (statusCode === 401 || lower.includes("unauthorized")) {
+            return new AuthorizationError(err);
+        }
+        if (statusCode === 403 || lower.includes("permission") || lower.includes("forbidden")) {
+            return new ForbiddenError(err);
+        }
+        if (statusCode === 429 || lower.includes("rate limit")) {
+            return new ConflictError(err);
+        }
+        if (statusCode === 503 || lower.includes("timeout") || lower.includes("unavailable") || lower.includes("connection")) {
+            return new ConnectionError(err);
+        }
+        return new InternalError(err);
+    }
+}
+//# sourceMappingURL=AzureBlobStoreService.js.map

package/lib/esm/blob/azure/AzureBlobStoreService.js.map

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

package/lib/esm/blob/azure/index.js

@@ -0,0 +1,7 @@
+/**
+ * @module integrations/blob/azure
+ * @summary Azure Blob storage exports.
+ * @description Re-exports the Azure Blob store service.
+ */
+export * from "./AzureBlobStoreService.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/blob/azure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/blob/azure/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,2CAAwC"}

package/lib/esm/blob/core/BlobErrors.js

@@ -0,0 +1,61 @@
+/**
+ * @module integrations/blob/core/errors
+ * @summary Blob error translation helpers.
+ * @description Re-exports standard DECAF errors used by blob store implementations and provides
+ * helper functions for translating provider library errors into the appropriate DECAF error types.
+ */
+import { AuthorizationError, ConnectionError, ForbiddenError, UnsupportedError, } from "@decaf-ts/core";
+import { BadRequestError, ConflictError, InternalError, NotFoundError, ValidationError, } from "@decaf-ts/db-decorators";
+export { AuthorizationError, BadRequestError, ConflictError, ConnectionError, ForbiddenError, InternalError, NotFoundError, UnsupportedError, ValidationError, };
+/**
+ * Translates a generic error into a DECAF error based on HTTP status code or message keywords.
+ * Used as a fallback by provider parseError methods.
+ */
+export function translateBlobError(error) {
+    if (error instanceof NotFoundError ||
+        error instanceof ConflictError ||
+        error instanceof AuthorizationError ||
+        error instanceof ForbiddenError ||
+        error instanceof ValidationError ||
+        error instanceof ConnectionError ||
+        error instanceof UnsupportedError ||
+        error instanceof InternalError) {
+        return error;
+    }
+    const message = error.message || error.name || "Unknown error";
+    const lowerMessage = message.toLowerCase();
+    const statusCode = error?.statusCode ||
+        error?.$metadata?.httpStatusCode ||
+        error?.code;
+    if (lowerMessage.includes("not found") ||
+        statusCode === 404 ||
+        lowerMessage.includes("enoent") ||
+        lowerMessage.includes("blobnotfound") ||
+        statusCode === "ENOENT") {
+        return new NotFoundError(error);
+    }
+    if (lowerMessage.includes("already exists") ||
+        lowerMessage.includes("conflict") ||
+        statusCode === 409 ||
+        statusCode === "EEXIST") {
+        return new ConflictError(error);
+    }
+    if (lowerMessage.includes("unauthorized") || statusCode === 401) {
+        return new AuthorizationError(error);
+    }
+    if (lowerMessage.includes("permission") || statusCode === 403) {
+        return new ForbiddenError(error);
+    }
+    if (lowerMessage.includes("rate limit") ||
+        statusCode === 429) {
+        return new ConflictError(error);
+    }
+    if (lowerMessage.includes("connection") ||
+        lowerMessage.includes("timeout") ||
+        lowerMessage.includes("unavailable") ||
+        statusCode === 503) {
+        return new ConnectionError(error);
+    }
+    return new InternalError(error);
+}
+//# sourceMappingURL=BlobErrors.js.map

package/lib/esm/blob/core/BlobErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlobErrors.js","sourceRoot":"","sources":["../../../../src/blob/core/BlobErrors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,eAAe,EACf,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,eAAe,EACf,cAAc,EACd,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAY;IAC7C,IACE,KAAK,YAAY,aAAa;QAC9B,KAAK,YAAY,aAAa;QAC9B,KAAK,YAAY,kBAAkB;QACnC,KAAK,YAAY,cAAc;QAC/B,KAAK,YAAY,eAAe;QAChC,KAAK,YAAY,eAAe;QAChC,KAAK,YAAY,gBAAgB;QACjC,KAAK,YAAY,aAAa,EAC9B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,IAAI,eAAe,CAAC;IAC/D,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,UAAU,GACb,KAAa,EAAE,UAAU;QACzB,KAAa,EAAE,SAAS,EAAE,cAAc;QACxC,KAAa,EAAE,IAAI,CAAC;IAEvB,IACE,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC;QAClC,UAAU,KAAK,GAAG;QAClB,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC/B,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC;QACrC,UAAU,KAAK,QAAQ,EACvB,CAAC;QACD,OAAO,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,IACE,YAAY,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACvC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;QACjC,UAAU,KAAK,GAAG;QAClB,UAAU,KAAK,QAAQ,EACvB,CAAC;QACD,OAAO,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QAChE,OAAO,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QAC9D,OAAO,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,IACE,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC;QACnC,UAAU,KAAK,GAAG,EAClB,CAAC;QACD,OAAO,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,IACE,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC;QACnC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC;QAChC,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC;QACpC,UAAU,KAAK,GAAG,EAClB,CAAC;QACD,OAAO,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC"}

package/lib/esm/blob/core/BlobKey.js

@@ -0,0 +1,32 @@
+/**
+ * @module integrations/blob/core/key
+ * @summary Blob key helpers.
+ * @description Validation, cleaning, and prefixing helpers for blob keys.
+ */
+import { ValidationError } from "@decaf-ts/db-decorators";
+/**
+ * Strips leading slashes from a blob key and rejects unsafe path segments.
+ */
+export function cleanKey(key) {
+    if (typeof key !== "string") {
+        throw new ValidationError(`Blob key must be a string`);
+    }
+    const clean = key.replace(/^\/+/, "");
+    if (clean === "" ||
+        clean === "." ||
+        clean === ".." ||
+        clean.includes("../") ||
+        clean.startsWith("../")) {
+        throw new ValidationError(`Invalid blob key: ${key}`);
+    }
+    return clean;
+}
+/**
+ * Applies the configured prefix (trimmed of leading/trailing slashes) to a cleaned key.
+ */
+export function physicalKey(key, prefix) {
+    const clean = cleanKey(key);
+    const trimmedPrefix = prefix?.replace(/^\/+|\/+$/g, "");
+    return trimmedPrefix ? `${trimmedPrefix}/${clean}` : clean;
+}
+//# sourceMappingURL=BlobKey.js.map

package/lib/esm/blob/core/BlobKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlobKey.js","sourceRoot":"","sources":["../../../../src/blob/core/BlobKey.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAY;IACnC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,eAAe,CAAC,2BAA2B,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEtC,IACE,KAAK,KAAK,EAAE;QACZ,KAAK,KAAK,GAAG;QACb,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QACrB,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,EACvB,CAAC;QACD,MAAM,IAAI,eAAe,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAY,EAAE,MAAe;IACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,aAAa,GAAG,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IACxD,OAAO,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC7D,CAAC"}

package/lib/esm/blob/core/BlobStoreFactory.js

@@ -0,0 +1,52 @@
+/**
+ * @module integrations/blob/core/factory
+ * @summary Blob store factory.
+ * @description Creates uninitialized blob store services selected by provider.
+ */
+import { ValidationError } from "@decaf-ts/db-decorators";
+import { S3BlobStoreService } from "./../s3/S3BlobStoreService.js";
+import { MinioBlobStoreService } from "./../s3/MinioBlobStoreService.js";
+import { R2BlobStoreService } from "./../s3/R2BlobStoreService.js";
+import { AzureBlobStoreService } from "./../azure/AzureBlobStoreService.js";
+import { GcsBlobStoreService } from "./../gcp/GcsBlobStoreService.js";
+import { LocalBlobStoreService } from "./../local/LocalBlobStoreService.js";
+import { IpfsBlobStoreService } from "./../ipfs/IpfsBlobStoreService.js";
+import { MemoryBlobStoreService } from "./../memory/MemoryBlobStoreService.js";
+export class BlobStoreFactory {
+    create(config) {
+        let service;
+        switch (config.provider) {
+            case "s3":
+                service = new S3BlobStoreService();
+                break;
+            case "minio":
+                service = new MinioBlobStoreService();
+                break;
+            case "r2":
+                service = new R2BlobStoreService();
+                break;
+            case "azure-blob":
+                service = new AzureBlobStoreService();
+                break;
+            case "gcs":
+                service = new GcsBlobStoreService();
+                break;
+            case "local":
+                service = new LocalBlobStoreService();
+                break;
+            case "ipfs":
+                service = new IpfsBlobStoreService();
+                break;
+            case "memory":
+                service = new MemoryBlobStoreService();
+                break;
+            default:
+                return assertNever(config);
+        }
+        return service;
+    }
+}
+function assertNever(value) {
+    throw new ValidationError(`Unsupported blob provider: ${JSON.stringify(value)}`);
+}
+//# sourceMappingURL=BlobStoreFactory.js.map

package/lib/esm/blob/core/BlobStoreFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlobStoreFactory.js","sourceRoot":"","sources":["../../../../src/blob/core/BlobStoreFactory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EAAE,kBAAkB,EAAE,sCAAiC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,yCAAoC;AACpE,OAAO,EAAE,kBAAkB,EAAE,sCAAiC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,4CAAuC;AACvE,OAAO,EAAE,mBAAmB,EAAE,wCAAmC;AACjE,OAAO,EAAE,qBAAqB,EAAE,4CAAuC;AACvE,OAAO,EAAE,oBAAoB,EAAE,0CAAqC;AACpE,OAAO,EAAE,sBAAsB,EAAE,8CAAyC;AAE1E,MAAM,OAAO,gBAAgB;IAC3B,MAAM,CACJ,MAAS;QAET,IAAI,OAAyB,CAAC;QAC9B,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;YACxB,KAAK,IAAI;gBACP,OAAO,GAAG,IAAI,kBAAkB,EAAiC,CAAC;gBAClE,MAAM;YACR,KAAK,OAAO;gBACV,OAAO,GAAG,IAAI,qBAAqB,EAAiC,CAAC;gBACrE,MAAM;YACR,KAAK,IAAI;gBACP,OAAO,GAAG,IAAI,kBAAkB,EAAiC,CAAC;gBAClE,MAAM;YACR,KAAK,YAAY;gBACf,OAAO,GAAG,IAAI,qBAAqB,EAAiC,CAAC;gBACrE,MAAM;YACR,KAAK,KAAK;gBACR,OAAO,GAAG,IAAI,mBAAmB,EAAiC,CAAC;gBACnE,MAAM;YACR,KAAK,OAAO;gBACV,OAAO,GAAG,IAAI,qBAAqB,EAAiC,CAAC;gBACrE,MAAM;YACR,KAAK,MAAM;gBACT,OAAO,GAAG,IAAI,oBAAoB,EAAiC,CAAC;gBACpE,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,GAAG,IAAI,sBAAsB,EAAiC,CAAC;gBACtE,MAAM;YACR;gBACE,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,SAAS,WAAW,CAAC,KAA6B;IAChD,MAAM,IAAI,eAAe,CACvB,8BAA8B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CACtD,CAAC;AACJ,CAAC"}

package/lib/esm/blob/core/BlobStoreService.js

@@ -0,0 +1,37 @@
+/**
+ * @module integrations/blob/core/service
+ * @summary Blob store service abstraction.
+ * @description Base abstraction for binary large object backends.
+ */
+import { ClientBasedService, } from "@decaf-ts/core";
+import { ValidationError } from "@decaf-ts/db-decorators";
+import { cleanKey, physicalKey } from "./BlobKey.js";
+export class BlobStoreService extends ClientBasedService {
+    constructor() {
+        super();
+    }
+    get provider() {
+        return this.config.provider;
+    }
+    get sourceId() {
+        return this.config.sourceId;
+    }
+    physicalKey(key) {
+        return physicalKey(key, this.config.prefix);
+    }
+    cleanKey(key) {
+        return cleanKey(key);
+    }
+    getConfigFromArgs(...args) {
+        const config = args[0];
+        if (!config || typeof config !== "object") {
+            throw new ValidationError("Blob store config must be the first initialize argument");
+        }
+        return config;
+    }
+    uri(key, scheme, extra) {
+        const base = `${scheme}://${this.sourceId}/${this.physicalKey(key)}`;
+        return extra ? `${base}?${extra}` : base;
+    }
+}
+//# sourceMappingURL=BlobStoreService.js.map

package/lib/esm/blob/core/BlobStoreService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlobStoreService.js","sourceRoot":"","sources":["../../../../src/blob/core/BlobStoreService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,kBAAkB,GAGnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAkB;AAiBlD,MAAM,OAAgB,gBAGpB,SAAQ,kBAAoC;IAC5C;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAoDS,WAAW,CAAC,GAAY;QAChC,OAAO,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAES,QAAQ,CAAC,GAAY;QAC7B,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAES,iBAAiB,CACzB,GAAG,IAA6B;QAEhC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAA0B,CAAC;QAChD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,IAAI,eAAe,CACvB,yDAAyD,CAC1D,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAES,GAAG,CAAC,GAAY,EAAE,MAAc,EAAE,KAAc;QACxD,MAAM,IAAI,GAAG,GAAG,MAAM,MAAM,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACrE,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3C,CAAC;CACF"}

package/lib/esm/blob/core/BlobTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=BlobTypes.js.map

package/lib/esm/blob/core/BlobTypes.js.map

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

package/lib/esm/blob/core/BlobValue.js

@@ -0,0 +1,66 @@
+/**
+ * @module integrations/blob/core/value
+ * @summary Blob value helpers.
+ * @description Utilities for normalizing blob values and collecting them into buffers.
+ */
+import { getCrypto } from "@decaf-ts/crypto/common";
+import { ValidationError } from "@decaf-ts/db-decorators";
+/**
+ * Converts any supported BlobValue into an AsyncIterable of Uint8Array chunks.
+ */
+export function toAsyncIterable(value) {
+    if (value instanceof Uint8Array) {
+        return (async function* () {
+            yield value;
+        })();
+    }
+    const anyValue = value;
+    if (anyValue && typeof anyValue[Symbol.asyncIterator] === "function") {
+        return anyValue;
+    }
+    if (anyValue && typeof anyValue.getReader === "function") {
+        return (async function* () {
+            const reader = anyValue.getReader();
+            try {
+                let result = await reader.read();
+                while (!result.done) {
+                    yield result.value;
+                    result = await reader.read();
+                }
+            }
+            finally {
+                reader.releaseLock();
+            }
+        })();
+    }
+    if (anyValue && typeof anyValue[Symbol.iterator] === "function") {
+        return (async function* () {
+            for (const chunk of anyValue) {
+                yield chunk;
+            }
+        })();
+    }
+    throw new ValidationError(`Unsupported blob value type: ${typeof value}`);
+}
+/**
+ * Collects an AsyncIterable of Uint8Array chunks into a single Buffer.
+ */
+export async function collectToBuffer(value) {
+    if (value instanceof Uint8Array) {
+        return Buffer.from(value);
+    }
+    const chunks = [];
+    for await (const chunk of toAsyncIterable(value)) {
+        chunks.push(Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks);
+}
+/**
+ * Computes the sha256 hex digest of a blob value.
+ */
+export async function computeSha256(value) {
+    const buffer = await collectToBuffer(value);
+    const crypto = (await getCrypto());
+    return crypto.createHash("sha256").update(buffer).digest("hex");
+}
+//# sourceMappingURL=BlobValue.js.map

package/lib/esm/blob/core/BlobValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlobValue.js","sourceRoot":"","sources":["../../../../src/blob/core/BlobValue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAgB;IAEhB,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,SAAS,CAAC;YACrB,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,EAAE,CAAC;IACP,CAAC;IAED,MAAM,QAAQ,GAAG,KAAY,CAAC;IAC9B,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,UAAU,EAAE,CAAC;QACrE,OAAO,QAAqC,CAAC;IAC/C,CAAC;IAED,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QACzD,OAAO,CAAC,KAAK,SAAS,CAAC;YACrB,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,IAAI,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBACjC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;oBACpB,MAAM,MAAM,CAAC,KAAmB,CAAC;oBACjC,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC/B,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;IACP,CAAC;IAED,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,UAAU,EAAE,CAAC;QAChE,OAAO,CAAC,KAAK,SAAS,CAAC;YACrB,KAAK,MAAM,KAAK,IAAI,QAAgC,EAAE,CAAC;gBACrD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;IACP,CAAC;IAED,MAAM,IAAI,eAAe,CACvB,gCAAgC,OAAO,KAAK,EAAE,CAC/C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAgB;IAEhB,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAgB;IAClD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,CAAC,MAAM,SAAS,EAAE,CAAQ,CAAC;IAC1C,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC"}

package/lib/esm/blob/core/index.js

@@ -0,0 +1,12 @@
+/**
+ * @module integrations/blob/core
+ * @summary Blob core exports.
+ * @description Re-exports the blob store core types, errors, key/value helpers, service abstraction, and factory.
+ */
+export * from "./BlobTypes.js";
+export * from "./BlobErrors.js";
+export * from "./BlobKey.js";
+export * from "./BlobValue.js";
+export * from "./BlobStoreService.js";
+export * from "./BlobStoreFactory.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/blob/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/blob/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,+BAA4B;AAC5B,gCAA6B;AAC7B,6BAA0B;AAC1B,+BAA4B;AAC5B,sCAAmC;AACnC,sCAAmC"}