nuxt-api-contract 0.1.0 → 0.2.0

package/dist/shared/{nuxt-api-contract.CPm9WbWA.d.mts → nuxt-api-contract.CFG8gzJH.d.mts}

@@ -161,5 +161,5 @@ type ResolvedApiRequestOptions = {
  */
 type ExtractSchemaOutput<T> = T extends ZodType<infer Output, any, any> ? Output : unknown;
 
-export { API_CONTRACT_KIND as a };
-export type { AnyApiContract as A, ContractBodyInput as C, EmptyObject as E, HttpMethod as H, IsEmptyObject as I, MaybePromise as M, PathParams as P, ResolvedApiRequestOptions as R, SplitPath as S, ApiContract as b, ApiContractDefinition as c, ApiRequestOptions as d, AuthConfig as e, ContractClientResponse as f, ContractErrorCode as g, ContractFromDefinition as h, ContractHandlerResponse as i, ContractHeadersInput as j, ContractParamsInput as k, ContractPathParams as l, ContractQueryInput as m, ExtractSchemaInput as n, ExtractSchemaOutput as o };
+export { API_CONTRACT_KIND as A };
+export type { ContractBodyInput as C, EmptyObject as E, HttpMethod as H, IsEmptyObject as I, MaybePromise as M, PathParams as P, ResolvedApiRequestOptions as R, SplitPath as S, AnyApiContract as a, ApiContract as b, ApiContractDefinition as c, ApiRequestOptions as d, AuthConfig as e, ContractClientResponse as f, ContractErrorCode as g, ContractFromDefinition as h, ContractHandlerResponse as i, ContractHeadersInput as j, ContractParamsInput as k, ContractPathParams as l, ContractQueryInput as m, ExtractSchemaInput as n, ExtractSchemaOutput as o };

package/dist/shared/{nuxt-api-contract.CPm9WbWA.d.ts → nuxt-api-contract.CFG8gzJH.d.ts}

@@ -161,5 +161,5 @@ type ResolvedApiRequestOptions = {
  */
 type ExtractSchemaOutput<T> = T extends ZodType<infer Output, any, any> ? Output : unknown;
 
-export { API_CONTRACT_KIND as a };
-export type { AnyApiContract as A, ContractBodyInput as C, EmptyObject as E, HttpMethod as H, IsEmptyObject as I, MaybePromise as M, PathParams as P, ResolvedApiRequestOptions as R, SplitPath as S, ApiContract as b, ApiContractDefinition as c, ApiRequestOptions as d, AuthConfig as e, ContractClientResponse as f, ContractErrorCode as g, ContractFromDefinition as h, ContractHandlerResponse as i, ContractHeadersInput as j, ContractParamsInput as k, ContractPathParams as l, ContractQueryInput as m, ExtractSchemaInput as n, ExtractSchemaOutput as o };
+export { API_CONTRACT_KIND as A };
+export type { ContractBodyInput as C, EmptyObject as E, HttpMethod as H, IsEmptyObject as I, MaybePromise as M, PathParams as P, ResolvedApiRequestOptions as R, SplitPath as S, AnyApiContract as a, ApiContract as b, ApiContractDefinition as c, ApiRequestOptions as d, AuthConfig as e, ContractClientResponse as f, ContractErrorCode as g, ContractFromDefinition as h, ContractHandlerResponse as i, ContractHeadersInput as j, ContractParamsInput as k, ContractPathParams as l, ContractQueryInput as m, ExtractSchemaInput as n, ExtractSchemaOutput as o };

package/dist/shared/nuxt-api-contract.DZfOzVaB.d.mts

@@ -0,0 +1,16 @@
+/**
+ * Serialization helpers shared by the client transport and cache keys.
+ *
+ * The protocol intentionally stays minimal: standard JSON plus two common
+ * edge cases (Date and bigint). Response serialization relies on Nitro's
+ * built-in devalue support, which already handles Date, RegExp, etc.
+ */
+/** Converts query values into URL-safe primitives (Date -> ISO, bigint -> string). */
+type SerializedQueryValue = string | number | boolean | Array<string | number | boolean>;
+declare function serializeQueryValue(value: unknown): SerializedQueryValue;
+/** Prepares a query object for `$fetch` / URL building; drops `undefined` entries. */
+declare function serializeQuery(query: Record<string, unknown> | undefined): Record<string, SerializedQueryValue> | undefined;
+/** Deterministic JSON stringify (sorted keys) for stable SSR cache keys. */
+declare function stableStringify(value: unknown): string;
+
+export { serializeQueryValue as a, stableStringify as b, serializeQuery as s };

package/dist/shared/nuxt-api-contract.DZfOzVaB.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Serialization helpers shared by the client transport and cache keys.
+ *
+ * The protocol intentionally stays minimal: standard JSON plus two common
+ * edge cases (Date and bigint). Response serialization relies on Nitro's
+ * built-in devalue support, which already handles Date, RegExp, etc.
+ */
+/** Converts query values into URL-safe primitives (Date -> ISO, bigint -> string). */
+type SerializedQueryValue = string | number | boolean | Array<string | number | boolean>;
+declare function serializeQueryValue(value: unknown): SerializedQueryValue;
+/** Prepares a query object for `$fetch` / URL building; drops `undefined` entries. */
+declare function serializeQuery(query: Record<string, unknown> | undefined): Record<string, SerializedQueryValue> | undefined;
+/** Deterministic JSON stringify (sorted keys) for stable SSR cache keys. */
+declare function stableStringify(value: unknown): string;
+
+export { serializeQueryValue as a, stableStringify as b, serializeQuery as s };

package/dist/shared/nuxt-api-contract.Dr4tPqGB.mjs

@@ -0,0 +1,38 @@
+function serializeQueryValue(value) {
+  if (value instanceof Date) return value.toISOString();
+  if (typeof value === "bigint") return value.toString();
+  if (Array.isArray(value)) return value.map((item) => serializePrimitive(item));
+  if (value === void 0 || value === null) return "";
+  if (typeof value === "object") return JSON.stringify(value);
+  return value;
+}
+function serializePrimitive(value) {
+  if (value instanceof Date) return value.toISOString();
+  if (typeof value === "bigint") return value.toString();
+  if (value === void 0 || value === null || typeof value === "object") return JSON.stringify(value) ?? "";
+  return value;
+}
+function serializeQuery(query) {
+  if (!query) return void 0;
+  const result = {};
+  for (const [key, value] of Object.entries(query)) {
+    if (value === void 0) continue;
+    result[key] = serializeQueryValue(value);
+  }
+  return result;
+}
+function stableStringify(value) {
+  return JSON.stringify(sortValue(value));
+}
+function sortValue(value) {
+  if (Array.isArray(value)) return value.map((item) => sortValue(item));
+  if (value instanceof Date) return value.toISOString();
+  if (typeof value === "bigint") return value.toString();
+  if (value !== null && typeof value === "object") {
+    const entries = Object.entries(value).filter(([, item]) => item !== void 0).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+    return Object.fromEntries(entries.map(([key, item]) => [key, sortValue(item)]));
+  }
+  return value;
+}
+
+export { serializeQueryValue as a, stableStringify as b, serializeQuery as s };

package/dist/shared/{nuxt-api-contract.QDGSGaVY.mjs → nuxt-api-contract.V15soI_f.mjs}

@@ -77,41 +77,4 @@ function buildRequestPath(path, params) {
   return url;
 }
 
-function serializeQueryValue(value) {
-  if (value instanceof Date) return value.toISOString();
-  if (typeof value === "bigint") return value.toString();
-  if (Array.isArray(value)) return value.map((item) => serializePrimitive(item));
-  if (value === void 0 || value === null) return "";
-  if (typeof value === "object") return JSON.stringify(value);
-  return value;
-}
-function serializePrimitive(value) {
-  if (value instanceof Date) return value.toISOString();
-  if (typeof value === "bigint") return value.toString();
-  if (value === void 0 || value === null || typeof value === "object") return JSON.stringify(value) ?? "";
-  return value;
-}
-function serializeQuery(query) {
-  if (!query) return void 0;
-  const result = {};
-  for (const [key, value] of Object.entries(query)) {
-    if (value === void 0) continue;
-    result[key] = serializeQueryValue(value);
-  }
-  return result;
-}
-function stableStringify(value) {
-  return JSON.stringify(sortValue(value));
-}
-function sortValue(value) {
-  if (Array.isArray(value)) return value.map((item) => sortValue(item));
-  if (value instanceof Date) return value.toISOString();
-  if (typeof value === "bigint") return value.toString();
-  if (value !== null && typeof value === "object") {
-    const entries = Object.entries(value).filter(([, item]) => item !== void 0).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
-    return Object.fromEntries(entries.map(([key, item]) => [key, sortValue(item)]));
-  }
-  return value;
-}
-
-export { getContractMock as a, buildRequestPath as b, clearContractRegistry as c, defineApiContract as d, serializeQueryValue as e, stableStringify as f, getContractByName as g, isApiContract as i, listRegisteredContracts as l, mockContract as m, registerContract as r, serializeQuery as s };
+export { getContractMock as a, buildRequestPath as b, clearContractRegistry as c, defineApiContract as d, getContractByName as g, isApiContract as i, listRegisteredContracts as l, mockContract as m, registerContract as r };

package/dist/shared/{nuxt-api-contract.B9JBCRk8.d.mts → nuxt-api-contract.VCevNWQV.d.mts}

@@ -1,6 +1,6 @@
 import { H3Event, EventHandler } from 'h3';
 import { z } from 'zod';
-import { A as AnyApiContract, M as MaybePromise, i as ContractHandlerResponse } from './nuxt-api-contract.CPm9WbWA.mjs';
+import { a as AnyApiContract, M as MaybePromise, i as ContractHandlerResponse } from './nuxt-api-contract.CFG8gzJH.mjs';
 
 type Infer<T> = T extends z.ZodType ? z.infer<T> : never;
 /**

package/dist/shared.d.mts

@@ -1,4 +1,6 @@
-export { ContractMock, MockResponseInput, buildRequestPath, clearContractRegistry, defineApiContract, getContractByName, getContractMock, isApiContract, listRegisteredContracts, mockContract, registerContract, serializeQuery, serializeQueryValue, stableStringify } from './client.mjs';
+export { C as ContractMock, M as MockResponseInput, b as buildRequestPath, c as clearContractRegistry, d as defineApiContract, g as getContractByName, a as getContractMock, i as isApiContract, l as listRegisteredContracts, m as mockContract, r as registerContract } from './shared/nuxt-api-contract.BgPd-YXc.mjs';
 export { A as ApiError, a as ApiErrorPayload, B as BUILT_IN_ERROR_CODES, C as CreateApiErrorInput, V as ValidationIssue, c as createApiError, f as formatValidationMessage, i as isApiError, p as parseApiErrorPayload, s as sanitizeIssues, b as serializeApiError, t as toApiError, d as toValidationIssues } from './shared/nuxt-api-contract.D31EDcwH.mjs';
-export { a as API_CONTRACT_KIND, A as AnyApiContract, b as ApiContract, c as ApiContractDefinition, d as ApiRequestOptions, e as AuthConfig, C as ContractBodyInput, f as ContractClientResponse, g as ContractErrorCode, h as ContractFromDefinition, i as ContractHandlerResponse, j as ContractHeadersInput, k as ContractParamsInput, l as ContractPathParams, m as ContractQueryInput, E as EmptyObject, n as ExtractSchemaInput, o as ExtractSchemaOutput, H as HttpMethod, I as IsEmptyObject, M as MaybePromise, P as PathParams, R as ResolvedApiRequestOptions, S as SplitPath } from './shared/nuxt-api-contract.CPm9WbWA.mjs';
+export { s as serializeQuery, a as serializeQueryValue, b as stableStringify } from './shared/nuxt-api-contract.DZfOzVaB.mjs';
+export { A as API_CONTRACT_KIND, a as AnyApiContract, b as ApiContract, c as ApiContractDefinition, d as ApiRequestOptions, e as AuthConfig, C as ContractBodyInput, f as ContractClientResponse, g as ContractErrorCode, h as ContractFromDefinition, i as ContractHandlerResponse, j as ContractHeadersInput, k as ContractParamsInput, l as ContractPathParams, m as ContractQueryInput, E as EmptyObject, n as ExtractSchemaInput, o as ExtractSchemaOutput, H as HttpMethod, I as IsEmptyObject, M as MaybePromise, P as PathParams, R as ResolvedApiRequestOptions, S as SplitPath } from './shared/nuxt-api-contract.CFG8gzJH.mjs';
+export { M as MockGenerateOptions, a as autoMockContract, c as createRng, g as generateMockResponse, b as generateMockValue } from './shared/nuxt-api-contract.BOxyDvRy.mjs';
 import 'zod';

package/dist/shared.d.ts

@@ -1,4 +1,6 @@
-export { ContractMock, MockResponseInput, buildRequestPath, clearContractRegistry, defineApiContract, getContractByName, getContractMock, isApiContract, listRegisteredContracts, mockContract, registerContract, serializeQuery, serializeQueryValue, stableStringify } from './client.js';
+export { C as ContractMock, M as MockResponseInput, b as buildRequestPath, c as clearContractRegistry, d as defineApiContract, g as getContractByName, a as getContractMock, i as isApiContract, l as listRegisteredContracts, m as mockContract, r as registerContract } from './shared/nuxt-api-contract.C7KxMQHa.js';
 export { A as ApiError, a as ApiErrorPayload, B as BUILT_IN_ERROR_CODES, C as CreateApiErrorInput, V as ValidationIssue, c as createApiError, f as formatValidationMessage, i as isApiError, p as parseApiErrorPayload, s as sanitizeIssues, b as serializeApiError, t as toApiError, d as toValidationIssues } from './shared/nuxt-api-contract.D31EDcwH.js';
-export { a as API_CONTRACT_KIND, A as AnyApiContract, b as ApiContract, c as ApiContractDefinition, d as ApiRequestOptions, e as AuthConfig, C as ContractBodyInput, f as ContractClientResponse, g as ContractErrorCode, h as ContractFromDefinition, i as ContractHandlerResponse, j as ContractHeadersInput, k as ContractParamsInput, l as ContractPathParams, m as ContractQueryInput, E as EmptyObject, n as ExtractSchemaInput, o as ExtractSchemaOutput, H as HttpMethod, I as IsEmptyObject, M as MaybePromise, P as PathParams, R as ResolvedApiRequestOptions, S as SplitPath } from './shared/nuxt-api-contract.CPm9WbWA.js';
+export { s as serializeQuery, a as serializeQueryValue, b as stableStringify } from './shared/nuxt-api-contract.DZfOzVaB.js';
+export { A as API_CONTRACT_KIND, a as AnyApiContract, b as ApiContract, c as ApiContractDefinition, d as ApiRequestOptions, e as AuthConfig, C as ContractBodyInput, f as ContractClientResponse, g as ContractErrorCode, h as ContractFromDefinition, i as ContractHandlerResponse, j as ContractHeadersInput, k as ContractParamsInput, l as ContractPathParams, m as ContractQueryInput, E as EmptyObject, n as ExtractSchemaInput, o as ExtractSchemaOutput, H as HttpMethod, I as IsEmptyObject, M as MaybePromise, P as PathParams, R as ResolvedApiRequestOptions, S as SplitPath } from './shared/nuxt-api-contract.CFG8gzJH.js';
+export { M as MockGenerateOptions, a as autoMockContract, c as createRng, g as generateMockResponse, b as generateMockValue } from './shared/nuxt-api-contract.BuWjAHJe.js';
 import 'zod';

package/dist/shared.mjs

@@ -1,3 +1,5 @@
-export { b as buildRequestPath, c as clearContractRegistry, d as defineApiContract, g as getContractByName, a as getContractMock, i as isApiContract, l as listRegisteredContracts, m as mockContract, r as registerContract, s as serializeQuery, e as serializeQueryValue, f as stableStringify } from './shared/nuxt-api-contract.QDGSGaVY.mjs';
+export { b as buildRequestPath, c as clearContractRegistry, d as defineApiContract, g as getContractByName, a as getContractMock, i as isApiContract, l as listRegisteredContracts, m as mockContract, r as registerContract } from './shared/nuxt-api-contract.V15soI_f.mjs';
 export { A as ApiError, B as BUILT_IN_ERROR_CODES, c as createApiError, i as isApiError, p as parseApiErrorPayload, s as serializeApiError, t as toApiError } from './shared/nuxt-api-contract.obS6uV8A.mjs';
 export { f as formatValidationMessage, s as sanitizeIssues, t as toValidationIssues } from './shared/nuxt-api-contract.DCAU2j7t.mjs';
+export { s as serializeQuery, a as serializeQueryValue, b as stableStringify } from './shared/nuxt-api-contract.Dr4tPqGB.mjs';
+export { a as autoMockContract, c as createRng, g as generateMockResponse, b as generateMockValue } from './shared/nuxt-api-contract.Bd2Y7Lx0.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-api-contract",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Type-safe API contracts between Nitro server routes and the Nuxt client.",
   "type": "module",
   "license": "MIT",
@@ -56,6 +56,10 @@
       "types": "./dist/openapi.d.mts",
       "import": "./dist/openapi.mjs"
     },
+    "./mock": {
+      "types": "./dist/mock.d.mts",
+      "import": "./dist/mock.mjs"
+    },
     "./package.json": "./package.json"
   },
   "bin": {