@elench/testkit 0.1.77 → 0.1.79

package/README.md

@@ -365,8 +365,31 @@ Named HTTP profiles live in `testkit.config.ts` and can be referenced by name:
 
 ```ts
 import { defineHttpSuite } from "@elench/testkit";
+import { defineConfig, profiles } from "@elench/testkit/config";
 
-const suite = defineHttpSuite({ profile: "default-auth" }, ({ req, setupData }) => {
+export default defineConfig({
+  profiles: {
+    http: {
+      defaultAuth: profiles.localJson({
+        password: "password",
+        identities: {
+          primary: {
+            email: "test@example.com",
+          },
+        },
+        session: {
+          authCookie: "session",
+        },
+        headers: {
+          contentTypeJson: true,
+          forwardedFor: "deterministic",
+        },
+      }).session(),
+    },
+  },
+});
+
+const suite = defineHttpSuite({ profile: "defaultAuth" }, ({ req, setupData }) => {
   req("GET", "/api/auth/session", setupData);
 });
 ```

package/lib/app/doctor.mjs

@@ -4,6 +4,7 @@ import ts from "typescript";
 import { discoverTests } from "../discovery/index.mjs";
 import { loadConfigContext } from "../config/index.mjs";
 import { runTestkitTypecheck } from "./typecheck.mjs";
+import { findConfigFile } from "../config/config-loader.mjs";
 
 export async function runDoctor(options = {}) {
   const checks = [];
@@ -39,6 +40,17 @@ export async function runDoctor(options = {}) {
     details: playwrightViolations,
   });
 
+  const configImportViolations = findConfigImportViolations(productDir);
+  checks.push({
+    code: "config-import-hygiene",
+    level: configImportViolations.length === 0 ? "pass" : "fail",
+    message:
+      configImportViolations.length === 0
+        ? "Repo config does not import __testkit__ helper modules"
+        : `Found ${configImportViolations.length} repo config import violation(s)`,
+    details: configImportViolations,
+  });
+
   const hasBrowserOrNextWork = discovery.files.some((entry) => entry.selectionType === "pw");
   if (hasBrowserOrNextWork) {
     const nodeCount = discovery.coverageGraph?.nodes?.length || 0;
@@ -113,6 +125,31 @@ function findPlaywrightRuntimeImportViolations(productDir) {
   return violations;
 }
 
+function findConfigImportViolations(productDir) {
+  const configFile = findConfigFile(productDir);
+  if (!configFile || !fs.existsSync(configFile)) return [];
+
+  const sourceText = fs.readFileSync(configFile, "utf8");
+  const sourceFile = ts.createSourceFile(configFile, sourceText, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+  const violations = [];
+
+  for (const statement of sourceFile.statements) {
+    if (!ts.isImportDeclaration(statement)) continue;
+    if (!ts.isStringLiteral(statement.moduleSpecifier)) continue;
+    const specifier = statement.moduleSpecifier.text;
+    if (!isRepoLocalConfigImportViolation(specifier)) continue;
+    const position = sourceFile.getLineAndCharacterOfPosition(statement.getStart(sourceFile));
+    violations.push({
+      file: path.relative(productDir, configFile).split(path.sep).join("/"),
+      line: position.line + 1,
+      specifier,
+      snippet: statement.getText(sourceFile),
+    });
+  }
+
+  return violations;
+}
+
 function collectFiles(rootDir, out = []) {
   if (!fs.existsSync(rootDir)) return out;
   for (const entry of fs.readdirSync(rootDir, { withFileTypes: true })) {
@@ -129,6 +166,12 @@ function collectFiles(rootDir, out = []) {
   return out.sort((left, right) => left.localeCompare(right));
 }
 
+function isRepoLocalConfigImportViolation(specifier) {
+  if (typeof specifier !== "string") return false;
+  if (!specifier.startsWith(".") && !specifier.startsWith("/")) return false;
+  return specifier.includes("__testkit__");
+}
+
 function relativeViolation(productDir, absolutePath, sourceFile, statement) {
   const position = sourceFile.getLineAndCharacterOfPosition(statement.getStart(sourceFile));
   return {

package/lib/cli/presentation/colors.mjs

@@ -1,12 +1,21 @@
 import { createColors } from "picocolors";
+import figures from "figures";
 
 const pc = createColors(Boolean(process.stdout?.isTTY || process.env.FORCE_COLOR));
 
 export function colorStatus(status) {
-  if (status === "PASS") return pc.green(status);
-  if (status === "FAIL") return pc.red(status);
-  if (status === "SKIP") return pc.yellow(status);
-  if (status === "RUN") return pc.cyan(status);
+  if (status === "PASS") return pc.green(figures.tick);
+  if (status === "FAIL") return pc.red(figures.cross);
+  if (status === "SKIP") return pc.yellow(figures.arrowDown);
+  if (status === "RUN") return pc.cyan(figures.play);
+  return status;
+}
+
+export function statusLabel(status) {
+  if (status === "PASS") return pc.green(`${figures.tick} PASS`);
+  if (status === "FAIL") return pc.red(`${figures.cross} FAIL`);
+  if (status === "SKIP") return pc.yellow(`${figures.arrowDown} SKIP`);
+  if (status === "RUN") return pc.cyan(`${figures.play} RUN`);
   return status;
 }
 
@@ -18,6 +27,14 @@ export function bold(text) {
   return pc.bold(text);
 }
 
+export function boldRed(text) {
+  return pc.bold(pc.red(text));
+}
+
+export function red(text) {
+  return pc.red(text);
+}
+
 export function muted(text) {
   return pc.dim(text);
 }

package/lib/cli/presentation/discovery-reporter.mjs

@@ -5,13 +5,18 @@ import {
   colorDiagnosticSeverity,
   colorHeading,
   colorService,
-  colorStatus,
   colorTypeBadge,
   muted,
+  statusLabel,
 } from "./colors.mjs";
 
 const TYPE_ORDER = ["int", "e2e", "scenario", "dal", "load", "pw"];
 
+const TREE_BRANCH = "\u251C\u2500\u2500 ";
+const TREE_LAST = "\u2514\u2500\u2500 ";
+const TREE_PIPE = "\u2502   ";
+const TREE_SPACE = "    ";
+
 export function buildDiscoveryReportLines(result, options = {}) {
   const mode = options.outputMode || "compact";
   return mode === "verbose" ? buildVerboseLines(result) : buildCompactLines(result);
@@ -20,7 +25,7 @@ export function buildDiscoveryReportLines(result, options = {}) {
 function buildCompactLines(result) {
   const lines = [];
   lines.push(
-    `${colorHeading("Summary")} ${result.summary.files} files · ${result.summary.activeFiles} active · ${result.summary.skippedFiles} skipped · ${result.summary.suites} suites · ${result.summary.services} services`
+    `${colorHeading("Summary")} ${result.summary.files} files \u00B7 ${result.summary.activeFiles} active \u00B7 ${result.summary.skippedFiles} skipped \u00B7 ${result.summary.suites} suites \u00B7 ${result.summary.services} services`
   );
 
   if (result.history?.available) {
@@ -35,17 +40,33 @@ function buildCompactLines(result) {
   for (const service of result.services) {
     lines.push("");
     lines.push(
-      `${colorService(service.name)} ${muted(`(${service.fileCount} files${service.dependsOn.length > 0 ? ` · depends on ${service.dependsOn.join(", ")}` : ""})`)}`
+      `${colorService(service.name)} ${muted(`(${service.fileCount} files${service.dependsOn.length > 0 ? ` \u00B7 depends on ${service.dependsOn.join(", ")}` : ""})`)}`
     );
     const typeGroups = suitesByService.get(service.name) || new Map();
-    for (const type of orderedTypes([...typeGroups.keys()])) {
+    const types = orderedTypes([...typeGroups.keys()]);
+
+    for (let ti = 0; ti < types.length; ti++) {
+      const type = types[ti];
+      const isLastType = ti === types.length - 1;
+      const typeConnector = isLastType ? TREE_LAST : TREE_BRANCH;
+      const typePrefix = isLastType ? TREE_SPACE : TREE_PIPE;
       const suites = typeGroups.get(type) || [];
-      lines.push(`  ${colorTypeBadge(type.toUpperCase())} ${formatSelectionTypeLabel(type)}`);
-      for (const suite of suites) {
-        lines.push(`    ${bold(suite.groupLabel)} ${muted(`(${suite.fileCount} files)`)}`);
-        for (const file of filesBySuite.get(suite.id) || []) {
-          const status = file.skipped ? `${colorStatus("SKIP")} ${file.skipReason}` : muted(buildHistoryHint(file));
-          lines.push(`      ${file.displayName}${status ? `  ${status}` : ""}`);
+      lines.push(`${typeConnector}${colorTypeBadge(type.toUpperCase())} ${formatSelectionTypeLabel(type)}`);
+
+      for (let si = 0; si < suites.length; si++) {
+        const suite = suites[si];
+        const isLastSuite = si === suites.length - 1;
+        const suiteConnector = isLastSuite ? TREE_LAST : TREE_BRANCH;
+        const suitePrefix = isLastSuite ? TREE_SPACE : TREE_PIPE;
+        lines.push(`${typePrefix}${suiteConnector}${bold(suite.groupLabel)} ${muted(`(${suite.fileCount} files)`)}`);
+
+        const files = filesBySuite.get(suite.id) || [];
+        for (let fi = 0; fi < files.length; fi++) {
+          const file = files[fi];
+          const isLastFile = fi === files.length - 1;
+          const fileConnector = isLastFile ? TREE_LAST : TREE_BRANCH;
+          const status = file.skipped ? `${statusLabel("SKIP")} ${file.skipReason}` : muted(buildHistoryHint(file));
+          lines.push(`${typePrefix}${suitePrefix}${fileConnector}${file.displayName}${status ? `  ${status}` : ""}`);
         }
       }
     }
@@ -73,7 +94,7 @@ function buildVerboseLines(result) {
     if (service.dependsOn.length > 0) {
       lines.push(`  dependsOn ${service.dependsOn.join(", ")}`);
     }
-    lines.push(`  files ${service.fileCount} · active ${service.activeFileCount} · skipped ${service.skippedFileCount}`);
+    lines.push(`  files ${service.fileCount} \u00B7 active ${service.activeFileCount} \u00B7 skipped ${service.skippedFileCount}`);
 
     const suites = result.suites.filter((suite) => suite.service === service.name).sort(compareSuites);
     for (const suite of suites) {
@@ -162,5 +183,5 @@ function buildHistoryHint(file) {
     file.history.firstSeenAt ? `seen ${file.history.firstSeenAt.slice(0, 10)}` : null,
   ]
     .filter(Boolean)
-    .join(" · ");
+    .join(" \u00B7 ");
 }

package/lib/cli/presentation/run-reporter.mjs

@@ -1,15 +1,89 @@
 import path from "path";
+import figures from "figures";
 import {
   buildCompactRunSummaryLines,
   buildDebugRunSummaryLines,
   formatDuration,
 } from "../../runner/formatting.mjs";
-import { colorSectionLine, colorStatus, dim } from "./colors.mjs";
+import { boldRed, colorSectionLine, dim, red, statusLabel } from "./colors.mjs";
+
+const ANSI_RE = /\x1b\[[0-9;]*m/g;
+const DURATION_RE = /\b(\d+m\s+\d+s|\d+s)\b/g;
+
+function stripAnsi(text) {
+  return text.replace(ANSI_RE, "");
+}
+
+function boxLines(lines) {
+  const nonEmpty = lines.filter((l) => stripAnsi(l).trim().length > 0);
+  if (nonEmpty.length === 0) return lines;
+  const maxWidth = lines.reduce((max, l) => Math.max(max, stripAnsi(l).length), 0);
+  const pad = 1;
+  const innerWidth = maxWidth + pad * 2;
+  const top = `${figures.lineDownRight}${figures.line.repeat(innerWidth)}${figures.lineDownLeft}`;
+  const bottom = `${figures.lineUpRight}${figures.line.repeat(innerWidth)}${figures.lineUpLeft}`;
+  const boxed = [top];
+  for (const line of lines) {
+    const visible = stripAnsi(line).length;
+    const right = innerWidth - pad - visible;
+    boxed.push(`${figures.lineVertical}${" ".repeat(pad)}${line}${" ".repeat(Math.max(0, right))}${figures.lineVertical}`);
+  }
+  boxed.push(bottom);
+  return boxed;
+}
+
+function colorFailureSummaryLines(lines) {
+  const result = [];
+  let inFailuresSection = false;
+  let lastWasFilePath = false;
+  for (const line of lines) {
+    const raw = stripAnsi(line);
+    if (raw === "Failures:" || raw === "Runtime Errors:") {
+      inFailuresSection = true;
+      lastWasFilePath = false;
+      result.push(line);
+      continue;
+    }
+    if (/^(Summary:|Result:|Known-failure|Triage:)/.test(raw) || raw === "") {
+      inFailuresSection = false;
+      lastWasFilePath = false;
+    }
+    if (inFailuresSection) {
+      if (/^ {2}\S/.test(raw)) {
+        lastWasFilePath = true;
+        result.push(boldRed(raw));
+        continue;
+      }
+      if (/^ {4}\S/.test(raw)) {
+        if (lastWasFilePath) {
+          lastWasFilePath = false;
+          result.push(boldRed(raw));
+        } else {
+          result.push(red(raw));
+        }
+        continue;
+      }
+    }
+    lastWasFilePath = false;
+    result.push(line);
+  }
+  return result;
+}
+
+function dimDurations(line) {
+  return line.replace(DURATION_RE, (match) => dim(match));
+}
 
 export function createRunReporter({ outputMode = "compact", stdout = process.stdout, stderr = process.stderr } = {}) {
   const mode = outputMode || "compact";
+  let completedCount = 0;
+  let totalFileCount = 0;
+
   return {
     outputMode: mode,
+    setTotalFileCount(count) {
+      totalFileCount = count;
+    },
     writeLine(line = "") {
       stdout.write(`${line}\n`);
     },
@@ -34,7 +108,7 @@ export function createRunReporter({ outputMode = "compact", stdout = process.std
       if (operation.status === "failed") {
         const detail = shortenMessage(operation.error || operation.summary || operation.stage);
         stdout.write(
-          `${colorStatus("FAIL")} ${"SETUP"} ${operation.serviceName} ${operation.stage} ${dim(duration)} ${detail}\n`
+          `${statusLabel("FAIL")} ${"SETUP"} ${operation.serviceName} ${operation.stage} ${dim(duration)} ${boldRed(detail)}\n`
         );
         return;
       }
@@ -44,7 +118,7 @@ export function createRunReporter({ outputMode = "compact", stdout = process.std
         (operation.durationMs || 0) >= 5_000
       ) {
         const summary = shortenMessage(operation.summary || operation.stage);
-        stdout.write(`${colorStatus("RUN")} ${"SETUP"} ${operation.serviceName} ${summary} ${dim(duration)}\n`);
+        stdout.write(`${statusLabel("RUN")} ${"SETUP"} ${operation.serviceName} ${summary} ${dim(duration)}\n`);
       }
     },
     localServiceStarting(config, command) {
@@ -52,19 +126,20 @@ export function createRunReporter({ outputMode = "compact", stdout = process.std
       stdout.write(`Starting ${config.runtimeLabel}:${config.name}: ${command}\n`);
     },
     serviceSkipped(config, reason) {
-      stdout.write(`${colorStatus("SKIP")} ${config.name} ${reason}\n`);
+      stdout.write(`${statusLabel("SKIP")} ${config.name} ${reason}\n`);
     },
     plannedSkip(entry) {
       stdout.write(
-        `${colorStatus("SKIP")} ${entry.serviceName} ${entry.type} ${normalizePath(entry.file)} ${dim("0s")} ${shortenMessage(entry.reason || "skipped")}\n`
+        `${statusLabel("SKIP")} ${entry.serviceName} ${entry.type} ${normalizePath(entry.file)} ${dim("0s")} ${shortenMessage(entry.reason || "skipped")}\n`
       );
     },
     taskStarted(task, targetConfig) {
       if (mode !== "debug") return;
-      stdout.write(`${colorStatus("RUN").padEnd(12)} ${targetConfig.name} ${task.type} ${task.file}\n`);
+      stdout.write(`${statusLabel("RUN")} ${targetConfig.name} ${task.type} ${task.file}\n`);
     },
     taskFinished(task, outcome) {
       if (mode === "json") return;
+      completedCount += 1;
       const status = outcome.status === "skipped" ? "SKIP" : outcome.failed ? "FAIL" : "PASS";
       const duration = formatDuration(outcome.durationMs || 0);
       const primaryFailure = firstFailureDetail(outcome);
@@ -72,12 +147,13 @@ export function createRunReporter({ outputMode = "compact", stdout = process.std
         primaryFailure && isThresholdWrapperMessage(outcome.error) ? primaryFailure : outcome.error || primaryFailure;
       const detail =
         status === "FAIL"
-          ? ` ${shortenMessage(preferredFailure || "failed")}`
+          ? ` ${boldRed(shortenMessage(preferredFailure || "failed"))}`
           : outcome.status === "not_run"
-            ? ` ${shortenMessage(outcome.reason || "not run")}`
+            ? ` ${dim(shortenMessage(outcome.reason || "not run"))}`
             : "";
+      const progress = mode === "compact" && totalFileCount > 0 ? `${dim(`[${completedCount}/${totalFileCount}]`)} ` : "";
       stdout.write(
-        `${colorStatus(status)} ${task.serviceName} ${displayTaskType(task)} ${normalizePath(task.file)} ${dim(duration)}${detail}\n`
+        `${progress}${statusLabel(status)} ${task.serviceName} ${displayTaskType(task)} ${normalizePath(task.file)} ${dim(duration)}${detail}\n`
       );
     },
     telemetry(message) {
@@ -89,7 +165,11 @@ export function createRunReporter({ outputMode = "compact", stdout = process.std
         mode === "debug"
           ? buildDebugRunSummaryLines(results, durationMs, knownFailureIssueValidation)
           : buildCompactRunSummaryLines(results, durationMs, knownFailureIssueValidation);
-      for (const line of lines) stdout.write(`${colorSectionLine(line)}\n`);
+      const colored = colorFailureSummaryLines(lines.map((line) => colorSectionLine(line)));
+      const dimmed = colored.map((line) => dimDurations(line));
+      const boxed = boxLines(dimmed);
+      stdout.write("\n");
+      for (const line of boxed) stdout.write(`${line}\n`);
     },
     error(message) {
       stderr.write(`${message}\n`);

package/lib/cli/presentation/run-reporter.test.mjs

@@ -1,4 +1,5 @@
 import { Writable } from "stream";
+import figures from "figures";
 import { describe, expect, it } from "vitest";
 import { createRunReporter } from "./run-reporter.mjs";
 
@@ -24,7 +25,7 @@ describe("run reporter setup output", () => {
       durationMs: 8_000,
     });
 
-    expect(stdout).toContain("RUN SETUP api template rebuild");
+    expect(stdout).toContain(`${figures.play} RUN SETUP api template rebuild`);
     expect(stdout).toContain("8s");
   });
 
@@ -74,7 +75,7 @@ describe("run reporter setup output", () => {
       error: "Command failed with exit code 1: node scripts/fail-prepare.mjs",
     });
 
-    expect(stdout).toContain("FAIL SETUP api runtime:prepare");
+    expect(stdout).toContain(`${figures.cross} FAIL SETUP api runtime:prepare`);
     expect(stdout).toContain("Command failed with exit code 1");
   });
 });

package/lib/config-api/index.d.ts

@@ -1,4 +1,4 @@
-import type { AuthAdapter, HeaderBuilder, HttpSuiteConfig } from "../index";
+import type { HttpSuiteConfig, RuntimeEnv, RuntimeOptions } from "../index";
 
 export interface DatabaseTemplateConfig {
   inputs?: string[];
@@ -192,6 +192,187 @@ export interface TestkitFileMetadata {
   skip?: string | { reason: string };
 }
 
+export interface ProfileRequestContext {
+  actor: string;
+  actorIndex: number;
+  env: RuntimeEnv;
+  phase: string;
+}
+
+export type ProfileValueFactory<TValue> =
+  | TValue
+  | ((context: ProfileRequestContext) => TValue);
+
+export interface ProfileRequestConfig {
+  body?: ProfileValueFactory<unknown>;
+  contentTypeJson?: boolean;
+  expect?: number | number[];
+  headers?: ProfileValueFactory<Record<string, string>>;
+  method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+  path: string;
+}
+
+export interface SessionAuthSourceConfig {
+  key: string;
+}
+
+export interface SessionAuthHeaderConfig {
+  header?: string;
+  prefix?: string;
+  source: SessionAuthSourceConfig;
+}
+
+export interface SessionCaptureConfig {
+  auth?: SessionAuthHeaderConfig;
+  cookies?: Record<string, string>;
+  fields?: Record<string, string>;
+}
+
+export interface SessionActorConfig {
+  bootstrap?: ProfileRequestConfig | ProfileRequestConfig[];
+  login: ProfileRequestConfig;
+  session: SessionCaptureConfig;
+}
+
+export interface ProfileHeaderContext<TSession = unknown> {
+  actor: string | null;
+  env: RuntimeEnv;
+  session: TSession | null;
+}
+
+export interface ProfileSessionHeaderConfig {
+  actor?: string;
+  field: string;
+  header: string;
+}
+
+export interface DeterministicForwardedForConfig {
+  actor?: string;
+  header?: string;
+  seed?: string;
+}
+
+export interface ProfileHeaderConfig<TSession = unknown> {
+  contentTypeJson?: boolean;
+  forwardedFor?: "deterministic" | DeterministicForwardedForConfig;
+  fromSession?: ProfileSessionHeaderConfig[];
+  values?: Record<string, string> | ((context: ProfileHeaderContext<TSession>) => Record<string, string>);
+}
+
+export interface RawHttpProfileOptions {
+  env?: RuntimeEnv;
+  headers?: ProfileHeaderConfig;
+  options?: RuntimeOptions;
+}
+
+export interface SessionHttpProfileOptions {
+  actor: SessionActorConfig;
+  env?: RuntimeEnv;
+  headers?: ProfileHeaderConfig<Record<string, unknown>>;
+  options?: RuntimeOptions;
+}
+
+export interface MultiActorHttpProfileOptions {
+  actors: Record<string, SessionActorConfig>;
+  env?: RuntimeEnv;
+  headers?: ProfileHeaderConfig<Record<string, Record<string, unknown>>>;
+  options?: RuntimeOptions;
+  primaryActor?: string;
+}
+
+export interface LocalJsonIdentityContext {
+  actor: string;
+}
+
+export type LocalJsonIdentityValue = string | ((context: LocalJsonIdentityContext) => string);
+
+export interface LocalJsonActorIdentityConfig {
+  email?: LocalJsonIdentityValue;
+  loginBody?: Record<string, unknown>;
+  name?: LocalJsonIdentityValue;
+  organizationName?: LocalJsonIdentityValue;
+  password?: LocalJsonIdentityValue;
+  signupBody?: Record<string, unknown>;
+}
+
+export interface LocalJsonSessionAuthOptions {
+  header?: string;
+  prefix?: string;
+  sourceKey?: string;
+}
+
+export interface LocalJsonSessionOptions {
+  auth?: LocalJsonSessionAuthOptions;
+  authCookie?: string;
+  cookies?: Record<string, string>;
+  fields?: Record<string, string>;
+  organizationIdPath?: string;
+  refreshCookie?: string;
+}
+
+export interface LocalJsonOrganizationHeaderConfig {
+  actor?: string;
+  field?: string;
+  header?: string;
+}
+
+export interface LocalJsonHeaderOptions {
+  contentTypeJson?: boolean;
+  forwardedFor?: "deterministic" | DeterministicForwardedForConfig;
+  organization?: false | string | LocalJsonOrganizationHeaderConfig;
+  values?: Record<string, string> | ((context: ProfileHeaderContext<unknown>) => Record<string, string>);
+}
+
+export interface LocalJsonSignupOptions {
+  enabled?: boolean;
+  expect?: number | number[];
+  path?: string;
+}
+
+export interface LocalJsonLoginOptions {
+  expect?: number | number[];
+  path?: string;
+}
+
+export interface LocalJsonProfileOptions {
+  env?: RuntimeEnv;
+  headers?: LocalJsonHeaderOptions;
+  identities?: Record<string, LocalJsonActorIdentityConfig>;
+  login?: LocalJsonLoginOptions;
+  options?: RuntimeOptions;
+  password?: LocalJsonIdentityValue;
+  session?: LocalJsonSessionOptions;
+  signup?: false | LocalJsonSignupOptions;
+}
+
+export interface LocalJsonSessionProfileOptions {
+  actor?: string;
+  env?: RuntimeEnv;
+  headers?: LocalJsonHeaderOptions;
+  identity?: LocalJsonActorIdentityConfig;
+  options?: RuntimeOptions;
+}
+
+export interface LocalJsonMultiActorProfileOptions {
+  actors?: string[] | Record<string, LocalJsonActorIdentityConfig>;
+  env?: RuntimeEnv;
+  headers?: LocalJsonHeaderOptions;
+  options?: RuntimeOptions;
+  primaryActor?: string;
+}
+
+export interface LocalJsonRawProfileOptions {
+  env?: RuntimeEnv;
+  headers?: LocalJsonHeaderOptions;
+  options?: RuntimeOptions;
+}
+
+export interface LocalJsonProfileBuilder {
+  multiActor(options?: LocalJsonMultiActorProfileOptions): HttpSuiteConfig<Record<string, Record<string, unknown>>>;
+  raw(options?: LocalJsonRawProfileOptions): HttpSuiteConfig<any>;
+  session(options?: LocalJsonSessionProfileOptions): HttpSuiteConfig<Record<string, unknown>>;
+}
+
 export interface NodeAppOptions extends Omit<ServiceConfig, "local" | "runtime" | "env"> {
   baseUrl?: string;
   build?: BuildConfig | null;
@@ -246,7 +427,6 @@ export interface TestkitConfig {
 }
 
 export declare function defineConfig<T extends TestkitConfig>(config: T): T;
-export declare function defineHttpProfile<T extends HttpSuiteConfig>(profile: T): T;
 export declare function defineFile<T extends TestkitFileMetadata>(metadata: T): T;
 export declare const app: {
   node(options: NodeAppOptions): ServiceConfig;
@@ -269,20 +449,13 @@ export declare const database: {
 export declare const toolchain: {
   node(options?: NodeToolchainConfig): NodeToolchainConfig;
 };
-export declare function clerkSessionProfile(options?: {
-  apiBase?: string;
-  needsAuth?: boolean;
-  secretKeyEnv?: string;
-}): HttpSuiteConfig;
-export declare function jsonSessionProfile(options?: {
-  body?: (context: { env: Record<string, string> }) => unknown;
-  cookieName?: string;
-  headers?: Record<string, string>;
-  loginPath?: string;
-  passwordEnv?: string;
-  successStatus?: number;
-  usernameEnv?: string;
-}): HttpSuiteConfig;
+export declare const profiles: {
+  custom<T extends HttpSuiteConfig>(profile: T): T;
+  localJson(options?: LocalJsonProfileOptions): LocalJsonProfileBuilder;
+  multiActor(options: MultiActorHttpProfileOptions): HttpSuiteConfig<Record<string, Record<string, unknown>>>;
+  raw(options?: RawHttpProfileOptions): HttpSuiteConfig<any>;
+  session(options: SessionHttpProfileOptions): HttpSuiteConfig<Record<string, unknown>>;
+};
 
 export declare function registerRepoConfig(config: unknown): void;
 export declare function getRepoConfig(): unknown;