@voltro/testing 0.69.1 → 0.71.0

package/dist/index.d.ts

@@ -15,6 +15,8 @@ import { Layer } from 'effect';
 import { ParseResult } from 'effect';
 import { ProcedureDescriptor } from '@voltro/protocol';
 import { PublicApiDescriptor } from '@voltro/protocol/rest';
+import { PublicApiProfileConfig } from '@voltro/protocol';
+import { PublicApiSpec } from '@voltro/protocol';
 import { RelationsSpec } from '@voltro/database';
 import { RestRouteDescriptor } from '@voltro/protocol/rest';
 import { RestServeBindings } from '@voltro/protocol/rest';
@@ -344,6 +346,9 @@ export declare interface MakeTestAppOptions {
     /** HTTP idempotency binding — the same `{ store, header, ttlMs }` the serve
      *  path builds from `app.config.ts`'s `idempotency` field. */
     readonly idempotency?: RestServeBindings['idempotency'];
+    /** The api's `publicApi:` config — the REST profile the projections speak,
+     *  the same object `app.config.ts` declares. Absent → `'rpc'`. */
+    readonly publicApiProfile?: PublicApiProfileConfig;
 }
 
 export declare const makeTestContext: <RowFilterCtx = unknown>(options?: MakeTestContextOptions<RowFilterCtx>) => TestContext;
@@ -417,6 +422,15 @@ export declare interface MakeTestContextOptions<RowFilterCtx = unknown> {
      *  test harness never runs the real boot gate. Merged OVER `process.env`
      *  (these win). Default: just the ambient `process.env`. */
     readonly env?: Record<string, string | undefined>;
+    /**
+     * The key for `.encrypted()` columns under test. Registers the field cipher
+     * the boot would derive from `VOLTRO_FIELD_ENCRYPTION_KEY`, so a handler that
+     * writes such a column runs here instead of failing with "no field cipher is
+     * registered". Process-global like the boot's (`setFieldCipher`), and left
+     * alone when omitted — `env` alone does NOT do this: the harness runs no boot
+     * gate, and the gate is what turns the variable into a cipher.
+     */
+    readonly fieldEncryptionKey?: string;
     /**
      * Plugins whose rpc interceptors (`interceptMutation` / `interceptQuery` /
      * `interceptAction`) wrap every `invoke` on this context — the same list an
@@ -491,6 +505,8 @@ export declare interface MakeWorkflowRunnerOptions {
     readonly workflows?: ReadonlyArray<WorkflowEntry>;
 }
 
+export declare const markRestInvocation: (ctx: TestContext, publicApi: PublicApiSpec) => void;
+
 /** Minimal AI mock surface. The full `mockAi({...})` helper is owned by
  *  the AI package (plan 05); typed here as an optional injected interface
  *  so `@voltro/testing` carries no hard `@voltro/ai` dependency. */
@@ -601,6 +617,11 @@ export declare const outboxNudgesOf: (ctx: TestContext) => ReadonlyArray<string>
 
 export { ParseResult }
 
+/** The plugins a context was built with — for the REST harness, which hands
+ *  their cross-cutting errors to the `publicApi` projection the way both boot
+ *  paths do. */
+export declare const pluginsOf: (ctx: TestContext) => ReadonlyArray<VoltroPlugin>;
+
 /** Any procedure executor: takes the DECODED input + a context, returns a
  *  result — sync, `Promise`, or `Effect`. Mirrors the `(input, ctx) => …` shape
  *  a real query / mutation / action handler has, INCLUDING the Effect form: the
@@ -669,6 +690,10 @@ export declare const reportEngineVersion: (label: string, probe: () => Promise<s
  */
 export declare const resetAfterCommit: (ctx: TestContext) => void;
 
+export declare const restInvocationOf: (ctx: TestContext) => {
+    readonly publicApi: PublicApiSpec;
+} | undefined;
+
 export { Row }
 
 /**