rn-persistent-timer 1.1.0

package/lib/typescript/NativeTimerModule.d.ts

@@ -0,0 +1,31 @@
+import { NativeEventEmitter } from 'react-native';
+export interface NativeStartOptions {
+    timerId: string;
+    mode: string;
+    duration: number;
+    elapsed: number;
+    startedAt: number;
+    showNotification: boolean;
+    notification: Record<string, unknown>;
+}
+export interface INativeTimerModule {
+    startTimer(options: NativeStartOptions): Promise<void>;
+    stopTimer(timerId: string): Promise<void>;
+    getElapsed(timerId: string): Promise<number>;
+    cancelAll(): Promise<void>;
+    getActiveTimers(): Promise<string[]>;
+    isKilledStateSupported(): Promise<boolean>;
+}
+export declare const NativeTimerModule: INativeTimerModule | null;
+export declare const NativeTimerEmitter: NativeEventEmitter | null;
+export declare const NATIVE_EVENTS: {
+    readonly TICK: "RNPersistentTimer_tick";
+    readonly COMPLETE: "RNPersistentTimer_complete";
+    readonly ERROR: "RNPersistentTimer_error";
+    readonly BACKGROUND: "RNPersistentTimer_background";
+    readonly FOREGROUND: "RNPersistentTimer_foreground";
+};
+export type NativeEventName = (typeof NATIVE_EVENTS)[keyof typeof NATIVE_EVENTS];
+export declare const isAndroid: boolean;
+export declare const isIOS: boolean;
+//# sourceMappingURL=NativeTimerModule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NativeTimerModule.d.ts","sourceRoot":"","sources":["../../src/NativeTimerModule.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,kBAAkB,EAAY,MAAM,cAAc,CAAC;AAe3E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAID,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,sBAAsB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5C;AAED,eAAO,MAAM,iBAAiB,EAAE,kBAAkB,GAAG,IAU7C,CAAC;AAIT,eAAO,MAAM,kBAAkB,EAAE,kBAAkB,GAAG,IAE9C,CAAC;AAET,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AAEX,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAIrD,eAAO,MAAM,SAAS,SAA4B,CAAC;AACnD,eAAO,MAAM,KAAK,SAAwB,CAAC"}

package/lib/typescript/PersistentTimerManager.d.ts

@@ -0,0 +1,37 @@
+import type { TimerConfig, TimerSnapshot, TimerCallbacks, RestoredTimerData } from './types';
+type EventName = keyof TimerCallbacks | 'stop' | 'error';
+export declare class PersistentTimerManager {
+    private _config;
+    private _state;
+    private _elapsed;
+    private _startedAt;
+    private _pausedAt;
+    private _tickInterval;
+    private _handlers;
+    private _appState;
+    private _appStateSubscription;
+    constructor(config: TimerConfig);
+    start(): void;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    reset(): void;
+    getSnapshot(): TimerSnapshot;
+    destroy(): void;
+    on(event: EventName, handler: Function): void;
+    off(event: EventName, handler: Function): void;
+    private _startJSTick;
+    private _stopJSTick;
+    private _onTick;
+    private _getElapsed;
+    private _listenAppState;
+    private _startNativeBackground;
+    private _stopNativeBackground;
+    private _syncFromNative;
+    private _persistState;
+    private _clearPersistedState;
+    static restore(timerId: string): Promise<RestoredTimerData | null>;
+    private _emit;
+}
+export {};
+//# sourceMappingURL=PersistentTimerManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PersistentTimerManager.d.ts","sourceRoot":"","sources":["../../src/PersistentTimerManager.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,WAAW,EAGX,aAAa,EACb,cAAc,EAEd,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAIjB,KAAK,SAAS,GAAG,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC;AAKzD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,aAAa,CAA+C;IACpE,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,qBAAqB,CAEb;gBAEJ,MAAM,EAAE,WAAW;IAiB/B,KAAK,IAAI,IAAI;IA2Bb,KAAK,IAAI,IAAI;IAiBb,MAAM,IAAI,IAAI;IAkBd,IAAI,IAAI,IAAI;IAWZ,KAAK,IAAI,IAAI;IAWb,WAAW,IAAI,aAAa;IAyB5B,OAAO,IAAI,IAAI;IASf,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI;IAO7C,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI;IAS9C,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,OAAO;IAef,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,eAAe;IA+CvB,OAAO,CAAC,sBAAsB;IAmB9B,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,eAAe;YAkBT,aAAa;YAoBb,oBAAoB;WAYrB,OAAO,CAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAwCpC,OAAO,CAAC,KAAK;CAad"}

package/lib/typescript/index.d.ts

@@ -0,0 +1,7 @@
+export { usePersistentTimer } from './usePersistentTimer';
+export { PersistentTimerManager } from './PersistentTimerManager';
+export { formatTime, parseTime, isBackgroundTimerSupported, isKilledStateTimerSupported, getActiveTimers, cancelAllTimers, } from './utils';
+export type { TimerMode, TimerState, AppState, TimerConfig, AndroidNotificationConfig, TimerSnapshot, TimerCallbacks, PersistentTimerControls, UsePersistentTimerReturn, PersistedTimerRecord, RestoredTimerData, } from './types';
+export { NativeTimerModule, NativeTimerEmitter, NATIVE_EVENTS, } from './NativeTimerModule';
+export type { INativeTimerModule, NativeStartOptions, NativeEventName } from './NativeTimerModule';
+//# 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":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EACL,UAAU,EACV,SAAS,EACT,0BAA0B,EAC1B,2BAA2B,EAC3B,eAAe,EACf,eAAe,GAChB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,SAAS,EACT,UAAU,EACV,QAAQ,EACR,WAAW,EACX,yBAAyB,EACzB,aAAa,EACb,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/lib/typescript/types.d.ts

@@ -0,0 +1,167 @@
+export type TimerMode = 'countdown' | 'stopwatch';
+export type TimerState = 'idle' | 'running' | 'paused' | 'completed';
+export type AppState = 'foreground' | 'background' | 'killed';
+export interface AndroidNotificationConfig {
+    /** Notification title shown in status bar */
+    title?: string;
+    /** Notification body. Use {time} as a placeholder for the current timer value */
+    body?: string;
+    /** Android notification channel ID */
+    channelId?: string;
+    /** Android notification channel name */
+    channelName?: string;
+    /** Drawable resource name for the notification icon */
+    icon?: string;
+    /** Accent color (hex, e.g. '#FF5733') */
+    color?: string;
+    /** Show elapsed / remaining time in the notification */
+    showTime?: boolean;
+    /** Add pause / resume action buttons to the notification */
+    showActions?: boolean;
+}
+export interface TimerConfig {
+    /**
+     * Unique ID for this timer instance. Required.
+     * Used as the key for persistence and native interop.
+     */
+    timerId: string;
+    /**
+     * Timer mode.
+     * - `'countdown'` — counts down from `duration` to 0.
+     * - `'stopwatch'` — counts up from 0.
+     * @default 'stopwatch'
+     */
+    mode?: TimerMode;
+    /**
+     * Duration in seconds. Required when `mode === 'countdown'`.
+     */
+    duration?: number;
+    /**
+     * Keep the timer running when the app goes to the **background**.
+     * On Android this starts a Foreground Service; on iOS it uses
+     * `UIBackgroundTaskIdentifier` + `BGTaskScheduler`.
+     * @default true
+     */
+    runInBackground?: boolean;
+    /**
+     * Keep the timer alive even after the app is **killed** from the
+     * task manager. State is persisted via AsyncStorage and restored
+     * when the app is re-opened.
+     * Requires additional native setup — see README.
+     * @default false
+     */
+    runInKilledState?: boolean;
+    /**
+     * Tick interval in milliseconds.
+     * @default 1000
+     */
+    interval?: number;
+    /**
+     * Show a persistent notification while the timer is active (Android).
+     * Required for reliable background execution on Android 8+.
+     * @default true  (when runInBackground is true)
+     */
+    showNotification?: boolean;
+    /** Android notification customisation. */
+    notification?: AndroidNotificationConfig;
+    /**
+     * Automatically pause when the app moves to the background.
+     * Overrides `runInBackground` when `true`.
+     * @default false
+     */
+    pauseOnBackground?: boolean;
+    /**
+     * Automatically reset when the app returns to the foreground from a
+     * killed state.
+     * @default false
+     */
+    resetOnForeground?: boolean;
+}
+export interface TimerSnapshot {
+    /** Timer ID */
+    timerId: string;
+    /** Elapsed seconds since the timer last started */
+    elapsed: number;
+    /** Remaining seconds — countdown mode only, otherwise `null` */
+    remaining: number | null;
+    /** Current timer state */
+    state: TimerState;
+    /** Current app state at the time the snapshot was taken */
+    appState: AppState;
+    /** Unix-ms timestamp when the timer was (last) started */
+    startedAt: number | null;
+    /** Unix-ms timestamp when the timer was paused */
+    pausedAt: number | null;
+    /** Elapsed time formatted as `HH:MM:SS` */
+    formattedElapsed: string;
+    /** Remaining time formatted as `HH:MM:SS` — countdown only, otherwise `null` */
+    formattedRemaining: string | null;
+    /** Progress from 0 to 1 — countdown only, otherwise `null` */
+    progress: number | null;
+}
+export interface TimerCallbacks {
+    /** Fires every tick (based on `interval`). */
+    onTick?: (snapshot: TimerSnapshot) => void;
+    /** Fires when the timer starts. */
+    onStart?: (snapshot: TimerSnapshot) => void;
+    /** Fires when the timer is paused. */
+    onPause?: (snapshot: TimerSnapshot) => void;
+    /** Fires when the timer is resumed. */
+    onResume?: (snapshot: TimerSnapshot) => void;
+    /** Fires when the timer is reset. */
+    onReset?: (snapshot: TimerSnapshot) => void;
+    /** Fires when a countdown timer reaches zero. */
+    onComplete?: (snapshot: TimerSnapshot) => void;
+    /** Fires when the app moves to the background. */
+    onBackground?: (snapshot: TimerSnapshot) => void;
+    /** Fires when the app returns to the foreground. */
+    onForeground?: (snapshot: TimerSnapshot) => void;
+    /** Fires when timer state is restored after an app kill. */
+    onRestore?: (snapshot: TimerSnapshot) => void;
+    /** Fires on any internal error. */
+    onError?: (error: Error) => void;
+}
+export interface PersistentTimerControls {
+    /** Start (or restart from 0) the timer. */
+    start: () => void;
+    /** Pause the timer. */
+    pause: () => void;
+    /** Resume from a paused state. */
+    resume: () => void;
+    /** Stop the timer and reset elapsed to 0. */
+    reset: () => void;
+    /** Stop the timer without resetting elapsed time. */
+    stop: () => void;
+    /** Get the current snapshot synchronously. */
+    getSnapshot: () => TimerSnapshot;
+    /** Destroy the timer and remove all listeners. */
+    destroy: () => void;
+}
+export interface UsePersistentTimerReturn extends PersistentTimerControls {
+    /** Latest reactive timer snapshot. */
+    snapshot: TimerSnapshot;
+    /** `true` when `state === 'running'`. */
+    isRunning: boolean;
+    /** `true` when `state === 'paused'`. */
+    isPaused: boolean;
+    /** `true` when `state === 'completed'` (countdown). */
+    isCompleted: boolean;
+    /** Current app state. */
+    appState: AppState;
+}
+export interface PersistedTimerRecord {
+    timerId: string;
+    config: Required<TimerConfig>;
+    state: TimerState;
+    elapsed: number;
+    startedAt: number | null;
+    pausedAt: number | null;
+    savedAt: number;
+}
+export interface RestoredTimerData {
+    config: Required<TimerConfig>;
+    state: TimerState;
+    elapsed: number;
+    secondsLost: number;
+}
+//# 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/lib/typescript/usePersistentTimer.d.ts

@@ -0,0 +1,16 @@
+import type { TimerConfig, TimerCallbacks, UsePersistentTimerReturn } from './types';
+/**
+ * React hook for persistent timers.
+ *
+ * @example
+ * ```tsx
+ * const { snapshot, start, pause, reset, isRunning } = usePersistentTimer({
+ *   timerId: 'workout-timer',
+ *   mode: 'stopwatch',
+ *   runInBackground: true,
+ *   onTick: (snap) => console.log(snap.formattedElapsed),
+ * });
+ * ```
+ */
+export declare function usePersistentTimer(config: TimerConfig & TimerCallbacks): UsePersistentTimerReturn;
+//# sourceMappingURL=usePersistentTimer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePersistentTimer.d.ts","sourceRoot":"","sources":["../../src/usePersistentTimer.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EAGd,wBAAwB,EACzB,MAAM,SAAS,CAAC;AAuBjB;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,GAAG,cAAc,GACnC,wBAAwB,CA0H1B"}

package/lib/typescript/utils.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Format a number of seconds into an `HH:MM:SS` string.
+ *
+ * @example
+ * formatTime(3661); // '01:01:01'
+ * formatTime(59);   // '00:00:59'
+ */
+export declare function formatTime(seconds: number): string;
+/**
+ * Parse an `HH:MM:SS` or `MM:SS` string into total seconds.
+ *
+ * @example
+ * parseTime('01:30:00'); // 5400
+ * parseTime('05:30');    // 330
+ */
+export declare function parseTime(formatted: string): number;
+/**
+ * Returns `true` if the native background-timer module is available on this
+ * device / build. Always returns `false` in Expo Go.
+ */
+export declare function isBackgroundTimerSupported(): Promise<boolean>;
+/**
+ * Returns `true` if the killed-state persistence feature is supported.
+ * Requires the native module **and** platform capabilities
+ * (WorkManager on Android, BGTaskScheduler on iOS 13+).
+ */
+export declare function isKilledStateTimerSupported(): Promise<boolean>;
+/**
+ * Return the IDs of all timers currently active in the native layer.
+ */
+export declare function getActiveTimers(): Promise<string[]>;
+/**
+ * Cancel every active timer in both the native layer and JS.
+ */
+export declare function cancelAllTimers(): Promise<void>;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CASnD;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,OAAO,CAAC,CAGnE;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,OAAO,CAAC,CAUpE;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAUzD;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAUrD"}

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "rn-persistent-timer",
+  "version": "1.1.0",
+  "description": "React Native timers that keep running in the foreground, background, and even after the app is killed — with TypeScript support.",
+  "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",
+  "exports": {
+    ".": {
+      "import": "./lib/module/index.js",
+      "require": "./lib/commonjs/index.js",
+      "types": "./lib/typescript/index.d.ts"
+    }
+  },
+  "files": [
+    "src/",
+    "lib/",
+    "android/",
+    "ios/",
+    "*.podspec",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "test": "jest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint \"src/**/*.{ts,tsx}\" \"example/**/*.{ts,tsx}\"",
+    "build": "bob build",
+    "prepare": "bob build"
+  },
+  "keywords": [
+    "react-native",
+    "timer",
+    "background-timer",
+    "persistent-timer",
+    "foreground-service",
+    "background-task",
+    "countdown",
+    "stopwatch",
+    "headless-js",
+    "ios-background",
+    "android-foreground-service",
+    "typescript",
+    "react-native-timer",
+    "killed-state",
+    "bg-timer"
+  ],
+  "author": "Vipin Jaiswal",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vipin208/rn-persistent-timer"
+  },
+  "bugs": {
+    "url": "https://github.com/vipin208/rn-persistent-timer/issues"
+  },
+  "homepage": "https://github.com/vipin208/rn-persistent-timer#readme",
+  "peerDependencies": {
+    "@react-native-async-storage/async-storage": ">=1.18.0",
+    "react": ">=18.0.0",
+    "react-native": ">=0.71.0"
+  },
+  "devDependencies": {
+    "@react-native-async-storage/async-storage": "^1.23.1",
+    "@react-native-community/eslint-config": "^3.2.0",
+    "@tsconfig/react-native": "^3.0.0",
+    "@types/react": "^18.2.0",
+    "@types/react-native": "^0.73.0",
+    "eslint": "^8.57.0",
+    "jest": "^29.7.0",
+    "react": "18.3.1",
+    "react-native": "0.75.4",
+    "react-native-builder-bob": "^0.23.2",
+    "typescript": "^5.4.0"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/lib/"
+    ]
+  }
+}

package/src/NativeTimerModule.ts

@@ -0,0 +1,73 @@
+// rn-persistent-timer — Native Bridge
+// Bridges TypeScript ↔ Android (ForegroundService) & iOS (BGTaskScheduler)
+// ─────────────────────────────────────────────────────────────────────────────
+
+import { NativeModules, NativeEventEmitter, Platform } from 'react-native';
+
+const { RNPersistentTimer } = NativeModules;
+
+if (__DEV__ && !RNPersistentTimer) {
+  console.warn(
+    '[rn-persistent-timer] Native module not found.\n' +
+      'iOS  → run `npx pod-install` then rebuild.\n' +
+      'Android → rebuild the Android project.\n' +
+      'Foreground (JS-only) timers still work; background/kill-state features are disabled.',
+  );
+}
+
+// ─── Start options passed to the native layer ────────────────────────────────
+
+export interface NativeStartOptions {
+  timerId: string;
+  mode: string;
+  duration: number;
+  elapsed: number;
+  startedAt: number;
+  showNotification: boolean;
+  notification: Record<string, unknown>;
+}
+
+// ─── Module interface ─────────────────────────────────────────────────────────
+
+export interface INativeTimerModule {
+  startTimer(options: NativeStartOptions): Promise<void>;
+  stopTimer(timerId: string): Promise<void>;
+  getElapsed(timerId: string): Promise<number>;
+  cancelAll(): Promise<void>;
+  getActiveTimers(): Promise<string[]>;
+  isKilledStateSupported(): Promise<boolean>;
+}
+
+export const NativeTimerModule: INativeTimerModule | null = RNPersistentTimer
+  ? {
+      startTimer: (options: NativeStartOptions) =>
+        RNPersistentTimer.startTimer(options),
+      stopTimer: (timerId: string) => RNPersistentTimer.stopTimer(timerId),
+      getElapsed: (timerId: string) => RNPersistentTimer.getElapsed(timerId),
+      cancelAll: () => RNPersistentTimer.cancelAll(),
+      getActiveTimers: () => RNPersistentTimer.getActiveTimers(),
+      isKilledStateSupported: () => RNPersistentTimer.isKilledStateSupported(),
+    }
+  : null;
+
+// ─── Native event emitter (optional background tick push) ────────────────────
+
+export const NativeTimerEmitter: NativeEventEmitter | null = RNPersistentTimer
+  ? new NativeEventEmitter(RNPersistentTimer)
+  : null;
+
+export const NATIVE_EVENTS = {
+  TICK: 'RNPersistentTimer_tick',
+  COMPLETE: 'RNPersistentTimer_complete',
+  ERROR: 'RNPersistentTimer_error',
+  BACKGROUND: 'RNPersistentTimer_background',
+  FOREGROUND: 'RNPersistentTimer_foreground',
+} as const;
+
+export type NativeEventName =
+  (typeof NATIVE_EVENTS)[keyof typeof NATIVE_EVENTS];
+
+// ─── Platform helpers ─────────────────────────────────────────────────────────
+
+export const isAndroid = Platform.OS === 'android';
+export const isIOS = Platform.OS === 'ios';