@lit-protocol/vincent-ability-sdk 0.0.1-ea

package/dist/src/lib/policyCore/helpers/zod.js

@@ -0,0 +1,82 @@
+"use strict";
+// src/lib/policyCore/helpers/zod.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PolicyResponseShape = void 0;
+exports.validateOrDeny = validateOrDeny;
+exports.getValidatedParamsOrDeny = getValidatedParamsOrDeny;
+exports.getSchemaForPolicyResponseResult = getSchemaForPolicyResponseResult;
+const zod_1 = require("zod");
+const utils_1 = require("../../utils");
+const resultCreators_1 = require("./resultCreators");
+const typeGuards_1 = require("./typeGuards");
+/**
+ * Matches the minimum structure of a PolicyResponse.
+ * This is useful when validating that a response shape is at least plausible.
+ */
+exports.PolicyResponseShape = zod_1.z.object({
+    allow: zod_1.z.boolean(),
+    result: zod_1.z.unknown(),
+});
+/**
+ * Validates a value using a Zod schema (or requires undefined if none given).
+ * Returns parsed result or a standardized deny object.
+ *
+ * @param value - The raw value to validate
+ * @param schema - A Zod schema to apply, or undefined (meaning: must be undefined)
+ * @param phase - One of 'evaluate' | 'precheck' | 'commit'
+ * @param stage - 'parameters' (before calling the lifecycle phase) or 'result' (after receiving the result)
+ *
+ * @returns The parsed result, or a PolicyResponseDeny with a ZodValidationDenyResult
+ */
+function validateOrDeny(value, schema, phase, stage) {
+    const parsed = schema.safeParse(value);
+    if (!parsed.success) {
+        const descriptor = stage === 'input' ? 'parameters' : 'result';
+        const message = `Invalid ${phase} ${descriptor}.`;
+        return (0, resultCreators_1.createDenyResult)({
+            runtimeError: message,
+            schemaValidationError: {
+                zodError: parsed.error,
+                phase,
+                stage,
+            },
+        });
+    }
+    return parsed.data;
+}
+function getValidatedParamsOrDeny({ rawAbilityParams, rawUserParams, abilityParamsSchema, userParamsSchema, phase, }) {
+    const abilityParams = validateOrDeny(rawAbilityParams, abilityParamsSchema, phase, 'input');
+    if ((0, typeGuards_1.isPolicyDenyResponse)(abilityParams)) {
+        return abilityParams;
+    }
+    const userParams = validateOrDeny(rawUserParams, userParamsSchema, phase, 'input');
+    if ((0, typeGuards_1.isPolicyDenyResponse)(userParams)) {
+        return userParams;
+    }
+    return {
+        abilityParams,
+        userParams,
+    };
+}
+/**
+ * Given an unknown policy response result and the known allow/deny schemas,
+ * this function returns the appropriate Zod schema to use when validating `.result`.
+ *
+ * - If the response shape is invalid, returns a Zod schema matching the PolicyResponse structure.
+ * - If the shape is valid, returns either the allow or deny result schema.
+ */
+function getSchemaForPolicyResponseResult({ value, allowResultSchema, denyResultSchema, }) {
+    if (!(0, typeGuards_1.isPolicyResponse)(value)) {
+        console.log('getSchemaForPolicyResponseResult !isPolicyResponse', JSON.stringify(value, utils_1.bigintReplacer));
+        return {
+            schemaToUse: exports.PolicyResponseShape,
+            parsedType: 'unknown',
+        };
+    }
+    console.log('getSchemaForPolicyResponseResult value is', JSON.stringify(value, utils_1.bigintReplacer));
+    return {
+        schemaToUse: value.allow ? allowResultSchema : denyResultSchema,
+        parsedType: value.allow ? 'allow' : 'deny',
+    };
+}
+//# sourceMappingURL=zod.js.map

package/dist/src/lib/policyCore/helpers/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../../../../../src/lib/policyCore/helpers/zod.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;AAiCpC,wCAsBC;AAED,4DAmCC;AASD,4EA6BC;AA7HD,6BAAwB;AAIxB,uCAA6C;AAC7C,qDAAoD;AACpD,6CAAsE;AAEtE;;;GAGG;AACU,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,OAAC,CAAC,OAAO,EAAE;IAClB,MAAM,EAAE,OAAC,CAAC,OAAO,EAAE;CACpB,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,SAAgB,cAAc,CAC5B,KAAc,EACd,MAAS,EACT,KAAyC,EACzC,KAAyB;IAEzB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAEvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,UAAU,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC/D,MAAM,OAAO,GAAG,WAAW,KAAK,IAAI,UAAU,GAAG,CAAC;QAClD,OAAO,IAAA,iCAAgB,EAAC;YACtB,YAAY,EAAE,OAAO;YACrB,qBAAqB,EAAE;gBACrB,QAAQ,EAAE,MAAM,CAAC,KAAK;gBACtB,KAAK;gBACL,KAAK;aACN;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,SAAgB,wBAAwB,CAGtC,EACA,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,GAON;IAMC,MAAM,aAAa,GAAG,cAAc,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5F,IAAI,IAAA,iCAAoB,EAAC,aAAa,CAAC,EAAE,CAAC;QACxC,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,UAAU,GAAG,cAAc,CAAC,aAAa,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACnF,IAAI,IAAA,iCAAoB,EAAC,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO;QACL,aAAa;QACb,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,gCAAgC,CAAC,EAC/C,KAAK,EACL,iBAAiB,EACjB,gBAAgB,GAKjB;IAIC,IAAI,CAAC,IAAA,6BAAgB,EAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CACT,oDAAoD,EACpD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,sBAAc,CAAC,CACtC,CAAC;QAEF,OAAO;YACL,WAAW,EAAE,2BAAmB;YAChC,UAAU,EAAE,SAAS;SACtB,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,2CAA2C,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,sBAAc,CAAC,CAAC,CAAC;IAChG,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,gBAAgB;QAC/D,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;KAC3C,CAAC;AACJ,CAAC"}

package/dist/src/lib/policyCore/index.d.ts

@@ -0,0 +1,3 @@
+export { createVincentAbilityPolicy, createVincentPolicy } from './vincentPolicy';
+export type { VincentPolicyConfig, PolicyConfigLifecycleFunction, PolicyConfigCommitFunction, } from './policyConfig/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/lib/policyCore/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/policyCore/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAClF,YAAY,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC"}

package/dist/src/lib/policyCore/index.js

@@ -0,0 +1,8 @@
+"use strict";
+// src/lib/policyCore/index.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createVincentPolicy = exports.createVincentAbilityPolicy = void 0;
+var vincentPolicy_1 = require("./vincentPolicy");
+Object.defineProperty(exports, "createVincentAbilityPolicy", { enumerable: true, get: function () { return vincentPolicy_1.createVincentAbilityPolicy; } });
+Object.defineProperty(exports, "createVincentPolicy", { enumerable: true, get: function () { return vincentPolicy_1.createVincentPolicy; } });
+//# sourceMappingURL=index.js.map

package/dist/src/lib/policyCore/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/policyCore/index.ts"],"names":[],"mappings":";AAAA,8BAA8B;;;AAE9B,iDAAkF;AAAzE,2HAAA,0BAA0B,OAAA;AAAE,oHAAA,mBAAmB,OAAA"}

package/dist/src/lib/policyCore/policyConfig/context/policyConfigContext.d.ts

@@ -0,0 +1,12 @@
+import type { BaseContext } from '../../../types';
+import type { PolicyContext } from './types';
+/**
+ * Creates a policy execution context to be passed into lifecycle methods
+ * like `evaluate`, `precheck`, and `commit`. This context includes strongly
+ * typed `allow()` and `deny()` helpers based on optional Zod schemas, and is used
+ * internally by VincentPolicyConfig wrappers to standardize response structure.
+ */
+export declare function createPolicyContext({ baseContext, }: {
+    baseContext: BaseContext;
+}): PolicyContext<any, any>;
+//# sourceMappingURL=policyConfigContext.d.ts.map

package/dist/src/lib/policyCore/policyConfig/context/policyConfigContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policyConfigContext.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/policyCore/policyConfig/context/policyConfigContext.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,WAAW,GACZ,EAAE;IACD,WAAW,EAAE,WAAW,CAAC;CAC1B,GAAG,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAO1B"}

package/dist/src/lib/policyCore/policyConfig/context/policyConfigContext.js

@@ -0,0 +1,20 @@
+"use strict";
+// src/lib/policyConfig/context/policyConfigContext.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPolicyContext = createPolicyContext;
+const resultCreators_1 = require("./resultCreators");
+/**
+ * Creates a policy execution context to be passed into lifecycle methods
+ * like `evaluate`, `precheck`, and `commit`. This context includes strongly
+ * typed `allow()` and `deny()` helpers based on optional Zod schemas, and is used
+ * internally by VincentPolicyConfig wrappers to standardize response structure.
+ */
+function createPolicyContext({ baseContext, }) {
+    // Select the appropriate function implementation based on schema presence
+    return {
+        ...baseContext,
+        allow: resultCreators_1.createAllow,
+        deny: resultCreators_1.createDeny,
+    };
+}
+//# sourceMappingURL=policyConfigContext.js.map

package/dist/src/lib/policyCore/policyConfig/context/policyConfigContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policyConfigContext.js","sourceRoot":"","sources":["../../../../../../src/lib/policyCore/policyConfig/context/policyConfigContext.ts"],"names":[],"mappings":";AAAA,sDAAsD;;AAatD,kDAWC;AAnBD,qDAA2D;AAE3D;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,EAClC,WAAW,GAGZ;IACC,0EAA0E;IAC1E,OAAO;QACL,GAAG,WAAW;QACd,KAAK,EAAE,4BAA+C;QACtD,IAAI,EAAE,2BAA6C;KACpD,CAAC;AACJ,CAAC"}

package/dist/src/lib/policyCore/policyConfig/context/resultCreators.d.ts

@@ -0,0 +1,6 @@
+import type { ContextAllowResponse, ContextAllowResponseNoResult, ContextDenyResponse, ContextDenyResponseNoResult } from './types';
+export declare function createAllow<T>(result: T): ContextAllowResponse<T>;
+export declare function createAllowNoResult(): ContextAllowResponseNoResult;
+export declare function createDeny<T>(result: T): ContextDenyResponse<T>;
+export declare function createDenyNoResult(): ContextDenyResponseNoResult;
+//# sourceMappingURL=resultCreators.d.ts.map

package/dist/src/lib/policyCore/policyConfig/context/resultCreators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resultCreators.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/policyCore/policyConfig/context/resultCreators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,4BAA4B,EAC5B,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAEjB,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAKjE;AAED,wBAAgB,mBAAmB,IAAI,4BAA4B,CAIlE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAK/D;AAED,wBAAgB,kBAAkB,IAAI,2BAA2B,CAKhE"}

package/dist/src/lib/policyCore/policyConfig/context/resultCreators.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAllow = createAllow;
+exports.createAllowNoResult = createAllowNoResult;
+exports.createDeny = createDeny;
+exports.createDenyNoResult = createDenyNoResult;
+function createAllow(result) {
+    return {
+        allow: true,
+        result,
+    };
+}
+function createAllowNoResult() {
+    return {
+        allow: true,
+    };
+}
+function createDeny(result) {
+    return {
+        allow: false,
+        result,
+    };
+}
+function createDenyNoResult() {
+    return {
+        allow: false,
+        result: undefined,
+    };
+}
+//# sourceMappingURL=resultCreators.js.map

package/dist/src/lib/policyCore/policyConfig/context/resultCreators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resultCreators.js","sourceRoot":"","sources":["../../../../../../src/lib/policyCore/policyConfig/context/resultCreators.ts"],"names":[],"mappings":";;AAOA,kCAKC;AAED,kDAIC;AAED,gCAKC;AAED,gDAKC;AAzBD,SAAgB,WAAW,CAAI,MAAS;IACtC,OAAO;QACL,KAAK,EAAE,IAAI;QACX,MAAM;KACoB,CAAC;AAC/B,CAAC;AAED,SAAgB,mBAAmB;IACjC,OAAO;QACL,KAAK,EAAE,IAAI;KACoB,CAAC;AACpC,CAAC;AAED,SAAgB,UAAU,CAAI,MAAS;IACrC,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,MAAM;KACmB,CAAC;AAC9B,CAAC;AAED,SAAgB,kBAAkB;IAChC,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,SAAkB;KACI,CAAC;AACnC,CAAC"}

package/dist/src/lib/policyCore/policyConfig/context/types.d.ts

@@ -0,0 +1,24 @@
+import type { z } from 'zod';
+import type { PolicyResponseAllow, PolicyResponseAllowNoResult, PolicyResponseDeny, PolicyResponseDenyNoResult, BaseContext } from '../../../types';
+declare const YouMustCallContextAllowOrDeny: unique symbol;
+type MustCallContextAllowOrDeny<T> = T & {
+    [YouMustCallContextAllowOrDeny]: 'PolicyResponse';
+};
+export type EnforcePolicyResponse<T> = typeof YouMustCallContextAllowOrDeny extends keyof T ? T : {
+    ERROR: 'You must return the result of context.allow() or context.deny()';
+    FIX: 'Do not construct the return value manually. Use the injected context helpers.';
+};
+export type ContextAllowResponse<AllowResult> = MustCallContextAllowOrDeny<PolicyResponseAllow<AllowResult>>;
+export type ContextAllowResponseNoResult = MustCallContextAllowOrDeny<PolicyResponseAllowNoResult>;
+export type ContextDenyResponse<DenyResult> = MustCallContextAllowOrDeny<PolicyResponseDeny<DenyResult>>;
+export type ContextDenyResponseNoResult = MustCallContextAllowOrDeny<PolicyResponseDenyNoResult>;
+/**
+ * @expand
+ * @category Interfaces
+ * */
+export interface PolicyContext<AllowSchema extends z.ZodType = z.ZodUndefined, DenySchema extends z.ZodType = z.ZodUndefined> extends BaseContext {
+    allow: AllowSchema extends z.ZodUndefined ? () => ContextAllowResponseNoResult : (result: z.infer<AllowSchema>) => ContextAllowResponse<z.infer<AllowSchema>>;
+    deny: DenySchema extends z.ZodUndefined ? () => ContextDenyResponseNoResult : (result: z.infer<DenySchema>, runtimeError?: string) => ContextDenyResponse<z.infer<DenySchema>>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/lib/policyCore/policyConfig/context/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/policyCore/policyConfig/context/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EACV,mBAAmB,EACnB,2BAA2B,EAC3B,kBAAkB,EAClB,0BAA0B,EAC1B,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAExB,QAAA,MAAM,6BAA6B,EAAE,OAAO,MAE3C,CAAC;AAEF,KAAK,0BAA0B,CAAC,CAAC,IAAI,CAAC,GAAG;IACvC,CAAC,6BAA6B,CAAC,EAAE,gBAAgB,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI,OAAO,6BAA6B,SAAS,MAAM,CAAC,GACvF,CAAC,GACD;IACE,KAAK,EAAE,iEAAiE,CAAC;IACzE,GAAG,EAAE,+EAA+E,CAAC;CACtF,CAAC;AAEN,MAAM,MAAM,oBAAoB,CAAC,WAAW,IAAI,0BAA0B,CACxE,mBAAmB,CAAC,WAAW,CAAC,CACjC,CAAC;AACF,MAAM,MAAM,4BAA4B,GAAG,0BAA0B,CAAC,2BAA2B,CAAC,CAAC;AACnG,MAAM,MAAM,mBAAmB,CAAC,UAAU,IAAI,0BAA0B,CACtE,kBAAkB,CAAC,UAAU,CAAC,CAC/B,CAAC;AACF,MAAM,MAAM,2BAA2B,GAAG,0BAA0B,CAAC,0BAA0B,CAAC,CAAC;AAEjG;;;KAGK;AACL,MAAM,WAAW,aAAa,CAC5B,WAAW,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EAC9C,UAAU,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,CAC7C,SAAQ,WAAW;IACnB,KAAK,EAAE,WAAW,SAAS,CAAC,CAAC,YAAY,GACrC,MAAM,4BAA4B,GAClC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAEjF,IAAI,EAAE,UAAU,SAAS,CAAC,CAAC,YAAY,GACnC,MAAM,2BAA2B,GACjC,CACE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,EAC3B,YAAY,CAAC,EAAE,MAAM,KAClB,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;CACnD"}

package/dist/src/lib/policyCore/policyConfig/context/types.js

@@ -0,0 +1,5 @@
+"use strict";
+// src/lib/policyConfig/context/types.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+const YouMustCallContextAllowOrDeny = Symbol('PolicyResponses must come from calling context.allow() or context.deny()');
+//# sourceMappingURL=types.js.map

package/dist/src/lib/policyCore/policyConfig/context/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/lib/policyCore/policyConfig/context/types.ts"],"names":[],"mappings":";AAAA,wCAAwC;;AAYxC,MAAM,6BAA6B,GAAkB,MAAM,CACzD,0EAA0E,CAC3E,CAAC"}

package/dist/src/lib/policyCore/policyConfig/types.d.ts

@@ -0,0 +1,46 @@
+import type { z } from 'zod';
+import type { ContextAllowResponse, ContextAllowResponseNoResult, ContextDenyResponse, ContextDenyResponseNoResult, EnforcePolicyResponse, PolicyContext } from './context/types';
+/** `evaluate()` and `precheck()` functions that you define when using `createVincentPolicy()` will match this function signature.
+ * Note that the arguments and return types are inferred based on the ZOD schemas that you pass to `createVincentPolicy`
+ *
+ * @category Interfaces
+ */
+export type PolicyConfigLifecycleFunction<AbilityParams extends z.ZodType, UserParams extends z.ZodType = z.ZodUndefined, AllowResult extends z.ZodType = z.ZodUndefined, DenyResult extends z.ZodType = z.ZodUndefined> = (args: {
+    abilityParams: z.infer<AbilityParams>;
+    userParams: z.infer<UserParams>;
+}, ctx: PolicyContext<AllowResult, DenyResult>) => Promise<EnforcePolicyResponse<(AllowResult extends z.ZodUndefined ? ContextAllowResponseNoResult : ContextAllowResponse<z.infer<AllowResult>>) | (DenyResult extends z.ZodUndefined ? ContextDenyResponseNoResult : ContextDenyResponse<z.infer<DenyResult>>)>>;
+/** Unlike `evaluate()` and `precheck()`, commit receives specific arguments provided by the ability during its `execute()` phase
+ * instead of than `abilityParams` and `userParams` that the ability was called with.
+ *
+ * @category Interfaces
+ */
+export type PolicyConfigCommitFunction<CommitParams extends z.ZodType = z.ZodUndefined, CommitAllowResult extends z.ZodType = z.ZodUndefined, CommitDenyResult extends z.ZodType = z.ZodUndefined> = (args: CommitParams extends z.ZodType ? z.infer<CommitParams> : undefined, context: PolicyContext<CommitAllowResult, CommitDenyResult>) => Promise<EnforcePolicyResponse<(CommitAllowResult extends z.ZodUndefined ? ContextAllowResponseNoResult : ContextAllowResponse<z.infer<CommitAllowResult>>) | (CommitDenyResult extends z.ZodUndefined ? ContextDenyResponseNoResult : ContextDenyResponse<z.infer<CommitDenyResult>>)>>;
+/**
+ * @typeParam PackageName {@removeTypeParameterCompletely}
+ * @typeParam PolicyAbilityParams {@removeTypeParameterCompletely}
+ * @typeParam UserParams {@removeTypeParameterCompletely}
+ * @typeParam PrecheckAllowResult {@removeTypeParameterCompletely}
+ * @typeParam PrecheckDenyResult {@removeTypeParameterCompletely}
+ * @typeParam EvalAllowResult {@removeTypeParameterCompletely}
+ * @typeParam EvalDenyResult {@removeTypeParameterCompletely}
+ * @typeParam CommitParams {@removeTypeParameterCompletely}
+ * @typeParam CommitAllowResult {@removeTypeParameterCompletely}
+ * @typeParam CommitDenyResult {@removeTypeParameterCompletely}
+ * @typeParam CommitDenyResult {@removeTypeParameterCompletely}
+ */
+export type VincentPolicyConfig<PackageName extends string, PolicyAbilityParams extends z.ZodType, UserParams extends z.ZodType = z.ZodUndefined, PrecheckAllowResult extends z.ZodType = z.ZodUndefined, PrecheckDenyResult extends z.ZodType = z.ZodUndefined, EvalAllowResult extends z.ZodType = z.ZodUndefined, EvalDenyResult extends z.ZodType = z.ZodUndefined, CommitParams extends z.ZodType = z.ZodUndefined, CommitAllowResult extends z.ZodType = z.ZodUndefined, CommitDenyResult extends z.ZodType = z.ZodUndefined, EvaluateFn = PolicyConfigLifecycleFunction<PolicyAbilityParams, UserParams, EvalAllowResult, EvalDenyResult>, PrecheckFn = undefined | PolicyConfigLifecycleFunction<PolicyAbilityParams, UserParams, PrecheckAllowResult, PrecheckDenyResult>, CommitFn = undefined | PolicyConfigCommitFunction<CommitParams, CommitAllowResult, CommitDenyResult>> = {
+    packageName: PackageName;
+    abilityParamsSchema: PolicyAbilityParams;
+    userParamsSchema?: UserParams;
+    evalAllowResultSchema?: EvalAllowResult;
+    evalDenyResultSchema?: EvalDenyResult;
+    precheckAllowResultSchema?: PrecheckAllowResult;
+    precheckDenyResultSchema?: PrecheckDenyResult;
+    commitParamsSchema?: CommitParams;
+    commitAllowResultSchema?: CommitAllowResult;
+    commitDenyResultSchema?: CommitDenyResult;
+    evaluate: EvaluateFn;
+    precheck?: PrecheckFn;
+    commit?: CommitFn;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/lib/policyCore/policyConfig/types.d.ts.map

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

package/dist/src/lib/policyCore/policyConfig/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/lib/policyCore/policyConfig/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/lib/policyCore/policyConfig/types.ts"],"names":[],"mappings":""}

package/dist/src/lib/policyCore/policyParameters/getOnchainPolicyParams.d.ts

@@ -0,0 +1,17 @@
+import { ethers } from 'ethers';
+import type { AbilityPolicyParameterData } from '@lit-protocol/vincent-contracts-sdk';
+export declare const getDecodedPolicyParams: ({ decodedPolicies, policyIpfsCid, }: {
+    decodedPolicies: AbilityPolicyParameterData;
+    policyIpfsCid: string;
+}) => Promise<Record<string, any> | undefined>;
+export declare const getPoliciesAndAppVersion: ({ delegationRpcUrl, appDelegateeAddress, agentWalletPkpEthAddress, abilityIpfsCid, }: {
+    delegationRpcUrl: string;
+    appDelegateeAddress: string;
+    agentWalletPkpEthAddress: string;
+    abilityIpfsCid: string;
+}) => Promise<{
+    appId: ethers.BigNumber;
+    appVersion: ethers.BigNumber;
+    decodedPolicies: AbilityPolicyParameterData;
+}>;
+//# sourceMappingURL=getOnchainPolicyParams.d.ts.map

package/dist/src/lib/policyCore/policyParameters/getOnchainPolicyParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOnchainPolicyParams.d.ts","sourceRoot":"","sources":["../../../../../src/lib/policyCore/policyParameters/getOnchainPolicyParams.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EACV,0BAA0B,EAE3B,MAAM,qCAAqC,CAAC;AAM7C,eAAO,MAAM,sBAAsB,GAAU,qCAG1C;IACD,eAAe,EAAE,0BAA0B,CAAC;IAC5C,aAAa,EAAE,MAAM,CAAC;CACvB,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAW1C,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAU,sFAK5C;IACD,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAAC;IACjC,cAAc,EAAE,MAAM,CAAC;CACxB,KAAG,OAAO,CAAC;IACV,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC;IAC7B,eAAe,EAAE,0BAA0B,CAAC;CAC7C,CA6CA,CAAC"}

package/dist/src/lib/policyCore/policyParameters/getOnchainPolicyParams.js

@@ -0,0 +1,54 @@
+"use strict";
+// src/lib/policyCore/policyParameters/getOnchainPolicyParams.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPoliciesAndAppVersion = exports.getDecodedPolicyParams = void 0;
+const ethers_1 = require("ethers");
+const vincent_contracts_sdk_1 = require("@lit-protocol/vincent-contracts-sdk");
+const utils_1 = require("../../utils");
+const getDecodedPolicyParams = async ({ decodedPolicies, policyIpfsCid, }) => {
+    console.log('All on-chain policy params:', JSON.stringify(decodedPolicies, utils_1.bigintReplacer));
+    const policyParams = decodedPolicies[policyIpfsCid];
+    if (policyParams) {
+        return policyParams;
+    }
+    console.log('Found no on-chain parameters for policy IPFS CID:', policyIpfsCid);
+    return undefined;
+};
+exports.getDecodedPolicyParams = getDecodedPolicyParams;
+const getPoliciesAndAppVersion = async ({ delegationRpcUrl, appDelegateeAddress, agentWalletPkpEthAddress, abilityIpfsCid, }) => {
+    console.log('getPoliciesAndAppVersion', {
+        delegationRpcUrl,
+        appDelegateeAddress,
+        agentWalletPkpEthAddress,
+        abilityIpfsCid,
+    });
+    try {
+        // Create a signer using the delegationRpcUrl
+        const signer = ethers_1.ethers.Wallet.createRandom().connect(new ethers_1.ethers.providers.StaticJsonRpcProvider(delegationRpcUrl));
+        const contractClient = (0, vincent_contracts_sdk_1.getClient)({
+            signer,
+        });
+        // Use the contracts-sdk to validate ability execution and get policies
+        const validationResult = await contractClient.validateAbilityExecutionAndGetPolicies({
+            delegateeAddress: appDelegateeAddress,
+            pkpEthAddress: agentWalletPkpEthAddress,
+            abilityIpfsCid: abilityIpfsCid,
+        });
+        // We exit early here because !validationResult.isPermitted means appDelegateeAddress
+        // is not permitted to execute abilityIpfsCid for the Vincent App on behalf of the agentWalletPkpTokenId
+        // and no further processing is needed
+        if (!validationResult.isPermitted) {
+            throw new Error(`App Delegatee: ${appDelegateeAddress} is not permitted to execute Vincent Ability: ${abilityIpfsCid} for App ID: ${validationResult.appId} App Version: ${validationResult.appVersion} using Agent Wallet PKP Address: ${agentWalletPkpEthAddress}`);
+        }
+        return {
+            appId: ethers_1.ethers.BigNumber.from(validationResult.appId),
+            appVersion: ethers_1.ethers.BigNumber.from(validationResult.appVersion),
+            decodedPolicies: validationResult.decodedPolicies,
+        };
+    }
+    catch (error) {
+        throw new Error(`Error getting on-chain policy parameters from Vincent contract using App Delegatee: ${appDelegateeAddress} and Agent Wallet PKP Address: ${agentWalletPkpEthAddress} and Vincent Ability: ${abilityIpfsCid}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+};
+exports.getPoliciesAndAppVersion = getPoliciesAndAppVersion;
+//# sourceMappingURL=getOnchainPolicyParams.js.map

package/dist/src/lib/policyCore/policyParameters/getOnchainPolicyParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOnchainPolicyParams.js","sourceRoot":"","sources":["../../../../../src/lib/policyCore/policyParameters/getOnchainPolicyParams.ts"],"names":[],"mappings":";AAAA,gEAAgE;;;AAEhE,mCAAgC;AAOhC,+EAAgE;AAEhE,uCAA6C;AAEtC,MAAM,sBAAsB,GAAG,KAAK,EAAE,EAC3C,eAAe,EACf,aAAa,GAId,EAA4C,EAAE;IAC7C,OAAO,CAAC,GAAG,CAAC,6BAA6B,EAAE,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,sBAAc,CAAC,CAAC,CAAC;IAE5F,MAAM,YAAY,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;IAEpD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,mDAAmD,EAAE,aAAa,CAAC,CAAC;IAChF,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAjBW,QAAA,sBAAsB,0BAiBjC;AAEK,MAAM,wBAAwB,GAAG,KAAK,EAAE,EAC7C,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,GAMf,EAIE,EAAE;IACH,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE;QACtC,gBAAgB;QAChB,mBAAmB;QACnB,wBAAwB;QACxB,cAAc;KACf,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,6CAA6C;QAC7C,MAAM,MAAM,GAAG,eAAM,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,OAAO,CACjD,IAAI,eAAM,CAAC,SAAS,CAAC,qBAAqB,CAAC,gBAAgB,CAAC,CAC7D,CAAC;QAEF,MAAM,cAAc,GAAG,IAAA,iCAAS,EAAC;YAC/B,MAAM;SACP,CAAC,CAAC;QAEH,uEAAuE;QACvE,MAAM,gBAAgB,GACpB,MAAM,cAAc,CAAC,sCAAsC,CAAC;YAC1D,gBAAgB,EAAE,mBAAmB;YACrC,aAAa,EAAE,wBAAwB;YACvC,cAAc,EAAE,cAAc;SAC/B,CAAC,CAAC;QAEL,qFAAqF;QACrF,wGAAwG;QACxG,sCAAsC;QACtC,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,kBAAkB,mBAAmB,iDAAiD,cAAc,gBAAgB,gBAAgB,CAAC,KAAK,iBAAiB,gBAAgB,CAAC,UAAU,oCAAoC,wBAAwB,EAAE,CACrP,CAAC;QACJ,CAAC;QAED,OAAO;YACL,KAAK,EAAE,eAAM,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;YACpD,UAAU,EAAE,eAAM,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC;YAC9D,eAAe,EAAE,gBAAgB,CAAC,eAAe;SAClD,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,uFAAuF,mBAAmB,kCAAkC,wBAAwB,yBAAyB,cAAc,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACzQ,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AA3DW,QAAA,wBAAwB,4BA2DnC"}

package/dist/src/lib/policyCore/vincentPolicy.d.ts

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+import type { CommitLifecycleFunction, PolicyLifecycleFunction, VincentPolicy } from '../types';
+import type { BundledVincentPolicy } from './bundledPolicy/types';
+import type { PolicyConfigCommitFunction, PolicyConfigLifecycleFunction, VincentPolicyConfig } from './policyConfig/types';
+/**
+ * The `createVincentPolicy()` method is used to define a policy's lifecycle methods and ensure that arguments provided to the ability's
+ * lifecycle methods, as well as their return values, are validated and fully type-safe by defining ZOD schemas for them.
+ *
+ * @typeParam PackageName {@removeTypeParameterCompletely}
+ * @typeParam PolicyAbilityParams {@removeTypeParameterCompletely}
+ * @typeParam UserParams {@removeTypeParameterCompletely}
+ * @typeParam PrecheckAllowResult {@removeTypeParameterCompletely}
+ * @typeParam PrecheckDenyResult {@removeTypeParameterCompletely}
+ * @typeParam EvalAllowResult {@removeTypeParameterCompletely}
+ * @typeParam EvalDenyResult {@removeTypeParameterCompletely}
+ * @typeParam CommitParams {@removeTypeParameterCompletely}
+ * @typeParam CommitAllowResult {@removeTypeParameterCompletely}
+ * @typeParam CommitDenyResult {@removeTypeParameterCompletely}
+ * @category API Methods
+ */
+export declare function createVincentPolicy<PackageName extends string, PolicyAbilityParams extends z.ZodType, UserParams extends z.ZodType = z.ZodUndefined, PrecheckAllowResult extends z.ZodType = z.ZodUndefined, PrecheckDenyResult extends z.ZodType = z.ZodUndefined, EvalAllowResult extends z.ZodType = z.ZodUndefined, EvalDenyResult extends z.ZodType = z.ZodUndefined, CommitParams extends z.ZodType = z.ZodUndefined, CommitAllowResult extends z.ZodType = z.ZodUndefined, CommitDenyResult extends z.ZodType = z.ZodUndefined>(PolicyConfig: VincentPolicyConfig<PackageName, PolicyAbilityParams, UserParams, PrecheckAllowResult, PrecheckDenyResult, EvalAllowResult, EvalDenyResult, CommitParams, CommitAllowResult, CommitDenyResult, PolicyConfigLifecycleFunction<PolicyAbilityParams, UserParams, EvalAllowResult, EvalDenyResult>, PolicyConfigLifecycleFunction<PolicyAbilityParams, UserParams, PrecheckAllowResult, PrecheckDenyResult>, PolicyConfigCommitFunction<CommitParams, CommitAllowResult, CommitDenyResult>>): VincentPolicy<PackageName, PolicyAbilityParams, UserParams, PrecheckAllowResult, PrecheckDenyResult, EvalAllowResult, EvalDenyResult, CommitParams, CommitAllowResult, CommitDenyResult, PolicyLifecycleFunction<PolicyAbilityParams, UserParams, EvalAllowResult, EvalDenyResult>, PolicyLifecycleFunction<PolicyAbilityParams, UserParams, PrecheckAllowResult, PrecheckDenyResult>, CommitLifecycleFunction<CommitParams, CommitAllowResult, CommitDenyResult>>;
+/**
+ * `createVincentAbilityPolicy()` is used to bind a policy to a specific ability. You must provide a `abilityParameterMappings` argument
+ * which instructs the ability which of its abilityParams should be passed to the Vincent Policy during evaluation, and
+ * defines what the argument passed to the ability should be.
+ *
+ * For example, a Ability might receive an argument called `tokenInAmount`, but it may need to pass that as `buyAmount` to a
+ * policy that uses the `tokenInAmount` for its own purposes.
+ *
+ * ```typescript
+ * import { bundledVincentPolicy } from '@lit-protocol/vincent-policy-spending-limit';
+ *
+ * const SpendingLimitPolicy = createVincentAbilityPolicy({
+ *   abilityParamsSchema,
+ *   bundledVincentPolicy,
+ *   abilityParameterMappings: {
+ *     rpcUrlForUniswap: 'rpcUrlForUniswap',
+ *     chainIdForUniswap: 'chainIdForUniswap',
+ *     ethRpcUrl: 'ethRpcUrl',
+ *     tokenInAddress: 'tokenAddress',
+ *     tokenInDecimals: 'tokenDecimals',
+ *     tokenInAmount: 'buyAmount',
+ *   },
+ * });
+ * ```
+ *
+ * @typeParam PackageName {@removeTypeParameterCompletely}
+ * @typeParam IpfsCid {@removeTypeParameterCompletely}
+ * @typeParam AbilityParamsSchema {@removeTypeParameterCompletely}
+ * @typeParam PolicyAbilityParams {@removeTypeParameterCompletely}
+ * @typeParam UserParams {@removeTypeParameterCompletely}
+ * @typeParam PrecheckAllowResult {@removeTypeParameterCompletely}
+ * @typeParam PrecheckDenyResult {@removeTypeParameterCompletely}
+ * @typeParam EvalAllowResult {@removeTypeParameterCompletely}
+ * @typeParam EvalDenyResult {@removeTypeParameterCompletely}
+ * @typeParam CommitParams {@removeTypeParameterCompletely}
+ * @typeParam CommitAllowResult {@removeTypeParameterCompletely}
+ * @typeParam CommitDenyResult {@removeTypeParameterCompletely}
+ *
+ * @returns A Vincent Policy that is configured to work with the provided ability
+ * {@displayType A Vincent Policy that is configured to work with the provided ability }
+ * @category API Methods
+ */
+export declare function createVincentAbilityPolicy<const PackageName extends string, const IpfsCid extends string, const VincentAbilityApiVersion extends string, AbilityParamsSchema extends z.ZodType, PolicyAbilityParams extends z.ZodType, UserParams extends z.ZodType = z.ZodUndefined, PrecheckAllowResult extends z.ZodType = z.ZodUndefined, PrecheckDenyResult extends z.ZodType = z.ZodUndefined, EvalAllowResult extends z.ZodType = z.ZodUndefined, EvalDenyResult extends z.ZodType = z.ZodUndefined, CommitParams extends z.ZodType = z.ZodUndefined, CommitAllowResult extends z.ZodType = z.ZodUndefined, CommitDenyResult extends z.ZodType = z.ZodUndefined>(config: {
+    abilityParamsSchema: AbilityParamsSchema;
+    bundledVincentPolicy: BundledVincentPolicy<VincentPolicy<PackageName, PolicyAbilityParams, UserParams, PrecheckAllowResult, PrecheckDenyResult, EvalAllowResult, EvalDenyResult, CommitParams, CommitAllowResult, CommitDenyResult, PolicyLifecycleFunction<PolicyAbilityParams, UserParams, EvalAllowResult, EvalDenyResult>, PolicyLifecycleFunction<PolicyAbilityParams, UserParams, PrecheckAllowResult, PrecheckDenyResult>, CommitLifecycleFunction<CommitParams, CommitAllowResult, CommitDenyResult>>, IpfsCid, VincentAbilityApiVersion>;
+    abilityParameterMappings: Partial<{
+        [K in keyof z.infer<AbilityParamsSchema>]: keyof z.infer<PolicyAbilityParams>;
+    }>;
+}): {
+    vincentPolicy: VincentPolicy<PackageName, PolicyAbilityParams, UserParams, PrecheckAllowResult, PrecheckDenyResult, EvalAllowResult, EvalDenyResult, CommitParams, CommitAllowResult, CommitDenyResult, PolicyLifecycleFunction<PolicyAbilityParams, UserParams, EvalAllowResult, EvalDenyResult>, PolicyLifecycleFunction<PolicyAbilityParams, UserParams, PrecheckAllowResult, PrecheckDenyResult>, CommitLifecycleFunction<CommitParams, CommitAllowResult, CommitDenyResult>>;
+    ipfsCid: IpfsCid;
+    abilityParameterMappings: typeof config.abilityParameterMappings;
+    /** @hidden */
+    vincentAbilityApiVersion: VincentAbilityApiVersion;
+    /** @hidden */
+    __schemaTypes: {
+        policyAbilityParamsSchema: PolicyAbilityParams;
+        userParamsSchema: UserParams;
+        evalAllowResultSchema: EvalAllowResult;
+        evalDenyResultSchema: EvalDenyResult;
+        precheckAllowResultSchema: PrecheckAllowResult;
+        precheckDenyResultSchema: PrecheckDenyResult;
+        commitParamsSchema: CommitParams;
+        commitAllowResultSchema: CommitAllowResult;
+        commitDenyResultSchema: CommitDenyResult;
+        evaluate: PolicyLifecycleFunction<PolicyAbilityParams, UserParams, EvalAllowResult, EvalDenyResult>;
+        precheck: PolicyLifecycleFunction<PolicyAbilityParams, UserParams, PrecheckAllowResult, PrecheckDenyResult> | undefined;
+        commit: CommitLifecycleFunction<CommitParams, CommitAllowResult, CommitDenyResult> | undefined;
+    };
+};
+//# sourceMappingURL=vincentPolicy.d.ts.map

package/dist/src/lib/policyCore/vincentPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vincentPolicy.d.ts","sourceRoot":"","sources":["../../../../src/lib/policyCore/vincentPolicy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EAMvB,aAAa,EAEd,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,OAAO,KAAK,EACV,0BAA0B,EAC1B,6BAA6B,EAC7B,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAmB9B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,SAAS,MAAM,EAC1B,mBAAmB,SAAS,CAAC,CAAC,OAAO,EACrC,UAAU,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EAC7C,mBAAmB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACtD,kBAAkB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACrD,eAAe,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EAClD,cAAc,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACjD,YAAY,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EAC/C,iBAAiB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACpD,gBAAgB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EAEnD,YAAY,EAAE,mBAAmB,CAC/B,WAAW,EACX,mBAAmB,EACnB,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,6BAA6B,CAAC,mBAAmB,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,CAAC,EAC/F,6BAA6B,CAC3B,mBAAmB,EACnB,UAAU,EACV,mBAAmB,EACnB,kBAAkB,CACnB,EACD,0BAA0B,CAAC,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,CAC9E,scAwOF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,CAAC,WAAW,SAAS,MAAM,EAChC,KAAK,CAAC,OAAO,SAAS,MAAM,EAC5B,KAAK,CAAC,wBAAwB,SAAS,MAAM,EAC7C,mBAAmB,SAAS,CAAC,CAAC,OAAO,EACrC,mBAAmB,SAAS,CAAC,CAAC,OAAO,EACrC,UAAU,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EAC7C,mBAAmB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACtD,kBAAkB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACrD,eAAe,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EAClD,cAAc,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACjD,YAAY,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EAC/C,iBAAiB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACpD,gBAAgB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACnD,MAAM,EAAE;IACR,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,oBAAoB,EAAE,oBAAoB,CACxC,aAAa,CACX,WAAW,EACX,mBAAmB,EACnB,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,CAAC,mBAAmB,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,CAAC,EACzF,uBAAuB,CACrB,mBAAmB,EACnB,UAAU,EACV,mBAAmB,EACnB,kBAAkB,CACnB,EACD,uBAAuB,CAAC,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,CAC3E,EACD,OAAO,EACP,wBAAwB,CACzB,CAAC;IACF,wBAAwB,EAAE,OAAO,CAAC;SAC/B,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC;KAC9E,CAAC,CAAC;CACJ,GAgCkB;IACf,aAAa,qcAAuB;IACpC,OAAO,UAAiB;IACxB,wBAAwB,EAAE,OAAO,MAAM,CAAC,wBAAwB,CAAC;IACjE,cAAc;IACd,wBAAwB,2BAAkC;IAC1D,cAAc;IACd,aAAa,EAAE;QACb,yBAAyB,EAAE,mBAAmB,CAAC;QAC/C,gBAAgB,EAAE,UAAU,CAAC;QAC7B,qBAAqB,EAAE,eAAe,CAAC;QACvC,oBAAoB,EAAE,cAAc,CAAC;QACrC,yBAAyB,EAAE,mBAAmB,CAAC;QAC/C,wBAAwB,EAAE,kBAAkB,CAAC;QAC7C,kBAAkB,EAAE,YAAY,CAAC;QACjC,uBAAuB,EAAE,iBAAiB,CAAC;QAC3C,sBAAsB,EAAE,gBAAgB,CAAC;QAEzC,QAAQ,4FAAgC;QACxC,QAAQ,gHAAgC;QACxC,MAAM,yFAA8B;KACrC,CAAC;CACH,CACF"}