@chipmobilesdk/rn-camera 0.1.1 → 0.2.1

package/CHANGELOG.md

@@ -1,34 +1,107 @@
-# Changelog — @chipmobilesdk/rn-camera
-
-All notable changes to this package are documented here. The package follows semantic versioning.
-
-## 0.1.0 — 2026-07-26
-
-Initial release. New package, no existing consumers, **no migration required**.
-
-### Added
-
-- **Permission handling** as a seven-state contract (`undetermined`, `requesting`, `granted`, `denied`, `deniedPermanently`, `unavailable`, `unsupported`). Reading status never prompts; requesting never re-prompts after a permanent denial; revocations made in system settings are pushed to subscribers without an app restart.
-- **`CameraPreview`** surface with `cover`/`contain` resize modes, an overlay slot via `children`, and pass-through of consumer accessibility properties. Ships no styled UI and takes no theme dependency.
-- **Still capture** returning a file reference plus metadata. Undeterminable fields (`fileSize`, `orientation`) are explicitly marked unavailable rather than guessed or omitted. Quality and max-dimension hints are applied within device limits and reported back as effective values.
-- **Session lifecycle** — start, pause, resume, stop — that releases the camera on background, unmount, and stop, restarts on foreground when a surface is still mounted, and reports a single active session per process.
-- **Artifact ownership and cleanup**: an optional `destination` on the capture request switches the result to app-owned and writes there directly; everything else lands in the package cache directory. `cleanup()` is idempotent and refuses anything the package does not own. Orphans are swept at initialization under a 24-hour time-to-live.
-- **Capability reporting** for camera positions, flash, torch, orientation, and camera-less devices, with capture-time flash modes and a continuous torch that is forced off on pause, stop, and background.
-- **Coordinate mapping** — pure, bidirectional, accounting for scale, letterbox or crop, orientation, and front-camera mirroring, accurate within 2 device-independent pixels on a round trip.
-- **Typed error taxonomy** of 11 codes, each carrying a `recoverable` flag, plus a `redact()` helper.
-- **Test adapter** (`createTestCamera`) implementing the same published ports as the production adapters, so consuming apps can drive every permission, capability, and capture path with no hardware and no permission prompts.
-- **Opt-in diagnostics logger**, defaulting to no logging.
-
-### Guarantees
-
-- No network egress of any kind.
-- No location read, no location permission requested.
-- Nothing written to the device photo library or gallery.
-- No capture history or index retained.
-- No on-device inference, no frame processor, no AI-derived labels.
-
-### Notes
-
-- `react-native-vision-camera` (>= 5.1.1) is a **peer dependency**; the consuming app installs and links it. This package authors no native source.
-- Android `minSdkVersion` remains **24** — VisionCamera 5.1.1 declares 23 and resolves the root project value first.
-- The local frame-processing extension point is documented in the README but deliberately not exported. It is designed to arrive as an additive minor release.
+# @chipmobilesdk/rn-camera
+
+## 0.2.1
+
+### Patch Changes
+
+- Packaging only; no code change. The package no longer declares `engines.node`: a
+  React Native package does not run on Node, so the field only produced install
+  warnings in apps on another Node version. rn-i18n's command-line tooling does run
+  on Node; its README's compatibility table states the version it needs. ([#14](https://github.com/operationd8979/chip-mobile-sdk/pull/14))
+
+## [0.2.0] — 2026-11-01
+
+Lifecycle and capture-path fixes. **No code change is required**; two behaviours
+change (see Changed), and a store that should manage VisionCamera captures needs a
+`FileSystemBridge` with `move()`.
+
+### Fixed
+
+- **`useCameraController` survives a StrictMode remount.** The cleanup disposed the
+  only controller and the remount kept it, so the screen showed `idle` forever and
+  backgrounding no longer released the camera. A disposed controller is now replaced,
+  and constructing one has no side effects (it subscribes on first use), so a
+  controller React builds and discards no longer leaks listeners.
+- **`CameraPreview` subscribes to the controller.** It read `controller.state` once
+  per render, so the feed could stay unmounted after the session became active unless
+  the parent re-rendered. `useCameraState` now uses `useSyncExternalStore`.
+- **A failed capture no longer leaves `capturing: true` published**, and `capturing:
+  true` is now published at all — the single-flight slot was taken after the first
+  emit. A raw native or engine error is turned into `CameraError('captureFailed')`
+  (or `storageFailure` when saving fails), with no file path in the message.
+- **Foregrounding restarts only a session that backgrounding interrupted.** It used
+  to start any idle or stopped session while a preview was mounted — including one
+  the user had stopped, one never started, and one whose permission had been revoked.
+  A foreground that arrives while the release is still running now waits for it
+  instead of being dropped.
+- **Use after dispose is defined.** `start`, `resume`, `capture`, and the permission
+  and capability reads reject with `CameraError('notReady')`; `stop`, `pause` and
+  `cleanup` are safe no-ops.
+- **VisionCamera captures can be cleaned up.** They were saved in VisionCamera's own
+  temporary directory, outside the store, so `cleanup()` refused them and the 24-hour
+  sweep never saw them. The controller now moves each package-temporary capture into
+  the store (`ArtifactStore.adopt`), and the sweep spares captures adopted by the
+  running process. With no store, or a bridge without `move()`, the logger reports
+  `unmanaged:no-store` / `unmanaged:store-cannot-adopt` once.
+- **No more "Camera is not active" error on every session start.** The feed sent
+  `torchMode="off"` on mount; VisionCamera applies it before the camera is active
+  and leaves the native rejection unhandled. The prop is now left unset until the
+  torch is first turned on.
+- **One throwing state listener no longer breaks a transition** or starves the other
+  listeners; it is logged as `listener-threw`.
+
+### Changed
+
+- **`effectiveQuality` and `effectiveMaxDimension` report what was applied.** The
+  VisionCamera adapter echoed the request hints. Quality is fixed on the photo output
+  (0.9) and nothing resizes, so it now reports `0.9` and an unavailable max dimension.
+- **Unmounting a preview over an idle controller leaves it `idle`**, rather than
+  driving it through `stopping` to `stopped` and calling the engine's `stop()`.
+
+### Added
+
+- `ArtifactStore.adopt?(uri)` and `FileSystemBridge.move?(from, to)`, both optional.
+  `createMemoryFileSystem()` implements `move`.
+
+### Docs
+
+- The README no longer claims quality and max-dimension hints are applied, or a
+  single active session per process.
+
+## 0.1.1 — 2026-08-01
+
+### Changed
+
+- The package now ships its agent skill (`skills/`), which consuming apps
+  copy in with `scripts/sync-sdk-skills.mjs`. No code change.
+
+## 0.1.0 — 2026-07-26
+
+Initial release. New package, no existing consumers, **no migration required**.
+
+### Added
+
+- **Permission handling** as a seven-state contract (`undetermined`, `requesting`, `granted`, `denied`, `deniedPermanently`, `unavailable`, `unsupported`). Reading status never prompts; requesting never re-prompts after a permanent denial; revocations made in system settings are pushed to subscribers without an app restart.
+- **`CameraPreview`** surface with `cover`/`contain` resize modes, an overlay slot via `children`, and pass-through of consumer accessibility properties. Ships no styled UI and takes no theme dependency.
+- **Still capture** returning a file reference plus metadata. Undeterminable fields (`fileSize`, `orientation`) are explicitly marked unavailable rather than guessed or omitted. Quality and max-dimension hints are normalized and reported back as effective values.
+- **Session lifecycle** — start, pause, resume, stop — that releases the camera on background, unmount, and stop, restarts on foreground when a surface is still mounted, and reports a single active session per controller.
+- **Artifact ownership and cleanup**: an optional `destination` on the capture request switches the result to app-owned and writes there directly; everything else lands in the package cache directory. `cleanup()` is idempotent and refuses anything the package does not own. Orphans are swept at initialization under a 24-hour time-to-live.
+- **Capability reporting** for camera positions, flash, torch, orientation, and camera-less devices, with capture-time flash modes and a continuous torch that is forced off on pause, stop, and background.
+- **Coordinate mapping** — pure, bidirectional, accounting for scale, letterbox or crop, orientation, and front-camera mirroring, accurate within 2 device-independent pixels on a round trip.
+- **Typed error taxonomy** of 11 codes, each carrying a `recoverable` flag, plus a `redact()` helper.
+- **Test adapter** (`createTestCamera`) implementing the same published ports as the production adapters, so consuming apps can drive every permission, capability, and capture path with no hardware and no permission prompts.
+- **Opt-in diagnostics logger**, defaulting to no logging.
+
+### Guarantees
+
+- No network egress of any kind.
+- No location read, no location permission requested.
+- Nothing written to the device photo library or gallery.
+- No capture history or index retained.
+- No on-device inference, no frame processor, no AI-derived labels.
+
+### Notes
+
+- `react-native-vision-camera` (>= 5.1.1) is a **peer dependency**; the consuming app installs and links it. This package authors no native source.
+- Android `minSdkVersion` remains **24** — VisionCamera 5.1.1 declares 23 and resolves the root project value first.
+- The local frame-processing extension point is documented in the README but deliberately not exported. It is designed to arrive as an additive minor release.