@sogni-ai/expo-client 1.0.0-alpha.2

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# [1.0.0-alpha.2](https://github.com/Sogni-AI/expo-client/compare/v1.0.0-alpha.1...v1.0.0-alpha.2) (2026-05-12)
+
+
+### Features
+
+* add WebSocket client and AccountApi ([b58b3ae](https://github.com/Sogni-AI/expo-client/commit/b58b3aed2fe55a27e3f01bee8c6df1e0e186af58))
+
+# 1.0.0-alpha.1 (2026-05-12)
+
+
+### Features
+
+* add authentication, REST client, and core lib utilities ([23053b5](https://github.com/Sogni-AI/expo-client/commit/23053b52430122bf04a812aef8cf25e7c01a73dd))

package/README.md

@@ -0,0 +1,87 @@
+# @sogni-ai/expo-client
+
+Expo / React Native SDK for the [Sogni Supernet](https://sogni.ai) — AI image, video & audio generation plus LLM chat over WebSocket.
+
+> **Status:** Early development. Public API is unstable until 1.0. Published to npm under the `alpha` dist-tag.
+
+## Install
+
+```bash
+npx expo install @sogni-ai/expo-client@alpha expo-secure-store expo-standard-web-crypto
+```
+
+## Setup
+
+Add the Web Crypto polyfill at your app entry point (e.g. `app/_layout.tsx` for Expo Router or `App.tsx` for classic Expo):
+
+```ts
+import 'expo-standard-web-crypto/polyfill';
+```
+
+This is required for cryptographic operations used by authentication and (optionally) wallet-based signup.
+
+## Usage
+
+### Create a client with an API key
+
+```ts
+import { SogniClient } from '@sogni-ai/expo-client';
+
+const sogni = await SogniClient.create({
+  appId: 'my-app',
+  apiKey: 'sk_...'
+});
+
+// Authenticated — fetch profile
+const me = await sogni.account.me();
+
+// Subscribe to account state changes (balance, network, etc.)
+const unsubscribe = sogni.account.onChange((snapshot) => {
+  console.log(snapshot);
+});
+```
+
+### Token-based session (auto-restored from secure storage)
+
+```ts
+const sogni = await SogniClient.create({ appId: 'my-app' });
+
+if (sogni.isAuthenticated) {
+  // Tokens were restored from previous session
+  await sogni.account.me();
+}
+```
+
+`login()` / `signup()` flows that derive a wallet from username + password are coming in a later release.
+
+## Account snapshot shape
+
+```ts
+interface AccountSnapshot {
+  authenticated: boolean;
+  networkStatus: 'connected' | 'disconnected' | 'connecting';
+  network: 'fast' | 'relaxed' | null;
+  balance: Balances;
+  walletAddress: string | null;
+  username: string | null;
+  email: string | null;
+}
+```
+
+Snapshots are plain data — drop them straight into Redux/Zustand/MMKV without conversion.
+
+## Imports
+
+| Path | Purpose |
+| --- | --- |
+| `@sogni-ai/expo-client` | Main SDK |
+| `@sogni-ai/expo-client/wallet` | Wallet creation & EIP-712 signing (tree-shakable; only pulled in if you use it) |
+
+## Requirements
+
+- Expo SDK 50 or newer
+- React Native 0.73 or newer
+
+## License
+
+ISC

package/dist/cjs/Account/index.d.ts

@@ -0,0 +1,39 @@
+import ApiClient from '../ApiClient';
+import TypedEventEmitter from '../lib/TypedEventEmitter';
+import { AccountSnapshot, Balances, MeData } from './types';
+interface AccountEvents {
+    change: AccountSnapshot;
+}
+/**
+ * Account API: current-user info, balance, logout.
+ *
+ * Phase 2 surface — `login()` and `signup()` are deferred to Phase 4
+ * because they require deterministic wallet derivation (Phase 4 wallet
+ * helper). For Phase 2, authenticate via API key in `SogniClient.create()`
+ * or pre-obtained tokens via `sogni.setTokens(...)`.
+ */
+declare class AccountApi extends TypedEventEmitter<AccountEvents> {
+    private _client;
+    private _snapshot;
+    constructor(client: ApiClient);
+    /** Read-only snapshot of the current account state. */
+    get current(): Readonly<AccountSnapshot>;
+    /** Subscribe to account state changes. Returns an unsubscribe function. */
+    onChange(listener: (snapshot: AccountSnapshot) => void): () => void;
+    /** Fetch the current user's profile data from REST. Updates the snapshot. */
+    me(): Promise<MeData>;
+    /**
+     * Force-refresh the current user's balance from REST. Balance also updates
+     * automatically via socket events — call this only when you need a synchronous
+     * fetch (e.g., on screen mount before the socket has reconnected).
+     */
+    refreshBalance(): Promise<Balances>;
+    /**
+     * Log out and clear all auth state. Closes the WebSocket and removes any
+     * persisted tokens. Safe to call even if not authenticated.
+     */
+    logout(): Promise<void>;
+    private _update;
+}
+export default AccountApi;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/Account/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Account/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAoC,MAAM,cAAc,CAAC;AAChE,OAAO,iBAAiB,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAwB,MAAM,SAAS,CAAC;AAElF,UAAU,aAAa;IACrB,MAAM,EAAE,eAAe,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,cAAM,UAAW,SAAQ,iBAAiB,CAAC,aAAa,CAAC;IACvD,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,SAAS,CAAkB;gBAEvB,MAAM,EAAE,SAAS;IAgC7B,uDAAuD;IACvD,IAAI,OAAO,IAAI,QAAQ,CAAC,eAAe,CAAC,CAEvC;IAED,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI;IAInE,6EAA6E;IACvE,EAAE,IAAI,OAAO,CAAC,MAAM,CAAC;IAU3B;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,QAAQ,CAAC;IAMzC;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAa7B,OAAO,CAAC,OAAO;CAMhB;AAUD,eAAe,UAAU,CAAC"}

package/dist/cjs/Account/index.js

@@ -0,0 +1,111 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const ApiClient_1 = require("../ApiClient");
+const TypedEventEmitter_1 = __importDefault(require("../lib/TypedEventEmitter"));
+const types_1 = require("./types");
+/**
+ * Account API: current-user info, balance, logout.
+ *
+ * Phase 2 surface — `login()` and `signup()` are deferred to Phase 4
+ * because they require deterministic wallet derivation (Phase 4 wallet
+ * helper). For Phase 2, authenticate via API key in `SogniClient.create()`
+ * or pre-obtained tokens via `sogni.setTokens(...)`.
+ */
+class AccountApi extends TypedEventEmitter_1.default {
+    constructor(client) {
+        super();
+        this._client = client;
+        this._snapshot = (0, types_1.emptyAccountSnapshot)();
+        client.socket.on('connected', ({ network }) => {
+            this._update({ networkStatus: 'connected', network });
+        });
+        client.socket.on('disconnected', () => {
+            this._update({ networkStatus: 'disconnected', network: null });
+        });
+        client.socket.on('authenticated', (e) => {
+            this._update({
+                authenticated: true,
+                username: e.username,
+                walletAddress: e.walletAddress,
+                balance: e.balance
+            });
+        });
+        client.socket.on('balanceUpdate', (e) => {
+            this._update({ balance: e.balance });
+        });
+        client.socket.on('changeNetwork', (e) => {
+            this._update({ network: e.network });
+        });
+        client.on('authUpdated', (authenticated) => {
+            if (!authenticated) {
+                this._update((0, types_1.emptyAccountSnapshot)());
+            }
+        });
+    }
+    /** Read-only snapshot of the current account state. */
+    get current() {
+        return this._snapshot;
+    }
+    /** Subscribe to account state changes. Returns an unsubscribe function. */
+    onChange(listener) {
+        return this.on('change', listener);
+    }
+    /** Fetch the current user's profile data from REST. Updates the snapshot. */
+    async me() {
+        const res = await this._client.rest.get('/v1/account/me');
+        this._update({
+            username: res.data.username,
+            email: res.data.currentEmail,
+            walletAddress: res.data.walletAddress
+        });
+        return res.data;
+    }
+    /**
+     * Force-refresh the current user's balance from REST. Balance also updates
+     * automatically via socket events — call this only when you need a synchronous
+     * fetch (e.g., on screen mount before the socket has reconnected).
+     */
+    async refreshBalance() {
+        const res = await this._client.rest.get('/v4/account/balance');
+        this._update({ balance: res.data });
+        return res.data;
+    }
+    /**
+     * Log out and clear all auth state. Closes the WebSocket and removes any
+     * persisted tokens. Safe to call even if not authenticated.
+     */
+    async logout() {
+        try {
+            await this._client.rest.post('/v1/account/logout');
+        }
+        catch (e) {
+            if (e instanceof ApiClient_1.ApiError && e.status === 401) {
+                this._client.logger.warn('Logout call rejected — probably already logged out');
+            }
+            else {
+                throw e;
+            }
+        }
+        this._client.auth.clear();
+    }
+    _update(partial) {
+        const next = { ...this._snapshot, ...partial };
+        if (shallowEqual(next, this._snapshot))
+            return;
+        this._snapshot = next;
+        this.emit('change', this._snapshot);
+    }
+}
+function shallowEqual(a, b) {
+    const keys = Object.keys(a);
+    for (const k of keys) {
+        if (a[k] !== b[k])
+            return false;
+    }
+    return true;
+}
+exports.default = AccountApi;
+//# sourceMappingURL=index.js.map

package/dist/cjs/Account/index.js.map

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

package/dist/cjs/Account/types.d.ts

@@ -0,0 +1,25 @@
+import { Balances } from '../ApiClient/WebSocketClient/events';
+import { SupernetType } from '../ApiClient/WebSocketClient/types';
+export type { Balances };
+export interface MeData {
+    currentEmail: string;
+    username: string;
+    walletAddress: string;
+    emailVerified?: boolean;
+    discord2FA?: boolean;
+    discordLinked?: boolean;
+    discordServerMember?: boolean;
+    discordUsername?: string;
+    requestedUpdatedEmail?: string;
+}
+export interface AccountSnapshot {
+    authenticated: boolean;
+    networkStatus: 'connected' | 'disconnected' | 'connecting';
+    network: SupernetType | null;
+    balance: Balances;
+    walletAddress: string | null;
+    username: string | null;
+    email: string | null;
+}
+export declare function emptyAccountSnapshot(): AccountSnapshot;
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/Account/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/Account/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB,MAAM,WAAW,MAAM;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,WAAW,GAAG,cAAc,GAAG,YAAY,CAAC;IAC3D,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,QAAQ,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,oBAAoB,IAAI,eAAe,CAatD"}

package/dist/cjs/Account/types.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emptyAccountSnapshot = emptyAccountSnapshot;
+function emptyAccountSnapshot() {
+    return {
+        authenticated: false,
+        networkStatus: 'disconnected',
+        network: null,
+        balance: {
+            sogni: { settled: '0', credit: '0', debit: '0', net: '0' },
+            spark: { settled: '0', credit: '0', debit: '0', net: '0', premiumCredit: '0' }
+        },
+        walletAddress: null,
+        username: null,
+        email: null
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/cjs/Account/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/Account/types.ts"],"names":[],"mappings":";;AA2BA,oDAaC;AAbD,SAAgB,oBAAoB;IAClC,OAAO;QACL,aAAa,EAAE,KAAK;QACpB,aAAa,EAAE,cAAc;QAC7B,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACP,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;YAC1D,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE;SAC/E;QACD,aAAa,EAAE,IAAI;QACnB,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,IAAI;KACZ,CAAC;AACJ,CAAC"}

package/dist/cjs/ApiClient/WebSocketClient/events.d.ts

@@ -0,0 +1,51 @@
+import { SupernetType } from './types';
+export interface BalanceData {
+    settled: string;
+    credit: string;
+    debit: string;
+    net: string;
+}
+export interface SparkBalanceData extends BalanceData {
+    premiumCredit: string;
+}
+export interface Balances {
+    sogni: BalanceData;
+    spark: SparkBalanceData;
+}
+export interface AuthenticatedEvent {
+    username: string;
+    walletAddress: string;
+    balance: Balances;
+    isMainnet: boolean;
+    accountWasMigrated: boolean;
+    hasUnclaimedAirdrop: boolean;
+    firstLoginAfterMigration: boolean;
+}
+export interface BalanceUpdateEvent {
+    balance: Balances;
+}
+export interface ChangeNetworkEvent {
+    network: SupernetType;
+}
+export interface ConnectedEvent {
+    network: SupernetType;
+}
+export interface DisconnectedEvent {
+    code?: number;
+    reason?: string;
+}
+export interface ToastMessageEvent {
+    level: 'info' | 'success' | 'warning' | 'error';
+    message: string;
+    stickyID?: string;
+}
+/** Public event map for WebSocketClient. */
+export interface SocketEventMap {
+    connected: ConnectedEvent;
+    disconnected: DisconnectedEvent;
+    authenticated: AuthenticatedEvent;
+    balanceUpdate: BalanceUpdateEvent;
+    changeNetwork: ChangeNetworkEvent;
+    toastMessage: ToastMessageEvent;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/cjs/ApiClient/WebSocketClient/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/ApiClient/WebSocketClient/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,QAAQ,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,wBAAwB,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,cAAc,CAAC;IAC1B,YAAY,EAAE,iBAAiB,CAAC;IAChC,aAAa,EAAE,kBAAkB,CAAC;IAClC,aAAa,EAAE,kBAAkB,CAAC;IAClC,aAAa,EAAE,kBAAkB,CAAC;IAClC,YAAY,EAAE,iBAAiB,CAAC;CACjC"}

package/dist/cjs/ApiClient/WebSocketClient/events.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=events.js.map

package/dist/cjs/ApiClient/WebSocketClient/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../../src/ApiClient/WebSocketClient/events.ts"],"names":[],"mappings":""}

package/dist/cjs/ApiClient/WebSocketClient/index.d.ts

@@ -0,0 +1,34 @@
+import TypedEventEmitter from '../../lib/TypedEventEmitter';
+import { Logger } from '../../lib/DefaultLogger';
+import { AuthManager } from '../../lib/AuthManager';
+import { ConnectionStatus, SupernetType } from './types';
+import { SocketEventMap } from './events';
+declare class WebSocketClient extends TypedEventEmitter<SocketEventMap> {
+    readonly appId: string;
+    readonly appSource?: string;
+    readonly baseUrl: string;
+    protected _logger: Logger;
+    private _auth;
+    private _supernetType;
+    private socket;
+    private _status;
+    private _reconnectAttempts;
+    private _wantConnected;
+    constructor(baseUrl: string, auth: AuthManager, appId: string, supernetType: SupernetType, logger: Logger, appSource?: string);
+    get supernetType(): SupernetType;
+    get isConnected(): boolean;
+    get status(): ConnectionStatus;
+    connect(): Promise<void>;
+    disconnect(): void;
+    switchNetwork(target: SupernetType): Promise<SupernetType>;
+    send(messageType: string, data: unknown): Promise<void>;
+    private _handleOpen;
+    private _handleClose;
+    private _handleError;
+    private _scheduleReconnect;
+    private _cleanupSocket;
+    private _handleMessage;
+    private _dispatch;
+}
+export default WebSocketClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/ApiClient/WebSocketClient/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ApiClient/WebSocketClient/index.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAqB1C,cAAM,eAAgB,SAAQ,iBAAiB,CAAC,cAAc,CAAC;IAC7D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,cAAc,CAAS;gBAG7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM;IAWpB,IAAI,YAAY,IAAI,YAAY,CAE/B;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,MAAM,IAAI,gBAAgB,CAE7B;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC9B,UAAU,IAAI,IAAI;IAcZ,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAU1D,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7D,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,SAAS;CAoBlB;AASD,eAAe,eAAe,CAAC"}

package/dist/cjs/ApiClient/WebSocketClient/index.js

@@ -0,0 +1,183 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const TypedEventEmitter_1 = __importDefault(require("../../lib/TypedEventEmitter"));
+const base64_1 = require("../../lib/base64");
+const version_1 = require("../../version");
+const normalize_1 = require("./normalize");
+const PROTOCOL_VERSION = '3.0.0';
+const RECONNECT_DELAY_MS = 1000;
+const MAX_RECONNECT_ATTEMPTS = 5;
+class WebSocketClient extends TypedEventEmitter_1.default {
+    constructor(baseUrl, auth, appId, supernetType, logger, appSource) {
+        super();
+        this.socket = null;
+        this._status = 'disconnected';
+        this._reconnectAttempts = 0;
+        this._wantConnected = false;
+        this.baseUrl = normalizeBaseUrl(baseUrl);
+        this._auth = auth;
+        this.appId = appId;
+        this.appSource = appSource?.trim() || undefined;
+        this._supernetType = supernetType;
+        this._logger = logger;
+    }
+    get supernetType() {
+        return this._supernetType;
+    }
+    get isConnected() {
+        return this._status === 'connected';
+    }
+    get status() {
+        return this._status;
+    }
+    async connect() {
+        this._wantConnected = true;
+        if (this.socket) {
+            this._cleanupSocket();
+        }
+        this._status = 'connecting';
+        const userAgent = `Sogni/${PROTOCOL_VERSION} (sogni-expo-client) ${version_1.LIB_VERSION}`;
+        const url = new URL(this.baseUrl);
+        url.protocol = url.protocol === 'https:' || url.protocol === 'wss:' ? 'wss:' : 'ws:';
+        url.searchParams.set('appId', this.appId);
+        if (this.appSource)
+            url.searchParams.set('appSource', this.appSource);
+        url.searchParams.set('clientName', userAgent);
+        url.searchParams.set('clientType', 'artist');
+        url.searchParams.set('forceWorkerId', this._supernetType === 'fast' ? 'fast' : '');
+        const auth = await this._auth.socketAuth();
+        if (auth.queryParams) {
+            for (const [k, v] of Object.entries(auth.queryParams)) {
+                url.searchParams.set(k, v);
+            }
+        }
+        const options = auth.headers ? { headers: auth.headers } : undefined;
+        const Ctor = globalThis.WebSocket;
+        if (!Ctor) {
+            throw new Error('No global WebSocket available — are you running outside of React Native?');
+        }
+        const socket = new Ctor(url.toString(), undefined, options);
+        this.socket = socket;
+        socket.onopen = () => this._handleOpen();
+        socket.onmessage = (e) => this._handleMessage(e);
+        socket.onclose = (e) => this._handleClose(e);
+        socket.onerror = (e) => this._handleError(e);
+    }
+    disconnect() {
+        this._wantConnected = false;
+        if (!this.socket)
+            return;
+        const socket = this.socket;
+        this._cleanupSocket();
+        try {
+            socket.close(1000, 'Client disconnected');
+        }
+        catch (e) {
+            this._logger.warn('Error closing socket:', e);
+        }
+        this._status = 'disconnected';
+        this.emit('disconnected', { code: 1000, reason: 'Client disconnected' });
+    }
+    async switchNetwork(target) {
+        return new Promise((resolve) => {
+            this.once('changeNetwork', ({ network }) => {
+                this._supernetType = network;
+                resolve(network);
+            });
+            void this.send('changeNetwork', target);
+        });
+    }
+    async send(messageType, data) {
+        if (!this.socket || this._status !== 'connected') {
+            throw new Error(`Cannot send ${messageType}: socket not connected`);
+        }
+        const envelope = JSON.stringify({
+            type: messageType,
+            data: (0, base64_1.base64Encode)(JSON.stringify(data))
+        });
+        this._logger.debug('WebSocket send:', messageType, data);
+        this.socket.send(envelope);
+    }
+    _handleOpen() {
+        this._status = 'connected';
+        this._reconnectAttempts = 0;
+        this.emit('connected', { network: this._supernetType });
+    }
+    _handleClose(e) {
+        const wasConnected = this._status === 'connected';
+        this._status = 'disconnected';
+        this._cleanupSocket();
+        this.emit('disconnected', { code: e.code, reason: e.reason });
+        if (this._wantConnected && wasConnected && e.code !== 1000) {
+            this._scheduleReconnect();
+        }
+    }
+    _handleError(e) {
+        this._logger.error('WebSocket error:', e);
+    }
+    _scheduleReconnect() {
+        if (this._reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {
+            this._logger.warn('WebSocket reconnect attempts exhausted');
+            return;
+        }
+        this._reconnectAttempts++;
+        setTimeout(() => {
+            if (this._wantConnected) {
+                void this.connect();
+            }
+        }, RECONNECT_DELAY_MS);
+    }
+    _cleanupSocket() {
+        if (!this.socket)
+            return;
+        const s = this.socket;
+        s.onopen = null;
+        s.onmessage = null;
+        s.onclose = null;
+        s.onerror = null;
+        this.socket = null;
+    }
+    _handleMessage(e) {
+        Promise.resolve(typeof e.data === 'string' ? e.data : e.data.text())
+            .then((str) => {
+            const envelope = JSON.parse(str);
+            const payload = envelope.data ? JSON.parse((0, base64_1.base64Decode)(envelope.data)) : null;
+            this._logger.debug('WebSocket recv:', envelope.type, payload);
+            this._dispatch(envelope.type, payload);
+        })
+            .catch((err) => this._logger.error('Failed to parse WebSocket message:', err));
+    }
+    _dispatch(type, payload) {
+        switch (type) {
+            case 'authenticated':
+                this.emit('authenticated', (0, normalize_1.normalizeAuthenticated)(payload));
+                break;
+            case 'balanceUpdate':
+                this.emit('balanceUpdate', (0, normalize_1.normalizeBalanceUpdate)(payload));
+                break;
+            case 'changeNetwork':
+                this.emit('changeNetwork', (0, normalize_1.normalizeChangeNetwork)(payload));
+                break;
+            case 'toastMessage':
+                this.emit('toastMessage', (0, normalize_1.normalizeToastMessage)(payload));
+                break;
+            default:
+                // Phase 2 only handles a subset; later phases will add jobState, jobProgress, etc.
+                this._logger.debug('Unhandled WebSocket message type:', type);
+                break;
+        }
+    }
+}
+function normalizeBaseUrl(url) {
+    const u = new URL(url);
+    if (u.protocol === 'http:' || u.protocol === 'ws:')
+        u.protocol = 'http:';
+    else
+        u.protocol = 'https:';
+    return u.toString();
+}
+exports.default = WebSocketClient;
+//# sourceMappingURL=index.js.map

package/dist/cjs/ApiClient/WebSocketClient/index.js.map

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

package/dist/cjs/ApiClient/WebSocketClient/normalize.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The ONLY place where wire-level message shapes are translated into clean
+ * public types. Every quirk in the sogni-socket protocol gets masked here so
+ * the rest of the SDK and downstream apps never see them.
+ *
+ * Authoritative wire source:
+ *   ../sogni-socket/controllers/jobsController.js
+ *   ../sogni-socket/controllers/websocketsController.js
+ *
+ * Known quirks masked (catalog grows as later phases add events):
+ *   - `jobID` on the wire is actually the PROJECT id (Phase 3)
+ *   - `imgID` on the wire is actually the JOB id (Phase 3)
+ *   - `error_message` is snake_case in an otherwise camelCase API (Phase 3)
+ *   - `balanceUpdate` arrives in two shapes (v1 flat, v2 nested) — always
+ *     normalized to v2 here.
+ *   - `authenticated.tokens` similarly v1/v2 — normalized to v2.
+ */
+import { AuthenticatedEvent, BalanceUpdateEvent, ChangeNetworkEvent, ToastMessageEvent } from './events';
+import { RawAuthenticated, RawBalanceUpdate, RawChangeNetwork, RawToastMessage } from './wireTypes';
+export declare function normalizeAuthenticated(raw: RawAuthenticated): AuthenticatedEvent;
+export declare function normalizeBalanceUpdate(raw: RawBalanceUpdate): BalanceUpdateEvent;
+export declare function normalizeChangeNetwork(raw: RawChangeNetwork): ChangeNetworkEvent;
+export declare function normalizeToastMessage(raw: RawToastMessage): ToastMessageEvent;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/cjs/ApiClient/WebSocketClient/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../../src/ApiClient/WebSocketClient/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAElB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAGhB,gBAAgB,EAChB,eAAe,EAChB,MAAM,aAAa,CAAC;AA6CrB,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,gBAAgB,GAAG,kBAAkB,CAUhF;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,gBAAgB,GAAG,kBAAkB,CAEhF;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,gBAAgB,GAAG,kBAAkB,CAEhF;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,iBAAiB,CAM7E"}