@beehexa/hexasync-template-frontend-flow 2608.20.18 → 2608.20.32

package/dist/workflows.js

@@ -0,0 +1,82 @@
+/**
+ * The frontend workflows, and their titles — Story 4.2 AC-1.
+ *
+ * ### A separate package, deliberately (AD-21)
+ *
+ * A frontend step is never resolved with the worker vocabulary, and this is where that becomes structural rather than
+ * a convention. The two runtimes genuinely differ, in four ways measured off the reference implementation
+ * (`dashboard-v2/src/pages/__dev/lib/connectorWorkflowMermaid.ts`):
+ *
+ * | | worker | frontend |
+ * | --- | --- | --- |
+ * | branch arms | `then` / `else` | `then` **or** `success` / `else` **or** `failed` |
+ * | `IF` reads | `data` | `metadata` |
+ * | `SWITCH` reads | `data`'s KEYS | `metadata.cases` (a record) + `metadata.default` |
+ * | extra route | `onError` | `onCancelled`, labelled `Cancel` |
+ *
+ * Two more the worker side has no equivalent for: an explicit **`END`** terminal when a step declares no `next`, and
+ * no expression handling at all — a frontend `next` is a key, a branch object, or nothing.
+ *
+ * ⛔ **So the two packages must NOT share a branch reader.** The temptation to unify them is the thing to resist:
+ * teaching the worker model about `success`/`failed` would make it accept documents the worker runtime rejects, which
+ * is exactly the invention NFR-1 forbids.
+ */
+/** The five workflows a CONNECTOR DEFINITION may declare, in the order the reference implementation lists them. */
+export const CONNECTOR_WORKFLOW_KEYS = [
+    'appRegistrationSteps',
+    'authorizationSteps',
+    'authorizationCallbackSteps',
+    'installStandaloneCallbackSteps',
+    'setupSteps',
+];
+/** The one a TEMPLATE declares. Separate because it lives on a different document. */
+export const TEMPLATE_WORKFLOW_KEYS = ['creationSteps'];
+export const FRONTEND_WORKFLOW_KEYS = [
+    ...CONNECTOR_WORKFLOW_KEYS,
+    ...TEMPLATE_WORKFLOW_KEYS,
+];
+/**
+ * A human title per workflow — AC-1's *"drawn with its own title"*.
+ *
+ * ⚠️ **PRESERVED from the recorded baseline** (Story 4.2 review, M2). The first version renamed five of the six —
+ * `App Registration` → `App registration`, `Profile Setup` → `Setup`, `Profile Creation` → `Creation` and so on — on
+ * the reasoning that the word *Steps* is noise and sentence case reads better. Two things were wrong with that: the
+ * baseline README records these titles as rendered output, so changing them needs an adopt/preserve/accept verdict per
+ * `golden-flows/README.md`, and nothing was asserting them — **setting all six to the same string left all 27 tests
+ * green**, because only `authorizationSteps` (the one title that happened not to change) was compared exactly.
+ *
+ * PRESERVE is the verdict: these are the titles two shipped surfaces already draw, and the case argument is a
+ * preference, not a defect. Each is now asserted exactly.
+ */
+export const FRONTEND_WORKFLOW_TITLES = {
+    appRegistrationSteps: 'App Registration',
+    authorizationSteps: 'Authorization',
+    authorizationCallbackSteps: 'Authorization Callback',
+    installStandaloneCallbackSteps: 'Install Standalone Callback',
+    setupSteps: 'Profile Setup',
+    creationSteps: 'Profile Creation',
+};
+export function surfaceOf(key) {
+    return CONNECTOR_WORKFLOW_KEYS.includes(key)
+        ? 'connector'
+        : 'template';
+}
+/**
+ * The workflows a document actually declares, in the order above.
+ *
+ * Non-empty, for the same reason the worker package requires it: a declared-but-empty workflow is a fact about the
+ * document, not a diagram a reader can be sent to. (The worker side shipped the looser rule and the review measured
+ * 4,519 corpus occurrences of an arrow into nothing.)
+ */
+export function workflowsPresent(document, 
+/**
+ * How many of an array's items are actually DRAWABLE. Injected so this module stays free of step semantics while
+ * still measuring the right thing.
+ */
+drawableCount = (items) => items.length) {
+    return FRONTEND_WORKFLOW_KEYS.filter((key) => {
+        const value = document[key];
+        return Array.isArray(value) && drawableCount(value) > 0;
+    });
+}
+//# sourceMappingURL=workflows.js.map

package/dist/workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../src/workflows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,mHAAmH;AACnH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,sBAAsB;IACtB,oBAAoB;IACpB,4BAA4B;IAC5B,gCAAgC;IAChC,YAAY;CACJ,CAAC;AAEX,sFAAsF;AACtF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,eAAe,CAAU,CAAC;AAMjE,MAAM,CAAC,MAAM,sBAAsB,GAAmC;IACpE,GAAG,uBAAuB;IAC1B,GAAG,sBAAsB;CAC1B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAEjC;IACF,oBAAoB,EAAE,kBAAkB;IACxC,kBAAkB,EAAE,eAAe;IACnC,0BAA0B,EAAE,wBAAwB;IACpD,8BAA8B,EAAE,6BAA6B;IAC7D,UAAU,EAAE,eAAe;IAC3B,aAAa,EAAE,kBAAkB;CAClC,CAAC;AAKF,MAAM,UAAU,SAAS,CAAC,GAAwB;IAChD,OAAQ,uBAA6C,CAAC,QAAQ,CAAC,GAAG,CAAC;QACjE,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,UAAU,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAiC;AACjC;;;GAGG;AACH,aAAa,GAA0C,CAAC,KAAK,EAAE,EAAE,CAC/D,KAAK,CAAC,MAAM;IAEd,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;QAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beehexa/hexasync-template-frontend-flow",
-  "version": "2608.20.18",
+  "version": "2608.20.32",
   "description": "The flow model for a frontend onboarding workflow — creationSteps and the five connector workflows.",
   "license": "SEE LICENSE IN ../../LICENSE",
   "type": "module",
@@ -20,7 +20,7 @@
     "build": "tsc -p tsconfig.build.json"
   },
   "dependencies": {
-    "@beehexa/hexasync-template-model": "2608.20.18"
+    "@beehexa/hexasync-template-model": "2608.20.32"
   },
   "hexasync": {
     "layer": "core"