chukyo-sdk 0.1.0

package/dist/esm/shib/parser/shibLogin.js

@@ -0,0 +1,127 @@
+import { getAttribute, loadDocument, queryOne } from "../../common/dom";
+import { ShibCheckTypeSchema, ShibLoginResultSchema, ShibWebauthnAuthSchema, ShibWebauthnRegistrationSchema, } from "../types/shibLogin";
+const isRecord = (value) => typeof value === "object" && value !== null;
+/**
+ * 認証エラー（ID/PW・OTP 誤り等）を示すメッセージ要素のセレクタ。
+ *
+ * ページは英語・日本語どちらでも描画されうるため、表示テキストではなく
+ * 言語非依存な CSS クラス（`c-message _error`）で判定する。実キャプチャ上、
+ * この要素は「認証失敗の POST 応答」でのみ出現し、初期ログインページや
+ * SAML 成功応答には現れない（誤検出しない）ことを確認済み。
+ */
+const AUTH_ERROR_SELECTOR = ".c-message._error";
+// ============================================
+// フロー制御ヘルパ（レスポンス由来。ZodSafeParseResult ではなく素の値を返す）
+// ============================================
+/** URL の `AuthState` クエリを取り出す。 */
+export const extractAuthStateFromUrl = (url) => {
+    try {
+        return new URL(url).searchParams.get("AuthState");
+    }
+    catch {
+        return null;
+    }
+};
+/** HTML の hidden input から `AuthState` を取り出す。 */
+export const extractAuthStateFromHtml = (html) => {
+    const input = queryOne('input[name="AuthState"]', loadDocument(html));
+    return getAttribute(input, "value");
+};
+/**
+ * loginuserpass ページの `AuthState` を解決する（URL クエリ優先、無ければ HTML hidden）。
+ * ログインの各 POST に必須の識別子。
+ */
+export const resolveAuthState = (finalUrl, html) => extractAuthStateFromUrl(finalUrl) ?? extractAuthStateFromHtml(html);
+/**
+ * 3xx 応答の遷移先（Location）を返す。SDK の Transport はヘッダのキーを小文字化する。
+ * リダイレクト追従自体は呼び出し側が行う。
+ */
+export const extractRedirectLocation = (response) => response.headers["location"] ?? null;
+// ============================================
+// パーサ
+// ============================================
+/** `checktype.php` の JSON 応答をパースする。 */
+export const parseShibCheckType = (input) => {
+    let data;
+    try {
+        data = JSON.parse(input);
+    }
+    catch {
+        data = null;
+    }
+    const authType = isRecord(data) && Array.isArray(data["authType"])
+        ? data["authType"].filter((v) => typeof v === "string")
+        : [];
+    const sessioninfo = isRecord(data) ? data["sessioninfo"] : undefined;
+    const authState = isRecord(sessioninfo) && typeof sessioninfo["AuthState"] === "string" ? sessioninfo["AuthState"] : null;
+    return ShibCheckTypeSchema.safeParse({ authType, authState });
+};
+/**
+ * `loginuserpass.php` のログイン結果をパースする。
+ *
+ * 表示テキスト（英語 "confirmation code" / 日本語 "確認コード" 等）に依存せず、
+ * 言語非依存な構造で判定する:
+ * 1. SAMLResponse hidden がある → 認証成立（SAML 自動 POST フォーム）
+ * 2. エラーメッセージ要素（{@link AUTH_ERROR_SELECTOR}）がある → 認証失敗
+ * 3. どちらも無い → 次の要素（OTP）が必要（`otpRequired`）
+ *
+ * ※ ページテンプレートは OTP セクションの markup（"確認コード" / "resend" 等）を
+ *   常に内包するため、テキスト一致では password 画面と OTP 画面を判別できない。
+ *   到達段階の判別は上記の構造シグナルで行う。
+ */
+export const parseShibLoginResult = (html) => {
+    const document = loadDocument(html);
+    const samlInput = queryOne('input[name="SAMLResponse"]', document);
+    if (samlInput) {
+        const form = queryOne("form", document);
+        const relayInput = queryOne('input[name="RelayState"]', document);
+        return ShibLoginResultSchema.safeParse({
+            kind: "samlForm",
+            action: getAttribute(form, "action") ?? "",
+            samlResponse: getAttribute(samlInput, "value") ?? "",
+            relayState: getAttribute(relayInput, "value") ?? "",
+        });
+    }
+    if (queryOne(AUTH_ERROR_SELECTOR, document)) {
+        return ShibLoginResultSchema.safeParse({ kind: "error" });
+    }
+    return ShibLoginResultSchema.safeParse({ kind: "otpRequired" });
+};
+/**
+ * ログインフロー用 `webauthn.php`（start/finish-authentication）の応答をパースする。
+ * `revoked`（HTTP 4xx か status≠0）はパスキー無効化を示す構造として返す（throw しない）。
+ */
+export const parseShibWebauthnAuthentication = (response) => {
+    const httpRevoked = response.status >= 400 && response.status < 500;
+    let data;
+    try {
+        data = JSON.parse(response.body);
+    }
+    catch {
+        data = null;
+    }
+    const status = isRecord(data) && typeof data["status"] === "number" ? data["status"] : null;
+    const params = isRecord(data) ? data["params"] : undefined;
+    const challenge = isRecord(params) && typeof params["challenge"] === "string" ? params["challenge"] : null;
+    const revoked = httpRevoked || (status !== null && status !== 0);
+    const ok = response.status === 200 && status === 0;
+    return ShibWebauthnAuthSchema.safeParse({ ok, revoked, status, challenge });
+};
+/** `User/webauthn`（start-registration）の応答をパースする。 */
+export const parseShibWebauthnRegistration = (input) => {
+    let data;
+    try {
+        data = JSON.parse(input);
+    }
+    catch {
+        data = null;
+    }
+    const params = isRecord(data) ? data["params"] : undefined;
+    return ShibWebauthnRegistrationSchema.safeParse({
+        status: isRecord(data) ? data["status"] : undefined,
+        challenge: isRecord(params) ? params["challenge"] : undefined,
+        user: isRecord(params) ? params["user"] : undefined,
+        rp: isRecord(params) ? params["rp"] : undefined,
+        pubKeyCredParams: isRecord(params) ? params["pubKeyCredParams"] : undefined,
+    });
+};

package/dist/esm/shib/parser/shibUser.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ACE User ポータル（`/User/*`）のページパーサ。
+ * CSRF トークン・procchk・登録済みデバイス一覧を抽出する。
+ */
+import type { ZodSafeParseResult } from "zod";
+import { type ShibCsrfTokenDTO, type ShibFido2DeviceListDTO } from "../types/shibUser";
+/** 任意の ACE User ページから ACEUSER_CSRFTOKEN と procchk を抽出する。 */
+export declare const parseShibCsrfToken: (html: string) => ZodSafeParseResult<ShibCsrfTokenDTO>;
+/** `Fido2DeviceList` の一覧ページをパースする。 */
+export declare const parseShibFido2DeviceList: (html: string) => ZodSafeParseResult<ShibFido2DeviceListDTO>;
+//# sourceMappingURL=shibUser.d.ts.map

package/dist/esm/shib/parser/shibUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shibUser.d.ts","sourceRoot":"","sources":["../../../../src/shib/parser/shibUser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,KAAK,CAAC;AAI9C,OAAO,EAGH,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC9B,MAAM,mBAAmB,CAAC;AAW3B,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,kBAAkB,CAAC,gBAAgB,CAMpF,CAAC;AAEF,sCAAsC;AACtC,eAAO,MAAM,wBAAwB,GAAI,MAAM,MAAM,KAAG,kBAAkB,CAAC,sBAAsB,CA2BhG,CAAC"}

package/dist/esm/shib/parser/shibUser.js

@@ -0,0 +1,46 @@
+import { closest, getAttribute, getTextContent, loadDocument, queryAll, queryOne } from "../../common/dom";
+import { normalizeWhitespace } from "../../common/utils";
+import { ShibCsrfTokenSchema, ShibFido2DeviceListSchema, } from "../types/shibUser";
+/** hidden input（name 指定）の value を返す。要素が無ければ null、value 属性のみ無ければ ""。 */
+const getInputValue = (root, name) => {
+    const input = queryOne(`input[name="${name}"]`, root);
+    if (!input) {
+        return null;
+    }
+    return getAttribute(input, "value") ?? "";
+};
+/** 任意の ACE User ページから ACEUSER_CSRFTOKEN と procchk を抽出する。 */
+export const parseShibCsrfToken = (html) => {
+    const document = loadDocument(html);
+    return ShibCsrfTokenSchema.safeParse({
+        csrfToken: getInputValue(document, "ACEUSER_CSRFTOKEN") ?? "",
+        procchk: getInputValue(document, "procchk"),
+    });
+};
+/** `Fido2DeviceList` の一覧ページをパースする。 */
+export const parseShibFido2DeviceList = (html) => {
+    const document = loadDocument(html);
+    const devices = queryAll("td.c-table_check", document).map((checkCell) => {
+        const credentialId = getAttribute(checkCell, "id") ?? "";
+        const row = closest(checkCell, "tr");
+        const cells = row ? queryAll("td", row) : [];
+        // cells[0] はチェックボックス列。以降が 名前 / 署名カウンタ / 登録日時 / 最終利用日時。
+        const text = (index) => normalizeWhitespace(getTextContent(cells[index] ?? null));
+        const signCountText = text(2);
+        const signCount = signCountText !== "" && /^\d+$/.test(signCountText) ? Number(signCountText) : null;
+        const registeredAt = text(3);
+        const lastUsedAt = text(4);
+        return {
+            credentialId,
+            name: text(1),
+            signCount,
+            registeredAt: registeredAt !== "" ? registeredAt : null,
+            lastUsedAt: lastUsedAt !== "" ? lastUsedAt : null,
+        };
+    });
+    return ShibFido2DeviceListSchema.safeParse({
+        csrfToken: getInputValue(document, "ACEUSER_CSRFTOKEN"),
+        procchk: getInputValue(document, "procchk"),
+        devices,
+    });
+};

package/dist/esm/shib/types/common.d.ts

@@ -0,0 +1,20 @@
+/**
+ * shib（Shibboleth 認証フロー）モジュール共通の型。
+ *
+ * この SDK は認証を「実行」しない。ビルダは各ステップの
+ * リクエスト記述子（{@link ShibRequest}）を返すだけで、実際の HTTP 送信・
+ * Cookie 管理・リダイレクト追従は呼び出し側が行う。
+ */
+import type { TransportRequest, TransportResponse } from "../../types";
+/**
+ * ビルダが返すリクエスト記述子。{@link TransportRequest} と同形で、
+ * そのまま `Transport#request` や任意の HTTP クライアントに渡せる。
+ * `Content-Type` / `Origin` は `headers` に含めて返す。
+ */
+export type ShibRequest = Pick<TransportRequest, "method" | "url" | "headers" | "body">;
+/**
+ * パーサが受け取るレスポンス（`status` / `body` を参照するもの向け）。
+ * ボディ文字列だけを見るパーサは `(input: string)` を取る（fixture テスト harness と互換）。
+ */
+export type ShibResponse = Pick<TransportResponse, "status" | "url" | "body" | "headers">;
+//# sourceMappingURL=common.d.ts.map

package/dist/esm/shib/types/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/shib/types/common.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC;AAExF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC"}

package/dist/esm/shib/types/common.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/shib/types/shibLogin.d.ts

@@ -0,0 +1,62 @@
+/**
+ * ログインフロー（CloudLink IdP）の各レスポンスを構造化する DTO。
+ *
+ * checktype.php → loginuserpass.php（PW / OTP / Passkey）→ webauthn.php の
+ * レスポンスを、後続処理に必要な最小情報へ落とし込む。値はサーバが返すものを通し、
+ * 判断（再認証・ログアウト等）は呼び出し側に委ねる。
+ */
+import { z } from "zod";
+/** `checktype.php` の応答（利用可能な認証方式） */
+export declare const ShibCheckTypeSchema: z.ZodObject<{
+    authType: z.ZodArray<z.ZodString>;
+    authState: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ShibCheckTypeDTO = z.infer<typeof ShibCheckTypeSchema>;
+/**
+ * `loginuserpass.php` のログイン結果。
+ * - `samlForm`: 認証成功。SP ACS への自動 POST フォームを抽出できた（次は SAML ACS へ POST）。
+ * - `otpRequired`: OTP 入力ページが表示された（authtype=2 で再送する）。
+ * - `error`: ID/PW（または OTP）誤り等の認証エラー。
+ */
+export declare const ShibLoginResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"samlForm">;
+    action: z.ZodString;
+    samlResponse: z.ZodString;
+    relayState: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"otpRequired">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"error">;
+}, z.core.$strip>], "kind">;
+export type ShibLoginResultDTO = z.infer<typeof ShibLoginResultSchema>;
+/**
+ * ログインフロー用 `webauthn.php`（start/finish-authentication）の応答。
+ * `revoked`（HTTP 4xx か status≠0）はパスキー無効化を示す構造として返す。SDK は自動処理しない。
+ */
+export declare const ShibWebauthnAuthSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    revoked: z.ZodBoolean;
+    status: z.ZodNullable<z.ZodNumber>;
+    challenge: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ShibWebauthnAuthDTO = z.infer<typeof ShibWebauthnAuthSchema>;
+/** `User/webauthn`（start-registration）の応答。登録に必要な challenge / user を抽出する。 */
+export declare const ShibWebauthnRegistrationSchema: z.ZodObject<{
+    status: z.ZodNumber;
+    challenge: z.ZodString;
+    user: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        displayName: z.ZodString;
+    }, z.core.$strip>;
+    rp: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    pubKeyCredParams: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        alg: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ShibWebauthnRegistrationDTO = z.infer<typeof ShibWebauthnRegistrationSchema>;
+//# sourceMappingURL=shibLogin.d.ts.map

package/dist/esm/shib/types/shibLogin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shibLogin.d.ts","sourceRoot":"","sources":["../../../../src/shib/types/shibLogin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qCAAqC;AACrC,eAAO,MAAM,mBAAmB;;;iBAQ9B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEnE;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;2BAoBhC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;iBAYjC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEzE,4EAA4E;AAC5E,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;iBAyBzC,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}

package/dist/esm/shib/types/shibLogin.js

@@ -0,0 +1,89 @@
+/**
+ * ログインフロー（CloudLink IdP）の各レスポンスを構造化する DTO。
+ *
+ * checktype.php → loginuserpass.php（PW / OTP / Passkey）→ webauthn.php の
+ * レスポンスを、後続処理に必要な最小情報へ落とし込む。値はサーバが返すものを通し、
+ * 判断（再認証・ログアウト等）は呼び出し側に委ねる。
+ */
+import { z } from "zod";
+/** `checktype.php` の応答（利用可能な認証方式） */
+export const ShibCheckTypeSchema = z.object({
+    /** 利用可能な認証方式（"Password" / "OTP" / "Passkey" 等） @example ["Password","OTP"] */
+    authType: z.array(z.string()).meta({ description: "利用可能な認証方式", example: ["Password", "OTP"] }),
+    /** 応答に含まれる sessioninfo.AuthState（無ければ null） @example "_dummyauthstate:https://shib.chukyo-u.ac.jp/..." */
+    authState: z
+        .string()
+        .nullable()
+        .meta({ description: "sessioninfo.AuthState", example: "_dummyauthstate:https://shib.chukyo-u.ac.jp/..." }),
+});
+/**
+ * `loginuserpass.php` のログイン結果。
+ * - `samlForm`: 認証成功。SP ACS への自動 POST フォームを抽出できた（次は SAML ACS へ POST）。
+ * - `otpRequired`: OTP 入力ページが表示された（authtype=2 で再送する）。
+ * - `error`: ID/PW（または OTP）誤り等の認証エラー。
+ */
+export const ShibLoginResultSchema = z.discriminatedUnion("kind", [
+    z.object({
+        kind: z.literal("samlForm"),
+        /** SAML 自動 POST の action URL @example "https://shib.chukyo-u.ac.jp/clsp/saml/acs?client_name=idp1" */
+        action: z
+            .string()
+            .meta({ description: "SAML 自動 POST の action", example: "https://shib.chukyo-u.ac.jp/clsp/saml/acs?client_name=idp1" }),
+        /** Base64 の SAMLResponse @example "PHNhbWxwOlJlc3BvbnNlPi4uLg==" */
+        samlResponse: z.string().meta({ description: "Base64 の SAMLResponse", example: "PHNhbWxwOlJlc3BvbnNlPi4uLg==" }),
+        /** RelayState @example "https://shib.chukyo-u.ac.jp/clsp/saml/acs?client_name=idp1" */
+        relayState: z
+            .string()
+            .meta({ description: "RelayState", example: "https://shib.chukyo-u.ac.jp/clsp/saml/acs?client_name=idp1" }),
+    }),
+    z.object({
+        kind: z.literal("otpRequired"),
+    }),
+    z.object({
+        kind: z.literal("error"),
+    }),
+]);
+/**
+ * ログインフロー用 `webauthn.php`（start/finish-authentication）の応答。
+ * `revoked`（HTTP 4xx か status≠0）はパスキー無効化を示す構造として返す。SDK は自動処理しない。
+ */
+export const ShibWebauthnAuthSchema = z.object({
+    /** 正常応答か（HTTP 200 かつ status===0） @example true */
+    ok: z.boolean().meta({ description: "正常応答か", example: true }),
+    /** パスキー無効化を示すか（HTTP 4xx か status≠0） @example false */
+    revoked: z.boolean().meta({ description: "パスキー無効化を示すか", example: false }),
+    /** 応答の status フィールド（4xx でボディ無しの場合 null） @example 0 */
+    status: z.number().nullable().meta({ description: "status フィールド", example: 0 }),
+    /** 署名用チャレンジ（base64url、取得できなければ null） @example "X95CVnQJfLd9DwcjBkaDZelkEH0Dthn7e2-iV_5aah0" */
+    challenge: z
+        .string()
+        .nullable()
+        .meta({ description: "署名用チャレンジ", example: "X95CVnQJfLd9DwcjBkaDZelkEH0Dthn7e2-iV_5aah0" }),
+});
+/** `User/webauthn`（start-registration）の応答。登録に必要な challenge / user を抽出する。 */
+export const ShibWebauthnRegistrationSchema = z.object({
+    /** status フィールド（0 で正常） @example 0 */
+    status: z.number().meta({ description: "status フィールド", example: 0 }),
+    /** 生成用チャレンジ（base64url） @example "1SZVUGityQOpj8TzCWc0KmAKpOGM7QfcJ8llEsIDH4k" */
+    challenge: z.string().meta({ description: "生成用チャレンジ", example: "1SZVUGityQOpj8TzCWc0KmAKpOGM7QfcJ8llEsIDH4k" }),
+    /** サーバが割り当てるユーザ情報 */
+    user: z.object({
+        /** User Handle（base64url） @example "bZ7pOaxNOfQn51w1p4PEDxouFn5R_CA1TLmgGKjutdo" */
+        id: z.string().meta({ description: "User Handle", example: "bZ7pOaxNOfQn51w1p4PEDxouFn5R_CA1TLmgGKjutdo" }),
+        /** ユーザ名（学籍番号） @example "T000000" */
+        name: z.string().meta({ description: "ユーザ名（学籍番号）", example: "T000000" }),
+        /** 表示名 @example "umebo for ios (a3f9k2x1)" */
+        displayName: z.string().meta({ description: "表示名", example: "umebo for ios (a3f9k2x1)" }),
+    }),
+    /** RP 情報 */
+    rp: z.object({
+        /** RP ID @example "shib.chukyo-u.ac.jp" */
+        id: z.string().meta({ description: "RP ID", example: "shib.chukyo-u.ac.jp" }),
+        /** RP 名 @example "Chukyo University FIDO" */
+        name: z.string().meta({ description: "RP 名", example: "Chukyo University FIDO" }),
+    }),
+    /** 許可される公開鍵アルゴリズム @example [{"type":"public-key","alg":-7}] */
+    pubKeyCredParams: z
+        .array(z.object({ type: z.string(), alg: z.number() }))
+        .meta({ description: "許可される公開鍵アルゴリズム", example: [{ type: "public-key", alg: -7 }] }),
+});

package/dist/esm/shib/types/shibUser.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ACE User ポータル（`/User/*`）の各ページを構造化する DTO。
+ *
+ * これらのページは全 POST に CSRF トークン（ACEUSER_CSRFTOKEN）を伴い、
+ * hidden input に次リクエスト用の値（procchk 等）が埋め込まれている。
+ */
+import { z } from "zod";
+/** 任意の ACE User ページから抽出する CSRF トークンと procchk。 */
+export declare const ShibCsrfTokenSchema: z.ZodObject<{
+    csrfToken: z.ZodString;
+    procchk: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ShibCsrfTokenDTO = z.infer<typeof ShibCsrfTokenSchema>;
+/** 登録済み FIDO2 デバイス 1 件。 */
+export declare const ShibFido2DeviceSchema: z.ZodObject<{
+    credentialId: z.ZodString;
+    name: z.ZodString;
+    signCount: z.ZodNullable<z.ZodNumber>;
+    registeredAt: z.ZodNullable<z.ZodString>;
+    lastUsedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ShibFido2DeviceDTO = z.infer<typeof ShibFido2DeviceSchema>;
+/** `Fido2DeviceList` の一覧ページ。 */
+export declare const ShibFido2DeviceListSchema: z.ZodObject<{
+    csrfToken: z.ZodNullable<z.ZodString>;
+    procchk: z.ZodNullable<z.ZodString>;
+    devices: z.ZodArray<z.ZodObject<{
+        credentialId: z.ZodString;
+        name: z.ZodString;
+        signCount: z.ZodNullable<z.ZodNumber>;
+        registeredAt: z.ZodNullable<z.ZodString>;
+        lastUsedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ShibFido2DeviceListDTO = z.infer<typeof ShibFido2DeviceListSchema>;
+//# sourceMappingURL=shibUser.d.ts.map

package/dist/esm/shib/types/shibUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shibUser.d.ts","sourceRoot":"","sources":["../../../../src/shib/types/shibUser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iDAAiD;AACjD,eAAO,MAAM,mBAAmB;;;iBAO9B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEnE,2BAA2B;AAC3B,eAAO,MAAM,qBAAqB;;;;;;iBAWhC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEvE,gCAAgC;AAChC,eAAO,MAAM,yBAAyB;;;;;;;;;;iBAUpC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/esm/shib/types/shibUser.js

@@ -0,0 +1,41 @@
+/**
+ * ACE User ポータル（`/User/*`）の各ページを構造化する DTO。
+ *
+ * これらのページは全 POST に CSRF トークン（ACEUSER_CSRFTOKEN）を伴い、
+ * hidden input に次リクエスト用の値（procchk 等）が埋め込まれている。
+ */
+import { z } from "zod";
+/** 任意の ACE User ページから抽出する CSRF トークンと procchk。 */
+export const ShibCsrfTokenSchema = z.object({
+    /** ACEUSER_CSRFTOKEN の値（次 POST に必須） @example "AAAA-BBBB-CCCC-DDDD-EEEE-FFFF-GGGG-HHHH" */
+    csrfToken: z
+        .string()
+        .meta({ description: "ACEUSER_CSRFTOKEN の値", example: "AAAA-BBBB-CCCC-DDDD-EEEE-FFFF-GGGG-HHHH" }),
+    /** procchk hidden input の値（存在しなければ null、空文字はそのまま） @example "" */
+    procchk: z.string().nullable().meta({ description: "procchk hidden の値", example: "" }),
+});
+/** 登録済み FIDO2 デバイス 1 件。 */
+export const ShibFido2DeviceSchema = z.object({
+    /** Credential ID（削除時の selectedNmId / checkedKeys に使う） @example "Xyjw5D-UU8oFEtpXXz-jY-UET1U" */
+    credentialId: z.string().meta({ description: "Credential ID", example: "Xyjw5D-UU8oFEtpXXz-jY-UET1U" }),
+    /** デバイス表示名 @example "umebo for ios (a3f9k2x1)" */
+    name: z.string().meta({ description: "デバイス表示名", example: "umebo for ios (a3f9k2x1)" }),
+    /** 署名カウンタ（取得できなければ null） @example 0 */
+    signCount: z.number().nullable().meta({ description: "署名カウンタ", example: 0 }),
+    /** 登録日時（表示文字列のまま） @example "2026/07/09 02:03:32 (JST)" */
+    registeredAt: z.string().nullable().meta({ description: "登録日時", example: "2026/07/09 02:03:32 (JST)" }),
+    /** 最終利用日時（表示文字列のまま） @example "2026/07/09 02:03:32 (JST)" */
+    lastUsedAt: z.string().nullable().meta({ description: "最終利用日時", example: "2026/07/09 02:03:32 (JST)" }),
+});
+/** `Fido2DeviceList` の一覧ページ。 */
+export const ShibFido2DeviceListSchema = z.object({
+    /** ページの ACEUSER_CSRFTOKEN（無ければ null） @example "AAAA-BBBB-CCCC-DDDD-EEEE-FFFF-GGGG-HHHH" */
+    csrfToken: z
+        .string()
+        .nullable()
+        .meta({ description: "ACEUSER_CSRFTOKEN", example: "AAAA-BBBB-CCCC-DDDD-EEEE-FFFF-GGGG-HHHH" }),
+    /** procchk hidden の値（削除完了 POST で使う。無ければ null） @example "bsTtqjrVjJgHU2yVadt0hc5qTkTq7RsX" */
+    procchk: z.string().nullable().meta({ description: "procchk hidden の値", example: "bsTtqjrVjJgHU2yVadt0hc5qTkTq7RsX" }),
+    /** 登録済みデバイス一覧 */
+    devices: z.array(ShibFido2DeviceSchema).meta({ description: "登録済みデバイス一覧" }),
+});

package/dist/esm/transports/fetch.d.ts

@@ -0,0 +1,36 @@
+import type { Transport, TransportResponse } from "../types";
+type FetchLike = (input: string, init?: FetchInit) => Promise<FetchResponse>;
+interface FetchInit {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    signal?: AbortSignal;
+    credentials?: "omit" | "same-origin" | "include";
+    redirect?: "follow" | "manual" | "error";
+}
+interface FetchResponse {
+    status: number;
+    url: string;
+    ok: boolean;
+    headers: {
+        forEach(cb: (value: string, key: string) => void): void;
+    };
+    text(): Promise<string>;
+}
+export interface FetchTransportOptions {
+    /** タイムアウト（ms）。既定 10 秒 */
+    timeoutMs?: number;
+    /** 付与する User-Agent（ブラウザでは無視される） */
+    userAgent?: string;
+    /** Cookie 送信ポリシー。既定 "omit"。拡張でブラウザの Cookie を使うなら "include" */
+    credentials?: "omit" | "same-origin" | "include";
+    /**
+     * 異常ステータスをエラーへ変換するフック。Error を返すと throw、
+     * null/undefined を返すとレスポンスをそのまま通す（既定は 503 のみ
+     * {@link ChukyoMaintenanceError} に変換し、他の 4xx/5xx はそのまま通す）。
+     */
+    mapErrorStatus?: (status: number, res: TransportResponse) => Error | null | undefined;
+}
+export declare const fetchTransport: (fetchImpl?: FetchLike, options?: FetchTransportOptions) => Transport;
+export {};
+//# sourceMappingURL=fetch.d.ts.map

package/dist/esm/transports/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/transports/fetch.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAoB,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE/E,KAAK,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAE7E,UAAU,SAAS;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC5C;AAED,UAAU,aAAa;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;KAAE,CAAC;IACrE,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IAClC,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IACjD;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,KAAK,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;CACzF;AAKD,eAAO,MAAM,cAAc,GACvB,YAAW,SAAoD,EAC/D,UAAS,qBAA0B,KACpC,SA0EF,CAAC"}

package/dist/esm/transports/fetch.js

@@ -0,0 +1,80 @@
+/**
+ * WHATWG `fetch` を {@link Transport} に適合させる Adapter。
+ *
+ * - Node: 引数省略で `globalThis.fetch`（Node 18+）
+ * - Expo: `fetch` に `expo/fetch` の `fetch` を渡す
+ * - ブラウザ拡張: `fetchTransport(fetch, { credentials: "include" })` で
+ *   ブラウザの Cookie ジャーを自動送信（SessionProvider 不要）
+ */
+import { ChukyoMaintenanceError, NetworkError, TimeoutError } from "../errors";
+const isAbortError = (error) => error instanceof Error && (error.name === "AbortError" || error.name === "TimeoutError");
+export const fetchTransport = (fetchImpl = globalThis.fetch, options = {}) => {
+    const timeoutMs = options.timeoutMs ?? 10_000;
+    return {
+        async request(req) {
+            const controller = new AbortController();
+            let timedOut = false;
+            const timeoutId = setTimeout(() => {
+                timedOut = true;
+                controller.abort();
+            }, timeoutMs);
+            const onExternalAbort = () => controller.abort();
+            if (req.signal) {
+                if (req.signal.aborted) {
+                    controller.abort();
+                }
+                else {
+                    req.signal.addEventListener("abort", onExternalAbort);
+                }
+            }
+            const headers = { ...req.headers };
+            if (options.userAgent) {
+                headers["User-Agent"] = options.userAgent;
+            }
+            try {
+                const res = await fetchImpl(req.url, {
+                    method: req.method,
+                    headers,
+                    ...(req.body != null ? { body: req.body } : {}),
+                    signal: controller.signal,
+                    credentials: options.credentials ?? "omit",
+                });
+                const responseHeaders = {};
+                res.headers.forEach((value, key) => {
+                    responseHeaders[key.toLowerCase()] = value;
+                });
+                const result = {
+                    status: res.status,
+                    url: res.url || req.url,
+                    body: await res.text(),
+                    headers: responseHeaders,
+                };
+                const mapped = options.mapErrorStatus
+                    ? options.mapErrorStatus(res.status, result)
+                    : res.status === 503
+                        ? new ChukyoMaintenanceError()
+                        : null;
+                if (mapped) {
+                    throw mapped;
+                }
+                return result;
+            }
+            catch (error) {
+                if (error instanceof ChukyoMaintenanceError) {
+                    throw error;
+                }
+                if (isAbortError(error) && timedOut) {
+                    throw new TimeoutError({ cause: error });
+                }
+                // fetch 自体が throw（DNS 失敗・接続拒否・TLS・URL 不正など。HTTP 応答なし）
+                throw new NetworkError({ cause: error });
+            }
+            finally {
+                clearTimeout(timeoutId);
+                if (req.signal) {
+                    req.signal.removeEventListener("abort", onExternalAbort);
+                }
+            }
+        },
+    };
+};

package/dist/esm/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * SDK コアが依存する Adapter インターフェース群。
+ *
+ * SDK は「HTTP をどう実行するか（{@link Transport}）」と「Cookie をどう供給するか
+ * （{@link SessionProvider}）」を知らない。これらを注入することで、Node / ブラウザ /
+ * ブラウザ拡張 / Expo / カスタムなど任意の環境で同じコードが動く。
+ */
+/** HTTP リクエスト1回分の入力 */
+export interface TransportRequest {
+    /** HTTP メソッド */
+    method: "GET" | "POST";
+    /** 完全な URL */
+    url: string;
+    /** 追加ヘッダ */
+    headers?: Record<string, string>;
+    /** リクエストボディ（form-urlencoded / JSON 文字列など） */
+    body?: string;
+    /** 中断用シグナル */
+    signal?: AbortSignal;
+}
+/** HTTP リクエスト1回分の結果 */
+export interface TransportResponse {
+    /** HTTP ステータスコード */
+    status: number;
+    /** リダイレクト後の最終 URL（CUBICS のセッション判定に使う） */
+    url: string;
+    /** レスポンスボディ（テキストとして読み出し済み） */
+    body: string;
+    /** レスポンスヘッダ（キーは小文字化しておくこと） */
+    headers: Record<string, string>;
+}
+/**
+ * 1回の HTTP リクエストを実行する Adapter。
+ * リダイレクトの自動追従は実装依存でよい（データ取得はそれで足りる）。
+ */
+export interface Transport {
+    request(req: TransportRequest): Promise<TransportResponse>;
+}
+/**
+ * ポータルサービスの記述子。「enterUrl へアクセス → SSO → goalUrl 到達で
+ * Cookie 取得」という共通パターンのための情報。
+ */
+export interface PortalService {
+    /** セッションキャッシュのキー（例: "manabo" / "cubics" / "albo"） */
+    readonly key: string;
+    /** ログイン起点 URL */
+    readonly enterUrl: string;
+    /** 認証完了とみなす到達先 URL */
+    readonly goalUrl: string;
+}
+/**
+ * Cookie / セッションを供給する Adapter（任意）。
+ *
+ * 未指定の場合、SDK は Cookie ヘッダを付与せず {@link Transport} の credentials 設定に
+ * 委ねる（ブラウザ拡張でブラウザの Cookie ジャーを使うユースケース）。
+ * 指定する場合、失効時の再認証は実装側の責務（例: umebo の PortalSessionManager）。
+ */
+export interface SessionProvider {
+    /** HTTP ヘッダ用の Cookie 文字列を返す。失効していれば内部で再認証する */
+    getCookieHeader(service: PortalService): Promise<string>;
+    /** セッション無効を検知した際に呼ぶ（次回アクセスで再認証させる） */
+    invalidate(serviceKey: string): void;
+}
+/** createChukyoClient のオプション */
+export interface ChukyoClientOptions {
+    /** HTTP 実行 Adapter（必須） */
+    transport: Transport;
+    /** Cookie 供給 Adapter（任意。省略時は Cookie を付与しない） */
+    session?: SessionProvider;
+}
+//# sourceMappingURL=types.d.ts.map