spfn 0.2.0-beta.46 → 0.2.0-beta.48

package/dist/templates/.dockerignore

@@ -14,6 +14,7 @@ dist
 .env
 .env.local
 .env*.local
+.env.server
 
 # Git
 .git

package/dist/templates/Dockerfile

@@ -1,5 +1,5 @@
 # Production Dockerfile for SPFN
-FROM node:20-alpine
+FROM node:22-alpine
 
 WORKDIR /app
 

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

@@ -36,88 +36,23 @@ export const envSchema = defineEnvSchema({
 });
 
 /**
- * Type-safe Environment Registry
+ * Type-safe Environment Variables
  *
- * Use this registry to access environment variables throughout your application.
- * It provides type-safe access and automatic validation.
+ * Variables are lazily validated on access — if a required variable is
+ * missing or invalid, an error is thrown at the first access point.
+ * This is timing-safe with dotenv loading.
  *
  * @example
  * ```typescript
  * import env from '@/server/config/env.config';
  *
- * // Get required variable (throws if missing)
- * const dbUrl = env.require('DATABASE_URL');
- *
- * // Get optional variable (returns undefined if missing)
- * const redisUrl = env.get('REDIS_URL');
- *
- * // Get with default value
- * const port = env.get('PORT') ?? 8790;
+ * const dbUrl = env.DATABASE_URL;   // throws if required and missing
+ * const port = env.PORT ?? 8790;    // optional with fallback
  * ```
- */
-export const env = createEnvRegistry(envSchema);
-
-/**
- * Validate Environment Variables
  *
- * This validation runs automatically when this module is imported.
- * It will fail fast on startup if any required variables are missing
- * or if there are configuration errors.
+ * For explicit upfront validation (e.g. in a CLI script), call
+ * `createEnvRegistry(envSchema).validateAll()` to get `{ errors, warnings }`.
  */
-if (typeof process !== 'undefined' && process.env.NODE_ENV !== 'test')
-{
-    const validation = env.validate();
-
-    // Critical errors (missing required variables)
-    if (!validation.valid)
-    {
-        console.error('\n❌ Environment Validation Failed\n');
-        console.error('The following required environment variables are missing or invalid:\n');
-
-        validation.errors.forEach((error) =>
-        {
-            console.error(`  • ${error.key}`);
-            console.error(`    ${error.message}`);
-
-            if (error.suggestion)
-            {
-                console.error(`    💡 ${error.suggestion}`);
-            }
-
-            console.error('');
-        });
-
-        console.error('Please check your .env files and ensure all required variables are set.');
-        console.error('See .env.example for reference.\n');
-
-        process.exit(1);
-    }
+export const env = createEnvRegistry(envSchema).validate();
 
-    // Non-critical warnings
-    if (validation.warnings.length > 0)
-    {
-        console.warn('\n⚠️  Environment Warnings:\n');
-
-        validation.warnings.forEach((warning) =>
-        {
-            console.warn(`  • ${warning.key}: ${warning.message}`);
-
-            if (warning.suggestion)
-            {
-                console.warn(`    💡 ${warning.suggestion}`);
-            }
-        });
-
-        console.warn('');
-    }
-}
-
-/**
- * Export the registry as default
- *
- * Import this in your application to access environment variables:
- * ```typescript
- * import env from '@/server/config/env.config';
- * ```
- */
 export default env;

package/dist/templates/server/routes/examples.ts

@@ -39,26 +39,16 @@ export const listExamples = route.get('/examples')
 
 /**
  * GET /examples/:id - Get single example
- *
- * This route requires authorization header for testing header validation
  */
 export const getExample = route.get('/examples/:id')
     .input({
-        headers: Type.Object({
-            test: Type.String({
-                description: 'Bearer token for authentication'
-            })
-        }),
         params: Type.Object({
             id: Type.String(),
         }),
     })
     .handler(async (c) =>
     {
-        const { params, headers } = await c.data();
-
-        // Log authorization header for testing
-        console.log('Authorization:', headers.test);
+        const { params } = await c.data();
 
         const example = await exampleRepo.findById(params.id);
 

package/dist/templates/server/routes/root.ts

@@ -16,7 +16,6 @@ export const getRoot = route.get('/')
             endpoints: {
                 health: '/health',
                 examples: '/examples',
-                teams: '/teams',
             },
             message: 'Welcome to SPFN! Visit /examples for usage examples.',
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spfn",
-  "version": "0.2.0-beta.46",
+  "version": "0.2.0-beta.48",
   "description": "Superfunction CLI - Add SPFN to your Next.js project",
   "type": "module",
   "bin": {
@@ -78,7 +78,7 @@
     "concurrently": "^9.2.1",
     "tsx": "^4.20.6",
     "typescript": "^5.3.3",
-    "@spfn/core": "0.2.0-beta.45"
+    "@spfn/core": "0.2.0-beta.49"
   },
   "scripts": {
     "build": "tsup && node scripts/copy-templates.js",

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,
-    }),
-});