@ecomiq/core 0.1.0

package/README.md

@@ -0,0 +1,42 @@
+# @ecomiq/core
+
+Modelos Zod, cliente HTTP y servicios storefront compartidos de Ecomiq.
+
+## Install
+
+```bash
+npm install @ecomiq/core
+```
+
+## Usage
+
+```ts
+import { createClient, createApi } from '@ecomiq/core'
+
+const api = createClient({
+  slug: 'mi-tienda',
+  baseUrl: 'https://storefront.ecomiq.pe',
+})
+
+const settings = await api.getSettings()
+const products = await api.getProducts({ page: 1, pageSize: 12 })
+```
+
+Subpaths (opcional):
+
+```ts
+import { createApi } from '@ecomiq/core/api'
+import { StorefrontCartSchema } from '@ecomiq/core/models/storefront-cart'
+```
+
+## Build
+
+```bash
+pnpm --filter @ecomiq/core build
+```
+
+## Publish
+
+```bash
+pnpm --filter @ecomiq/core publish --access public
+```

package/dist/api.cjs

@@ -0,0 +1,99 @@
+'use strict';
+
+// src/libs/api.ts
+var DEFAULT_API_BASE_URL = "https://storefront.ecomiq.pe";
+var DEFAULT_API_VERSION = "v1";
+var ApiError = class extends Error {
+  constructor(message, status, url, body) {
+    super(message);
+    this.status = status;
+    this.url = url;
+    this.body = body;
+    this.name = "ApiError";
+  }
+  status;
+  url;
+  body;
+};
+function resolveApiBaseUrl(baseUrl = DEFAULT_API_BASE_URL, version = DEFAULT_API_VERSION) {
+  const root = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+  const segment = version.replace(/^\/+|\/+$/g, "");
+  return new URL(`${segment}/`, root).toString();
+}
+function createApi(options = {}) {
+  const {
+    baseUrl = DEFAULT_API_BASE_URL,
+    version = DEFAULT_API_VERSION,
+    headers: baseHeaders = {},
+    timeoutMs = 1e4
+  } = options;
+  const effectiveBaseUrl = resolveApiBaseUrl(baseUrl, version);
+  async function request(method, path, schema, opts = {}) {
+    const url = new URL(path.replace(/^\//, ""), effectiveBaseUrl);
+    for (const [key, value] of Object.entries(opts.query ?? {})) {
+      if (value !== void 0) url.searchParams.set(key, String(value));
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    if (opts.signal) opts.signal.addEventListener("abort", () => controller.abort(), { once: true });
+    const isFormData = typeof FormData !== "undefined" && opts.body instanceof FormData;
+    let response;
+    try {
+      response = await fetch(url.toString(), {
+        method,
+        headers: {
+          accept: "application/json",
+          ...opts.body !== void 0 && !isFormData ? { "content-type": "application/json" } : {},
+          ...baseHeaders,
+          ...opts.headers
+        },
+        body: opts.body === void 0 ? void 0 : isFormData ? opts.body : JSON.stringify(opts.body),
+        signal: controller.signal
+      });
+    } catch (err) {
+      throw new ApiError(
+        err instanceof DOMException && err.name === "AbortError" ? `Timeout tras ${timeoutMs}ms: ${url}` : `No se pudo conectar con ${url}`,
+        0,
+        url.toString()
+      );
+    } finally {
+      clearTimeout(timeout);
+    }
+    if (!response.ok) {
+      const bodyText = await response.text().catch(() => void 0);
+      let body = bodyText;
+      if (bodyText) {
+        try {
+          body = JSON.parse(bodyText);
+        } catch {
+        }
+      }
+      throw new ApiError(`${method} ${url} \u2192 ${response.status}`, response.status, url.toString(), body);
+    }
+    const json = await response.json();
+    const parsed = schema.safeParse(json);
+    if (!parsed.success) {
+      throw new ApiError(
+        `Respuesta inesperada de ${url}: ${parsed.error.issues[0]?.path.join(".")} ${parsed.error.issues[0]?.message}`,
+        response.status,
+        url.toString(),
+        json
+      );
+    }
+    return parsed.data;
+  }
+  return {
+    request,
+    get: (path, schema, opts) => request("GET", path, schema, opts),
+    post: (path, body, schema, opts) => request("POST", path, schema, { ...opts, body }),
+    postForm: (path, body, schema, opts) => request("POST", path, schema, { ...opts, body })
+  };
+}
+
+exports.ApiError = ApiError;
+exports.DEFAULT_API_BASE_URL = DEFAULT_API_BASE_URL;
+exports.DEFAULT_API_VERSION = DEFAULT_API_VERSION;
+exports.createApi = createApi;
+exports.resolveApiBaseUrl = resolveApiBaseUrl;
+//# sourceMappingURL=api.cjs.map
+//# sourceMappingURL=api.cjs.map

package/dist/api.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/libs/api.ts"],"names":[],"mappings":"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","file":"api.cjs","sourcesContent":["/**\n * Cliente HTTP de Ecomiq para servicios externos.\n * fetch nativo (funciona en Node, navegador y Cloudflare Workers)\n * + validación de respuestas con Zod.\n */\nimport type { z } from 'zod'\n\nexport const DEFAULT_API_BASE_URL = 'https://storefront.ecomiq.pe'\nexport const DEFAULT_API_VERSION = 'v1'\n\nexport class ApiError extends Error {\n  constructor(\n    message: string,\n    public readonly status: number,\n    public readonly url: string,\n    public readonly body?: unknown,\n  ) {\n    super(message)\n    this.name = 'ApiError'\n  }\n}\n\nexport interface CreateApiOptions {\n  /** Default: https://storefront.ecomiq.pe */\n  baseUrl?: string\n  /** Segmento de path, default 'v1' → {baseUrl}/v1/... */\n  version?: string\n  headers?: Record<string, string>\n  timeoutMs?: number\n}\n\ninterface RequestOptions {\n  query?: Record<string, string | number | boolean | undefined>\n  headers?: Record<string, string>\n  signal?: AbortSignal\n}\n\nexport interface Api {\n  get<S extends z.ZodTypeAny>(\n    path: string,\n    schema: S,\n    options?: RequestOptions,\n  ): Promise<z.output<S>>\n  post<S extends z.ZodTypeAny>(\n    path: string,\n    body: unknown,\n    schema: S,\n    options?: RequestOptions,\n  ): Promise<z.output<S>>\n  /** POST multipart; no fuerza `content-type: application/json`. */\n  postForm<S extends z.ZodTypeAny>(\n    path: string,\n    body: FormData,\n    schema: S,\n    options?: RequestOptions,\n  ): Promise<z.output<S>>\n  request<S extends z.ZodTypeAny>(\n    method: string,\n    path: string,\n    schema: S,\n    options?: RequestOptions & { body?: unknown },\n  ): Promise<z.output<S>>\n}\n\n/** Une baseUrl + version en la base efectiva del cliente, ej. https://storefront.ecomiq.pe/v1/ */\nexport function resolveApiBaseUrl(\n  baseUrl: string = DEFAULT_API_BASE_URL,\n  version: string = DEFAULT_API_VERSION,\n): string {\n  const root = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`\n  const segment = version.replace(/^\\/+|\\/+$/g, '')\n  return new URL(`${segment}/`, root).toString()\n}\n\n/**\n * Crea un cliente HTTP tipado con Zod.\n *\n * ```ts\n * const api = createApi()\n * const data = await api.get('settings', schema)\n * // → GET https://storefront.ecomiq.pe/v1/settings\n * ```\n */\nexport function createApi(options: CreateApiOptions = {}): Api {\n  const {\n    baseUrl = DEFAULT_API_BASE_URL,\n    version = DEFAULT_API_VERSION,\n    headers: baseHeaders = {},\n    timeoutMs = 10_000,\n  } = options\n\n  const effectiveBaseUrl = resolveApiBaseUrl(baseUrl, version)\n\n  async function request<S extends z.ZodTypeAny>(\n    method: string,\n    path: string,\n    schema: S,\n    opts: RequestOptions & { body?: unknown } = {},\n  ): Promise<z.output<S>> {\n    const url = new URL(path.replace(/^\\//, ''), effectiveBaseUrl)\n    for (const [key, value] of Object.entries(opts.query ?? {})) {\n      if (value !== undefined) url.searchParams.set(key, String(value))\n    }\n\n    const controller = new AbortController()\n    const timeout = setTimeout(() => controller.abort(), timeoutMs)\n    if (opts.signal) opts.signal.addEventListener('abort', () => controller.abort(), { once: true })\n\n    const isFormData =\n      typeof FormData !== 'undefined' && opts.body instanceof FormData\n\n    let response: Response\n    try {\n      response = await fetch(url.toString(), {\n        method,\n        headers: {\n          accept: 'application/json',\n          ...(opts.body !== undefined && !isFormData\n            ? { 'content-type': 'application/json' }\n            : {}),\n          ...baseHeaders,\n          ...opts.headers,\n        },\n        body:\n          opts.body === undefined\n            ? undefined\n            : isFormData\n              ? (opts.body as FormData)\n              : JSON.stringify(opts.body),\n        signal: controller.signal,\n      })\n    } catch (err) {\n      throw new ApiError(\n        err instanceof DOMException && err.name === 'AbortError'\n          ? `Timeout tras ${timeoutMs}ms: ${url}`\n          : `No se pudo conectar con ${url}`,\n        0,\n        url.toString(),\n      )\n    } finally {\n      clearTimeout(timeout)\n    }\n\n    if (!response.ok) {\n      const bodyText = await response.text().catch(() => undefined)\n      let body: unknown = bodyText\n      if (bodyText) {\n        try {\n          body = JSON.parse(bodyText)\n        } catch {}\n      }\n      throw new ApiError(`${method} ${url} → ${response.status}`, response.status, url.toString(), body)\n    }\n\n    const json = await response.json()\n    const parsed = schema.safeParse(json)\n    if (!parsed.success) {\n      throw new ApiError(\n        `Respuesta inesperada de ${url}: ${parsed.error.issues[0]?.path.join('.')} ${parsed.error.issues[0]?.message}`,\n        response.status,\n        url.toString(),\n        json,\n      )\n    }\n    return parsed.data as z.output<S>\n  }\n\n  return {\n    request,\n    get: (path, schema, opts) => request('GET', path, schema, opts),\n    post: (path, body, schema, opts) => request('POST', path, schema, { ...opts, body }),\n    postForm: (path, body, schema, opts) =>\n      request('POST', path, schema, { ...opts, body }),\n  }\n}\n"]}

package/dist/api.d.cts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+
+/**
+ * Cliente HTTP de Ecomiq para servicios externos.
+ * fetch nativo (funciona en Node, navegador y Cloudflare Workers)
+ * + validación de respuestas con Zod.
+ */
+
+declare const DEFAULT_API_BASE_URL = "https://storefront.ecomiq.pe";
+declare const DEFAULT_API_VERSION = "v1";
+declare class ApiError extends Error {
+    readonly status: number;
+    readonly url: string;
+    readonly body?: unknown | undefined;
+    constructor(message: string, status: number, url: string, body?: unknown | undefined);
+}
+interface CreateApiOptions {
+    /** Default: https://storefront.ecomiq.pe */
+    baseUrl?: string;
+    /** Segmento de path, default 'v1' → {baseUrl}/v1/... */
+    version?: string;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+}
+interface RequestOptions {
+    query?: Record<string, string | number | boolean | undefined>;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+}
+interface Api {
+    get<S extends z.ZodTypeAny>(path: string, schema: S, options?: RequestOptions): Promise<z.output<S>>;
+    post<S extends z.ZodTypeAny>(path: string, body: unknown, schema: S, options?: RequestOptions): Promise<z.output<S>>;
+    /** POST multipart; no fuerza `content-type: application/json`. */
+    postForm<S extends z.ZodTypeAny>(path: string, body: FormData, schema: S, options?: RequestOptions): Promise<z.output<S>>;
+    request<S extends z.ZodTypeAny>(method: string, path: string, schema: S, options?: RequestOptions & {
+        body?: unknown;
+    }): Promise<z.output<S>>;
+}
+/** Une baseUrl + version en la base efectiva del cliente, ej. https://storefront.ecomiq.pe/v1/ */
+declare function resolveApiBaseUrl(baseUrl?: string, version?: string): string;
+/**
+ * Crea un cliente HTTP tipado con Zod.
+ *
+ * ```ts
+ * const api = createApi()
+ * const data = await api.get('settings', schema)
+ * // → GET https://storefront.ecomiq.pe/v1/settings
+ * ```
+ */
+declare function createApi(options?: CreateApiOptions): Api;
+
+export { type Api, ApiError, type CreateApiOptions, DEFAULT_API_BASE_URL, DEFAULT_API_VERSION, createApi, resolveApiBaseUrl };

package/dist/api.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+
+/**
+ * Cliente HTTP de Ecomiq para servicios externos.
+ * fetch nativo (funciona en Node, navegador y Cloudflare Workers)
+ * + validación de respuestas con Zod.
+ */
+
+declare const DEFAULT_API_BASE_URL = "https://storefront.ecomiq.pe";
+declare const DEFAULT_API_VERSION = "v1";
+declare class ApiError extends Error {
+    readonly status: number;
+    readonly url: string;
+    readonly body?: unknown | undefined;
+    constructor(message: string, status: number, url: string, body?: unknown | undefined);
+}
+interface CreateApiOptions {
+    /** Default: https://storefront.ecomiq.pe */
+    baseUrl?: string;
+    /** Segmento de path, default 'v1' → {baseUrl}/v1/... */
+    version?: string;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+}
+interface RequestOptions {
+    query?: Record<string, string | number | boolean | undefined>;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+}
+interface Api {
+    get<S extends z.ZodTypeAny>(path: string, schema: S, options?: RequestOptions): Promise<z.output<S>>;
+    post<S extends z.ZodTypeAny>(path: string, body: unknown, schema: S, options?: RequestOptions): Promise<z.output<S>>;
+    /** POST multipart; no fuerza `content-type: application/json`. */
+    postForm<S extends z.ZodTypeAny>(path: string, body: FormData, schema: S, options?: RequestOptions): Promise<z.output<S>>;
+    request<S extends z.ZodTypeAny>(method: string, path: string, schema: S, options?: RequestOptions & {
+        body?: unknown;
+    }): Promise<z.output<S>>;
+}
+/** Une baseUrl + version en la base efectiva del cliente, ej. https://storefront.ecomiq.pe/v1/ */
+declare function resolveApiBaseUrl(baseUrl?: string, version?: string): string;
+/**
+ * Crea un cliente HTTP tipado con Zod.
+ *
+ * ```ts
+ * const api = createApi()
+ * const data = await api.get('settings', schema)
+ * // → GET https://storefront.ecomiq.pe/v1/settings
+ * ```
+ */
+declare function createApi(options?: CreateApiOptions): Api;
+
+export { type Api, ApiError, type CreateApiOptions, DEFAULT_API_BASE_URL, DEFAULT_API_VERSION, createApi, resolveApiBaseUrl };

package/dist/api.js

@@ -0,0 +1,93 @@
+// src/libs/api.ts
+var DEFAULT_API_BASE_URL = "https://storefront.ecomiq.pe";
+var DEFAULT_API_VERSION = "v1";
+var ApiError = class extends Error {
+  constructor(message, status, url, body) {
+    super(message);
+    this.status = status;
+    this.url = url;
+    this.body = body;
+    this.name = "ApiError";
+  }
+  status;
+  url;
+  body;
+};
+function resolveApiBaseUrl(baseUrl = DEFAULT_API_BASE_URL, version = DEFAULT_API_VERSION) {
+  const root = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+  const segment = version.replace(/^\/+|\/+$/g, "");
+  return new URL(`${segment}/`, root).toString();
+}
+function createApi(options = {}) {
+  const {
+    baseUrl = DEFAULT_API_BASE_URL,
+    version = DEFAULT_API_VERSION,
+    headers: baseHeaders = {},
+    timeoutMs = 1e4
+  } = options;
+  const effectiveBaseUrl = resolveApiBaseUrl(baseUrl, version);
+  async function request(method, path, schema, opts = {}) {
+    const url = new URL(path.replace(/^\//, ""), effectiveBaseUrl);
+    for (const [key, value] of Object.entries(opts.query ?? {})) {
+      if (value !== void 0) url.searchParams.set(key, String(value));
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    if (opts.signal) opts.signal.addEventListener("abort", () => controller.abort(), { once: true });
+    const isFormData = typeof FormData !== "undefined" && opts.body instanceof FormData;
+    let response;
+    try {
+      response = await fetch(url.toString(), {
+        method,
+        headers: {
+          accept: "application/json",
+          ...opts.body !== void 0 && !isFormData ? { "content-type": "application/json" } : {},
+          ...baseHeaders,
+          ...opts.headers
+        },
+        body: opts.body === void 0 ? void 0 : isFormData ? opts.body : JSON.stringify(opts.body),
+        signal: controller.signal
+      });
+    } catch (err) {
+      throw new ApiError(
+        err instanceof DOMException && err.name === "AbortError" ? `Timeout tras ${timeoutMs}ms: ${url}` : `No se pudo conectar con ${url}`,
+        0,
+        url.toString()
+      );
+    } finally {
+      clearTimeout(timeout);
+    }
+    if (!response.ok) {
+      const bodyText = await response.text().catch(() => void 0);
+      let body = bodyText;
+      if (bodyText) {
+        try {
+          body = JSON.parse(bodyText);
+        } catch {
+        }
+      }
+      throw new ApiError(`${method} ${url} \u2192 ${response.status}`, response.status, url.toString(), body);
+    }
+    const json = await response.json();
+    const parsed = schema.safeParse(json);
+    if (!parsed.success) {
+      throw new ApiError(
+        `Respuesta inesperada de ${url}: ${parsed.error.issues[0]?.path.join(".")} ${parsed.error.issues[0]?.message}`,
+        response.status,
+        url.toString(),
+        json
+      );
+    }
+    return parsed.data;
+  }
+  return {
+    request,
+    get: (path, schema, opts) => request("GET", path, schema, opts),
+    post: (path, body, schema, opts) => request("POST", path, schema, { ...opts, body }),
+    postForm: (path, body, schema, opts) => request("POST", path, schema, { ...opts, body })
+  };
+}
+
+export { ApiError, DEFAULT_API_BASE_URL, DEFAULT_API_VERSION, createApi, resolveApiBaseUrl };
+//# sourceMappingURL=api.js.map
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/libs/api.ts"],"names":[],"mappings":"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","file":"api.js","sourcesContent":["/**\n * Cliente HTTP de Ecomiq para servicios externos.\n * fetch nativo (funciona en Node, navegador y Cloudflare Workers)\n * + validación de respuestas con Zod.\n */\nimport type { z } from 'zod'\n\nexport const DEFAULT_API_BASE_URL = 'https://storefront.ecomiq.pe'\nexport const DEFAULT_API_VERSION = 'v1'\n\nexport class ApiError extends Error {\n  constructor(\n    message: string,\n    public readonly status: number,\n    public readonly url: string,\n    public readonly body?: unknown,\n  ) {\n    super(message)\n    this.name = 'ApiError'\n  }\n}\n\nexport interface CreateApiOptions {\n  /** Default: https://storefront.ecomiq.pe */\n  baseUrl?: string\n  /** Segmento de path, default 'v1' → {baseUrl}/v1/... */\n  version?: string\n  headers?: Record<string, string>\n  timeoutMs?: number\n}\n\ninterface RequestOptions {\n  query?: Record<string, string | number | boolean | undefined>\n  headers?: Record<string, string>\n  signal?: AbortSignal\n}\n\nexport interface Api {\n  get<S extends z.ZodTypeAny>(\n    path: string,\n    schema: S,\n    options?: RequestOptions,\n  ): Promise<z.output<S>>\n  post<S extends z.ZodTypeAny>(\n    path: string,\n    body: unknown,\n    schema: S,\n    options?: RequestOptions,\n  ): Promise<z.output<S>>\n  /** POST multipart; no fuerza `content-type: application/json`. */\n  postForm<S extends z.ZodTypeAny>(\n    path: string,\n    body: FormData,\n    schema: S,\n    options?: RequestOptions,\n  ): Promise<z.output<S>>\n  request<S extends z.ZodTypeAny>(\n    method: string,\n    path: string,\n    schema: S,\n    options?: RequestOptions & { body?: unknown },\n  ): Promise<z.output<S>>\n}\n\n/** Une baseUrl + version en la base efectiva del cliente, ej. https://storefront.ecomiq.pe/v1/ */\nexport function resolveApiBaseUrl(\n  baseUrl: string = DEFAULT_API_BASE_URL,\n  version: string = DEFAULT_API_VERSION,\n): string {\n  const root = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`\n  const segment = version.replace(/^\\/+|\\/+$/g, '')\n  return new URL(`${segment}/`, root).toString()\n}\n\n/**\n * Crea un cliente HTTP tipado con Zod.\n *\n * ```ts\n * const api = createApi()\n * const data = await api.get('settings', schema)\n * // → GET https://storefront.ecomiq.pe/v1/settings\n * ```\n */\nexport function createApi(options: CreateApiOptions = {}): Api {\n  const {\n    baseUrl = DEFAULT_API_BASE_URL,\n    version = DEFAULT_API_VERSION,\n    headers: baseHeaders = {},\n    timeoutMs = 10_000,\n  } = options\n\n  const effectiveBaseUrl = resolveApiBaseUrl(baseUrl, version)\n\n  async function request<S extends z.ZodTypeAny>(\n    method: string,\n    path: string,\n    schema: S,\n    opts: RequestOptions & { body?: unknown } = {},\n  ): Promise<z.output<S>> {\n    const url = new URL(path.replace(/^\\//, ''), effectiveBaseUrl)\n    for (const [key, value] of Object.entries(opts.query ?? {})) {\n      if (value !== undefined) url.searchParams.set(key, String(value))\n    }\n\n    const controller = new AbortController()\n    const timeout = setTimeout(() => controller.abort(), timeoutMs)\n    if (opts.signal) opts.signal.addEventListener('abort', () => controller.abort(), { once: true })\n\n    const isFormData =\n      typeof FormData !== 'undefined' && opts.body instanceof FormData\n\n    let response: Response\n    try {\n      response = await fetch(url.toString(), {\n        method,\n        headers: {\n          accept: 'application/json',\n          ...(opts.body !== undefined && !isFormData\n            ? { 'content-type': 'application/json' }\n            : {}),\n          ...baseHeaders,\n          ...opts.headers,\n        },\n        body:\n          opts.body === undefined\n            ? undefined\n            : isFormData\n              ? (opts.body as FormData)\n              : JSON.stringify(opts.body),\n        signal: controller.signal,\n      })\n    } catch (err) {\n      throw new ApiError(\n        err instanceof DOMException && err.name === 'AbortError'\n          ? `Timeout tras ${timeoutMs}ms: ${url}`\n          : `No se pudo conectar con ${url}`,\n        0,\n        url.toString(),\n      )\n    } finally {\n      clearTimeout(timeout)\n    }\n\n    if (!response.ok) {\n      const bodyText = await response.text().catch(() => undefined)\n      let body: unknown = bodyText\n      if (bodyText) {\n        try {\n          body = JSON.parse(bodyText)\n        } catch {}\n      }\n      throw new ApiError(`${method} ${url} → ${response.status}`, response.status, url.toString(), body)\n    }\n\n    const json = await response.json()\n    const parsed = schema.safeParse(json)\n    if (!parsed.success) {\n      throw new ApiError(\n        `Respuesta inesperada de ${url}: ${parsed.error.issues[0]?.path.join('.')} ${parsed.error.issues[0]?.message}`,\n        response.status,\n        url.toString(),\n        json,\n      )\n    }\n    return parsed.data as z.output<S>\n  }\n\n  return {\n    request,\n    get: (path, schema, opts) => request('GET', path, schema, opts),\n    post: (path, body, schema, opts) => request('POST', path, schema, { ...opts, body }),\n    postForm: (path, body, schema, opts) =>\n      request('POST', path, schema, { ...opts, body }),\n  }\n}\n"]}