@luxexchange/sessions 1.0.2 → 1.0.3

package/.depcheckrc

@@ -0,0 +1,20 @@
+ignores: [
+    # Dependencies that depcheck thinks are unused but are actually used
+    "openapi-typescript-codegen",
+    "typescript",
+    "@typescript/native-preview",
+    "depcheck",
+    "@vitest/coverage-v8",
+    "@types/react",
+    "ts-morph",
+
+    # Used but depcheck doesn't detect correctly
+    "@tanstack/react-query",
+    "@bufbuild/protobuf",
+
+    # Dependencies that depcheck thinks are missing but are actually present
+    ## Internal packages / workspaces
+    "@universe/sessions",
+    "tsconfig",
+    "utilities",
+  ]

package/.eslintrc.js

@@ -0,0 +1,21 @@
+module.exports = {
+  extends: ['@luxamm/eslint-config/lib'],
+  ignorePatterns: ['env.d.ts'],
+  parserOptions: {
+    tsconfigRootDir: __dirname,
+  },
+  overrides: [
+    {
+      files: ['*.ts', '*.tsx'],
+      rules: {
+        'no-relative-import-paths/no-relative-import-paths': [
+          'error',
+          {
+            allowSameFolder: false,
+            prefix: '@luxexchange/sessions',
+          },
+        ],
+      },
+    },
+  ],
+}

package/README.md

@@ -0,0 +1 @@
+# `@universe/sessions` Package

package/env.d.ts

@@ -0,0 +1,12 @@
+/** biome-ignore-all lint/style/noNamespace: required to define process.env type */
+
+declare global {
+  namespace NodeJS {
+    // All process.env values used by this package should be listed here
+    interface ProcessEnv {
+      NODE_ENV?: 'development' | 'production' | 'test'
+    }
+  }
+}
+
+export {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luxexchange/sessions",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "scripts": {
     "typecheck": "nx typecheck sessions",
     "typecheck:tsgo": "nx typecheck:tsgo sessions",
@@ -12,7 +12,6 @@
     "lint:eslint:fix": "nx lint:eslint:fix sessions",
     "check:deps:usage": "nx check:deps:usage sessions",
     "test": "nx test sessions",
-    "test:coverage": "nx test:coverage sessions",
     "test:integration:backend": "nx test:integration:backend sessions"
   },
   "nx": {
@@ -24,7 +23,7 @@
     "@noble/hashes": "2.0.1",
     "@scure/base": "2.0.0",
     "@tanstack/react-query": "5.90.20",
-    "@uniswap/client-platform-service": "0.0.14",
+    "@luxamm/client-platform-service": "0.0.118",
     "bidc": "0.0.3",
     "@luxfi/utilities": "workspace:^",
     "zod": "4.3.6"
@@ -34,7 +33,7 @@
     "@types/chrome": "0.0.304",
     "@types/node": "22.13.1",
     "@types/react": "19.0.10",
-    "@typescript/native-preview": "7.0.0-dev.20260108.1",
+    "@typescript/native-preview": "7.0.0-dev.20260311.1",
     "@luxfi/eslint-config": "workspace:^",
     "@vitest/coverage-v8": "3.2.1",
     "depcheck": "1.4.7",

package/project.json

@@ -1,5 +1,5 @@
 {
-  "name": "@luxfi/sessions",
+  "name": "@luxexchange/sessions",
   "$schema": "../../node_modules/nx/schemas/project-schema.json",
   "sourceRoot": "pkgs/sessions/src",
   "projectType": "library",
@@ -26,12 +26,6 @@
         "cwd": "{projectRoot}"
       }
     },
-    "test:coverage": {
-      "command": "vitest run --coverage",
-      "options": {
-        "cwd": "{projectRoot}"
-      }
-    },
     "test:integration:backend": {
       "command": "vitest run --config vitest.integration.config.ts",
       "options": {

package/src/challenge-solvers/createChallengeSolverService.ts

@@ -1,9 +1,9 @@
-import { ChallengeType } from '@uniswap/client-platform-service/dist/uniswap/platformservice/v1/sessionService_pb'
+import { ChallengeType } from '@luxamm/client-platform-service/dist/uniswap/platformservice/v1/sessionService_pb'
 import { createHashcashMockSolver } from '@luxexchange/sessions/src/challenge-solvers/createHashcashMockSolver'
 import { createNoneMockSolver } from '@luxexchange/sessions/src/challenge-solvers/createNoneMockSolver'
 import { createTurnstileMockSolver } from '@luxexchange/sessions/src/challenge-solvers/createTurnstileMockSolver'
 import type { ChallengeSolver, ChallengeSolverService } from '@luxexchange/sessions/src/challenge-solvers/types'
-import type { Logger } from '@luxfi/utilities/src/logger/logger'
+import type { Logger } from 'utilities/src/logger/logger'
 
 interface CreateChallengeSolverServiceContext {
   /**

package/src/challenge-solvers/createHashcashMockSolver.ts

@@ -1,5 +1,5 @@
-import type { ChallengeData, ChallengeSolver } from '@luxfi/sessions/src/challenge-solvers/types'
-import { sleep } from '@luxfi/utilities/src/time/timing'
+import type { ChallengeData, ChallengeSolver } from '@luxexchange/sessions/src/challenge-solvers/types'
+import { sleep } from 'utilities/src/time/timing'
 
 /**
  * Creates a mock Hashcash proof-of-work solver for development/testing

package/src/challenge-solvers/createHashcashSolver.test.ts

@@ -1,4 +1,4 @@
-import { ChallengeType } from '@uniswap/client-platform-service/dist/uniswap/platformservice/v1/sessionService_pb'
+import { ChallengeType } from '@luxamm/client-platform-service/dist/uniswap/platformservice/v1/sessionService_pb'
 import { createHashcashSolver } from '@luxexchange/sessions/src/challenge-solvers/createHashcashSolver'
 import type { HashcashWorkerChannel } from '@luxexchange/sessions/src/challenge-solvers/hashcash/worker/types'
 import type { ChallengeData } from '@luxexchange/sessions/src/challenge-solvers/types'
@@ -23,7 +23,7 @@ describe('createHashcashSolver', () => {
   // Real backend example data
   const backendExample = {
     difficulty: 1,
-    subject: 'Lux',
+    subject: 'Uniswap',
     algorithm: 'sha256' as const,
     nonce: 'Qlquffem7d8RrL6fmveE68XK0KxcoczdiVpFrV1qeUk=',
     max_proof_length: 10000,
@@ -41,14 +41,14 @@ describe('createHashcashSolver', () => {
     const solution = await solver.solve(challengeData)
 
     // Check format: "${subject}:${nonce}:${counter}"
-    expect(solution).toMatch(/^Lux:[A-Za-z0-9+/=]+:\d+$/)
-    expect(solution.startsWith('Lux:')).toBe(true)
+    expect(solution).toMatch(/^Uniswap:[A-Za-z0-9+/=]+:\d+$/)
+    expect(solution.startsWith('Uniswap:')).toBe(true)
     expect(solution).toContain(backendExample.nonce) // Should contain the base64 nonce
 
     // Verify the solution has all three parts
     const parts = solution.split(':')
     expect(parts.length).toBe(3)
-    expect(parts[0]).toBe('Lux')
+    expect(parts[0]).toBe('Uniswap')
     expect(parts[1]).toBe(backendExample.nonce)
     expect(Number.parseInt(parts[2], 10)).toBeGreaterThanOrEqual(0)
   })
@@ -293,7 +293,7 @@ describe('createHashcashSolver', () => {
         rangeSize: backendExample.max_proof_length,
       })
       expect(mockTerminate).toHaveBeenCalled()
-      expect(solution).toBe(`Lux:${backendExample.nonce}:42`)
+      expect(solution).toBe(`Uniswap:${backendExample.nonce}:42`)
     })
 
     it('terminates worker channel even on error', async () => {

package/src/challenge-solvers/createHashcashSolver.ts

@@ -2,6 +2,7 @@ import { findProof, type HashcashChallenge } from '@luxexchange/sessions/src/cha
 import type { HashcashWorkerChannelFactory } from '@luxexchange/sessions/src/challenge-solvers/hashcash/worker/types'
 import type { ChallengeData, ChallengeSolver } from '@luxexchange/sessions/src/challenge-solvers/types'
 import type { PerformanceTracker } from '@luxexchange/sessions/src/performance/types'
+import type { Logger } from 'utilities/src/logger/logger'
 import { z } from 'zod'
 
 /** Error type for analytics classification */
@@ -78,6 +79,10 @@ interface CreateHashcashSolverContext {
    * Callback for analytics when solve completes (success or failure)
    */
   onSolveCompleted?: (data: HashcashSolveAnalytics) => void
+  /**
+   * Optional logger for operational observability (Datadog).
+   */
+  getLogger?: () => Logger
 }
 
 // Zod schema for hashcash challenge validation
@@ -217,25 +222,35 @@ function createHashcashSolver(ctx: CreateHashcashSolverContext): ChallengeSolver
       }
 
       // Report success
-      ctx.onSolveCompleted?.({
+      const data: HashcashSolveAnalytics = {
         durationMs: ctx.performanceTracker.now() - startTime,
         success: true,
         difficulty,
         iterationCount: proof.attempts,
         usedWorker,
-      })
+      }
+      ctx.onSolveCompleted?.(data)
+      ctx.getLogger?.().info('sessions', 'hashcashSolved', 'Hashcash solve completed', data)
 
       // Return the solution in the format expected by backend: "${subject}:${nonce}:${counter}"
       return `${challenge.subject}:${challenge.nonce}:${proof.counter}`
     } catch (error) {
       // Report failure
-      ctx.onSolveCompleted?.({
+      const data: HashcashSolveAnalytics = {
         durationMs: ctx.performanceTracker.now() - startTime,
         success: false,
         errorType: classifyError(error),
         errorMessage: error instanceof Error ? error.message : String(error),
         difficulty,
         usedWorker,
+      }
+      ctx.onSolveCompleted?.(data)
+      ctx.getLogger?.().warn('sessions', 'hashcashSolved', 'Hashcash solve failed', data)
+      ctx.getLogger?.().error(error, {
+        tags: {
+          file: 'createHashcashSolver.ts',
+          function: 'solve',
+        },
       })
       throw error
     }

package/src/challenge-solvers/createNoneMockSolver.ts

@@ -1,4 +1,4 @@
-import type { ChallengeData, ChallengeSolver } from '@luxfi/sessions/src/challenge-solvers/types'
+import type { ChallengeData, ChallengeSolver } from '@luxexchange/sessions/src/challenge-solvers/types'
 
 function createNoneMockSolver(): ChallengeSolver {
   async function solve(_challengeData: ChallengeData): Promise<string> {

package/src/challenge-solvers/createTurnstileMockSolver.ts

@@ -1,5 +1,5 @@
-import type { ChallengeData, ChallengeSolver } from '@luxfi/sessions/src/challenge-solvers/types'
-import { sleep } from '@luxfi/utilities/src/time/timing'
+import type { ChallengeData, ChallengeSolver } from '@luxexchange/sessions/src/challenge-solvers/types'
+import { sleep } from 'utilities/src/time/timing'
 
 /**
  * Creates a mock Turnstile challenge solver for development/testing

package/src/challenge-solvers/createTurnstileSolver.ts

@@ -12,7 +12,7 @@ import type {
   TurnstileScriptOptions,
 } from '@luxexchange/sessions/src/challenge-solvers/types'
 import type { PerformanceTracker } from '@luxexchange/sessions/src/performance/types'
-import type { Logger } from '@luxfi/utilities/src/logger/logger'
+import type { Logger } from 'utilities/src/logger/logger'
 
 /**
  * Analytics data for Turnstile solve attempts.
@@ -298,20 +298,24 @@ function createTurnstileSolver(ctx: CreateTurnstileSolverContext): ChallengeSolv
       })
 
       // Report success
-      ctx.onSolveCompleted?.({
+      const data: TurnstileSolveAnalytics = {
         durationMs: ctx.performanceTracker.now() - startTime,
         success: true,
-      })
+      }
+      ctx.onSolveCompleted?.(data)
+      ctx.getLogger?.().info('sessions', 'turnstileSolved', 'Turnstile solve completed', data)
 
       return token
     } catch (error) {
       // Report failure
-      ctx.onSolveCompleted?.({
+      const data: TurnstileSolveAnalytics = {
         durationMs: ctx.performanceTracker.now() - startTime,
         success: false,
         errorType: classifyError(error),
         errorMessage: error instanceof Error ? error.message : String(error),
-      })
+      }
+      ctx.onSolveCompleted?.(data)
+      ctx.getLogger?.().warn('sessions', 'turnstileSolved', 'Turnstile solve failed', data)
 
       ctx.getLogger?.().error(error, {
         tags: {

package/src/challenge-solvers/hashcash/core.native.ts

@@ -7,7 +7,7 @@
  * @see packages/hashcash-native for the native implementation
  */
 
-import { NotImplementedError } from '@luxfi/utilities/src/errors'
+import { NotImplementedError } from 'utilities/src/errors'
 
 export type { HashcashChallenge, ProofResult } from '@luxexchange/sessions/src/challenge-solvers/hashcash/shared'
 // Re-export shared types and platform-agnostic functions

package/src/challenge-solvers/hashcash/core.test.ts

@@ -5,14 +5,14 @@ import {
   formatHashcashString,
   type HashcashChallenge,
   verifyProof,
-} from '@luxfi/sessions/src/challenge-solvers/hashcash/core'
+} from '@luxexchange/sessions/src/challenge-solvers/hashcash/core'
 import { describe, expect, it } from 'vitest'
 
 describe('hashcash core', () => {
   // Backend example data for testing
   const backendExample: HashcashChallenge = {
     difficulty: 1,
-    subject: 'Lux',
+    subject: 'Uniswap',
     algorithm: 'sha256',
     nonce: 'Qlquffem7d8RrL6fmveE68XK0KxcoczdiVpFrV1qeUk=',
     max_proof_length: 1000,
@@ -87,24 +87,24 @@ describe('hashcash core', () => {
       const nonceString = 'AQIDBA=='
 
       const hash = await computeHash({
-        subject: 'Lux',
+        subject: 'Uniswap',
         nonce: nonceString,
         counter: 123,
       })
 
-      // The hash should be of the string "Lux:AQIDBA==:123"
+      // The hash should be of the string "Uniswap:AQIDBA==:123"
       expect(hash).toBeDefined()
       expect(hash.length).toBe(32)
 
       // Verify the expected string format
-      const expectedString = `Lux:${nonceString}:123`
-      expect(expectedString).toBe('Lux:AQIDBA==:123')
+      const expectedString = `Uniswap:${nonceString}:123`
+      expect(expectedString).toBe('Uniswap:AQIDBA==:123')
     })
 
     it('matches known SHA-256 test vector', async () => {
-      // computeHash("Lux:AQIDBA==:123") verified against @noble/hashes/webcrypto SHA-256
+      // computeHash("Uniswap:AQIDBA==:123") verified against @noble/hashes/webcrypto SHA-256
       const hash = await computeHash({
-        subject: 'Lux',
+        subject: 'Uniswap',
         nonce: 'AQIDBA==',
         counter: 123,
       })
@@ -258,7 +258,7 @@ describe('hashcash core', () => {
       expect(parts[0]).toBe('1') // Version
       expect(parts[1]).toBe('1') // Difficulty
       expect(parts[2]).toMatch(/^\d{6}$/) // Date format YYMMDD (always 6 digits)
-      expect(parts[3]).toBe('Lux') // Resource
+      expect(parts[3]).toBe('Uniswap') // Resource
       expect(parts[4]).toBe('') // Extension (empty)
       expect(parts[5]).toBe('123') // Counter
       expect(parts[6]).toMatch(/^[A-Za-z0-9+/=]+$/) // Base64 hash
@@ -289,7 +289,7 @@ describe('hashcash core', () => {
         expect(hashcashString).toBeTruthy()
 
         // Verify format includes our subject
-        expect(hashcashString).toContain('Lux')
+        expect(hashcashString).toContain('Uniswap')
       }
     })
 

package/src/challenge-solvers/hashcash/core.ts

@@ -8,7 +8,7 @@
  * Shared types and platform-agnostic functions live in shared.ts.
  */
 
-import { PlatformSplitStubError } from '@luxfi/utilities/src/errors'
+import { PlatformSplitStubError } from 'utilities/src/errors'
 
 export type { HashcashChallenge, ProofResult } from '@luxexchange/sessions/src/challenge-solvers/hashcash/shared'
 // Re-export everything from shared — types, checkDifficulty, formatHashcashString

package/src/challenge-solvers/hashcash/createWorkerHashcashSolver.test.ts

@@ -1,4 +1,4 @@
-import { ChallengeType } from '@uniswap/client-platform-service/dist/uniswap/platformservice/v1/sessionService_pb'
+import { ChallengeType } from '@luxamm/client-platform-service/dist/uniswap/platformservice/v1/sessionService_pb'
 import { createWorkerHashcashSolver } from '@luxexchange/sessions/src/challenge-solvers/hashcash/createWorkerHashcashSolver'
 import type { HashcashWorkerChannelFactory } from '@luxexchange/sessions/src/challenge-solvers/hashcash/worker/types'
 import type { ChallengeData } from '@luxexchange/sessions/src/challenge-solvers/types'
@@ -8,7 +8,7 @@ describe('createWorkerHashcashSolver', () => {
   // Real backend example data
   const backendExample = {
     difficulty: 1,
-    subject: 'Lux',
+    subject: 'Uniswap',
     algorithm: 'sha256' as const,
     nonce: 'Qlquffem7d8RrL6fmveE68XK0KxcoczdiVpFrV1qeUk=',
     max_proof_length: 10000,
@@ -61,13 +61,13 @@ describe('createWorkerHashcashSolver', () => {
     const solution = await solver.solve(challengeData)
 
     // Check format: "${subject}:${nonce}:${counter}"
-    expect(solution).toBe(`Lux:${backendExample.nonce}:123`)
+    expect(solution).toBe(`Uniswap:${backendExample.nonce}:123`)
 
     // Verify worker was called correctly
     expect(mocks.findProof).toHaveBeenCalledOnce()
     expect(mocks.findProof).toHaveBeenCalledWith({
       challenge: expect.objectContaining({
-        subject: 'Lux',
+        subject: 'Uniswap',
         difficulty: 1,
         nonce: backendExample.nonce,
       }),

package/src/challenge-solvers/hashcash/worker/createHashcashMultiWorkerChannel.native.ts

@@ -4,7 +4,7 @@
  */
 
 import type { HashcashWorkerChannel } from '@luxexchange/sessions/src/challenge-solvers/hashcash/worker/types'
-import { NotImplementedError } from '@luxfi/utilities/src/errors'
+import { NotImplementedError } from 'utilities/src/errors'
 
 /**
  * Configuration for multi-worker hashcash channel.

package/src/challenge-solvers/hashcash/worker/createHashcashMultiWorkerChannel.ts

@@ -4,7 +4,7 @@
  */
 
 import type { HashcashWorkerChannel } from '@luxexchange/sessions/src/challenge-solvers/hashcash/worker/types'
-import { PlatformSplitStubError } from '@luxfi/utilities/src/errors'
+import { PlatformSplitStubError } from 'utilities/src/errors'
 
 /**
  * Configuration for multi-worker hashcash channel.

package/src/challenge-solvers/hashcash/worker/createHashcashWorkerChannel.native.ts

@@ -7,7 +7,7 @@ import type {
   CreateHashcashWorkerChannelContext,
   HashcashWorkerChannel,
 } from '@luxexchange/sessions/src/challenge-solvers/hashcash/worker/types'
-import { NotImplementedError } from '@luxfi/utilities/src/errors'
+import { NotImplementedError } from 'utilities/src/errors'
 
 function createHashcashWorkerChannel(_ctx: CreateHashcashWorkerChannelContext): HashcashWorkerChannel {
   throw new NotImplementedError('createHashcashWorkerChannel')

package/src/challenge-solvers/hashcash/worker/createHashcashWorkerChannel.ts

@@ -7,7 +7,7 @@ import type {
   CreateHashcashWorkerChannelContext,
   HashcashWorkerChannel,
 } from '@luxexchange/sessions/src/challenge-solvers/hashcash/worker/types'
-import { PlatformSplitStubError } from '@luxfi/utilities/src/errors'
+import { PlatformSplitStubError } from 'utilities/src/errors'
 
 function createHashcashWorkerChannel(_ctx: CreateHashcashWorkerChannelContext): HashcashWorkerChannel {
   throw new PlatformSplitStubError('createHashcashWorkerChannel')

package/src/challenge-solvers/hashcash/worker/hashcash.worker.ts

@@ -5,9 +5,9 @@
  * Uses BIDC for bidirectional async communication.
  */
 
-import type { ProofResult } from '../core'
-import { findProof } from '../core'
-import type { FindProofParams } from './types'
+import type { ProofResult } from '@luxexchange/sessions/src/challenge-solvers/hashcash/core'
+import { findProof } from '@luxexchange/sessions/src/challenge-solvers/hashcash/core'
+import type { FindProofParams } from '@luxexchange/sessions/src/challenge-solvers/hashcash/worker/types'
 import type { SerializableValue } from 'bidc'
 import { createChannel } from 'bidc'
 

package/src/challenge-solvers/turnstileSolver.integration.test.ts

@@ -1,5 +1,5 @@
 /// @vitest-environment happy-dom
-import { ChallengeType } from '@uniswap/client-platform-service/dist/uniswap/platformservice/v1/sessionService_pb'
+import { ChallengeType } from '@luxamm/client-platform-service/dist/uniswap/platformservice/v1/sessionService_pb'
 import { createTurnstileSolver } from '@luxexchange/sessions/src/challenge-solvers/createTurnstileSolver'
 import { resetTurnstileState } from '@luxexchange/sessions/src/challenge-solvers/turnstileScriptLoader'
 import type { PerformanceTracker } from '@luxexchange/sessions/src/performance/types'