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

package/build/src/freeze.d.ts

@@ -0,0 +1,120 @@
+/**
+ * El **freeze DURABLE** (3b-7; decisión del dueño del 2026-08-31 (3b):
+ * B + E-analista). Primitivas SQL puras; la policy (quién congela, el
+ * anidado, el contexto del operador) vive en el manager.
+ *
+ * El freeze cuelga de la fila `id = 2` de `authz_catalog_version` — la señal
+ * entre procesos que el paquete ya usa (invariante 14). La colocación está
+ * MEDIDA (panel 3, analista §4.1): en la fila `id = 1` la renovación del
+ * lease espera al `FOR UPDATE` de `withAuthzCatalogWrite` (816 ms en PG /
+ * 805 en MySQL con un sync de 800 ms); en su propia fila, 10-12 ms. Y la
+ * consulta de la barrera es PROPIA y sin memo (juez C2): colgarse del memo
+ * del catálogo haría del freeze «una ventana acotada de freeze que todavía
+ * no aplica» con `catalogRevalidate: { everyMs }`. El coste que se publica
+ * es el medido: +0,14 ms p50 por escritura (PG; +0,11 MySQL), 0 por
+ * `authorize`.
+ *
+ * Las tres reglas del protocolo:
+ *  - **Token de dueño** (`fence` + `holder`): `acquire` sube el fence y solo
+ *    hay UN freeze vivo a la vez; `release`/`renew` son condicionales por
+ *    token, así que un `unfreeze` ajeno o rezagado es un no-op (auditor
+ *    A1.3: el `finally` de una ventana interior ya no puede levantar la
+ *    barrera de otra).
+ *  - **Lease**: `untilMs` en ms de PARED (el reloj del config, el mismo que
+ *    decide caducidades). Vencido ⇒ el freeze deja de estar vivo y la flota
+ *    vuelve a escribir SOLA — tras un `SIGKILL` nadie limpia nada (medido:
+ *    2 527 ms con lease de 3 000). `untilMs: null` = sin caducidad (la
+ *    ventana del operador).
+ *  - **Fence publicado**: la renovación exige `freeze_until_ms > now`; una
+ *    renovación que toca 0 filas significa que el lease se PERDIÓ a mitad
+ *    (pausa de GC, base caída más tiempo que el lease) y quien lo sostiene
+ *    lo marca `lapsed` — la pasada no se certifica (juez C4).
+ *
+ * La fila ausente (o las columnas: una base migrada con el stub < 2.3) es
+ * **503 «migración 2.0 no aplicada»** en toda escritura, jamás «no
+ * congelado»: el mismo patrón que la fila `id = 1` del memo. Un upsert
+ * perezoso desde la barrera sería una escritura en el camino de lectura,
+ * fuera de `withAuthzCatalogWrite`, y una carrera gratis.
+ */
+/** La fila del freeze durable (la `id = 1` es la versión del catálogo). */
+export declare const FREEZE_ROW_ID = 2;
+/** Lease por defecto (analista §2.3): 15 s renovados cada 5 s cubren cualquier pausa razonable y acotan la parada tras un `SIGKILL`. */
+export declare const DEFAULT_FREEZE_LEASE_MS = 15000;
+/** Quién congela: el dueño va escrito en la fila (`<kind>:<pid>:<hex>`). */
+export type FreezeKind = 'operator' | 'reconcile' | 'platform';
+/** El token del dueño: lo devuelve `freeze()` y es lo ÚNICO que levanta o renueva ese freeze. */
+export interface FreezeToken {
+    /** Número de generación: sube en cada `acquire`, nunca se reutiliza. */
+    fence: number;
+    /** `<kind>:<pid>:<hex>`: identifica al proceso que congeló. */
+    holder: string;
+}
+/** La fila del freeze, tal como está en la base. */
+export interface FreezeRow {
+    reason: string | null;
+    holder: string | null;
+    untilMs: number | null;
+    fence: number;
+}
+export interface FreezeSqlOptions {
+    /** Etiqueta del driver en los errores 503 (default `freeze`). */
+    driver?: string;
+    /** Deadline de cada consulta (default 5000): vencido ⇒ 503. */
+    timeoutMs?: number;
+    /**
+     * Cliente sobre el que leer (la TRANSACCIÓN del llamante, si la escritura
+     * llegó con una — `ScopeTreeWriteOptions.transaction`). Sin esto, la
+     * barrera necesitaría una SEGUNDA conexión del pool mientras el consumidor
+     * sostiene la suya, y con un pool de 1 (SQLite `:memory:`) eso es un
+     * interbloqueo, no una lectura. El precio, declarado: en un motor cuyo
+     * aislamiento por defecto congela la foto de las lecturas (InnoDB
+     * REPEATABLE READ), un freeze puesto DESPUÉS de abrir esa transacción
+     * puede no verse desde dentro — la misma ventana que una escritura que ya
+     * pasó su barrera (tester A4), y por eso la promesa publicada es «otro
+     * proceso recibe 503», no «ninguna escritura entra».
+     */
+    client?: {
+        from: (table: string) => any;
+    };
+}
+/** Lee la fila del freeze (503 clasificado si la base no responde; 503 «migración no aplicada» si no existe). */
+export declare function readFreezeRow(options?: FreezeSqlOptions): Promise<FreezeRow>;
+/** ¿Está VIVO este freeze en el instante `nowMs`? (motivo puesto y lease sin vencer; `untilMs: null` no vence). */
+export declare function freezeIsLive(row: FreezeRow, nowMs: number): boolean;
+/**
+ * Toma el freeze si NADIE lo sostiene vivo (condicional y atómico: dos
+ * `acquire` a la vez acaban en exactamente uno). Devuelve el token, o `null`
+ * si hay un freeze vivo de otro dueño (el llamante decide si eso es 423 o un
+ * contexto que reconoce).
+ */
+export declare function acquireFreeze(input: {
+    reason: string;
+    holder: string;
+    untilMs: number | null;
+    nowMs: number;
+}, options?: FreezeSqlOptions): Promise<FreezeToken | null>;
+/**
+ * Renueva el lease, CONDICIONAL por token y solo si aún no venció
+ * (`freeze_until_ms > now`). `false` = el lease se PERDIÓ (caducó a mitad, o
+ * otro dueño tomó el freeze): el llamante lo marca `lapsed` y deja de
+ * renovar — nunca «recupera» un freeze que ya no es suyo.
+ */
+export declare function renewFreeze(token: FreezeToken, input: {
+    untilMs: number;
+    nowMs: number;
+}, options?: FreezeSqlOptions): Promise<boolean>;
+/**
+ * Levanta el freeze de ESTE token (condicional: uno ajeno o rezagado no toca
+ * nada). Devuelve además `lapsed`: si en el instante de cerrar el lease ya
+ * estaba vencido o el token ya no era el de la fila, hubo una ventana en la
+ * que otros procesos pudieron escribir — es lo que el reporte publica.
+ */
+export declare function releaseFreeze(token: FreezeToken, input: {
+    nowMs: number;
+}, options?: FreezeSqlOptions): Promise<{
+    released: boolean;
+    lapsed: boolean;
+}>;
+/** El `kind` que el holder lleva escrito (`operator:123:ab…` → `operator`). */
+export declare function freezeKindOf(holder: string | null): FreezeKind | 'unknown';
+//# sourceMappingURL=freeze.d.ts.map

package/build/src/freeze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freeze.d.ts","sourceRoot":"","sources":["../../src/freeze.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,2EAA2E;AAC3E,eAAO,MAAM,aAAa,IAAI,CAAA;AAE9B,wIAAwI;AACxI,eAAO,MAAM,uBAAuB,QAAS,CAAA;AAI7C,4EAA4E;AAC5E,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAA;AAE9D,iGAAiG;AACjG,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAA;CACf;AAED,oDAAoD;AACpD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAAA;KAAE,CAAA;CAC1C;AAyBD,iHAAiH;AACjH,wBAAsB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CAmBtF;AAED,mHAAmH;AACnH,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAGnE;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAChF,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA8B7B;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACzC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EACxB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAejD;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU,GAAG,SAAS,CAG1E"}

package/build/src/freeze.js

@@ -0,0 +1,172 @@
+import db from '@adonisjs/lucid/services/db';
+import { guardSql } from './shared/backend_guard.js';
+import { AuthorizationBackendError } from './errors.js';
+import { CATALOG_VERSION_TABLE } from './catalog/catalog_cache.js';
+/**
+ * El **freeze DURABLE** (3b-7; decisión del dueño del 2026-08-31 (3b):
+ * B + E-analista). Primitivas SQL puras; la policy (quién congela, el
+ * anidado, el contexto del operador) vive en el manager.
+ *
+ * El freeze cuelga de la fila `id = 2` de `authz_catalog_version` — la señal
+ * entre procesos que el paquete ya usa (invariante 14). La colocación está
+ * MEDIDA (panel 3, analista §4.1): en la fila `id = 1` la renovación del
+ * lease espera al `FOR UPDATE` de `withAuthzCatalogWrite` (816 ms en PG /
+ * 805 en MySQL con un sync de 800 ms); en su propia fila, 10-12 ms. Y la
+ * consulta de la barrera es PROPIA y sin memo (juez C2): colgarse del memo
+ * del catálogo haría del freeze «una ventana acotada de freeze que todavía
+ * no aplica» con `catalogRevalidate: { everyMs }`. El coste que se publica
+ * es el medido: +0,14 ms p50 por escritura (PG; +0,11 MySQL), 0 por
+ * `authorize`.
+ *
+ * Las tres reglas del protocolo:
+ *  - **Token de dueño** (`fence` + `holder`): `acquire` sube el fence y solo
+ *    hay UN freeze vivo a la vez; `release`/`renew` son condicionales por
+ *    token, así que un `unfreeze` ajeno o rezagado es un no-op (auditor
+ *    A1.3: el `finally` de una ventana interior ya no puede levantar la
+ *    barrera de otra).
+ *  - **Lease**: `untilMs` en ms de PARED (el reloj del config, el mismo que
+ *    decide caducidades). Vencido ⇒ el freeze deja de estar vivo y la flota
+ *    vuelve a escribir SOLA — tras un `SIGKILL` nadie limpia nada (medido:
+ *    2 527 ms con lease de 3 000). `untilMs: null` = sin caducidad (la
+ *    ventana del operador).
+ *  - **Fence publicado**: la renovación exige `freeze_until_ms > now`; una
+ *    renovación que toca 0 filas significa que el lease se PERDIÓ a mitad
+ *    (pausa de GC, base caída más tiempo que el lease) y quien lo sostiene
+ *    lo marca `lapsed` — la pasada no se certifica (juez C4).
+ *
+ * La fila ausente (o las columnas: una base migrada con el stub < 2.3) es
+ * **503 «migración 2.0 no aplicada»** en toda escritura, jamás «no
+ * congelado»: el mismo patrón que la fila `id = 1` del memo. Un upsert
+ * perezoso desde la barrera sería una escritura en el camino de lectura,
+ * fuera de `withAuthzCatalogWrite`, y una carrera gratis.
+ */
+/** La fila del freeze durable (la `id = 1` es la versión del catálogo). */
+export const FREEZE_ROW_ID = 2;
+/** Lease por defecto (analista §2.3): 15 s renovados cada 5 s cubren cualquier pausa razonable y acotan la parada tras un `SIGKILL`. */
+export const DEFAULT_FREEZE_LEASE_MS = 15_000;
+const DEFAULT_FREEZE_TIMEOUT_MS = 5_000;
+function opts(options) {
+    return { driver: options.driver ?? 'freeze', timeoutMs: options.timeoutMs ?? DEFAULT_FREEZE_TIMEOUT_MS };
+}
+function missingRow(driver) {
+    const error = new AuthorizationBackendError(driver, 'freeze.row', new Error(`no hay fila id = ${FREEZE_ROW_ID} en ${CATALOG_VERSION_TABLE}`));
+    error.message =
+        `${driver}: no se puede leer el freeze compartido (${CATALOG_VERSION_TABLE}, id = ${FREEZE_ROW_ID}). ` +
+            `Probablemente la migración 2.0 no está aplicada (la siembra el stub publicado; la receta está en el CHANGELOG). ` +
+            `Sin la fila las escrituras NO proceden: tratarla como «no congelado» sería fail-open.`;
+    return error;
+}
+function toMs(raw) {
+    if (raw === null || raw === undefined)
+        return null;
+    const value = typeof raw === 'number' ? raw : Number(raw);
+    return Number.isFinite(value) ? value : null;
+}
+/** Lee la fila del freeze (503 clasificado si la base no responde; 503 «migración no aplicada» si no existe). */
+export async function readFreezeRow(options = {}) {
+    const { driver, timeoutMs } = opts(options);
+    const client = options.client ?? db;
+    const rows = await guardSql(driver, 'freeze.read', timeoutMs, () => client
+        .from(CATALOG_VERSION_TABLE)
+        .where('id', FREEZE_ROW_ID)
+        .select('freeze_reason', 'freeze_holder', 'freeze_until_ms', 'freeze_fence'));
+    if (rows.length === 0)
+        throw missingRow(driver);
+    const row = rows[0];
+    const fence = toMs(row.freeze_fence);
+    if (fence === null)
+        throw missingRow(driver);
+    return {
+        reason: row.freeze_reason === null || row.freeze_reason === undefined ? null : String(row.freeze_reason),
+        holder: row.freeze_holder === null || row.freeze_holder === undefined ? null : String(row.freeze_holder),
+        untilMs: toMs(row.freeze_until_ms),
+        fence,
+    };
+}
+/** ¿Está VIVO este freeze en el instante `nowMs`? (motivo puesto y lease sin vencer; `untilMs: null` no vence). */
+export function freezeIsLive(row, nowMs) {
+    if (row.reason === null)
+        return false;
+    return row.untilMs === null || row.untilMs > nowMs;
+}
+/**
+ * Toma el freeze si NADIE lo sostiene vivo (condicional y atómico: dos
+ * `acquire` a la vez acaban en exactamente uno). Devuelve el token, o `null`
+ * si hay un freeze vivo de otro dueño (el llamante decide si eso es 423 o un
+ * contexto que reconoce).
+ */
+export async function acquireFreeze(input, options = {}) {
+    const { driver, timeoutMs } = opts(options);
+    const updated = await guardSql(driver, 'freeze.acquire', timeoutMs, () => db
+        .from(CATALOG_VERSION_TABLE)
+        .where('id', FREEZE_ROW_ID)
+        .where((q) => {
+        // Libre, o con el lease VENCIDO (un dueño muerto no bloquea la toma).
+        q.whereNull('freeze_reason').orWhere((expired) => {
+            expired.whereNotNull('freeze_until_ms').andWhere('freeze_until_ms', '<=', input.nowMs);
+        });
+    })
+        .update({
+        freeze_reason: input.reason,
+        freeze_holder: input.holder,
+        freeze_until_ms: input.untilMs,
+        freeze_fence: db.raw('freeze_fence + 1'),
+        updated_at: new Date(input.nowMs),
+    }));
+    if (Number(updated) === 0) {
+        // O hay un freeze vivo, o la fila no existe: distinguirlo es leerla.
+        const row = await readFreezeRow(options);
+        if (freezeIsLive(row, input.nowMs))
+            return null;
+        // Carrera minúscula (se liberó entre el UPDATE y el SELECT): reintenta una vez.
+        return acquireFreeze(input, options);
+    }
+    const row = await readFreezeRow(options);
+    if (row.holder !== input.holder)
+        return null; // otro acquire ganó justo después (no debería: el nuestro dejó la fila viva)
+    return { fence: row.fence, holder: input.holder };
+}
+/**
+ * Renueva el lease, CONDICIONAL por token y solo si aún no venció
+ * (`freeze_until_ms > now`). `false` = el lease se PERDIÓ (caducó a mitad, o
+ * otro dueño tomó el freeze): el llamante lo marca `lapsed` y deja de
+ * renovar — nunca «recupera» un freeze que ya no es suyo.
+ */
+export async function renewFreeze(token, input, options = {}) {
+    const { driver, timeoutMs } = opts(options);
+    const updated = await guardSql(driver, 'freeze.renew', timeoutMs, () => db
+        .from(CATALOG_VERSION_TABLE)
+        .where('id', FREEZE_ROW_ID)
+        .where('freeze_fence', token.fence)
+        .where('freeze_holder', token.holder)
+        .where('freeze_until_ms', '>', input.nowMs)
+        .update({ freeze_until_ms: input.untilMs, updated_at: new Date(input.nowMs) }));
+    return Number(updated) > 0;
+}
+/**
+ * Levanta el freeze de ESTE token (condicional: uno ajeno o rezagado no toca
+ * nada). Devuelve además `lapsed`: si en el instante de cerrar el lease ya
+ * estaba vencido o el token ya no era el de la fila, hubo una ventana en la
+ * que otros procesos pudieron escribir — es lo que el reporte publica.
+ */
+export async function releaseFreeze(token, input, options = {}) {
+    const { driver, timeoutMs } = opts(options);
+    const row = await readFreezeRow(options);
+    const mine = row.fence === token.fence && row.holder === token.holder;
+    const lapsed = !mine || (row.untilMs !== null && row.untilMs <= input.nowMs);
+    if (!mine)
+        return { released: false, lapsed };
+    const updated = await guardSql(driver, 'freeze.release', timeoutMs, () => db
+        .from(CATALOG_VERSION_TABLE)
+        .where('id', FREEZE_ROW_ID)
+        .where('freeze_fence', token.fence)
+        .where('freeze_holder', token.holder)
+        .update({ freeze_reason: null, freeze_holder: null, freeze_until_ms: null, updated_at: new Date(input.nowMs) }));
+    return { released: Number(updated) > 0, lapsed };
+}
+/** El `kind` que el holder lleva escrito (`operator:123:ab…` → `operator`). */
+export function freezeKindOf(holder) {
+    const prefix = holder?.split(':', 1)[0];
+    return prefix === 'operator' || prefix === 'reconcile' || prefix === 'platform' ? prefix : 'unknown';
+}
+//# sourceMappingURL=freeze.js.map

package/build/src/freeze.js.map

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

package/build/src/http/app_access_middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app_access_middleware.d.ts","sourceRoot":"","sources":["../../../src/http/app_access_middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAMvD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,CAAC,OAAO,OAAO,mBAAmB;IAChC,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB;CAgDvE"}

package/build/src/http/app_access_middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app_access_middleware.js","sourceRoot":"","sources":["../../../src/http/app_access_middleware.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AACrD,OAAO,aAAa,MAAM,wBAAwB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAsB7E,MAAM,CAAC,OAAO,OAAO,mBAAmB;IACtC,KAAK,CAAC,MAAM,CAAC,GAAgB,EAAE,IAAY,EAAE,OAAyB;QACpE,yEAAyE;QACzE,wDAAwD;QACxD,IAAI,OAAO,IAAI,MAAM,IAAK,OAAkB,EAAE,CAAC;YAC7C,MAAM,IAAI,oBAAoB,CAAE,OAAe,CAAC,IAAI,CAAC,CAAA;QACvD,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;YACzB,MAAM,IAAI,wBAAwB,CAChC,iGAAiG,CAClG,CAAA;QACH,CAAC;QAED,MAAM,MAAM,GAAI,GAAW,CAAC,IAAI,EAAE,IAA6D,CAAA;QAC/F,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAA;QAC9F,CAAC;QAED,mEAAmE;QACnE,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAA;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,SAAS,CAAC,mEAAmE,EAAE;gBACvF,MAAM,EAAE,GAAG;aACZ,CAAC,CAAA;QACJ,CAAC;QAED,kEAAkE;QAClE,wEAAwE;QACxE,yEAAyE;QACzE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,SAAS,CACjB,cAAc,KAAK,mEAAmE;gBACpF,sCAAsC,EACxC,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAA;QACH,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAA;QAElD,IAAI,CAAC,CAAC,MAAM,aAAa,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;YAC7E,OAAO,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAC5B,OAAO,EAAE,sBAAsB;gBAC/B,UAAU,EAAE,GAAG;gBACf,MAAM,EAAE,EAAE;aACX,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,IAAI,EAAE,CAAA;IACf,CAAC;CACF"}

package/build/src/http/resource_access_middleware.d.ts

@@ -0,0 +1,105 @@
+import type { HttpContext } from '@adonisjs/core/http';
+import type { NextFn } from '@adonisjs/core/types/http';
+import type { ScopeRef } from '../types.js';
+/**
+ * Enforcement de acceso A UN RECURSO concreto. COMPONE el `authorize` que ya
+ * existe: el consumidor dice CÓMO cargar el recurso (`load(ctx, id)`) y en qué
+ * `{ scope }` vive, y el middleware pregunta al motor sobre ese scope. No es un
+ * modelo ni un driver nuevo: es el borde HTTP del scope de un recurso.
+ *
+ * El ORDEN de las respuestas ES la propiedad de seguridad — un 403 donde
+ * debería ir un 404 filtra qué recursos existen (enumeración):
+ *
+ *   1. 401  si no hay usuario autenticado (antes de nada).
+ *   2. 403  si el `gate(ctx)` del consumidor (una ability previa, p. ej.
+ *           «es admin del tenant») lo niega.
+ *   3. 404  si el CONTENEDOR no existe (`containerParam`, cuando se declara).
+ *   4. 404  si el RECURSO no existe (`load` ⇒ null) — MISMO cuerpo que el 404
+ *           del contenedor, para no distinguir «no existe» de «no es tuyo».
+ *   5. authorize sobre el `{ scope }` que devolvió `load`, con `permission`
+ *           (o `readPermission` en métodos seguros): un `false` aquí también
+ *           es 404 con el MISMO cuerpo, NO un 403 — que no puedas verlo no
+ *           revela que existe.
+ *
+ * Invariantes que NO se negocian:
+ *  - `AuthorizationBackendError` (503) NUNCA se disfraza de 404/403: si el
+ *    backend cae (`gate`/`load`/`authorize` lanzan), el error sube tal cual.
+ *    Es lo que distingue «denegado» de «no pude comprobar». El middleware NO
+ *    envuelve estas llamadas en try/catch a propósito.
+ *  - Prohibido `role`: como `appAccess`, solo acepta `permission`/
+ *    `readPermission`. `{ role }` es 500 con receta (membresía no es acceso, y
+ *    el deny no la gobierna: toda decisión pasa por `authorize`).
+ *  - Sin segundo `authorize`: se llama UNA sola vez. No re-autoriza.
+ *
+ * Limitación conocida — canal de TEMPORIZACIÓN (auditor Fase 5, ⚪): el status
+ * y el cuerpo de «no existe» y «existe pero no es tuyo» son idénticos, pero el
+ * TIEMPO no: un id inexistente responde 404 sin round-trip a `authorize`; uno
+ * ajeno responde el mismo 404 tras esa llamada. Es inherente a load→authorize
+ * (no se puede autorizar el scope de algo que no se ha cargado), no un defecto;
+ * quien necesite cerrar el canal iguala el tiempo en su capa (delay constante),
+ * no en el middleware.
+ *
+ * Pureza: el middleware NO importa aliases del consumidor; `load`/`gate` llegan
+ * INYECTADOS en las opciones de la ruta.
+ *
+ * Uso:
+ *   router
+ *     .get('/orgs/:orgId/documents/:id', [DocumentsController, 'show'])
+ *     .use(middleware.resourceAccess({
+ *       resource: 'document',
+ *       param: 'id',
+ *       containerParam: 'orgId',
+ *       permission: 'documents:write',
+ *       readPermission: 'documents:read',
+ *       load: (ctx, id) => Document.query().where('id', id).first(),
+ *       gate: (ctx) => ctx.auth.user!.isMemberOf(ctx.params.orgId),
+ *     }))
+ */
+export interface ResourceAccessOptions {
+    /**
+     * Nombre del recurso. Es la clave bajo la que el recurso cargado (con su
+     * scope) se PROPAGA al `ctx` para el controlador (`ctx[resource]`), así que
+     * dos `resourceAccess` anidados no se pisan.
+     */
+    resource: string;
+    /** Nombre del param de ruta que trae el id del recurso (`ctx.params[param]`). */
+    param: string;
+    /**
+     * Nombre del param de ruta del contenedor (p. ej. el tenant de una ruta
+     * anidada). Cuando se declara, un contenedor ausente en la ruta es 404 —el
+     * MISMO cuerpo que un recurso ausente— y se comprueba ANTES de cargar el
+     * recurso. La pertenencia real del recurso al contenedor la comprueba
+     * `load` (que ve `ctx.params`): devolver `null` allí es el mismo 404, así que
+     * «no existe» y «no está en este contenedor» son indistinguibles.
+     */
+    containerParam?: string;
+    /** Permiso requerido (métodos que mutan, y lectura si no hay `readPermission`). */
+    permission: string;
+    /**
+     * Permiso requerido en métodos SEGUROS (GET/HEAD). Si se omite, una lectura
+     * exige `permission` — nunca es gratis. Suele ser el permiso MENOS
+     * privilegiado (ver vs escribir).
+     */
+    readPermission?: string;
+    /**
+     * Carga el recurso por su id y devuelve dónde vive (`{ scope }`) o `null` si
+     * no existe / no es visible. Del consumidor: ve el `ctx` entero (params,
+     * usuario). Un throw es «no pude comprobar» (sube como 503), NO un 404.
+     */
+    load: (ctx: HttpContext, id: string) => Promise<{
+        scope: ScopeRef;
+    } | null> | {
+        scope: ScopeRef;
+    } | null;
+    /**
+     * Ability previa del consumidor (p. ej. «es admin del tenant»). Opcional; si
+     * se declara y devuelve `false`, es 403 —una restricción ADICIONAL, evaluada
+     * antes de tocar el recurso—. Si se omite, no hay pre-check: la seguridad la
+     * da igualmente `authorize`.
+     */
+    gate?: (ctx: HttpContext) => Promise<boolean> | boolean;
+}
+export default class ResourceAccessMiddleware {
+    handle(ctx: HttpContext, next: NextFn, options: ResourceAccessOptions): Promise<any>;
+}
+//# sourceMappingURL=resource_access_middleware.d.ts.map

package/build/src/http/resource_access_middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource_access_middleware.d.ts","sourceRoot":"","sources":["../../../src/http/resource_access_middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAGvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAG3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,IAAI,EAAE,CACJ,GAAG,EAAE,WAAW,EAChB,EAAE,EAAE,MAAM,KACP,OAAO,CAAC;QAAE,KAAK,EAAE,QAAQ,CAAA;KAAE,GAAG,IAAI,CAAC,GAAG;QAAE,KAAK,EAAE,QAAQ,CAAA;KAAE,GAAG,IAAI,CAAA;IACrE;;;;;OAKG;IACH,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;CACxD;AAKD,MAAM,CAAC,OAAO,OAAO,wBAAwB;IACrC,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB;CA6F5E"}

package/build/src/http/resource_access_middleware.js

@@ -0,0 +1,81 @@
+import { Exception } from '@adonisjs/core/exceptions';
+import authorization from '../../services/main.js';
+import { AuthorizationConfigError, RoleIsNotAccessError } from '../errors.js';
+/** Métodos HTTP seguros: usan `readPermission` si se declara. */
+const SAFE_METHODS = new Set(['GET', 'HEAD']);
+export default class ResourceAccessMiddleware {
+    async handle(ctx, next, options) {
+        // Config PRIMERO, antes de mirar si hay usuario: una ruta mal declarada
+        // tiene que saltar en el primer request de desarrollo, autenticado o no.
+        if (options && 'role' in options) {
+            throw new RoleIsNotAccessError(options.role);
+        }
+        if (!options?.permission) {
+            throw new AuthorizationConfigError("middleware.resourceAccess requiere `{ permission }` (p. ej. resourceAccess({ permission: 'documents:write', ... }))");
+        }
+        if (!options.param) {
+            throw new AuthorizationConfigError('middleware.resourceAccess requiere `{ param }` — el nombre del param de ruta con el id del recurso');
+        }
+        if (typeof options.load !== 'function') {
+            throw new AuthorizationConfigError('middleware.resourceAccess requiere `load(ctx, id)` — cómo cargar el recurso y en qué `{ scope }` vive');
+        }
+        if (!options.resource) {
+            throw new AuthorizationConfigError('middleware.resourceAccess requiere `{ resource }` — el nombre bajo el que se propaga el recurso al controlador');
+        }
+        // ── 1. 401 ────────────────────────────────────────────────────────────
+        const holder = ctx.auth?.user;
+        if (!holder) {
+            return ctx.response.unauthorized({ message: 'No autenticado', statusCode: 401, errors: [] });
+        }
+        // El holder tiene que ser un subject válido (mismos guards que appAccess).
+        // Son errores de programación (500), no de acceso: nunca degradan a 404.
+        const morph = holder.__morphMapName;
+        if (!morph) {
+            throw new Exception('El modelo autenticado no tiene @MorphMap — no es un holder válido', {
+                status: 500,
+            });
+        }
+        if (!holder.uuid) {
+            throw new Exception(`El holder '${morph}' no expone 'uuid' — el motor identifica a los holders por uuid, ` +
+                `no por la clave primaria del modelo.`, { status: 500 });
+        }
+        const subject = { type: morph, uuid: holder.uuid };
+        // ── 2. 403 gate del consumidor ────────────────────────────────────────
+        // Sin try/catch: si el gate lanza (backend caído), el 503 sube tal cual.
+        if (options.gate && !(await options.gate(ctx))) {
+            return ctx.response.forbidden({ message: 'Permiso insuficiente', statusCode: 403, errors: [] });
+        }
+        // El 404 del contenedor, del recurso ausente y del authorize negativo
+        // comparten EXACTAMENTE el mismo cuerpo: nada distingue los tres.
+        const notFound = () => ctx.response.notFound({ message: 'Recurso no encontrado', statusCode: 404, errors: [] });
+        // ── 3. 404 contenedor (ANTES que el recurso) ──────────────────────────
+        if (options.containerParam) {
+            const containerId = ctx.params?.[options.containerParam];
+            if (!containerId)
+                return notFound();
+        }
+        // ── 4. 404 recurso ────────────────────────────────────────────────────
+        const id = ctx.params?.[options.param];
+        if (!id)
+            return notFound();
+        // Un throw de `load` NO se atrapa: «no pude comprobar» (503) ≠ «no existe».
+        const loaded = await options.load(ctx, String(id));
+        if (!loaded)
+            return notFound();
+        // ── 5. authorize (UNA vez) sobre el scope del recurso ─────────────────
+        const method = String(ctx.request?.method?.() ?? 'GET').toUpperCase();
+        const permission = SAFE_METHODS.has(method) && options.readPermission
+            ? options.readPermission
+            : options.permission;
+        if (!(await authorization.authorize(subject, permission, loaded.scope))) {
+            // Negado ⇒ 404 con el MISMO cuerpo, NO 403: que no puedas verlo no
+            // revela que existe.
+            return notFound();
+        }
+        // El recurso cargado (con su scope) llega al controlador sin recargarlo.
+        ;
+        ctx[options.resource] = loaded;
+        return next();
+    }
+}
+//# sourceMappingURL=resource_access_middleware.js.map

package/build/src/http/resource_access_middleware.js.map

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

package/build/src/identity.d.ts

@@ -54,6 +54,37 @@ export declare function assertSubject(subject: SubjectRef): void;
 export declare function assertScope(scope: ScopeRef): void;
 /** Tipo de scope suelto (el de `listRoleScopes`). */
 export declare function assertScopeType(scopeType: string): void;
+/**
+ * Longitud máxima del id de un objeto/holder de RELACIÓN (columna
+ * `varchar(64)` de `authz_relations`). Más ancha que `IDENTITY_LIMITS.uuid`
+ * (36): el `object.id` de ReBAC lo elige el consumidor y no tiene por qué ser
+ * un uuid.
+ */
+export declare const RELATION_ID_LIMIT = 64;
+/**
+ * **La gramática del id de un objeto de RELACIÓN** (R-16, Fase 4 · lote 4-7).
+ *
+ * Un `object.id` de relaciones va en la columna `varchar(64)` de
+ * `authz_relations` y, en el store compartido, en el id de objeto de FGA
+ * (`document:<partitionKey>|<object.id>`). El driver `database` ya lo validaba
+ * (`RELATION_ID_FORMAT`), pero ni el manager ni el driver `openfga` lo hacían:
+ * el `openfga` solo medía la LONGITUD. Un `object.id` con un `|` dentro
+ * (`'a|b'`) se ESCRIBÍA y `check` lo honraba, pero al parsear de vuelta (corte
+ * por el ÚLTIMO `|`) la partición salía mal, así que `listObjects` lo filtraba
+ * y `enumerateRelations` lo descartaba: una relación que concede y que NO se ve
+ * en la enumeración ni migra —pérdida SILENCIOSA en `reconcile`, justo lo que
+ * el driver promete que no pasa— y una divergencia con `database`, que lo
+ * rechaza con 422. Y los caracteres estructurales (`:`/`#`/espacio) salían como
+ * 503 mal clasificado, cuando por invariante 5 una entrada malformada es 422.
+ *
+ * Misma lista blanca que el resto de la identidad (`COMPONENT_FORMAT`):
+ * minúsculas, dígitos y `._-`; excluye `|`, `#`, `:`, `@`, `*`, `~`, espacios y
+ * control. La aplican el manager (una vez por llamada) Y cada driver (defensa
+ * en profundidad), como el resto de la gramática.
+ */
+export declare function assertRelationId(kind: string, value: unknown): asserts value is string;
+/** Versión booleana para caminos de LECTURA (ids que vienen del backend): no lanza. */
+export declare function isValidRelationId(value: unknown): value is string;
 /**
  * Clave textual de un scope: `app` para la raíz, `<tipo>|<uuid>` para el
  * resto (≤ 57 caracteres). Es la MISMA en todo el paquete: el id de los
@@ -66,6 +97,34 @@ export declare function assertScopeType(scopeType: string): void;
  * 422 aquí, antes de serializarse a nada.
  */
 export declare function scopeKey(scope: ScopeRef): string;
+/**
+ * **Las ORTOGRAFÍAS de un scope con las que hay que limpiar cuando ya no hay
+ * cadena con la que canonizar** (3b-2h · 🟠 3, auditor R2).
+ *
+ * La identidad de un scope es la canónica que devuelve el resolutor
+ * (invariante 17) y el paquete la usa para TODOS los hechos… mientras la fila
+ * del consumidor existe. `scopes.detached` es justo la operación que admite
+ * que ya NO exista (3F · S1: se purga igual, con el scope tal cual), y ahí no
+ * hay con qué canonizar: se usa la ortografía del llamante. Medido contra
+ * PostgreSQL: el tipo `uuid` funde `01a0…-…` con el mismo uuid SIN guiones,
+ * así que el `DELETE` del controlador acierta con el alias, el `detached`
+ * llega con el alias, `purgeScope` demuestra cero sobre un objeto que no
+ * existe y el scope REAL conserva su `parent` y su `binding`: en modo
+ * `facts`, **concede para siempre**. En lectura el mismo alias es
+ * fail-closed; en escritura era fail-OPEN.
+ *
+ * La salida es no elegir: una purga sin cadena limpia la ortografía del
+ * llamante **y** la canónica de la que puede ser alias. Solo se expande el
+ * alias SIN guiones (32 hex ⇒ también la forma 8-4-4-4-12), que es la única
+ * que un motor produce fundiendo —PostgreSQL canoniza CON guiones; el alias
+ * por mayúsculas ya muere en la puerta (`assertScope`)—; así el consumidor
+ * que guarda sus uuids con guiones (el caso normal) no paga NADA, y el que
+ * los guarda sin guiones sigue purgando su clave y, además, una que nunca
+ * tiene hechos. Normalizar en vez de expandir no vale: sin la fila no se sabe
+ * cuál de las dos es la buena, y elegir mal deja los hechos vivos, que es el
+ * fallo que se está cerrando.
+ */
+export declare function scopeSpellings(scope: ScopeRef): ScopeRef[];
 /**
  * La inversa de `scopeKey` para claves que vienen de la BASE (el owner de un
  * rol): `app` ⇒ la raíz; `<tipo>|<uuid>` ⇒ el scope; cualquier otra forma
@@ -75,7 +134,7 @@ export declare function scopeKey(scope: ScopeRef): string;
 export declare function scopeFromKey(key: string): ScopeRef | null;
 /**
  * Nombres que el modelo FGA del modo `facts` usa como relaciones propias
- * (`scope#parent`, `role_binding#assignee`, `deny_binding#denied`…). Un
+ * (`scope#parent`, `role_binding#assignee`, `scope#denied_<P>`…). Un
  * permiso llamado `parent` invalidaría el modelo entero (S14): se rechaza en
  * el núcleo, para ambos drivers, no el día de la migración.
  */
@@ -87,6 +146,20 @@ export declare const RESERVED_SLUGS: ReadonlySet<string>;
  * (S4: `can_docs_write` anulaba el deny de `docs:write`).
  */
 export declare const RESERVED_SLUG_PREFIXES: readonly string[];
+/**
+ * **Los TIPOS de objeto que el modelo `facts` (y el `group` de relaciones) YA
+ * declaran** (Fase 4 · ⚪4). Un tipo de objeto de relaciones que se llame como
+ * uno de estos DUPLICARÍA un tipo del store compartido: `role_binding` sobre
+ * todo —si el driver de relaciones pudiera declararlo, podría componer el id
+ * de un binding real y `relate` sería una escalada a `roles.authorize`—. Vive
+ * en `identity.ts` (la gramática compartida) porque lo consumen DOS módulos
+ * que la frontera de pureza mantiene disjuntos: el generador del modelo
+ * (`src/drivers/openfga_facts.ts`, que no puede depender de `relations/`) y
+ * `defineRelationsConfig` (`src/relations/`, que no puede depender de
+ * `drivers/`). `deny_binding` sigue reservado aunque el modelo (c2r) ya no lo
+ * emita: un catálogo migrado del modo `resolver` no puede resucitarlo.
+ */
+export declare const RESERVED_FACTS_TYPES: ReadonlySet<string>;
 /**
  * Longitud máxima de un slug. Un nombre de relación en FGA admite 50
  * caracteres y el modelo deriva `permits_<slug>` (el prefijo más largo, 8):

package/build/src/identity.d.ts.map

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