@arkstack/common 0.12.35 → 0.12.37

package/dist/index.d.ts

@@ -275,6 +275,15 @@ declare const nodeEnv: () => "prod" | "dev";
  * @returns
  */
 declare const outputDir: (cwd?: string) => string;
+/**
+ * Rebuild the application output (tsdown) into {@link outputDir}, wiping it first
+ * so no stale emitted modules survive a source change. Standalone — it does NOT
+ * boot the app — so the console kernel can call it to self-heal a stale or
+ * incomplete build artifact that would otherwise wedge startup. Build-only: it
+ * sets `CLI_BUILD` so tsdown emits without starting a watcher/dev server, and
+ * inherits the current `NODE_ENV` so it targets the same dir the kernel reads.
+ */
+declare const rebuildOutput: () => Promise<void>;
 /**
  *
  * Dynamically imports a file at the given path with full TypeScript support,
@@ -287,6 +296,22 @@ declare const outputDir: (cwd?: string) => string;
  * const config = await importFile<AppConfig>('./config/app.ts')
  */
 declare const importFile: FileImporter;
+/**
+ * Discover console command classes from the application's command directory.
+ *
+ * Commands are loaded straight from TypeScript source through {@link importFile}
+ * (jiti), so they are picked up without a build and reflect edits on every run.
+ * The built output is only used as a fallback when the source directory is
+ * absent — e.g. a production deploy that ships `dist` without `src`.
+ *
+ * This exists because musket's own glob discovery imports paths with native
+ * `import()`, which silently skips `.ts` files — the reason commands previously
+ * only appeared after a `build --dev` and never reflected later edits.
+ *
+ * @param subPath   Command directory relative to the app root (src/dist aware).
+ * @returns         The discovered command classes.
+ */
+declare const discoverCommands: <T = unknown>(subPath?: string) => Promise<T[]>;
 /**
  * Resolves the default export from a module, handling both CJS and ESM interop.
  * In CJS modules, the default export is often the module itself (a function or object),
@@ -432,4 +457,4 @@ declare class Hook {
   static clear: () => void;
 }
 //#endregion
-export { AbstractModelConstructor, AppException, ArkstackErrorPayload, ArkstackErrorShape, CONFIG_KEY, ConfigRegistry, ConfigShape, DotPath, DotPathValue, Encryption, EnvRegistry, ErrorHandler, Exception, FileImporter, GlobalConfig, GlobalEnv, Hash, Hook, HookArgs, HookFor, HookName, HookPos, HookPositions, HookRegistry, IHook, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, MergedConfig, ModelConstructor, ModelRegistry, Primitive, RequestException, UnionToIntersection, abort, abortIf, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, createErrorPayload, env, getErrorLogger, getModel, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isClass, isModelNotFoundError, isValidationError, loadPrototypes, logUnhandledError, nodeEnv, normalizeStatusCode, outputDir, perPage, renderError, serializeError, shouldHideStack, shouldLogError, toErrorShape };
+export { AbstractModelConstructor, AppException, ArkstackErrorPayload, ArkstackErrorShape, CONFIG_KEY, ConfigRegistry, ConfigShape, DotPath, DotPathValue, Encryption, EnvRegistry, ErrorHandler, Exception, FileImporter, GlobalConfig, GlobalEnv, Hash, Hook, HookArgs, HookFor, HookName, HookPos, HookPositions, HookRegistry, IHook, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, MergedConfig, ModelConstructor, ModelRegistry, Primitive, RequestException, UnionToIntersection, abort, abortIf, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, createErrorPayload, discoverCommands, env, getErrorLogger, getModel, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isClass, isModelNotFoundError, isValidationError, loadPrototypes, logUnhandledError, nodeEnv, normalizeStatusCode, outputDir, perPage, rebuildOutput, renderError, serializeError, shouldHideStack, shouldLogError, toErrorShape };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { C as importFile, E as outputDir, S as env, T as nodeEnv, _ as Hash, b as appUrl, c as abortIf, d as initializeGlobalContext, f as isClass, g as Exception, h as AppException, l as assertFound, m as RequestException, p as perPage, s as abort, u as getModel, v as Encryption, w as interopDefault, x as config, y as CONFIG_KEY } from "./utils-CFjlZZ91.js";
+import { C as env, D as outputDir, E as nodeEnv, O as rebuildOutput, S as discoverCommands, T as interopDefault, _ as Hash, b as appUrl, c as abortIf, d as initializeGlobalContext, f as isClass, g as Exception, h as AppException, l as assertFound, m as RequestException, p as perPage, s as abort, u as getModel, v as Encryption, w as importFile, x as config, y as CONFIG_KEY } from "./utils-yPBhsll_.js";
 import { Hook as Hook$1 } from "@arkstack/foundry";
 import { str } from "@h3ravel/support";
 import { Arkstack } from "@arkstack/contract";
@@ -481,4 +481,4 @@ var Hook = class {
 	};
 };
 //#endregion
-export { AppException, CONFIG_KEY, Encryption, ErrorHandler, Exception, Hash, Hook, Logger, RequestException, abort, abortIf, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, createErrorPayload, env, getErrorLogger, getModel, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isClass, isModelNotFoundError, isValidationError, loadPrototypes, logUnhandledError, nodeEnv, normalizeStatusCode, outputDir, perPage, renderError, serializeError, shouldHideStack, shouldLogError, toErrorShape };
+export { AppException, CONFIG_KEY, Encryption, ErrorHandler, Exception, Hash, Hook, Logger, RequestException, abort, abortIf, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, createErrorPayload, discoverCommands, env, getErrorLogger, getModel, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isClass, isModelNotFoundError, isValidationError, loadPrototypes, logUnhandledError, nodeEnv, normalizeStatusCode, outputDir, perPage, rebuildOutput, renderError, serializeError, shouldHideStack, shouldLogError, toErrorShape };

package/dist/utils/index.js

@@ -1,2 +1,2 @@
-import { _ as Hash, a as use, c as abortIf, d as initializeGlobalContext, f as isClass, i as trait, l as assertFound, n as crc32, o as uses, p as perPage, r as getTraitMethods, s as abort, t as callTraitMethods, u as getModel, v as Encryption } from "../utils-CFjlZZ91.js";
+import { _ as Hash, a as use, c as abortIf, d as initializeGlobalContext, f as isClass, i as trait, l as assertFound, n as crc32, o as uses, p as perPage, r as getTraitMethods, s as abort, t as callTraitMethods, u as getModel, v as Encryption } from "../utils-yPBhsll_.js";
 export { Encryption, Hash, abort, abortIf, assertFound, callTraitMethods, crc32, getModel, getTraitMethods, initializeGlobalContext, isClass, perPage, trait, use, uses };

package/dist/{utils-CFjlZZ91.js → utils-yPBhsll_.js}

@@ -6,6 +6,8 @@ import { createRequire } from "module";
 import path, { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { readdirSync } from "fs";
+import { rm } from "node:fs/promises";
+import { spawn } from "node:child_process";
 import { Secret, TOTP } from "otpauth";
 import { compare, genSalt, hash } from "bcryptjs";
 import { getUserConfig } from "arkormx";
@@ -121,6 +123,40 @@ const outputDir = (cwd) => {
 	return path.isAbsolute(output[NODE_ENV] ?? output.dev) ? output[NODE_ENV] ?? output.dev : path.join(cwd, output[NODE_ENV] ?? output.dev);
 };
 /**
+* Rebuild the application output (tsdown) into {@link outputDir}, wiping it first
+* so no stale emitted modules survive a source change. Standalone — it does NOT
+* boot the app — so the console kernel can call it to self-heal a stale or
+* incomplete build artifact that would otherwise wedge startup. Build-only: it
+* sets `CLI_BUILD` so tsdown emits without starting a watcher/dev server, and
+* inherits the current `NODE_ENV` so it targets the same dir the kernel reads.
+*/
+const rebuildOutput = async () => {
+	await rm(outputDir(), {
+		recursive: true,
+		force: true
+	});
+	await new Promise((resolveBuild, reject) => {
+		const child = spawn(process.platform === "win32" ? "pnpm.cmd" : "pnpm", [
+			"exec",
+			"tsdown",
+			"--log-level",
+			"silent"
+		], {
+			cwd: Arkstack.rootDir(),
+			stdio: "inherit",
+			env: Object.assign({}, process.env, { CLI_BUILD: "true" })
+		});
+		child.on("error", reject);
+		child.on("exit", (code) => {
+			if (code === 0 || code === null) {
+				resolveBuild();
+				return;
+			}
+			reject(/* @__PURE__ */ new Error(`tsdown exited with code ${code}`));
+		});
+	});
+};
+/**
 * 
 * Dynamically imports a file at the given path with full TypeScript support,
 * including `tsconfig.json` path aliases. 
@@ -140,6 +176,67 @@ const importFile = async (filePath, userOptions, resolveOptions) => {
 	}).import(resolvedPath, resolveOptions);
 };
 /**
+* Picks the command class out of an imported module. Prefers the export named
+* after the file (musket's discovery convention), then a default export, then
+* the first exported constructor it finds.
+*
+* @param mod        The imported module namespace.
+* @param basename   The file name without extension.
+* @returns          The resolved command class, or undefined when none is found.
+*/
+const resolveCommandExport = (mod, basename) => {
+	const named = mod[basename];
+	if (typeof named === "function") return named;
+	if (typeof mod.default === "function") return mod.default;
+	return Object.values(mod).find((value) => typeof value === "function");
+};
+/**
+* Discover console command classes from the application's command directory.
+*
+* Commands are loaded straight from TypeScript source through {@link importFile}
+* (jiti), so they are picked up without a build and reflect edits on every run.
+* The built output is only used as a fallback when the source directory is
+* absent — e.g. a production deploy that ships `dist` without `src`.
+*
+* This exists because musket's own glob discovery imports paths with native
+* `import()`, which silently skips `.ts` files — the reason commands previously
+* only appeared after a `build --dev` and never reflected later edits.
+*
+* @param subPath   Command directory relative to the app root (src/dist aware).
+* @returns         The discovered command classes.
+*/
+const discoverCommands = async (subPath = path.join("app", "console", "commands")) => {
+	const root = Arkstack.rootDir();
+	const dist = path.relative(root, outputDir());
+	const candidateDirs = [path.join(root, "src", subPath), path.join(root, dist, subPath)];
+	let commandsDir;
+	let files = [];
+	for (const dir of candidateDirs) try {
+		const entries = readdirSync(dir, { withFileTypes: true }).filter((file) => file.isFile() && [
+			".ts",
+			".js",
+			".mjs"
+		].includes(path.extname(file.name)));
+		if (entries.length > 0) {
+			commandsDir = dir;
+			files = entries;
+			break;
+		}
+	} catch {}
+	if (!commandsDir) return [];
+	const commands = [];
+	for (const file of files) {
+		const basename = path.basename(file.name, path.extname(file.name));
+		try {
+			const command = resolveCommandExport(await importFile(path.join(commandsDir, file.name)), basename);
+			if (command) commands.push(command);
+		} catch (error) {
+			console.error(`[arkstack] Failed to load command "${file.name}":`, error);
+		}
+	}
+	return commands;
+};
+/**
 * Resolves the default export from a module, handling both CJS and ESM interop.
 * In CJS modules, the default export is often the module itself (a function or object),
 * while in ESM the default is nested under the `default` property.
@@ -580,4 +677,4 @@ function uses(instance, trait) {
 	return false;
 }
 //#endregion
-export { importFile as C, outputDir as E, env as S, nodeEnv as T, Hash as _, use as a, appUrl as b, abortIf as c, initializeGlobalContext as d, isClass as f, Exception as g, AppException as h, trait as i, assertFound as l, RequestException as m, crc32 as n, uses as o, perPage as p, getTraitMethods as r, abort as s, callTraitMethods as t, getModel as u, Encryption as v, interopDefault as w, config as x, CONFIG_KEY as y };
+export { env as C, outputDir as D, nodeEnv as E, rebuildOutput as O, discoverCommands as S, interopDefault as T, Hash as _, use as a, appUrl as b, abortIf as c, initializeGlobalContext as d, isClass as f, Exception as g, AppException as h, trait as i, assertFound as l, RequestException as m, crc32 as n, uses as o, perPage as p, getTraitMethods as r, abort as s, callTraitMethods as t, getModel as u, Encryption as v, importFile as w, config as x, CONFIG_KEY as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkstack/common",
-  "version": "0.12.35",
+  "version": "0.12.37",
   "type": "module",
   "description": "Core utilities, primitives, and shared infrastructure for the Arkstack ecosystem.",
   "homepage": "https://arkstack.toneflix.net",
@@ -42,8 +42,8 @@
   "peerDependencies": {
     "@h3ravel/support": "^2.1.4",
     "arkormx": "^2.9.0",
-    "@arkstack/foundry": "^0.12.35",
-    "@arkstack/contract": "^0.12.35"
+    "@arkstack/foundry": "^0.12.37",
+    "@arkstack/contract": "^0.12.37"
   },
   "scripts": {
     "build": "tsdown --config-loader unrun",