@asterflow/cli 2.0.1 → 2.1.0

package/dist/types/generators/packageJson.d.ts

@@ -5,4 +5,4 @@ export interface PackageJsonOptions {
     adapter: AdapterDefinition;
     plugins: PluginDefinition[];
 }
-export declare function generatePackage({ name, adapter, plugins }: PackageJsonOptions): string;
+export declare function generatePackage({ name, adapter, plugins }: PackageJsonOptions): Promise<string>;

package/dist/types/helpers/npmVersion.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resolves the safest install range for an AsterFlow-ecosystem package: the latest
+ * published patch within this CLI's own major.minor line, e.g. `^2.0.4` when the CLI
+ * itself is `2.0.1`. Every asterflow package moves in lockstep (see VERSIONING.md) and
+ * only the patch digit (Z) is guaranteed to carry zero API/type surface impact - a
+ * minor bump can break types, a major can break runtime - so floating past the CLI's
+ * own X.Y would risk reintroducing the exact cross-package mismatch (e.g. scaffolding
+ * `asterflow@0.0.5` next to `@asterflow/fs@1.0.7`) this resolver exists to prevent.
+ * Falls back to the CLI's own version when the registry can't be reached, so scaffolding
+ * still works offline - just without picking up any patch released since this CLI build.
+ */
+export declare function resolveAsterflowVersion(packageName: string): Promise<string>;
+/**
+ * Resolves the `^latest` install range for a regular (non-AsterFlow-ecosystem)
+ * npm package, e.g. `tsdown`. Unlike `resolveAsterflowVersion`, this isn't
+ * pinned to the CLI's own major.minor - it just reads the registry's `latest`
+ * dist-tag. Falls back to `fallbackVersion` when the registry can't be reached.
+ */
+export declare function resolveLatestVersion(packageName: string, fallbackVersion: string): Promise<string>;

package/dist/types/registry/adapters.d.ts

@@ -11,6 +11,8 @@ export interface AdapterDefinition {
     preamble: string | null;
     /** Everything after `.listen` - arguments and callback - appended to the exported chain. */
     listenCall: string;
+    /** Binary used to run the bundled `dist/index.mjs` in the `start` script - `bun` needs Bun's globals, everything else runs under plain Node. */
+    runCommand: 'bun' | 'node';
 }
 export declare const ADAPTER_REGISTRY: Record<string, AdapterDefinition>;
 export declare const ADAPTER_IDS: string[];

package/dist/types/registry/plugins.d.ts

@@ -1,7 +1,6 @@
 export interface PluginDefinition {
     id: string;
     packageName: string;
-    version: string;
     description: string;
     /** Binding name imported from the plugin's package, e.g. `multipartPlugin`. */
     importName: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asterflow/cli",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "CLI for scaffolding AsterFlow projects, adding plugins, and generating the static fs-routing manifest.",
   "keywords": [
     "asterflow",
@@ -40,7 +40,7 @@
     "dev": "bun run src/index.ts"
   },
   "dependencies": {
-    "@asterflow/fs": "^2.0.1",
+    "@asterflow/fs": "^2.1.0",
     "@clack/prompts": "^0.9.1",
     "chalk": "^4.1.2",
     "ci-info": "^4.1.0",

package/templates/tsdown.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  platform: 'node',
+  clean: true
+})