@launch77/plugin-runtime 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+interface GeneratorContext {
+    appPath: string;
+    appName: string;
+    workspaceName: string;
+    pluginPath: string;
+}
+interface PluginMetadata {
+    name: string;
+    version: string;
+    pluginDependencies?: Record<string, string>;
+    libraryDependencies?: Record<string, string>;
+}
+
+/**
+ * Base abstract class for all plugin generators.
+ *
+ * The only requirement for a generator is to implement the run() method.
+ * This method is called by the CLI when a plugin is installed.
+ *
+ * Use this base class when you need full control over the installation process.
+ * For convention-based installation, extend StandardGenerator instead.
+ */
+declare abstract class Generator {
+    protected context: GeneratorContext;
+    constructor(context: GeneratorContext);
+    /**
+     * Main entry point for plugin installation.
+     * This method is called by the CLI and must be implemented by all generators.
+     */
+    abstract run(): Promise<void>;
+}
+
+/**
+ * Standard generator with convention-over-configuration approach.
+ *
+ * Provides a structured lifecycle with smart defaults:
+ * 1. updateDependencies() - Reads plugin.json, merges into package.json
+ * 2. installDependencies() - Runs npm install
+ * 3. copyTemplates() - Copies templates/ folder to app
+ * 4. injectCode() - Override this for surgical code edits
+ *
+ * Most plugins only need to implement injectCode().
+ * For full control, extend Generator instead.
+ */
+declare abstract class StandardGenerator extends Generator {
+    run(): Promise<void>;
+    protected updateDependencies(): Promise<void>;
+    protected installDependencies(): Promise<void>;
+    protected copyTemplates(): Promise<void>;
+    protected injectCode(): Promise<void>;
+    protected showNextSteps(): void;
+}
+
+declare function copyRecursive(src: string, dest: string): Promise<void>;
+declare function pathExists(filePath: string): Promise<boolean>;
+
+export { Generator, type GeneratorContext, type PluginMetadata, StandardGenerator, copyRecursive, pathExists };

package/dist/index.js

@@ -0,0 +1,109 @@
+// src/generator.ts
+var Generator = class {
+  constructor(context) {
+    this.context = context;
+  }
+};
+
+// src/standard-generator.ts
+import * as path2 from "path";
+import * as fs2 from "fs/promises";
+import chalk from "chalk";
+import { execa } from "execa";
+
+// src/utils/file-operations.ts
+import * as fs from "fs/promises";
+import * as path from "path";
+async function copyRecursive(src, dest) {
+  const stat2 = await fs.stat(src);
+  if (stat2.isDirectory()) {
+    await fs.mkdir(dest, { recursive: true });
+    const entries = await fs.readdir(src);
+    for (const entry of entries) {
+      await copyRecursive(path.join(src, entry), path.join(dest, entry));
+    }
+  } else {
+    await fs.copyFile(src, dest);
+  }
+}
+async function pathExists(filePath) {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/standard-generator.ts
+var StandardGenerator = class extends Generator {
+  async run() {
+    console.log(chalk.green(`
+\u2705 Installing plugin...
+`));
+    await this.updateDependencies();
+    await this.installDependencies();
+    await this.copyTemplates();
+    await this.injectCode();
+    console.log(chalk.green(`
+\u2705 Plugin installed successfully!
+`));
+    this.showNextSteps();
+  }
+  async updateDependencies() {
+    const pluginJsonPath = path2.join(this.context.pluginPath, "plugin.json");
+    if (!await pathExists(pluginJsonPath)) return;
+    try {
+      const pluginJsonContent = await fs2.readFile(pluginJsonPath, "utf-8");
+      const pluginMetadata = JSON.parse(pluginJsonContent);
+      if (!pluginMetadata.libraryDependencies || Object.keys(pluginMetadata.libraryDependencies).length === 0) {
+        return;
+      }
+      const packageJsonPath = path2.join(this.context.appPath, "package.json");
+      const packageJsonContent = await fs2.readFile(packageJsonPath, "utf-8");
+      const packageJson = JSON.parse(packageJsonContent);
+      packageJson.dependencies = {
+        ...packageJson.dependencies,
+        ...pluginMetadata.libraryDependencies
+      };
+      await fs2.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2) + "\n", "utf-8");
+      console.log(chalk.green("   \u2713 Updated package.json with dependencies"));
+    } catch (error) {
+      console.log(chalk.yellow(`   \u26A0\uFE0F  Could not update dependencies: ${error}`));
+    }
+  }
+  async installDependencies() {
+    try {
+      console.log(chalk.cyan("   Installing dependencies..."));
+      const workspaceRoot = path2.dirname(path2.dirname(this.context.appPath));
+      await execa("npm", ["install"], {
+        cwd: workspaceRoot,
+        stdio: "pipe"
+      });
+      console.log(chalk.green("   \u2713 Dependencies installed"));
+    } catch (error) {
+      console.log(chalk.yellow(`   \u26A0\uFE0F  Could not install dependencies: ${error}`));
+    }
+  }
+  async copyTemplates() {
+    const templatesDir = path2.join(this.context.pluginPath, "templates");
+    if (!await pathExists(templatesDir)) return;
+    try {
+      await copyRecursive(templatesDir, this.context.appPath);
+      console.log(chalk.green("   \u2713 Copied template files"));
+    } catch (error) {
+      console.log(chalk.yellow(`   \u26A0\uFE0F  Could not copy template files: ${error}`));
+    }
+  }
+  async injectCode() {
+  }
+  showNextSteps() {
+  }
+};
+export {
+  Generator,
+  StandardGenerator,
+  copyRecursive,
+  pathExists
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/generator.ts","../src/standard-generator.ts","../src/utils/file-operations.ts"],"sourcesContent":["import type { GeneratorContext } from './types.js'\n\n/**\n * Base abstract class for all plugin generators.\n *\n * The only requirement for a generator is to implement the run() method.\n * This method is called by the CLI when a plugin is installed.\n *\n * Use this base class when you need full control over the installation process.\n * For convention-based installation, extend StandardGenerator instead.\n */\nexport abstract class Generator {\n  constructor(protected context: GeneratorContext) {}\n\n  /**\n   * Main entry point for plugin installation.\n   * This method is called by the CLI and must be implemented by all generators.\n   */\n  abstract run(): Promise<void>\n}\n","import * as path from 'path'\nimport * as fs from 'fs/promises'\nimport chalk from 'chalk'\nimport { execa } from 'execa'\nimport { Generator } from './generator.js'\nimport { copyRecursive, pathExists } from './utils/file-operations.js'\nimport type { PluginMetadata } from './types.js'\n\n/**\n * Standard generator with convention-over-configuration approach.\n *\n * Provides a structured lifecycle with smart defaults:\n * 1. updateDependencies() - Reads plugin.json, merges into package.json\n * 2. installDependencies() - Runs npm install\n * 3. copyTemplates() - Copies templates/ folder to app\n * 4. injectCode() - Override this for surgical code edits\n *\n * Most plugins only need to implement injectCode().\n * For full control, extend Generator instead.\n */\nexport abstract class StandardGenerator extends Generator {\n  async run(): Promise<void> {\n    console.log(chalk.green(`\\n✅ Installing plugin...\\n`))\n\n    await this.updateDependencies()\n    await this.installDependencies()\n    await this.copyTemplates()\n    await this.injectCode()\n\n    console.log(chalk.green(`\\n✅ Plugin installed successfully!\\n`))\n    this.showNextSteps()\n  }\n\n  protected async updateDependencies(): Promise<void> {\n    const pluginJsonPath = path.join(this.context.pluginPath, 'plugin.json')\n\n    if (!(await pathExists(pluginJsonPath))) return\n\n    try {\n      const pluginJsonContent = await fs.readFile(pluginJsonPath, 'utf-8')\n      const pluginMetadata: PluginMetadata = JSON.parse(pluginJsonContent)\n\n      if (!pluginMetadata.libraryDependencies || Object.keys(pluginMetadata.libraryDependencies).length === 0) {\n        return\n      }\n\n      const packageJsonPath = path.join(this.context.appPath, 'package.json')\n      const packageJsonContent = await fs.readFile(packageJsonPath, 'utf-8')\n      const packageJson = JSON.parse(packageJsonContent)\n\n      packageJson.dependencies = {\n        ...packageJson.dependencies,\n        ...pluginMetadata.libraryDependencies,\n      }\n\n      await fs.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\\n', 'utf-8')\n      console.log(chalk.green('   ✓ Updated package.json with dependencies'))\n    } catch (error) {\n      console.log(chalk.yellow(`   ⚠️  Could not update dependencies: ${error}`))\n    }\n  }\n\n  protected async installDependencies(): Promise<void> {\n    try {\n      console.log(chalk.cyan('   Installing dependencies...'))\n      const workspaceRoot = path.dirname(path.dirname(this.context.appPath))\n\n      await execa('npm', ['install'], {\n        cwd: workspaceRoot,\n        stdio: 'pipe',\n      })\n\n      console.log(chalk.green('   ✓ Dependencies installed'))\n    } catch (error) {\n      console.log(chalk.yellow(`   ⚠️  Could not install dependencies: ${error}`))\n    }\n  }\n\n  protected async copyTemplates(): Promise<void> {\n    const templatesDir = path.join(this.context.pluginPath, 'templates')\n\n    if (!(await pathExists(templatesDir))) return\n\n    try {\n      await copyRecursive(templatesDir, this.context.appPath)\n      console.log(chalk.green('   ✓ Copied template files'))\n    } catch (error) {\n      console.log(chalk.yellow(`   ⚠️  Could not copy template files: ${error}`))\n    }\n  }\n\n  protected async injectCode(): Promise<void> {\n    // No-op by default - plugins override this for custom code injection\n  }\n\n  protected showNextSteps(): void {\n    // No-op by default - plugins can override to show custom next steps\n  }\n}\n","import * as fs from 'fs/promises'\nimport * as path from 'path'\n\nexport async function copyRecursive(src: string, dest: string): Promise<void> {\n  const stat = await fs.stat(src)\n\n  if (stat.isDirectory()) {\n    await fs.mkdir(dest, { recursive: true })\n    const entries = await fs.readdir(src)\n\n    for (const entry of entries) {\n      await copyRecursive(path.join(src, entry), path.join(dest, entry))\n    }\n  } else {\n    await fs.copyFile(src, dest)\n  }\n}\n\nexport async function pathExists(filePath: string): Promise<boolean> {\n  try {\n    await fs.access(filePath)\n    return true\n  } catch {\n    return false\n  }\n}\n"],"mappings":"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","names":["path","fs","stat"]}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@launch77/plugin-runtime",
+  "version": "0.1.0",
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/**/*.ts"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "execa": "^9.5.2",
+    "fs-extra": "^11.2.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^20.12.7",
+    "tsup": "^8.0.2",
+    "typescript": "^5.4.5"
+  }
+}