@jantstack/adonis-authz 2.0.0-alpha.1 → 2.4.0-alpha.10

package/build/commands/authz_scopes_requeue.js

@@ -0,0 +1,230 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { BaseCommand, flags } from '@adonisjs/core/ace';
+/** Una entrada de la cola, en una línea (misma forma que en `authz:scopes:relay`). */
+function linea(item) {
+    const { change } = item;
+    const scope = (s) => `${s.type}:${s.uuid ?? ''}`;
+    const destino = change.op === 'detached' ? '' : ` → ${scope(change.parent)}`;
+    const intentos = item.attempts ? ` (intentos: ${item.attempts})` : '';
+    const causa = item.lastError ? ` — ${item.lastError}` : '';
+    return `#${item.id} ${change.op} ${scope(change.child)}${destino}${intentos}${causa}`;
+}
+/**
+ * Las líneas del comando y si la ejecución es «limpia», en una función PURA
+ * (mismo patrón que `reconcileLines`/`orphanLines`): es lo único del comando
+ * que decide algo, y así tiene su caso sin montar un ace.
+ *
+ *  - `refused`: el manager se NEGÓ (500 `E_AUTHZ_REQUEUE_REFUSED`). Se imprime
+ *    el DIFF entero —cada aparcada y cada entrada APLICADA posterior que
+ *    reaplicarla revertiría— y se sale ≠ 0, con las dos salidas: `--force`
+ *    (que entra igual, con este mismo diff delante) y `authz:reconcile`.
+ *  - `report`: se reencoló. Con `forced` y `overrides`, el diff se imprime
+ *    como AVISO: forzar no es un éxito mudo.
+ *  - `report.relay` (con `--apply`, 2.4.0-alpha.8): la pasada que relevó SOLO
+ *    lo reencolado, bajo el mismo lease. `busy` ⇒ NO se reencoló nada (todo o
+ *    nada) y se sale ≠ 0 con la letra («otra pasada tiene el lease; reintenta,
+ *    o `requeue` sin `--apply`»); cada entrada dice si se aplicó, falló o quedó
+ *    aplazada, y solo es limpio si TODO lo reencolado se aplicó.
+ */
+export function requeueLines(input) {
+    const lines = [];
+    const diff = (level, conflict) => {
+        lines.push({
+            level,
+            message: `${level === 'error' ? 'NEGADO' : 'FORZADO'}: ${linea(conflict.parked)} está APARCADA y hay ` +
+                `${conflict.applied.length} entrada(s) APLICADA(s) después sobre la misma clave de scope. Reencolarla las REVERTIRÍA ` +
+                `(el store quedaría con un árbol que nunca existió, y con UN solo padre nada lo delata):`,
+        });
+        for (const applied of conflict.applied)
+            lines.push({ level, message: `    revertiría ${linea(applied)}` });
+        if (conflict.truncated) {
+            lines.push({
+                level,
+                message: `    … y más: solo se listan las primeras ${conflict.applied.length} aplicadas posteriores sobre esa clave; el diff está CORTADO.`,
+            });
+        }
+    };
+    if (input.refused !== undefined) {
+        for (const conflict of input.refused)
+            diff('error', conflict);
+        lines.push({
+            level: 'warning',
+            message: 'No se ha reencolado NADA (todo o nada). Para recalcular el store con el árbol de HOY: ' +
+                'node ace authz:reconcile --to=<driver>. Si de verdad quieres revertir esas entradas, repite con --force: ' +
+                'imprime este mismo diff y entra igual.',
+        });
+        return { lines, clean: false };
+    }
+    const report = input.report;
+    if (report.relay?.busy) {
+        lines.push({
+            level: 'error',
+            message: 'Otra pasada del relay tiene el lease de la cola: con --apply no se ha reencolado NADA (todo o nada: reencolar y no ' +
+                'aplicar dejaría la entrada con un solo intento, que la siguiente pasada gastaría). Reintenta (--wait-lease-ms espera ' +
+                'a que la suelten), o reencola sin --apply y deja que la próxima pasada la aplique.',
+        });
+        return { lines, clean: false };
+    }
+    if (report.forced)
+        for (const conflict of report.overrides)
+            diff('warning', conflict);
+    for (const item of report.requeued)
+        lines.push({ level: 'log', message: `reencolada: ${linea(item)}` });
+    if (report.relay === undefined) {
+        lines.push({
+            level: 'success',
+            message: `${report.requeued.length} entrada(s) devuelta(s) a la cola con attempts = maxAttempts − 1: si la causa sigue rota ` +
+                'vuelve(n) a aparcarse en UNA pasada; si la arreglaste, entra(n) a la primera. Corre node ace authz:scopes:relay.',
+        });
+        return { lines, clean: true };
+    }
+    // --apply: qué fue de cada reencolada en la pasada que corrió bajo el mismo lease.
+    const relay = report.relay;
+    let clean = true;
+    for (const entry of relay.entries) {
+        if (entry.status === 'applied')
+            lines.push({ level: 'log', message: `aplicada: ${linea(entry)}` });
+        else if (entry.status === 'deferred') {
+            clean = false;
+            lines.push({ level: 'warning', message: `aplazada (${entry.reason ?? 'depende de una entrada anterior'}): ${linea(entry)} — no se ha aplicado` });
+        }
+        else if (entry.status === 'failed') {
+            clean = false;
+            lines.push({ level: 'error', message: `falló: ${linea(entry)} — ${entry.reason ?? ''}` });
+        }
+        else if (entry.status === 'dead') {
+            clean = false;
+            lines.push({ level: 'error', message: `sigue APARCADA: ${linea(entry)}${entry.reason ? ` — ${entry.reason}` : ''}` });
+        }
+    }
+    if (relay.applied.length !== report.requeued.length)
+        clean = false;
+    if (relay.remaining) {
+        lines.push({
+            level: 'warning',
+            message: 'Quedan entradas pendientes en la cola (--apply releva SOLO lo reencolado; lo que dependía de ello sigue aplazado): ' +
+                'corre node ace authz:scopes:relay, o releva su recibo con --only.',
+        });
+    }
+    lines.push({
+        level: clean ? 'success' : 'warning',
+        message: clean
+            ? `${relay.applied.length} entrada(s) reencolada(s) y aplicada(s) en la misma pasada.`
+            : `${relay.applied.length} de ${report.requeued.length} reencolada(s) aplicada(s): mira las líneas de arriba (la causa sigue rota, o el backend no respondió).`,
+    });
+    return { lines, clean };
+}
+/**
+ * **Devuelve entradas APARCADAS de la outbox a la cola** (2.4.0-alpha.5 · R2b;
+ * panel relay, cuestión 2).
+ *
+ *   node ace authz:scopes:requeue --id=12            # una
+ *   node ace authz:scopes:requeue --id=12,13         # varias (o --id repetido)
+ *   node ace authz:scopes:requeue --id=12 --force    # aunque revierta lo aplicado después (diff impreso)
+ *   node ace authz:scopes:requeue --id=12 --apply    # y la aplica en la MISMA llamada (2.4.0-alpha.8)
+ *   node ace authz:scopes:requeue --id=12 --apply --wait-lease-ms=5000   # esperando el lease si el cron lo tiene
+ *
+ * Una entrada aparcada (`sqlScopeOutbox({ maxAttempts })`, 5 por defecto)
+ * no se reintenta sola: el relay la reporta en cada pasada y sale ≠ 0. Cuando
+ * el operador arregla la causa —el padre que faltaba vuelve, el store se
+ * reconcilia— este comando la devuelve a `pending()` con **`attempts =
+ * maxAttempts − 1`**: entra a la primera si está arreglada y vuelve a
+ * aparcarse en UNA sola pasada si no (así un requeue automatizado de lo
+ * irreparable no es un grifo de aplazamiento para el resto del scope).
+ *
+ * **La sonda anti-reversión es del manager y no tiene excepción**: si después
+ * de la aparcada se APLICÓ otra entrada sobre la misma clave de scope,
+ * reencolarla reaplicaría el cambio viejo por encima del nuevo —un `moved`
+ * viejo tras el nuevo deja el store con el padre VIEJO y un solo padre—. El
+ * comando imprime ese diff y sale ≠ 0. **`--force` existe SOLO aquí**
+ * (decisión del dueño del 2026-09-09 (2)): imprime el diff y entra igual. Nunca
+ * en una ruta alcanzable por HTTP.
+ *
+ * **`--apply` (2.4.0-alpha.8)**: reencola Y releva SOLO esas entradas en la
+ * misma llamada, bajo UN lease (medido: sin esto la reencolada volvía con su
+ * id original y la siguiente pasada `only` del tenant salía `depends-on`; el
+ * incidente no se cerraba con un comando). Explícito, jamás por defecto: el
+ * comando pasa a ESCRIBIR en el backend. No compone con `--force` (500). Pasa
+ * la barrera del freeze. Con el lease tomado por otra pasada NO reencola nada
+ * y sale ≠ 0 (`--wait-lease-ms` espera, acotado).
+ *
+ * Es una operación de PLATAFORMA (como `authz:scopes:relay`): sin actor, sin
+ * `within`, y no se expone por HTTP.
+ */
+export default class AuthzScopesRequeue extends BaseCommand {
+    static commandName = 'authz:scopes:requeue';
+    static description = 'Return parked scope-tree outbox entries to the queue (refuses to revert later applied changes unless --force)';
+    static options = {
+        startApp: true,
+    };
+    /** `--id=12,13` o `--id=12 --id=13`: ids numéricos como número, el resto como cadena. */
+    static parseIds(values) {
+        if (values === undefined)
+            return undefined;
+        return values
+            .flatMap((value) => String(value).split(','))
+            .map((value) => value.trim())
+            .filter((value) => value.length > 0)
+            .map((value) => (/^\d+$/.test(value) ? Number(value) : value));
+    }
+    async run() {
+        const ids = AuthzScopesRequeue.parseIds(this.id);
+        if (ids === undefined || ids.length === 0) {
+            this.logger.error('Falta --id: di QUÉ entradas aparcadas reencolar (las que reporta authz:scopes:relay). Sin ids no se reencola nada.');
+            this.exitCode = 1;
+            return;
+        }
+        const { default: authorization } = await import('../services/main.js');
+        let result;
+        try {
+            const report = await authorization.requeueScopeChanges(ids, {
+                force: this.force === true,
+                apply: this.apply === true,
+                ...(this.waitLeaseMs === undefined ? {} : { waitForLeaseMs: this.waitLeaseMs }),
+            });
+            result = requeueLines({ report });
+        }
+        catch (error) {
+            if (error?.code !== 'E_AUTHZ_REQUEUE_REFUSED')
+                throw error;
+            result = requeueLines({ refused: error.conflicts });
+        }
+        for (const line of result.lines)
+            this.logger[line.level](line.message);
+        if (!result.clean)
+            this.exitCode = 1;
+    }
+}
+__decorate([
+    flags.array({
+        description: 'Outbox ids to requeue (the parked entries the relay reports), comma-separated or repeated',
+    }),
+    __metadata("design:type", Object)
+], AuthzScopesRequeue.prototype, "id", void 0);
+__decorate([
+    flags.boolean({
+        description: 'Requeue even if a later APPLIED entry shares a scope key (the diff is printed; the store WILL be reverted)',
+    }),
+    __metadata("design:type", Object)
+], AuthzScopesRequeue.prototype, "force", void 0);
+__decorate([
+    flags.boolean({
+        description: 'Also relay ONLY the requeued entries in the same call, under one lease (writes to the backend; not with --force)',
+    }),
+    __metadata("design:type", Object)
+], AuthzScopesRequeue.prototype, "apply", void 0);
+__decorate([
+    flags.number({
+        description: 'With --apply: wait up to this many ms for the relay lease instead of failing at once (pool >= 2)',
+    }),
+    __metadata("design:type", Object)
+], AuthzScopesRequeue.prototype, "waitLeaseMs", void 0);
+//# sourceMappingURL=authz_scopes_requeue.js.map

package/build/commands/authz_scopes_requeue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authz_scopes_requeue.js","sourceRoot":"","sources":["../../commands/authz_scopes_requeue.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAIvD,sFAAsF;AACtF,SAAS,KAAK,CAAC,IAA4B;IACzC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACvB,MAAM,KAAK,GAAG,CAAC,CAAyC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAA;IACxF,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAA;IAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;IACrE,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1D,OAAO,IAAI,IAAI,CAAC,EAAE,IAAI,MAAM,CAAC,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,EAAE,CAAA;AACvF,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwE;IAInG,MAAM,KAAK,GAA+E,EAAE,CAAA;IAC5F,MAAM,IAAI,GAAG,CAAC,KAA0B,EAAE,QAA8B,EAAE,EAAE;QAC1E,KAAK,CAAC,IAAI,CAAC;YACT,KAAK;YACL,OAAO,EACL,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,uBAAuB;gBAC7F,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,4FAA4F;gBACtH,yFAAyF;SAC5F,CAAC,CAAA;QACF,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;QAC1G,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC;gBACT,KAAK;gBACL,OAAO,EAAE,4CAA4C,QAAQ,CAAC,OAAO,CAAC,MAAM,+DAA+D;aAC5I,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,CAAA;IAED,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAChC,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;QAC7D,KAAK,CAAC,IAAI,CAAC;YACT,KAAK,EAAE,SAAS;YAChB,OAAO,EACL,wFAAwF;gBACxF,2GAA2G;gBAC3G,wCAAwC;SAC3C,CAAC,CAAA;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;IAChC,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAO,CAAA;IAC5B,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC;YACT,KAAK,EAAE,OAAO;YACd,OAAO,EACL,qHAAqH;gBACrH,uHAAuH;gBACvH,oFAAoF;SACvF,CAAC,CAAA;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;IAChC,CAAC;IACD,IAAI,MAAM,CAAC,MAAM;QAAE,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS;YAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IACrF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;IACvG,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC;YACT,KAAK,EAAE,SAAS;YAChB,OAAO,EACL,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,2FAA2F;gBACpH,kHAAkH;SACrH,CAAC,CAAA;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IAC/B,CAAC;IACD,mFAAmF;IACnF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAC1B,IAAI,KAAK,GAAG,IAAI,CAAA;IAChB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;aAC7F,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACrC,KAAK,GAAG,KAAK,CAAA;YACb,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,KAAK,CAAC,MAAM,IAAI,iCAAiC,MAAM,KAAK,CAAC,KAAK,CAAC,sBAAsB,EAAE,CAAC,CAAA;QACnJ,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACrC,KAAK,GAAG,KAAK,CAAA;YACb,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;QAC3F,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACnC,KAAK,GAAG,KAAK,CAAA;YACb,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QACvH,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM;QAAE,KAAK,GAAG,KAAK,CAAA;IAClE,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC;YACT,KAAK,EAAE,SAAS;YAChB,OAAO,EACL,qHAAqH;gBACrH,mEAAmE;SACtE,CAAC,CAAA;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CAAC;QACT,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QACpC,OAAO,EAAE,KAAK;YACZ,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,6DAA6D;YACtF,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,yGAAyG;KAClK,CAAC,CAAA;IACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,WAAW;IACzD,MAAM,CAAC,WAAW,GAAG,sBAAsB,CAAA;IAC3C,MAAM,CAAC,WAAW,GAAG,+GAA+G,CAAA;IAEpI,MAAM,CAAC,OAAO,GAAmB;QAC/B,QAAQ,EAAE,IAAI;KACf,CAAA;IAsBD,yFAAyF;IACzF,MAAM,CAAC,QAAQ,CAAC,MAA4B;QAC1C,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QAC1C,OAAO,MAAM;aACV,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;aAC5C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;aAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;aACnC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;IAClE,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,GAAG,GAAG,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAChD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oHAAoH,CAAC,CAAA;YACvI,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAA;YACjB,OAAM;QACR,CAAC;QACD,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAA;QACtE,IAAI,MAAuC,CAAA;QAC3C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,mBAAmB,CAAC,GAAG,EAAE;gBAC1D,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI;gBAC1B,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI;gBAC1B,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;aAChF,CAAC,CAAA;YACF,MAAM,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACnC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,KAAK,EAAE,IAAI,KAAK,yBAAyB;gBAAE,MAAM,KAAK,CAAA;YAC1D,MAAM,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAA;QACrD,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK;YAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACtE,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAA;IACtC,CAAC;;AAjDO;IAHP,KAAK,CAAC,KAAK,CAAC;QACX,WAAW,EAAE,2FAA2F;KACzG,CAAC;;8CAC8B;AAKxB;IAHP,KAAK,CAAC,OAAO,CAAC;QACb,WAAW,EAAE,4GAA4G;KAC1H,CAAC;;iDACgC;AAK1B;IAHP,KAAK,CAAC,OAAO,CAAC;QACb,WAAW,EAAE,kHAAkH;KAChI,CAAC;;iDACgC;AAK1B;IAHP,KAAK,CAAC,MAAM,CAAC;QACZ,WAAW,EAAE,kGAAkG;KAChH,CAAC;;uDACqC"}

package/build/commands/authz_unfreeze.d.ts

@@ -0,0 +1,45 @@
+import { BaseCommand } from '@adonisjs/core/ace';
+import { CommandOptions } from '@adonisjs/core/types/ace';
+import type { FreezeStatus } from '../src/manager.js';
+/**
+ * Qué hacer con el freeze vivo, en una función PURA (mismo patrón que
+ * `reconcileLines`): es la única decisión del comando y así tiene su caso
+ * sin montar un ace.
+ *
+ * Reglas:
+ *  - Sin freeze (nunca hubo, o ya levantado: motivo `null`) ⇒ no-op en verde
+ *    (idempotente: descongelar lo descongelado no es un incidente).
+ *  - Ventana CADUCADA (2.4.0-alpha.10: motivo puesto y `untilMs` en el pasado,
+ *    `lastFreezeStatus().expired`) ⇒ `expired`: ERROR con cuándo venció, exit
+ *    ≠ 0, y el comando limpia la fila para que el segundo `unfreeze` sea
+ *    no-op. No es «nada que levantar»: es un intervalo en el que la flota
+ *    escribió — en un cutover, escrituras que el motor nuevo no vio.
+ *  - Freeze de OPERADOR ⇒ se levanta (este comando es su otra mitad).
+ *  - Freeze de OTRO dueño (`reconcile`, `platform`) ⇒ NO se levanta sin
+ *    `--fence`: levantar la barrera de una pasada viva es exactamente el
+ *    A1.3 que el token cierra. `--fence=<n>` es la decisión humana explícita
+ *    («ese proceso murió sin lease»), y tiene que coincidir con el fence
+ *    vivo — un fence viejo no levanta la ventana de otro.
+ */
+export declare function unfreezePlan(status: (FreezeStatus & {
+    expired?: boolean;
+    checkedAtMs?: number;
+}) | null, fence: number | undefined, nowMs?: number): {
+    action: 'noop' | 'lift' | 'refuse' | 'expired';
+    message: string;
+};
+/**
+ * **Cierra la ventana de cutover** (3b-7): levanta el freeze de operador que
+ * abrió `authz:freeze`. La otra mitad de ese comando; ver su docblock.
+ *
+ *   node ace authz:unfreeze              # levanta la ventana del operador
+ *   node ace authz:unfreeze --fence=7    # decisión humana: levanta ESE freeze aunque no sea de operador
+ */
+export default class AuthzUnfreeze extends BaseCommand {
+    static commandName: string;
+    static description: string;
+    static options: CommandOptions;
+    fence: number | undefined;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=authz_unfreeze.d.ts.map

package/build/commands/authz_unfreeze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authz_unfreeze.d.ts","sourceRoot":"","sources":["../../commands/authz_unfreeze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,CAAC,YAAY,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,EAC3E,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,CAAC,EAAE,MAAM,GACb;IAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA2CrE;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,MAAM,CAAC,WAAW,SAAmB;IACrC,MAAM,CAAC,WAAW,SAAqF;IAEvG,MAAM,CAAC,OAAO,EAAE,cAAc,CAE7B;IAKO,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAE3B,GAAG;CAwEV"}

package/build/commands/authz_unfreeze.js

@@ -0,0 +1,157 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { BaseCommand, flags } from '@adonisjs/core/ace';
+/**
+ * Qué hacer con el freeze vivo, en una función PURA (mismo patrón que
+ * `reconcileLines`): es la única decisión del comando y así tiene su caso
+ * sin montar un ace.
+ *
+ * Reglas:
+ *  - Sin freeze (nunca hubo, o ya levantado: motivo `null`) ⇒ no-op en verde
+ *    (idempotente: descongelar lo descongelado no es un incidente).
+ *  - Ventana CADUCADA (2.4.0-alpha.10: motivo puesto y `untilMs` en el pasado,
+ *    `lastFreezeStatus().expired`) ⇒ `expired`: ERROR con cuándo venció, exit
+ *    ≠ 0, y el comando limpia la fila para que el segundo `unfreeze` sea
+ *    no-op. No es «nada que levantar»: es un intervalo en el que la flota
+ *    escribió — en un cutover, escrituras que el motor nuevo no vio.
+ *  - Freeze de OPERADOR ⇒ se levanta (este comando es su otra mitad).
+ *  - Freeze de OTRO dueño (`reconcile`, `platform`) ⇒ NO se levanta sin
+ *    `--fence`: levantar la barrera de una pasada viva es exactamente el
+ *    A1.3 que el token cierra. `--fence=<n>` es la decisión humana explícita
+ *    («ese proceso murió sin lease»), y tiene que coincidir con el fence
+ *    vivo — un fence viejo no levanta la ventana de otro.
+ */
+export function unfreezePlan(status, fence, nowMs) {
+    if (status === null) {
+        return { action: 'noop', message: 'No hay ningún freeze vivo: nada que levantar.' };
+    }
+    // **La ventana CADUCADA** (2.4.0-alpha.10): va antes que `--fence` porque el
+    // incidente es el mismo lo pida quien lo pida — no queda barrera que
+    // levantar, queda un intervalo en el que la flota ESCRIBIÓ.
+    if (status.expired === true) {
+        const when = status.untilMs === null ? '?' : new Date(status.untilMs).toISOString();
+        const at = nowMs ?? status.checkedAtMs;
+        const since = status.untilMs !== null && at !== undefined ? ` (hace ${Math.max(0, at - status.untilMs)} ms)` : '';
+        return {
+            action: 'expired',
+            message: `La ventana de ${status.holder} (${status.reason}, fence ${status.fence}) CADUCÓ el ${when}${since} y nadie ` +
+                `la cerró: desde entonces las escrituras volvieron a entrar en toda la flota. En un cutover eso son ` +
+                `escrituras que el motor nuevo no vio si la migración ya había corrido: no des el cutover por cerrado — ` +
+                `repite la migración (authz:reconcile) dentro de una ventana sin caducidad (authz:freeze sin --lease-ms) ` +
+                `antes de cambiar de driver.`,
+        };
+    }
+    if (fence !== undefined && fence !== status.fence) {
+        return {
+            action: 'refuse',
+            message: `El fence vivo es ${status.fence} y pediste levantar el ${fence}: ese freeze ya no existe. ` +
+                `Mira el estado y repite con el fence actual si de verdad quieres levantarlo.`,
+        };
+    }
+    if (status.kind !== 'operator' && fence === undefined) {
+        return {
+            action: 'refuse',
+            message: `El freeze vivo NO es de operador: lo sostiene ${status.holder} (${status.reason}). ` +
+                `Levantárselo dejaría su pasada corriendo sin barrera (y su reporte lo delatará como lapsed). ` +
+                `Espera a que termine${status.untilMs === null ? '' : ' — o a que su lease venza solo'}; si su proceso ` +
+                `murió sin lease, la decisión humana es --fence=${status.fence}.`,
+        };
+    }
+    return {
+        action: 'lift',
+        message: `Freeze de ${status.holder} (${status.reason}, fence ${status.fence}) levantado: la flota vuelve a escribir.`,
+    };
+}
+/**
+ * **Cierra la ventana de cutover** (3b-7): levanta el freeze de operador que
+ * abrió `authz:freeze`. La otra mitad de ese comando; ver su docblock.
+ *
+ *   node ace authz:unfreeze              # levanta la ventana del operador
+ *   node ace authz:unfreeze --fence=7    # decisión humana: levanta ESE freeze aunque no sea de operador
+ */
+export default class AuthzUnfreeze extends BaseCommand {
+    static commandName = 'authz:unfreeze';
+    static description = 'Close the cutover window: lift the operator freeze and let the fleet write again';
+    static options = {
+        startApp: true,
+    };
+    async run() {
+        const { default: authorization } = await import('../services/main.js');
+        // `lastFreezeStatus()` y no `freezeStatus()` (2.4.0-alpha.10): este es el
+        // único lector que tiene que ver también la ventana CADUCADA.
+        const status = await authorization.lastFreezeStatus();
+        const plan = unfreezePlan(status, this.fence);
+        if (plan.action === 'noop') {
+            this.logger.success(plan.message);
+            return;
+        }
+        if (plan.action === 'refuse') {
+            this.logger.error(plan.message);
+            this.exitCode = 1;
+            return;
+        }
+        // Levantar (o limpiar la caducada) es CONDICIONAL por token: si otro proceso
+        // cambió la fila entre la lectura y el UPDATE no se toca nada. Cierre del
+        // auditor de alpha.10 (⚪ 4): la letra la decide el RESULTADO, releyendo la
+        // fila — hasta el cierre la rama caducada afirmaba «la fila queda limpia»
+        // sin mirar el booleano, y la de levantar decía «o venció su lease» en verde
+        // (vencer no hace fallar el UPDATE: `releaseFreeze` no mira `untilMs`).
+        const done = await authorization.unfreeze({ fence: status.fence, holder: status.holder });
+        const after = done ? null : await authorization.lastFreezeStatus();
+        const ahora = (s) => `${s.holder} (${s.reason}, fence ${s.fence}, ${s.expired ? 'CADUCADA' : 'viva'})`;
+        // Cierre-2 · C4: si el UPDATE no casó pero la fila releída es LA MISMA (holder,
+        // fence y motivo), nadie la cambió: la letra no puede afirmar «otro proceso».
+        const unchanged = after !== null && after.fence === status.fence && after.holder === status.holder && after.reason === status.reason;
+        if (plan.action === 'expired') {
+            this.logger.error(plan.message);
+            if (done) {
+                this.logger.info('La fila queda limpia: un segundo authz:unfreeze ya no repite este error.');
+            }
+            else if (after === null) {
+                this.logger.warning('La fila ya la había limpiado otro proceso entre la lectura y la limpieza: no se ha tocado nada.');
+            }
+            else if (unchanged) {
+                this.logger.error(`La fila NO se ha limpiado y la fila NO cambió: sigue siendo ${ahora(after)}, pero el UPDATE condicional por ` +
+                    'su token no casó (rama «token no casa»). Es un defecto del paquete, no una carrera: repórtalo con esta línea.');
+            }
+            else {
+                this.logger.error(`La fila NO se ha limpiado: entre la lectura y la limpieza otro proceso la cambió y ahora es ${ahora(after)}. ` +
+                    'Vuelve a ejecutar authz:unfreeze para ver su estado.');
+            }
+            this.exitCode = 1;
+            return;
+        }
+        if (done) {
+            this.logger.success(plan.message);
+            return;
+        }
+        if (after === null) {
+            // Nadie lo sostiene ya: otro lo levantó entre medias. El objetivo del operador se cumple.
+            this.logger.success('El freeze ya no estaba: otro proceso lo levantó entre la lectura y el levantamiento. Nada que hacer.');
+            return;
+        }
+        if (unchanged) {
+            this.logger.error(`No se ha levantado nada y la fila NO cambió: sigue siendo ${ahora(after)}, pero el UPDATE condicional por su ` +
+                'token no casó (rama «token no casa»). Es un defecto del paquete, no una carrera: repórtalo con esta línea.');
+            this.exitCode = 1;
+            return;
+        }
+        this.logger.error(`No se ha levantado nada: entre la lectura y el levantamiento la fila cambió y ahora es ${ahora(after)}. ` +
+            'Vuelve a ejecutar authz:unfreeze para decidir sobre ese freeze.');
+        this.exitCode = 1;
+    }
+}
+__decorate([
+    flags.number({
+        description: 'Lift exactly this freeze even if it is not an operator window (its owner died without a lease)',
+    }),
+    __metadata("design:type", Object)
+], AuthzUnfreeze.prototype, "fence", void 0);
+//# sourceMappingURL=authz_unfreeze.js.map

package/build/commands/authz_unfreeze.js.map

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

package/build/commands/main.d.ts

@@ -1,9 +1,17 @@
-/**
- * Comandos ace del paquete. Se registran con:
- *   node ace configure @jantstack/adonis-authz
- */
-export { default as OpenFgaProvision } from './openfga_provision.js';
-export { default as OpenFgaImport } from './openfga_import.js';
-export { default as AuthzCatalogDiff } from './authz_catalog_diff.js';
-export { default as AuthzCatalogSync } from './authz_catalog_sync.js';
+import type { CommandMetaData } from '@adonisjs/core/types/ace';
+import OpenFgaProvision from './openfga_provision.js';
+import AuthzCatalogDiff from './authz_catalog_diff.js';
+import AuthzCatalogSync from './authz_catalog_sync.js';
+import AuthzCatalogPruneOrphans from './authz_catalog_prune_orphans.js';
+import AuthzScopesRelay from './authz_scopes_relay.js';
+import AuthzScopesRequeue from './authz_scopes_requeue.js';
+import AuthzReconcile from './authz_reconcile.js';
+import AuthzRelationsReconcile from './authz_relations_reconcile.js';
+import AuthzFreeze from './authz_freeze.js';
+import AuthzUnfreeze from './authz_unfreeze.js';
+export { OpenFgaProvision, AuthzCatalogDiff, AuthzCatalogSync, AuthzCatalogPruneOrphans, AuthzScopesRelay, AuthzScopesRequeue, AuthzReconcile, AuthzRelationsReconcile, AuthzFreeze, AuthzUnfreeze, };
+/** Contrato de loader de ace (`LoadersContract.getMetaData`). */
+export declare function getMetaData(): Promise<CommandMetaData[]>;
+/** Contrato de loader de ace (`LoadersContract.getCommand`): la clase, o `null` si el nombre no es nuestro. */
+export declare function getCommand(metaData: CommandMetaData): Promise<any>;
 //# sourceMappingURL=main.d.ts.map

package/build/commands/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACpE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,gBAAgB,MAAM,wBAAwB,CAAA;AACrD,OAAO,gBAAgB,MAAM,yBAAyB,CAAA;AACtD,OAAO,gBAAgB,MAAM,yBAAyB,CAAA;AACtD,OAAO,wBAAwB,MAAM,kCAAkC,CAAA;AACvE,OAAO,gBAAgB,MAAM,yBAAyB,CAAA;AACtD,OAAO,kBAAkB,MAAM,2BAA2B,CAAA;AAC1D,OAAO,cAAc,MAAM,sBAAsB,CAAA;AACjD,OAAO,uBAAuB,MAAM,gCAAgC,CAAA;AACpE,OAAO,WAAW,MAAM,mBAAmB,CAAA;AAC3C,OAAO,aAAa,MAAM,qBAAqB,CAAA;AAE/C,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,WAAW,EACX,aAAa,GACd,CAAA;AAgBD,iEAAiE;AACjE,wBAAgB,WAAW,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAExD;AAED,+GAA+G;AAC/G,wBAAgB,UAAU,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,CAElE"}

package/build/commands/main.js

@@ -1,9 +1,62 @@
 /**
- * Comandos ace del paquete. Se registran con:
- *   node ace configure @jantstack/adonis-authz
+ * **El loader de ace de los comandos del paquete** (2.4.0-alpha.4). Se
+ * registra con `node ace configure @jantstack/adonis-authz`, que escribe en el
+ * `adonisrc.ts` del consumidor:
+ *
+ *   commands: [() => import('@jantstack/adonis-authz/commands')]
+ *
+ * y ace trata **el módulo importado como el loader**: `Kernel.boot()` llama
+ * `getMetaData()` y `getCommand(meta)` sobre el namespace del módulo, sin
+ * desenvolver `default` (mismo contrato que `@adonisjs/core/commands` y
+ * `@adonisjs/lucid/commands`, que leen un `commands.json` generado por el
+ * assembler; aquí no hay assembler, así que el loader es un `ListLoader`
+ * sobre las diez clases (nueve hasta alpha.4) y no hay índice que generar).
+ *
+ * Hasta alpha.3 este fichero re-exportaba las nueve clases y NADA más, de
+ * modo que en un consumidor configurado con `node ace configure` **`node ace`
+ * entero reventaba** al arrancar (`TypeError: loaderInstance.getMetaData is
+ * not a function`), no solo `openfga:provision`. Ningún caso lo vio porque
+ * ninguno registraba el barrel como lo registra `createAceKernel`
+ * (`tests/commands.spec.ts` · C-1 lo hace desde alpha.4).
+ *
+ * Las re-exportaciones con nombre se MANTIENEN (quien importe una clase
+ * suelta sigue funcionando). Lo que NO vale desde alpha.4 es envolver el
+ * módulo en un `ListLoader(Object.values(m))`: `Object.values` incluye ahora
+ * las dos funciones y `ListLoader.getMetaData()` llama `serialize()` sobre
+ * cada valor. Se registra el módulo directamente, como escribe `configure`.
+ * Y NO se exporta `default`: ace no lo cargaría.
  */
-export { default as OpenFgaProvision } from './openfga_provision.js';
-export { default as OpenFgaImport } from './openfga_import.js';
-export { default as AuthzCatalogDiff } from './authz_catalog_diff.js';
-export { default as AuthzCatalogSync } from './authz_catalog_sync.js';
+import { ListLoader } from '@adonisjs/core/ace';
+import OpenFgaProvision from './openfga_provision.js';
+import AuthzCatalogDiff from './authz_catalog_diff.js';
+import AuthzCatalogSync from './authz_catalog_sync.js';
+import AuthzCatalogPruneOrphans from './authz_catalog_prune_orphans.js';
+import AuthzScopesRelay from './authz_scopes_relay.js';
+import AuthzScopesRequeue from './authz_scopes_requeue.js';
+import AuthzReconcile from './authz_reconcile.js';
+import AuthzRelationsReconcile from './authz_relations_reconcile.js';
+import AuthzFreeze from './authz_freeze.js';
+import AuthzUnfreeze from './authz_unfreeze.js';
+export { OpenFgaProvision, AuthzCatalogDiff, AuthzCatalogSync, AuthzCatalogPruneOrphans, AuthzScopesRelay, AuthzScopesRequeue, AuthzReconcile, AuthzRelationsReconcile, AuthzFreeze, AuthzUnfreeze, };
+/** Los diez (nueve hasta alpha.4; `authz:scopes:requeue` desde alpha.5), en el orden en que `node ace list` los enseña. */
+const loader = new ListLoader([
+    OpenFgaProvision,
+    AuthzCatalogDiff,
+    AuthzCatalogSync,
+    AuthzCatalogPruneOrphans,
+    AuthzScopesRelay,
+    AuthzScopesRequeue,
+    AuthzReconcile,
+    AuthzRelationsReconcile,
+    AuthzFreeze,
+    AuthzUnfreeze,
+]);
+/** Contrato de loader de ace (`LoadersContract.getMetaData`). */
+export function getMetaData() {
+    return loader.getMetaData();
+}
+/** Contrato de loader de ace (`LoadersContract.getCommand`): la clase, o `null` si el nombre no es nuestro. */
+export function getCommand(metaData) {
+    return loader.getCommand(metaData);
+}
 //# sourceMappingURL=main.js.map

package/build/commands/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACpE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE/C,OAAO,gBAAgB,MAAM,wBAAwB,CAAA;AACrD,OAAO,gBAAgB,MAAM,yBAAyB,CAAA;AACtD,OAAO,gBAAgB,MAAM,yBAAyB,CAAA;AACtD,OAAO,wBAAwB,MAAM,kCAAkC,CAAA;AACvE,OAAO,gBAAgB,MAAM,yBAAyB,CAAA;AACtD,OAAO,kBAAkB,MAAM,2BAA2B,CAAA;AAC1D,OAAO,cAAc,MAAM,sBAAsB,CAAA;AACjD,OAAO,uBAAuB,MAAM,gCAAgC,CAAA;AACpE,OAAO,WAAW,MAAM,mBAAmB,CAAA;AAC3C,OAAO,aAAa,MAAM,qBAAqB,CAAA;AAE/C,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,WAAW,EACX,aAAa,GACd,CAAA;AAED,2HAA2H;AAC3H,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC;IAC5B,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,wBAAwB;IACxB,gBAAgB;IAChB,kBAAkB;IAClB,cAAc;IACd,uBAAuB;IACvB,WAAW;IACX,aAAa;CACP,CAAC,CAAA;AAET,iEAAiE;AACjE,MAAM,UAAU,WAAW;IACzB,OAAO,MAAM,CAAC,WAAW,EAAE,CAAA;AAC7B,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,UAAU,CAAC,QAAyB;IAClD,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;AACpC,CAAC"}