@vibesdotdev/storage 0.0.2 → 1.0.0-rc.4

package/dist/adapters/cloud-api/cloud-api.adapter.impl.js

@@ -0,0 +1,448 @@
+/**
+ * Cloud API Storage Adapter Implementation
+ *
+ * HTTP persistence for cloud-synced data: each store or record runs over the
+ * fetch transport (`cloud-api.fetch-client.ts`) bound to its own origin and
+ * credentials.
+ *
+ * One instance per runtime: the storage/adapter kind constructs this class
+ * with the runtime's kind context, so two roots never share one. Within a
+ * runtime, `configure()` replaces the configuration (never merges it with an
+ * earlier manifest's), and every store and record binds the configuration it
+ * was opened with, so one manifest never keeps another's origin or token.
+ *
+ * Safe to import in any environment (browser, server, worker).
+ */
+import { CapabilityError, CaughtFailureSchema, createRuntimeImplementation, valueFreeFailure } from '@vibesdotdev/kernel';
+import { ServiceTargetSchema } from '@vibesdotdev/infra-contracts';
+import * as z from 'zod/v4';
+import { resolveStorageCallerBearer } from "../../utils/caller-bearer.js";
+import { CloudConfigFieldsSchema, CloudManifestHintsSchema } from "../../schemas/cloud-api.js";
+import { JsonObjectSchema } from '@vibesdotdev/kernel/schemas/json';
+import { createFetchClient } from "./cloud-api.fetch-client.js";
+import { CloudAPIStorageRecord } from "./cloud-api.record.js";
+import { parseAdapterInput } from "../parse-adapter-input.js";
+import { readStoredLayer, validateForPersist } from "../validate-for-persist.js";
+/** The host's first-party service token credential. */
+const INTERNAL_SERVICE_TOKEN_KEY = 'VIBES_INTERNAL_SERVICE_TOKEN';
+const ADAPTER_ID = 'storage.cloud-api';
+/** A records document's collection value: an item list, or items already keyed by id. */
+const RecordsCollectionSchema = z.record(z.string(), z.unknown());
+const RecordsDocumentFieldsSchema = z.record(z.string(), z.unknown());
+const RecordsItemsSchema = z.union([z.array(RecordsCollectionSchema), RecordsCollectionSchema]);
+/** The binding the fields describe. A relative `apiEndpoint` is a mistaken path, not an origin, and is not bound. */
+function bindingOf(fields, runtime) {
+    const binding = {};
+    if (fields.apiEndpoint?.startsWith('http'))
+        binding.apiEndpoint = fields.apiEndpoint;
+    if (fields.ownerApp)
+        binding.ownerApp = fields.ownerApp;
+    if (fields.apiToken !== undefined)
+        binding.apiToken = fields.apiToken;
+    if (fields.authPolicy !== undefined)
+        binding.authPolicy = fields.authPolicy;
+    if (fields.timeout !== undefined)
+        binding.timeout = fields.timeout;
+    if (runtime)
+        binding.runtime = runtime;
+    return binding;
+}
+/** `base` with `override`'s own fields in front: one store's configuration and its descriptor's, never another store's. */
+function withOverrides(base, override) {
+    return { ...base, ...override };
+}
+/** The origin a path for `getPath()` names: the endpoint's origin (never its userinfo, path or query), else the owner app. */
+function displayedOrigin(binding) {
+    if (binding.apiEndpoint && URL.canParse(binding.apiEndpoint))
+        return new URL(binding.apiEndpoint).origin;
+    return binding.ownerApp ?? 'unknown';
+}
+/**
+ * The runtime the storage owner handed this adapter in its config (manifests
+ * and records set `runtime`). A call without one is refused, never answered
+ * from an ambient runtime.
+ */
+function requireAdapterRuntime(binding) {
+    if (!binding.runtime) {
+        throw new CapabilityError('Cloud API adapter was configured without the runtime of the manifest or record it serves.', 'UNAVAILABLE', { reason: 'storage-runtime-required', retryable: false });
+    }
+    return binding.runtime;
+}
+function unsupportedProtocol(protocol) {
+    return new CapabilityError(`The cloud-api adapter does not support the ${protocol} protocol.`, 'UNAVAILABLE', {
+        reason: 'storage-protocol-unsupported',
+        retryable: false,
+        details: { adapterId: ADAPTER_ID, protocol }
+    });
+}
+/** A records document whose items cannot be keyed: refused before any request. */
+function recordIdInvalid(index, idField) {
+    return new CapabilityError('A records item has no string id; nothing was saved.', 'INVALID_INPUT', {
+        reason: 'cloud-api-record-id-invalid',
+        retryable: false,
+        details: { index, idField }
+    });
+}
+/**
+ * The items of a records document keyed by `idField`, read from its
+ * collection field when the manifest declares one. An item whose id is not a
+ * string refuses the save, before any request: the remote collection is
+ * reconciled against exactly what the caller saved.
+ */
+function keyedRecords(document, collectionField, idField) {
+    const refusal = {
+        message: 'A records document must hold its items as a list or as items keyed by id.',
+        code: 'INVALID_INPUT',
+        reason: 'cloud-api-records-invalid'
+    };
+    const collection = collectionField
+        ? parseAdapterInput(RecordsDocumentFieldsSchema, document, refusal)[collectionField]
+        : document;
+    const items = parseAdapterInput(RecordsItemsSchema, collection, refusal);
+    if (!Array.isArray(items))
+        return items;
+    const keyed = {};
+    for (const [index, item] of items.entries()) {
+        const id = z.string().safeParse(item[idField]);
+        if (!id.success)
+            throw recordIdInvalid(index, idField);
+        keyed[id.data] = item;
+    }
+    return keyed;
+}
+class CloudAPIStorageAdapter {
+    id = ADAPTER_ID;
+    capabilities = {
+        protocols: ['document', 'record'],
+        requiresPairSchema: false,
+        supportsTransactions: false,
+        supportsTTL: false,
+        supportsFTS: false,
+        persistent: true,
+        supportsSubscription: false,
+        supportsHierarchy: false,
+        supportsComputedFields: false,
+        supportsSideEffects: false,
+        supportsRawQueries: false
+    };
+    /** The configuration the next store or record opens with; replaced, never merged, by `configure()`. */
+    binding = {};
+    /** Per-namespace and per-record scoped bindings preventing concurrent configure() races. */
+    namespaceBindings = new Map();
+    /** A test client every store and record uses instead of the fetch transport. */
+    injected = null;
+    /** Endpoint declarations registered by manifests, for the health probe's transport. */
+    endpoints = new Map();
+    /** Constructed by the storage/adapter kind with the runtime's kind context; the binding carries each caller's runtime. */
+    constructor(_descriptor, _context) { }
+    configure(config) {
+        // IMPORTANT: `endpoint` (a per-manifest relative path like
+        // '/api/storage/ai/providers') is NOT `apiEndpoint` (the service origin);
+        // endpoint is resolved per namespace by the transport.
+        const fields = parseAdapterInput(CloudConfigFieldsSchema, config, {
+            message: 'The cloud-api adapter configuration is invalid.',
+            code: 'INVALID_INPUT',
+            reason: 'cloud-api-config-invalid'
+        });
+        const bound = bindingOf(fields, fields.runtime);
+        this.binding = bound;
+        const id = fields.namespace ?? fields.manifestId ?? fields.recordId;
+        if (id) {
+            this.namespaceBindings.set(id, bound);
+        }
+    }
+    /** Use `client` for every store and record (tests). */
+    setClient(client) {
+        this.injected = client;
+    }
+    isConfigured() {
+        return this.binding.apiEndpoint !== undefined;
+    }
+    /**
+     * The origin of one binding, in order: an explicit `apiEndpoint`; else
+     * `ownerApp`'s declared `infra/service` origin for the service environment
+     * the handed runtime selects; else refuse `service-undeclared`. There is no
+     * environment `apiUrl` or `VIBES_API_URL` fallback (rc04 §2.4).
+     */
+    async originOf(binding) {
+        if (binding.apiEndpoint)
+            return binding.apiEndpoint;
+        const ownerApp = binding.ownerApp;
+        if (!ownerApp) {
+            throw new CapabilityError('Cloud API adapter has no origin: configure an explicit apiEndpoint or the ownerApp whose infra/service declares it.', 'NOT_FOUND', { reason: 'service-undeclared', retryable: false, details: { ownerApp: null } });
+        }
+        const runtime = requireAdapterRuntime(binding);
+        // Confirmed absence of the service (no infra/service kind, or no descriptor
+        // for the owner) is `service-undeclared`; any other failure (config, tier)
+        // propagates typed from the infra owner. The kind is asked first: querying
+        // an unregistered kind refuses, which is not the owner's answer.
+        const declared = runtime.hasKind('infra/service');
+        const query = declared ? runtime.query('infra/service').withId(ownerApp) : undefined;
+        if (!query || query.descriptors().length === 0) {
+            throw new CapabilityError('No infra/service is declared for the owner app.', 'NOT_FOUND', {
+                reason: 'service-undeclared',
+                retryable: false,
+                details: { ownerApp }
+            });
+        }
+        const target = parseAdapterInput(ServiceTargetSchema, await (await query.resolve()).target('primary'), {
+            message: 'The service target answer is invalid.', code: 'INTERNAL', reason: 'service-target-invalid'
+        });
+        return target.origin;
+    }
+    /**
+     * Per request: an explicit configured token, else the host's first-party
+     * service token (the `VIBES_INTERNAL_SERVICE_TOKEN` credential), else the
+     * caller's bearer (`resolveStorageCallerBearer`), all on the handed runtime.
+     */
+    async resolveApiToken(binding) {
+        if (binding.authPolicy === 'caller') {
+            if (binding.apiToken !== undefined) {
+                throw new CapabilityError('Caller-authenticated storage cannot use a configured token.', 'INVALID_INPUT', {
+                    reason: 'storage-caller-token-conflict', retryable: false
+                });
+            }
+            const runtime = requireAdapterRuntime(binding);
+            const bearer = await resolveStorageCallerBearer(runtime);
+            if (bearer)
+                return bearer;
+            if (runtime.scope.surface === 'browser')
+                return undefined;
+            throw new CapabilityError('Caller authentication is required for this storage operation.', 'AUTH_REQUIRED', {
+                reason: 'storage-caller-bearer-unavailable', retryable: false
+            });
+        }
+        const explicit = binding.apiToken?.trim();
+        if (explicit)
+            return explicit;
+        const runtime = requireAdapterRuntime(binding);
+        const service = await runtime.resolveCredential({ source: 'secret', key: INTERNAL_SERVICE_TOKEN_KEY });
+        if (service.ok) {
+            const token = service.value.trim();
+            if (token)
+                return token;
+        }
+        else if (!(service.error.code === 'NOT_FOUND' && service.error.reason === 'credential-not-set')) {
+            throw service.error;
+        }
+        return (await resolveStorageCallerBearer(runtime)) ?? undefined;
+    }
+    /** The transport for one binding: the injected test client, else a fetch transport on the binding's origin. */
+    async transportFor(binding) {
+        if (this.injected)
+            return this.injected;
+        const apiEndpoint = await this.originOf(binding);
+        const runtime = requireAdapterRuntime(binding);
+        const selected = await runtime.query('runtime/environment').select();
+        const environment = selected?.impl;
+        const request = environment?.httpFetch;
+        if (!environment || !request)
+            throw new CapabilityError('The host has no HTTP transport for cloud storage.', 'UNAVAILABLE', {
+                reason: 'http-fetch-unavailable', retryable: false
+            });
+        return createFetchClient(runtime, { apiEndpoint, timeout: binding.timeout }, () => this.resolveApiToken(binding), (input, options) => request.call(environment, input, options));
+    }
+    /**
+     * Register a per-namespace endpoint (from a manifest's adapterConfig). A
+     * store reads its own manifest's endpoint; this registry serves the health
+     * probe.
+     */
+    registerEndpoint(namespace, endpoint) {
+        this.registerEndpointConfig(namespace, { endpoint });
+    }
+    registerEndpointConfig(namespace, config) {
+        this.endpoints.set(namespace, config);
+    }
+    documentStore(namespace, schema, manifest) {
+        const hints = parseAdapterInput(CloudManifestHintsSchema, manifest, {
+            message: 'The manifest hints handed to the cloud-api adapter are invalid.',
+            code: 'INVALID_INPUT',
+            reason: 'cloud-api-manifest-invalid'
+        });
+        const cloudFields = hints?.adapterConfig?.[ADAPTER_ID];
+        const dataType = hints?.dataType;
+        const idField = cloudFields?.idField ?? hints?.idField ?? 'id';
+        const collectionField = hints?.collectionField;
+        const manifestRuntime = hints?.runtime ?? hints?.context?.runtime;
+        const baseBinding = this.namespaceBindings.get(namespace) ?? this.binding;
+        const ownBinding = manifestRuntime ? withOverrides(baseBinding, { runtime: manifestRuntime }) : baseBinding;
+        // Bound now: a later configure() for another manifest never reaches this store.
+        const binding = cloudFields ? withOverrides(ownBinding, bindingOf(cloudFields, undefined)) : ownBinding;
+        const endpointConfig = cloudFields?.endpoint
+            ? { endpoint: cloudFields.endpoint, dataType, idField, collectionField }
+            : (this.endpoints.get(namespace) ?? null);
+        let opened = null;
+        const open = async () => {
+            const client = await this.transportFor(binding);
+            if (endpointConfig) {
+                if (client.registerEndpointConfig)
+                    client.registerEndpointConfig(namespace, endpointConfig);
+                else
+                    client.registerEndpoint?.(namespace, endpointConfig.endpoint);
+            }
+            return client;
+        };
+        const transport = async () => {
+            opened ??= open();
+            try {
+                return await opened;
+            }
+            catch (thrown) {
+                // A failed open is not kept: the next call opens again.
+                opened = null;
+                throw thrown;
+            }
+        };
+        const store = {
+            async load(options) {
+                // Transport failures surface (only a 404 is absence), so sync reports
+                // "Remote unreachable" instead of treating a down target as empty.
+                // The caller's signal aborts the request (CANCELLED cloud-api-cancelled).
+                const data = await (await transport()).get(namespace, { signal: options?.signal });
+                if (data === null)
+                    return null;
+                return schema.parse(data);
+            },
+            async loadStored(options) {
+                const data = await (await transport()).get(namespace, { signal: options?.signal });
+                if (data === null)
+                    return null;
+                return readStoredLayer(schema, data);
+            },
+            async save(data) {
+                // Persist the caller's validated input, never the parse output (defaults are read-time only).
+                const validated = validateForPersist(schema, data);
+                if (dataType === 'records') {
+                    const items = keyedRecords(validated, collectionField, idField);
+                    await (await transport()).reconcile(namespace, items);
+                    return;
+                }
+                await (await transport()).set(namespace, validated);
+            },
+            async exists() {
+                return (await transport()).exists(namespace);
+            },
+            async delete() {
+                await (await transport()).delete(namespace);
+            },
+            getPath() {
+                return `cloud://${displayedOrigin(binding)}/${namespace}`;
+            }
+        };
+        if (dataType === 'records') {
+            store.pushRecords = async (data, pushed, hash) => {
+                const items = {};
+                for (const [id, item] of Object.entries(keyedRecords(validateForPersist(schema, data), collectionField, idField))) {
+                    items[id] = JsonObjectSchema.parse(item);
+                }
+                return (await transport()).pushRecords(namespace, items, pushed, hash);
+            };
+        }
+        return store;
+    }
+    keyValueStore(_namespace, _keySchema, _valueSchema) {
+        throw unsupportedProtocol('key-value');
+    }
+    repository(_tableName, _schema, _options) {
+        throw unsupportedProtocol('repository');
+    }
+    /**
+     * A record bound to its own descriptor's configuration. Resolved through a
+     * kind context (a `StorageRecord`), it carries only the configured runtime
+     * and its descriptor's fields, exactly what that record configured, so a
+     * sibling record's configure() racing it cannot lend its origin or token.
+     */
+    record(descriptor, context) {
+        const fields = parseAdapterInput(CloudConfigFieldsSchema.optional(), descriptor.adapterConfig?.[ADAPTER_ID], {
+            message: 'The record descriptor configuration for the cloud-api adapter is invalid.',
+            code: 'INVALID_INPUT',
+            reason: 'cloud-api-config-invalid',
+            details: { recordId: descriptor.id }
+        });
+        const contextRuntime = context?.runtime;
+        const baseBinding = this.namespaceBindings.get(descriptor.id) ?? this.binding;
+        const own = contextRuntime
+            ? withOverrides(baseBinding, { runtime: contextRuntime })
+            : (context ? bindingOf({}, baseBinding.runtime) : baseBinding);
+        const binding = fields ? withOverrides(own, bindingOf(fields, undefined)) : own;
+        let opened = null;
+        const transport = async () => {
+            opened ??= this.transportFor(binding);
+            try {
+                return await opened;
+            }
+            catch (thrown) {
+                // A failed open is not kept: the next call opens again.
+                opened = null;
+                throw thrown;
+            }
+        };
+        return new CloudAPIStorageRecord(descriptor, {
+            async request(path, options) {
+                return (await transport()).request(path, options);
+            }
+        }, binding.runtime);
+    }
+    /** The current configuration resolves to an origin (an explicit endpoint or a declared owner service). */
+    async ensureReady() {
+        await this.initialize();
+    }
+    getDatabaseConnection() {
+        throw new CapabilityError('The cloud-api adapter does not provide a database connection.', 'UNAVAILABLE', {
+            reason: 'storage-database-connection-unsupported',
+            retryable: false,
+            details: { adapterId: ADAPTER_ID }
+        });
+    }
+    async initialize() {
+        if (this.injected)
+            return;
+        await this.originOf(this.binding);
+    }
+    async close() {
+        this.endpoints.clear();
+        this.namespaceBindings.clear();
+    }
+    async healthCheck() {
+        const binding = this.binding;
+        const start = Date.now();
+        try {
+            const transport = await this.transportFor(binding);
+            for (const [namespace, endpoint] of this.endpoints)
+                transport.registerEndpointConfig?.(namespace, endpoint);
+            await transport.exists('__health__');
+            return { healthy: true, latencyMs: Date.now() - start, details: { origin: displayedOrigin(binding) } };
+        }
+        catch (thrown) {
+            // The failure's value-free facts (name, code, reason), never its text.
+            return {
+                healthy: false,
+                latencyMs: Date.now() - start,
+                error: 'Health check failed',
+                details: { failure: valueFreeFailure(CaughtFailureSchema.parse(thrown)) }
+            };
+        }
+    }
+}
+/** Create an isolated adapter instance (lifecycle, concurrency and isolation tests). */
+export function createCloudAPIStorageAdapter() {
+    return new CloudAPIStorageAdapter();
+}
+export default createRuntimeImplementation({
+    id: ADAPTER_ID,
+    kind: 'storage/adapter',
+    // A class: the storage/adapter kind constructs one per runtime with its kind context.
+    implementation: CloudAPIStorageAdapter
+});
+/**
+ * Create a Cloud API adapter whose every store and record uses `mockClient`
+ * (for testing).
+ */
+export function createTestCloudAPIAdapter(mockClient) {
+    const adapter = new CloudAPIStorageAdapter();
+    adapter.configure({ apiEndpoint: 'http://test.local' });
+    adapter.setClient(mockClient);
+    return adapter;
+}
+export { createMockCloudClient } from "./cloud-api.test-utils.js";
+//# sourceMappingURL=cloud-api.adapter.impl.js.map

package/dist/adapters/cloud-api/cloud-api.adapter.impl.js.map

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

package/dist/adapters/cloud-api/cloud-api.fetch-client.d.ts

@@ -0,0 +1,66 @@
+import type { CloudApiConnection } from '../../schemas/cloud-api.ts';
+import { type CloudEndpointConfig } from '../../schemas/cloud-api.ts';
+export { CloudEndpointConfigSchema, type CloudEndpointConfig } from '../../schemas/cloud-api.ts';
+/**
+ * Cloud API fetch transport.
+ *
+ * Every request goes to the store's resolved origin (`apiEndpoint`) plus a
+ * per-namespace API path through the active runtime's `fetch`, bounded by the
+ * configured timeout combined with (never replacing) the caller's signal.
+ *
+ * Every failure is a `CapabilityError` with a fixed, value-free message; the
+ * original failure travels as `cause`. No reason phrase, response body, URL
+ * query or credential reaches a message or a detail:
+ *
+ * - the transport failed (refused, DNS, reset): UNAVAILABLE `cloud-api-unreachable`
+ * - the request's bound elapsed: TIMEOUT `cloud-api-timeout`
+ * - the caller's signal aborted: CANCELLED `cloud-api-cancelled`
+ * - a non-success status: `cloud-api-status`, coded by the status, with
+ *   `details.status`; a 404 is NOT_FOUND naming the requested resource
+ *   (`details.kind`/`details.id`), the only failure a reader may take as absence
+ * - a body that is not JSON: INTERNAL `cloud-api-body-invalid`
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type JsonValue } from '@vibesdotdev/kernel/schemas/json';
+/** The `details.kind` of a 404: `details.id` is the requested resource path (its query withheld). */
+export declare const CLOUD_API_RESOURCE_KIND = "storage/cloud-api-resource";
+/** One namespace's endpoint, as its manifest declares it. */
+/**
+ * The transport a cloud-api store or record runs over: JSON out of every read,
+ * any serializable value into every write. A `CloudSettingsClient` (an
+ * injected test client) satisfies it.
+ */
+export interface CloudApiTransport {
+    /** Read a document; the caller's `signal` aborts the request (CANCELLED `cloud-api-cancelled`). */
+    get(namespace: string, options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<JsonValue | null>;
+    set<Data>(namespace: string, data: Data): Promise<void>;
+    reconcile<Item>(namespace: string, items: Readonly<Record<string, Item>>): Promise<void>;
+    /**
+     * Mirror a records collection as a delta against what this client last pushed:
+     * a record whose hash is unchanged is not sent, a record never pushed is
+     * POSTed, a changed one PATCHed, and only a record pushed before and now
+     * absent is DELETEd. Returns the hashes of the collection now pushed.
+     */
+    pushRecords<Item>(namespace: string, items: Readonly<Record<string, Item>>, pushed: Readonly<Record<string, string>>, hash: (item: Item) => string): Promise<Record<string, string>>;
+    request(path: string, options?: RequestInit): Promise<JsonValue | null>;
+    delete(namespace: string): Promise<void>;
+    exists(namespace: string): Promise<boolean>;
+    registerEndpoint?(namespace: string, endpoint: string): void;
+    registerEndpointConfig?(namespace: string, config: CloudEndpointConfig): void;
+}
+/** What one fetch transport is bound to: a resolved origin and its request bound. */
+export type { CloudApiConnection } from '../../schemas/cloud-api.ts';
+/** The resource a path names, its query withheld (a query may carry a credential). */
+export declare function cloudApiResourceOf(path: string): string;
+/**
+ * Create the fetch transport for one resolved origin. `resolveApiToken` is
+ * asked for the bearer on every request (an explicit token, the host's service
+ * token, or the caller's login), so a refreshed login is presented at once.
+ */
+export declare function createFetchClient(runtime: Pick<RuntimeRef, 'lifecycle'>, connection: CloudApiConnection, resolveApiToken: () => Promise<string | undefined>, request: (input: string, options: RequestInit) => Promise<Response>): CloudApiTransport & {
+    registerEndpoint(namespace: string, endpoint: string): void;
+    registerEndpointConfig(namespace: string, config: CloudEndpointConfig): void;
+};
+//# sourceMappingURL=cloud-api.fetch-client.d.ts.map

package/dist/adapters/cloud-api/cloud-api.fetch-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-api.fetch-client.d.ts","sourceRoot":"","sources":["../../../src/adapters/cloud-api/cloud-api.fetch-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjG;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAkE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtH,OAAO,EAAkD,KAAK,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAIlH,qGAAqG;AACrG,eAAO,MAAM,uBAAuB,+BAA+B,CAAC;AAIpE,6DAA6D;AAE7D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IACjC,mGAAmG;IACnG,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAC/F,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzF;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,EACrC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACxC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACxE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,gBAAgB,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7D,sBAAsB,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC9E;AAED,qFAAqF;AACrF,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvD;AA0HD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EACtC,UAAU,EAAE,kBAAkB,EAC9B,eAAe,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,EAClD,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,GACjE,iBAAiB,GAAG;IAAE,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAA;CAAE,CAkOnK"}