@ukwhatn/wikidot 1.0.9 → 4.0.2

package/dist/index.d.ts

@@ -1 +1,2106 @@
-export { Client } from './module/client';
+/**
+* Wikidotライブラリの基底エラークラス
+* 全てのカスタムエラーはこのクラスを継承する
+*/
+declare abstract class WikidotError extends Error {
+	/** エラー名 */
+	readonly name: string;
+	/**
+	* @param message - エラーメッセージ
+	*/
+	constructor(message: string);
+}
+/**
+* 予期せぬエラー
+* 内部的な不整合やバグを表す
+*/
+declare class UnexpectedError extends WikidotError {}
+/**
+* Ajax Module Connector関連の基底エラー
+*/
+declare class AMCError extends WikidotError {}
+/**
+* HTTPステータスコードエラー
+* AMCへのリクエストがHTTPエラーで失敗した場合
+*/
+declare class AMCHttpError extends AMCError {
+	/** HTTPステータスコード */
+	readonly statusCode: number;
+	/**
+	* @param message - エラーメッセージ
+	* @param statusCode - HTTPステータスコード
+	*/
+	constructor(message: string, statusCode: number);
+}
+/**
+* Wikidotステータスコードエラー
+* AMCレスポンスのstatusがokでない場合
+*/
+declare class WikidotStatusError extends AMCError {
+	/** Wikidotステータスコード文字列 */
+	readonly statusCode: string;
+	/**
+	* @param message - エラーメッセージ
+	* @param statusCode - ステータスコード（例: 'not_ok', 'try_again'）
+	*/
+	constructor(message: string, statusCode: string);
+}
+/**
+* レスポンスデータエラー
+* レスポンスのパースに失敗した場合
+*/
+declare class ResponseDataError extends AMCError {}
+/**
+* セッション関連の基底エラー
+*/
+declare class SessionError extends WikidotError {}
+/**
+* セッション作成失敗エラー
+* ログイン試行が失敗した場合にスロー
+*/
+declare class SessionCreateError extends SessionError {}
+/**
+* ログイン必須エラー
+* 認証が必要な操作を未ログイン状態で実行した場合にスロー
+*/
+declare class LoginRequiredError extends SessionError {
+	constructor(message?: string);
+}
+/**
+* リソース未発見エラー
+* 要求されたリソースが存在しない場合
+*/
+declare class NotFoundException extends WikidotError {}
+/**
+* リソース既存エラー
+* 作成しようとしたリソースが既に存在する場合
+*/
+declare class TargetExistsError extends WikidotError {}
+/**
+* ターゲット状態エラー
+* リソースが操作不可能な状態の場合（ロック中など）
+*/
+declare class TargetError extends WikidotError {}
+/**
+* アクセス拒否エラー
+* 権限不足で操作が拒否された場合
+*/
+declare class ForbiddenError extends WikidotError {}
+/**
+* HTML要素未発見エラー
+* パース中に必要な要素が見つからない場合
+*/
+declare class NoElementError extends WikidotError {}
+/**
+* ロギング機能を提供するモジュール
+*
+* このモジュールは、ライブラリ全体で使用されるロガーを設定し、提供する。
+* デフォルトでは出力を行わず、アプリケーション側でのログ制御を可能にする。
+*/
+/**
+* ログレベル
+*/
+type LogLevel = "debug" | "info" | "warn" | "error";
+/**
+* ロガーハンドラー
+*/
+type LogHandler = (level: LogLevel, name: string, message: string, ...args: unknown[]) => void;
+/**
+* NullHandler: 何も出力しない（デフォルト）
+*/
+declare const nullHandler: LogHandler;
+/**
+* ConsoleHandler: コンソールに出力する
+*/
+declare const consoleHandler: LogHandler;
+/**
+* ロガークラス
+*/
+declare class Logger {
+	private readonly name;
+	private handler;
+	private level;
+	constructor(name: string, handler?: LogHandler, level?: LogLevel);
+	/**
+	* ハンドラーを設定
+	*/
+	setHandler(handler: LogHandler): void;
+	/**
+	* ログレベルを設定
+	*/
+	setLevel(level: LogLevel): void;
+	/**
+	* 指定レベルがログ出力対象かどうか
+	*/
+	private shouldLog;
+	/**
+	* ログ出力
+	*/
+	private log;
+	debug(message: string, ...args: unknown[]): void;
+	info(message: string, ...args: unknown[]): void;
+	warn(message: string, ...args: unknown[]): void;
+	error(message: string, ...args: unknown[]): void;
+}
+/**
+* ロガーを取得
+* @param name - ロガー名（デフォルト: "wikidot"）
+* @returns ロガーインスタンス
+*/
+declare function getLogger(name?: string): Logger;
+/**
+* コンソール出力用ハンドラを設定
+* @param logger - 設定するロガー
+* @param level - ログレベル（デフォルト: "warn"）
+*/
+declare function setupConsoleHandler(logger: Logger, level?: LogLevel): void;
+/**
+* パッケージ全体で使用されるデフォルトロガー
+*/
+declare const logger: Logger;
+/** 日時型（ISO 8601形式） */
+type DateTimeString = string;
+/** ユーザーIDまたはユーザー名 */
+type UserIdentifier = number | string;
+/** サイトUNIX名 */
+type SiteUnixName = string;
+/** ページフルネーム（カテゴリ:名前） */
+type PageFullname = string;
+import { Result, ResultAsync } from "neverthrow";
+/** 同期Result型エイリアス */
+type WikidotResult<T> = Result<T, WikidotError>;
+/** 非同期Result型エイリアス */
+type WikidotResultAsync<T> = ResultAsync<T, WikidotError>;
+/** 成功Resultを生成 */
+declare const wdOk: <T>(value: T) => WikidotResult<T>;
+/** エラーResultを生成 */
+declare const wdErr: <E extends WikidotError>(error: E) => WikidotResult<never>;
+/** 成功ResultAsyncを生成 */
+declare const wdOkAsync: <T>(value: T) => WikidotResultAsync<T>;
+/** エラーResultAsyncを生成 */
+declare const wdErrAsync: <E extends WikidotError>(error: E) => WikidotResultAsync<never>;
+/** Promiseからの変換 */
+declare const fromPromise: <T>(promise: Promise<T>, errorMapper: (error: unknown) => WikidotError) => WikidotResultAsync<T>;
+/** 複数ResultAsyncの結合 */
+declare const combineResults: <T>(results: WikidotResultAsync<T>[]) => WikidotResultAsync<T[]>;
+/**
+* Ajax Module Connector設定
+*/
+interface AMCConfig {
+	/** リクエストタイムアウト（ミリ秒） */
+	timeout: number;
+	/** リトライ上限回数 */
+	retryLimit: number;
+	/** リトライ基本間隔（ミリ秒） */
+	retryInterval: number;
+	/** 最大バックオフ（ミリ秒） */
+	maxBackoff: number;
+	/** バックオフ係数 */
+	backoffFactor: number;
+	/** 最大並列リクエスト数 */
+	semaphoreLimit: number;
+}
+/** デフォルトAMC設定 */
+declare const DEFAULT_AMC_CONFIG: AMCConfig;
+/**
+* AMCリクエストヘッダーを管理するクラス
+*/
+declare class AMCHeader {
+	private cookies;
+	private contentType;
+	private userAgent;
+	private referer;
+	/**
+	* @param options - ヘッダー初期化オプション
+	*/
+	constructor(options?: {
+		contentType?: string;
+		userAgent?: string;
+		referer?: string;
+	});
+	/**
+	* Cookieを設定する
+	* @param name - Cookie名
+	* @param value - Cookie値
+	*/
+	setCookie(name: string, value: string): void;
+	/**
+	* Cookieを削除する
+	* @param name - Cookie名
+	*/
+	deleteCookie(name: string): void;
+	/**
+	* Cookieを取得する
+	* @param name - Cookie名
+	* @returns Cookie値、存在しない場合はundefined
+	*/
+	getCookie(name: string): string | undefined;
+	/**
+	* HTTPヘッダーオブジェクトを取得する
+	* @returns ヘッダー辞書
+	*/
+	getHeaders(): Record<string, string>;
+}
+import { z } from "zod";
+/**
+* AMCリクエストボディの値型
+*/
+type AMCRequestBodyValue = string | number | boolean | null | undefined | Record<string, unknown> | AMCRequestBodyValue[];
+/**
+* AMCリクエストボディの型定義
+*/
+interface AMCRequestBody {
+	moduleName?: string;
+	action?: string;
+	event?: string;
+	[key: string]: AMCRequestBodyValue;
+}
+/**
+* AMCレスポンスのベーススキーマ
+*/
+declare const baseSchema: z.ZodObject<{
+	status: z.ZodString;
+	body: z.ZodOptional<z.ZodString>;
+	message: z.ZodOptional<z.ZodString>;
+}>;
+/**
+* AMCレスポンススキーマ
+*/
+declare const amcResponseSchema: z.ZodType<z.infer<typeof baseSchema> & Record<string, unknown>>;
+/**
+* AMCレスポンス型
+*/
+type AMCResponse = z.infer<typeof amcResponseSchema>;
+/**
+* 成功したAMCレスポンス
+*/
+interface AMCSuccessResponse {
+	status: "ok";
+	body: string;
+	[key: string]: unknown;
+}
+/**
+* AMCレスポンスが成功かどうかを判定する型ガード
+* @param response - AMCレスポンス
+* @returns 成功レスポンスの場合true
+*/
+declare function isSuccessResponse(response: AMCResponse): response is AMCSuccessResponse;
+/**
+* 機密情報をマスクする（ログ出力用）
+* @param body - マスク対象のリクエストボディ
+* @returns マスクされたボディ
+*/
+declare function maskSensitiveData(body: AMCRequestBody): Record<string, unknown>;
+/**
+* AMCリクエストオプション
+*/
+interface AMCRequestOptions {
+	/** サイト名（デフォルト: www） */
+	siteName?: string;
+	/** SSL対応（省略時は自動検出） */
+	sslSupported?: boolean;
+	/** エラーを例外として投げずに結果に含める（デフォルト: false） */
+	returnExceptions?: boolean;
+}
+/**
+* Ajax Module Connectorクライアント
+* Wikidot AMCエンドポイントへのリクエストを管理する
+*/
+declare class AMCClient {
+	/** kyインスタンス */
+	private readonly ky;
+	/** 並列リクエスト制限 */
+	private readonly limit;
+	/** ヘッダー管理 */
+	readonly header: AMCHeader;
+	/** 設定 */
+	readonly config: AMCConfig;
+	/** ベースドメイン */
+	readonly domain: string;
+	/** SSL対応状況のキャッシュ */
+	private sslCache;
+	/**
+	* @param config - AMC設定（省略時はデフォルト値）
+	* @param domain - ベースドメイン（デフォルト: wikidot.com）
+	*/
+	constructor(config?: Partial<AMCConfig>, domain?: string);
+	/**
+	* サイトの存在とSSL対応状況を確認する
+	* @param siteName - サイト名
+	* @returns SSL対応状況（true: HTTPS、false: HTTP）
+	*/
+	checkSiteSSL(siteName: string): WikidotResultAsync<boolean>;
+	/**
+	* AMCリクエストを実行する
+	* @param bodies - リクエストボディ配列
+	* @param siteName - サイト名（省略時はwww）
+	* @param sslSupported - SSL対応（省略時は自動検出）
+	* @returns レスポンス配列
+	*/
+	request(bodies: AMCRequestBody[], siteName?: string, sslSupported?: boolean): WikidotResultAsync<AMCResponse[]>;
+	/**
+	* AMCリクエストを実行する（オプション指定版）
+	* @param bodies - リクエストボディ配列
+	* @param options - リクエストオプション
+	* @returns レスポンス配列（returnExceptionsがtrueの場合はエラーも含む）
+	*/
+	requestWithOptions(bodies: AMCRequestBody[], options?: AMCRequestOptions): WikidotResultAsync<(AMCResponse | WikidotError)[]>;
+	/**
+	* 単一リクエストを実行する内部メソッド
+	* @param body - リクエストボディ
+	* @param url - リクエストURL
+	* @returns レスポンス
+	*/
+	private singleRequest;
+}
+/**
+* クライアント参照インターフェース
+* Client型への直接依存を避けるために使用
+*/
+interface ClientRef {
+	/**
+	* ログインが必要な操作の前に呼び出す
+	* @returns ログインしていない場合はエラー
+	*/
+	requireLogin(): {
+		isErr(): boolean;
+		error?: Error;
+	};
+	/**
+	* ログイン済みかどうか
+	*/
+	isLoggedIn(): boolean;
+}
+/**
+* AMCHeaderの最小インターフェース
+*/
+interface AMCHeaderRef {
+	getHeaders(): Record<string, string>;
+	setCookie(name: string, value: string): void;
+	deleteCookie(name: string): void;
+}
+/**
+* AMCClientの最小インターフェース
+*/
+interface AMCClientRef {
+	header: AMCHeaderRef;
+	request(bodies: AMCRequestBody[]): WikidotResultAsync<AMCResponse[]>;
+}
+/**
+* 認証処理で必要なクライアントコンテキスト
+* auth.tsがclient.tsに直接依存することを避けるために使用
+*/
+interface AuthClientContext {
+	amcClient: AMCClientRef;
+}
+/**
+* サイト参照インターフェース
+* Site型への直接依存を避けるために使用
+*/
+interface SiteRef {
+	/**
+	* サイトID
+	*/
+	readonly id: number;
+	/**
+	* UNIX名（例: scp-jp）
+	*/
+	readonly unixName: string;
+	/**
+	* ドメイン
+	*/
+	readonly domain: string;
+	/**
+	* SSL対応フラグ
+	*/
+	readonly sslSupported: boolean;
+	/**
+	* クライアント参照
+	*/
+	readonly client: ClientRef;
+	/**
+	* AMCリクエストを実行
+	*/
+	amcRequest(bodies: AMCRequestBody[]): WikidotResultAsync<AMCResponse[]>;
+	/**
+	* 単一のAMCリクエストを実行
+	*/
+	amcRequestSingle(body: AMCRequestBody): WikidotResultAsync<AMCResponse>;
+}
+/**
+* フォーラムカテゴリ参照インターフェース
+*/
+interface ForumCategoryRef {
+	/**
+	* カテゴリID
+	*/
+	readonly id: number;
+	/**
+	* カテゴリタイトル
+	*/
+	readonly title: string;
+	/**
+	* サイト参照
+	*/
+	readonly site: SiteRef;
+}
+/**
+* フォーラムスレッド参照インターフェース
+* ForumThread型への直接依存を避けるために使用
+*/
+interface ForumThreadRef {
+	/**
+	* スレッドID
+	*/
+	readonly id: number;
+	/**
+	* スレッドタイトル
+	*/
+	readonly title: string;
+	/**
+	* サイト参照
+	*/
+	readonly site: SiteRef;
+	/**
+	* カテゴリ参照（存在する場合）
+	*/
+	readonly category?: ForumCategoryRef | null;
+}
+/**
+* ページ参照インターフェース
+* Page型への直接依存を避けるために使用
+*/
+interface PageRef {
+	/**
+	* ページID（取得後に設定される）
+	*/
+	readonly id: number | null;
+	/**
+	* フルネーム（category:name 形式）
+	*/
+	readonly fullname: string;
+	/**
+	* ページ名
+	*/
+	readonly name: string;
+	/**
+	* カテゴリ
+	*/
+	readonly category: string;
+	/**
+	* サイト参照
+	*/
+	readonly site: SiteRef;
+}
+/**
+* ユーザー名とパスワードでWikidotにログインする
+* @param client - クライアントコンテキスト（AMCClientを持つオブジェクト）
+* @param username - ユーザー名
+* @param password - パスワード
+* @returns 成功時はvoid、失敗時はSessionCreateError
+*/
+declare function login(client: AuthClientContext, username: string, password: string): WikidotResultAsync<void>;
+/**
+* ログアウトする
+* @param client - クライアントコンテキスト（AMCClientを持つオブジェクト）
+* @returns 成功時はvoid
+*/
+declare function logout(client: AuthClientContext): WikidotResultAsync<void>;
+/**
+* ユーザー種別
+*/
+type UserType = "user" | "deleted" | "anonymous" | "guest" | "wikidot";
+/**
+* ユーザー基底インターフェース
+*/
+interface AbstractUser {
+	/** クライアント */
+	readonly client: ClientRef;
+	/** ユーザーID */
+	readonly id: number;
+	/** ユーザー名 */
+	readonly name: string;
+	/** UNIX形式のユーザー名 */
+	readonly unixName: string | null;
+	/** アバターURL */
+	readonly avatarUrl: string | null;
+	/** IPアドレス（匿名ユーザーの場合のみ） */
+	readonly ip: string | null;
+	/** ユーザー種別 */
+	readonly userType: UserType;
+	/** ユーザー種別を判定 */
+	isUser(): boolean;
+	isDeletedUser(): boolean;
+	isAnonymousUser(): boolean;
+	isGuestUser(): boolean;
+	isWikidotUser(): boolean;
+}
+/**
+* 匿名ユーザー
+*/
+declare class AnonymousUser implements AbstractUser {
+	readonly client: ClientRef;
+	/** ユーザーID（匿名は0） */
+	readonly id: number;
+	/** ユーザー名（匿名は"Anonymous"） */
+	readonly name: string;
+	/** UNIX形式のユーザー名 */
+	readonly unixName: string;
+	/** アバターURL（匿名はnull） */
+	readonly avatarUrl: string | null;
+	/** IPアドレス */
+	readonly ip: string;
+	/** ユーザー種別 */
+	readonly userType: UserType;
+	constructor(client: ClientRef, ip: string);
+	isUser(): boolean;
+	isDeletedUser(): boolean;
+	isAnonymousUser(): boolean;
+	isGuestUser(): boolean;
+	isWikidotUser(): boolean;
+	toString(): string;
+}
+/**
+* 削除済みユーザー
+*/
+declare class DeletedUser implements AbstractUser {
+	readonly client: ClientRef;
+	/** 削除済みユーザーID */
+	readonly id: number;
+	/** ユーザー名（削除済みは"account deleted"） */
+	readonly name: string;
+	/** UNIX形式のユーザー名 */
+	readonly unixName: string;
+	/** アバターURL（削除済みはnull） */
+	readonly avatarUrl: string | null;
+	/** IPアドレス（削除済みはnull） */
+	readonly ip: string | null;
+	/** ユーザー種別 */
+	readonly userType: UserType;
+	constructor(client: ClientRef, id: number);
+	isUser(): boolean;
+	isDeletedUser(): boolean;
+	isAnonymousUser(): boolean;
+	isGuestUser(): boolean;
+	isWikidotUser(): boolean;
+	toString(): string;
+}
+/**
+* ゲストユーザー
+*/
+declare class GuestUser implements AbstractUser {
+	readonly client: ClientRef;
+	/** ユーザーID（ゲストは0） */
+	readonly id: number;
+	/** ゲスト名 */
+	readonly name: string;
+	/** UNIX形式のユーザー名（ゲストはnull） */
+	readonly unixName: string | null;
+	/** アバターURL（Gravatarの場合あり） */
+	readonly avatarUrl: string | null;
+	/** IPアドレス（ゲストはnull） */
+	readonly ip: string | null;
+	/** ユーザー種別 */
+	readonly userType: UserType;
+	constructor(client: ClientRef, name: string, avatarUrl?: string | null);
+	isUser(): boolean;
+	isDeletedUser(): boolean;
+	isAnonymousUser(): boolean;
+	isGuestUser(): boolean;
+	isWikidotUser(): boolean;
+	toString(): string;
+}
+/**
+* ユーザーコレクション
+*/
+declare class UserCollection extends Array<User | null> {
+	constructor(users?: (User | null)[]);
+	/**
+	* ユーザー名で検索
+	* @param name - ユーザー名
+	* @returns ユーザーまたはundefined
+	*/
+	findByName(name: string): User | undefined;
+	/**
+	* ユーザーIDで検索
+	* @param id - ユーザーID
+	* @returns ユーザーまたはundefined
+	*/
+	findById(id: number): User | undefined;
+	/**
+	* nullを除いたユーザーのみを返す
+	* @returns null以外のユーザー配列
+	*/
+	filterNonNull(): User[];
+}
+/**
+* ユーザーデータ
+*/
+interface UserData {
+	id: number;
+	name: string;
+	displayName?: string | null;
+	avatarUrl?: string | null;
+	unixName?: string;
+}
+/**
+* 通常ユーザー
+*/
+declare class User implements AbstractUser {
+	readonly client: ClientRef;
+	/** ユーザーID */
+	readonly id: number;
+	/** ユーザー名 */
+	readonly name: string;
+	/** 表示名 */
+	readonly displayName: string | null;
+	/** アバターURL */
+	readonly avatarUrl: string | null;
+	/** UNIX形式のユーザー名 */
+	readonly unixName: string;
+	/** IPアドレス（通常ユーザーではnull） */
+	readonly ip: string | null;
+	/** ユーザー種別 */
+	readonly userType: UserType;
+	constructor(client: ClientRef, data: UserData);
+	/**
+	* ユーザー名からユーザーを取得する
+	* @param client - クライアント
+	* @param name - ユーザー名
+	* @returns ユーザー（存在しない場合はnull）
+	*/
+	static fromName(client: ClientRef, name: string): WikidotResultAsync<User | null>;
+	/**
+	* 複数ユーザー名からユーザーを取得する
+	* @param client - クライアント
+	* @param names - ユーザー名配列
+	* @returns ユーザーコレクション
+	*/
+	static fromNames(client: ClientRef, names: string[]): WikidotResultAsync<UserCollection>;
+	isUser(): boolean;
+	isDeletedUser(): boolean;
+	isAnonymousUser(): boolean;
+	isGuestUser(): boolean;
+	isWikidotUser(): boolean;
+	toString(): string;
+}
+/**
+* Wikidotシステムユーザー
+*/
+declare class WikidotUser implements AbstractUser {
+	readonly client: ClientRef;
+	/** ユーザーID（Wikidotシステムは0） */
+	readonly id: number;
+	/** ユーザー名 */
+	readonly name: string;
+	/** UNIX形式のユーザー名 */
+	readonly unixName: string;
+	/** アバターURL（システムユーザーはnull） */
+	readonly avatarUrl: string | null;
+	/** IPアドレス（システムユーザーはnull） */
+	readonly ip: string | null;
+	/** ユーザー種別 */
+	readonly userType: UserType;
+	constructor(client: ClientRef);
+	isUser(): boolean;
+	isDeletedUser(): boolean;
+	isAnonymousUser(): boolean;
+	isGuestUser(): boolean;
+	isWikidotUser(): boolean;
+	toString(): string;
+}
+/**
+* プライベートメッセージデータ
+*/
+interface PrivateMessageData {
+	client: Client;
+	id: number;
+	sender: AbstractUser;
+	recipient: AbstractUser;
+	subject: string;
+	body: string;
+	createdAt: Date;
+}
+/**
+* プライベートメッセージ
+*/
+declare class PrivateMessage {
+	readonly client: Client;
+	readonly id: number;
+	readonly sender: AbstractUser;
+	readonly recipient: AbstractUser;
+	readonly subject: string;
+	readonly body: string;
+	readonly createdAt: Date;
+	constructor(data: PrivateMessageData);
+	/**
+	* メッセージIDからメッセージを取得する
+	* @param client - クライアント
+	* @param messageId - メッセージID
+	* @returns プライベートメッセージ
+	*/
+	static fromId(client: Client, messageId: number): WikidotResultAsync<PrivateMessage>;
+	/**
+	* プライベートメッセージを送信する
+	* @param client - クライアント
+	* @param recipient - 受信者
+	* @param subject - 件名
+	* @param body - 本文
+	*/
+	static send(client: Client, recipient: User, subject: string, body: string): WikidotResultAsync<void>;
+	toString(): string;
+}
+/**
+* プライベートメッセージコレクション
+*/
+declare class PrivateMessageCollection extends Array<PrivateMessage> {
+	readonly client: Client;
+	constructor(client: Client, messages?: PrivateMessage[]);
+	/**
+	* IDで検索
+	*/
+	findById(id: number): PrivateMessage | undefined;
+	/**
+	* メッセージIDのリストからメッセージを取得する
+	*/
+	static fromIds(client: Client, messageIds: number[]): WikidotResultAsync<PrivateMessageCollection>;
+	/**
+	* モジュールからメッセージを取得する内部メソッド
+	*/
+	protected static acquireFromModule(client: Client, moduleName: string): WikidotResultAsync<PrivateMessageCollection>;
+}
+/**
+* 受信箱
+*/
+declare class PrivateMessageInbox extends PrivateMessageCollection {
+	/**
+	* 受信箱のメッセージをすべて取得する
+	*/
+	static acquire(client: Client): WikidotResultAsync<PrivateMessageInbox>;
+}
+/**
+* 送信箱
+*/
+declare class PrivateMessageSentBox extends PrivateMessageCollection {
+	/**
+	* 送信箱のメッセージをすべて取得する
+	*/
+	static acquire(client: Client): WikidotResultAsync<PrivateMessageSentBox>;
+}
+import { Element } from "domhandler";
+/**
+* フォーラム投稿データ
+*/
+interface ForumPostData {
+	thread: ForumThreadRef;
+	id: number;
+	title: string;
+	text: string;
+	element: Element;
+	createdBy: AbstractUser;
+	createdAt: Date;
+	editedBy?: AbstractUser | null;
+	editedAt?: Date | null;
+	parentId?: number | null;
+}
+/**
+* フォーラム投稿
+*/
+declare class ForumPost {
+	readonly thread: ForumThreadRef;
+	readonly id: number;
+	title: string;
+	readonly text: string;
+	readonly element: Element;
+	readonly createdBy: AbstractUser;
+	readonly createdAt: Date;
+	readonly editedBy: AbstractUser | null;
+	readonly editedAt: Date | null;
+	private _parentId;
+	private _source;
+	constructor(data: ForumPostData);
+	/**
+	* 親投稿ID
+	*/
+	get parentId(): number | null;
+	/**
+	* ソースコード（Wikidot記法）を取得
+	*/
+	getSource(): WikidotResultAsync<string>;
+	/**
+	* 投稿を編集する
+	* @param source - 新しいソース（Wikidot記法）
+	* @param title - 新しいタイトル（省略時は現在のタイトルを維持）
+	*/
+	edit(source: string, title?: string): WikidotResultAsync<void>;
+	toString(): string;
+}
+/**
+* フォーラム投稿コレクション
+*/
+declare class ForumPostCollection extends Array<ForumPost> {
+	readonly thread: ForumThreadRef;
+	constructor(thread: ForumThreadRef, posts?: ForumPost[]);
+	/**
+	* IDで検索
+	* @param id - 投稿ID
+	* @returns 投稿（存在しない場合はundefined）
+	*/
+	findById(id: number): ForumPost | undefined;
+	/**
+	* HTMLから投稿をパースする（内部メソッド）
+	*/
+	private static _parse;
+	/**
+	* スレッド内の全投稿を取得
+	*/
+	static acquireAllInThread(thread: ForumThreadRef): WikidotResultAsync<ForumPostCollection>;
+}
+/**
+* フォーラムスレッドデータ
+*/
+interface ForumThreadData {
+	site: Site;
+	id: number;
+	title: string;
+	description: string;
+	createdBy: AbstractUser | null;
+	createdAt: Date;
+	postCount: number;
+	category?: ForumCategory | null;
+}
+/**
+* フォーラムスレッド
+*/
+declare class ForumThread2 {
+	readonly site: Site;
+	readonly id: number;
+	readonly title: string;
+	readonly description: string;
+	readonly createdBy: AbstractUser | null;
+	readonly createdAt: Date;
+	postCount: number;
+	readonly category: ForumCategory | null;
+	private _posts;
+	constructor(data: ForumThreadData);
+	/**
+	* スレッドURL
+	*/
+	getUrl(): string;
+	/**
+	* 投稿一覧を取得
+	*/
+	getPosts(): WikidotResultAsync<ForumPostCollection>;
+	/**
+	* スレッドに返信
+	*/
+	reply(source: string, title?: string, parentPostId?: number | null): WikidotResultAsync<ForumThread2>;
+	toString(): string;
+	/**
+	* IDからスレッドを取得
+	*/
+	static getFromId(site: Site, threadId: number, category?: ForumCategory | null): WikidotResultAsync<ForumThread2>;
+}
+/**
+* フォーラムスレッドコレクション
+*/
+declare class ForumThreadCollection extends Array<ForumThread2> {
+	readonly site: Site;
+	constructor(site: Site, threads?: ForumThread2[]);
+	/**
+	* IDで検索
+	*/
+	findById(id: number): ForumThread2 | undefined;
+	/**
+	* カテゴリ内の全スレッドを取得
+	*/
+	static acquireAllInCategory(category: ForumCategory): WikidotResultAsync<ForumThreadCollection>;
+	/**
+	* スレッドIDから単一のスレッドを取得
+	* @param site - サイト
+	* @param threadId - スレッドID
+	*/
+	static fromId(site: Site, threadId: number): WikidotResultAsync<ForumThread2>;
+	/**
+	* スレッドIDからスレッドを取得
+	*/
+	static acquireFromThreadIds(site: Site, threadIds: number[], category?: ForumCategory | null): WikidotResultAsync<ForumThreadCollection>;
+}
+/**
+* フォーラムカテゴリデータ
+*/
+interface ForumCategoryData {
+	site: Site;
+	id: number;
+	title: string;
+	description: string;
+	threadsCount: number;
+	postsCount: number;
+}
+/**
+* フォーラムカテゴリ
+*/
+declare class ForumCategory {
+	readonly site: Site;
+	readonly id: number;
+	readonly title: string;
+	readonly description: string;
+	readonly threadsCount: number;
+	readonly postsCount: number;
+	private _threads;
+	constructor(data: ForumCategoryData);
+	/**
+	* スレッド一覧を取得
+	*/
+	getThreads(): WikidotResultAsync<ForumThreadCollection>;
+	/**
+	* スレッド一覧を再取得
+	*/
+	reloadThreads(): WikidotResultAsync<ForumThreadCollection>;
+	/**
+	* スレッドを作成
+	*/
+	createThread(title: string, description: string, source: string): WikidotResultAsync<ForumThread2>;
+	toString(): string;
+}
+/**
+* フォーラムカテゴリコレクション
+*/
+declare class ForumCategoryCollection extends Array<ForumCategory> {
+	readonly site: Site;
+	constructor(site: Site, categories?: ForumCategory[]);
+	/**
+	* IDで検索
+	*/
+	findById(id: number): ForumCategory | undefined;
+	/**
+	* サイトの全カテゴリを取得
+	*/
+	static acquireAll(site: Site): WikidotResultAsync<ForumCategoryCollection>;
+}
+/**
+* QuickModuleモジュール名
+*/
+type QuickModuleName = "MemberLookupQModule" | "UserLookupQModule" | "PageLookupQModule";
+/**
+* QuickModuleユーザー情報
+*/
+interface QMCUser {
+	id: number;
+	name: string;
+}
+/**
+* QuickModuleページ情報
+*/
+interface QMCPage {
+	title: string;
+	unixName: string;
+}
+/**
+* サイトメンバーを検索
+* @param siteId - サイトID
+* @param query - 検索クエリ（ユーザー名の一部）
+* @returns マッチしたユーザー一覧
+*/
+declare function memberLookup(siteId: number, query: string): WikidotResultAsync<QMCUser[]>;
+/**
+* Wikidot全体からユーザーを検索
+* @param siteId - サイトID（任意のサイトIDで可）
+* @param query - 検索クエリ（ユーザー名の一部）
+* @returns マッチしたユーザー一覧
+*/
+declare function userLookup(siteId: number, query: string): WikidotResultAsync<QMCUser[]>;
+/**
+* サイト内のページを検索
+* @param siteId - サイトID
+* @param query - 検索クエリ（ページ名の一部）
+* @returns マッチしたページ一覧
+*/
+declare function pageLookup(siteId: number, query: string): WikidotResultAsync<QMCPage[]>;
+/**
+* QuickModule API（後方互換性のため維持）
+* @deprecated 代わりに個別の関数（memberLookup, userLookup, pageLookup）を使用してください
+*/
+declare const QuickModule: {
+	memberLookup: typeof memberLookup;
+	userLookup: typeof userLookup;
+	pageLookup: typeof pageLookup;
+};
+/**
+* サイト参加申請データ
+*/
+interface SiteApplicationData {
+	site: Site;
+	user: AbstractUser;
+	text: string;
+}
+/**
+* サイト参加申請
+*/
+declare class SiteApplication {
+	readonly site: Site;
+	readonly user: AbstractUser;
+	readonly text: string;
+	constructor(data: SiteApplicationData);
+	/**
+	* 未処理の参加申請をすべて取得する
+	* @param site - 対象サイト
+	*/
+	static acquireAll(site: Site): WikidotResultAsync<SiteApplication[]>;
+	/**
+	* 申請を処理する内部メソッド
+	*/
+	private process;
+	/**
+	* 参加申請を承認する
+	*/
+	accept(): WikidotResultAsync<void>;
+	/**
+	* 参加申請を拒否する
+	*/
+	decline(): WikidotResultAsync<void>;
+	toString(): string;
+}
+/**
+* サイトメンバーデータ
+*/
+interface SiteMemberData {
+	site: Site;
+	user: AbstractUser;
+	joinedAt: Date | null;
+}
+/**
+* サイトメンバー
+*/
+declare class SiteMember {
+	readonly site: Site;
+	readonly user: AbstractUser;
+	readonly joinedAt: Date | null;
+	constructor(data: SiteMemberData);
+	/**
+	* HTMLからメンバー情報をパースする
+	*/
+	private static parse;
+	/**
+	* サイトメンバー一覧を取得する
+	* @param site - 対象サイト
+	* @param group - グループ（"admins", "moderators", または空文字で全メンバー）
+	*/
+	static getMembers(site: Site, group?: "admins" | "moderators" | ""): WikidotResultAsync<SiteMember[]>;
+	/**
+	* グループ変更の内部メソッド
+	*/
+	private changeGroup;
+	/**
+	* モデレーターに昇格
+	*/
+	toModerator(): WikidotResultAsync<void>;
+	/**
+	* モデレーター権限を削除
+	*/
+	removeModerator(): WikidotResultAsync<void>;
+	/**
+	* 管理者に昇格
+	*/
+	toAdmin(): WikidotResultAsync<void>;
+	/**
+	* 管理者権限を削除
+	*/
+	removeAdmin(): WikidotResultAsync<void>;
+	toString(): string;
+}
+/**
+* サイトメンバー操作アクセサ
+*/
+declare class MemberAccessor {
+	readonly site: Site;
+	constructor(site: Site);
+	/**
+	* 全メンバーを取得する
+	* @returns メンバー一覧
+	*/
+	getAll(): WikidotResultAsync<SiteMember[]>;
+	/**
+	* モデレーター一覧を取得する
+	* @returns モデレーター一覧
+	*/
+	getModerators(): WikidotResultAsync<SiteMember[]>;
+	/**
+	* 管理者一覧を取得する
+	* @returns 管理者一覧
+	*/
+	getAdmins(): WikidotResultAsync<SiteMember[]>;
+	/**
+	* 未処理の参加申請を取得する
+	* @returns 参加申請一覧
+	*/
+	getApplications(): WikidotResultAsync<SiteApplication[]>;
+	/**
+	* メンバーを検索する
+	* @param query - 検索クエリ（ユーザー名の一部）
+	* @returns マッチしたユーザー一覧（QMCUser形式）
+	*/
+	lookup(query: string): WikidotResultAsync<QMCUser[]>;
+	/**
+	* ユーザーをサイトに招待する
+	* @param user - 招待するユーザー
+	* @param text - 招待メッセージ
+	*/
+	invite(user: User, text: string): WikidotResultAsync<void>;
+}
+import * as cheerio from "cheerio";
+import { AnyNode } from "domhandler";
+/**
+* ページファイルデータ
+*/
+interface PageFileData {
+	page: Page;
+	id: number;
+	name: string;
+	url: string;
+	mimeType: string;
+	size: number;
+}
+/**
+* ページ添付ファイル
+*/
+declare class PageFile {
+	readonly page: Page;
+	readonly id: number;
+	readonly name: string;
+	readonly url: string;
+	readonly mimeType: string;
+	readonly size: number;
+	constructor(data: PageFileData);
+	toString(): string;
+}
+/**
+* ページファイルコレクション
+*/
+declare class PageFileCollection extends Array<PageFile> {
+	readonly page: Page;
+	constructor(page: Page, files?: PageFile[]);
+	/**
+	* IDで検索
+	*/
+	findById(id: number): PageFile | undefined;
+	/**
+	* 名前で検索
+	*/
+	findByName(name: string): PageFile | undefined;
+	/**
+	* サイズ文字列をバイト数に変換
+	*/
+	private static parseSize;
+	/**
+	* ページに添付されたファイル一覧を取得する
+	*/
+	static acquire(page: Page): WikidotResultAsync<PageFileCollection>;
+}
+/**
+* ページメタタグデータ
+*/
+interface PageMetaData {
+	page: PageRef;
+	name: string;
+	content: string;
+}
+/**
+* ページメタタグ
+*/
+declare class PageMeta {
+	readonly page: PageRef;
+	readonly name: string;
+	content: string;
+	constructor(data: PageMetaData);
+	/**
+	* メタタグの値を更新する
+	* @param content - 新しい値
+	*/
+	update(content: string): WikidotResultAsync<void>;
+	/**
+	* メタタグを削除する
+	*/
+	delete(): WikidotResultAsync<void>;
+	toString(): string;
+}
+/**
+* ページメタタグコレクション
+*/
+declare class PageMetaCollection extends Array<PageMeta> {
+	readonly page: PageRef;
+	constructor(page: PageRef, metas?: PageMeta[]);
+	/**
+	* 名前で検索
+	* @param name - メタタグ名
+	* @returns メタタグ（存在しない場合はundefined）
+	*/
+	findByName(name: string): PageMeta | undefined;
+	/**
+	* ページのメタタグを取得する
+	* @param page - ページ参照
+	* @returns メタタグコレクション
+	*/
+	static acquire(page: PageRef): WikidotResultAsync<PageMetaCollection>;
+	/**
+	* メタタグを設定する
+	* @param page - ページ参照
+	* @param name - メタタグ名
+	* @param content - メタタグの値
+	*/
+	static setMeta(page: PageRef, name: string, content: string): WikidotResultAsync<void>;
+	/**
+	* メタタグを削除する
+	* @param page - ページ参照
+	* @param name - メタタグ名
+	*/
+	static deleteMeta(page: PageRef, name: string): WikidotResultAsync<void>;
+}
+/**
+* ページソースデータ
+*/
+interface PageSourceData {
+	page: Page;
+	wikiText: string;
+}
+/**
+* ページのソースコード（Wikidot記法）
+*/
+declare class PageSource {
+	/** ソースが属するページ */
+	readonly page: Page;
+	/** ソースコード（Wikidot記法） */
+	readonly wikiText: string;
+	constructor(data: PageSourceData);
+	toString(): string;
+}
+/**
+* ページリビジョンデータ
+*/
+interface PageRevisionData {
+	page: Page;
+	id: number;
+	revNo: number;
+	createdBy: AbstractUser;
+	createdAt: Date;
+	comment: string;
+}
+/**
+* ページのリビジョン（編集履歴のバージョン）
+*/
+declare class PageRevision {
+	/** リビジョンが属するページ */
+	readonly page: Page;
+	/** リビジョンID */
+	readonly id: number;
+	/** リビジョン番号 */
+	readonly revNo: number;
+	/** リビジョン作成者 */
+	readonly createdBy: AbstractUser;
+	/** リビジョン作成日時 */
+	readonly createdAt: Date;
+	/** 編集コメント */
+	readonly comment: string;
+	/** ソースコード（内部キャッシュ） */
+	private _source;
+	/** HTML表示（内部キャッシュ） */
+	private _html;
+	constructor(data: PageRevisionData);
+	/**
+	* ソースコードが取得済みかどうか
+	*/
+	isSourceAcquired(): boolean;
+	/**
+	* HTML表示が取得済みかどうか
+	*/
+	isHtmlAcquired(): boolean;
+	/**
+	* ソースコード（キャッシュ済み）を取得
+	*/
+	get source(): PageSource | null;
+	/**
+	* ソースコードを設定
+	*/
+	set source(value: PageSource | null);
+	/**
+	* HTML表示（キャッシュ済み）を取得
+	*/
+	get html(): string | null;
+	/**
+	* HTML表示を設定
+	*/
+	set html(value: string | null);
+	/**
+	* リビジョンのソースを取得する（REV-001）
+	* @returns ソース文字列
+	*/
+	getSource(): WikidotResultAsync<string>;
+	/**
+	* リビジョンのHTMLを取得する（REV-002）
+	* @returns HTML文字列
+	*/
+	getHtml(): WikidotResultAsync<string>;
+	toString(): string;
+}
+/**
+* ページリビジョンコレクション
+*/
+declare class PageRevisionCollection extends Array<PageRevision> {
+	readonly page: Page | null;
+	constructor(page: Page | null, revisions?: PageRevision[]);
+	/**
+	* IDで検索
+	* @param id - リビジョンID
+	* @returns リビジョン（存在しない場合はundefined）
+	*/
+	findById(id: number): PageRevision | undefined;
+	/**
+	* 全リビジョンのソースを一括取得する
+	* @returns ソース文字列の配列
+	*/
+	getSources(): WikidotResultAsync<string[]>;
+	/**
+	* 全リビジョンのHTMLを一括取得する
+	* @returns HTML文字列の配列
+	*/
+	getHtmls(): WikidotResultAsync<string[]>;
+}
+/**
+* ページ投票データ
+*/
+interface PageVoteData {
+	page: Page;
+	user: AbstractUser;
+	value: number;
+}
+/**
+* ページへの投票（レーティング）
+*/
+declare class PageVote {
+	/** 投票が属するページ */
+	readonly page: Page;
+	/** 投票したユーザー */
+	readonly user: AbstractUser;
+	/** 投票値（+1/-1 または 数値） */
+	readonly value: number;
+	constructor(data: PageVoteData);
+	toString(): string;
+}
+/**
+* ページ投票コレクション
+*/
+declare class PageVoteCollection extends Array<PageVote> {
+	readonly page: Page;
+	constructor(page: Page, votes?: PageVote[]);
+	/**
+	* ユーザーで検索
+	* @param user - 検索するユーザー
+	* @returns 投票（存在しない場合はundefined）
+	*/
+	findByUser(user: AbstractUser): PageVote | undefined;
+}
+/**
+* ページ検索クエリのパラメータ
+*/
+interface SearchPagesQueryParams {
+	/** ページタイプ（例: 'normal', 'admin'） */
+	pagetype?: string;
+	/** カテゴリ名 */
+	category?: string;
+	/** 検索対象タグ（AND条件） */
+	tags?: string | string[];
+	/** 親ページ名 */
+	parent?: string;
+	/** リンク先ページ名 */
+	linkTo?: string;
+	/** 作成日時条件 */
+	createdAt?: string;
+	/** 更新日時条件 */
+	updatedAt?: string;
+	/** 作成者 */
+	createdBy?: AbstractUser | string;
+	/** レーティング条件 */
+	rating?: string;
+	/** 投票数条件 */
+	votes?: string;
+	/** ページ名条件 */
+	name?: string;
+	/** フルネーム（完全一致） */
+	fullname?: string;
+	/** 範囲指定 */
+	range?: string;
+	/** ソート順（例: 'created_at desc'） */
+	order?: string;
+	/** 取得開始位置 */
+	offset?: number;
+	/** 取得件数制限 */
+	limit?: number;
+	/** 1ページあたり件数 */
+	perPage?: number;
+	/** 個別表示 */
+	separate?: string;
+	/** ラッパー表示 */
+	wrapper?: string;
+}
+/**
+* デフォルトの1ページあたり件数
+*/
+declare const DEFAULT_PER_PAGE = 250;
+/**
+* デフォルトのモジュールボディフィールド
+*/
+declare const DEFAULT_MODULE_BODY: readonly ["fullname", "category", "name", "title", "created_at", "created_by_linked", "updated_at", "updated_by_linked", "commented_at", "commented_by_linked", "parent_fullname", "comments", "size", "children", "rating_votes", "rating", "rating_percent", "revisions", "tags", "_tags"];
+/**
+* ページ検索クエリ
+*/
+declare class SearchPagesQuery {
+	/** ページタイプ */
+	pagetype: string;
+	/** カテゴリ */
+	category: string;
+	/** タグ */
+	tags: string | string[] | null;
+	/** 親ページ */
+	parent: string | null;
+	/** リンク先 */
+	linkTo: string | null;
+	/** 作成日時条件 */
+	createdAt: string | null;
+	/** 更新日時条件 */
+	updatedAt: string | null;
+	/** 作成者 */
+	createdBy: AbstractUser | string | null;
+	/** レーティング条件 */
+	rating: string | null;
+	/** 投票数条件 */
+	votes: string | null;
+	/** ページ名条件 */
+	name: string | null;
+	/** フルネーム条件 */
+	fullname: string | null;
+	/** 範囲 */
+	range: string | null;
+	/** ソート順 */
+	order: string;
+	/** オフセット */
+	offset: number;
+	/** 取得件数制限 */
+	limit: number | null;
+	/** 1ページあたり件数 */
+	perPage: number;
+	/** 個別表示 */
+	separate: string;
+	/** ラッパー表示 */
+	wrapper: string;
+	constructor(params?: SearchPagesQueryParams);
+	/**
+	* 辞書形式に変換
+	*/
+	asDict(): Record<string, unknown>;
+}
+/**
+* ページデータ
+*/
+interface PageData {
+	site: Site;
+	fullname: string;
+	name: string;
+	category: string;
+	title: string;
+	childrenCount: number;
+	commentsCount: number;
+	size: number;
+	rating: number;
+	votesCount: number;
+	ratingPercent: number | null;
+	revisionsCount: number;
+	parentFullname: string | null;
+	tags: string[];
+	createdBy: AbstractUser | null;
+	createdAt: Date;
+	updatedBy: AbstractUser | null;
+	updatedAt: Date;
+	commentedBy: AbstractUser | null;
+	commentedAt: Date | null;
+}
+/**
+* Wikidotページ
+*/
+declare class Page {
+	readonly site: Site;
+	readonly fullname: string;
+	readonly name: string;
+	readonly category: string;
+	title: string;
+	childrenCount: number;
+	commentsCount: number;
+	size: number;
+	rating: number;
+	votesCount: number;
+	ratingPercent: number | null;
+	revisionsCount: number;
+	parentFullname: string | null;
+	tags: string[];
+	readonly createdBy: AbstractUser | null;
+	readonly createdAt: Date;
+	updatedBy: AbstractUser | null;
+	updatedAt: Date;
+	commentedBy: AbstractUser | null;
+	commentedAt: Date | null;
+	private _id;
+	private _source;
+	private _revisions;
+	private _votes;
+	constructor(data: PageData);
+	/**
+	* ページURLを取得
+	*/
+	getUrl(): string;
+	/**
+	* ページIDが取得済みかどうか
+	*/
+	isIdAcquired(): boolean;
+	/**
+	* ページIDを取得
+	*/
+	get id(): number | null;
+	/**
+	* ページIDを設定
+	*/
+	set id(value: number | null);
+	/**
+	* ソースコードを取得
+	*/
+	get source(): PageSource | null;
+	/**
+	* ソースコードを設定
+	*/
+	set source(value: PageSource | null);
+	/**
+	* リビジョン履歴を取得
+	*/
+	get revisions(): PageRevisionCollection | null;
+	/**
+	* リビジョン履歴を設定
+	*/
+	set revisions(value: PageRevisionCollection | null);
+	/**
+	* 投票情報を取得
+	*/
+	get votes(): PageVoteCollection | null;
+	/**
+	* 投票情報を設定
+	*/
+	set votes(value: PageVoteCollection | null);
+	/**
+	* 最新リビジョンを取得
+	*/
+	get latestRevision(): PageRevision | undefined;
+	/**
+	* ページIDが必須の操作で、IDがない場合にエラーを返すヘルパー
+	* @param operation - 操作名（エラーメッセージ用）
+	* @returns ページIDまたはエラーResult
+	*/
+	private requireId;
+	/**
+	* ページを削除する
+	*/
+	destroy(): WikidotResultAsync<void>;
+	/**
+	* タグを保存する
+	*/
+	commitTags(): WikidotResultAsync<void>;
+	/**
+	* 親ページを設定する
+	* @param parentFullname - 親ページのフルネーム（nullで解除）
+	*/
+	setParent(parentFullname: string | null): WikidotResultAsync<void>;
+	/**
+	* ページに投票する
+	* @param value - 投票値
+	* @returns 新しいレーティング
+	*/
+	vote(value: number): WikidotResultAsync<number>;
+	/**
+	* 投票をキャンセルする
+	* @returns 新しいレーティング
+	*/
+	cancelVote(): WikidotResultAsync<number>;
+	/**
+	* ページを編集する
+	* @param options - 編集オプション
+	*/
+	edit(options: {
+		title?: string;
+		source?: string;
+		comment?: string;
+		forceEdit?: boolean;
+	}): WikidotResultAsync<void>;
+	/**
+	* ページ名を変更する
+	* @param newFullname - 新しいフルネーム
+	*/
+	rename(newFullname: string): WikidotResultAsync<void>;
+	/**
+	* ページに添付されたファイル一覧を取得する
+	*/
+	getFiles(): WikidotResultAsync<PageFileCollection>;
+	/**
+	* ページのディスカッションスレッドを取得する
+	*/
+	getDiscussion(): WikidotResultAsync<import("../forum").ForumThread | null>;
+	/**
+	* ページのメタタグ一覧を取得する
+	* @returns メタタグコレクション
+	*/
+	getMetas(): WikidotResultAsync<PageMetaCollection>;
+	/**
+	* メタタグを設定する
+	* @param name - メタタグ名
+	* @param content - メタタグの値
+	*/
+	setMeta(name: string, content: string): WikidotResultAsync<void>;
+	/**
+	* メタタグを削除する
+	* @param name - メタタグ名
+	*/
+	deleteMeta(name: string): WikidotResultAsync<void>;
+	toString(): string;
+}
+/**
+* ページコレクション
+*/
+declare class PageCollection extends Array<Page> {
+	readonly site: Site;
+	constructor(site: Site, pages?: Page[]);
+	/**
+	* フルネームで検索
+	* @param fullname - ページのフルネーム
+	* @returns ページ（存在しない場合はundefined）
+	*/
+	findByFullname(fullname: string): Page | undefined;
+	/**
+	* ページIDを一括取得
+	*/
+	getPageIds(): WikidotResultAsync<PageCollection>;
+	/**
+	* ページソースを一括取得
+	*/
+	getPageSources(): WikidotResultAsync<PageCollection>;
+	/**
+	* ページリビジョンを一括取得
+	*/
+	getPageRevisions(): WikidotResultAsync<PageCollection>;
+	/**
+	* ページ投票を一括取得
+	*/
+	getPageVotes(): WikidotResultAsync<PageCollection>;
+	/**
+	* ページIDを一括取得する内部メソッド
+	*/
+	static acquirePageIds(site: Site, pages: Page[]): WikidotResultAsync<PageCollection>;
+	/**
+	* ページソースを一括取得する内部メソッド
+	*/
+	static acquirePageSources(site: Site, pages: Page[]): WikidotResultAsync<PageCollection>;
+	/**
+	* ページリビジョンを一括取得する内部メソッド
+	*/
+	static acquirePageRevisions(site: Site, pages: Page[]): WikidotResultAsync<PageCollection>;
+	/**
+	* ページ投票を一括取得する内部メソッド
+	*/
+	static acquirePageVotes(site: Site, pages: Page[]): WikidotResultAsync<PageCollection>;
+	/**
+	* ListPagesModuleレスポンスをパース
+	*/
+	static parse(site: Site, htmlBody: cheerio.CheerioAPI, _parseUser: (element: cheerio.Cheerio<AnyNode>) => AbstractUser): PageCollection;
+	/**
+	* ページ検索
+	*/
+	static searchPages(site: Site, parseUser: (element: cheerio.Cheerio<AnyNode>) => AbstractUser, query?: SearchPagesQuery | null): WikidotResultAsync<PageCollection>;
+	/**
+	* ページを作成または編集
+	*/
+	static createOrEdit(site: Site, fullname: string, options?: {
+		pageId?: number | null;
+		title?: string;
+		source?: string;
+		comment?: string;
+		forceEdit?: boolean;
+		raiseOnExists?: boolean;
+	}): WikidotResultAsync<void>;
+}
+/**
+* サイト変更履歴データ
+*/
+interface SiteChangeData {
+	site: Site;
+	pageFullname: string;
+	pageTitle: string;
+	revisionNo: number;
+	changedBy: AbstractUser | null;
+	changedAt: Date | null;
+	flags: string[];
+	comment: string;
+}
+/**
+* サイト変更履歴
+*/
+declare class SiteChange {
+	readonly site: Site;
+	readonly pageFullname: string;
+	readonly pageTitle: string;
+	readonly revisionNo: number;
+	readonly changedBy: AbstractUser | null;
+	readonly changedAt: Date | null;
+	readonly flags: string[];
+	readonly comment: string;
+	constructor(data: SiteChangeData);
+	/**
+	* ページURL
+	*/
+	getPageUrl(): string;
+	toString(): string;
+}
+/**
+* サイト変更履歴コレクション
+*/
+declare class SiteChangeCollection extends Array<SiteChange> {
+	readonly site: Site;
+	constructor(site: Site, changes?: SiteChange[]);
+	/**
+	* 最近の変更履歴を取得する
+	* @param site - サイト
+	* @param options - オプション
+	* @returns 変更履歴コレクション
+	*/
+	static acquire(site: Site, options?: {
+		perPage?: number;
+		page?: number;
+		limit?: number;
+	}): WikidotResultAsync<SiteChangeCollection>;
+}
+/**
+* 単一ページ操作アクセサ
+*/
+declare class PageAccessor {
+	readonly site: Site;
+	constructor(site: Site);
+	/**
+	* UNIX名からページを取得する
+	* @param unixName - ページのUNIX名（例: 'scp-173'）
+	* @returns ページ（存在しない場合はnull）
+	*/
+	get(unixName: string): WikidotResultAsync<Page | null>;
+	/**
+	* ページを作成する
+	* @param fullname - ページのフルネーム（例: 'scp-173'）
+	* @param options - 作成オプション
+	* @returns void
+	*/
+	create(fullname: string, options?: {
+		title?: string;
+		source?: string;
+		comment?: string;
+		forceEdit?: boolean;
+	}): WikidotResultAsync<void>;
+}
+/**
+* ページ一覧操作アクセサ
+*/
+declare class PagesAccessor {
+	readonly site: Site;
+	constructor(site: Site);
+	/**
+	* 条件に合うページを検索する
+	* @param params - 検索条件
+	* @returns ページコレクション
+	*/
+	search(params?: SearchPagesQueryParams): WikidotResultAsync<PageCollection>;
+	/**
+	* 全ページを取得する
+	* @returns ページコレクション
+	*/
+	all(): WikidotResultAsync<PageCollection>;
+	/**
+	* 最近の変更履歴を取得する
+	* @param options - オプション
+	* @param options.perPage - 1ページあたりの件数（デフォルト: 20）
+	* @param options.page - ページ番号（デフォルト: 1）
+	* @returns 変更履歴コレクション
+	*/
+	getRecentChanges(options?: {
+		perPage?: number;
+		page?: number;
+	}): WikidotResultAsync<SiteChangeCollection>;
+}
+/**
+* サイトデータ
+*/
+interface SiteData {
+	id: number;
+	title: string;
+	unixName: string;
+	domain: string;
+	sslSupported: boolean;
+}
+/**
+* サイトクラス
+*/
+declare class Site {
+	readonly client: Client;
+	/** サイトID */
+	readonly id: number;
+	/** サイトタイトル */
+	readonly title: string;
+	/** UNIX名（例: scp-jp） */
+	readonly unixName: string;
+	/** ドメイン */
+	readonly domain: string;
+	/** SSL対応フラグ */
+	readonly sslSupported: boolean;
+	/** ページアクセサ */
+	private _page;
+	/** ページ一覧アクセサ */
+	private _pages;
+	/** フォーラムアクセサ */
+	private _forum;
+	/** メンバーアクセサ */
+	private _member;
+	constructor(client: Client, data: SiteData);
+	/**
+	* ページアクセサを取得
+	*/
+	get page(): PageAccessor;
+	/**
+	* ページ一覧アクセサを取得
+	*/
+	get pages(): PagesAccessor;
+	/**
+	* フォーラムアクセサを取得
+	*/
+	get forum(): ForumAccessor;
+	/**
+	* メンバーアクセサを取得
+	*/
+	get member(): MemberAccessor;
+	/**
+	* サイトのベースURLを取得
+	*/
+	getBaseUrl(): string;
+	/**
+	* サイトへのAMCリクエストを実行
+	* @param bodies - リクエストボディ配列
+	* @returns AMCレスポンス配列
+	*/
+	amcRequest(bodies: AMCRequestBody[]): WikidotResultAsync<AMCResponse[]>;
+	/**
+	* 単一のAMCリクエストを実行
+	* @param body - リクエストボディ
+	* @returns AMCレスポンス
+	*/
+	amcRequestSingle(body: AMCRequestBody): WikidotResultAsync<AMCResponse>;
+	/**
+	* UNIX名からサイトを取得する
+	* @param client - クライアント
+	* @param unixName - サイトのUNIX名（例: 'scp-jp'）
+	* @returns サイト
+	*/
+	static fromUnixName(client: Client, unixName: string): WikidotResultAsync<Site>;
+	toString(): string;
+}
+/**
+* フォーラム操作アクセサ
+*/
+declare class ForumAccessor {
+	readonly site: Site;
+	constructor(site: Site);
+	/**
+	* フォーラムカテゴリ一覧を取得
+	* @returns カテゴリ一覧
+	*/
+	getCategories(): WikidotResultAsync<ForumCategoryCollection>;
+	/**
+	* スレッドを取得
+	* @param threadId - スレッドID
+	* @returns スレッド
+	*/
+	getThread(threadId: number): WikidotResultAsync<ForumThread2>;
+	/**
+	* 複数スレッドを取得
+	* @param threadIds - スレッドID配列
+	* @returns スレッドコレクション
+	*/
+	getThreads(threadIds: number[]): WikidotResultAsync<ForumThreadCollection>;
+}
+/**
+* サイト操作アクセサ
+*/
+declare class SiteAccessor {
+	readonly client: Client;
+	constructor(client: Client);
+	/**
+	* UNIX名からサイトを取得する
+	* @param unixName - サイトのUNIX名（例: 'scp-jp'）
+	* @returns サイトオブジェクト
+	*/
+	get(unixName: string): WikidotResultAsync<Site>;
+}
+/**
+* ユーザー取得オプション
+*/
+interface GetUserOptions {
+	/** ユーザーが見つからない場合にエラーを発生させる（デフォルト: false） */
+	raiseWhenNotFound?: boolean;
+}
+/**
+* ユーザー操作アクセサ
+*/
+declare class UserAccessor {
+	readonly client: Client;
+	constructor(client: Client);
+	/**
+	* ユーザー名からユーザーを取得する
+	* @param name - ユーザー名
+	* @param options - 取得オプション
+	* @returns ユーザー（存在しない場合はnull、raiseWhenNotFoundがtrueの場合はエラー）
+	*/
+	get(name: string, options?: GetUserOptions): WikidotResultAsync<User | null>;
+	/**
+	* 複数ユーザー名からユーザーを取得する
+	* @param names - ユーザー名配列
+	* @param options - 取得オプション
+	* @returns ユーザーコレクション（存在しないユーザーはnull、raiseWhenNotFoundがtrueの場合はエラー）
+	*/
+	getMany(names: string[], options?: GetUserOptions): WikidotResultAsync<UserCollection>;
+}
+/**
+* クライアント作成オプション
+*/
+interface ClientOptions {
+	/** Wikidotユーザー名 */
+	username?: string;
+	/** Wikidotパスワード */
+	password?: string;
+	/** ベースドメイン（デフォルト: wikidot.com） */
+	domain?: string;
+	/** AMC設定オーバーライド */
+	amcConfig?: Partial<AMCConfig>;
+}
+/**
+* Wikidotクライアント
+* ライブラリのメインエントリポイント
+*/
+declare class Client {
+	/** AMCクライアント */
+	readonly amcClient: AMCClient;
+	/** ベースドメイン */
+	readonly domain: string;
+	/** ユーザー操作アクセサ */
+	readonly user: UserAccessor;
+	/** サイト操作アクセサ */
+	readonly site: SiteAccessor;
+	/** プライベートメッセージ操作アクセサ */
+	readonly privateMessage: PrivateMessageAccessor;
+	/** ログイン中のユーザー名 */
+	private _username;
+	/** ログイン中のユーザー */
+	private _me;
+	/**
+	* プライベートコンストラクタ
+	* createメソッドを使用してインスタンスを作成する
+	*/
+	private constructor();
+	/**
+	* ログイン中のユーザー名を取得
+	*/
+	get username(): string | null;
+	/**
+	* ログイン中のユーザーを取得
+	* ログインしていない場合はnull
+	*/
+	get me(): User | null;
+	/**
+	* クライアントを作成する
+	* @param options - クライアントオプション
+	* @returns クライアントインスタンス
+	*/
+	static create(options?: ClientOptions): WikidotResultAsync<Client>;
+	/**
+	* 未認証クライアントを作成する
+	* @param options - クライアントオプション（認証情報以外）
+	* @returns クライアントインスタンス
+	*/
+	static createAnonymous(options?: Omit<ClientOptions, "username" | "password">): Client;
+	/**
+	* ログイン状態を確認する
+	* @returns ログイン済みならtrue
+	*/
+	isLoggedIn(): boolean;
+	/**
+	* ログインを要求する
+	* ログイン済みでない場合はLoginRequiredErrorを返す
+	* @returns 成功時はvoid
+	*/
+	requireLogin(): WikidotResult<void>;
+	/**
+	* クライアントをクローズする
+	* セッションがある場合はログアウトを試みる
+	*/
+	close(): WikidotResultAsync<void>;
+}
+/**
+* プライベートメッセージ操作アクセサ
+*/
+declare class PrivateMessageAccessor {
+	readonly client: Client;
+	constructor(client: Client);
+	/**
+	* メッセージIDからメッセージを取得する
+	* @param id - メッセージID
+	* @returns メッセージオブジェクト
+	*/
+	get(id: number): WikidotResultAsync<PrivateMessage>;
+	/**
+	* 複数のメッセージIDからメッセージを取得する
+	* @param ids - メッセージID配列
+	* @returns メッセージコレクション
+	*/
+	getMessages(ids: number[]): WikidotResultAsync<PrivateMessageCollection>;
+	/**
+	* 受信箱のメッセージ一覧を取得する
+	* @returns 受信箱
+	*/
+	inbox(): WikidotResultAsync<PrivateMessageInbox>;
+	/**
+	* 送信箱のメッセージ一覧を取得する
+	* @returns 送信箱
+	*/
+	sentBox(): WikidotResultAsync<PrivateMessageSentBox>;
+	/**
+	* プライベートメッセージを送信する
+	* @param recipient - 受信者
+	* @param subject - 件名
+	* @param body - 本文
+	*/
+	send(recipient: User, subject: string, body: string): WikidotResultAsync<void>;
+}
+import * as cheerio2 from "cheerio";
+import { AnyNode as AnyNode2 } from "domhandler";
+/**
+* printuser要素をパースし、ユーザーオブジェクトを返す
+*
+* @param client - Wikidotクライアント
+* @param elem - パース対象の要素（printuserクラスがついた要素）
+* @returns パースされて得られたユーザーオブジェクト
+*/
+declare function parseUser2(client: ClientRef, elem: cheerio2.Cheerio<AnyNode2>): AbstractUser;
+/**
+* odate要素から日時をパースする
+*
+* @param elem - パース対象の要素（odate要素）
+* @returns パースされたDate、パース失敗時はnull
+*/
+declare function parseOdate(elem: cheerio2.Cheerio<AnyNode2>): Date | null;
+export { wdOkAsync, wdOk, wdErrAsync, wdErr, userLookup, setupConsoleHandler, parseUser2 as parseUser, parseOdate, pageLookup, nullHandler, memberLookup, maskSensitiveData, logout, login, logger, isSuccessResponse, getLogger, fromPromise, consoleHandler, combineResults, amcResponseSchema, WikidotUser, WikidotStatusError, WikidotResultAsync, WikidotResult, WikidotError, UserType, UserIdentifier, UserData, UserCollection, UserAccessor, User, UnexpectedError, TargetExistsError, TargetError, SiteUnixName, SiteRef, SiteMemberData, SiteMember, SiteData, SiteChangeData, SiteChangeCollection, SiteChange, SiteApplicationData, SiteApplication, SiteAccessor, Site, SessionError, SessionCreateError, SearchPagesQueryParams, SearchPagesQuery, ResponseDataError, QuickModuleName, QuickModule, QMCUser, QMCPage, PrivateMessageSentBox, PrivateMessageInbox, PrivateMessageData, PrivateMessageCollection, PrivateMessageAccessor, PrivateMessage, PagesAccessor, PageVoteData, PageVoteCollection, PageVote, PageSourceData, PageSource, PageRevisionData, PageRevisionCollection, PageRevision, PageRef, PageMetaData, PageMetaCollection, PageMeta, PageFullname, PageFileData, PageFileCollection, PageFile, PageData, PageCollection, PageAccessor, Page, NotFoundException, NoElementError, MemberAccessor, LoginRequiredError, Logger, LogLevel, LogHandler, GuestUser, GetUserOptions, ForumThreadRef, ForumThreadData, ForumThreadCollection, ForumThread2 as ForumThread, ForumPostData, ForumPostCollection, ForumPost, ForumCategoryRef, ForumCategoryData, ForumCategoryCollection, ForumCategory, ForumAccessor, ForbiddenError, DeletedUser, DateTimeString, DEFAULT_PER_PAGE, DEFAULT_MODULE_BODY, DEFAULT_AMC_CONFIG, ClientRef, ClientOptions, Client, AuthClientContext, AnonymousUser, AbstractUser, AMCSuccessResponse, AMCResponse, AMCRequestOptions, AMCRequestBody, AMCHttpError, AMCHeaderRef, AMCHeader, AMCError, AMCConfig, AMCClientRef, AMCClient };