@tinycloudlabs/sdk-services 1.0.0

package/dist/base/BaseService.d.ts

@@ -0,0 +1,151 @@
+/**
+ * BaseService - Abstract base class for all TinyCloud services.
+ *
+ * Provides common functionality:
+ * - Context management
+ * - Session lifecycle hooks
+ * - Abort signal handling
+ * - Telemetry emission
+ */
+import { IService, IServiceContext, ServiceSession, ServiceError, Result } from "../types";
+/**
+ * Abstract base class for TinyCloud services.
+ *
+ * Services extend this class to get common functionality like
+ * context management, session lifecycle, and abort handling.
+ *
+ * @example
+ * ```typescript
+ * class MyService extends BaseService implements IMyService {
+ *   static readonly serviceName = 'myservice';
+ *
+ *   constructor(config: MyServiceConfig = {}) {
+ *     super();
+ *     this._config = config;
+ *   }
+ *
+ *   async doSomething(): Promise<Result<Data>> {
+ *     if (!this.requireAuth()) {
+ *       return err(authRequiredError('myservice'));
+ *     }
+ *     // ... implementation
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class BaseService implements IService {
+    /**
+     * Service identifier used for registration.
+     * Must be overridden by subclasses.
+     */
+    static readonly serviceName: string;
+    /**
+     * Service context providing access to platform dependencies.
+     * Set during initialize().
+     */
+    protected context: IServiceContext;
+    /**
+     * Abort controller for this service's operations.
+     * Reset on sign-out.
+     */
+    protected abortController: AbortController;
+    /**
+     * Service-specific configuration.
+     */
+    protected _config: Record<string, unknown>;
+    /**
+     * Get the service configuration.
+     */
+    get config(): Record<string, unknown>;
+    /**
+     * Initialize the service with context.
+     * Called by the SDK after instantiation.
+     *
+     * @param context - The service context
+     */
+    initialize(context: IServiceContext): void;
+    /**
+     * Called when session changes (sign-in, sign-out, refresh).
+     * Override in subclasses to handle session changes.
+     *
+     * @param session - The new session, or null if signed out
+     */
+    onSessionChange(session: ServiceSession | null): void;
+    /**
+     * Called when SDK signs out.
+     * Aborts all pending operations.
+     */
+    onSignOut(): void;
+    /**
+     * Get the abort signal for this service.
+     * Combines the service-level abort with context-level abort.
+     */
+    protected get abortSignal(): AbortSignal;
+    /**
+     * Check if the service is authenticated.
+     */
+    protected get isAuthenticated(): boolean;
+    /**
+     * Get the current session.
+     * Throws if not authenticated.
+     */
+    protected get session(): ServiceSession;
+    /**
+     * Check authentication and return error result if not authenticated.
+     * Use this at the start of methods that require authentication.
+     *
+     * @returns true if authenticated, false otherwise
+     */
+    protected requireAuth(): boolean;
+    /**
+     * Emit a telemetry event.
+     *
+     * @param event - Event name
+     * @param data - Event data
+     */
+    protected emit(event: string, data: unknown): void;
+    /**
+     * Emit a service request event.
+     *
+     * @param action - The action being performed
+     * @param key - Optional key/path being accessed
+     */
+    protected emitRequest(action: string, key?: string): void;
+    /**
+     * Emit a service response event.
+     *
+     * @param action - The action that was performed
+     * @param ok - Whether the request was successful
+     * @param startTime - Start time for duration calculation
+     * @param status - Optional HTTP status code
+     */
+    protected emitResponse(action: string, ok: boolean, startTime: number, status?: number): void;
+    /**
+     * Emit a service error event.
+     *
+     * @param error - The service error
+     */
+    protected emitError(error: ServiceError): void;
+    /**
+     * Get the service name from the static property.
+     * Subclasses must define static serviceName.
+     */
+    protected getServiceName(): string;
+    /**
+     * Create a combined abort signal from multiple sources.
+     *
+     * @param signals - Additional abort signals to combine
+     * @returns A combined abort signal
+     */
+    protected combineSignals(...signals: (AbortSignal | undefined)[]): AbortSignal;
+    /**
+     * Wrap an operation with error handling and telemetry.
+     *
+     * @param action - The action name for telemetry
+     * @param key - Optional key for telemetry
+     * @param operation - The operation to execute
+     * @returns Result of the operation
+     */
+    protected withTelemetry<T>(action: string, key: string | undefined, operation: () => Promise<Result<T>>): Promise<Result<T>>;
+}
+//# sourceMappingURL=BaseService.d.ts.map

package/dist/base/BaseService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseService.d.ts","sourceRoot":"","sources":["../../src/base/BaseService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,QAAQ,EACR,eAAe,EACf,cAAc,EACd,YAAY,EAGZ,MAAM,EACP,MAAM,UAAU,CAAC;AAGlB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,8BAAsB,WAAY,YAAW,QAAQ;IACnD;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAEpC;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAG,eAAe,CAAC;IAEpC;;;OAGG;IACH,SAAS,CAAC,eAAe,EAAE,eAAe,CAAyB;IAEnE;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAEhD;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEpC;IAED;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAI1C;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI;IAIrD;;;OAGG;IACH,SAAS,IAAI,IAAI;IAKjB;;;OAGG;IACH,SAAS,KAAK,WAAW,IAAI,WAAW,CAEvC;IAED;;OAEG;IACH,SAAS,KAAK,eAAe,IAAI,OAAO,CAEvC;IAED;;;OAGG;IACH,SAAS,KAAK,OAAO,IAAI,cAAc,CAKtC;IAED;;;;;OAKG;IACH,SAAS,CAAC,WAAW,IAAI,OAAO;IAIhC;;;;;OAKG;IACH,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAIlD;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IASzD;;;;;;;OAOG;IACH,SAAS,CAAC,YAAY,CACpB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,OAAO,EACX,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI;IAUP;;;;OAIG;IACH,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAO9C;;;OAGG;IACH,SAAS,CAAC,cAAc,IAAI,MAAM;IAIlC;;;;;OAKG;IACH,SAAS,CAAC,cAAc,CAAC,GAAG,OAAO,EAAE,CAAC,WAAW,GAAG,SAAS,CAAC,EAAE,GAAG,WAAW;IAiB9E;;;;;;;OAOG;cACa,aAAa,CAAC,CAAC,EAC7B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CAsBtB"}

package/dist/base/BaseService.js

@@ -0,0 +1,221 @@
+/**
+ * BaseService - Abstract base class for all TinyCloud services.
+ *
+ * Provides common functionality:
+ * - Context management
+ * - Session lifecycle hooks
+ * - Abort signal handling
+ * - Telemetry emission
+ */
+import { TelemetryEvents, err, } from "../types";
+import { wrapError } from "../errors";
+/**
+ * Abstract base class for TinyCloud services.
+ *
+ * Services extend this class to get common functionality like
+ * context management, session lifecycle, and abort handling.
+ *
+ * @example
+ * ```typescript
+ * class MyService extends BaseService implements IMyService {
+ *   static readonly serviceName = 'myservice';
+ *
+ *   constructor(config: MyServiceConfig = {}) {
+ *     super();
+ *     this._config = config;
+ *   }
+ *
+ *   async doSomething(): Promise<Result<Data>> {
+ *     if (!this.requireAuth()) {
+ *       return err(authRequiredError('myservice'));
+ *     }
+ *     // ... implementation
+ *   }
+ * }
+ * ```
+ */
+export class BaseService {
+    constructor() {
+        /**
+         * Abort controller for this service's operations.
+         * Reset on sign-out.
+         */
+        this.abortController = new AbortController();
+        /**
+         * Service-specific configuration.
+         */
+        this._config = {};
+    }
+    /**
+     * Get the service configuration.
+     */
+    get config() {
+        return this._config;
+    }
+    /**
+     * Initialize the service with context.
+     * Called by the SDK after instantiation.
+     *
+     * @param context - The service context
+     */
+    initialize(context) {
+        this.context = context;
+    }
+    /**
+     * Called when session changes (sign-in, sign-out, refresh).
+     * Override in subclasses to handle session changes.
+     *
+     * @param session - The new session, or null if signed out
+     */
+    onSessionChange(session) {
+        // Override in subclass if needed
+    }
+    /**
+     * Called when SDK signs out.
+     * Aborts all pending operations.
+     */
+    onSignOut() {
+        this.abortController.abort();
+        this.abortController = new AbortController();
+    }
+    /**
+     * Get the abort signal for this service.
+     * Combines the service-level abort with context-level abort.
+     */
+    get abortSignal() {
+        return this.abortController.signal;
+    }
+    /**
+     * Check if the service is authenticated.
+     */
+    get isAuthenticated() {
+        return this.context?.isAuthenticated ?? false;
+    }
+    /**
+     * Get the current session.
+     * Throws if not authenticated.
+     */
+    get session() {
+        if (!this.context?.session) {
+            throw new Error("Not authenticated");
+        }
+        return this.context.session;
+    }
+    /**
+     * Check authentication and return error result if not authenticated.
+     * Use this at the start of methods that require authentication.
+     *
+     * @returns true if authenticated, false otherwise
+     */
+    requireAuth() {
+        return this.isAuthenticated;
+    }
+    /**
+     * Emit a telemetry event.
+     *
+     * @param event - Event name
+     * @param data - Event data
+     */
+    emit(event, data) {
+        this.context?.emit(event, data);
+    }
+    /**
+     * Emit a service request event.
+     *
+     * @param action - The action being performed
+     * @param key - Optional key/path being accessed
+     */
+    emitRequest(action, key) {
+        this.emit(TelemetryEvents.SERVICE_REQUEST, {
+            service: this.getServiceName(),
+            action,
+            key,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Emit a service response event.
+     *
+     * @param action - The action that was performed
+     * @param ok - Whether the request was successful
+     * @param startTime - Start time for duration calculation
+     * @param status - Optional HTTP status code
+     */
+    emitResponse(action, ok, startTime, status) {
+        this.emit(TelemetryEvents.SERVICE_RESPONSE, {
+            service: this.getServiceName(),
+            action,
+            ok,
+            duration: Date.now() - startTime,
+            status,
+        });
+    }
+    /**
+     * Emit a service error event.
+     *
+     * @param error - The service error
+     */
+    emitError(error) {
+        this.emit(TelemetryEvents.SERVICE_ERROR, {
+            service: this.getServiceName(),
+            error,
+        });
+    }
+    /**
+     * Get the service name from the static property.
+     * Subclasses must define static serviceName.
+     */
+    getServiceName() {
+        return this.constructor.serviceName;
+    }
+    /**
+     * Create a combined abort signal from multiple sources.
+     *
+     * @param signals - Additional abort signals to combine
+     * @returns A combined abort signal
+     */
+    combineSignals(...signals) {
+        const controller = new AbortController();
+        const allSignals = [this.abortSignal, ...signals.filter(Boolean)];
+        for (const signal of allSignals) {
+            if (signal.aborted) {
+                controller.abort(signal.reason);
+                return controller.signal;
+            }
+            signal.addEventListener("abort", () => controller.abort(signal.reason), {
+                once: true,
+            });
+        }
+        return controller.signal;
+    }
+    /**
+     * Wrap an operation with error handling and telemetry.
+     *
+     * @param action - The action name for telemetry
+     * @param key - Optional key for telemetry
+     * @param operation - The operation to execute
+     * @returns Result of the operation
+     */
+    async withTelemetry(action, key, operation) {
+        const startTime = Date.now();
+        this.emitRequest(action, key);
+        try {
+            const result = await operation();
+            if (result.ok) {
+                this.emitResponse(action, true, startTime);
+            }
+            else {
+                this.emitResponse(action, false, startTime);
+                this.emitError(result.error);
+            }
+            return result;
+        }
+        catch (error) {
+            const serviceError = wrapError(this.getServiceName(), error);
+            this.emitResponse(action, false, startTime);
+            this.emitError(serviceError);
+            return err(serviceError);
+        }
+    }
+}
+//# sourceMappingURL=BaseService.js.map

package/dist/base/BaseService.js.map

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

package/dist/base/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Base Service Exports
+ */
+export { BaseService } from "./BaseService";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/base/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/base/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,cAAc,SAAS,CAAC"}

package/dist/base/index.js

@@ -0,0 +1,6 @@
+/**
+ * Base Service Exports
+ */
+export { BaseService } from "./BaseService";
+export * from "./types";
+//# sourceMappingURL=index.js.map

package/dist/base/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/base/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,cAAc,SAAS,CAAC"}

package/dist/base/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Base Service Types
+ *
+ * Types specific to the base service infrastructure.
+ */
+import { IService, IServiceContext, ServiceSession } from "../types";
+/**
+ * Service constructor type for registration.
+ * Used by the SDK to instantiate services.
+ */
+export interface ServiceConstructor<TConfig = Record<string, unknown>, TService extends IService = IService> {
+    /** Service identifier used for registration */
+    readonly serviceName: string;
+    /** Create a new instance of the service */
+    new (config?: TConfig): TService;
+}
+/**
+ * Service registration entry.
+ */
+export interface ServiceRegistration {
+    /** The service class constructor */
+    constructor: ServiceConstructor;
+    /** Configuration for this service instance */
+    config?: Record<string, unknown>;
+}
+/**
+ * Options for base service operations.
+ */
+export interface BaseServiceOptions {
+    /** Override the default timeout for this operation */
+    timeout?: number;
+    /** Custom abort signal for this operation */
+    signal?: AbortSignal;
+}
+export type { IService, IServiceContext, ServiceSession };
+//# sourceMappingURL=types.d.ts.map

package/dist/base/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/base/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,QAAQ,EACR,eAAe,EACf,cAAc,EACf,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CACjC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,SAAS,QAAQ,GAAG,QAAQ;IAEpC,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2CAA2C;IAC3C,KAAK,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,WAAW,EAAE,kBAAkB,CAAC;IAChC,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAGD,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC"}

package/dist/base/types.js

@@ -0,0 +1,7 @@
+/**
+ * Base Service Types
+ *
+ * Types specific to the base service infrastructure.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/base/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/base/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/context.d.ts

@@ -0,0 +1,142 @@
+/**
+ * ServiceContext implementation for TinyCloud SDK Services
+ * @module @tinycloudlabs/sdk-services
+ */
+import { IServiceContext, IService, ServiceSession, RetryPolicy, InvokeFunction, FetchFunction } from "./types";
+/**
+ * Event handler type for telemetry events.
+ */
+type EventHandler = (data: unknown) => void;
+/**
+ * Configuration options for ServiceContext.
+ */
+export interface ServiceContextConfig {
+    /** Function to invoke WASM operations */
+    invoke: InvokeFunction;
+    /** Function to make HTTP requests (defaults to globalThis.fetch) */
+    fetch?: FetchFunction;
+    /** List of TinyCloud host URLs */
+    hosts: string[];
+    /** Initial session (optional) */
+    session?: ServiceSession | null;
+    /** Retry policy configuration */
+    retryPolicy?: Partial<RetryPolicy>;
+}
+/**
+ * ServiceContext provides platform dependencies and cross-service access to services.
+ * This is the primary interface services use to interact with the SDK runtime.
+ *
+ * @example
+ * ```typescript
+ * const context = new ServiceContext({
+ *   invoke: wasmInvoke,
+ *   hosts: ['https://node.tinycloud.xyz'],
+ *   retryPolicy: { maxAttempts: 5 },
+ * });
+ *
+ * // Register a service
+ * const kvService = new KVService({});
+ * context.registerService('kv', kvService);
+ * kvService.initialize(context);
+ *
+ * // Update session when user signs in
+ * context.setSession(userSession);
+ * ```
+ */
+export declare class ServiceContext implements IServiceContext {
+    private _session;
+    private _services;
+    private _eventHandlers;
+    private _abortController;
+    private readonly _invoke;
+    private readonly _fetch;
+    private readonly _hosts;
+    private readonly _retryPolicy;
+    constructor(config: ServiceContextConfig);
+    /**
+     * Get the current session.
+     */
+    get session(): ServiceSession | null;
+    /**
+     * Check if the context has an authenticated session.
+     */
+    get isAuthenticated(): boolean;
+    /**
+     * Update the session and notify all registered services.
+     *
+     * @param session - New session or null to clear
+     */
+    setSession(session: ServiceSession | null): void;
+    /**
+     * Get the invoke function for WASM operations.
+     */
+    get invoke(): InvokeFunction;
+    /**
+     * Get the fetch function for HTTP requests.
+     */
+    get fetch(): FetchFunction;
+    /**
+     * Get the list of TinyCloud host URLs.
+     */
+    get hosts(): string[];
+    /**
+     * Register a service with the context.
+     *
+     * @param name - Service name (e.g., 'kv')
+     * @param service - Service instance
+     */
+    registerService(name: string, service: IService): void;
+    /**
+     * Unregister a service from the context.
+     *
+     * @param name - Service name to remove
+     */
+    unregisterService(name: string): void;
+    /**
+     * Get a registered service by name.
+     *
+     * @param name - Service name
+     * @returns The service instance or undefined if not registered
+     */
+    getService<T extends IService>(name: string): T | undefined;
+    /**
+     * Emit a telemetry event.
+     *
+     * @param event - Event name
+     * @param data - Event data
+     */
+    emit(event: string, data: unknown): void;
+    /**
+     * Subscribe to telemetry events.
+     *
+     * @param event - Event name to subscribe to
+     * @param handler - Handler function
+     * @returns Unsubscribe function
+     */
+    on(event: string, handler: EventHandler): () => void;
+    /**
+     * Remove all event handlers for an event.
+     *
+     * @param event - Event name (if omitted, clears all events)
+     */
+    clearEventHandlers(event?: string): void;
+    /**
+     * Get the abort signal for cancelling operations.
+     */
+    get abortSignal(): AbortSignal;
+    /**
+     * Abort all pending operations and notify services.
+     * Creates a new AbortController for future operations.
+     */
+    abort(): void;
+    /**
+     * Sign out - abort operations and clear session.
+     */
+    signOut(): void;
+    /**
+     * Get the retry policy configuration.
+     */
+    get retryPolicy(): RetryPolicy;
+}
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,eAAe,EACf,QAAQ,EACR,cAAc,EACd,WAAW,EACX,cAAc,EACd,aAAa,EAEd,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,MAAM,EAAE,cAAc,CAAC;IACvB,oEAAoE;IACpE,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,kCAAkC;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iCAAiC;IACjC,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,cAAe,YAAW,eAAe;IACpD,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,gBAAgB,CAA0C;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;gBAE/B,MAAM,EAAE,oBAAoB;IAexC;;OAEG;IACH,IAAI,OAAO,IAAI,cAAc,GAAG,IAAI,CAEnC;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI;IAchD;;OAEG;IACH,IAAI,MAAM,IAAI,cAAc,CAE3B;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,aAAa,CAEzB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,EAAE,CAEpB;IAMD;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI;IAItD;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIrC;;;;;OAKG;IACH,UAAU,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAQ3D;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAcxC;;;;;;OAMG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAkBpD;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAYxC;;OAEG;IACH,IAAI,WAAW,IAAI,WAAW,CAE7B;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,OAAO,IAAI,IAAI;IAUf;;OAEG;IACH,IAAI,WAAW,IAAI,WAAW,CAE7B;CACF"}