@stacksjs/testing 0.70.88 → 0.70.90

package/dist/feature.d.ts

@@ -0,0 +1,46 @@
+export declare function setupTestEnvironment(): void;
+export declare function featureTest(baseUrl?: string): FeatureTestClient;
+/**
+ * Lightweight feature-test helper. Returns a fluent client that wraps
+ * the request flow (`actingAs`, `json`, `assertStatus`, etc.) so test
+ * files don't have to re-implement boilerplate around `serverResponse`.
+ *
+ * Tests that need raw `fetch`-style access can still call the underlying
+ * server entrypoint directly — the helper is purely additive.
+ *
+ * @example
+ * ```ts
+ * import { featureTest, refreshDatabase } from '@stacksjs/testing'
+ *
+ * test('create post', async () => {
+ *   await refreshDatabase()
+ *   const user = await User.create({ email: 'a@b.com' })
+ *
+ *   const res = await featureTest()
+ *     .actingAs(user)
+ *     .post('/api/posts', { title: 'hello' })
+ *
+ *   res.assertStatus(201)
+ *   const body = await res.json<{ id: number, title: string }>()
+ *   expect(body.title).toBe('hello')
+ * })
+ * ```
+ */
+export declare interface FeatureTestResponse {
+  status: number
+  headers: Headers
+  text: () => Promise<string>
+  json: <T = unknown>() => Promise<T>
+  assertStatus: (expected: number) => FeatureTestResponse
+  assertJson: <T extends Record<string, unknown>>(partial: T) => Promise<FeatureTestResponse>
+  assertHeader: (name: string, expected?: string | RegExp) => FeatureTestResponse
+}
+export declare interface FeatureTestClient {
+  actingAs: (user: { id: number | string, [k: string]: unknown }) => FeatureTestClient
+  withHeaders: (headers: Record<string, string>) => FeatureTestClient
+  get: (path: string) => Promise<FeatureTestResponse>
+  post: (path: string, body?: unknown) => Promise<FeatureTestResponse>
+  put: (path: string, body?: unknown) => Promise<FeatureTestResponse>
+  patch: (path: string, body?: unknown) => Promise<FeatureTestResponse>
+  delete: (path: string, body?: unknown) => Promise<FeatureTestResponse>
+}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+// Lightweight test surface — `bun:test` re-exports + `setupTestEnvironment`.
+//
+// The database fixture helpers (`setupDatabase`, `refreshDatabase`,
+// `truncateMysql`, …) used to be re-exported from this root entry too,
+// but importing them eagerly drags in `@stacksjs/database`, which has
+// a self-import cycle through its `./drivers/*` re-exports that
+// deadlocks bun's module loader (60s @ 99% CPU) when imported outside
+// the framework's preloader context (e.g. by `bun test`'s preload).
+//
+// The vast majority of tests don't need the database fixtures — they
+// just want `describe / test / expect / beforeAll / afterAll` and
+// `setupTestEnvironment()` to flip APP_ENV. So the database helpers
+// are now opt-in via the package's `./database` subpath export
+// (already declared in package.json's `exports`):
+//
+//   import { setupDatabase, refreshDatabase } from '@stacksjs/testing/database'
+//
+// Tests that don't need them get a fast, hang-free import from
+// '@stacksjs/testing'.
+export * from './feature';
+export * from 'bun:test';

package/dist/index.js

@@ -0,0 +1,2 @@
+// @bun
+var W=import.meta.require;import K from"process";function N(){K.env.NODE_ENV="test",K.env.APP_ENV="test"}async function Y(){return(await import("@stacksjs/router")).serverResponse}function Z(F){let G={status:F.status,headers:F.headers,text:()=>F.text(),json:async()=>await F.clone().json(),assertStatus(C){if(this.status!==C)throw Error(`Expected status ${C}, got ${this.status}`);return G},async assertJson(C){let D=await F.clone().json();for(let[B,I]of Object.entries(C))if(JSON.stringify(D[B])!==JSON.stringify(I))throw Error(`assertJson: expected ${B}=${JSON.stringify(I)}, got ${JSON.stringify(D[B])}`);return G},assertHeader(C,D){let B=F.headers.get(C);if(B===null)throw Error(`assertHeader: missing header '${C}'`);if(D!==void 0){if(!(typeof D==="string"?B===D:D.test(B)))throw Error(`assertHeader: expected ${C}=${String(D)}, got '${B}'`)}return G}};return G}function R(F="http://localhost"){let G=null,C={};function D(q){let z={Accept:"application/json",...C};if(q!==void 0)z["Content-Type"]="application/json";if(G)z["X-Test-Acting-User"]=JSON.stringify(G);return z}async function B(q,z,J){let L=await Y(),M=z.startsWith("http")?z:`${F}${z}`,O={method:q,headers:D(J),body:J===void 0?void 0:typeof J==="string"?J:JSON.stringify(J)},Q=await L(new Request(M,O));return Z(Q)}let I={actingAs(q){return G=q,I},withHeaders(q){return C={...C,...q},I},get:(q)=>B("GET",q),post:(q,z)=>B("POST",q,z),put:(q,z)=>B("PUT",q,z),patch:(q,z)=>B("PATCH",q,z),delete:(q,z)=>B("DELETE",q,z)};return I}export*from"bun:test";export{N as setupTestEnvironment,R as featureTest};

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/testing",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.88",
+  "version": "0.70.90",
   "description": "The Stacks way of testing.",
   "author": "Chris Breuer",
   "contributors": [
@@ -74,8 +74,8 @@
     "@stacksjs/ts-cloud": "^0.7.17"
   },
   "devDependencies": {
-    "@stacksjs/config": "0.70.88",
-    "@stacksjs/database": "0.70.88",
+    "@stacksjs/config": "0.70.90",
+    "@stacksjs/database": "0.70.90",
     "better-dx": "^0.2.16"
   }
 }