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

package/dist/src/lib/abilityCore/helpers/validatePolicies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validatePolicies.d.ts","sourceRoot":"","sources":["../../../../../src/lib/abilityCore/helpers/validatePolicies.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAEtF,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAMtE,MAAM,MAAM,kBAAkB,CAC5B,mBAAmB,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/C,qBAAqB,SAAS,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,IAC/E,KAAK,CACP;KACG,OAAO,IAAI,MAAM,qBAAqB,GAAG;QACxC,UAAU,EACN;YACE,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC;SAC1B,GACD,SAAS,CAAC;QACd,iBAAiB,EAAE,OAAO,CAAC;QAC3B,mBAAmB,EAAE;aAClB,cAAc,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC,0BAA0B,CAAC,CAAC,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC,0BAA0B,CAAC,CAAC,GAC7I,MAAM,GAAG,mBAAmB,CAAC;iBAC5B,eAAe,IAAI,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC,0BAA0B,CAAC,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC,0BAA0B,CAAC,CAAC,eAAe,CAAC,SAAS,cAAc,GACrL,eAAe,GACf,KAAK;aACV,CAAC,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC,0BAA0B,CAAC,CAAC,GACjE,MAAM,mBAAmB,CAAC;SAC7B,CAAC;KACH;CACF,CAAC,MAAM,qBAAqB,CAAC,CAC/B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,mBAAmB,SAAS,CAAC,CAAC,OAAO,EACrC,SAAS,SAAS,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,EAC5C,qBAAqB,SAAS,SAAS,CAAC,qBAAqB,CAAC,EAC9D,EACA,eAAe,EACf,cAAc,EACd,cAAc,EACd,mBAAmB,GACpB,EAAE;IACD,eAAe,EAAE,0BAA0B,CAAC;IAC5C,cAAc,EAAE,cAAc,CAC5B,mBAAmB,EACnB,MAAM,qBAAqB,GAAG,MAAM,EACpC,SAAS,EACT,qBAAqB,EACrB,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,CACJ,CAAC;IACF,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;CACnD,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAuDnF"}

package/dist/src/lib/abilityCore/helpers/validatePolicies.js

@@ -0,0 +1,31 @@
+"use strict";
+// src/lib/abilityCore/helpers/validatePolicies.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePolicies = validatePolicies;
+const getMappedAbilityPolicyParams_1 = require("./getMappedAbilityPolicyParams");
+async function validatePolicies({ decodedPolicies, vincentAbility, abilityIpfsCid, parsedAbilityParams, }) {
+    const validatedPolicies = [];
+    for (const policyIpfsCid of Object.keys(decodedPolicies)) {
+        const abilityPolicy = vincentAbility.supportedPolicies.policyByIpfsCid[policyIpfsCid];
+        console.log('vincentAbility.supportedPolicies', Object.keys(vincentAbility.supportedPolicies.policyByIpfsCid));
+        if (!abilityPolicy) {
+            throw new Error(`Policy with IPFS CID ${policyIpfsCid} is registered on-chain but not supported by this ability. Vincent Ability: ${abilityIpfsCid}`);
+        }
+        const policyPackageName = abilityPolicy.vincentPolicy.packageName;
+        if (!abilityPolicy.abilityParameterMappings) {
+            throw new Error('abilityParameterMappings missing on policy');
+        }
+        console.log('abilityPolicy.abilityParameterMappings', JSON.stringify(abilityPolicy.abilityParameterMappings));
+        const abilityPolicyParams = (0, getMappedAbilityPolicyParams_1.getMappedAbilityPolicyParams)({
+            abilityParameterMappings: abilityPolicy.abilityParameterMappings,
+            parsedAbilityParams,
+        });
+        validatedPolicies.push({
+            parameters: decodedPolicies[policyIpfsCid] || {},
+            policyPackageName,
+            abilityPolicyParams,
+        });
+    }
+    return validatedPolicies;
+}
+//# sourceMappingURL=validatePolicies.js.map

package/dist/src/lib/abilityCore/helpers/validatePolicies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validatePolicies.js","sourceRoot":"","sources":["../../../../../src/lib/abilityCore/helpers/validatePolicies.ts"],"names":[],"mappings":";AAAA,kDAAkD;;AAsClD,4CAgFC;AA7GD,iFAA8E;AA6BvE,KAAK,UAAU,gBAAgB,CAIpC,EACA,eAAe,EACf,cAAc,EACd,cAAc,EACd,mBAAmB,GAiBpB;IACC,MAAM,iBAAiB,GAQlB,EAAE,CAAC;IAER,KAAK,MAAM,aAAa,IAAI,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;QACzD,MAAM,aAAa,GAAG,cAAc,CAAC,iBAAiB,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;QAEtF,OAAO,CAAC,GAAG,CACT,kCAAkC,EAClC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAC9D,CAAC;QACF,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,wBAAwB,aAAa,+EAA+E,cAAc,EAAE,CACrI,CAAC;QACJ,CAAC;QAED,MAAM,iBAAiB,GAAG,aAAa,CAAC,aAAa,CAAC,WAAW,CAAC;QAElE,IAAI,CAAC,aAAa,CAAC,wBAAwB,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,CAAC,GAAG,CACT,wCAAwC,EACxC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,wBAAwB,CAAC,CACvD,CAAC;QACF,MAAM,mBAAmB,GAAG,IAAA,2DAA4B,EAAC;YACvD,wBAAwB,EAAE,aAAa,CAAC,wBAGvC;YACD,mBAAmB;SACpB,CAEA,CAAC;QAEF,iBAAiB,CAAC,IAAI,CAAC;YACrB,UAAU,EAAE,eAAe,CAAC,aAAa,CAAC,IAAI,EAAE;YAChD,iBAAiB;YACjB,mBAAmB;SACpB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,iBAGN,CAAC;AACJ,CAAC"}

package/dist/src/lib/abilityCore/helpers/zod.d.ts

@@ -0,0 +1,43 @@
+import type { ZodType } from 'zod';
+import { z } from 'zod';
+import type { AbilityResultFailure, AbilityResultFailureNoResult } from '../../types';
+/**
+ * Matches the minimum structure of a AbilityResult.
+ * This is useful when validating that a response shape is at least plausible.
+ */
+export declare const AbilityResultShape: z.ZodObject<{
+    success: z.ZodBoolean;
+    result: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    result?: unknown;
+}, {
+    success: boolean;
+    result?: unknown;
+}>;
+/**
+ * Validates a value using a Zod schema (or requires undefined if none given).
+ * Returns parsed result or a standardized failure object.
+ *
+ * @param value - The raw value to validate
+ * @param schema - A Zod schema to apply
+ * @param stage - Whether this is input or output validation
+ * @param phase - Whether this is 'precheck' or 'execute'
+ */
+export declare function validateOrFail<T extends ZodType<any, any, any>>(value: unknown, schema: T, phase: 'precheck' | 'execute', stage: 'input' | 'output'): z.infer<T> | AbilityResultFailure<never> | AbilityResultFailureNoResult;
+/**
+ * Given an unknown ability response result and the known success/failure 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 AbilityResult structure.
+ * - If the shape is valid, returns either the success or failure result schema.
+ */
+export declare function getSchemaForAbilityResult({ value, successResultSchema, failureResultSchema, }: {
+    value: unknown;
+    successResultSchema?: ZodType;
+    failureResultSchema?: ZodType;
+}): {
+    schemaToUse: ZodType;
+    parsedType: 'success' | 'failure' | 'unknown';
+};
+//# sourceMappingURL=zod.d.ts.map

package/dist/src/lib/abilityCore/helpers/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../../../../src/lib/abilityCore/helpers/zod.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAKtF;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAC;AAOH;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC7D,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,KAAK,EAAE,OAAO,GAAG,QAAQ,GACxB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC,KAAK,CAAC,GAAG,4BAA4B,CAkBzE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,KAAK,EACL,mBAAmB,EACnB,mBAAmB,GACpB,EAAE;IACD,KAAK,EAAE,OAAO,CAAC;IACf,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,GAAG;IACF,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;CAC/C,CAgBA"}

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

@@ -0,0 +1,70 @@
+"use strict";
+// src/lib/abilityCore/helpers/zod.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbilityResultShape = void 0;
+exports.validateOrFail = validateOrFail;
+exports.getSchemaForAbilityResult = getSchemaForAbilityResult;
+const zod_1 = require("zod");
+const resultCreators_1 = require("./resultCreators");
+const typeGuards_1 = require("./typeGuards");
+/**
+ * Matches the minimum structure of a AbilityResult.
+ * This is useful when validating that a response shape is at least plausible.
+ */
+exports.AbilityResultShape = zod_1.z.object({
+    success: zod_1.z.boolean(),
+    result: zod_1.z.unknown(),
+});
+/**
+ * Used as the default fallback schema when one is missing and the result must be undefined.
+ */
+const mustBeUndefinedSchema = zod_1.z.undefined();
+/**
+ * Validates a value using a Zod schema (or requires undefined if none given).
+ * Returns parsed result or a standardized failure object.
+ *
+ * @param value - The raw value to validate
+ * @param schema - A Zod schema to apply
+ * @param stage - Whether this is input or output validation
+ * @param phase - Whether this is 'precheck' or 'execute'
+ */
+function validateOrFail(value, schema, phase, stage) {
+    const effectiveSchema = schema ?? mustBeUndefinedSchema;
+    const parsed = effectiveSchema.safeParse(value);
+    if (!parsed.success) {
+        const descriptor = stage === 'input' ? 'parameters' : 'result';
+        const message = `Invalid ${phase} ${descriptor}.`;
+        return (0, resultCreators_1.createAbilityFailureResult)({
+            runtimeError: message,
+            schemaValidationError: {
+                zodError: parsed.error,
+                phase,
+                stage,
+            },
+        });
+    }
+    return parsed.data;
+}
+/**
+ * Given an unknown ability response result and the known success/failure 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 AbilityResult structure.
+ * - If the shape is valid, returns either the success or failure result schema.
+ */
+function getSchemaForAbilityResult({ value, successResultSchema, failureResultSchema, }) {
+    if (!(0, typeGuards_1.isAbilityResult)(value)) {
+        return {
+            schemaToUse: exports.AbilityResultShape,
+            parsedType: 'unknown',
+        };
+    }
+    const schemaToUse = value.success
+        ? (successResultSchema ?? zod_1.z.undefined())
+        : (failureResultSchema ?? zod_1.z.undefined());
+    return {
+        schemaToUse,
+        parsedType: value.success ? 'success' : 'failure',
+    };
+}
+//# sourceMappingURL=zod.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../../../../../src/lib/abilityCore/helpers/zod.ts"],"names":[],"mappings":";AAAA,qCAAqC;;;AAmCrC,wCAuBC;AASD,8DA2BC;AAzFD,6BAAwB;AAIxB,qDAA8D;AAC9D,6CAA+C;AAE/C;;;GAGG;AACU,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;IACpB,MAAM,EAAE,OAAC,CAAC,OAAO,EAAE;CACpB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,qBAAqB,GAAG,OAAC,CAAC,SAAS,EAAE,CAAC;AAE5C;;;;;;;;GAQG;AACH,SAAgB,cAAc,CAC5B,KAAc,EACd,MAAS,EACT,KAA6B,EAC7B,KAAyB;IAEzB,MAAM,eAAe,GAAG,MAAM,IAAI,qBAAqB,CAAC;IACxD,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAEhD,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,2CAA0B,EAAC;YAChC,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;;;;;;GAMG;AACH,SAAgB,yBAAyB,CAAC,EACxC,KAAK,EACL,mBAAmB,EACnB,mBAAmB,GAKpB;IAIC,IAAI,CAAC,IAAA,4BAAe,EAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,WAAW,EAAE,0BAAkB;YAC/B,UAAU,EAAE,SAAS;SACtB,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO;QAC/B,CAAC,CAAC,CAAC,mBAAmB,IAAI,OAAC,CAAC,SAAS,EAAE,CAAC;QACxC,CAAC,CAAC,CAAC,mBAAmB,IAAI,OAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IAE3C,OAAO;QACL,WAAW;QACX,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;KAClD,CAAC;AACJ,CAAC"}

package/dist/src/lib/abilityCore/vincentAbility.d.ts

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+import type { PolicyEvaluationResultContext, AbilityExecutionPolicyContext, VincentAbility } from '../types';
+import type { AbilityConfigLifecycleFunction, VincentAbilityConfig } from './abilityConfig/types';
+import type { AbilityPolicyMap } from './helpers';
+/**
+ * The `createVincentAbility()` method is used to define an ability'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.
+ *
+ *```typescript
+ * const exampleSimpleAbility = createVincentAbility({
+ *     packageName: '@lit-protocol/yesability@1.0.0',
+ *     abilityDescription: 'Yes Ability description',
+ *     abilityParamsSchema: testSchema,
+ *     supportedPolicies: supportedPoliciesForAbility([testPolicy]),
+ *
+ *     precheck: async (params, { succeed, fail }) => {
+ *       // Should allow succeed() with no arguments
+ *       succeed();
+ *
+ *       // Should allow fail() with string error
+ *       fail('Error message');
+ *
+ *       // @ts-expect-error - Should not allow succeed() with arguments when no schema
+ *       succeed({ message: 'test' });
+ *
+ *       // @ts-expect-error - Should not allow fail() with object when no schema
+ *       fail({ error: 'test' });
+ *
+ *       return succeed();
+ *     },
+ *
+ *     execute: async (params, { succeed }) => {
+ *       // Should allow succeed() with no arguments
+ *       succeed();
+ *
+ *       // @ts-expect-error - Should not allow succeed() with arguments when no schema
+ *       return succeed({ data: 'test' });
+ *     },
+ *   });
+ * ```
+ *
+ * @typeParam AbilityParamsSchema {@removeTypeParameterCompletely}
+ * @typeParam PkgNames {@removeTypeParameterCompletely}
+ * @typeParam PolicyMap {@removeTypeParameterCompletely}
+ * @typeParam PolicyMapByPackageName {@removeTypeParameterCompletely}
+ * @typeParam PrecheckSuccessSchema {@removeTypeParameterCompletely}
+ * @typeParam PrecheckFailSchema {@removeTypeParameterCompletely}
+ * @typeParam ExecuteSuccessSchema {@removeTypeParameterCompletely}
+ * @typeParam ExecuteFailSchema {@removeTypeParameterCompletely}
+ *
+ * @category API Methods
+ */
+export declare function createVincentAbility<AbilityParamsSchema extends z.ZodType, const PkgNames extends string, const PolicyMap extends AbilityPolicyMap<any, PkgNames>, PolicyMapByPackageName extends PolicyMap['policyByPackageName'], PrecheckSuccessSchema extends z.ZodType = z.ZodUndefined, PrecheckFailSchema extends z.ZodType = z.ZodUndefined, ExecuteSuccessSchema extends z.ZodType = z.ZodUndefined, ExecuteFailSchema extends z.ZodType = z.ZodUndefined>(AbilityConfig: VincentAbilityConfig<AbilityParamsSchema, PkgNames, PolicyMap, PolicyMapByPackageName, PrecheckSuccessSchema, PrecheckFailSchema, ExecuteSuccessSchema, ExecuteFailSchema, AbilityConfigLifecycleFunction<AbilityParamsSchema, PolicyEvaluationResultContext<PolicyMapByPackageName>, PrecheckSuccessSchema, PrecheckFailSchema>, AbilityConfigLifecycleFunction<AbilityParamsSchema, AbilityExecutionPolicyContext<PolicyMapByPackageName>, ExecuteSuccessSchema, ExecuteFailSchema>>): VincentAbility<AbilityParamsSchema, PkgNames, PolicyMap, PolicyMapByPackageName, ExecuteSuccessSchema, ExecuteFailSchema, PrecheckSuccessSchema, PrecheckFailSchema>;
+//# sourceMappingURL=vincentAbility.d.ts.map

package/dist/src/lib/abilityCore/vincentAbility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vincentAbility.d.ts","sourceRoot":"","sources":["../../../../src/lib/abilityCore/vincentAbility.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EACV,6BAA6B,EAC7B,6BAA6B,EAG7B,cAAc,EACf,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,8BAA8B,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAelD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,oBAAoB,CAClC,mBAAmB,SAAS,CAAC,CAAC,OAAO,EACrC,KAAK,CAAC,QAAQ,SAAS,MAAM,EAC7B,KAAK,CAAC,SAAS,SAAS,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC,EACvD,sBAAsB,SAAS,SAAS,CAAC,qBAAqB,CAAC,EAC/D,qBAAqB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACxD,kBAAkB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACrD,oBAAoB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACvD,iBAAiB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EAEpD,aAAa,EAAE,oBAAoB,CACjC,mBAAmB,EACnB,QAAQ,EACR,SAAS,EACT,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,8BAA8B,CAC5B,mBAAmB,EACnB,6BAA6B,CAAC,sBAAsB,CAAC,EACrD,qBAAqB,EACrB,kBAAkB,CACnB,EACD,8BAA8B,CAC5B,mBAAmB,EACnB,6BAA6B,CAAC,sBAAsB,CAAC,EACrD,oBAAoB,EACpB,iBAAiB,CAClB,CACF,GAsJI,cAAc,CACjB,mBAAmB,EACnB,QAAQ,EACR,SAAS,EACT,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,CACnB,CACF"}

package/dist/src/lib/abilityCore/vincentAbility.js

@@ -0,0 +1,162 @@
+"use strict";
+// src/lib/abilityCore/vincentAbility.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createVincentAbility = createVincentAbility;
+const zod_1 = require("zod");
+const assertSupportedAbilityVersion_1 = require("../assertSupportedAbilityVersion");
+const constants_1 = require("../constants");
+const utils_1 = require("../utils");
+const abilityContext_1 = require("./abilityConfig/context/abilityContext");
+const resultCreators_1 = require("./helpers/resultCreators");
+const typeGuards_1 = require("./helpers/typeGuards");
+const zod_2 = require("./helpers/zod");
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * The `createVincentAbility()` method is used to define an ability'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.
+ *
+ *```typescript
+ * const exampleSimpleAbility = createVincentAbility({
+ *     packageName: '@lit-protocol/yesability@1.0.0',
+ *     abilityDescription: 'Yes Ability description',
+ *     abilityParamsSchema: testSchema,
+ *     supportedPolicies: supportedPoliciesForAbility([testPolicy]),
+ *
+ *     precheck: async (params, { succeed, fail }) => {
+ *       // Should allow succeed() with no arguments
+ *       succeed();
+ *
+ *       // Should allow fail() with string error
+ *       fail('Error message');
+ *
+ *       // @ts-expect-error - Should not allow succeed() with arguments when no schema
+ *       succeed({ message: 'test' });
+ *
+ *       // @ts-expect-error - Should not allow fail() with object when no schema
+ *       fail({ error: 'test' });
+ *
+ *       return succeed();
+ *     },
+ *
+ *     execute: async (params, { succeed }) => {
+ *       // Should allow succeed() with no arguments
+ *       succeed();
+ *
+ *       // @ts-expect-error - Should not allow succeed() with arguments when no schema
+ *       return succeed({ data: 'test' });
+ *     },
+ *   });
+ * ```
+ *
+ * @typeParam AbilityParamsSchema {@removeTypeParameterCompletely}
+ * @typeParam PkgNames {@removeTypeParameterCompletely}
+ * @typeParam PolicyMap {@removeTypeParameterCompletely}
+ * @typeParam PolicyMapByPackageName {@removeTypeParameterCompletely}
+ * @typeParam PrecheckSuccessSchema {@removeTypeParameterCompletely}
+ * @typeParam PrecheckFailSchema {@removeTypeParameterCompletely}
+ * @typeParam ExecuteSuccessSchema {@removeTypeParameterCompletely}
+ * @typeParam ExecuteFailSchema {@removeTypeParameterCompletely}
+ *
+ * @category API Methods
+ */
+function createVincentAbility(AbilityConfig) {
+    const { policyByPackageName, policyByIpfsCid } = AbilityConfig.supportedPolicies;
+    for (const policyId in policyByIpfsCid) {
+        const policy = policyByIpfsCid[policyId];
+        const { vincentAbilityApiVersion } = policy;
+        (0, assertSupportedAbilityVersion_1.assertSupportedAbilityVersion)(vincentAbilityApiVersion);
+    }
+    const executeSuccessSchema = (AbilityConfig.executeSuccessSchema ??
+        zod_1.z.undefined());
+    const executeFailSchema = (AbilityConfig.executeFailSchema ?? zod_1.z.undefined());
+    const execute = async ({ abilityParams }, baseAbilityContext) => {
+        try {
+            const context = (0, abilityContext_1.createExecutionAbilityContext)({
+                baseContext: baseAbilityContext,
+                policiesByPackageName: policyByPackageName,
+            });
+            const parsedAbilityParams = (0, zod_2.validateOrFail)(abilityParams, AbilityConfig.abilityParamsSchema, 'execute', 'input');
+            if ((0, typeGuards_1.isAbilityFailureResult)(parsedAbilityParams)) {
+                // In this case, we have an invalid input to the ability -- return { success: fail, runtimeError, schemaValidationError }
+                return parsedAbilityParams;
+            }
+            const result = await AbilityConfig.execute({ abilityParams: parsedAbilityParams }, {
+                ...context,
+                policiesContext: { ...context.policiesContext, allow: true },
+            });
+            console.log('AbilityConfig execute result', JSON.stringify(result, utils_1.bigintReplacer));
+            const { schemaToUse } = (0, zod_2.getSchemaForAbilityResult)({
+                value: result,
+                successResultSchema: executeSuccessSchema,
+                failureResultSchema: executeFailSchema,
+            });
+            const resultOrFailure = (0, zod_2.validateOrFail)(result.result, schemaToUse, 'execute', 'output');
+            if ((0, typeGuards_1.isAbilityFailureResult)(resultOrFailure)) {
+                return resultOrFailure;
+            }
+            // We parsed the result -- it may be a success or a failure; return appropriately.
+            if ((0, typeGuards_1.isAbilityFailureResult)(result)) {
+                return (0, resultCreators_1.wrapFailure)(resultOrFailure);
+            }
+            return (0, resultCreators_1.wrapSuccess)(resultOrFailure);
+        }
+        catch (err) {
+            return (0, resultCreators_1.wrapNoResultFailure)(err instanceof Error ? err.message : 'Unknown error');
+        }
+    };
+    const precheckSuccessSchema = (AbilityConfig.precheckSuccessSchema ??
+        zod_1.z.undefined());
+    const precheckFailSchema = (AbilityConfig.precheckFailSchema ??
+        zod_1.z.undefined());
+    const { precheck: precheckFn } = AbilityConfig;
+    const precheck = precheckFn
+        ? (async ({ abilityParams }, baseAbilityContext) => {
+            try {
+                const context = (0, abilityContext_1.createPrecheckAbilityContext)({
+                    baseContext: baseAbilityContext,
+                });
+                const parsedAbilityParams = (0, zod_2.validateOrFail)(abilityParams, AbilityConfig.abilityParamsSchema, 'precheck', 'input');
+                if ((0, typeGuards_1.isAbilityFailureResult)(parsedAbilityParams)) {
+                    return parsedAbilityParams;
+                }
+                const result = await precheckFn({ abilityParams }, context);
+                console.log('AbilityConfig precheck result', JSON.stringify(result, utils_1.bigintReplacer));
+                const { schemaToUse } = (0, zod_2.getSchemaForAbilityResult)({
+                    value: result,
+                    successResultSchema: precheckSuccessSchema,
+                    failureResultSchema: precheckFailSchema,
+                });
+                const resultOrFailure = (0, zod_2.validateOrFail)(result.result, schemaToUse, 'precheck', 'output');
+                if ((0, typeGuards_1.isAbilityFailureResult)(resultOrFailure)) {
+                    return resultOrFailure;
+                }
+                // We parsed the result successfully -- it may be a success or a failure, return appropriately
+                if ((0, typeGuards_1.isAbilityFailureResult)(result)) {
+                    return (0, resultCreators_1.wrapFailure)(resultOrFailure, result.runtimeError);
+                }
+                return (0, resultCreators_1.wrapSuccess)(resultOrFailure);
+            }
+            catch (err) {
+                return (0, resultCreators_1.wrapNoResultFailure)(err instanceof Error ? err.message : 'Unknown error');
+            }
+        })
+        : undefined;
+    return {
+        packageName: AbilityConfig.packageName,
+        vincentAbilityApiVersion: constants_1.VINCENT_TOOL_API_VERSION,
+        abilityDescription: AbilityConfig.abilityDescription,
+        execute,
+        precheck,
+        supportedPolicies: AbilityConfig.supportedPolicies,
+        policyByPackageName,
+        abilityParamsSchema: AbilityConfig.abilityParamsSchema,
+        /** @hidden */
+        __schemaTypes: {
+            precheckSuccessSchema: AbilityConfig.precheckSuccessSchema,
+            precheckFailSchema: AbilityConfig.precheckFailSchema,
+            executeSuccessSchema: AbilityConfig.executeSuccessSchema,
+            executeFailSchema: AbilityConfig.executeFailSchema,
+        },
+    };
+}
+//# sourceMappingURL=vincentAbility.js.map

package/dist/src/lib/abilityCore/vincentAbility.js.map

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

package/dist/src/lib/assertSupportedAbilityVersion.d.ts

@@ -0,0 +1,2 @@
+export declare function assertSupportedAbilityVersion(abilityVersionSemver: string | undefined): asserts abilityVersionSemver is string;
+//# sourceMappingURL=assertSupportedAbilityVersion.d.ts.map

package/dist/src/lib/assertSupportedAbilityVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertSupportedAbilityVersion.d.ts","sourceRoot":"","sources":["../../../src/lib/assertSupportedAbilityVersion.ts"],"names":[],"mappings":"AAIA,wBAAgB,6BAA6B,CAC3C,oBAAoB,EAAE,MAAM,GAAG,SAAS,GACvC,OAAO,CAAC,oBAAoB,IAAI,MAAM,CAWxC"}

package/dist/src/lib/assertSupportedAbilityVersion.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertSupportedAbilityVersion = assertSupportedAbilityVersion;
+const semver_1 = require("semver");
+const constants_1 = require("./constants");
+function assertSupportedAbilityVersion(abilityVersionSemver) {
+    if (!abilityVersionSemver) {
+        throw new Error('Ability version is required');
+    }
+    // Check if the ability's API version has the same major version as the current API version
+    if ((0, semver_1.major)(abilityVersionSemver) !== (0, semver_1.major)(constants_1.VINCENT_TOOL_API_VERSION)) {
+        throw new Error(`Ability version ${abilityVersionSemver} is not supported. Current version: ${constants_1.VINCENT_TOOL_API_VERSION}. Major versions must match.`);
+    }
+}
+//# sourceMappingURL=assertSupportedAbilityVersion.js.map

package/dist/src/lib/assertSupportedAbilityVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertSupportedAbilityVersion.js","sourceRoot":"","sources":["../../../src/lib/assertSupportedAbilityVersion.ts"],"names":[],"mappings":";;AAIA,sEAaC;AAjBD,mCAA+B;AAE/B,2CAAuD;AAEvD,SAAgB,6BAA6B,CAC3C,oBAAwC;IAExC,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,2FAA2F;IAC3F,IAAI,IAAA,cAAK,EAAC,oBAAoB,CAAC,KAAK,IAAA,cAAK,EAAC,oCAAwB,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CACb,mBAAmB,oBAAoB,uCAAuC,oCAAwB,8BAA8B,CACrI,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/lib/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const VINCENT_TOOL_API_VERSION: "2.0.0";
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/lib/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/lib/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,EAAG,OAAgB,CAAC"}

package/dist/src/lib/constants.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VINCENT_TOOL_API_VERSION = void 0;
+exports.VINCENT_TOOL_API_VERSION = '2.0.0';
+//# sourceMappingURL=constants.js.map

package/dist/src/lib/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/lib/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,wBAAwB,GAAG,OAAgB,CAAC"}

package/dist/src/lib/handlers/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const LIT_DATIL_PUBKEY_ROUTER_ADDRESS = "0xF182d6bEf16Ba77e69372dD096D8B70Bc3d5B475";
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/lib/handlers/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/lib/handlers/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,+BAA+B,+CAA+C,CAAC"}

package/dist/src/lib/handlers/constants.js

@@ -0,0 +1,6 @@
+"use strict";
+// src/lib/handlers/constants.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIT_DATIL_PUBKEY_ROUTER_ADDRESS = void 0;
+exports.LIT_DATIL_PUBKEY_ROUTER_ADDRESS = '0xF182d6bEf16Ba77e69372dD096D8B70Bc3d5B475';
+//# sourceMappingURL=constants.js.map

package/dist/src/lib/handlers/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/lib/handlers/constants.ts"],"names":[],"mappings":";AAAA,gCAAgC;;;AAEnB,QAAA,+BAA+B,GAAG,4CAA4C,CAAC"}

package/dist/src/lib/handlers/evaluatePolicies.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import type { AbilityPolicyMap } from '../abilityCore/helpers';
+import type { ValidatedPolicyMap } from '../abilityCore/helpers/validatePolicies';
+import type { BaseContext, PolicyEvaluationResultContext, VincentAbility } from '../types';
+export declare function evaluatePolicies<AbilityParamsSchema extends z.ZodType, PolicyMap extends AbilityPolicyMap<any, any>, PoliciesByPackageName extends PolicyMap['policyByPackageName']>({ vincentAbility, context, validatedPolicies, vincentAbilityApiVersion, }: {
+    vincentAbility: VincentAbility<AbilityParamsSchema, keyof PoliciesByPackageName & string, PolicyMap, PoliciesByPackageName, any, any, any, any>;
+    context: BaseContext;
+    validatedPolicies: ValidatedPolicyMap<z.infer<AbilityParamsSchema>, PoliciesByPackageName>;
+    vincentAbilityApiVersion: string;
+}): Promise<PolicyEvaluationResultContext<PoliciesByPackageName>>;
+//# sourceMappingURL=evaluatePolicies.d.ts.map

package/dist/src/lib/handlers/evaluatePolicies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluatePolicies.d.ts","sourceRoot":"","sources":["../../../../src/lib/handlers/evaluatePolicies.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,KAAK,EACV,WAAW,EACX,6BAA6B,EAK7B,cAAc,EAEf,MAAM,UAAU,CAAC;AAyBlB,wBAAsB,gBAAgB,CACpC,mBAAmB,SAAS,CAAC,CAAC,OAAO,EACrC,SAAS,SAAS,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,EAC5C,qBAAqB,SAAS,SAAS,CAAC,qBAAqB,CAAC,EAC9D,EACA,cAAc,EACd,OAAO,EACP,iBAAiB,EACjB,wBAAwB,GACzB,EAAE;IACD,cAAc,EAAE,cAAc,CAC5B,mBAAmB,EACnB,MAAM,qBAAqB,GAAG,MAAM,EACpC,SAAS,EACT,qBAAqB,EACrB,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,CACJ,CAAC;IACF,OAAO,EAAE,WAAW,CAAC;IACrB,iBAAiB,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,qBAAqB,CAAC,CAAC;IAC3F,wBAAwB,EAAE,MAAM,CAAC;CAClC,GAAG,OAAO,CAAC,6BAA6B,CAAC,qBAAqB,CAAC,CAAC,CAmEhE"}

package/dist/src/lib/handlers/evaluatePolicies.js

@@ -0,0 +1,110 @@
+"use strict";
+// src/lib/handlers/evaluatePolicies.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluatePolicies = evaluatePolicies;
+const zod_1 = require("zod");
+const helpers_1 = require("../policyCore/helpers");
+const resultCreators_1 = require("../policyCore/helpers/resultCreators");
+/* eslint-disable @typescript-eslint/no-explicit-any */
+async function evaluatePolicies({ vincentAbility, context, validatedPolicies, vincentAbilityApiVersion, }) {
+    const evaluatedPolicies = [];
+    let policyDeniedResult = undefined;
+    const rawAllowedPolicies = {};
+    for (const { policyPackageName, abilityPolicyParams } of validatedPolicies) {
+        evaluatedPolicies.push(policyPackageName);
+        const policy = vincentAbility.supportedPolicies.policyByPackageName[policyPackageName];
+        try {
+            const litActionResponse = await Lit.Actions.call({
+                ipfsId: policy.ipfsCid,
+                params: {
+                    abilityParams: abilityPolicyParams,
+                    context: {
+                        abilityIpfsCid: context.abilityIpfsCid,
+                        delegatorPkpEthAddress: context.delegation.delegatorPkpInfo.ethAddress,
+                    },
+                    vincentAbilityApiVersion,
+                },
+            });
+            console.log(`evaluated ${String(policyPackageName)} policy, result is:`, JSON.stringify(litActionResponse));
+            const result = parseAndValidateEvaluateResult({
+                litActionResponse,
+                vincentPolicy: policy.vincentPolicy,
+            });
+            if ((0, helpers_1.isPolicyDenyResponse)(result)) {
+                policyDeniedResult = {
+                    ...result,
+                    packageName: policyPackageName,
+                };
+            }
+            else {
+                rawAllowedPolicies[policyPackageName] = {
+                    result: result.result,
+                };
+            }
+        }
+        catch (err) {
+            const denyResult = (0, helpers_1.createDenyResult)({
+                runtimeError: err instanceof Error ? err.message : 'Unknown error',
+            });
+            policyDeniedResult = { ...denyResult, packageName: policyPackageName };
+        }
+    }
+    if (policyDeniedResult) {
+        return (0, resultCreators_1.createDenyEvaluationResult)({
+            allowedPolicies: rawAllowedPolicies,
+            evaluatedPolicies,
+            deniedPolicy: policyDeniedResult,
+        });
+    }
+    return (0, resultCreators_1.createAllowEvaluationResult)({
+        evaluatedPolicies,
+        allowedPolicies: rawAllowedPolicies,
+    });
+}
+function parseAndValidateEvaluateResult({ litActionResponse, vincentPolicy, }) {
+    let parsedLitActionResponse;
+    try {
+        parsedLitActionResponse = JSON.parse(litActionResponse);
+    }
+    catch (error) {
+        console.log('rawLitActionResponse (parsePolicyExecutionResult)', litActionResponse);
+        throw new Error(`Failed to JSON parse Lit Action Response: ${error instanceof Error ? error.message : String(error)}. rawLitActionResponse in request logs (parsePolicyExecutionResult)`);
+    }
+    try {
+        console.log('parseAndValidateEvaluateResult', JSON.stringify(parsedLitActionResponse));
+        if ((0, helpers_1.isPolicyDenyResponse)(parsedLitActionResponse) &&
+            (parsedLitActionResponse.schemaValidationError || parsedLitActionResponse.runtimeError)) {
+            console.log('parsedLitActionResponse is a deny response with a runtime error or schema validation error; skipping schema validation');
+            return parsedLitActionResponse;
+        }
+        if (!(0, helpers_1.isPolicyResponse)(parsedLitActionResponse)) {
+            throw new Error(`Invalid response from policy: ${JSON.stringify(parsedLitActionResponse)}`);
+        }
+        const { schemaToUse, parsedType } = (0, helpers_1.getSchemaForPolicyResponseResult)({
+            value: parsedLitActionResponse,
+            denyResultSchema: vincentPolicy.evalDenyResultSchema || zod_1.z.undefined(),
+            allowResultSchema: vincentPolicy.evalAllowResultSchema || zod_1.z.undefined(),
+        });
+        console.log('parsedType', parsedType);
+        const parsedResult = (0, helpers_1.validateOrDeny)(parsedLitActionResponse.result, schemaToUse, 'evaluate', 'output');
+        if ((0, helpers_1.isPolicyDenyResponse)(parsedResult)) {
+            // Failed schema parsing!
+            return parsedResult;
+        }
+        if ((0, helpers_1.isPolicyDenyResponse)(parsedLitActionResponse)) {
+            return (0, helpers_1.createDenyResult)({
+                runtimeError: parsedLitActionResponse.runtimeError,
+                schemaValidationError: parsedLitActionResponse.schemaValidationError,
+                result: parsedResult,
+            });
+        }
+        return (0, resultCreators_1.createAllowResult)({
+            result: parsedResult,
+        });
+    }
+    catch (err) {
+        console.log('parseAndValidateEvaluateResult error; returning noResultDeny', err.message, err.stack);
+        return (0, resultCreators_1.returnNoResultDeny)(err instanceof Error ? err.message : 'Unknown error');
+    }
+}
+//# sourceMappingURL=evaluatePolicies.js.map

package/dist/src/lib/handlers/evaluatePolicies.js.map

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

package/dist/src/lib/handlers/vincentAbilityHandler.d.ts

@@ -0,0 +1,15 @@
+import type { z } from 'zod';
+import type { AbilityPolicyMap } from '../abilityCore/helpers';
+import type { BaseContext, PolicyEvaluationResultContext, AbilityConsumerContext, AbilityExecutionPolicyContext, VincentAbility } from '../types';
+export declare function createAbilityExecutionContext<AbilityParamsSchema extends z.ZodType, PkgNames extends string, PolicyMap extends AbilityPolicyMap<any, PkgNames>, PoliciesByPackageName extends PolicyMap['policyByPackageName']>({ vincentAbility, policyEvaluationResults, baseContext, }: {
+    vincentAbility: VincentAbility<AbilityParamsSchema, PkgNames, PolicyMap, PoliciesByPackageName, any, any, any, any>;
+    policyEvaluationResults: PolicyEvaluationResultContext<PoliciesByPackageName>;
+    baseContext: BaseContext;
+}): AbilityExecutionPolicyContext<PoliciesByPackageName>;
+/** @hidden */
+export declare const vincentAbilityHandler: <AbilityParamsSchema extends z.ZodType, PkgNames extends string, PolicyMap extends AbilityPolicyMap<any, PkgNames>, PoliciesByPackageName extends PolicyMap["policyByPackageName"]>({ vincentAbility, abilityParams, context, }: {
+    vincentAbility: VincentAbility<AbilityParamsSchema, PkgNames, PolicyMap, PoliciesByPackageName, any, any, any, any>;
+    context: AbilityConsumerContext;
+    abilityParams: Record<string, unknown>;
+}) => () => Promise<void>;
+//# sourceMappingURL=vincentAbilityHandler.d.ts.map

package/dist/src/lib/handlers/vincentAbilityHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vincentAbilityHandler.d.ts","sourceRoot":"","sources":["../../../../src/lib/handlers/vincentAbilityHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAK7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EACV,WAAW,EACX,6BAA6B,EAC7B,sBAAsB,EACtB,6BAA6B,EAC7B,cAAc,EACf,MAAM,UAAU,CAAC;AA4BlB,wBAAgB,6BAA6B,CAC3C,mBAAmB,SAAS,CAAC,CAAC,OAAO,EACrC,QAAQ,SAAS,MAAM,EACvB,SAAS,SAAS,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC,EACjD,qBAAqB,SAAS,SAAS,CAAC,qBAAqB,CAAC,EAC9D,EACA,cAAc,EACd,uBAAuB,EACvB,WAAW,GACZ,EAAE;IACD,cAAc,EAAE,cAAc,CAC5B,mBAAmB,EACnB,QAAQ,EACR,SAAS,EACT,qBAAqB,EACrB,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,CACJ,CAAC;IACF,uBAAuB,EAAE,6BAA6B,CAAC,qBAAqB,CAAC,CAAC;IAC9E,WAAW,EAAE,WAAW,CAAC;CAC1B,GAAG,6BAA6B,CAAC,qBAAqB,CAAC,CA6CvD;AAED,cAAc;AACd,eAAO,MAAM,qBAAqB,GAChC,mBAAmB,SAAS,CAAC,CAAC,OAAO,EACrC,QAAQ,SAAS,MAAM,EACvB,SAAS,SAAS,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC,EACjD,qBAAqB,SAAS,SAAS,CAAC,qBAAqB,CAAC,EAC9D,6CAIC;IACD,cAAc,EAAE,cAAc,CAC5B,mBAAmB,EACnB,QAAQ,EACR,SAAS,EACT,qBAAqB,EACrB,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,CACJ,CAAC;IACF,OAAO,EAAE,sBAAsB,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,wBAwIA,CAAC"}