@arkstack/common 0.18.7 → 0.18.9

package/dist/faker.js

@@ -1,4 +1,4 @@
-import { g as configLoader } from "./system-Die_Dv5y.js";
+import { g as configLoader } from "./system-BH1phDBR.js";
 import * as fakerLocales from "@faker-js/faker";
 import { Faker } from "@faker-js/faker";
 import { pictwoImage } from "@pictwo/faker";

package/dist/{helpers-Bn-0uv3R.d.ts → helpers-DgIgQLDu.d.ts}

@@ -388,6 +388,10 @@ interface PublishConfirmation {
    */
   callback?: (choice: Choice<string>['value'], stub: string) => string | Promise<string>;
 }
+type Concrete<T extends abstract new (...args: any[]) => any> = Omit<T, 'prototype'> & {
+  new (...args: ConstructorParameters<T>): InstanceType<T>;
+  prototype: InstanceType<T>;
+};
 //#endregion
 //#region src/utils/encryption.d.ts
 /**
@@ -680,4 +684,4 @@ declare const abortIf: <T>(boolean: T, message?: string, code?: number) => asser
  */
 declare const assertFound: <T>(value: T | null | undefined, message: string, code?: number) => asserts value is T;
 //#endregion
-export { IHook as $, SerializedKeyPair as A, EnvKey as B, FingerprintOptions as C, NodeCipher as D, Keys as E, Choices as F, GlobalConfig as G, EnvRegistry as H, ConfigRegistry as I, HookFor as J, GlobalEnv as K, ConfigShape as L, ArkstackErrorPayload as M, ArkstackErrorShape as N, SealedBox as O, Choice as P, HookRegistry as Q, DotPath as R, EncryptionKey as S, KeyPair as T, EnvReturn as U, EnvLookup as V, FileImporter as W, HookPos as X, HookName as Y, HookPositions as Z, CipherOptions as _, abortIf as a, Primitive as at, DerivedKey as b, getModelSync as c, PublishFilter as ct, normalizePositiveInteger as d, Logger as dt, LoggerChalk as et, perPage as f, Cipher as g, ChannelOptions as h, abort as i, PaginationOptions as it, AppConfig as j, SecureChannel as k, initializeGlobalContext as l, PublishGroup as lt, Hash as m, ModelConstructor as n, LoggerParseSignature as nt, assertFound as o, PublishConfirmation as ot, resolvePagination as p, HookArgs as q, ModelRegistry as r, MergedConfig as rt, getModel$1 as s, PublishEntry as st, AbstractModelConstructor as t, LoggerLog as tt, isClass as u, UnionToIntersection as ut, Codec as v, KeyInput as w, Encryption as x, DeriveOptions as y, DotPathValue as z };
+export { HookRegistry as $, SerializedKeyPair as A, DotPathValue as B, FingerprintOptions as C, NodeCipher as D, Keys as E, Choices as F, FileImporter as G, EnvLookup as H, Concrete as I, HookArgs as J, GlobalConfig as K, ConfigRegistry as L, ArkstackErrorPayload as M, ArkstackErrorShape as N, SealedBox as O, Choice as P, HookPositions as Q, ConfigShape as R, EncryptionKey as S, KeyPair as T, EnvRegistry as U, EnvKey as V, EnvReturn as W, HookName as X, HookFor as Y, HookPos as Z, CipherOptions as _, abortIf as a, PaginationOptions as at, DerivedKey as b, getModelSync as c, PublishEntry as ct, normalizePositiveInteger as d, UnionToIntersection as dt, IHook as et, perPage as f, Logger as ft, Cipher as g, ChannelOptions as h, abort as i, MergedConfig as it, AppConfig as j, SecureChannel as k, initializeGlobalContext as l, PublishFilter as lt, Hash as m, ModelConstructor as n, LoggerLog as nt, assertFound as o, Primitive as ot, resolvePagination as p, GlobalEnv as q, ModelRegistry as r, LoggerParseSignature as rt, getModel$1 as s, PublishConfirmation as st, AbstractModelConstructor as t, LoggerChalk as tt, isClass as u, PublishGroup as ut, Codec as v, KeyInput as w, Encryption as x, DeriveOptions as y, DotPath as z };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /// <reference path="./app.d.ts" />
-import { $ as IHook, A as SerializedKeyPair, B as EnvKey, C as FingerprintOptions, D as NodeCipher, E as Keys, F as Choices, G as GlobalConfig, H as EnvRegistry, I as ConfigRegistry, J as HookFor, K as GlobalEnv, L as ConfigShape, M as ArkstackErrorPayload, N as ArkstackErrorShape, O as SealedBox, P as Choice, Q as HookRegistry, R as DotPath, S as EncryptionKey, T as KeyPair, U as EnvReturn, V as EnvLookup, W as FileImporter, X as HookPos, Y as HookName, Z as HookPositions, _ as CipherOptions, a as abortIf, at as Primitive, b as DerivedKey, c as getModelSync, ct as PublishFilter, d as normalizePositiveInteger, dt as Logger, et as LoggerChalk, f as perPage, g as Cipher, h as ChannelOptions, i as abort, it as PaginationOptions, j as AppConfig, k as SecureChannel, l as initializeGlobalContext, lt as PublishGroup, m as Hash, n as ModelConstructor, nt as LoggerParseSignature, o as assertFound, ot as PublishConfirmation, p as resolvePagination, q as HookArgs, r as ModelRegistry, rt as MergedConfig, s as getModel, st as PublishEntry, t as AbstractModelConstructor, tt as LoggerLog, u as isClass, ut as UnionToIntersection, v as Codec, w as KeyInput, x as Encryption, y as DeriveOptions, z as DotPathValue } from "./helpers-Bn-0uv3R.js";
+import { $ as HookRegistry, A as SerializedKeyPair, B as DotPathValue, C as FingerprintOptions, D as NodeCipher, E as Keys, F as Choices, G as FileImporter, H as EnvLookup, I as Concrete, J as HookArgs, K as GlobalConfig, L as ConfigRegistry, M as ArkstackErrorPayload, N as ArkstackErrorShape, O as SealedBox, P as Choice, Q as HookPositions, R as ConfigShape, S as EncryptionKey, T as KeyPair, U as EnvRegistry, V as EnvKey, W as EnvReturn, X as HookName, Y as HookFor, Z as HookPos, _ as CipherOptions, a as abortIf, at as PaginationOptions, b as DerivedKey, c as getModelSync, ct as PublishEntry, d as normalizePositiveInteger, dt as UnionToIntersection, et as IHook, f as perPage, ft as Logger, g as Cipher, h as ChannelOptions, i as abort, it as MergedConfig, j as AppConfig, k as SecureChannel, l as initializeGlobalContext, lt as PublishFilter, m as Hash, n as ModelConstructor, nt as LoggerLog, o as assertFound, ot as Primitive, p as resolvePagination, q as GlobalEnv, r as ModelRegistry, rt as LoggerParseSignature, s as getModel, st as PublishConfirmation, t as AbstractModelConstructor, tt as LoggerChalk, u as isClass, ut as PublishGroup, v as Codec, w as KeyInput, x as Encryption, y as DeriveOptions, z as DotPath } from "./helpers-DgIgQLDu.js";
 import { Arkstack } from "@arkstack/contract";
 import { ForkOptions } from "node:child_process";
 import pino from "pino";
@@ -407,10 +407,29 @@ declare class EnvLoader {
    * Read an environment variable, coercing booleans, numbers and `null`, and
    * falling back to `defaultValue` when it is unset.
    *
+   * A value is only read as a number when the number says exactly what was
+   * written. See {@link isExactNumber}.
+   *
    * @param name          The variable name.
    * @param defaultValue  Returned when the variable is unset.
    */
   get<X = never, D = undefined, K extends string = string>(name: K, defaultValue?: D): EnvReturn<X, K, D>;
+  /**
+   * Whether a number would say exactly what the variable says.
+   *
+   * `Number()` accepts far more than decimal digits: hexadecimal, binary and
+   * octal literals, exponents, surrounding whitespace, and integers wider
+   * than a double can hold. Coercing those loses information silently, and
+   * the values that look like numbers by accident tend to be the ones where
+   * that matters most - a 32-byte key beginning `0x` becomes a float that
+   * keeps roughly its first thirteen digits, and nothing downstream can tell
+   * that it happened.
+   *
+   * Converting back and comparing is the whole test: `'6379'` survives it,
+   * `'0x1f'`, `'007'`, `'1e5'` and `'12345678901234567890'` do not, and so
+   * they stay the strings they were written as.
+   */
+  private isExactNumber;
 }
 /**
  * Shared environment loader backing {@link env}.
@@ -514,4 +533,4 @@ declare const devServer: (options: DevServerRunnerOptions) => {
   closeWatcher(): Promise<void>;
 };
 //#endregion
-export { AbstractModelConstructor, AppConfig, AppException, ArkstackErrorPayload, ArkstackErrorShape, CONFIG_KEY, type ChannelOptions, Choice, Choices, Cipher, type CipherOptions, Codec, ConfigLoader, ConfigRegistry, ConfigShape, type DeriveOptions, type DerivedKey, DevServerRunnerOptions, DotPath, DotPathValue, Encryption, EncryptionKey, EnvKey, EnvLoader, EnvLookup, EnvRegistry, EnvReturn, ErrorHandler, Exception, FileImporter, type FingerprintOptions, GlobalConfig, GlobalEnv, Hash, Hook, HookArgs, HookFor, HookName, HookPos, HookPositions, HookRegistry, IHook, type KeyInput, KeyPair, Keys, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, MergedConfig, ModelConstructor, ModelRegistry, NodeCipher, PaginationOptions, Primitive, PublishConfirmation, PublishEntry, PublishFilter, PublishGroup, Publisher, RequestException, SealedBox, SecureChannel, type SerializedKeyPair, 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 };
+export { AbstractModelConstructor, AppConfig, AppException, ArkstackErrorPayload, ArkstackErrorShape, CONFIG_KEY, type ChannelOptions, Choice, Choices, Cipher, type CipherOptions, Codec, Concrete, ConfigLoader, ConfigRegistry, ConfigShape, type DeriveOptions, type DerivedKey, DevServerRunnerOptions, DotPath, DotPathValue, Encryption, EncryptionKey, EnvKey, EnvLoader, EnvLookup, EnvRegistry, EnvReturn, ErrorHandler, Exception, FileImporter, type FingerprintOptions, GlobalConfig, GlobalEnv, Hash, Hook, HookArgs, HookFor, HookName, HookPos, HookPositions, HookRegistry, IHook, type KeyInput, KeyPair, Keys, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, MergedConfig, ModelConstructor, ModelRegistry, NodeCipher, PaginationOptions, Primitive, PublishConfirmation, PublishEntry, PublishFilter, PublishGroup, Publisher, RequestException, SealedBox, SecureChannel, type SerializedKeyPair, 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

@@ -1,5 +1,5 @@
-import { _ as EnvLoader, a as env, c as nodeEnv, d as resolveRuntimeDir, f as resolveRuntimeModule, g as configLoader, h as ConfigLoader, i as discoverCommands, l as outputDir, m as CONFIG_KEY, n as appUrl, o as importFile, p as toOutputPath, r as config, s as interopDefault, t as appKey, u as rebuildOutput, v as envLoader } from "./system-Die_Dv5y.js";
-import { C as Encryption, D as NodeCipher, E as Keys, O as SealedBox, S as Codec, T as KeyPair, _ as RequestException, b as Hash, c as abortIf, d as getModelSync, f as initializeGlobalContext, g as resolvePagination, h as perPage, k as SecureChannel, l as assertFound, m as normalizePositiveInteger, p as isClass, s as abort, u as getModel, v as AppException, w as EncryptionKey, x as Cipher, y as Exception } from "./utils-gKiLoXG9.js";
+import { _ as EnvLoader, a as env, c as nodeEnv, d as resolveRuntimeDir, f as resolveRuntimeModule, g as configLoader, h as ConfigLoader, i as discoverCommands, l as outputDir, m as CONFIG_KEY, n as appUrl, o as importFile, p as toOutputPath, r as config, s as interopDefault, t as appKey, u as rebuildOutput, v as envLoader } from "./system-BH1phDBR.js";
+import { C as Encryption, D as NodeCipher, E as Keys, O as SealedBox, S as Codec, T as KeyPair, _ as RequestException, b as Hash, c as abortIf, d as getModelSync, f as initializeGlobalContext, g as resolvePagination, h as perPage, k as SecureChannel, l as assertFound, m as normalizePositiveInteger, p as isClass, s as abort, u as getModel, v as AppException, w as EncryptionKey, x as Cipher, y as Exception } from "./utils-4xEVrT0Z.js";
 import { Hook as Hook$1 } from "@arkstack/foundry";
 import { Arkstack } from "@arkstack/contract";
 import { str } from "@h3ravel/support";

package/dist/{system-Die_Dv5y.js → system-BH1phDBR.js}

@@ -42,6 +42,9 @@ var EnvLoader = class {
 	* Read an environment variable, coercing booleans, numbers and `null`, and
 	* falling back to `defaultValue` when it is unset.
 	*
+	* A value is only read as a number when the number says exactly what was
+	* written. See {@link isExactNumber}.
+	*
 	* @param name          The variable name.
 	* @param defaultValue  Returned when the variable is unset.
 	*/
@@ -60,12 +63,31 @@ var EnvLoader = class {
 			"true",
 			"on"
 		].includes(val);
-		if (!isNaN(Number(val)) && typeof val !== "boolean" && typeof val !== "undefined" && val !== "") val = Number(val);
+		if (typeof val === "string" && this.isExactNumber(val)) val = Number(val);
 		if (val === "") val = void 0;
 		if (val === "null") val = null;
 		val ??= defaultValue;
 		return val;
 	}
+	/**
+	* Whether a number would say exactly what the variable says.
+	*
+	* `Number()` accepts far more than decimal digits: hexadecimal, binary and
+	* octal literals, exponents, surrounding whitespace, and integers wider
+	* than a double can hold. Coercing those loses information silently, and
+	* the values that look like numbers by accident tend to be the ones where
+	* that matters most - a 32-byte key beginning `0x` becomes a float that
+	* keeps roughly its first thirteen digits, and nothing downstream can tell
+	* that it happened.
+	*
+	* Converting back and comparing is the whole test: `'6379'` survives it,
+	* `'0x1f'`, `'007'`, `'1e5'` and `'12345678901234567890'` do not, and so
+	* they stay the strings they were written as.
+	*/
+	isExactNumber(value) {
+		const parsed = Number(value);
+		return Number.isFinite(parsed) && String(parsed) === value;
+	}
 };
 /** 
 * Shared environment loader backing {@link env}.

package/dist/utils/index.d.ts

@@ -1,4 +1,4 @@
-import { A as SerializedKeyPair, C as FingerprintOptions, D as NodeCipher, E as Keys, O as SealedBox, S as EncryptionKey, T as KeyPair, _ as CipherOptions, a as abortIf, b as DerivedKey, c as getModelSync, d as normalizePositiveInteger, f as perPage, g as Cipher, h as ChannelOptions, i as abort, k as SecureChannel, l as initializeGlobalContext, m as Hash, n as ModelConstructor, o as assertFound, p as resolvePagination, r as ModelRegistry, s as getModel, t as AbstractModelConstructor, u as isClass, v as Codec, w as KeyInput, x as Encryption, y as DeriveOptions } from "../helpers-Bn-0uv3R.js";
+import { A as SerializedKeyPair, C as FingerprintOptions, D as NodeCipher, E as Keys, O as SealedBox, S as EncryptionKey, T as KeyPair, _ as CipherOptions, a as abortIf, b as DerivedKey, c as getModelSync, d as normalizePositiveInteger, f as perPage, g as Cipher, h as ChannelOptions, i as abort, k as SecureChannel, l as initializeGlobalContext, m as Hash, n as ModelConstructor, o as assertFound, p as resolvePagination, r as ModelRegistry, s as getModel, t as AbstractModelConstructor, u as isClass, v as Codec, w as KeyInput, x as Encryption, y as DeriveOptions } from "../helpers-DgIgQLDu.js";
 import { Model } from "arkormx";
 //#region src/utils/traits.d.ts
 declare const crc32: (str: string) => number;

package/dist/utils/index.js

@@ -1,2 +1,2 @@
-import { C as Encryption, D as NodeCipher, E as Keys, O as SealedBox, S as Codec, T as KeyPair, a as use, b as Hash, c as abortIf, d as getModelSync, f as initializeGlobalContext, g as resolvePagination, h as perPage, i as trait, k as SecureChannel, l as assertFound, m as normalizePositiveInteger, n as crc32, o as uses, p as isClass, r as getTraitMethods, s as abort, t as callTraitMethods, u as getModel, w as EncryptionKey, x as Cipher } from "../utils-gKiLoXG9.js";
+import { C as Encryption, D as NodeCipher, E as Keys, O as SealedBox, S as Codec, T as KeyPair, a as use, b as Hash, c as abortIf, d as getModelSync, f as initializeGlobalContext, g as resolvePagination, h as perPage, i as trait, k as SecureChannel, l as assertFound, m as normalizePositiveInteger, n as crc32, o as uses, p as isClass, r as getTraitMethods, s as abort, t as callTraitMethods, u as getModel, w as EncryptionKey, x as Cipher } from "../utils-4xEVrT0Z.js";
 export { Cipher, Codec, Encryption, EncryptionKey, Hash, KeyPair, Keys, NodeCipher, SealedBox, SecureChannel, abort, abortIf, assertFound, callTraitMethods, crc32, getModel, getModelSync, getTraitMethods, initializeGlobalContext, isClass, normalizePositiveInteger, perPage, resolvePagination, trait, use, uses };

package/dist/{utils-gKiLoXG9.js → utils-4xEVrT0Z.js}

@@ -1,4 +1,4 @@
-import { a as env, t as appKey } from "./system-Die_Dv5y.js";
+import { a as env, t as appKey } from "./system-BH1phDBR.js";
 import { Cipher, Codec, EncryptionKey, KeyPair, Keys, SealedBox, SecureChannel } from "@arkstack/encryption";
 import { NodeCipher } from "@arkstack/encryption/node";
 import { Secret, TOTP } from "otpauth";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkstack/common",
-  "version": "0.18.7",
+  "version": "0.18.9",
   "type": "module",
   "description": "Core utilities, primitives, and shared infrastructure for the Arkstack ecosystem.",
   "homepage": "https://arkstack.toneflix.net",
@@ -43,13 +43,13 @@
     "otpauth": "^9.5.1",
     "pino": "^10.3.1",
     "selfsigned": "^2.4.1",
-    "@arkstack/encryption": "^0.18.7"
+    "@arkstack/encryption": "^0.18.9"
   },
   "peerDependencies": {
     "@h3ravel/support": "^2.2.7",
     "arkormx": "^2.12.8",
-    "@arkstack/contract": "^0.18.7",
-    "@arkstack/foundry": "^0.18.7"
+    "@arkstack/contract": "^0.18.9",
+    "@arkstack/foundry": "^0.18.9"
   },
   "optionalDependencies": {
     "@faker-js/faker": "^10.4.0"