@delopay/sdk 0.137.0 → 0.139.0

package/dist/internal.cjs

@@ -67,6 +67,7 @@ __export(internal_exports, {
   DelopayAuthenticationError: () => DelopayAuthenticationError,
   DelopayError: () => DelopayError,
   DelopayInternal: () => DelopayInternal,
+  Diagnostic: () => Diagnostic,
   Export: () => Export,
   FeatureMatrix: () => FeatureMatrix,
   FeeProgramBuilder: () => FeeProgramBuilder,
@@ -8784,6 +8785,210 @@ var ConnectorRestrictions = class {
   }
 };
 
+// src/internal/resources/diagnostic.ts
+var Diagnostic = class {
+  constructor(request) {
+    this.request = request;
+  }
+  /**
+   * The ranked attention board — the page's landing state, with nothing typed.
+   *
+   * Always carries `checks_run` and `vitals`, so an empty `items` reads as
+   * "checked these things at 14:02, all clear" rather than as a panel that
+   * failed to load. A check that could not run is **absent** from `checks_run`
+   * rather than silently counted as clear.
+   */
+  async attention(body) {
+    return this.request("POST", "/admin-portal/diagnostic/attention", { body: body ?? {} });
+  }
+  /**
+   * Provider webhooks received, across every merchant.
+   *
+   * `source_verified: false` selects rows that failed verification **or** never
+   * reached it — the deliveries that failed before verification was attempted
+   * are exactly the ones an operator opens this tab for.
+   */
+  async listIncomingWebhooks(body) {
+    return this.request("POST", "/admin-portal/diagnostic/webhooks/incoming", {
+      body: body ?? {}
+    });
+  }
+  /**
+   * One delivery in full: masked headers and body, the verification verdict,
+   * and the router log lines for its request id.
+   *
+   * `router_logs` is `null` — not `[]` — when the log store is unreachable, and
+   * `router_logs_unavailable` then says why. Render the first as *unavailable*,
+   * never as "the router logged nothing".
+   */
+  async getIncomingWebhook(eventId) {
+    return this.request(
+      "GET",
+      `/admin-portal/diagnostic/webhooks/incoming/${encodeURIComponent(eventId)}`
+    );
+  }
+  /** Shop webhooks sent, across every merchant, with each event's attempts folded in. */
+  async listOutgoingWebhooks(body) {
+    return this.request("POST", "/admin-portal/diagnostic/webhooks/outgoing", {
+      body: body ?? {}
+    });
+  }
+  /**
+   * The four tiles above the shop-webhooks table.
+   *
+   * Counted under the same window and environment as the table but **without**
+   * its delivery filter — the tiles say what the window holds, and applying the
+   * filter would make every tile agree with whichever one is selected.
+   */
+  async outgoingWebhookSummary(body) {
+    return this.request("POST", "/admin-portal/diagnostic/webhooks/outgoing/summary", {
+      body: body ?? {}
+    });
+  }
+  /**
+   * Connector calls the router made.
+   *
+   * List rows carry no payload. Fetch one with {@link getConnectorCall} for the
+   * masked request and response.
+   */
+  async listConnectorCalls(body) {
+    return this.request("POST", "/admin-portal/diagnostic/connector-calls", { body: body ?? {} });
+  }
+  /** One connector call, with its masked payloads. */
+  async getConnectorCall(id) {
+    return this.request(
+      "GET",
+      `/admin-portal/diagnostic/connector-calls/${encodeURIComponent(id)}`
+    );
+  }
+  /**
+   * Router logs, proxied from the deployment's log store.
+   *
+   * Answers a {@link DiagnosticPanel}. Check `status` before reading `data`:
+   * `'unavailable'` means the store did not answer, which is the opposite of
+   * "there were no errors" and must be rendered as such.
+   */
+  async routerLogs(body) {
+    return this.request("POST", "/admin-portal/diagnostic/logs", { body: body ?? {} });
+  }
+  /**
+   * Payments that are stuck or failed.
+   *
+   * Stuck means non-terminal for longer than `stuck_minutes`; failed means it
+   * ended without succeeding inside the window. Omitting `stuck_minutes` turns
+   * the first arm off rather than widening it.
+   */
+  async listPayments(body) {
+    return this.request("POST", "/admin-portal/diagnostic/payments", { body: body ?? {} });
+  }
+  /**
+   * The error codes in this window, each with its count in the previous window
+   * of equal length.
+   *
+   * `previous_count: null` means the code did not appear before — render it as
+   * "new" rather than as a fall to zero.
+   */
+  async paymentErrorCodes(body) {
+    return this.request("POST", "/admin-portal/diagnostic/payments/error-codes", {
+      body: body ?? {}
+    });
+  }
+  /**
+   * Everything about one payment, in one call: the payment, its attempts, its
+   * status history, its client context, and what it produced — connector calls,
+   * webhooks both ways, and scheduler jobs.
+   *
+   * Read `diagnostic_capture` before rendering an empty section. A payment with
+   * no connector calls and a deployment that never recorded any are different
+   * facts, and the second must not read as the first.
+   *
+   * Typed loosely on purpose: the payment, attempts, status-history and
+   * client-context halves are the merchant-facing shapes this package already
+   * exports, and re-declaring them here would give consumers two names for one
+   * thing that could then drift apart.
+   */
+  async getPayment(paymentId) {
+    return this.request(
+      "GET",
+      `/admin-portal/diagnostic/payments/${encodeURIComponent(paymentId)}`
+    );
+  }
+  /** Scheduler tasks, most overdue first. */
+  async listQueues(body) {
+    return this.request("POST", "/admin-portal/diagnostic/queues", { body: body ?? {} });
+  }
+  /**
+   * The four tiles above the queues table, plus the approvals count.
+   *
+   * `pending_approvals` is a **different** queue from `pending_count`: a stalled
+   * scheduler needs a consumer, a full approvals queue needs a person, and
+   * folding them into one number would point an operator at the wrong fix.
+   */
+  async queueSummary() {
+    return this.request("GET", "/admin-portal/diagnostic/queues/summary");
+  }
+  /**
+   * Replicas and their dependencies.
+   *
+   * `build_mismatch` is computed server-side rather than left for a caller to
+   * notice by comparing strings: one replica in four answering differently
+   * explains a whole class of "it only fails sometimes" incident, and is
+   * invisible unless something says it out loud.
+   */
+  async infrastructure() {
+    return this.request("GET", "/admin-portal/diagnostic/infrastructure");
+  }
+  /**
+   * Firing alerts, proxied from Alertmanager.
+   *
+   * Answers a {@link DiagnosticPanel} for the same reason {@link routerLogs}
+   * does: a strip that renders empty because Alertmanager is down says "nothing
+   * is firing", which is the most dangerous sentence this page could print.
+   */
+  async alerts() {
+    return this.request("GET", "/admin-portal/diagnostic/alerts");
+  }
+  /** Config edits and admin actions inside the window. */
+  async listChanges(body) {
+    return this.request("POST", "/admin-portal/diagnostic/changes", { body: body ?? {} });
+  }
+  /**
+   * What a pasted id is, and whether we hold it.
+   *
+   * `kind` and `found` are separate answers on purpose. A well-shaped id that
+   * matches nothing comes back `found: false` with the three `reasons` and
+   * their fixes — render that, never an empty table, which reads as "no such
+   * payment" when the real answer is "outside the window" or "it is a test
+   * payment".
+   */
+  async resolveId(id) {
+    return this.request("GET", `/admin-portal/diagnostic/resolve/${encodeURIComponent(id)}`);
+  }
+  /**
+   * One id across every source, as an ordered span list.
+   *
+   * Accepts a payment, attempt, event or request id. Sources that could not be
+   * read are named in `unavailable_sources` rather than left out: a waterfall
+   * with an unexplained gap reads as a period when nothing happened.
+   */
+  async trace(id) {
+    return this.request("GET", `/admin-portal/diagnostic/trace/${encodeURIComponent(id)}`);
+  }
+  /**
+   * Unmask one field of one object.
+   *
+   * **Writes an audit row** naming the operator, the field and the object,
+   * before the value is returned — a reveal that could not be audited does not
+   * happen. Needs a dashboard JWT holding `DiagnosticReveal`; an admin API key
+   * cannot call it, because an API key names no person.
+   *
+   * `reason` is required and is stored verbatim.
+   */
+  async reveal(body) {
+    return this.request("POST", "/admin-portal/diagnostic/reveal", { body });
+  }
+};
+
 // src/internal/resources/gsm.ts
 var Gsm = class {
   constructor(request) {
@@ -9072,6 +9277,7 @@ var DelopayInternal = class extends Delopay {
     this.configs = new Configs(request);
     this.connectorRestrictions = new ConnectorRestrictions(request);
     this.connectorRestrictionRules = new ConnectorRestrictionRules(request);
+    this.diagnostic = new Diagnostic(request);
     this.gsm = new Gsm(request);
     this.platformBilling = new PlatformBilling(request);
     this.platformFees = new PlatformFees(request);
@@ -9126,6 +9332,7 @@ var DelopayInternal = class extends Delopay {
   DelopayAuthenticationError,
   DelopayError,
   DelopayInternal,
+  Diagnostic,
   Export,
   FeatureMatrix,
   FeeProgramBuilder,