@digitalworld/digital-world-sdk 16.0.0

package/lib/axios/esm/gateway/account_response.js

@@ -0,0 +1,104 @@
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/int.js';
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/hyper.js';
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-int.js';
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-hyper.js';
+import '../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/xdr-type.js';
+import 'buffer';
+import '../base/generated/curr_generated.js';
+import '@noble/hashes/sha2.js';
+import '../base/signing.js';
+import '../base/keypair.js';
+import 'base32.js';
+import '../base/util/continued_fraction.js';
+import '../base/util/bignumber.js';
+import '../base/transaction_builder.js';
+import { Account } from '../base/account.js';
+import '../base/muxed_account.js';
+import '../base/scval.js';
+import '../base/numbers/uint128.js';
+import '../base/numbers/uint256.js';
+import '../base/numbers/int128.js';
+import '../base/numbers/int256.js';
+
+class AccountResponse {
+  id;
+  paging_token;
+  account_id;
+  sequence;
+  sequence_ledger;
+  sequence_time;
+  subentry_count;
+  home_domain;
+  inflation_destination;
+  last_modified_ledger;
+  last_modified_time;
+  thresholds;
+  flags;
+  balances;
+  signers;
+  num_sponsoring;
+  num_sponsored;
+  sponsor;
+  data;
+  data_attr;
+  effects;
+  offers;
+  operations;
+  payments;
+  trades;
+  transactions;
+  _baseAccount;
+  constructor(response) {
+    this._baseAccount = new Account(response.account_id, response.sequence);
+    this.effects = response.effects;
+    this.offers = response.offers;
+    this.operations = response.operations;
+    this.payments = response.payments;
+    this.trades = response.trades;
+    this.data = response.data;
+    this.transactions = response.transactions;
+    this.id = response.id;
+    this.paging_token = response.paging_token;
+    this.account_id = response.account_id;
+    this.sequence = response.sequence;
+    this.sequence_ledger = response.sequence_ledger;
+    this.sequence_time = response.sequence_time;
+    this.subentry_count = response.subentry_count;
+    this.home_domain = response.home_domain;
+    this.inflation_destination = response.inflation_destination;
+    this.last_modified_ledger = response.last_modified_ledger;
+    this.last_modified_time = response.last_modified_time;
+    this.thresholds = response.thresholds;
+    this.flags = response.flags;
+    this.balances = response.balances;
+    this.signers = response.signers;
+    this.data_attr = response.data_attr;
+    this.sponsor = response.sponsor;
+    this.num_sponsoring = response.num_sponsoring;
+    this.num_sponsored = response.num_sponsored;
+  }
+  /**
+   * Get Digital World account public key ex. `GB3KJPLFUYN5VL6R3GU3EGCGVCKFDSD7BEDX42HWG5BWFKB3KQGJJRMA`
+   * @returns accountId
+   */
+  accountId() {
+    return this._baseAccount.accountId();
+  }
+  /**
+   * Get the current sequence number
+   * @returns sequenceNumber
+   */
+  sequenceNumber() {
+    return this._baseAccount.sequenceNumber();
+  }
+  /**
+   * Increments sequence number in this object by one.
+   * @returns    */
+  incrementSequenceNumber() {
+    this._baseAccount.incrementSequenceNumber();
+    this.sequence = this._baseAccount.sequenceNumber();
+  }
+}
+
+export { AccountResponse };
+//# sourceMappingURL=account_response.js.map

package/lib/axios/esm/gateway/account_response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account_response.js","sources":["../../../../src/gateway/account_response.ts"],"sourcesContent":["/* tslint:disable:variable-name */\n\nimport { Account as BaseAccount } from \"../base/index.js\";\nimport type { TransactionBuilder, TransactionSource } from \"../base/index.js\";\nimport { GatewayApi } from \"./gateway_api.js\";\nimport { ServerApi } from \"./server_api.js\";\n\n/**\n * Do not create this object directly, use {@link Gateway.Server.loadAccount | Gateway.Server#loadAccount}.\n *\n * Returns information and links relating to a single account.\n * The balances section in the returned JSON will also list all the trust lines this account has set up.\n * It also contains {@link BaseAccount} object and exposes it's methods so can be used in {@link TransactionBuilder}.\n *\n * @see {@link https://docs.digitalworld.global/docs/data/gateway/api-reference/resources/accounts/object | Account Details}\n * @param response - Response from gateway account endpoint.\n * @returns AccountResponse instance\n */\nexport class AccountResponse implements TransactionSource {\n  public readonly id!: string;\n  public readonly paging_token!: string;\n  public readonly account_id!: string;\n  public sequence!: string;\n  public readonly sequence_ledger?: number;\n  public readonly sequence_time?: string;\n  public readonly subentry_count!: number;\n  public readonly home_domain?: string;\n  public readonly inflation_destination?: string;\n  public readonly last_modified_ledger!: number;\n  public readonly last_modified_time!: string;\n  public readonly thresholds!: GatewayApi.AccountThresholds;\n  public readonly flags!: GatewayApi.Flags;\n  public readonly balances!: GatewayApi.BalanceLine[];\n  public readonly signers!: ServerApi.AccountRecordSigners[];\n  public readonly num_sponsoring!: number;\n  public readonly num_sponsored!: number;\n  public readonly sponsor?: string;\n  public readonly data!: (options: {\n    value: string;\n  }) => Promise<{ value: string }>;\n  public readonly data_attr!: Record<string, string>;\n  public readonly effects!: ServerApi.CallCollectionFunction<ServerApi.EffectRecord>;\n  public readonly offers!: ServerApi.CallCollectionFunction<ServerApi.OfferRecord>;\n  public readonly operations!: ServerApi.CallCollectionFunction<ServerApi.OperationRecord>;\n  public readonly payments!: ServerApi.CallCollectionFunction<ServerApi.PaymentOperationRecord>;\n  public readonly trades!: ServerApi.CallCollectionFunction<ServerApi.TradeRecord>;\n  public readonly transactions!: ServerApi.CallCollectionFunction<ServerApi.TransactionRecord>;\n  private readonly _baseAccount: BaseAccount;\n\n  constructor(response: ServerApi.AccountRecord) {\n    this._baseAccount = new BaseAccount(response.account_id, response.sequence);\n    // Extract response fields\n    this.effects = response.effects;\n    this.offers = response.offers;\n    this.operations = response.operations;\n    this.payments = response.payments;\n    this.trades = response.trades;\n    this.data = response.data;\n    this.transactions = response.transactions;\n    this.id = response.id;\n    this.paging_token = response.paging_token;\n    this.account_id = response.account_id;\n    this.sequence = response.sequence;\n    this.sequence_ledger = response.sequence_ledger;\n    this.sequence_time = response.sequence_time;\n    this.subentry_count = response.subentry_count;\n    this.home_domain = response.home_domain;\n    this.inflation_destination = response.inflation_destination;\n    this.last_modified_ledger = response.last_modified_ledger;\n    this.last_modified_time = response.last_modified_time;\n    this.thresholds = response.thresholds;\n    this.flags = response.flags;\n    this.balances = response.balances;\n    this.signers = response.signers;\n    this.data_attr = response.data_attr;\n    this.sponsor = response.sponsor;\n    this.num_sponsoring = response.num_sponsoring;\n    this.num_sponsored = response.num_sponsored;\n  }\n\n  /**\n   * Get Digital World account public key ex. `GB3KJPLFUYN5VL6R3GU3EGCGVCKFDSD7BEDX42HWG5BWFKB3KQGJJRMA`\n   * @returns accountId\n   */\n  public accountId(): string {\n    return this._baseAccount.accountId();\n  }\n\n  /**\n   * Get the current sequence number\n   * @returns sequenceNumber\n   */\n  public sequenceNumber(): string {\n    return this._baseAccount.sequenceNumber();\n  }\n\n  /**\n   * Increments sequence number in this object by one.\n   * @returns    */\n  public incrementSequenceNumber(): void {\n    this._baseAccount.incrementSequenceNumber();\n    this.sequence = this._baseAccount.sequenceNumber();\n  }\n}\n"],"names":["BaseAccount"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAkBO,MAAM,eAAA,CAA6C;AAAA,EACxC,EAAA;AAAA,EACA,YAAA;AAAA,EACA,UAAA;AAAA,EACT,QAAA;AAAA,EACS,eAAA;AAAA,EACA,aAAA;AAAA,EACA,cAAA;AAAA,EACA,WAAA;AAAA,EACA,qBAAA;AAAA,EACA,oBAAA;AAAA,EACA,kBAAA;AAAA,EACA,UAAA;AAAA,EACA,KAAA;AAAA,EACA,QAAA;AAAA,EACA,OAAA;AAAA,EACA,cAAA;AAAA,EACA,aAAA;AAAA,EACA,OAAA;AAAA,EACA,IAAA;AAAA,EAGA,SAAA;AAAA,EACA,OAAA;AAAA,EACA,MAAA;AAAA,EACA,UAAA;AAAA,EACA,QAAA;AAAA,EACA,MAAA;AAAA,EACA,YAAA;AAAA,EACC,YAAA;AAAA,EAEjB,YAAY,QAAA,EAAmC;AAC7C,IAAA,IAAA,CAAK,eAAe,IAAIA,OAAA,CAAY,QAAA,CAAS,UAAA,EAAY,SAAS,QAAQ,CAAA;AAE1E,IAAA,IAAA,CAAK,UAAU,QAAA,CAAS,OAAA;AACxB,IAAA,IAAA,CAAK,SAAS,QAAA,CAAS,MAAA;AACvB,IAAA,IAAA,CAAK,aAAa,QAAA,CAAS,UAAA;AAC3B,IAAA,IAAA,CAAK,WAAW,QAAA,CAAS,QAAA;AACzB,IAAA,IAAA,CAAK,SAAS,QAAA,CAAS,MAAA;AACvB,IAAA,IAAA,CAAK,OAAO,QAAA,CAAS,IAAA;AACrB,IAAA,IAAA,CAAK,eAAe,QAAA,CAAS,YAAA;AAC7B,IAAA,IAAA,CAAK,KAAK,QAAA,CAAS,EAAA;AACnB,IAAA,IAAA,CAAK,eAAe,QAAA,CAAS,YAAA;AAC7B,IAAA,IAAA,CAAK,aAAa,QAAA,CAAS,UAAA;AAC3B,IAAA,IAAA,CAAK,WAAW,QAAA,CAAS,QAAA;AACzB,IAAA,IAAA,CAAK,kBAAkB,QAAA,CAAS,eAAA;AAChC,IAAA,IAAA,CAAK,gBAAgB,QAAA,CAAS,aAAA;AAC9B,IAAA,IAAA,CAAK,iBAAiB,QAAA,CAAS,cAAA;AAC/B,IAAA,IAAA,CAAK,cAAc,QAAA,CAAS,WAAA;AAC5B,IAAA,IAAA,CAAK,wBAAwB,QAAA,CAAS,qBAAA;AACtC,IAAA,IAAA,CAAK,uBAAuB,QAAA,CAAS,oBAAA;AACrC,IAAA,IAAA,CAAK,qBAAqB,QAAA,CAAS,kBAAA;AACnC,IAAA,IAAA,CAAK,aAAa,QAAA,CAAS,UAAA;AAC3B,IAAA,IAAA,CAAK,QAAQ,QAAA,CAAS,KAAA;AACtB,IAAA,IAAA,CAAK,WAAW,QAAA,CAAS,QAAA;AACzB,IAAA,IAAA,CAAK,UAAU,QAAA,CAAS,OAAA;AACxB,IAAA,IAAA,CAAK,YAAY,QAAA,CAAS,SAAA;AAC1B,IAAA,IAAA,CAAK,UAAU,QAAA,CAAS,OAAA;AACxB,IAAA,IAAA,CAAK,iBAAiB,QAAA,CAAS,cAAA;AAC/B,IAAA,IAAA,CAAK,gBAAgB,QAAA,CAAS,aAAA;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,SAAA,GAAoB;AACzB,IAAA,OAAO,IAAA,CAAK,aAAa,SAAA,EAAU;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,cAAA,GAAyB;AAC9B,IAAA,OAAO,IAAA,CAAK,aAAa,cAAA,EAAe;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA,EAKO,uBAAA,GAAgC;AACrC,IAAA,IAAA,CAAK,aAAa,uBAAA,EAAwB;AAC1C,IAAA,IAAA,CAAK,QAAA,GAAW,IAAA,CAAK,YAAA,CAAa,cAAA,EAAe;AAAA,EACnD;AACF;;;;"}

package/lib/axios/esm/gateway/assets_call_builder.d.ts

@@ -0,0 +1,25 @@
+import { CallBuilder } from "./call_builder.js";
+import { ServerApi } from "./server_api.js";
+import type { HttpClient } from "../http-client/index.js";
+/**
+ * Creates a new {@link AssetsCallBuilder} pointed to server defined by serverUrl.
+ *
+ * Do not create this object directly, use {@link Gateway.Server.assets}.
+ *
+ * @param serverUrl - Gateway server URL.
+ */
+export declare class AssetsCallBuilder extends CallBuilder<ServerApi.CollectionPage<ServerApi.AssetRecord>> {
+    constructor(serverUrl: URL, httpClient: HttpClient);
+    /**
+     * This endpoint filters all assets by the asset code.
+     * @param value - For example: `USD`
+     * @returns current AssetCallBuilder instance
+     */
+    forCode(value: string): AssetsCallBuilder;
+    /**
+     * This endpoint filters all assets by the asset issuer.
+     * @param value - For example: `GDGQVOKHW4VEJRU2TETD6DBRKEO5ERCNF353LW5WBFW3JJWQ2BRQ6KDD`
+     * @returns current AssetCallBuilder instance
+     */
+    forIssuer(value: string): AssetsCallBuilder;
+}

package/lib/axios/esm/gateway/assets_call_builder.js

@@ -0,0 +1,29 @@
+import { CallBuilder } from './call_builder.js';
+
+class AssetsCallBuilder extends CallBuilder {
+  constructor(serverUrl, httpClient) {
+    super(serverUrl, httpClient);
+    this.setPath("assets");
+  }
+  /**
+   * This endpoint filters all assets by the asset code.
+   * @param value - For example: `USD`
+   * @returns current AssetCallBuilder instance
+   */
+  forCode(value) {
+    this.url.searchParams.set("asset_code", value);
+    return this;
+  }
+  /**
+   * This endpoint filters all assets by the asset issuer.
+   * @param value - For example: `GDGQVOKHW4VEJRU2TETD6DBRKEO5ERCNF353LW5WBFW3JJWQ2BRQ6KDD`
+   * @returns current AssetCallBuilder instance
+   */
+  forIssuer(value) {
+    this.url.searchParams.set("asset_issuer", value);
+    return this;
+  }
+}
+
+export { AssetsCallBuilder };
+//# sourceMappingURL=assets_call_builder.js.map

package/lib/axios/esm/gateway/assets_call_builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets_call_builder.js","sources":["../../../../src/gateway/assets_call_builder.ts"],"sourcesContent":["import { CallBuilder } from \"./call_builder.js\";\nimport { ServerApi } from \"./server_api.js\";\nimport type { HttpClient } from \"../http-client/index.js\";\n\n/**\n * Creates a new {@link AssetsCallBuilder} pointed to server defined by serverUrl.\n *\n * Do not create this object directly, use {@link Gateway.Server.assets}.\n *\n * @param serverUrl - Gateway server URL.\n */\nexport class AssetsCallBuilder extends CallBuilder<\n  ServerApi.CollectionPage<ServerApi.AssetRecord>\n> {\n  constructor(serverUrl: URL, httpClient: HttpClient) {\n    super(serverUrl, httpClient);\n    this.setPath(\"assets\");\n  }\n\n  /**\n   * This endpoint filters all assets by the asset code.\n   * @param value - For example: `USD`\n   * @returns current AssetCallBuilder instance\n   */\n  public forCode(value: string): AssetsCallBuilder {\n    this.url.searchParams.set(\"asset_code\", value);\n    return this;\n  }\n\n  /**\n   * This endpoint filters all assets by the asset issuer.\n   * @param value - For example: `GDGQVOKHW4VEJRU2TETD6DBRKEO5ERCNF353LW5WBFW3JJWQ2BRQ6KDD`\n   * @returns current AssetCallBuilder instance\n   */\n  public forIssuer(value: string): AssetsCallBuilder {\n    this.url.searchParams.set(\"asset_issuer\", value);\n    return this;\n  }\n}\n"],"names":[],"mappings":";;AAWO,MAAM,0BAA0B,WAAA,CAErC;AAAA,EACA,WAAA,CAAY,WAAgB,UAAA,EAAwB;AAClD,IAAA,KAAA,CAAM,WAAW,UAAU,CAAA;AAC3B,IAAA,IAAA,CAAK,QAAQ,QAAQ,CAAA;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOO,QAAQ,KAAA,EAAkC;AAC/C,IAAA,IAAA,CAAK,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,YAAA,EAAc,KAAK,CAAA;AAC7C,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOO,UAAU,KAAA,EAAkC;AACjD,IAAA,IAAA,CAAK,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,cAAA,EAAgB,KAAK,CAAA;AAC/C,IAAA,OAAO,IAAA;AAAA,EACT;AACF;;;;"}

package/lib/axios/esm/gateway/call_builder.d.ts

@@ -0,0 +1,128 @@
+import { GatewayApi } from "./gateway_api.js";
+import type { HttpClient } from "../http-client/index.js";
+import { ServerApi } from "./server_api.js";
+export interface EventSourceOptions<T> {
+    onmessage?: (value: T extends ServerApi.CollectionPage<infer U> ? U : T) => void;
+    onerror?: (event: MessageEvent) => void;
+    reconnectTimeout?: number;
+}
+/**
+ * Creates a new {@link CallBuilder} pointed to server defined by serverUrl.
+ *
+ * This is an **abstract** class. Do not create this object directly, use {@link Server} class.
+ * @param serverUrl - URL of Horizon server
+ */
+export declare class CallBuilder<T extends GatewayApi.FeeStatsResponse | GatewayApi.BaseResponse | GatewayApi.RootResponse | ServerApi.CollectionPage<GatewayApi.BaseResponse>> {
+    protected url: URL;
+    filter: string[][];
+    protected originalSegments: string[];
+    protected neighborRoot: string;
+    protected httpClient: HttpClient;
+    constructor(serverUrl: URL, httpClient: HttpClient, neighborRoot?: string);
+    protected setPath(...segments: string[]): void;
+    /**
+     * Triggers a HTTP request using this builder's current configuration.
+     * @returns a Promise that resolves to the server's response.
+     */
+    call(): Promise<T>;
+    /**
+     * Creates an EventSource that listens for incoming messages from the server. To stop listening for new
+     * events call the function returned by this method.
+     * @see [Gateway Response Format](https://docs.digitalworld.global/api/introduction/response-format/)
+     * @see [MDN EventSource](https://developer.mozilla.org/en-US/docs/Web/API/EventSource)
+     * @param options - (optional) EventSource options.
+     *   - `onmessage` (optional): Callback function to handle incoming messages.
+     *   - `onerror` (optional): Callback function to handle errors.
+     *   - `reconnectTimeout` (optional): Custom stream connection timeout in ms, default is 15 seconds.
+     * @returns Close function. Run to close the connection and stop listening for new events.
+     */
+    stream(options?: EventSourceOptions<T extends ServerApi.CollectionPage<infer U> ? U : T>): () => void;
+    /**
+     * Sets `cursor` parameter for the current call. Returns the CallBuilder object on which this method has been called.
+     * @see [Paging](https://docs.digitalworld.global/api/introduction/pagination/)
+     * @param cursor - A cursor is a value that points to a specific location in a collection of resources.
+     * @returns current CallBuilder instance
+     */
+    cursor(cursor: string): this;
+    /**
+     * Sets `limit` parameter for the current call. Returns the CallBuilder object on which this method has been called.
+     * @see [Paging](https://docs.digitalworld.global/api/introduction/pagination/)
+     * @param recordsNumber - Number of records the server should return.
+     * @returns current CallBuilder instance
+     */
+    limit(recordsNumber: number): this;
+    /**
+     * Sets `order` parameter for the current call. Returns the CallBuilder object on which this method has been called.
+     * @param direction - Sort direction
+     * @returns current CallBuilder instance
+     */
+    order(direction: "asc" | "desc"): this;
+    /**
+     * Sets `join` parameter for the current call. The `join` parameter
+     * includes the requested resource in the response. Currently, the
+     * only valid value for the parameter is `transactions` and is only
+     * supported on the operations and payments endpoints. The response
+     * will include a `transaction` field for each operation in the
+     * response.
+     *
+     * @param include - join Records to be included in the response.
+     * @returns current CallBuilder instance.
+     */
+    join(include: "transactions"): this;
+    /**
+     * A helper method to craft queries to "neighbor" endpoints.
+     *
+     *  For example, we have an `/effects` suffix endpoint on many different
+     *  "root" endpoints, such as `/transactions/:id` and `/accounts/:id`. So,
+     *  it's helpful to be able to conveniently create queries to the
+     *  `/accounts/:id/effects` endpoint:
+     *
+     *    `this.forEndpoint("accounts", accountId)`.
+     *
+     * @param endpoint - neighbor endpoint in question, like /operations
+     * @param param - filter parameter, like an operation ID
+     *
+     * @returns this CallBuilder instance
+     */
+    protected forEndpoint(endpoint: string, param: string): this;
+    /**
+     * @hidden
+     * @returns    */
+    private checkFilter;
+    /**
+     * Convert a link object to a function that fetches that link.
+     * @hidden
+     * @param link - A link object
+     *   - `href`: the URI of the link
+     *   - `templated` (optional): Whether the link is templated
+     * @returns A function that requests the link
+     */
+    private _requestFnForLink;
+    /**
+     * Given the json response, find and convert each link into a function that
+     * calls that link.
+     * @hidden
+     * @param json - JSON response
+     * @returns JSON response with string links replaced with functions
+     */
+    private _parseRecord;
+    private _sendNormalRequest;
+    /**
+     * @hidden
+     * @param json - Response object
+     * @returns Extended response
+     */
+    private _parseResponse;
+    /**
+     * @hidden
+     * @param json - Response object
+     * @returns Extended response object
+     */
+    private _toCollectionPage;
+    /**
+     * @hidden
+     * @param error - Network error object
+     * @returns Promise that rejects with a human-readable error
+     */
+    private _handleNetworkError;
+}

package/lib/axios/esm/gateway/call_builder.js

@@ -0,0 +1,354 @@
+import { EventSource } from 'eventsource';
+import { NetworkError } from '../errors/network.js';
+import { NotFoundError } from '../errors/not_found.js';
+import { BadRequestError } from '../errors/bad_request.js';
+import { version } from './gateway_axios_client.js';
+import { expandUriTemplate } from '../utils/url.js';
+
+const JOINABLE = ["transaction"];
+class CallBuilder {
+  url;
+  filter;
+  originalSegments;
+  neighborRoot;
+  httpClient;
+  constructor(serverUrl, httpClient, neighborRoot = "") {
+    this.url = new URL(serverUrl);
+    this.filter = [];
+    this.originalSegments = this.url.pathname.split("/").filter((s) => s.length > 0);
+    this.neighborRoot = neighborRoot;
+    this.httpClient = httpClient;
+  }
+  setPath(...segments) {
+    const endpointSegments = segments.flatMap(
+      (segment) => segment.split("/").filter((s) => s.length > 0)
+    );
+    this.url.pathname = this.originalSegments.concat(endpointSegments).join("/");
+  }
+  /**
+   * Triggers a HTTP request using this builder's current configuration.
+   * @returns a Promise that resolves to the server's response.
+   */
+  call() {
+    this.checkFilter();
+    return this._sendNormalRequest(this.url).then(
+      (r) => this._parseResponse(r)
+    );
+  }
+  //// TODO: Migrate to async, BUT that's a change in behavior and tests "rejects two filters" will fail.
+  //// It's because async will check within promise, which makes more sense when using awaits instead of Promises.
+  // public async call(): Promise<T> {
+  //   this.checkFilter();
+  //   const r = await this._sendNormalRequest(this.url);
+  //   return this._parseResponse(r);
+  // }
+  //// /* actually equals */
+  //// public call(): Promise<T> {
+  ////   return Promise.resolve().then(() => {
+  ////     this.checkFilter();
+  ////     return this._sendNormalRequest(this.url)
+  ////   }).then((r) => {
+  ////     this._parseResponse(r)
+  ////   });
+  //// }
+  /**
+   * Creates an EventSource that listens for incoming messages from the server. To stop listening for new
+   * events call the function returned by this method.
+   * @see [Gateway Response Format](https://docs.digitalworld.global/api/introduction/response-format/)
+   * @see [MDN EventSource](https://developer.mozilla.org/en-US/docs/Web/API/EventSource)
+   * @param options - (optional) EventSource options.
+   *   - `onmessage` (optional): Callback function to handle incoming messages.
+   *   - `onerror` (optional): Callback function to handle errors.
+   *   - `reconnectTimeout` (optional): Custom stream connection timeout in ms, default is 15 seconds.
+   * @returns Close function. Run to close the connection and stop listening for new events.
+   */
+  stream(options = {}) {
+    this.checkFilter();
+    const streamUrl = new URL(this.url);
+    streamUrl.searchParams.set("X-Client-Name", "digital-world-js-sdk");
+    streamUrl.searchParams.set("X-Client-Version", version);
+    const { headers } = this.httpClient.defaults;
+    if (headers) {
+      const headerNames = ["X-App-Name", "X-App-Version"];
+      headerNames.forEach((name) => {
+        let value;
+        if (headers instanceof Headers) {
+          value = headers.get(name) ?? void 0;
+        } else if (Array.isArray(headers)) {
+          const entry = headers.find(([key]) => key === name);
+          value = entry?.[1];
+        } else {
+          value = headers[name];
+        }
+        if (value) {
+          streamUrl.searchParams.set(name, value);
+        }
+      });
+    }
+    let es;
+    let timeout;
+    const createTimeout = () => {
+      timeout = setTimeout(
+        () => {
+          es?.close();
+          es = createEventSource();
+        },
+        options.reconnectTimeout || 15 * 1e3
+      );
+    };
+    const createEventSource = () => {
+      try {
+        es = new EventSource(streamUrl.toString());
+      } catch (err) {
+        if (options.onerror) {
+          options.onerror(err);
+        }
+      }
+      createTimeout();
+      if (!es) {
+        return es;
+      }
+      let closed = false;
+      const onClose = () => {
+        if (closed) {
+          return;
+        }
+        clearTimeout(timeout);
+        es.close();
+        createEventSource();
+        closed = true;
+      };
+      const onMessage = (message) => {
+        if (message.type === "close") {
+          onClose();
+          return;
+        }
+        const result = message.data ? this._parseRecord(JSON.parse(message.data)) : message;
+        if (result.paging_token) {
+          streamUrl.searchParams.set("cursor", result.paging_token);
+        }
+        clearTimeout(timeout);
+        createTimeout();
+        if (typeof options.onmessage !== "undefined") {
+          options.onmessage(result);
+        }
+      };
+      const onError = (error) => {
+        if (options.onerror) {
+          options.onerror(error);
+        }
+      };
+      if (es.addEventListener) {
+        es.addEventListener("message", onMessage.bind(this));
+        es.addEventListener("error", onError.bind(this));
+        es.addEventListener("close", onClose.bind(this));
+      } else {
+        es.onmessage = onMessage.bind(this);
+        es.onerror = onError.bind(this);
+      }
+      return es;
+    };
+    createEventSource();
+    return () => {
+      clearTimeout(timeout);
+      es?.close();
+    };
+  }
+  /**
+   * Sets `cursor` parameter for the current call. Returns the CallBuilder object on which this method has been called.
+   * @see [Paging](https://docs.digitalworld.global/api/introduction/pagination/)
+   * @param cursor - A cursor is a value that points to a specific location in a collection of resources.
+   * @returns current CallBuilder instance
+   */
+  cursor(cursor) {
+    this.url.searchParams.set("cursor", cursor);
+    return this;
+  }
+  /**
+   * Sets `limit` parameter for the current call. Returns the CallBuilder object on which this method has been called.
+   * @see [Paging](https://docs.digitalworld.global/api/introduction/pagination/)
+   * @param recordsNumber - Number of records the server should return.
+   * @returns current CallBuilder instance
+   */
+  limit(recordsNumber) {
+    this.url.searchParams.set("limit", recordsNumber.toString());
+    return this;
+  }
+  /**
+   * Sets `order` parameter for the current call. Returns the CallBuilder object on which this method has been called.
+   * @param direction - Sort direction
+   * @returns current CallBuilder instance
+   */
+  order(direction) {
+    this.url.searchParams.set("order", direction);
+    return this;
+  }
+  /**
+   * Sets `join` parameter for the current call. The `join` parameter
+   * includes the requested resource in the response. Currently, the
+   * only valid value for the parameter is `transactions` and is only
+   * supported on the operations and payments endpoints. The response
+   * will include a `transaction` field for each operation in the
+   * response.
+   *
+   * @param include - join Records to be included in the response.
+   * @returns current CallBuilder instance.
+   */
+  join(include) {
+    this.url.searchParams.set("join", include);
+    return this;
+  }
+  /**
+   * A helper method to craft queries to "neighbor" endpoints.
+   *
+   *  For example, we have an `/effects` suffix endpoint on many different
+   *  "root" endpoints, such as `/transactions/:id` and `/accounts/:id`. So,
+   *  it's helpful to be able to conveniently create queries to the
+   *  `/accounts/:id/effects` endpoint:
+   *
+   *    `this.forEndpoint("accounts", accountId)`.
+   *
+   * @param endpoint - neighbor endpoint in question, like /operations
+   * @param param - filter parameter, like an operation ID
+   *
+   * @returns this CallBuilder instance
+   */
+  forEndpoint(endpoint, param) {
+    if (this.neighborRoot === "") {
+      throw new Error("Invalid usage: neighborRoot not set in constructor");
+    }
+    this.filter.push([endpoint, param, this.neighborRoot]);
+    return this;
+  }
+  /**
+   * @hidden
+   * @returns    */
+  checkFilter() {
+    if (this.filter.length >= 2) {
+      throw new BadRequestError("Too many filters specified", this.filter);
+    }
+    if (this.filter.length === 1) {
+      const newSegment = this.originalSegments.concat(this.filter[0]);
+      this.url.pathname = newSegment.join("/");
+    }
+  }
+  /**
+   * Convert a link object to a function that fetches that link.
+   * @hidden
+   * @param link - A link object
+   *   - `href`: the URI of the link
+   *   - `templated` (optional): Whether the link is templated
+   * @returns A function that requests the link
+   */
+  _requestFnForLink(link) {
+    return async (opts = {}) => {
+      let uri;
+      if (link.templated) {
+        uri = new URL(expandUriTemplate(link.href, opts), this.url);
+      } else {
+        uri = new URL(link.href, this.url);
+      }
+      const r = await this._sendNormalRequest(uri);
+      return this._parseResponse(r);
+    };
+  }
+  /**
+   * Given the json response, find and convert each link into a function that
+   * calls that link.
+   * @hidden
+   * @param json - JSON response
+   * @returns JSON response with string links replaced with functions
+   */
+  _parseRecord(json) {
+    if (!json._links) {
+      return json;
+    }
+    Object.keys(json._links).forEach((key) => {
+      const n = json._links[key];
+      let included = false;
+      if (typeof json[key] !== "undefined") {
+        json[`${key}_attr`] = json[key];
+        included = true;
+      }
+      if (included && JOINABLE.indexOf(key) >= 0) {
+        const record = this._parseRecord(json[key]);
+        json[key] = async () => record;
+      } else {
+        json[key] = this._requestFnForLink(n);
+      }
+    });
+    return json;
+  }
+  async _sendNormalRequest(initialUrl) {
+    const url = new URL(initialUrl);
+    url.protocol = this.url.protocol;
+    url.host = this.url.host;
+    return this.httpClient.get(url.toString()).then((response) => response.data).catch(this._handleNetworkError);
+  }
+  /**
+   * @hidden
+   * @param json - Response object
+   * @returns Extended response
+   */
+  _parseResponse(json) {
+    if (json._embedded && json._embedded.records) {
+      return this._toCollectionPage(json);
+    }
+    return this._parseRecord(json);
+  }
+  /**
+   * @hidden
+   * @param json - Response object
+   * @returns Extended response object
+   */
+  _toCollectionPage(json) {
+    for (let i = 0; i < json._embedded.records.length; i += 1) {
+      json._embedded.records[i] = this._parseRecord(json._embedded.records[i]);
+    }
+    return {
+      records: json._embedded.records,
+      next: async () => {
+        const r = await this._sendNormalRequest(
+          new URL(json._links.next.href, this.url)
+        );
+        return this._toCollectionPage(r);
+      },
+      prev: async () => {
+        const r = await this._sendNormalRequest(
+          new URL(json._links.prev.href, this.url)
+        );
+        return this._toCollectionPage(r);
+      }
+    };
+  }
+  /**
+   * @hidden
+   * @param error - Network error object
+   * @returns Promise that rejects with a human-readable error
+   */
+  async _handleNetworkError(error) {
+    if (error.response && error.response.status) {
+      switch (error.response.status) {
+        case 404:
+          return Promise.reject(
+            new NotFoundError(
+              error.response.statusText ?? "Not Found",
+              error.response.data
+            )
+          );
+        default:
+          return Promise.reject(
+            new NetworkError(
+              error.response.statusText ?? "Unknown",
+              error.response.data
+            )
+          );
+      }
+    } else {
+      return Promise.reject(new Error(error.message));
+    }
+  }
+}
+
+export { CallBuilder };
+//# sourceMappingURL=call_builder.js.map