[ID-1139] add js bindings

.github/workflows/publish-swift.yml

@@ -116,4 +116,4 @@ jobs:
           gh release edit "$VERSION" \
             --repo worldcoin/idkit-swift \
             --draft=false \
-            --latest
+            --latest

Cargo.toml

@@ -31,14 +31,14 @@ hex = "0.4"
 
 # Async
 tokio = { version = "1", features = ["full"] }
-reqwest = { version = "0.12", default-features = false, features = ["json", "rustls-tls"] }
+reqwest = { version = "0.12", default-features = false }
 
 # Error handling
 thiserror = "1.0"
 anyhow = "1.0"
 
 # UUID
-uuid = { version = "1.10", features = ["v4", "serde"] }
+uuid = { version = "1.10", default-features = false, features = ["serde"] }
 
 # URL handling
 url = "2.5"

js/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "idkit-monorepo",
+  "version": "3.0.0",
+  "private": true,
+  "description": "World ID SDK for Relying Parties - JavaScript packages",
+  "scripts": {
+    "build": "pnpm -r build",
+    "dev": "pnpm -r dev",
+    "lint": "pnpm -r lint",
+    "test": "pnpm -r test"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.27",
+    "prettier": "^3.3",
+    "typescript": "^5.6",
+    "turbo": "^2.2"
+  },
+  "packageManager": "pnpm@9.12.2",
+  "engines": {
+    "node": ">=18"
+  }
+}

js/packages/core/README.md

@@ -0,0 +1,164 @@
+# @worldcoin/idkit-core
+
+Core bridge logic for IDKit (World ID SDK) powered by Rust/WASM.
+
+## Installation
+
+```bash
+npm install @worldcoin/idkit-core
+# or
+pnpm add @worldcoin/idkit-core
+```
+
+## Quick Start
+
+```typescript
+import {
+  useWorldBridgeStore,
+  VerificationLevel,
+} from '@worldcoin/idkit-core'
+
+// 1. Get store instance
+const store = useWorldBridgeStore()
+
+// 2. Create client - returns immutable client object
+const client = await store.createClient({
+  app_id: 'app_staging_xxxxx',
+  action: 'my-action',
+  verification_level: VerificationLevel.Orb,
+  signal: 'user-id-123',
+})
+
+// 3. Display QR code for World App
+console.log('Scan this:', client.connectorURI)
+
+// 4. Poll for proof (handles polling automatically)
+try {
+  const proof = await client.pollForUpdates()
+  console.log('Success:', proof)
+} catch (error) {
+  console.error('Verification failed:', error)
+}
+```
+
+## V2 API
+
+```typescript
+const store = useWorldBridgeStore()
+
+await store.createClient({
+  app_id: 'app_staging_xxxxx',
+  action: 'my-action',
+  verification_level: VerificationLevel.Orb,
+  signal: 'user-id-123',
+})
+
+console.log('Scan this:', store.connectorURI)
+
+await store.pollForUpdates()
+
+if (store.result) {
+  console.log('Proof received:', store.result)
+}
+```
+
+## API Reference
+
+```typescript
+const client = await store.createClient(config)
+```
+
+**Properties:**
+- `connectorURI: string` - QR code URL for World App
+- `requestId: string` - Unique request ID
+
+**Methods:**
+- `pollForUpdates(options?: WaitOptions): Promise<ISuccessResult>` - Poll for proof (auto-polls)
+- `pollOnce(): Promise<Status>` - Poll once for status (manual polling)
+
+**WaitOptions:**
+```typescript
+interface WaitOptions {
+  pollInterval?: number    // ms between polls (default: 1000)
+  timeout?: number        // total timeout ms (default: 300000 = 5min)
+  signal?: AbortSignal    // for cancellation
+}
+```
+
+### Store
+
+```typescript
+const store = useWorldBridgeStore()
+```
+
+**V3 Methods:**
+- `createClient(config: IDKitConfig): Promise<WorldBridgeClient>` - Create new client
+
+**V2 State (backward compat):**
+- `verificationState: VerificationState` - Current verification state
+- `connectorURI: string | null` - QR code URL for World App
+- `result: ISuccessResult | null` - Proof data when verified
+- `errorCode: AppErrorCodes | null` - Error code if failed
+
+**V2 Methods (deprecated):**
+- `pollForUpdates(): Promise<void>` - Check for proof (call repeatedly) ⚠️ Use `client.pollForUpdates()` with auto-polling instead
+- `reset(): void` - Clear state and start over
+
+### Types
+
+```typescript
+interface IDKitConfig {
+  app_id: `app_${string}`
+  action: string
+  signal?: string
+  verification_level?: VerificationLevel
+  bridge_url?: string
+  partner?: boolean
+}
+
+interface ISuccessResult {
+  proof: string
+  merkle_root: string
+  nullifier_hash: string
+  verification_level: VerificationLevel
+}
+
+enum VerificationLevel {
+  Orb = 'orb',
+  Face = 'face',
+  Device = 'device',
+  Document = 'document',
+  SecureDocument = 'secure_document',
+}
+```
+
+### Utilities
+
+```typescript
+// Signal hashing (keccak256)
+hashToField(input: string): HashFunctionOutput
+
+// ABI encoding
+solidityEncode(types: string[], values: unknown[]): AbiEncodedValue
+```
+
+## Examples
+
+See [examples/browser](./examples/browser) for a complete working example.
+
+## Building from Source
+
+```bash
+# Build WASM module
+npm run build:wasm
+
+# Build TypeScript
+npm run build:ts
+
+# Or both
+npm run build
+```
+
+## License
+
+MIT

js/packages/core/examples/browser/README.md

@@ -0,0 +1,68 @@
+# IDKit Browser Example
+
+A simple browser example demonstrating World ID verification using IDKit 3.0.
+
+## Usage
+
+#### Local Development
+
+1. Build the core package:
+```bash
+cd ../../
+pnpm build
+```
+
+2. Serve the example:
+```bash
+cd examples/browser
+python3 -m http.server 8000
+# or
+npx serve
+```
+
+3. Open http://localhost:8000 in your browser
+
+#### Production
+
+Replace the import in `index.html`:
+
+```javascript
+// From:
+import { initIDKit, Session, Credential } from '../../dist/index.js';
+
+// To:
+import { initIDKit, Session, Credential } from '@worldcoin/idkit-core';
+```
+
+## Configuration
+
+Update these values in `index.html`:
+
+```javascript
+const APP_ID = 'app_staging_123'; // Your app ID from the Developer Portal
+const ACTION = 'demo-action';     // Your action identifier from the Developer Portal
+```
+
+## API Usage
+
+```javascript
+// 1. Initialize WASM
+await initIDKit();
+
+// 2. Create session
+const session = await Session.create({
+    app_id: 'app_xxx',
+    action: 'my-action',
+    requests: [{
+        type: Credential.Orb,
+        signal: 'my-signal',
+    }],
+});
+
+// 3. Get QR code URL
+const url = session.connectUrl();
+
+// 4. Wait for proof
+const proof = await session.waitForProof();
+console.log(proof);
+```