@ir-kit/openapi-ts-orpc 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ahmed Rowaihi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,234 @@
+# @ir-kit/openapi-ts-orpc
+
+Generates type-safe [oRPC](https://orpc.unnoq.com/) contracts, routers, server skeletons, clients, and mock factories from OpenAPI specifications. Plugin for [@hey-api/openapi-ts](https://heyapi.dev/).
+
+## Installation
+
+```bash
+bun add -d @ir-kit/openapi-ts-orpc @hey-api/openapi-ts
+bun add @orpc/contract @orpc/server @orpc/client zod
+```
+
+## What it generates
+
+| File                    | Description                                              | Required              |
+| ----------------------- | -------------------------------------------------------- | --------------------- |
+| `contract.gen.ts`       | Type-safe oRPC contracts with input/output schemas       | Always                |
+| `router.gen.ts`         | Organized router structure                               | Always                |
+| `server.gen.ts`         | `os = implement(router)` helper                          | Optional              |
+| `client.gen.ts`         | Client factory functions (RPC, WebSocket, OpenAPI, etc.) | Optional              |
+| `tanstack.gen.ts`       | TanStack Query utilities                                 | Optional              |
+| `faker.gen.ts`          | Mock data factory functions per tag                      | Optional (faker mode) |
+| `src/handlers/<tag>.ts` | Handler files with three modes                           | Optional              |
+
+---
+
+## Basic Usage
+
+```typescript
+import { defineConfig } from "@hey-api/openapi-ts";
+import { defineConfig as defineORPCConfig } from "@ir-kit/openapi-ts-orpc";
+
+export default defineConfig({
+  input: "openapi.json",
+  output: { path: "./src/generated" },
+  plugins: [
+    "@hey-api/typescript",
+    "zod",
+    defineORPCConfig(), // contracts + router only (default)
+  ],
+});
+```
+
+---
+
+## Server (Backend)
+
+```typescript
+defineORPCConfig({
+  server: {
+    implementation: true,
+    handlers: {
+      dir: "src/handlers",
+      importAlias: "#/",
+      mode: "stub", // 'stub' | 'faker' | 'proxy'
+    },
+  },
+});
+```
+
+### Handler modes
+
+**`stub`** (default) — throws `ORPCError('NOT_IMPLEMENTED')`:
+
+```typescript
+getUser: os.users.getUser.handler(async () => {
+  throw new ORPCError("NOT_IMPLEMENTED");
+}),
+```
+
+**`faker`** — returns mock data from generated `faker.gen.ts` factories:
+
+```typescript
+getUser: os.users.getUser.handler(async () => mockGetUser()),
+```
+
+Requires `@faker-js/faker` as a dependency. Generates type-safe factories with:
+
+- Field name heuristics (email, phone, url, etc.)
+- Enum support via `faker.helpers.arrayElement()`
+- Nested objects and arrays from schema
+- Date `.toISOString()` chaining
+
+**`proxy`** — forwards requests through the generated OpenAPI client:
+
+```typescript
+getUser: os.users.getUser.handler(async ({ input }) => apiClient.users.getUser(input)),
+```
+
+Configure the client import:
+
+```typescript
+handlers: {
+  mode: 'proxy',
+  proxy: { clientImport: { name: 'apiClient', from: '#/lib/client' } },
+}
+```
+
+### Handler file management
+
+- **New tags** create new handler files
+- **Existing files** only get missing procedures appended (never overwritten)
+- **`override: true`** rewrites files completely on each run
+
+---
+
+## Client (Frontend)
+
+```typescript
+defineORPCConfig({
+  client: {
+    rpc: true, // HTTP client (native oRPC RPC protocol)
+    openapi: true, // REST client (OpenAPI protocol)
+    tanstack: true, // TanStack Query utilities
+  },
+});
+```
+
+| Option        | Description                               |
+| ------------- | ----------------------------------------- |
+| `rpc`         | HTTP/Fetch client (native RPC protocol)   |
+| `websocket`   | WebSocket client                          |
+| `messageport` | MessagePort client (Web Workers, iframes) |
+| `openapi`     | REST client (OpenAPI protocol)            |
+| `tanstack`    | TanStack Query utilities                  |
+
+---
+
+## Full Configuration Reference
+
+```typescript
+defineORPCConfig({
+  // Server-side generation
+  server: {
+    implementation: false,
+    handlers: {
+      dir: "src/handlers",
+      importAlias: "#/",
+      implementer: { name: "publicOs", from: "#/procedures" },
+      mode: "stub", // 'stub' | 'faker' | 'proxy'
+      override: false, // rewrite files on each run
+      proxy: { clientImport: { name: "apiClient", from: "#/lib/client" } },
+    },
+  },
+
+  // Client-side generation
+  client: {
+    rpc: false,
+    websocket: false,
+    messageport: false,
+    openapi: false,
+    tanstack: false,
+  },
+
+  // Input structure mode
+  mode: "compact", // 'compact' | 'detailed'
+
+  // Router grouping
+  group: "tags", // 'tags' | 'paths' | 'flat' | 'operationId'
+
+  // JSDoc comments on contracts
+  comments: true,
+
+  // Naming rules (uses hey-api's applyNaming)
+  naming: {
+    contract: { casing: "PascalCase" }, // contract constant names
+    operation: { casing: "camelCase" }, // router/procedure keys
+  },
+
+  // Validator configuration
+  validator: "zod", // string | false | { input: string | false, output: string | false }
+});
+```
+
+### `mode` — Input structure
+
+| Mode | Description |
+| --- | --- |
+| `compact` (default) | Flat merged input — path + body for mutations, path + query for reads |
+| `detailed` | Structured `{ params, query, body, headers }` input |
+
+> **Note:** Standard validators (zod, valibot, arktype) always use detailed mode regardless of this setting. Compact mode is only supported with Typia. This is because hey-api's `createRequestSchema` API always returns a structured object.
+
+### `group` — Router grouping
+
+| Mode             | Description                 | Example                      |
+| ---------------- | --------------------------- | ---------------------------- |
+| `tags` (default) | Group by OpenAPI tag        | `router.users.getById()`     |
+| `paths`          | Group by URL structure      | `router.api.users.getById()` |
+| `flat`           | No grouping                 | `router.getUserById()`       |
+| `operationId`    | Group by operationId prefix | `router.auth.login()`        |
+
+### `validator` — Validation configuration
+
+Works with any hey-api validator plugin (zod, valibot, arktype):
+
+```typescript
+// Single validator for both input and output (default)
+validator: 'zod'
+
+// Separate input/output validators
+validator: { input: 'zod', output: false }
+
+// Disable validation entirely
+validator: false
+```
+
+### `naming` — Name customization
+
+Uses `applyNaming` from `@hey-api/shared`:
+
+```typescript
+naming: {
+  contract: { casing: 'PascalCase' },   // GetUserContract
+  operation: { casing: 'camelCase' },    // getUser
+}
+```
+
+Supports `'camelCase'`, `'PascalCase'`, `'snake_case'`, `'SCREAMING_SNAKE_CASE'`, `'preserve'`, or a custom transform function.
+
+---
+
+## Requirements
+
+- `@hey-api/openapi-ts` >= 0.95.0
+- `@hey-api/typescript` plugin (auto-included as dependency)
+- A validator plugin (`zod`, `valibot`, `arktype`) configured in your plugins
+
+---
+
+## Typia Integration
+
+Want compile-time validators instead of Zod? See [docs/typia.md](docs/typia.md).
+
+Set `validator: { input: 'typia', output: 'typia' }` to use Typia's Standard Schema validators.

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+import type { ORPCPlugin, UserConfig } from "./types";
+export declare const resolveConfig: (userConfig: Partial<UserConfig>) => ORPCPlugin["Config"]["config"];
+export declare const defaultConfig: ORPCPlugin["Config"];
+export declare const defineConfig: (userConfig?: Omit<UserConfig, "name"> | undefined) => Omit<import("@hey-api/shared").Plugin.Config<import("@hey-api/shared").Plugin.Types<UserConfig, import("./types").Config, never>>, "name"> & {
+    name: any;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAiDtD,eAAO,MAAM,aAAa,GACxB,YAAY,OAAO,CAAC,UAAU,CAAC,KAC9B,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,CA2B/B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,UAAU,CAAC,QAAQ,CAkC9C,CAAC;AAEF,eAAO,MAAM,YAAY;;CAAoC,CAAC"}

package/dist/config.js

@@ -0,0 +1,101 @@
+import { definePluginConfig, resolveNaming } from "@hey-api/shared";
+import { handler } from "./plugin";
+function resolveHandlers(server) {
+    const handlers = server?.handlers;
+    const implementation = server?.implementation ?? false;
+    if (handlers === false)
+        return false;
+    if (handlers === true || (handlers === undefined && implementation)) {
+        return { dir: "src/handlers", mode: "stub", override: false };
+    }
+    if (typeof handlers === "object") {
+        return {
+            dir: handlers.dir ?? "src/handlers",
+            importAlias: handlers.importAlias,
+            implementer: handlers.implementer,
+            mode: handlers.mode ?? "stub",
+            override: handlers.override ?? false,
+            faker: handlers.faker,
+            proxy: handlers.proxy,
+        };
+    }
+    return false;
+}
+function resolveValidator(validator) {
+    if (validator === false)
+        return { input: false, output: false };
+    if (typeof validator === "string")
+        return { input: validator, output: validator };
+    if (typeof validator === "object") {
+        return {
+            input: validator.input ?? "zod",
+            output: validator.output ?? "zod",
+        };
+    }
+    return { input: "zod", output: "zod" };
+}
+export const resolveConfig = (userConfig) => {
+    return {
+        server: {
+            implementation: userConfig.server?.implementation ?? false,
+            handlers: resolveHandlers(userConfig.server),
+        },
+        client: {
+            rpc: userConfig.client?.rpc ?? false,
+            websocket: userConfig.client?.websocket ?? false,
+            messageport: userConfig.client?.messageport ?? false,
+            openapi: userConfig.client?.openapi ?? false,
+            tanstack: userConfig.client?.tanstack ?? false,
+        },
+        comments: userConfig.comments ?? true,
+        group: userConfig.group ?? "tags",
+        includeInEntry: true,
+        mode: userConfig.mode ?? "compact",
+        naming: {
+            contract: resolveNaming(userConfig.naming?.contract) ?? {
+                casing: "PascalCase",
+            },
+            operation: resolveNaming(userConfig.naming?.operation) ?? {
+                casing: "camelCase",
+            },
+        },
+        validator: resolveValidator(userConfig.validator),
+    };
+};
+export const defaultConfig = {
+    config: {
+        server: { implementation: false, handlers: false },
+        client: {
+            rpc: false,
+            websocket: false,
+            messageport: false,
+            openapi: false,
+            tanstack: false,
+        },
+        comments: true,
+        group: "tags",
+        includeInEntry: true,
+        mode: "compact",
+        naming: {
+            contract: { casing: "PascalCase" },
+            operation: { casing: "camelCase" },
+        },
+        validator: { input: "zod", output: "zod" },
+    },
+    dependencies: ["@hey-api/typescript"],
+    handler,
+    name: "@ir-kit/orpc",
+    resolveConfig: (plugin) => {
+        plugin.config.server ??= { implementation: false, handlers: false };
+        plugin.config.server.handlers = resolveHandlers(plugin.config.server);
+        plugin.config.validator = resolveValidator(plugin.config.validator);
+        const { input, output } = plugin.config.validator;
+        if (input)
+            plugin.dependencies?.add(input);
+        if (output && output !== input)
+            plugin.dependencies?.add(output);
+    },
+    tags: ["transformer"],
+};
+export const defineConfig = definePluginConfig(defaultConfig);
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/generators/client.d.ts

@@ -0,0 +1,7 @@
+import type { ClientGeneratorInput } from "./types";
+/**
+ * Generates client creation functions for oRPC.
+ * Creates type-safe client factory functions based on user configuration.
+ */
+export declare const generateClients: ({ clientTypes, context, }: ClientGeneratorInput) => void;
+//# sourceMappingURL=client.d.ts.map

package/dist/generators/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/generators/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAoB,MAAM,SAAS,CAAC;AA+BtE;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,2BAG7B,oBAAoB,KAAG,IAkDzB,CAAC"}

package/dist/generators/client.js

@@ -0,0 +1,113 @@
+import { $ } from "@hey-api/openapi-ts";
+/**
+ * Client type configurations.
+ * Maps client types to their external symbols and config.
+ */
+const CLIENT_TYPE_CONFIGS = {
+    openapi: {
+        configTypeName: "OpenApiLinkClientConfig",
+        functionName: "createOpenApiClient",
+        linkSymbolResource: "@orpc/openapi-client/fetch.OpenAPILink",
+        needsRouter: true, // OpenAPILink requires router as first arg
+    },
+    rpc: {
+        configTypeName: "RpcLinkClientConfig",
+        functionName: "createRpcLinkClient",
+        linkSymbolResource: "@orpc/client/fetch.RPCLink",
+    },
+    messageport: {
+        configTypeName: "RpcMessagePortClientConfig",
+        functionName: "createRpcMessagePortClient",
+        linkSymbolResource: "@orpc/client/message-port.RPCLink",
+    },
+    websocket: {
+        configTypeName: "RpcWebSocketClientConfig",
+        functionName: "createRpcWebSocketClient",
+        linkSymbolResource: "@orpc/client/websocket.RPCLink",
+    },
+    tanstack: null, // Handled by tanstack generator
+};
+/**
+ * Generates client creation functions for oRPC.
+ * Creates type-safe client factory functions based on user configuration.
+ */
+export const generateClients = ({ clientTypes, context, }) => {
+    const { clientFile, plugin, routerSymbol } = context;
+    const contractRouterClientSymbol = plugin.external("@orpc/contract.ContractRouterClient");
+    const createORPCClientSymbol = plugin.external("@orpc/client.createORPCClient");
+    // Filter out tanstack and get configs
+    const clientConfigs = clientTypes
+        .filter((type) => type !== "tanstack")
+        .map((type) => CLIENT_TYPE_CONFIGS[type])
+        .filter((config) => config !== null);
+    // Generate each client
+    for (const config of clientConfigs) {
+        generateClient(plugin, routerSymbol, clientFile, contractRouterClientSymbol, createORPCClientSymbol, config);
+    }
+    // Export shared Client type if any clients were generated
+    if (clientConfigs.length > 0) {
+        const clientTypeSymbol = plugin.symbol("Client", {
+            getFilePath: () => clientFile,
+            meta: {
+                category: "client",
+                resource: "client",
+                tool: "orpc",
+            },
+        });
+        const clientTypeAlias = $.type
+            .alias(clientTypeSymbol)
+            .export()
+            .type($.type
+            .expr(contractRouterClientSymbol)
+            .generic($.type.query($(routerSymbol))));
+        plugin.node(clientTypeAlias);
+    }
+};
+/**
+ * Helper function to generate a single client creation function.
+ */
+function generateClient(plugin, routerSymbol, clientFile, contractRouterClientSymbol, createORPCClientSymbol, config) {
+    const { configTypeName, functionName, linkSymbolResource, needsRouter = false, } = config;
+    const linkSymbol = plugin.external(linkSymbolResource);
+    // ClientConfig type: inferred from Link constructor
+    const clientConfigSymbol = plugin.symbol(configTypeName, {
+        getFilePath: () => clientFile,
+        meta: {
+            category: "client",
+            resource: configTypeName,
+            tool: "orpc",
+        },
+    });
+    // For OpenAPILink, config is the second parameter
+    const configParamIndex = needsRouter ? 1 : 0;
+    const clientConfigType = $.type.idx($.type.expr("ConstructorParameters").generic($.type.query($(linkSymbol))), configParamIndex);
+    const clientConfigStatement = $.type
+        .alias(clientConfigSymbol)
+        .export()
+        .type(clientConfigType);
+    plugin.node(clientConfigStatement);
+    // createClient function
+    const createClientSymbol = plugin.symbol(functionName, {
+        getFilePath: () => clientFile,
+        meta: {
+            category: "client",
+            resource: functionName,
+            tool: "orpc",
+        },
+    });
+    const createClientFunc = $.const(createClientSymbol)
+        .export()
+        .assign($.func()
+        .param("config", (p) => p.type($.type.expr(clientConfigSymbol)))
+        .returns($.type
+        .expr(contractRouterClientSymbol)
+        .generic($.type.query($(routerSymbol))))
+        .do(
+    // OpenAPILink needs router as first arg: new OpenAPILink(router, config)
+    // RPCLink only needs config: new RPCLink(config)
+    needsRouter
+        ? $.const("link").assign($.new(linkSymbol, $(routerSymbol), $.id("config")))
+        : $.const("link").assign($.new(linkSymbol, $.id("config"))), $.return($.call(createORPCClientSymbol, $.id("link")))));
+    plugin.node(createClientFunc);
+}
+//# sourceMappingURL=client.js.map

package/dist/generators/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/generators/client.ts"],"names":[],"mappings":"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"}

package/dist/generators/contract-validator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Standard validator API contract builders.
+ * Works with any hey-api validator plugin (zod, valibot, arktype)
+ * that exposes the `createRequestSchema` API.
+ */
+import type { IR } from "@hey-api/shared";
+import type { ORPCPlugin } from "../types";
+type Plugin = ORPCPlugin["Instance"];
+type InputResult = {
+    expr: any;
+    useDetailedMode: boolean;
+};
+export type BodyKind = "json" | "raw-file" | "multipart" | "other";
+/** Classify the body media-type so callers don't pass loose booleans. */
+export declare function classifyBody(mediaType: string | undefined): BodyKind;
+/** Build a validator-backed `.input()` expression for a contract. */
+export declare function buildValidatorInput(plugin: Plugin, operation: IR.OperationObject, bodyKind: BodyKind): InputResult | null;
+export declare function buildValidatorOutput(plugin: Plugin, operationId: string): any | null;
+export declare function buildValidatorErrorMap(plugin: Plugin, operation: IR.OperationObject): any | null;
+export {};
+//# sourceMappingURL=contract-validator.d.ts.map

package/dist/generators/contract-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-validator.d.ts","sourceRoot":"","sources":["../../src/generators/contract-validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAG1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAM3C,KAAK,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;AACrC,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC;AAE3D,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;AAMnE,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAWpE;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,EAAE,CAAC,eAAe,EAC7B,QAAQ,EAAE,QAAQ,GACjB,WAAW,GAAG,IAAI,CAoCpB;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,GAAG,GAAG,IAAI,CAeZ;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,EAAE,CAAC,eAAe,GAC5B,GAAG,GAAG,IAAI,CAOZ"}