@decaf-ts/integrations 0.8.0 → 0.10.0

package/lib/types/blob/gcp/GcsBlobEnvironment.d.mts

@@ -0,0 +1,17 @@
+export interface GcsBlobEnvironmentConfig {
+    sourceId: string;
+    bucket: string;
+    projectId?: string;
+    apiEndpoint?: string;
+    prefix?: string;
+}
+export interface GcsBlobEnvironmentShape {
+    blobs: {
+        gcs: GcsBlobEnvironmentConfig;
+    };
+}
+export declare const GcsBlobEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").BlobCommonEnvironmentShape & GcsBlobEnvironmentShape>;

package/lib/types/blob/gcp/GcsBlobStoreService.d.cts

@@ -7,8 +7,44 @@ import { type Bucket } from "@google-cloud/storage";
 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, GcsBlobStoreServiceConfig } from "../core/BlobTypes.d.cts";
+/**
+ * @description Google Cloud Storage blob store service registered as `blob-gcs`
+ * @summary Stores blobs in a GCS bucket via `@google-cloud/storage`,
+ * authenticating with optional explicit credentials or the environment's
+ * application default credentials.
+ * @class GcsBlobStoreService
+ * @memberOf module:integrations/blob/gcp/service
+ */
 export declare class GcsBlobStoreService extends BlobStoreService<Bucket, GcsBlobStoreServiceConfig> {
+    /**
+     * @description The `Storage` client used to resolve the bucket
+     * @summary Built in `initialize()` from the resolved config.
+     * @type {Storage}
+     * @private
+     */
     private storage;
+    /**
+     * @description Builds the GCS blob config from the environment
+     * @summary Reads the `blobs.gcs` environment slice; considered
+     * unconfigured when no `bucket` is set, which keeps the auto-boot
+     * fallback (see `getConfigFromArgs`) resolving to `undefined`.
+     * @return {GcsBlobStoreServiceConfig | undefined} The environment-derived config, or `undefined` when unconfigured
+     */
+    protected configFromEnvironment(): GcsBlobStoreServiceConfig | undefined;
+    /**
+     * @description Initializes the GCS bucket client
+     * @summary Resolves the config via `getConfigFromArgs` (explicit config,
+     * then the `blobs.gcs` environment slice). When no config resolves during a
+     * context-bearing auto-boot of an unconfigured provider, returns
+     * `skipInitialization()` so `Service.boot` does not throw; an explicit
+     * `initialize()` with no resolvable config still throws a
+     * `ValidationError`. Requires a `bucket`, builds the `Storage` client with
+     * the configured project ID, credentials, and API endpoint, and stores the
+     * bucket client.
+     * @param {...ContextualArgs<any>} args - An optional `GcsBlobStoreServiceConfig`, optionally followed by a decaf `Context`
+     * @return {Promise<{config: GcsBlobStoreServiceConfig, client: Bucket}>} The resolved config and the bucket client
+     * @throws {InternalError} When a resolved config has no `bucket`
+     */
     initialize(...args: ContextualArgs<any>): Promise<{
         config: GcsBlobStoreServiceConfig;
         client: Bucket;

package/lib/types/blob/gcp/GcsBlobStoreService.d.mts

@@ -7,8 +7,44 @@ import { type Bucket } from "@google-cloud/storage";
 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, GcsBlobStoreServiceConfig } from "../core/BlobTypes.d.mts";
+/**
+ * @description Google Cloud Storage blob store service registered as `blob-gcs`
+ * @summary Stores blobs in a GCS bucket via `@google-cloud/storage`,
+ * authenticating with optional explicit credentials or the environment's
+ * application default credentials.
+ * @class GcsBlobStoreService
+ * @memberOf module:integrations/blob/gcp/service
+ */
 export declare class GcsBlobStoreService extends BlobStoreService<Bucket, GcsBlobStoreServiceConfig> {
+    /**
+     * @description The `Storage` client used to resolve the bucket
+     * @summary Built in `initialize()` from the resolved config.
+     * @type {Storage}
+     * @private
+     */
     private storage;
+    /**
+     * @description Builds the GCS blob config from the environment
+     * @summary Reads the `blobs.gcs` environment slice; considered
+     * unconfigured when no `bucket` is set, which keeps the auto-boot
+     * fallback (see `getConfigFromArgs`) resolving to `undefined`.
+     * @return {GcsBlobStoreServiceConfig | undefined} The environment-derived config, or `undefined` when unconfigured
+     */
+    protected configFromEnvironment(): GcsBlobStoreServiceConfig | undefined;
+    /**
+     * @description Initializes the GCS bucket client
+     * @summary Resolves the config via `getConfigFromArgs` (explicit config,
+     * then the `blobs.gcs` environment slice). When no config resolves during a
+     * context-bearing auto-boot of an unconfigured provider, returns
+     * `skipInitialization()` so `Service.boot` does not throw; an explicit
+     * `initialize()` with no resolvable config still throws a
+     * `ValidationError`. Requires a `bucket`, builds the `Storage` client with
+     * the configured project ID, credentials, and API endpoint, and stores the
+     * bucket client.
+     * @param {...ContextualArgs<any>} args - An optional `GcsBlobStoreServiceConfig`, optionally followed by a decaf `Context`
+     * @return {Promise<{config: GcsBlobStoreServiceConfig, client: Bucket}>} The resolved config and the bucket client
+     * @throws {InternalError} When a resolved config has no `bucket`
+     */
     initialize(...args: ContextualArgs<any>): Promise<{
         config: GcsBlobStoreServiceConfig;
         client: Bucket;

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

@@ -4,3 +4,4 @@
  * @description Re-exports the GCS blob store service.
  */
 export * from "./GcsBlobStoreService.d.cts";
+export * from "./GcsBlobEnvironment.d.cts";

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

@@ -4,3 +4,4 @@
  * @description Re-exports the GCS blob store service.
  */
 export * from "./GcsBlobStoreService.d.mts";
+export * from "./GcsBlobEnvironment.d.mts";

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

@@ -0,0 +1,24 @@
+export interface IpfsKeyIndexEnvironmentConfig {
+    provider: "memory" | "postgres" | "local-json";
+    connectionRef?: string;
+    path?: string;
+}
+export interface IpfsBlobEnvironmentConfig {
+    sourceId: string;
+    apiUrl?: string;
+    gatewayUrl?: string;
+    pinByDefault?: boolean;
+    encryptedOnly?: boolean;
+    prefix?: string;
+    keyIndex: IpfsKeyIndexEnvironmentConfig;
+}
+export interface IpfsBlobEnvironmentShape {
+    blobs: {
+        ipfs: IpfsBlobEnvironmentConfig;
+    };
+}
+export declare const IpfsBlobEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").BlobCommonEnvironmentShape & IpfsBlobEnvironmentShape>;

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

@@ -0,0 +1,24 @@
+export interface IpfsKeyIndexEnvironmentConfig {
+    provider: "memory" | "postgres" | "local-json";
+    connectionRef?: string;
+    path?: string;
+}
+export interface IpfsBlobEnvironmentConfig {
+    sourceId: string;
+    apiUrl?: string;
+    gatewayUrl?: string;
+    pinByDefault?: boolean;
+    encryptedOnly?: boolean;
+    prefix?: string;
+    keyIndex: IpfsKeyIndexEnvironmentConfig;
+}
+export interface IpfsBlobEnvironmentShape {
+    blobs: {
+        ipfs: IpfsBlobEnvironmentConfig;
+    };
+}
+export declare const IpfsBlobEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").BlobCommonEnvironmentShape & IpfsBlobEnvironmentShape>;

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

@@ -8,8 +8,43 @@ 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";
+/**
+ * @description IPFS blob store service registered as `blob-ipfs`
+ * @summary Stores blobs on an IPFS (Kubo) node via `kubo-rpc-client`. Because
+ * the blob API is key/value CRUD-like and IPFS is content-addressed, an
+ * `IpfsKeyIndex` maps logical keys to CIDs; when `encryptedOnly` is set only
+ * encrypted payloads are accepted.
+ * @class IpfsBlobStoreService
+ * @memberOf module:integrations/blob/ipfs/service
+ */
 export declare class IpfsBlobStoreService extends BlobStoreService<KuboRPCClient, IpfsBlobStoreServiceConfig> {
+    /**
+     * @description The key index mapping logical keys to IPFS CIDs
+     * @summary Created in `initialize()` from the configured `keyIndex` provider.
+     * @type {IpfsKeyIndex}
+     * @private
+     */
     private index;
+    /**
+     * @description Builds the IPFS blob config from the environment
+     * @summary Reads the `blobs.ipfs` environment slice; considered
+     * unconfigured when no `sourceId` is set, which keeps the auto-boot
+     * fallback (see `getConfigFromArgs`) resolving to `undefined`.
+     * @return {IpfsBlobStoreServiceConfig | undefined} The environment-derived config, or `undefined` when unconfigured
+     */
+    protected configFromEnvironment(): IpfsBlobStoreServiceConfig | undefined;
+    /**
+     * @description Initializes the IPFS Kubo RPC client and key index
+     * @summary Resolves the config via `getConfigFromArgs` (explicit config,
+     * then the `blobs.ipfs` environment slice). When no config resolves during
+     * a context-bearing auto-boot of an unconfigured provider, returns
+     * `skipInitialization()` so `Service.boot` does not throw; an explicit
+     * `initialize()` with no resolvable config still throws a
+     * `ValidationError`. Connects to the Kubo node at the configured `apiUrl`
+     * (default `http://localhost:5001`) and creates the `IpfsKeyIndex`.
+     * @param {...ContextualArgs<any>} args - An optional `IpfsBlobStoreServiceConfig`, optionally followed by a decaf `Context`
+     * @return {Promise<{config: IpfsBlobStoreServiceConfig, client: KuboRPCClient}>} The resolved config and the Kubo RPC client
+     */
     initialize(...args: ContextualArgs<any>): Promise<{
         config: IpfsBlobStoreServiceConfig;
         client: KuboRPCClient;

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

@@ -8,8 +8,43 @@ 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";
+/**
+ * @description IPFS blob store service registered as `blob-ipfs`
+ * @summary Stores blobs on an IPFS (Kubo) node via `kubo-rpc-client`. Because
+ * the blob API is key/value CRUD-like and IPFS is content-addressed, an
+ * `IpfsKeyIndex` maps logical keys to CIDs; when `encryptedOnly` is set only
+ * encrypted payloads are accepted.
+ * @class IpfsBlobStoreService
+ * @memberOf module:integrations/blob/ipfs/service
+ */
 export declare class IpfsBlobStoreService extends BlobStoreService<KuboRPCClient, IpfsBlobStoreServiceConfig> {
+    /**
+     * @description The key index mapping logical keys to IPFS CIDs
+     * @summary Created in `initialize()` from the configured `keyIndex` provider.
+     * @type {IpfsKeyIndex}
+     * @private
+     */
     private index;
+    /**
+     * @description Builds the IPFS blob config from the environment
+     * @summary Reads the `blobs.ipfs` environment slice; considered
+     * unconfigured when no `sourceId` is set, which keeps the auto-boot
+     * fallback (see `getConfigFromArgs`) resolving to `undefined`.
+     * @return {IpfsBlobStoreServiceConfig | undefined} The environment-derived config, or `undefined` when unconfigured
+     */
+    protected configFromEnvironment(): IpfsBlobStoreServiceConfig | undefined;
+    /**
+     * @description Initializes the IPFS Kubo RPC client and key index
+     * @summary Resolves the config via `getConfigFromArgs` (explicit config,
+     * then the `blobs.ipfs` environment slice). When no config resolves during
+     * a context-bearing auto-boot of an unconfigured provider, returns
+     * `skipInitialization()` so `Service.boot` does not throw; an explicit
+     * `initialize()` with no resolvable config still throws a
+     * `ValidationError`. Connects to the Kubo node at the configured `apiUrl`
+     * (default `http://localhost:5001`) and creates the `IpfsKeyIndex`.
+     * @param {...ContextualArgs<any>} args - An optional `IpfsBlobStoreServiceConfig`, optionally followed by a decaf `Context`
+     * @return {Promise<{config: IpfsBlobStoreServiceConfig, client: KuboRPCClient}>} The resolved config and the Kubo RPC client
+     */
     initialize(...args: ContextualArgs<any>): Promise<{
         config: IpfsBlobStoreServiceConfig;
         client: KuboRPCClient;

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

@@ -4,6 +4,7 @@
  * @description Re-exports the IPFS blob store service and key-index abstraction.
  */
 export * from "./IpfsBlobStoreService.d.cts";
+export * from "./IpfsBlobEnvironment.d.cts";
 export * from "./IpfsKeyIndex.d.cts";
 export * from "./MemoryIpfsKeyIndex.d.cts";
 export * from "./PostgresIpfsKeyIndex.d.cts";

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

@@ -4,6 +4,7 @@
  * @description Re-exports the IPFS blob store service and key-index abstraction.
  */
 export * from "./IpfsBlobStoreService.d.mts";
+export * from "./IpfsBlobEnvironment.d.mts";
 export * from "./IpfsKeyIndex.d.mts";
 export * from "./MemoryIpfsKeyIndex.d.mts";
 export * from "./PostgresIpfsKeyIndex.d.mts";

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

@@ -0,0 +1,15 @@
+export interface LocalBlobEnvironmentConfig {
+    sourceId: string;
+    rootPath: string;
+    prefix?: string;
+}
+export interface LocalBlobEnvironmentShape {
+    blobs: {
+        local: LocalBlobEnvironmentConfig;
+    };
+}
+export declare const LocalBlobEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").BlobCommonEnvironmentShape & LocalBlobEnvironmentShape>;

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

@@ -0,0 +1,15 @@
+export interface LocalBlobEnvironmentConfig {
+    sourceId: string;
+    rootPath: string;
+    prefix?: string;
+}
+export interface LocalBlobEnvironmentShape {
+    blobs: {
+        local: LocalBlobEnvironmentConfig;
+    };
+}
+export declare const LocalBlobEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").BlobCommonEnvironmentShape & LocalBlobEnvironmentShape>;

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

@@ -9,7 +9,35 @@ import type { BlobGetOptions, BlobGetResult, BlobKey, BlobListOptions, BlobListR
 interface LocalFsClient {
     root: string;
 }
+/**
+ * @description Local filesystem blob store service registered as `blob-local`
+ * @summary Stores blobs under a configurable root path using `node:fs` with
+ * atomic writes (temp file + rename) and path-traversal protection.
+ * @class LocalBlobStoreService
+ * @memberOf module:integrations/blob/local/service
+ */
 export declare class LocalBlobStoreService extends BlobStoreService<LocalFsClient, LocalBlobStoreServiceConfig> {
+    /**
+     * @description Builds the local blob config from the environment
+     * @summary Reads the `blobs.local` environment slice; considered
+     * unconfigured when no `rootPath` is set, which keeps the auto-boot
+     * fallback (see `getConfigFromArgs`) resolving to `undefined`.
+     * @return {LocalBlobStoreServiceConfig | undefined} The environment-derived config, or `undefined` when unconfigured
+     */
+    protected configFromEnvironment(): LocalBlobStoreServiceConfig | undefined;
+    /**
+     * @description Initializes the local filesystem blob store client
+     * @summary Resolves the config via `getConfigFromArgs` (explicit config,
+     * then the `blobs.local` environment slice). When no config resolves during
+     * a context-bearing auto-boot of an unconfigured provider, returns
+     * `skipInitialization()` so `Service.boot` does not throw; an explicit
+     * `initialize()` with no resolvable config still throws a
+     * `ValidationError`. Requires a `rootPath`, creates it recursively, and
+     * stores the resolved absolute root as the client.
+     * @param {...ContextualArgs<any>} args - An optional `LocalBlobStoreServiceConfig`, optionally followed by a decaf `Context`
+     * @return {Promise<{config: LocalBlobStoreServiceConfig, client: LocalFsClient}>} The resolved config and the filesystem client
+     * @throws {InternalError} When a resolved config has no `rootPath`
+     */
     initialize(...args: ContextualArgs<any>): Promise<{
         config: LocalBlobStoreServiceConfig;
         client: LocalFsClient;

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

@@ -9,7 +9,35 @@ import type { BlobGetOptions, BlobGetResult, BlobKey, BlobListOptions, BlobListR
 interface LocalFsClient {
     root: string;
 }
+/**
+ * @description Local filesystem blob store service registered as `blob-local`
+ * @summary Stores blobs under a configurable root path using `node:fs` with
+ * atomic writes (temp file + rename) and path-traversal protection.
+ * @class LocalBlobStoreService
+ * @memberOf module:integrations/blob/local/service
+ */
 export declare class LocalBlobStoreService extends BlobStoreService<LocalFsClient, LocalBlobStoreServiceConfig> {
+    /**
+     * @description Builds the local blob config from the environment
+     * @summary Reads the `blobs.local` environment slice; considered
+     * unconfigured when no `rootPath` is set, which keeps the auto-boot
+     * fallback (see `getConfigFromArgs`) resolving to `undefined`.
+     * @return {LocalBlobStoreServiceConfig | undefined} The environment-derived config, or `undefined` when unconfigured
+     */
+    protected configFromEnvironment(): LocalBlobStoreServiceConfig | undefined;
+    /**
+     * @description Initializes the local filesystem blob store client
+     * @summary Resolves the config via `getConfigFromArgs` (explicit config,
+     * then the `blobs.local` environment slice). When no config resolves during
+     * a context-bearing auto-boot of an unconfigured provider, returns
+     * `skipInitialization()` so `Service.boot` does not throw; an explicit
+     * `initialize()` with no resolvable config still throws a
+     * `ValidationError`. Requires a `rootPath`, creates it recursively, and
+     * stores the resolved absolute root as the client.
+     * @param {...ContextualArgs<any>} args - An optional `LocalBlobStoreServiceConfig`, optionally followed by a decaf `Context`
+     * @return {Promise<{config: LocalBlobStoreServiceConfig, client: LocalFsClient}>} The resolved config and the filesystem client
+     * @throws {InternalError} When a resolved config has no `rootPath`
+     */
     initialize(...args: ContextualArgs<any>): Promise<{
         config: LocalBlobStoreServiceConfig;
         client: LocalFsClient;

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

@@ -4,3 +4,4 @@
  * @description Re-exports the local filesystem blob store service.
  */
 export * from "./LocalBlobStoreService.d.cts";
+export * from "./LocalBlobEnvironment.d.cts";

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

@@ -4,3 +4,4 @@
  * @description Re-exports the local filesystem blob store service.
  */
 export * from "./LocalBlobStoreService.d.mts";
+export * from "./LocalBlobEnvironment.d.mts";

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

@@ -0,0 +1,14 @@
+export interface MemoryBlobEnvironmentConfig {
+    sourceId: string;
+    prefix?: string;
+}
+export interface MemoryBlobEnvironmentShape {
+    blobs: {
+        memory: MemoryBlobEnvironmentConfig;
+    };
+}
+export declare const MemoryBlobEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").BlobCommonEnvironmentShape & MemoryBlobEnvironmentShape>;

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

@@ -0,0 +1,14 @@
+export interface MemoryBlobEnvironmentConfig {
+    sourceId: string;
+    prefix?: string;
+}
+export interface MemoryBlobEnvironmentShape {
+    blobs: {
+        memory: MemoryBlobEnvironmentConfig;
+    };
+}
+export declare const MemoryBlobEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").BlobCommonEnvironmentShape & MemoryBlobEnvironmentShape>;

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

@@ -10,7 +10,35 @@ interface MemoryEntry {
     value: Buffer;
     metadata: BlobMetadata;
 }
+/**
+ * @description In-memory blob store service registered as `blob-memory`
+ * @summary Stores blobs in a process-local `Map`, so data does not survive
+ * restarts. Intended for tests and examples; supports the full blob CRUD API
+ * without any SDK dependency.
+ * @class MemoryBlobStoreService
+ * @memberOf module:integrations/blob/memory/service
+ */
 export declare class MemoryBlobStoreService extends BlobStoreService<Map<string, MemoryEntry>, BlobStoreServiceConfig> {
+    /**
+     * @description Builds the memory blob config from the environment
+     * @summary Reads the `blobs.memory` environment slice; considered
+     * unconfigured when no `sourceId` is set, which keeps the auto-boot
+     * fallback (see `getConfigFromArgs`) resolving to `undefined`.
+     * @return {BlobStoreServiceConfig | undefined} The environment-derived config, or `undefined` when unconfigured
+     */
+    protected configFromEnvironment(): BlobStoreServiceConfig | undefined;
+    /**
+     * @description Initializes the in-memory blob store client
+     * @summary Resolves the config via `getConfigFromArgs` (explicit config,
+     * then the `blobs.memory` environment slice). When no config resolves during
+     * a context-bearing auto-boot of an unconfigured provider, returns
+     * `skipInitialization()` so `Service.boot` does not throw; an explicit
+     * `initialize()` with no resolvable config still throws a
+     * `ValidationError`. On success, stores the config and creates the backing
+     * `Map` client.
+     * @param {...ContextualArgs<any>} args - An optional `BlobStoreServiceConfig`, optionally followed by a decaf `Context`
+     * @return {Promise<{config: BlobStoreServiceConfig, client: Map<string, MemoryEntry>}>} The resolved config and the in-memory client
+     */
     initialize(...args: ContextualArgs<any>): Promise<{
         config: BlobStoreServiceConfig;
         client: Map<string, MemoryEntry>;

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

@@ -10,7 +10,35 @@ interface MemoryEntry {
     value: Buffer;
     metadata: BlobMetadata;
 }
+/**
+ * @description In-memory blob store service registered as `blob-memory`
+ * @summary Stores blobs in a process-local `Map`, so data does not survive
+ * restarts. Intended for tests and examples; supports the full blob CRUD API
+ * without any SDK dependency.
+ * @class MemoryBlobStoreService
+ * @memberOf module:integrations/blob/memory/service
+ */
 export declare class MemoryBlobStoreService extends BlobStoreService<Map<string, MemoryEntry>, BlobStoreServiceConfig> {
+    /**
+     * @description Builds the memory blob config from the environment
+     * @summary Reads the `blobs.memory` environment slice; considered
+     * unconfigured when no `sourceId` is set, which keeps the auto-boot
+     * fallback (see `getConfigFromArgs`) resolving to `undefined`.
+     * @return {BlobStoreServiceConfig | undefined} The environment-derived config, or `undefined` when unconfigured
+     */
+    protected configFromEnvironment(): BlobStoreServiceConfig | undefined;
+    /**
+     * @description Initializes the in-memory blob store client
+     * @summary Resolves the config via `getConfigFromArgs` (explicit config,
+     * then the `blobs.memory` environment slice). When no config resolves during
+     * a context-bearing auto-boot of an unconfigured provider, returns
+     * `skipInitialization()` so `Service.boot` does not throw; an explicit
+     * `initialize()` with no resolvable config still throws a
+     * `ValidationError`. On success, stores the config and creates the backing
+     * `Map` client.
+     * @param {...ContextualArgs<any>} args - An optional `BlobStoreServiceConfig`, optionally followed by a decaf `Context`
+     * @return {Promise<{config: BlobStoreServiceConfig, client: Map<string, MemoryEntry>}>} The resolved config and the in-memory client
+     */
     initialize(...args: ContextualArgs<any>): Promise<{
         config: BlobStoreServiceConfig;
         client: Map<string, MemoryEntry>;

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

@@ -4,3 +4,4 @@
  * @description Re-exports the in-memory blob store service.
  */
 export * from "./MemoryBlobStoreService.d.cts";
+export * from "./MemoryBlobEnvironment.d.cts";

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

@@ -4,3 +4,4 @@
  * @description Re-exports the in-memory blob store service.
  */
 export * from "./MemoryBlobStoreService.d.mts";
+export * from "./MemoryBlobEnvironment.d.mts";

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

@@ -0,0 +1,11 @@
+import type { S3BlobEnvironmentConfig } from "./S3BlobEnvironment.d.cts";
+export interface MinioBlobEnvironmentShape {
+    blobs: {
+        minio: S3BlobEnvironmentConfig;
+    };
+}
+export declare const MinioBlobEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").BlobCommonEnvironmentShape & MinioBlobEnvironmentShape>;

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

@@ -0,0 +1,11 @@
+import type { S3BlobEnvironmentConfig } from "./S3BlobEnvironment.d.mts";
+export interface MinioBlobEnvironmentShape {
+    blobs: {
+        minio: S3BlobEnvironmentConfig;
+    };
+}
+export declare const MinioBlobEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").BlobCommonEnvironmentShape & MinioBlobEnvironmentShape>;

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

@@ -1,8 +1,5 @@
-/**
- * @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 {
+import { S3CompatibleBlobStoreService } from "./S3CompatibleBlobStoreService.d.cts";
+import type { S3BlobStoreServiceConfig } from "../core/BlobTypes.d.cts";
+export declare class MinioBlobStoreService extends S3CompatibleBlobStoreService {
+    protected configFromEnvironment(): S3BlobStoreServiceConfig | undefined;
 }

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

@@ -1,8 +1,5 @@
-/**
- * @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 {
+import { S3CompatibleBlobStoreService } from "./S3CompatibleBlobStoreService.d.mts";
+import type { S3BlobStoreServiceConfig } from "../core/BlobTypes.d.mts";
+export declare class MinioBlobStoreService extends S3CompatibleBlobStoreService {
+    protected configFromEnvironment(): S3BlobStoreServiceConfig | undefined;
 }

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

@@ -0,0 +1,11 @@
+import type { S3BlobEnvironmentConfig } from "./S3BlobEnvironment.d.cts";
+export interface R2BlobEnvironmentShape {
+    blobs: {
+        r2: S3BlobEnvironmentConfig;
+    };
+}
+export declare const R2BlobEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").BlobCommonEnvironmentShape & R2BlobEnvironmentShape>;

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

@@ -0,0 +1,11 @@
+import type { S3BlobEnvironmentConfig } from "./S3BlobEnvironment.d.mts";
+export interface R2BlobEnvironmentShape {
+    blobs: {
+        r2: S3BlobEnvironmentConfig;
+    };
+}
+export declare const R2BlobEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").BlobCommonEnvironmentShape & R2BlobEnvironmentShape>;

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

@@ -1,8 +1,5 @@
-/**
- * @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 {
+import { S3CompatibleBlobStoreService } from "./S3CompatibleBlobStoreService.d.cts";
+import type { S3BlobStoreServiceConfig } from "../core/BlobTypes.d.cts";
+export declare class R2BlobStoreService extends S3CompatibleBlobStoreService {
+    protected configFromEnvironment(): S3BlobStoreServiceConfig | undefined;
 }

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

@@ -1,8 +1,5 @@
-/**
- * @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 {
+import { S3CompatibleBlobStoreService } from "./S3CompatibleBlobStoreService.d.mts";
+import type { S3BlobStoreServiceConfig } from "../core/BlobTypes.d.mts";
+export declare class R2BlobStoreService extends S3CompatibleBlobStoreService {
+    protected configFromEnvironment(): S3BlobStoreServiceConfig | undefined;
 }