@typokit/testing 0.1.4

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+import type { TypoKitApp } from "@typokit/core";
+import type { RouteContract } from "@typokit/types";
+export { createIntegrationSuite, registerSeed, getSeed, } from "./integration-suite.js";
+export type { IntegrationSuite, IntegrationSuiteOptions, InMemoryDatabase, SeedFn, } from "./integration-suite.js";
+export { createFactory } from "./factory.js";
+export type { Factory, FactoryOptions } from "./factory.js";
+export { toMatchSchema, matchSchema, registerSchemaValidators, getSchemaValidator, clearSchemaValidators, } from "./schema-matcher.js";
+export type { SchemaMatchResult, SchemaMatchers } from "./schema-matcher.js";
+export { generateContractTests, detectTestRunner, } from "./contract-generator.js";
+export type { ContractTestRoute, ContractTestOptions, ContractTestOutput, TestRunner, } from "./contract-generator.js";
+/** Response returned by test client methods */
+export interface TestResponse<TBody = unknown> {
+    status: number;
+    body: TBody;
+    headers: Record<string, string>;
+}
+/** Options for test client request methods */
+export interface TestRequestOptions {
+    body?: unknown;
+    query?: Record<string, string | string[]>;
+    headers?: Record<string, string>;
+}
+/** Type-safe request options using a RouteContract */
+export interface TypedRequestOptions<TContract extends RouteContract<unknown, unknown, unknown, unknown>> {
+    body?: TContract["body"] extends void ? never : TContract["body"];
+    query?: TContract["query"] extends void ? never : TContract["query"];
+    headers?: Record<string, string>;
+}
+/** A test client for making typed HTTP requests against a TypoKit app */
+export interface TestClient {
+    /** Send a GET request */
+    get<TResponse = unknown>(path: string, options?: TestRequestOptions): Promise<TestResponse<TResponse>>;
+    /** Send a POST request */
+    post<TResponse = unknown>(path: string, options?: TestRequestOptions): Promise<TestResponse<TResponse>>;
+    /** Send a PUT request */
+    put<TResponse = unknown>(path: string, options?: TestRequestOptions): Promise<TestResponse<TResponse>>;
+    /** Send a PATCH request */
+    patch<TResponse = unknown>(path: string, options?: TestRequestOptions): Promise<TestResponse<TResponse>>;
+    /** Send a DELETE request */
+    delete<TResponse = unknown>(path: string, options?: TestRequestOptions): Promise<TestResponse<TResponse>>;
+    /** Send a contract-typed request */
+    request<TContract extends RouteContract<unknown, unknown, unknown, unknown>>(method: string, path: string, options?: TypedRequestOptions<TContract>): Promise<TestResponse<TContract["response"]>>;
+    /** Shut down the test server */
+    close(): Promise<void>;
+    /** The base URL the test server is listening on */
+    baseUrl: string;
+}
+/**
+ * Create a test client for a TypoKit application.
+ *
+ * Starts the app on a random port and returns a typed HTTP client.
+ * Call `client.close()` when done to shut down the server.
+ *
+ * ```ts
+ * const client = await createTestClient(app);
+ * const res = await client.get<{ message: string }>("/hello");
+ * expect(res.status).toBe(200);
+ * await client.close();
+ * ```
+ */
+export declare function createTestClient(app: TypoKitApp): Promise<TestClient>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,119 @@
+// @typokit/testing — Test Client, Integration Suite & Factories
+export { createIntegrationSuite, registerSeed, getSeed, } from "./integration-suite.js";
+export { createFactory } from "./factory.js";
+export { toMatchSchema, matchSchema, registerSchemaValidators, getSchemaValidator, clearSchemaValidators, } from "./schema-matcher.js";
+export { generateContractTests, detectTestRunner, } from "./contract-generator.js";
+// ─── Internal Helpers ────────────────────────────────────────
+/** Build a URL with query parameters */
+function buildUrl(base, path, query) {
+    let url = `${base}${path}`;
+    if (query && Object.keys(query).length > 0) {
+        const params = new URLSearchParams();
+        for (const [key, value] of Object.entries(query)) {
+            if (Array.isArray(value)) {
+                for (const v of value) {
+                    params.append(key, v);
+                }
+            }
+            else {
+                params.append(key, value);
+            }
+        }
+        url += `?${params.toString()}`;
+    }
+    return url;
+}
+/** Parse response headers into a flat Record */
+function parseHeaders(headers) {
+    const result = {};
+    headers.forEach((value, key) => {
+        result[key] = value;
+    });
+    return result;
+}
+/** Execute an HTTP request and return a TestResponse */
+async function executeRequest(baseUrl, method, path, options = {}) {
+    const url = buildUrl(baseUrl, path, options.query);
+    const headers = { ...options.headers };
+    let bodyStr;
+    if (options.body !== undefined) {
+        if (!headers["content-type"]) {
+            headers["content-type"] = "application/json";
+        }
+        bodyStr =
+            typeof options.body === "string"
+                ? options.body
+                : JSON.stringify(options.body);
+    }
+    const response = await fetch(url, {
+        method,
+        headers,
+        body: bodyStr,
+    });
+    const responseHeaders = parseHeaders(response.headers);
+    const contentType = response.headers.get("content-type") ?? "";
+    let body;
+    if (contentType.includes("application/json")) {
+        body = (await response.json());
+    }
+    else {
+        body = (await response.text());
+    }
+    return {
+        status: response.status,
+        body,
+        headers: responseHeaders,
+    };
+}
+// ─── createTestClient ────────────────────────────────────────
+/**
+ * Create a test client for a TypoKit application.
+ *
+ * Starts the app on a random port and returns a typed HTTP client.
+ * Call `client.close()` when done to shut down the server.
+ *
+ * ```ts
+ * const client = await createTestClient(app);
+ * const res = await client.get<{ message: string }>("/hello");
+ * expect(res.status).toBe(200);
+ * await client.close();
+ * ```
+ */
+export async function createTestClient(app) {
+    // Start on port 0 for auto-assigned random port
+    await app.listen(0);
+    // Get the actual port from the underlying server
+    const nativeServer = app.getNativeServer();
+    const addr = nativeServer.address();
+    if (!addr || typeof addr === "string") {
+        throw new Error("Failed to determine server port");
+    }
+    const port = addr.port;
+    const baseUrl = `http://127.0.0.1:${port}`;
+    const client = {
+        baseUrl,
+        get(path, options) {
+            return executeRequest(baseUrl, "GET", path, options);
+        },
+        post(path, options) {
+            return executeRequest(baseUrl, "POST", path, options);
+        },
+        put(path, options) {
+            return executeRequest(baseUrl, "PUT", path, options);
+        },
+        patch(path, options) {
+            return executeRequest(baseUrl, "PATCH", path, options);
+        },
+        delete(path, options) {
+            return executeRequest(baseUrl, "DELETE", path, options);
+        },
+        request(method, path, options) {
+            return executeRequest(baseUrl, method, path, options);
+        },
+        async close() {
+            await app.close();
+        },
+    };
+    return client;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/integration-suite.d.ts

@@ -0,0 +1,66 @@
+import type { TypoKitApp } from "@typokit/core";
+import type { TestClient } from "./index.js";
+/** A simple in-memory database for integration testing */
+export interface InMemoryDatabase {
+    /** Insert a record into a table */
+    insert(table: string, record: Record<string, unknown>): void;
+    /** Find all records in a table */
+    findAll(table: string): Record<string, unknown>[];
+    /** Find a record by id field */
+    findById(table: string, id: string): Record<string, unknown> | undefined;
+    /** Delete all records from a table */
+    clearTable(table: string): void;
+    /** Delete all records from all tables */
+    clear(): void;
+    /** Get the list of table names */
+    tables(): string[];
+}
+/** A seed function populates an in-memory database with test data */
+export type SeedFn = (db: InMemoryDatabase) => void;
+/** Register a named seed data fixture */
+export declare function registerSeed(name: string, seed: SeedFn): void;
+/** Get a registered seed function by name */
+export declare function getSeed(name: string): SeedFn | undefined;
+/** Options for creating an integration test suite */
+export interface IntegrationSuiteOptions {
+    /** Whether to spin up an in-memory database (default: false) */
+    database?: boolean;
+    /** Name of a registered seed data fixture to apply */
+    seed?: string;
+}
+/** An integration test suite with managed server and database lifecycle */
+export interface IntegrationSuite {
+    /** Start the server and seed the database */
+    setup(): Promise<void>;
+    /** Stop the server and clean up */
+    teardown(): Promise<void>;
+    /** The typed test client (available after setup) */
+    readonly client: TestClient;
+    /** The in-memory database (null if database option is false) */
+    readonly db: InMemoryDatabase | null;
+}
+/**
+ * Create an integration test suite for a TypoKit application.
+ *
+ * Sets up an isolated server and optionally an in-memory database
+ * with seeded test data. Each call creates a fully independent
+ * instance with no shared mutable state.
+ *
+ * ```ts
+ * const suite = createIntegrationSuite(app, {
+ *   database: true,
+ *   seed: "users",
+ * });
+ *
+ * // In beforeEach / setup
+ * await suite.setup();
+ *
+ * // In tests
+ * const res = await suite.client.get("/users");
+ *
+ * // In afterEach / teardown
+ * await suite.teardown();
+ * ```
+ */
+export declare function createIntegrationSuite(app: TypoKitApp, options?: IntegrationSuiteOptions): IntegrationSuite;
+//# sourceMappingURL=integration-suite.d.ts.map

package/dist/integration-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-suite.d.ts","sourceRoot":"","sources":["../src/integration-suite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE7D,kCAAkC;IAClC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAElD,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAEzE,sCAAsC;IACtC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC,yCAAyC;IACzC,KAAK,IAAI,IAAI,CAAC;IAEd,kCAAkC;IAClC,MAAM,IAAI,MAAM,EAAE,CAAC;CACpB;AAyCD,qEAAqE;AACrE,MAAM,MAAM,MAAM,GAAG,CAAC,EAAE,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAIpD,yCAAyC;AACzC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7D;AAED,6CAA6C;AAC7C,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExD;AAID,qDAAqD;AACrD,MAAM,WAAW,uBAAuB;IACtC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,2EAA2E;AAC3E,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,mCAAmC;IACnC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAE5B,gEAAgE;IAChE,QAAQ,CAAC,EAAE,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,UAAU,EACf,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CAuDlB"}

package/dist/integration-suite.js

@@ -0,0 +1,110 @@
+// @typokit/testing — Integration Test Suite
+import { createTestClient } from "./index.js";
+function createInMemoryDatabase() {
+    const store = new Map();
+    return {
+        insert(table, record) {
+            if (!store.has(table)) {
+                store.set(table, []);
+            }
+            // Clone the record to prevent shared references
+            store.get(table).push({ ...record });
+        },
+        findAll(table) {
+            return (store.get(table) ?? []).map((r) => ({ ...r }));
+        },
+        findById(table, id) {
+            const records = store.get(table);
+            if (!records)
+                return undefined;
+            const found = records.find((r) => r["id"] === id);
+            return found ? { ...found } : undefined;
+        },
+        clearTable(table) {
+            store.delete(table);
+        },
+        clear() {
+            store.clear();
+        },
+        tables() {
+            return [...store.keys()];
+        },
+    };
+}
+const seedRegistry = new Map();
+/** Register a named seed data fixture */
+export function registerSeed(name, seed) {
+    seedRegistry.set(name, seed);
+}
+/** Get a registered seed function by name */
+export function getSeed(name) {
+    return seedRegistry.get(name);
+}
+/**
+ * Create an integration test suite for a TypoKit application.
+ *
+ * Sets up an isolated server and optionally an in-memory database
+ * with seeded test data. Each call creates a fully independent
+ * instance with no shared mutable state.
+ *
+ * ```ts
+ * const suite = createIntegrationSuite(app, {
+ *   database: true,
+ *   seed: "users",
+ * });
+ *
+ * // In beforeEach / setup
+ * await suite.setup();
+ *
+ * // In tests
+ * const res = await suite.client.get("/users");
+ *
+ * // In afterEach / teardown
+ * await suite.teardown();
+ * ```
+ */
+export function createIntegrationSuite(app, options = {}) {
+    let client = null;
+    let db = null;
+    const suite = {
+        async setup() {
+            // Create a fresh in-memory database if requested
+            if (options.database) {
+                db = createInMemoryDatabase();
+                // Apply seed data if specified
+                if (options.seed) {
+                    const seedFn = getSeed(options.seed);
+                    if (!seedFn) {
+                        throw new Error(`Unknown seed fixture: "${options.seed}". Register it with registerSeed() first.`);
+                    }
+                    seedFn(db);
+                }
+            }
+            // Start the server and create a test client
+            client = await createTestClient(app);
+        },
+        async teardown() {
+            // Close the test client / server
+            if (client) {
+                await client.close();
+                client = null;
+            }
+            // Clear the database
+            if (db) {
+                db.clear();
+                db = null;
+            }
+        },
+        get client() {
+            if (!client) {
+                throw new Error("Integration suite not set up. Call suite.setup() first.");
+            }
+            return client;
+        },
+        get db() {
+            return db;
+        },
+    };
+    return suite;
+}
+//# sourceMappingURL=integration-suite.js.map

package/dist/integration-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-suite.js","sourceRoot":"","sources":["../src/integration-suite.ts"],"names":[],"mappings":"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"}

package/dist/schema-matcher.d.ts

@@ -0,0 +1,78 @@
+import type { ValidatorFn, ValidatorMap } from "@typokit/types";
+/**
+ * Register compiled validators for use with toMatchSchema().
+ * Call this in your test setup with validators from your build output.
+ *
+ * ```ts
+ * import { registerSchemaValidators } from "@typokit/testing";
+ * registerSchemaValidators({
+ *   PublicUser: (input) => ({ success: true, data: input }),
+ *   CreateUserInput: myTypiaValidator,
+ * });
+ * ```
+ */
+export declare function registerSchemaValidators(validators: ValidatorMap): void;
+/**
+ * Get a validator by schema name. Throws if not registered.
+ */
+export declare function getSchemaValidator(schemaName: string): ValidatorFn;
+/** Clear all registered validators (for test isolation) */
+export declare function clearSchemaValidators(): void;
+/** Result of a schema match operation */
+export interface SchemaMatchResult {
+    pass: boolean;
+    message: string;
+}
+/**
+ * Core schema matching logic shared by all framework adapters.
+ */
+export declare function matchSchema(received: unknown, schemaName: string): SchemaMatchResult;
+/**
+ * Custom matcher for Jest, Vitest, and Rstest expect() chains.
+ *
+ * All three frameworks share compatible matcher APIs:
+ * - `this.isNot` indicates `.not.toMatchSchema()` usage
+ * - Return `{ pass, message() }` object
+ *
+ * Usage:
+ * ```ts
+ * import { toMatchSchema, registerSchemaValidators } from "@typokit/testing";
+ *
+ * // For Jest:
+ * expect.extend({ toMatchSchema });
+ *
+ * // For Vitest:
+ * expect.extend({ toMatchSchema });
+ *
+ * // For Rstest:
+ * expect.extend({ toMatchSchema });
+ *
+ * // Then in tests:
+ * expect(responseBody).toMatchSchema("PublicUser");
+ * ```
+ */
+export declare function toMatchSchema(this: {
+    isNot?: boolean;
+} | void, received: unknown, schemaName: string): {
+    pass: boolean;
+    message: () => string;
+};
+/**
+ * Type declaration for extending expect() in Jest, Vitest, and Rstest.
+ *
+ * Users should add to their test setup:
+ * ```ts
+ * declare module "expect" {
+ *   interface AsymmetricMatchers {
+ *     toMatchSchema(schemaName: string): void;
+ *   }
+ *   interface Matchers<R> {
+ *     toMatchSchema(schemaName: string): R;
+ *   }
+ * }
+ * ```
+ */
+export interface SchemaMatchers<R = unknown> {
+    toMatchSchema(schemaName: string): R;
+}
+//# sourceMappingURL=schema-matcher.d.ts.map

package/dist/schema-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-matcher.d.ts","sourceRoot":"","sources":["../src/schema-matcher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAEb,MAAM,gBAAgB,CAAC;AAOxB;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,YAAY,GAAG,IAAI,CAEvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAWlE;AAED,2DAA2D;AAC3D,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAID,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAgBD;;GAEG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,MAAM,GACjB,iBAAiB,CAoBnB;AAID;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,EAChC,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,MAAM,GACjB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,MAAM,CAAA;CAAE,CAO1C;AAID;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,CAAC;CACtC"}

package/dist/schema-matcher.js

@@ -0,0 +1,99 @@
+// @typokit/testing — toMatchSchema custom matcher
+// Adapters for Jest, Vitest, and Rstest
+// ─── Schema Registry ─────────────────────────────────────────
+/** Global registry of compiled validators keyed by schema name */
+let validatorRegistry = {};
+/**
+ * Register compiled validators for use with toMatchSchema().
+ * Call this in your test setup with validators from your build output.
+ *
+ * ```ts
+ * import { registerSchemaValidators } from "@typokit/testing";
+ * registerSchemaValidators({
+ *   PublicUser: (input) => ({ success: true, data: input }),
+ *   CreateUserInput: myTypiaValidator,
+ * });
+ * ```
+ */
+export function registerSchemaValidators(validators) {
+    validatorRegistry = { ...validatorRegistry, ...validators };
+}
+/**
+ * Get a validator by schema name. Throws if not registered.
+ */
+export function getSchemaValidator(schemaName) {
+    const validator = validatorRegistry[schemaName];
+    if (!validator) {
+        const available = Object.keys(validatorRegistry);
+        throw new Error(`Schema "${schemaName}" not registered. ` +
+            `Available schemas: ${available.length > 0 ? available.join(", ") : "(none)"}. ` +
+            `Call registerSchemaValidators() in your test setup.`);
+    }
+    return validator;
+}
+/** Clear all registered validators (for test isolation) */
+export function clearSchemaValidators() {
+    validatorRegistry = {};
+}
+// ─── Core Matcher Logic ──────────────────────────────────────
+/**
+ * Format validation errors into a human-readable message.
+ */
+function formatErrors(errors) {
+    return errors
+        .map((e) => `  • ${e.path}: expected ${e.expected}, received ${JSON.stringify(e.actual)}`)
+        .join("\n");
+}
+/**
+ * Core schema matching logic shared by all framework adapters.
+ */
+export function matchSchema(received, schemaName) {
+    const validator = getSchemaValidator(schemaName);
+    const result = validator(received);
+    if (result.success) {
+        return {
+            pass: true,
+            message: `Expected value NOT to match schema "${schemaName}", but it did.`,
+        };
+    }
+    const errorDetails = result.errors && result.errors.length > 0
+        ? `\nField errors:\n${formatErrors(result.errors)}`
+        : "";
+    return {
+        pass: false,
+        message: `Expected value to match schema "${schemaName}", but validation failed.${errorDetails}`,
+    };
+}
+// ─── Jest / Vitest / Rstest Adapter ──────────────────────────
+/**
+ * Custom matcher for Jest, Vitest, and Rstest expect() chains.
+ *
+ * All three frameworks share compatible matcher APIs:
+ * - `this.isNot` indicates `.not.toMatchSchema()` usage
+ * - Return `{ pass, message() }` object
+ *
+ * Usage:
+ * ```ts
+ * import { toMatchSchema, registerSchemaValidators } from "@typokit/testing";
+ *
+ * // For Jest:
+ * expect.extend({ toMatchSchema });
+ *
+ * // For Vitest:
+ * expect.extend({ toMatchSchema });
+ *
+ * // For Rstest:
+ * expect.extend({ toMatchSchema });
+ *
+ * // Then in tests:
+ * expect(responseBody).toMatchSchema("PublicUser");
+ * ```
+ */
+export function toMatchSchema(received, schemaName) {
+    const result = matchSchema(received, schemaName);
+    return {
+        pass: result.pass,
+        message: () => result.message,
+    };
+}
+//# sourceMappingURL=schema-matcher.js.map

package/dist/schema-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-matcher.js","sourceRoot":"","sources":["../src/schema-matcher.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,wCAAwC;AAQxC,gEAAgE;AAEhE,kEAAkE;AAClE,IAAI,iBAAiB,GAAiB,EAAE,CAAC;AAEzC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB,CAAC,UAAwB;IAC/D,iBAAiB,GAAG,EAAE,GAAG,iBAAiB,EAAE,GAAG,UAAU,EAAE,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,MAAM,SAAS,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,WAAW,UAAU,oBAAoB;YACvC,sBAAsB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI;YAChF,qDAAqD,CACxD,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,qBAAqB;IACnC,iBAAiB,GAAG,EAAE,CAAC;AACzB,CAAC;AAUD,gEAAgE;AAEhE;;GAEG;AACH,SAAS,YAAY,CAAC,MAA8B;IAClD,OAAO,MAAM;SACV,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,OAAO,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,QAAQ,cAAc,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAChF;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,QAAiB,EACjB,UAAkB;IAElB,MAAM,SAAS,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAEnC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO;YACL,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,uCAAuC,UAAU,gBAAgB;SAC3E,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAChB,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACvC,CAAC,CAAC,oBAAoB,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;QACnD,CAAC,CAAC,EAAE,CAAC;IAET,OAAO;QACL,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,mCAAmC,UAAU,4BAA4B,YAAY,EAAE;KACjG,CAAC;AACJ,CAAC;AAED,gEAAgE;AAEhE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,aAAa,CAE3B,QAAiB,EACjB,UAAkB;IAElB,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAEjD,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO;KAC9B,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@typokit/testing",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "version": "0.1.4",
+  "type": "module",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@typokit/core": "0.1.4",
+    "@typokit/types": "0.1.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@typokit/server-native": "0.1.4",
+    "@typokit/platform-node": "0.1.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/KyleBastien/typokit",
+    "directory": "packages/testing"
+  },
+  "scripts": {
+    "test": "rstest run --passWithNoTests"
+  }
+}