react-native-spike-sdk 4.4.13 → 4.5.23-beta.1

package/lib/typescript/v3/SpikeRNConnectionAPIv3.d.ts

@@ -7,6 +7,7 @@ import type { SpikeRecord } from "./DataModels/SpikeRecord";
 import { HealthConnectAvailabilityStatus } from "./DataModels/HealthConnectAvailabilityStatus";
 import type { ActivityConfig } from "./DataModels/ActivityConfig";
 import type { SleepConfig } from "./DataModels/SleepConfig";
+import type { RecordConfig } from "./RecordConfig";
 import type { UserInfoResponse } from "./DataModels/UserInfoResponse";
 import type { Provider } from "./DataModels/Provider";
 import type { UserProperties } from "./DataModels/UserProperties";
@@ -92,7 +93,7 @@ export declare class SpikeRNConnectionAPIv3 {
      *
      * @category Data reading
      */
-    getRecords({ ofTypes, from, to, filter }: {
+    getRecords({ ofTypes, from, to, filter, config }: {
         /** Array of metric types to retrieve (e.g., heart rate, steps, sleep) */
         ofTypes: MetricType[];
         /** Start datetime for the data range (inclusive) */
@@ -101,6 +102,8 @@ export declare class SpikeRNConnectionAPIv3 {
         to: Date;
         /** Optional filter to apply to the results (can filter by provider, etc.) */
         filter?: StatisticsFilter | null;
+        /** Optional configuration for records queries (e.g., include samples) */
+        config?: RecordConfig | null;
     }): Promise<SpikeRecord[]>;
     /**
      * Retrieves all activities based on the specified configuration.
@@ -235,6 +238,30 @@ export declare class SpikeRNConnectionAPIv3 {
          */
         sleepConfigs?: SleepConfig[];
     }): Promise<void>;
+    /**
+     * Triggers a backfill of health data for the specified number of days.
+     *
+     * This method pushes historical health data to the Spike backend. It requires that
+     * health permissions have already been granted (via `requestHealthPermissions` on iOS
+     * or Health Connect / Samsung Health Data integration on Android).
+     *
+     * The number of days to backfill configured in the Spike dashboard will be used if
+     * `days` is not provided.
+     *
+     * @category Backfill
+     */
+    backfill({ days, statisticTypes, metricTypes, activityConfigs, sleepConfigs }: {
+        /** Number of days to backfill. If not provided, uses the value from Spike dashboard config. */
+        days?: number;
+        /** Array of statistic types to backfill. */
+        statisticTypes?: StatisticsType[];
+        /** Array of metric types to backfill. */
+        metricTypes?: MetricType[];
+        /** Array of activity configuration objects to backfill. */
+        activityConfigs?: ActivityConfig[];
+        /** Array of sleep configuration objects to backfill. */
+        sleepConfigs?: SleepConfig[];
+    }): Promise<void>;
     /**
      * Disables background checks for new data.
      *
@@ -263,6 +290,27 @@ export declare class SpikeRNConnectionAPIv3 {
      * @category iOS HealthKit
      */
     isHealthKitIntegrationEnabled(): Promise<boolean>;
+    /**
+     * Requests HealthKit read permissions for the given categories, then starts a backfill.
+     * Data for today and yesterday is pushed before this method resolves; older days continue in the background.
+     *
+     * For manual control over backfill, use {@link requestHealthPermissions} and {@link backfill} instead.
+     *
+     * @category iOS HealthKit
+     * @category Backfill
+     */
+    requestPermissionsFromHealthKitAndBackfill({ days, statisticTypes, metricTypes, activityConfigs, sleepConfigs }: {
+        /** Number of days to backfill. If not provided, uses the value from Spike dashboard config. */
+        days?: number;
+        /** Array of statistic types. */
+        statisticTypes?: StatisticsType[];
+        /** Array of metric types. */
+        metricTypes?: MetricType[];
+        /** Array of activity configuration objects. */
+        activityConfigs?: ActivityConfig[];
+        /** Array of sleep configuration objects. */
+        sleepConfigs?: SleepConfig[];
+    }): Promise<void>;
     /**
      * Check if Health Connect is installed or should be updated.
      *
@@ -349,6 +397,35 @@ export declare class SpikeRNConnectionAPIv3 {
      * @returns true if the feature is available, false otherwise
      */
     isHealthConnectFeatureAvailable(feature: HealthConnectFeature): Promise<boolean>;
+    /**
+     * Enables Health Connect integration, requests permissions for the given categories, then starts a backfill.
+     * Data for today and yesterday is pushed before this method resolves; older days continue in the background.
+     *
+     * This mirrors the native {@link requestSamsungPermissionsAndBackfill} flow: enable integration,
+     * request permissions, then run backfill (implemented by composing existing Health Connect APIs).
+     *
+     * For manual control, use {@link enableHealthConnectIntegration}, {@link getHealthConnectPermissions},
+     * {@link requestPermissionsFromHealthConnect}, and {@link backfill} instead.
+     *
+     * @category Android Health Connect
+     * @category Backfill
+     */
+    requestHealthConnectPermissionsAndBackfill({ days, statisticTypes, metricTypes, activityConfigs, sleepConfigs, includeEnhancedPermissions, includeBackgroundDelivery, }: {
+        /** Number of days to backfill. If not provided, uses the value from Spike dashboard config. */
+        days?: number;
+        /** Array of statistic types. */
+        statisticTypes?: StatisticsType[];
+        /** Array of metric types. */
+        metricTypes?: MetricType[];
+        /** Array of activity configuration objects. */
+        activityConfigs?: ActivityConfig[];
+        /** Array of sleep configuration objects. */
+        sleepConfigs?: SleepConfig[];
+        /** Whether to include enhanced permissions (e.g. background read). Defaults to false. */
+        includeEnhancedPermissions?: boolean;
+        /** Whether to include background delivery permissions. Defaults to false. */
+        includeBackgroundDelivery?: boolean;
+    }): Promise<void>;
     /**
      * Check if Samsung Health Data is available on the device.
      *
@@ -408,6 +485,27 @@ export declare class SpikeRNConnectionAPIv3 {
      * @category Permissions
      */
     requestPermissionsFromSamsungHealthData({ statisticTypes, metricTypes, activityConfigs, sleepConfigs }: GetHealthConnectPermissionsParameters): Promise<string[]>;
+    /**
+     * Enables Samsung Health Data integration, requests permissions for the given categories, then starts a backfill.
+     * Data for today and yesterday is pushed before this method resolves; older days continue in the background.
+     *
+     * For manual control, use {@link enableSamsungHealthDataIntegration}, {@link requestPermissionsFromSamsungHealthData}, and {@link backfill} instead.
+     *
+     * @category Samsung Health Data
+     * @category Backfill
+     */
+    requestSamsungPermissionsAndBackfill({ days, statisticTypes, metricTypes, activityConfigs, sleepConfigs }: {
+        /** Number of days to backfill. If not provided, uses the value from Spike dashboard config. */
+        days?: number;
+        /** Array of statistic types. */
+        statisticTypes?: StatisticsType[];
+        /** Array of metric types. */
+        metricTypes?: MetricType[];
+        /** Array of activity configuration objects. */
+        activityConfigs?: ActivityConfig[];
+        /** Array of sleep configuration objects. */
+        sleepConfigs?: SleepConfig[];
+    }): Promise<void>;
     /**
      * Analyze the nutritional content of food on a given image.
      *

package/lib/typescript/v3/SpikeRNConnectionAPIv3.d.ts.map

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

package/lib/typescript/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SPIKE_SDK_VERSION = "4.4.13";
+export declare const SPIKE_SDK_VERSION = "4.5.23-beta.1";
 //# sourceMappingURL=version.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,iBAAiB,WAAW,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,iBAAiB,kBAAkB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-spike-sdk",
-  "version": "4.4.13",
-  "iosVersion": "4.4.11",
+  "version": "4.5.23-beta.1",
+  "iosVersion": "4.5.21-beta.1",
   "description": "Spike API for health and productivity data from wearables and IoT devices",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",

package/src/index.ts

@@ -108,6 +108,7 @@ import type { ActivityEntry } from './v3/DataModels/ActivityEntry';
 import type { ActivitySamples } from './v3/DataModels/ActivitySamples';
 import type { RecordSource } from './v3/DataModels/RecordSource';
 import { SleepConfig, SleepConfigConstructorInterface } from './v3/DataModels/SleepConfig';
+import { RecordConfig, RecordConfigConstructorParameters } from './v3/RecordConfig';
 import type { SpikeRecord } from './v3/DataModels/SpikeRecord';
 import type { Statistic } from './v3/DataModels/Statistic';
 import type { UUID } from './v3/DataModels/UUID';
@@ -153,6 +154,7 @@ export {
   MetricType,
   Provider,
   ProviderSource,
+  RecordConfig,
   RecordSource,
   SleepConfig,
   SpikeRecord,
@@ -178,6 +180,7 @@ export type {
   StatisticsFilterConstructorParameters,
   ActivityConfigConstructorInterface,
   SleepConfigConstructorInterface,
+  RecordConfigConstructorParameters,
   BackgroundDeliveryConfig,
   SamsungHealthDataAvailability,
   IntegrationInitConfig,

package/src/v3/RecordConfig.ts

@@ -0,0 +1,13 @@
+export interface RecordConfigConstructorParameters {
+    includeSamples?: boolean,
+}
+
+export class RecordConfig {
+    includeSamples: boolean = false
+
+    constructor({
+        includeSamples = false,
+    }: RecordConfigConstructorParameters) {
+        this.includeSamples = includeSamples;
+    }
+}

package/src/v3/SpikeRNConnectionAPIv3.ts

@@ -11,6 +11,7 @@ import type { SpikeRecord } from "./DataModels/SpikeRecord";
 import { HealthConnectAvailabilityStatus } from "./DataModels/HealthConnectAvailabilityStatus";
 import type { ActivityConfig } from "./DataModels/ActivityConfig";
 import type { SleepConfig } from "./DataModels/SleepConfig";
+import type { RecordConfig } from "./RecordConfig";
 import type { UserInfoResponse } from "./DataModels/UserInfoResponse";
 import type { Provider } from "./DataModels/Provider";
 import type { UserProperties } from "./DataModels/UserProperties";
@@ -165,7 +166,8 @@ export class SpikeRNConnectionAPIv3 {
         ofTypes,
         from,
         to,
-        filter = null
+        filter = null,
+        config = null
     } : {
         /** Array of metric types to retrieve (e.g., heart rate, steps, sleep) */
         ofTypes: MetricType[],
@@ -178,17 +180,20 @@ export class SpikeRNConnectionAPIv3 {
 
         /** Optional filter to apply to the results (can filter by provider, etc.) */
         filter?: StatisticsFilter | null,
+
+        /** Optional configuration for records queries (e.g., include samples) */
+        config?: RecordConfig | null,
     }): Promise<SpikeRecord[]> {
         if (!SpikeSdk) throw new SpikeException();
     
         const stringTypes = ofTypes.map ( (item: MetricType) => item )
-        // console.log("Record types requested",  stringTypes)
         const result = await SpikeSdk.getRecords(
             this.connectionUUID,
             stringTypes,
             from.toISOString(),
             to.toISOString(),
-            !!filter ? JSON.stringify(filter) : null
+            !!filter ? JSON.stringify(filter) : null,
+            config ? JSON.stringify(camelToSnake(config)) : null
         )
         const jsonResult = JSON.parse(result)
         const finalResult = snakeToCamel(jsonResult) as [SpikeRecord]
@@ -445,6 +450,48 @@ export class SpikeRNConnectionAPIv3 {
         }
     }
 
+    /**
+     * Triggers a backfill of health data for the specified number of days.
+     *
+     * This method pushes historical health data to the Spike backend. It requires that
+     * health permissions have already been granted (via `requestHealthPermissions` on iOS
+     * or Health Connect / Samsung Health Data integration on Android).
+     *
+     * The number of days to backfill configured in the Spike dashboard will be used if
+     * `days` is not provided.
+     *
+     * @category Backfill
+     */
+    async backfill({
+        days = undefined,
+        statisticTypes = [],
+        metricTypes = [],
+        activityConfigs = [],
+        sleepConfigs = []
+    }: {
+        /** Number of days to backfill. If not provided, uses the value from Spike dashboard config. */
+        days?: number,
+        /** Array of statistic types to backfill. */
+        statisticTypes?: StatisticsType[],
+        /** Array of metric types to backfill. */
+        metricTypes?: MetricType[],
+        /** Array of activity configuration objects to backfill. */
+        activityConfigs?: ActivityConfig[],
+        /** Array of sleep configuration objects to backfill. */
+        sleepConfigs?: SleepConfig[],
+    }): Promise<void> {
+        if (!SpikeSdk) throw new SpikeException();
+
+        await SpikeSdk.backfill(
+            this.connectionUUID,
+            days !== undefined ? String(days) : null,
+            statisticTypes,
+            metricTypes,
+            activityConfigs.map((object) => JSON.stringify(object)),
+            sleepConfigs.map((object) => JSON.stringify(object))
+        )
+    }
+
     /**
      * Disables background checks for new data.
      * 
@@ -510,6 +557,46 @@ export class SpikeRNConnectionAPIv3 {
         return await SpikeSdk.isHealthKitIntegrationEnabled(this.connectionUUID)
     }
 
+    /**
+     * Requests HealthKit read permissions for the given categories, then starts a backfill.
+     * Data for today and yesterday is pushed before this method resolves; older days continue in the background.
+     *
+     * For manual control over backfill, use {@link requestHealthPermissions} and {@link backfill} instead.
+     *
+     * @category iOS HealthKit
+     * @category Backfill
+     */
+    async requestPermissionsFromHealthKitAndBackfill({
+        days = undefined,
+        statisticTypes = [],
+        metricTypes = [],
+        activityConfigs = [],
+        sleepConfigs = []
+    }: {
+        /** Number of days to backfill. If not provided, uses the value from Spike dashboard config. */
+        days?: number,
+        /** Array of statistic types. */
+        statisticTypes?: StatisticsType[],
+        /** Array of metric types. */
+        metricTypes?: MetricType[],
+        /** Array of activity configuration objects. */
+        activityConfigs?: ActivityConfig[],
+        /** Array of sleep configuration objects. */
+        sleepConfigs?: SleepConfig[],
+    }): Promise<void> {
+        if (Platform.OS !== 'ios') return;
+        if (!SpikeSdk) throw new SpikeException();
+
+        await SpikeSdk.requestPermissionsFromHealthKitAndBackfill(
+            this.connectionUUID,
+            statisticTypes,
+            metricTypes,
+            activityConfigs.map((object) => JSON.stringify(object)),
+            sleepConfigs.map((object) => JSON.stringify(object)),
+            days !== undefined ? String(days) : null
+        );
+    }
+
     // ------------------------- Android specific Health Connect permissions -------------------------
     
     /**
@@ -678,6 +765,65 @@ export class SpikeRNConnectionAPIv3 {
         return await SpikeSdk.isHealthConnectFeatureAvailable(this.connectionUUID, feature)
     }
 
+    /**
+     * Enables Health Connect integration, requests permissions for the given categories, then starts a backfill.
+     * Data for today and yesterday is pushed before this method resolves; older days continue in the background.
+     *
+     * This mirrors the native {@link requestSamsungPermissionsAndBackfill} flow: enable integration,
+     * request permissions, then run backfill (implemented by composing existing Health Connect APIs).
+     *
+     * For manual control, use {@link enableHealthConnectIntegration}, {@link getHealthConnectPermissions},
+     * {@link requestPermissionsFromHealthConnect}, and {@link backfill} instead.
+     *
+     * @category Android Health Connect
+     * @category Backfill
+     */
+    async requestHealthConnectPermissionsAndBackfill({
+        days = undefined,
+        statisticTypes = [],
+        metricTypes = [],
+        activityConfigs = [],
+        sleepConfigs = [],
+        includeEnhancedPermissions = false,
+        includeBackgroundDelivery = false,
+    }: {
+        /** Number of days to backfill. If not provided, uses the value from Spike dashboard config. */
+        days?: number,
+        /** Array of statistic types. */
+        statisticTypes?: StatisticsType[],
+        /** Array of metric types. */
+        metricTypes?: MetricType[],
+        /** Array of activity configuration objects. */
+        activityConfigs?: ActivityConfig[],
+        /** Array of sleep configuration objects. */
+        sleepConfigs?: SleepConfig[],
+        /** Whether to include enhanced permissions (e.g. background read). Defaults to false. */
+        includeEnhancedPermissions?: boolean,
+        /** Whether to include background delivery permissions. Defaults to false. */
+        includeBackgroundDelivery?: boolean,
+    }): Promise<void> {
+        if (Platform.OS !== 'android') return;
+        if (!SpikeSdk) throw new SpikeException();
+
+        await this.enableHealthConnectIntegration();
+        const permissions = await this.getHealthConnectPermissions({
+            statisticTypes,
+            metricTypes,
+            activityConfigs,
+            sleepConfigs,
+            includeEnhancedPermissions,
+            includeBackgroundDelivery,
+        });
+        await this.requestPermissionsFromHealthConnect({ permissions });
+        await this.backfill({
+            days,
+            statisticTypes,
+            metricTypes,
+            activityConfigs,
+            sleepConfigs,
+        });
+    }
+
     // ------------------------- Samsung Health Data permissions -------------------------
     
     /**
@@ -806,6 +952,46 @@ export class SpikeRNConnectionAPIv3 {
         )
     }
 
+    /**
+     * Enables Samsung Health Data integration, requests permissions for the given categories, then starts a backfill.
+     * Data for today and yesterday is pushed before this method resolves; older days continue in the background.
+     *
+     * For manual control, use {@link enableSamsungHealthDataIntegration}, {@link requestPermissionsFromSamsungHealthData}, and {@link backfill} instead.
+     *
+     * @category Samsung Health Data
+     * @category Backfill
+     */
+    async requestSamsungPermissionsAndBackfill({
+        days = undefined,
+        statisticTypes = [],
+        metricTypes = [],
+        activityConfigs = [],
+        sleepConfigs = []
+    }: {
+        /** Number of days to backfill. If not provided, uses the value from Spike dashboard config. */
+        days?: number,
+        /** Array of statistic types. */
+        statisticTypes?: StatisticsType[],
+        /** Array of metric types. */
+        metricTypes?: MetricType[],
+        /** Array of activity configuration objects. */
+        activityConfigs?: ActivityConfig[],
+        /** Array of sleep configuration objects. */
+        sleepConfigs?: SleepConfig[],
+    }): Promise<void> {
+        if (Platform.OS !== 'android') return;
+        if (!SpikeSdk) throw new SpikeException();
+
+        await SpikeSdk.requestSamsungPermissionsAndBackfill(
+            this.connectionUUID,
+            statisticTypes,
+            metricTypes,
+            activityConfigs.map((object) => JSON.stringify(object)),
+            sleepConfigs.map((object) => JSON.stringify(object)),
+            days !== undefined ? String(days) : null
+        );
+    }
+
     // ------------------------- Nutrition AI -------------------------
 
     /**

package/src/version.ts

@@ -1,3 +1,3 @@
 // This file is auto-generated. Do not edit manually.
-export const SPIKE_SDK_VERSION = "4.4.13";
+export const SPIKE_SDK_VERSION = "4.5.23-beta.1";