@arkstack/console 0.13.2 → 0.14.1

package/dist/index.js

@@ -1,14 +1,15 @@
 #!/usr/bin/env node
 import { t as ArkstackConsoleApp } from "./app-DnaQWE9q.js";
 import { n as BaseTCConfig, r as TSConfig, t as BuildInterfaces } from "./BuildInterfaces-CsZ3Uerb.js";
-import { abort, abortIf, assertFound, config, discoverCommands, env, importFile, initializeGlobalContext, loadPrototypes, outputDir, rebuildOutput } from "@arkstack/common";
-import { existsSync, realpathSync } from "node:fs";
+import { Publisher, abort, abortIf, assertFound, config, discoverCommands, env, importFile, initializeGlobalContext, loadPrototypes, outputDir, rebuildOutput } from "@arkstack/common";
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, statSync, writeFileSync } from "node:fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import path, { join } from "node:path";
+import path, { dirname, join } from "node:path";
 import { Arkstack } from "@arkstack/contract";
 import { MakeResource, applyRuntimeConfig, getDefaultConfig } from "resora";
 import { Command, Kernel } from "@h3ravel/musket";
 import { spawn } from "node:child_process";
+import { randomBytes } from "node:crypto";
 import { resolve } from "path";
 import { writeFile } from "fs/promises";
 import { CliApp as CliApp$1 } from "arkormx";
@@ -76,6 +77,47 @@ var DevCommand = class extends Command {
 	}
 };
 
+//#endregion
+//#region dist/commands/KeyGenerateCommand.js
+/**
+* Generate and set the application key (APP_KEY).
+*
+* APP_KEY is the unified secret used for signing JWTs and encrypting values
+* across the framework (exposed as `config('app.key')`).
+*/
+var KeyGenerateCommand = class extends Command {
+	signature = `key:generate
+        {--show : Display the generated key instead of writing it to the .env file.}
+        {--force : Overwrite the existing APP_KEY without confirmation.}
+    `;
+	description = "Set the application key (APP_KEY).";
+	async handle() {
+		const key = this.generateKey();
+		if (this.option("show")) {
+			this.line(key);
+			return;
+		}
+		const envPath = join(Arkstack.rootDir(), ".env");
+		if (!existsSync(envPath)) {
+			this.error("No .env file found. Copy .env.example to .env before running key:generate.");
+			return;
+		}
+		const contents = readFileSync(envPath, "utf-8");
+		const existing = contents.match(/^APP_KEY=(.*)$/m);
+		if (existing?.[1]?.trim() && !this.option("force")) {
+			if (!await this.confirm("An application key already exists. Overwrite it?", false)) {
+				this.info("Application key generation aborted.");
+				return;
+			}
+		}
+		writeFileSync(envPath, existing ? contents.replace(/^APP_KEY=.*$/m, `APP_KEY=${key}`) : `${contents.replace(/\s*$/, "")}\nAPP_KEY=${key}\n`);
+		this.success("Application key set successfully.");
+	}
+	generateKey() {
+		return randomBytes(32).toString("base64url");
+	}
+};
+
 //#endregion
 //#region dist/commands/MakeCommand.js
 var MakeCommand = class extends Command {
@@ -198,6 +240,118 @@ var MakeResource$1 = class extends MakeResource {
 	}
 };
 
+//#endregion
+//#region dist/commands/PublishCommand.js
+/** Suffix that marks a file as a publishable stub; stripped on publish. */
+const STUB_SUFFIX = ".stub";
+/**
+* Strip a trailing `.stub` suffix from a path.
+*
+* Stubs are shipped as `<name>.<ext>.stub` so they are ignored by linting,
+* type-checking and test discovery in the source repo, then restored to their
+* real extension when published into an application.
+*
+* @param path
+*/
+const stripStubSuffix = (path) => path.endsWith(STUB_SUFFIX) ? path.slice(0, -5) : path;
+/**
+* Publish artifacts (migrations, stubs, assets, …) that installed packages
+* register via `publishes()` into the consuming application.
+*/
+var PublishCommand = class extends Command {
+	signature = `publish
+        {--package= : Only publish artifacts registered by this package (e.g. @arkstack/cache).}
+        {--tag= : Only publish artifacts registered under this tag.}
+        {--force : Overwrite files that already exist at the destination.}
+        {--list : List the publishable artifacts without copying anything.}
+    `;
+	description = "Publish package artifacts into your application.";
+	async handle() {
+		await this.loadPackageSetups();
+		const filter = {
+			package: this.option("package"),
+			tag: this.option("tag")
+		};
+		const groups = Publisher.publishables(filter);
+		if (groups.length < 1) {
+			this.warn(`No publishable artifacts found${this.describeFilter(filter)}.`);
+			return;
+		}
+		if (this.option("list")) {
+			this.listGroups(groups);
+			return;
+		}
+		let published = 0;
+		let skipped = 0;
+		for (const group of groups) for (const entry of group.entries) {
+			if (!existsSync(entry.from)) {
+				this.warn(`[${group.package}] Source not found, skipping: ${entry.from}`);
+				continue;
+			}
+			const to = stripStubSuffix(entry.to);
+			const dest = join(Arkstack.rootDir(), to);
+			if (existsSync(dest) && !this.option("force")) {
+				this.warn(`Exists, skipped (use --force): ${to}`);
+				skipped++;
+				continue;
+			}
+			mkdirSync(dirname(dest), { recursive: true });
+			cpSync(entry.from, dest, { recursive: true });
+			if (statSync(dest).isDirectory()) this.stripStubsInTree(dest);
+			this.success(`Published [${group.package}] -> ${to}`);
+			published++;
+		}
+		this.info(`Done. ${published} published, ${skipped} skipped.`);
+	}
+	/**
+	* Recursively rename `*.stub` files within a published directory to their
+	* real extension.
+	*
+	* @param dir
+	*/
+	stripStubsInTree(dir) {
+		for (const item of readdirSync(dir, {
+			recursive: true,
+			withFileTypes: true
+		})) if (item.isFile() && item.name.endsWith(STUB_SUFFIX)) {
+			const current = join(item.parentPath, item.name);
+			renameSync(current, stripStubSuffix(current));
+		}
+	}
+	/**
+	* Print the publishable artifacts grouped by package without copying.
+	*
+	* @param groups
+	*/
+	listGroups(groups) {
+		this.info("Publishable artifacts:");
+		for (const group of groups) {
+			this.line(`  ${group.package}${group.tag ? ` (tag: ${group.tag})` : ""}`);
+			for (const entry of group.entries) this.line(`    - ${stripStubSuffix(entry.to)}`);
+		}
+	}
+	/**
+	* Import the `setup` module of every installed `@arkstack/*` package so its
+	* `publishes()` registrations run. Errors (missing build, side effects) are
+	* ignored so one bad package cannot break publishing.
+	*/
+	async loadPackageSetups() {
+		const scope = join(Arkstack.rootDir(), "node_modules", "@arkstack");
+		if (!existsSync(scope)) return;
+		for (const pkg of readdirSync(scope)) {
+			const setup = join(scope, pkg, "dist", "setup.js");
+			if (!existsSync(setup)) continue;
+			try {
+				await import(pathToFileURL(setup).href);
+			} catch {}
+		}
+	}
+	describeFilter(filter) {
+		const parts = [filter.package ? `package "${filter.package}"` : "", filter.tag ? `tag "${filter.tag}"` : ""].filter(Boolean);
+		return parts.length ? ` for ${parts.join(" and ")}` : "";
+	}
+};
+
 //#endregion
 //#region dist/commands/RouteList.js
 var RouteList = class extends Command {
@@ -332,6 +486,8 @@ const runConsoleKernel = async (options = {}) => {
 			DevCommand,
 			BuildCommand,
 			MakeCommand,
+			KeyGenerateCommand,
+			PublishCommand,
 			...userCommands
 		],
 		discoveryPaths: [join(Arkstack.rootDir(), "node_modules", "@arkstack/*", "dist", "commands", "*.js")],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkstack/console",
-  "version": "0.13.2",
+  "version": "0.14.1",
   "type": "module",
   "description": "Console module for Arkstack, providing the command-line runtime and console integration layer.",
   "homepage": "https://arkstack.toneflix.net/guide/cli",
@@ -42,7 +42,7 @@
     }
   },
   "peerDependencies": {
-    "arkormx": "^2.9.2",
+    "arkormx": "^2.9.3",
     "clear-router": "^2.8.8"
   },
   "dependencies": {
@@ -51,8 +51,8 @@
     "chalk": "^5.6.2",
     "resora": "^1.3.26",
     "ts-morph": "^28.0.0",
-    "@arkstack/common": "^0.13.2",
-    "@arkstack/contract": "^0.13.2"
+    "@arkstack/contract": "^0.14.1",
+    "@arkstack/common": "^0.14.1"
   },
   "scripts": {
     "build": "tsdown",