@chrisalvir1/camera-ui-homekit-4k 0.6.14 → 0.6.15

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.6.15] — Camera.UI platform install targets
+
+- Declare macOS, Windows, and Linux on x64 and ARM64 as npm install targets,
+  matching Camera.UI's supported server platforms. Runtime testing remains
+  verified on macOS ARM64 only; the other targets require host-specific checks.
+- Keep the official logo in the published bundle and assert the install target
+  matrix and package version in the bundle smoke test.
+- Publish the Camera.UI-generated `bundle/` artifact rather than the source
+  repository root. This removes source-only runtime dependencies from the npm
+  install path and ships the `cameraui` metadata, `bundle.zip`, and logo that
+  Camera.UI consumes.
+- Embed the pinned HAP runtime and its complete production dependency tree in
+  `bundle.zip`. Camera.UI therefore performs no dependency download after
+  extracting the npm package, avoiding installation failures caused by a
+  user-owned npm cache with incorrect permissions.
+
 ## [0.6.14] — npm account scope correction
 
 - Rename the public package from `@chrisalvir/camera-ui-homekit-4k` to

package/LICENSE.md

@@ -1,8 +1,21 @@
-# Licensing status
+HOMEKIT 4K PROPRIETARY SOFTWARE LICENSE
 
-Copyright Chrisalvir. All rights reserved.
+Copyright (c) 2026 Chrisalvir. All rights reserved.
 
-No public license is granted for the original HOMEKIT 4K implementation during
-Phase 1. package.json declares UNLICENSED. A distribution license must be chosen
-by the author before public release. Third-party dependencies retain their own
-licenses and notices; this file does not change those licenses.
+Permission is granted to download, install, and run an unmodified copy of
+HOMEKIT 4K with Camera.UI for lawful personal or commercial use. This permission
+does not transfer ownership of the software.
+
+You may not modify, adapt, translate, or create derivative works from HOMEKIT
+4K. You may not redistribute, sublicense, republish, or sell copies of the
+software. Any permission beyond downloading, installing, and running an
+unmodified copy requires prior written permission from the copyright holder.
+
+The copyright notice and this license must accompany any permitted unmodified
+copy.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHOR OR COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY
+ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR ITS USE.

package/README.md

@@ -6,10 +6,10 @@ HomeKit 4K exports cameras assigned to the plugin in Camera.UI as separate
 Apple Home accessories. Camera.UI remains the source of camera streams,
 capabilities, sensors, and detector configuration.
 
-**Version 0.6.14.** Runtime behavior was validated on the developer MacBook
-with Camera.UI 2.3.0 using the previous package, 0.6.12. Version 0.6.14 fixes
-the npm scope to match the owner's npm account and does not change camera runtime
-behavior. Runtime evidence and limits are in
+**Next release prepared: 0.6.15 (not published).** Runtime behavior was
+validated on the developer MacBook with Camera.UI 2.3.0 using package 0.6.12.
+Version 0.6.14 fixed the npm scope to match the owner's npm account and did not
+change camera runtime behavior. Runtime evidence and limits are in
 [`docs/deployment-0.6.12.md`](docs/deployment-0.6.12.md).
 
 ## Current behavior
@@ -33,14 +33,12 @@ behavior. Runtime evidence and limits are in
 
 ## Requirements and installation
 
-The package currently declares Camera.UI >=2.3.0 and Node.js >=22.18.0. The
-development validation used Camera.UI's official local bundle installer. Public
-npm installation is not available yet; use Camera.UI's supported plugin
-installer after a public release is announced.
-
-The current package manifest restricts installation to macOS ARM64. That limit
-must be confirmed or removed before promising support for other Camera.UI
-platforms.
+The package declares Camera.UI >=2.3.0 and Node.js >=22.18.0. Starting with
+0.6.15, npm allows installation on macOS, Windows, and Linux on x64 or ARM64.
+The runtime has only been exercised on macOS ARM64; Windows, Linux, and macOS
+Intel still need real-host validation before they can be called verified.
+In Camera.UI's plugin store, search for the shorter text `camera-ui-homekit-4k`
+and select the scoped package `@chrisalvir1/camera-ui-homekit-4k`.
 
 ## Development
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@chrisalvir1/camera-ui-homekit-4k",
   "displayName": "HOMEKIT 4K — by Chrisalvir",
-  "version": "0.6.14",
+  "version": "0.6.15",
   "description": "Exports Camera.UI cameras to Apple Home with H.264/HKSV and HEVC/HKSV3 streaming paths.",
   "homepage": "https://github.com/Chrisalvir1/homekit-4k",
   "repository": {
@@ -17,58 +17,26 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "type": "module",
+  "type": "commonjs",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist/**/*.js",
-    "dist/**/*.d.ts",
-    "vendor/hap-nodejs/dist/**/*.js",
-    "vendor/hap-nodejs/dist/**/*.d.ts",
-    "vendor/hap-nodejs/package.json",
-    "vendor/hap-nodejs/LICENSE",
-    "vendor/hap-nodejs/PATCH.md",
-    "vendor/hap-nodejs/README.md",
-    "docs",
-    "LICENSE",
-    "logo.png",
-    "README.md",
-    "CHANGELOG.md"
+    "bundle.zip",
+    "CHANGELOG.md",
+    "logo.png"
   ],
   "engines": {
     "node": ">=22.18.0",
     "camera.ui": ">=2.3.0"
   },
   "os": [
-    "darwin"
+    "darwin",
+    "linux",
+    "win32"
   ],
   "cpu": [
-    "arm64"
-  ],
-  "dependencies": {
-    "@camera.ui/sdk": "1.4.1",
-    "@homebridge/hap-nodejs": "file:vendor/hap-nodejs",
-    "@noble/ciphers": "2.4.0",
-    "fflate": "0.8.3",
-    "mqtt": "5.16.0",
-    "qrcode": "1.5.4",
-    "werift": "0.23.0"
-  },
-  "devDependencies": {
-    "@camera.ui/cli": "0.0.116",
-    "@types/node": "24.10.0",
-    "@types/qrcode": "1.5.6",
-    "eslint": "10.11.0",
-    "typescript": "5.9.3",
-    "typescript-eslint": "8.71.0"
-  },
-  "homekit4k": {
-    "releaseChannel": "stable"
-  },
-  "keywords": [
-    "camera-ui-plugin",
-    "camera-ui",
-    "homekit"
+    "arm64",
+    "x64"
   ],
   "scripts": {
     "build": "node scripts/build-vendored-hap.mjs && node scripts/build.mjs",
@@ -84,6 +52,19 @@
     "smoke:bundle": "node scripts/smoke-bundle.mjs",
     "examples": "pnpm build && node scripts/examples.mjs",
     "bundle:camera-ui": "pnpm build && cui bundle && node scripts/finalize-camera-ui-bundle.mjs",
+    "publish:camera-ui": "pnpm bundle:camera-ui && npm publish ./bundle --access public --registry=https://registry.npmjs.org/",
     "test:audio": "pnpm build && node scripts/audio-lab/test-audio.mjs"
+  },
+  "homekit4k": {
+    "releaseChannel": "stable"
+  },
+  "packageManager": "pnpm@11.25.0",
+  "keywords": [
+    "camera-ui-plugin",
+    "camera-ui",
+    "homekit"
+  ],
+  "cameraui": {
+    "protocolLevel": 2
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-HOMEKIT 4K PROPRIETARY SOFTWARE LICENSE
-
-Copyright (c) 2026 Chrisalvir. All rights reserved.
-
-Permission is granted to download, install, and run an unmodified copy of
-HOMEKIT 4K with Camera.UI for lawful personal or commercial use. This permission
-does not transfer ownership of the software.
-
-You may not modify, adapt, translate, or create derivative works from HOMEKIT
-4K. You may not redistribute, sublicense, republish, or sell copies of the
-software. Any permission beyond downloading, installing, and running an
-unmodified copy requires prior written permission from the copyright holder.
-
-The copyright notice and this license must accompany any permitted unmodified
-copy.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHOR OR COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY
-ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR ITS USE.

package/dist/accessories/AccessoryConfigStore.d.ts

@@ -1,36 +0,0 @@
-export interface StoredPtzPosition {
-    pan: number;
-    tilt: number;
-    zoom: number;
-}
-export interface StoredPtzPreset {
-    name: string;
-    position: StoredPtzPosition;
-    savedAt: string;
-    includeInPatrol: boolean;
-}
-export type HomeKitVideoMode = 'CLASSIC_H264' | 'HKSV3_LOCAL_HEVC';
-export interface CameraAccessoryConfig {
-    exportEnabled: boolean;
-    /** True after the one-time first-export default for HEVC/HKSV3 recording audio was applied. */
-    recordingAudioDefaultInitialized: boolean;
-    sourceId?: string;
-    videoMode: HomeKitVideoMode;
-    ptzEnabled: boolean;
-    patrolEnabled: boolean;
-    patrolIntervalSeconds: number;
-    presets: Array<StoredPtzPreset | null>;
-    defaultPreset?: number;
-    tracking: {
-        person: boolean;
-        animal: boolean;
-        vehicle: boolean;
-    };
-}
-export declare class AccessoryConfigStore {
-    private readonly store;
-    constructor(root: string);
-    get(cameraId: string): Promise<CameraAccessoryConfig>;
-    update(cameraId: string, change: (current: CameraAccessoryConfig) => CameraAccessoryConfig): Promise<CameraAccessoryConfig>;
-    exportEnabled(): Promise<string[]>;
-}

package/dist/accessories/AccessoryConfigStore.js

@@ -1,79 +0,0 @@
-import { join } from 'node:path';
-import { AtomicJsonStore, record } from "../persistence/AtomicJsonStore.js";
-const initialCamera = () => ({ exportEnabled: false, recordingAudioDefaultInitialized: false,
-    videoMode: 'CLASSIC_H264', ptzEnabled: false, patrolEnabled: false, patrolIntervalSeconds: 15,
-    presets: [null, null, null, null, null],
-    tracking: { person: false, animal: false, vehicle: false } });
-function decode(value) {
-    if (!record(value) || value.schemaVersion !== 1 || !record(value.cameras))
-        throw new Error('Invalid accessory configuration schema');
-    const cameras = Object.create(null);
-    for (const [cameraId, raw] of Object.entries(value.cameras)) {
-        if (!cameraId || !record(raw) || typeof raw.exportEnabled !== 'boolean' || typeof raw.ptzEnabled !== 'boolean' ||
-            !Array.isArray(raw.presets) || raw.presets.length !== 5 || !record(raw.tracking) ||
-            typeof raw.tracking.person !== 'boolean' || typeof raw.tracking.animal !== 'boolean' || typeof raw.tracking.vehicle !== 'boolean') {
-            throw new Error('Invalid per-camera accessory configuration');
-        }
-        const presets = raw.presets.map(preset => {
-            if (preset === null)
-                return null;
-            if (!record(preset) || typeof preset.name !== 'string' || !preset.name.trim() || typeof preset.savedAt !== 'string' ||
-                !record(preset.position) || typeof preset.position.pan !== 'number' || typeof preset.position.tilt !== 'number' ||
-                typeof preset.position.zoom !== 'number' || ![preset.position.pan, preset.position.tilt, preset.position.zoom].every(Number.isFinite)) {
-                throw new Error('Invalid PTZ preset');
-            }
-            const pan = preset.position.pan;
-            const tilt = preset.position.tilt;
-            const zoom = preset.position.zoom;
-            if (pan < -1 || pan > 1 || tilt < -1 || tilt > 1 || zoom < 0 || zoom > 1)
-                throw new Error('PTZ position is outside normalized limits');
-            return { name: preset.name.trim().slice(0, 48), savedAt: preset.savedAt,
-                position: { pan, tilt, zoom }, includeInPatrol: typeof preset.includeInPatrol === 'boolean' ? preset.includeInPatrol : true };
-        });
-        const defaultPreset = raw.defaultPreset;
-        if (defaultPreset !== undefined && (typeof defaultPreset !== 'number' || !Number.isInteger(defaultPreset) || defaultPreset < 0 ||
-            defaultPreset >= 5 || presets[defaultPreset] === null)) {
-            throw new Error('Invalid default PTZ preset');
-        }
-        if (!record(raw.tracking) || typeof raw.tracking.person !== 'boolean' || typeof raw.tracking.animal !== 'boolean' ||
-            typeof raw.tracking.vehicle !== 'boolean')
-            throw new Error('Invalid tracking flags');
-        cameras[cameraId] = { exportEnabled: raw.exportEnabled,
-            // Older saved camera configs predate the default. Initialize HEVC/HKSV3
-            // once after HAP restore, then persist the marker so later user choices stick.
-            recordingAudioDefaultInitialized: typeof raw.recordingAudioDefaultInitialized === 'boolean'
-                ? raw.recordingAudioDefaultInitialized : false,
-            videoMode: raw.videoMode === 'HKSV3_LOCAL_HEVC' ? 'HKSV3_LOCAL_HEVC' : 'CLASSIC_H264', ptzEnabled: raw.ptzEnabled,
-            patrolEnabled: typeof raw.patrolEnabled === 'boolean' ? raw.patrolEnabled : false,
-            ...(typeof raw.sourceId === 'string' && raw.sourceId ? { sourceId: raw.sourceId } : {}), presets,
-            patrolIntervalSeconds: typeof raw.patrolIntervalSeconds === 'number' && Number.isInteger(raw.patrolIntervalSeconds) &&
-                raw.patrolIntervalSeconds >= 5 && raw.patrolIntervalSeconds <= 300 ? raw.patrolIntervalSeconds : 15,
-            ...(typeof defaultPreset === 'number' ? { defaultPreset } : {}),
-            tracking: { person: raw.tracking.person, animal: raw.tracking.animal, vehicle: raw.tracking.vehicle } };
-    }
-    return { schemaVersion: 1, cameras };
-}
-export class AccessoryConfigStore {
-    store;
-    constructor(root) {
-        this.store = new AtomicJsonStore(join(root, 'accessories', 'config.json'), () => ({ schemaVersion: 1, cameras: {} }), decode);
-    }
-    async get(cameraId) {
-        const value = (await this.store.read()).cameras[cameraId];
-        return structuredClone(value ?? initialCamera());
-    }
-    async update(cameraId, change) {
-        if (!cameraId.trim())
-            throw new Error('Camera ID required');
-        const state = await this.store.update(current => {
-            const previous = current.cameras[cameraId] ?? initialCamera();
-            const updated = change(structuredClone(previous));
-            return { schemaVersion: 1, cameras: { ...current.cameras, [cameraId]: updated } };
-        });
-        return structuredClone(state.cameras[cameraId]);
-    }
-    async exportEnabled() {
-        const state = await this.store.read();
-        return Object.entries(state.cameras).filter(([, config]) => config.exportEnabled).map(([cameraId]) => cameraId);
-    }
-}

package/dist/accessories/CameraAccessoryManager.d.ts

@@ -1,125 +0,0 @@
-import type { CameraUiAdapter } from '../camera-ui/CameraUiAdapter.ts';
-import type { IdentityStore } from '../identity/IdentityStore.ts';
-import type { NativeVideoEngine } from '../media/NativeVideoEngine.ts';
-import type { Diagnostics } from '../diagnostics/Diagnostics.ts';
-import type { InspectableHapAdapter } from '../hap/HapAdapter.ts';
-import { AccessoryConfigStore, type HomeKitVideoMode } from './AccessoryConfigStore.ts';
-import { type H264AudioRuntime } from '../h264/AudioRuntime.ts';
-export interface AccessoryView {
-    cameraId: string;
-    name: string;
-    published: boolean;
-    paired: boolean;
-    sourceId?: string;
-    videoCodec?: string;
-    width?: number;
-    height?: number;
-    processing: 'UNKNOWN_NOT_VERIFIED';
-    audio: 'H264_NORMALIZED_AUDIO_UNVERIFIED' | 'PCMA_8KHZ_ADVERTISED_UNVERIFIED' | 'OPUS_48KHZ_20MS_FROM_PCMA_8KHZ_UNVERIFIED' | 'OPUS_48KHZ_OR_AAC_ELD_24KHZ_20MS_FROM_PCMA_8KHZ_UNVERIFIED';
-    entities: Array<{
-        id: string;
-        type: string;
-        name: string;
-        capabilities: string[];
-    }>;
-    ptz?: {
-        available: boolean;
-        enabled: boolean;
-        patrolEnabled: boolean;
-        capabilities: string[];
-        nativePresets?: string[];
-        positions: Array<({
-            name: string;
-            position: {
-                pan: number;
-                tilt: number;
-                zoom: number;
-            };
-            includeInPatrol: boolean;
-        } | null)>;
-        defaultPositionSlot?: number;
-        patrolIntervalSeconds: number;
-        position?: {
-            pan: number;
-            tilt: number;
-            zoom: number;
-        };
-    };
-    error?: string;
-}
-export interface PairingView {
-    setupUri: string;
-    manualCode: string;
-    paired: false;
-}
-export declare function brandedHomeKitSetupQr(setupUri: string, manualCode?: string, accessoryName?: string): Promise<string>;
-export declare function brandedHomeKitPlaceholderQr(statusBadge: string, lines: string[], footerBadge?: string, accessoryName?: string, variant?: 'info' | 'success' | 'warn'): string;
-export declare function formatHomeKitPin(value: number): string;
-/** Publishes one independent classic HAP camera accessory for an explicitly selected Camera.UI camera. */
-export declare class CameraAccessoryManager {
-    private readonly host;
-    private readonly hapAdapter;
-    private readonly identities;
-    private readonly video;
-    private readonly diagnostics;
-    private readonly storagePath;
-    private readonly h264AudioRuntime;
-    readonly config: AccessoryConfigStore;
-    private readonly live;
-    private readonly statuses;
-    private readonly serial;
-    private closed;
-    private readonly patrolJobs;
-    private readonly pendingPositionMoves;
-    private readonly stoppingPtz;
-    private readonly ptzStateListeners;
-    constructor(host: CameraUiAdapter, hapAdapter: InspectableHapAdapter, identities: IdentityStore, video: NativeVideoEngine, diagnostics: Diagnostics, storagePath: string, h264AudioRuntime?: () => Promise<H264AudioRuntime>);
-    start(): Promise<void>;
-    cameraAvailable(cameraId: string): Promise<void>;
-    cameraUnavailable(cameraId: string): Promise<void>;
-    sensorsChanged(): Promise<void>;
-    onPtzPatrolStateChanged(listener: (cameraId: string, enabled: boolean) => void): () => void;
-    enable(cameraId: string, sourceId: string, videoMode?: HomeKitVideoMode): Promise<void>;
-    disable(cameraId: string): Promise<void>;
-    /** Clears this accessory's local HAP pairing records. The Home app may also require removal on the iPhone. */
-    unlink(cameraId: string): Promise<void>;
-    ptzInfo(cameraId: string): Promise<AccessoryView['ptz']>;
-    setPtzEnabled(cameraId: string, enabled: boolean): Promise<void>;
-    setPtzPatrolEnabled(cameraId: string, enabled: boolean): Promise<void>;
-    savePtzPreset(cameraId: string, slot: number, name: string): Promise<void>;
-    setDefaultPtzPreset(cameraId: string, slot: number): Promise<void>;
-    setPtzPresetIncludedInPatrol(cameraId: string, slot: number, included: boolean): Promise<void>;
-    deletePtzPreset(cameraId: string, slot: number): Promise<void>;
-    movePtzRelative(cameraId: string, panDelta: number, tiltDelta: number, zoomDelta: number): Promise<void>;
-    jogPtz(cameraId: string, pan: number, tilt: number, zoom: number): Promise<void>;
-    stopPtz(cameraId: string): Promise<void>;
-    moveToPtzPreset(cameraId: string, slot: number): Promise<void>;
-    moveToDefaultPtzPreset(cameraId: string): Promise<void>;
-    pairing(cameraId: string): Promise<PairingView | undefined>;
-    pairingQr(cameraId: string): Promise<string>;
-    snapshot(): Promise<AccessoryView[]>;
-    close(): Promise<void>;
-    private publish;
-    private measuredSecureVideoTiers;
-    private updateMotionState;
-    private bindMotion;
-    private bindCameraEntities;
-    private entityView;
-    private storedPairingState;
-    private rotatePin;
-    private unpublish;
-    private disposeLive;
-    private refreshStatus;
-    private findPtz;
-    private presetNames;
-    private schedulePatrol;
-    private advancePatrol;
-    private failPatrol;
-    private clearPatrol;
-    private requirePtz;
-    private moveToSavedPosition;
-    private stopPtzMovement;
-    private validPosition;
-    private runtime;
-    private queue;
-}