@palbase/backend 30.0.0 → 32.0.0

package/dist/test/index.d.cts

@@ -1,5 +1,5 @@
 import { T as Token } from '../module-Dl1KFVtc.cjs';
-import { D as DBClient } from '../index-DtCgaZAg.cjs';
+import { E as EnvServiceDatabase, D as DBClient, a as RuntimeServices } from '../index-DgYkdNT9.cjs';
 import '../db/env.cjs';
 import '../stack.cjs';
 import 'zod';
@@ -163,8 +163,26 @@ interface RecordedQuery {
 }
 /** What a service-layer test is handed. */
 interface FakeDatabase {
-    /** Pass this where the service expects `Database`. */
-    db: DBClient;
+    /** Pass this where the service expects `Database`.
+     *
+     * Built with the SAME constructor the production `Database` uses
+     * (`makeTypedSurface`), so the fake's surface cannot drift from the real one
+     * — including the `$`-prefixed raw ops and the typed `public` schema surface. */
+    db: EnvServiceDatabase;
+    /**
+     * The RAW `DBClient` behind {@link FakeDatabase.db} (FR-028).
+     *
+     * `RuntimeServices.Database` is the raw client — the ambient `Database`
+     * singleton is what WRAPS it with `makeTypedSurface`. So a test that installs
+     * the fake as the ambient runtime passes THIS:
+     *
+     *   withServices({ Database: fake.raw }, () => …)
+     *
+     * Passing `db` there would wrap an already-wrapped surface and every `$op`
+     * would miss (measured). Two fields because there are two call sites: `db`
+     * goes straight to a service, `raw` goes into the runtime.
+     */
+    raw: DBClient;
     /** Every `query()` call, in order. */
     queries: readonly RecordedQuery[];
     /** Put rows in a table before the code under test runs. */
@@ -178,4 +196,41 @@ interface FakeDatabase {
 }
 declare function fakeDatabase(): 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 };
+/**
+ * `withServices()` — run code with only the platform services a test supplies.
+ *
+ * WHY IT IS PUBLIC. `isolated()` substitutes CONSTRUCTOR dependencies, and its
+ * own documentation says why it cannot help here: "platform services are
+ * ambient rather than injected". So the repository layer — the one place that
+ * really does `import { Database } from "@palbase/backend"` — had no supported
+ * way to be unit-tested, while `__runWithRuntime` demands EVERY service. A
+ * measured consumer project wrote this helper by hand, exploding proxies
+ * included, and 30.0.0 then added a tenth required service (`Auth`) which broke
+ * that hand-written copy. Shipping it here is what stops that from recurring.
+ *
+ * WHAT IS ABSENT IS LOUD. An unsupplied service is neither `undefined` nor a
+ * silent no-op: touching it throws and NAMES itself, so a test that quietly
+ * grew a dependency on `Cache` fails saying "Cache", not "cannot read
+ * properties of undefined".
+ *
+ * SCOPE IS THE REQUEST ALS, never the process-global slot. Two tests in one
+ * file must not be able to see each other's services, and a helper that wrote
+ * the global slot would leak the first test's fake into the second.
+ *
+ * EKSİKSİZLİK DERLEYİCİYE SORULUR, BİR LİSTEYE DEĞİL. İlk yazımı servis
+ * adlarını bir diziye koyup `satisfies readonly (keyof RuntimeServices)[]` ile
+ * pinliyordu — ama `satisfies` yalnız "her ELEMAN bir anahtar mı" diye bakar,
+ * "her ANAHTAR listede mi" diye BAKMAZ. Ölçüldü: `RuntimeServices`'a on birinci
+ * bir servis eklenip liste dokunulmadan bırakıldığında `tsc --strict` TEMİZ
+ * derliyor, ve eksik servise erişen tüketici `TypeError: Reflect.get called on
+ * non-object` alıyor — ne servisin adı, ne çaresi. Yani bu dosyanın var olma
+ * sebebi olan kusurun ta kendisi, bu dosya tarafından üretiliyordu.
+ *
+ * Şimdi `filled` düz bir `RuntimeServices` nesne literali: bir alan eksik
+ * kalırsa TypeScript `TS2741: Property '<ad>' is missing` diyor ve derleme
+ * durur. `as unknown as` yok.
+ */
+
+declare function withServices<T>(services: Partial<RuntimeServices>, fn: () => T): T;
+
+export { type CallOptions, type ErrorEnvelope, type FakeDatabase, type IsolatedContainer, type RecordedQuery, type RecordedRequest, type TestApi, type TestApiConfig, TestApiError, type TestIdentity, api, createTestApi, fakeDatabase, isolated, withServices };

package/dist/test/index.d.ts

@@ -1,5 +1,5 @@
 import { T as Token } from '../module-Dl1KFVtc.js';
-import { D as DBClient } from '../index-8qy3kIuA.js';
+import { E as EnvServiceDatabase, D as DBClient, a as RuntimeServices } from '../index-BgWnP07a.js';
 import '../db/env.js';
 import '../stack.js';
 import 'zod';
@@ -163,8 +163,26 @@ interface RecordedQuery {
 }
 /** What a service-layer test is handed. */
 interface FakeDatabase {
-    /** Pass this where the service expects `Database`. */
-    db: DBClient;
+    /** Pass this where the service expects `Database`.
+     *
+     * Built with the SAME constructor the production `Database` uses
+     * (`makeTypedSurface`), so the fake's surface cannot drift from the real one
+     * — including the `$`-prefixed raw ops and the typed `public` schema surface. */
+    db: EnvServiceDatabase;
+    /**
+     * The RAW `DBClient` behind {@link FakeDatabase.db} (FR-028).
+     *
+     * `RuntimeServices.Database` is the raw client — the ambient `Database`
+     * singleton is what WRAPS it with `makeTypedSurface`. So a test that installs
+     * the fake as the ambient runtime passes THIS:
+     *
+     *   withServices({ Database: fake.raw }, () => …)
+     *
+     * Passing `db` there would wrap an already-wrapped surface and every `$op`
+     * would miss (measured). Two fields because there are two call sites: `db`
+     * goes straight to a service, `raw` goes into the runtime.
+     */
+    raw: DBClient;
     /** Every `query()` call, in order. */
     queries: readonly RecordedQuery[];
     /** Put rows in a table before the code under test runs. */
@@ -178,4 +196,41 @@ interface FakeDatabase {
 }
 declare function fakeDatabase(): 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 };
+/**
+ * `withServices()` — run code with only the platform services a test supplies.
+ *
+ * WHY IT IS PUBLIC. `isolated()` substitutes CONSTRUCTOR dependencies, and its
+ * own documentation says why it cannot help here: "platform services are
+ * ambient rather than injected". So the repository layer — the one place that
+ * really does `import { Database } from "@palbase/backend"` — had no supported
+ * way to be unit-tested, while `__runWithRuntime` demands EVERY service. A
+ * measured consumer project wrote this helper by hand, exploding proxies
+ * included, and 30.0.0 then added a tenth required service (`Auth`) which broke
+ * that hand-written copy. Shipping it here is what stops that from recurring.
+ *
+ * WHAT IS ABSENT IS LOUD. An unsupplied service is neither `undefined` nor a
+ * silent no-op: touching it throws and NAMES itself, so a test that quietly
+ * grew a dependency on `Cache` fails saying "Cache", not "cannot read
+ * properties of undefined".
+ *
+ * SCOPE IS THE REQUEST ALS, never the process-global slot. Two tests in one
+ * file must not be able to see each other's services, and a helper that wrote
+ * the global slot would leak the first test's fake into the second.
+ *
+ * EKSİKSİZLİK DERLEYİCİYE SORULUR, BİR LİSTEYE DEĞİL. İlk yazımı servis
+ * adlarını bir diziye koyup `satisfies readonly (keyof RuntimeServices)[]` ile
+ * pinliyordu — ama `satisfies` yalnız "her ELEMAN bir anahtar mı" diye bakar,
+ * "her ANAHTAR listede mi" diye BAKMAZ. Ölçüldü: `RuntimeServices`'a on birinci
+ * bir servis eklenip liste dokunulmadan bırakıldığında `tsc --strict` TEMİZ
+ * derliyor, ve eksik servise erişen tüketici `TypeError: Reflect.get called on
+ * non-object` alıyor — ne servisin adı, ne çaresi. Yani bu dosyanın var olma
+ * sebebi olan kusurun ta kendisi, bu dosya tarafından üretiliyordu.
+ *
+ * Şimdi `filled` düz bir `RuntimeServices` nesne literali: bir alan eksik
+ * kalırsa TypeScript `TS2741: Property '<ad>' is missing` diyor ve derleme
+ * durur. `as unknown as` yok.
+ */
+
+declare function withServices<T>(services: Partial<RuntimeServices>, fn: () => T): T;
+
+export { type CallOptions, type ErrorEnvelope, type FakeDatabase, type IsolatedContainer, type RecordedQuery, type RecordedRequest, type TestApi, type TestApiConfig, TestApiError, type TestIdentity, api, createTestApi, fakeDatabase, isolated, withServices };

package/dist/test/index.js

@@ -1,3 +1,7 @@
+import {
+  __requestALS,
+  makeTypedSurface
+} from "../chunk-XEGZ3S2Q.js";
 import {
   assertNoExpressionHandles,
   assertUsableFilter,
@@ -7,10 +11,10 @@ import {
   isColumnExpr,
   isNowExpr,
   isSqlFragment
-} from "../chunk-3TUJWHC2.js";
+} from "../chunk-IXAX5CON.js";
 import {
   __name
-} from "../chunk-VXPNPVAG.js";
+} from "../chunk-KATPXCJ5.js";
 
 // ../core/dist/index.js
 var CACHE_TTL_MS = 5 * 60 * 1e3;
@@ -624,7 +628,7 @@ function createMockDB() {
           const vals = bucket.map((r) => r[c]).filter((v) => v !== null && v !== void 0);
           (out["avg"] ??= {})[c] = vals.length === 0 ? null : String(Number(vals.reduce((a, v) => addDecimal(a, v, 1), "0")) / vals.length);
         }
-        for (const [fn, pick] of [
+        for (const [fn, pick2] of [
           [
             "min",
             -1
@@ -636,7 +640,7 @@ function createMockDB() {
         ]) {
           for (const c of q[fn] ?? []) {
             const vals = bucket.map((r) => r[c]).filter((v) => v !== null && v !== void 0);
-            (out[fn] ??= {})[c] = vals.length === 0 ? null : vals.reduce((a, v) => cmp(v, a, pick === 1 ? "gt" : "lt") ? v : a);
+            (out[fn] ??= {})[c] = vals.length === 0 ? null : vals.reduce((a, v) => cmp(v, a, pick2 === 1 ? "gt" : "lt") ? v : a);
           }
         }
         if (q.count === true) out["count"] = bucket.length;
@@ -785,16 +789,12 @@ function createMockDB() {
         applied[k] = v;
       }
       assertNoExpressionHandles("update", table, Object.keys(applied), applied);
-      const updated = idx >= 0 ? {
+      if (idx < 0) return null;
+      const updated = {
         ...rows[idx],
         ...applied
-      } : {
-        id,
-        ...applied
       };
-      if (idx >= 0) {
-        rows[idx] = updated;
-      }
+      rows[idx] = updated;
       track(tracked.updated, table, updated);
       return updated;
     },
@@ -819,6 +819,9 @@ function createMockDB() {
     async findMany(table, query, opts) {
       assertUsableFilter("findMany", table, query);
       refuseFragment("findMany", table, query);
+      if (opts?.with !== void 0 && Object.keys(opts.with).length > 0) {
+        throw new Error(`findMany(${table}): fakeDatabase \`with\` desteklemiyor \u2014 ili\u015Fki grafi\u011Fi yabanc\u0131 anahtarlardan T\xDCRET\u0130L\u0130YOR ve fake \u015Femay\u0131 okumuyor. \u0130li\u015Fkili sat\u0131rlar\u0131 \xF6l\xE7en bir test ger\xE7ek motoru kullanmal\u0131; fake ile \xF6l\xE7mek istiyorsan\u0131z ilgili sat\u0131rlar\u0131 \`seed\` ile ayr\u0131 koyup ayr\u0131 sorgulay\u0131n.`);
+      }
       const rows = store.get(table) ?? [];
       let out = query ? rows.filter((row) => rowMatchesFilter("findMany", table, row, query)) : [
         ...rows
@@ -1114,7 +1117,8 @@ function fakeDatabase() {
     }, "query")
   });
   return {
-    db,
+    db: makeTypedSurface(db),
+    raw: db,
     queries,
     seed: /* @__PURE__ */ __name((table, rows) => mock.seed(table, rows), "seed"),
     inserted: /* @__PURE__ */ __name((table) => mock.inserted(table), "inserted"),
@@ -1123,11 +1127,45 @@ function fakeDatabase() {
   };
 }
 __name(fakeDatabase, "fakeDatabase");
+
+// src/test/with-services.ts
+function absent(name) {
+  return new Proxy({}, {
+    get(_target, prop) {
+      throw new Error(`${String(name)}.${String(prop)} was read, but this test did not provide ${String(name)}. Pass it: withServices({ ${String(name)}: \u2026 }, () => \u2026)`);
+    }
+  });
+}
+__name(absent, "absent");
+function pick(services, key) {
+  return services[key] ?? absent(key);
+}
+__name(pick, "pick");
+function withServices(services, fn) {
+  const filled = {
+    Database: pick(services, "Database"),
+    Auth: pick(services, "Auth"),
+    Secrets: pick(services, "Secrets"),
+    Documents: pick(services, "Documents"),
+    Storage: pick(services, "Storage"),
+    Cache: pick(services, "Cache"),
+    Log: pick(services, "Log"),
+    Notifications: pick(services, "Notifications"),
+    Flags: pick(services, "Flags"),
+    Realtime: pick(services, "Realtime")
+  };
+  return __requestALS.run({
+    runtime: filled,
+    userId: null
+  }, fn);
+}
+__name(withServices, "withServices");
 export {
   TestApiError,
   api,
   createTestApi,
   fakeDatabase,
-  isolated
+  isolated,
+  withServices
 };
 //# sourceMappingURL=index.js.map