@puul/partner-sdk 1.3.0 → 1.4.0

package/dist/index.d.mts

@@ -63,6 +63,10 @@ interface PlacePredictionParams {
     stakeAmount: number;
     stakeCurrency: Currency;
     idempotencyKey: string;
+    /** Linked Puul user UUID (provide userId or userExternalId) */
+    userId?: string;
+    /** Your linked external user ID (provide userId or userExternalId) */
+    userExternalId?: string;
     /** Optional quote ID for slippage protection */
     quoteId?: string;
     /** Optional FX quote ID */
@@ -75,6 +79,10 @@ interface CreateQuoteParams {
     outcomeId: string;
     stakeAmount: number;
     stakeCurrency: Currency;
+    /** Linked Puul user UUID (provide userId or userExternalId) */
+    userId?: string;
+    /** Your linked external user ID (provide userId or userExternalId) */
+    userExternalId?: string;
 }
 interface QuoteResponse {
     quoteId: string;
@@ -153,6 +161,10 @@ interface DepositParams {
     currency?: string;
     idempotency_key: string;
     reference?: string;
+    /** Linked Puul user UUID (provide userId or userExternalId) */
+    userId?: string;
+    /** Your linked external user ID (provide userId or userExternalId) */
+    userExternalId?: string;
 }
 type WithdrawMethod = 'bank' | 'crypto';
 interface WithdrawParams {
@@ -220,13 +232,13 @@ interface LotteryEntriesResponse {
     total: number;
 }
 interface BuyTicketParams {
-    /** Puul user ID of the linked user */
-    userId: string;
+    /** Puul user UUID (provide userId or userExternalId) */
+    userId?: string;
     /** Unique key to prevent duplicate purchases */
     idempotencyKey: string;
     /** Number of tickets (default: 1) */
     quantity?: number;
-    /** Your external user ID (for tracking) */
+    /** Your linked external user ID (provide userId or userExternalId) */
     userExternalId?: string;
 }
 interface BuyTicketResponse {
@@ -473,6 +485,8 @@ declare class PredictionsAPI {
     list(options?: {
         status?: PredictionStatus;
         limit?: number;
+        userId?: string;
+        userExternalId?: string;
     }): Promise<PredictionListResponse>;
     /** Create a pending prediction (JIT funding flow) */
     createPending(params: CreatePendingPredictionParams): Promise<PendingPrediction>;

package/dist/index.d.ts

@@ -63,6 +63,10 @@ interface PlacePredictionParams {
     stakeAmount: number;
     stakeCurrency: Currency;
     idempotencyKey: string;
+    /** Linked Puul user UUID (provide userId or userExternalId) */
+    userId?: string;
+    /** Your linked external user ID (provide userId or userExternalId) */
+    userExternalId?: string;
     /** Optional quote ID for slippage protection */
     quoteId?: string;
     /** Optional FX quote ID */
@@ -75,6 +79,10 @@ interface CreateQuoteParams {
     outcomeId: string;
     stakeAmount: number;
     stakeCurrency: Currency;
+    /** Linked Puul user UUID (provide userId or userExternalId) */
+    userId?: string;
+    /** Your linked external user ID (provide userId or userExternalId) */
+    userExternalId?: string;
 }
 interface QuoteResponse {
     quoteId: string;
@@ -153,6 +161,10 @@ interface DepositParams {
     currency?: string;
     idempotency_key: string;
     reference?: string;
+    /** Linked Puul user UUID (provide userId or userExternalId) */
+    userId?: string;
+    /** Your linked external user ID (provide userId or userExternalId) */
+    userExternalId?: string;
 }
 type WithdrawMethod = 'bank' | 'crypto';
 interface WithdrawParams {
@@ -220,13 +232,13 @@ interface LotteryEntriesResponse {
     total: number;
 }
 interface BuyTicketParams {
-    /** Puul user ID of the linked user */
-    userId: string;
+    /** Puul user UUID (provide userId or userExternalId) */
+    userId?: string;
     /** Unique key to prevent duplicate purchases */
     idempotencyKey: string;
     /** Number of tickets (default: 1) */
     quantity?: number;
-    /** Your external user ID (for tracking) */
+    /** Your linked external user ID (provide userId or userExternalId) */
     userExternalId?: string;
 }
 interface BuyTicketResponse {
@@ -473,6 +485,8 @@ declare class PredictionsAPI {
     list(options?: {
         status?: PredictionStatus;
         limit?: number;
+        userId?: string;
+        userExternalId?: string;
     }): Promise<PredictionListResponse>;
     /** Create a pending prediction (JIT funding flow) */
     createPending(params: CreatePendingPredictionParams): Promise<PendingPrediction>;

package/dist/index.js

@@ -190,11 +190,21 @@ var PredictionsAPI = class {
   }
   /** Create a binding quote for slippage protection (expires in 10s) */
   async createQuote(params) {
-    return this.client.request("POST", "/partner/predictions/quote", params);
+    const { userId, userExternalId, ...rest } = params;
+    return this.client.request("POST", "/partner/predictions/quote", {
+      ...rest,
+      user_id: userId,
+      user_external_id: userExternalId
+    });
   }
   /** Place a prediction on a market outcome */
   async place(params) {
-    return this.client.request("POST", "/partner/predictions", params);
+    const { userId, userExternalId, ...rest } = params;
+    return this.client.request("POST", "/partner/predictions", {
+      ...rest,
+      user_id: userId,
+      user_external_id: userExternalId
+    });
   }
   /** Get a specific prediction by ID */
   async get(predictionId) {
@@ -205,6 +215,8 @@ var PredictionsAPI = class {
     const params = new URLSearchParams();
     if (options?.status) params.set("status", options.status);
     if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.userId) params.set("user_id", options.userId);
+    if (options?.userExternalId) params.set("user_external_id", options.userExternalId);
     const query = params.toString() ? `?${params.toString()}` : "";
     return this.client.request("GET", `/partner/predictions${query}`);
   }
@@ -236,7 +248,12 @@ var WalletAPI = class {
   }
   /** Deposit funds to a linked user wallet */
   async deposit(params) {
-    return this.client.request("POST", "/partner/wallet/deposit", params);
+    const { userId, userExternalId, ...rest } = params;
+    return this.client.request("POST", "/partner/wallet/deposit", {
+      ...rest,
+      user_id: userId,
+      user_external_id: userExternalId
+    });
   }
   /** Get withdrawal fee estimate */
   async getWithdrawalFees(currency, amount) {

package/dist/index.mjs

@@ -147,11 +147,21 @@ var PredictionsAPI = class {
   }
   /** Create a binding quote for slippage protection (expires in 10s) */
   async createQuote(params) {
-    return this.client.request("POST", "/partner/predictions/quote", params);
+    const { userId, userExternalId, ...rest } = params;
+    return this.client.request("POST", "/partner/predictions/quote", {
+      ...rest,
+      user_id: userId,
+      user_external_id: userExternalId
+    });
   }
   /** Place a prediction on a market outcome */
   async place(params) {
-    return this.client.request("POST", "/partner/predictions", params);
+    const { userId, userExternalId, ...rest } = params;
+    return this.client.request("POST", "/partner/predictions", {
+      ...rest,
+      user_id: userId,
+      user_external_id: userExternalId
+    });
   }
   /** Get a specific prediction by ID */
   async get(predictionId) {
@@ -162,6 +172,8 @@ var PredictionsAPI = class {
     const params = new URLSearchParams();
     if (options?.status) params.set("status", options.status);
     if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.userId) params.set("user_id", options.userId);
+    if (options?.userExternalId) params.set("user_external_id", options.userExternalId);
     const query = params.toString() ? `?${params.toString()}` : "";
     return this.client.request("GET", `/partner/predictions${query}`);
   }
@@ -193,7 +205,12 @@ var WalletAPI = class {
   }
   /** Deposit funds to a linked user wallet */
   async deposit(params) {
-    return this.client.request("POST", "/partner/wallet/deposit", params);
+    const { userId, userExternalId, ...rest } = params;
+    return this.client.request("POST", "/partner/wallet/deposit", {
+      ...rest,
+      user_id: userId,
+      user_external_id: userExternalId
+    });
   }
   /** Get withdrawal fee estimate */
   async getWithdrawalFees(currency, amount) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@puul/partner-sdk",
-    "version": "1.3.0",
+    "version": "1.4.0",
     "description": "Official TypeScript SDK for the Puul Partner API — integrate prediction markets into your platform",
     "main": "dist/index.js",
     "module": "dist/index.mjs",
@@ -42,4 +42,4 @@
     "engines": {
         "node": ">=18.0.0"
     }
-}
+}