@elench/testkit 0.1.47 → 0.1.48

package/lib/runtime/index.d.ts

@@ -40,6 +40,14 @@ export interface RuntimeEnv {
   routeParams: RuntimeHeaders;
 }
 
+export interface TestkitRuntimeContext {
+  active: boolean;
+  leaseId: string | null;
+  namespace: string;
+  rawEnv: Record<string, string | undefined>;
+  runtimeId: string | null;
+}
+
 export interface RuntimeDb {
   exec(sql: string): unknown;
   query<T = Record<string, unknown>>(sql: string): T[];
@@ -177,6 +185,7 @@ export declare const httpDefaultOptions: RuntimeOptions;
 export declare function createDalContext(db?: RuntimeDb): RuntimeDalContext;
 export declare function openDb(): RuntimeDb;
 export declare function truncate(db: RuntimeDb, ...tables: string[]): void;
+export declare function getTestkitContext(): TestkitRuntimeContext;
 
 export declare function getEnv(): RuntimeEnv;
 export declare function createHttpClient<TSetup = unknown>(

package/lib/runtime/index.mjs

@@ -8,6 +8,7 @@ import {
   remainingFileTimeoutMs,
   remainingFileTimeoutSeconds,
 } from "../shared/file-timeout.mjs";
+import { readTestkitContext } from "../shared/test-context.mjs";
 import { check, group } from "../runtime-src/k6/checks.js";
 
 export { check, fail, group, sleep };
@@ -43,6 +44,10 @@ export {
   makeReq,
 } from "../runtime-src/k6/http.js";
 
+export function getTestkitContext() {
+  return readTestkitContext(__ENV);
+}
+
 export function remainingTimeSeconds() {
   return remainingFileTimeoutSeconds(readFileTimeoutBudget(__ENV), Date.now());
 }

package/lib/shared/test-context.mjs

@@ -0,0 +1,29 @@
+function sanitizeToken(value) {
+  return String(value || "")
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+}
+
+function optionalToken(value) {
+  const token = sanitizeToken(value);
+  return token || null;
+}
+
+export function buildTestNamespace({ leaseId, runtimeId } = {}) {
+  return optionalToken(leaseId) || optionalToken(runtimeId) || "standalone";
+}
+
+export function readTestkitContext(env = {}) {
+  const runtimeId = optionalToken(env.TESTKIT_RUNTIME_ID);
+  const leaseId = optionalToken(env.TESTKIT_LEASE_ID);
+
+  return {
+    active: env.TESTKIT_ACTIVE === "1",
+    runtimeId,
+    leaseId,
+    namespace: buildTestNamespace({ leaseId, runtimeId }),
+    rawEnv: env,
+  };
+}

package/lib/shared/test-context.test.mjs

@@ -0,0 +1,43 @@
+import { describe, expect, it } from "vitest";
+
+import { buildTestNamespace, readTestkitContext } from "./test-context.mjs";
+
+describe("buildTestNamespace", () => {
+  it("prefers the lease id when present", () => {
+    expect(buildTestNamespace({ runtimeId: "runtime-2", leaseId: "lease-4" })).toBe("lease-4");
+  });
+
+  it("falls back to the runtime id", () => {
+    expect(buildTestNamespace({ runtimeId: "runtime-2" })).toBe("runtime-2");
+  });
+
+  it("normalizes unsafe characters", () => {
+    expect(buildTestNamespace({ leaseId: " Lease 4 / Weird " })).toBe("lease-4-weird");
+  });
+
+  it("falls back to standalone when no runtime identifiers exist", () => {
+    expect(buildTestNamespace({})).toBe("standalone");
+  });
+});
+
+describe("readTestkitContext", () => {
+  it("reads active state and normalized identifiers", () => {
+    expect(
+      readTestkitContext({
+        TESTKIT_ACTIVE: "1",
+        TESTKIT_RUNTIME_ID: "Runtime 2",
+        TESTKIT_LEASE_ID: "Lease 3",
+      })
+    ).toEqual({
+      active: true,
+      runtimeId: "runtime-2",
+      leaseId: "lease-3",
+      namespace: "lease-3",
+      rawEnv: {
+        TESTKIT_ACTIVE: "1",
+        TESTKIT_RUNTIME_ID: "Runtime 2",
+        TESTKIT_LEASE_ID: "Lease 3",
+      },
+    });
+  });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit",
-  "version": "0.1.47",
+  "version": "0.1.48",
   "description": "CLI for discovering and running local HTTP, DAL, and Playwright test suites",
   "type": "module",
   "types": "./lib/index.d.ts",