@camstack/core 0.1.14 → 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

@@ -0,0 +1,106 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+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
+};
+var ConsoleDestination = class {
+	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() {}
+};
+//#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"
+					}
+				]
+			})]
+		}] });
+	}
+};
+//#endregion
+exports.ConsoleDestination = ConsoleDestination;
+exports.ConsoleDestination$1 = ConsoleDestination;
+exports.ConsoleLoggingAddon = ConsoleLoggingAddon;
+exports.ConsoleLoggingAddon$1 = ConsoleLoggingAddon;
+exports.default = ConsoleLoggingAddon;
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/builtins/console-logging/console-destination.ts","../../../src/builtins/console-logging/console-logging.addon.ts"],"sourcesContent":["/**\n * Zero-dependency log destination that writes every entry to stdout /\n * stderr via the shared `formatLogLine` formatter. Same surface as\n * `WinstonDestination` (full `ILogDestination` contract) but without\n * the rotating-file transport — ideal fallback when the Winston addon\n * is disabled or unavailable (e.g. bare-bones agents, tests).\n */\nimport type { ILogDestination, LogEntry, LogFilter } from '@camstack/types'\nimport { formatLogLine } from '../../logging/formatter.js'\n\ninterface ConsoleConfig {\n  /** Minimum log level to emit. Entries below this level are dropped. */\n  readonly level?: 'debug' | 'info' | 'warn' | 'error'\n}\n\nconst LEVEL_RANK: Readonly<Record<string, number>> = {\n  debug: 0, info: 1, warn: 2, error: 3,\n}\n\nexport class ConsoleDestination implements ILogDestination {\n  private minLevel = 0\n\n  async initialize(config?: ConsoleConfig): Promise<void> {\n    this.minLevel = LEVEL_RANK[config?.level ?? 'info'] ?? 1\n  }\n\n  write(entry: LogEntry): void {\n    const rank = LEVEL_RANK[entry.level] ?? 1\n    if (rank < this.minLevel) return\n    // Always request ANSI colours for the console sink. The formatter still\n    // respects `NO_COLOR` so operators can opt out globally.\n    const line = formatLogLine(entry, { colorize: true })\n    if (entry.level === 'error') console.error(line)\n    else if (entry.level === 'warn') console.warn(line)\n    else console.log(line)\n  }\n\n  async query(_filter: LogFilter): Promise<readonly LogEntry[]> {\n    // Console has no persistence — queries are served by other destinations.\n    return []\n  }\n\n  async shutdown(): Promise<void> {\n    // Nothing to flush — stdout/stderr are process-owned.\n  }\n}\n","import type { ProviderRegistration } from '@camstack/types'\nimport { BaseAddon, logDestinationCapability } from '@camstack/types'\nimport { ConsoleDestination } from './console-destination.js'\n\ninterface ConsoleConfig {\n  readonly level: 'debug' | 'info' | 'warn' | 'error'\n}\n\n/**\n * Console logging addon — zero-dependency stdout/stderr sink that\n * produces the same canonical line format as the Winston built-in.\n * Registers as a `log-destination` capability provider so the shared\n * LogManager fans every entry to both sinks when both are active.\n *\n * Settings live under Cluster → NodeDetail → Settings alongside the\n * Winston addon. Disable one without disabling the other — the\n * LogManager keeps working as long as at least one destination is\n * registered.\n */\nexport class ConsoleLoggingAddon extends BaseAddon<ConsoleConfig> {\n  private destination: ConsoleDestination | null = null\n\n  constructor() {\n    super({ level: 'info' })\n  }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    this.destination = new ConsoleDestination()\n    await this.destination.initialize({ level: this.config.level })\n    this.ctx.logger.info('Console logging initialized')\n    return [{ capability: logDestinationCapability, provider: this.destination }]\n  }\n\n  protected async onShutdown(): Promise<void> {\n    await this.destination?.shutdown()\n  }\n\n  getDestination(): ConsoleDestination {\n    if (!this.destination) throw new Error('Console logging not initialized')\n    return this.destination\n  }\n\n  protected globalSettingsSchema() {\n    return this.schema({\n      sections: [\n        {\n          id: 'console-logging',\n          title: 'Console Logging',\n          description: 'Minimum log level to emit on stdout/stderr. Independent from the rotated-file (Winston) destination.',\n          columns: 2,\n          fields: [\n            this.field({\n              type: 'select',\n              key: 'level',\n              label: 'Log Level',\n              default: 'info',\n              options: [\n                { value: 'debug', label: 'Debug' },\n                { value: 'info', label: 'Info' },\n                { value: 'warn', label: 'Warn' },\n                { value: 'error', label: 'Error' },\n              ],\n            }),\n          ],\n        },\n      ],\n    })\n  }\n}\n"],"mappings":";;;;;;;;AAeA,IAAM,aAA+C;CACnD,OAAO;CAAG,MAAM;CAAG,MAAM;CAAG,OAAO;CACpC;AAED,IAAa,qBAAb,MAA2D;CACzD,WAAmB;CAEnB,MAAM,WAAW,QAAuC;EACtD,KAAK,WAAW,WAAW,QAAQ,SAAS,WAAW;;CAGzD,MAAM,OAAuB;EAE3B,KADa,WAAW,MAAM,UAAU,KAC7B,KAAK,UAAU;EAG1B,MAAM,OAAO,kBAAA,cAAc,OAAO,EAAE,UAAU,MAAM,CAAC;EACrD,IAAI,MAAM,UAAU,SAAS,QAAQ,MAAM,KAAK;OAC3C,IAAI,MAAM,UAAU,QAAQ,QAAQ,KAAK,KAAK;OAC9C,QAAQ,IAAI,KAAK;;CAGxB,MAAM,MAAM,SAAkD;EAE5D,OAAO,EAAE;;CAGX,MAAM,WAA0B;;;;;;;;;;;;;;;ACvBlC,IAAa,sBAAb,cAAyC,gBAAA,UAAyB;CAChE,cAAiD;CAEjD,cAAc;EACZ,MAAM,EAAE,OAAO,QAAQ,CAAC;;CAG1B,MAAgB,eAAgD;EAC9D,KAAK,cAAc,IAAI,oBAAoB;EAC3C,MAAM,KAAK,YAAY,WAAW,EAAE,OAAO,KAAK,OAAO,OAAO,CAAC;EAC/D,KAAK,IAAI,OAAO,KAAK,8BAA8B;EACnD,OAAO,CAAC;GAAE,YAAY,gBAAA;GAA0B,UAAU,KAAK;GAAa,CAAC;;CAG/E,MAAgB,aAA4B;EAC1C,MAAM,KAAK,aAAa,UAAU;;CAGpC,iBAAqC;EACnC,IAAI,CAAC,KAAK,aAAa,MAAM,IAAI,MAAM,kCAAkC;EACzE,OAAO,KAAK;;CAGd,uBAAiC;EAC/B,OAAO,KAAK,OAAO,EACjB,UAAU,CACR;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,SAAS;GACT,QAAQ,CACN,KAAK,MAAM;IACT,MAAM;IACN,KAAK;IACL,OAAO;IACP,SAAS;IACT,SAAS;KACP;MAAE,OAAO;MAAS,OAAO;MAAS;KAClC;MAAE,OAAO;MAAQ,OAAO;MAAQ;KAChC;MAAE,OAAO;MAAQ,OAAO;MAAQ;KAChC;MAAE,OAAO;MAAS,OAAO;MAAS;KACnC;IACF,CAAC,CACH;GACF,CACF,EACF,CAAC"}

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

@@ -0,0 +1,97 @@
+import { t as formatLogLine } from "../../formatter-C-5An4Bl.mjs";
+import { BaseAddon, logDestinationCapability } from "@camstack/types";
+//#region src/builtins/console-logging/console-destination.ts
+var LEVEL_RANK = {
+	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) {
+		if ((LEVEL_RANK[entry.level] ?? 1) < 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() {}
+};
+//#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 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: 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
+export { ConsoleDestination, ConsoleLoggingAddon, ConsoleLoggingAddon as default };
+
+//# sourceMappingURL=index.mjs.map

package/dist/builtins/console-logging/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/builtins/console-logging/console-destination.ts","../../../src/builtins/console-logging/console-logging.addon.ts"],"sourcesContent":["/**\n * Zero-dependency log destination that writes every entry to stdout /\n * stderr via the shared `formatLogLine` formatter. Same surface as\n * `WinstonDestination` (full `ILogDestination` contract) but without\n * the rotating-file transport — ideal fallback when the Winston addon\n * is disabled or unavailable (e.g. bare-bones agents, tests).\n */\nimport type { ILogDestination, LogEntry, LogFilter } from '@camstack/types'\nimport { formatLogLine } from '../../logging/formatter.js'\n\ninterface ConsoleConfig {\n  /** Minimum log level to emit. Entries below this level are dropped. */\n  readonly level?: 'debug' | 'info' | 'warn' | 'error'\n}\n\nconst LEVEL_RANK: Readonly<Record<string, number>> = {\n  debug: 0, info: 1, warn: 2, error: 3,\n}\n\nexport class ConsoleDestination implements ILogDestination {\n  private minLevel = 0\n\n  async initialize(config?: ConsoleConfig): Promise<void> {\n    this.minLevel = LEVEL_RANK[config?.level ?? 'info'] ?? 1\n  }\n\n  write(entry: LogEntry): void {\n    const rank = LEVEL_RANK[entry.level] ?? 1\n    if (rank < this.minLevel) return\n    // Always request ANSI colours for the console sink. The formatter still\n    // respects `NO_COLOR` so operators can opt out globally.\n    const line = formatLogLine(entry, { colorize: true })\n    if (entry.level === 'error') console.error(line)\n    else if (entry.level === 'warn') console.warn(line)\n    else console.log(line)\n  }\n\n  async query(_filter: LogFilter): Promise<readonly LogEntry[]> {\n    // Console has no persistence — queries are served by other destinations.\n    return []\n  }\n\n  async shutdown(): Promise<void> {\n    // Nothing to flush — stdout/stderr are process-owned.\n  }\n}\n","import type { ProviderRegistration } from '@camstack/types'\nimport { BaseAddon, logDestinationCapability } from '@camstack/types'\nimport { ConsoleDestination } from './console-destination.js'\n\ninterface ConsoleConfig {\n  readonly level: 'debug' | 'info' | 'warn' | 'error'\n}\n\n/**\n * Console logging addon — zero-dependency stdout/stderr sink that\n * produces the same canonical line format as the Winston built-in.\n * Registers as a `log-destination` capability provider so the shared\n * LogManager fans every entry to both sinks when both are active.\n *\n * Settings live under Cluster → NodeDetail → Settings alongside the\n * Winston addon. Disable one without disabling the other — the\n * LogManager keeps working as long as at least one destination is\n * registered.\n */\nexport class ConsoleLoggingAddon extends BaseAddon<ConsoleConfig> {\n  private destination: ConsoleDestination | null = null\n\n  constructor() {\n    super({ level: 'info' })\n  }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    this.destination = new ConsoleDestination()\n    await this.destination.initialize({ level: this.config.level })\n    this.ctx.logger.info('Console logging initialized')\n    return [{ capability: logDestinationCapability, provider: this.destination }]\n  }\n\n  protected async onShutdown(): Promise<void> {\n    await this.destination?.shutdown()\n  }\n\n  getDestination(): ConsoleDestination {\n    if (!this.destination) throw new Error('Console logging not initialized')\n    return this.destination\n  }\n\n  protected globalSettingsSchema() {\n    return this.schema({\n      sections: [\n        {\n          id: 'console-logging',\n          title: 'Console Logging',\n          description: 'Minimum log level to emit on stdout/stderr. Independent from the rotated-file (Winston) destination.',\n          columns: 2,\n          fields: [\n            this.field({\n              type: 'select',\n              key: 'level',\n              label: 'Log Level',\n              default: 'info',\n              options: [\n                { value: 'debug', label: 'Debug' },\n                { value: 'info', label: 'Info' },\n                { value: 'warn', label: 'Warn' },\n                { value: 'error', label: 'Error' },\n              ],\n            }),\n          ],\n        },\n      ],\n    })\n  }\n}\n"],"mappings":";;;AAeA,IAAM,aAA+C;CACnD,OAAO;CAAG,MAAM;CAAG,MAAM;CAAG,OAAO;CACpC;AAED,IAAa,qBAAb,MAA2D;CACzD,WAAmB;CAEnB,MAAM,WAAW,QAAuC;EACtD,KAAK,WAAW,WAAW,QAAQ,SAAS,WAAW;;CAGzD,MAAM,OAAuB;EAE3B,KADa,WAAW,MAAM,UAAU,KAC7B,KAAK,UAAU;EAG1B,MAAM,OAAO,cAAc,OAAO,EAAE,UAAU,MAAM,CAAC;EACrD,IAAI,MAAM,UAAU,SAAS,QAAQ,MAAM,KAAK;OAC3C,IAAI,MAAM,UAAU,QAAQ,QAAQ,KAAK,KAAK;OAC9C,QAAQ,IAAI,KAAK;;CAGxB,MAAM,MAAM,SAAkD;EAE5D,OAAO,EAAE;;CAGX,MAAM,WAA0B;;;;;;;;;;;;;;;ACvBlC,IAAa,sBAAb,cAAyC,UAAyB;CAChE,cAAiD;CAEjD,cAAc;EACZ,MAAM,EAAE,OAAO,QAAQ,CAAC;;CAG1B,MAAgB,eAAgD;EAC9D,KAAK,cAAc,IAAI,oBAAoB;EAC3C,MAAM,KAAK,YAAY,WAAW,EAAE,OAAO,KAAK,OAAO,OAAO,CAAC;EAC/D,KAAK,IAAI,OAAO,KAAK,8BAA8B;EACnD,OAAO,CAAC;GAAE,YAAY;GAA0B,UAAU,KAAK;GAAa,CAAC;;CAG/E,MAAgB,aAA4B;EAC1C,MAAM,KAAK,aAAa,UAAU;;CAGpC,iBAAqC;EACnC,IAAI,CAAC,KAAK,aAAa,MAAM,IAAI,MAAM,kCAAkC;EACzE,OAAO,KAAK;;CAGd,uBAAiC;EAC/B,OAAO,KAAK,OAAO,EACjB,UAAU,CACR;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,SAAS;GACT,QAAQ,CACN,KAAK,MAAM;IACT,MAAM;IACN,KAAK;IACL,OAAO;IACP,SAAS;IACT,SAAS;KACP;MAAE,OAAO;MAAS,OAAO;MAAS;KAClC;MAAE,OAAO;MAAQ,OAAO;MAAQ;KAChC;MAAE,OAAO;MAAQ,OAAO;MAAQ;KAChC;MAAE,OAAO;MAAS,OAAO;MAAS;KACnC;IACF,CAAC,CACH;GACF,CACF,EACF,CAAC"}

package/dist/builtins/device-manager/device-event-propagator.d.ts

@@ -0,0 +1,27 @@
+import { IEventBus, SystemEvent } from '@camstack/types';
+export interface DeviceEventPropagatorOptions {
+    readonly eventBus: IEventBus;
+    /**
+     * Resolve the numeric parent id of a device, or `null` when the
+     * device has no parent (or was deleted). The propagator injects a
+     * closure over the hub's `DeviceRegistry` so the lookup is in-
+     * process and O(1) per call.
+     */
+    readonly getParentOf: (deviceId: number) => number | null;
+    /** Structured logger for anti-cycle + anti-loop diagnostics. */
+    readonly logger: {
+        warn: (msg: string, meta?: Record<string, unknown>) => void;
+        debug: (msg: string, meta?: Record<string, unknown>) => void;
+    };
+}
+export declare class DeviceEventPropagator {
+    private readonly opts;
+    private unsubscribe;
+    constructor(opts: DeviceEventPropagatorOptions);
+    start(): void;
+    stop(): void;
+    /** Exposed for tests — lets them inject events without the full bus. */
+    handle(ev: SystemEvent): void;
+    private resolveParentChain;
+}
+//# sourceMappingURL=device-event-propagator.d.ts.map

package/dist/builtins/device-manager/device-event-propagator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-event-propagator.d.ts","sourceRoot":"","sources":["../../../src/builtins/device-manager/device-event-propagator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAe,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAqC1E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;IACzD,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE;QACf,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;QAC3D,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;KAC7D,CAAA;CACF;AAED,qBAAa,qBAAqB;IAGpB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,WAAW,CAA4B;gBAElB,IAAI,EAAE,4BAA4B;IAE/D,KAAK,IAAI,IAAI;IASb,IAAI,IAAI,IAAI;IAMZ,wEAAwE;IACxE,MAAM,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI;IAyB7B,OAAO,CAAC,kBAAkB;CAyB3B"}