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

package/CHANGELOG.md

@@ -0,0 +1,69 @@
+# [1.0.0-alpha.10](https://github.com/Sogni-AI/expo-client/compare/v1.0.0-alpha.9...v1.0.0-alpha.10) (2026-05-12)
+
+
+### Bug Fixes
+
+* use noble pbkdf2 and correct expo-standard-web-crypto setup ([0ca4de9](https://github.com/Sogni-AI/expo-client/commit/0ca4de92ccef231e3033600ba6f83dfa829a3f6b))
+
+# [1.0.0-alpha.9](https://github.com/Sogni-AI/expo-client/compare/v1.0.0-alpha.8...v1.0.0-alpha.9) (2026-05-12)
+
+
+### Features
+
+* app-state reconnect and projects.fetch REST hydration ([671aeea](https://github.com/Sogni-AI/expo-client/commit/671aeea9dc3a6e6a1c4a16a0ef4ea8f03aee4a56))
+
+# [1.0.0-alpha.8](https://github.com/Sogni-AI/expo-client/compare/v1.0.0-alpha.7...v1.0.0-alpha.8) (2026-05-12)
+
+
+### Features
+
+* **chat:** add tool-calling helpers and autoExecuteTools loop ([103803a](https://github.com/Sogni-AI/expo-client/commit/103803a3bd272ee80b71f4bc83c14f78b9118cea))
+
+# [1.0.0-alpha.7](https://github.com/Sogni-AI/expo-client/compare/v1.0.0-alpha.6...v1.0.0-alpha.7) (2026-05-12)
+
+
+### Features
+
+* add Chat API for LLM completions ([ee68f1a](https://github.com/Sogni-AI/expo-client/commit/ee68f1aee065ea0dd673ebb0365194d1dcae1c99))
+
+# [1.0.0-alpha.6](https://github.com/Sogni-AI/expo-client/compare/v1.0.0-alpha.5...v1.0.0-alpha.6) (2026-05-12)
+
+
+### Features
+
+* add video and audio generation ([ba90ac6](https://github.com/Sogni-AI/expo-client/commit/ba90ac672f8e9aee8184fa48fcb4c02b536f57a8))
+
+# [1.0.0-alpha.5](https://github.com/Sogni-AI/expo-client/compare/v1.0.0-alpha.4...v1.0.0-alpha.5) (2026-05-12)
+
+
+### Features
+
+* add img2img, ControlNet, and context images ([dcd9b6d](https://github.com/Sogni-AI/expo-client/commit/dcd9b6da092449d9ce3cb1f0f253540efa5f70d8))
+
+# [1.0.0-alpha.4](https://github.com/Sogni-AI/expo-client/compare/v1.0.0-alpha.3...v1.0.0-alpha.4) (2026-05-12)
+
+
+### Features
+
+* add username+password login and signup via wallet derivation ([4fc095f](https://github.com/Sogni-AI/expo-client/commit/4fc095fab997d631b062fc6352b774965065dd60))
+
+# [1.0.0-alpha.3](https://github.com/Sogni-AI/expo-client/compare/v1.0.0-alpha.2...v1.0.0-alpha.3) (2026-05-12)
+
+
+### Features
+
+* add image generation via ProjectsApi ([392d3ca](https://github.com/Sogni-AI/expo-client/commit/392d3caeb7a7980e646b2ba9046554a5dbaf262e))
+
+# [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,411 @@
+# @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
+
+Polyfill `crypto.getRandomValues` at your app entry point (e.g. `app/_layout.tsx` for Expo Router or `App.tsx` for classic Expo):
+
+```ts
+import { polyfillWebCrypto } from 'expo-standard-web-crypto';
+polyfillWebCrypto();
+```
+
+This is required for the SDK to generate UUIDs and (optionally) fresh wallets. PBKDF2 for username+password login is done in pure JS via `@noble/hashes`, so no `crypto.subtle` polyfill is needed.
+
+## 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();
+}
+```
+
+### Log in with username + password
+
+```ts
+const sogni = await SogniClient.create({ appId: 'my-app' });
+const session = await sogni.account.login('alice', 'correct-horse-battery-staple');
+// JWT tokens are auto-persisted to SecureStore — they survive app restarts.
+```
+
+The SDK derives a deterministic wallet from your credentials on-device
+(PBKDF2: SHA-256, 10,000 iterations, salt = username, 32-byte key), then
+signs an EIP-712 authentication message which the server validates. The
+password never leaves the device and the same credentials produce the
+same wallet on every device — no wallet file to back up.
+
+### Sign up
+
+```ts
+const session = await sogni.account.signup({
+  username: 'alice',
+  email: 'alice@example.com',
+  password: 'correct-horse-battery-staple',
+  subscribe: true,
+  turnstileToken: turnstileTokenFromCaptcha
+});
+// Auto-logged in after signup.
+```
+
+`turnstileToken` comes from Cloudflare Turnstile, which the Sogni API
+requires for signup. Wire it up via `react-native-turnstile` or an
+Expo-friendly equivalent.
+
+### Generate an image
+
+```ts
+import { SogniClient } from '@sogni-ai/expo-client';
+
+const sogni = await SogniClient.create({ appId: 'my-app', apiKey: 'sk_...' });
+
+// Wait for the WebSocket to authenticate before listing models
+await new Promise<void>((resolve) => {
+  if (sogni.account.current.networkStatus === 'connected') resolve();
+  else {
+    const off = sogni.account.onChange((s) => {
+      if (s.networkStatus === 'connected') {
+        off();
+        resolve();
+      }
+    });
+  }
+});
+
+const models = await sogni.projects.getAvailableModels();
+const model = models.find((m) => m.media === 'image' && m.workerCount > 0);
+if (!model) throw new Error('No image models available right now');
+
+const project = await sogni.projects.create({
+  modelId: model.id,
+  positivePrompt: 'a watercolor painting of a fox in autumn',
+  numberOfMedia: 1,
+  steps: 20,
+  guidance: 7.5
+});
+
+// Watch progress
+const unsubscribe = sogni.projects.subscribe(project.id, (p) => {
+  console.log(`${p.status} — ${Math.round(p.progress * 100)}%`);
+});
+
+// Wait for completion and get URLs
+const urls = await sogni.projects.waitForCompletion(project.id);
+unsubscribe();
+console.log('Done:', urls);
+```
+
+`Project` is a plain serializable object — `project.id`, `project.status`, `project.jobs[]`, `project.resultUrls[]`. Drop it into Redux/Zustand/MMKV directly. Subscribe by ID; the SDK keeps an internal cache and garbage-collects projects 30 seconds after they reach a terminal state.
+
+### img2img with an init image
+
+```ts
+import * as ImagePicker from 'expo-image-picker';
+
+const pick = await ImagePicker.launchImageLibraryAsync({ quality: 1 });
+const asset = pick.assets![0]; // { uri, type, fileName, ... }
+
+const project = await sogni.projects.create({
+  modelId: 'flux1-schnell-fp8',
+  positivePrompt: 'cinematic, painterly',
+  numberOfMedia: 1,
+  startingImage: { uri: asset.uri, type: asset.type, name: asset.fileName },
+  startingImageStrength: 0.7
+});
+
+const urls = await sogni.projects.waitForCompletion(project.id);
+```
+
+### ControlNet
+
+```ts
+const project = await sogni.projects.create({
+  modelId: 'sdxl-base',
+  positivePrompt: 'a fox in a forest',
+  numberOfMedia: 1,
+  controlNet: {
+    name: 'canny',
+    image: { uri: edgeAsset.uri, type: edgeAsset.type },
+    strength: 0.8,
+    mode: 'balanced'
+  }
+});
+```
+
+### Multi-reference (context) images
+
+```ts
+const project = await sogni.projects.create({
+  modelId: 'gpt-image-2',
+  positivePrompt: 'merge the style of these references',
+  numberOfMedia: 1,
+  contextImages: [
+    { uri: ref1.uri, type: ref1.type },
+    { uri: ref2.uri, type: ref2.type }
+  ]
+});
+```
+
+The SDK uploads images via signed PUT URLs before sending the generation request — no manual upload step required.
+
+### Generate a video (LTX-2.3)
+
+```ts
+const project = await sogni.projects.create({
+  type: 'video',
+  modelId: 'ltx23-22b-fp8_t2v_distilled',
+  positivePrompt: 'a paper boat drifting down a river at sunset',
+  numberOfMedia: 1,
+  duration: 5, // seconds
+  fps: 24
+});
+
+const urls = await sogni.projects.waitForCompletion(project.id);
+```
+
+The SDK derives frame count from `duration` and `fps` per the model's
+conventions (LTX-2.3 snaps to `1 + n*8`, WAN 2.2 always generates at
+16 fps regardless of the `fps` value, etc.). Override with explicit
+`frames` if needed.
+
+For image-to-video (first/last frame conditioning), pass `referenceImage`
+and optionally `referenceImageEnd` as MediaInput. The SDK uploads them
+before sending the generation request:
+
+```ts
+const project = await sogni.projects.create({
+  type: 'video',
+  modelId: 'ltx23-22b-fp8_i2v_distilled',
+  positivePrompt: 'the still painting comes to life',
+  numberOfMedia: 1,
+  duration: 4,
+  fps: 24,
+  referenceImage: pickerResult.assets[0]
+});
+```
+
+### Generate music (ACE-Step 1.5)
+
+```ts
+const project = await sogni.projects.create({
+  type: 'audio',
+  modelId: 'ace_step_1.5_turbo',
+  positivePrompt: 'upbeat lo-fi hip-hop with mellow piano',
+  numberOfMedia: 1,
+  duration: 30, // seconds, 10-600
+  bpm: 90
+});
+
+const urls = await sogni.projects.waitForCompletion(project.id);
+```
+
+For instrumental music, omit `lyrics`. For songs, pass `lyrics` and
+optionally `language`.
+
+### Chat with an LLM (streaming)
+
+```ts
+const models = sogni.chat.getAvailableModels();
+const modelId = Object.keys(models)[0]; // pick whichever you prefer
+
+const stream = await sogni.chat.completions.create({
+  model: modelId,
+  messages: [
+    { role: 'system', content: 'You are a helpful assistant.' },
+    { role: 'user', content: 'Write a haiku about React Native.' }
+  ],
+  stream: true,
+  temperature: 0.7
+});
+
+for await (const chunk of stream) {
+  process.stdout.write(chunk.content);
+}
+
+const result = await stream.result;
+console.log('\nfinishReason:', result.finishReason, 'tokens:', result.usage);
+```
+
+### Chat (non-streaming)
+
+```ts
+const result = await sogni.chat.completions.create({
+  model: modelId,
+  messages: [{ role: 'user', content: 'Explain WebSockets in one sentence.' }]
+});
+
+console.log(result.content);
+```
+
+### Multimodal (vision)
+
+```ts
+import * as ImagePicker from 'expo-image-picker';
+import * as FileSystem from 'expo-file-system';
+
+const pick = await ImagePicker.launchImageLibraryAsync({ base64: true });
+const dataUri = `data:${pick.assets![0].mimeType};base64,${pick.assets![0].base64}`;
+
+const result = await sogni.chat.completions.create({
+  model: modelId, // must be a vision-capable model (Qwen 3.5 VLM, etc.)
+  messages: [
+    {
+      role: 'user',
+      content: [
+        { type: 'text', text: 'What is in this image?' },
+        { type: 'image_url', image_url: { url: dataUri } }
+      ]
+    }
+  ]
+});
+```
+
+### Tool calling — describe a photo as structured JSON
+
+```ts
+import { parseToolCallArguments } from '@sogni-ai/expo-client';
+import * as ImagePicker from 'expo-image-picker';
+
+const pick = await ImagePicker.launchImageLibraryAsync({ base64: true });
+const dataUri = `data:${pick.assets![0].mimeType};base64,${pick.assets![0].base64}`;
+
+const tools = [
+  {
+    type: 'function' as const,
+    function: {
+      name: 'save_photo_description',
+      description: 'Save a structured description of the user-provided photo.',
+      parameters: {
+        type: 'object',
+        properties: {
+          summary: { type: 'string', description: 'One-sentence summary' },
+          tags: {
+            type: 'array',
+            items: { type: 'string' },
+            description: 'Up to 8 short tags'
+          },
+          mood: { type: 'string', description: 'e.g. cheerful, melancholic' }
+        },
+        required: ['summary', 'tags']
+      }
+    }
+  }
+];
+
+const result = await sogni.chat.completions.create({
+  model: visionModelId,
+  tools,
+  tool_choice: { type: 'function', function: { name: 'save_photo_description' } },
+  messages: [
+    {
+      role: 'user',
+      content: [
+        { type: 'text', text: 'Look at this photo and call the save_photo_description tool.' },
+        { type: 'image_url', image_url: { url: dataUri } }
+      ]
+    }
+  ]
+});
+
+if (result.tool_calls?.length) {
+  const args = parseToolCallArguments<{
+    summary: string;
+    tags: string[];
+    mood?: string;
+  }>(result.tool_calls[0]);
+  console.log(args.summary, args.tags, args.mood);
+}
+```
+
+### Multi-round tool execution (`autoExecuteTools`)
+
+For agent-style flows where the model might call multiple tools in
+sequence (e.g., "look up X, then summarize Y"), pass
+`autoExecuteTools: true` and an `onToolCall` handler. The SDK runs the
+loop until the model answers without calling more tools:
+
+```ts
+const result = await sogni.chat.completions.create({
+  model: modelId,
+  messages: [{ role: 'user', content: 'What is the weather in Kyiv?' }],
+  tools: [getWeatherTool],
+  autoExecuteTools: true,
+  maxToolRounds: 5,
+  onToolCall: async (call) => {
+    const args = parseToolCallArguments<{ city: string }>(call);
+    const weather = await fetchWeather(args.city);
+    return JSON.stringify(weather);
+  }
+});
+
+// result.content is the model's final natural-language answer
+// result.toolHistory[] shows each round
+```
+
+Sogni hosted tools (the `sogni_*` family that lets the LLM directly
+trigger image/video/music generation server-side) are coming in a
+follow-up 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,60 @@
+import ApiClient from '../ApiClient';
+import TypedEventEmitter from '../lib/TypedEventEmitter';
+import { AccountSnapshot, Balances, LoginData, MeData, SignupParams } from './types';
+interface AccountEvents {
+    change: AccountSnapshot;
+}
+/**
+ * Account API: authentication, current-user info, balance.
+ *
+ * login() and signup() derive a deterministic wallet from username + password
+ * via PBKDF2(password, username, 10000 iter, SHA-256, 32 bytes), then sign an
+ * EIP-712 authentication or signup message with that wallet. The wallet
+ * private key never leaves the device.
+ *
+ * login()/signup() require token-based auth (the default). For API-key auth,
+ * use the apiKey config option in SogniClient.create() instead.
+ */
+declare class AccountApi extends TypedEventEmitter<AccountEvents> {
+    private _client;
+    private _snapshot;
+    private _walletNetwork;
+    constructor(client: ApiClient, options?: {
+        testnet?: boolean;
+    });
+    /** 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;
+    /**
+     * Log in with username + password. Derives the user's wallet on-device,
+     * signs an EIP-712 authentication message, and exchanges it for JWT tokens
+     * which are then persisted to SecureStore.
+     */
+    login(username: string, password: string, options?: {
+        appSource?: string;
+    }): Promise<LoginData>;
+    /**
+     * Create a new account. Derives the user's wallet on-device, signs the
+     * EIP-712 signup payload, and exchanges it for JWT tokens (the user is
+     * automatically logged in on success).
+     */
+    signup(params: SignupParams): Promise<LoginData>;
+    /** 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 _getNonce;
+    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;AAGzD,OAAO,EACL,eAAe,EACf,QAAQ,EACR,SAAS,EACT,MAAM,EACN,YAAY,EAEb,MAAM,SAAS,CAAC;AAEjB,UAAU,aAAa;IACrB,MAAM,EAAE,eAAe,CAAC;CACzB;AAED;;;;;;;;;;GAUG;AACH,cAAM,UAAW,SAAQ,iBAAiB,CAAC,aAAa,CAAC;IACvD,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,cAAc,CAAgB;gBAE1B,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO;IAiClE,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;;;;OAIG;IACG,KAAK,CACT,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnC,OAAO,CAAC,SAAS,CAAC;IAsBrB;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;IAuCtD,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;YAaf,SAAS;IAOvB,OAAO,CAAC,OAAO;CAMhB;AAUD,eAAe,UAAU,CAAC"}