@supernal/interface 1.0.0

package/dist/cjs/src/routes/scanners/NameExtractor.js

@@ -0,0 +1,193 @@
+"use strict";
+// Generated from: 2025-12-28-simple-name-extraction.md
+// Generated on: 2025-12-29
+// DO NOT EDIT - Regenerate from documentation if changes needed
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NameExtractor = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Extract route names from existing code
+ * No decorators, no metadata - just find what's already named
+ */
+class NameExtractor {
+    /**
+     * Extract array literals from source files
+     * Example: const VALID_VIEWS = ['overview', 'planning', ...]
+     */
+    extractArrayLiteral(filePath, variableName) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            // Match: export const VALID_VIEWS = ['item1', 'item2', ...]
+            const pattern = new RegExp(`(?:export\\s+)?const\\s+${variableName}\\s*=\\s*\\[([^\\]]+)\\]`, 's');
+            const match = content.match(pattern);
+            if (!match)
+                return [];
+            // Parse string literals: 'item1', "item2", `item3`
+            const arrayContent = match[1];
+            const stringPattern = /['"`]([^'"`]+)['"`]/g;
+            const names = [];
+            let stringMatch;
+            while ((stringMatch = stringPattern.exec(arrayContent)) !== null) {
+                names.push(stringMatch[1]);
+            }
+            return names;
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Extract routes from Next.js app directory structure
+     * Finds: app/api/[param]/route.ts
+     */
+    extractAppDirectoryRoutes(appDir, prefix = '') {
+        const routes = [];
+        const walkDir = (dir, currentPath = '') => {
+            if (!fs.existsSync(dir))
+                return;
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                const routePath = path.join(currentPath, entry.name);
+                if (entry.isDirectory()) {
+                    // Recurse into subdirectories
+                    walkDir(fullPath, routePath);
+                }
+                else if (entry.name === 'route.ts' || entry.name === 'route.js') {
+                    // Found a route file
+                    const segments = currentPath.split(path.sep).filter(s => s);
+                    const pattern = this.buildRoutePattern(segments, prefix);
+                    const params = this.extractParams(segments);
+                    const name = this.buildRouteName(segments);
+                    const methods = this.extractHttpMethods(fullPath);
+                    routes.push({
+                        name,
+                        pattern,
+                        params,
+                        methods,
+                        sourceFile: fullPath
+                    });
+                }
+            }
+        };
+        walkDir(appDir);
+        return routes;
+    }
+    /**
+     * Extract HTTP methods from a Next.js route file
+     * Supports multiple export patterns:
+     * - export async function GET/POST/etc(...)
+     * - export function GET/POST/etc(...)
+     * - export const GET/POST/etc = ...
+     * - export { handler as GET, handler as POST }
+     * - export const { GET, POST } = handlers
+     */
+    extractHttpMethods(routeFilePath) {
+        try {
+            const content = fs.readFileSync(routeFilePath, 'utf-8');
+            const methods = [];
+            const httpMethods = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS'];
+            for (const method of httpMethods) {
+                // Pattern 1: export async function GET( or export function GET(
+                const functionPattern = new RegExp(`export\\s+(?:async\\s+)?function\\s+${method}\\s*\\(`, 'm');
+                // Pattern 2: export const GET = ...
+                const constPattern = new RegExp(`export\\s+const\\s+${method}\\s*=`, 'm');
+                // Pattern 3: export { ... as GET, ... }
+                const reExportPattern = new RegExp(`export\\s*\\{[^}]*\\s+as\\s+${method}[,\\s}]`, 'm');
+                // Pattern 4: export const { GET, POST } = ...
+                const destructurePattern = new RegExp(`export\\s+const\\s*\\{[^}]*\\b${method}\\b[^}]*\\}`, 'm');
+                if (functionPattern.test(content) ||
+                    constPattern.test(content) ||
+                    reExportPattern.test(content) ||
+                    destructurePattern.test(content)) {
+                    methods.push(method);
+                }
+            }
+            return methods.length > 0 ? methods : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    buildRoutePattern(segments, prefix) {
+        const pathSegments = segments.map(seg => {
+            // [param] → :param
+            if (seg.startsWith('[') && seg.endsWith(']')) {
+                const param = seg.slice(1, -1);
+                // [[...catch]] → *catchAll (optional catch-all)
+                if (param.startsWith('[...') && param.endsWith(']')) {
+                    return `:${param.slice(4, -1)}*?`;
+                }
+                // [...catch] → *catchAll (required catch-all)
+                if (param.startsWith('...')) {
+                    return `:${param.slice(3)}*`;
+                }
+                // [param] → :param
+                return `:${param}`;
+            }
+            return seg;
+        });
+        return prefix + '/' + pathSegments.join('/');
+    }
+    extractParams(segments) {
+        return segments
+            .filter(seg => seg.startsWith('[') && seg.endsWith(']'))
+            .map(seg => {
+            const param = seg.slice(1, -1);
+            if (param.startsWith('...'))
+                return param.slice(3);
+            if (param.startsWith('[...') && param.endsWith(']')) {
+                return param.slice(4, -1);
+            }
+            return param;
+        });
+    }
+    buildRouteName(segments) {
+        // Convert path segments to PascalCase name
+        // api/[repoId]/requirements → RepoIdRequirements
+        return segments
+            .map(seg => {
+            // Strip brackets and dots: [repoId] → repoId
+            const clean = seg.replace(/[[\].]/g, '');
+            // PascalCase: repoId → RepoId
+            return clean.charAt(0).toUpperCase() + clean.slice(1);
+        })
+            .join('');
+    }
+}
+exports.NameExtractor = NameExtractor;
+//# sourceMappingURL=NameExtractor.js.map

package/dist/cjs/src/routes/scanners/NameExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NameExtractor.js","sourceRoot":"","sources":["../../../../../src/routes/scanners/NameExtractor.ts"],"names":[],"mappings":"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"}

package/dist/cjs/src/routes/scanners/NextjsDynamicScanner.js

@@ -0,0 +1,102 @@
+"use strict";
+// Generated from: 2025-12-28-simple-name-extraction.md
+// Generated on: 2025-12-28
+// DO NOT EDIT - Regenerate from documentation if changes needed
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NextjsDynamicScanner = void 0;
+const RouteScanner_1 = require("./RouteScanner");
+const NameExtractor_1 = require("./NameExtractor");
+/**
+ * Scanner that extracts route names from Next.js applications.
+ *
+ * Supports two discovery strategies:
+ * 1. VALID_VIEWS arrays - Extracts view names from configuration files
+ * 2. App directory structure - Scans Next.js App Router directories for API routes
+ *
+ * @example
+ * ```typescript
+ * import { NextjsDynamicScanner } from '@supernal/interface-core/routes';
+ *
+ * const scanner = new NextjsDynamicScanner({
+ *   routingSystem: 'nextjs-name-extraction',
+ *   scanPaths: {
+ *     configs: ['src/lib/routing/slugService.ts'],  // Contains VALID_VIEWS
+ *     routes: ['src/app/api']                        // API routes directory
+ *   },
+ *   output: {
+ *     contractsPath: 'src/lib/routing/Routes.ts',
+ *     moduleFormat: 'esm'
+ *   }
+ * });
+ *
+ * const result = await scanner.scan();
+ * // result.routes contains all discovered routes
+ * ```
+ */
+class NextjsDynamicScanner extends RouteScanner_1.RouteScanner {
+    constructor() {
+        super(...arguments);
+        this.extractor = new NameExtractor_1.NameExtractor();
+    }
+    getName() {
+        return 'Next.js Name Extraction Scanner';
+    }
+    async scan() {
+        const routes = [];
+        // Strategy 1: Extract from VALID_VIEWS array
+        if (this.config.scanPaths.configs) {
+            for (const configPath of this.config.scanPaths.configs) {
+                const viewNames = this.extractor.extractArrayLiteral(configPath, 'VALID_VIEWS');
+                viewNames.forEach(view => {
+                    routes.push({
+                        id: `view-${view}`,
+                        pattern: `/:repo/:branch/${view}`,
+                        params: ['repo', 'branch'],
+                        metadata: {
+                            category: 'view',
+                            source: 'VALID_VIEWS',
+                        },
+                    });
+                });
+            }
+        }
+        // Strategy 2: Extract from app directory structure
+        if (this.config.scanPaths.routes) {
+            for (const routePath of this.config.scanPaths.routes) {
+                // Don't add prefix - let the directory structure determine the route
+                const appRoutes = this.extractor.extractAppDirectoryRoutes(routePath, '' // Empty prefix - routes are determined by directory structure
+                );
+                appRoutes.forEach(route => {
+                    routes.push({
+                        id: `api-${route.name}`,
+                        pattern: route.pattern,
+                        params: route.params,
+                        metadata: {
+                            category: 'api',
+                            source: 'file-structure',
+                            methods: route.methods,
+                            sourceFile: route.sourceFile,
+                        },
+                    });
+                });
+            }
+        }
+        return {
+            routes,
+            metadata: {
+                timestamp: new Date().toISOString(),
+                scannedPaths: [
+                    ...(this.config.scanPaths.configs || []),
+                    ...(this.config.scanPaths.routes || []),
+                ],
+                routingSystem: 'nextjs-name-extraction',
+            },
+        };
+    }
+    async validate(routes) {
+        // Basic validation - check all routes have patterns and ids
+        return routes.every(route => route.id && route.pattern);
+    }
+}
+exports.NextjsDynamicScanner = NextjsDynamicScanner;
+//# sourceMappingURL=NextjsDynamicScanner.js.map

package/dist/cjs/src/routes/scanners/NextjsDynamicScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NextjsDynamicScanner.js","sourceRoot":"","sources":["../../../../../src/routes/scanners/NextjsDynamicScanner.ts"],"names":[],"mappings":";AAAA,uDAAuD;AACvD,2BAA2B;AAC3B,gEAAgE;;;AAEhE,iDAA0E;AAC1E,mDAAgD;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAa,oBAAqB,SAAQ,2BAAY;IAAtD;;QACU,cAAS,GAAG,IAAI,6BAAa,EAAE,CAAC;IAyE1C,CAAC;IAvEC,OAAO;QACL,OAAO,iCAAiC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAgB,EAAE,CAAC;QAE/B,6CAA6C;QAC7C,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YAClC,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;gBACvD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAClD,UAAU,EACV,aAAa,CACd,CAAC;gBAEF,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;oBACvB,MAAM,CAAC,IAAI,CAAC;wBACV,EAAE,EAAE,QAAQ,IAAI,EAAE;wBAClB,OAAO,EAAE,kBAAkB,IAAI,EAAE;wBACjC,MAAM,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;wBAC1B,QAAQ,EAAE;4BACR,QAAQ,EAAE,MAAM;4BAChB,MAAM,EAAE,aAAa;yBACtB;qBACF,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,mDAAmD;QACnD,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YACjC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;gBACrD,qEAAqE;gBACrE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,yBAAyB,CACxD,SAAS,EACT,EAAE,CAAE,8DAA8D;iBACnE,CAAC;gBAEF,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;oBACxB,MAAM,CAAC,IAAI,CAAC;wBACV,EAAE,EAAE,OAAO,KAAK,CAAC,IAAI,EAAE;wBACvB,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,QAAQ,EAAE;4BACR,QAAQ,EAAE,KAAK;4BACf,MAAM,EAAE,gBAAgB;4BACxB,OAAO,EAAE,KAAK,CAAC,OAAO;4BACtB,UAAU,EAAE,KAAK,CAAC,UAAU;yBAC7B;qBACF,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM;YACN,QAAQ,EAAE;gBACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,YAAY,EAAE;oBACZ,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC;oBACxC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC;iBACxC;gBACD,aAAa,EAAE,wBAAwB;aACxC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAmB;QAChC,4DAA4D;QAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;CACF;AA1ED,oDA0EC"}

package/dist/cjs/src/routes/scanners/RouteScanner.js

@@ -0,0 +1,13 @@
+"use strict";
+// Generated from: 2025-12-27-implementation.md
+// Generated on: 2025-12-28
+// DO NOT EDIT - Regenerate from documentation if changes needed
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouteScanner = void 0;
+class RouteScanner {
+    constructor(config) {
+        this.config = config;
+    }
+}
+exports.RouteScanner = RouteScanner;
+//# sourceMappingURL=RouteScanner.js.map

package/dist/cjs/src/routes/scanners/RouteScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteScanner.js","sourceRoot":"","sources":["../../../../../src/routes/scanners/RouteScanner.ts"],"names":[],"mappings":";AAAA,+CAA+C;AAC/C,2BAA2B;AAC3B,gEAAgE;;;AAkEhE,MAAsB,YAAY;IAChC,YAAsB,MAA4B;QAA5B,WAAM,GAAN,MAAM,CAAsB;IAAG,CAAC;CAgBvD;AAjBD,oCAiBC"}

package/dist/cjs/src/storage/LocalStorageAdapter.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * LocalStorageAdapter - Browser-only storage using localStorage
+ *
+ * Safe for browser bundling - no Node.js dependencies
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalStorageAdapter = void 0;
+/**
+ * Storage adapter using browser localStorage
+ * Compatible with SSR - checks for window availability
+ */
+class LocalStorageAdapter {
+    constructor(prefix = 'supernal_') {
+        this.prefix = prefix;
+    }
+    getKey(key) {
+        return `${this.prefix}${key}`;
+    }
+    async get(key) {
+        if (typeof window === 'undefined')
+            return null;
+        try {
+            const item = localStorage.getItem(this.getKey(key));
+            return item ? JSON.parse(item) : null;
+        }
+        catch (e) {
+            // eslint-disable-next-line no-console
+            console.error('[LocalStorageAdapter] Failed to get:', key, e);
+            return null;
+        }
+    }
+    async set(key, value) {
+        if (typeof window === 'undefined')
+            return;
+        try {
+            localStorage.setItem(this.getKey(key), JSON.stringify(value));
+        }
+        catch (e) {
+            // eslint-disable-next-line no-console
+            console.error('[LocalStorageAdapter] Failed to set:', key, e);
+            throw e;
+        }
+    }
+    async delete(key) {
+        if (typeof window === 'undefined')
+            return;
+        try {
+            localStorage.removeItem(this.getKey(key));
+        }
+        catch (e) {
+            // eslint-disable-next-line no-console
+            console.error('[LocalStorageAdapter] Failed to delete:', key, e);
+        }
+    }
+    async clear() {
+        if (typeof window === 'undefined')
+            return;
+        try {
+            const keys = await this.keys();
+            keys.forEach(key => localStorage.removeItem(this.getKey(key)));
+        }
+        catch (e) {
+            // eslint-disable-next-line no-console
+            console.error('[LocalStorageAdapter] Failed to clear:', e);
+        }
+    }
+    async has(key) {
+        if (typeof window === 'undefined')
+            return false;
+        return localStorage.getItem(this.getKey(key)) !== null;
+    }
+    async keys() {
+        if (typeof window === 'undefined')
+            return [];
+        const allKeys = [];
+        for (let i = 0; i < localStorage.length; i++) {
+            const key = localStorage.key(i);
+            if (key && key.startsWith(this.prefix)) {
+                allKeys.push(key.substring(this.prefix.length));
+            }
+        }
+        return allKeys;
+    }
+}
+exports.LocalStorageAdapter = LocalStorageAdapter;
+//# sourceMappingURL=LocalStorageAdapter.js.map

package/dist/cjs/src/storage/LocalStorageAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalStorageAdapter.js","sourceRoot":"","sources":["../../../../src/storage/LocalStorageAdapter.ts"],"names":[],"mappings":"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"}