ysk-server-shared 1.0.0

package/dist/i18n/request-locale.js

@@ -0,0 +1,42 @@
+/**
+ * Request-scoped locale (AsyncLocalStorage).
+ * HTTP sets this per request; CLI sets once at process start.
+ * Core may call `tl(key)` without threading locale through every call.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { DEFAULT_LOCALE, localeFromAcceptLanguage, normalizeLocale, } from './normalize-locale.js';
+import { t } from './t.js';
+const als = new AsyncLocalStorage();
+/** Current locale, or DEFAULT_LOCALE outside a runWithLocale scope. */
+export function getLocale() {
+    return als.getStore() ?? DEFAULT_LOCALE;
+}
+/** Run `fn` with a fixed locale (HTTP request / CLI session). */
+export function runWithLocale(locale, fn) {
+    return als.run(normalizeLocale(locale), fn);
+}
+export async function runWithLocaleAsync(locale, fn) {
+    return als.run(normalizeLocale(locale), fn);
+}
+/**
+ * Resolve locale for an HTTP request.
+ * Priority: explicit user.locale → Accept-Language → default.
+ */
+export function resolveRequestLocale(input) {
+    if (input.userLocale)
+        return normalizeLocale(input.userLocale);
+    if (input.queryLocale)
+        return normalizeLocale(input.queryLocale);
+    if (input.acceptLanguage)
+        return localeFromAcceptLanguage(input.acceptLanguage);
+    return DEFAULT_LOCALE;
+}
+/** Translate with request locale (or default). */
+export function tl(key, params) {
+    return t(getLocale(), key, params);
+}
+/** CLI: YSK_LOCALE / --locale already parsed → set process default via ALS outer run. */
+export function localeFromEnv(env = process.env) {
+    return normalizeLocale(env.YSK_LOCALE ?? env.LANG ?? null);
+}
+//# sourceMappingURL=request-locale.js.map

package/dist/i18n/request-locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-locale.js","sourceRoot":"","sources":["../../src/i18n/request-locale.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,eAAe,GAEhB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAc,CAAC;AAEhD,uEAAuE;AACvE,MAAM,UAAU,SAAS;IACvB,OAAO,GAAG,CAAC,QAAQ,EAAE,IAAI,cAAc,CAAC;AAC1C,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,aAAa,CAAI,MAAiC,EAAE,EAAW;IAC7E,OAAO,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAiC,EACjC,EAAoB;IAEpB,OAAO,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAIpC;IACC,IAAI,KAAK,CAAC,UAAU;QAAE,OAAO,eAAe,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/D,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO,eAAe,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACjE,IAAI,KAAK,CAAC,cAAc;QAAE,OAAO,wBAAwB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAChF,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,EAAE,CAChB,GAAW,EACX,MAAqE;IAErE,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,aAAa,CAAC,MAAyB,OAAO,CAAC,GAAG;IAChE,OAAO,eAAe,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;AAC7D,CAAC"}

package/dist/i18n/t.d.ts

@@ -0,0 +1,15 @@
+import { type LocaleCode } from './normalize-locale.js';
+export type Dict = {
+    [key: string]: string | Dict;
+};
+export declare function loadLocaleDict(locale: LocaleCode): Dict;
+/** Clear cache (tests). */
+export declare function clearLocaleCache(): void;
+/**
+ * Translate a dotted key for a locale.
+ * Missing key → fallback locale → key itself (honest, visible in dev).
+ */
+export declare function t(locale: string | null | undefined, key: string, params?: Record<string, string | number | boolean | null | undefined>): string;
+/** Deep-merge namespace objects (for building translation bundles). */
+export declare function mergeDicts(...dicts: Dict[]): Dict;
+//# sourceMappingURL=t.d.ts.map

package/dist/i18n/t.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"t.d.ts","sourceRoot":"","sources":["../../src/i18n/t.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,UAAU,EAEhB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,IAAI,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAiBpD,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAcvD;AAED,2BAA2B;AAC3B,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAuBD;;;GAGG;AACH,wBAAgB,CAAC,CACf,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,GACpE,MAAM,CAaR;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,GAAG,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAkBjD"}

package/dist/i18n/t.js

@@ -0,0 +1,103 @@
+/**
+ * Framework-free translator for API + CLI + tests.
+ * Web UI uses i18next loaded from the same JSON catalogs.
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { DEFAULT_LOCALE, normalizeLocale, } from './normalize-locale.js';
+const cache = new Map();
+function localesRoot() {
+    // dist/i18n → ../../locales  OR src/i18n → ../../locales
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        join(here, '../../locales'),
+        join(here, '../../../locales'),
+    ];
+    for (const c of candidates) {
+        if (existsSync(join(c, 'zh-HK', 'translation.json')))
+            return c;
+    }
+    return candidates[0];
+}
+export function loadLocaleDict(locale) {
+    const hit = cache.get(locale);
+    if (hit)
+        return hit;
+    const path = join(localesRoot(), locale, 'translation.json');
+    try {
+        const raw = readFileSync(path, 'utf8');
+        const dict = JSON.parse(raw);
+        cache.set(locale, dict);
+        return dict;
+    }
+    catch {
+        if (locale !== DEFAULT_LOCALE)
+            return loadLocaleDict(DEFAULT_LOCALE);
+        cache.set(locale, {});
+        return {};
+    }
+}
+/** Clear cache (tests). */
+export function clearLocaleCache() {
+    cache.clear();
+}
+function getPath(dict, key) {
+    const parts = key.split('.');
+    let cur = dict;
+    for (const p of parts) {
+        if (cur == null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[p];
+    }
+    return typeof cur === 'string' ? cur : undefined;
+}
+function interpolate(template, params) {
+    if (!params)
+        return template;
+    return template.replace(/\{\{(\w+)\}\}/g, (_, name) => {
+        const v = params[name];
+        return v == null ? '' : String(v);
+    });
+}
+/**
+ * Translate a dotted key for a locale.
+ * Missing key → fallback locale → key itself (honest, visible in dev).
+ */
+export function t(locale, key, params) {
+    const loc = normalizeLocale(locale);
+    const primary = getPath(loadLocaleDict(loc), key);
+    if (primary != null)
+        return interpolate(primary, params);
+    if (loc !== DEFAULT_LOCALE) {
+        const fb = getPath(loadLocaleDict(DEFAULT_LOCALE), key);
+        if (fb != null)
+            return interpolate(fb, params);
+    }
+    if (loc !== 'en') {
+        const en = getPath(loadLocaleDict('en'), key);
+        if (en != null)
+            return interpolate(en, params);
+    }
+    return key;
+}
+/** Deep-merge namespace objects (for building translation bundles). */
+export function mergeDicts(...dicts) {
+    const out = {};
+    for (const d of dicts) {
+        for (const [k, v] of Object.entries(d)) {
+            if (v &&
+                typeof v === 'object' &&
+                !Array.isArray(v) &&
+                out[k] &&
+                typeof out[k] === 'object') {
+                out[k] = mergeDicts(out[k], v);
+            }
+            else {
+                out[k] = v;
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=t.js.map

package/dist/i18n/t.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"t.js","sourceRoot":"","sources":["../../src/i18n/t.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+export * from './types.js';
+export * from './dto.js';
+export * from './errors.js';
+export * from './ops.js';
+export * from './ops-i18n.js';
+export * from './migrate.js';
+export * from './cdn.js';
+/** Domain API DTOs (Wave2 R1 — single source for web + core) */
+export * from './metrics.js';
+export * from './network.js';
+export * from './system.js';
+export * from './databases.js';
+export * from './ftp.js';
+export * from './files.js';
+export * from './bt-tracker.js';
+export * from './email-domain.js';
+export * from './fleet.js';
+export * from './software.js';
+export * from './ssl.js';
+export * from './updates.js';
+export * from './ai.js';
+export * from './service-ports.js';
+export * from './service-exposure.js';
+/** Adjustable multi-level RBAC catalog + factory defaults */
+export * from './capabilities.js';
+/** Mutating route → capability map + nav feature gates */
+export * from './route-capabilities.js';
+/** Unified list search/filter query contract */
+export * from './list-query.js';
+/** i18n — locale catalogs + t() for server/CLI/web */
+export * from './i18n/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAAA,cAAc,UAAU,CAAC;AACtD,gEAAgE;AAChE,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,6DAA6D;AAC7D,cAAc,mBAAmB,CAAC;AAClC,0DAA0D;AAC1D,cAAc,yBAAyB,CAAC;AACxC,gDAAgD;AAChD,cAAc,iBAAiB,CAAC;AAChC,sDAAsD;AACtD,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+export * from './types.js';
+export * from './dto.js';
+export * from './errors.js';
+export * from './ops.js';
+export * from './ops-i18n.js';
+export * from './migrate.js';
+export * from './cdn.js';
+/** Domain API DTOs (Wave2 R1 — single source for web + core) */
+export * from './metrics.js';
+export * from './network.js';
+export * from './system.js';
+export * from './databases.js';
+export * from './ftp.js';
+export * from './files.js';
+export * from './bt-tracker.js';
+export * from './email-domain.js';
+export * from './fleet.js';
+export * from './software.js';
+export * from './ssl.js';
+export * from './updates.js';
+export * from './ai.js';
+export * from './service-ports.js';
+export * from './service-exposure.js';
+/** Adjustable multi-level RBAC catalog + factory defaults */
+export * from './capabilities.js';
+/** Mutating route → capability map + nav feature gates */
+export * from './route-capabilities.js';
+/** Unified list search/filter query contract */
+export * from './list-query.js';
+/** i18n — locale catalogs + t() for server/CLI/web */
+export * from './i18n/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAAA,cAAc,UAAU,CAAC;AACtD,gEAAgE;AAChE,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,6DAA6D;AAC7D,cAAc,mBAAmB,CAAC;AAClC,0DAA0D;AAC1D,cAAc,yBAAyB,CAAC;AACxC,gDAAgD;AAChD,cAAc,iBAAiB,CAAC;AAChC,sDAAsD;AACtD,cAAc,iBAAiB,CAAC"}

package/dist/list-query.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Unified list search / filter query contract for table list APIs.
+ * Used by server routes + web clients (buildListQueryString).
+ */
+export type ListSortOrder = 'asc' | 'desc';
+export type ListQuery = {
+    /** Free-text search (trimmed; empty = no text filter) */
+    q: string;
+    /** Named dimension filters (role, runtime, status, …) */
+    filters: Record<string, string>;
+    sort?: string;
+    order: ListSortOrder;
+    /** 1-based page; ignored when limit is 0 (return all matched) */
+    page: number;
+    /**
+     * Page size. 0 = return all matched items (capped by maxAll).
+     * Default 0 for host-panel sized datasets unless caller sets a page size.
+     */
+    limit: number;
+};
+export type ListMeta = {
+    total: number;
+    page: number;
+    limit: number;
+    q: string;
+    filters: Record<string, string>;
+    sort?: string;
+    order: ListSortOrder;
+    /** Counts per facet key → value, after text filter (before dimension filter on that key optional) */
+    facets?: Record<string, Record<string, number>>;
+};
+export type ListResponse<T> = {
+    items: T[];
+    meta: ListMeta;
+};
+export type ParseListQueryOptions = {
+    /** Allowed enum values per filter key; unknown values are dropped */
+    enums?: Record<string, readonly string[]>;
+    /** Extra free-form filter keys (any non-empty string kept) */
+    freeFilters?: readonly string[];
+    /** Allowed sort field names */
+    sortFields?: readonly string[];
+    defaultSort?: string;
+    defaultOrder?: ListSortOrder;
+    defaultLimit?: number;
+    /** Max page size when limit > 0 (default 200) */
+    maxLimit?: number;
+    /** When limit=0, hard cap on returned rows (default 5000) */
+    maxAll?: number;
+    /** Query keys reserved (never treated as filters) */
+    reserved?: readonly string[];
+};
+/**
+ * Parse URL search params into ListQuery.
+ * Accepts URL | URLSearchParams | Record-like get(name) objects.
+ */
+export declare function parseListQuery(source: URL | URLSearchParams | {
+    searchParams: URLSearchParams;
+}, opts?: ParseListQueryOptions): ListQuery;
+/**
+ * Build query string (without leading ?) from ListQuery-like state.
+ */
+export declare function buildListQueryString(input: {
+    q?: string;
+    filters?: Record<string, string | undefined | null>;
+    sort?: string;
+    order?: ListSortOrder;
+    page?: number;
+    limit?: number;
+}): string;
+export declare function emptyListMeta(query: ListQuery, total?: number): ListMeta;
+//# sourceMappingURL=list-query.d.ts.map

package/dist/list-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-query.d.ts","sourceRoot":"","sources":["../src/list-query.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;AAE3C,MAAM,MAAM,SAAS,GAAG;IACtB,yDAAyD;IACzD,CAAC,EAAE,MAAM,CAAC;IACV,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,qGAAqG;IACrG,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC5B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAC1C,8DAA8D;IAC9D,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,+BAA+B;IAC/B,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B,CAAC;AAYF;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,GAAG,GAAG,eAAe,GAAG;IAAE,YAAY,EAAE,eAAe,CAAA;CAAE,EACjE,IAAI,GAAE,qBAA0B,GAC/B,SAAS,CAyDX;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAcT;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,SAAI,GAAG,QAAQ,CAUnE"}

package/dist/list-query.js

@@ -0,0 +1,108 @@
+/**
+ * Unified list search / filter query contract for table list APIs.
+ * Used by server routes + web clients (buildListQueryString).
+ */
+const DEFAULT_RESERVED = [
+    'q',
+    'sort',
+    'order',
+    'page',
+    'limit',
+    'locale',
+    'summary',
+];
+/**
+ * Parse URL search params into ListQuery.
+ * Accepts URL | URLSearchParams | Record-like get(name) objects.
+ */
+export function parseListQuery(source, opts = {}) {
+    const sp = source instanceof URLSearchParams
+        ? source
+        : source instanceof URL
+            ? source.searchParams
+            : source.searchParams;
+    const maxLimit = opts.maxLimit ?? 200;
+    const defaultLimit = opts.defaultLimit ?? 0;
+    const reserved = new Set([...DEFAULT_RESERVED, ...(opts.reserved ?? [])]);
+    const q = (sp.get('q') ?? '').trim();
+    const pageRaw = Number(sp.get('page') || 1);
+    const page = Number.isFinite(pageRaw) && pageRaw >= 1 ? Math.floor(pageRaw) : 1;
+    let limitRaw = sp.get('limit');
+    let limit;
+    if (limitRaw == null || limitRaw === '') {
+        limit = defaultLimit;
+    }
+    else {
+        const n = Number(limitRaw);
+        if (!Number.isFinite(n) || n < 0)
+            limit = defaultLimit;
+        else if (n === 0)
+            limit = 0;
+        else
+            limit = Math.min(maxLimit, Math.floor(n));
+    }
+    let order = (sp.get('order') ?? opts.defaultOrder ?? 'asc').toLowerCase() === 'desc'
+        ? 'desc'
+        : 'asc';
+    let sort = (sp.get('sort') ?? opts.defaultSort ?? '').trim() || undefined;
+    if (sort && opts.sortFields && !opts.sortFields.includes(sort)) {
+        sort = opts.defaultSort;
+    }
+    const filters = {};
+    const enumKeys = opts.enums ? Object.keys(opts.enums) : [];
+    const freeKeys = opts.freeFilters ?? [];
+    for (const key of enumKeys) {
+        const raw = (sp.get(key) ?? '').trim();
+        if (!raw)
+            continue;
+        const allowed = opts.enums[key];
+        if (allowed.includes(raw))
+            filters[key] = raw;
+    }
+    for (const key of freeKeys) {
+        if (reserved.has(key))
+            continue;
+        const raw = (sp.get(key) ?? '').trim();
+        if (raw)
+            filters[key] = raw;
+    }
+    // Also accept any other non-reserved param as free filter when freeFilters is empty
+    // but enums listed — only enum + freeFilters keys; no open world by default.
+    return { q, filters, sort, order, page, limit };
+}
+/**
+ * Build query string (without leading ?) from ListQuery-like state.
+ */
+export function buildListQueryString(input) {
+    const sp = new URLSearchParams();
+    const q = (input.q ?? '').trim();
+    if (q)
+        sp.set('q', q);
+    if (input.filters) {
+        for (const [k, v] of Object.entries(input.filters)) {
+            if (v != null && String(v).trim() !== '')
+                sp.set(k, String(v).trim());
+        }
+    }
+    if (input.sort)
+        sp.set('sort', input.sort);
+    if (input.order && input.order !== 'asc')
+        sp.set('order', input.order);
+    if (input.page != null && input.page > 1)
+        sp.set('page', String(input.page));
+    if (input.limit != null && input.limit > 0)
+        sp.set('limit', String(input.limit));
+    return sp.toString();
+}
+export function emptyListMeta(query, total = 0) {
+    return {
+        total,
+        page: query.page,
+        limit: query.limit,
+        q: query.q,
+        filters: { ...query.filters },
+        sort: query.sort,
+        order: query.order,
+    };
+}
+//# sourceMappingURL=list-query.js.map

package/dist/list-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-query.js","sourceRoot":"","sources":["../src/list-query.ts"],"names":[],"mappings":"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"}

package/dist/metrics.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Host metrics / process table / top header — API + core contract.
+ */
+export interface DiskMountDto {
+    filesystem: string;
+    size: number;
+    used: number;
+    avail: number;
+    usedRatio: number;
+    mount: string;
+}
+/** @deprecated Prefer DiskMountDto */
+export type DiskMount = DiskMountDto;
+export interface MetricsSnapshotDto {
+    at: string;
+    loadavg: number[];
+    cpuCount: number;
+    memory: {
+        total: number;
+        free: number;
+        usedRatio: number;
+        available?: number;
+    };
+    uptimeSec: number;
+    disk?: {
+        path: string;
+        free: number;
+        total: number;
+        usedRatio: number;
+    };
+    diskMounts?: DiskMountDto[];
+    alerts: string[];
+    notes?: string[];
+}
+/** @deprecated Prefer MetricsSnapshotDto */
+export type MetricsSnapshot = MetricsSnapshotDto;
+export interface CpuTimesPctDto {
+    us: number;
+    sy: number;
+    ni: number;
+    id: number;
+    wa: number;
+    hi: number;
+    si: number;
+    st: number;
+    busyPct: number;
+}
+export type CpuTimesPct = CpuTimesPctDto;
+export interface TopHeaderDto {
+    ok: boolean;
+    at: string;
+    uptimeSec: number;
+    loadavg: [number, number, number];
+    tasks: {
+        total: number;
+        running: number;
+        sleeping: number;
+        stopped: number;
+        zombie: number;
+    };
+    cpu: CpuTimesPctDto;
+    cpus: CpuTimesPctDto[];
+    memory: {
+        totalKiB: number;
+        freeKiB: number;
+        usedKiB: number;
+        buffCacheKiB: number;
+        availableKiB: number;
+    };
+    swap: {
+        totalKiB: number;
+        freeKiB: number;
+        usedKiB: number;
+    };
+    notes: string[];
+    sampleMs?: number;
+}
+export type TopHeader = TopHeaderDto;
+export type ProcessSort = 'cpu' | 'mem' | 'time' | 'pid';
+export interface ProcessRowDto {
+    pid: string;
+    user: string;
+    cpu: number;
+    mem: number;
+    command: string;
+    etime?: string;
+    pr?: string;
+    ni?: number;
+    virtKiB?: number;
+    resKiB?: number;
+    shrKiB?: number;
+    state?: string;
+    timePlus?: string;
+}
+export type ProcessRow = ProcessRowDto;
+export interface ProcessSnapshotDto {
+    ok: boolean;
+    at: string;
+    sort: ProcessSort;
+    limit: number;
+    rows: ProcessRowDto[];
+    topHeader?: TopHeaderDto;
+    rawTop?: string;
+    notes: string[];
+}
+export type ProcessSnapshot = ProcessSnapshotDto;
+export type ProcessSignal = 'TERM' | 'KILL' | 'HUP' | 'USR1';
+export interface SignalProcessResultDto {
+    ok: boolean;
+    blocked?: boolean;
+    blockMessage?: string;
+    pid: string;
+    signal: ProcessSignal;
+    stillAlive?: boolean;
+    command?: string;
+    notes: string[];
+    executeEnabled?: boolean;
+    nice?: number;
+}
+export interface ProcessDetailDto {
+    ok: boolean;
+    pid: string;
+    command?: string;
+    cwd?: string;
+    fdCount?: number;
+    notes: string[];
+}
+export interface MetricsStreamTickDto {
+    at: string;
+    metrics: MetricsSnapshotDto;
+    processes: ProcessSnapshotDto;
+    topHeader?: TopHeaderDto;
+}
+export interface ProjectDiskUsageRowDto {
+    projectId: string;
+    name: string;
+    domain?: string;
+    homeDir: string;
+    usedBytes: number;
+    usedMb: number;
+    quotaMb: number | null;
+    usedRatio: number | null;
+    withinQuota: boolean | null;
+    notes: string[];
+}
+export interface ProjectsDiskUsageSnapshotDto {
+    ok: boolean;
+    at: string;
+    items: ProjectDiskUsageRowDto[];
+    totalUsedBytes: number;
+    notes: string[];
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"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"}

package/dist/metrics.js

@@ -0,0 +1,5 @@
+/**
+ * Host metrics / process table / top header — API + core contract.
+ */
+export {};
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA;;GAEG"}