palbase 0.16.1 → 0.17.0

package/types/internal/src/modules/stores.d.ts

@@ -179,7 +179,7 @@ export type App = {
     upload_key?: UploadKey;
 };
 /**
- * stores.app.changed: an app was linked to its store.
+ * stores.app.changed: an app was linked to its store, or its App Store Connect record made or removed with the project's Apple ID.
  */
 export type AppChangedEvent = {
     /**
@@ -197,7 +197,7 @@ export type AppChangedEvent = {
     /**
      * What happened.
      */
-    change: "linked";
+    change: "linked" | "record_made" | "record_removed";
     /**
      * The platform (an Android app's link says it).
      */
@@ -2405,6 +2405,486 @@ export type WhatToTest = {
      */
     text: string;
 };
+/**
+ * Apple's code, with the link's grant.
+ */
+export type AppleIDCodeRequest = {
+    /**
+     * The six digits Apple sent.
+     */
+    code: string;
+    /**
+     * The link's grant.
+     */
+    grant: string;
+};
+/**
+ * A one-time link to sign an Apple ID in, and the key its password is sealed to: the password is sealed in the person's browser (connect_url) or terminal, and goes sealed, with the grant, to POST /stores/connect/apple-id.
+ */
+export type AppleIDGrant = {
+    /**
+     * The page that signs the Apple ID in from a browser. The grant rides in the URL's fragment, which a browser never sends to a server.
+     */
+    connect_url: string;
+    /**
+     * When the grant stops working.
+     */
+    expires_at: string;
+    /**
+     * The grant: spent when the Apple ID is connected, or after 15 minutes.
+     */
+    grant: string;
+    /**
+     * The project's X25519 public key (base64url, 32 bytes) the password is sealed to: HPKE (RFC 9180) base mode, DHKEM(X25519, HKDF-SHA256), HKDF-SHA256, AES-128-GCM, info `palbase/stores/apple-id/password/1`, a NUL byte, then the grant — palbase-js's hpkeSeal. Nothing on the password's way reads it; the stores module alone opens it.
+     */
+    seal_key: string;
+};
+/**
+ * An Apple ID and its sealed password, with the link's grant.
+ */
+export type AppleIDSignInRequest = {
+    /**
+     * The Apple ID.
+     */
+    apple_id: string;
+    /**
+     * The link's grant.
+     */
+    grant: string;
+    /**
+     * The password, sealed to the grant's seal_key (AppleIDGrant): base64url of the encapsulated key and the ciphertext. Opened by the stores module alone, handed to Apple, never kept. A password in the clear is no field of the request.
+     */
+    password_sealed: string;
+};
+/**
+ * Where a sign-in stands.
+ */
+export type AppleIDSignInStep = {
+    /**
+     * The phone it went to, as Apple masks it (`code`, `phone`).
+     */
+    destination?: string;
+    /**
+     * Where Apple sent the code (`code`): `trusted-device` or `phone`.
+     */
+    method?: string;
+    session?: AppleSession;
+    /**
+     * `code`: Apple sent a code; `team`: choose the team; `connected`: done.
+     */
+    step: "code" | "team" | "connected";
+    /**
+     * The Apple ID's teams (`team`).
+     */
+    teams?: AppleTeam[];
+};
+/**
+ * The team chosen, with the link's grant.
+ */
+export type AppleIDTeamRequest = {
+    /**
+     * The link's grant.
+     */
+    grant: string;
+    /**
+     * The team's `id`, from the `team` step.
+     */
+    team: string;
+};
+/**
+ * The project's Apple ID session: never the session itself.
+ */
+export type AppleSession = {
+    /**
+     * What the person has to do, when the session waits on them.
+     */
+    action?: string;
+    /**
+     * The Apple ID, as Apple says it.
+     */
+    apple_id?: string;
+    /**
+     * When Apple last said what it is.
+     */
+    checked_at?: string;
+    /**
+     * Whether an Apple ID is signed in.
+     */
+    connected: boolean;
+    /**
+     * When it was signed in.
+     */
+    connected_at?: string;
+    /**
+     * Who asked for the sign-in link: a developer's id, or the key's.
+     */
+    connected_by?: string;
+    /**
+     * When Apple's end of it was found.
+     */
+    expired_at?: string;
+    /**
+     * The Apple ID's roles in the team.
+     */
+    roles?: string[];
+    /**
+     * `active`, or `expired`: Apple ended the session; sign in again.
+     */
+    status?: "active" | "expired";
+    team?: AppleTeam;
+};
+/**
+ * stores.apple.session.changed: an Apple ID was signed in for the project, or disconnected. Never the session.
+ */
+export type AppleSessionChangedEvent = {
+    /**
+     * The Apple ID.
+     */
+    apple_id: string;
+    /**
+     * What happened.
+     */
+    change: "connected" | "disconnected";
+    team: AppleTeam;
+};
+/**
+ * stores.apple.session.expired: Apple ended the project's Apple ID session (it does after a few weeks, and when the password changes). What needs it answers 409 `apple_id_expired` until someone signs in again.
+ */
+export type AppleSessionExpiredEvent = {
+    /**
+     * The Apple ID.
+     */
+    apple_id: string;
+    team: AppleTeam;
+};
+/**
+ * An App Store Connect team (Apple's provider).
+ */
+export type AppleTeam = {
+    /**
+     * The team's public id at Apple.
+     */
+    id: string;
+    /**
+     * The team's name.
+     */
+    name: string;
+    /**
+     * Apple's number for the team.
+     */
+    provider_id: number;
+};
+/**
+ * A guideline a rejection names.
+ */
+export type ReviewReason = {
+    /**
+     * The guideline's section (2.1, 5.1.1…).
+     */
+    section?: string;
+    /**
+     * What App Review says of it.
+     */
+    description?: string;
+    /**
+     * Apple's code for it.
+     */
+    code?: string;
+};
+/**
+ * A rejection App Review wrote in a thread.
+ */
+export type ReviewRejection = {
+    /**
+     * The rejection.
+     */
+    id: string;
+    /**
+     * The guidelines it names.
+     */
+    reasons: ReviewReason[];
+    /**
+     * Its attachments' ids.
+     */
+    attachments: string[];
+};
+/**
+ * A message in a thread, as plain text.
+ */
+export type ReviewMessage = {
+    /**
+     * The message.
+     */
+    id: string;
+    /**
+     * When it was written, as Apple says it.
+     */
+    created_at?: string;
+    /**
+     * Who wrote it, as Apple says it (its actor's type).
+     */
+    from?: string;
+    /**
+     * Its text.
+     */
+    body: string;
+    /**
+     * The rejections it carries.
+     */
+    rejections: string[];
+    /**
+     * Its attachments' ids.
+     */
+    attachments: string[];
+};
+/**
+ * A file App Review attached.
+ */
+export type ReviewAttachment = {
+    /**
+     * The attachment.
+     */
+    id: string;
+    /**
+     * Its name.
+     */
+    file_name?: string;
+    /**
+     * Its size in bytes.
+     */
+    file_size?: number;
+    /**
+     * Whether Apple offers it for download.
+     */
+    downloadable: boolean;
+    /**
+     * The message it is of.
+     */
+    message_id?: string;
+    /**
+     * The rejection it is of.
+     */
+    rejection_id?: string;
+};
+/**
+ * The answer to a thread, not sent yet (a thread with none has no draft).
+ */
+export type ReviewDraft = {
+    /**
+     * The draft.
+     */
+    id: string;
+    /**
+     * Its text.
+     */
+    body: string;
+};
+/**
+ * A Resolution Center thread of the app: a rejection, or a message from App Review.
+ */
+export type ReviewThread = {
+    /**
+     * The thread.
+     */
+    id: string;
+    /**
+     * Apple's kind of thread (REJECTION_BINARY, REJECTION_METADATA, APP_MESSAGE_…).
+     */
+    type?: string;
+    /**
+     * Its state at Apple.
+     */
+    state?: string;
+    /**
+     * When it began.
+     */
+    created_at?: string;
+    /**
+     * When its last message came.
+     */
+    last_message_at?: string;
+    /**
+     * Whether App Review takes an answer on it.
+     */
+    can_reply: boolean;
+    /**
+     * The App Store versions it is of.
+     */
+    versions: string[];
+    /**
+     * Its messages.
+     */
+    messages: ReviewMessage[];
+    /**
+     * Its rejections.
+     */
+    rejections: ReviewRejection[];
+    /**
+     * Its attachments.
+     */
+    attachments: ReviewAttachment[];
+    draft?: ReviewDraft;
+};
+/**
+ * The app's Resolution Center.
+ */
+export type ReviewPage = {
+    /**
+     * Its threads, newest first.
+     */
+    threads: ReviewThread[];
+};
+/**
+ * The answer to write.
+ */
+export type DraftRequest = {
+    /**
+     * Its text.
+     */
+    body: string;
+};
+/**
+ * One line of the app's privacy details, in Apple's words: a kind of data (category: USER_ID, PURCHASE_HISTORY…), what it is used for (purpose: APP_FUNCTIONALITY, ANALYTICS…) and how (data_protection: DATA_LINKED_TO_YOU, DATA_NOT_LINKED_TO_YOU, DATA_USED_TO_TRACK_YOU) — or DATA_NOT_COLLECTED alone.
+ */
+export type PrivacyUsage = {
+    /**
+     * The kind of data.
+     */
+    category?: string;
+    /**
+     * What it is used for.
+     */
+    purpose?: string;
+    /**
+     * How.
+     */
+    data_protection: string;
+};
+/**
+ * The app's privacy details at Apple.
+ */
+export type Privacy = {
+    /**
+     * Its lines.
+     */
+    usages: PrivacyUsage[];
+    /**
+     * Whether they are published on the App Store.
+     */
+    published: boolean;
+};
+/**
+ * The privacy details to write.
+ */
+export type PrivacyRequest = {
+    /**
+     * Every line, or DATA_NOT_COLLECTED alone.
+     */
+    usages: PrivacyUsage[];
+    /**
+     * Publish them once written.
+     */
+    publish?: boolean;
+};
+/**
+ * The app record to make.
+ */
+export type RecordRequest = {
+    /**
+     * Its App Store name.
+     */
+    name: string;
+    /**
+     * Its own id in the team (the bundle id when empty).
+     */
+    sku?: string;
+    /**
+     * Its store page's first language (en-US when empty).
+     */
+    primary_locale?: string;
+    /**
+     * The seller's name, which a team's first app sets.
+     */
+    company_name?: string;
+};
+/**
+ * stores.review.message: a message in the app's Resolution Center not told yet — App Review's, or any not sent from Palbase — with the guidelines its rejections name and its attachments. Told while the project has an Apple ID signed in and a version of the app is in review or was rejected in the last 30 days.
+ */
+export type ReviewMessageEvent = {
+    /**
+     * The app.
+     */
+    app_id: string;
+    /**
+     * Its bundle id.
+     */
+    bundle_id: string;
+    /**
+     * Its App Store Connect record.
+     */
+    asc_app_id: string;
+    /**
+     * The thread.
+     */
+    thread_id: string;
+    /**
+     * Apple's kind of thread.
+     */
+    thread_type?: string;
+    /**
+     * The App Store versions it is of.
+     */
+    versions?: string[];
+    /**
+     * The message.
+     */
+    message_id: string;
+    /**
+     * When it was written.
+     */
+    created_at?: string;
+    /**
+     * Who wrote it, as Apple says it.
+     */
+    from?: string;
+    /**
+     * Its text (24 KiB at most).
+     */
+    body: string;
+    /**
+     * Whether the text was cut to fit.
+     */
+    body_cut: boolean;
+    /**
+     * The guidelines its rejections name.
+     */
+    reasons: ReviewReason[];
+    /**
+     * Its attachments (read them from GET …/review/threads/{thread_id}/attachments/{attachment_id}).
+     */
+    attachments: ReviewAttachment[];
+};
+/**
+ * stores.apple.session.ended: Palbase's own project's copy of an Apple ID session Apple ended in a customer's project, whose Studio mails the person who connected it.
+ */
+export type AppleSessionEndedEvent = {
+    /**
+     * The customer's project.
+     */
+    project_id: string;
+    /**
+     * The Apple ID.
+     */
+    apple_id: string;
+    /**
+     * Its team's name.
+     */
+    team: string;
+    /**
+     * Who asked for the sign-in link: a developer's id, or the key's.
+     */
+    connected_by: string;
+};
 /** The events this module sends the project's webhooks (x-palbase-events), by type: each one's payload, the event's data. */
 export interface Events {
     /**
@@ -2412,7 +2892,7 @@ export interface Events {
      */
     "stores.action.changed": ActionChangedEvent;
     /**
-     * stores.app.changed: an app was linked to its store.
+     * stores.app.changed: an app was linked to its store, or its App Store Connect record made or removed with the project's Apple ID.
      */
     "stores.app.changed": AppChangedEvent;
     /**
@@ -2475,6 +2955,22 @@ export interface Events {
      * stores.webhook.changed: an app's App Store Connect webhook came on, or was refused (the key's role) or failed.
      */
     "stores.webhook.changed": WebhookChangedEvent;
+    /**
+     * stores.apple.session.changed: an Apple ID was signed in for the project, or disconnected. Never the session.
+     */
+    "stores.apple.session.changed": AppleSessionChangedEvent;
+    /**
+     * stores.apple.session.expired: Apple ended the project's Apple ID session (it does after a few weeks, and when the password changes). What needs it answers 409 `apple_id_expired` until someone signs in again.
+     */
+    "stores.apple.session.expired": AppleSessionExpiredEvent;
+    /**
+     * stores.review.message: a message in the app's Resolution Center not told yet — App Review's, or any not sent from Palbase — with the guidelines its rejections name and its attachments. Told while the project has an Apple ID signed in and a version of the app is in review or was rejected in the last 30 days.
+     */
+    "stores.review.message": ReviewMessageEvent;
+    /**
+     * stores.apple.session.ended: Palbase's own project's copy of an Apple ID session Apple ended in a customer's project, whose Studio mails the person who connected it.
+     */
+    "stores.apple.session.ended": AppleSessionEndedEvent;
 }
 /** Palbase Stores */
 export declare function client(t: Transport): {
@@ -3232,5 +3728,191 @@ export declare function client(t: Transport): {
         body: AppleWebhookDelivery; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
         signal?: AbortSignal;
     }): Promise<Reply<200, undefined>>;
+    /**
+     * The Apple ID session
+     *
+     * The Apple ID signed in for the project (App Store Connect's web session, for what Apple's API does not do: App Review's Resolution Center, App Privacy, making an app record), its team and roles, and whether Apple still takes it — never the session itself. `connected: false` with none.
+     */
+    getAppleSession(input?: {
+        signal?: AbortSignal;
+    }): Promise<Reply<200, AppleSession>>;
+    /**
+     * Disconnect the Apple ID
+     *
+     * Signs the session out at Apple and forgets it; Apple not answering does not keep it. An owner's or an admin's, or the project's secret key's (403 `admin_required` for a member). Emits `stores.apple.session.changed` (disconnected).
+     */
+    disconnectAppleSession(input?: {
+        headers?: {
+            "Idempotency-Key"?: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<204, undefined>>;
+    /**
+     * Check the Apple ID session
+     *
+     * Asks Apple whose the session is now (its team, its roles) — the module does every 6 hours a session is not used. A session Apple ended is marked `expired` and told (`stores.apple.session.expired`); sign in again to go on.
+     */
+    checkAppleSession(input?: {
+        headers?: {
+            "Idempotency-Key"?: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, AppleSession>>;
+    /**
+     * Grant an Apple ID's sign-in
+     *
+     * A one-time link, good for 15 minutes, to sign an Apple ID in for the project. Whoever asks for it never holds the password: the person opens `connect_url` in a browser, or a terminal posts to `POST /stores/connect/apple-id` with the grant. A link takes 3 passwords and 3 codes; a project 6 passwords an hour, however many links it asks for (Apple locks an Apple ID tried too often), and holds 5 open links at most (429 `too_many_grants`). An owner's or an admin's, or the project's secret key's (403 `admin_required` for a member).
+     */
+    createAppleIdGrant(input?: {
+        headers?: {
+            "Idempotency-Key"?: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<201, AppleIDGrant>>;
+    /**
+     * The Apple ID sign-in page
+     *
+     * The page a sign-in link opens: it names the project the Apple ID goes to, reads the grant from the link's fragment and posts the Apple ID, its password, Apple's code and the team with it. No credential: the grant is the authorization.
+     */
+    getAppleIdPage(input?: {
+        signal?: AbortSignal;
+    }): Promise<Reply<200, Response>>;
+    /**
+     * Sign an Apple ID in
+     *
+     * Takes an Apple ID and its password, sealed to the link's seal_key, with a grant: the stores module opens the password and hands it to Apple. It is in no row, event or log, and nothing on its way reads it. Apple then asks for a code (`step: code`), the Apple ID's team is to be chosen (`step: team`), or it is connected (`step: connected`, emitting `stores.apple.session.changed`). Each password counts against the link (3), the project's hour (6) and the Apple ID's hour, whatever project tries it (10); past either hour, 429 `too_many_attempts`.
+     */
+    signInAppleId(input: {
+        body: AppleIDSignInRequest; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, AppleIDSignInStep>>;
+    /**
+     * Send Apple's code
+     *
+     * Finishes a sign-in with the six-digit code Apple sent to the Apple ID's trusted devices or phone. A link takes 3 codes.
+     */
+    submitAppleIdCode(input: {
+        body: AppleIDCodeRequest; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, AppleIDSignInStep>>;
+    /**
+     * Choose the team
+     *
+     * Finishes a sign-in whose Apple ID is in more than one App Store Connect team, with the team's `id` from the `team` step.
+     */
+    chooseAppleIdTeam(input: {
+        body: AppleIDTeamRequest; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, AppleIDSignInStep>>;
+    /**
+     * The app's Resolution Center
+     *
+     * App Review's threads of the app, the five written to last, latest first: each message as plain text, the guidelines each rejection names, the attachments, and the answer not sent yet. Needs the project's Apple ID signed in (409 `apple_id_not_connected`, or `apple_id_expired` once Apple ended its session) and the app's App Store Connect record (409 `app_record_missing`).
+     */
+    getAppReview(input: {
+        path: {
+            app_id: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, ReviewPage>>;
+    /**
+     * An App Review attachment
+     *
+     * The file App Review attached to a message or a rejection, read from where Apple serves it and passed on as it comes (64 MiB at most): with none of the session's cookies, but where App Store Connect serves it itself. 404 `thread_not_found` or `attachment_not_found`. Needs the project's Apple ID signed in (409 `apple_id_not_connected`, or `apple_id_expired` once Apple ended its session) and the app's App Store Connect record (409 `app_record_missing`).
+     */
+    getReviewAttachment(input: {
+        path: {
+            app_id: string; /** The Resolution Center thread's id (ReviewThread.id). */
+            thread_id: string; /** The attachment's id (ReviewAttachment.id). */
+            attachment_id: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, Response>>;
+    /**
+     * Write the answer to App Review
+     *
+     * Writes the thread's answer, not sent: App Store Connect keeps it as the website's draft. 409 `thread_closed` when App Review takes no answer on the thread. Needs the project's Apple ID signed in (409 `apple_id_not_connected`, or `apple_id_expired` once Apple ended its session) and the app's App Store Connect record (409 `app_record_missing`).
+     */
+    setReviewDraft(input: {
+        path: {
+            app_id: string; /** The Resolution Center thread's id (ReviewThread.id). */
+            thread_id: string;
+        };
+        headers?: {
+            "Idempotency-Key"?: string;
+        };
+        body: DraftRequest; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, ReviewDraft>>;
+    /**
+     * Send the answer to App Review
+     *
+     * Sends the thread's draft to App Review (409 `draft_missing` with none). The message is the project's own: it is not told back as `stores.review.message`. Needs the project's Apple ID signed in (409 `apple_id_not_connected`, or `apple_id_expired` once Apple ended its session) and the app's App Store Connect record (409 `app_record_missing`).
+     */
+    sendReviewDraft(input: {
+        path: {
+            app_id: string; /** The Resolution Center thread's id (ReviewThread.id). */
+            thread_id: string;
+        };
+        headers?: {
+            "Idempotency-Key"?: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, ReviewMessage>>;
+    /**
+     * The app's App Privacy details
+     *
+     * The app's privacy details as App Store Connect has them, in Apple's words, and whether they are published. Needs the project's Apple ID signed in (409 `apple_id_not_connected`, or `apple_id_expired` once Apple ended its session) and the app's App Store Connect record (409 `app_record_missing`).
+     */
+    getAppPrivacy(input: {
+        path: {
+            app_id: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, Privacy>>;
+    /**
+     * Write the app's App Privacy details
+     *
+     * Writes the app's privacy details at Apple — the lines it lacks made first, then the ones not asked for removed, so that a write that stops half way leaves more said than asked, never less — and publishes them with `publish`. Every value must be one of Apple's own lists (400 `invalid_privacy` names the others). The write is not one transaction at Apple: sent again, it finishes what one cut short. Published, the version's missing list stops asking for App Privacy. Needs the project's Apple ID signed in (409 `apple_id_not_connected`, or `apple_id_expired` once Apple ended its session) and the app's App Store Connect record (409 `app_record_missing`).
+     */
+    setAppPrivacy(input: {
+        path: {
+            app_id: string;
+        };
+        headers?: {
+            "Idempotency-Key"?: string;
+        };
+        body: PrivacyRequest; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, Privacy>>;
+    /**
+     * Make the app's App Store Connect record
+     *
+     * Makes the app's record at App Store Connect, which Apple's API leaves to a person on the website, and links the app to it (`stores.app.changed`, record_made); its webhook is made then, or by the leader's next round when Apple refuses it. 409 `app_record_exists` when it has one, `app_name_taken` when the App Store has the name. Needs the project's Apple ID signed in.
+     */
+    makeAppRecord(input: {
+        path: {
+            app_id: string;
+        };
+        headers?: {
+            "Idempotency-Key"?: string;
+        };
+        body: RecordRequest; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<201, App>>;
+    /**
+     * Remove the app's App Store Connect record
+     *
+     * Removes the app's record at App Store Connect, as its Remove App does: Apple takes it for an app never approved, with no version ready for, waiting for, in or rejected by App Review, sold on the App Store alone (409 `app_record_not_removable` says which). The removal is read back: the app stays linked, with no record (`stores.app.changed`, record_removed), only once Apple says it is removed. An owner's or an admin's, or the project's secret key's. Needs the project's Apple ID signed in (409 `apple_id_not_connected`, or `apple_id_expired`) and the app's App Store Connect record (409 `app_record_missing`).
+     */
+    removeAppRecord(input: {
+        path: {
+            app_id: string;
+        };
+        headers?: {
+            "Idempotency-Key"?: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<204, undefined>>;
 };
 export type Client = ReturnType<typeof client>;