spotny-sdk 1.0.0

package/ios/SpotnySdk.h

@@ -0,0 +1,10 @@
+#import <SpotnySdkSpec/SpotnySdkSpec.h>
+#import <React/RCTEventEmitter.h>
+
+/**
+ * SpotnySdk is both a Turbo Module (NativeSpotnySdkSpec) and an RCTEventEmitter
+ * so it can push beacon events to JavaScript via NativeEventEmitter.
+ */
+@interface SpotnySdk : RCTEventEmitter <NativeSpotnySdkSpec>
+
+@end

package/ios/SpotnySdk.mm

@@ -0,0 +1,127 @@
+#import "SpotnySdk.h"
+// CoreLocation is a system framework whose public headers use #import (not @import),
+// so importing it here is safe in an ObjC++ (.mm) context.
+// This provides CLLocationManager, CLAuthorizationStatus, CLBeacon, CLRegionState, etc.
+#import <CoreLocation/CoreLocation.h>
+// KontaktSDK headers use @import internally and cannot be included in ObjC++.
+// @class / @protocol forward declarations are enough for pointer params in the generated header.
+@class KTKBeaconManager;
+@class KTKBeaconRegion;
+@protocol KTKBeaconManagerDelegate;
+// Auto-generated Swift header (contains SpotnyBeaconScanner)
+#import "SpotnySdk-Swift.h"
+
+@implementation SpotnySdk {
+  SpotnyBeaconScanner *_scanner;
+  BOOL _hasListeners;
+}
+
+// ── Module registration ─────────────────────────────────────────────────────
+
+RCT_EXPORT_MODULE()
+
++ (BOOL)requiresMainQueueSetup {
+  return YES;
+}
+
+- (instancetype)init {
+  if (self = [super init]) {
+    __weak SpotnySdk *weakSelf = self;
+    _scanner = [[SpotnyBeaconScanner alloc] initWithEventCallback:^(NSString *name, NSDictionary *body) {
+      SpotnySdk *strongSelf = weakSelf;
+      if (strongSelf && strongSelf->_hasListeners) {
+        [strongSelf sendEventWithName:name body:body];
+      }
+    }];
+  }
+  return self;
+}
+
+// ── RCTEventEmitter ─────────────────────────────────────────────────────────
+
+- (NSArray<NSString *> *)supportedEvents {
+  return @[@"onBeaconsRanged", @"onBeaconRegionEvent"];
+}
+
+- (void)startObserving {
+  _hasListeners = YES;
+}
+
+- (void)stopObserving {
+  _hasListeners = NO;
+}
+
+// ── Turbo Module: addListener / removeListeners ─────────────────────────────
+// These are required by the codegen spec when the module emits events.
+
+- (void)addListener:(NSString *)eventName {
+  [super addListener:eventName];
+}
+
+- (void)removeListeners:(double)count {
+  [super removeListeners:count];
+}
+
+// ── Method implementations ───────────────────────────────────────────────────
+
+- (void)startScanner:(RCTPromiseResolveBlock)resolve
+              reject:(RCTPromiseRejectBlock)reject {
+  [_scanner startScannerWithResolve:resolve reject:reject];
+}
+
+- (void)stopScanner:(RCTPromiseResolveBlock)resolve
+             reject:(RCTPromiseRejectBlock)reject {
+  [_scanner stopScannerWithResolve:resolve reject:reject];
+}
+
+- (void)isScanning:(RCTPromiseResolveBlock)resolve
+            reject:(RCTPromiseRejectBlock)reject {
+  [_scanner isScanningWithResolve:resolve reject:reject];
+}
+
+- (void)initialize:(NSDictionary *)config
+           resolve:(RCTPromiseResolveBlock)resolve
+            reject:(RCTPromiseRejectBlock)reject {
+  [_scanner initializeWith:config resolve:resolve reject:reject];
+}
+
+- (void)requestNotificationPermissions:(RCTPromiseResolveBlock)resolve
+                                 reject:(RCTPromiseRejectBlock)reject {
+  [_scanner requestNotificationPermissionsWithResolve:resolve reject:reject];
+}
+
+- (void)getDebugLogs:(RCTPromiseResolveBlock)resolve
+              reject:(RCTPromiseRejectBlock)reject {
+  [_scanner getDebugLogsWithResolve:resolve reject:reject];
+}
+
+- (void)clearDebugLogs:(RCTPromiseResolveBlock)resolve
+                reject:(RCTPromiseRejectBlock)reject {
+  [_scanner clearDebugLogsWithResolve:resolve reject:reject];
+}
+
+- (void)setDebounceInterval:(double)interval
+                    resolve:(RCTPromiseResolveBlock)resolve
+                     reject:(RCTPromiseRejectBlock)reject {
+  [_scanner setDebounceInterval:interval resolve:resolve reject:reject];
+}
+
+- (void)clearDebounceCache:(RCTPromiseResolveBlock)resolve
+                    reject:(RCTPromiseRejectBlock)reject {
+  [_scanner clearDebounceCacheWithResolve:resolve reject:reject];
+}
+
+- (void)getDebounceStatus:(RCTPromiseResolveBlock)resolve
+                   reject:(RCTPromiseRejectBlock)reject {
+  [_scanner getDebounceStatusWithResolve:resolve reject:reject];
+}
+
+// ── TurboModule JSI bridge ───────────────────────────────────────────────────
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+  return std::make_shared<facebook::react::NativeSpotnySdkSpecJSI>(params);
+}
+
+@end

package/lib/module/NativeSpotnySdk.js

@@ -0,0 +1,5 @@
+"use strict";
+
+import { TurboModuleRegistry } from 'react-native';
+export default TurboModuleRegistry.getEnforcing('SpotnySdk');
+//# sourceMappingURL=NativeSpotnySdk.js.map

package/lib/module/NativeSpotnySdk.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeSpotnySdk.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;AA4BpE,eAAeA,mBAAmB,CAACC,YAAY,CAAO,WAAW,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,96 @@
+"use strict";
+
+import { NativeEventEmitter, NativeModules } from 'react-native';
+import NativeSpotnySdk from "./NativeSpotnySdk.js";
+
+// ── Event names ──────────────────────────────────────────────────────────────
+export const SpotnyEvents = {
+  ON_BEACONS_RANGED: 'onBeaconsRanged',
+  ON_BEACON_REGION_EVENT: 'onBeaconRegionEvent'
+};
+
+// ── Types ────────────────────────────────────────────────────────────────────
+
+// ── Internal event emitter ───────────────────────────────────────────────────
+const eventEmitter = new NativeEventEmitter(NativeModules.SpotnySdk);
+
+// ── Core scanning ────────────────────────────────────────────────────────────
+
+/** Start beacon scanning. */
+export function startScanner() {
+  return NativeSpotnySdk.startScanner();
+}
+
+/** Stop beacon scanning and clean up all state. */
+export function stopScanner() {
+  return NativeSpotnySdk.stopScanner();
+}
+
+/** Returns `true` if the SDK is currently scanning. */
+export function isScanning() {
+  return NativeSpotnySdk.isScanning();
+}
+
+// ── Initialization ──────────────────────────────────────────────────────────────
+
+/**
+ * Initialize the SDK. Must be called **before** any other SDK function.
+ */
+export function initialize(config) {
+  return NativeSpotnySdk.initialize(config);
+}
+
+// ── Permissions ──────────────────────────────────────────────────────────────
+
+/** (iOS) Prompt the user for local-notification permissions. */
+export function requestNotificationPermissions() {
+  return NativeSpotnySdk.requestNotificationPermissions();
+}
+
+// ── Debug helpers ─────────────────────────────────────────────────────────────
+
+/** Read the on-device debug log file. */
+export function getDebugLogs() {
+  return NativeSpotnySdk.getDebugLogs();
+}
+
+/** Delete the on-device debug log file. */
+export function clearDebugLogs() {
+  return NativeSpotnySdk.clearDebugLogs();
+}
+
+// ── Debounce helpers ──────────────────────────────────────────────────────────
+
+/** Override the proximity-event debounce interval (seconds). */
+export function setDebounceInterval(interval) {
+  return NativeSpotnySdk.setDebounceInterval(interval);
+}
+
+/** Clear the debounce / cooldown cache for all beacons. */
+export function clearDebounceCache() {
+  return NativeSpotnySdk.clearDebounceCache();
+}
+
+/** Return the current debounce status for all tracked beacons. */
+export function getDebounceStatus() {
+  return NativeSpotnySdk.getDebounceStatus();
+}
+
+// ── Event subscriptions ───────────────────────────────────────────────────────
+
+/**
+ * Subscribe to continuous ranging updates.
+ * The callback fires roughly every second while beacons are in range.
+ */
+export function addBeaconsRangedListener(callback) {
+  return eventEmitter.addListener(SpotnyEvents.ON_BEACONS_RANGED, callback);
+}
+
+/**
+ * Subscribe to region enter/exit events.
+ * These fire in all app states (foreground, background, terminated on iOS).
+ */
+export function addBeaconRegionListener(callback) {
+  return eventEmitter.addListener(SpotnyEvents.ON_BEACON_REGION_EVENT, callback);
+}
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeEventEmitter","NativeModules","NativeSpotnySdk","SpotnyEvents","ON_BEACONS_RANGED","ON_BEACON_REGION_EVENT","eventEmitter","SpotnySdk","startScanner","stopScanner","isScanning","initialize","config","requestNotificationPermissions","getDebugLogs","clearDebugLogs","setDebounceInterval","interval","clearDebounceCache","getDebounceStatus","addBeaconsRangedListener","callback","addListener","addBeaconRegionListener"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,kBAAkB,EAAEC,aAAa,QAAQ,cAAc;AAChE,OAAOC,eAAe,MAAM,sBAAmB;;AAE/C;AACA,OAAO,MAAMC,YAAY,GAAG;EAC1BC,iBAAiB,EAAE,iBAAiB;EACpCC,sBAAsB,EAAE;AAC1B,CAAU;;AAEV;;AAkDA;AACA,MAAMC,YAAY,GAAG,IAAIN,kBAAkB,CAACC,aAAa,CAACM,SAAS,CAAC;;AAEpE;;AAEA;AACA,OAAO,SAASC,YAAYA,CAAA,EAAoB;EAC9C,OAAON,eAAe,CAACM,YAAY,CAAC,CAAC;AACvC;;AAEA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAoB;EAC7C,OAAOP,eAAe,CAACO,WAAW,CAAC,CAAC;AACtC;;AAEA;AACA,OAAO,SAASC,UAAUA,CAAA,EAAqB;EAC7C,OAAOR,eAAe,CAACQ,UAAU,CAAC,CAAC;AACrC;;AAEA;;AAEA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAACC,MAAuB,EAAmB;EACnE,OAAOV,eAAe,CAACS,UAAU,CAACC,MAAgB,CAAC;AACrD;;AAEA;;AAEA;AACA,OAAO,SAASC,8BAA8BA,CAAA,EAAoB;EAChE,OAAOX,eAAe,CAACW,8BAA8B,CAAC,CAAC;AACzD;;AAEA;;AAEA;AACA,OAAO,SAASC,YAAYA,CAAA,EAAoB;EAC9C,OAAOZ,eAAe,CAACY,YAAY,CAAC,CAAC;AACvC;;AAEA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAoB;EAChD,OAAOb,eAAe,CAACa,cAAc,CAAC,CAAC;AACzC;;AAEA;;AAEA;AACA,OAAO,SAASC,mBAAmBA,CAACC,QAAgB,EAAmB;EACrE,OAAOf,eAAe,CAACc,mBAAmB,CAACC,QAAQ,CAAC;AACtD;;AAEA;AACA,OAAO,SAASC,kBAAkBA,CAAA,EAAoB;EACpD,OAAOhB,eAAe,CAACgB,kBAAkB,CAAC,CAAC;AAC7C;;AAEA;AACA,OAAO,SAASC,iBAAiBA,CAAA,EAAoB;EACnD,OAAOjB,eAAe,CAACiB,iBAAiB,CAAC,CAAC;AAC5C;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,wBAAwBA,CACtCC,QAA4C,EAC5C;EACA,OAAOf,YAAY,CAACgB,WAAW,CAC7BnB,YAAY,CAACC,iBAAiB,EAC9BiB,QACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,uBAAuBA,CACrCF,QAA4C,EAC5C;EACA,OAAOf,YAAY,CAACgB,WAAW,CAC7BnB,YAAY,CAACE,sBAAsB,EACnCgB,QACF,CAAC;AACH","ignoreList":[]}

package/lib/module/package.json

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

package/lib/typescript/package.json

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

package/lib/typescript/src/NativeSpotnySdk.d.ts

@@ -0,0 +1,18 @@
+import { type TurboModule } from 'react-native';
+export interface Spec extends TurboModule {
+    startScanner(): Promise<string>;
+    stopScanner(): Promise<string>;
+    isScanning(): Promise<boolean>;
+    initialize(config: Object): Promise<string>;
+    requestNotificationPermissions(): Promise<string>;
+    getDebugLogs(): Promise<string>;
+    clearDebugLogs(): Promise<string>;
+    setDebounceInterval(interval: number): Promise<string>;
+    clearDebounceCache(): Promise<string>;
+    getDebounceStatus(): Promise<Object>;
+    addListener(eventName: string): void;
+    removeListeners(count: number): void;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeSpotnySdk.d.ts.map

package/lib/typescript/src/NativeSpotnySdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeSpotnySdk.d.ts","sourceRoot":"","sources":["../../../src/NativeSpotnySdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,WAAW,IAAK,SAAQ,WAAW;IAEvC,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAG/B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAG5C,8BAA8B,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAGlD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAGlC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAGrC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;;AAED,wBAAmE"}

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

@@ -0,0 +1,81 @@
+export declare const SpotnyEvents: {
+    readonly ON_BEACONS_RANGED: "onBeaconsRanged";
+    readonly ON_BEACON_REGION_EVENT: "onBeaconRegionEvent";
+};
+export type BeaconData = {
+    uuid: string;
+    major: number;
+    minor: number;
+    /** Estimated distance in metres */
+    distance: number;
+    rssi: number;
+    /** 'immediate' | 'near' | 'far' | 'unknown' */
+    proximity: string;
+};
+export type BeaconRangedEvent = {
+    beacons: BeaconData[];
+    region: string;
+};
+export type BeaconRegionEvent = {
+    region: string;
+    /** 'enter' | 'exit' | 'determined' */
+    event: 'enter' | 'exit' | 'determined';
+    state?: 'inside' | 'outside' | 'unknown';
+};
+export type SpotnySdkConfig = {
+    /**
+     * SDK token issued by Spotny for your app.
+     * Sent to the backend during initialize() to obtain a session JWT. Required.
+     */
+    token: string;
+    /**
+     * API key identifying your brand or app (e.g. 'nike').
+     * Sent to the backend during initialize() alongside the token. Required.
+     */
+    apiKey: string;
+    /**
+     * ID of the authenticated user (e.g. database UUID, hashed email).
+     * Embedded in the JWT so all tracking events are tied to this user. Required.
+     */
+    userId: string;
+    /** Maximum BLE detection distance in metres (default: 8.0) */
+    maxDetectionDistance?: number;
+    /**
+     * Multiplier applied to raw RSSI-derived distance to compensate for device
+     * TX power variance (default: 0.5, tuned for Kontakt.io -12 dBm beacons).
+     */
+    distanceCorrectionFactor?: number;
+};
+/** Start beacon scanning. */
+export declare function startScanner(): Promise<string>;
+/** Stop beacon scanning and clean up all state. */
+export declare function stopScanner(): Promise<string>;
+/** Returns `true` if the SDK is currently scanning. */
+export declare function isScanning(): Promise<boolean>;
+/**
+ * Initialize the SDK. Must be called **before** any other SDK function.
+ */
+export declare function initialize(config: SpotnySdkConfig): Promise<string>;
+/** (iOS) Prompt the user for local-notification permissions. */
+export declare function requestNotificationPermissions(): Promise<string>;
+/** Read the on-device debug log file. */
+export declare function getDebugLogs(): Promise<string>;
+/** Delete the on-device debug log file. */
+export declare function clearDebugLogs(): Promise<string>;
+/** Override the proximity-event debounce interval (seconds). */
+export declare function setDebounceInterval(interval: number): Promise<string>;
+/** Clear the debounce / cooldown cache for all beacons. */
+export declare function clearDebounceCache(): Promise<string>;
+/** Return the current debounce status for all tracked beacons. */
+export declare function getDebounceStatus(): Promise<Object>;
+/**
+ * Subscribe to continuous ranging updates.
+ * The callback fires roughly every second while beacons are in range.
+ */
+export declare function addBeaconsRangedListener(callback: (event: BeaconRangedEvent) => void): import("react-native").EventSubscription;
+/**
+ * Subscribe to region enter/exit events.
+ * These fire in all app states (foreground, background, terminated on iOS).
+ */
+export declare function addBeaconRegionListener(callback: (event: BeaconRegionEvent) => void): import("react-native").EventSubscription;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY;;;CAGf,CAAC;AAIX,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,CAAC;IACvC,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC,CAAC;AAOF,6BAA6B;AAC7B,wBAAgB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAE9C;AAED,mDAAmD;AACnD,wBAAgB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAE7C;AAED,uDAAuD;AACvD,wBAAgB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAE7C;AAID;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnE;AAID,gEAAgE;AAChE,wBAAgB,8BAA8B,IAAI,OAAO,CAAC,MAAM,CAAC,CAEhE;AAID,yCAAyC;AACzC,wBAAgB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAE9C;AAED,2CAA2C;AAC3C,wBAAgB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAEhD;AAID,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAErE;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEpD;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEnD;AAID;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,4CAM7C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,4CAM7C"}

package/package.json

@@ -0,0 +1,169 @@
+{
+  "name": "spotny-sdk",
+  "version": "1.0.0",
+  "description": "Beacon Scanner",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace spotny-sdk-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "release-it --only-version"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Spotny-SA/spotny-sdk.git"
+  },
+  "author": "Ahmad Freijeh <ahmadbfreijeh@gmail.com> (https://github.com/ahmadfreijeh)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Spotny-SA/spotny-sdk/issues"
+  },
+  "homepage": "https://github.com/Spotny-SA/spotny-sdk#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native/babel-preset": "0.83.0",
+    "@react-native/eslint-config": "0.83.0",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.2.0",
+    "commitlint": "^19.8.1",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "lefthook": "^2.0.3",
+    "prettier": "^2.8.8",
+    "react": "19.2.0",
+    "react-native": "0.83.0",
+    "react-native-builder-bob": "^0.40.18",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "SpotnySdkSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.spotnysdk"
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "turbo-module",
+    "languages": "kotlin-objc",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it"
+    ],
+    "version": "0.57.2"
+  }
+}

package/src/NativeSpotnySdk.ts

@@ -0,0 +1,29 @@
+import { TurboModuleRegistry, type TurboModule } from 'react-native';
+
+export interface Spec extends TurboModule {
+  // ── Core scanning ──────────────────────────────────────────────────────────
+  startScanner(): Promise<string>;
+  stopScanner(): Promise<string>;
+  isScanning(): Promise<boolean>;
+
+  // ── Initialization ───────────────────────────────────────────────────────
+  initialize(config: Object): Promise<string>;
+
+  // ── Permissions ────────────────────────────────────────────────────────────
+  requestNotificationPermissions(): Promise<string>;
+
+  // ── Debug ──────────────────────────────────────────────────────────────────
+  getDebugLogs(): Promise<string>;
+  clearDebugLogs(): Promise<string>;
+
+  // ── Debounce helpers ───────────────────────────────────────────────────────
+  setDebounceInterval(interval: number): Promise<string>;
+  clearDebounceCache(): Promise<string>;
+  getDebounceStatus(): Promise<Object>;
+
+  // ── Required by NativeEventEmitter ────────────────────────────────────────
+  addListener(eventName: string): void;
+  removeListeners(count: number): void;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('SpotnySdk');