@camstack/system 1.2.390 → 1.2.392

package/dist/kernel/config-schema.d.ts

@@ -1,135 +1,139 @@
-import { z } from 'zod';
+import { z } from "zod";
 /** Default data directory — used when CAMSTACK_DATA env var is not set */
 export declare const DEFAULT_DATA_PATH = "camstack-data";
+/** Bootstrap `server` section — see {@link serverSchema}. */
+export type BootstrapServerConfig = {
+	port: number;
+	host: string;
+	dataPath: string;
+	corsOrigins: string[];
+};
+/** Bootstrap `hub` section — see {@link hubSchema}. */
+export type BootstrapHubConfig = {
+	url: string;
+	token: string;
+};
+/** Bootstrap `agent` section — see {@link agentSchema}. */
+export type BootstrapAgentConfig = {
+	name: string;
+	statusPort: number;
+};
+/** Bootstrap `tls` section — see {@link tlsSchema}. */
+export type BootstrapTlsConfig = {
+	enabled: boolean;
+};
+/** Bootstrap `bootstrap` section — see {@link bootstrapAddonsSchema}. */
+export type BootstrapAddonsConfig = {
+	settingsStoreAddon: string;
+	installSource?: "npm" | "local" | "symlink";
+	requiredAddons?: string[];
+	forceDisable: string[];
+};
+/** Bootstrap `keychain` section — see {@link keychainSchema}. */
+export type BootstrapKeychainConfig = {
+	keyFile?: string;
+	previousKeyFile?: string;
+};
+/** Bootstrap config -- loaded from config.yaml ONLY at startup. */
+export type BootstrapConfig = {
+	mode: "hub" | "agent";
+	server: BootstrapServerConfig;
+	auth: Record<string, never>;
+	hub: BootstrapHubConfig;
+	agent: BootstrapAgentConfig;
+	tls: BootstrapTlsConfig;
+	bootstrap: BootstrapAddonsConfig;
+	keychain: BootstrapKeychainConfig;
+};
 /** `auth.*` keys a pre-D797 config.yaml may still carry; ignored, and warned about. */
 export declare const RETIRED_AUTH_CONFIG_KEYS: readonly ["jwtSecret", "adminUsername", "adminPassword"];
-/** Bootstrap config -- loaded from config.yaml ONLY at startup.
- *  All other settings live in SQL (system_settings table). */
-export declare const bootstrapSchema: z.ZodObject<{
-    mode: z.ZodDefault<z.ZodEnum<{
-        agent: "agent";
-        hub: "hub";
-    }>>;
-    server: z.ZodDefault<z.ZodObject<{
-        port: z.ZodDefault<z.ZodNumber>;
-        host: z.ZodDefault<z.ZodString>;
-        dataPath: z.ZodDefault<z.ZodString>;
-        corsOrigins: z.ZodDefault<z.ZodPreprocess<z.ZodArray<z.ZodString>>>;
-    }, z.core.$strip>>;
-    auth: z.ZodDefault<z.ZodObject<{}, z.core.$strip>>;
-    hub: z.ZodDefault<z.ZodObject<{
-        url: z.ZodDefault<z.ZodString>;
-        token: z.ZodDefault<z.ZodString>;
-    }, z.core.$strip>>;
-    agent: z.ZodDefault<z.ZodObject<{
-        name: z.ZodDefault<z.ZodString>;
-        statusPort: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>;
-    tls: z.ZodDefault<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip>>;
-    bootstrap: z.ZodDefault<z.ZodObject<{
-        settingsStoreAddon: z.ZodDefault<z.ZodString>;
-        installSource: z.ZodOptional<z.ZodEnum<{
-            local: "local";
-            npm: "npm";
-            symlink: "symlink";
-        }>>;
-        requiredAddons: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        forceDisable: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-    keychain: z.ZodDefault<z.ZodObject<{
-        keyFile: z.ZodOptional<z.ZodString>;
-        previousKeyFile: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type BootstrapConfig = z.infer<typeof bootstrapSchema>;
+export declare const bootstrapSchema: z.ZodType<BootstrapConfig>;
 /**
- * Runtime defaults — re-exported from @camstack/types (canonical location).
- * Kept here for backward compatibility with existing kernel consumers.
- */
-export { RUNTIME_DEFAULTS } from '@camstack/types';
-export type ServerMode = 'hub' | 'agent';
+* Runtime defaults — re-exported from @camstack/types (canonical location).
+* Kept here for backward compatibility with existing kernel consumers.
+*/
+export { RUNTIME_DEFAULTS } from "@camstack/types";
+export type ServerMode = "hub" | "agent";
 export type AppConfig = BootstrapConfig & {
-    features: {
-        streaming: boolean;
-        notifications: boolean;
-        objectDetection: boolean;
-        remoteAccess: boolean;
-        agentCluster: boolean;
-        smartHome: boolean;
-        recordings: boolean;
-        backup: boolean;
-        repl: boolean;
-    };
-    storage: {
-        provider: string;
-        locations: Record<string, string>;
-    };
-    logging: {
-        level: string;
-        retentionDays: number;
-    };
-    eventBus: {
-        /** System-EVENT ring size. Separate from the log buffer below. */
-        ringBufferSize: number;
-        /**
-         * Per-addon log ring-buffer capacity, in entries. Default 5000.
-         *
-         * A HARD bound on EACH addon's bucket, not the total — the buffer is
-         * partitioned by `addonId` (`PartitionedLogBuffer`), so a chatty addon evicts
-         * only its own lines and a quiet one keeps its sparse history. Worst-case
-         * memory is therefore `this × number of addons that have logged`, which is
-         * why the total below exists.
-         *
-         * Hub-only: the agent constructs its `LogManager` with a hardcoded 5000.
-         */
-        perAddonLogBufferSize?: number;
-        /**
-         * Ceiling on retained entries across every addon bucket.
-         *
-         * UNSET (the normal case) takes `DEFAULT_MAX_TOTAL_LOG_ENTRIES` — the buffer is
-         * bounded in aggregate out of the box. It has to be: `perAddonLogBufferSize ×
-         * addons` grows with the roster, and hub-main ingests from every local runner
-         * AND every agent, so the measured ~60-bucket hub retained ~300k entries
-         * (~92MB at ~306 B/entry) with no aggregate bound at all.
-         *
-         * Set a number to tune it. Set an explicit `null` to opt out entirely — the
-         * per-addon rings then become the only bound again.
-         *
-         * It is met by discarding entries at or below `logBufferPruneLevel` FIRST, so a
-         * live addon's `warn`/`error` are never traded for lines about frame timings.
-         * Only when that cannot reach the target are whole least-recently-WRITTEN
-         * buckets dropped — a bound that pruning alone cannot hold is not a bound, and
-         * the bucket nobody has written to is the cheapest thing in the buffer to lose.
-         */
-        maxTotalLogBufferSize?: number | null;
-        /**
-         * Highest severity the total-cap sweep may discard. Default `debug`.
-         *
-         * `debug` reclaims nearly all the space on any busy buffer while leaving
-         * `info`/`warn`/`error` untouched. Raise it to `info` only if debug alone is
-         * not enough; `warn` and `error` are then still safe. Setting it to `error`
-         * means "evict anything", which defeats the point.
-         */
-        logBufferPruneLevel?: 'debug' | 'info' | 'warn' | 'error';
-    };
-    retention: {
-        detectionEventsDays: number;
-        audioLevelsDays: number;
-    };
-    providers: Array<{
-        id: string;
-        type: string;
-        name: string;
-        url?: string;
-        username?: string;
-        password?: string;
-        mqtt?: {
-            brokerUrl: string;
-            username?: string;
-            password?: string;
-            topicPrefix: string;
-        };
-    }>;
+	features: {
+		streaming: boolean;
+		notifications: boolean;
+		objectDetection: boolean;
+		remoteAccess: boolean;
+		agentCluster: boolean;
+		smartHome: boolean;
+		recordings: boolean;
+		backup: boolean;
+		repl: boolean;
+	};
+	storage: {
+		provider: string;
+		locations: Record<string, string>;
+	};
+	logging: {
+		level: string;
+		retentionDays: number;
+	};
+	eventBus: {
+		/** System-EVENT ring size. Separate from the log buffer below. */
+		ringBufferSize: number;
+		/**
+		* Per-addon log ring-buffer capacity, in entries. Default 5000.
+		*
+		* A HARD bound on EACH addon's bucket, not the total — the buffer is
+		* partitioned by `addonId` (`PartitionedLogBuffer`), so a chatty addon evicts
+		* only its own lines and a quiet one keeps its sparse history. Worst-case
+		* memory is therefore `this × number of addons that have logged`, which is
+		* why the total below exists.
+		*
+		* Hub-only: the agent constructs its `LogManager` with a hardcoded 5000.
+		*/
+		perAddonLogBufferSize?: number;
+		/**
+		* Ceiling on retained entries across every addon bucket.
+		*
+		* UNSET (the normal case) takes `DEFAULT_MAX_TOTAL_LOG_ENTRIES` — the buffer is
+		* bounded in aggregate out of the box. It has to be: `perAddonLogBufferSize ×
+		* addons` grows with the roster, and hub-main ingests from every local runner
+		* AND every agent, so the measured ~60-bucket hub retained ~300k entries
+		* (~92MB at ~306 B/entry) with no aggregate bound at all.
+		*
+		* Set a number to tune it. Set an explicit `null` to opt out entirely — the
+		* per-addon rings then become the only bound again.
+		*
+		* It is met by discarding entries at or below `logBufferPruneLevel` FIRST, so a
+		* live addon's `warn`/`error` are never traded for lines about frame timings.
+		* Only when that cannot reach the target are whole least-recently-WRITTEN
+		* buckets dropped — a bound that pruning alone cannot hold is not a bound, and
+		* the bucket nobody has written to is the cheapest thing in the buffer to lose.
+		*/
+		maxTotalLogBufferSize?: number | null;
+		/**
+		* Highest severity the total-cap sweep may discard. Default `debug`.
+		*
+		* `debug` reclaims nearly all the space on any busy buffer while leaving
+		* `info`/`warn`/`error` untouched. Raise it to `info` only if debug alone is
+		* not enough; `warn` and `error` are then still safe. Setting it to `error`
+		* means "evict anything", which defeats the point.
+		*/
+		logBufferPruneLevel?: "debug" | "info" | "warn" | "error";
+	};
+	retention: {
+		detectionEventsDays: number;
+		audioLevelsDays: number;
+	};
+	providers: Array<{
+		id: string;
+		type: string;
+		name: string;
+		url?: string;
+		username?: string;
+		password?: string;
+		mqtt?: {
+			brokerUrl: string;
+			username?: string;
+			password?: string;
+			topicPrefix: string;
+		};
+	}>;
 };

package/dist/kernel/custom-action-registry.d.ts

@@ -1,32 +1,32 @@
-import { ChildCustomActionCatalogs, CustomActionCaller, CustomActionSpec, CustomActionsSpec } from '@camstack/types';
+import type { ChildCustomActionCatalogs, CustomActionCaller, CustomActionSpec, CustomActionsSpec } from "@camstack/types";
 type Handler = (action: string, input: unknown, caller?: CustomActionCaller) => Promise<unknown>;
 export interface CustomActionEntry {
-    readonly spec: CustomActionSpec;
-    readonly handler: (input: unknown, caller?: CustomActionCaller) => Promise<unknown>;
+	readonly spec: CustomActionSpec;
+	readonly handler: (input: unknown, caller?: CustomActionCaller) => Promise<unknown>;
 }
 /**
- * CustomActionRegistry — per-process registry of addon custom actions.
- *
- * Populated at boot from each addon's `AddonInitResult.customActions` +
- * `handleCustomAction` handler. Rejects actions declared with scope other
- * than 'system' (today only 'system' is runtime-supported; the descriptor
- * allows future scopes for forward compat).
- */
+* CustomActionRegistry — per-process registry of addon custom actions.
+*
+* Populated at boot from each addon's `AddonInitResult.customActions` +
+* `handleCustomAction` handler. Rejects actions declared with scope other
+* than 'system' (today only 'system' is runtime-supported; the descriptor
+* allows future scopes for forward compat).
+*/
 export declare class CustomActionRegistry {
-    private readonly byAddon;
-    registerAddon(addonId: string, catalog: CustomActionsSpec, handler: Handler): void;
-    unregisterAddon(addonId: string): void;
-    resolve(addonId: string, action: string): CustomActionEntry | null;
-    listActions(addonId: string): readonly string[];
-    listAddons(): readonly string[];
-    /**
-     * Every registered catalog with its schemas stripped, keyed by addon id —
-     * what a runner puts in its register frame so the hub learns the catalogs
-     * from the process that owns them (D444). `hostedAddonIds` are the addons
-     * this runner hosts: each is present in the result, with an EMPTY catalog
-     * when it registered none, so the parent can say "declares no actions" per
-     * addon instead of guessing from an absent key.
-     */
-    describeAll(hostedAddonIds: readonly string[]): ChildCustomActionCatalogs;
+	private readonly byAddon;
+	registerAddon(addonId: string, catalog: CustomActionsSpec, handler: Handler): void;
+	unregisterAddon(addonId: string): void;
+	resolve(addonId: string, action: string): CustomActionEntry | null;
+	listActions(addonId: string): readonly string[];
+	listAddons(): readonly string[];
+	/**
+	* Every registered catalog with its schemas stripped, keyed by addon id —
+	* what a runner puts in its register frame so the hub learns the catalogs
+	* from the process that owns them (D444). `hostedAddonIds` are the addons
+	* this runner hosts: each is present in the result, with an EMPTY catalog
+	* when it registered none, so the parent can say "declares no actions" per
+	* addon instead of guessing from an absent key.
+	*/
+	describeAll(hostedAddonIds: readonly string[]): ChildCustomActionCatalogs;
 }
 export {};

package/dist/kernel/deps/addon-deps-manager.d.ts

@@ -1,19 +1,19 @@
-import { IScopedLogger, IAddonDepsManager } from '@camstack/types';
+import type { IScopedLogger, IAddonDepsManager } from "@camstack/types";
 export declare class AddonDepsManager implements IAddonDepsManager {
-    private readonly logger;
-    private readonly nodeRoot;
-    private readonly depsDir;
-    constructor(_dataDir: string, logger: IScopedLogger);
-    ensureBinary(opts: {
-        readonly name: string;
-        readonly downloadUrl: string;
-        readonly isArchive?: boolean;
-        readonly archiveFormat?: 'zip' | 'tar.gz' | 'tar.xz';
-        readonly archiveInnerPath?: string;
-    }): Promise<string>;
-    ensureFfmpeg(): Promise<string>;
-    ensurePython(): Promise<string | null>;
-    installPythonPackages(packages: readonly string[]): Promise<void>;
-    installPythonRequirements(requirementsFile: string): Promise<void>;
-    getDepsDir(): string;
+	private readonly logger;
+	private readonly nodeRoot;
+	private readonly depsDir;
+	constructor(_dataDir: string, logger: IScopedLogger);
+	ensureBinary(opts: {
+		readonly name: string;
+		readonly downloadUrl: string;
+		readonly isArchive?: boolean;
+		readonly archiveFormat?: "zip" | "tar.gz" | "tar.xz";
+		readonly archiveInnerPath?: string;
+	}): Promise<string>;
+	ensureFfmpeg(): Promise<string>;
+	ensurePython(): Promise<string | null>;
+	installPythonPackages(packages: readonly string[]): Promise<void>;
+	installPythonRequirements(requirementsFile: string): Promise<void>;
+	getDepsDir(): string;
 }

package/dist/kernel/deps/closure-dedupe.d.ts

@@ -1,105 +1,105 @@
-import { IScopedLogger } from '@camstack/types';
+import type { IScopedLogger } from "@camstack/types";
 /**
- * Does `version` satisfy `range`, for the range forms this module is willing
- * to vouch for?
- *
- * Supported: exact (`1.2.3`, `=1.2.3`), caret (`^1.2.3`, incl. the 0.x rules)
- * and tilde (`~1.2.3`). EVERYTHING else — `*`, `>=`, unions, hyphen ranges,
- * dist-tags, bases with prereleases — returns false: an unprovable range must
- * keep the addon's own copy, never borrow the closure's.
- *
- * A prerelease `version` satisfies only an exact string match — semver range
- * semantics around prereleases are precisely the kind of subtlety a
- * hand-rolled parser must refuse rather than approximate.
- */
+* Does `version` satisfy `range`, for the range forms this module is willing
+* to vouch for?
+*
+* Supported: exact (`1.2.3`, `=1.2.3`), caret (`^1.2.3`, incl. the 0.x rules)
+* and tilde (`~1.2.3`). EVERYTHING else — `*`, `>=`, unions, hyphen ranges,
+* dist-tags, bases with prereleases — returns false: an unprovable range must
+* keep the addon's own copy, never borrow the closure's.
+*
+* A prerelease `version` satisfies only an exact string match — semver range
+* semantics around prereleases are precisely the kind of subtlety a
+* hand-rolled parser must refuse rather than approximate.
+*/
 export declare function closureSatisfiesRange(range: string, version: string): boolean;
 /**
- * Belt over the range check: the closure copy must live in the same major
- * line as the copy npm actually materialised (same minor while major is 0).
- * The range check should already guarantee this; if the two ever disagree
- * the safe answer is "do not link".
- */
+* Belt over the range check: the closure copy must live in the same major
+* line as the copy npm actually materialised (same minor while major is 0).
+* The range check should already guarantee this; if the two ever disagree
+* the safe answer is "do not link".
+*/
 export declare function sameCompatLine(a: string, b: string): boolean;
 /** A real (non-symlink) top-level entry of an addon's node_modules. */
 export interface DedupeCandidate {
-    readonly name: string;
-    readonly version: string;
+	readonly name: string;
+	readonly version: string;
 }
-export type ClosureKeepReason = 'camstack-package' | 'never-link' | 'not-in-closure' | 'version-incompatible';
+export type ClosureKeepReason = "camstack-package" | "never-link" | "not-in-closure" | "version-incompatible";
 export interface ClosureLink {
-    readonly name: string;
-    readonly closureVersion: string;
+	readonly name: string;
+	readonly closureVersion: string;
 }
 export interface ClosureKeep {
-    readonly name: string;
-    readonly reason: ClosureKeepReason;
+	readonly name: string;
+	readonly reason: ClosureKeepReason;
 }
 export interface ClosureDedupePlan {
-    readonly links: readonly ClosureLink[];
-    readonly keeps: readonly ClosureKeep[];
+	readonly links: readonly ClosureLink[];
+	readonly keeps: readonly ClosureKeep[];
 }
 export interface ClosureDedupeInput {
-    readonly candidates: readonly DedupeCandidate[];
-    /** name → version installed in the server closure's node_modules. */
-    readonly closureVersions: ReadonlyMap<string, string>;
-    /**
-     * name → every requirement range the addon tree records for it (the addon's
-     * own manifest + every dependent that resolves to the top-level copy).
-     */
-    readonly requirements: ReadonlyMap<string, readonly string[]>;
-    /** Names that must never be linked (e.g. `camstack.nativeDependencies`). */
-    readonly neverLink: ReadonlySet<string>;
+	readonly candidates: readonly DedupeCandidate[];
+	/** name → version installed in the server closure's node_modules. */
+	readonly closureVersions: ReadonlyMap<string, string>;
+	/**
+	* name → every requirement range the addon tree records for it (the addon's
+	* own manifest + every dependent that resolves to the top-level copy).
+	*/
+	readonly requirements: ReadonlyMap<string, readonly string[]>;
+	/** Names that must never be linked (e.g. `camstack.nativeDependencies`). */
+	readonly neverLink: ReadonlySet<string>;
 }
 /**
- * Decide, per top-level entry, whether the closure's copy can serve in place
- * of the addon's own. Identical versions always link; otherwise every
- * recorded requirement range must accept the closure version, and the two
- * copies must share a compat line. Anything unprovable keeps the local copy.
- */
+* Decide, per top-level entry, whether the closure's copy can serve in place
+* of the addon's own. Identical versions always link; otherwise every
+* recorded requirement range must accept the closure version, and the two
+* copies must share a compat line. Anything unprovable keeps the local copy.
+*/
 export declare function planClosureDedupe(input: ClosureDedupeInput): ClosureDedupePlan;
 export interface AddonTreeState {
-    /** Real directories eligible for linking (symlinks are excluded). */
-    readonly candidates: readonly DedupeCandidate[];
-    /** name → requirement ranges collected across the tree. */
-    readonly requirements: ReadonlyMap<string, readonly string[]>;
-    /** Top-level entries that are already symlinks (with their targets). */
-    readonly existingLinks: readonly {
-        readonly name: string;
-        readonly target: string;
-    }[];
+	/** Real directories eligible for linking (symlinks are excluded). */
+	readonly candidates: readonly DedupeCandidate[];
+	/** name → requirement ranges collected across the tree. */
+	readonly requirements: ReadonlyMap<string, readonly string[]>;
+	/** Top-level entries that are already symlinks (with their targets). */
+	readonly existingLinks: readonly {
+		readonly name: string;
+		readonly target: string;
+	}[];
 }
 /**
- * Read an addon tree's dedupe-relevant state: which top-level packages exist
- * (and their versions), and which requirement ranges apply to each. A
- * dependent's range for `X` is recorded only when that dependent resolves to
- * the TOP-LEVEL `X` — a nested override copy (`dep/node_modules/X`) means the
- * flat copy is not what that dependent loads, so its range must not block the
- * flat copy's dedupe.
- */
+* Read an addon tree's dedupe-relevant state: which top-level packages exist
+* (and their versions), and which requirement ranges apply to each. A
+* dependent's range for `X` is recorded only when that dependent resolves to
+* the TOP-LEVEL `X` — a nested override copy (`dep/node_modules/X`) means the
+* flat copy is not what that dependent loads, so its range must not block the
+* flat copy's dedupe.
+*/
 export declare function collectAddonTreeState(addonDir: string): AddonTreeState;
 /** Read `name → version` from a closure node_modules for the given names. */
 export declare function readClosureVersions(closureNodeModulesDir: string, names: Iterable<string>): Map<string, string>;
 /**
- * Where the running node's server closure keeps its node_modules, or null
- * when there is none to dedupe against (dev workspace, tests without a
- * closure). `CAMSTACK_FRAMEWORK_DIR` is set by the starter/launcher on every
- * deployed node — the same directory the framework resolver hook and
- * NODE_PATH extension already point at.
- */
+* Where the running node's server closure keeps its node_modules, or null
+* when there is none to dedupe against (dev workspace, tests without a
+* closure). `CAMSTACK_FRAMEWORK_DIR` is set by the starter/launcher on every
+* deployed node — the same directory the framework resolver hook and
+* NODE_PATH extension already point at.
+*/
 export declare function resolveClosureNodeModulesDir(explicitDir: string | undefined): string | null;
 /**
- * Replace each planned entry with a symlink into the closure. Probes symlink
- * support once (Windows without developer mode cannot create them — in that
- * case every copy is kept, which is exactly today's behaviour). Each link
- * re-verifies the closure version right before the swap so a closure updated
- * mid-flight can only cause a KEEP, never a wrong link.
- *
- * Returns the names actually linked.
- */
+* Replace each planned entry with a symlink into the closure. Probes symlink
+* support once (Windows without developer mode cannot create them — in that
+* case every copy is kept, which is exactly today's behaviour). Each link
+* re-verifies the closure version right before the swap so a closure updated
+* mid-flight can only cause a KEEP, never a wrong link.
+*
+* Returns the names actually linked.
+*/
 export declare function executeClosureDedupe(addonDir: string, closureNodeModulesDir: string, plan: ClosureDedupePlan, logger: IScopedLogger): readonly string[];
 /**
- * Is `linkTarget` (as read from `readlink`) a path inside the closure's
- * node_modules? Only such links belong to this mechanism — workspace/npm
- * `file:` links must never be touched by dedupe maintenance.
- */
+* Is `linkTarget` (as read from `readlink`) a path inside the closure's
+* node_modules? Only such links belong to this mechanism — workspace/npm
+* `file:` links must never be touched by dedupe maintenance.
+*/
 export declare function isClosureLinkTarget(linkTarget: string, closureNodeModulesDir: string): boolean;

package/dist/kernel/deps/ensure-addon-natives.d.ts

@@ -1,41 +1,41 @@
-import { IScopedLogger } from '@camstack/types';
-import { PrebuildFetchFn, PrebuildTarget } from './ensure-native-prebuilds.js';
+import type { IScopedLogger } from "@camstack/types";
+import { type PrebuildFetchFn, type PrebuildTarget } from "./ensure-native-prebuilds.js";
 /** Per-native outcome of the ensure pass. */
-export type NativeEnsureOutcome = 'already-present' | 'copied' | 'fetched' | 'missing';
+export type NativeEnsureOutcome = "already-present" | "copied" | "fetched" | "missing";
 export interface NativeEnsureResult {
-    readonly pkg: string;
-    readonly outcome: NativeEnsureOutcome;
+	readonly pkg: string;
+	readonly outcome: NativeEnsureOutcome;
 }
 export interface EnsureAddonNativePrebuildsOptions {
-    /** Addon package name — for loud error messages naming module + addon. */
-    readonly addonName: string;
-    readonly logger: IScopedLogger;
-    /**
-     * Bundled addon copy dir (the `installCopy` `sourceDir` / a
-     * `CAMSTACK_BUNDLED_ADDONS_DIR/<addon>` copy) whose own
-     * `node_modules/<pkg>` may carry a prebuilt `.node` for THIS machine.
-     * Copied in directly before any network fetch. Absent on the npm/tgz path.
-     */
-    readonly bundledSourceDir?: string;
-    /** Running ABI/arch the fetched prebuild must match. Defaults to the process. */
-    readonly target?: PrebuildTarget;
-    /** Native package set. Defaults to `TRADITIONAL_NATIVE_PACKAGES`. */
-    readonly packages?: readonly string[];
-    /** Override the fetcher (tests). Production uses the bundled `prebuild-install`. */
-    readonly fetchPrebuild?: PrebuildFetchFn;
-    /** Override the `.node` presence scan (tests). */
-    readonly hasNative?: (moduleDir: string) => boolean;
+	/** Addon package name — for loud error messages naming module + addon. */
+	readonly addonName: string;
+	readonly logger: IScopedLogger;
+	/**
+	* Bundled addon copy dir (the `installCopy` `sourceDir` / a
+	* `CAMSTACK_BUNDLED_ADDONS_DIR/<addon>` copy) whose own
+	* `node_modules/<pkg>` may carry a prebuilt `.node` for THIS machine.
+	* Copied in directly before any network fetch. Absent on the npm/tgz path.
+	*/
+	readonly bundledSourceDir?: string;
+	/** Running ABI/arch the fetched prebuild must match. Defaults to the process. */
+	readonly target?: PrebuildTarget;
+	/** Native package set. Defaults to `TRADITIONAL_NATIVE_PACKAGES`. */
+	readonly packages?: readonly string[];
+	/** Override the fetcher (tests). Production uses the bundled `prebuild-install`. */
+	readonly fetchPrebuild?: PrebuildFetchFn;
+	/** Override the `.node` presence scan (tests). */
+	readonly hasNative?: (moduleDir: string) => boolean;
 }
 /**
- * Ensure every referenced traditional native in `<addonDir>/node_modules`
- * carries its compiled `.node` after the addon's `npm install`. Bundled-copy
- * first (offline), prebuild-fetch fallback, LOUD throw on a residual miss.
- *
- * SKIPS a native absent from the addon's own `node_modules` (it resolves via a
- * hoisted host copy — not this addon's concern). A NO-OP in docker / dev where
- * npm produced a working `.node` (already-present). Returns the per-native
- * outcomes for logging/tests.
- *
- * @throws if any required native is still source-only after copy + fetch.
- */
+* Ensure every referenced traditional native in `<addonDir>/node_modules`
+* carries its compiled `.node` after the addon's `npm install`. Bundled-copy
+* first (offline), prebuild-fetch fallback, LOUD throw on a residual miss.
+*
+* SKIPS a native absent from the addon's own `node_modules` (it resolves via a
+* hoisted host copy — not this addon's concern). A NO-OP in docker / dev where
+* npm produced a working `.node` (already-present). Returns the per-native
+* outcomes for logging/tests.
+*
+* @throws if any required native is still source-only after copy + fetch.
+*/
 export declare function ensureAddonNativePrebuilds(addonDir: string, options: EnsureAddonNativePrebuildsOptions): Promise<readonly NativeEnsureResult[]>;