@richie-rpc/core 0.1.0

package/README.md

@@ -0,0 +1,109 @@
+# @richie-rpc/core
+
+Core package for defining type-safe API contracts with Zod schemas.
+
+## Installation
+
+```bash
+bun add @richie-rpc/core zod
+```
+
+## Usage
+
+### Defining a Contract
+
+```typescript
+import { defineContract } from '@richie-rpc/core';
+import { z } from 'zod';
+
+const contract = defineContract({
+  getUser: {
+    method: 'GET',
+    path: '/users/:id',
+    params: z.object({ id: z.string() }),
+    responses: {
+      200: z.object({ id: z.string(), name: z.string() }),
+      404: z.object({ error: z.string() })
+    }
+  },
+  createUser: {
+    method: 'POST',
+    path: '/users',
+    body: z.object({ name: z.string(), email: z.string().email() }),
+    responses: {
+      201: z.object({ id: z.string(), name: z.string(), email: z.string() })
+    }
+  }
+});
+```
+
+### Endpoint Definition Structure
+
+Each endpoint can have:
+
+- `method` (required): HTTP method (`GET`, `POST`, `PUT`, `PATCH`, `DELETE`, etc.)
+- `path` (required): URL path with optional parameters (`:id` syntax)
+- `params` (optional): Zod schema for path parameters
+- `query` (optional): Zod schema for query parameters
+- `headers` (optional): Zod schema for request headers
+- `body` (optional): Zod schema for request body
+- `responses` (required): Object mapping status codes to Zod schemas
+
+## Features
+
+- ✅ Type-safe contract definitions
+- ✅ Zod v3+ schema validation
+- ✅ Path parameter parsing and interpolation
+- ✅ Query parameter handling
+- ✅ Multiple response types per endpoint
+- ✅ Full TypeScript inference
+
+## Utilities
+
+### Path Parameter Utilities
+
+```typescript
+import { parsePathParams, matchPath, interpolatePath } from '@richie-rpc/core';
+
+// Parse parameter names from path
+parsePathParams('/users/:id/posts/:postId');
+// => ['id', 'postId']
+
+// Match a path and extract parameters
+matchPath('/users/:id', '/users/123');
+// => { id: '123' }
+
+// Interpolate parameters into path
+interpolatePath('/users/:id', { id: '123' });
+// => '/users/123'
+```
+
+### URL Building
+
+```typescript
+import { buildUrl } from '@richie-rpc/core';
+
+buildUrl('http://api.example.com', '/users', { limit: '10', offset: '0' });
+// => 'http://api.example.com/users?limit=10&offset=0'
+```
+
+## Type Inference
+
+The package exports several utility types for extracting types from endpoint definitions:
+
+- `ExtractParams<T>`: Extract path parameters type
+- `ExtractQuery<T>`: Extract query parameters type
+- `ExtractHeaders<T>`: Extract headers type
+- `ExtractBody<T>`: Extract request body type
+- `ExtractResponses<T>`: Extract all response types
+- `ExtractResponse<T, Status>`: Extract specific response type by status code
+
+## Links
+
+- **npm:** https://www.npmjs.com/package/@richie-rpc/core
+- **Repository:** https://github.com/ricsam/richie-rpc
+
+## License
+
+MIT
+

package/dist/cjs/index.cjs

@@ -0,0 +1,105 @@
+// @bun @bun-cjs
+(function(exports, require, module, __filename, __dirname) {var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// packages/core/index.ts
+var exports_core = {};
+__export(exports_core, {
+  parseQuery: () => parseQuery,
+  parsePathParams: () => parsePathParams,
+  matchPath: () => matchPath,
+  interpolatePath: () => interpolatePath,
+  defineContract: () => defineContract,
+  buildUrl: () => buildUrl
+});
+module.exports = __toCommonJS(exports_core);
+function parsePathParams(path) {
+  const matches = path.match(/:([^/]+)/g);
+  if (!matches)
+    return [];
+  return matches.map((match) => match.slice(1));
+}
+function matchPath(pattern, path) {
+  const paramNames = parsePathParams(pattern);
+  const regexPattern = pattern.replace(/:[^/]+/g, "([^/]+)").replace(/\//g, "\\/");
+  const regex = new RegExp(`^${regexPattern}$`);
+  const match = path.match(regex);
+  if (!match)
+    return null;
+  const params = {};
+  paramNames.forEach((name, index) => {
+    params[name] = match[index + 1] ?? "";
+  });
+  return params;
+}
+function interpolatePath(pattern, params) {
+  let result = pattern;
+  for (const [key, value] of Object.entries(params)) {
+    result = result.replace(`:${key}`, String(value));
+  }
+  return result;
+}
+function buildUrl(baseUrl, path, query) {
+  const url = new URL(path, baseUrl);
+  if (query) {
+    for (const [key, value] of Object.entries(query)) {
+      if (value !== undefined && value !== null) {
+        if (Array.isArray(value)) {
+          for (const v of value) {
+            url.searchParams.append(key, String(v));
+          }
+        } else {
+          url.searchParams.append(key, String(value));
+        }
+      }
+    }
+  }
+  return url.toString();
+}
+function parseQuery(searchParams) {
+  const result = {};
+  for (const [key, value] of searchParams.entries()) {
+    const existing = result[key];
+    if (existing) {
+      if (Array.isArray(existing)) {
+        existing.push(value);
+      } else {
+        result[key] = [existing, value];
+      }
+    } else {
+      result[key] = value;
+    }
+  }
+  return result;
+}
+function defineContract(contract) {
+  return contract;
+}
+})
+
+//# debugId=E90B1C296ECE391D64756E2164756E21

package/dist/cjs/index.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../index.ts"],
+  "sourcesContent": [
+    "import type { z } from 'zod';\n\n// HTTP methods supported\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';\n\n// Endpoint definition structure\nexport interface EndpointDefinition {\n  method: HttpMethod;\n  path: string;\n  params?: z.ZodTypeAny;\n  query?: z.ZodTypeAny;\n  headers?: z.ZodTypeAny;\n  body?: z.ZodTypeAny;\n  responses: Record<number, z.ZodTypeAny>;\n}\n\n// Contract is a collection of named endpoints\nexport type Contract = Record<string, EndpointDefinition>;\n\n// Extract the Zod type from a schema\nexport type InferZodType<T> = T extends z.ZodTypeAny ? z.infer<T> : never;\n\n// Extract params type from endpoint\nexport type ExtractParams<T extends EndpointDefinition> = T['params'] extends z.ZodTypeAny\n  ? InferZodType<T['params']>\n  : never;\n\n// Extract query type from endpoint\nexport type ExtractQuery<T extends EndpointDefinition> = T['query'] extends z.ZodTypeAny\n  ? InferZodType<T['query']>\n  : never;\n\n// Extract headers type from endpoint\nexport type ExtractHeaders<T extends EndpointDefinition> = T['headers'] extends z.ZodTypeAny\n  ? InferZodType<T['headers']>\n  : never;\n\n// Extract body type from endpoint\nexport type ExtractBody<T extends EndpointDefinition> = T['body'] extends z.ZodTypeAny\n  ? InferZodType<T['body']>\n  : never;\n\n// Extract response types for all status codes\nexport type ExtractResponses<T extends EndpointDefinition> = {\n  [K in keyof T['responses']]: T['responses'][K] extends z.ZodTypeAny\n    ? InferZodType<T['responses'][K]>\n    : never;\n};\n\n// Extract a specific response type by status code\nexport type ExtractResponse<\n  T extends EndpointDefinition,\n  Status extends number,\n> = Status extends keyof T['responses']\n  ? T['responses'][Status] extends z.ZodTypeAny\n    ? InferZodType<T['responses'][Status]>\n    : never\n  : never;\n\n// Path parameter extraction utilities\nexport type ExtractPathParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? Param | ExtractPathParams<`/${Rest}`>\n    : T extends `${infer _Start}:${infer Param}`\n      ? Param\n      : never;\n\n// Convert path params to object type\nexport type PathParamsObject<T extends string> = {\n  [K in ExtractPathParams<T>]: string;\n};\n\n/**\n * Parse path parameters from a URL path pattern\n * e.g., \"/users/:id/posts/:postId\" => [\"id\", \"postId\"]\n */\nexport function parsePathParams(path: string): string[] {\n  const matches = path.match(/:([^/]+)/g);\n  if (!matches) return [];\n  return matches.map((match) => match.slice(1));\n}\n\n/**\n * Match a URL path against a pattern and extract parameters\n * e.g., matchPath(\"/users/:id\", \"/users/123\") => { id: \"123\" }\n */\nexport function matchPath(pattern: string, path: string): Record<string, string> | null {\n  const paramNames = parsePathParams(pattern);\n\n  // Convert pattern to regex\n  const regexPattern = pattern.replace(/:[^/]+/g, '([^/]+)').replace(/\\//g, '\\\\/');\n\n  const regex = new RegExp(`^${regexPattern}$`);\n  const match = path.match(regex);\n\n  if (!match) return null;\n\n  const params: Record<string, string> = {};\n  paramNames.forEach((name, index) => {\n    params[name] = match[index + 1] ?? '';\n  });\n\n  return params;\n}\n\n/**\n * Interpolate path parameters into a URL pattern\n * e.g., interpolatePath(\"/users/:id\", { id: \"123\" }) => \"/users/123\"\n */\nexport function interpolatePath(pattern: string, params: Record<string, string | number>): string {\n  let result = pattern;\n  for (const [key, value] of Object.entries(params)) {\n    result = result.replace(`:${key}`, String(value));\n  }\n  return result;\n}\n\n/**\n * Build a complete URL with query parameters\n */\nexport function buildUrl(\n  baseUrl: string,\n  path: string,\n  query?: Record<string, string | number | boolean | string[]>,\n): string {\n  const url = new URL(path, baseUrl);\n\n  if (query) {\n    for (const [key, value] of Object.entries(query)) {\n      if (value !== undefined && value !== null) {\n        if (Array.isArray(value)) {\n          for (const v of value) {\n            url.searchParams.append(key, String(v));\n          }\n        } else {\n          url.searchParams.append(key, String(value));\n        }\n      }\n    }\n  }\n\n  return url.toString();\n}\n\n/**\n * Parse query parameters from URLSearchParams\n */\nexport function parseQuery(searchParams: URLSearchParams): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    const existing = result[key];\n    if (existing) {\n      if (Array.isArray(existing)) {\n        existing.push(value);\n      } else {\n        result[key] = [existing, value];\n      }\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\n// Type helper to ensure a value is a valid contract\nexport function defineContract<T extends Contract>(contract: T): T {\n  return contract;\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4EO,SAAS,eAAe,CAAC,MAAwB;AAAA,EACtD,MAAM,UAAU,KAAK,MAAM,WAAW;AAAA,EACtC,IAAI,CAAC;AAAA,IAAS,OAAO,CAAC;AAAA,EACtB,OAAO,QAAQ,IAAI,CAAC,UAAU,MAAM,MAAM,CAAC,CAAC;AAAA;AAOvC,SAAS,SAAS,CAAC,SAAiB,MAA6C;AAAA,EACtF,MAAM,aAAa,gBAAgB,OAAO;AAAA,EAG1C,MAAM,eAAe,QAAQ,QAAQ,WAAW,SAAS,EAAE,QAAQ,OAAO,KAAK;AAAA,EAE/E,MAAM,QAAQ,IAAI,OAAO,IAAI,eAAe;AAAA,EAC5C,MAAM,QAAQ,KAAK,MAAM,KAAK;AAAA,EAE9B,IAAI,CAAC;AAAA,IAAO,OAAO;AAAA,EAEnB,MAAM,SAAiC,CAAC;AAAA,EACxC,WAAW,QAAQ,CAAC,MAAM,UAAU;AAAA,IAClC,OAAO,QAAQ,MAAM,QAAQ,MAAM;AAAA,GACpC;AAAA,EAED,OAAO;AAAA;AAOF,SAAS,eAAe,CAAC,SAAiB,QAAiD;AAAA,EAChG,IAAI,SAAS;AAAA,EACb,YAAY,KAAK,UAAU,OAAO,QAAQ,MAAM,GAAG;AAAA,IACjD,SAAS,OAAO,QAAQ,IAAI,OAAO,OAAO,KAAK,CAAC;AAAA,EAClD;AAAA,EACA,OAAO;AAAA;AAMF,SAAS,QAAQ,CACtB,SACA,MACA,OACQ;AAAA,EACR,MAAM,MAAM,IAAI,IAAI,MAAM,OAAO;AAAA,EAEjC,IAAI,OAAO;AAAA,IACT,YAAY,KAAK,UAAU,OAAO,QAAQ,KAAK,GAAG;AAAA,MAChD,IAAI,UAAU,aAAa,UAAU,MAAM;AAAA,QACzC,IAAI,MAAM,QAAQ,KAAK,GAAG;AAAA,UACxB,WAAW,KAAK,OAAO;AAAA,YACrB,IAAI,aAAa,OAAO,KAAK,OAAO,CAAC,CAAC;AAAA,UACxC;AAAA,QACF,EAAO;AAAA,UACL,IAAI,aAAa,OAAO,KAAK,OAAO,KAAK,CAAC;AAAA;AAAA,MAE9C;AAAA,IACF;AAAA,EACF;AAAA,EAEA,OAAO,IAAI,SAAS;AAAA;AAMf,SAAS,UAAU,CAAC,cAAkE;AAAA,EAC3F,MAAM,SAA4C,CAAC;AAAA,EAEnD,YAAY,KAAK,UAAU,aAAa,QAAQ,GAAG;AAAA,IACjD,MAAM,WAAW,OAAO;AAAA,IACxB,IAAI,UAAU;AAAA,MACZ,IAAI,MAAM,QAAQ,QAAQ,GAAG;AAAA,QAC3B,SAAS,KAAK,KAAK;AAAA,MACrB,EAAO;AAAA,QACL,OAAO,OAAO,CAAC,UAAU,KAAK;AAAA;AAAA,IAElC,EAAO;AAAA,MACL,OAAO,OAAO;AAAA;AAAA,EAElB;AAAA,EAEA,OAAO;AAAA;AAIF,SAAS,cAAkC,CAAC,UAAgB;AAAA,EACjE,OAAO;AAAA;",
+  "debugId": "E90B1C296ECE391D64756E2164756E21",
+  "names": []
+}

package/dist/cjs/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "@richie-rpc/core",
+  "version": "0.1.0",
+  "type": "commonjs"
+}

package/dist/mjs/index.mjs

@@ -0,0 +1,74 @@
+// @bun
+// packages/core/index.ts
+function parsePathParams(path) {
+  const matches = path.match(/:([^/]+)/g);
+  if (!matches)
+    return [];
+  return matches.map((match) => match.slice(1));
+}
+function matchPath(pattern, path) {
+  const paramNames = parsePathParams(pattern);
+  const regexPattern = pattern.replace(/:[^/]+/g, "([^/]+)").replace(/\//g, "\\/");
+  const regex = new RegExp(`^${regexPattern}$`);
+  const match = path.match(regex);
+  if (!match)
+    return null;
+  const params = {};
+  paramNames.forEach((name, index) => {
+    params[name] = match[index + 1] ?? "";
+  });
+  return params;
+}
+function interpolatePath(pattern, params) {
+  let result = pattern;
+  for (const [key, value] of Object.entries(params)) {
+    result = result.replace(`:${key}`, String(value));
+  }
+  return result;
+}
+function buildUrl(baseUrl, path, query) {
+  const url = new URL(path, baseUrl);
+  if (query) {
+    for (const [key, value] of Object.entries(query)) {
+      if (value !== undefined && value !== null) {
+        if (Array.isArray(value)) {
+          for (const v of value) {
+            url.searchParams.append(key, String(v));
+          }
+        } else {
+          url.searchParams.append(key, String(value));
+        }
+      }
+    }
+  }
+  return url.toString();
+}
+function parseQuery(searchParams) {
+  const result = {};
+  for (const [key, value] of searchParams.entries()) {
+    const existing = result[key];
+    if (existing) {
+      if (Array.isArray(existing)) {
+        existing.push(value);
+      } else {
+        result[key] = [existing, value];
+      }
+    } else {
+      result[key] = value;
+    }
+  }
+  return result;
+}
+function defineContract(contract) {
+  return contract;
+}
+export {
+  parseQuery,
+  parsePathParams,
+  matchPath,
+  interpolatePath,
+  defineContract,
+  buildUrl
+};
+
+//# debugId=AAE15A31FDF5132964756E2164756E21

package/dist/mjs/index.mjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../index.ts"],
+  "sourcesContent": [
+    "import type { z } from 'zod';\n\n// HTTP methods supported\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';\n\n// Endpoint definition structure\nexport interface EndpointDefinition {\n  method: HttpMethod;\n  path: string;\n  params?: z.ZodTypeAny;\n  query?: z.ZodTypeAny;\n  headers?: z.ZodTypeAny;\n  body?: z.ZodTypeAny;\n  responses: Record<number, z.ZodTypeAny>;\n}\n\n// Contract is a collection of named endpoints\nexport type Contract = Record<string, EndpointDefinition>;\n\n// Extract the Zod type from a schema\nexport type InferZodType<T> = T extends z.ZodTypeAny ? z.infer<T> : never;\n\n// Extract params type from endpoint\nexport type ExtractParams<T extends EndpointDefinition> = T['params'] extends z.ZodTypeAny\n  ? InferZodType<T['params']>\n  : never;\n\n// Extract query type from endpoint\nexport type ExtractQuery<T extends EndpointDefinition> = T['query'] extends z.ZodTypeAny\n  ? InferZodType<T['query']>\n  : never;\n\n// Extract headers type from endpoint\nexport type ExtractHeaders<T extends EndpointDefinition> = T['headers'] extends z.ZodTypeAny\n  ? InferZodType<T['headers']>\n  : never;\n\n// Extract body type from endpoint\nexport type ExtractBody<T extends EndpointDefinition> = T['body'] extends z.ZodTypeAny\n  ? InferZodType<T['body']>\n  : never;\n\n// Extract response types for all status codes\nexport type ExtractResponses<T extends EndpointDefinition> = {\n  [K in keyof T['responses']]: T['responses'][K] extends z.ZodTypeAny\n    ? InferZodType<T['responses'][K]>\n    : never;\n};\n\n// Extract a specific response type by status code\nexport type ExtractResponse<\n  T extends EndpointDefinition,\n  Status extends number,\n> = Status extends keyof T['responses']\n  ? T['responses'][Status] extends z.ZodTypeAny\n    ? InferZodType<T['responses'][Status]>\n    : never\n  : never;\n\n// Path parameter extraction utilities\nexport type ExtractPathParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? Param | ExtractPathParams<`/${Rest}`>\n    : T extends `${infer _Start}:${infer Param}`\n      ? Param\n      : never;\n\n// Convert path params to object type\nexport type PathParamsObject<T extends string> = {\n  [K in ExtractPathParams<T>]: string;\n};\n\n/**\n * Parse path parameters from a URL path pattern\n * e.g., \"/users/:id/posts/:postId\" => [\"id\", \"postId\"]\n */\nexport function parsePathParams(path: string): string[] {\n  const matches = path.match(/:([^/]+)/g);\n  if (!matches) return [];\n  return matches.map((match) => match.slice(1));\n}\n\n/**\n * Match a URL path against a pattern and extract parameters\n * e.g., matchPath(\"/users/:id\", \"/users/123\") => { id: \"123\" }\n */\nexport function matchPath(pattern: string, path: string): Record<string, string> | null {\n  const paramNames = parsePathParams(pattern);\n\n  // Convert pattern to regex\n  const regexPattern = pattern.replace(/:[^/]+/g, '([^/]+)').replace(/\\//g, '\\\\/');\n\n  const regex = new RegExp(`^${regexPattern}$`);\n  const match = path.match(regex);\n\n  if (!match) return null;\n\n  const params: Record<string, string> = {};\n  paramNames.forEach((name, index) => {\n    params[name] = match[index + 1] ?? '';\n  });\n\n  return params;\n}\n\n/**\n * Interpolate path parameters into a URL pattern\n * e.g., interpolatePath(\"/users/:id\", { id: \"123\" }) => \"/users/123\"\n */\nexport function interpolatePath(pattern: string, params: Record<string, string | number>): string {\n  let result = pattern;\n  for (const [key, value] of Object.entries(params)) {\n    result = result.replace(`:${key}`, String(value));\n  }\n  return result;\n}\n\n/**\n * Build a complete URL with query parameters\n */\nexport function buildUrl(\n  baseUrl: string,\n  path: string,\n  query?: Record<string, string | number | boolean | string[]>,\n): string {\n  const url = new URL(path, baseUrl);\n\n  if (query) {\n    for (const [key, value] of Object.entries(query)) {\n      if (value !== undefined && value !== null) {\n        if (Array.isArray(value)) {\n          for (const v of value) {\n            url.searchParams.append(key, String(v));\n          }\n        } else {\n          url.searchParams.append(key, String(value));\n        }\n      }\n    }\n  }\n\n  return url.toString();\n}\n\n/**\n * Parse query parameters from URLSearchParams\n */\nexport function parseQuery(searchParams: URLSearchParams): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    const existing = result[key];\n    if (existing) {\n      if (Array.isArray(existing)) {\n        existing.push(value);\n      } else {\n        result[key] = [existing, value];\n      }\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\n// Type helper to ensure a value is a valid contract\nexport function defineContract<T extends Contract>(contract: T): T {\n  return contract;\n}\n"
+  ],
+  "mappings": ";;AA4EO,SAAS,eAAe,CAAC,MAAwB;AAAA,EACtD,MAAM,UAAU,KAAK,MAAM,WAAW;AAAA,EACtC,IAAI,CAAC;AAAA,IAAS,OAAO,CAAC;AAAA,EACtB,OAAO,QAAQ,IAAI,CAAC,UAAU,MAAM,MAAM,CAAC,CAAC;AAAA;AAOvC,SAAS,SAAS,CAAC,SAAiB,MAA6C;AAAA,EACtF,MAAM,aAAa,gBAAgB,OAAO;AAAA,EAG1C,MAAM,eAAe,QAAQ,QAAQ,WAAW,SAAS,EAAE,QAAQ,OAAO,KAAK;AAAA,EAE/E,MAAM,QAAQ,IAAI,OAAO,IAAI,eAAe;AAAA,EAC5C,MAAM,QAAQ,KAAK,MAAM,KAAK;AAAA,EAE9B,IAAI,CAAC;AAAA,IAAO,OAAO;AAAA,EAEnB,MAAM,SAAiC,CAAC;AAAA,EACxC,WAAW,QAAQ,CAAC,MAAM,UAAU;AAAA,IAClC,OAAO,QAAQ,MAAM,QAAQ,MAAM;AAAA,GACpC;AAAA,EAED,OAAO;AAAA;AAOF,SAAS,eAAe,CAAC,SAAiB,QAAiD;AAAA,EAChG,IAAI,SAAS;AAAA,EACb,YAAY,KAAK,UAAU,OAAO,QAAQ,MAAM,GAAG;AAAA,IACjD,SAAS,OAAO,QAAQ,IAAI,OAAO,OAAO,KAAK,CAAC;AAAA,EAClD;AAAA,EACA,OAAO;AAAA;AAMF,SAAS,QAAQ,CACtB,SACA,MACA,OACQ;AAAA,EACR,MAAM,MAAM,IAAI,IAAI,MAAM,OAAO;AAAA,EAEjC,IAAI,OAAO;AAAA,IACT,YAAY,KAAK,UAAU,OAAO,QAAQ,KAAK,GAAG;AAAA,MAChD,IAAI,UAAU,aAAa,UAAU,MAAM;AAAA,QACzC,IAAI,MAAM,QAAQ,KAAK,GAAG;AAAA,UACxB,WAAW,KAAK,OAAO;AAAA,YACrB,IAAI,aAAa,OAAO,KAAK,OAAO,CAAC,CAAC;AAAA,UACxC;AAAA,QACF,EAAO;AAAA,UACL,IAAI,aAAa,OAAO,KAAK,OAAO,KAAK,CAAC;AAAA;AAAA,MAE9C;AAAA,IACF;AAAA,EACF;AAAA,EAEA,OAAO,IAAI,SAAS;AAAA;AAMf,SAAS,UAAU,CAAC,cAAkE;AAAA,EAC3F,MAAM,SAA4C,CAAC;AAAA,EAEnD,YAAY,KAAK,UAAU,aAAa,QAAQ,GAAG;AAAA,IACjD,MAAM,WAAW,OAAO;AAAA,IACxB,IAAI,UAAU;AAAA,MACZ,IAAI,MAAM,QAAQ,QAAQ,GAAG;AAAA,QAC3B,SAAS,KAAK,KAAK;AAAA,MACrB,EAAO;AAAA,QACL,OAAO,OAAO,CAAC,UAAU,KAAK;AAAA;AAAA,IAElC,EAAO;AAAA,MACL,OAAO,OAAO;AAAA;AAAA,EAElB;AAAA,EAEA,OAAO;AAAA;AAIF,SAAS,cAAkC,CAAC,UAAgB;AAAA,EACjE,OAAO;AAAA;",
+  "debugId": "AAE15A31FDF5132964756E2164756E21",
+  "names": []
+}

package/dist/mjs/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "@richie-rpc/core",
+  "version": "0.1.0",
+  "type": "module"
+}

package/dist/types/index.d.ts

@@ -0,0 +1,49 @@
+import type { z } from 'zod';
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+export interface EndpointDefinition {
+    method: HttpMethod;
+    path: string;
+    params?: z.ZodTypeAny;
+    query?: z.ZodTypeAny;
+    headers?: z.ZodTypeAny;
+    body?: z.ZodTypeAny;
+    responses: Record<number, z.ZodTypeAny>;
+}
+export type Contract = Record<string, EndpointDefinition>;
+export type InferZodType<T> = T extends z.ZodTypeAny ? z.infer<T> : never;
+export type ExtractParams<T extends EndpointDefinition> = T['params'] extends z.ZodTypeAny ? InferZodType<T['params']> : never;
+export type ExtractQuery<T extends EndpointDefinition> = T['query'] extends z.ZodTypeAny ? InferZodType<T['query']> : never;
+export type ExtractHeaders<T extends EndpointDefinition> = T['headers'] extends z.ZodTypeAny ? InferZodType<T['headers']> : never;
+export type ExtractBody<T extends EndpointDefinition> = T['body'] extends z.ZodTypeAny ? InferZodType<T['body']> : never;
+export type ExtractResponses<T extends EndpointDefinition> = {
+    [K in keyof T['responses']]: T['responses'][K] extends z.ZodTypeAny ? InferZodType<T['responses'][K]> : never;
+};
+export type ExtractResponse<T extends EndpointDefinition, Status extends number> = Status extends keyof T['responses'] ? T['responses'][Status] extends z.ZodTypeAny ? InferZodType<T['responses'][Status]> : never : never;
+export type ExtractPathParams<T extends string> = T extends `${infer _Start}:${infer Param}/${infer Rest}` ? Param | ExtractPathParams<`/${Rest}`> : T extends `${infer _Start}:${infer Param}` ? Param : never;
+export type PathParamsObject<T extends string> = {
+    [K in ExtractPathParams<T>]: string;
+};
+/**
+ * Parse path parameters from a URL path pattern
+ * e.g., "/users/:id/posts/:postId" => ["id", "postId"]
+ */
+export declare function parsePathParams(path: string): string[];
+/**
+ * Match a URL path against a pattern and extract parameters
+ * e.g., matchPath("/users/:id", "/users/123") => { id: "123" }
+ */
+export declare function matchPath(pattern: string, path: string): Record<string, string> | null;
+/**
+ * Interpolate path parameters into a URL pattern
+ * e.g., interpolatePath("/users/:id", { id: "123" }) => "/users/123"
+ */
+export declare function interpolatePath(pattern: string, params: Record<string, string | number>): string;
+/**
+ * Build a complete URL with query parameters
+ */
+export declare function buildUrl(baseUrl: string, path: string, query?: Record<string, string | number | boolean | string[]>): string;
+/**
+ * Parse query parameters from URLSearchParams
+ */
+export declare function parseQuery(searchParams: URLSearchParams): Record<string, string | string[]>;
+export declare function defineContract<T extends Contract>(contract: T): T;

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@richie-rpc/core",
+  "version": "0.1.0",
+  "main": "./dist/cjs/index.cjs",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "require": "./dist/cjs/index.cjs",
+      "import": "./dist/mjs/index.mjs"
+    }
+  },
+  "dependencies": {
+    "zod": "^3.23.8"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "module": "./dist/mjs/index.mjs",
+  "types": "./dist/types/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "author": "Richie <oss@ricsam.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ricsam/richie-rpc.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ricsam/richie-rpc/issues"
+  },
+  "homepage": "https://github.com/ricsam/richie-rpc#readme",
+  "keywords": [
+    "typescript",
+    "bun",
+    "zod",
+    "api",
+    "contract",
+    "rpc",
+    "rest",
+    "openapi",
+    "type-safe"
+  ],
+  "description": "Core contract definitions and type utilities for Richie RPC"
+}