@42ailab/42plugin 0.1.0-beta.0 → 0.1.2

package/src/api.ts

@@ -0,0 +1,447 @@
+/**
+ * API 客户端
+ *
+ * 单文件封装所有 API 调用
+ */
+
+import { config } from './config';
+import type {
+  PluginDownload,
+  KitDownload,
+  KitApiResponse,
+  SearchResponse,
+  SearchApiResponse,
+  DeviceCodeResponse,
+  DeviceTokenResponse,
+  Session,
+  PluginStatusResponse,
+  UploadUrlResponse,
+  PublishConfirmRequest,
+  PublishConfirmResponse,
+  PluginType,
+} from './types';
+
+// ============================================================================
+// 错误类型
+// ============================================================================
+
+export class ApiError extends Error {
+  constructor(
+    public statusCode: number,
+    public endpoint: string,
+    message: string,
+    public code?: string
+  ) {
+    super(message);
+    this.name = 'ApiError';
+  }
+}
+
+export class QuotaExceededError extends ApiError {
+  constructor(
+    public quotaType: string,
+    public limit: number,
+    public role: string,
+    message: string
+  ) {
+    super(429, 'quota', message, 'QUOTA_EXCEEDED');
+    this.name = 'QuotaExceededError';
+  }
+
+  isGuestQuota(): boolean {
+    return this.role === 'guest';
+  }
+}
+
+// ============================================================================
+// API 客户端
+// ============================================================================
+
+class ApiClient {
+  private baseUrl: string;
+  private sessionToken: string | null = null;
+
+  constructor() {
+    this.baseUrl = config.apiBaseUrl;
+  }
+
+  setSessionToken(token: string | null): void {
+    this.sessionToken = token;
+  }
+
+  isAuthenticated(): boolean {
+    return !!this.sessionToken;
+  }
+
+  private async request<T>(
+    path: string,
+    options: {
+      method?: string;
+      body?: unknown;
+      auth?: boolean;
+    } = {}
+  ): Promise<T> {
+    const { method = 'GET', body, auth = true } = options;
+
+    const headers: Record<string, string> = {
+      'Content-Type': 'application/json',
+      'User-Agent': '42plugin-cli/1.0.0',
+      'X-Download-Source': 'cli',
+    };
+
+    if (auth && this.sessionToken) {
+      headers['Authorization'] = `Bearer ${this.sessionToken}`;
+    }
+
+    const response = await fetch(`${this.baseUrl}${path}`, {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : undefined,
+    });
+
+    const data = await response.json().catch(() => ({}));
+
+    if (!response.ok) {
+      const error = (data as { error?: { code?: string; message?: string; quotaType?: string; limit?: number; role?: string } }).error;
+      const message = error?.message || `HTTP ${response.status}`;
+
+      if (response.status === 429 && error?.code === 'QUOTA_EXCEEDED') {
+        throw new QuotaExceededError(
+          error.quotaType || 'unknown',
+          error.limit || 0,
+          error.role || 'guest',
+          message
+        );
+      }
+
+      throw new ApiError(response.status, path, message, error?.code);
+    }
+
+    return ((data as { data?: T }).data ?? data) as T;
+  }
+
+  // ==========================================================================
+  // 插件 API
+  // ==========================================================================
+
+  async getPluginDownload(author: string, name: string): Promise<PluginDownload> {
+    return this.request<PluginDownload>(`/v1/plugins/${author}/${name}/download`);
+  }
+
+  // ==========================================================================
+  // 套包 API
+  // ==========================================================================
+
+  async getKitDownload(username: string, slugOrId: string): Promise<KitDownload> {
+    const raw = await this.request<KitApiResponse['data']>(
+      `/v1/kits/${username}/kit/${slugOrId}/download`
+    );
+
+    // 转换 snake_case -> camelCase
+    return {
+      kit: {
+        fullName: raw.kit.full_name,
+        name: raw.kit.name,
+        description: raw.kit.description,
+        priceTier: raw.kit.price_tier,
+        effectivePriceTier: raw.kit.effective_price_tier,
+      },
+      plugins: raw.plugins.map((p) => ({
+        plugin: {
+          fullName: p.plugin.full_name,
+          name: p.plugin.name,
+          title: p.plugin.title,
+          author: p.plugin.author,
+          type: p.plugin.type,
+        },
+        download: {
+          fullName: p.download.full_name,
+          name: p.download.name,
+          type: p.download.type,
+          version: p.download.version,
+          downloadUrl: p.download.download_url,
+          checksum: p.download.checksum,
+          sizeBytes: p.download.size_bytes,
+          installPath: p.download.install_path,
+        },
+        required: p.required,
+        reason: p.reason,
+      })),
+      summary: {
+        totalPlugins: raw.summary.total_plugins,
+        requiredPlugins: raw.summary.required_plugins,
+        optionalPlugins: raw.summary.optional_plugins,
+        totalSizeBytes: raw.summary.total_size_bytes,
+        expiresAt: raw.summary.expires_at,
+      },
+    };
+  }
+
+  // ==========================================================================
+  // 搜索 API
+  // ==========================================================================
+
+  async search(params: {
+    q: string;
+    pluginType?: string;
+    page?: number;
+    perPage?: number;
+  }): Promise<SearchResponse> {
+    const searchParams = new URLSearchParams();
+    searchParams.set('q', params.q);
+    if (params.pluginType) searchParams.set('plugin_type', params.pluginType);
+    if (params.page) searchParams.set('page', String(params.page));
+    if (params.perPage) searchParams.set('per_page', String(params.perPage));
+
+    // 搜索 API 直接返回 {data, pagination}，不需要解包
+    const headers: Record<string, string> = {
+      'Content-Type': 'application/json',
+      'User-Agent': '42plugin-cli/1.0.0',
+      'X-Download-Source': 'cli',
+    };
+    if (this.sessionToken) {
+      headers['Authorization'] = `Bearer ${this.sessionToken}`;
+    }
+
+    const response = await fetch(`${this.baseUrl}/v1/search?${searchParams}`, {
+      method: 'GET',
+      headers,
+    });
+
+    const raw = await response.json();
+
+    if (!response.ok) {
+      const error = raw?.error;
+      const message = error?.message || `HTTP ${response.status}`;
+      throw new ApiError(response.status, '/v1/search', message, error?.code);
+    }
+
+    // 转换 API 响应格式为内部格式 (snake_case -> camelCase)
+    const apiData = raw as SearchApiResponse;
+    const plugins = apiData.data?.plugins || [];
+
+    return {
+      data: plugins.map((p) => ({
+        fullName: p.full_name,
+        name: p.name,
+        title: p.title,
+        slogan: p.slogan || null,
+        description: p.description,
+        type: p.type,
+        version: p.version || '0.0.0',
+        author: p.author,
+        tags: p.tags || [],
+        downloads: p.downloads,
+        icon: p.icon || null,
+      })),
+      pagination: {
+        page: apiData.pagination?.page || 1,
+        perPage: apiData.pagination?.per_page || 20,
+        total: apiData.pagination?.total || 0,
+        totalPages: Math.ceil((apiData.pagination?.total || 0) / (apiData.pagination?.per_page || 20)),
+      },
+    };
+  }
+
+  // ==========================================================================
+  // 认证 API
+  // ==========================================================================
+
+  async requestDeviceCode(): Promise<DeviceCodeResponse> {
+    const response = await fetch(`${this.baseUrl}/auth/device/code`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'User-Agent': '42plugin-cli/1.0.0',
+        'X-Download-Source': 'cli',
+      },
+      body: JSON.stringify({
+        client_id: '42plugin-cli',
+        scope: 'openid profile email',
+      }),
+    });
+
+    const data = await response.json();
+
+    return {
+      deviceCode: data.device_code,
+      userCode: data.user_code,
+      verificationUri: data.verification_uri,
+      verificationUriComplete: data.verification_uri_complete,
+      expiresIn: data.expires_in,
+      interval: data.interval,
+    };
+  }
+
+  async pollDeviceToken(deviceCode: string): Promise<DeviceTokenResponse> {
+    const response = await fetch(`${this.baseUrl}/auth/device/token`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'User-Agent': '42plugin-cli/1.0.0',
+        'X-Download-Source': 'cli',
+      },
+      body: JSON.stringify({
+        client_id: '42plugin-cli',
+        device_code: deviceCode,
+        grant_type: 'urn:ietf:params:oauth:grant-type:device_code',
+      }),
+    });
+
+    const data = await response.json();
+
+    return {
+      accessToken: data.access_token,
+      user: data.user
+        ? {
+            id: data.user.id,
+            name: data.user.name,
+            username: data.user.username,
+            email: data.user.email,
+          }
+        : undefined,
+      error: data.error,
+      errorDescription: data.error_description,
+    };
+  }
+
+  async getSession(): Promise<Session> {
+    // 开发模式跳过认证 - 返回 mock session
+    if (config.devSkipAuth) {
+      return {
+        user: {
+          id: 'dev-user-id',
+          name: 'DevUser',
+          username: 'devuser',
+          email: 'dev@localhost',
+        },
+        session: {
+          id: 'dev-session-id',
+          expiresAt: new Date(Date.now() + 86400000).toISOString(),
+        },
+      };
+    }
+    return this.request<Session>('/session');
+  }
+
+  // ==========================================================================
+  // 用户 API
+  // ==========================================================================
+
+  async recordInstall(pluginFullName: string): Promise<void> {
+    await this.request('/user/installed', {
+      method: 'POST',
+      body: { plugin_full_name: pluginFullName },
+    });
+  }
+
+  async removeInstallRecord(author: string, name: string): Promise<void> {
+    await this.request(`/user/installed/${author}/${name}`, {
+      method: 'DELETE',
+    });
+  }
+
+  // ==========================================================================
+  // 发布 API
+  // ==========================================================================
+
+  /**
+   * 获取插件状态（用于版本决策）
+   */
+  async getPluginStatus(name: string): Promise<PluginStatusResponse> {
+    try {
+      const result = await this.request<{
+        exists: boolean;
+        version?: string;
+        content_hash?: string;
+        visibility?: 'self' | 'public';
+      }>(`/v1/plugins/me/${name}/status`);
+
+      return {
+        exists: result.exists,
+        version: result.version,
+        contentHash: result.content_hash,
+        visibility: result.visibility,
+      };
+    } catch (error) {
+      // 404 表示插件不存在
+      if (error instanceof ApiError && error.statusCode === 404) {
+        return { exists: false };
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * 获取上传签名 URL
+   */
+  async getUploadUrl(params: {
+    name: string;
+    type: PluginType;
+    version: string;
+    contentHash: string;
+    sizeBytes: number;
+  }): Promise<UploadUrlResponse> {
+    const result = await this.request<{
+      upload_url: string;
+      storage_key: string;
+      expires_at: string;
+    }>('/v1/plugins/upload-url', {
+      method: 'POST',
+      body: {
+        name: params.name,
+        type: params.type,
+        version: params.version,
+        content_hash: params.contentHash,
+        size_bytes: params.sizeBytes,
+      },
+    });
+
+    return {
+      uploadUrl: result.upload_url,
+      storageKey: result.storage_key,
+      expiresAt: result.expires_at,
+    };
+  }
+
+  /**
+   * 确认发布
+   */
+  async confirmPublish(params: PublishConfirmRequest): Promise<PublishConfirmResponse> {
+    const result = await this.request<{
+      plugin: {
+        id: string;
+        full_name: string;
+        version: string;
+      };
+      action: 'created' | 'updated';
+    }>('/v1/plugins', {
+      method: 'POST',
+      body: {
+        name: params.name,
+        type: params.type,
+        version: params.version,
+        content_hash: params.contentHash,
+        package_hash: params.packageHash,
+        storage_key: params.storageKey,
+        size_bytes: params.sizeBytes,
+        title: params.title,
+        description: params.description,
+        tags: params.tags,
+        visibility: params.visibility,
+      },
+    });
+
+    return {
+      plugin: {
+        id: result.plugin.id,
+        fullName: result.plugin.full_name,
+        version: result.plugin.version,
+      },
+      action: result.action,
+    };
+  }
+}
+
+// 单例导出
+export const api = new ApiClient();

package/src/cli.ts

@@ -1,27 +1,44 @@
+/**
+ * CLI 入口
+ */
+
 import { Command } from 'commander';
-import { authCommand } from './commands/auth';
-import { installCommand } from './commands/install';
-import { searchCommand } from './commands/search';
-import { listCommand } from './commands/list';
-import { uninstallCommand } from './commands/uninstall';
-import { versionCommand } from './commands/version';
+import {
+  authCommand,
+  installCommand,
+  searchCommand,
+  listCommand,
+  uninstallCommand,
+  completionCommand,
+  setupCommand,
+  publishCommand,
+  checkCommand,
+} from './commands';
 
-export const program = new Command();
+const program = new Command();
 
 program
   .name('42plugin')
-  .description('Claude Code 插件管理器')
-  .version('0.1.0', '-v, --version', '显示版本号')
-  .option('--verbose', '详细输出')
-  .option('--no-color', '禁用颜色输出');
+  .description('活水插件 - AI 插件管理工具')
+  .version('0.1.0');
 
-// Register commands
+// 注册命令
 program.addCommand(authCommand);
-program.addCommand(installCommand);
 program.addCommand(searchCommand);
+program.addCommand(installCommand);
 program.addCommand(listCommand);
 program.addCommand(uninstallCommand);
-program.addCommand(versionCommand);
+program.addCommand(publishCommand);
+program.addCommand(checkCommand);
+program.addCommand(completionCommand);
+program.addCommand(setupCommand);
+
+// 版本命令
+program
+  .command('version')
+  .description('显示版本信息')
+  .action(() => {
+    console.log('42plugin v0.1.0');
+  });
 
-// Default help
-program.showHelpAfterError();
+export { program };

package/src/commands/auth.ts

@@ -1,114 +1,128 @@
+/**
+ * auth 命令 - 认证管理
+ */
+
 import { Command } from 'commander';
-import open from 'open';
-import ora from 'ora';
 import chalk from 'chalk';
-import { api } from '../services/api';
-import { saveSecrets, loadSecrets, clearSecrets } from '../services/auth';
+import ora from 'ora';
+import open from 'open';
+import { api } from '../api';
+import { getSessionToken, saveSessionToken, clearSessionToken } from '../db';
 
 export const authCommand = new Command('auth')
-  .description('登录 / 授权账户')
-  .option('--status', '查看当前登录状态')
-  .option('--logout', '登出并清除本地凭证')
+  .description('登录/登出 42plugin')
+  .option('--status', '查看登录状态')
+  .option('--logout', '登出')
   .action(async (options) => {
-    if (options.status) {
-      await showStatus();
-      return;
-    }
-
     if (options.logout) {
       await logout();
-      return;
+    } else if (options.status) {
+      await status();
+    } else {
+      await login();
     }
-
-    await login();
   });
 
-async function login() {
-  const spinner = ora('正在初始化登录...').start();
+async function login(): Promise<void> {
+  // 检查是否已登录
+  const existingToken = await getSessionToken();
+  if (existingToken) {
+    api.setSessionToken(existingToken);
+    try {
+      const session = await api.getSession();
+      console.log(chalk.yellow(`已登录为 ${session.user.name || session.user.email}`));
+      console.log(chalk.gray('如需切换账号，请先执行 42plugin auth --logout'));
+      return;
+    } catch {
+      // Token 无效，继续登录流程
+    }
+  }
+
+  const spinner = ora('正在请求设备授权码...').start();
 
   try {
-    // 1. Get authorization code
-    const { code, auth_url, expires_at } = await api.startAuth();
+    const deviceCode = await api.requestDeviceCode();
     spinner.stop();
 
     console.log();
-    console.log(chalk.cyan('正在打开浏览器进行授权...'));
+    console.log(chalk.cyan('请在浏览器中完成登录：'));
     console.log();
-    console.log('如果浏览器没有自动打开，请访问：');
-    console.log(chalk.underline(auth_url));
+    console.log(`  ${chalk.bold('验证码')}: ${chalk.yellow.bold(deviceCode.userCode)}`);
+    console.log(`  ${chalk.bold('链接')}: ${deviceCode.verificationUri}`);
     console.log();
 
-    // 2. Open browser
-    await open(auth_url);
+    // 尝试打开浏览器
+    if (deviceCode.verificationUriComplete) {
+      await open(deviceCode.verificationUriComplete).catch(() => {});
+    }
 
-    // 3. Poll for authorization completion
-    spinner.start('等待浏览器授权...');
+    // 轮询等待授权
+    const pollSpinner = ora('等待授权...').start();
+    const interval = (deviceCode.interval || 5) * 1000;
+    const expiresAt = Date.now() + deviceCode.expiresIn * 1000;
 
-    const pollInterval = 2000; // 2 seconds
-    const expiresTime = new Date(expires_at).getTime();
+    while (Date.now() < expiresAt) {
+      await new Promise((r) => setTimeout(r, interval));
 
-    while (Date.now() < expiresTime) {
-      const result = await api.pollAuth(code);
+      const tokenResponse = await api.pollDeviceToken(deviceCode.deviceCode);
 
-      if (result.status === 'completed') {
-        // 4. Save credentials
-        await saveSecrets({
-          access_token: result.access_token!,
-          refresh_token: result.refresh_token!,
-          created_at: new Date().toISOString(),
-        });
+      if (tokenResponse.accessToken && tokenResponse.user) {
+        pollSpinner.succeed('授权成功！');
 
-        // Update API client token
-        api.setToken(result.access_token!);
+        // 保存 token
+        await saveSessionToken(tokenResponse.accessToken);
+        api.setSessionToken(tokenResponse.accessToken);
 
-        spinner.succeed(chalk.green('登录成功！'));
         console.log();
-        console.log(`欢迎，${chalk.cyan(result.user!.display_name || result.user!.username)}！`);
+        console.log(chalk.green(`欢迎，${tokenResponse.user.name || tokenResponse.user.username || tokenResponse.user.email}！`));
         return;
       }
 
-      await sleep(pollInterval);
+      if (tokenResponse.error === 'expired_token') {
+        pollSpinner.fail('授权码已过期，请重新执行 42plugin auth');
+        process.exit(1);
+      }
+
+      if (tokenResponse.error === 'access_denied') {
+        pollSpinner.fail('授权被拒绝');
+        process.exit(1);
+      }
+
+      // authorization_pending 继续等待
     }
 
-    spinner.fail('授权超时，请重试');
+    pollSpinner.fail('授权超时，请重试');
+    process.exit(1);
   } catch (error) {
-    spinner.fail(`登录失败: ${(error as Error).message}`);
+    spinner.fail('登录失败');
+    console.error(chalk.red((error as Error).message));
     process.exit(1);
   }
 }
 
-async function showStatus() {
-  const secrets = await loadSecrets();
+async function logout(): Promise<void> {
+  await clearSessionToken();
+  api.setSessionToken(null);
+  console.log(chalk.green('已登出'));
+}
 
-  if (!secrets) {
+async function status(): Promise<void> {
+  const token = await getSessionToken();
+
+  if (!token) {
     console.log(chalk.yellow('未登录'));
-    console.log('使用 42plugin auth 登录');
+    console.log(chalk.gray('执行 42plugin auth 登录'));
     return;
   }
 
+  api.setSessionToken(token);
+
   try {
-    const user = await api.getMe();
+    const session = await api.getSession();
     console.log(chalk.green('已登录'));
-    console.log();
-    console.log(`用户名: ${chalk.cyan(user.username)}`);
-    console.log(`显示名: ${user.display_name || '-'}`);
-    console.log(`角色:   ${user.role}`);
-
-    if (user.role === 'vip' && user.vip_expires_at) {
-      console.log(`VIP 到期: ${new Date(user.vip_expires_at).toLocaleDateString()}`);
-    }
+    console.log(`  用户: ${session.user.name || session.user.email}`);
   } catch {
-    console.log(chalk.yellow('Token 已过期，请重新登录'));
-    console.log('使用 42plugin auth 重新登录');
+    console.log(chalk.yellow('登录已过期'));
+    console.log(chalk.gray('请执行 42plugin auth 重新登录'));
   }
 }
-
-async function logout() {
-  await clearSecrets();
-  api.resetToken();
-  console.log(chalk.green('已登出'));
-}
-
-function sleep(ms: number) {
-  return new Promise(resolve => setTimeout(resolve, ms));
-}