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

package/build/src/scope_outbox.js

@@ -0,0 +1,532 @@
+/**
+ * **La outbox del árbol sobre Lucid** (3b-2d; panel 2, cruce 4 · S5).
+ *
+ * El puerto es `ScopeOutbox` (`src/types.ts`) y el paquete NO impone tabla:
+ * cualquier implementación vale. Esta es la que se publica para quien no
+ * quiera escribir la suya, junto con su migración
+ * (`stubs/scopes_outbox_migration.stub`, que hay que COPIAR al proyecto:
+ * `configure` no la publica sola porque la outbox es opt-in).
+ *
+ *   import { sqlScopeOutbox } from '@jantstack/adonis-authz'
+ *
+ *   const outbox = sqlScopeOutbox()
+ *   export default defineConfig({
+ *     scopes: { resolveChain, outbox },
+ *     ...
+ *   })
+ *
+ *   // y en el sitio donde mueves tu árbol:
+ *   await db.transaction(async (trx) => {
+ *     await authorization.scopes.moved(unit, nuevaOrg, { within, actor, transaction: trx })
+ *     await unit.useTransaction(trx).merge({ organizationId: nuevaOrg.uuid }).save()
+ *   })
+ *
+ * Lo único que tiene que cumplir una implementación del puerto es que
+ * `enqueue` escriba DENTRO de la transacción que le pasan: es lo que hace
+ * que el cambio del árbol y su propagación al backend confirmen —o se vayan—
+ * juntos. Todo lo demás (nombres de columna, si las filas aplicadas se
+ * borran o se marcan, si hay reintento con backoff) es del consumidor.
+ *
+ * Aquí las filas aplicadas se MARCAN (`applied_at`), no se borran: la cola
+ * es también el registro de lo que se propagó y cuándo, y `authz:scopes:relay`
+ * no puede ser silencioso.
+ */
+import { createHash } from 'node:crypto';
+import db from '@adonisjs/lucid/services/db';
+import { AuthorizationConfigError } from './errors.js';
+import { systemClock } from './clock.js';
+import { assertScope, assertSubject } from './identity.js';
+import { guardSql } from './shared/backend_guard.js';
+import { assertCallerTransaction } from './shared/transaction_guard.js';
+import { dialectOf, isSqliteDialect } from './shared/sql_expiry.js';
+import { APP_SCOPE, APP_SCOPE_TYPE } from './types.js';
+const DEFAULT_TABLE = 'authz_scope_outbox';
+const DEFAULT_TIMEOUT_MS = 5_000;
+/** Intentos antes de aparcar una entrada (3b-2h · 🔴 2). */
+const DEFAULT_MAX_ATTEMPTS = 5;
+/**
+ * Leases tomados por ESTE proceso (SQLite y cualquier dialecto sin cerrojo de
+ * sesión): la exclusión es entonces de proceso, no de despliegue, y va escrita
+ * en el README. Con PostgreSQL y MySQL el cerrojo es del servidor.
+ */
+const localLeases = new Set();
+const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** Las tres operaciones del árbol, tal como se guardan en la columna `op`. */
+const OPS = ['attached', 'moved', 'detached'];
+/** El scope que va a la fila: la raíz se guarda como `app` con uuid nulo. */
+function columnsOf(scope) {
+    return { type: scope.type, uuid: scope.type === APP_SCOPE_TYPE ? null : scope.uuid };
+}
+/** La vuelta: `app` sin uuid es `APP_SCOPE`; el resto, la fila tal cual. */
+function scopeOf(type, uuid) {
+    return type === APP_SCOPE_TYPE ? APP_SCOPE : { type, uuid: uuid === null ? null : String(uuid) };
+}
+/**
+ * Valida el cambio ANTES del INSERT (422): una cola es un diferido, y un
+ * `ScopeRef` mal formado que entrara aquí explotaría días después dentro del
+ * relay, lejos del call-site que lo escribió.
+ */
+function assertChange(change) {
+    if (!change || !OPS.includes(change.op)) {
+        throw new AuthorizationConfigError(`sqlScopeOutbox: 'op' debe ser uno de ${OPS.join(', ')} (llegó ${String(change?.op)})`);
+    }
+    assertScope(change.child);
+    if (change.op !== 'detached')
+        assertScope(change.parent);
+}
+/** Namespace de los advisory locks del paquete en PostgreSQL. */
+const ADVISORY_LOCK_NAMESPACE = 0x617a;
+/** Tope de MySQL para el nombre de un `GET_LOCK` (más largo es un error 3158). */
+const MYSQL_LOCK_NAME_MAX = 64;
+/**
+ * **Los nombres del lease de una cola** (2.4.0-alpha.5 · R6; tester del panel
+ * relay). Hasta alpha.4 el nombre era `authz_scope_outbox:<conexión>:<tabla>`
+ * recortado a 64 caracteres para MySQL: dos despliegues cuya conexión+tabla
+ * coincidieran en los primeros 64 COMPARTÍAN lease y se excluían para siempre
+ * — y el modo de fallo era `busy: true`, que no lanza: el relay de uno de los
+ * dos no corría nunca, en silencio. Desde alpha.5 el nombre es un hash
+ * ESTABLE del nombre completo (`current`, 59 caracteres), que no colisiona.
+ *
+ * **Transición**: `sqlScopeOutbox.acquire()` toma el lock viejo (`legacy`, el
+ * recortado) Y el nuevo durante alpha.5, porque en un rolling deploy un
+ * proceso con alpha.4 y otro con alpha.5 tienen que seguir excluyéndose
+ * (+0,56 ms medidos por `acquire`). El viejo se retira en 2.5 (CHANGELOG):
+ * mientras dure la transición, dos tablas con los mismos 64 primeros
+ * caracteres siguen compartiendo el `legacy` — la colisión solo se cierra
+ * del todo al retirarlo. Exportado para que el caso lo fije sin MySQL.
+ */
+/**
+ * **Retirada del lock viejo, atada a la versión (cierre alpha.6).** `acquire()` toma
+ * el nombre `legacy` SOLO mientras `SCOPE_OUTBOX_TAKES_LEGACY_LOCK` sea `true`, y
+ * `tests/scope_outbox.spec.ts` exige que ese flag valga exactamente
+ * «`package.json` ≤ `SCOPE_OUTBOX_LEGACY_LOCK_UNTIL`»: en cuanto alguien suba la
+ * versión por encima de la última que necesita la transición, la suite se pone en
+ * ROJO hasta que el flag pase a `false` (y el caso MySQL de R6 se ajuste). Nadie
+ * tiene que acordarse: el propio bump lo exige. Por qué no se retira en la misma
+ * versión que estrena el nombre nuevo: durante un despliegue rodante los procesos
+ * de alpha.4 sostienen el viejo y los nuevos el nuevo, y ninguno ve al otro —
+ * dos escritores justo entonces.
+ */
+export const SCOPE_OUTBOX_LEGACY_LOCK_UNTIL = '2.4.0-alpha.6';
+/**
+ * `false` desde `2.4.0-alpha.7`: la transición terminó (decisión del dueño 2026-09-10: sin
+ * consumidores en MySQL desplegando desde alpha.4, la transición no protegía a nadie). Subir
+ * desde ≤ alpha.4 en MySQL exige parada completa del relay, no despliegue rodante.
+ */
+export const SCOPE_OUTBOX_TAKES_LEGACY_LOCK = false;
+export function scopeOutboxLockNames(connection, table) {
+    const full = `authz_scope_outbox:${connection ?? 'default'}:${table}`;
+    return {
+        legacy: full.slice(0, MYSQL_LOCK_NAME_MAX),
+        current: `authz_scope_outbox:${createHash('sha1').update(full).digest('hex')}`,
+    };
+}
+/** Hash de 32 bits con signo (lo que acepta `pg_try_advisory_xact_lock`). */
+function hash32(value) {
+    let hash = 0;
+    for (let i = 0; i < value.length; i++)
+        hash = (Math.imul(hash, 31) + value.charCodeAt(i)) | 0;
+    return hash;
+}
+/** El primer valor de un `rawQuery`, sea cual sea la forma del dialecto. */
+function firstValue(result, column) {
+    const rows = Array.isArray(result) ? result[0] : (result?.rows ?? result);
+    const row = Array.isArray(rows) ? rows[0] : rows;
+    return row?.[column];
+}
+/**
+ * El cliente con el que se toma el lease: la conexión con nombre, la primaria
+ * del `db` de Lucid, o `null` si lo que se inyectó no es un cliente de Lucid
+ * (los dobles de test) — entonces el lease es de proceso.
+ */
+function lockClientOf(database, connection) {
+    if (connection)
+        return db.connection(connection);
+    const client = database;
+    if (typeof client?.transaction === 'function' && client?.dialect)
+        return client;
+    if (typeof client?.connection === 'function') {
+        const primary = client.connection();
+        return typeof primary?.transaction === 'function' ? primary : null;
+    }
+    return null;
+}
+/**
+ * El sello `created_at` como `Date`, venga como venga del dialecto (medido:
+ * `Date` en PostgreSQL y MySQL, milisegundos como `number` en SQLite). Parsear
+ * un valor NO es leer el reloj (`tests/clock.spec.ts`). Ilegible ⇒ ausente.
+ */
+function stampOf(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    const date = value instanceof Date ? value : new Date(value);
+    return Number.isNaN(date.getTime()) ? undefined : date;
+}
+/** Una fila de la cola, tal como la ve el puerto. */
+function rowToPending(row) {
+    const child = scopeOf(String(row.child_type), row.child_uuid);
+    const change = row.op === 'detached'
+        ? { op: 'detached', child }
+        : { op: row.op, child, parent: scopeOf(String(row.parent_type), row.parent_uuid) };
+    const actor = row.actor_type === null || row.actor_type === undefined
+        ? undefined
+        : { type: String(row.actor_type), uuid: String(row.actor_uuid) };
+    const createdAt = stampOf(row.created_at);
+    return {
+        id: row.id,
+        change,
+        attempts: Number(row.attempts ?? 0),
+        actor,
+        ...(row.last_error === null || row.last_error === undefined ? {} : { lastError: String(row.last_error) }),
+        // La EDAD de la cola (2.4.0-alpha.8): el sello de quien encoló, tal cual.
+        ...(createdAt === undefined ? {} : { createdAt }),
+    };
+}
+/**
+ * El id de la fila que acaba de insertar Lucid, sea cual sea la forma del
+ * dialecto (medido, 2.4.0-alpha.5): `[id]` en SQLite y MySQL, `[{ id }]` en
+ * PostgreSQL con `returning('id')`.
+ */
+function insertedId(result) {
+    const first = Array.isArray(result) ? result[0] : result;
+    const id = first !== null && typeof first === 'object' ? first.id : first;
+    if (typeof id !== 'number' && typeof id !== 'string') {
+        throw new AuthorizationConfigError(`sqlScopeOutbox.enqueue: el motor no devolvió el id de la fila insertada (llegó ${JSON.stringify(first)}); ` +
+            'sin recibo no hay `only`.');
+    }
+    return id;
+}
+/** Los ids de `only`: una lista NO vacía de números o cadenas (500 si no). */
+function assertIds(ids) {
+    if (!Array.isArray(ids) || ids.length === 0 || ids.some((id) => typeof id !== 'number' && typeof id !== 'string')) {
+        throw new AuthorizationConfigError(`sqlScopeOutbox: filter.ids debe ser una lista NO vacía de ids (llegó ${JSON.stringify(ids)})`);
+    }
+    return ids;
+}
+/** La cota de `pending`/`dead`: entera y positiva o 500 (config rota). */
+function assertLimit(limit) {
+    if (!(Number.isInteger(limit) && limit >= 1)) {
+        throw new AuthorizationConfigError(`sqlScopeOutbox: limit debe ser un entero >= 1 (llegó ${String(limit)})`);
+    }
+}
+export function sqlScopeOutbox(options = {}, database = db) {
+    const table = options.table ?? DEFAULT_TABLE;
+    if (!IDENTIFIER.test(table)) {
+        throw new AuthorizationConfigError(`sqlScopeOutbox: table '${table}' no es un identificador SQL simple (letras, dígitos y _).`);
+    }
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const connection = options.connection;
+    const now = options.now ?? systemClock;
+    const maxAttempts = options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+    if (!(Number.isInteger(maxAttempts) && maxAttempts >= 1)) {
+        throw new AuthorizationConfigError(`sqlScopeOutbox: maxAttempts debe ser un entero >= 1 (llegó ${String(options.maxAttempts)})`);
+    }
+    const requireTransaction = options.requireTransaction === undefined ? false : options.requireTransaction;
+    if (typeof requireTransaction !== 'boolean') {
+        throw new AuthorizationConfigError(`sqlScopeOutbox: requireTransaction debe ser un booleano (llegó ${String(options.requireTransaction)}); ` +
+            'true = encolar sin { transaction } es 500 antes del INSERT (default false en 2.4; true en 2.5).');
+    }
+    /**
+     * La conexión de ESTA cola: la declarada, o la primaria del `db` de Lucid
+     * (un doble sin `primaryConnectionName` deja `undefined`: entonces se exige
+     * una transacción, pero no se juzga su conexión).
+     */
+    const ownConnection = connection ??
+        (typeof database.primaryConnectionName === 'string' ? database.primaryConnectionName : undefined);
+    /**
+     * El cliente del encolado: la transacción del consumidor si la hay — y
+     * SOLO si es una transacción abierta de la conexión de la cola (L-1 · 🟠 9,
+     * `assertCallerTransaction`): un `trx` de otra conexión encolaba en la base
+     * equivocada y `db` entero escribía fuera de toda transacción, en silencio.
+     */
+    const clientOf = (context) => {
+        const trx = assertCallerTransaction('sqlScopeOutbox.enqueue', context?.transaction, { connection: ownConnection });
+        if (trx === undefined && requireTransaction) {
+            // La fuga S5, nombrada (2.4.0-alpha.8): sin tu transacción la fila
+            // confirma sola y un rollback tuyo no se la lleva.
+            throw new AuthorizationConfigError('sqlScopeOutbox.enqueue: no llegó { transaction } y esta outbox tiene requireTransaction: true. Encolar fuera ' +
+                'de tu unidad de trabajo es la fuga que la outbox existe para cerrar: la fila confirmaría sola, y si tu ' +
+                'transacción hace rollback después el cambio se queda en la cola y el relay lo aplica al store — tu base ' +
+                'diría un padre y el PDP otro. Pasa el `trx` de db.transaction() en scopes.attached/moved/detached ' +
+                '({ transaction: trx }). No se ha escrito nada.');
+        }
+        return trx ?? on(database);
+    };
+    const query = (operation, run) => guardSql('sqlScopeOutbox', operation, timeoutMs, run);
+    /** Igual que el resto del paquete: la conexión con nombre si se declaró. */
+    const on = (client) => (connection && client === database ? db.connection(connection) : client);
+    return {
+        async enqueue(change, context) {
+            assertChange(change);
+            if (context?.actor !== undefined)
+                assertSubject(context.actor);
+            const child = columnsOf(change.child);
+            const parent = change.op === 'detached' ? { type: null, uuid: null } : columnsOf(change.parent);
+            const client = clientOf(context);
+            // El RECIBO (alpha.5 · R1): el id de la fila, que es el mismo que
+            // devolverá `pending()`. `returning` solo lo aplica Lucid donde el
+            // dialecto lo soporta; en los demás el insert ya devuelve `[id]`.
+            const inserted = await query('enqueue', () => client.table(table).returning('id').insert({
+                op: change.op,
+                child_type: child.type,
+                child_uuid: child.uuid,
+                parent_type: parent.type,
+                parent_uuid: parent.uuid,
+                actor_type: context?.actor?.type ?? null,
+                actor_uuid: context?.actor?.uuid ?? null,
+                attempts: 0,
+                last_error: null,
+                created_at: now(),
+                applied_at: null,
+            }));
+            return { id: insertedId(inserted) };
+        },
+        async pending(limit, after, filter) {
+            assertLimit(limit);
+            const ids = filter === undefined ? undefined : assertIds(filter.ids);
+            const client = on(database);
+            const rows = await query('pending', () => {
+                // Lo APARCADO (`attempts >= maxAttempts`) sale por `dead()`, no por
+                // aquí: si volviera, la pasada la reintentaría eternamente.
+                let q = client
+                    .from(table)
+                    .whereNull('applied_at')
+                    .where('attempts', '<', maxAttempts)
+                    .orderBy('id', 'asc')
+                    .limit(limit);
+                // `after` es el último id que el relay ya vio EN ESTA PASADA: lo que
+                // dejó sin aplicar sigue pendiente y sin esto volvería a salir el
+                // primero para siempre (3b-2h · 🔴 2).
+                if (after !== undefined)
+                    q = q.where('id', '>', after);
+                // `only` (alpha.5 · R1) se filtra AQUÍ, en SQL: es la PK, 0,20 ms
+                // sobre un backlog de 501; en memoria habría que leer la cola entera.
+                if (ids !== undefined)
+                    q = q.whereIn('id', ids);
+                return q;
+            });
+            return rows.map(rowToPending);
+        },
+        /**
+         * **La sonda de dependencia de `only`** (alpha.5 · R1): la pendiente más
+         * antigua ANTERIOR a `id` —sin aplicar, no aparcada— que nombre alguno de
+         * `scopes` como hijo o como padre. Una consulta de existencia con el
+         * índice `(applied_at, id)`: 0,69 ms medidos sobre 501 pendientes.
+         */
+        async earlierPending(id, scopes) {
+            const targets = scopes.map((scope) => {
+                assertScope(scope);
+                return columnsOf(scope);
+            });
+            if (targets.length === 0)
+                return null;
+            const client = on(database);
+            const rows = await query('earlierPending', () => client
+                .from(table)
+                .whereNull('applied_at')
+                .where('attempts', '<', maxAttempts)
+                .where('id', '<', id)
+                .where((names) => {
+                for (const target of targets) {
+                    // La raíz se guarda como `app` con uuid NULO (solo puede ser padre).
+                    names.orWhere((one) => {
+                        one.where('child_type', target.type);
+                        target.uuid === null ? one.whereNull('child_uuid') : one.where('child_uuid', target.uuid);
+                    });
+                    names.orWhere((one) => {
+                        one.where('parent_type', target.type);
+                        target.uuid === null ? one.whereNull('parent_uuid') : one.where('parent_uuid', target.uuid);
+                    });
+                }
+            })
+                .orderBy('id', 'asc')
+                .limit(1));
+            return rows.length === 0 ? null : rowToPending(rows[0]);
+        },
+        /**
+         * Las entradas APARCADAS: pendientes que agotaron sus intentos. No se
+         * reintentan, se MIRAN (3b-2h · 🔴 2).
+         */
+        async dead(limit) {
+            assertLimit(limit);
+            const client = on(database);
+            const rows = await query('dead', () => client
+                .from(table)
+                .whereNull('applied_at')
+                .where('attempts', '>=', maxAttempts)
+                .orderBy('id', 'asc')
+                .limit(limit));
+            return rows.map(rowToPending);
+        },
+        /**
+         * **El lease del escritor ÚNICO** (3b-2h · 🟠 4). Cerrojo del SERVIDOR en
+         * PostgreSQL (`pg_try_advisory_xact_lock`, que se suelta con la
+         * transacción) y en MySQL (`GET_LOCK(name, 0)`); en SQLite —y en
+         * cualquier dialecto sin cerrojo de sesión— es un cerrojo de PROCESO, y
+         * eso está escrito: SQLite ya serializa sus escrituras y no es el motor
+         * de un despliegue con dos réplicas del relay.
+         *
+         * La transacción se abre SOLO para sostener el cerrojo (no escribe nada)
+         * y se revierte al soltarlo: es una conexión ocupada mientras dura la
+         * pasada, que es el precio de que dos pasadas no se pisen.
+         */
+        async acquire() {
+            const names = scopeOutboxLockNames(connection, table);
+            /** El nombre del cerrojo de PROCESO y del advisory de PG: el completo (allí no hay recorte). */
+            const name = `authz_scope_outbox:${connection ?? 'default'}:${table}`;
+            const client = lockClientOf(database, connection);
+            if (client === null || isSqliteDialect(client)) {
+                if (localLeases.has(name))
+                    return null;
+                localLeases.add(name);
+                return { release: async () => void localLeases.delete(name) };
+            }
+            const dialect = dialectOf(client);
+            const trx = await query('acquire', () => client.transaction());
+            try {
+                if (dialect.startsWith('postgres')) {
+                    const result = await query('acquire', () => trx.rawQuery('select pg_try_advisory_xact_lock(?, ?) as taken', [ADVISORY_LOCK_NAMESPACE, hash32(name)]));
+                    if (!firstValue(result, 'taken')) {
+                        await trx.rollback();
+                        return null;
+                    }
+                    // El cerrojo es de la TRANSACCIÓN: revertirla lo suelta.
+                    return { release: async () => void (await trx.rollback()) };
+                }
+                if (dialect.startsWith('mysql')) {
+                    // **Los DOS locks** (alpha.5 · R6, transición): el nuevo —hash
+                    // estable, sin colisión— y el viejo —el recortado a 64 de alpha.4—,
+                    // para que un rolling deploy con las dos versiones siga siendo
+                    // escritor único. Si cualquiera de los dos falla, se sueltan los que
+                    // se tomaron y es `busy`. El viejo se retira en 2.5.
+                    const taken = [];
+                    const take = async (lockName) => {
+                        const result = await query('acquire', () => trx.rawQuery('select get_lock(?, 0) as taken', [lockName]));
+                        const ok = Number(firstValue(result, 'taken') ?? 0) === 1;
+                        if (ok)
+                            taken.push(lockName);
+                        return ok;
+                    };
+                    const releaseAll = async () => {
+                        try {
+                            for (const lockName of taken.reverse())
+                                await trx.rawQuery('select release_lock(?)', [lockName]);
+                        }
+                        finally {
+                            await trx.rollback();
+                        }
+                    };
+                    if (!(await take(names.current)) || (SCOPE_OUTBOX_TAKES_LEGACY_LOCK && !(await take(names.legacy)))) {
+                        await releaseAll();
+                        return null;
+                    }
+                    return { release: releaseAll };
+                }
+                // Un dialecto que no sabemos cerrar: se cierra en el proceso y se
+                // suelta la transacción (nunca se devuelve un lease de mentira).
+                await trx.rollback();
+                if (localLeases.has(name))
+                    return null;
+                localLeases.add(name);
+                return { release: async () => void localLeases.delete(name) };
+            }
+            catch (error) {
+                await trx.rollback().catch(() => { });
+                throw error;
+            }
+        },
+        /**
+         * **La sonda anti-reversión de `requeue`** (alpha.5 · R2b), espejo de
+         * `earlierPending`: las entradas APLICADAS posteriores a `id` que nombren
+         * alguno de `scopes` como hijo o como padre, en orden de id. Una consulta
+         * acotada por `limit`; es lo que el manager mira antes de devolver una
+         * aparcada a la cola.
+         */
+        async laterApplied(id, scopes, limit) {
+            assertLimit(limit);
+            const targets = scopes.map((scope) => {
+                assertScope(scope);
+                return columnsOf(scope);
+            });
+            if (targets.length === 0)
+                return [];
+            const client = on(database);
+            const rows = await query('laterApplied', () => client
+                .from(table)
+                .whereNotNull('applied_at')
+                .where('id', '>', id)
+                .where((names) => {
+                for (const target of targets) {
+                    names.orWhere((one) => {
+                        one.where('child_type', target.type);
+                        target.uuid === null ? one.whereNull('child_uuid') : one.where('child_uuid', target.uuid);
+                    });
+                    names.orWhere((one) => {
+                        one.where('parent_type', target.type);
+                        target.uuid === null ? one.whereNull('parent_uuid') : one.where('parent_uuid', target.uuid);
+                    });
+                }
+            })
+                .orderBy('id', 'asc')
+                .limit(limit));
+            return rows.map(rowToPending);
+        },
+        /**
+         * **Reencola entradas APARCADAS** (alpha.5 · R2b): todo o nada, y
+         * `attempts = maxAttempts − 1` (decisión del dueño: vuelve a `dead()` en
+         * UNA pasada si la causa sigue rota, entra a la primera si se arregló;
+         * sin columna nueva). Cada id tiene que existir, no estar aplicado y
+         * tener los intentos agotados; si alguno no cumple se lanza nombrándolo
+         * ANTES de tocar nada — una fila aplicada no revive jamás (reencolar un
+         * `detached` aplicado volvería a purgar). `last_error` se conserva: la
+         * causa es historia, y la siguiente pasada la sobreescribe si vuelve a
+         * fallar. La política (qué se puede reencolar sin revertir el árbol) es
+         * del manager, no de aquí.
+         */
+        async requeue(ids) {
+            const wanted = assertIds(ids);
+            const client = on(database);
+            const rows = await query('requeue', () => client.from(table).whereIn('id', wanted).select('id', 'applied_at', 'attempts'));
+            const found = new Map(rows.map((row) => [String(row.id), row]));
+            const rejectedIds = wanted.filter((id) => {
+                const row = found.get(String(id));
+                return !row || (row.applied_at !== null && row.applied_at !== undefined) || Number(row.attempts) < maxAttempts;
+            });
+            if (rejectedIds.length > 0) {
+                throw new AuthorizationConfigError(`sqlScopeOutbox.requeue: ${rejectedIds.map(String).join(', ')} no existe(n) o no está(n) aparcada(s) ` +
+                    `(ya aplicada, o todavía pendiente con intentos por gastar): no se ha tocado NINGUNA fila. ` +
+                    'Solo se reencola lo que sale por dead().');
+            }
+            await query('requeue', () => client
+                .from(table)
+                .whereIn('id', wanted)
+                .whereNull('applied_at')
+                .where('attempts', '>=', maxAttempts)
+                .update({ attempts: maxAttempts - 1 }));
+            // La comprobación y la escritura no van en una transacción (el cliente
+            // puede ser un doble): se relee, y si la cola cambió entre medias se dice.
+            const after = await query('requeue', () => client.from(table).whereIn('id', wanted).whereNull('applied_at').where('attempts', maxAttempts - 1).select('id'));
+            if (after.length !== wanted.length) {
+                throw new AuthorizationConfigError(`sqlScopeOutbox.requeue: se pidió reencolar ${wanted.length} fila(s) y quedaron ${after.length} en la cola: ` +
+                    'la outbox cambió entre la comprobación y la escritura. Mira dead() y repite.');
+            }
+        },
+        async markApplied(id) {
+            const client = on(database);
+            await query('markApplied', () => client.from(table).where('id', id).update({ applied_at: now(), last_error: null }));
+        },
+        async markFailed(id, error, options) {
+            const client = on(database);
+            // El intento se cuenta aunque el mensaje sea larguísimo: se recorta el
+            // texto, nunca el hecho de que falló. Salvo que la causa sea el BACKEND
+            // (`transient`, alpha.5 · R2a): entonces se escribe la causa —nada se
+            // vuelve silencioso— y NO se cuenta, porque `maxAttempts` converge
+            // sobre lo irreparable y una caída del store no dice nada de la fila.
+            await query('markFailed', () => {
+                const q = client.from(table).where('id', id).update({ last_error: String(error).slice(0, 2000) });
+                return options?.transient === true ? q : q.increment('attempts', 1);
+            });
+        },
+    };
+}
+//# sourceMappingURL=scope_outbox.js.map

package/build/src/scope_outbox.js.map

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

package/build/src/{drivers → shared}/backend_guard.d.ts

@@ -23,6 +23,34 @@ export declare function isAuthzError(error: unknown): boolean;
  * (2.5-B · K12): un error crudo del cliente nunca cruza la frontera.
  */
 export declare function isSqlDriverError(error: unknown): boolean;
+/**
+ * ¿El error (o alguna de sus causas) es un choque del UNIQUE? Por la forma de
+ * cada cliente: PostgreSQL SQLSTATE `23505`, MySQL `errno` 1062
+ * (`ER_DUP_ENTRY`), SQLite `SQLITE_CONSTRAINT_UNIQUE` (o el `SQLITE_CONSTRAINT`
+ * genérico con «UNIQUE» en el mensaje). Se mira la cadena entera de causas:
+ * `guardSql` ya lo habrá envuelto en un `AuthorizationBackendError`.
+ *
+ * Lo usa el driver `database` DENTRO de una transacción del llamante (L-3):
+ * fuera de ella un choque se absorbe releyendo (K4), dentro no se puede —en
+ * PostgreSQL la transacción ya está abortada y en REPEATABLE READ la relectura
+ * no vería al ganador— y sale como 409 `E_AUTHZ_WRITE_CONFLICT`.
+ */
+export declare function isUniqueViolation(error: unknown): boolean;
+/**
+ * ¿El error (o alguna de sus causas) es un DEADLOCK que el motor resolvió
+ * eligiendo esta transacción como víctima? PostgreSQL SQLSTATE `40P01`
+ * (`deadlock_detected`; y `40001`, `serialization_failure`, la misma familia
+ * de «reintenta»), MySQL `errno` 1213 (`ER_LOCK_DEADLOCK`: InnoDB deshace la
+ * transacción ENTERA de la víctima). SQLite no tiene deadlocks entre
+ * escritores: el segundo recibe `SQLITE_BUSY` (503), no un deadlock.
+ *
+ * Lo usa el driver `database` de relaciones DENTRO de una transacción del
+ * llamante (L-4, 🟡 12 del auditor): dos transacciones que escriben dos
+ * relaciones en orden cruzado ⇒ el perdedor sale con **409
+ * `E_AUTHZ_WRITE_CONFLICT`** («haz rollback y reintenta»), jamás un error
+ * crudo del motor ni un 503 disfrazado de indeterminado.
+ */
+export declare function isDeadlock(error: unknown): boolean;
 /**
  * ¿El error viene de un deadline vencido? knex lanza `KnexTimeoutError` (o, si
  * además falló la cancelación, el error de cancelación con `timeout` puesto);
@@ -87,6 +115,20 @@ export declare function resolveChain(resolver: ScopeChainResolver, scope: ScopeR
  * sigue siendo 503: no se limpia a ciegas cuando el árbol está caído.
  */
 export declare function canonicalScope(resolver: ScopeChainResolver, scope: ScopeRef, operation: string): Promise<ScopeRef>;
+/**
+ * **Los scopes destino de un DELETE que no exige que el scope exista**
+ * (`revoke`/`removeDeny`; 3b-8 · A4, mismo cierre que 3b-2h · 🟠 3 dio a
+ * `scopes.detached`). Con la fila viva es exactamente UNO, el canónico
+ * (`chain[0]`). Sin cadena con la que canonizar —la fila ya borrada, o sin
+ * resolutor— la ortografía del llamante a secas hacía del delete un no-op
+ * SILENCIOSO cuando llegaba un alias del uuid (el mismo uuid sin guiones,
+ * que el tipo `uuid` de PG o una collation `*_ci` funden con la fila real):
+ * el hecho canónico seguía escrito y volvía a conceder si el scope se
+ * restauraba. Se reusa el fan-out de `scopeSpellings`: la ortografía del
+ * llamante Y la canónica de la que puede ser alias. Quitar nunca concede,
+ * así que borrar de más no existe aquí.
+ */
+export declare function canonicalScopeTargets(resolver: ScopeChainResolver, scope: ScopeRef, operation: string): Promise<ScopeRef[]>;
 /** La cadena canónica, o 422 `E_AUTHZ_UNKNOWN_SCOPE` si el scope no existe (para escrituras). */
 export declare function assertKnownScope(resolver: ScopeChainResolver, scope: ScopeRef, operation: string): Promise<ScopeRef[]>;
 //# sourceMappingURL=backend_guard.d.ts.map

package/build/src/shared/backend_guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend_guard.d.ts","sourceRoot":"","sources":["../../../src/shared/backend_guard.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAI/D;;;;;;;;;;;GAWG;AAEH,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWzD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQlD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQrD;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAOnG;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAO9B,CAAA;AAeD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CA0C5B;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAQxH;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAQrB;AAED,iGAAiG;AACjG,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,QAAQ,EAAE,CAAC,CASrB"}