@aletheia-dev/collection-flow 0.0.0-stage → 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,79 @@
+import { Field, FlowStep, CollectionFlowBody, ValidationReport } from '@aletheia-dev/core';
+export { Condition, evaluateCondition } from '@aletheia-dev/core';
+import { z } from 'zod';
+
+/** A field without `visibleWhen` is always visible; otherwise its condition is evaluated against `data`. */
+declare function isFieldVisible(field: Field, data: Record<string, unknown>): boolean;
+/** Fields of `step` that are currently visible given `data`, in declaration order. */
+declare function visibleFields(step: FlowStep, data: Record<string, unknown>): Field[];
+
+/** Looks up a step by id. Throws a ValidationError when the flow has no such step. */
+declare function getStep(flow: CollectionFlowBody, stepId: string): FlowStep;
+/**
+ * Resolves the step that follows `stepId` for the given submission data.
+ * The first branch whose condition holds wins, then `step.next`; undefined means terminal.
+ */
+declare function nextStepId(flow: CollectionFlowBody, stepId: string, data: Record<string, unknown>): string | undefined;
+/** True when no step follows `stepId` for the given data. */
+declare function isTerminal(flow: CollectionFlowBody, stepId: string, data: Record<string, unknown>): boolean;
+/**
+ * The path a submission with `data` takes through the flow, starting at the entry step.
+ * Throws a ValidationError if the path revisits a step.
+ */
+declare function orderedSteps(flow: CollectionFlowBody, data: Record<string, unknown>): FlowStep[];
+
+/** Zod schema for a single field's value, derived from its type, validation and required flag. */
+declare function fieldSchema(field: Field): z.ZodType;
+/** Object schema for the fields of `step` that are visible given `data`. Unknown keys are stripped. */
+declare function buildZodForStep(step: FlowStep, data: Record<string, unknown>): z.ZodObject;
+/** Object schema covering every step on the path `data` takes through `flow`. */
+declare function buildZodForFlow(flow: CollectionFlowBody, data: Record<string, unknown>): z.ZodObject;
+type SubmissionIssue = {
+    path: string;
+    message: string;
+};
+type ValidateSubmissionResult = {
+    success: true;
+    data: Record<string, unknown>;
+} | {
+    success: false;
+    issues: SubmissionIssue[];
+};
+/** Validates a full submission against the steps it would traverse. */
+declare function validateSubmission(flow: CollectionFlowBody, data: Record<string, unknown>): ValidateSubmissionResult;
+
+interface FileFieldRef {
+    fieldKey: string;
+    fileId: string;
+}
+/** True when `flow` has a `file` field with `key` on any step (visibility and path ignored). */
+declare function isFileField(flow: CollectionFlowBody, key: string): boolean;
+/**
+ * The `{ fileId }` values held by the visible `file` fields on the path `data` takes through
+ * `flow`, in step and field order. Fields without a well-formed value are skipped: shape
+ * validation is `validateSubmission`'s job, this only finds the documents to verify.
+ */
+declare function fileFieldValues(flow: CollectionFlowBody, data: Record<string, unknown>): FileFieldRef[];
+
+/** A minimal KYB flow: business details, then UBO details unless the entity is a sole trader, then review. */
+declare const kybBasicFlow: CollectionFlowBody;
+declare const exampleFlows: Record<string, CollectionFlowBody>;
+
+/**
+ * Full validation of a collection-flow draft without saving it (`POST
+ * /collection-flows/validate`). Pure. Every problem becomes a `DefinitionIssue` with the step id
+ * and, where it has one, the field key, so the builder can mark the step and the field.
+ */
+
+/**
+ * Validates a flow body (`{ entryStepId, steps, linkTtlSeconds? }`). `prefix` is prepended to
+ * every issue path (e.g. `definition` when the body sits inside an upsert input).
+ */
+declare function validateFlowBody(body: unknown, prefix?: string): ValidationReport;
+/**
+ * Validates an `UpsertCollectionFlowInput`-shaped body: the envelope (`name`, `description`) and
+ * the definition, with definition issue paths under `definition.`.
+ */
+declare function validateFlowInput(input: unknown): ValidationReport;
+
+export { type FileFieldRef, type SubmissionIssue, type ValidateSubmissionResult, buildZodForFlow, buildZodForStep, exampleFlows, fieldSchema, fileFieldValues, getStep, isFieldVisible, isFileField, isTerminal, kybBasicFlow, nextStepId, orderedSteps, validateFlowBody, validateFlowInput, validateSubmission, visibleFields };

package/dist/index.js

@@ -0,0 +1,466 @@
+// src/visibility.ts
+import { evaluateCondition } from "@aletheia-dev/core";
+function isFieldVisible(field, data) {
+  if (!field.visibleWhen) return true;
+  return evaluateCondition(field.visibleWhen, data);
+}
+function visibleFields(step, data) {
+  return step.fields.filter((field) => isFieldVisible(field, data));
+}
+
+// src/navigation.ts
+import {
+  evaluateCondition as evaluateCondition2,
+  ValidationError
+} from "@aletheia-dev/core";
+function getStep(flow, stepId) {
+  const step = flow.steps.find((s) => s.id === stepId);
+  if (!step) throw new ValidationError(`unknown step "${stepId}"`);
+  return step;
+}
+function nextStepId(flow, stepId, data) {
+  const step = getStep(flow, stepId);
+  for (const branch of step.branches ?? []) {
+    if (evaluateCondition2(branch.when, data)) return branch.next;
+  }
+  return step.next;
+}
+function isTerminal(flow, stepId, data) {
+  return nextStepId(flow, stepId, data) === void 0;
+}
+function orderedSteps(flow, data) {
+  const visited = /* @__PURE__ */ new Set();
+  const steps = [];
+  let current = flow.entryStepId;
+  while (current !== void 0) {
+    if (visited.has(current)) {
+      throw new ValidationError(`cycle detected at step "${current}"`, { stepId: current });
+    }
+    visited.add(current);
+    steps.push(getStep(flow, current));
+    current = nextStepId(flow, current, data);
+  }
+  return steps;
+}
+
+// src/validation.ts
+import { z } from "zod";
+import {
+  ValidationError as ValidationError2
+} from "@aletheia-dev/core";
+var ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+function dateSchema() {
+  const iso = z.iso;
+  return iso?.date ? iso.date() : z.string().regex(ISO_DATE, "expected YYYY-MM-DD");
+}
+function textSchema(field) {
+  let schema = z.string();
+  const { min, max, pattern } = field.validation ?? {};
+  if (field.required) schema = schema.min(1, `${field.label} is required`);
+  if (min !== void 0) schema = schema.min(min);
+  if (max !== void 0) schema = schema.max(max);
+  if (pattern !== void 0) schema = schema.regex(new RegExp(pattern));
+  return schema;
+}
+function numberSchema(field) {
+  let schema = z.coerce.number();
+  const { min, max } = field.validation ?? {};
+  if (min !== void 0) schema = schema.min(min);
+  if (max !== void 0) schema = schema.max(max);
+  return schema;
+}
+function selectSchema(field) {
+  const values = (field.options ?? []).map((o) => o.value);
+  if (values.length === 0) {
+    throw new ValidationError2(`select field "${field.key}" has no options`, { key: field.key });
+  }
+  return z.enum(values);
+}
+function baseSchema(field) {
+  switch (field.type) {
+    case "text":
+      return textSchema(field);
+    case "email":
+      return z.email();
+    case "number":
+      return numberSchema(field);
+    case "select":
+      return selectSchema(field);
+    case "date":
+      return dateSchema();
+    case "boolean":
+      return z.boolean();
+    case "file":
+      return z.object({ fileId: z.string(), name: z.string().optional() });
+  }
+}
+function fieldSchema(field) {
+  const schema = baseSchema(field);
+  return field.required ? schema : schema.optional();
+}
+function buildZodForStep(step, data) {
+  const shape = {};
+  for (const field of visibleFields(step, data)) shape[field.key] = fieldSchema(field);
+  return z.object(shape);
+}
+function buildZodForFlow(flow, data) {
+  let schema = z.object({});
+  for (const step of orderedSteps(flow, data))
+    schema = schema.extend(buildZodForStep(step, data).shape);
+  return schema;
+}
+function validateSubmission(flow, data) {
+  const result = buildZodForFlow(flow, data).safeParse(data);
+  if (result.success) return { success: true, data: result.data };
+  return {
+    success: false,
+    issues: result.error.issues.map((issue) => ({
+      path: issue.path.map(String).join("."),
+      message: issue.message
+    }))
+  };
+}
+
+// src/files.ts
+function isFileField(flow, key) {
+  return flow.steps.some(
+    (step) => step.fields.some((field) => field.key === key && field.type === "file")
+  );
+}
+function fileIdOf(value) {
+  if (typeof value !== "object" || value === null) return void 0;
+  const fileId = value.fileId;
+  return typeof fileId === "string" && fileId.length > 0 ? fileId : void 0;
+}
+function fileFieldValues(flow, data) {
+  const refs = [];
+  for (const step of orderedSteps(flow, data)) {
+    for (const field of visibleFields(step, data)) {
+      if (field.type !== "file") continue;
+      const fileId = fileIdOf(data[field.key]);
+      if (fileId !== void 0) refs.push({ fieldKey: field.key, fileId });
+    }
+  }
+  return refs;
+}
+
+// src/examples/kyb-basic.ts
+import { CollectionFlowBody } from "@aletheia-dev/core";
+var countryOptions = [
+  { value: "US", label: "United States" },
+  { value: "GB", label: "United Kingdom" },
+  { value: "DE", label: "Germany" },
+  { value: "KP", label: "North Korea" }
+];
+var kybBasicFlow = CollectionFlowBody.parse({
+  entryStepId: "business",
+  steps: [
+    {
+      id: "business",
+      title: "Business details",
+      fields: [
+        { key: "legalName", label: "Legal name", type: "text", required: true },
+        {
+          key: "country",
+          label: "Country of incorporation",
+          type: "select",
+          required: true,
+          options: countryOptions
+        },
+        {
+          key: "entityType",
+          label: "Entity type",
+          type: "select",
+          required: true,
+          options: [
+            { value: "company", label: "Company" },
+            { value: "sole_trader", label: "Sole trader" }
+          ]
+        },
+        {
+          key: "website",
+          label: "Website",
+          type: "text",
+          validation: { pattern: "^(https?://)?([a-zA-Z0-9-]+\\.)+[a-zA-Z]{2,}(/\\S*)?$" }
+        }
+      ],
+      branches: [{ when: { path: "entityType", op: "eq", value: "sole_trader" }, next: "review" }],
+      next: "ubo"
+    },
+    {
+      id: "ubo",
+      title: "Ultimate beneficial owner",
+      fields: [
+        { key: "uboName", label: "Full name", type: "text", required: true },
+        {
+          key: "uboOwnershipPct",
+          label: "Ownership percentage",
+          type: "number",
+          required: true,
+          validation: { min: 0, max: 100 }
+        },
+        {
+          key: "uboCountry",
+          label: "Country of residence",
+          type: "select",
+          required: true,
+          options: countryOptions
+        }
+      ],
+      next: "review"
+    },
+    {
+      id: "review",
+      title: "Review",
+      fields: [
+        {
+          key: "confirm",
+          label: "I confirm the information is accurate",
+          type: "boolean",
+          required: true
+        }
+      ]
+    }
+  ]
+});
+var exampleFlows = { "kyb-basic": kybBasicFlow };
+
+// src/index.ts
+import { evaluateCondition as evaluateCondition3 } from "@aletheia-dev/core";
+
+// src/validate-flow.ts
+import {
+  FlowStep,
+  MAX_LINK_TTL_SECONDS,
+  UpsertCollectionFlowInput
+} from "@aletheia-dev/core";
+import { z as z2 } from "zod";
+var isRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+var joinPath = (...parts) => parts.filter((p) => p !== void 0 && p !== "").join(".");
+var FlowShape = z2.object({
+  entryStepId: z2.string().min(1),
+  steps: z2.array(z2.unknown()).min(1),
+  linkTtlSeconds: z2.number().int().min(60).max(MAX_LINK_TTL_SECONDS).optional()
+});
+function schemaIssues(error, prefix, stepId, stepRaw) {
+  return error.issues.map((issue) => {
+    let fieldKey;
+    if (issue.path[0] === "fields" && typeof issue.path[1] === "number" && isRecord(stepRaw)) {
+      const field = Array.isArray(stepRaw.fields) ? stepRaw.fields[issue.path[1]] : void 0;
+      if (isRecord(field) && typeof field.key === "string") fieldKey = field.key;
+    }
+    return {
+      severity: "error",
+      path: joinPath(prefix, ...issue.path.map(String)),
+      ...stepId !== void 0 && { stepId },
+      ...fieldKey !== void 0 && { fieldKey },
+      code: "schema",
+      message: issue.message
+    };
+  });
+}
+function targetsOf(step) {
+  return [
+    ...step.next !== void 0 ? [{ to: step.next, path: "next" }] : [],
+    ...(step.branches ?? []).map((b, j) => ({ to: b.next, path: `branches.${j}.next` }))
+  ];
+}
+function looseNode(raw) {
+  const strings = (items, prop) => (Array.isArray(items) ? items : []).map((item) => isRecord(item) ? item[prop] : void 0).filter((v) => typeof v === "string");
+  return {
+    keys: strings(raw.fields, "key"),
+    targets: [
+      ...typeof raw.next === "string" ? [raw.next] : [],
+      ...strings(raw.branches, "next")
+    ]
+  };
+}
+function answeredBefore(entry, nodes) {
+  const avail = /* @__PURE__ */ new Map([[entry, /* @__PURE__ */ new Set()]]);
+  let changed = true;
+  while (changed) {
+    changed = false;
+    for (const [id, keys] of [...avail]) {
+      const node = nodes.get(id);
+      const out = /* @__PURE__ */ new Set([...keys, ...node.keys]);
+      for (const to of node.targets) {
+        if (!nodes.has(to)) continue;
+        const target = avail.get(to) ?? /* @__PURE__ */ new Set();
+        const before = target.size;
+        for (const key of out) target.add(key);
+        if (!avail.has(to) || target.size !== before) {
+          avail.set(to, target);
+          changed = true;
+        }
+      }
+    }
+  }
+  return avail;
+}
+function validateFlowBody(body, prefix = "") {
+  const issues = [];
+  const push = (issue) => issues.push(issue);
+  const shape = FlowShape.safeParse(body);
+  if (!shape.success) issues.push(...schemaIssues(shape.error, prefix));
+  const raw = isRecord(body) ? body : {};
+  const rawSteps = Array.isArray(raw.steps) ? raw.steps : [];
+  const steps = /* @__PURE__ */ new Map();
+  const indexOf = /* @__PURE__ */ new Map();
+  const nodes = /* @__PURE__ */ new Map();
+  rawSteps.forEach((rawStep, i) => {
+    const base = joinPath(prefix, "steps", i);
+    const id = isRecord(rawStep) && typeof rawStep.id === "string" ? rawStep.id : void 0;
+    if (id !== void 0 && isRecord(rawStep) && !nodes.has(id)) nodes.set(id, looseNode(rawStep));
+    const parsed = FlowStep.safeParse(rawStep);
+    if (!parsed.success) {
+      issues.push(...schemaIssues(parsed.error, base, id, rawStep));
+      return;
+    }
+    if (steps.has(parsed.data.id)) {
+      push({
+        severity: "error",
+        path: joinPath(base, "id"),
+        stepId: parsed.data.id,
+        code: "duplicate_step_id",
+        message: `step id "${parsed.data.id}" is used more than once`
+      });
+      return;
+    }
+    steps.set(parsed.data.id, parsed.data);
+    indexOf.set(parsed.data.id, i);
+  });
+  const entry = typeof raw.entryStepId === "string" ? raw.entryStepId : void 0;
+  if (entry && rawSteps.length > 0 && !nodes.has(entry)) {
+    push({
+      severity: "error",
+      path: joinPath(prefix, "entryStepId"),
+      code: "entry_missing",
+      message: `entry step "${entry}" does not exist`
+    });
+  }
+  const fieldOwner = /* @__PURE__ */ new Map();
+  for (const [id, step] of steps) {
+    const base = joinPath(prefix, "steps", indexOf.get(id));
+    for (const target of targetsOf(step)) {
+      if (!nodes.has(target.to)) {
+        push({
+          severity: "error",
+          path: joinPath(base, target.path),
+          stepId: id,
+          code: "unknown_branch_target",
+          message: `step "${id}" points to unknown step "${target.to}"`
+        });
+      }
+    }
+    step.fields.forEach((field, j) => {
+      const fieldBase = joinPath(base, "fields", j);
+      const owner = fieldOwner.get(field.key);
+      if (owner !== void 0) {
+        push({
+          severity: "error",
+          path: joinPath(fieldBase, "key"),
+          stepId: id,
+          fieldKey: field.key,
+          code: "duplicate_field_key",
+          message: `field key "${field.key}" is already used in step "${owner}"`
+        });
+      } else {
+        fieldOwner.set(field.key, id);
+      }
+      if (field.type === "select" && (field.options ?? []).length === 0) {
+        push({
+          severity: "error",
+          path: joinPath(fieldBase, "options"),
+          stepId: id,
+          fieldKey: field.key,
+          code: "select_without_options",
+          message: `select field "${field.key}" needs at least one option`
+        });
+      }
+      if (field.type === "file" && field.required && id === entry) {
+        push({
+          severity: "warning",
+          path: joinPath(fieldBase, "required"),
+          stepId: id,
+          fieldKey: field.key,
+          code: "file_field_in_first_step_required",
+          message: `required upload "${field.key}" on the first step; applicants abandon flows that open with one`
+        });
+      }
+    });
+  }
+  if (entry && nodes.has(entry)) {
+    const answered = answeredBefore(entry, nodes);
+    for (const [id, step] of steps) {
+      const base = joinPath(prefix, "steps", indexOf.get(id));
+      const before = answered.get(id);
+      if (!before) {
+        push({
+          severity: "warning",
+          path: base,
+          stepId: id,
+          code: "unreachable_step",
+          message: `step "${id}" cannot be reached from the entry step`
+        });
+        continue;
+      }
+      step.fields.forEach((field, j) => {
+        if (!field.visibleWhen) return;
+        const root = field.visibleWhen.path.split(".")[0] ?? "";
+        const sameStep = step.fields.some((f) => f.key === root && f.key !== field.key);
+        if (before.has(root) || sameStep) return;
+        push({
+          severity: "warning",
+          path: joinPath(base, "fields", j, "visibleWhen", "path"),
+          stepId: id,
+          fieldKey: field.key,
+          code: "visible_when_unknown_path",
+          message: `"${field.visibleWhen.path}" is not a field answered before "${field.key}"`
+        });
+      });
+    }
+  }
+  return { ok: !issues.some((i) => i.severity === "error"), issues };
+}
+var Envelope = UpsertCollectionFlowInput.omit({ definition: true });
+function validateFlowInput(input) {
+  if (!isRecord(input)) {
+    return {
+      ok: false,
+      issues: [{ severity: "error", path: "", code: "schema", message: "expected an object" }]
+    };
+  }
+  const envelope = Envelope.safeParse(input);
+  const issues = envelope.success ? [] : schemaIssues(envelope.error, "");
+  if (input.definition === void 0) {
+    issues.push({
+      severity: "error",
+      path: "definition",
+      code: "schema",
+      message: "definition is required"
+    });
+  } else {
+    issues.push(...validateFlowBody(input.definition, "definition").issues);
+  }
+  return { ok: !issues.some((i) => i.severity === "error"), issues };
+}
+export {
+  buildZodForFlow,
+  buildZodForStep,
+  evaluateCondition3 as evaluateCondition,
+  exampleFlows,
+  fieldSchema,
+  fileFieldValues,
+  getStep,
+  isFieldVisible,
+  isFileField,
+  isTerminal,
+  kybBasicFlow,
+  nextStepId,
+  orderedSteps,
+  validateFlowBody,
+  validateFlowInput,
+  validateSubmission,
+  visibleFields
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/visibility.ts","../src/navigation.ts","../src/validation.ts","../src/files.ts","../src/examples/kyb-basic.ts","../src/index.ts","../src/validate-flow.ts"],"sourcesContent":["import { evaluateCondition, type Field, type FlowStep } from '@aletheia-dev/core';\n\n/** A field without `visibleWhen` is always visible; otherwise its condition is evaluated against `data`. */\nexport function isFieldVisible(field: Field, data: Record<string, unknown>): boolean {\n  if (!field.visibleWhen) return true;\n  return evaluateCondition(field.visibleWhen, data);\n}\n\n/** Fields of `step` that are currently visible given `data`, in declaration order. */\nexport function visibleFields(step: FlowStep, data: Record<string, unknown>): Field[] {\n  return step.fields.filter((field) => isFieldVisible(field, data));\n}\n","import {\n  evaluateCondition,\n  ValidationError,\n  type CollectionFlowBody,\n  type FlowStep,\n} from '@aletheia-dev/core';\n\n/** Looks up a step by id. Throws a ValidationError when the flow has no such step. */\nexport function getStep(flow: CollectionFlowBody, stepId: string): FlowStep {\n  const step = flow.steps.find((s) => s.id === stepId);\n  if (!step) throw new ValidationError(`unknown step \"${stepId}\"`);\n  return step;\n}\n\n/**\n * Resolves the step that follows `stepId` for the given submission data.\n * The first branch whose condition holds wins, then `step.next`; undefined means terminal.\n */\nexport function nextStepId(\n  flow: CollectionFlowBody,\n  stepId: string,\n  data: Record<string, unknown>,\n): string | undefined {\n  const step = getStep(flow, stepId);\n  for (const branch of step.branches ?? []) {\n    if (evaluateCondition(branch.when, data)) return branch.next;\n  }\n  return step.next;\n}\n\n/** True when no step follows `stepId` for the given data. */\nexport function isTerminal(\n  flow: CollectionFlowBody,\n  stepId: string,\n  data: Record<string, unknown>,\n): boolean {\n  return nextStepId(flow, stepId, data) === undefined;\n}\n\n/**\n * The path a submission with `data` takes through the flow, starting at the entry step.\n * Throws a ValidationError if the path revisits a step.\n */\nexport function orderedSteps(flow: CollectionFlowBody, data: Record<string, unknown>): FlowStep[] {\n  const visited = new Set<string>();\n  const steps: FlowStep[] = [];\n  let current: string | undefined = flow.entryStepId;\n  while (current !== undefined) {\n    if (visited.has(current)) {\n      throw new ValidationError(`cycle detected at step \"${current}\"`, { stepId: current });\n    }\n    visited.add(current);\n    steps.push(getStep(flow, current));\n    current = nextStepId(flow, current, data);\n  }\n  return steps;\n}\n","import { z } from 'zod';\nimport {\n  ValidationError,\n  type CollectionFlowBody,\n  type Field,\n  type FlowStep,\n} from '@aletheia-dev/core';\nimport { orderedSteps } from './navigation.js';\nimport { visibleFields } from './visibility.js';\n\nconst ISO_DATE = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nfunction dateSchema(): z.ZodType<string> {\n  const iso = (z as { iso?: { date?: () => z.ZodType<string> } }).iso;\n  return iso?.date ? iso.date() : z.string().regex(ISO_DATE, 'expected YYYY-MM-DD');\n}\n\nfunction textSchema(field: Field): z.ZodType {\n  let schema = z.string();\n  const { min, max, pattern } = field.validation ?? {};\n  if (field.required) schema = schema.min(1, `${field.label} is required`);\n  if (min !== undefined) schema = schema.min(min);\n  if (max !== undefined) schema = schema.max(max);\n  if (pattern !== undefined) schema = schema.regex(new RegExp(pattern));\n  return schema;\n}\n\nfunction numberSchema(field: Field): z.ZodType {\n  let schema = z.coerce.number();\n  const { min, max } = field.validation ?? {};\n  if (min !== undefined) schema = schema.min(min);\n  if (max !== undefined) schema = schema.max(max);\n  return schema;\n}\n\nfunction selectSchema(field: Field): z.ZodType {\n  const values = (field.options ?? []).map((o) => o.value);\n  if (values.length === 0) {\n    throw new ValidationError(`select field \"${field.key}\" has no options`, { key: field.key });\n  }\n  return z.enum(values as [string, ...string[]]);\n}\n\nfunction baseSchema(field: Field): z.ZodType {\n  switch (field.type) {\n    case 'text':\n      return textSchema(field);\n    case 'email':\n      return z.email();\n    case 'number':\n      return numberSchema(field);\n    case 'select':\n      return selectSchema(field);\n    case 'date':\n      return dateSchema();\n    case 'boolean':\n      return z.boolean();\n    case 'file':\n      return z.object({ fileId: z.string(), name: z.string().optional() });\n  }\n}\n\n/** Zod schema for a single field's value, derived from its type, validation and required flag. */\nexport function fieldSchema(field: Field): z.ZodType {\n  const schema = baseSchema(field);\n  return field.required ? schema : schema.optional();\n}\n\n/** Object schema for the fields of `step` that are visible given `data`. Unknown keys are stripped. */\nexport function buildZodForStep(step: FlowStep, data: Record<string, unknown>): z.ZodObject {\n  const shape: Record<string, z.ZodType> = {};\n  for (const field of visibleFields(step, data)) shape[field.key] = fieldSchema(field);\n  return z.object(shape);\n}\n\n/** Object schema covering every step on the path `data` takes through `flow`. */\nexport function buildZodForFlow(\n  flow: CollectionFlowBody,\n  data: Record<string, unknown>,\n): z.ZodObject {\n  let schema = z.object({});\n  for (const step of orderedSteps(flow, data))\n    schema = schema.extend(buildZodForStep(step, data).shape);\n  return schema;\n}\n\nexport type SubmissionIssue = { path: string; message: string };\nexport type ValidateSubmissionResult =\n  { success: true; data: Record<string, unknown> } | { success: false; issues: SubmissionIssue[] };\n\n/** Validates a full submission against the steps it would traverse. */\nexport function validateSubmission(\n  flow: CollectionFlowBody,\n  data: Record<string, unknown>,\n): ValidateSubmissionResult {\n  const result = buildZodForFlow(flow, data).safeParse(data);\n  if (result.success) return { success: true, data: result.data };\n  return {\n    success: false,\n    issues: result.error.issues.map((issue) => ({\n      path: issue.path.map(String).join('.'),\n      message: issue.message,\n    })),\n  };\n}\n","import type { CollectionFlowBody } from '@aletheia-dev/core';\nimport { orderedSteps } from './navigation.js';\nimport { visibleFields } from './visibility.js';\n\nexport interface FileFieldRef {\n  fieldKey: string;\n  fileId: string;\n}\n\n/** True when `flow` has a `file` field with `key` on any step (visibility and path ignored). */\nexport function isFileField(flow: CollectionFlowBody, key: string): boolean {\n  return flow.steps.some((step) =>\n    step.fields.some((field) => field.key === key && field.type === 'file'),\n  );\n}\n\nfunction fileIdOf(value: unknown): string | undefined {\n  if (typeof value !== 'object' || value === null) return undefined;\n  const fileId = (value as { fileId?: unknown }).fileId;\n  return typeof fileId === 'string' && fileId.length > 0 ? fileId : undefined;\n}\n\n/**\n * The `{ fileId }` values held by the visible `file` fields on the path `data` takes through\n * `flow`, in step and field order. Fields without a well-formed value are skipped: shape\n * validation is `validateSubmission`'s job, this only finds the documents to verify.\n */\nexport function fileFieldValues(\n  flow: CollectionFlowBody,\n  data: Record<string, unknown>,\n): FileFieldRef[] {\n  const refs: FileFieldRef[] = [];\n  for (const step of orderedSteps(flow, data)) {\n    for (const field of visibleFields(step, data)) {\n      if (field.type !== 'file') continue;\n      const fileId = fileIdOf(data[field.key]);\n      if (fileId !== undefined) refs.push({ fieldKey: field.key, fileId });\n    }\n  }\n  return refs;\n}\n","import { CollectionFlowBody } from '@aletheia-dev/core';\n\nconst countryOptions = [\n  { value: 'US', label: 'United States' },\n  { value: 'GB', label: 'United Kingdom' },\n  { value: 'DE', label: 'Germany' },\n  { value: 'KP', label: 'North Korea' },\n];\n\n/** A minimal KYB flow: business details, then UBO details unless the entity is a sole trader, then review. */\nexport const kybBasicFlow: CollectionFlowBody = CollectionFlowBody.parse({\n  entryStepId: 'business',\n  steps: [\n    {\n      id: 'business',\n      title: 'Business details',\n      fields: [\n        { key: 'legalName', label: 'Legal name', type: 'text', required: true },\n        {\n          key: 'country',\n          label: 'Country of incorporation',\n          type: 'select',\n          required: true,\n          options: countryOptions,\n        },\n        {\n          key: 'entityType',\n          label: 'Entity type',\n          type: 'select',\n          required: true,\n          options: [\n            { value: 'company', label: 'Company' },\n            { value: 'sole_trader', label: 'Sole trader' },\n          ],\n        },\n        {\n          key: 'website',\n          label: 'Website',\n          type: 'text',\n          validation: { pattern: '^(https?://)?([a-zA-Z0-9-]+\\\\.)+[a-zA-Z]{2,}(/\\\\S*)?$' },\n        },\n      ],\n      branches: [{ when: { path: 'entityType', op: 'eq', value: 'sole_trader' }, next: 'review' }],\n      next: 'ubo',\n    },\n    {\n      id: 'ubo',\n      title: 'Ultimate beneficial owner',\n      fields: [\n        { key: 'uboName', label: 'Full name', type: 'text', required: true },\n        {\n          key: 'uboOwnershipPct',\n          label: 'Ownership percentage',\n          type: 'number',\n          required: true,\n          validation: { min: 0, max: 100 },\n        },\n        {\n          key: 'uboCountry',\n          label: 'Country of residence',\n          type: 'select',\n          required: true,\n          options: countryOptions,\n        },\n      ],\n      next: 'review',\n    },\n    {\n      id: 'review',\n      title: 'Review',\n      fields: [\n        {\n          key: 'confirm',\n          label: 'I confirm the information is accurate',\n          type: 'boolean',\n          required: true,\n        },\n      ],\n    },\n  ],\n});\n\nexport const exampleFlows: Record<string, CollectionFlowBody> = { 'kyb-basic': kybBasicFlow };\n","export * from './visibility.js';\nexport * from './navigation.js';\nexport * from './validation.js';\nexport * from './files.js';\nexport * from './examples/kyb-basic.js';\nexport { evaluateCondition, type Condition } from '@aletheia-dev/core';\nexport * from './validate-flow.js';\n","/**\n * Full validation of a collection-flow draft without saving it (`POST\n * /collection-flows/validate`). Pure. Every problem becomes a `DefinitionIssue` with the step id\n * and, where it has one, the field key, so the builder can mark the step and the field.\n */\nimport {\n  FlowStep,\n  MAX_LINK_TTL_SECONDS,\n  UpsertCollectionFlowInput,\n  type DefinitionIssue,\n  type ValidationReport,\n} from '@aletheia-dev/core';\nimport { z } from 'zod';\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  value !== null && typeof value === 'object' && !Array.isArray(value);\n\nconst joinPath = (...parts: Array<string | number | undefined>): string =>\n  parts.filter((p) => p !== undefined && p !== '').join('.');\n\n/** The top level without the core schema's graph refinements, which become coded issues here. */\nconst FlowShape = z.object({\n  entryStepId: z.string().min(1),\n  steps: z.array(z.unknown()).min(1),\n  linkTtlSeconds: z.number().int().min(60).max(MAX_LINK_TTL_SECONDS).optional(),\n});\n\nfunction schemaIssues(\n  error: z.ZodError,\n  prefix: string,\n  stepId?: string,\n  stepRaw?: unknown,\n): DefinitionIssue[] {\n  return error.issues.map((issue) => {\n    // `fields.<j>.…` issues name the field when its key is readable.\n    let fieldKey: string | undefined;\n    if (issue.path[0] === 'fields' && typeof issue.path[1] === 'number' && isRecord(stepRaw)) {\n      const field = Array.isArray(stepRaw.fields) ? stepRaw.fields[issue.path[1]] : undefined;\n      if (isRecord(field) && typeof field.key === 'string') fieldKey = field.key;\n    }\n    return {\n      severity: 'error' as const,\n      path: joinPath(prefix, ...issue.path.map(String)),\n      ...(stepId !== undefined && { stepId }),\n      ...(fieldKey !== undefined && { fieldKey }),\n      code: 'schema',\n      message: issue.message,\n    };\n  });\n}\n\nfunction targetsOf(step: FlowStep): Array<{ to: string; path: string }> {\n  return [\n    ...(step.next !== undefined ? [{ to: step.next, path: 'next' }] : []),\n    ...(step.branches ?? []).map((b, j) => ({ to: b.next, path: `branches.${j}.next` })),\n  ];\n}\n\n/** A step's graph view, read from the raw body so steps that fail the schema still count. */\ninterface Node {\n  keys: string[];\n  targets: string[];\n}\n\nfunction looseNode(raw: Record<string, unknown>): Node {\n  const strings = (items: unknown, prop: string): string[] =>\n    (Array.isArray(items) ? items : [])\n      .map((item) => (isRecord(item) ? item[prop] : undefined))\n      .filter((v): v is string => typeof v === 'string');\n  return {\n    keys: strings(raw.fields, 'key'),\n    targets: [\n      ...(typeof raw.next === 'string' ? [raw.next] : []),\n      ...strings(raw.branches, 'next'),\n    ],\n  };\n}\n\n/**\n * Field keys that may already be answered when each step is shown: the union, over every path\n * from the entry, of the fields of the steps before it. Forward data-flow to a fixed point.\n */\nfunction answeredBefore(entry: string, nodes: Map<string, Node>): Map<string, Set<string>> {\n  const avail = new Map<string, Set<string>>([[entry, new Set()]]);\n  let changed = true;\n  while (changed) {\n    changed = false;\n    for (const [id, keys] of [...avail]) {\n      const node = nodes.get(id)!;\n      const out = new Set([...keys, ...node.keys]);\n      for (const to of node.targets) {\n        if (!nodes.has(to)) continue;\n        const target = avail.get(to) ?? new Set<string>();\n        const before = target.size;\n        for (const key of out) target.add(key);\n        if (!avail.has(to) || target.size !== before) {\n          avail.set(to, target);\n          changed = true;\n        }\n      }\n    }\n  }\n  return avail;\n}\n\n/**\n * Validates a flow body (`{ entryStepId, steps, linkTtlSeconds? }`). `prefix` is prepended to\n * every issue path (e.g. `definition` when the body sits inside an upsert input).\n */\nexport function validateFlowBody(body: unknown, prefix = ''): ValidationReport {\n  const issues: DefinitionIssue[] = [];\n  const push = (issue: DefinitionIssue) => issues.push(issue);\n  const shape = FlowShape.safeParse(body);\n  if (!shape.success) issues.push(...schemaIssues(shape.error, prefix));\n  const raw = isRecord(body) ? body : {};\n  const rawSteps = Array.isArray(raw.steps) ? raw.steps : [];\n\n  // Steps that pass the schema take part in the graph and field checks.\n  const steps = new Map<string, FlowStep>();\n  const indexOf = new Map<string, number>();\n  // Every first step per id, valid or not, for the graph checks.\n  const nodes = new Map<string, Node>();\n  rawSteps.forEach((rawStep, i) => {\n    const base = joinPath(prefix, 'steps', i);\n    const id = isRecord(rawStep) && typeof rawStep.id === 'string' ? rawStep.id : undefined;\n    if (id !== undefined && isRecord(rawStep) && !nodes.has(id)) nodes.set(id, looseNode(rawStep));\n    const parsed = FlowStep.safeParse(rawStep);\n    if (!parsed.success) {\n      issues.push(...schemaIssues(parsed.error, base, id, rawStep));\n      return;\n    }\n    if (steps.has(parsed.data.id)) {\n      push({\n        severity: 'error',\n        path: joinPath(base, 'id'),\n        stepId: parsed.data.id,\n        code: 'duplicate_step_id',\n        message: `step id \"${parsed.data.id}\" is used more than once`,\n      });\n      return;\n    }\n    steps.set(parsed.data.id, parsed.data);\n    indexOf.set(parsed.data.id, i);\n  });\n\n  const entry = typeof raw.entryStepId === 'string' ? raw.entryStepId : undefined;\n  if (entry && rawSteps.length > 0 && !nodes.has(entry)) {\n    push({\n      severity: 'error',\n      path: joinPath(prefix, 'entryStepId'),\n      code: 'entry_missing',\n      message: `entry step \"${entry}\" does not exist`,\n    });\n  }\n\n  const fieldOwner = new Map<string, string>();\n  for (const [id, step] of steps) {\n    const base = joinPath(prefix, 'steps', indexOf.get(id)!);\n    for (const target of targetsOf(step)) {\n      if (!nodes.has(target.to)) {\n        push({\n          severity: 'error',\n          path: joinPath(base, target.path),\n          stepId: id,\n          code: 'unknown_branch_target',\n          message: `step \"${id}\" points to unknown step \"${target.to}\"`,\n        });\n      }\n    }\n    step.fields.forEach((field, j) => {\n      const fieldBase = joinPath(base, 'fields', j);\n      const owner = fieldOwner.get(field.key);\n      if (owner !== undefined) {\n        push({\n          severity: 'error',\n          path: joinPath(fieldBase, 'key'),\n          stepId: id,\n          fieldKey: field.key,\n          code: 'duplicate_field_key',\n          message: `field key \"${field.key}\" is already used in step \"${owner}\"`,\n        });\n      } else {\n        fieldOwner.set(field.key, id);\n      }\n      if (field.type === 'select' && (field.options ?? []).length === 0) {\n        push({\n          severity: 'error',\n          path: joinPath(fieldBase, 'options'),\n          stepId: id,\n          fieldKey: field.key,\n          code: 'select_without_options',\n          message: `select field \"${field.key}\" needs at least one option`,\n        });\n      }\n      if (field.type === 'file' && field.required && id === entry) {\n        push({\n          severity: 'warning',\n          path: joinPath(fieldBase, 'required'),\n          stepId: id,\n          fieldKey: field.key,\n          code: 'file_field_in_first_step_required',\n          message: `required upload \"${field.key}\" on the first step; applicants abandon flows that open with one`,\n        });\n      }\n    });\n  }\n\n  if (entry && nodes.has(entry)) {\n    const answered = answeredBefore(entry, nodes);\n    for (const [id, step] of steps) {\n      const base = joinPath(prefix, 'steps', indexOf.get(id)!);\n      const before = answered.get(id);\n      if (!before) {\n        push({\n          severity: 'warning',\n          path: base,\n          stepId: id,\n          code: 'unreachable_step',\n          message: `step \"${id}\" cannot be reached from the entry step`,\n        });\n        continue;\n      }\n      step.fields.forEach((field, j) => {\n        if (!field.visibleWhen) return;\n        const root = field.visibleWhen.path.split('.')[0] ?? '';\n        const sameStep = step.fields.some((f) => f.key === root && f.key !== field.key);\n        if (before.has(root) || sameStep) return;\n        push({\n          severity: 'warning',\n          path: joinPath(base, 'fields', j, 'visibleWhen', 'path'),\n          stepId: id,\n          fieldKey: field.key,\n          code: 'visible_when_unknown_path',\n          message: `\"${field.visibleWhen.path}\" is not a field answered before \"${field.key}\"`,\n        });\n      });\n    }\n  }\n\n  return { ok: !issues.some((i) => i.severity === 'error'), issues };\n}\n\nconst Envelope = UpsertCollectionFlowInput.omit({ definition: true });\n\n/**\n * Validates an `UpsertCollectionFlowInput`-shaped body: the envelope (`name`, `description`) and\n * the definition, with definition issue paths under `definition.`.\n */\nexport function validateFlowInput(input: unknown): ValidationReport {\n  if (!isRecord(input)) {\n    return {\n      ok: false,\n      issues: [{ severity: 'error', path: '', code: 'schema', message: 'expected an object' }],\n    };\n  }\n  const envelope = Envelope.safeParse(input);\n  const issues = envelope.success ? [] : schemaIssues(envelope.error, '');\n  if (input.definition === undefined) {\n    issues.push({\n      severity: 'error',\n      path: 'definition',\n      code: 'schema',\n      message: 'definition is required',\n    });\n  } else {\n    issues.push(...validateFlowBody(input.definition, 'definition').issues);\n  }\n  return { ok: !issues.some((i) => i.severity === 'error'), issues };\n}\n"],"mappings":"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","names":["evaluateCondition","ValidationError","ValidationError","evaluateCondition","z"]}

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@aletheia-dev/collection-flow",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Collection flow logic for Aletheia: field visibility, step navigation and dynamic validation, shared by the server and the UIs.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/akhiljames/aletheia.git",
+    "directory": "packages/collection-flow"
+  },
+  "homepage": "https://github.com/akhiljames/aletheia/tree/main/packages/collection-flow#readme",
+  "bugs": "https://github.com/akhiljames/aletheia/issues",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "^4.6.5",
+    "@aletheia-dev/core": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.4",
+    "eslint": "^10.11.0",
+    "tsup": "^8.5.1",
+    "typescript": "5.9.3",
+    "vitest": "^5.0.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist .turbo"
+  }
 }