odoro 1.0.9 → 2.1.0

package/templates/react-ts-server/server/src/modules/health/index.ts

@@ -1,40 +1,39 @@
 /**
- * Module de sante — et exemple de ce a quoi ressemble un module.
+ * Health module — and an example of what a module looks like.
  *
- * C'est le seul module de ce template, et il est ecrit ici plutot que fourni
- * par `@odoro-cli/server` pour une raison : ecrire un module est la premiere chose
- * qu'on fait sur ce socle, et un exemple qu'on peut ouvrir vaut mieux qu'une
- * page de documentation.
+ * It is the only module of this template, and it is written here rather than
+ * provided by `@odoro-cli/server` for a reason: writing a module is the first
+ * thing you do on this foundation, and an example you can open beats a page of
+ * documentation.
  *
- * ## Un module est une fonction de ce dont il a besoin
+ * ## A module is a function of what it needs
  *
- * Celui-ci recoit la configuration en parametre plutot que de lire
- * `process.env`. C'est la regle du socle : l'environnement est valide une fois,
- * au demarrage, et tout le reste consomme le resultat. Une lecture directe
- * echappe a cette validation et se manifeste a la centieme requete.
+ * This one receives the configuration as a parameter rather than reading
+ * `process.env`. That is the rule of the foundation: the environment is
+ * validated once, at startup, and everything else consumes the result. A
+ * direct read escapes that validation and shows up on the hundredth request.
  *
- * ## Deux points de controle, et pourquoi ils different
+ * ## Two health endpoints, and why they differ
  *
- * `/api/health` repond que **le processus vit**. Il ne teste rien d'autre, et
- * doit repondre meme quand tout le reste est casse : c'est ce qu'un
- * orchestrateur interroge pour decider s'il faut redemarrer le conteneur. Le
- * faire dependre de la base ferait redemarrer un serveur parfaitement sain
- * chaque fois que la base hoquette — et un redemarrage ne repare pas une base.
+ * `/api/health` answers that **the process is alive**. It tests nothing else,
+ * and must answer even when everything else is broken: that is what an
+ * orchestrator asks to decide whether to restart the container. Making it
+ * depend on the database would restart a perfectly healthy server every time
+ * the database hiccups — and a restart does not repair a database.
  *
- * `/api/ready` repond que **le service peut travailler**, et rend 503 tant
- * qu'il manque quelque chose : c'est ce qu'un repartiteur interroge pour
- * decider s'il peut envoyer du trafic.
+ * `/api/ready` answers that **the service can do its work**, and returns 503
+ * for as long as something is missing: that is what a load balancer asks to
+ * decide whether it can send traffic.
  *
- * Confondre les deux donne l'un des deux defauts : un service qui redemarre en
- * boucle pendant un incident de base, ou un repartiteur qui envoie du trafic a
- * un service incapable de repondre.
+ * Confusing the two gives one of two faults: a service restarting in a loop
+ * during a database incident, or a load balancer sending traffic to a service
+ * that cannot answer.
  *
- * ## Pourquoi `/ready` echoue au premier demarrage
+ * ## Why `/ready` fails on the first start
  *
- * Un projet fraichement echafaude n'a pas encore de `DATABASE_URL`. Le client
- * demarre, l'interface s'affiche, et `/api/ready` dit ce qui manque. On voit
- * donc quelque chose des la premiere minute, et on sait exactement ce qu'il
- * reste a faire.
+ * A freshly scaffolded project has no `DATABASE_URL` yet. The client starts,
+ * the interface shows, and `/api/ready` says what is missing. So you see
+ * something in the first minute, and you know exactly what is left to do.
  *
  * @module
  */
@@ -47,20 +46,20 @@ import {
 } from '@odoro-cli/server'
 import { z } from 'zod'
 
-/** Ce que rend le controle de vie. */
+/** What the liveness check returns. */
 const liveness = z.object({
   status: z.literal('ok'),
   environment: z.string(),
   uptime: z.number(),
 })
 
-/** Ce que rend le controle de disponibilite, quand tout repond. */
+/** What the readiness check returns, when everything answers. */
 const readiness = z.object({
   ready: z.literal(true),
   dependencies: z.array(z.object({ name: z.string(), detail: z.string() })),
 })
 
-/** Une dependance et son etat. */
+/** A dependency and its state. */
 interface Dependency {
   readonly name: string
   readonly ready: boolean
@@ -68,13 +67,13 @@ interface Dependency {
 }
 
 /**
- * Etat des dependances.
+ * State of the dependencies.
  *
- * La base n'est pas encore interrogee — le socle n'a pas sa couche de
- * persistance. Ce qui est verifie ici est sa **configuration**, ce qui suffit
- * a distinguer un projet qui n'a jamais recu d'URL d'un projet configure.
- * Quand la persistance arrivera, c'est cette fonction qui apprendra a ouvrir
- * une connexion, et rien d'autre ne changera.
+ * The database is not queried yet — the foundation has no persistence layer.
+ * What is checked here is its **configuration**, which is enough to tell a
+ * project that never received a URL from a configured one. When persistence
+ * arrives, this function is the one that will learn to open a connection, and
+ * nothing else will change.
  */
 function inspect(config: KernelConfig): readonly Dependency[] {
   const url = config.DATABASE_URL.trim()
@@ -84,14 +83,14 @@ function inspect(config: KernelConfig): readonly Dependency[] {
       ready: url.length > 0,
       detail:
         url.length > 0
-          ? 'URL configuree'
-          : 'DATABASE_URL absente — voir .env.example, ou lancer `odoro db:create`',
+          ? 'URL configured'
+          : 'DATABASE_URL missing — see .env.example, or run `odoro db:create`',
     },
   ]
 }
 
 /**
- * Construit le module.
+ * Builds the module.
  *
  * @example
  * createApp({ modules: [createHealthModule(config)], … })
@@ -105,7 +104,7 @@ export function createHealthModule(config: KernelConfig) {
         method: 'GET',
         path: '/api/health',
         auth: 'public',
-        summary: 'Le processus repond.',
+        summary: 'The process answers.',
         output: liveness,
         handler: () => ({
           status: 'ok' as const,
@@ -119,17 +118,17 @@ export function createHealthModule(config: KernelConfig) {
         method: 'GET',
         path: '/api/ready',
         auth: 'public',
-        summary: 'Les dependances repondent.',
+        summary: 'The dependencies answer.',
         output: readiness,
         handler: () => {
           const dependencies = inspect(config)
-          const manquantes = dependencies.filter((d) => !d.ready)
+          const missing = dependencies.filter((d) => !d.ready)
 
-          if (manquantes.length > 0) {
-            // 503 et non 500 : la demande etait valide, c'est le service qui
-            // ne peut pas encore y repondre.
+          if (missing.length > 0) {
+            // 503 and not 500: the request was valid, it is the service that
+            // cannot answer it yet.
             throw new ServiceUnavailableError(
-              manquantes.map((d) => `${d.name} — ${d.detail}`).join(' ; '),
+              missing.map((d) => `${d.name} — ${d.detail}`).join(' ; '),
             )
           }
 

package/dist/build-JFQHODAT.js

@@ -1,5 +0,0 @@
-#!/usr/bin/env node
-export { buildProject, reportBuild } from './chunk-22KJTV2R.js';
-import './chunk-LHZGX5ML.js';
-import './chunk-TQUJ3MFS.js';
-import './chunk-JMEHF3KN.js';

package/dist/chunk-22KJTV2R.js

@@ -1,380 +0,0 @@
-#!/usr/bin/env node
-import { extractEntries, fournisseurDe } from './chunk-LHZGX5ML.js';
-import { applyAlias, isBareSpecifier } from './chunk-TQUJ3MFS.js';
-import { info, colors, size, success, duration } from './chunk-JMEHF3KN.js';
-import { existsSync } from 'fs';
-import { readFile, rm, mkdir, writeFile, cp, stat } from 'fs/promises';
-import { join, basename, resolve, relative, sep } from 'path';
-import { build } from 'esbuild';
-
-// src/build/elaguer.ts
-var GROUPES = /* @__PURE__ */ new Set(["media", "supports", "layer", "container", "scope"]);
-function analyser(css) {
-  const noeuds = [];
-  let i = 0;
-  let debut = 0;
-  function avancer() {
-    const c = css[i];
-    if (c === "\\") {
-      i += 2;
-      return;
-    }
-    if (c === "/" && css[i + 1] === "*") {
-      const fin = css.indexOf("*/", i + 2);
-      i = fin === -1 ? css.length : fin + 2;
-      return;
-    }
-    if (c === '"' || c === "'") {
-      i += 1;
-      while (i < css.length && css[i] !== c) {
-        i += css[i] === "\\" ? 2 : 1;
-      }
-      i += 1;
-      return;
-    }
-    i += 1;
-  }
-  while (i < css.length) {
-    const c = css[i];
-    if (c === "{") {
-      const prelude = css.slice(debut, i).trim();
-      let profondeur = 1;
-      i += 1;
-      const debutCorps = i;
-      while (i < css.length && profondeur > 0) {
-        const d = css[i];
-        if (d === "{") {
-          profondeur += 1;
-          i += 1;
-        } else if (d === "}") {
-          profondeur -= 1;
-          i += 1;
-        } else {
-          avancer();
-        }
-      }
-      const corps = css.slice(debutCorps, i - 1);
-      if (prelude.startsWith("@")) {
-        const nom = /^@([a-zA-Z-]+)/.exec(prelude)?.[1] ?? "";
-        noeuds.push(
-          GROUPES.has(nom) ? { sorte: "groupe", prelude, enfants: analyser(corps) } : (
-            // `@keyframes`, `@font-face`, `@property` : recopies tels quels.
-            { sorte: "brut", texte: `${prelude}{${corps}}` }
-          )
-        );
-      } else if (prelude.length > 0) {
-        noeuds.push({ sorte: "regle", selecteur: prelude, corps });
-      }
-      debut = i;
-      continue;
-    }
-    if (c === ";" && css.slice(debut, i).trim().startsWith("@")) {
-      noeuds.push({ sorte: "brut", texte: `${css.slice(debut, i).trim()};` });
-      i += 1;
-      debut = i;
-      continue;
-    }
-    avancer();
-  }
-  return noeuds;
-}
-function ecrire(noeuds) {
-  return noeuds.map((n) => {
-    if (n.sorte === "brut") return n.texte;
-    if (n.sorte === "regle") return `${n.selecteur}{${n.corps}}`;
-    return `${n.prelude}{${ecrire(n.enfants)}}`;
-  }).join("\n");
-}
-function classesDe(selecteur) {
-  const classes = [];
-  const motif = /(?<!\\)\.((?:\\.|[\w-])+)/g;
-  for (const trouve of selecteur.matchAll(motif)) {
-    classes.push(trouve[1].replaceAll(/\\(.)/g, "$1"));
-  }
-  return classes;
-}
-function motsDe(texte) {
-  const mots = /* @__PURE__ */ new Set();
-  const motif = /[A-Za-z0-9_][A-Za-z0-9_:/.[\]%@-]*/g;
-  for (const trouve of texte.matchAll(motif)) mots.add(trouve[0]);
-  return mots;
-}
-function estUtilitaire(classe, prefixe) {
-  const nue = classe.slice(classe.lastIndexOf(":") + 1);
-  return nue.startsWith(prefixe);
-}
-function gardee(classe, employes, sauvegarde) {
-  if (employes.has(classe)) return true;
-  for (const regle of sauvegarde) {
-    if (typeof regle === "string" ? regle === classe : regle.test(classe)) return true;
-  }
-  return false;
-}
-function elaguer(css, sources, options = {}) {
-  const prefixe = options.prefixe ?? "o-";
-  const sauvegarde = options.sauvegarde ?? [];
-  const employes = /* @__PURE__ */ new Set();
-  for (const source of sources) {
-    for (const mot of motsDe(source)) employes.add(mot);
-  }
-  const vues = /* @__PURE__ */ new Set();
-  const survivantes = /* @__PURE__ */ new Set();
-  function filtrerSelecteur(selecteur) {
-    const retenus = decouperSelecteurs(selecteur).filter((un) => {
-      const utilitaires = classesDe(un).filter((c) => estUtilitaire(c, prefixe));
-      if (utilitaires.length === 0) return true;
-      for (const classe of utilitaires) vues.add(classe);
-      const survit = utilitaires.every((c) => gardee(c, employes, sauvegarde));
-      if (survit) for (const classe of utilitaires) survivantes.add(classe);
-      return survit;
-    });
-    return retenus.length === 0 ? void 0 : retenus.join(",");
-  }
-  function filtrer(noeuds) {
-    const retenus = [];
-    for (const noeud of noeuds) {
-      if (noeud.sorte === "brut") {
-        retenus.push(noeud);
-        continue;
-      }
-      if (noeud.sorte === "regle") {
-        const selecteur = filtrerSelecteur(noeud.selecteur);
-        if (selecteur !== void 0) retenus.push({ ...noeud, selecteur });
-        continue;
-      }
-      const enfants = filtrer(noeud.enfants);
-      if (enfants.length > 0) retenus.push({ ...noeud, enfants });
-    }
-    return retenus;
-  }
-  const elaguee = ecrire(filtrer(analyser(css)));
-  return {
-    css: elaguee,
-    octetsAvant: Buffer.byteLength(css),
-    octetsApres: Buffer.byteLength(elaguee),
-    gardees: survivantes.size,
-    retirees: vues.size - survivantes.size
-  };
-}
-function decouperSelecteurs(selecteur) {
-  const parts = [];
-  let profondeur = 0;
-  let debut = 0;
-  let i = 0;
-  while (i < selecteur.length) {
-    const c = selecteur[i];
-    if (c === "\\") {
-      i += 2;
-      continue;
-    }
-    if (c === '"' || c === "'") {
-      i += 1;
-      while (i < selecteur.length && selecteur[i] !== c) {
-        i += selecteur[i] === "\\" ? 2 : 1;
-      }
-      i += 1;
-      continue;
-    }
-    if (c === "(" || c === "[") profondeur += 1;
-    else if (c === ")" || c === "]") profondeur -= 1;
-    else if (c === "," && profondeur === 0) {
-      parts.push(selecteur.slice(debut, i).trim());
-      debut = i + 1;
-    }
-    i += 1;
-  }
-  parts.push(selecteur.slice(debut).trim());
-  return parts.filter((p) => p.length > 0);
-}
-
-// src/build/build.ts
-function toPosix(path) {
-  return path.split(sep).join("/");
-}
-function buildEnv(config) {
-  const env = {
-    MODE: "production",
-    DEV: false,
-    PROD: true,
-    BASE_URL: config.base
-  };
-  for (const [key, value] of Object.entries(process.env)) {
-    if (key.startsWith(config.envPrefix) && value !== void 0) env[key] = value;
-  }
-  return env;
-}
-function outputsForEntry(result, entry, outDir, root) {
-  const toRelative = (file) => toPosix(relative(outDir, resolve(root, file)));
-  for (const [file, meta] of Object.entries(result.metafile.outputs)) {
-    if (meta.entryPoint === void 0) continue;
-    if (resolve(root, meta.entryPoint) !== resolve(entry)) continue;
-    if (!file.endsWith(".js")) continue;
-    return {
-      script: toRelative(file),
-      styles: meta.cssBundle === void 0 ? [] : [toRelative(meta.cssBundle)]
-    };
-  }
-  return { script: void 0, styles: [] };
-}
-async function taillerFeuilles(result, config, html) {
-  const produits = Object.keys(result.metafile.outputs).map(
-    (f) => resolve(config.root, f)
-  );
-  const feuilles = produits.filter((f) => f.endsWith(".css"));
-  if (feuilles.length === 0) return;
-  const sources = [html];
-  for (const fichier of produits) {
-    if (fichier.endsWith(".js")) sources.push(await readFile(fichier, "utf8"));
-  }
-  const fournisseur = await fournisseurDe(config.root);
-  const employes = /* @__PURE__ */ new Set();
-  if (fournisseur !== void 0) {
-    for (const source of sources) for (const mot of motsDe(source)) employes.add(mot);
-    for (const garde of config.build.safelist) {
-      if (typeof garde === "string") employes.add(garde);
-    }
-  }
-  for (const feuille of feuilles) {
-    const avant = await readFile(feuille, "utf8");
-    if (fournisseur === void 0) {
-      const rapport = elaguer(avant, sources, { sauvegarde: config.build.safelist });
-      await writeFile(feuille, rapport.css, "utf8");
-      info(
-        `  ${colors.dim("elagage")} ${basename(feuille)}  ${size(rapport.octetsAvant)} \u2192 ${size(rapport.octetsApres)}  ${colors.dim(`${String(rapport.gardees)} classes gardees`)}`
-      );
-      continue;
-    }
-    const socle = elaguer(avant, [], {}).css;
-    const utilitaires = fournisseur.renderUtilitairesPour(employes);
-    const apres = `${socle}
-${utilitaires}`;
-    await writeFile(feuille, apres, "utf8");
-    info(
-      `  ${colors.dim("generation")} ${basename(feuille)}  ${size(Buffer.byteLength(avant))} \u2192 ${size(Buffer.byteLength(apres))}`
-    );
-  }
-}
-async function buildProject(config) {
-  const started = Date.now();
-  const indexFile = join(config.root, "index.html");
-  if (!existsSync(indexFile)) {
-    throw new Error(`[odoro] Aucun "index.html" a la racine du projet (${config.root}).`);
-  }
-  const html = await readFile(indexFile, "utf8");
-  const entries = extractEntries(html, config.root);
-  if (entries.length === 0) {
-    throw new Error(
-      `[odoro] Aucun point d'entree : "index.html" doit contenir un <script type="module" src="...">.`
-    );
-  }
-  await rm(config.outDir, { recursive: true, force: true });
-  await mkdir(config.outDir, { recursive: true });
-  const result = await build({
-    entryPoints: [...entries],
-    bundle: true,
-    format: "esm",
-    platform: "browser",
-    target: config.build.target,
-    splitting: true,
-    minify: config.build.minify,
-    sourcemap: config.build.sourcemap,
-    metafile: true,
-    outdir: join(config.outDir, "assets"),
-    absWorkingDir: config.root,
-    publicPath: `${config.base}assets`,
-    // Les empreintes rendent les fichiers immuables : ils peuvent etre mis en
-    // cache indefiniment, et un deploiement n'invalide que ce qui a change.
-    entryNames: "[name]-[hash]",
-    chunkNames: "chunk-[hash]",
-    assetNames: "[name]-[hash]",
-    jsx: "automatic",
-    logLevel: "silent",
-    define: {
-      "import.meta.env": JSON.stringify(buildEnv(config)),
-      "process.env.NODE_ENV": JSON.stringify("production"),
-      ...config.define
-    },
-    loader: {
-      ".svg": "file",
-      ".png": "file",
-      ".jpg": "file",
-      ".jpeg": "file",
-      ".gif": "file",
-      ".webp": "file",
-      ".avif": "file",
-      ".ico": "file",
-      ".woff": "file",
-      ".woff2": "file",
-      ".mp4": "file",
-      ".webm": "file"
-    },
-    plugins: [
-      {
-        name: "odoro-alias",
-        setup(builder) {
-          builder.onResolve({ filter: /.*/ }, (args) => {
-            if (args.kind === "entry-point") return null;
-            const aliased = applyAlias(args.path, config);
-            if (aliased === args.path || isBareSpecifier(aliased)) return null;
-            return builder.resolve(aliased, {
-              kind: "import-statement",
-              resolveDir: args.resolveDir,
-              importer: args.importer,
-              pluginData: { aliased: true }
-            });
-          });
-        }
-      }
-    ]
-  });
-  if (config.build.elaguer) await taillerFeuilles(result, config, html);
-  let output = html;
-  for (const entry of entries) {
-    const { script, styles } = outputsForEntry(
-      result,
-      entry,
-      join(config.outDir, "assets"),
-      config.root
-    );
-    if (script === void 0) continue;
-    const original = new RegExp(
-      `<script[^>]*type=["']module["'][^>]*src=["'][^"']*${basename(entry)}["'][^>]*></script>`,
-      "i"
-    );
-    const tags = [
-      ...styles.map(
-        (style) => `<link rel="stylesheet" href="${config.base}assets/${style}">`
-      ),
-      `<script type="module" crossorigin src="${config.base}assets/${script}"></script>`
-    ].join("\n    ");
-    output = output.replace(original, tags);
-  }
-  await writeFile(join(config.outDir, "index.html"), output, "utf8");
-  if (existsSync(config.publicDir)) {
-    await cp(config.publicDir, config.outDir, { recursive: true });
-  }
-  const files = (await Promise.all(
-    Object.keys(result.metafile.outputs).map(async (file) => {
-      const chemin = resolve(config.root, file);
-      return {
-        path: toPosix(relative(config.outDir, chemin)),
-        bytes: (await stat(chemin)).size
-      };
-    })
-  )).sort((a, b) => b.bytes - a.bytes);
-  return { outDir: config.outDir, files, elapsed: Date.now() - started };
-}
-function reportBuild(output, root) {
-  const directory = toPosix(relative(root, output.outDir)) || ".";
-  let total = 0;
-  for (const file of output.files) {
-    total += file.bytes;
-    if (file.path.endsWith(".map")) continue;
-    info(
-      `  ${colors.dim(`${directory}/`)}${file.path}  ${colors.dim(size(file.bytes))}`
-    );
-  }
-  success(`compile en ${duration(output.elapsed)} \u2014 ${size(total)} au total`);
-}
-
-export { buildProject, reportBuild };

package/dist/chunk-3SZIN6VG.js

@@ -1,64 +0,0 @@
-#!/usr/bin/env node
-import { readFile, writeFile, appendFile } from 'fs/promises';
-import { existsSync } from 'fs';
-import { join } from 'path';
-
-function checkDatabaseUrl(value) {
-  const url = value.trim();
-  if (url.length === 0) return "L'URL ne peut pas etre vide.";
-  if (!/^postgres(ql)?:\/\//i.test(url)) {
-    return "Une URL PostgreSQL commence par postgres:// ou postgresql://";
-  }
-  let parsed;
-  try {
-    parsed = new URL(url);
-  } catch {
-    return "Cette chaine n'est pas une URL valide.";
-  }
-  if (parsed.hostname.length === 0) return "Aucun hote dans cette URL.";
-  if (parsed.pathname.replace(/^\//, "").length === 0) {
-    return "Aucun nom de base : ajoutez-le apres le port, par exemple /mon_projet";
-  }
-  if (!/^(localhost|127\.0\.0\.1|\[::1\])$/i.test(parsed.hostname) && parsed.searchParams.get("sslmode") === "disable") {
-    return "sslmode=disable sur une base distante : le trafic passerait en clair.";
-  }
-  return void 0;
-}
-async function writeDatabaseUrl(target, url) {
-  const path = join(target, ".env");
-  const line = `DATABASE_URL=${url}
-`;
-  if (!existsSync(path)) {
-    const example = join(target, ".env.example");
-    const base = existsSync(example) ? await readFile(example, "utf8") : "";
-    await writeFile(path, base.replace(/^DATABASE_URL=.*$/m, line.trimEnd()), "utf8");
-    if (!base.includes("DATABASE_URL=")) await appendFile(path, line, "utf8");
-    return;
-  }
-  const current = await readFile(path, "utf8");
-  await writeFile(
-    path,
-    current.includes("DATABASE_URL=") ? current.replace(/^DATABASE_URL=.*$/m, line.trimEnd()) : current + line,
-    "utf8"
-  );
-}
-async function assertEnvIgnored(target) {
-  const path = join(target, ".gitignore");
-  if (!existsSync(path)) {
-    return "Aucun .gitignore : le fichier .env risque d'etre versionne.";
-  }
-  const content = await readFile(path, "utf8");
-  const ignored = content.split("\n").map((line) => line.trim()).some((line) => line === ".env" || line === ".env*" || line === "*.env");
-  return ignored ? void 0 : ".env ne figure pas dans le .gitignore : vos identifiants risquent d etre versionnes.";
-}
-var PROVIDER_PENDING = [
-  "Le provisionnement passe par @odoro-cli/cloud-sdk, installe a part :",
-  "",
-  "  npm install --save-dev @odoro-cli/cloud-sdk",
-  "  odoro db:login",
-  "  odoro db:create --env production",
-  "",
-  "Il ne vient pas avec odoro : ce binaire est telecharge a chaque creation de projet, et la plupart emploient leur propre base."
-].join("\n");
-
-export { PROVIDER_PENDING, assertEnvIgnored, checkDatabaseUrl, writeDatabaseUrl };