@ucdjs/test-utils 1.0.1-beta.1

package/dist/mock-store.mjs

@@ -0,0 +1,210 @@
+import { mockFetch } from "./msw.mjs";
+import { a as parseLatency, c as unsafeResponse, d as defaultArabicShapingFileContent, f as addPathsToFileNodes, i as omitChildrenAndContent, l as defaultDerivedBidClassFileContent, n as MOCK_ROUTES, o as wrapMockFetch, r as extractConfiguredMetadata, s as configure, t as createFileTree, u as defaultBidiBracketsFileContent } from "./file-tree-CColHWG6.mjs";
+import { createDebugger, findFileByPath, isApiError } from "@ucdjs-internal/shared";
+import { UCD_STAT_CHILDREN_DIRS_HEADER, UCD_STAT_CHILDREN_FILES_HEADER, UCD_STAT_CHILDREN_HEADER, UCD_STAT_SIZE_HEADER, UCD_STAT_TYPE_HEADER } from "@ucdjs/env";
+import { HttpResponse } from "msw";
+
+//#region src/mock-store/index.ts
+const debug = createDebugger("ucdjs:test-utils:mock-store");
+const DEFAULT_MOCK_STORE_FILES = { "*": [
+	{
+		type: "file",
+		name: "ArabicShaping.txt",
+		lastModified: 17552871e5,
+		_content: defaultArabicShapingFileContent
+	},
+	{
+		type: "file",
+		name: "BidiBrackets.txt",
+		lastModified: 17552871e5,
+		_content: defaultBidiBracketsFileContent
+	},
+	{
+		type: "directory",
+		name: "extracted",
+		lastModified: 17552871e5,
+		children: [{
+			type: "file",
+			name: "DerivedBidiClass.txt",
+			lastModified: 17552871e5,
+			_content: defaultDerivedBidClassFileContent
+		}]
+	}
+] };
+function mockStoreApi(config) {
+	const { baseUrl = "https://api.ucdjs.dev", responses, versions = [
+		"16.0.0",
+		"15.1.0",
+		"15.0.0"
+	], customResponses = [], onRequest, files = DEFAULT_MOCK_STORE_FILES } = config || {};
+	debug?.("Setting up mock store API with config:", config);
+	const normalizedBaseUrl = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+	for (const route of MOCK_ROUTES) {
+		const endpoint = route.endpoint;
+		const response = responses?.[endpoint] ?? false;
+		if (response === false) continue;
+		let { actualResponse, latency, headers, beforeHook, afterHook } = extractConfiguredMetadata(response);
+		if (typeof actualResponse === "object" && actualResponse !== null && "__useDefaultResolver" in actualResponse) actualResponse = true;
+		const shouldUseDefaultValue = actualResponse === true || response == null;
+		debug?.(`Setting up mock for endpoint: ${endpoint} with response:`, actualResponse);
+		if (isApiError(actualResponse)) {
+			debug?.(`Detected ApiError-like response for endpoint: ${endpoint}`);
+			let tmp = actualResponse;
+			function newHandler() {
+				return HttpResponse.json(tmp, { status: tmp.status });
+			}
+			actualResponse = newHandler;
+		}
+		const wrappedMockFetch = wrapMockFetch(mockFetch, {
+			onRequest,
+			beforeFetch: async (payload) => {
+				debug?.("Before fetch for endpoint:", endpoint);
+				if (latency) {
+					const ms = parseLatency(latency);
+					await new Promise((resolve) => setTimeout(resolve, ms));
+				}
+				await beforeHook?.(payload);
+			},
+			afterFetch: async ({ response, ...payload }) => {
+				debug?.("After fetch for endpoint:", endpoint);
+				await afterHook?.({
+					...payload,
+					response
+				});
+				if (!response) {
+					debug?.("No response returned from resolver");
+					return;
+				}
+				if (!headers || !("headers" in response) || !(response.headers instanceof Headers)) return;
+				for (const [key, value] of Object.entries(headers)) if (response.headers.get(key) !== value) response.headers.set(key, value);
+			}
+		});
+		const mswPath = toMSWPath(endpoint);
+		debug?.(`MSW path for endpoint ${endpoint}: ${mswPath}`);
+		route.setup({
+			url: `${normalizedBaseUrl}${mswPath}`,
+			providedResponse: actualResponse,
+			shouldUseDefaultValue,
+			mockFetch: wrappedMockFetch,
+			versions,
+			files
+		});
+	}
+	if (customResponses.length > 0) {
+		debug?.("Setting up custom responses");
+		mockFetch(customResponses);
+	}
+}
+function toMSWPath(endpoint) {
+	return endpoint.replace(/\{(\w+)\}/g, (_, p1) => {
+		if (p1 === "wildcard") return `:${p1}*`;
+		return `:${p1}`;
+	});
+}
+/**
+* Sets up mock handlers for the store subdomain (ucd-store.ucdjs.dev).
+*
+* This is used for the HTTP fs-bridge which directly accesses files via the store subdomain
+* rather than through the API. The store subdomain handles paths like /:version/:filepath
+* without the /ucd/ prefix (it's handled internally by the subdomain).
+*
+* @param {object} config - Configuration for the store subdomain mock
+* @param {string} [config.storeBaseUrl] - Base URL for the store subdomain (defaults to https://ucd-store.ucdjs.dev)
+* @param {MockStoreFiles} config.files - The files to mock
+*/
+function mockStoreSubdomain(config) {
+	const { storeBaseUrl = "https://ucd-store.ucdjs.dev", files } = config;
+	debug?.("Setting up mock store subdomain with config:", config);
+	mockFetch([[
+		["GET", "HEAD"],
+		`${storeBaseUrl.endsWith("/") ? storeBaseUrl.slice(0, -1) : storeBaseUrl}/:wildcard*`,
+		({ request, params }) => {
+			const wildcard = params.wildcard || "";
+			const isHeadRequest = request.method === "HEAD";
+			debug?.("Store subdomain request:", {
+				wildcard,
+				method: request.method
+			});
+			const [firstPart, ...pathParts] = wildcard.split("/");
+			const isVersionKey = firstPart && firstPart in files;
+			let version = "";
+			let filePath;
+			let versionFiles = [];
+			let lookupPath;
+			if (isVersionKey || firstPart && files["*"]) {
+				version = firstPart;
+				filePath = pathParts.join("/");
+				const versionFilesRaw = files[firstPart] || files["*"];
+				if (!versionFilesRaw || !Array.isArray(versionFilesRaw)) return HttpResponse.json({
+					message: "Resource not found",
+					status: 404,
+					timestamp: (/* @__PURE__ */ new Date()).toISOString()
+				}, { status: 404 });
+				versionFiles = addPathsToFileNodes(versionFilesRaw, version, "");
+				lookupPath = filePath ? `/${version}/${filePath}` : `/${version}`;
+			} else {
+				filePath = wildcard;
+				const rootFilesRaw = files.root;
+				if (!rootFilesRaw || !Array.isArray(rootFilesRaw)) return HttpResponse.json({
+					message: "Resource not found",
+					status: 404,
+					timestamp: (/* @__PURE__ */ new Date()).toISOString()
+				}, { status: 404 });
+				versionFiles = addPathsToFileNodes(rootFilesRaw, "", "");
+				lookupPath = filePath ? `/${filePath}` : "/";
+			}
+			debug?.("Looking up path:", {
+				lookupPath,
+				versionFilesCount: versionFiles.length
+			});
+			if (version && !filePath) {
+				const stripped = omitChildrenAndContent(versionFiles);
+				return HttpResponse.json(stripped, { headers: {
+					[UCD_STAT_TYPE_HEADER]: "directory",
+					[UCD_STAT_CHILDREN_HEADER]: `${stripped.length}`,
+					[UCD_STAT_CHILDREN_FILES_HEADER]: `${stripped.filter((f) => f.type === "file").length}`,
+					[UCD_STAT_CHILDREN_DIRS_HEADER]: `${stripped.filter((f) => f.type === "directory").length}`
+				} });
+			}
+			const fileNode = findFileByPath(versionFiles, lookupPath);
+			if (fileNode && fileNode.type === "directory") {
+				const stripped = omitChildrenAndContent(fileNode.children ?? []);
+				return HttpResponse.json(stripped, { headers: {
+					[UCD_STAT_TYPE_HEADER]: "directory",
+					[UCD_STAT_CHILDREN_HEADER]: `${stripped.length}`,
+					[UCD_STAT_CHILDREN_FILES_HEADER]: `${stripped.filter((f) => f.type === "file").length}`,
+					[UCD_STAT_CHILDREN_DIRS_HEADER]: `${stripped.filter((f) => f.type === "directory").length}`
+				} });
+			}
+			if (fileNode && "_content" in fileNode && typeof fileNode._content === "string") {
+				const content = fileNode._content;
+				const contentLength = new TextEncoder().encode(content).length;
+				const headers = {
+					"Content-Type": "text/plain; charset=utf-8",
+					[UCD_STAT_TYPE_HEADER]: "file"
+				};
+				if (isHeadRequest) {
+					headers["Content-Length"] = `${contentLength}`;
+					headers[UCD_STAT_SIZE_HEADER] = `${contentLength}`;
+				}
+				return HttpResponse.text(content, { headers });
+			}
+			if (fileNode) {
+				console.warn(`Mock store subdomain: File "${filePath}" found but has no _content. Returning 404.`);
+				return HttpResponse.json({
+					message: "Resource not found",
+					status: 404,
+					timestamp: (/* @__PURE__ */ new Date()).toISOString()
+				}, { status: 404 });
+			}
+			return HttpResponse.json({
+				message: "Resource not found",
+				status: 404,
+				timestamp: (/* @__PURE__ */ new Date()).toISOString()
+			}, { status: 404 });
+		}
+	]]);
+}
+
+//#endregion
+export { configure, createFileTree, mockStoreApi, mockStoreSubdomain, unsafeResponse };

package/dist/msw/vitest-setup.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/msw/vitest-setup.mjs

@@ -0,0 +1,14 @@
+import { mswServer } from "../msw.mjs";
+import { afterAll, afterEach, beforeAll } from "vitest";
+
+//#region src/msw/vitest-setup.ts
+beforeAll(() => {
+	mswServer.listen({ onUnhandledRequest: (_, print) => {
+		print.error();
+	} });
+});
+afterEach(() => mswServer.resetHandlers());
+afterAll(() => mswServer.close());
+
+//#endregion
+export {  };

package/dist/msw.d.mts

@@ -0,0 +1,25 @@
+import { HttpResponse, http } from "msw";
+import * as _luxass_msw_utils0 from "@luxass/msw-utils";
+import { createMockFetch } from "@luxass/msw-utils";
+import { SetupServerApi } from "msw/node";
+
+//#region src/msw.d.ts
+declare global {
+  var __ucd_msw_server: SetupServerApi | undefined;
+}
+declare const mswServer: SetupServerApi;
+declare const mockFetch: _luxass_msw_utils0.MockFetchFn;
+/**
+ * A `Response` subclass that avoids default headers.
+ * Useful for MSW or unit tests to simulate "naked" responses from a server
+ * that lack a `Content-Type` header, allowing you to test fallback parsing logic.
+ */
+declare class RawResponse extends Response {
+  /**
+   * @param {BodyInit | null} body - The body of the response.
+   * @param {ResponseInit} [init] - Options including status code and headers.
+   */
+  constructor(body?: BodyInit | null, init?: ResponseInit);
+}
+//#endregion
+export { HttpResponse, RawResponse, createMockFetch, http, mockFetch, mswServer };

package/dist/msw.mjs

@@ -0,0 +1,30 @@
+import { HttpResponse, http } from "msw";
+import { createMockFetch, createMockFetch as createMockFetch$1 } from "@luxass/msw-utils";
+import { setupServer } from "msw/node";
+
+//#region src/msw.ts
+const mswServer = setupServer();
+globalThis.__ucd_msw_server = mswServer;
+const mockFetch = createMockFetch$1({
+	mswServer,
+	replaceOpenAPIPathParams: true
+});
+/**
+* A `Response` subclass that avoids default headers.
+* Useful for MSW or unit tests to simulate "naked" responses from a server
+* that lack a `Content-Type` header, allowing you to test fallback parsing logic.
+*/
+var RawResponse = class extends Response {
+	/**
+	* @param {BodyInit | null} body - The body of the response.
+	* @param {ResponseInit} [init] - Options including status code and headers.
+	*/
+	constructor(body, init) {
+		let processedBody = body;
+		if (typeof body === "string") processedBody = new TextEncoder().encode(body);
+		super(processedBody, init);
+	}
+};
+
+//#endregion
+export { HttpResponse, RawResponse, createMockFetch, http, mockFetch, mswServer };

package/dist/pipelines.d.mts

@@ -0,0 +1,21 @@
+//#region src/pipelines/source.d.ts
+interface PipelineDefinition {
+  _type?: string;
+  id: string;
+  versions?: string[];
+  inputs?: unknown[];
+  routes?: unknown[];
+  [key: string]: unknown;
+}
+type NamedExportValue = PipelineDefinition | string;
+type NamedExportConfig = Record<string, NamedExportValue>;
+type PipelineModuleSourceNamed = string[] | NamedExportConfig;
+interface PipelineModuleSourceOptions {
+  named?: PipelineModuleSourceNamed;
+  definitions?: Record<string, Partial<PipelineDefinition>>;
+  extraExports?: string;
+  prelude?: string;
+}
+declare function createPipelineModuleSource(options?: PipelineModuleSourceOptions): string;
+//#endregion
+export { type PipelineDefinition, type PipelineModuleSourceOptions, createPipelineModuleSource };

package/dist/pipelines.mjs

@@ -0,0 +1,35 @@
+//#region src/pipelines/source.ts
+function isStringArray(value) {
+	return Array.isArray(value);
+}
+function isPipelineDefinition(value) {
+	return typeof value === "object" && value !== null && "id" in value;
+}
+function buildDefinition(id, overrides) {
+	const def = {
+		_type: "pipeline-definition",
+		id,
+		versions: ["16.0.0"],
+		inputs: [],
+		routes: [],
+		...overrides
+	};
+	return JSON.stringify(def).replace(/"(\w+)":/g, "$1:");
+}
+function buildNamedExports(named, definitions) {
+	if (isStringArray(named)) return named.map((name) => `export const ${name} = ${buildDefinition(name, definitions[name])};`).join("\n\n");
+	return Object.entries(named).map(([name, value]) => {
+		return `export const ${name} = ${isPipelineDefinition(value) ? buildDefinition(value.id, value) : value};`;
+	}).join("\n\n");
+}
+function createPipelineModuleSource(options = {}) {
+	const { named = [], definitions = {}, extraExports, prelude } = options;
+	return [
+		prelude,
+		buildNamedExports(named, definitions),
+		extraExports
+	].filter(Boolean).join("\n\n");
+}
+
+//#endregion
+export { createPipelineModuleSource };

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@ucdjs/test-utils",
+  "version": "1.0.1-beta.1",
+  "type": "module",
+  "author": {
+    "name": "Lucas Nørgård",
+    "email": "lucasnrgaard@gmail.com",
+    "url": "https://luxass.dev"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/ucdjs/ucd",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ucdjs/ucd.git",
+    "directory": "packages/test-utils"
+  },
+  "bugs": {
+    "url": "https://github.com/ucdjs/ucd/issues"
+  },
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./fs-bridges": "./dist/fs-bridges/index.mjs",
+    "./matchers/types": "./dist/matchers/types.mjs",
+    "./matchers/vitest-setup": "./dist/matchers/vitest-setup.mjs",
+    "./mock-store": "./dist/mock-store.mjs",
+    "./msw": "./dist/msw.mjs",
+    "./msw/vitest-setup": "./dist/msw/vitest-setup.mjs",
+    "./pipelines": "./dist/pipelines.mjs",
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.18"
+  },
+  "peerDependencies": {
+    "vitest-testdirs": "4.4.2",
+    "@ucdjs/ucd-store": "1.0.1-beta.1"
+  },
+  "dependencies": {
+    "@luxass/msw-utils": "0.6.0",
+    "@luxass/utils": "2.7.3",
+    "@unicode-utils/core": "0.12.0-beta.19",
+    "msw": "2.12.10",
+    "zod": "4.3.6",
+    "@ucdjs-internal/shared": "0.1.1-beta.1",
+    "@ucdjs/fs-bridge": "0.1.1-beta.1",
+    "@ucdjs/schemas": "0.1.1-beta.1",
+    "@ucdjs/env": "0.1.1-beta.1"
+  },
+  "devDependencies": {
+    "@luxass/eslint-config": "7.2.0",
+    "@vitest/expect": "4.1.0-beta.1",
+    "eslint": "10.0.0",
+    "openapi-typescript": "7.13.0",
+    "publint": "0.3.17",
+    "tsdown": "0.20.3",
+    "tsx": "4.21.0",
+    "typescript": "5.9.3",
+    "vitest-testdirs": "4.4.2",
+    "@ucdjs-tooling/tsdown-config": "1.0.0",
+    "@ucdjs/ucd-store": "1.0.1-beta.1",
+    "@ucdjs-tooling/tsconfig": "1.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown --tsconfig=./tsconfig.build.json",
+    "dev": "tsdown --watch",
+    "clean": "git clean -xdf dist node_modules",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit -p tsconfig.build.json",
+    "generate:client": "openapi-typescript ../../ucd-generated/api/openapi.json -o ./src/.generated/api.d.ts",
+    "generate:client:local": "openapi-typescript http://localhost:8787/openapi.json -o ./src/.generated/api.d.ts"
+  }
+}