@streetjs/storage 1.0.0

package/dist/drivers/supabase.js

@@ -0,0 +1,502 @@
+/**
+ * @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 { createHash } from "node:crypto";
+import { Readable, Writable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { systemClock } from "streetjs";
+import { NotFoundError, StorageConfigError } from "../errors.js";
+import { buildObjectMetadata } from "../metadata.js";
+/** The stable driver name surfaced as {@link StorageDriver.name} for Supabase. */
+const SUPABASE_DRIVER_NAME = "supabase";
+// ── Reserved user-metadata keys ────────────────────────────────────────────────
+/**
+ * Reserved custom-metadata keys used to round-trip the typed metadata field set
+ * through Supabase's string→string custom-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 Supabase driver ─────────────────────────────────────────────────────────
+/**
+ * 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 class SupabaseStorageDriver {
+    /** Stable driver name. */
+    name = SUPABASE_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 object's custom-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({
+            path: key,
+            body: stored,
+            contentType: objectMetadata.contentType,
+            metadata: encodeUserMetadata(objectMetadata),
+            upsert: true,
+        });
+        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 object's attributes and encoded custom metadata via the
+     * shared metadata layer.
+     */
+    async get(key) {
+        const bytes = await this.client.download(key);
+        if (bytes === null) {
+            return { found: false };
+        }
+        const info = await this.client.info(key);
+        const metadata = this.decodeMeta(key, bytes.byteLength, info);
+        return { found: true, bytes: bytes.slice(), metadata };
+    }
+    /** Report whether an object is stored under `key` (Requirement 4.3). */
+    async exists(key) {
+        return this.client.exists(key);
+    }
+    /** Delete the object at `key`; deleting a missing key is a no-op (Requirement 4.4). */
+    async delete(key) {
+        await this.client.remove(key);
+    }
+    /**
+     * Return the metadata for `key` without its content, or `null` when absent
+     * (Requirement 4.10).
+     */
+    async stat(key) {
+        const info = await this.client.info(key);
+        if (info === null) {
+            return null;
+        }
+        const size = parseSize(info.size);
+        return this.decodeMeta(key, size, info);
+    }
+    /**
+     * List objects whose key begins with `prefix`, sorted by key for deterministic
+     * ordering (Requirement 4.9). Honors optional `cursor` (exclusive resume
+     * point) and `limit`.
+     */
+    async list(prefix, options) {
+        const entries = await this.client.list({ prefix, limit: options?.limit });
+        let items = entries
+            .filter((entry) => typeof entry.name === "string")
+            .map((entry) => ({
+            key: entry.name,
+            size: parseSize(entry.size),
+            updatedAt: parseIso(entry.updatedAt) ?? 0,
+        }))
+            .sort((a, b) => (a.key < b.key ? -1 : a.key > b.key ? 1 : 0));
+        const cursor = options?.cursor;
+        if (cursor !== undefined) {
+            items = items.filter((item) => item.key > cursor);
+        }
+        return typeof options?.limit === "number" ? items.slice(0, options.limit) : items;
+    }
+    // ── 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 bytes = await this.client.download(key);
+        if (bytes === null) {
+            throw new NotFoundError(key);
+        }
+        return Readable.from([Buffer.from(bytes)]);
+    }
+    // ── Internal helpers ──────────────────────────────────────────────────────
+    /**
+     * 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.
+     */
+    decodeMeta(key, size, info) {
+        const attrs = info ?? {};
+        const um = attrs.userMetadata ?? {};
+        const now = this.clock();
+        const checksum = um[MK.checksum] ?? attrs.etag ?? "";
+        const createdAt = parseEpoch(um[MK.createdAt]) ?? parseIso(attrs.createdAt) ?? now;
+        const updatedAt = parseEpoch(um[MK.updatedAt]) ?? parseIso(attrs.updatedAt) ?? createdAt;
+        const write = {
+            contentType: attrs.contentType,
+            owner: um[MK.owner],
+            tenant: um[MK.tenant],
+            accessLevel: decodeAccessLevel(um[MK.accessLevel]),
+            custom: parseCustom(um[MK.custom]),
+        };
+        return buildObjectMetadata({
+            key,
+            size,
+            checksum,
+            etag: attrs.etag ?? checksum,
+            createdAt,
+            updatedAt,
+            write,
+        });
+    }
+}
+/**
+ * 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 function createSupabaseStorageDriver(client, options = {}) {
+    if (client === undefined || client === null) {
+        throw new StorageConfigError("createSupabaseStorageDriver requires an injected SupabaseStorageClientLike. " +
+            "Pass a structural client, or use connectSupabaseStorageDriver(config) " +
+            "to build one from a bucket using the optional '@supabase/supabase-js' peer dependency.", { provider: SUPABASE_DRIVER_NAME });
+    }
+    return new SupabaseStorageDriver(client, options);
+}
+/**
+ * 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 async function connectSupabaseStorageDriver(config) {
+    if (!config.url || !config.key || !config.bucket) {
+        throw new StorageConfigError("Supabase driver requires url, key, and bucket.", { provider: SUPABASE_DRIVER_NAME });
+    }
+    // Lazy, non-literal dynamic import so the Supabase SDK stays an optional peer
+    // that `tsc` never resolves statically and Node only loads on this path.
+    const specifier = "@supabase/supabase-js";
+    let sdk;
+    try {
+        sdk = (await import(specifier));
+    }
+    catch (cause) {
+        throw new StorageConfigError('Supabase driver requires the optional peer dependency "@supabase/supabase-js". ' +
+            "Install it, or inject your own SupabaseStorageClientLike via createSupabaseStorageDriver().", { provider: SUPABASE_DRIVER_NAME, cause });
+    }
+    let bucketApi;
+    try {
+        const supabase = sdk.createClient(config.url, config.key);
+        bucketApi = supabase.storage.from(config.bucket);
+    }
+    catch (cause) {
+        throw new StorageConfigError(`Failed to construct a Supabase Storage client for bucket "${config.bucket}".`, { provider: SUPABASE_DRIVER_NAME, cause });
+    }
+    const client = adaptSupabaseBucketApi(bucketApi);
+    return createSupabaseStorageDriver(client, { clock: config.clock });
+}
+// ── SDK → SupabaseStorageClientLike adapter ────────────────────────────────────
+/**
+ * Adapt a `@supabase/supabase-js` storage bucket API into the structural
+ * {@link SupabaseStorageClientLike} this driver consumes. Only the methods the
+ * driver uses are mapped; the SDK's `{ data, error }` envelopes are narrowed
+ * through the local structural types below so this module never imports concrete
+ * SDK types. A missing object is mapped to `null` so not-found semantics stay
+ * consistent.
+ */
+function adaptSupabaseBucketApi(api) {
+    return {
+        async upload(input) {
+            const { error } = await api.upload(input.path, Buffer.from(input.body), {
+                contentType: input.contentType,
+                upsert: input.upsert ?? true,
+                metadata: input.metadata,
+            });
+            if (error) {
+                throw asError(error);
+            }
+            return {};
+        },
+        async download(path) {
+            const { data, error } = await api.download(path);
+            if (error) {
+                if (isNotFound(error)) {
+                    return null;
+                }
+                throw asError(error);
+            }
+            if (data === null || data === undefined) {
+                return null;
+            }
+            const buffer = await data.arrayBuffer();
+            return new Uint8Array(buffer);
+        },
+        async remove(path) {
+            const { error } = await api.remove([path]);
+            if (error && !isNotFound(error)) {
+                throw asError(error);
+            }
+        },
+        async exists(path) {
+            const { data, error } = await api.download(path);
+            if (error) {
+                if (isNotFound(error)) {
+                    return false;
+                }
+                throw asError(error);
+            }
+            return data !== null && data !== undefined;
+        },
+        async info(path) {
+            const { data, error } = await api.info(path);
+            if (error) {
+                if (isNotFound(error)) {
+                    return null;
+                }
+                throw asError(error);
+            }
+            if (data === null || data === undefined) {
+                return null;
+            }
+            const meta = data.metadata ?? {};
+            return {
+                size: data.size ?? meta.size,
+                contentType: data.contentType ?? meta.mimetype,
+                etag: data.etag ?? meta.eTag,
+                createdAt: data.created_at,
+                updatedAt: data.updated_at,
+                userMetadata: data.userMetadata,
+            };
+        },
+        async list(input) {
+            const { data, error } = await api.list(input.prefix, { limit: input.limit });
+            if (error) {
+                throw asError(error);
+            }
+            const rows = data ?? [];
+            return rows.map((row) => {
+                const meta = row.metadata ?? {};
+                return {
+                    name: row.name,
+                    size: meta.size,
+                    updatedAt: row.updated_at,
+                };
+            });
+        },
+    };
+}
+/**
+ * Recognize the Supabase "object does not exist" condition so
+ * `download`/`info`/`remove` can map to `null`/no-op rather than throwing.
+ * Supabase surfaces a `statusCode`/`status` of `404` or a `"not_found"` code.
+ */
+function isNotFound(error) {
+    if (error === null || typeof error !== "object") {
+        return false;
+    }
+    const candidate = error;
+    const statusCode = candidate.statusCode;
+    const status = candidate.status;
+    return (statusCode === 404 ||
+        statusCode === "404" ||
+        status === 404 ||
+        candidate.error === "not_found" ||
+        (typeof candidate.message === "string" && /not[_ ]?found/i.test(candidate.message)));
+}
+/** Coerce a Supabase `{ data, error }` error payload into an `Error`. */
+function asError(error) {
+    if (error instanceof Error) {
+        return error;
+    }
+    if (error !== null && typeof error === "object") {
+        const message = error.message;
+        if (typeof message === "string") {
+            return new Error(message);
+        }
+    }
+    return new Error(String(error));
+}
+// ── 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 Supabase custom-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;
+}
+/** Parse a Supabase `size` (number or numeric string), defaulting to `0`. */
+function parseSize(value) {
+    if (typeof value === "number") {
+        return Number.isFinite(value) ? value : 0;
+    }
+    if (typeof value === "string") {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : 0;
+    }
+    return 0;
+}
+/** 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 an ISO-8601 timestamp to epoch ms, or `undefined`. */
+function parseIso(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = Date.parse(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=supabase.js.map

package/dist/drivers/supabase.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,115 @@
+/**
+ * @streetjs/storage — typed error hierarchy
+ *
+ * Every error thrown by the storage framework derives from {@link StorageError},
+ * so consumers can catch the whole family with a single `instanceof StorageError`
+ * check while still discriminating on concrete subclasses for specific handling.
+ *
+ * Each subclass carries descriptive, strongly typed fields appropriate to its
+ * purpose (the offending key, the validation message, the access context, the
+ * unsupported image source, etc.) and sets `this.name`. Because TypeScript emits
+ * to ES2022 with `Error` subclassing, we call `Object.setPrototypeOf` in every
+ * constructor to keep the prototype chain intact for `instanceof` under ESM/TS.
+ *
+ * _Requirements: 1.5, 5.5, 9.4, 11.3, 14.4_
+ */
+/**
+ * Base class for every error raised by `@streetjs/storage`.
+ *
+ * Catch this to handle any storage failure; narrow to a subclass for specific
+ * cases. Carries an optional `cause` (the underlying error, when this error
+ * wraps another) following the standard `Error` `cause` convention.
+ */
+export declare class StorageError extends Error {
+    /** The underlying error this error wraps, when applicable. */
+    readonly cause?: unknown;
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Raised when `createStorage` (or another configuration step) receives an
+ * invalid or unusable configuration — for example an unknown provider name.
+ *
+ * Carries the optional `provider` that triggered the failure so callers can
+ * surface a precise, descriptive configuration error (Requirement 1.5).
+ */
+export declare class StorageConfigError extends StorageError {
+    /** The provider name (or other config value) that was rejected, if known. */
+    readonly provider?: string;
+    constructor(message: string, options?: {
+        provider?: string;
+        cause?: unknown;
+    });
+}
+/**
+ * Raised when an operation targets an object key that does not exist — for
+ * example `getStream` on a missing key (Requirement 5.5).
+ *
+ * Carries the offending `key` so callers know exactly which object was absent.
+ */
+export declare class NotFoundError extends StorageError {
+    /** The object key that was not found. */
+    readonly key: string;
+    constructor(key: string, message?: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Raised when the validation pipeline rejects an upload before any content is
+ * persisted, leaving no partial object stored (Requirement 9.4).
+ *
+ * Carries the human-readable `validationError` text describing why the upload
+ * was rejected, plus the optional `key` the upload targeted.
+ */
+export declare class ValidationError extends StorageError {
+    /** The descriptive text explaining why validation failed. */
+    readonly validationError: string;
+    /** The object key the rejected upload targeted, when known. */
+    readonly key?: string;
+    constructor(validationError: string, options?: {
+        key?: string;
+        message?: string;
+        cause?: unknown;
+    });
+}
+/**
+ * Raised when a caller lacks the access required by an object's access level,
+ * denying the operation (Requirement 11.3).
+ *
+ * Carries the access context — the `key`, the attempted `operation`, and the
+ * object's `accessLevel` — so the denial can be logged and explained precisely.
+ */
+export declare class AuthorizationError extends StorageError {
+    /** The object key the denied operation targeted, when known. */
+    readonly key?: string;
+    /** The operation that was denied (e.g. "read", "write", "delete"). */
+    readonly operation?: string;
+    /** The access level that governed the denied object, when known. */
+    readonly accessLevel?: string;
+    constructor(message: string, options?: {
+        key?: string;
+        operation?: string;
+        accessLevel?: string;
+        cause?: unknown;
+    });
+}
+/**
+ * Raised when the image processor is asked to transform a source that is not a
+ * supported image format; the source object is left unmodified (Requirement 14.4).
+ *
+ * Carries the offending source `format` and/or `key` so the error precisely
+ * identifies what could not be processed.
+ */
+export declare class UnsupportedImageError extends StorageError {
+    /** The detected/declared source format that is not supported, when known. */
+    readonly format?: string;
+    /** The source object key that could not be processed, when known. */
+    readonly key?: string;
+    constructor(message: string, options?: {
+        format?: string;
+        key?: string;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAQ3D;AAED;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAM9E;AAED;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,yCAAyC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAMzE;AAED;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,6DAA6D;IAC7D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;gBAGpB,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAQhE;AAED;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,gEAAgE;IAChE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;gBAG5B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CASJ;AAED;;;;;;GAMG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;IACrD,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;gBAGpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAQ/D"}