@everfur/sdk 0.1.0

package/dist/video/index.d.cts

@@ -0,0 +1,66 @@
+import { f as EverfurError, E as EverfurResult } from '../EverfurResult-D92-uL82.cjs';
+export { g as EverfurErrorCategory, a as EverfurErrorCode } from '../EverfurResult-D92-uL82.cjs';
+import { J as JobId, P as PetRef } from '../ids-CJ1S6adf.cjs';
+export { B as Brand, _ as __brand } from '../ids-CJ1S6adf.cjs';
+import { M as MediaSource } from '../CameraPort-Cv31Pz7g.cjs';
+import { I as Interpretation } from '../projection-CeIUsbSk.cjs';
+import { ReactNode } from 'react';
+import { StyleProp, ViewStyle } from 'react-native';
+
+type JobLifecycle = 'queued' | 'processing' | 'complete' | 'failed';
+interface VideoDetection {
+    readonly label: string;
+    readonly confidence: number;
+    readonly timestampMs: number | null;
+    readonly durationMs: number | null;
+}
+/** Projector-safe only (§7). NO decision_audit / ood_layers / gate1_score EVER. */
+interface VideoAnalysisResult {
+    readonly jobId: JobId;
+    readonly analysisType: 'gait';
+    readonly detections: readonly VideoDetection[];
+    readonly interpretation: Interpretation | null;
+    readonly modelVersion: string | null;
+    /** Low-quality honesty (§9): an unusable video yields `usable:false`, not a fabricated finding. */
+    readonly quality: {
+        readonly usable: boolean;
+        readonly reasons: readonly string[];
+    };
+}
+type VideoStatus = 'idle' | 'uploading' | 'analyzing' | 'complete' | 'error';
+
+interface UseEverfurVideoState {
+    readonly status: VideoStatus;
+    readonly job: {
+        readonly id: JobId;
+        readonly state: JobLifecycle;
+    } | null;
+    readonly result: VideoAnalysisResult | null;
+    readonly error: EverfurError | null;
+    readonly isCaptureAvailable: boolean;
+    readonly progress: number;
+    /** true until the controller is committed; the component maps it to Loading. */
+    readonly isBootstrapping: boolean;
+    /** Upload + analyze a media source the host captured/picked. */
+    submit(source: MediaSource): Promise<EverfurResult<JobId>>;
+    /** Open the CameraPort (video) then submit; no-op when capture is unavailable. */
+    capture(): Promise<EverfurResult<JobId>>;
+    /** Abort the in-flight upload/poll; not an error (returns to idle). */
+    cancel(): void;
+}
+/**
+ * @throws {EverfurConfigError} kind 'not-initialized' if called outside an EverfurProvider.
+ * Auto-disposes its controller reference on unmount.
+ */
+declare function useEverfurVideo(opts?: {
+    readonly petRef?: PetRef;
+}): UseEverfurVideoState;
+
+interface EverfurVideoProps {
+    readonly petRef?: PetRef;
+    readonly style?: StyleProp<ViewStyle>;
+}
+/** Entitlement-gated, four-state gait/live-scan surface. */
+declare function EverfurVideo(props: EverfurVideoProps): ReactNode;
+
+export { EverfurError, EverfurResult, EverfurVideo, type EverfurVideoProps, Interpretation, JobId, type JobLifecycle, MediaSource, PetRef, type UseEverfurVideoState, type VideoAnalysisResult, type VideoDetection, type VideoStatus, useEverfurVideo };

package/dist/video/index.d.ts

@@ -0,0 +1,66 @@
+import { f as EverfurError, E as EverfurResult } from '../EverfurResult-D92-uL82.js';
+export { g as EverfurErrorCategory, a as EverfurErrorCode } from '../EverfurResult-D92-uL82.js';
+import { J as JobId, P as PetRef } from '../ids-CJ1S6adf.js';
+export { B as Brand, _ as __brand } from '../ids-CJ1S6adf.js';
+import { M as MediaSource } from '../CameraPort-Cv31Pz7g.js';
+import { I as Interpretation } from '../projection-CeIUsbSk.js';
+import { ReactNode } from 'react';
+import { StyleProp, ViewStyle } from 'react-native';
+
+type JobLifecycle = 'queued' | 'processing' | 'complete' | 'failed';
+interface VideoDetection {
+    readonly label: string;
+    readonly confidence: number;
+    readonly timestampMs: number | null;
+    readonly durationMs: number | null;
+}
+/** Projector-safe only (§7). NO decision_audit / ood_layers / gate1_score EVER. */
+interface VideoAnalysisResult {
+    readonly jobId: JobId;
+    readonly analysisType: 'gait';
+    readonly detections: readonly VideoDetection[];
+    readonly interpretation: Interpretation | null;
+    readonly modelVersion: string | null;
+    /** Low-quality honesty (§9): an unusable video yields `usable:false`, not a fabricated finding. */
+    readonly quality: {
+        readonly usable: boolean;
+        readonly reasons: readonly string[];
+    };
+}
+type VideoStatus = 'idle' | 'uploading' | 'analyzing' | 'complete' | 'error';
+
+interface UseEverfurVideoState {
+    readonly status: VideoStatus;
+    readonly job: {
+        readonly id: JobId;
+        readonly state: JobLifecycle;
+    } | null;
+    readonly result: VideoAnalysisResult | null;
+    readonly error: EverfurError | null;
+    readonly isCaptureAvailable: boolean;
+    readonly progress: number;
+    /** true until the controller is committed; the component maps it to Loading. */
+    readonly isBootstrapping: boolean;
+    /** Upload + analyze a media source the host captured/picked. */
+    submit(source: MediaSource): Promise<EverfurResult<JobId>>;
+    /** Open the CameraPort (video) then submit; no-op when capture is unavailable. */
+    capture(): Promise<EverfurResult<JobId>>;
+    /** Abort the in-flight upload/poll; not an error (returns to idle). */
+    cancel(): void;
+}
+/**
+ * @throws {EverfurConfigError} kind 'not-initialized' if called outside an EverfurProvider.
+ * Auto-disposes its controller reference on unmount.
+ */
+declare function useEverfurVideo(opts?: {
+    readonly petRef?: PetRef;
+}): UseEverfurVideoState;
+
+interface EverfurVideoProps {
+    readonly petRef?: PetRef;
+    readonly style?: StyleProp<ViewStyle>;
+}
+/** Entitlement-gated, four-state gait/live-scan surface. */
+declare function EverfurVideo(props: EverfurVideoProps): ReactNode;
+
+export { EverfurError, EverfurResult, EverfurVideo, type EverfurVideoProps, Interpretation, JobId, type JobLifecycle, MediaSource, PetRef, type UseEverfurVideoState, type VideoAnalysisResult, type VideoDetection, type VideoStatus, useEverfurVideo };