@ukwhatn/wikidot 1.0.10 → 4.0.3

package/README.md

@@ -1,85 +1,249 @@
-# wikidot-ts - A TypeScript library for making requests to the Wikidot sites.
+# wikidot-ts
+
+TypeScriptでWikidotサイトと対話するための非同期ユーティリティライブラリ。
+
+## 概要
+
+wikidot-tsは、Wikidot APIを操作するためのTypeScriptライブラリです。ページの取得・編集、フォーラム操作、プライベートメッセージ、ユーザー情報の取得など、Wikidotの主要機能をサポートしています。
+
+## 特徴
+
+- 型安全なAPI（TypeScript完全対応）
+- Result型によるエラーハンドリング（neverthrow使用）
+- 非同期処理の完全サポート
+- ページ、フォーラム、プライベートメッセージなど主要機能をカバー
+- wikidot.pyとの高い互換性
+
+## インストール
+
+```bash
+bun add @ukwhatn/wikidot
+```
+
+または
 
-## Installation
 ```bash
 npm install @ukwhatn/wikidot
 ```
 
-## Usage
-> [!NOTE]
-> You can use this library without logging in, but you can only use the features that do not require logging in.
-```ts
-import {Client} from "@ukwhatn/wikidot";
-
-// Create a new Client class and logging in with the credentials of your wikidot account
-// If you don't want to log in:
-//   const client = await Client.init();
-const client = await Client.init('input-your-name', 'input-your-password');
-
-// ------
-// user features
-// ------
-// Get the user object of the user
-const user = await client.user.get('input-a-username');
-// Bulk execution by asynchronous request
-const users = await client.user.getBulk(['input-a-username', 'input-another-username']);
-
-// ------
-// site features
-// ------
-// Get the site object of the SCP Foundation
-const site = await client.site.get('scp-wiki');
-
-// invite a user to the site
-await site.inviteUser(user)
-
-// Get all unprocessed applications for the site
-const applications = await site.getApplications()
-
-// process an application
-for (const application of applications) {
-    application.accept()
-    // or 
-    application.reject()
+## 基本的な使い方
+
+このライブラリは`neverthrow`のResult型を使用します。すべての非同期メソッドは`WikidotResultAsync<T>`を返し、`isOk()`で成功を確認後、`.value`で値を取得します。
+
+### クライアントの作成
+
+```typescript
+import { Client } from '@ukwhatn/wikidot';
+
+// ログインなしでアクセス（公開情報のみ）
+const clientResult = await Client.create();
+if (!clientResult.isOk()) {
+  throw new Error('クライアントの作成に失敗しました');
+}
+const client = clientResult.value;
+
+// ログインしてアクセス
+const authClientResult = await Client.create({
+  username: 'your_username',
+  password: 'your_password',
+});
+if (!authClientResult.isOk()) {
+  throw new Error('ログインに失敗しました');
+}
+const authClient = authClientResult.value;
+```
+
+### サイトの取得
+
+```typescript
+// サイトを取得
+const siteResult = await client.site.get('scp-jp');
+if (!siteResult.isOk()) {
+  throw new Error('サイトの取得に失敗しました');
 }
+const site = siteResult.value;
+console.log(`サイト: ${site.title}`);
+```
+
+### ページの操作
+
+```typescript
+// ページを検索
+const pagesResult = await site.pages.search({ category: 'scp', tags: ['safe'] });
+if (!pagesResult.isOk()) {
+  throw new Error('ページの検索に失敗しました');
+}
+for (const page of pagesResult.value) {
+  console.log(`${page.fullname}: ${page.title}`);
+}
+
+// 単一ページを取得
+const pageResult = await site.page.get('scp-001');
+if (!pageResult.isOk()) {
+  throw new Error('ページの取得に失敗しました');
+}
+const page = pageResult.value;
+console.log(`タイトル: ${page.title}`);
+console.log(`レーティング: ${page.rating}`);
+```
+
+### フォーラムの操作
+
+```typescript
+// フォーラムカテゴリを取得
+const categoriesResult = await site.forum.getCategories();
+if (!categoriesResult.isOk()) {
+  throw new Error('フォーラムカテゴリの取得に失敗しました');
+}
+for (const category of categoriesResult.value) {
+  console.log(`カテゴリ: ${category.title}`);
+}
+
+// スレッドに返信（要ログイン）
+const threadResult = await site.forum.getThread(12345);
+if (!threadResult.isOk()) {
+  throw new Error('スレッドの取得に失敗しました');
+}
+const thread = threadResult.value;
+await thread.reply('返信内容', 'Re: タイトル');
+```
+
+### プライベートメッセージ（要ログイン）
+
+```typescript
+// 受信箱を取得
+const inboxResult = await client.privateMessage.inbox();
+if (!inboxResult.isOk()) {
+  throw new Error('受信箱の取得に失敗しました');
+}
+for (const message of inboxResult.value) {
+  console.log(`From: ${message.sender.name}, Subject: ${message.subject}`);
+}
+
+// メッセージを送信
+await client.privateMessage.send(recipientUser, '件名', '本文');
+
+// メッセージを検索
+const searchResult = await client.privateMessage.search('検索クエリ', 'all');
+```
+
+## エラーハンドリング
+
+wikidot-tsは`neverthrow`ライブラリを使用したResult型でエラーを処理します。
+
+```typescript
+const result = await site.page.get('non-existent-page');
+
+if (result.isOk()) {
+  const page = result.value;
+  // 成功時の処理
+} else {
+  const error = result.error;
+  if (error instanceof NotFoundException) {
+    console.log('ページが見つかりません');
+  } else if (error instanceof ForbiddenError) {
+    console.log('アクセス権限がありません');
+  }
+}
+```
+
+## 主要なエラー型
+
+| エラー | 説明 |
+|--------|------|
+| `LoginRequiredError` | ログインが必要な操作 |
+| `NotFoundException` | リソースが見つからない |
+| `ForbiddenError` | アクセス権限がない |
+| `TargetExistsError` | リソースが既に存在する |
+| `WikidotStatusError` | Wikidot APIエラー |
+
+## wikidot.pyとの差異
+
+wikidot-tsはwikidot.pyからの移植ですが、TypeScriptの慣習に合わせていくつかの違いがあります。
+
+### プロパティ → メソッド変換
+
+Pythonの`@property`デコレータを使用したプロパティは、TypeScriptではgetterメソッドとして実装されています。
+
+| Python (wikidot.py) | TypeScript (wikidot-ts) |
+|---------------------|------------------------|
+| `site.base_url` | `site.getBaseUrl()` |
+| `page.url` | `page.getUrl()` |
+| `user.avatar_url` | `user.avatarUrl` (読み取り専用プロパティ) |
+
+### 命名規則
+
+- スネークケース → キャメルケース
+  - `page.fullname` (変更なし)
+  - `page.children_count` → `page.childrenCount`
+  - `page.created_by` → `page.createdBy`
+
+### エラーハンドリング
+
+- Python: 例外をスロー
+- TypeScript: `Result`型を返却（`neverthrow`使用）
+
+```python
+# Python
+try:
+    page = await site.get_page("scp-001")
+except NotFoundException:
+    print("Page not found")
+```
+
+```typescript
+// TypeScript
+const result = await site.page.get("scp-001");
+if (result.isErr()) {
+  if (result.error instanceof NotFoundException) {
+    console.log("Page not found");
+  }
+}
+```
+
+### オプション引数
+
+一部のメソッドでは、Python版と同様のオプション引数をサポートしています。
+
+```typescript
+// raiseWhenNotFound オプション
+const user = await client.user.get("username", { raiseWhenNotFound: true });
+
+// returnExceptions オプション（AMCClient）
+const results = await client.amcClient.requestWithOptions(bodies, { returnExceptions: true });
+```
+
+## 開発
+
+### セットアップ
+
+```bash
+bun install
+```
+
+### コマンド
+
+```bash
+# 型チェック
+bun run typecheck
+
+# Lint
+bun run lint
+
+# フォーマット
+bun run format
+
+# テスト
+bun test
+
+# ビルド
+bun run build
+```
+
+## ライセンス
+
+MIT
+
+## 関連プロジェクト
 
-// ------
-// page features
-// ------
-// Search pages by some criteria
-// NOTE: The search criteria are the same as in the ListPages module
-pages = await site.pages.search({
-    category: "_default",
-    tags: ["tag1", "tag2"],  // You can also use the "tag1 -tag2" syntax
-    order: "created_at desc desc",
-    limit: 10,
-})
-
-// Get the page object of the SCP-001
-const page = await site.page.get('scp-001')
-
-// destroy a page
-await page.destroy()
-
-// ------
-// private message features
-// ------
-// Get messages in your inbox
-const receivedMessages = await client.privateMessage.getInbox()
-
-// Get messages in your sent box
-const sentMessages = await client.privateMessage.getSentbox()
-
-// Get message by id
-// NOTE: You can only get the message that you have received or sent
-message = client.privateMessage.getMessage(123456)
-// Bulk execution by asynchronous request
-messages = client.privateMessage.getMessages([123456, 123457])
-
-// Send a message to a user
-await client.privateMessage.send(
-    recipient = user,
-    subject = 'Hello',
-    body = 'Hello, world!'
-)
-```
+- [wikidot.py](https://github.com/ukwhatn/wikidot.py) - Python版のWikidotライブラリ

package/dist/errors.cjs

@@ -0,0 +1,114 @@
+var import_node_module = require("node:module");
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// src/errors.ts
+var exports_errors = {};
+__export(exports_errors, {
+  WikidotStatusError: () => WikidotStatusError,
+  WikidotError: () => WikidotError,
+  UnexpectedError: () => UnexpectedError,
+  TargetExistsError: () => TargetExistsError,
+  TargetError: () => TargetError,
+  SessionError: () => SessionError,
+  SessionCreateError: () => SessionCreateError,
+  ResponseDataError: () => ResponseDataError,
+  NotFoundException: () => NotFoundException,
+  NoElementError: () => NoElementError,
+  LoginRequiredError: () => LoginRequiredError,
+  ForbiddenError: () => ForbiddenError,
+  AMCHttpError: () => AMCHttpError,
+  AMCError: () => AMCError
+});
+module.exports = __toCommonJS(exports_errors);
+
+// src/common/errors/base.ts
+class WikidotError extends Error {
+  name;
+  constructor(message) {
+    super(message);
+    this.name = this.constructor.name;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+}
+
+class UnexpectedError extends WikidotError {
+}
+
+// src/common/errors/amc.ts
+class AMCError extends WikidotError {
+}
+
+class AMCHttpError extends AMCError {
+  statusCode;
+  constructor(message, statusCode) {
+    super(message);
+    this.statusCode = statusCode;
+  }
+}
+
+class WikidotStatusError extends AMCError {
+  statusCode;
+  constructor(message, statusCode) {
+    super(message);
+    this.statusCode = statusCode;
+  }
+}
+
+class ResponseDataError extends AMCError {
+}
+// src/common/errors/session.ts
+class SessionError extends WikidotError {
+}
+
+class SessionCreateError extends SessionError {
+}
+
+class LoginRequiredError extends SessionError {
+  constructor(message = "Login is required for this operation") {
+    super(message);
+  }
+}
+// src/common/errors/target.ts
+class NotFoundException extends WikidotError {
+}
+
+class TargetExistsError extends WikidotError {
+}
+
+class TargetError extends WikidotError {
+}
+
+class ForbiddenError extends WikidotError {
+}
+
+class NoElementError extends WikidotError {
+}
+
+//# debugId=34CEA15B1F492E1F64756E2164756E21
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsic3JjL2NvbW1vbi9lcnJvcnMvYmFzZS50cyIsICJzcmMvY29tbW9uL2Vycm9ycy9hbWMudHMiLCAic3JjL2NvbW1vbi9lcnJvcnMvc2Vzc2lvbi50cyIsICJzcmMvY29tbW9uL2Vycm9ycy90YXJnZXQudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbCiAgICAiLyoqXG4gKiBXaWtpZG9044Op44Kk44OW44Op44Oq44Gu5Z+65bqV44Ko44Op44O844Kv44Op44K5XG4gKiDlhajjgabjga7jgqvjgrnjgr/jg6Djgqjjg6njg7zjga/jgZPjga7jgq/jg6njgrnjgpLntpnmib/jgZnjgotcbiAqL1xuZXhwb3J0IGFic3RyYWN0IGNsYXNzIFdpa2lkb3RFcnJvciBleHRlbmRzIEVycm9yIHtcbiAgLyoqIOOCqOODqeODvOWQjSAqL1xuICBwdWJsaWMgb3ZlcnJpZGUgcmVhZG9ubHkgbmFtZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBAcGFyYW0gbWVzc2FnZSAtIOOCqOODqeODvOODoeODg+OCu+ODvOOCuFxuICAgKi9cbiAgY29uc3RydWN0b3IobWVzc2FnZTogc3RyaW5nKSB7XG4gICAgc3VwZXIobWVzc2FnZSk7XG4gICAgdGhpcy5uYW1lID0gdGhpcy5jb25zdHJ1Y3Rvci5uYW1lO1xuICAgIE9iamVjdC5zZXRQcm90b3R5cGVPZih0aGlzLCBuZXcudGFyZ2V0LnByb3RvdHlwZSk7XG4gIH1cbn1cblxuLyoqXG4gKiDkuojmnJ/jgZvjgazjgqjjg6njg7xcbiAqIOWGhemDqOeahOOBquS4jeaVtOWQiOOChOODkOOCsOOCkuihqOOBmVxuICovXG5leHBvcnQgY2xhc3MgVW5leHBlY3RlZEVycm9yIGV4dGVuZHMgV2lraWRvdEVycm9yIHt9XG4iLAogICAgImltcG9ydCB7IFdpa2lkb3RFcnJvciB9IGZyb20gJy4vYmFzZSc7XG5cbi8qKlxuICogQWpheCBNb2R1bGUgQ29ubmVjdG9y6Zai6YCj44Gu5Z+65bqV44Ko44Op44O8XG4gKi9cbmV4cG9ydCBjbGFzcyBBTUNFcnJvciBleHRlbmRzIFdpa2lkb3RFcnJvciB7fVxuXG4vKipcbiAqIEhUVFDjgrnjg4bjg7zjgr/jgrnjgrPjg7zjg4njgqjjg6njg7xcbiAqIEFNQ+OBuOOBruODquOCr+OCqOOCueODiOOBjEhUVFDjgqjjg6njg7zjgaflpLHmlZfjgZfjgZ/loLTlkIhcbiAqL1xuZXhwb3J0IGNsYXNzIEFNQ0h0dHBFcnJvciBleHRlbmRzIEFNQ0Vycm9yIHtcbiAgLyoqIEhUVFDjgrnjg4bjg7zjgr/jgrnjgrPjg7zjg4kgKi9cbiAgcHVibGljIHJlYWRvbmx5IHN0YXR1c0NvZGU6IG51bWJlcjtcblxuICAvKipcbiAgICogQHBhcmFtIG1lc3NhZ2UgLSDjgqjjg6njg7zjg6Hjg4Pjgrvjg7zjgrhcbiAgICogQHBhcmFtIHN0YXR1c0NvZGUgLSBIVFRQ44K544OG44O844K/44K544Kz44O844OJXG4gICAqL1xuICBjb25zdHJ1Y3RvcihtZXNzYWdlOiBzdHJpbmcsIHN0YXR1c0NvZGU6IG51bWJlcikge1xuICAgIHN1cGVyKG1lc3NhZ2UpO1xuICAgIHRoaXMuc3RhdHVzQ29kZSA9IHN0YXR1c0NvZGU7XG4gIH1cbn1cblxuLyoqXG4gKiBXaWtpZG9044K544OG44O844K/44K544Kz44O844OJ44Ko44Op44O8XG4gKiBBTUPjg6zjgrnjg53jg7Pjgrnjga5zdGF0dXPjgYxva+OBp+OBquOBhOWgtOWQiFxuICovXG5leHBvcnQgY2xhc3MgV2lraWRvdFN0YXR1c0Vycm9yIGV4dGVuZHMgQU1DRXJyb3Ige1xuICAvKiogV2lraWRvdOOCueODhuODvOOCv+OCueOCs+ODvOODieaWh+Wtl+WIlyAqL1xuICBwdWJsaWMgcmVhZG9ubHkgc3RhdHVzQ29kZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBAcGFyYW0gbWVzc2FnZSAtIOOCqOODqeODvOODoeODg+OCu+ODvOOCuFxuICAgKiBAcGFyYW0gc3RhdHVzQ29kZSAtIOOCueODhuODvOOCv+OCueOCs+ODvOODie+8iOS+izogJ25vdF9vaycsICd0cnlfYWdhaW4n77yJXG4gICAqL1xuICBjb25zdHJ1Y3RvcihtZXNzYWdlOiBzdHJpbmcsIHN0YXR1c0NvZGU6IHN0cmluZykge1xuICAgIHN1cGVyKG1lc3NhZ2UpO1xuICAgIHRoaXMuc3RhdHVzQ29kZSA9IHN0YXR1c0NvZGU7XG4gIH1cbn1cblxuLyoqXG4gKiDjg6zjgrnjg53jg7Pjgrnjg4fjg7zjgr/jgqjjg6njg7xcbiAqIOODrOOCueODneODs+OCueOBruODkeODvOOCueOBq+WkseaVl+OBl+OBn+WgtOWQiFxuICovXG5leHBvcnQgY2xhc3MgUmVzcG9uc2VEYXRhRXJyb3IgZXh0ZW5kcyBBTUNFcnJvciB7fVxuIiwKICAgICJpbXBvcnQgeyBXaWtpZG90RXJyb3IgfSBmcm9tICcuL2Jhc2UnO1xuXG4vKipcbiAqIOOCu+ODg+OCt+ODp+ODs+mWoumAo+OBruWfuuW6leOCqOODqeODvFxuICovXG5leHBvcnQgY2xhc3MgU2Vzc2lvbkVycm9yIGV4dGVuZHMgV2lraWRvdEVycm9yIHt9XG5cbi8qKlxuICog44K744OD44K344On44Oz5L2c5oiQ5aSx5pWX44Ko44Op44O8XG4gKiDjg63jgrDjgqTjg7PoqabooYzjgYzlpLHmlZfjgZfjgZ/loLTlkIjjgavjgrnjg63jg7xcbiAqL1xuZXhwb3J0IGNsYXNzIFNlc3Npb25DcmVhdGVFcnJvciBleHRlbmRzIFNlc3Npb25FcnJvciB7fVxuXG4vKipcbiAqIOODreOCsOOCpOODs+W/hemgiOOCqOODqeODvFxuICog6KqN6Ki844GM5b+F6KaB44Gq5pON5L2c44KS5pyq44Ot44Kw44Kk44Oz54q25oWL44Gn5a6f6KGM44GX44Gf5aC05ZCI44Gr44K544Ot44O8XG4gKi9cbmV4cG9ydCBjbGFzcyBMb2dpblJlcXVpcmVkRXJyb3IgZXh0ZW5kcyBTZXNzaW9uRXJyb3Ige1xuICBjb25zdHJ1Y3RvcihtZXNzYWdlID0gJ0xvZ2luIGlzIHJlcXVpcmVkIGZvciB0aGlzIG9wZXJhdGlvbicpIHtcbiAgICBzdXBlcihtZXNzYWdlKTtcbiAgfVxufVxuIiwKICAgICJpbXBvcnQgeyBXaWtpZG90RXJyb3IgfSBmcm9tICcuL2Jhc2UnO1xuXG4vKipcbiAqIOODquOCveODvOOCueacqueZuuimi+OCqOODqeODvFxuICog6KaB5rGC44GV44KM44Gf44Oq44K944O844K544GM5a2Y5Zyo44GX44Gq44GE5aC05ZCIXG4gKi9cbmV4cG9ydCBjbGFzcyBOb3RGb3VuZEV4Y2VwdGlvbiBleHRlbmRzIFdpa2lkb3RFcnJvciB7fVxuXG4vKipcbiAqIOODquOCveODvOOCueaXouWtmOOCqOODqeODvFxuICog5L2c5oiQ44GX44KI44GG44Go44GX44Gf44Oq44K944O844K544GM5pei44Gr5a2Y5Zyo44GZ44KL5aC05ZCIXG4gKi9cbmV4cG9ydCBjbGFzcyBUYXJnZXRFeGlzdHNFcnJvciBleHRlbmRzIFdpa2lkb3RFcnJvciB7fVxuXG4vKipcbiAqIOOCv+ODvOOCsuODg+ODiOeKtuaFi+OCqOODqeODvFxuICog44Oq44K944O844K544GM5pON5L2c5LiN5Y+v6IO944Gq54q25oWL44Gu5aC05ZCI77yI44Ot44OD44Kv5Lit44Gq44Gp77yJXG4gKi9cbmV4cG9ydCBjbGFzcyBUYXJnZXRFcnJvciBleHRlbmRzIFdpa2lkb3RFcnJvciB7fVxuXG4vKipcbiAqIOOCouOCr+OCu+OCueaLkuWQpuOCqOODqeODvFxuICog5qip6ZmQ5LiN6Laz44Gn5pON5L2c44GM5ouS5ZCm44GV44KM44Gf5aC05ZCIXG4gKi9cbmV4cG9ydCBjbGFzcyBGb3JiaWRkZW5FcnJvciBleHRlbmRzIFdpa2lkb3RFcnJvciB7fVxuXG4vKipcbiAqIEhUTUzopoHntKDmnKrnmbropovjgqjjg6njg7xcbiAqIOODkeODvOOCueS4reOBq+W/heimgeOBquimgee0oOOBjOimi+OBpOOBi+OCieOBquOBhOWgtOWQiFxuICovXG5leHBvcnQgY2xhc3MgTm9FbGVtZW50RXJyb3IgZXh0ZW5kcyBXaWtpZG90RXJyb3Ige31cbiIKICBdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBSU8sTUFBZSxxQkFBcUIsTUFBTTtBQUFBLEVBRXRCO0FBQUEsRUFLekIsV0FBVyxDQUFDLFNBQWlCO0FBQUEsSUFDM0IsTUFBTSxPQUFPO0FBQUEsSUFDYixLQUFLLE9BQU8sS0FBSyxZQUFZO0FBQUEsSUFDN0IsT0FBTyxlQUFlLE1BQU0sV0FBVyxTQUFTO0FBQUE7QUFFcEQ7QUFBQTtBQU1PLE1BQU0sd0JBQXdCLGFBQWE7QUFBQzs7O0FDakI1QyxNQUFNLGlCQUFpQixhQUFhO0FBQUM7QUFBQTtBQU1yQyxNQUFNLHFCQUFxQixTQUFTO0FBQUEsRUFFekI7QUFBQSxFQU1oQixXQUFXLENBQUMsU0FBaUIsWUFBb0I7QUFBQSxJQUMvQyxNQUFNLE9BQU87QUFBQSxJQUNiLEtBQUssYUFBYTtBQUFBO0FBRXRCO0FBQUE7QUFNTyxNQUFNLDJCQUEyQixTQUFTO0FBQUEsRUFFL0I7QUFBQSxFQU1oQixXQUFXLENBQUMsU0FBaUIsWUFBb0I7QUFBQSxJQUMvQyxNQUFNLE9BQU87QUFBQSxJQUNiLEtBQUssYUFBYTtBQUFBO0FBRXRCO0FBQUE7QUFNTyxNQUFNLDBCQUEwQixTQUFTO0FBQUM7O0FDMUMxQyxNQUFNLHFCQUFxQixhQUFhO0FBQUM7QUFBQTtBQU16QyxNQUFNLDJCQUEyQixhQUFhO0FBQUM7QUFBQTtBQU0vQyxNQUFNLDJCQUEyQixhQUFhO0FBQUEsRUFDbkQsV0FBVyxDQUFDLFVBQVUsd0NBQXdDO0FBQUEsSUFDNUQsTUFBTSxPQUFPO0FBQUE7QUFFakI7O0FDZk8sTUFBTSwwQkFBMEIsYUFBYTtBQUFDO0FBQUE7QUFNOUMsTUFBTSwwQkFBMEIsYUFBYTtBQUFDO0FBQUE7QUFNOUMsTUFBTSxvQkFBb0IsYUFBYTtBQUFDO0FBQUE7QUFNeEMsTUFBTSx1QkFBdUIsYUFBYTtBQUFDO0FBQUE7QUFNM0MsTUFBTSx1QkFBdUIsYUFBYTtBQUFDOyIsCiAgImRlYnVnSWQiOiAiMzRDRUExNUIxRjQ5MkUxRjY0NzU2RTIxNjQ3NTZFMjEiLAogICJuYW1lcyI6IFtdCn0=

package/dist/errors.d.cts

@@ -0,0 +1,94 @@
+/**
+* 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 {}
+export { WikidotStatusError, WikidotError, UnexpectedError, TargetExistsError, TargetError, SessionError, SessionCreateError, ResponseDataError, NotFoundException, NoElementError, LoginRequiredError, ForbiddenError, AMCHttpError, AMCError };

package/dist/errors.d.ts

@@ -0,0 +1,94 @@
+/**
+* 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 {}
+export { WikidotStatusError, WikidotError, UnexpectedError, TargetExistsError, TargetError, SessionError, SessionCreateError, ResponseDataError, NotFoundException, NoElementError, LoginRequiredError, ForbiddenError, AMCHttpError, AMCError };