@dotpress/testing 2.0.0-alpha.3 → 2.0.0-alpha.5

package/README.md

@@ -5,7 +5,7 @@ Testing helpers for [Dotpress](https://dotpress.dev): a test app in memory, the
 > 🚧 Dotpress V2 is in alpha (`2.0.0-alpha`): the API may still change before 2.0.0.
 
 ```sh
-npm install --save-dev @dotpress/testing
+npm install --save-dev @dotpress/testing vitest
 ```
 
 ```ts

package/dist/chunk-MUWNILMA.js

@@ -0,0 +1,51 @@
+// src/logger.ts
+var createMemoryLogger = () => {
+  const entries = [];
+  const create = () => ({
+    debug: (...args) => void entries.push({ level: "debug", args }),
+    info: (...args) => void entries.push({ level: "info", args }),
+    warn: (...args) => void entries.push({ level: "warn", args }),
+    error: (...args) => void entries.push({ level: "error", args }),
+    child: () => create()
+  });
+  return Object.assign(create(), { entries });
+};
+
+// src/request.ts
+var toRequest = async (path, init) => {
+  const request = new Request(new URL(path, "http://localhost"), init);
+  if (!(init?.body instanceof FormData)) return request;
+  return new Request(request, { body: await request.arrayBuffer() });
+};
+
+// src/target.ts
+var OPTIONS = ["close"];
+var closeOf = (label, options, known = OPTIONS) => {
+  if (typeof options !== "object" || options === null) {
+    throw new TypeError(`${label}: options must be an object.`);
+  }
+  for (const key of Object.keys(options)) {
+    if (!known.includes(key)) {
+      throw new TypeError(`${label}: unknown option "${key}".`);
+    }
+  }
+  return options.close ?? (async () => {
+  });
+};
+var createHttpTarget = (baseUrl, options = {}) => ({
+  fetch: (path, init) => fetch(new URL(path, baseUrl), init),
+  close: closeOf("createHttpTarget()", options)
+});
+var createFetchTarget = (handle, options = {}) => ({
+  fetch: async (path, init) => handle(await toRequest(path, init)),
+  close: closeOf("createFetchTarget()", options)
+});
+
+export {
+  createMemoryLogger,
+  toRequest,
+  closeOf,
+  createHttpTarget,
+  createFetchTarget
+};
+//# sourceMappingURL=chunk-MUWNILMA.js.map

package/dist/chunk-MUWNILMA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logger.ts","../src/request.ts","../src/target.ts"],"sourcesContent":["import type { Logger } from '@dotpress/core'\n\nexport interface LogEntry {\n  readonly level: 'debug' | 'info' | 'warn' | 'error'\n  readonly args: readonly unknown[]\n}\n\nexport interface MemoryLogger extends Logger {\n  /** Entries logged by this logger and its children. */\n  readonly entries: LogEntry[]\n}\n\n/**\n * Logger that records entries instead of printing them.\n */\nexport const createMemoryLogger = (): MemoryLogger => {\n  const entries: LogEntry[] = []\n\n  const create = (): Logger => ({\n    debug: (...args: unknown[]) => void entries.push({ level: 'debug', args }),\n    info: (...args: unknown[]) => void entries.push({ level: 'info', args }),\n    warn: (...args: unknown[]) => void entries.push({ level: 'warn', args }),\n    error: (...args: unknown[]) => void entries.push({ level: 'error', args }),\n    child: () => create(),\n  })\n\n  return Object.assign(create(), { entries })\n}\n","/**\n * Creates the request sent by an in-memory target. Form data bodies are\n * serialized first, as HTTP clients do: on Node.js 24, cancelling a body\n * built from a `FormData` (body limit) raises an unhandled rejection in\n * undici.\n */\nexport const toRequest = async (\n  path: string,\n  init?: RequestInit\n): Promise<Request> => {\n  const request = new Request(new URL(path, 'http://localhost'), init)\n  if (!(init?.body instanceof FormData)) return request\n  return new Request(request, { body: await request.arrayBuffer() })\n}\n","import { toRequest } from './request.js'\n\n/**\n * Running application under test.\n */\nexport interface TestTarget {\n  /** Sends a request to the application. `path` includes the query. */\n  fetch(path: string, init?: RequestInit): Promise<Response>\n  /** Stops the application. */\n  close(): Promise<void>\n}\n\nexport interface TargetOptions {\n  /** Stops the application. Defaults to doing nothing. */\n  close?: () => Promise<void>\n}\n\nconst OPTIONS = ['close'] satisfies (keyof TargetOptions)[]\n\n/** Checks the options of a target, and returns its `close()`. */\nexport const closeOf = (\n  label: string,\n  options: TargetOptions,\n  known: readonly string[] = OPTIONS\n): (() => Promise<void>) => {\n  if (typeof options !== 'object' || options === null) {\n    throw new TypeError(`${label}: options must be an object.`)\n  }\n  for (const key of Object.keys(options)) {\n    if (!known.includes(key)) {\n      throw new TypeError(`${label}: unknown option \"${key}\".`)\n    }\n  }\n  return options.close ?? (async () => {})\n}\n\n/**\n * Target for adapters listening on an HTTP port.\n */\nexport const createHttpTarget = (\n  baseUrl: string,\n  options: TargetOptions = {}\n): TestTarget => ({\n  fetch: (path, init) => fetch(new URL(path, baseUrl), init),\n  close: closeOf('createHttpTarget()', options),\n})\n\n/**\n * Target for adapters handling Web requests in memory (`fetch()` of the\n * adapter, serverless handlers). `path` is relative to `http://localhost`.\n */\nexport const createFetchTarget = (\n  handle: (request: Request) => Promise<Response>,\n  options: TargetOptions = {}\n): TestTarget => ({\n  fetch: async (path, init) => handle(await toRequest(path, init)),\n  close: closeOf('createFetchTarget()', options),\n})\n"],"mappings":";AAeO,IAAM,qBAAqB,MAAoB;AACpD,QAAM,UAAsB,CAAC;AAE7B,QAAM,SAAS,OAAe;AAAA,IAC5B,OAAO,IAAI,SAAoB,KAAK,QAAQ,KAAK,EAAE,OAAO,SAAS,KAAK,CAAC;AAAA,IACzE,MAAM,IAAI,SAAoB,KAAK,QAAQ,KAAK,EAAE,OAAO,QAAQ,KAAK,CAAC;AAAA,IACvE,MAAM,IAAI,SAAoB,KAAK,QAAQ,KAAK,EAAE,OAAO,QAAQ,KAAK,CAAC;AAAA,IACvE,OAAO,IAAI,SAAoB,KAAK,QAAQ,KAAK,EAAE,OAAO,SAAS,KAAK,CAAC;AAAA,IACzE,OAAO,MAAM,OAAO;AAAA,EACtB;AAEA,SAAO,OAAO,OAAO,OAAO,GAAG,EAAE,QAAQ,CAAC;AAC5C;;;ACrBO,IAAM,YAAY,OACvB,MACA,SACqB;AACrB,QAAM,UAAU,IAAI,QAAQ,IAAI,IAAI,MAAM,kBAAkB,GAAG,IAAI;AACnE,MAAI,EAAE,MAAM,gBAAgB,UAAW,QAAO;AAC9C,SAAO,IAAI,QAAQ,SAAS,EAAE,MAAM,MAAM,QAAQ,YAAY,EAAE,CAAC;AACnE;;;ACIA,IAAM,UAAU,CAAC,OAAO;AAGjB,IAAM,UAAU,CACrB,OACA,SACA,QAA2B,YACD;AAC1B,MAAI,OAAO,YAAY,YAAY,YAAY,MAAM;AACnD,UAAM,IAAI,UAAU,GAAG,KAAK,8BAA8B;AAAA,EAC5D;AACA,aAAW,OAAO,OAAO,KAAK,OAAO,GAAG;AACtC,QAAI,CAAC,MAAM,SAAS,GAAG,GAAG;AACxB,YAAM,IAAI,UAAU,GAAG,KAAK,qBAAqB,GAAG,IAAI;AAAA,IAC1D;AAAA,EACF;AACA,SAAO,QAAQ,UAAU,YAAY;AAAA,EAAC;AACxC;AAKO,IAAM,mBAAmB,CAC9B,SACA,UAAyB,CAAC,OACV;AAAA,EAChB,OAAO,CAAC,MAAM,SAAS,MAAM,IAAI,IAAI,MAAM,OAAO,GAAG,IAAI;AAAA,EACzD,OAAO,QAAQ,sBAAsB,OAAO;AAC9C;AAMO,IAAM,oBAAoB,CAC/B,QACA,UAAyB,CAAC,OACV;AAAA,EAChB,OAAO,OAAO,MAAM,SAAS,OAAO,MAAM,UAAU,MAAM,IAAI,CAAC;AAAA,EAC/D,OAAO,QAAQ,uBAAuB,OAAO;AAC/C;","names":[]}

package/dist/conformance.d.ts

@@ -0,0 +1,28 @@
+import { AppOptions } from '@dotpress/core';
+import { T as TestTarget } from './target-BZC-J2SE.js';
+export { a as TargetOptions, c as createFetchTarget, b as createHttpTarget } from './target-BZC-J2SE.js';
+
+type ConformanceAppOptions = Omit<AppOptions, 'adapter'>;
+interface ConformanceSuiteOptions {
+    /** Adapter name, used in test titles. */
+    name: string;
+    /**
+     * Creates an app with the adapter under test and the given options, and
+     * starts it. Called once per test.
+     */
+    setup(options: ConformanceAppOptions): Promise<TestTarget>;
+    /**
+     * The adapter sends responses once complete (AWS Lambda without response
+     * streaming). The scenarios that need incremental streaming or client
+     * disconnects are skipped.
+     */
+    bufferedResponses?: boolean;
+}
+/**
+ * Registers the adapter conformance suite (vitest). An adapter is ready
+ * when it passes every test.
+ */
+declare const runConformanceSuite: (options: ConformanceSuiteOptions) => void;
+
+export { TestTarget, runConformanceSuite };
+export type { ConformanceAppOptions, ConformanceSuiteOptions };