syzygy-services-rn 1.0.0

package/.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches: ['**']
+    tags-ignore: ['*']
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - run: npm ci
+
+      - name: Fetch ESLint + Prettier configs
+        run: |
+          curl -fsSL https://raw.githubusercontent.com/Syzygy-Hub/.github/main/engineering/tooling/rn/.eslintrc.ts.json -o .eslintrc.json
+          curl -fsSL https://raw.githubusercontent.com/Syzygy-Hub/.github/main/engineering/tooling/rn/.prettierrc -o .prettierrc
+
+      - name: Typecheck
+        run: npm run typecheck
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Test
+        run: npm test
+
+      - name: Upload coverage
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage
+          path: coverage/
+          if-no-files-found: warn

package/.github/workflows/release.yml

@@ -0,0 +1,30 @@
+name: Release
+
+on:
+  push:
+    tags: ['[0-9]+.[0-9]+.[0-9]+']
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    uses: Syzygy-Hub/.github/.github/workflows/rn-release.yml@main
+    secrets: inherit
+
+  publish-npm:
+    needs: release
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          registry-url: 'https://registry.npmjs.org'
+          package-manager-cache: false
+      - run: npm ci
+      - run: npm publish --access=public --provenance

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-09-12
+
+### Added
+
+- NetworkClient interface and fetch-backed HTTP client
+- StorageProvider interface and AsyncStorage-backed key-value persistence stub
+- AuthProvider interface and JWT token storage and refresh stub
+- FileProvider interface and RNFS-backed file I/O stub
+- PushProvider interface and push token registration stub
+- DeviceProvider interface and react-native device info stub
+- RemoteConfigProvider interface and in-memory remote config store
+- AnalyticsProvider interface and console analytics event logging stub
+- CrashReporter interface and console crash logging stub
+- WebSocketProvider interface and native WebSocket implementation stub
+
+[1.0.0]: https://github.com/Syzygy-Hub/syzygy-services-rn/releases/tag/1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Syzygy Hub
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+![CI](https://github.com/Syzygy-Hub/syzygy-services-rn/actions/workflows/ci.yml/badge.svg)
+![version](https://img.shields.io/badge/version-1.0.0-blue)
+![platform](https://img.shields.io/badge/platform-React%20Native%20%7C%20TypeScript-61DAFB)
+![license](https://img.shields.io/badge/license-MIT-green)
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Syzygy-Hub/.github/main/assets/syzygy-banner-dark.png">
+  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/Syzygy-Hub/.github/main/assets/syzygy-banner-light.png">
+  <img alt="Syzygy Banner" src="https://raw.githubusercontent.com/Syzygy-Hub/.github/main/assets/syzygy-banner-light.png">
+</picture>
+
+# syzygy-services-rn
+
+Concrete I/O service implementations for the Syzygy React Native ecosystem — networking, persistence, auth, file management, push notifications, device services, remote config, analytics, crash reporting, and WebSocket.
+
+## Modules
+
+| Module | Interface | Implementation | Description |
+|--------|-----------|----------------|-------------|
+| `networking` | `NetworkClient` | `FetchNetworkClient` | HTTP GET/POST via global `fetch` |
+| `persistence` | `StorageProvider` | `InMemoryStorageProvider` | Key-value storage (swap with AsyncStorage) |
+| `auth` | `AuthProvider` | `JWTAuthProvider` | JWT token storage and refresh stub |
+| `filemanagement` | `FileProvider` | `NodeFileProvider` | File read/write/delete (swap with RNFS) |
+| `pushnotifications` | `PushProvider` | `InMemoryPushProvider` | Push token registration stub |
+| `deviceservices` | `DeviceProvider` | `NodeDeviceProvider` | Hostname, platform, OS version |
+| `remoteconfig` | `RemoteConfigProvider` | `InMemoryRemoteConfigProvider` | In-memory remote config store |
+| `analytics` | `AnalyticsProvider` | `ConsoleAnalyticsProvider` | Console-based event logging stub |
+| `crashreporting` | `CrashReporter` | `ConsoleCrashReporter` | Console-based crash/error logging stub |
+| `websocket` | `WebSocketProvider` | `NativeWebSocketProvider` | Native WebSocket implementation stub |
+
+## Installation
+
+```sh
+npm install syzygy-services-rn
+```
+
+## Requirements
+
+- React Native 0.73+
+- TypeScript 5.0+
+- Node 20+
+
+## Dependencies
+
+- `syzygy-foundation-rn` ^1.1.0
+
+## Ecosystem
+
+`syzygy-services-rn` is part of the Syzygy React Native ecosystem. It sits in the **services layer** — the I/O boundary of the architecture — and depends only on `syzygy-foundation-rn`. Each module ships its own interface alongside a concrete implementation, making it straightforward to swap in production adapters (AsyncStorage, RNFS, Firebase, etc.) while keeping the rest of the codebase decoupled.
+
+| Package | Layer | Description |
+|---------|-------|-------------|
+| `syzygy-foundation-rn` | foundation | Primitives, utilities, base types |
+| `syzygy-services-rn` | services | I/O service interfaces and implementations |
+
+## License
+
+MIT

package/dist/__tests__/analytics/AnalyticsProvider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AnalyticsProvider.test.d.ts.map

package/dist/__tests__/analytics/AnalyticsProvider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsProvider.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/analytics/AnalyticsProvider.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/analytics/AnalyticsProvider.test.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const syzygy_foundation_rn_1 = require("syzygy-foundation-rn");
+const AnalyticsProvider_1 = require("../../analytics/AnalyticsProvider");
+// ---------------------------------------------------------------------------
+// InMemoryAnalyticsProvider
+// ---------------------------------------------------------------------------
+describe('InMemoryAnalyticsProvider', () => {
+    it('track stores the event', () => {
+        const provider = new AnalyticsProvider_1.InMemoryAnalyticsProvider();
+        const event = (0, syzygy_foundation_rn_1.createAnalyticsEvent)('button_click', { label: 'submit' });
+        provider.track(event);
+        expect(provider.events).toHaveLength(1);
+        expect(provider.events[0].name).toBe('button_click');
+        expect(provider.events[0].properties.label).toBe('submit');
+    });
+    it('identify stores user properties', () => {
+        const provider = new AnalyticsProvider_1.InMemoryAnalyticsProvider();
+        provider.identify('user-1', { plan: 'pro' });
+        expect(provider.userProperties.userId).toBe('user-1');
+        expect(provider.userProperties.plan).toBe('pro');
+    });
+    it('setUserProperties merges into existing properties', () => {
+        const provider = new AnalyticsProvider_1.InMemoryAnalyticsProvider();
+        provider.setUserProperties({ a: 1 });
+        provider.setUserProperties({ b: 2 });
+        expect(provider.userProperties.a).toBe(1);
+        expect(provider.userProperties.b).toBe(2);
+    });
+    it('trackScreen records the screen name and adds a screen_view event', () => {
+        const provider = new AnalyticsProvider_1.InMemoryAnalyticsProvider();
+        provider.trackScreen('HomeScreen', { tab: 'feed' });
+        expect(provider.screenViews).toEqual(['HomeScreen']);
+        expect(provider.events[0].name).toBe('screen_view');
+        expect(provider.events[0].properties.screenName).toBe('HomeScreen');
+    });
+    it('sessionId is a non-empty string', () => {
+        const provider = new AnalyticsProvider_1.InMemoryAnalyticsProvider();
+        expect(provider.sessionId.length).toBeGreaterThan(0);
+    });
+    it('reset clears user properties and generates a new sessionId', () => {
+        const provider = new AnalyticsProvider_1.InMemoryAnalyticsProvider();
+        provider.identify('user-1', { plan: 'free' });
+        const oldSession = provider.sessionId;
+        provider.reset();
+        expect(provider.userProperties).toEqual({});
+        expect(provider.sessionId).not.toBe(oldSession);
+    });
+});
+// ---------------------------------------------------------------------------
+// ConsoleAnalyticsProvider
+// ---------------------------------------------------------------------------
+describe('ConsoleAnalyticsProvider', () => {
+    let consoleSpy;
+    beforeEach(() => {
+        consoleSpy = jest.spyOn(console, 'log').mockImplementation(() => undefined);
+    });
+    afterEach(() => {
+        consoleSpy.mockRestore();
+    });
+    it('track emits to console.log', () => {
+        const provider = new AnalyticsProvider_1.ConsoleAnalyticsProvider();
+        const event = (0, syzygy_foundation_rn_1.createAnalyticsEvent)('page_view');
+        provider.track(event);
+        expect(consoleSpy).toHaveBeenCalledWith('[Analytics] track', 'page_view', {}, expect.anything());
+    });
+    it('trackScreen emits a screen_view event', () => {
+        const provider = new AnalyticsProvider_1.ConsoleAnalyticsProvider();
+        provider.trackScreen('SettingsScreen');
+        expect(consoleSpy).toHaveBeenCalledWith('[Analytics] track', 'screen_view', expect.objectContaining({ screenName: 'SettingsScreen' }), expect.anything());
+    });
+    it('identify logs user and updates userProperties', () => {
+        const provider = new AnalyticsProvider_1.ConsoleAnalyticsProvider();
+        provider.identify('u2', { email: 'a@b.com' });
+        expect(provider.userProperties.userId).toBe('u2');
+        expect(consoleSpy).toHaveBeenCalledWith('[Analytics] identify', 'u2', { email: 'a@b.com' });
+    });
+    it('reset generates a new sessionId', () => {
+        const provider = new AnalyticsProvider_1.ConsoleAnalyticsProvider();
+        const s1 = provider.sessionId;
+        provider.reset();
+        expect(provider.sessionId).not.toBe(s1);
+    });
+});
+//# sourceMappingURL=AnalyticsProvider.test.js.map

package/dist/__tests__/analytics/AnalyticsProvider.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsProvider.test.js","sourceRoot":"","sources":["../../../src/__tests__/analytics/AnalyticsProvider.test.ts"],"names":[],"mappings":";;AAAA,+DAA4D;AAE5D,yEAG2C;AAE3C,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,QAAQ,GAAG,IAAI,6CAAyB,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,IAAA,2CAAoB,EAAC,cAAc,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtB,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACxC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrD,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,QAAQ,GAAG,IAAI,6CAAyB,EAAE,CAAC;QACjD,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7C,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,QAAQ,GAAG,IAAI,6CAAyB,EAAE,CAAC;QACjD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACrC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,QAAQ,GAAG,IAAI,6CAAyB,EAAE,CAAC;QACjD,QAAQ,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QACpD,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACpD,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,QAAQ,GAAG,IAAI,6CAAyB,EAAE,CAAC;QACjD,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,QAAQ,GAAG,IAAI,6CAAyB,EAAE,CAAC;QACjD,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC;QACtC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5C,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,IAAI,UAA4B,CAAC;IAEjC,UAAU,CAAC,GAAG,EAAE;QACd,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,WAAW,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,QAAQ,GAAG,IAAI,4CAAwB,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,IAAA,2CAAoB,EAAC,WAAW,CAAC,CAAC;QAChD,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtB,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CACrC,mBAAmB,EACnB,WAAW,EACX,EAAE,EACF,MAAM,CAAC,QAAQ,EAAE,CAClB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,QAAQ,GAAG,IAAI,4CAAwB,EAAE,CAAC;QAChD,QAAQ,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;QACvC,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CACrC,mBAAmB,EACnB,aAAa,EACb,MAAM,CAAC,gBAAgB,CAAC,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC,EACzD,MAAM,CAAC,QAAQ,EAAE,CAClB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,QAAQ,GAAG,IAAI,4CAAwB,EAAE,CAAC;QAChD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,sBAAsB,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,QAAQ,GAAG,IAAI,4CAAwB,EAAE,CAAC;QAChD,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,CAAC;QAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/auth/AuthProvider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AuthProvider.test.d.ts.map

package/dist/__tests__/auth/AuthProvider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthProvider.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/auth/AuthProvider.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/auth/AuthProvider.test.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const syzygy_foundation_rn_1 = require("syzygy-foundation-rn");
+const AuthProvider_1 = require("../../auth/AuthProvider");
+const StorageProvider_1 = require("../../persistence/StorageProvider");
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeToken(overrides = {}) {
+    return {
+        accessToken: 'access-abc',
+        refreshToken: 'refresh-xyz',
+        ...overrides,
+    };
+}
+function makeExpiredToken() {
+    return makeToken({
+        expiresAt: (0, syzygy_foundation_rn_1.createSyzygyTimestamp)(Date.now() - 10000),
+    });
+}
+function makeValidToken() {
+    return makeToken({
+        expiresAt: (0, syzygy_foundation_rn_1.createSyzygyTimestamp)(Date.now() + 60000),
+    });
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('JWTAuthProvider', () => {
+    it('starts in unauthenticated state', () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new AuthProvider_1.JWTAuthProvider({ storage });
+        expect(provider.state.kind).toBe('unauthenticated');
+    });
+    it('authenticate transitions to authenticated', () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new AuthProvider_1.JWTAuthProvider({ storage });
+        provider.authenticate(makeToken());
+        expect(provider.state.kind).toBe('authenticated');
+    });
+    it('authenticate persists the access token in storage', async () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new AuthProvider_1.JWTAuthProvider({ storage });
+        const token = makeToken({ accessToken: 'persisted-token' });
+        provider.authenticate(token);
+        // Allow async persistence to complete
+        await new Promise((r) => setTimeout(r, 0));
+        const stored = await storage.get({ identifier: 'syzygy.auth.accessToken' });
+        expect(stored).toBe('persisted-token');
+    });
+    it('signOut transitions to unauthenticated and clears token', async () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new AuthProvider_1.JWTAuthProvider({ storage });
+        provider.authenticate(makeToken());
+        provider.signOut();
+        await new Promise((r) => setTimeout(r, 0));
+        expect(provider.state.kind).toBe('unauthenticated');
+        const stored = await storage.get({ identifier: 'syzygy.auth.accessToken' });
+        expect(stored).toBeUndefined();
+    });
+    it('subscribe notifies listener on state change', () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new AuthProvider_1.JWTAuthProvider({ storage });
+        const states = [];
+        provider.subscribe((s) => states.push(s.kind));
+        provider.authenticate(makeToken());
+        provider.signOut();
+        expect(states).toEqual(['authenticated', 'unauthenticated']);
+    });
+    it('unsubscribe stops notifications', () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new AuthProvider_1.JWTAuthProvider({ storage });
+        const states = [];
+        const unsub = provider.subscribe((s) => states.push(s.kind));
+        provider.authenticate(makeToken());
+        unsub();
+        provider.signOut();
+        expect(states).toEqual(['authenticated']); // signOut not received
+    });
+    it('restore loads a valid token from storage', async () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new AuthProvider_1.JWTAuthProvider({ storage });
+        provider.authenticate(makeValidToken());
+        await new Promise((r) => setTimeout(r, 0));
+        const provider2 = new AuthProvider_1.JWTAuthProvider({ storage });
+        await provider2.restore();
+        expect(provider2.state.kind).toBe('authenticated');
+    });
+    it('restore transitions to expired when token is past expiresAt', async () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new AuthProvider_1.JWTAuthProvider({ storage });
+        provider.authenticate(makeExpiredToken());
+        await new Promise((r) => setTimeout(r, 0));
+        const provider2 = new AuthProvider_1.JWTAuthProvider({ storage });
+        await provider2.restore();
+        expect(provider2.state.kind).toBe('expired');
+    });
+    it('restore transitions to unauthenticated when no token in storage', async () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new AuthProvider_1.JWTAuthProvider({ storage });
+        await provider.restore();
+        expect(provider.state.kind).toBe('unauthenticated');
+    });
+    it('refresh without network config throws AuthError', async () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new AuthProvider_1.JWTAuthProvider({ storage });
+        provider.authenticate(makeToken());
+        await expect(provider.refresh()).rejects.toBeInstanceOf(AuthProvider_1.AuthError);
+    });
+    it('refresh without an authenticated token throws AuthError', async () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new AuthProvider_1.JWTAuthProvider({ storage });
+        await expect(provider.refresh()).rejects.toBeInstanceOf(AuthProvider_1.AuthError);
+    });
+    it('AuthState helpers work correctly', () => {
+        const token = makeToken();
+        expect(syzygy_foundation_rn_1.AuthState.isAuthenticated(syzygy_foundation_rn_1.AuthState.authenticated(token))).toBe(true);
+        expect(syzygy_foundation_rn_1.AuthState.isAuthenticated(syzygy_foundation_rn_1.AuthState.unauthenticated())).toBe(false);
+        expect(syzygy_foundation_rn_1.AuthState.token(syzygy_foundation_rn_1.AuthState.authenticated(token))).toEqual(token);
+        expect(syzygy_foundation_rn_1.AuthState.token(syzygy_foundation_rn_1.AuthState.unauthenticated())).toBeUndefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// extractExpFromJwt
+// ---------------------------------------------------------------------------
+describe('extractExpFromJwt', () => {
+    function buildJwt(payload) {
+        const header = Buffer.from(JSON.stringify({ alg: 'HS256' })).toString('base64url');
+        const body = Buffer.from(JSON.stringify(payload)).toString('base64url');
+        return `${header}.${body}.sig`;
+    }
+    it('extracts the exp claim as milliseconds', () => {
+        const expSec = Math.floor(Date.now() / 1000) + 3600;
+        const jwt = buildJwt({ exp: expSec });
+        const result = (0, AuthProvider_1.extractExpFromJwt)(jwt);
+        expect(result?.millisecondsSinceEpoch).toBe(expSec * 1000);
+    });
+    it('returns undefined when exp is missing', () => {
+        const jwt = buildJwt({ sub: 'user-1' });
+        expect((0, AuthProvider_1.extractExpFromJwt)(jwt)).toBeUndefined();
+    });
+    it('returns undefined for a malformed token', () => {
+        expect((0, AuthProvider_1.extractExpFromJwt)('not.a')).toBeUndefined();
+        expect((0, AuthProvider_1.extractExpFromJwt)('')).toBeUndefined();
+    });
+});
+//# sourceMappingURL=AuthProvider.test.js.map

package/dist/__tests__/auth/AuthProvider.test.js.map

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

package/dist/__tests__/crashreporting/CrashReporter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=CrashReporter.test.d.ts.map

package/dist/__tests__/crashreporting/CrashReporter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrashReporter.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/crashreporting/CrashReporter.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/crashreporting/CrashReporter.test.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const CrashReporter_1 = require("../../crashreporting/CrashReporter");
+// ---------------------------------------------------------------------------
+// InMemoryCrashReporter
+// ---------------------------------------------------------------------------
+describe('InMemoryCrashReporter', () => {
+    it('recordError stores the error record', () => {
+        const reporter = new CrashReporter_1.InMemoryCrashReporter();
+        const error = new Error('test error');
+        reporter.recordError(error, { module: 'auth' });
+        expect(reporter.errors).toHaveLength(1);
+        expect(reporter.errors[0].error).toBe(error);
+        expect(reporter.errors[0].metadata.module).toBe('auth');
+    });
+    it('reportCrash stores the crash record', () => {
+        const reporter = new CrashReporter_1.InMemoryCrashReporter();
+        reporter.reportCrash('fatal crash', { screen: 'Home' });
+        expect(reporter.crashes).toHaveLength(1);
+        expect(reporter.crashes[0].message).toBe('fatal crash');
+        expect(reporter.crashes[0].metadata.screen).toBe('Home');
+    });
+    it('setUserContext is retrievable', () => {
+        const reporter = new CrashReporter_1.InMemoryCrashReporter();
+        reporter.setUserContext({ userId: 'u1', email: 'u@example.com' });
+        expect(reporter.userContext?.userId).toBe('u1');
+        expect(reporter.userContext?.email).toBe('u@example.com');
+    });
+    it('setUserContext can be cleared with undefined', () => {
+        const reporter = new CrashReporter_1.InMemoryCrashReporter();
+        reporter.setUserContext({ userId: 'u1' });
+        reporter.setUserContext(undefined);
+        expect(reporter.userContext).toBeUndefined();
+    });
+    it('setMetadata stores key-value pairs', () => {
+        const reporter = new CrashReporter_1.InMemoryCrashReporter();
+        reporter.setMetadata('version', '1.2.3');
+        reporter.setMetadata('env', 'prod');
+        expect(reporter.metadata.version).toBe('1.2.3');
+        expect(reporter.metadata.env).toBe('prod');
+    });
+    it('metadata is included in crash records', () => {
+        const reporter = new CrashReporter_1.InMemoryCrashReporter();
+        reporter.setMetadata('buildNumber', '42');
+        reporter.reportCrash('boom');
+        expect(reporter.crashes[0].metadata.buildNumber).toBe('42');
+    });
+    it('metadata is included in error records', () => {
+        const reporter = new CrashReporter_1.InMemoryCrashReporter();
+        reporter.setMetadata('env', 'staging');
+        reporter.recordError(new Error('oops'));
+        expect(reporter.errors[0].metadata.env).toBe('staging');
+    });
+});
+// ---------------------------------------------------------------------------
+// ConsoleCrashReporter
+// ---------------------------------------------------------------------------
+describe('ConsoleCrashReporter', () => {
+    let consoleSpy;
+    beforeEach(() => {
+        consoleSpy = jest.spyOn(console, 'error').mockImplementation(() => undefined);
+    });
+    afterEach(() => {
+        consoleSpy.mockRestore();
+    });
+    it('recordError does not throw', () => {
+        const reporter = new CrashReporter_1.ConsoleCrashReporter();
+        expect(() => reporter.recordError(new Error('non-fatal'), { ctx: 'test' })).not.toThrow();
+        expect(consoleSpy).toHaveBeenCalled();
+    });
+    it('reportCrash does not throw', () => {
+        const reporter = new CrashReporter_1.ConsoleCrashReporter();
+        expect(() => reporter.reportCrash('crash msg')).not.toThrow();
+        expect(consoleSpy).toHaveBeenCalled();
+    });
+    it('setUserContext is stored and reflected in crash reports', () => {
+        const reporter = new CrashReporter_1.ConsoleCrashReporter();
+        reporter.setUserContext({ userId: 'u42' });
+        reporter.reportCrash('uh oh');
+        expect(consoleSpy).toHaveBeenCalledWith('[CrashReporter] CRASH:', 'uh oh', expect.any(Object), expect.objectContaining({ userId: 'u42' }));
+    });
+    it('setMetadata is reflected in error reports', () => {
+        const reporter = new CrashReporter_1.ConsoleCrashReporter();
+        reporter.setMetadata('platform', 'ios');
+        reporter.recordError(new Error('err'));
+        expect(consoleSpy).toHaveBeenCalledWith('[CrashReporter] ERROR:', 'err', expect.objectContaining({ platform: 'ios' }), undefined);
+    });
+});
+//# sourceMappingURL=CrashReporter.test.js.map

package/dist/__tests__/crashreporting/CrashReporter.test.js.map

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

package/dist/__tests__/deviceservices/DeviceProvider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DeviceProvider.test.d.ts.map

package/dist/__tests__/deviceservices/DeviceProvider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceProvider.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/deviceservices/DeviceProvider.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/deviceservices/DeviceProvider.test.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const DeviceProvider_1 = require("../../deviceservices/DeviceProvider");
+const StorageProvider_1 = require("../../persistence/StorageProvider");
+describe('NodeDeviceProvider', () => {
+    it('platform is always "rn"', () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new DeviceProvider_1.NodeDeviceProvider({ storage });
+        expect(provider.platform).toBe('rn');
+    });
+    it('osVersion is a non-empty string', () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new DeviceProvider_1.NodeDeviceProvider({ storage });
+        expect(typeof provider.osVersion).toBe('string');
+        expect(provider.osVersion.length).toBeGreaterThan(0);
+    });
+    it('appVersion matches the override when provided', () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new DeviceProvider_1.NodeDeviceProvider({ storage, appVersion: '2.3.4' });
+        expect(provider.appVersion).toBe('2.3.4');
+    });
+    it('appVersion defaults to a non-empty string when no override', () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new DeviceProvider_1.NodeDeviceProvider({ storage });
+        expect(provider.appVersion.length).toBeGreaterThan(0);
+    });
+    it('isSimulator is false by default', () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new DeviceProvider_1.NodeDeviceProvider({ storage });
+        expect(provider.isSimulator).toBe(false);
+    });
+    it('isSimulator can be overridden', () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new DeviceProvider_1.NodeDeviceProvider({ storage, isSimulator: true });
+        expect(provider.isSimulator).toBe(true);
+    });
+    it('deviceId generates and persists a UUID', async () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new DeviceProvider_1.NodeDeviceProvider({ storage });
+        const id = await provider.deviceId;
+        expect(typeof id).toBe('string');
+        expect(id.length).toBeGreaterThan(0);
+    });
+    it('deviceId is the same across multiple calls', async () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new DeviceProvider_1.NodeDeviceProvider({ storage });
+        const id1 = await provider.deviceId;
+        const id2 = await provider.deviceId;
+        expect(id1).toBe(id2);
+    });
+    it('deviceId persists across provider instances sharing the same storage', async () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider1 = new DeviceProvider_1.NodeDeviceProvider({ storage });
+        const id1 = await provider1.deviceId;
+        const provider2 = new DeviceProvider_1.NodeDeviceProvider({ storage });
+        const id2 = await provider2.deviceId;
+        expect(id1).toBe(id2);
+    });
+    it('deviceId is unique across different storage instances', async () => {
+        const p1 = new DeviceProvider_1.NodeDeviceProvider({ storage: new StorageProvider_1.InMemoryStorageProvider() });
+        const p2 = new DeviceProvider_1.NodeDeviceProvider({ storage: new StorageProvider_1.InMemoryStorageProvider() });
+        const [id1, id2] = await Promise.all([p1.deviceId, p2.deviceId]);
+        expect(id1).not.toBe(id2);
+    });
+});
+//# sourceMappingURL=DeviceProvider.test.js.map