spfn 0.2.0-beta.9 → 0.3.0-beta.2

package/dist/templates/server/server.config.ts

@@ -2,10 +2,10 @@
  * Server Configuration
  */
 import { defineServerConfig } from '@spfn/core/server';
-import { appRouter } from "@/server/router";
+import { appRouter } from '@/server/router';
 
 export default defineServerConfig()
     .port(8790)
     .host('0.0.0.0')
     .routes(appRouter)
-    .build();
+    .build();

package/dist/templates/vercel/npmrc

@@ -0,0 +1,4 @@
+@spfn:registry=https://git.superfunction.xyz/api/packages/superfunction/npm/
+@superself:registry=https://git.superfunction.xyz/api/packages/superfunction/npm/
+//git.superfunction.xyz/api/packages/superfunction/npm/:_authToken=${GITEA_NPM_TOKEN}
+//git.superfunction.xyz/api/packages/superfunction/npm/:always-auth=true

package/dist/templates/vercel/route.ts

@@ -0,0 +1,53 @@
+/**
+ * Vercel serverless adapter for the SPFN Hono API.
+ *
+ * The SPFN-specific bootstrap lives in the core: `createServerlessApp()`
+ * (from `@spfn/core/server`) returns a listen-free, memoized Hono app with the DB
+ * initialized in-handler and the periodic health-check disabled. `hono/vercel`'s
+ * `handle()` turns it into Vercel Functions. `startServer()` / `spfn start` (the
+ * always-on path) is unaffected.
+ *
+ * The SPFN app is mounted under `/api/backend` so it coexists with Next.js routes on
+ * a single Vercel origin. Point the RPC proxy at the same origin in production:
+ *   SPFN_API_URL = https://<deployment>/api/backend
+ */
+
+import { Hono } from 'hono';
+import { handle } from 'hono/vercel';
+import { createServerlessApp } from '@spfn/core/server';
+import serverConfig from '@/server/server.config';
+
+// SPFN needs Node APIs (pg, native bcrypt) — the edge runtime cannot host it.
+export const runtime = 'nodejs';
+export const dynamic = 'force-dynamic';
+
+// The Vercel Supabase integration injects POSTGRES_URL (Supavisor transaction pooler)
+// but not DATABASE_URL, which is what SPFN reads. Map it so the app connects.
+process.env.DATABASE_URL ??= process.env.POSTGRES_URL;
+
+let handlerPromise: Promise<(req: Request) => Response | Promise<Response>> | undefined;
+
+function getHandler()
+{
+    if (!handlerPromise)
+    {
+        handlerPromise = createServerlessApp(serverConfig).then((spfn) =>
+            handle(new Hono().route('/api/backend', spfn)),
+        );
+    }
+
+    return handlerPromise;
+}
+
+async function dispatch(req: Request): Promise<Response>
+{
+    return (await getHandler())(req);
+}
+
+export const GET = dispatch;
+export const POST = dispatch;
+export const PUT = dispatch;
+export const PATCH = dispatch;
+export const DELETE = dispatch;
+export const OPTIONS = dispatch;
+export const HEAD = dispatch;

package/dist/templates/vercel/vercel.json

@@ -0,0 +1,6 @@
+{
+    "$schema": "https://openapi.vercel.sh/vercel.json",
+    "framework": "nextjs",
+    "buildCommand": "pnpm spfn:build",
+    "installCommand": "pnpm install --no-frozen-lockfile"
+}

package/package.json

@@ -1,16 +1,26 @@
 {
   "name": "spfn",
-  "version": "0.2.0-beta.9",
-  "description": "Superfunction CLI - Add SPFN to your Next.js project",
+  "version": "0.3.0-beta.2",
+  "description": "Scaffold a full-stack TypeScript backend onto a Next.js app built with an AI coding agent: auth, database, typed routes and codegen, one fixed vertical slice per feature",
   "type": "module",
   "bin": {
-    "spfn": "./bin/spfn.js"
+    "spfn": "bin/spfn.js"
   },
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
     "bin"
   ],
+  "scripts": {
+    "build": "tsup && node scripts/copy-templates.js",
+    "test": "vitest run",
+    "prepack": "node -e \"require('fs').copyFileSync('../../LICENSE','LICENSE')\"",
+    "dev": "tsup --watch",
+    "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",
     "cli",
@@ -22,31 +32,32 @@
     "scaffolding",
     "boilerplate",
     "dev-tools",
-    "development",
-    "init",
     "typescript",
-    "type-safe"
+    "type-safe",
+    "full-stack-framework",
+    "ai-coding-agent",
+    "claude-code"
   ],
-  "author": "Ray Im <rayim@inflike.com>",
+  "author": "Ray Im <rayim@fxy.global>",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/spfn/spfn.git",
+    "url": "git+https://github.com/fxylabs/spfn.git",
     "directory": "packages/cli"
   },
   "publishConfig": {
     "access": "public",
-    "tag": "alpha",
-    "registry": "https://registry.npmjs.org"
+    "tag": "beta"
   },
   "bugs": {
-    "url": "https://github.com/spfn/spfn/issues"
+    "url": "https://github.com/fxylabs/spfn/issues"
   },
-  "homepage": "https://github.com/spfn/spfn/tree/main/packages/cli#readme",
+  "homepage": "https://github.com/fxylabs/spfn/tree/main/packages/cli#readme",
   "engines": {
-    "node": ">=18.18.0"
+    "node": ">=20.0.0"
   },
   "peerDependencies": {
+    "@spfn/core": ">=0.3.0-beta.1 <0.4.0",
     "typescript": "^5.3.0"
   },
   "peerDependenciesMeta": {
@@ -59,7 +70,8 @@
     "chokidar": "^4.0.3",
     "commander": "^11.1.0",
     "dotenv": "^17.2.3",
-    "drizzle-orm": "^0.45.0",
+    "drizzle-kit": "1.0.0-rc.4",
+    "drizzle-orm": "1.0.0-rc.4",
     "execa": "^8.0.1",
     "fs-extra": "^11.2.0",
     "ora": "^7.0.1",
@@ -67,21 +79,21 @@
     "postgres": "^3.4.0",
     "prompts": "^2.4.2",
     "tsup": "^8.5.0",
-    "@spfn/core": "0.2.0-beta.12"
+    "yaml": "^2.8.3"
+  },
+  "optionalDependencies": {
+    "@napi-rs/keyring": "^1.1.0"
   },
   "devDependencies": {
+    "@electric-sql/pglite": "^0.5.4",
+    "@spfn/core": "workspace:*",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^20.11.0",
     "@types/pg": "^8.10.9",
     "@types/prompts": "^2.4.9",
     "concurrently": "^9.2.1",
-    "drizzle-kit": "^0.31.6",
     "tsx": "^4.20.6",
-    "typescript": "^5.3.3"
-  },
-  "scripts": {
-    "build": "tsup && node scripts/copy-templates.js",
-    "dev": "tsup --watch",
-    "type-check": "tsc --noEmit"
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.6"
   }
-}
+}

package/dist/commands/generate/templates/contract.template

@@ -1,58 +0,0 @@
-/**
- * {{PASCAL_NAME}} Contracts
- *
- * Auto-generated by SPFN CLI
- */
-
-import { Type } from '@sinclair/typebox';
-import { createContract } from '@spfn/core/route';
-
-/**
- * GET /{{ENTITY_NAME}}
- * List {{PASCAL_NAME}} items
- */
-export const list{{PASCAL_NAME}}Contract = createContract({
-    method: 'GET',
-    path: '/{{ENTITY_NAME}}',
-    query: Type.Object({
-        limit: Type.Optional(Type.Number({ minimum: 1, maximum: 100 })),
-        offset: Type.Optional(Type.Number({ minimum: 0 })),
-    }),
-    responses: {
-        200: Type.Object({
-            items: Type.Array(
-                Type.Object({
-                    id: Type.Number(),
-                    name: Type.String(),
-                    description: Type.Union([Type.String(), Type.Null()]),
-                    createdAt: Type.String(),
-                    updatedAt: Type.String(),
-                })
-            ),
-            limit: Type.Number(),
-            offset: Type.Number(),
-        }),
-    },
-});
-
-/**
- * POST /{{ENTITY_NAME}}
- * Create new {{PASCAL_NAME}}
- */
-export const create{{PASCAL_NAME}}Contract = createContract({
-    method: 'POST',
-    path: '/{{ENTITY_NAME}}',
-    body: Type.Object({
-        name: Type.String({ minLength: 1 }),
-        description: Type.Optional(Type.String()),
-    }),
-    responses: {
-        201: Type.Object({
-            id: Type.Number(),
-            name: Type.String(),
-            description: Type.Union([Type.String(), Type.Null()]),
-            createdAt: Type.String(),
-            updatedAt: Type.String(),
-        }),
-    },
-});

package/dist/commands/generate/templates/entity.template

@@ -1,28 +0,0 @@
-/**
- * {{PASCAL_NAME}} Entity
- *
- * Auto-generated by SPFN CLI
- */
-
-import { index, serial, text, timestamp } from 'drizzle-orm/pg-core';
-import { {{SCHEMA_VAR_NAME}} } from './{{SCHEMA_FILE_NAME}}';
-
-export const {{ENTITY_NAME}} = {{SCHEMA_VAR_NAME}}.table('{{TABLE_NAME}}', {
-    // Primary Key
-    id: serial('id').primaryKey(),
-
-    // Fields
-    name: text('name').notNull(),
-    description: text('description'),
-
-    // Timestamps
-    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
-    updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
-}, (table) => [
-    // Indexes
-    index('{{SCHEMA_NAME}}_{{TABLE_NAME}}_name_idx').on(table.name),
-]);
-
-// Type inference
-export type {{PASCAL_NAME}} = typeof {{ENTITY_NAME}}.$inferSelect;
-export type New{{PASCAL_NAME}} = typeof {{ENTITY_NAME}}.$inferInsert;

package/dist/commands/generate/templates/init-migration.template

@@ -1,3 +0,0 @@
--- Initial migration for @spfn/{{FN_NAME}}
--- Create schema for {{PASCAL_NAME}} package
-CREATE SCHEMA IF NOT EXISTS spfn_{{FN_NAME}};

package/dist/commands/generate/templates/repository.template

@@ -1,56 +0,0 @@
-/**
- * {{PASCAL_NAME}} Repository
- *
- * Auto-generated by SPFN CLI
- */
-
-import { findOne, findMany, create, update, deleteById } from '@spfn/core/db';
-import { eq } from 'drizzle-orm';
-import { {{ENTITY_NAME}} } from '@/entities';
-import type { {{PASCAL_NAME}}, New{{PASCAL_NAME}} } from '@/entities';
-
-export const {{REPO_NAME}} = {
-    /**
-     * Find {{PASCAL_NAME}} by ID
-     */
-    findById: async (id: number): Promise<{{PASCAL_NAME}} | null> =>
-    {
-        return findOne({{ENTITY_NAME}}, eq({{ENTITY_NAME}}.id, id));
-    },
-
-    /**
-     * Find all {{PASCAL_NAME}} items
-     */
-    findMany: async (options?: { limit?: number; offset?: number }): Promise<{{PASCAL_NAME}}[]> =>
-    {
-        const { limit = 20, offset = 0 } = options || {};
-        return findMany({{ENTITY_NAME}}, {
-            limit,
-            offset,
-        });
-    },
-
-    /**
-     * Create new {{PASCAL_NAME}}
-     */
-    create: async (data: New{{PASCAL_NAME}}): Promise<{{PASCAL_NAME}}> =>
-    {
-        return create({{ENTITY_NAME}}, data);
-    },
-
-    /**
-     * Update {{PASCAL_NAME}} by ID
-     */
-    updateById: async (id: number, data: Partial<New{{PASCAL_NAME}}>): Promise<{{PASCAL_NAME}} | null> =>
-    {
-        return update({{ENTITY_NAME}}, eq({{ENTITY_NAME}}.id, id), data);
-    },
-
-    /**
-     * Delete {{PASCAL_NAME}} by ID
-     */
-    deleteById: async (id: number): Promise<void> =>
-    {
-        await deleteById({{ENTITY_NAME}}, id);
-    },
-};

package/dist/commands/generate/templates/route.template

@@ -1,65 +0,0 @@
-/**
- * {{PASCAL_NAME}} Routes
- *
- * Auto-generated by SPFN CLI
- */
-
-import { createApp } from '@spfn/core/route';
-import { Transactional } from '@spfn/core/db';
-import { {{REPO_NAME}} } from '@/repositories/{{KEBAB_NAME}}.repository.js';
-import {
-    list{{PASCAL_NAME}}Contract,
-    create{{PASCAL_NAME}}Contract,
-} from '@/contracts/{{KEBAB_NAME}}.js';
-
-const app = createApp();
-
-/**
- * GET /{{ENTITY_NAME}}
- * List {{PASCAL_NAME}} items
- */
-app.bind(list{{PASCAL_NAME}}Contract, async (c) =>
-{
-    const { limit = 20, offset = 0 } = c.query;
-
-    const items = await {{REPO_NAME}}.findMany({ limit, offset });
-
-    return c.json({
-        items: items.map((item) => ({
-            id: item.id,
-            name: item.name,
-            description: item.description,
-            createdAt: item.createdAt.toISOString(),
-            updatedAt: item.updatedAt.toISOString(),
-        })),
-        limit,
-        offset,
-    });
-});
-
-/**
- * POST /{{ENTITY_NAME}}
- * Create new {{PASCAL_NAME}}
- */
-app.bind(create{{PASCAL_NAME}}Contract, [Transactional()], async (c) =>
-{
-    const body = await c.data();
-
-    const item = await {{REPO_NAME}}.create({
-        name: body.name,
-        description: body.description,
-    });
-
-    return c.json(
-        {
-            id: item.id,
-            name: item.name,
-            description: item.description,
-            createdAt: item.createdAt.toISOString(),
-            updatedAt: item.updatedAt.toISOString(),
-        },
-        201
-    );
-});
-
-export default app;

package/dist/commands/generate/templates/schema.template

@@ -1,13 +0,0 @@
-/**
- * {{FN_NAME_PASCAL}} Schema
- *
- * Creates isolated PostgreSQL schema for {{PACKAGE_NAME}} tables.
- * IMPORTANT: Export this schema so drizzle-kit can generate CREATE SCHEMA statement.
- *
- * Auto-generated by SPFN CLI
- */
-
-import { createFunctionSchema } from '@spfn/core/db';
-
-// ✅ Export schema to auto-generate CREATE SCHEMA in migrations
-export const {{SCHEMA_VAR_NAME}} = createFunctionSchema('{{PACKAGE_NAME}}');

package/dist/templates/Dockerfile.optimized

@@ -1,67 +0,0 @@
-# Optimized Production Dockerfile for SPFN
-# Multi-stage build for smaller image size
-
-# Stage 1: Dependencies
-FROM node:20-alpine AS deps
-WORKDIR /app
-
-# Install pnpm
-RUN corepack enable pnpm
-
-# Copy dependency files
-COPY package.json pnpm-lock.yaml* ./
-
-# Install ALL dependencies (needed for build)
-RUN pnpm install --frozen-lockfile
-
-# Stage 2: Builder
-FROM node:20-alpine AS builder
-WORKDIR /app
-
-RUN corepack enable pnpm
-
-# Copy dependencies from deps stage
-COPY --from=deps /app/node_modules ./node_modules
-COPY . .
-
-# Build both Next.js and SPFN server
-RUN pnpm run spfn:build
-
-# Stage 3: Runner (Production)
-FROM node:20-alpine AS runner
-WORKDIR /app
-
-ENV NODE_ENV=production
-
-RUN corepack enable pnpm
-
-# Copy necessary files from builder
-COPY --from=builder /app/package.json ./package.json
-COPY --from=builder /app/pnpm-lock.yaml ./pnpm-lock.yaml
-COPY --from=builder /app/.next ./.next
-COPY --from=builder /app/.spfn ./.spfn
-COPY --from=builder /app/public ./public
-COPY --from=builder /app/next.config.* ./
-COPY --from=builder /app/.env.local.example ./.env.local.example
-
-# Install PRODUCTION dependencies only
-RUN pnpm install --frozen-lockfile --prod
-
-# Create non-root user for security
-RUN addgroup --system --gid 1001 nodejs
-RUN adduser --system --uid 1001 nextjs
-
-# Change ownership
-RUN chown -R nextjs:nodejs /app
-
-USER nextjs
-
-# Expose both ports
-EXPOSE 3790 8790
-
-# Health check for SPFN API
-HEALTHCHECK --interval=30s --timeout=3s --start-period=10s --retries=3 \
-  CMD node -e "require('http').get('http://localhost:8790/health', (r) => {process.exit(r.statusCode === 200 ? 0 : 1)})"
-
-# Start both Next.js and SPFN server
-CMD ["pnpm", "run", "spfn:start"]

package/dist/templates/config/index.ts

@@ -1,22 +0,0 @@
-/**
- * Core Package Configuration
- *
- * @example
- * ```typescript
- * import { registry } from '@spfn/core/config';
- *
- * const env = registry.validate();
- * console.log(env.DB_POOL_MAX);
- * ```
- *
- * @module config
- */
-
-import { createEnvRegistry } from '@spfn/core/env';
-import { envSchema } from './schema';
-
-/**
- * Environment registry
- */
-const registry = createEnvRegistry(envSchema);
-export const env = registry.validate();

package/dist/templates/config/schema.ts

@@ -1,42 +0,0 @@
-/**
- * Environment Variable Schema
- *
- * Centralized schema definition for all environment variables.
- * This provides type safety, validation, and documentation for your application configuration.
- *
- * @example
- * ```typescript
- * import { envSchema } from './config/schema';
- *
- * // Access validated environment variables
- * console.log(envSchema.DATABASE_URL.description);
- * console.log(envSchema.PORT.default);
- * ```
- *
- * @module config/schema
- */
-
-import {
-    defineEnvSchema,
-    envString,
-    envNumber,
-} from '@spfn/core/env';
-
-/**
- * Application environment variable schema
- *
- * Add your environment variables here with proper types and validation.
- */
-export const envSchema = defineEnvSchema({
-    // Example: API configuration
-    API_KEY: envString({
-        description: 'Third-party API key',
-        required: true,
-    }),
-
-    // Example: Server port
-    PORT: envNumber({
-        description: 'Server port number',
-        default: 8790,
-    }),
-});