@supawatch/target-orpc 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Omar Dulaimi
+
+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,26 @@
+# @supawatch/target-orpc
+
+The oRPC target for
+[supawatch](https://github.com/omar-dulaimi/supawatch). Emits one oRPC
+router per table: `list`, `byId` keyed by the primary key, and `create`
+on tables, with inputs validated by the already generated Zod schemas
+through `os.input()`. Each module exports a factory that takes your
+postgres.js connection and returns the router, ready to serve or to
+call in process with oRPC's `call()`.
+
+```ts
+targets: [
+  { kind: "zod", strict: true, emit: { insert: true } },
+  { kind: "orpc" },
+]
+```
+
+Requires the zod target; `schemasImportPath` (default `"../zod"`)
+points the emitted imports at it. API shapes verified empirically
+against `@orpc/server` 1.x: invalid inputs reject with `ORPCError`
+before the handler runs.
+
+The repo's suite calls the emitted procedures against a real database,
+valid and invalid inputs both.
+
+MIT.

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import type { Rendered, Snapshot, Table, Target, TargetCapabilities, TargetOptions } from "@supawatch/core";
+export interface OrpcTargetOptions extends TargetOptions {
+    schemasImportPath?: string;
+}
+export declare function exportNameFor(table: Table): string;
+export declare class OrpcTarget implements Target<OrpcTargetOptions> {
+    readonly name = "orpc";
+    readonly fileExtension = ".mjs";
+    readonly capabilities: TargetCapabilities;
+    renderTable(table: Table, _snapshot: Snapshot, opts: OrpcTargetOptions): Rendered;
+    renderTypes(table: Table, _snapshot: Snapshot, _opts: OrpcTargetOptions): string;
+}
+export default OrpcTarget;

package/dist/index.js

@@ -0,0 +1,62 @@
+function baseNameFor(table) {
+    return table.name.replace(/[^a-zA-Z0-9_]/g, "_");
+}
+export function exportNameFor(table) {
+    const base = baseNameFor(table);
+    return `create${base.charAt(0).toUpperCase() + base.slice(1)}Orpc`;
+}
+function quotedIdent(table) {
+    const q = (s) => '"' + s.replace(/"/g, '""') + '"';
+    return `${q(table.schema)}.${q(table.name)}`;
+}
+export class OrpcTarget {
+    name = "orpc";
+    fileExtension = ".mjs";
+    capabilities = {
+        strictObjects: false,
+        brandedTypes: false,
+        dateInstances: true,
+    };
+    renderTable(table, _snapshot, opts) {
+        const base = baseNameFor(table);
+        const importPath = opts.schemasImportPath ?? "../zod";
+        const rowName = `${base}Row`;
+        const insertName = `${base}Insert`;
+        const ident = quotedIdent(table);
+        const singlePk = table.primaryKey.length === 1 ? table.primaryKey[0] : null;
+        const lines = [
+            `export function ${exportNameFor(table)}(sql) {`,
+            "  const procedures = {",
+            "    list: os.handler(async () => {",
+            `      const rows = await sql.unsafe('select * from ${ident} limit 100');`,
+            `      return rows.map((row) => ${rowName}.parse(row));`,
+            "    }),",
+        ];
+        if (singlePk) {
+            const pkIdent = '"' + singlePk.replace(/"/g, '""') + '"';
+            lines.push(`    byId: os.input(${rowName}.pick({ ${JSON.stringify(singlePk)}: true })).handler(async ({ input }) => {`, `      const rows = await sql.unsafe('select * from ${ident} where ${pkIdent} = $1 limit 1', [input[${JSON.stringify(singlePk)}]]);`, `      return rows.length > 0 ? ${rowName}.parse(rows[0]) : null;`, "    }),");
+        }
+        if (table.kind === "table") {
+            lines.push(`    create: os.input(${insertName}).handler(async ({ input }) => {`, "      const keys = Object.keys(input);", `      const cols = keys.map((k) => '"' + k.replace(/"/g, '""') + '"').join(', ');`, "      const params = keys.map((_, i) => '$' + (i + 1)).join(', ');", `      const rows = await sql.unsafe('insert into ${ident} (' + cols + ') values (' + params + ') returning *', keys.map((k) => input[k]));`, `      return ${rowName}.parse(rows[0]);`, "    }),");
+        }
+        lines.push("  };", "  return os.router(procedures);", "}");
+        const names = table.kind === "table" ? `${rowName}, ${insertName}` : rowName;
+        return {
+            imports: [
+                { from: "@orpc/server", names: ["os"] },
+                { from: `${importPath}/${table.name}.mjs`, names: [names] },
+            ],
+            body: lines.join("\n"),
+            exportName: exportNameFor(table),
+        };
+    }
+    renderTypes(table, _snapshot, _opts) {
+        const name = exportNameFor(table);
+        return [
+            "// Generated by supawatch. Do not edit.",
+            `export declare function ${name}(sql: { unsafe(text: string, params?: unknown[]): Promise<any[]> }): any;`,
+            "",
+        ].join("\n");
+    }
+}
+export default OrpcTarget;

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@supawatch/target-orpc",
+  "version": "0.5.0",
+  "description": "oRPC routers generated from live Postgres by supawatch, input-validated by the generated Zod schemas.",
+  "keywords": [
+    "supabase",
+    "postgres",
+    "postgresql",
+    "codegen",
+    "schema",
+    "typescript",
+    "orpc",
+    "router",
+    "api"
+  ],
+  "license": "MIT",
+  "author": "Omar Dulaimi",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/omar-dulaimi/supawatch.git",
+    "directory": "packages/target-orpc"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@supawatch/core": "0.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.1",
+    "typescript": "^5.9.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  }
+}