@carlos-tzin/tzin 0.1.0 → 0.1.2

package/README.md

@@ -11,7 +11,13 @@
 measured (see [Benchmarks](#benchmarks)), but this is not yet production software.
 
 ```sh
-npm install tzin
+npm install @carlos-tzin/tzin
+```
+
+Or scaffold a new project:
+
+```sh
+npx create-tzin my-app
 ```
 
 ## Why another framework?
@@ -29,8 +35,8 @@ The TypeScript backend landscape is crowded — and still leaves real gaps:
 tzin's answer: **declare a contract once**, get everything else for free.
 
 ```ts
-import { t } from 'tzin'
-import { contract, impl, createApp } from 'tzin'
+import { t } from '@carlos-tzin/tzin'
+import { contract, impl, createApp } from '@carlos-tzin/tzin'
 
 const getUser = contract({
   method: 'GET',
@@ -146,7 +152,7 @@ contracts that generate your OpenAPI document also expose your endpoints as tool
 for AI agents:
 
 ```ts
-import { startStdioMcp } from 'tzin'
+import { startStdioMcp } from '@carlos-tzin/tzin'
 
 const app = createApp(routes)
 startStdioMcp(app) // newline-delimited JSON-RPC on stdio
@@ -184,7 +190,7 @@ Phoenix-style channels, mounted as ordinary routes — SSE down, POST up, so it
 runs on every runtime including Workers:
 
 ```ts
-import { Hub, Presence, channelRoutes } from 'tzin'
+import { Hub, Presence, channelRoutes } from '@carlos-tzin/tzin'
 
 const hub = new Hub()
 const presence = new Presence(hub, 30_000)
@@ -201,7 +207,7 @@ ghost clients disappear even after crashes. The in-memory `Hub` is one process;
 multi-node deployments wire hubs together over a message bus:
 
 ```ts
-import { Hub } from 'tzin'
+import { Hub } from '@carlos-tzin/tzin'
 import { LocalBus, type MessageBus } from 'tzin/bus'
 
 // Any PUBLISH/SUBSCRIBE transport maps onto this 2-method interface:
@@ -252,8 +258,8 @@ exactly like Node/Bun (workerd drops sends that come from another request's
 context, which is why plain fetch handlers can't relay between sockets):
 
 ```ts
-import { toDurableWorker, toWorker, TzinChannels } from 'tzin'
-import { Hub, Presence, channelRoutes, wsChannels, createApp } from 'tzin'
+import { toDurableWorker, toWorker, TzinChannels } from '@carlos-tzin/tzin'
+import { Hub, Presence, channelRoutes, wsChannels, createApp } from '@carlos-tzin/tzin'
 
 export { TzinChannels } // workerd discovers DO classes among exports
 
@@ -289,22 +295,6 @@ HTTP ✓, WS upgrade ✓, roster ✓, broadcast across connections ✓, leave di
   Request-scoped middleware can override. No decorators, no reflection, no
   container configuration files.
 
-## Roadmap
-
-- [x] Spike: contracts, router, server, typed client, OpenAPI generation
-- [x] Middleware composition (onion-style) with typed per-request context
-- [x] Adapters: Node, Bun (verified e2e), Workers (HTTP + DO-backed WebSockets, verified via miniflare/workerd)
-- [x] Streaming/SSE (`sse()` helper + `raw()` escape hatch)
-- [x] Realtime: Hub (pub/sub), Presence (TTL + diffs), mountable channel routes
-- [x] Native WebSockets for channels: Node + Bun verified, Workers via Durable Objects
-- [x] Multi-node realtime over a `MessageBus` (Redis/Postgres/Durable Objects map onto it)
-- [x] Typed client with status-discriminated unions + zero-dep browser channel client
-- [x] Optional light DI layer (`provide()` → typed singleton seeds in request context)
-- [x] AI-native toolchain: MCP (stdio + Streamable HTTP), OpenAPI 3.1, `/llms.txt`
-- [x] Batteries started: CORS middleware, bearer-auth pattern (see `examples/todo-api.ts`)
-- [ ] Phoenix-style presence replication across nodes
-- [ ] `create-tzin` scaffolding
-
 ## Development
 
 ```sh
@@ -313,20 +303,6 @@ npm test          # vitest — runtime + end-to-end client + type assertions
 npm run typecheck # strict tsc across src/test/bench fixtures
 ```
 
-### Production-shaped example
-
-`examples/todo-api.ts` is the full story in one runnable file: bearer-token auth
-as onion middleware, typed context DI between middleware and handlers,
-app-scoped injected store, ownership checks, query coercion, and the generated
-`/openapi.json` + `/llms.txt` + `POST /mcp` surface from the same contracts.
-
-```sh
-npx tsx examples/todo-api.ts
-TOKEN=$(curl -s localhost:4644/auth/login -H 'content-type: application/json' \
-  -d '{"username":"ada","password":"lovelace"}' | node -pe 'JSON.parse(require("fs").readFileSync(0)).token')
-curl -s localhost:4644/todos -H "authorization: Bearer $TOKEN"
-```
-
 ### Dev server
 
 ```sh
@@ -343,6 +319,17 @@ tzin dev · 2 routes
   POST    /users            create_user
 ```
 
+### Examples
+
+| Example | Runtime | What it shows |
+|---|---|---|
+| `examples/node-demo.ts` | Node | Minimal HTTP server with contracts |
+| `examples/bun-demo.ts` | Bun | Bun.serve with validation |
+| `examples/todo-api.ts` | Node | Full CRUD: auth middleware, DI, OpenAPI, MCP |
+| `examples/mcp-demo.ts` | Node | MCP server over stdio |
+| `examples/ws-demo.ts` | Bun | WebSocket channels with presence |
+| `examples/worker-channels.ts` | Workers | Cloudflare DO-backed channels |
+
 ## License
 
 MIT — see [LICENSE](./LICENSE).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlos-tzin/tzin",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Contract-first TypeScript framework. Types that scale, realtime channels with presence, and an MCP server for every API.",
   "license": "MIT",
   "author": "The tzin authors",