@pasosdejesus/m 0.27.2 → 0.28.0

package/dist/compose/manifest.js

@@ -0,0 +1,16 @@
+/**
+ * Composición de motores (https://gitlab.com/pasosdeJesus/m/-/work_items/39) — tipos puros.
+ *
+ * Un motor se describe con **dos archivos**:
+ *   - `m-engine.json`          → **intención** (a mano): montaje, motores/tablas
+ *                                que usa, capacidades, futuros renombres.
+ *   - `m-engine.generated.ts`  → **hechos derivados** (generado por `eng:sync`):
+ *                                nombre/versión, modelo, contratos, vistas, comandos.
+ *
+ * Regla de oro: lo que se **deriva** no se escribe a mano; lo que es **intención**
+ * (y no se puede derivar) va en `m-engine.json`.
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+export {};
+//# sourceMappingURL=manifest.js.map

package/dist/compose/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/compose/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/compose/sync.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `eng:sync [<motor>] [--check]` (https://gitlab.com/pasosdeJesus/m/-/work_items/39, D3) — **genera** `m-engine.generated.ts`
+ * from the motor's sources. Idempotent: re-running with no source change is a
+ * no-op. With `--check` it writes nothing and reports whether it is stale.
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+import type { SyncResult } from './manifest.js';
+export declare function sync(dir: string, options?: {
+    check?: boolean;
+}): SyncResult;
+//# sourceMappingURL=sync.d.ts.map

package/dist/compose/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/compose/sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,UAAU,CAa/E"}

package/dist/compose/sync.js

@@ -0,0 +1,27 @@
+/**
+ * `eng:sync [<motor>] [--check]` (https://gitlab.com/pasosdeJesus/m/-/work_items/39, D3) — **genera** `m-engine.generated.ts`
+ * from the motor's sources. Idempotent: re-running with no source change is a
+ * no-op. With `--check` it writes nothing and reports whether it is stale.
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import { GENERATED_RELATIVE, deriveFrom, renderGenerated } from './derive.js';
+import { readIntention, readPackageJson } from './discover.js';
+export function sync(dir, options = {}) {
+    if (!readIntention(dir))
+        throw new Error(`not a motor (no m-engine.json): ${dir}`);
+    const pkg = readPackageJson(dir);
+    const derived = deriveFrom(dir, pkg?.name ?? basename(dir), pkg?.version ?? '0.0.0', pkg);
+    const contents = renderGenerated(derived);
+    const path = join(dir, GENERATED_RELATIVE);
+    const existing = existsSync(path) ? readFileSync(path, 'utf-8') : null;
+    const changed = existing !== contents;
+    if (!options.check && changed) {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, contents, 'utf-8');
+    }
+    return { path, changed };
+}
+//# sourceMappingURL=sync.js.map

package/dist/compose/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/compose/sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEnD,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAG9D,MAAM,UAAU,IAAI,CAAC,GAAW,EAAE,UAA+B,EAAE;IACjE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAA;IAClF,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;IAChC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,IAAI,OAAO,EAAE,GAAG,CAAC,CAAA;IACzF,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAA;IAC1C,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACtE,MAAM,OAAO,GAAG,QAAQ,KAAK,QAAQ,CAAA;IACrC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,EAAE,CAAC;QAC9B,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7C,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;IACxC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;AAC1B,CAAC"}

package/dist/compose/usage.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Autocontención (https://gitlab.com/pasosdeJesus/m/-/work_items/39 D7/§4): "lo que el proyecto usa" se deriva de sus
+ * **`import`/código** —las tablas de los motores que referencia— y se compara con
+ * lo **declarado** en su `m-engine.json` (`engines.<motor>.tables`) para reportar
+ * `missing`/`extra`.
+ *
+ * Herramienta: la API **sintáctica** de `tsc` (`ts.createSourceFile`, sin
+ * `Program`); si `typescript` no está disponible, `grep`-like por nombre. Alcance:
+ * `src/**` y `app/**`; `node_modules` fuera.
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+import { type PackageJson } from './discover.js';
+export interface DeclaredUsage {
+    /** Unión de las tablas declaradas (`engines.<motor>.tables`). */
+    all: string[];
+    byMotor: Record<string, string[]>;
+}
+export interface UsageReport {
+    used: string[];
+    missing: string[];
+    extra: string[];
+}
+/** Fuentes del proyecto (`src/**`, `app/**`). */
+export declare function projectSources(rootDir: string): string[];
+/**
+ * Tablas (de `tables`) que el código del proyecto referencia. Con `typescript`
+ * usa el parser sintáctico (identificadores y literales de cadena); si no, un
+ * chequeo por nombre con límites de palabra.
+ */
+export declare function tablesUsed(rootDir: string, tables: readonly string[]): string[];
+/** Tablas declaradas por un proyecto en su `m-engine.json` (`engines.<motor>.tables`). */
+export declare function declaredUsage(projectDir: string): DeclaredUsage;
+/** Compara lo usado contra lo declarado: `missing` (usado y no declarado) y `extra`. */
+export declare function usageReport(used: readonly string[], declared: readonly string[]): UsageReport;
+export interface ImportFinding {
+    /** Paquete externo importado. */
+    name: string;
+    /** Archivo donde se importa (el primero que se encuentra). */
+    file: string;
+    /** `true` cuando el import está sólo en pruebas (`*.test.ts`). */
+    dev: boolean;
+}
+/** Paquete de un especificador (`@alcance/pkg/sub` → `@alcance/pkg`); `null` si es relativo o `node:`. */
+export declare function packageOf(specifier: string): string | null;
+/** Paquetes externos que importa un motor (`src/**`), con el archivo y si es sólo de pruebas. */
+export declare function importedPackages(motorDir: string): ImportFinding[];
+/**
+ * "El motor declara lo que usa": imports externos de `src/**` que no están en las
+ * `dependencies`/`peerDependencies`/`optionalDependencies` del motor (para pruebas,
+ * vale también `devDependencies`).
+ */
+export declare function undeclaredImports(motorDir: string, pkg: PackageJson | null): ImportFinding[];
+//# sourceMappingURL=usage.d.ts.map

package/dist/compose/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/compose/usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AAE/D,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAYD,iDAAiD;AACjD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAIxD;AAUD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAyB/E;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAQ/D;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAQ7F;AAED,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,GAAG,EAAE,OAAO,CAAA;CACb;AAED,0GAA0G;AAC1G,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK1D;AA2BD,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAelE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,GAAG,aAAa,EAAE,CAQ5F"}

package/dist/compose/usage.js

@@ -0,0 +1,167 @@
+/**
+ * Autocontención (https://gitlab.com/pasosdeJesus/m/-/work_items/39 D7/§4): "lo que el proyecto usa" se deriva de sus
+ * **`import`/código** —las tablas de los motores que referencia— y se compara con
+ * lo **declarado** en su `m-engine.json` (`engines.<motor>.tables`) para reportar
+ * `missing`/`extra`.
+ *
+ * Herramienta: la API **sintáctica** de `tsc` (`ts.createSourceFile`, sin
+ * `Program`); si `typescript` no está disponible, `grep`-like por nombre. Alcance:
+ * `src/**` y `app/**`; `node_modules` fuera.
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { readIntention } from './discover.js';
+function walk(dir, acc) {
+    if (!existsSync(dir))
+        return;
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        if (entry.name === 'node_modules' || entry.name === 'dist' || entry.name.startsWith('.'))
+            continue;
+        const full = join(dir, entry.name);
+        if (entry.isDirectory())
+            walk(full, acc);
+        else if (/\.tsx?$/.test(entry.name) && !/\.d\.ts$/.test(entry.name))
+            acc.push(full);
+    }
+}
+/** Fuentes del proyecto (`src/**`, `app/**`). */
+export function projectSources(rootDir) {
+    const files = [];
+    for (const base of ['src', 'app'])
+        walk(join(rootDir, base), files);
+    return files;
+}
+function tryLoadTypescript() {
+    try {
+        return createRequire(import.meta.url)('typescript');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Tablas (de `tables`) que el código del proyecto referencia. Con `typescript`
+ * usa el parser sintáctico (identificadores y literales de cadena); si no, un
+ * chequeo por nombre con límites de palabra.
+ */
+export function tablesUsed(rootDir, tables) {
+    const names = new Set(tables);
+    if (names.size === 0)
+        return [];
+    const used = new Set();
+    const ts = tryLoadTypescript();
+    for (const file of projectSources(rootDir)) {
+        const text = readFileSync(file, 'utf-8');
+        if (!ts) {
+            for (const name of names) {
+                if (new RegExp(`\\b${name}\\b`).test(text))
+                    used.add(name);
+            }
+            continue;
+        }
+        const source = ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true);
+        const visit = (node) => {
+            const candidate = ts.isIdentifier(node) || ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node)
+                ? node.text
+                : undefined;
+            if (candidate !== undefined && names.has(candidate))
+                used.add(candidate);
+            ts.forEachChild(node, visit);
+        };
+        visit(source);
+    }
+    return [...used].sort();
+}
+/** Tablas declaradas por un proyecto en su `m-engine.json` (`engines.<motor>.tables`). */
+export function declaredUsage(projectDir) {
+    const intention = readIntention(projectDir);
+    const byMotor = {};
+    for (const [motor, ref] of Object.entries(intention?.engines ?? {})) {
+        if (ref.tables && ref.tables.length > 0)
+            byMotor[motor] = [...ref.tables];
+    }
+    const all = [...new Set(Object.values(byMotor).flat())].sort();
+    return { all, byMotor };
+}
+/** Compara lo usado contra lo declarado: `missing` (usado y no declarado) y `extra`. */
+export function usageReport(used, declared) {
+    const usedSet = new Set(used);
+    const declaredSet = new Set(declared);
+    return {
+        used: [...usedSet].sort(),
+        missing: [...usedSet].filter((table) => !declaredSet.has(table)).sort(),
+        extra: [...declaredSet].filter((table) => !usedSet.has(table)).sort(),
+    };
+}
+/** Paquete de un especificador (`@alcance/pkg/sub` → `@alcance/pkg`); `null` si es relativo o `node:`. */
+export function packageOf(specifier) {
+    if (!specifier || specifier.startsWith('.') || specifier.startsWith('/') || specifier.startsWith('node:'))
+        return null;
+    const [first, second] = specifier.split('/');
+    if (specifier.startsWith('@'))
+        return second ? `${first}/${second}` : null;
+    return first || null;
+}
+/** Especificadores de módulo de unas fuentes (import/export … from/require). */
+function moduleSpecifiers(file, text, ts) {
+    if (!ts) {
+        // Fallback sin `typescript`: cuenta también el texto emitido dentro de plantillas.
+        const found = [];
+        for (const re of [/from\s+['"]([^'"]+)['"]/g, /require\(\s*['"]([^'"]+)['"]\s*\)/g]) {
+            for (const match of text.matchAll(re))
+                found.push(match[1]);
+        }
+        return found;
+    }
+    const source = ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true);
+    const found = [];
+    const visit = (node) => {
+        const specifier = (ts.isImportDeclaration(node) || ts.isExportDeclaration(node))
+            ? node.moduleSpecifier
+            : (ts.isImportEqualsDeclaration(node) && ts.isExternalModuleReference(node.moduleReference))
+                ? node.moduleReference.expression
+                : undefined;
+        if (specifier && ts.isStringLiteralLike(specifier))
+            found.push(specifier.text);
+        ts.forEachChild(node, visit);
+    };
+    visit(source);
+    return found;
+}
+/** Paquetes externos que importa un motor (`src/**`), con el archivo y si es sólo de pruebas. */
+export function importedPackages(motorDir) {
+    const ts = tryLoadTypescript();
+    const byName = new Map();
+    for (const file of projectSources(motorDir)) {
+        const text = readFileSync(file, 'utf-8');
+        for (const specifier of moduleSpecifiers(file, text, ts)) {
+            const name = packageOf(specifier);
+            if (!name)
+                continue;
+            const dev = /\.test\.tsx?$/.test(file);
+            const previous = byName.get(name);
+            if (previous && (!previous.dev || dev))
+                continue;
+            byName.set(name, { name, file, dev });
+        }
+    }
+    return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * "El motor declara lo que usa": imports externos de `src/**` que no están en las
+ * `dependencies`/`peerDependencies`/`optionalDependencies` del motor (para pruebas,
+ * vale también `devDependencies`).
+ */
+export function undeclaredImports(motorDir, pkg) {
+    const declared = new Set([
+        ...Object.keys(pkg?.dependencies ?? {}),
+        ...Object.keys(pkg?.peerDependencies ?? {}),
+        ...Object.keys(pkg?.optionalDependencies ?? {}),
+    ]);
+    const devDeclared = new Set([...declared, ...Object.keys(pkg?.devDependencies ?? {})]);
+    return importedPackages(motorDir).filter((finding) => !(finding.dev ? devDeclared : declared).has(finding.name));
+}
+//# sourceMappingURL=usage.js.map

package/dist/compose/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/compose/usage.ts"],"names":[],"mappings":"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"}

package/dist/compose/vendor.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Vendorización "etapa 0" (https://gitlab.com/pasosdeJesus/m/-/work_items/39 D17): copia trazable de un motor dentro del
+ * consumidor (`packages/generated/<motor>`), con **procedencia** (motor, versión,
+ * origen y `sha256`) para poder medir **drift** contra el original. Adoptar un
+ * cambio del motor = **regenerar** (`eng:sync --vendor`), no fusionar a mano.
+ *
+ * "Porque ¿quién de vosotros, queriendo edificar una torre, no se sienta primero y calcula los gastos…?" (Lucas 14:28)
+ */
+import { type PackageJson } from './discover.js';
+export interface Provenance {
+    motor: string;
+    version: string;
+    source: string;
+    sha256: string;
+}
+/** `sha256` del esquema de referencia del motor (`db/structure.sql`), o `null`. */
+export declare function structureSha(dir: string): string | null;
+/**
+ * `tsconfig.json` de la copia vendorizada: proyecto **autónomo** (no hereda de `m`),
+ * de modo que cada copia se compile por separado (`tsc -b`) y no pese en el
+ * consumidor (mismo criterio que sus paquetes de motor, p. ej. `gdcluster`).
+ */
+export declare function vendoredTsconfig(): string;
+/** `package.json` de la copia vendorizada: paquete propio, compilable por separado. */
+export declare function vendoredPackageJson(motorDir: string, pkg: PackageJson | null): string;
+/**
+ * Motor original con el que medir el drift de una copia vendorizada: el `--from`
+ * (la carpeta del motor, o un checkout donde vive en `packages/<motor>`), y si no
+ * la `source` de la procedencia.
+ */
+export declare function resolveOrigin(from: string | null, motorName: string, provenanceSource?: string): string | null;
+/** Copia un motor a `outDir` con procedencia. Regenera: borra `outDir` primero. */
+export declare function vendor(motorDir: string, outDir: string): Provenance;
+/** Lee la procedencia de una copia vendorizada, o `null`. */
+export declare function readProvenance(outDir: string): Provenance | null;
+/** Quita una copia vendorizada. Devuelve `true` si existía. */
+export declare function unvendor(outDir: string): boolean;
+export type DriftCode = 'ok' | 'drift' | 'absent';
+export interface DriftFinding {
+    code: DriftCode;
+    message: string;
+}
+/** Mide el drift de una copia vendorizada contra el motor original. */
+export declare function drift(outDir: string, originalDir: string): DriftFinding;
+//# sourceMappingURL=vendor.d.ts.map

package/dist/compose/vendor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendor.d.ts","sourceRoot":"","sources":["../../src/compose/vendor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAAkC,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AAKhF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIvD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAmBzC;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,GAAG,MAAM,CAwBrF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS9G;AAED,mFAAmF;AACnF,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAwBnE;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAQhE;AAED,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAIhD;AAED,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEjD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,uEAAuE;AACvE,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,CAUvE"}

package/dist/compose/vendor.js

@@ -0,0 +1,147 @@
+/**
+ * Vendorización "etapa 0" (https://gitlab.com/pasosdeJesus/m/-/work_items/39 D17): copia trazable de un motor dentro del
+ * consumidor (`packages/generated/<motor>`), con **procedencia** (motor, versión,
+ * origen y `sha256`) para poder medir **drift** contra el original. Adoptar un
+ * cambio del motor = **regenerar** (`eng:sync --vendor`), no fusionar a mano.
+ *
+ * "Porque ¿quién de vosotros, queriendo edificar una torre, no se sienta primero y calcula los gastos…?" (Lucas 14:28)
+ */
+import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { basename, join } from 'node:path';
+import { readIntention, readPackageJson } from './discover.js';
+/** Archivos/entradas que se copian del motor a la copia vendorizada. */
+const VENDORED = ['src', 'db', 'm-engine.json', 'm-engine.generated.ts'];
+/** `sha256` del esquema de referencia del motor (`db/structure.sql`), o `null`. */
+export function structureSha(dir) {
+    const file = join(dir, 'db', 'structure.sql');
+    if (!existsSync(file))
+        return null;
+    return createHash('sha256').update(readFileSync(file)).digest('hex');
+}
+/**
+ * `tsconfig.json` de la copia vendorizada: proyecto **autónomo** (no hereda de `m`),
+ * de modo que cada copia se compile por separado (`tsc -b`) y no pese en el
+ * consumidor (mismo criterio que sus paquetes de motor, p. ej. `gdcluster`).
+ */
+export function vendoredTsconfig() {
+    return `${JSON.stringify({
+        compilerOptions: {
+            target: 'ES2022',
+            module: 'NodeNext',
+            moduleResolution: 'NodeNext',
+            lib: ['ES2022'],
+            rootDir: './src',
+            outDir: './dist',
+            declaration: true,
+            composite: true,
+            strict: true,
+            skipLibCheck: true,
+            esModuleInterop: true,
+            forceConsistentCasingInFileNames: true,
+        },
+        include: ['src/**/*'],
+        exclude: ['node_modules', 'dist'],
+    }, null, 2)}\n`;
+}
+/** `package.json` de la copia vendorizada: paquete propio, compilable por separado. */
+export function vendoredPackageJson(motorDir, pkg) {
+    const name = `generated-${basename(motorDir)}`;
+    const version = pkg?.version ?? '0.0.0';
+    const dependencies = { ...(pkg?.dependencies ?? {}), ...(pkg?.peerDependencies ?? {}) };
+    const manifest = {
+        name,
+        version,
+        private: true,
+        type: 'module',
+        description: `Copia vendorizada de ${pkg?.name ?? name} v${version}, generada por \`bin/m eng:sync --vendor\`; no editar a mano.`,
+        main: 'dist/index.js',
+        types: 'dist/index.d.ts',
+        exports: {
+            '.': { import: './dist/index.js', types: './dist/index.d.ts' },
+            './*': { import: './dist/*.js', types: './dist/*.d.ts' },
+        },
+        scripts: {
+            build: 'npx tsc -b',
+            typecheck: 'npx tsc -b --pretty false',
+            clean: 'rm -rf dist tsconfig.tsbuildinfo',
+        },
+    };
+    if (Object.keys(dependencies).length > 0)
+        manifest.dependencies = dependencies;
+    return `${JSON.stringify(manifest, null, 2)}\n`;
+}
+/**
+ * Motor original con el que medir el drift de una copia vendorizada: el `--from`
+ * (la carpeta del motor, o un checkout donde vive en `packages/<motor>`), y si no
+ * la `source` de la procedencia.
+ */
+export function resolveOrigin(from, motorName, provenanceSource) {
+    if (!from)
+        return provenanceSource && existsSync(provenanceSource) ? provenanceSource : null;
+    const names = [...new Set([motorName, basename(motorName)])];
+    const candidates = [
+        from,
+        ...names.map((name) => join(from, 'packages', name)),
+        ...names.map((name) => join(from, 'packages', 'generated', name)),
+    ];
+    return candidates.find((dir) => existsSync(join(dir, 'm-engine.json'))) ?? null;
+}
+/** Copia un motor a `outDir` con procedencia. Regenera: borra `outDir` primero. */
+export function vendor(motorDir, outDir) {
+    if (!readIntention(motorDir))
+        throw new Error(`not a motor (no m-engine.json): ${motorDir}`);
+    const pkg = readPackageJson(motorDir);
+    rmSync(outDir, { recursive: true, force: true });
+    mkdirSync(outDir, { recursive: true });
+    // Se copia el modelo + capa de datos, no las pruebas del motor.
+    const keep = (source) => !/\.test\.tsx?$/.test(source);
+    for (const entry of VENDORED) {
+        const from = join(motorDir, entry);
+        if (existsSync(from))
+            cpSync(from, join(outDir, entry), { recursive: true, filter: keep });
+    }
+    // Paquete propio + tsconfig autónomo: cada copia se compila por separado (`tsc -b`).
+    writeFileSync(join(outDir, 'package.json'), vendoredPackageJson(motorDir, pkg));
+    writeFileSync(join(outDir, 'tsconfig.json'), vendoredTsconfig());
+    const provenance = {
+        motor: pkg?.name ?? basename(motorDir),
+        version: pkg?.version ?? '0.0.0',
+        source: motorDir,
+        sha256: structureSha(motorDir) ?? '',
+    };
+    writeFileSync(join(outDir, 'PROVENANCE.json'), JSON.stringify(provenance, null, 2) + '\n');
+    return provenance;
+}
+/** Lee la procedencia de una copia vendorizada, o `null`. */
+export function readProvenance(outDir) {
+    const file = join(outDir, 'PROVENANCE.json');
+    if (!existsSync(file))
+        return null;
+    try {
+        return JSON.parse(readFileSync(file, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** Quita una copia vendorizada. Devuelve `true` si existía. */
+export function unvendor(outDir) {
+    if (!existsSync(outDir))
+        return false;
+    rmSync(outDir, { recursive: true, force: true });
+    return true;
+}
+/** Mide el drift de una copia vendorizada contra el motor original. */
+export function drift(outDir, originalDir) {
+    const provenance = readProvenance(outDir);
+    const current = structureSha(originalDir);
+    if (!provenance || current === null) {
+        return { code: 'absent', message: `sin procedencia o esquema en ${outDir}` };
+    }
+    if (provenance.sha256 === current) {
+        return { code: 'ok', message: `${provenance.motor} v${provenance.version} al día` };
+    }
+    return { code: 'drift', message: `${provenance.motor} v${provenance.version} desactualizado; corre \`eng:sync --vendor\`` };
+}
+//# sourceMappingURL=vendor.js.map

package/dist/compose/vendor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendor.js","sourceRoot":"","sources":["../../src/compose/vendor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5F,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAE1C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAoB,MAAM,eAAe,CAAA;AAEhF,wEAAwE;AACxE,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,uBAAuB,CAAC,CAAA;AASxE,mFAAmF;AACnF,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,eAAe,CAAC,CAAA;IAC7C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAClC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACtE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QACvB,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,UAAU;YAClB,gBAAgB,EAAE,UAAU;YAC5B,GAAG,EAAE,CAAC,QAAQ,CAAC;YACf,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,IAAI;YACjB,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,IAAI;YACrB,gCAAgC,EAAE,IAAI;SACvC;QACD,OAAO,EAAE,CAAC,UAAU,CAAC;QACrB,OAAO,EAAE,CAAC,cAAc,EAAE,MAAM,CAAC;KAClC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAA;AACjB,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,GAAuB;IAC3E,MAAM,IAAI,GAAG,aAAa,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAA;IAC9C,MAAM,OAAO,GAAG,GAAG,EAAE,OAAO,IAAI,OAAO,CAAA;IACvC,MAAM,YAAY,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,YAAY,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,gBAAgB,IAAI,EAAE,CAAC,EAAE,CAAA;IACvF,MAAM,QAAQ,GAA4B;QACxC,IAAI;QACJ,OAAO;QACP,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,wBAAwB,GAAG,EAAE,IAAI,IAAI,IAAI,KAAK,OAAO,+DAA+D;QACjI,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,iBAAiB;QACxB,OAAO,EAAE;YACP,GAAG,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,mBAAmB,EAAE;YAC9D,KAAK,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,eAAe,EAAE;SACzD;QACD,OAAO,EAAE;YACP,KAAK,EAAE,YAAY;YACnB,SAAS,EAAE,2BAA2B;YACtC,KAAK,EAAE,kCAAkC;SAC1C;KACF,CAAA;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,QAAQ,CAAC,YAAY,GAAG,YAAY,CAAA;IAC9E,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAA;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAmB,EAAE,SAAiB,EAAE,gBAAyB;IAC7F,IAAI,CAAC,IAAI;QAAE,OAAO,gBAAgB,IAAI,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAA;IAC5F,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5D,MAAM,UAAU,GAAG;QACjB,IAAI;QACJ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;QACpD,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;KAClE,CAAA;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;AACjF,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,MAAM,CAAC,QAAgB,EAAE,MAAc;IACrD,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAA;IAC5F,MAAM,GAAG,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;IAErC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAChD,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACtC,gEAAgE;IAChE,MAAM,IAAI,GAAG,CAAC,MAAc,EAAW,EAAE,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACvE,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAClC,IAAI,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAC5F,CAAC;IACD,qFAAqF;IACrF,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,mBAAmB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAA;IAC/E,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAA;IAEhE,MAAM,UAAU,GAAe;QAC7B,KAAK,EAAE,GAAG,EAAE,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC;QACtC,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,OAAO;QAChC,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE;KACrC,CAAA;IACD,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAC1F,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;IAC5C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAClC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAe,CAAA;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAA;IACrC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAChD,OAAO,IAAI,CAAA;AACb,CAAC;AASD,uEAAuE;AACvE,MAAM,UAAU,KAAK,CAAC,MAAc,EAAE,WAAmB;IACvD,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAA;IACzC,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CAAC,CAAA;IACzC,IAAI,CAAC,UAAU,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACpC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,gCAAgC,MAAM,EAAE,EAAE,CAAA;IAC9E,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAClC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC,KAAK,KAAK,UAAU,CAAC,OAAO,SAAS,EAAE,CAAA;IACrF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC,KAAK,KAAK,UAAU,CAAC,OAAO,8CAA8C,EAAE,CAAA;AAC7H,CAAC"}

package/dist/compose/verify.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `eng:verify [<motor>]` (https://gitlab.com/pasosdeJesus/m/-/work_items/39, D3) — **guarda** `m-engine.generated.ts` against
+ * the sources and the intention; writes nothing and reports findings. Fails when
+ * the generated facts no longer derive from the sources, when a declared engine
+ * was not discovered, or when `engines.<a>.tables` names a table `a` does not own.
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+import type { EngineManifest, VerifyResult } from './manifest.js';
+export declare function verify(dir: string, byName?: ReadonlyMap<string, EngineManifest>): VerifyResult;
+//# sourceMappingURL=verify.d.ts.map

package/dist/compose/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/compose/verify.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAW,cAAc,EAAW,YAAY,EAAE,MAAM,eAAe,CAAA;AAMnF,wBAAgB,MAAM,CACpB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAa,GACtD,YAAY,CA0Dd"}

package/dist/compose/verify.js

@@ -0,0 +1,74 @@
+/**
+ * `eng:verify [<motor>]` (https://gitlab.com/pasosdeJesus/m/-/work_items/39, D3) — **guarda** `m-engine.generated.ts` against
+ * the sources and the intention; writes nothing and reports findings. Fails when
+ * the generated facts no longer derive from the sources, when a declared engine
+ * was not discovered, or when `engines.<a>.tables` names a table `a` does not own.
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+import { basename } from 'node:path';
+import { deriveFrom, readGenerated } from './derive.js';
+import { readIntention, readPackageJson } from './discover.js';
+function sameDerived(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+export function verify(dir, byName = new Map()) {
+    const findings = [];
+    const intention = readIntention(dir);
+    // Not a motor: nothing to guard (the caller decides whether that is an error).
+    if (!intention)
+        return { ok: true, findings };
+    const pkg = readPackageJson(dir);
+    const name = pkg?.name ?? basename(dir);
+    const version = pkg?.version ?? '0.0.0';
+    const derived = deriveFrom(dir, name, version, pkg);
+    const generated = readGenerated(dir);
+    if (!generated) {
+        findings.push({
+            code: 'GENERATED_MISSING',
+            motor: name,
+            message: `m-engine.generated.ts is missing; run \`eng:sync\``,
+        });
+    }
+    else if (!sameDerived(generated, derived)) {
+        findings.push({
+            code: 'GENERATED_STALE',
+            motor: name,
+            message: `m-engine.generated.ts no longer matches the sources; run \`eng:sync\``,
+        });
+    }
+    for (const [motor, ref] of Object.entries(intention.engines ?? {})) {
+        const dependency = byName.get(motor);
+        if (!dependency) {
+            findings.push({
+                code: 'MISSING_ENGINE',
+                motor,
+                message: `declares engine "${motor}" but it was not discovered`,
+            });
+            continue;
+        }
+        for (const table of ref.tables ?? []) {
+            if (dependency.model.tables.includes(table))
+                continue;
+            const owner = [...byName.values()].find((engine) => engine.model.tables.includes(table));
+            if (owner) {
+                findings.push({
+                    code: 'BROKEN_REFERENCE',
+                    motor,
+                    table,
+                    message: `table "${table}" belongs to "${owner.name}", not to "${motor}"`,
+                });
+            }
+            else {
+                findings.push({
+                    code: 'UNKNOWN_TABLE',
+                    motor,
+                    table,
+                    message: `engine "${motor}" does not own table "${table}"`,
+                });
+            }
+        }
+    }
+    return { ok: findings.length === 0, findings };
+}
+//# sourceMappingURL=verify.js.map

package/dist/compose/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/compose/verify.ts"],"names":[],"mappings":"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"}

package/dist/e2e/env.d.ts

@@ -14,7 +14,7 @@ export interface E2EEnv {
     /** Billetera principal (sesión SIWE / primer wallet). */
     account: E2EAccount;
     /**
-     * Todas las billeteras disponibles (REQ/35: flujos de claim pueden necesitar
+     * Todas las billeteras disponibles (https://gitlab.com/pasosdeJesus/m/-/work_items/35: flujos de claim pueden necesitar
      * una billetera de sesión y otra claimer con fondos para gas).
      * Fuentes: TEST_PRIVATE_KEYS (lista separada por comas, prioridad),
      * TEST_PRIVATE_KEY, apps/.env, Hardhat test key.