@42ailab/42plugin 0.1.0-beta.1 → 0.1.5

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,50 @@
+/**
+ * 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';
+
+// 动态读取版本号
+const packageJson = await Bun.file(
+  new URL('../package.json', import.meta.url)
+).json();
+const version: string = packageJson.version;
 
-export const program = new Command();
+const program = new Command();
 
 program
   .name('42plugin')
-  .description('活水插件')
-  .version('0.1.0', '-v, --version', '显示版本号')
-  .option('--verbose', '详细输出')
-  .option('--no-color', '禁用颜色输出');
+  .description('活水插件 - AI 插件管理工具')
+  .version(version);
 
-// 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 v${version}`);
+  });
 
-// Default help
-program.showHelpAfterError();
+export { program };