@vurb/core 3.2.0

package/dist/cli/templates/vectors/database.js

@@ -0,0 +1,82 @@
+/**
+ * Database Vector — Prisma schema + DB tool templates
+ * @module
+ */
+/** Generate `prisma/schema.prisma` */
+export function prismaSchema() {
+    return `// Prisma Schema — Database-Driven MCP Server
+//
+// The @vurb/prisma-gen generator reads annotations
+// and auto-generates Presenters + ToolBuilders with:
+// - Field-level security (/// @vurb.hide)
+// - Tenant isolation
+// - OOM protection
+
+generator client {
+    provider = "prisma-client-js"
+}
+
+generator vurb {
+    provider = "@vurb/prisma-gen"
+}
+
+datasource db {
+    provider = "postgresql"
+    url      = env("DATABASE_URL")
+}
+
+model User {
+    id        String   @id @default(cuid())
+    email     String   @unique
+    name      String
+
+    /// @vurb.hide — Stripped by the Egress Firewall before reaching the LLM
+    password  String
+
+    role      String   @default("USER")
+    createdAt DateTime @default(now())
+    updatedAt DateTime @updatedAt
+
+    posts     Post[]
+}
+
+model Post {
+    id        String   @id @default(cuid())
+    title     String
+    content   String?
+    published Boolean  @default(false)
+    createdAt DateTime @default(now())
+
+    author    User     @relation(fields: [authorId], references: [id])
+    authorId  String
+}
+`;
+}
+/** Generate `src/tools/db/users.ts` */
+export function dbUsersToolTs() {
+    return `/**
+ * Database Users Tool — Prisma-Driven CRUD (Fluent API)
+ *
+ * Demonstrates:
+ * - f.query() with .withOptionalNumber() typed parameter
+ * - .handle(input, ctx) — input.take is typed as number | undefined
+ * - Implicit success() wrapping
+ */
+import { f } from '../../vurb.js';
+
+export default f.query('db.list_users')
+    .describe('List users from the database')
+    .withOptionalNumber('take', 'Max results (1-50)')
+    .handle(async (input, ctx) => {
+        // TODO: Replace with your Prisma client
+        // const users = await ctx.db.user.findMany({ take: input.take ?? 10 });
+        // return users;
+
+        return {
+            hint: 'Connect your Prisma client in src/context.ts to enable database queries.',
+            example: 'const users = await ctx.db.user.findMany({ take: 10 })',
+        };
+    });
+`;
+}
+//# sourceMappingURL=database.js.map

package/dist/cli/templates/vectors/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../../src/cli/templates/vectors/database.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sCAAsC;AACtC,MAAM,UAAU,YAAY;IACxB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CV,CAAC;AACF,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,aAAa;IACzB,OAAO;;;;;;;;;;;;;;;;;;;;;;;CAuBV,CAAC;AACF,CAAC"}

package/dist/cli/templates/vectors/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Vector Templates — Barrel Export
+ * @module
+ */
+export { prismaSchema, dbUsersToolTs } from './database.js';
+export { n8nConnectorTs } from './workflow.js';
+export { openapiYaml, openapiSetupMd } from './openapi.js';
+export { oauthSetupTs, oauthMiddlewareTs } from './oauth.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/templates/vectors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/vectors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/cli/templates/vectors/index.js

@@ -0,0 +1,9 @@
+/**
+ * Vector Templates — Barrel Export
+ * @module
+ */
+export { prismaSchema, dbUsersToolTs } from './database.js';
+export { n8nConnectorTs } from './workflow.js';
+export { openapiYaml, openapiSetupMd } from './openapi.js';
+export { oauthSetupTs, oauthMiddlewareTs } from './oauth.js';
+//# sourceMappingURL=index.js.map

package/dist/cli/templates/vectors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cli/templates/vectors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/cli/templates/vectors/oauth.d.ts

@@ -0,0 +1,10 @@
+/**
+ * OAuth Vector — Device Flow Authentication templates
+ * @module
+ */
+import type { ProjectConfig } from '../../types.js';
+/** Generate `src/auth.ts` — OAuth Device Flow setup */
+export declare function oauthSetupTs(config: ProjectConfig): string;
+/** Generate `src/middleware/auth.ts` — requireAuth middleware */
+export declare function oauthMiddlewareTs(): string;
+//# sourceMappingURL=oauth.d.ts.map

package/dist/cli/templates/vectors/oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/vectors/oauth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAsC1D;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,IAAI,MAAM,CA6B1C"}

package/dist/cli/templates/vectors/oauth.js

@@ -0,0 +1,76 @@
+/**
+ * OAuth Vector — Device Flow Authentication templates
+ * @module
+ */
+/** Generate `src/auth.ts` — OAuth Device Flow setup */
+export function oauthSetupTs(config) {
+    return `/**
+ * OAuth Setup — Device Flow Authentication (RFC 8628)
+ *
+ * Pre-configured \`createAuthTool()\` with login, complete, status, logout actions.
+ * The \`requireAuth()\` middleware protects any tool with one line.
+ *
+ * 1. Set CLIENT_ID and AUTH endpoints in .env
+ * 2. Register the auth tool in server.ts
+ * 3. Use \`requireAuth()\` on protected tools
+ */
+import { createAuthTool, TokenManager } from '@vurb/oauth';
+import type { ToolRegistry } from 'vurb';
+
+export function registerAuth<TContext>(registry: ToolRegistry<TContext>): void {
+    const clientId = process.env['OAUTH_CLIENT_ID'];
+    const authEndpoint = process.env['OAUTH_AUTH_ENDPOINT'];
+    const tokenEndpoint = process.env['OAUTH_TOKEN_ENDPOINT'];
+
+    if (!clientId || !authEndpoint || !tokenEndpoint) {
+        console.error('⚠️  OAUTH_CLIENT_ID, OAUTH_AUTH_ENDPOINT, OAUTH_TOKEN_ENDPOINT are required in .env');
+        return;
+    }
+
+    const auth = createAuthTool({
+        clientId,
+        authorizationEndpoint: authEndpoint,
+        tokenEndpoint,
+        tokenManager: {
+            configDir: '.${config.name}',
+            envVar: '${config.name.toUpperCase().replace(/-/g, '_')}_TOKEN',
+        },
+    });
+
+    registry.register(auth);
+    console.error('🔐 OAuth Device Flow registered (auth.login → auth.complete → auth.status)');
+}
+`;
+}
+/** Generate `src/middleware/auth.ts` — requireAuth middleware */
+export function oauthMiddlewareTs() {
+    return `/**
+ * Auth Middleware — Protect tools with requireAuth()
+ *
+ * @example
+ * \`\`\`ts
+ * import { withAuth } from '../middleware/auth.js';
+ *
+ * export default f.query('projects.list')
+ *     .describe('List all projects')
+ *     .use(withAuth)
+ *     .handle(async (input, ctx) => { /* authenticated */ });
+ * \`\`\`
+ */
+import { requireAuth } from '@vurb/oauth';
+
+/**
+ * Pre-configured auth middleware.
+ * Rejects unauthenticated requests with \`AUTH_REQUIRED\` + self-healing hints.
+ */
+export const withAuth = requireAuth({
+    extractToken: (ctx: unknown) => {
+        const obj = ctx as Record<string, unknown>;
+        return typeof obj['token'] === 'string' ? obj['token'] : null;
+    },
+    recoveryHint: 'Call auth action=login to authenticate via browser',
+    recoveryAction: 'auth',
+});
+`;
+}
+//# sourceMappingURL=oauth.js.map

package/dist/cli/templates/vectors/oauth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.js","sourceRoot":"","sources":["../../../../src/cli/templates/vectors/oauth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,uDAAuD;AACvD,MAAM,UAAU,YAAY,CAAC,MAAqB;IAC9C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA4BgB,MAAM,CAAC,IAAI;uBACf,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;;;;;;;CAOlE,CAAC;AACF,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,iBAAiB;IAC7B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BV,CAAC;AACF,CAAC"}

package/dist/cli/templates/vectors/openapi.d.ts

@@ -0,0 +1,10 @@
+/**
+ * OpenAPI Vector — Spec + setup templates
+ * @module
+ */
+import type { ProjectConfig } from '../../types.js';
+/** Generate `openapi.yaml` — Sample OpenAPI spec */
+export declare function openapiYaml(config: ProjectConfig): string;
+/** Generate `SETUP.md` — OpenAPI generation instructions */
+export declare function openapiSetupMd(): string;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/cli/templates/vectors/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/vectors/openapi.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAwEzD;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,IAAI,MAAM,CA6BvC"}

package/dist/cli/templates/vectors/openapi.js

@@ -0,0 +1,106 @@
+/** Generate `openapi.yaml` — Sample OpenAPI spec */
+export function openapiYaml(config) {
+    return `# OpenAPI 3.0 Specification — Sample
+#
+# Replace this with your actual API spec, then run:
+#   npx @vurb/openapi-gen ./openapi.yaml --outDir ./src/generated
+#
+# The generator creates Presenters, Tools, Registry, and server
+# bootstrap — all configurable via YAML annotations.
+
+openapi: '3.0.3'
+info:
+  title: '${config.name} API'
+  version: '0.1.0'
+  description: Sample API for Vurb OpenAPI generation
+
+servers:
+  - url: http://localhost:3000/api
+
+paths:
+  /health:
+    get:
+      operationId: getHealth
+      summary: Health check endpoint
+      responses:
+        '200':
+          description: Server health status
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status:
+                    type: string
+                    example: healthy
+                  uptime:
+                    type: number
+                    example: 12345.67
+
+  /users:
+    get:
+      operationId: listUsers
+      summary: List all users
+      parameters:
+        - name: limit
+          in: query
+          schema:
+            type: integer
+            minimum: 1
+            maximum: 100
+            default: 10
+      responses:
+        '200':
+          description: List of users
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/User'
+
+components:
+  schemas:
+    User:
+      type: object
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+        email:
+          type: string
+`;
+}
+/** Generate `SETUP.md` — OpenAPI generation instructions */
+export function openapiSetupMd() {
+    return `# OpenAPI Generator Setup
+
+This project is configured for the **Legacy API Proxy** ingestion vector.
+
+## Steps
+
+1. Replace \`openapi.yaml\` with your actual OpenAPI 3.x spec
+
+2. Generate the MCP server from the spec:
+   \`\`\`bash
+   npx @vurb/openapi-gen ./openapi.yaml --outDir ./src/generated
+   \`\`\`
+
+3. The generator creates:
+   - Presenters with Zod schemas (Egress Firewall)
+   - Tool builders with typed handlers
+   - Registry setup with all endpoints
+
+4. Import and register in \`src/server.ts\`:
+   \`\`\`typescript
+   import { generatedTools } from './generated/registry.js';
+   registry.registerAll(...generatedTools);
+   \`\`\`
+
+## Documentation
+
+See: [OpenAPI Generator](https://vurb.vinkius.com/openapi-gen)
+`;
+}
+//# sourceMappingURL=openapi.js.map

package/dist/cli/templates/vectors/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../../../../src/cli/templates/vectors/openapi.ts"],"names":[],"mappings":"AAMA,oDAAoD;AACpD,MAAM,UAAU,WAAW,CAAC,MAAqB;IAC7C,OAAO;;;;;;;;;;YAUC,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DtB,CAAC;AACF,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,cAAc;IAC1B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BV,CAAC;AACF,CAAC"}

package/dist/cli/templates/vectors/workflow.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Workflow Vector — n8n connector template
+ * @module
+ */
+/** Generate `src/n8n.ts` — n8n workflow connector */
+export declare function n8nConnectorTs(): string;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/cli/templates/vectors/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/vectors/workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qDAAqD;AACrD,wBAAgB,cAAc,IAAI,MAAM,CA0CvC"}

package/dist/cli/templates/vectors/workflow.js

@@ -0,0 +1,49 @@
+/**
+ * Workflow Vector — n8n connector template
+ * @module
+ */
+/** Generate `src/n8n.ts` — n8n workflow connector */
+export function n8nConnectorTs() {
+    return [
+        '/**',
+        ' * n8n Connector — Workflow Automation Bridge',
+        ' *',
+        ' * Auto-discovers webhook workflows from your n8n instance',
+        ' * and registers them as MCP tools. The connector infers',
+        ' * tool semantics from workflow Notes and maintains',
+        ' * live-sync with zero downtime.',
+        ' *',
+        ' * Configure N8N_BASE_URL and N8N_API_KEY in your .env file.',
+        ' */',
+        "import { N8nConnector } from '@vurb/n8n';",
+        "import type { ToolRegistry } from 'vurb';",
+        '',
+        'export async function discoverWorkflows<TContext>(',
+        '    registry: ToolRegistry<TContext>,',
+        '): Promise<number> {',
+        "    const baseUrl = process.env['N8N_BASE_URL'];",
+        "    const apiKey = process.env['N8N_API_KEY'];",
+        '',
+        '    if (!baseUrl || !apiKey) {',
+        "        console.error('\u26A0\uFE0F  N8N_BASE_URL and N8N_API_KEY are required in .env');",
+        '        return 0;',
+        '    }',
+        '',
+        '    const connector = new N8nConnector({',
+        '        baseUrl,',
+        '        apiKey,',
+        '    });',
+        '',
+        '    const tools = await connector.discover();',
+        '',
+        '    for (const tool of tools) {',
+        '        registry.register(tool);',
+        '    }',
+        '',
+        '    console.error(`\uD83D\uDD17 Discovered ${tools.length} n8n workflow(s)`);',
+        '    return tools.length;',
+        '}',
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=workflow.js.map

package/dist/cli/templates/vectors/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../../src/cli/templates/vectors/workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qDAAqD;AACrD,MAAM,UAAU,cAAc;IAC1B,OAAO;QACH,KAAK;QACL,+CAA+C;QAC/C,IAAI;QACJ,4DAA4D;QAC5D,0DAA0D;QAC1D,qDAAqD;QACrD,kCAAkC;QAClC,IAAI;QACJ,8DAA8D;QAC9D,KAAK;QACL,2CAA2C;QAC3C,2CAA2C;QAC3C,EAAE;QACF,oDAAoD;QACpD,uCAAuC;QACvC,sBAAsB;QACtB,kDAAkD;QAClD,gDAAgD;QAChD,EAAE;QACF,gCAAgC;QAChC,2FAA2F;QAC3F,mBAAmB;QACnB,OAAO;QACP,EAAE;QACF,0CAA0C;QAC1C,kBAAkB;QAClB,iBAAiB;QACjB,SAAS;QACT,EAAE;QACF,+CAA+C;QAC/C,EAAE;QACF,iCAAiC;QACjC,kCAAkC;QAClC,OAAO;QACP,EAAE;QACF,+EAA+E;QAC/E,0BAA0B;QAC1B,GAAG;QACH,EAAE;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC"}

package/dist/cli/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * CLI Types — Shared Configuration Types
+ *
+ * Configuration types collected from the interactive wizard
+ * or CLI flags for the `vurb create` command.
+ *
+ * @module
+ */
+/** Primary ingestion vector for the scaffolded project */
+export type IngestionVector = 'vanilla' | 'prisma' | 'n8n' | 'openapi' | 'oauth';
+/** Transport layer for MCP communication */
+export type TransportLayer = 'stdio' | 'sse';
+/**
+ * Project scaffold configuration.
+ *
+ * Collected from CLI flags or the interactive wizard.
+ * Drives template generation and file selection.
+ */
+export interface ProjectConfig {
+    /** Project name (directory name + package.json name) */
+    readonly name: string;
+    /** Transport layer for MCP communication */
+    readonly transport: TransportLayer;
+    /** Primary ingestion vector */
+    readonly vector: IngestionVector;
+    /** Include @vurb/testing + Vitest */
+    readonly testing: boolean;
+}
+/** Remote cloud configuration stored in .vurbrc (token-free) */
+export interface RemoteConfig {
+    /** API base URL (e.g., https://api.cloud.vinkius.com) */
+    readonly remote: string;
+    /** Target server UUID */
+    readonly serverId: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC;AAEjF,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,KAAK,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IAEnC,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAEjC,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC7B;AAED,gEAAgE;AAChE,MAAM,WAAW,YAAY;IACzB,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC7B"}

package/dist/cli/types.js

@@ -0,0 +1,10 @@
+/**
+ * CLI Types — Shared Configuration Types
+ *
+ * Configuration types collected from the interactive wizard
+ * or CLI flags for the `vurb create` command.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/cli/utils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Auto-detect the server entrypoint by probing common file paths.
+ *
+ * Checks in order: `src/server.ts`, `src/index.ts`, `server.ts`, `index.ts`,
+ * and their `.js` counterparts.
+ *
+ * @internal
+ */
+export declare function inferServerEntry(cwd: string): string | undefined;
+/**
+ * Infer the watch directory from the server entrypoint path.
+ *
+ * Heuristic: if the server is in `src/server.ts`, watch `src/`.
+ * Falls back to the directory containing the entrypoint.
+ *
+ * @internal
+ */
+export declare function inferWatchDir(serverPath: string): string;
+/**
+ * Ask a question via readline with styled ANSI output.
+ * @internal exported for testing
+ */
+export declare function ask(rl: {
+    question: (q: string, cb: (a: string) => void) => void;
+    once?: (event: string, cb: () => void) => void;
+}, prompt: string, fallback: string): Promise<string>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/cli/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/cli/utils.ts"],"names":[],"mappings":"AAUA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYhE;AAID;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAWxD;AAID;;;GAGG;AACH,wBAAgB,GAAG,CACf,EAAE,EAAE;IAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,KAAK,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAA;CAAE,EAC9G,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAgBjB"}

package/dist/cli/utils.js

@@ -0,0 +1,73 @@
+/**
+ * CLI utilities — server detection, watch dir inference.
+ * @module
+ */
+import { resolve } from 'node:path';
+import { existsSync } from 'node:fs';
+import { ansi } from './constants.js';
+// ─── Server Entry Detection ──────────────────────────────────────
+/**
+ * Auto-detect the server entrypoint by probing common file paths.
+ *
+ * Checks in order: `src/server.ts`, `src/index.ts`, `server.ts`, `index.ts`,
+ * and their `.js` counterparts.
+ *
+ * @internal
+ */
+export function inferServerEntry(cwd) {
+    const candidates = [
+        'src/server.ts', 'src/index.ts',
+        'src/server.js', 'src/index.js',
+        'server.ts', 'index.ts',
+        'server.js', 'index.js',
+    ];
+    for (const candidate of candidates) {
+        const fullPath = resolve(cwd, candidate);
+        if (existsSync(fullPath))
+            return fullPath;
+    }
+    return undefined;
+}
+// ─── Watch Dir Inference ─────────────────────────────────────────
+/**
+ * Infer the watch directory from the server entrypoint path.
+ *
+ * Heuristic: if the server is in `src/server.ts`, watch `src/`.
+ * Falls back to the directory containing the entrypoint.
+ *
+ * @internal
+ */
+export function inferWatchDir(serverPath) {
+    const dir = resolve(serverPath, '..');
+    const dirName = dir.split(/[\\/]/).pop() ?? '';
+    if (dirName === 'src')
+        return dir;
+    const parentDir = resolve(dir, '..');
+    const parentName = parentDir.split(/[\\/]/).pop() ?? '';
+    if (parentName === 'src')
+        return parentDir;
+    return dir;
+}
+// ─── Interactive Prompt ──────────────────────────────────────────
+/**
+ * Ask a question via readline with styled ANSI output.
+ * @internal exported for testing
+ */
+export function ask(rl, prompt, fallback) {
+    return new Promise((resolve) => {
+        let resolved = false;
+        rl.once?.('close', () => {
+            if (!resolved) {
+                resolved = true;
+                resolve(fallback);
+            }
+        });
+        rl.question(`  ${ansi.cyan('◇')} ${prompt} ${ansi.dim(`(${fallback})`)} `, (answer) => {
+            if (!resolved) {
+                resolved = true;
+                resolve(answer.trim() || fallback);
+            }
+        });
+    });
+}
+//# sourceMappingURL=utils.js.map

package/dist/cli/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/cli/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,oEAAoE;AAEpE;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IACxC,MAAM,UAAU,GAAG;QACf,eAAe,EAAE,cAAc;QAC/B,eAAe,EAAE,cAAc;QAC/B,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE,UAAU;KAC1B,CAAC;IACF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACzC,IAAI,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;IAC9C,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,oEAAoE;AAEpE;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAE/C,IAAI,OAAO,KAAK,KAAK;QAAE,OAAO,GAAG,CAAC;IAElC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IACxD,IAAI,UAAU,KAAK,KAAK;QAAE,OAAO,SAAS,CAAC;IAE3C,OAAO,GAAG,CAAC;AACf,CAAC;AAED,oEAAoE;AAEpE;;;GAGG;AACH,MAAM,UAAU,GAAG,CACf,EAA8G,EAC9G,MAAc,EACd,QAAgB;IAEhB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3B,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,EAAE,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACpB,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,QAAQ,GAAG,IAAI,CAAC;gBAChB,OAAO,CAAC,QAAQ,CAAC,CAAC;YACtB,CAAC;QACL,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,GAAG,EAAE,CAAC,MAAc,EAAE,EAAE;YAC1F,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,QAAQ,GAAG,IAAI,CAAC;gBAChB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,QAAQ,CAAC,CAAC;YACvC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/vurb.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { commandLock } from './commands/lock.js';
+import { commandDev } from './commands/dev.js';
+import { commandCreate } from './commands/create.js';
+export { parseArgs } from './args.js';
+export type { CliArgs } from './args.js';
+export { VURB_VERSION, HELP, ansi } from './constants.js';
+export type { StepStatus, ProgressStep, ProgressReporter } from './progress.js';
+export { ProgressTracker, createDefaultReporter } from './progress.js';
+export type { RegistryLike, PromptRegistryLike } from './registry.js';
+export { resolveRegistry } from './registry.js';
+export { collectConfig } from './commands/create.js';
+export { commandLock, commandDev, commandCreate };
+export { ask } from './utils.js';
+//# sourceMappingURL=vurb.d.ts.map

package/dist/cli/vurb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vurb.d.ts","sourceRoot":"","sources":["../../src/cli/vurb.ts"],"names":[],"mappings":";AAWA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAMrD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC1D,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACvE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;AAClD,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC"}