@gethippoai/create-hippo-plugin 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,359 @@
+#!/usr/bin/env node
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const prompts_1 = __importDefault(require("prompts"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const CATEGORIES = [
+    { title: 'Integration (API, OAuth)', value: 'integration' },
+    { title: 'Productivity (Tasks, Notes)', value: 'productivity' },
+    { title: 'Finance (Payments, Tracking)', value: 'finance' },
+    { title: 'Social (Content, Sharing)', value: 'social' },
+    { title: 'Utility (Tools, Helpers)', value: 'utility' },
+];
+async function main() {
+    console.log('\n🦛 create-hippo-plugin\n');
+    console.log('Yeni bir Hippo plugin\'i oluşturalım.\n');
+    const response = await (0, prompts_1.default)([
+        {
+            type: 'text',
+            name: 'name',
+            message: 'Plugin adı:',
+            initial: 'My Plugin',
+            validate: (v) => v.length > 0 || 'İsim gerekli',
+        },
+        {
+            type: 'text',
+            name: 'slug',
+            message: 'Plugin slug (kebab-case):',
+            initial: (_, values) => values.name
+                .toLowerCase()
+                .replace(/[^a-z0-9]+/g, '-')
+                .replace(/^-|-$/g, ''),
+            validate: (v) => /^[a-z0-9-]+$/.test(v) || 'Sadece küçük harf, rakam ve tire',
+        },
+        {
+            type: 'text',
+            name: 'description',
+            message: 'Kısa açıklama:',
+            initial: 'A Hippo plugin',
+        },
+        {
+            type: 'select',
+            name: 'category',
+            message: 'Kategori:',
+            choices: CATEGORIES,
+        },
+        {
+            type: 'text',
+            name: 'author',
+            message: 'Geliştirici:',
+            initial: 'Hippo Community',
+        },
+        {
+            type: 'confirm',
+            name: 'needsOAuth',
+            message: 'OAuth gerekiyor mu? (Google, GitHub vs.)',
+            initial: false,
+        },
+        {
+            type: (prev) => (prev ? 'text' : null),
+            name: 'oauthProvider',
+            message: 'OAuth provider (google, github, slack...):',
+            initial: 'google',
+        },
+        {
+            type: 'list',
+            name: 'tools',
+            message: 'AI tool isimleri (virgülle ayır):',
+            initial: 'my_tool',
+            separator: ',',
+        },
+    ]);
+    if (!response.name) {
+        console.log('\n❌ İptal edildi.\n');
+        process.exit(1);
+    }
+    const config = {
+        name: response.name,
+        slug: response.slug,
+        description: response.description,
+        category: response.category,
+        author: response.author,
+        needsOAuth: response.needsOAuth || false,
+        oauthProvider: response.oauthProvider || '',
+        tools: (response.tools || ['my_tool']).map((t) => t.trim()),
+    };
+    const outputDir = path_1.default.resolve(process.cwd(), `hippo-${config.slug}-plugin`);
+    await generatePlugin(config, outputDir);
+    console.log(`\n✅ Plugin oluşturuldu: ${outputDir}\n`);
+    console.log('Dosya yapısı:');
+    console.log(`  hippo-${config.slug}-plugin/`);
+    console.log('  ├── src/');
+    console.log('  │   ├── manifest.ts        # Plugin tanımı');
+    console.log('  │   ├── handlers.ts        # Tool handler\'ları');
+    console.log('  │   └── index.ts           # Entry point');
+    console.log('  ├── locales/               # 10 dil çevirisi');
+    console.log('  │   ├── tr.json');
+    console.log('  │   ├── en.json');
+    console.log('  │   └── ...');
+    console.log('  ├── README.md');
+    console.log('  └── package.json');
+    console.log('\nSonraki adımlar:');
+    console.log(`  1. cd hippo-${config.slug}-plugin`);
+    console.log('  2. npm install');
+    console.log('  3. src/handlers.ts dosyasında tool handler\'larını yaz');
+    console.log('  4. locales/ altında çevirileri tamamla');
+    console.log('  5. Hippo backend\'e entegre et (README\'e bak)\n');
+}
+async function generatePlugin(config, outputDir) {
+    await fs_extra_1.default.ensureDir(path_1.default.join(outputDir, 'src'));
+    await fs_extra_1.default.ensureDir(path_1.default.join(outputDir, 'locales'));
+    // package.json
+    await fs_extra_1.default.writeJSON(path_1.default.join(outputDir, 'package.json'), {
+        name: `hippo-${config.slug}-plugin`,
+        version: '1.0.0',
+        description: config.description,
+        main: 'dist/index.js',
+        types: 'dist/index.d.ts',
+        scripts: {
+            build: 'tsc',
+            dev: 'tsx src/index.ts',
+        },
+        dependencies: {},
+        devDependencies: {
+            typescript: '^5.5.0',
+            tsx: '^4.19.0',
+        },
+        hippoPlugin: {
+            slug: config.slug,
+            category: config.category,
+        },
+    }, { spaces: 2 });
+    // tsconfig.json
+    await fs_extra_1.default.writeJSON(path_1.default.join(outputDir, 'tsconfig.json'), {
+        compilerOptions: {
+            target: 'ES2022',
+            module: 'commonjs',
+            outDir: './dist',
+            rootDir: './src',
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+            declaration: true,
+        },
+        include: ['src/**/*'],
+    }, { spaces: 2 });
+    // src/manifest.ts
+    const manifestContent = `/**
+ * ${config.name} — Hippo Plugin Manifest
+ */
+
+export const manifest = {
+  slug: '${config.slug}',
+  name: '${config.name}',
+  description: '${config.description}',
+  version: '1.0.0',
+  icon: '🔌',
+  category: '${config.category}' as const,
+  author: '${config.author}',
+  isOfficial: false,
+
+  // AI tool tanımları
+  tools: [
+${config.tools
+        .map((t) => `    {
+      name: '${t}',
+      description: 'TODO: ${t} tool açıklaması',
+      parameters: {
+        type: 'object' as const,
+        properties: {
+          // TODO: Parametreleri tanımla
+        },
+      },
+    },`)
+        .join('\n')}
+  ],
+${config.needsOAuth
+        ? `
+  // OAuth yapılandırması
+  configSchema: {
+    type: 'oauth',
+    provider: '${config.oauthProvider}',
+    scopes: ['TODO: gerekli scope\'ları ekle'],
+  },
+`
+        : `
+  // Kullanıcı yapılandırması (opsiyonel)
+  configSchema: {},
+`}
+  // Çoklu dil desteği (locales/ klasöründen yüklenir)
+  i18n: {},
+};
+`;
+    await fs_extra_1.default.writeFile(path_1.default.join(outputDir, 'src', 'manifest.ts'), manifestContent);
+    // src/handlers.ts
+    const handlersContent = `/**
+ * ${config.name} — Tool Handlers
+ *
+ * Her tool için bir handler fonksiyonu tanımlayın.
+ * Handler'lar AI tool çağrıldığında çalışır.
+ */
+
+export interface PluginContext {
+  userId: string;
+  locale: string;
+  currency: string;
+  /** Plugin'e özel kullanıcı ayarları (PluginInstallation.config) */
+  config: Record<string, unknown>;
+  /** OAuth token'ları (varsa) */
+  oauthData?: Record<string, unknown>;
+}
+
+export interface HandlerResult {
+  success: boolean;
+  data?: unknown;
+  message?: string;
+  error?: string;
+}
+
+${config.tools
+        .map((t) => `/**
+ * ${t} handler
+ *
+ * @param params - AI'ın gönderdiği parametreler (tool tanımındaki properties)
+ * @param ctx - Kullanıcı bağlamı (userId, locale, config, oauthData)
+ */
+export async function handle_${t}(
+  params: Record<string, unknown>,
+  ctx: PluginContext,
+): Promise<HandlerResult> {
+  // TODO: Handler mantığını implement et
+  return {
+    success: true,
+    data: {},
+    message: '${t} başarılı',
+  };
+}
+`)
+        .join('\n')}
+
+/** Handler registry — tool adı → handler fonksiyonu */
+export const handlers: Record<string, (params: Record<string, unknown>, ctx: PluginContext) => Promise<HandlerResult>> = {
+${config.tools.map((t) => `  '${t}': handle_${t},`).join('\n')}
+};
+`;
+    await fs_extra_1.default.writeFile(path_1.default.join(outputDir, 'src', 'handlers.ts'), handlersContent);
+    // src/index.ts
+    const indexContent = `/**
+ * ${config.name} — Hippo Plugin Entry Point
+ */
+
+export { manifest } from './manifest';
+export { handlers } from './handlers';
+export type { PluginContext, HandlerResult } from './handlers';
+`;
+    await fs_extra_1.default.writeFile(path_1.default.join(outputDir, 'src', 'index.ts'), indexContent);
+    // Locale files
+    const locales = {
+        tr: { name: config.name, description: config.description },
+        en: { name: config.name, description: config.description },
+        de: { name: config.name, description: `TODO: German description` },
+        fr: { name: config.name, description: `TODO: French description` },
+        es: { name: config.name, description: `TODO: Spanish description` },
+        pt: { name: config.name, description: `TODO: Portuguese description` },
+        it: { name: config.name, description: `TODO: Italian description` },
+        nl: { name: config.name, description: `TODO: Dutch description` },
+        ru: { name: config.name, description: `TODO: Russian description` },
+        ar: { name: config.name, description: `TODO: Arabic description` },
+    };
+    for (const [lang, translations] of Object.entries(locales)) {
+        await fs_extra_1.default.writeJSON(path_1.default.join(outputDir, 'locales', `${lang}.json`), translations, {
+            spaces: 2,
+        });
+    }
+    // README.md
+    const readmeContent = `# ${config.name}
+
+${config.description}
+
+## Hippo Plugin
+
+| | |
+|---|---|
+| **Slug** | \`${config.slug}\` |
+| **Kategori** | ${config.category} |
+| **Geliştirici** | ${config.author} |
+| **Versiyon** | 1.0.0 |
+${config.needsOAuth ? `| **OAuth** | ${config.oauthProvider} |` : ''}
+
+## AI Tool'ları
+
+${config.tools.map((t) => `- \`${t}\` — TODO: açıklama`).join('\n')}
+
+## Kurulum
+
+### 1. Handler'ları Yaz
+
+\`src/handlers.ts\` dosyasında her tool için handler mantığını implement edin.
+
+### 2. Hippo Backend'e Kaydet
+
+\`hippo-backend/apps/api/src/core/services/plugin_seed.ts\` dosyasına manifest'i ekleyin:
+
+\`\`\`typescript
+import { manifest } from 'hippo-${config.slug}-plugin';
+
+// OFFICIAL_PLUGINS dizisine ekleyin:
+{
+  slug: manifest.slug,
+  name: manifest.name,
+  description: manifest.description,
+  version: manifest.version,
+  icon: manifest.icon,
+  category: manifest.category,
+  author: manifest.author,
+  tools: manifest.tools,
+  i18n: manifest.i18n,
+}
+\`\`\`
+
+### 3. Hippo AI'a Handler Ekle
+
+\`hippo-ai/src/core/engine/handlers/\` altına handler dosyanızı kopyalayın ve registry'ye kaydedin.
+
+### 4. Çevirileri Tamamla
+
+\`locales/\` klasöründeki 10 dil dosyasını doldurun.
+
+## Geliştirme
+
+\`\`\`bash
+npm install
+npm run build
+\`\`\`
+
+## Dosya Yapısı
+
+\`\`\`
+hippo-${config.slug}-plugin/
+├── src/
+│   ├── manifest.ts      # Plugin tanımı (tools, config, i18n)
+│   ├── handlers.ts      # Tool handler fonksiyonları
+│   └── index.ts         # Entry point
+├── locales/             # 10 dil çevirisi
+│   ├── tr.json
+│   ├── en.json
+│   └── ...
+├── package.json
+├── tsconfig.json
+└── README.md
+\`\`\`
+`;
+    await fs_extra_1.default.writeFile(path_1.default.join(outputDir, 'README.md'), readmeContent);
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@gethippoai/create-hippo-plugin",
+  "version": "1.0.0",
+  "description": "CLI to scaffold a new Hippo plugin",
+  "author": "GetHippoAI",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GetHippoAI/create-hippo-plugin"
+  },
+  "keywords": ["hippo", "plugin", "cli", "scaffold", "ai"],
+  "bin": {
+    "create-hippo-plugin": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "prompts": "^2.4.2",
+    "chalk": "^5.3.0",
+    "fs-extra": "^11.2.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/prompts": "^2.4.9",
+    "tsx": "^4.19.0",
+    "typescript": "^5.5.0"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ]
+}