@supanovaapp/sdk 0.2.38 → 0.2.39

package/README.md

@@ -418,6 +418,27 @@ const filteredContracts = await getActiveContracts([
   'template-id-1',
   'template-id-2'
 ]);
+
+// With pagination (limit required, offset optional)
+const page = await getActiveContracts(undefined, { limit: 10 });
+const nextPage = await getActiveContracts(undefined, { limit: 10, offset: 10 });
+
+// Combined: filter + pagination
+const filtered = await getActiveContracts(['template-id-1'], { limit: 5, offset: 0 });
+```
+
+**Parameters:**
+- `templateIds` (optional) - Array of template IDs to filter by
+- `pagination` (optional) - `{ limit: number; offset?: number }`. `offset` requires `limit`.
+
+**Note:** The API may return contracts in two formats (legacy wrapped or flat). Use `normalizeContractItem()` to get a consistent shape:
+
+```tsx
+import { normalizeContractItem } from '@supanovaapp/sdk';
+
+const contracts = await getActiveContracts();
+const normalized = contracts.map(normalizeContractItem);
+// normalized[0].contractId, .templateId, .createArgument, .createdAt
 ```
 
 #### Get Canton Balances

package/dist/core/types.d.ts

@@ -143,15 +143,47 @@ export interface CantonJsActiveContract {
 export interface CantonContractEntry {
     JsActiveContract: CantonJsActiveContract;
 }
-/** Active contract response item from API */
-export interface CantonActiveContractItem {
+/** Active contract item — legacy wrapped format (Canton Ledger API) */
+export interface CantonActiveContractItemLegacy {
     /** Workflow ID (can be empty) */
     workflowId: string;
     /** Contract entry containing the active contract */
     contractEntry: CantonContractEntry;
 }
+/** Active contract item — new flat format */
+export interface CantonActiveContractItemFlat {
+    /** Contract ID */
+    contractId: string;
+    /** Template ID in format packageId:module:entity */
+    templateId: string;
+    /** Create argument data — varies per template */
+    createArgument: CantonAmuletCreateArgument | Record<string, unknown>;
+    /** Created event blob (base64) */
+    createdEventBlob: string;
+}
+/** Active contract response item — supports both legacy and flat formats */
+export type CantonActiveContractItem = CantonActiveContractItemLegacy | CantonActiveContractItemFlat;
+/** Normalized contract data extracted from either format */
+export interface CantonNormalizedContract {
+    contractId: string;
+    templateId: string;
+    createArgument: CantonAmuletCreateArgument | Record<string, unknown>;
+    createdEventBlob: string;
+    /** Only available in legacy format */
+    createdAt: string | null;
+}
 /** Response from /canton/api/active_contracts */
 export type CantonActiveContractsResponseDto = CantonActiveContractItem[];
+/** Parameters for getActiveContracts (offset requires limit) */
+export type GetActiveContractsParams = {
+    templateIds?: string[];
+    limit?: number;
+    offset?: never;
+} | {
+    templateIds?: string[];
+    limit: number;
+    offset?: number;
+};
 export interface CantonActiveContract {
     /** Contract ID */
     contractId: string;