@secondlayer/cli 3.3.1 → 3.4.0

package/dist/index.js.map

@@ -1,14 +1,15 @@
 {
   "version": 3,
-  "sources": ["../src/utils/format.ts", "../src/utils/config.ts", "../src/core/plugin-manager.ts", "../src/types/plugin.ts", "../src/utils/contract-id.ts"],
+  "sources": ["../src/types/plugin.ts", "../src/utils/contract-id.ts", "../src/utils/format.ts", "../src/core/plugin-manager.ts", "../src/utils/config.ts", "../src/index.ts"],
   "sourcesContent": [
+    "/**\n * Plugin system types for @secondlayer/cli\n */\n\nimport type { AbiContract } from \"@secondlayer/stacks/clarity\";\nimport type {\n\tNetworkName,\n\tResolvedContract,\n\tSecondLayerConfig,\n} from \"./config\";\n\n/**\n * Core plugin interface that all plugins must implement\n */\nexport interface SecondLayerPlugin {\n\t/** Plugin name (should be unique) */\n\tname: string;\n\n\t/** Plugin version */\n\tversion: string;\n\n\t// Lifecycle hooks\n\t/** Called after config is resolved but before generation starts */\n\tconfigResolved?: (config: ResolvedConfig) => void | Promise<void>;\n\n\t/** Called before generation starts */\n\tbeforeGenerate?: (context: GenerateContext) => void | Promise<void>;\n\n\t/** Called during generation phase - plugins can add their own outputs */\n\tgenerate?: (context: GenerateContext) => void | Promise<void>;\n\n\t/** Called after all generation is complete */\n\tafterGenerate?: (context: GenerateContext) => void | Promise<void>;\n\n\t// Transform hooks\n\t/** Transform user config before resolution */\n\ttransformConfig?: (config: UserConfig) => UserConfig | Promise<UserConfig>;\n\n\t/** Transform individual contracts during processing */\n\ttransformContract?: (\n\t\tcontract: ContractConfig,\n\t) => ContractConfig | Promise<ContractConfig>;\n\n\t/** Transform generated output before writing to disk */\n\ttransformOutput?: (\n\t\toutput: string,\n\t\ttype: OutputType,\n\t) => string | Promise<string>;\n}\n\n/**\n * User configuration (before plugin transformations)\n */\nexport type UserConfig = SecondLayerConfig;\n\n/**\n * Resolved configuration (after plugin transformations)\n */\nexport interface ResolvedConfig extends SecondLayerConfig {\n\t/** Resolved plugins array */\n\tplugins: SecondLayerPlugin[];\n}\n\n/**\n * Contract configuration that can be transformed by plugins\n */\nexport interface ContractConfig {\n\tname?: string;\n\taddress?: string | Partial<Record<NetworkName, string>>;\n\tsource?: string;\n\tabi?: AbiContract;\n\tmetadata?: Record<string, any>;\n}\n\n/**\n * Contract config from Clarinet plugin\n */\nexport interface ClarinetContractConfig extends ContractConfig {\n\t_clarinetSource: true;\n}\n\n/**\n * Contract config from direct file input\n */\nexport interface DirectFileContractConfig extends ContractConfig {\n\t_directFile: true;\n}\n\n/**\n * Union of all contract config types\n */\nexport type PluginContractConfig =\n\t| ContractConfig\n\t| ClarinetContractConfig\n\t| DirectFileContractConfig;\n\n/**\n * Type guard for Clarinet contracts\n */\nexport function isClarinetContract(\n\tc: ContractConfig,\n): c is ClarinetContractConfig {\n\treturn \"_clarinetSource\" in c && c._clarinetSource === true;\n}\n\n/**\n * Type guard for direct file contracts\n */\nexport function isDirectFileContract(\n\tc: ContractConfig,\n): c is DirectFileContractConfig {\n\treturn \"_directFile\" in c && c._directFile === true;\n}\n\n/**\n * Processed contract with resolved ABI and metadata\n */\nexport interface ProcessedContract extends ResolvedContract {\n\t/** Additional metadata added by plugins */\n\tmetadata?: Record<string, any>;\n}\n\n/**\n * Generated output from plugins\n */\nexport interface GeneratedOutput {\n\t/** File path where output should be written */\n\tpath: string;\n\n\t/** Generated content */\n\tcontent: string;\n\n\t/** Output type for transformation hooks */\n\ttype?: OutputType;\n\n\t/** Whether this output should overwrite existing files */\n\toverwrite?: boolean;\n}\n\n/**\n * Types of outputs that can be generated\n */\nexport type OutputType =\n\t| \"contracts\"\n\t| \"hooks\"\n\t| \"actions\"\n\t| \"types\"\n\t| \"utils\"\n\t| \"config\"\n\t| \"other\";\n\n/**\n * Base context available to all plugin hooks\n */\nexport interface PluginContext {\n\t/** Resolved configuration */\n\tconfig: ResolvedConfig;\n\n\t/** Logger for plugin output */\n\tlogger: Logger;\n\n\t/** Utility functions for plugins */\n\tutils: PluginUtils;\n}\n\n/**\n * Context available during generation phase\n */\nexport interface GenerateContext extends PluginContext {\n\t/** Processed contracts ready for generation */\n\tcontracts: ProcessedContract[];\n\n\t/** Map of output keys to generated content */\n\toutputs: Map<string, GeneratedOutput>;\n\n\t/** Function to augment existing outputs */\n\taugment: (outputKey: string, contractName: string, content: any) => void;\n\n\t/** Function to add new outputs */\n\taddOutput: (key: string, output: GeneratedOutput) => void;\n}\n\n/**\n * Logger interface for plugin output\n */\nexport interface Logger {\n\tinfo: (message: string) => void;\n\twarn: (message: string) => void;\n\terror: (message: string) => void;\n\tdebug: (message: string) => void;\n\tsuccess: (message: string) => void;\n}\n\n/**\n * Utility functions available to plugins\n */\nexport interface PluginUtils {\n\t/** Convert kebab-case to camelCase */\n\ttoCamelCase: (str: string) => string;\n\n\t/** Convert camelCase to kebab-case */\n\ttoKebabCase: (str: string) => string;\n\n\t/** Validate Stacks address format */\n\tvalidateAddress: (address: string) => boolean;\n\n\t/** Parse contract identifier (address.contract-name) */\n\tparseContractId: (contractId: string) => {\n\t\taddress: string;\n\t\tcontractName: string;\n\t};\n\n\t/** Format TypeScript code using prettier */\n\tformatCode: (code: string) => Promise<string>;\n\n\t/** Resolve file path relative to project root */\n\tresolvePath: (relativePath: string) => string;\n\n\t/** Check if file exists */\n\tfileExists: (path: string) => Promise<boolean>;\n\n\t/** Read file content */\n\treadFile: (path: string) => Promise<string>;\n\n\t/** Write file content */\n\twriteFile: (path: string, content: string) => Promise<void>;\n\n\t/** Create directory recursively */\n\tensureDir: (path: string) => Promise<void>;\n}\n\n/**\n * Plugin factory function type for creating plugins with options\n */\nexport type PluginFactory<TOptions = any> = (\n\toptions?: TOptions,\n) => SecondLayerPlugin;\n\n/**\n * Plugin options base interface\n */\nexport interface PluginOptions {\n\t/** Include only specific contracts/functions */\n\tinclude?: string[];\n\n\t/** Exclude specific contracts/functions */\n\texclude?: string[];\n\n\t/** Enable debug output */\n\tdebug?: boolean;\n}\n\n/**\n * Hook execution result\n */\nexport interface HookResult<T = any> {\n\t/** Whether the hook was successful */\n\tsuccess: boolean;\n\n\t/** Result data from the hook */\n\tdata?: T;\n\n\t/** Error if hook failed */\n\terror?: Error;\n\n\t/** Plugin that executed the hook */\n\tplugin: string;\n}\n\n/**\n * Plugin execution context for internal use\n */\nexport interface PluginExecutionContext {\n\t/** Current plugin being executed */\n\tcurrentPlugin?: SecondLayerPlugin;\n\n\t/** Execution phase */\n\tphase: \"config\" | \"generate\" | \"output\";\n\n\t/** Start time for performance tracking */\n\tstartTime: number;\n\n\t/** Plugin execution results */\n\tresults: Map<string, HookResult[]>;\n}\n",
+    "/**\n * Parse a fully-qualified contract ID (\"address.contractName\") into its parts.\n * Throws if the input doesn't contain a dot separator.\n */\nexport function parseContractId(contractId: string): {\n\taddress: string;\n\tcontractName: string;\n} {\n\tconst dotIndex = contractId.indexOf(\".\");\n\tif (dotIndex === -1) {\n\t\tthrow new Error(\n\t\t\t`Invalid contract ID: \"${contractId}\" (expected \"address.contractName\")`,\n\t\t);\n\t}\n\treturn {\n\t\taddress: contractId.slice(0, dotIndex),\n\t\tcontractName: contractId.slice(dotIndex + 1),\n\t};\n}\n",
     "/**\n * Shared code formatting utilities using Biome\n */\n\nimport { Biome, Distribution } from \"@biomejs/js-api\";\n\nlet biome: Biome | null = null;\n\n/**\n * Lazily initialize Biome singleton\n */\nasync function getBiome(): Promise<Biome> {\n\tif (!biome) {\n\t\tbiome = await Biome.create({\n\t\t\tdistribution: Distribution.NODE,\n\t\t});\n\n\t\tbiome.applyConfiguration({\n\t\t\tformatter: {\n\t\t\t\tenabled: true,\n\t\t\t\tindentStyle: \"tab\",\n\t\t\t\tlineWidth: 80,\n\t\t\t},\n\t\t\tjavascript: {\n\t\t\t\tformatter: {\n\t\t\t\t\tsemicolons: \"always\",\n\t\t\t\t\tquoteStyle: \"single\",\n\t\t\t\t},\n\t\t\t},\n\t\t\torganizeImports: {\n\t\t\t\tenabled: true,\n\t\t\t},\n\t\t\tlinter: {\n\t\t\t\tenabled: true,\n\t\t\t},\n\t\t\tassists: {\n\t\t\t\tenabled: true,\n\t\t\t},\n\t\t});\n\n\t\tbiome.registerProjectFolder();\n\t}\n\n\treturn biome;\n}\n\n/**\n * Format TypeScript code using Biome\n */\nexport async function formatCode(code: string): Promise<string> {\n\tconst b = await getBiome();\n\n\t// Use lintContent with SafeFixes to organize imports\n\tconst linted = b.lintContent(code, {\n\t\tfilePath: \"generated.ts\",\n\t\tfixFileMode: \"SafeFixes\",\n\t});\n\n\t// Then format\n\tconst formatted = b.formatContent(linted.content, {\n\t\tfilePath: \"generated.ts\",\n\t});\n\n\treturn formatted.content;\n}\n",
-    "import { randomBytes } from \"crypto\";\nimport { promises as fs } from \"fs\";\nimport { createRequire } from \"module\";\nimport { tmpdir } from \"os\";\nimport path from \"path\";\nimport { pathToFileURL } from \"url\";\nimport { PluginManager } from \"../core/plugin-manager\";\nimport type { ConfigDefiner, SecondLayerConfig } from \"../types/config\";\nimport type { ResolvedConfig } from \"../types/plugin\";\n\n/**\n * Config file utilities\n */\n\nconst CONFIG_FILE_NAMES = [\n\t\"secondlayer.config.ts\",\n\t\"secondlayer.config\",\n\t\"secondlayer.config.mjs\",\n];\n\nexport async function findConfigFile(cwd: string): Promise<string | null> {\n\tfor (const fileName of CONFIG_FILE_NAMES) {\n\t\tconst filePath = path.join(cwd, fileName);\n\t\ttry {\n\t\t\tawait fs.access(filePath);\n\t\t\treturn filePath;\n\t\t} catch {\n\t\t\t// File doesn't exist, continue\n\t\t}\n\t}\n\treturn null;\n}\n\nexport async function loadConfig(configPath?: string): Promise<ResolvedConfig> {\n\tconst cwd = process.cwd();\n\n\tconst resolvedPath = configPath\n\t\t? path.resolve(cwd, configPath)\n\t\t: await findConfigFile(cwd);\n\n\tif (!resolvedPath) {\n\t\tthrow new Error(\n\t\t\t\"No config file found. Create a secondlayer.config.ts file or specify a path with --config\",\n\t\t);\n\t}\n\n\tlet config: any;\n\n\tif (resolvedPath.endsWith(\".ts\")) {\n\t\tconst code = await fs.readFile(resolvedPath, \"utf-8\");\n\n\t\t// Transform TypeScript to JavaScript, replacing the @secondlayer/cli import\n\t\t// For development/linked packages, we need to resolve to the actual package location\n\t\t// This will work both for published packages and local development\n\t\tlet replacementPath: string;\n\n\t\ttry {\n\t\t\t// Try to resolve @secondlayer/cli as if it were a normal package\n\t\t\tconst require = createRequire(import.meta.url);\n\t\t\tconst packagePath = require.resolve(\"@secondlayer/cli\");\n\t\t\treplacementPath = pathToFileURL(packagePath).href;\n\t\t} catch {\n\t\t\t// Fallback: resolve relative to current module (for development)\n\t\t\tconst currentModuleDir = path.dirname(new URL(import.meta.url).pathname);\n\t\t\tconst indexPath = path.resolve(currentModuleDir, \"../index\");\n\t\t\treplacementPath = pathToFileURL(indexPath).href;\n\t\t}\n\n\t\tconst transformedCode = code.replace(\n\t\t\t/from\\s+[\"']@secondlayer\\/cli[\"']/g,\n\t\t\t`from '${replacementPath}'`,\n\t\t);\n\n\t\tconst { transformSync } = await import(\"esbuild\");\n\t\tconst result = transformSync(transformedCode, {\n\t\t\tformat: \"esm\",\n\t\t\ttarget: \"node18\",\n\t\t\tloader: \"ts\",\n\t\t});\n\n\t\tconst tempPath = path.join(\n\t\t\ttmpdir(),\n\t\t\t`secondlayer-config-${randomBytes(4).toString(\"hex\")}.mjs`,\n\t\t);\n\t\tawait fs.writeFile(tempPath, result.code);\n\n\t\ttry {\n\t\t\tconst fileUrl = pathToFileURL(tempPath).href;\n\t\t\tconst module = await import(fileUrl);\n\t\t\tconfig = module.default;\n\t\t} finally {\n\t\t\tawait fs.unlink(tempPath).catch(() => {});\n\t\t}\n\t} else {\n\t\tconst fileUrl = pathToFileURL(resolvedPath).href;\n\t\tconst module = await import(fileUrl);\n\t\tconfig = module.default;\n\t}\n\n\tif (!config) {\n\t\tthrow new Error(\"Config file must export a default configuration\");\n\t}\n\n\tif (typeof config === \"function\") {\n\t\tconfig = config({} as SecondLayerConfig);\n\t}\n\n\tvalidateConfig(config);\n\n\t// Process plugins if they exist\n\tconst pluginManager = new PluginManager();\n\n\tif (config.plugins && Array.isArray(config.plugins)) {\n\t\tfor (const plugin of config.plugins) {\n\t\t\tpluginManager.register(plugin);\n\t\t}\n\t}\n\n\t// Transform config through plugins\n\tconst resolvedConfig = await pluginManager.transformConfig(config);\n\n\treturn resolvedConfig;\n}\n\nexport function validateConfig(\n\tconfig: unknown,\n): asserts config is SecondLayerConfig {\n\tif (!config || typeof config !== \"object\") {\n\t\tthrow new Error(\"Config must be an object\");\n\t}\n\n\tconst c = config as any;\n\n\t// Contracts are optional now since plugins can provide them\n\tif (c.contracts && !Array.isArray(c.contracts)) {\n\t\tthrow new Error(\"Config contracts must be an array\");\n\t}\n\n\tif (!c.out || typeof c.out !== \"string\") {\n\t\tthrow new Error(\"Config out must be a string path\");\n\t}\n\n\t// Validate contracts if they exist\n\tif (c.contracts) {\n\t\tfor (const contract of c.contracts) {\n\t\t\tif (!contract.address && !contract.source) {\n\t\t\t\tthrow new Error(\"Each contract must have either an address or source\");\n\t\t\t}\n\t\t}\n\t}\n\n\t// Validate plugins if they exist\n\tif (c.plugins && !Array.isArray(c.plugins)) {\n\t\tthrow new Error(\"Config plugins must be an array\");\n\t}\n}\n\n/**\n * Type-safe helper for creating a `secondlayer.config.ts` configuration.\n * Accepts either a config object or a factory function that receives a base config and returns a modified one.\n *\n * @example\n * ```ts\n * import { defineConfig } from \"@secondlayer/cli\";\n *\n * export default defineConfig({\n *   contracts: [{ address: \"SP000000000000000000002Q6VF78.bns\" }],\n *   out: \"./src/generated.ts\",\n * });\n * ```\n */\nexport function defineConfig(config: SecondLayerConfig): SecondLayerConfig;\nexport function defineConfig(definer: ConfigDefiner): ConfigDefiner;\nexport function defineConfig(\n\tconfigOrDefiner: SecondLayerConfig | ConfigDefiner,\n) {\n\treturn configOrDefiner;\n}\n",
     "/**\n * Plugin Manager for @secondlayer/cli\n * Handles plugin registration, lifecycle execution, and output management\n */\n\nimport { promises as fs } from \"fs\";\nimport path from \"path\";\nimport { isValidAddress as _validateStacksAddress } from \"@secondlayer/stacks\";\nconst validateStacksAddress = _validateStacksAddress as (\n\taddress: string,\n) => boolean;\nimport { getErrorMessage } from \"@secondlayer/shared\";\nimport { toCamelCase } from \"@secondlayer/stacks/clarity\";\nimport type {\n\tContractConfig,\n\tGenerateContext,\n\tGeneratedOutput,\n\tHookResult,\n\tLogger,\n\tPluginExecutionContext,\n\tPluginUtils,\n\tProcessedContract,\n\tResolvedConfig,\n\tSecondLayerPlugin,\n\tUserConfig,\n} from \"../types/plugin\";\nimport { isClarinetContract, isDirectFileContract } from \"../types/plugin\";\nimport { parseContractId } from \"../utils/contract-id\";\n\n/**\n * Core plugin manager that orchestrates plugin execution\n */\nexport class PluginManager {\n\tprivate plugins: SecondLayerPlugin[] = [];\n\tprivate logger: Logger;\n\tprivate utils: PluginUtils;\n\tprivate executionContext: PluginExecutionContext;\n\n\tconstructor() {\n\t\tthis.logger = this.createLogger();\n\t\tthis.utils = this.createUtils();\n\t\tthis.executionContext = {\n\t\t\tphase: \"config\",\n\t\t\tstartTime: Date.now(),\n\t\t\tresults: new Map(),\n\t\t};\n\t}\n\n\t/**\n\t * Register a plugin\n\t */\n\tregister(plugin: SecondLayerPlugin): void {\n\t\t// Validate plugin\n\t\tif (!plugin.name || !plugin.version) {\n\t\t\tthrow new Error(\"Plugin must have a name and version\");\n\t\t}\n\n\t\t// Check for duplicate plugin names\n\t\tconst existing = this.plugins.find((p) => p.name === plugin.name);\n\t\tif (existing) {\n\t\t\tthrow new Error(\n\t\t\t\t`Plugin \"${plugin.name}\" is already registered (version ${existing.version})`,\n\t\t\t);\n\t\t}\n\n\t\tthis.plugins.push(plugin);\n\t\tthis.logger.debug(`Registered plugin: ${plugin.name}@${plugin.version}`);\n\t}\n\n\t/**\n\t * Get all registered plugins\n\t */\n\tgetPlugins(): SecondLayerPlugin[] {\n\t\treturn [...this.plugins];\n\t}\n\n\t/**\n\t * Transform user config through all plugins\n\t */\n\tasync transformConfig(config: UserConfig): Promise<ResolvedConfig> {\n\t\tthis.executionContext.phase = \"config\";\n\t\tlet transformedConfig = { ...config };\n\n\t\tfor (const plugin of this.plugins) {\n\t\t\tif (plugin.transformConfig) {\n\t\t\t\tthis.executionContext.currentPlugin = plugin;\n\t\t\t\ttry {\n\t\t\t\t\tconst result = await plugin.transformConfig(transformedConfig);\n\t\t\t\t\ttransformedConfig = result;\n\t\t\t\t\tthis.recordHookResult(plugin.name, \"transformConfig\", {\n\t\t\t\t\t\tsuccess: true,\n\t\t\t\t\t});\n\t\t\t\t} catch (error) {\n\t\t\t\t\tthis.recordHookResult(plugin.name, \"transformConfig\", {\n\t\t\t\t\t\tsuccess: false,\n\t\t\t\t\t\terror:\n\t\t\t\t\t\t\terror instanceof Error\n\t\t\t\t\t\t\t\t? error\n\t\t\t\t\t\t\t\t: new Error(getErrorMessage(error)),\n\t\t\t\t\t});\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`Plugin \"${plugin.name}\" failed during config transformation: ${getErrorMessage(error)}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Add plugins array to resolved config\n\t\tconst resolvedConfig: ResolvedConfig = {\n\t\t\t...transformedConfig,\n\t\t\tplugins: this.plugins,\n\t\t};\n\n\t\treturn resolvedConfig;\n\t}\n\n\t/**\n\t * Transform contracts through all plugins\n\t */\n\tasync transformContracts(\n\t\tcontracts: ContractConfig[],\n\t\t_config: ResolvedConfig,\n\t): Promise<ProcessedContract[]> {\n\t\tconst processedContracts: ProcessedContract[] = [];\n\n\t\tfor (let contract of contracts) {\n\t\t\tif (isClarinetContract(contract) && contract.abi) {\n\t\t\t\tprocessedContracts.push(this.contractToProcessed(contract, \"clarinet\"));\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (isDirectFileContract(contract) && contract.abi) {\n\t\t\t\tprocessedContracts.push(this.contractToProcessed(contract, \"direct\"));\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Transform through each plugin\n\t\t\tfor (const plugin of this.plugins) {\n\t\t\t\tif (plugin.transformContract) {\n\t\t\t\t\tthis.executionContext.currentPlugin = plugin;\n\t\t\t\t\ttry {\n\t\t\t\t\t\tcontract = await plugin.transformContract(contract);\n\t\t\t\t\t\tthis.recordHookResult(plugin.name, \"transformContract\", {\n\t\t\t\t\t\t\tsuccess: true,\n\t\t\t\t\t\t});\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tthis.recordHookResult(plugin.name, \"transformContract\", {\n\t\t\t\t\t\t\tsuccess: false,\n\t\t\t\t\t\t\terror:\n\t\t\t\t\t\t\t\terror instanceof Error\n\t\t\t\t\t\t\t\t\t? error\n\t\t\t\t\t\t\t\t\t: new Error(getErrorMessage(error)),\n\t\t\t\t\t\t});\n\t\t\t\t\t\tthis.logger.warn(\n\t\t\t\t\t\t\t`Plugin \"${plugin.name}\" failed to transform contract: ${getErrorMessage(error)}`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (contract.abi) {\n\t\t\t\tprocessedContracts.push(this.contractToProcessed(contract, \"api\"));\n\t\t\t}\n\t\t}\n\n\t\treturn processedContracts;\n\t}\n\n\t/**\n\t * Execute lifecycle hooks\n\t */\n\tasync executeHook(\n\t\thookName: keyof SecondLayerPlugin,\n\t\tcontext: any,\n\t): Promise<void> {\n\t\tfor (const plugin of this.plugins) {\n\t\t\tconst hook = plugin[hookName];\n\t\t\tif (typeof hook === \"function\") {\n\t\t\t\tthis.executionContext.currentPlugin = plugin;\n\t\t\t\ttry {\n\t\t\t\t\tawait (hook as any).call(plugin, context);\n\t\t\t\t\tthis.recordHookResult(plugin.name, hookName as string, {\n\t\t\t\t\t\tsuccess: true,\n\t\t\t\t\t});\n\t\t\t\t} catch (error) {\n\t\t\t\t\tthis.recordHookResult(plugin.name, hookName as string, {\n\t\t\t\t\t\tsuccess: false,\n\t\t\t\t\t\terror:\n\t\t\t\t\t\t\terror instanceof Error\n\t\t\t\t\t\t\t\t? error\n\t\t\t\t\t\t\t\t: new Error(getErrorMessage(error)),\n\t\t\t\t\t});\n\t\t\t\t\tthis.logger.error(\n\t\t\t\t\t\t`Plugin \"${plugin.name}\" failed during ${hookName as string}: ${getErrorMessage(error)}`,\n\t\t\t\t\t);\n\t\t\t\t\t// Don't throw - allow other plugins to continue\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Execute generation phase with full context\n\t */\n\tasync executeGeneration(\n\t\tcontracts: ProcessedContract[],\n\t\tconfig: ResolvedConfig,\n\t): Promise<Map<string, GeneratedOutput>> {\n\t\tthis.executionContext.phase = \"generate\";\n\t\tconst outputs = new Map<string, GeneratedOutput>();\n\n\t\t// Create generation context\n\t\tconst context: GenerateContext = {\n\t\t\tconfig,\n\t\t\tlogger: this.logger,\n\t\t\tutils: this.utils,\n\t\t\tcontracts,\n\t\t\toutputs,\n\t\t\taugment: (outputKey: string, contractName: string, content: any) => {\n\t\t\t\tthis.augmentOutput(outputs, outputKey, contractName, content);\n\t\t\t},\n\t\t\taddOutput: (key: string, output: GeneratedOutput) => {\n\t\t\t\toutputs.set(key, output);\n\t\t\t},\n\t\t};\n\n\t\t// Execute beforeGenerate hooks\n\t\tawait this.executeHook(\"beforeGenerate\", context);\n\n\t\t// Execute generate hooks\n\t\tawait this.executeHook(\"generate\", context);\n\n\t\t// Execute afterGenerate hooks\n\t\tawait this.executeHook(\"afterGenerate\", context);\n\n\t\treturn outputs;\n\t}\n\n\t/**\n\t * Transform outputs through plugins\n\t */\n\tasync transformOutputs(\n\t\toutputs: Map<string, GeneratedOutput>,\n\t): Promise<Map<string, GeneratedOutput>> {\n\t\tthis.executionContext.phase = \"output\";\n\t\tconst transformedOutputs = new Map<string, GeneratedOutput>();\n\n\t\tfor (const [key, output] of outputs) {\n\t\t\tlet transformedContent = output.content;\n\n\t\t\tfor (const plugin of this.plugins) {\n\t\t\t\tif (plugin.transformOutput) {\n\t\t\t\t\tthis.executionContext.currentPlugin = plugin;\n\t\t\t\t\ttry {\n\t\t\t\t\t\ttransformedContent = await plugin.transformOutput(\n\t\t\t\t\t\t\ttransformedContent,\n\t\t\t\t\t\t\toutput.type || \"other\",\n\t\t\t\t\t\t);\n\t\t\t\t\t\tthis.recordHookResult(plugin.name, \"transformOutput\", {\n\t\t\t\t\t\t\tsuccess: true,\n\t\t\t\t\t\t});\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tthis.recordHookResult(plugin.name, \"transformOutput\", {\n\t\t\t\t\t\t\tsuccess: false,\n\t\t\t\t\t\t\terror:\n\t\t\t\t\t\t\t\terror instanceof Error\n\t\t\t\t\t\t\t\t\t? error\n\t\t\t\t\t\t\t\t\t: new Error(getErrorMessage(error)),\n\t\t\t\t\t\t});\n\t\t\t\t\t\tthis.logger.warn(\n\t\t\t\t\t\t\t`Plugin \"${plugin.name}\" failed to transform output: ${getErrorMessage(error)}`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\ttransformedOutputs.set(key, {\n\t\t\t\t...output,\n\t\t\t\tcontent: transformedContent,\n\t\t\t});\n\t\t}\n\n\t\treturn transformedOutputs;\n\t}\n\n\t/**\n\t * Write outputs to disk\n\t */\n\tasync writeOutputs(outputs: Map<string, GeneratedOutput>): Promise<void> {\n\t\tfor (const [, output] of outputs) {\n\t\t\ttry {\n\t\t\t\tconst resolvedPath = path.resolve(process.cwd(), output.path);\n\t\t\t\tawait this.utils.ensureDir(path.dirname(resolvedPath));\n\t\t\t\tawait this.utils.writeFile(resolvedPath, output.content);\n\t\t\t\t// Don't log here - let the main command handle success messaging\n\t\t\t} catch (error) {\n\t\t\t\tthis.logger.error(\n\t\t\t\t\t`Failed to write ${output.path}: ${getErrorMessage(error)}`,\n\t\t\t\t);\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Get execution results for debugging\n\t */\n\tgetExecutionResults(): Map<string, HookResult[]> {\n\t\treturn new Map(this.executionContext.results);\n\t}\n\n\t/**\n\t * Convert a contract config with an ABI into a ProcessedContract\n\t */\n\tprivate contractToProcessed(\n\t\tcontract: ContractConfig,\n\t\tsource: string,\n\t): ProcessedContract {\n\t\tconst address =\n\t\t\ttypeof contract.address === \"string\" ? contract.address : \"\";\n\t\tconst parsed = parseContractId(address);\n\t\treturn {\n\t\t\tname: contract.name || parsed.contractName || \"unknown\",\n\t\t\taddress: parsed.address || \"unknown\",\n\t\t\tcontractName: parsed.contractName || contract.name || \"unknown\",\n\t\t\tabi: contract.abi!,\n\t\t\tsource: source === \"api\" ? (\"api\" as const) : (\"local\" as const),\n\t\t\tmetadata: contract.metadata ?? { source },\n\t\t};\n\t}\n\n\t/**\n\t * Augment existing output with additional content\n\t */\n\tprivate augmentOutput(\n\t\toutputs: Map<string, GeneratedOutput>,\n\t\toutputKey: string,\n\t\tcontractName: string,\n\t\tcontent: any,\n\t): void {\n\t\tconst existing = outputs.get(outputKey);\n\t\tif (!existing) {\n\t\t\tthis.logger.warn(`Cannot augment non-existent output: ${outputKey}`);\n\t\t\treturn;\n\t\t}\n\n\t\t// Simple augmentation - append content\n\t\t// In a real implementation, this would be more sophisticated\n\t\tconst augmentedContent = `${existing.content}\\n\\n// Augmented by plugin for ${contractName}\\n${JSON.stringify(content, null, 2)}`;\n\n\t\toutputs.set(outputKey, {\n\t\t\t...existing,\n\t\t\tcontent: augmentedContent,\n\t\t});\n\t}\n\n\t/**\n\t * Record hook execution result\n\t */\n\tprivate recordHookResult(\n\t\tpluginName: string,\n\t\thookName: string,\n\t\tresult: Omit<HookResult, \"plugin\">,\n\t): void {\n\t\tconst key = `${pluginName}:${hookName}`;\n\t\tconst existing = this.executionContext.results.get(key) || [];\n\t\texisting.push({ ...result, plugin: pluginName });\n\t\tthis.executionContext.results.set(key, existing);\n\t}\n\n\t/**\n\t * Create logger instance\n\t */\n\tprivate createLogger(): Logger {\n\t\treturn {\n\t\t\tinfo: (message: string) => console.log(`ℹ️  ${message}`),\n\t\t\twarn: (message: string) => console.warn(`⚠️  ${message}`),\n\t\t\terror: (message: string) => console.error(`❌ ${message}`),\n\t\t\tdebug: (message: string) => {\n\t\t\t\tif (process.env.DEBUG) {\n\t\t\t\t\tconsole.log(`🐛 ${message}`);\n\t\t\t\t}\n\t\t\t},\n\t\t\tsuccess: (message: string) => console.log(`✅ ${message}`),\n\t\t};\n\t}\n\n\t/**\n\t * Create utils instance\n\t */\n\tprivate createUtils(): PluginUtils {\n\t\treturn {\n\t\t\ttoCamelCase,\n\n\t\t\ttoKebabCase: (str: string) => {\n\t\t\t\treturn str.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);\n\t\t\t},\n\n\t\t\tvalidateAddress: (address: string) => {\n\t\t\t\treturn validateStacksAddress(parseContractId(address).address);\n\t\t\t},\n\n\t\t\tparseContractId: (contractId: string) => {\n\t\t\t\treturn parseContractId(contractId);\n\t\t\t},\n\n\t\t\tformatCode: async (code: string) => {\n\t\t\t\tconst { formatCode } = await import(\"../utils/format\");\n\t\t\t\treturn formatCode(code);\n\t\t\t},\n\n\t\t\tresolvePath: (relativePath: string) => {\n\t\t\t\treturn path.resolve(process.cwd(), relativePath);\n\t\t\t},\n\n\t\t\tfileExists: async (filePath: string) => {\n\t\t\t\ttry {\n\t\t\t\t\tawait fs.access(filePath);\n\t\t\t\t\treturn true;\n\t\t\t\t} catch {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t},\n\n\t\t\treadFile: async (filePath: string) => {\n\t\t\t\treturn fs.readFile(filePath, \"utf-8\");\n\t\t\t},\n\n\t\t\twriteFile: async (filePath: string, content: string) => {\n\t\t\t\tawait fs.writeFile(filePath, content, \"utf-8\");\n\t\t\t},\n\n\t\t\tensureDir: async (dirPath: string) => {\n\t\t\t\tawait fs.mkdir(dirPath, { recursive: true });\n\t\t\t},\n\t\t};\n\t}\n}\n",
-    "/**\n * Plugin system types for @secondlayer/cli\n */\n\nimport type { AbiContract } from \"@secondlayer/stacks/clarity\";\nimport type {\n\tNetworkName,\n\tResolvedContract,\n\tSecondLayerConfig,\n} from \"./config\";\n\n/**\n * Core plugin interface that all plugins must implement\n */\nexport interface SecondLayerPlugin {\n\t/** Plugin name (should be unique) */\n\tname: string;\n\n\t/** Plugin version */\n\tversion: string;\n\n\t// Lifecycle hooks\n\t/** Called after config is resolved but before generation starts */\n\tconfigResolved?: (config: ResolvedConfig) => void | Promise<void>;\n\n\t/** Called before generation starts */\n\tbeforeGenerate?: (context: GenerateContext) => void | Promise<void>;\n\n\t/** Called during generation phase - plugins can add their own outputs */\n\tgenerate?: (context: GenerateContext) => void | Promise<void>;\n\n\t/** Called after all generation is complete */\n\tafterGenerate?: (context: GenerateContext) => void | Promise<void>;\n\n\t// Transform hooks\n\t/** Transform user config before resolution */\n\ttransformConfig?: (config: UserConfig) => UserConfig | Promise<UserConfig>;\n\n\t/** Transform individual contracts during processing */\n\ttransformContract?: (\n\t\tcontract: ContractConfig,\n\t) => ContractConfig | Promise<ContractConfig>;\n\n\t/** Transform generated output before writing to disk */\n\ttransformOutput?: (\n\t\toutput: string,\n\t\ttype: OutputType,\n\t) => string | Promise<string>;\n}\n\n/**\n * User configuration (before plugin transformations)\n */\nexport type UserConfig = SecondLayerConfig;\n\n/**\n * Resolved configuration (after plugin transformations)\n */\nexport interface ResolvedConfig extends SecondLayerConfig {\n\t/** Resolved plugins array */\n\tplugins: SecondLayerPlugin[];\n}\n\n/**\n * Contract configuration that can be transformed by plugins\n */\nexport interface ContractConfig {\n\tname?: string;\n\taddress?: string | Partial<Record<NetworkName, string>>;\n\tsource?: string;\n\tabi?: AbiContract;\n\tmetadata?: Record<string, any>;\n}\n\n/**\n * Contract config from Clarinet plugin\n */\nexport interface ClarinetContractConfig extends ContractConfig {\n\t_clarinetSource: true;\n}\n\n/**\n * Contract config from direct file input\n */\nexport interface DirectFileContractConfig extends ContractConfig {\n\t_directFile: true;\n}\n\n/**\n * Union of all contract config types\n */\nexport type PluginContractConfig =\n\t| ContractConfig\n\t| ClarinetContractConfig\n\t| DirectFileContractConfig;\n\n/**\n * Type guard for Clarinet contracts\n */\nexport function isClarinetContract(\n\tc: ContractConfig,\n): c is ClarinetContractConfig {\n\treturn \"_clarinetSource\" in c && c._clarinetSource === true;\n}\n\n/**\n * Type guard for direct file contracts\n */\nexport function isDirectFileContract(\n\tc: ContractConfig,\n): c is DirectFileContractConfig {\n\treturn \"_directFile\" in c && c._directFile === true;\n}\n\n/**\n * Processed contract with resolved ABI and metadata\n */\nexport interface ProcessedContract extends ResolvedContract {\n\t/** Additional metadata added by plugins */\n\tmetadata?: Record<string, any>;\n}\n\n/**\n * Generated output from plugins\n */\nexport interface GeneratedOutput {\n\t/** File path where output should be written */\n\tpath: string;\n\n\t/** Generated content */\n\tcontent: string;\n\n\t/** Output type for transformation hooks */\n\ttype?: OutputType;\n\n\t/** Whether this output should overwrite existing files */\n\toverwrite?: boolean;\n}\n\n/**\n * Types of outputs that can be generated\n */\nexport type OutputType =\n\t| \"contracts\"\n\t| \"hooks\"\n\t| \"actions\"\n\t| \"types\"\n\t| \"utils\"\n\t| \"config\"\n\t| \"other\";\n\n/**\n * Base context available to all plugin hooks\n */\nexport interface PluginContext {\n\t/** Resolved configuration */\n\tconfig: ResolvedConfig;\n\n\t/** Logger for plugin output */\n\tlogger: Logger;\n\n\t/** Utility functions for plugins */\n\tutils: PluginUtils;\n}\n\n/**\n * Context available during generation phase\n */\nexport interface GenerateContext extends PluginContext {\n\t/** Processed contracts ready for generation */\n\tcontracts: ProcessedContract[];\n\n\t/** Map of output keys to generated content */\n\toutputs: Map<string, GeneratedOutput>;\n\n\t/** Function to augment existing outputs */\n\taugment: (outputKey: string, contractName: string, content: any) => void;\n\n\t/** Function to add new outputs */\n\taddOutput: (key: string, output: GeneratedOutput) => void;\n}\n\n/**\n * Logger interface for plugin output\n */\nexport interface Logger {\n\tinfo: (message: string) => void;\n\twarn: (message: string) => void;\n\terror: (message: string) => void;\n\tdebug: (message: string) => void;\n\tsuccess: (message: string) => void;\n}\n\n/**\n * Utility functions available to plugins\n */\nexport interface PluginUtils {\n\t/** Convert kebab-case to camelCase */\n\ttoCamelCase: (str: string) => string;\n\n\t/** Convert camelCase to kebab-case */\n\ttoKebabCase: (str: string) => string;\n\n\t/** Validate Stacks address format */\n\tvalidateAddress: (address: string) => boolean;\n\n\t/** Parse contract identifier (address.contract-name) */\n\tparseContractId: (contractId: string) => {\n\t\taddress: string;\n\t\tcontractName: string;\n\t};\n\n\t/** Format TypeScript code using prettier */\n\tformatCode: (code: string) => Promise<string>;\n\n\t/** Resolve file path relative to project root */\n\tresolvePath: (relativePath: string) => string;\n\n\t/** Check if file exists */\n\tfileExists: (path: string) => Promise<boolean>;\n\n\t/** Read file content */\n\treadFile: (path: string) => Promise<string>;\n\n\t/** Write file content */\n\twriteFile: (path: string, content: string) => Promise<void>;\n\n\t/** Create directory recursively */\n\tensureDir: (path: string) => Promise<void>;\n}\n\n/**\n * Plugin factory function type for creating plugins with options\n */\nexport type PluginFactory<TOptions = any> = (\n\toptions?: TOptions,\n) => SecondLayerPlugin;\n\n/**\n * Plugin options base interface\n */\nexport interface PluginOptions {\n\t/** Include only specific contracts/functions */\n\tinclude?: string[];\n\n\t/** Exclude specific contracts/functions */\n\texclude?: string[];\n\n\t/** Enable debug output */\n\tdebug?: boolean;\n}\n\n/**\n * Hook execution result\n */\nexport interface HookResult<T = any> {\n\t/** Whether the hook was successful */\n\tsuccess: boolean;\n\n\t/** Result data from the hook */\n\tdata?: T;\n\n\t/** Error if hook failed */\n\terror?: Error;\n\n\t/** Plugin that executed the hook */\n\tplugin: string;\n}\n\n/**\n * Plugin execution context for internal use\n */\nexport interface PluginExecutionContext {\n\t/** Current plugin being executed */\n\tcurrentPlugin?: SecondLayerPlugin;\n\n\t/** Execution phase */\n\tphase: \"config\" | \"generate\" | \"output\";\n\n\t/** Start time for performance tracking */\n\tstartTime: number;\n\n\t/** Plugin execution results */\n\tresults: Map<string, HookResult[]>;\n}\n",
-    "/**\n * Parse a fully-qualified contract ID (\"address.contractName\") into its parts.\n * Throws if the input doesn't contain a dot separator.\n */\nexport function parseContractId(contractId: string): {\n\taddress: string;\n\tcontractName: string;\n} {\n\tconst dotIndex = contractId.indexOf(\".\");\n\tif (dotIndex === -1) {\n\t\tthrow new Error(\n\t\t\t`Invalid contract ID: \"${contractId}\" (expected \"address.contractName\")`,\n\t\t);\n\t}\n\treturn {\n\t\taddress: contractId.slice(0, dotIndex),\n\t\tcontractName: contractId.slice(dotIndex + 1),\n\t};\n}\n"
+    "import { randomBytes } from \"crypto\";\nimport { promises as fs } from \"fs\";\nimport { createRequire } from \"module\";\nimport { tmpdir } from \"os\";\nimport path from \"path\";\nimport { pathToFileURL } from \"url\";\nimport { PluginManager } from \"../core/plugin-manager\";\nimport type { ConfigDefiner, SecondLayerConfig } from \"../types/config\";\nimport type { ResolvedConfig } from \"../types/plugin\";\n\n/**\n * Config file utilities\n */\n\nconst CONFIG_FILE_NAMES = [\n\t\"secondlayer.config.ts\",\n\t\"secondlayer.config\",\n\t\"secondlayer.config.mjs\",\n];\n\nexport async function findConfigFile(cwd: string): Promise<string | null> {\n\tfor (const fileName of CONFIG_FILE_NAMES) {\n\t\tconst filePath = path.join(cwd, fileName);\n\t\ttry {\n\t\t\tawait fs.access(filePath);\n\t\t\treturn filePath;\n\t\t} catch {\n\t\t\t// File doesn't exist, continue\n\t\t}\n\t}\n\treturn null;\n}\n\nexport async function loadConfig(configPath?: string): Promise<ResolvedConfig> {\n\tconst cwd = process.cwd();\n\n\tconst resolvedPath = configPath\n\t\t? path.resolve(cwd, configPath)\n\t\t: await findConfigFile(cwd);\n\n\tif (!resolvedPath) {\n\t\tthrow new Error(\n\t\t\t\"No config file found. Create a secondlayer.config.ts file or specify a path with --config\",\n\t\t);\n\t}\n\n\tlet config: any;\n\n\tif (resolvedPath.endsWith(\".ts\")) {\n\t\tconst code = await fs.readFile(resolvedPath, \"utf-8\");\n\n\t\t// Transform TypeScript to JavaScript, replacing the @secondlayer/cli import\n\t\t// For development/linked packages, we need to resolve to the actual package location\n\t\t// This will work both for published packages and local development\n\t\tlet replacementPath: string;\n\n\t\ttry {\n\t\t\t// Try to resolve @secondlayer/cli as if it were a normal package\n\t\t\tconst require = createRequire(import.meta.url);\n\t\t\tconst packagePath = require.resolve(\"@secondlayer/cli\");\n\t\t\treplacementPath = pathToFileURL(packagePath).href;\n\t\t} catch {\n\t\t\t// Fallback: resolve relative to current module (for development)\n\t\t\tconst currentModuleDir = path.dirname(new URL(import.meta.url).pathname);\n\t\t\tconst indexPath = path.resolve(currentModuleDir, \"../index\");\n\t\t\treplacementPath = pathToFileURL(indexPath).href;\n\t\t}\n\n\t\tconst transformedCode = code.replace(\n\t\t\t/from\\s+[\"']@secondlayer\\/cli[\"']/g,\n\t\t\t`from '${replacementPath}'`,\n\t\t);\n\n\t\tconst { transformSync } = await import(\"esbuild\");\n\t\tconst result = transformSync(transformedCode, {\n\t\t\tformat: \"esm\",\n\t\t\ttarget: \"node18\",\n\t\t\tloader: \"ts\",\n\t\t});\n\n\t\tconst tempPath = path.join(\n\t\t\ttmpdir(),\n\t\t\t`secondlayer-config-${randomBytes(4).toString(\"hex\")}.mjs`,\n\t\t);\n\t\tawait fs.writeFile(tempPath, result.code);\n\n\t\ttry {\n\t\t\tconst fileUrl = pathToFileURL(tempPath).href;\n\t\t\tconst module = await import(fileUrl);\n\t\t\tconfig = module.default;\n\t\t} finally {\n\t\t\tawait fs.unlink(tempPath).catch(() => {});\n\t\t}\n\t} else {\n\t\tconst fileUrl = pathToFileURL(resolvedPath).href;\n\t\tconst module = await import(fileUrl);\n\t\tconfig = module.default;\n\t}\n\n\tif (!config) {\n\t\tthrow new Error(\"Config file must export a default configuration\");\n\t}\n\n\tif (typeof config === \"function\") {\n\t\tconfig = config({} as SecondLayerConfig);\n\t}\n\n\tvalidateConfig(config);\n\n\t// Process plugins if they exist\n\tconst pluginManager = new PluginManager();\n\n\tif (config.plugins && Array.isArray(config.plugins)) {\n\t\tfor (const plugin of config.plugins) {\n\t\t\tpluginManager.register(plugin);\n\t\t}\n\t}\n\n\t// Transform config through plugins\n\tconst resolvedConfig = await pluginManager.transformConfig(config);\n\n\treturn resolvedConfig;\n}\n\nexport function validateConfig(\n\tconfig: unknown,\n): asserts config is SecondLayerConfig {\n\tif (!config || typeof config !== \"object\") {\n\t\tthrow new Error(\"Config must be an object\");\n\t}\n\n\tconst c = config as any;\n\n\t// Contracts are optional now since plugins can provide them\n\tif (c.contracts && !Array.isArray(c.contracts)) {\n\t\tthrow new Error(\"Config contracts must be an array\");\n\t}\n\n\tif (!c.out || typeof c.out !== \"string\") {\n\t\tthrow new Error(\"Config out must be a string path\");\n\t}\n\n\t// Validate contracts if they exist\n\tif (c.contracts) {\n\t\tfor (const contract of c.contracts) {\n\t\t\tif (!contract.address && !contract.source) {\n\t\t\t\tthrow new Error(\"Each contract must have either an address or source\");\n\t\t\t}\n\t\t}\n\t}\n\n\t// Validate plugins if they exist\n\tif (c.plugins && !Array.isArray(c.plugins)) {\n\t\tthrow new Error(\"Config plugins must be an array\");\n\t}\n}\n\n/**\n * Type-safe helper for creating a `secondlayer.config.ts` configuration.\n * Accepts either a config object or a factory function that receives a base config and returns a modified one.\n *\n * @example\n * ```ts\n * import { defineConfig } from \"@secondlayer/cli\";\n *\n * export default defineConfig({\n *   contracts: [{ address: \"SP000000000000000000002Q6VF78.bns\" }],\n *   out: \"./src/generated.ts\",\n * });\n * ```\n */\nexport function defineConfig(config: SecondLayerConfig): SecondLayerConfig;\nexport function defineConfig(definer: ConfigDefiner): ConfigDefiner;\nexport function defineConfig(\n\tconfigOrDefiner: SecondLayerConfig | ConfigDefiner,\n) {\n\treturn configOrDefiner;\n}\n",
+    "/**\n * @secondlayer/cli\n * CLI tool for generating type-safe Stacks contract interfaces\n */\n\nexport { defineConfig } from \"./utils/config\";\nexport type {\n\tSecondLayerConfig,\n\tContractSource,\n\tNetworkName,\n} from \"./types/config\";\n\nexport type {\n\tAbiContract,\n\tAbiFunction,\n\tAbiType,\n} from \"@secondlayer/stacks/clarity\";\n\n// Plugin system exports\nexport type {\n\tSecondLayerPlugin,\n\tPluginFactory,\n\tPluginOptions,\n\tUserConfig,\n\tResolvedConfig,\n\tGenerateContext,\n\tPluginContext,\n\tLogger,\n\tPluginUtils,\n\tGeneratedOutput,\n\tProcessedContract,\n\tContractConfig,\n\tOutputType,\n} from \"./types/plugin\";\n\nexport { PluginManager } from \"./core/plugin-manager\";\n"
   ],
-  "mappings": "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",
-  "debugId": "6FDA39721A22F05264756E2164756E21",
+  "mappings": "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",
+  "debugId": "AF644CA8AC7B439C64756E2164756E21",
   "names": []
 }

package/dist/plugins/index.d.ts

@@ -0,0 +1,364 @@
+import { AbiContract as AbiContract2 } from "@secondlayer/stacks/clarity";
+import { AbiContract } from "@secondlayer/stacks/clarity";
+/** Supported Stacks network identifiers for contract resolution. */
+type NetworkName = "mainnet" | "testnet" | "devnet";
+/** Specifies a contract to generate typed interfaces for, either from a deployed address or local Clarity source file. */
+interface ContractSource {
+	/**
+	* Contract identifier (address.name) for deployed contracts
+	*/
+	address?: string | Partial<Record<NetworkName, string>>;
+	/**
+	* Path to local Clarity file
+	*/
+	source?: string;
+	/**
+	* Optional name to use in generated code
+	*/
+	name?: string;
+}
+/** Configuration for the `@secondlayer/cli` code generator. Defines which contracts to process, output paths, network settings, and plugins. */
+interface SecondLayerConfig {
+	/**
+	* Contracts to generate interfaces for (optional - plugins can provide these)
+	*/
+	contracts?: ContractSource[];
+	/**
+	* Output file path
+	*/
+	out: string;
+	/**
+	* Plugins to use for generation
+	*/
+	plugins?: any[];
+	/**
+	* Network to use for fetching contracts
+	*/
+	network?: NetworkName;
+	/**
+	* API key for Stacks API (if required)
+	*/
+	apiKey?: string;
+	/**
+	* Base URL for Stacks API (optional override)
+	*/
+	apiUrl?: string;
+	/**
+	* Default deployer address for local contracts without explicit addresses
+	* Defaults to ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM (devnet default)
+	*/
+	defaultAddress?: string;
+}
+interface ResolvedContract {
+	name: string;
+	address: string;
+	contractName: string;
+	abi: AbiContract;
+	source: "api" | "local";
+}
+/**
+* Core plugin interface that all plugins must implement
+*/
+interface SecondLayerPlugin {
+	/** Plugin name (should be unique) */
+	name: string;
+	/** Plugin version */
+	version: string;
+	/** Called after config is resolved but before generation starts */
+	configResolved?: (config: ResolvedConfig) => void | Promise<void>;
+	/** Called before generation starts */
+	beforeGenerate?: (context: GenerateContext) => void | Promise<void>;
+	/** Called during generation phase - plugins can add their own outputs */
+	generate?: (context: GenerateContext) => void | Promise<void>;
+	/** Called after all generation is complete */
+	afterGenerate?: (context: GenerateContext) => void | Promise<void>;
+	/** Transform user config before resolution */
+	transformConfig?: (config: UserConfig) => UserConfig | Promise<UserConfig>;
+	/** Transform individual contracts during processing */
+	transformContract?: (contract: ContractConfig) => ContractConfig | Promise<ContractConfig>;
+	/** Transform generated output before writing to disk */
+	transformOutput?: (output: string, type: OutputType) => string | Promise<string>;
+}
+/**
+* User configuration (before plugin transformations)
+*/
+type UserConfig = SecondLayerConfig;
+/**
+* Resolved configuration (after plugin transformations)
+*/
+interface ResolvedConfig extends SecondLayerConfig {
+	/** Resolved plugins array */
+	plugins: SecondLayerPlugin[];
+}
+/**
+* Contract configuration that can be transformed by plugins
+*/
+interface ContractConfig {
+	name?: string;
+	address?: string | Partial<Record<NetworkName, string>>;
+	source?: string;
+	abi?: AbiContract2;
+	metadata?: Record<string, any>;
+}
+/**
+* Processed contract with resolved ABI and metadata
+*/
+interface ProcessedContract extends ResolvedContract {
+	/** Additional metadata added by plugins */
+	metadata?: Record<string, any>;
+}
+/**
+* Generated output from plugins
+*/
+interface GeneratedOutput {
+	/** File path where output should be written */
+	path: string;
+	/** Generated content */
+	content: string;
+	/** Output type for transformation hooks */
+	type?: OutputType;
+	/** Whether this output should overwrite existing files */
+	overwrite?: boolean;
+}
+/**
+* Types of outputs that can be generated
+*/
+type OutputType = "contracts" | "hooks" | "actions" | "types" | "utils" | "config" | "other";
+/**
+* Base context available to all plugin hooks
+*/
+interface PluginContext {
+	/** Resolved configuration */
+	config: ResolvedConfig;
+	/** Logger for plugin output */
+	logger: Logger;
+	/** Utility functions for plugins */
+	utils: PluginUtils;
+}
+/**
+* Context available during generation phase
+*/
+interface GenerateContext extends PluginContext {
+	/** Processed contracts ready for generation */
+	contracts: ProcessedContract[];
+	/** Map of output keys to generated content */
+	outputs: Map<string, GeneratedOutput>;
+	/** Function to augment existing outputs */
+	augment: (outputKey: string, contractName: string, content: any) => void;
+	/** Function to add new outputs */
+	addOutput: (key: string, output: GeneratedOutput) => void;
+}
+/**
+* Logger interface for plugin output
+*/
+interface Logger {
+	info: (message: string) => void;
+	warn: (message: string) => void;
+	error: (message: string) => void;
+	debug: (message: string) => void;
+	success: (message: string) => void;
+}
+/**
+* Utility functions available to plugins
+*/
+interface PluginUtils {
+	/** Convert kebab-case to camelCase */
+	toCamelCase: (str: string) => string;
+	/** Convert camelCase to kebab-case */
+	toKebabCase: (str: string) => string;
+	/** Validate Stacks address format */
+	validateAddress: (address: string) => boolean;
+	/** Parse contract identifier (address.contract-name) */
+	parseContractId: (contractId: string) => {
+		address: string
+		contractName: string
+	};
+	/** Format TypeScript code using prettier */
+	formatCode: (code: string) => Promise<string>;
+	/** Resolve file path relative to project root */
+	resolvePath: (relativePath: string) => string;
+	/** Check if file exists */
+	fileExists: (path: string) => Promise<boolean>;
+	/** Read file content */
+	readFile: (path: string) => Promise<string>;
+	/** Write file content */
+	writeFile: (path: string, content: string) => Promise<void>;
+	/** Create directory recursively */
+	ensureDir: (path: string) => Promise<void>;
+}
+/**
+* Plugin factory function type for creating plugins with options
+*/
+type PluginFactory<TOptions = any> = (options?: TOptions) => SecondLayerPlugin;
+/**
+* Plugin options base interface
+*/
+interface PluginOptions {
+	/** Include only specific contracts/functions */
+	include?: string[];
+	/** Exclude specific contracts/functions */
+	exclude?: string[];
+	/** Enable debug output */
+	debug?: boolean;
+}
+/**
+* Hook execution result
+*/
+interface HookResult<T = any> {
+	/** Whether the hook was successful */
+	success: boolean;
+	/** Result data from the hook */
+	data?: T;
+	/** Error if hook failed */
+	error?: Error;
+	/** Plugin that executed the hook */
+	plugin: string;
+}
+/**
+* Core plugin manager that orchestrates plugin execution
+*/
+declare class PluginManager {
+	private plugins;
+	private logger;
+	private utils;
+	private executionContext;
+	constructor();
+	/**
+	* Register a plugin
+	*/
+	register(plugin: SecondLayerPlugin): void;
+	/**
+	* Get all registered plugins
+	*/
+	getPlugins(): SecondLayerPlugin[];
+	/**
+	* Transform user config through all plugins
+	*/
+	transformConfig(config: UserConfig): Promise<ResolvedConfig>;
+	/**
+	* Transform contracts through all plugins
+	*/
+	transformContracts(contracts: ContractConfig[], _config: ResolvedConfig): Promise<ProcessedContract[]>;
+	/**
+	* Execute lifecycle hooks
+	*/
+	executeHook(hookName: keyof SecondLayerPlugin, context: any): Promise<void>;
+	/**
+	* Execute generation phase with full context
+	*/
+	executeGeneration(contracts: ProcessedContract[], config: ResolvedConfig): Promise<Map<string, GeneratedOutput>>;
+	/**
+	* Transform outputs through plugins
+	*/
+	transformOutputs(outputs: Map<string, GeneratedOutput>): Promise<Map<string, GeneratedOutput>>;
+	/**
+	* Write outputs to disk
+	*/
+	writeOutputs(outputs: Map<string, GeneratedOutput>): Promise<void>;
+	/**
+	* Get execution results for debugging
+	*/
+	getExecutionResults(): Map<string, HookResult[]>;
+	/**
+	* Convert a contract config with an ABI into a ProcessedContract
+	*/
+	private contractToProcessed;
+	/**
+	* Augment existing output with additional content
+	*/
+	private augmentOutput;
+	/**
+	* Record hook execution result
+	*/
+	private recordHookResult;
+	/**
+	* Create logger instance
+	*/
+	private createLogger;
+	/**
+	* Create utils instance
+	*/
+	private createUtils;
+}
+interface ClarinetPluginOptions {
+	/** Path to Clarinet.toml file */
+	path?: string;
+	/** Include only specific contracts */
+	include?: string[];
+	/** Exclude specific contracts */
+	exclude?: string[];
+	/** Enable debug output */
+	debug?: boolean;
+}
+/**
+* Clarinet plugin factory
+*/
+declare const clarinet: PluginFactory<ClarinetPluginOptions>;
+/**
+* Utility function to check if a Clarinet project exists
+*/
+declare function hasClarinetProject(path?: string): Promise<boolean>;
+interface ActionsPluginOptions {
+	/** Include only specific contracts */
+	include?: string[];
+	/** Exclude specific contracts */
+	exclude?: string[];
+	/** Include only specific functions */
+	includeFunctions?: string[];
+	/** Exclude specific functions */
+	excludeFunctions?: string[];
+	/** Enable debug output */
+	debug?: boolean;
+	/** Environment variable name for default sender key (default: "STX_SENDER_KEY") */
+	senderKeyEnv?: string;
+}
+/**
+* Actions plugin factory
+*/
+declare const actions: PluginFactory<ActionsPluginOptions>;
+/**
+* React plugin configuration options
+*/
+interface ReactPluginOptions extends PluginOptions {
+	/**
+	* Hooks to exclude from generation (both generic and contract-specific)
+	* By default, all hooks are generated
+	*/
+	exclude?: string[];
+}
+/**
+* React plugin factory
+*/
+declare const react: PluginFactory<ReactPluginOptions>;
+interface TestingPluginOptions {
+	/** Include only specific contracts */
+	include?: string[];
+	/** Exclude specific contracts */
+	exclude?: string[];
+	/** Output path for generated testing helpers (default: ./src/generated/testing.ts) */
+	out?: string;
+	/** Include private function helpers (default: false) */
+	includePrivate?: boolean;
+	/** Enable debug output */
+	debug?: boolean;
+}
+declare const testing: PluginFactory<TestingPluginOptions>;
+interface BasePluginOptions {
+	/** Include only specific contracts/functions */
+	include?: string[];
+	/** Exclude specific contracts/functions */
+	exclude?: string[];
+	/** Enable debug output */
+	debug?: boolean;
+}
+/**
+* Utility function to filter contracts/functions based on include/exclude options
+*/
+declare function filterByOptions<T extends {
+	name: string
+}>(items: T[], options?: BasePluginOptions): T[];
+/**
+* Utility function to create a simple plugin
+*/
+declare function createPlugin(name: string, version: string, implementation: Partial<SecondLayerPlugin>): SecondLayerPlugin;
+export { testing, react, hasClarinetProject, filterByOptions, createPlugin, clarinet, actions, TestingPluginOptions, SecondLayerPlugin, ReactPluginOptions, PluginUtils, PluginOptions, PluginManager, PluginFactory, PluginContext, Logger, GenerateContext, ClarinetPluginOptions, BasePluginOptions, ActionsPluginOptions };