@velajs/testing 0.5.0 → 0.5.1

package/package.json

@@ -1,8 +1,36 @@
 {
   "name": "@velajs/testing",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Testing utilities for Vela framework",
+  "keywords": [
+    "edge",
+    "framework",
+    "mock",
+    "override",
+    "test",
+    "testing",
+    "vela"
+  ],
+  "homepage": "https://github.com/velajs/testing#readme",
+  "bugs": {
+    "url": "https://github.com/velajs/testing/issues"
+  },
+  "license": "MIT",
+  "author": "ksh",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/velajs/testing.git"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "type": "module",
+  "sideEffects": [
+    "./dist/websocket-node/index.js"
+  ],
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -15,43 +43,27 @@
       "import": "./dist/websocket-node/index.js"
     }
   },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE",
-    "CHANGELOG.md"
-  ],
-  "sideEffects": [
-    "./dist/websocket-node/index.js"
-  ],
-  "keywords": [
-    "vela",
-    "testing",
-    "test",
-    "mock",
-    "override",
-    "edge",
-    "framework"
-  ],
-  "author": "ksh",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/velajs/testing.git"
-  },
-  "homepage": "https://github.com/velajs/testing#readme",
-  "bugs": {
-    "url": "https://github.com/velajs/testing/issues"
-  },
-  "engines": {
-    "node": ">=20"
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.5",
+    "@changesets/cli": "^2.31.0",
+    "@swc/core": "^1.15.43",
+    "@types/node": "^24.13.3",
+    "@velajs/vela": "^1.12.0",
+    "hono": "^4.12.26",
+    "oxfmt": "^0.58.0",
+    "oxlint": "^1.73.0",
+    "publint": "^0.3.21",
+    "tsdown": "^0.22.4",
+    "typescript": "^7.0.2",
+    "unplugin-swc": "^1.5.9",
+    "vitest": "^4.1.10"
   },
   "peerDependencies": {
+    "@hono/node-server": ">=1",
+    "@hono/node-ws": ">=1",
     "@velajs/vela": ">=1.11.0",
     "hono": ">=4",
-    "vitest": ">=3",
-    "@hono/node-ws": ">=1",
-    "@hono/node-server": ">=1"
+    "vitest": ">=3"
   },
   "peerDependenciesMeta": {
     "@hono/node-ws": {
@@ -61,19 +73,21 @@
       "optional": true
     }
   },
-  "devDependencies": {
-    "@swc/cli": "^0.8.1",
-    "@swc/core": "^1.15.41",
-    "@types/bun": "latest",
-    "@velajs/vela": "^1.12.0",
-    "hono": "^4.12.26",
-    "typescript": "^6.0.3",
-    "unplugin-swc": "^1.5.9",
-    "vitest": "^4.1.9"
+  "engines": {
+    "node": ">=24"
   },
   "scripts": {
-    "build": "rm -rf dist && swc src -d dist --strip-leading-paths && tsc --emitDeclarationOnly",
+    "build": "tsdown",
     "test": "vitest run",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint .",
+    "format": "oxfmt .",
+    "format:check": "oxfmt --check .",
+    "publint": "publint",
+    "attw": "attw --pack . --profile esm-only",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "pnpm build && changeset publish",
+    "verify": "pnpm lint && pnpm format:check && pnpm build && pnpm typecheck && pnpm test && pnpm publint && pnpm attw"
   }
 }

package/dist/db/test-database.d.ts

@@ -1,27 +0,0 @@
-/**
- * TestDatabase
- *
- * A minimal driver contract for database assertions in tests. Vela has no ORM
- * in core, so the harness ships only this interface plus thin assertion
- * wrappers (`module.assertDatabaseHas/Missing/Count`). A consumer — or a future
- * `@velajs/crud` driver — provides the concrete implementation; the harness
- * never couples to a specific database library.
- *
- * @example
- * ```ts
- * class MyTestDb implements TestDatabase {
- *   async truncate() { ... }
- *   async has(table, where) { ... }
- *   async count(table) { ... }
- * }
- * await module.assertDatabaseHas(new MyTestDb(), 'user', { email: 'a@b.com' });
- * ```
- */
-export interface TestDatabase {
-    /** Remove all rows from every table (reset between tests). */
-    truncate(): Promise<void>;
-    /** Whether a row matching `where` exists in `table`. */
-    has(table: string, where: Record<string, unknown>): Promise<boolean>;
-    /** The number of rows in `table`. */
-    count(table: string): Promise<number>;
-}

package/dist/db/test-database.js

@@ -1,19 +0,0 @@
-/**
- * TestDatabase
- *
- * A minimal driver contract for database assertions in tests. Vela has no ORM
- * in core, so the harness ships only this interface plus thin assertion
- * wrappers (`module.assertDatabaseHas/Missing/Count`). A consumer — or a future
- * `@velajs/crud` driver — provides the concrete implementation; the harness
- * never couples to a specific database library.
- *
- * @example
- * ```ts
- * class MyTestDb implements TestDatabase {
- *   async truncate() { ... }
- *   async has(table, where) { ... }
- *   async count(table) { ... }
- * }
- * await module.assertDatabaseHas(new MyTestDb(), 'user', { email: 'a@b.com' });
- * ```
- */ export { };

package/dist/http/path-utils.d.ts

@@ -1,11 +0,0 @@
-/**
- * Read the value at a dot-notation path (e.g. `data.user.id`).
- * Returns `undefined` when any segment along the way is null/undefined.
- */
-export declare function getValueAtPath(obj: unknown, path: string): unknown;
-/**
- * Whether a dot-notation path exists on the object, even when the value at the
- * path is `null`/`undefined`. Distinguishes "key present but null" from "key
- * absent".
- */
-export declare function hasValueAtPath(obj: unknown, path: string): boolean;

package/dist/http/path-utils.js

@@ -1,37 +0,0 @@
-// Ported from @stratal/testing (MIT, © Temitayo Fadojutimi).
-/**
- * Read the value at a dot-notation path (e.g. `data.user.id`).
- * Returns `undefined` when any segment along the way is null/undefined.
- */ export function getValueAtPath(obj, path) {
-    const parts = path.split('.');
-    let current = obj;
-    for (const part of parts){
-        if (current === null || current === undefined) {
-            return undefined;
-        }
-        current = current[part];
-    }
-    return current;
-}
-/**
- * Whether a dot-notation path exists on the object, even when the value at the
- * path is `null`/`undefined`. Distinguishes "key present but null" from "key
- * absent".
- */ export function hasValueAtPath(obj, path) {
-    const parts = path.split('.');
-    let current = obj;
-    for (const part of parts){
-        if (current === null || current === undefined) {
-            return false;
-        }
-        if (typeof current !== 'object') {
-            return false;
-        }
-        const record = current;
-        if (!(part in record)) {
-            return false;
-        }
-        current = record[part];
-    }
-    return true;
-}

package/dist/http/test-http-client.d.ts

@@ -1,37 +0,0 @@
-import type { TestingModule } from '../testing-module.js';
-import { TestHttpRequest } from './test-http-request.js';
-/**
- * TestHttpClient
- *
- * Fluent entry point for test HTTP requests. `forHost`/`withHeaders` return a
- * new immutable client; the verb methods start a {@link TestHttpRequest}.
- *
- * @example
- * ```ts
- * const res = await module.http
- *   .forHost('example.com')
- *   .post('/users')
- *   .withBody({ name: 'A' })
- *   .send();
- * res.assertCreated();
- * ```
- */
-export declare class TestHttpClient {
-    private readonly module;
-    private readonly host;
-    private readonly defaultHeaders;
-    constructor(module: TestingModule, host?: string | null, defaultHeaders?: Headers);
-    /**
-     * Return a new client bound to `host`. Also sets the `Host` header so domain
-     * routing works even when the runtime reads the header rather than the URL.
-     */
-    forHost(host: string): TestHttpClient;
-    /** Return a new client with additional default headers on every request. */
-    withHeaders(headers: Record<string, string>): TestHttpClient;
-    get(path: string): TestHttpRequest;
-    post(path: string): TestHttpRequest;
-    put(path: string): TestHttpRequest;
-    patch(path: string): TestHttpRequest;
-    delete(path: string): TestHttpRequest;
-    private createRequest;
-}

package/dist/http/test-http-client.js

@@ -1,61 +0,0 @@
-// Adapted from @stratal/testing (MIT, © Temitayo Fadojutimi). Stratal's i18n
-// `withLocale` is dropped (vela i18n differs — optional follow-up).
-import { TestHttpRequest } from "./test-http-request.js";
-/**
- * TestHttpClient
- *
- * Fluent entry point for test HTTP requests. `forHost`/`withHeaders` return a
- * new immutable client; the verb methods start a {@link TestHttpRequest}.
- *
- * @example
- * ```ts
- * const res = await module.http
- *   .forHost('example.com')
- *   .post('/users')
- *   .withBody({ name: 'A' })
- *   .send();
- * res.assertCreated();
- * ```
- */ export class TestHttpClient {
-    module;
-    host;
-    defaultHeaders;
-    constructor(module, host = null, defaultHeaders = new Headers()){
-        this.module = module;
-        this.host = host;
-        this.defaultHeaders = defaultHeaders;
-    }
-    /**
-   * Return a new client bound to `host`. Also sets the `Host` header so domain
-   * routing works even when the runtime reads the header rather than the URL.
-   */ forHost(host) {
-        const headers = new Headers(this.defaultHeaders);
-        headers.set('Host', host);
-        return new TestHttpClient(this.module, host, headers);
-    }
-    /** Return a new client with additional default headers on every request. */ withHeaders(headers) {
-        const next = new Headers(this.defaultHeaders);
-        for (const [key, value] of Object.entries(headers)){
-            next.set(key, value);
-        }
-        return new TestHttpClient(this.module, this.host, next);
-    }
-    get(path) {
-        return this.createRequest('GET', path);
-    }
-    post(path) {
-        return this.createRequest('POST', path);
-    }
-    put(path) {
-        return this.createRequest('PUT', path);
-    }
-    patch(path) {
-        return this.createRequest('PATCH', path);
-    }
-    delete(path) {
-        return this.createRequest('DELETE', path);
-    }
-    createRequest(method, path) {
-        return new TestHttpRequest(method, path, this.defaultHeaders, this.module, this.host);
-    }
-}

package/dist/http/test-http-request.d.ts

@@ -1,46 +0,0 @@
-import type { ActingAsResolver, TestPrincipal, TestingModule } from '../testing-module.js';
-import { TestResponse } from './test-response.js';
-/**
- * TestHttpRequest
- *
- * Fluent builder for a single test HTTP request. `send()` builds a `Request`
- * and drives it through `module.fetch()` (the full Hono pipeline).
- *
- * @example
- * ```ts
- * const res = await module.http
- *   .post('/users')
- *   .withBody({ name: 'A' })
- *   .withHeaders({ 'X-Trace': '1' })
- *   .send();
- * res.assertCreated();
- * ```
- */
-export declare class TestHttpRequest {
-    private readonly method;
-    private readonly path;
-    private readonly module;
-    private readonly host;
-    private body;
-    private readonly requestHeaders;
-    private principal;
-    private resolver;
-    constructor(method: string, path: string, headers: Headers, module: TestingModule, host?: string | null);
-    /** Set the request body (JSON-serialized on send). */
-    withBody(data: unknown): this;
-    /** Merge additional headers. */
-    withHeaders(headers: Record<string, string>): this;
-    /** Set `Content-Type: application/json`. */
-    asJson(): this;
-    /**
-     * Authenticate the request as `principal`. The `resolver` (or a default one
-     * registered via `module.setAuthResolver`) turns the principal into request
-     * headers. The resolver signature `(module, principal) => Promise<Headers>`
-     * is the cross-package contract sibling packages (e.g. `@velajs/better-auth`)
-     * build against.
-     */
-    actingAs(principal: TestPrincipal, resolver?: ActingAsResolver): this;
-    /** Build the `Request` and send it through `module.fetch()`. */
-    send(): Promise<TestResponse>;
-    private applyAuthentication;
-}

package/dist/http/test-http-request.js

@@ -1,87 +0,0 @@
-// Adapted from @stratal/testing (MIT, © Temitayo Fadojutimi): stratal's hard
-// AuthService import is replaced by a generic auth-resolver seam so
-// @velajs/testing stays free of optional-package dependencies.
-import { TestResponse } from "./test-response.js";
-/**
- * TestHttpRequest
- *
- * Fluent builder for a single test HTTP request. `send()` builds a `Request`
- * and drives it through `module.fetch()` (the full Hono pipeline).
- *
- * @example
- * ```ts
- * const res = await module.http
- *   .post('/users')
- *   .withBody({ name: 'A' })
- *   .withHeaders({ 'X-Trace': '1' })
- *   .send();
- * res.assertCreated();
- * ```
- */ export class TestHttpRequest {
-    method;
-    path;
-    module;
-    host;
-    body = undefined;
-    requestHeaders;
-    principal = null;
-    resolver = null;
-    constructor(method, path, headers, module, host = null){
-        this.method = method;
-        this.path = path;
-        this.module = module;
-        this.host = host;
-        this.requestHeaders = new Headers(headers);
-    }
-    /** Set the request body (JSON-serialized on send). */ withBody(data) {
-        this.body = data;
-        return this;
-    }
-    /** Merge additional headers. */ withHeaders(headers) {
-        for (const [key, value] of Object.entries(headers)){
-            this.requestHeaders.set(key, value);
-        }
-        return this;
-    }
-    /** Set `Content-Type: application/json`. */ asJson() {
-        this.requestHeaders.set('Content-Type', 'application/json');
-        return this;
-    }
-    /**
-   * Authenticate the request as `principal`. The `resolver` (or a default one
-   * registered via `module.setAuthResolver`) turns the principal into request
-   * headers. The resolver signature `(module, principal) => Promise<Headers>`
-   * is the cross-package contract sibling packages (e.g. `@velajs/better-auth`)
-   * build against.
-   */ actingAs(principal, resolver) {
-        this.principal = principal;
-        this.resolver = resolver ?? null;
-        return this;
-    }
-    /** Build the `Request` and send it through `module.fetch()`. */ async send() {
-        await this.applyAuthentication();
-        const hasBody = this.body !== undefined && this.body !== null;
-        if (hasBody && !this.requestHeaders.has('Content-Type')) {
-            this.requestHeaders.set('Content-Type', 'application/json');
-        }
-        const url = new URL(this.path, `http://${this.host ?? 'localhost'}`);
-        const request = new Request(url.toString(), {
-            method: this.method,
-            headers: this.requestHeaders,
-            body: hasBody ? JSON.stringify(this.body) : null
-        });
-        const response = await this.module.fetch(request);
-        return new TestResponse(response);
-    }
-    async applyAuthentication() {
-        if (!this.principal) return;
-        const resolver = this.resolver ?? this.module.getAuthResolver();
-        if (!resolver) {
-            throw new Error('actingAs() requires an auth resolver. Pass one explicitly — ' + 'actingAs(principal, resolver) — or register a default with ' + 'module.setAuthResolver(resolver). For better-auth: ' + 'import { actingAs } from "@velajs/better-auth/testing".');
-        }
-        const headers = await resolver(this.module, this.principal);
-        for (const [key, value] of headers.entries()){
-            this.requestHeaders.set(key, value);
-        }
-    }
-}

package/dist/http/test-response.d.ts

@@ -1,76 +0,0 @@
-/**
- * TestResponse
- *
- * Wraps a `Response` with fluent, chainable assertions. Synchronous status /
- * header assertions return `this`; JSON assertions (which must read the body)
- * return `Promise<this>`.
- *
- * @example
- * ```ts
- * const res = await module.http.get('/users/1').send();
- * res.assertOk();
- * await res.assertJsonPath('data.id', 1);
- * ```
- */
-export declare class TestResponse {
-    private readonly response;
-    private jsonData;
-    private textData;
-    constructor(response: Response);
-    /** The raw `Response`. */
-    get raw(): Response;
-    /** The response status code. */
-    get status(): number;
-    /** The response headers. */
-    get headers(): Headers;
-    /** Parse (and cache) the response body as JSON. */
-    json<T = unknown>(): Promise<T>;
-    /** Read (and cache) the response body as text. */
-    text(): Promise<string>;
-    /** Assert status is 200 OK. */
-    assertOk(): this;
-    /** Assert status is 201 Created. */
-    assertCreated(): this;
-    /** Assert status is 204 No Content. */
-    assertNoContent(): this;
-    /** Assert status is 400 Bad Request. */
-    assertBadRequest(): this;
-    /** Assert status is 401 Unauthorized. */
-    assertUnauthorized(): this;
-    /** Assert status is 403 Forbidden. */
-    assertForbidden(): this;
-    /** Assert status is 404 Not Found. */
-    assertNotFound(): this;
-    /** Assert status is 422 Unprocessable Entity. */
-    assertUnprocessable(): this;
-    /** Assert status is 500 Internal Server Error. */
-    assertServerError(): this;
-    /** Assert the response has the given status code. */
-    assertStatus(expected: number): this;
-    /** Assert the status is in the 2xx range. */
-    assertSuccessful(): this;
-    /** Assert each key in `expected` equals the corresponding top-level value. */
-    assertJson(expected: Record<string, unknown>): Promise<this>;
-    /** Assert the value at a dot-notation path equals `expected`. */
-    assertJsonPath(path: string, expected: unknown): Promise<this>;
-    /** Assert every path/value pair in `expectations` matches (batch assert). */
-    assertJsonPaths(expectations: Record<string, unknown>): Promise<this>;
-    /** Assert the top-level JSON object has every key in `structure`. */
-    assertJsonStructure(structure: string[]): Promise<this>;
-    /** Assert a path exists (value may be anything, including `null`). */
-    assertJsonPathExists(path: string): Promise<this>;
-    /** Assert a path does not exist. */
-    assertJsonPathMissing(path: string): Promise<this>;
-    /** Assert the value at a path satisfies a predicate. */
-    assertJsonPathMatches(path: string, matcher: (value: unknown) => boolean): Promise<this>;
-    /** Assert the string value at a path contains `substring`. */
-    assertJsonPathContains(path: string, substring: string): Promise<this>;
-    /** Assert the array value at a path includes `item`. */
-    assertJsonPathIncludes(path: string, item: unknown): Promise<this>;
-    /** Assert the array value at a path has `count` items. */
-    assertJsonPathCount(path: string, count: number): Promise<this>;
-    /** Assert a header is present, optionally equal to `expected`. */
-    assertHeader(name: string, expected?: string): this;
-    /** Assert a header is absent. */
-    assertHeaderMissing(name: string): this;
-}