@fluojs/cli 1.0.0-beta.1

package/dist/new/starter-profiles.d.ts

@@ -0,0 +1,91 @@
+import type { BootstrapPlatform, BootstrapRuntime, BootstrapSchema, BootstrapShape, BootstrapToolingPreset, BootstrapTopology, BootstrapTransport } from './types.js';
+/** Emitter families that decide which scaffold template tree renders the starter. */
+export type StarterEmitterType = 'http' | 'microservice' | 'mixed';
+/** Stable IDs for the scaffold recipes currently shipped by `fluo new`. */
+export type StarterScaffoldRecipeId = 'application-bun-bun-http' | 'application-cloudflare-workers-cloudflare-workers-http' | 'application-deno-deno-http' | 'application-node-express-http' | 'application-node-fastify-http' | 'application-node-nodejs-http' | 'microservice-node-none-grpc' | 'microservice-node-none-kafka' | 'microservice-node-none-mqtt' | 'microservice-node-none-nats' | 'microservice-node-none-rabbitmq' | 'microservice-node-none-redis-streams' | 'microservice-node-none-tcp' | 'mixed-node-fastify-tcp';
+type StarterDependencies = {
+    dependencies: readonly string[];
+    devDependencies: readonly string[];
+};
+/** Fully resolved starter metadata used by schema resolution, prompts, and scaffold emission. */
+export interface StarterProfile {
+    dependencies: StarterDependencies;
+    emitter: {
+        platform: BootstrapPlatform;
+        preset: BootstrapToolingPreset;
+        runtime: BootstrapRuntime;
+        transport: BootstrapTransport;
+        type: StarterEmitterType;
+    };
+    id: StarterScaffoldRecipeId;
+    platformPromptLabel?: string;
+    promptLabel: string;
+    schema: BootstrapSchema;
+}
+/** Supported microservice starter transports recognized by `fluo new`. */
+export declare const SUPPORTED_MICROSERVICE_STARTER_TRANSPORTS: readonly BootstrapTransport[];
+/** Backward-compatible alias for the current shipped microservice starter transport list. */
+export declare const DOCUMENTED_MICROSERVICE_TRANSPORTS: readonly BootstrapTransport[];
+/** Source-of-truth registry for starter dependencies, prompt labels, and emitted scaffold recipes. */
+export declare const STARTER_PROFILE_REGISTRY: readonly StarterProfile[];
+/** Supported scaffold shapes accepted by the current starter matrix. */
+export declare const SUPPORTED_BOOTSTRAP_SHAPES: readonly BootstrapShape[];
+/** Supported runtime families accepted by the current starter matrix. */
+export declare const SUPPORTED_BOOTSTRAP_RUNTIMES: readonly BootstrapRuntime[];
+/** Supported platform adapters accepted by the current starter matrix. */
+export declare const SUPPORTED_BOOTSTRAP_PLATFORMS: readonly BootstrapPlatform[];
+/** Supported transports accepted by the current starter matrix. */
+export declare const SUPPORTED_BOOTSTRAP_TRANSPORTS: readonly BootstrapTransport[];
+/** Supported tooling presets accepted by the current starter matrix. */
+export declare const SUPPORTED_BOOTSTRAP_TOOLING_PRESETS: readonly BootstrapToolingPreset[];
+/** Supported topology modes accepted by the current starter matrix. */
+export declare const SUPPORTED_BOOTSTRAP_TOPOLOGY_MODES: readonly BootstrapTopology['mode'][];
+/** Default starter profile used for shape-less `fluo new` invocations. */
+export declare const DEFAULT_BOOTSTRAP_PROFILE: StarterProfile;
+/**
+ * Resolves the default starter profile for one shape/runtime branch.
+ *
+ * @param shape Shape requested by the caller.
+ * @param runtime Optional runtime override used to pick Bun/Deno/Workers application defaults.
+ * @returns The starter profile that defines the default contract for that branch.
+ */
+export declare function getStarterProfileForShape(shape: BootstrapShape, runtime?: BootstrapRuntime): StarterProfile;
+/**
+ * Lists the application starter profiles currently published by the registry.
+ *
+ * @param runtime Optional runtime filter.
+ * @returns Application starter profiles for the selected runtime, or all application starters when omitted.
+ */
+export declare function getApplicationStarterProfiles(runtime?: BootstrapRuntime): readonly StarterProfile[];
+/**
+ * Clones the default bootstrap schema for one shape/runtime branch.
+ *
+ * @param shape Shape requested by the caller.
+ * @param runtime Optional runtime override used for application starters.
+ * @returns A fresh schema object safe to mutate during resolution.
+ */
+export declare function getDefaultBootstrapSchemaForShape(shape: BootstrapShape, runtime?: BootstrapRuntime): BootstrapSchema;
+/**
+ * Clones the global default bootstrap schema.
+ *
+ * @returns A fresh schema object for the default Node.js + Fastify HTTP starter.
+ */
+export declare function getDefaultBootstrapSchema(): BootstrapSchema;
+/**
+ * Finds the starter profile that exactly matches a resolved bootstrap schema.
+ *
+ * @param schema Fully resolved bootstrap schema.
+ * @returns The matching starter profile, or `undefined` when the schema is validation-only.
+ */
+export declare function getStarterProfileFromSchema(schema: BootstrapSchema): StarterProfile | undefined;
+/**
+ * Checks whether one transport belongs to the supported microservice starter transport family.
+ *
+ * @param transport Transport selected by the caller.
+ * @returns `true` when the transport is part of the supported microservice starter transport set.
+ */
+export declare function isSupportedMicroserviceStarterTransport(transport: BootstrapTransport): boolean;
+/** Backward-compatible alias for starter-transport membership checks. */
+export declare const isDocumentedMicroserviceTransport: typeof isSupportedMicroserviceStarterTransport;
+export {};
+//# sourceMappingURL=starter-profiles.d.ts.map

package/dist/new/starter-profiles.d.ts.map

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

package/dist/new/starter-profiles.js

@@ -0,0 +1,347 @@
+/** Emitter families that decide which scaffold template tree renders the starter. */
+
+/** Stable IDs for the scaffold recipes currently shipped by `fluo new`. */
+
+/** Fully resolved starter metadata used by schema resolution, prompts, and scaffold emission. */
+
+const DEFAULT_TOPOLOGY = {
+  deferred: true,
+  mode: 'single-package'
+};
+function createSchema(shape, runtime, platform, transport, tooling = 'standard') {
+  return {
+    platform,
+    runtime,
+    shape,
+    tooling,
+    topology: {
+      ...DEFAULT_TOPOLOGY
+    },
+    transport
+  };
+}
+function cloneBootstrapSchema(schema) {
+  return {
+    ...schema,
+    topology: {
+      ...schema.topology
+    }
+  };
+}
+
+/** Supported microservice starter transports recognized by `fluo new`. */
+export const SUPPORTED_MICROSERVICE_STARTER_TRANSPORTS = ['tcp', 'redis-streams', 'nats', 'kafka', 'rabbitmq', 'mqtt', 'grpc'];
+
+/** Backward-compatible alias for the current shipped microservice starter transport list. */
+export const DOCUMENTED_MICROSERVICE_TRANSPORTS = SUPPORTED_MICROSERVICE_STARTER_TRANSPORTS;
+
+/** Source-of-truth registry for starter dependencies, prompt labels, and emitted scaffold recipes. */
+export const STARTER_PROFILE_REGISTRY = [{
+  dependencies: {
+    dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/validation', '@fluojs/di', '@fluojs/http', '@fluojs/platform-bun', '@fluojs/runtime'],
+    devDependencies: ['@fluojs/cli', '@fluojs/testing']
+  },
+  emitter: {
+    platform: 'bun',
+    preset: 'standard',
+    runtime: 'bun',
+    transport: 'http',
+    type: 'http'
+  },
+  id: 'application-bun-bun-http',
+  platformPromptLabel: 'Bun native HTTP',
+  promptLabel: 'Application (HTTP starter)',
+  schema: createSchema('application', 'bun', 'bun', 'http')
+}, {
+  dependencies: {
+    dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/validation', '@fluojs/di', '@fluojs/http', '@fluojs/platform-deno', '@fluojs/runtime'],
+    devDependencies: ['@fluojs/cli']
+  },
+  emitter: {
+    platform: 'deno',
+    preset: 'standard',
+    runtime: 'deno',
+    transport: 'http',
+    type: 'http'
+  },
+  id: 'application-deno-deno-http',
+  platformPromptLabel: 'Deno native HTTP',
+  promptLabel: 'Application (HTTP starter)',
+  schema: createSchema('application', 'deno', 'deno', 'http')
+}, {
+  dependencies: {
+    dependencies: ['@fluojs/core', '@fluojs/validation', '@fluojs/di', '@fluojs/http', '@fluojs/platform-cloudflare-workers', '@fluojs/runtime'],
+    devDependencies: ['@fluojs/cli', '@fluojs/testing']
+  },
+  emitter: {
+    platform: 'cloudflare-workers',
+    preset: 'standard',
+    runtime: 'cloudflare-workers',
+    transport: 'http',
+    type: 'http'
+  },
+  id: 'application-cloudflare-workers-cloudflare-workers-http',
+  platformPromptLabel: 'Cloudflare Workers',
+  promptLabel: 'Application (HTTP starter)',
+  schema: createSchema('application', 'cloudflare-workers', 'cloudflare-workers', 'http')
+}, {
+  dependencies: {
+    dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/validation', '@fluojs/di', '@fluojs/http', '@fluojs/platform-fastify', '@fluojs/runtime'],
+    devDependencies: ['@fluojs/cli', '@fluojs/testing']
+  },
+  emitter: {
+    platform: 'fastify',
+    preset: 'standard',
+    runtime: 'node',
+    transport: 'http',
+    type: 'http'
+  },
+  id: 'application-node-fastify-http',
+  platformPromptLabel: 'Fastify',
+  promptLabel: 'Application (HTTP starter)',
+  schema: createSchema('application', 'node', 'fastify', 'http')
+}, {
+  dependencies: {
+    dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/validation', '@fluojs/di', '@fluojs/http', '@fluojs/platform-express', '@fluojs/runtime'],
+    devDependencies: ['@fluojs/cli', '@fluojs/testing']
+  },
+  emitter: {
+    platform: 'express',
+    preset: 'standard',
+    runtime: 'node',
+    transport: 'http',
+    type: 'http'
+  },
+  id: 'application-node-express-http',
+  platformPromptLabel: 'Express',
+  promptLabel: 'Application (HTTP starter)',
+  schema: createSchema('application', 'node', 'express', 'http')
+}, {
+  dependencies: {
+    dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/validation', '@fluojs/di', '@fluojs/http', '@fluojs/platform-nodejs', '@fluojs/runtime'],
+    devDependencies: ['@fluojs/cli', '@fluojs/testing']
+  },
+  emitter: {
+    platform: 'nodejs',
+    preset: 'standard',
+    runtime: 'node',
+    transport: 'http',
+    type: 'http'
+  },
+  id: 'application-node-nodejs-http',
+  platformPromptLabel: 'Raw Node.js HTTP',
+  promptLabel: 'Application (HTTP starter)',
+  schema: createSchema('application', 'node', 'nodejs', 'http')
+}, {
+  dependencies: {
+    dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/di', '@fluojs/microservices', '@fluojs/runtime'],
+    devDependencies: ['@fluojs/cli', '@fluojs/testing']
+  },
+  emitter: {
+    platform: 'none',
+    preset: 'standard',
+    runtime: 'node',
+    transport: 'tcp',
+    type: 'microservice'
+  },
+  id: 'microservice-node-none-tcp',
+  promptLabel: 'Microservice (transport-first starter)',
+  schema: createSchema('microservice', 'node', 'none', 'tcp')
+}, {
+  dependencies: {
+    dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/di', '@fluojs/microservices', '@fluojs/runtime', 'ioredis'],
+    devDependencies: ['@fluojs/cli', '@fluojs/testing']
+  },
+  emitter: {
+    platform: 'none',
+    preset: 'standard',
+    runtime: 'node',
+    transport: 'redis-streams',
+    type: 'microservice'
+  },
+  id: 'microservice-node-none-redis-streams',
+  promptLabel: 'Microservice (Redis Streams starter)',
+  schema: createSchema('microservice', 'node', 'none', 'redis-streams')
+}, {
+  dependencies: {
+    dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/di', '@fluojs/microservices', '@fluojs/runtime', 'mqtt'],
+    devDependencies: ['@fluojs/cli', '@fluojs/testing']
+  },
+  emitter: {
+    platform: 'none',
+    preset: 'standard',
+    runtime: 'node',
+    transport: 'mqtt',
+    type: 'microservice'
+  },
+  id: 'microservice-node-none-mqtt',
+  promptLabel: 'Microservice (MQTT starter)',
+  schema: createSchema('microservice', 'node', 'none', 'mqtt')
+}, {
+  dependencies: {
+    dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/di', '@fluojs/microservices', '@fluojs/runtime', '@grpc/grpc-js', '@grpc/proto-loader'],
+    devDependencies: ['@fluojs/cli', '@fluojs/testing']
+  },
+  emitter: {
+    platform: 'none',
+    preset: 'standard',
+    runtime: 'node',
+    transport: 'grpc',
+    type: 'microservice'
+  },
+  id: 'microservice-node-none-grpc',
+  promptLabel: 'Microservice (gRPC starter)',
+  schema: createSchema('microservice', 'node', 'none', 'grpc')
+}, {
+  dependencies: {
+    dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/di', '@fluojs/microservices', '@fluojs/runtime', 'nats'],
+    devDependencies: ['@fluojs/cli', '@fluojs/testing']
+  },
+  emitter: {
+    platform: 'none',
+    preset: 'standard',
+    runtime: 'node',
+    transport: 'nats',
+    type: 'microservice'
+  },
+  id: 'microservice-node-none-nats',
+  promptLabel: 'Microservice (NATS starter)',
+  schema: createSchema('microservice', 'node', 'none', 'nats')
+}, {
+  dependencies: {
+    dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/di', '@fluojs/microservices', '@fluojs/runtime', 'kafkajs'],
+    devDependencies: ['@fluojs/cli', '@fluojs/testing']
+  },
+  emitter: {
+    platform: 'none',
+    preset: 'standard',
+    runtime: 'node',
+    transport: 'kafka',
+    type: 'microservice'
+  },
+  id: 'microservice-node-none-kafka',
+  promptLabel: 'Microservice (Kafka starter)',
+  schema: createSchema('microservice', 'node', 'none', 'kafka')
+}, {
+  dependencies: {
+    dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/di', '@fluojs/microservices', '@fluojs/runtime', 'amqplib'],
+    devDependencies: ['@fluojs/cli', '@fluojs/testing', '@types/amqplib']
+  },
+  emitter: {
+    platform: 'none',
+    preset: 'standard',
+    runtime: 'node',
+    transport: 'rabbitmq',
+    type: 'microservice'
+  },
+  id: 'microservice-node-none-rabbitmq',
+  promptLabel: 'Microservice (RabbitMQ starter)',
+  schema: createSchema('microservice', 'node', 'none', 'rabbitmq')
+}, {
+  dependencies: {
+    dependencies: ['@fluojs/config', '@fluojs/core', '@fluojs/validation', '@fluojs/di', '@fluojs/http', '@fluojs/microservices', '@fluojs/platform-fastify', '@fluojs/runtime'],
+    devDependencies: ['@fluojs/cli', '@fluojs/testing']
+  },
+  emitter: {
+    platform: 'fastify',
+    preset: 'standard',
+    runtime: 'node',
+    transport: 'tcp',
+    type: 'mixed'
+  },
+  id: 'mixed-node-fastify-tcp',
+  promptLabel: 'Mixed (HTTP API + microservice starter)',
+  schema: createSchema('mixed', 'node', 'fastify', 'tcp')
+}];
+
+/** Supported scaffold shapes accepted by the current starter matrix. */
+export const SUPPORTED_BOOTSTRAP_SHAPES = STARTER_PROFILE_REGISTRY.map(profile => profile.schema.shape);
+/** Supported runtime families accepted by the current starter matrix. */
+export const SUPPORTED_BOOTSTRAP_RUNTIMES = ['bun', 'cloudflare-workers', 'deno', 'node'];
+/** Supported platform adapters accepted by the current starter matrix. */
+export const SUPPORTED_BOOTSTRAP_PLATFORMS = ['bun', 'cloudflare-workers', 'deno', 'express', 'fastify', 'nodejs', 'none'];
+/** Supported transports accepted by the current starter matrix. */
+export const SUPPORTED_BOOTSTRAP_TRANSPORTS = ['http', ...SUPPORTED_MICROSERVICE_STARTER_TRANSPORTS];
+/** Supported tooling presets accepted by the current starter matrix. */
+export const SUPPORTED_BOOTSTRAP_TOOLING_PRESETS = ['standard'];
+/** Supported topology modes accepted by the current starter matrix. */
+export const SUPPORTED_BOOTSTRAP_TOPOLOGY_MODES = ['single-package'];
+
+/** Default starter profile used for shape-less `fluo new` invocations. */
+export const DEFAULT_BOOTSTRAP_PROFILE = STARTER_PROFILE_REGISTRY.find(profile => profile.id === 'application-node-fastify-http');
+
+/**
+ * Resolves the default starter profile for one shape/runtime branch.
+ *
+ * @param shape Shape requested by the caller.
+ * @param runtime Optional runtime override used to pick Bun/Deno/Workers application defaults.
+ * @returns The starter profile that defines the default contract for that branch.
+ */
+export function getStarterProfileForShape(shape, runtime) {
+  if (runtime !== undefined) {
+    return STARTER_PROFILE_REGISTRY.find(profile => profile.schema.shape === shape && profile.schema.runtime === runtime) ?? DEFAULT_BOOTSTRAP_PROFILE;
+  }
+  if (shape === 'application') {
+    return DEFAULT_BOOTSTRAP_PROFILE;
+  }
+  if (shape === 'microservice') {
+    return STARTER_PROFILE_REGISTRY.find(profile => profile.id === 'microservice-node-none-tcp') ?? DEFAULT_BOOTSTRAP_PROFILE;
+  }
+  if (shape === 'mixed') {
+    return STARTER_PROFILE_REGISTRY.find(profile => profile.id === 'mixed-node-fastify-tcp') ?? DEFAULT_BOOTSTRAP_PROFILE;
+  }
+  return DEFAULT_BOOTSTRAP_PROFILE;
+}
+
+/**
+ * Lists the application starter profiles currently published by the registry.
+ *
+ * @param runtime Optional runtime filter.
+ * @returns Application starter profiles for the selected runtime, or all application starters when omitted.
+ */
+export function getApplicationStarterProfiles(runtime) {
+  return STARTER_PROFILE_REGISTRY.filter(profile => profile.schema.shape === 'application' && (runtime === undefined || profile.schema.runtime === runtime));
+}
+
+/**
+ * Clones the default bootstrap schema for one shape/runtime branch.
+ *
+ * @param shape Shape requested by the caller.
+ * @param runtime Optional runtime override used for application starters.
+ * @returns A fresh schema object safe to mutate during resolution.
+ */
+export function getDefaultBootstrapSchemaForShape(shape, runtime) {
+  return cloneBootstrapSchema(getStarterProfileForShape(shape, runtime).schema);
+}
+
+/**
+ * Clones the global default bootstrap schema.
+ *
+ * @returns A fresh schema object for the default Node.js + Fastify HTTP starter.
+ */
+export function getDefaultBootstrapSchema() {
+  return cloneBootstrapSchema(DEFAULT_BOOTSTRAP_PROFILE.schema);
+}
+
+/**
+ * Finds the starter profile that exactly matches a resolved bootstrap schema.
+ *
+ * @param schema Fully resolved bootstrap schema.
+ * @returns The matching starter profile, or `undefined` when the schema is validation-only.
+ */
+export function getStarterProfileFromSchema(schema) {
+  return STARTER_PROFILE_REGISTRY.find(profile => profile.schema.shape === schema.shape && profile.schema.runtime === schema.runtime && profile.schema.platform === schema.platform && profile.schema.transport === schema.transport && profile.schema.tooling === schema.tooling && profile.schema.topology.deferred === schema.topology.deferred && profile.schema.topology.mode === schema.topology.mode);
+}
+
+/**
+ * Checks whether one transport belongs to the supported microservice starter transport family.
+ *
+ * @param transport Transport selected by the caller.
+ * @returns `true` when the transport is part of the supported microservice starter transport set.
+ */
+export function isSupportedMicroserviceStarterTransport(transport) {
+  return SUPPORTED_MICROSERVICE_STARTER_TRANSPORTS.includes(transport);
+}
+
+/** Backward-compatible alias for starter-transport membership checks. */
+export const isDocumentedMicroserviceTransport = isSupportedMicroserviceStarterTransport;

package/dist/new/types.d.ts

@@ -0,0 +1,63 @@
+/** Supported package managers for generated starters. */
+export type PackageManager = 'bun' | 'npm' | 'pnpm' | 'yarn';
+/** Source for resolving starter package dependencies. */
+export type DependencySource = 'local' | 'published';
+/** Supported starter shapes for `fluo new`. */
+export type BootstrapShape = 'application' | 'microservice' | 'mixed';
+/** Supported runtime families for the current starter matrix. */
+export type BootstrapRuntime = 'bun' | 'cloudflare-workers' | 'deno' | 'node';
+/** Supported platform adapters for the current starter matrix. */
+export type BootstrapPlatform = 'bun' | 'cloudflare-workers' | 'deno' | 'express' | 'fastify' | 'nodejs' | 'none';
+/** Supported transport families for the current starter matrix. */
+export type BootstrapTransport = 'grpc' | 'http' | 'kafka' | 'mqtt' | 'nats' | 'rabbitmq' | 'redis-streams' | 'tcp';
+/** Supported tooling presets for the current starter matrix. */
+export type BootstrapToolingPreset = 'standard';
+/** Topology settings for the generated starter layout. */
+export interface BootstrapTopology {
+    deferred: boolean;
+    mode: 'single-package';
+}
+/** Shape-first scaffold schema resolved before file generation. */
+export interface BootstrapSchema {
+    platform: BootstrapPlatform;
+    runtime: BootstrapRuntime;
+    shape: BootstrapShape;
+    tooling: BootstrapToolingPreset;
+    topology: BootstrapTopology;
+    transport: BootstrapTransport;
+}
+/** Full scaffold options used by the file emitter and post-write steps. */
+export interface BootstrapOptions extends BootstrapSchema {
+    dependencySource?: DependencySource;
+    force?: boolean;
+    initializeGit?: boolean;
+    installDependencies?: boolean;
+    packageManager: PackageManager;
+    projectName: string;
+    repoRoot?: string;
+    skipInstall?: boolean;
+    targetDirectory: string;
+}
+/** Prompt descriptor for bootstrap answer collection. */
+export interface BootstrapPrompt {
+    key: keyof BootstrapAnswers;
+    label: string;
+}
+/** Resolved answers shared by flag-driven, interactive, and programmatic flows. */
+export interface BootstrapAnswers extends BootstrapSchema {
+    initializeGit: boolean;
+    installDependencies: boolean;
+    packageManager: PackageManager;
+    projectName: string;
+    targetDirectory: string;
+}
+/** Programmatic overrides for `runNewCommand(...)`. */
+export interface NewCommandOptions {
+    dependencySource?: DependencySource;
+    force?: boolean;
+    initializeGit?: boolean;
+    installDependencies?: boolean;
+    repoRoot?: string;
+    skipInstall?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/new/types.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAC7D,yDAAyD;AACzD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,CAAC;AACrD,+CAA+C;AAC/C,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,CAAC;AACtE,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC;AAC9E,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAClH,mEAAmE;AACnE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,GAAG,KAAK,CAAC;AACpH,gEAAgE;AAChE,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC;AAEhD,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,2EAA2E;AAC3E,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,gBAAgB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/new/types.js

@@ -0,0 +1 @@
+export {};

package/dist/registry.d.ts

@@ -0,0 +1,10 @@
+import type { GeneratorFactory } from './generator-types.js';
+export declare class GeneratorRegistry {
+    private readonly registry;
+    register(kind: string, factory: GeneratorFactory, description?: string): this;
+    resolve(kind: string): GeneratorFactory | undefined;
+    has(kind: string): boolean;
+    kinds(): string[];
+}
+export declare const defaultRegistry: GeneratorRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAyB,MAAM,sBAAsB,CAAC;AAIpF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IAErE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAK7E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAInD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,KAAK,IAAI,MAAM,EAAE;CAGlB;AAED,eAAO,MAAM,eAAe,mBAA0B,CAAC"}

package/dist/registry.js

@@ -0,0 +1,30 @@
+import { generatorManifest } from './generators/manifest.js';
+export class GeneratorRegistry {
+  registry = new Map();
+  register(kind, factory, description) {
+    this.registry.set(kind, {
+      factory,
+      description
+    });
+    return this;
+  }
+  resolve(kind) {
+    return this.registry.get(kind)?.factory;
+  }
+  has(kind) {
+    return this.registry.has(kind);
+  }
+  kinds() {
+    return Array.from(this.registry.keys());
+  }
+}
+export const defaultRegistry = new GeneratorRegistry();
+for (const entry of generatorManifest) {
+  defaultRegistry.register(entry.kind, entry.factory, entry.description);
+  const registryAliases = 'registryAliases' in entry ? entry.registryAliases : undefined;
+  if (registryAliases) {
+    for (const alias of registryAliases) {
+      defaultRegistry.register(alias, entry.factory, entry.description);
+    }
+  }
+}

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

@@ -0,0 +1,33 @@
+export declare const MIGRATION_TRANSFORMS: readonly ["imports", "injectable", "scope", "bootstrap", "testing", "tsconfig"];
+export type MigrationTransformKind = typeof MIGRATION_TRANSFORMS[number];
+export declare const WARNING_CATEGORIES: readonly ["inject-token", "request-dto", "pipe-converter", "bootstrap-unsupported", "testing-unsupported", "import-unsupported", "injectable-options", "tsconfig-parse", "bootstrap-port"];
+export type WarningCategory = typeof WARNING_CATEGORIES[number];
+export type MigrationWarning = {
+    category: WarningCategory;
+    filePath: string;
+    line: number;
+    message: string;
+};
+export declare function getWarningCategoryLabel(category: WarningCategory): string;
+export declare function groupWarningsByCategory(warnings: MigrationWarning[]): Map<WarningCategory, MigrationWarning[]>;
+export type FileMigrationResult = {
+    appliedTransforms: MigrationTransformKind[];
+    changed: boolean;
+    filePath: string;
+    warnings: MigrationWarning[];
+};
+export type MigrationReport = {
+    apply: boolean;
+    changedFiles: number;
+    scannedFiles: number;
+    warningCount: number;
+    fileResults: FileMigrationResult[];
+};
+export type RunNestJsMigrationOptions = {
+    apply: boolean;
+    enabledTransforms: ReadonlySet<MigrationTransformKind>;
+    targetPath: string;
+};
+export declare function runNestJsMigration(options: RunNestJsMigrationOptions): MigrationReport;
+export declare function renderTransformList(kinds: readonly MigrationTransformKind[]): string;
+//# sourceMappingURL=nestjs-migrate.d.ts.map

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

@@ -0,0 +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"}