alepha 0.15.2 → 0.15.3

package/README.md

@@ -1,116 +1,104 @@
 <div align="center">
-<h1 >
+<h1>
 <img
-	src="https://raw.githubusercontent.com/feunard/alepha/main/apps/docs/public/icon-512.png"
-	width="128"
-	height="128"
-	alt="Logo"
+  src="https://raw.githubusercontent.com/feunard/alepha/main/apps/docs/public/icon-512.png"
+  width="128"
+  height="128"
+  alt="Alepha logo"
   valign="middle"
 />
 Alepha
 </h1>
-<p style="max-width: 512px">
-Easy mode for building TypeScript applications.
-</p>
-<a href="https://www.npmjs.com/package/alepha"><img src="https://img.shields.io/npm/v/alepha.svg" alt="npm"/></a>
-<a href="https://www.npmjs.com/package/alepha"><img src="https://img.shields.io/npm/l/alepha.svg" alt="npm"/></a>
-<a href="https://codecov.io/gh/feunard/alepha"><img src="https://codecov.io/gh/feunard/alepha/graph/badge.svg?token=ZDLWI514CP" alt="npm"/></a>
-<a href="https://www.npmjs.com/package/alepha"><img src="https://img.shields.io/npm/dt/alepha.svg" alt="npm"/></a>
-<a href="https://github.com/feunard/alepha"><img src="https://img.shields.io/github/stars/feunard/alepha.svg?style=social" alt="GitHub stars"/></a>
+<p>TypeScript Framework Made Easy</p>
+<a href="https://www.npmjs.com/package/alepha"><img src="https://img.shields.io/npm/v/alepha.svg" alt="npm version"/></a>
+<a href="https://www.npmjs.com/package/alepha"><img src="https://img.shields.io/npm/l/alepha.svg" alt="license"/></a>
+<a href="https://codecov.io/gh/feunard/alepha"><img src="https://codecov.io/gh/feunard/alepha/graph/badge.svg?token=ZDLWI514CP" alt="coverage"/></a>
+<a href="https://www.npmjs.com/package/alepha"><img src="https://img.shields.io/npm/dt/alepha.svg" alt="downloads"/></a>
 </div>
 
 ## What is this?
 
-A full-stack TypeScript framework for building APIs, React apps with SSR, CLI tools, and more.
+Full-stack TypeScript framework. Node.js and Bun, same code.
 
-- **Runs on Node.js and Bun** — switch runtimes without changing code
-- **Zero config** — sensible defaults, override when needed
-- **Type-safe everything** — schemas validate at runtime, TypeScript catches the rest
-- **Single bundle deploy** — no `node_modules` in production
+You define your API with `$action`, your DB with `$entity`, jobs with `$queue`.
+One schema handles database, validation, and TypeScript types.
+The client gets full autocomplete without codegen.
+Testing? Swap services with `.with()`, no mocking.
+Deploy anywhere — Cloudflare, Vercel, Docker, bare metal.
 
-Check out the [documentation](https://alepha.dev) for the full picture.
+## Example
 
-## Quick Start
-
-**Requirements:** [Node.js](https://nodejs.org/) v22+ or [Bun](https://bun.sh/)
-
-### API Server
-
-```bash
-npx alepha init my-api
-cd my-api
-```
-
-Edit `src/api/controllers/HelloController.ts`:
-
-```ts
+```tsx
+// src/Api.ts
 import { t } from "alepha";
 import { $action } from "alepha/server";
-import { $swagger } from "alepha/server/swagger";
-
-export class HelloController {
-  docs = $swagger();
-
-  hello = $action({
-    path: "/hello",
-    schema: {
-      query: t.object({
-        name: t.optional(t.text()),
-      }),
-      response: t.object({
-        message: t.text(),
-      }),
+import { $entity, $repository, db } from "alepha/orm";
+
+const viewEntity = $entity({
+  name: "views",
+  schema: t.object({
+    id: db.primaryKey(),
+    createdAt: db.createdAt(),
+  }),
+});
+
+export class Api {
+  views = $repository(viewEntity);
+
+  inc = $action({
+    schema: { response: t.object({ count: t.number() }) },  // ← validates + generates OpenAPI
+    handler: async () => {
+      await this.views.create({});
+      return { count: await this.views.count() };
     },
-    handler: ({ query }) => ({
-      message: `Hello, ${query.name || "World"}!`,
-    }),
   });
 }
 ```
 
-```bash
-npm run dev
-# Open http://localhost:3000/docs/ for auto-generated API docs
-```
+```tsx
+// src/AppRouter.tsx
+import { $client } from "alepha/server/links";
+import { $page } from "alepha/react/router";
+import type { Api } from "./Api.ts";
 
-Build and run in production:
+export class AppRouter {
+  api = $client<Api>();  // ← fully typed, zero codegen
 
-```bash
-npm run build
-node dist  # or: bun dist
+  home = $page({
+    loader: () => this.api.inc(),
+    component: (props) => <div>Counter: {props.count}</div>,
+  });
+}
 ```
 
-### Full-Stack React
+## Getting Started
 
-In same directory, re-initialize with React support:
+Requirements: [Node.js](https://nodejs.org/) 22+ or [Bun](https://bun.sh/) 1.3+
 
 ```bash
-npx alepha init --react
-```
-
-Your `src/main.server.ts` wires everything together:
-
-```ts
-import { Alepha, run } from "alepha";
-import { ApiModule } from "./api/index.ts";
-import { WebModule } from "./web/index.ts";
-
-const alepha = Alepha.create();
-
-alepha.with(ApiModule);  // API endpoints
-alepha.with(WebModule);  // React pages
+npx alepha init my-app --api         # API only
+npx alepha init my-app --react       # With React
+npx alepha init my-app --admin       # Full SaaS starter
+npx alepha init my-app --admin --ai  # + AI assistant context
 
-run(alepha);
+cd my-app && npm run dev
 ```
 
-Start development server:
+## CLI
 
 ```bash
-npm run dev
-# Open http://localhost:3000/
+alepha dev          # Dev server with HMR
+alepha lint         # Format & lint code
+alepha typecheck    # TypeScript check
+alepha test         # Run tests
+alepha build        # Production build
+alepha db generate  # Generate migrations
+alepha db migrate   # Apply migrations
+alepha db studio    # Visual database browser
 ```
 
 ## Learn More
 
-- [Documentation](https://alepha.dev) — guides, concepts, API reference
-- [GitHub](https://github.com/feunard/alepha) — source code and issues
+- [Documentation](https://alepha.dev)
+- [llms.txt](https://alepha.dev/llms.txt) — for AI assistants
+- [GitHub](https://github.com/feunard/alepha)