@stryke-xyz/premarket-sdk 1.1.4 → 1.1.6

package/dist/cjs/api/orderbook-api/index.js

@@ -708,7 +708,9 @@ function _ts_generator(thisArg, body) {
             // USER POSITION & PNL METHODS
             // ============================================================================
             /**
-   * Returns current user positions derived from vault activity.
+   * Returns enriched user positions including market name, instrument name,
+   * logo, collateral info, PnL, and role (isOPrm / isOpen).
+   * Also includes a `grouped` array keyed by market.
    */ function getUserPositions(userAddress) {
                 return _async_to_generator(function() {
                     return _ts_generator(this, function(_state) {
@@ -826,8 +828,9 @@ function _ts_generator(thisArg, body) {
             // HISTORY METHODS
             // ============================================================================
             /**
-   * Returns grouped user history across mint, redeem, unwind, withdraw,
-   * rollover, transfer, fill, and cancel events.
+   * Returns grouped + enriched user history. Every event carries marketName,
+   * instrumentName, logoUri, collateralDecimals, collateralToken, and a `type`
+   * discriminator. The `timeline` field is a flat chronological list of all events.
    */ function getUserHistories(userAddress, opts) {
                 return _async_to_generator(function() {
                     var limit, marketId, tokenId;

package/dist/cjs/package.json

@@ -1 +1 @@
-{"name":"@stryke-xyz/premarket-sdk","version":"1.1.4","type":"commonjs"}
+{"name":"@stryke-xyz/premarket-sdk","version":"1.1.6","type":"commonjs"}

package/dist/cjs/shared/types.js

@@ -31,10 +31,17 @@ Object.defineProperty(exports, "OrderStatus", {
 // ============================================================================
 // POSITION & PNL TYPES
 // ============================================================================
-/** PnL contribution from limit-order trades */ /** PnL contribution from redemption / exercise settlements */ // ============================================================================
+/** PnL contribution from limit-order trades */ /** PnL contribution from redemption / exercise settlements */ /**
+ * Market/instrument metadata the API attaches to positions and history events.
+ * All fields are optional so existing decoders stay backward-compatible.
+ */ /** Position enriched with market/instrument context returned by /positions. */ /** true when holding > 0 */ /** true = oPRM (outcome position), false = PRM (write/minted) */ /** Flat list sorted by updatedAt desc. */ /** Same positions grouped by market for convenient access. */ // ============================================================================
 // HISTORY TYPES
 // ============================================================================
-/** Net proceeds after fees (profit - fees), as a string */ /** true = ask (maker sells), false = bid (maker buys); from API when available */ /** Recent trade item as returned by getMarketRecentTrades */ // ============================================================================
+/** Net proceeds after fees (profit - fees), as a string */ /** true = ask (maker sells), false = bid (maker buys); from API when available */ /** Recent trade item as returned by getMarketRecentTrades */ /**
+   * All of the above merged and sorted chronologically (newest first).
+   * Each event has a `type` discriminator field.
+   * Populated by /history — may be absent on sub-routes like /history/mints.
+   */ // ============================================================================
 // DEPTH TYPES
 // ============================================================================
 // Note: DepthLevel is exported from sync/clients/order-client.ts

package/dist/esm/api/orderbook-api/index.js

@@ -698,7 +698,9 @@ function _ts_generator(thisArg, body) {
             // USER POSITION & PNL METHODS
             // ============================================================================
             /**
-   * Returns current user positions derived from vault activity.
+   * Returns enriched user positions including market name, instrument name,
+   * logo, collateral info, PnL, and role (isOPrm / isOpen).
+   * Also includes a `grouped` array keyed by market.
    */ function getUserPositions(userAddress) {
                 return _async_to_generator(function() {
                     return _ts_generator(this, function(_state) {
@@ -816,8 +818,9 @@ function _ts_generator(thisArg, body) {
             // HISTORY METHODS
             // ============================================================================
             /**
-   * Returns grouped user history across mint, redeem, unwind, withdraw,
-   * rollover, transfer, fill, and cancel events.
+   * Returns grouped + enriched user history. Every event carries marketName,
+   * instrumentName, logoUri, collateralDecimals, collateralToken, and a `type`
+   * discriminator. The `timeline` field is a flat chronological list of all events.
    */ function getUserHistories(userAddress, opts) {
                 return _async_to_generator(function() {
                     var limit, marketId, tokenId;

package/dist/esm/package.json

@@ -1 +1 @@
-{"name":"@stryke-xyz/premarket-sdk","version":"1.1.4","type":"module"}
+{"name":"@stryke-xyz/premarket-sdk","version":"1.1.6","type":"module"}

package/dist/esm/shared/types.js

@@ -21,10 +21,17 @@
 // ============================================================================
 // POSITION & PNL TYPES
 // ============================================================================
-/** PnL contribution from limit-order trades */ /** PnL contribution from redemption / exercise settlements */ // ============================================================================
+/** PnL contribution from limit-order trades */ /** PnL contribution from redemption / exercise settlements */ /**
+ * Market/instrument metadata the API attaches to positions and history events.
+ * All fields are optional so existing decoders stay backward-compatible.
+ */ /** Position enriched with market/instrument context returned by /positions. */ /** true when holding > 0 */ /** true = oPRM (outcome position), false = PRM (write/minted) */ /** Flat list sorted by updatedAt desc. */ /** Same positions grouped by market for convenient access. */ // ============================================================================
 // HISTORY TYPES
 // ============================================================================
-/** Net proceeds after fees (profit - fees), as a string */ /** true = ask (maker sells), false = bid (maker buys); from API when available */ /** Recent trade item as returned by getMarketRecentTrades */ // ============================================================================
+/** Net proceeds after fees (profit - fees), as a string */ /** true = ask (maker sells), false = bid (maker buys); from API when available */ /** Recent trade item as returned by getMarketRecentTrades */ /**
+   * All of the above merged and sorted chronologically (newest first).
+   * Each event has a `type` discriminator field.
+   * Populated by /history — may be absent on sub-routes like /history/mints.
+   */ // ============================================================================
 // DEPTH TYPES
 // ============================================================================
 // Note: DepthLevel is exported from sync/clients/order-client.ts

package/dist/types/api/orderbook-api/index.d.ts

@@ -1,5 +1,5 @@
 import { Address, Hex } from "viem";
-import type { StoredOrder, CreateOrderParams, CreateOrderResult, MarketsResponse, MarketResponse, UserPosition, TradingPnL, UserPnL, TokenPnL, Erc20PnL, UserHistories, OrderbookApiConfig, PaginatedOrdersResponse, MarketTradeItem, AuthChallenge } from "../../shared/types.js";
+import type { StoredOrder, CreateOrderParams, CreateOrderResult, MarketsResponse, MarketResponse, TradingPnL, UserPnL, TokenPnL, Erc20PnL, UserHistories, EnrichedPositionsResponse, OrderbookApiConfig, PaginatedOrdersResponse, MarketTradeItem, AuthChallenge } from "../../shared/types.js";
 /**
  * Unified HTTP client for orderbook, market, position, and history endpoints.
  */
@@ -64,9 +64,11 @@ export declare class OrderbookApi {
      */
     getMarket(marketId: string): Promise<MarketResponse["data"] | null>;
     /**
-     * Returns current user positions derived from vault activity.
+     * Returns enriched user positions including market name, instrument name,
+     * logo, collateral info, PnL, and role (isOPrm / isOpen).
+     * Also includes a `grouped` array keyed by market.
      */
-    getUserPositions(userAddress: string): Promise<UserPosition[]>;
+    getUserPositions(userAddress: string): Promise<EnrichedPositionsResponse>;
     /**
      * Returns realized trading PnL for limit-order activity.
      */
@@ -84,8 +86,9 @@ export declare class OrderbookApi {
      */
     getErc20PnL(userAddress: string, tokenAddress: string): Promise<Erc20PnL>;
     /**
-     * Returns grouped user history across mint, redeem, unwind, withdraw,
-     * rollover, transfer, fill, and cancel events.
+     * Returns grouped + enriched user history. Every event carries marketName,
+     * instrumentName, logoUri, collateralDecimals, collateralToken, and a `type`
+     * discriminator. The `timeline` field is a flat chronological list of all events.
      */
     getUserHistories(userAddress: string, opts?: {
         limit?: number;

package/dist/types/shared/types.d.ts

@@ -232,6 +232,44 @@ export interface UserPosition {
     redeemExercisePnl: string;
     updatedAt: string;
 }
+/**
+ * Market/instrument metadata the API attaches to positions and history events.
+ * All fields are optional so existing decoders stay backward-compatible.
+ */
+export interface EventEnrichment {
+    marketId?: string | null;
+    marketName?: string;
+    instrumentName?: string;
+    logoUri?: string | null;
+    collateralDecimals?: number;
+    collateralToken?: string;
+}
+/** Position enriched with market/instrument context returned by /positions. */
+export interface EnrichedPosition extends UserPosition, EventEnrichment {
+    /** true when holding > 0 */
+    isOpen: boolean;
+    /** true = oPRM (outcome position), false = PRM (write/minted) */
+    isOPrm: boolean;
+    marketId: string;
+    marketName: string;
+    instrumentName: string;
+    logoUri: string | null;
+    collateralDecimals: number;
+    collateralToken: string;
+}
+export interface EnrichedPositionsResponse {
+    /** Flat list sorted by updatedAt desc. */
+    positions: EnrichedPosition[];
+    /** Same positions grouped by market for convenient access. */
+    grouped: Array<{
+        marketId: string;
+        marketName: string;
+        logoUri: string | null;
+        collateralDecimals: number;
+        collateralToken: string;
+        positions: EnrichedPosition[];
+    }>;
+}
 export interface TradingPnL {
     id: string;
     asset: `0x${string}`;
@@ -274,7 +312,7 @@ export interface Erc20PnL {
     trading: TradingPnL | null;
     totalPnl: string;
 }
-export interface MintHistoryItem {
+export interface MintHistoryItem extends EventEnrichment {
     id: string;
     marketId: string;
     prmTokenId: string;
@@ -289,8 +327,9 @@ export interface MintHistoryItem {
     transactionHash: `0x${string}`;
     blockNumber: string;
     timestamp: string;
+    type?: "mint";
 }
-export interface RedeemHistoryItem {
+export interface RedeemHistoryItem extends EventEnrichment {
     id: string;
     oPrmTokenId: string;
     prmTokenId: string;
@@ -304,8 +343,9 @@ export interface RedeemHistoryItem {
     transactionHash: `0x${string}`;
     blockNumber: string;
     timestamp: string;
+    type?: "redeem";
 }
-export interface UnwindHistoryItem {
+export interface UnwindHistoryItem extends EventEnrichment {
     id: string;
     marketId: string;
     prmTokenId: string;
@@ -320,8 +360,9 @@ export interface UnwindHistoryItem {
     transactionHash: `0x${string}`;
     blockNumber: string;
     timestamp: string;
+    type?: "unwind";
 }
-export interface TransferHistoryItem {
+export interface TransferHistoryItem extends EventEnrichment {
     id: string;
     vaultId: string;
     caller: `0x${string}`;
@@ -333,8 +374,9 @@ export interface TransferHistoryItem {
     transactionHash: `0x${string}`;
     blockNumber: string;
     timestamp: string;
+    type?: "transfer";
 }
-export interface OrderFillHistoryItem {
+export interface OrderFillHistoryItem extends EventEnrichment {
     id: string;
     orderHash: `0x${string}`;
     maker: `0x${string}`;
@@ -353,10 +395,11 @@ export interface OrderFillHistoryItem {
     timestamp: string;
     /** true = ask (maker sells), false = bid (maker buys); from API when available */
     isAsk?: boolean;
+    type?: "fill";
 }
 /** Recent trade item as returned by getMarketRecentTrades */
 export type MarketTradeItem = OrderFillHistoryItem;
-export interface WithdrawHistoryItem {
+export interface WithdrawHistoryItem extends EventEnrichment {
     id: string;
     marketId: string;
     prmTokenId: string;
@@ -370,8 +413,9 @@ export interface WithdrawHistoryItem {
     transactionHash: `0x${string}`;
     blockNumber: string;
     timestamp: string;
+    type?: "withdraw";
 }
-export interface RolloverHistoryItem {
+export interface RolloverHistoryItem extends EventEnrichment {
     id: string;
     marketId: string;
     oldMarketId: string | null;
@@ -390,8 +434,9 @@ export interface RolloverHistoryItem {
     transactionHash: `0x${string}`;
     blockNumber: string;
     timestamp: string;
+    type?: "rollover";
 }
-export interface OrderCancelHistoryItem {
+export interface OrderCancelHistoryItem extends EventEnrichment {
     id: string;
     marketId: string;
     tokenId: string;
@@ -400,7 +445,9 @@ export interface OrderCancelHistoryItem {
     transactionHash: `0x${string}`;
     blockNumber: string;
     timestamp: string;
+    type?: "cancel";
 }
+export type AnyHistoryEvent = MintHistoryItem | RedeemHistoryItem | UnwindHistoryItem | WithdrawHistoryItem | RolloverHistoryItem | TransferHistoryItem | OrderFillHistoryItem | OrderCancelHistoryItem;
 export interface UserHistories {
     mints: MintHistoryItem[];
     redeems: RedeemHistoryItem[];
@@ -410,6 +457,12 @@ export interface UserHistories {
     transfers: TransferHistoryItem[];
     fills: OrderFillHistoryItem[];
     cancels: OrderCancelHistoryItem[];
+    /**
+     * All of the above merged and sorted chronologically (newest first).
+     * Each event has a `type` discriminator field.
+     * Populated by /history — may be absent on sub-routes like /history/mints.
+     */
+    timeline?: AnyHistoryEvent[];
 }
 export interface PaginatedOrdersResponse {
     orders: StoredOrder[];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@stryke-xyz/premarket-sdk",
-	"version": "1.1.4",
+	"version": "1.1.6",
 	"type": "module",
 	"module": "dist/esm/index.js",
 	"main": "dist/cjs/index.js",