@start9labs/start-sdk 0.4.0-beta.6 → 0.4.0-beta.61

package/package/lib/health/HealthCheck.js

@@ -3,7 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HealthCheck = void 0;
 const defaultTrigger_1 = require("../trigger/defaultTrigger");
 const util_1 = require("../util");
-const ts_matches_1 = require("ts-matches");
+/**
+ * A periodic health check that reports daemon readiness to the StartOS UI.
+ *
+ * Polls at an interval controlled by a {@link Trigger}, reporting results as
+ * "starting" (during the grace period), "success", or "failure". Automatically
+ * pauses when the daemon is stopped and resumes when restarted.
+ */
 class HealthCheck extends util_1.Drop {
     constructor(effects, o) {
         super();
@@ -18,11 +24,8 @@ class HealthCheck extends util_1.Drop {
         this.currentValue = {};
         this.promise = Promise.resolve().then(async () => {
             const getCurrentValue = () => this.currentValue;
-            const gracePeriod = o.gracePeriod ?? 5000;
+            const gracePeriod = o.gracePeriod ?? 10_000;
             const trigger = (o.trigger ?? defaultTrigger_1.defaultTrigger)(getCurrentValue);
-            const triggerFirstSuccess = (0, util_1.once)(() => Promise.resolve("onFirstSuccess" in o && o.onFirstSuccess
-                ? o.onFirstSuccess()
-                : undefined));
             const checkStarted = () => [
                 this.started,
                 new Promise((resolve) => {
@@ -47,30 +50,27 @@ class HealthCheck extends util_1.Drop {
                     if (triggered) {
                         try {
                             let { result, message } = await o.fn();
-                            if (result === "failure" &&
+                            if (result === 'failure' &&
                                 performance.now() - started <= gracePeriod)
-                                result = "starting";
+                                result = 'starting';
                             await effects.setHealth({
                                 name: o.name,
                                 id: o.id,
                                 result,
-                                message: message || "",
+                                message: message || '',
                             });
                             this.currentValue.lastResult = result;
-                            await triggerFirstSuccess().catch((err) => {
-                                console.error((0, util_1.asError)(err));
-                            });
                         }
                         catch (e) {
                             await effects.setHealth({
                                 name: o.name,
                                 id: o.id,
                                 result: performance.now() - started <= gracePeriod
-                                    ? "starting"
-                                    : "failure",
-                                message: asMessage(e) || "",
+                                    ? 'starting'
+                                    : 'failure',
+                                message: asMessage(e) || '',
                             });
-                            this.currentValue.lastResult = "failure";
+                            this.currentValue.lastResult = 'failure';
                         }
                     }
                 }
@@ -85,14 +85,22 @@ class HealthCheck extends util_1.Drop {
             }
         });
     }
+    /**
+     * Create a new HealthCheck instance and begin its polling loop.
+     * @param effects - The effects context for reporting health status
+     * @param options - Health check configuration (ID, name, check function, trigger, grace period)
+     * @returns A new HealthCheck instance
+     */
     static of(effects, options) {
         return new HealthCheck(effects, options);
     }
+    /** Signal that the daemon is running, enabling health check polling */
     start() {
         if (this.started)
             return;
         this.setStarted(performance.now());
     }
+    /** Signal that the daemon has stopped, pausing health check polling */
     stop() {
         if (!this.started)
             return;
@@ -104,7 +112,7 @@ class HealthCheck extends util_1.Drop {
 }
 exports.HealthCheck = HealthCheck;
 function asMessage(e) {
-    if ((0, ts_matches_1.object)({ message: ts_matches_1.unknown }).test(e))
+    if (typeof e === 'object' && e !== null && 'message' in e)
         return String(e.message);
     const value = String(e);
     if (value.length == null)

package/package/lib/health/HealthCheck.js.map

@@ -1 +1 @@
-{"version":3,"file":"HealthCheck.js","sourceRoot":"","sources":["../../../../package/lib/health/HealthCheck.ts"],"names":[],"mappings":";;;AAIA,8DAA0D;AAC1D,kCAA6C;AAC7C,2CAA4C;AAW5C,MAAa,WAAY,SAAQ,WAAI;IAWnC,YAAoB,OAAgB,EAAE,CAAoB;QACxD,KAAK,EAAE,CAAA;QAXD,YAAO,GAAkB,IAAI,CAAA;QAC7B,eAAU,GAAG,CAAC,OAAsB,EAAE,EAAE;YAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACxB,CAAC,CAAA;QACO,WAAM,GAAG,KAAK,CAAA;QACd,SAAI,GAAG,GAAG,EAAE;YAClB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QACpB,CAAC,CAAA;QACO,iBAAY,GAAiB,EAAE,CAAA;QAIrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAC/C,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAA;YAC/C,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,IAAI,IAAI,CAAA;YACzC,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,+BAAc,CAAC,CAAC,eAAe,CAAC,CAAA;YAC9D,MAAM,mBAAmB,GAAG,IAAA,WAAI,EAAC,GAAG,EAAE,CACpC,OAAO,CAAC,OAAO,CACb,gBAAgB,IAAI,CAAC,IAAI,CAAC,CAAC,cAAc;gBACvC,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE;gBACpB,CAAC,CAAC,SAAS,CACd,CACF,CAAA;YACD,MAAM,YAAY,GAAG,GAAG,EAAE,CACxB;gBACE,IAAI,CAAC,OAAO;gBACZ,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;oBAC5B,IAAI,CAAC,UAAU,GAAG,CAAC,OAAsB,EAAE,EAAE;wBAC3C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;wBACtB,OAAO,EAAE,CAAA;oBACX,CAAC,CAAA;oBACD,IAAI,CAAC,IAAI,GAAG,GAAG,EAAE;wBACf,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;wBAClB,OAAO,EAAE,CAAA;oBACX,CAAC,CAAA;gBACH,CAAC,CAAC;aACM,CAAA;YACZ,IAAI,SAAS,GAAG,KAAK,CAAA;YACrB,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACpB,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,YAAY,EAAE,CAAA;gBACzC,IAAI,IAAI,GAEyD;oBAC/D,OAAO;iBACR,CAAA;gBACD,IAAI,OAAO,EAAE,CAAC;oBACZ,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;oBAChC,IAAI,SAAS,EAAE,CAAC;wBACd,IAAI,CAAC;4BACH,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC,EAAE,EAAE,CAAA;4BACtC,IACE,MAAM,KAAK,SAAS;gCACpB,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,IAAI,WAAW;gCAE1C,MAAM,GAAG,UAAU,CAAA;4BACrB,MAAM,OAAO,CAAC,SAAS,CAAC;gCACtB,IAAI,EAAE,CAAC,CAAC,IAAI;gCACZ,EAAE,EAAE,CAAC,CAAC,EAAE;gCACR,MAAM;gCACN,OAAO,EAAE,OAAO,IAAI,EAAE;6BACvB,CAAC,CAAA;4BACF,IAAI,CAAC,YAAY,CAAC,UAAU,GAAG,MAAM,CAAA;4BACrC,MAAM,mBAAmB,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gCACxC,OAAO,CAAC,KAAK,CAAC,IAAA,cAAO,EAAC,GAAG,CAAC,CAAC,CAAA;4BAC7B,CAAC,CAAC,CAAA;wBACJ,CAAC;wBAAC,OAAO,CAAC,EAAE,CAAC;4BACX,MAAM,OAAO,CAAC,SAAS,CAAC;gCACtB,IAAI,EAAE,CAAC,CAAC,IAAI;gCACZ,EAAE,EAAE,CAAC,CAAC,EAAE;gCACR,MAAM,EACJ,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,IAAI,WAAW;oCACxC,CAAC,CAAC,UAAU;oCACZ,CAAC,CAAC,SAAS;gCACf,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE;6BAC5B,CAAC,CAAA;4BACF,IAAI,CAAC,YAAY,CAAC,UAAU,GAAG,SAAS,CAAA;wBAC1C,CAAC;oBACH,CAAC;gBACH,CAAC;;oBAAM,SAAS,GAAG,KAAK,CAAA;gBACxB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACtC,IAAI,KAAK,EAAE,CAAC;oBACV,IAAI,KAAK,CAAC,IAAI;wBAAE,MAAK;oBACrB,SAAS,GAAG,IAAI,CAAA;gBAClB,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,CAAC,EAAE,CAAC,OAAgB,EAAE,OAA0B;QACpD,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAC1C,CAAC;IACD,KAAK;QACH,IAAI,IAAI,CAAC,OAAO;YAAE,OAAM;QACxB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAA;IACpC,CAAC;IACD,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAM;QACzB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IACvB,CAAC;IACD,MAAM;QACJ,IAAI,CAAC,IAAI,EAAE,CAAA;IACb,CAAC;CACF;AAtGD,kCAsGC;AAED,SAAS,SAAS,CAAC,CAAU;IAC3B,IAAI,IAAA,mBAAM,EAAC,EAAE,OAAO,EAAE,oBAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IACvB,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI;QAAE,OAAO,IAAI,CAAA;IACrC,OAAO,KAAK,CAAA;AACd,CAAC"}
+{"version":3,"file":"HealthCheck.js","sourceRoot":"","sources":["../../../../package/lib/health/HealthCheck.ts"],"names":[],"mappings":"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"}

package/package/lib/health/checkFns/HealthCheckResult.d.ts

@@ -1,2 +1,8 @@
-import { T } from "../../../../base/lib";
-export type HealthCheckResult = Omit<T.NamedHealthCheckResult, "name">;
+import { T } from '../../../../base/lib';
+/**
+ * The result of a single health check invocation.
+ *
+ * Contains a `result` field ("success", "failure", or "starting") and an optional `message`.
+ * This is the unnamed variant -- the health check name is added by the framework.
+ */
+export type HealthCheckResult = Omit<T.NamedHealthCheckResult, 'name'>;

package/package/lib/health/checkFns/checkPortListening.d.ts

@@ -1,5 +1,5 @@
-import { Effects } from "../../../../base/lib/types";
-import { HealthCheckResult } from "./HealthCheckResult";
+import { Effects } from '../../../../base/lib/types';
+import { HealthCheckResult } from './HealthCheckResult';
 export declare function containsAddress(x: string, port: number, address?: bigint): boolean;
 /**
  * This is used to check if a port is listening on the system.

package/package/lib/health/checkFns/checkPortListening.js

@@ -41,10 +41,10 @@ const CP = __importStar(require("node:child_process"));
 const cpExec = (0, node_util_1.promisify)(CP.exec);
 function containsAddress(x, port, address) {
     const readPorts = x
-        .split("\n")
+        .split('\n')
         .filter(Boolean)
         .splice(1)
-        .map((x) => x.split(" ").filter(Boolean)[1]?.split(":"))
+        .map((x) => x.split(' ').filter(Boolean)[1]?.split(':'))
         .filter((x) => x?.length > 1)
         .map(([addr, p]) => [BigInt(`0x${addr}`), Number.parseInt(p, 16)]);
     return !!readPorts.find(([addr, p]) => (address === undefined || address === addr) && port === p);
@@ -58,19 +58,19 @@ async function checkPortListening(effects, port, options) {
         Promise.resolve().then(async () => {
             const hasAddress = containsAddress(await cpExec(`cat /proc/net/tcp`, {}).then(util_1.stringFromStdErrOut), port) ||
                 containsAddress(await cpExec(`cat /proc/net/tcp6`, {}).then(util_1.stringFromStdErrOut), port, BigInt(0)) ||
-                containsAddress(await cpExec("cat /proc/net/udp", {}).then(util_1.stringFromStdErrOut), port) ||
-                containsAddress(await cpExec("cat /proc/net/udp6", {}).then(util_1.stringFromStdErrOut), port, BigInt(0));
+                containsAddress(await cpExec('cat /proc/net/udp', {}).then(util_1.stringFromStdErrOut), port) ||
+                containsAddress(await cpExec('cat /proc/net/udp6', {}).then(util_1.stringFromStdErrOut), port, BigInt(0));
             if (hasAddress) {
-                return { result: "success", message: options.successMessage };
+                return { result: 'success', message: options.successMessage };
             }
             return {
-                result: "failure",
+                result: 'failure',
                 message: options.errorMessage,
             };
         }),
         new Promise((resolve) => {
             setTimeout(() => resolve({
-                result: "failure",
+                result: 'failure',
                 message: options.timeoutMessage || `Timeout trying to check port ${port}`,
             }), options.timeout ?? 1_000);
         }),

package/package/lib/health/checkFns/checkWebUrl.d.ts

@@ -1,6 +1,6 @@
-import { Effects } from "../../../../base/lib/types";
-import { HealthCheckResult } from "./HealthCheckResult";
-import "isomorphic-fetch";
+import { Effects } from '../../../../base/lib/types';
+import { HealthCheckResult } from './HealthCheckResult';
+import 'isomorphic-fetch';
 /**
  * This is a helper function to check if a web url is reachable.
  * @param url

package/package/lib/health/checkFns/checkWebUrl.js

@@ -13,14 +13,14 @@ require("isomorphic-fetch");
 const checkWebUrl = async (effects, url, { timeout = 1000, successMessage = `Reached ${url}`, errorMessage = `Error while fetching URL: ${url}`, } = {}) => {
     return Promise.race([fetch(url), (0, index_1.timeoutPromise)(timeout)])
         .then((x) => ({
-        result: "success",
+        result: 'success',
         message: successMessage,
     }))
         .catch((e) => {
         console.warn(`Error while fetching URL: ${url}`);
         console.error(JSON.stringify(e));
         console.error((0, util_1.asError)(e));
-        return { result: "failure", message: errorMessage };
+        return { result: 'failure', message: errorMessage };
     });
 };
 exports.checkWebUrl = checkWebUrl;

package/package/lib/health/checkFns/index.d.ts

@@ -1,7 +1,15 @@
-import { runHealthScript } from "./runHealthScript";
-export { checkPortListening } from "./checkPortListening";
-export { HealthCheckResult } from "./HealthCheckResult";
-export { checkWebUrl } from "./checkWebUrl";
+import { runHealthScript } from './runHealthScript';
+export { checkPortListening } from './checkPortListening';
+export { HealthCheckResult } from './HealthCheckResult';
+export { checkWebUrl } from './checkWebUrl';
+/**
+ * Create a promise that rejects after the specified timeout.
+ * Useful for racing against long-running health checks.
+ *
+ * @param ms - Timeout duration in milliseconds
+ * @param options.message - Custom error message (defaults to "Timed out")
+ * @returns A promise that never resolves, only rejects after the timeout
+ */
 export declare function timeoutPromise(ms: number, { message }?: {
     message?: string | undefined;
 }): Promise<never>;

package/package/lib/health/checkFns/index.js

@@ -8,7 +8,15 @@ var checkPortListening_1 = require("./checkPortListening");
 Object.defineProperty(exports, "checkPortListening", { enumerable: true, get: function () { return checkPortListening_1.checkPortListening; } });
 var checkWebUrl_1 = require("./checkWebUrl");
 Object.defineProperty(exports, "checkWebUrl", { enumerable: true, get: function () { return checkWebUrl_1.checkWebUrl; } });
-function timeoutPromise(ms, { message = "Timed out" } = {}) {
+/**
+ * Create a promise that rejects after the specified timeout.
+ * Useful for racing against long-running health checks.
+ *
+ * @param ms - Timeout duration in milliseconds
+ * @param options.message - Custom error message (defaults to "Timed out")
+ * @returns A promise that never resolves, only rejects after the timeout
+ */
+function timeoutPromise(ms, { message = 'Timed out' } = {}) {
     return new Promise((resolve, reject) => setTimeout(() => reject(new Error(message)), ms));
 }
 //# sourceMappingURL=index.js.map

package/package/lib/health/checkFns/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../package/lib/health/checkFns/index.ts"],"names":[],"mappings":";;;AAKA,wCAIC;AATD,uDAAmD;AAU1C,gGAVA,iCAAe,OAUA;AATxB,2DAAyD;AAAhD,wHAAA,kBAAkB,OAAA;AAE3B,6CAA2C;AAAlC,0GAAA,WAAW,OAAA;AAEpB,SAAgB,cAAc,CAAC,EAAU,EAAE,EAAE,OAAO,GAAG,WAAW,EAAE,GAAG,EAAE;IACvE,OAAO,IAAI,OAAO,CAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAC5C,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CACjD,CAAA;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../package/lib/health/checkFns/index.ts"],"names":[],"mappings":";;;AAaA,wCAIC;AAjBD,uDAAmD;AAkB1C,gGAlBA,iCAAe,OAkBA;AAjBxB,2DAAyD;AAAhD,wHAAA,kBAAkB,OAAA;AAE3B,6CAA2C;AAAlC,0GAAA,WAAW,OAAA;AAEpB;;;;;;;GAOG;AACH,SAAgB,cAAc,CAAC,EAAU,EAAE,EAAE,OAAO,GAAG,WAAW,EAAE,GAAG,EAAE;IACvE,OAAO,IAAI,OAAO,CAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAC5C,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CACjD,CAAA;AACH,CAAC"}

package/package/lib/health/checkFns/runHealthScript.d.ts

@@ -1,6 +1,6 @@
-import { HealthCheckResult } from "./HealthCheckResult";
-import { SubContainer } from "../../util/SubContainer";
-import { SDKManifest } from "../../types";
+import { HealthCheckResult } from './HealthCheckResult';
+import { SubContainer } from '../../util/SubContainer';
+import { SDKManifest } from '../../types';
 /**
  * Running a health script, is used when we want to have a simple
  * script in bash or something like that. It should return something that is useful

package/package/lib/health/checkFns/runHealthScript.js

@@ -11,16 +11,16 @@ const index_1 = require("./index");
  */
 const runHealthScript = async (runCommand, subcontainer, { timeout = 30000, errorMessage = `Error while running command: ${runCommand}`, message = (res) => `Have ran script ${runCommand} and the result: ${res}`, } = {}) => {
     const res = await Promise.race([
-        subcontainer.exec(runCommand),
+        subcontainer.execFail(runCommand),
         (0, index_1.timeoutPromise)(timeout),
     ]).catch((e) => {
         console.warn(errorMessage);
         console.warn(JSON.stringify(e));
         console.warn(e.toString());
-        throw { result: "failure", message: errorMessage };
+        throw { result: 'failure', message: errorMessage };
     });
     return {
-        result: "success",
+        result: 'success',
         message: message(res.stdout.toString()),
     };
 };

package/package/lib/health/checkFns/runHealthScript.js.map

@@ -1 +1 @@
-{"version":3,"file":"runHealthScript.js","sourceRoot":"","sources":["../../../../../package/lib/health/checkFns/runHealthScript.ts"],"names":[],"mappings":";;;AACA,mCAAwC;AAIxC;;;;;;GAMG;AACI,MAAM,eAAe,GAAG,KAAK,EAClC,UAAoB,EACpB,YAAoC,EACpC,EACE,OAAO,GAAG,KAAK,EACf,YAAY,GAAG,gCAAgC,UAAU,EAAE,EAC3D,OAAO,GAAG,CAAC,GAAW,EAAE,EAAE,CACxB,mBAAmB,UAAU,oBAAoB,GAAG,EAAE,MACtD,EAAE,EACsB,EAAE;IAC9B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;QAC7B,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC;QAC7B,IAAA,sBAAc,EAAC,OAAO,CAAC;KACxB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QACb,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAC1B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAA;QAC1B,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAuB,CAAA;IACzE,CAAC,CAAC,CAAA;IACF,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;KACnB,CAAA;AACxB,CAAC,CAAA;AAvBY,QAAA,eAAe,mBAuB3B"}
+{"version":3,"file":"runHealthScript.js","sourceRoot":"","sources":["../../../../../package/lib/health/checkFns/runHealthScript.ts"],"names":[],"mappings":";;;AACA,mCAAwC;AAIxC;;;;;;GAMG;AACI,MAAM,eAAe,GAAG,KAAK,EAClC,UAAoB,EACpB,YAAoC,EACpC,EACE,OAAO,GAAG,KAAK,EACf,YAAY,GAAG,gCAAgC,UAAU,EAAE,EAC3D,OAAO,GAAG,CAAC,GAAW,EAAE,EAAE,CACxB,mBAAmB,UAAU,oBAAoB,GAAG,EAAE,MACtD,EAAE,EACsB,EAAE;IAC9B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;QAC7B,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;QACjC,IAAA,sBAAc,EAAC,OAAO,CAAC;KACxB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QACb,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAC1B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAA;QAC1B,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAuB,CAAA;IACzE,CAAC,CAAC,CAAA;IACF,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;KACnB,CAAA;AACxB,CAAC,CAAA;AAvBY,QAAA,eAAe,mBAuB3B"}

package/package/lib/health/index.d.ts

@@ -1,2 +1,2 @@
-import "./checkFns";
-export { HealthCheck } from "./HealthCheck";
+import './checkFns';
+export { HealthCheck } from './HealthCheck';

package/package/lib/i18n/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Internationalization (i18n) utilities for StartOS packages.
+ *
+ * @example
+ * ```typescript
+ * // In package's i18n/index.ts:
+ * import { setupI18n } from '@start9labs/start-sdk'
+ * import defaultDict, { DEFAULT_LANG } from './dictionaries/default'
+ * import translations from './dictionaries/translations'
+ *
+ * export const i18n = setupI18n(defaultDict, translations, DEFAULT_LANG)
+ * ```
+ */
+type ParamValue = string | number | Date;
+/**
+ * Creates a typed i18n function for a package.
+ *
+ * @param defaultDict - The default language dictionary mapping strings to numeric indices
+ * @param translations - Translation dictionaries for each supported locale
+ * @param defaultLang - The default language code (e.g., 'en_US')
+ * @returns A typed i18n function that accepts dictionary keys and optional parameters
+ */
+export declare function setupI18n<Dict extends Record<string, number>, Translations extends Record<string, Record<number, string>>>(defaultDict: Dict, translations: Translations, defaultLang: string): (key: keyof Dict, params?: Record<string, ParamValue>) => string;
+export {};

package/package/lib/i18n/index.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * Internationalization (i18n) utilities for StartOS packages.
+ *
+ * @example
+ * ```typescript
+ * // In package's i18n/index.ts:
+ * import { setupI18n } from '@start9labs/start-sdk'
+ * import defaultDict, { DEFAULT_LANG } from './dictionaries/default'
+ * import translations from './dictionaries/translations'
+ *
+ * export const i18n = setupI18n(defaultDict, translations, DEFAULT_LANG)
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupI18n = setupI18n;
+/**
+ * Creates a typed i18n function for a package.
+ *
+ * @param defaultDict - The default language dictionary mapping strings to numeric indices
+ * @param translations - Translation dictionaries for each supported locale
+ * @param defaultLang - The default language code (e.g., 'en_US')
+ * @returns A typed i18n function that accepts dictionary keys and optional parameters
+ */
+function setupI18n(defaultDict, translations, defaultLang) {
+    const lang = process.env.LANG?.replace(/\.UTF-8$/, '') || defaultLang;
+    // Convert locale format from en_US to en-US for Intl APIs
+    const intlLocale = lang.replace('_', '-');
+    function getTranslation() {
+        if (lang === defaultLang)
+            return null;
+        const availableLangs = Object.keys(translations);
+        const match = availableLangs.find((l) => l === lang) ??
+            availableLangs.find((l) => String(l).startsWith(lang.split('_')[0] + '_'));
+        return match ? translations[match] : null;
+    }
+    const translation = getTranslation();
+    function formatValue(value) {
+        if (typeof value === 'number') {
+            return new Intl.NumberFormat(intlLocale).format(value);
+        }
+        if (value instanceof Date) {
+            return new Intl.DateTimeFormat(intlLocale).format(value);
+        }
+        return value;
+    }
+    return function i18n(key, params) {
+        let result = translation
+            ? translation[defaultDict[key]]
+            : key;
+        if (params) {
+            for (const [paramName, value] of Object.entries(params)) {
+                result = result.replace(`\${${paramName}}`, formatValue(value));
+            }
+        }
+        return result;
+    };
+}
+//# sourceMappingURL=index.js.map

package/package/lib/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../package/lib/i18n/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AAYH,8BAiDC;AAzDD;;;;;;;GAOG;AACH,SAAgB,SAAS,CAGvB,WAAiB,EAAE,YAA0B,EAAE,WAAmB;IAClE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,WAAW,CAAA;IAErE,0DAA0D;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAEzC,SAAS,cAAc;QACrB,IAAI,IAAI,KAAK,WAAW;YAAE,OAAO,IAAI,CAAA;QAErC,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAA2B,CAAA;QAE1E,MAAM,KAAK,GACT,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;YACtC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;QAE5E,OAAO,KAAK,CAAC,CAAC,CAAE,YAAY,CAAC,KAAK,CAA4B,CAAC,CAAC,CAAC,IAAI,CAAA;IACvE,CAAC;IAED,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;IAEpC,SAAS,WAAW,CAAC,KAAiB;QACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACxD,CAAC;QACD,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;YAC1B,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC1D,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,OAAO,SAAS,IAAI,CAClB,GAAe,EACf,MAAmC;QAEnC,IAAI,MAAM,GAAG,WAAW;YACtB,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,GAAa,CAAC,CAAC;YACzC,CAAC,CAAE,GAAc,CAAA;QAEnB,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,SAAS,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAA;YACjE,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;AACH,CAAC"}

package/package/lib/index.d.ts

@@ -1,23 +1,21 @@
-import { S9pk, Version, VersionRange, ExtendedVersion, inputSpec, ISB, IST, types, matches, utils } from "../../base/lib";
-export { S9pk, Version, VersionRange, ExtendedVersion, inputSpec, ISB, IST, types, matches, utils, };
-export * as T from "./types";
-export { Daemons } from "./mainFn/Daemons";
-export { SubContainer } from "./util/SubContainer";
-export { StartSdk } from "./StartSdk";
-export { setupManifest, buildManifest } from "./manifest/setupManifest";
-export { FileHelper } from "./util/fileHelper";
-export { setupExposeStore } from "./store/setupExposeStore";
-export { pathBuilder } from "../../base/lib/util/PathBuilder";
-export * as actions from "../../base/lib/actions";
-export * as backup from "./backup";
-export * as daemons from "./mainFn/Daemons";
-export * as health from "./health";
-export * as healthFns from "./health/checkFns";
-export * as inits from "./inits";
-export * as mainFn from "./mainFn";
-export * as toml from "@iarna/toml";
-export * as yaml from "yaml";
-export * as startSdk from "./StartSdk";
-export * as YAML from "yaml";
-export * as TOML from "@iarna/toml";
-export * from "./version";
+import { S9pk, Version, VersionRange, ExtendedVersion, inputSpec, ISB, IST, types, z, utils } from '../../base/lib';
+export { S9pk, Version, VersionRange, ExtendedVersion, inputSpec, ISB, IST, types, z, utils, };
+export { setupI18n } from './i18n';
+export * as T from './types';
+export { Daemons } from './mainFn/Daemons';
+export { SubContainer } from './util/SubContainer';
+export { StartSdk } from './StartSdk';
+export { setupManifest, buildManifest } from './manifest/setupManifest';
+export { FileHelper } from './util/fileHelper';
+export * as actions from '../../base/lib/actions';
+export * as backup from './backup';
+export * as daemons from './mainFn/Daemons';
+export * as health from './health';
+export * as healthFns from './health/checkFns';
+export * as mainFn from './mainFn';
+export * as toml from '@iarna/toml';
+export * as yaml from 'yaml';
+export * as startSdk from './StartSdk';
+export * as YAML from 'yaml';
+export * as TOML from '@iarna/toml';
+export * from './version';

package/package/lib/index.js

@@ -36,7 +36,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOML = exports.YAML = exports.startSdk = exports.yaml = exports.toml = exports.mainFn = exports.inits = exports.healthFns = exports.health = exports.daemons = exports.backup = exports.actions = exports.pathBuilder = exports.setupExposeStore = exports.FileHelper = exports.buildManifest = exports.setupManifest = exports.StartSdk = exports.SubContainer = exports.Daemons = exports.T = exports.utils = exports.matches = exports.types = exports.IST = exports.ISB = exports.inputSpec = exports.ExtendedVersion = exports.VersionRange = exports.Version = exports.S9pk = void 0;
+exports.TOML = exports.YAML = exports.startSdk = exports.yaml = exports.toml = exports.mainFn = exports.healthFns = exports.health = exports.daemons = exports.backup = exports.actions = exports.FileHelper = exports.buildManifest = exports.setupManifest = exports.StartSdk = exports.Daemons = exports.T = exports.setupI18n = exports.utils = exports.z = exports.types = exports.IST = exports.ISB = exports.inputSpec = exports.ExtendedVersion = exports.VersionRange = exports.Version = exports.S9pk = void 0;
 const lib_1 = require("../../base/lib");
 Object.defineProperty(exports, "S9pk", { enumerable: true, get: function () { return lib_1.S9pk; } });
 Object.defineProperty(exports, "Version", { enumerable: true, get: function () { return lib_1.Version; } });
@@ -46,13 +46,13 @@ Object.defineProperty(exports, "inputSpec", { enumerable: true, get: function ()
 Object.defineProperty(exports, "ISB", { enumerable: true, get: function () { return lib_1.ISB; } });
 Object.defineProperty(exports, "IST", { enumerable: true, get: function () { return lib_1.IST; } });
 Object.defineProperty(exports, "types", { enumerable: true, get: function () { return lib_1.types; } });
-Object.defineProperty(exports, "matches", { enumerable: true, get: function () { return lib_1.matches; } });
+Object.defineProperty(exports, "z", { enumerable: true, get: function () { return lib_1.z; } });
 Object.defineProperty(exports, "utils", { enumerable: true, get: function () { return lib_1.utils; } });
+var i18n_1 = require("./i18n");
+Object.defineProperty(exports, "setupI18n", { enumerable: true, get: function () { return i18n_1.setupI18n; } });
 exports.T = __importStar(require("./types"));
 var Daemons_1 = require("./mainFn/Daemons");
 Object.defineProperty(exports, "Daemons", { enumerable: true, get: function () { return Daemons_1.Daemons; } });
-var SubContainer_1 = require("./util/SubContainer");
-Object.defineProperty(exports, "SubContainer", { enumerable: true, get: function () { return SubContainer_1.SubContainer; } });
 var StartSdk_1 = require("./StartSdk");
 Object.defineProperty(exports, "StartSdk", { enumerable: true, get: function () { return StartSdk_1.StartSdk; } });
 var setupManifest_1 = require("./manifest/setupManifest");
@@ -60,16 +60,11 @@ Object.defineProperty(exports, "setupManifest", { enumerable: true, get: functio
 Object.defineProperty(exports, "buildManifest", { enumerable: true, get: function () { return setupManifest_1.buildManifest; } });
 var fileHelper_1 = require("./util/fileHelper");
 Object.defineProperty(exports, "FileHelper", { enumerable: true, get: function () { return fileHelper_1.FileHelper; } });
-var setupExposeStore_1 = require("./store/setupExposeStore");
-Object.defineProperty(exports, "setupExposeStore", { enumerable: true, get: function () { return setupExposeStore_1.setupExposeStore; } });
-var PathBuilder_1 = require("../../base/lib/util/PathBuilder");
-Object.defineProperty(exports, "pathBuilder", { enumerable: true, get: function () { return PathBuilder_1.pathBuilder; } });
 exports.actions = __importStar(require("../../base/lib/actions"));
 exports.backup = __importStar(require("./backup"));
 exports.daemons = __importStar(require("./mainFn/Daemons"));
 exports.health = __importStar(require("./health"));
 exports.healthFns = __importStar(require("./health/checkFns"));
-exports.inits = __importStar(require("./inits"));
 exports.mainFn = __importStar(require("./mainFn"));
 exports.toml = __importStar(require("@iarna/toml"));
 exports.yaml = __importStar(require("yaml"));

package/package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../package/lib/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wCAWuB;AAGrB,qFAbA,UAAI,OAaA;AACJ,wFAbA,aAAO,OAaA;AACP,6FAbA,kBAAY,OAaA;AACZ,gGAbA,qBAAe,OAaA;AACf,0FAbA,eAAS,OAaA;AACT,oFAbA,SAAG,OAaA;AACH,oFAbA,SAAG,OAaA;AACH,sFAbA,WAAK,OAaA;AACL,wFAbA,aAAO,OAaA;AACP,sFAbA,WAAK,OAaA;AAEP,6CAA4B;AAC5B,4CAA0C;AAAjC,kGAAA,OAAO,OAAA;AAChB,oDAAkD;AAAzC,4GAAA,YAAY,OAAA;AACrB,uCAAqC;AAA5B,oGAAA,QAAQ,OAAA;AACjB,0DAAuE;AAA9D,8GAAA,aAAa,OAAA;AAAE,8GAAA,aAAa,OAAA;AACrC,gDAA8C;AAArC,wGAAA,UAAU,OAAA;AACnB,6DAA2D;AAAlD,oHAAA,gBAAgB,OAAA;AACzB,+DAA6D;AAApD,0GAAA,WAAW,OAAA;AAEpB,kEAAiD;AACjD,mDAAkC;AAClC,4DAA2C;AAC3C,mDAAkC;AAClC,+DAA8C;AAC9C,iDAAgC;AAChC,mDAAkC;AAClC,oDAAmC;AACnC,6CAA4B;AAC5B,uDAAsC;AACtC,6CAA4B;AAC5B,oDAAmC;AACnC,4CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../package/lib/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wCAWuB;AAGrB,qFAbA,UAAI,OAaA;AACJ,wFAbA,aAAO,OAaA;AACP,6FAbA,kBAAY,OAaA;AACZ,gGAbA,qBAAe,OAaA;AACf,0FAbA,eAAS,OAaA;AACT,oFAbA,SAAG,OAaA;AACH,oFAbA,SAAG,OAaA;AACH,sFAbA,WAAK,OAaA;AACL,kFAbA,OAAC,OAaA;AACD,sFAbA,WAAK,OAaA;AAEP,+BAAkC;AAAzB,iGAAA,SAAS,OAAA;AAClB,6CAA4B;AAC5B,4CAA0C;AAAjC,kGAAA,OAAO,OAAA;AAEhB,uCAAqC;AAA5B,oGAAA,QAAQ,OAAA;AACjB,0DAAuE;AAA9D,8GAAA,aAAa,OAAA;AAAE,8GAAA,aAAa,OAAA;AACrC,gDAA8C;AAArC,wGAAA,UAAU,OAAA;AAEnB,kEAAiD;AACjD,mDAAkC;AAClC,4DAA2C;AAC3C,mDAAkC;AAClC,+DAA8C;AAC9C,mDAAkC;AAClC,oDAAmC;AACnC,6CAA4B;AAC5B,uDAAsC;AACtC,6CAA4B;AAC5B,oDAAmC;AACnC,4CAAyB"}

package/package/lib/mainFn/CommandController.d.ts

@@ -1,28 +1,47 @@
-import * as T from "../../../base/lib/types";
-import { SubContainerHandle, SubContainer } from "../util/SubContainer";
-import { Drop } from "../util";
-export declare class CommandController<Manifest extends T.SDKManifest> extends Drop {
-    readonly runningAnswer: Promise<unknown>;
+import * as T from '../../../base/lib/types';
+import { SubContainer } from '../util/SubContainer';
+import { Drop } from '../util';
+import { DaemonCommandType } from './Daemons';
+/**
+ * Low-level controller for a single running process inside a subcontainer (or as a JS function).
+ *
+ * Manages the child process lifecycle: spawning, waiting, and signal-based termination.
+ * Used internally by {@link Daemon} to manage individual command executions.
+ *
+ * @typeParam Manifest - The service manifest type
+ * @typeParam C - The subcontainer type, or `null` for JS-only commands
+ */
+export declare class CommandController<Manifest extends T.SDKManifest, C extends SubContainer<Manifest> | null> extends Drop {
+    readonly runningAnswer: Promise<null>;
     private state;
     private readonly subcontainer;
     private process;
     readonly sigtermTimeout: number;
     private constructor();
-    static of<Manifest extends T.SDKManifest>(): (effects: T.Effects, subcontainer: SubContainer<Manifest>, command: T.CommandType, options: {
-        sigtermTimeout?: number;
-        runAsInit?: boolean;
-        env?: {
-            [variable: string]: string;
-        } | undefined;
-        cwd?: string | undefined;
-        user?: string | undefined;
-        onStdout?: (chunk: Buffer | string | any) => void;
-        onStderr?: (chunk: Buffer | string | any) => void;
-    }) => Promise<CommandController<Manifest>>;
-    get subContainerHandle(): SubContainerHandle;
+    /**
+     * Factory method to create a new CommandController.
+     *
+     * Returns a curried async function: `(effects, subcontainer, exec) => CommandController`.
+     * If the exec spec has an `fn` property, runs the function; otherwise spawns a shell command
+     * in the subcontainer.
+     */
+    static of<Manifest extends T.SDKManifest, C extends SubContainer<Manifest> | null>(): (effects: T.Effects, subcontainer: C, exec: DaemonCommandType<Manifest, C>) => Promise<CommandController<Manifest, C>>;
+    /**
+     * Wait for the command to finish. Optionally terminate after a timeout.
+     * @param options.timeout - Milliseconds to wait before terminating. Defaults to no timeout.
+     */
     wait({ timeout }?: {
         timeout?: number | undefined;
-    }): Promise<unknown>;
+    }): Promise<void>;
+    /**
+     * Terminate the running command by sending a signal.
+     *
+     * Sends the specified signal (default: SIGTERM), then escalates to SIGKILL
+     * after the timeout expires. Destroys the subcontainer after the process exits.
+     *
+     * @param options.signal - The signal to send (default: SIGTERM)
+     * @param options.timeout - Milliseconds before escalating to SIGKILL
+     */
     term({ signal, timeout }?: {
         signal?: NodeJS.Signals | undefined;
         timeout?: number | undefined;