create-katajs 0.1.0

package/dist/templates/monorepo/apps/api/wrangler.jsonc

@@ -0,0 +1,34 @@
+{
+  "$schema": "node_modules/wrangler/config-schema.json",
+  "name": "{{PROJECT_NAME}}",
+  "main": "src/index.ts",
+  "compatibility_date": "{{TODAY_ISO}}",
+  "compatibility_flags": ["nodejs_compat"],
+  "observability": { "enabled": true },
+  "hyperdrive": [
+    {
+      "binding": "HYPERDRIVE",
+      "id": "<your-hyperdrive-id>",
+      "localConnectionString": "postgres://postgres:postgres@localhost:5432/{{PROJECT_NAME}}_dev"
+    }
+  ]
+
+  // Cloudflare Queues bindings. Uncomment + adjust when a module in this app
+  // declares a `consumer:` field (see docs/concepts/queues.md).
+  //
+  // "queues": {
+  //   "producers": [
+  //     { "binding": "ORDER_QUEUE", "queue": "orders" },
+  //     { "binding": "ORDER_DLQ",   "queue": "orders-dlq" }
+  //   ],
+  //   "consumers": [
+  //     {
+  //       "queue": "orders",
+  //       "max_batch_size": 100,
+  //       "max_batch_timeout": 30,
+  //       "max_retries": 3,
+  //       "dead_letter_queue": "orders-dlq"
+  //     }
+  //   ]
+  // }
+}

package/dist/templates/monorepo/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "turbo run dev",
+    "test": "turbo run test",
+    "typecheck": "turbo run typecheck",
+    "deploy": "pnpm --filter @{{PROJECT_NAME}}/api deploy",
+    "db:generate": "pnpm --filter @{{PROJECT_NAME}}/db db:generate",
+    "db:migrate": "pnpm --filter @{{PROJECT_NAME}}/db db:migrate",
+    "graph": "pnpm --filter @{{PROJECT_NAME}}/api graph"
+  },
+  "devDependencies": {
+    "turbo": "^2.3.0",
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=20",
+    "pnpm": ">=9"
+  },
+  "packageManager": "pnpm@9.12.3"
+}

package/dist/templates/monorepo/packages/api-client/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@{{PROJECT_NAME}}/api-client",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "hono": "^4.6.10"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  }
+}

package/dist/templates/monorepo/packages/api-client/src/index.ts

@@ -0,0 +1,43 @@
+/**
+ * Typed Hono RPC client factory.
+ *
+ * Generic over the API's `AppType` so this package has zero workspace deps —
+ * it doesn't try to resolve types from `apps/api`, which would force a
+ * cross-package typecheck of the entire API source. The consumer provides
+ * the type:
+ *
+ *   import { createApiClient } from '@{{PROJECT_NAME}}/api-client';
+ *   import type { AppType } from '@{{PROJECT_NAME}}/api';
+ *
+ *   const api = createApiClient<AppType>('https://api.example.com');
+ *   const res = await api.posts.$post({ json: { title: 't', body: 'b' } });
+ *   const data = await res.json();   // typed end-to-end
+ *
+ * This package is the place to evolve cross-cutting client concerns over time
+ * — auth header injection, retry policy, error response parsing, request
+ * tracing, mock clients for testing.
+ */
+import { hc } from 'hono/client';
+import type { Hono } from 'hono';
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type AnyHono = Hono<any, any, any>;
+
+export type ApiClient<App extends AnyHono> = ReturnType<typeof hc<App>>;
+
+export type ApiClientOptions = {
+  /** Optional headers merged into every request (e.g. Authorization). */
+  headers?: Record<string, string>;
+  /** Custom fetch implementation (e.g. for testing). Defaults to global `fetch`. */
+  fetch?: typeof fetch;
+};
+
+export function createApiClient<App extends AnyHono>(
+  baseUrl: string,
+  options: ApiClientOptions = {},
+): ApiClient<App> {
+  return hc<App>(baseUrl, {
+    headers: options.headers,
+    fetch: options.fetch,
+  });
+}

package/dist/templates/monorepo/packages/api-client/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "include": ["src/**/*"]
+}

package/dist/templates/monorepo/packages/db/drizzle.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from 'drizzle-kit';
+
+export default defineConfig({
+  dialect: 'postgresql',
+  schema: './src/schema.ts',
+  out: './migrations',
+  dbCredentials: {
+    url: process.env.DATABASE_URL ?? 'postgres://postgres:postgres@localhost:5432/{{PROJECT_NAME}}',
+  },
+  strict: true,
+  verbose: true,
+});

package/dist/templates/monorepo/packages/db/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@{{PROJECT_NAME}}/db",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./schema": "./src/schema.ts"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate"
+  },
+  "dependencies": {
+    "drizzle-orm": "^0.36.4",
+    "pg": "^8.13.1"
+  },
+  "devDependencies": {
+    "@types/pg": "^8.11.10",
+    "drizzle-kit": "^0.28.1",
+    "typescript": "^5.6.3"
+  }
+}

package/dist/templates/monorepo/packages/db/src/index.ts

@@ -0,0 +1,13 @@
+/**
+ * Public surface of @{{PROJECT_NAME}}/db.
+ *
+ * Workspace consumers import schema tables and types from here:
+ *
+ *   import * as schema from '@{{PROJECT_NAME}}/db';
+ *   import { posts, type Post, type NewPost } from '@{{PROJECT_NAME}}/db';
+ *
+ * Or pull just the schema namespace:
+ *
+ *   import * as schema from '@{{PROJECT_NAME}}/db/schema';
+ */
+export * from './schema';

package/dist/templates/monorepo/packages/db/src/schema.ts

@@ -0,0 +1,12 @@
+import { pgTable, text, timestamp, uuid } from 'drizzle-orm/pg-core';
+
+export const posts = pgTable('posts', {
+  id: uuid('id').primaryKey().defaultRandom(),
+  title: text('title').notNull(),
+  body: text('body').notNull(),
+  authorId: text('author_id').notNull(),
+  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+});
+
+export type Post = typeof posts.$inferSelect;
+export type NewPost = typeof posts.$inferInsert;

package/dist/templates/monorepo/packages/db/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "include": ["src/**/*", "drizzle.config.ts"]
+}

package/dist/templates/monorepo/pnpm-workspace.yaml

@@ -0,0 +1,3 @@
+packages:
+  - 'apps/*'
+  - 'packages/*'

package/dist/templates/monorepo/tsconfig.base.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "noUncheckedIndexedAccess": true,
+    "allowSyntheticDefaultImports": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": false,
+    "noEmit": true
+  }
+}

package/dist/templates/monorepo/turbo.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://turbo.build/schema.json",
+  "tasks": {
+    "dev": {
+      "persistent": true,
+      "cache": false
+    },
+    "test": {
+      "outputs": []
+    },
+    "typecheck": {
+      "outputs": []
+    },
+    "deploy": {
+      "cache": false,
+      "outputs": []
+    }
+  }
+}

package/dist/templates/monorepo-worker/apps/worker/_dev.vars.example

@@ -0,0 +1,4 @@
+# Local-only secrets for `wrangler dev` (queue worker). Copy this file to
+# `.dev.vars` and fill in real values. The `.dev.vars` file is gitignored.
+
+DATABASE_URL="postgres://postgres:postgres@localhost:5432/{{PROJECT_NAME}}_dev"

package/dist/templates/monorepo-worker/apps/worker/_gitignore

@@ -0,0 +1,6 @@
+node_modules/
+dist/
+.wrangler/
+.dev.vars
+.turbo/
+*.tsbuildinfo

package/dist/templates/monorepo-worker/apps/worker/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@{{PROJECT_NAME}}/{{WORKER_NAME}}",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "wrangler dev",
+    "deploy": "wrangler deploy",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@{{PROJECT_NAME}}/db": "workspace:*",
+    "@hono/zod-validator": "^0.4.1",
+    "@katajs/core": "^0.1.0",
+    "@katajs/drizzle": "^0.1.0",
+    "drizzle-orm": "^0.36.4",
+    "hono": "^4.6.10",
+    "pg": "^8.13.1",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20241112.0",
+    "@katajs/cli": "^0.1.0",
+    "@types/node": "^22.9.0",
+    "@types/pg": "^8.11.10",
+    "typescript": "^5.6.3",
+    "wrangler": "^3.86.0"
+  }
+}

package/dist/templates/monorepo-worker/apps/worker/src/app.ts

@@ -0,0 +1,27 @@
+import { createApp } from '@katajs/core';
+import { drizzleAdapter } from '@katajs/drizzle';
+import * as schema from '@{{PROJECT_NAME}}/db';
+
+import { exampleConsumerModule } from './modules/example-consumer/index';
+// katajs:module-imports
+
+export type Bindings = {
+  HYPERDRIVE: Hyperdrive;
+};
+
+const { queue } = createApp({
+  bindings: {} as Bindings,
+  db: drizzleAdapter({ schema }),
+  modules: [
+    exampleConsumerModule,
+    // katajs:modules
+  ],
+  queueErrorMapper: {
+    onUnhandled: (_err, _ctx) => {
+      // Real apps ship to Sentry/Logflare/etc. here.
+    },
+  },
+  // No routes — this Worker has no HTTP surface.
+});
+
+export { queue };

package/dist/templates/monorepo-worker/apps/worker/src/index.ts

@@ -0,0 +1,6 @@
+import { queue } from './app';
+
+// Worker default export. This Worker is queue-only — no `fetch` handler.
+// Cloudflare invokes `queue` for each message batch delivered to a queue
+// listed in this Worker's `queues.consumers` block in wrangler.jsonc.
+export default { queue };

package/dist/templates/monorepo-worker/apps/worker/src/modules/example-consumer/example.consumer.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { defineConsumer } from '@katajs/core';
+
+/**
+ * Message body schema for the example queue. Replace this with the schema
+ * your producer (in apps/api) actually sends. If you want the producer and
+ * consumer to share the schema definition, extract it into a small shared
+ * package (e.g. `packages/events/`) and import from there.
+ */
+export const ExampleEventSchema = z.object({
+  id: z.string().uuid(),
+  payload: z.unknown(),
+});
+export type ExampleEvent = z.infer<typeof ExampleEventSchema>;
+
+export const exampleConsumer = defineConsumer({
+  queue: 'EXAMPLE_QUEUE',
+  schema: ExampleEventSchema,
+  async handle(message, c) {
+    const service = c.resolve('exampleService');
+    await service.process(message.body);
+  },
+});

package/dist/templates/monorepo-worker/apps/worker/src/modules/example-consumer/example.service.ts

@@ -0,0 +1,18 @@
+import type { RequestContainer } from '@katajs/core';
+import type { ExampleEvent } from './example.consumer';
+
+export type ExampleService = {
+  process(event: ExampleEvent): Promise<void>;
+};
+
+export function makeExampleService(_c: RequestContainer): ExampleService {
+  return {
+    async process(event) {
+      // TODO: implement message processing.
+      // Reach `_c.db` for database access (the Drizzle client is shared with
+      // apps/api via `packages/db`). Reach `_c.resolve('otherService')` for
+      // services from other modules in this worker's `modules:` array.
+      void event;
+    },
+  };
+}

package/dist/templates/monorepo-worker/apps/worker/src/modules/example-consumer/index.ts

@@ -0,0 +1,24 @@
+import { defineModule } from '@katajs/core';
+import { makeExampleService, type ExampleService } from './example.service';
+// katajs:module-service-imports
+import { exampleConsumer } from './example.consumer';
+
+export const exampleConsumerModule = defineModule({
+  name: 'example-consumer',
+  provides: {
+    exampleService: (c): ExampleService => makeExampleService(c),
+    // katajs:module-provides
+  },
+  requires: [] as const,
+  consumer: exampleConsumer,
+  // katajs:module-consumer
+});
+
+/** Services this module contributes to the container's `Registry`. */
+export type ExampleConsumerRegistry = {
+  exampleService: ExampleService;
+  // katajs:module-registry
+};
+
+export type { ExampleService };
+export { ExampleEventSchema, type ExampleEvent } from './example.consumer';

package/dist/templates/monorepo-worker/apps/worker/src/types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Module augmentations for `@katajs/core`. Picked up automatically by
+ * tsconfig's `include` glob — no runtime import needed.
+ */
+import type { DrizzleClient } from '@katajs/drizzle';
+import type * as schema from '@{{PROJECT_NAME}}/db';
+import type { Bindings } from './app';
+
+import type { ExampleConsumerRegistry } from './modules/example-consumer/index';
+// katajs:registry-imports
+
+declare module '@katajs/core' {
+  interface AppDb extends DrizzleClient<typeof schema> {}
+  interface AppEnv extends Bindings {}
+  interface Registry
+    extends ExampleConsumerRegistry
+    // katajs:registry
+  {}
+}

package/dist/templates/monorepo-worker/apps/worker/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "types": ["@cloudflare/workers-types", "node"]
+  },
+  "include": ["src/**/*"]
+}

package/dist/templates/monorepo-worker/apps/worker/wrangler.jsonc

@@ -0,0 +1,28 @@
+{
+  "$schema": "node_modules/wrangler/config-schema.json",
+  "name": "{{PROJECT_NAME}}-{{WORKER_NAME}}",
+  "main": "src/index.ts",
+  "compatibility_date": "{{TODAY_ISO}}",
+  "compatibility_flags": ["nodejs_compat"],
+  "observability": { "enabled": true },
+  "hyperdrive": [
+    {
+      "binding": "HYPERDRIVE",
+      "id": "<your-hyperdrive-id>",
+      "localConnectionString": "postgres://postgres:postgres@localhost:5432/{{PROJECT_NAME}}_dev"
+    }
+  ],
+
+  // Queue consumer bindings. The producer side lives in apps/api/wrangler.jsonc.
+  // Add one entry per queue this worker consumes.
+  "queues": {
+    "consumers": [
+      {
+        "queue": "example-events",
+        "max_batch_size": 100,
+        "max_batch_timeout": 30,
+        "max_retries": 3
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "create-katajs",
+  "version": "0.1.0",
+  "description": "Scaffolding CLI for katajs projects.",
+  "keywords": [
+    "katajs",
+    "create",
+    "scaffold",
+    "cli",
+    "hono",
+    "cloudflare",
+    "workers"
+  ],
+  "license": "MIT",
+  "author": "Yaseer A. Okino <yaseerokino@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ookino/katajs.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/ookino/katajs/tree/main/packages/cli#readme",
+  "bugs": {
+    "url": "https://github.com/ookino/katajs/issues"
+  },
+  "type": "module",
+  "bin": {
+    "create-katajs": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^0.8.2",
+    "cac": "^6.7.14",
+    "kolorist": "^1.8.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit"
+  }
+}