@spfn/core 0.2.0-beta.9 → 0.3.0-beta.2

package/package.json

@@ -1,210 +1,246 @@
 {
-  "name": "@spfn/core",
-  "version": "0.2.0-beta.9",
-  "description": "SPFN Framework Core - File-based routing, transactions, repository pattern",
-  "type": "module",
-  "exports": {
-    "./client": {
-      "types": "./dist/client/index.d.ts",
-      "import": "./dist/client/index.js",
-      "require": "./dist/client/index.js"
-    },
-    "./nextjs": {
-      "types": "./dist/nextjs/index.d.ts",
-      "import": "./dist/nextjs/index.js",
-      "require": "./dist/nextjs/index.js"
-    },
-    "./nextjs/server": {
-      "types": "./dist/nextjs/server.d.ts",
-      "import": "./dist/nextjs/server.js",
-      "require": "./dist/nextjs/server.js"
-    },
-    "./route": {
-      "types": "./dist/route/index.d.ts",
-      "import": "./dist/route/index.js",
-      "require": "./dist/route/index.js"
-    },
-    "./route/types": {
-      "types": "./dist/route/types.d.ts",
-      "import": "./dist/route/types.js",
-      "require": "./dist/route/types.js"
-    },
-    "./db": {
-      "types": "./dist/db/index.d.ts",
-      "import": "./dist/db/index.js",
-      "require": "./dist/db/index.js"
-    },
-    "./server": {
-      "types": "./dist/server/index.d.ts",
-      "import": "./dist/server/index.js",
-      "require": "./dist/server/index.js"
-    },
-    "./errors": {
-      "types": "./dist/errors/index.d.ts",
-      "import": "./dist/errors/index.js",
-      "require": "./dist/errors/index.js"
-    },
-    "./middleware": {
-      "types": "./dist/middleware/index.d.ts",
-      "import": "./dist/middleware/index.js",
-      "require": "./dist/middleware/index.js"
-    },
-    "./cache": {
-      "types": "./dist/cache/index.d.ts",
-      "import": "./dist/cache/index.js",
-      "require": "./dist/cache/index.js"
-    },
-    "./codegen": {
-      "types": "./dist/codegen/index.d.ts",
-      "import": "./dist/codegen/index.js",
-      "require": "./dist/codegen/index.js"
-    },
-    "./env": {
-      "types": "./dist/env/index.d.ts",
-      "import": "./dist/env/index.js",
-      "require": "./dist/env/index.js"
-    },
-    "./env/loader": {
-      "types": "./dist/env/loader.d.ts",
-      "import": "./dist/env/loader.js",
-      "require": "./dist/env/loader.js"
-    },
-    "./logger": {
-      "types": "./dist/logger/index.d.ts",
-      "import": "./dist/logger/index.js",
-      "require": "./dist/logger/index.js"
-    },
-    "./config": {
-      "types": "./dist/config/index.d.ts",
-      "import": "./dist/config/index.js",
-      "require": "./dist/config/index.js"
-    },
-    "./job": {
-      "types": "./dist/job/index.d.ts",
-      "import": "./dist/job/index.js",
-      "require": "./dist/job/index.js"
-    },
-    "./event": {
-      "types": "./dist/event/index.d.ts",
-      "import": "./dist/event/index.js",
-      "require": "./dist/event/index.js"
-    },
-    "./event/sse": {
-      "types": "./dist/event/sse/index.d.ts",
-      "import": "./dist/event/sse/index.js",
-      "require": "./dist/event/sse/index.js"
-    },
-    "./event/sse/client": {
-      "types": "./dist/event/sse/client.d.ts",
-      "import": "./dist/event/sse/client.js",
-      "require": "./dist/event/sse/client.js"
-    }
-  },
-  "keywords": [
-    "spfn",
-    "nextjs",
-    "backend",
-    "framework",
-    "typescript",
-    "type-safe",
-    "api",
-    "rest-api",
-    "crud",
-    "database",
-    "orm",
-    "drizzle-orm",
-    "postgres",
-    "redis",
-    "hono",
-    "fullstack",
-    "server",
-    "scalable",
-    "auto-generated",
-    "file-based-routing",
-    "transaction",
-    "repository-pattern"
-  ],
-  "author": "Ray Im <rayim@inflike.com>",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/spfn/spfn.git",
-    "directory": "packages/core"
-  },
-  "bugs": {
-    "url": "https://github.com/spfn/spfn/issues"
-  },
-  "homepage": "https://github.com/spfn/spfn/tree/main/packages/core#readme",
-  "engines": {
-    "node": ">=18.18.0"
-  },
-  "dependencies": {
-    "@hono/node-server": "^1.0.0",
-    "@sinclair/typebox": "^0.34.0",
-    "chalk": "^5.6.2",
-    "chokidar": "^4.0.3",
-    "dotenv": "^17.2.3",
-    "drizzle-orm": "^0.45.0",
-    "drizzle-typebox": "^0.1.0",
-    "hono": "^4.10.6",
-    "jiti": "^2.6.1",
-    "micromatch": "^4.0.8",
-    "pg-boss": "^11.1.2",
-    "postgres": "^3.4.0",
-    "typescript": "^5.3.3",
-    "zod": "^4.1.11"
-  },
-  "optionalDependencies": {
-    "ioredis": "^5.4.1"
-  },
-  "devDependencies": {
-    "@types/micromatch": "^4.0.9",
-    "@types/node": "^20.11.0",
-    "@vitest/coverage-v8": "^4.0.6",
-    "drizzle-kit": "^0.31.6",
-    "madge": "^8.0.0",
-    "next": "^16.0.0",
-    "tsup": "^8.5.0",
-    "vitest": "^4.0.6"
-  },
-  "peerDependencies": {
-    "next": "^15.0.0 || ^16.0.0"
-  },
-  "peerDependenciesMeta": {
-    "next": {
-      "optional": true
+    "name": "@spfn/core",
+    "version": "0.3.0-beta.2",
+    "description": "Full-stack TypeScript backend for Next.js: file-based typed routes, Drizzle entities and repositories, PostgreSQL transactions and a generated end-to-end client, in one fixed vertical slice per feature",
+    "type": "module",
+    "exports": {
+        "./client": {
+            "types": "./dist/client/index.d.ts",
+            "import": "./dist/client/index.js",
+            "require": "./dist/client/index.js"
+        },
+        "./nextjs": {
+            "types": "./dist/nextjs/index.d.ts",
+            "import": "./dist/nextjs/index.js",
+            "require": "./dist/nextjs/index.js"
+        },
+        "./nextjs/server": {
+            "types": "./dist/nextjs/server.d.ts",
+            "import": "./dist/nextjs/server.js",
+            "require": "./dist/nextjs/server.js"
+        },
+        "./route": {
+            "types": "./dist/route/index.d.ts",
+            "import": "./dist/route/index.js",
+            "require": "./dist/route/index.js"
+        },
+        "./route/types": {
+            "types": "./dist/route/types.d.ts",
+            "import": "./dist/route/types.js",
+            "require": "./dist/route/types.js"
+        },
+        "./db": {
+            "types": "./dist/db/index.d.ts",
+            "import": "./dist/db/index.js",
+            "require": "./dist/db/index.js"
+        },
+        "./server": {
+            "types": "./dist/server/index.d.ts",
+            "import": "./dist/server/index.js",
+            "require": "./dist/server/index.js"
+        },
+        "./errors": {
+            "types": "./dist/errors/index.d.ts",
+            "import": "./dist/errors/index.js",
+            "require": "./dist/errors/index.js"
+        },
+        "./middleware": {
+            "types": "./dist/middleware/index.d.ts",
+            "import": "./dist/middleware/index.js",
+            "require": "./dist/middleware/index.js"
+        },
+        "./security": {
+            "types": "./dist/security/index.d.ts",
+            "import": "./dist/security/index.js",
+            "require": "./dist/security/index.js"
+        },
+        "./authz": {
+            "types": "./dist/authz/index.d.ts",
+            "import": "./dist/authz/index.js",
+            "require": "./dist/authz/index.js"
+        },
+        "./cache": {
+            "types": "./dist/cache/index.d.ts",
+            "import": "./dist/cache/index.js",
+            "require": "./dist/cache/index.js"
+        },
+        "./codegen": {
+            "types": "./dist/codegen/index.d.ts",
+            "import": "./dist/codegen/index.js",
+            "require": "./dist/codegen/index.js"
+        },
+        "./contract": {
+            "types": "./dist/contract/index.d.ts",
+            "import": "./dist/contract/index.js",
+            "require": "./dist/contract/index.js"
+        },
+        "./ops": {
+            "types": "./dist/ops/index.d.ts",
+            "import": "./dist/ops/index.js",
+            "require": "./dist/ops/index.js"
+        },
+        "./env": {
+            "types": "./dist/env/index.d.ts",
+            "import": "./dist/env/index.js",
+            "require": "./dist/env/index.js"
+        },
+        "./env/loader": {
+            "types": "./dist/env/loader.d.ts",
+            "import": "./dist/env/loader.js",
+            "require": "./dist/env/loader.js"
+        },
+        "./logger": {
+            "types": "./dist/logger/index.d.ts",
+            "import": "./dist/logger/index.js",
+            "require": "./dist/logger/index.js"
+        },
+        "./config": {
+            "types": "./dist/config/index.d.ts",
+            "import": "./dist/config/index.js",
+            "require": "./dist/config/index.js"
+        },
+        "./job": {
+            "types": "./dist/job/index.d.ts",
+            "import": "./dist/job/index.js",
+            "require": "./dist/job/index.js"
+        },
+        "./event": {
+            "types": "./dist/event/index.d.ts",
+            "import": "./dist/event/index.js",
+            "require": "./dist/event/index.js"
+        },
+        "./event/sse": {
+            "types": "./dist/event/sse/index.d.ts",
+            "import": "./dist/event/sse/index.js",
+            "require": "./dist/event/sse/index.js"
+        },
+        "./event/sse/client": {
+            "types": "./dist/event/sse/client.d.ts",
+            "import": "./dist/event/sse/client.js",
+            "require": "./dist/event/sse/client.js"
+        },
+        "./event/ws": {
+            "types": "./dist/event/ws/index.d.ts",
+            "import": "./dist/event/ws/index.js",
+            "require": "./dist/event/ws/index.js"
+        },
+        "./event/ws/client": {
+            "types": "./dist/event/ws/client.d.ts",
+            "import": "./dist/event/ws/client.js",
+            "require": "./dist/event/ws/client.js"
+        }
+    },
+    "scripts": {
+        "build": "pnpm check:circular && tsup",
+        "prepack": "node -e \"require('fs').copyFileSync('../../LICENSE','LICENSE')\"",
+        "dev": "tsup",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "test:coverage": "vitest run --coverage",
+        "test:logger": "vitest run src/logger",
+        "test:errors": "vitest run src/errors",
+        "test:codegen": "vitest run src/codegen",
+        "test:route": "vitest run src/route",
+        "test:client": "vitest run src/client",
+        "test:middleware": "vitest run src/middleware",
+        "test:env": "vitest run src/env",
+        "test:cache": "vitest run src/cache --config vitest.integration.config.ts",
+        "test:db": "vitest run src/db --config vitest.integration.config.ts",
+        "test:server": "vitest run src/server --config vitest.integration.config.ts",
+        "check:circular": "madge --circular --extensions ts src/",
+        "type-check": "tsc --noEmit",
+        "publish:alpha": "node ../../scripts/publish-package.mjs alpha",
+        "publish:beta": "node ../../scripts/publish-package.mjs beta",
+        "publish:latest": "node ../../scripts/publish-package.mjs latest"
+    },
+    "keywords": [
+        "spfn",
+        "nextjs",
+        "backend",
+        "framework",
+        "typescript",
+        "type-safe",
+        "api",
+        "rest-api",
+        "crud",
+        "database",
+        "orm",
+        "drizzle-orm",
+        "postgres",
+        "redis",
+        "hono",
+        "fullstack",
+        "full-stack-framework",
+        "ai-coding-agent",
+        "claude-code",
+        "file-based-routing",
+        "transaction",
+        "repository-pattern"
+    ],
+    "author": "Ray Im <rayim@fxy.global>",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/fxylabs/spfn.git",
+        "directory": "packages/core"
+    },
+    "bugs": {
+        "url": "https://github.com/fxylabs/spfn/issues"
+    },
+    "homepage": "https://github.com/fxylabs/spfn/tree/main/packages/core#readme",
+    "engines": {
+        "node": ">=20.0.0"
+    },
+    "dependencies": {
+        "@hono/node-server": "^2.0.5",
+        "@sinclair/typebox": "^0.34.0",
+        "chalk": "^5.6.2",
+        "chokidar": "^4.0.3",
+        "dotenv": "^17.2.3",
+        "drizzle-typebox": "^0.3.3",
+        "hono": "^4.12.34",
+        "jiti": "^2.6.1",
+        "micromatch": "^4.0.8",
+        "pg-boss": "^11.1.2",
+        "postgres": "^3.4.0",
+        "typescript": "^5.3.3",
+        "undici": "^7.29.0",
+        "zod": "^4.4.3"
+    },
+    "optionalDependencies": {
+        "ioredis": "^5.4.1",
+        "ws": "^8.21.0"
+    },
+    "devDependencies": {
+        "@electric-sql/pglite": "0.5.4",
+        "@types/micromatch": "^4.0.9",
+        "@types/node": "^20.11.0",
+        "@types/ws": "^8.18.1",
+        "@vitest/coverage-v8": "^4.0.6",
+        "drizzle-kit": "1.0.0-rc.4",
+        "drizzle-orm": "1.0.0-rc.4",
+        "madge": "^8.0.0",
+        "next": "^16.2.11",
+        "tsup": "^8.5.0",
+        "vitest": "^4.0.6"
+    },
+    "peerDependencies": {
+        "drizzle-orm": ">=1.0.0-rc.4 <2",
+        "next": "^16.2.11"
+    },
+    "peerDependenciesMeta": {
+        "next": {
+            "optional": true
+        }
+    },
+    "files": [
+        "dist",
+        "docs",
+        "README.md",
+        "LICENSE"
+    ],
+    "publishConfig": {
+        "access": "public",
+        "tag": "beta"
     }
-  },
-  "files": [
-    "dist",
-    "docs",
-    "README.md",
-    "LICENSE"
-  ],
-  "publishConfig": {
-    "access": "public",
-    "tag": "beta"
-  },
-  "scripts": {
-    "build": "pnpm check:circular && tsup",
-    "dev": "tsup",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --config vitest.unit.config.ts --coverage",
-    "test:logger": "vitest run src/logger",
-    "test:errors": "vitest run src/errors",
-    "test:codegen": "vitest run src/codegen",
-    "test:route": "vitest run src/route",
-    "test:client": "vitest run src/client",
-    "test:middleware": "vitest run src/middleware",
-    "test:env": "vitest run src/env",
-    "test:cache": "vitest run src/cache --config vitest.integration.config.ts",
-    "test:db": "vitest run src/db --config vitest.integration.config.ts",
-    "test:server": "vitest run src/server --config vitest.integration.config.ts",
-    "docker:test:up": "docker compose -f docker-compose.test.yml up -d",
-    "docker:test:down": "docker compose -f docker-compose.test.yml down",
-    "docker:test:logs": "docker compose -f docker-compose.test.yml logs -f",
-    "check:circular": "madge --circular --extensions ts src/",
-    "type-check": "tsc --noEmit"
-  }
-}
+}

package/dist/router-Di7ENoah.d.ts

@@ -1,151 +0,0 @@
-import { TSchema } from '@sinclair/typebox';
-
-/**
- * Event System Types
- */
-
-/**
- * Pub/Sub capable cache interface for multi-instance events
- */
-interface PubSubCache {
-    /**
-     * Publish a message to a channel
-     */
-    publish(channel: string, message: unknown): Promise<void>;
-    /**
-     * Subscribe to a channel
-     */
-    subscribe(channel: string, handler: (message: unknown) => void | Promise<void>): Promise<void>;
-}
-/**
- * Event handler function type
- */
-type EventHandler<TPayload> = (payload: TPayload) => void | Promise<void>;
-/**
- * Job queue sender function type (used by job module)
- */
-type JobQueueSender = (queueName: string, payload: unknown) => Promise<void>;
-/**
- * Event definition interface
- */
-interface EventDef<TPayload = void> {
-    /**
-     * Unique event name
-     */
-    readonly name: string;
-    /**
-     * TypeBox payload schema (optional)
-     */
-    readonly schema?: TSchema;
-    /**
-     * Subscribe to this event (in-memory handler)
-     */
-    subscribe: (handler: EventHandler<TPayload>) => () => void;
-    /**
-     * Unsubscribe all handlers
-     */
-    unsubscribeAll: () => void;
-    /**
-     * Emit the event (triggers all subscribers and queued jobs)
-     */
-    emit: TPayload extends void ? () => Promise<void> : (payload: TPayload) => Promise<void>;
-    /**
-     * Enable cache-based pub/sub for multi-instance support
-     * Must await before emitting events to ensure subscription is ready
-     */
-    useCache: (cache: PubSubCache) => Promise<EventDef<TPayload>>;
-    /**
-     * Internal: Register a job queue to receive this event
-     * Called by job registration system
-     */
-    _registerJobQueue: (queueName: string, sender: JobQueueSender) => void;
-    /**
-     * Type inference helper
-     */
-    _payload: TPayload;
-}
-/**
- * Infer payload type from EventDef
- */
-type InferEventPayload$1<TEvent> = TEvent extends EventDef<infer TPayload> ? TPayload : never;
-
-/**
- * Event Router
- *
- * Type-safe event router for SSE subscription
- *
- * @example
- * ```typescript
- * import { defineEvent, defineEventRouter } from '@spfn/core/event';
- * import { Type } from '@sinclair/typebox';
- *
- * const userCreated = defineEvent('user.created', Type.Object({
- *     userId: Type.String(),
- * }));
- *
- * const orderPlaced = defineEvent('order.placed', Type.Object({
- *     orderId: Type.String(),
- *     amount: Type.Number(),
- * }));
- *
- * export const eventRouter = defineEventRouter({
- *     userCreated,
- *     orderPlaced,
- * });
- *
- * export type EventRouter = typeof eventRouter;
- * ```
- */
-
-/**
- * Event Router Definition
- */
-interface EventRouterDef<TEvents extends Record<string, EventDef<any>>> {
-    /**
-     * Event definitions
-     */
-    readonly events: TEvents;
-    /**
-     * Event names as array
-     */
-    readonly eventNames: (keyof TEvents)[];
-    /**
-     * Type inference helper - payload types by event name
-     */
-    readonly _types: {
-        [K in keyof TEvents]: TEvents[K]['_payload'];
-    };
-}
-/**
- * Infer event names from EventRouter
- */
-type InferEventNames<T> = T extends EventRouterDef<infer E> ? keyof E & string : never;
-/**
- * Infer payload type for specific event
- */
-type InferEventPayload<T extends EventRouterDef<any>, K extends InferEventNames<T>> = T['_types'][K];
-/**
- * Infer all event payloads map
- */
-type InferEventPayloads<T extends EventRouterDef<any>> = T['_types'];
-/**
- * Define an event router for SSE subscription
- *
- * @example
- * ```typescript
- * export const eventRouter = defineEventRouter({
- *     userCreated,
- *     orderPlaced,
- * });
- *
- * // Type inference
- * type Names = InferEventNames<typeof eventRouter>;
- * // 'userCreated' | 'orderPlaced'
- *
- * type Payload = InferEventPayload<typeof eventRouter, 'userCreated'>;
- * // { userId: string }
- * ```
- */
-declare function defineEventRouter<TEvents extends Record<string, EventDef<any>>>(events: TEvents): EventRouterDef<TEvents>;
-
-export { type EventRouterDef as E, type InferEventNames as I, type JobQueueSender as J, type PubSubCache as P, type EventDef as a, type InferEventPayload as b, type InferEventPayloads as c, defineEventRouter as d, type EventHandler as e, type InferEventPayload$1 as f };