@tak-ps/cloudtak 13.77.0 → 13.78.0

package/dist/types/src/components/util/VideoPlayer.vue.d.ts

@@ -1,3 +1,5 @@
+import 'video.js/dist/video-js.css';
+import { type PlaybackProtocol } from './video/protocol.ts';
 export type VideoPlayerMetadata = {
     name: string;
     active: boolean;
@@ -12,9 +14,11 @@ type __VLS_Props = {
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     metadata: (metadata: VideoPlayerMetadata) => any;
     error: (error: Error) => any;
+    protocol: (protocol: PlaybackProtocol) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onMetadata?: ((metadata: VideoPlayerMetadata) => any) | undefined;
     onError?: ((error: Error) => any) | undefined;
+    onProtocol?: ((protocol: PlaybackProtocol) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/types/src/components/util/video/WhepReader.d.ts

@@ -0,0 +1,80 @@
+/**
+ * WhepReader - WebRTC/WHEP reader for MediaMTX streams.
+ *
+ * A TypeScript port of the MediaMTX `reader.js` (MediaMTXWebRTCReader) shipped
+ * with the MediaMTX web player, retaining its behaviour:
+ *   - ICE servers are discovered via an OPTIONS request (Link headers)
+ *   - The SDP offer is edited to enable stereo Opus & non-advertised codecs
+ *   - ICE candidates are trickled via PATCH (application/trickle-ice-sdpfrag)
+ *   - Failures tear the session down and restart after a short pause
+ *
+ * Credentials are sent via the Authorization header (never in the URL).
+ */
+export type WhepReaderConfig = {
+    /** Absolute URL of the WHEP endpoint */
+    url: string;
+    user?: string;
+    pass?: string;
+    token?: string;
+    /** Pause between restarts after an error (ms) */
+    retryPause?: number;
+    /** Abort a connection attempt that has not produced a track in this time (ms) */
+    connectTimeout?: number;
+    onError?: (err: string) => void;
+    onTrack?: (evt: RTCTrackEvent) => void;
+    onDataChannel?: (evt: RTCDataChannelEvent) => void;
+    /** Called once the peer connection reaches the connected state */
+    onConnected?: () => void;
+};
+type OfferData = {
+    iceUfrag: string;
+    icePwd: string;
+    medias: string[];
+};
+export default class WhepReader {
+    static DEFAULT_RETRY_PAUSE: number;
+    static DEFAULT_CONNECT_TIMEOUT: number;
+    private static nonAdvertisedCodecsProbe;
+    static isSupported(): boolean;
+    private conf;
+    private state;
+    private restartTimeout;
+    private connectTimeout;
+    private pc;
+    private offerData;
+    private sessionUrl;
+    private queuedCandidates;
+    private nonAdvertisedCodecs;
+    constructor(conf: WhepReaderConfig);
+    close(): void;
+    private static supportsNonAdvertisedCodec;
+    private static unquoteCredential;
+    static linkToIceServers(links: string | null): RTCIceServer[];
+    static parseOffer(sdp: string): OfferData;
+    private static reservePayloadType;
+    private static addCodec;
+    private static enableStereoPcmau;
+    private static enableMultichannelOpus;
+    private static enableL16;
+    private static enableStereoOpus;
+    static editOffer(sdp: string, nonAdvertisedCodecs: string[]): string;
+    static generateSdpFragment(od: OfferData, candidates: RTCIceCandidate[]): string;
+    private handleError;
+    private restart;
+    private static probeNonAdvertisedCodecs;
+    private getNonAdvertisedCodecs;
+    private start;
+    private armConnectTimeout;
+    private clearConnectTimeout;
+    private authHeader;
+    private requestICEServers;
+    private setupPeerConnection;
+    private sendOffer;
+    private setAnswer;
+    private onLocalCandidate;
+    private sendLocalCandidates;
+    private onConnectionState;
+    private onTrack;
+    private onDataChannel;
+}
+export {};

package/dist/types/src/components/util/video/protocol.d.ts

@@ -0,0 +1,26 @@
+import type { VideoLeaseProtocols } from '../../../types.ts';
+export type PlaybackProtocol = 'webrtc' | 'hls';
+/**
+ * Leases proxying an existing HTTP(S) source are HLS streams being re-served
+ * by MediaMTX - keep HLS as their default. Everything else (RTSP/RTMP/SRT/etc)
+ * is served over WebRTC with HLS as the fallback.
+ */
+export declare function isHlsSource(source?: string | null): boolean;
+/**
+ * Ordered list of protocols to attempt for playback - the first entry is the
+ * default and each subsequent entry is a fallback
+ */
+export declare function playbackOrder(protocols: VideoLeaseProtocols | undefined, source?: string | null, webrtcSupported?: boolean): PlaybackProtocol[];
+/**
+ * Split embedded basic-auth credentials out of a stream URL so they can be
+ * sent via the Authorization header instead of being exposed in the URL
+ */
+export declare function splitCredentials(input: string): {
+    url: string;
+    username: string;
+    password: string;
+};
+/**
+ * MediaMTX serves WHEP at `<webrtc path url>/whep`
+ */
+export declare function whepUrl(webrtc: string): string;

package/dist/types/src/stores/device/geolocation.d.ts

@@ -1,5 +1,16 @@
 import type { Position } from '@capacitor/geolocation';
 import type { DevicePermissionContext } from './types.ts';
+/**
+ * When set, the native layer POSTs each fix to `url` directly, independent of
+ * the WebView - iOS suspends the WebContent process in the background, so
+ * bridge-delivered fixes stop flowing while native delivery keeps working.
+ */
+export type NativeDeliveryOptions = {
+    url: string;
+    headers?: Record<string, string>;
+    /** Minimum ms between native POSTs (and the Android update interval). */
+    minIntervalMs?: number;
+};
 export declare class GeolocationPermission {
     private readonly context;
     constructor(context: DevicePermissionContext);
@@ -7,16 +18,22 @@ export declare class GeolocationPermission {
     private watchGeneration;
     private lastLocationTimestamp;
     private locationCallback;
-    private static readonly DISTANCE_FILTER_M;
     private static readonly SEED_TIMEOUT_MS;
     private static readonly SEED_MAX_AGE_MS;
     static supportsLocationRequests(): boolean;
     refreshStatus(): Promise<void>;
+    private refreshBackgroundStatus;
     request(onGranted?: () => void): Promise<void>;
     initializeSubscription(onGranted?: () => void): Promise<void>;
-    startWatch(onLocation: (position: Position) => void): Promise<void>;
+    startWatch(onLocation: (position: Position) => void, native?: NativeDeliveryOptions): Promise<void>;
     private seedImmediateFix;
     stopWatch(): Promise<void>;
     private startBackgroundWatch;
+    /**
+     * Point native POST delivery at a rotated auth token. Best-effort: the
+     * watch restarts with fresh headers on the next app boot regardless.
+     */
+    static updateNativeHeaders(headers: Record<string, string>): Promise<void>;
+    openNativeSettings(): Promise<void>;
     private static backgroundLocationToPosition;
 }

package/dist/types/src/stores/device/types.d.ts

@@ -1,5 +1,5 @@
-export type BrowserPermissionState = PermissionState | 'unsupported' | 'unknown';
-export type BrowserPermissionType = 'location' | 'notification' | 'orientation' | 'storage' | 'camera' | 'wakeLock' | 'fileSystem';
+export type BrowserPermissionState = PermissionState | 'when_in_use' | 'unsupported' | 'unknown';
+export type BrowserPermissionType = 'location' | 'backgroundLocation' | 'notification' | 'orientation' | 'storage' | 'camera' | 'wakeLock' | 'fileSystem';
 export type FileSystemAccessHandle = FileSystemHandle & {
     queryPermission?: (descriptor?: {
         mode?: 'read' | 'readwrite';

package/dist/types/src/stores/device.d.ts

@@ -13,6 +13,7 @@ export type { BrowserPermissionState, BrowserPermissionType } from './device/typ
 export { CameraPermission } from './device/camera.ts';
 export { FileSystemPermission } from './device/file-system.ts';
 export { GeolocationPermission } from './device/geolocation.ts';
+export type { NativeDeliveryOptions } from './device/geolocation.ts';
 export { BrowserNotificationPermission } from './device/notification.ts';
 export type { PushNotificationData } from './device/notification.ts';
 export { OrientationPermission } from './device/orientation.ts';
@@ -27,6 +28,7 @@ export declare const useDeviceStore: import("pinia").SetupStoreDefinition<"devic
         storage: BrowserPermissionState;
         orientation: BrowserPermissionState;
         location: BrowserPermissionState;
+        backgroundLocation: BrowserPermissionState;
         camera: BrowserPermissionState;
         wakeLock: BrowserPermissionState;
         fileSystem: BrowserPermissionState;

package/dist/types/src/stores/map.d.ts

@@ -13,7 +13,6 @@ import * as mapgl from 'maplibre-gl';
 import type Atlas from '../workers/atlas.ts';
 import type { Feature } from '../types.ts';
 import type { LngLat, Point, MapGeoJSONFeature } from 'maplibre-gl';
-import type { Position } from '@capacitor/geolocation';
 export type TAKNotification = {
     type: string;
     name: string;
@@ -37,7 +36,6 @@ export declare const useMapStore: import("pinia").StoreDefinition<"cloudtak", {
     };
     _overlayReconcile?: Promise<void>;
     _overlayReconcileQueued?: boolean;
-    _lastLocationHttpSubmit?: number;
     channel: BroadcastChannel;
     toImport: Feature[];
     locked: Array<string>;
@@ -159,7 +157,6 @@ export declare const useMapStore: import("pinia").StoreDefinition<"cloudtak", {
      */
     resumeFromBackground: () => Promise<void>;
     init: (container: HTMLElement) => Promise<void>;
-    submitLocationHttp: (position: Position) => Promise<void>;
     initOverlays: () => Promise<void>;
     /**
      * Reconcile the loaded map overlays against the local overlay

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@tak-ps/cloudtak",
     "type": "module",
-    "version": "13.77.0",
+    "version": "13.78.0",
     "types": "dist/types/plugin.d.ts",
     "files": [
         "dist/types"
@@ -100,6 +100,7 @@
         "terra-draw-route-snap-mode": "^0.4.1",
         "terra-route": "^0.0.18",
         "uuid": "^14.0.0",
+        "video.js": "^8.24.0",
         "vue": "^3.2.31",
         "vue-component-type-helpers": "^3.0.7",
         "vue-eslint-parser": "^10.4.1",