@kanmon-hq/tollgate-ui 0.0.5 → 1.1.2

package/README.md

@@ -113,22 +113,45 @@ export function TollgateAdminPage() {
 
 ## Props (Attributes / Properties)
 
-| 属性名 | 型 | 説明 | デフォルト値 |
+| 属性名 | 型 | 説明 | デフォルト値 / 環境変数フォールバック |
 | :--- | :--- | :--- | :--- |
-| `api-base-url` | `string` | Tollgate サーバーの Base URL (例: `http://localhost:8000`) | `""` |
-| `admin-token` | `string` | 管理者認可シークレット / Bearer トークン | `""` |
+| `api-base-url` | `string` | Tollgate サーバーの Base URL (例: `http://localhost:8000`, `/api`) | `""` / `VITE_TOLLGATE_API_BASE_URL` |
+| `admin-token` | `string` | 管理者認可シークレット / Bearer トークン | `""` / `VITE_TOLLGATE_ADMIN_TOKEN` |
 | `tenant-id` | `string` | 特定テナントに限定する場合のテナントID | `""` |
-| `tenants-json` | `string` \| `TenantOption[]` | テナント一覧の配列（またはJSON文字列） | `[]` |
+| `tenants-json` | `string` \| `TenantOption[]` | テナント一覧の配列（またはJSON文字列） | `[]` / `VITE_TOLLGATE_TENANTS` |
 | `embedded` | `boolean` | ヘッダーを非表示にしてコンポーネントのみ埋め込むモード | `false` |
 | `title` | `string` | ヘッダータイトル | `"API Key Gateway (Tollgate) 管理コンソール"` |
 
+## 環境変数 (デフォルト設定)
+
+ビルド時やローカル開発時、属性が省略された場合のデフォルト値を `.env` 等の環境変数で設定可能です：
+
+```env
+# Tollgate UI — Environment Variables
+VITE_TOLLGATE_API_BASE_URL=http://localhost:8000
+VITE_TOLLGATE_ADMIN_TOKEN=admin-secret-key-for-local-dev
+VITE_TOLLGATE_TENANTS=[{"id":"tenant-risk-01","name":"Risk Division"},{"id":"tenant-finance-02","name":"Finance Division"}]
+```
+
+## UI 上での動的エンドポイント変更
+
+- ヘッダー右上の **エンドポイントバッジ / 接続設定ボタン（⚙️）** をクリックすることで、モーダル上から API Base URL や Admin Token を動的に変更・接続テスト・即時リロードが可能です。
+- UI 上で変更した設定はブラウザの `localStorage` に保持され、リロード後も維持されます。「初期値に戻す」ボタンで環境変数/Props のデフォルト値に戻すことができます。
+
+## 解決優先順位 (Resolution Order)
+
+1. **UI 手動設定** (`localStorage`)
+2. **Props / Attributes** (`api-base-url`, `admin-token`, `tenants-json`)
+3. **環境変数** (`VITE_TOLLGATE_*`) またはグローバル定義 (`window.__TOLLGATE_CONFIG__`)
+4. **デフォルト値** (同一オリジン / 空文字)
+
 ## 開発
 
 ```bash
 # 依存関係インストール
 npm install
 
-# 開発サーバー起動
+# 開発サーバー起動 (http://localhost:5173/)
 npm run dev
 
 # Web Components ライブラリビルド

package/dist/api/client.d.ts

@@ -1,4 +1,4 @@
-import { TollgateKey, CreateKeyInput, CreateKeyOutput, UpdateKeyInput, RotateKeyOutput, VerifyKeyResult } from '../types';
+import { TollgateKey, CreateKeyInput, CreateKeyOutput, UpdateKeyInput, RotateKeyOutput, VerifyKeyResult, KeyStats } from '../types';
 export declare class TollgateApiClient {
     private baseUrl;
     private adminToken?;
@@ -8,17 +8,34 @@ export declare class TollgateApiClient {
         adminToken?: string;
         tenantId?: string;
     });
+    getBaseUrl(): string;
     setBaseUrl(url: string): void;
+    getAdminToken(): string | undefined;
     setAdminToken(token?: string): void;
+    getTenantId(): string | undefined;
     setTenantId(id?: string): void;
+    checkHealth(): Promise<{
+        status: string;
+        service?: string;
+    }>;
+    checkAdminAuth(tenantId?: string): Promise<boolean>;
     private request;
-    fetchKeys(tenantId?: string): Promise<TollgateKey[]>;
+    fetchKeys(options?: string | {
+        tenantId?: string;
+        serviceId?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        keys: TollgateKey[];
+        nextCursor?: string;
+    }>;
+    fetchStats(tenantId?: string, serviceId?: string): Promise<KeyStats>;
     fetchAllKeys(tenantIds: string[]): Promise<TollgateKey[]>;
     createKey(input: CreateKeyInput): Promise<CreateKeyOutput>;
     updateKey(keyId: string, payload: UpdateKeyInput, tenantId?: string): Promise<TollgateKey>;
     suspendKey(keyId: string, tenantId?: string): Promise<void>;
     resumeKey(keyId: string, tenantId?: string): Promise<void>;
-    rotateKey(keyId: string, gracePeriodSeconds?: number, tenantId?: string): Promise<RotateKeyOutput>;
+    rotateKey(keyId: string, gracePeriodHours?: number, tenantId?: string): Promise<RotateKeyOutput>;
     deleteKey(keyId: string, tenantId?: string): Promise<void>;
     verifyKey(rawKey: string, requiredScope?: string): Promise<VerifyKeyResult>;
 }

package/dist/components/TollgateConsole.ce.vue.d.ts

@@ -11,7 +11,6 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     adminToken: string;
     tenantId: string;
     apiBaseUrl: string;
-    tenantsJson: string | TenantOption[];
     embedded: boolean;
     title: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;

package/dist/config.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 環境変数およびグローバル設定の安全な取得ユーティリティ
+ */
+declare global {
+    interface Window {
+        __TOLLGATE_CONFIG__?: {
+            apiBaseUrl?: string;
+            adminToken?: string;
+            tenantId?: string;
+            tenantsJson?: string;
+        };
+    }
+}
+/**
+ * デフォルトの API Base URL を取得する
+ * 解決優先順位:
+ * 1. import.meta.env.VITE_TOLLGATE_API_BASE_URL
+ * 2. window.__TOLLGATE_CONFIG__.apiBaseUrl
+ * 3. '' (空文字: 同一ホスト / リバースプロキシ経由)
+ */
+export declare function getDefaultApiBaseUrl(): string;
+/**
+ * デフォルトの管理者トークンを取得する
+ * 解決優先順位:
+ * 1. import.meta.env.VITE_TOLLGATE_ADMIN_TOKEN
+ * 2. window.__TOLLGATE_CONFIG__.adminToken
+ * 3. ''
+ */
+export declare function getDefaultAdminToken(): string;
+/**
+ * デフォルトのテナント一覧 (JSON文字列) を取得する
+ */
+export declare function getDefaultTenantsJson(): string;