@camstack/types 1.2.72 → 1.2.73

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

@@ -39,6 +39,69 @@ declare const NetworkAddressSchema: z.ZodObject<{
     family: z.ZodString;
     internal: z.ZodBoolean;
 }, z.core.$strip>;
+/**
+ * Provenance of the site coordinates, and the whole reason this is not just two
+ * numbers.
+ *
+ *   - `operator-set` — a human typed it, or accepted a detection. Authoritative;
+ *     nothing overwrites it.
+ *   - `derived-from-ip` — the hub geolocated its own public IP once, because a
+ *     default that is right to a few kilometres beats the coarse UTC clock split
+ *     the sun-times consumers otherwise fall back to.
+ *
+ * The UI shows which one it is. An operator who cannot tell a guess from their
+ * own input will eventually trust the guess.
+ */
+declare const SiteLocationSourceSchema: z.ZodEnum<{
+    "operator-set": "operator-set";
+    "derived-from-ip": "derived-from-ip";
+}>;
+/**
+ * Where the installation physically is — a fact of the SITE, not of any addon.
+ *
+ * It used to live in `pipeline-analytics`' global settings, which made a
+ * property of the building a property of one analytics addon. Anything that
+ * needs sun-times (scene condition variants today; anything solar tomorrow)
+ * reads it from here.
+ */
+declare const SiteLocationSchema: z.ZodObject<{
+    latitude: z.ZodNumber;
+    longitude: z.ZodNumber;
+    source: z.ZodEnum<{
+        "operator-set": "operator-set";
+        "derived-from-ip": "derived-from-ip";
+    }>;
+    updatedAt: z.ZodNumber;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * The read shape: the location plus the honest state of the one-shot derivation.
+ *
+ * `derivationAttemptedAt` is what makes the "one call, ever" contract
+ * inspectable. When it is set and `location` is null, the geo-IP lookup ran and
+ * failed; the hub will NOT try again on its own — the fallback is declared
+ * (consumers degrade to their own last resort) and the operator either types the
+ * coordinates or presses detect.
+ */
+declare const SiteLocationStatusSchema: z.ZodObject<{
+    location: z.ZodNullable<z.ZodObject<{
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        source: z.ZodEnum<{
+            "operator-set": "operator-set";
+            "derived-from-ip": "derived-from-ip";
+        }>;
+        updatedAt: z.ZodNumber;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    derivationAttemptedAt: z.ZodNullable<z.ZodNumber>;
+    derivationError: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/** `null` clears the location and re-arms nothing — the derivation stays spent. */
+declare const SetSiteLocationInputSchema: z.ZodNullable<z.ZodObject<{
+    latitude: z.ZodNumber;
+    longitude: z.ZodNumber;
+}, z.core.$strip>>;
 export declare const systemCapability: {
     readonly name: "system";
     readonly scope: "system";
@@ -79,6 +142,68 @@ export declare const systemCapability: {
         readonly getRetentionConfig: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodNullable<z.ZodUnknown>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly setRetentionConfig: import("./capability-definition.js").CapabilityMethodSchema<z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodNull, "mutation">;
         readonly forceRetentionCleanup: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodVoid, "mutation">;
+        /**
+         * The site coordinates, deriving a default from the hub's public IP on the
+         * FIRST read that finds nothing stored.
+         *
+         * The derivation is one-shot and bounded: one outbound request, a few
+         * seconds, its outcome persisted either way. A hub with no internet pays it
+         * once and never again, and neither boot nor any consumer is blocked on it —
+         * the caller gets `location: null` and degrades exactly as it did before this
+         * method existed.
+         */
+        readonly getSiteLocation: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
+            location: z.ZodNullable<z.ZodObject<{
+                latitude: z.ZodNumber;
+                longitude: z.ZodNumber;
+                source: z.ZodEnum<{
+                    "operator-set": "operator-set";
+                    "derived-from-ip": "derived-from-ip";
+                }>;
+                updatedAt: z.ZodNumber;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            derivationAttemptedAt: z.ZodNullable<z.ZodNumber>;
+            derivationError: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /** Operator input. Always lands as `source: 'operator-set'`. */
+        readonly setSiteLocation: import("./capability-definition.js").CapabilityMethodSchema<z.ZodNullable<z.ZodObject<{
+            latitude: z.ZodNumber;
+            longitude: z.ZodNumber;
+        }, z.core.$strip>>, z.ZodObject<{
+            location: z.ZodNullable<z.ZodObject<{
+                latitude: z.ZodNumber;
+                longitude: z.ZodNumber;
+                source: z.ZodEnum<{
+                    "operator-set": "operator-set";
+                    "derived-from-ip": "derived-from-ip";
+                }>;
+                updatedAt: z.ZodNumber;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            derivationAttemptedAt: z.ZodNullable<z.ZodNumber>;
+            derivationError: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, "mutation">;
+        /**
+         * Re-run the geo-IP derivation now. The ONLY way a spent or failed
+         * derivation is retried — there is no timer, and no read path retries.
+         * Overwrites an existing `derived-from-ip` value; refuses to clobber an
+         * `operator-set` one.
+         */
+        readonly detectSiteLocation: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
+            location: z.ZodNullable<z.ZodObject<{
+                latitude: z.ZodNumber;
+                longitude: z.ZodNumber;
+                source: z.ZodEnum<{
+                    "operator-set": "operator-set";
+                    "derived-from-ip": "derived-from-ip";
+                }>;
+                updatedAt: z.ZodNumber;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            derivationAttemptedAt: z.ZodNullable<z.ZodNumber>;
+            derivationError: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, "mutation">;
     };
     /** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
     readonly mount: {
@@ -86,4 +211,8 @@ export declare const systemCapability: {
     };
 };
 export type ISystemProvider = InferProvider<typeof systemCapability>;
-export { FeatureManifestSchema, HealthStatusSchema, NetworkAddressSchema };
+export type SiteLocation = z.infer<typeof SiteLocationSchema>;
+export type SiteLocationSource = z.infer<typeof SiteLocationSourceSchema>;
+export type SiteLocationStatus = z.infer<typeof SiteLocationStatusSchema>;
+export type SetSiteLocationInput = z.infer<typeof SetSiteLocationInputSchema>;
+export { FeatureManifestSchema, HealthStatusSchema, NetworkAddressSchema, SetSiteLocationInputSchema, SiteLocationSchema, SiteLocationSourceSchema, SiteLocationStatusSchema, };

package/dist/generated/addon-api.d.ts

@@ -3354,6 +3354,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof llmCapability.methods.generateVision.output>;
             meta: object;
         }>;
+        cancel: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof llmCapability.methods.cancel.input>;
+            output: z.infer<typeof llmCapability.methods.cancel.output>;
+            meta: object;
+        }>;
         listProfileKinds: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;
@@ -7494,6 +7501,25 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof systemCapability.methods.forceRetentionCleanup.output>;
             meta: object;
         }>;
+        getSiteLocation: TRPCQueryProcedure<{
+            input: {
+                nodeId?: string | undefined;
+            } | undefined;
+            output: z.infer<typeof systemCapability.methods.getSiteLocation.output>;
+            meta: object;
+        }>;
+        setSiteLocation: TRPCMutationProcedure<{
+            input: z.input<typeof systemCapability.methods.setSiteLocation.input>;
+            output: z.infer<typeof systemCapability.methods.setSiteLocation.output>;
+            meta: object;
+        }>;
+        detectSiteLocation: TRPCMutationProcedure<{
+            input: {
+                nodeId?: string | undefined;
+            } | undefined;
+            output: z.infer<typeof systemCapability.methods.detectSiteLocation.output>;
+            meta: object;
+        }>;
     }>>;
     tamper: TRPCBuiltRouter<{
         ctx: TrpcContext;

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 934 method paths across 123 capabilities.
+ * Coverage: 938 method paths across 123 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

package/dist/generated/system-proxy.d.ts

@@ -73,7 +73,7 @@ export interface SystemProxy {
     readonly deviceState: Pick<InferProvider<typeof deviceStateCapability>, 'getAllSnapshots'>;
     readonly faceGallery: Pick<InferProvider<typeof faceGalleryCapability>, 'listIdentities' | 'createIdentity' | 'renameIdentity' | 'deleteIdentity' | 'listIdentitySamples' | 'removeSample' | 'getFaceMedia' | 'assignFace' | 'unassignFace' | 'deleteFace' | 'assignFaces' | 'unassignFaces' | 'suggestFaceClusters'>;
     readonly integrations: Pick<InferProvider<typeof integrationsCapability>, 'list' | 'get' | 'getByAddonId' | 'create' | 'update' | 'delete' | 'getSettings' | 'setSettings' | 'getAvailableTypes' | 'testConnection'>;
-    readonly llm: Pick<InferProvider<typeof llmCapability>, 'generate' | 'generateVision' | 'listProfileKinds' | 'listProfiles' | 'upsertProfile' | 'deleteProfile' | 'testProfile' | 'listModels' | 'getDefaults' | 'setDefault' | 'getUsage' | 'listModelCatalog' | 'listRuntimeNodes' | 'listNodeModels' | 'installModel' | 'deleteModel' | 'getRuntimeStatus' | 'startRuntime' | 'stopRuntime'>;
+    readonly llm: Pick<InferProvider<typeof llmCapability>, 'generate' | 'generateVision' | 'cancel' | 'listProfileKinds' | 'listProfiles' | 'upsertProfile' | 'deleteProfile' | 'testProfile' | 'listModels' | 'getDefaults' | 'setDefault' | 'getUsage' | 'listModelCatalog' | 'listRuntimeNodes' | 'listNodeModels' | 'installModel' | 'deleteModel' | 'getRuntimeStatus' | 'startRuntime' | 'stopRuntime'>;
     readonly localNetwork: Pick<InferProvider<typeof localNetworkCapability>, 'list' | 'getPreferred' | 'getConnectionEndpoints' | 'getNotificationEndpoint' | 'setNotificationEndpoint' | 'getAllowedAddresses' | 'setAllowedAddresses' | 'resetAllowlistToBestMatch'>;
     readonly meshNetwork: Pick<InferProvider<typeof meshNetworkCapability>, 'getStatus' | 'join' | 'startLogin' | 'leave' | 'logout' | 'listPeers' | 'testConnection'>;
     readonly metricsProvider: Pick<InferProvider<typeof metricsProviderCapability>, 'collectSnapshot' | 'getCached' | 'getCurrent' | 'getDiskSpace' | 'getGpuInfo' | 'getCpuTemperature' | 'getProcessStats' | 'listAddonInstances' | 'getAddonStats' | 'listNodeProcesses' | 'killProcess' | 'dumpHeapSnapshot'>;
@@ -94,7 +94,7 @@ export interface SystemProxy {
     readonly storage: Pick<InferProvider<typeof storageCapability>, 'resolve' | 'write' | 'read' | 'exists' | 'list' | 'delete' | 'getAvailableSpace' | 'beginUpload' | 'writeChunk' | 'finalizeUpload' | 'abortUpload' | 'beginDownload' | 'readChunk' | 'endDownload' | 'listLocations' | 'getDefaultLocation' | 'listLocationDeclarations' | 'upsertLocation' | 'deleteLocation' | 'testLocation' | 'listProviders' | 'testConfig'>;
     readonly storageMigration: Pick<InferProvider<typeof storageMigrationCapability>, 'plan' | 'start' | 'status' | 'cancel'>;
     readonly streamBroker: Pick<InferProvider<typeof streamBrokerCapability>, 'fetchEventMedia' | 'listAllCameraStreams' | 'listAllProfileSlots' | 'getBrokerStats' | 'probeStream' | 'listClients' | 'killClient' | 'getStreamUrl' | 'getStreamWithCodec' | 'releaseStreamWithCodec' | 'acquireEgressTranscode' | 'releaseEgressTranscode' | 'subscribeAudioChunks' | 'pullAudioChunks' | 'unsubscribeAudioChunks' | 'subscribeFrames' | 'pullFrameHandles' | 'unsubscribeFrames' | 'setPreBufferDuration' | 'getPreBufferInfo' | 'getRtspPort' | 'getAllRtspEntries' | 'getRtspEntry' | 'regenerateRtspToken' | 'setRtspEnabled' | 'isRtspEnabled'>;
-    readonly system: Pick<InferProvider<typeof systemCapability>, 'info' | 'health' | 'featureFlags' | 'networkAddresses' | 'getRetentionConfig' | 'setRetentionConfig' | 'forceRetentionCleanup'>;
+    readonly system: Pick<InferProvider<typeof systemCapability>, 'info' | 'health' | 'featureFlags' | 'networkAddresses' | 'getRetentionConfig' | 'setRetentionConfig' | 'forceRetentionCleanup' | 'getSiteLocation' | 'setSiteLocation' | 'detectSiteLocation'>;
     readonly terminalSession: Pick<InferProvider<typeof terminalSessionCapability>, 'listProfiles' | 'listInstances' | 'createInstance' | 'deleteInstance' | 'setInstanceEnabled' | 'listLegacyCameras' | 'adoptLegacyMonitor' | 'listSessions' | 'openSession' | 'resize' | 'pullOutput' | 'writeInput' | 'close'>;
     readonly toast: Pick<InferProvider<typeof toastCapability>, 'onToast'>;
     readonly turnProvider: Pick<InferProvider<typeof turnProviderCapability>, 'getTurnServers'>;

package/dist/index.d.ts

@@ -188,7 +188,7 @@ export type { AudioCodecInfo, AudioDecodeSessionConfig, AudioEncodedChunk, Audio
 export type { StreamQuality } from './interfaces/device-capabilities/camera.js';
 export { STREAM_QUALITY_LABELS, streamQualityLabel, } from './interfaces/device-capabilities/camera.js';
 export * from './lifecycle/index.js';
-export { audioIsFailClosed, audioLabelChoices, audioOrDefaults, isAudioLabelSelected, NC_AUDIO_DB_MAX, NC_AUDIO_DB_MIN, NC_AUDIO_DB_OFFERED, NC_AUDIO_DB_STEP, NC_AUDIO_DEFAULTS, NC_AUDIO_HIT_PERCENT_MAX, NC_AUDIO_HIT_PERCENT_MIN, NC_AUDIO_SAMPLING_MAX_SEC, NC_AUDIO_SAMPLING_MIN_SEC, type NcAudioLabelChoice, type NcAudioPatch, normalizeAudioLabel, patchAudio, toggleAudioLabel, } from './notification/audio-condition.js';
+export { audioIsFailClosed, audioLabelChoices, audioModeOf, audioOrDefaults, isAudioLabelSelected, NC_AUDIO_DB_MAX, NC_AUDIO_DB_MIN, NC_AUDIO_DB_OFFERED, NC_AUDIO_DB_STEP, NC_AUDIO_DEFAULTS, NC_AUDIO_HIT_PERCENT_MAX, NC_AUDIO_HIT_PERCENT_MIN, NC_AUDIO_SAMPLING_MAX_SEC, NC_AUDIO_SAMPLING_MIN_SEC, type NcAudioLabelChoice, type NcAudioMode, type NcAudioPatch, normalizeAudioLabel, patchAudio, toggleAudioLabel, } from './notification/audio-condition.js';
 export { isBaseConditionKey, knownValues, NC_BASE_CONDITION_KEYS, type NcBaseConditionKey, pickerForCondition, type TaxonomyGroup, type TaxonomyOption, type TaxonomyPicker, } from './notification/condition-taxonomy.js';
 export { type PreparedAction, type PreparedAttachment, type PreparedNotification, prepareNotification, type ResolvedLevel, } from './notification/degrade-engine.js';
 export { htmlToText, markdownToHtmlLite, markdownToText, type NotificationFormat as NotificationBodyFormat, resolveFormat, textToHtml, transcodeBody, } from './notification/format-transcode.js';
@@ -197,8 +197,8 @@ export type { TimelapseCadencePair, TimelapsePreviewMode, TimelapseRule, Timelap
 export { assertTimelapseCadences, DEFAULT_TIMELAPSE_PREVIEW_TEXT, readTimelapseGeneratedAt, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleInputSchema, TimelapseRulePatchSchema, TimelapseRuleSchema, TimelapseTemplateSchema, } from './notification/timelapse-rule.js';
 export { DEFAULT_DETAIL_CROP_CONVENTION, DETAIL_CROP_PADDING_FIELD, DETAIL_CROP_PADDING_KEY, DETAIL_CROP_SECTION_ID, DETAIL_CROP_SQUARE_KEY, type DetailCropConvention, DetailCropConventionSchema, type DetailCropRect, deriveDetailCropRect, type HydratedSettingsSection, type HydratedSettingsView, pickDetailCropConvention, readDetailCropConvention, } from './pipeline/detail-crop.js';
 export { DEFAULT_NATIVE_LEASE_SETTINGS, NATIVE_LEASE_ACTIVITY_FIELD, NATIVE_LEASE_ACTIVITY_KEY, NATIVE_LEASE_ADMISSION_FIELD, NATIVE_LEASE_ADMISSION_KEY, NATIVE_LEASE_BUDGET_FIELD, NATIVE_LEASE_BUDGET_KEY, NATIVE_LEASE_HOLD_FIELD, NATIVE_LEASE_HOLD_KEY, NATIVE_LEASE_SECTION_ID, NATIVE_LEASE_TILE_BUDGET_FIELD, NATIVE_LEASE_TILE_BUDGET_KEY, type NativeLeaseAdmission, NativeLeaseAdmissionSchema, type NativeLeaseKnob, type NativeLeaseNumberKnob, type NativeLeaseSettings, type NativeLeaseSettingsOverride, NativeLeaseSettingsSchema, pickNativeLeaseOverride, readNativeLeaseOverride, } from './pipeline/native-lease.js';
-export { type ApiKeyRecord, ApiKeyRecordSchema, type CapScope, CapScopeSchema, type DeviceSelector, DeviceSelectorSchema, type DeviceTokenScope, type MethodAccess, MethodAccessSchema, type ScopedToken, ScopedTokenSchema, type TokenScope, TokenScopeSchema, type UserRecord, UserRecordSchema, } from './schemas/auth-records.js';
 export { ACCESS_ROLES, type AccessRoleAssignment, type AccessRoleId, type AccessRoleSpec, buildRoleScopes, detectAccessRole, roleSpec, } from './schemas/access-roles.js';
+export { type ApiKeyRecord, ApiKeyRecordSchema, type CapScope, CapScopeSchema, type DeviceSelector, DeviceSelectorSchema, type DeviceTokenScope, type MethodAccess, MethodAccessSchema, type ScopedToken, ScopedTokenSchema, type TokenScope, TokenScopeSchema, type UserRecord, UserRecordSchema, } from './schemas/auth-records.js';
 export { type DeviceMetaLike, type DeviceReachSummary, deviceSelectorMatches, type EffectiveScope, normalizeTokenScopes, resolveViewableDeviceIds, type ScopeGrantSummary, scopeInherits, summarizeEffectiveScope, } from './schemas/device-selector.js';
 export type { CameraDetectionCapabilities, CameraMotionConfig, CameraNativeDetectionConfig, } from './types/camera-detection.js';
 export { DEVICE_TYPE_INFO, type DeviceTypeInfo } from './types/device-type.js';