SDK Quickstart

dependencies: [
    .package(url: "https://github.com/onecheck-inc/OneS1ght-iOS-SDK", from: "0.1.0"),
],
targets: [
    .target(name: "YourApp", dependencies: [
        .product(name: "OneS1ght", package: "OneS1ght-iOS-SDK"),
    ])
]

<key>NSLocationWhenInUseUsageDescription</key>
<string>Used to determine your location inside the store.</string>
<key>NSNearbyInteractionUsageDescription</key>
<string>Used for precise UWB positioning.</string>

import CoreLocation

let locationManager = CLLocationManager()
locationManager.requestWhenInUseAuthorization()

switch await OneS1ght.permissions() {
case .authorized:  break
case .denied:      showSettingsGuide()      // Cannot be requested again — send the user to Settings
case .unsupported: showUnsupportedNotice()
}

import SwiftUI
import OneS1ght

@main
struct MyApp: App {
    init() {
        Task { @MainActor in
            do {
                try await OneS1ght.initialize(sdkKey: "YOUR_SDK_API_KEY",
                                              geoSdkKey: "YOUR_GEOSPACE_SDK_KEY")
            } catch {
                print("OneS1ght initialization failed: \(error)")   // Does not block the app from running
            }
        }
    }
    var body: some Scene { WindowGroup { ContentView() } }
}

 let profileId: String

 if let saved = savedProfileId {
     profileId = saved                       // Reuse the stored value on every launch.
 } else {
     profileId = try await OneS1ght.createProfile([   // Run this when there is no profile yet.
         "gender":   "F",
         "ageBand":  "20s",        // Put in whatever you want to segment by.
         "interest": "cosmetics",
     ])
     save(profileId)                         // Creating a profile issues a unique ID — you need it on the next visit.
 }

 OneS1ght.identify(profileId: profileId)    // Authenticate with the issued profile ID.

 let buildings = try await OneS1ght.buildings()      // Look up the buildings of the tenant (organization).
 let floors    = try await OneS1ght.floors(buildings[0].id) // Look up the floors of a building.

 try await OneS1ght.setFloorMap(floors[0], buildingID: buildings[0].id) // Fetch the target map by building ID and floor ID.

 try await OneS1ght.refreshZones() // Refresh the zone data on the map.

   let session = try OneS1ght.floorSession()

   // Zone enter · exit · dwell
   session.onZoneEnter = { zone in showCoupon(zone) }   // Callback fired when the user enters a zone.
   session.onZoneExit  = { zone in hideCoupon(zone) }   // Callback fired when the user leaves a zone.
   session.onZoneDwell = { zone, seconds in print("dwell \(Int(seconds))s — \(zone.name)") } // Callback fired while the user stays in a zone.

   // Live coordinate callback. (x, y are returned in floor-plan local meters.)
   session.onPosition = { coord in
       print("📍 x: \(coord.x), y: \(coord.y)")
   }

   // Trigger fired for a specific zone.
   session.onTriggers = { zoneId, triggers in handle(triggers) }

   // SDK debugging. (For development only — do not use it in a production build.)
   OneS1ght.onDebugLog = { level, line in print("[OneS1ght][\(level)] \(line)") }

try await session.begin() // Start positioning

  await session.end() // Stop positioning

import SwiftUI
import CoreLocation
import OneS1ght

@main
struct MyApp: App {
    var body: some Scene {
        WindowGroup { StoreView() }
    }
}

struct StoreView: View {
    @State private var status = "idle"
    private let locationManager = CLLocationManager()

    var body: some View {
        Text(status)
            .task {
                do {
                    // ① Initialize (once, at app start)
                    try await OneS1ght.initialize(sdkKey: "YOUR_SDK_API_KEY",
                                                  geoSdkKey: "YOUR_GEOSPACE_SDK_KEY")

                    // ② Permissions — in a real app, confirm the "allowed" response through the
                    //    delegate before starting positioning (starting before the first prompt is answered fails)
                    locationManager.requestWhenInUseAuthorization()
                    guard await OneS1ght.permissions() == .authorized else {
                        status = "Positioning permission is required"
                        return
                    }

                    // ③ Connect a profile (your app stores the issued value and reuses it)
                    let profileId = try await OneS1ght.createProfile(["ageBand": "20s"])
                    OneS1ght.identify(profileId: profileId)

                    // ④ Select the positioning space — skip this and no coordinates come out
                    let buildings = try await OneS1ght.buildings()
                    let floors = try await OneS1ght.floors(buildings[0].id)
                    try await OneS1ght.setFloorMap(floors[0], buildingID: buildings[0].id)

                    // ⑤ Register enter callbacks
                    let session = try OneS1ght.floorSession()
                    session.onPosition = { coord in
                        status = String(format: "x %.2f · y %.2f", coord.x, coord.y)
                    }
                    session.onZoneEnter = { zone in print("enter: \(zone.name)") }
                    session.onZoneExit  = { zone in print("exit: \(zone.name)") }

                    // ⑥ Start positioning
                    try await session.begin()
                } catch {
                    status = "failed: \(error)"
                }
            }
            .onDisappear {
                // ⑦ Stop positioning
                Task { @MainActor in
                    if let session = try? OneS1ght.floorSession() { await session.end() }
                }
            }
    }
}