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

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

@@ -0,0 +1,73 @@
+import type { RelationsConfig } from '../relations/define_relations_config.js';
+import type { RelationsDriver, RelationsDriverCapabilities, ScopeRef } from '../types.js';
+import type { ContractTestApi } from './contract.js';
+/** Los holder types del contrato de relaciones. */
+export declare const RELATIONS_HOLDER_TYPES: readonly ["user", "admin", "integration"];
+/**
+ * La config FIJA del contrato: un tipo `document` con `owner ⊆ editor ⊆
+ * viewer` (includes de un nivel) y `membersOf` habilitado en `database`.
+ */
+export declare function contractRelationsConfig(): RelationsConfig;
+export interface RelationsDriverContractHarness {
+    name: string;
+    /** Lo que este driver DECLARA. Cada valor se juzga con su cara. */
+    capabilities: RelationsDriverCapabilities;
+    /** Construye el driver sobre la config del contrato (fresco por caso). */
+    makeDriver(config: RelationsConfig): RelationsDriver | Promise<RelationsDriver>;
+    /** Tope del backend para el truncado (whenTrue de `listObjectsTruncation`). */
+    limits?: {
+        listMaxResults?: number;
+    };
+    /**
+     * Solo con `transactionalWrites: true` (L-4, paridad con el hook
+     * `transactions` del runner de roles): cómo abre el juez una transacción de
+     * LA CONEXIÓN DEL DRIVER y cómo cuenta las tuplas de una partición en el
+     * backend — el CENSO: el rollback se juzga por filas, no solo por la
+     * respuesta de `check`. Default: `db.transaction()` de Lucid (conexión
+     * primaria) y `authz_relations`, lo que vale para el driver `database`. Un
+     * driver de terceros con otra conexión u otra tabla trae el suyo.
+     */
+    transactions?: RelationsContractTransactions;
+}
+/** Ver `RelationsDriverContractHarness.transactions`. */
+export interface RelationsContractTransactions {
+    begin(): Promise<{
+        client: unknown;
+        commit(): Promise<unknown>;
+        rollback(): Promise<unknown>;
+    }>;
+    /** Cuántas tuplas hay en la partición, por la conexión del motor (fuera de toda transacción). */
+    census(partition: ScopeRef): Promise<number>;
+}
+/** El default de `RelationsDriverContractHarness.transactions`: Lucid + `authz_relations`. */
+export declare function lucidRelationsContractTransactions(): RelationsContractTransactions;
+export interface MakeRelationsDriverOptions {
+    config: RelationsConfig;
+    capabilities: RelationsDriverCapabilities;
+    limits?: {
+        listMaxResults?: number;
+    };
+}
+/**
+ * Un `RelationsDriver` en memoria que satisface el puerto y HONRA las
+ * capacidades declaradas (para poblar las dos caras del contrato). Es el doble
+ * que prueba el CONTRATO —no el MODELO fusionado (eso es el `:8101` en 4-4)—.
+ */
+export declare function makeRelationsDriver(options: MakeRelationsDriverOptions): RelationsDriver;
+export declare function runRelationsDriverContract(harness: RelationsDriverContractHarness): {
+    registered: number;
+    covered: Set<keyof RelationsDriverCapabilities>;
+};
+/**
+ * El MOTOR del runner (registro de casos), separado para que el propio paquete
+ * pueda contar los casos (`relations_harness.spec.ts`). Devuelve el nº de
+ * casos registrados y las capacidades cubiertas.
+ */
+export declare function registerRelationsDriverContract(harness: RelationsDriverContractHarness, api: {
+    group: ContractTestApi['group'];
+    test: ContractTestApi['test'];
+}): {
+    registered: number;
+    covered: Set<keyof RelationsDriverCapabilities>;
+};
+//# sourceMappingURL=relations_contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relations_contract.d.ts","sourceRoot":"","sources":["../../../src/testing/relations_contract.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAA;AAC9E,OAAO,KAAK,EAGV,eAAe,EACf,2BAA2B,EAK3B,QAAQ,EAET,MAAM,aAAa,CAAA;AAEpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAIpD,mDAAmD;AACnD,eAAO,MAAM,sBAAsB,2CAA4C,CAAA;AAE/E;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,eAAe,CAezD;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAA;IACZ,mEAAmE;IACnE,YAAY,EAAE,2BAA2B,CAAA;IACzC,0EAA0E;IAC1E,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC/E,+EAA+E;IAC/E,MAAM,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACpC;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,6BAA6B,CAAA;CAC7C;AAED,yDAAyD;AACzD,MAAM,WAAW,6BAA6B;IAC5C,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;IAC/F,iGAAiG;IACjG,MAAM,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CAC7C;AAED,8FAA8F;AAC9F,wBAAgB,kCAAkC,IAAI,6BAA6B,CAWlF;AAwBD,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,eAAe,CAAA;IACvB,YAAY,EAAE,2BAA2B,CAAA;IACzC,MAAM,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACrC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,eAAe,CAExF;AAsSD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,8BAA8B;gBAgBjE,MAAM;aAAW,GAAG,CAAC,MAAM,2BAA2B,CAAC;EAVvE;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,8BAA8B,EACvC,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,2BAA2B,CAAC,CAAA;CAAE,CAyyBzE"}