@elench/testkit 0.1.118 → 0.1.119

package/lib/config-api/index.mjs

@@ -53,6 +53,38 @@ function buildDatabaseTemplateConfig(options = {}) {
   };
 }
 
+function commandStep(run, options = {}) {
+  return {
+    kind: "command",
+    run,
+    ...copyStepOptions(options),
+  };
+}
+
+function sqlFileStep(filePath, options = {}) {
+  return {
+    kind: "sql-file",
+    path: filePath,
+    ...copyStepOptions(options),
+  };
+}
+
+function moduleStep(target, options = {}) {
+  return {
+    kind: "module",
+    target,
+    ...copyStepOptions(options),
+  };
+}
+
+function copyStepOptions(options = {}) {
+  return {
+    ...(options.cwd !== undefined ? { cwd: options.cwd } : {}),
+    ...(options.inputs !== undefined ? { inputs: [...options.inputs] } : {}),
+    ...(options.args !== undefined ? { args: options.args } : {}),
+  };
+}
+
 function sourceSchemaFromEnv(envName, options = {}) {
   if (typeof envName !== "string" || envName.trim().length === 0) {
     throw new Error("database.schema.fromEnv(...) requires a non-empty env var name");
@@ -69,15 +101,30 @@ function sourceSchemaFromEnv(envName, options = {}) {
   };
 }
 
+function databaseStepTarget(exportName) {
+  return `@elench/testkit/config/database-steps#${exportName}`;
+}
+
+function verifySeedStep(options = {}) {
+  return moduleStep(databaseStepTarget("verifySeed"), { args: options });
+}
+
+function materializePostgresBindingStep(options = {}) {
+  return moduleStep(databaseStepTarget("materializePostgresBinding"), { args: options });
+}
+
 function postgresFixture(options = {}) {
-  const { discovery, envFiles, template, ...databaseOptions } = options;
-  for (const legacyKey of ["inputs", "schema", "migrate", "seed", "verify"]) {
+  const { discovery, envFiles, template, inputs, migrate, seed, verify, ...databaseOptions } = options;
+  for (const legacyKey of ["schema"]) {
     if (Object.prototype.hasOwnProperty.call(options, legacyKey)) {
       throw new Error(
-        `database.fixture(...) no longer accepts top-level "${legacyKey}". Move lifecycle config under database.fixture({ template: { ... } }).`
+        `database.fixture(...) no longer accepts "${legacyKey}". Configure database.sourceSchema instead.`
       );
     }
   }
+  const resolvedTemplate = template || hasTemplateLifecycle(options)
+    ? buildDatabaseTemplateConfig({ inputs, migrate, seed, verify, ...(template || {}) })
+    : undefined;
   return {
     discovery: discovery || {
       roots: [".testkit-fixture"],
@@ -85,16 +132,22 @@ function postgresFixture(options = {}) {
     envFiles,
     local: false,
     database: postgresDatabase(
-      template
+      resolvedTemplate
         ? {
             ...databaseOptions,
-            template: buildDatabaseTemplateConfig(template),
+            template: resolvedTemplate,
           }
         : databaseOptions
     ),
   };
 }
 
+function hasTemplateLifecycle(options = {}) {
+  return ["inputs", "migrate", "seed", "verify"].some((key) =>
+    Object.prototype.hasOwnProperty.call(options, key)
+  );
+}
+
 function nodeToolchain(options = {}) {
   return {
     kind: "node",
@@ -195,6 +248,8 @@ function nodeApp(options = {}) {
 
 function nextApp(options = {}) {
   const {
+    api,
+    auth: authMode,
     baseUrl: explicitBaseUrl,
     browser,
     build: explicitBuild,
@@ -214,7 +269,10 @@ function nextApp(options = {}) {
   } = options;
 
   const normalizedPort = requiredNumber(port, "app.next port");
-  const normalizedEnv = normalizePresetEnv(env);
+  const normalizedEnv = {
+    ...normalizeNextPresetEnv({ api, authMode }),
+    ...normalizePresetEnv(env),
+  };
   const baseUrl = explicitBaseUrl || "http://127.0.0.1:{port}";
   const build =
     explicitBuild === undefined
@@ -266,12 +324,16 @@ export const database = {
   schema: {
     fromEnv: sourceSchemaFromEnv,
   },
+  steps: {
+    materializePostgresBinding: materializePostgresBindingStep,
+    verifySeed: verifySeedStep,
+  },
   postgres(options = {}) {
-    const { template, sourceSchema, ...databaseOptions } = options;
-    for (const legacyKey of ["inputs", "schema", "migrate", "seed", "verify"]) {
+    const { template, sourceSchema, inputs, migrate, seed, verify, ...databaseOptions } = options;
+    for (const legacyKey of ["schema"]) {
       if (Object.prototype.hasOwnProperty.call(options, legacyKey)) {
         throw new Error(
-          `database.postgres(...) no longer accepts top-level "${legacyKey}". Move lifecycle config under database.postgres({ template: { ... } }).`
+          `database.postgres(...) no longer accepts "${legacyKey}". Use database.postgres({ sourceSchema: database.schema.fromEnv(...) }) instead.`
         );
       }
     }
@@ -281,11 +343,14 @@ export const database = {
           ...databaseOptions,
           sourceSchema,
         };
+    const resolvedTemplate = template || hasTemplateLifecycle(options)
+      ? buildDatabaseTemplateConfig({ inputs, migrate, seed, verify, ...(template || {}) })
+      : undefined;
     return postgresDatabase(
-      template
+      resolvedTemplate
         ? {
             ...normalizedDatabaseOptions,
-            template: buildDatabaseTemplateConfig(template),
+            template: resolvedTemplate,
           }
         : normalizedDatabaseOptions
     );
@@ -293,6 +358,30 @@ export const database = {
   fixture: postgresFixture,
 };
 
+export const step = {
+  command: commandStep,
+  module: moduleStep,
+  sqlFile: sqlFileStep,
+};
+
+export const presets = {
+  nodeNext(options = {}) {
+    return {
+      execution: {
+        workers: options.workers ?? 1,
+        fileTimeoutSeconds: options.fileTimeoutSeconds ?? 120,
+      },
+      toolchains: {
+        node: nodeToolchain({
+          install: options.install ?? "download",
+          ...(options.node ? { node: options.node } : {}),
+          ...(options.npm ? { npm: options.npm } : {}),
+        }),
+      },
+    };
+  },
+};
+
 export const toolchain = {
   node: nodeToolchain,
 };
@@ -383,6 +472,22 @@ function normalizeDatabaseEnvToken(value, label, sanitize = true) {
   return normalized;
 }
 
+function normalizeNextPresetEnv({ api, authMode } = {}) {
+  const env = {};
+  if (api) {
+    const baseUrlToken = typeof api === "string" ? api : api.baseUrl;
+    if (baseUrlToken) {
+      env.NEXT_PUBLIC_API_URL = baseUrlToken;
+    }
+  }
+  if (authMode === "disabled-clerk" || authMode?.kind === "disabled-clerk") {
+    env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY = "testkit_disabled";
+    env.CLERK_SECRET_KEY = "testkit_disabled";
+    env.CLERK_WEBHOOK_SECRET = "testkit_disabled";
+  }
+  return env;
+}
+
 function resolveNodeAppStart(build, entry) {
   if (build?.kind === "tsc") {
     const compiled = compiledEntryFromSource(entry || build.entry || "src/index.ts", build.outDir || "dist");
@@ -393,7 +498,8 @@ function resolveNodeAppStart(build, entry) {
 
 function normalizeTemplateStepList(value) {
   if (value == null) return [];
-  return Array.isArray(value) ? [...value] : [value];
+  const values = Array.isArray(value) ? value : [value];
+  return values.map((entry) => typeof entry === "string" ? commandStep(entry) : entry);
 }
 
 function compiledEntryFromSource(entry, outDir) {