@ttctl/core 0.0.0 → 0.1.0-rc.1

package/dist/services/payments/index.js

@@ -0,0 +1,636 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * `payments` service module — read payouts, list configured payment
+ * methods, inspect the talent's current rate, and submit rate-change
+ * requests on engagements.
+ *
+ * In Toptal vocabulary, "Payments" is the talent's earnings surface:
+ *   - **Payouts** — historical `TalentPayment` events (billing-cycle
+ *     paid amounts, memorandums, status — DUE / PAID / DISPUTED / etc.)
+ *   - **Methods** — `PaymentOption` records (Payoneer / direct deposit /
+ *     etc.) the talent has configured.
+ *   - **Rate** — the talent's hourly rate as defaulted on
+ *     `viewerRole.hourlyRate` (the "rack rate" used for future
+ *     engagements). Per-engagement rates live on
+ *     `engagement.currentAgreement.talentRate` (already surfaced by the
+ *     `engagements` service). A talent can request a rate change via
+ *     `CreateRateChangeRequest`; the most recent / ongoing request is
+ *     readable via `viewer.lastRateChangeRequest` /
+ *     `viewer.ongoingRateChangeRequest`.
+ *
+ * | Leaf                              | Operation(s)                          |
+ * |-----------------------------------|---------------------------------------|
+ * | `payouts.list`                    | `Payments(filters: PaymentFilter)`    |
+ * | `payouts.show`                    | `Payment(id: ID!)` (Relay `node`)     |
+ * | `methods.list`                    | `PaymentOptions` (hand-authored)      |
+ * | `methods.show`                    | `methods.list` + client-side filter   |
+ * | `rate.show`                       | `LastRateChangeRequest` + `RateChangeFormDetails` |
+ * | `rate.questions`                  | `RateChangeRequestQuestions`          |
+ * | `rate.change`                     | `CreateRateChangeRequest(input)`      |
+ *
+ * **Routing**: All ops talk to the **mobile-gateway** surface
+ * (`https://www.toptal.com/gateway/graphql/talent/graphql`) via
+ * `stockTransport`. Plain HTTPS — no Cloudflare, no TLS impersonation
+ * needed. Same surface as `engagements`, `jobs`, `applications`.
+ *
+ * **Operations are inlined as strings** (NOT codegen-driven). Every
+ * payment-domain operation is in `GATEWAY_{MOBILE,PORTAL}_KNOWN_UNTRUSTED_OPS`
+ * per `codegen.config.ts` — the SDL synthesizer has `Unknown` placeholders
+ * for `PaymentFilter.{kind,status,…}` and the `engagement: Unknown` field
+ * on `RateChangeRequest`, so generated types do not exist. Captured
+ * operation documents live in:
+ *   - `../research/graphql/gateway/operations/mobile/Payments.graphql`
+ *   - `../research/graphql/gateway/operations/mobile/Payment.graphql`
+ *   - `../research/graphql/gateway/operations/mobile/LastRateChangeRequest.graphql`
+ *   - `../research/graphql/gateway/operations/mobile/RateChangeRequestQuestions.graphql`
+ *   - `../research/graphql/gateway/operations/mobile/RateChangeFormDetails.graphql`
+ *   - `../research/graphql/gateway/operations/mobile/CreateRateChangeRequest.graphql`
+ *   - `PaymentOptions` is hand-authored (the captured portal op
+ *     `GetTalentPaymentOptions` doesn't have a mobile sibling; this
+ *     service uses a minimal projection compatible with the mobile-gateway
+ *     surface; verified-via-E2E).
+ *
+ * **CLAUDE.md schema/contract validation rule**: Every operation in
+ * this module is **[INFERRED — UNVERIFIED]** until its gated
+ * `*.e2e.test.ts` file passes against a live session. The mutation
+ * (`rate.change`) is the highest-stakes trigger; ALL operations need
+ * E2E coverage before merge per `scripts/check-e2e-coverage.ts`.
+ *
+ * **Rate-change semantics**:
+ *   - `requestType: CURRENT_ENGAGEMENT` — rate change for ONE existing
+ *     engagement; requires `engagementId`.
+ *   - `requestType: FUTURE_ENGAGEMENTS` — change the talent's default
+ *     "rack rate" applied to NEW engagement applications. Does NOT
+ *     affect any active engagements.
+ *   - `requestType: CONSULTATION` — rate change for the consultation
+ *     surface (separate from engagement work). The talent's role must
+ *     support consultations; rejection by the server surfaces as
+ *     `MUTATION_ERROR` here.
+ *
+ * **Out of scope for v1** (deferred to follow-ups):
+ *   - Payment-method mutations (create / update / remove /
+ *     mark-as-preferred) — explicitly excluded per issue #149's
+ *     out-of-scope list.
+ *   - Withdrawal request initiation — Toptal admin-side flow.
+ *   - Tax document generation / download — post-v1.
+ *   - Cross-engagement payment aggregation beyond what the API
+ *     surfaces.
+ */
+import { z } from "zod";
+import { VerticalGlobalMarketConditionSchema, VerticalMarketConditionSchema } from "../../__generated__/zod-schemas.js";
+import { buildDryRunPreview } from "../../transport.js";
+import { callGatewayShared } from "../_shared/transport.js";
+export class PaymentsError extends Error {
+    code;
+    name = "PaymentsError";
+    constructor(code, message, options) {
+        super(message, options);
+        this.code = code;
+    }
+}
+// ---------------------------------------------------------------------
+// Public types — rate namespace
+// ---------------------------------------------------------------------
+/**
+ * Three flavors of rate-change request, mapped to the wire enum
+ * `RateChangeRequestTypeEnum`.
+ */
+export const RATE_CHANGE_KINDS = ["current-engagement", "future-engagements", "consultation"];
+const RATE_CHANGE_KIND_TO_WIRE = {
+    "current-engagement": "CURRENT_ENGAGEMENT",
+    "future-engagements": "FUTURE_ENGAGEMENTS",
+    consultation: "CONSULTATION",
+};
+const RATE_CHANGE_STATUS_VERBOSE = {
+    PENDING: "Pending",
+    CLAIMED: "Claimed",
+    COMPLETED: "Completed",
+};
+// ---------------------------------------------------------------------
+// GraphQL operation strings — verbatim from captured documents where
+// possible. Hand-authored ops carry a doc-string note.
+// ---------------------------------------------------------------------
+// Verbatim from `../research/graphql/gateway/operations/mobile/Payments.graphql`.
+const PAYMENTS_QUERY = `query Payments($filters: PaymentFilter) { viewer { __typename id payments(offsetPagination: { offset: 0 limit: 20 } , filters: $filters) { __typename ...paymentsData } } }  fragment paymentFields on TalentPayment { __typename amount correctionAmount billingCycle { __typename id endDate startDate } description job { __typename id title client { __typename id fullName } } memorandums { __typename nodes { __typename amount balance downloadPdfUrl effectiveDate id } } kindCategory paymentGroupId createdAt updatedAt downloadPdfUrl dueDate paidAt id number status }  fragment paymentsData on PaymentsConnection { __typename ids nodes { __typename ...paymentFields } summary { __typename totalDisputed totalDue totalOnHold totalOutstanding totalOverdue totalPaid } }`;
+// Verbatim from `../research/graphql/gateway/operations/mobile/Payment.graphql`.
+const PAYMENT_QUERY = `query Payment($id: ID!) { node(id: $id) { __typename ... on TalentPayment { ...paymentFields } } }  fragment paymentFields on TalentPayment { __typename amount correctionAmount billingCycle { __typename id endDate startDate } description job { __typename id title client { __typename id fullName } } memorandums { __typename nodes { __typename amount balance downloadPdfUrl effectiveDate id } } kindCategory paymentGroupId createdAt updatedAt downloadPdfUrl dueDate paidAt id number status }`;
+// Hand-authored — no mobile-side `PaymentOptions` operation exists in
+// the research repo. Minimal projection covering what the v1 CLI / MCP
+// surface needs. Live-validated via E2E (`32-payments-methods.e2e.test.ts`).
+//
+// Per CLAUDE.md § Schema/contract validation rule, this operation is
+// hand-authored → mandatory live E2E coverage. The `paymentOptions`
+// field on `Viewer` exists in the synthesized SDL via portal capture;
+// the empirical question is whether the mobile-gateway endpoint serves
+// it (the assumption is yes since portal + mobile share the same
+// backend per `08-portal-api.md`).
+const PAYMENT_OPTIONS_QUERY = `query PaymentOptions { viewer { __typename id paymentOptions { __typename id paymentMethod preferredOption fullName payoneerId comment toptalPaymentsPending } } }`;
+// Verbatim from `../research/graphql/gateway/operations/mobile/LastRateChangeRequest.graphql`.
+const LAST_RATE_CHANGE_REQUEST_QUERY = `query LastRateChangeRequest { viewer { __typename id ...lastRateChangeRequestData } }  fragment rateInsightForCommitmentData on TalentRateInsightForCommitment { __typename currentRateCompetitive recentApplicationRate recommendedRate }  fragment profileRatesData on ViewerRole { __typename rates { __typename hourly } rateInsight { __typename hourly { __typename ...rateInsightForCommitmentData } } }  fragment lastRateChangeRequestData on Viewer { __typename id lastRateChangeRequest { __typename id createdAt desiredRate engagement { __typename id job { __typename id title client { __typename id fullName } } currentAgreement { __typename commitment { __typename slug } } } outcomeRate requestType status talentComment } viewerRole { __typename ...profileRatesData } }`;
+// Verbatim from `../research/graphql/gateway/operations/mobile/RateChangeFormDetails.graphql`.
+const RATE_CHANGE_FORM_DETAILS_QUERY = `query RateChangeFormDetails { viewer { __typename id ...marketConditionData viewerRole { __typename ...profileRatesData } } platformConfiguration { __typename ...rateValidationRulesData } }  fragment marketConditionData on Viewer { __typename viewerRole { __typename vertical { __typename name marketCondition { __typename condition } globalMarketCondition { __typename condition conditionColor conditionVerbose reportUrl } } } }  fragment rateInsightForCommitmentData on TalentRateInsightForCommitment { __typename currentRateCompetitive recentApplicationRate recommendedRate }  fragment profileRatesData on ViewerRole { __typename rates { __typename hourly } rateInsight { __typename hourly { __typename ...rateInsightForCommitmentData } } }  fragment talentRateValidationRuleData on TalentRateValidationRule { __typename minRate rateStep }  fragment rateValidationRulesData on PlatformConfiguration { __typename id rateValidationRules { __typename hourly { __typename ...talentRateValidationRuleData } } }`;
+// Verbatim from `../research/graphql/gateway/operations/mobile/RateChangeRequestQuestions.graphql`.
+const RATE_CHANGE_QUESTIONS_QUERY = `query RateChangeRequestQuestions { viewer { id rateChangeRequestQuestions { id ...RateChangeRequestQuestion } } }  fragment RateChangeRequestQuestion on RateChangeRequestQuestion { id kind label options { commentRequired label } }`;
+// Verbatim from `../research/graphql/gateway/operations/mobile/CreateRateChangeRequest.graphql`.
+const CREATE_RATE_CHANGE_REQUEST_MUTATION = `mutation CreateRateChangeRequest($desiredRate: BigDecimal, $engagementId: ID, $requestType: RateChangeRequestTypeEnum!, $talentComment: String, $answers: [RateChangeRequestAnswerInput!]!) { viewerRole { __typename createRateChangeRequest(input: { answers: $answers desiredRate: $desiredRate engagementId: $engagementId requestType: $requestType talentComment: $talentComment } ) { __typename ...mutationResultFields notice viewer { __typename id ...lastRateChangeRequestData } } } }  fragment mutationResultFields on MutationResult { __typename errors { __typename key message code } success }  fragment rateInsightForCommitmentData on TalentRateInsightForCommitment { __typename currentRateCompetitive recentApplicationRate recommendedRate }  fragment profileRatesData on ViewerRole { __typename rates { __typename hourly } rateInsight { __typename hourly { __typename ...rateInsightForCommitmentData } } }  fragment lastRateChangeRequestData on Viewer { __typename id lastRateChangeRequest { __typename id createdAt desiredRate engagement { __typename id job { __typename id title client { __typename id fullName } } currentAgreement { __typename commitment { __typename slug } } } outcomeRate requestType status talentComment } viewerRole { __typename ...profileRatesData } }`;
+/**
+ * Z-4 (#288) beachhead schema — first production wire-up of the
+ * runtime-validation seam built in Z-3 (#286). Validates the
+ * `RateChangeFormDetails` mobile-gateway response against the
+ * structural shape `rate.show()` depends on.
+ *
+ * Beachhead choice rationale:
+ *   - `RateChangeFormDetails` is the SOLE existing `callGateway` site
+ *     in the codebase using a TRUSTED operation (i.e., NOT in
+ *     `GATEWAY_{MOBILE,PORTAL}_KNOWN_UNTRUSTED_OPS` per
+ *     `codegen.config.ts`). The codegen emits a
+ *     `RateChangeFormDetailsQuery` type in `gateway.ts`, confirming
+ *     the operation passes SDL validation end-to-end.
+ *   - The query text in `RATE_CHANGE_FORM_DETAILS_QUERY` above is
+ *     verbatim from `../research/graphql/gateway/operations/mobile/
+ *     RateChangeFormDetails.graphql`, so the wire response is exactly
+ *     what the SDL declares.
+ *
+ * Generated zod sub-schemas used directly:
+ *   - {@link VerticalMarketConditionSchema} — the wire's
+ *     `viewerRole.vertical.marketCondition` selection (`{ condition }`)
+ *     matches the SDL type `VerticalMarketCondition` exactly. No
+ *     `__typename` mismatch risk for the inner type because the
+ *     selection includes `__typename` per the verbatim query.
+ *   - {@link VerticalGlobalMarketConditionSchema} — the wire's
+ *     `viewerRole.vertical.globalMarketCondition` selection
+ *     (`{ condition, conditionColor, conditionVerbose, reportUrl }`)
+ *     matches the SDL type `VerticalGlobalMarketCondition` exactly
+ *     (4 string fields).
+ *
+ * Inline (NOT-from-codegen) sub-schemas used elsewhere:
+ *   - `viewer` / `viewerRole` / `vertical` / `platformConfiguration`
+ *     envelopes — partial selections of larger SDL types; the
+ *     auto-generated `ViewerSchema` etc. require every SDL-declared
+ *     field, which the operation does not select. An inline shape
+ *     matches the actual selection set.
+ *   - `rates`, `rateInsight.hourly`, and
+ *     `platformConfiguration.rateValidationRules.hourly` — the SDL
+ *     declares `TalentRate.hourly: String!` (non-null),
+ *     `TalentRateInsightForCommitment.currentRateCompetitive: Boolean!`
+ *     (boolean), and `TalentRateValidationRule.rateStep: Int!`
+ *     (number). The hand-rolled service-layer types
+ *     (`WireViewerRoleRates`, `WireRateInsightForCommitment`,
+ *     `WireTalentRateValidationRule`) declare `hourly` as
+ *     `string | null` (defensive null tolerance) and now declare
+ *     `currentRateCompetitive` as `boolean | null` and `rateStep` as
+ *     `number | null` (SDL-aligned per #319 — pre-#319 they were
+ *     widened to `string | null`, the T2 Zod validator caught the
+ *     drift on the live wire on 2026-05-15).
+ *
+ * Schema/contract rule disposition: NOT triggered. The wire shape
+ * being validated is the SAME shape the hand-rolled types now
+ * encode; the schema is a structural mirror. Issue #319 reconciled
+ * the `currentRateCompetitive` / `rateStep` types with the SDL truth
+ * and the live wire (post-Z-4 beachhead follow-up).
+ *
+ * Vertical is `.optional()` because the existing in-tree unit
+ * fixtures for `rate.show` don't carry it (the hand-rolled
+ * `WireViewerRole` doesn't declare `vertical` either). The live wire
+ * does include it per the verbatim query selection — `.optional()`
+ * keeps the schema compatible with both shapes.
+ */
+const RATE_CHANGE_FORM_DETAILS_RESPONSE_SCHEMA = z.object({
+    viewer: z
+        .object({
+        id: z.string(),
+        viewerRole: z
+            .object({
+            vertical: z
+                .object({
+                name: z.string(),
+                marketCondition: VerticalMarketConditionSchema(),
+                globalMarketCondition: VerticalGlobalMarketConditionSchema(),
+            })
+                .optional(),
+            rates: z
+                .object({
+                hourly: z.string().nullable(),
+            })
+                .nullable(),
+            rateInsight: z
+                .object({
+                hourly: z
+                    .object({
+                    // `Boolean!` per SDL; live wire returns JSON boolean (#319).
+                    currentRateCompetitive: z.boolean().nullable(),
+                    recentApplicationRate: z.string().nullable(),
+                    recommendedRate: z.string().nullable(),
+                })
+                    .nullable(),
+            })
+                .nullable(),
+        })
+            .nullable(),
+    })
+        .nullable(),
+    platformConfiguration: z
+        .object({
+        id: z.string(),
+        rateValidationRules: z
+            .object({
+            hourly: z
+                .object({
+                minRate: z.string().nullable(),
+                // `Int!` per SDL; live wire returns JSON number (#319).
+                rateStep: z.number().nullable(),
+            })
+                .nullable(),
+        })
+            .nullable(),
+    })
+        .nullable(),
+});
+// Wire pattern: bad Relay ID returns `Node id "<id>" resolves to ...`
+// per memory `project_toptal_wire_quirks.md`. Used by `payouts.show()`
+// to remap the wire-level decode error to a typed NOT_FOUND.
+const NODE_NOT_FOUND_PATTERN = /Node id .* resolves to/i;
+// ---------------------------------------------------------------------
+// Transport helper (mirrors the engagements/applications pattern)
+// ---------------------------------------------------------------------
+/**
+ * Thin per-service wrapper around {@link callGatewayShared} (issue
+ * #329). Pins the mobile-gateway surface and the {@link PaymentsError}
+ * domain class.
+ */
+async function callGateway(token, operationName, query, variables, schema) {
+    return callGatewayShared("mobile-gateway", token, operationName, query, variables, PaymentsError, {
+        schema,
+    });
+}
+function formatMutationErrors(prefix, errors) {
+    if (errors == null || errors.length === 0) {
+        return `${prefix}: no error detail returned.`;
+    }
+    const parts = errors.map((e) => {
+        const fields = [];
+        if (e.code != null)
+            fields.push(`code=${e.code}`);
+        if (e.key != null)
+            fields.push(`key=${e.key}`);
+        const head = fields.length > 0 ? `[${fields.join(", ")}] ` : "";
+        return `${head}${e.message ?? "(no message)"}`;
+    });
+    return `${prefix}: ${parts.join("; ")}`;
+}
+// ---------------------------------------------------------------------
+// Projections
+// ---------------------------------------------------------------------
+function emptyPayoutsSummary() {
+    return {
+        totalDisputed: "0",
+        totalDue: "0",
+        totalOnHold: "0",
+        totalOutstanding: "0",
+        totalOverdue: "0",
+        totalPaid: "0",
+    };
+}
+function projectMemorandum(wire) {
+    return {
+        id: wire.id,
+        amount: wire.amount,
+        balance: wire.balance,
+        downloadPdfUrl: wire.downloadPdfUrl,
+        effectiveDate: wire.effectiveDate,
+    };
+}
+function projectPayout(wire) {
+    const memos = (wire.memorandums?.nodes ?? []).filter((m) => m !== null);
+    return {
+        id: wire.id,
+        number: wire.number,
+        amount: wire.amount,
+        correctionAmount: wire.correctionAmount,
+        description: wire.description,
+        status: wire.status,
+        kindCategory: wire.kindCategory,
+        paymentGroupId: wire.paymentGroupId,
+        billingCycle: wire.billingCycle,
+        dueDate: wire.dueDate,
+        paidAt: wire.paidAt,
+        createdAt: wire.createdAt,
+        updatedAt: wire.updatedAt,
+        downloadPdfUrl: wire.downloadPdfUrl,
+        job: wire.job,
+        memorandums: memos.map(projectMemorandum),
+    };
+}
+function projectPaymentMethod(wire) {
+    return {
+        id: wire.id,
+        paymentMethod: wire.paymentMethod,
+        preferredOption: wire.preferredOption,
+        fullName: wire.fullName,
+        payoneerId: wire.payoneerId,
+        comment: wire.comment,
+        toptalPaymentsPending: wire.toptalPaymentsPending,
+    };
+}
+function projectRateChangeRequest(wire) {
+    const job = wire.engagement?.job ?? null;
+    return {
+        id: wire.id,
+        createdAt: wire.createdAt,
+        desiredRate: wire.desiredRate,
+        outcomeRate: wire.outcomeRate,
+        requestType: wire.requestType,
+        status: wire.status,
+        statusVerbose: RATE_CHANGE_STATUS_VERBOSE[wire.status] ?? wire.status,
+        talentComment: wire.talentComment,
+        engagementId: wire.engagement?.id ?? null,
+        engagementTitle: job?.title ?? null,
+        clientName: job?.client?.fullName ?? null,
+    };
+}
+function projectRateQuestion(wire) {
+    const opts = (wire.options ?? []).filter((o) => o !== null);
+    return {
+        id: wire.id,
+        kind: wire.kind,
+        label: wire.label,
+        options: opts.map((o) => ({ label: o.label, commentRequired: o.commentRequired })),
+    };
+}
+// ---------------------------------------------------------------------
+// Payouts namespace
+// ---------------------------------------------------------------------
+/**
+ * Payouts — historical `TalentPayment` events. Read-only in v1.
+ */
+export const payouts = {
+    /**
+     * List historical payouts. Default pagination is the captured wire
+     * shape: `offset: 0 limit: 20` (hardcoded in the operation). The
+     * server returns the most recent 20 paid/due payouts by default;
+     * date filtering narrows the window.
+     *
+     * Filter map: `fromDate` / `toDate` flow into the wire's
+     * `filters.createdOn` field, which expects an inclusive-on-both-ends
+     * `DateFilter` shape `{from?: Date, to?: Date}`. Empty filter object
+     * (`opts === {}`) sends `filters: null` per Toptal convention.
+     *
+     * Returns an array of {@link Payout} rows AND the server-provided
+     * {@link PayoutsSummary} aggregates for the same filter window —
+     * surfacing both lets the CLI render a summary line above the table
+     * without a second round-trip.
+     */
+    async list(token, opts = {}) {
+        const hasFilter = opts.fromDate !== undefined || opts.toDate !== undefined;
+        const variables = {
+            filters: hasFilter ? { createdOn: { from: opts.fromDate ?? null, to: opts.toDate ?? null } } : null,
+        };
+        const data = await callGateway(token, "Payments", PAYMENTS_QUERY, variables);
+        if (data.viewer === null) {
+            throw new PaymentsError("NO_VIEWER", "Session is valid but no viewer is bound to it.");
+        }
+        if (data.viewer.payments === null) {
+            return { items: [], summary: emptyPayoutsSummary() };
+        }
+        const nodes = (data.viewer.payments.nodes ?? []).filter((n) => n !== null);
+        return {
+            items: nodes.map(projectPayout),
+            summary: data.viewer.payments.summary ?? emptyPayoutsSummary(),
+        };
+    },
+    /**
+     * Fetch a single payout's detail by `TalentPayment.id`.
+     *
+     * Throws `PaymentsError("NOT_FOUND")` when the id doesn't resolve
+     * (two wire shapes both fold here: the Relay `node` returning `null`,
+     * AND the gateway returning a `Node id "<id>" resolves to ...` decode
+     * error in `errors[]`).
+     */
+    async show(token, id) {
+        let data;
+        try {
+            data = await callGateway(token, "Payment", PAYMENT_QUERY, { id });
+        }
+        catch (err) {
+            if (err instanceof PaymentsError && err.code === "GRAPHQL_ERROR" && NODE_NOT_FOUND_PATTERN.test(err.message)) {
+                throw new PaymentsError("NOT_FOUND", `No payout found with id "${id}" (or you don't have access to it).`, {
+                    cause: err,
+                });
+            }
+            throw err;
+        }
+        if (data.node === null) {
+            throw new PaymentsError("NOT_FOUND", `No payout found with id "${id}" (or you don't have access to it).`);
+        }
+        return projectPayout(data.node);
+    },
+};
+// ---------------------------------------------------------------------
+// Methods namespace
+// ---------------------------------------------------------------------
+/**
+ * Payment methods — `PaymentOption` records configured by the talent.
+ * Read-only in v1; mutations (create / update / mark-as-preferred /
+ * remove) are explicitly out of scope per #149.
+ */
+export const methods = {
+    /**
+     * List configured payment methods. No filter args on the wire — the
+     * full list is small (typically 1-3 entries).
+     *
+     * `preferredOption: true` marks the active method; the CLI / MCP
+     * surface annotates this in the rendered output.
+     */
+    async list(token) {
+        const data = await callGateway(token, "PaymentOptions", PAYMENT_OPTIONS_QUERY, {});
+        if (data.viewer === null) {
+            throw new PaymentsError("NO_VIEWER", "Session is valid but no viewer is bound to it.");
+        }
+        const wires = (data.viewer.paymentOptions ?? []).filter((p) => p !== null);
+        return wires.map(projectPaymentMethod);
+    },
+    /**
+     * Fetch a single payment method by id. The wire has no per-id query;
+     * this client-side filter on {@link methods.list} is the API reality.
+     * Adds one round-trip cost relative to a hypothetical
+     * `paymentOption(id)` query — acceptable given the list is small.
+     *
+     * Throws `PaymentsError("NOT_FOUND")` when no entry matches.
+     */
+    async show(token, id) {
+        const list = await methods.list(token);
+        const found = list.find((m) => m.id === id);
+        if (found === undefined) {
+            throw new PaymentsError("NOT_FOUND", `No payment method found with id "${id}".`);
+        }
+        return found;
+    },
+};
+// ---------------------------------------------------------------------
+// Rate namespace
+// ---------------------------------------------------------------------
+function projectViewerRoleRate(role) {
+    if (role === null)
+        return { decimal: null, verbose: null };
+    const decimal = role.rates?.hourly ?? null;
+    const verbose = role.hourlyRate?.verbose ?? null;
+    return { decimal, verbose };
+}
+function projectMarketInsight(role) {
+    const insight = role?.rateInsight?.hourly;
+    if (insight == null)
+        return null;
+    return {
+        currentRateCompetitive: insight.currentRateCompetitive,
+        recentApplicationRate: insight.recentApplicationRate,
+        recommendedRate: insight.recommendedRate,
+    };
+}
+function projectValidation(config) {
+    const hourly = config?.rateValidationRules?.hourly;
+    if (hourly == null)
+        return null;
+    return { minRate: hourly.minRate, rateStep: hourly.rateStep };
+}
+function classifyOngoing(req) {
+    if (req === null)
+        return null;
+    if (req.status !== "PENDING" && req.status !== "CLAIMED")
+        return null;
+    return projectRateChangeRequest(req);
+}
+/**
+ * Rate management — show the current rate + change history; submit a
+ * rate-change request.
+ */
+export const rate = {
+    /**
+     * Show the talent's current rate + most-recent rate-change request
+     * + market insight + validation rules. Issues TWO parallel queries:
+     *   - `LastRateChangeRequest` — carries the most-recent change AND
+     *     the current rates / market insight on the viewerRole side.
+     *   - `RateChangeFormDetails` — carries the rate-validation rules
+     *     (minRate / rateStep) the server enforces on `rate.change`.
+     *
+     * Both queries return overlapping viewerRole / rateInsight projections;
+     * we prefer the `LastRateChangeRequest` shape for those fields (its
+     * projection is denser) and fall back to `RateChangeFormDetails` for
+     * the validation rules (only this query exposes them).
+     *
+     * The wire's `ongoingRateChangeRequest` field is `Unknown`-typed and
+     * not exposed on `lastRateChangeRequest`; this projection classifies
+     * the returned `lastRateChangeRequest` by status — `PENDING` /
+     * `CLAIMED` count as "ongoing"; `COMPLETED` counts only as "last".
+     * If the wire shape ever grows a separate `ongoingRateChangeRequest`
+     * field that can be projected, swap the classification here for a
+     * direct read.
+     */
+    async show(token) {
+        const [lastData, formData] = await Promise.all([
+            callGateway(token, "LastRateChangeRequest", LAST_RATE_CHANGE_REQUEST_QUERY, {}),
+            // Z-4 (#288) beachhead: the only `callGateway` site that passes
+            // a schema. See `RATE_CHANGE_FORM_DETAILS_RESPONSE_SCHEMA` for
+            // the audit transcript and the SDL-vs-hand-rolled disposition.
+            callGateway(token, "RateChangeFormDetails", RATE_CHANGE_FORM_DETAILS_QUERY, {}, RATE_CHANGE_FORM_DETAILS_RESPONSE_SCHEMA),
+        ]);
+        if (lastData.viewer === null) {
+            throw new PaymentsError("NO_VIEWER", "Session is valid but no viewer is bound to it.");
+        }
+        const lastWire = lastData.viewer.lastRateChangeRequest;
+        const last = lastWire !== null ? projectRateChangeRequest(lastWire) : null;
+        const ongoing = classifyOngoing(lastWire);
+        const role = lastData.viewer.viewerRole ?? formData.viewer?.viewerRole ?? null;
+        const rates = projectViewerRoleRate(role);
+        return {
+            currentRateVerbose: rates.verbose,
+            currentRateDecimal: rates.decimal,
+            lastChange: last,
+            ongoingChange: ongoing,
+            marketInsight: projectMarketInsight(role),
+            validation: projectValidation(formData.platformConfiguration ?? null),
+        };
+    },
+    /**
+     * Fetch the rate-change form's question catalog. Answers to these
+     * questions are required as the `answers[]` input to
+     * {@link rate.change}. Mirrors the discovery pattern of
+     * `engagements.breaks.reasonsList()`.
+     */
+    async questions(token) {
+        const data = await callGateway(token, "RateChangeRequestQuestions", RATE_CHANGE_QUESTIONS_QUERY, {});
+        if (data.viewer === null) {
+            throw new PaymentsError("NO_VIEWER", "Session is valid but no viewer is bound to it.");
+        }
+        const wires = (data.viewer.rateChangeRequestQuestions ?? []).filter((q) => q !== null);
+        return wires.map(projectRateQuestion);
+    },
+    /**
+     * Submit a rate-change request. Client-side validation:
+     *   - `kind === "current-engagement"` requires `engagementId`.
+     *   - Other kinds reject `engagementId`.
+     *   - `desiredRate` and `answers` are passed verbatim to the wire.
+     *
+     * Dry-run path: when `dryRunOpts.dryRun === true`, short-circuit
+     * before any transport call and return a {@link DryRunPreview}-bearing
+     * outcome. No prefetch is required (the mutation has no implicit
+     * read).
+     *
+     * Apply path: invokes `CreateRateChangeRequest`. On `success: false`,
+     * throws `PaymentsError("MUTATION_ERROR")` with formatted per-field
+     * errors.
+     */
+    async change(token, opts, dryRunOpts = {}) {
+        // Client-side validation — surface BEFORE any transport call.
+        if (opts.kind === "current-engagement" && (opts.engagementId === undefined || opts.engagementId === "")) {
+            throw new PaymentsError("MISSING_INPUT", "`rate change --kind=current-engagement` requires `--engagement <id>`.");
+        }
+        if (opts.kind !== "current-engagement" && opts.engagementId !== undefined && opts.engagementId !== "") {
+            throw new PaymentsError("MISSING_INPUT", `\`rate change --kind=${opts.kind}\` rejects \`--engagement <id>\` — drop the flag (the change is account-wide for this kind).`);
+        }
+        const wireAnswers = opts.answers.map((a) => {
+            const wire = { questionId: a.questionId, value: a.value };
+            if (a.comment !== undefined)
+                wire["comment"] = a.comment;
+            return wire;
+        });
+        const variables = {
+            desiredRate: opts.desiredRate,
+            engagementId: opts.engagementId ?? null,
+            requestType: RATE_CHANGE_KIND_TO_WIRE[opts.kind],
+            talentComment: opts.talentComment ?? null,
+            answers: wireAnswers,
+        };
+        if (dryRunOpts.dryRun === true) {
+            return {
+                kind: "preview",
+                preview: buildDryRunPreview({
+                    surface: "mobile-gateway",
+                    authToken: token,
+                    body: {
+                        operationName: "CreateRateChangeRequest",
+                        query: CREATE_RATE_CHANGE_REQUEST_MUTATION,
+                        variables,
+                    },
+                }),
+            };
+        }
+        const data = await callGateway(token, "CreateRateChangeRequest", CREATE_RATE_CHANGE_REQUEST_MUTATION, variables);
+        if (data.viewerRole === null) {
+            throw new PaymentsError("UNKNOWN", "CreateRateChangeRequest response had no `viewerRole`.");
+        }
+        const result = data.viewerRole.createRateChangeRequest;
+        if (result === null) {
+            throw new PaymentsError("UNKNOWN", "CreateRateChangeRequest returned a null payload.");
+        }
+        if (!result.success) {
+            throw new PaymentsError("MUTATION_ERROR", formatMutationErrors("CreateRateChangeRequest failed", result.errors));
+        }
+        const wire = result.viewer?.lastRateChangeRequest ?? null;
+        if (wire === null) {
+            throw new PaymentsError("UNKNOWN", "CreateRateChangeRequest reported success but the returned `viewer.lastRateChangeRequest` was null.");
+        }
+        return { kind: "applied", result: projectRateChangeRequest(wire), notice: result.notice };
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/services/payments/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/payments/index.ts"],"names":[],"mappings":"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"}