@fluojs/cli 1.0.0-beta.1

package/dist/new/prompt.d.ts

@@ -0,0 +1,56 @@
+import type { BootstrapAnswers, PackageManager } from './types.js';
+/** Default package manager used when detection has no signal. */
+export declare const DEFAULT_PACKAGE_MANAGER: PackageManager;
+type WritableStream = {
+    write(message: string): unknown;
+};
+type ReadableStream = {
+    isTTY?: boolean;
+};
+type PromptChoice<T extends string> = {
+    label: string;
+    value: T;
+};
+/** Prompt contract used by the interactive `fluo new` wizard. */
+export interface BootstrapPrompter {
+    close?(): void;
+    confirm(message: string, defaultValue: boolean): Promise<boolean>;
+    select<T extends string>(message: string, choices: readonly PromptChoice<T>[], defaultValue?: T): Promise<T>;
+    text(message: string): Promise<string>;
+}
+/** Runtime overrides for resolving bootstrap answers in tests and editors. */
+export interface ResolveBootstrapAnswersOptions {
+    interactive?: boolean;
+    prompt?: BootstrapPrompter;
+    stdin?: ReadableStream;
+    stdout?: WritableStream;
+}
+/**
+ * Detects the package manager that should back the generated starter.
+ *
+ * @param startDirectory Directory used for lockfile and manifest discovery.
+ * @param userAgent Optional package-manager user agent from the caller.
+ * @returns The detected package manager, or the repo default when no signal exists.
+ */
+export declare function detectPackageManager(startDirectory: string, userAgent?: string): PackageManager;
+/**
+ * Resolves partial bootstrap selections onto the shared answer model.
+ *
+ * @param partial Partial bootstrap selections collected from flags or runtime callers.
+ * @param cwd Working directory used for package-manager detection.
+ * @param userAgent Optional package-manager user agent from the caller.
+ * @returns Fully resolved bootstrap answers with defaults applied.
+ */
+export declare function resolveBootstrapAnswers(partial: Partial<BootstrapAnswers>, cwd: string, userAgent?: string): BootstrapAnswers;
+/**
+ * Collects bootstrap answers through the interactive wizard when needed.
+ *
+ * @param partial Partial bootstrap selections collected from flags or runtime callers.
+ * @param cwd Working directory used for package-manager detection.
+ * @param userAgent Optional package-manager user agent from the caller.
+ * @param options Runtime overrides for interactive prompting.
+ * @returns Fully resolved bootstrap answers for scaffolding.
+ */
+export declare function collectBootstrapAnswers(partial: Partial<BootstrapAnswers>, cwd: string, userAgent?: string, options?: ResolveBootstrapAnswersOptions): Promise<BootstrapAnswers>;
+export {};
+//# sourceMappingURL=prompt.d.ts.map

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

@@ -0,0 +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,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AA6OD;;;;;;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

@@ -0,0 +1,278 @@
+import { existsSync, readFileSync } from 'node:fs';
+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';
+/** Default package manager used when detection has no signal. */
+export const DEFAULT_PACKAGE_MANAGER = 'pnpm';
+const DEFAULT_INSTALL_DEPENDENCIES = true;
+const DEFAULT_INITIALIZE_GIT = false;
+const STARTER_SHAPE_CHOICES = [{
+  label: 'Application',
+  value: 'application'
+}, {
+  label: 'Microservice',
+  value: 'microservice'
+}, {
+  label: 'Mixed',
+  value: 'mixed'
+}];
+
+/** Prompt contract used by the interactive `fluo new` wizard. */
+
+/** Runtime overrides for resolving bootstrap answers in tests and editors. */
+
+function hasOwnValue(partial, key) {
+  return partial[key] !== undefined;
+}
+function createBootstrapPrompter() {
+  return {
+    async confirm(message, defaultValue) {
+      const result = await clack.confirm({
+        message,
+        initialValue: defaultValue
+      });
+      if (clack.isCancel(result)) {
+        clack.cancel('Operation cancelled.');
+        process.exit(0);
+      }
+      return result;
+    },
+    async select(message, choices, defaultValue) {
+      const result = await clack.select({
+        message,
+        options: choices.map(choice => ({
+          label: choice.label,
+          value: choice.value
+        })),
+        initialValue: defaultValue
+      });
+      if (clack.isCancel(result)) {
+        clack.cancel('Operation cancelled.');
+        process.exit(0);
+      }
+      return result;
+    },
+    async text(message) {
+      const result = await clack.text({
+        message,
+        validate(value) {
+          if (!value || value.trim().length === 0) {
+            return 'Value is required.';
+          }
+        }
+      });
+      if (clack.isCancel(result)) {
+        clack.cancel('Operation cancelled.');
+        process.exit(0);
+      }
+      return result;
+    }
+  };
+}
+function shouldPromptForAnswers(partial, interactive) {
+  const selectedRuntime = partial.runtime;
+  return interactive && (!hasOwnValue(partial, 'projectName') || !hasOwnValue(partial, 'shape') || !hasOwnValue(partial, 'tooling') || !hasOwnValue(partial, 'packageManager') || !hasOwnValue(partial, 'installDependencies') || !hasOwnValue(partial, 'initializeGit') || partial.shape === 'application' && !hasOwnValue(partial, 'runtime') || partial.shape === 'application' && selectedRuntime === 'node' && !hasOwnValue(partial, 'platform') || partial.shape === 'microservice' && !hasOwnValue(partial, 'transport'));
+}
+async function resolveInteractiveBootstrapAnswers(partial, cwd, userAgent, prompt) {
+  const answers = {
+    ...partial
+  };
+  const detectedPackageManager = detectPackageManager(cwd, userAgent);
+  if (!answers.projectName) {
+    answers.projectName = assertValidProjectName(await prompt.text('Project name'));
+  }
+  if (!answers.shape) {
+    answers.shape = await prompt.select('Starter shape', STARTER_SHAPE_CHOICES, 'application');
+  }
+  if (answers.shape === 'application' && !answers.runtime) {
+    answers.runtime = await prompt.select('Runtime', [{
+      label: 'Bun',
+      value: 'bun'
+    }, {
+      label: 'Cloudflare Workers',
+      value: 'cloudflare-workers'
+    }, {
+      label: 'Deno',
+      value: 'deno'
+    }, {
+      label: 'Node.js',
+      value: 'node'
+    }], 'node');
+  }
+  if (answers.shape === 'application' && !answers.platform) {
+    if (answers.runtime === 'node') {
+      const applicationProfiles = getApplicationStarterProfiles('node');
+      answers.platform = await prompt.select('HTTP platform', applicationProfiles.map(profile => ({
+        label: profile.platformPromptLabel ?? profile.schema.platform,
+        value: profile.schema.platform
+      })), 'fastify');
+    } else if (answers.runtime === 'bun' || answers.runtime === 'deno' || answers.runtime === 'cloudflare-workers') {
+      answers.platform = answers.runtime;
+    }
+  }
+  if (answers.shape === 'microservice' && !answers.transport) {
+    answers.transport = await prompt.select('Microservice transport', DOCUMENTED_MICROSERVICE_TRANSPORTS.map(transport => ({
+      label: transport,
+      value: transport
+    })), 'tcp');
+  }
+  if (!answers.tooling) {
+    answers.tooling = await prompt.select('Tooling preset', [{
+      label: 'standard',
+      value: 'standard'
+    }], 'standard');
+  }
+  if (!answers.packageManager) {
+    answers.packageManager = await prompt.select('Package manager', [{
+      label: 'pnpm',
+      value: 'pnpm'
+    }, {
+      label: 'npm',
+      value: 'npm'
+    }, {
+      label: 'yarn',
+      value: 'yarn'
+    }, {
+      label: 'bun',
+      value: 'bun'
+    }], detectedPackageManager);
+  }
+  if (!hasOwnValue(answers, 'installDependencies')) {
+    answers.installDependencies = await prompt.confirm('Install dependencies now', DEFAULT_INSTALL_DEPENDENCIES);
+  }
+  if (!hasOwnValue(answers, 'initializeGit')) {
+    answers.initializeGit = await prompt.confirm('Initialize a git repository', DEFAULT_INITIALIZE_GIT);
+  }
+  return resolveBootstrapAnswers(answers, cwd, userAgent);
+}
+function assertValidProjectName(projectName) {
+  const trimmed = projectName.trim();
+  if (trimmed.length === 0) {
+    throw new Error('Project name is required.');
+  }
+  if (trimmed.includes('/') || trimmed.includes('\\') || trimmed.includes('..')) {
+    throw new Error(`Invalid project name "${projectName}": must not contain path separators or traversal sequences.`);
+  }
+  return trimmed;
+}
+function parsePackageManager(value) {
+  if (!value) {
+    return undefined;
+  }
+  if (value.startsWith('bun')) {
+    return 'bun';
+  }
+  if (value.startsWith('pnpm')) {
+    return 'pnpm';
+  }
+  if (value.startsWith('yarn')) {
+    return 'yarn';
+  }
+  if (value.startsWith('npm')) {
+    return 'npm';
+  }
+  return undefined;
+}
+function detectFromUserAgent(userAgent) {
+  if (!userAgent) {
+    return undefined;
+  }
+  const candidate = userAgent.split(' ')[0];
+  return parsePackageManager(candidate);
+}
+function detectFromDirectory(startDirectory) {
+  let currentDirectory = resolve(startDirectory);
+  while (true) {
+    const packageJsonPath = join(currentDirectory, 'package.json');
+    if (existsSync(packageJsonPath)) {
+      const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+      const fromPackageManagerField = parsePackageManager(packageJson.packageManager);
+      if (fromPackageManagerField) {
+        return fromPackageManagerField;
+      }
+    }
+    if (existsSync(join(currentDirectory, 'bun.lock')) || existsSync(join(currentDirectory, 'bun.lockb'))) {
+      return 'bun';
+    }
+    if (existsSync(join(currentDirectory, 'pnpm-lock.yaml'))) {
+      return 'pnpm';
+    }
+    if (existsSync(join(currentDirectory, 'yarn.lock'))) {
+      return 'yarn';
+    }
+    if (existsSync(join(currentDirectory, 'package-lock.json'))) {
+      return 'npm';
+    }
+    const parentDirectory = dirname(currentDirectory);
+    if (parentDirectory === currentDirectory) {
+      return undefined;
+    }
+    currentDirectory = parentDirectory;
+  }
+}
+
+/**
+ * Detects the package manager that should back the generated starter.
+ *
+ * @param startDirectory Directory used for lockfile and manifest discovery.
+ * @param userAgent Optional package-manager user agent from the caller.
+ * @returns The detected package manager, or the repo default when no signal exists.
+ */
+export function detectPackageManager(startDirectory, userAgent) {
+  return detectFromUserAgent(userAgent) ?? detectFromDirectory(startDirectory) ?? DEFAULT_PACKAGE_MANAGER;
+}
+
+/**
+ * Resolves partial bootstrap selections onto the shared answer model.
+ *
+ * @param partial Partial bootstrap selections collected from flags or runtime callers.
+ * @param cwd Working directory used for package-manager detection.
+ * @param userAgent Optional package-manager user agent from the caller.
+ * @returns Fully resolved bootstrap answers with defaults applied.
+ */
+export function resolveBootstrapAnswers(partial, cwd, userAgent) {
+  if (!partial.projectName) {
+    throw new Error('Project name is required.');
+  }
+  const projectName = assertValidProjectName(partial.projectName);
+  const schema = resolveBootstrapSchema(partial);
+  return {
+    initializeGit: partial.initializeGit ?? DEFAULT_INITIALIZE_GIT,
+    installDependencies: partial.installDependencies ?? DEFAULT_INSTALL_DEPENDENCIES,
+    packageManager: partial.packageManager ?? detectPackageManager(cwd, userAgent),
+    ...schema,
+    projectName,
+    targetDirectory: partial.targetDirectory ?? `./${projectName}`
+  };
+}
+
+/**
+ * Collects bootstrap answers through the interactive wizard when needed.
+ *
+ * @param partial Partial bootstrap selections collected from flags or runtime callers.
+ * @param cwd Working directory used for package-manager detection.
+ * @param userAgent Optional package-manager user agent from the caller.
+ * @param options Runtime overrides for interactive prompting.
+ * @returns Fully resolved bootstrap answers for scaffolding.
+ */
+export async function collectBootstrapAnswers(partial, cwd, userAgent, options = {}) {
+  const interactive = options.interactive ?? (options.prompt !== undefined || Boolean(options.stdin?.isTTY ?? process.stdin.isTTY));
+  if (!shouldPromptForAnswers(partial, interactive)) {
+    return resolveBootstrapAnswers(partial, cwd, userAgent);
+  }
+  const prompt = options.prompt ?? createBootstrapPrompter();
+  const isInteractiveShell = options.prompt === undefined;
+  try {
+    if (isInteractiveShell) {
+      clack.intro('fluo new');
+    }
+    const answers = await resolveInteractiveBootstrapAnswers(partial, cwd, userAgent, prompt);
+    if (isInteractiveShell) {
+      clack.outro(`Project created! Run: cd ${answers.targetDirectory}`);
+    }
+    return answers;
+  } finally {
+    prompt.close?.();
+  }
+}

package/dist/new/resolver.d.ts

@@ -0,0 +1,32 @@
+import type { BootstrapOptions, BootstrapSchema } from './types.js';
+import { type StarterProfile } from './starter-profiles.js';
+type BootstrapResolutionInput = Partial<BootstrapSchema> & Pick<Partial<BootstrapOptions>, 'packageManager'>;
+/**
+ * Shape-first compatibility baseline for `fluo new` until additional starter variants ship.
+ */
+export declare const DEFAULT_BOOTSTRAP_SCHEMA: BootstrapSchema;
+/**
+ * Dependency set required by the currently supported `fluo new` starter baseline.
+ */
+export interface ResolvedBootstrapPlan {
+    dependencies: StarterProfile['dependencies'];
+    emitter: StarterProfile['emitter'];
+    profile: StarterProfile;
+    schema: BootstrapSchema;
+}
+/**
+ * Resolves a partial starter schema onto the currently supported v2 compatibility baseline.
+ *
+ * @param partial Partial CLI/runtime schema selections.
+ * @returns A normalized bootstrap schema with defaults applied.
+ */
+export declare function resolveBootstrapSchema(partial?: Partial<BootstrapSchema>): BootstrapSchema;
+/**
+ * Resolves the dependency and emitter plan for the requested starter schema.
+ *
+ * @param options Partial or full bootstrap options collected from the CLI/runtime surface.
+ * @returns The normalized schema plus the emitter boundary that should render scaffold files.
+ */
+export declare function resolveBootstrapPlan(options: BootstrapResolutionInput | BootstrapOptions): ResolvedBootstrapPlan;
+export {};
+//# sourceMappingURL=resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/new/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAGhB,MAAM,YAAY,CAAC;AACpB,OAAO,EAYL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAE/B,KAAK,wBAAwB,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,CAAC;AAE7G;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAA6C,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IAC7C,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACnC,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;CACzB;AAyBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,eAAe,CAe9F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,GAAG,gBAAgB,GAAG,qBAAqB,CAkFhH"}

package/dist/new/resolver.js

@@ -0,0 +1,93 @@
+import { getDefaultBootstrapSchema, getDefaultBootstrapSchemaForShape, getStarterProfileForShape, getStarterProfileFromSchema, isSupportedMicroserviceStarterTransport, SUPPORTED_BOOTSTRAP_PLATFORMS, SUPPORTED_BOOTSTRAP_RUNTIMES, SUPPORTED_BOOTSTRAP_SHAPES, SUPPORTED_BOOTSTRAP_TOOLING_PRESETS, SUPPORTED_BOOTSTRAP_TOPOLOGY_MODES, SUPPORTED_BOOTSTRAP_TRANSPORTS } from './starter-profiles.js';
+/**
+ * Shape-first compatibility baseline for `fluo new` until additional starter variants ship.
+ */
+export const DEFAULT_BOOTSTRAP_SCHEMA = getDefaultBootstrapSchema();
+
+/**
+ * Dependency set required by the currently supported `fluo new` starter baseline.
+ */
+
+function defaultSchemaForShape(shape, runtime) {
+  return getDefaultBootstrapSchemaForShape(shape, runtime);
+}
+function assertOneOf(label, value, supported) {
+  if (!supported.includes(value)) {
+    throw new Error(`Unsupported ${label} "${value}". Supported values: ${supported.join(', ')}.`);
+  }
+  return value;
+}
+function normalizeTopology(topology) {
+  return {
+    deferred: topology?.deferred ?? true,
+    mode: assertOneOf('topology mode', topology?.mode ?? DEFAULT_BOOTSTRAP_SCHEMA.topology.mode, SUPPORTED_BOOTSTRAP_TOPOLOGY_MODES)
+  };
+}
+
+/**
+ * Resolves a partial starter schema onto the currently supported v2 compatibility baseline.
+ *
+ * @param partial Partial CLI/runtime schema selections.
+ * @returns A normalized bootstrap schema with defaults applied.
+ */
+export function resolveBootstrapSchema(partial = {}) {
+  const shape = assertOneOf('shape', partial.shape ?? DEFAULT_BOOTSTRAP_SCHEMA.shape, SUPPORTED_BOOTSTRAP_SHAPES);
+  const runtime = partial.runtime ? assertOneOf('runtime', partial.runtime, SUPPORTED_BOOTSTRAP_RUNTIMES) : undefined;
+  const defaults = defaultSchemaForShape(shape, runtime);
+  return {
+    platform: assertOneOf('platform', partial.platform ?? defaults.platform, SUPPORTED_BOOTSTRAP_PLATFORMS),
+    runtime: assertOneOf('runtime', partial.runtime ?? defaults.runtime, SUPPORTED_BOOTSTRAP_RUNTIMES),
+    shape,
+    tooling: assertOneOf('tooling', partial.tooling ?? defaults.tooling, SUPPORTED_BOOTSTRAP_TOOLING_PRESETS),
+    topology: normalizeTopology(partial.topology),
+    transport: assertOneOf('transport', partial.transport ?? defaults.transport, SUPPORTED_BOOTSTRAP_TRANSPORTS)
+  };
+}
+
+/**
+ * Resolves the dependency and emitter plan for the requested starter schema.
+ *
+ * @param options Partial or full bootstrap options collected from the CLI/runtime surface.
+ * @returns The normalized schema plus the emitter boundary that should render scaffold files.
+ */
+export function resolveBootstrapPlan(options) {
+  const schema = resolveBootstrapSchema(options);
+  const starterProfile = getStarterProfileFromSchema(schema);
+  if (starterProfile) {
+    return {
+      dependencies: starterProfile.dependencies,
+      emitter: starterProfile.emitter,
+      profile: starterProfile,
+      schema
+    };
+  }
+  const defaultProfile = getStarterProfileForShape(schema.shape);
+  if (schema.shape === 'microservice' && schema.transport === 'http') {
+    throw new Error('Unsupported bootstrap schema "microservice/node/http/' + schema.platform + '/standard/single-package". ' + 'Microservice starters require a transport-aware microservice transport such as tcp, redis-streams, mqtt, grpc, nats, kafka, or rabbitmq.');
+  }
+  if (schema.shape === 'application' && isSupportedMicroserviceStarterTransport(schema.transport)) {
+    throw new Error('Unsupported bootstrap schema "application/node/' + schema.transport + '/' + schema.platform + '/standard/single-package". ' + 'Application starters currently require the HTTP transport across the Fastify, Express, raw Node.js, Bun, Deno, and Cloudflare Workers starter profiles.');
+  }
+  if (schema.shape === 'mixed' && schema.transport === 'http') {
+    throw new Error('Unsupported bootstrap schema "mixed/node/http/' + schema.platform + '/standard/' + schema.topology.mode + '". ' + 'The first mixed starter uses the HTTP API plus an attached TCP microservice; use tcp for the supported mixed contract.');
+  }
+  if (schema.shape === 'microservice' && isSupportedMicroserviceStarterTransport(schema.transport) && schema.transport !== defaultProfile.schema.transport) {
+    throw new Error('Unsupported bootstrap schema "microservice/node/' + schema.transport + '/' + schema.platform + '/standard/single-package". ' + 'The first-class microservice starters currently scaffold tcp, redis-streams, nats, kafka, rabbitmq, mqtt, and grpc.');
+  }
+  if (schema.shape === 'mixed' && isSupportedMicroserviceStarterTransport(schema.transport) && schema.transport !== defaultProfile.schema.transport) {
+    throw new Error('Unsupported bootstrap schema "mixed/node/' + schema.transport + '/' + schema.platform + '/standard/' + schema.topology.mode + '". ' + 'The first mixed starter currently supports only the attached TCP microservice contract.');
+  }
+  if (schema.shape === 'application' && schema.topology.mode !== 'single-package') {
+    throw new Error('Unsupported bootstrap schema "application/node/' + schema.transport + '/' + schema.platform + '/standard/' + schema.topology.mode + '". ' + 'Application starters currently support only the single-package HTTP topology; use --shape mixed for the API + microservice starter.');
+  }
+  if (schema.shape === 'microservice' && schema.topology.mode !== 'single-package') {
+    throw new Error('Unsupported bootstrap schema "microservice/node/' + schema.transport + '/' + schema.platform + '/standard/' + schema.topology.mode + '". ' + 'Microservice starters currently support only the single-package microservice topology.');
+  }
+  if (schema.shape === 'mixed' && schema.topology.mode !== 'single-package') {
+    throw new Error('Unsupported bootstrap schema "mixed/node/' + schema.transport + '/' + schema.platform + '/standard/' + schema.topology.mode + '". ' + 'Mixed starters currently support only the single-package contract: one Fastify HTTP application with an attached TCP microservice.');
+  }
+  if (schema.tooling !== 'standard' || schema.topology.deferred !== true) {
+    throw new Error(`Unsupported bootstrap schema "${schema.shape}/${schema.runtime}/${schema.transport}/${schema.platform}/${schema.tooling}/${schema.topology.mode}". ` + 'The current compatibility baseline supports the standard single-package Node + Fastify/Express/raw Node.js HTTP starters, Bun/Deno/Cloudflare Workers HTTP starters, the tcp/redis-streams/nats/kafka/rabbitmq/mqtt/grpc microservice starters, and the mixed single-package starter.');
+  }
+  throw new Error(`Unsupported bootstrap schema "${schema.shape}/${schema.runtime}/${schema.transport}/${schema.platform}/${schema.tooling}/${schema.topology.mode}". ` + 'The current compatibility baseline supports the standard single-package Node + Fastify/Express/raw Node.js HTTP starters, Bun/Deno/Cloudflare Workers HTTP starters, the tcp/redis-streams/nats/kafka/rabbitmq/mqtt/grpc microservice starters, and the mixed single-package starter.');
+}

package/dist/new/scaffold.d.ts

@@ -0,0 +1,14 @@
+import type { BootstrapOptions } from './types.js';
+/**
+ * Scaffolds a new fluo application into the target directory.
+ *
+ * @param options Bootstrap configuration for the new project.
+ * @param importMetaUrl Optional URL of the importing module for relative path resolution.
+ * @returns A promise that resolves when the project has been scaffolded.
+ */
+export declare function scaffoldBootstrapApp(options: BootstrapOptions, importMetaUrl?: string): Promise<void>;
+/**
+ * Alias for {@link scaffoldBootstrapApp}.
+ */
+export declare const scaffoldFluoApp: typeof scaffoldBootstrapApp;
+//# sourceMappingURL=scaffold.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/new/scaffold.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AAijEnE;;;;;;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"}