@decaf-ts/integrations 0.1.3 → 0.2.0

package/lib/types/blob/memory/MemoryBlobStoreService.d.cts

@@ -0,0 +1,28 @@
+/**
+ * @module integrations/blob/memory/service
+ * @summary In-memory blob store service.
+ * @description Process-local Map-backed blob store for tests and examples. No SDK dependency.
+ */
+import { type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
+import { BlobStoreService } from "../core/BlobStoreService.d.cts";
+import type { BlobGetOptions, BlobGetResult, BlobKey, BlobListOptions, BlobListResult, BlobMetadata, BlobPutOptions, BlobPutResult, BlobStoreServiceConfig, BlobUrlOptions, BlobUrlResult, BlobValue } from "../core/BlobTypes.d.cts";
+interface MemoryEntry {
+    value: Buffer;
+    metadata: BlobMetadata;
+}
+export declare class MemoryBlobStoreService extends BlobStoreService<Map<string, MemoryEntry>, BlobStoreServiceConfig> {
+    initialize(...args: ContextualArgs<any>): Promise<{
+        config: BlobStoreServiceConfig;
+        client: Map<string, MemoryEntry>;
+    }>;
+    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;
+}
+export {};

package/lib/types/blob/memory/MemoryBlobStoreService.d.mts

@@ -0,0 +1,28 @@
+/**
+ * @module integrations/blob/memory/service
+ * @summary In-memory blob store service.
+ * @description Process-local Map-backed blob store for tests and examples. No SDK dependency.
+ */
+import { type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
+import { BlobStoreService } from "../core/BlobStoreService.d.mts";
+import type { BlobGetOptions, BlobGetResult, BlobKey, BlobListOptions, BlobListResult, BlobMetadata, BlobPutOptions, BlobPutResult, BlobStoreServiceConfig, BlobUrlOptions, BlobUrlResult, BlobValue } from "../core/BlobTypes.d.mts";
+interface MemoryEntry {
+    value: Buffer;
+    metadata: BlobMetadata;
+}
+export declare class MemoryBlobStoreService extends BlobStoreService<Map<string, MemoryEntry>, BlobStoreServiceConfig> {
+    initialize(...args: ContextualArgs<any>): Promise<{
+        config: BlobStoreServiceConfig;
+        client: Map<string, MemoryEntry>;
+    }>;
+    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;
+}
+export {};

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

@@ -0,0 +1,6 @@
+/**
+ * @module integrations/blob/memory
+ * @summary In-memory blob store exports.
+ * @description Re-exports the in-memory blob store service.
+ */
+export * from "./MemoryBlobStoreService.d.cts";

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

@@ -0,0 +1,6 @@
+/**
+ * @module integrations/blob/memory
+ * @summary In-memory blob store exports.
+ * @description Re-exports the in-memory blob store service.
+ */
+export * from "./MemoryBlobStoreService.d.mts";

package/lib/types/blob/s3/MinioBlobStoreService.d.cts

@@ -0,0 +1,8 @@
+/**
+ * @module integrations/blob/s3/minio
+ * @summary MinIO blob store service.
+ * @description S3-compatible blob store for MinIO. Extends S3BlobStoreService.
+ */
+import { S3BlobStoreService } from "./S3BlobStoreService.d.cts";
+export declare class MinioBlobStoreService extends S3BlobStoreService {
+}

package/lib/types/blob/s3/MinioBlobStoreService.d.mts

@@ -0,0 +1,8 @@
+/**
+ * @module integrations/blob/s3/minio
+ * @summary MinIO blob store service.
+ * @description S3-compatible blob store for MinIO. Extends S3BlobStoreService.
+ */
+import { S3BlobStoreService } from "./S3BlobStoreService.d.mts";
+export declare class MinioBlobStoreService extends S3BlobStoreService {
+}

package/lib/types/blob/s3/R2BlobStoreService.d.cts

@@ -0,0 +1,8 @@
+/**
+ * @module integrations/blob/s3/r2
+ * @summary Cloudflare R2 blob store service.
+ * @description S3-compatible blob store for Cloudflare R2. Extends S3BlobStoreService.
+ */
+import { S3BlobStoreService } from "./S3BlobStoreService.d.cts";
+export declare class R2BlobStoreService extends S3BlobStoreService {
+}

package/lib/types/blob/s3/R2BlobStoreService.d.mts

@@ -0,0 +1,8 @@
+/**
+ * @module integrations/blob/s3/r2
+ * @summary Cloudflare R2 blob store service.
+ * @description S3-compatible blob store for Cloudflare R2. Extends S3BlobStoreService.
+ */
+import { S3BlobStoreService } from "./S3BlobStoreService.d.mts";
+export declare class R2BlobStoreService extends S3BlobStoreService {
+}

package/lib/types/blob/s3/S3BlobStoreService.d.cts

@@ -0,0 +1,25 @@
+/**
+ * @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 { S3Client } from "@aws-sdk/client-s3";
+import { type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
+import { BlobStoreService } from "../core/BlobStoreService.d.cts";
+import type { BlobGetOptions, BlobGetResult, BlobKey, BlobListOptions, BlobListResult, BlobMetadata, BlobPutOptions, BlobPutResult, BlobUrlOptions, BlobUrlResult, BlobValue, S3BlobStoreServiceConfig } from "../core/BlobTypes.d.cts";
+export declare class S3BlobStoreService extends BlobStoreService<S3Client, S3BlobStoreServiceConfig> {
+    initialize(...args: ContextualArgs<any>): Promise<{
+        config: S3BlobStoreServiceConfig;
+        client: S3Client;
+    }>;
+    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;
+    private ensureBucket;
+}

package/lib/types/blob/s3/S3BlobStoreService.d.mts

@@ -0,0 +1,25 @@
+/**
+ * @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 { S3Client } from "@aws-sdk/client-s3";
+import { type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
+import { BlobStoreService } from "../core/BlobStoreService.d.mts";
+import type { BlobGetOptions, BlobGetResult, BlobKey, BlobListOptions, BlobListResult, BlobMetadata, BlobPutOptions, BlobPutResult, BlobUrlOptions, BlobUrlResult, BlobValue, S3BlobStoreServiceConfig } from "../core/BlobTypes.d.mts";
+export declare class S3BlobStoreService extends BlobStoreService<S3Client, S3BlobStoreServiceConfig> {
+    initialize(...args: ContextualArgs<any>): Promise<{
+        config: S3BlobStoreServiceConfig;
+        client: S3Client;
+    }>;
+    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;
+    private ensureBucket;
+}

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

@@ -0,0 +1,8 @@
+/**
+ * @module integrations/blob/s3
+ * @summary S3-compatible blob store exports.
+ * @description Re-exports the S3, MinIO, and R2 blob store services.
+ */
+export * from "./S3BlobStoreService.d.cts";
+export * from "./MinioBlobStoreService.d.cts";
+export * from "./R2BlobStoreService.d.cts";

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

@@ -0,0 +1,8 @@
+/**
+ * @module integrations/blob/s3
+ * @summary S3-compatible blob store exports.
+ * @description Re-exports the S3, MinIO, and R2 blob store services.
+ */
+export * from "./S3BlobStoreService.d.mts";
+export * from "./MinioBlobStoreService.d.mts";
+export * from "./R2BlobStoreService.d.mts";

package/lib/types/docker/DockerComposeService.d.cts

@@ -6,6 +6,12 @@ interface DockerComposeServiceConfig {
 interface DockerHealthCheckOptions {
     maxAttempts?: number;
     interval?: number;
+    /**
+     * When true (default), only HTTP 2xx responses count as healthy.
+     * When false, any HTTP response (i.e. the port is accepting connections) counts as healthy.
+     * Set to false for emulators that do not expose an unauthenticated 2xx health endpoint.
+     */
+    requireOk?: boolean;
 }
 export declare class DockerComposeService extends ClientBasedService<void, DockerComposeServiceConfig> {
     constructor();

package/lib/types/docker/DockerComposeService.d.mts

@@ -6,6 +6,12 @@ interface DockerComposeServiceConfig {
 interface DockerHealthCheckOptions {
     maxAttempts?: number;
     interval?: number;
+    /**
+     * When true (default), only HTTP 2xx responses count as healthy.
+     * When false, any HTTP response (i.e. the port is accepting connections) counts as healthy.
+     * Set to false for emulators that do not expose an unauthenticated 2xx health endpoint.
+     */
+    requireOk?: boolean;
 }
 export declare class DockerComposeService extends ClientBasedService<void, DockerComposeServiceConfig> {
     constructor();

package/lib/types/index.d.cts

@@ -5,6 +5,6 @@
  */
 export * from "./utils.d.cts";
 export declare const VERSION: string;
-export declare const COMMIT = "770d2e2";
-export declare const FULL_VERSION = "0.1.2-770d2e2";
+export declare const COMMIT = "96f5884";
+export declare const FULL_VERSION = "0.1.4-96f5884";
 export declare const PACKAGE_NAME: string;

package/lib/types/index.d.mts

@@ -5,6 +5,6 @@
  */
 export * from "./utils.d.mts";
 export declare const VERSION: string;
-export declare const COMMIT = "770d2e2";
-export declare const FULL_VERSION = "0.1.2-770d2e2";
+export declare const COMMIT = "96f5884";
+export declare const FULL_VERSION = "0.1.4-96f5884";
 export declare const PACKAGE_NAME: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/integrations",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.mts",
@@ -125,6 +125,83 @@
         "default": "./lib/cjs/secrets/vault/index.cjs"
       },
       "default": "./lib/esm/secrets/vault/index.js"
+    },
+    "./blob": {
+      "import": {
+        "types": "./lib/types/blob/index.d.mts",
+        "default": "./lib/esm/blob/index.js"
+      },
+      "require": {
+        "types": "./lib/types/blob/index.d.cts",
+        "default": "./lib/cjs/blob/index.cjs"
+      },
+      "default": "./lib/esm/blob/index.js"
+    },
+    "./blob/s3": {
+      "import": {
+        "types": "./lib/types/blob/s3/index.d.mts",
+        "default": "./lib/esm/blob/s3/index.js"
+      },
+      "require": {
+        "types": "./lib/types/blob/s3/index.d.cts",
+        "default": "./lib/cjs/blob/s3/index.cjs"
+      },
+      "default": "./lib/esm/blob/s3/index.js"
+    },
+    "./blob/azure": {
+      "import": {
+        "types": "./lib/types/blob/azure/index.d.mts",
+        "default": "./lib/esm/blob/azure/index.js"
+      },
+      "require": {
+        "types": "./lib/types/blob/azure/index.d.cts",
+        "default": "./lib/cjs/blob/azure/index.cjs"
+      },
+      "default": "./lib/esm/blob/azure/index.js"
+    },
+    "./blob/gcp": {
+      "import": {
+        "types": "./lib/types/blob/gcp/index.d.mts",
+        "default": "./lib/esm/blob/gcp/index.js"
+      },
+      "require": {
+        "types": "./lib/types/blob/gcp/index.d.cts",
+        "default": "./lib/cjs/blob/gcp/index.cjs"
+      },
+      "default": "./lib/esm/blob/gcp/index.js"
+    },
+    "./blob/local": {
+      "import": {
+        "types": "./lib/types/blob/local/index.d.mts",
+        "default": "./lib/esm/blob/local/index.js"
+      },
+      "require": {
+        "types": "./lib/types/blob/local/index.d.cts",
+        "default": "./lib/cjs/blob/local/index.cjs"
+      },
+      "default": "./lib/esm/blob/local/index.js"
+    },
+    "./blob/ipfs": {
+      "import": {
+        "types": "./lib/types/blob/ipfs/index.d.mts",
+        "default": "./lib/esm/blob/ipfs/index.js"
+      },
+      "require": {
+        "types": "./lib/types/blob/ipfs/index.d.cts",
+        "default": "./lib/cjs/blob/ipfs/index.cjs"
+      },
+      "default": "./lib/esm/blob/ipfs/index.js"
+    },
+    "./blob/memory": {
+      "import": {
+        "types": "./lib/types/blob/memory/index.d.mts",
+        "default": "./lib/esm/blob/memory/index.js"
+      },
+      "require": {
+        "types": "./lib/types/blob/memory/index.d.cts",
+        "default": "./lib/cjs/blob/memory/index.cjs"
+      },
+      "default": "./lib/esm/blob/memory/index.js"
     }
   },
   "scripts": {
@@ -137,11 +214,11 @@
     "reset": "rm -rf * && git checkout . && git pull && npm run do-install",
     "build": "build-scripts --dev",
     "build:prod": "build-scripts --prod",
-    "test": "npm run build && jest --runInBand --coverage --detectOpenHandles",
-    "test:unit": "jest --testPathPatterns=\"/tests/unit\" --passWithNoTests --detectOpenHandles",
-    "test:integration": "jest --testPathPatterns=\"/tests/(integration)\" --passWithNoTests --detectOpenHandles",
-    "test:e2e": "jest --testPathPatterns=\"/tests/(e2e)\" --passWithNoTests --detectOpenHandles",
-    "test:all": "jest --testPathPatterns=\"/tests\" --passWithNoTests",
+    "test": "npm run build && NODE_OPTIONS=\"--experimental-vm-modules\" jest --runInBand --coverage --detectOpenHandles",
+    "test:unit": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --testPathPatterns=\"/tests/unit\" --passWithNoTests --detectOpenHandles",
+    "test:integration": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --testPathPatterns=\"/tests/(integration)\" --passWithNoTests --detectOpenHandles",
+    "test:e2e": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --testPathPatterns=\"/tests/(e2e)\" --passWithNoTests --detectOpenHandles",
+    "test:all": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --runInBand --testPathPatterns=\"/tests\" --passWithNoTests",
     "test:circular": "dpdm -T --no-warning --no-tree ./src/index.ts",
     "coverage": "rimraf ./workdocs/reports/data/*.json && npm run test:all -- --coverage --config=./workdocs/reports/jest.coverage.config.cjs",
     "lint": "eslint .",
@@ -183,13 +260,18 @@
     "js-yaml": "^4.2.0"
   },
   "optionalDependencies": {
+    "@aws-sdk/client-s3": "^3.1075.0",
     "@aws-sdk/client-secrets-manager": "^3.758.0",
+    "@aws-sdk/s3-request-presigner": "^3.1075.0",
     "@azure/identity": "^4.13.1",
     "@azure/keyvault-secrets": "^4.9.0",
+    "@azure/storage-blob": "^12.33.0",
     "@google-cloud/secret-manager": "^5.6.0",
+    "@google-cloud/storage": "^7.21.0",
     "aws-sdk": "^2.1691.0",
     "hashicorp-vault": "^0.1.0",
     "keycloak-admin": "^24.0.5",
+    "kubo-rpc-client": "^7.1.0",
     "onelogin-node": "^0.1.0"
   }
 }