@stacksjs/ts-cloud 0.2.15 → 0.2.16

package/dist/object-storage/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Multi-provider object storage.
+ *
+ * AWS S3, Backblaze B2 and Hetzner Object Storage all speak the S3 API and
+ * authenticate with AWS Signature V4, so a single {@link S3Client} drives all
+ * three — the only differences are the endpoint host, the addressing style and
+ * where the credentials come from. This module resolves those differences from
+ * a small config object (or environment variables) and hands back a ready
+ * {@link S3Client}.
+ *
+ * @example
+ * ```ts
+ * // Backblaze B2 from explicit config
+ * const s3 = createObjectStorageClient({
+ *   provider: 'backblaze',
+ *   region: 'us-west-004',
+ *   credentials: { accessKeyId: keyId, secretAccessKey: appKey },
+ * })
+ * await s3.putObject({ bucket: 'my-bucket', key: 'a.txt', body: 'hi' })
+ *
+ * // Or entirely from env (OBJECT_STORAGE_PROVIDER=backblaze, B2_* vars set)
+ * const s3 = createObjectStorageClient()
+ * ```
+ */
+import { S3Client } from '../aws/s3';
+export type ObjectStorageProvider = 'aws' | 'backblaze' | 'hetzner';
+export interface ObjectStorageCredentials {
+    accessKeyId: string;
+    secretAccessKey: string;
+    sessionToken?: string;
+}
+export interface ObjectStorageConfig {
+    /** Storage provider. Defaults to `OBJECT_STORAGE_PROVIDER`/`STORAGE_PROVIDER` env, then `'aws'`. */
+    provider?: ObjectStorageProvider;
+    /** Region / location slug. Provider-specific default if omitted (see {@link resolveObjectStorage}). */
+    region?: string;
+    /** Endpoint host override (no scheme). Defaults to the provider's standard endpoint for the region. */
+    endpoint?: string;
+    /** Force path-style addressing. Defaults to virtual-hosted, which all three providers support. */
+    forcePathStyle?: boolean;
+    /** Explicit credentials. When omitted, resolved from provider-specific env vars (see below). */
+    credentials?: ObjectStorageCredentials;
+    /** AWS named profile (AWS provider only) — ignored by B2/Hetzner. */
+    profile?: string;
+}
+export interface ResolvedObjectStorage {
+    provider: ObjectStorageProvider;
+    region: string;
+    /** Endpoint host (no scheme), or undefined for AWS S3 (uses the default AWS endpoint). */
+    endpoint?: string;
+    forcePathStyle: boolean;
+    credentials?: ObjectStorageCredentials;
+    profile?: string;
+    /** Public HTTPS base URL for a bucket (no trailing slash). */
+    publicBaseUrl: (bucket: string) => string;
+}
+/** Standard endpoint host for a provider+region (undefined ⇒ use AWS default). */
+export declare function providerEndpoint(provider: ObjectStorageProvider, region: string): string | undefined;
+/**
+ * Resolve a full object-storage configuration from explicit values + environment.
+ * Pure and side-effect free — useful for diagnostics and for building both the
+ * client and the public URLs consistently.
+ */
+export declare function resolveObjectStorage(config?: ObjectStorageConfig): ResolvedObjectStorage;
+/**
+ * Create an {@link S3Client} for any supported provider. AWS S3 with no config
+ * behaves exactly as `new S3Client()` did before.
+ */
+export declare function createObjectStorageClient(config?: ObjectStorageConfig): S3Client;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/ts-cloud",
   "type": "module",
-  "version": "0.2.15",
+  "version": "0.2.16",
   "description": "A lightweight, performant infrastructure-as-code library and CLI for deploying both server-based (EC2) and serverless applications.",
   "author": "Chris Breuer <chris@stacksjs.com>",
   "license": "MIT",
@@ -42,6 +42,10 @@
       "types": "./dist/dns/index.d.ts",
       "import": "./dist/dns/index.js"
     },
+    "./drivers": {
+      "types": "./dist/drivers/index.d.ts",
+      "import": "./dist/drivers/index.js"
+    },
     "./push": {
       "types": "./dist/push/index.d.ts",
       "import": "./dist/push/index.js"
@@ -85,8 +89,8 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ts-cloud/aws-types": "0.2.15",
-    "@ts-cloud/core": "0.2.15",
+    "@ts-cloud/aws-types": "0.2.16",
+    "@ts-cloud/core": "0.2.16",
     "@stacksjs/ts-xml": "^0.1.0"
   },
   "devDependencies": {