@webda/core 4.0.0-beta.1 → 4.0.0-beta.3

package/lib/core/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/core/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGzC,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,aAAa,MAAM,sCAAsC,CAAC;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAGlE;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,IAAI,GAAG,IAAI,KAAK,CAAC,CAElD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,QAEjC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,KAAK,CAAC;IAChB,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,IAAI,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAMjF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,aAAa,CAKjF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,CAE9F;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,KAAK,EAChD,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,GACtC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAE3B;AAED;;;GAGG;AACH,wBAAgB,YAAY,WAQ3B"}

package/lib/core/hooks.js

@@ -0,0 +1,73 @@
+import { useInstanceStorage } from "./instancestorage.js";
+import pkg from "node-machine-id";
+import { useModel } from "../application/hooks.js";
+const { machineIdSync } = pkg;
+/**
+ * Get the current core
+ * @returns the current core
+ */
+export function useCore() {
+    return useInstanceStorage().core;
+}
+/**
+ * Set the current core
+ * @param core - the Core instance
+ */
+export function setCore(core) {
+    useInstanceStorage().core = core;
+}
+//export function useService<T = Service>(name: ServiceName): T;
+export function useService(name) {
+    return useCore().getService(name);
+}
+/**
+ * When you want to use a service that is not defined in the ServicesMap, you can use this function
+ * @param name - the name to use
+ * @returns the result
+ */
+export function useDynamicService(name) {
+    return useService(name);
+}
+/**
+ * Get the metadata for a model
+ * @param object - the target object
+ * @param name - the name to use
+ * @returns the result
+ */
+export function useModelMetadata(name) {
+    if (name["Metadata"]) {
+        return name["Metadata"];
+    }
+    return useModel(name)?.Metadata;
+}
+/**
+ * Use model store
+ * @param name - the name to use
+ * @returns the result
+ */
+export function useModelStore(name) {
+    return useCore().getModelStore(name);
+}
+/**
+ * Get the repository for a model, typed as Repository
+ * @param name - the name to use
+ * @returns the result
+ */
+export function useModelRepository(name) {
+    return useModelStore(name);
+}
+/**
+ * Get a machine id
+ * @returns the result
+ */
+export function getMachineId() {
+    try {
+        return process.env["WEBDA_MACHINE_ID"] || machineIdSync();
+        /* c8 ignore next 4 */
+    }
+    catch (err) {
+        // Useful in k8s pod
+        return process.env["HOSTNAME"];
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/lib/core/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/core/hooks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,GAAG,MAAM,iBAAiB,CAAC;AAOlC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGnD,MAAM,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC;AAE9B;;;GAGG;AACH,MAAM,UAAU,OAAO;IACrB,OAAO,kBAAkB,EAAE,CAAC,IAAS,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAU;IAChC,kBAAkB,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC;AACnC,CAAC;AA0BD,gEAAgE;AAChE,MAAM,UAAU,UAAU,CAAC,IAAiB;IAC1C,OAAO,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAY,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAc,IAAY;IACzD,OAAO,UAAU,CAAC,IAAyB,CAAM,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAiC;IAChE,IAAI,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,QAAQ,CAAC,IAAsB,CAAC,EAAE,QAAQ,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAkB,IAAuC;IACpF,OAAO,OAAO,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAuC;IAEvC,OAAO,aAAa,CAAC,IAAI,CAAyC,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,aAAa,EAAE,CAAC;QAC1D,sBAAsB;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,oBAAoB;QACpB,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;AACH,CAAC"}

package/lib/core/icore.d.ts

@@ -0,0 +1,249 @@
+import { QueryValidator } from "@webda/ql";
+import type { WebdaQLString } from "@webda/ql";
+import { AbstractService } from "../services/iservice.js";
+import type { Model, ModelClass } from "@webda/models";
+import type { Service } from "../services/service.js";
+import type { Store } from "../stores/store.js";
+import type CryptoService from "../services/cryptoservice.service.js";
+import { CustomConstructor } from "@webda/tsc-esm";
+export { AbstractService };
+/**
+ * Registry interface augmented at build time by `.webda/session-types.d.ts`
+ * (generated from `webda.config.json#session`). The qlvalidator transformer
+ * resolves `OperationDefinition.permission`'s type parameter through this
+ * interface — when no session is configured, `session` resolves to `unknown`
+ * and the plugin emits `WQL9006` on any permission usage.
+ */
+export interface WebdaSessionRegistry {
+    session: unknown;
+}
+/**
+ * REST transport parameters for use with `@Operation<RestParameters>()`
+ */
+export interface RestParameters {
+    rest?: false | {
+        method: "get" | "post" | "put" | "delete" | "patch";
+        path: string;
+        responses?: {
+            [statusCode: string]: {
+                description?: string;
+                content?: {
+                    [mediaType: string]: any;
+                };
+            };
+        };
+    };
+}
+/**
+ * gRPC transport parameters for use with `@Operation<GrpcParameters>()`
+ */
+export interface GrpcParameters {
+    grpc?: false | {
+        streaming?: "none" | "client" | "server" | "bidi";
+    };
+}
+/**
+ * GraphQL transport parameters for use with `@Operation<GraphQLParameters>()`
+ */
+export interface GraphQLParameters {
+    graphql?: false | {
+        query?: string;
+        mutation?: string;
+        subscription?: string;
+    };
+}
+/**
+ * MCP transport parameters for use with `@Operation<McpParameters>()`
+ */
+export interface McpParameters {
+    mcp?: false | {
+        /**
+         * Human-friendly tool title
+         */
+        title?: string;
+        /**
+         * Override the derived readOnlyHint
+         */
+        readOnly?: boolean;
+        /**
+         * Override the derived destructiveHint
+         */
+        destructive?: boolean;
+    };
+}
+/**
+ * Define an operation within webda app
+ */
+export interface OperationDefinition {
+    /**
+     * Id of the operation
+     */
+    id: string;
+    /**
+     * Schema name for operation input. Use "void" for no input.
+     */
+    input: string;
+    /**
+     * Schema name for operation output. Use "void" for no output.
+     */
+    output: string;
+    /**
+     * WebdaQL to execute on session to know if
+     * operation is available to user
+     */
+    permission?: WebdaQLString<WebdaSessionRegistry["session"]>;
+    /**
+     * Service implementing the operation
+     *
+     * Either service or model should be defined
+     */
+    service?: string;
+    /**
+     * Model implementing the operation
+     *
+     * Either service or model should be defined
+     */
+    model?: string;
+    /**
+     * Method implementing the operation
+     */
+    method: string;
+    /**
+     * Context to use for the operation
+     *
+     * Useful to define a specific context for the operation
+     */
+    context?: any;
+    /**
+     * Short summary of the operation
+     */
+    summary?: string;
+    /**
+     * Full description of the operation
+     */
+    description?: string;
+    /**
+     * Categorization tags for the operation
+     */
+    tags?: string[];
+    /**
+     * Mark the operation as deprecated
+     */
+    deprecated?: boolean;
+    /**
+     * Hide the operation from transport exposure
+     */
+    hidden?: boolean;
+    /**
+     * Whether this is a static (class-level) or instance method
+     * Used by callOperation to determine if model instance needs to be loaded
+     */
+    static?: boolean;
+    /**
+     * REST transport hints
+     *
+     * Set to `false` to explicitly exclude from REST transport.
+     * Provide an object to specify REST method, path, and response definitions.
+     */
+    rest?: RestParameters["rest"];
+    /**
+     * gRPC transport hints
+     *
+     * Set to `false` to explicitly exclude from gRPC transport.
+     * Provide an object to specify streaming mode.
+     */
+    grpc?: GrpcParameters["grpc"];
+    /**
+     * GraphQL transport hints
+     *
+     * Set to `false` to explicitly exclude from GraphQL transport.
+     * Provide an object to specify query, mutation, or subscription mappings.
+     */
+    graphql?: GraphQLParameters["graphql"];
+    /**
+     * MCP transport hints
+     *
+     * Set to `false` to explicitly exclude from the MCP transport.
+     * Provide an object to set the tool title or override the read-only/destructive hints.
+     */
+    mcp?: McpParameters["mcp"];
+    /**
+     * Additional transport hints for future extensibility
+     */
+    extensions?: Record<string, unknown>;
+}
+/**
+ * Record the class as a Bean
+ * @param constructor - the constructor function
+ */
+export declare function Bean(constructor: Function): void;
+/**
+ * Define an operation within webda app
+ */
+export interface OperationDefinitionInfo extends OperationDefinition {
+    /**
+     * Contains the parse permission query
+     */
+    permissionQuery?: QueryValidator;
+}
+/**
+ * Useful interface to get the instance id
+ * @deprecated
+ */
+export interface ICore {
+    /**
+     * Stop the core gracefully
+     */
+    stop(): Promise<void>;
+    /**
+     * Return if Webda is in debug mode
+     */
+    isDebug(): boolean;
+    getServices(): {
+        [key: string]: AbstractService;
+    };
+    getBinaryStore(model: ModelClass | Model | string, attribute: string): AbstractService;
+    getLocales(): string[];
+    /**
+     * Get the store assigned to this model
+     * @param model
+     * @returns
+     */
+    getModelStore<T extends Model>(item: CustomConstructor<T> | T | string): AbstractService;
+    /**
+     * Return a service
+     * @param name
+     */
+    getService<T extends Service = Service>(name: string): T;
+    getService<T extends Store = Store>(name: "Registry"): T;
+    getService<T extends CryptoService = CryptoService>(name: "CryptoService"): T;
+    getInstanceId(): string;
+    updateConfiguration(newConfig: {
+        [key: string]: any;
+    }): void;
+}
+/**
+ * No schema was found
+ */
+export type NoSchemaResult = null;
+/**
+ * Object is valid against the schema
+ */
+export type SchemaValidResult = true;
+/**
+ * Helper to define a ServiceContrustor
+ */
+export interface ServiceConstructor<T extends AbstractService> {
+    new (name: string, params: any): T;
+}
+/**
+ * Represent a Binary Store
+ */
+export interface IBinaryStore extends AbstractService {
+}
+/**
+ * Represent a Store
+ */
+export interface IStore extends AbstractService {
+}
+//# sourceMappingURL=icore.d.ts.map

package/lib/core/icore.d.ts.map

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

package/lib/core/icore.js

@@ -0,0 +1,15 @@
+import { AbstractService } from "../services/iservice.js";
+export { AbstractService };
+/**
+ * Record the class as a Bean
+ * @param constructor - the constructor function
+ */
+// @Bean to declare as a Singleton service
+export function Bean(constructor) {
+    const name = constructor.name;
+    // @ts-ignore
+    process.webdaBeans ??= {};
+    // @ts-ignore
+    process.webdaBeans[name] = constructor;
+}
+//# sourceMappingURL=icore.js.map

package/lib/core/icore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icore.js","sourceRoot":"","sources":["../../src/core/icore.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAM1D,OAAO,EAAE,eAAe,EAAE,CAAC;AAoL3B;;;GAGG;AACH,0CAA0C;AAC1C,MAAM,UAAU,IAAI,CAAC,WAAqB;IACxC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;IAC9B,aAAa;IACb,OAAO,CAAC,UAAU,KAAK,EAAE,CAAC;IAC1B,aAAa;IACb,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC;AACzC,CAAC"}

package/lib/core/instancestorage.d.ts

@@ -0,0 +1,61 @@
+import { OperationDefinitionInfo } from "./icore.js";
+import { ContextProvider } from "../contexts/icontext.js";
+import { IRouter } from "../rest/irest.js";
+import type { Application } from "../application/application.js";
+import type { Core } from "./core.js";
+export type InstanceStorage = Partial<{
+    application: Application;
+    operations: {
+        [key: string]: OperationDefinitionInfo;
+    };
+    core: Core;
+    contextProviders: ContextProvider[];
+    caches?: any;
+    router: IRouter;
+    interruptables: Set<{
+        cancel: () => Promise<void>;
+    }>;
+}>;
+/**
+ * Retrieve the current async-local InstanceStorage, throwing if called outside a storage context
+ * @returns the result
+ */
+export declare function useInstanceStorage(): InstanceStorage;
+/**
+ * Run a function within an async-local InstanceStorage context, merging with defaults
+ * @param instanceStorage - the instance storage
+ * @param fn - the function to wrap
+ * @returns the result
+ */
+export declare function runWithInstanceStorage(instanceStorage: InstanceStorage, fn: any): any;
+/**
+ * Create a hook that is present in the instance storage
+ * @param hookName - the hook name
+ * @returns the result
+ */
+export declare function createCoreHook<K extends keyof InstanceStorage>(hookName: K): [<T extends InstanceStorage[K]>() => T, (value: InstanceStorage[K]) => void];
+type ReservedInstance = keyof InstanceStorage;
+/**
+ * Create a custom hook that is not reserved
+ * @param hookName - the hook name
+ * @returns the result
+ */
+export declare function createHook<T extends string>(hookName: T & Exclude<T, ReservedInstance>): [() => T, (value: T) => void];
+/**
+ * Register a cancelable process so it can be interrupted on shutdown
+ * @param process - the process to manage
+ * @param process.cancel - the cancel callback
+ */
+export declare function registerInteruptableProcess(process: {
+    cancel: () => Promise<void>;
+}): void;
+/**
+ * Unregister a previously registered cancelable process
+ * @param process - the process to manage
+ * @param process.cancel - the cancel callback
+ */
+export declare function unregisterInteruptableProcess(process: {
+    cancel: () => Promise<void>;
+}): void;
+export {};
+//# sourceMappingURL=instancestorage.d.ts.map

package/lib/core/instancestorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instancestorage.d.ts","sourceRoot":"","sources":["../../src/core/instancestorage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAS,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC;IAEpC,WAAW,EAAE,WAAW,CAAC;IAEzB,UAAU,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,CAAA;KAAE,CAAC;IAEvD,IAAI,EAAE,IAAI,CAAC;IAEX,gBAAgB,EAAE,eAAe,EAAE,CAAC;IAEpC,MAAM,CAAC,EAAE,GAAG,CAAC;IAEb,MAAM,EAAE,OAAO,CAAC;IAEhB,cAAc,EAAE,GAAG,CAAC;QAAE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC,CAAC;CACtD,CAAC,CAAC;AAMH;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAMpD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,eAAoB,EAAE,EAAE,KAAA,OAa/E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,eAAe,EAC5D,QAAQ,EAAE,CAAC,GACV,CAAC,CAAC,CAAC,SAAS,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAO9E;AAED,KAAK,gBAAgB,GAAG,MAAM,eAAe,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EACzC,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,gBAAgB,CAAC,GACzC,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,CAO/B;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,QAEnF;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,QAErF"}

package/lib/core/instancestorage.js

@@ -0,0 +1,75 @@
+import { AsyncLocalStorage } from "async_hooks";
+// Test are transpiling and creating several instances of 'instancestorage.ts'
+process["webdaInstanceStorage"] ??= new AsyncLocalStorage();
+const storage = process["webdaInstanceStorage"];
+/**
+ * Retrieve the current async-local InstanceStorage, throwing if called outside a storage context
+ * @returns the result
+ */
+export function useInstanceStorage() {
+    const store = storage.getStore();
+    if (!store) {
+        throw new Error("Webda launched outside of a InstanceStorage context");
+    }
+    return store;
+}
+/**
+ * Run a function within an async-local InstanceStorage context, merging with defaults
+ * @param instanceStorage - the instance storage
+ * @param fn - the function to wrap
+ * @returns the result
+ */
+export function runWithInstanceStorage(instanceStorage = {}, fn) {
+    return storage.run({
+        application: undefined,
+        operations: {},
+        core: undefined,
+        contextProviders: [],
+        router: undefined,
+        interruptables: new Set(),
+        ...instanceStorage
+    }, fn);
+}
+/**
+ * Create a hook that is present in the instance storage
+ * @param hookName - the hook name
+ * @returns the result
+ */
+export function createCoreHook(hookName) {
+    return [
+        () => useInstanceStorage()[hookName],
+        (value) => {
+            useInstanceStorage()[hookName] = value;
+        }
+    ];
+}
+/**
+ * Create a custom hook that is not reserved
+ * @param hookName - the hook name
+ * @returns the result
+ */
+export function createHook(hookName) {
+    return [
+        () => useInstanceStorage()[hookName],
+        (value) => {
+            useInstanceStorage()[hookName] = value;
+        }
+    ];
+}
+/**
+ * Register a cancelable process so it can be interrupted on shutdown
+ * @param process - the process to manage
+ * @param process.cancel - the cancel callback
+ */
+export function registerInteruptableProcess(process) {
+    useInstanceStorage().interruptables.add(process);
+}
+/**
+ * Unregister a previously registered cancelable process
+ * @param process - the process to manage
+ * @param process.cancel - the cancel callback
+ */
+export function unregisterInteruptableProcess(process) {
+    useInstanceStorage().interruptables.delete(process);
+}
+//# sourceMappingURL=instancestorage.js.map

package/lib/core/instancestorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instancestorage.js","sourceRoot":"","sources":["../../src/core/instancestorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAyBhD,8EAA8E;AAC9E,OAAO,CAAC,sBAAsB,CAAC,KAAK,IAAI,iBAAiB,EAAmB,CAAC;AAC7E,MAAM,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,eAAe,GAAoB,EAAE,EAAE,EAAE;IAC9E,OAAO,OAAO,CAAC,GAAG,CAChB;QACE,WAAW,EAAE,SAAS;QACtB,UAAU,EAAE,EAAE;QACd,IAAI,EAAE,SAAS;QACf,gBAAgB,EAAE,EAAE;QACpB,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,IAAI,GAAG,EAAE;QACzB,GAAG,eAAe;KACnB,EACD,EAAE,CACH,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAW;IAEX,OAAO;QACL,GAAG,EAAE,CAAM,kBAAkB,EAAE,CAAC,QAAQ,CAAC;QACzC,CAAC,KAAyB,EAAE,EAAE;YAC5B,kBAAkB,EAAE,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC;AAID;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,QAA0C;IAE1C,OAAO;QACL,GAAG,EAAE,CAAO,kBAAkB,EAAG,CAAC,QAAQ,CAAC;QAC3C,CAAC,KAAQ,EAAE,EAAE;YACL,kBAAkB,EAAG,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;QAChD,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAAwC;IAClF,kBAAkB,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAAwC;IACpF,kBAAkB,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC"}