@camstack/core 0.1.15 → 0.1.16

package/dist/builtins/backup-orchestrator/cron-helpers.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Validate a cron expression and return its next firing time strictly
+ * after `after`, expressed as ms-epoch. Returns `null` when the
+ * expression has no future runs (croner returns null e.g. for
+ * fully-bounded patterns that have already elapsed). Throws when the
+ * expression is syntactically invalid — callers are expected to
+ * surface that to the operator.
+ */
+export declare function computeNextDue(cron: string, after: number): number | null;
+/**
+ * Validate without computing — returns true when `cron` parses, false
+ * otherwise. Used by the cap-router input zod schema's `.refine`
+ * callback to reject malformed expressions at the boundary instead
+ * of at scheduler-tick time.
+ */
+export declare function isValidCron(cron: string): boolean;
+/**
+ * Peek the next N firing times after `after` (default: now). Used by
+ * the admin UI's CronEditor preview pane — operators see the next
+ * 3–5 runs as they edit the expression so a wrong pattern is
+ * obvious before save.
+ */
+export declare function previewNextRuns(cron: string, count: number, after?: number): readonly number[];
+//# sourceMappingURL=cron-helpers.d.ts.map

package/dist/builtins/backup-orchestrator/cron-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-helpers.d.ts","sourceRoot":"","sources":["../../../src/builtins/backup-orchestrator/cron-helpers.ts"],"names":[],"mappings":"AAeA;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIzE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOjD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAW9F"}

package/dist/builtins/backup-orchestrator/destination-policy.d.ts

@@ -0,0 +1,73 @@
+import { ISettingsBackend, TableSchema } from '@camstack/types';
+/**
+ * Per-`backups`-location policy. `locationId` is the foreign-key into
+ * the storage orchestrator's `storage_locations` table.
+ *
+ * `enabled` gates whether scheduled / unspecified-target backups fan out
+ * to this destination; operators can disable a destination temporarily
+ * without deleting the underlying `StorageLocation`.
+ *
+ * `retentionCount` is independent per destination — destination A may
+ * keep 3 archives while B keeps 30.
+ *
+ * `label` is an optional operator-defined display string. When omitted
+ * the orchestrator falls back to the `StorageLocation.displayName`.
+ */
+export interface BackupDestinationPolicy {
+    readonly locationId: string;
+    readonly enabled: boolean;
+    readonly retentionCount: number;
+    readonly label?: string;
+    /**
+     * Cron expression for scheduled backups to this destination. When
+     * undefined / empty the destination only receives backups from
+     * manual `runNow()` calls. Each destination has its own cadence —
+     * an offsite SFTP can run weekly while local stays nightly. The
+     * orchestrator parses with `cron-parser` (5-field POSIX cron, no
+     * seconds field).
+     */
+    readonly cron?: string;
+    /** ms-epoch of the last successful backup completion to this destination. */
+    readonly lastRunAt?: number;
+}
+export declare const BACKUP_DESTINATION_POLICIES_SCHEMA: TableSchema;
+export declare class BackupDestinationPolicyService {
+    private readonly backend;
+    private tableEnsured;
+    constructor(backend: ISettingsBackend);
+    /**
+     * Lazy `ensureTable` — called from every read/write path. The
+     * settings backend's own `ensureTable` is idempotent (additive
+     * migration), so repeated calls collapse to a no-op after the first.
+     * This keeps the constructor synchronous and avoids a separate
+     * `initialize()` step that callers could forget.
+     */
+    initialize(): Promise<void>;
+    private ensureTable;
+    list(): Promise<readonly BackupDestinationPolicy[]>;
+    get(locationId: string): Promise<BackupDestinationPolicy | null>;
+    /**
+     * Replace-or-insert. Implemented as `delete` + `insert` (mirrors the
+     * `SqliteLocationStore` contract) so backends that don't surface
+     * `tableUpdate` still work.
+     */
+    upsert(p: BackupDestinationPolicy): Promise<void>;
+    delete(locationId: string): Promise<void>;
+    /**
+     * Auto-create a default policy for a `backups` location seen for the
+     * first time (returns the existing policy unchanged when present).
+     * The orchestrator calls this lazily on the first `listDestinations`
+     * pass so newly-added storage locations are surfaced as enabled
+     * destinations without an explicit configuration step.
+     *
+     * Defaults are passed by the orchestrator (currently:
+     * `retentionCount=7` + `cron='0 3 * * *'`) so a fresh destination
+     * starts running daily at 03:00 with 7 archives kept. Operator can
+     * tune both inline on the destinations table.
+     */
+    ensureDefault(locationId: string, defaults: {
+        retentionCount: number;
+        cron?: string;
+    }): Promise<BackupDestinationPolicy>;
+}
+//# sourceMappingURL=destination-policy.d.ts.map

package/dist/builtins/backup-orchestrator/destination-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination-policy.d.ts","sourceRoot":"","sources":["../../../src/builtins/backup-orchestrator/destination-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAEpE;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAID,eAAO,MAAM,kCAAkC,EAAE,WAShD,CAAA;AAED,qBAAa,8BAA8B;IAG7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,YAAY,CAAQ;gBAEC,OAAO,EAAE,gBAAgB;IAEtD;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAInB,WAAW;IAYnB,IAAI,IAAI,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC;IAcnD,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAOtE;;;;OAIG;IACG,MAAM,CAAC,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IASjD,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/C;;;;;;;;;;;OAWG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAClD,OAAO,CAAC,uBAAuB,CAAC;CAYpC"}

package/dist/builtins/backup-orchestrator/download-helpers.d.ts

@@ -0,0 +1,13 @@
+import { IScopedLogger } from '@camstack/types';
+import { ChunkedDownloadApi } from './manifest-store.js';
+export interface DownloadArchiveInput {
+    readonly api: ChunkedDownloadApi;
+    readonly locationId: string;
+    readonly filename: string;
+    readonly cachePath: string;
+    /** Per-chunk byte budget. Matches the upload helper's 8 MiB. */
+    readonly chunkBytes: number;
+    readonly logger: IScopedLogger;
+}
+export declare function downloadArchiveToCache(input: DownloadArchiveInput): Promise<void>;
+//# sourceMappingURL=download-helpers.d.ts.map

package/dist/builtins/backup-orchestrator/download-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-helpers.d.ts","sourceRoot":"","sources":["../../../src/builtins/backup-orchestrator/download-helpers.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAE7D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAA;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAC/B;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyDvF"}

package/dist/builtins/backup-orchestrator/index.d.ts

@@ -0,0 +1,3 @@
+export { BackupOrchestratorAddon } from './backup-orchestrator.addon.js';
+export { BackupOrchestratorAddon as default } from './backup-orchestrator.addon.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/builtins/backup-orchestrator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builtins/backup-orchestrator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AACxE,OAAO,EAAE,uBAAuB,IAAI,OAAO,EAAE,MAAM,gCAAgC,CAAA"}

package/dist/builtins/backup-orchestrator/index.js

@@ -0,0 +1,7 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_builtins_backup_orchestrator_backup_orchestrator_addon = require("./backup-orchestrator.addon.js");
+exports.BackupOrchestratorAddon = require_builtins_backup_orchestrator_backup_orchestrator_addon.BackupOrchestratorAddon;
+exports.default = require_builtins_backup_orchestrator_backup_orchestrator_addon.BackupOrchestratorAddon;

package/dist/builtins/backup-orchestrator/index.mjs

@@ -0,0 +1,2 @@
+import { BackupOrchestratorAddon } from "./backup-orchestrator.addon.mjs";
+export { BackupOrchestratorAddon, BackupOrchestratorAddon as default };

package/dist/builtins/backup-orchestrator/manifest-store.d.ts

@@ -0,0 +1,78 @@
+import { AddonApi } from '@camstack/types';
+import { ArchiveManifest } from '../system-backup/system-backup.service.js';
+/** File path (relative to the location root) where the index lives. */
+export declare const MANIFESTS_FILENAME = "manifests.json";
+export interface ManifestArchiveEntry {
+    readonly id: string;
+    /** Filename inside the location (e.g. `<id>.tar.gz`). */
+    readonly filename: string;
+    readonly createdAt: number;
+    readonly sizeBytes: number;
+    readonly label?: string;
+    /** Snapshot of the embedded `.camstack-backup-manifest.json`. */
+    readonly manifest: ArchiveManifest;
+}
+export interface LocationBackupManifest {
+    readonly version: 1;
+    readonly archives: readonly ManifestArchiveEntry[];
+}
+/** Subset of `AddonApi['storage']` the manifest store consumes. */
+export type ManifestStorageApi = Pick<AddonApi['storage'], 'read' | 'write' | 'exists'>;
+/**
+ * Subset of `AddonApi['storage']` consumed by the chunked-download
+ * helper. Sourced from the same generated type so the contract stays
+ * in lockstep with the live cap surface.
+ */
+export type ChunkedDownloadApi = Pick<AddonApi['storage'], 'beginDownload' | 'readChunk' | 'endDownload'>;
+/**
+ * Read the per-location manifest. Returns an empty manifest on first
+ * use (when `manifests.json` doesn't exist) or when the file is
+ * unreadable / corrupt — operators see destination state degrade
+ * gracefully rather than the orchestrator crashing.
+ */
+export declare function readLocationManifest(api: ManifestStorageApi, locationId: string): Promise<LocationBackupManifest>;
+export declare function writeLocationManifest(api: ManifestStorageApi, locationId: string, manifest: LocationBackupManifest): Promise<void>;
+/**
+ * Decode the raw bytes of `manifests.json`. Falls back to an empty
+ * manifest on JSON-parse / shape-validation failure — same defensive
+ * stance as the legacy `LocalBackupService.ensureManifestsLoaded`.
+ */
+export declare function parseManifestBytes(bytes: Uint8Array): LocationBackupManifest;
+/**
+ * Build a `ManifestArchiveEntry` from the raw inputs collected during
+ * a successful upload. Pure transform — no I/O — kept here so the
+ * triggerBackup path stays terse.
+ */
+export declare function buildArchiveEntry(input: {
+    id: string;
+    filename: string;
+    createdAt: number;
+    sizeBytes: number;
+    label?: string;
+    manifest: ArchiveManifest;
+}): ManifestArchiveEntry;
+/**
+ * Pure retention split: given an archive list and the operator's
+ * `retentionCount`, return `{ keep, drop }` where `keep` is the most-
+ * recent N archives (newest first) and `drop` is the older overflow.
+ *
+ * `retentionCount <= 0` is treated as "no pruning" — defensive against
+ * a config value that would otherwise wipe every archive on the next
+ * write.
+ */
+export declare function applyRetention(archives: readonly ManifestArchiveEntry[], retentionCount: number): {
+    readonly keep: readonly ManifestArchiveEntry[];
+    readonly drop: readonly ManifestArchiveEntry[];
+};
+/**
+ * Per-location async mutex. The orchestrator owns one instance and
+ * funnels every read-modify-write of `manifests.json` through it so
+ * parallel destination uploads (within the same location) commit in
+ * arrival order. Across locations the operations run in parallel —
+ * each location keys its own promise chain.
+ */
+export declare class LocationManifestLock {
+    private readonly chains;
+    run<T>(locationId: string, fn: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=manifest-store.d.ts.map

package/dist/builtins/backup-orchestrator/manifest-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-store.d.ts","sourceRoot":"","sources":["../../../src/builtins/backup-orchestrator/manifest-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAA;AAEhF,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,mBAAmB,CAAA;AAElD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAA;CACnD;AAED,mEAAmE;AACnE,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC,CAAA;AAEvF;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,GAAG,WAAW,GAAG,aAAa,CAAC,CAAA;AAEzG;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,kBAAkB,EACvB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,sBAAsB,CAAC,CAgBjC;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,kBAAkB,EACvB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,sBAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,sBAAsB,CAS5E;AAmCD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,eAAe,CAAA;CAC1B,GAAG,oBAAoB,CASvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,SAAS,oBAAoB,EAAE,EACzC,cAAc,EAAE,MAAM,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,oBAAoB,EAAE,CAAA;CAAE,CAUpG;AAED;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAEpD,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CA0BnE"}

package/dist/builtins/console-logging/console-destination.d.ts

@@ -0,0 +1,14 @@
+import { ILogDestination, LogEntry, LogFilter } from '@camstack/types';
+interface ConsoleConfig {
+    /** Minimum log level to emit. Entries below this level are dropped. */
+    readonly level?: 'debug' | 'info' | 'warn' | 'error';
+}
+export declare class ConsoleDestination implements ILogDestination {
+    private minLevel;
+    initialize(config?: ConsoleConfig): Promise<void>;
+    write(entry: LogEntry): void;
+    query(_filter: LogFilter): Promise<readonly LogEntry[]>;
+    shutdown(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=console-destination.d.ts.map

package/dist/builtins/console-logging/console-destination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-destination.d.ts","sourceRoot":"","sources":["../../../src/builtins/console-logging/console-destination.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAG3E,UAAU,aAAa;IACrB,uEAAuE;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CACrD;AAMD,qBAAa,kBAAmB,YAAW,eAAe;IACxD,OAAO,CAAC,QAAQ,CAAI;IAEd,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAWtB,KAAK,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC;IAKvD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}

package/dist/builtins/console-logging/console-logging.addon.d.ts

@@ -0,0 +1,26 @@
+import { ProviderRegistration, BaseAddon } from '@camstack/types';
+import { ConsoleDestination } from './console-destination.js';
+interface ConsoleConfig {
+    readonly level: 'debug' | 'info' | 'warn' | 'error';
+}
+/**
+ * Console logging addon — zero-dependency stdout/stderr sink that
+ * produces the same canonical line format as the Winston built-in.
+ * Registers as a `log-destination` capability provider so the shared
+ * LogManager fans every entry to both sinks when both are active.
+ *
+ * Settings live under Cluster → NodeDetail → Settings alongside the
+ * Winston addon. Disable one without disabling the other — the
+ * LogManager keeps working as long as at least one destination is
+ * registered.
+ */
+export declare class ConsoleLoggingAddon extends BaseAddon<ConsoleConfig> {
+    private destination;
+    constructor();
+    protected onInitialize(): Promise<ProviderRegistration[]>;
+    protected onShutdown(): Promise<void>;
+    getDestination(): ConsoleDestination;
+    protected globalSettingsSchema(): import('@camstack/types').ConfigUISchema;
+}
+export {};
+//# sourceMappingURL=console-logging.addon.d.ts.map

package/dist/builtins/console-logging/console-logging.addon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-logging.addon.d.ts","sourceRoot":"","sources":["../../../src/builtins/console-logging/console-logging.addon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAC3D,OAAO,EAAE,SAAS,EAA4B,MAAM,iBAAiB,CAAA;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAE7D,UAAU,aAAa;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CACpD;AAED;;;;;;;;;;GAUG;AACH,qBAAa,mBAAoB,SAAQ,SAAS,CAAC,aAAa,CAAC;IAC/D,OAAO,CAAC,WAAW,CAAkC;;cAMrC,YAAY,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;cAO/C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3C,cAAc,IAAI,kBAAkB;IAKpC,SAAS,CAAC,oBAAoB;CA0B/B"}

package/dist/builtins/console-logging/index.d.ts

@@ -0,0 +1,4 @@
+export { ConsoleLoggingAddon } from './console-logging.addon.js';
+export { ConsoleDestination } from './console-destination.js';
+export { ConsoleLoggingAddon as default } from './console-logging.addon.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/builtins/console-logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builtins/console-logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,EAAE,mBAAmB,IAAI,OAAO,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/builtins/console-logging/index.js

@@ -1,242 +1,106 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/builtins/console-logging/index.ts
-var console_logging_exports = {};
-__export(console_logging_exports, {
-  ConsoleDestination: () => ConsoleDestination,
-  ConsoleLoggingAddon: () => ConsoleLoggingAddon,
-  default: () => ConsoleLoggingAddon
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
 });
-module.exports = __toCommonJS(console_logging_exports);
-
-// src/builtins/console-logging/console-logging.addon.ts
-var import_types = require("@camstack/types");
-
-// src/logging/formatter.ts
-var USE_COLOR = (() => {
-  try {
-    if (typeof process === "undefined") return false;
-    const env = process.env ?? {};
-    if (env["NO_COLOR"]) return false;
-    const force = env["FORCE_COLOR"];
-    if (force !== void 0) return force !== "" && force !== "0" && force !== "false";
-    return Boolean(process.stdout?.isTTY);
-  } catch {
-    return false;
-  }
-})();
-var NO_COLOR = (() => {
-  try {
-    return Boolean(process?.env?.["NO_COLOR"]);
-  } catch {
-    return false;
-  }
-})();
-var RESET = "\x1B[0m";
-var ANSI = {
-  green: "\x1B[32m",
-  yellow: "\x1B[33m",
-  red: "\x1B[31m",
-  cyan: "\x1B[36m",
-  gray: "\x1B[90m"
-};
-var COLOR_BY_LEVEL = {
-  debug: ANSI.gray,
-  info: ANSI.green,
-  warn: ANSI.yellow,
-  error: ANSI.red
-};
-function paint(color, text, enabled) {
-  return enabled ? `${color}${text}${RESET}` : text;
-}
-function colorizeLevel(level, text, enabled) {
-  if (!enabled) return text;
-  const code = COLOR_BY_LEVEL[level];
-  return code ? `${code}${text}${RESET}` : text;
-}
-function padRight(value, width) {
-  if (value.length >= width) return value.slice(0, width);
-  return value + " ".repeat(width - value.length);
-}
-function resolveAgent(tags) {
-  const agentId = tags?.agentId;
-  if (typeof agentId === "string" && agentId.length > 0) return agentId;
-  const nodeId = tags?.nodeId;
-  if (typeof nodeId === "string" && nodeId.length > 0) {
-    return nodeId.includes("/") ? nodeId.split("/")[0] : nodeId;
-  }
-  return null;
-}
-function resolveAddon(entry) {
-  const addonId = entry.tags?.addonId;
-  if (typeof addonId === "string" && addonId.length > 0) return addonId;
-  return "system";
-}
-function resolveDevice(tags) {
-  const name = tags?.deviceName;
-  if (typeof name === "string" && name.length > 0) return name;
-  const id = tags?.deviceId;
-  if (typeof id === "number" && Number.isFinite(id)) return `#${id}`;
-  return null;
-}
-function buildBrand(entry) {
-  const agent = resolveAgent(entry.tags) ?? "?";
-  const addon = resolveAddon(entry);
-  return `${agent}/${addon}`;
-}
-function buildDeviceContext(entry) {
-  return resolveDevice(entry.tags);
-}
-function formatTimestamp(value) {
-  const date = value instanceof Date ? value : new Date(typeof value === "string" ? value : Date.now());
-  return date.toLocaleString("en-US", {
-    month: "numeric",
-    day: "numeric",
-    year: "numeric",
-    hour: "numeric",
-    minute: "2-digit",
-    second: "2-digit",
-    hour12: true
-  });
-}
-function formatMeta(meta) {
-  if (!meta) return "";
-  const keys = Object.keys(meta);
-  if (keys.length === 0) return "";
-  const parts = [];
-  for (const key of keys) {
-    const value = meta[key];
-    parts.push(`${key}=${formatMetaValue(value)}`);
-  }
-  return `{${parts.join(" ")}}`;
-}
-function formatMetaValue(value) {
-  if (value === null) return "null";
-  if (value === void 0) return "undefined";
-  if (typeof value === "string") {
-    return /\s|"/.test(value) ? JSON.stringify(value) : value;
-  }
-  if (typeof value === "number" || typeof value === "boolean") return String(value);
-  if (value instanceof Error) return JSON.stringify(value.message);
-  try {
-    return JSON.stringify(value);
-  } catch {
-    return String(value);
-  }
-}
-var PID = typeof process !== "undefined" && typeof process.pid === "number" ? String(process.pid) : "?";
-function formatLogLine(entry, options) {
-  const wantsColor = options?.colorize ?? USE_COLOR;
-  const colorize = wantsColor && !NO_COLOR;
-  const levelColor = COLOR_BY_LEVEL[entry.level];
-  const brand = paint(ANSI.green, `[${buildBrand(entry)}]`, colorize);
-  const entryPid = entry.tags?.pid;
-  const pid = typeof entryPid === "number" ? String(entryPid) : PID;
-  const timestamp = formatTimestamp(entry.timestamp);
-  const level = colorizeLevel(entry.level, padRight(entry.level.toUpperCase(), 5), colorize);
-  const device = buildDeviceContext(entry);
-  const ctxPart = device ? " " + paint(ANSI.yellow, `[${device}]`, colorize) : "";
-  const scope = typeof entry.scope === "string" && entry.scope.length > 0 ? entry.scope : null;
-  const scopePart = scope ? " " + paint(ANSI.cyan, `(${scope})`, colorize) : "";
-  const metaText = formatMeta(entry.meta);
-  const metaPart = metaText ? " " + paint(ANSI.gray, metaText, colorize) : "";
-  const message = colorize && levelColor ? `${levelColor}${entry.message}${RESET}` : entry.message;
-  return `${brand} ${pid}  - ${timestamp}     ${level}${ctxPart}${scopePart} ${message}${metaPart}`;
-}
-
-// src/builtins/console-logging/console-destination.ts
+require("../../chunk-C13QxCFV.js");
+const require_formatter = require("../../formatter-Dr_6NNZc.js");
+let _camstack_types = require("@camstack/types");
+//#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {
-  debug: 0,
-  info: 1,
-  warn: 2,
-  error: 3
+	debug: 0,
+	info: 1,
+	warn: 2,
+	error: 3
 };
 var ConsoleDestination = class {
-  minLevel = 0;
-  async initialize(config) {
-    this.minLevel = LEVEL_RANK[config?.level ?? "info"] ?? 1;
-  }
-  write(entry) {
-    const rank = LEVEL_RANK[entry.level] ?? 1;
-    if (rank < this.minLevel) return;
-    const line = formatLogLine(entry, { colorize: true });
-    if (entry.level === "error") console.error(line);
-    else if (entry.level === "warn") console.warn(line);
-    else console.log(line);
-  }
-  async query(_filter) {
-    return [];
-  }
-  async shutdown() {
-  }
+	minLevel = 0;
+	async initialize(config) {
+		this.minLevel = LEVEL_RANK[config?.level ?? "info"] ?? 1;
+	}
+	write(entry) {
+		if ((LEVEL_RANK[entry.level] ?? 1) < this.minLevel) return;
+		const line = require_formatter.formatLogLine(entry, { colorize: true });
+		if (entry.level === "error") console.error(line);
+		else if (entry.level === "warn") console.warn(line);
+		else console.log(line);
+	}
+	async query(_filter) {
+		return [];
+	}
+	async shutdown() {}
 };
-
-// src/builtins/console-logging/console-logging.addon.ts
-var ConsoleLoggingAddon = class extends import_types.BaseAddon {
-  destination = null;
-  constructor() {
-    super({ level: "info" });
-  }
-  async onInitialize() {
-    this.destination = new ConsoleDestination();
-    await this.destination.initialize({ level: this.config.level });
-    this.ctx.logger.info("Console logging initialized");
-    return [{ capability: import_types.logDestinationCapability, provider: this.destination }];
-  }
-  async onShutdown() {
-    await this.destination?.shutdown();
-  }
-  getDestination() {
-    if (!this.destination) throw new Error("Console logging not initialized");
-    return this.destination;
-  }
-  globalSettingsSchema() {
-    return this.schema({
-      sections: [
-        {
-          id: "console-logging",
-          title: "Console Logging",
-          description: "Minimum log level to emit on stdout/stderr. Independent from the rotated-file (Winston) destination.",
-          columns: 2,
-          fields: [
-            this.field({
-              type: "select",
-              key: "level",
-              label: "Log Level",
-              default: "info",
-              options: [
-                { value: "debug", label: "Debug" },
-                { value: "info", label: "Info" },
-                { value: "warn", label: "Warn" },
-                { value: "error", label: "Error" }
-              ]
-            })
-          ]
-        }
-      ]
-    });
-  }
+//#endregion
+//#region src/builtins/console-logging/console-logging.addon.ts
+/**
+* Console logging addon — zero-dependency stdout/stderr sink that
+* produces the same canonical line format as the Winston built-in.
+* Registers as a `log-destination` capability provider so the shared
+* LogManager fans every entry to both sinks when both are active.
+*
+* Settings live under Cluster → NodeDetail → Settings alongside the
+* Winston addon. Disable one without disabling the other — the
+* LogManager keeps working as long as at least one destination is
+* registered.
+*/
+var ConsoleLoggingAddon = class extends _camstack_types.BaseAddon {
+	destination = null;
+	constructor() {
+		super({ level: "info" });
+	}
+	async onInitialize() {
+		this.destination = new ConsoleDestination();
+		await this.destination.initialize({ level: this.config.level });
+		this.ctx.logger.info("Console logging initialized");
+		return [{
+			capability: _camstack_types.logDestinationCapability,
+			provider: this.destination
+		}];
+	}
+	async onShutdown() {
+		await this.destination?.shutdown();
+	}
+	getDestination() {
+		if (!this.destination) throw new Error("Console logging not initialized");
+		return this.destination;
+	}
+	globalSettingsSchema() {
+		return this.schema({ sections: [{
+			id: "console-logging",
+			title: "Console Logging",
+			description: "Minimum log level to emit on stdout/stderr. Independent from the rotated-file (Winston) destination.",
+			columns: 2,
+			fields: [this.field({
+				type: "select",
+				key: "level",
+				label: "Log Level",
+				default: "info",
+				options: [
+					{
+						value: "debug",
+						label: "Debug"
+					},
+					{
+						value: "info",
+						label: "Info"
+					},
+					{
+						value: "warn",
+						label: "Warn"
+					},
+					{
+						value: "error",
+						label: "Error"
+					}
+				]
+			})]
+		}] });
+	}
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ConsoleDestination,
-  ConsoleLoggingAddon
-});
+//#endregion
+exports.ConsoleDestination = ConsoleDestination;
+exports.ConsoleDestination$1 = ConsoleDestination;
+exports.ConsoleLoggingAddon = ConsoleLoggingAddon;
+exports.ConsoleLoggingAddon$1 = ConsoleLoggingAddon;
+exports.default = ConsoleLoggingAddon;
+
 //# sourceMappingURL=index.js.map