@korajs/cli 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,72 @@
+import { KoraError, SchemaDefinition } from '@korajs/core';
+
+/** Supported package managers */
+declare const PACKAGE_MANAGERS: readonly ["pnpm", "npm", "yarn", "bun"];
+type PackageManager = (typeof PACKAGE_MANAGERS)[number];
+/** Available project templates */
+declare const TEMPLATES: readonly ["react-basic", "react-sync"];
+type TemplateName = (typeof TEMPLATES)[number];
+/** Metadata for a project template */
+interface TemplateInfo {
+    name: TemplateName;
+    label: string;
+    description: string;
+}
+/** Available templates with their descriptions */
+declare const TEMPLATE_INFO: readonly TemplateInfo[];
+/** Variables available for template substitution */
+interface TemplateContext {
+    projectName: string;
+    packageManager: PackageManager;
+    koraVersion: string;
+}
+
+/**
+ * Base error class for all CLI errors.
+ */
+declare class CliError extends KoraError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Thrown when the target project directory already exists.
+ */
+declare class ProjectExistsError extends KoraError {
+    readonly directory: string;
+    constructor(directory: string);
+}
+/**
+ * Thrown when a schema file cannot be found in the project.
+ */
+declare class SchemaNotFoundError extends KoraError {
+    readonly searchedPaths: string[];
+    constructor(searchedPaths: string[]);
+}
+/**
+ * Thrown when a command is run outside a valid Kora project.
+ */
+declare class InvalidProjectError extends KoraError {
+    readonly directory: string;
+    constructor(directory: string);
+}
+/**
+ * Thrown when a required local dev server binary cannot be found.
+ */
+declare class DevServerError extends KoraError {
+    readonly binary: string;
+    readonly searchPath: string;
+    constructor(binary: string, searchPath: string);
+}
+
+/**
+ * Generates TypeScript interfaces from a SchemaDefinition.
+ * For each collection, produces three interfaces:
+ * - {Name}Record: full record type (all fields + id)
+ * - {Name}InsertInput: insert input (omit auto fields, optional for fields with defaults)
+ * - {Name}UpdateInput: update input (all non-auto fields optional)
+ *
+ * @param schema - A validated SchemaDefinition from defineSchema()
+ * @returns A complete TypeScript file as a string
+ */
+declare function generateTypes(schema: SchemaDefinition): string;
+
+export { CliError, DevServerError, InvalidProjectError, PACKAGE_MANAGERS, type PackageManager, ProjectExistsError, SchemaNotFoundError, TEMPLATES, TEMPLATE_INFO, type TemplateContext, type TemplateInfo, type TemplateName, generateTypes };

package/dist/index.d.ts

@@ -0,0 +1,72 @@
+import { KoraError, SchemaDefinition } from '@korajs/core';
+
+/** Supported package managers */
+declare const PACKAGE_MANAGERS: readonly ["pnpm", "npm", "yarn", "bun"];
+type PackageManager = (typeof PACKAGE_MANAGERS)[number];
+/** Available project templates */
+declare const TEMPLATES: readonly ["react-basic", "react-sync"];
+type TemplateName = (typeof TEMPLATES)[number];
+/** Metadata for a project template */
+interface TemplateInfo {
+    name: TemplateName;
+    label: string;
+    description: string;
+}
+/** Available templates with their descriptions */
+declare const TEMPLATE_INFO: readonly TemplateInfo[];
+/** Variables available for template substitution */
+interface TemplateContext {
+    projectName: string;
+    packageManager: PackageManager;
+    koraVersion: string;
+}
+
+/**
+ * Base error class for all CLI errors.
+ */
+declare class CliError extends KoraError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Thrown when the target project directory already exists.
+ */
+declare class ProjectExistsError extends KoraError {
+    readonly directory: string;
+    constructor(directory: string);
+}
+/**
+ * Thrown when a schema file cannot be found in the project.
+ */
+declare class SchemaNotFoundError extends KoraError {
+    readonly searchedPaths: string[];
+    constructor(searchedPaths: string[]);
+}
+/**
+ * Thrown when a command is run outside a valid Kora project.
+ */
+declare class InvalidProjectError extends KoraError {
+    readonly directory: string;
+    constructor(directory: string);
+}
+/**
+ * Thrown when a required local dev server binary cannot be found.
+ */
+declare class DevServerError extends KoraError {
+    readonly binary: string;
+    readonly searchPath: string;
+    constructor(binary: string, searchPath: string);
+}
+
+/**
+ * Generates TypeScript interfaces from a SchemaDefinition.
+ * For each collection, produces three interfaces:
+ * - {Name}Record: full record type (all fields + id)
+ * - {Name}InsertInput: insert input (omit auto fields, optional for fields with defaults)
+ * - {Name}UpdateInput: update input (all non-auto fields optional)
+ *
+ * @param schema - A validated SchemaDefinition from defineSchema()
+ * @returns A complete TypeScript file as a string
+ */
+declare function generateTypes(schema: SchemaDefinition): string;
+
+export { CliError, DevServerError, InvalidProjectError, PACKAGE_MANAGERS, type PackageManager, ProjectExistsError, SchemaNotFoundError, TEMPLATES, TEMPLATE_INFO, type TemplateContext, type TemplateInfo, type TemplateName, generateTypes };

package/dist/index.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import {
+  generateTypes
+} from "./chunk-N36PFOSA.js";
+import {
+  CliError,
+  DevServerError,
+  InvalidProjectError,
+  PACKAGE_MANAGERS,
+  ProjectExistsError,
+  SchemaNotFoundError,
+  TEMPLATES,
+  TEMPLATE_INFO
+} from "./chunk-ZVB4HAB3.js";
+export {
+  CliError,
+  DevServerError,
+  InvalidProjectError,
+  PACKAGE_MANAGERS,
+  ProjectExistsError,
+  SchemaNotFoundError,
+  TEMPLATES,
+  TEMPLATE_INFO,
+  generateTypes
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@korajs/cli",
+  "version": "0.1.0",
+  "description": "Kora.js CLI tooling and project scaffolding",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "kora": "./dist/bin.js",
+    "create-kora-app": "./dist/create.js"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "dependencies": {
+    "citty": "^0.1.6",
+    "@korajs/core": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "tsup": "^8.3.6",
+    "vitest": "^3.0.4"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src/ tests/",
+    "clean": "rm -rf dist .turbo coverage"
+  }
+}

package/templates/react-basic/index.html.hbs

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{projectName}}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/react-basic/kora.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from 'korajs/config'
+
+export default defineConfig({
+	schema: './src/schema.ts',
+	dev: {
+		port: 5173,
+		watch: {
+			enabled: true,
+			debounceMs: 300,
+		},
+		sync: false,
+	},
+})

package/templates/react-basic/package.json.hbs

@@ -0,0 +1,26 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "kora dev",
+    "build": "tsc && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "korajs": "{{koraVersion}}",
+    "@korajs/react": "{{koraVersion}}",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@korajs/cli": "{{koraVersion}}",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.3.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0"
+  }
+}

package/templates/react-basic/src/App.tsx

@@ -0,0 +1,48 @@
+import { useQuery, useMutation, useCollection } from '@korajs/react'
+
+export function App() {
+  const todos = useCollection('todos')
+  const activeTodos = useQuery(todos.where({ completed: false }))
+  const { mutate: addTodo } = useMutation(
+    (data: { title: string }) => todos.insert(data)
+  )
+  const { mutate: toggleTodo } = useMutation(
+    (id: string, data: { completed: boolean }) => todos.update(id, data)
+  )
+
+  return (
+    <div style={{ maxWidth: 600, margin: '0 auto', padding: 20 }}>
+      <h1>Kora Todo App</h1>
+
+      <form
+        onSubmit={async (e) => {
+          e.preventDefault()
+          const form = e.currentTarget
+          const input = form.elements.namedItem('title') as HTMLInputElement
+          if (input.value.trim()) {
+            addTodo({ title: input.value.trim() })
+            input.value = ''
+          }
+        }}
+      >
+        <input name="title" placeholder="What needs to be done?" />
+        <button type="submit">Add</button>
+      </form>
+
+      <ul>
+        {activeTodos.map((todo) => (
+          <li key={todo.id}>
+            <label>
+              <input
+                type="checkbox"
+                checked={!!todo.completed}
+                onChange={() => toggleTodo(todo.id, { completed: !todo.completed })}
+              />
+              {String(todo.title)}
+            </label>
+          </li>
+        ))}
+      </ul>
+    </div>
+  )
+}

package/templates/react-basic/src/main.tsx

@@ -0,0 +1,16 @@
+import { createApp } from 'korajs'
+import { KoraProvider } from '@korajs/react'
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import schema from './schema'
+import { App } from './App'
+
+const app = createApp({ schema })
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <KoraProvider app={app}>
+      <App />
+    </KoraProvider>
+  </StrictMode>,
+)

package/templates/react-basic/src/schema.ts

@@ -0,0 +1,15 @@
+import { defineSchema, t } from 'korajs'
+
+export default defineSchema({
+  version: 1,
+  collections: {
+    todos: {
+      fields: {
+        title: t.string(),
+        completed: t.boolean().default(false),
+        createdAt: t.timestamp().auto(),
+      },
+      indexes: ['completed'],
+    },
+  },
+})

package/templates/react-basic/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}

package/templates/react-basic/vite.config.ts

@@ -0,0 +1,6 @@
+import react from '@vitejs/plugin-react'
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+  plugins: [react()],
+})

package/templates/react-sync/index.html.hbs

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{projectName}}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/react-sync/kora.config.ts

@@ -0,0 +1,17 @@
+import { defineConfig } from 'korajs/config'
+
+export default defineConfig({
+	schema: './src/schema.ts',
+	dev: {
+		port: 5173,
+		sync: {
+			enabled: true,
+			port: 3001,
+			store: 'memory',
+		},
+		watch: {
+			enabled: true,
+			debounceMs: 300,
+		},
+	},
+})

package/templates/react-sync/package.json.hbs

@@ -0,0 +1,28 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "kora dev",
+    "dev:server": "tsx server.ts",
+    "build": "tsc && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "korajs": "{{koraVersion}}",
+    "@korajs/react": "{{koraVersion}}",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@korajs/cli": "{{koraVersion}}",
+    "@korajs/server": "{{koraVersion}}",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.3.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0"
+  }
+}

package/templates/react-sync/server.ts

@@ -0,0 +1,11 @@
+import { createKoraServer, MemoryServerStore } from '@korajs/server'
+
+const store = new MemoryServerStore()
+const server = createKoraServer({
+  store,
+  port: 3001,
+})
+
+server.start().then(() => {
+  console.log('Kora sync server running on ws://localhost:3001')
+})

package/templates/react-sync/src/App.tsx

@@ -0,0 +1,50 @@
+import { useQuery, useMutation, useSyncStatus, useCollection } from '@korajs/react'
+
+export function App() {
+  const todos = useCollection('todos')
+  const activeTodos = useQuery(todos.where({ completed: false }))
+  const { mutate: addTodo } = useMutation(
+    (data: { title: string }) => todos.insert(data)
+  )
+  const { mutate: toggleTodo } = useMutation(
+    (id: string, data: { completed: boolean }) => todos.update(id, data)
+  )
+  const status = useSyncStatus()
+
+  return (
+    <div style={{ maxWidth: 600, margin: '0 auto', padding: 20 }}>
+      <h1>Kora Todo App</h1>
+      <p>Status: {status.status}</p>
+
+      <form
+        onSubmit={async (e) => {
+          e.preventDefault()
+          const form = e.currentTarget
+          const input = form.elements.namedItem('title') as HTMLInputElement
+          if (input.value.trim()) {
+            addTodo({ title: input.value.trim() })
+            input.value = ''
+          }
+        }}
+      >
+        <input name="title" placeholder="What needs to be done?" />
+        <button type="submit">Add</button>
+      </form>
+
+      <ul>
+        {activeTodos.map((todo) => (
+          <li key={todo.id}>
+            <label>
+              <input
+                type="checkbox"
+                checked={!!todo.completed}
+                onChange={() => toggleTodo(todo.id, { completed: !todo.completed })}
+              />
+              {String(todo.title)}
+            </label>
+          </li>
+        ))}
+      </ul>
+    </div>
+  )
+}

package/templates/react-sync/src/main.tsx

@@ -0,0 +1,24 @@
+import { createApp } from 'korajs'
+import { KoraProvider } from '@korajs/react'
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import schema from './schema'
+import { App } from './App'
+
+const app = createApp({
+  schema,
+  sync: {
+    url: 'ws://localhost:3001',
+  },
+})
+
+// Connect to sync server once the app is ready
+app.ready.then(() => app.sync?.connect())
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <KoraProvider app={app}>
+      <App />
+    </KoraProvider>
+  </StrictMode>,
+)

package/templates/react-sync/src/schema.ts

@@ -0,0 +1,15 @@
+import { defineSchema, t } from 'korajs'
+
+export default defineSchema({
+  version: 1,
+  collections: {
+    todos: {
+      fields: {
+        title: t.string(),
+        completed: t.boolean().default(false),
+        createdAt: t.timestamp().auto(),
+      },
+      indexes: ['completed'],
+    },
+  },
+})

package/templates/react-sync/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}

package/templates/react-sync/vite.config.ts

@@ -0,0 +1,6 @@
+import react from '@vitejs/plugin-react'
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+  plugins: [react()],
+})