@decaf-ts/integrations 0.1.3 → 0.2.0

package/lib/esm/blob/s3/S3BlobStoreService.js

@@ -0,0 +1,317 @@
+/**
+ * @module integrations/blob/s3/service
+ * @summary S3-compatible blob store service.
+ * @description Blob store backed by AWS S3, MinIO, and Cloudflare R2 via the AWS SDK v3 S3Client.
+ */
+import { CopyObjectCommand, CreateBucketCommand, DeleteObjectCommand, GetObjectCommand, HeadObjectCommand, ListObjectsV2Command, PutObjectCommand, S3Client, } from "@aws-sdk/client-s3";
+import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
+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 S3BlobStoreService extends BlobStoreService {
+    async initialize(...args) {
+        const { log } = (await this.logCtx(args, "initialize", true)).for(this.initialize);
+        const config = this.getConfigFromArgs(...args);
+        if (!config.bucket) {
+            throw new InternalError("S3BlobStoreService requires a bucket");
+        }
+        const clientConfig = {
+            region: config.region,
+            endpoint: config.endpoint,
+            forcePathStyle: config.forcePathStyle,
+            maxAttempts: config.maxRetries,
+        };
+        if (config.credentials) {
+            clientConfig.credentials = {
+                accessKeyId: config.credentials.accessKeyId,
+                secretAccessKey: config.credentials.secretAccessKey,
+                sessionToken: config.credentials.sessionToken,
+            };
+        }
+        const client = new S3Client(clientConfig);
+        this._config = config;
+        this._client = client;
+        if (config.autoCreateBucket) {
+            await this.ensureBucket(log);
+        }
+        log.verbose(`Initialized S3 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 objectKey = this.physicalKey(key);
+        if (options.ifNotExists) {
+            if (await this.has(key)) {
+                throw new ConflictError(`Blob already exists: ${key}`);
+            }
+        }
+        const body = await collectToBuffer(value);
+        if (options.expectedSha256) {
+            const sha256 = await computeSha256(body);
+            if (options.expectedSha256 !== sha256) {
+                throw new ValidationError(`Checksum mismatch for ${key}`);
+            }
+        }
+        try {
+            const response = await this.client.send(new PutObjectCommand({
+                Bucket: this.config.bucket,
+                Key: objectKey,
+                Body: body,
+                ContentType: options.contentType,
+                Metadata: options.metadata,
+            }));
+            const metadata = {
+                contentType: options.contentType,
+                contentLength: body.length,
+                etag: response.ETag?.replace(/"/g, ""),
+                versionId: response.VersionId,
+                custom: options.metadata,
+            };
+            return {
+                key,
+                uri: this.uri(key, "s3", response.VersionId ? `versionId=${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 objectKey = this.physicalKey(key);
+        try {
+            const response = await this.client.send(new GetObjectCommand({
+                Bucket: this.config.bucket,
+                Key: objectKey,
+                Range: options.range
+                    ? `bytes=${options.range.start}-${options.range.end ?? ""}`
+                    : undefined,
+                VersionId: options.versionId,
+            }));
+            const body = response.Body;
+            const metadata = {
+                contentType: response.ContentType,
+                contentLength: response.ContentLength,
+                etag: response.ETag?.replace(/"/g, ""),
+                versionId: response.VersionId,
+            };
+            return {
+                key,
+                value: toAsyncIterable(body),
+                uri: this.uri(key, "s3", response.VersionId ? `versionId=${response.VersionId}` : undefined),
+                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 {
+            await this.stat(key);
+            return true;
+        }
+        catch (error) {
+            if (error instanceof NotFoundError) {
+                return false;
+            }
+            throw error;
+        }
+    }
+    async stat(key, ...args) {
+        const { log } = (await this.logCtx(args, "stat", true)).for(this.stat);
+        log.verbose(`Statting blob ${key}`);
+        const objectKey = this.physicalKey(key);
+        try {
+            const response = await this.client.send(new HeadObjectCommand({
+                Bucket: this.config.bucket,
+                Key: objectKey,
+            }));
+            return {
+                contentType: response.ContentType,
+                contentLength: response.ContentLength,
+                etag: response.ETag?.replace(/"/g, ""),
+                versionId: response.VersionId,
+                custom: response.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}`);
+        const objectKey = this.physicalKey(key);
+        try {
+            await this.client.send(new DeleteObjectCommand({
+                Bucket: this.config.bucket,
+                Key: objectKey,
+            }));
+        }
+        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}`);
+        const from = this.physicalKey(fromKey);
+        const to = this.physicalKey(toKey);
+        try {
+            const response = await this.client.send(new CopyObjectCommand({
+                Bucket: this.config.bucket,
+                CopySource: `${this.config.bucket}/${from}`,
+                Key: to,
+                ContentType: options.contentType,
+                Metadata: options.metadata,
+            }));
+            const metadata = {
+                contentType: options.contentType,
+                etag: response.CopyObjectResult?.ETag?.replace(/"/g, ""),
+                versionId: response.VersionId,
+                custom: options.metadata,
+            };
+            return {
+                key: toKey,
+                uri: this.uri(toKey, "s3"),
+                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 response = await this.client.send(new ListObjectsV2Command({
+                Bucket: this.config.bucket,
+                Prefix: prefix || undefined,
+                MaxKeys: options.limit,
+                ContinuationToken: options.cursor,
+            }));
+            const items = (response.Contents ?? []).map((obj) => ({
+                key: obj.Key,
+                metadata: {
+                    contentLength: obj.Size,
+                    etag: obj.ETag?.replace(/"/g, ""),
+                },
+            }));
+            return {
+                items,
+                cursor: response.IsTruncated ? response.NextContinuationToken : undefined,
+            };
+        }
+        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 objectKey = this.physicalKey(key);
+        const operation = options.operation ?? "get";
+        const expiresIn = options.expiresInSeconds ?? 300;
+        try {
+            const command = operation === "put"
+                ? new PutObjectCommand({
+                    Bucket: this.config.bucket,
+                    Key: objectKey,
+                    ContentType: options.contentType,
+                    Metadata: options.metadata,
+                })
+                : new GetObjectCommand({
+                    Bucket: this.config.bucket,
+                    Key: objectKey,
+                });
+            const url = await getSignedUrl(this.client, command, { expiresIn });
+            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 || err.name || "Unknown error";
+        const lower = message.toLowerCase();
+        const name = err.name || "";
+        const statusCode = err?.$metadata?.httpStatusCode;
+        if (name === "NotFound" ||
+            name === "NoSuchKey" ||
+            statusCode === 404 ||
+            lower.includes("not found") ||
+            lower.includes("nosuchkey")) {
+            return new NotFoundError(err);
+        }
+        if (name === "BucketAlreadyExists" ||
+            name === "BucketAlreadyOwnedByYou" ||
+            statusCode === 409 ||
+            lower.includes("already exists") ||
+            lower.includes("conflict")) {
+            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);
+    }
+    async ensureBucket(log) {
+        try {
+            await this.client.send(new CreateBucketCommand({ Bucket: this.config.bucket }));
+            log.verbose(`Created bucket ${this.config.bucket}`);
+        }
+        catch (error) {
+            const name = error?.name || "";
+            if (name === "BucketAlreadyExists" ||
+                name === "BucketAlreadyOwnedByYou" ||
+                error?.$metadata?.httpStatusCode === 409) {
+                log.verbose(`Bucket ${this.config.bucket} already exists`);
+                return;
+            }
+            throw this.parseError(error);
+        }
+    }
+}
+//# sourceMappingURL=S3BlobStoreService.js.map

package/lib/esm/blob/s3/S3BlobStoreService.js.map

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

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

@@ -0,0 +1,9 @@
+/**
+ * @module integrations/blob/s3
+ * @summary S3-compatible blob store exports.
+ * @description Re-exports the S3, MinIO, and R2 blob store services.
+ */
+export * from "./S3BlobStoreService.js";
+export * from "./MinioBlobStoreService.js";
+export * from "./R2BlobStoreService.js";
+//# sourceMappingURL=index.js.map

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

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

package/lib/esm/docker/DockerComposeService.js

@@ -75,12 +75,12 @@ let DockerComposeService = class DockerComposeService extends ClientBasedService
      */
     async waitForHealth(url, options = {}, ...args) {
         const { log } = await this.logCtx(args, this.waitForHealth, true);
-        const { maxAttempts = 60, interval = 2000 } = options;
+        const { maxAttempts = 60, interval = 2000, requireOk = true } = options;
         log.info(`Waiting for health check at ${url}`);
         for (let i = 0; i < maxAttempts; i++) {
             try {
                 const response = await fetch(url);
-                if (response.ok) {
+                if (!requireOk || response.ok) {
                     log.info(`Health check passed after ${i + 1} attempts`);
                     return true;
                 }

package/lib/esm/docker/DockerComposeService.js.map

@@ -1 +1 @@
-{"version":3,"file":"DockerComposeService.js","sourceRoot":"","sources":["../../../src/docker/DockerComposeService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DockerComposeService.js","sourceRoot":"","sources":["../../../src/docker/DockerComposeService.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EACL,kBAAkB,EAGlB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,sBAAiB;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAmBjD,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,kBAGzC;IACC;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED,KAAK,CAAC,UAAU,CACd,GAAG,IAAyB;QAE5B,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,CACvB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,cAAc,EAAE,IAAI,CAAC,CAC9D,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAA+B,CAAC;QAExD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACxB,MAAM,IAAI,aAAa,CACrB,kDAAkD,CACnD,CAAC;QACJ,CAAC;QAED,+BAA+B;QAC/B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,aAAa,CACrB,kCAAkC,MAAM,CAAC,WAAW,EAAE,CACvD,CAAC;QACJ,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,kCAAkC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAEjE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC,mDAAmD;QAE1E,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,IAAc,UAAU;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,IAAc,eAAe;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,QAAQ,GAAG,IAAI,EAAE,GAAG,IAA6B;QACxD,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACvD,MAAM,OAAO,GAAG,qBAAqB,IAAI,CAAC,eAAe,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAEvF,MAAM,eAAe,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,CAAC,CAAC;QAC9D,GAAG,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,GAAG,IAA6B;QACzC,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,qBAAqB,IAAI,CAAC,eAAe,iBAAiB,CAAC;QAE3E,MAAM,eAAe,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,CAAC,CAAC;QAC9D,GAAG,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,GAAG,IAA6B;QAC5C,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,qBAAqB,IAAI,CAAC,eAAe,UAAU,CAAC;QAEpE,MAAM,eAAe,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,CAAC,CAAC;QAC9D,GAAG,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,GAAW,EACX,UAAoC,EAAE,EACtC,GAAG,IAA6B;QAEhC,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAClE,MAAM,EAAE,WAAW,GAAG,EAAE,EAAE,QAAQ,GAAG,IAAI,EAAE,SAAS,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QAExE,GAAG,CAAC,IAAI,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC;QAE/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;gBAClC,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;oBAC9B,GAAG,CAAC,IAAI,CAAC,6BAA6B,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;oBACxD,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,KAAK,CAAC,wBAAwB,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC3D,CAAC;YAED,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAChE,CAAC;QAED,GAAG,CAAC,KAAK,CAAC,2BAA2B,GAAG,UAAU,WAAW,WAAW,CAAC,CAAC;QAC1E,MAAM,IAAI,aAAa,CACrB,2BAA2B,GAAG,UAAU,WAAW,WAAW,CAC/D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CACnB,aAAqB,EACrB,OAAe,EACf,GAAG,IAA6B;QAEhC,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,qBAAqB,IAAI,CAAC,eAAe,SAAS,aAAa,IAAI,OAAO,EAAE,CAAC;QAEjG,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,eAAe,CACtC,WAAW,EACX,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,EACxB,GAAG,CACJ,CAAC;QAEF,GAAG,CAAC,IAAI,CAAC,iCAAiC,aAAa,EAAE,CAAC,CAAC;QAC3D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,aAAsB,EACtB,IAAI,GAAG,GAAG,EACV,GAAG,IAA6B;QAEhC,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5D,MAAM,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,MAAM,OAAO,GAAG,qBAAqB,IAAI,CAAC,eAAe,SAAS,YAAY,WAAW,IAAI,EAAE,CAAC;QAEhG,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,eAAe,CACtC,OAAO,EACP,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,EACxB,GAAG,CACJ,CAAC;QAEF,GAAG,CAAC,IAAI,CAAC,sBAAsB,aAAa,IAAI,gBAAgB,EAAE,CAAC,CAAC;QACpE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CACb,aAAqB,EACrB,GAAG,IAA6B;QAEhC,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAE9D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,qBAAqB,IAAI,CAAC,eAAe,OAAO,aAAa,yBAAyB,CAAC;YACvG,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,eAAe,CACtC,OAAO,EACP,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,EACxB,GAAG,CACJ,CAAC;YAEF,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAClE,GAAG,CAAC,KAAK,CACP,aAAa,aAAa,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,CACzE,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,CAAC,KAAK,CAAC,aAAa,aAAa,iBAAiB,CAAC,CAAC;YACvD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF,CAAA;AA1LY,oBAAoB;IADhC,WAAW,CAAC,gEAAgE,CAAC;;GACjE,oBAAoB,CA0LhC"}

package/lib/esm/index.js

@@ -4,8 +4,8 @@
  * @description Exposes the package utilities and build-time version metadata for `@decaf-ts/integrations`.
  */
 export * from "./utils.js";
-export const VERSION = "0.1.2";
-export const COMMIT = "770d2e2";
-export const FULL_VERSION = "0.1.2-770d2e2";
+export const VERSION = "0.1.4";
+export const COMMIT = "96f5884";
+export const FULL_VERSION = "0.1.4-96f5884";
 export const PACKAGE_NAME = "@decaf-ts/integrations";
 //# sourceMappingURL=index.js.map

package/lib/types/blob/azure/AzureBlobStoreService.d.cts

@@ -0,0 +1,25 @@
+/**
+ * @module integrations/blob/azure/service
+ * @summary Azure Blob storage service.
+ * @description Blob store backed by Azure Blob Storage via @azure/storage-blob.
+ */
+import { type ContainerClient } from "@azure/storage-blob";
+import { type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
+import { BlobStoreService } from "../core/BlobStoreService.d.cts";
+import type { AzureBlobStoreServiceConfig, BlobGetOptions, BlobGetResult, BlobKey, BlobListOptions, BlobListResult, BlobMetadata, BlobPutOptions, BlobPutResult, BlobUrlOptions, BlobUrlResult, BlobValue } from "../core/BlobTypes.d.cts";
+export declare class AzureBlobStoreService extends BlobStoreService<ContainerClient, AzureBlobStoreServiceConfig> {
+    private blobServiceClient;
+    initialize(...args: ContextualArgs<any>): Promise<{
+        config: AzureBlobStoreServiceConfig;
+        client: ContainerClient;
+    }>;
+    put(key: BlobKey, value: BlobValue, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
+    get(key: BlobKey, options?: BlobGetOptions, ...args: MaybeContextualArg<any>): Promise<BlobGetResult>;
+    has(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<boolean>;
+    stat(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<BlobMetadata>;
+    delete(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<void>;
+    copy(fromKey: BlobKey, toKey: BlobKey, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
+    list(options?: BlobListOptions, ...args: MaybeContextualArg<any>): Promise<BlobListResult>;
+    url(key: BlobKey, options?: BlobUrlOptions, ...args: MaybeContextualArg<any>): Promise<BlobUrlResult>;
+    protected parseError(error: unknown): Error;
+}

package/lib/types/blob/azure/AzureBlobStoreService.d.mts

@@ -0,0 +1,25 @@
+/**
+ * @module integrations/blob/azure/service
+ * @summary Azure Blob storage service.
+ * @description Blob store backed by Azure Blob Storage via @azure/storage-blob.
+ */
+import { type ContainerClient } from "@azure/storage-blob";
+import { type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
+import { BlobStoreService } from "../core/BlobStoreService.d.mts";
+import type { AzureBlobStoreServiceConfig, BlobGetOptions, BlobGetResult, BlobKey, BlobListOptions, BlobListResult, BlobMetadata, BlobPutOptions, BlobPutResult, BlobUrlOptions, BlobUrlResult, BlobValue } from "../core/BlobTypes.d.mts";
+export declare class AzureBlobStoreService extends BlobStoreService<ContainerClient, AzureBlobStoreServiceConfig> {
+    private blobServiceClient;
+    initialize(...args: ContextualArgs<any>): Promise<{
+        config: AzureBlobStoreServiceConfig;
+        client: ContainerClient;
+    }>;
+    put(key: BlobKey, value: BlobValue, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
+    get(key: BlobKey, options?: BlobGetOptions, ...args: MaybeContextualArg<any>): Promise<BlobGetResult>;
+    has(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<boolean>;
+    stat(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<BlobMetadata>;
+    delete(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<void>;
+    copy(fromKey: BlobKey, toKey: BlobKey, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
+    list(options?: BlobListOptions, ...args: MaybeContextualArg<any>): Promise<BlobListResult>;
+    url(key: BlobKey, options?: BlobUrlOptions, ...args: MaybeContextualArg<any>): Promise<BlobUrlResult>;
+    protected parseError(error: unknown): Error;
+}

package/lib/types/blob/azure/index.d.cts

@@ -0,0 +1,6 @@
+/**
+ * @module integrations/blob/azure
+ * @summary Azure Blob storage exports.
+ * @description Re-exports the Azure Blob store service.
+ */
+export * from "./AzureBlobStoreService.d.cts";

package/lib/types/blob/azure/index.d.mts

@@ -0,0 +1,6 @@
+/**
+ * @module integrations/blob/azure
+ * @summary Azure Blob storage exports.
+ * @description Re-exports the Azure Blob store service.
+ */
+export * from "./AzureBlobStoreService.d.mts";

package/lib/types/blob/core/BlobErrors.d.cts

@@ -0,0 +1,14 @@
+/**
+ * @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 declare function translateBlobError(error: Error): Error;

package/lib/types/blob/core/BlobErrors.d.mts

@@ -0,0 +1,14 @@
+/**
+ * @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 declare function translateBlobError(error: Error): Error;

package/lib/types/blob/core/BlobKey.d.cts

@@ -0,0 +1,9 @@
+import type { BlobKey } from "./BlobTypes.d.cts";
+/**
+ * Strips leading slashes from a blob key and rejects unsafe path segments.
+ */
+export declare function cleanKey(key: BlobKey): string;
+/**
+ * Applies the configured prefix (trimmed of leading/trailing slashes) to a cleaned key.
+ */
+export declare function physicalKey(key: BlobKey, prefix?: string): string;

package/lib/types/blob/core/BlobKey.d.mts

@@ -0,0 +1,9 @@
+import type { BlobKey } from "./BlobTypes.d.mts";
+/**
+ * Strips leading slashes from a blob key and rejects unsafe path segments.
+ */
+export declare function cleanKey(key: BlobKey): string;
+/**
+ * Applies the configured prefix (trimmed of leading/trailing slashes) to a cleaned key.
+ */
+export declare function physicalKey(key: BlobKey, prefix?: string): string;

package/lib/types/blob/core/BlobStoreFactory.d.cts

@@ -0,0 +1,5 @@
+import type { BlobStoreServiceConfig } from "./BlobTypes.d.cts";
+import type { BlobStoreService } from "./BlobStoreService.d.cts";
+export declare class BlobStoreFactory {
+    create<T extends BlobStoreServiceConfig>(config: T): BlobStoreService;
+}

package/lib/types/blob/core/BlobStoreFactory.d.mts

@@ -0,0 +1,5 @@
+import type { BlobStoreServiceConfig } from "./BlobTypes.d.mts";
+import type { BlobStoreService } from "./BlobStoreService.d.mts";
+export declare class BlobStoreFactory {
+    create<T extends BlobStoreServiceConfig>(config: T): BlobStoreService;
+}

package/lib/types/blob/core/BlobStoreService.d.cts

@@ -0,0 +1,28 @@
+/**
+ * @module integrations/blob/core/service
+ * @summary Blob store service abstraction.
+ * @description Base abstraction for binary large object backends.
+ */
+import { ClientBasedService, type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
+import type { BlobGetOptions, BlobGetResult, BlobKey, BlobListOptions, BlobListResult, BlobMetadata, BlobProvider, BlobPutOptions, BlobPutResult, BlobStoreServiceConfig, BlobUrlOptions, BlobUrlResult, BlobValue } from "./BlobTypes.d.cts";
+export declare abstract class BlobStoreService<TClient = unknown, TConfig extends BlobStoreServiceConfig = BlobStoreServiceConfig> extends ClientBasedService<TClient, TConfig> {
+    constructor();
+    get provider(): BlobProvider;
+    get sourceId(): string;
+    abstract initialize(...args: ContextualArgs<any>): Promise<{
+        config: TConfig;
+        client: TClient;
+    }>;
+    abstract put(key: BlobKey, value: BlobValue, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
+    abstract get(key: BlobKey, options?: BlobGetOptions, ...args: MaybeContextualArg<any>): Promise<BlobGetResult>;
+    abstract has(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<boolean>;
+    abstract stat(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<BlobMetadata>;
+    abstract delete(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<void>;
+    abstract copy(fromKey: BlobKey, toKey: BlobKey, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
+    abstract list(options?: BlobListOptions, ...args: MaybeContextualArg<any>): Promise<BlobListResult>;
+    abstract url(key: BlobKey, options?: BlobUrlOptions, ...args: MaybeContextualArg<any>): Promise<BlobUrlResult>;
+    protected physicalKey(key: BlobKey): string;
+    protected cleanKey(key: BlobKey): string;
+    protected getConfigFromArgs<TExpected extends TConfig>(...args: MaybeContextualArg<any>): TExpected;
+    protected uri(key: BlobKey, scheme: string, extra?: string): string;
+}

package/lib/types/blob/core/BlobStoreService.d.mts

@@ -0,0 +1,28 @@
+/**
+ * @module integrations/blob/core/service
+ * @summary Blob store service abstraction.
+ * @description Base abstraction for binary large object backends.
+ */
+import { ClientBasedService, type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
+import type { BlobGetOptions, BlobGetResult, BlobKey, BlobListOptions, BlobListResult, BlobMetadata, BlobProvider, BlobPutOptions, BlobPutResult, BlobStoreServiceConfig, BlobUrlOptions, BlobUrlResult, BlobValue } from "./BlobTypes.d.mts";
+export declare abstract class BlobStoreService<TClient = unknown, TConfig extends BlobStoreServiceConfig = BlobStoreServiceConfig> extends ClientBasedService<TClient, TConfig> {
+    constructor();
+    get provider(): BlobProvider;
+    get sourceId(): string;
+    abstract initialize(...args: ContextualArgs<any>): Promise<{
+        config: TConfig;
+        client: TClient;
+    }>;
+    abstract put(key: BlobKey, value: BlobValue, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
+    abstract get(key: BlobKey, options?: BlobGetOptions, ...args: MaybeContextualArg<any>): Promise<BlobGetResult>;
+    abstract has(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<boolean>;
+    abstract stat(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<BlobMetadata>;
+    abstract delete(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<void>;
+    abstract copy(fromKey: BlobKey, toKey: BlobKey, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
+    abstract list(options?: BlobListOptions, ...args: MaybeContextualArg<any>): Promise<BlobListResult>;
+    abstract url(key: BlobKey, options?: BlobUrlOptions, ...args: MaybeContextualArg<any>): Promise<BlobUrlResult>;
+    protected physicalKey(key: BlobKey): string;
+    protected cleanKey(key: BlobKey): string;
+    protected getConfigFromArgs<TExpected extends TConfig>(...args: MaybeContextualArg<any>): TExpected;
+    protected uri(key: BlobKey, scheme: string, extra?: string): string;
+}