@streetjs/storage 1.0.0

package/dist/drivers/s3-base.js

@@ -0,0 +1,436 @@
+/**
+ * @streetjs/storage — the shared S3-style driver base and {@link S3ClientLike}.
+ *
+ * S3-compatible providers (Amazon S3, Cloudflare R2, MinIO, and the Backblaze B2
+ * S3 API) share one wire shape: a small set of object operations
+ * (`putObject`/`getObject`/`deleteObject`/`listObjects`) plus optional
+ * multipart and presign calls. This module captures that shape as the structural
+ * {@link S3ClientLike} interface and maps the {@link StorageDriver} contract onto
+ * it, so `s3.ts`, `r2.ts`, `minio.ts`, and `backblaze.ts` (tasks 28.2–28.5) only
+ * differ in how they build/configure the client, never in how the contract is
+ * satisfied.
+ *
+ * ## 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. The base accepts an **injected** {@link S3ClientLike}; it never
+ * resolves an SDK itself. The concrete submodules that *can* construct their own
+ * client do so with a **lazy dynamic `import()`** performed inside that submodule
+ * at construction time, so the optional peer SDK is resolved only when that
+ * submodule is actually imported. `streetjs` therefore stays the only runtime
+ * dependency.
+ *
+ * ## Capability delegation (Requirement 2.3)
+ *
+ * The base implements the **mandatory primitives** (`put`/`get`/`exists`/
+ * `delete`/`stat`/`list`/`putStream`/`getStream`) by mapping onto
+ * {@link S3ClientLike}, producing every {@link StorageObjectMetadata} through the
+ * shared metadata layer ({@link buildObjectMetadata}) so the field set is
+ * identical to Memory/Local, and reporting a missing key consistently
+ * ({@link MaybeObject} `{ found: false }` for `get`, `null` for `stat`,
+ * {@link NotFoundError} for `getStream`).
+ *
+ * Advanced capabilities are **delegated to the client when available, otherwise
+ * left `undefined` so the facade simulates them over the primitives**
+ * (Requirement 2, keeping behavior identical across providers):
+ *
+ * - **Multipart** is wired only when the client exposes the full SDK-shaped
+ *   multipart method set; the base adapts those calls into a
+ *   {@link MultipartCapability}, tracking the `uploadId → key` mapping the S3 API
+ *   requires.
+ * - **Versioning / lifecycle / signed URLs** are delegated only when a native
+ *   capability object is supplied through `options.capabilities`; otherwise they
+ *   are left `undefined`. (A provider's presigned URLs are verified by the
+ *   provider, not locally, so the base does not synthesize a
+ *   {@link SignedUrlCapability} from a bare `presignUrl` — the facade's HMAC
+ *   simulation is used instead unless a full native capability is injected.)
+ *
+ * _Requirements: 2.3, 3.1, 3.3_
+ */
+import { createHash } from "node:crypto";
+import { Readable, Writable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { systemClock } from "streetjs";
+import { NotFoundError } from "../errors.js";
+import { buildObjectMetadata } from "../metadata.js";
+// ── User-metadata encoding keys ───────────────────────────────────────────────
+/**
+ * Reserved user-metadata keys used to round-trip the typed metadata field set
+ * through the provider's string→string user-metadata map. Prefixed so they never
+ * collide with a caller's own custom fields.
+ */
+const MK = {
+    checksum: "x-street-checksum",
+    createdAt: "x-street-created-at",
+    updatedAt: "x-street-updated-at",
+    owner: "x-street-owner",
+    tenant: "x-street-tenant",
+    accessLevel: "x-street-access-level",
+    custom: "x-street-custom",
+};
+// ── The S3-style base driver ──────────────────────────────────────────────────
+/**
+ * Maps the {@link StorageDriver} contract onto an injected {@link S3ClientLike}.
+ *
+ * This class is provider-agnostic: every S3-compatible driver (S3, R2, MinIO,
+ * Backblaze) is this base with a differently-constructed client. It imports no
+ * provider SDK; the client is supplied by the caller (typically a submodule that
+ * lazily `import()`s its SDK).
+ */
+export class S3StyleDriver {
+    name;
+    client;
+    clock;
+    /** Tracks the `key` for each in-flight multipart `uploadId` (S3 needs both). */
+    multipartKeys = new Map();
+    // Optional capabilities — populated only when delegation is available.
+    multipart;
+    versioning;
+    signedUrl;
+    lifecycle;
+    constructor(client, options = {}) {
+        this.client = client;
+        this.name = options.name ?? "s3";
+        this.clock = options.clock ?? systemClock;
+        // Wire native multipart only when the client exposes the full method set;
+        // otherwise the facade simulates multipart over put/get.
+        if (typeof client.createMultipartUpload === "function" &&
+            typeof client.uploadPart === "function" &&
+            typeof client.completeMultipartUpload === "function" &&
+            typeof client.abortMultipartUpload === "function") {
+            this.multipart = this.buildMultipartCapability();
+        }
+        // Delegate versioning/lifecycle/signed URLs only when a native capability
+        // object is injected; otherwise leave undefined for facade simulation.
+        this.versioning = options.capabilities?.versioning;
+        this.lifecycle = options.capabilities?.lifecycle;
+        this.signedUrl = options.capabilities?.signedUrl;
+    }
+    // ── 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 provider's user-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.readMeta(key);
+        const objectMetadata = buildObjectMetadata({
+            key,
+            size: stored.byteLength,
+            checksum,
+            createdAt: existing?.createdAt ?? now,
+            updatedAt: now,
+            write: metadata,
+        });
+        await this.client.putObject({
+            key,
+            body: stored,
+            contentType: objectMetadata.contentType,
+            metadata: encodeUserMetadata(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 provider attributes and encoded user metadata via the
+     * shared metadata layer.
+     */
+    async get(key) {
+        const out = await this.client.getObject({ key });
+        if (out === null) {
+            return { found: false };
+        }
+        const bytes = out.body.slice();
+        const metadata = this.decodeMeta(key, {
+            contentType: out.contentType,
+            etag: out.etag,
+            size: 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) {
+        if (typeof this.client.headObject === "function") {
+            const head = await this.client.headObject({ key });
+            return head !== null;
+        }
+        const out = await this.client.getObject({ key });
+        return out !== null;
+    }
+    /** Delete the object at `key`; deleting a missing key is a no-op (Requirement 4.4). */
+    async delete(key) {
+        await this.client.deleteObject({ key });
+    }
+    /**
+     * Return the metadata for `key` without its content, or `null` when absent
+     * (Requirement 4.10). Uses `headObject` when available, else falls back to a
+     * body fetch.
+     */
+    async stat(key) {
+        if (typeof this.client.headObject === "function") {
+            const head = await this.client.headObject({ key });
+            if (head === null) {
+                return null;
+            }
+            return this.decodeMeta(key, head);
+        }
+        const out = await this.client.getObject({ key });
+        if (out === null) {
+            return null;
+        }
+        return this.decodeMeta(key, {
+            contentType: out.contentType,
+            etag: out.etag,
+            size: out.size ?? out.body.byteLength,
+            lastModified: out.lastModified,
+            metadata: out.metadata,
+        });
+    }
+    /** List objects whose key begins with `prefix` (Requirement 4.9). */
+    async list(prefix, options) {
+        const items = await this.client.listObjects({
+            prefix,
+            limit: options?.limit,
+            cursor: options?.cursor,
+            delimiter: options?.delimiter,
+        });
+        return items.map((item) => ({
+            key: item.key,
+            size: item.size,
+            updatedAt: item.updatedAt,
+        }));
+    }
+    // ── 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.getObject({ key });
+        if (out === null) {
+            throw new NotFoundError(key);
+        }
+        return Readable.from([Buffer.from(out.body)]);
+    }
+    // ── Internal helpers ──────────────────────────────────────────────────────
+    /**
+     * Best-effort read of an object's existing metadata (used to preserve
+     * `createdAt` on overwrite). Returns `null` when the object does not exist.
+     */
+    async readMeta(key) {
+        return this.stat(key);
+    }
+    /**
+     * Rebuild the typed {@link StorageObjectMetadata} field set from provider
+     * attributes and the encoded user-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 base): `etag`/`size`/`lastModified` back-fill the identity/timestamp
+     * fields, keeping the shape consistent across providers.
+     */
+    decodeMeta(key, out) {
+        const um = out.metadata ?? {};
+        const now = this.clock();
+        const checksum = um[MK.checksum] ?? out.etag ?? "";
+        const createdAt = parseEpoch(um[MK.createdAt]) ?? out.lastModified ?? now;
+        const updatedAt = parseEpoch(um[MK.updatedAt]) ?? out.lastModified ?? createdAt;
+        const write = {
+            contentType: out.contentType,
+            owner: um[MK.owner],
+            tenant: um[MK.tenant],
+            accessLevel: decodeAccessLevel(um[MK.accessLevel]),
+            custom: parseCustom(um[MK.custom]),
+        };
+        return buildObjectMetadata({
+            key,
+            size: out.size ?? 0,
+            checksum,
+            etag: out.etag ?? checksum,
+            createdAt,
+            updatedAt,
+            write,
+        });
+    }
+    /**
+     * Adapt the client's SDK-shaped multipart calls into a
+     * {@link MultipartCapability}. The S3 API requires the object key on every
+     * part/complete/abort call, so the `uploadId → key` mapping is tracked here.
+     */
+    buildMultipartCapability() {
+        const client = this.client;
+        const clock = this.clock;
+        const keys = this.multipartKeys;
+        const readMeta = (key) => this.stat(key);
+        const requireKey = (uploadId) => {
+            const key = keys.get(uploadId);
+            if (key === undefined) {
+                throw new NotFoundError(uploadId, `Unknown multipart upload "${uploadId}"`);
+            }
+            return key;
+        };
+        return {
+            async create(key, metadata) {
+                const now = clock();
+                const { uploadId } = await client.createMultipartUpload({
+                    key,
+                    contentType: metadata.contentType,
+                    metadata: encodeWriteMetadata(metadata, now),
+                });
+                keys.set(uploadId, key);
+                return uploadId;
+            },
+            async uploadPart(uploadId, partNumber, bytes) {
+                const key = requireKey(uploadId);
+                const { etag } = await client.uploadPart({ key, uploadId, partNumber, body: bytes });
+                return { partNumber, etag, size: bytes.byteLength };
+            },
+            async complete(uploadId, parts) {
+                const key = requireKey(uploadId);
+                await client.completeMultipartUpload({
+                    key,
+                    uploadId,
+                    parts: parts.map((part) => ({ partNumber: part.partNumber, etag: part.etag })),
+                });
+                keys.delete(uploadId);
+                const metadata = await readMeta(key);
+                if (metadata !== null) {
+                    return metadata;
+                }
+                // The object should exist after completion; fall back to a minimal,
+                // shaped record if the provider cannot immediately describe it.
+                const now = clock();
+                const size = parts.reduce((total, part) => total + part.size, 0);
+                return buildObjectMetadata({
+                    key,
+                    size,
+                    checksum: "",
+                    createdAt: now,
+                    updatedAt: now,
+                    write: {},
+                });
+            },
+            async abort(uploadId) {
+                const key = requireKey(uploadId);
+                await client.abortMultipartUpload({ key, uploadId });
+                keys.delete(uploadId);
+            },
+        };
+    }
+}
+/**
+ * Construct an S3-style {@link StorageDriver} over an injected
+ * {@link S3ClientLike}. This is the entry point consumed by the concrete
+ * provider submodules (`s3.ts`/`r2.ts`/`minio.ts`/`backblaze.ts`), each of which
+ * supplies a differently-constructed client.
+ */
+export function createS3StyleDriver(client, options) {
+    return new S3StyleDriver(client, options);
+}
+// ── Module-private encoding helpers ────────────────────────────────────────────
+/** Compute the lowercase sha-256 hex digest of `bytes`. */
+function sha256Hex(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}
+/** Encode a built object's typed metadata into the provider user-metadata map. */
+function encodeUserMetadata(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;
+}
+/**
+ * Encode write-time metadata (plus timestamps) into a user-metadata map for a
+ * multipart create, so the assembled object round-trips its typed fields.
+ */
+function encodeWriteMetadata(metadata, now) {
+    const map = {
+        [MK.createdAt]: String(now),
+        [MK.updatedAt]: String(now),
+        [MK.accessLevel]: metadata.accessLevel ?? "private",
+        [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;
+}
+/** 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=s3-base.js.map

package/dist/drivers/s3-base.js.map

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

package/dist/drivers/s3.d.ts

@@ -0,0 +1,111 @@
+/**
+ * @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 { type Clock } from "streetjs";
+import type { StorageDriver } from "../driver.js";
+import { type S3ClientLike, type S3NativeCapabilities } from "./s3-base.js";
+/**
+ * Options accepted by {@link createS3StorageDriver} and, alongside the
+ * connection fields, by {@link createS3StorageDriverFromConfig}.
+ *
+ * The driver `name` is always `"s3"` and is intentionally not configurable here
+ * (use the shared base directly if a different name is required).
+ */
+export interface S3StorageDriverOptions {
+    /** Injected clock for deterministic timestamps in tests. Default `systemClock`. */
+    readonly clock?: Clock;
+    /**
+     * Native capability objects to delegate to (versioning / lifecycle / signed
+     * URLs). Any capability omitted here is left `undefined` so the facade
+     * simulates it over the primitives, keeping behavior identical across
+     * providers (Requirement 2.3).
+     */
+    readonly capabilities?: S3NativeCapabilities;
+}
+/** AWS credentials used when constructing a client from configuration. */
+export interface S3Credentials {
+    readonly accessKeyId: string;
+    readonly secretAccessKey: string;
+    readonly sessionToken?: string;
+}
+/**
+ * Connection configuration for {@link createS3StorageDriverFromConfig}. A
+ * pre-constructed {@link S3ClientLike} may be supplied via `client` to bypass SDK
+ * construction entirely (the preferred, SDK-free path).
+ */
+export interface S3StorageDriverConfig extends S3StorageDriverOptions {
+    /** The S3 bucket every operation targets. Required when constructing a client. */
+    readonly bucket: string;
+    /** AWS region (e.g. `"us-east-1"`). */
+    readonly region?: string;
+    /** Custom endpoint (for S3-compatible gateways). */
+    readonly endpoint?: string;
+    /** Static credentials; when omitted the SDK's default credential chain is used. */
+    readonly credentials?: S3Credentials;
+    /** Force path-style addressing (needed by some S3-compatible endpoints). */
+    readonly forcePathStyle?: boolean;
+    /**
+     * A pre-constructed structural client. When provided, no AWS SDK is loaded and
+     * this client is wrapped directly.
+     */
+    readonly client?: S3ClientLike;
+}
+/**
+ * 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 declare function createS3StorageDriver(client: S3ClientLike, options?: S3StorageDriverOptions): StorageDriver;
+/**
+ * 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 declare function createS3StorageDriverFromConfig(config: S3StorageDriverConfig): Promise<StorageDriver>;
+//# sourceMappingURL=s3.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../../src/drivers/s3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,oBAAoB,EAC1B,MAAM,cAAc,CAAC;AAOtB;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAC;CAC9C;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,sBAAsB;IACnE,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,mFAAmF;IACnF,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;IACrC,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;CAChC;AAID;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,sBAA2B,GACnC,aAAa,CAef;AAED;;;;;;;;;GASG;AACH,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,aAAa,CAAC,CAUxB"}