@mostajs/workflow 0.0.1

package/LICENSE

@@ -0,0 +1,15 @@
+@mostajs/workflow
+Copyright (C) 2026 Dr Hamid MADANI <drmdh@msn.com>
+
+This program is free software: you can redistribute it and/or modify it under
+the terms of the GNU Affero General Public License as published by the Free
+Software Foundation, either version 3 of the License, or (at your option) any
+later version.
+
+This program is distributed in the hope that it will be useful, but WITHOUT
+ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/agpl-3.0.html>.

package/README.md

@@ -0,0 +1,65 @@
+# @mostajs/workflow
+
+> La **stack** qui assemble le triptyque **State · Rule · Trigger** — `@mostajs/statemachine` (états + historique immuable) + `@mostajs/rules` (gardes, injecté) + `@mostajs/trigger` (réactions) — derrière **une API déclarative**. Aucune logique propre : **câblage + presets**. Modèle Drupal *Workflow + Rules + Trigger*, pattern `-stack` de l'écosystème.
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com> · **Licence** : AGPL-3.0-or-later
+
+C'est la **seule dépendance workflow** de `@mostajs/crm` (+ `@mostajs/numbering`) : le domaine ne câble pas les trois primitives lui-même.
+
+## Installation
+
+```bash
+npm i @mostajs/workflow @mostajs/statemachine @mostajs/trigger
+# @mostajs/rules : optionnel (seulement si une transition utilise when: { rule })
+```
+
+## Exemple
+
+```ts
+import { defineWorkflow, orderWorkflowDef } from "@mostajs/workflow";
+
+const base = orderWorkflowDef(); // preset : automate fini de commande (9 états, couleurs + party)
+const emails: string[] = [];
+
+const wf = defineWorkflow(
+  {
+    ...base,
+    transitions: base.transitions.map((t) =>
+      t.id === "notifier" ? { ...t, then: [(tr) => emails.push(`notify:${tr.toState}`)] } : t,
+    ),
+  },
+  { checkPermission: (actorId) => actorId === "admin" },
+);
+
+const ref = { entityType: "order", entityId: "42" };
+await wf.transition(ref, "init", "notification_attente", { actorId: "admin" });
+// init → notification_attente → relance_emetteur_attente → reponse_attente →
+// relance_destinataire_attente → validation_attente → finalisation_attente → client_informe
+await wf.history(ref); // historique immuable (qui / quand / from→to)
+```
+
+## Ce que la stack câble
+
+| Déclaratif | Câblé vers |
+|---|---|
+| `transition.when` (fonction ou `{ rule }`) | garde `@mostajs/statemachine` (`{ rule }` résolu via `RuleEvaluator` = `@mostajs/rules`) |
+| `transition.then[]` | triggers `@mostajs/trigger` sur `transition:<id>` |
+| `onPost` de la FSM | `hub.fire("transition:<id>")` puis `"enter:<to>"` (fire-and-forget) |
+| historique immuable | `@mostajs/statemachine` (via `AuditSink` / `@mostajs/audit`) |
+
+## Garde déclarative via `@mostajs/rules`
+
+```ts
+import { createKnowledgeBase } from "@mostajs/rules";
+const kb = createKnowledgeBase();
+// transition { id:"valid", from:["attente_admin"], to:"validee", when:{ rule:"transition_allowed(...)" } }
+const wf = defineWorkflow(def, { rules: kb }); // kb.holds(goal, ctx)
+```
+
+## API
+
+`defineWorkflow(def, opts?)` → `Workflow`. `wf.availableTransitions/canTransition/transition/history`, `wf.on(event, action)`, `wf.hub`. `WorkflowOptions = { audit?, checkPermission?, now?, rules?, hub? }`. Preset : `orderWorkflowDef()`.
+
+## Statut
+
+**v0.0.1** — assemblage **implémenté et testé** (`defineWorkflow` câblant `statemachine` + `trigger`, `when` fonction + `{ rule }`, `then`→triggers) + preset `orderWorkflow`. Feuille de route : `docs/03-PLAN-DEV-WORKFLOW.md`. Étude : `docs/01-ETUDE-ETAT-ART-WORKFLOW-07062026.md`.

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @mostajs/workflow — point d'entrée public (STACK State·Rule·Trigger).
+ *
+ * Assemble @mostajs/statemachine + @mostajs/rules (injecté) + @mostajs/trigger
+ * en un workflow clé en main. Seule dépendance de @mostajs/crm (+ numbering).
+ *
+ * @author Dr Hamid MADANI <drmdh@msn.com>
+ * @license AGPL-3.0-or-later
+ */
+export { type RuleEvaluator, type RuleRef, type WhenSpec, type WorkflowAction, type WorkflowTransition, type WorkflowDef, type WorkflowOptions, WorkflowError, MissingRuleEvaluatorError, } from "./types.js";
+export { Workflow, defineWorkflow } from "./workflow.js";
+export { orderWorkflowDef, orderWorkflowBundles, ORDER_STATE_IDS, type OrderBundle, } from "./preset.js";
+export type { EntityRef, ExecutedTransition, State } from "@mostajs/statemachine";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,aAAa,EACb,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @mostajs/workflow — point d'entrée public (STACK State·Rule·Trigger).
+ *
+ * Assemble @mostajs/statemachine + @mostajs/rules (injecté) + @mostajs/trigger
+ * en un workflow clé en main. Seule dépendance de @mostajs/crm (+ numbering).
+ *
+ * @author Dr Hamid MADANI <drmdh@msn.com>
+ * @license AGPL-3.0-or-later
+ */
+export { WorkflowError, MissingRuleEvaluatorError, } from "./types.js";
+export { Workflow, defineWorkflow } from "./workflow.js";
+export { orderWorkflowDef, orderWorkflowBundles, ORDER_STATE_IDS, } from "./preset.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAQL,aAAa,EACb,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,GAEhB,MAAM,aAAa,CAAC"}

package/dist/preset.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @mostajs/workflow — preset `orderWorkflow` : cycle de vie d'une commande de trading.
+ *
+ * Les 8 états du cahier des charges (§3.5), enrichis d'un **code couleur** (UI), d'une
+ * **`party`** (émetteur=interne / receiver=fournisseur) et d'un **libellé = clé i18n**
+ * (`order:state.<id>`, traduit FR/EN/AR via `orderWorkflowBundles()`).
+ *
+ * @author Dr Hamid MADANI <drmdh@msn.com>
+ * @license AGPL-3.0-or-later
+ */
+import type { WorkflowDef } from "./types.js";
+/** Bundle de traduction (forme compatible @mostajs/i18n `Bundle`). */
+export interface OrderBundle {
+    locale: string;
+    namespace: string;
+    messages: Record<string, unknown>;
+}
+/** Ordre canonique des états (CDC §3.5). */
+export declare const ORDER_STATE_IDS: readonly ["nouvelle", "en_cours", "attente_fournisseur", "attente_admin", "proformat_etabli", "validee", "terminee", "annulee"];
+/** Définition du workflow de commande (8 états CDC + transitions + permissions par transition). */
+export declare function orderWorkflowDef(): WorkflowDef;
+/** Bundles de traduction (namespace `order`) pour @mostajs/i18n — FR (défaut), EN, AR. */
+export declare function orderWorkflowBundles(): OrderBundle[];
+//# sourceMappingURL=preset.d.ts.map

package/dist/preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../src/preset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,4CAA4C;AAC5C,eAAO,MAAM,eAAe,iIASlB,CAAC;AAEX,mGAAmG;AACnG,wBAAgB,gBAAgB,IAAI,WAAW,CA8B9C;AAED,0FAA0F;AAC1F,wBAAgB,oBAAoB,IAAI,WAAW,EAAE,CA6CpD"}

package/dist/preset.js

@@ -0,0 +1,101 @@
+/**
+ * @mostajs/workflow — preset `orderWorkflow` : cycle de vie d'une commande de trading.
+ *
+ * Les 8 états du cahier des charges (§3.5), enrichis d'un **code couleur** (UI), d'une
+ * **`party`** (émetteur=interne / receiver=fournisseur) et d'un **libellé = clé i18n**
+ * (`order:state.<id>`, traduit FR/EN/AR via `orderWorkflowBundles()`).
+ *
+ * @author Dr Hamid MADANI <drmdh@msn.com>
+ * @license AGPL-3.0-or-later
+ */
+/** Ordre canonique des états (CDC §3.5). */
+export const ORDER_STATE_IDS = [
+    "nouvelle",
+    "en_cours",
+    "attente_fournisseur",
+    "attente_admin",
+    "proformat_etabli",
+    "validee",
+    "terminee",
+    "annulee",
+];
+/** Définition du workflow de commande (8 états CDC + transitions + permissions par transition). */
+export function orderWorkflowDef() {
+    return {
+        name: "order",
+        states: [
+            { id: "nouvelle", label: "order:state.nouvelle", initial: true, weight: 0, color: "#3B82F6" },
+            { id: "en_cours", label: "order:state.en_cours", weight: 1, color: "#F59E0B", meta: { party: "sender" } },
+            { id: "attente_fournisseur", label: "order:state.attente_fournisseur", weight: 2, color: "#F97316", meta: { party: "receiver" } },
+            { id: "attente_admin", label: "order:state.attente_admin", weight: 3, color: "#EAB308", meta: { party: "sender" } },
+            { id: "proformat_etabli", label: "order:state.proformat_etabli", weight: 4, color: "#8B5CF6", meta: { party: "receiver" } },
+            { id: "validee", label: "order:state.validee", weight: 5, color: "#10B981", meta: { party: "sender" } },
+            { id: "terminee", label: "order:state.terminee", terminal: true, weight: 6, color: "#059669" },
+            { id: "annulee", label: "order:state.annulee", terminal: true, weight: 7, color: "#EF4444" },
+        ],
+        transitions: [
+            { id: "start", from: ["nouvelle"], to: "en_cours", label: "order:transition.start", permission: "crm.order.transition.start" },
+            { id: "to_supplier", from: ["en_cours"], to: "attente_fournisseur", label: "order:transition.to_supplier", permission: "crm.order.transition.to_supplier" },
+            { id: "supplier_back", from: ["attente_fournisseur"], to: "en_cours", label: "order:transition.supplier_back", permission: "crm.order.transition.supplier_back" },
+            { id: "to_admin", from: ["en_cours", "attente_fournisseur"], to: "attente_admin", label: "order:transition.to_admin", permission: "crm.order.transition.to_admin" },
+            { id: "set_proforma", from: ["attente_admin"], to: "proformat_etabli", label: "order:transition.set_proforma", permission: "crm.order.transition.set_proforma" },
+            { id: "validate", from: ["proformat_etabli"], to: "validee", label: "order:transition.validate", permission: "crm.order.transition.validate" },
+            { id: "finish", from: ["validee"], to: "terminee", label: "order:transition.finish", permission: "crm.order.transition.finish" },
+            {
+                id: "cancel",
+                from: ["nouvelle", "en_cours", "attente_fournisseur", "attente_admin", "proformat_etabli", "validee"],
+                to: "annulee",
+                label: "order:transition.cancel",
+                permission: "crm.order.transition.cancel",
+            },
+        ],
+    };
+}
+/** Bundles de traduction (namespace `order`) pour @mostajs/i18n — FR (défaut), EN, AR. */
+export function orderWorkflowBundles() {
+    return [
+        {
+            locale: "fr", namespace: "order",
+            messages: {
+                state: {
+                    nouvelle: "Nouvelle commande", en_cours: "En cours de traitement", attente_fournisseur: "En attente fournisseur",
+                    attente_admin: "En attente admin", proformat_etabli: "Proformat établi", validee: "Validée",
+                    terminee: "Terminée", annulee: "Annulée",
+                },
+                transition: {
+                    start: "Prendre en charge", to_supplier: "Vers fournisseur", supplier_back: "Retour fournisseur",
+                    to_admin: "Vers admin", set_proforma: "Établir le proformat", validate: "Valider", finish: "Terminer", cancel: "Annuler",
+                },
+            },
+        },
+        {
+            locale: "en", namespace: "order",
+            messages: {
+                state: {
+                    nouvelle: "New order", en_cours: "In progress", attente_fournisseur: "Awaiting supplier",
+                    attente_admin: "Awaiting admin", proformat_etabli: "Proforma issued", validee: "Validated",
+                    terminee: "Completed", annulee: "Cancelled",
+                },
+                transition: {
+                    start: "Take in charge", to_supplier: "To supplier", supplier_back: "Supplier reply",
+                    to_admin: "To admin", set_proforma: "Issue proforma", validate: "Validate", finish: "Complete", cancel: "Cancel",
+                },
+            },
+        },
+        {
+            locale: "ar", namespace: "order",
+            messages: {
+                state: {
+                    nouvelle: "طلب جديد", en_cours: "قيد المعالجة", attente_fournisseur: "في انتظار المورّد",
+                    attente_admin: "في انتظار المدير", proformat_etabli: "فاتورة أولية مُعدّة", validee: "مُصادق عليها",
+                    terminee: "مكتملة", annulee: "ملغاة",
+                },
+                transition: {
+                    start: "تكفّل", to_supplier: "إلى المورّد", supplier_back: "رد المورّد",
+                    to_admin: "إلى المدير", set_proforma: "إعداد الفاتورة الأولية", validate: "مصادقة", finish: "إنهاء", cancel: "إلغاء",
+                },
+            },
+        },
+    ];
+}
+//# sourceMappingURL=preset.js.map

package/dist/preset.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @mostajs/workflow — types de la stack d'assemblage.
+ *
+ * @author Dr Hamid MADANI <drmdh@msn.com>
+ * @license AGPL-3.0-or-later
+ */
+import type { State, Guard, AuditSink, PermissionCheck, ExecutedTransition } from "@mostajs/statemachine";
+import type { TriggerHub } from "@mostajs/trigger";
+/**
+ * Évaluateur de règle **injecté** (interface minimale, satisfaite par
+ * `@mostajs/rules` : `(goal, ctx) => holds`). Évite une dépendance dure à rules.
+ */
+export interface RuleEvaluator {
+    holds(goal: string, ctx: Record<string, unknown>): boolean | Promise<boolean>;
+}
+/** Référence à une règle nommée/textuelle (Prolog) — résolue via `RuleEvaluator`. */
+export interface RuleRef {
+    rule: string;
+}
+/** Garde d'une transition : soit une fonction (statemachine), soit une référence de règle (rules). */
+export type WhenSpec = Guard | RuleRef;
+/** Réaction exécutée après une transition (déléguée à @mostajs/trigger). */
+export type WorkflowAction = (transition: ExecutedTransition) => void | Promise<void>;
+/** Transition de workflow (déclarative) : chemin + permission + garde + réactions. */
+export interface WorkflowTransition {
+    id: string;
+    from: string[];
+    to: string;
+    label?: string;
+    permission?: string;
+    when?: WhenSpec;
+    then?: WorkflowAction[];
+}
+/** Définition d'un workflow. */
+export interface WorkflowDef {
+    name: string;
+    states: State[];
+    transitions: WorkflowTransition[];
+}
+/** Options d'assemblage (toutes injectées). */
+export interface WorkflowOptions {
+    audit?: AuditSink;
+    checkPermission?: PermissionCheck;
+    now?: () => Date;
+    /** Évaluateur de règles (requis si une transition utilise `when: { rule }`). */
+    rules?: RuleEvaluator;
+    /** Hub de triggers (défaut : un hub neuf). */
+    hub?: TriggerHub;
+}
+export declare class WorkflowError extends Error {
+    constructor(message: string);
+}
+/** Une transition utilise `when: { rule }` mais aucun `RuleEvaluator` n'a été injecté. */
+export declare class MissingRuleEvaluatorError extends WorkflowError {
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,KAAK,EACL,SAAS,EACT,eAAe,EACf,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/E;AAED,qFAAqF;AACrF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sGAAsG;AACtG,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;AAEvC,4EAA4E;AAC5E,MAAM,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtF,sFAAsF;AACtF,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,IAAI,CAAC,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,gCAAgC;AAChC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,gFAAgF;IAChF,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB;AAED,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AACD,0FAA0F;AAC1F,qBAAa,yBAA0B,SAAQ,aAAa;CAAG"}

package/dist/types.js

@@ -0,0 +1,16 @@
+/**
+ * @mostajs/workflow — types de la stack d'assemblage.
+ *
+ * @author Dr Hamid MADANI <drmdh@msn.com>
+ * @license AGPL-3.0-or-later
+ */
+export class WorkflowError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+/** Une transition utilise `when: { rule }` mais aucun `RuleEvaluator` n'a été injecté. */
+export class MissingRuleEvaluatorError extends WorkflowError {
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2DH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AACD,0FAA0F;AAC1F,MAAM,OAAO,yBAA0B,SAAQ,aAAa;CAAG"}

package/dist/workflow.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @mostajs/workflow — la stack : assemble State·Rule·Trigger. AUCUNE logique propre.
+ *
+ * Câble : `when` → garde @mostajs/statemachine (via RuleEvaluator si `{rule}`),
+ * `then` → triggers @mostajs/trigger (sur `transition:<id>`), historique → audit
+ * (assuré par statemachine). C'est la seule dépendance de @mostajs/crm (+ numbering).
+ *
+ * @author Dr Hamid MADANI <drmdh@msn.com>
+ * @license AGPL-3.0-or-later
+ */
+import { type ConfigTransition, type EntityRef, type ExecutedTransition, type State, type CanResult, type TransitionInput } from "@mostajs/statemachine";
+import { type TriggerHub, type Action } from "@mostajs/trigger";
+import { type WorkflowDef, type WorkflowOptions } from "./types.js";
+export declare class Workflow {
+    readonly name: string;
+    readonly hub: TriggerHub;
+    private readonly machine;
+    constructor(def: WorkflowDef, opts?: WorkflowOptions);
+    get states(): ReadonlyMap<string, State>;
+    get initial(): string;
+    availableTransitions(current: string, input?: TransitionInput): Promise<ConfigTransition[]>;
+    canTransition(from: string, to: string, input?: TransitionInput): Promise<CanResult>;
+    /** Exécute la transition (journalise via statemachine ; déclenche les réactions via trigger). */
+    transition(ref: EntityRef, from: string, to: string, input?: TransitionInput): Promise<ExecutedTransition>;
+    history(ref: EntityRef): Promise<ExecutedTransition[]>;
+    /** Abonner une réaction supplémentaire (ex. `on("enter:validee", ...)`). */
+    on(event: string, action: Action): this;
+}
+/** Définit (et assemble) un workflow à partir des trois primitives. */
+export declare function defineWorkflow(def: WorkflowDef, opts?: WorkflowOptions): Workflow;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAGL,KAAK,gBAAgB,EAGrB,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAoB,KAAK,UAAU,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,eAAe,EAKrB,MAAM,YAAY,CAAC;AA8BpB,qBAAa,QAAQ;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,GAAG,EAAE,WAAW,EAAE,IAAI,GAAE,eAAoB;IAkCxD,IAAI,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAEvC;IACD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAG3F,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAGpF,iGAAiG;IACjG,UAAU,CACR,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,KAAK,CAAC,EAAE,eAAe,GACtB,OAAO,CAAC,kBAAkB,CAAC;IAG9B,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAItD,4EAA4E;IAC5E,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAIxC;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,QAAQ,CAEjF"}

package/dist/workflow.js

@@ -0,0 +1,94 @@
+/**
+ * @mostajs/workflow — la stack : assemble State·Rule·Trigger. AUCUNE logique propre.
+ *
+ * Câble : `when` → garde @mostajs/statemachine (via RuleEvaluator si `{rule}`),
+ * `then` → triggers @mostajs/trigger (sur `transition:<id>`), historique → audit
+ * (assuré par statemachine). C'est la seule dépendance de @mostajs/crm (+ numbering).
+ *
+ * @author Dr Hamid MADANI <drmdh@msn.com>
+ * @license AGPL-3.0-or-later
+ */
+import { defineMachine, } from "@mostajs/statemachine";
+import { createTriggerHub } from "@mostajs/trigger";
+import { MissingRuleEvaluatorError, } from "./types.js";
+function isRuleRef(when) {
+    return typeof when === "object" && when !== null && "rule" in when;
+}
+/** Convertit le `when` déclaratif en garde statemachine (résout `{rule}` via l'évaluateur injecté). */
+function resolveGuard(when, transitionId, rules) {
+    if (!when)
+        return undefined;
+    if (typeof when === "function")
+        return when;
+    // when est une RuleRef → nécessite un RuleEvaluator (rules)
+    if (!rules) {
+        throw new MissingRuleEvaluatorError(`Transition "${transitionId}" utilise when:{ rule } mais aucun RuleEvaluator (@mostajs/rules) n'est injecté.`);
+    }
+    const goal = when.rule;
+    return (ctx) => rules.holds(goal, {
+        from: ctx.from,
+        to: ctx.to,
+        actorId: ctx.actorId,
+        ...(ctx.data ?? {}),
+    });
+}
+export class Workflow {
+    name;
+    hub;
+    machine;
+    constructor(def, opts = {}) {
+        this.name = def.name;
+        this.hub = opts.hub ?? createTriggerHub();
+        // 1) Mapper les transitions de workflow → transitions de configuration statemachine.
+        const mapped = def.transitions.map((t) => ({
+            id: t.id,
+            from: t.from,
+            to: t.to,
+            label: t.label,
+            permission: t.permission,
+            guard: resolveGuard(t.when, t.id, opts.rules),
+        }));
+        this.machine = defineMachine({ states: def.states, transitions: mapped }, { audit: opts.audit, checkPermission: opts.checkPermission, now: opts.now });
+        // 2) Enregistrer les réactions `then` comme triggers sur `transition:<id>`.
+        for (const t of def.transitions) {
+            (t.then ?? []).forEach((action, i) => {
+                const handler = (ctx) => action(ctx.transition);
+                this.hub.define({ name: `${def.name}:${t.id}#${i}`, on: `transition:${t.id}`, do: handler });
+            });
+        }
+        // 3) Câbler les hooks de la FSM vers le hub (réactions fire-and-forget).
+        this.machine.onPost(async (tr) => {
+            await this.hub.fire(`transition:${tr.transitionId}`, { transition: tr });
+            await this.hub.fire(`enter:${tr.toState}`, { transition: tr });
+        });
+    }
+    get states() {
+        return this.machine.states;
+    }
+    get initial() {
+        return this.machine.initial;
+    }
+    availableTransitions(current, input) {
+        return this.machine.availableTransitions(current, input);
+    }
+    canTransition(from, to, input) {
+        return this.machine.canTransition(from, to, input);
+    }
+    /** Exécute la transition (journalise via statemachine ; déclenche les réactions via trigger). */
+    transition(ref, from, to, input) {
+        return this.machine.transition(ref, from, to, input);
+    }
+    history(ref) {
+        return this.machine.history(ref);
+    }
+    /** Abonner une réaction supplémentaire (ex. `on("enter:validee", ...)`). */
+    on(event, action) {
+        this.hub.on(event, action);
+        return this;
+    }
+}
+/** Définit (et assemble) un workflow à partir des trois primitives. */
+export function defineWorkflow(def, opts) {
+    return new Workflow(def, opts);
+}
+//# sourceMappingURL=workflow.js.map

package/dist/workflow.js.map

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

package/llms.txt

@@ -0,0 +1,65 @@
+# @mostajs/workflow — fiche LLM
+
+RÔLE
+  STACK d'assemblage du triptyque State·Rule·Trigger (modèle Drupal Workflow+Rules+Trigger).
+  AUCUNE logique propre : câble @mostajs/statemachine (états + historique immuable),
+  @mostajs/rules (garde `when`, injectée) et @mostajs/trigger (réactions `then`) derrière
+  UNE API déclarative defineWorkflow(...). Fournit le preset orderWorkflow (8 états CDC).
+  C'est la SEULE dépendance workflow de @mostajs/crm (+ @mostajs/numbering) — le domaine
+  ne voit pas les 3 primitives.
+
+INSTALL
+  npm i @mostajs/workflow @mostajs/statemachine @mostajs/trigger
+  # @mostajs/rules : peer OPTIONNELLE (requise seulement si une transition utilise when:{ rule })
+
+EXPORTS
+  defineWorkflow(def, opts?) -> Workflow
+  Workflow : states ; initial ; availableTransitions(current, input?) ; canTransition(from,to,input?)
+             transition(ref, from, to, input?) -> Promise<ExecutedTransition> ; history(ref) ; on(event, action) ; hub
+  orderWorkflowDef() -> WorkflowDef         # preset 8 états CDC
+  Types : WorkflowDef, WorkflowTransition { id, from[], to, label?, permission?, when?, then? },
+          WhenSpec = Guard | { rule: string }, WorkflowAction = (ExecutedTransition)=>void|Promise,
+          RuleEvaluator { holds(goal, ctx) }, WorkflowOptions { audit?, checkPermission?, now?, rules?, hub? }
+  Ré-exports : EntityRef, ExecutedTransition, State (depuis @mostajs/statemachine)
+  Erreurs : WorkflowError, MissingRuleEvaluatorError
+
+CÂBLAGE (ce que fait la stack)
+  - transition.when (fonction OU { rule }) -> garde @mostajs/statemachine
+      ({ rule } est résolu via opts.rules.holds(goal, ctx) — sinon MissingRuleEvaluatorError)
+  - transition.then[] -> triggers @mostajs/trigger sur l'événement "transition:<id>"
+  - statemachine.onPost -> hub.fire("transition:<id>") puis hub.fire("enter:<to>")  (fire-and-forget)
+  - historique immuable -> assuré par statemachine (via AuditSink / @mostajs/audit)
+
+EXEMPLE
+  import { defineWorkflow, orderWorkflowDef } from "@mostajs/workflow";
+  const emails = [];
+  const wf = defineWorkflow(
+    {
+      ...orderWorkflowDef(),
+      transitions: orderWorkflowDef().transitions.map((t) =>
+        t.id === "notifier" ? { ...t, then: [(tr) => emails.push(tr.toState)] } : t),
+    },
+    { checkPermission: (actorId) => actorId === "admin" },   // sinon permission refusée
+  );
+  const ref = { entityType: "order", entityId: "42" };
+  await wf.transition(ref, "init", "notification_attente", { actorId: "admin" });
+  // automate : init → notification_attente → relance_emetteur_attente → reponse_attente →
+  //            relance_destinataire_attente → validation_attente → finalisation_attente → client_informe
+  // chaque état porte color (#RRGGBB) + meta.party ("sender"|"receiver")
+  await wf.history(ref);   // historique immuable
+
+  // garde déclarative via @mostajs/rules (when: { rule })
+  // defineWorkflow(def, { rules: kb })  où kb.holds(goal, ctx) provient de createKnowledgeBase()
+
+PIÈGES
+  - Toutes les opérations sont ASYNCHRONES.
+  - when:{ rule } SANS opts.rules => MissingRuleEvaluatorError (injecter @mostajs/rules).
+  - `then` exécutées en fire-and-forget (trigger) : une réaction qui échoue n'interrompt pas la transition.
+  - permission par transition enforcée seulement si opts.checkPermission injecté (sinon métadonnée).
+  - ZÉRO logique dans la stack : toute logique appartient à une primitive.
+  - Versions peer des 3 primitives à garder compatibles (SemVer).
+
+STATUT
+  v0.0.1 — assemblage IMPLÉMENTÉ (defineWorkflow câblant statemachine+trigger, when fonction + { rule },
+  then->triggers) + preset orderWorkflow, testé. Voir docs/03-PLAN-DEV-WORKFLOW.md.
+  Licence AGPL-3.0-or-later. Auteur Dr Hamid MADANI.

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@mostajs/workflow",
+  "version": "0.0.1",
+  "description": "Turnkey workflow STACK assembling the State·Rule·Trigger triptych: @mostajs/statemachine (states + immutable history) + @mostajs/rules (guards, injected) + @mostajs/trigger (reactions). Single declarative API + orderWorkflow preset. No business logic — wiring only.",
+  "author": "Dr Hamid MADANI <drmdh@msn.com>",
+  "license": "AGPL-3.0-or-later",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "peerDependencies": {
+    "@mostajs/statemachine": "^0.0.1",
+    "@mostajs/trigger": "^0.0.1",
+    "@mostajs/rules": "^0.0.1"
+  },
+  "peerDependenciesMeta": {
+    "@mostajs/rules": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "llms.txt"
+  ],
+  "keywords": [
+    "workflow",
+    "stack",
+    "state-machine",
+    "rules",
+    "trigger",
+    "eca",
+    "orchestration",
+    "mosta",
+    "mostajs"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/apolocine/mosta-workflow"
+  },
+  "homepage": "https://mostajs.dev/packages/workflow",
+  "bugs": {
+    "url": "https://github.com/apolocine/mosta-workflow/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "@mostajs/statemachine": "^0.0.1",
+    "@mostajs/trigger": "^0.0.1"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "node --test test-scripts/*.test.mjs"
+  }
+}