@streetjs/storage 1.0.0

package/dist/drivers/azure.js

@@ -0,0 +1,476 @@
+/**
+ * @streetjs/storage — Azure Blob Storage driver submodule (`@streetjs/storage/azure`).
+ *
+ * Azure Blob Storage does **not** speak the S3 wire shape, so — unlike
+ * `s3.ts`/`r2.ts`/`minio.ts`/`backblaze.ts`, which specialize the shared
+ * {@link createS3StyleDriver} base — this driver maps the {@link StorageDriver}
+ * contract **directly** onto a structural Azure Blob client
+ * ({@link AzureBlobClientLike}). It computes object identity fields
+ * (`size`/`checksum`/`etag`) and timestamps locally and assembles every
+ * {@link StorageObjectMetadata} through the shared metadata layer
+ * ({@link buildObjectMetadata}) so the field set is identical to Memory/Local
+ * and every other provider (Requirement 2.1, 10.1).
+ *
+ * ## SDK isolation (Requirements 3.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. There are two ways to obtain a driver:
+ *
+ * 1. **Inject a structural client.** {@link createAzureBlobDriver} accepts an
+ *    already-built {@link AzureBlobClientLike} (real SDK adapter or a test
+ *    double) and maps the contract onto it. The `@azure/storage-blob` SDK stays
+ *    an optional peer concern of the consumer and is never touched by this
+ *    package.
+ *
+ * 2. **Let the driver build its own client.** {@link connectAzureBlobDriver}
+ *    resolves the optional `@azure/storage-blob` peer SDK with a **lazy dynamic
+ *    `import()`** performed *inside the function* (never at module top level),
+ *    constructs a container-scoped client, adapts it to
+ *    {@link AzureBlobClientLike}, and hands it to {@link createAzureBlobDriver}.
+ *    If the SDK is absent, it throws {@link StorageConfigError} rather than a raw
+ *    module-resolution error.
+ *
+ * Because the driver lives behind the `./azure` subpath export
+ * (`dist/drivers/azure.js`) and is *not* re-exported from the package index, a
+ * consumer only loads this code — and any SDK it lazily resolves — when they
+ * import `@streetjs/storage/azure`. `package.json` lists `@azure/storage-blob`
+ * as an optional peer dependency, never a runtime dependency, keeping `streetjs`
+ * the only runtime dependency.
+ *
+ * ## Capability delegation (Requirement 2.3)
+ *
+ * Only the **mandatory primitives** (`put`/`get`/`exists`/`delete`/`stat`/
+ * `list`/`putStream`/`getStream`) are implemented. The advanced capabilities
+ * (`multipart`/`resumable`/`versioning`/`signedUrl`/`lifecycle`) are left
+ * `undefined` so the facade's cross-cutting layer supplies a provider-agnostic
+ * simulation over the primitives, keeping observable behavior identical across
+ * providers.
+ *
+ * _Requirements: 2.1, 2.3, 3.3_
+ */
+import { createHash } from "node:crypto";
+import { Readable, Writable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { systemClock } from "streetjs";
+import { StorageConfigError, NotFoundError } from "../errors.js";
+import { buildObjectMetadata } from "../metadata.js";
+/** The stable {@link StorageDriver.name} surfaced by every Azure Blob driver. */
+const AZURE_DRIVER_NAME = "azure";
+// ── Metadata encoding keys ────────────────────────────────────────────────────
+/**
+ * Reserved blob-metadata keys used to round-trip the typed metadata field set
+ * through Azure's string→string blob metadata map. Azure blob metadata names
+ * must be valid C# identifiers (letters/digits/underscore, no hyphens), so these
+ * keys are underscore-delimited rather than the `x-...-` style used by the
+ * S3-style base. The `street_` prefix keeps them from colliding with a caller's
+ * own custom fields.
+ */
+const MK = {
+    checksum: "street_checksum",
+    createdAt: "street_created_at",
+    updatedAt: "street_updated_at",
+    owner: "street_owner",
+    tenant: "street_tenant",
+    accessLevel: "street_access_level",
+    custom: "street_custom",
+};
+// ── The Azure Blob driver ──────────────────────────────────────────────────────
+/**
+ * Maps the {@link StorageDriver} contract directly onto an injected
+ * {@link AzureBlobClientLike}.
+ *
+ * Unlike the S3-compatible providers, Azure Blob does not share the S3 wire
+ * shape, so this driver does not build on {@link createS3StyleDriver}. It
+ * computes size/checksum/etag and timestamps locally, encodes the typed metadata
+ * into the blob metadata map so it round-trips on read, and reports a missing
+ * key consistently ({@link MaybeObject} `{ found: false }` for `get`, `null` for
+ * `stat`, {@link NotFoundError} for `getStream`).
+ */
+export class AzureBlobDriver {
+    /** Stable driver name. */
+    name = AZURE_DRIVER_NAME;
+    client;
+    clock;
+    constructor(client, options = {}) {
+        this.client = client;
+        this.clock = options.clock ?? systemClock;
+    }
+    // ── Mandatory primitives ──────────────────────────────────────────────────
+    /**
+     * 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 blob metadata map so it round-trips on read
+     * (Requirements 4.1, 10.1, 10.2).
+     */
+    async put(key, bytes, metadata) {
+        const stored = bytes.slice();
+        const checksum = sha256Hex(stored);
+        const now = this.clock();
+        const existing = await this.stat(key);
+        const objectMetadata = buildObjectMetadata({
+            key,
+            size: stored.byteLength,
+            checksum,
+            createdAt: existing?.createdAt ?? now,
+            updatedAt: now,
+            write: metadata,
+        });
+        await this.client.upload({
+            blobName: key,
+            body: stored,
+            contentType: objectMetadata.contentType,
+            metadata: encodeMetadata(objectMetadata),
+        });
+        return objectMetadata;
+    }
+    /**
+     * 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 blob attributes and encoded metadata via the shared layer.
+     */
+    async get(key) {
+        const out = await this.client.download({ blobName: key });
+        if (out === null) {
+            return { found: false };
+        }
+        const bytes = out.body.slice();
+        const metadata = this.decodeMeta(key, {
+            contentType: out.contentType,
+            etag: out.etag,
+            contentLength: bytes.byteLength,
+            lastModified: out.lastModified,
+            metadata: out.metadata,
+        });
+        return { found: true, bytes, metadata };
+    }
+    /** Report whether an object is stored under `key` (Requirement 4.3). */
+    async exists(key) {
+        return this.client.exists({ blobName: key });
+    }
+    /** Delete the object at `key`; deleting a missing key is a no-op (Requirement 4.4). */
+    async delete(key) {
+        await this.client.deleteBlob({ blobName: key });
+    }
+    /**
+     * Return the metadata for `key` without its content, or `null` when absent
+     * (Requirement 4.10).
+     */
+    async stat(key) {
+        const props = await this.client.getProperties({ blobName: key });
+        if (props === null) {
+            return null;
+        }
+        return this.decodeMeta(key, props);
+    }
+    /** List objects whose key begins with `prefix` (Requirement 4.9). */
+    async list(prefix, options) {
+        const items = await this.client.listBlobs({ prefix, limit: options?.limit });
+        const sorted = [...items].sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+        const limited = typeof options?.limit === "number" ? sorted.slice(0, options.limit) : sorted;
+        return limited.map((item) => ({
+            key: item.name,
+            size: item.contentLength,
+            updatedAt: item.lastModified,
+        }));
+    }
+    // ── Streaming ───────────────────────────────────────────────────────────────
+    /**
+     * 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}.
+     */
+    async putStream(key, stream, metadata) {
+        const chunks = [];
+        const collector = new Writable({
+            write(chunk, _encoding, callback) {
+                chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+                callback();
+            },
+        });
+        await pipeline(stream, collector);
+        return this.put(key, new Uint8Array(Buffer.concat(chunks)), metadata);
+    }
+    /**
+     * Return a Node {@link Readable} of the stored bytes at `key` (Requirement
+     * 5.2). Throws {@link NotFoundError} for a missing key (Requirement 5.5).
+     */
+    async getStream(key) {
+        const out = await this.client.download({ blobName: key });
+        if (out === null) {
+            throw new NotFoundError(key);
+        }
+        return Readable.from([Buffer.from(out.body)]);
+    }
+    // ── Internal helpers ──────────────────────────────────────────────────────
+    /**
+     * Rebuild the typed {@link StorageObjectMetadata} field set from blob
+     * attributes and the encoded metadata map, applying the shared layer's
+     * canonical defaults. Provider-supplied values back-fill identity/timestamp
+     * fields when the encoded ones are absent (e.g. a blob written outside this
+     * driver), keeping the shape consistent across providers.
+     */
+    decodeMeta(key, props) {
+        const bm = props.metadata ?? {};
+        const now = this.clock();
+        const checksum = bm[MK.checksum] ?? props.etag ?? "";
+        const createdAt = parseEpoch(bm[MK.createdAt]) ?? props.lastModified ?? now;
+        const updatedAt = parseEpoch(bm[MK.updatedAt]) ?? props.lastModified ?? createdAt;
+        const write = {
+            contentType: props.contentType,
+            owner: bm[MK.owner],
+            tenant: bm[MK.tenant],
+            accessLevel: decodeAccessLevel(bm[MK.accessLevel]),
+            custom: parseCustom(bm[MK.custom]),
+        };
+        return buildObjectMetadata({
+            key,
+            size: props.contentLength ?? 0,
+            checksum,
+            etag: props.etag ?? checksum,
+            createdAt,
+            updatedAt,
+            write,
+        });
+    }
+}
+/**
+ * Create an Azure-Blob-backed {@link StorageDriver} over an **injected**
+ * structural {@link AzureBlobClientLike}.
+ *
+ * This is the primary, SDK-free entry point: the caller supplies a client that
+ * already speaks the {@link AzureBlobClientLike} shape (built from
+ * `@azure/storage-blob`, or a test double), and this function maps the contract
+ * onto it. No provider SDK is imported.
+ *
+ * @throws {StorageConfigError} when no client is injected — use
+ *   {@link connectAzureBlobDriver} to build a client from connection options.
+ */
+export function createAzureBlobDriver(client, options = {}) {
+    if (client === undefined || client === null) {
+        throw new StorageConfigError("createAzureBlobDriver requires an injected Azure Blob client. " +
+            "Pass an AzureBlobClientLike, or use connectAzureBlobDriver(options) to " +
+            "build one from a connection string using the optional " +
+            "'@azure/storage-blob' peer dependency.", { provider: AZURE_DRIVER_NAME });
+    }
+    return new AzureBlobDriver(client, options);
+}
+/**
+ * Build an Azure-Blob-backed {@link StorageDriver}, constructing the underlying
+ * client from `connection` options using the optional `@azure/storage-blob` peer
+ * SDK.
+ *
+ * The SDK is resolved with a **lazy dynamic `import()`** performed inside this
+ * function, so the peer dependency is only touched when a caller actually asks
+ * the driver to build its own client. The resolved SDK client is adapted to the
+ * structural {@link AzureBlobClientLike} and handed to {@link createAzureBlobDriver}.
+ *
+ * @throws {StorageConfigError} when the `@azure/storage-blob` SDK is not
+ *   installed, or when the client cannot be constructed from the supplied options.
+ */
+export async function connectAzureBlobDriver(connection, options = {}) {
+    const sdk = await loadAzureSdk();
+    let containerClient;
+    try {
+        const service = sdk.BlobServiceClient.fromConnectionString(connection.connectionString);
+        containerClient = service.getContainerClient(connection.container);
+    }
+    catch (cause) {
+        throw new StorageConfigError(`Failed to construct an Azure Blob client for container "${connection.container}".`, { provider: AZURE_DRIVER_NAME, cause });
+    }
+    const client = adaptAzureContainerClient(containerClient);
+    return createAzureBlobDriver(client, options);
+}
+/**
+ * Lazily resolve the optional `@azure/storage-blob` peer SDK. The module
+ * specifier is held in a variable so the compiler does not statically resolve
+ * (and therefore require) the optional peer at build time; the resolution
+ * happens only at call time.
+ *
+ * @throws {StorageConfigError} when the SDK is not installed.
+ */
+async function loadAzureSdk() {
+    const specifier = "@azure/storage-blob";
+    try {
+        return (await import(specifier));
+    }
+    catch (cause) {
+        throw new StorageConfigError("The optional '@azure/storage-blob' peer dependency is not installed. " +
+            "Install it (`npm install @azure/storage-blob`) to build an Azure Blob " +
+            "client from a connection string, or inject your own AzureBlobClientLike " +
+            "via createAzureBlobDriver(client).", { provider: AZURE_DRIVER_NAME, cause });
+    }
+}
+// ── SDK → AzureBlobClientLike adapter ──────────────────────────────────────────
+/**
+ * Adapt an Azure `ContainerClient` into the structural {@link AzureBlobClientLike}
+ * the driver consumes, scoping every call to that container. Not-found responses
+ * (a 404 `RestError`/`BlobNotFound`) are mapped to `null`/no-op so absence is
+ * reported consistently rather than thrown.
+ */
+function adaptAzureContainerClient(container) {
+    return {
+        async upload(input) {
+            const blob = container.getBlockBlobClient(input.blobName);
+            const body = Buffer.from(input.body);
+            const result = await blob.upload(body, body.byteLength, {
+                blobHTTPHeaders: input.contentType !== undefined
+                    ? { blobContentType: input.contentType }
+                    : undefined,
+                metadata: input.metadata,
+            });
+            return { etag: result.etag };
+        },
+        async download(input) {
+            const blob = container.getBlockBlobClient(input.blobName);
+            let response;
+            try {
+                response = await blob.download();
+            }
+            catch (error) {
+                if (isNotFound(error)) {
+                    return null;
+                }
+                throw error;
+            }
+            const body = response.readableStreamBody
+                ? await collectStream(response.readableStreamBody)
+                : new Uint8Array(0);
+            return {
+                body,
+                contentType: response.contentType,
+                etag: response.etag,
+                contentLength: response.contentLength ?? body.byteLength,
+                lastModified: response.lastModified?.getTime(),
+                metadata: response.metadata,
+            };
+        },
+        async getProperties(input) {
+            const blob = container.getBlockBlobClient(input.blobName);
+            try {
+                const props = await blob.getProperties();
+                return {
+                    contentType: props.contentType,
+                    etag: props.etag,
+                    contentLength: props.contentLength,
+                    lastModified: props.lastModified?.getTime(),
+                    metadata: props.metadata,
+                };
+            }
+            catch (error) {
+                if (isNotFound(error)) {
+                    return null;
+                }
+                throw error;
+            }
+        },
+        async deleteBlob(input) {
+            const blob = container.getBlockBlobClient(input.blobName);
+            await blob.deleteIfExists();
+        },
+        async exists(input) {
+            const blob = container.getBlockBlobClient(input.blobName);
+            return blob.exists();
+        },
+        async listBlobs(input) {
+            const items = [];
+            for await (const blob of container.listBlobsFlat({ prefix: input.prefix })) {
+                items.push({
+                    name: blob.name,
+                    contentLength: blob.properties?.contentLength ?? 0,
+                    lastModified: blob.properties?.lastModified?.getTime() ?? 0,
+                });
+                if (typeof input.limit === "number" && items.length >= input.limit) {
+                    break;
+                }
+            }
+            return items;
+        },
+    };
+}
+// ── Metadata encode/decode helpers ──────────────────────────────────────────────
+/** Encode a built object's typed metadata into the Azure blob metadata map. */
+function encodeMetadata(metadata) {
+    const map = {
+        [MK.checksum]: metadata.checksum,
+        [MK.createdAt]: String(metadata.createdAt),
+        [MK.updatedAt]: String(metadata.updatedAt),
+        [MK.accessLevel]: metadata.accessLevel,
+        [MK.custom]: JSON.stringify(metadata.custom ?? {}),
+    };
+    if (metadata.owner !== undefined) {
+        map[MK.owner] = metadata.owner;
+    }
+    if (metadata.tenant !== undefined) {
+        map[MK.tenant] = metadata.tenant;
+    }
+    return map;
+}
+/** Compute the lowercase sha-256 hex digest of `bytes`. */
+function sha256Hex(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}
+/** Collect a Node readable stream into a single {@link Uint8Array}. */
+async function collectStream(stream) {
+    const chunks = [];
+    for await (const chunk of stream) {
+        chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : Buffer.from(chunk));
+    }
+    return new Uint8Array(Buffer.concat(chunks));
+}
+/**
+ * Detect an Azure "blob does not exist" error so absence maps to `null`/no-op
+ * rather than a thrown error, keeping not-found semantics identical across
+ * providers.
+ */
+function isNotFound(error) {
+    if (error === null || typeof error !== "object") {
+        return false;
+    }
+    const code = error.code;
+    const statusCode = error.statusCode;
+    return code === "BlobNotFound" || code === "ContainerNotFound" || statusCode === 404;
+}
+/** Parse an epoch-ms string, returning `undefined` when absent or non-numeric. */
+function parseEpoch(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+/** Parse the encoded custom-field JSON, tolerating malformed values. */
+function parseCustom(value) {
+    if (value === undefined) {
+        return {};
+    }
+    try {
+        const parsed = JSON.parse(value);
+        if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        // Fall through to the empty default on malformed JSON.
+    }
+    return {};
+}
+/** The recognized access levels, used to validate the decoded value. */
+const ACCESS_LEVELS = [
+    "public",
+    "private",
+    "signed",
+    "authenticated",
+    "role-based",
+    "tenant-aware",
+];
+/** Decode an access-level string, returning `undefined` for an unknown value. */
+function decodeAccessLevel(value) {
+    if (value !== undefined && ACCESS_LEVELS.includes(value)) {
+        return value;
+    }
+    return undefined;
+}
+//# sourceMappingURL=azure.js.map

package/dist/drivers/azure.js.map

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

package/dist/drivers/backblaze.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @streetjs/storage — the Backblaze B2 driver submodule (`@streetjs/storage/backblaze`).
+ *
+ * Backblaze B2 exposes a **fully S3-compatible API**, so this driver is a thin
+ * specialization of the shared S3-style base ({@link createS3StyleDriver} in
+ * `s3-base.ts`): it only differs in how the underlying client is
+ * built/configured (a B2 S3 endpoint and B2 application-key credentials), never
+ * in how the {@link StorageDriver} contract is satisfied. The driver name is
+ * fixed to `"backblaze"`.
+ *
+ * ## SDK isolation (Requirements 3.1, 3.3)
+ *
+ * This module imports **no provider SDK at the top level** — only this package's
+ * own type surface and the shared S3-style base. It supports two construction
+ * modes:
+ *
+ * 1. **Injected structural client** — the caller passes an {@link S3ClientLike}
+ *    (the minimal, SDK-shaped structural interface the base depends on). The SDK
+ *    is then entirely a concern of the caller; this package resolves nothing.
+ *    ({@link createBackblazeB2Driver} with a client, synchronous.)
+ * 2. **Self-built client from connection config** — the driver constructs its own
+ *    S3-compatible client for the B2 endpoint using a **lazy dynamic `import()`**
+ *    performed inside the factory at construction time (never at module top
+ *    level), so `@aws-sdk/client-s3` is resolved only when this submodule is
+ *    actually used to build a client. If that optional peer SDK is absent (and no
+ *    client was injected), a descriptive {@link StorageConfigError} is thrown.
+ *    ({@link createBackblazeB2Driver} with a config, asynchronous.)
+ *
+ * Because this driver lives behind the `./backblaze` subpath export and the base
+ * package never imports it, `streetjs` stays the only runtime dependency and the
+ * B2/S3 SDK remains an optional peer dependency.
+ *
+ * _Requirements: 2.1, 2.3, 3.3_
+ */
+import { type Clock } from "streetjs";
+import type { StorageDriver } from "../driver.js";
+import { S3StyleDriver, type S3ClientLike, type S3NativeCapabilities } from "./s3-base.js";
+/** The stable driver name surfaced as {@link StorageDriver.name}. */
+export declare const BACKBLAZE_DRIVER_NAME = "backblaze";
+/**
+ * Options shared by both construction modes. Native capability objects supplied
+ * here are delegated by the base; anything omitted is simulated by the facade
+ * over the mandatory primitives (identical behavior across providers).
+ */
+export interface BackblazeB2DriverOptions {
+    /** Overrides the driver name. Defaults to `"backblaze"`; changing it is rare. */
+    readonly name?: string;
+    /** Injected clock for deterministic timestamps in tests. Default `systemClock`. */
+    readonly clock?: Clock;
+    /** Native capability objects (versioning/lifecycle/signed URLs) to delegate. */
+    readonly capabilities?: S3NativeCapabilities;
+}
+/**
+ * B2 application-key credentials, expressed in S3 terms. The B2 `keyId` maps to
+ * `accessKeyId` and the B2 `applicationKey` maps to `secretAccessKey`.
+ */
+export interface BackblazeB2Credentials {
+    readonly accessKeyId: string;
+    readonly secretAccessKey: string;
+}
+/**
+ * Connection config used when the driver **builds its own** S3-compatible client
+ * for the Backblaze B2 endpoint (the lazy-`import()` path).
+ */
+export interface BackblazeB2ConnectionConfig extends BackblazeB2DriverOptions {
+    /** The B2 bucket name every object operation targets. */
+    readonly bucket: string;
+    /**
+     * The B2 S3-compatible endpoint, e.g. `https://s3.us-west-002.backblazeb2.com`.
+     */
+    readonly endpoint: string;
+    /**
+     * The B2 region label embedded in the endpoint, e.g. `us-west-002`. Defaults to
+     * `"auto"` when omitted (the S3 client requires some region value).
+     */
+    readonly region?: string;
+    /** The B2 application-key credentials (as S3 access/secret keys). */
+    readonly credentials: BackblazeB2Credentials;
+    /**
+     * Use path-style addressing (`endpoint/bucket/key`) instead of virtual-hosted
+     * style. Defaults to `false`; B2's S3 endpoint supports virtual-hosted style.
+     */
+    readonly forcePathStyle?: boolean;
+}
+/**
+ * Create a Backblaze B2 {@link StorageDriver} from an **injected**
+ * {@link S3ClientLike}. Synchronous: no SDK is resolved by this package.
+ */
+export declare function createBackblazeB2Driver(client: S3ClientLike, options?: BackblazeB2DriverOptions): StorageDriver;
+/**
+ * Create a Backblaze B2 {@link StorageDriver} that **builds its own** client for
+ * the B2 S3 endpoint. Asynchronous: the SDK is resolved through a lazy dynamic
+ * `import()`; a {@link StorageConfigError} is thrown when it is absent.
+ */
+export declare function createBackblazeB2Driver(config: BackblazeB2ConnectionConfig): Promise<StorageDriver>;
+/**
+ * A Backblaze B2 driver as a concrete class over an injected {@link S3ClientLike},
+ * for callers who prefer `new` construction. Equivalent to
+ * {@link createBackblazeB2Driver} with an injected client; the name defaults to
+ * `"backblaze"`.
+ */
+export declare class BackblazeB2Driver extends S3StyleDriver {
+    constructor(client: S3ClientLike, options?: BackblazeB2DriverOptions);
+}
+//# sourceMappingURL=backblaze.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backblaze.d.ts","sourceRoot":"","sources":["../../src/drivers/backblaze.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAEL,aAAa,EACb,KAAK,YAAY,EAIjB,KAAK,oBAAoB,EAG1B,MAAM,cAAc,CAAC;AAEtB,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,cAAc,CAAC;AAOjD;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,iFAAiF;IACjF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAC;CAC9C;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA4B,SAAQ,wBAAwB;IAC3E,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC7C;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,wBAAwB,GACjC,aAAa,CAAC;AACjB;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,aAAa,CAAC,CAAC;AAW1B;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,wBAA6B;CAOzE"}