@stardeck-customer-apps/testing 0.13.0 → 0.14.0

package/SKILL.md

@@ -295,6 +295,32 @@ expect(app.edge.latestDisplay()?.action).toBe("show");
   - `allowNetwork` — permit non-Stardeck outbound fetches (off by default).
 - `app.reset()` — wipe + re-apply schema + re-seed + clear inbox/sessions.
   Call in `beforeEach`.
+- `app.reset({ mode: "data" })` — available in testing SDK **0.14.0+**. Faster
+  opt-in for stable schemas: truncate ordinary tables in `public`, restart their
+  owned serial/identity sequences, re-run the data-only seed, and clear the same
+  simulator/user/session state as the default. It preserves tables and other
+  schema objects instead of rebuilding them. The default remains full schema
+  reset; `app.reset({ mode: "schema" })` explicitly selects that default.
+
+  ```ts
+  // Only after verifying this suite keeps its schema fixed and uses a data-only seed:
+  beforeEach(() => app.reset({ mode: "data" }));
+  ```
+
+  Keep `app.reset()` for tests that change schema or depend on INSERTs in the
+  schema script. Also keep full reset for independent sequences, materialized
+  views, partitioned/foreign tables, temporary tables, and custom triggers or
+  cross-schema dependencies. Data mode does not restore those states or detect
+  eligibility; inspect both the tests and seed before opting in. All required
+  baseline rows must come from the data-only seed callback, not schema SQL.
+  Data mode refuses foreign keys requiring a cross-schema cascade. Database and
+  seed errors reject the reset; fix them before running the next test.
+
+  Do not use `it.concurrent` or `test.concurrent` with a shared test app: user,
+  database, and simulator state are shared within the file. Keep file isolation
+  enabled and let Vitest parallelize files. This option does not change workers
+  or the platform's test-run deadline.
+
 - `app.asUser(partial?)` — sign in a test user; `getSession()` in app code
   resolves to it. `app.signOut()` clears.
 - `app.issueSession(partial?)` — mint access/refresh tokens for cookie-based

package/dist/index.d.mts

@@ -520,8 +520,15 @@ interface TestApp {
      * control-plane verify endpoint resolves these tokens back to the user.
      */
     issueSession(user?: Partial<TestUser>): SessionTokens;
-    /** Drop all tables, re-apply the schema, re-run the seed, clear inbox/user. */
-    reset(): Promise<void>;
+    /**
+     * Rebuild the schema (default), re-run the seed, and clear simulator/user state.
+     * `mode: "data"` instead truncates ordinary public tables and restarts owned
+     * sequences. Use only with a stable schema and data-only seed; it does not
+     * restore DDL changes, schema-script data, or independent sequences.
+     */
+    reset(options?: {
+        mode: "schema" | "data";
+    }): Promise<void>;
     /** Tear down the app and restore global fetch. */
     close(): Promise<void>;
 }

package/dist/index.d.ts

@@ -520,8 +520,15 @@ interface TestApp {
      * control-plane verify endpoint resolves these tokens back to the user.
      */
     issueSession(user?: Partial<TestUser>): SessionTokens;
-    /** Drop all tables, re-apply the schema, re-run the seed, clear inbox/user. */
-    reset(): Promise<void>;
+    /**
+     * Rebuild the schema (default), re-run the seed, and clear simulator/user state.
+     * `mode: "data"` instead truncates ordinary public tables and restarts owned
+     * sequences. Use only with a stable schema and data-only seed; it does not
+     * restore DDL changes, schema-script data, or independent sequences.
+     */
+    reset(options?: {
+        mode: "schema" | "data";
+    }): Promise<void>;
     /** Tear down the app and restore global fetch. */
     close(): Promise<void>;
 }

package/dist/index.js

@@ -73,6 +73,19 @@ async function applySchema(db, schemaSql) {
 async function dropAllTables(db) {
   await db.exec(`DROP SCHEMA public CASCADE; CREATE SCHEMA public;`);
 }
+async function listPublicTables(db) {
+  const { rows } = await db.query(`
+    SELECT format('%I.%I', n.nspname, c.relname) AS name
+    FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace
+    WHERE n.nspname = 'public' AND c.relkind = 'r'
+    ORDER BY c.relname
+  `);
+  return rows.map(({ name }) => name);
+}
+async function truncateAllTables(db) {
+  const tables = await listPublicTables(db);
+  if (tables.length) await db.exec(`TRUNCATE TABLE ${tables.join(", ")} RESTART IDENTITY`);
+}
 var identityParsers = null;
 function getIdentityParsers() {
   if (!identityParsers) {
@@ -2841,9 +2854,14 @@ async function createTestApp(options = {}) {
       state.refreshSessions.set(tokens.refreshToken, fullUser);
       return tokens;
     },
-    async reset() {
-      await dropAllTables(db);
-      await initialize();
+    async reset(resetOptions) {
+      if (resetOptions?.mode === "data") {
+        await truncateAllTables(db);
+        if (options.seed) await options.seed(db);
+      } else {
+        await dropAllTables(db);
+        await initialize();
+      }
       state.currentUser = null;
       state.sessions.clear();
       state.refreshSessions.clear();

package/dist/index.mjs

@@ -24,6 +24,19 @@ async function applySchema(db, schemaSql) {
 async function dropAllTables(db) {
   await db.exec(`DROP SCHEMA public CASCADE; CREATE SCHEMA public;`);
 }
+async function listPublicTables(db) {
+  const { rows } = await db.query(`
+    SELECT format('%I.%I', n.nspname, c.relname) AS name
+    FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace
+    WHERE n.nspname = 'public' AND c.relkind = 'r'
+    ORDER BY c.relname
+  `);
+  return rows.map(({ name }) => name);
+}
+async function truncateAllTables(db) {
+  const tables = await listPublicTables(db);
+  if (tables.length) await db.exec(`TRUNCATE TABLE ${tables.join(", ")} RESTART IDENTITY`);
+}
 var identityParsers = null;
 function getIdentityParsers() {
   if (!identityParsers) {
@@ -2792,9 +2805,14 @@ async function createTestApp(options = {}) {
       state.refreshSessions.set(tokens.refreshToken, fullUser);
       return tokens;
     },
-    async reset() {
-      await dropAllTables(db);
-      await initialize();
+    async reset(resetOptions) {
+      if (resetOptions?.mode === "data") {
+        await truncateAllTables(db);
+        if (options.seed) await options.seed(db);
+      } else {
+        await dropAllTables(db);
+        await initialize();
+      }
       state.currentUser = null;
       state.sessions.clear();
       state.refreshSessions.clear();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stardeck-customer-apps/testing",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Vitest test harness for Stardeck customer apps — in-process Postgres (PGlite) plus a control-plane simulator so the real Stardeck SDKs run unmodified in tests",
   "main": "dist/index.js",
   "module": "dist/index.mjs",