@obsidiane/meridiane 0.0.6 → 0.0.10

package/models.config.example.js

@@ -1,24 +0,0 @@
-// Exemple de configuration pour la génération des modèles.
-// Copiez ce fichier en `models.config.js` dans le dossier où vous lancez la commande (`meridiane models`).
-// Format CommonJS pour éviter les warnings Node dans la plupart des workspaces Angular.
-
-module.exports = {
-  // Dossier de sortie (relatif au CWD)
-  outDir: 'projects/backend-bridge/src/models',
-
-  // Chemin d'import de `Item` dans les templates (relatif au fichier généré)
-  itemImportPath: '../lib/ports/resource-repository.port',
-
-  // Contrôle des propriétés optionnelles
-  // - 'all-optional': toutes les props sont optionnelles
-  // - 'spec': respecte le tableau `required` de la spec
-  requiredMode: 'all-optional',
-
-  // Préférence entre variantes de schémas (.jsonld, .jsonapi ou aucune)
-  // Valeurs possibles: 'jsonld' | 'jsonapi' | 'none'
-  preferFlavor: 'jsonld',
-
-  // Hydra: regex pour les schémas de base à ignorer (merge allOf / filtrage)
-  // Peut être une RegExp ou une string passée à `new RegExp(...)`
-  hydraBaseRegex: /^Hydra(?:Item|Collection)BaseSchema$/,
-};

package/templates/_lib_template/src/lib/bridge/credentials.policy.ts

@@ -1,9 +0,0 @@
-export class CredentialsPolicy {
-  constructor(private readonly init: unknown) {
-  }
-
-  withCredentials(): boolean {
-    const c = this.init as any;
-    return c?.withCredentials === true || c?.credentials === 'include';
-  }
-}

package/templates/_lib_template/src/lib/utils/utils.ts

@@ -1,21 +0,0 @@
-import {WritableSignal} from '@angular/core';
-import {Item} from '../ports/resource-repository.port';
-
-export function upsertInSignal(
-  signal: WritableSignal<readonly Item[]>,
-  item: Item,
-): void {
-  signal.update(items => {
-
-    const id = item['@id'];
-    const existingIndex = items.findIndex(it => it['@id'] === id);
-
-    if (existingIndex === -1) {
-      return [item, ...items];
-    }
-
-    const next = items.slice() as Item[];
-    next[existingIndex] = item;
-    return next;
-  });
-}

package/templates/_lib_template/tsconfig.spec.json

@@ -1,14 +0,0 @@
-/* To learn more about Typescript configuration file: https://www.typescriptlang.org/docs/handbook/tsconfig-json.html. */
-/* To learn more about Angular compiler options: https://angular.dev/reference/configs/angular-compiler-options. */
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "../../out-tsc/spec",
-    "types": [
-      "jasmine"
-    ]
-  },
-  "include": [
-    "src/**/*.ts"
-  ]
-}

package/tools/generate-lib.js

@@ -1,136 +0,0 @@
-#!/usr/bin/env node
-import fs from "fs-extra"
-import path from "path"
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname  = path.dirname(__filename);
-/**
- * Recursively replace all placeholders in files under a directory
- * @param {string} srcDir - source directory path
- * @param {Object.<string,string>} placeholders - map of placeholder -> value
- */
-async function replacePlaceholdersInDir(srcDir, placeholders) {
-  const entries = await fs.readdir(srcDir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = path.join(srcDir, entry.name);
-    if (entry.isDirectory()) {
-      await replacePlaceholdersInDir(fullPath, placeholders);
-    } else if (entry.isFile()) {
-      let content = await fs.readFile(fullPath, 'utf8');
-      for (const [key, value] of Object.entries(placeholders)) {
-        const regex = new RegExp(key, 'g');
-        content = content.replace(regex, value);
-      }
-      await fs.writeFile(fullPath, content);
-    }
-  }
-}
-
-/**
- * Generate a new Angular library from template
- * @param {string} libName - folder and project name
- * @param {string} packageName - NPM package name (e.g. @org/lib)
- * @param {string} version - initial version for the package
- * @param {string} urlRegistry  - NPM registry url
- */
-async function generate(libName, packageName, version, urlRegistry) {
-  const tplDir = path.resolve(__dirname, '../templates/_lib_template');
-  const workspaceRoot = process.cwd();
-  const targetDir = path.resolve(workspaceRoot, 'projects', libName);
-
-  // 1) Copy the template directory
-  await fs.copy(tplDir, targetDir);
-
-  // 2) Replace placeholders __LIB_NAME__, __PACKAGE_NAME__, __VERSION__
-  const placeholders = {
-    '__LIB_NAME__': libName,
-    '__PACKAGE_NAME__': packageName,
-    '__VERSION__': version
-  };
-  await replacePlaceholdersInDir(targetDir, placeholders);
-
-  // 3) Update the library's package.json
-  const libPackageJsonPath = path.join(targetDir, 'package.json');
-  if (await fs.pathExists(libPackageJsonPath)) {
-    const libPkg = await fs.readJson(libPackageJsonPath);
-    libPkg.name = packageName;
-    libPkg.version = version;
-    if (urlRegistry) {
-      libPkg.publishConfig = {...(libPkg.publishConfig || {}), registry: urlRegistry};
-    } else if (libPkg.publishConfig?.registry) {
-      delete libPkg.publishConfig.registry;
-      if (Object.keys(libPkg.publishConfig).length === 0) delete libPkg.publishConfig;
-    }
-    await fs.writeJson(libPackageJsonPath, libPkg, { spaces: 2 });
-  }
-
-  // 4) Update angular.json
-  const angularJsonPath = path.resolve(workspaceRoot, 'angular.json');
-  const ng = await fs.readJson(angularJsonPath);
-
-  ng.projects[libName] = {
-    root: `projects/${libName}`,
-    sourceRoot: `projects/${libName}/src`,
-    projectType: 'library',
-    "architect": {
-      "build": {
-        "builder": "@angular/build:ng-packagr",
-        "configurations": {
-          "production": {
-            "tsConfig": `projects/${libName}/tsconfig.lib.prod.json`
-          },
-          "development": {
-            "tsConfig": `projects/${libName}/tsconfig.lib.json`
-          }
-        },
-        "defaultConfiguration": "production"
-      },
-      "test": {
-        "builder": "@angular/build:karma",
-        "options": {
-          "tsConfig": `projects/${libName}/tsconfig.spec.json`
-        }
-      }
-    }
-  };
-  await fs.writeJson(angularJsonPath, ng, { spaces: 2 });
-
-  console.log(`✅ Library '${libName}' generated at projects/${libName}` +
-    ` with package '${packageName}@${version}'`);
-
-  const ngPackagrPkg = findUpNodeModulePackageJson(workspaceRoot, 'ng-packagr');
-  if (!ngPackagrPkg) {
-    console.warn(
-      [
-        "⚠️  'ng-packagr' n'est pas installé dans ce workspace.",
-        "   Pour builder une librairie (ng-packagr), installez-le dans votre projet Angular :",
-        "   npm i -D ng-packagr",
-      ].join('\n')
-    );
-  }
-}
-
-function findUpNodeModulePackageJson(startDir, packageName) {
-  let dir = startDir;
-  while (true) {
-    const candidate = path.join(dir, 'node_modules', packageName, 'package.json');
-    if (fs.existsSync(candidate)) return candidate;
-    const parent = path.dirname(dir);
-    if (parent === dir) return undefined;
-    dir = parent;
-  }
-}
-
-// CLI args: node generate-lib.js <lib-name> <package-name> [version] <url-registry>
-// CLI args: node generate-lib.js <lib-name> <package-name> [version] [url-registry]
-const [,, libName, packageName, version = '0.0.1', urlRegistry] = process.argv;
-if (!libName || !packageName) {
-  console.error('Usage: generate-lib.js <lib-name> <package-name> [version] [url-registry]');
-  process.exit(1);
-}
-
-generate(libName, packageName, version, urlRegistry).catch(err => {
-  console.error(err);
-  process.exit(1);
-});

package/tools/generate-models.js

@@ -1,121 +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';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-/**
- * Récupère un argument CLI de la forme --name=value
- * @param {string} name
- * @param {string|undefined} def
- * @returns {string|undefined}
- */
-function getArg(name, def) {
-  const a = process.argv.find((x) => x.startsWith(`--${name}=`));
-  return a ? a.split('=')[1] : def;
-}
-
-/**
- * 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 = path.resolve(process.cwd(), 'models.config.js');
-  try {
-    const st = await fs.stat(cfgPath);
-    if (!st.isFile()) return {};
-    const mod = await import(pathToFileURL(cfgPath).href);
-    return (mod?.default && typeof mod.default === 'object') ? mod.default : (mod || {});
-  } catch {
-    return {};
-  }
-}
-async function main() {
-  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] [--no-index]');
-    process.exit(1);
-  }
-
-  const workDir = process.cwd();
-  const userCfg = await loadUserConfig();
-  const outDir = path.resolve(workDir, getArg('out', userCfg.outDir || 'models'));
-  const writeIndex = !('' + process.argv.join(' ')).includes('--no-index');
-  const itemImportPath = getArg('item-import', userCfg.itemImportPath || '../lib/ports/resource-repository.port');
-  const requiredMode = (() => {
-    const v = getArg('required-mode', userCfg.requiredMode || 'all-optional');
-    return (v === 'spec' || v === 'all-optional') ? v : 'all-optional';
-  })();
-  const preferFlavor = userCfg.preferFlavor; // 'jsonld' | 'jsonapi' | 'none'
-  const hydraBaseRegex = userCfg.hydraBaseRegex; // RegExp|string
-
-  console.log(`📥 Spec OpenAPI: ${specPathOrUrl}`);
-  const spec = await readSpec(specPathOrUrl);
-
-
-  console.log('🔧 Construction des interfaces…');
-  const {models} = buildModelsFromOpenAPI(spec, { requiredMode, preferFlavor, hydraBaseRegex });
-
-  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);
-});