@ai-matrx/records 0.26.0 → 0.27.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog — @ai-matrx/records
 
+## 0.27.0
+
+**"Give me a board of deals by stage" — the rules that judge every move become
+something a screen can ask about before the finger lets go.**
+
+A pipeline is not a new kind of thing and this release adds none. It is a Choice
+Field a Table names as its stage field, plus transition Rules of the ONE Rule
+object — so a move is an ordinary record write the store judges, History records
+because it IS a write, and every surface already knows how to read.
+
+`src/pipeline.ts`: `Pipeline`, `PipelineStage`, `PipelineRule`, `PipelineColumn`,
+`PipelineVerdict`, `PipelineMissingField`, `PipelineDeclared`, `PipelineSpec`.
+
+Six client methods, each one door: `pipelineRead`, `pipelineBoard`,
+`pipelineTransitionRefusal`, `pipelineMove`, `pipelineDeclare`, `tableStageField`.
+
+THIS PACKAGE ENFORCES NOTHING, and that is the point. `pipelineTransitionRefusal`
+asks the store the same question the write will ask — the same Rules, through the
+same evaluator, on the document the move WOULD produce — and hands back the store's
+own sentence plus, when a stage demands columns that are empty, exactly which ones.
+A board that decided in the browser would be a second opinion with nothing keeping
+it equal to the first, and it would be the comfortable one, because it is the one
+nobody can be refused by.
+
+`mayDrag(level)` is the one thing this package DOES decide, and it is about the
+person, not the rules: a viewer's card carries no drag handle at all rather than
+one that looks live and snaps back every time.
+
 ## 0.26.0
 
 **"Text me on a new lead; email me a Monday summary" — the second half of that

package/dist/core/index.cjs

@@ -53,6 +53,7 @@ __export(core_exports, {
   PARITY_FIELD_TYPES: () => PARITY_FIELD_TYPES,
   PERMISSION_LEVELS: () => PERMISSION_LEVELS,
   PER_VALUE_ACCESS_WORDS: () => PER_VALUE_ACCESS_WORDS,
+  PIPELINE_RULE_KINDS: () => PIPELINE_RULE_KINDS,
   REFUSALS_WORTH_REPEATING: () => REFUSALS_WORTH_REPEATING,
   RELATION_BINDINGS: () => RELATION_BINDINGS,
   RELATION_CARDINALITIES: () => RELATION_CARDINALITIES,
@@ -94,6 +95,7 @@ __export(core_exports, {
   isTheChosen: () => isTheChosen,
   looksLikeAnId: () => looksLikeAnId,
   mapPgError: () => mapPgError,
+  mayDrag: () => mayDrag,
   measureKey: () => measureKey,
   memoryStore: () => memoryStore,
   mintClientKey: () => mintClientKey,
@@ -242,6 +244,12 @@ function looksLikeAnId(value) {
   return typeof value === "string" && UUID.test(value);
 }
 
+// src/pipeline.ts
+var PIPELINE_RULE_KINDS = ["moves", "requires", "who", "limit", "entry"];
+function mayDrag(level) {
+  return level === "editor" || level === "admin" || level === "owner";
+}
+
 // src/rule.ts
 function publicFormPath(formId) {
   return `/f/${formId}`;
@@ -2354,6 +2362,12 @@ var DOORS = {
   tableKernelId: "table_kernel_id",
   // A saved view references its membership Rule, and the STORE decides who is
   // in it — the screen never re-implements the predicate.
+  pipelineDeclare: "pipeline_declare",
+  pipelineRead: "pipeline_read",
+  pipelineBoard: "pipeline_board",
+  pipelineTransitionRefusal: "pipeline_transition_refusal",
+  pipelineMove: "pipeline_move",
+  tableStageField: "table_stage_field",
   ruleMembers: "rule_members",
   ruleMembership: "rule_membership",
   ruleRun: "rule_run",
@@ -3153,6 +3167,54 @@ function createRecordsClient(config) {
     async ruleKernelId() {
       return callDoor(DOORS.ruleKernelId, {}, "ruleKernelId");
     },
+    async pipelineRead({ table_id }) {
+      return callDoor(
+        DOORS.pipelineRead,
+        { p_organization_id: org, p_table_id: table_id },
+        "pipelineRead"
+      );
+    },
+    async pipelineBoard({ table_id, measure }) {
+      return callDoor(
+        DOORS.pipelineBoard,
+        { p_organization_id: org, p_table_id: table_id, p_measure: measure ?? null },
+        "pipelineBoard"
+      );
+    },
+    async pipelineTransitionRefusal({ record_id, to }) {
+      return callDoor(
+        DOORS.pipelineTransitionRefusal,
+        { p_organization_id: org, p_record_id: record_id, p_to: to },
+        "pipelineTransitionRefusal"
+      );
+    },
+    async pipelineMove({ record_id, to, also, expected_version }) {
+      return callDoor(
+        DOORS.pipelineMove,
+        {
+          p_organization_id: org,
+          p_record_id: record_id,
+          p_to: to,
+          p_also: also ?? {},
+          p_expected_version: expected_version ?? null
+        },
+        "pipelineMove"
+      );
+    },
+    async pipelineDeclare({ table_id, spec }) {
+      return callDoor(
+        DOORS.pipelineDeclare,
+        { p_organization_id: org, p_table_id: table_id, p_spec: spec },
+        "pipelineDeclare"
+      );
+    },
+    async tableStageField({ table_id }) {
+      return callDoor(
+        DOORS.tableStageField,
+        { p_organization_id: org, p_table_id: table_id },
+        "tableStageField"
+      );
+    },
     async ruleMembers({ rule_id }) {
       return callDoor(
         DOORS.ruleMembers,