@eudiplo/sdk-core 1.14.0-main.d446bdf → 1.14.0-main.d6bef75

package/README.md

@@ -141,14 +141,16 @@ const session = await client.submitDcApiResponse(sessionId, credential);
 When deploying to production, you should **never expose your client credentials to the browser**. The SDK provides helper functions to split the DC API flow between your server (where credentials are safe) and the browser (where the DC API runs).
 
 **Server-side Functions:**
-| Function | Description |
-| ---------------------- | --------------------------------------------------- |
+
+| Function                         | Description                                            |
+| -------------------------------- | ------------------------------------------------------ |
 | `createDcApiRequestForBrowser()` | Create request on server, return safe data for browser |
-| `submitDcApiWalletResponse()` | Submit wallet response to EUDIPLO from server |
+| `submitDcApiWalletResponse()`    | Submit wallet response to EUDIPLO from server          |
 
 **Browser-side Functions:**
-| Function | Description |
-| ---------------------- | --------------------------------------------------- |
+
+| Function      | Description                                            |
+| ------------- | ------------------------------------------------------ |
 | `callDcApi()` | Call the native DC API with a request from your server |
 
 ##### Example: Express.js Backend + Browser Frontend
@@ -165,8 +167,8 @@ import {
 app.post('/api/start-verification', async (req, res) => {
   const requestData = await createDcApiRequestForBrowser({
     baseUrl: process.env.EUDIPLO_URL,
-    clientId: process.env.EUDIPLO_CLIENT_ID,     // ✅ Safe on server
-    clientSecret: process.env.EUDIPLO_SECRET,   // ✅ Safe on server
+    clientId: process.env.EUDIPLO_CLIENT_ID, // ✅ Safe on server
+    clientSecret: process.env.EUDIPLO_SECRET, // ✅ Safe on server
     configId: 'age-over-18',
   });
 
@@ -181,7 +183,7 @@ app.post('/api/complete-verification', async (req, res) => {
   const result = await submitDcApiWalletResponse({
     responseUri,
     walletResponse,
-    sendResponse: true,  // Get verified claims back
+    sendResponse: true, // Get verified claims back
   });
 
   // result.credentials contains the verified data
@@ -224,13 +226,13 @@ async function verifyAge() {
 
 **What stays where:**
 
-| Data | Location | Safe to expose? |
-|------|----------|-----------------|
-| `clientId` / `clientSecret` | Server only | ❌ Never expose |
-| `requestObject` (signed JWT) | Server → Browser | ✅ Yes |
-| `responseUri` | Server → Browser | ✅ Yes |
-| Wallet response (encrypted VP) | Browser → Server | ✅ Yes |
-| Verified credentials | Server only | Depends on use case |
+| Data                           | Location         | Safe to expose?     |
+| ------------------------------ | ---------------- | ------------------- |
+| `clientId` / `clientSecret`    | Server only      | ❌ Never expose     |
+| `requestObject` (signed JWT)   | Server → Browser | ✅ Yes              |
+| `responseUri`                  | Server → Browser | ✅ Yes              |
+| Wallet response (encrypted VP) | Browser → Server | ✅ Yes              |
+| Verified credentials           | Server only      | Depends on use case |
 
 ### Class-based API (More Control)
 
@@ -325,6 +327,43 @@ const session = await client.waitForSession(sessionId, {
 });
 ```
 
+### `subscribeToSession(sessionId, options)`
+
+Subscribe to real-time session status updates via Server-Sent Events (SSE).
+This is more efficient than polling and provides instant updates.
+
+```typescript
+const subscription = await client.subscribeToSession(sessionId, {
+  onStatusChange: (event) => {
+    console.log(`Status: ${event.status}`);
+    if (['completed', 'expired', 'failed'].includes(event.status)) {
+      subscription.close();
+    }
+  },
+  onError: (error) => console.error('SSE error:', error),
+  onOpen: () => console.log('Connected'),
+});
+
+// Later, to close the connection:
+subscription.close();
+```
+
+### `waitForSessionWithSse(sessionId, options)`
+
+Wait for session completion using SSE instead of polling. Returns a Promise
+that resolves when the session completes.
+
+```typescript
+try {
+  const finalStatus = await client.waitForSessionWithSse(sessionId, {
+    onStatusChange: (event) => console.log('Status:', event.status),
+  });
+  console.log('Session completed:', finalStatus);
+} catch (error) {
+  console.error('Session failed:', error);
+}
+```
+
 ## Examples
 
 ### Age Verification in a Web Shop

package/dist/api/client/client.gen.d.mts

@@ -1,4 +1,4 @@
-import { b as Config, C as Client } from '../../types.gen-DDunhhsd.mjs';
+import { b as Config, C as Client } from '../../types.gen-BltYeQS_.mjs';
 
 declare const createClient: (config?: Config) => Client;
 

package/dist/api/client/client.gen.d.ts

@@ -1,4 +1,4 @@
-import { b as Config, C as Client } from '../../types.gen-DDunhhsd.js';
+import { b as Config, C as Client } from '../../types.gen-BltYeQS_.js';
 
 declare const createClient: (config?: Config) => Client;
 

package/dist/api/client/client.gen.js

@@ -637,8 +637,9 @@ var createClient = (config = {}) => {
     if (opts.body === void 0 || opts.serializedBody === "") {
       opts.headers.delete("Content-Type");
     }
-    const url = buildUrl(opts);
-    return { opts, url };
+    const resolvedOpts = opts;
+    const url = buildUrl(resolvedOpts);
+    return { opts: resolvedOpts, url };
   };
   const request = async (options) => {
     const { opts, url } = await beforeRequest(options);
@@ -789,8 +790,9 @@ var createClient = (config = {}) => {
       url
     });
   };
+  const _buildUrl = (options) => buildUrl({ ..._config, ...options });
   return {
-    buildUrl,
+    buildUrl: _buildUrl,
     connect: makeMethodFn("CONNECT"),
     delete: makeMethodFn("DELETE"),
     get: makeMethodFn("GET"),

package/dist/api/client/client.gen.mjs

@@ -635,8 +635,9 @@ var createClient = (config = {}) => {
     if (opts.body === void 0 || opts.serializedBody === "") {
       opts.headers.delete("Content-Type");
     }
-    const url = buildUrl(opts);
-    return { opts, url };
+    const resolvedOpts = opts;
+    const url = buildUrl(resolvedOpts);
+    return { opts: resolvedOpts, url };
   };
   const request = async (options) => {
     const { opts, url } = await beforeRequest(options);
@@ -787,8 +788,9 @@ var createClient = (config = {}) => {
       url
     });
   };
+  const _buildUrl = (options) => buildUrl({ ..._config, ...options });
   return {
-    buildUrl,
+    buildUrl: _buildUrl,
     connect: makeMethodFn("CONNECT"),
     delete: makeMethodFn("DELETE"),
     get: makeMethodFn("GET"),

package/dist/api/client/index.d.mts

@@ -1,4 +1,4 @@
-export { A as Auth, C as Client, a as ClientOptions, b as Config, c as CreateClientConfig, O as Options, Q as QuerySerializerOptions, R as RequestOptions, d as RequestResult, e as ResolvedRequestOptions, f as ResponseStyle, T as TDataShape, g as createConfig, h as formDataBodySerializer, j as jsonBodySerializer, m as mergeHeaders, u as urlSearchParamsBodySerializer } from '../../types.gen-DDunhhsd.mjs';
+export { A as Auth, C as Client, a as ClientOptions, b as Config, c as CreateClientConfig, O as Options, Q as QuerySerializerOptions, R as RequestOptions, d as RequestResult, e as ResolvedRequestOptions, f as ResponseStyle, T as TDataShape, g as createConfig, h as formDataBodySerializer, j as jsonBodySerializer, m as mergeHeaders, u as urlSearchParamsBodySerializer } from '../../types.gen-BltYeQS_.mjs';
 export { createClient } from './client.gen.mjs';
 
 type Slot = "body" | "headers" | "path" | "query";

package/dist/api/client/index.d.ts

@@ -1,4 +1,4 @@
-export { A as Auth, C as Client, a as ClientOptions, b as Config, c as CreateClientConfig, O as Options, Q as QuerySerializerOptions, R as RequestOptions, d as RequestResult, e as ResolvedRequestOptions, f as ResponseStyle, T as TDataShape, g as createConfig, h as formDataBodySerializer, j as jsonBodySerializer, m as mergeHeaders, u as urlSearchParamsBodySerializer } from '../../types.gen-DDunhhsd.js';
+export { A as Auth, C as Client, a as ClientOptions, b as Config, c as CreateClientConfig, O as Options, Q as QuerySerializerOptions, R as RequestOptions, d as RequestResult, e as ResolvedRequestOptions, f as ResponseStyle, T as TDataShape, g as createConfig, h as formDataBodySerializer, j as jsonBodySerializer, m as mergeHeaders, u as urlSearchParamsBodySerializer } from '../../types.gen-BltYeQS_.js';
 export { createClient } from './client.gen.js';
 
 type Slot = "body" | "headers" | "path" | "query";

package/dist/api/client/index.js

@@ -88,7 +88,7 @@ var buildKeyMap = (fields, map) => {
 };
 var stripEmptySlots = (params) => {
   for (const [slot, value] of Object.entries(params)) {
-    if (value && typeof value === "object" && !Object.keys(value).length) {
+    if (value && typeof value === "object" && !Array.isArray(value) && !Object.keys(value).length) {
       delete params[slot];
     }
   }
@@ -859,8 +859,9 @@ var createClient = (config = {}) => {
     if (opts.body === void 0 || opts.serializedBody === "") {
       opts.headers.delete("Content-Type");
     }
-    const url = buildUrl(opts);
-    return { opts, url };
+    const resolvedOpts = opts;
+    const url = buildUrl(resolvedOpts);
+    return { opts: resolvedOpts, url };
   };
   const request = async (options) => {
     const { opts, url } = await beforeRequest(options);
@@ -1011,8 +1012,9 @@ var createClient = (config = {}) => {
       url
     });
   };
+  const _buildUrl = (options) => buildUrl({ ..._config, ...options });
   return {
-    buildUrl,
+    buildUrl: _buildUrl,
     connect: makeMethodFn("CONNECT"),
     delete: makeMethodFn("DELETE"),
     get: makeMethodFn("GET"),

package/dist/api/client/index.mjs

@@ -86,7 +86,7 @@ var buildKeyMap = (fields, map) => {
 };
 var stripEmptySlots = (params) => {
   for (const [slot, value] of Object.entries(params)) {
-    if (value && typeof value === "object" && !Object.keys(value).length) {
+    if (value && typeof value === "object" && !Array.isArray(value) && !Object.keys(value).length) {
       delete params[slot];
     }
   }
@@ -857,8 +857,9 @@ var createClient = (config = {}) => {
     if (opts.body === void 0 || opts.serializedBody === "") {
       opts.headers.delete("Content-Type");
     }
-    const url = buildUrl(opts);
-    return { opts, url };
+    const resolvedOpts = opts;
+    const url = buildUrl(resolvedOpts);
+    return { opts: resolvedOpts, url };
   };
   const request = async (options) => {
     const { opts, url } = await beforeRequest(options);
@@ -1009,8 +1010,9 @@ var createClient = (config = {}) => {
       url
     });
   };
+  const _buildUrl = (options) => buildUrl({ ..._config, ...options });
   return {
-    buildUrl,
+    buildUrl: _buildUrl,
     connect: makeMethodFn("CONNECT"),
     delete: makeMethodFn("DELETE"),
     get: makeMethodFn("GET"),

package/dist/api/client/types.gen.d.mts

@@ -1 +1 @@
-export { C as Client, a as ClientOptions, b as Config, c as CreateClientConfig, O as Options, R as RequestOptions, d as RequestResult, e as ResolvedRequestOptions, f as ResponseStyle, T as TDataShape } from '../../types.gen-DDunhhsd.mjs';
+export { C as Client, a as ClientOptions, b as Config, c as CreateClientConfig, O as Options, R as RequestOptions, d as RequestResult, e as ResolvedRequestOptions, f as ResponseStyle, T as TDataShape } from '../../types.gen-BltYeQS_.mjs';

package/dist/api/client/types.gen.d.ts

@@ -1 +1 @@
-export { C as Client, a as ClientOptions, b as Config, c as CreateClientConfig, O as Options, R as RequestOptions, d as RequestResult, e as ResolvedRequestOptions, f as ResponseStyle, T as TDataShape } from '../../types.gen-DDunhhsd.js';
+export { C as Client, a as ClientOptions, b as Config, c as CreateClientConfig, O as Options, R as RequestOptions, d as RequestResult, e as ResolvedRequestOptions, f as ResponseStyle, T as TDataShape } from '../../types.gen-BltYeQS_.js';

package/dist/api/client.gen.d.mts

@@ -1,5 +1,5 @@
-import { C as Client, a as ClientOptions, b as Config } from '../types.gen-DDunhhsd.mjs';
-import { aw as ClientOptions$1 } from '../types.gen-D7mQfhiG.mjs';
+import { C as Client, a as ClientOptions, b as Config } from '../types.gen-BltYeQS_.mjs';
+import { ag as ClientOptions$1 } from '../types.gen-DussKHRF.mjs';
 
 /**
  * The `createClientConfig()` function will be called on client initialization

package/dist/api/client.gen.d.ts

@@ -1,5 +1,5 @@
-import { C as Client, a as ClientOptions, b as Config } from '../types.gen-DDunhhsd.js';
-import { aw as ClientOptions$1 } from '../types.gen-D7mQfhiG.js';
+import { C as Client, a as ClientOptions, b as Config } from '../types.gen-BltYeQS_.js';
+import { ag as ClientOptions$1 } from '../types.gen-DussKHRF.js';
 
 /**
  * The `createClientConfig()` function will be called on client initialization

package/dist/api/client.gen.js

@@ -637,8 +637,9 @@ var createClient = (config = {}) => {
     if (opts.body === void 0 || opts.serializedBody === "") {
       opts.headers.delete("Content-Type");
     }
-    const url = buildUrl(opts);
-    return { opts, url };
+    const resolvedOpts = opts;
+    const url = buildUrl(resolvedOpts);
+    return { opts: resolvedOpts, url };
   };
   const request = async (options) => {
     const { opts, url } = await beforeRequest(options);
@@ -789,8 +790,9 @@ var createClient = (config = {}) => {
       url
     });
   };
+  const _buildUrl = (options) => buildUrl({ ..._config, ...options });
   return {
-    buildUrl,
+    buildUrl: _buildUrl,
     connect: makeMethodFn("CONNECT"),
     delete: makeMethodFn("DELETE"),
     get: makeMethodFn("GET"),

package/dist/api/client.gen.mjs

@@ -635,8 +635,9 @@ var createClient = (config = {}) => {
     if (opts.body === void 0 || opts.serializedBody === "") {
       opts.headers.delete("Content-Type");
     }
-    const url = buildUrl(opts);
-    return { opts, url };
+    const resolvedOpts = opts;
+    const url = buildUrl(resolvedOpts);
+    return { opts: resolvedOpts, url };
   };
   const request = async (options) => {
     const { opts, url } = await beforeRequest(options);
@@ -787,8 +788,9 @@ var createClient = (config = {}) => {
       url
     });
   };
+  const _buildUrl = (options) => buildUrl({ ..._config, ...options });
   return {
-    buildUrl,
+    buildUrl: _buildUrl,
     connect: makeMethodFn("CONNECT"),
     delete: makeMethodFn("DELETE"),
     get: makeMethodFn("GET"),