@dotdo/do 0.1.0

package/dist/sdk/index.js

@@ -0,0 +1,230 @@
+/**
+ * Client SDK Module
+ *
+ * SDK for consuming Digital Objects from external applications:
+ * - Type-safe DO client
+ * - Real-time subscriptions
+ * - Offline support
+ * - React/Vue/Svelte bindings
+ */
+import { RPCClientImpl } from '../rpc';
+/**
+ * Create an RPC client
+ */
+function createRPCClient(options) {
+    return new RPCClientImpl(options.url, options);
+}
+/**
+ * DO Client - main entry point for SDK consumers
+ */
+class DOClientLegacy {
+    options;
+    rpcClients = new Map();
+    cache = new Map();
+    constructor(options = {}) {
+        this.options = {
+            baseUrl: 'https://do.md',
+            auth: '',
+            headers: {},
+            offline: false,
+            cacheTTL: 60000, // 1 minute
+            ...options,
+        };
+    }
+    /**
+     * Connect to a Digital Object
+     */
+    async connect(doRef) {
+        const url = this.resolveUrl(doRef);
+        // Reuse existing RPC client if available
+        let rpcClient = this.rpcClients.get(url);
+        if (!rpcClient) {
+            rpcClient = createRPCClient({
+                url,
+                auth: this.options.auth,
+                headers: this.options.headers,
+            });
+            this.rpcClients.set(url, rpcClient);
+        }
+        return new DOConnection(doRef, rpcClient, this.options);
+    }
+    /**
+     * Disconnect from a Digital Object
+     */
+    async disconnect(doRef) {
+        const url = this.resolveUrl(doRef);
+        const rpcClient = this.rpcClients.get(url);
+        if (rpcClient) {
+            await rpcClient.close();
+            this.rpcClients.delete(url);
+        }
+    }
+    /**
+     * Disconnect from all Digital Objects
+     */
+    async disconnectAll() {
+        for (const [url, client] of this.rpcClients) {
+            await client.close();
+        }
+        this.rpcClients.clear();
+    }
+    /**
+     * Set authentication token
+     */
+    setAuth(token) {
+        this.options.auth = token;
+        // Update all existing clients would require reconnection
+    }
+    /**
+     * Clear the cache
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    resolveUrl(doRef) {
+        if (doRef.startsWith('https://')) {
+            return doRef;
+        }
+        return `${this.options.baseUrl}/${doRef}`;
+    }
+}
+/**
+ * Connection to a specific Digital Object
+ */
+export class DOConnection {
+    doRef;
+    rpcClient;
+    options;
+    subscriptions = new Map();
+    constructor(doRef, rpcClient, options) {
+        this.doRef = doRef;
+        this.rpcClient = rpcClient;
+        this.options = options;
+    }
+    /**
+     * Get the DO identity
+     */
+    async getIdentity() {
+        return this.rpcClient.call('do.identity.get');
+    }
+    /**
+     * List things of a specific type
+     */
+    async listThings(type) {
+        const result = await this.rpcClient.call('do.things.list', {
+            filter: type ? { field: 'type', op: 'eq', value: type } : undefined,
+        });
+        return result.items;
+    }
+    /**
+     * Get a thing by ID
+     */
+    async getThing(id) {
+        return this.rpcClient.call('do.things.get', id);
+    }
+    /**
+     * Create a thing
+     */
+    async createThing(data) {
+        return this.rpcClient.call('do.things.create', data);
+    }
+    /**
+     * Update a thing
+     */
+    async updateThing(id, data) {
+        return this.rpcClient.call('do.things.update', id, data);
+    }
+    /**
+     * Delete a thing
+     */
+    async deleteThing(id) {
+        await this.rpcClient.call('do.things.delete', id);
+    }
+    /**
+     * Execute an action
+     */
+    async executeAction(verb, input) {
+        // Cast to unknown first to bypass strict type checking since Action uses $id not id
+        const actionData = {
+            verb,
+            input,
+            status: 'pending',
+            actor: { type: 'User', id: 'anonymous' },
+            createdAt: Date.now(),
+        };
+        return this.rpcClient.call('do.actions.create', actionData);
+    }
+    /**
+     * Subscribe to CDC events
+     */
+    subscribe(handler, options) {
+        const channel = `cdc:${this.doRef}`;
+        const unsubscribe = this.rpcClient.subscribe(channel, (event) => {
+            const cdcEvent = event;
+            // Apply filters
+            if (options?.eventTypes && !options.eventTypes.includes(cdcEvent.operation)) {
+                return;
+            }
+            if (options?.collections &&
+                !options.collections.includes(cdcEvent.collection)) {
+                return;
+            }
+            handler(cdcEvent);
+        });
+        const subscriptionId = `${channel}:${Date.now()}`;
+        this.subscriptions.set(subscriptionId, unsubscribe);
+        return () => {
+            unsubscribe();
+            this.subscriptions.delete(subscriptionId);
+        };
+    }
+    /**
+     * Unsubscribe from all events
+     */
+    unsubscribeAll() {
+        for (const unsubscribe of this.subscriptions.values()) {
+            unsubscribe();
+        }
+        this.subscriptions.clear();
+    }
+    /**
+     * Get the underlying RPC client
+     */
+    get rpc() {
+        return this.rpcClient;
+    }
+}
+/**
+ * Create a DO client (legacy)
+ */
+export function createDOClient(options) {
+    return new DOClientLegacy(options);
+}
+// Export legacy client as named export
+export { DOClientLegacy };
+// =============================================================================
+// New SDK Client Exports
+// =============================================================================
+// Re-export from new typed client
+export { createClient, createClients, DOError, TimeoutError, TransportError, } from './client';
+// Re-export transport layer
+export { WebSocketTransport, HTTPTransport, AutoTransport, createTransport, } from './transport';
+// =============================================================================
+// RPC.do Integration
+// =============================================================================
+// Re-export from rpc.do integration
+export { 
+// Client factories
+createDOApiClient, connectDO, createDOClientFromBinding, doClient, 
+// Environment configuration
+setEnv, getEnv, getEnvVar, isEnvConfigured, getDefaultApiKey, getDefaultApiKeySync, 
+// rpc.do re-exports
+RPC, http, ws, capnweb, composite, binding, 
+// Error class
+RPCError, } from './rpc';
+// =============================================================================
+// Authentication (oauth.do)
+// =============================================================================
+// Re-export auth module
+export { ensureDOAuth, getDOToken, isDOAuthenticated, forceReauthDO, logoutDO, configureDOAuth, startDODeviceFlow, completeDODeviceFlow, createSecureStorage, } from './auth';
+//# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

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

package/dist/sdk/rpc.d.ts

@@ -0,0 +1,275 @@
+/**
+ * DO RPC Client - Wraps rpc.do for Digital Object operations
+ *
+ * Provides a type-safe client for interacting with Digital Objects via RPC.
+ * Uses rpc.do as the underlying transport with DO-specific API definitions.
+ *
+ * @example
+ * ```typescript
+ * import { createDOApiClient } from '@do/sdk/rpc'
+ *
+ * const client = createDOApiClient({ baseURL: 'https://my-do.workers.dev' })
+ * const things = await client.things.list()
+ *
+ * // With authentication
+ * const authClient = createDOApiClient({
+ *   baseURL: 'https://my-do.workers.dev',
+ *   token: 'my-api-token'
+ * })
+ * ```
+ *
+ * @module @do/sdk/rpc
+ */
+import { RPC, http, ws, capnweb, composite, binding, type Transport, type RPCProxy, type AuthProvider } from 'rpc.do';
+import type { Noun, Verb, Thing, ThingExpanded, ThingCompact, Relationship, Function, Workflow, User, Org, Agent, Role, ListOptions, ListResult, FilterExpression } from '../types/collections';
+export { RPC, http, ws, capnweb, composite, binding };
+export type { Transport, RPCProxy, AuthProvider };
+type EnvRecord = Record<string, string | undefined>;
+/**
+ * Set the global environment for all DO SDKs
+ * Call this once at your app's entry point
+ *
+ * @example
+ * ```typescript
+ * // Workers
+ * import { env } from 'cloudflare:workers'
+ * import { setEnv } from '@do/sdk/rpc'
+ * setEnv(env)
+ *
+ * // Node.js
+ * import { setEnv } from '@do/sdk/rpc'
+ * setEnv(process.env)
+ * ```
+ */
+export declare function setEnv(env: EnvRecord): void;
+/**
+ * Get the global environment
+ * Returns null if not set
+ */
+export declare function getEnv(): EnvRecord | null;
+/**
+ * Get a specific environment variable
+ */
+export declare function getEnvVar(key: string): string | undefined;
+/**
+ * Check if environment is configured
+ */
+export declare function isEnvConfigured(): boolean;
+/**
+ * Get default API key from environment (async version)
+ * Checks: DO_API_KEY, DO_TOKEN, ORG_AI_API_KEY, ORG_AI_TOKEN
+ */
+export declare function getDefaultApiKey(envOverride?: EnvRecord): Promise<string | undefined>;
+/**
+ * Get default API key from environment (sync version)
+ */
+export declare function getDefaultApiKeySync(envOverride?: EnvRecord): string | undefined;
+/**
+ * Standard CRUD operations for a collection
+ */
+export interface CollectionAPI<T, TCreate = Omit<T, 'id'>, TUpdate = Partial<T>> {
+    /** List items with optional filtering and pagination */
+    list(options?: ListOptions): ListResult<T>;
+    /** Get a single item by ID */
+    get(id: string): T | null;
+    /** Create a new item */
+    create(data: TCreate): T;
+    /** Update an existing item */
+    update(id: string, data: TUpdate): T;
+    /** Delete an item by ID */
+    delete(id: string): void;
+}
+/**
+ * Extended collection API with additional query methods
+ */
+export interface ExtendedCollectionAPI<T, TCreate = Omit<T, 'id'>, TUpdate = Partial<T>> extends CollectionAPI<T, TCreate, TUpdate> {
+    /** Count items matching a filter */
+    count(filter?: FilterExpression): number;
+    /** Find items matching a filter */
+    find(filter: FilterExpression): T[];
+}
+/**
+ * Relationship-specific API with graph traversal
+ */
+export interface RelationshipAPI extends ExtendedCollectionAPI<Relationship> {
+    /** Traverse relationships from a source node */
+    traverse(options: TraverseOptions): TraverseResult;
+}
+/**
+ * Options for graph traversal
+ */
+export interface TraverseOptions {
+    /** Starting node ID */
+    from: string;
+    /** Relationship type to follow */
+    type?: string;
+    /** Direction of traversal */
+    direction?: 'outgoing' | 'incoming' | 'both';
+    /** Maximum depth to traverse */
+    depth?: number;
+    /** Filter for target nodes */
+    filter?: FilterExpression;
+    /** Maximum results */
+    limit?: number;
+}
+/**
+ * Result of a graph traversal
+ */
+export interface TraverseResult {
+    /** Nodes found during traversal */
+    nodes: Array<{
+        id: string;
+        depth: number;
+        data?: unknown;
+    }>;
+    /** Edges traversed */
+    edges: Relationship[];
+    /** Total nodes visited */
+    visited: number;
+}
+/**
+ * Complete DO API interface with all collections
+ */
+export interface DOApi {
+    /** Noun definitions (entity types) */
+    nouns: ExtendedCollectionAPI<Noun>;
+    /** Verb definitions (action types) */
+    verbs: ExtendedCollectionAPI<Verb>;
+    /** Thing instances (entities) */
+    things: ExtendedCollectionAPI<Thing, Omit<ThingExpanded, '$id'> | Omit<ThingCompact, 'id'>, Partial<ThingExpanded> | Partial<ThingCompact>>;
+    /** Relationship instances (edges between things) */
+    relationships: RelationshipAPI;
+    /** Function definitions */
+    functions: ExtendedCollectionAPI<Function>;
+    /** Workflow definitions */
+    workflows: ExtendedCollectionAPI<Workflow>;
+    /** User accounts */
+    users: ExtendedCollectionAPI<User>;
+    /** Organizations */
+    orgs: ExtendedCollectionAPI<Org>;
+    /** AI Agents */
+    agents: ExtendedCollectionAPI<Agent>;
+    /** Roles (permissions) */
+    roles: ExtendedCollectionAPI<Role>;
+}
+/**
+ * Configuration options for the DO client
+ */
+export interface DOClientConfig {
+    /** Base URL for the DO API (default: https://do.md) */
+    baseURL?: string;
+    /** DO instance identifier (name or ID) */
+    doId?: string;
+    /** API token for authentication */
+    token?: string;
+    /** Auth provider function for dynamic token retrieval */
+    authProvider?: AuthProvider;
+    /** Transport type: 'http' | 'ws' | 'capnweb' | 'auto' (default: 'http') */
+    transport?: 'http' | 'ws' | 'capnweb' | 'auto';
+    /** Environment variables to use for config resolution */
+    env?: EnvRecord;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * DO client with all API methods
+ */
+export type DOApiClient = RPCProxy<DOApi>;
+/**
+ * Create a typed DO RPC client.
+ *
+ * The client provides type-safe access to all DO collections via RPC.
+ * It automatically handles authentication and transport selection.
+ *
+ * @param options - Client configuration
+ * @returns Typed DO API client
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const client = createDOApiClient({ baseURL: 'https://my-do.workers.dev' })
+ *
+ * // List all things
+ * const { items } = await client.things.list({ limit: 10 })
+ *
+ * // Create a new thing
+ * const thing = await client.things.create({
+ *   $type: 'Customer',
+ *   name: 'Acme Corp',
+ *   email: 'contact@acme.com'
+ * })
+ *
+ * // Traverse relationships
+ * const result = await client.relationships.traverse({
+ *   from: 'customer-123',
+ *   type: 'purchased',
+ *   depth: 2
+ * })
+ *
+ * // Close when done
+ * await client.close?.()
+ * ```
+ */
+export declare function createDOApiClient(options?: DOClientConfig): DOApiClient;
+/**
+ * Create a client for a specific DO instance
+ *
+ * @param doId - DO instance identifier
+ * @param options - Additional client options
+ * @returns Typed DO API client
+ */
+export declare function connectDO(doId: string, options?: Omit<DOClientConfig, 'doId'>): DOApiClient;
+/**
+ * Default DO client instance.
+ *
+ * Uses environment variables for configuration:
+ * - DO_API_KEY or DO_TOKEN for authentication
+ * - DO_BASE_URL for base URL (default: https://do.md)
+ *
+ * @example
+ * ```typescript
+ * import { doClient } from '@do/sdk/rpc'
+ *
+ * const things = await doClient.things.list()
+ * ```
+ */
+export declare const doClient: DOApiClient;
+/**
+ * Create a client from a Cloudflare Workers service binding
+ *
+ * @param serviceBinding - The service binding from env
+ * @returns Typed DO API client
+ *
+ * @example
+ * ```typescript
+ * export default {
+ *   async fetch(request, env) {
+ *     const client = createDOClientFromBinding(env.DO_SERVICE)
+ *     const things = await client.things.list()
+ *     return Response.json(things)
+ *   }
+ * }
+ * ```
+ */
+export declare function createDOClientFromBinding(serviceBinding: unknown): DOApiClient;
+/**
+ * Extract the item type from a collection API
+ */
+export type CollectionItem<T> = T extends CollectionAPI<infer U> ? U : never;
+/**
+ * Extract all collection names from the DO API
+ */
+export type CollectionName = keyof DOApi;
+/**
+ * Get the item type for a specific collection
+ */
+export type CollectionItemType<K extends CollectionName> = CollectionItem<DOApi[K]>;
+/**
+ * Error class for RPC failures
+ */
+export declare class RPCError extends Error {
+    code: number;
+    data?: unknown | undefined;
+    constructor(code: number, message: string, data?: unknown | undefined);
+}
+//# sourceMappingURL=rpc.d.ts.map

package/dist/sdk/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../sdk/rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrH,OAAO,KAAK,EACV,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,aAAa,EACb,YAAY,EAEZ,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,GAAG,EACH,KAAK,EACL,IAAI,EACJ,WAAW,EACX,UAAU,EACV,gBAAgB,EACjB,MAAM,sBAAsB,CAAA;AAM7B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAA;AACrD,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAA;AAMjD,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;AAMnD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAE3C;AAED;;;GAGG;AACH,wBAAgB,MAAM,IAAI,SAAS,GAAG,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAgBD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW3F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAWhF;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAC7E,wDAAwD;IACxD,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;IAC1C,8BAA8B;IAC9B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAAA;IACzB,wBAAwB;IACxB,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAA;IACxB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAAA;IACpC,2BAA2B;IAC3B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAE,SAAQ,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC;IACjI,oCAAoC;IACpC,KAAK,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAA;IACxC,mCAAmC;IACnC,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,CAAC,EAAE,CAAA;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,qBAAqB,CAAC,YAAY,CAAC;IAC1E,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAAA;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6BAA6B;IAC7B,SAAS,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAA;IAC5C,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAC3D,sBAAsB;IACtB,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IAKpB,sCAAsC;IACtC,KAAK,EAAE,qBAAqB,CAAC,IAAI,CAAC,CAAA;IAElC,sCAAsC;IACtC,KAAK,EAAE,qBAAqB,CAAC,IAAI,CAAC,CAAA;IAElC,iCAAiC;IACjC,MAAM,EAAE,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAA;IAE3I,oDAAoD;IACpD,aAAa,EAAE,eAAe,CAAA;IAM9B,2BAA2B;IAC3B,SAAS,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAA;IAE1C,2BAA2B;IAC3B,SAAS,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAA;IAM1C,oBAAoB;IACpB,KAAK,EAAE,qBAAqB,CAAC,IAAI,CAAC,CAAA;IAElC,oBAAoB;IACpB,IAAI,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAA;IAEhC,gBAAgB;IAChB,MAAM,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAA;IAEpC,0BAA0B;IAC1B,KAAK,EAAE,qBAAqB,CAAC,IAAI,CAAC,CAAA;CACnC;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yDAAyD;IACzD,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAA;IAC9C,yDAAyD;IACzD,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;AAMzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,cAAmB,GAAG,WAAW,CAiC3E;AAMD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAM,GAAG,WAAW,CAE/F;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,EAAE,WAAiC,CAAA;AAMxD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,OAAO,GAAG,WAAW,CAE9E;AAMD;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAE5E;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,KAAK,CAAA;AAExC;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,cAAc,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AAMnF;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAExB,IAAI,EAAE,MAAM;IAEZ,IAAI,CAAC,EAAE,OAAO;gBAFd,IAAI,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACR,IAAI,CAAC,EAAE,OAAO,YAAA;CAKxB"}