@obsidiane/meridiane 0.0.7 → 0.0.10

package/tools/generate-models.js

@@ -1,175 +0,0 @@
-#!/usr/bin/env node
-import path from 'node:path';
-import fs from 'node:fs/promises';
-import process from 'node:process';
-import {fileURLToPath, pathToFileURL} from 'node:url';
-
-import {renderTemplateToFile} from './generator/models/handlebars.js';
-import {buildModelsFromOpenAPI} from './generator/models/openapi-to-models.js';
-import {ensureCleanDir} from './generator/models/utils.js';
-import {asBool, getArg, getArgs} from './utils/cli-args.js';
-import {loadDotEnv} from './utils/dotenv.js';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-/**
- * Lit la specification OpenAPI depuis une URL http(s) ou un chemin fichier JSON.
- * @param {string} specPathOrUrl
- */
-async function readSpec(specPathOrUrl) {
-  if (/^https?:\/\//.test(specPathOrUrl)) {
-    const res = await fetch(specPathOrUrl);
-    if (!res.ok) {
-      throw new Error(`Impossible de télécharger la spec : ${res.status} ${res.statusText}`);
-    }
-    return await res.json();
-  }
-
-  try {
-    const src = await fs.readFile(specPathOrUrl, 'utf8');
-    return JSON.parse(src);
-  } catch (err) {
-    if (err.code === 'ENOENT') {
-      throw new Error(`Fichier non trouvé : ${specPathOrUrl}`);
-    }
-    if (err.name === 'SyntaxError') {
-      throw new Error(`JSON invalide dans ${specPathOrUrl} : ${err.message}`);
-    }
-    throw err;
-  }
-}
-/**
- * Charge un fichier de config local `models.config.js` (CWD) s'il existe.
- * Le module peut exporter par défaut ou via export nommé.
- */
-async function loadUserConfig() {
-  const cfgPath = await findUp(process.cwd(), 'models.config.js');
-  try {
-    if (!cfgPath) return {};
-    const st = await fs.stat(cfgPath);
-    if (!st.isFile()) return {};
-    const mod = await import(pathToFileURL(cfgPath).href);
-    const cfg = mod?.default ?? mod;
-    return (cfg && typeof cfg === 'object') ? cfg : {};
-  } catch {
-    return {};
-  }
-}
-
-async function findUp(startDir, fileName) {
-  let dir = startDir;
-  while (true) {
-    const candidate = path.join(dir, fileName);
-    try {
-      const st = await fs.stat(candidate);
-      if (st.isFile()) return candidate;
-    } catch {
-      // ignore
-    }
-    const parent = path.dirname(dir);
-    if (parent === dir) return undefined;
-    dir = parent;
-  }
-}
-async function main() {
-  await loadDotEnv();
-  const debug = process.argv.includes('--debug') || /^(1|true|yes)$/i.test(process.env.MERIDIANE_DEBUG ?? '');
-
-  const specPathOrUrl = process.argv[2];
-  if (!specPathOrUrl) {
-    console.error('Usage: generate-models.js <OpenAPI spec (url|fichier)> [--item-import=../lib/ports/resource-repository.port] [--out=models] [--required-mode=all-optional|spec] [--preset=all|native] [--include=<substr>] [--exclude=<substr>] [--index=1|0]');
-    process.exit(1);
-  }
-
-  const workDir = process.cwd();
-  const userCfg = await loadUserConfig();
-  const outDir = path.resolve(workDir, getArg('out', userCfg.outDir || process.env.MERIDIANE_MODELS_OUT || 'models'));
-  const writeIndex = (() => {
-    const cli = getArg('index', undefined);
-    if (typeof cli === 'string') return asBool(cli, true);
-    if (typeof userCfg.writeIndex === 'boolean') return userCfg.writeIndex;
-    return asBool(process.env.MERIDIANE_MODELS_INDEX ?? '1', true);
-  })();
-  const itemImportPath = getArg(
-    'item-import',
-    userCfg.itemImportPath || process.env.MERIDIANE_MODELS_ITEM_IMPORT || '../lib/ports/resource-repository.port'
-  );
-  const requiredMode = (() => {
-    const v = getArg('required-mode', userCfg.requiredMode || process.env.MERIDIANE_MODELS_REQUIRED_MODE || 'all-optional');
-    return (v === 'spec' || v === 'all-optional') ? v : 'all-optional';
-  })();
-  const preset = (() => {
-    const v = getArg('preset', userCfg.preset || process.env.MERIDIANE_MODELS_PRESET || 'all');
-    return (v === 'native' || v === 'all') ? v : 'all';
-  })();
-  const preferFlavor = userCfg.preferFlavor; // 'jsonld' | 'jsonapi' | 'none'
-  const hydraBaseRegex = userCfg.hydraBaseRegex; // RegExp|string
-  const includeCli = getArgs('include').flatMap((v) => v.split(',').map((s) => s.trim()).filter(Boolean));
-  const excludeCli = getArgs('exclude').flatMap((v) => v.split(',').map((s) => s.trim()).filter(Boolean));
-  const includeSchemaNames = [
-    ...(Array.isArray(userCfg.includeSchemaNames) ? userCfg.includeSchemaNames : []),
-    ...includeCli,
-  ];
-  const excludeSchemaNames = [
-    ...(Array.isArray(userCfg.excludeSchemaNames) ? userCfg.excludeSchemaNames : []),
-    ...excludeCli,
-  ];
-
-  if (debug) {
-    console.log('[meridiane models] debug', {
-      outDir: path.relative(workDir, outDir),
-      writeIndex,
-      itemImportPath,
-      requiredMode,
-      preset,
-      preferFlavor,
-      includeCount: includeSchemaNames.length,
-      excludeCount: excludeSchemaNames.length,
-    });
-  }
-
-  console.log(`📥 Spec OpenAPI: ${specPathOrUrl}`);
-  const spec = await readSpec(specPathOrUrl);
-
-
-  console.log('🔧 Construction des interfaces…');
-  const {models} = buildModelsFromOpenAPI(spec, {
-    requiredMode,
-    preset,
-    preferFlavor,
-    hydraBaseRegex,
-    includeSchemaNames,
-    excludeSchemaNames,
-  });
-
-  const templatesDir = path.join(__dirname, 'generator', 'models', 'templates');
-  await ensureCleanDir(outDir);
-
-  for (const m of models) {
-    await renderTemplateToFile({
-      templatePath: path.join(templatesDir, 'model.hbs'),
-      outPath: path.join(outDir, `${m.name}.ts`),
-      ctx: {
-        itemImportPath,
-        name: m.name,
-        props: m.props,
-        imports: m.imports,
-      },
-    });
-  }
-
-  if (writeIndex) {
-    await renderTemplateToFile({
-      templatePath: path.join(templatesDir, 'index.hbs'),
-      outPath: path.join(outDir, 'index.ts'),
-      ctx: {models: models.map((m) => ({name: m.name}))},
-    });
-  }
-
-  console.log(`✅ ${models.length} modèle(s) écrit(s) dans ${path.relative(workDir, outDir)}`);
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/tools/init.js

@@ -1,148 +0,0 @@
-#!/usr/bin/env node
-import path from 'node:path';
-import process from 'node:process';
-import {fileURLToPath} from 'node:url';
-import fs from 'node:fs/promises';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-function hasFlag(name) {
-  return process.argv.includes(`--${name}`);
-}
-
-async function pathExists(p) {
-  try {
-    await fs.stat(p);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-async function ensureDir(p) {
-  await fs.mkdir(p, {recursive: true});
-}
-
-async function writeFileIfMissing(filePath, content, {force} = {}) {
-  const exists = await pathExists(filePath);
-  if (exists && !force) return {written: false, reason: 'exists'};
-  await ensureDir(path.dirname(filePath));
-  await fs.writeFile(filePath, content, 'utf8');
-  return {written: true};
-}
-
-async function copyFileIfMissing(src, dest, {force} = {}) {
-  const exists = await pathExists(dest);
-  if (exists && !force) return {written: false, reason: 'exists'};
-  await ensureDir(path.dirname(dest));
-  await fs.copyFile(src, dest);
-  return {written: true};
-}
-
-async function main() {
-  const force = hasFlag('force');
-  const debug = /^(1|true|yes)$/i.test(process.env.MERIDIANE_DEBUG ?? '') || hasFlag('debug');
-
-  const cwd = process.cwd();
-  const pkgRoot = path.resolve(__dirname, '..');
-
-  const outDir = path.resolve(cwd, 'meridiane');
-  await ensureDir(outDir);
-
-  const modelsExample = path.join(pkgRoot, 'models.config.example.js');
-  const modelsOut = path.resolve(cwd, 'models.config.js');
-  const envExampleOut = path.resolve(cwd, '.env.example');
-
-  const angularExampleOut = path.join(outDir, 'angular.example.ts');
-  const readmeOut = path.join(outDir, 'README.md');
-
-  if (debug) console.log('[meridiane init] cwd=', cwd);
-
-  const copiedCfg = await copyFileIfMissing(modelsExample, modelsOut, {force});
-  const wroteEnv = await writeFileIfMissing(
-    envExampleOut,
-    [
-      '# Meridiane (CLI) - exemple de configuration',
-      '# Copiez en `.env` pour activer la config locale.',
-      '',
-      '# Logs',
-      'MERIDIANE_DEBUG=0',
-      '',
-      '# meridiane lib',
-      '# MERIDIANE_LIB_VERSION=0.1.0',
-      '# MERIDIANE_NPM_REGISTRY_URL=https://registry.npmjs.org/',
-      '',
-      '# meridiane models',
-      '# MERIDIANE_MODELS_OUT=projects/backend-bridge/src/models',
-      '# MERIDIANE_MODELS_REQUIRED_MODE=spec',
-      '# MERIDIANE_MODELS_ITEM_IMPORT=../lib/ports/resource-repository.port',
-      '# MERIDIANE_MODELS_PRESET=all',
-      '# MERIDIANE_MODELS_INDEX=1',
-      '',
-      '# Runtime (Angular) - à recopier dans provideBridge(...)',
-      '# MERIDIANE_API_BASE_URL=http://localhost:8000',
-      '# MERIDIANE_MERCURE_HUB_URL=http://localhost:8000/.well-known/mercure',
-      '',
-    ].join('\n'),
-    {force}
-  );
-
-  const wroteAngular = await writeFileIfMissing(
-    angularExampleOut,
-    [
-      "import {provideBridge} from '@acme/backend-bridge';",
-      '',
-      'export const BRIDGE_PROVIDERS = [',
-      '  provideBridge({',
-      "    baseUrl: 'http://localhost:8000',",
-      '    mercure: {',
-      "      hubUrl: 'http://localhost:8000/.well-known/mercure',",
-      "      init: {credentials: 'include'},",
-      '    },',
-      '    defaults: {',
-      '      headers: {',
-      "        // 'X-Correlation-Id': crypto.randomUUID(),",
-      '      },',
-      '      timeoutMs: 30_000,',
-      '      retries: {count: 1, delayMs: 250},',
-      '    },',
-      '    // auth: {type: \"bearer\", token: \"<JWT>\"},',
-      '    debug: false,',
-      '  }),',
-      '];',
-      '',
-    ].join('\n'),
-    {force}
-  );
-
-  const wroteReadme = await writeFileIfMissing(
-    readmeOut,
-    [
-      '# Meridiane – fichiers générés',
-      '',
-      'Ces fichiers sont créés par `meridiane init` pour accélérer l’intégration.',
-      '',
-      '## CLI',
-      '',
-      '- `models.config.js` : configuration par défaut de `meridiane models` (chargée depuis le CWD).',
-      "- `.env` : optionnel. Le CLI charge automatiquement `.env` (CWD) avant d'exécuter `lib/models`.",
-      '',
-      '## Angular',
-      '',
-      '- `angular.example.ts` : exemple `provideBridge({ baseUrl, mercure, defaults, auth, debug })` à adapter.',
-      '',
-    ].join('\n'),
-    {force}
-  );
-
-  console.log('✅ meridiane init');
-  console.log(`- ${path.relative(cwd, modelsOut)} ${copiedCfg.written ? 'créé' : '(existe déjà)'}`);
-  console.log(`- ${path.relative(cwd, envExampleOut)} ${wroteEnv.written ? 'créé' : '(existe déjà)'}`);
-  console.log(`- ${path.relative(cwd, angularExampleOut)} ${wroteAngular.written ? 'créé' : '(existe déjà)'}`);
-  console.log(`- ${path.relative(cwd, readmeOut)} ${wroteReadme.written ? 'créé' : '(existe déjà)'}`);
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/tools/sandbox-bridge.js

@@ -1,77 +0,0 @@
-#!/usr/bin/env node
-import path from 'node:path';
-import process from 'node:process';
-import {fileURLToPath} from 'node:url';
-import {spawn} from 'node:child_process';
-import {loadDotEnv} from './utils/dotenv.js';
-import {getArg, hasFlag} from './utils/cli-args.js';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const repoRoot = path.resolve(__dirname, '../../..');
-
-function run(args) {
-  return new Promise((resolve) => {
-    const child = spawn(process.execPath, args, {stdio: 'inherit', env: process.env});
-    child.on('exit', (code) => resolve(code ?? 0));
-  });
-}
-
-function printHelp() {
-  console.log(`
-Usage:
-  meridiane sandbox-bridge [options]
-
-This command regenerates the Angular bridge library used by the sandbox:
-  - workspace: apps/sandbox
-  - libName: bridge-sandbox
-  - package: @obsidiane/bridge-sandbox
-  - version: 0.1.0 (override with --version)
-
-Options:
-  --backend=http://localhost:8000
-  --spec=/api/docs.json
-  --models-out=projects/bridge-sandbox/src/models
-  --required-mode=all-optional|spec
-  --preset=all|native
-  --include=<substr>[,<substr>…] (repeatable)
-  --exclude=<substr>[,<substr>…] (repeatable)
-  --index=1|0
-  --no-models
-  --debug
-
-Example:
-  npx -y @obsidiane/meridiane sandbox-bridge --backend=http://localhost:8000
-`);
-}
-
-async function main() {
-  await loadDotEnv();
-
-  if (hasFlag('help') || hasFlag('h')) {
-    printHelp();
-    process.exit(0);
-  }
-
-  const version = getArg('version', process.env.MERIDIANE_SANDBOX_BRIDGE_VERSION ?? '0.1.0');
-
-  const passThrough = process.argv.slice(2).filter((a) => a.startsWith('--') && !a.startsWith('--version='));
-
-  const devBridgePath = path.join(__dirname, 'dev-bridge.js');
-  const workspaceAbs = path.join(repoRoot, 'apps', 'sandbox');
-  const args = [
-    devBridgePath,
-    'bridge-sandbox',
-    '@obsidiane/bridge-sandbox',
-    version,
-    `--workspace=${workspaceAbs}`,
-    ...passThrough,
-  ];
-
-  const code = await run(args);
-  process.exit(code);
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/tools/utils/cli-args.js

@@ -1,41 +0,0 @@
-/**
- * @param {string} name
- * @param {string|undefined} def
- * @param {string[]} [argv]
- * @returns {string|undefined}
- */
-export function getArg(name, def, argv = process.argv) {
-  const a = argv.find((x) => x.startsWith(`--${name}=`));
-  return a ? a.split('=')[1] : def;
-}
-
-/**
- * @param {string} name
- * @param {string[]} [argv]
- * @returns {string[]}
- */
-export function getArgs(name, argv = process.argv) {
-  return argv
-    .filter((x) => x.startsWith(`--${name}=`))
-    .map((x) => x.slice(`--${name}=`.length));
-}
-
-/**
- * @param {string} name
- * @param {string[]} [argv]
- */
-export function hasFlag(name, argv = process.argv) {
-  return argv.includes(`--${name}`);
-}
-
-/**
- * @param {unknown} v
- * @param {boolean} def
- */
-export function asBool(v, def) {
-  if (typeof v !== 'string') return def;
-  if (/^(1|true|yes)$/i.test(v)) return true;
-  if (/^(0|false|no)$/i.test(v)) return false;
-  return def;
-}
-

package/tools/utils/dotenv.js

@@ -1,55 +0,0 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-
-/**
- * Charge un fichier `.env` (format KEY=VALUE) dans process.env, sans écraser les variables déjà définies.
- * @param {{cwd?: string, filename?: string}} [opts]
- * @returns {Promise<Record<string, string>>} variables chargées
- */
-export async function loadDotEnv(opts = {}) {
-  const cwd = opts.cwd ?? process.cwd();
-  const filename = opts.filename ?? '.env';
-  const envPath = await findUp(cwd, filename);
-  if (!envPath) return {};
-
-  const raw = await fs.readFile(envPath, 'utf8');
-
-  const loaded = {};
-  for (const line of raw.split(/\r?\n/)) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith('#')) continue;
-    const normalized = trimmed.startsWith('export ') ? trimmed.slice('export '.length).trim() : trimmed;
-    const idx = normalized.indexOf('=');
-    if (idx < 0) continue;
-    const key = normalized.slice(0, idx).trim();
-    let value = normalized.slice(idx + 1).trim();
-    if (!key) continue;
-
-    if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
-      value = value.slice(1, -1);
-    }
-
-    if (process.env[key] === undefined) {
-      process.env[key] = value;
-      loaded[key] = value;
-    }
-  }
-
-  return loaded;
-}
-
-async function findUp(startDir, fileName) {
-  let dir = startDir;
-  while (true) {
-    const candidate = path.join(dir, fileName);
-    try {
-      const st = await fs.stat(candidate);
-      if (st.isFile()) return candidate;
-    } catch {
-      // ignore
-    }
-    const parent = path.dirname(dir);
-    if (parent === dir) return undefined;
-    dir = parent;
-  }
-}