@decaf-ts/integrations 0.8.0 → 0.9.0

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

@@ -24,5 +24,11 @@ export declare abstract class BlobStoreService<TClient = unknown, TConfig extend
     protected physicalKey(key: BlobKey): string;
     protected cleanKey(key: BlobKey): string;
     protected getConfigFromArgs<TExpected extends TConfig>(...args: MaybeContextualArg<any>): TExpected;
+    /**
+     * @description Builds a config from the provider's environment as a fallback.
+     * @summary Providers that support environment-sourced configuration should
+     * override this to read from their own `blobs.<provider>` environment slice.
+     */
+    protected abstract configFromEnvironment(): TConfig | undefined;
     protected uri(key: BlobKey, scheme: string, extra?: string): string;
 }

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

@@ -5,6 +5,7 @@
  */
 export * from "./BlobTypes.d.cts";
 export * from "./BlobErrors.d.cts";
+export * from "./BlobEnvironment.d.cts";
 export * from "./BlobKey.d.cts";
 export * from "./BlobValue.d.cts";
 export * from "./BlobStoreService.d.cts";

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

@@ -5,6 +5,7 @@
  */
 export * from "./BlobTypes.d.mts";
 export * from "./BlobErrors.d.mts";
+export * from "./BlobEnvironment.d.mts";
 export * from "./BlobKey.d.mts";
 export * from "./BlobValue.d.mts";
 export * from "./BlobStoreService.d.mts";

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

@@ -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/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

@@ -9,6 +9,7 @@ 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";
 export declare class GcsBlobStoreService extends BlobStoreService<Bucket, GcsBlobStoreServiceConfig> {
     private storage;
+    protected configFromEnvironment(): GcsBlobStoreServiceConfig | undefined;
     initialize(...args: ContextualArgs<any>): Promise<{
         config: GcsBlobStoreServiceConfig;
         client: Bucket;

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

@@ -9,6 +9,7 @@ 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";
 export declare class GcsBlobStoreService extends BlobStoreService<Bucket, GcsBlobStoreServiceConfig> {
     private storage;
+    protected configFromEnvironment(): GcsBlobStoreServiceConfig | undefined;
     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

@@ -10,6 +10,7 @@ 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;
+    protected configFromEnvironment(): IpfsBlobStoreServiceConfig | undefined;
     initialize(...args: ContextualArgs<any>): Promise<{
         config: IpfsBlobStoreServiceConfig;
         client: KuboRPCClient;

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

@@ -10,6 +10,7 @@ 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;
+    protected configFromEnvironment(): IpfsBlobStoreServiceConfig | undefined;
     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

@@ -10,6 +10,7 @@ interface LocalFsClient {
     root: string;
 }
 export declare class LocalBlobStoreService extends BlobStoreService<LocalFsClient, LocalBlobStoreServiceConfig> {
+    protected configFromEnvironment(): LocalBlobStoreServiceConfig | undefined;
     initialize(...args: ContextualArgs<any>): Promise<{
         config: LocalBlobStoreServiceConfig;
         client: LocalFsClient;

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

@@ -10,6 +10,7 @@ interface LocalFsClient {
     root: string;
 }
 export declare class LocalBlobStoreService extends BlobStoreService<LocalFsClient, LocalBlobStoreServiceConfig> {
+    protected configFromEnvironment(): LocalBlobStoreServiceConfig | undefined;
     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

@@ -11,6 +11,7 @@ interface MemoryEntry {
     metadata: BlobMetadata;
 }
 export declare class MemoryBlobStoreService extends BlobStoreService<Map<string, MemoryEntry>, BlobStoreServiceConfig> {
+    protected configFromEnvironment(): BlobStoreServiceConfig | undefined;
     initialize(...args: ContextualArgs<any>): Promise<{
         config: BlobStoreServiceConfig;
         client: Map<string, MemoryEntry>;

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

@@ -11,6 +11,7 @@ interface MemoryEntry {
     metadata: BlobMetadata;
 }
 export declare class MemoryBlobStoreService extends BlobStoreService<Map<string, MemoryEntry>, BlobStoreServiceConfig> {
+    protected configFromEnvironment(): BlobStoreServiceConfig | undefined;
     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;
 }

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

@@ -0,0 +1,26 @@
+export interface S3BlobEnvironmentCredentials {
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    sessionToken?: string;
+}
+export interface S3BlobEnvironmentConfig {
+    sourceId: string;
+    bucket: string;
+    region?: string;
+    endpoint?: string;
+    prefix?: string;
+    forcePathStyle?: boolean;
+    autoCreateBucket?: boolean;
+    maxRetries?: number;
+    credentials?: S3BlobEnvironmentCredentials;
+}
+export interface S3BlobEnvironmentShape {
+    blobs: {
+        s3: S3BlobEnvironmentConfig;
+    };
+}
+export declare const S3BlobEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").BlobCommonEnvironmentShape & S3BlobEnvironmentShape>;

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

@@ -0,0 +1,26 @@
+export interface S3BlobEnvironmentCredentials {
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    sessionToken?: string;
+}
+export interface S3BlobEnvironmentConfig {
+    sourceId: string;
+    bucket: string;
+    region?: string;
+    endpoint?: string;
+    prefix?: string;
+    forcePathStyle?: boolean;
+    autoCreateBucket?: boolean;
+    maxRetries?: number;
+    credentials?: S3BlobEnvironmentCredentials;
+}
+export interface S3BlobEnvironmentShape {
+    blobs: {
+        s3: S3BlobEnvironmentConfig;
+    };
+}
+export declare const S3BlobEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").BlobCommonEnvironmentShape & S3BlobEnvironmentShape>;

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

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

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

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

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

@@ -0,0 +1,30 @@
+/**
+ * @module integrations/blob/s3/base-service
+ * @summary S3-compatible blob store base implementation.
+ * @description Shared CRUD implementation backed by the AWS SDK v3 S3Client, used by
+ * the S3, MinIO, and Cloudflare R2 provider services. Deliberately left undecorated:
+ * `@service(...)` on a class whose parent is itself `@service(...)`-decorated breaks
+ * that subclass's inherited field initializers (e.g. `Context` ends up `undefined`).
+ * Each concrete provider below extends this class directly and carries its own
+ * `@service("blob-<provider>")` decorator instead of stacking on top of one another.
+ */
+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 abstract class S3CompatibleBlobStoreService 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/S3CompatibleBlobStoreService.d.mts

@@ -0,0 +1,30 @@
+/**
+ * @module integrations/blob/s3/base-service
+ * @summary S3-compatible blob store base implementation.
+ * @description Shared CRUD implementation backed by the AWS SDK v3 S3Client, used by
+ * the S3, MinIO, and Cloudflare R2 provider services. Deliberately left undecorated:
+ * `@service(...)` on a class whose parent is itself `@service(...)`-decorated breaks
+ * that subclass's inherited field initializers (e.g. `Context` ends up `undefined`).
+ * Each concrete provider below extends this class directly and carries its own
+ * `@service("blob-<provider>")` decorator instead of stacking on top of one another.
+ */
+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 abstract class S3CompatibleBlobStoreService 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

@@ -3,6 +3,10 @@
  * @summary S3-compatible blob store exports.
  * @description Re-exports the S3, MinIO, and R2 blob store services.
  */
+export * from "./S3CompatibleBlobStoreService.d.cts";
 export * from "./S3BlobStoreService.d.cts";
+export * from "./S3BlobEnvironment.d.cts";
 export * from "./MinioBlobStoreService.d.cts";
+export * from "./MinioBlobEnvironment.d.cts";
 export * from "./R2BlobStoreService.d.cts";
+export * from "./R2BlobEnvironment.d.cts";

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

@@ -3,6 +3,10 @@
  * @summary S3-compatible blob store exports.
  * @description Re-exports the S3, MinIO, and R2 blob store services.
  */
+export * from "./S3CompatibleBlobStoreService.d.mts";
 export * from "./S3BlobStoreService.d.mts";
+export * from "./S3BlobEnvironment.d.mts";
 export * from "./MinioBlobStoreService.d.mts";
+export * from "./MinioBlobEnvironment.d.mts";
 export * from "./R2BlobStoreService.d.mts";
+export * from "./R2BlobEnvironment.d.mts";