@mostajs/aop-engine 0.1.0

package/README.md

@@ -0,0 +1,5 @@
+# @mostajs/aop-engine
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+
+Moteur de **veille multi-client** : câble `@mostajs/aop-scheduler` → hub `@mostajs/trigger` → **livraison au client** (notification, seam injecté). Compose scheduler + clients/veilles + notify. Stack `mosta-aop-stack`.

package/llms.txt

@@ -0,0 +1,10 @@
+# @mostajs/aop-engine — fiche LLM
+> Moteur de veille MULTI-CLIENT : câble aop-scheduler → hub @mostajs/trigger → LIVRAISON au client (notification).
+
+## EXPORTS
+createVeilleEngine({ ingestion, tenders, veilles(aop-clients), clients(aop-clients), hub(@mostajs/trigger), notify?, audit?, now }) -> { runVeille(scrapers,filters), hub, scheduler }
+createFakeHub() (./src/fake-hub.js) — hub minimal pour tests ; en prod createTriggerHub() de @mostajs/trigger.
+
+## FLUX
+runVeille -> scheduler (ingère+matche veilles) -> hub.fire(aop:tender:matched) -> réaction enregistrée: résout client -> notify.send -> stats++.
+Stack mosta-aop-stack. notify = seam (@mostajs/notifications/mailer).

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@mostajs/aop-engine",
+  "version": "0.1.0",
+  "description": "Moteur de veille multi-client : câble aop-scheduler → hub @mostajs/trigger → livraison au client (notification). Composition transverse.",
+  "author": "Dr Hamid MADANI <drmdh@msn.com>",
+  "license": "AGPL-3.0-or-later",
+  "type": "module",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "llms.txt"
+  ],
+  "dependencies": {
+    "@mostajs/aop-scheduler": "^0.1.0"
+  },
+  "peerDependencies": {
+    "@mostajs/trigger": "*"
+  },
+  "peerDependenciesMeta": {
+    "@mostajs/trigger": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@mostajs/mjs-unit": "^0.3.0"
+  },
+  "scripts": {
+    "test": "node test-scripts/unit/aop-engine.test.mjs && node examples/run.mjs"
+  }
+}

package/src/fake-hub.js

@@ -0,0 +1,8 @@
+// Hub minimal compatible @mostajs/trigger pour TESTS/exemples (define + fire pondéré). En prod : createTriggerHub().
+export function createFakeHub() {
+  const handlers = [];
+  return {
+    define: (def) => { handlers.push(def); return def; },
+    fire: async (event, ctx) => { for (const h of handlers.filter((d) => d.on === event).sort((a, b) => (a.weight || 0) - (b.weight || 0))) { if (!h.when || h.when(ctx)) await h.do(ctx); } },
+  };
+}

package/src/index.js

@@ -0,0 +1,46 @@
+// @mostajs/aop-engine — moteur de veille multi-client : câble aop-scheduler → hub @mostajs/trigger →
+// LIVRAISON au client (notification). Compose scheduler + hub(trigger) + notify(seam) + clients/veilles/tenders.
+// @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+import { createScheduler } from '@mostajs/aop-scheduler';
+
+/**
+ * @param {object} deps
+ * @param {object} deps.ingestion  service @mostajs/aop-ingestion
+ * @param {object} deps.tenders    service @mostajs/aop-core
+ * @param {object} deps.veilles    service @mostajs/aop-clients createVeilles (= interface alerts du scheduler)
+ * @param {object} deps.clients    service @mostajs/aop-clients createClients
+ * @param {object} deps.hub        hub @mostajs/trigger (createTriggerHub) — REQUIS (define/fire)
+ * @param {{ send(msg):Promise }} [deps.notify]  seam de notification (@mostajs/notifications/mailer)
+ * @param {{ record(ev) }} [deps.audit]
+ * @param {() => Date} [deps.now]
+ */
+export function createVeilleEngine({ ingestion, tenders, veilles, clients, hub, notify = null, audit = null, now = () => new Date() } = {}) {
+  if (!hub?.define) throw new Error('aop-engine: hub @mostajs/trigger requis (createTriggerHub)');
+  const scheduler = createScheduler({ ingestion, tenders, alerts: veilles, hub, now });
+
+  // RÉACTION : un AO matche une veille → résoudre le client → livrer (notifier) + tracer + stats.
+  hub.define({
+    on: 'aop:tender:matched', weight: 10,
+    do: async (ctx) => {
+      const veille = await veilles.get(ctx.alertId || ctx.veilleId); if (!veille) return;
+      const client = veille.clientId ? await clients.get(veille.clientId) : null;
+      const tender = await tenders.get(ctx.tenderId);
+      const channels = veille.notifications?.channels || client?.notifyChannels || ['email'];
+      if (notify?.send && client?.contactEmail) {
+        await notify.send({ to: client.contactEmail, channels, subject: `Veille « ${veille.name} » — nouvel appel d'offres`,
+          body: `${tender?.title || ''} (score ${ctx.score})`, meta: { clientId: client.id, veilleId: veille.id, tenderId: ctx.tenderId, score: ctx.score } });
+      }
+      await veilles.update(veille.id, { stats: { ...(veille.stats || {}), matchCount: (veille.stats?.matchCount || 0) + 1 } });
+      audit?.record?.({ type: 'aop.match.delivered', clientId: client?.id, veilleId: veille.id, tenderId: ctx.tenderId, score: ctx.score });
+    },
+  });
+
+  return {
+    hub, scheduler,
+    /** Lance un cycle de veille (ingestion → matching veilles → trigger → livraison clients). */
+    runVeille: (scrapers, filters) => scheduler.runVeille(scrapers, filters),
+  };
+}
+export default { createVeilleEngine };
+
+export { createFakeHub } from './fake-hub.js';