@riocrypto/common-server 1.0.2932 → 1.0.2934

package/build/index.d.ts

@@ -90,6 +90,7 @@ export * from "./models/STP-deposit-CLABE";
 export * from "./models/STP-settings";
 export * from "./models/fintoc-mxn-withdrawal";
 export * from "./models/fintoc-deposit-CLABE";
+export * from "./models/fintoc-deposit-intake";
 export * from "./models/processor-readiness";
 export * from "./models/payment-address-verification";
 export * from "./models/alfin-virtual-cci";

package/build/index.js

@@ -106,6 +106,7 @@ __exportStar(require("./models/STP-deposit-CLABE"), exports);
 __exportStar(require("./models/STP-settings"), exports);
 __exportStar(require("./models/fintoc-mxn-withdrawal"), exports);
 __exportStar(require("./models/fintoc-deposit-CLABE"), exports);
+__exportStar(require("./models/fintoc-deposit-intake"), exports);
 __exportStar(require("./models/processor-readiness"), exports);
 __exportStar(require("./models/payment-address-verification"), exports);
 __exportStar(require("./models/alfin-virtual-cci"), exports);

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

@@ -1,9 +1,17 @@
 import { Fiat, Side, Crypto, ExternalTradeType, ExternalTradingProvider, ExternalTradeStatus, ExternalTradeAmountType, EmarketsSettlementType, LmaxOrderType, LmaxSide, LmaxTimeInForce } from "@riocrypto/common";
 import { Mongoose, Model, Document, HydratedDocument } from "mongoose";
+interface ExternalTradeImportMeta {
+    fileName?: string;
+    importedBy?: string;
+    importedAt: Date;
+    providerOrderIdIsSynthetic?: boolean;
+    sourceRow?: Record<string, string>;
+}
 interface ExternalTradeAttrs {
     createdAt: Date;
     providerOrderId?: string;
     tradeKey?: string;
+    valueDate?: string;
     type: ExternalTradeType;
     side: Side;
     provider: ExternalTradingProvider;
@@ -72,11 +80,13 @@ interface ExternalTradeAttrs {
     externalTradingAlgorithmId?: string;
     arbitrageSessionId?: string;
     isImported?: boolean;
+    importMeta?: ExternalTradeImportMeta;
 }
 interface ExternalTradeDoc extends Document {
     createdAt: Date;
     providerOrderId?: string;
     tradeKey?: string;
+    valueDate?: string;
     type: ExternalTradeType;
     side: Side;
     amountType: ExternalTradeAmountType;
@@ -146,9 +156,10 @@ interface ExternalTradeDoc extends Document {
     externalTradingAlgorithmId?: string;
     arbitrageSessionId?: string;
     isImported?: boolean;
+    importMeta?: ExternalTradeImportMeta;
 }
 interface ExternalTradeModel extends Model<ExternalTradeDoc> {
     build(attrs: ExternalTradeAttrs): HydratedDocument<ExternalTradeDoc>;
 }
 declare const buildExternalTrade: (mongoose: Mongoose) => ExternalTradeModel;
-export { buildExternalTrade, ExternalTradeDoc, ExternalTradeAttrs };
+export { buildExternalTrade, ExternalTradeDoc, ExternalTradeAttrs, ExternalTradeImportMeta, };

package/build/models/external-trade.js

@@ -17,6 +17,9 @@ const buildExternalTrade = (mongoose) => {
         tradeKey: {
             type: String,
         },
+        valueDate: {
+            type: String,
+        },
         requestedAmountType: {
             type: String,
             required: true,
@@ -90,6 +93,9 @@ const buildExternalTrade = (mongoose) => {
             type: Boolean,
             default: false,
         },
+        importMeta: {
+            type: Object,
+        },
     }, {
         toJSON: {
             transform(doc, ret) {

package/build/models/fintoc-deposit-intake.d.ts

@@ -0,0 +1,39 @@
+import { Mongoose, Model, Document, HydratedDocument } from "mongoose";
+export declare enum FintocDepositIntakeStatus {
+    /** Recorded, waiting for the worker. */
+    Pending = "pending",
+    /** A worker has taken it. Reset to pending if left here too long. */
+    Processing = "processing",
+    /** Matching ran to completion, whatever it concluded. See `outcome`. */
+    Done = "done",
+    /** Matching threw and retries are exhausted. Needs a person. */
+    Failed = "failed"
+}
+export type FintocDepositIntakeSource = "webhook" | "poller";
+interface FintocDepositIntakeAttrs {
+    fintocTransferId: string;
+    source: FintocDepositIntakeSource;
+    /** Fintoc's webhook event id, for tracing back to their dashboard. */
+    fintocEventId?: string;
+    receivedAt: Date;
+}
+interface FintocDepositIntakeDoc extends Document {
+    fintocTransferId: string;
+    source: FintocDepositIntakeSource;
+    fintocEventId?: string;
+    status: FintocDepositIntakeStatus;
+    attempts: number;
+    /** The `reason` processInboundFintocDeposit returned, once it has run. */
+    outcome?: string;
+    /** Whether that run published a payment, as opposed to skipping or rejecting. */
+    processed?: boolean;
+    lastError?: string;
+    receivedAt: Date;
+    startedAt?: Date;
+    finishedAt?: Date;
+}
+interface FintocDepositIntakeModel extends Model<FintocDepositIntakeDoc> {
+    build(attrs: FintocDepositIntakeAttrs): HydratedDocument<FintocDepositIntakeDoc>;
+}
+declare const buildFintocDepositIntake: (mongoose: Mongoose) => FintocDepositIntakeModel;
+export { buildFintocDepositIntake, FintocDepositIntakeDoc, FintocDepositIntakeAttrs, };

package/build/models/fintoc-deposit-intake.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildFintocDepositIntake = exports.FintocDepositIntakeStatus = void 0;
+// One row per inbound Fintoc transfer, written the moment we learn the transfer
+// exists and before any work is done on it. This is what lets a deposit survive
+// the pod being killed mid-processing: the webhook only records that the transfer
+// arrived, and a worker does the matching from here, so a restart resumes rather
+// than forgets. It is a processing ledger, not an accounting record; the money
+// itself is recorded in InboundBankDeposit once matching has run.
+var FintocDepositIntakeStatus;
+(function (FintocDepositIntakeStatus) {
+    /** Recorded, waiting for the worker. */
+    FintocDepositIntakeStatus["Pending"] = "pending";
+    /** A worker has taken it. Reset to pending if left here too long. */
+    FintocDepositIntakeStatus["Processing"] = "processing";
+    /** Matching ran to completion, whatever it concluded. See `outcome`. */
+    FintocDepositIntakeStatus["Done"] = "done";
+    /** Matching threw and retries are exhausted. Needs a person. */
+    FintocDepositIntakeStatus["Failed"] = "failed";
+})(FintocDepositIntakeStatus = exports.FintocDepositIntakeStatus || (exports.FintocDepositIntakeStatus = {}));
+// Finished rows are kept a month for tracing a payment that went wrong, then
+// dropped. Rows that never finish have no finishedAt and so never expire, which is
+// the point: an unfinished deposit should stay visible until someone deals with it.
+const FINISHED_ROW_TTL_SECONDS = 30 * 24 * 60 * 60;
+const buildFintocDepositIntake = (mongoose) => {
+    if (mongoose.models.FintocDepositIntake) {
+        return mongoose.model("FintocDepositIntake");
+    }
+    const FintocDepositIntakeSchema = new mongoose.Schema({
+        fintocTransferId: {
+            type: String,
+            required: true,
+        },
+        source: {
+            type: String,
+            required: true,
+            enum: ["webhook", "poller"],
+        },
+        fintocEventId: {
+            type: String,
+        },
+        status: {
+            type: String,
+            required: true,
+            enum: Object.values(FintocDepositIntakeStatus),
+            default: FintocDepositIntakeStatus.Pending,
+        },
+        attempts: {
+            type: Number,
+            required: true,
+            default: 0,
+        },
+        outcome: {
+            type: String,
+        },
+        processed: {
+            type: Boolean,
+        },
+        lastError: {
+            type: String,
+        },
+        receivedAt: {
+            type: Date,
+            required: true,
+        },
+        startedAt: {
+            type: Date,
+        },
+        finishedAt: {
+            type: Date,
+        },
+    }, {
+        toJSON: {
+            transform(doc, ret) {
+                ret.id = ret._id.valueOf();
+                delete ret._id;
+                delete ret.__v;
+            },
+        },
+    });
+    // The dedup. A webhook delivered twice, or a transfer the poller sees after the
+    // webhook already recorded it, is an insert that fails rather than a second row.
+    FintocDepositIntakeSchema.index({ fintocTransferId: 1 }, { unique: true });
+    // What the worker polls on: the oldest pending row first, and the processing rows
+    // whose startedAt says their owner died.
+    FintocDepositIntakeSchema.index({ status: 1, receivedAt: 1 });
+    FintocDepositIntakeSchema.index({ status: 1, startedAt: 1 });
+    FintocDepositIntakeSchema.index({ finishedAt: 1 }, { expireAfterSeconds: FINISHED_ROW_TTL_SECONDS });
+    FintocDepositIntakeSchema.statics.build = (attrs) => {
+        return new FintocDepositIntake(attrs);
+    };
+    const FintocDepositIntake = mongoose.model("FintocDepositIntake", FintocDepositIntakeSchema);
+    return FintocDepositIntake;
+};
+exports.buildFintocDepositIntake = buildFintocDepositIntake;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riocrypto/common-server",
-  "version": "1.0.2932",
+  "version": "1.0.2934",
   "description": "",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",