@camstack/types 1.1.9 → 1.1.11

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-Chb7wz4V.js");
+const require_sleep = require("./sleep-CKc4LLbD.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 exports.BaseAddon = require_sleep.BaseAddon;
 exports.DATAPLANE_SECRET_HEADER = require_sleep.DATAPLANE_SECRET_HEADER;

package/dist/addon.mjs

@@ -1,3 +1,3 @@
-import { A as ReadinessTimeoutError, D as parseJsonUnknown, N as scopeKey, O as DATAPLANE_SECRET_HEADER, S as asJsonObject, a as adminUiCapability, at as BaseAddon, ht as DisposerChain, i as deviceOpsCapability, k as ReadinessRegistry, lt as emitReadiness, mt as EventCategory, o as createDeviceProxy, ot as normalizeAddonInitResult, p as expandCapMethods, t as sleep, w as asString, y as DeviceType } from "./sleep-DVmKHFGi.mjs";
+import { A as ReadinessRegistry, C as asJsonObject, O as parseJsonUnknown, P as scopeKey, T as asString, a as adminUiCapability, b as DeviceType, gt as DisposerChain, ht as EventCategory, i as deviceOpsCapability, j as ReadinessTimeoutError, k as DATAPLANE_SECRET_HEADER, o as createDeviceProxy, ot as BaseAddon, p as expandCapMethods, st as normalizeAddonInitResult, t as sleep, ut as emitReadiness } from "./sleep-B3AOslwX.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 export { BaseAddon, DATAPLANE_SECRET_HEADER, DeviceType, DisposerChain, EventCategory, ReadinessRegistry, ReadinessTimeoutError, adminUiCapability, asJsonObject, asString, createDeviceProxy, deviceOpsCapability, emitReadiness, errMsg, expandCapMethods, normalizeAddonInitResult, parseJsonUnknown, scopeKey, sleep };

package/dist/capabilities/addon-routes.cap.d.ts

@@ -80,6 +80,10 @@ export declare const addonRoutesCapability: {
             contentType: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, "mutation">;
     };
+    /** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
+    readonly mount: {
+        readonly kind: "skip";
+    };
 };
 export type IAddonRoutesProvider = InferProvider<typeof addonRoutesCapability>;
 export { InvokeRequestSchema, InvokeReplyEnvelopeSchema };

package/dist/capabilities/addons.cap.d.ts

@@ -780,6 +780,10 @@ export declare const addonsCapability: {
             scope: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, "subscription">;
     };
+    /** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
+    readonly mount: {
+        readonly kind: "service-backed";
+    };
 };
 export type IAddonsProvider = InferProvider<typeof addonsCapability>;
 export { AddonListItemSchema, InstalledPackageSchema, PackageUpdateSchema, PackageVersionInfoSchema, SearchResultSchema, AutoUpdateSettingsSchema, AddonAutoUpdateSchema, LogStreamEntrySchema, CustomActionInputSchema, LogLevelSchema, ChannelSchema, ChannelWithInheritSchema, UpdateFrameworkPackageResultSchema, FrameworkPackageStatusSchema, BulkUpdateItemStatusSchema, BulkUpdateItemSchema, BulkUpdatePhaseSchema, BulkUpdateStateSchema, };

package/dist/capabilities/auth-provider.cap.d.ts

@@ -43,6 +43,10 @@ export declare const authProviderCapability: {
             isAdmin: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
     };
+    /** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
+    readonly mount: {
+        readonly kind: "skip";
+    };
 };
 export type IAuthProvider = InferProvider<typeof authProviderCapability>;
 export { AuthResultSchema };

package/dist/capabilities/capability-definition.d.ts

@@ -393,7 +393,66 @@ export interface CapabilityDefinition<TName extends string = string, TMethods ex
      * non-singleton caps.
      */
     readonly preferredProvider?: string;
+    /**
+     * Declarative mount hint read by the runtime cap-router builder
+     * (`@camstack/system` `buildCapRouters`). It encodes HOW the hub
+     * resolves the provider object the cap's tRPC router calls — the same
+     * decision that the codegen `generate-cap-mounts.ts` baked into
+     * `generated-cap-mounts.ts` at build time, lifted onto the cap def so a
+     * cap change ships via the framework plugin (`@camstack/types` +
+     * `@camstack/system`) without a `@camstack/server` rebuild (BIG PLAN 2).
+     *
+     * When omitted, the builder derives the mount from the cap's
+     * `scope` / `mode` / `deviceNative` exactly as the codegen did
+     * (see {@link resolveCapMount}):
+     *   - `deviceNative: true`     → `{ kind: 'device-native' }`
+     *   - `mode: 'collection'`     → `{ kind: 'collection' }` (array-output
+     *                                 methods auto-detected → concat fan-out)
+     *   - otherwise (singleton / per-node) → `{ kind: 'singleton' }`
+     *
+     * Set it EXPLICITLY only for caps whose resolution is NOT derivable from
+     * scope/mode — the handful that today live as hand-written overrides in
+     * `trpc.router.ts`:
+     *   - `{ kind: 'service-backed' }` — the provider is built on the hub
+     *     from backend services (`system`, `nodes`, `integrations`,
+     *     `addons`, `network-quality`, `toast`). The builder does NOT
+     *     resolve these; the server supplies a provider factory by cap name
+     *     to `buildCapRouters` via its `serviceProviders` map. Keeps backend
+     *     composition out of `@camstack/system` (the self-sufficiency
+     *     invariant) while still mounting the route generically.
+     *   - `{ kind: 'hub-only' }` — single-node cap; the remote-proxy leg is
+     *     short-circuited to `null` (agents are not addressable). Used by
+     *     `local-network`.
+     *   - `{ kind: 'custom' }` — resolution needs app-specific logic the
+     *     generic builder cannot model (probe-then-fan-out, per-request
+     *     relay enrichment). The server keeps a hand-written override for
+     *     these (`snapshot-provider`, `webrtc-session`); the builder leaves
+     *     the slot empty for the override to fill via spread precedence.
+     *   - `{ kind: 'skip' }` — never mounted (legacy provider shapes that
+     *     predate the `InferProvider` contract — `addon-routes`,
+     *     `auth-provider`, `log-destination`, `restreamer`,
+     *     `streaming-engine`, `webrtc`). Mirrors the old `LEGACY_SHAPE_SKIP`
+     *     set.
+     */
+    readonly mount?: CapabilityMountHint;
 }
+/**
+ * Mount-resolution kinds for {@link CapabilityDefinition.mount}. See the
+ * field doc for when to use each. `singleton` / `collection` /
+ * `device-native` are the auto-derivable defaults; the rest are explicit
+ * opt-ins for caps that today need a hand-written override.
+ */
+export type CapabilityMountKind = 'singleton' | 'collection' | 'device-native' | 'service-backed' | 'hub-only' | 'custom' | 'skip';
+export interface CapabilityMountHint {
+    readonly kind: CapabilityMountKind;
+}
+/**
+ * Resolve the EFFECTIVE mount hint for a cap — the explicit `mount` when
+ * present, else the scope/mode/deviceNative-derived default. Single source
+ * of truth shared by the runtime builder and any codegen that needs the
+ * same classification, so the two can never disagree.
+ */
+export declare function resolveCapMount(def: CapabilityDefinition): CapabilityMountHint;
 /** Contract for the three methods added by `exposesDeviceSettings: true`. */
 export interface DeviceSettingsContribution {
     readonly getDeviceSettingsContribution: (input: {

package/dist/capabilities/climate-control.cap.d.ts

@@ -24,6 +24,13 @@ import { DeviceType } from '../device/device-type.js';
  *   - `ClimateHumidity` — currentHumidity / targetHumidity surfaces
  *   - `ClimateFanMode` — fan-mode selector
  *   - `ClimatePreset` — preset selector
+ *   - `ClimateSwingVertical` — vertical louver swing toggle
+ *   - `ClimateSwingHorizontal` — horizontal louver swing toggle
+ *
+ * Swing is modelled as two INDEPENDENT booleans (vertical / horizontal),
+ * each actionable on its own and each gated by its own `DeviceFeature`
+ * so the UI shows only the axes a given device supports. This is generic
+ * — any climate device (not just Gree) can advertise either / both axes.
  */
 export declare const HvacModeSchema: z.ZodEnum<{
     auto: "auto";
@@ -64,6 +71,8 @@ export declare const ClimateControlStatusSchema: z.ZodObject<{
     targetHumidity: z.ZodNullable<z.ZodNumber>;
     currentTemp: z.ZodNullable<z.ZodNumber>;
     currentHumidity: z.ZodNullable<z.ZodNumber>;
+    swingVertical: z.ZodNullable<z.ZodBoolean>;
+    swingHorizontal: z.ZodNullable<z.ZodBoolean>;
     lastFetchedAt: z.ZodNumber;
 }, z.core.$strip>;
 export type ClimateControlStatus = z.infer<typeof ClimateControlStatusSchema>;
@@ -107,6 +116,14 @@ export declare const climateControlCapability: {
             deviceId: z.ZodNumber;
             targetHumidity: z.ZodNumber;
         }, z.core.$strip>, z.ZodVoid, "mutation">;
+        readonly setSwingVertical: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            on: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        readonly setSwingHorizontal: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            on: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
     };
     readonly status: {
         readonly schema: z.ZodObject<{
@@ -138,6 +155,8 @@ export declare const climateControlCapability: {
             targetHumidity: z.ZodNullable<z.ZodNumber>;
             currentTemp: z.ZodNullable<z.ZodNumber>;
             currentHumidity: z.ZodNullable<z.ZodNumber>;
+            swingVertical: z.ZodNullable<z.ZodBoolean>;
+            swingHorizontal: z.ZodNullable<z.ZodBoolean>;
             lastFetchedAt: z.ZodNumber;
         }, z.core.$strip>;
         readonly kind: "push";
@@ -176,6 +195,8 @@ export declare const climateControlCapability: {
         targetHumidity: z.ZodNullable<z.ZodNumber>;
         currentTemp: z.ZodNullable<z.ZodNumber>;
         currentHumidity: z.ZodNullable<z.ZodNumber>;
+        swingVertical: z.ZodNullable<z.ZodBoolean>;
+        swingHorizontal: z.ZodNullable<z.ZodBoolean>;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
 };