@decaf-ts/integrations 0.1.2 → 0.1.4

package/lib/types/blob/ipfs/IpfsBlobStoreService.d.cts

@@ -0,0 +1,26 @@
+/**
+ * @module integrations/blob/ipfs/service
+ * @summary IPFS blob store service.
+ * @description Blob store backed by an IPFS (Kubo) node. Because the blob API is key/value CRUD-like
+ * and IPFS is content-addressed, an IpfsKeyIndex maps logical keys to CIDs.
+ */
+import { type KuboRPCClient } from "kubo-rpc-client";
+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, IpfsBlobStoreServiceConfig } from "../core/BlobTypes.d.cts";
+export declare class IpfsBlobStoreService extends BlobStoreService<KuboRPCClient, IpfsBlobStoreServiceConfig> {
+    private index;
+    initialize(...args: ContextualArgs<any>): Promise<{
+        config: IpfsBlobStoreServiceConfig;
+        client: KuboRPCClient;
+    }>;
+    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/ipfs/IpfsBlobStoreService.d.mts

@@ -0,0 +1,26 @@
+/**
+ * @module integrations/blob/ipfs/service
+ * @summary IPFS blob store service.
+ * @description Blob store backed by an IPFS (Kubo) node. Because the blob API is key/value CRUD-like
+ * and IPFS is content-addressed, an IpfsKeyIndex maps logical keys to CIDs.
+ */
+import { type KuboRPCClient } from "kubo-rpc-client";
+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, IpfsBlobStoreServiceConfig } from "../core/BlobTypes.d.mts";
+export declare class IpfsBlobStoreService extends BlobStoreService<KuboRPCClient, IpfsBlobStoreServiceConfig> {
+    private index;
+    initialize(...args: ContextualArgs<any>): Promise<{
+        config: IpfsBlobStoreServiceConfig;
+        client: KuboRPCClient;
+    }>;
+    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/ipfs/IpfsKeyIndex.d.cts

@@ -0,0 +1,9 @@
+import type { BlobListResult, BlobMetadata, IpfsKeyIndexConfig } from "../core/BlobTypes.d.cts";
+export interface IpfsKeyIndex {
+    get(key: string): Promise<string | undefined>;
+    set(key: string, cid: string, metadata?: BlobMetadata): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix?: string, limit?: number, cursor?: string): Promise<BlobListResult>;
+    stat(key: string): Promise<BlobMetadata>;
+}
+export declare function createIpfsKeyIndex(config: IpfsKeyIndexConfig): IpfsKeyIndex;

package/lib/types/blob/ipfs/IpfsKeyIndex.d.mts

@@ -0,0 +1,9 @@
+import type { BlobListResult, BlobMetadata, IpfsKeyIndexConfig } from "../core/BlobTypes.d.mts";
+export interface IpfsKeyIndex {
+    get(key: string): Promise<string | undefined>;
+    set(key: string, cid: string, metadata?: BlobMetadata): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix?: string, limit?: number, cursor?: string): Promise<BlobListResult>;
+    stat(key: string): Promise<BlobMetadata>;
+}
+export declare function createIpfsKeyIndex(config: IpfsKeyIndexConfig): IpfsKeyIndex;

package/lib/types/blob/ipfs/LocalJsonIpfsKeyIndex.d.cts

@@ -0,0 +1,11 @@
+import type { BlobListResult, BlobMetadata } from "../core/BlobTypes.d.cts";
+import type { IpfsKeyIndex } from "./IpfsKeyIndex.d.cts";
+export declare class LocalJsonIpfsKeyIndex implements IpfsKeyIndex {
+    private readonly path;
+    constructor(path: string);
+    get(key: string): Promise<string | undefined>;
+    set(key: string, cid: string, metadata?: BlobMetadata): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix?: string, limit?: number, cursor?: string): Promise<BlobListResult>;
+    stat(key: string): Promise<BlobMetadata>;
+}

package/lib/types/blob/ipfs/LocalJsonIpfsKeyIndex.d.mts

@@ -0,0 +1,11 @@
+import type { BlobListResult, BlobMetadata } from "../core/BlobTypes.d.mts";
+import type { IpfsKeyIndex } from "./IpfsKeyIndex.d.mts";
+export declare class LocalJsonIpfsKeyIndex implements IpfsKeyIndex {
+    private readonly path;
+    constructor(path: string);
+    get(key: string): Promise<string | undefined>;
+    set(key: string, cid: string, metadata?: BlobMetadata): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix?: string, limit?: number, cursor?: string): Promise<BlobListResult>;
+    stat(key: string): Promise<BlobMetadata>;
+}

package/lib/types/blob/ipfs/MemoryIpfsKeyIndex.d.cts

@@ -0,0 +1,15 @@
+/**
+ * @module integrations/blob/ipfs/memory-index
+ * @summary In-memory IPFS key index.
+ * @description Process-local Map-backed key index for tests and examples.
+ */
+import type { BlobListResult, BlobMetadata } from "../core/BlobTypes.d.cts";
+import type { IpfsKeyIndex } from "./IpfsKeyIndex.d.cts";
+export declare class MemoryIpfsKeyIndex implements IpfsKeyIndex {
+    private readonly values;
+    get(key: string): Promise<string | undefined>;
+    set(key: string, cid: string, metadata?: BlobMetadata): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix?: string, limit?: number, cursor?: string): Promise<BlobListResult>;
+    stat(key: string): Promise<BlobMetadata>;
+}

package/lib/types/blob/ipfs/MemoryIpfsKeyIndex.d.mts

@@ -0,0 +1,15 @@
+/**
+ * @module integrations/blob/ipfs/memory-index
+ * @summary In-memory IPFS key index.
+ * @description Process-local Map-backed key index for tests and examples.
+ */
+import type { BlobListResult, BlobMetadata } from "../core/BlobTypes.d.mts";
+import type { IpfsKeyIndex } from "./IpfsKeyIndex.d.mts";
+export declare class MemoryIpfsKeyIndex implements IpfsKeyIndex {
+    private readonly values;
+    get(key: string): Promise<string | undefined>;
+    set(key: string, cid: string, metadata?: BlobMetadata): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix?: string, limit?: number, cursor?: string): Promise<BlobListResult>;
+    stat(key: string): Promise<BlobMetadata>;
+}

package/lib/types/blob/ipfs/PostgresIpfsKeyIndex.d.cts

@@ -0,0 +1,11 @@
+import type { BlobListResult, BlobMetadata } from "../core/BlobTypes.d.cts";
+import type { IpfsKeyIndex } from "./IpfsKeyIndex.d.cts";
+export declare class PostgresIpfsKeyIndex implements IpfsKeyIndex {
+    private readonly connectionRef;
+    constructor(connectionRef: string);
+    get(key: string): Promise<string | undefined>;
+    set(key: string, cid: string, metadata?: BlobMetadata): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix?: string, limit?: number, cursor?: string): Promise<BlobListResult>;
+    stat(key: string): Promise<BlobMetadata>;
+}

package/lib/types/blob/ipfs/PostgresIpfsKeyIndex.d.mts

@@ -0,0 +1,11 @@
+import type { BlobListResult, BlobMetadata } from "../core/BlobTypes.d.mts";
+import type { IpfsKeyIndex } from "./IpfsKeyIndex.d.mts";
+export declare class PostgresIpfsKeyIndex implements IpfsKeyIndex {
+    private readonly connectionRef;
+    constructor(connectionRef: string);
+    get(key: string): Promise<string | undefined>;
+    set(key: string, cid: string, metadata?: BlobMetadata): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix?: string, limit?: number, cursor?: string): Promise<BlobListResult>;
+    stat(key: string): Promise<BlobMetadata>;
+}

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

@@ -0,0 +1,10 @@
+/**
+ * @module integrations/blob/ipfs
+ * @summary IPFS blob store exports.
+ * @description Re-exports the IPFS blob store service and key-index abstraction.
+ */
+export * from "./IpfsBlobStoreService.d.cts";
+export * from "./IpfsKeyIndex.d.cts";
+export * from "./MemoryIpfsKeyIndex.d.cts";
+export * from "./PostgresIpfsKeyIndex.d.cts";
+export * from "./LocalJsonIpfsKeyIndex.d.cts";

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

@@ -0,0 +1,10 @@
+/**
+ * @module integrations/blob/ipfs
+ * @summary IPFS blob store exports.
+ * @description Re-exports the IPFS blob store service and key-index abstraction.
+ */
+export * from "./IpfsBlobStoreService.d.mts";
+export * from "./IpfsKeyIndex.d.mts";
+export * from "./MemoryIpfsKeyIndex.d.mts";
+export * from "./PostgresIpfsKeyIndex.d.mts";
+export * from "./LocalJsonIpfsKeyIndex.d.mts";

package/lib/types/blob/local/LocalBlobStoreService.d.cts

@@ -0,0 +1,30 @@
+/**
+ * @module integrations/blob/local/service
+ * @summary Local filesystem blob store service.
+ * @description Filesystem-backed blob store wrapping node:fs with atomic writes and path-traversal protection.
+ */
+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, LocalBlobStoreServiceConfig } from "../core/BlobTypes.d.cts";
+interface LocalFsClient {
+    root: string;
+}
+export declare class LocalBlobStoreService extends BlobStoreService<LocalFsClient, LocalBlobStoreServiceConfig> {
+    initialize(...args: ContextualArgs<any>): Promise<{
+        config: LocalBlobStoreServiceConfig;
+        client: LocalFsClient;
+    }>;
+    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 safePath;
+    private safeStat;
+    private atomicWrite;
+}
+export {};

package/lib/types/blob/local/LocalBlobStoreService.d.mts

@@ -0,0 +1,30 @@
+/**
+ * @module integrations/blob/local/service
+ * @summary Local filesystem blob store service.
+ * @description Filesystem-backed blob store wrapping node:fs with atomic writes and path-traversal protection.
+ */
+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, LocalBlobStoreServiceConfig } from "../core/BlobTypes.d.mts";
+interface LocalFsClient {
+    root: string;
+}
+export declare class LocalBlobStoreService extends BlobStoreService<LocalFsClient, LocalBlobStoreServiceConfig> {
+    initialize(...args: ContextualArgs<any>): Promise<{
+        config: LocalBlobStoreServiceConfig;
+        client: LocalFsClient;
+    }>;
+    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 safePath;
+    private safeStat;
+    private atomicWrite;
+}
+export {};

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

@@ -0,0 +1,6 @@
+/**
+ * @module integrations/blob/local
+ * @summary Local filesystem blob store exports.
+ * @description Re-exports the local filesystem blob store service.
+ */
+export * from "./LocalBlobStoreService.d.cts";

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

@@ -0,0 +1,6 @@
+/**
+ * @module integrations/blob/local
+ * @summary Local filesystem blob store exports.
+ * @description Re-exports the local filesystem blob store service.
+ */
+export * from "./LocalBlobStoreService.d.mts";

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 = "3666be9";
-export declare const FULL_VERSION = "0.1.1-3666be9";
+export declare const COMMIT = "35fecfa";
+export declare const FULL_VERSION = "0.1.3-35fecfa";
 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 = "3666be9";
-export declare const FULL_VERSION = "0.1.1-3666be9";
+export declare const COMMIT = "35fecfa";
+export declare const FULL_VERSION = "0.1.3-35fecfa";
 export declare const PACKAGE_NAME: string;