@fluojs/cli 1.0.0-beta.2 → 1.0.0-beta.4

package/dist/new/package-spec-resolver.js

@@ -366,6 +366,14 @@ function rewriteWorkspaceProtocolDependencies(manifest, packageVersions) {
     }
   }
 }
+
+/**
+ * Resolve package specs.
+ *
+ * @param options The options.
+ * @param bootstrapPlan The bootstrap plan.
+ * @returns The resolve package specs result.
+ */
 export async function resolvePackageSpecs(options, bootstrapPlan) {
   if (options.dependencySource !== 'local' || !options.repoRoot) {
     return {};

package/dist/new/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/new/prompt.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnE,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,EAAE,cAAuB,CAAC;AAI9D,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,KAAK,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;CACV,CAAC;AAQF,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,IAAI,IAAI,CAAC;IACf,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7G,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,8EAA8E;AAC9E,MAAM,WAAW,8BAA8B;IAC7C,iBAAiB,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,gBAAgB,KAAK,MAAM,CAAC,CAAC;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAwPD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,SAAS,CAAC,EAAE,MAAM,GACjB,cAAc,CAIhB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,gBAAgB,CAgBlB;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,gBAAgB,CAAC,CA0B3B"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/new/prompt.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGnE,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,EAAE,cAAuB,CAAC;AAI9D,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,KAAK,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;CACV,CAAC;AAQF,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,IAAI,IAAI,CAAC;IACf,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7G,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,8EAA8E;AAC9E,MAAM,WAAW,8BAA8B;IAC7C,iBAAiB,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,gBAAgB,KAAK,MAAM,CAAC,CAAC;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAwPD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,SAAS,CAAC,EAAE,MAAM,GACjB,cAAc,CAIhB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,gBAAgB,CAgBlB;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,gBAAgB,CAAC,CA0B3B"}

package/dist/new/prompt.js

@@ -3,6 +3,8 @@ import { dirname, join, resolve } from 'node:path';
 import * as clack from '@clack/prompts';
 import { resolveBootstrapSchema } from './resolver.js';
 import { DOCUMENTED_MICROSERVICE_TRANSPORTS, getApplicationStarterProfiles } from './starter-profiles.js';
+import { CliPromptCancelledError } from '../prompt-cancel.js';
+
 /** Default package manager used when detection has no signal. */
 export const DEFAULT_PACKAGE_MANAGER = 'pnpm';
 const DEFAULT_INSTALL_DEPENDENCIES = true;
@@ -40,7 +42,7 @@ function createBootstrapPrompter() {
       });
       if (clack.isCancel(result)) {
         clack.cancel('Operation cancelled.');
-        process.exit(0);
+        throw new CliPromptCancelledError();
       }
       return result;
     },
@@ -55,7 +57,7 @@ function createBootstrapPrompter() {
       });
       if (clack.isCancel(result)) {
         clack.cancel('Operation cancelled.');
-        process.exit(0);
+        throw new CliPromptCancelledError();
       }
       return result;
     },
@@ -70,7 +72,7 @@ function createBootstrapPrompter() {
       });
       if (clack.isCancel(result)) {
         clack.cancel('Operation cancelled.');
-        process.exit(0);
+        throw new CliPromptCancelledError();
       }
       return result;
     }

package/dist/new/scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/new/scaffold.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AAmkEnE;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,EACzB,aAAa,SAAkB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,6BAAuB,CAAC"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/new/scaffold.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AAokEnE;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,EACzB,aAAa,SAAkB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,6BAAuB,CAAC"}

package/dist/new/scaffold.js

@@ -27,20 +27,21 @@ const PUBLISHED_RUNTIME_DEPENDENCIES = {
   nats: '^2.29.3'
 };
 const PUBLISHED_INTERNAL_DEPENDENCIES = {
-  '@fluojs/cli': '^1.0.0-beta.2',
-  '@fluojs/config': '^1.0.0-beta.1',
-  '@fluojs/core': '^1.0.0-beta.1',
-  '@fluojs/di': '^1.0.0-beta.1',
-  '@fluojs/http': '^1.0.0-beta.1',
-  '@fluojs/microservices': '^1.0.0-beta.1',
-  '@fluojs/platform-bun': '^1.0.0-beta.1',
-  '@fluojs/platform-cloudflare-workers': '^1.0.0-beta.1',
-  '@fluojs/platform-deno': '^1.0.0-beta.1',
-  '@fluojs/platform-express': '^1.0.0-beta.1',
-  '@fluojs/platform-fastify': '^1.0.0-beta.2',
-  '@fluojs/platform-nodejs': '^1.0.0-beta.1',
-  '@fluojs/runtime': '^1.0.0-beta.1',
-  '@fluojs/testing': '^1.0.0-beta.1'
+  '@fluojs/cli': '^1.0.0-beta.3',
+  '@fluojs/config': '^1.0.0-beta.5',
+  '@fluojs/core': '^1.0.0-beta.3',
+  '@fluojs/di': '^1.0.0-beta.6',
+  '@fluojs/http': '^1.0.0-beta.9',
+  '@fluojs/microservices': '^1.0.0-beta.3',
+  '@fluojs/platform-bun': '^1.0.0-beta.6',
+  '@fluojs/platform-cloudflare-workers': '^1.0.0-beta.2',
+  '@fluojs/platform-deno': '^1.0.0-beta.3',
+  '@fluojs/platform-express': '^1.0.0-beta.6',
+  '@fluojs/platform-fastify': '^1.0.0-beta.8',
+  '@fluojs/platform-nodejs': '^1.0.0-beta.4',
+  '@fluojs/runtime': '^1.0.0-beta.9',
+  '@fluojs/testing': '^1.0.0-beta.2',
+  '@fluojs/validation': '^1.0.0-beta.2'
 };
 function describeApplicationStarter(options) {
   if (options.runtime === 'bun') {

package/dist/prompt-cancel.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Stable sentinel error for caller-owned prompt cancellation.
+ *
+ * @remarks
+ * Programmatic prompt hooks passed to `runCli(...)` or `runNewCommand(...)`
+ * can throw this error to report a normal user cancellation without relying on
+ * CLI internals or terminating the host process.
+ *
+ * @example
+ * ```ts
+ * import { CliPromptCancelledError, runNewCommand } from '@fluojs/cli';
+ *
+ * const exitCode = await runNewCommand([], {
+ *   interactive: true,
+ *   prompt: {
+ *     async text() {
+ *       throw new CliPromptCancelledError();
+ *     },
+ *     async select(_message, _choices, defaultValue) {
+ *       return defaultValue ?? 'pnpm';
+ *     },
+ *     async confirm(_message, defaultValue) {
+ *       return defaultValue;
+ *     },
+ *   },
+ * });
+ * ```
+ */
+export declare class CliPromptCancelledError extends Error {
+    /**
+     * Creates a prompt cancellation sentinel.
+     *
+     * @param message Optional cancellation message for diagnostics.
+     */
+    constructor(message?: string);
+}
+/**
+ * Checks whether a thrown value represents a user-cancelled CLI prompt.
+ *
+ * @param error Value caught from a command execution path.
+ * @returns `true` when the value is a `CliPromptCancelledError`.
+ */
+export declare function isCliPromptCancelledError(error: unknown): error is CliPromptCancelledError;
+//# sourceMappingURL=prompt-cancel.d.ts.map

package/dist/prompt-cancel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-cancel.d.ts","sourceRoot":"","sources":["../src/prompt-cancel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD;;;;OAIG;gBACS,OAAO,SAAyB;CAI7C;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAE1F"}

package/dist/prompt-cancel.js

@@ -0,0 +1,49 @@
+/**
+ * Stable sentinel error for caller-owned prompt cancellation.
+ *
+ * @remarks
+ * Programmatic prompt hooks passed to `runCli(...)` or `runNewCommand(...)`
+ * can throw this error to report a normal user cancellation without relying on
+ * CLI internals or terminating the host process.
+ *
+ * @example
+ * ```ts
+ * import { CliPromptCancelledError, runNewCommand } from '@fluojs/cli';
+ *
+ * const exitCode = await runNewCommand([], {
+ *   interactive: true,
+ *   prompt: {
+ *     async text() {
+ *       throw new CliPromptCancelledError();
+ *     },
+ *     async select(_message, _choices, defaultValue) {
+ *       return defaultValue ?? 'pnpm';
+ *     },
+ *     async confirm(_message, defaultValue) {
+ *       return defaultValue;
+ *     },
+ *   },
+ * });
+ * ```
+ */
+export class CliPromptCancelledError extends Error {
+  /**
+   * Creates a prompt cancellation sentinel.
+   *
+   * @param message Optional cancellation message for diagnostics.
+   */
+  constructor(message = 'Operation cancelled.') {
+    super(message);
+    this.name = 'CliPromptCancelledError';
+  }
+}
+
+/**
+ * Checks whether a thrown value represents a user-cancelled CLI prompt.
+ *
+ * @param error Value caught from a command execution path.
+ * @returns `true` when the value is a `CliPromptCancelledError`.
+ */
+export function isCliPromptCancelledError(error) {
+  return error instanceof CliPromptCancelledError;
+}

package/dist/transforms/nestjs-migrate.d.ts

@@ -1,21 +1,54 @@
+/**
+ * Provides the migration transforms value.
+ */
 export declare const MIGRATION_TRANSFORMS: readonly ["imports", "injectable", "scope", "bootstrap", "testing", "tsconfig"];
+/**
+ * Defines the migration transform kind type.
+ */
 export type MigrationTransformKind = typeof MIGRATION_TRANSFORMS[number];
+/**
+ * Provides the warning categories value.
+ */
 export declare const WARNING_CATEGORIES: readonly ["inject-token", "request-dto", "pipe-converter", "bootstrap-unsupported", "testing-unsupported", "import-unsupported", "injectable-options", "tsconfig-parse", "bootstrap-port"];
+/**
+ * Defines the warning category type.
+ */
 export type WarningCategory = typeof WARNING_CATEGORIES[number];
+/**
+ * Defines the migration warning type.
+ */
 export type MigrationWarning = {
     category: WarningCategory;
     filePath: string;
     line: number;
     message: string;
 };
+/**
+ * Get warning category label.
+ *
+ * @param category The category.
+ * @returns The get warning category label result.
+ */
 export declare function getWarningCategoryLabel(category: WarningCategory): string;
+/**
+ * Group warnings by category.
+ *
+ * @param warnings The warnings.
+ * @returns The group warnings by category result.
+ */
 export declare function groupWarningsByCategory(warnings: MigrationWarning[]): Map<WarningCategory, MigrationWarning[]>;
+/**
+ * Defines the file migration result type.
+ */
 export type FileMigrationResult = {
     appliedTransforms: MigrationTransformKind[];
     changed: boolean;
     filePath: string;
     warnings: MigrationWarning[];
 };
+/**
+ * Defines the migration report type.
+ */
 export type MigrationReport = {
     apply: boolean;
     changedFiles: number;
@@ -23,11 +56,26 @@ export type MigrationReport = {
     warningCount: number;
     fileResults: FileMigrationResult[];
 };
+/**
+ * Defines the run nest js migration options type.
+ */
 export type RunNestJsMigrationOptions = {
     apply: boolean;
     enabledTransforms: ReadonlySet<MigrationTransformKind>;
     targetPath: string;
 };
+/**
+ * Run nest js migration.
+ *
+ * @param options The options.
+ * @returns The run nest js migration result.
+ */
 export declare function runNestJsMigration(options: RunNestJsMigrationOptions): MigrationReport;
+/**
+ * Render transform list.
+ *
+ * @param kinds The kinds.
+ * @returns The render transform list result.
+ */
 export declare function renderTransformList(kinds: readonly MigrationTransformKind[]): string;
 //# sourceMappingURL=nestjs-migrate.d.ts.map

package/dist/transforms/nestjs-migrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nestjs-migrate.d.ts","sourceRoot":"","sources":["../../src/transforms/nestjs-migrate.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,oBAAoB,iFAAkF,CAAC;AAEpH,MAAM,MAAM,sBAAsB,GAAG,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAOzE,eAAO,MAAM,kBAAkB,4LAUrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAEhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAcF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAEzE;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,gBAAgB,EAAE,CAAC,CAS9G;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,iBAAiB,EAAE,sBAAsB,EAAE,CAAC;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,mBAAmB,EAAE,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,EAAE,WAAW,CAAC,sBAAsB,CAAC,CAAC;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AA6kCF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,eAAe,CAqDtF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,sBAAsB,EAAE,GAAG,MAAM,CAEpF"}
+{"version":3,"file":"nestjs-migrate.d.ts","sourceRoot":"","sources":["../../src/transforms/nestjs-migrate.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,eAAO,MAAM,oBAAoB,iFAAkF,CAAC;AAEpH;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAOzE;;GAEG;AACH,eAAO,MAAM,kBAAkB,4LAUrB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAcF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,gBAAgB,EAAE,CAAC,CAS9G;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,iBAAiB,EAAE,sBAAsB,EAAE,CAAC;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,mBAAmB,EAAE,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,EAAE,WAAW,CAAC,sBAAsB,CAAC,CAAC;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AA6kCF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,eAAe,CAqDtF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,sBAAsB,EAAE,GAAG,MAAM,CAEpF"}

package/dist/transforms/nestjs-migrate.js

@@ -1,8 +1,29 @@
 import { existsSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { basename, extname, posix, resolve } from 'node:path';
 import ts from 'typescript';
+
+/**
+ * Provides the migration transforms value.
+ */
 export const MIGRATION_TRANSFORMS = ['imports', 'injectable', 'scope', 'bootstrap', 'testing', 'tsconfig'];
+
+/**
+ * Defines the migration transform kind type.
+ */
+
+/**
+ * Provides the warning categories value.
+ */
 export const WARNING_CATEGORIES = ['inject-token', 'request-dto', 'pipe-converter', 'bootstrap-unsupported', 'testing-unsupported', 'import-unsupported', 'injectable-options', 'tsconfig-parse', 'bootstrap-port'];
+
+/**
+ * Defines the warning category type.
+ */
+
+/**
+ * Defines the migration warning type.
+ */
+
 const WARNING_CATEGORY_LABEL = {
   'inject-token': 'DI token migration (@Inject)',
   'request-dto': 'Request DTO migration (handler parameter decorators)',
@@ -14,9 +35,23 @@ const WARNING_CATEGORY_LABEL = {
   'tsconfig-parse': 'tsconfig parse failure',
   'bootstrap-port': 'Bootstrap port folding issue'
 };
+
+/**
+ * Get warning category label.
+ *
+ * @param category The category.
+ * @returns The get warning category label result.
+ */
 export function getWarningCategoryLabel(category) {
   return WARNING_CATEGORY_LABEL[category];
 }
+
+/**
+ * Group warnings by category.
+ *
+ * @param warnings The warnings.
+ * @returns The group warnings by category result.
+ */
 export function groupWarningsByCategory(warnings) {
   const groups = new Map();
   for (const warning of warnings) {
@@ -26,6 +61,19 @@ export function groupWarningsByCategory(warnings) {
   }
   return groups;
 }
+
+/**
+ * Defines the file migration result type.
+ */
+
+/**
+ * Defines the migration report type.
+ */
+
+/**
+ * Defines the run nest js migration options type.
+ */
+
 const printer = ts.createPrinter({
   newLine: ts.NewLineKind.LineFeed
 });
@@ -841,6 +889,13 @@ function runTypeScriptTransforms(source, filePath, enabledTransforms) {
     warnings
   };
 }
+
+/**
+ * Run nest js migration.
+ *
+ * @param options The options.
+ * @returns The run nest js migration result.
+ */
 export function runNestJsMigration(options) {
   const resolvedTargetPath = resolve(options.targetPath);
   if (!existsSync(resolvedTargetPath)) {
@@ -886,6 +941,13 @@ export function runNestJsMigration(options) {
     fileResults
   };
 }
+
+/**
+ * Render transform list.
+ *
+ * @param kinds The kinds.
+ * @returns The render transform list result.
+ */
 export function renderTransformList(kinds) {
   return kinds.map(kind => `${kind} (${TRANSFORM_KIND_LABEL[kind]})`).join(', ');
 }

package/dist/update-check.d.ts

@@ -5,24 +5,41 @@ type CliStream = {
 type CliReadableStream = {
     isTTY?: boolean;
 };
+/**
+ * Defines the cli update check result type.
+ */
 export type CliUpdateCheckResult = {
     action: 'continue';
 } | {
     action: 'reran';
     exitCode: number;
 };
+/**
+ * Defines the update install command type.
+ */
 export type UpdateInstallCommand = {
     args: string[];
     command: string;
     display: string;
 };
+/** Package manager that can install the CLI globally. */
+export type UpdatePackageManager = 'bun' | 'npm' | 'pnpm' | 'yarn';
+/**
+ * Defines the update command runtime type.
+ */
 export type UpdateCommandRuntime = {
     env: NodeJS.ProcessEnv;
     stderr: CliStream;
 };
+/**
+ * Defines the update prompter type.
+ */
 export type UpdatePrompter = {
     confirm(message: string, defaultValue: boolean): Promise<boolean>;
 };
+/**
+ * Describes the cli update check runtime options contract.
+ */
 export interface CliUpdateCheckRuntimeOptions {
     cacheFile?: string;
     cacheTtlMs?: number;
@@ -34,6 +51,8 @@ export interface CliUpdateCheckRuntimeOptions {
     interactive?: boolean;
     now?: () => Date;
     packageName?: string;
+    packageManager?: UpdatePackageManager;
+    packageRoot?: string;
     prompt?: UpdatePrompter;
     rerunCli?: (argv: string[], runtime: UpdateCommandRuntime) => Promise<number>;
     skip?: boolean;
@@ -41,10 +60,23 @@ export interface CliUpdateCheckRuntimeOptions {
     stdin?: CliReadableStream;
     stdout?: CliStream;
 }
+/**
+ * Remove update check flags.
+ *
+ * @param argv The argv.
+ * @returns The remove update check flags result.
+ */
 export declare function removeUpdateCheckFlags(argv: string[]): {
     argv: string[];
     skipUpdateCheck: boolean;
 };
+/**
+ * Run cli update check.
+ *
+ * @param argv The argv.
+ * @param options The options.
+ * @returns The run cli update check result.
+ */
 export declare function runCliUpdateCheck(argv: string[], options?: CliUpdateCheckRuntimeOptions): Promise<CliUpdateCheckResult>;
 export {};
 //# sourceMappingURL=update-check.d.ts.map

package/dist/update-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAOA,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAcF,MAAM,MAAM,oBAAoB,GAC5B;IACE,MAAM,EAAE,UAAU,CAAC;CACpB,GACD;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnE,CAAC;AAEF,MAAM,WAAW,4BAA4B;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,kBAAkB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1E,cAAc,CAAC,EAAE,CAAC,cAAc,EAAE,oBAAoB,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1G,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AA0VD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAcnG;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAgEjI"}
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAOA,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAcF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IACE,MAAM,EAAE,UAAU,CAAC;CACpB,GACD;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnE,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,kBAAkB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1E,cAAc,CAAC,EAAE,CAAC,cAAc,EAAE,oBAAoB,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1G,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAscD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAcnG;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAkEjI"}

package/dist/update-check.js

@@ -1,13 +1,37 @@
 import { spawnSync } from 'node:child_process';
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
-import { dirname, join } from 'node:path';
+import { basename, dirname, join, sep } from 'node:path';
 import { createInterface } from 'node:readline/promises';
 import { fileURLToPath } from 'node:url';
+
+/**
+ * Defines the cli update check result type.
+ */
+
+/**
+ * Defines the update install command type.
+ */
+
+/** Package manager that can install the CLI globally. */
+
+/**
+ * Defines the update command runtime type.
+ */
+
+/**
+ * Defines the update prompter type.
+ */
+
+/**
+ * Describes the cli update check runtime options contract.
+ */
+
 const DEFAULT_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
 const DEFAULT_PACKAGE_NAME = '@fluojs/cli';
 const DEFAULT_REGISTRY_TIMEOUT_MS = 5_000;
 const UPDATE_CHECK_FLAGS = new Set(['--no-update-check', '--no-update-notifier']);
+const UPDATE_PACKAGE_MANAGERS = new Set(['bun', 'npm', 'pnpm', 'yarn']);
 function isRecord(value) {
   return typeof value === 'object' && value !== null;
 }
@@ -213,12 +237,90 @@ async function readOwnPackageVersion() {
     return undefined;
   }
 }
-function resolveInstallCommand(packageName, latestVersion) {
+function normalizePathForDetection(path) {
+  return (path ?? '').replaceAll('\\', '/').toLowerCase();
+}
+function parsePackageManagerName(value) {
+  if (!value) {
+    return undefined;
+  }
+  const normalized = value.trim().toLowerCase();
+  if (UPDATE_PACKAGE_MANAGERS.has(normalized)) {
+    return normalized;
+  }
+  return undefined;
+}
+function parsePackageManagerFromUserAgent(userAgent) {
+  const name = userAgent?.split(' ')[0]?.split('/')[0];
+  return parsePackageManagerName(name);
+}
+function parsePackageManagerFromExecPath(execPath) {
+  const executableName = basename(execPath ?? '', '.cmd').toLowerCase();
+  const packageManager = parsePackageManagerName(executableName.replace(/\.(?:cjs|mjs|js)$/, ''));
+  if (packageManager) {
+    return packageManager;
+  }
+  const normalizedPath = normalizePathForDetection(execPath);
+  if (normalizedPath.includes('/pnpm/')) {
+    return 'pnpm';
+  }
+  if (normalizedPath.includes('/yarn/')) {
+    return 'yarn';
+  }
+  if (normalizedPath.includes('/bun/')) {
+    return 'bun';
+  }
+  if (normalizedPath.includes('/npm/')) {
+    return 'npm';
+  }
+  return undefined;
+}
+function parsePackageManagerFromPackageRoot(packageRoot) {
+  const normalizedPath = normalizePathForDetection(`${sep}${packageRoot}${sep}`);
+  if (normalizedPath.includes('/.pnpm/') || normalizedPath.includes('/pnpm/global/')) {
+    return 'pnpm';
+  }
+  if (normalizedPath.includes('/.bun/install/global/') || normalizedPath.includes('/bun/install/global/')) {
+    return 'bun';
+  }
+  if (normalizedPath.includes('/.config/yarn/global/') || normalizedPath.includes('/yarn/global/')) {
+    return 'yarn';
+  }
+  if (normalizedPath.includes('/node_modules/')) {
+    return 'npm';
+  }
+  return undefined;
+}
+function resolveUpdatePackageManager(env, packageRoot) {
+  return parsePackageManagerName(env.FLUO_UPDATE_PACKAGE_MANAGER) ?? parsePackageManagerFromPackageRoot(packageRoot) ?? parsePackageManagerFromUserAgent(env.npm_config_user_agent) ?? parsePackageManagerFromExecPath(env.npm_execpath) ?? 'npm';
+}
+function resolveInstallCommand(packageName, latestVersion, packageManager) {
   const packageSpecifier = `${packageName}@${latestVersion}`;
+  if (packageManager === 'bun') {
+    return {
+      args: ['add', '-g', packageSpecifier],
+      command: 'bun',
+      display: `bun add -g ${packageSpecifier}`
+    };
+  }
+  if (packageManager === 'pnpm') {
+    return {
+      args: ['add', '-g', packageSpecifier],
+      command: 'pnpm',
+      display: `pnpm add -g ${packageSpecifier}`
+    };
+  }
+  if (packageManager === 'yarn') {
+    return {
+      args: ['global', 'add', packageSpecifier],
+      command: 'yarn',
+      display: `yarn global add ${packageSpecifier}`
+    };
+  }
   return {
-    args: ['add', '-g', packageSpecifier],
-    command: 'pnpm',
-    display: `pnpm add -g ${packageSpecifier}`
+    args: ['install', '-g', packageSpecifier],
+    command: 'npm',
+    display: `npm install -g ${packageSpecifier}`
   };
 }
 async function defaultPromptConfirm(message, defaultValue) {
@@ -272,6 +374,13 @@ function shouldRunInteractiveUpdateCheck(options, env) {
   }
   return Boolean(options.stdin?.isTTY ?? process.stdin.isTTY) && Boolean(options.stdout?.isTTY ?? process.stdout.isTTY);
 }
+
+/**
+ * Remove update check flags.
+ *
+ * @param argv The argv.
+ * @returns The remove update check flags result.
+ */
 export function removeUpdateCheckFlags(argv) {
   const filteredArgv = [];
   let skipUpdateCheck = false;
@@ -287,6 +396,14 @@ export function removeUpdateCheckFlags(argv) {
     skipUpdateCheck
   };
 }
+
+/**
+ * Run cli update check.
+ *
+ * @param argv The argv.
+ * @param options The options.
+ * @returns The run cli update check result.
+ */
 export async function runCliUpdateCheck(argv, options = {}) {
   const env = options.env ?? {};
   const stderr = options.stderr ?? process.stderr;
@@ -306,6 +423,7 @@ export async function runCliUpdateCheck(argv, options = {}) {
   const cacheFile = options.cacheFile ?? resolveCacheFile(env);
   const cacheTtlMs = options.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
   const currentVersion = options.currentVersion ?? (await readOwnPackageVersion());
+  const packageRoot = options.packageRoot ?? dirname(fileURLToPath(new URL('../package.json', import.meta.url)));
   if (!currentVersion) {
     return {
       action: 'continue'
@@ -328,7 +446,8 @@ export async function runCliUpdateCheck(argv, options = {}) {
       action: 'continue'
     };
   }
-  const installCommand = resolveInstallCommand(packageName, latestVersion);
+  const packageManager = options.packageManager ?? resolveUpdatePackageManager(env, packageRoot);
+  const installCommand = resolveInstallCommand(packageName, latestVersion, packageManager);
   stderr.write(`Installing ${packageName}@${latestVersion} with \`${installCommand.display}\`...\n`);
   const commandRuntime = {
     env,

package/package.json

@@ -9,7 +9,7 @@
     "migration",
     "diagnostics"
   ],
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.4",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -44,10 +44,10 @@
     "ejs": "^3.1.10",
     "tsx": "^4.20.4",
     "typescript": "^6.0.2",
-    "@fluojs/runtime": "^1.0.0-beta.1"
+    "@fluojs/runtime": "^1.0.0-beta.9"
   },
   "peerDependencies": {
-    "@fluojs/studio": "^1.0.0-beta.2"
+    "@fluojs/studio": "^1.0.0-beta.3"
   },
   "peerDependenciesMeta": {
     "@fluojs/studio": {