@peac/control 0.9.18

package/dist/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8DxB;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;EAWjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAK3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ7B,CAAC;AAOH,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EAKjB,kBAAkB,IAAI,uBAAuB,GAC9C,MAAM,cAAc,CAAC"}

package/dist/validators.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * PEAC Control Abstraction Layer (CAL) Validators
+ *
+ * Validation logic for control blocks and mandates.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChainControlBlockSchema = exports.ControlStepSchema = exports.ControlDecisionSchema = exports.ControlLicensingModeSchema = exports.ControlPurposeSchema = exports.ControlStateSchema = exports.ControlBlockSchema = exports.ConstraintSchema = exports.CombinedConstraintSchema = exports.BudgetConstraintSchema = exports.UsageConstraintSchema = exports.TemporalConstraintSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Base temporal mandate schema (without refinements)
+ */
+const TemporalConstraintBaseSchema = zod_1.z.object({
+    type: zod_1.z.literal('temporal'),
+    valid_from: zod_1.z.number().int().positive().optional(),
+    valid_until: zod_1.z.number().int().positive().optional(),
+    duration: zod_1.z.number().int().positive().optional(),
+});
+/**
+ * Base usage mandate schema (without refinements)
+ */
+const UsageConstraintBaseSchema = zod_1.z.object({
+    type: zod_1.z.literal('usage'),
+    max_uses: zod_1.z.number().int().positive(),
+    current_uses: zod_1.z.number().int().nonnegative().optional(),
+    window: zod_1.z.number().int().positive().optional(),
+});
+/**
+ * Base budget mandate schema (without refinements)
+ */
+const BudgetConstraintBaseSchema = zod_1.z.object({
+    type: zod_1.z.literal('budget'),
+    max_amount: zod_1.z.number().int().positive(),
+    current_amount: zod_1.z.number().int().nonnegative().optional(),
+    window: zod_1.z.number().int().positive().optional(),
+    currency: zod_1.z.string().length(3).toUpperCase(),
+});
+/**
+ * Base combined mandate schema (without refinements)
+ */
+const CombinedConstraintBaseSchema = zod_1.z.object({
+    type: zod_1.z.literal('combined'),
+    temporal: zod_1.z
+        .object({
+        valid_from: zod_1.z.number().int().positive().optional(),
+        valid_until: zod_1.z.number().int().positive().optional(),
+        duration: zod_1.z.number().int().positive().optional(),
+    })
+        .optional(),
+    usage: zod_1.z
+        .object({
+        max_uses: zod_1.z.number().int().positive(),
+        current_uses: zod_1.z.number().int().nonnegative().optional(),
+        window: zod_1.z.number().int().positive().optional(),
+    })
+        .optional(),
+    budget: zod_1.z
+        .object({
+        max_amount: zod_1.z.number().int().positive(),
+        current_amount: zod_1.z.number().int().nonnegative().optional(),
+        window: zod_1.z.number().int().positive().optional(),
+        currency: zod_1.z.string().length(3).toUpperCase(),
+    })
+        .optional(),
+});
+/**
+ * Temporal mandate schema (with validation)
+ */
+exports.TemporalConstraintSchema = TemporalConstraintBaseSchema.refine((data) => {
+    // At least one temporal constraint must be specified
+    return (data.valid_from !== undefined || data.valid_until !== undefined || data.duration !== undefined);
+}, {
+    message: 'At least one temporal constraint (valid_from, valid_until, duration) must be specified',
+}).refine((data) => {
+    // If both valid_from and valid_until are specified, valid_until must be after valid_from
+    if (data.valid_from !== undefined && data.valid_until !== undefined) {
+        return data.valid_until > data.valid_from;
+    }
+    return true;
+}, {
+    message: 'valid_until must be after valid_from',
+});
+/**
+ * Usage mandate schema (with validation)
+ */
+exports.UsageConstraintSchema = UsageConstraintBaseSchema.refine((data) => {
+    // current_uses cannot exceed max_uses
+    if (data.current_uses !== undefined) {
+        return data.current_uses <= data.max_uses;
+    }
+    return true;
+}, {
+    message: 'current_uses cannot exceed max_uses',
+});
+/**
+ * Budget mandate schema (with validation)
+ */
+exports.BudgetConstraintSchema = BudgetConstraintBaseSchema.refine((data) => {
+    // current_amount cannot exceed max_amount
+    if (data.current_amount !== undefined) {
+        return data.current_amount <= data.max_amount;
+    }
+    return true;
+}, {
+    message: 'current_amount cannot exceed max_amount',
+});
+/**
+ * Combined mandate schema (with validation)
+ */
+exports.CombinedConstraintSchema = CombinedConstraintBaseSchema.refine((data) => {
+    // At least one mandate type must be specified
+    return data.temporal !== undefined || data.usage !== undefined || data.budget !== undefined;
+}, {
+    message: 'At least one mandate (temporal, usage, budget) must be specified in combined type',
+});
+/**
+ * Constraint schema (discriminated union using base schemas)
+ */
+exports.ConstraintSchema = zod_1.z.discriminatedUnion('type', [
+    TemporalConstraintBaseSchema,
+    UsageConstraintBaseSchema,
+    BudgetConstraintBaseSchema,
+    CombinedConstraintBaseSchema,
+]);
+/**
+ * Control block schema
+ */
+exports.ControlBlockSchema = zod_1.z.object({
+    mandate: exports.ConstraintSchema,
+    scope: zod_1.z.string().url().optional(),
+    metadata: zod_1.z.record(zod_1.z.unknown()).optional(),
+});
+/**
+ * Control state schema
+ */
+exports.ControlStateSchema = zod_1.z.object({
+    receipt_id: zod_1.z.string().uuid(),
+    constraint: exports.ConstraintSchema,
+    usage_count: zod_1.z.number().int().nonnegative().optional(),
+    spent_amount: zod_1.z.number().int().nonnegative().optional(),
+    first_use: zod_1.z.number().int().positive().optional(),
+    last_use: zod_1.z.number().int().positive().optional(),
+    metadata: zod_1.z.record(zod_1.z.unknown()).optional(),
+});
+// -----------------------------------------------------------------------------
+// CAL Semantic Validators (v0.9.16+)
+// Re-exported from @peac/schema for convenience
+// -----------------------------------------------------------------------------
+var schema_1 = require("@peac/schema");
+Object.defineProperty(exports, "ControlPurposeSchema", { enumerable: true, get: function () { return schema_1.ControlPurposeSchema; } });
+Object.defineProperty(exports, "ControlLicensingModeSchema", { enumerable: true, get: function () { return schema_1.ControlLicensingModeSchema; } });
+Object.defineProperty(exports, "ControlDecisionSchema", { enumerable: true, get: function () { return schema_1.ControlDecisionSchema; } });
+Object.defineProperty(exports, "ControlStepSchema", { enumerable: true, get: function () { return schema_1.ControlStepSchema; } });
+// Note: ControlBlockSchema from @peac/schema validates chain-based governance blocks
+// (chain/decision/combinator), while the ControlBlockSchema above validates
+// constraint-based blocks (mandate/scope/metadata). We export the chain-based
+// one with a distinct name to avoid confusion.
+Object.defineProperty(exports, "ChainControlBlockSchema", { enumerable: true, get: function () { return schema_1.ControlBlockSchema; } });
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@peac/control",
+  "version": "0.9.18",
+  "description": "PEAC Protocol Control - control engine interfaces and validation",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/peacprotocol/peac.git",
+    "directory": "packages/control"
+  },
+  "author": "jithinraj <7850727+jithinraj@users.noreply.github.com>",
+  "license": "Apache-2.0",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@peac/schema": "workspace:*",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.1.0"
+  }
+}