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

package/src/types.ts

@@ -0,0 +1,396 @@
+/**
+ * CLI 类型定义
+ *
+ * 与 42plugin-api/src/db/types.ts 保持一致
+ */
+
+// ============================================================================
+// 基础类型
+// ============================================================================
+
+export type PluginType = 'skill' | 'agent' | 'command' | 'hook' | 'mcp';
+export type PriceTier = 'free' | 'vip' | 'premium';
+
+// ============================================================================
+// 插件下载（扁平化：plugin = capability）
+// ============================================================================
+
+export interface PluginDownloadInfo {
+  fullName: string;
+  name: string;
+  type: PluginType;
+  version: string;
+  downloadUrl: string;
+  checksum: string;
+  sizeBytes: number;
+  installPath: string;
+}
+
+export interface PluginDownload {
+  plugin: {
+    fullName: string;
+    name: string;
+    title: string | null;
+    description: string | null;
+    author: string | null;
+    type: PluginType | null;
+    version: string | null;
+    sourceRepo: string | null;
+  };
+  download: PluginDownloadInfo;
+  priceTier: PriceTier;
+  isPaid: boolean;
+  requiresAuth: boolean;
+  expiresAt: string;
+}
+
+// ============================================================================
+// 套包下载
+// ============================================================================
+
+export interface KitDownload {
+  kit: {
+    fullName: string;
+    name: string;
+    description: string | null;
+    priceTier: PriceTier | null;
+    effectivePriceTier: PriceTier;
+  };
+  plugins: Array<{
+    plugin: {
+      fullName: string;
+      name: string;
+      title: string | null;
+      author: string | null;
+      type: PluginType | null;
+    };
+    download: PluginDownloadInfo;
+    required: boolean;
+    reason: string | null;
+  }>;
+  summary: {
+    totalPlugins: number;
+    requiredPlugins: number;
+    optionalPlugins: number;
+    totalSizeBytes: number;
+    expiresAt: string;
+  };
+}
+
+// ============================================================================
+// 搜索
+// ============================================================================
+
+export interface SearchResult {
+  fullName: string;
+  name: string;
+  title: string | null;
+  slogan: string | null;
+  description: string | null;
+  type: PluginType;
+  version: string;
+  author: { username: string };
+  tags: string[];
+  downloads: number;
+  icon: string | null;
+}
+
+export interface SearchResponse {
+  data: SearchResult[];
+  pagination: {
+    page: number;
+    perPage: number;
+    total: number;
+    totalPages: number;
+  };
+}
+
+// API 实际返回格式 (snake_case)
+export interface SearchApiResult {
+  full_name: string;
+  name: string;
+  title: string | null;
+  slogan?: string | null;
+  description: string | null;
+  type: PluginType;
+  version?: string;
+  downloads: number;
+  author: { username: string };
+  tags?: string[];
+  icon?: string | null;
+}
+
+export interface SearchApiResponse {
+  data: {
+    plugins: SearchApiResult[];
+    kits: unknown[];
+  };
+  pagination: {
+    total: number;
+    page: number;
+    per_page: number;
+    loaded: number;
+    has_more: boolean;
+  };
+}
+
+// ============================================================================
+// 认证
+// ============================================================================
+
+export interface DeviceCodeResponse {
+  deviceCode: string;
+  userCode: string;
+  verificationUri: string;
+  verificationUriComplete?: string;
+  expiresIn: number;
+  interval: number;
+}
+
+export interface DeviceTokenResponse {
+  accessToken?: string;
+  user?: {
+    id: string;
+    name: string | null;
+    username: string | null;
+    email: string | null;
+  };
+  error?: string;
+  errorDescription?: string;
+}
+
+export interface Session {
+  user: {
+    id: string;
+    name: string | null;
+    username: string | null;
+    email: string | null;
+  };
+  session: {
+    id: string;
+    expiresAt: string;
+  };
+}
+
+// ============================================================================
+// 本地存储
+// ============================================================================
+
+export interface LocalProject {
+  id: string;
+  path: string;
+  name: string;
+  registeredAt: string;
+  lastUsedAt: string;
+}
+
+export interface LocalCache {
+  fullName: string;
+  type: PluginType;
+  version: string;
+  cachePath: string;
+  checksum: string;
+  sizeBytes: number;
+  cachedAt: string;
+}
+
+export interface LocalInstallation {
+  id: string;
+  projectId: string;
+  fullName: string;
+  type: PluginType;
+  version: string;
+  cachePath: string;
+  linkPath: string;
+  source: 'direct' | 'kit';
+  sourceKit?: string;
+  installedAt: string;
+}
+
+// ============================================================================
+// Kit API 响应（snake_case）
+// ============================================================================
+
+export interface KitApiResponse {
+  data: {
+    kit: {
+      full_name: string;
+      name: string;
+      description: string | null;
+      price_tier: PriceTier | null;
+      effective_price_tier: PriceTier;
+    };
+    plugins: Array<{
+      plugin: {
+        full_name: string;
+        name: string;
+        title: string | null;
+        author: string | null;
+        type: PluginType | null;
+      };
+      download: {
+        full_name: string;
+        name: string;
+        type: PluginType;
+        version: string;
+        download_url: string;
+        checksum: string;
+        size_bytes: number;
+        install_path: string;
+      };
+      required: boolean;
+      reason: string | null;
+    }>;
+    summary: {
+      total_plugins: number;
+      required_plugins: number;
+      optional_plugins: number;
+      total_size_bytes: number;
+      expires_at: string;
+    };
+  };
+}
+
+// ============================================================================
+// 目标解析
+// ============================================================================
+
+export enum TargetType {
+  Plugin = 'plugin',
+  Kit = 'kit',
+}
+
+export interface ParsedTarget {
+  type: TargetType;
+  fullName: string;
+  author: string;
+  name: string;
+}
+
+// ============================================================================
+// 发布相关类型
+// ============================================================================
+
+export interface PublishOptions {
+  path: string;
+  dryRun?: boolean;
+  force?: boolean;
+  visibility?: 'self' | 'public';
+  name?: string;
+}
+
+export interface PluginMetadata {
+  name: string;
+  type: PluginType;
+  title?: string;
+  description?: string;
+  tags?: string[];
+  sourcePath: string;
+}
+
+export interface PackageResult {
+  tarballPath: string;
+  contentHash: string;
+  packageHash: string;
+  sizeBytes: number;
+}
+
+export interface VersionDecision {
+  version: string;
+  action: 'create' | 'update' | 'skip';
+  existingHash?: string;
+}
+
+export interface PublishResult {
+  fullName: string;
+  version: string;
+  storageKey: string;
+  type: PluginType;
+  action: 'created' | 'updated' | 'unchanged';
+}
+
+export interface UploadUrlResponse {
+  uploadUrl: string;
+  storageKey: string;
+  expiresAt: string;
+}
+
+export interface PublishConfirmRequest {
+  name: string;
+  type: PluginType;
+  version: string;
+  contentHash: string;
+  packageHash: string;
+  storageKey: string;
+  sizeBytes: number;
+  title?: string;
+  description?: string;
+  tags?: string[];
+  visibility: 'self' | 'public';
+}
+
+export interface PublishConfirmResponse {
+  plugin: {
+    id: string;
+    fullName: string;
+    version: string;
+  };
+  action: 'created' | 'updated';
+}
+
+export interface PluginStatusResponse {
+  exists: boolean;
+  version?: string;
+  contentHash?: string;
+  visibility?: 'self' | 'public';
+}
+
+// ============================================================================
+// 验证相关类型
+// ============================================================================
+
+export interface ValidationResult {
+  valid: boolean;
+  metadata: PluginMetadata;
+  errors: ValidationIssue[];
+  warnings: ValidationIssue[];
+}
+
+export interface ValidationIssue {
+  code: string;
+  field?: string;
+  message: string;
+  suggestion?: string;
+  line?: number;
+}
+
+// Hook 配置（匹配 Claude Code 实际格式）
+export interface HookConfig {
+  description?: string;
+  hooks: {
+    [eventType: string]: Array<{
+      matcher?: string;
+      hooks: Array<{
+        type: string;
+        command: string;
+        timeout?: number;
+      }>;
+    }>;
+  };
+}
+
+// MCP 配置
+export interface McpConfig {
+  name?: string;
+  protocol_version?: string;
+  capabilities?: {
+    resources?: boolean;
+    tools?: boolean;
+    sampling?: boolean;
+  };
+  tools?: Array<{
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+  }>;
+}

package/src/utils.ts

@@ -0,0 +1,128 @@
+/**
+ * 工具函数
+ */
+
+import { TargetType, type ParsedTarget, type PluginType } from './types';
+
+// ============================================================================
+// 目标解析
+// ============================================================================
+
+/**
+ * 解析安装目标
+ *
+ * - Plugin: author/name
+ * - Kit: author/kit/slug
+ */
+export function parseTarget(target: string): ParsedTarget {
+  // Kit: author/kit/slug
+  if (target.includes('/kit/')) {
+    const [author, , slug] = target.split('/');
+    if (!author || !slug) {
+      throw new Error(`无效的套包格式: ${target}\n正确格式: author/kit/slug`);
+    }
+    return { type: TargetType.Kit, fullName: target, author, name: slug };
+  }
+
+  // Plugin: author/name
+  const parts = target.split('/');
+  if (parts.length !== 2 || !parts[0] || !parts[1]) {
+    throw new Error(`无效的插件格式: ${target}\n正确格式: author/name`);
+  }
+
+  return {
+    type: TargetType.Plugin,
+    fullName: target,
+    author: parts[0],
+    name: parts[1],
+  };
+}
+
+// ============================================================================
+// 安装路径
+// ============================================================================
+
+/**
+ * 获取插件安装路径（.claude/ 目录下）
+ */
+export function getInstallPath(type: PluginType, name: string): string {
+  switch (type) {
+    case 'skill':
+      return `.claude/skills/${name}/`;
+    case 'agent':
+      return `.claude/agents/${name}.md`;
+    case 'command':
+      return `.claude/commands/${name}.md`;
+    case 'hook':
+      return `.claude/hooks/${name}`;
+    case 'mcp':
+      return `.claude/mcp/${name}/`;
+    default:
+      return `.claude/${type}/${name}/`;
+  }
+}
+
+// ============================================================================
+// 格式化
+// ============================================================================
+
+/**
+ * 格式化文件大小
+ */
+export function formatBytes(bytes: number): string {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+
+/**
+ * 格式化相对时间
+ */
+export function formatRelativeTime(date: string | Date): string {
+  const d = typeof date === 'string' ? new Date(date) : date;
+  const now = new Date();
+  const diff = now.getTime() - d.getTime();
+
+  const minutes = Math.floor(diff / 60000);
+  if (minutes < 1) return '刚刚';
+  if (minutes < 60) return `${minutes} 分钟前`;
+
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `${hours} 小时前`;
+
+  const days = Math.floor(hours / 24);
+  if (days < 30) return `${days} 天前`;
+
+  const months = Math.floor(days / 30);
+  if (months < 12) return `${months} 个月前`;
+
+  return `${Math.floor(months / 12)} 年前`;
+}
+
+// ============================================================================
+// 插件类型
+// ============================================================================
+
+const TYPE_LABELS: Record<PluginType, string> = {
+  skill: 'Skill',
+  agent: 'Agent',
+  command: 'Command',
+  hook: 'Hook',
+  mcp: 'MCP',
+};
+
+const TYPE_ICONS: Record<PluginType, string> = {
+  skill: '⚡',
+  agent: '🤖',
+  command: '⌘',
+  hook: '🪝',
+  mcp: '🔌',
+};
+
+export function getTypeLabel(type: PluginType): string {
+  return TYPE_LABELS[type] || type;
+}
+
+export function getTypeIcon(type: PluginType): string {
+  return TYPE_ICONS[type] || '📦';
+}