@medialane/sdk 0.21.0 → 0.23.0

package/dist/index.d.cts

@@ -496,7 +496,15 @@ interface ApiCollectionsQuery {
     /** Filter by service id. */
     service?: string;
 }
-type OrderStatus = "ACTIVE" | "FULFILLED" | "CANCELLED" | "EXPIRED" | "COUNTER_OFFERED";
+/**
+ * Order lifecycle states. **Four canonical values** per `01-core-model §V`.
+ *
+ * The legacy `"COUNTER_OFFERED"` value was removed in 0.23.0 (audit P0-1
+ * Phase D). Counter-offers are linked orders via `parentOrderHash`, not a
+ * third lifecycle state on the parent bid. Use `ApiOrder.hasActiveCounterOffer`
+ * (added in 0.22.0) for the "this bid has been countered" affordance.
+ */
+type OrderStatus = "ACTIVE" | "FULFILLED" | "CANCELLED" | "EXPIRED";
 type SortOrder = "price_asc" | "price_desc" | "recent";
 type ActivityType = "mint" | "transfer" | "sale" | "listing" | "offer" | "cancelled";
 type IntentType = "CREATE_LISTING" | "MAKE_OFFER" | "FULFILL_ORDER" | "CANCEL_ORDER" | "MINT" | "CREATE_COLLECTION" | "COUNTER_OFFER";
@@ -573,10 +581,21 @@ interface ApiOrder {
     updatedAt: string;
     /** Embedded token metadata (name/image/description). Null when not yet indexed. */
     token: ApiOrderTokenMeta | null;
-    /** Set when this is a counter-offer listing — points to the original buyer bid. */
+    /** Set when this is a counter-offer listing — points to the original buyer bid.
+     *  Now always emitted by the backend (was conditional); kept optional in the
+     *  type for back-compat with older response shapes. */
     parentOrderHash?: string | null;
     /** Optional seller message accompanying a counter-offer. */
     counterOfferMessage?: string | null;
+    /** True when this order is a bid (ERC-20 offer) AND at least one ACTIVE counter
+     *  exists with `parentOrderHash = this.orderHash`. Set by endpoints that compute
+     *  it (currently `GET /v1/orders/user/:address` and `GET /v1/orders/:orderHash`);
+     *  undefined on endpoints that don't.
+     *
+     *  Use this instead of `status === "COUNTER_OFFERED"` for "this bid has been
+     *  countered" affordances. The status pattern is being phased out per
+     *  01-core-model §V — counter-offers are linked orders, not a lifecycle state. */
+    hasActiveCounterOffer?: boolean;
 }
 /**
  * A single OpenSea-compatible ERC-721 attribute.

package/dist/index.d.ts

@@ -496,7 +496,15 @@ interface ApiCollectionsQuery {
     /** Filter by service id. */
     service?: string;
 }
-type OrderStatus = "ACTIVE" | "FULFILLED" | "CANCELLED" | "EXPIRED" | "COUNTER_OFFERED";
+/**
+ * Order lifecycle states. **Four canonical values** per `01-core-model §V`.
+ *
+ * The legacy `"COUNTER_OFFERED"` value was removed in 0.23.0 (audit P0-1
+ * Phase D). Counter-offers are linked orders via `parentOrderHash`, not a
+ * third lifecycle state on the parent bid. Use `ApiOrder.hasActiveCounterOffer`
+ * (added in 0.22.0) for the "this bid has been countered" affordance.
+ */
+type OrderStatus = "ACTIVE" | "FULFILLED" | "CANCELLED" | "EXPIRED";
 type SortOrder = "price_asc" | "price_desc" | "recent";
 type ActivityType = "mint" | "transfer" | "sale" | "listing" | "offer" | "cancelled";
 type IntentType = "CREATE_LISTING" | "MAKE_OFFER" | "FULFILL_ORDER" | "CANCEL_ORDER" | "MINT" | "CREATE_COLLECTION" | "COUNTER_OFFER";
@@ -573,10 +581,21 @@ interface ApiOrder {
     updatedAt: string;
     /** Embedded token metadata (name/image/description). Null when not yet indexed. */
     token: ApiOrderTokenMeta | null;
-    /** Set when this is a counter-offer listing — points to the original buyer bid. */
+    /** Set when this is a counter-offer listing — points to the original buyer bid.
+     *  Now always emitted by the backend (was conditional); kept optional in the
+     *  type for back-compat with older response shapes. */
     parentOrderHash?: string | null;
     /** Optional seller message accompanying a counter-offer. */
     counterOfferMessage?: string | null;
+    /** True when this order is a bid (ERC-20 offer) AND at least one ACTIVE counter
+     *  exists with `parentOrderHash = this.orderHash`. Set by endpoints that compute
+     *  it (currently `GET /v1/orders/user/:address` and `GET /v1/orders/:orderHash`);
+     *  undefined on endpoints that don't.
+     *
+     *  Use this instead of `status === "COUNTER_OFFERED"` for "this bid has been
+     *  countered" affordances. The status pattern is being phased out per
+     *  01-core-model §V — counter-offers are linked orders, not a lifecycle state. */
+    hasActiveCounterOffer?: boolean;
 }
 /**
  * A single OpenSea-compatible ERC-721 attribute.