@stacksjs/mobile 0.75.22 → 0.75.23

package/README.md

@@ -55,3 +55,54 @@ The `health` facade reads authorized Apple Health or Android Health Connect
 metrics and writes completed workouts using one payload. `watchConnectivity`
 keeps companion controls and recording state synchronized without exposing
 platform bridge globals to application code.
+
+### Reading Apple Health
+
+`health.getWorkouts()` lists the workouts in Apple Health — the watch's, and
+every app's that writes there — newest first, with duration, distance, energy,
+heart rate and elevation, keyed on HealthKit's UUID so an import can be run
+again without duplicating. `health.getDailyStatistics(type)` returns one value
+per local day: a sum for `steps`, `activeEnergy` and `distance`, an average for
+`heartRate`, `restingHeartRate` and `heartRateVariability`, the latest
+`bodyMass`, and hours asleep for `sleep`, counted on the day you woke.
+
+```ts
+import { health } from '@stacksjs/mobile'
+
+await health.requestAuthorization(['workouts', 'heartRate', 'sleep', 'heartRateVariability'])
+const workouts = await health.getWorkouts({ startDate: Date.now() - 30 * 86400000 })
+const hrv = await health.getDailyStatistics('heartRateVariability', { startDate: Date.now() - 30 * 86400000 })
+```
+
+Both are iOS only for now; on Android they reject as unavailable.
+
+## Before the bridge arrives
+
+Craft installs `window.craft` once the page has finished loading, so
+`isNativeMobile()` answers `false` during setup on a phone. A decision made
+then — hide the website's header, show the app's tab bar — needs the answer
+when it is right:
+
+```ts
+import { hasNativeMobileHost, whenNativeMobile } from '@stacksjs/mobile'
+
+hasNativeMobileHost() // true inside the phone shell, even before the bridge
+const native = await whenNativeMobile() // resolves once it knows, false in a browser
+```
+
+## Page gestures and navigation
+
+The phone-native behaviour a screen expects, kept out of STX templates:
+
+- `observePullToRefresh({ onRefresh, onPull, threshold })` pulls the page down
+  from its top. On iOS it rides the system's rubber band; elsewhere the finger's
+  travel drives it. Crossing the threshold taps the haptic engine once.
+- `observePageScroll(offset => …)` reports the scroll offset at most once a
+  frame, for a bar that collapses as the page scrolls.
+- `goBack()` goes back through history when the app pushed the current screen,
+  and answers `false` otherwise so a back button follows its own link and never
+  leaves the app.
+
+The framework's `NativeNavBar`, `NativePullToRefresh`, `NativeSegmentedControl`
+and `NativeSheet` components are built on these.
+

package/dist/gestures.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The page's vertical scroll offset. Negative while iOS rubber-bands past the
+ * top, which is what pull-to-refresh reads.
+ */
+export declare function pageScrollTop(host?: ScrollHost | undefined): number;
+/**
+ * Calls `callback` with the page's scroll offset now and on every scroll, at
+ * most once a frame. Returns the unsubscribe.
+ */
+export declare function observePageScroll(callback: (offset: number) => void, host?: ScrollHost | undefined): () => void;
+/**
+ * How far a pull has travelled.
+ *
+ * iOS rubber-bands the page past its top, so the scroll offset itself goes
+ * negative and carries the system's own resistance curve. Android and desktop
+ * browsers stop at zero, so there the finger's travel counts, halved to feel
+ * like the same resistance.
+ */
+export declare function pullDistance(scrollTop: number, fingerTravel: number): number;
+/**
+ * Pull-to-refresh for the whole page.
+ *
+ * A pull starts only with the page at its top. Crossing the threshold gives a
+ * medium haptic tap, the moment a native list does; pulling back under 80% of
+ * it disarms. Letting go while armed runs `onRefresh`.
+ */
+export declare function observePullToRefresh(options: PullToRefreshOptions): () => void;
+/** Where a page scrolls: the window, or a stand-in with the same shape. */
+export declare interface ScrollHost extends EventTarget {
+  scrollY?: number
+  document?: { scrollingElement?: { scrollTop: number } | null }
+}
+export declare interface PullToRefreshOptions {
+  threshold?: number
+  onPull?: (distance: number, armed: boolean) => void
+  onRefresh: () => unknown | Promise<unknown>
+  host?: ScrollHost
+}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * Bundled TypeScript declarations
- * Generated from 2 source files
+ * Generated from 4 source files
  */
 
 
@@ -27,10 +27,101 @@ export declare const watchConnectivity: WatchConnectivityApi;
 /** Reads the current host, including a bridge injected after this module loaded. */
 export declare function getNativeMobileBridge(): CraftMobileBridge | null;
 export declare function isNativeMobile(): boolean;
+/**
+ * Whether this page runs inside Craft's phone shell, before the bridge exists.
+ *
+ * Craft installs `window.craft` once the page has finished loading — images
+ * and all — so `isNativeMobile()` answers `false` during setup on a phone, and
+ * a layout that decides then renders the website's chrome in the app. The
+ * transports are there from the start: Android's `CraftAndroid` interface, and
+ * on iOS the `craft` message handler. Craft's macOS windows carry that handler
+ * too, so on iOS an iPhone or iPad user agent is what makes it the phone app.
+ */
+export declare function hasNativeMobileHost(): boolean;
+/**
+ * Resolves `true` inside the phone shell and `false` in a browser, at a moment
+ * when the answer is right.
+ *
+ * A browser answers at once. A phone answers at once too when its host is
+ * already recognisable, and otherwise once `craftReady` fires. The timeout is
+ * a floor for a host that never fires it: a caller waiting on this has to
+ * decide something to render anything.
+ */
+export declare function whenNativeMobile(timeoutMs?: number): Promise<boolean>;
 export declare function onMobileReady(callback: (event: CraftReadyEvent) => void): () => void;
 export declare function withNativeFeedback<T>(action: () => T | Promise<T>): Promise<T>;
 export declare const mobile: MobileApi;
 
+// From: src/gestures.ts
+/** Where a page scrolls: the window, or a stand-in with the same shape. */
+export declare interface ScrollHost extends EventTarget {
+  scrollY?: number
+  document?: { scrollingElement?: { scrollTop: number } | null }
+}
+/**
+ * The page's vertical scroll offset. Negative while iOS rubber-bands past the
+ * top, which is what pull-to-refresh reads.
+ */
+export declare function pageScrollTop(host?: ScrollHost | undefined): number;
+/**
+ * Calls `callback` with the page's scroll offset now and on every scroll, at
+ * most once a frame. Returns the unsubscribe.
+ */
+export declare function observePageScroll(callback: (offset: number) => void, host?: ScrollHost | undefined): () => void;
+export declare interface PullToRefreshOptions {
+  threshold?: number
+  onPull?: (distance: number, armed: boolean) => void
+  onRefresh: () => unknown | Promise<unknown>
+  host?: ScrollHost
+}
+/**
+ * How far a pull has travelled.
+ *
+ * iOS rubber-bands the page past its top, so the scroll offset itself goes
+ * negative and carries the system's own resistance curve. Android and desktop
+ * browsers stop at zero, so there the finger's travel counts, halved to feel
+ * like the same resistance.
+ */
+export declare function pullDistance(scrollTop: number, fingerTravel: number): number;
+/**
+ * Pull-to-refresh for the whole page.
+ *
+ * A pull starts only with the page at its top. Crossing the threshold gives a
+ * medium haptic tap, the moment a native list does; pulling back under 80% of
+ * it disarms. Letting go while armed runs `onRefresh`.
+ */
+export declare function observePullToRefresh(options: PullToRefreshOptions): () => void;
+
+// From: src/navigation.ts
+/** The part of the window back navigation reads. */
+export declare interface HistoryHost {
+  history?: { state: unknown, back: () => void }
+}
+/** Whether going back stays inside this app. */
+export declare function canGoBack(host?: HistoryHost | undefined): boolean;
+/**
+ * Goes back through history when that stays inside the app, and says whether
+ * it did. When it answers `false` the caller follows its own link.
+ */
+export declare function goBack(host?: HistoryHost | undefined): boolean;
+/**
+ * The in-app path a deep link opens, or null when it is not this app's.
+ *
+ * A custom scheme carries the path after it — `myapp://m/workout/5` and
+ * `myapp:///m/workout/5` both open `/m/workout/5` — and a universal link on
+ * this app's origin opens its own path. A link to anywhere else is not
+ * followed from inside the app.
+ */
+export declare function deepLinkPath(link: string, origin?: string | undefined): string | null;
+/**
+ * Opens every deep link the app receives with `go`: the one it was launched
+ * with, once, and each one after. Returns the unsubscribe.
+ *
+ * The launch link is remembered for the session, so a full page load inside
+ * the app does not open it again.
+ */
+export declare function followDeepLinks(go: (path: string) => void, links: DeepLinksApi): () => void;
+
 // From: src/types.ts
 /** Enabled native features, not the hardware report from device.getCapabilities(). */
 export declare interface CraftMobileCapabilities {
@@ -107,6 +198,7 @@ export declare interface MobileApi {
   liveActivities: LiveActivitiesApi
   watchConnectivity: WatchConnectivityApi
   isNativeMobile: () => boolean
+  whenNative: (timeoutMs?: number) => Promise<boolean>
   onReady: (callback: (event: CraftReadyEvent) => void) => () => void
   withFeedback: <T>(action: () => T | Promise<T>) => Promise<T>
 }
@@ -274,7 +366,7 @@ export declare interface KeepAwakeApi {
 }
 export declare interface DeepLinksApi {
   getInitialURL: () => Promise<string | null>
-  onLink: (callback: (url: string) => void) => () => void
+  onLink: (callback: (url: string, link?: { initial: boolean }) => void) => () => void
 }
 export declare interface NetworkStatus {
   type: 'wifi' | 'cellular' | 'ethernet' | 'none' | 'unknown'
@@ -292,7 +384,17 @@ export declare interface PushNotificationsApi {
   onToken: (callback: (token: string) => void) => () => void
   onNotification: (callback: (data: Record<string, unknown>) => void) => () => void
 }
-export type HealthDataType = 'steps' | 'heartRate' | 'activeEnergy' | 'distance' | 'workouts';
+export type HealthDataType = | 'steps'
+  | 'heartRate'
+  | 'activeEnergy'
+  | 'distance'
+  | 'workouts'
+  | 'restingHeartRate'
+  | 'heartRateVariability'
+  | 'bodyMass'
+  | 'sleep';
+/** The types with one value per day. `sleep` is hours asleep, counted on the day you woke. */
+export type HealthDailyType = Exclude<HealthDataType, 'workouts'>;
 export declare interface HealthDataOptions {
   startDate?: number
   endDate?: number
@@ -321,10 +423,44 @@ export declare interface HealthWorkout {
 export declare interface HealthWorkoutResult {
   id: string
 }
+export declare interface HealthWorkoutQuery {
+  startDate?: number
+  endDate?: number
+  limit?: number
+}
+/** The activity of a workout read from Apple Health, named independently of the SDK. */
+export type HealthWorkoutActivity = | 'running' | 'cycling' | 'walking' | 'hiking' | 'swimming' | 'rowing' | 'elliptical'
+  | 'stairClimbing' | 'yoga' | 'pilates' | 'strength' | 'hiit' | 'crossTraining'
+  | 'crossCountrySkiing' | 'skiing' | 'paddling' | 'climbing' | 'dance' | 'mobility' | 'other';
+/** A workout recorded by the watch, or by any app that writes to Apple Health. */
+export declare interface HealthWorkoutSample {
+  id: string
+  type: HealthWorkoutActivity
+  startDate: number
+  endDate: number
+  durationSeconds: number
+  sourceName: string
+  indoor: boolean
+  distanceMeters?: number
+  elevationGainMeters?: number
+  activeEnergyCalories?: number
+  averageHeartRate?: number
+  maxHeartRate?: number
+}
+export declare interface HealthDailyValue {
+  date: string
+  value: number
+  unit: string
+}
+export declare interface HealthAuthorizationOptions {
+  write?: boolean
+}
 export declare interface HealthApi {
-  requestAuthorization: (types: HealthDataType[]) => Promise<boolean>
+  requestAuthorization: (types: HealthDataType[], options?: HealthAuthorizationOptions) => Promise<boolean>
   getData: (type: HealthDataType, options?: HealthDataOptions) => Promise<HealthDataResult>
   saveWorkout: (workout: HealthWorkout) => Promise<HealthWorkoutResult>
+  getWorkouts: (options?: HealthWorkoutQuery) => Promise<HealthWorkoutSample[]>
+  getDailyStatistics: (type: HealthDailyType, options?: HealthDataOptions) => Promise<HealthDailyValue[]>
 }
 export declare interface LiveActivityState {
   status?: string

package/dist/index.js

@@ -1 +1 @@
-import{appReview as p,biometrics as f,camera as l,deepLinks as a,device as u,haptics as A,health as v,keepAwake as d,lifecycle as m,liveActivities as w,location as y,network as h,notifications as k,permissions as x,pushNotifications as L,secureStorage as b,share as g,watchConnectivity as R}from"craft-native/mobile";var C=f,N=l,E=u,o=A,S=m,H=y,M=k,P=x,B=b,D=g,j=p;function c(t){if(typeof t==="string")return t.trim()||null;if(!t||typeof t!=="object")return null;let e=t.url;return typeof e==="string"&&e.trim()?e:null}var T={async getInitialURL(){return c(await a.getInitialURL?.())},onLink(t){return a.onLink?.((e)=>{let i=c(e);if(i)t(i)})??(()=>{})}},K=d,U=h,W=L,F=v,I=w,O=R;function s(){if(typeof window>"u")return;return window}function n(){let t=s()?.craft;if(!t||typeof t!=="object")return null;if(!("platform"in t)||t.platform!=="ios"&&t.platform!=="android")return null;let e="capabilities"in t?t.capabilities:void 0,i=e&&typeof e==="object"&&!Array.isArray(e)?Object.fromEntries(Object.entries(e).filter(([,r])=>typeof r==="boolean")):{};return{platform:t.platform,capabilities:i}}function q(){return n()!==null}function z(t){let e=s();if(!e)return()=>{};if(n()){let r=!1;return queueMicrotask(()=>{if(!r)t(new Event("craftReady"))}),()=>{r=!0}}let i=(r)=>{if(!n())return;e.removeEventListener("craftReady",i),t(r)};return e.addEventListener("craftReady",i),()=>e.removeEventListener("craftReady",i)}async function G(t){await o.impact("light");try{let e=await t();return await o.notification("success"),e}catch(e){throw await o.notification("error"),e}}var Q={get nativeBridge(){return n()},biometrics:C,camera:N,device:E,haptics:o,lifecycle:S,location:H,notifications:M,permissions:P,secureStorage:B,share:D,appReview:j,deepLinks:T,keepAwake:K,network:U,pushNotifications:W,health:F,liveActivities:I,watchConnectivity:O,isNativeMobile:q,onReady:z,withFeedback:G};export{j as appReview,C as biometrics,N as camera,T as deepLinks,E as device,n as getNativeMobileBridge,o as haptics,F as health,q as isNativeMobile,K as keepAwake,S as lifecycle,I as liveActivities,H as location,Q as mobile,U as network,c as normalizeDeepLinkURL,M as notifications,z as onMobileReady,P as permissions,W as pushNotifications,B as secureStorage,D as share,O as watchConnectivity,G as withNativeFeedback};
+import{appReview as S,biometrics as N,camera as T,deepLinks as x,device as M,haptics as D,health as B,keepAwake as Y,lifecycle as j,liveActivities as U,location as I,network as O,notifications as q,permissions as F,pushNotifications as K,secureStorage as W,share as z,watchConnectivity as G}from"craft-native/mobile";import{haptics as E}from"craft-native/mobile";function d(){if(typeof window>"u")return;return window}function u(t=d()){if(!t)return 0;if(typeof t.scrollY==="number")return t.scrollY;return t.document?.scrollingElement?.scrollTop??0}function he(t,e=d()){if(!e)return()=>{};let r=!1,n=typeof requestAnimationFrame==="function"?requestAnimationFrame:(o)=>setTimeout(o,16),i=()=>{if(r)return;r=!0,n(()=>{r=!1,t(u(e))})};return t(u(e)),e.addEventListener("scroll",i,{passive:!0}),()=>e.removeEventListener("scroll",i)}function H(t,e){let r=Math.max(0,-t),n=t<=0?Math.max(0,e)*0.5:0;return Math.round(Math.max(r,n))}function we(t){let e=t.host??d();if(!e)return()=>{};let r=t.threshold??72,n=null,i=!1,o=!1,c=(s)=>t.onPull?.(s,i),h=(s)=>{let a=s.touches?.[0];return a?a.clientY:null},w=(s)=>{if(o||u(e)>0)return;n=h(s),i=!1},A=(s)=>{if(n===null)return;let a=h(s);if(a===null)return;let p=H(u(e),a-n);if(!i&&p>=r)i=!0,Promise.resolve(E.impact("medium")).catch(()=>{});else if(i&&p<r*0.8)i=!1;c(p)},y=async()=>{if(n===null)return;if(n=null,!i){c(0);return}i=!1,o=!0,t.onPull?.(r,!1);try{await t.onRefresh()}finally{o=!1,c(0)}},b=()=>{if(n===null)return;n=null,i=!1,c(0)};return e.addEventListener("touchstart",w,{passive:!0}),e.addEventListener("touchmove",A,{passive:!0}),e.addEventListener("touchend",y),e.addEventListener("touchcancel",b),()=>{e.removeEventListener("touchstart",w),e.removeEventListener("touchmove",A),e.removeEventListener("touchend",y),e.removeEventListener("touchcancel",b)}}function k(){if(typeof window>"u")return;return window}function R(t=k()){let e=t?.history?.state;return e!==null&&e!==void 0}function ye(t=k()){if(!R(t))return!1;return t.history.back(),!0}function P(t,e=C()){let r;try{r=new URL(t)}catch{return null}let n=`${r.search}${r.hash}`;if(r.protocol==="http:"||r.protocol==="https:"){if(!e||r.origin!==e)return null;return`${r.pathname||"/"}${n}`}return`${`/${[r.host,r.pathname.replace(/^\/+/,"")].filter(Boolean).join("/")}`}${n}`}function C(){if(typeof window>"u")return;return window.location?.origin}var g="stacks-mobile-deep-link";function be(t,e){let r=(n)=>{let i=P(n);if(i)t(i)};return e.getInitialURL().then((n)=>{if(!n)return;try{if(sessionStorage.getItem(g)===n)return;sessionStorage.setItem(g,n)}catch{}r(n)}).catch(()=>{}),e.onLink((n,i)=>{if(i?.initial)return;r(n)})}var _=N,J=T,Q=M,f=D,V=j,X=I,Z=q,ee=F,te=W,ne=z,re=S;function L(t){if(typeof t==="string")return t.trim()||null;if(!t||typeof t!=="object")return null;let e=t.url;return typeof e==="string"&&e.trim()?e:null}var ie={async getInitialURL(){return L(await x.getInitialURL?.())},onLink(t){return x.onLink?.((e,r)=>{let n=L(e);if(n)t(n,{initial:r?.initial===!0})})??(()=>{})}},oe=Y,se=O,ae=K,ce=B,ue=U,fe=G;function v(){if(typeof window>"u")return;return window}function l(){let t=v()?.craft;if(!t||typeof t!=="object")return null;if(!("platform"in t)||t.platform!=="ios"&&t.platform!=="android")return null;let e="capabilities"in t?t.capabilities:void 0,r=e&&typeof e==="object"&&!Array.isArray(e)?Object.fromEntries(Object.entries(e).filter(([,n])=>typeof n==="boolean")):{};return{platform:t.platform,capabilities:r}}function m(){return l()!==null}function le(){if(typeof window>"u")return!1;let t=window;if(t.CraftAndroid)return!0;let e=typeof navigator>"u"?"":navigator.userAgent;return Boolean(t.webkit?.messageHandlers?.craft)&&/iPhone|iPad|iPod/.test(e)}function pe(t=2000){if(m()||le())return Promise.resolve(!0);let e=v(),r=e;if(!e||!(r?.craft||r?.webkit?.messageHandlers?.craft))return Promise.resolve(!1);return new Promise((n)=>{let i=()=>{clearTimeout(o),e.removeEventListener("craftReady",i),n(m())},o=setTimeout(i,t);e.addEventListener("craftReady",i,{once:!0})})}function de(t){let e=v();if(!e)return()=>{};if(l()){let n=!1;return queueMicrotask(()=>{if(!n)t(new Event("craftReady"))}),()=>{n=!0}}let r=(n)=>{if(!l())return;e.removeEventListener("craftReady",r),t(n)};return e.addEventListener("craftReady",r),()=>e.removeEventListener("craftReady",r)}async function me(t){await f.impact("light");try{let e=await t();return await f.notification("success"),e}catch(e){throw await f.notification("error"),e}}var xe={get nativeBridge(){return l()},biometrics:_,camera:J,device:Q,haptics:f,lifecycle:V,location:X,notifications:Z,permissions:ee,secureStorage:te,share:ne,appReview:re,deepLinks:ie,keepAwake:oe,network:se,pushNotifications:ae,health:ce,liveActivities:ue,watchConnectivity:fe,isNativeMobile:m,whenNative:pe,onReady:de,withFeedback:me};export{re as appReview,_ as biometrics,J as camera,R as canGoBack,P as deepLinkPath,ie as deepLinks,Q as device,be as followDeepLinks,l as getNativeMobileBridge,ye as goBack,f as haptics,le as hasNativeMobileHost,ce as health,m as isNativeMobile,oe as keepAwake,V as lifecycle,ue as liveActivities,X as location,xe as mobile,se as network,L as normalizeDeepLinkURL,Z as notifications,he as observePageScroll,we as observePullToRefresh,de as onMobileReady,u as pageScrollTop,ee as permissions,H as pullDistance,ae as pushNotifications,te as secureStorage,ne as share,fe as watchConnectivity,pe as whenNativeMobile,me as withNativeFeedback};

package/dist/navigation.d.ts

@@ -0,0 +1,29 @@
+import type { DeepLinksApi } from './types';
+/** Whether going back stays inside this app. */
+export declare function canGoBack(host?: HistoryHost | undefined): boolean;
+/**
+ * Goes back through history when that stays inside the app, and says whether
+ * it did. When it answers `false` the caller follows its own link.
+ */
+export declare function goBack(host?: HistoryHost | undefined): boolean;
+/**
+ * The in-app path a deep link opens, or null when it is not this app's.
+ *
+ * A custom scheme carries the path after it — `myapp://m/workout/5` and
+ * `myapp:///m/workout/5` both open `/m/workout/5` — and a universal link on
+ * this app's origin opens its own path. A link to anywhere else is not
+ * followed from inside the app.
+ */
+export declare function deepLinkPath(link: string, origin?: string | undefined): string | null;
+/**
+ * Opens every deep link the app receives with `go`: the one it was launched
+ * with, once, and each one after. Returns the unsubscribe.
+ *
+ * The launch link is remembered for the session, so a full page load inside
+ * the app does not open it again.
+ */
+export declare function followDeepLinks(go: (path: string) => void, links: DeepLinksApi): () => void;
+/** The part of the window back navigation reads. */
+export declare interface HistoryHost {
+  history?: { state: unknown, back: () => void }
+}

package/dist/types.d.ts

@@ -73,6 +73,7 @@ export declare interface MobileApi {
   liveActivities: LiveActivitiesApi
   watchConnectivity: WatchConnectivityApi
   isNativeMobile: () => boolean
+  whenNative: (timeoutMs?: number) => Promise<boolean>
   onReady: (callback: (event: CraftReadyEvent) => void) => () => void
   withFeedback: <T>(action: () => T | Promise<T>) => Promise<T>
 }
@@ -223,7 +224,7 @@ export declare interface KeepAwakeApi {
 }
 export declare interface DeepLinksApi {
   getInitialURL: () => Promise<string | null>
-  onLink: (callback: (url: string) => void) => () => void
+  onLink: (callback: (url: string, link?: { initial: boolean }) => void) => () => void
 }
 export declare interface NetworkStatus {
   type: 'wifi' | 'cellular' | 'ethernet' | 'none' | 'unknown'
@@ -268,10 +269,40 @@ export declare interface HealthWorkout {
 export declare interface HealthWorkoutResult {
   id: string
 }
+export declare interface HealthWorkoutQuery {
+  startDate?: number
+  endDate?: number
+  limit?: number
+}
+/** A workout recorded by the watch, or by any app that writes to Apple Health. */
+export declare interface HealthWorkoutSample {
+  id: string
+  type: HealthWorkoutActivity
+  startDate: number
+  endDate: number
+  durationSeconds: number
+  sourceName: string
+  indoor: boolean
+  distanceMeters?: number
+  elevationGainMeters?: number
+  activeEnergyCalories?: number
+  averageHeartRate?: number
+  maxHeartRate?: number
+}
+export declare interface HealthDailyValue {
+  date: string
+  value: number
+  unit: string
+}
+export declare interface HealthAuthorizationOptions {
+  write?: boolean
+}
 export declare interface HealthApi {
-  requestAuthorization: (types: HealthDataType[]) => Promise<boolean>
+  requestAuthorization: (types: HealthDataType[], options?: HealthAuthorizationOptions) => Promise<boolean>
   getData: (type: HealthDataType, options?: HealthDataOptions) => Promise<HealthDataResult>
   saveWorkout: (workout: HealthWorkout) => Promise<HealthWorkoutResult>
+  getWorkouts: (options?: HealthWorkoutQuery) => Promise<HealthWorkoutSample[]>
+  getDailyStatistics: (type: HealthDailyType, options?: HealthDataOptions) => Promise<HealthDailyValue[]>
 }
 export declare interface LiveActivityState {
   status?: string
@@ -312,5 +343,19 @@ export type PermissionType = | 'camera'
 export type PermissionStatus = 'granted' | 'denied' | 'undetermined' | 'restricted';
 export type BiometricType = 'faceId' | 'touchId' | 'fingerprint' | 'face' | 'iris';
 export type AppState = 'active' | 'inactive' | 'background';
-export type HealthDataType = 'steps' | 'heartRate' | 'activeEnergy' | 'distance' | 'workouts';
+export type HealthDataType = | 'steps'
+  | 'heartRate'
+  | 'activeEnergy'
+  | 'distance'
+  | 'workouts'
+  | 'restingHeartRate'
+  | 'heartRateVariability'
+  | 'bodyMass'
+  | 'sleep';
+/** The types with one value per day. `sleep` is hours asleep, counted on the day you woke. */
+export type HealthDailyType = Exclude<HealthDataType, 'workouts'>;
 export type HealthWorkoutType = 'running' | 'walking' | 'hiking' | 'cycling';
+/** The activity of a workout read from Apple Health, named independently of the SDK. */
+export type HealthWorkoutActivity = | 'running' | 'cycling' | 'walking' | 'hiking' | 'swimming' | 'rowing' | 'elliptical'
+  | 'stairClimbing' | 'yoga' | 'pilates' | 'strength' | 'hiit' | 'crossTraining'
+  | 'crossCountrySkiing' | 'skiing' | 'paddling' | 'climbing' | 'dance' | 'mobility' | 'other';

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/mobile",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.22",
+  "version": "0.75.23",
   "description": "Craft-powered native mobile runtime for Stacks and STX applications",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -32,10 +32,10 @@
     "test": "bun test"
   },
   "dependencies": {
-    "craft-native": ">=0.0.92"
+    "craft-native": ">=0.0.100"
   },
   "devDependencies": {
-    "@stacksjs/build": "0.75.22",
+    "@stacksjs/build": "0.75.23",
     "better-dx": "^0.2.24"
   }
 }