types-mediawiki-response 1.0.0-alpha.1 → 1.0.0

package/dist/common/index.d.ts

@@ -12,6 +12,17 @@ export type Flag = true;
  * e.g. `2024-01-15T08:30:00Z`.
  */
 export type Timestamp = string;
+/**
+ * Expiry of a temporary state: a timestamp, or the literal `infinity` when it
+ * does not expire. Block records spell the permanent case `infinite` instead
+ * — see {@link BlockExpiry}.
+ */
+export type Expiry = Timestamp | "infinity";
+/**
+ * Expiry of a block as an action result reports it: a timestamp, or the
+ * literal `infinite` for an indefinite block.
+ */
+export type BlockExpiry = Timestamp | "infinite";
 /**
  * A block of plain text (as opposed to HTML), e.g. a TextExtracts excerpt
  * requested with `explaintext`. Kept distinct from HTML-bearing string fields.
@@ -19,6 +30,16 @@ export type Timestamp = string;
 export type PlainText = string;
 /** Namespace index. Negative indexes are pseudo-namespaces. */
 export type NamespaceIndex = number;
+/**
+ * `success` — or the actual outcome string when an operation did not succeed.
+ * **Open union**: `(string & {})` keeps other outcomes forward-compatible.
+ */
+export type SuccessStatus = "success" | (string & {});
+/**
+ * `Success` — or the actual result string when an operation did not succeed.
+ * **Open union**: `(string & {})` keeps other outcomes forward-compatible.
+ */
+export type SuccessResult = "Success" | (string & {});
 /**
  * A structured in-band message — a serialized MediaWiki `Message`/`FatalError`
  * spec (`{ message, params, code, type }`) nested inside an action result

package/dist/core/block.d.ts

@@ -9,7 +9,7 @@
  *
  * @see https://www.mediawiki.org/wiki/API:Block
  */
-import type { Timestamp } from "../common";
+import type { BlockExpiry, Timestamp } from "../common";
 import type { ApiEnvelope } from "../envelope";
 /** The `block` object of an `action=block` response. */
 export interface ApiBlockResult {
@@ -20,7 +20,7 @@ export interface ApiBlockResult {
     /** Block id. */
     id: number;
     /** Expiry timestamp, or `infinite` for an indefinite block. */
-    expiry: Timestamp | "infinite";
+    expiry: BlockExpiry;
     /** Block reason (echoed back). */
     reason: string;
     /** Block only anonymous users editing from an IP address range. */
@@ -60,10 +60,8 @@ export interface ApiBlockResult {
      */
     timestamp?: Timestamp;
     /**
-     * Extra statuses set by extensions during a successful block. Always
-     * emitted; core never fills it, so it is `[]` unless `$wgEnableMultiBlocks`
-     * is on and an extension populates it via the `ApiBlockSucceeded` hook, in
-     * which case a PHP map (thus the `unknown[]` empty case).
+     * Extra statuses set by extensions during a successful block; `[]` when none
+     * is set.
      *
      * @since MediaWiki 1.46
      */
@@ -71,6 +69,7 @@ export interface ApiBlockResult {
 }
 /** Response of `action=block`. */
 export interface ApiBlockResponse extends ApiEnvelope {
+    /** Result of `action=block`. */
     block: ApiBlockResult;
 }
 /** The `unblock` object of an `action=unblock` response. */
@@ -94,5 +93,6 @@ export interface ApiUnblockResult {
 }
 /** Response of `action=unblock`. */
 export interface ApiUnblockResponse extends ApiEnvelope {
+    /** Result of `action=unblock`. */
     unblock: ApiUnblockResult;
 }

package/dist/core/changeauthenticationdata.d.ts

@@ -8,11 +8,13 @@
  *
  * @see https://www.mediawiki.org/wiki/API:Changeauthenticationdata
  */
+import type { SuccessStatus } from "../common";
 import type { ApiEnvelope } from "../envelope";
 /** Response of `action=changeauthenticationdata`. */
 export interface ApiChangeAuthenticationDataResponse extends ApiEnvelope {
+    /** Result of `action=changeauthenticationdata`. */
     changeauthenticationdata: {
         /** Flow outcome; `success` when the change was applied. */
-        status: "success" | (string & {});
+        status: SuccessStatus;
     };
 }

package/dist/core/changecontentmodel.d.ts

@@ -6,13 +6,14 @@
  *
  * @see https://www.mediawiki.org/wiki/API:Changecontentmodel
  */
-import type { ContentModel } from "../common";
+import type { ContentModel, SuccessResult } from "../common";
 import type { ApiEnvelope } from "../envelope";
 /** Response of `action=changecontentmodel`. */
 export interface ApiChangeContentModelResponse extends ApiEnvelope {
+    /** Result of `action=changecontentmodel`. */
     changecontentmodel: {
         /** `Success` when the model was changed. */
-        result: "Success" | (string & {});
+        result: SuccessResult;
         /** Page title. */
         title: string;
         /** Page id. */

package/dist/core/checktoken.d.ts

@@ -16,6 +16,7 @@ import type { ApiEnvelope } from "../envelope";
 export type ApiCheckTokenResult = "valid" | "expired" | "invalid" | (string & {});
 /** Response of `action=checktoken`. */
 export interface ApiCheckTokenResponse extends ApiEnvelope {
+    /** Result of `action=checktoken`. */
     checktoken: {
         /** Outcome of the token check. */
         result: ApiCheckTokenResult;

package/dist/core/clientlogin.d.ts

@@ -44,5 +44,6 @@ export interface ApiClientLogin {
 }
 /** Response of `action=clientlogin`. */
 export interface ApiClientLoginResponse extends ApiEnvelope {
+    /** Result of `action=clientlogin`. */
     clientlogin: ApiClientLogin;
 }

package/dist/core/compare.d.ts

@@ -88,5 +88,6 @@ export interface ApiCompareResult {
 }
 /** Response of `action=compare`. */
 export interface ApiCompareResponse extends ApiEnvelope {
+    /** Result of `action=compare`. */
     compare: ApiCompareResult;
 }

package/dist/core/createaccount.d.ts

@@ -1,9 +1,8 @@
 /**
  * `action=createaccount` response — AuthManager-driven account creation. The
- * result keys under `createaccount`, produced by `ApiAuthManagerHelper::
- * formatAuthenticationResponse` (the same builder as `clientlogin`): `status`
- * drives the flow (`PASS` on success, plus in-band `FAIL`/`UI`/`RESTART`/
- * `REDIRECT`), and failures carry `message`/`messagecode`.
+ * result keys under `createaccount`: `status` drives the flow (`PASS` on
+ * success, plus in-band `FAIL`/`UI`/`RESTART`/`REDIRECT`), and failures carry
+ * `message`/`messagecode`.
  *
  * These are **in-band** AuthManager outcomes, not a top-level
  * {@link ApiErrorResponse}. `username` appears on `PASS`; `UI`/`RESTART`/
@@ -12,10 +11,11 @@
  *
  * @see https://www.mediawiki.org/wiki/API:Createaccount
  */
-import type { ApiAuthManagerMessage, ApiAuthManagerStatus } from "./query/authmanagerinfo";
+import type { ApiAuthManagerMessage, ApiAuthManagerStatus, ApiQueryAuthManagerInfoRequest } from "./query/authmanagerinfo";
 import type { ApiEnvelope } from "../envelope";
 /** Response of `action=createaccount`. */
 export interface ApiCreateAccountResponse extends ApiEnvelope {
+    /** Result of `action=createaccount`. */
     createaccount: {
         /** AuthManager outcome of the account-creation flow. */
         status?: ApiAuthManagerStatus;
@@ -36,6 +36,6 @@ export interface ApiCreateAccountResponse extends ApiEnvelope {
         /** Extra API data accompanying a `REDIRECT` outcome. */
         redirectdata?: Record<string, unknown>;
         /** AuthManager request descriptors for interactive (`UI`/`RESTART`) and `REDIRECT` steps. */
-        requests?: Record<string, unknown>[];
+        requests?: ApiQueryAuthManagerInfoRequest[];
     };
 }

package/dist/core/delete.d.ts

@@ -26,6 +26,7 @@ export interface ApiDeleteResult {
 }
 /** Response of `action=delete`. */
 export interface ApiDeleteResponse extends ApiEnvelope {
+    /** Result of `action=delete`. */
     delete: ApiDeleteResult;
 }
 /** The `undelete` object of an `action=undelete` response. */
@@ -41,5 +42,6 @@ export interface ApiUndeleteResult {
 }
 /** Response of `action=undelete`. */
 export interface ApiUndeleteResponse extends ApiEnvelope {
+    /** Result of `action=undelete`. */
     undelete: ApiUndeleteResult;
 }

package/dist/core/edit.d.ts

@@ -6,9 +6,11 @@
  * - create: `new: true` plus `oldrevid: 0` / `newrevid` / `newtimestamp`;
  * - changed: `oldrevid` / `newrevid` / `newtimestamp` (no `new`);
  * - nochange: `nochange: true`, no revision ids.
- * `watched` appears when the edit applied a watch. Most hard failures (bad
- * token, protected page, `createonly` on an existing page) surface as a
- * top-level {@link ApiErrorResponse}, not `result: "Failure"`.
+ * A save aborted by a hook that carries status data (ConfirmEdit's captcha
+ * challenge) returns the in-band failure branch: `result: "Failure"` plus that
+ * data and no revision ids. Most hard failures (bad token, protected page,
+ * `createonly` on an existing page) surface as a top-level
+ * {@link ApiErrorResponse}, not `result: "Failure"`.
  *
  * @see https://www.mediawiki.org/wiki/API:Edit
  */
@@ -59,8 +61,26 @@ export interface ApiEditResult {
     code?: string;
     /** Human-readable failure description. */
     info?: string;
+    /**
+     * Captcha challenge returned when ConfirmEdit aborted the save. Present only
+     * in the in-band failure branch; {@link ApiEditCaptcha.id} and
+     * {@link ApiEditCaptcha.question} are per-request random values.
+     */
+    captcha?: ApiEditCaptcha;
+}
+/** The captcha challenge of a `result: "Failure"` edit, as emitted by ConfirmEdit. */
+export interface ApiEditCaptcha {
+    /** Captcha implementation, e.g. `simple` (arithmetic challenge) or `image`. Open union. */
+    type?: string;
+    /** MIME type the challenge renders as, e.g. `text/plain`, `image/png`, `text/html`. */
+    mime?: string;
+    /** Cache key of the pending challenge; pass it back as `captchaid` alongside the `captchaword` answer. */
+    id?: string;
+    /** Challenge text: an arithmetic expression for the sample implementation, the prompt for a question captcha. */
+    question?: string;
 }
 /** Response of `action=edit`. */
 export interface ApiEditResponse extends ApiEnvelope {
+    /** Result of `action=edit`. */
     edit: ApiEditResult;
 }

package/dist/core/emailuser.d.ts

@@ -16,6 +16,7 @@ import type { ApiSpecMessage } from "../common";
 import type { ApiEnvelope } from "../envelope";
 /** Response of `action=emailuser`. */
 export interface ApiEmailUserResponse extends ApiEnvelope {
+    /** Result of `action=emailuser`. */
     emailuser: {
         /** Whether the message was accepted, or accepted with warnings, or failed. */
         result: "Success" | "Warnings" | "Failure" | (string & {});

package/dist/core/expandtemplates.d.ts

@@ -53,6 +53,7 @@ export interface ApiExpandTemplatesResult {
 }
 /** Response of `action=expandtemplates`. */
 export interface ApiExpandTemplatesResponse extends ApiEnvelope {
+    /** Result of `action=expandtemplates`. */
     expandtemplates: ApiExpandTemplatesResult;
     /**
      * XML parse tree of the input wikitext, emitted at the root level (outside

package/dist/core/filerevert.d.ts

@@ -11,6 +11,7 @@ import type { ApiSpecMessage } from "../common";
 import type { ApiEnvelope } from "../envelope";
 /** Response of `action=filerevert`. */
 export interface ApiFileRevertResponse extends ApiEnvelope {
+    /** Result of `action=filerevert`. */
     filerevert: {
         /** Outcome of the revert. */
         result: "Success" | "Failure" | (string & {});

package/dist/core/imagerotate.d.ts

@@ -14,30 +14,15 @@
  *
  * @see https://www.mediawiki.org/wiki/API:Imagerotate
  */
-import type { Flag, NamespaceIndex, ApiSpecMessage } from "../common";
+import type { ApiSpecMessage } from "../common";
 import type { ApiEnvelope } from "../envelope";
+import type { ApiPageIdentity } from "./query";
 /** One file entry of an `action=imagerotate` response. */
-export interface ApiImageRotateEntry {
+export interface ApiImageRotateEntry extends ApiPageIdentity {
     /** Page id of the file (keyed as `id`, not `pageid`). */
     id?: number;
-    /** Page id, for entries describing a `pageid=` that did not resolve. */
-    pageid?: number;
     /** Revision id, for entries describing a `revid=` that did not resolve. */
     revid?: number;
-    /** Namespace index (6 = File). */
-    ns?: NamespaceIndex;
-    /** File title. */
-    title?: string;
-    /** The title does not correspond to an existing page. A {@link Flag}. */
-    missing?: Flag;
-    /** A `missing` title that is nonetheless "known" (e.g. a redlinked file). A {@link Flag}. */
-    known?: Flag;
-    /** The requested title is malformed or otherwise invalid. A {@link Flag}. */
-    invalid?: Flag;
-    /** Reason the title is invalid (localized wikitext), alongside `invalid`. */
-    invalidreason?: string;
-    /** The requested title is a Special: page (not rotated). A {@link Flag}. */
-    special?: Flag;
     /** Interwiki prefix, for entries describing an interwiki title. */
     iw?: string;
     /** Per-file outcome. */
@@ -47,5 +32,6 @@ export interface ApiImageRotateEntry {
 }
 /** Response of `action=imagerotate`. */
 export interface ApiImageRotateResponse extends ApiEnvelope {
+    /** Result of `action=imagerotate`; one entry per rotated image. */
     imagerotate: ApiImageRotateEntry[];
 }

package/dist/core/import.d.ts

@@ -4,8 +4,7 @@
  * uploads) right. The result is a top-level `import` **array**, one entry per
  * imported page.
  *
- * Shape comes from `ApiImportReporter::reportPage` (via `ApiQueryBase::addTitleInfo`):
- * a successful page carries `ns`/`title` plus a `revisions` count; an
+ * A successful page carries `ns`/`title` plus a `revisions` count; an
  * un-importable title carries `title` + an `invalid` flag.
  *
  * @see https://www.mediawiki.org/wiki/API:Import
@@ -25,5 +24,6 @@ export interface ApiImportEntry {
 }
 /** Response of `action=import`. */
 export interface ApiImportResponse extends ApiEnvelope {
+    /** Result of `action=import`; one entry per imported page. */
     import: ApiImportEntry[];
 }

package/dist/core/login.d.ts

@@ -15,6 +15,7 @@
 import type { ApiEnvelope } from "../envelope";
 /** Response of the deprecated `action=login`. */
 export interface ApiLoginResponse extends ApiEnvelope {
+    /** Result of `action=login`. */
     login: {
         /** Login outcome. */
         result: "Success" | "Failed" | "NeedToken" | "WrongToken" | "Aborted" | (string & {});

package/dist/core/managetags.d.ts

@@ -13,6 +13,7 @@ import type { ApiEnvelope } from "../envelope";
 export type ApiManageTagsOperation = "activate" | "create" | "deactivate" | "delete" | (string & {});
 /** Response of `action=managetags`. */
 export interface ApiManageTagsResponse extends ApiEnvelope {
+    /** Result of `action=managetags`. */
     managetags: {
         /** The operation that was performed. */
         operation: ApiManageTagsOperation;

package/dist/core/mergehistory.d.ts

@@ -9,6 +9,7 @@ import type { Timestamp } from "../common";
 import type { ApiEnvelope } from "../envelope";
 /** Response of `action=mergehistory`. */
 export interface ApiMergeHistoryResponse extends ApiEnvelope {
+    /** Result of `action=mergehistory`. */
     mergehistory: {
         /** Source page title (history moved out of). */
         from: string;

package/dist/core/move.d.ts

@@ -4,8 +4,8 @@
  *
  * Note under `formatversion=2`: `redirectcreated` / `moveoverredirect` /
  * `talkmoveoverredirect` are real booleans (present as `false`), `reason` is
- * always present (`''` when none was supplied), and there is **no `result`
- * key** on a successful move. `subpages` is polymorphic: an array of per-subpage
+ * `''` when none was supplied, and there is **no `result` key** on a
+ * successful move. `subpages` is polymorphic: an array of per-subpage
  * outcomes when any subpage could be processed, or an object `{ errors }` when
  * the whole subpage move failed (e.g. the namespace forbids them).
  *
@@ -58,5 +58,6 @@ export interface ApiMoveResult {
 }
 /** Response of `action=move`. */
 export interface ApiMoveResponse extends ApiEnvelope {
+    /** Result of `action=move`. */
     move: ApiMoveResult;
 }

package/dist/core/options.d.ts

@@ -8,9 +8,10 @@
  *
  * @see https://www.mediawiki.org/wiki/API:Options
  */
+import type { SuccessStatus } from "../common";
 import type { ApiEnvelope } from "../envelope";
 /** Response of `action=options`. */
 export interface ApiOptionsResponse extends ApiEnvelope {
     /** Success sentinel (`"success"`); failures come back as a top-level error. */
-    options: "success" | (string & {});
+    options: SuccessStatus;
 }

package/dist/core/parse.d.ts

@@ -42,12 +42,12 @@ export interface ApiParseLangLink {
     /** Full URL of the target page. */
     url?: string;
     /**
-     * Localized language name, in the request `uselang` language. Always emitted
-     * when the target title is valid (`action=parse` has no `llprop` parameter).
+     * Localized language name, in the request `uselang` language. Present when
+     * the target title is valid (`action=parse` has no `llprop` parameter).
      */
     langname?: string;
     /**
-     * Native language name. Always emitted when the target title is valid
+     * Native language name. Present when the target title is valid
      * (`action=parse` has no `llprop` parameter).
      */
     autonym?: string;
@@ -74,10 +74,7 @@ export interface ApiParseRedirect {
  * A table-of-contents entry (`prop=sections`) — the legacy projection of the
  * same outline `prop=tocdata` emits, with lowercase keys here (`fromtitle`,
  * `byteoffset`) against camelCase there (`fromTitle`, `codepointOffset`); see
- * {@link ApiParseTocSection}.
- *
- * `SectionMetadata::toLegacy()` fills every key below unconditionally except
- * `extensionData`, which is only emitted when non-empty.
+ * {@link ApiParseTocSection}. `extensionData` appears only when non-empty.
  */
 export interface ApiParseSection {
     /** Nesting level in the TOC. */
@@ -139,11 +136,7 @@ export interface ApiParseTocSection {
     /** Extension-supplied data for this section; `[]` when empty. */
     extensionData?: Record<string, unknown> | unknown[];
 }
-/**
- * The `tocdata` object (`prop=tocdata`). `TOCData::toJsonArray()` writes both
- * keys unconditionally; individual section keys are the conditional ones (see
- * {@link ApiParseTocSection}).
- */
+/** The `tocdata` object (`prop=tocdata`). */
 export interface ApiParseTocData {
     /** The outline, in camelCase keys. */
     sections: ApiParseTocSection[];
@@ -248,8 +241,7 @@ export interface ApiParse {
     /**
      * The script-bearing subset of {@link modules}.
      *
-     * @deprecated since MediaWiki 1.32 — core hard-codes this to `[]`, so it is always
-     * empty; read {@link modules} instead.
+     * @deprecated since MediaWiki 1.32 — always empty; read {@link modules} instead.
      */
     modulescripts?: never[];
     /**
@@ -305,6 +297,7 @@ export interface ApiParse {
 }
 /** Response of `action=parse`. */
 export interface ApiParseResponse extends ApiEnvelope {
+    /** Result of `action=parse`. */
     parse: ApiParse;
 }
 /**
@@ -313,6 +306,7 @@ export interface ApiParseResponse extends ApiEnvelope {
  * `title`/`pageid` and none of the `prop` sub-objects of {@link ApiParse}.
  */
 export interface ApiParseOnlyPstResponse extends ApiEnvelope {
+    /** Result of `action=parse&onlypst=1`. */
     parse: {
         /** Pre-save-transformed wikitext. */
         text: string;

package/dist/core/patrol.d.ts

@@ -17,5 +17,6 @@ export interface ApiPatrolResult {
 }
 /** Response of `action=patrol`. */
 export interface ApiPatrolResponse extends ApiEnvelope {
+    /** Result of `action=patrol`. */
     patrol: ApiPatrolResult;
 }

package/dist/core/protect.d.ts

@@ -39,5 +39,6 @@ export interface ApiProtectResult {
 }
 /** Response of `action=protect`. */
 export interface ApiProtectResponse extends ApiEnvelope {
+    /** Result of `action=protect`. */
     protect: ApiProtectResult;
 }

package/dist/core/purge.d.ts

@@ -6,15 +6,11 @@
  *
  * @see https://www.mediawiki.org/wiki/API:Purge
  */
-import type { Flag, NamespaceIndex } from "../common";
+import type { Flag } from "../common";
 import type { ApiEnvelope } from "../envelope";
-import type { ApiQueryNormalized, ApiQueryTitlePair } from "./query";
+import type { ApiPageIdentity, ApiQueryNormalized, ApiQueryTitlePair } from "./query";
 /** One purged page. */
-export interface ApiPurgeEntry {
-    /** Namespace index. */
-    ns?: NamespaceIndex;
-    /** Page title. */
-    title?: string;
+export interface ApiPurgeEntry extends ApiPageIdentity {
     /** Whether the page was actually purged. A {@link Flag} (appears when purged). */
     purged?: Flag;
     /**
@@ -22,32 +18,14 @@ export interface ApiPurgeEntry {
      * `forcerecursivelinkupdate`). A {@link Flag}.
      */
     linkupdate?: Flag;
-    /** Page id, for entries describing a `pageids=` value that did not resolve. */
-    pageid?: number;
     /** Revision id, for entries describing a `revids=` value that did not resolve. */
     revid?: number;
-    /** The requested title does not correspond to an existing page. A {@link Flag}. */
-    missing?: Flag;
-    /** A `missing` title that is nonetheless "known" (e.g. a redlinked page). A {@link Flag}. */
-    known?: Flag;
-    /** The requested title is malformed or otherwise invalid. A {@link Flag}. */
-    invalid?: Flag;
-    /** Reason the title is invalid (localized wikitext), alongside `invalid`. */
-    invalidreason?: string;
-    /** The requested title is a Special: page (not purged). A {@link Flag}. */
-    special?: Flag;
     /** Interwiki prefix, for entries describing an interwiki title. */
     iw?: string;
 }
-/** One resolved redirect (with `redirects=1`). */
-export interface ApiPurgeRedirect {
-    /** Redirect source title. */
-    from?: string;
-    /** Title the redirect points to. */
-    to?: string;
-}
 /** Response of `action=purge`. */
 export interface ApiPurgeResponse extends ApiEnvelope {
+    /** Result of `action=purge`; one entry per targeted page. */
     purge: ApiPurgeEntry[];
     /**
      * Title normalizations the pageSet applied before the purge (e.g. underscore
@@ -57,5 +35,5 @@ export interface ApiPurgeResponse extends ApiEnvelope {
     /** Title conversions on a language-variant wiki, same shape as `query.converted`. */
     converted?: ApiQueryTitlePair[];
     /** Redirect resolutions (with `redirects=1`). */
-    redirects?: ApiPurgeRedirect[];
+    redirects?: ApiQueryTitlePair[];
 }

package/dist/core/query/allcategories.d.ts

@@ -4,10 +4,7 @@
  *
  * @see https://www.mediawiki.org/wiki/API:Allcategories
  */
-/**
- * One category summary. `acprop=size|hidden` selects the optional fields;
- * `category` is always present.
- */
+/** One category summary. `acprop=size|hidden` selects the optional fields. */
 export interface ApiAllCategory {
     /** Category name, without the `Category:` prefix. */
     category: string;

package/dist/core/query/alldeletedrevisions.d.ts

@@ -8,16 +8,12 @@
  *
  * @see https://www.mediawiki.org/wiki/API:Alldeletedrevisions
  */
-import type { NamespaceIndex } from "../../common";
+import type { ApiPageRef } from "./shared";
 import type { ApiRevision } from "./revisions";
 /** One page carrying at least one deleted revision. */
-export interface ApiAllDeletedRevisions {
+export interface ApiAllDeletedRevisions extends ApiPageRef {
     /** Page id; `0` when the whole page is deleted. */
     pageid: number;
-    /** Namespace index. */
-    ns: NamespaceIndex;
-    /** Full page title. */
-    title: string;
     /** The page's deleted revisions, ordered per `ardir` (default `older`). */
     revisions: ApiRevision[];
 }

package/dist/core/query/alllinks.d.ts

@@ -14,8 +14,8 @@ export interface ApiAllLink {
     /**
      * Page id of the page holding the link (`alprop=ids`). Without `alunique` a
      * target appears once per linking page, each row carrying that page's id;
-     * `alunique` deduplicates targets with DISTINCT and never selects the source
-     * column, which is why it cannot be combined with `*prop=ids`.
+     * `alunique` lists each target once and drops the source page id, so it
+     * cannot be combined with `*prop=ids`.
      */
     fromid?: number;
     /** Namespace index of the linked title. `alprop=title` (default). */

package/dist/core/query/allpages.d.ts

@@ -5,15 +5,9 @@
  *
  * @see https://www.mediawiki.org/wiki/API:Allpages
  */
-import type { NamespaceIndex } from "../../common";
+import type { ApiPageRef } from "./shared";
 /** One page listed by `list=allpages`. */
-export interface ApiAllPage {
-    /** Page id. */
-    pageid: number;
-    /** Namespace index. */
-    ns: NamespaceIndex;
-    /** Page title. */
-    title: string;
+export interface ApiAllPage extends ApiPageRef {
 }
 declare module "./index" {
     interface ApiQueryResult {

package/dist/core/query/allrevisions.d.ts

@@ -9,16 +9,10 @@
  *
  * @see https://www.mediawiki.org/wiki/API:Allrevisions
  */
-import type { NamespaceIndex } from "../../common";
+import type { ApiPageRef } from "./shared";
 import type { ApiRevision } from "./revisions";
 /** One page with the revisions requested for it. */
-export interface ApiAllRevisions {
-    /** Page id. */
-    pageid: number;
-    /** Namespace index. */
-    ns: NamespaceIndex;
-    /** Full page title. */
-    title: string;
+export interface ApiAllRevisions extends ApiPageRef {
     /** Revisions of the page, ordered per `arvdir`. */
     revisions: ApiRevision[];
 }

package/dist/core/query/allusers.d.ts

@@ -1,7 +1,7 @@
 /**
  * `list=allusers` — enumerate all registered users, merged into
  * {@link ApiQueryResult} via declaration merging. `auprop` selects which fields
- * appear, and every entry always carries `userid` and `name`.
+ * appear, and every entry carries `userid` and `name`.
  *
  * Entries share the `list=users` shape ({@link ApiUser}) minus the fields this
  * module can never emit: `gender`, `emailable`, `cancreate`,

package/dist/core/query/authmanagerinfo.d.ts

@@ -57,8 +57,6 @@ export interface ApiQueryAuthManagerField {
     optional?: boolean;
     /** The field carries a secret (password) and is masked. */
     sensitive?: boolean;
-    /** Additional provider-specific field metadata. */
-    [extra: string]: unknown;
 }
 /** The `authmanagerinfo` object returned under `query`. */
 export interface ApiQueryAuthManagerInfo {