react-native-step-tracker-pro 1.0.0

package/lib/module/index.js

@@ -0,0 +1,7 @@
+"use strict";
+
+export { StepTracker, StepTracker as default, isSupported } from './StepTracker';
+export { StepTrackerError } from './errors';
+export { DEFAULT_CONFIG, STRIDE_COEFFICIENT } from './constants';
+export * from './hooks';
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["StepTracker","default","isSupported","StepTrackerError","DEFAULT_CONFIG","STRIDE_COEFFICIENT"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEA,WAAW,IAAIC,OAAO,EAAEC,WAAW,QAAQ,eAAe;AAChF,SAASC,gBAAgB,QAAQ,UAAU;AAE3C,SAASC,cAAc,EAAEC,kBAAkB,QAAQ,aAAa;AAChE,cAAc,SAAS","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/module/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["types.ts"],"mappings":"","ignoreList":[]}

package/lib/typescript/NativeStepTrackerPro.d.ts

@@ -0,0 +1,50 @@
+import type { TurboModule } from 'react-native';
+import type { UnsafeObject } from 'react-native/Libraries/Types/CodegenTypes';
+/**
+ * Codegen spec. Everything crossing the bridge is an UnsafeObject so that a
+ * single native method can evolve without a codegen break; the strongly typed
+ * surface lives in `StepTracker.ts`, which is what consumers import.
+ */
+export interface Spec extends TurboModule {
+    initialize(config: UnsafeObject): Promise<UnsafeObject>;
+    updateConfig(config: UnsafeObject): Promise<UnsafeObject>;
+    getConfig(): Promise<UnsafeObject>;
+    startTracking(): Promise<UnsafeObject>;
+    pauseTracking(): Promise<UnsafeObject>;
+    resumeTracking(): Promise<UnsafeObject>;
+    stopTracking(): Promise<UnsafeObject>;
+    getTrackingState(): Promise<UnsafeObject>;
+    isTracking(): Promise<boolean>;
+    getTodaySteps(): Promise<UnsafeObject>;
+    getStepsForDate(date: string): Promise<UnsafeObject>;
+    getYesterdaySteps(): Promise<UnsafeObject>;
+    getStatsForRange(startDate: string, endDate: string): Promise<UnsafeObject>;
+    getWeeklyStats(options: UnsafeObject): Promise<UnsafeObject>;
+    getMonthlyStats(options: UnsafeObject): Promise<UnsafeObject>;
+    getYearlyStats(options: UnsafeObject): Promise<UnsafeObject>;
+    getHistory(startDate: string, endDate: string): Promise<UnsafeObject>;
+    resetToday(): Promise<boolean>;
+    clearHistory(): Promise<boolean>;
+    pruneHistory(retentionDays: number): Promise<number>;
+    checkPermissions(): Promise<UnsafeObject>;
+    requestPermissions(): Promise<UnsafeObject>;
+    getDeviceCapabilities(): Promise<UnsafeObject>;
+    openAppSettings(): Promise<boolean>;
+    isBatteryOptimizationEnabled(): Promise<boolean>;
+    requestDisableBatteryOptimization(): Promise<boolean>;
+    openBatteryOptimizationSettings(): Promise<boolean>;
+    openManufacturerAutoStartSettings(): Promise<boolean>;
+    getHealthConnectStatus(): Promise<UnsafeObject>;
+    requestHealthConnectPermissions(): Promise<UnsafeObject>;
+    openHealthConnectSettings(): Promise<boolean>;
+    readHealthConnectSteps(startIso: string, endIso: string): Promise<UnsafeObject>;
+    writeHealthConnectSteps(date: string): Promise<boolean>;
+    syncWithHealthConnect(): Promise<UnsafeObject>;
+    getPendingSyncCount(): Promise<number>;
+    syncNow(): Promise<UnsafeObject>;
+    addListener(eventName: string): void;
+    removeListeners(count: number): void;
+}
+declare const _default: Spec | null;
+export default _default;
+//# sourceMappingURL=NativeStepTrackerPro.d.ts.map

package/lib/typescript/NativeStepTrackerPro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeStepTrackerPro.d.ts","sourceRoot":"","sources":["../../src/NativeStepTrackerPro.ts"],"names":[],"mappings":"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"}

package/lib/typescript/StepTracker.d.ts

@@ -0,0 +1,76 @@
+import type { DayRecord, DeviceCapabilities, EventSubscription, HealthConnectStatus, PermissionStatus, RangeOptions, RangeStats, StepSnapshot, StepTrackerConfig, StepTrackerEvent, StepTrackerEventMap, SyncEvent, TrackingState } from './types';
+/** Android is the only supported platform; call this before anything else. */
+export declare function isSupported(): boolean;
+/**
+ * The public API. All methods reject with a `StepTrackerError` carrying a
+ * stable `code`, so callers can branch without string matching.
+ */
+export declare const StepTracker: {
+    /**
+     * Loads config into the native layer and restores any persisted state.
+     * Safe to call on every app launch — it is idempotent.
+     */
+    initialize(config?: StepTrackerConfig): Promise<StepSnapshot>;
+    /** Patches config at runtime. Notification and goals update immediately. */
+    updateConfig(config: StepTrackerConfig): Promise<StepTrackerConfig>;
+    getConfig(): Promise<StepTrackerConfig>;
+    /** Starts the foreground service. Requires permissions to be granted first. */
+    startTracking(): Promise<StepSnapshot>;
+    /** Keeps the service and notification alive but ignores sensor deltas. */
+    pauseTracking(): Promise<StepSnapshot>;
+    resumeTracking(): Promise<StepSnapshot>;
+    /** Flushes to the database, unregisters sensors and kills the service. */
+    stopTracking(): Promise<StepSnapshot>;
+    getTrackingState(): Promise<TrackingState>;
+    isTracking(): Promise<boolean>;
+    getTodaySteps(): Promise<StepSnapshot>;
+    getYesterdaySteps(): Promise<DayRecord>;
+    /** @param date yyyy-MM-dd */
+    getStepsForDate(date: string): Promise<DayRecord>;
+    getWeeklyStats(options?: RangeOptions): Promise<RangeStats>;
+    getMonthlyStats(options?: RangeOptions): Promise<RangeStats>;
+    getYearlyStats(options?: RangeOptions): Promise<RangeStats>;
+    /** Inclusive on both ends. Dates are yyyy-MM-dd, and start must precede end. */
+    getStatsForRange(startDate: string, endDate: string): Promise<RangeStats>;
+    getHistory(startDate: string, endDate: string): Promise<DayRecord[]>;
+    /** Zeroes today's counter without touching history. Useful in QA builds. */
+    resetToday(): Promise<boolean>;
+    clearHistory(): Promise<boolean>;
+    /** Deletes rows older than `retentionDays`; returns rows removed. */
+    pruneHistory(retentionDays?: number): Promise<number>;
+    checkPermissions(): Promise<PermissionStatus>;
+    /** Shows the Android runtime dialogs. Must be called with an Activity attached. */
+    requestPermissions(): Promise<PermissionStatus>;
+    getDeviceCapabilities(): Promise<DeviceCapabilities>;
+    openAppSettings(): Promise<boolean>;
+    /** True when the OS is still applying doze restrictions to this app. */
+    isBatteryOptimizationEnabled(): Promise<boolean>;
+    /**
+     * Shows the system exemption dialog. Play policy requires an eligible use
+     * case — see docs/PLAY_STORE_COMPLIANCE.md before shipping this.
+     */
+    requestDisableBatteryOptimization(): Promise<boolean>;
+    /** Policy-safe alternative: opens the settings list, no direct prompt. */
+    openBatteryOptimizationSettings(): Promise<boolean>;
+    /** Best-effort deep link into Xiaomi/Oppo/Vivo/Huawei autostart screens. */
+    openManufacturerAutoStartSettings(): Promise<boolean>;
+    getHealthConnectStatus(): Promise<HealthConnectStatus>;
+    requestHealthConnectPermissions(): Promise<HealthConnectStatus>;
+    openHealthConnectSettings(): Promise<boolean>;
+    /** ISO-8601 instants, e.g. '2026-09-01T00:00:00Z'. */
+    readHealthConnectSteps(startIso: string, endIso: string): Promise<{
+        totalSteps: number;
+        records: DayRecord[];
+    }>;
+    /** Upserts one day's steps/distance/calories into Health Connect. */
+    writeHealthConnectSteps(date: string): Promise<boolean>;
+    syncWithHealthConnect(): Promise<SyncEvent>;
+    getPendingSyncCount(): Promise<number>;
+    /** Runs Health Connect + remote sync immediately instead of waiting for WorkManager. */
+    syncNow(): Promise<SyncEvent[]>;
+    addListener<E extends StepTrackerEvent>(event: E, listener: (payload: StepTrackerEventMap[E]) => void): EventSubscription;
+    /** Removes every listener for one event, or all events when omitted. */
+    removeListener(event?: StepTrackerEvent): void;
+};
+export default StepTracker;
+//# sourceMappingURL=StepTracker.d.ts.map

package/lib/typescript/StepTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepTracker.d.ts","sourceRoot":"","sources":["../../src/StepTracker.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,EACT,aAAa,EACd,MAAM,SAAS,CAAC;AAqBjB,8EAA8E;AAC9E,wBAAgB,WAAW,IAAI,OAAO,CAKrC;AAqGD;;;GAGG;AACH,eAAO,MAAM,WAAW;IACtB;;;OAGG;wBACsB,iBAAiB,GAAQ,OAAO,CAAC,YAAY,CAAC;IAOvE,4EAA4E;yBACjD,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;iBAmBtD,OAAO,CAAC,iBAAiB,CAAC;IAI7C,+EAA+E;qBACxD,OAAO,CAAC,YAAY,CAAC;IAI5C,0EAA0E;qBACnD,OAAO,CAAC,YAAY,CAAC;sBAIpB,OAAO,CAAC,YAAY,CAAC;IAI7C,0EAA0E;oBACpD,OAAO,CAAC,YAAY,CAAC;wBAIjB,OAAO,CAAC,aAAa,CAAC;kBAO5B,OAAO,CAAC,OAAO,CAAC;qBAMb,OAAO,CAAC,YAAY,CAAC;yBAIjB,OAAO,CAAC,SAAS,CAAC;IAI7C,6BAA6B;0BACD,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;6BAIzB,YAAY,GAAQ,OAAO,CAAC,UAAU,CAAC;8BAItC,YAAY,GAAQ,OAAO,CAAC,UAAU,CAAC;6BAIxC,YAAY,GAAQ,OAAO,CAAC,UAAU,CAAC;IAIrE,gFAAgF;gCAC9C,MAAM,WAAW,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;0BAOnD,MAAM,WAAW,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAU1E,4EAA4E;kBACxD,OAAO,CAAC,OAAO,CAAC;oBAId,OAAO,CAAC,OAAO,CAAC;IAItC,qEAAqE;iCAClC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;wBAUjC,OAAO,CAAC,gBAAgB,CAAC;IAInD,mFAAmF;0BACvD,OAAO,CAAC,gBAAgB,CAAC;6BAItB,OAAO,CAAC,kBAAkB,CAAC;uBAMjC,OAAO,CAAC,OAAO,CAAC;IAMzC,wEAAwE;oCAClC,OAAO,CAAC,OAAO,CAAC;IAItD;;;OAGG;yCACwC,OAAO,CAAC,OAAO,CAAC;IAI3D,0EAA0E;uCACjC,OAAO,CAAC,OAAO,CAAC;IAIzD,4EAA4E;yCACjC,OAAO,CAAC,OAAO,CAAC;8BAM3B,OAAO,CAAC,mBAAmB,CAAC;uCAMnB,OAAO,CAAC,mBAAmB,CAAC;iCAMlC,OAAO,CAAC,OAAO,CAAC;IAInD,sDAAsD;qCAE1C,MAAM,UACR,MAAM,GACb,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;IAMxD,qEAAqE;kCACjC,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;6BAI9B,OAAO,CAAC,SAAS,CAAC;2BAMpB,OAAO,CAAC,MAAM,CAAC;IAI5C,wFAAwF;eACvE,OAAO,CAAC,SAAS,EAAE,CAAC;gBASzB,CAAC,SAAS,gBAAgB,SAC7B,CAAC,YACE,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,GAClD,iBAAiB;IAMpB,wEAAwE;2BACjD,gBAAgB,GAAG,IAAI;CAkB/C,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/lib/typescript/constants.d.ts

@@ -0,0 +1,10 @@
+import type { StepTrackerConfig } from './types';
+export declare const MODULE_NAME = "StepTrackerPro";
+export declare const DEFAULT_CONFIG: Required<Pick<StepTrackerConfig, 'height' | 'weight' | 'sex' | 'dailyGoal' | 'calorieCoefficient' | 'historyRetentionDays' | 'notificationActions' | 'notificationThrottleMs' | 'eventThrottleMs' | 'persistEveryNSteps' | 'healthConnectEnabled' | 'healthConnectSyncIntervalMinutes' | 'autoStartOnBoot'>>;
+/** Stride length = height(cm) * coefficient / 100. */
+export declare const STRIDE_COEFFICIENT: {
+    readonly male: 0.415;
+    readonly female: 0.413;
+    readonly unspecified: 0.414;
+};
+//# sourceMappingURL=constants.d.ts.map

package/lib/typescript/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,eAAO,MAAM,WAAW,mBAAmB,CAAC;AAE5C,eAAO,MAAM,cAAc,EAAE,QAAQ,CACnC,IAAI,CACF,iBAAiB,EACf,QAAQ,GACR,QAAQ,GACR,KAAK,GACL,WAAW,GACX,oBAAoB,GACpB,sBAAsB,GACtB,qBAAqB,GACrB,wBAAwB,GACxB,iBAAiB,GACjB,oBAAoB,GACpB,sBAAsB,GACtB,kCAAkC,GAClC,iBAAiB,CACpB,CAeF,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC"}

package/lib/typescript/errors.d.ts

@@ -0,0 +1,8 @@
+export type StepTrackerErrorCode = 'E_UNSUPPORTED_PLATFORM' | 'E_NO_SENSOR' | 'E_NOT_INITIALIZED' | 'E_PERMISSION_DENIED' | 'E_SERVICE_START_FAILED' | 'E_HEALTH_CONNECT_UNAVAILABLE' | 'E_HEALTH_CONNECT_DENIED' | 'E_DATABASE' | 'E_INVALID_CONFIG' | 'E_NO_ACTIVITY' | 'E_NOT_TRACKING' | 'E_UNKNOWN';
+export declare class StepTrackerError extends Error {
+    readonly code: StepTrackerErrorCode;
+    constructor(code: StepTrackerErrorCode, message: string);
+}
+/** Normalises rejections coming off the native bridge. */
+export declare function toStepTrackerError(error: unknown): StepTrackerError;
+//# sourceMappingURL=errors.d.ts.map

package/lib/typescript/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC5B,wBAAwB,GACxB,aAAa,GACb,mBAAmB,GACnB,qBAAqB,GACrB,wBAAwB,GACxB,8BAA8B,GAC9B,yBAAyB,GACzB,YAAY,GACZ,kBAAkB,GAClB,eAAe,GACf,gBAAgB,GAChB,WAAW,CAAC;AAEhB,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;gBAExB,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM;CAKxD;AAED,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAKnE"}

package/lib/typescript/hooks/index.d.ts

@@ -0,0 +1,5 @@
+export { useStepTracker } from './useStepTracker';
+export type { UseStepTrackerOptions, UseStepTrackerResult } from './useStepTracker';
+export { useStepStats } from './useStepStats';
+export type { StatsPeriod, UseStepStatsResult } from './useStepStats';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/typescript/hooks/useStepStats.d.ts

@@ -0,0 +1,11 @@
+import type { RangeOptions, RangeStats } from '../types';
+export type StatsPeriod = 'week' | 'month' | 'year';
+export interface UseStepStatsResult {
+    stats: RangeStats | null;
+    loading: boolean;
+    error: Error | null;
+    reload: () => Promise<void>;
+}
+/** Fetches a windowed summary and refreshes it when the day rolls over. */
+export declare function useStepStats(period: StatsPeriod, options?: RangeOptions): UseStepStatsResult;
+//# sourceMappingURL=useStepStats.d.ts.map

package/lib/typescript/hooks/useStepStats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStepStats.d.ts","sourceRoot":"","sources":["../../../src/hooks/useStepStats.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,YAAiB,GACzB,kBAAkB,CAqCpB"}

package/lib/typescript/hooks/useStepTracker.d.ts

@@ -0,0 +1,26 @@
+import type { GoalReachedEvent, StepSnapshot, StepTrackerConfig, TrackingState } from '../types';
+export interface UseStepTrackerOptions extends StepTrackerConfig {
+    /** Initialise and start tracking as soon as permissions allow. Default false. */
+    autoStart?: boolean;
+    /** Refetch the snapshot when the app returns to the foreground. Default true. */
+    refreshOnForeground?: boolean;
+    onGoalReached?: (event: GoalReachedEvent) => void;
+}
+export interface UseStepTrackerResult {
+    snapshot: StepSnapshot | null;
+    state: TrackingState;
+    ready: boolean;
+    error: Error | null;
+    start: () => Promise<void>;
+    pause: () => Promise<void>;
+    resume: () => Promise<void>;
+    stop: () => Promise<void>;
+    refresh: () => Promise<void>;
+    requestPermissions: () => Promise<boolean>;
+}
+/**
+ * Wires the tracker into a component: initialises once, subscribes to
+ * `stepsChanged`, and re-reads the snapshot when the app is foregrounded.
+ */
+export declare function useStepTracker(options?: UseStepTrackerOptions): UseStepTrackerResult;
+//# sourceMappingURL=useStepTracker.d.ts.map

package/lib/typescript/hooks/useStepTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStepTracker.d.ts","sourceRoot":"","sources":["../../../src/hooks/useStepTracker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACd,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,kBAAkB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,CAiItB"}

package/lib/typescript/index.d.ts

@@ -0,0 +1,7 @@
+export { StepTracker, StepTracker as default, isSupported } from './StepTracker';
+export { StepTrackerError } from './errors';
+export type { StepTrackerErrorCode } from './errors';
+export { DEFAULT_CONFIG, STRIDE_COEFFICIENT } from './constants';
+export * from './hooks';
+export type { DayChangedEvent, DayRecord, DeviceCapabilities, EventSubscription, GoalProgressEvent, GoalReachedEvent, HealthConnectStatus, PermissionStatus, RangeOptions, RangeStats, SensorSource, Sex, StepSnapshot, StepTrackerConfig, StepTrackerEvent, StepTrackerEventMap, StepsChangedEvent, SyncEvent, TrackingState, TrackingStateEvent, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,IAAI,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjE,cAAc,SAAS,CAAC;AACxB,YAAY,EACV,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,GAAG,EACH,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/lib/typescript/types.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Public type definitions for react-native-step-tracker-pro.
+ */
+/** Biological sex is only used to pick a stride-length coefficient. */
+export type Sex = 'male' | 'female' | 'unspecified';
+/** Which hardware sensor the service ended up using. */
+export type SensorSource = 'step_counter' | 'step_detector' | 'none';
+export type TrackingState = 'idle' | 'running' | 'paused' | 'stopped' | 'unsupported';
+export interface StepTrackerConfig {
+    /** Height in centimetres. Used for stride length. Default 170. */
+    height?: number;
+    /** Weight in kilograms. Used for calorie estimation. Default 70. */
+    weight?: number;
+    /**
+     * Overrides the derived stride length, in metres. Leave unset to derive it
+     * from `height` and `sex`.
+     */
+    strideLength?: number;
+    sex?: Sex;
+    /** Steps. Default 10000. */
+    dailyGoal?: number;
+    /** Steps. Defaults to dailyGoal * 7. */
+    weeklyGoal?: number;
+    /** Steps. Defaults to dailyGoal * 30. */
+    monthlyGoal?: number;
+    /** kcal per kg per km of walking. Default 0.57. */
+    calorieCoefficient?: number;
+    /** How many days of history to keep on device. Default 35. */
+    historyRetentionDays?: number;
+    /** Notification title. Supports {steps}, {goal}, {percent}, {distance}, {calories}. */
+    notificationTitle?: string;
+    notificationText?: string;
+    /** Drawable name in the host app, e.g. 'ic_stat_steps'. Falls back to a bundled icon. */
+    notificationIcon?: string;
+    /** Notification channel name shown in Android settings. */
+    notificationChannelName?: string;
+    /** Show Pause/Resume actions on the notification. Default true. */
+    notificationActions?: boolean;
+    /** Minimum ms between notification redraws. Default 1000. */
+    notificationThrottleMs?: number;
+    /** Minimum ms between JS `stepsChanged` events. Default 500. */
+    eventThrottleMs?: number;
+    /** Persist to SQLite after this many steps. Default 10. */
+    persistEveryNSteps?: number;
+    /** Mirror data into Health Connect when permissions are granted. Default true. */
+    healthConnectEnabled?: boolean;
+    /** Auto-write today's totals to Health Connect every N minutes. Default 30. 0 disables. */
+    healthConnectSyncIntervalMinutes?: number;
+    /** Optional HTTPS endpoint that unsynced day records get POSTed to. */
+    remoteSyncUrl?: string;
+    remoteSyncHeaders?: Record<string, string>;
+    /** Restart tracking automatically after device reboot. Default true. */
+    autoStartOnBoot?: boolean;
+}
+export interface StepSnapshot {
+    /** yyyy-MM-dd in the device timezone. */
+    date: string;
+    steps: number;
+    /** Metres. */
+    distance: number;
+    /** Kilocalories. */
+    calories: number;
+    dailyGoal: number;
+    /** 0..1, clamped. */
+    goalProgress: number;
+    goalReached: boolean;
+    state: TrackingState;
+    source: SensorSource;
+    /** Epoch ms of the last sensor sample. */
+    timestamp: number;
+}
+export interface DayRecord {
+    date: string;
+    steps: number;
+    distance: number;
+    calories: number;
+    /** Mirrored into Health Connect. */
+    synced: boolean;
+    /** Uploaded to `remoteSyncUrl`. Always false when no endpoint is configured. */
+    syncedRemote: boolean;
+}
+export interface RangeStats {
+    /** Inclusive yyyy-MM-dd. */
+    startDate: string;
+    /** Inclusive yyyy-MM-dd. */
+    endDate: string;
+    totalSteps: number;
+    totalDistance: number;
+    totalCalories: number;
+    averageSteps: number;
+    /** Days with at least one recorded step. */
+    activeDays: number;
+    bestDay: DayRecord | null;
+    /** Every day in the range, zero-filled, ascending. */
+    days: DayRecord[];
+    /** Present for weekly/monthly windows when a goal is configured. */
+    goal?: number;
+    goalProgress?: number;
+}
+export interface RangeOptions {
+    /**
+     * 'calendar' snaps to the current week (Mon–Sun), month or year.
+     * 'rolling' uses the last 7 / 30 / 365 days ending today.
+     * Default 'calendar'.
+     */
+    mode?: 'calendar' | 'rolling';
+    /** 0 = current period, 1 = previous period, and so on. Only for 'calendar'. */
+    offset?: number;
+}
+export interface PermissionStatus {
+    activityRecognition: boolean;
+    postNotifications: boolean;
+    /** True on API < 34 where the permission does not exist. */
+    foregroundServiceHealth: boolean;
+    /** All permissions required to start tracking are granted. */
+    allGranted: boolean;
+}
+export interface HealthConnectStatus {
+    /** Health Connect SDK is available on the device. */
+    available: boolean;
+    /** The user must install or update the Health Connect provider. */
+    requiresUpdate: boolean;
+    granted: boolean;
+    grantedPermissions: string[];
+}
+export interface DeviceCapabilities {
+    hasStepCounter: boolean;
+    hasStepDetector: boolean;
+    supported: boolean;
+    sdkInt: number;
+    manufacturer: string;
+    model: string;
+}
+export interface StepsChangedEvent extends StepSnapshot {
+}
+export interface GoalReachedEvent {
+    type: 'daily' | 'weekly' | 'monthly';
+    goal: number;
+    steps: number;
+    date: string;
+    timestamp: number;
+}
+export interface GoalProgressEvent {
+    type: 'daily' | 'weekly' | 'monthly';
+    goal: number;
+    steps: number;
+    progress: number;
+    date: string;
+}
+export interface TrackingStateEvent {
+    state: TrackingState;
+    source: SensorSource;
+    reason?: string;
+}
+export interface SyncEvent {
+    target: 'health_connect' | 'remote';
+    syncedRecords: number;
+    failedRecords: number;
+    success: boolean;
+    error?: string;
+}
+export interface DayChangedEvent {
+    previousDate: string;
+    currentDate: string;
+    previousDaySteps: number;
+}
+export interface StepTrackerEventMap {
+    stepsChanged: StepsChangedEvent;
+    goalReached: GoalReachedEvent;
+    goalProgressChanged: GoalProgressEvent;
+    trackingStateChanged: TrackingStateEvent;
+    dayChanged: DayChangedEvent;
+    syncCompleted: SyncEvent;
+    error: {
+        code: string;
+        message: string;
+    };
+}
+export type StepTrackerEvent = keyof StepTrackerEventMap;
+export interface EventSubscription {
+    remove(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "react-native-step-tracker-pro",
+  "version": "1.0.0",
+  "description": "Production-grade Android step tracking for React Native: hardware step counter, foreground service, Room storage, Health Connect sync, boot recovery and goals.",
+  "main": "lib/commonjs/index.js",
+  "module": "lib/module/index.js",
+  "types": "lib/typescript/index.d.ts",
+  "react-native": "src/index.ts",
+  "source": "src/index.ts",
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "!android/build",
+    "!android/.gradle",
+    "!android/gradle",
+    "!android/gradlew*",
+    "!android/local.properties",
+    "!android/settings.gradle",
+    "!android/schemas",
+    "!android/src/androidTest",
+    "!**/__tests__",
+    "docs",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "bob build",
+    "clean": "rimraf lib android/build",
+    "prepack": "bob build"
+  },
+  "keywords": [
+    "react-native",
+    "android",
+    "pedometer",
+    "step-counter",
+    "steps",
+    "fitness",
+    "health-connect",
+    "foreground-service",
+    "turbo-module"
+  ],
+  "license": "MIT",
+  "author": "Helper <sachinkumarq87@gmail.com>",
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-native": ">=0.74.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "react": "18.3.1",
+    "react-native": "0.76.5",
+    "react-native-builder-bob": "^0.30.0",
+    "typescript": "^5.4.0"
+  },
+  "codegenConfig": {
+    "name": "RNStepTrackerProSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.steptrackerpro"
+    }
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  }
+}

package/src/NativeStepTrackerPro.ts

@@ -0,0 +1,66 @@
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+import type { UnsafeObject } from 'react-native/Libraries/Types/CodegenTypes';
+
+/**
+ * Codegen spec. Everything crossing the bridge is an UnsafeObject so that a
+ * single native method can evolve without a codegen break; the strongly typed
+ * surface lives in `StepTracker.ts`, which is what consumers import.
+ */
+export interface Spec extends TurboModule {
+  // ---- lifecycle -------------------------------------------------------
+  initialize(config: UnsafeObject): Promise<UnsafeObject>;
+  updateConfig(config: UnsafeObject): Promise<UnsafeObject>;
+  getConfig(): Promise<UnsafeObject>;
+  startTracking(): Promise<UnsafeObject>;
+  pauseTracking(): Promise<UnsafeObject>;
+  resumeTracking(): Promise<UnsafeObject>;
+  stopTracking(): Promise<UnsafeObject>;
+  getTrackingState(): Promise<UnsafeObject>;
+  isTracking(): Promise<boolean>;
+
+  // ---- reads -----------------------------------------------------------
+  getTodaySteps(): Promise<UnsafeObject>;
+  getStepsForDate(date: string): Promise<UnsafeObject>;
+  getYesterdaySteps(): Promise<UnsafeObject>;
+  getStatsForRange(startDate: string, endDate: string): Promise<UnsafeObject>;
+  getWeeklyStats(options: UnsafeObject): Promise<UnsafeObject>;
+  getMonthlyStats(options: UnsafeObject): Promise<UnsafeObject>;
+  getYearlyStats(options: UnsafeObject): Promise<UnsafeObject>;
+  getHistory(startDate: string, endDate: string): Promise<UnsafeObject>;
+
+  // ---- writes ----------------------------------------------------------
+  resetToday(): Promise<boolean>;
+  clearHistory(): Promise<boolean>;
+  pruneHistory(retentionDays: number): Promise<number>;
+
+  // ---- permissions -----------------------------------------------------
+  checkPermissions(): Promise<UnsafeObject>;
+  requestPermissions(): Promise<UnsafeObject>;
+  getDeviceCapabilities(): Promise<UnsafeObject>;
+  openAppSettings(): Promise<boolean>;
+
+  // ---- battery ---------------------------------------------------------
+  isBatteryOptimizationEnabled(): Promise<boolean>;
+  requestDisableBatteryOptimization(): Promise<boolean>;
+  openBatteryOptimizationSettings(): Promise<boolean>;
+  openManufacturerAutoStartSettings(): Promise<boolean>;
+
+  // ---- health connect --------------------------------------------------
+  getHealthConnectStatus(): Promise<UnsafeObject>;
+  requestHealthConnectPermissions(): Promise<UnsafeObject>;
+  openHealthConnectSettings(): Promise<boolean>;
+  readHealthConnectSteps(startIso: string, endIso: string): Promise<UnsafeObject>;
+  writeHealthConnectSteps(date: string): Promise<boolean>;
+  syncWithHealthConnect(): Promise<UnsafeObject>;
+
+  // ---- sync ------------------------------------------------------------
+  getPendingSyncCount(): Promise<number>;
+  syncNow(): Promise<UnsafeObject>;
+
+  // ---- event emitter plumbing -----------------------------------------
+  addListener(eventName: string): void;
+  removeListeners(count: number): void;
+}
+
+export default TurboModuleRegistry.get<Spec>('StepTrackerPro');