syzygy-services-rn 1.1.0 → 1.2.0

package/.eslintrc.json

@@ -0,0 +1,47 @@
+{
+  "root": true,
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": 2020,
+    "sourceType": "module",
+    "ecmaFeatures": { "jsx": true }
+  },
+  "plugins": ["@typescript-eslint", "react", "react-hooks", "react-native", "import"],
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:react/recommended",
+    "plugin:react-hooks/recommended",
+    // Must always be last: disables ESLint formatting rules that would
+    // otherwise conflict with Prettier's output.
+    "eslint-config-prettier"
+  ],
+  "env": {
+    "es6": true,
+    "node": true,
+    "react-native/react-native": true
+  },
+  "settings": {
+    "react": { "version": "detect" }
+  },
+  "rules": {
+    "@typescript-eslint/no-unused-vars": [
+      "warn",
+      { "argsIgnorePattern": "^_", "varsIgnorePattern": "^_" }
+    ],
+    "@typescript-eslint/no-explicit-any": "warn",
+    "react/prop-types": "off",
+    "react/react-in-jsx-scope": "off",
+    "react-native/no-inline-styles": "warn",
+    "react-native/no-unused-styles": "warn",
+    "import/order": [
+      "warn",
+      {
+        "groups": ["builtin", "external", "internal", "parent", "sibling", "index"],
+        "alphabetize": { "order": "asc", "caseInsensitive": true },
+        "newlines-between": "always"
+      }
+    ]
+  },
+  "ignorePatterns": ["dist", "node_modules", "lib", "build"]
+}

package/.github/workflows/release.yml

@@ -21,10 +21,17 @@ jobs:
       contents: read
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - name: Set up Node
+        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
+      - name: Install dependencies
+        run: npm ci
+      - name: Lint
+        run: npm run lint
+      - name: Type check
+        run: npm run typecheck
+      - name: Test
+        run: npm test
+      - name: Publish to npm
+        run: npm publish --access=public --provenance

package/.prettierrc

@@ -0,0 +1,9 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "tabWidth": 2,
+  "useTabs": false,
+  "printWidth": 100,
+  "arrowParens": "always"
+}

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.0] - 2026-09-19
+
+### Fixed
+- `DeviceProvider`: concurrent `getDeviceId()` calls now share one UUID generation via single-flight Promise memoization
+
+### Changed
+- npm publish gated behind lint + typecheck + test in release.yml
+- `StorageProvider.set(value, key)` argument order documented — Foundation v1.2.0 TODO noted
+- Canonical backoff policy: 500ms base, 2.0× multiplier, full jitter, 8 000ms cap, max 3 retries
+- Foundation dependency updated to ^1.2.0
+
 ## [1.1.0] - 2026-09-13
 
 ### Added
@@ -57,6 +68,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - CrashReporter interface and console crash logging stub
 - WebSocketProvider interface and native WebSocket implementation stub
 
-[Unreleased]: https://github.com/Syzygy-Hub/syzygy-services-rn/compare/1.1.0...HEAD
+[Unreleased]: https://github.com/Syzygy-Hub/syzygy-services-rn/compare/1.2.0...HEAD
+[1.2.0]: https://github.com/Syzygy-Hub/syzygy-services-rn/compare/1.1.0...1.2.0
 [1.1.0]: https://github.com/Syzygy-Hub/syzygy-services-rn/compare/1.0.0...1.1.0
 [1.0.0]: https://github.com/Syzygy-Hub/syzygy-services-rn/releases/tag/1.0.0

package/CONTRACT_TESTS.md

@@ -106,3 +106,13 @@ implemented in this repo's test suite; tests marked 🔲 are not yet implemented
 | simulateBinaryMessage() emits to binary callback | ✅ |
 | dispose() closes connection | ✅ |
 | dispose() is idempotent | ✅ |
+
+## Idempotency Tests
+
+| Module | Scenario | Status |
+|--------|----------|--------|
+| networking | `dispose()` called twice does not throw | ❌ (test not yet implemented) |
+| websocket | `disconnect()` called before `connect()` does not throw | ❌ (test not yet implemented) |
+| websocket | `disconnect()` called twice does not throw | ❌ (test not yet implemented) |
+| auth | `signOut()` called when already signed out does not throw | ❌ (test not yet implemented) |
+| persistence | `clear()` called on empty store does not throw | ❌ (test not yet implemented) |

package/README.md

@@ -1,4 +1,4 @@
-[![React Native](https://img.shields.io/badge/React%20Native-TypeScript-61DAFB?style=flat)](https://reactnative.dev) [![TypeScript](https://img.shields.io/badge/TypeScript-5.0%2B-3178C6?logo=typescript&logoColor=white&style=flat)](https://www.typescriptlang.org) [![CI](https://img.shields.io/github/actions/workflow/status/Syzygy-Hub/syzygy-services-rn/ci.yml?label=ci&style=flat)](https://github.com/Syzygy-Hub/syzygy-services-rn/actions/workflows/ci.yml) [![Version](https://img.shields.io/badge/version-1.1.0-D85A30?style=flat)](https://github.com/Syzygy-Hub/syzygy-services-rn/releases) [![License](https://img.shields.io/badge/License-MIT-green?style=flat)](LICENSE)
+[![React Native](https://img.shields.io/badge/React%20Native-TypeScript-61DAFB?style=flat)](https://reactnative.dev) [![TypeScript](https://img.shields.io/badge/TypeScript-5.0%2B-3178C6?logo=typescript&logoColor=white&style=flat)](https://www.typescriptlang.org) [![CI](https://img.shields.io/github/actions/workflow/status/Syzygy-Hub/syzygy-services-rn/ci.yml?label=ci&style=flat)](https://github.com/Syzygy-Hub/syzygy-services-rn/actions/workflows/ci.yml) [![Version](https://img.shields.io/badge/version-1.2.0-D85A30?style=flat)](https://github.com/Syzygy-Hub/syzygy-services-rn/releases) [![License](https://img.shields.io/badge/License-MIT-green?style=flat)](LICENSE)
 
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Syzygy-Hub/.github/main/brand/assets/banners/syzygy-banner-dark-1200.png">
@@ -38,7 +38,7 @@ npm install syzygy-services-rn
 
 ## Dependencies
 
-- `syzygy-foundation-rn` ^1.1.0
+- `syzygy-foundation-rn` ^1.2.0
 
 ## Ecosystem
 

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

@@ -62,5 +62,11 @@ describe('NodeDeviceProvider', () => {
         const [id1, id2] = await Promise.all([p1.deviceId, p2.deviceId]);
         expect(id1).not.toBe(id2);
     });
+    it('concurrent getDeviceId calls all return same UUID', async () => {
+        const storage = new StorageProvider_1.InMemoryStorageProvider();
+        const provider = new DeviceProvider_1.NodeDeviceProvider({ storage });
+        const results = await Promise.all(Array.from({ length: 10 }, () => provider.deviceId));
+        expect(new Set(results).size).toBe(1);
+    });
 });
 //# sourceMappingURL=DeviceProvider.test.js.map

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

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

package/dist/__tests__/networking/RetryIntegration.test.js

@@ -100,27 +100,27 @@ describe('FetchNetworkClient — retry integration', () => {
         await expect(client.execute(makeRequest())).rejects.toThrow();
         expect(mockFetch).toHaveBeenCalledTimes(maxRetries + 1);
     });
-    it('exponential backoff: delay doubles each retry', async () => {
+    it('exponential backoff: delay grows with each retry (jitter range check)', async () => {
         const baseDelay = 100;
+        const capMs = 8000;
         const maxRetries = 3;
         const mockFetch = makeAlwaysFail(500);
         global.fetch = mockFetch;
-        // Capture retry delays by checking FetchNetworkClient formula indirectly:
-        // attempt 1 → base*2^0, attempt 2 → base*2^1, attempt 3 → base*2^2
-        const expectedDelays = [
-            baseDelay * Math.pow(2, 0),
-            baseDelay * Math.pow(2, 1),
-            baseDelay * Math.pow(2, 2),
+        // Canonical policy: delay = random(0, min(cap, base * 2^attempt))
+        // attempt 1 → [0, min(cap, base*2^0)] = [0, 100]
+        // attempt 2 → [0, min(cap, base*2^1)] = [0, 200]
+        // attempt 3 → [0, min(cap, base*2^2)] = [0, 400]
+        const expectedCaps = [
+            Math.min(capMs, baseDelay * Math.pow(2, 0)),
+            Math.min(capMs, baseDelay * Math.pow(2, 1)),
+            Math.min(capMs, baseDelay * Math.pow(2, 2)),
         ];
-        // Verify via the observable: stub setTimeout so retries run instantly,
-        // capture only delays in the [baseDelay..] range (exclude the per-request
-        // abort timeout which is set to timeoutSeconds * 1000 = 30000 ms).
         const capturedDelays = [];
         jest
             .spyOn(global, 'setTimeout')
             .mockImplementation((fn, ms, ...args) => {
             const delay = ms ?? 0;
-            if (delay > 0 && delay <= baseDelay * 10) {
+            if (delay >= 0 && delay <= baseDelay * 10) {
                 // Only capture retry-range delays
                 capturedDelays.push(delay);
             }
@@ -128,9 +128,17 @@ describe('FetchNetworkClient — retry integration', () => {
             fn(...args);
             return 0;
         });
-        const client = new NetworkClient_1.FetchNetworkClient({ maxRetries, retryBaseDelayMs: baseDelay });
+        const client = new NetworkClient_1.FetchNetworkClient({
+            maxRetries,
+            retryBaseDelayMs: baseDelay,
+            retryCapMs: capMs,
+        });
         await expect(client.execute(makeRequest())).rejects.toThrow();
-        expect(capturedDelays).toEqual(expectedDelays);
+        expect(capturedDelays).toHaveLength(maxRetries);
+        capturedDelays.forEach((delay, i) => {
+            expect(delay).toBeGreaterThanOrEqual(0);
+            expect(delay).toBeLessThanOrEqual(expectedCaps[i]);
+        });
     });
     it('zero maxRetries means no retry — only one attempt', async () => {
         installDelayStub();
@@ -161,25 +169,32 @@ describe('FetchNetworkClient — injectable BackoffClock (deterministic backoff)
     afterEach(() => {
         jest.restoreAllMocks();
     });
-    it('injectable BackoffClock is called once per retry with correct delays', async () => {
+    it('injectable BackoffClock is called once per retry with jitter delays in expected range', async () => {
         const { backoffClock, delays } = makeInjectableSleep();
         const baseDelay = 100;
+        const capMs = 8000;
         const maxRetries = 3;
         const mockFetch = makeAlwaysFail(500);
         global.fetch = mockFetch;
         const client = new NetworkClient_1.FetchNetworkClient({
             maxRetries,
             retryBaseDelayMs: baseDelay,
+            retryCapMs: capMs,
             backoffClock,
         });
         await expect(client.execute(makeRequest())).rejects.toThrow();
         // backoffClock called once per retry (not for the initial attempt)
         expect(delays).toHaveLength(maxRetries);
-        expect(delays).toEqual([
-            baseDelay * Math.pow(2, 0), // 100
-            baseDelay * Math.pow(2, 1), // 200
-            baseDelay * Math.pow(2, 2), // 400
-        ]);
+        // Canonical policy: delay = random(0, min(cap, base * 2^attempt))
+        const expectedCaps = [
+            Math.min(capMs, baseDelay * Math.pow(2, 0)), // [0, 100]
+            Math.min(capMs, baseDelay * Math.pow(2, 1)), // [0, 200]
+            Math.min(capMs, baseDelay * Math.pow(2, 2)), // [0, 400]
+        ];
+        delays.forEach((delay, i) => {
+            expect(delay).toBeGreaterThanOrEqual(0);
+            expect(delay).toBeLessThanOrEqual(expectedCaps[i]);
+        });
     });
     it('injectable BackoffClock is NOT called on first attempt (no prior failure)', async () => {
         const { backoffClock, delays } = makeInjectableSleep();
@@ -202,28 +217,39 @@ describe('FetchNetworkClient — injectable BackoffClock (deterministic backoff)
     it('injectable BackoffClock records partial delays when server recovers mid-retry', async () => {
         const { backoffClock, delays } = makeInjectableSleep();
         const baseDelay = 50;
+        const capMs = 8000;
         global.fetch = makeRecoverAfter(2);
         const client = new NetworkClient_1.FetchNetworkClient({
             maxRetries: 3,
             retryBaseDelayMs: baseDelay,
+            retryCapMs: capMs,
             backoffClock,
         });
         const response = await client.execute(makeRequest());
         expect(response.statusCode).toBe(200);
         // 2 failures → 2 sleeps
         expect(delays).toHaveLength(2);
-        expect(delays).toEqual([baseDelay * Math.pow(2, 0), baseDelay * Math.pow(2, 1)]);
+        // Canonical policy: delay = random(0, min(cap, base * 2^attempt))
+        const expectedCaps = [
+            Math.min(capMs, baseDelay * Math.pow(2, 0)), // [0, 50]
+            Math.min(capMs, baseDelay * Math.pow(2, 1)), // [0, 100]
+        ];
+        delays.forEach((delay, i) => {
+            expect(delay).toBeGreaterThanOrEqual(0);
+            expect(delay).toBeLessThanOrEqual(expectedCaps[i]);
+        });
     });
     it('default BackoffClock (no injection) still works — setTimeout is used for retry delay', async () => {
         // Stub setTimeout so the test runs fast; filter for retry-range delays only.
         const baseDelay = 10;
+        const capMs = 8000;
         const capturedDelays = [];
         jest
             .spyOn(global, 'setTimeout')
             .mockImplementation((fn, ms, ...args) => {
             const d = ms ?? 0;
             // Capture only the retry-range delay (not the per-request abort timeout)
-            if (d > 0 && d <= baseDelay * 10)
+            if (d >= 0 && d <= baseDelay * 10)
                 capturedDelays.push(d);
             fn(...args);
             return 0;
@@ -231,11 +257,63 @@ describe('FetchNetworkClient — injectable BackoffClock (deterministic backoff)
         const mockFetch = makeAlwaysFail(500);
         global.fetch = mockFetch;
         // No backoffClock injected — uses default setTimeout-backed delay
-        const client = new NetworkClient_1.FetchNetworkClient({ maxRetries: 1, retryBaseDelayMs: baseDelay });
+        const client = new NetworkClient_1.FetchNetworkClient({
+            maxRetries: 1,
+            retryBaseDelayMs: baseDelay,
+            retryCapMs: capMs,
+        });
         await expect(client.execute(makeRequest())).rejects.toThrow();
-        // 1 retry → 1 delay recorded in the retry-range
+        // 1 retry → 1 delay recorded in the retry-range (jittered: [0, min(cap, base)])
         expect(capturedDelays).toHaveLength(1);
-        expect(capturedDelays[0]).toBe(baseDelay);
+        expect(capturedDelays[0]).toBeGreaterThanOrEqual(0);
+        expect(capturedDelays[0]).toBeLessThanOrEqual(Math.min(capMs, baseDelay));
+    });
+});
+// ---------------------------------------------------------------------------
+// Canonical backoff policy contract assertions
+// Verifies the cross-platform backoff contract:
+//   delay = random(0, min(BACKOFF_CAP_MS, BACKOFF_BASE_MS * BACKOFF_MULTIPLIER^attempt))
+// ---------------------------------------------------------------------------
+describe('Canonical backoff policy — range assertions', () => {
+    afterEach(() => {
+        jest.restoreAllMocks();
+    });
+    it('attempt 0 (retry 1): delay in [0, 500]', async () => {
+        const { backoffClock, delays } = makeInjectableSleep();
+        global.fetch = makeAlwaysFail(500);
+        const client = new NetworkClient_1.FetchNetworkClient({ maxRetries: 1, backoffClock });
+        await expect(client.execute(makeRequest())).rejects.toThrow();
+        expect(delays).toHaveLength(1);
+        expect(delays[0]).toBeGreaterThanOrEqual(0);
+        expect(delays[0]).toBeLessThanOrEqual(Math.min(NetworkClient_1.BACKOFF_CAP_MS, NetworkClient_1.BACKOFF_BASE_MS * Math.pow(NetworkClient_1.BACKOFF_MULTIPLIER, 0)));
+    });
+    it('attempt 1 (retry 2): delay in [0, 1000]', async () => {
+        const { backoffClock, delays } = makeInjectableSleep();
+        global.fetch = makeAlwaysFail(500);
+        const client = new NetworkClient_1.FetchNetworkClient({ maxRetries: 2, backoffClock });
+        await expect(client.execute(makeRequest())).rejects.toThrow();
+        expect(delays).toHaveLength(2);
+        expect(delays[1]).toBeGreaterThanOrEqual(0);
+        expect(delays[1]).toBeLessThanOrEqual(Math.min(NetworkClient_1.BACKOFF_CAP_MS, NetworkClient_1.BACKOFF_BASE_MS * Math.pow(NetworkClient_1.BACKOFF_MULTIPLIER, 1)));
+    });
+    it('attempt 2 (retry 3): delay in [0, 2000]', async () => {
+        const { backoffClock, delays } = makeInjectableSleep();
+        global.fetch = makeAlwaysFail(500);
+        const client = new NetworkClient_1.FetchNetworkClient({ maxRetries: NetworkClient_1.MAX_RETRY_ATTEMPTS, backoffClock });
+        await expect(client.execute(makeRequest())).rejects.toThrow();
+        expect(delays.length).toBeGreaterThanOrEqual(3);
+        expect(delays[2]).toBeGreaterThanOrEqual(0);
+        expect(delays[2]).toBeLessThanOrEqual(Math.min(NetworkClient_1.BACKOFF_CAP_MS, NetworkClient_1.BACKOFF_BASE_MS * Math.pow(NetworkClient_1.BACKOFF_MULTIPLIER, 2)));
+    });
+    it('attempt 3 (retry 4): delay in [0, 8000] — cap applies', async () => {
+        const { backoffClock, delays } = makeInjectableSleep();
+        global.fetch = makeAlwaysFail(500);
+        const client = new NetworkClient_1.FetchNetworkClient({ maxRetries: 4, backoffClock });
+        await expect(client.execute(makeRequest())).rejects.toThrow();
+        expect(delays.length).toBeGreaterThanOrEqual(4);
+        // base * 2^3 = 4000, which is < cap 8000, so cap = 8000 but actual max is 4000
+        expect(delays[3]).toBeGreaterThanOrEqual(0);
+        expect(delays[3]).toBeLessThanOrEqual(NetworkClient_1.BACKOFF_CAP_MS);
     });
 });
 //# sourceMappingURL=RetryIntegration.test.js.map

package/dist/__tests__/networking/RetryIntegration.test.js.map

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

package/dist/__tests__/persistence/StorageProvider.test.js

@@ -91,5 +91,14 @@ describe('InMemoryStorageProvider', () => {
         // No TypeError because there is no type hint to validate against
         await expect(provider.get(readKey)).resolves.toBe(42);
     });
+    it('concurrent reads and writes do not throw', async () => {
+        const provider = new StorageProvider_1.InMemoryStorageProvider();
+        const key = (0, syzygy_foundation_rn_1.createStorageKey)('concurrent.key');
+        const ops = [
+            ...Array.from({ length: 5 }, () => provider.set('value', key)),
+            ...Array.from({ length: 5 }, () => provider.get(key)),
+        ];
+        await expect(Promise.all(ops)).resolves.toBeDefined();
+    });
 });
 //# sourceMappingURL=StorageProvider.test.js.map

package/dist/__tests__/persistence/StorageProvider.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"StorageProvider.test.js","sourceRoot":"","sources":["../../../src/__tests__/persistence/StorageProvider.test.ts"],"names":[],"mappings":";;AAAA,+DAAwD;AAExD,uEAA4E;AAE5E,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,QAAQ,GAAG,IAAI,yCAAuB,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAA,uCAAgB,EAAS,UAAU,CAAC,CAAC;QACjD,MAAM,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,QAAQ,GAAG,IAAI,yCAAuB,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAA,uCAAgB,EAAS,OAAO,CAAC,CAAC;QAC9C,MAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC5B,MAAM,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,QAAQ,GAAG,IAAI,yCAAuB,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAA,uCAAgB,EAAU,MAAM,CAAC,CAAC;QAC9C,MAAM,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,QAAQ,GAAG,IAAI,yCAAuB,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAA,uCAAgB,EAA2B,KAAK,CAAC,CAAC;QAC9D,MAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,QAAQ,GAAG,IAAI,yCAAuB,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAA,uCAAgB,EAAS,SAAS,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,QAAQ,GAAG,IAAI,yCAAuB,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAA,uCAAgB,EAAS,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC3D,MAAM,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,QAAQ,GAAG,IAAI,yCAAuB,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAA,uCAAgB,EAAS,MAAM,CAAC,CAAC;QAC7C,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,MAAM,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,QAAQ,GAAG,IAAI,yCAAuB,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAA,uCAAgB,EAAS,MAAM,CAAC,CAAC;QAC7C,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,QAAQ,GAAG,IAAI,yCAAuB,EAAE,CAAC;QAC/C,MAAM,EAAE,GAAG,IAAA,uCAAgB,EAAS,GAAG,CAAC,CAAC;QACzC,MAAM,EAAE,GAAG,IAAA,uCAAgB,EAAS,GAAG,CAAC,CAAC;QACzC,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC5B,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1B,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;QACvB,MAAM,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAC/C,MAAM,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,EAAE,GAAG,IAAI,yCAAuB,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,IAAI,yCAAuB,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,IAAA,uCAAgB,EAAS,QAAQ,CAAC,CAAC;QAC/C,MAAM,EAAE,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,QAAQ,GAAG,IAAI,yCAAuB,EAAE,CAAC;QAC/C,gDAAgD;QAChD,MAAM,MAAM,GAAG,IAAA,uCAAgB,EAAS,OAAO,CAAC,CAAC;QACjD,MAAM,QAAQ,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC3C,kFAAkF;QAClF,MAAM,MAAM,GAAG,IAAA,uCAAgB,EAAS,OAAO,EAAE,CAAC,CAAC,CAAC;QACpD,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9D,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,QAAQ,GAAG,IAAI,yCAAuB,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAA,uCAAgB,EAAS,OAAO,EAAE,CAAC,CAAC,CAAC;QACjD,MAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC5B,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,+EAA+E;QAC/E,MAAM,QAAQ,GAAG,IAAI,yCAAuB,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAG,IAAA,uCAAgB,EAAS,GAAG,CAAC,CAAC;QAC/C,MAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,IAAA,uCAAgB,EAAS,GAAG,CAAC,CAAC,CAAC,kBAAkB;QACjE,iEAAiE;QACjE,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"StorageProvider.test.js","sourceRoot":"","sources":["../../../src/__tests__/persistence/StorageProvider.test.ts"],"names":[],"mappings":"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"}

package/dist/deviceservices/DeviceProvider.d.ts

@@ -41,6 +41,7 @@ export declare class NodeDeviceProvider implements DeviceProvider {
     private readonly _appVersion;
     private readonly _isSimulator;
     private _cachedDeviceId;
+    private _pendingId;
     constructor(options: NodeDeviceProviderOptions);
     /**
      * Returns the persistent device ID, generating and storing one on first

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

@@ -1 +1 @@
-{"version":3,"file":"DeviceProvider.d.ts","sourceRoot":"","sources":["../../src/deviceservices/DeviceProvider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AA0B5D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAQD,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC,8DAA8D;IAC9D,OAAO,EAAE,eAAe,CAAC;IACzB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,eAAe,CAAqB;gBAEhC,OAAO,EAAE,yBAAyB;IAM9C;;;OAGG;IACH,IAAI,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAK9B;IAED,qBAAqB;IACrB,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,kCAAkC;IAClC,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,qDAAqD;IACrD,IAAI,WAAW,IAAI,OAAO,CAEzB;YAIa,qBAAqB;CAWpC"}
+{"version":3,"file":"DeviceProvider.d.ts","sourceRoot":"","sources":["../../src/deviceservices/DeviceProvider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AA0B5D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAQD,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC,8DAA8D;IAC9D,OAAO,EAAE,eAAe,CAAC;IACzB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,UAAU,CAAgC;gBAEtC,OAAO,EAAE,yBAAyB;IAM9C;;;OAGG;IACH,IAAI,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAY9B;IAED,qBAAqB;IACrB,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,kCAAkC;IAClC,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,qDAAqD;IACrD,IAAI,WAAW,IAAI,OAAO,CAEzB;YAIa,qBAAqB;CAWpC"}

package/dist/deviceservices/DeviceProvider.js

@@ -36,6 +36,7 @@ const DEVICE_ID_KEY = (0, syzygy_foundation_rn_1.createStorageKey)('syzygy.devic
  */
 class NodeDeviceProvider {
     constructor(options) {
+        this._pendingId = null;
         this.storage = options.storage;
         this._appVersion = options.appVersion ?? readAppVersion();
         this._isSimulator = options.isSimulator ?? false;
@@ -48,7 +49,14 @@ class NodeDeviceProvider {
         if (this._cachedDeviceId !== undefined) {
             return Promise.resolve(this._cachedDeviceId);
         }
-        return this._loadOrCreateDeviceId();
+        // Return existing in-flight promise to prevent concurrent callers from
+        // each generating their own UUID before the first write completes.
+        if (this._pendingId)
+            return this._pendingId;
+        this._pendingId = this._loadOrCreateDeviceId().finally(() => {
+            this._pendingId = null;
+        });
+        return this._pendingId;
     }
     /** Always `'rn'`. */
     get platform() {

package/dist/deviceservices/DeviceProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"DeviceProvider.js","sourceRoot":"","sources":["../../src/deviceservices/DeviceProvider.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AAEpB,+DAAwD;AAGxD,8EAA8E;AAC9E,oCAAoC;AACpC,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,YAAY;IACnB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC7E,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IACD,kCAAkC;IAClC,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;QACnE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC1C,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC;AA6BD,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,MAAM,aAAa,GAAG,IAAA,uCAAgB,EAAS,oBAAoB,CAAC,CAAC;AAYrE;;;;;GAKG;AACH,MAAa,kBAAkB;IAM7B,YAAY,OAAkC;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,IAAI,cAAc,EAAE,CAAC;QAC1D,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,IAAI,QAAQ;QACV,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACvC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,IAAI,CAAC,qBAAqB,EAAE,CAAC;IACtC,CAAC;IAED,qBAAqB;IACrB,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,IAAI,SAAS;QACX,OAAO,YAAE,CAAC,OAAO,EAAE,CAAC;IACtB,CAAC;IAED,kCAAkC;IAClC,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,qDAAqD;IACrD,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,4EAA4E;IAEpE,KAAK,CAAC,qBAAqB;QACjC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC;YAC9B,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;QAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;QAC1C,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AA3DD,gDA2DC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,oEAAoE;QACpE,2EAA2E;QAC3E,+EAA+E;QAC/E,qGAAqG;QACrG,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAyB,CAAC;QAClE,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC"}
+{"version":3,"file":"DeviceProvider.js","sourceRoot":"","sources":["../../src/deviceservices/DeviceProvider.ts"],"names":[],"mappings":"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"}

package/dist/networking/NetworkClient.d.ts

@@ -34,12 +34,22 @@ export interface RequestInterceptor {
  * @param ms  Milliseconds to sleep.
  */
 export type BackoffClock = (ms: number) => Promise<void>;
+/** Base delay in milliseconds for exponential back-off. */
+export declare const BACKOFF_BASE_MS = 500;
+/** Multiplier applied to the base delay on each successive attempt. */
+export declare const BACKOFF_MULTIPLIER = 2;
+/** Maximum delay cap in milliseconds for any single back-off sleep. */
+export declare const BACKOFF_CAP_MS = 8000;
+/** Maximum number of retry attempts before giving up. */
+export declare const MAX_RETRY_ATTEMPTS = 3;
 /** Configuration options for {@link FetchNetworkClient}. */
 export interface FetchNetworkClientOptions {
-    /** Maximum number of automatic retries on server errors (5xx). Default: 3. */
+    /** Maximum number of automatic retries on server errors (5xx). Default: {@link MAX_RETRY_ATTEMPTS}. */
     maxRetries?: number;
-    /** Base delay (ms) for exponential back-off. Default: 200. */
+    /** Base delay (ms) for exponential back-off. Default: {@link BACKOFF_BASE_MS}. */
     retryBaseDelayMs?: number;
+    /** Cap (ms) for exponential back-off. Default: {@link BACKOFF_CAP_MS}. */
+    retryCapMs?: number;
     /** Interceptors applied to every request before dispatch. */
     interceptors?: RequestInterceptor[];
     /**
@@ -68,6 +78,7 @@ export interface FetchNetworkClientOptions {
 export declare class FetchNetworkClient implements NetworkClientProtocol {
     private readonly maxRetries;
     private readonly retryBaseDelayMs;
+    private readonly retryCapMs;
     private readonly interceptors;
     private readonly backoffClock;
     private readonly logger?;

package/dist/networking/NetworkClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NetworkClient.d.ts","sourceRoot":"","sources":["../../src/networking/NetworkClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAM5E;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,kBAAkB;IAClB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,kBAAkB;IAClB,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC;gBAG/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,EACrB,QAAQ,GAAE,mBAA+C,EACzD,eAAe,CAAC,EAAE,KAAK;CAQ1B;AAMD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9E;AAMD;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzD,4DAA4D;AAC5D,MAAM,WAAW,yBAAyB;IACxC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACpC;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,YAAW,qBAAqB;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuB;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAiB;IACzC,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,GAAE,yBAA8B;IAQnD;;;;;OAKG;IACH,OAAO,IAAI,IAAI;IAIf;;;;;;;;OAQG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;YAyElD,YAAY;CAoE3B"}
+{"version":3,"file":"NetworkClient.d.ts","sourceRoot":"","sources":["../../src/networking/NetworkClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAM5E;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,kBAAkB;IAClB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,kBAAkB;IAClB,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC;gBAG/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,EACrB,QAAQ,GAAE,mBAA+C,EACzD,eAAe,CAAC,EAAE,KAAK;CAQ1B;AAMD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9E;AAMD;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAOzD,2DAA2D;AAC3D,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,IAAM,CAAC;AACtC,uEAAuE;AACvE,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,yDAAyD;AACzD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,4DAA4D;AAC5D,MAAM,WAAW,yBAAyB;IACxC,uGAAuG;IACvG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACpC;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,YAAW,qBAAqB;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuB;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAiB;IACzC,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,GAAE,yBAA8B;IASnD;;;;;OAKG;IACH,OAAO,IAAI,IAAI;IAIf;;;;;;;;OAQG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;YA6ElD,YAAY;CAoE3B"}

package/dist/networking/NetworkClient.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FetchNetworkClient = exports.NetworkError = void 0;
+exports.FetchNetworkClient = exports.MAX_RETRY_ATTEMPTS = exports.BACKOFF_CAP_MS = exports.BACKOFF_MULTIPLIER = exports.BACKOFF_BASE_MS = exports.NetworkError = void 0;
 const syzygy_foundation_rn_1 = require("syzygy-foundation-rn");
 // ---------------------------------------------------------------------------
 // NetworkError — local SyzygyError implementation
@@ -19,6 +19,18 @@ class NetworkError extends Error {
     }
 }
 exports.NetworkError = NetworkError;
+// ---------------------------------------------------------------------------
+// Canonical backoff policy (all 4 platforms must match)
+// delay = random(0, min(cap, base * multiplier^attempt))
+// ---------------------------------------------------------------------------
+/** Base delay in milliseconds for exponential back-off. */
+exports.BACKOFF_BASE_MS = 500;
+/** Multiplier applied to the base delay on each successive attempt. */
+exports.BACKOFF_MULTIPLIER = 2.0;
+/** Maximum delay cap in milliseconds for any single back-off sleep. */
+exports.BACKOFF_CAP_MS = 8000;
+/** Maximum number of retry attempts before giving up. */
+exports.MAX_RETRY_ATTEMPTS = 3;
 /**
  * Fetch-based implementation of {@link NetworkClientProtocol}.
  *
@@ -32,8 +44,9 @@ exports.NetworkError = NetworkError;
 class FetchNetworkClient {
     constructor(options = {}) {
         this._disposed = false;
-        this.maxRetries = options.maxRetries ?? 3;
-        this.retryBaseDelayMs = options.retryBaseDelayMs ?? 200;
+        this.maxRetries = options.maxRetries ?? exports.MAX_RETRY_ATTEMPTS;
+        this.retryBaseDelayMs = options.retryBaseDelayMs ?? exports.BACKOFF_BASE_MS;
+        this.retryCapMs = options.retryCapMs ?? exports.BACKOFF_CAP_MS;
         this.interceptors = options.interceptors ?? [];
         this.backoffClock = options.backoffClock ?? defaultBackoffClock;
         this.logger = options.logger;
@@ -77,7 +90,8 @@ class FetchNetworkClient {
         let lastError;
         for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
             if (attempt > 0) {
-                await this.backoffClock(this.retryBaseDelayMs * Math.pow(2, attempt - 1));
+                const cap = Math.min(this.retryCapMs, this.retryBaseDelayMs * Math.pow(exports.BACKOFF_MULTIPLIER, attempt - 1));
+                await this.backoffClock(Math.random() * cap);
             }
             try {
                 const response = await this._executeOnce(intercepted);

package/dist/networking/NetworkClient.js.map

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

package/dist/persistence/StorageProvider.d.ts

@@ -23,6 +23,10 @@ export declare class InMemoryStorageProvider implements StorageProvider {
     /**
      * Serialises `value` as JSON and persists it under `key`.
      *
+     * @param value - The value to store (NOTE: value comes before key —
+     *   this matches the Foundation contract. See Foundation v1.2.0
+     *   for potential API alignment.)
+     * @param key - The storage key
      * @typeParam T  The value type.
      */
     set<T>(value: T, key: StorageKey<T>): Promise<void>;

package/dist/persistence/StorageProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StorageProvider.d.ts","sourceRoot":"","sources":["../../src/persistence/StorageProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExE;;;;;;;;;;;GAWG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IAEnD;;;;;OAKG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IA0BxD;;;;OAIG;IACG,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;;;OAIG;IACG,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}
+{"version":3,"file":"StorageProvider.d.ts","sourceRoot":"","sources":["../../src/persistence/StorageProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExE;;;;;;;;;;;GAWG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IAEnD;;;;;OAKG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IA0BxD;;;;;;;;OAQG;IACG,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;;;OAIG;IACG,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/persistence/StorageProvider.js

@@ -46,6 +46,10 @@ class InMemoryStorageProvider {
     /**
      * Serialises `value` as JSON and persists it under `key`.
      *
+     * @param value - The value to store (NOTE: value comes before key —
+     *   this matches the Foundation contract. See Foundation v1.2.0
+     *   for potential API alignment.)
+     * @param key - The storage key
      * @typeParam T  The value type.
      */
     async set(value, key) {

package/dist/persistence/StorageProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"StorageProvider.js","sourceRoot":"","sources":["../../src/persistence/StorageProvider.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;GAWG;AACH,MAAa,uBAAuB;IAApC;QACmB,UAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IA0DrD,CAAC;IAxDC;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAI,GAAkB;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC,YAAY,CAAC;QAE/C,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,SAAS,CACjB,yBAAyB,GAAG,CAAC,UAAU,sDAAsD,CAC9F,CAAC;QACJ,CAAC;QAED,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,YAAY,GAAG,OAAO,GAAG,CAAC,YAAY,CAAC;YAC7C,MAAM,UAAU,GAAG,OAAO,MAAM,CAAC;YACjC,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;gBAChC,MAAM,IAAI,SAAS,CACjB,yBAAyB,GAAG,CAAC,UAAU,6BAA6B,UAAU,eAAe,YAAY,iBAAiB,CAC3H,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,MAAW,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG,CAAI,KAAQ,EAAE,GAAkB;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACxD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAI,GAAkB;QAChC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AA3DD,0DA2DC"}
+{"version":3,"file":"StorageProvider.js","sourceRoot":"","sources":["../../src/persistence/StorageProvider.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;GAWG;AACH,MAAa,uBAAuB;IAApC;QACmB,UAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IA8DrD,CAAC;IA5DC;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAI,GAAkB;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC,YAAY,CAAC;QAE/C,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,SAAS,CACjB,yBAAyB,GAAG,CAAC,UAAU,sDAAsD,CAC9F,CAAC;QACJ,CAAC;QAED,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,YAAY,GAAG,OAAO,GAAG,CAAC,YAAY,CAAC;YAC7C,MAAM,UAAU,GAAG,OAAO,MAAM,CAAC;YACjC,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;gBAChC,MAAM,IAAI,SAAS,CACjB,yBAAyB,GAAG,CAAC,UAAU,6BAA6B,UAAU,eAAe,YAAY,iBAAiB,CAC3H,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,MAAW,CAAC;IACrB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,GAAG,CAAI,KAAQ,EAAE,GAAkB;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACxD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAI,GAAkB;QAChC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AA/DD,0DA+DC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "syzygy-services-rn",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Concrete I/O service implementations for the Syzygy React Native ecosystem",
   "license": "MIT",
   "main": "dist/index.js",
@@ -27,7 +27,7 @@
     "prepare": "npm run build"
   },
   "dependencies": {
-    "syzygy-foundation-rn": "^1.1.0"
+    "syzygy-foundation-rn": "^1.2.0"
   },
   "devDependencies": {
     "@react-native-community/eslint-plugin": "^1.3.0",

package/src/__tests__/deviceservices/DeviceProvider.test.ts

@@ -72,4 +72,11 @@ describe('NodeDeviceProvider', () => {
     const [id1, id2] = await Promise.all([p1.deviceId, p2.deviceId]);
     expect(id1).not.toBe(id2);
   });
+
+  it('concurrent getDeviceId calls all return same UUID', async () => {
+    const storage = new InMemoryStorageProvider();
+    const provider = new NodeDeviceProvider({ storage });
+    const results = await Promise.all(Array.from({ length: 10 }, () => provider.deviceId));
+    expect(new Set(results).size).toBe(1);
+  });
 });

package/src/__tests__/networking/RetryIntegration.test.ts

@@ -6,7 +6,13 @@
  */
 import { createNetworkRequest } from 'syzygy-foundation-rn';
 
-import { FetchNetworkClient } from '../../networking/NetworkClient';
+import {
+  BACKOFF_BASE_MS,
+  BACKOFF_CAP_MS,
+  BACKOFF_MULTIPLIER,
+  FetchNetworkClient,
+  MAX_RETRY_ATTEMPTS,
+} from '../../networking/NetworkClient';
 import type { BackoffClock } from '../../networking/NetworkClient';
 
 // ---------------------------------------------------------------------------
@@ -123,30 +129,30 @@ describe('FetchNetworkClient — retry integration', () => {
     expect(mockFetch).toHaveBeenCalledTimes(maxRetries + 1);
   });
 
-  it('exponential backoff: delay doubles each retry', async () => {
+  it('exponential backoff: delay grows with each retry (jitter range check)', async () => {
     const baseDelay = 100;
+    const capMs = 8000;
     const maxRetries = 3;
     const mockFetch = makeAlwaysFail(500);
     global.fetch = mockFetch;
 
-    // Capture retry delays by checking FetchNetworkClient formula indirectly:
-    // attempt 1 → base*2^0, attempt 2 → base*2^1, attempt 3 → base*2^2
-    const expectedDelays = [
-      baseDelay * Math.pow(2, 0),
-      baseDelay * Math.pow(2, 1),
-      baseDelay * Math.pow(2, 2),
+    // Canonical policy: delay = random(0, min(cap, base * 2^attempt))
+    // attempt 1 → [0, min(cap, base*2^0)] = [0, 100]
+    // attempt 2 → [0, min(cap, base*2^1)] = [0, 200]
+    // attempt 3 → [0, min(cap, base*2^2)] = [0, 400]
+    const expectedCaps = [
+      Math.min(capMs, baseDelay * Math.pow(2, 0)),
+      Math.min(capMs, baseDelay * Math.pow(2, 1)),
+      Math.min(capMs, baseDelay * Math.pow(2, 2)),
     ];
 
-    // Verify via the observable: stub setTimeout so retries run instantly,
-    // capture only delays in the [baseDelay..] range (exclude the per-request
-    // abort timeout which is set to timeoutSeconds * 1000 = 30000 ms).
     const capturedDelays: number[] = [];
     jest
       .spyOn(global, 'setTimeout')
       .mockImplementation(
         (fn: Parameters<typeof setTimeout>[0], ms?: number, ...args: unknown[]) => {
           const delay = ms ?? 0;
-          if (delay > 0 && delay <= baseDelay * 10) {
+          if (delay >= 0 && delay <= baseDelay * 10) {
             // Only capture retry-range delays
             capturedDelays.push(delay);
           }
@@ -156,10 +162,18 @@ describe('FetchNetworkClient — retry integration', () => {
         },
       );
 
-    const client = new FetchNetworkClient({ maxRetries, retryBaseDelayMs: baseDelay });
+    const client = new FetchNetworkClient({
+      maxRetries,
+      retryBaseDelayMs: baseDelay,
+      retryCapMs: capMs,
+    });
     await expect(client.execute(makeRequest())).rejects.toThrow();
 
-    expect(capturedDelays).toEqual(expectedDelays);
+    expect(capturedDelays).toHaveLength(maxRetries);
+    capturedDelays.forEach((delay, i) => {
+      expect(delay).toBeGreaterThanOrEqual(0);
+      expect(delay).toBeLessThanOrEqual(expectedCaps[i]);
+    });
   });
 
   it('zero maxRetries means no retry — only one attempt', async () => {
@@ -197,9 +211,10 @@ describe('FetchNetworkClient — injectable BackoffClock (deterministic backoff)
     jest.restoreAllMocks();
   });
 
-  it('injectable BackoffClock is called once per retry with correct delays', async () => {
+  it('injectable BackoffClock is called once per retry with jitter delays in expected range', async () => {
     const { backoffClock, delays } = makeInjectableSleep();
     const baseDelay = 100;
+    const capMs = 8000;
     const maxRetries = 3;
     const mockFetch = makeAlwaysFail(500);
     global.fetch = mockFetch;
@@ -207,17 +222,23 @@ describe('FetchNetworkClient — injectable BackoffClock (deterministic backoff)
     const client = new FetchNetworkClient({
       maxRetries,
       retryBaseDelayMs: baseDelay,
+      retryCapMs: capMs,
       backoffClock,
     });
     await expect(client.execute(makeRequest())).rejects.toThrow();
 
     // backoffClock called once per retry (not for the initial attempt)
     expect(delays).toHaveLength(maxRetries);
-    expect(delays).toEqual([
-      baseDelay * Math.pow(2, 0), // 100
-      baseDelay * Math.pow(2, 1), // 200
-      baseDelay * Math.pow(2, 2), // 400
-    ]);
+    // Canonical policy: delay = random(0, min(cap, base * 2^attempt))
+    const expectedCaps = [
+      Math.min(capMs, baseDelay * Math.pow(2, 0)), // [0, 100]
+      Math.min(capMs, baseDelay * Math.pow(2, 1)), // [0, 200]
+      Math.min(capMs, baseDelay * Math.pow(2, 2)), // [0, 400]
+    ];
+    delays.forEach((delay, i) => {
+      expect(delay).toBeGreaterThanOrEqual(0);
+      expect(delay).toBeLessThanOrEqual(expectedCaps[i]);
+    });
   });
 
   it('injectable BackoffClock is NOT called on first attempt (no prior failure)', async () => {
@@ -247,11 +268,13 @@ describe('FetchNetworkClient — injectable BackoffClock (deterministic backoff)
   it('injectable BackoffClock records partial delays when server recovers mid-retry', async () => {
     const { backoffClock, delays } = makeInjectableSleep();
     const baseDelay = 50;
+    const capMs = 8000;
     global.fetch = makeRecoverAfter(2);
 
     const client = new FetchNetworkClient({
       maxRetries: 3,
       retryBaseDelayMs: baseDelay,
+      retryCapMs: capMs,
       backoffClock,
     });
     const response = await client.execute(makeRequest());
@@ -259,12 +282,21 @@ describe('FetchNetworkClient — injectable BackoffClock (deterministic backoff)
     expect(response.statusCode).toBe(200);
     // 2 failures → 2 sleeps
     expect(delays).toHaveLength(2);
-    expect(delays).toEqual([baseDelay * Math.pow(2, 0), baseDelay * Math.pow(2, 1)]);
+    // Canonical policy: delay = random(0, min(cap, base * 2^attempt))
+    const expectedCaps = [
+      Math.min(capMs, baseDelay * Math.pow(2, 0)), // [0, 50]
+      Math.min(capMs, baseDelay * Math.pow(2, 1)), // [0, 100]
+    ];
+    delays.forEach((delay, i) => {
+      expect(delay).toBeGreaterThanOrEqual(0);
+      expect(delay).toBeLessThanOrEqual(expectedCaps[i]);
+    });
   });
 
   it('default BackoffClock (no injection) still works — setTimeout is used for retry delay', async () => {
     // Stub setTimeout so the test runs fast; filter for retry-range delays only.
     const baseDelay = 10;
+    const capMs = 8000;
     const capturedDelays: number[] = [];
     jest
       .spyOn(global, 'setTimeout')
@@ -272,7 +304,7 @@ describe('FetchNetworkClient — injectable BackoffClock (deterministic backoff)
         (fn: Parameters<typeof setTimeout>[0], ms?: number, ...args: unknown[]) => {
           const d = ms ?? 0;
           // Capture only the retry-range delay (not the per-request abort timeout)
-          if (d > 0 && d <= baseDelay * 10) capturedDelays.push(d);
+          if (d >= 0 && d <= baseDelay * 10) capturedDelays.push(d);
           (fn as () => void)(...(args as []));
           return 0 as unknown as ReturnType<typeof setTimeout>;
         },
@@ -282,11 +314,75 @@ describe('FetchNetworkClient — injectable BackoffClock (deterministic backoff)
     global.fetch = mockFetch;
 
     // No backoffClock injected — uses default setTimeout-backed delay
-    const client = new FetchNetworkClient({ maxRetries: 1, retryBaseDelayMs: baseDelay });
+    const client = new FetchNetworkClient({
+      maxRetries: 1,
+      retryBaseDelayMs: baseDelay,
+      retryCapMs: capMs,
+    });
     await expect(client.execute(makeRequest())).rejects.toThrow();
 
-    // 1 retry → 1 delay recorded in the retry-range
+    // 1 retry → 1 delay recorded in the retry-range (jittered: [0, min(cap, base)])
     expect(capturedDelays).toHaveLength(1);
-    expect(capturedDelays[0]).toBe(baseDelay);
+    expect(capturedDelays[0]).toBeGreaterThanOrEqual(0);
+    expect(capturedDelays[0]).toBeLessThanOrEqual(Math.min(capMs, baseDelay));
+  });
+});
+
+// ---------------------------------------------------------------------------
+// Canonical backoff policy contract assertions
+// Verifies the cross-platform backoff contract:
+//   delay = random(0, min(BACKOFF_CAP_MS, BACKOFF_BASE_MS * BACKOFF_MULTIPLIER^attempt))
+// ---------------------------------------------------------------------------
+
+describe('Canonical backoff policy — range assertions', () => {
+  afterEach(() => {
+    jest.restoreAllMocks();
+  });
+
+  it('attempt 0 (retry 1): delay in [0, 500]', async () => {
+    const { backoffClock, delays } = makeInjectableSleep();
+    global.fetch = makeAlwaysFail(500);
+    const client = new FetchNetworkClient({ maxRetries: 1, backoffClock });
+    await expect(client.execute(makeRequest())).rejects.toThrow();
+    expect(delays).toHaveLength(1);
+    expect(delays[0]).toBeGreaterThanOrEqual(0);
+    expect(delays[0]).toBeLessThanOrEqual(
+      Math.min(BACKOFF_CAP_MS, BACKOFF_BASE_MS * Math.pow(BACKOFF_MULTIPLIER, 0)),
+    );
+  });
+
+  it('attempt 1 (retry 2): delay in [0, 1000]', async () => {
+    const { backoffClock, delays } = makeInjectableSleep();
+    global.fetch = makeAlwaysFail(500);
+    const client = new FetchNetworkClient({ maxRetries: 2, backoffClock });
+    await expect(client.execute(makeRequest())).rejects.toThrow();
+    expect(delays).toHaveLength(2);
+    expect(delays[1]).toBeGreaterThanOrEqual(0);
+    expect(delays[1]).toBeLessThanOrEqual(
+      Math.min(BACKOFF_CAP_MS, BACKOFF_BASE_MS * Math.pow(BACKOFF_MULTIPLIER, 1)),
+    );
+  });
+
+  it('attempt 2 (retry 3): delay in [0, 2000]', async () => {
+    const { backoffClock, delays } = makeInjectableSleep();
+    global.fetch = makeAlwaysFail(500);
+    const client = new FetchNetworkClient({ maxRetries: MAX_RETRY_ATTEMPTS, backoffClock });
+    await expect(client.execute(makeRequest())).rejects.toThrow();
+    expect(delays.length).toBeGreaterThanOrEqual(3);
+    expect(delays[2]).toBeGreaterThanOrEqual(0);
+    expect(delays[2]).toBeLessThanOrEqual(
+      Math.min(BACKOFF_CAP_MS, BACKOFF_BASE_MS * Math.pow(BACKOFF_MULTIPLIER, 2)),
+    );
+  });
+
+  it('attempt 3 (retry 4): delay in [0, 8000] — cap applies', async () => {
+    const { backoffClock, delays } = makeInjectableSleep();
+    global.fetch = makeAlwaysFail(500);
+    const client = new FetchNetworkClient({ maxRetries: 4, backoffClock });
+    await expect(client.execute(makeRequest())).rejects.toThrow();
+    expect(delays.length).toBeGreaterThanOrEqual(4);
+    // base * 2^3 = 4000, which is < cap 8000, so cap = 8000 but actual max is 4000
+    expect(delays[3]).toBeGreaterThanOrEqual(0);
+    expect(delays[3]).toBeLessThanOrEqual(BACKOFF_CAP_MS);
   });
 });

package/src/__tests__/persistence/StorageProvider.test.ts

@@ -103,4 +103,14 @@ describe('InMemoryStorageProvider', () => {
     // No TypeError because there is no type hint to validate against
     await expect(provider.get(readKey)).resolves.toBe(42);
   });
+
+  it('concurrent reads and writes do not throw', async () => {
+    const provider = new InMemoryStorageProvider();
+    const key = createStorageKey<string>('concurrent.key');
+    const ops = [
+      ...Array.from({ length: 5 }, () => provider.set('value', key)),
+      ...Array.from({ length: 5 }, () => provider.get(key)),
+    ];
+    await expect(Promise.all(ops)).resolves.toBeDefined();
+  });
 });

package/src/deviceservices/DeviceProvider.ts

@@ -77,6 +77,7 @@ export class NodeDeviceProvider implements DeviceProvider {
   private readonly _appVersion: string;
   private readonly _isSimulator: boolean;
   private _cachedDeviceId: string | undefined;
+  private _pendingId: Promise<string> | null = null;
 
   constructor(options: NodeDeviceProviderOptions) {
     this.storage = options.storage;
@@ -92,7 +93,14 @@ export class NodeDeviceProvider implements DeviceProvider {
     if (this._cachedDeviceId !== undefined) {
       return Promise.resolve(this._cachedDeviceId);
     }
-    return this._loadOrCreateDeviceId();
+    // Return existing in-flight promise to prevent concurrent callers from
+    // each generating their own UUID before the first write completes.
+    if (this._pendingId) return this._pendingId;
+
+    this._pendingId = this._loadOrCreateDeviceId().finally(() => {
+      this._pendingId = null;
+    });
+    return this._pendingId;
   }
 
   /** Always `'rn'`. */

package/src/networking/NetworkClient.ts

@@ -67,12 +67,28 @@ export interface RequestInterceptor {
  */
 export type BackoffClock = (ms: number) => Promise<void>;
 
+// ---------------------------------------------------------------------------
+// Canonical backoff policy (all 4 platforms must match)
+// delay = random(0, min(cap, base * multiplier^attempt))
+// ---------------------------------------------------------------------------
+
+/** Base delay in milliseconds for exponential back-off. */
+export const BACKOFF_BASE_MS = 500;
+/** Multiplier applied to the base delay on each successive attempt. */
+export const BACKOFF_MULTIPLIER = 2.0;
+/** Maximum delay cap in milliseconds for any single back-off sleep. */
+export const BACKOFF_CAP_MS = 8000;
+/** Maximum number of retry attempts before giving up. */
+export const MAX_RETRY_ATTEMPTS = 3;
+
 /** Configuration options for {@link FetchNetworkClient}. */
 export interface FetchNetworkClientOptions {
-  /** Maximum number of automatic retries on server errors (5xx). Default: 3. */
+  /** Maximum number of automatic retries on server errors (5xx). Default: {@link MAX_RETRY_ATTEMPTS}. */
   maxRetries?: number;
-  /** Base delay (ms) for exponential back-off. Default: 200. */
+  /** Base delay (ms) for exponential back-off. Default: {@link BACKOFF_BASE_MS}. */
   retryBaseDelayMs?: number;
+  /** Cap (ms) for exponential back-off. Default: {@link BACKOFF_CAP_MS}. */
+  retryCapMs?: number;
   /** Interceptors applied to every request before dispatch. */
   interceptors?: RequestInterceptor[];
   /**
@@ -102,14 +118,16 @@ export interface FetchNetworkClientOptions {
 export class FetchNetworkClient implements NetworkClientProtocol {
   private readonly maxRetries: number;
   private readonly retryBaseDelayMs: number;
+  private readonly retryCapMs: number;
   private readonly interceptors: RequestInterceptor[];
   private readonly backoffClock: BackoffClock;
   private readonly logger?: LoggerProtocol;
   private _disposed = false;
 
   constructor(options: FetchNetworkClientOptions = {}) {
-    this.maxRetries = options.maxRetries ?? 3;
-    this.retryBaseDelayMs = options.retryBaseDelayMs ?? 200;
+    this.maxRetries = options.maxRetries ?? MAX_RETRY_ATTEMPTS;
+    this.retryBaseDelayMs = options.retryBaseDelayMs ?? BACKOFF_BASE_MS;
+    this.retryCapMs = options.retryCapMs ?? BACKOFF_CAP_MS;
     this.interceptors = options.interceptors ?? [];
     this.backoffClock = options.backoffClock ?? defaultBackoffClock;
     this.logger = options.logger;
@@ -164,7 +182,11 @@ export class FetchNetworkClient implements NetworkClientProtocol {
 
     for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
       if (attempt > 0) {
-        await this.backoffClock(this.retryBaseDelayMs * Math.pow(2, attempt - 1));
+        const cap = Math.min(
+          this.retryCapMs,
+          this.retryBaseDelayMs * Math.pow(BACKOFF_MULTIPLIER, attempt - 1),
+        );
+        await this.backoffClock(Math.random() * cap);
       }
       try {
         const response = await this._executeOnce(intercepted);

package/src/persistence/StorageProvider.ts

@@ -50,6 +50,10 @@ export class InMemoryStorageProvider implements StorageProvider {
   /**
    * Serialises `value` as JSON and persists it under `key`.
    *
+   * @param value - The value to store (NOTE: value comes before key —
+   *   this matches the Foundation contract. See Foundation v1.2.0
+   *   for potential API alignment.)
+   * @param key - The storage key
    * @typeParam T  The value type.
    */
   async set<T>(value: T, key: StorageKey<T>): Promise<void> {

package/syzygy.yml

@@ -5,5 +5,5 @@ platform: rn
 language: typescript
 package_manager: npm
 license: MIT
-version: 1.1.0
-syzygy_foundation: ">=1.1.0"
+version: 1.2.0
+syzygy_foundation: ">=1.2.0 <2.0.0"