@carlos-tzin/tzin 1.0.2 → 1.0.4

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## 1.0.4 — Node 20 compatibility fix
+
+No API changes. CI was failing on the Node 20 floor because the WS test and the
+Workers probe relied on the global `WebSocket`, which only exists on Node ≥22.
+
+### Testing & coverage
+
+- `native websockets` test and the Workers probe use the `ws` package client
+  instead of the global `WebSocket`, keeping the Node 20 floor green
+
+No API changes. Focused on proving the stable claim in CI and on the
+type surface.
+
+### Testing & coverage
+
+- Unit suites for `cache.ts` and `rate-limit.ts` (30 tests) — previously the
+  only modules without direct coverage
+- Coverage gates in CI: `npm run test:coverage` requires ≥70% lines, functions,
+  statements and branches across `src/` (baseline 73.6%)
+- `vitest.config.ts` with the v8 provider; `coverage/` git-ignored
+
+### CI matrix
+
+- Node `20 / 22 / 24` — previously only 22 and 24; Node 20 is the documented
+  floor and is now exercised
+- Cloudflare Workers probe (`miniflare`) runs on every push, not just releases
+- Benchmark job (`lookup`, `pipeline`, `http`) runs in CI with minimal rounds
+  to catch runtime regressions early
+
+### Type-surface cleanup
+
+- Public `RouteImpl<any>` occurrences replaced by the new erasable
+  `AnyRoute` type — `createApp`, MCP tools, OpenAPI, llms.txt, channels and
+  route-table printing now take `AnyRoute[]` while `impl()` keeps full
+  per-endpoint typing
+- Browser client callbacks (`on`) and internal `any` returns typed as
+  `unknown`; `client()` proxy input uses a typed `ClientInput`
+- New exports: `AnyRoute`, `RouteResult`
+
 ## 1.0.1 — Repo moved to Tzinny-dev
 
 Metadata-only release after the source repository moved from

package/README.md

@@ -9,8 +9,9 @@
 [![npm](https://img.shields.io/npm/v/@carlos-tzin/tzin)](https://www.npmjs.com/package/@carlos-tzin/tzin)
 [![Donate](https://img.shields.io/badge/Donate-PayPal-00457C?logo=paypal&logoColor=white)](https://paypal.me/carlostzin)
 
-**Status: experimental, pre-1.0.** The core works end-to-end and the scaling thesis is
-measured (see [Benchmarks](#benchmarks)), but this is not yet production software.
+**Status: stable (1.0.x).** The core works end-to-end (see [Benchmarks](#benchmarks));
+1.0.0 shipped the stable API, and 1.0.2 adds test coverage gates, a wider CI
+matrix and a public type-clean surface.
 
 ```sh
 npm install @carlos-tzin/tzin

package/dist/channels.d.ts

@@ -1,4 +1,4 @@
-import { type RouteImpl } from './contract.js';
+import { type AnyRoute } from './contract.js';
 import type { Hub } from './hub.js';
 import type { Presence } from './presence.js';
 export interface ChannelOptions {
@@ -11,4 +11,4 @@ export interface ChannelOptions {
  *   POST /channels/:topic/heartbeat  presence join/refresh { member, meta? }
  *   POST /channels/:topic/leave      presence leave { member }
  */
-export declare function channelRoutes(hub: Hub, options?: ChannelOptions): RouteImpl<any>[];
+export declare function channelRoutes(hub: Hub, options?: ChannelOptions): AnyRoute[];

package/dist/client-browser.d.ts

@@ -33,7 +33,7 @@ export type Unsubscribe = () => void;
 export interface Channel {
     readonly topic: string;
     /** Listen to a named event; returns an unsubscribe function. */
-    on(event: string, cb: (data: any) => void): Unsubscribe;
+    on(event: string, cb: (data: unknown) => void): Unsubscribe;
     /** Broadcast to every subscriber of this channel. */
     push(event: string, data?: unknown): Promise<{
         delivered: number;

package/dist/contract.d.ts

@@ -62,6 +62,23 @@ export interface RouteImpl<C extends AnyContract = AnyContract> {
 }
 /** Bind an implementation to a contract. The compiler checks inputs AND outputs. */
 export declare function impl<const C extends AnyContract>(c: C, handler: Handler<C>): RouteImpl<C>;
+/** A handler's resolved reply with the per-endpoint generics erased. */
+export type RouteResult = {
+    status: number;
+    body: unknown;
+} | RawResult;
+/**
+ * A route with its contract generics erased, for heterogeneous registries —
+ * `createApp`, OpenAPI/MCP/llms generators, docs tools. Each concrete
+ * `RouteImpl<C>` satisfies it (impl keeps inputs/outputs fully typed); the
+ * erased handler is only invoked by dispatchers, which supply validated
+ * sections via a cast (the `never` input makes accidental direct calls a
+ * compile error).
+ */
+export interface AnyRoute {
+    contract: AnyContract;
+    handler: (input: never) => RouteResult | Promise<RouteResult>;
+}
 /** Thrown inside handlers -> converted to an HTTP error response. */
 export declare class HttpError extends Error {
     readonly status: number;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { contract, impl, HttpError, type HttpMethod, type ContractDef, type AnyContract, type PathParamNames, type HandlerInput, type SectionsOf, type ResponseOf, type Handler, type RouteImpl, } from './contract.js';
+export { contract, impl, HttpError, type HttpMethod, type ContractDef, type AnyContract, type PathParamNames, type HandlerInput, type SectionsOf, type ResponseOf, type Handler, type RouteImpl, type AnyRoute, type RouteResult, } from './contract.js';
 export { createApp, type App } from './server.js';
 export { client, type ClientOf, type ClientResult, type CallerFn } from './client.js';
 export { generateOpenApi } from './openapi.js';

package/dist/llms.d.ts

@@ -1,10 +1,10 @@
-import type { RouteImpl } from './contract.js';
+import type { AnyRoute } from './contract.js';
 export interface ApiMeta {
     title?: string;
     description?: string;
     version?: string;
 }
 /** llms.txt: the discoverable, human-readable index of the API. */
-export declare function renderLlmsTxt(routes: RouteImpl<any>[], meta?: ApiMeta): string;
+export declare function renderLlmsTxt(routes: AnyRoute[], meta?: ApiMeta): string;
 /** llms-full.txt: same index plus each endpoint's declared JSON Schemas. */
-export declare function renderLlmsFullTxt(routes: RouteImpl<any>[], meta?: ApiMeta): string;
+export declare function renderLlmsFullTxt(routes: AnyRoute[], meta?: ApiMeta): string;

package/dist/llms.js

@@ -32,8 +32,9 @@ export function renderLlmsFullTxt(routes, meta = {}) {
             ...(c.description ? [`${c.description}`, ''] : []),
         ];
         for (const section of ['params', 'query', 'headers', 'cookies', 'body']) {
-            if (section in c && c[section]) {
-                lines.push(`\`${section}\` schema:`, '', '```json', JSON.stringify(c[section]), '```', '');
+            const schema = c[section];
+            if (schema) {
+                lines.push(`\`${section}\` schema:`, '', '```json', JSON.stringify(schema), '```', '');
             }
         }
         for (const [status, schema] of Object.entries(c.responses)) {

package/dist/mcp.d.ts

@@ -1,12 +1,12 @@
 import type { App } from './server.js';
-import type { RouteImpl } from './contract.js';
+import type { AnyRoute } from './contract.js';
 /**
  * One endpoint = one MCP tool.
  * The inputSchema is assembled from the contract's declared sections —
  * TypeBox schemas are already JSON Schema, so there is no conversion layer.
  */
-export declare function toTool(route: RouteImpl<any>): Record<string, unknown>;
-export declare function listTools(routes: RouteImpl<any>[]): Record<string, unknown>[];
+export declare function toTool(route: AnyRoute): Record<string, unknown>;
+export declare function listTools(routes: AnyRoute[]): Record<string, unknown>[];
 export interface RpcRequest {
     jsonrpc?: string;
     id?: string | number | null;

package/dist/openapi.d.ts

@@ -1,9 +1,9 @@
-import type { RouteImpl } from './contract.js';
+import type { AnyRoute } from './contract.js';
 /**
  * OpenAPI 3.1 document generated from contracts.
  * Zero conversion layer: TypeBox == JSON Schema == OpenAPI component vocabulary.
  */
-export declare function generateOpenApi(routes: RouteImpl<any>[], info?: {
+export declare function generateOpenApi(routes: AnyRoute[], info?: {
     title: string;
     version: string;
 }): Record<string, unknown>;

package/dist/server.d.ts

@@ -1,9 +1,9 @@
-import { type RouteImpl } from './contract.js';
+import { type AnyRoute } from './contract.js';
 import { type Middleware } from './middleware.js';
 import type { ProvidedEntry } from './provide.js';
 import { type ApiMeta } from './llms.js';
 export interface App {
-    routes: RouteImpl<any>[];
+    routes: AnyRoute[];
     fetch(req: Request): Promise<Response>;
     /**
      * Same dispatch as fetch(), without constructing undici Responses for
@@ -42,4 +42,4 @@ export declare function fastResponseHeaders(res: Response): Record<string, strin
  * stay lazy; real Request objects carry a plain signal.
  */
 export declare function signalSource(req: Request): AbortSignal | (() => AbortSignal | undefined) | undefined;
-export declare function createApp(routes: RouteImpl<any>[], options?: AppOptions): App;
+export declare function createApp(routes: AnyRoute[], options?: AppOptions): App;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlos-tzin/tzin",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "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",
@@ -85,6 +85,7 @@
     "build": "tsc -p tsconfig.build.json",
     "prepublishOnly": "npm run build && npm test",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
     "typecheck:ours": "tsc -p bench/tsconfig.ours.json --noEmit --extendedDiagnostics",
     "typecheck:hono": "tsc -p bench/tsconfig.hono.json --noEmit --extendedDiagnostics",
@@ -103,7 +104,9 @@
     "@hono/node-server": "^2.1.1",
     "@types/node": "^26.2.0",
     "@types/ws": "^8.18.1",
+    "@vitest/coverage-v8": "^2.1.9",
     "autocannon": "^8.0.0",
+    "esbuild": "^0.28.0",
     "express": "^5.2.1",
     "hono": "^4.0.0",
     "miniflare": "^5.20260820.0-alpha",