wexts 4.1.6 → 4.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/cli/index.js CHANGED
@@ -24,7 +24,7 @@ function createCliProgram() {
24
24
  skipInstall: options.skipInstall
25
25
  });
26
26
  });
27
- program.command("dev").description("Start local development processes").option("-a, --api <path>", "Path to API project", "./apps/api").option("-w, --web <path>", "Path to Web project", "./apps/web").option("-p, --port <port>", "Port for web server", "3000").option("--api-port <port>", "Port for API server", "5050").option("--proxy", "Enable development proxy on a separate proxy port", false).action(async (options) => {
27
+ program.command("dev").description("Start local development processes").option("-a, --api <path>", "Path to API project", "./apps/api").option("-w, --web <path>", "Path to Web project", "./apps/web").option("-p, --port <port>", "Port for web server", "3000").option("--api-port <port>", "Port for API server", "5050").option("--proxy", "Enable development proxy on a separate proxy port", false).option("-c, --config <path>", "Runtime config module path", "./wexts.runtime.js").action(async (options) => {
28
28
  const { FusionDevServer } = await Promise.resolve().then(() => _interopRequireWildcard(require("../dev-server/index.js")));
29
29
  const server = new FusionDevServer();
30
30
  await server.start({
@@ -32,7 +32,9 @@ function createCliProgram() {
32
32
  webPath: options.web,
33
33
  webPort: Number(options.port),
34
34
  apiPort: Number(options.apiPort),
35
- useProxy: options.proxy
35
+ useProxy: options.proxy,
36
+ rootDir: process.cwd(),
37
+ runtimeConfigPath: options.config
36
38
  });
37
39
  });
38
40
  program.command("generate [type] [name]").alias("g").description("Generate RPC manifest/client, or scaffold a minimal RPC service").option("-p, --project <path>", "Path to NestJS project", "./apps/api").option("-o, --output <path>", "Output directory for generated RPC client", "./apps/web/lib/wexts").option("--force", "Overwrite generated files if they already exist", false).action(async (type, name, options) => {
@@ -79,14 +81,14 @@ function createCliProgram() {
79
81
  cwd: process.cwd()
80
82
  });
81
83
  });
82
- program.command("start").description("Start the production Wexts runtime").option("-c, --config <path>", "Runtime config module path", "./wexts.runtime.js").option("-p, --port <port>", "Port to listen on", _nullishCoalesce(process.env.PORT, () => ( "3000"))).action(async (options) => {
84
+ program.command("start").description("Start the Wexts runtime").option("-c, --config <path>", "Runtime config module path", "./wexts.runtime.js").option("-p, --port <port>", "Port to listen on", _nullishCoalesce(process.env.PORT, () => ( "3000"))).option("--dev", "Run the runtime in development mode", false).action(async (options) => {
83
85
  const { startWextsRuntime } = await Promise.resolve().then(() => _interopRequireWildcard(require("../runtime/index.js")));
84
86
  const configPath = path.resolve(options.config);
85
- const runtimeConfig = fs.existsSync(configPath) ? await loadRuntimeConfig(configPath) : {};
87
+ const runtimeConfig = fs.existsSync(configPath) ? await loadRuntimeConfig(configPath, options.dev) : {};
86
88
  await startWextsRuntime({
87
89
  ...runtimeConfig,
88
90
  port: Number(options.port),
89
- dev: false
91
+ dev: options.dev
90
92
  });
91
93
  });
92
94
  program.command("vercel-build").description("Build for Vercel using Build Output API v3").option("-p, --project <path>", "Path to NestJS project", "./apps/api").option("-o, --output <path>", "Output dir for RPC client", "./apps/web/lib/wexts").option("-c, --config <path>", "Runtime config module path", "./wexts.runtime.js").option("--skip-codegen", "Skip RPC generation", false).option("--skip-build", "Skip project build step", false).option("--node-version <version>", "Node.js version for Vercel function", "20").option("--max-duration <seconds>", "Max duration for serverless function", "30").action(async (options) => {
@@ -143,7 +145,7 @@ function runDoctor(cwd, security = false) {
143
145
  }
144
146
  }
145
147
  if (fs.existsSync(path.join(cwd, "apps/api")) && fs.existsSync(path.join(cwd, "apps/web"))) {
146
- result.warnings.push("Development mode starts separate web/API processes. Single-port serving is the production `wexts start` runtime path.");
148
+ result.warnings.push("Development mode starts an API compiler plus the Wexts runtime so `/rpc` and Next routes share the web port.");
147
149
  }
148
150
  if (security) {
149
151
  const source = readAllText(cwd, [
@@ -200,170 +202,9 @@ async function createVerifiedStarter(projectPath, projectName, wextsDependency)
200
202
  "doctor:security": "wexts doctor --security"
201
203
  },
202
204
  dependencies: {
203
- "@nestjs/common": "^11.1.19",
204
- "@nestjs/core": "^11.1.19",
205
- "@nestjs/platform-fastify": "^11.1.19",
206
- next: "16.2.4",
207
- react: "^19.2.5",
208
- "react-dom": "^19.2.5",
209
- "reflect-metadata": "^0.2.2",
210
- rxjs: "^7.8.1",
211
205
  wexts: wextsDependency
212
- },
213
- devDependencies: {
214
- "@types/node": "^22.19.1",
215
- "@types/react": "^19.2.14",
216
- "@types/react-dom": "^19.2.3",
217
- typescript: "^5.9.3"
218
- }
219
- }, null, 2),
220
- "apps/api/package.json": JSON.stringify({
221
- name: `${projectName}-api`,
222
- private: true,
223
- scripts: {
224
- "start:dev": "tsc -w -p tsconfig.json"
225
- }
226
- }, null, 2),
227
- "apps/api/tsconfig.json": JSON.stringify({
228
- compilerOptions: {
229
- target: "ES2023",
230
- module: "NodeNext",
231
- moduleResolution: "NodeNext",
232
- experimentalDecorators: true,
233
- emitDecoratorMetadata: true,
234
- strict: true,
235
- esModuleInterop: true,
236
- skipLibCheck: true,
237
- outDir: "dist",
238
- rootDir: "src"
239
- },
240
- include: [
241
- "src/**/*.ts"
242
- ]
243
- }, null, 2),
244
- "apps/api/src/hello.service.ts": `import { Injectable } from '@nestjs/common';
245
- import { RpcMethod, RpcService } from 'wexts/nest';
246
-
247
- @Injectable()
248
- @RpcService({ name: 'hello', requireAuth: false })
249
- export class HelloService {
250
- @RpcMethod()
251
- async sayHello(name: string): Promise<string> {
252
- return \`Hello, \${name}!\`;
253
- }
254
- }
255
- `,
256
- "apps/web/package.json": JSON.stringify({
257
- name: `${projectName}-web`,
258
- private: true,
259
- scripts: {
260
- dev: "next dev -p 3000"
261
206
  }
262
207
  }, null, 2),
263
- "apps/web/tsconfig.json": JSON.stringify({
264
- compilerOptions: {
265
- target: "ES2022",
266
- lib: [
267
- "dom",
268
- "dom.iterable",
269
- "es2022"
270
- ],
271
- allowJs: false,
272
- skipLibCheck: true,
273
- strict: true,
274
- noEmit: true,
275
- esModuleInterop: true,
276
- module: "esnext",
277
- moduleResolution: "bundler",
278
- resolveJsonModule: true,
279
- isolatedModules: true,
280
- jsx: "react-jsx",
281
- incremental: true,
282
- plugins: [
283
- {
284
- name: "next"
285
- }
286
- ]
287
- },
288
- include: [
289
- "next-env.d.ts",
290
- "**/*.ts",
291
- "**/*.tsx",
292
- ".next/types/**/*.ts",
293
- ".next/dev/types/**/*.ts"
294
- ],
295
- exclude: [
296
- "node_modules"
297
- ]
298
- }, null, 2),
299
- "apps/web/next-env.d.ts": `/// <reference types="next" />
300
- /// <reference types="next/image-types/global" />
301
-
302
- // This file is generated by Next.js. Do not edit.
303
- `,
304
- "apps/web/next.config.ts": `import type { NextConfig } from 'next';
305
-
306
- const nextConfig: NextConfig = {
307
- output: 'standalone',
308
- };
309
-
310
- export default nextConfig;
311
- `,
312
- "apps/web/app/layout.tsx": `import type { ReactNode } from 'react';
313
- import { WextsProvider } from '../lib/wexts-provider';
314
-
315
- export default function RootLayout({ children }: { children: ReactNode }) {
316
- return (
317
- <html lang="en">
318
- <body>
319
- <WextsProvider>{children}</WextsProvider>
320
- </body>
321
- </html>
322
- );
323
- }
324
- `,
325
- "apps/web/app/page.tsx": `'use client';
326
-
327
- import { useState } from 'react';
328
- import { useWexts } from '../lib/wexts-provider';
329
-
330
- export default function Page() {
331
- const wexts = useWexts();
332
- const [message, setMessage] = useState('Not called yet');
333
-
334
- return (
335
- <main>
336
- <h1>Wexts Hello RPC</h1>
337
- <button
338
- type="button"
339
- onClick={async () => {
340
- setMessage(await wexts.hello.sayHello('Bob'));
341
- }}
342
- >
343
- Call RPC
344
- </button>
345
- <p>{message}</p>
346
- </main>
347
- );
348
- }
349
- `,
350
- "apps/web/lib/wexts-provider.tsx": `'use client';
351
-
352
- import { FusionProvider, useWexts as useGeneratedWexts } from 'wexts/next';
353
- import { createWextsClient, type WextsClient } from './wexts/client';
354
-
355
- export function WextsProvider({ children }: { children: React.ReactNode }) {
356
- return (
357
- <FusionProvider rpcClient={createWextsClient({ baseUrl: '/rpc' })}>
358
- {children}
359
- </FusionProvider>
360
- );
361
- }
362
-
363
- export function useWexts(): WextsClient {
364
- return useGeneratedWexts<WextsClient>();
365
- }
366
- `,
367
208
  "wexts.runtime.js": `const { HelloService } = require('./apps/api/dist/hello.service.js');
368
209
 
369
210
  module.exports = {
@@ -379,15 +220,13 @@ module.exports = {
379
220
  `,
380
221
  "README.md": `# ${projectName}
381
222
 
382
- Verified Wexts starter with a generated Hello RPC client.
223
+ Verified Wexts starter with Next.js and NestJS.
383
224
 
384
225
  \`\`\`bash
385
226
  pnpm install
386
227
  pnpm run generate
387
228
  pnpm run build
388
- pnpm run doctor
389
- pnpm run doctor:security
390
- pnpm start
229
+ pnpm run dev
391
230
  \`\`\`
392
231
  `,
393
232
  ".cursorrules": `# Wexts Project AI Rules
@@ -410,14 +249,6 @@ Wexts is a unified single-runtime toolkit that combines Next.js (frontend) and N
410
249
  1. **RPC Usage**: To call the backend, import the \`api\` client from \`@/lib/wexts\` or your designated Wexts client file (e.g., \`useWexts()\`).
411
250
  2. **Syntax**: \`const data = await api.serviceName.methodName(args);\`
412
251
  3. The \`api\` object is fully type-safe. Rely on TypeScript autocomplete rather than guessing endpoints.
413
-
414
- ## Development Workflow
415
- - When asked to add a new full-stack feature:
416
- 1. Add the database model (Prisma).
417
- 2. Create/update the NestJS RPC service in \`apps/api\`.
418
- 3. Remind the user to run \`wexts generate\` (or \`pnpm generate\`) so the types sync.
419
- 4. Build the UI in Next.js using the new \`api\` methods.
420
- - **Never** hardcode \`fetch('http://localhost:3000/...')\`. ALWAYS use the generated \`api\` SDK.
421
252
  `
422
253
  };
423
254
  for (const [relativePath, content] of Object.entries(files)) {
@@ -427,11 +258,57 @@ Wexts is a unified single-runtime toolkit that combines Next.js (frontend) and N
427
258
  });
428
259
  fs.writeFileSync(absolutePath, content);
429
260
  }
430
- const { generateRpcClient } = await Promise.resolve().then(() => _interopRequireWildcard(require("../codegen/index.js")));
431
- await generateRpcClient({
432
- projectPath: path.join(projectPath, "apps/api"),
433
- outputPath: path.join(projectPath, "apps/web/lib/wexts")
434
- });
261
+ const templatePath = findTemplatePath();
262
+ if (!templatePath) {
263
+ throw new Error("Template directory not found in package.");
264
+ }
265
+ const apiTemplatePath = path.join(templatePath, "nestjs-api");
266
+ const apiDestPath = path.join(projectPath, "apps/api");
267
+ if (fs.existsSync(apiTemplatePath)) {
268
+ fs.cpSync(apiTemplatePath, apiDestPath, {
269
+ recursive: true,
270
+ filter: /* @__PURE__ */ _chunkXE4OXN2Wjs.__name.call(void 0, (src) => {
271
+ const basename2 = path.basename(src);
272
+ return basename2 !== "node_modules" && basename2 !== "dist" && basename2 !== "package-lock.json";
273
+ }, "filter")
274
+ });
275
+ const apiPkgPath = path.join(apiDestPath, "package.json");
276
+ if (fs.existsSync(apiPkgPath)) {
277
+ const apiPkg = JSON.parse(fs.readFileSync(apiPkgPath, "utf8"));
278
+ apiPkg.name = `${projectName}-api`;
279
+ if (_optionalChain([apiPkg, 'access', _4 => _4.dependencies, 'optionalAccess', _5 => _5.wexts])) apiPkg.dependencies.wexts = wextsDependency;
280
+ fs.writeFileSync(apiPkgPath, JSON.stringify(apiPkg, null, 2));
281
+ }
282
+ }
283
+ const webTemplatePath = path.join(templatePath, "nextjs-web");
284
+ const webDestPath = path.join(projectPath, "apps/web");
285
+ if (fs.existsSync(webTemplatePath)) {
286
+ fs.cpSync(webTemplatePath, webDestPath, {
287
+ recursive: true,
288
+ filter: /* @__PURE__ */ _chunkXE4OXN2Wjs.__name.call(void 0, (src) => {
289
+ const basename2 = path.basename(src);
290
+ return basename2 !== "node_modules" && basename2 !== ".next" && basename2 !== "package-lock.json";
291
+ }, "filter")
292
+ });
293
+ const webPkgPath = path.join(webDestPath, "package.json");
294
+ if (fs.existsSync(webPkgPath)) {
295
+ const webPkg = JSON.parse(fs.readFileSync(webPkgPath, "utf8"));
296
+ webPkg.name = `${projectName}-web`;
297
+ if (_optionalChain([webPkg, 'access', _6 => _6.dependencies, 'optionalAccess', _7 => _7.wexts])) webPkg.dependencies.wexts = wextsDependency;
298
+ fs.writeFileSync(webPkgPath, JSON.stringify(webPkg, null, 2));
299
+ }
300
+ }
301
+ if (fs.existsSync(path.join(apiDestPath, "src"))) {
302
+ try {
303
+ const { generateRpcClient } = await Promise.resolve().then(() => _interopRequireWildcard(require("../codegen/index.js")));
304
+ await generateRpcClient({
305
+ projectPath: path.join(projectPath, "apps/api"),
306
+ outputPath: path.join(projectPath, "apps/web/lib/wexts")
307
+ });
308
+ } catch (e) {
309
+ _chunkWCKSKU3Cjs.logger.warn('Initial RPC generation failed; you may need to run "wexts generate" after setup.');
310
+ }
311
+ }
435
312
  }
436
313
  _chunkXE4OXN2Wjs.__name.call(void 0, createVerifiedStarter, "createVerifiedStarter");
437
314
  function createLegacyProject(projectPath, projectName) {
@@ -479,7 +356,7 @@ function resolveCreateWextsDependency(projectPath) {
479
356
  if (fs.existsSync(cwdLocalPackage) && fs.realpathSync(cwdLocalPackage) === fs.realpathSync(packageRoot)) {
480
357
  return `file:${path.relative(projectPath, cwdLocalPackage)}`;
481
358
  }
482
- } catch (e) {
359
+ } catch (e2) {
483
360
  }
484
361
  return `^${readPackageVersion()}`;
485
362
  }
@@ -654,7 +531,7 @@ function detectPackageManager(cwd) {
654
531
  const packageJsonPath = path.join(cwd, "package.json");
655
532
  if (fs.existsSync(packageJsonPath)) {
656
533
  const pkg = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
657
- if (_optionalChain([pkg, 'access', _4 => _4.packageManager, 'optionalAccess', _5 => _5.startsWith, 'call', _6 => _6("pnpm@")])) return "pnpm";
534
+ if (_optionalChain([pkg, 'access', _8 => _8.packageManager, 'optionalAccess', _9 => _9.startsWith, 'call', _10 => _10("pnpm@")])) return "pnpm";
658
535
  }
659
536
  if (fs.existsSync(path.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
660
537
  if (fs.existsSync(path.join(cwd, "pnpm-workspace.yaml"))) return "pnpm";
@@ -719,14 +596,26 @@ function pathToFileUrl(filePath) {
719
596
  return `file://${filePath}`;
720
597
  }
721
598
  _chunkXE4OXN2Wjs.__name.call(void 0, pathToFileUrl, "pathToFileUrl");
722
- async function loadRuntimeConfig(configPath) {
723
- if (configPath.endsWith(".mjs")) {
724
- const mod2 = await Promise.resolve().then(() => _interopRequireWildcard(require(pathToFileUrl(configPath))));
725
- return _nullishCoalesce(mod2.default, () => ( mod2));
726
- }
727
- const require2 = _module.createRequire.call(void 0, __filename);
728
- const mod = require2(configPath);
729
- return _nullishCoalesce(mod.default, () => ( mod));
599
+ async function loadRuntimeConfig(configPath, retry = false) {
600
+ const deadline = Date.now() + (retry ? 15e3 : 0);
601
+ let lastError;
602
+ do {
603
+ try {
604
+ if (configPath.endsWith(".mjs")) {
605
+ const mod2 = await Promise.resolve().then(() => _interopRequireWildcard(require(pathToFileUrl(configPath))));
606
+ return _nullishCoalesce(mod2.default, () => ( mod2));
607
+ }
608
+ const require2 = _module.createRequire.call(void 0, __filename);
609
+ delete require2.cache[require2.resolve(configPath)];
610
+ const mod = require2(configPath);
611
+ return _nullishCoalesce(mod.default, () => ( mod));
612
+ } catch (error) {
613
+ lastError = error;
614
+ if (!retry || Date.now() >= deadline) break;
615
+ await new Promise((resolve2) => setTimeout(resolve2, 500));
616
+ }
617
+ } while (retry);
618
+ throw lastError;
730
619
  }
731
620
  _chunkXE4OXN2Wjs.__name.call(void 0, loadRuntimeConfig, "loadRuntimeConfig");
732
621
  var invokedAsCli = process.argv[1] && (path.basename(process.argv[1]) === "wexts" || path.basename(process.argv[1]) === "wexts.cjs" || path.resolve(process.argv[1]).includes(`${path.sep}dist${path.sep}cli${path.sep}index`));
@@ -1 +1 @@
1
- {"version":3,"sources":["/Volumes/Projects/wexts/packages/dist/cli/index.js","../../src/cli/index.ts"],"names":["createCliProgram","program","Command","name","description","version","readPackageVersion","command","option","action","projectName","options","createProject","template","skipInstall","FusionDevServer","server","start","apiPath","api","webPath","web","webPort","Number","port","apiPort","useProxy","proxy","alias","type","generateRpcClient","manifest","projectPath","resolve","project","outputPath","output","logger","success","services","length","isScaffoldGenerator","targetRoot","process","cwd","changedFiles","scaffoldGenerator","force","file","info","relative","runtimeConfig","config","skipCodegen","skipBuild","nodeVersion","warning","error","result","runDoctor","resolveCreateWextsDependency","wextsDependency","relativePath","content","createVerifiedStarter","findTemplatePath","createLegacyProject","packageRoot","cwdLocalPackage","rawName","classBase","serviceName","rpcServiceFiles","absolutePath","writeGeneratedFiles","script","runScript","runCommand","detectPackageManager","candidate","dir","text","readAllText","entry","absolute","walk","toKebabCase","toPascalCase","value","toCamelCase","filePath","pathToFileUrl","configPath","mod","__filename","loadRuntimeConfig","basename"],"mappings":"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AAA;AACS,QAAA;AACH,QAAA;AACN,QAAA;AACC,QAAA;AACb,MAAA;AACS,MAAA;AAAC,QAAA;ADtE2E,MAAA;ACuEhF,IAAA;AACwB,IAAA;ADrEwD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;ACuEjD,IAAA;AAC3BA,MAAAA;AACA,MAAA;AACA,MAAA;AACA,QAAA;AACT,MAAA;AACK,IAAA;AACgC,IAAA;AACpB,MAAA;AACL,QAAA;AACH,QAAA;AAAC,UAAA;AAAO,UAAA;AAAgB,UAAA;ADlEoD,QAAA;ACmExE,QAAA;AACK,QAAA;AACN,QAAA;AACA,QAAA;AACS,QAAA;AACT,QAAA;AACU,QAAA;AACC,QAAA;AACF,QAAA;AACZ,QAAA;AACQ,QAAA;AACJ,QAAA;AAAC,UAAA;AAAQ,YAAA;AAAO,UAAA;AD9DwD,QAAA;AC+DrF,MAAA;AACS,MAAA;AAAC,QAAA;AAAiB,QAAA;AAAW,QAAA;AAAY,QAAA;AAAuB,QAAA;ADxDY,MAAA;ACyD5E,MAAA;AAAC,QAAA;ADtD2E,MAAA;ACuDhF,IAAA;AACiB,IAAA;ADrD+D;AACA;AACA;AACA;ACuD9D,IAAA;ADrD8D;AACA;AACA;AACA;AACA;AACA;AACA;ACuD9D,IAAA;ADrD8D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;ACuDhE,IAAA;ADrDgE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;ACuDtD,IAAA;ADrDsD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;ACuDrE,IAAA;ADrDqE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;ACuDvEA,IAAAA;ADrDuE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;ACuDzE,IAAA;ADrDyE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;ACuD7F,EAAA;AAE6D,EAAA;AACboD,IAAAA;AACH,IAAA;AAAa,MAAA;AAAK,IAAA;AAC5BC,IAAAA;AACnC,EAAA;AAE2C,EAAA;AACnB,EAAA;AACgB,IAAA;AACD,IAAA;AACvC,EAAA;AACJ;AAxOeC;AA0OsD;AAC5CC,EAAAA;AACF,EAAA;AACC,IAAA;AACpB,EAAA;AAE6C,EAAA;AAAa,IAAA;AAAK,EAAA;AACsB,EAAA;AAAa,IAAA;AAAK,EAAA;AAClB,EAAA;AAAa,IAAA;AAAK,EAAA;AACvC,EAAA;AAAS,IAAA;AAAK,EAAA;AACd,EAAA;AAAS,IAAA;AAAK,EAAA;AACd,EAAA;AACQ,EAAA;AAC9DvD,IAAAA;AACG,IAAA;AACO,IAAA;AACP,IAAA;AACA,MAAA;AACK,MAAA;AACH,MAAA;AACA,MAAA;AACC,MAAA;AACZ,IAAA;AACiB,IAAA;AACFJ,MAAAA;AACf,IAAA;AACK,EAAA;AACb;AA3BS4D;AA6BgD;AACT,EAAA;AACK,EAAA;AAE7C,EAAA;AAC2FC,IAAAA;AAC7CC,MAAAA;AAC9C,IAAA;AACI,EAAA;AAER,EAAA;AAEW9D,EAAAA;AACf;AAbSsD;AAwBgE;AACrB,EAAA;AACvB,IAAA;AACX,MAAA;AAC6B,MAAA;AACe,MAAA;AACxC,MAAA;AACd,IAAA;AACJ,EAAA;AAE+B,EAAA;AACoB,IAAA;AAAC,MAAA;AAC9B,QAAA;AACL,QAAA;ADxD4E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AC0DzF,MAAA;AAAyB,IAAA;AAC7B,EAAA;AAEwBzD,EAAAA;AACCkE,EAAAA;AACMlE,EAAAA;AACe,EAAA;AAEqE,EAAA;AACpFmE,IAAAA;AAClB,IAAA;AAAC,MAAA;AACmD,QAAA;AAChD,QAAA;ADxD4E;AACA;AC0DlFA,aAAAA;ADxDkF;AC0DvEnE,YAAAA;ADxDuE;AACA;AACA;AC0DzF,MAAA;ADxDyF,IAAA;ACyDjF,IAAA;AAAC,MAAA;AACmD,QAAA;AAC/C,QAAA;ADtD4E;AACA;ACwDlFmE,aAAAA;ADtDkF;ACwDzF,MAAA;ADtDyF,IAAA;ACuDjF,IAAA;AAAC,MAAA;AACmD,QAAA;AAC3BA,QAAAA;ADpDwD;AACA;AACA;AACA;AACA;ACsDzF,MAAA;ADpDyF,IAAA;ACqDlF,IAAA;AAAC,MAAA;AACmD,QAAA;AAC9C,QAAA;ADlD4E;AACA;ACoDlFA,aAAAA;ADlDkF;AACA;AACA;AACA;AACA;ACoDzF,MAAA;ADlDyF,IAAA;ACmD7F,EAAA;AAEsB,EAAA;AAAa,IAAA;AAAK,EAAA;AACuD,EAAA;AACnG;AAhFsBxB;AAkFmB;AAC9B,EAAA;AAAC,IAAA;AAAO,IAAA;AAAW,IAAA;AAAU,IAAA;AAAU,IAAA;AAAS,IAAA;AAAmBjB,EAAAA;AAC9E;AAFSY;AAIsD;AACpD,EAAA;AAAC,IAAA;AACmE,MAAA;AAC9D,MAAA;ADxCgF;AACA;AACA;AC0C9D8B,qBAAAA;AACpBD,aAAAA;ADxCkF;AACA;AACA;AACA;AACA;AACA;AC0C7F,IAAA;ADxC6F,EAAA;ACyCjG;AAhBSE;AAkBoG;AAC1E,EAAA;AAEL,EAAA;AACgC,IAAA;AACX,IAAA;AAClB,MAAA;AACX,QAAA;AAC2CC,QAAAA;AACnC,QAAA;AACJ,QAAA;AACd,MAAA;AACJ,IAAA;AACyC,IAAA;AAAa,MAAA;AAAK,IAAA;AAChB,IAAA;AACzBA,IAAAA;AACtB,EAAA;AAEO5B,EAAAA;AACX;AAnBS6B;AAqBgD;AACf,EAAA;AACM9B,EAAAA;AACJ,EAAA;AAAC,IAAA;AAAO+B,IAAAA;AAAU,EAAA;AAAC,IAAA;AAAOA,IAAAA;ADlC2B,EAAA;ACmC5D/B,EAAAA;AACrC;AALSgC;AAOuD;AACpB,EAAA;AAAEhC,IAAAA;AAAY,IAAA;AAAuC,IAAA;AAAQ,EAAA;AAC5E,EAAA;AACgE,IAAA;AACzF,EAAA;AACJ;AALSiC;AAOgC;AACE,EAAA;AACH,EAAA;AACwB,IAAA;AACJ,IAAA;AACxD,EAAA;AAC4D,EAAA;AACK,EAAA;AAC1D,EAAA;AACX;AATSC;AAWAb;AACc,EAAA;AACS,IAAA;AACA,IAAA;AACI,IAAA;AD7B6D,EAAA;ACgCzCc,EAAAA;AACxD;AARSd;AAUA3D;AAC2C,EAAA;AACJ,EAAA;AACgBD,EAAAA;AAChE;AAJSC;AAMuC;AACjC,EAAA;AACa,EAAA;AACY0E,IAAAA;AACF,IAAA;AACK,IAAA;AAC4C,MAAA;AACzC,QAAA;AAClC,MAAA;AACJ,IAAA;AACJ,EAAA;AACOC,EAAAA;AACX;AAZSC;AAcgB;AACM,EAAA;AAAiB,IAAA;AAAiBC,EAAAA;AACf,IAAA;AACLC,IAAAA;AAC9B,IAAA;AAACA,MAAAA;AD3BiF,IAAA;AC4B7F,EAAA;AACJ;AANSC;AAQyB;AACyD,EAAA;AAC3F;AAFSC;AAI0B;AAC8D,EAAA;AACjG;AAFSC;AAIyB;AACFC,EAAAA;AACyB,EAAA;AACzD;AAHSC;AAK8B;AAClBC,EAAAA;AACrB;AAFSC;AAI0C;AACd,EAAA;AACUC,IAAAA;AAChBC,IAAAA;AAC3B,EAAA;AAE8BC,EAAAA;AACVF,EAAAA;AACGC,EAAAA;AAC3B;AATeE;AAY4CC;AAElB;AACcvC,EAAAA;AACjBA,IAAAA;AACjB,IAAA;AACjB,EAAA;AACJ;AD7BiG;AACA;AACA;AACA;AACA;AACA","file":"/Volumes/Projects/wexts/packages/dist/cli/index.js","sourcesContent":[null,"#!/usr/bin/env node\n\nimport { Command } from 'commander';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { spawnSync } from 'child_process';\nimport { createRequire } from 'module';\nimport { logger } from '../core/logger';\nimport { formatWextsError, WextsError } from '../errors';\n\ninterface CommonOptions {\n cwd?: string;\n}\n\nexport function createCliProgram(): Command {\n const program = new Command();\n\n program\n .name('wexts')\n .description('Wexts - production-focused single-runtime Next.js + NestJS toolkit')\n .version(readPackageVersion());\n\n program\n .command('create <project-name>')\n .description('Create a verified Wexts starter')\n .option('-t, --template <template>', 'Template to use (starter|legacy)', 'starter')\n .option('--skip-install', 'Skip dependency installation', false)\n .action(async (projectName: string, options: { template: string; skipInstall: boolean }) => {\n await createProject(projectName, options.template, { skipInstall: options.skipInstall });\n });\n\n program\n .command('dev')\n .description('Start local development processes')\n .option('-a, --api <path>', 'Path to API project', './apps/api')\n .option('-w, --web <path>', 'Path to Web project', './apps/web')\n .option('-p, --port <port>', 'Port for web server', '3000')\n .option('--api-port <port>', 'Port for API server', '5050')\n .option('--proxy', 'Enable development proxy on a separate proxy port', false)\n .action(async (options: { api: string; web: string; port: string; apiPort: string; proxy: boolean }) => {\n const { FusionDevServer } = await import('../dev-server/index.js');\n const server = new FusionDevServer();\n await server.start({\n apiPath: options.api,\n webPath: options.web,\n webPort: Number(options.port),\n apiPort: Number(options.apiPort),\n useProxy: options.proxy,\n });\n });\n\n program\n .command('generate [type] [name]')\n .alias('g')\n .description('Generate RPC manifest/client, or scaffold a minimal RPC service')\n .option('-p, --project <path>', 'Path to NestJS project', './apps/api')\n .option('-o, --output <path>', 'Output directory for generated RPC client', './apps/web/lib/wexts')\n .option('--force', 'Overwrite generated files if they already exist', false)\n .action(async (type: string | undefined, name: string | undefined, options: { project: string; output: string; force: boolean }) => {\n if (!type || (type === 'rpc' && !name)) {\n const { generateRpcClient } = await import('../codegen/index.js');\n const manifest = await generateRpcClient({\n projectPath: path.resolve(options.project),\n outputPath: path.resolve(options.output),\n });\n logger.success(`Generated Wexts RPC client for ${manifest.services.length} service(s).`);\n return;\n }\n\n if (isScaffoldGenerator(type)) {\n const targetRoot = type === 'config' ? process.cwd() : path.resolve(options.project);\n const changedFiles = await scaffoldGenerator({\n type,\n name,\n targetRoot,\n force: options.force,\n });\n for (const file of changedFiles) logger.info(`created ${path.relative(process.cwd(), file)}`);\n logger.success(`Generated ${type}${name ? ` ${name}` : ''}.`);\n return;\n }\n\n throw new Error(`Unknown generator \"${type}\". Supported generators: rpc, service, module, entity, guard, config.`);\n });\n\n program\n .command('codegen')\n .description('Alias for wexts generate rpc')\n .option('-p, --project <path>', 'Path to NestJS project', './apps/api')\n .option('-o, --output <path>', 'Output directory for generated RPC client', './apps/web/lib/wexts')\n .action(async (options: { project: string; output: string }) => {\n const { generateRpcClient } = await import('../codegen/index.js');\n const manifest = await generateRpcClient({\n projectPath: path.resolve(options.project),\n outputPath: path.resolve(options.output),\n });\n logger.success(`Generated Wexts RPC client for ${manifest.services.length} service(s).`);\n });\n\n program\n .command('build')\n .description('Build a Wexts project for production')\n .option('--skip-generate', 'Skip RPC generation before build', false)\n .option('-p, --project <path>', 'Path to NestJS project', './apps/api')\n .option('-o, --output <path>', 'Output directory for generated RPC client', './apps/web/lib/wexts')\n .action(async (options: { skipGenerate: boolean; project: string; output: string }) => {\n if (!options.skipGenerate && fs.existsSync(options.project)) {\n const { generateRpcClient } = await import('../codegen/index.js');\n await generateRpcClient({\n projectPath: path.resolve(options.project),\n outputPath: path.resolve(options.output),\n });\n }\n runScript('build', { cwd: process.cwd() });\n });\n\n program\n .command('start')\n .description('Start the production Wexts runtime')\n .option('-c, --config <path>', 'Runtime config module path', './wexts.runtime.js')\n .option('-p, --port <port>', 'Port to listen on', process.env.PORT ?? '3000')\n .action(async (options: { config: string; port: string }) => {\n const { startWextsRuntime } = await import('../runtime/index.js');\n const configPath = path.resolve(options.config);\n const runtimeConfig = fs.existsSync(configPath)\n ? await loadRuntimeConfig(configPath)\n : {};\n await startWextsRuntime({\n ...runtimeConfig,\n port: Number(options.port),\n dev: false,\n });\n });\n\n program\n .command('vercel-build')\n .description('Build for Vercel using Build Output API v3')\n .option('-p, --project <path>', 'Path to NestJS project', './apps/api')\n .option('-o, --output <path>', 'Output dir for RPC client', './apps/web/lib/wexts')\n .option('-c, --config <path>', 'Runtime config module path', './wexts.runtime.js')\n .option('--skip-codegen', 'Skip RPC generation', false)\n .option('--skip-build', 'Skip project build step', false)\n .option('--node-version <version>', 'Node.js version for Vercel function', '20')\n .option('--max-duration <seconds>', 'Max duration for serverless function', '30')\n .action(async (options: {\n project: string;\n output: string;\n config: string;\n skipCodegen: boolean;\n skipBuild: boolean;\n nodeVersion: string;\n maxDuration: string;\n }) => {\n const { buildVercelOutput } = await import('../vercel-builder/index.js');\n const result = await buildVercelOutput({\n rootDir: process.cwd(),\n apiProjectPath: options.project,\n rpcOutputPath: options.output,\n runtimeConfigPath: options.config,\n skipCodegen: options.skipCodegen,\n skipBuild: options.skipBuild,\n nodeVersion: options.nodeVersion,\n maxDuration: Number(options.maxDuration),\n });\n if (result.warnings.length > 0) {\n for (const warning of result.warnings) logger.warn(warning);\n }\n if (result.errors.length > 0) {\n for (const error of result.errors) logger.error(error);\n process.exit(1);\n }\n logger.success('Vercel build output ready at .vercel/output');\n });\n\n program\n .command('doctor')\n .description('Validate Wexts project configuration')\n .option('--security', 'Run security-specific checks', false)\n .action(async (options: { security: boolean }) => {\n const result = runDoctor(process.cwd(), options.security);\n for (const warning of result.warnings) logger.warn(warning);\n for (const error of result.errors) logger.error(error);\n if (result.errors.length > 0) process.exit(1);\n logger.success(options.security ? 'Security doctor passed.' : 'Doctor passed.');\n });\n\n return program;\n}\n\nexport interface DoctorResult {\n errors: string[];\n warnings: string[];\n}\n\nexport function runDoctor(cwd: string, security = false): DoctorResult {\n const result: DoctorResult = { errors: [], warnings: [] };\n const pkgPath = path.join(cwd, 'package.json');\n\n if (!fs.existsSync(pkgPath)) {\n result.errors.push('package.json not found.');\n return result;\n }\n\n const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));\n if (!pkg.packageManager?.startsWith('pnpm@')) {\n result.warnings.push('packageManager should pin pnpm.');\n }\n\n for (const dir of ['apps/api', 'apps/web']) {\n if (!fs.existsSync(path.join(cwd, dir))) {\n result.warnings.push(`${dir} not found; some Wexts commands may need explicit paths.`);\n }\n }\n\n if (fs.existsSync(path.join(cwd, 'apps/api')) && fs.existsSync(path.join(cwd, 'apps/web'))) {\n result.warnings.push('Development mode starts separate web/API processes. Single-port serving is the production `wexts start` runtime path.');\n }\n\n if (security) {\n const source = readAllText(cwd, ['apps/api/src', 'packages/templates/nestjs-api/src']);\n if (source.includes('default-secret')) {\n result.errors.push('JWT fallback \"default-secret\" found. Production apps must fail without a strong JWT_SECRET.');\n }\n if (/origin:\\s*['\"]\\*['\"]/.test(source)) {\n result.errors.push('Wildcard CORS origin found. Use an explicit origin allowlist.');\n }\n }\n\n return result;\n}\n\nexport async function createProject(\n projectName: string,\n template: string,\n options: { skipInstall: boolean; wextsDependency?: string }\n): Promise<void> {\n const projectPath = path.join(process.cwd(), projectName);\n if (fs.existsSync(projectPath)) {\n throw new Error(`Directory already exists: ${projectName}`);\n }\n\n fs.mkdirSync(projectPath, { recursive: true });\n\n if (template === 'starter') {\n await createVerifiedStarter(projectPath, projectName, options.wextsDependency ?? resolveCreateWextsDependency(projectPath));\n } else if (template === 'legacy') {\n createLegacyProject(projectPath, projectName);\n } else {\n throw new Error(`Unknown template \"${template}\". Supported templates: starter, legacy.`);\n }\n\n if (!options.skipInstall) {\n runCommand(detectPackageManager(projectPath), ['install'], projectPath);\n }\n}\n\nasync function createVerifiedStarter(projectPath: string, projectName: string, wextsDependency: string): Promise<void> {\n const files: Record<string, string> = {\n 'pnpm-workspace.yaml': \"packages:\\n - 'apps/*'\\n\",\n 'package.json': JSON.stringify({\n name: projectName,\n version: '0.1.0',\n private: true,\n packageManager: 'pnpm@10.22.0',\n scripts: {\n dev: 'wexts dev',\n generate: 'wexts generate -p apps/api -o apps/web/lib/wexts',\n build: 'pnpm run generate && tsc -p apps/api/tsconfig.json && next build apps/web',\n start: 'wexts start -c ./wexts.runtime.js',\n 'vercel-build': 'wexts vercel-build -p apps/api -o apps/web/lib/wexts -c ./wexts.runtime.js',\n doctor: 'wexts doctor',\n 'doctor:security': 'wexts doctor --security',\n },\n dependencies: {\n '@nestjs/common': '^11.1.19',\n '@nestjs/core': '^11.1.19',\n '@nestjs/platform-fastify': '^11.1.19',\n next: '16.2.4',\n react: '^19.2.5',\n 'react-dom': '^19.2.5',\n 'reflect-metadata': '^0.2.2',\n rxjs: '^7.8.1',\n wexts: wextsDependency,\n },\n devDependencies: {\n '@types/node': '^22.19.1',\n '@types/react': '^19.2.14',\n '@types/react-dom': '^19.2.3',\n typescript: '^5.9.3',\n },\n }, null, 2),\n 'apps/api/package.json': JSON.stringify({\n name: `${projectName}-api`,\n private: true,\n scripts: {\n 'start:dev': 'tsc -w -p tsconfig.json',\n },\n }, null, 2),\n 'apps/api/tsconfig.json': JSON.stringify({\n compilerOptions: {\n target: 'ES2023',\n module: 'NodeNext',\n moduleResolution: 'NodeNext',\n experimentalDecorators: true,\n emitDecoratorMetadata: true,\n strict: true,\n esModuleInterop: true,\n skipLibCheck: true,\n outDir: 'dist',\n rootDir: 'src',\n },\n include: ['src/**/*.ts'],\n }, null, 2),\n 'apps/api/src/hello.service.ts': `import { Injectable } from '@nestjs/common';\nimport { RpcMethod, RpcService } from 'wexts/nest';\n\n@Injectable()\n@RpcService({ name: 'hello', requireAuth: false })\nexport class HelloService {\n @RpcMethod()\n async sayHello(name: string): Promise<string> {\n return \\`Hello, \\${name}!\\`;\n }\n}\n`,\n 'apps/web/package.json': JSON.stringify({\n name: `${projectName}-web`,\n private: true,\n scripts: {\n dev: 'next dev -p 3000',\n },\n }, null, 2),\n 'apps/web/tsconfig.json': JSON.stringify({\n compilerOptions: {\n target: 'ES2022',\n lib: ['dom', 'dom.iterable', 'es2022'],\n allowJs: false,\n skipLibCheck: true,\n strict: true,\n noEmit: true,\n esModuleInterop: true,\n module: 'esnext',\n moduleResolution: 'bundler',\n resolveJsonModule: true,\n isolatedModules: true,\n jsx: 'react-jsx',\n incremental: true,\n plugins: [{ name: 'next' }],\n },\n include: ['next-env.d.ts', '**/*.ts', '**/*.tsx', '.next/types/**/*.ts', '.next/dev/types/**/*.ts'],\n exclude: ['node_modules'],\n }, null, 2),\n 'apps/web/next-env.d.ts': `/// <reference types=\"next\" />\n/// <reference types=\"next/image-types/global\" />\n\n// This file is generated by Next.js. Do not edit.\n`,\n 'apps/web/next.config.ts': `import type { NextConfig } from 'next';\n\nconst nextConfig: NextConfig = {\n output: 'standalone',\n};\n\nexport default nextConfig;\n`,\n 'apps/web/app/layout.tsx': `import type { ReactNode } from 'react';\nimport { WextsProvider } from '../lib/wexts-provider';\n\nexport default function RootLayout({ children }: { children: ReactNode }) {\n return (\n <html lang=\"en\">\n <body>\n <WextsProvider>{children}</WextsProvider>\n </body>\n </html>\n );\n}\n`,\n 'apps/web/app/page.tsx': `'use client';\n\nimport { useState } from 'react';\nimport { useWexts } from '../lib/wexts-provider';\n\nexport default function Page() {\n const wexts = useWexts();\n const [message, setMessage] = useState('Not called yet');\n\n return (\n <main>\n <h1>Wexts Hello RPC</h1>\n <button\n type=\"button\"\n onClick={async () => {\n setMessage(await wexts.hello.sayHello('Bob'));\n }}\n >\n Call RPC\n </button>\n <p>{message}</p>\n </main>\n );\n}\n`,\n 'apps/web/lib/wexts-provider.tsx': `'use client';\n\nimport { FusionProvider, useWexts as useGeneratedWexts } from 'wexts/next';\nimport { createWextsClient, type WextsClient } from './wexts/client';\n\nexport function WextsProvider({ children }: { children: React.ReactNode }) {\n return (\n <FusionProvider rpcClient={createWextsClient({ baseUrl: '/rpc' })}>\n {children}\n </FusionProvider>\n );\n}\n\nexport function useWexts(): WextsClient {\n return useGeneratedWexts<WextsClient>();\n}\n`,\n 'wexts.runtime.js': `const { HelloService } = require('./apps/api/dist/hello.service.js');\n\nmodule.exports = {\n nextDir: './apps/web',\n rpcManifestPath: './apps/web/lib/wexts/wexts.rpc.manifest.json',\n rpcServices: {\n hello: new HelloService(),\n },\n security: {\n allowedOrigins: ['http://localhost:3000'],\n },\n};\n`,\n 'README.md': `# ${projectName}\n\nVerified Wexts starter with a generated Hello RPC client.\n\n\\`\\`\\`bash\npnpm install\npnpm run generate\npnpm run build\npnpm run doctor\npnpm run doctor:security\npnpm start\n\\`\\`\\`\n`,\n '.cursorrules': `# Wexts Project AI Rules\n\nYou are an expert full-stack developer working on a Wexts application.\nWexts is a unified single-runtime toolkit that combines Next.js (frontend) and NestJS (backend) using a highly typed RPC bridge.\n\n## Project Structure\n- \\`apps/api/\\`: The NestJS backend. Contains business logic, database models, and RPC services.\n- \\`apps/web/\\`: The Next.js frontend. Contains UI components, pages, and consumes the RPC client.\n- \\`apps/web/lib/wexts\\`: The auto-generated typed RPC client (DO NOT EDIT MANUALLY).\n\n## Backend Guidelines (NestJS)\n1. **RPC Services**: To create an API endpoint, create a NestJS provider decorated with \\`@RpcService({ name: 'serviceName' })\\` and methods decorated with \\`@RpcMethod()\\`.\n2. **Imports**: Import \\`@RpcService\\` and \\`@RpcMethod\\` from \\`wexts/nest\\`.\n3. Do NOT manually create REST controllers unless explicitly needed for webhooks. Use the RPC bridge for all internal frontend-backend communication.\n4. **Auth**: If a service requires authentication, set \\`@RpcService({ requireAuth: true })\\`.\n\n## Frontend Guidelines (Next.js)\n1. **RPC Usage**: To call the backend, import the \\`api\\` client from \\`@/lib/wexts\\` or your designated Wexts client file (e.g., \\`useWexts()\\`).\n2. **Syntax**: \\`const data = await api.serviceName.methodName(args);\\`\n3. The \\`api\\` object is fully type-safe. Rely on TypeScript autocomplete rather than guessing endpoints.\n\n## Development Workflow\n- When asked to add a new full-stack feature:\n 1. Add the database model (Prisma).\n 2. Create/update the NestJS RPC service in \\`apps/api\\`.\n 3. Remind the user to run \\`wexts generate\\` (or \\`pnpm generate\\`) so the types sync.\n 4. Build the UI in Next.js using the new \\`api\\` methods.\n- **Never** hardcode \\`fetch('http://localhost:3000/...')\\`. ALWAYS use the generated \\`api\\` SDK.\n`,\n };\n\n for (const [relativePath, content] of Object.entries(files)) {\n const absolutePath = path.join(projectPath, relativePath);\n fs.mkdirSync(path.dirname(absolutePath), { recursive: true });\n fs.writeFileSync(absolutePath, content);\n }\n\n const { generateRpcClient } = await import('../codegen/index.js');\n await generateRpcClient({\n projectPath: path.join(projectPath, 'apps/api'),\n outputPath: path.join(projectPath, 'apps/web/lib/wexts'),\n });\n}\n\nfunction createLegacyProject(projectPath: string, projectName: string): void {\n const templatePath = findTemplatePath();\n if (!templatePath) {\n throw new Error('Template directory not found in package.');\n }\n\n fs.mkdirSync(path.join(projectPath, 'apps'), { recursive: true });\n fs.cpSync(path.join(templatePath, 'nestjs-api'), path.join(projectPath, 'apps/api'), { recursive: true });\n fs.cpSync(path.join(templatePath, 'nextjs-web'), path.join(projectPath, 'apps/web'), { recursive: true });\n fs.rmSync(path.join(projectPath, 'apps/web/package-lock.json'), { force: true });\n fs.rmSync(path.join(projectPath, 'apps/api/package-lock.json'), { force: true });\n fs.writeFileSync(path.join(projectPath, 'pnpm-workspace.yaml'), \"packages:\\n - 'apps/*'\\n\");\n fs.writeFileSync(path.join(projectPath, 'package.json'), JSON.stringify({\n name: projectName,\n private: true,\n packageManager: 'pnpm@10.22.0',\n scripts: {\n dev: 'wexts dev',\n generate: 'wexts generate',\n build: 'wexts build',\n start: 'wexts start',\n doctor: 'wexts doctor',\n },\n devDependencies: {\n wexts: `^${readPackageVersion()}`,\n },\n }, null, 2));\n}\n\nfunction resolveCreateWextsDependency(projectPath: string): string {\n const packageRoot = path.resolve(__dirname, '../..');\n const cwdLocalPackage = path.join(process.cwd(), 'node_modules/wexts');\n\n try {\n if (fs.existsSync(cwdLocalPackage) && fs.realpathSync(cwdLocalPackage) === fs.realpathSync(packageRoot)) {\n return `file:${path.relative(projectPath, cwdLocalPackage)}`;\n }\n } catch {\n // Fall back to semver for normal npx/npm usage.\n }\n\n return `^${readPackageVersion()}`;\n}\n\ntype ScaffoldGeneratorType = 'rpc' | 'service' | 'module' | 'entity' | 'guard' | 'config';\n\ninterface ScaffoldGeneratorOptions {\n type: ScaffoldGeneratorType;\n name?: string;\n targetRoot: string;\n force?: boolean;\n}\n\nexport async function scaffoldGenerator(options: ScaffoldGeneratorOptions): Promise<string[]> {\n if (options.type !== 'config' && !options.name) {\n throw new WextsError({\n code: 'WEXTS_CLI_GENERATOR_NAME_REQUIRED',\n message: `Generator \"${options.type}\" requires a name.`,\n suggestedFix: `Run \\`wexts generate ${options.type} hello\\` or use \\`wexts generate config\\`.`,\n docsSlug: 'cli',\n });\n }\n\n if (options.type === 'config') {\n return writeGeneratedFiles(options.targetRoot, [{\n relativePath: 'wexts.runtime.js',\n content: `/** @type {import('wexts/runtime').WextsRuntimeConfig} */\nmodule.exports = {\n rootDir: __dirname,\n port: Number(process.env.PORT || 3000),\n rpcManifestPath: 'apps/web/lib/wexts/wexts.rpc.manifest.json',\n security: {\n enabled: true,\n production: process.env.NODE_ENV === 'production',\n allowedOrigins: process.env.WEXTS_ALLOWED_ORIGINS?.split(',').filter(Boolean) || [],\n },\n};\n`,\n }], Boolean(options.force));\n }\n\n const rawName = options.name!;\n const name = toKebabCase(rawName);\n const classBase = toPascalCase(name);\n const srcRoot = path.join(options.targetRoot, 'src');\n\n const filesByType: Record<Exclude<ScaffoldGeneratorType, 'config'>, { relativePath: string; content: string }[]> = {\n rpc: rpcServiceFiles(name, classBase),\n service: [{\n relativePath: path.join('src', name, `${name}.service.ts`),\n content: `import { Injectable } from '@nestjs/common';\n\n@Injectable()\nexport class ${classBase}Service {\n async execute(): Promise<string> {\n return '${toCamelCase(name)}';\n }\n}\n`,\n }],\n module: [{\n relativePath: path.join('src', name, `${name}.module.ts`),\n content: `import { Module } from '@nestjs/common';\n\n@Module({})\nexport class ${classBase}Module {}\n`,\n }],\n entity: [{\n relativePath: path.join('src', name, `${name}.entity.ts`),\n content: `export interface ${classBase}Entity {\n id: string;\n createdAt: Date;\n updatedAt: Date;\n}\n`,\n }],\n guard: [{\n relativePath: path.join('src', name, `${name}.guard.ts`),\n content: `import { CanActivate, ExecutionContext, Injectable } from '@nestjs/common';\n\n@Injectable()\nexport class ${classBase}Guard implements CanActivate {\n canActivate(_context: ExecutionContext): boolean {\n return true;\n }\n}\n`,\n }],\n };\n\n fs.mkdirSync(srcRoot, { recursive: true });\n return writeGeneratedFiles(options.targetRoot, filesByType[options.type], Boolean(options.force));\n}\n\nfunction isScaffoldGenerator(type: string): type is ScaffoldGeneratorType {\n return ['rpc', 'service', 'module', 'entity', 'guard', 'config'].includes(type);\n}\n\nfunction rpcServiceFiles(serviceName: string, classBase: string): { relativePath: string; content: string }[] {\n return [{\n relativePath: path.join('src', serviceName, `${serviceName}.service.ts`),\n content: `import { Injectable } from '@nestjs/common';\nimport { RpcMethod, RpcService } from 'wexts/nest';\n\n@Injectable()\n@RpcService({ name: '${toCamelCase(serviceName)}', requireAuth: false })\nexport class ${classBase}Service {\n @RpcMethod()\n async sayHello(name: string): Promise<string> {\n return \\`Hello, \\${name}!\\`;\n }\n}\n`,\n }];\n}\n\nfunction writeGeneratedFiles(root: string, files: { relativePath: string; content: string }[], force: boolean): string[] {\n const changedFiles: string[] = [];\n\n for (const file of files) {\n const absolutePath = path.join(root, file.relativePath);\n if (fs.existsSync(absolutePath) && !force) {\n throw new WextsError({\n code: 'WEXTS_CLI_GENERATOR_FILE_EXISTS',\n message: `Refusing to overwrite existing file: ${absolutePath}`,\n suggestedFix: 'Review the file, then rerun with --force if overwriting is intentional.',\n docsSlug: 'cli',\n });\n }\n fs.mkdirSync(path.dirname(absolutePath), { recursive: true });\n fs.writeFileSync(absolutePath, file.content);\n changedFiles.push(absolutePath);\n }\n\n return changedFiles;\n}\n\nfunction runScript(script: string, options: CommonOptions): void {\n const cwd = options.cwd ?? process.cwd();\n const packageManager = detectPackageManager(cwd);\n const args = packageManager === 'npm' ? ['run', script] : ['run', script];\n runCommand(packageManager, args, cwd);\n}\n\nfunction runCommand(command: string, args: string[], cwd: string): void {\n const result = spawnSync(command, args, { cwd, stdio: 'inherit', shell: process.platform === 'win32' });\n if (result.status !== 0) {\n throw new Error(`${command} ${args.join(' ')} failed with exit code ${result.status}`);\n }\n}\n\nfunction detectPackageManager(cwd: string): 'pnpm' | 'npm' {\n const packageJsonPath = path.join(cwd, 'package.json');\n if (fs.existsSync(packageJsonPath)) {\n const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')) as { packageManager?: string };\n if (pkg.packageManager?.startsWith('pnpm@')) return 'pnpm';\n }\n if (fs.existsSync(path.join(cwd, 'pnpm-lock.yaml'))) return 'pnpm';\n if (fs.existsSync(path.join(cwd, 'pnpm-workspace.yaml'))) return 'pnpm';\n return 'npm';\n}\n\nfunction findTemplatePath(): string | undefined {\n const candidates = [\n path.resolve(__dirname, '../../templates'),\n path.resolve(__dirname, '../templates'),\n path.resolve(process.cwd(), 'packages/templates'),\n ];\n\n return candidates.find((candidate) => fs.existsSync(candidate));\n}\n\nfunction readPackageVersion(): string {\n const packageJsonPath = path.resolve(__dirname, '../../package.json');\n if (!fs.existsSync(packageJsonPath)) return '0.0.0';\n return JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')).version as string;\n}\n\nfunction readAllText(cwd: string, dirs: string[]): string {\n let text = '';\n for (const dir of dirs) {\n const absolute = path.join(cwd, dir);\n if (!fs.existsSync(absolute)) continue;\n for (const file of walk(absolute)) {\n if (file.endsWith('.ts') || file.endsWith('.tsx') || file.endsWith('.js')) {\n text += fs.readFileSync(file, 'utf8');\n }\n }\n }\n return text;\n}\n\nfunction walk(dir: string): string[] {\n return fs.readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {\n const absolute = path.join(dir, entry.name);\n if (entry.isDirectory()) return walk(absolute);\n return [absolute];\n });\n}\n\nfunction toKebabCase(value: string): string {\n return value.replace(/([a-z0-9])([A-Z])/g, '$1-$2').replace(/[_\\s]+/g, '-').toLowerCase();\n}\n\nfunction toPascalCase(value: string): string {\n return toKebabCase(value).split('-').map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join('');\n}\n\nfunction toCamelCase(value: string): string {\n const pascal = toPascalCase(value);\n return pascal.charAt(0).toLowerCase() + pascal.slice(1);\n}\n\nfunction pathToFileUrl(filePath: string): string {\n return `file://${filePath}`;\n}\n\nasync function loadRuntimeConfig(configPath: string): Promise<Record<string, unknown>> {\n if (configPath.endsWith('.mjs')) {\n const mod = await import(pathToFileUrl(configPath));\n return (mod.default ?? mod) as Record<string, unknown>;\n }\n\n const require = createRequire(__filename);\n const mod = require(configPath);\n return (mod.default ?? mod) as Record<string, unknown>;\n}\n\nconst invokedAsCli = process.argv[1]\n && (path.basename(process.argv[1]) === 'wexts' || path.basename(process.argv[1]) === 'wexts.cjs' || path.resolve(process.argv[1]).includes(`${path.sep}dist${path.sep}cli${path.sep}index`));\n\nif (invokedAsCli && !process.env.VITEST) {\n createCliProgram().parseAsync(process.argv).catch((error) => {\n logger.error(formatWextsError(error));\n process.exit(1);\n });\n}\n"]}
1
+ {"version":3,"sources":["/Volumes/Projects/wexts/packages/dist/cli/index.js","../../src/cli/index.ts"],"names":["createCliProgram","program","Command","name","description","version","readPackageVersion","command","option","action","projectName","options","createProject","template","skipInstall","FusionDevServer","server","start","apiPath","api","webPath","web","webPort","Number","port","apiPort","useProxy","proxy","rootDir","process","cwd","runtimeConfigPath","config","alias","type","generateRpcClient","manifest","projectPath","resolve","project","outputPath","output","logger","success","services","length","isScaffoldGenerator","targetRoot","changedFiles","scaffoldGenerator","force","file","info","relative","runtimeConfig","dev","skipCodegen","skipBuild","nodeVersion","warning","error","result","runDoctor","resolveCreateWextsDependency","wextsDependency","relativePath","content","findTemplatePath","src","createVerifiedStarter","createLegacyProject","packageRoot","cwdLocalPackage","rawName","classBase","serviceName","rpcServiceFiles","absolutePath","writeGeneratedFiles","script","runScript","runCommand","detectPackageManager","candidate","dir","text","readAllText","entry","absolute","walk","toKebabCase","toPascalCase","value","toCamelCase","filePath","pathToFileUrl","lastError","configPath","mod","__filename","retry","loadRuntimeConfig","basename"],"mappings":"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","file":"/Volumes/Projects/wexts/packages/dist/cli/index.js","sourcesContent":[null,"#!/usr/bin/env node\n\nimport { Command } from 'commander';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { spawnSync } from 'child_process';\nimport { createRequire } from 'module';\nimport { logger } from '../core/logger';\nimport { formatWextsError, WextsError } from '../errors';\n\ninterface CommonOptions {\n cwd?: string;\n}\n\nexport function createCliProgram(): Command {\n const program = new Command();\n\n program\n .name('wexts')\n .description('Wexts - production-focused single-runtime Next.js + NestJS toolkit')\n .version(readPackageVersion());\n\n program\n .command('create <project-name>')\n .description('Create a verified Wexts starter')\n .option('-t, --template <template>', 'Template to use (starter|legacy)', 'starter')\n .option('--skip-install', 'Skip dependency installation', false)\n .action(async (projectName: string, options: { template: string; skipInstall: boolean }) => {\n await createProject(projectName, options.template, { skipInstall: options.skipInstall });\n });\n\n program\n .command('dev')\n .description('Start local development processes')\n .option('-a, --api <path>', 'Path to API project', './apps/api')\n .option('-w, --web <path>', 'Path to Web project', './apps/web')\n .option('-p, --port <port>', 'Port for web server', '3000')\n .option('--api-port <port>', 'Port for API server', '5050')\n .option('--proxy', 'Enable development proxy on a separate proxy port', false)\n .option('-c, --config <path>', 'Runtime config module path', './wexts.runtime.js')\n .action(async (options: { api: string; web: string; port: string; apiPort: string; proxy: boolean; config: string }) => {\n const { FusionDevServer } = await import('../dev-server/index.js');\n const server = new FusionDevServer();\n await server.start({\n apiPath: options.api,\n webPath: options.web,\n webPort: Number(options.port),\n apiPort: Number(options.apiPort),\n useProxy: options.proxy,\n rootDir: process.cwd(),\n runtimeConfigPath: options.config,\n });\n });\n\n program\n .command('generate [type] [name]')\n .alias('g')\n .description('Generate RPC manifest/client, or scaffold a minimal RPC service')\n .option('-p, --project <path>', 'Path to NestJS project', './apps/api')\n .option('-o, --output <path>', 'Output directory for generated RPC client', './apps/web/lib/wexts')\n .option('--force', 'Overwrite generated files if they already exist', false)\n .action(async (type: string | undefined, name: string | undefined, options: { project: string; output: string; force: boolean }) => {\n if (!type || (type === 'rpc' && !name)) {\n const { generateRpcClient } = await import('../codegen/index.js');\n const manifest = await generateRpcClient({\n projectPath: path.resolve(options.project),\n outputPath: path.resolve(options.output),\n });\n logger.success(`Generated Wexts RPC client for ${manifest.services.length} service(s).`);\n return;\n }\n\n if (isScaffoldGenerator(type)) {\n const targetRoot = type === 'config' ? process.cwd() : path.resolve(options.project);\n const changedFiles = await scaffoldGenerator({\n type,\n name,\n targetRoot,\n force: options.force,\n });\n for (const file of changedFiles) logger.info(`created ${path.relative(process.cwd(), file)}`);\n logger.success(`Generated ${type}${name ? ` ${name}` : ''}.`);\n return;\n }\n\n throw new Error(`Unknown generator \"${type}\". Supported generators: rpc, service, module, entity, guard, config.`);\n });\n\n program\n .command('codegen')\n .description('Alias for wexts generate rpc')\n .option('-p, --project <path>', 'Path to NestJS project', './apps/api')\n .option('-o, --output <path>', 'Output directory for generated RPC client', './apps/web/lib/wexts')\n .action(async (options: { project: string; output: string }) => {\n const { generateRpcClient } = await import('../codegen/index.js');\n const manifest = await generateRpcClient({\n projectPath: path.resolve(options.project),\n outputPath: path.resolve(options.output),\n });\n logger.success(`Generated Wexts RPC client for ${manifest.services.length} service(s).`);\n });\n\n program\n .command('build')\n .description('Build a Wexts project for production')\n .option('--skip-generate', 'Skip RPC generation before build', false)\n .option('-p, --project <path>', 'Path to NestJS project', './apps/api')\n .option('-o, --output <path>', 'Output directory for generated RPC client', './apps/web/lib/wexts')\n .action(async (options: { skipGenerate: boolean; project: string; output: string }) => {\n if (!options.skipGenerate && fs.existsSync(options.project)) {\n const { generateRpcClient } = await import('../codegen/index.js');\n await generateRpcClient({\n projectPath: path.resolve(options.project),\n outputPath: path.resolve(options.output),\n });\n }\n runScript('build', { cwd: process.cwd() });\n });\n\n program\n .command('start')\n .description('Start the Wexts runtime')\n .option('-c, --config <path>', 'Runtime config module path', './wexts.runtime.js')\n .option('-p, --port <port>', 'Port to listen on', process.env.PORT ?? '3000')\n .option('--dev', 'Run the runtime in development mode', false)\n .action(async (options: { config: string; port: string; dev: boolean }) => {\n const { startWextsRuntime } = await import('../runtime/index.js');\n const configPath = path.resolve(options.config);\n const runtimeConfig = fs.existsSync(configPath)\n ? await loadRuntimeConfig(configPath, options.dev)\n : {};\n await startWextsRuntime({\n ...runtimeConfig,\n port: Number(options.port),\n dev: options.dev,\n });\n });\n\n program\n .command('vercel-build')\n .description('Build for Vercel using Build Output API v3')\n .option('-p, --project <path>', 'Path to NestJS project', './apps/api')\n .option('-o, --output <path>', 'Output dir for RPC client', './apps/web/lib/wexts')\n .option('-c, --config <path>', 'Runtime config module path', './wexts.runtime.js')\n .option('--skip-codegen', 'Skip RPC generation', false)\n .option('--skip-build', 'Skip project build step', false)\n .option('--node-version <version>', 'Node.js version for Vercel function', '20')\n .option('--max-duration <seconds>', 'Max duration for serverless function', '30')\n .action(async (options: {\n project: string;\n output: string;\n config: string;\n skipCodegen: boolean;\n skipBuild: boolean;\n nodeVersion: string;\n maxDuration: string;\n }) => {\n const { buildVercelOutput } = await import('../vercel-builder/index.js');\n const result = await buildVercelOutput({\n rootDir: process.cwd(),\n apiProjectPath: options.project,\n rpcOutputPath: options.output,\n runtimeConfigPath: options.config,\n skipCodegen: options.skipCodegen,\n skipBuild: options.skipBuild,\n nodeVersion: options.nodeVersion,\n maxDuration: Number(options.maxDuration),\n });\n if (result.warnings.length > 0) {\n for (const warning of result.warnings) logger.warn(warning);\n }\n if (result.errors.length > 0) {\n for (const error of result.errors) logger.error(error);\n process.exit(1);\n }\n logger.success('Vercel build output ready at .vercel/output');\n });\n\n program\n .command('doctor')\n .description('Validate Wexts project configuration')\n .option('--security', 'Run security-specific checks', false)\n .action(async (options: { security: boolean }) => {\n const result = runDoctor(process.cwd(), options.security);\n for (const warning of result.warnings) logger.warn(warning);\n for (const error of result.errors) logger.error(error);\n if (result.errors.length > 0) process.exit(1);\n logger.success(options.security ? 'Security doctor passed.' : 'Doctor passed.');\n });\n\n return program;\n}\n\nexport interface DoctorResult {\n errors: string[];\n warnings: string[];\n}\n\nexport function runDoctor(cwd: string, security = false): DoctorResult {\n const result: DoctorResult = { errors: [], warnings: [] };\n const pkgPath = path.join(cwd, 'package.json');\n\n if (!fs.existsSync(pkgPath)) {\n result.errors.push('package.json not found.');\n return result;\n }\n\n const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));\n if (!pkg.packageManager?.startsWith('pnpm@')) {\n result.warnings.push('packageManager should pin pnpm.');\n }\n\n for (const dir of ['apps/api', 'apps/web']) {\n if (!fs.existsSync(path.join(cwd, dir))) {\n result.warnings.push(`${dir} not found; some Wexts commands may need explicit paths.`);\n }\n }\n\n if (fs.existsSync(path.join(cwd, 'apps/api')) && fs.existsSync(path.join(cwd, 'apps/web'))) {\n result.warnings.push('Development mode starts an API compiler plus the Wexts runtime so `/rpc` and Next routes share the web port.');\n }\n\n if (security) {\n const source = readAllText(cwd, ['apps/api/src', 'packages/templates/nestjs-api/src']);\n if (source.includes('default-secret')) {\n result.errors.push('JWT fallback \"default-secret\" found. Production apps must fail without a strong JWT_SECRET.');\n }\n if (/origin:\\s*['\"]\\*['\"]/.test(source)) {\n result.errors.push('Wildcard CORS origin found. Use an explicit origin allowlist.');\n }\n }\n\n return result;\n}\n\nexport async function createProject(\n projectName: string,\n template: string,\n options: { skipInstall: boolean; wextsDependency?: string }\n): Promise<void> {\n const projectPath = path.join(process.cwd(), projectName);\n if (fs.existsSync(projectPath)) {\n throw new Error(`Directory already exists: ${projectName}`);\n }\n\n fs.mkdirSync(projectPath, { recursive: true });\n\n if (template === 'starter') {\n await createVerifiedStarter(projectPath, projectName, options.wextsDependency ?? resolveCreateWextsDependency(projectPath));\n } else if (template === 'legacy') {\n createLegacyProject(projectPath, projectName);\n } else {\n throw new Error(`Unknown template \"${template}\". Supported templates: starter, legacy.`);\n }\n\n if (!options.skipInstall) {\n runCommand(detectPackageManager(projectPath), ['install'], projectPath);\n }\n}\n\nasync function createVerifiedStarter(projectPath: string, projectName: string, wextsDependency: string): Promise<void> {\n const files: Record<string, string> = {\n 'pnpm-workspace.yaml': \"packages:\\n - 'apps/*'\\n\",\n 'package.json': JSON.stringify({\n name: projectName,\n version: '0.1.0',\n private: true,\n packageManager: 'pnpm@10.22.0',\n scripts: {\n dev: 'wexts dev',\n generate: 'wexts generate -p apps/api -o apps/web/lib/wexts',\n build: 'pnpm run generate && tsc -p apps/api/tsconfig.json && next build apps/web',\n start: 'wexts start -c ./wexts.runtime.js',\n 'vercel-build': 'wexts vercel-build -p apps/api -o apps/web/lib/wexts -c ./wexts.runtime.js',\n doctor: 'wexts doctor',\n 'doctor:security': 'wexts doctor --security',\n },\n dependencies: {\n wexts: wextsDependency,\n },\n }, null, 2),\n 'wexts.runtime.js': `const { HelloService } = require('./apps/api/dist/hello.service.js');\n\nmodule.exports = {\n nextDir: './apps/web',\n rpcManifestPath: './apps/web/lib/wexts/wexts.rpc.manifest.json',\n rpcServices: {\n hello: new HelloService(),\n },\n security: {\n allowedOrigins: ['http://localhost:3000'],\n },\n};\n`,\n 'README.md': `# ${projectName}\n\nVerified Wexts starter with Next.js and NestJS.\n\n\\`\\`\\`bash\npnpm install\npnpm run generate\npnpm run build\npnpm run dev\n\\`\\`\\`\n`,\n '.cursorrules': `# Wexts Project AI Rules\n\nYou are an expert full-stack developer working on a Wexts application.\nWexts is a unified single-runtime toolkit that combines Next.js (frontend) and NestJS (backend) using a highly typed RPC bridge.\n\n## Project Structure\n- \\`apps/api/\\`: The NestJS backend. Contains business logic, database models, and RPC services.\n- \\`apps/web/\\`: The Next.js frontend. Contains UI components, pages, and consumes the RPC client.\n- \\`apps/web/lib/wexts\\`: The auto-generated typed RPC client (DO NOT EDIT MANUALLY).\n\n## Backend Guidelines (NestJS)\n1. **RPC Services**: To create an API endpoint, create a NestJS provider decorated with \\`@RpcService({ name: 'serviceName' })\\` and methods decorated with \\`@RpcMethod()\\`.\n2. **Imports**: Import \\`@RpcService\\` and \\`@RpcMethod\\` from \\`wexts/nest\\`.\n3. Do NOT manually create REST controllers unless explicitly needed for webhooks. Use the RPC bridge for all internal frontend-backend communication.\n4. **Auth**: If a service requires authentication, set \\`@RpcService({ requireAuth: true })\\`.\n\n## Frontend Guidelines (Next.js)\n1. **RPC Usage**: To call the backend, import the \\`api\\` client from \\`@/lib/wexts\\` or your designated Wexts client file (e.g., \\`useWexts()\\`).\n2. **Syntax**: \\`const data = await api.serviceName.methodName(args);\\`\n3. The \\`api\\` object is fully type-safe. Rely on TypeScript autocomplete rather than guessing endpoints.\n`,\n };\n\n // Write root files\n for (const [relativePath, content] of Object.entries(files)) {\n const absolutePath = path.join(projectPath, relativePath);\n fs.mkdirSync(path.dirname(absolutePath), { recursive: true });\n fs.writeFileSync(absolutePath, content);\n }\n\n const templatePath = findTemplatePath();\n if (!templatePath) {\n throw new Error('Template directory not found in package.');\n }\n\n // Copy API template\n const apiTemplatePath = path.join(templatePath, 'nestjs-api');\n const apiDestPath = path.join(projectPath, 'apps/api');\n if (fs.existsSync(apiTemplatePath)) {\n fs.cpSync(apiTemplatePath, apiDestPath, {\n recursive: true,\n filter: (src) => {\n const basename = path.basename(src);\n return basename !== 'node_modules' && basename !== 'dist' && basename !== 'package-lock.json';\n },\n });\n const apiPkgPath = path.join(apiDestPath, 'package.json');\n if (fs.existsSync(apiPkgPath)) {\n const apiPkg = JSON.parse(fs.readFileSync(apiPkgPath, 'utf8'));\n apiPkg.name = `${projectName}-api`;\n if (apiPkg.dependencies?.wexts) apiPkg.dependencies.wexts = wextsDependency;\n fs.writeFileSync(apiPkgPath, JSON.stringify(apiPkg, null, 2));\n }\n }\n\n // Copy Web template\n const webTemplatePath = path.join(templatePath, 'nextjs-web');\n const webDestPath = path.join(projectPath, 'apps/web');\n if (fs.existsSync(webTemplatePath)) {\n fs.cpSync(webTemplatePath, webDestPath, {\n recursive: true,\n filter: (src) => {\n const basename = path.basename(src);\n return basename !== 'node_modules' && basename !== '.next' && basename !== 'package-lock.json';\n },\n });\n const webPkgPath = path.join(webDestPath, 'package.json');\n if (fs.existsSync(webPkgPath)) {\n const webPkg = JSON.parse(fs.readFileSync(webPkgPath, 'utf8'));\n webPkg.name = `${projectName}-web`;\n if (webPkg.dependencies?.wexts) webPkg.dependencies.wexts = wextsDependency;\n fs.writeFileSync(webPkgPath, JSON.stringify(webPkg, null, 2));\n }\n }\n\n // Attempt RPC generation if api exists\n if (fs.existsSync(path.join(apiDestPath, 'src'))) {\n try {\n const { generateRpcClient } = await import('../codegen/index.js');\n await generateRpcClient({\n projectPath: path.join(projectPath, 'apps/api'),\n outputPath: path.join(projectPath, 'apps/web/lib/wexts'),\n });\n } catch (e) {\n logger.warn('Initial RPC generation failed; you may need to run \"wexts generate\" after setup.');\n }\n }\n}\n\nfunction createLegacyProject(projectPath: string, projectName: string): void {\n const templatePath = findTemplatePath();\n if (!templatePath) {\n throw new Error('Template directory not found in package.');\n }\n\n fs.mkdirSync(path.join(projectPath, 'apps'), { recursive: true });\n fs.cpSync(path.join(templatePath, 'nestjs-api'), path.join(projectPath, 'apps/api'), { recursive: true });\n fs.cpSync(path.join(templatePath, 'nextjs-web'), path.join(projectPath, 'apps/web'), { recursive: true });\n fs.rmSync(path.join(projectPath, 'apps/web/package-lock.json'), { force: true });\n fs.rmSync(path.join(projectPath, 'apps/api/package-lock.json'), { force: true });\n fs.writeFileSync(path.join(projectPath, 'pnpm-workspace.yaml'), \"packages:\\n - 'apps/*'\\n\");\n fs.writeFileSync(path.join(projectPath, 'package.json'), JSON.stringify({\n name: projectName,\n private: true,\n packageManager: 'pnpm@10.22.0',\n scripts: {\n dev: 'wexts dev',\n generate: 'wexts generate',\n build: 'wexts build',\n start: 'wexts start',\n doctor: 'wexts doctor',\n },\n devDependencies: {\n wexts: `^${readPackageVersion()}`,\n },\n }, null, 2));\n}\n\nfunction resolveCreateWextsDependency(projectPath: string): string {\n const packageRoot = path.resolve(__dirname, '../..');\n const cwdLocalPackage = path.join(process.cwd(), 'node_modules/wexts');\n\n try {\n if (fs.existsSync(cwdLocalPackage) && fs.realpathSync(cwdLocalPackage) === fs.realpathSync(packageRoot)) {\n return `file:${path.relative(projectPath, cwdLocalPackage)}`;\n }\n } catch {\n // Fall back to semver for normal npx/npm usage.\n }\n\n return `^${readPackageVersion()}`;\n}\n\ntype ScaffoldGeneratorType = 'rpc' | 'service' | 'module' | 'entity' | 'guard' | 'config';\n\ninterface ScaffoldGeneratorOptions {\n type: ScaffoldGeneratorType;\n name?: string;\n targetRoot: string;\n force?: boolean;\n}\n\nexport async function scaffoldGenerator(options: ScaffoldGeneratorOptions): Promise<string[]> {\n if (options.type !== 'config' && !options.name) {\n throw new WextsError({\n code: 'WEXTS_CLI_GENERATOR_NAME_REQUIRED',\n message: `Generator \"${options.type}\" requires a name.`,\n suggestedFix: `Run \\`wexts generate ${options.type} hello\\` or use \\`wexts generate config\\`.`,\n docsSlug: 'cli',\n });\n }\n\n if (options.type === 'config') {\n return writeGeneratedFiles(options.targetRoot, [{\n relativePath: 'wexts.runtime.js',\n content: `/** @type {import('wexts/runtime').WextsRuntimeConfig} */\nmodule.exports = {\n rootDir: __dirname,\n port: Number(process.env.PORT || 3000),\n rpcManifestPath: 'apps/web/lib/wexts/wexts.rpc.manifest.json',\n security: {\n enabled: true,\n production: process.env.NODE_ENV === 'production',\n allowedOrigins: process.env.WEXTS_ALLOWED_ORIGINS?.split(',').filter(Boolean) || [],\n },\n};\n`,\n }], Boolean(options.force));\n }\n\n const rawName = options.name!;\n const name = toKebabCase(rawName);\n const classBase = toPascalCase(name);\n const srcRoot = path.join(options.targetRoot, 'src');\n\n const filesByType: Record<Exclude<ScaffoldGeneratorType, 'config'>, { relativePath: string; content: string }[]> = {\n rpc: rpcServiceFiles(name, classBase),\n service: [{\n relativePath: path.join('src', name, `${name}.service.ts`),\n content: `import { Injectable } from '@nestjs/common';\n\n@Injectable()\nexport class ${classBase}Service {\n async execute(): Promise<string> {\n return '${toCamelCase(name)}';\n }\n}\n`,\n }],\n module: [{\n relativePath: path.join('src', name, `${name}.module.ts`),\n content: `import { Module } from '@nestjs/common';\n\n@Module({})\nexport class ${classBase}Module {}\n`,\n }],\n entity: [{\n relativePath: path.join('src', name, `${name}.entity.ts`),\n content: `export interface ${classBase}Entity {\n id: string;\n createdAt: Date;\n updatedAt: Date;\n}\n`,\n }],\n guard: [{\n relativePath: path.join('src', name, `${name}.guard.ts`),\n content: `import { CanActivate, ExecutionContext, Injectable } from '@nestjs/common';\n\n@Injectable()\nexport class ${classBase}Guard implements CanActivate {\n canActivate(_context: ExecutionContext): boolean {\n return true;\n }\n}\n`,\n }],\n };\n\n fs.mkdirSync(srcRoot, { recursive: true });\n return writeGeneratedFiles(options.targetRoot, filesByType[options.type], Boolean(options.force));\n}\n\nfunction isScaffoldGenerator(type: string): type is ScaffoldGeneratorType {\n return ['rpc', 'service', 'module', 'entity', 'guard', 'config'].includes(type);\n}\n\nfunction rpcServiceFiles(serviceName: string, classBase: string): { relativePath: string; content: string }[] {\n return [{\n relativePath: path.join('src', serviceName, `${serviceName}.service.ts`),\n content: `import { Injectable } from '@nestjs/common';\nimport { RpcMethod, RpcService } from 'wexts/nest';\n\n@Injectable()\n@RpcService({ name: '${toCamelCase(serviceName)}', requireAuth: false })\nexport class ${classBase}Service {\n @RpcMethod()\n async sayHello(name: string): Promise<string> {\n return \\`Hello, \\${name}!\\`;\n }\n}\n`,\n }];\n}\n\nfunction writeGeneratedFiles(root: string, files: { relativePath: string; content: string }[], force: boolean): string[] {\n const changedFiles: string[] = [];\n\n for (const file of files) {\n const absolutePath = path.join(root, file.relativePath);\n if (fs.existsSync(absolutePath) && !force) {\n throw new WextsError({\n code: 'WEXTS_CLI_GENERATOR_FILE_EXISTS',\n message: `Refusing to overwrite existing file: ${absolutePath}`,\n suggestedFix: 'Review the file, then rerun with --force if overwriting is intentional.',\n docsSlug: 'cli',\n });\n }\n fs.mkdirSync(path.dirname(absolutePath), { recursive: true });\n fs.writeFileSync(absolutePath, file.content);\n changedFiles.push(absolutePath);\n }\n\n return changedFiles;\n}\n\nfunction runScript(script: string, options: CommonOptions): void {\n const cwd = options.cwd ?? process.cwd();\n const packageManager = detectPackageManager(cwd);\n const args = packageManager === 'npm' ? ['run', script] : ['run', script];\n runCommand(packageManager, args, cwd);\n}\n\nfunction runCommand(command: string, args: string[], cwd: string): void {\n const result = spawnSync(command, args, { cwd, stdio: 'inherit', shell: process.platform === 'win32' });\n if (result.status !== 0) {\n throw new Error(`${command} ${args.join(' ')} failed with exit code ${result.status}`);\n }\n}\n\nfunction detectPackageManager(cwd: string): 'pnpm' | 'npm' {\n const packageJsonPath = path.join(cwd, 'package.json');\n if (fs.existsSync(packageJsonPath)) {\n const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')) as { packageManager?: string };\n if (pkg.packageManager?.startsWith('pnpm@')) return 'pnpm';\n }\n if (fs.existsSync(path.join(cwd, 'pnpm-lock.yaml'))) return 'pnpm';\n if (fs.existsSync(path.join(cwd, 'pnpm-workspace.yaml'))) return 'pnpm';\n return 'npm';\n}\n\nfunction findTemplatePath(): string | undefined {\n const candidates = [\n path.resolve(__dirname, '../../templates'),\n path.resolve(__dirname, '../templates'),\n path.resolve(process.cwd(), 'packages/templates'),\n ];\n\n return candidates.find((candidate) => fs.existsSync(candidate));\n}\n\nfunction readPackageVersion(): string {\n const packageJsonPath = path.resolve(__dirname, '../../package.json');\n if (!fs.existsSync(packageJsonPath)) return '0.0.0';\n return JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')).version as string;\n}\n\nfunction readAllText(cwd: string, dirs: string[]): string {\n let text = '';\n for (const dir of dirs) {\n const absolute = path.join(cwd, dir);\n if (!fs.existsSync(absolute)) continue;\n for (const file of walk(absolute)) {\n if (file.endsWith('.ts') || file.endsWith('.tsx') || file.endsWith('.js')) {\n text += fs.readFileSync(file, 'utf8');\n }\n }\n }\n return text;\n}\n\nfunction walk(dir: string): string[] {\n return fs.readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {\n const absolute = path.join(dir, entry.name);\n if (entry.isDirectory()) return walk(absolute);\n return [absolute];\n });\n}\n\nfunction toKebabCase(value: string): string {\n return value.replace(/([a-z0-9])([A-Z])/g, '$1-$2').replace(/[_\\s]+/g, '-').toLowerCase();\n}\n\nfunction toPascalCase(value: string): string {\n return toKebabCase(value).split('-').map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join('');\n}\n\nfunction toCamelCase(value: string): string {\n const pascal = toPascalCase(value);\n return pascal.charAt(0).toLowerCase() + pascal.slice(1);\n}\n\nfunction pathToFileUrl(filePath: string): string {\n return `file://${filePath}`;\n}\n\nasync function loadRuntimeConfig(configPath: string, retry = false): Promise<Record<string, unknown>> {\n const deadline = Date.now() + (retry ? 15_000 : 0);\n let lastError: unknown;\n\n do {\n try {\n if (configPath.endsWith('.mjs')) {\n const mod = await import(pathToFileUrl(configPath));\n return (mod.default ?? mod) as Record<string, unknown>;\n }\n\n const require = createRequire(__filename);\n delete require.cache[require.resolve(configPath)];\n const mod = require(configPath);\n return (mod.default ?? mod) as Record<string, unknown>;\n } catch (error) {\n lastError = error;\n if (!retry || Date.now() >= deadline) break;\n await new Promise((resolve) => setTimeout(resolve, 500));\n }\n } while (retry);\n\n throw lastError;\n}\n\nconst invokedAsCli = process.argv[1]\n && (path.basename(process.argv[1]) === 'wexts' || path.basename(process.argv[1]) === 'wexts.cjs' || path.resolve(process.argv[1]).includes(`${path.sep}dist${path.sep}cli${path.sep}index`));\n\nif (invokedAsCli && !process.env.VITEST) {\n createCliProgram().parseAsync(process.argv).catch((error) => {\n logger.error(formatWextsError(error));\n process.exit(1);\n });\n}\n"]}