@ai-matrx/records 0.26.0 → 0.28.0

package/CHANGELOG.md

@@ -1,5 +1,56 @@
 # Changelog — @ai-matrx/records
 
+## 0.28.0
+
+**The owner's side of a booking page — the one method that was standing between
+`BookingSlots` and being the panel it should be.**
+
+`bookings({ table_id? })` over `custom.bookings`, which has been live and granted to
+`authenticated` since lane BOOKING landed and which no client could name. It is
+modelled line for line on `forms()`, because a booking page IS an `anon_form`: the
+same object, asked for its booking half, opened and closed by the same
+`anonPublish`. `BookingSummary` (`src/rule.ts`) carries what makes the list worth
+opening — booked, cancelled, still upcoming, how many slots somebody is holding
+right now, and when the next appointment is — every number the store's own, because
+a screen that counted appointments in the browser would drift from the unique index
+that actually protects a slot.
+
+`bookingPath(formId)` sits beside `publicFormPath` for the same reason: the page id
+IS the capability, and the visitor's `booking_ref` is the separate secret that lets
+ONE person manage the appointment they made.
+
+The VISITOR's three doors (`booking_public`, `booking_hold`, `booking_confirm`) are
+deliberately still absent from this client. They are server-lane, a signed-out
+visitor reaches them through the host's own route, and a browser never calls them.
+
+## 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,
@@ -72,6 +73,7 @@ __export(core_exports, {
   asPermissionLevel: () => asPermissionLevel,
   asWriteConflict: () => asWriteConflict,
   atLeast: () => atLeast,
+  bookingPath: () => bookingPath,
   cellText: () => cellText,
   choiceSlug: () => choiceSlug,
   choiceValuesOf: () => choiceValuesOf,
@@ -94,6 +96,7 @@ __export(core_exports, {
   isTheChosen: () => isTheChosen,
   looksLikeAnId: () => looksLikeAnId,
   mapPgError: () => mapPgError,
+  mayDrag: () => mayDrag,
   measureKey: () => measureKey,
   memoryStore: () => memoryStore,
   mintClientKey: () => mintClientKey,
@@ -242,7 +245,16 @@ 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 bookingPath(formId) {
+  return `/b/${formId}`;
+}
 function publicFormPath(formId) {
   return `/f/${formId}`;
 }
@@ -2354,6 +2366,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",
@@ -2369,6 +2387,12 @@ var DOORS = {
   // are server-lane doors and a browser never calls them.
   forms: "forms",
   formDeclare: "form_declare",
+  // PRODUCTS row 14 — "let clients book a 30-minute consult". A booking page IS an
+  // `anon_form`, so it is opened and closed by `anonPublish` like any other; this is
+  // the owner's list of them with the numbers that make it worth opening. The
+  // VISITOR's three (`booking_public`, `booking_hold`, `booking_confirm`) are
+  // deliberately absent: they are server-lane and a browser never calls them.
+  bookings: "bookings",
   // PRODUCTS row 9 — "pull my spreadsheet in". W4-IO built `io_import_open` and
   // `io_import_rows`; lane IMPORT gave a run an IDENTITY (the file's sha-256, so
   // a re-import doubles nothing), a duplicate key, a policy, per-row outcomes
@@ -3153,6 +3177,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,
@@ -3174,6 +3246,13 @@ function createRecordsClient(config) {
         "forms"
       );
     },
+    async bookings(args) {
+      return callDoor(
+        DOORS.bookings,
+        { p_organization_id: org, p_table_id: args?.table_id ?? null },
+        "bookings"
+      );
+    },
     async formDeclare(args) {
       return callDoor(
         DOORS.formDeclare,