shokupan 0.9.0 → 0.10.0

package/dist/plugins/application/dashboard/plugin.d.ts

@@ -1,4 +1,5 @@
 import { HeadersInit } from 'bun';
+import { $appRoot } from '../../../util/symbol';
 import { ShokupanHooks, ShokupanPlugin } from '../../../util/types';
 export interface RequestLog {
     method: string;
@@ -15,21 +16,30 @@ export interface DashboardConfig {
      * Retention time in milliseconds
      */
     retentionMs?: number;
+    integrations?: {
+        scalar?: boolean | {
+            path?: string;
+        };
+        asyncapi?: boolean | {
+            path?: string;
+        };
+    };
 }
 export declare class Dashboard implements ShokupanPlugin {
     private readonly dashboardConfig;
-    private static __dirname;
-    private static getBasePath;
+    private [$appRoot];
     private router;
     private metrics;
-    private eta;
     private startTime;
     private instrumented;
     private metricsCollector;
+    get db(): import('../../../util/datastore').SurrealDatastore;
     constructor(dashboardConfig?: DashboardConfig);
     onInit(app: any, options?: {
         path?: string;
     }): void;
+    private detectIntegrations;
+    private static getBasePath;
     private setupRoutes;
     private instrumentApp;
     private assignIdsToRegistry;

package/dist/plugins/application/dashboard/static/registry.css

@@ -43,59 +43,6 @@
     font-weight: bold;
 }
 
-.badge-GET {
-    background: #0f172a;
-    color: #3b82f6;
-    border: 1px solid #3b82f6;
-}
-
-.badge-POST {
-    background: #0f172a;
-    color: #22c55e;
-    border: 1px solid #22c55e;
-}
-
-.badge-PUT {
-    background: #0f172a;
-    color: #eab308;
-    border: 1px solid #eab308;
-}
-
-.badge-PATCH {
-    background: #0f172a;
-    color: #08d3ea;
-    border: 1px solid #08eae6;
-}
-
-.badge-HEAD {
-    background: #0f172a;
-    color: #e3ea08;
-    border: 1px solid #e3ea08;
-}
-
-.badge-OPTIONS {
-    background: #0f172a;
-    color: #838383;
-    border: 1px solid #838383;
-}
-
-.badge-DELETE {
-    background: #0f172a;
-    color: #ef4444;
-    border: 1px solid #ef4444;
-}
-
-.badge-ROUTER {
-    background: #334155;
-    color: #f8fafc;
-}
-
-.badge-CONTROLLER {
-    background: #475569;
-    color: #f8fafc;
-}
-
-
 /* Tooltip Styling */
 .tooltip {
     position: relative;

package/dist/plugins/application/dashboard/static/styles.css

@@ -1,14 +1,4 @@
-:root {
-    --bg-primary: #0f172a;
-    --bg-secondary: #1e293b;
-    --text-primary: #f8fafc;
-    --text-secondary: #94a3b8;
-    --text-emphasis: #60a5fa;
-    --accent: #3b82f6;
-    --success: #22c55e;
-    --error: #ef4444;
-    --card-border: #334155;
-}
+/* :root variables are now provided by theme.css */
 
 * {
     box-sizing: border-box;
@@ -27,21 +17,30 @@ body {
     font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
     background-color: var(--bg-primary);
     color: var(--text-primary);
-    min-height: 100vh;
-    padding: 2rem;
+    height: 100vh;
+    overflow: hidden;
 }
 
 header {
-    margin-bottom: 2rem;
+    width: 100%;
+    background-color: var(--bg-header);
+    padding: 0 1rem;
     display: flex;
     justify-content: space-between;
     align-items: center;
 }
 
+iframe {
+    flex: 1;
+    width: 100%;
+    height: 100%;
+    border: none;
+}
+
 h1 {
     font-size: 2rem;
     font-weight: 700;
-    background: linear-gradient(to right, var(--accent), #8b5cf6);
+    background: linear-gradient(to right, var(--accent), var(--primary));
     -webkit-background-clip: text;
     background-clip: text;
     color: transparent;
@@ -55,9 +54,8 @@ select {
     display: flex;
     flex: 1;
     flex-direction: column;
-    max-width: 1200px;
-    margin: 0 auto;
-    overflow: auto
+    align-items: center;
+    overflow: hidden;
 }
 
 .metrics-grid {
@@ -92,7 +90,6 @@ select {
     color: var(--text-secondary);
     font-size: 0.875rem;
     margin-bottom: 0.5rem;
-    text-transform: uppercase;
     letter-spacing: 0.05em;
     height: 48px;
     line-height: 48px;
@@ -142,6 +139,10 @@ select {
     transition: all 0.2s;
 }
 
+.tab-btn:focus-visible {
+    outline: none;
+}
+
 .tab-btn:hover {
     color: var(--text-primary);
 }
@@ -153,12 +154,20 @@ select {
 
 .tab-content {
     display: none;
+    flex-direction: column;
+    flex: 1;
+    overflow: auto;
+    width: -webkit-fill-available;
+    /* width: 1200px; */
+    max-width: 1200px;
+    margin: 0 2rem;
 }
 
 .tab-content.active {
-    display: block;
+    display: flex;
 }
 
+
 /* Graph */
 #cy {
     width: 100%;

package/dist/plugins/application/dashboard/static/tabulator.css

@@ -1,66 +1,118 @@
+/* Tabulator Theme Overrides - Merged with Layout */
 .tabulator {
     height: 100%;
     width: 100%;
-    background-color: #0f1322;
-}
-
-.tabulator .tabulator-tableholder .tabulator-table {
-    color: #ccc;
-    background-color: #0f1322;
+    background-color: var(--bg-card);
+    border: 1px solid var(--card-border);
+    color: var(--text-primary);
 }
 
+/* Header */
 .tabulator .tabulator-header {
-    color: #ddd;
-    background-color: #0f1322;
-    border-top-color: #0b0b18;
-    border-bottom-color: #0b0b18;
+    background-color: var(--bg-card);
+    border-top: 0;
+    border-bottom: 2px solid var(--table-header-border-color);
+    color: var(--primary);
+    font-weight: bold;
 }
 
 .tabulator .tabulator-header .tabulator-col {
-    border-right-color: #15162f;
-    background-color: #0f1322;
+    background-color: var(--bg-card);
+    border-right: 1px solid var(--card-border);
+}
+
+.tabulator .tabulator-header .tabulator-col:hover {
+    background-color: var(--bg-primary);
 }
 
+.tabulator .tabulator-header .tabulator-col-content {
+    padding: 12px;
+}
+
+/* Sortable Columns */
 .tabulator .tabulator-header .tabulator-col.tabulator-sortable[aria-sort=none] .tabulator-col-content .tabulator-col-sorter {
-    color: #0d0f20;
+    color: var(--text-secondary);
 }
 
 .tabulator .tabulator-header .tabulator-col.tabulator-sortable.tabulator-col-sorter-element:hover {
-    background-color: #111427;
+    background-color: var(--bg-primary);
 }
 
+/* Filter Inputs */
+.tabulator .tabulator-header .tabulator-col .tabulator-header-filter input {
+    background-color: var(--bg-primary);
+    color: var(--text-primary);
+    border: 1px solid var(--card-border);
+}
+
+.tabulator .tabulator-header .tabulator-col .tabulator-header-filter input:focus {
+    background-color: var(--bg-secondary);
+    color: var(--text-primary);
+    border-color: var(--primary);
+    outline: none;
+}
+
+/* Rows */
 .tabulator .tabulator-row {
-    border-bottom-color: #0c0d23;
+    background-color: var(--bg-card);
+    border-bottom: 1px solid var(--card-border);
+    color: var(--text-primary);
     transition: background-color 100ms ease;
 }
 
-.tabulator .tabulator-row .tabulator-cell {
-    border-right-color: #11152c;
-    align-content: center;
+/* Higher specificity to override Tabulator default themes */
+.tabulator .tabulator-row.tabulator-row-even,
+.tabulator-row.tabulator-row-even {
+    background-color: var(--bg-primary) !important;
+}
+
+.tabulator .tabulator-row.tabulator-row-odd,
+.tabulator-row.tabulator-row-odd {
+    background-color: var(--bg-card) !important;
+}
+
+.tabulator .tabulator-row.tabulator-selected {
+    background-color: var(--bg-primary) !important;
+    color: var(--text-primary);
 }
 
 .tabulator .tabulator-row:hover {
-    background-color: #202540 !important;
+    background-color: var(--bg-primary) !important;
+    color: var(--text-primary);
+    cursor: pointer;
 }
 
-.tabulator .tabulator-row.tabulator-row-even {
-    background-color: #1c1e2c;
+/* Cells */
+.tabulator .tabulator-row .tabulator-cell {
+    border-right: 1px solid var(--card-border);
+    padding: 10px;
+    align-content: center;
 }
 
-.tabulator .tabulator-row.tabulator-row-odd {
-    background-color: #171824;
+/* Footer / Pagination */
+.tabulator .tabulator-footer {
+    background-color: var(--bg-card);
+    border-top: 2px solid var(--table-header-border-color);
 }
 
-.tabulator .tabulator-row.tabulator-selected {
-    background-color: #252a43;
+.tabulator .tabulator-footer .tabulator-page {
+    background-color: var(--bg-primary);
+    color: var(--text-primary);
+    border: 1px solid var(--border-color);
+    border-radius: 4px;
 }
 
-.tabulator .tabulator-header .tabulator-col .tabulator-header-filter input {
-    background-color: #0e1016ff;
-    color: #ccc;
+.tabulator .tabulator-footer .tabulator-page:hover {
+    background-color: var(--table-header-border-color);
+    color: var(--text-primary);
 }
 
-.tabulator .tabulator-header .tabulator-col .tabulator-header-filter input:focus {
-    background-color: #212637ff;
-    color: #fff
+.tabulator .tabulator-footer .tabulator-page.active {
+    background-color: var(--primary);
+    color: var(--bg-card);
+}
+
+/* Sorting Icons */
+.tabulator .tabulator-header .tabulator-col .tabulator-col-content .tabulator-arrow {
+    border-bottom-color: var(--text-secondary);
 }

package/dist/plugins/application/dashboard/static/theme.css

@@ -0,0 +1,128 @@
+:root {
+    /* Raw Palette - Dark (Now Default) */
+    --palette-dark-primary: #FFB380;
+    /* Warm Filament */
+    --palette-dark-secondary: #7B5E7B;
+    /* Yeast Purple */
+    --palette-dark-accent: #D6D3D1;
+    /* Flour Dust */
+    --palette-dark-bg: #1A1614;
+    /* Oven Depth */
+    --palette-dark-card: #2A2421;
+
+    --palette-dark-header: rgb(39, 27, 19);
+    /* Proofing Drawer */
+
+    /* Universal defaults (tokens) */
+    --shokupan-font: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;
+
+    /* Theme Variables - Enforced Dark Mode */
+    --bg-primary: var(--palette-dark-bg);
+    --bg-secondary: var(--palette-dark-card);
+    --bg-card: var(--palette-dark-card);
+    --bg-header: var(--palette-dark-header);
+
+    --text-primary: #F0F0F0;
+    --text-secondary: var(--palette-dark-accent);
+    --text-muted: rgba(214, 211, 209, 0.5);
+
+    --primary: var(--palette-dark-primary);
+    --secondary: var(--palette-dark-secondary);
+    --accent: var(--palette-dark-accent);
+
+    --border-color: rgba(214, 211, 209, 0.2);
+    --card-border: rgba(214, 211, 209, 0.2);
+
+    --table-header-border-color: rgba(214, 211, 209, 0.2);
+
+    --link-color: var(--palette-dark-primary);
+    --link-hover: #FFCBA0;
+
+    --button-bg: var(--palette-dark-primary);
+    --button-text: #1A1614;
+}
+
+::-webkit-scrollbar {
+    width: 8px;
+    height: 8px;
+    background-color: var(--bg-primary);
+}
+
+::-webkit-scrollbar-thumb {
+    border-radius: 10px;
+    background-color: var(--primary);
+    box-shadow: inset 0 0 6px rgba(0, 0, 0, 0.3);
+}
+
+::-webkit-scrollbar-track {
+    border-radius: 10px;
+    background-color: var(--bg-secondary);
+}
+
+::-webkit-scrollbar-corner {
+    box-shadow: inset 0 0 6px rgba(0, 0, 0, 0.3);
+}
+
+.badge-SEND {
+    background: rgba(59, 130, 246, 0.15);
+    color: #60a5fa;
+    border: 1px solid rgba(59, 130, 246, 0.3);
+}
+
+.badge-RECV {
+    background: rgba(16, 185, 129, 0.15);
+    color: #34d399;
+    border: 1px solid rgba(16, 185, 129, 0.3);
+}
+
+.badge-GET {
+    background: #0f172a;
+    color: #3b82f6;
+    border: 1px solid #3b82f6;
+}
+
+.badge-POST {
+    background: #0f172a;
+    color: #22c55e;
+    border: 1px solid #22c55e;
+}
+
+.badge-PUT {
+    background: #0f172a;
+    color: #eab308;
+    border: 1px solid #eab308;
+}
+
+.badge-PATCH {
+    background: #0f172a;
+    color: #08d3ea;
+    border: 1px solid #08eae6;
+}
+
+.badge-HEAD {
+    background: #0f172a;
+    color: #e3ea08;
+    border: 1px solid #e3ea08;
+}
+
+.badge-OPTIONS {
+    background: #0f172a;
+    color: #838383;
+    border: 1px solid #838383;
+}
+
+.badge-DELETE {
+    background: #0f172a;
+    color: #ef4444;
+    border: 1px solid #ef4444;
+}
+
+.badge-ROUTER {
+    background: #334155;
+    color: #f8fafc;
+}
+
+.badge-CONTROLLER {
+    background: #475569;
+    color: #f8fafc;
+}

package/dist/plugins/application/graphql-apollo.d.ts

@@ -0,0 +1,33 @@
+import { ApolloServer } from '@apollo/server';
+import { ShokupanRouter } from '../../router';
+import { Shokupan } from '../../shokupan';
+import { ShokupanPlugin, ShokupanPluginOptions } from '../../util/types';
+export interface GraphQLPluginOptions {
+    /**
+     * Path to mount the GraphQL endpoint to.
+     * @default '/graphql'
+     */
+    path?: string;
+    /**
+     * GraphQL Type Definitions
+     */
+    typeDefs: any;
+    /**
+     * GraphQL Resolvers
+     */
+    resolvers: any;
+    /**
+     * Optional Apollo Server configuration
+     */
+    apolloConfig?: Omit<ConstructorParameters<typeof ApolloServer>[0], 'typeDefs' | 'resolvers'>;
+}
+/**
+ * GraphQL Apollo Server Plugin for Shokupan.
+ * Enables serving GraphQL APIs using Apollo Server 4.
+ */
+export declare class GraphQLApolloPlugin extends ShokupanRouter<any> implements ShokupanPlugin {
+    private pluginOptions;
+    private apolloServer;
+    constructor(pluginOptions: GraphQLPluginOptions);
+    onInit(app: Shokupan, options?: ShokupanPluginOptions): Promise<void>;
+}

package/dist/plugins/application/graphql-yoga.d.ts

@@ -0,0 +1,25 @@
+import { YogaServerOptions } from 'graphql-yoga';
+import { ShokupanRouter } from '../../router';
+import { Shokupan } from '../../shokupan';
+import { ShokupanPlugin, ShokupanPluginOptions } from '../../util/types';
+export interface GraphQLYogaPluginOptions {
+    /**
+     * Path to mount the GraphQL endpoint to.
+     * @default '/graphql'
+     */
+    path?: string;
+    /**
+     * Yoga Server configuration
+     */
+    yogaConfig: YogaServerOptions<any, any>;
+}
+/**
+ * GraphQL Yoga Plugin for Shokupan.
+ * Enables serving GraphQL APIs using GraphQL Yoga.
+ */
+export declare class GraphQLYogaPlugin extends ShokupanRouter<any> implements ShokupanPlugin {
+    private pluginOptions;
+    private yoga;
+    constructor(pluginOptions: GraphQLYogaPluginOptions);
+    onInit(app: Shokupan, options?: ShokupanPluginOptions): Promise<void>;
+}

package/dist/plugins/application/openapi/analyzer.d.ts

@@ -1,133 +1,27 @@
+import { ApplicationInstance } from './analyzer.impl';
+export type { ApplicationInstance, RouteInfo } from './analyzer.impl';
 /**
- * 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
+ * OpenAPI Analyzer Wrapper.
+ *
+ * This class wraps the actual OpenAPIAnalyzer implementation to facilitate
+ * lazy loading of the 'typescript' peer dependency. The actual implementation
+ * and the 'typescript' module are only loaded when `analyze()` is called.
  */
 export declare class OpenAPIAnalyzer {
     private rootDir;
-    private files;
-    private applications;
-    private program?;
     private entrypoint?;
+    private analyzerImpl;
     constructor(rootDir: string, entrypoint?: string);
     /**
-     * Main analysis entry point
-     */
-    /**
-     * Main analysis entry point
+     * Main analysis entry point.
+     * Dynamically imports the implementation and runs the analysis.
      */
     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
+     * Generate OpenAPI specification.
+     * Must be called after analyze().
      */
     generateOpenAPISpec(): any;
 }
@@ -135,4 +29,3 @@ export declare class OpenAPIAnalyzer {
  * Analyze a directory and generate OpenAPI spec
  */
 export declare function analyzeDirectory(directory: string): Promise<any>;
-export {};