modern-treasury 0.0.1

package/dist/cjs/resources/transactions.d.ts

@@ -0,0 +1,377 @@
+import * as Core from '../core';
+import { APIResource } from '../resource';
+import { Page, PageParams } from '../pagination';
+export declare class Transactions extends APIResource {
+  /**
+   * Get details on a single transaction.
+   */
+  retrieve(id: string, options?: Core.RequestOptions): Promise<Core.APIResponse<Transaction>>;
+  /**
+   * Update a single transaction.
+   */
+  update(
+    id: string,
+    body?: TransactionUpdateParams,
+    options?: Core.RequestOptions,
+  ): Promise<Core.APIResponse<Transaction>>;
+  update(id: string, options?: Core.RequestOptions): Promise<Core.APIResponse<Transaction>>;
+  /**
+   * Get a list of all transactions.
+   */
+  list(query?: TransactionListParams, options?: Core.RequestOptions): Core.PagePromise<TransactionsPage>;
+  list(options?: Core.RequestOptions): Core.PagePromise<TransactionsPage>;
+}
+export declare class TransactionsPage extends Page<Transaction> {}
+export interface Transaction {
+  /**
+   * Value in specified currency's smallest unit. e.g. $10 would be represented
+   * as 1000.
+   */
+  amount?: number;
+  /**
+   * The date on which the transaction occurred.
+   */
+  as_of_date?: string | null;
+  /**
+   * The time on which the transaction occurred. Depending on the granularity of the
+   * timestamp information received from the bank, it may be `null`.
+   */
+  as_of_time?: string | null;
+  created_at?: string;
+  /**
+   * Currency that this transaction is denominated in.
+   */
+  currency?:
+    | 'AED'
+    | 'AFN'
+    | 'ALL'
+    | 'AMD'
+    | 'ANG'
+    | 'AOA'
+    | 'ARS'
+    | 'AUD'
+    | 'AWG'
+    | 'AZN'
+    | 'BAM'
+    | 'BBD'
+    | 'BCH'
+    | 'BDT'
+    | 'BGN'
+    | 'BHD'
+    | 'BIF'
+    | 'BMD'
+    | 'BND'
+    | 'BOB'
+    | 'BRL'
+    | 'BSD'
+    | 'BTC'
+    | 'BTN'
+    | 'BWP'
+    | 'BYN'
+    | 'BYR'
+    | 'BZD'
+    | 'CAD'
+    | 'CDF'
+    | 'CHF'
+    | 'CLF'
+    | 'CLP'
+    | 'CNH'
+    | 'CNY'
+    | 'COP'
+    | 'CRC'
+    | 'CUC'
+    | 'CUP'
+    | 'CVE'
+    | 'CZK'
+    | 'DJF'
+    | 'DKK'
+    | 'DOP'
+    | 'DZD'
+    | 'EEK'
+    | 'EGP'
+    | 'ERN'
+    | 'ETB'
+    | 'EUR'
+    | 'FJD'
+    | 'FKP'
+    | 'GBP'
+    | 'GBX'
+    | 'GEL'
+    | 'GGP'
+    | 'GHS'
+    | 'GIP'
+    | 'GMD'
+    | 'GNF'
+    | 'GTQ'
+    | 'GYD'
+    | 'HKD'
+    | 'HNL'
+    | 'HRK'
+    | 'HTG'
+    | 'HUF'
+    | 'IDR'
+    | 'ILS'
+    | 'IMP'
+    | 'INR'
+    | 'IQD'
+    | 'IRR'
+    | 'ISK'
+    | 'JEP'
+    | 'JMD'
+    | 'JOD'
+    | 'JPY'
+    | 'KES'
+    | 'KGS'
+    | 'KHR'
+    | 'KMF'
+    | 'KPW'
+    | 'KRW'
+    | 'KWD'
+    | 'KYD'
+    | 'KZT'
+    | 'LAK'
+    | 'LBP'
+    | 'LKR'
+    | 'LRD'
+    | 'LSL'
+    | 'LTL'
+    | 'LVL'
+    | 'LYD'
+    | 'MAD'
+    | 'MDL'
+    | 'MGA'
+    | 'MKD'
+    | 'MMK'
+    | 'MNT'
+    | 'MOP'
+    | 'MRO'
+    | 'MRU'
+    | 'MTL'
+    | 'MUR'
+    | 'MVR'
+    | 'MWK'
+    | 'MXN'
+    | 'MYR'
+    | 'MZN'
+    | 'NAD'
+    | 'NGN'
+    | 'NIO'
+    | 'NOK'
+    | 'NPR'
+    | 'NZD'
+    | 'OMR'
+    | 'PAB'
+    | 'PEN'
+    | 'PGK'
+    | 'PHP'
+    | 'PKR'
+    | 'PLN'
+    | 'PYG'
+    | 'QAR'
+    | 'RON'
+    | 'RSD'
+    | 'RUB'
+    | 'RWF'
+    | 'SAR'
+    | 'SBD'
+    | 'SCR'
+    | 'SDG'
+    | 'SEK'
+    | 'SGD'
+    | 'SHP'
+    | 'SKK'
+    | 'SLL'
+    | 'SOS'
+    | 'SRD'
+    | 'SSP'
+    | 'STD'
+    | 'SVC'
+    | 'SYP'
+    | 'SZL'
+    | 'THB'
+    | 'TJS'
+    | 'TMM'
+    | 'TMT'
+    | 'TND'
+    | 'TOP'
+    | 'TRY'
+    | 'TTD'
+    | 'TWD'
+    | 'TZS'
+    | 'UAH'
+    | 'UGX'
+    | 'USD'
+    | 'UYU'
+    | 'UZS'
+    | 'VEF'
+    | 'VES'
+    | 'VND'
+    | 'VUV'
+    | 'WST'
+    | 'XAF'
+    | 'XAG'
+    | 'XAU'
+    | 'XBA'
+    | 'XBB'
+    | 'XBC'
+    | 'XBD'
+    | 'XCD'
+    | 'XDR'
+    | 'XFU'
+    | 'XOF'
+    | 'XPD'
+    | 'XPF'
+    | 'XPT'
+    | 'XTS'
+    | 'YER'
+    | 'ZAR'
+    | 'ZMK'
+    | 'ZMW'
+    | 'ZWD'
+    | 'ZWL'
+    | 'ZWN'
+    | 'ZWR';
+  /**
+   * This field contains additional information that the bank provided about the
+   * transaction. This is structured data. Some of the data in here might overlap
+   * with what is in the `vendor_description`. For example, the OBI could be a part
+   * of the vendor description, and it would also be included in here. The attributes
+   * that are passed through the details field will vary based on your banking
+   * partner. Currently, the following keys may be in the details object:
+   * `originator_name`, `originator_to_beneficiary_information`.
+   */
+  details?: Record<string, string>;
+  /**
+   * Either `credit` or `debit`.
+   */
+  direction?: string;
+  discarded_at?: string | null;
+  id?: string;
+  /**
+   * The ID of the relevant Internal Account.
+   */
+  internal_account_id?: string;
+  /**
+   * This field will be true if this object exists in the live environment or false
+   * if it exists in the test environment.
+   */
+  live_mode?: boolean;
+  /**
+   * Additional data represented as key-value pairs. Both the key and value must be
+   * strings.
+   */
+  metadata?: Record<string, string>;
+  object?: string;
+  /**
+   * This field will be `true` if the transaction has posted to the account.
+   */
+  posted?: boolean;
+  /**
+   * This field will be `true` if a transaction is reconciled by the Modern Treasury
+   * system. This means that it has transaction line items that sum up to the
+   * transaction's amount.
+   */
+  reconciled?: boolean;
+  /**
+   * The type of the transaction. Can be one of `ach`, `wire`, `check`, `rtp`,
+   * `book`, or `sen`.
+   */
+  type?:
+    | 'ach'
+    | 'au_becs'
+    | 'bacs'
+    | 'book'
+    | 'card'
+    | 'check'
+    | 'eft'
+    | 'interac'
+    | 'provxchange'
+    | 'rtp'
+    | 'sen'
+    | 'sepa'
+    | 'signet'
+    | 'wire';
+  updated_at?: string;
+  /**
+   * When applicable, the bank-given code that determines the transaction's category.
+   * For most banks this is the BAI2/BTRS transaction code.
+   */
+  vendor_code?: string | null;
+  /**
+   * The type of vendor_code being reported. Can be one of `bai2`, `swift`,
+   * `cleartouch`, or `silvergate`.
+   */
+  vendor_code_type?:
+    | 'bai2'
+    | 'bankprov'
+    | 'bnk_dev'
+    | 'cleartouch'
+    | 'cross_river'
+    | 'currencycloud'
+    | 'dc_bank'
+    | 'dwolla'
+    | 'goldman_sachs'
+    | 'iso20022'
+    | 'jpmc'
+    | 'mx'
+    | 'signet'
+    | 'silvergate'
+    | 'swift'
+    | null;
+  /**
+   * An identifier given to this transaction by the bank, often `null`.
+   */
+  vendor_customer_id?: string | null;
+  /**
+   * The transaction detail text that often appears in on your bank statement and in
+   * your banking portal.
+   */
+  vendor_description?: string | null;
+  /**
+   * An identifier given to this transaction by the bank.
+   */
+  vendor_id?: string | null;
+}
+export interface TransactionUpdateParams {
+  /**
+   * Additional data in the form of key-value pairs. Pairs can be removed by passing
+   * an empty string or `null` as the value.
+   */
+  metadata?: Record<string, string>;
+}
+export interface TransactionListParams extends PageParams {
+  /**
+   * Filters transactions with an `as_of_date` starting on or before the specified
+   * date (YYYY-MM-DD).
+   */
+  as_of_date_end?: string;
+  /**
+   * Filters transactions with an `as_of_date` starting on or after the specified
+   * date (YYYY-MM-DD).
+   */
+  as_of_date_start?: string;
+  counterparty_id?: string;
+  /**
+   * Filters for transactions including the queried string in the description.
+   */
+  description?: string;
+  direction?: string;
+  /**
+   * Specify `internal_account_id` if you wish to see transactions to/from a specific
+   * account.
+   */
+  internal_account_id?: string;
+  /**
+   * For example, if you want to query for records with metadata key `Type` and value
+   * `Loan`, the query would be `metadata%5BType%5D=Loan`. This encodes the query
+   * parameters.
+   */
+  metadata?: Record<string, string>;
+  payment_type?: string;
+  /**
+   * Either `true` or `false`.
+   */
+  posted?: boolean;
+  transactable_type?: string;
+  virtual_account_id?: string;
+}

package/dist/cjs/resources/transactions.js

@@ -0,0 +1,31 @@
+'use strict';
+// File generated from our OpenAPI spec by Stainless.
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.TransactionsPage = exports.Transactions = void 0;
+const resource_1 = require('../resource');
+const core_1 = require('../core');
+const pagination_1 = require('../pagination');
+class Transactions extends resource_1.APIResource {
+  /**
+   * Get details on a single transaction.
+   */
+  retrieve(id, options) {
+    return this.get(`/api/transactions/${id}`, options);
+  }
+  update(id, body = {}, options) {
+    if ((0, core_1.isRequestOptions)(body)) {
+      return this.update(id, {}, body);
+    }
+    return this.patch(`/api/transactions/${id}`, Object.assign({ body }, options));
+  }
+  list(query = {}, options) {
+    if ((0, core_1.isRequestOptions)(query)) {
+      return this.list({}, query);
+    }
+    return this.getAPIList('/api/transactions', TransactionsPage, Object.assign({ query }, options));
+  }
+}
+exports.Transactions = Transactions;
+class TransactionsPage extends pagination_1.Page {}
+exports.TransactionsPage = TransactionsPage;
+//# sourceMappingURL=transactions.js.map

package/dist/cjs/resources/transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../../../resources/transactions.ts"],"names":[],"mappings":";AAAA,qDAAqD;;;AAGrD,yCAAyC;AACzC,iCAA0C;AAC1C,6CAAgD;AAEhD,MAAa,YAAa,SAAQ,sBAAW;IAC3C;;OAEG;IACH,QAAQ,CAAC,EAAU,EAAE,OAA6B;QAChD,OAAO,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAWD,MAAM,CACJ,EAAU,EACV,OAAsD,EAAE,EACxD,OAA6B;QAE7B,IAAI,IAAA,uBAAgB,EAAC,IAAI,CAAC,EAAE;YAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;SAClC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,kBAAI,IAAI,IAAK,OAAO,EAAG,CAAC;IACrE,CAAC;IAOD,IAAI,CACF,QAAqD,EAAE,EACvD,OAA6B;QAE7B,IAAI,IAAA,uBAAgB,EAAC,KAAK,CAAC,EAAE;YAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;SAC7B;QAED,OAAO,IAAI,CAAC,UAAU,CAAC,mBAAmB,EAAE,gBAAgB,kBAAI,KAAK,IAAK,OAAO,EAAG,CAAC;IACvF,CAAC;CACF;AA5CD,oCA4CC;AAED,MAAa,gBAAiB,SAAQ,iBAAiB;CAAG;AAA1D,4CAA0D"}

package/dist/cjs/resources/validations.d.ts

@@ -0,0 +1,97 @@
+import * as Core from '../core';
+import { APIResource } from '../resource';
+export declare class Validations extends APIResource {
+  /**
+   * Validates the routing number information supplied without creating a routing
+   * detail
+   */
+  validateRoutingNumber(
+    query: ValidationValidateRoutingNumberParams,
+    options?: Core.RequestOptions,
+  ): Promise<Core.APIResponse<RoutingNumberLookupRequest>>;
+}
+export interface RoutingNumberLookupRequest {
+  /**
+   * The address of the bank.
+   */
+  bank_address?: RoutingNumberLookupRequest.BankAddress;
+  /**
+   * The name of the bank.
+   */
+  bank_name?: string;
+  /**
+   * The routing number of the bank.
+   */
+  routing_number?: string;
+  /**
+   * One of `aba`, `au_bsb`, `br_codigo`, `ca_cpa`, `cnaps`, `gb_sort_code`,
+   * `in_ifsc`, `my_branch_code`, or `swift`. In sandbox mode we currently only
+   * support `aba` and `swift` with routing numbers '123456789' and 'GRINUST0XXX'
+   * respectively.
+   */
+  routing_number_type?: 'aba' | 'au_bsb' | 'ca_cpa' | 'gb_sort_code' | 'swift';
+  /**
+   * An array of payment types that are supported for this routing number. This can
+   * include `ach`, `wire`, `rtp`, `sepa`, `bacs`, `au_becs` currently.
+   */
+  supported_payment_types?: Array<
+    | 'ach'
+    | 'au_becs'
+    | 'bacs'
+    | 'book'
+    | 'card'
+    | 'check'
+    | 'eft'
+    | 'interac'
+    | 'provxchange'
+    | 'rtp'
+    | 'sen'
+    | 'sepa'
+    | 'signet'
+    | 'wire'
+  >;
+}
+export declare namespace RoutingNumberLookupRequest {
+  interface BankAddress {
+    /**
+     * Country code conforms to [ISO 3166-1 alpha-2]
+     */
+    country?: string | null;
+    line1?: string | null;
+    line2?: string | null;
+    /**
+     * Locality or City.
+     */
+    locality?: string | null;
+    /**
+     * The postal code of the address.
+     */
+    postal_code?: string | null;
+    /**
+     * Region or State.
+     */
+    region?: string | null;
+  }
+}
+export interface ValidationValidateRoutingNumberParams {
+  /**
+   * The routing number that is being validated.
+   */
+  routing_number: string;
+  /**
+   * One of `aba`, `au_bsb`, `br_codigo`, `ca_cpa`, `cnaps`, `gb_sort_code`,
+   * `in_ifsc`, `my_branch_code`, or `swift`. In sandbox mode we currently only
+   * support `aba` and `swift` with routing numbers '123456789' and 'GRINUST0XXX'
+   * respectively.
+   */
+  routing_number_type:
+    | 'aba'
+    | 'au_bsb'
+    | 'br_codigo'
+    | 'ca_cpa'
+    | 'cnaps'
+    | 'gb_sort_code'
+    | 'in_ifsc'
+    | 'my_branch_code'
+    | 'swift';
+}

package/dist/cjs/resources/validations.js

@@ -0,0 +1,16 @@
+'use strict';
+// File generated from our OpenAPI spec by Stainless.
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.Validations = void 0;
+const resource_1 = require('../resource');
+class Validations extends resource_1.APIResource {
+  /**
+   * Validates the routing number information supplied without creating a routing
+   * detail
+   */
+  validateRoutingNumber(query, options) {
+    return this.get('/api/validations/routing_numbers', Object.assign({ query }, options));
+  }
+}
+exports.Validations = Validations;
+//# sourceMappingURL=validations.js.map

package/dist/cjs/resources/validations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validations.js","sourceRoot":"","sources":["../../../resources/validations.ts"],"names":[],"mappings":";AAAA,qDAAqD;;;AAGrD,yCAAyC;AAEzC,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;;OAGG;IACH,qBAAqB,CACnB,KAA4C,EAC5C,OAA6B;QAE7B,OAAO,IAAI,CAAC,GAAG,CAAC,kCAAkC,kBAAI,KAAK,IAAK,OAAO,EAAG,CAAC;IAC7E,CAAC;CACF;AAXD,kCAWC"}

package/dist/cjs/resources/webhooks.d.ts

@@ -0,0 +1,31 @@
+import { APIResource } from '../resource';
+import type { HeadersLike } from '../core';
+export declare class Webhooks extends APIResource {
+  /**
+   * To verify that a webhook was actually sent by Modern Treasury, every payload is
+   * signed with a signature that is passed through the `X-Signature` HTTP header.
+   *
+   * This method will generate a signature based off of your webhook key which can be
+   * found in the Developer Settings,
+   * https://app.moderntreasury.com/developers/webhooks, and the webhook payload.
+   *
+   * You can then compare the generated signature with the signature sent with the
+   * request, if they match then the webhook was sent by Modern Treasury.
+   */
+  getSignature(
+    payload: string,
+    opts?: {
+      key?: string | null | undefined;
+    },
+  ): string;
+  /**
+   * Returns whether or not the webhook payload was sent by Modern Treasury.
+   */
+  validateSignature(
+    payload: string,
+    headers: string | HeadersLike,
+    opts?: {
+      key?: string | null | undefined;
+    },
+  ): boolean;
+}

package/dist/cjs/resources/webhooks.js

@@ -0,0 +1,44 @@
+'use strict';
+// File generated from our OpenAPI spec by Stainless.
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.Webhooks = void 0;
+const resource_1 = require('../resource');
+const crypto_1 = require('crypto');
+const core_1 = require('../core');
+class Webhooks extends resource_1.APIResource {
+  /**
+   * To verify that a webhook was actually sent by Modern Treasury, every payload is
+   * signed with a signature that is passed through the `X-Signature` HTTP header.
+   *
+   * This method will generate a signature based off of your webhook key which can be
+   * found in the Developer Settings,
+   * https://app.moderntreasury.com/developers/webhooks, and the webhook payload.
+   *
+   * You can then compare the generated signature with the signature sent with the
+   * request, if they match then the webhook was sent by Modern Treasury.
+   */
+  getSignature(payload, opts) {
+    const key = (opts === null || opts === void 0 ? void 0 : opts.key) || this.client.webhookKey;
+    if (key == null) {
+      throw new Error(
+        "The webhook key must either be set using the env var, MODERN_TREASURY_WEBHOOK_KEY, on the client class, new ModernTreasury({ webhookKey: '123' }) or passed to this function",
+      );
+    }
+    if (!key) {
+      throw new Error('The webhook key is set but appears to be empty.');
+    }
+    return (0, crypto_1.createHmac)('sha256', key).update(payload, 'utf8').digest('hex');
+  }
+  /**
+   * Returns whether or not the webhook payload was sent by Modern Treasury.
+   */
+  validateSignature(payload, headers, opts) {
+    const signature = this.getSignature(payload, opts);
+    const expectedSignature =
+      typeof headers === 'string' ? headers : (0, core_1.getHeader)(headers, 'X-Signature');
+    if (!expectedSignature) throw new Error('Could not find an X-Signature header');
+    return signature === expectedSignature;
+  }
+}
+exports.Webhooks = Webhooks;
+//# sourceMappingURL=webhooks.js.map

package/dist/cjs/resources/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../../resources/webhooks.ts"],"names":[],"mappings":";AAAA,qDAAqD;;;AAErD,yCAAyC;AACzC,mCAAoC;AAGpC,iCAAmC;AAEnC,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;OAUG;IACH,YAAY,CAAC,OAAe,EAAE,IAA0C;QACtE,MAAM,GAAG,GAAG,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,GAAG,KAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QAChD,IAAI,GAAG,IAAI,IAAI,EAAE;YACf,MAAM,IAAI,KAAK,CACb,8KAA8K,CAC/K,CAAC;SACH;QACD,IAAI,CAAC,GAAG,EAAE;YACR,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;SACpE;QAED,OAAO,IAAA,mBAAU,EAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,iBAAiB,CACf,OAAe,EACf,OAA6B,EAC7B,IAA0C;QAE1C,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnD,MAAM,iBAAiB,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAA,gBAAS,EAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACpG,IAAI,CAAC,iBAAiB;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAChF,OAAO,SAAS,KAAK,iBAAiB,CAAC;IACzC,CAAC;CACF;AAvCD,4BAuCC"}

package/dist/cjs/tests/api-resources/counterparties.test.d.ts

@@ -0,0 +1 @@
+export {};