@cotrrackpro-dev/sdk 0.1.0

package/dist/nocode/validate.js

@@ -0,0 +1,136 @@
+import { isAllowedOp } from "./simpleOps.js";
+function str(v) {
+    return typeof v === "string" ? v : "";
+}
+/** Detect a cycle in the directed node graph (DFS three-colour). */
+function findCycle(nodes, edges) {
+    const adj = new Map();
+    for (const n of nodes)
+        adj.set(n.id, []);
+    for (const e of edges) {
+        const list = adj.get(e.source);
+        if (list && adj.has(e.target))
+            list.push(e.target);
+    }
+    const state = new Map(); // 0=unseen 1=in-stack 2=done
+    const visit = (id) => {
+        state.set(id, 1);
+        for (const next of adj.get(id) ?? []) {
+            const s = state.get(next) ?? 0;
+            if (s === 1)
+                return true;
+            if (s === 0 && visit(next))
+                return true;
+        }
+        state.set(id, 2);
+        return false;
+    };
+    for (const n of nodes) {
+        if ((state.get(n.id) ?? 0) === 0 && visit(n.id))
+            return true;
+    }
+    return false;
+}
+export function validateApp(app) {
+    const errors = [];
+    const push = (path, message) => {
+        errors.push({ path, message });
+    };
+    if (!str(app.name).trim())
+        push("name", "An app name is required.");
+    // Guard the top-level shape before iterating it. The input is untrusted JSON,
+    // so a missing/mis-typed array must become a clear validation error — never a
+    // raw `undefined.forEach` crash from the very function meant to catch it.
+    const nodes = Array.isArray(app.nodes) ? app.nodes : [];
+    const variables = Array.isArray(app.variables) ? app.variables : [];
+    const edges = Array.isArray(app.edges) ? app.edges : [];
+    const mcp = Array.isArray(app.settings?.mcp) ? app.settings.mcp : [];
+    if (!Array.isArray(app.nodes))
+        push("nodes", "An app needs a `nodes` array.");
+    if (!Array.isArray(app.variables))
+        push("variables", "An app needs a `variables` array.");
+    if (!Array.isArray(app.edges))
+        push("edges", "An app needs an `edges` array.");
+    if (!app.settings || !Array.isArray(app.settings.mcp))
+        push("settings.mcp", "An app needs `settings.mcp` — the array of declared tools (use `[]` if none).");
+    // unique node ids
+    const ids = new Set();
+    nodes.forEach((n, i) => {
+        if (!str(n.id))
+            push(`nodes[${i}].id`, "A node id is required.");
+        else if (ids.has(n.id))
+            push(`nodes[${i}].id`, `Duplicate node id '${n.id}'.`);
+        ids.add(n.id);
+    });
+    // unique variable keys
+    const varKeys = new Set();
+    variables.forEach((v, i) => {
+        if (varKeys.has(v.key))
+            push(`variables[${i}].key`, `Duplicate variable '${v.key}'.`);
+        varKeys.add(v.key);
+    });
+    // edges reference existing nodes
+    edges.forEach((e, i) => {
+        if (!ids.has(e.source))
+            push(`edges[${i}].source`, `Edge source '${e.source}' is not a node.`);
+        if (!ids.has(e.target))
+            push(`edges[${i}].target`, `Edge target '${e.target}' is not a node.`);
+    });
+    // per-node-type rules
+    const declared = new Set(mcp.map((m) => `${m.serverId}::${m.toolName}`));
+    nodes.forEach((n, i) => {
+        if (n.type === "transform") {
+            const op = str(n.data.op);
+            if (!op)
+                push(`nodes[${i}].data.op`, "A transform node needs an `op`.");
+            else if (!isAllowedOp(op))
+                push(`nodes[${i}].data.op`, `Operation not permitted on-device: '${op}'. Use an mcpTool node.`);
+        }
+        if (n.type === "mcpTool") {
+            const serverId = str(n.data.serverId);
+            const toolName = str(n.data.toolName);
+            if (!serverId || !toolName)
+                push(`nodes[${i}].data`, "An mcpTool node needs `serverId` and `toolName`.");
+            else if (!declared.has(`${serverId}::${toolName}`))
+                push(`nodes[${i}].data`, `mcpTool '${serverId}/${toolName}' is not in settings.mcp (declare it to allow the call).`);
+        }
+    });
+    if (nodes.length && findCycle(nodes, edges))
+        push("edges", "The graph has a cycle; a no-code app must be acyclic.");
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Soft warnings that don't make an app invalid but usually signal a mistake — the
+ * core stays permissive (a variable can be seeded at run time) while still helping
+ * surface the common slip: a transform/condition whose `in` names a variable no
+ * step produces (a typo or a missing upstream step). Template ops read variables
+ * from their text, not `in`, so they're skipped. Pure; same shape as errors.
+ */
+export function appWarnings(app) {
+    const nodes = Array.isArray(app.nodes) ? app.nodes : [];
+    const produced = new Set();
+    for (const n of nodes) {
+        if (n.type === "input") {
+            const k = str(n.data.variable) || str(n.data.key);
+            if (k)
+                produced.add(k);
+        }
+        const out = str(n.data.out);
+        if (out)
+            produced.add(out);
+    }
+    const warnings = [];
+    nodes.forEach((n, i) => {
+        if (n.type !== "transform" && n.type !== "condition")
+            return;
+        if (str(n.data.op) === "template")
+            return;
+        const inKeys = Array.isArray(n.data.in) ? n.data.in.map(str) : [];
+        for (const k of inKeys) {
+            if (k && !produced.has(k))
+                warnings.push({ path: `nodes[${i}].data.in`, message: `Uses “${k}”, which no step produces — add a step that sets it, or check the spelling.` });
+        }
+    });
+    return warnings;
+}
+//# sourceMappingURL=validate.js.map

package/dist/nocode/validate.js.map

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

package/dist/params/codegen.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Node-only: compile a parameter set's JSON Schema into a TypeScript interface.
+ * Kept out of `core.ts` because it lazily imports `json-schema-to-typescript`.
+ * Shared by the CLI's `params types` and `sdk/scripts/gen-artifacts.ts` so the
+ * compile options live in exactly one place.
+ */
+import type { JsonSchema } from "./types.js";
+export declare function schemaToInterface(schema: JsonSchema | object, typeName: string): Promise<string>;

package/dist/params/codegen.js

@@ -0,0 +1,12 @@
+export async function schemaToInterface(schema, typeName) {
+    let compile;
+    try {
+        ({ compile } = await import("json-schema-to-typescript"));
+    }
+    catch {
+        throw new Error("TypeScript generation needs `json-schema-to-typescript` (npm i -D json-schema-to-typescript).");
+    }
+    const ts = await compile(schema, typeName, { bannerComment: "", additionalProperties: false });
+    return ts.trim();
+}
+//# sourceMappingURL=codegen.js.map

package/dist/params/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.js","sourceRoot":"","sources":["../../src/params/codegen.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAA2B,EAAE,QAAgB;IACnF,IAAI,OAAgE,CAAC;IACrE,IAAI,CAAC;QACH,CAAC,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,+FAA+F,CAAC,CAAC;IACnH,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,MAAgB,EAAE,QAAQ,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC;IACzG,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC;AACnB,CAAC"}

package/dist/params/convert.d.ts

@@ -0,0 +1,7 @@
+import { type JsonSchema, type ParamSet } from "./types.js";
+/** PascalCase a slug for use as a TypeScript interface name. */
+export declare function pascalCase(s: string): string;
+/** A parameter set → canonical JSON Schema (the saved, standards-compliant form). */
+export declare function fieldsToSchema(set: ParamSet): JsonSchema;
+/** Canonical JSON Schema → parameter set (the `--from` importer). Rejects out-of-subset features. */
+export declare function schemaToFields(schema: unknown): ParamSet;

package/dist/params/convert.js

@@ -0,0 +1,123 @@
+import { ParamError } from "./types.js";
+import { FIELD_TYPES } from "./fieldTypes.js";
+const JSON_SCHEMA_URI = "https://json-schema.org/draft/2020-12/schema";
+/** PascalCase a slug for use as a TypeScript interface name. */
+export function pascalCase(s) {
+    return s
+        .split(/[^a-zA-Z0-9]+/)
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join("");
+}
+/** A parameter set → canonical JSON Schema (the saved, standards-compliant form). */
+export function fieldsToSchema(set) {
+    const properties = {};
+    const required = [];
+    for (const f of [...set.fields].sort((a, b) => a.key.localeCompare(b.key))) {
+        const prop = { ...FIELD_TYPES[f.type].prop(f) };
+        if (f.label)
+            prop.title = f.label;
+        if (f.description)
+            prop.description = f.description;
+        if (prop.type === "string" && !prop.enum && !prop.format) {
+            if (f.minLength != null)
+                prop.minLength = f.minLength;
+            if (f.maxLength != null)
+                prop.maxLength = f.maxLength;
+        }
+        if (prop.type === "number" || prop.type === "integer") {
+            if (f.min != null)
+                prop.minimum = f.min;
+            if (f.max != null)
+                prop.maximum = f.max;
+        }
+        properties[f.key] = prop;
+        if (f.required)
+            required.push(f.key);
+    }
+    const schema = {
+        $schema: JSON_SCHEMA_URI,
+        type: "object",
+        title: set.title,
+        additionalProperties: false,
+        properties,
+    };
+    if (set.description)
+        schema.description = set.description;
+    if (required.length)
+        schema.required = required.sort();
+    schema["x-cotrackpro"] = { dataSensitivity: set.dataSensitivity };
+    return schema;
+}
+const UNSUPPORTED = ["$ref", "allOf", "anyOf", "oneOf", "not", "if", "then", "else", "patternProperties", "dependentSchemas"];
+/** Canonical JSON Schema → parameter set (the `--from` importer). Rejects out-of-subset features. */
+export function schemaToFields(schema) {
+    const s = schema;
+    if (!s || s.type !== "object" || typeof s.properties !== "object" || s.properties == null) {
+        throw new ParamError("Schema must be an object schema with a `properties` map.");
+    }
+    for (const bad of UNSUPPORTED) {
+        if (bad in s)
+            throw new ParamError(`Unsupported JSON Schema feature: \`${bad}\`. Use a flat object schema.`);
+    }
+    const requiredList = Array.isArray(s.required) ? s.required : [];
+    const fields = [];
+    for (const [key, raw] of Object.entries(s.properties)) {
+        fields.push(propToField(key, raw, requiredList.includes(key)));
+    }
+    const meta = s["x-cotrackpro"] ?? {};
+    return {
+        title: typeof s.title === "string" ? s.title : "Untitled parameter set",
+        description: typeof s.description === "string" ? s.description : undefined,
+        dataSensitivity: meta.dataSensitivity ?? "sensitive",
+        fields,
+    };
+}
+function propToField(key, p, required) {
+    // The schema is untrusted input (a hand-written or exported `--from` file). A
+    // property whose value isn't a schema object must fail with a clear message —
+    // not a raw "Cannot read properties of null (reading 'title')" TypeError.
+    if (!p || typeof p !== "object" || Array.isArray(p)) {
+        const got = p === null ? "null" : Array.isArray(p) ? "an array" : `a ${typeof p}`;
+        throw new ParamError(`Field '${key}' must be a schema object (got ${got}).`);
+    }
+    const field = { key, label: p.title ?? key, type: inferType(key, p), required };
+    if (p.description)
+        field.description = p.description;
+    if (p.enum)
+        field.options = p.enum;
+    if (p.items?.enum)
+        field.options = p.items.enum;
+    if (p.minimum != null)
+        field.min = p.minimum;
+    if (p.maximum != null)
+        field.max = p.maximum;
+    if (p.minLength != null)
+        field.minLength = p.minLength;
+    if (p.maxLength != null)
+        field.maxLength = p.maxLength;
+    return field;
+}
+function inferType(key, p) {
+    switch (p.type) {
+        case "boolean":
+            return "boolean";
+        case "number":
+            return "number";
+        case "integer":
+            return "integer";
+        case "array":
+            return p.items?.enum ? "multiselect" : "list";
+        case "string":
+            if (p.format === "date")
+                return "date";
+            if (p.format === "time")
+                return "time";
+            if (p.enum)
+                return "select";
+            return "text";
+        default:
+            throw new ParamError(`Field '${key}' has an unsupported type '${String(p.type)}'.`);
+    }
+}
+//# sourceMappingURL=convert.js.map

package/dist/params/convert.js.map

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

package/dist/params/core.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Browser-safe barrel: everything in `params/` EXCEPT the Node-only codegen.
+ * Import-free by construction, so the compiled output loads directly in the
+ * portal builder. Keep it that way (an SDK test enforces no external imports).
+ */
+export * from "./types.js";
+export * from "./fieldTypes.js";
+export * from "./convert.js";
+export * from "./validate.js";
+export * from "./render.js";
+export * from "./prompt.js";

package/dist/params/core.js

@@ -0,0 +1,12 @@
+/**
+ * Browser-safe barrel: everything in `params/` EXCEPT the Node-only codegen.
+ * Import-free by construction, so the compiled output loads directly in the
+ * portal builder. Keep it that way (an SDK test enforces no external imports).
+ */
+export * from "./types.js";
+export * from "./fieldTypes.js";
+export * from "./convert.js";
+export * from "./validate.js";
+export * from "./render.js";
+export * from "./prompt.js";
+//# sourceMappingURL=core.js.map

package/dist/params/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/params/core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/params/fieldTypes.d.ts

@@ -0,0 +1,26 @@
+import type { FieldType, ParamField, SchemaProp } from "./types.js";
+/** Input widget the portal builder renders for a field type. */
+export type Widget = "text" | "textarea" | "number" | "checkbox" | "date" | "time" | "select" | "multiselect" | "taglist";
+export interface FieldTypeDef {
+    /** Display name in the builder. */
+    label: string;
+    /** Widget hint for the portal form. */
+    widget: Widget;
+    /** Whether this type needs an `options` list (select/multiselect). */
+    hasOptions: boolean;
+    /** The type-specific JSON Schema fragment (title/description/constraints added by convert). */
+    prop(field: ParamField): SchemaProp;
+}
+/**
+ * The single source of truth that drives the converter, both validators, the
+ * markdown renderer, and the portal's widget rendering — so they cannot drift.
+ */
+export declare const FIELD_TYPES: Record<FieldType, FieldTypeDef>;
+export interface FieldTypeMeta {
+    type: FieldType;
+    label: string;
+    widget: Widget;
+    hasOptions: boolean;
+}
+/** Serializable view of FIELD_TYPES for the portal (functions stripped). */
+export declare const FIELD_TYPE_LIST: FieldTypeMeta[];

package/dist/params/fieldTypes.js

@@ -0,0 +1,29 @@
+/**
+ * The single source of truth that drives the converter, both validators, the
+ * markdown renderer, and the portal's widget rendering — so they cannot drift.
+ */
+export const FIELD_TYPES = {
+    text: { label: "Short text", widget: "text", hasOptions: false, prop: () => ({ type: "string" }) },
+    longtext: { label: "Long text", widget: "textarea", hasOptions: false, prop: () => ({ type: "string" }) },
+    number: { label: "Number", widget: "number", hasOptions: false, prop: () => ({ type: "number" }) },
+    integer: { label: "Whole number", widget: "number", hasOptions: false, prop: () => ({ type: "integer" }) },
+    boolean: { label: "Yes / no", widget: "checkbox", hasOptions: false, prop: () => ({ type: "boolean" }) },
+    date: { label: "Date", widget: "date", hasOptions: false, prop: () => ({ type: "string", format: "date" }) },
+    time: { label: "Time", widget: "time", hasOptions: false, prop: () => ({ type: "string", format: "time" }) },
+    select: { label: "Choose one", widget: "select", hasOptions: true, prop: (f) => ({ type: "string", enum: f.options ?? [] }) },
+    multiselect: {
+        label: "Choose many",
+        widget: "multiselect",
+        hasOptions: true,
+        prop: (f) => ({ type: "array", items: { type: "string", enum: f.options ?? [] } }),
+    },
+    list: { label: "List of text", widget: "taglist", hasOptions: false, prop: () => ({ type: "array", items: { type: "string" } }) },
+};
+/** Serializable view of FIELD_TYPES for the portal (functions stripped). */
+export const FIELD_TYPE_LIST = Object.keys(FIELD_TYPES).map((t) => ({
+    type: t,
+    label: FIELD_TYPES[t].label,
+    widget: FIELD_TYPES[t].widget,
+    hasOptions: FIELD_TYPES[t].hasOptions,
+}));
+//# sourceMappingURL=fieldTypes.js.map

package/dist/params/fieldTypes.js.map

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

package/dist/params/index.d.ts

@@ -0,0 +1,3 @@
+/** Full params surface: the browser-safe core plus the Node-only codegen helper. */
+export * from "./core.js";
+export { schemaToInterface } from "./codegen.js";

package/dist/params/index.js

@@ -0,0 +1,4 @@
+/** Full params surface: the browser-safe core plus the Node-only codegen helper. */
+export * from "./core.js";
+export { schemaToInterface } from "./codegen.js";
+//# sourceMappingURL=index.js.map

package/dist/params/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/params/index.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/params/prompt.d.ts

@@ -0,0 +1,4 @@
+/** Turn a parameter set (a form) into a plain-English prompt to paste into any AI assistant. */
+import type { ParamSet } from "./types.js";
+/** A ready-to-paste prompt asking an assistant to improve the form you're building. */
+export declare function toPrompt(set: ParamSet): string;

package/dist/params/prompt.js

@@ -0,0 +1,16 @@
+/** A ready-to-paste prompt asking an assistant to improve the form you're building. */
+export function toPrompt(set) {
+    const fields = set.fields.length
+        ? set.fields.map((f) => `- ${f.label}${f.required ? " (required)" : ""} — a ${f.type}`).join("\n")
+        : "- (no fields yet)";
+    return [
+        `I'm building a form called "${set.title}" to collect this information:`,
+        "",
+        fields,
+        "",
+        "Please help me improve it: what important fields am I missing for this kind of record, how should each field be worded so it's clear and neutral, and what should I be careful about when collecting this?",
+        "",
+        "Keep it educational and informational only — not legal or clinical advice. This may hold sensitive family information, so flag anything I should keep private. Use court-neutral, child-centered language.",
+    ].join("\n");
+}
+//# sourceMappingURL=prompt.js.map

package/dist/params/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/params/prompt.ts"],"names":[],"mappings":"AAGA,uFAAuF;AACvF,MAAM,UAAU,QAAQ,CAAC,GAAa;IACpC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM;QAC9B,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAClG,CAAC,CAAC,mBAAmB,CAAC;IACxB,OAAO;QACL,+BAA+B,GAAG,CAAC,KAAK,gCAAgC;QACxE,EAAE;QACF,MAAM;QACN,EAAE;QACF,4MAA4M;QAC5M,EAAE;QACF,4MAA4M;KAC7M,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/params/render.d.ts

@@ -0,0 +1,5 @@
+import type { ParamSet } from "./types.js";
+/** The platform safety line reprinted on every filled document. */
+export declare const SAFETY_LINE: string;
+/** Render a parameter set + (optional) values as a filled markdown document. */
+export declare function renderMarkdown(set: ParamSet, values?: Record<string, unknown>): string;

package/dist/params/render.js

@@ -0,0 +1,25 @@
+/** The platform safety line reprinted on every filled document. */
+export const SAFETY_LINE = "Educational and informational only — not legal or clinical advice. " +
+    "Do not place confidential family information in shared or public locations.";
+/** Render a parameter set + (optional) values as a filled markdown document. */
+export function renderMarkdown(set, values = {}) {
+    const lines = [`# ${set.title}`, ""];
+    if (set.description) {
+        lines.push(set.description, "");
+    }
+    lines.push(`> Sensitivity: **${set.dataSensitivity}**. ${SAFETY_LINE}`, "");
+    for (const f of set.fields) {
+        lines.push(`**${f.label || f.key}**`, "", formatValue(f, values[f.key]), "");
+    }
+    return lines.join("\n");
+}
+function formatValue(f, v) {
+    if (v === undefined || v === null || v === "" || (Array.isArray(v) && v.length === 0))
+        return "_(not provided)_";
+    if (typeof v === "boolean")
+        return v ? "Yes" : "No";
+    if (Array.isArray(v))
+        return v.map((x) => `- ${String(x)}`).join("\n");
+    return String(v);
+}
+//# sourceMappingURL=render.js.map

package/dist/params/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/params/render.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,MAAM,CAAC,MAAM,WAAW,GACtB,qEAAqE;IACrE,6EAA6E,CAAC;AAEhF,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,GAAa,EAAE,SAAkC,EAAE;IAChF,MAAM,KAAK,GAAa,CAAC,KAAK,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/C,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAClC,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,oBAAoB,GAAG,CAAC,eAAe,OAAO,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5E,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,WAAW,CAAC,CAAa,EAAE,CAAU;IAC5C,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;QAAE,OAAO,kBAAkB,CAAC;IACjH,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACpD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC"}

package/dist/params/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Custom parameter-set types. A "parameter" is a typed field; a "parameter set"
+ * is a named collection of them, persisted as a standards-compliant JSON Schema.
+ *
+ * This file and its siblings in `params/` (except `codegen.ts`) MUST stay
+ * import-free (no `node:` or external deps) so the compiled output loads directly
+ * in the browser — the portal builder and the CLI share this exact logic.
+ */
+export type DataSensitivity = "public" | "sensitive" | "confidential";
+export type FieldType = "text" | "longtext" | "number" | "integer" | "boolean" | "date" | "time" | "select" | "multiselect" | "list";
+/** A single user-authored parameter (one field of a form/schema). */
+export interface ParamField {
+    /** Property name — a valid identifier (letter, then letters/digits/underscore). */
+    key: string;
+    /** Human-friendly label (becomes the schema property `title`). */
+    label: string;
+    type: FieldType;
+    required?: boolean;
+    description?: string;
+    /** Allowed values for `select` / `multiselect`. */
+    options?: string[];
+    /** Numeric bounds for `number` / `integer`. */
+    min?: number;
+    max?: number;
+    /** Length bounds for `text` / `longtext`. */
+    minLength?: number;
+    maxLength?: number;
+}
+/** A named, typed set of parameters. */
+export interface ParamSet {
+    title: string;
+    description?: string;
+    dataSensitivity: DataSensitivity;
+    fields: ParamField[];
+}
+/** The supported JSON Schema (Draft 2020-12) subset for a single property. */
+export interface SchemaProp {
+    type?: "string" | "number" | "integer" | "boolean" | "array";
+    title?: string;
+    description?: string;
+    format?: "date" | "time";
+    enum?: string[];
+    items?: {
+        type: "string";
+        enum?: string[];
+    };
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+}
+/** The canonical object schema a parameter set serializes to. */
+export interface JsonSchema {
+    $schema?: string;
+    type: "object";
+    title?: string;
+    description?: string;
+    additionalProperties: false;
+    properties: Record<string, SchemaProp>;
+    required?: string[];
+    "x-cotrackpro"?: {
+        dataSensitivity: DataSensitivity;
+    };
+}
+export interface ValidationError {
+    path: string;
+    message: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+/** Thrown when a schema uses features outside the supported subset. */
+export declare class ParamError extends Error {
+    constructor(message: string);
+}

package/dist/params/types.js

@@ -0,0 +1,16 @@
+/**
+ * Custom parameter-set types. A "parameter" is a typed field; a "parameter set"
+ * is a named collection of them, persisted as a standards-compliant JSON Schema.
+ *
+ * This file and its siblings in `params/` (except `codegen.ts`) MUST stay
+ * import-free (no `node:` or external deps) so the compiled output loads directly
+ * in the browser — the portal builder and the CLI share this exact logic.
+ */
+/** Thrown when a schema uses features outside the supported subset. */
+export class ParamError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ParamError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/params/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/params/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+EH,uEAAuE;AACvE,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF"}

package/dist/params/validate.d.ts

@@ -0,0 +1,5 @@
+import type { ParamSet, ValidationResult } from "./types.js";
+/** Validate a parameter-set DEFINITION (the schema the user authored). */
+export declare function validateParamSet(def: ParamSet): ValidationResult;
+/** Validate VALUES entered for a parameter set against its field types. */
+export declare function validateValues(set: ParamSet, values: Record<string, unknown>): ValidationResult;