@nage-api/testing 1.0.0-beta.2

package/dist/test-api.d.ts

@@ -0,0 +1,64 @@
+/**
+ * The slice of a test framework this kit uses (PLAN.md §19, §27.3).
+ *
+ * Injected rather than imported, for two reasons. The published package does
+ * not depend on a test runner — so `@nage-api/testing` is safe to keep out of a
+ * production dependency graph without conditional exports — and a project that
+ * runs Jest in its generated app while the framework runs Vitest can still use
+ * the same packs (§27.3 recommends exactly that split).
+ *
+ * The shape is the one `describeRepositoryConformance` in `@nage-api/data` already
+ * established, widened only where a pack genuinely needs more.
+ */
+/** The matcher surface a pack may use. Deliberately small. */
+export interface Expectation {
+    toBe(expected: unknown): void;
+    toEqual(expected: unknown): void;
+    toBeNull(): void;
+    toBeUndefined(): void;
+    toBeDefined(): void;
+    toBeTruthy(): void;
+    toBeFalsy(): void;
+    toHaveLength(length: number): void;
+    toMatchObject(expected: object): void;
+    toContain(expected: unknown): void;
+    toBeGreaterThan(value: number): void;
+    toBeGreaterThanOrEqual(value: number): void;
+    toBeLessThan(value: number): void;
+    toThrow(expected?: unknown): void;
+    rejects: {
+        toThrow(expected?: unknown): Promise<void>;
+        toMatchObject(expected: object): Promise<void>;
+    };
+    resolves: {
+        toBe(expected: unknown): Promise<void>;
+        toEqual(expected: unknown): Promise<void>;
+        toBeUndefined(): Promise<void>;
+        toMatchObject(expected: object): Promise<void>;
+    };
+    not: {
+        toBe(expected: unknown): void;
+        toBeNull(): void;
+        toBeUndefined(): void;
+        toContain(expected: unknown): void;
+        toMatchObject(expected: object): void;
+        toThrow(expected?: unknown): void;
+    };
+}
+export interface TestApi {
+    describe: (name: string, fn: () => void) => void;
+    it: (name: string, fn: () => Promise<void> | void) => void;
+    beforeEach: (fn: () => Promise<void> | void) => void;
+    afterEach: (fn: () => Promise<void> | void) => void;
+    expect: (actual: unknown) => Expectation;
+}
+/**
+ * A pack that a package registers against its own implementation.
+ *
+ * Every security pack in this kit has this shape: the kit owns the *cases*, the
+ * package supplies the *subject*. A defect the kit knows about is then a
+ * failing test in every package that could have it, rather than a note in a
+ * document.
+ */
+export type Pack<THarness> = (api: TestApi, harness: THarness) => void;
+//# sourceMappingURL=test-api.d.ts.map

package/dist/test-api.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * The slice of a test framework this kit uses (PLAN.md §19, §27.3).
+ *
+ * Injected rather than imported, for two reasons. The published package does
+ * not depend on a test runner — so `@nage-api/testing` is safe to keep out of a
+ * production dependency graph without conditional exports — and a project that
+ * runs Jest in its generated app while the framework runs Vitest can still use
+ * the same packs (§27.3 recommends exactly that split).
+ *
+ * The shape is the one `describeRepositoryConformance` in `@nage-api/data` already
+ * established, widened only where a pack genuinely needs more.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=test-api.js.map

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@nage-api/testing",
+  "version": "1.0.0-beta.2",
+  "description": "Shared test kit for @nage-api — fixtures, port doubles, reusable security packs, container harness",
+  "license": "Apache-2.0",
+  "type": "commonjs",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "!dist/.tsbuildinfo",
+    "!dist/**/*.map",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@nage-api/contracts": "1.0.0-beta.2"
+  },
+  "devDependencies": {
+    "@types/node": "22.20.1",
+    "@vitest/coverage-v8": "4.1.10",
+    "rimraf": "6.1.3",
+    "typescript": "5.9.3",
+    "vitest": "4.1.10"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json",
+    "clean": "rimraf dist .turbo",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}