@palbase/backend 39.1.7 → 40.0.1

package/dist/test/index.d.cts

@@ -1,5 +1,5 @@
 import { T as Token } from '../module-Dl1KFVtc.cjs';
-import { E as EnvServiceDatabase, a as DBClient, b as RuntimeServices } from '../index-CCY1h_J2.cjs';
+import { E as EnvServiceDatabase, a as DBClient, b as RuntimeServices } from '../index-t7Ie44mM.cjs';
 import 'zod';
 import '../db/env.cjs';
 import '../stack.cjs';
@@ -131,6 +131,25 @@ interface TestApi {
     readonly requests: readonly RecordedRequest[];
 }
 declare function createTestApi(config: TestApiConfig): TestApi;
+/** What THIS run was given, asked before a suite decides what it can measure.
+ *
+ * A suite that calls the stack cannot run under `npm test` or `palbase test
+ * --unit` — there is no stack there — and a suite that signs in as a fixture
+ * user cannot run on a deploy whose project declared none. Both are facts about
+ * the RUN, set by whoever started it, so they are read here rather than out of
+ * the environment in the project's own code: a scaffold that shows
+ * `process.env` teaches the habit that ends with a secret in a repository.
+ *
+ * Ask it for a SKIP CONDITION, never as a way out of an assertion that failed:
+ * `describe.skipIf(!testRun.stack)`, `describe.if(testRun.minted("author"))`.
+ */
+interface TestRun {
+    /** There is a stack to call — the deploy set one, or `palbase test --live` did. */
+    readonly stack: boolean;
+    /** This run minted a login under that fixture name. */
+    minted(name: string): boolean;
+}
+declare const testRun: TestRun;
 declare const api: TestApi;
 
 interface IsolatedContainer {
@@ -233,4 +252,4 @@ declare function fakeDatabase(): FakeDatabase;
 
 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 };
+export { type CallOptions, type ErrorEnvelope, type FakeDatabase, type IsolatedContainer, type RecordedQuery, type RecordedRequest, type TestApi, type TestApiConfig, TestApiError, type TestIdentity, type TestRun, api, createTestApi, fakeDatabase, isolated, testRun, withServices };

package/dist/test/index.d.ts

@@ -1,5 +1,5 @@
 import { T as Token } from '../module-Dl1KFVtc.js';
-import { E as EnvServiceDatabase, a as DBClient, b as RuntimeServices } from '../index-fLaf0PN2.js';
+import { E as EnvServiceDatabase, a as DBClient, b as RuntimeServices } from '../index-B8zC9oV0.js';
 import 'zod';
 import '../db/env.js';
 import '../stack.js';
@@ -131,6 +131,25 @@ interface TestApi {
     readonly requests: readonly RecordedRequest[];
 }
 declare function createTestApi(config: TestApiConfig): TestApi;
+/** What THIS run was given, asked before a suite decides what it can measure.
+ *
+ * A suite that calls the stack cannot run under `npm test` or `palbase test
+ * --unit` — there is no stack there — and a suite that signs in as a fixture
+ * user cannot run on a deploy whose project declared none. Both are facts about
+ * the RUN, set by whoever started it, so they are read here rather than out of
+ * the environment in the project's own code: a scaffold that shows
+ * `process.env` teaches the habit that ends with a secret in a repository.
+ *
+ * Ask it for a SKIP CONDITION, never as a way out of an assertion that failed:
+ * `describe.skipIf(!testRun.stack)`, `describe.if(testRun.minted("author"))`.
+ */
+interface TestRun {
+    /** There is a stack to call — the deploy set one, or `palbase test --live` did. */
+    readonly stack: boolean;
+    /** This run minted a login under that fixture name. */
+    minted(name: string): boolean;
+}
+declare const testRun: TestRun;
 declare const api: TestApi;
 
 interface IsolatedContainer {
@@ -233,4 +252,4 @@ declare function fakeDatabase(): FakeDatabase;
 
 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 };
+export { type CallOptions, type ErrorEnvelope, type FakeDatabase, type IsolatedContainer, type RecordedQuery, type RecordedRequest, type TestApi, type TestApiConfig, TestApiError, type TestIdentity, type TestRun, api, createTestApi, fakeDatabase, isolated, testRun, withServices };

package/dist/test/index.js

@@ -1395,7 +1395,7 @@ function parseIdentities(raw) {
   try {
     return JSON.parse(raw);
   } catch {
-    return {};
+    throw new Error("PALBASE_TEST_IDENTITIES is set but is not JSON \u2014 the run that started these tests handed over a broken identity set");
   }
 }
 __name(parseIdentities, "parseIdentities");
@@ -1407,6 +1407,22 @@ function safeParse(text) {
   }
 }
 __name(safeParse, "safeParse");
+var testRun = {
+  get stack() {
+    return Boolean(process.env.PALBASE_TEST_BASE_URL);
+  },
+  minted(name) {
+    const raw = process.env.PALBASE_TEST_IDENTITIES;
+    if (!raw) return false;
+    let identities;
+    try {
+      identities = JSON.parse(raw);
+    } catch {
+      throw new Error("PALBASE_TEST_IDENTITIES is set but is not JSON \u2014 the run that started these tests handed over a broken identity set");
+    }
+    return typeof identities === "object" && identities !== null && Object.prototype.hasOwnProperty.call(identities, name);
+  }
+};
 var configured = null;
 var api = new Proxy({}, {
   get(_target, prop) {
@@ -2332,6 +2348,7 @@ export {
   createTestApi,
   fakeDatabase,
   isolated,
+  testRun,
   withServices
 };
 /*! Bundled license information: