@streetjs/storage 1.0.0

package/dist/drivers/s3.js

@@ -0,0 +1,311 @@
+/**
+ * @streetjs/storage — {@link S3StorageDriver} (Amazon S3), submodule `./s3`.
+ *
+ * This module is the concrete Amazon S3 provider driver, exposed only through
+ * the optional subpath export `@streetjs/storage/s3` (Requirement 3.3). It is
+ * **not** re-exported from the package entry point `src/index.ts`, so importing
+ * the base package never pulls in this file or any AWS SDK.
+ *
+ * ## What this module adds over the base
+ *
+ * The entire {@link StorageDriver} contract mapping already lives in the shared
+ * {@link createS3StyleDriver} / {@link S3StyleDriver} base (task 28.1) built over
+ * the structural {@link S3ClientLike}. Amazon S3, Cloudflare R2, MinIO and the
+ * Backblaze B2 S3 API differ only in **how the client is built/configured**, not
+ * in how the contract is satisfied — so this module contributes only:
+ *
+ * 1. {@link createS3StorageDriver} — wrap an **injected** {@link S3ClientLike}
+ *    (the preferred, SDK-free path) as a `name: "s3"` driver by delegating to the
+ *    base. No AWS SDK is loaded on this path.
+ * 2. {@link createS3StorageDriverFromConfig} — construct an {@link S3ClientLike}
+ *    from `bucket`/`region`/`endpoint`/`credentials` using a **lazy dynamic
+ *    `import()`** of the AWS SDK performed *inside* the function. The SDK is
+ *    therefore resolved only when this construction path actually runs, never at
+ *    module load, keeping the AWS SDK an optional peer concern of the consumer
+ *    (Requirement 3.1). If the SDK cannot be loaded and no client was injected, a
+ *    descriptive {@link StorageConfigError} is thrown.
+ *
+ * ## SDK isolation (Requirements 2.1, 3.3)
+ *
+ * There is **no top-level `import` of any AWS SDK** in this file — only `streetjs`
+ * (for {@link Clock}), this package's own type surface, and the shared base. The
+ * `@aws-sdk/client-s3` / `@aws-sdk/s3-request-presigner` packages are declared as
+ * **optional peer dependencies** in `package.json`; they are pulled in only by
+ * the lazy `import()` inside {@link createS3StorageDriverFromConfig}. The dynamic
+ * specifier is held in a variable so the build never statically requires the SDK
+ * to be installed.
+ *
+ * _Requirements: 2.1, 2.3, 3.3_
+ */
+import { StorageConfigError } from "../errors.js";
+import { createS3StyleDriver, } from "./s3-base.js";
+/** The stable driver name surfaced as {@link StorageDriver.name} for this driver. */
+const DRIVER_NAME = "s3";
+// ── Public factories ─────────────────────────────────────────────────────────
+/**
+ * Wrap an **injected** {@link S3ClientLike} as an Amazon S3 {@link StorageDriver}
+ * (`name: "s3"`). This is the preferred path: no AWS SDK is required because the
+ * caller supplies the structural client, and the whole {@link StorageDriver}
+ * contract is satisfied by the shared base (Requirement 2.3).
+ *
+ * @throws {StorageConfigError} when `client` is missing or does not implement the
+ * mandatory {@link S3ClientLike} object operations. To build a client from
+ * credentials instead, use {@link createS3StorageDriverFromConfig}.
+ */
+export function createS3StorageDriver(client, options = {}) {
+    if (!isS3ClientLike(client)) {
+        throw new StorageConfigError('createS3StorageDriver requires an injected S3ClientLike implementing ' +
+            'putObject/getObject/deleteObject/listObjects. Pass a structural client, ' +
+            'or use createS3StorageDriverFromConfig to construct one from credentials ' +
+            'via the optional "@aws-sdk/client-s3" peer dependency.', { provider: DRIVER_NAME });
+    }
+    return createS3StyleDriver(client, {
+        name: DRIVER_NAME,
+        clock: options.clock,
+        capabilities: options.capabilities,
+    });
+}
+/**
+ * Construct an Amazon S3 {@link StorageDriver} from connection configuration.
+ *
+ * When `config.client` is supplied it is wrapped directly (no SDK is loaded).
+ * Otherwise this **lazily `import()`s** `@aws-sdk/client-s3` and builds a client
+ * over the SDK — the SDK is resolved only here, at construction time, never at
+ * module load. If the SDK cannot be loaded, a descriptive {@link StorageConfigError}
+ * is thrown so a missing optional peer dependency surfaces clearly rather than as
+ * an opaque module-resolution failure (Requirements 2.1, 3.3).
+ */
+export async function createS3StorageDriverFromConfig(config) {
+    const client = config.client !== undefined && config.client !== null
+        ? config.client
+        : await buildS3ClientFromSdk(config);
+    return createS3StorageDriver(client, {
+        clock: config.clock,
+        capabilities: config.capabilities,
+    });
+}
+// ── Internal: structural client guard ──────────────────────────────────────────
+/**
+ * Structural check that `value` implements the mandatory {@link S3ClientLike}
+ * object operations. Optional methods (`headObject`, multipart, `presignUrl`) are
+ * not required and are feature-detected by the base.
+ */
+function isS3ClientLike(value) {
+    if (value === null || typeof value !== "object") {
+        return false;
+    }
+    const candidate = value;
+    return (typeof candidate.putObject === "function" &&
+        typeof candidate.getObject === "function" &&
+        typeof candidate.deleteObject === "function" &&
+        typeof candidate.listObjects === "function");
+}
+// ── Internal: lazy AWS SDK client construction ─────────────────────────────────
+/**
+ * Build an {@link S3ClientLike} over the real AWS SDK, loaded lazily.
+ *
+ * The SDK module specifiers are held in variables so the TypeScript build never
+ * statically resolves (and therefore never requires) the optional peer
+ * dependencies. Any load failure is wrapped in a {@link StorageConfigError}.
+ */
+async function buildS3ClientFromSdk(config) {
+    // Held in a variable so the compiler treats this as a dynamic (untyped) import
+    // and does not require "@aws-sdk/client-s3" to be installed to build.
+    const clientModuleId = "@aws-sdk/client-s3";
+    let sdk;
+    try {
+        sdk = (await import(clientModuleId));
+    }
+    catch (cause) {
+        throw new StorageConfigError('The AWS SDK ("@aws-sdk/client-s3") is required to construct an S3 client ' +
+            "from credentials but could not be loaded. Install it as an optional peer " +
+            "dependency, or inject a structural S3ClientLike via createS3StorageDriver.", { provider: DRIVER_NAME, cause });
+    }
+    const bucket = config.bucket;
+    const sdkClient = new sdk.S3Client({
+        region: config.region,
+        endpoint: config.endpoint,
+        forcePathStyle: config.forcePathStyle,
+        credentials: config.credentials,
+    });
+    const commands = sdk;
+    const send = (command) => sdkClient.send(command);
+    const command = (name, input) => new commands[name](input);
+    return {
+        async putObject({ key, body, contentType, metadata }) {
+            const out = await send(command("PutObjectCommand", {
+                Bucket: bucket,
+                Key: key,
+                Body: body,
+                ContentType: contentType,
+                Metadata: metadata,
+            }));
+            return { etag: out.ETag ?? "" };
+        },
+        async getObject({ key }) {
+            let out;
+            try {
+                out = await send(command("GetObjectCommand", { Bucket: bucket, Key: key }));
+            }
+            catch (error) {
+                if (isNotFound(error)) {
+                    return null;
+                }
+                throw error;
+            }
+            return {
+                body: await collectBody(out.Body),
+                contentType: out.ContentType,
+                etag: out.ETag,
+                size: out.ContentLength,
+                lastModified: toEpochMs(out.LastModified),
+                metadata: out.Metadata,
+            };
+        },
+        async deleteObject({ key }) {
+            await send(command("DeleteObjectCommand", { Bucket: bucket, Key: key }));
+        },
+        async listObjects({ prefix, limit, cursor }) {
+            const out = await send(command("ListObjectsV2Command", {
+                Bucket: bucket,
+                Prefix: prefix,
+                MaxKeys: limit,
+                ContinuationToken: cursor,
+            }));
+            const contents = out.Contents ?? [];
+            const items = [];
+            for (const entry of contents) {
+                if (entry.Key === undefined) {
+                    continue;
+                }
+                items.push({
+                    key: entry.Key,
+                    size: entry.Size ?? 0,
+                    updatedAt: toEpochMs(entry.LastModified) ?? 0,
+                });
+            }
+            return items;
+        },
+        async headObject({ key }) {
+            let out;
+            try {
+                out = await send(command("HeadObjectCommand", { Bucket: bucket, Key: key }));
+            }
+            catch (error) {
+                if (isNotFound(error)) {
+                    return null;
+                }
+                throw error;
+            }
+            return {
+                contentType: out.ContentType,
+                etag: out.ETag,
+                size: out.ContentLength,
+                lastModified: toEpochMs(out.LastModified),
+                metadata: out.Metadata,
+            };
+        },
+        async createMultipartUpload({ key, contentType, metadata }) {
+            const out = await send(command("CreateMultipartUploadCommand", {
+                Bucket: bucket,
+                Key: key,
+                ContentType: contentType,
+                Metadata: metadata,
+            }));
+            return { uploadId: out.UploadId ?? "" };
+        },
+        async uploadPart({ key, uploadId, partNumber, body }) {
+            const out = await send(command("UploadPartCommand", {
+                Bucket: bucket,
+                Key: key,
+                UploadId: uploadId,
+                PartNumber: partNumber,
+                Body: body,
+            }));
+            return { etag: out.ETag ?? "" };
+        },
+        async completeMultipartUpload({ key, uploadId, parts }) {
+            const out = await send(command("CompleteMultipartUploadCommand", {
+                Bucket: bucket,
+                Key: key,
+                UploadId: uploadId,
+                MultipartUpload: {
+                    Parts: parts.map((part) => ({ PartNumber: part.partNumber, ETag: part.etag })),
+                },
+            }));
+            return { etag: out.ETag ?? "" };
+        },
+        async abortMultipartUpload({ key, uploadId }) {
+            await send(command("AbortMultipartUploadCommand", {
+                Bucket: bucket,
+                Key: key,
+                UploadId: uploadId,
+            }));
+        },
+        async presignUrl({ key, op, expiresInMs }) {
+            // Held in a variable for the same lazy, build-independent reason as above.
+            const presignModuleId = "@aws-sdk/s3-request-presigner";
+            let presigner;
+            try {
+                presigner = (await import(presignModuleId));
+            }
+            catch (cause) {
+                throw new StorageConfigError('The AWS SDK presigner ("@aws-sdk/s3-request-presigner") is required to ' +
+                    "mint presigned URLs but could not be loaded. Install it as an optional " +
+                    "peer dependency.", { provider: DRIVER_NAME, cause });
+            }
+            const commandName = op === "PUT"
+                ? "PutObjectCommand"
+                : op === "DELETE"
+                    ? "DeleteObjectCommand"
+                    : "GetObjectCommand";
+            return presigner.getSignedUrl(sdkClient, command(commandName, { Bucket: bucket, Key: key }), {
+                expiresIn: Math.max(1, Math.round(expiresInMs / 1000)),
+            });
+        },
+    };
+}
+/** Convert an SDK `Date` (or `undefined`) to epoch ms. */
+function toEpochMs(date) {
+    return date instanceof Date ? date.getTime() : undefined;
+}
+/**
+ * Detect the SDK's "object does not exist" signals so a missing key maps to the
+ * base's `null` convention rather than a thrown error.
+ */
+function isNotFound(error) {
+    if (error === null || typeof error !== "object") {
+        return false;
+    }
+    const err = error;
+    return (err.name === "NoSuchKey" ||
+        err.name === "NotFound" ||
+        err.Code === "NoSuchKey" ||
+        err.$metadata?.httpStatusCode === 404);
+}
+/**
+ * Collect an SDK response body into a `Uint8Array`. Prefers the SDK's
+ * `transformToByteArray()` helper and falls back to async iteration for stream
+ * bodies.
+ */
+async function collectBody(body) {
+    if (body === null || body === undefined) {
+        return new Uint8Array(0);
+    }
+    const maybe = body;
+    if (typeof maybe.transformToByteArray === "function") {
+        return new Uint8Array(await maybe.transformToByteArray());
+    }
+    if (typeof maybe[Symbol.asyncIterator] === "function") {
+        const chunks = [];
+        for await (const chunk of body) {
+            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        }
+        return new Uint8Array(Buffer.concat(chunks));
+    }
+    if (body instanceof Uint8Array) {
+        return body.slice();
+    }
+    return new Uint8Array(0);
+}
+//# sourceMappingURL=s3.js.map

package/dist/drivers/s3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.js","sourceRoot":"","sources":["../../src/drivers/s3.ts"],"names":[],"mappings":"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"}

package/dist/drivers/supabase.d.ts

@@ -0,0 +1,246 @@
+/**
+ * @streetjs/storage — SupabaseStorageDriver (submodule `@streetjs/storage/supabase`).
+ *
+ * Supabase Storage is **not** an S3-wire-compatible provider — its SDK exposes a
+ * bucket-scoped file API (`storage.from(bucket).upload/download/remove/list/info`)
+ * rather than the `putObject`/`getObject` verbs the S3-style base is built on. So,
+ * unlike `s3.ts`/`r2.ts`/`minio.ts`/`backblaze.ts`, this driver does **not**
+ * extend the shared S3 base ({@link ../drivers/s3-base}); it maps the
+ * {@link StorageDriver} contract directly onto a purpose-built structural
+ * {@link SupabaseStorageClientLike} that mirrors just the Supabase Storage calls
+ * it needs.
+ *
+ * ## Two ways to obtain a driver
+ *
+ * - {@link createSupabaseStorageDriver} wraps an **already-constructed,
+ *   injected** {@link SupabaseStorageClientLike} and returns a driver
+ *   synchronously. This is the SDK-free path: no provider SDK is touched, so it
+ *   is fully testable with an in-memory fake and needs no `@supabase/supabase-js`
+ *   install.
+ * - {@link connectSupabaseStorageDriver} **builds its own client** from Supabase
+ *   connection config. It resolves `@supabase/supabase-js` through a **lazy
+ *   dynamic `import()` performed inside the function** (never at module top
+ *   level), so the optional peer dependency is only required when this path is
+ *   actually used. If the SDK is not installed and no client was injected, it
+ *   throws {@link StorageConfigError} (provider `"supabase"`, Requirement 1.5).
+ *
+ * ## Capability delegation (Requirement 2.3)
+ *
+ * The driver implements only the **mandatory primitives** (`put`/`get`/`exists`/
+ * `delete`/`stat`/`list`/`putStream`/`getStream`), producing every
+ * {@link StorageObjectMetadata} through the shared metadata layer
+ * ({@link buildObjectMetadata}) so the field set is identical to Memory/Local/S3,
+ * and reporting a missing key consistently ({@link MaybeObject} `{ found: false }`
+ * for `get`, `null` for `stat`, {@link NotFoundError} for `getStream`). Advanced
+ * capabilities (`multipart`/`resumable`/`versioning`/`signedUrl`/`lifecycle`) are
+ * intentionally left `undefined` so the facade simulates them over the
+ * primitives, keeping behavior identical across providers.
+ *
+ * ## SDK isolation (Requirements 2.1, 3.3)
+ *
+ * This module imports **no provider SDK at the top level** — only Node built-ins,
+ * `streetjs` (for the injected {@link Clock}), and this package's own type
+ * surface. `@supabase/supabase-js` is referenced solely via a dynamic `import()`
+ * with a non-literal specifier inside {@link connectSupabaseStorageDriver}, so
+ * `tsc` never requires the SDK to be present and `streetjs` stays the only
+ * runtime dependency. This driver is a submodule-only export
+ * (`./supabase` → `dist/drivers/supabase.js`); it is intentionally not
+ * re-exported from the package's main `index.ts`.
+ *
+ * _Requirements: 2.1, 2.3, 3.3_
+ */
+import { type Clock } from "streetjs";
+import type { MaybeObject, NodeReadable, StorageDriver } from "../driver.js";
+import type { ListOptions, StorageListItem, StorageObjectMetadata, WriteMetadata } from "../types.js";
+/** Input to {@link SupabaseStorageClientLike.upload}. */
+export interface SupabaseUploadInput {
+    /** The object path (key) within the bucket. */
+    readonly path: string;
+    /** The bytes to store. */
+    readonly body: Uint8Array;
+    /** Declared content type, mapped to Supabase's `contentType` upload option. */
+    readonly contentType?: string;
+    /** Custom metadata (string→string) to persist; used to round-trip the field set. */
+    readonly metadata?: Record<string, string>;
+    /** Whether to overwrite an existing object at `path` (Supabase `upsert`). */
+    readonly upsert?: boolean;
+}
+/** Result of {@link SupabaseStorageClientLike.upload}. */
+export interface SupabaseUploadResult {
+    /** The object's entity tag, when the service returns one. */
+    readonly etag?: string;
+}
+/**
+ * Object attributes as surfaced by Supabase Storage (`info(path)` / `list`
+ * entries). Every field is optional and loosely typed because Supabase returns
+ * timestamps as ISO-8601 strings and nests size/mimetype/user metadata under a
+ * `metadata` map; the driver normalizes them. Caller-supplied user metadata lives
+ * under the nested {@link userMetadata} map (Supabase's custom "metadata").
+ */
+export interface SupabaseObjectInfo {
+    /** Byte length. Supabase may return this as a number or numeric string. */
+    readonly size?: number | string;
+    /** Declared content type / mimetype. */
+    readonly contentType?: string;
+    /** Entity tag, when present. */
+    readonly etag?: string;
+    /** Creation time as an ISO-8601 string. */
+    readonly createdAt?: string;
+    /** Last-updated time as an ISO-8601 string. */
+    readonly updatedAt?: string;
+    /** Caller-supplied custom metadata (string→string). */
+    readonly userMetadata?: Record<string, string>;
+}
+/** A single object entry returned by {@link SupabaseStorageClientLike.list}. */
+export interface SupabaseListEntry {
+    /** The object path (full key). */
+    readonly name: string;
+    /** Byte length of the object, when the listing includes it. */
+    readonly size?: number | string;
+    /** Last-updated time as an ISO-8601 string, when the listing includes it. */
+    readonly updatedAt?: string;
+}
+/** Options accepted by {@link SupabaseStorageClientLike.list}. */
+export interface SupabaseListInput {
+    /** Only list objects whose path begins with this prefix. */
+    readonly prefix: string;
+    /** Best-effort maximum number of results the caller wants. */
+    readonly limit?: number;
+}
+/**
+ * The **minimal, bucket-scoped structural interface** this driver depends on.
+ *
+ * It describes just the Supabase Storage operations the driver needs — never any
+ * concrete `@supabase/supabase-js` type — so the SDK stays an optional peer
+ * concern of the consumer (Requirement 3.1). `download`/`info` return `null` for
+ * a missing object so not-found maps to the contract's consistent semantics
+ * rather than a thrown error.
+ */
+export interface SupabaseStorageClientLike {
+    /** Store `body` under `path` with optional content type and custom metadata. */
+    upload(input: SupabaseUploadInput): Promise<SupabaseUploadResult>;
+    /** Download the object's bytes, or `null` when it does not exist. */
+    download(path: string): Promise<Uint8Array | null>;
+    /** Remove the object at `path` (a no-op when it is already absent). */
+    remove(path: string): Promise<void>;
+    /** Report whether an object exists at `path`. */
+    exists(path: string): Promise<boolean>;
+    /** Fetch the object's attributes, or `null` when it does not exist. */
+    info(path: string): Promise<SupabaseObjectInfo | null>;
+    /** List objects whose path begins with `input.prefix`. */
+    list(input: SupabaseListInput): Promise<readonly SupabaseListEntry[]>;
+}
+/**
+ * Options for the Supabase driver. The provider name is fixed to `"supabase"`
+ * and is not caller-configurable, so provider identity stays stable.
+ */
+export interface SupabaseStorageDriverOptions {
+    /** Injected clock for deterministic timestamps in tests. Default `systemClock`. */
+    readonly clock?: Clock;
+}
+/**
+ * Maps the {@link StorageDriver} contract onto an injected
+ * {@link SupabaseStorageClientLike}.
+ *
+ * Object identity fields (`etag`/`checksum`/`size`) and timestamps are computed
+ * locally at write time — the checksum/etag are the sha-256 hex digest of the
+ * stored bytes, the size is the byte length, and timestamps come from the
+ * injected {@link Clock} — then encoded into the object's custom metadata so they
+ * round-trip on read. Advanced capabilities are left `undefined` for facade
+ * simulation.
+ */
+export declare class SupabaseStorageDriver implements StorageDriver {
+    /** Stable driver name. */
+    readonly name = "supabase";
+    private readonly client;
+    private readonly clock;
+    constructor(client: SupabaseStorageClientLike, options?: SupabaseStorageDriverOptions);
+    /**
+     * Store `bytes` under `key`, computing size and sha-256 checksum locally and
+     * taking timestamps from the injected clock. When overwriting, the original
+     * `createdAt` is preserved (a preceding attribute read). The typed metadata is
+     * encoded into the object's custom-metadata map so it round-trips on read
+     * (Requirements 4.1, 10.1, 10.2).
+     */
+    put(key: string, bytes: Uint8Array, metadata: WriteMetadata): Promise<StorageObjectMetadata>;
+    /**
+     * Read the object at `key`, returning a discriminated {@link MaybeObject} so
+     * absence is reported rather than thrown (Requirements 4.2, 2.4). Metadata is
+     * rebuilt from the object's attributes and encoded custom metadata via the
+     * shared metadata layer.
+     */
+    get(key: string): Promise<MaybeObject>;
+    /** Report whether an object is stored under `key` (Requirement 4.3). */
+    exists(key: string): Promise<boolean>;
+    /** Delete the object at `key`; deleting a missing key is a no-op (Requirement 4.4). */
+    delete(key: string): Promise<void>;
+    /**
+     * Return the metadata for `key` without its content, or `null` when absent
+     * (Requirement 4.10).
+     */
+    stat(key: string): Promise<StorageObjectMetadata | null>;
+    /**
+     * List objects whose key begins with `prefix`, sorted by key for deterministic
+     * ordering (Requirement 4.9). Honors optional `cursor` (exclusive resume
+     * point) and `limit`.
+     */
+    list(prefix: string, options?: ListOptions): Promise<StorageListItem[]>;
+    /**
+     * Consume a Node {@link Readable} and persist the assembled bytes under `key`
+     * with the same computed metadata as {@link put} (Requirement 5.1). Chunks are
+     * drained through a `pipeline` (correct backpressure and error propagation),
+     * then handed to {@link put}.
+     */
+    putStream(key: string, stream: NodeReadable, metadata: WriteMetadata): Promise<StorageObjectMetadata>;
+    /**
+     * Return a Node {@link Readable} of the stored bytes at `key` (Requirement
+     * 5.2). Throws {@link NotFoundError} for a missing key (Requirement 5.5).
+     */
+    getStream(key: string): Promise<NodeReadable>;
+    /**
+     * Rebuild the typed {@link StorageObjectMetadata} field set from the object's
+     * attributes and the encoded custom-metadata map, applying the shared layer's
+     * canonical defaults. Provider-supplied values are used as best-effort
+     * fallbacks when the encoded fields are absent (e.g. an object written outside
+     * this driver): `etag`/`createdAt`/`updatedAt` back-fill the identity/timestamp
+     * fields, keeping the shape consistent across providers.
+     */
+    private decodeMeta;
+}
+/**
+ * Wrap an injected {@link SupabaseStorageClientLike} as a Supabase driver.
+ * Synchronous and SDK-free: the caller supplies the client, so no provider SDK
+ * is resolved here.
+ *
+ * @throws {StorageConfigError} when no client is injected — use
+ *   {@link connectSupabaseStorageDriver} to build a client from connection
+ *   options instead.
+ */
+export declare function createSupabaseStorageDriver(client: SupabaseStorageClientLike, options?: SupabaseStorageDriverOptions): StorageDriver;
+/**
+ * Connection configuration for {@link connectSupabaseStorageDriver}. `url` and
+ * `key` are forwarded to `createClient`; `bucket` scopes the resulting storage
+ * client.
+ */
+export interface SupabaseStorageConfig extends SupabaseStorageDriverOptions {
+    /** The Supabase project URL (required). */
+    readonly url: string;
+    /** The Supabase API key — service-role or anon (required). */
+    readonly key: string;
+    /** The Supabase Storage bucket the driver operates within (required). */
+    readonly bucket: string;
+}
+/**
+ * Build a Supabase driver that owns its client, resolving `@supabase/supabase-js`
+ * lazily.
+ *
+ * The SDK is loaded through a dynamic `import()` with a non-literal specifier so
+ * it is never a static/top-level dependency: `tsc` does not require it to be
+ * installed, and it is only resolved when this function runs. When the SDK
+ * cannot be resolved, a {@link StorageConfigError} is thrown (Requirement 1.5) —
+ * callers that cannot install the SDK should use
+ * {@link createSupabaseStorageDriver} with their own
+ * {@link SupabaseStorageClientLike} instead.
+ */
+export declare function connectSupabaseStorageDriver(config: SupabaseStorageConfig): Promise<StorageDriver>;
+//# sourceMappingURL=supabase.d.ts.map

package/dist/drivers/supabase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../../src/drivers/supabase.ts"],"names":[],"mappings":"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"}