@aventara/testing 1.0.0-rc.10 → 1.0.0-rc.12

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @aventara/testing
 
+## 1.0.0-rc.12
+
+### Patch Changes
+
+- Updated dependencies [fdeee8a]
+  - @aventara/core@1.0.0-rc.12
+
+## 1.0.0-rc.11
+
+### Patch Changes
+
+- 67551ca: The protocol corpus covers rc.11's Operation Sets and cached reads. `POST /_all` rows: a mix of reads and writes answered
+  `200 A1000` with each key's own envelope, hostile keys, the streamed NDJSON answer, and the whole-request refusals
+  (`limits.maxAll`, an empty set, a bad key or member, a stale hash, `GET`). Cached-read rows run against a fourth corpus
+  ClientContract with `cache` stages, named by their query's `v`: each `for` audience's headers, the compressed `q`,
+  `ETag` and `304`, the `no-store` refusals, and the `405`s. `runAvProtocolConformance` and `AvProtocolCorpus.framework`
+  pick a `GET` row's contract by its `v`, and `fixtures/protocol-v1.json` lists the fourth contract.
+- 186bc29: The corpus Contracts' hashes and `fixtures/protocol-v1.json` move once, because every Client Contract's limits now
+  include `maxAll` and `maxAllConcurrency`.
+- Updated dependencies [6197c08]
+- Updated dependencies [e0e89c1]
+- Updated dependencies [186bc29]
+- Updated dependencies [33b5f83]
+- Updated dependencies [6d8b589]
+- Updated dependencies [11ece49]
+- Updated dependencies [92fd093]
+- Updated dependencies [e5e98e6]
+- Updated dependencies [a05d970]
+  - @aventara/core@1.0.0-rc.11
+
 ## 1.0.0-rc.10
 
 ### Patch Changes

package/README.md

@@ -36,8 +36,10 @@ const framework = await AvProtocolCorpus.framework();
 ```
 
 - `framework(contractHash?)`: a fresh corpus `AvFramework`, backed by an in-memory adapter whose answers every row
-  states. Pass a row's `Aventara-Contract-Hash` to get the contract that row targets: a few rows target a second
-  contract without transactions, and every other hash (a stale one included) gets the main contract.
+  states. Pass a row's `Aventara-Contract-Hash` to get the contract that row targets (a cached read's `GET` sends no
+  such header: pass its query's `v`). A few rows target a contract without transactions, the `/_access/can` rows one
+  with `access`, and the cached-read rows one with `cache` stages; every other hash (a stale one included) gets the
+  main contract.
 - `entrypoint`: where the corpus is mounted; every row's `path` is relative to it.
 - `clientContractHash`: the main ClientContract's hash. A client generated against it sends this hash, and
   `GET /_contract` names it.
@@ -63,8 +65,11 @@ or host written in another language can be held to the same answers:
 ```
 
 - `contracts`: each ClientContract a row targets: its hash and its exact `GET /_contract` bytes (`document`, a
-  string). The first is the main contract, `clientContractHash`; a row targets the other by sending its hash.
-- `rows`: as `AvProtocolFixture` describes them. One body is too large to write out (one byte over the 1 MiB request
+  string). The first is the main contract, `clientContractHash`; a row targets another by sending its hash (a cached
+  read's `GET` as its query's `v`).
+- `rows`: as `AvProtocolFixture` describes them. A cached read's `request` carries its `query` (without the `?`). A
+  streamed `POST /_all` answer (`Accept: application/x-ndjson`) is no envelope: its row's `code` is `null` and its
+  `bodyBytes` are the lines in order. One body is too large to write out (one byte over the 1 MiB request
   limit): its `request.body.content` is a recipe, `{ "prefix": "…", "repeat": "x", "times": 1048567, "suffix": "…" }`,
   standing for `prefix` + `repeat` repeated `times` times + `suffix`. Every other `content` is the body's text.
 

package/dist/protocol/corpus-contract.fixture.d.ts

@@ -1,285 +1,5 @@
 import type { AvAdapterModel, AvContext, AvFramework, AvPrebuiltContracts } from "@aventara/core";
-import { AvDecimal } from "@aventara/core";
 import type { AvAdapterOperation } from "@aventara/core/internal";
-/**
- * The corpus's adapter model:
- *
- * - `authors`: every standard operation; its `secret` field is hidden at
- *   client scope;
- * - `books`: references `authors`, and deleting an author cascades into it
- *   ({@link CORPUS_REFERENTIAL_ACTIONS}; a plan's `V1019`); the client scope
- *   defines a computed `label` the client alone sees ({@link CORPUS_RESOURCES});
- * - `secrets`: its one operation restricted away at client scope;
- * - `hiddenRes`: hidden at client scope;
- * - `samples`: one field of each scalar whose wire form is not its runtime
- *   form (`bigint`, `datetime`, `decimal`, `bytes`).
- */
-export declare const CORPUS_MODEL: {
-    readonly transactions: "interactive";
-    readonly scalars: {
-        readonly string: {
-            readonly builtin: true;
-        };
-        readonly bigint: {
-            readonly builtin: true;
-        };
-        readonly datetime: {
-            readonly builtin: true;
-        };
-        readonly decimal: {
-            readonly builtin: true;
-        };
-        readonly bytes: {
-            readonly builtin: true;
-        };
-    };
-    readonly enums: {};
-    readonly resources: {
-        readonly authors: {
-            readonly fields: {
-                readonly id: {
-                    readonly kind: "scalar";
-                    readonly type: {
-                        readonly scalar: "string";
-                    };
-                    readonly nullable: false;
-                    readonly list: false;
-                    readonly lifecycle: readonly [];
-                    readonly capabilities: {
-                        readonly select: true;
-                        readonly filter: readonly ["equals"];
-                    };
-                };
-                readonly name: {
-                    readonly capabilities: {
-                        readonly select: true;
-                        readonly filter: readonly ["equals"];
-                        readonly create: readonly [];
-                        readonly update: readonly [];
-                    };
-                    readonly kind: "scalar";
-                    readonly type: {
-                        readonly scalar: "string";
-                    };
-                    readonly nullable: false;
-                    readonly list: false;
-                    readonly lifecycle: readonly [];
-                };
-                readonly secret: {
-                    readonly kind: "scalar";
-                    readonly type: {
-                        readonly scalar: "string";
-                    };
-                    readonly nullable: false;
-                    readonly list: false;
-                    readonly lifecycle: readonly [];
-                    readonly capabilities: {
-                        readonly select: true;
-                        readonly filter: readonly ["equals"];
-                    };
-                };
-            };
-            readonly identifiers: readonly [readonly ["id"]];
-            readonly operations: {
-                readonly find: {
-                    readonly first: true;
-                    readonly unique: true;
-                    readonly many: true;
-                    readonly count: true;
-                };
-                readonly create: {
-                    readonly one: true;
-                    readonly many: true;
-                    readonly count: true;
-                };
-                readonly update: {
-                    readonly first: true;
-                    readonly unique: true;
-                    readonly many: true;
-                    readonly count: true;
-                };
-                readonly delete: {
-                    readonly first: true;
-                    readonly unique: true;
-                    readonly many: true;
-                    readonly count: true;
-                };
-                readonly upsert: {
-                    readonly unique: true;
-                };
-            };
-        };
-        readonly books: {
-            readonly fields: {
-                readonly id: {
-                    readonly kind: "scalar";
-                    readonly type: {
-                        readonly scalar: "string";
-                    };
-                    readonly nullable: false;
-                    readonly list: false;
-                    readonly lifecycle: readonly [];
-                    readonly capabilities: {
-                        readonly select: true;
-                        readonly filter: readonly ["equals"];
-                    };
-                };
-                readonly authorId: {
-                    readonly kind: "scalar";
-                    readonly type: {
-                        readonly scalar: "string";
-                    };
-                    readonly nullable: false;
-                    readonly list: false;
-                    readonly lifecycle: readonly [];
-                    readonly capabilities: {
-                        readonly select: true;
-                        readonly filter: readonly ["equals"];
-                    };
-                };
-            };
-            readonly identifiers: readonly [readonly ["id"]];
-            readonly operations: {
-                readonly find: {
-                    readonly many: true;
-                };
-            };
-        };
-        readonly secrets: {
-            readonly fields: {
-                readonly id: {
-                    readonly kind: "scalar";
-                    readonly type: {
-                        readonly scalar: "string";
-                    };
-                    readonly nullable: false;
-                    readonly list: false;
-                    readonly lifecycle: readonly [];
-                    readonly capabilities: {
-                        readonly select: true;
-                        readonly filter: readonly ["equals"];
-                    };
-                };
-            };
-            readonly identifiers: readonly [readonly ["id"]];
-            readonly operations: {
-                readonly find: {
-                    readonly many: true;
-                };
-            };
-        };
-        readonly hiddenRes: {
-            readonly fields: {
-                readonly id: {
-                    readonly kind: "scalar";
-                    readonly type: {
-                        readonly scalar: "string";
-                    };
-                    readonly nullable: false;
-                    readonly list: false;
-                    readonly lifecycle: readonly [];
-                    readonly capabilities: {
-                        readonly select: true;
-                        readonly filter: readonly ["equals"];
-                    };
-                };
-            };
-            readonly identifiers: readonly [readonly ["id"]];
-            readonly operations: {
-                readonly find: {
-                    readonly many: true;
-                };
-            };
-        };
-        readonly samples: {
-            readonly fields: {
-                readonly id: {
-                    readonly kind: "scalar";
-                    readonly type: {
-                        readonly scalar: "string";
-                    };
-                    readonly nullable: false;
-                    readonly list: false;
-                    readonly lifecycle: readonly [];
-                    readonly capabilities: {
-                        readonly select: true;
-                        readonly filter: readonly ["equals"];
-                    };
-                };
-                readonly count: {
-                    readonly kind: "scalar";
-                    readonly type: {
-                        readonly scalar: "bigint" | "datetime" | "decimal" | "bytes";
-                    };
-                    readonly nullable: false;
-                    readonly list: false;
-                    readonly lifecycle: readonly [];
-                    readonly capabilities: {
-                        readonly select: true;
-                        readonly create: readonly [];
-                    };
-                };
-                readonly at: {
-                    readonly kind: "scalar";
-                    readonly type: {
-                        readonly scalar: "bigint" | "datetime" | "decimal" | "bytes";
-                    };
-                    readonly nullable: false;
-                    readonly list: false;
-                    readonly lifecycle: readonly [];
-                    readonly capabilities: {
-                        readonly select: true;
-                        readonly create: readonly [];
-                    };
-                };
-                readonly amount: {
-                    readonly kind: "scalar";
-                    readonly type: {
-                        readonly scalar: "bigint" | "datetime" | "decimal" | "bytes";
-                    };
-                    readonly nullable: false;
-                    readonly list: false;
-                    readonly lifecycle: readonly [];
-                    readonly capabilities: {
-                        readonly select: true;
-                        readonly create: readonly [];
-                    };
-                };
-                readonly blob: {
-                    readonly kind: "scalar";
-                    readonly type: {
-                        readonly scalar: "bigint" | "datetime" | "decimal" | "bytes";
-                    };
-                    readonly nullable: false;
-                    readonly list: false;
-                    readonly lifecycle: readonly [];
-                    readonly capabilities: {
-                        readonly select: true;
-                        readonly create: readonly [];
-                    };
-                };
-            };
-            readonly identifiers: readonly [readonly ["id"]];
-            readonly operations: {
-                readonly find: {
-                    readonly unique: true;
-                };
-                readonly create: {
-                    readonly one: true;
-                };
-            };
-        };
-    };
-};
-/** Deleting an author cascades into its books (an edge under `books`). */
-export declare const CORPUS_REFERENTIAL_ACTIONS: {
-    readonly books: readonly [{
-        readonly field: "author";
-        readonly target: "authors";
-        readonly references: readonly ["authorId"];
-        readonly onDelete: "cascade";
-    }];
-};
 /**
  * The `where.id` a row sends to make the corpus Framework fail one way:
  *
@@ -314,101 +34,40 @@ declare function corpusGuard(context: AvContext): boolean;
  * `A3004` trigger, and then adds a filter on a field the server does not have.
  */
 declare function corpusPipe(args: unknown): unknown;
-/**
- * The corpus's root `resources` tree: `books.label`, a VIRTUAL field computed on
- * read from `id`.
- */
-export declare const CORPUS_RESOURCES: {
-    readonly books: {
-        readonly fields: {
-            readonly label: {
-                readonly definition: {
-                    readonly type: {
-                        readonly scalar: "string";
-                    };
-                    readonly nullable: false;
-                    readonly list: false;
-                    readonly lifecycle: readonly ["VIRTUAL"];
-                };
-                readonly pipelines: {
-                    readonly compute: {
-                        readonly read: {
-                            readonly dependsOn: readonly ["id"];
-                            readonly compute: ({ record, }: {
-                                readonly record: Readonly<Record<string, unknown>>;
-                            }) => string;
-                        };
-                    };
-                };
-            };
-        };
-    };
-};
-/** The corpus's application layer: `books.label` is the client's only. */
-export declare const CORPUS_APPLICATION_CONFIG: {
-    readonly exposed: true;
-    readonly exemptions: {
-        readonly resources: {
-            readonly books: {
-                readonly fields: {
-                    readonly label: true;
-                };
-            };
-        };
-    };
-};
-/**
- * The corpus's client layer: what the ClientContract hides or restricts, and
- * the client's own guard and pipe.
- */
-export declare const CORPUS_CLIENT_CONFIG: {
-    readonly pipelines: {
-        readonly guards: readonly [typeof corpusGuard];
-        readonly pipes: readonly [typeof corpusPipe];
-    };
-    readonly exposed: true;
-    readonly exemptions: {
-        readonly resources: {
-            readonly authors: {
-                readonly fields: {
-                    readonly secret: true;
-                };
-            };
-            readonly secrets: {
-                readonly operations: {
-                    readonly find: readonly ["many"];
-                };
-            };
-            readonly hiddenRes: true;
-        };
-    };
-};
 /** The corpus Framework's mount point; every row's path is relative to it. */
 export declare const CORPUS_ENTRYPOINT = "/api";
 /**
  * The corpus ClientContract's hash: what a generated client for it sends as
  * `Aventara-Contract-Hash`. A literal, as a generated client holds it.
  */
-export declare const CORPUS_CLIENT_CONTRACT_HASH = "sha256:502530d5b918266c61f45e70035acd7d9637bbf7305c5572106185d5e63ec307";
+export declare const CORPUS_CLIENT_CONTRACT_HASH = "sha256:e0f996802a6a8f1ac9954796ae3f48e0892c9d1a2e691b5cd831098f4b78d7f5";
 /**
  * The corpus ClientContract as `GET /_contract` serves it: its JCS-canonical
  * bytes, `protocol.hash` included. A literal, as a host must serve it byte for
  * byte.
  */
-export declare const CORPUS_CLIENT_CONTRACT_DOCUMENT = "{\"enums\":{},\"limits\":{\"maxBooleanNodes\":50,\"maxJsonDepth\":64,\"maxListLimit\":250,\"maxNestingDepth\":12,\"maxRequestBytes\":1048576,\"maxTransactionOperations\":20},\"protocol\":{\"hash\":\"sha256:502530d5b918266c61f45e70035acd7d9637bbf7305c5572106185d5e63ec307\",\"version\":1},\"resources\":{\"authors\":{\"fields\":{\"id\":{\"capabilities\":{\"filter\":[\"equals\"],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"string\"}},\"name\":{\"capabilities\":{\"create\":[],\"filter\":[\"equals\"],\"select\":true,\"update\":[]},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"string\"}}},\"identifiers\":[[\"id\"]],\"operations\":{\"create\":{\"count\":true,\"many\":true,\"one\":true},\"delete\":{\"count\":true,\"first\":true,\"many\":true,\"unique\":true},\"find\":{\"count\":true,\"first\":true,\"many\":true,\"unique\":true},\"update\":{\"count\":true,\"first\":true,\"many\":true,\"unique\":true},\"upsert\":{\"unique\":true}}},\"books\":{\"fields\":{\"authorId\":{\"capabilities\":{\"filter\":[\"equals\"],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"string\"}},\"id\":{\"capabilities\":{\"filter\":[\"equals\"],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"string\"}},\"label\":{\"capabilities\":{\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[\"COMPUTED_ON_READ\",\"VIRTUAL\"],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"string\"}}},\"identifiers\":[[\"id\"]],\"operations\":{\"find\":{\"many\":true}}},\"samples\":{\"fields\":{\"amount\":{\"capabilities\":{\"create\":[],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"decimal\"}},\"at\":{\"capabilities\":{\"create\":[],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"datetime\"}},\"blob\":{\"capabilities\":{\"create\":[],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"bytes\"}},\"count\":{\"capabilities\":{\"create\":[],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"bigint\"}},\"id\":{\"capabilities\":{\"filter\":[\"equals\"],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"string\"}}},\"identifiers\":[[\"id\"]],\"operations\":{\"create\":{\"one\":true},\"find\":{\"unique\":true}}},\"secrets\":{\"fields\":{\"id\":{\"capabilities\":{\"filter\":[\"equals\"],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"string\"}}},\"identifiers\":[[\"id\"]],\"operations\":{}}},\"scalars\":{\"bigint\":{\"builtin\":true},\"bytes\":{\"builtin\":true},\"datetime\":{\"builtin\":true},\"decimal\":{\"builtin\":true},\"string\":{\"builtin\":true}},\"transactions\":\"interactive\"}";
+export declare const CORPUS_CLIENT_CONTRACT_DOCUMENT = "{\"enums\":{},\"limits\":{\"maxAll\":10,\"maxAllConcurrency\":4,\"maxBooleanNodes\":50,\"maxJsonDepth\":64,\"maxListLimit\":250,\"maxNestingDepth\":12,\"maxRequestBytes\":1048576,\"maxTransactionOperations\":20},\"protocol\":{\"hash\":\"sha256:e0f996802a6a8f1ac9954796ae3f48e0892c9d1a2e691b5cd831098f4b78d7f5\",\"version\":1},\"resources\":{\"authors\":{\"fields\":{\"id\":{\"capabilities\":{\"filter\":[\"equals\"],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"string\"}},\"name\":{\"capabilities\":{\"create\":[],\"filter\":[\"equals\"],\"select\":true,\"update\":[]},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"string\"}}},\"identifiers\":[[\"id\"]],\"operations\":{\"create\":{\"count\":true,\"many\":true,\"one\":true},\"delete\":{\"count\":true,\"first\":true,\"many\":true,\"unique\":true},\"find\":{\"count\":true,\"first\":true,\"many\":true,\"unique\":true},\"update\":{\"count\":true,\"first\":true,\"many\":true,\"unique\":true},\"upsert\":{\"unique\":true}}},\"books\":{\"fields\":{\"authorId\":{\"capabilities\":{\"filter\":[\"equals\"],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"string\"}},\"id\":{\"capabilities\":{\"filter\":[\"equals\"],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"string\"}},\"label\":{\"capabilities\":{\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[\"COMPUTED_ON_READ\",\"VIRTUAL\"],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"string\"}}},\"identifiers\":[[\"id\"]],\"operations\":{\"find\":{\"many\":true}}},\"samples\":{\"fields\":{\"amount\":{\"capabilities\":{\"create\":[],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"decimal\"}},\"at\":{\"capabilities\":{\"create\":[],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"datetime\"}},\"blob\":{\"capabilities\":{\"create\":[],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"bytes\"}},\"count\":{\"capabilities\":{\"create\":[],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"bigint\"}},\"id\":{\"capabilities\":{\"filter\":[\"equals\"],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"string\"}}},\"identifiers\":[[\"id\"]],\"operations\":{\"create\":{\"one\":true},\"find\":{\"unique\":true}}},\"secrets\":{\"fields\":{\"id\":{\"capabilities\":{\"filter\":[\"equals\"],\"select\":true},\"kind\":\"scalar\",\"lifecycle\":[],\"list\":false,\"nullable\":false,\"type\":{\"scalar\":\"string\"}}},\"identifiers\":[[\"id\"]],\"operations\":{}}},\"scalars\":{\"bigint\":{\"builtin\":true},\"bytes\":{\"builtin\":true},\"datetime\":{\"builtin\":true},\"decimal\":{\"builtin\":true},\"string\":{\"builtin\":true}},\"transactions\":\"interactive\"}";
 /**
  * The hash of the corpus's second ClientContract: the same model and
  * configuration with `transactions: "none"` (the `/_transactions` absence
  * rows). A row targets it by sending this hash, exactly as a client generated
  * against it would.
  */
-export declare const CORPUS_NONE_CLIENT_CONTRACT_HASH = "sha256:5e99809294a2aae922b635e9a44b464b1b6e03359a54d30420292c62676a7ce5";
+export declare const CORPUS_NONE_CLIENT_CONTRACT_HASH = "sha256:34a73fd521d186350252a9bf905a9a627465f8267e0051ba4efe0441510e164a";
 /**
  * The hash of the corpus's third ClientContract: the same model and
  * configuration with the framework's `access` option ({@link CORPUS_ACCESS}),
  * so it carries the `access` section and its `POST /_access/can` route.
  */
-export declare const CORPUS_ACCESS_CLIENT_CONTRACT_HASH = "sha256:e45cdbc0c5f27e94058a1e0a1e4b9e532522ebeddcbb68170ac6ec6b45ca0d23";
+export declare const CORPUS_ACCESS_CLIENT_CONTRACT_HASH = "sha256:ee098756b61a2081f92c7c065816c9f77782561aef572c117d2ee7e18389db0b";
+/**
+ * The hash of the corpus's fourth ClientContract: the same model and
+ * configuration with `cache` stages on reads ({@link CORPUS_CACHE_RESOURCES}),
+ * so it marks them cacheable and serves each a `GET` route. A cached-read row
+ * targets it by sending this hash as its query's `v`, exactly as a client
+ * generated against it would.
+ */
+export declare const CORPUS_CACHE_CLIENT_CONTRACT_HASH = "sha256:d82386747eef41809c28721bc513e70db59884b5bd85ca1535038ce32127fd99";
 /** The one record the corpus Adapter knows. */
 export declare const CORPUS_AUTHOR: {
     readonly id: "a1";
@@ -416,61 +75,13 @@ export declare const CORPUS_AUTHOR: {
 };
 /** The `where.id` that matches nothing. */
 export declare const CORPUS_NOBODY = "nobody";
-/**
- * The one `samples` record, in runtime forms — what an Adapter hands core, and
- * what the HTTP encoders must spell in wire forms.
- */
-export declare const CORPUS_SAMPLE: {
-    readonly id: "s1";
-    readonly count: 9007199254740993n;
-    readonly at: Date;
-    readonly amount: AvDecimal;
-    readonly blob: Uint8Array<ArrayBuffer>;
-};
-/**
- * The corpus's access provider, behind {@link CORPUS_ACCESS_CLIENT_CONTRACT_HASH}:
- * every request is anonymous (`me: null`, the same through every host), and its
- * policy answers by the question alone, never by a row. Every operation is
- * allowed, every row is in scope, every field readable, except: no `authors`
- * row is in the delete scope; a question about `books` is refused by an
- * `AvError` the engine throws; and any question about `samples` is the engine's
- * own defect.
- */
-export declare const CORPUS_ACCESS: {
-    state: () => {
-        me: null;
-    };
-    policy: {
-        can: ({ resource }: {
-            readonly principal: unknown;
-            readonly origin: import("@aventara/core").AvRequestOrigin;
-            readonly resource: string;
-        } & {
-            readonly action: "read" | "create" | "update" | "delete";
-            readonly row?: Readonly<Record<string, unknown>>;
-            readonly before?: Readonly<Record<string, unknown>>;
-            readonly beforeGrants?: readonly string[];
-            readonly exists: (resource: string, where: import("@aventara/core").AvPolicyWhere) => Promise<boolean>;
-        }) => true;
-        scopeOf: ({ resource, action }: {
-            readonly principal: unknown;
-            readonly origin: import("@aventara/core").AvRequestOrigin;
-            readonly resource: string;
-        } & {
-            readonly action: "read" | "update" | "delete";
-        }) => boolean;
-        fieldsOf: () => {
-            always: "all";
-            perRow: {};
-        };
-    };
-};
 /**
  * The corpus Framework's configuration, over a fresh corpus Adapter, and the
  * count of operations that Adapter has been handed so far. `contractHash`
  * selects which corpus ClientContract it compiles to: the `transactions:
  * "none"` one when it is {@link CORPUS_NONE_CLIENT_CONTRACT_HASH}, the one with
- * `access` when it is {@link CORPUS_ACCESS_CLIENT_CONTRACT_HASH}, the main one
+ * `access` when it is {@link CORPUS_ACCESS_CLIENT_CONTRACT_HASH}, the one with
+ * cached reads when it is {@link CORPUS_CACHE_CLIENT_CONTRACT_HASH}, the main one
  * otherwise (a stale or absent hash included).
  */
 export declare function corpusConfiguration(contractHash?: string): {

package/dist/protocol/corpus-contract.fixture.js

@@ -1,4 +1,4 @@
-import { AvDecimal, AvError, createFramework } from "@aventara/core";
+import { AvDecimal, AvError, cache, createFramework } from "@aventara/core";
 import { createFakeAdapter } from "../adapters/fake-adapter.js";
 const identityString = {
     kind: "scalar",
@@ -26,7 +26,7 @@ const wired = (scalar) => ({
     capabilities: { select: true, create: [] },
 });
 const findMany = { find: { many: true } };
-export const CORPUS_MODEL = {
+const CORPUS_MODEL = {
     transactions: "interactive",
     scalars: {
         string: { builtin: true },
@@ -80,7 +80,7 @@ export const CORPUS_MODEL = {
         },
     },
 };
-export const CORPUS_REFERENTIAL_ACTIONS = {
+const CORPUS_REFERENTIAL_ACTIONS = {
     books: [
         {
             field: "author",
@@ -133,7 +133,7 @@ function corpusPipe(args) {
     const record = args;
     return { ...record, where: { ...record.where, nope: "x" } };
 }
-export const CORPUS_RESOURCES = {
+const CORPUS_RESOURCES = {
     books: {
         fields: {
             label: {
@@ -155,11 +155,32 @@ export const CORPUS_RESOURCES = {
         },
     },
 };
-export const CORPUS_APPLICATION_CONFIG = {
+const CORPUS_CACHE_RESOURCES = {
+    ...CORPUS_RESOURCES,
+    authors: {
+        pipelines: { cache: cache({ for: "user", maxAge: 60 }) },
+        operations: {
+            find: {
+                first: {
+                    pipelines: { cache: cache({ for: "anonymous", maxAge: 30 }) },
+                },
+            },
+        },
+    },
+    books: {
+        ...CORPUS_RESOURCES.books,
+        operations: {
+            find: {
+                many: { pipelines: { cache: cache({ for: "everyone", maxAge: 300 }) } },
+            },
+        },
+    },
+};
+const CORPUS_APPLICATION_CONFIG = {
     exposed: true,
     exemptions: { resources: { books: { fields: { label: true } } } },
 };
-export const CORPUS_CLIENT_CONFIG = {
+const CORPUS_CLIENT_CONFIG = {
     pipelines: { guards: [corpusGuard], pipes: [corpusPipe] },
     exposed: true,
     exemptions: {
@@ -171,13 +192,14 @@ export const CORPUS_CLIENT_CONFIG = {
     },
 };
 export const CORPUS_ENTRYPOINT = "/api";
-export const CORPUS_CLIENT_CONTRACT_HASH = "sha256:502530d5b918266c61f45e70035acd7d9637bbf7305c5572106185d5e63ec307";
-export const CORPUS_CLIENT_CONTRACT_DOCUMENT = '{"enums":{},"limits":{"maxBooleanNodes":50,"maxJsonDepth":64,"maxListLimit":250,"maxNestingDepth":12,"maxRequestBytes":1048576,"maxTransactionOperations":20},"protocol":{"hash":"sha256:502530d5b918266c61f45e70035acd7d9637bbf7305c5572106185d5e63ec307","version":1},"resources":{"authors":{"fields":{"id":{"capabilities":{"filter":["equals"],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"string"}},"name":{"capabilities":{"create":[],"filter":["equals"],"select":true,"update":[]},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"string"}}},"identifiers":[["id"]],"operations":{"create":{"count":true,"many":true,"one":true},"delete":{"count":true,"first":true,"many":true,"unique":true},"find":{"count":true,"first":true,"many":true,"unique":true},"update":{"count":true,"first":true,"many":true,"unique":true},"upsert":{"unique":true}}},"books":{"fields":{"authorId":{"capabilities":{"filter":["equals"],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"string"}},"id":{"capabilities":{"filter":["equals"],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"string"}},"label":{"capabilities":{"select":true},"kind":"scalar","lifecycle":["COMPUTED_ON_READ","VIRTUAL"],"list":false,"nullable":false,"type":{"scalar":"string"}}},"identifiers":[["id"]],"operations":{"find":{"many":true}}},"samples":{"fields":{"amount":{"capabilities":{"create":[],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"decimal"}},"at":{"capabilities":{"create":[],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"datetime"}},"blob":{"capabilities":{"create":[],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"bytes"}},"count":{"capabilities":{"create":[],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"bigint"}},"id":{"capabilities":{"filter":["equals"],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"string"}}},"identifiers":[["id"]],"operations":{"create":{"one":true},"find":{"unique":true}}},"secrets":{"fields":{"id":{"capabilities":{"filter":["equals"],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"string"}}},"identifiers":[["id"]],"operations":{}}},"scalars":{"bigint":{"builtin":true},"bytes":{"builtin":true},"datetime":{"builtin":true},"decimal":{"builtin":true},"string":{"builtin":true}},"transactions":"interactive"}';
-export const CORPUS_NONE_CLIENT_CONTRACT_HASH = "sha256:5e99809294a2aae922b635e9a44b464b1b6e03359a54d30420292c62676a7ce5";
-export const CORPUS_ACCESS_CLIENT_CONTRACT_HASH = "sha256:e45cdbc0c5f27e94058a1e0a1e4b9e532522ebeddcbb68170ac6ec6b45ca0d23";
+export const CORPUS_CLIENT_CONTRACT_HASH = "sha256:e0f996802a6a8f1ac9954796ae3f48e0892c9d1a2e691b5cd831098f4b78d7f5";
+export const CORPUS_CLIENT_CONTRACT_DOCUMENT = '{"enums":{},"limits":{"maxAll":10,"maxAllConcurrency":4,"maxBooleanNodes":50,"maxJsonDepth":64,"maxListLimit":250,"maxNestingDepth":12,"maxRequestBytes":1048576,"maxTransactionOperations":20},"protocol":{"hash":"sha256:e0f996802a6a8f1ac9954796ae3f48e0892c9d1a2e691b5cd831098f4b78d7f5","version":1},"resources":{"authors":{"fields":{"id":{"capabilities":{"filter":["equals"],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"string"}},"name":{"capabilities":{"create":[],"filter":["equals"],"select":true,"update":[]},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"string"}}},"identifiers":[["id"]],"operations":{"create":{"count":true,"many":true,"one":true},"delete":{"count":true,"first":true,"many":true,"unique":true},"find":{"count":true,"first":true,"many":true,"unique":true},"update":{"count":true,"first":true,"many":true,"unique":true},"upsert":{"unique":true}}},"books":{"fields":{"authorId":{"capabilities":{"filter":["equals"],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"string"}},"id":{"capabilities":{"filter":["equals"],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"string"}},"label":{"capabilities":{"select":true},"kind":"scalar","lifecycle":["COMPUTED_ON_READ","VIRTUAL"],"list":false,"nullable":false,"type":{"scalar":"string"}}},"identifiers":[["id"]],"operations":{"find":{"many":true}}},"samples":{"fields":{"amount":{"capabilities":{"create":[],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"decimal"}},"at":{"capabilities":{"create":[],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"datetime"}},"blob":{"capabilities":{"create":[],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"bytes"}},"count":{"capabilities":{"create":[],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"bigint"}},"id":{"capabilities":{"filter":["equals"],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"string"}}},"identifiers":[["id"]],"operations":{"create":{"one":true},"find":{"unique":true}}},"secrets":{"fields":{"id":{"capabilities":{"filter":["equals"],"select":true},"kind":"scalar","lifecycle":[],"list":false,"nullable":false,"type":{"scalar":"string"}}},"identifiers":[["id"]],"operations":{}}},"scalars":{"bigint":{"builtin":true},"bytes":{"builtin":true},"datetime":{"builtin":true},"decimal":{"builtin":true},"string":{"builtin":true}},"transactions":"interactive"}';
+export const CORPUS_NONE_CLIENT_CONTRACT_HASH = "sha256:34a73fd521d186350252a9bf905a9a627465f8267e0051ba4efe0441510e164a";
+export const CORPUS_ACCESS_CLIENT_CONTRACT_HASH = "sha256:ee098756b61a2081f92c7c065816c9f77782561aef572c117d2ee7e18389db0b";
+export const CORPUS_CACHE_CLIENT_CONTRACT_HASH = "sha256:d82386747eef41809c28721bc513e70db59884b5bd85ca1535038ce32127fd99";
 export const CORPUS_AUTHOR = { id: "a1", name: "Ada" };
 export const CORPUS_NOBODY = "nobody";
-export const CORPUS_SAMPLE = {
+const CORPUS_SAMPLE = {
     id: "s1",
     count: 9007199254740993n,
     at: new Date("2026-10-05T12:34:56.789Z"),
@@ -222,7 +244,7 @@ function corpusAnswer(operation) {
     }
     return CORPUS_AUTHOR;
 }
-export const CORPUS_ACCESS = {
+const CORPUS_ACCESS = {
     state: () => ({ me: null }),
     policy: {
         can: ({ resource }) => {
@@ -272,7 +294,9 @@ export function corpusConfiguration(contractHash) {
         config: {
             api: CORPUS_ENTRYPOINT,
             adapter,
-            resources: CORPUS_RESOURCES,
+            resources: contractHash === CORPUS_CACHE_CLIENT_CONTRACT_HASH
+                ? CORPUS_CACHE_RESOURCES
+                : CORPUS_RESOURCES,
             application: CORPUS_APPLICATION_CONFIG,
             client: CORPUS_CLIENT_CONFIG,
             ...(contractHash === CORPUS_ACCESS_CLIENT_CONTRACT_HASH