@palbase/backend 25.1.0 → 27.0.0

package/dist/test/index.d.cts

@@ -1,6 +1,9 @@
-import { D as DBClient } from '../endpoint-DYHMo6cC.cjs';
-import 'zod';
+import { T as Token } from '../module-Dl1KFVtc.cjs';
+import { D as DBClient } from '../index-Bve7BBTL.cjs';
+import '../db/env.cjs';
 import '../stack.cjs';
+import 'zod';
+import 'node:async_hooks';
 
 /** The client a tenant's tests use to call their own backend.
  *
@@ -130,7 +133,30 @@ interface TestApi {
 declare function createTestApi(config: TestApiConfig): TestApi;
 declare const api: TestApi;
 
-/** One `Database.query(...)` call, as the service made it. */
+interface IsolatedContainer {
+    /** Substitutes a token. Chainable; the last write for a token wins. */
+    with<T>(t: Token<T>, v: T): IsolatedContainer;
+    get<T>(t: Token<T>): T;
+}
+/**
+ * How a test replaces a dependency.
+ *
+ * Rebuilds the graph with the overrides in place and never touches the process
+ * singleton cache, so the next test in the same process does not meet a doubled
+ * instance left behind by this one. Substitution is DEEP: `Report` asks for
+ * `Money` and gets whatever the graph was rebuilt with, however many hops down.
+ *
+ * Substitution is by `with` alone — there is no separate platform map, because
+ * platform services are ambient rather than injected (FR-005).
+ *
+ * Module boundaries are NOT enforced here, deliberately. They are a build-time
+ * rule about the shipped application; making a unit test fail on them would
+ * force every test to restate a module layout it is not testing. What a test
+ * gets is a graph, not a second opinion about the architecture.
+ */
+declare function isolated(): IsolatedContainer;
+
+/** One `Database.$query(...)` call, as the service made it. */
 interface RecordedQuery {
     sql: string;
     params: unknown[];
@@ -152,4 +178,4 @@ interface FakeDatabase {
 }
 declare function fakeDatabase(): FakeDatabase;
 
-export { type CallOptions, type ErrorEnvelope, type FakeDatabase, type RecordedQuery, type RecordedRequest, type TestApi, type TestApiConfig, TestApiError, type TestIdentity, api, createTestApi, fakeDatabase };
+export { type CallOptions, type ErrorEnvelope, type FakeDatabase, type IsolatedContainer, type RecordedQuery, type RecordedRequest, type TestApi, type TestApiConfig, TestApiError, type TestIdentity, api, createTestApi, fakeDatabase, isolated };

package/dist/test/index.d.ts

@@ -1,6 +1,9 @@
-import { D as DBClient } from '../endpoint-CTEHhb7A.js';
-import 'zod';
+import { T as Token } from '../module-Dl1KFVtc.js';
+import { D as DBClient } from '../index-BrvvxSpn.js';
+import '../db/env.js';
 import '../stack.js';
+import 'zod';
+import 'node:async_hooks';
 
 /** The client a tenant's tests use to call their own backend.
  *
@@ -130,7 +133,30 @@ interface TestApi {
 declare function createTestApi(config: TestApiConfig): TestApi;
 declare const api: TestApi;
 
-/** One `Database.query(...)` call, as the service made it. */
+interface IsolatedContainer {
+    /** Substitutes a token. Chainable; the last write for a token wins. */
+    with<T>(t: Token<T>, v: T): IsolatedContainer;
+    get<T>(t: Token<T>): T;
+}
+/**
+ * How a test replaces a dependency.
+ *
+ * Rebuilds the graph with the overrides in place and never touches the process
+ * singleton cache, so the next test in the same process does not meet a doubled
+ * instance left behind by this one. Substitution is DEEP: `Report` asks for
+ * `Money` and gets whatever the graph was rebuilt with, however many hops down.
+ *
+ * Substitution is by `with` alone — there is no separate platform map, because
+ * platform services are ambient rather than injected (FR-005).
+ *
+ * Module boundaries are NOT enforced here, deliberately. They are a build-time
+ * rule about the shipped application; making a unit test fail on them would
+ * force every test to restate a module layout it is not testing. What a test
+ * gets is a graph, not a second opinion about the architecture.
+ */
+declare function isolated(): IsolatedContainer;
+
+/** One `Database.$query(...)` call, as the service made it. */
 interface RecordedQuery {
     sql: string;
     params: unknown[];
@@ -152,4 +178,4 @@ interface FakeDatabase {
 }
 declare function fakeDatabase(): FakeDatabase;
 
-export { type CallOptions, type ErrorEnvelope, type FakeDatabase, type RecordedQuery, type RecordedRequest, type TestApi, type TestApiConfig, TestApiError, type TestIdentity, api, createTestApi, fakeDatabase };
+export { type CallOptions, type ErrorEnvelope, type FakeDatabase, type IsolatedContainer, type RecordedQuery, type RecordedRequest, type TestApi, type TestApiConfig, TestApiError, type TestIdentity, api, createTestApi, fakeDatabase, isolated };