@camstack/types 1.0.3 → 1.0.4

package/dist/index.js

@@ -622,14 +622,15 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["DeviceSleeping"] = "device.sleeping";
 	EventCategory["RetentionCleanup"] = "retention.cleanup";
 	/**
-	* Progress snapshot emitted by `BulkUpdateCoordinator` on every state
-	* transition (item status change, phase change, completion, cancel).
-	* Payload is `BulkUpdateState`. Admin UI subscribes via `useLiveEvent`
-	* to drive the sticky `BulkUpdateBanner` and per-row `AddonRowBadge`.
-	*
-	* Spec: docs/superpowers/specs/2026-05-21-addons-bulk-update-progress-design.md
+	* Legacy bulk-update progress snapshot (payload `BulkUpdateState`). No longer
+	* emitted — F3 removed the coordinator that produced it; "Update all" now runs
+	* as one lifecycle engine job (`AddonsJobProgress`/`AddonsJobLog`). Retained
+	* (with `BulkUpdateState`) only to avoid regenerating the event maps; removed
+	* in F4 once live bulk progress is re-implemented over the engine events.
 	*/
 	EventCategory["AddonsBulkUpdateProgress"] = "addons.bulk-update-progress";
+	EventCategory["AddonsJobProgress"] = "addons.job-progress";
+	EventCategory["AddonsJobLog"] = "addons.job-log";
 	/**
 	* A container's child visibility toggled (hidden/shown). Emitted by the
 	* `accessories` cap when a child device is hidden or revealed.
@@ -13087,10 +13088,6 @@ function createSystemProxy(api) {
 			listCapabilityProviders: (input) => dispatch("addons", "listCapabilityProviders", "query", input),
 			setCapabilityProviderEnabled: (input) => dispatch("addons", "setCapabilityProviderEnabled", "mutation", input),
 			updateFrameworkPackage: (input) => dispatch("addons", "updateFrameworkPackage", "mutation", input),
-			startBulkUpdate: (input) => dispatch("addons", "startBulkUpdate", "mutation", input),
-			getBulkUpdateState: (input) => dispatch("addons", "getBulkUpdateState", "query", input),
-			cancelBulkUpdate: (input) => dispatch("addons", "cancelBulkUpdate", "mutation", input),
-			listActiveBulkUpdates: (input) => dispatch("addons", "listActiveBulkUpdates", "query", input),
 			getVersions: (input) => dispatch("addons", "getVersions", "query", input),
 			restartAddon: (input) => dispatch("addons", "restartAddon", "mutation", input),
 			retryLoad: (input) => dispatch("addons", "retryLoad", "mutation", input),
@@ -13100,6 +13097,10 @@ function createSystemProxy(api) {
 			setAddonAutoUpdate: (input) => dispatch("addons", "setAddonAutoUpdate", "mutation", input),
 			applyAutoUpdateToAll: (input) => dispatch("addons", "applyAutoUpdateToAll", "mutation", input),
 			custom: (input) => dispatch("addons", "custom", "mutation", input),
+			startJob: (input) => dispatch("addons", "startJob", "mutation", input),
+			getJob: (input) => dispatch("addons", "getJob", "query", input),
+			listJobs: (input) => dispatch("addons", "listJobs", "query", input),
+			cancelJob: (input) => dispatch("addons", "cancelJob", "mutation", input),
 			onAddonLogs: (input, push) => dispatch("addons", "onAddonLogs", "subscription", input, push)
 		},
 		addonSettings: {
@@ -22098,6 +22099,71 @@ var integrationsCapability = {
 	}
 };
 //#endregion
+//#region src/lifecycle/job.ts
+var jobKindSchema = zod.z.enum([
+	"install",
+	"update",
+	"uninstall",
+	"restart"
+]);
+var taskPhaseSchema = zod.z.enum([
+	"queued",
+	"fetching",
+	"staged",
+	"validating",
+	"applying",
+	"restarting",
+	"applied",
+	"done",
+	"failed",
+	"skipped"
+]);
+var taskTargetSchema = zod.z.enum(["framework", "addon"]);
+var taskLogEntrySchema = zod.z.object({
+	tsMs: zod.z.number(),
+	nodeId: zod.z.string(),
+	packageName: zod.z.string(),
+	phase: taskPhaseSchema,
+	message: zod.z.string()
+});
+var lifecycleTaskSchema = zod.z.object({
+	taskId: zod.z.string(),
+	nodeId: zod.z.string(),
+	packageName: zod.z.string(),
+	fromVersion: zod.z.string().nullable(),
+	toVersion: zod.z.string(),
+	target: taskTargetSchema,
+	phase: taskPhaseSchema,
+	stagedPath: zod.z.string().nullable(),
+	attempts: zod.z.number(),
+	steps: zod.z.array(taskLogEntrySchema),
+	error: zod.z.string().nullable(),
+	startedAtMs: zod.z.number().nullable(),
+	finishedAtMs: zod.z.number().nullable()
+});
+var lifecycleJobStateSchema = zod.z.enum([
+	"running",
+	"completed",
+	"failed",
+	"partially-failed",
+	"cancelled"
+]);
+var lifecycleJobScopeSchema = zod.z.enum([
+	"single",
+	"bulk",
+	"cluster"
+]);
+var lifecycleJobSchema = zod.z.object({
+	jobId: zod.z.string(),
+	kind: jobKindSchema,
+	createdAtMs: zod.z.number(),
+	createdBy: zod.z.string(),
+	scope: lifecycleJobScopeSchema,
+	tasks: zod.z.array(lifecycleTaskSchema),
+	state: lifecycleJobStateSchema,
+	schemaVersion: zod.z.literal(1)
+});
+//#endregion
 //#region src/capabilities/addons.cap.ts
 /**
 * addons — system-scoped singleton capability for addon package
@@ -22281,7 +22347,7 @@ var BulkUpdatePhaseSchema = zod.z.enum([
 	"restarting",
 	"finalizing"
 ]);
-var BulkUpdateStateSchema = zod.z.object({
+zod.z.object({
 	id: zod.z.string(),
 	nodeId: zod.z.string(),
 	startedAtMs: zod.z.number(),
@@ -22517,54 +22583,6 @@ var addonsCapability = {
 			kind: "mutation",
 			auth: "admin"
 		}),
-		/**
-		* Kicks off a server-side bulk update operation and returns the bulk
-		* id immediately. The operation runs asynchronously; observe progress
-		* via the `AddonsBulkUpdateProgress` event or `getBulkUpdateState`.
-		* Items with `isSystem: true` use `deferRestart` — the hub restarts
-		* ONCE at the end of the system phase, after all system packages are
-		* installed.
-		*
-		* `items[].version` is REQUIRED — callers must pass the resolved
-		* version from `listUpdates`. There is no `'latest'` default here
-		* (unlike `updatePackage`) to guarantee deterministic bulk rolls.
-		*/
-		startBulkUpdate: method(zod.z.object({
-			nodeId: zod.z.string(),
-			items: zod.z.array(zod.z.object({
-				name: zod.z.string(),
-				version: zod.z.string(),
-				isSystem: zod.z.boolean()
-			})).readonly()
-		}), zod.z.object({ id: zod.z.string() }), {
-			kind: "mutation",
-			auth: "admin"
-		}),
-		/**
-		* Returns the current state of a bulk update by id.
-		* Returns `null` if the id is unknown or has been auto-cleaned
-		* (5 minutes after `completedAt` the record is evicted from memory).
-		*/
-		getBulkUpdateState: method(zod.z.object({ id: zod.z.string() }), BulkUpdateStateSchema.nullable(), { auth: "admin" }),
-		/**
-		* Cancels an in-flight bulk update. The update loop exits after the
-		* currently-processing item completes — cancellation is not
-		* instantaneous. Has no effect once the `restarting` phase has been
-		* entered (the hub is already shutting down at that point).
-		* Returns `{ cancelled: false }` if the id is unknown, the operation
-		* has already completed, or the `restarting` phase is active.
-		*/
-		cancelBulkUpdate: method(zod.z.object({ id: zod.z.string() }), zod.z.object({ cancelled: zod.z.boolean() }), {
-			kind: "mutation",
-			auth: "admin"
-		}),
-		/**
-		* Lists all currently active (non-completed) bulk updates.
-		* If `nodeId` is provided, filters to only bulk updates targeting
-		* that node. Useful for restoring an in-progress banner on a fresh
-		* page load when the UI reconnects mid-operation.
-		*/
-		listActiveBulkUpdates: method(zod.z.object({ nodeId: zod.z.string().optional() }), zod.z.array(BulkUpdateStateSchema).readonly(), { auth: "admin" }),
 		getVersions: method(zod.z.object({ name: zod.z.string() }), zod.z.array(PackageVersionInfoSchema).readonly()),
 		restartAddon: method(zod.z.object({ addonId: zod.z.string() }), RestartAddonResultSchema, {
 			kind: "mutation",
@@ -22601,6 +22619,51 @@ var addonsCapability = {
 			auth: "admin"
 		}),
 		custom: method(CustomActionInputSchema, zod.z.unknown(), { kind: "mutation" }),
+		/**
+		* Start a lifecycle job (install / update / uninstall / restart) for one
+		* or more addon packages. Returns the `jobId` immediately — the job runs
+		* asynchronously. Observe progress via `EventCategory.AddonsJobProgress` /
+		* `AddonsJobLog` events or poll `getJob`.
+		*
+		* For a single-addon update on the hub the provider also routes
+		* `updatePackage` through this path so the fast swap + atomic-restart
+		* path (`applyStagedAddonUpdate`) is always used.
+		*/
+		startJob: method(zod.z.object({
+			kind: zod.z.enum([
+				"install",
+				"update",
+				"uninstall",
+				"restart"
+			]),
+			targets: zod.z.array(zod.z.object({
+				name: zod.z.string().min(1),
+				version: zod.z.string().min(1)
+			})).min(1),
+			nodeIds: zod.z.array(zod.z.string()).optional()
+		}), zod.z.object({ jobId: zod.z.string() }), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/**
+		* Retrieve a lifecycle job by id. Returns `null` when the id is unknown
+		* (e.g. evicted after the retention window).
+		*/
+		getJob: method(zod.z.object({ jobId: zod.z.string() }), lifecycleJobSchema.nullable(), { auth: "admin" }),
+		/**
+		* List lifecycle jobs. When `activeOnly` is true, only jobs still in
+		* `running` state are returned.
+		*/
+		listJobs: method(zod.z.object({ activeOnly: zod.z.boolean().optional() }), zod.z.array(lifecycleJobSchema), { auth: "admin" }),
+		/**
+		* Cancel a lifecycle job that is queued but not yet actively running.
+		* Returns `{ cancelled: false }` if the job is unknown, already in a
+		* terminal state, or actively executing (cannot abort mid-flight).
+		*/
+		cancelJob: method(zod.z.object({ jobId: zod.z.string() }), zod.z.object({ cancelled: zod.z.boolean() }), {
+			kind: "mutation",
+			auth: "admin"
+		}),
 		onAddonLogs: method(zod.z.object({
 			addonId: zod.z.string(),
 			level: LogLevelSchema$1.optional()
@@ -23562,7 +23625,7 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
-	"addons.cancelBulkUpdate": {
+	"addons.cancelJob": {
 		capName: "addons",
 		capScope: "system",
 		addonId: null,
@@ -23592,7 +23655,7 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"addons.getBulkUpdateState": {
+	"addons.getJob": {
 		capName: "addons",
 		capScope: "system",
 		addonId: null,
@@ -23640,19 +23703,19 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"addons.listActiveBulkUpdates": {
+	"addons.listCapabilityProviders": {
 		capName: "addons",
 		capScope: "system",
 		addonId: null,
 		access: "view"
 	},
-	"addons.listCapabilityProviders": {
+	"addons.listFrameworkPackages": {
 		capName: "addons",
 		capScope: "system",
 		addonId: null,
 		access: "view"
 	},
-	"addons.listFrameworkPackages": {
+	"addons.listJobs": {
 		capName: "addons",
 		capScope: "system",
 		addonId: null,
@@ -23736,7 +23799,7 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
-	"addons.startBulkUpdate": {
+	"addons.startJob": {
 		capName: "addons",
 		capScope: "system",
 		addonId: null,
@@ -28023,6 +28086,34 @@ function getCapsByProviderKind(kind) {
 	return out;
 }
 //#endregion
+//#region src/lifecycle/framework-swap.ts
+var frameworkSwapPackageSchema = zod.z.object({
+	name: zod.z.string(),
+	stagedPath: zod.z.string(),
+	backupPath: zod.z.string(),
+	toVersion: zod.z.string(),
+	fromVersion: zod.z.string().nullable()
+});
+var pendingFrameworkSwapSchema = zod.z.object({
+	jobId: zod.z.string(),
+	taskId: zod.z.string(),
+	packages: zod.z.array(frameworkSwapPackageSchema),
+	requestedAtMs: zod.z.number(),
+	schemaVersion: zod.z.literal(1)
+});
+var frameworkSwapConfirmSchema = zod.z.object({
+	jobId: zod.z.string(),
+	taskId: zod.z.string(),
+	backups: zod.z.array(zod.z.object({
+		name: zod.z.string(),
+		backupPath: zod.z.string(),
+		livePath: zod.z.string()
+	})),
+	appliedAtMs: zod.z.number(),
+	bootAttempts: zod.z.number(),
+	schemaVersion: zod.z.literal(1)
+});
+//#endregion
 //#region src/util/location-match.ts
 /**
 * Pure fuzzy matcher for adoption location import. Normalized
@@ -28914,6 +29005,8 @@ exports.findTimezone = findTimezone;
 exports.floodCapability = floodCapability;
 exports.formatForBackend = formatForBackend;
 exports.formatForRuntime = formatForRuntime;
+exports.frameworkSwapConfirmSchema = frameworkSwapConfirmSchema;
+exports.frameworkSwapPackageSchema = frameworkSwapPackageSchema;
 exports.gasCapability = gasCapability;
 exports.getAudioMacroClassIds = getAudioMacroClassIds;
 exports.getByPath = getByPath;
@@ -28929,7 +29022,12 @@ exports.isAgentOnlyPlacement = isAgentOnlyPlacement;
 exports.isDeployableToAgent = isDeployableToAgent;
 exports.isDeviceConfigCap = isDeviceConfigCap;
 exports.isEvent = isEvent;
+exports.jobKindSchema = jobKindSchema;
 exports.lawnMowerControlCapability = lawnMowerControlCapability;
+exports.lifecycleJobSchema = lifecycleJobSchema;
+exports.lifecycleJobScopeSchema = lifecycleJobScopeSchema;
+exports.lifecycleJobStateSchema = lifecycleJobStateSchema;
+exports.lifecycleTaskSchema = lifecycleTaskSchema;
 exports.localNetworkCapability = localNetworkCapability;
 exports.locationSimilarity = locationSimilarity;
 exports.lockControlCapability = lockControlCapability;
@@ -28966,6 +29064,7 @@ exports.parseJsonObject = parseJsonObject;
 exports.parseJsonUnknown = parseJsonUnknown;
 exports.parseProfileBrokerId = parseProfileBrokerId;
 exports.parseStreamParamsFormPatch = parseStreamParamsFormPatch;
+exports.pendingFrameworkSwapSchema = pendingFrameworkSwapSchema;
 exports.pickPreferredRtspEntry = pickPreferredRtspEntry;
 exports.pipelineAnalyticsCapability = pipelineAnalyticsCapability;
 exports.pipelineExecutorCapability = pipelineExecutorCapability;
@@ -29020,6 +29119,9 @@ exports.switchCapability = switchCapability;
 exports.synthesizeSourceInfo = synthesizeSourceInfo;
 exports.systemCapability = systemCapability;
 exports.tamperCapability = tamperCapability;
+exports.taskLogEntrySchema = taskLogEntrySchema;
+exports.taskPhaseSchema = taskPhaseSchema;
+exports.taskTargetSchema = taskTargetSchema;
 exports.temperatureSensorCapability = temperatureSensorCapability;
 exports.toDeviceSummary = toDeviceSummary;
 exports.toStreamSourceEntry = toStreamSourceEntry;