callman-mcp 0.1.0 → 0.2.0

package/dist/domain/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/domain/contracts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,eAAO,MAAM,kBAAkB,aAQ5B,CAAC;AAIJ,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0CiI,CAAC;AAElK,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOnC,CAAC;AAGF,eAAO,MAAM,oBAAoB;;;;;CAAgE,CAAC;AAElG,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcjC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIzE,eAAO,MAAM,qBAAqB,GAAI,SAAS,MAAM,EAAE,EAAE,MAAM,oBAAoB,EAAE,KAAG,MAAM,EAK7F,CAAC"}

package/dist/domain/contracts.js

@@ -0,0 +1,90 @@
+import { SCENARIO_CONTRACT_FORMATS } from "callman-core";
+import { z } from "zod";
+import { strictObject } from "../lib/strict.js";
+// Contract checks on a saved request — the same two documents the desktop's
+// Contracts tab edits and every runner (desktop, CLI, run_request /
+// run_collection) evaluates after the response:
+//   * contract RULES — "the field at `path` must satisfy `rules`"
+//   * a DATA CONTRACT — rows of inputs ({{data.<column>}}), each with its own
+//     expected status and field assertions; the request runs once per row.
+// The rule vocabulary mirrors the backend's contractRuleRulesSchema exactly
+// (strict here, so a misspelled rule is an error instead of a no-op).
+// `users[].id`, `data.items[0].price`, `[].name`, `response.status`,
+// `response.headers.content-type` — same grammar the backend enforces.
+const CONTRACT_PATH = /^(\[\d*\]|[A-Za-z0-9_$-]+(\[\d*\])?)(\.(\[\d*\]|[A-Za-z0-9_$-]+(\[\d*\])?))*$/;
+export const contractPathSchema = z
+    .string()
+    .trim()
+    .min(1)
+    .max(500)
+    .regex(CONTRACT_PATH, "Invalid contract path — use dots and [] like users[].id, items[0].price or response.status")
+    .describe("Field path. Body paths: user.id, users[].id (every element), items[0].price (one element), [].name (top-level array). `response.status`, `response.headers.<name>` and `response.duration` check the HTTP envelope instead of the body.");
+const nonNegativeInt = z.number().int().min(0);
+export const contractRulesSchema = strictObject({
+    required: z.boolean().optional().describe("The field must exist"),
+    type: z.enum(["string", "number", "boolean", "object", "array", "null"]).optional(),
+    equals: z.union([z.string().max(2000), z.number(), z.boolean()]).optional().describe("Exact value (honours caseSensitive for strings)"),
+    notEmpty: z.boolean().optional().describe("Not \"\", [], {} or null"),
+    // numbers
+    min: z.number().optional(),
+    max: z.number().optional(),
+    greaterThan: z.number().optional(),
+    lessThan: z.number().optional(),
+    integer: z.boolean().optional(),
+    positive: z.boolean().optional(),
+    negative: z.boolean().optional(),
+    nonZero: z.boolean().optional(),
+    // strings
+    minLength: nonNegativeInt.optional(),
+    maxLength: nonNegativeInt.optional(),
+    pattern: z.string().max(1000).optional().describe("JavaScript regular expression the string must match"),
+    contains: z.string().max(1000).optional(),
+    notContains: z.string().max(1000).optional(),
+    startsWith: z.string().max(1000).optional(),
+    endsWith: z.string().max(1000).optional(),
+    caseSensitive: z.boolean().optional().describe("For equals/contains/startsWith/endsWith (default true)"),
+    enumValues: z.array(z.union([z.string().max(500), z.number()])).min(1).max(100).optional().describe("The value must be one of these"),
+    format: z.enum(SCENARIO_CONTRACT_FORMATS).optional().describe(`String format: ${SCENARIO_CONTRACT_FORMATS.join(", ")}`),
+    // arrays
+    minItems: nonNegativeInt.optional(),
+    maxItems: nonNegativeInt.optional(),
+    sorted: strictObject({ order: z.enum(["asc", "desc"]), field: z.string().max(200).optional().describe("Sort key for arrays of objects") }, "sorted field").optional(),
+    unique: strictObject({ mode: z.enum(["whole", "byField"]), fields: z.array(z.string().max(200)).max(50).optional().describe("Required with mode byField") }, "unique field").optional(),
+    // objects
+    requiredKeys: z.array(z.string().max(200)).max(100).optional(),
+    forbiddenKeys: z.array(z.string().max(200)).max(100).optional(),
+    minProperties: nonNegativeInt.optional(),
+    maxProperties: nonNegativeInt.optional(),
+    strictSchema: z.boolean().optional().describe("Objects: no keys beyond requiredKeys"),
+}, "contract rule").refine((rules) => Object.values(rules).some((value) => value !== undefined), { message: "Give at least one rule (e.g. { required: true, type: \"string\" })" });
+export const contractRuleInputSchema = strictObject({
+    path: contractPathSchema,
+    rules: contractRulesSchema,
+    enabled: z.boolean().optional().describe("Default true"),
+}, "contract rule field");
+// Data-driven contract — backend caps (DATA_CONTRACT_*).
+export const DATA_CONTRACT_LIMITS = { rows: 20, columns: 8, assertions: 12, cell: 4096 };
+export const dataContractRowSchema = strictObject({
+    data: z
+        .record(z.string().max(DATA_CONTRACT_LIMITS.cell))
+        .default({})
+        .describe("Column → value for this row; the request reads them as {{data.<column>}}"),
+    expectedStatus: z.number().int().min(100).max(599).optional().describe("HTTP status this row must return"),
+    assertions: z
+        .array(strictObject({ path: contractPathSchema, rules: contractRulesSchema, enabled: z.boolean().optional() }, "row assertion field"))
+        .max(DATA_CONTRACT_LIMITS.assertions)
+        .default([])
+        .describe(`Field checks for this row (≤ ${DATA_CONTRACT_LIMITS.assertions})`),
+}, "data contract row field");
+// Every {{data.x}} a row set needs must be a declared column — catch the
+// typo before the run reports an empty value.
+export const undeclaredDataColumns = (columns, rows) => {
+    const declared = new Set(columns);
+    const used = new Set();
+    for (const row of rows)
+        for (const key of Object.keys(row.data))
+            if (!declared.has(key))
+                used.add(key);
+    return [...used];
+};
+//# sourceMappingURL=contracts.js.map

package/dist/domain/contracts.js.map

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