@node-in-layers/mcp-server 2.5.2 → 2.5.4

package/types.d.ts

@@ -1,7 +1,14 @@
 import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import { Config, LogLevelNames, LayerContext, XOR, CrossLayerProps, NilAnnotatedFunction } from '@node-in-layers/core';
 import express from 'express';
-import { JsonAble, JsonObj } from 'functional-models';
+import { DatastoreValueType, EqualitySymbol, JsonAble, JsonObj } from 'functional-models';
+import z from 'zod';
+export declare const crossLayerPropsSchema: z.ZodObject<{
+    logging: z.ZodOptional<z.ZodObject<{
+        ids: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    }, z.z.core.$loose>>;
+}, z.z.core.$loose>;
+export declare const jsonAbleSchema: z.ZodType<JsonAble, unknown, z.z.core.$ZodTypeInternals<JsonAble, unknown>>;
 /**
  * The namespace key used to scope all `@node-in-layers/mcp-server` configuration
  * inside the system config object.
@@ -17,6 +24,286 @@ import { JsonAble, JsonObj } from 'functional-models';
  * ```
  */
 export declare const McpNamespace = "@node-in-layers/mcp-server";
+export declare enum ModelAction {
+    Save = "save",
+    Retrieve = "retrieve",
+    Delete = "delete",
+    Search = "search",
+    BulkInsert = "bulkInsert",
+    BulkDelete = "bulkDelete"
+}
+export declare enum ModelActionToolName {
+    Save = "model_save",
+    Retrieve = "model_retrieve",
+    Delete = "model_delete",
+    Search = "model_search",
+    BulkInsert = "model_bulk_insert",
+    BulkDelete = "model_bulk_delete"
+}
+export declare const modelBulkInsertSchema: z.ZodObject<{
+    modelType: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{}, z.z.core.$loose>>;
+}, z.z.core.$strip>;
+export declare const modelRetrieveSchema: z.ZodObject<{
+    modelType: z.ZodString;
+    id: z.ZodString;
+}, z.z.core.$strip>;
+export declare const modelDeleteSchema: z.ZodObject<{
+    modelType: z.ZodString;
+    id: z.ZodString;
+}, z.z.core.$strip>;
+export declare const searchSchema: z.ZodObject<{
+    take: z.ZodOptional<z.ZodNumber>;
+    sort: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        order: z.ZodEnum<{
+            asc: "asc";
+            dsc: "dsc";
+        }>;
+    }, z.z.core.$strip>>;
+    page: z.ZodOptional<z.ZodType<JsonAble, unknown, z.z.core.$ZodTypeInternals<JsonAble, unknown>>>;
+    query: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
+        AND: "AND";
+        OR: "OR";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"property">;
+        key: z.ZodString;
+        value: z.ZodAny;
+        valueType: z.ZodEnum<typeof DatastoreValueType>;
+        equalitySymbol: z.ZodEnum<typeof EqualitySymbol>;
+        options: z.ZodOptional<z.ZodObject<{
+            caseSensitive: z.ZodOptional<z.ZodBoolean>;
+            startsWith: z.ZodOptional<z.ZodBoolean>;
+            endsWith: z.ZodOptional<z.ZodBoolean>;
+        }, z.z.core.$strip>>;
+    }, z.z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"datesAfter">;
+        key: z.ZodString;
+        date: z.ZodString;
+        valueType: z.ZodEnum<typeof DatastoreValueType>;
+        options: z.ZodOptional<z.ZodObject<{
+            equalToAndAfter: z.ZodOptional<z.ZodBoolean>;
+        }, z.z.core.$strip>>;
+    }, z.z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"datesBefore">;
+        key: z.ZodString;
+        date: z.ZodString;
+        valueType: z.ZodEnum<typeof DatastoreValueType>;
+        options: z.ZodOptional<z.ZodObject<{
+            equalToAndBefore: z.ZodOptional<z.ZodBoolean>;
+        }, z.z.core.$strip>>;
+    }, z.z.core.$strip>]>>>;
+}, z.z.core.$strip>;
+export declare const modelSearchSchema: z.ZodObject<{
+    modelType: z.ZodString;
+    search: z.ZodObject<{
+        take: z.ZodOptional<z.ZodNumber>;
+        sort: z.ZodOptional<z.ZodObject<{
+            key: z.ZodString;
+            order: z.ZodEnum<{
+                asc: "asc";
+                dsc: "dsc";
+            }>;
+        }, z.z.core.$strip>>;
+        page: z.ZodOptional<z.ZodType<JsonAble, unknown, z.z.core.$ZodTypeInternals<JsonAble, unknown>>>;
+        query: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
+            AND: "AND";
+            OR: "OR";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"property">;
+            key: z.ZodString;
+            value: z.ZodAny;
+            valueType: z.ZodEnum<typeof DatastoreValueType>;
+            equalitySymbol: z.ZodEnum<typeof EqualitySymbol>;
+            options: z.ZodOptional<z.ZodObject<{
+                caseSensitive: z.ZodOptional<z.ZodBoolean>;
+                startsWith: z.ZodOptional<z.ZodBoolean>;
+                endsWith: z.ZodOptional<z.ZodBoolean>;
+            }, z.z.core.$strip>>;
+        }, z.z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"datesAfter">;
+            key: z.ZodString;
+            date: z.ZodString;
+            valueType: z.ZodEnum<typeof DatastoreValueType>;
+            options: z.ZodOptional<z.ZodObject<{
+                equalToAndAfter: z.ZodOptional<z.ZodBoolean>;
+            }, z.z.core.$strip>>;
+        }, z.z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"datesBefore">;
+            key: z.ZodString;
+            date: z.ZodString;
+            valueType: z.ZodEnum<typeof DatastoreValueType>;
+            options: z.ZodOptional<z.ZodObject<{
+                equalToAndBefore: z.ZodOptional<z.ZodBoolean>;
+            }, z.z.core.$strip>>;
+        }, z.z.core.$strip>]>>>;
+    }, z.z.core.$strip>;
+}, z.z.core.$strip>;
+export declare const modelBulkDeleteSchema: z.ZodObject<{
+    modelType: z.ZodString;
+    ids: z.ZodArray<z.ZodString>;
+}, z.z.core.$strip>;
+export declare const modelSaveSchema: z.ZodObject<{
+    modelType: z.ZodString;
+    instance: z.ZodObject<{}, z.z.core.$loose>;
+}, z.z.core.$strip>;
+export type ModelBulkInsert = z.infer<typeof modelBulkInsertSchema>;
+export type ModelRetrieve = z.infer<typeof modelRetrieveSchema>;
+export type ModelDelete = z.infer<typeof modelDeleteSchema>;
+export type ModelSearch = z.infer<typeof modelSearchSchema>;
+export type ModelBulkDelete = z.infer<typeof modelBulkDeleteSchema>;
+export type ModelSave = z.infer<typeof modelSaveSchema>;
+type _ModelActionMap = Readonly<{
+    [ModelAction.Save]: Readonly<{
+        toolName: ModelActionToolName.Save;
+        args: ModelSave;
+    }>;
+    [ModelAction.Retrieve]: Readonly<{
+        toolName: ModelActionToolName.Retrieve;
+        args: ModelRetrieve;
+    }>;
+    [ModelAction.Delete]: Readonly<{
+        toolName: ModelActionToolName.Delete;
+        args: ModelDelete;
+    }>;
+    [ModelAction.Search]: Readonly<{
+        toolName: ModelActionToolName.Search;
+        args: ModelSearch;
+    }>;
+    [ModelAction.BulkInsert]: Readonly<{
+        toolName: ModelActionToolName.BulkInsert;
+        args: ModelBulkInsert;
+    }>;
+    [ModelAction.BulkDelete]: Readonly<{
+        toolName: ModelActionToolName.BulkDelete;
+        args: ModelBulkDelete;
+    }>;
+}>;
+export type MCPToolExecuteData<ToolName extends string, T extends JsonObj = JsonObj> = Readonly<{
+    toolName: ToolName;
+    args: T;
+}>;
+export declare const executeModelSchema: z.ZodObject<{
+    toolName: z.ZodEnum<typeof ModelActionToolName>;
+    action: z.ZodEnum<typeof ModelAction>;
+    domain: z.ZodString;
+    modelName: z.ZodString;
+    args: z.ZodXor<readonly [z.ZodObject<{
+        modelType: z.ZodString;
+        items: z.ZodArray<z.ZodObject<{}, z.z.core.$loose>>;
+    }, z.z.core.$strip>, z.ZodObject<{
+        modelType: z.ZodString;
+        id: z.ZodString;
+    }, z.z.core.$strip>, z.ZodObject<{
+        modelType: z.ZodString;
+        id: z.ZodString;
+    }, z.z.core.$strip>, z.ZodObject<{
+        modelType: z.ZodString;
+        search: z.ZodObject<{
+            take: z.ZodOptional<z.ZodNumber>;
+            sort: z.ZodOptional<z.ZodObject<{
+                key: z.ZodString;
+                order: z.ZodEnum<{
+                    asc: "asc";
+                    dsc: "dsc";
+                }>;
+            }, z.z.core.$strip>>;
+            page: z.ZodOptional<z.ZodType<JsonAble, unknown, z.z.core.$ZodTypeInternals<JsonAble, unknown>>>;
+            query: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
+                AND: "AND";
+                OR: "OR";
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"property">;
+                key: z.ZodString;
+                value: z.ZodAny;
+                valueType: z.ZodEnum<typeof DatastoreValueType>;
+                equalitySymbol: z.ZodEnum<typeof EqualitySymbol>;
+                options: z.ZodOptional<z.ZodObject<{
+                    caseSensitive: z.ZodOptional<z.ZodBoolean>;
+                    startsWith: z.ZodOptional<z.ZodBoolean>;
+                    endsWith: z.ZodOptional<z.ZodBoolean>;
+                }, z.z.core.$strip>>;
+            }, z.z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"datesAfter">;
+                key: z.ZodString;
+                date: z.ZodString;
+                valueType: z.ZodEnum<typeof DatastoreValueType>;
+                options: z.ZodOptional<z.ZodObject<{
+                    equalToAndAfter: z.ZodOptional<z.ZodBoolean>;
+                }, z.z.core.$strip>>;
+            }, z.z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"datesBefore">;
+                key: z.ZodString;
+                date: z.ZodString;
+                valueType: z.ZodEnum<typeof DatastoreValueType>;
+                options: z.ZodOptional<z.ZodObject<{
+                    equalToAndBefore: z.ZodOptional<z.ZodBoolean>;
+                }, z.z.core.$strip>>;
+            }, z.z.core.$strip>]>>>;
+        }, z.z.core.$strip>;
+    }, z.z.core.$strip>, z.ZodObject<{
+        modelType: z.ZodString;
+        ids: z.ZodArray<z.ZodString>;
+    }, z.z.core.$strip>, z.ZodObject<{
+        modelType: z.ZodString;
+        instance: z.ZodObject<{}, z.z.core.$loose>;
+    }, z.z.core.$strip>]>;
+    crossLayerProps: z.ZodOptional<z.ZodObject<{
+        logging: z.ZodOptional<z.ZodObject<{
+            ids: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodString>>>;
+        }, z.z.core.$loose>>;
+    }, z.z.core.$loose>>;
+}, z.z.core.$strip>;
+/**
+ * Extracted data when an MCP tool execution represents a Model CRUD action.
+ * @interface
+ */
+export type ExecuteModelData<A extends ModelAction = ModelAction> = A extends any ? MCPToolExecuteData<_ModelActionMap[A]['toolName'], _ModelActionMap[A]['args'] & JsonObj> & Readonly<{
+    toolName: _ModelActionMap[A]['toolName'];
+    action: A;
+    domain: string;
+    modelName: string;
+}> : never;
+/**
+ * Schema for the arguments of a Feature execution.
+ * @param argsSchema
+ * @returns
+ */
+export declare const executeFeatureSchema: (argsSchema: z.ZodObject<any>) => z.ZodObject<{
+    toolName: z.ZodLiteral<"execute_feature">;
+    domain: z.ZodOptional<z.ZodString>;
+    featureName: z.ZodString;
+    args: z.ZodObject<any, z.z.core.$strip>;
+    crossLayerProps: z.ZodOptional<z.ZodObject<{
+        logging: z.ZodOptional<z.ZodObject<{
+            ids: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodString>>>;
+        }, z.z.core.$loose>>;
+    }, z.z.core.$loose>>;
+}, z.z.core.$strip>;
+export declare const executeFunctionSchema: z.ZodObject<{
+    toolName: z.ZodString;
+    functionName: z.ZodString;
+    args: z.ZodObject<{}, z.z.core.$loose>;
+    crossLayerProps: z.ZodOptional<z.ZodObject<{
+        logging: z.ZodOptional<z.ZodObject<{
+            ids: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodString>>>;
+        }, z.z.core.$loose>>;
+    }, z.z.core.$loose>>;
+}, z.z.core.$strip>;
+/**
+ * Extracted data when an MCP tool execution represents a Feature execution.
+ * @interface
+ */
+export type ExecuteFeatureData = MCPToolExecuteData<'execute_feature'> & Readonly<{
+    domain: string;
+    featureName: string;
+}>;
+/**
+ * Extracted data when an MCP tool execution represents a Function execution.
+ */
+export type ExecuteFunctionData = MCPToolExecuteData<string, JsonObj> & Readonly<{
+    functionName: string;
+}>;
 /**
  * @interface
  * CLI (stdio) connection configuration. Use this when the MCP server is
@@ -490,6 +777,24 @@ export type RequestCrossLayerProps = Readonly<{
      */
     authInfo?: AuthInfo;
 }> & CrossLayerProps;
+/**
+ * A middleware function that can pullout information that will be put into the cross layer props
+ * and passed down stream with the request.
+ * @interface
+ */
+export type CrossLayerPropMiddleware = (
+/**
+ * The express request object.
+ */
+req: express.Request, 
+/**
+ * The express response object.
+ */
+res: express.Response, 
+/**
+ * The next function to call.
+ */
+next: express.NextFunction) => Promise<Record<string, any> | void>;
 /**
  * @interface
  * The public interface returned by `create()` in `mcp.ts` and stored in the
@@ -503,6 +808,18 @@ export type RequestCrossLayerProps = Readonly<{
  * ```
  */
 export type McpServerMcp = Readonly<{
+    /**
+     * Adds a middleware function that will be called before the MCP route, that can extract
+     * information that will be placed into the cross layer props.
+     *
+     * NOTE: If you return "logging" cross layer props, it will be merged in appropriately
+     * with the normal cross layer props. This can be useful for adding additional IDS.
+     *
+     * Having said that, NON-"logging" properties, are merged together, and can result in overriding values.
+     * @param middleware
+     * @returns
+     */
+    addCrossLayerPropMiddleware: (middleware: CrossLayerPropMiddleware) => void;
     /**
      * Starts the MCP server. For HTTP connections, binds an Express app to the
      * configured port. For CLI connections, connects the stdio transport.
@@ -628,3 +945,4 @@ export type Maybe<T> = Readonly<{
     /** Returns `true` if a value is present. */
     hasValue: () => boolean;
 }>;
+export {};

package/types.js

@@ -1,3 +1,29 @@
+import { DatastoreValueType, EqualitySymbol, } from 'functional-models';
+import z from 'zod';
+export const crossLayerPropsSchema = z
+    .object({
+    logging: z
+        .object({
+        ids: z
+            .array(z
+            .record(z.string(), z.string())
+            .describe('Each of these are individual objects, that have a key:id pair. Example: "ids": [{"myId":"123"},{"anotherId":"456"}]'))
+            .optional(),
+    })
+        .loose()
+        .optional(),
+})
+    .loose()
+    .describe('CrossLayerProps is an optional argument you can send with NIL MCP tool calls to enable end-to-end tracing across layers (features/services) and across multiple tool invocations. It carries correlation ids that the system logs at each hop so you can stitch together a full execution story.');
+export const jsonAbleSchema = z.lazy(() => z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.null(),
+    z.undefined(),
+    z.array(jsonAbleSchema),
+    z.record(z.string(), jsonAbleSchema),
+]));
 /**
  * The namespace key used to scope all `@node-in-layers/mcp-server` configuration
  * inside the system config object.
@@ -13,4 +39,130 @@
  * ```
  */
 export const McpNamespace = '@node-in-layers/mcp-server';
+export var ModelAction;
+(function (ModelAction) {
+    ModelAction["Save"] = "save";
+    ModelAction["Retrieve"] = "retrieve";
+    ModelAction["Delete"] = "delete";
+    ModelAction["Search"] = "search";
+    ModelAction["BulkInsert"] = "bulkInsert";
+    ModelAction["BulkDelete"] = "bulkDelete";
+})(ModelAction || (ModelAction = {}));
+export var ModelActionToolName;
+(function (ModelActionToolName) {
+    ModelActionToolName["Save"] = "model_save";
+    ModelActionToolName["Retrieve"] = "model_retrieve";
+    ModelActionToolName["Delete"] = "model_delete";
+    ModelActionToolName["Search"] = "model_search";
+    ModelActionToolName["BulkInsert"] = "model_bulk_insert";
+    ModelActionToolName["BulkDelete"] = "model_bulk_delete";
+})(ModelActionToolName || (ModelActionToolName = {}));
+export const modelBulkInsertSchema = z.object({
+    modelType: z.string(),
+    items: z.array(z.object().loose()),
+});
+export const modelRetrieveSchema = z.object({
+    modelType: z.string(),
+    id: z.string(),
+});
+export const modelDeleteSchema = z.object({
+    modelType: z.string(),
+    id: z.string(),
+});
+export const searchSchema = z.object({
+    take: z.number().int().optional(),
+    sort: z
+        .object({
+        key: z.string(),
+        order: z.enum(['asc', 'dsc']),
+    })
+        .optional(),
+    page: jsonAbleSchema.optional(),
+    query: z
+        .array(z.union([
+        z.enum(['AND', 'OR']),
+        z.object({
+            type: z.literal('property'),
+            key: z.string(),
+            value: z.any(),
+            valueType: z.enum(DatastoreValueType),
+            equalitySymbol: z.enum(EqualitySymbol),
+            options: z
+                .object({
+                caseSensitive: z.boolean().optional(),
+                startsWith: z.boolean().optional(),
+                endsWith: z.boolean().optional(),
+            })
+                .optional(),
+        }),
+        z.object({
+            type: z.literal('datesAfter'),
+            key: z.string(),
+            date: z.string(),
+            valueType: z.enum(DatastoreValueType),
+            options: z
+                .object({
+                equalToAndAfter: z.boolean().optional(),
+            })
+                .optional(),
+        }),
+        z.object({
+            type: z.literal('datesBefore'),
+            key: z.string(),
+            date: z.string(),
+            valueType: z.enum(DatastoreValueType),
+            options: z
+                .object({
+                equalToAndBefore: z.boolean().optional(),
+            })
+                .optional(),
+        }),
+    ]))
+        .optional(),
+});
+export const modelSearchSchema = z.object({
+    modelType: z.string(),
+    search: searchSchema,
+});
+export const modelBulkDeleteSchema = z.object({
+    modelType: z.string(),
+    ids: z.array(z.string()),
+});
+export const modelSaveSchema = z.object({
+    modelType: z.string(),
+    instance: z.object().loose(),
+});
+export const executeModelSchema = z.object({
+    toolName: z.enum(ModelActionToolName),
+    action: z.enum(ModelAction),
+    domain: z.string(),
+    modelName: z.string(),
+    args: z.xor([
+        modelBulkInsertSchema,
+        modelRetrieveSchema,
+        modelDeleteSchema,
+        modelSearchSchema,
+        modelBulkDeleteSchema,
+        modelSaveSchema,
+    ]),
+    crossLayerProps: crossLayerPropsSchema.optional(),
+});
+/**
+ * Schema for the arguments of a Feature execution.
+ * @param argsSchema
+ * @returns
+ */
+export const executeFeatureSchema = (argsSchema) => z.object({
+    toolName: z.literal('execute_feature'),
+    domain: z.string().optional(),
+    featureName: z.string(),
+    args: argsSchema,
+    crossLayerProps: crossLayerPropsSchema.optional(),
+});
+export const executeFunctionSchema = z.object({
+    toolName: z.string(),
+    functionName: z.string(),
+    args: z.object().loose(),
+    crossLayerProps: crossLayerPropsSchema.optional(),
+});
 //# sourceMappingURL=types.js.map

package/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/utils.d.ts

@@ -1,3 +1,4 @@
+import z from 'zod';
 import { Maybe } from './types.js';
 /**
  * Provides a standard way of handling objects that change state.
@@ -19,3 +20,7 @@ export declare const maybe: <T>(_instance: T | undefined) => Readonly<{
     instance: () => T | undefined;
     hasValue: () => boolean;
 }>;
+export declare const zodParse: <T extends object>(schema: z.ZodType<T, unknown, z.z.core.$ZodTypeInternals<T, unknown>>, rawInput: any) => T;
+export declare const checkAndSetDefault: <T extends object>(obj: T, key: string, defaultValue: any) => void;
+export declare const pushArray: <T>(array: T[], item: T) => void;
+export declare const setObjectProperty: <T extends object>(obj: T, key: string, value: any) => void;

package/utils.js

@@ -30,4 +30,21 @@ export const maybe = (_instance) => {
         hasValue,
     };
 };
+export const zodParse = (schema, rawInput) => {
+    return schema.parse(rawInput);
+};
+export const checkAndSetDefault = (obj, key, defaultValue) => {
+    if (!obj[key]) {
+        // eslint-disable-next-line functional/immutable-data
+        obj[key] = defaultValue;
+    }
+};
+export const pushArray = (array, item) => {
+    // eslint-disable-next-line functional/immutable-data
+    array.push(item);
+};
+export const setObjectProperty = (obj, key, value) => {
+    // eslint-disable-next-line functional/immutable-data
+    obj[key] = value;
+};
 //# sourceMappingURL=utils.js.map

package/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAGrB,EAAE;IACH,6CAA6C;IAC7C,IAAI,SAAS,GAAkB,SAAS,CAAA;IAExC,MAAM,GAAG,GAAG,CAAC,KAAQ,EAAE,EAAE;QACvB,SAAS,GAAG,KAAK,CAAA;IACnB,CAAC,CAAA;IAED,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;QAChC,GAAG;KACJ,CAAA;AACH,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAI,SAAwB,EAAY,EAAE;IAC7D,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,OAAO,SAAS,CAAA;IAClB,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,OAAO,SAAS,KAAK,SAAS,CAAA;IAChC,CAAC,CAAA;IAED,OAAO;QACL,QAAQ;QACR,QAAQ;KACT,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAGrB,EAAE;IACH,6CAA6C;IAC7C,IAAI,SAAS,GAAkB,SAAS,CAAA;IAExC,MAAM,GAAG,GAAG,CAAC,KAAQ,EAAE,EAAE;QACvB,SAAS,GAAG,KAAK,CAAA;IACnB,CAAC,CAAA;IAED,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;QAChC,GAAG;KACJ,CAAA;AACH,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAI,SAAwB,EAAY,EAAE;IAC7D,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,OAAO,SAAS,CAAA;IAClB,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,OAAO,SAAS,KAAK,SAAS,CAAA;IAChC,CAAC,CAAA;IAED,OAAO;QACL,QAAQ;QACR,QAAQ;KACT,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,MAAoB,EACpB,QAAa,EACV,EAAE;IACL,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;AAC/B,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,GAAM,EACN,GAAW,EACX,YAAiB,EACjB,EAAE;IACF,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACd,qDAAqD;QACrD,GAAG,CAAC,GAAG,CAAC,GAAG,YAAY,CAAA;IACzB,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAI,KAAU,EAAE,IAAO,EAAE,EAAE;IAClD,qDAAqD;IACrD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAClB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,GAAM,EACN,GAAW,EACX,KAAU,EACV,EAAE;IACF,qDAAqD;IACrD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAClB,CAAC,CAAA"}