@mostajs/social-publish 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,4 @@
+# Changelog — @mostajs/social-publish
+## [0.1.0] — 2026-06-22
+### Ajouté
+- Registre de dialectes de diffusion (modèle @mostajs/auth-dialects) : 6 réseaux natifs (planned) + passerelle webhook. webhookDialect/consoleDialect/socialFromEnv. publish() fan-out best-effort. 5 tests.

package/README.md

@@ -0,0 +1,17 @@
+# @mostajs/social-publish
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com>
+
+Diffusion (syndication) des **vidéos & enregistrements vers les réseaux sociaux**, **zéro-dépendance**, **modelé sur `@mostajs/auth-dialects`** : chaque réseau est un *dialecte de diffusion* (`native` OAuth ou `webhook` générique), dans un **registre extensible** (`register/get/byKind/active/planned`).
+
+```js
+import { createSocialRegistry, socialFromEnv } from '@mostajs/social-publish';
+const social = createSocialRegistry();
+socialFromEnv(process.env).forEach((d) => social.register(d));   // SOCIAL_YOUTUBE_WEBHOOK=… etc.
+const results = await social.publish({ networks: ['youtube', 'facebook'], post: { title: 'Demo Day', mediaUrl: '/media/demoday.mp4', mediaKind: 'video', link: 'https://market.amia.fr/vox' } });
+```
+
+- **webhook** (Zapier/Make/Buffer/n8n) = diffusion **réelle dès aujourd'hui** sans dépendance.
+- **native** (YouTube Data, Graph API, LinkedIn, X, TikTok) = même interface, à câbler (Phase 2).
+
+Tests : `npm test`. Licence : AGPL-3.0-or-later.

package/llms.txt

@@ -0,0 +1,8 @@
+# @mostajs/social-publish — diffusion vidéos/enregistrements vers les réseaux sociaux
+Zéro-dépendance, modelé sur @mostajs/auth-dialects : chaque réseau = un DIALECTE de diffusion { key,label,kind,status,media,publish? }.
+kind : 'native' (OAuth : YouTube/Facebook/Instagram/LinkedIn/X/TikTok — Phase 2) | 'webhook' (passerelle Zapier/Make/Buffer/n8n — RÉEL, zéro-dép).
+status : 'active' (porte publish()) | 'planned' (catalogue, à activer par register()).
+## API (calquée sur auth-dialects)
+createSocialRegistry({networks=defaultNetworks()}) → list/get/byKind/active/planned/register(dialect) + publish({networks?,post})→[{network,ok,id?,url?,error?}]
+post = { title, description, link, mediaUrl, mediaKind, tags }
+webhookDialect({key,url,map?,parse?}) · consoleDialect({key}) · socialFromEnv(env) (SOCIAL_<NET>_WEBHOOK → dialectes actifs, sinon console)

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@mostajs/social-publish",
+  "version": "0.1.0",
+  "description": "Diffusion (syndication) des vidéos & enregistrements vers les réseaux sociaux, zéro-dépendance — modelé sur @mostajs/auth-dialects : chaque réseau (YouTube/Facebook/Instagram/LinkedIn/X/TikTok) est un « dialecte » de diffusion (native OAuth ou passerelle webhook), registre extensible (register/select/active/planned).",
+  "license": "AGPL-3.0-or-later",
+  "author": "Dr Hamid MADANI <drmdh@msn.com>",
+  "type": "module",
+  "main": "src/index.js",
+  "files": [
+    "src",
+    "llms.txt",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "keywords": [
+    "mostajs",
+    "social",
+    "syndication",
+    "publish",
+    "youtube",
+    "facebook",
+    "linkedin",
+    "webhook",
+    "dialects"
+  ],
+  "devDependencies": {
+    "@mostajs/mjs-unit": "^0.3.0"
+  },
+  "scripts": {
+    "test": "bash test-scripts/run-tests.sh"
+  }
+}

package/src/index.js

@@ -0,0 +1,104 @@
+// @mostajs/social-publish — diffusion (syndication) des vidéos & enregistrements vers les réseaux sociaux. Author: Dr Hamid MADANI <drmdh@msn.com>
+// ZÉRO DÉPENDANCE. Modelé sur @mostajs/auth-dialects : un réseau social = un « DIALECTE » de diffusion. Deux familles (kind) :
+//   • native  : API officielle du réseau (OAuth) — YouTube Data, Facebook/Instagram Graph, LinkedIn, X, TikTok (à câbler, Phase 2).
+//   • webhook : passerelle générique (Zapier/Make/Buffer/n8n/IFTTT) qui relaie vers le réseau réel — RÉEL et zéro-dép dès aujourd'hui.
+// Le registre est EXTENSIBLE (register), comme les dialectes de connexion. Un POST = { title, description, link, mediaUrl, mediaKind, tags }.
+// Author: Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+
+export const KINDS = Object.freeze({ NATIVE: 'native', WEBHOOK: 'webhook' });
+export const STATUS = Object.freeze({ ACTIVE: 'active', PLANNED: 'planned' });
+
+/**
+ * Catalogue par défaut des réseaux. Forme d'un dialecte de diffusion :
+ *   { key, label, kind, status, media:[types supportés], requires?, publish?(post)->Promise<{ok,id?,url?,error?}> }
+ *   - status PLANNED : au catalogue (UI/doc) mais pas encore diffusable (pas de publish) → à activer par register().
+ *   - status ACTIVE  : porte un publish() (webhook configuré, ou driver natif câblé).
+ */
+export function defaultNetworks() {
+  const all = ['video', 'audio', 'image', 'link'];
+  return [
+    { key: 'youtube', label: 'YouTube', kind: KINDS.NATIVE, status: STATUS.PLANNED, media: ['video'], requires: 'OAuth — YouTube Data API' },
+    { key: 'facebook', label: 'Facebook', kind: KINDS.NATIVE, status: STATUS.PLANNED, media: all, requires: 'OAuth — Graph API' },
+    { key: 'instagram', label: 'Instagram', kind: KINDS.NATIVE, status: STATUS.PLANNED, media: ['video', 'image'], requires: 'OAuth — Graph API' },
+    { key: 'linkedin', label: 'LinkedIn', kind: KINDS.NATIVE, status: STATUS.PLANNED, media: ['video', 'image', 'link'], requires: 'OAuth — LinkedIn API' },
+    { key: 'x', label: 'X (Twitter)', kind: KINDS.NATIVE, status: STATUS.PLANNED, media: ['video', 'image', 'link'], requires: 'OAuth — X API' },
+    { key: 'tiktok', label: 'TikTok', kind: KINDS.NATIVE, status: STATUS.PLANNED, media: ['video'], requires: 'OAuth — TikTok API' },
+    // Dialecte GÉNÉRIQUE : une passerelle webhook relaie vers n'importe quel réseau. À activer par register(webhookDialect(...)).
+    { key: 'webhook', label: 'Passerelle webhook (Zapier/Make/Buffer/n8n)', kind: KINDS.WEBHOOK, status: STATUS.PLANNED, media: all, requires: 'URL de webhook' },
+  ];
+}
+
+/** Dialecte de DEV (simule la diffusion, journalise) — toujours ACTIVE. */
+export function consoleDialect({ key = 'console', label = 'Console (simulation)' } = {}) {
+  return { key, label, kind: KINDS.WEBHOOK, status: STATUS.ACTIVE, media: ['video', 'audio', 'image', 'link'], async publish(post = {}) { return { ok: true, id: 'sim-' + key, url: null, simulated: true }; } };
+}
+
+/**
+ * Dialecte WEBHOOK actif : POST JSON vers une passerelle (Zapier/Make/Buffer/n8n) qui relaie au réseau réel. Zéro-dépendance (fetch global).
+ * `map(post)` adapte la charge utile ; `parse(data)` en extrait { id, url }.
+ */
+export function webhookDialect({ key, label = null, url, method = 'POST', headers = {}, map = null, parse = null } = {}) {
+  if (!key || !url) throw new Error('@mostajs/social-publish: webhookDialect { key, url } requis');
+  return {
+    key, label: label || `${key} (webhook)`, kind: KINDS.WEBHOOK, status: STATUS.ACTIVE, media: ['video', 'audio', 'image', 'link'], url,
+    async publish(post = {}) {
+      try {
+        const body = JSON.stringify(map ? map(post) : { network: key, ...post });
+        const res = await fetch(url, { method, headers: { 'content-type': 'application/json', ...headers }, body });
+        if (!res.ok) return { ok: false, error: `HTTP ${res.status}` };
+        let data = null; try { data = await res.json(); } catch { /* réponse non-JSON tolérée */ }
+        const out = parse ? parse(data) : (data || {});
+        return { ok: true, id: out.id || null, url: out.url || out.link || null };
+      } catch (e) { return { ok: false, error: e.message }; }
+    },
+  };
+}
+
+/**
+ * Construit les dialectes ACTIFS depuis l'environnement : pour chaque réseau, `SOCIAL_<NET>_WEBHOOK` → webhookDialect.
+ * Réseaux : YOUTUBE/FACEBOOK/INSTAGRAM/LINKEDIN/X/TIKTOK. Aucun configuré → [consoleDialect()] (dev). À passer à register().
+ */
+export function socialFromEnv(env = process.env) {
+  const out = [];
+  for (const net of ['youtube', 'facebook', 'instagram', 'linkedin', 'x', 'tiktok']) {
+    const url = env[`SOCIAL_${net.toUpperCase()}_WEBHOOK`];
+    if (url) out.push(webhookDialect({ key: net, label: net, url }));
+  }
+  return out.length ? out : [consoleDialect()];
+}
+
+/**
+ * Registre de dialectes de diffusion (extensible). API calquée sur @mostajs/auth-dialects :
+ *   list() · get(key) · byKind(kind) · active() · planned() · register(dialect)  (+ publish pour orchestrer la diffusion).
+ *   publish({ networks?, post }) → [{ network, ok, id?, url?, error? }] ; networks absent → tous les ACTIFS. Best-effort.
+ */
+export function createSocialRegistry({ networks = defaultNetworks() } = {}) {
+  const list = networks.map((d) => ({ ...d }));
+  const api = {
+    list: () => list.map((d) => ({ ...d })),
+    get: (key) => list.find((d) => d.key === key) || null,
+    byKind: (kind) => list.filter((d) => d.kind === kind).map((d) => ({ ...d })),
+    active: () => list.filter((d) => d.status === STATUS.ACTIVE).map((d) => ({ ...d })),
+    planned: () => list.filter((d) => d.status === STATUS.PLANNED).map((d) => ({ ...d })),
+    register(d) {
+      if (!d || !d.key) throw new Error('@mostajs/social-publish: dialect.key requis');
+      const i = list.findIndex((x) => x.key === d.key);
+      if (i >= 0) list[i] = { ...list[i], ...d };   // upsert : active un réseau planifié (ajoute son publish + status active)
+      else list.unshift(d);
+      return api;
+    },
+    async publish({ networks: keys = null, post = {} } = {}) {
+      const chosen = keys && keys.length ? keys.map((k) => list.find((d) => d.key === k)).filter(Boolean) : list.filter((d) => d.status === STATUS.ACTIVE);
+      const results = [];
+      for (const d of chosen) {
+        if (typeof d.publish !== 'function') { results.push({ network: d.key, ok: false, error: 'réseau non configuré (planned)' }); continue; }
+        let r; try { r = await d.publish(post); } catch (e) { r = { ok: false, error: e.message }; }
+        results.push({ network: d.key, ...r });
+      }
+      return results;
+    },
+  };
+  return api;
+}
+
+export default { KINDS, STATUS, defaultNetworks, consoleDialect, webhookDialect, socialFromEnv, createSocialRegistry };