@jantstack/adonis-authz 2.4.0-alpha.3 → 2.4.0-alpha.5

package/build/src/testing/main.d.ts

@@ -16,4 +16,6 @@ export { runRelationsDriverContract, registerRelationsDriverContract, makeRelati
 export type { RelationsDriverContractHarness, RelationsContractTransactions, MakeRelationsDriverOptions, } from './relations_contract.js';
 export { runRelationsReconcileContract, registerRelationsReconcileContract, } from './relations_reconcile_contract.js';
 export type { RelationsReconcileHarness } from './relations_reconcile_contract.js';
+export { runScopeOutboxContract, registerScopeOutboxContract, makeScopeOutbox, SCOPE_OUTBOX_CAPABILITY_KEYS, } from './scope_outbox_contract.js';
+export type { ScopeOutboxCapabilities, ScopeOutboxContractHarness, ScopeOutboxContractTransactions, MakeScopeOutboxOptions, } from './scope_outbox_contract.js';
 //# sourceMappingURL=main.d.ts.map

package/build/src/testing/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/testing/main.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAA;AACzF,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACnH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACpF,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,wBAAwB,GACzB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EACV,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,YAAY,GACb,MAAM,yBAAyB,CAAA;AAChC,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,kCAAkC,GACnC,MAAM,yBAAyB,CAAA;AAChC,YAAY,EACV,8BAA8B,EAC9B,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,GACnC,MAAM,mCAAmC,CAAA;AAC1C,YAAY,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAA"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/testing/main.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAA;AACzF,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACnH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACpF,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,wBAAwB,GACzB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EACV,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,YAAY,GACb,MAAM,yBAAyB,CAAA;AAChC,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,kCAAkC,GACnC,MAAM,yBAAyB,CAAA;AAChC,YAAY,EACV,8BAA8B,EAC9B,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,GACnC,MAAM,mCAAmC,CAAA;AAC1C,YAAY,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAA;AAClF,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,eAAe,EACf,4BAA4B,GAC7B,MAAM,4BAA4B,CAAA;AACnC,YAAY,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,4BAA4B,CAAA"}

package/build/src/testing/main.js

@@ -11,4 +11,5 @@ export { memoryScopeTree, resolveChainFrom, descendantsFrom } from './scope_tree
 export { runMigrationContract, registerMigrationContract, runMigrationDirection, makeMigrationSeed, migrationQuestions, plantMigrationFacts, plantMigrationTree, MIGRATION_CATALOG, MIGRATION_PERMISSIONS, MIGRATION_ROLES, MIGRATION_QUESTION_COUNT, } from './migration_contract.js';
 export { runRelationsDriverContract, registerRelationsDriverContract, makeRelationsDriver, contractRelationsConfig, RELATIONS_HOLDER_TYPES, lucidRelationsContractTransactions, } from './relations_contract.js';
 export { runRelationsReconcileContract, registerRelationsReconcileContract, } from './relations_reconcile_contract.js';
+export { runScopeOutboxContract, registerScopeOutboxContract, makeScopeOutbox, SCOPE_OUTBOX_CAPABILITY_KEYS, } from './scope_outbox_contract.js';
 //# sourceMappingURL=main.js.map

package/build/src/testing/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/testing/main.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAA;AAEzF,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACpF,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,wBAAwB,GACzB,MAAM,yBAAyB,CAAA;AAUhC,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,kCAAkC,GACnC,MAAM,yBAAyB,CAAA;AAMhC,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,GACnC,MAAM,mCAAmC,CAAA"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/testing/main.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAA;AAEzF,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACpF,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,wBAAwB,GACzB,MAAM,yBAAyB,CAAA;AAUhC,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,kCAAkC,GACnC,MAAM,yBAAyB,CAAA;AAMhC,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,GACnC,MAAM,mCAAmC,CAAA;AAE1C,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,eAAe,EACf,4BAA4B,GAC7B,MAAM,4BAA4B,CAAA"}

package/build/src/testing/scope_outbox_contract.d.ts

@@ -0,0 +1,88 @@
+import type { ScopeOutbox } from '../types.js';
+import type { ContractTestApi } from './contract.js';
+/**
+ * Lo que una outbox DECLARA. Cada clave es un par: la cara `true` juzga el
+ * deber, la `false` juzga la ausencia (el manager lo dice, o la
+ * implementación degrada hacia lo seguro).
+ */
+export interface ScopeOutboxCapabilities {
+    /**
+     * `enqueue` escribe por `context.transaction`: un rollback del llamante no
+     * deja intención ninguna, un commit sí. Es TODO el mecanismo de la
+     * mitigación (README, «The tree outbox»). Exige `transactions` en el
+     * harness. `false` = la implementación ignora la transacción (un doble en
+     * memoria): la cara juzga solo que encolar sin transacción funciona, y la
+     * mitigación queda APAGADA — dilo en tu README.
+     */
+    transactionalEnqueue: boolean;
+    /** `pending(limit, after, { ids })` filtra EN EL PUERTO (alpha.5 · R1). `false` ⇒ el manager corta `only` con 500. */
+    filter: boolean;
+    /** `markFailed(id, error, { transient: true })` NO cuenta el intento (alpha.5 · R2a). `false` ⇒ cuenta siempre (lo de alpha.4). */
+    transient: boolean;
+    /** `dead()` existe: tras `limits.maxAttempts` fallos la entrada sale de `pending()` y entra en `dead()` (3b-2h). */
+    dead: boolean;
+    /** `acquire()` existe: lease SOSTENIDO y exclusivo (3b-2h · 🟠 4). `false` ⇒ el relay corre sin lease y lo dice el README. */
+    acquire: boolean;
+    /** `earlierPending(id, scopes)` existe (alpha.5 · R1). `false` ⇒ el manager pagina `pending()` y el veredicto es el mismo. */
+    earlierPending: boolean;
+    /** `requeue(ids)` Y `laterApplied(id, scopes, limit)` existen (alpha.5 · R2b). Exige `dead: true`. `false` ⇒ `requeueScopeChanges` es 500. */
+    requeue: boolean;
+}
+export declare const SCOPE_OUTBOX_CAPABILITY_KEYS: ReadonlyArray<keyof ScopeOutboxCapabilities>;
+export interface ScopeOutboxContractHarness {
+    name: string;
+    capabilities: ScopeOutboxCapabilities;
+    /** Una outbox FRESCA por caso, sobre una cola VACÍA (el harness la vacía en `cleanup`). */
+    makeOutbox(): ScopeOutbox | Promise<ScopeOutbox>;
+    /** Vacía la cola antes de cada caso. */
+    cleanup?(): Promise<void>;
+    /**
+     * Con `dead: true` (y por tanto `requeue: true`): el `maxAttempts` con el
+     * que está construida la outbox, ≥ 3 (los casos cuentan dos fallos sin
+     * aparcar y luego aparcan de verdad).
+     */
+    limits?: {
+        maxAttempts?: number;
+    };
+    /** Con `transactionalEnqueue: true`: cómo abre el juez una transacción de LA CONEXIÓN de la outbox. */
+    transactions?: ScopeOutboxContractTransactions;
+}
+/** Ver `ScopeOutboxContractHarness.transactions`. */
+export interface ScopeOutboxContractTransactions {
+    begin(): Promise<{
+        client: unknown;
+        commit(): Promise<unknown>;
+        rollback(): Promise<unknown>;
+    }>;
+}
+export interface MakeScopeOutboxOptions {
+    capabilities: ScopeOutboxCapabilities;
+    /** Solo con `dead: true` (default 5). */
+    maxAttempts?: number;
+}
+/**
+ * Una outbox EN MEMORIA que implementa el puerto entero y expone SOLO lo que
+ * declara: con `filter: false` ignora `ids`, con `transient: false` cuenta
+ * siempre, con `dead: false` no aparca (y no tiene `dead`), y sin `acquire`/
+ * `earlierPending`/`requeue` no trae esos métodos. Es la forma de ejercer LAS
+ * DOS CARAS de cada par sin servidor. No escribe por ninguna transacción:
+ * `transactionalEnqueue` tiene que ser `false` (lanza si no).
+ */
+export declare function makeScopeOutbox(options: MakeScopeOutboxOptions): ScopeOutbox;
+export declare function runScopeOutboxContract(harness: ScopeOutboxContractHarness): {
+    registered: number;
+    covered: Set<keyof ScopeOutboxCapabilities>;
+};
+/**
+ * El MOTOR del runner (registro de casos), separado para que el propio
+ * paquete pueda contar los casos (`scope_outbox_harness.spec.ts`). Devuelve
+ * el nº de casos registrados y las capacidades cubiertas.
+ */
+export declare function registerScopeOutboxContract(harness: ScopeOutboxContractHarness, api: {
+    group: ContractTestApi['group'];
+    test: ContractTestApi['test'];
+}): {
+    registered: number;
+    covered: Set<keyof ScopeOutboxCapabilities>;
+};
+//# sourceMappingURL=scope_outbox_contract.d.ts.map

package/build/src/testing/scope_outbox_contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope_outbox_contract.d.ts","sourceRoot":"","sources":["../../../src/testing/scope_outbox_contract.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAA0B,WAAW,EAA6D,MAAM,aAAa,CAAA;AACjI,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAIpD;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;OAOG;IACH,oBAAoB,EAAE,OAAO,CAAA;IAC7B,sHAAsH;IACtH,MAAM,EAAE,OAAO,CAAA;IACf,mIAAmI;IACnI,SAAS,EAAE,OAAO,CAAA;IAClB,oHAAoH;IACpH,IAAI,EAAE,OAAO,CAAA;IACb,8HAA8H;IAC9H,OAAO,EAAE,OAAO,CAAA;IAChB,8HAA8H;IAC9H,cAAc,EAAE,OAAO,CAAA;IACvB,8IAA8I;IAC9I,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,eAAO,MAAM,4BAA4B,EAAE,aAAa,CAAC,MAAM,uBAAuB,CAQrF,CAAA;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,uBAAuB,CAAA;IACrC,2FAA2F;IAC3F,UAAU,IAAI,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAChD,wCAAwC;IACxC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB;;;;OAIG;IACH,MAAM,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACjC,uGAAuG;IACvG,YAAY,CAAC,EAAE,+BAA+B,CAAA;CAC/C;AAED,qDAAqD;AACrD,MAAM,WAAW,+BAA+B;IAC9C,KAAK,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;QAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC,CAAA;CAChG;AAID,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,uBAAuB,CAAA;IACrC,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAUD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,WAAW,CA4F5E;AAID,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,0BAA0B;gBAgCzD,MAAM;aAAW,GAAG,CAAC,MAAM,uBAAuB,CAAC;EA3BnE;AAmBD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,0BAA0B,EACnC,GAAG,EAAE;IAAE,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,CAAA;CAAE,GACtE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAC,MAAM,uBAAuB,CAAC,CAAA;CAAE,CAwfrE"}