@stacksjs/testing 0.74.27 → 0.74.28

package/dist/database.d.ts

@@ -0,0 +1,56 @@
+export declare function setupDatabase(): Promise<void>;
+export declare function refreshDatabase(): Promise<void>;
+export declare function truncateMysql(): Promise<void>;
+export declare function truncateSqlite(): Promise<void>;
+/**
+ * Snapshot-based SQLite reset. The very first call falls through to the
+ * legacy `truncateSqlite()` path (drop, recopy models, migrate) AND
+ * captures the resulting empty-but-migrated DB to a `.snapshot` file.
+ * Every subsequent call just copies that snapshot back over the live
+ * file — orders of magnitude faster than running migrations end to end
+ * for each test, and dramatically cheaper than the per-test model file
+ * recopy.
+ *
+ * The snapshot is invalidated automatically when:
+ *   - any model file is newer than the snapshot
+ *   - any migration file is newer than the snapshot
+ *
+ * — re-capturing in those cases keeps schema changes correct without
+ * the user remembering to clear it.
+ */
+export declare function truncateSqliteFast(): Promise<void>;
+/**
+ * Wrap each test in a database transaction that rolls back on completion.
+ *
+ * The fastest possible test isolation: instead of dropping/recopying
+ * the schema between tests, every test runs inside `BEGIN; … ROLLBACK;`
+ * so the row state at the end of one test is invisible to the next
+ * (and to the `--fresh` snapshot path entirely).
+ *
+ * Caveats — read these before reaching for this helper:
+ *   1. Code under test that issues its own `BEGIN`/`COMMIT` will commit
+ *      against the outer transaction and the rollback won't undo it
+ *      (Postgres doesn't support nested transactions natively).
+ *   2. Multi-statement tests that test "commit visibility across
+ *      connections" need the slower `refreshDatabase()` path because
+ *      the rolled-back transaction never reached the disk.
+ *   3. SQLite WAL mode is required for concurrent connections to see
+ *      each other within the same DB file; the framework configures
+ *      this by default.
+ *
+ * Use as a `beforeEach`/`afterEach` pair from your test setup:
+ *
+ * @example
+ * ```ts
+ * import { beforeEach, afterEach } from 'bun:test'
+ * import { useTransactionalTests } from '@stacksjs/testing/database'
+ *
+ * const tx = useTransactionalTests()
+ * beforeEach(tx.begin)
+ * afterEach(tx.rollback)
+ * ```
+ */
+export declare function useTransactionalTests(): {
+  begin: () => Promise<void>
+  rollback: () => Promise<void>
+};

package/dist/database.js

@@ -0,0 +1,2 @@
+// @bun
+import{config as l}from"@stacksjs/config";import{copyModelFiles as w,db as a,deleteFrameworkModels as y,dropSqliteTables as h,fetchSqliteFile as c,fetchTables as T,migrateAuthTables as S,migrateNotificationTables as g,migrateRbacTables as P,migrateTraitTables as E,ensureUtcDatetimeColumns as x,ensureUtcTimestampDefaults as A,runDatabaseMigration as u}from"@stacksjs/database";import{path as o}from"@stacksjs/path";import{fs as i,globSync as f}from"@stacksjs/storage";function m(){return l.database?.default||""}var r=null;function M(){if(r)return r;return r=`${c()}.snapshot`,r}async function d(){let t=[["auth",S],["notification",g],["RBAC",P],["trait",E],["utc-datetime",x],["utc-defaults",A]];for(let[e,n]of t)try{let s=await n();if(!s.success)console.error(`[testing] Failed to migrate ${e} tables: ${s.error}`)}catch(s){console.error(`[testing] Failed to migrate ${e} tables:`,s)}}async function v(){let t=`${l.database?.connections?.mysql?.name??"stacks"}_testing`;if(m()==="mysql")await a.unsafe(`CREATE DATABASE IF NOT EXISTS ${t}`).execute(),await u(),await d()}async function _(){await v();let t=m();if(t==="mysql")await F();if(t==="sqlite")await q()}async function F(){let t=await T();await a.unsafe("SET FOREIGN_KEY_CHECKS = 0").execute();try{for(let e of t)await a.unsafe(`TRUNCATE TABLE ${e}`).execute()}finally{await a.unsafe("SET FOREIGN_KEY_CHECKS = 1").execute()}}async function k(){let t=c();if(!i.existsSync(t))await Bun.$`touch ${t}`;await h(),await y();let e=f([o.userModelsPath("*.ts"),o.storagePath("framework/defaults/app/Models/**/*.ts")],{absolute:!0});for(let n of e)await w(n);await u(),await d()}async function q(){let t=c(),e=M();if((()=>{if(!i.existsSync(e))return!0;let s=i.statSync(e).mtimeMs,p=f([o.userModelsPath("*.ts"),o.storagePath("framework/defaults/app/Models/**/*.ts"),o.userMigrationsPath("*.ts")],{absolute:!0});for(let b of p)try{if(i.statSync(b).mtimeMs>s)return!0}catch{}return!1})()){await k();try{await a.unsafe("PRAGMA wal_checkpoint(TRUNCATE)").execute(),i.copyFileSync(t,e)}catch{}return}i.copyFileSync(e,t)}function D(){let t=null;return{begin:async()=>{let e=`stacks_test_${Date.now()}_${Math.floor(Math.random()*1e6)}`;await a.unsafe(`SAVEPOINT ${e}`).execute(),t={rollback:async()=>{await a.unsafe(`ROLLBACK TO SAVEPOINT ${e}`).execute(),await a.unsafe(`RELEASE SAVEPOINT ${e}`).execute()}}},rollback:async()=>{if(!t)return;try{await t.rollback()}finally{t=null}}}}export{_ as refreshDatabase,v as setupDatabase,F as truncateMysql,k as truncateSqlite,q as truncateSqliteFast,D as useTransactionalTests};

package/dist/dynamodb.d.ts

@@ -0,0 +1,3 @@
+export declare function launchServer(): Promise<void>;
+export declare function createStacksTable(): Promise<void>;
+export declare function deleteStacksTable(): Promise<void>;

package/dist/dynamodb.js

@@ -0,0 +1,2 @@
+// @bun
+import r from"process";import{DynamoDBClient as o}from"@stacksjs/ts-cloud";var i=await import("@stacksjs/cache").then((e)=>e.dynamoDbTool),t=new o("us-east-1");async function y(){if(!r.env.GITHUB_ACTIONS)await i.dynamoDb.launch();await n(5000),await c()}async function n(e){return new Promise((a)=>setTimeout(a,e))}async function c(){try{await t.createTable({TableName:"stacks",KeySchema:[{AttributeName:"key",KeyType:"HASH"}],AttributeDefinitions:[{AttributeName:"key",AttributeType:"S"}],ProvisionedThroughput:{ReadCapacityUnits:5,WriteCapacityUnits:5}})}catch(e){console.error("Error Creating Table",e)}}async function l(){try{await t.deleteTable({TableName:"stacks"})}catch(e){console.error("Error deleting table:",e)}}export{c as createStacksTable,l as deleteStacksTable,y as launchServer};

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/testing",
   "type": "module",
   "sideEffects": false,
-  "version": "0.74.27",
+  "version": "0.74.28",
   "description": "The Stacks way of testing.",
   "author": "Chris Breuer",
   "contributors": [
@@ -74,14 +74,14 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/auth": "0.74.27",
-    "@stacksjs/cache": "0.74.27",
-    "@stacksjs/config": "0.74.27",
-    "@stacksjs/database": "0.74.27",
-    "@stacksjs/path": "0.74.27",
-    "@stacksjs/router": "0.74.27",
-    "@stacksjs/storage": "0.74.27",
-    "@stacksjs/ts-cloud": "^0.12.10"
+    "@stacksjs/auth": "0.74.28",
+    "@stacksjs/cache": "0.74.28",
+    "@stacksjs/config": "0.74.28",
+    "@stacksjs/database": "0.74.28",
+    "@stacksjs/path": "0.74.28",
+    "@stacksjs/router": "0.74.28",
+    "@stacksjs/storage": "0.74.28",
+    "@stacksjs/ts-cloud": "^0.12.15"
   },
   "devDependencies": {
     "better-dx": "^0.2.24"