shokupan 0.0.1 → 0.2.0

package/README.md

@@ -1628,21 +1628,22 @@ Container.clear();
 - ✅ **OpenTelemetry** - Built-in [OpenTelemetry](https://opentelemetry.io/) traces
 - ✅ **OAuth2** - Built-in [OAuth2](https://oauth.net/2/) support
 - ✅ **Request-Scoped Globals** - Request-scoped values via [AsyncLocalStorage](https://docs.deno.com/api/node/async_hooks/~/AsyncLocalStorage)
-
+- ✅ **Runtime Compatibility** - Support for [Deno](https://deno.com/) and [Node.js](https://nodejs.org/)
+- ✅ **Deep Introspection** - Type analysis for enhanced OpenAPI generation
+- ✅ **Controller Mode** - Option for controller-only mode
+- ✅ **Supports Node/Deno** - Shokupan can run on Node.js or Deno
+- ✅ **OpenAPI Validation** - Built-in [OpenAPI](https://www.openapis.org/) validation
 
 ### Future Features
 
-- 🔄 **Runtime Compatibility** - Support for [Deno](https://deno.com/) and [Node.js](https://nodejs.org/)
-- 🔌 **Framework Plugins** - Drop-in adapters for [Express](https://expressjs.com/), [Koa](https://koajs.com/), and [Elysia](https://elysiajs.com/)
-- 📡 **Enhanced WebSockets** - Event support and HTTP simulation
-- 🔍 **Deep Introspection** - Type analysis for enhanced OpenAPI generation
-- 📊 **Benchmarks** - Comprehensive performance comparisons
-- ⚖️ **Scaling** - Automatic clustering support
-- 🔗 **RPC Support** - [tRPC](https://trpc.io/) and [gRPC](https://grpc.io/) integration
-- 📦 **Binary Formats** - [Protobuf](https://protobuf.dev/) and [MessagePack](https://msgpack.org/) support
-- 🛡️ **Reliability** - Circuit breaker pattern for resilience
-- 👮 **Strict Mode** - Enforced controller patterns
-- ⚠️ **Standardized Errors** - Consistent 4xx/5xx error formats
+- 🚧 **Framework Plugins** - Drop-in adapters for [Express](https://expressjs.com/), [Koa](https://koajs.com/), and [Elysia](https://elysiajs.com/)
+- 🚧 **Enhanced WebSockets** - Event support and HTTP simulation
+- 🚧 **Benchmarks** - Comprehensive performance comparisons
+- 🚧 **Scaling** - Automatic clustering support
+- 🚧 **RPC Support** - [tRPC](https://trpc.io/) and [gRPC](https://grpc.io/) integration
+- 🚧 **Binary Formats** - [Protobuf](https://protobuf.dev/) and [MessagePack](https://msgpack.org/) support
+- 🚧 **Reliability** - Circuit breaker pattern for resilience
+- 🚧 **Standardized Errors** - Consistent 4xx/5xx error formats
 
 ## 🤝 Contributing
 

package/dist/analysis/openapi-analyzer.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Route information extracted from AST
+ */
+export interface RouteInfo {
+    method: string;
+    path: string;
+    handlerName?: string;
+    handlerSource?: string;
+    requestTypes?: {
+        body?: any;
+        query?: Record<string, string>;
+        params?: Record<string, string>;
+        headers?: Record<string, string>;
+    };
+    responseType?: string;
+    responseSchema?: any;
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    operationId?: string;
+}
+/**
+ * Dependency information
+ */
+interface DependencyInfo {
+    packageName: string;
+    version?: string;
+    importPath: string;
+    isExternal: boolean;
+}
+/**
+ * Application/Router instance found in code
+ */
+export interface ApplicationInstance {
+    name: string;
+    filePath: string;
+    className: 'Shokupan' | 'ShokupanRouter' | 'Controller';
+    routes: RouteInfo[];
+    mounted: MountInfo[];
+}
+interface MountInfo {
+    prefix: string;
+    target: string;
+    dependency?: DependencyInfo;
+}
+/**
+ * Main analyzer class
+ */
+export declare class OpenAPIAnalyzer {
+    private rootDir;
+    private files;
+    private applications;
+    private program?;
+    private entrypoint?;
+    constructor(rootDir: string, entrypoint?: string);
+    /**
+     * Main analysis entry point
+     */
+    /**
+     * Main analysis entry point
+     */
+    analyze(): Promise<{
+        applications: ApplicationInstance[];
+    }>;
+    /**
+     * Recursively scan directory for TypeScript/JavaScript files
+     */
+    private scanDirectory;
+    /**
+     * Process source maps to reconstruct TypeScript
+     */
+    private processSourceMaps;
+    /**
+     * Parse TypeScript files and create AST
+     */
+    private parseTypeScriptFiles;
+    /**
+     * Find all Shokupan/ShokupanRouter instances
+     */
+    private findApplications;
+    /**
+     * Visit AST node to find application instances
+     */
+    private visitNode;
+    /**
+     * Extract route information from applications
+     */
+    private extractRoutes;
+    /**
+     * Extract routes from a Controller class
+     */
+    private extractRoutesFromController;
+    /**
+     * Extract routes from a specific file
+     */
+    private extractRoutesFromFile;
+    /**
+     * Extract route information from a route call (e.g., app.get('/path', handler))
+     */
+    private extractRouteFromCall;
+    /**
+     * Analyze a route handler to extract type information
+     */
+    private analyzeHandler;
+    /**
+     * Convert an Expression node to an OpenAPI schema (best effort)
+     */
+    private convertExpressionToSchema;
+    /**
+     * Check if an expression is a call to ctx.body()
+     */
+    private isCtxBodyCall;
+    /**
+     * Convert a TypeScript TypeNode to an OpenAPI schema
+     */
+    private convertTypeNodeToSchema;
+    /**
+     * Extract mount information from mount call
+     */
+    private extractMountFromCall;
+    /**
+     * Check if a reference is to an external dependency
+     */
+    private checkIfExternalDependency;
+    /**
+     * Get package version from package.json
+     */
+    private getPackageVersion;
+    /**
+     * Generate OpenAPI specification
+     */
+    generateOpenAPISpec(): any;
+    /**
+     * Convert a type string to an OpenAPI schema
+     */
+    private typeToSchema;
+}
+/**
+ * Analyze a directory and generate OpenAPI spec
+ */
+export declare function analyzeDirectory(directory: string): Promise<any>;
+export {};

package/dist/cli.cjs

@@ -4,6 +4,7 @@ const p = require("@clack/prompts");
 const fs = require("node:fs");
 const path = require("node:path");
 const promises = require("node:timers/promises");
+const openapiAnalyzer = require("./openapi-analyzer-BN0wFCML.cjs");
 function _interopNamespaceDefault(e) {
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });
   if (e) {
@@ -71,7 +72,7 @@ export class ${name}Plugin extends ShokupanRouter {
 }
 `
 };
-async function main() {
+async function scaffold() {
   console.clear();
   p__namespace.intro(`Shokupan CLI Scaffolder`);
   if (!fs.existsSync("package.json")) {
@@ -148,7 +149,66 @@ async function main() {
   const nextSteps = `  -> ${finalPath}
 Make sure to register it in your main application file if necessary.`;
   p__namespace.note(nextSteps, "Next steps");
-  p__namespace.outro(`Problems? Open an issue at https://github.com/dotglitch/express.ts`);
+  p__namespace.outro(`Problems? Open an issue at https://github.com/dotglitch/shokupan`);
+}
+async function analyze() {
+  console.clear();
+  p__namespace.intro(`Shokupan OpenAPI Analyzer`);
+  const args = process.argv.slice(2);
+  let directory = process.cwd();
+  let outputPath = "openapi.json";
+  const analyzeIndex = args.indexOf("analyze");
+  if (analyzeIndex !== -1 && args.length > analyzeIndex + 1) {
+    const nextArg = args[analyzeIndex + 1];
+    if (!nextArg.startsWith("--")) {
+      directory = path.resolve(nextArg);
+    }
+  }
+  const outputIndex = args.indexOf("--output");
+  if (outputIndex !== -1 && args.length > outputIndex + 1) {
+    outputPath = args[outputIndex + 1];
+  }
+  if (!fs.existsSync(directory)) {
+    p__namespace.cancel(`Directory not found: ${directory}`);
+    process.exit(1);
+  }
+  const s = p__namespace.spinner();
+  s.start(`Analyzing directory: ${directory}`);
+  try {
+    const spec = await openapiAnalyzer.analyzeDirectory(directory);
+    s.stop("Analysis complete");
+    const fullOutputPath = path.resolve(outputPath);
+    fs.writeFileSync(fullOutputPath, JSON.stringify(spec, null, 2));
+    p__namespace.note(`OpenAPI spec written to: ${fullOutputPath}`, "Success");
+    const pathCount = Object.keys(spec.paths || {}).length;
+    p__namespace.note(`Found ${pathCount} unique paths`, "Summary");
+    p__namespace.outro("Done!");
+  } catch (error) {
+    s.stop("Analysis failed");
+    p__namespace.cancel(`Error: ${error.message}`);
+    console.error(error);
+    process.exit(1);
+  }
+}
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  if (command === "analyze") {
+    await analyze();
+  } else if (command === "scaffold" || !command) {
+    await scaffold();
+  } else {
+    console.log("Shokupan CLI");
+    console.log("");
+    console.log("Commands:");
+    console.log("  scaffold (default) - Scaffold controllers, middleware, or plugins");
+    console.log("  analyze <directory> - Analyze a Shokupan application and generate OpenAPI spec");
+    console.log("");
+    console.log("Usage:");
+    console.log("  shokupan scaffold");
+    console.log("  shokupan analyze <directory> [--output openapi.json]");
+    process.exit(0);
+  }
 }
 main().catch(console.error);
 //# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.cjs","sources":["../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env bun\nimport * as p from '@clack/prompts';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { setTimeout } from 'node:timers/promises';\n\nconst templates = {\n    controller: (name: string) => `import { Controller, Get, Ctx } from 'shokupan';\nimport { ShokupanContext } from 'shokupan';\n\n@Controller('/${name.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase()}')\nexport class ${name}Controller {\n    @Get('/')\n    public index(@Ctx() ctx: ShokupanContext) {\n        return { message: 'Hello from ${name}Controller' };\n    }\n}\n`,\n    middleware: (name: string) => `import { ShokupanContext, NextFn } from 'shokupan';\n\n/**\n * ${name} Middleware\n */\nexport const ${name}Middleware = async (ctx: ShokupanContext, next: NextFn) => {\n    // Before next\n    // console.log('${name} Middleware - Request');\n\n    const result = await next();\n\n    // After next\n    // console.log('${name} Middleware - Response');\n    \n    return result;\n};\n`,\n    plugin: (name: string) => `import { ShokupanRouter } from 'shokupan';\nimport { ShokupanContext } from 'shokupan';\n\nexport interface ${name}Options {\n    // Define options here\n}\n\nexport class ${name}Plugin extends ShokupanRouter {\n    constructor(private options: ${name}Options = {}) {\n        super();\n        this.init();\n    }\n\n    private init() {\n        this.get('/', (ctx: ShokupanContext) => {\n            return { message: '${name} Plugin Active' };\n        });\n    }\n}\n`\n};\n\nasync function main() {\n    console.clear();\n    p.intro(`Shokupan CLI Scaffolder`);\n\n    // Check if running in a project root\n    if (!fs.existsSync('package.json')) {\n        p.note('Warning: No package.json found in current directory. Are you in the project root?');\n    }\n\n    const project = await p.group(\n        {\n            type: () => p.select({\n                message: 'What do you want to scaffold?',\n                options: [\n                    { value: 'controller', label: 'Controller' },\n                    { value: 'middleware', label: 'Middleware' },\n                    { value: 'plugin', label: 'Plugin' },\n                ],\n            }),\n            name: () => p.text({\n                message: 'Name (PascalCase, e.g. UserAuth):',\n                validate: (value) => {\n                    if (!value) return 'Name is required';\n                    if (!/^[A-Z][a-zA-Z0-9]*$/.test(value)) return 'Please use PascalCase';\n                    return undefined;\n                },\n            }),\n            dir: () => p.text({\n                message: 'Output directory (leave empty for default):',\n                placeholder: 'src/controllers',\n            }),\n        },\n        {\n            onCancel: () => {\n                p.cancel('Operation cancelled.');\n                process.exit(0);\n            },\n        }\n    );\n\n    const type = project.type as keyof typeof templates;\n    const name = project.name;\n    let dir = project.dir;\n\n    if (!dir || dir.trim() === '') {\n        switch (type) {\n            case 'controller': dir = 'src/controllers'; break;\n            case 'middleware': dir = 'src/middleware'; break;\n            case 'plugin': dir = 'src/plugins'; break;\n        }\n    }\n\n    // Convert PascalCase to kebab-case for filename\n    const kebabName = name.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();\n    const fileName = `${kebabName}.ts`;\n\n    const finalPath = path.join(process.cwd(), dir, fileName);\n\n    // Ensure directory exists\n    if (!fs.existsSync(path.dirname(finalPath))) {\n        fs.mkdirSync(path.dirname(finalPath), { recursive: true });\n    }\n\n    // Check for overwrite\n    if (fs.existsSync(finalPath)) {\n        const overwrite = await p.confirm({\n            message: `File ${finalPath} already exists. Overwrite?`,\n            initialValue: false\n        });\n\n        if (p.isCancel(overwrite) || !overwrite) {\n            p.cancel('Operation cancelled.');\n            process.exit(0);\n        }\n    }\n\n    const s = p.spinner();\n    s.start(`Creating ${type}...`);\n\n    await setTimeout(500); // Artificial delay to show spinner\n\n    const content = templates[type](name);\n    fs.writeFileSync(finalPath, content);\n\n    s.stop(`Created ${type}`);\n\n    const nextSteps = `  -> ${finalPath}\nMake sure to register it in your main application file if necessary.`;\n\n    p.note(nextSteps, 'Next steps');\n\n    p.outro(`Problems? Open an issue at https://github.com/dotglitch/express.ts`);\n}\n\nmain().catch(console.error);;\n"],"names":["p","setTimeout"],"mappings":"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"}
+{"version":3,"file":"cli.cjs","sources":["../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env bun\nimport * as p from '@clack/prompts';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { setTimeout } from 'node:timers/promises';\nimport { analyzeDirectory } from '../analysis/openapi-analyzer';\n\nconst templates = {\n    controller: (name: string) => `import { Controller, Get, Ctx } from 'shokupan';\nimport { ShokupanContext } from 'shokupan';\n\n@Controller('/${name.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase()}')\nexport class ${name}Controller {\n    @Get('/')\n    public index(@Ctx() ctx: ShokupanContext) {\n        return { message: 'Hello from ${name}Controller' };\n    }\n}\n`,\n    middleware: (name: string) => `import { ShokupanContext, NextFn } from 'shokupan';\n\n/**\n * ${name} Middleware\n */\nexport const ${name}Middleware = async (ctx: ShokupanContext, next: NextFn) => {\n    // Before next\n    // console.log('${name} Middleware - Request');\n\n    const result = await next();\n\n    // After next\n    // console.log('${name} Middleware - Response');\n    \n    return result;\n};\n`,\n    plugin: (name: string) => `import { ShokupanRouter } from 'shokupan';\nimport { ShokupanContext } from 'shokupan';\n\nexport interface ${name}Options {\n    // Define options here\n}\n\nexport class ${name}Plugin extends ShokupanRouter {\n    constructor(private options: ${name}Options = {}) {\n        super();\n        this.init();\n    }\n\n    private init() {\n        this.get('/', (ctx: ShokupanContext) => {\n            return { message: '${name} Plugin Active' };\n        });\n    }\n}\n`\n};\n\nasync function scaffold() {\n    console.clear();\n    p.intro(`Shokupan CLI Scaffolder`);\n\n    // Check if running in a project root\n    if (!fs.existsSync('package.json')) {\n        p.note('Warning: No package.json found in current directory. Are you in the project root?');\n    }\n\n    const project = await p.group(\n        {\n            type: () => p.select({\n                message: 'What do you want to scaffold?',\n                options: [\n                    { value: 'controller', label: 'Controller' },\n                    { value: 'middleware', label: 'Middleware' },\n                    { value: 'plugin', label: 'Plugin' },\n                ],\n            }),\n            name: () => p.text({\n                message: 'Name (PascalCase, e.g. UserAuth):',\n                validate: (value) => {\n                    if (!value) return 'Name is required';\n                    if (!/^[A-Z][a-zA-Z0-9]*$/.test(value)) return 'Please use PascalCase';\n                    return undefined;\n                },\n            }),\n            dir: () => p.text({\n                message: 'Output directory (leave empty for default):',\n                placeholder: 'src/controllers',\n            }),\n        },\n        {\n            onCancel: () => {\n                p.cancel('Operation cancelled.');\n                process.exit(0);\n            },\n        }\n    );\n\n    const type = project.type as keyof typeof templates;\n    const name = project.name;\n    let dir = project.dir;\n\n    if (!dir || dir.trim() === '') {\n        switch (type) {\n            case 'controller': dir = 'src/controllers'; break;\n            case 'middleware': dir = 'src/middleware'; break;\n            case 'plugin': dir = 'src/plugins'; break;\n        }\n    }\n\n    // Convert PascalCase to kebab-case for filename\n    const kebabName = name.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();\n    const fileName = `${kebabName}.ts`;\n\n    const finalPath = path.join(process.cwd(), dir, fileName);\n\n    // Ensure directory exists\n    if (!fs.existsSync(path.dirname(finalPath))) {\n        fs.mkdirSync(path.dirname(finalPath), { recursive: true });\n    }\n\n    // Check for overwrite\n    if (fs.existsSync(finalPath)) {\n        const overwrite = await p.confirm({\n            message: `File ${finalPath} already exists. Overwrite?`,\n            initialValue: false\n        });\n\n        if (p.isCancel(overwrite) || !overwrite) {\n            p.cancel('Operation cancelled.');\n            process.exit(0);\n        }\n    }\n\n    const s = p.spinner();\n    s.start(`Creating ${type}...`);\n\n    await setTimeout(500); // Artificial delay to show spinner\n\n    const content = templates[type](name);\n    fs.writeFileSync(finalPath, content);\n\n    s.stop(`Created ${type}`);\n\n    const nextSteps = `  -> ${finalPath}\nMake sure to register it in your main application file if necessary.`;\n\n    p.note(nextSteps, 'Next steps');\n\n    p.outro(`Problems? Open an issue at https://github.com/dotglitch/shokupan`);\n}\n\nasync function analyze() {\n    console.clear();\n    p.intro(`Shokupan OpenAPI Analyzer`);\n\n    const args = process.argv.slice(2);\n    let directory = process.cwd();\n    let outputPath = 'openapi.json';\n\n    // Parse command line arguments\n    // analyze [directory] [--output file.json]\n    const analyzeIndex = args.indexOf('analyze');\n    if (analyzeIndex !== -1 && args.length > analyzeIndex + 1) {\n        const nextArg = args[analyzeIndex + 1];\n        if (!nextArg.startsWith('--')) {\n            directory = path.resolve(nextArg);\n        }\n    }\n\n    const outputIndex = args.indexOf('--output');\n    if (outputIndex !== -1 && args.length > outputIndex + 1) {\n        outputPath = args[outputIndex + 1];\n    }\n\n    // Verify directory exists\n    if (!fs.existsSync(directory)) {\n        p.cancel(`Directory not found: ${directory}`);\n        process.exit(1);\n    }\n\n    const s = p.spinner();\n    s.start(`Analyzing directory: ${directory}`);\n\n    try {\n        const spec = await analyzeDirectory(directory);\n\n        s.stop('Analysis complete');\n\n        // Write to file\n        const fullOutputPath = path.resolve(outputPath);\n        fs.writeFileSync(fullOutputPath, JSON.stringify(spec, null, 2));\n\n        p.note(`OpenAPI spec written to: ${fullOutputPath}`, 'Success');\n\n        // Show summary\n        const pathCount = Object.keys(spec.paths || {}).length;\n        p.note(`Found ${pathCount} unique paths`, 'Summary');\n\n        p.outro('Done!');\n    } catch (error: any) {\n        s.stop('Analysis failed');\n        p.cancel(`Error: ${error.message}`);\n        console.error(error);\n        process.exit(1);\n    }\n}\n\nasync function main() {\n    const args = process.argv.slice(2);\n    const command = args[0];\n\n    if (command === 'analyze') {\n        await analyze();\n    } else if (command === 'scaffold' || !command) {\n        // Default to scaffold for backwards compatibility\n        await scaffold();\n    } else {\n        console.log('Shokupan CLI');\n        console.log('');\n        console.log('Commands:');\n        console.log('  scaffold (default) - Scaffold controllers, middleware, or plugins');\n        console.log('  analyze <directory> - Analyze a Shokupan application and generate OpenAPI spec');\n        console.log('');\n        console.log('Usage:');\n        console.log('  shokupan scaffold');\n        console.log('  shokupan analyze <directory> [--output openapi.json]');\n        process.exit(0);\n    }\n}\n\nmain().catch(console.error);\n"],"names":["p","setTimeout","analyzeDirectory"],"mappings":"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"}

package/dist/cli.js

@@ -3,6 +3,7 @@ import * as p from "@clack/prompts";
 import fs from "node:fs";
 import path from "node:path";
 import { setTimeout } from "node:timers/promises";
+import { analyzeDirectory } from "./openapi-analyzer-BTExMLX4.js";
 const templates = {
   controller: (name) => `import { Controller, Get, Ctx } from 'shokupan';
 import { ShokupanContext } from 'shokupan';
@@ -53,7 +54,7 @@ export class ${name}Plugin extends ShokupanRouter {
 }
 `
 };
-async function main() {
+async function scaffold() {
   console.clear();
   p.intro(`Shokupan CLI Scaffolder`);
   if (!fs.existsSync("package.json")) {
@@ -130,7 +131,66 @@ async function main() {
   const nextSteps = `  -> ${finalPath}
 Make sure to register it in your main application file if necessary.`;
   p.note(nextSteps, "Next steps");
-  p.outro(`Problems? Open an issue at https://github.com/dotglitch/express.ts`);
+  p.outro(`Problems? Open an issue at https://github.com/dotglitch/shokupan`);
+}
+async function analyze() {
+  console.clear();
+  p.intro(`Shokupan OpenAPI Analyzer`);
+  const args = process.argv.slice(2);
+  let directory = process.cwd();
+  let outputPath = "openapi.json";
+  const analyzeIndex = args.indexOf("analyze");
+  if (analyzeIndex !== -1 && args.length > analyzeIndex + 1) {
+    const nextArg = args[analyzeIndex + 1];
+    if (!nextArg.startsWith("--")) {
+      directory = path.resolve(nextArg);
+    }
+  }
+  const outputIndex = args.indexOf("--output");
+  if (outputIndex !== -1 && args.length > outputIndex + 1) {
+    outputPath = args[outputIndex + 1];
+  }
+  if (!fs.existsSync(directory)) {
+    p.cancel(`Directory not found: ${directory}`);
+    process.exit(1);
+  }
+  const s = p.spinner();
+  s.start(`Analyzing directory: ${directory}`);
+  try {
+    const spec = await analyzeDirectory(directory);
+    s.stop("Analysis complete");
+    const fullOutputPath = path.resolve(outputPath);
+    fs.writeFileSync(fullOutputPath, JSON.stringify(spec, null, 2));
+    p.note(`OpenAPI spec written to: ${fullOutputPath}`, "Success");
+    const pathCount = Object.keys(spec.paths || {}).length;
+    p.note(`Found ${pathCount} unique paths`, "Summary");
+    p.outro("Done!");
+  } catch (error) {
+    s.stop("Analysis failed");
+    p.cancel(`Error: ${error.message}`);
+    console.error(error);
+    process.exit(1);
+  }
+}
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  if (command === "analyze") {
+    await analyze();
+  } else if (command === "scaffold" || !command) {
+    await scaffold();
+  } else {
+    console.log("Shokupan CLI");
+    console.log("");
+    console.log("Commands:");
+    console.log("  scaffold (default) - Scaffold controllers, middleware, or plugins");
+    console.log("  analyze <directory> - Analyze a Shokupan application and generate OpenAPI spec");
+    console.log("");
+    console.log("Usage:");
+    console.log("  shokupan scaffold");
+    console.log("  shokupan analyze <directory> [--output openapi.json]");
+    process.exit(0);
+  }
 }
 main().catch(console.error);
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sources":["../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env bun\nimport * as p from '@clack/prompts';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { setTimeout } from 'node:timers/promises';\n\nconst templates = {\n    controller: (name: string) => `import { Controller, Get, Ctx } from 'shokupan';\nimport { ShokupanContext } from 'shokupan';\n\n@Controller('/${name.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase()}')\nexport class ${name}Controller {\n    @Get('/')\n    public index(@Ctx() ctx: ShokupanContext) {\n        return { message: 'Hello from ${name}Controller' };\n    }\n}\n`,\n    middleware: (name: string) => `import { ShokupanContext, NextFn } from 'shokupan';\n\n/**\n * ${name} Middleware\n */\nexport const ${name}Middleware = async (ctx: ShokupanContext, next: NextFn) => {\n    // Before next\n    // console.log('${name} Middleware - Request');\n\n    const result = await next();\n\n    // After next\n    // console.log('${name} Middleware - Response');\n    \n    return result;\n};\n`,\n    plugin: (name: string) => `import { ShokupanRouter } from 'shokupan';\nimport { ShokupanContext } from 'shokupan';\n\nexport interface ${name}Options {\n    // Define options here\n}\n\nexport class ${name}Plugin extends ShokupanRouter {\n    constructor(private options: ${name}Options = {}) {\n        super();\n        this.init();\n    }\n\n    private init() {\n        this.get('/', (ctx: ShokupanContext) => {\n            return { message: '${name} Plugin Active' };\n        });\n    }\n}\n`\n};\n\nasync function main() {\n    console.clear();\n    p.intro(`Shokupan CLI Scaffolder`);\n\n    // Check if running in a project root\n    if (!fs.existsSync('package.json')) {\n        p.note('Warning: No package.json found in current directory. Are you in the project root?');\n    }\n\n    const project = await p.group(\n        {\n            type: () => p.select({\n                message: 'What do you want to scaffold?',\n                options: [\n                    { value: 'controller', label: 'Controller' },\n                    { value: 'middleware', label: 'Middleware' },\n                    { value: 'plugin', label: 'Plugin' },\n                ],\n            }),\n            name: () => p.text({\n                message: 'Name (PascalCase, e.g. UserAuth):',\n                validate: (value) => {\n                    if (!value) return 'Name is required';\n                    if (!/^[A-Z][a-zA-Z0-9]*$/.test(value)) return 'Please use PascalCase';\n                    return undefined;\n                },\n            }),\n            dir: () => p.text({\n                message: 'Output directory (leave empty for default):',\n                placeholder: 'src/controllers',\n            }),\n        },\n        {\n            onCancel: () => {\n                p.cancel('Operation cancelled.');\n                process.exit(0);\n            },\n        }\n    );\n\n    const type = project.type as keyof typeof templates;\n    const name = project.name;\n    let dir = project.dir;\n\n    if (!dir || dir.trim() === '') {\n        switch (type) {\n            case 'controller': dir = 'src/controllers'; break;\n            case 'middleware': dir = 'src/middleware'; break;\n            case 'plugin': dir = 'src/plugins'; break;\n        }\n    }\n\n    // Convert PascalCase to kebab-case for filename\n    const kebabName = name.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();\n    const fileName = `${kebabName}.ts`;\n\n    const finalPath = path.join(process.cwd(), dir, fileName);\n\n    // Ensure directory exists\n    if (!fs.existsSync(path.dirname(finalPath))) {\n        fs.mkdirSync(path.dirname(finalPath), { recursive: true });\n    }\n\n    // Check for overwrite\n    if (fs.existsSync(finalPath)) {\n        const overwrite = await p.confirm({\n            message: `File ${finalPath} already exists. Overwrite?`,\n            initialValue: false\n        });\n\n        if (p.isCancel(overwrite) || !overwrite) {\n            p.cancel('Operation cancelled.');\n            process.exit(0);\n        }\n    }\n\n    const s = p.spinner();\n    s.start(`Creating ${type}...`);\n\n    await setTimeout(500); // Artificial delay to show spinner\n\n    const content = templates[type](name);\n    fs.writeFileSync(finalPath, content);\n\n    s.stop(`Created ${type}`);\n\n    const nextSteps = `  -> ${finalPath}\nMake sure to register it in your main application file if necessary.`;\n\n    p.note(nextSteps, 'Next steps');\n\n    p.outro(`Problems? Open an issue at https://github.com/dotglitch/express.ts`);\n}\n\nmain().catch(console.error);;\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sources":["../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env bun\nimport * as p from '@clack/prompts';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { setTimeout } from 'node:timers/promises';\nimport { analyzeDirectory } from '../analysis/openapi-analyzer';\n\nconst templates = {\n    controller: (name: string) => `import { Controller, Get, Ctx } from 'shokupan';\nimport { ShokupanContext } from 'shokupan';\n\n@Controller('/${name.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase()}')\nexport class ${name}Controller {\n    @Get('/')\n    public index(@Ctx() ctx: ShokupanContext) {\n        return { message: 'Hello from ${name}Controller' };\n    }\n}\n`,\n    middleware: (name: string) => `import { ShokupanContext, NextFn } from 'shokupan';\n\n/**\n * ${name} Middleware\n */\nexport const ${name}Middleware = async (ctx: ShokupanContext, next: NextFn) => {\n    // Before next\n    // console.log('${name} Middleware - Request');\n\n    const result = await next();\n\n    // After next\n    // console.log('${name} Middleware - Response');\n    \n    return result;\n};\n`,\n    plugin: (name: string) => `import { ShokupanRouter } from 'shokupan';\nimport { ShokupanContext } from 'shokupan';\n\nexport interface ${name}Options {\n    // Define options here\n}\n\nexport class ${name}Plugin extends ShokupanRouter {\n    constructor(private options: ${name}Options = {}) {\n        super();\n        this.init();\n    }\n\n    private init() {\n        this.get('/', (ctx: ShokupanContext) => {\n            return { message: '${name} Plugin Active' };\n        });\n    }\n}\n`\n};\n\nasync function scaffold() {\n    console.clear();\n    p.intro(`Shokupan CLI Scaffolder`);\n\n    // Check if running in a project root\n    if (!fs.existsSync('package.json')) {\n        p.note('Warning: No package.json found in current directory. Are you in the project root?');\n    }\n\n    const project = await p.group(\n        {\n            type: () => p.select({\n                message: 'What do you want to scaffold?',\n                options: [\n                    { value: 'controller', label: 'Controller' },\n                    { value: 'middleware', label: 'Middleware' },\n                    { value: 'plugin', label: 'Plugin' },\n                ],\n            }),\n            name: () => p.text({\n                message: 'Name (PascalCase, e.g. UserAuth):',\n                validate: (value) => {\n                    if (!value) return 'Name is required';\n                    if (!/^[A-Z][a-zA-Z0-9]*$/.test(value)) return 'Please use PascalCase';\n                    return undefined;\n                },\n            }),\n            dir: () => p.text({\n                message: 'Output directory (leave empty for default):',\n                placeholder: 'src/controllers',\n            }),\n        },\n        {\n            onCancel: () => {\n                p.cancel('Operation cancelled.');\n                process.exit(0);\n            },\n        }\n    );\n\n    const type = project.type as keyof typeof templates;\n    const name = project.name;\n    let dir = project.dir;\n\n    if (!dir || dir.trim() === '') {\n        switch (type) {\n            case 'controller': dir = 'src/controllers'; break;\n            case 'middleware': dir = 'src/middleware'; break;\n            case 'plugin': dir = 'src/plugins'; break;\n        }\n    }\n\n    // Convert PascalCase to kebab-case for filename\n    const kebabName = name.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();\n    const fileName = `${kebabName}.ts`;\n\n    const finalPath = path.join(process.cwd(), dir, fileName);\n\n    // Ensure directory exists\n    if (!fs.existsSync(path.dirname(finalPath))) {\n        fs.mkdirSync(path.dirname(finalPath), { recursive: true });\n    }\n\n    // Check for overwrite\n    if (fs.existsSync(finalPath)) {\n        const overwrite = await p.confirm({\n            message: `File ${finalPath} already exists. Overwrite?`,\n            initialValue: false\n        });\n\n        if (p.isCancel(overwrite) || !overwrite) {\n            p.cancel('Operation cancelled.');\n            process.exit(0);\n        }\n    }\n\n    const s = p.spinner();\n    s.start(`Creating ${type}...`);\n\n    await setTimeout(500); // Artificial delay to show spinner\n\n    const content = templates[type](name);\n    fs.writeFileSync(finalPath, content);\n\n    s.stop(`Created ${type}`);\n\n    const nextSteps = `  -> ${finalPath}\nMake sure to register it in your main application file if necessary.`;\n\n    p.note(nextSteps, 'Next steps');\n\n    p.outro(`Problems? Open an issue at https://github.com/dotglitch/shokupan`);\n}\n\nasync function analyze() {\n    console.clear();\n    p.intro(`Shokupan OpenAPI Analyzer`);\n\n    const args = process.argv.slice(2);\n    let directory = process.cwd();\n    let outputPath = 'openapi.json';\n\n    // Parse command line arguments\n    // analyze [directory] [--output file.json]\n    const analyzeIndex = args.indexOf('analyze');\n    if (analyzeIndex !== -1 && args.length > analyzeIndex + 1) {\n        const nextArg = args[analyzeIndex + 1];\n        if (!nextArg.startsWith('--')) {\n            directory = path.resolve(nextArg);\n        }\n    }\n\n    const outputIndex = args.indexOf('--output');\n    if (outputIndex !== -1 && args.length > outputIndex + 1) {\n        outputPath = args[outputIndex + 1];\n    }\n\n    // Verify directory exists\n    if (!fs.existsSync(directory)) {\n        p.cancel(`Directory not found: ${directory}`);\n        process.exit(1);\n    }\n\n    const s = p.spinner();\n    s.start(`Analyzing directory: ${directory}`);\n\n    try {\n        const spec = await analyzeDirectory(directory);\n\n        s.stop('Analysis complete');\n\n        // Write to file\n        const fullOutputPath = path.resolve(outputPath);\n        fs.writeFileSync(fullOutputPath, JSON.stringify(spec, null, 2));\n\n        p.note(`OpenAPI spec written to: ${fullOutputPath}`, 'Success');\n\n        // Show summary\n        const pathCount = Object.keys(spec.paths || {}).length;\n        p.note(`Found ${pathCount} unique paths`, 'Summary');\n\n        p.outro('Done!');\n    } catch (error: any) {\n        s.stop('Analysis failed');\n        p.cancel(`Error: ${error.message}`);\n        console.error(error);\n        process.exit(1);\n    }\n}\n\nasync function main() {\n    const args = process.argv.slice(2);\n    const command = args[0];\n\n    if (command === 'analyze') {\n        await analyze();\n    } else if (command === 'scaffold' || !command) {\n        // Default to scaffold for backwards compatibility\n        await scaffold();\n    } else {\n        console.log('Shokupan CLI');\n        console.log('');\n        console.log('Commands:');\n        console.log('  scaffold (default) - Scaffold controllers, middleware, or plugins');\n        console.log('  analyze <directory> - Analyze a Shokupan application and generate OpenAPI spec');\n        console.log('');\n        console.log('Usage:');\n        console.log('  shokupan scaffold');\n        console.log('  shokupan analyze <directory> [--output openapi.json]');\n        process.exit(0);\n    }\n}\n\nmain().catch(console.error);\n"],"names":[],"mappings":"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"}

package/dist/context.d.ts

@@ -1,15 +1,27 @@
-import { BodyInit } from 'bun';
+import { BodyInit, Server } from 'bun';
 import { ShokupanRequest } from './request';
 import { ShokupanResponse } from './response';
-import { CookieOptions } from './types';
+import { Shokupan } from './shokupan';
+import { CookieOptions, JSXRenderer } from './types';
 type HeadersInit = Headers | Record<string, string> | [string, string][];
+export interface HandlerStackItem {
+    name: string;
+    file: string;
+    line: number;
+    stateChanges?: Record<string, any>;
+}
 export declare class ShokupanContext<State extends Record<string, any> = Record<string, any>> {
     readonly request: ShokupanRequest<any>;
-    readonly url: URL;
+    readonly server?: Server;
+    readonly app?: Shokupan;
+    private _url;
     params: Record<string, string>;
     state: State;
+    handlerStack: HandlerStackItem[];
     readonly response: ShokupanResponse;
-    constructor(request: ShokupanRequest<any>, state?: State);
+    _finalResponse?: Response;
+    constructor(request: ShokupanRequest<any>, server?: Server, state?: State, app?: Shokupan, enableMiddlewareTracking?: boolean);
+    get url(): URL;
     /**
      * Base request
      */
@@ -21,23 +33,54 @@ export declare class ShokupanContext<State extends Record<string, any> = Record<
     /**
      * Request path
      */
-    get path(): string;
+    get path(): any;
     /**
      * Request query params
      */
     get query(): {
         [k: string]: string;
     };
+    /**
+     * Client IP address
+     */
+    get ip(): Bun.SocketAddress;
+    /**
+     * Request hostname (e.g. "localhost")
+     */
+    get hostname(): string;
+    /**
+     * Request host (e.g. "localhost:3000")
+     */
+    get host(): string;
+    /**
+     * Request protocol (e.g. "http:", "https:")
+     */
+    get protocol(): string;
+    /**
+     * Whether request is secure (https)
+     */
+    get secure(): boolean;
+    /**
+     * Request origin (e.g. "http://localhost:3000")
+     */
+    get origin(): string;
     /**
      * Request headers
      */
     get headers(): any;
+    /**
+     * Get a request header
+     * @param name Header name
+     */
+    get(name: string): any;
     /**
      * Base response object
      */
     get res(): ShokupanResponse;
     /**
      * Helper to set a header on the response
+     * @param key Header key
+     * @param value Header value
      */
     set(key: string, value: string): this;
     /**
@@ -84,5 +127,16 @@ export declare class ShokupanContext<State extends Record<string, any> = Record<
      * Respond with a file
      */
     file(path: string, fileOptions?: BlobPropertyBag, responseOptions?: ResponseInit): Response;
+    /**
+     * JSX Rendering Function
+     */
+    renderer?: JSXRenderer;
+    /**
+     * Render a JSX element
+     * @param element JSX Element
+     * @param status HTTP Status
+     * @param headers HTTP Headers
+     */
+    jsx(element: any, args?: Parameters<JSXRenderer>[1], status?: number, headers?: HeadersInit): Promise<Response>;
 }
 export {};

package/dist/decorators.d.ts

@@ -1,4 +1,4 @@
-import { Middleware } from './types';
+import { GuardAPISpec, MethodAPISpec, Middleware } from './types';
 /**
  * Class Decorator: Defines the base path for a controller.
  */
@@ -13,6 +13,10 @@ export declare const Query: (name?: string) => (target: any, propertyKey: string
 export declare const Headers: (name?: string) => (target: any, propertyKey: string, parameterIndex: number) => void;
 export declare const Req: (name?: string) => (target: any, propertyKey: string, parameterIndex: number) => void;
 export declare const Ctx: (name?: string) => (target: any, propertyKey: string, parameterIndex: number) => void;
+/**
+ * Decorator: Overrides the OpenAPI specification for a route.
+ */
+export declare function Spec(spec: MethodAPISpec | GuardAPISpec): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
 export declare const Get: (path?: string) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
 export declare const Post: (path?: string) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
 export declare const Put: (path?: string) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;