@openmirai/typeforge 0.1.8 → 0.2.1

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="./assets/typeforge-logo.png" alt="Typeforge logo" width="280" />
+  <img src="https://raw.githubusercontent.com/openmirai/typeforge/HEAD/assets/typeforge-logo.png" alt="Typeforge logo" width="280" />
 </p>
 
 # @openmirai/typeforge
@@ -11,10 +11,6 @@ Headless **OpenAPI / Swagger → TypeScript** codegen. The CLI is `typeforge`. I
 
 You own `http.ts` (the `HTTPFetch` adapter). Generated files import that adapter — they do not invent axios/fetch calls inline.
 
-## Migrating from `@openmirai/openapi-codegen`
-
-Install `@openmirai/typeforge` and update package imports and scripts to use the canonical `typeforge` name. During migration, the package also exposes the legacy `openapi-codegen` binary and reads `openapi-codegen.json`, `openapi-codegen.local.json`, and the `openapiCodegen` package.json key. New projects created by `typeforge init` use the Typeforge names.
-
 ## What it generates
 
 For each **source** (a named API, e.g. `atlas`), under `<apiRoot>/<source>/generated/`:

package/dist/adapters/axios/index.d.ts

@@ -7,32 +7,43 @@ type QueryParams = Record<string, QueryParamValue>;
 type ResponseValidator<T> = (value: unknown) => T;
 //#endregion
 //#region src/http/types.d.ts
+/** Per-request options accepted by every Typeforge HTTP adapter method. */
 interface HTTPFetchConfig<TParams extends object = QueryParams, TResponse = unknown> {
+  /** Abort signal forwarded to the underlying HTTP client. */
   signal?: AbortSignal;
+  /** Query parameters serialized by the HTTP adapter. */
   params?: TParams;
+  /** Request headers merged with adapter-level defaults. */
   headers?: Record<string, string>;
+  /** Optional runtime validator applied to the response payload. */
   validateResponse?: ResponseValidator<TResponse>;
 }
+/** Transport contract consumed by Typeforge-generated API callers. */
 interface HTTPFetch {
+  /** Send a GET request and return its typed response payload. */
   get<TResponse, TParams extends object = QueryParams>(route: string, config?: HTTPFetchConfig<TParams, TResponse>): Promise<{
     data: TResponse;
   }>;
+  /** Send a POST request with a typed body and return its typed response payload. */
   post<TResponse, TBody = unknown, TParams extends object = QueryParams>(route: string, body: TBody, config?: HTTPFetchConfig<TParams, TResponse>): Promise<{
     data: TResponse;
   }>;
+  /** Send a PUT request with a typed body and return its typed response payload. */
   put<TResponse, TBody = unknown, TParams extends object = QueryParams>(route: string, body: TBody, config?: HTTPFetchConfig<TParams, TResponse>): Promise<{
     data: TResponse;
   }>;
+  /** Send a PATCH request with a typed body and return its typed response payload. */
   patch<TResponse, TBody = unknown, TParams extends object = QueryParams>(route: string, body: TBody, config?: HTTPFetchConfig<TParams, TResponse>): Promise<{
     data: TResponse;
   }>;
+  /** Send a DELETE request and return its typed response payload. */
   delete<TResponse, TParams extends object = QueryParams>(route: string, config?: HTTPFetchConfig<TParams, TResponse>): Promise<{
     data: TResponse;
   }>;
 }
 //#endregion
 //#region src/adapters/axios/index.d.ts
+/** Create an `HTTPFetch` implementation backed by an Axios instance. */
 declare function createAxiosAdapter(instance: AxiosInstance): HTTPFetch;
 //#endregion
-export { type HTTPFetch, type HTTPFetchConfig, createAxiosAdapter };
-//# sourceMappingURL=index.d.ts.map
+export { type HTTPFetch, type HTTPFetchConfig, createAxiosAdapter };

package/dist/adapters/axios/index.js

@@ -1,43 +1 @@
-//#region src/http/validate.ts
-var ResponseValidationError = class extends Error {
-	cause;
-	constructor(message, cause) {
-		super(message);
-		this.name = "ResponseValidationError";
-		this.cause = cause;
-	}
-};
-function coerceResponseData(value, validator) {
-	if (validator === void 0) return value;
-	try {
-		return validator(value);
-	} catch (error) {
-		throw new ResponseValidationError("Response validation failed", error);
-	}
-}
-//#endregion
-//#region src/adapters/axios/index.ts
-function toAxiosConfig(config) {
-	if (config === void 0) return;
-	const axiosConfig = {};
-	if (config.signal !== void 0) axiosConfig.signal = config.signal;
-	if (config.params !== void 0) axiosConfig.params = config.params;
-	if (config.headers !== void 0) axiosConfig.headers = config.headers;
-	return axiosConfig;
-}
-function mapResponse(data, config) {
-	return { data: coerceResponseData(data, config?.validateResponse) };
-}
-function createAxiosAdapter(instance) {
-	return {
-		delete: (route, config) => instance.delete(route, toAxiosConfig(config)).then((response) => mapResponse(response.data, config)),
-		get: (route, config) => instance.get(route, toAxiosConfig(config)).then((response) => mapResponse(response.data, config)),
-		patch: (route, body, config) => instance.patch(route, body, toAxiosConfig(config)).then((response) => mapResponse(response.data, config)),
-		post: (route, body, config) => instance.post(route, body, toAxiosConfig(config)).then((response) => mapResponse(response.data, config)),
-		put: (route, body, config) => instance.put(route, body, toAxiosConfig(config)).then((response) => mapResponse(response.data, config))
-	};
-}
-//#endregion
-export { createAxiosAdapter };
-
-//# sourceMappingURL=index.js.map
+var e=class extends Error{cause;constructor(e,t){super(e),this.name=`ResponseValidationError`,this.cause=t}};function t(t,n){if(n===void 0)return t;try{return n(t)}catch(t){throw new e(`Response validation failed`,t)}}function n(e){if(e===void 0)return;let t={};return e.signal!==void 0&&(t.signal=e.signal),e.params!==void 0&&(t.params=e.params),e.headers!==void 0&&(t.headers=e.headers),t}function r(e,n){return{data:t(e,n?.validateResponse)}}function i(e){return{delete:(t,i)=>e.delete(t,n(i)).then(e=>r(e.data,i)),get:(t,i)=>e.get(t,n(i)).then(e=>r(e.data,i)),patch:(t,i,a)=>e.patch(t,i,n(a)).then(e=>r(e.data,a)),post:(t,i,a)=>e.post(t,i,n(a)).then(e=>r(e.data,a)),put:(t,i,a)=>e.put(t,i,n(a)).then(e=>r(e.data,a))}}export{i as createAxiosAdapter};

package/dist/adapters/fetch/index.d.ts

@@ -6,37 +6,52 @@ type QueryParams = Record<string, QueryParamValue>;
 type ResponseValidator<T> = (value: unknown) => T;
 //#endregion
 //#region src/http/types.d.ts
+/** Per-request options accepted by every Typeforge HTTP adapter method. */
 interface HTTPFetchConfig<TParams extends object = QueryParams, TResponse = unknown> {
+  /** Abort signal forwarded to the underlying HTTP client. */
   signal?: AbortSignal;
+  /** Query parameters serialized by the HTTP adapter. */
   params?: TParams;
+  /** Request headers merged with adapter-level defaults. */
   headers?: Record<string, string>;
+  /** Optional runtime validator applied to the response payload. */
   validateResponse?: ResponseValidator<TResponse>;
 }
+/** Transport contract consumed by Typeforge-generated API callers. */
 interface HTTPFetch {
+  /** Send a GET request and return its typed response payload. */
   get<TResponse, TParams extends object = QueryParams>(route: string, config?: HTTPFetchConfig<TParams, TResponse>): Promise<{
     data: TResponse;
   }>;
+  /** Send a POST request with a typed body and return its typed response payload. */
   post<TResponse, TBody = unknown, TParams extends object = QueryParams>(route: string, body: TBody, config?: HTTPFetchConfig<TParams, TResponse>): Promise<{
     data: TResponse;
   }>;
+  /** Send a PUT request with a typed body and return its typed response payload. */
   put<TResponse, TBody = unknown, TParams extends object = QueryParams>(route: string, body: TBody, config?: HTTPFetchConfig<TParams, TResponse>): Promise<{
     data: TResponse;
   }>;
+  /** Send a PATCH request with a typed body and return its typed response payload. */
   patch<TResponse, TBody = unknown, TParams extends object = QueryParams>(route: string, body: TBody, config?: HTTPFetchConfig<TParams, TResponse>): Promise<{
     data: TResponse;
   }>;
+  /** Send a DELETE request and return its typed response payload. */
   delete<TResponse, TParams extends object = QueryParams>(route: string, config?: HTTPFetchConfig<TParams, TResponse>): Promise<{
     data: TResponse;
   }>;
 }
 //#endregion
 //#region src/adapters/fetch/index.d.ts
+/** Options for the Fetch-based `HTTPFetch` adapter. */
 interface FetchAdapterOptions {
+  /** Base URL prepended to every generated route. */
   baseURL?: string;
+  /** Headers included with every request unless overridden per request. */
   headers?: Record<string, string>;
+  /** Fetch implementation to use, such as a test double or platform polyfill. */
   fetch?: typeof fetch;
 }
+/** Create an `HTTPFetch` implementation backed by the Fetch API. */
 declare function createFetchAdapter(options?: FetchAdapterOptions): HTTPFetch;
 //#endregion
-export { FetchAdapterOptions, type HTTPFetch, type HTTPFetchConfig, createFetchAdapter };
-//# sourceMappingURL=index.d.ts.map
+export { FetchAdapterOptions, type HTTPFetch, type HTTPFetchConfig, createFetchAdapter };

package/dist/adapters/fetch/index.js

@@ -1,77 +1 @@
-//#region src/json/types.ts
-function isJsonValue(value) {
-	if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean") return true;
-	if (Array.isArray(value)) return value.every(isJsonValue);
-	if (typeof value === "object" && value !== null) return Object.values(value).every(isJsonValue);
-	return false;
-}
-function parseJson(text) {
-	const parsed = JSON.parse(text);
-	if (!isJsonValue(parsed)) throw new TypeError("JSON text did not parse to a valid JSON value");
-	return parsed;
-}
-//#endregion
-//#region src/http/validate.ts
-var ResponseValidationError = class extends Error {
-	cause;
-	constructor(message, cause) {
-		super(message);
-		this.name = "ResponseValidationError";
-		this.cause = cause;
-	}
-};
-function coerceResponseData(value, validator) {
-	if (validator === void 0) return value;
-	try {
-		return validator(value);
-	} catch (error) {
-		throw new ResponseValidationError("Response validation failed", error);
-	}
-}
-//#endregion
-//#region src/adapters/fetch/index.ts
-function appendQuery(url, params) {
-	if (params === void 0 || Object.keys(params).length === 0) return url;
-	const search = new URLSearchParams();
-	for (const [key, value] of Object.entries(params)) search.append(key, String(value));
-	const query = search.toString();
-	if (query.length === 0) return url;
-	return `${url}${url.includes("?") ? "&" : "?"}${query}`;
-}
-function readResponseBody(text) {
-	if (text.length === 0) return;
-	return parseJson(text);
-}
-async function request(method, route, options, body, config) {
-	const fetchImpl = options.fetch ?? globalThis.fetch;
-	const url = appendQuery(`${options.baseURL ?? ""}${route}`, config?.params);
-	const headers = {
-		...options.headers,
-		...config?.headers
-	};
-	const init = {
-		headers,
-		method
-	};
-	if (config?.signal !== void 0) init.signal = config.signal;
-	if (body !== void 0) {
-		headers["Content-Type"] ??= "application/json";
-		init.body = JSON.stringify(body);
-	}
-	const response = await fetchImpl(url, init);
-	if (!response.ok) throw new Error(`HTTP ${response.status} ${response.statusText}`);
-	return { data: coerceResponseData(readResponseBody(await response.text()), config?.validateResponse) };
-}
-function createFetchAdapter(options = {}) {
-	return {
-		delete: (route, config) => request("DELETE", route, options, void 0, config),
-		get: (route, config) => request("GET", route, options, void 0, config),
-		patch: (route, body, config) => request("PATCH", route, options, body, config),
-		post: (route, body, config) => request("POST", route, options, body, config),
-		put: (route, body, config) => request("PUT", route, options, body, config)
-	};
-}
-//#endregion
-export { createFetchAdapter };
-
-//# sourceMappingURL=index.js.map
+function e(t){return t===null||typeof t==`string`||typeof t==`number`||typeof t==`boolean`?!0:Array.isArray(t)?t.every(e):typeof t==`object`&&t?Object.values(t).every(e):!1}function t(t){let n=JSON.parse(t);if(!e(n))throw TypeError(`JSON text did not parse to a valid JSON value`);return n}var n=class extends Error{cause;constructor(e,t){super(e),this.name=`ResponseValidationError`,this.cause=t}};function r(e,t){if(t===void 0)return e;try{return t(e)}catch(e){throw new n(`Response validation failed`,e)}}function i(e,t){if(t===void 0||Object.keys(t).length===0)return e;let n=new URLSearchParams;for(let[e,r]of Object.entries(t))n.append(e,String(r));let r=n.toString();return r.length===0?e:`${e}${e.includes(`?`)?`&`:`?`}${r}`}function a(e){if(e.length!==0)return t(e)}async function o(e,t,n,o,s){let c=n.fetch??globalThis.fetch,l=i(`${n.baseURL??``}${t}`,s?.params),u={...n.headers,...s?.headers},d={headers:u,method:e};s?.signal!==void 0&&(d.signal=s.signal),o!==void 0&&(u[`Content-Type`]??=`application/json`,d.body=JSON.stringify(o));let f=await c(l,d);if(!f.ok)throw Error(`HTTP ${f.status} ${f.statusText}`);return{data:r(a(await f.text()),s?.validateResponse)}}function s(e={}){return{delete:(t,n)=>o(`DELETE`,t,e,void 0,n),get:(t,n)=>o(`GET`,t,e,void 0,n),patch:(t,n,r)=>o(`PATCH`,t,e,n,r),post:(t,n,r)=>o(`POST`,t,e,n,r),put:(t,n,r)=>o(`PUT`,t,e,n,r)}}export{s as createFetchAdapter};

package/dist/cli.d.ts

@@ -14,5 +14,4 @@ interface ParsedArgs {
 }
 declare function parseArgs(argv: Array<string>): ParsedArgs;
 //#endregion
-export { parseArgs };
-//# sourceMappingURL=cli.d.ts.map
+export { parseArgs };

package/dist/cli.js

@@ -1,87 +1,5 @@
 #!/usr/bin/env node
-import { g as loadProjectConfig, h as listSourceKeys, r as generateForSource, t as initProject } from "./init-BBNO0SYd.js";
-import { realpathSync } from "node:fs";
-import { pathToFileURL } from "node:url";
-//#region src/cli.ts
-function parseArgs(argv) {
-	const parsed = { sources: [] };
-	const positional = [];
-	for (let index = 0; index < argv.length; index += 1) {
-		const arg = argv[index];
-		if (arg === void 0) continue;
-		if (arg === "--check") {
-			parsed.check = true;
-			continue;
-		}
-		if (arg === "--accept-base") {
-			parsed.acceptBase = true;
-			continue;
-		}
-		if (arg === "--all") {
-			parsed.all = true;
-			continue;
-		}
-		if (arg.startsWith("--source=")) {
-			const value = arg.slice(9);
-			parsed.sources.push(value);
-			if (parsed.source === void 0) parsed.source = value;
-			continue;
-		}
-		if (arg === "--source") {
-			const value = argv[index + 1];
-			if (value !== void 0) {
-				parsed.sources.push(value);
-				if (parsed.source === void 0) parsed.source = value;
-				index += 1;
-			}
-			continue;
-		}
-		if (arg.startsWith("--spec=")) {
-			parsed.spec = arg.slice(7);
-			continue;
-		}
-		if (arg === "--spec") {
-			const value = argv[index + 1];
-			if (value !== void 0) {
-				parsed.spec = value;
-				index += 1;
-			}
-			continue;
-		}
-		if (arg.startsWith("--client=")) {
-			const value = arg.slice(9);
-			if (value === "axios" || value === "fetch" || value === "custom") parsed.client = value;
-			continue;
-		}
-		if (arg === "--client") {
-			const value = argv[index + 1];
-			if (value === "axios" || value === "fetch" || value === "custom") {
-				parsed.client = value;
-				index += 1;
-			}
-			continue;
-		}
-		if (arg.startsWith("--layout=")) {
-			const value = arg.slice(9);
-			if (value === "monolith" || value === "packages") parsed.layout = value;
-			continue;
-		}
-		if (arg === "--layout") {
-			const value = argv[index + 1];
-			if (value === "monolith" || value === "packages") {
-				parsed.layout = value;
-				index += 1;
-			}
-			continue;
-		}
-		if (!arg.startsWith("-")) positional.push(arg);
-	}
-	const command = positional[0];
-	if (command !== void 0) parsed.command = command;
-	return parsed;
-}
-function printHelp() {
-	process.stdout.write(`typeforge — headless OpenAPI TypeScript codegen
+import{g as e,h as t,r as n,t as r}from"./init-CqBQsEHz.js";import{realpathSync as i}from"node:fs";import{pathToFileURL as a}from"node:url";function o(e){let t={sources:[]},n=[];for(let r=0;r<e.length;r+=1){let i=e[r];if(i!==void 0){if(i===`--check`){t.check=!0;continue}if(i===`--accept-base`){t.acceptBase=!0;continue}if(i===`--all`){t.all=!0;continue}if(i.startsWith(`--source=`)){let e=i.slice(9);t.sources.push(e),t.source===void 0&&(t.source=e);continue}if(i===`--source`){let n=e[r+1];n!==void 0&&(t.sources.push(n),t.source===void 0&&(t.source=n),r+=1);continue}if(i.startsWith(`--spec=`)){t.spec=i.slice(7);continue}if(i===`--spec`){let n=e[r+1];n!==void 0&&(t.spec=n,r+=1);continue}if(i.startsWith(`--client=`)){let e=i.slice(9);(e===`axios`||e===`fetch`||e===`custom`)&&(t.client=e);continue}if(i===`--client`){let n=e[r+1];(n===`axios`||n===`fetch`||n===`custom`)&&(t.client=n,r+=1);continue}if(i.startsWith(`--layout=`)){let e=i.slice(9);(e===`monolith`||e===`packages`)&&(t.layout=e);continue}if(i===`--layout`){let n=e[r+1];(n===`monolith`||n===`packages`)&&(t.layout=n,r+=1);continue}i.startsWith(`-`)||n.push(i)}}let r=n[0];return r!==void 0&&(t.command=r),t}function s(){process.stdout.write(`typeforge — headless OpenAPI TypeScript codegen
 
 Usage:
   typeforge init --source <key> --client axios|fetch|custom [--layout monolith|packages]
@@ -95,88 +13,7 @@ Multi-source generate:
   Configure per-source spec paths in each source.ts:
     import { defineSourceConfig } from "@openmirai/typeforge";
     export default defineSourceConfig({ spec: "./specs/acme.json", ... });
-`);
-}
-async function runGenerate(args) {
-	if (args.check === true && args.acceptBase === true) {
-		process.stderr.write("typeforge: --accept-base is not allowed with --check\n");
-		return 1;
-	}
-	const cwd = process.cwd();
-	const apiRoot = loadProjectConfig(cwd).apiRoot ?? "src/api";
-	let sources;
-	if (args.all === true) sources = listSourceKeys(cwd, apiRoot);
-	else if (args.sources.length > 0) sources = args.sources;
-	else sources = [];
-	if (sources.length === 0) {
-		process.stderr.write("typeforge: --source <key> or --all is required\n");
-		return 1;
-	}
-	let exitCode = 0;
-	for (const sourceKey of sources) try {
-		const generateOptions = { sourceKey };
-		if (args.acceptBase === true) generateOptions.acceptBase = true;
-		if (args.check === true) generateOptions.check = true;
-		if (args.spec !== void 0) generateOptions.specFlag = args.spec;
-		const result = await generateForSource(generateOptions);
-		if (args.check === true) {
-			if (result.changed.length > 0) {
-				process.stderr.write(`typeforge: stale generated files for "${sourceKey}":\n`);
-				for (const file of result.changed) process.stderr.write(`  ${file}\n`);
-				exitCode = 1;
-			} else process.stdout.write(`typeforge: "${sourceKey}" is up to date\n`);
-		} else process.stdout.write(`typeforge: generated ${result.files} files for "${sourceKey}" (${result.changed.length} changed)\n`);
-	} catch (error) {
-		exitCode = 1;
-		const message = error instanceof Error ? error.message : String(error);
-		process.stderr.write(`${message}\n`);
-	}
-	return exitCode;
-}
-async function main() {
-	const args = parseArgs(process.argv.slice(2));
-	if (args.command === void 0 || args.command === "help" || args.command === "--help" || args.command === "-h") {
-		printHelp();
-		process.exit(0);
-	}
-	if (args.command === "init") {
-		if (args.source === void 0 || args.client === void 0) {
-			process.stderr.write("typeforge: init requires --source and --client\n");
-			process.exit(1);
-		}
-		const initOptions = {
-			client: args.client,
-			sourceKey: args.source
-		};
-		if (args.layout !== void 0) initOptions.layout = args.layout;
-		const result = initProject(initOptions);
-		for (const file of result.created) process.stdout.write(`created ${file}\n`);
-		for (const file of result.skipped) process.stdout.write(`skipped ${file} (already exists)\n`);
-		process.exit(0);
-	}
-	if (args.command === "generate" || args.command === "check" || args.command === "accept-base") {
-		if (args.command === "check") args.check = true;
-		if (args.command === "accept-base") args.acceptBase = true;
-		process.exit(await runGenerate(args));
-	}
-	process.stderr.write(`typeforge: unknown command "${args.command}"\n`);
-	printHelp();
-	process.exit(1);
-}
-if ((() => {
-	const entry = process.argv[1];
-	if (entry === void 0) return false;
-	try {
-		return import.meta.url === pathToFileURL(realpathSync(entry)).href;
-	} catch {
-		return false;
-	}
-})()) main().catch((error) => {
-	const message = error instanceof Error ? error.message : String(error);
-	process.stderr.write(`${message}\n`);
-	process.exit(1);
-});
-//#endregion
-export { parseArgs };
-
-//# sourceMappingURL=cli.js.map
+`)}async function c(r){if(r.check===!0&&r.acceptBase===!0)return process.stderr.write(`typeforge: --accept-base is not allowed with --check
+`),1;let i=process.cwd(),a=e(i).apiRoot??`src/api`,o;if(o=r.all===!0?t(i,a):r.sources.length>0?r.sources:[],o.length===0)return process.stderr.write(`typeforge: --source <key> or --all is required
+`),1;let s=0;for(let e of o)try{let t={sourceKey:e};r.acceptBase===!0&&(t.acceptBase=!0),r.check===!0&&(t.check=!0),r.spec!==void 0&&(t.specFlag=r.spec);let i=await n(t);if(r.check===!0){if(i.changed.length>0){process.stderr.write(`typeforge: stale generated files for "${e}":\n`);for(let e of i.changed)process.stderr.write(`  ${e}\n`);s=1}else process.stdout.write(`typeforge: "${e}" is up to date\n`)}else process.stdout.write(`typeforge: generated ${i.files} files for "${e}" (${i.changed.length} changed)\n`)}catch(e){s=1;let t=e instanceof Error?e.message:String(e);process.stderr.write(`${t}\n`)}return s}async function l(){let e=o(process.argv.slice(2));if((e.command===void 0||e.command===`help`||e.command===`--help`||e.command===`-h`)&&(s(),process.exit(0)),e.command===`init`){(e.source===void 0||e.client===void 0)&&(process.stderr.write(`typeforge: init requires --source and --client
+`),process.exit(1));let t={client:e.client,sourceKey:e.source};e.layout!==void 0&&(t.layout=e.layout);let n=r(t);for(let e of n.created)process.stdout.write(`created ${e}\n`);for(let e of n.skipped)process.stdout.write(`skipped ${e} (already exists)\n`);process.exit(0)}(e.command===`generate`||e.command===`check`||e.command===`accept-base`)&&(e.command===`check`&&(e.check=!0),e.command===`accept-base`&&(e.acceptBase=!0),process.exit(await c(e))),process.stderr.write(`typeforge: unknown command "${e.command}"\n`),s(),process.exit(1)}(()=>{let e=process.argv[1];if(e===void 0)return!1;try{return import.meta.url===a(i(e)).href}catch{return!1}})()&&l().catch(e=>{let t=e instanceof Error?e.message:String(e);process.stderr.write(`${t}\n`),process.exit(1)});export{o as parseArgs};

package/dist/http/types.d.ts

@@ -4,29 +4,39 @@ type QueryParamValue = string | number | boolean | null | undefined;
 type QueryParams = Record<string, QueryParamValue>;
 //#endregion
 //#region src/http/types.d.ts
+/** Per-request options accepted by every Typeforge HTTP adapter method. */
 interface HTTPFetchConfig<TParams extends object = QueryParams, TResponse = unknown> {
+  /** Abort signal forwarded to the underlying HTTP client. */
   signal?: AbortSignal;
+  /** Query parameters serialized by the HTTP adapter. */
   params?: TParams;
+  /** Request headers merged with adapter-level defaults. */
   headers?: Record<string, string>;
+  /** Optional runtime validator applied to the response payload. */
   validateResponse?: ResponseValidator<TResponse>;
 }
+/** Transport contract consumed by Typeforge-generated API callers. */
 interface HTTPFetch {
+  /** Send a GET request and return its typed response payload. */
   get<TResponse, TParams extends object = QueryParams>(route: string, config?: HTTPFetchConfig<TParams, TResponse>): Promise<{
     data: TResponse;
   }>;
+  /** Send a POST request with a typed body and return its typed response payload. */
   post<TResponse, TBody = unknown, TParams extends object = QueryParams>(route: string, body: TBody, config?: HTTPFetchConfig<TParams, TResponse>): Promise<{
     data: TResponse;
   }>;
+  /** Send a PUT request with a typed body and return its typed response payload. */
   put<TResponse, TBody = unknown, TParams extends object = QueryParams>(route: string, body: TBody, config?: HTTPFetchConfig<TParams, TResponse>): Promise<{
     data: TResponse;
   }>;
+  /** Send a PATCH request with a typed body and return its typed response payload. */
   patch<TResponse, TBody = unknown, TParams extends object = QueryParams>(route: string, body: TBody, config?: HTTPFetchConfig<TParams, TResponse>): Promise<{
     data: TResponse;
   }>;
+  /** Send a DELETE request and return its typed response payload. */
   delete<TResponse, TParams extends object = QueryParams>(route: string, config?: HTTPFetchConfig<TParams, TResponse>): Promise<{
     data: TResponse;
   }>;
 }
 //#endregion
-export { HTTPFetch, HTTPFetchConfig, type QueryParamValue, type QueryParams, ResponseValidationError, type ResponseValidator, coerceResponseData };
-//# sourceMappingURL=types.d.ts.map
+export { HTTPFetch, HTTPFetchConfig, type QueryParamValue, type QueryParams, ResponseValidationError, type ResponseValidator, coerceResponseData };

package/dist/http/types.js

@@ -1,2 +1 @@
-import { ResponseValidationError, coerceResponseData } from "./validate.js";
-export { ResponseValidationError, coerceResponseData };
+import{ResponseValidationError as e,coerceResponseData as t}from"./validate.js";export{e as ResponseValidationError,t as coerceResponseData};

package/dist/http/validate.d.ts

@@ -6,5 +6,4 @@ declare class ResponseValidationError extends Error {
 }
 declare function coerceResponseData<T>(value: unknown, validator?: ResponseValidator<T>): T;
 //#endregion
-export { ResponseValidationError, ResponseValidator, coerceResponseData };
-//# sourceMappingURL=validate.d.ts.map
+export { ResponseValidationError, ResponseValidator, coerceResponseData };

package/dist/http/validate.js

@@ -1,21 +1 @@
-//#region src/http/validate.ts
-var ResponseValidationError = class extends Error {
-	cause;
-	constructor(message, cause) {
-		super(message);
-		this.name = "ResponseValidationError";
-		this.cause = cause;
-	}
-};
-function coerceResponseData(value, validator) {
-	if (validator === void 0) return value;
-	try {
-		return validator(value);
-	} catch (error) {
-		throw new ResponseValidationError("Response validation failed", error);
-	}
-}
-//#endregion
-export { ResponseValidationError, coerceResponseData };
-
-//# sourceMappingURL=validate.js.map
+var e=class extends Error{cause;constructor(e,t){super(e),this.name=`ResponseValidationError`,this.cause=t}};function t(t,n){if(n===void 0)return t;try{return n(t)}catch(t){throw new e(`Response validation failed`,t)}}export{e as ResponseValidationError,t as coerceResponseData};