@specific.dev/spectest 0.110.0 → 0.111.0

package/dist/daemon.js

@@ -2932,7 +2932,7 @@ async function bootstrapInner(prepared, identity) {
 let interactiveSetupCompleted = false;
 /**
  * Run a project setup hook. Normal `setup` runs before the shared warm
- * snapshot; `setupInteractive` runs only after it, in a fresh user start.
+ * snapshot; `interactive.seed` runs only after it, in a fresh user start.
  * Both use the same context and boot-log capture.
  *
  * Unlike test runs, this is NOT instrumented — no recorder, no event
@@ -2951,7 +2951,8 @@ async function runProjectSetup(hook = "setup") {
     }
 }
 async function runProjectSetupInner(hook) {
-    const setup = requireLoaded().project[hook];
+    const project = requireLoaded().project;
+    const setup = hook === "setup" ? project.setup : project.interactive?.seed;
     if (!setup || (hook === "setupInteractive" && interactiveSetupCompleted)) {
         return { ran: false, durationMs: 0 };
     }
@@ -5143,7 +5144,7 @@ export function harnessMethods(state) {
             capabilities: ["prepared-images-v1"],
             // Optional discovery: old SDKs omit this field and are never sent the
             // new method. Check the loaded project, including after warm restore.
-            setupInteractive: typeof loaded?.project.setupInteractive === "function",
+            setupInteractive: typeof loaded?.project.interactive?.seed === "function",
             replayEnvironmentMode: true,
         }),
         // Live bootstrap progress, polled by the control plane during

package/dist/index.d.ts

@@ -1627,21 +1627,24 @@ export interface Project<S extends ServicesMap = ServicesMap, F extends FakesMap
     /**
      * Prepare a new interactive environment, after normal setup and the shared
      * warm-template snapshot. Runs on both cold starts and warm restores from
-     * the dashboard or `spectest env start`, before the environment is ready.
+     * the dashboard (seed checkbox on) or `spectest env start --seed`, before
+     * the environment is ready. Skipped when seeding is not requested.
      * Never runs for tests, snapshot forks, or resuming a stopped environment.
      * Uses the same context as `setup`; throw to fail the start.
      */
-    setupInteractive?: ProjectSetupFn<S, F>;
+    interactive?: {
+        seed?: ProjectSetupFn<S, F>;
+    };
     tests?: TestSuite<S, F>;
 }
 /**
- * Context handed to the project-level `setup` and `setupInteractive` hooks: the full
+ * Context handed to the project-level `setup` and `interactive.seed` hooks: the full
  * {@link SpectestContext}, minus only what a timeline gives a test
  * (testName, parent, browser/mobile/terminal). Everything a test can do
  * to the environment — exec, fetch, `svc`/`fakes` helpers, `poll`,
  * `dnsName`, `certificate`, `startService`, and project-file access via
  * `projectRoot`/`readProjectFile` — is available here too. Normal `setup`
- * state is captured into the shared warm template; `setupInteractive`
+ * state is captured into the shared warm template; `interactive.seed`
  * state belongs only to the new interactive environment.
  */
 export interface ProjectSetupContext<S extends ServicesMap = ServicesMap, F extends FakesMap = FakesMap> extends SpectestContext<S, F> {
@@ -1681,8 +1684,10 @@ export type ProjectSetupFn<S extends ServicesMap = ServicesMap, F extends FakesM
 export interface ProjectOpts<S extends ServicesMap = ServicesMap, F extends FakesMap = FakesMap> {
     /** Optional project-level setup. See `Project.setup`. */
     setup?: ProjectSetupFn<S, F>;
-    /** Optional interactive-only setup. See `Project.setupInteractive`. */
-    setupInteractive?: ProjectSetupFn<S, F>;
+    /** Optional interactive-only setup. See `Project.interactive`. */
+    interactive?: {
+        seed?: ProjectSetupFn<S, F>;
+    };
     /** Test cases for this project's suite. */
     tests?: TestCase<unknown, S, F>[];
 }
@@ -1736,7 +1741,7 @@ export interface DefinedEnvironment<S extends ServicesMap, F extends FakesMap =
     group<P = undefined>(name: string, opts?: GroupOpts<P, S, F>): TestGroup<P, S, F>;
     /** Bundle this environment with a test suite into the project default
      * export. Pass tests as a plain array for the common case, or an
-     * options bag to attach `setup` or `setupInteractive`. (Fakes are declared on
+     * options bag to attach `setup` or `interactive.seed`. (Fakes are declared on
      * `defineEnvironment`, not here.) */
     project(tests?: TestCase<unknown, S, F>[]): Project<S, F>;
     project(opts: ProjectOpts<S, F>): Project<S, F>;

package/dist/index.js

@@ -484,8 +484,8 @@ export function defineEnvironment(input) {
         const proj = { environment: config };
         if (opts.setup)
             proj.setup = opts.setup;
-        if (opts.setupInteractive)
-            proj.setupInteractive = opts.setupInteractive;
+        if (opts.interactive)
+            proj.interactive = opts.interactive;
         if (fakes)
             proj.fakes = fakes;
         if (opts.tests && opts.tests.length > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specific.dev/spectest",
-  "version": "0.110.0",
+  "version": "0.111.0",
   "description": "Spectest SDK for defining test environments in TypeScript.",
   "type": "module",
   "main": "./dist/index.js",

package/src/daemon.ts

@@ -3481,7 +3481,7 @@ let interactiveSetupCompleted = false;
 
 /**
  * Run a project setup hook. Normal `setup` runs before the shared warm
- * snapshot; `setupInteractive` runs only after it, in a fresh user start.
+ * snapshot; `interactive.seed` runs only after it, in a fresh user start.
  * Both use the same context and boot-log capture.
  *
  * Unlike test runs, this is NOT instrumented — no recorder, no event
@@ -3500,7 +3500,8 @@ async function runProjectSetup(hook: "setup" | "setupInteractive" = "setup"): Pr
 }
 
 async function runProjectSetupInner(hook: "setup" | "setupInteractive"): Promise<ProjectSetupResult> {
-  const setup = requireLoaded().project[hook];
+  const project = requireLoaded().project;
+  const setup = hook === "setup" ? project.setup : project.interactive?.seed;
   if (!setup || (hook === "setupInteractive" && interactiveSetupCompleted)) {
     return { ran: false, durationMs: 0 };
   }
@@ -6161,7 +6162,7 @@ export function harnessMethods(state: RouteState): MethodTable {
       capabilities: ["prepared-images-v1"],
       // Optional discovery: old SDKs omit this field and are never sent the
       // new method. Check the loaded project, including after warm restore.
-      setupInteractive: typeof loaded?.project.setupInteractive === "function",
+      setupInteractive: typeof loaded?.project.interactive?.seed === "function",
       replayEnvironmentMode: true,
     }),
 

package/src/index.ts

@@ -2380,22 +2380,23 @@ export interface Project<
   /**
    * Prepare a new interactive environment, after normal setup and the shared
    * warm-template snapshot. Runs on both cold starts and warm restores from
-   * the dashboard or `spectest env start`, before the environment is ready.
+   * the dashboard (seed checkbox on) or `spectest env start --seed`, before
+   * the environment is ready. Skipped when seeding is not requested.
    * Never runs for tests, snapshot forks, or resuming a stopped environment.
    * Uses the same context as `setup`; throw to fail the start.
    */
-  setupInteractive?: ProjectSetupFn<S, F>;
+  interactive?: { seed?: ProjectSetupFn<S, F> };
   tests?: TestSuite<S, F>;
 }
 
 /**
- * Context handed to the project-level `setup` and `setupInteractive` hooks: the full
+ * Context handed to the project-level `setup` and `interactive.seed` hooks: the full
  * {@link SpectestContext}, minus only what a timeline gives a test
  * (testName, parent, browser/mobile/terminal). Everything a test can do
  * to the environment — exec, fetch, `svc`/`fakes` helpers, `poll`,
  * `dnsName`, `certificate`, `startService`, and project-file access via
  * `projectRoot`/`readProjectFile` — is available here too. Normal `setup`
- * state is captured into the shared warm template; `setupInteractive`
+ * state is captured into the shared warm template; `interactive.seed`
  * state belongs only to the new interactive environment.
  */
 export interface ProjectSetupContext<
@@ -2445,8 +2446,8 @@ export interface ProjectOpts<
 > {
   /** Optional project-level setup. See `Project.setup`. */
   setup?: ProjectSetupFn<S, F>;
-  /** Optional interactive-only setup. See `Project.setupInteractive`. */
-  setupInteractive?: ProjectSetupFn<S, F>;
+  /** Optional interactive-only setup. See `Project.interactive`. */
+  interactive?: { seed?: ProjectSetupFn<S, F> };
   /** Test cases for this project's suite. */
   tests?: TestCase<unknown, S, F>[];
 }
@@ -2511,7 +2512,7 @@ export interface DefinedEnvironment<
   ): TestGroup<P, S, F>;
   /** Bundle this environment with a test suite into the project default
    * export. Pass tests as a plain array for the common case, or an
-   * options bag to attach `setup` or `setupInteractive`. (Fakes are declared on
+   * options bag to attach `setup` or `interactive.seed`. (Fakes are declared on
    * `defineEnvironment`, not here.) */
   project(tests?: TestCase<unknown, S, F>[]): Project<S, F>;
   project(opts: ProjectOpts<S, F>): Project<S, F>;
@@ -2663,7 +2664,7 @@ export function defineEnvironment<
       : (arg ?? {});
     const proj: Project<S, F> = { environment: config };
     if (opts.setup) proj.setup = opts.setup;
-    if (opts.setupInteractive) proj.setupInteractive = opts.setupInteractive;
+    if (opts.interactive) proj.interactive = opts.interactive;
     if (fakes) proj.fakes = fakes;
     if (opts.tests && opts.tests.length > 0) {
       // Explicit suite (single-file / legacy layout): the tests are listed

package/src/interactive-setup.test.ts

@@ -22,7 +22,7 @@ for (const withHook of [false, true]) {
         }});
         export default env.project({
           setup: () => { calls.push("baseline"); },
-          ${withHook ? `setupInteractive: async (ctx) => {
+          ${withHook ? `interactive: { seed: async (ctx) => {
             calls.push("interactive");
             console.log("seeding demo data");
             await globalThis.seedGate;
@@ -35,7 +35,7 @@ for (const withHook of [false, true]) {
             if (typeof result.exitCode !== "number" || !result.stdout.includes("seed demo")) {
               throw new Error("exec result not plain: " + JSON.stringify(result));
             }
-          },` : ""}
+          } },` : ""}
         });
       `);
       const script = `