@arkstack/common 0.17.18 → 0.17.20

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 /// <reference path="./app.d.ts" />
 import { A as GlobalConfig, B as LoggerLog, C as DotPath, D as EnvRegistry, E as EnvLookup, F as HookPos, G as PublishConfirmation, H as MergedConfig, I as HookPositions, J as PublishGroup, K as PublishEntry, L as HookRegistry, M as HookArgs, N as HookFor, O as EnvReturn, P as HookName, R as IHook, S as ConfigShape, T as EnvKey, U as PaginationOptions, V as LoggerParseSignature, W as Primitive, X as Logger, Y as UnionToIntersection, _ as ArkstackErrorPayload, a as abortIf, b as Choices, c as getModelSync, d as normalizePositiveInteger, f as perPage, g as AppConfig, h as Encryption, i as abort, j as GlobalEnv, k as FileImporter, l as initializeGlobalContext, m as Hash, n as ModelConstructor, o as assertFound, p as resolvePagination, q as PublishFilter, r as ModelRegistry, s as getModel, t as AbstractModelConstructor, u as isClass, v as ArkstackErrorShape, w as DotPathValue, x as ConfigRegistry, y as Choice, z as LoggerChalk } from "./helpers-E_O2UDRn.js";
 import { Arkstack } from "@arkstack/contract";
+import { ForkOptions } from "node:child_process";
 import pino from "pino";
 //#region src/lifecycle.d.ts
 declare const bindGracefulShutdown: (shutdown: () => Promise<void> | void, defer?: boolean) => void;
@@ -483,4 +484,34 @@ declare const devTlsCredentials: (host?: string) => Promise<TlsCredentials>;
  */
 declare const localNetworkAddress: () => string | undefined;
 //#endregion
-export { AbstractModelConstructor, AppConfig, AppException, ArkstackErrorPayload, ArkstackErrorShape, CONFIG_KEY, Choice, Choices, ConfigLoader, ConfigRegistry, ConfigShape, DotPath, DotPathValue, Encryption, EnvKey, EnvLoader, EnvLookup, EnvRegistry, EnvReturn, ErrorHandler, Exception, FileImporter, GlobalConfig, GlobalEnv, Hash, Hook, HookArgs, HookFor, HookName, HookPos, HookPositions, HookRegistry, IHook, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, MergedConfig, ModelConstructor, ModelRegistry, PaginationOptions, Primitive, PublishConfirmation, PublishEntry, PublishFilter, PublishGroup, Publisher, RequestException, TlsCredentials, UnionToIntersection, abort, abortIf, appKey, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, configLoader, createErrorPayload, devTlsCredentials, discoverCommands, env, envLoader, getErrorLogger, getModel, getModelSync, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isClass, isModelNotFoundError, isValidationError, loadPrototypes, localNetworkAddress, logUnhandledError, nodeEnv, normalizePositiveInteger, normalizeStatusCode, outputDir, perPage, rebuildOutput, renderError, resolvePagination, resolveRuntimeDir, resolveRuntimeModule, serializeError, shouldHideStack, shouldLogError, toErrorShape, toOutputPath };
+//#region src/dev-server.d.ts
+interface OutputChunk {
+  facadeModuleId?: string | null;
+  isEntry?: boolean;
+}
+interface OutputOptions {
+  dir?: string;
+  file?: string;
+}
+interface DevServerRunnerOptions extends ForkOptions {
+  input: string;
+  args?: readonly string[];
+}
+/**
+ * Run the emitted server entry after a watched build has completely settled.
+ *
+ * This runner does not replace the live process immediately in `writeBundle`.
+ * Tsdown can still finalize or replace its output after that hook, creating a
+ * short window where Node cannot resolve the entry.
+ */
+declare const devServer: (options: DevServerRunnerOptions) => {
+  name: string;
+  writeBundle?: undefined;
+  closeWatcher?: undefined;
+} | {
+  name: string;
+  writeBundle(output: OutputOptions, bundle: Record<string, OutputChunk>): void;
+  closeWatcher(): Promise<void>;
+};
+//#endregion
+export { AbstractModelConstructor, AppConfig, AppException, ArkstackErrorPayload, ArkstackErrorShape, CONFIG_KEY, Choice, Choices, ConfigLoader, ConfigRegistry, ConfigShape, DevServerRunnerOptions, DotPath, DotPathValue, Encryption, EnvKey, EnvLoader, EnvLookup, EnvRegistry, EnvReturn, ErrorHandler, Exception, FileImporter, GlobalConfig, GlobalEnv, Hash, Hook, HookArgs, HookFor, HookName, HookPos, HookPositions, HookRegistry, IHook, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, MergedConfig, ModelConstructor, ModelRegistry, PaginationOptions, Primitive, PublishConfirmation, PublishEntry, PublishFilter, PublishGroup, Publisher, RequestException, TlsCredentials, UnionToIntersection, abort, abortIf, appKey, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, configLoader, createErrorPayload, devServer, devTlsCredentials, discoverCommands, env, envLoader, getErrorLogger, getModel, getModelSync, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isClass, isModelNotFoundError, isValidationError, loadPrototypes, localNetworkAddress, logUnhandledError, nodeEnv, normalizePositiveInteger, normalizeStatusCode, outputDir, perPage, rebuildOutput, renderError, resolvePagination, resolveRuntimeDir, resolveRuntimeModule, serializeError, shouldHideStack, shouldLogError, toErrorShape, toOutputPath };

package/dist/index.js

@@ -4,6 +4,8 @@ import { Hook as Hook$1 } from "@arkstack/foundry";
 import { Arkstack } from "@arkstack/contract";
 import { str } from "@h3ravel/support";
 import path from "node:path";
+import { access, stat } from "node:fs/promises";
+import { fork } from "node:child_process";
 import { detect } from "detect-port";
 import pino from "pino";
 import chalk from "chalk";
@@ -599,4 +601,63 @@ const localNetworkAddress = () => {
 	for (const list of Object.values(networkInterfaces())) for (const net of list ?? []) if (net.family === "IPv4" && !net.internal) return net.address;
 };
 //#endregion
-export { AppException, CONFIG_KEY, ConfigLoader, Encryption, EnvLoader, ErrorHandler, Exception, Hash, Hook, Logger, Publisher, RequestException, abort, abortIf, appKey, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, configLoader, createErrorPayload, devTlsCredentials, discoverCommands, env, envLoader, getErrorLogger, getModel, getModelSync, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isClass, isModelNotFoundError, isValidationError, loadPrototypes, localNetworkAddress, logUnhandledError, nodeEnv, normalizePositiveInteger, normalizeStatusCode, outputDir, perPage, rebuildOutput, renderError, resolvePagination, resolveRuntimeDir, resolveRuntimeModule, serializeError, shouldHideStack, shouldLogError, toErrorShape, toOutputPath };
+//#region src/dev-server.ts
+/**
+* Run the emitted server entry after a watched build has completely settled.
+*
+* This runner does not replace the live process immediately in `writeBundle`.
+* Tsdown can still finalize or replace its output after that hook, creating a
+* short window where Node cannot resolve the entry.
+*/
+const devServer = (options) => {
+	if (nodeEnv() !== "dev" || process.env.CLI_BUILD === "true") return { name: "arkstack-dev-server-disabled" };
+	let child;
+	let restart = Promise.resolve();
+	const { input: sourceInput, args: runnerArgs = [], ...forkOptions } = options;
+	const input = path.resolve(sourceInput);
+	const args = [...runnerArgs];
+	const waitUntilStable = async (entry) => {
+		let previousSize = -1;
+		for (let attempt = 0; attempt < 50; attempt++) {
+			try {
+				await access(entry);
+				const size = (await stat(entry)).size;
+				if (size > 0 && size === previousSize) return;
+				previousSize = size;
+			} catch {
+				previousSize = -1;
+			}
+			await new Promise((resolve) => setTimeout(resolve, 10));
+		}
+		throw new Error(`The emitted server entry was not ready: ${entry}`);
+	};
+	const stopChild = async () => {
+		if (!child || child.exitCode !== null) return;
+		const exited = new Promise((resolve) => child?.once("exit", () => resolve()));
+		child.kill();
+		await exited;
+	};
+	return {
+		name: "arkstack-dev-server",
+		writeBundle(output, bundle) {
+			const fileName = Object.keys(bundle).find((name) => {
+				const chunk = bundle[name];
+				return chunk?.isEntry && path.resolve(chunk.facadeModuleId ?? "") === input;
+			});
+			if (!fileName) throw new Error("Could not find the emitted server entry");
+			const directory = output.dir ?? path.dirname(output.file ?? "");
+			const entry = path.join(directory, fileName);
+			restart = restart.then(async () => {
+				await new Promise((resolve) => setTimeout(resolve, 0));
+				await waitUntilStable(entry);
+				await stopChild();
+				child = fork(entry, args, forkOptions);
+			});
+		},
+		async closeWatcher() {
+			await stopChild();
+		}
+	};
+};
+//#endregion
+export { AppException, CONFIG_KEY, ConfigLoader, Encryption, EnvLoader, ErrorHandler, Exception, Hash, Hook, Logger, Publisher, RequestException, abort, abortIf, appKey, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, configLoader, createErrorPayload, devServer, devTlsCredentials, discoverCommands, env, envLoader, getErrorLogger, getModel, getModelSync, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isClass, isModelNotFoundError, isValidationError, loadPrototypes, localNetworkAddress, logUnhandledError, nodeEnv, normalizePositiveInteger, normalizeStatusCode, outputDir, perPage, rebuildOutput, renderError, resolvePagination, resolveRuntimeDir, resolveRuntimeModule, serializeError, shouldHideStack, shouldLogError, toErrorShape, toOutputPath };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkstack/common",
-  "version": "0.17.18",
+  "version": "0.17.20",
   "type": "module",
   "description": "Core utilities, primitives, and shared infrastructure for the Arkstack ecosystem.",
   "homepage": "https://arkstack.toneflix.net",
@@ -47,8 +47,8 @@
   "peerDependencies": {
     "@h3ravel/support": "^2.2.7",
     "arkormx": "^2.12.8",
-    "@arkstack/contract": "^0.17.18",
-    "@arkstack/foundry": "^0.17.18"
+    "@arkstack/contract": "^0.17.20",
+    "@arkstack/foundry": "^0.17.20"
   },
   "optionalDependencies": {
     "@faker-js/faker": "^10.4.0"