@databricks/appkit 0.61.1 → 0.62.0

package/dist/cli/commands/doctor/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","names":[],"sources":["../../../../src/cli/commands/doctor/run.ts"],"sourcesContent":["/** Orchestration for `appkit doctor`. */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { originForEnvVars, readBundleInfo } from \"./bundle\";\nimport {\n  type ConfigCheckContext,\n  checkAuth,\n  checkConfig,\n  DEFAULT_ENV_FILE,\n} from \"./checks\";\nimport { runExistenceProbe } from \"./checks-existence\";\nimport { checkWiring } from \"./checks-wiring\";\nimport {\n  DEFAULT_MANIFEST_FILE,\n  resolveTargetsFromCwd,\n} from \"./resolve-targets\";\nimport {\n  AUTH_UNAVAILABLE_CODE,\n  BUNDLE_MANAGED_CODE,\n  type CheckStatus,\n  type DoctorOptions,\n  type DoctorReport,\n  type LayerResult,\n  type ResourceCheckResult,\n  type ResourceTarget,\n  type SetupFinding,\n  STATUS_SEVERITY,\n} from \"./types\";\nimport { errorMessage, TimeoutError, withTimeout } from \"./utils\";\n\nfunction worst(a: CheckStatus, b: CheckStatus): CheckStatus {\n  return STATUS_SEVERITY[b] > STATUS_SEVERITY[a] ? b : a;\n}\n\nasync function checkResource(\n  target: ResourceTarget,\n  // undefined = auth failed, so the live existence layer is skipped.\n  client: unknown,\n  configCtx: ConfigCheckContext,\n): Promise<ResourceCheckResult> {\n  const layers: LayerResult[] = [];\n  let rolled: CheckStatus = \"ok\";\n\n  // A bundle-managed resource is checked before anything else, because neither\n  // remaining layer can say anything true about it: its value comes from\n  // `${resources.*}` at deploy time, so an unset env var locally is the *normal*\n  // state (not a config error), and probing would be a false NOT_FOUND. A\n  // mismatch between the three files is the wiring layer's job, and problems\n  // inside databricks.yml are `databricks bundle validate`'s.\n  //\n  // This must run first: checking config here used to error on the unset var and\n  // return early, never reaching this branch — which failed CI for a correctly\n  // configured app while the report collapsed the row to a green-looking\n  // \"will be created on deploy\" with the error hidden.\n  if (target.origin === \"bundle-managed\") {\n    return {\n      target,\n      status: \"skipped\",\n      layers: [\n        {\n          layer: \"existence\",\n          status: \"skipped\",\n          code: BUNDLE_MANAGED_CODE,\n          detail: \"created by this bundle on deploy — not probed\",\n        },\n      ],\n    };\n  }\n\n  const configResult = checkConfig(target, configCtx);\n  layers.push(configResult);\n  rolled = worst(rolled, configResult.status);\n  // A hard config failure makes the existence probe meaningless.\n  if (configResult.status === \"error\") {\n    return { target, status: rolled, layers };\n  }\n\n  if (client === undefined) {\n    layers.push({\n      layer: \"existence\",\n      status: \"skipped\",\n      code: AUTH_UNAVAILABLE_CODE,\n      detail: \"skipped because workspace authentication failed\",\n    });\n    rolled = worst(rolled, \"skipped\");\n  } else {\n    // A reachable-but-unresponsive endpoint must not hang doctor, so bound the\n    // probe; a timeout becomes an error row rather than a hung process.\n    const result = await withTimeout(runExistenceProbe(client, target)).catch(\n      (err): LayerResult => ({\n        layer: \"existence\",\n        status: \"error\",\n        code: err instanceof TimeoutError ? \"PROBE_TIMEOUT\" : \"PROBE_FAILED\",\n        detail: `probe did not complete: ${errorMessage(err)}`,\n      }),\n    );\n    layers.push(result);\n    rolled = worst(rolled, result.status);\n  }\n\n  return { target, status: rolled, layers };\n}\n\n/**\n * Runs {@link checkResource} behind a guaranteed boundary: any unexpected throw\n * (a probe's own `.catch` handles the common case, but this covers config\n * errors and anything else) becomes a single error row instead of rejecting the\n * `Promise.all` and losing the entire report to a stack trace.\n */\nasync function checkResourceSafe(\n  target: ResourceTarget,\n  client: unknown,\n  configCtx: ConfigCheckContext,\n): Promise<ResourceCheckResult> {\n  try {\n    return await checkResource(target, client, configCtx);\n  } catch (err) {\n    return {\n      target,\n      status: \"error\",\n      layers: [\n        {\n          layer: \"existence\",\n          status: \"error\",\n          code: \"PROBE_EXCEPTION\",\n          detail: `unexpected error while checking: ${errorMessage(err)}`,\n        },\n      ],\n    };\n  }\n}\n\n/**\n * Checks doctor's own inputs, which otherwise produce a misleading report: run\n * from the wrong directory (say `server/` instead of the app root), nothing is\n * found and the result is a near-empty all-clear — a CI gate passing an app it\n * never looked at.\n *\n * The manifest is the signal for \"this is an app root\". Without it there's one\n * cause worth reporting (wrong directory), so it reports only that; a missing\n * `.env` would be noise on top. With it, a missing `.env` is worth its own notice\n * because local values could then only have come from the shell.\n *\n * Warnings, not errors: an app may legitimately have no `.env` (values exported\n * in the shell, or running in a deployed container), so this must not fail a\n * build on its own.\n */\nexport function checkSetup(\n  cwd: string,\n  options: DoctorOptions,\n): SetupFinding[] {\n  // Presence of the manifest, not the target count: a manifest that declares no\n  // resources is legitimate and shouldn't be reported as a missing file.\n  if (!fs.existsSync(path.join(cwd, DEFAULT_MANIFEST_FILE))) {\n    return [\n      {\n        status: \"warn\",\n        code: \"NO_RESOURCES_CHECKED\",\n        label: \"no resources checked\",\n        detail: `no ${DEFAULT_MANIFEST_FILE} found in ${cwd}, so no plugin resources were checked`,\n        hint: `Run doctor from the app root (where ${DEFAULT_MANIFEST_FILE} lives), or run \\`appkit plugin sync --write\\` if it's missing.`,\n      },\n    ];\n  }\n\n  // An explicit --env-file that's missing already throws in the CLI, so only the\n  // auto-loaded default is worth reporting here.\n  if (!options.envFile && !fs.existsSync(path.join(cwd, DEFAULT_ENV_FILE))) {\n    return [\n      {\n        status: \"warn\",\n        code: \"ENV_FILE_MISSING\",\n        label: DEFAULT_ENV_FILE,\n        detail: `no ${DEFAULT_ENV_FILE} found in ${cwd} — local values can only come from the shell`,\n        hint: `Create one (see .env.example), or pass --env-file <path>.`,\n      },\n    ];\n  }\n\n  return [];\n}\n\nexport async function runDoctor(options: DoctorOptions): Promise<DoctorReport> {\n  const { result: auth, client } = await checkAuth(options);\n\n  // Resolve and config-check resources even when auth failed, so a bad\n  // connection still surfaces config problems instead of hiding them.\n  const cwd = process.cwd();\n  const targets = resolveTargetsFromCwd(cwd);\n\n  const bundle = readBundleInfo(cwd);\n  for (const target of targets) {\n    const origin = originForEnvVars(target.envVars, bundle);\n    if (origin) target.origin = origin;\n  }\n\n  // Name the file local values actually came from, and let the config layer see\n  // the deploy wiring so it doesn't advise fixing what's already correct.\n  const configCtx: ConfigCheckContext = {\n    envFile: options.envFile ?? DEFAULT_ENV_FILE,\n    wiredEnvVars: new Set(bundle.envToBinding.keys()),\n  };\n\n  const setup = checkSetup(cwd, options);\n\n  // Probes are independent reads; Promise.all preserves order for a\n  // deterministic report.\n  const resources = await Promise.all(\n    targets.map((target) => checkResourceSafe(target, client, configCtx)),\n  );\n  const wiring = checkWiring(bundle, targets);\n\n  // The summary counts *everything* with a status — resources, the auth check,\n  // wiring findings, and setup notices — so a --json consumer reading\n  // summary.error can trust it, and the human/JSON outputs share one source of\n  // truth.\n  const summary = { ok: 0, warn: 0, error: 0, skipped: 0 };\n  for (const result of resources) summary[result.status] += 1;\n  summary[auth.status] += 1;\n  for (const finding of wiring) summary[finding.status] += 1;\n  for (const finding of setup) summary[finding.status] += 1;\n\n  const exitCode = summary.error > 0 ? 1 : 0;\n\n  return { auth, resources, wiring, setup, summary, exitCode };\n}\n"],"mappings":"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"}
+{"version":3,"file":"run.js","names":[],"sources":["../../../../src/cli/commands/doctor/run.ts"],"sourcesContent":["/** Orchestration for `appkit doctor`. */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\nimport { originForEnvVars, readBundleInfo } from \"./bundle\";\nimport {\n  type ConfigCheckContext,\n  checkAuth,\n  checkConfig,\n  DEFAULT_ENV_FILE,\n} from \"./checks\";\nimport { runExistenceProbe } from \"./checks-existence\";\nimport { checkWiring } from \"./checks-wiring\";\nimport {\n  DEFAULT_MANIFEST_FILE,\n  resolveTargetsFromCwd,\n} from \"./resolve-targets\";\nimport {\n  AUTH_UNAVAILABLE_CODE,\n  BUNDLE_MANAGED_CODE,\n  type CheckStatus,\n  type DoctorOptions,\n  type DoctorReport,\n  type LayerResult,\n  type ResourceCheckResult,\n  type ResourceTarget,\n  type SetupFinding,\n  STATUS_SEVERITY,\n} from \"./types\";\nimport { errorMessage, TimeoutError, withTimeout } from \"./utils\";\n\nfunction worst(a: CheckStatus, b: CheckStatus): CheckStatus {\n  return STATUS_SEVERITY[b] > STATUS_SEVERITY[a] ? b : a;\n}\n\nasync function checkResource(\n  target: ResourceTarget,\n  // undefined = auth failed, so the live existence layer is skipped.\n  client: unknown,\n  configCtx: ConfigCheckContext,\n): Promise<ResourceCheckResult> {\n  const layers: LayerResult[] = [];\n  let rolled: CheckStatus = \"ok\";\n\n  // A bundle-managed resource is checked before anything else, because neither\n  // remaining layer can say anything true about it: its value comes from\n  // `${resources.*}` at deploy time, so an unset env var locally is the *normal*\n  // state (not a config error), and probing would be a false NOT_FOUND. A\n  // mismatch between the three files is the wiring layer's job, and problems\n  // inside databricks.yml are `databricks bundle validate`'s.\n  //\n  // This must run first: checking config here used to error on the unset var and\n  // return early, never reaching this branch — which failed CI for a correctly\n  // configured app while the report collapsed the row to a green-looking\n  // \"will be created on deploy\" with the error hidden.\n  if (target.origin === \"bundle-managed\") {\n    return {\n      target,\n      status: \"skipped\",\n      layers: [\n        {\n          layer: \"existence\",\n          status: \"skipped\",\n          code: BUNDLE_MANAGED_CODE,\n          detail: \"created by this bundle on deploy — not probed\",\n        },\n      ],\n    };\n  }\n\n  const configResult = checkConfig(target, configCtx);\n  layers.push(configResult);\n  rolled = worst(rolled, configResult.status);\n  // A hard config failure makes the existence probe meaningless.\n  if (configResult.status === \"error\") {\n    return { target, status: rolled, layers };\n  }\n\n  if (client === undefined) {\n    layers.push({\n      layer: \"existence\",\n      status: \"skipped\",\n      code: AUTH_UNAVAILABLE_CODE,\n      detail: \"skipped because workspace authentication failed\",\n    });\n    rolled = worst(rolled, \"skipped\");\n  } else {\n    // A reachable-but-unresponsive endpoint must not hang doctor, so bound the\n    // probe; a timeout becomes an error row rather than a hung process.\n    const result = await withTimeout(runExistenceProbe(client, target)).catch(\n      (err): LayerResult => ({\n        layer: \"existence\",\n        status: \"error\",\n        code: err instanceof TimeoutError ? \"PROBE_TIMEOUT\" : \"PROBE_FAILED\",\n        detail: `probe did not complete: ${errorMessage(err)}`,\n      }),\n    );\n    layers.push(result);\n    rolled = worst(rolled, result.status);\n  }\n\n  return { target, status: rolled, layers };\n}\n\n/**\n * Runs {@link checkResource} behind a guaranteed boundary: any unexpected throw\n * (a probe's own `.catch` handles the common case, but this covers config\n * errors and anything else) becomes a single error row instead of rejecting the\n * `Promise.all` and losing the entire report to a stack trace.\n */\nasync function checkResourceSafe(\n  target: ResourceTarget,\n  client: unknown,\n  configCtx: ConfigCheckContext,\n): Promise<ResourceCheckResult> {\n  try {\n    return await checkResource(target, client, configCtx);\n  } catch (err) {\n    return {\n      target,\n      status: \"error\",\n      layers: [\n        {\n          layer: \"existence\",\n          status: \"error\",\n          code: \"PROBE_EXCEPTION\",\n          detail: `unexpected error while checking: ${errorMessage(err)}`,\n        },\n      ],\n    };\n  }\n}\n\n/**\n * Checks doctor's own inputs, which otherwise produce a misleading report: run\n * from the wrong directory (say `server/` instead of the app root), nothing is\n * found and the result is a near-empty all-clear — a CI gate passing an app it\n * never looked at.\n *\n * The manifest is the signal for \"this is an app root\". Without it there's one\n * cause worth reporting (wrong directory), so it reports only that; a missing\n * `.env` would be noise on top. With it, a missing `.env` is worth its own notice\n * because local values could then only have come from the shell.\n *\n * Warnings, not errors: an app may legitimately have no `.env` (values exported\n * in the shell, or running in a deployed container), so this must not fail a\n * build on its own.\n */\nexport function checkSetup(\n  cwd: string,\n  options: DoctorOptions,\n): SetupFinding[] {\n  // Presence of the manifest, not the target count: a manifest that declares no\n  // resources is legitimate and shouldn't be reported as a missing file.\n  if (!fs.existsSync(path.join(cwd, DEFAULT_MANIFEST_FILE))) {\n    return [\n      {\n        status: \"warn\",\n        code: \"NO_RESOURCES_CHECKED\",\n        label: \"no resources checked\",\n        detail: `no ${DEFAULT_MANIFEST_FILE} found in ${cwd}, so no plugin resources were checked`,\n        hint: `Run doctor from the app root (where ${DEFAULT_MANIFEST_FILE} lives), or run \\`appkit plugin sync --write\\` if it's missing.`,\n      },\n    ];\n  }\n\n  // An explicit --env-file that's missing already throws in the CLI, so only the\n  // auto-loaded default is worth reporting here.\n  if (!options.envFile && !fs.existsSync(path.join(cwd, DEFAULT_ENV_FILE))) {\n    return [\n      {\n        status: \"warn\",\n        code: \"ENV_FILE_MISSING\",\n        label: DEFAULT_ENV_FILE,\n        detail: `no ${DEFAULT_ENV_FILE} found in ${cwd} — local values can only come from the shell`,\n        hint: `Create one (see .env.example), or pass --env-file <path>.`,\n      },\n    ];\n  }\n\n  return [];\n}\n\nexport async function runDoctor(options: DoctorOptions): Promise<DoctorReport> {\n  const { result: auth, client } = await checkAuth(options);\n\n  // Resolve and config-check resources even when auth failed, so a bad\n  // connection still surfaces config problems instead of hiding them.\n  const cwd = process.cwd();\n  const targets = resolveTargetsFromCwd(cwd);\n\n  const bundle = readBundleInfo(cwd);\n  for (const target of targets) {\n    const origin = originForEnvVars(target.envVars, bundle);\n    if (origin) target.origin = origin;\n  }\n\n  // Name the file local values actually came from, and let the config layer see\n  // the deploy wiring so it doesn't advise fixing what's already correct.\n  const configCtx: ConfigCheckContext = {\n    envFile: options.envFile ?? DEFAULT_ENV_FILE,\n    wiredEnvVars: new Set(bundle.envToBinding.keys()),\n  };\n\n  const setup = checkSetup(cwd, options);\n\n  // Probes are independent reads; Promise.all preserves order for a\n  // deterministic report.\n  const resources = await Promise.all(\n    targets.map((target) => checkResourceSafe(target, client, configCtx)),\n  );\n  const wiring = checkWiring(bundle, targets);\n\n  // The summary counts *everything* with a status — resources, the auth check,\n  // wiring findings, and setup notices — so a --json consumer reading\n  // summary.error can trust it, and the human/JSON outputs share one source of\n  // truth.\n  const summary = { ok: 0, warn: 0, error: 0, skipped: 0 };\n  for (const result of resources) summary[result.status] += 1;\n  summary[auth.status] += 1;\n  for (const finding of wiring) summary[finding.status] += 1;\n  for (const finding of setup) summary[finding.status] += 1;\n\n  const exitCode = summary.error > 0 ? 1 : 0;\n\n  return { auth, resources, wiring, setup, summary, exitCode };\n}\n"],"mappings":"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"}

package/dist/cli/commands/generate-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate-types.js","names":[],"sources":["../../../src/cli/commands/generate-types.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { Command, Option } from \"commander\";\nimport { METRIC_CONFIG_FILE } from \"../../schemas/metric-fqn\";\nimport {\n  acquireSpawnLock,\n  getSpawnLockPath,\n  releaseSpawnLock,\n} from \"./spawn-lock.js\";\n\n/**\n * Resolve the typegen pre-flight mode for the CLI. Defaults to \"non-blocking\" —\n * a one-shot CLI can't describe in the background, so by default it never\n * describes at all: it skips the warehouse probe AND every DESCRIBE, emits\n * best-available types (cache where the SQL hash matches, else `result: unknown`)\n * and returns immediately, never blocking on — or failing because of — a\n * warehouse, even a RUNNING one. Pass `--wait` (commander sets `wait: true`)\n * for a deliberate/CI invocation that should wait for a starting warehouse and\n * fail fast on a stopped one.\n */\nexport function resolveTypegenMode(options?: {\n  wait?: boolean;\n}): \"non-blocking\" | \"blocking\" {\n  return options?.wait ? \"blocking\" : \"non-blocking\";\n}\n\n/** Options parsed by commander for the generate-types command. */\ninterface GenerateTypesOptions {\n  noCache?: boolean;\n  wait?: boolean;\n  /**\n   * Internal: present only on the detached worker invocation. Carries the path\n   * of the single-flight lock this worker must release when it finishes. Its\n   * presence is what marks an invocation as \"the worker\" — workers always run\n   * with `--wait`, so they never spawn another worker (only non-blocking runs\n   * spawn), which terminates the recursion.\n   */\n  workerLock?: string;\n}\n\n/**\n * Generate types command implementation. Runs the library generate (which, in\n * non-blocking mode, writes degraded types and returns immediately). This is the\n * SAME work the worker performs in blocking mode in the background.\n */\nasync function runGenerateTypes(\n  rootDir?: string,\n  outFile?: string,\n  warehouseId?: string,\n  options?: GenerateTypesOptions,\n) {\n  try {\n    const resolvedRootDir = rootDir || process.cwd();\n    const noCache = options?.noCache || false;\n    const mode = resolveTypegenMode(options);\n\n    const typeGen = await import(\"@databricks/appkit/type-generator\");\n\n    // Generate analytics query types (requires warehouse ID)\n    const resolvedWarehouseId =\n      warehouseId || process.env.DATABRICKS_WAREHOUSE_ID;\n\n    if (resolvedWarehouseId) {\n      const resolvedOutFile =\n        outFile ||\n        path.join(process.cwd(), \"shared/appkit-types/analytics.d.ts\");\n\n      const queryFolder = path.join(resolvedRootDir, \"config/queries\");\n      const metricViewsFolder = path.join(\n        resolvedRootDir,\n        \"config/metric-views\",\n      );\n      const hasQueries = fs.existsSync(queryFolder);\n      const hasMetricViews = fs.existsSync(metricViewsFolder);\n\n      // Generate when either config surface exists. Metric-view types are\n      // independent of `.sql` queries — an app can declare metric views in\n      // `config/metric-views/` without a `config/queries/` folder.\n      if (hasQueries || hasMetricViews) {\n        await typeGen.generateFromEntryPoint({\n          queryFolder: hasQueries ? queryFolder : undefined,\n          metricViewsFolder: hasMetricViews ? metricViewsFolder : undefined,\n          outFile: resolvedOutFile,\n          warehouseId: resolvedWarehouseId,\n          noCache,\n          mode,\n        });\n\n        if (hasQueries) {\n          console.log(`Generated query types: ${resolvedOutFile}`);\n        }\n\n        const metricConfig = path.join(metricViewsFolder, METRIC_CONFIG_FILE);\n        if (fs.existsSync(metricConfig)) {\n          const typesDir = path.dirname(resolvedOutFile);\n          console.log(\n            `Generated metric types: ${path.join(typesDir, \"metric-views.ts\")}`,\n          );\n        }\n      }\n    } else {\n      console.error(\n        \"Skipping query type generation: no warehouse ID. Set DATABRICKS_WAREHOUSE_ID or pass as argument.\",\n      );\n    }\n\n    // Generate serving endpoint types (no warehouse required)\n    const servingOutFile = path.join(\n      process.cwd(),\n      \"shared/appkit-types/serving.d.ts\",\n    );\n    await typeGen.generateServingTypes({\n      outFile: servingOutFile,\n      noCache,\n    });\n    console.log(`Generated serving types: ${servingOutFile}`);\n  } catch (error) {\n    if (\n      error instanceof Error &&\n      error.message.includes(\"Cannot find module\")\n    ) {\n      console.error(\n        \"Error: The 'generate-types' command is only available in @databricks/appkit.\",\n      );\n      console.error(\"Please install @databricks/appkit to use this command.\");\n      process.exit(1);\n    }\n    // TypegenSyntaxError / TypegenFatalError carry a complete, actionable\n    // message (which queries failed and how to debug them). The stack trace\n    // points into appkit internals and is noise for app developers, so print\n    // only the message and exit non-zero instead of letting it bubble up.\n    if (\n      error instanceof Error &&\n      (error.name === \"TypegenSyntaxError\" ||\n        error.name === \"TypegenFatalError\")\n    ) {\n      console.error(error.message);\n      process.exit(1);\n    }\n    throw error;\n  }\n}\n\n/**\n * Spawn the detached blocking worker that refreshes real types in the background\n * after the foreground non-blocking generate has already written degraded types.\n *\n * Re-invokes THIS CLI (`process.execPath` + `process.argv[1]` — the bin entry\n * that launched us) with `generate-types --wait --worker-lock <lockPath>` plus\n * the same positional target options the foreground used, so the worker writes\n * to the same out file / reads the same query folder. The worker is:\n *  - `detached: true` + `.unref()` so it outlives this process (install/dev-setup\n *    can finish and exit while the worker keeps warming the warehouse).\n *  - `stdio: \"ignore\"` so it never holds the parent's pipes open or interleaves\n *    output into the install/dev log.\n *\n * Spawning is wrapped so any failure is non-fatal: the caller still has degraded\n * types and exits 0.\n *\n * @param lockPath - the acquired single-flight lock; passed to the worker so it\n *   releases the SAME lock when it finishes.\n * @param targets - the foreground's positional args, forwarded verbatim.\n * @returns true if the worker was spawned, false if spawning threw.\n */\nexport function spawnTypegenWorker(\n  lockPath: string,\n  targets: { rootDir?: string; outFile?: string; warehouseId?: string },\n): boolean {\n  // The script the runtime launched us with (the `appkit` bin shim). Re-running\n  // it under the same node binary reproduces this exact CLI in the worker.\n  const cliEntry = process.argv[1];\n\n  // Forward the positionals in declaration order (rootDir, outFile,\n  // warehouseId). Stop at the first undefined so we never pass a literal\n  // \"undefined\" — commander would treat it as a positional value. (rootDir is\n  // effectively always set by commander's default, but guard anyway.)\n  const positionals: string[] = [];\n  for (const value of [targets.rootDir, targets.outFile, targets.warehouseId]) {\n    if (value === undefined) break;\n    positionals.push(value);\n  }\n\n  const args = [\n    // Forward the parent's node/loader flags so the worker runs under the same\n    // runtime. Critically this carries tsx's `--require`/`--import` when the CLI\n    // is run from source (`tsx index.ts …`); without them the worker would be\n    // `node index.ts …`, which can't parse TypeScript and dies silently — the\n    // degraded types would then never refresh. Empty for the built bin (plain\n    // `node bin/appkit.js`), so production behaviour is unchanged.\n    ...process.execArgv,\n    cliEntry,\n    \"generate-types\",\n    \"--wait\",\n    \"--worker-lock\",\n    lockPath,\n    ...positionals,\n  ];\n\n  try {\n    const child = spawn(process.execPath, args, {\n      detached: true,\n      stdio: \"ignore\",\n    });\n    child.unref();\n    return true;\n  } catch (error) {\n    // Non-fatal: the foreground already wrote degraded types. Log and move on.\n    console.error(\n      `Could not start background type refresh: ${\n        error instanceof Error ? error.message : String(error)\n      }`,\n    );\n    return false;\n  }\n}\n\n/**\n * The command action. Orchestrates the non-blocking foreground contract:\n *  1. Run the library generate (writes degraded types immediately in non-blocking\n *     mode; does the full blocking lifecycle when this is the worker).\n *  2. If this is a non-blocking, non-worker invocation, try to spawn the detached\n *     blocking worker behind the single-flight lock. If the lock is already held\n *     by a live worker, skip (single-flight) with a one-line note. Either way the\n *     foreground returns normally (exit 0).\n *  3. If this IS the worker (`--worker-lock` present), it ran blocking above and\n *     releases the lock here (and via a process-exit guard, so a hard failure /\n *     process.exit still frees it).\n */\nasync function generateTypesAction(\n  rootDir: string | undefined,\n  outFile: string | undefined,\n  warehouseId: string | undefined,\n  options: GenerateTypesOptions,\n) {\n  const isWorker = typeof options.workerLock === \"string\";\n\n  // A worker must always free its lock, even if the blocking generate throws or\n  // calls process.exit (TypegenFatalError → exit 1). The exit handler covers the\n  // process.exit / uncaught paths; the finally covers the normal return.\n  if (isWorker && options.workerLock) {\n    const lockPath = options.workerLock;\n    process.once(\"exit\", () => releaseSpawnLock(lockPath));\n  }\n\n  try {\n    await runGenerateTypes(rootDir, outFile, warehouseId, options);\n  } finally {\n    if (isWorker && options.workerLock) {\n      releaseSpawnLock(options.workerLock);\n    }\n  }\n\n  // Only a non-blocking, non-worker invocation spawns. A worker is always\n  // --wait (so resolveTypegenMode → \"blocking\"), which both prevents recursion\n  // and means we never get here for a worker.\n  if (!isWorker && resolveTypegenMode(options) === \"non-blocking\") {\n    const resolvedRootDir = rootDir || process.cwd();\n    const lockPath = getSpawnLockPath(resolvedRootDir);\n\n    if (acquireSpawnLock(lockPath)) {\n      spawnTypegenWorker(lockPath, { rootDir, outFile, warehouseId });\n    } else {\n      console.log(\"Type refresh already in progress, skipping.\");\n    }\n  }\n}\n\nexport const generateTypesCommand = new Command(\"generate-types\")\n  .description(\"Generate TypeScript types from SQL queries\")\n  .argument(\"[rootDir]\", \"Root directory of the project\", process.cwd())\n  .argument(\n    \"[outFile]\",\n    \"Output file path\",\n    path.join(process.cwd(), \"shared/appkit-types/analytics.d.ts\"),\n  )\n  .argument(\"[warehouseId]\", \"Databricks warehouse ID\")\n  .option(\"--no-cache\", \"Disable caching for type generation\")\n  .option(\n    \"--wait\",\n    \"Wait for warehouse readiness instead of degrading (use for CI)\",\n  )\n  // Internal: marks the detached background worker and carries the lock it must\n  // release. Hidden from --help; users should never pass it.\n  .addOption(\n    new Option(\n      \"--worker-lock <path>\",\n      \"Internal: detached worker lock path\",\n    ).hideHelp(),\n  )\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ appkit generate-types\n  $ appkit generate-types . shared/appkit-types/analytics.d.ts\n  $ appkit generate-types . shared/appkit-types/analytics.d.ts my-warehouse-id\n  $ appkit generate-types --no-cache\n  $ appkit generate-types --wait   # CI: wait for the warehouse and fail on a cold one`,\n  )\n  .action(generateTypesAction);\n"],"mappings":"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"}
+{"version":3,"file":"generate-types.js","names":[],"sources":["../../../src/cli/commands/generate-types.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\nimport { Command, Option } from \"commander\";\n\nimport { METRIC_CONFIG_FILE } from \"../../schemas/metric-fqn\";\nimport {\n  acquireSpawnLock,\n  getSpawnLockPath,\n  releaseSpawnLock,\n} from \"./spawn-lock.js\";\n\n/**\n * Resolve the typegen pre-flight mode for the CLI. Defaults to \"non-blocking\" —\n * a one-shot CLI can't describe in the background, so by default it never\n * describes at all: it skips the warehouse probe AND every DESCRIBE, emits\n * best-available types (cache where the SQL hash matches, else `result: unknown`)\n * and returns immediately, never blocking on — or failing because of — a\n * warehouse, even a RUNNING one. Pass `--wait` (commander sets `wait: true`)\n * for a deliberate/CI invocation that should wait for a starting warehouse and\n * fail fast on a stopped one.\n */\nexport function resolveTypegenMode(options?: {\n  wait?: boolean;\n}): \"non-blocking\" | \"blocking\" {\n  return options?.wait ? \"blocking\" : \"non-blocking\";\n}\n\n/** Options parsed by commander for the generate-types command. */\ninterface GenerateTypesOptions {\n  noCache?: boolean;\n  wait?: boolean;\n  /**\n   * Internal: present only on the detached worker invocation. Carries the path\n   * of the single-flight lock this worker must release when it finishes. Its\n   * presence is what marks an invocation as \"the worker\" — workers always run\n   * with `--wait`, so they never spawn another worker (only non-blocking runs\n   * spawn), which terminates the recursion.\n   */\n  workerLock?: string;\n}\n\n/**\n * Generate types command implementation. Runs the library generate (which, in\n * non-blocking mode, writes degraded types and returns immediately). This is the\n * SAME work the worker performs in blocking mode in the background.\n */\nasync function runGenerateTypes(\n  rootDir?: string,\n  outFile?: string,\n  warehouseId?: string,\n  options?: GenerateTypesOptions,\n) {\n  try {\n    const resolvedRootDir = rootDir || process.cwd();\n    const noCache = options?.noCache || false;\n    const mode = resolveTypegenMode(options);\n\n    const typeGen = await import(\"@databricks/appkit/type-generator\");\n\n    // Generate analytics query types (requires warehouse ID)\n    const resolvedWarehouseId =\n      warehouseId || process.env.DATABRICKS_WAREHOUSE_ID;\n\n    if (resolvedWarehouseId) {\n      const resolvedOutFile =\n        outFile ||\n        path.join(process.cwd(), \"shared/appkit-types/analytics.d.ts\");\n\n      const queryFolder = path.join(resolvedRootDir, \"config/queries\");\n      const metricViewsFolder = path.join(\n        resolvedRootDir,\n        \"config/metric-views\",\n      );\n      const hasQueries = fs.existsSync(queryFolder);\n      const hasMetricViews = fs.existsSync(metricViewsFolder);\n\n      // Generate when either config surface exists. Metric-view types are\n      // independent of `.sql` queries — an app can declare metric views in\n      // `config/metric-views/` without a `config/queries/` folder.\n      if (hasQueries || hasMetricViews) {\n        await typeGen.generateFromEntryPoint({\n          queryFolder: hasQueries ? queryFolder : undefined,\n          metricViewsFolder: hasMetricViews ? metricViewsFolder : undefined,\n          outFile: resolvedOutFile,\n          warehouseId: resolvedWarehouseId,\n          noCache,\n          mode,\n        });\n\n        if (hasQueries) {\n          console.log(`Generated query types: ${resolvedOutFile}`);\n        }\n\n        const metricConfig = path.join(metricViewsFolder, METRIC_CONFIG_FILE);\n        if (fs.existsSync(metricConfig)) {\n          const typesDir = path.dirname(resolvedOutFile);\n          console.log(\n            `Generated metric types: ${path.join(typesDir, \"metric-views.ts\")}`,\n          );\n        }\n      }\n    } else {\n      console.error(\n        \"Skipping query type generation: no warehouse ID. Set DATABRICKS_WAREHOUSE_ID or pass as argument.\",\n      );\n    }\n\n    // Generate serving endpoint types (no warehouse required)\n    const servingOutFile = path.join(\n      process.cwd(),\n      \"shared/appkit-types/serving.d.ts\",\n    );\n    await typeGen.generateServingTypes({\n      outFile: servingOutFile,\n      noCache,\n    });\n    console.log(`Generated serving types: ${servingOutFile}`);\n  } catch (error) {\n    if (\n      error instanceof Error &&\n      error.message.includes(\"Cannot find module\")\n    ) {\n      console.error(\n        \"Error: The 'generate-types' command is only available in @databricks/appkit.\",\n      );\n      console.error(\"Please install @databricks/appkit to use this command.\");\n      process.exit(1);\n    }\n    // TypegenSyntaxError / TypegenFatalError carry a complete, actionable\n    // message (which queries failed and how to debug them). The stack trace\n    // points into appkit internals and is noise for app developers, so print\n    // only the message and exit non-zero instead of letting it bubble up.\n    if (\n      error instanceof Error &&\n      (error.name === \"TypegenSyntaxError\" ||\n        error.name === \"TypegenFatalError\")\n    ) {\n      console.error(error.message);\n      process.exit(1);\n    }\n    throw error;\n  }\n}\n\n/**\n * Spawn the detached blocking worker that refreshes real types in the background\n * after the foreground non-blocking generate has already written degraded types.\n *\n * Re-invokes THIS CLI (`process.execPath` + `process.argv[1]` — the bin entry\n * that launched us) with `generate-types --wait --worker-lock <lockPath>` plus\n * the same positional target options the foreground used, so the worker writes\n * to the same out file / reads the same query folder. The worker is:\n *  - `detached: true` + `.unref()` so it outlives this process (install/dev-setup\n *    can finish and exit while the worker keeps warming the warehouse).\n *  - `stdio: \"ignore\"` so it never holds the parent's pipes open or interleaves\n *    output into the install/dev log.\n *\n * Spawning is wrapped so any failure is non-fatal: the caller still has degraded\n * types and exits 0.\n *\n * @param lockPath - the acquired single-flight lock; passed to the worker so it\n *   releases the SAME lock when it finishes.\n * @param targets - the foreground's positional args, forwarded verbatim.\n * @returns true if the worker was spawned, false if spawning threw.\n */\nexport function spawnTypegenWorker(\n  lockPath: string,\n  targets: { rootDir?: string; outFile?: string; warehouseId?: string },\n): boolean {\n  // The script the runtime launched us with (the `appkit` bin shim). Re-running\n  // it under the same node binary reproduces this exact CLI in the worker.\n  const cliEntry = process.argv[1];\n\n  // Forward the positionals in declaration order (rootDir, outFile,\n  // warehouseId). Stop at the first undefined so we never pass a literal\n  // \"undefined\" — commander would treat it as a positional value. (rootDir is\n  // effectively always set by commander's default, but guard anyway.)\n  const positionals: string[] = [];\n  for (const value of [targets.rootDir, targets.outFile, targets.warehouseId]) {\n    if (value === undefined) break;\n    positionals.push(value);\n  }\n\n  const args = [\n    // Forward the parent's node/loader flags so the worker runs under the same\n    // runtime. Critically this carries tsx's `--require`/`--import` when the CLI\n    // is run from source (`tsx index.ts …`); without them the worker would be\n    // `node index.ts …`, which can't parse TypeScript and dies silently — the\n    // degraded types would then never refresh. Empty for the built bin (plain\n    // `node bin/appkit.js`), so production behaviour is unchanged.\n    ...process.execArgv,\n    cliEntry,\n    \"generate-types\",\n    \"--wait\",\n    \"--worker-lock\",\n    lockPath,\n    ...positionals,\n  ];\n\n  try {\n    const child = spawn(process.execPath, args, {\n      detached: true,\n      stdio: \"ignore\",\n    });\n    child.unref();\n    return true;\n  } catch (error) {\n    // Non-fatal: the foreground already wrote degraded types. Log and move on.\n    console.error(\n      `Could not start background type refresh: ${\n        error instanceof Error ? error.message : String(error)\n      }`,\n    );\n    return false;\n  }\n}\n\n/**\n * The command action. Orchestrates the non-blocking foreground contract:\n *  1. Run the library generate (writes degraded types immediately in non-blocking\n *     mode; does the full blocking lifecycle when this is the worker).\n *  2. If this is a non-blocking, non-worker invocation, try to spawn the detached\n *     blocking worker behind the single-flight lock. If the lock is already held\n *     by a live worker, skip (single-flight) with a one-line note. Either way the\n *     foreground returns normally (exit 0).\n *  3. If this IS the worker (`--worker-lock` present), it ran blocking above and\n *     releases the lock here (and via a process-exit guard, so a hard failure /\n *     process.exit still frees it).\n */\nasync function generateTypesAction(\n  rootDir: string | undefined,\n  outFile: string | undefined,\n  warehouseId: string | undefined,\n  options: GenerateTypesOptions,\n) {\n  const isWorker = typeof options.workerLock === \"string\";\n\n  // A worker must always free its lock, even if the blocking generate throws or\n  // calls process.exit (TypegenFatalError → exit 1). The exit handler covers the\n  // process.exit / uncaught paths; the finally covers the normal return.\n  if (isWorker && options.workerLock) {\n    const lockPath = options.workerLock;\n    process.once(\"exit\", () => releaseSpawnLock(lockPath));\n  }\n\n  try {\n    await runGenerateTypes(rootDir, outFile, warehouseId, options);\n  } finally {\n    if (isWorker && options.workerLock) {\n      releaseSpawnLock(options.workerLock);\n    }\n  }\n\n  // Only a non-blocking, non-worker invocation spawns. A worker is always\n  // --wait (so resolveTypegenMode → \"blocking\"), which both prevents recursion\n  // and means we never get here for a worker.\n  if (!isWorker && resolveTypegenMode(options) === \"non-blocking\") {\n    const resolvedRootDir = rootDir || process.cwd();\n    const lockPath = getSpawnLockPath(resolvedRootDir);\n\n    if (acquireSpawnLock(lockPath)) {\n      spawnTypegenWorker(lockPath, { rootDir, outFile, warehouseId });\n    } else {\n      console.log(\"Type refresh already in progress, skipping.\");\n    }\n  }\n}\n\nexport const generateTypesCommand = new Command(\"generate-types\")\n  .description(\"Generate TypeScript types from SQL queries\")\n  .argument(\"[rootDir]\", \"Root directory of the project\", process.cwd())\n  .argument(\n    \"[outFile]\",\n    \"Output file path\",\n    path.join(process.cwd(), \"shared/appkit-types/analytics.d.ts\"),\n  )\n  .argument(\"[warehouseId]\", \"Databricks warehouse ID\")\n  .option(\"--no-cache\", \"Disable caching for type generation\")\n  .option(\n    \"--wait\",\n    \"Wait for warehouse readiness instead of degrading (use for CI)\",\n  )\n  // Internal: marks the detached background worker and carries the lock it must\n  // release. Hidden from --help; users should never pass it.\n  .addOption(\n    new Option(\n      \"--worker-lock <path>\",\n      \"Internal: detached worker lock path\",\n    ).hideHelp(),\n  )\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ appkit generate-types\n  $ appkit generate-types . shared/appkit-types/analytics.d.ts\n  $ appkit generate-types . shared/appkit-types/analytics.d.ts my-warehouse-id\n  $ appkit generate-types --no-cache\n  $ appkit generate-types --wait   # CI: wait for the warehouse and fail on a cold one`,\n  )\n  .action(generateTypesAction);\n"],"mappings":"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"}

package/dist/cli/commands/lint.js.map

@@ -1 +1 @@
-{"version":3,"file":"lint.js","names":[],"sources":["../../../src/cli/commands/lint.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { Lang, parse, type SgNode } from \"@ast-grep/napi\";\nimport { Command } from \"commander\";\n\ninterface BaseRule {\n  id: string;\n  message: string;\n  includeTests?: boolean;\n  filter?: (code: string) => boolean;\n}\n\n/**\n * A rule matches via exactly one of `pattern` (an ast-grep pattern for\n * `root.findAll`) or `find` (an escape hatch for checks a single pattern can't\n * express). Discriminated union so a rule with neither or both fails to compile.\n */\ntype Rule =\n  | (BaseRule & { pattern: string; find?: never })\n  | (BaseRule & { find: (root: SgNode) => SgNode[]; pattern?: never });\n\n/** Value node of an object literal's `key: value` pair, or undefined. */\nfunction objectPropertyValue(obj: SgNode, key: string): SgNode | undefined {\n  for (const pair of obj.children()) {\n    if (pair.kind() !== \"pair\") continue;\n    const k = pair.field(\"key\");\n    // Strip quotes so `columns` and `\"columns\"` are treated the same.\n    if (k && k.text().replace(/^[\"']|[\"']$/g, \"\") === key) {\n      return pair.field(\"value\") ?? undefined;\n    }\n  }\n  return undefined;\n}\n\n/** True for `[]` / `[ ]` — an array literal with no elements. */\nfunction isEmptyArrayLiteral(node: SgNode): boolean {\n  return node.kind() === \"array\" && node.children().every((c) => !c.isNamed());\n}\n\n/**\n * Flags `aiSearch(...)` configs whose indexes lack usable `columns`. Production\n * does not auto-discover columns (dev-only), so a missing or empty `columns`\n * fails at query time. Passes anything it can't statically prove bad (constant\n * or dynamically-built columns/indexes) to avoid false positives.\n */\nfunction findAiSearchIndexesMissingColumns(root: SgNode): SgNode[] {\n  const flagged: SgNode[] = [];\n\n  for (const call of root.findAll(\"aiSearch($$$ARGS)\")) {\n    const argNodes =\n      call\n        .field(\"arguments\")\n        ?.children()\n        .filter((c) => c.isNamed()) ?? [];\n\n    // Bare aiSearch(): relies on the env default index (no columns).\n    if (argNodes.length === 0) {\n      flagged.push(call);\n      continue;\n    }\n\n    // aiSearch(dynamicConfig) — not an object literal, can't inspect. Pass.\n    const configObj = argNodes[0].kind() === \"object\" ? argNodes[0] : undefined;\n    if (!configObj) continue;\n\n    const indexes = objectPropertyValue(configObj, \"indexes\");\n\n    // No `indexes` key => falls back to the env default index (no columns).\n    if (!indexes) {\n      flagged.push(call);\n      continue;\n    }\n    if (indexes.kind() !== \"object\") continue; // dynamic indexes: pass.\n\n    const indexPairs = indexes.children().filter((c) => c.kind() === \"pair\");\n\n    // Empty `indexes: {}` => no configured index, same as bare.\n    if (indexPairs.length === 0) {\n      flagged.push(call);\n      continue;\n    }\n\n    for (const pair of indexPairs) {\n      const idxObj = pair.field(\"value\");\n      if (!idxObj || idxObj.kind() !== \"object\") continue; // dynamic: pass.\n      // A spread (`{ ...base }`) may carry `columns` we can't see: pass.\n      if (idxObj.children().some((c) => c.kind() === \"spread_element\"))\n        continue;\n      const columns = objectPropertyValue(idxObj, \"columns\");\n      if (!columns || isEmptyArrayLiteral(columns)) {\n        flagged.push(pair); // points at the offending index alias.\n      }\n    }\n  }\n\n  return flagged;\n}\n\nconst rules: Rule[] = [\n  {\n    id: \"no-double-type-assertion\",\n    pattern: \"$X as unknown as $Y\",\n    message:\n      \"Avoid double type assertion (as unknown as). Use proper type guards or fix the source type.\",\n  },\n  {\n    id: \"no-as-any\",\n    pattern: \"$X as any\",\n    message:\n      'Avoid \"as any\" type assertion. Use proper typing or unknown with type guards.',\n    includeTests: false, // acceptable in test mocks\n  },\n  {\n    id: \"no-array-index-key\",\n    pattern: \"key={$IDX}\",\n    message:\n      \"Avoid using array index as React key. Use a stable unique identifier.\",\n    filter: (code) => /key=\\{(idx|index|i)\\}/.test(code),\n  },\n  {\n    id: \"no-parse-float-without-validation\",\n    pattern: \"parseFloat($X).toFixed($Y)\",\n    message:\n      \"parseFloat can return NaN. Validate input or use toNumber() helper from shared/types.ts.\",\n  },\n  {\n    // <Variants> is the dev-only variant picker from @databricks/appkit-ui,\n    // meant to drive the local edit loop. Finalize the chosen variant before\n    // deploying so the picker chrome never reaches production.\n    id: \"no-variants-in-prod\",\n    pattern: \"<Variants $$$P>$$$C</Variants>\",\n    message:\n      \"<Variants> is a development-only variant picker and must not be shipped. Finalize the chosen <Variant> before deploying.\",\n    includeTests: false,\n  },\n  {\n    id: \"ai-search-index-requires-columns\",\n    message:\n      \"AI Search index has no `columns`; it will fail in production (columns are auto-discovered only in dev). Set `columns` explicitly on each index.\",\n    includeTests: false,\n    find: findAiSearchIndexesMissingColumns,\n  },\n];\n\nfunction isTestFile(filePath: string, rootDir: string): boolean {\n  // Relative to scan root: an ancestor `tests` dir must not mark the whole project as tests.\n  const rel = path.relative(rootDir, filePath);\n  return (\n    /\\.(test|spec)\\.(ts|tsx)$/.test(rel) || /(^|[/\\\\])tests[/\\\\]/.test(rel)\n  );\n}\n\nfunction findTsFiles(dir: string, files: string[] = []): string[] {\n  const entries = fs.readdirSync(dir, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const fullPath = path.join(dir, entry.name);\n\n    if (entry.isDirectory()) {\n      if ([\"node_modules\", \"dist\", \"build\", \".git\"].includes(entry.name))\n        continue;\n      findTsFiles(fullPath, files);\n    } else if (entry.isFile() && /\\.(ts|tsx)$/.test(entry.name)) {\n      files.push(fullPath);\n    }\n  }\n\n  return files;\n}\n\ninterface Violation {\n  file: string;\n  line: number;\n  column: number;\n  rule: string;\n  message: string;\n  code: string;\n}\n\n/**\n * Runs all applicable rules against a file's source. Exported so tests can lint\n * an in-memory string without touching disk.\n */\nexport function lintSource(\n  content: string,\n  filePath: string,\n  activeRules: Rule[] = rules,\n  isTest = false,\n): Violation[] {\n  const violations: Violation[] = [];\n  const lang = filePath.endsWith(\".tsx\") ? Lang.Tsx : Lang.TypeScript;\n  const root = parse(lang, content).root();\n\n  for (const rule of activeRules) {\n    // skip rules that don't apply to test files\n    if (isTest && rule.includeTests === false) continue;\n\n    const matches = rule.find ? rule.find(root) : root.findAll(rule.pattern);\n\n    for (const match of matches) {\n      const code = match.text();\n\n      if (rule.filter && !rule.filter(code)) continue;\n\n      const range = match.range();\n      violations.push({\n        file: filePath,\n        line: range.start.line + 1,\n        column: range.start.column + 1,\n        rule: rule.id,\n        message: rule.message,\n        code: code.length > 80 ? `${code.slice(0, 77)}...` : code,\n      });\n    }\n  }\n\n  return violations;\n}\n\nfunction lintFile(\n  filePath: string,\n  activeRules: Rule[],\n  rootDir: string,\n): Violation[] {\n  const content = fs.readFileSync(filePath, \"utf-8\");\n  return lintSource(\n    content,\n    filePath,\n    activeRules,\n    isTestFile(filePath, rootDir),\n  );\n}\n\n/**\n * Lint command implementation\n */\nfunction runLint() {\n  const rootDir = process.cwd();\n  const files = findTsFiles(rootDir);\n\n  console.log(`Scanning ${files.length} TypeScript files...\\n`);\n\n  const allViolations: Violation[] = [];\n\n  for (const file of files) {\n    const violations = lintFile(file, rules, rootDir);\n    allViolations.push(...violations);\n  }\n\n  if (allViolations.length === 0) {\n    console.log(\"No ast-grep lint violations found.\");\n    process.exit(0);\n  }\n\n  console.log(`Found ${allViolations.length} violation(s):\\n`);\n\n  for (const v of allViolations) {\n    const relPath = path.relative(rootDir, v.file);\n    console.log(`${relPath}:${v.line}:${v.column}`);\n    console.log(`  ${v.rule}: ${v.message}`);\n    console.log(`  > ${v.code}\\n`);\n  }\n\n  process.exit(1);\n}\n\nexport const lintCommand = new Command(\"lint\")\n  .description(\"Run AST-based linting on TypeScript files\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ appkit lint`,\n  )\n  .action(runLint);\n"],"mappings":"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"}
+{"version":3,"file":"lint.js","names":[],"sources":["../../../src/cli/commands/lint.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\n\nimport { Lang, parse, type SgNode } from \"@ast-grep/napi\";\nimport { Command } from \"commander\";\n\ninterface BaseRule {\n  id: string;\n  message: string;\n  includeTests?: boolean;\n  filter?: (code: string) => boolean;\n}\n\n/**\n * A rule matches via exactly one of `pattern` (an ast-grep pattern for\n * `root.findAll`) or `find` (an escape hatch for checks a single pattern can't\n * express). Discriminated union so a rule with neither or both fails to compile.\n */\ntype Rule =\n  | (BaseRule & { pattern: string; find?: never })\n  | (BaseRule & { find: (root: SgNode) => SgNode[]; pattern?: never });\n\n/** Value node of an object literal's `key: value` pair, or undefined. */\nfunction objectPropertyValue(obj: SgNode, key: string): SgNode | undefined {\n  for (const pair of obj.children()) {\n    if (pair.kind() !== \"pair\") continue;\n    const k = pair.field(\"key\");\n    // Strip quotes so `columns` and `\"columns\"` are treated the same.\n    if (k && k.text().replace(/^[\"']|[\"']$/g, \"\") === key) {\n      return pair.field(\"value\") ?? undefined;\n    }\n  }\n  return undefined;\n}\n\n/** True for `[]` / `[ ]` — an array literal with no elements. */\nfunction isEmptyArrayLiteral(node: SgNode): boolean {\n  return node.kind() === \"array\" && node.children().every((c) => !c.isNamed());\n}\n\n/**\n * Flags `aiSearch(...)` configs whose indexes lack usable `columns`. Production\n * does not auto-discover columns (dev-only), so a missing or empty `columns`\n * fails at query time. Passes anything it can't statically prove bad (constant\n * or dynamically-built columns/indexes) to avoid false positives.\n */\nfunction findAiSearchIndexesMissingColumns(root: SgNode): SgNode[] {\n  const flagged: SgNode[] = [];\n\n  for (const call of root.findAll(\"aiSearch($$$ARGS)\")) {\n    const argNodes =\n      call\n        .field(\"arguments\")\n        ?.children()\n        .filter((c) => c.isNamed()) ?? [];\n\n    // Bare aiSearch(): relies on the env default index (no columns).\n    if (argNodes.length === 0) {\n      flagged.push(call);\n      continue;\n    }\n\n    // aiSearch(dynamicConfig) — not an object literal, can't inspect. Pass.\n    const configObj = argNodes[0].kind() === \"object\" ? argNodes[0] : undefined;\n    if (!configObj) continue;\n\n    const indexes = objectPropertyValue(configObj, \"indexes\");\n\n    // No `indexes` key => falls back to the env default index (no columns).\n    if (!indexes) {\n      flagged.push(call);\n      continue;\n    }\n    if (indexes.kind() !== \"object\") continue; // dynamic indexes: pass.\n\n    const indexPairs = indexes.children().filter((c) => c.kind() === \"pair\");\n\n    // Empty `indexes: {}` => no configured index, same as bare.\n    if (indexPairs.length === 0) {\n      flagged.push(call);\n      continue;\n    }\n\n    for (const pair of indexPairs) {\n      const idxObj = pair.field(\"value\");\n      if (!idxObj || idxObj.kind() !== \"object\") continue; // dynamic: pass.\n      // A spread (`{ ...base }`) may carry `columns` we can't see: pass.\n      if (idxObj.children().some((c) => c.kind() === \"spread_element\"))\n        continue;\n      const columns = objectPropertyValue(idxObj, \"columns\");\n      if (!columns || isEmptyArrayLiteral(columns)) {\n        flagged.push(pair); // points at the offending index alias.\n      }\n    }\n  }\n\n  return flagged;\n}\n\nconst rules: Rule[] = [\n  {\n    id: \"no-double-type-assertion\",\n    pattern: \"$X as unknown as $Y\",\n    message:\n      \"Avoid double type assertion (as unknown as). Use proper type guards or fix the source type.\",\n  },\n  {\n    id: \"no-as-any\",\n    pattern: \"$X as any\",\n    message:\n      'Avoid \"as any\" type assertion. Use proper typing or unknown with type guards.',\n    includeTests: false, // acceptable in test mocks\n  },\n  {\n    id: \"no-array-index-key\",\n    pattern: \"key={$IDX}\",\n    message:\n      \"Avoid using array index as React key. Use a stable unique identifier.\",\n    filter: (code) => /key=\\{(idx|index|i)\\}/.test(code),\n  },\n  {\n    id: \"no-parse-float-without-validation\",\n    pattern: \"parseFloat($X).toFixed($Y)\",\n    message:\n      \"parseFloat can return NaN. Validate input or use toNumber() helper from shared/types.ts.\",\n  },\n  {\n    // <Variants> is the dev-only variant picker from @databricks/appkit-ui,\n    // meant to drive the local edit loop. Finalize the chosen variant before\n    // deploying so the picker chrome never reaches production.\n    id: \"no-variants-in-prod\",\n    pattern: \"<Variants $$$P>$$$C</Variants>\",\n    message:\n      \"<Variants> is a development-only variant picker and must not be shipped. Finalize the chosen <Variant> before deploying.\",\n    includeTests: false,\n  },\n  {\n    id: \"ai-search-index-requires-columns\",\n    message:\n      \"AI Search index has no `columns`; it will fail in production (columns are auto-discovered only in dev). Set `columns` explicitly on each index.\",\n    includeTests: false,\n    find: findAiSearchIndexesMissingColumns,\n  },\n];\n\nfunction isTestFile(filePath: string, rootDir: string): boolean {\n  // Relative to scan root: an ancestor `tests` dir must not mark the whole project as tests.\n  const rel = path.relative(rootDir, filePath);\n  return (\n    /\\.(test|spec)\\.(ts|tsx)$/.test(rel) || /(^|[/\\\\])tests[/\\\\]/.test(rel)\n  );\n}\n\nfunction findTsFiles(dir: string, files: string[] = []): string[] {\n  const entries = fs.readdirSync(dir, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const fullPath = path.join(dir, entry.name);\n\n    if (entry.isDirectory()) {\n      if ([\"node_modules\", \"dist\", \"build\", \".git\"].includes(entry.name))\n        continue;\n      findTsFiles(fullPath, files);\n    } else if (entry.isFile() && /\\.(ts|tsx)$/.test(entry.name)) {\n      files.push(fullPath);\n    }\n  }\n\n  return files;\n}\n\ninterface Violation {\n  file: string;\n  line: number;\n  column: number;\n  rule: string;\n  message: string;\n  code: string;\n}\n\n/**\n * Runs all applicable rules against a file's source. Exported so tests can lint\n * an in-memory string without touching disk.\n */\nexport function lintSource(\n  content: string,\n  filePath: string,\n  activeRules: Rule[] = rules,\n  isTest = false,\n): Violation[] {\n  const violations: Violation[] = [];\n  const lang = filePath.endsWith(\".tsx\") ? Lang.Tsx : Lang.TypeScript;\n  const root = parse(lang, content).root();\n\n  for (const rule of activeRules) {\n    // skip rules that don't apply to test files\n    if (isTest && rule.includeTests === false) continue;\n\n    const matches = rule.find ? rule.find(root) : root.findAll(rule.pattern);\n\n    for (const match of matches) {\n      const code = match.text();\n\n      if (rule.filter && !rule.filter(code)) continue;\n\n      const range = match.range();\n      violations.push({\n        file: filePath,\n        line: range.start.line + 1,\n        column: range.start.column + 1,\n        rule: rule.id,\n        message: rule.message,\n        code: code.length > 80 ? `${code.slice(0, 77)}...` : code,\n      });\n    }\n  }\n\n  return violations;\n}\n\nfunction lintFile(\n  filePath: string,\n  activeRules: Rule[],\n  rootDir: string,\n): Violation[] {\n  const content = fs.readFileSync(filePath, \"utf-8\");\n  return lintSource(\n    content,\n    filePath,\n    activeRules,\n    isTestFile(filePath, rootDir),\n  );\n}\n\n/**\n * Lint command implementation\n */\nfunction runLint() {\n  const rootDir = process.cwd();\n  const files = findTsFiles(rootDir);\n\n  console.log(`Scanning ${files.length} TypeScript files...\\n`);\n\n  const allViolations: Violation[] = [];\n\n  for (const file of files) {\n    const violations = lintFile(file, rules, rootDir);\n    allViolations.push(...violations);\n  }\n\n  if (allViolations.length === 0) {\n    console.log(\"No ast-grep lint violations found.\");\n    process.exit(0);\n  }\n\n  console.log(`Found ${allViolations.length} violation(s):\\n`);\n\n  for (const v of allViolations) {\n    const relPath = path.relative(rootDir, v.file);\n    console.log(`${relPath}:${v.line}:${v.column}`);\n    console.log(`  ${v.rule}: ${v.message}`);\n    console.log(`  > ${v.code}\\n`);\n  }\n\n  process.exit(1);\n}\n\nexport const lintCommand = new Command(\"lint\")\n  .description(\"Run AST-based linting on TypeScript files\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ appkit lint`,\n  )\n  .action(runLint);\n"],"mappings":"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"}

package/dist/cli/commands/plugin/add-resource/add-resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"add-resource.js","names":[],"sources":["../../../../../src/cli/commands/plugin/add-resource/add-resource.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport { cancel, intro, outro } from \"@clack/prompts\";\nimport { Command } from \"commander\";\nimport { promptOneResource } from \"../create/prompt-resource\";\nimport {\n  DEFAULT_PERMISSION_BY_TYPE,\n  getDefaultFieldsForType,\n  getValidResourceTypes,\n  humanizeResourceType,\n  resourceKeyFromType,\n} from \"../create/resource-defaults\";\nimport { resolveManifestInDir } from \"../manifest-resolve\";\nimport type { PluginManifest, ResourceRequirement } from \"../manifest-types\";\nimport { validateManifest } from \"../validate/validate-manifest\";\n\n/** Extended manifest type that preserves extra JSON fields (e.g. $schema, author, version) for round-trip writes. */\ninterface ManifestWithExtras extends PluginManifest {\n  [key: string]: unknown;\n}\n\ninterface AddResourceOptions {\n  path?: string;\n  type?: string;\n  required?: boolean;\n  resourceKey?: string;\n  description?: string;\n  permission?: string;\n  fieldsJson?: string;\n  dryRun?: boolean;\n}\n\nfunction loadManifest(\n  pluginDir: string,\n): { manifest: ManifestWithExtras; manifestPath: string } | null {\n  const resolved = resolveManifestInDir(pluginDir, { allowJsManifest: true });\n\n  if (!resolved) {\n    console.error(\n      `No manifest found in ${pluginDir}. This command requires manifest.json (manifest.js cannot be edited in place).`,\n    );\n    console.error(\n      \"  appkit plugin add-resource --path <dir-with-manifest.json>\",\n    );\n    process.exit(1);\n  }\n\n  if (resolved.type !== \"json\") {\n    console.error(\n      `Editable manifest not found. add-resource only supports plugin directories that contain manifest.json (found ${path.basename(resolved.path)}).`,\n    );\n    process.exit(1);\n  }\n\n  const manifestPath = resolved.path;\n\n  try {\n    const raw = fs.readFileSync(manifestPath, \"utf-8\");\n    const parsed = JSON.parse(raw) as unknown;\n    const result = validateManifest(parsed);\n    if (!result.valid || !result.manifest) {\n      console.error(\n        \"Invalid manifest. Run `appkit plugin validate` for details.\",\n      );\n      process.exit(1);\n    }\n    return { manifest: parsed as ManifestWithExtras, manifestPath };\n  } catch (err) {\n    console.error(\n      \"Failed to read or parse manifest.json:\",\n      err instanceof Error ? err.message : err,\n    );\n    process.exit(1);\n  }\n}\n\nfunction buildEntry(\n  type: string,\n  opts: AddResourceOptions,\n): { entry: ResourceRequirement; isRequired: boolean } {\n  const alias = humanizeResourceType(type);\n  const isRequired = opts.required !== false;\n\n  let fields = getDefaultFieldsForType(type);\n  if (opts.fieldsJson) {\n    try {\n      const parsed = JSON.parse(opts.fieldsJson) as Record<\n        string,\n        { env: string; description?: string }\n      >;\n      fields = { ...fields, ...parsed };\n    } catch {\n      console.error(\"Error: --fields-json must be valid JSON.\");\n      console.error(\n        '  Example: --fields-json \\'{\"id\":{\"env\":\"MY_WAREHOUSE_ID\"}}\\'',\n      );\n      process.exit(1);\n    }\n  }\n\n  // Constructed dynamically from a string `type` and string `permission`;\n  // the per-type permission tightness from the discriminated union is\n  // recovered at runtime by `validateManifest` before the entry is written.\n  const entry = {\n    type,\n    alias,\n    resourceKey: opts.resourceKey ?? resourceKeyFromType(type),\n    description:\n      opts.description ||\n      `${isRequired ? \"Required\" : \"Optional\"} for ${alias} functionality.`,\n    permission:\n      opts.permission ?? DEFAULT_PERMISSION_BY_TYPE[type] ?? \"CAN_VIEW\",\n    fields,\n  } as ResourceRequirement;\n\n  return { entry, isRequired };\n}\n\nfunction runNonInteractive(opts: AddResourceOptions): void {\n  const cwd = process.cwd();\n  const pluginDir = path.resolve(cwd, opts.path ?? \".\");\n  const loaded = loadManifest(pluginDir);\n  if (!loaded) return;\n  const { manifest, manifestPath } = loaded;\n\n  const type = opts.type as string;\n  const validTypes = getValidResourceTypes();\n  if (!validTypes.includes(type)) {\n    console.error(`Error: Unknown resource type \"${type}\".`);\n    console.error(`  Valid types: ${validTypes.join(\", \")}`);\n    process.exit(1);\n  }\n  const { entry, isRequired } = buildEntry(type, opts);\n\n  if (isRequired) {\n    manifest.resources.required.push(entry);\n  } else {\n    manifest.resources.optional.push(entry);\n  }\n\n  if (opts.dryRun) {\n    console.log(JSON.stringify(manifest, null, 2));\n    return;\n  }\n\n  fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\\n`);\n  console.log(\n    `Added ${entry.alias} as ${isRequired ? \"required\" : \"optional\"} to ${path.relative(cwd, manifestPath)}`,\n  );\n}\n\nasync function runInteractive(opts: AddResourceOptions): Promise<void> {\n  intro(\"Add resource to plugin manifest\");\n\n  const cwd = process.cwd();\n  const pluginDir = path.resolve(cwd, opts.path ?? \".\");\n  const loaded = loadManifest(pluginDir);\n  if (!loaded) return;\n  const { manifest, manifestPath } = loaded;\n\n  const spec = await promptOneResource();\n  if (!spec) {\n    cancel(\"Cancelled.\");\n    process.exit(0);\n  }\n\n  const alias = humanizeResourceType(spec.type);\n  // See note on the non-interactive variant in `buildEntry` — the entry is\n  // assembled from prompt strings and validated by Zod at write time.\n  const entry = {\n    type: spec.type,\n    alias,\n    resourceKey: spec.resourceKey,\n    description: spec.description || `Required for ${alias} functionality.`,\n    permission: spec.permission,\n    fields: spec.fields,\n  } as ResourceRequirement;\n\n  if (spec.required) {\n    manifest.resources.required.push(entry);\n  } else {\n    manifest.resources.optional.push(entry);\n  }\n\n  fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\\n`);\n\n  outro(\"Resource added.\");\n  console.log(\n    `\\nAdded ${alias} as ${spec.required ? \"required\" : \"optional\"} to ${path.relative(cwd, manifestPath)}`,\n  );\n}\n\nasync function runPluginAddResource(opts: AddResourceOptions): Promise<void> {\n  if (opts.type) {\n    runNonInteractive(opts);\n  } else {\n    await runInteractive(opts);\n  }\n}\n\nexport const pluginAddResourceCommand = new Command(\"add-resource\")\n  .description(\n    \"Add a resource requirement to an existing plugin manifest. Overwrites manifest.json in place.\",\n  )\n  .option(\n    \"-p, --path <dir>\",\n    \"Plugin directory containing manifest.json (default: .)\",\n  )\n  .option(\n    \"-t, --type <resource_type>\",\n    \"Resource type (e.g. sql_warehouse, volume). Enables non-interactive mode.\",\n  )\n  .option(\"--required\", \"Mark resource as required (default: true)\", true)\n  .option(\"--no-required\", \"Mark resource as optional\")\n  .option(\"--resource-key <key>\", \"Resource key (default: derived from type)\")\n  .option(\"--description <text>\", \"Description of the resource requirement\")\n  .option(\"--permission <perm>\", \"Permission level (default: from schema)\")\n  .option(\n    \"--fields-json <json>\",\n    'JSON object overriding field env vars (e.g. \\'{\"id\":{\"env\":\"MY_WAREHOUSE_ID\"}}\\')',\n  )\n  .option(\"--dry-run\", \"Preview the updated manifest without writing\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ appkit plugin add-resource\n  $ appkit plugin add-resource --path plugins/my-plugin --type sql_warehouse\n  $ appkit plugin add-resource --path plugins/my-plugin --type volume --no-required --dry-run\n  $ appkit plugin add-resource --type sql_warehouse --fields-json '{\"id\":{\"env\":\"MY_WAREHOUSE_ID\"}}'`,\n  )\n  .action((opts) =>\n    runPluginAddResource(opts).catch((err) => {\n      console.error(err);\n      process.exit(1);\n    }),\n  );\n"],"mappings":"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"}
+{"version":3,"file":"add-resource.js","names":[],"sources":["../../../../../src/cli/commands/plugin/add-resource/add-resource.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport process from \"node:process\";\n\nimport { cancel, intro, outro } from \"@clack/prompts\";\nimport { Command } from \"commander\";\n\nimport { promptOneResource } from \"../create/prompt-resource\";\nimport {\n  DEFAULT_PERMISSION_BY_TYPE,\n  getDefaultFieldsForType,\n  getValidResourceTypes,\n  humanizeResourceType,\n  resourceKeyFromType,\n} from \"../create/resource-defaults\";\nimport { resolveManifestInDir } from \"../manifest-resolve\";\nimport type { PluginManifest, ResourceRequirement } from \"../manifest-types\";\nimport { validateManifest } from \"../validate/validate-manifest\";\n\n/** Extended manifest type that preserves extra JSON fields (e.g. $schema, author, version) for round-trip writes. */\ninterface ManifestWithExtras extends PluginManifest {\n  [key: string]: unknown;\n}\n\ninterface AddResourceOptions {\n  path?: string;\n  type?: string;\n  required?: boolean;\n  resourceKey?: string;\n  description?: string;\n  permission?: string;\n  fieldsJson?: string;\n  dryRun?: boolean;\n}\n\nfunction loadManifest(\n  pluginDir: string,\n): { manifest: ManifestWithExtras; manifestPath: string } | null {\n  const resolved = resolveManifestInDir(pluginDir, { allowJsManifest: true });\n\n  if (!resolved) {\n    console.error(\n      `No manifest found in ${pluginDir}. This command requires manifest.json (manifest.js cannot be edited in place).`,\n    );\n    console.error(\n      \"  appkit plugin add-resource --path <dir-with-manifest.json>\",\n    );\n    process.exit(1);\n  }\n\n  if (resolved.type !== \"json\") {\n    console.error(\n      `Editable manifest not found. add-resource only supports plugin directories that contain manifest.json (found ${path.basename(resolved.path)}).`,\n    );\n    process.exit(1);\n  }\n\n  const manifestPath = resolved.path;\n\n  try {\n    const raw = fs.readFileSync(manifestPath, \"utf-8\");\n    const parsed = JSON.parse(raw) as unknown;\n    const result = validateManifest(parsed);\n    if (!result.valid || !result.manifest) {\n      console.error(\n        \"Invalid manifest. Run `appkit plugin validate` for details.\",\n      );\n      process.exit(1);\n    }\n    return { manifest: parsed as ManifestWithExtras, manifestPath };\n  } catch (err) {\n    console.error(\n      \"Failed to read or parse manifest.json:\",\n      err instanceof Error ? err.message : err,\n    );\n    process.exit(1);\n  }\n}\n\nfunction buildEntry(\n  type: string,\n  opts: AddResourceOptions,\n): { entry: ResourceRequirement; isRequired: boolean } {\n  const alias = humanizeResourceType(type);\n  const isRequired = opts.required !== false;\n\n  let fields = getDefaultFieldsForType(type);\n  if (opts.fieldsJson) {\n    try {\n      const parsed = JSON.parse(opts.fieldsJson) as Record<\n        string,\n        { env: string; description?: string }\n      >;\n      fields = { ...fields, ...parsed };\n    } catch {\n      console.error(\"Error: --fields-json must be valid JSON.\");\n      console.error(\n        '  Example: --fields-json \\'{\"id\":{\"env\":\"MY_WAREHOUSE_ID\"}}\\'',\n      );\n      process.exit(1);\n    }\n  }\n\n  // Constructed dynamically from a string `type` and string `permission`;\n  // the per-type permission tightness from the discriminated union is\n  // recovered at runtime by `validateManifest` before the entry is written.\n  const entry = {\n    type,\n    alias,\n    resourceKey: opts.resourceKey ?? resourceKeyFromType(type),\n    description:\n      opts.description ||\n      `${isRequired ? \"Required\" : \"Optional\"} for ${alias} functionality.`,\n    permission:\n      opts.permission ?? DEFAULT_PERMISSION_BY_TYPE[type] ?? \"CAN_VIEW\",\n    fields,\n  } as ResourceRequirement;\n\n  return { entry, isRequired };\n}\n\nfunction runNonInteractive(opts: AddResourceOptions): void {\n  const cwd = process.cwd();\n  const pluginDir = path.resolve(cwd, opts.path ?? \".\");\n  const loaded = loadManifest(pluginDir);\n  if (!loaded) return;\n  const { manifest, manifestPath } = loaded;\n\n  const type = opts.type as string;\n  const validTypes = getValidResourceTypes();\n  if (!validTypes.includes(type)) {\n    console.error(`Error: Unknown resource type \"${type}\".`);\n    console.error(`  Valid types: ${validTypes.join(\", \")}`);\n    process.exit(1);\n  }\n  const { entry, isRequired } = buildEntry(type, opts);\n\n  if (isRequired) {\n    manifest.resources.required.push(entry);\n  } else {\n    manifest.resources.optional.push(entry);\n  }\n\n  if (opts.dryRun) {\n    console.log(JSON.stringify(manifest, null, 2));\n    return;\n  }\n\n  fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\\n`);\n  console.log(\n    `Added ${entry.alias} as ${isRequired ? \"required\" : \"optional\"} to ${path.relative(cwd, manifestPath)}`,\n  );\n}\n\nasync function runInteractive(opts: AddResourceOptions): Promise<void> {\n  intro(\"Add resource to plugin manifest\");\n\n  const cwd = process.cwd();\n  const pluginDir = path.resolve(cwd, opts.path ?? \".\");\n  const loaded = loadManifest(pluginDir);\n  if (!loaded) return;\n  const { manifest, manifestPath } = loaded;\n\n  const spec = await promptOneResource();\n  if (!spec) {\n    cancel(\"Cancelled.\");\n    process.exit(0);\n  }\n\n  const alias = humanizeResourceType(spec.type);\n  // See note on the non-interactive variant in `buildEntry` — the entry is\n  // assembled from prompt strings and validated by Zod at write time.\n  const entry = {\n    type: spec.type,\n    alias,\n    resourceKey: spec.resourceKey,\n    description: spec.description || `Required for ${alias} functionality.`,\n    permission: spec.permission,\n    fields: spec.fields,\n  } as ResourceRequirement;\n\n  if (spec.required) {\n    manifest.resources.required.push(entry);\n  } else {\n    manifest.resources.optional.push(entry);\n  }\n\n  fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\\n`);\n\n  outro(\"Resource added.\");\n  console.log(\n    `\\nAdded ${alias} as ${spec.required ? \"required\" : \"optional\"} to ${path.relative(cwd, manifestPath)}`,\n  );\n}\n\nasync function runPluginAddResource(opts: AddResourceOptions): Promise<void> {\n  if (opts.type) {\n    runNonInteractive(opts);\n  } else {\n    await runInteractive(opts);\n  }\n}\n\nexport const pluginAddResourceCommand = new Command(\"add-resource\")\n  .description(\n    \"Add a resource requirement to an existing plugin manifest. Overwrites manifest.json in place.\",\n  )\n  .option(\n    \"-p, --path <dir>\",\n    \"Plugin directory containing manifest.json (default: .)\",\n  )\n  .option(\n    \"-t, --type <resource_type>\",\n    \"Resource type (e.g. sql_warehouse, volume). Enables non-interactive mode.\",\n  )\n  .option(\"--required\", \"Mark resource as required (default: true)\", true)\n  .option(\"--no-required\", \"Mark resource as optional\")\n  .option(\"--resource-key <key>\", \"Resource key (default: derived from type)\")\n  .option(\"--description <text>\", \"Description of the resource requirement\")\n  .option(\"--permission <perm>\", \"Permission level (default: from schema)\")\n  .option(\n    \"--fields-json <json>\",\n    'JSON object overriding field env vars (e.g. \\'{\"id\":{\"env\":\"MY_WAREHOUSE_ID\"}}\\')',\n  )\n  .option(\"--dry-run\", \"Preview the updated manifest without writing\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ appkit plugin add-resource\n  $ appkit plugin add-resource --path plugins/my-plugin --type sql_warehouse\n  $ appkit plugin add-resource --path plugins/my-plugin --type volume --no-required --dry-run\n  $ appkit plugin add-resource --type sql_warehouse --fields-json '{\"id\":{\"env\":\"MY_WAREHOUSE_ID\"}}'`,\n  )\n  .action((opts) =>\n    runPluginAddResource(opts).catch((err) => {\n      console.error(err);\n      process.exit(1);\n    }),\n  );\n"],"mappings":"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"}

package/dist/cli/commands/plugin/create/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","names":[],"sources":["../../../../../src/cli/commands/plugin/create/create.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport {\n  cancel,\n  confirm,\n  intro,\n  isCancel,\n  multiselect,\n  outro,\n  select,\n  spinner,\n  text,\n} from \"@clack/prompts\";\nimport { Command, Option } from \"commander\";\nimport { PLUGIN_NAME_PATTERN } from \"../../../../naming\";\nimport { promptOneResource } from \"./prompt-resource\";\nimport {\n  DEFAULT_PERMISSION_BY_TYPE,\n  getDefaultFieldsForType,\n  getValidResourceTypes,\n  humanizeResourceType,\n  RESOURCE_TYPE_OPTIONS,\n  resourceKeyFromType,\n} from \"./resource-defaults\";\nimport { resolveTargetDir, scaffoldPlugin } from \"./scaffold\";\nimport type { CreateAnswers, Placement, SelectedResource } from \"./types\";\n\nconst DEFAULT_VERSION = \"0.1.0\";\nconst VALID_PLACEMENTS: Placement[] = [\"in-repo\", \"isolated\"];\nconst REQUIRED_FLAGS = [\"placement\", \"path\", \"name\", \"description\"] as const;\n\ninterface CreateOptions {\n  placement?: string;\n  path?: string;\n  name?: string;\n  displayName?: string;\n  description?: string;\n  resources?: string;\n  resourcesJson?: string;\n  force?: boolean;\n}\n\nfunction deriveDisplayName(name: string): string {\n  // camelCase -> Title Case words (e.g. \"myPlugin\" -> \"My Plugin\").\n  const spaced = name.replace(/([a-z0-9])([A-Z])/g, \"$1 $2\");\n  return spaced.charAt(0).toUpperCase() + spaced.slice(1);\n}\n\nfunction buildResourceFromType(type: string): SelectedResource {\n  return {\n    type,\n    required: true,\n    description: `Required for ${humanizeResourceType(type)} functionality.`,\n    resourceKey: resourceKeyFromType(type),\n    permission: DEFAULT_PERMISSION_BY_TYPE[type] ?? \"CAN_VIEW\",\n    fields: getDefaultFieldsForType(type),\n  };\n}\n\ninterface JsonResourceEntry {\n  type: string;\n  required?: boolean;\n  description?: string;\n  resourceKey?: string;\n  permission?: string;\n  fields?: Record<string, { env: string; description?: string }>;\n}\n\nfunction parseResourcesJson(json: string): SelectedResource[] {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(json);\n  } catch {\n    console.error(\"Error: --resources-json must be valid JSON.\");\n    console.error('  Example: --resources-json \\'[{\"type\":\"sql_warehouse\"}]\\'');\n    process.exit(1);\n  }\n\n  if (!Array.isArray(parsed)) {\n    console.error(\"Error: --resources-json must be a JSON array.\");\n    console.error('  Example: --resources-json \\'[{\"type\":\"sql_warehouse\"}]\\'');\n    process.exit(1);\n  }\n\n  return (parsed as JsonResourceEntry[]).map((entry, i) => {\n    if (entry == null || typeof entry !== \"object\") {\n      console.error(`Error: --resources-json entry ${i} is not an object.`);\n      process.exit(1);\n    }\n    if (!entry.type || typeof entry.type !== \"string\") {\n      console.error(\n        `Error: --resources-json entry ${i} missing required \"type\" field.`,\n      );\n      process.exit(1);\n    }\n    validateResourceType(entry.type);\n    const defaults = buildResourceFromType(entry.type);\n    return {\n      type: entry.type,\n      required: entry.required ?? defaults.required,\n      description: entry.description ?? defaults.description,\n      resourceKey: entry.resourceKey ?? defaults.resourceKey,\n      permission: entry.permission ?? defaults.permission,\n      fields: entry.fields ?? defaults.fields,\n    };\n  });\n}\n\nfunction validateResourceType(type: string): void {\n  const validTypes = getValidResourceTypes();\n  if (!validTypes.includes(type)) {\n    console.error(`Error: Unknown resource type \"${type}\".`);\n    console.error(`  Valid types: ${validTypes.join(\", \")}`);\n    process.exit(1);\n  }\n}\n\nfunction parseResourcesShorthand(csv: string): SelectedResource[] {\n  const types = csv\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter(Boolean);\n  for (const t of types) validateResourceType(t);\n  return types.map(buildResourceFromType);\n}\n\nfunction printNextSteps(answers: CreateAnswers, targetDir: string): void {\n  const relativePath = path.relative(process.cwd(), targetDir);\n  const importPath = relativePath.startsWith(\".\")\n    ? relativePath\n    : `./${relativePath}`;\n  // The camelCase plugin name is already the JS binding.\n  const exportName = answers.name;\n\n  console.log(\"\\nNext steps:\\n\");\n  if (answers.placement === \"in-repo\") {\n    console.log(`  1. Import and register in your server:`);\n    console.log(`     import { ${exportName} } from \"${importPath}\";`);\n    console.log(`     createApp({ plugins: [ ..., ${exportName}() ] });`);\n    console.log(\n      `  2. Run \\`npx appkit plugin sync --write\\` to update appkit.plugins.json.\\n`,\n    );\n  } else {\n    console.log(`  1. cd into the new package and install dependencies:`);\n    console.log(`     cd ${answers.targetPath} && pnpm install`);\n    console.log(`  2. Build: pnpm build`);\n    console.log(\n      `  3. In your app: pnpm add ./${answers.targetPath} @databricks/appkit`,\n    );\n    console.log(\n      `  4. Import and register: import { ${exportName} } from \"<package-name>\";\\n`,\n    );\n  }\n}\n\nfunction runNonInteractive(opts: CreateOptions): void {\n  const missing = REQUIRED_FLAGS.filter((f) => !opts[f]);\n  if (missing.length > 0) {\n    console.error(\n      `Error: Non-interactive mode requires: ${REQUIRED_FLAGS.map((f) => `--${f}`).join(\", \")}`,\n    );\n    console.error(`Missing: ${missing.map((f) => `--${f}`).join(\", \")}`);\n    console.error(\n      '  appkit plugin create --placement in-repo --path plugins/my-plugin --name myPlugin --description \"Does X\"',\n    );\n    process.exit(1);\n  }\n\n  const placement = opts.placement as Placement;\n  if (!VALID_PLACEMENTS.includes(placement)) {\n    console.error(\n      `Error: --placement must be one of: ${VALID_PLACEMENTS.join(\", \")}`,\n    );\n    process.exit(1);\n  }\n\n  const targetPath = (opts.path as string).trim();\n  if (\n    placement === \"in-repo\" &&\n    (path.isAbsolute(targetPath) || targetPath.startsWith(\"..\"))\n  ) {\n    console.error(\n      \"Error: --path must be a relative path under the current directory for in-repo plugins.\",\n    );\n    process.exit(1);\n  }\n\n  const name = opts.name as string;\n  if (!PLUGIN_NAME_PATTERN.test(name)) {\n    console.error(\n      \"Error: --name must start with a lowercase letter and be camelCase (letters and numbers only, e.g. myPlugin).\",\n    );\n    process.exit(1);\n  }\n\n  let resources: SelectedResource[] = [];\n  if (opts.resourcesJson) {\n    resources = parseResourcesJson(opts.resourcesJson);\n  } else if (opts.resources) {\n    resources = parseResourcesShorthand(opts.resources);\n  }\n\n  const answers: CreateAnswers = {\n    placement,\n    targetPath,\n    name: name.trim(),\n    displayName: opts.displayName?.trim() || deriveDisplayName(name),\n    description: (opts.description as string).trim(),\n    resources,\n    version: DEFAULT_VERSION,\n  };\n\n  const targetDir = resolveTargetDir(process.cwd(), answers);\n  const dirExists = fs.existsSync(targetDir);\n  const hasContent = dirExists && fs.readdirSync(targetDir).length > 0;\n  if (hasContent && !opts.force) {\n    console.error(\n      `Error: Directory ${answers.targetPath} already exists and is not empty.`,\n    );\n    console.error(\"  Use --force to overwrite.\");\n    process.exit(1);\n  }\n\n  scaffoldPlugin(targetDir, answers, { isolated: placement === \"isolated\" });\n\n  console.log(\n    `Plugin \"${answers.name}\" created at ${path.relative(process.cwd(), targetDir)}`,\n  );\n  printNextSteps(answers, targetDir);\n}\n\nasync function runInteractive(): Promise<void> {\n  intro(\"Create a new AppKit plugin\");\n\n  try {\n    const placement = await select<Placement>({\n      message: \"Where should the plugin live?\",\n      options: [\n        {\n          value: \"in-repo\",\n          label: \"In this repository (e.g. plugins/my-plugin)\",\n          hint: \"folder path\",\n        },\n        {\n          value: \"isolated\",\n          label: \"New isolated package\",\n          hint: \"full package with package.json\",\n        },\n      ],\n    });\n    if (isCancel(placement)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const placementPrompt =\n      placement === \"in-repo\"\n        ? \"Folder path for the plugin (e.g. plugins/my-feature)\"\n        : \"Directory name for the new package (e.g. appkit-plugin-my-feature)\";\n    const targetPath = await text({\n      message: placementPrompt,\n      placeholder:\n        placement === \"in-repo\"\n          ? \"plugins/my-plugin\"\n          : \"appkit-plugin-my-feature\",\n      validate(value) {\n        if (!value?.trim()) return \"Path is required.\";\n        if (\n          placement === \"in-repo\" &&\n          (path.isAbsolute(value) || value.trim().startsWith(\"..\"))\n        ) {\n          return \"Use a relative path under the current directory (e.g. plugins/my-plugin).\";\n        }\n        return undefined;\n      },\n    });\n    if (isCancel(targetPath)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const name = await text({\n      message: \"Plugin name (id)\",\n      placeholder: \"myPlugin\",\n      validate(value) {\n        if (!value?.trim()) return \"Name is required.\";\n        if (!PLUGIN_NAME_PATTERN.test(value as string)) {\n          return \"Must start with a lowercase letter and be camelCase (letters and numbers only, e.g. myPlugin).\";\n        }\n        return undefined;\n      },\n    });\n    if (isCancel(name)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const displayName = await text({\n      message: \"Display name\",\n      placeholder: \"My Plugin\",\n      initialValue: name\n        .split(\"-\")\n        .map((s) => s.charAt(0).toUpperCase() + s.slice(1))\n        .join(\" \"),\n      validate(value) {\n        if (!value?.trim()) return \"Display name is required.\";\n        return undefined;\n      },\n    });\n    if (isCancel(displayName)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const description = await text({\n      message: \"Short description\",\n      placeholder: \"What does this plugin do?\",\n      validate(value) {\n        if (!value?.trim()) return \"Description is required.\";\n        return undefined;\n      },\n    });\n    if (isCancel(description)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const stability = await select<\"ga\" | \"beta\">({\n      message: \"Plugin stability level\",\n      options: [\n        { value: \"ga\", label: \"GA\", hint: \"API follows semver\" },\n        {\n          value: \"beta\",\n          label: \"Beta\",\n          hint: \"Heading to GA, API may change\",\n        },\n      ],\n      initialValue: \"ga\" as \"ga\" | \"beta\",\n    });\n    if (isCancel(stability)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const resourceTypes = await multiselect({\n      message: \"Which Databricks resources does this plugin need?\",\n      options: RESOURCE_TYPE_OPTIONS.map((o) => ({\n        value: o.value,\n        label: o.label,\n      })),\n      required: false,\n    });\n    if (isCancel(resourceTypes)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const resources: CreateAnswers[\"resources\"] = [];\n    for (const type of resourceTypes as string[]) {\n      const spec = await promptOneResource({ type });\n      if (!spec) {\n        cancel(\"Cancelled.\");\n        process.exit(0);\n      }\n      resources.push({\n        type: spec.type,\n        required: spec.required,\n        description: spec.description,\n        resourceKey: spec.resourceKey,\n        permission: spec.permission,\n        fields: spec.fields,\n      });\n    }\n\n    const answers: CreateAnswers = {\n      placement,\n      targetPath: (targetPath as string).trim(),\n      name: (name as string).trim(),\n      displayName: (displayName as string).trim(),\n      description: (description as string).trim(),\n      stability: stability === \"ga\" ? undefined : stability,\n      resources,\n      version: DEFAULT_VERSION,\n    };\n\n    const targetDir = resolveTargetDir(process.cwd(), answers);\n    const dirExists = fs.existsSync(targetDir);\n    const hasContent = dirExists && fs.readdirSync(targetDir).length > 0;\n    if (hasContent) {\n      const overwrite = await confirm({\n        message: `Directory ${answers.targetPath} already exists and is not empty. Overwrite?`,\n        initialValue: false,\n      });\n      if (isCancel(overwrite) || !overwrite) {\n        cancel(\"Cancelled.\");\n        process.exit(0);\n      }\n    }\n\n    const s = spinner();\n    s.start(\"Writing files…\");\n    try {\n      scaffoldPlugin(targetDir, answers, {\n        isolated: placement === \"isolated\",\n      });\n      s.stop(\"Files written.\");\n    } catch (err) {\n      s.stop(\"Failed.\");\n      throw err;\n    }\n\n    outro(\"Plugin created successfully.\");\n    printNextSteps(answers, targetDir);\n  } catch (err) {\n    console.error(err);\n    process.exit(1);\n  }\n}\n\nconst OPTIONAL_FLAGS = [\n  \"displayName\",\n  \"resources\",\n  \"resourcesJson\",\n  \"force\",\n] as const;\n\nasync function runPluginCreate(opts: CreateOptions): Promise<void> {\n  const hasRequiredFlag = REQUIRED_FLAGS.some((f) => opts[f] !== undefined);\n  if (hasRequiredFlag) {\n    runNonInteractive(opts);\n  } else {\n    const hasOptionalOnly = OPTIONAL_FLAGS.some(\n      (f) => opts[f] !== undefined && opts[f] !== false,\n    );\n    if (hasOptionalOnly) {\n      console.error(\n        `Error: Non-interactive mode requires: ${REQUIRED_FLAGS.map((f) => `--${f}`).join(\", \")}`,\n      );\n      console.error(\n        '  appkit plugin create --placement in-repo --path plugins/my-plugin --name myPlugin --description \"Does X\"',\n      );\n      process.exit(1);\n    }\n    await runInteractive();\n  }\n}\n\nexport const pluginCreateCommand = new Command(\"create\")\n  .description(\"Scaffold a new AppKit plugin\")\n  .option(\"--placement <type>\", \"Where the plugin lives (in-repo, isolated)\")\n  .option(\"--path <dir>\", \"Target directory for the plugin\")\n  .option(\"--name <id>\", \"Plugin name (lowercase, hyphens allowed)\")\n  .option(\"--display-name <name>\", \"Human-readable display name\")\n  .option(\"--description <text>\", \"Short description of the plugin\")\n  .addOption(\n    new Option(\n      \"--resources <types>\",\n      \"Comma-separated resource types (e.g. sql_warehouse,volume)\",\n    ).conflicts(\"resourcesJson\"),\n  )\n  .addOption(\n    new Option(\n      \"--resources-json <json>\",\n      'JSON array of resource specs (e.g. \\'[{\"type\":\"sql_warehouse\"}]\\')',\n    ).conflicts(\"resources\"),\n  )\n  .option(\"-f, --force\", \"Overwrite existing directory without confirmation\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ appkit plugin create\n  $ appkit plugin create --placement in-repo --path plugins/my-plugin --name myPlugin --description \"Does X\"\n  $ appkit plugin create --placement in-repo --path plugins/my-plugin --name myPlugin --description \"Does X\" --resources sql_warehouse,volume --force\n  $ appkit plugin create --placement isolated --path appkit-plugin-ml --name ml --description \"ML\" --resources-json '[{\"type\":\"serving_endpoint\"}]'`,\n  )\n  .action((opts) =>\n    runPluginCreate(opts).catch((err) => {\n      console.error(err);\n      process.exit(1);\n    }),\n  );\n\n/** Exported for testing. */\nexport { buildResourceFromType, parseResourcesJson, parseResourcesShorthand };\n"],"mappings":"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"}
+{"version":3,"file":"create.js","names":[],"sources":["../../../../../src/cli/commands/plugin/create/create.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport process from \"node:process\";\n\nimport {\n  cancel,\n  confirm,\n  intro,\n  isCancel,\n  multiselect,\n  outro,\n  select,\n  spinner,\n  text,\n} from \"@clack/prompts\";\nimport { Command, Option } from \"commander\";\n\nimport { PLUGIN_NAME_PATTERN } from \"../../../../naming\";\nimport { promptOneResource } from \"./prompt-resource\";\nimport {\n  DEFAULT_PERMISSION_BY_TYPE,\n  getDefaultFieldsForType,\n  getValidResourceTypes,\n  humanizeResourceType,\n  RESOURCE_TYPE_OPTIONS,\n  resourceKeyFromType,\n} from \"./resource-defaults\";\nimport { resolveTargetDir, scaffoldPlugin } from \"./scaffold\";\nimport type { CreateAnswers, Placement, SelectedResource } from \"./types\";\n\nconst DEFAULT_VERSION = \"0.1.0\";\nconst VALID_PLACEMENTS: Placement[] = [\"in-repo\", \"isolated\"];\nconst REQUIRED_FLAGS = [\"placement\", \"path\", \"name\", \"description\"] as const;\n\ninterface CreateOptions {\n  placement?: string;\n  path?: string;\n  name?: string;\n  displayName?: string;\n  description?: string;\n  resources?: string;\n  resourcesJson?: string;\n  force?: boolean;\n}\n\nfunction deriveDisplayName(name: string): string {\n  // camelCase -> Title Case words (e.g. \"myPlugin\" -> \"My Plugin\").\n  const spaced = name.replace(/([a-z0-9])([A-Z])/g, \"$1 $2\");\n  return spaced.charAt(0).toUpperCase() + spaced.slice(1);\n}\n\nfunction buildResourceFromType(type: string): SelectedResource {\n  return {\n    type,\n    required: true,\n    description: `Required for ${humanizeResourceType(type)} functionality.`,\n    resourceKey: resourceKeyFromType(type),\n    permission: DEFAULT_PERMISSION_BY_TYPE[type] ?? \"CAN_VIEW\",\n    fields: getDefaultFieldsForType(type),\n  };\n}\n\ninterface JsonResourceEntry {\n  type: string;\n  required?: boolean;\n  description?: string;\n  resourceKey?: string;\n  permission?: string;\n  fields?: Record<string, { env: string; description?: string }>;\n}\n\nfunction parseResourcesJson(json: string): SelectedResource[] {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(json);\n  } catch {\n    console.error(\"Error: --resources-json must be valid JSON.\");\n    console.error('  Example: --resources-json \\'[{\"type\":\"sql_warehouse\"}]\\'');\n    process.exit(1);\n  }\n\n  if (!Array.isArray(parsed)) {\n    console.error(\"Error: --resources-json must be a JSON array.\");\n    console.error('  Example: --resources-json \\'[{\"type\":\"sql_warehouse\"}]\\'');\n    process.exit(1);\n  }\n\n  return (parsed as JsonResourceEntry[]).map((entry, i) => {\n    if (entry == null || typeof entry !== \"object\") {\n      console.error(`Error: --resources-json entry ${i} is not an object.`);\n      process.exit(1);\n    }\n    if (!entry.type || typeof entry.type !== \"string\") {\n      console.error(\n        `Error: --resources-json entry ${i} missing required \"type\" field.`,\n      );\n      process.exit(1);\n    }\n    validateResourceType(entry.type);\n    const defaults = buildResourceFromType(entry.type);\n    return {\n      type: entry.type,\n      required: entry.required ?? defaults.required,\n      description: entry.description ?? defaults.description,\n      resourceKey: entry.resourceKey ?? defaults.resourceKey,\n      permission: entry.permission ?? defaults.permission,\n      fields: entry.fields ?? defaults.fields,\n    };\n  });\n}\n\nfunction validateResourceType(type: string): void {\n  const validTypes = getValidResourceTypes();\n  if (!validTypes.includes(type)) {\n    console.error(`Error: Unknown resource type \"${type}\".`);\n    console.error(`  Valid types: ${validTypes.join(\", \")}`);\n    process.exit(1);\n  }\n}\n\nfunction parseResourcesShorthand(csv: string): SelectedResource[] {\n  const types = csv\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter(Boolean);\n  for (const t of types) validateResourceType(t);\n  return types.map(buildResourceFromType);\n}\n\nfunction printNextSteps(answers: CreateAnswers, targetDir: string): void {\n  const relativePath = path.relative(process.cwd(), targetDir);\n  const importPath = relativePath.startsWith(\".\")\n    ? relativePath\n    : `./${relativePath}`;\n  // The camelCase plugin name is already the JS binding.\n  const exportName = answers.name;\n\n  console.log(\"\\nNext steps:\\n\");\n  if (answers.placement === \"in-repo\") {\n    console.log(`  1. Import and register in your server:`);\n    console.log(`     import { ${exportName} } from \"${importPath}\";`);\n    console.log(`     createApp({ plugins: [ ..., ${exportName}() ] });`);\n    console.log(\n      `  2. Run \\`npx appkit plugin sync --write\\` to update appkit.plugins.json.\\n`,\n    );\n  } else {\n    console.log(`  1. cd into the new package and install dependencies:`);\n    console.log(`     cd ${answers.targetPath} && pnpm install`);\n    console.log(`  2. Build: pnpm build`);\n    console.log(\n      `  3. In your app: pnpm add ./${answers.targetPath} @databricks/appkit`,\n    );\n    console.log(\n      `  4. Import and register: import { ${exportName} } from \"<package-name>\";\\n`,\n    );\n  }\n}\n\nfunction runNonInteractive(opts: CreateOptions): void {\n  const missing = REQUIRED_FLAGS.filter((f) => !opts[f]);\n  if (missing.length > 0) {\n    console.error(\n      `Error: Non-interactive mode requires: ${REQUIRED_FLAGS.map((f) => `--${f}`).join(\", \")}`,\n    );\n    console.error(`Missing: ${missing.map((f) => `--${f}`).join(\", \")}`);\n    console.error(\n      '  appkit plugin create --placement in-repo --path plugins/my-plugin --name myPlugin --description \"Does X\"',\n    );\n    process.exit(1);\n  }\n\n  const placement = opts.placement as Placement;\n  if (!VALID_PLACEMENTS.includes(placement)) {\n    console.error(\n      `Error: --placement must be one of: ${VALID_PLACEMENTS.join(\", \")}`,\n    );\n    process.exit(1);\n  }\n\n  const targetPath = (opts.path as string).trim();\n  if (\n    placement === \"in-repo\" &&\n    (path.isAbsolute(targetPath) || targetPath.startsWith(\"..\"))\n  ) {\n    console.error(\n      \"Error: --path must be a relative path under the current directory for in-repo plugins.\",\n    );\n    process.exit(1);\n  }\n\n  const name = opts.name as string;\n  if (!PLUGIN_NAME_PATTERN.test(name)) {\n    console.error(\n      \"Error: --name must start with a lowercase letter and be camelCase (letters and numbers only, e.g. myPlugin).\",\n    );\n    process.exit(1);\n  }\n\n  let resources: SelectedResource[] = [];\n  if (opts.resourcesJson) {\n    resources = parseResourcesJson(opts.resourcesJson);\n  } else if (opts.resources) {\n    resources = parseResourcesShorthand(opts.resources);\n  }\n\n  const answers: CreateAnswers = {\n    placement,\n    targetPath,\n    name: name.trim(),\n    displayName: opts.displayName?.trim() || deriveDisplayName(name),\n    description: (opts.description as string).trim(),\n    resources,\n    version: DEFAULT_VERSION,\n  };\n\n  const targetDir = resolveTargetDir(process.cwd(), answers);\n  const dirExists = fs.existsSync(targetDir);\n  const hasContent = dirExists && fs.readdirSync(targetDir).length > 0;\n  if (hasContent && !opts.force) {\n    console.error(\n      `Error: Directory ${answers.targetPath} already exists and is not empty.`,\n    );\n    console.error(\"  Use --force to overwrite.\");\n    process.exit(1);\n  }\n\n  scaffoldPlugin(targetDir, answers, { isolated: placement === \"isolated\" });\n\n  console.log(\n    `Plugin \"${answers.name}\" created at ${path.relative(process.cwd(), targetDir)}`,\n  );\n  printNextSteps(answers, targetDir);\n}\n\nasync function runInteractive(): Promise<void> {\n  intro(\"Create a new AppKit plugin\");\n\n  try {\n    const placement = await select<Placement>({\n      message: \"Where should the plugin live?\",\n      options: [\n        {\n          value: \"in-repo\",\n          label: \"In this repository (e.g. plugins/my-plugin)\",\n          hint: \"folder path\",\n        },\n        {\n          value: \"isolated\",\n          label: \"New isolated package\",\n          hint: \"full package with package.json\",\n        },\n      ],\n    });\n    if (isCancel(placement)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const placementPrompt =\n      placement === \"in-repo\"\n        ? \"Folder path for the plugin (e.g. plugins/my-feature)\"\n        : \"Directory name for the new package (e.g. appkit-plugin-my-feature)\";\n    const targetPath = await text({\n      message: placementPrompt,\n      placeholder:\n        placement === \"in-repo\"\n          ? \"plugins/my-plugin\"\n          : \"appkit-plugin-my-feature\",\n      validate(value) {\n        if (!value?.trim()) return \"Path is required.\";\n        if (\n          placement === \"in-repo\" &&\n          (path.isAbsolute(value) || value.trim().startsWith(\"..\"))\n        ) {\n          return \"Use a relative path under the current directory (e.g. plugins/my-plugin).\";\n        }\n        return undefined;\n      },\n    });\n    if (isCancel(targetPath)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const name = await text({\n      message: \"Plugin name (id)\",\n      placeholder: \"myPlugin\",\n      validate(value) {\n        if (!value?.trim()) return \"Name is required.\";\n        if (!PLUGIN_NAME_PATTERN.test(value as string)) {\n          return \"Must start with a lowercase letter and be camelCase (letters and numbers only, e.g. myPlugin).\";\n        }\n        return undefined;\n      },\n    });\n    if (isCancel(name)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const displayName = await text({\n      message: \"Display name\",\n      placeholder: \"My Plugin\",\n      initialValue: name\n        .split(\"-\")\n        .map((s) => s.charAt(0).toUpperCase() + s.slice(1))\n        .join(\" \"),\n      validate(value) {\n        if (!value?.trim()) return \"Display name is required.\";\n        return undefined;\n      },\n    });\n    if (isCancel(displayName)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const description = await text({\n      message: \"Short description\",\n      placeholder: \"What does this plugin do?\",\n      validate(value) {\n        if (!value?.trim()) return \"Description is required.\";\n        return undefined;\n      },\n    });\n    if (isCancel(description)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const stability = await select<\"ga\" | \"beta\">({\n      message: \"Plugin stability level\",\n      options: [\n        { value: \"ga\", label: \"GA\", hint: \"API follows semver\" },\n        {\n          value: \"beta\",\n          label: \"Beta\",\n          hint: \"Heading to GA, API may change\",\n        },\n      ],\n      initialValue: \"ga\" as \"ga\" | \"beta\",\n    });\n    if (isCancel(stability)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const resourceTypes = await multiselect({\n      message: \"Which Databricks resources does this plugin need?\",\n      options: RESOURCE_TYPE_OPTIONS.map((o) => ({\n        value: o.value,\n        label: o.label,\n      })),\n      required: false,\n    });\n    if (isCancel(resourceTypes)) {\n      cancel(\"Cancelled.\");\n      process.exit(0);\n    }\n\n    const resources: CreateAnswers[\"resources\"] = [];\n    for (const type of resourceTypes as string[]) {\n      const spec = await promptOneResource({ type });\n      if (!spec) {\n        cancel(\"Cancelled.\");\n        process.exit(0);\n      }\n      resources.push({\n        type: spec.type,\n        required: spec.required,\n        description: spec.description,\n        resourceKey: spec.resourceKey,\n        permission: spec.permission,\n        fields: spec.fields,\n      });\n    }\n\n    const answers: CreateAnswers = {\n      placement,\n      targetPath: (targetPath as string).trim(),\n      name: (name as string).trim(),\n      displayName: (displayName as string).trim(),\n      description: (description as string).trim(),\n      stability: stability === \"ga\" ? undefined : stability,\n      resources,\n      version: DEFAULT_VERSION,\n    };\n\n    const targetDir = resolveTargetDir(process.cwd(), answers);\n    const dirExists = fs.existsSync(targetDir);\n    const hasContent = dirExists && fs.readdirSync(targetDir).length > 0;\n    if (hasContent) {\n      const overwrite = await confirm({\n        message: `Directory ${answers.targetPath} already exists and is not empty. Overwrite?`,\n        initialValue: false,\n      });\n      if (isCancel(overwrite) || !overwrite) {\n        cancel(\"Cancelled.\");\n        process.exit(0);\n      }\n    }\n\n    const s = spinner();\n    s.start(\"Writing files…\");\n    try {\n      scaffoldPlugin(targetDir, answers, {\n        isolated: placement === \"isolated\",\n      });\n      s.stop(\"Files written.\");\n    } catch (err) {\n      s.stop(\"Failed.\");\n      throw err;\n    }\n\n    outro(\"Plugin created successfully.\");\n    printNextSteps(answers, targetDir);\n  } catch (err) {\n    console.error(err);\n    process.exit(1);\n  }\n}\n\nconst OPTIONAL_FLAGS = [\n  \"displayName\",\n  \"resources\",\n  \"resourcesJson\",\n  \"force\",\n] as const;\n\nasync function runPluginCreate(opts: CreateOptions): Promise<void> {\n  const hasRequiredFlag = REQUIRED_FLAGS.some((f) => opts[f] !== undefined);\n  if (hasRequiredFlag) {\n    runNonInteractive(opts);\n  } else {\n    const hasOptionalOnly = OPTIONAL_FLAGS.some(\n      (f) => opts[f] !== undefined && opts[f] !== false,\n    );\n    if (hasOptionalOnly) {\n      console.error(\n        `Error: Non-interactive mode requires: ${REQUIRED_FLAGS.map((f) => `--${f}`).join(\", \")}`,\n      );\n      console.error(\n        '  appkit plugin create --placement in-repo --path plugins/my-plugin --name myPlugin --description \"Does X\"',\n      );\n      process.exit(1);\n    }\n    await runInteractive();\n  }\n}\n\nexport const pluginCreateCommand = new Command(\"create\")\n  .description(\"Scaffold a new AppKit plugin\")\n  .option(\"--placement <type>\", \"Where the plugin lives (in-repo, isolated)\")\n  .option(\"--path <dir>\", \"Target directory for the plugin\")\n  .option(\"--name <id>\", \"Plugin name (lowercase, hyphens allowed)\")\n  .option(\"--display-name <name>\", \"Human-readable display name\")\n  .option(\"--description <text>\", \"Short description of the plugin\")\n  .addOption(\n    new Option(\n      \"--resources <types>\",\n      \"Comma-separated resource types (e.g. sql_warehouse,volume)\",\n    ).conflicts(\"resourcesJson\"),\n  )\n  .addOption(\n    new Option(\n      \"--resources-json <json>\",\n      'JSON array of resource specs (e.g. \\'[{\"type\":\"sql_warehouse\"}]\\')',\n    ).conflicts(\"resources\"),\n  )\n  .option(\"-f, --force\", \"Overwrite existing directory without confirmation\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ appkit plugin create\n  $ appkit plugin create --placement in-repo --path plugins/my-plugin --name myPlugin --description \"Does X\"\n  $ appkit plugin create --placement in-repo --path plugins/my-plugin --name myPlugin --description \"Does X\" --resources sql_warehouse,volume --force\n  $ appkit plugin create --placement isolated --path appkit-plugin-ml --name ml --description \"ML\" --resources-json '[{\"type\":\"serving_endpoint\"}]'`,\n  )\n  .action((opts) =>\n    runPluginCreate(opts).catch((err) => {\n      console.error(err);\n      process.exit(1);\n    }),\n  );\n\n/** Exported for testing. */\nexport { buildResourceFromType, parseResourcesJson, parseResourcesShorthand };\n"],"mappings":"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"}

package/dist/cli/commands/plugin/create/prompt-resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-resource.js","names":[],"sources":["../../../../../src/cli/commands/plugin/create/prompt-resource.ts"],"sourcesContent":["import { isCancel, select, text } from \"@clack/prompts\";\nimport {\n  getDefaultFieldsForType,\n  humanizeResourceType,\n  PERMISSIONS_BY_TYPE,\n  RESOURCE_TYPE_OPTIONS,\n  resourceKeyFromType,\n} from \"./resource-defaults\";\n\n/** Full resource spec collected from prompts (shared by create and add-resource). */\nexport interface ResourceSpec {\n  type: string;\n  required: boolean;\n  description: string;\n  resourceKey: string;\n  permission: string;\n  fields: Record<string, { env: string; description?: string }>;\n}\n\n/**\n * Prompt for a single resource: type (optional), required, description, resourceKey, permission, and field env vars.\n * When type is provided (e.g. from create's multiselect), type prompt is skipped.\n */\nexport async function promptOneResource(opts?: {\n  type?: string;\n}): Promise<ResourceSpec | null> {\n  let type = opts?.type;\n\n  if (!type) {\n    const resourceType = await select({\n      message: \"Resource type\",\n      options: RESOURCE_TYPE_OPTIONS.map((o) => ({\n        value: o.value,\n        label: o.label,\n      })),\n    });\n    if (isCancel(resourceType)) return null;\n    type = resourceType as string;\n  }\n\n  const required = await select<boolean>({\n    message: `${humanizeResourceType(type)} – required or optional?`,\n    options: [\n      { value: true, label: \"Required\", hint: \"plugin needs it to function\" },\n      { value: false, label: \"Optional\", hint: \"enhances functionality\" },\n    ],\n  });\n  if (isCancel(required)) return null;\n\n  const description = await text({\n    message: `Short description for ${humanizeResourceType(type)}`,\n    placeholder: required ? \"Required for …\" : \"Optional for …\",\n  });\n  if (isCancel(description)) return null;\n\n  const defaultKey = resourceKeyFromType(type);\n  const resourceKey = await text({\n    message: \"Resource key (unique identifier within the manifest)\",\n    initialValue: defaultKey,\n    placeholder: defaultKey,\n    validate: (val = \"\") => {\n      if (!val.trim()) return \"Resource key is required\";\n      if (!/^[a-z][a-z0-9-]*$/.test(val))\n        return \"Must be lowercase, start with a letter, and contain only letters, numbers, and hyphens\";\n    },\n  });\n  if (isCancel(resourceKey)) return null;\n\n  const typePermissions = PERMISSIONS_BY_TYPE[type] ?? [\"CAN_VIEW\"];\n  let permission: string;\n  if (typePermissions.length === 1) {\n    permission = typePermissions[0];\n  } else {\n    const selected = await select({\n      message: \"Permission level\",\n      options: typePermissions.map((p) => ({ value: p, label: p })),\n    });\n    if (isCancel(selected)) return null;\n    permission = selected as string;\n  }\n\n  const defaultFields = getDefaultFieldsForType(type);\n  const fields: Record<string, { env: string; description?: string }> = {};\n\n  for (const [fieldKey, defaults] of Object.entries(defaultFields)) {\n    const envName = await text({\n      message: `Env var for \"${fieldKey}\"${defaults.description ? ` (${defaults.description})` : \"\"}`,\n      initialValue: defaults.env,\n      placeholder: defaults.env,\n      validate: (val = \"\") => {\n        if (!val.trim()) return \"Env var name is required\";\n        if (!/^[A-Z][A-Z0-9_]*$/.test(val))\n          return \"Must be uppercase, start with a letter (e.g. DATABRICKS_WAREHOUSE_ID)\";\n      },\n    });\n    if (isCancel(envName)) return null;\n    fields[fieldKey] = {\n      env: (envName as string).trim(),\n      ...(defaults.description ? { description: defaults.description } : {}),\n    };\n  }\n\n  return {\n    type,\n    required: required as boolean,\n    description: (description as string)?.trim() || \"\",\n    resourceKey: (resourceKey as string).trim(),\n    permission,\n    fields,\n  };\n}\n"],"mappings":";;;;;;;;AAuBA,eAAsB,kBAAkB,MAEP;CAC/B,IAAI,OAAO,MAAM;AAEjB,KAAI,CAAC,MAAM;EACT,MAAM,eAAe,MAAM,OAAO;GAChC,SAAS;GACT,SAAS,sBAAsB,KAAK,OAAO;IACzC,OAAO,EAAE;IACT,OAAO,EAAE;IACV,EAAE;GACJ,CAAC;AACF,MAAI,SAAS,aAAa,CAAE,QAAO;AACnC,SAAO;;CAGT,MAAM,WAAW,MAAM,OAAgB;EACrC,SAAS,GAAG,qBAAqB,KAAK,CAAC;EACvC,SAAS,CACP;GAAE,OAAO;GAAM,OAAO;GAAY,MAAM;GAA+B,EACvE;GAAE,OAAO;GAAO,OAAO;GAAY,MAAM;GAA0B,CACpE;EACF,CAAC;AACF,KAAI,SAAS,SAAS,CAAE,QAAO;CAE/B,MAAM,cAAc,MAAM,KAAK;EAC7B,SAAS,yBAAyB,qBAAqB,KAAK;EAC5D,aAAa,WAAW,mBAAmB;EAC5C,CAAC;AACF,KAAI,SAAS,YAAY,CAAE,QAAO;CAElC,MAAM,aAAa,oBAAoB,KAAK;CAC5C,MAAM,cAAc,MAAM,KAAK;EAC7B,SAAS;EACT,cAAc;EACd,aAAa;EACb,WAAW,MAAM,OAAO;AACtB,OAAI,CAAC,IAAI,MAAM,CAAE,QAAO;AACxB,OAAI,CAAC,oBAAoB,KAAK,IAAI,CAChC,QAAO;;EAEZ,CAAC;AACF,KAAI,SAAS,YAAY,CAAE,QAAO;CAElC,MAAM,kBAAkB,oBAAoB,SAAS,CAAC,WAAW;CACjE,IAAI;AACJ,KAAI,gBAAgB,WAAW,EAC7B,cAAa,gBAAgB;MACxB;EACL,MAAM,WAAW,MAAM,OAAO;GAC5B,SAAS;GACT,SAAS,gBAAgB,KAAK,OAAO;IAAE,OAAO;IAAG,OAAO;IAAG,EAAE;GAC9D,CAAC;AACF,MAAI,SAAS,SAAS,CAAE,QAAO;AAC/B,eAAa;;CAGf,MAAM,gBAAgB,wBAAwB,KAAK;CACnD,MAAM,SAAgE,EAAE;AAExE,MAAK,MAAM,CAAC,UAAU,aAAa,OAAO,QAAQ,cAAc,EAAE;EAChE,MAAM,UAAU,MAAM,KAAK;GACzB,SAAS,gBAAgB,SAAS,GAAG,SAAS,cAAc,KAAK,SAAS,YAAY,KAAK;GAC3F,cAAc,SAAS;GACvB,aAAa,SAAS;GACtB,WAAW,MAAM,OAAO;AACtB,QAAI,CAAC,IAAI,MAAM,CAAE,QAAO;AACxB,QAAI,CAAC,oBAAoB,KAAK,IAAI,CAChC,QAAO;;GAEZ,CAAC;AACF,MAAI,SAAS,QAAQ,CAAE,QAAO;AAC9B,SAAO,YAAY;GACjB,KAAM,QAAmB,MAAM;GAC/B,GAAI,SAAS,cAAc,EAAE,aAAa,SAAS,aAAa,GAAG,EAAE;GACtE;;AAGH,QAAO;EACL;EACU;EACV,aAAc,aAAwB,MAAM,IAAI;EAChD,aAAc,YAAuB,MAAM;EAC3C;EACA;EACD"}
+{"version":3,"file":"prompt-resource.js","names":[],"sources":["../../../../../src/cli/commands/plugin/create/prompt-resource.ts"],"sourcesContent":["import { isCancel, select, text } from \"@clack/prompts\";\n\nimport {\n  getDefaultFieldsForType,\n  humanizeResourceType,\n  PERMISSIONS_BY_TYPE,\n  RESOURCE_TYPE_OPTIONS,\n  resourceKeyFromType,\n} from \"./resource-defaults\";\n\n/** Full resource spec collected from prompts (shared by create and add-resource). */\nexport interface ResourceSpec {\n  type: string;\n  required: boolean;\n  description: string;\n  resourceKey: string;\n  permission: string;\n  fields: Record<string, { env: string; description?: string }>;\n}\n\n/**\n * Prompt for a single resource: type (optional), required, description, resourceKey, permission, and field env vars.\n * When type is provided (e.g. from create's multiselect), type prompt is skipped.\n */\nexport async function promptOneResource(opts?: {\n  type?: string;\n}): Promise<ResourceSpec | null> {\n  let type = opts?.type;\n\n  if (!type) {\n    const resourceType = await select({\n      message: \"Resource type\",\n      options: RESOURCE_TYPE_OPTIONS.map((o) => ({\n        value: o.value,\n        label: o.label,\n      })),\n    });\n    if (isCancel(resourceType)) return null;\n    type = resourceType as string;\n  }\n\n  const required = await select<boolean>({\n    message: `${humanizeResourceType(type)} – required or optional?`,\n    options: [\n      { value: true, label: \"Required\", hint: \"plugin needs it to function\" },\n      { value: false, label: \"Optional\", hint: \"enhances functionality\" },\n    ],\n  });\n  if (isCancel(required)) return null;\n\n  const description = await text({\n    message: `Short description for ${humanizeResourceType(type)}`,\n    placeholder: required ? \"Required for …\" : \"Optional for …\",\n  });\n  if (isCancel(description)) return null;\n\n  const defaultKey = resourceKeyFromType(type);\n  const resourceKey = await text({\n    message: \"Resource key (unique identifier within the manifest)\",\n    initialValue: defaultKey,\n    placeholder: defaultKey,\n    validate: (val = \"\") => {\n      if (!val.trim()) return \"Resource key is required\";\n      if (!/^[a-z][a-z0-9-]*$/.test(val))\n        return \"Must be lowercase, start with a letter, and contain only letters, numbers, and hyphens\";\n    },\n  });\n  if (isCancel(resourceKey)) return null;\n\n  const typePermissions = PERMISSIONS_BY_TYPE[type] ?? [\"CAN_VIEW\"];\n  let permission: string;\n  if (typePermissions.length === 1) {\n    permission = typePermissions[0];\n  } else {\n    const selected = await select({\n      message: \"Permission level\",\n      options: typePermissions.map((p) => ({ value: p, label: p })),\n    });\n    if (isCancel(selected)) return null;\n    permission = selected as string;\n  }\n\n  const defaultFields = getDefaultFieldsForType(type);\n  const fields: Record<string, { env: string; description?: string }> = {};\n\n  for (const [fieldKey, defaults] of Object.entries(defaultFields)) {\n    const envName = await text({\n      message: `Env var for \"${fieldKey}\"${defaults.description ? ` (${defaults.description})` : \"\"}`,\n      initialValue: defaults.env,\n      placeholder: defaults.env,\n      validate: (val = \"\") => {\n        if (!val.trim()) return \"Env var name is required\";\n        if (!/^[A-Z][A-Z0-9_]*$/.test(val))\n          return \"Must be uppercase, start with a letter (e.g. DATABRICKS_WAREHOUSE_ID)\";\n      },\n    });\n    if (isCancel(envName)) return null;\n    fields[fieldKey] = {\n      env: (envName as string).trim(),\n      ...(defaults.description ? { description: defaults.description } : {}),\n    };\n  }\n\n  return {\n    type,\n    required: required as boolean,\n    description: (description as string)?.trim() || \"\",\n    resourceKey: (resourceKey as string).trim(),\n    permission,\n    fields,\n  };\n}\n"],"mappings":";;;;;;;;AAwBA,eAAsB,kBAAkB,MAEP;CAC/B,IAAI,OAAO,MAAM;AAEjB,KAAI,CAAC,MAAM;EACT,MAAM,eAAe,MAAM,OAAO;GAChC,SAAS;GACT,SAAS,sBAAsB,KAAK,OAAO;IACzC,OAAO,EAAE;IACT,OAAO,EAAE;IACV,EAAE;GACJ,CAAC;AACF,MAAI,SAAS,aAAa,CAAE,QAAO;AACnC,SAAO;;CAGT,MAAM,WAAW,MAAM,OAAgB;EACrC,SAAS,GAAG,qBAAqB,KAAK,CAAC;EACvC,SAAS,CACP;GAAE,OAAO;GAAM,OAAO;GAAY,MAAM;GAA+B,EACvE;GAAE,OAAO;GAAO,OAAO;GAAY,MAAM;GAA0B,CACpE;EACF,CAAC;AACF,KAAI,SAAS,SAAS,CAAE,QAAO;CAE/B,MAAM,cAAc,MAAM,KAAK;EAC7B,SAAS,yBAAyB,qBAAqB,KAAK;EAC5D,aAAa,WAAW,mBAAmB;EAC5C,CAAC;AACF,KAAI,SAAS,YAAY,CAAE,QAAO;CAElC,MAAM,aAAa,oBAAoB,KAAK;CAC5C,MAAM,cAAc,MAAM,KAAK;EAC7B,SAAS;EACT,cAAc;EACd,aAAa;EACb,WAAW,MAAM,OAAO;AACtB,OAAI,CAAC,IAAI,MAAM,CAAE,QAAO;AACxB,OAAI,CAAC,oBAAoB,KAAK,IAAI,CAChC,QAAO;;EAEZ,CAAC;AACF,KAAI,SAAS,YAAY,CAAE,QAAO;CAElC,MAAM,kBAAkB,oBAAoB,SAAS,CAAC,WAAW;CACjE,IAAI;AACJ,KAAI,gBAAgB,WAAW,EAC7B,cAAa,gBAAgB;MACxB;EACL,MAAM,WAAW,MAAM,OAAO;GAC5B,SAAS;GACT,SAAS,gBAAgB,KAAK,OAAO;IAAE,OAAO;IAAG,OAAO;IAAG,EAAE;GAC9D,CAAC;AACF,MAAI,SAAS,SAAS,CAAE,QAAO;AAC/B,eAAa;;CAGf,MAAM,gBAAgB,wBAAwB,KAAK;CACnD,MAAM,SAAgE,EAAE;AAExE,MAAK,MAAM,CAAC,UAAU,aAAa,OAAO,QAAQ,cAAc,EAAE;EAChE,MAAM,UAAU,MAAM,KAAK;GACzB,SAAS,gBAAgB,SAAS,GAAG,SAAS,cAAc,KAAK,SAAS,YAAY,KAAK;GAC3F,cAAc,SAAS;GACvB,aAAa,SAAS;GACtB,WAAW,MAAM,OAAO;AACtB,QAAI,CAAC,IAAI,MAAM,CAAE,QAAO;AACxB,QAAI,CAAC,oBAAoB,KAAK,IAAI,CAChC,QAAO;;GAEZ,CAAC;AACF,MAAI,SAAS,QAAQ,CAAE,QAAO;AAC9B,SAAO,YAAY;GACjB,KAAM,QAAmB,MAAM;GAC/B,GAAI,SAAS,cAAc,EAAE,aAAa,SAAS,aAAa,GAAG,EAAE;GACtE;;AAGH,QAAO;EACL;EACU;EACV,aAAc,aAAwB,MAAM,IAAI;EAChD,aAAc,YAAuB,MAAM;EAC3C;EACA;EACD"}

package/dist/cli/commands/plugin/create/scaffold.js.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.js","names":[],"sources":["../../../../../src/cli/commands/plugin/create/scaffold.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { humanizeResourceType, MANIFEST_SCHEMA_ID } from \"./resource-defaults\";\nimport type { CreateAnswers } from \"./types\";\n\n/** Convert kebab-name to PascalCase (e.g. my-plugin -> MyPlugin). */\nfunction toPascalCase(name: string): string {\n  return name\n    .split(\"-\")\n    .map((s) => s.charAt(0).toUpperCase() + s.slice(1).toLowerCase())\n    .join(\"\");\n}\n\n/** Convert kebab-name to camelCase (e.g. my-plugin -> myPlugin). */\nfunction toCamelCase(name: string): string {\n  const pascal = toPascalCase(name);\n  return pascal.charAt(0).toLowerCase() + pascal.slice(1);\n}\n\n/** Build manifest.json resources from selected resources. */\nfunction buildManifestResources(answers: CreateAnswers) {\n  const required: unknown[] = [];\n  const optional: unknown[] = [];\n\n  for (const r of answers.resources) {\n    const alias = humanizeResourceType(r.type);\n    const entry = {\n      type: r.type,\n      alias,\n      resourceKey: r.resourceKey,\n      description: r.description || `Required for ${alias} functionality.`,\n      permission: r.permission,\n      fields: r.fields,\n    };\n    if (r.required) {\n      required.push(entry);\n    } else {\n      optional.push(entry);\n    }\n  }\n\n  return { required, optional };\n}\n\n/** Build full manifest object for manifest.json. */\nfunction buildManifest(answers: CreateAnswers): Record<string, unknown> {\n  const { required, optional } = buildManifestResources(answers);\n  const manifest: Record<string, unknown> = {\n    $schema: MANIFEST_SCHEMA_ID,\n    name: answers.name,\n    displayName: answers.displayName,\n    description: answers.description,\n    resources: { required, optional },\n  };\n  if (answers.stability) manifest.stability = answers.stability;\n  if (answers.author) manifest.author = answers.author;\n  manifest.version = answers.version || \"0.1.0\";\n  if (answers.license) manifest.license = answers.license;\n  return manifest;\n}\n\n/** Resolve absolute target directory from cwd and answers. */\nexport function resolveTargetDir(cwd: string, answers: CreateAnswers): string {\n  return path.resolve(cwd, answers.targetPath);\n}\n\n/** Track files written during scaffolding for rollback on failure. */\nfunction writeTracked(\n  filePath: string,\n  content: string,\n  written: string[],\n): void {\n  fs.writeFileSync(filePath, content);\n  written.push(filePath);\n}\n\n/** Remove files written during a failed scaffold attempt. */\nfunction rollback(written: string[], targetDir: string): void {\n  for (const filePath of written.reverse()) {\n    try {\n      fs.unlinkSync(filePath);\n    } catch {\n      // best-effort cleanup\n    }\n  }\n  try {\n    const remaining = fs.readdirSync(targetDir);\n    if (remaining.length === 0) fs.rmdirSync(targetDir);\n  } catch {\n    // directory may not be empty or may have been removed already\n  }\n}\n\n/**\n * Scaffold plugin files into targetDir. Pure: no interactive I/O.\n * Writes manifest.json, {name}.ts, index.ts; for isolated also package.json, tsconfig.json, README.md.\n * On failure, rolls back any files already written.\n */\nexport function scaffoldPlugin(\n  targetDir: string,\n  answers: CreateAnswers,\n  options: { isolated: boolean },\n): void {\n  fs.mkdirSync(targetDir, { recursive: true });\n\n  const written: string[] = [];\n\n  try {\n    const manifest = buildManifest(answers);\n    const className = toPascalCase(answers.name);\n    const exportName = toCamelCase(answers.name);\n\n    writeTracked(\n      path.join(targetDir, \"manifest.json\"),\n      `${JSON.stringify(manifest, null, 2)}\\n`,\n      written,\n    );\n\n    const pluginTs = `import {\n  Plugin,\n  toPlugin,\n  type IAppRouter,\n  type PluginManifest,\n} from \"@databricks/appkit\";\nimport manifest from \"./manifest.json\";\n\nexport class ${className} extends Plugin {\n  static manifest = manifest as PluginManifest<\"${answers.name}\">;\n\n  injectRoutes(router: IAppRouter): void {\n    // Add your routes here, e.g.:\n    // this.route(router, {\n    //   name: \"example\",\n    //   method: \"get\",\n    //   path: \"/\",\n    //   handler: async (_req, res) => {\n    //     res.json({ message: \"Hello from ${answers.name}\" });\n    //   },\n    // });\n  }\n}\n\nexport const ${exportName} = toPlugin(${className});\n`;\n\n    writeTracked(path.join(targetDir, `${answers.name}.ts`), pluginTs, written);\n\n    const indexTs = `export { ${className}, ${exportName} } from \"./${answers.name}\";\n`;\n\n    writeTracked(path.join(targetDir, \"index.ts\"), indexTs, written);\n\n    if (options.isolated) {\n      const packageName =\n        answers.name.includes(\"/\") || answers.name.startsWith(\"@\")\n          ? answers.name\n          : `appkit-plugin-${answers.name}`;\n\n      const packageJson = {\n        name: packageName,\n        version: answers.version || \"0.1.0\",\n        type: \"module\",\n        main: \"./dist/index.js\",\n        types: \"./dist/index.d.ts\",\n        files: [\"dist\"],\n        scripts: {\n          build: \"tsc\",\n          typecheck: \"tsc --noEmit\",\n        },\n        peerDependencies: {\n          \"@databricks/appkit\": \">=0.5.0\",\n        },\n        devDependencies: {\n          typescript: \"^5.0.0\",\n        },\n      };\n\n      writeTracked(\n        path.join(targetDir, \"package.json\"),\n        `${JSON.stringify(packageJson, null, 2)}\\n`,\n        written,\n      );\n\n      const tsconfigJson = {\n        compilerOptions: {\n          target: \"ES2022\",\n          module: \"NodeNext\",\n          moduleResolution: \"NodeNext\",\n          outDir: \"dist\",\n          rootDir: \".\",\n          declaration: true,\n          strict: true,\n          skipLibCheck: true,\n        },\n        include: [\"*.ts\"],\n        exclude: [\"node_modules\", \"dist\"],\n      };\n\n      writeTracked(\n        path.join(targetDir, \"tsconfig.json\"),\n        `${JSON.stringify(tsconfigJson, null, 2)}\\n`,\n        written,\n      );\n\n      const readme = `# ${answers.displayName}\n\n${answers.description}\n\n## Installation\n\n\\`\\`\\`bash\npnpm add ${packageName} @databricks/appkit\n\\`\\`\\`\n\n## Usage\n\nRegister the plugin in your AppKit app:\n\n\\`\\`\\`ts\nimport { createApp } from \"@databricks/appkit\";\nimport { ${exportName} } from \"${packageName}\";\n\ncreateApp({\n  plugins: [\n    ${exportName}(),\n    // ... other plugins\n  ],\n}).then((app) => { /* ... */ });\n\\`\\`\\`\n`;\n\n      writeTracked(path.join(targetDir, \"README.md\"), readme, written);\n    }\n  } catch (err) {\n    rollback(written, targetDir);\n    throw err;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"scaffold.js","names":[],"sources":["../../../../../src/cli/commands/plugin/create/scaffold.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\n\nimport { humanizeResourceType, MANIFEST_SCHEMA_ID } from \"./resource-defaults\";\nimport type { CreateAnswers } from \"./types\";\n\n/** Convert kebab-name to PascalCase (e.g. my-plugin -> MyPlugin). */\nfunction toPascalCase(name: string): string {\n  return name\n    .split(\"-\")\n    .map((s) => s.charAt(0).toUpperCase() + s.slice(1).toLowerCase())\n    .join(\"\");\n}\n\n/** Convert kebab-name to camelCase (e.g. my-plugin -> myPlugin). */\nfunction toCamelCase(name: string): string {\n  const pascal = toPascalCase(name);\n  return pascal.charAt(0).toLowerCase() + pascal.slice(1);\n}\n\n/** Build manifest.json resources from selected resources. */\nfunction buildManifestResources(answers: CreateAnswers) {\n  const required: unknown[] = [];\n  const optional: unknown[] = [];\n\n  for (const r of answers.resources) {\n    const alias = humanizeResourceType(r.type);\n    const entry = {\n      type: r.type,\n      alias,\n      resourceKey: r.resourceKey,\n      description: r.description || `Required for ${alias} functionality.`,\n      permission: r.permission,\n      fields: r.fields,\n    };\n    if (r.required) {\n      required.push(entry);\n    } else {\n      optional.push(entry);\n    }\n  }\n\n  return { required, optional };\n}\n\n/** Build full manifest object for manifest.json. */\nfunction buildManifest(answers: CreateAnswers): Record<string, unknown> {\n  const { required, optional } = buildManifestResources(answers);\n  const manifest: Record<string, unknown> = {\n    $schema: MANIFEST_SCHEMA_ID,\n    name: answers.name,\n    displayName: answers.displayName,\n    description: answers.description,\n    resources: { required, optional },\n  };\n  if (answers.stability) manifest.stability = answers.stability;\n  if (answers.author) manifest.author = answers.author;\n  manifest.version = answers.version || \"0.1.0\";\n  if (answers.license) manifest.license = answers.license;\n  return manifest;\n}\n\n/** Resolve absolute target directory from cwd and answers. */\nexport function resolveTargetDir(cwd: string, answers: CreateAnswers): string {\n  return path.resolve(cwd, answers.targetPath);\n}\n\n/** Track files written during scaffolding for rollback on failure. */\nfunction writeTracked(\n  filePath: string,\n  content: string,\n  written: string[],\n): void {\n  fs.writeFileSync(filePath, content);\n  written.push(filePath);\n}\n\n/** Remove files written during a failed scaffold attempt. */\nfunction rollback(written: string[], targetDir: string): void {\n  for (const filePath of written.reverse()) {\n    try {\n      fs.unlinkSync(filePath);\n    } catch {\n      // best-effort cleanup\n    }\n  }\n  try {\n    const remaining = fs.readdirSync(targetDir);\n    if (remaining.length === 0) fs.rmdirSync(targetDir);\n  } catch {\n    // directory may not be empty or may have been removed already\n  }\n}\n\n/**\n * Scaffold plugin files into targetDir. Pure: no interactive I/O.\n * Writes manifest.json, {name}.ts, index.ts; for isolated also package.json, tsconfig.json, README.md.\n * On failure, rolls back any files already written.\n */\nexport function scaffoldPlugin(\n  targetDir: string,\n  answers: CreateAnswers,\n  options: { isolated: boolean },\n): void {\n  fs.mkdirSync(targetDir, { recursive: true });\n\n  const written: string[] = [];\n\n  try {\n    const manifest = buildManifest(answers);\n    const className = toPascalCase(answers.name);\n    const exportName = toCamelCase(answers.name);\n\n    writeTracked(\n      path.join(targetDir, \"manifest.json\"),\n      `${JSON.stringify(manifest, null, 2)}\\n`,\n      written,\n    );\n\n    const pluginTs = `import {\n  Plugin,\n  toPlugin,\n  type IAppRouter,\n  type PluginManifest,\n} from \"@databricks/appkit\";\nimport manifest from \"./manifest.json\";\n\nexport class ${className} extends Plugin {\n  static manifest = manifest as PluginManifest<\"${answers.name}\">;\n\n  injectRoutes(router: IAppRouter): void {\n    // Add your routes here, e.g.:\n    // this.route(router, {\n    //   name: \"example\",\n    //   method: \"get\",\n    //   path: \"/\",\n    //   handler: async (_req, res) => {\n    //     res.json({ message: \"Hello from ${answers.name}\" });\n    //   },\n    // });\n  }\n}\n\nexport const ${exportName} = toPlugin(${className});\n`;\n\n    writeTracked(path.join(targetDir, `${answers.name}.ts`), pluginTs, written);\n\n    const indexTs = `export { ${className}, ${exportName} } from \"./${answers.name}\";\n`;\n\n    writeTracked(path.join(targetDir, \"index.ts\"), indexTs, written);\n\n    if (options.isolated) {\n      const packageName =\n        answers.name.includes(\"/\") || answers.name.startsWith(\"@\")\n          ? answers.name\n          : `appkit-plugin-${answers.name}`;\n\n      const packageJson = {\n        name: packageName,\n        version: answers.version || \"0.1.0\",\n        type: \"module\",\n        main: \"./dist/index.js\",\n        types: \"./dist/index.d.ts\",\n        files: [\"dist\"],\n        scripts: {\n          build: \"tsc\",\n          typecheck: \"tsc --noEmit\",\n        },\n        peerDependencies: {\n          \"@databricks/appkit\": \">=0.5.0\",\n        },\n        devDependencies: {\n          typescript: \"^5.0.0\",\n        },\n      };\n\n      writeTracked(\n        path.join(targetDir, \"package.json\"),\n        `${JSON.stringify(packageJson, null, 2)}\\n`,\n        written,\n      );\n\n      const tsconfigJson = {\n        compilerOptions: {\n          target: \"ES2022\",\n          module: \"NodeNext\",\n          moduleResolution: \"NodeNext\",\n          outDir: \"dist\",\n          rootDir: \".\",\n          declaration: true,\n          strict: true,\n          skipLibCheck: true,\n        },\n        include: [\"*.ts\"],\n        exclude: [\"node_modules\", \"dist\"],\n      };\n\n      writeTracked(\n        path.join(targetDir, \"tsconfig.json\"),\n        `${JSON.stringify(tsconfigJson, null, 2)}\\n`,\n        written,\n      );\n\n      const readme = `# ${answers.displayName}\n\n${answers.description}\n\n## Installation\n\n\\`\\`\\`bash\npnpm add ${packageName} @databricks/appkit\n\\`\\`\\`\n\n## Usage\n\nRegister the plugin in your AppKit app:\n\n\\`\\`\\`ts\nimport { createApp } from \"@databricks/appkit\";\nimport { ${exportName} } from \"${packageName}\";\n\ncreateApp({\n  plugins: [\n    ${exportName}(),\n    // ... other plugins\n  ],\n}).then((app) => { /* ... */ });\n\\`\\`\\`\n`;\n\n      writeTracked(path.join(targetDir, \"README.md\"), readme, written);\n    }\n  } catch (err) {\n    rollback(written, targetDir);\n    throw err;\n  }\n}\n"],"mappings":"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"}

package/dist/cli/commands/plugin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/cli/commands/plugin/index.ts"],"sourcesContent":["import { Command } from \"commander\";\nimport { pluginAddResourceCommand } from \"./add-resource/add-resource\";\nimport { pluginCreateCommand } from \"./create/create\";\nimport { pluginListCommand } from \"./list/list\";\nimport { pluginPromoteCommand } from \"./promote/promote\";\nimport { pluginsSyncCommand } from \"./sync/sync\";\nimport { pluginValidateCommand } from \"./validate/validate\";\n\n/**\n * Parent command for plugin management operations.\n * Subcommands:\n *   - sync: Aggregate plugin manifests into appkit.plugins.json\n *   - create: Scaffold a new plugin (interactive)\n *   - validate: Validate manifest(s) against the JSON schema\n *   - list: List plugins from appkit.plugins.json or a directory\n *   - add-resource: Add a resource requirement to a plugin manifest (interactive)\n *   - promote: Promote a plugin to a higher stability tier\n */\nexport const pluginCommand = new Command(\"plugin\")\n  .description(\"Plugin management commands\")\n  .addCommand(pluginsSyncCommand)\n  .addCommand(pluginCreateCommand)\n  .addCommand(pluginValidateCommand)\n  .addCommand(pluginListCommand)\n  .addCommand(pluginAddResourceCommand)\n  .addCommand(pluginPromoteCommand)\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ appkit plugin sync --write\n  $ appkit plugin create --placement in-repo --path plugins/my-plugin --name my-plugin --description \"Does X\"\n  $ appkit plugin validate .\n  $ appkit plugin list --json\n  $ appkit plugin add-resource --path plugins/my-plugin --type sql_warehouse\n  $ appkit plugin promote my-plugin --to ga`,\n  );\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,MAAa,gBAAgB,IAAI,QAAQ,SAAS,CAC/C,YAAY,6BAA6B,CACzC,WAAW,mBAAmB,CAC9B,WAAW,oBAAoB,CAC/B,WAAW,sBAAsB,CACjC,WAAW,kBAAkB,CAC7B,WAAW,yBAAyB,CACpC,WAAW,qBAAqB,CAChC,YACC,SACA;;;;;;;6CAQD"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/cli/commands/plugin/index.ts"],"sourcesContent":["import { Command } from \"commander\";\n\nimport { pluginAddResourceCommand } from \"./add-resource/add-resource\";\nimport { pluginCreateCommand } from \"./create/create\";\nimport { pluginListCommand } from \"./list/list\";\nimport { pluginPromoteCommand } from \"./promote/promote\";\nimport { pluginsSyncCommand } from \"./sync/sync\";\nimport { pluginValidateCommand } from \"./validate/validate\";\n\n/**\n * Parent command for plugin management operations.\n * Subcommands:\n *   - sync: Aggregate plugin manifests into appkit.plugins.json\n *   - create: Scaffold a new plugin (interactive)\n *   - validate: Validate manifest(s) against the JSON schema\n *   - list: List plugins from appkit.plugins.json or a directory\n *   - add-resource: Add a resource requirement to a plugin manifest (interactive)\n *   - promote: Promote a plugin to a higher stability tier\n */\nexport const pluginCommand = new Command(\"plugin\")\n  .description(\"Plugin management commands\")\n  .addCommand(pluginsSyncCommand)\n  .addCommand(pluginCreateCommand)\n  .addCommand(pluginValidateCommand)\n  .addCommand(pluginListCommand)\n  .addCommand(pluginAddResourceCommand)\n  .addCommand(pluginPromoteCommand)\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ appkit plugin sync --write\n  $ appkit plugin create --placement in-repo --path plugins/my-plugin --name my-plugin --description \"Does X\"\n  $ appkit plugin validate .\n  $ appkit plugin list --json\n  $ appkit plugin add-resource --path plugins/my-plugin --type sql_warehouse\n  $ appkit plugin promote my-plugin --to ga`,\n  );\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,MAAa,gBAAgB,IAAI,QAAQ,SAAS,CAC/C,YAAY,6BAA6B,CACzC,WAAW,mBAAmB,CAC9B,WAAW,oBAAoB,CAC/B,WAAW,sBAAsB,CACjC,WAAW,kBAAkB,CAC7B,WAAW,yBAAyB,CACpC,WAAW,qBAAqB,CAChC,YACC,SACA;;;;;;;6CAQD"}

package/dist/cli/commands/plugin/list/list.js.map

@@ -1 +1 @@
-{"version":3,"file":"list.js","names":[],"sources":["../../../../../src/cli/commands/plugin/list/list.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport { Command } from \"commander\";\nimport {\n  loadManifestFromFile,\n  resolveManifestInDir,\n} from \"../manifest-resolve\";\nimport { shouldAllowJsManifestForDir } from \"../trusted-js-manifest\";\nimport { validateManifest } from \"../validate/validate-manifest\";\n\n/** Safety limit for recursive directory scanning to prevent runaway traversal. */\nconst MAX_SCAN_DEPTH = 5;\n\nexport interface PluginRow {\n  name: string;\n  displayName: string;\n  package: string;\n  stability: \"beta\" | \"ga\";\n  required: number;\n  optional: number;\n}\n\nexport function listFromManifestFile(manifestPath: string): PluginRow[] {\n  let raw: string;\n  try {\n    raw = fs.readFileSync(manifestPath, \"utf-8\");\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    throw new Error(`Failed to read manifest file ${manifestPath}: ${msg}`);\n  }\n\n  let data: {\n    plugins?: Record<\n      string,\n      {\n        name: string;\n        displayName: string;\n        package: string;\n        stability?: \"beta\" | \"ga\";\n        resources: { required: unknown[]; optional: unknown[] };\n      }\n    >;\n  };\n  try {\n    data = JSON.parse(raw) as typeof data;\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    throw new Error(`Failed to parse manifest file ${manifestPath}: ${msg}`);\n  }\n\n  const plugins = data.plugins ?? {};\n  return Object.values(plugins).map((p) => ({\n    name: p.name,\n    displayName: p.displayName ?? p.name,\n    package: p.package ?? \"\",\n    stability: p.stability ?? \"ga\",\n    required: Array.isArray(p.resources?.required)\n      ? p.resources.required.length\n      : 0,\n    optional: Array.isArray(p.resources?.optional)\n      ? p.resources.optional.length\n      : 0,\n  }));\n}\n\nasync function collectPluginsRecursive(\n  dir: string,\n  cwd: string,\n  rows: PluginRow[],\n  allowJsManifest: boolean,\n  depth = 0,\n): Promise<void> {\n  if (\n    !fs.existsSync(dir) ||\n    !fs.statSync(dir).isDirectory() ||\n    depth >= MAX_SCAN_DEPTH\n  )\n    return;\n\n  const entries = fs.readdirSync(dir, { withFileTypes: true });\n  for (const entry of entries) {\n    if (!entry.isDirectory()) continue;\n\n    const childPath = path.join(dir, entry.name);\n    const allowJsForChild =\n      allowJsManifest || shouldAllowJsManifestForDir(childPath);\n    const resolvedManifest = resolveManifestInDir(childPath, {\n      allowJsManifest: allowJsForChild,\n    });\n\n    if (resolvedManifest) {\n      try {\n        const obj = await loadManifestFromFile(\n          resolvedManifest.path,\n          resolvedManifest.type,\n          { allowJsManifest: allowJsForChild },\n        );\n        const result = validateManifest(obj);\n        const manifest = result.valid ? result.manifest : null;\n        if (manifest) {\n          const relPath = path.relative(\n            cwd,\n            path.dirname(resolvedManifest.path),\n          );\n          const packagePath = relPath.startsWith(\".\")\n            ? relPath\n            : `./${relPath}`;\n          const rawManifest = manifest as typeof manifest & {\n            stability?: \"beta\" | \"ga\";\n          };\n          rows.push({\n            name: manifest.name,\n            displayName: manifest.displayName ?? manifest.name,\n            package: packagePath,\n            stability: rawManifest.stability ?? \"ga\",\n            required: Array.isArray(manifest.resources?.required)\n              ? manifest.resources.required.length\n              : 0,\n            optional: Array.isArray(manifest.resources?.optional)\n              ? manifest.resources.optional.length\n              : 0,\n          });\n        }\n      } catch {\n        // skip invalid manifests\n      }\n      continue;\n    }\n\n    await collectPluginsRecursive(\n      childPath,\n      cwd,\n      rows,\n      allowJsManifest,\n      depth + 1,\n    );\n  }\n}\n\nexport async function listFromDirectory(\n  dirPath: string,\n  cwd: string,\n  allowJsManifest = false,\n): Promise<PluginRow[]> {\n  const resolved = path.resolve(cwd, dirPath);\n  if (!fs.existsSync(resolved) || !fs.statSync(resolved).isDirectory()) {\n    return [];\n  }\n  const rows: PluginRow[] = [];\n  await collectPluginsRecursive(resolved, cwd, rows, allowJsManifest);\n  return rows;\n}\n\nfunction printTable(rows: PluginRow[]): void {\n  if (rows.length === 0) {\n    console.log(\"No plugins found.\");\n    return;\n  }\n  const maxName = Math.max(4, ...rows.map((r) => r.name.length));\n  const maxDisplay = Math.max(10, ...rows.map((r) => r.displayName.length));\n  const maxPkg = Math.max(7, ...rows.map((r) => r.package.length));\n  const maxStab = Math.max(9, ...rows.map((r) => r.stability.length));\n  const header = [\n    \"NAME\".padEnd(maxName),\n    \"DISPLAY NAME\".padEnd(maxDisplay),\n    \"STABILITY\".padEnd(maxStab),\n    \"PACKAGE / PATH\".padEnd(maxPkg),\n    \"REQ\",\n    \"OPT\",\n  ].join(\"  \");\n  console.log(header);\n  console.log(\"-\".repeat(header.length));\n  for (const r of rows) {\n    console.log(\n      [\n        r.name.padEnd(maxName),\n        r.displayName.padEnd(maxDisplay),\n        r.stability.padEnd(maxStab),\n        r.package.padEnd(maxPkg),\n        String(r.required).padStart(3),\n        String(r.optional).padStart(3),\n      ].join(\"  \"),\n    );\n  }\n}\n\nasync function runPluginList(options: {\n  manifest?: string;\n  dir?: string;\n  json?: boolean;\n  allowJsManifest?: boolean;\n}): Promise<void> {\n  const cwd = process.cwd();\n  const allowJsManifest = Boolean(options.allowJsManifest);\n  if (allowJsManifest) {\n    console.warn(\n      \"Warning: --allow-js-manifest executes manifest.js/manifest.cjs files. Only use with trusted code.\",\n    );\n  }\n  let rows: PluginRow[];\n\n  if (options.dir !== undefined) {\n    rows = await listFromDirectory(options.dir, cwd, allowJsManifest);\n    if (rows.length === 0 && options.dir) {\n      console.error(\n        `No plugin directories with ${allowJsManifest ? \"manifest.json or manifest.js\" : \"manifest.json\"} found in ${options.dir}`,\n      );\n      process.exit(1);\n    }\n  } else {\n    const manifestPath = path.resolve(\n      cwd,\n      options.manifest ?? \"appkit.plugins.json\",\n    );\n    if (!fs.existsSync(manifestPath)) {\n      console.error(`Manifest not found: ${manifestPath}`);\n      console.error(\n        \"  appkit plugin list --manifest <path-to-manifest> or appkit plugin list --dir <plugins-directory>\",\n      );\n      process.exit(1);\n    }\n    try {\n      rows = listFromManifestFile(manifestPath);\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  }\n\n  if (options.json) {\n    console.log(JSON.stringify(rows, null, 2));\n  } else {\n    printTable(rows);\n  }\n}\n\nexport const pluginListCommand = new Command(\"list\")\n  .description(\"List plugins from appkit.plugins.json or a directory\")\n  .option(\n    \"-m, --manifest <path>\",\n    \"Path to appkit.plugins.json\",\n    \"appkit.plugins.json\",\n  )\n  .option(\n    \"-d, --dir <path>\",\n    \"Scan directory recursively for plugin folders (manifest.json by default)\",\n  )\n  .option(\n    \"--allow-js-manifest\",\n    \"Allow reading manifest.js/manifest.cjs (executes code; use only with trusted plugins)\",\n  )\n  .option(\"--json\", \"Output as JSON\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ appkit plugin list\n  $ appkit plugin list --json\n  $ appkit plugin list --manifest custom-manifest.json\n  $ appkit plugin list --dir plugins/`,\n  )\n  .action((opts) =>\n    runPluginList(opts).catch((err) => {\n      console.error(err);\n      process.exit(1);\n    }),\n  );\n"],"mappings":"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"}
+{"version":3,"file":"list.js","names":[],"sources":["../../../../../src/cli/commands/plugin/list/list.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport process from \"node:process\";\n\nimport { Command } from \"commander\";\n\nimport {\n  loadManifestFromFile,\n  resolveManifestInDir,\n} from \"../manifest-resolve\";\nimport { shouldAllowJsManifestForDir } from \"../trusted-js-manifest\";\nimport { validateManifest } from \"../validate/validate-manifest\";\n\n/** Safety limit for recursive directory scanning to prevent runaway traversal. */\nconst MAX_SCAN_DEPTH = 5;\n\nexport interface PluginRow {\n  name: string;\n  displayName: string;\n  package: string;\n  stability: \"beta\" | \"ga\";\n  required: number;\n  optional: number;\n}\n\nexport function listFromManifestFile(manifestPath: string): PluginRow[] {\n  let raw: string;\n  try {\n    raw = fs.readFileSync(manifestPath, \"utf-8\");\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    throw new Error(`Failed to read manifest file ${manifestPath}: ${msg}`);\n  }\n\n  let data: {\n    plugins?: Record<\n      string,\n      {\n        name: string;\n        displayName: string;\n        package: string;\n        stability?: \"beta\" | \"ga\";\n        resources: { required: unknown[]; optional: unknown[] };\n      }\n    >;\n  };\n  try {\n    data = JSON.parse(raw) as typeof data;\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    throw new Error(`Failed to parse manifest file ${manifestPath}: ${msg}`);\n  }\n\n  const plugins = data.plugins ?? {};\n  return Object.values(plugins).map((p) => ({\n    name: p.name,\n    displayName: p.displayName ?? p.name,\n    package: p.package ?? \"\",\n    stability: p.stability ?? \"ga\",\n    required: Array.isArray(p.resources?.required)\n      ? p.resources.required.length\n      : 0,\n    optional: Array.isArray(p.resources?.optional)\n      ? p.resources.optional.length\n      : 0,\n  }));\n}\n\nasync function collectPluginsRecursive(\n  dir: string,\n  cwd: string,\n  rows: PluginRow[],\n  allowJsManifest: boolean,\n  depth = 0,\n): Promise<void> {\n  if (\n    !fs.existsSync(dir) ||\n    !fs.statSync(dir).isDirectory() ||\n    depth >= MAX_SCAN_DEPTH\n  )\n    return;\n\n  const entries = fs.readdirSync(dir, { withFileTypes: true });\n  for (const entry of entries) {\n    if (!entry.isDirectory()) continue;\n\n    const childPath = path.join(dir, entry.name);\n    const allowJsForChild =\n      allowJsManifest || shouldAllowJsManifestForDir(childPath);\n    const resolvedManifest = resolveManifestInDir(childPath, {\n      allowJsManifest: allowJsForChild,\n    });\n\n    if (resolvedManifest) {\n      try {\n        const obj = await loadManifestFromFile(\n          resolvedManifest.path,\n          resolvedManifest.type,\n          { allowJsManifest: allowJsForChild },\n        );\n        const result = validateManifest(obj);\n        const manifest = result.valid ? result.manifest : null;\n        if (manifest) {\n          const relPath = path.relative(\n            cwd,\n            path.dirname(resolvedManifest.path),\n          );\n          const packagePath = relPath.startsWith(\".\")\n            ? relPath\n            : `./${relPath}`;\n          const rawManifest = manifest as typeof manifest & {\n            stability?: \"beta\" | \"ga\";\n          };\n          rows.push({\n            name: manifest.name,\n            displayName: manifest.displayName ?? manifest.name,\n            package: packagePath,\n            stability: rawManifest.stability ?? \"ga\",\n            required: Array.isArray(manifest.resources?.required)\n              ? manifest.resources.required.length\n              : 0,\n            optional: Array.isArray(manifest.resources?.optional)\n              ? manifest.resources.optional.length\n              : 0,\n          });\n        }\n      } catch {\n        // skip invalid manifests\n      }\n      continue;\n    }\n\n    await collectPluginsRecursive(\n      childPath,\n      cwd,\n      rows,\n      allowJsManifest,\n      depth + 1,\n    );\n  }\n}\n\nexport async function listFromDirectory(\n  dirPath: string,\n  cwd: string,\n  allowJsManifest = false,\n): Promise<PluginRow[]> {\n  const resolved = path.resolve(cwd, dirPath);\n  if (!fs.existsSync(resolved) || !fs.statSync(resolved).isDirectory()) {\n    return [];\n  }\n  const rows: PluginRow[] = [];\n  await collectPluginsRecursive(resolved, cwd, rows, allowJsManifest);\n  return rows;\n}\n\nfunction printTable(rows: PluginRow[]): void {\n  if (rows.length === 0) {\n    console.log(\"No plugins found.\");\n    return;\n  }\n  const maxName = Math.max(4, ...rows.map((r) => r.name.length));\n  const maxDisplay = Math.max(10, ...rows.map((r) => r.displayName.length));\n  const maxPkg = Math.max(7, ...rows.map((r) => r.package.length));\n  const maxStab = Math.max(9, ...rows.map((r) => r.stability.length));\n  const header = [\n    \"NAME\".padEnd(maxName),\n    \"DISPLAY NAME\".padEnd(maxDisplay),\n    \"STABILITY\".padEnd(maxStab),\n    \"PACKAGE / PATH\".padEnd(maxPkg),\n    \"REQ\",\n    \"OPT\",\n  ].join(\"  \");\n  console.log(header);\n  console.log(\"-\".repeat(header.length));\n  for (const r of rows) {\n    console.log(\n      [\n        r.name.padEnd(maxName),\n        r.displayName.padEnd(maxDisplay),\n        r.stability.padEnd(maxStab),\n        r.package.padEnd(maxPkg),\n        String(r.required).padStart(3),\n        String(r.optional).padStart(3),\n      ].join(\"  \"),\n    );\n  }\n}\n\nasync function runPluginList(options: {\n  manifest?: string;\n  dir?: string;\n  json?: boolean;\n  allowJsManifest?: boolean;\n}): Promise<void> {\n  const cwd = process.cwd();\n  const allowJsManifest = Boolean(options.allowJsManifest);\n  if (allowJsManifest) {\n    console.warn(\n      \"Warning: --allow-js-manifest executes manifest.js/manifest.cjs files. Only use with trusted code.\",\n    );\n  }\n  let rows: PluginRow[];\n\n  if (options.dir !== undefined) {\n    rows = await listFromDirectory(options.dir, cwd, allowJsManifest);\n    if (rows.length === 0 && options.dir) {\n      console.error(\n        `No plugin directories with ${allowJsManifest ? \"manifest.json or manifest.js\" : \"manifest.json\"} found in ${options.dir}`,\n      );\n      process.exit(1);\n    }\n  } else {\n    const manifestPath = path.resolve(\n      cwd,\n      options.manifest ?? \"appkit.plugins.json\",\n    );\n    if (!fs.existsSync(manifestPath)) {\n      console.error(`Manifest not found: ${manifestPath}`);\n      console.error(\n        \"  appkit plugin list --manifest <path-to-manifest> or appkit plugin list --dir <plugins-directory>\",\n      );\n      process.exit(1);\n    }\n    try {\n      rows = listFromManifestFile(manifestPath);\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  }\n\n  if (options.json) {\n    console.log(JSON.stringify(rows, null, 2));\n  } else {\n    printTable(rows);\n  }\n}\n\nexport const pluginListCommand = new Command(\"list\")\n  .description(\"List plugins from appkit.plugins.json or a directory\")\n  .option(\n    \"-m, --manifest <path>\",\n    \"Path to appkit.plugins.json\",\n    \"appkit.plugins.json\",\n  )\n  .option(\n    \"-d, --dir <path>\",\n    \"Scan directory recursively for plugin folders (manifest.json by default)\",\n  )\n  .option(\n    \"--allow-js-manifest\",\n    \"Allow reading manifest.js/manifest.cjs (executes code; use only with trusted plugins)\",\n  )\n  .option(\"--json\", \"Output as JSON\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ appkit plugin list\n  $ appkit plugin list --json\n  $ appkit plugin list --manifest custom-manifest.json\n  $ appkit plugin list --dir plugins/`,\n  )\n  .action((opts) =>\n    runPluginList(opts).catch((err) => {\n      console.error(err);\n      process.exit(1);\n    }),\n  );\n"],"mappings":"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"}