@riocrypto/common-server 1.0.2766 → 1.0.2768

package/build/clients/cluster-client.d.ts

@@ -241,14 +241,16 @@ declare class ClusterClient {
         quantity: number;
         valueDate?: string;
         fiat?: string;
+        tradeKey: string;
     }): Promise<StonexFXTrade>;
-    takeStonexQuote(tradeId: string, side: "buy" | "sell"): Promise<StonexFXTrade>;
+    takeStonexQuote(tradeId: string, side: "buy" | "sell", tradeKey: string): Promise<StonexFXTrade>;
     cancelStonexTrade(tradeId: string): Promise<StonexFXTrade>;
     updateStonexOrder(tradeId: string, params: {
         quantity?: number;
         price?: number;
         stopPx?: number;
         timeInForce?: string;
+        tradeKey: string;
     }): Promise<StonexFXTrade>;
     placeStonexDirectOrder(params: {
         symbol: string;
@@ -261,8 +263,10 @@ declare class ClusterClient {
         stopPx?: number;
         valueDate?: string;
         execInst?: string;
+        tradeKey: string;
     }): Promise<StonexFXTrade>;
     getStonexTrade(tradeId: string): Promise<StonexFXTrade>;
+    getStonexTradeByKey(tradeKey: string): Promise<StonexFXTrade | null>;
     getStonexTrades(offset: number, limit: number): Promise<{
         data: StonexFXTrade[];
         hasMore: boolean;

package/build/clients/cluster-client.js

@@ -794,13 +794,24 @@ class ClusterClient {
     // ─── StoneX FIX ───────────────────────────────────────────────────
     createStonexTrade(data) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.axios.post(`${this.baseUrl}/api/stonex/create-quote-stream`, data, { headers: { "x-cluster-api-key": this.clusterApiKey } });
+            const { tradeKey } = data;
+            const response = yield this.axios.post(`${this.baseUrl}/api/stonex/create-quote-stream`, data, {
+                headers: {
+                    "x-cluster-api-key": this.clusterApiKey,
+                    "X-Trade-Key": tradeKey,
+                },
+            });
             return response.data;
         });
     }
-    takeStonexQuote(tradeId, side) {
+    takeStonexQuote(tradeId, side, tradeKey) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.axios.post(`${this.baseUrl}/api/stonex/take-quote/${tradeId}`, { side }, { headers: { "x-cluster-api-key": this.clusterApiKey } });
+            const response = yield this.axios.post(`${this.baseUrl}/api/stonex/take-quote/${tradeId}`, { side, tradeKey }, {
+                headers: {
+                    "x-cluster-api-key": this.clusterApiKey,
+                    "X-Trade-Key": tradeKey,
+                },
+            });
             return response.data;
         });
     }
@@ -812,13 +823,25 @@ class ClusterClient {
     }
     updateStonexOrder(tradeId, params) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.axios.post(`${this.baseUrl}/api/stonex/update-order/${tradeId}`, params, { headers: { "x-cluster-api-key": this.clusterApiKey } });
+            const { tradeKey } = params;
+            const response = yield this.axios.post(`${this.baseUrl}/api/stonex/update-order/${tradeId}`, params, {
+                headers: {
+                    "x-cluster-api-key": this.clusterApiKey,
+                    "X-Trade-Key": tradeKey,
+                },
+            });
             return response.data;
         });
     }
     placeStonexDirectOrder(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.axios.post(`${this.baseUrl}/api/stonex/place-order`, params, { headers: { "x-cluster-api-key": this.clusterApiKey } });
+            const { tradeKey } = params;
+            const response = yield this.axios.post(`${this.baseUrl}/api/stonex/place-order`, params, {
+                headers: {
+                    "x-cluster-api-key": this.clusterApiKey,
+                    "X-Trade-Key": tradeKey,
+                },
+            });
             return response.data;
         });
     }
@@ -828,6 +851,29 @@ class ClusterClient {
             return response.data;
         });
     }
+    // Reconcile helper: look up a Stonex trade by caller-supplied trade key.
+    // Returns null when the key has no matching trade (the server either
+    // never received the request or failed before persisting). External-trading
+    // calls this before stamping a local trade as Failed so a lost HTTP
+    // response does not desync the two systems.
+    getStonexTradeByKey(tradeKey) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const response = yield this.axios.get(`${this.baseUrl}/api/stonex/trades/by-trade-key/${encodeURIComponent(tradeKey)}`, { headers: { "x-cluster-api-key": this.clusterApiKey } });
+                return response.data;
+            }
+            catch (err) {
+                if (typeof err === "object" &&
+                    err !== null &&
+                    "response" in err &&
+                    ((_a = err.response) === null || _a === void 0 ? void 0 : _a.status) === 404) {
+                    return null;
+                }
+                throw err;
+            }
+        });
+    }
     getStonexTrades(offset, limit) {
         return __awaiter(this, void 0, void 0, function* () {
             const response = yield this.axios.get(`${this.baseUrl}/api/stonex/trades?offset=${offset}&limit=${limit}`, { headers: { "x-cluster-api-key": this.clusterApiKey } });

package/build/models/external-trade.d.ts

@@ -3,6 +3,7 @@ import { Mongoose, Model, Document, HydratedDocument } from "mongoose";
 interface ExternalTradeAttrs {
     createdAt: Date;
     providerOrderId?: string;
+    tradeKey?: string;
     type: ExternalTradeType;
     side: Side;
     provider: ExternalTradingProvider;
@@ -31,6 +32,7 @@ interface ExternalTradeAttrs {
             ordType?: string;
             amountReceived?: number;
             stopPx?: number;
+            takeQuoteTradeKey?: string;
         };
     };
     externalTradingAlgorithmId?: string;
@@ -40,6 +42,7 @@ interface ExternalTradeAttrs {
 interface ExternalTradeDoc extends Document {
     createdAt: Date;
     providerOrderId?: string;
+    tradeKey?: string;
     type: ExternalTradeType;
     side: Side;
     amountType: ExternalTradeAmountType;
@@ -69,6 +72,7 @@ interface ExternalTradeDoc extends Document {
             ordType?: string;
             amountReceived?: number;
             stopPx?: number;
+            takeQuoteTradeKey?: string;
         };
     };
     externalTradingAlgorithmId?: string;

package/build/models/external-trade.js

@@ -14,6 +14,9 @@ const buildExternalTrade = (mongoose) => {
         providerOrderId: {
             type: String,
         },
+        tradeKey: {
+            type: String,
+        },
         requestedAmountType: {
             type: String,
             required: true,
@@ -87,6 +90,18 @@ const buildExternalTrade = (mongoose) => {
             },
         },
     });
+    // Partial unique compound index: guarantees at most one ExternalTrade per
+    // (provider, tradeKey) pair. Legacy rows without tradeKey are
+    // excluded by the partial filter, so no backfill is required.
+    ExternalTradeSchema.index({ provider: 1, tradeKey: 1 }, {
+        unique: true,
+        partialFilterExpression: { tradeKey: { $type: "string" } },
+    });
+    // Defense-in-depth: at most one ExternalTrade per (provider, providerOrderId).
+    ExternalTradeSchema.index({ provider: 1, providerOrderId: 1 }, {
+        unique: true,
+        partialFilterExpression: { providerOrderId: { $type: "string" } },
+    });
     ExternalTradeSchema.statics.build = (attrs) => {
         return new ExternalTrade(attrs);
     };

package/build/models/stonex-fx-trade.d.ts

@@ -30,6 +30,10 @@ interface StonexFXTradeAttrs {
     expireTime?: string;
     leavesQty?: number;
     avgPx?: number;
+    tradeKey?: string;
+    takeQuoteTradeKey?: string;
+    fixSubmitted?: boolean;
+    submitAttempts?: number;
 }
 interface StonexFXTradeDoc extends Document {
     id: string;
@@ -62,6 +66,10 @@ interface StonexFXTradeDoc extends Document {
     expireTime?: string;
     leavesQty?: number;
     avgPx?: number;
+    tradeKey?: string;
+    takeQuoteTradeKey?: string;
+    fixSubmitted?: boolean;
+    submitAttempts?: number;
 }
 interface StonexFXTradeModel extends Model<StonexFXTradeDoc> {
     build(attrs: StonexFXTradeAttrs): StonexFXTradeDoc;

package/build/models/stonex-fx-trade.js

@@ -99,6 +99,20 @@ const buildStonexFXTrade = (mongoose) => {
         avgPx: {
             type: Number,
         },
+        tradeKey: {
+            type: String,
+        },
+        takeQuoteTradeKey: {
+            type: String,
+        },
+        fixSubmitted: {
+            type: Boolean,
+            default: false,
+        },
+        submitAttempts: {
+            type: Number,
+            default: 0,
+        },
         metadata: {
             type: Map,
             of: mongoose.Schema.Types.Mixed,
@@ -112,6 +126,19 @@ const buildStonexFXTrade = (mongoose) => {
             },
         },
     });
+    // Partial unique index: only docs with a string tradeKey are indexed,
+    // so existing docs (no field) don't collide. Guarantees at most one StonexFXTrade
+    // per caller-supplied trade key.
+    StonexFXTradeSchema.index({ tradeKey: 1 }, {
+        unique: true,
+        partialFilterExpression: { tradeKey: { $type: "string" } },
+    });
+    StonexFXTradeSchema.index({ takeQuoteTradeKey: 1 }, {
+        unique: true,
+        partialFilterExpression: {
+            takeQuoteTradeKey: { $type: "string" },
+        },
+    });
     StonexFXTradeSchema.statics.build = (attrs) => {
         return new StonexFXTrade(attrs);
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riocrypto/common-server",
-  "version": "1.0.2766",
+  "version": "1.0.2768",
   "description": "",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
@@ -24,7 +24,7 @@
     "@google-cloud/secret-manager": "^5.6.0",
     "@google-cloud/storage": "^7.19.0",
     "@hyperdx/node-opentelemetry": "^0.10.3",
-    "@riocrypto/common": "1.0.2563",
+    "@riocrypto/common": "1.0.2565",
     "@slack/web-api": "^7.15.0",
     "@types/express": "^4.17.25",
     "axios": "1.13.6",