@dudousxd/nestjs-durable-testing 0.6.0 → 0.7.1

package/dist/index.d.ts

@@ -1,4 +1,21 @@
-import { StateStore, RunStatus, WorkflowEngine, InMemoryStateStore, InMemoryTransport, RunResult, WorkflowRef, StartOptions, WorkflowRun, StepCheckpoint, Transport } from '@dudousxd/nestjs-durable-core';
+import { AdmissionBackend, StateStore, RunStatus, WorkflowEngine, InMemoryStateStore, InMemoryTransport, RunResult, WorkflowRef, StartOptions, WorkflowRun, StepCheckpoint, Transport } from '@dudousxd/nestjs-durable-core';
+
+/**
+ * Builds an {@link AdmissionBackend} bound to the given test clock. Implementations that hold their
+ * own resources (e.g. a Redis connection) should register the instance for teardown out-of-band.
+ */
+type AdmissionBackendFactory = (clock: () => number) => AdmissionBackend;
+/**
+ * The SHARED cross-backend behavioural contract for the flow-control admission gate. Both the
+ * in-process `InMemoryAdmissionBackend` and the Redis `RedisAdmissionBackend` run it, so their
+ * concurrency / rate-limit / ordering semantics can never silently drift apart — backend-specific
+ * concerns (leases, pub/sub, cross-pod globality) live in each adapter's own spec.
+ *
+ * The engine always passes a stable `waiterId`, so every gated call is order-tracked: ties with no
+ * priority/fairness fall back to arrival FIFO (or LIFO when configured). These cases assert exactly
+ * that, on ONE backend instance.
+ */
+declare function runAdmissionBackendContract(name: string, makeBackend: AdmissionBackendFactory): void;
 
 declare function assertRunStatus(store: StateStore, runId: string, status: RunStatus): Promise<void>;
 declare function assertOutput(store: StateStore, runId: string, expected: unknown): Promise<void>;
@@ -215,4 +232,4 @@ type HandleableTransport = Transport & {
  */
 declare function assertTransportConformance(transport: HandleableTransport, idPrefix?: string): Promise<void>;
 
-export { DURABLE_CANONICAL_COLUMNS, type DurableColumnMap, type DurableColumnMismatch, type HandleableTransport, MutableClock, type RunHistory, type StateStoreContext, type StateStoreFactory, StateStoreUnavailableError, type TestEngine, assertDurableColumns, assertOutput, assertReplayable, assertRunStatus, assertStepAttempts, assertStepsRan, assertTransportConformance, createTestEngine, failOnce, failTimes, preserveColumnExpectation, recordedSteps, runStateStoreContract };
+export { type AdmissionBackendFactory, DURABLE_CANONICAL_COLUMNS, type DurableColumnMap, type DurableColumnMismatch, type HandleableTransport, MutableClock, type RunHistory, type StateStoreContext, type StateStoreFactory, StateStoreUnavailableError, type TestEngine, assertDurableColumns, assertOutput, assertReplayable, assertRunStatus, assertStepAttempts, assertStepsRan, assertTransportConformance, createTestEngine, failOnce, failTimes, preserveColumnExpectation, recordedSteps, runAdmissionBackendContract, runStateStoreContract };