@databricks/appkit-ui 0.88.1 → 0.90.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (150) hide show
  1. package/CLAUDE.md +7 -2
  2. package/dist/cli/commands/doctor/checks-existence.js +16 -16
  3. package/dist/cli/commands/doctor/checks-existence.js.map +1 -1
  4. package/dist/cli/commands/doctor/checks.js +15 -18
  5. package/dist/cli/commands/doctor/checks.js.map +1 -1
  6. package/dist/cli/commands/doctor/databricks-client.js +8 -6
  7. package/dist/cli/commands/doctor/databricks-client.js.map +1 -1
  8. package/dist/cli/commands/registry/add.js +6 -9
  9. package/dist/cli/commands/registry/add.js.map +1 -1
  10. package/dist/cli/commands/registry/client.js +9 -31
  11. package/dist/cli/commands/registry/client.js.map +1 -1
  12. package/dist/cli/commands/registry/constants.js +2 -41
  13. package/dist/cli/commands/registry/constants.js.map +1 -1
  14. package/dist/cli/commands/registry/info.js +1 -3
  15. package/dist/cli/commands/registry/info.js.map +1 -1
  16. package/dist/cli/commands/registry/list.js +5 -13
  17. package/dist/cli/commands/registry/list.js.map +1 -1
  18. package/dist/cli/commands/registry/workspace-picker.js +34 -24
  19. package/dist/cli/commands/registry/workspace-picker.js.map +1 -1
  20. package/dist/react/genie/genie-chart-inference.js.map +1 -1
  21. package/dist/react/genie/genie-query-transform.d.ts +5 -2
  22. package/dist/react/genie/genie-query-transform.d.ts.map +1 -1
  23. package/dist/react/genie/genie-query-transform.js +14 -8
  24. package/dist/react/genie/genie-query-transform.js.map +1 -1
  25. package/dist/react/ui/button.d.ts +1 -1
  26. package/dist/shared/src/genie.d.ts +9 -3
  27. package/dist/shared/src/genie.d.ts.map +1 -1
  28. package/dist/shared/src/workspace-client/factory.d.ts +0 -1
  29. package/dist/shared/src/workspace-client/index.d.ts +1 -2
  30. package/dist/shared/src/workspace-client/modular.d.ts +19 -0
  31. package/dist/shared/src/workspace-client/types.d.ts +1 -2
  32. package/dist/workspace-client/client.js +81 -23
  33. package/dist/workspace-client/client.js.map +1 -1
  34. package/dist/workspace-client/errors.d.ts +14 -2
  35. package/dist/workspace-client/errors.d.ts.map +1 -0
  36. package/dist/workspace-client/errors.js +45 -2
  37. package/dist/workspace-client/errors.js.map +1 -0
  38. package/dist/workspace-client/factory.d.ts +1 -1
  39. package/dist/workspace-client/factory.js.map +1 -1
  40. package/dist/workspace-client/index.d.ts +4 -3
  41. package/dist/workspace-client/index.js +2 -2
  42. package/dist/workspace-client/modular.d.ts +109 -0
  43. package/dist/workspace-client/modular.d.ts.map +1 -0
  44. package/dist/workspace-client/modular.js +447 -0
  45. package/dist/workspace-client/modular.js.map +1 -0
  46. package/dist/workspace-client/options.d.ts +29 -0
  47. package/dist/workspace-client/options.d.ts.map +1 -0
  48. package/dist/workspace-client/types.d.ts +35 -38
  49. package/dist/workspace-client/types.d.ts.map +1 -1
  50. package/docs/api/appkit/Class.ApiError.md +110 -0
  51. package/docs/api/appkit/Class.DatabricksAdapter.md +2 -2
  52. package/docs/api/appkit/Class.SupervisorApiAdapter.md +1 -1
  53. package/docs/api/appkit/Function.generateDatabaseCredential.md +2 -2
  54. package/docs/api/appkit/Function.getWorkspaceClient.md +2 -2
  55. package/docs/api/appkit/Interface.DirectoryEntry.md +62 -0
  56. package/docs/api/appkit/Interface.DownloadResponse.md +45 -0
  57. package/docs/api/appkit/Interface.JobAPI.md +20 -12
  58. package/docs/api/appkit/Interface.LakebasePoolConfig.md +1 -1
  59. package/docs/api/appkit/Interface.WorkspaceClient.md +168 -26
  60. package/docs/api/appkit/Interface.WorkspaceClientOptions.md +1 -14
  61. package/docs/api/appkit/TypeAlias.FilesDirectoryEntry.md +8 -0
  62. package/docs/api/appkit/TypeAlias.FilesDownloadResponse.md +8 -0
  63. package/docs/api/appkit/TypeAlias.IDatabaseConfig.md +12 -0
  64. package/docs/api/appkit/TypeAlias.JobsExport.md +1 -1
  65. package/docs/api/appkit/TypeAlias.WorkspaceClientLike.md +16 -0
  66. package/docs/api/appkit.md +7 -2
  67. package/docs/plugins/database.md +11 -0
  68. package/docs/plugins/files.md +20 -3
  69. package/docs/plugins/jobs.md +9 -9
  70. package/docs/plugins/lakebase.md +3 -1
  71. package/docs/plugins/testing.md +10 -8
  72. package/llms.txt +7 -2
  73. package/node_modules/@databricks/sdk-genie/LICENSE +203 -0
  74. package/node_modules/@databricks/sdk-genie/README.md +23 -0
  75. package/node_modules/@databricks/sdk-genie/dist/package.js +7 -0
  76. package/node_modules/@databricks/sdk-genie/dist/package.js.map +1 -0
  77. package/node_modules/@databricks/sdk-genie/dist/v1/client.d.ts +175 -0
  78. package/node_modules/@databricks/sdk-genie/dist/v1/client.d.ts.map +1 -0
  79. package/node_modules/@databricks/sdk-genie/dist/v1/client.js +829 -0
  80. package/node_modules/@databricks/sdk-genie/dist/v1/client.js.map +1 -0
  81. package/node_modules/@databricks/sdk-genie/dist/v1/index.d.ts +3 -0
  82. package/node_modules/@databricks/sdk-genie/dist/v1/index.js +4 -0
  83. package/node_modules/@databricks/sdk-genie/dist/v1/model.d.ts +1799 -0
  84. package/node_modules/@databricks/sdk-genie/dist/v1/model.d.ts.map +1 -0
  85. package/node_modules/@databricks/sdk-genie/dist/v1/model.js +1097 -0
  86. package/node_modules/@databricks/sdk-genie/dist/v1/model.js.map +1 -0
  87. package/node_modules/@databricks/sdk-genie/dist/v1/transport.d.ts +37 -0
  88. package/node_modules/@databricks/sdk-genie/dist/v1/transport.d.ts.map +1 -0
  89. package/node_modules/@databricks/sdk-genie/dist/v1/transport.js +73 -0
  90. package/node_modules/@databricks/sdk-genie/dist/v1/transport.js.map +1 -0
  91. package/node_modules/@databricks/sdk-genie/dist/v1/utils.d.ts +43 -0
  92. package/node_modules/@databricks/sdk-genie/dist/v1/utils.d.ts.map +1 -0
  93. package/node_modules/@databricks/sdk-genie/dist/v1/utils.js +130 -0
  94. package/node_modules/@databricks/sdk-genie/dist/v1/utils.js.map +1 -0
  95. package/node_modules/@databricks/sdk-genie/package.json +46 -0
  96. package/node_modules/@databricks/sdk-statementexecution/LICENSE +203 -0
  97. package/node_modules/@databricks/sdk-statementexecution/README.md +23 -0
  98. package/node_modules/@databricks/sdk-statementexecution/dist/package.js +7 -0
  99. package/node_modules/@databricks/sdk-statementexecution/dist/package.js.map +1 -0
  100. package/node_modules/@databricks/sdk-statementexecution/dist/v1/client.d.ts +91 -0
  101. package/node_modules/@databricks/sdk-statementexecution/dist/v1/client.d.ts.map +1 -0
  102. package/node_modules/@databricks/sdk-statementexecution/dist/v1/client.js +183 -0
  103. package/node_modules/@databricks/sdk-statementexecution/dist/v1/client.js.map +1 -0
  104. package/node_modules/@databricks/sdk-statementexecution/dist/v1/index.d.ts +3 -0
  105. package/node_modules/@databricks/sdk-statementexecution/dist/v1/index.js +4 -0
  106. package/node_modules/@databricks/sdk-statementexecution/dist/v1/model.d.ts +506 -0
  107. package/node_modules/@databricks/sdk-statementexecution/dist/v1/model.d.ts.map +1 -0
  108. package/node_modules/@databricks/sdk-statementexecution/dist/v1/model.js +302 -0
  109. package/node_modules/@databricks/sdk-statementexecution/dist/v1/model.js.map +1 -0
  110. package/node_modules/@databricks/sdk-statementexecution/dist/v1/transport.d.ts +37 -0
  111. package/node_modules/@databricks/sdk-statementexecution/dist/v1/transport.d.ts.map +1 -0
  112. package/node_modules/@databricks/sdk-statementexecution/dist/v1/transport.js +73 -0
  113. package/node_modules/@databricks/sdk-statementexecution/dist/v1/transport.js.map +1 -0
  114. package/node_modules/@databricks/sdk-statementexecution/dist/v1/utils.d.ts +25 -0
  115. package/node_modules/@databricks/sdk-statementexecution/dist/v1/utils.d.ts.map +1 -0
  116. package/node_modules/@databricks/sdk-statementexecution/dist/v1/utils.js +87 -0
  117. package/node_modules/@databricks/sdk-statementexecution/dist/v1/utils.js.map +1 -0
  118. package/node_modules/@databricks/sdk-statementexecution/package.json +46 -0
  119. package/node_modules/@databricks/sdk-vectorsearch/LICENSE +203 -0
  120. package/node_modules/@databricks/sdk-vectorsearch/README.md +23 -0
  121. package/node_modules/@databricks/sdk-vectorsearch/dist/package.js +7 -0
  122. package/node_modules/@databricks/sdk-vectorsearch/dist/package.js.map +1 -0
  123. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/client.d.ts +70 -0
  124. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/client.d.ts.map +1 -0
  125. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/client.js +474 -0
  126. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/client.js.map +1 -0
  127. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/index.d.ts +3 -0
  128. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/index.js +4 -0
  129. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/model.d.ts +704 -0
  130. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/model.d.ts.map +1 -0
  131. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/model.js +635 -0
  132. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/model.js.map +1 -0
  133. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/transport.d.ts +37 -0
  134. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/transport.d.ts.map +1 -0
  135. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/transport.js +73 -0
  136. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/transport.js.map +1 -0
  137. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/utils.d.ts +37 -0
  138. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/utils.d.ts.map +1 -0
  139. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/utils.js +104 -0
  140. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/utils.js.map +1 -0
  141. package/node_modules/@databricks/sdk-vectorsearch/package.json +46 -0
  142. package/package.json +29 -4
  143. package/sbom.cdx.json +1 -1
  144. package/dist/shared/src/workspace-client/errors.d.ts +0 -1
  145. package/dist/shared/src/workspace-client/legacy.d.ts +0 -3
  146. package/dist/workspace-client/legacy.d.ts +0 -34
  147. package/dist/workspace-client/legacy.d.ts.map +0 -1
  148. package/dist/workspace-client/legacy.js +0 -23
  149. package/dist/workspace-client/legacy.js.map +0 -1
  150. package/docs/api/appkit/Interface.WorkspaceClientLike.md +0 -67
@@ -1 +1 @@
1
- {"version":3,"file":"add.js","names":[],"sources":["../../../../src/cli/commands/registry/add.ts"],"sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport process from \"node:process\";\n\nimport { Command } from \"commander\";\nimport pc from \"picocolors\";\n\nimport { SCOPE_BY_TYPE } from \"../../../schemas/manifest\";\nimport { detectPackageManager } from \"../../package-manager\";\nimport {\n fetchRegistryItem,\n fetchVerifiedNames,\n isValidItemName,\n type RegistryItem,\n type RegistryItemFile,\n stripNamespace,\n} from \"./client\";\nimport {\n buildConfigPlan,\n collectBindingValueNeeds,\n planHasContent,\n} from \"./config-plan\";\nimport {\n reportConfigWrite,\n validateBundle,\n writeConfig,\n} from \"./config-writer\";\nimport {\n JS_IDENTIFIER,\n REGISTRY_REPO,\n type RegistryToken,\n resolveToken,\n} from \"./constants\";\nimport { parseEnv } from \"./env-reconcile\";\nimport {\n extractRequirements,\n type ResourceRequirementRow,\n renderRequirements,\n} from \"./requirements\";\n\n/** Subdirectories that commonly hold the frontend / server in an AppKit app. */\nconst FRONTEND_SUBDIRS = [\"client\", \"frontend\", \"web\", \"app\"];\nconst SERVER_SUBDIRS = [\"server\", \"api\", \"backend\"];\n\nfunction isDir(p: string): boolean {\n return fs.existsSync(p) && fs.statSync(p).isDirectory();\n}\n\n/** A registry item is a server plugin if it ships a manifest.json. */\nfunction isPluginItem(item: RegistryItem): boolean {\n return (item.files ?? []).some(\n (f) => path.basename(f.target ?? f.path) === \"manifest.json\",\n );\n}\n\n/**\n * Locates the frontend root for UI components. AppKit apps put the client in a\n * client/ subdir (with its own components.json + src/); the CLI is typically\n * run from the repo root. Prefer the dir with components.json, then a src/.\n */\nfunction findFrontendRoot(cwd: string): string {\n if (fs.existsSync(path.join(cwd, \"components.json\"))) return cwd;\n for (const sub of FRONTEND_SUBDIRS) {\n if (fs.existsSync(path.join(cwd, sub, \"components.json\"))) {\n return path.join(cwd, sub);\n }\n }\n if (isDir(path.join(cwd, \"src\"))) return cwd;\n for (const sub of FRONTEND_SUBDIRS) {\n if (isDir(path.join(cwd, sub, \"src\"))) return path.join(cwd, sub);\n }\n return cwd;\n}\n\n/** Locates the server root for plugins (the server/ subdir, else cwd). */\nfunction findServerRoot(cwd: string): string {\n for (const sub of SERVER_SUBDIRS) {\n if (isDir(path.join(cwd, sub))) return path.join(cwd, sub);\n }\n return cwd;\n}\n\n/** Nearest dir with a package.json, walking up from start (for dep install). */\nfunction findNearestPackageJson(start: string): string {\n let dir = start;\n for (;;) {\n if (fs.existsSync(path.join(dir, \"package.json\"))) return dir;\n const parent = path.dirname(dir);\n if (parent === dir) return start;\n dir = parent;\n }\n}\n\n/**\n * The Databricks profile the app is configured with, read from\n * `DATABRICKS_CONFIG_PROFILE` in `cwd/.env` via the same dotenv parser the app\n * loads its env with. The CLI's top-level `dotenv/config` only loads the launch\n * dir's `.env` into `process.env`; when `--cwd` points at a different app dir,\n * that file isn't loaded, so the workspace picker and bundle validate would\n * miss the app's profile — this reads it directly. Undefined if the file or key\n * is absent, so the SDK's own default resolution still applies.\n */\nexport function profileFromEnv(cwd: string): string | undefined {\n try {\n const content = fs.readFileSync(path.join(cwd, \".env\"), \"utf-8\");\n return parseEnv(content).DATABRICKS_CONFIG_PROFILE || undefined;\n } catch {\n return undefined;\n }\n}\n\n/**\n * Resolves a registry item's `target` under `base`, enforcing that the result\n * stays inside `base`. Registry items are untrusted remote data; a `target`\n * like `../../../.zshrc` or an absolute path could otherwise write files\n * anywhere on disk (arbitrary-write → RCE). Throws on any escape.\n */\nexport function resolveWithinBase(base: string, target: string): string {\n if (path.isAbsolute(target)) {\n throw new Error(`Refusing absolute file target from registry: ${target}`);\n }\n const baseResolved = path.resolve(base);\n const resolved = path.resolve(baseResolved, target);\n if (\n resolved !== baseResolved &&\n !resolved.startsWith(baseResolved + path.sep)\n ) {\n throw new Error(\n `Refusing file target that escapes the destination directory: ${target}`,\n );\n }\n return resolved;\n}\n\n/** UI file destination (relative to the frontend root): placed in src/ if present. */\nfunction uiTargetPath(base: string, file: RegistryItemFile): string {\n let target = file.target ?? path.join(\"components\", path.basename(file.path));\n if (!target.startsWith(\"src/\") && isDir(path.join(base, \"src\"))) {\n target = path.join(\"src\", target);\n }\n return target;\n}\n\n/** Best-effort: the `toPlugin` export name from the item's index.ts. Returns\n * null (caller falls back to printed instructions) unless the name is a plain\n * JS identifier — the item is untrusted remote content and the value is\n * interpolated into the user's server.ts. */\nexport function pluginExportName(item: RegistryItem): string | null {\n const index = (item.files ?? []).find(\n (f) => path.basename(f.target ?? f.path) === \"index.ts\",\n );\n const match = index?.content.match(/export\\s*\\{([^}]*)\\}/);\n if (!match) return null;\n const names = match[1].split(\",\").map((s) => s.trim());\n // Prefer the camelCase toPlugin instance over the PascalCase class.\n const chosen = names.find((n) => /^[a-z]/.test(n)) ?? names[0];\n return chosen && JS_IDENTIFIER.test(chosen) ? chosen : null;\n}\n\n/**\n * A safe npm dependency spec: `[@scope/]name` with an optional `@version`\n * range. Registry `dependencies` are untrusted remote data passed to the\n * package manager, so we reject anything that isn't a plain name+range —\n * blocks tarball/git URL specs (install-script RCE) and `-`-prefixed entries\n * that the PM would parse as flags (argument injection).\n */\nconst SAFE_DEP_SPEC =\n /^(@[a-z0-9][\\w.-]*\\/)?[a-z0-9][\\w.-]*(@[\\w.\\-+~^><=|* ]+)?$/i;\n\n/** Splits deps into safe (installable) and rejected (surfaced to the user). */\nexport function partitionDeps(deps: string[]): {\n safe: string[];\n rejected: string[];\n} {\n const safe: string[] = [];\n const rejected: string[] = [];\n for (const dep of deps) {\n if (dep.startsWith(\"-\") || !SAFE_DEP_SPEC.test(dep)) rejected.push(dep);\n else safe.push(dep);\n }\n return { safe, rejected };\n}\n\n/** Splits an npm spec into `name` and optional version `range`, handling the\n * leading `@` of scoped names (`@databricks/appkit-ui@^0.41.0` → name\n * `@databricks/appkit-ui`, range `^0.41.0`; `lodash` → no range). */\nexport function parseDepSpec(spec: string): { name: string; range?: string } {\n const at = spec.lastIndexOf(\"@\");\n // at <= 0 means either no `@` (bare name) or the scope's `@` at index 0.\n if (at <= 0) return { name: spec };\n return { name: spec.slice(0, at), range: spec.slice(at + 1) };\n}\n\n/**\n * Registry `dependencies` are floors (\"needs at least this version\"), not pins.\n * Against the versions already in the target `package.json`, returns which specs\n * to install: missing packages (as declared) and genuine upgrades (installed\n * floor below the requested floor). A package already at a same-or-newer version\n * is skipped so the package manager never downgrades it; ranges that can't be\n * compared (workspace:*, catalog:, git) are skipped for the same reason.\n *\n * `semver` is injected so the caller can lazy-load it (see `installDependencies`).\n */\nexport function reconcileDeps(\n specs: string[],\n installed: Record<string, string>,\n { gte, minVersion }: Pick<typeof import(\"semver\"), \"gte\" | \"minVersion\">,\n): { install: string[]; skipped: string[] } {\n // minVersion() throws on ranges it can't parse (workspace:*, catalog:, git);\n // treat those as uncomparable and skip rather than risk a downgrade.\n const floor = (range: string): string | null => {\n try {\n return minVersion(range)?.version ?? null;\n } catch {\n return null;\n }\n };\n const install: string[] = [];\n const skipped: string[] = [];\n for (const spec of specs) {\n const { name, range } = parseDepSpec(spec);\n const have = installed[name];\n if (!have) {\n install.push(spec); // missing → install as declared\n continue;\n }\n if (!range) {\n skipped.push(spec); // present, no version asked → keep what's there\n continue;\n }\n const reqFloor = floor(range);\n const haveFloor = floor(have);\n if (!reqFloor || !haveFloor) {\n skipped.push(spec); // can't compare safely → don't touch\n } else if (gte(haveFloor, reqFloor)) {\n skipped.push(spec); // installed is same-or-newer → keep (no downgrade)\n } else {\n install.push(spec); // installed is older than required → upgrade\n }\n }\n return { install, skipped };\n}\n\n/** Merged dependencies + devDependencies (name → declared range) of a\n * package.json, tolerating a missing/unreadable file (returns {}). */\nfunction readInstalledRanges(pkgPath: string): Record<string, string> {\n try {\n const pkg = JSON.parse(fs.readFileSync(pkgPath, \"utf-8\")) as {\n dependencies?: Record<string, string>;\n devDependencies?: Record<string, string>;\n };\n return { ...pkg.dependencies, ...pkg.devDependencies };\n } catch {\n return {};\n }\n}\n\nasync function installDependencies(deps: string[], cwd: string): Promise<void> {\n if (deps.length === 0) return;\n\n const { safe, rejected } = partitionDeps(deps);\n if (rejected.length > 0) {\n console.warn(\n pc.yellow(\n `Skipping suspicious dependenc${rejected.length === 1 ? \"y\" : \"ies\"} from the registry (not a plain name@version): ${rejected.join(\", \")}. Install manually if you trust them.`,\n ),\n );\n }\n if (safe.length === 0) return;\n\n const pkgPath = path.join(cwd, \"package.json\");\n if (!fs.existsSync(pkgPath)) {\n console.warn(\n pc.yellow(\n `No package.json found — install these manually: ${safe.join(\" \")}`,\n ),\n );\n return;\n }\n\n // Lazy import: this file is loaded eagerly by the CLI entry, so keep semver\n // (only needed here) off the startup path — as with server-register/env-writer.\n const semver = await import(\"semver\");\n const { install, skipped } = reconcileDeps(\n safe,\n readInstalledRanges(pkgPath),\n semver,\n );\n if (skipped.length > 0) {\n console.log(\n pc.dim(\n `Keeping already-installed (registry asked for an older/equal range): ${skipped.join(\", \")}`,\n ),\n );\n }\n if (install.length === 0) return;\n\n const pm = detectPackageManager(cwd, \"npm\");\n const subcommand = pm === \"npm\" ? \"install\" : \"add\";\n console.log(`\\nInstalling dependencies with ${pm}: ${install.join(\" \")}`);\n // `--` stops the PM from parsing any dep as a flag (defense in depth).\n const result = spawnSync(pm, [subcommand, \"--\", ...install], {\n stdio: \"inherit\",\n cwd,\n });\n if (result.status !== 0) {\n console.warn(\n pc.yellow(\n `Dependency install exited with code ${result.status ?? \"unknown\"} — install manually if needed: ${install.join(\" \")}`,\n ),\n );\n }\n}\n\n/** Runs `appkit plugin sync --write` via this same CLI binary. */\nfunction runPluginSync(cwd: string): void {\n const result = spawnSync(\n process.execPath,\n [process.argv[1], \"plugin\", \"sync\", \"--write\"],\n { stdio: \"inherit\", cwd },\n );\n if (result.status !== 0) {\n console.warn(\n pc.yellow(\n \" Plugin sync did not complete cleanly — run `appkit plugin sync --write` manually.\",\n ),\n );\n }\n}\n\nfunction writeItemFile(\n base: string,\n target: string,\n content: string,\n force: boolean,\n cwd: string,\n): void {\n const dest = resolveWithinBase(base, target);\n const existed = fs.existsSync(dest);\n if (existed && !force) {\n console.error(\n pc.red(\n `Refusing to overwrite ${path.relative(cwd, dest)} — pass --force to replace it.`,\n ),\n );\n process.exit(1);\n }\n fs.mkdirSync(path.dirname(dest), { recursive: true });\n fs.writeFileSync(dest, content);\n const label = existed ? pc.yellow(\"Updated\") : pc.green(\"Created\");\n console.log(`${label} ${path.relative(cwd, dest)}`);\n}\n\ninterface PluginSummary {\n importPath: string;\n exportName: string | null;\n}\n\n/**\n * Fetches the requested items plus their transitive registryDependencies.\n * Dependencies are resolved breadth-first and de-duplicated by name, so a\n * plugin that depends on another registry item pulls the whole graph in one\n * `add`. Explicitly-requested items keep their request order and come first.\n */\nexport async function resolveItems(\n names: string[],\n token: RegistryToken | null,\n fetchItem: (\n name: string,\n token: RegistryToken | null,\n ) => Promise<RegistryItem> = fetchRegistryItem,\n): Promise<RegistryItem[]> {\n const seen = new Set<string>();\n const ordered: RegistryItem[] = [];\n // A name is both the fetch path and the on-disk `plugins/<name>` dir, so\n // reject non-slug refs (`/`, `..`, control chars) before they reach either.\n const enqueue = (ref: string): string => {\n const name = stripNamespace(ref);\n if (!isValidItemName(name)) {\n throw new Error(`Invalid registry item name: ${JSON.stringify(ref)}`);\n }\n return name;\n };\n // Breadth-first over the dependency graph, one level per iteration. Items in\n // a level are fetched concurrently (fetch latency is additive otherwise), but\n // levels stay ordered and dedup/cycle handling is unchanged: a name is marked\n // seen before its level is fetched, so it's never fetched or queued twice.\n let level = names.map(enqueue).filter((name) => {\n if (seen.has(name)) return false;\n seen.add(name);\n return true;\n });\n\n while (level.length > 0) {\n const items = await Promise.all(\n level.map(async (key) => {\n const item = await fetchItem(key, token);\n // Pin to the fetch key: the body's self-reported `name` is untrusted\n // and could claim a verified name to slip past the gate. The key is the\n // trustworthy identity the index keys `verified` on.\n item.name = key;\n return item;\n }),\n );\n ordered.push(...items);\n const next: string[] = [];\n for (const item of items) {\n for (const dep of item.registryDependencies ?? []) {\n const depName = enqueue(dep);\n if (seen.has(depName)) continue;\n seen.add(depName);\n next.push(depName);\n }\n }\n level = next;\n }\n\n return ordered;\n}\n\ninterface AddOptions {\n force?: boolean;\n cwd?: string;\n register?: boolean;\n /** false = don't reconcile resource env vars into .env. */\n resources?: boolean;\n /** true = never prompt; use --env flags or leave unset (agent/CI). */\n yes?: boolean;\n /** Pre-supplied env values from repeated --env KEY=VALUE flags. */\n env?: Record<string, string>;\n /** Databricks profile passed to `bundle validate` after writing config. */\n profile?: string;\n /** true = install items the registry index doesn't mark verified. */\n allowUnverified?: boolean;\n}\n\n/**\n * Splits requested names into verified and unverified against the index's\n * verified set. When `verified` is null the index couldn't be read — we can't\n * prove anything is verified, so every name is treated as unverified (the gate\n * then decides whether to warn-and-continue or block). Names are compared with\n * the namespace stripped, matching how items are fetched.\n */\nexport function partitionVerified(\n refs: string[],\n verified: Set<string> | null,\n): { verified: string[]; unverified: string[] } {\n const ok: string[] = [];\n const bad: string[] = [];\n for (const ref of refs) {\n const name = stripNamespace(ref);\n if (verified?.has(name)) ok.push(name);\n else bad.push(name);\n }\n return { verified: ok, unverified: bad };\n}\n\nasync function runAdd(refs: string[], opts: AddOptions): Promise<void> {\n const cwd = opts.cwd ? path.resolve(opts.cwd) : process.cwd();\n const token = resolveToken();\n if (token) {\n console.log(\n `Using ${token.envName} to fetch from ${REGISTRY_REPO} (private).`,\n );\n }\n\n // Resolve the full graph and fetch the verified index concurrently (two\n // independent round-trips). Item resolution is read-only — nothing is written\n // or installed until after the gate below.\n const verifiedP = opts.allowUnverified\n ? Promise.resolve(null)\n : fetchVerifiedNames(token);\n const items = await resolveItems(refs, token);\n\n // Integrity gate over the *entire resolved set* (not just requested names, so\n // an unverified transitive dep can't ride in on a verified item). Fails closed:\n // a null verified set (unreadable index) makes every item count as unverified.\n if (!opts.allowUnverified) {\n const verified = await verifiedP;\n const { unverified } = partitionVerified(\n items.map((i) => i.name),\n verified,\n );\n if (unverified.length > 0) {\n const reason =\n verified === null\n ? \"could not read the registry index to verify these items\"\n : `not marked verified in ${REGISTRY_REPO}`;\n console.error(\n pc.red(\n `Refusing to add unverified item(s) (${reason}): ${unverified.join(\", \")}.`,\n ),\n );\n console.error(\n pc.dim(\n \" Re-run with --allow-unverified if you trust the source; unverified items run code in your app.\",\n ),\n );\n process.exit(1);\n }\n }\n\n const hasUi = items.some((i) => !isPluginItem(i));\n const hasPlugin = items.some(isPluginItem);\n const frontendRoot = hasUi ? findFrontendRoot(cwd) : cwd;\n const serverRoot = hasPlugin ? findServerRoot(cwd) : cwd;\n if (hasUi && frontendRoot !== cwd) {\n console.log(pc.dim(`UI components → ${path.relative(cwd, frontendRoot)}/`));\n }\n if (hasPlugin && serverRoot !== cwd) {\n console.log(pc.dim(`Plugins → ${path.relative(cwd, serverRoot)}/`));\n }\n\n const deps = new Set<string>();\n let wroteUi = false;\n const pluginSummaries: PluginSummary[] = [];\n const allRequirements: ResourceRequirementRow[] = [];\n\n for (const item of items) {\n for (const dep of item.dependencies ?? []) deps.add(dep);\n\n if (isPluginItem(item)) {\n let pluginRel = path.join(\"plugins\", item.name);\n for (const file of item.files ?? []) {\n const target =\n file.target ??\n path.join(\"plugins\", item.name, path.basename(file.path));\n writeItemFile(\n serverRoot,\n target,\n file.content,\n Boolean(opts.force),\n cwd,\n );\n if (path.basename(target) === \"manifest.json\") {\n pluginRel = path.dirname(target);\n }\n }\n const requirements = extractRequirements(item);\n if (requirements.length > 0) {\n console.log(`\\n${renderRequirements(item, requirements)}`);\n allRequirements.push(...requirements);\n }\n pluginSummaries.push({\n importPath: `./${pluginRel}`,\n exportName: pluginExportName(item),\n });\n } else {\n for (const file of item.files ?? []) {\n writeItemFile(\n frontendRoot,\n uiTargetPath(frontendRoot, file),\n file.content,\n Boolean(opts.force),\n cwd,\n );\n wroteUi = true;\n }\n }\n }\n\n await installDependencies([...deps], findNearestPackageJson(cwd));\n\n if (hasPlugin) {\n console.log(pc.dim(\"\\nRegistering plugins (appkit plugin sync)...\"));\n runPluginSync(cwd);\n }\n\n if (wroteUi) {\n console.log(\n pc.dim(\n '\\nReminder: import \"@databricks/appkit-ui/styles.css\" once at your app root so components are themed.',\n ),\n );\n }\n // Lazy import: server-register pulls in @ast-grep/napi (a native addon), and\n // this CLI is imported eagerly by index.ts, so a static import would make\n // every unrelated command pay that cost.\n const registerPluginInServer =\n opts.register !== false && pluginSummaries.some((s) => s.exportName)\n ? (await import(\"./server-register.js\")).registerPluginInServer\n : null;\n for (const s of pluginSummaries) {\n // Try to wire the plugin into the server's createApp call automatically;\n // fall back to printing the snippet when the shape isn't the standard one.\n let wired = false;\n // Why auto-registration was skipped, so the fallback can say so (an empty\n // reason means the user opted out via --no-register — no nag then).\n let skipReason: string | undefined;\n if (opts.register === false) {\n // opted out — print the snippet without a \"couldn't\" message\n } else if (!s.exportName) {\n skipReason =\n \"couldn't read a plugin export name from the item's index.ts\";\n } else if (registerPluginInServer) {\n const result = registerPluginInServer(\n serverRoot,\n s.importPath,\n s.exportName,\n );\n // result.file is relative to serverRoot; show it from cwd for the user.\n const shown =\n result.file && path.relative(cwd, path.join(serverRoot, result.file));\n if (result.status === \"wired\") {\n console.log(`\\n${pc.green(\"Registered\")} ${s.exportName} in ${shown}`);\n wired = true;\n } else if (result.status === \"already\") {\n console.log(\n pc.dim(`\\n${s.exportName} is already registered in ${shown}`),\n );\n wired = true;\n } else {\n skipReason = result.reason;\n }\n }\n if (!wired) {\n const imp = s.exportName ?? \"<plugin>\";\n if (skipReason) {\n console.log(\n pc.yellow(`\\nCouldn't auto-register ${imp} — ${skipReason}.`),\n );\n }\n console.log(\n `${pc.bold(\"Add this to your server's createApp call:\")}\\n` +\n pc.dim(\n ` import { ${imp} } from \"${s.importPath}\";\\n` +\n ` const app = await createApp({ plugins: [${imp}(), /* ... */] });`,\n ),\n );\n }\n }\n\n if (opts.resources !== false && allRequirements.length > 0) {\n // Lazy import (same reason as server-register above): env-writer pulls in\n // the workspace picker and, through it, the Databricks SDK.\n const { collectBindingValues, reportEnvResolutions, syncEnv } =\n await import(\"./env-writer.js\");\n // Without --profile, fall back to the app's configured profile so the\n // picker and bundle validate reach the workspace the app runs against.\n const profile = opts.profile ?? profileFromEnv(cwd);\n console.log(pc.dim(\"\\nReconciling resource env vars into .env...\"));\n const resolutions = await syncEnv(allRequirements, {\n cwd,\n nonInteractive: Boolean(opts.yes),\n values: opts.env,\n profile,\n });\n reportEnvResolutions(resolutions);\n\n // Deploy config (app.yaml + databricks.yml). Values come from what the\n // user supplied for env fields (flags or prompts); other fields fall back\n // to their manifest defaults inside buildConfigPlan.\n const values: Record<string, string> = { ...(opts.env ?? {}) };\n for (const r of resolutions) {\n if (r.value !== undefined) values[r.env] = r.value;\n }\n // Binding fields with no env name (e.g. postgres project/branch/database)\n // never flow through .env, so collect them separately — else their\n // databricks.yml bundle variables stay unassigned and bundle validate fails.\n const bindingNeeds = collectBindingValueNeeds(allRequirements);\n if (bindingNeeds.length > 0) {\n const bindingValues = await collectBindingValues(bindingNeeds, {\n cwd,\n nonInteractive: Boolean(opts.yes),\n values: opts.env,\n profile,\n });\n Object.assign(values, bindingValues);\n }\n const plan = buildConfigPlan(allRequirements, values);\n if (planHasContent(plan)) {\n const result = writeConfig(cwd, plan);\n reportConfigWrite(result);\n if (result.databricksYmlChanged) validateBundle(cwd, profile);\n }\n warnScopeNeeding(allRequirements);\n }\n}\n\n/**\n * v1 does not write `user_api_scopes` (deferred to the manifest scope\n * extension). Warn when an added plugin's resource type is known to need one,\n * so the user adds it before deploy.\n */\n/** Returns the user_api_scopes implied by a set of resource rows (deduped). */\nexport function scopesForResources(\n rows: ResourceRequirementRow[],\n): Map<string, string> {\n const needed = new Map<string, string>();\n for (const row of rows) {\n if (Object.hasOwn(SCOPE_BY_TYPE, row.type)) {\n needed.set(\n row.type,\n SCOPE_BY_TYPE[row.type as keyof typeof SCOPE_BY_TYPE],\n );\n }\n }\n return needed;\n}\n\nfunction warnScopeNeeding(rows: ResourceRequirementRow[]): void {\n const needed = scopesForResources(rows);\n if (needed.size === 0) return;\n const list = [...needed.entries()]\n .map(([type, scope]) => `${type} → ${scope}`)\n .join(\", \");\n console.warn(\n pc.yellow(\n `\\n Note: these resources may need a user_api_scope before deploy: ${list}.\\n` +\n \" Add it under resources.apps.app.user_api_scopes in databricks.yml.\",\n ),\n );\n}\n\n/** Commander reducer for repeatable `--env KEY=VALUE` flags. */\nfunction collectEnvFlag(\n raw: string,\n acc: Record<string, string>,\n): Record<string, string> {\n const eq = raw.indexOf(\"=\");\n if (eq === -1) {\n console.error(`Ignoring --env \"${raw}\" (expected KEY=VALUE).`);\n return acc;\n }\n const key = raw.slice(0, eq).trim();\n const value = raw.slice(eq + 1);\n if (key) acc[key] = value;\n return acc;\n}\n\nexport const addCommand = new Command(\"add\")\n .description(\"Add a UI component or server plugin from the AppKit registry\")\n .argument(\"<item...>\", \"Registry item name(s), e.g. metric-card or hello\")\n .option(\"-f, --force\", \"Overwrite existing files\")\n .option(\"-C, --cwd <dir>\", \"Run as if started in <dir>\")\n .option(\"--no-register\", \"Don't edit the server entry to register plugins\")\n .option(\"--no-resources\", \"Don't reconcile resource env vars into .env\")\n .option(\"-y, --yes\", \"Don't prompt; use --env values or leave vars unset\")\n .option(\n \"--env <KEY=VALUE>\",\n \"Pre-set a resource env var (repeatable)\",\n collectEnvFlag,\n {},\n )\n .option(\n \"-p, --profile <name>\",\n \"Databricks profile for the resource picker and bundle validate (defaults to the app's DATABRICKS_CONFIG_PROFILE)\",\n )\n .option(\n \"--allow-unverified\",\n \"Add items the registry doesn't mark verified (runs untrusted code)\",\n )\n .addHelpText(\n \"after\",\n `\nNo components.json is required. Item type is detected automatically:\n • UI components → <frontend>/src/components/appkit/ (client/ detected)\n • Server plugins → <server>/plugins/<name>/, runs plugin sync, and registers\n them in your createApp call (use --no-register to skip the server edit)\n\nServer plugins declare Databricks resources. On add, their env vars are\nreconciled into .env (and names into .env.example), and the deploy config\n(app.yaml + databricks.yml resource bindings) is patched to match — existing\nentries are never clobbered. Interactive by default; pass --yes for agents/CI\n(uses --env values, leaves the rest unset) and --env KEY=VALUE to supply\nvalues non-interactively. Pass --profile to validate the bundle after writing.\n\nThe frontend/server roots are detected from common layouts, so you can run\nthis from the repo root. While the registry repo is private, a read token is\nresolved from \\`gh auth token\\` or APPKIT_REGISTRY_TOKEN / GITHUB_TOKEN / GH_TOKEN.\n\nExamples:\n $ appkit add metric-card # UI component\n $ appkit add hello # server plugin\n $ appkit add metric-card hello # mix in one call\n $ appkit add analytics --yes --env DATABRICKS_WAREHOUSE_ID=abc123`,\n )\n .action((items: string[], opts: AddOptions) =>\n runAdd(items, opts).catch((err) => {\n console.error(err);\n process.exit(1);\n }),\n );\n"],"mappings":"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"}
1
+ {"version":3,"file":"add.js","names":[],"sources":["../../../../src/cli/commands/registry/add.ts"],"sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport process from \"node:process\";\n\nimport { Command } from \"commander\";\nimport pc from \"picocolors\";\n\nimport { SCOPE_BY_TYPE } from \"../../../schemas/manifest\";\nimport { detectPackageManager } from \"../../package-manager\";\nimport {\n fetchRegistryItem,\n fetchVerifiedNames,\n isValidItemName,\n type RegistryItem,\n type RegistryItemFile,\n stripNamespace,\n} from \"./client\";\nimport {\n buildConfigPlan,\n collectBindingValueNeeds,\n planHasContent,\n} from \"./config-plan\";\nimport {\n reportConfigWrite,\n validateBundle,\n writeConfig,\n} from \"./config-writer\";\nimport { JS_IDENTIFIER, REGISTRY_REPO } from \"./constants\";\nimport { parseEnv } from \"./env-reconcile\";\nimport {\n extractRequirements,\n type ResourceRequirementRow,\n renderRequirements,\n} from \"./requirements\";\n\n/** Subdirectories that commonly hold the frontend / server in an AppKit app. */\nconst FRONTEND_SUBDIRS = [\"client\", \"frontend\", \"web\", \"app\"];\nconst SERVER_SUBDIRS = [\"server\", \"api\", \"backend\"];\n\nfunction isDir(p: string): boolean {\n return fs.existsSync(p) && fs.statSync(p).isDirectory();\n}\n\n/** A registry item is a server plugin if it ships a manifest.json. */\nfunction isPluginItem(item: RegistryItem): boolean {\n return (item.files ?? []).some(\n (f) => path.basename(f.target ?? f.path) === \"manifest.json\",\n );\n}\n\n/**\n * Locates the frontend root for UI components. AppKit apps put the client in a\n * client/ subdir (with its own components.json + src/); the CLI is typically\n * run from the repo root. Prefer the dir with components.json, then a src/.\n */\nfunction findFrontendRoot(cwd: string): string {\n if (fs.existsSync(path.join(cwd, \"components.json\"))) return cwd;\n for (const sub of FRONTEND_SUBDIRS) {\n if (fs.existsSync(path.join(cwd, sub, \"components.json\"))) {\n return path.join(cwd, sub);\n }\n }\n if (isDir(path.join(cwd, \"src\"))) return cwd;\n for (const sub of FRONTEND_SUBDIRS) {\n if (isDir(path.join(cwd, sub, \"src\"))) return path.join(cwd, sub);\n }\n return cwd;\n}\n\n/** Locates the server root for plugins (the server/ subdir, else cwd). */\nfunction findServerRoot(cwd: string): string {\n for (const sub of SERVER_SUBDIRS) {\n if (isDir(path.join(cwd, sub))) return path.join(cwd, sub);\n }\n return cwd;\n}\n\n/** Nearest dir with a package.json, walking up from start (for dep install). */\nfunction findNearestPackageJson(start: string): string {\n let dir = start;\n for (;;) {\n if (fs.existsSync(path.join(dir, \"package.json\"))) return dir;\n const parent = path.dirname(dir);\n if (parent === dir) return start;\n dir = parent;\n }\n}\n\n/**\n * The Databricks profile the app is configured with, read from\n * `DATABRICKS_CONFIG_PROFILE` in `cwd/.env` via the same dotenv parser the app\n * loads its env with. The CLI's top-level `dotenv/config` only loads the launch\n * dir's `.env` into `process.env`; when `--cwd` points at a different app dir,\n * that file isn't loaded, so the workspace picker and bundle validate would\n * miss the app's profile — this reads it directly. Undefined if the file or key\n * is absent, so the SDK's own default resolution still applies.\n */\nexport function profileFromEnv(cwd: string): string | undefined {\n try {\n const content = fs.readFileSync(path.join(cwd, \".env\"), \"utf-8\");\n return parseEnv(content).DATABRICKS_CONFIG_PROFILE || undefined;\n } catch {\n return undefined;\n }\n}\n\n/**\n * Resolves a registry item's `target` under `base`, enforcing that the result\n * stays inside `base`. Registry items are untrusted remote data; a `target`\n * like `../../../.zshrc` or an absolute path could otherwise write files\n * anywhere on disk (arbitrary-write → RCE). Throws on any escape.\n */\nexport function resolveWithinBase(base: string, target: string): string {\n if (path.isAbsolute(target)) {\n throw new Error(`Refusing absolute file target from registry: ${target}`);\n }\n const baseResolved = path.resolve(base);\n const resolved = path.resolve(baseResolved, target);\n if (\n resolved !== baseResolved &&\n !resolved.startsWith(baseResolved + path.sep)\n ) {\n throw new Error(\n `Refusing file target that escapes the destination directory: ${target}`,\n );\n }\n return resolved;\n}\n\n/** UI file destination (relative to the frontend root): placed in src/ if present. */\nfunction uiTargetPath(base: string, file: RegistryItemFile): string {\n let target = file.target ?? path.join(\"components\", path.basename(file.path));\n if (!target.startsWith(\"src/\") && isDir(path.join(base, \"src\"))) {\n target = path.join(\"src\", target);\n }\n return target;\n}\n\n/** Best-effort: the `toPlugin` export name from the item's index.ts. Returns\n * null (caller falls back to printed instructions) unless the name is a plain\n * JS identifier — the item is untrusted remote content and the value is\n * interpolated into the user's server.ts. */\nexport function pluginExportName(item: RegistryItem): string | null {\n const index = (item.files ?? []).find(\n (f) => path.basename(f.target ?? f.path) === \"index.ts\",\n );\n const match = index?.content.match(/export\\s*\\{([^}]*)\\}/);\n if (!match) return null;\n const names = match[1].split(\",\").map((s) => s.trim());\n // Prefer the camelCase toPlugin instance over the PascalCase class.\n const chosen = names.find((n) => /^[a-z]/.test(n)) ?? names[0];\n return chosen && JS_IDENTIFIER.test(chosen) ? chosen : null;\n}\n\n/**\n * A safe npm dependency spec: `[@scope/]name` with an optional `@version`\n * range. Registry `dependencies` are untrusted remote data passed to the\n * package manager, so we reject anything that isn't a plain name+range —\n * blocks tarball/git URL specs (install-script RCE) and `-`-prefixed entries\n * that the PM would parse as flags (argument injection).\n */\nconst SAFE_DEP_SPEC =\n /^(@[a-z0-9][\\w.-]*\\/)?[a-z0-9][\\w.-]*(@[\\w.\\-+~^><=|* ]+)?$/i;\n\n/** Splits deps into safe (installable) and rejected (surfaced to the user). */\nexport function partitionDeps(deps: string[]): {\n safe: string[];\n rejected: string[];\n} {\n const safe: string[] = [];\n const rejected: string[] = [];\n for (const dep of deps) {\n if (dep.startsWith(\"-\") || !SAFE_DEP_SPEC.test(dep)) rejected.push(dep);\n else safe.push(dep);\n }\n return { safe, rejected };\n}\n\n/** Splits an npm spec into `name` and optional version `range`, handling the\n * leading `@` of scoped names (`@databricks/appkit-ui@^0.41.0` → name\n * `@databricks/appkit-ui`, range `^0.41.0`; `lodash` → no range). */\nexport function parseDepSpec(spec: string): { name: string; range?: string } {\n const at = spec.lastIndexOf(\"@\");\n // at <= 0 means either no `@` (bare name) or the scope's `@` at index 0.\n if (at <= 0) return { name: spec };\n return { name: spec.slice(0, at), range: spec.slice(at + 1) };\n}\n\n/**\n * Registry `dependencies` are floors (\"needs at least this version\"), not pins.\n * Against the versions already in the target `package.json`, returns which specs\n * to install: missing packages (as declared) and genuine upgrades (installed\n * floor below the requested floor). A package already at a same-or-newer version\n * is skipped so the package manager never downgrades it; ranges that can't be\n * compared (workspace:*, catalog:, git) are skipped for the same reason.\n *\n * `semver` is injected so the caller can lazy-load it (see `installDependencies`).\n */\nexport function reconcileDeps(\n specs: string[],\n installed: Record<string, string>,\n { gte, minVersion }: Pick<typeof import(\"semver\"), \"gte\" | \"minVersion\">,\n): { install: string[]; skipped: string[] } {\n // minVersion() throws on ranges it can't parse (workspace:*, catalog:, git);\n // treat those as uncomparable and skip rather than risk a downgrade.\n const floor = (range: string): string | null => {\n try {\n return minVersion(range)?.version ?? null;\n } catch {\n return null;\n }\n };\n const install: string[] = [];\n const skipped: string[] = [];\n for (const spec of specs) {\n const { name, range } = parseDepSpec(spec);\n const have = installed[name];\n if (!have) {\n install.push(spec); // missing → install as declared\n continue;\n }\n if (!range) {\n skipped.push(spec); // present, no version asked → keep what's there\n continue;\n }\n const reqFloor = floor(range);\n const haveFloor = floor(have);\n if (!reqFloor || !haveFloor) {\n skipped.push(spec); // can't compare safely → don't touch\n } else if (gte(haveFloor, reqFloor)) {\n skipped.push(spec); // installed is same-or-newer → keep (no downgrade)\n } else {\n install.push(spec); // installed is older than required → upgrade\n }\n }\n return { install, skipped };\n}\n\n/** Merged dependencies + devDependencies (name → declared range) of a\n * package.json, tolerating a missing/unreadable file (returns {}). */\nfunction readInstalledRanges(pkgPath: string): Record<string, string> {\n try {\n const pkg = JSON.parse(fs.readFileSync(pkgPath, \"utf-8\")) as {\n dependencies?: Record<string, string>;\n devDependencies?: Record<string, string>;\n };\n return { ...pkg.dependencies, ...pkg.devDependencies };\n } catch {\n return {};\n }\n}\n\nasync function installDependencies(deps: string[], cwd: string): Promise<void> {\n if (deps.length === 0) return;\n\n const { safe, rejected } = partitionDeps(deps);\n if (rejected.length > 0) {\n console.warn(\n pc.yellow(\n `Skipping suspicious dependenc${rejected.length === 1 ? \"y\" : \"ies\"} from the registry (not a plain name@version): ${rejected.join(\", \")}. Install manually if you trust them.`,\n ),\n );\n }\n if (safe.length === 0) return;\n\n const pkgPath = path.join(cwd, \"package.json\");\n if (!fs.existsSync(pkgPath)) {\n console.warn(\n pc.yellow(\n `No package.json found — install these manually: ${safe.join(\" \")}`,\n ),\n );\n return;\n }\n\n // Lazy import: this file is loaded eagerly by the CLI entry, so keep semver\n // (only needed here) off the startup path — as with server-register/env-writer.\n const semver = await import(\"semver\");\n const { install, skipped } = reconcileDeps(\n safe,\n readInstalledRanges(pkgPath),\n semver,\n );\n if (skipped.length > 0) {\n console.log(\n pc.dim(\n `Keeping already-installed (registry asked for an older/equal range): ${skipped.join(\", \")}`,\n ),\n );\n }\n if (install.length === 0) return;\n\n const pm = detectPackageManager(cwd, \"npm\");\n const subcommand = pm === \"npm\" ? \"install\" : \"add\";\n console.log(`\\nInstalling dependencies with ${pm}: ${install.join(\" \")}`);\n // `--` stops the PM from parsing any dep as a flag (defense in depth).\n const result = spawnSync(pm, [subcommand, \"--\", ...install], {\n stdio: \"inherit\",\n cwd,\n });\n if (result.status !== 0) {\n console.warn(\n pc.yellow(\n `Dependency install exited with code ${result.status ?? \"unknown\"} — install manually if needed: ${install.join(\" \")}`,\n ),\n );\n }\n}\n\n/** Runs `appkit plugin sync --write` via this same CLI binary. */\nfunction runPluginSync(cwd: string): void {\n const result = spawnSync(\n process.execPath,\n [process.argv[1], \"plugin\", \"sync\", \"--write\"],\n { stdio: \"inherit\", cwd },\n );\n if (result.status !== 0) {\n console.warn(\n pc.yellow(\n \" Plugin sync did not complete cleanly — run `appkit plugin sync --write` manually.\",\n ),\n );\n }\n}\n\nfunction writeItemFile(\n base: string,\n target: string,\n content: string,\n force: boolean,\n cwd: string,\n): void {\n const dest = resolveWithinBase(base, target);\n const existed = fs.existsSync(dest);\n if (existed && !force) {\n console.error(\n pc.red(\n `Refusing to overwrite ${path.relative(cwd, dest)} — pass --force to replace it.`,\n ),\n );\n process.exit(1);\n }\n fs.mkdirSync(path.dirname(dest), { recursive: true });\n fs.writeFileSync(dest, content);\n const label = existed ? pc.yellow(\"Updated\") : pc.green(\"Created\");\n console.log(`${label} ${path.relative(cwd, dest)}`);\n}\n\ninterface PluginSummary {\n importPath: string;\n exportName: string | null;\n}\n\n/**\n * Fetches the requested items plus their transitive registryDependencies.\n * Dependencies are resolved breadth-first and de-duplicated by name, so a\n * plugin that depends on another registry item pulls the whole graph in one\n * `add`. Explicitly-requested items keep their request order and come first.\n */\nexport async function resolveItems(\n names: string[],\n fetchItem: (name: string) => Promise<RegistryItem> = fetchRegistryItem,\n): Promise<RegistryItem[]> {\n const seen = new Set<string>();\n const ordered: RegistryItem[] = [];\n // A name is both the fetch path and the on-disk `plugins/<name>` dir, so\n // reject non-slug refs (`/`, `..`, control chars) before they reach either.\n const enqueue = (ref: string): string => {\n const name = stripNamespace(ref);\n if (!isValidItemName(name)) {\n throw new Error(`Invalid registry item name: ${JSON.stringify(ref)}`);\n }\n return name;\n };\n // Breadth-first over the dependency graph, one level per iteration. Items in\n // a level are fetched concurrently (fetch latency is additive otherwise), but\n // levels stay ordered and dedup/cycle handling is unchanged: a name is marked\n // seen before its level is fetched, so it's never fetched or queued twice.\n let level = names.map(enqueue).filter((name) => {\n if (seen.has(name)) return false;\n seen.add(name);\n return true;\n });\n\n while (level.length > 0) {\n const items = await Promise.all(\n level.map(async (key) => {\n const item = await fetchItem(key);\n // Pin to the fetch key: the body's self-reported `name` is untrusted\n // and could claim a verified name to slip past the gate. The key is the\n // trustworthy identity the index keys `verified` on.\n item.name = key;\n return item;\n }),\n );\n ordered.push(...items);\n const next: string[] = [];\n for (const item of items) {\n for (const dep of item.registryDependencies ?? []) {\n const depName = enqueue(dep);\n if (seen.has(depName)) continue;\n seen.add(depName);\n next.push(depName);\n }\n }\n level = next;\n }\n\n return ordered;\n}\n\ninterface AddOptions {\n force?: boolean;\n cwd?: string;\n register?: boolean;\n /** false = don't reconcile resource env vars into .env. */\n resources?: boolean;\n /** true = never prompt; use --env flags or leave unset (agent/CI). */\n yes?: boolean;\n /** Pre-supplied env values from repeated --env KEY=VALUE flags. */\n env?: Record<string, string>;\n /** Databricks profile passed to `bundle validate` after writing config. */\n profile?: string;\n /** true = install items the registry index doesn't mark verified. */\n allowUnverified?: boolean;\n}\n\n/**\n * Splits requested names into verified and unverified against the index's\n * verified set. When `verified` is null the index couldn't be read — we can't\n * prove anything is verified, so every name is treated as unverified (the gate\n * then decides whether to warn-and-continue or block). Names are compared with\n * the namespace stripped, matching how items are fetched.\n */\nexport function partitionVerified(\n refs: string[],\n verified: Set<string> | null,\n): { verified: string[]; unverified: string[] } {\n const ok: string[] = [];\n const bad: string[] = [];\n for (const ref of refs) {\n const name = stripNamespace(ref);\n if (verified?.has(name)) ok.push(name);\n else bad.push(name);\n }\n return { verified: ok, unverified: bad };\n}\n\nasync function runAdd(refs: string[], opts: AddOptions): Promise<void> {\n const cwd = opts.cwd ? path.resolve(opts.cwd) : process.cwd();\n\n // Resolve the full graph and fetch the verified index concurrently (two\n // independent round-trips). Item resolution is read-only — nothing is written\n // or installed until after the gate below.\n const verifiedP = opts.allowUnverified\n ? Promise.resolve(null)\n : fetchVerifiedNames();\n const items = await resolveItems(refs);\n\n // Integrity gate over the *entire resolved set* (not just requested names, so\n // an unverified transitive dep can't ride in on a verified item). Fails closed:\n // a null verified set (unreadable index) makes every item count as unverified.\n if (!opts.allowUnverified) {\n const verified = await verifiedP;\n const { unverified } = partitionVerified(\n items.map((i) => i.name),\n verified,\n );\n if (unverified.length > 0) {\n const reason =\n verified === null\n ? \"could not read the registry index to verify these items\"\n : `not marked verified in ${REGISTRY_REPO}`;\n console.error(\n pc.red(\n `Refusing to add unverified item(s) (${reason}): ${unverified.join(\", \")}.`,\n ),\n );\n console.error(\n pc.dim(\n \" Re-run with --allow-unverified if you trust the source; unverified items run code in your app.\",\n ),\n );\n process.exit(1);\n }\n }\n\n const hasUi = items.some((i) => !isPluginItem(i));\n const hasPlugin = items.some(isPluginItem);\n const frontendRoot = hasUi ? findFrontendRoot(cwd) : cwd;\n const serverRoot = hasPlugin ? findServerRoot(cwd) : cwd;\n if (hasUi && frontendRoot !== cwd) {\n console.log(pc.dim(`UI components → ${path.relative(cwd, frontendRoot)}/`));\n }\n if (hasPlugin && serverRoot !== cwd) {\n console.log(pc.dim(`Plugins → ${path.relative(cwd, serverRoot)}/`));\n }\n\n const deps = new Set<string>();\n let wroteUi = false;\n const pluginSummaries: PluginSummary[] = [];\n const allRequirements: ResourceRequirementRow[] = [];\n\n for (const item of items) {\n for (const dep of item.dependencies ?? []) deps.add(dep);\n\n if (isPluginItem(item)) {\n let pluginRel = path.join(\"plugins\", item.name);\n for (const file of item.files ?? []) {\n const target =\n file.target ??\n path.join(\"plugins\", item.name, path.basename(file.path));\n writeItemFile(\n serverRoot,\n target,\n file.content,\n Boolean(opts.force),\n cwd,\n );\n if (path.basename(target) === \"manifest.json\") {\n pluginRel = path.dirname(target);\n }\n }\n const requirements = extractRequirements(item);\n if (requirements.length > 0) {\n console.log(`\\n${renderRequirements(item, requirements)}`);\n allRequirements.push(...requirements);\n }\n pluginSummaries.push({\n importPath: `./${pluginRel}`,\n exportName: pluginExportName(item),\n });\n } else {\n for (const file of item.files ?? []) {\n writeItemFile(\n frontendRoot,\n uiTargetPath(frontendRoot, file),\n file.content,\n Boolean(opts.force),\n cwd,\n );\n wroteUi = true;\n }\n }\n }\n\n await installDependencies([...deps], findNearestPackageJson(cwd));\n\n if (hasPlugin) {\n console.log(pc.dim(\"\\nRegistering plugins (appkit plugin sync)...\"));\n runPluginSync(cwd);\n }\n\n if (wroteUi) {\n console.log(\n pc.dim(\n '\\nReminder: import \"@databricks/appkit-ui/styles.css\" once at your app root so components are themed.',\n ),\n );\n }\n // Lazy import: server-register pulls in @ast-grep/napi (a native addon), and\n // this CLI is imported eagerly by index.ts, so a static import would make\n // every unrelated command pay that cost.\n const registerPluginInServer =\n opts.register !== false && pluginSummaries.some((s) => s.exportName)\n ? (await import(\"./server-register.js\")).registerPluginInServer\n : null;\n for (const s of pluginSummaries) {\n // Try to wire the plugin into the server's createApp call automatically;\n // fall back to printing the snippet when the shape isn't the standard one.\n let wired = false;\n // Why auto-registration was skipped, so the fallback can say so (an empty\n // reason means the user opted out via --no-register — no nag then).\n let skipReason: string | undefined;\n if (opts.register === false) {\n // opted out — print the snippet without a \"couldn't\" message\n } else if (!s.exportName) {\n skipReason =\n \"couldn't read a plugin export name from the item's index.ts\";\n } else if (registerPluginInServer) {\n const result = registerPluginInServer(\n serverRoot,\n s.importPath,\n s.exportName,\n );\n // result.file is relative to serverRoot; show it from cwd for the user.\n const shown =\n result.file && path.relative(cwd, path.join(serverRoot, result.file));\n if (result.status === \"wired\") {\n console.log(`\\n${pc.green(\"Registered\")} ${s.exportName} in ${shown}`);\n wired = true;\n } else if (result.status === \"already\") {\n console.log(\n pc.dim(`\\n${s.exportName} is already registered in ${shown}`),\n );\n wired = true;\n } else {\n skipReason = result.reason;\n }\n }\n if (!wired) {\n const imp = s.exportName ?? \"<plugin>\";\n if (skipReason) {\n console.log(\n pc.yellow(`\\nCouldn't auto-register ${imp} — ${skipReason}.`),\n );\n }\n console.log(\n `${pc.bold(\"Add this to your server's createApp call:\")}\\n` +\n pc.dim(\n ` import { ${imp} } from \"${s.importPath}\";\\n` +\n ` const app = await createApp({ plugins: [${imp}(), /* ... */] });`,\n ),\n );\n }\n }\n\n if (opts.resources !== false && allRequirements.length > 0) {\n // Lazy import (same reason as server-register above): env-writer pulls in\n // the workspace picker and, through it, the Databricks SDK.\n const { collectBindingValues, reportEnvResolutions, syncEnv } =\n await import(\"./env-writer.js\");\n // Without --profile, fall back to the app's configured profile so the\n // picker and bundle validate reach the workspace the app runs against.\n const profile = opts.profile ?? profileFromEnv(cwd);\n console.log(pc.dim(\"\\nReconciling resource env vars into .env...\"));\n const resolutions = await syncEnv(allRequirements, {\n cwd,\n nonInteractive: Boolean(opts.yes),\n values: opts.env,\n profile,\n });\n reportEnvResolutions(resolutions);\n\n // Deploy config (app.yaml + databricks.yml). Values come from what the\n // user supplied for env fields (flags or prompts); other fields fall back\n // to their manifest defaults inside buildConfigPlan.\n const values: Record<string, string> = { ...(opts.env ?? {}) };\n for (const r of resolutions) {\n if (r.value !== undefined) values[r.env] = r.value;\n }\n // Binding fields with no env name (e.g. postgres project/branch/database)\n // never flow through .env, so collect them separately — else their\n // databricks.yml bundle variables stay unassigned and bundle validate fails.\n const bindingNeeds = collectBindingValueNeeds(allRequirements);\n if (bindingNeeds.length > 0) {\n const bindingValues = await collectBindingValues(bindingNeeds, {\n cwd,\n nonInteractive: Boolean(opts.yes),\n values: opts.env,\n profile,\n });\n Object.assign(values, bindingValues);\n }\n const plan = buildConfigPlan(allRequirements, values);\n if (planHasContent(plan)) {\n const result = writeConfig(cwd, plan);\n reportConfigWrite(result);\n if (result.databricksYmlChanged) validateBundle(cwd, profile);\n }\n warnScopeNeeding(allRequirements);\n }\n}\n\n/**\n * v1 does not write `user_api_scopes` (deferred to the manifest scope\n * extension). Warn when an added plugin's resource type is known to need one,\n * so the user adds it before deploy.\n */\n/** Returns the user_api_scopes implied by a set of resource rows (deduped). */\nexport function scopesForResources(\n rows: ResourceRequirementRow[],\n): Map<string, string> {\n const needed = new Map<string, string>();\n for (const row of rows) {\n if (Object.hasOwn(SCOPE_BY_TYPE, row.type)) {\n needed.set(\n row.type,\n SCOPE_BY_TYPE[row.type as keyof typeof SCOPE_BY_TYPE],\n );\n }\n }\n return needed;\n}\n\nfunction warnScopeNeeding(rows: ResourceRequirementRow[]): void {\n const needed = scopesForResources(rows);\n if (needed.size === 0) return;\n const list = [...needed.entries()]\n .map(([type, scope]) => `${type} → ${scope}`)\n .join(\", \");\n console.warn(\n pc.yellow(\n `\\n Note: these resources may need a user_api_scope before deploy: ${list}.\\n` +\n \" Add it under resources.apps.app.user_api_scopes in databricks.yml.\",\n ),\n );\n}\n\n/** Commander reducer for repeatable `--env KEY=VALUE` flags. */\nfunction collectEnvFlag(\n raw: string,\n acc: Record<string, string>,\n): Record<string, string> {\n const eq = raw.indexOf(\"=\");\n if (eq === -1) {\n console.error(`Ignoring --env \"${raw}\" (expected KEY=VALUE).`);\n return acc;\n }\n const key = raw.slice(0, eq).trim();\n const value = raw.slice(eq + 1);\n if (key) acc[key] = value;\n return acc;\n}\n\nexport const addCommand = new Command(\"add\")\n .description(\"Add a UI component or server plugin from the AppKit registry\")\n .argument(\"<item...>\", \"Registry item name(s), e.g. metric-card or hello\")\n .option(\"-f, --force\", \"Overwrite existing files\")\n .option(\"-C, --cwd <dir>\", \"Run as if started in <dir>\")\n .option(\"--no-register\", \"Don't edit the server entry to register plugins\")\n .option(\"--no-resources\", \"Don't reconcile resource env vars into .env\")\n .option(\"-y, --yes\", \"Don't prompt; use --env values or leave vars unset\")\n .option(\n \"--env <KEY=VALUE>\",\n \"Pre-set a resource env var (repeatable)\",\n collectEnvFlag,\n {},\n )\n .option(\n \"-p, --profile <name>\",\n \"Databricks profile for the resource picker and bundle validate (defaults to the app's DATABRICKS_CONFIG_PROFILE)\",\n )\n .option(\n \"--allow-unverified\",\n \"Add items the registry doesn't mark verified (runs untrusted code)\",\n )\n .addHelpText(\n \"after\",\n `\nNo components.json is required. Item type is detected automatically:\n • UI components → <frontend>/src/components/appkit/ (client/ detected)\n • Server plugins → <server>/plugins/<name>/, runs plugin sync, and registers\n them in your createApp call (use --no-register to skip the server edit)\n\nServer plugins declare Databricks resources. On add, their env vars are\nreconciled into .env (and names into .env.example), and the deploy config\n(app.yaml + databricks.yml resource bindings) is patched to match — existing\nentries are never clobbered. Interactive by default; pass --yes for agents/CI\n(uses --env values, leaves the rest unset) and --env KEY=VALUE to supply\nvalues non-interactively. Pass --profile to validate the bundle after writing.\n\nThe frontend/server roots are detected from common layouts, so you can run\nthis from the repo root.\n\nExamples:\n $ appkit add metric-card # UI component\n $ appkit add hello # server plugin\n $ appkit add metric-card hello # mix in one call\n $ appkit add analytics --yes --env DATABRICKS_WAREHOUSE_ID=abc123`,\n )\n .action((items: string[], opts: AddOptions) =>\n runAdd(items, opts).catch((err) => {\n console.error(err);\n process.exit(1);\n }),\n );\n"],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { REGISTRY_INDEX_API_URL, REGISTRY_INDEX_URL, REGISTRY_ITEM_API_TEMPLATE, REGISTRY_ITEM_URL_TEMPLATE, REGISTRY_NAMESPACE, REGISTRY_REPO } from "./constants.js";
1
+ import { REGISTRY_INDEX_URL, REGISTRY_ITEM_URL_TEMPLATE, REGISTRY_NAMESPACE, REGISTRY_REPO } from "./constants.js";
2
2
  import process from "node:process";
3
3
 
4
4
  //#region src/cli/commands/registry/client.ts
@@ -23,29 +23,14 @@ function isValidItemName(name) {
23
23
  return name !== "." && name !== ".." && ITEM_NAME.test(name);
24
24
  }
25
25
  /**
26
- * Auth headers for a registry request. With a token the GitHub Contents API is
27
- * used and `Accept: raw` makes it return file bytes directly; without one the
28
- * public raw URL needs no headers. Single source for the auth contract shared
29
- * by every registry fetch.
26
+ * Fetches and parses a single registry item from the public raw URL. Exits the
27
+ * process with a helpful message on failure.
30
28
  */
31
- function registryAuthHeaders(token) {
32
- if (!token) return {};
33
- return {
34
- Authorization: `Bearer ${token.value}`,
35
- Accept: "application/vnd.github.raw"
36
- };
37
- }
38
- /**
39
- * Fetches and parses a single registry item. When a token is present the GitHub
40
- * Contents API is used (works for the private/internal repo); otherwise the
41
- * public raw URL is used. Exits the process with a helpful message on failure.
42
- */
43
- async function fetchRegistryItem(name, token) {
44
- const url = (token ? REGISTRY_ITEM_API_TEMPLATE : REGISTRY_ITEM_URL_TEMPLATE).replace("{name}", name);
45
- const headers = registryAuthHeaders(token);
29
+ async function fetchRegistryItem(name) {
30
+ const url = REGISTRY_ITEM_URL_TEMPLATE.replace("{name}", name);
46
31
  let res;
47
32
  try {
48
- res = await fetch(url, { headers });
33
+ res = await fetch(url);
49
34
  } catch (err) {
50
35
  console.error(`Failed to fetch "${name}" from ${url}`);
51
36
  console.error(` ${err instanceof Error ? err.message : String(err)}`);
@@ -53,12 +38,6 @@ async function fetchRegistryItem(name, token) {
53
38
  }
54
39
  if (res.status === 404) {
55
40
  console.error(`"${name}" not found in ${REGISTRY_REPO}.`);
56
- if (!token) console.error(" If the registry repo is private, set APPKIT_REGISTRY_TOKEN (or GITHUB_TOKEN) to a token with read access.");
57
- process.exit(1);
58
- }
59
- if (res.status === 401 || res.status === 403) {
60
- console.error(`Access denied (HTTP ${res.status}) fetching "${name}" from ${REGISTRY_REPO}.`);
61
- console.error(" Check that your token has read access to the repository.");
62
41
  process.exit(1);
63
42
  }
64
43
  if (!res.ok) {
@@ -75,10 +54,9 @@ async function fetchRegistryItem(name, token) {
75
54
  * index can't be read, so the caller can tell "nothing verified" apart from
76
55
  * "couldn't check".
77
56
  */
78
- async function fetchVerifiedNames(token) {
79
- const url = token ? REGISTRY_INDEX_API_URL : REGISTRY_INDEX_URL;
57
+ async function fetchVerifiedNames() {
80
58
  try {
81
- const res = await fetch(url, { headers: registryAuthHeaders(token) });
59
+ const res = await fetch(REGISTRY_INDEX_URL);
82
60
  if (!res.ok) return null;
83
61
  const data = await res.json();
84
62
  const verified = /* @__PURE__ */ new Set();
@@ -90,5 +68,5 @@ async function fetchVerifiedNames(token) {
90
68
  }
91
69
 
92
70
  //#endregion
93
- export { fetchRegistryItem, fetchVerifiedNames, isValidItemName, registryAuthHeaders, stripNamespace };
71
+ export { fetchRegistryItem, fetchVerifiedNames, isValidItemName, stripNamespace };
94
72
  //# sourceMappingURL=client.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","names":[],"sources":["../../../../src/cli/commands/registry/client.ts"],"sourcesContent":["import process from \"node:process\";\n\nimport {\n REGISTRY_INDEX_API_URL,\n REGISTRY_INDEX_URL,\n REGISTRY_ITEM_API_TEMPLATE,\n REGISTRY_ITEM_URL_TEMPLATE,\n REGISTRY_NAMESPACE,\n REGISTRY_REPO,\n type RegistryToken,\n} from \"./constants\";\n\nexport interface RegistryItemFile {\n path: string;\n content: string;\n type: string;\n /** Destination path relative to the project root. */\n target?: string;\n}\n\nexport interface RegistryItem {\n name: string;\n type?: string;\n dependencies?: string[];\n registryDependencies?: string[];\n files?: RegistryItemFile[];\n}\n\n/** Removes a leading `@databricks-appkit/` namespace from a component reference. */\nexport function stripNamespace(component: string): string {\n const prefix = `${REGISTRY_NAMESPACE}/`;\n return component.startsWith(prefix)\n ? component.slice(prefix.length)\n : component;\n}\n\n/**\n * A registry item name is a slug: letters, digits, dot, underscore, hyphen —\n * never a path separator or `.`/`..`. Names come from user refs and from an\n * item's untrusted `registryDependencies`, and are used both as the fetch path\n * (`public/r/<name>.json`) and as the on-disk `plugins/<name>` dir. Rejecting\n * separators and dot-segments at the source stops a crafted ref like\n * `../../attacker/repo/payload` from redirecting the fetch to another path in\n * the registry repo or escaping the destination dir, and keeps control chars\n * out of any printed name.\n */\nconst ITEM_NAME = /^[A-Za-z0-9._-]+$/;\n\n/** True when `name` is a safe registry item slug (post-namespace-strip). */\nexport function isValidItemName(name: string): boolean {\n return name !== \".\" && name !== \"..\" && ITEM_NAME.test(name);\n}\n\n/**\n * Auth headers for a registry request. With a token the GitHub Contents API is\n * used and `Accept: raw` makes it return file bytes directly; without one the\n * public raw URL needs no headers. Single source for the auth contract shared\n * by every registry fetch.\n */\nexport function registryAuthHeaders(\n token: RegistryToken | null,\n): Record<string, string> {\n if (!token) return {};\n return {\n Authorization: `Bearer ${token.value}`,\n Accept: \"application/vnd.github.raw\",\n };\n}\n\n/**\n * Fetches and parses a single registry item. When a token is present the GitHub\n * Contents API is used (works for the private/internal repo); otherwise the\n * public raw URL is used. Exits the process with a helpful message on failure.\n */\nexport async function fetchRegistryItem(\n name: string,\n token: RegistryToken | null,\n): Promise<RegistryItem> {\n const template = token\n ? REGISTRY_ITEM_API_TEMPLATE\n : REGISTRY_ITEM_URL_TEMPLATE;\n const url = template.replace(\"{name}\", name);\n const headers = registryAuthHeaders(token);\n\n let res: Awaited<ReturnType<typeof fetch>>;\n try {\n res = await fetch(url, { headers });\n } catch (err) {\n console.error(`Failed to fetch \"${name}\" from ${url}`);\n console.error(` ${err instanceof Error ? err.message : String(err)}`);\n process.exit(1);\n }\n\n if (res.status === 404) {\n console.error(`\"${name}\" not found in ${REGISTRY_REPO}.`);\n if (!token) {\n console.error(\n \" If the registry repo is private, set APPKIT_REGISTRY_TOKEN (or GITHUB_TOKEN) to a token with read access.\",\n );\n }\n process.exit(1);\n }\n if (res.status === 401 || res.status === 403) {\n console.error(\n `Access denied (HTTP ${res.status}) fetching \"${name}\" from ${REGISTRY_REPO}.`,\n );\n console.error(\" Check that your token has read access to the repository.\");\n process.exit(1);\n }\n if (!res.ok) {\n console.error(`Registry returned HTTP ${res.status} for \"${name}\".`);\n process.exit(1);\n }\n\n return (await res.json()) as RegistryItem;\n}\n\n/** One entry in the registry index (`registry.json`). */\nexport interface RegistryIndexEntry {\n name: string;\n meta?: { verified?: boolean };\n}\n\n/**\n * Fetches the registry index (`registry.json`) and returns the set of item\n * names marked `meta.verified`. The `verified` flag lives only in the index —\n * the per-item JSON at `public/r/<name>.json` does not carry it — so the `add`\n * integrity gate must consult this. Returns null (not an empty set) if the\n * index can't be read, so the caller can tell \"nothing verified\" apart from\n * \"couldn't check\".\n */\nexport async function fetchVerifiedNames(\n token: RegistryToken | null,\n): Promise<Set<string> | null> {\n const url = token ? REGISTRY_INDEX_API_URL : REGISTRY_INDEX_URL;\n try {\n const res = await fetch(url, { headers: registryAuthHeaders(token) });\n if (!res.ok) return null;\n const data = (await res.json()) as { items?: RegistryIndexEntry[] };\n const verified = new Set<string>();\n for (const item of data.items ?? []) {\n if (item.meta?.verified === true) verified.add(item.name);\n }\n return verified;\n } catch {\n return null;\n }\n}\n"],"mappings":";;;;;AA6BA,SAAgB,eAAe,WAA2B;CACxD,MAAM,SAAS,GAAG,mBAAmB;AACrC,QAAO,UAAU,WAAW,OAAO,GAC/B,UAAU,MAAM,OAAO,OAAO,GAC9B;;;;;;;;;;;;AAaN,MAAM,YAAY;;AAGlB,SAAgB,gBAAgB,MAAuB;AACrD,QAAO,SAAS,OAAO,SAAS,QAAQ,UAAU,KAAK,KAAK;;;;;;;;AAS9D,SAAgB,oBACd,OACwB;AACxB,KAAI,CAAC,MAAO,QAAO,EAAE;AACrB,QAAO;EACL,eAAe,UAAU,MAAM;EAC/B,QAAQ;EACT;;;;;;;AAQH,eAAsB,kBACpB,MACA,OACuB;CAIvB,MAAM,OAHW,QACb,6BACA,4BACiB,QAAQ,UAAU,KAAK;CAC5C,MAAM,UAAU,oBAAoB,MAAM;CAE1C,IAAI;AACJ,KAAI;AACF,QAAM,MAAM,MAAM,KAAK,EAAE,SAAS,CAAC;UAC5B,KAAK;AACZ,UAAQ,MAAM,oBAAoB,KAAK,SAAS,MAAM;AACtD,UAAQ,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAAG;AACtE,UAAQ,KAAK,EAAE;;AAGjB,KAAI,IAAI,WAAW,KAAK;AACtB,UAAQ,MAAM,IAAI,KAAK,iBAAiB,cAAc,GAAG;AACzD,MAAI,CAAC,MACH,SAAQ,MACN,8GACD;AAEH,UAAQ,KAAK,EAAE;;AAEjB,KAAI,IAAI,WAAW,OAAO,IAAI,WAAW,KAAK;AAC5C,UAAQ,MACN,uBAAuB,IAAI,OAAO,cAAc,KAAK,SAAS,cAAc,GAC7E;AACD,UAAQ,MAAM,6DAA6D;AAC3E,UAAQ,KAAK,EAAE;;AAEjB,KAAI,CAAC,IAAI,IAAI;AACX,UAAQ,MAAM,0BAA0B,IAAI,OAAO,QAAQ,KAAK,IAAI;AACpE,UAAQ,KAAK,EAAE;;AAGjB,QAAQ,MAAM,IAAI,MAAM;;;;;;;;;;AAiB1B,eAAsB,mBACpB,OAC6B;CAC7B,MAAM,MAAM,QAAQ,yBAAyB;AAC7C,KAAI;EACF,MAAM,MAAM,MAAM,MAAM,KAAK,EAAE,SAAS,oBAAoB,MAAM,EAAE,CAAC;AACrE,MAAI,CAAC,IAAI,GAAI,QAAO;EACpB,MAAM,OAAQ,MAAM,IAAI,MAAM;EAC9B,MAAM,2BAAW,IAAI,KAAa;AAClC,OAAK,MAAM,QAAQ,KAAK,SAAS,EAAE,CACjC,KAAI,KAAK,MAAM,aAAa,KAAM,UAAS,IAAI,KAAK,KAAK;AAE3D,SAAO;SACD;AACN,SAAO"}
1
+ {"version":3,"file":"client.js","names":[],"sources":["../../../../src/cli/commands/registry/client.ts"],"sourcesContent":["import process from \"node:process\";\n\nimport {\n REGISTRY_INDEX_URL,\n REGISTRY_ITEM_URL_TEMPLATE,\n REGISTRY_NAMESPACE,\n REGISTRY_REPO,\n} from \"./constants\";\n\nexport interface RegistryItemFile {\n path: string;\n content: string;\n type: string;\n /** Destination path relative to the project root. */\n target?: string;\n}\n\nexport interface RegistryItem {\n name: string;\n type?: string;\n dependencies?: string[];\n registryDependencies?: string[];\n files?: RegistryItemFile[];\n}\n\n/** Removes a leading `@databricks-appkit/` namespace from a component reference. */\nexport function stripNamespace(component: string): string {\n const prefix = `${REGISTRY_NAMESPACE}/`;\n return component.startsWith(prefix)\n ? component.slice(prefix.length)\n : component;\n}\n\n/**\n * A registry item name is a slug: letters, digits, dot, underscore, hyphen —\n * never a path separator or `.`/`..`. Names come from user refs and from an\n * item's untrusted `registryDependencies`, and are used both as the fetch path\n * (`public/r/<name>.json`) and as the on-disk `plugins/<name>` dir. Rejecting\n * separators and dot-segments at the source stops a crafted ref like\n * `../../attacker/repo/payload` from redirecting the fetch to another path in\n * the registry repo or escaping the destination dir, and keeps control chars\n * out of any printed name.\n */\nconst ITEM_NAME = /^[A-Za-z0-9._-]+$/;\n\n/** True when `name` is a safe registry item slug (post-namespace-strip). */\nexport function isValidItemName(name: string): boolean {\n return name !== \".\" && name !== \"..\" && ITEM_NAME.test(name);\n}\n\n/**\n * Fetches and parses a single registry item from the public raw URL. Exits the\n * process with a helpful message on failure.\n */\nexport async function fetchRegistryItem(name: string): Promise<RegistryItem> {\n const url = REGISTRY_ITEM_URL_TEMPLATE.replace(\"{name}\", name);\n\n let res: Awaited<ReturnType<typeof fetch>>;\n try {\n res = await fetch(url);\n } catch (err) {\n console.error(`Failed to fetch \"${name}\" from ${url}`);\n console.error(` ${err instanceof Error ? err.message : String(err)}`);\n process.exit(1);\n }\n\n if (res.status === 404) {\n console.error(`\"${name}\" not found in ${REGISTRY_REPO}.`);\n process.exit(1);\n }\n if (!res.ok) {\n console.error(`Registry returned HTTP ${res.status} for \"${name}\".`);\n process.exit(1);\n }\n\n return (await res.json()) as RegistryItem;\n}\n\n/** One entry in the registry index (`registry.json`). */\nexport interface RegistryIndexEntry {\n name: string;\n meta?: { verified?: boolean };\n}\n\n/**\n * Fetches the registry index (`registry.json`) and returns the set of item\n * names marked `meta.verified`. The `verified` flag lives only in the index —\n * the per-item JSON at `public/r/<name>.json` does not carry it — so the `add`\n * integrity gate must consult this. Returns null (not an empty set) if the\n * index can't be read, so the caller can tell \"nothing verified\" apart from\n * \"couldn't check\".\n */\nexport async function fetchVerifiedNames(): Promise<Set<string> | null> {\n try {\n const res = await fetch(REGISTRY_INDEX_URL);\n if (!res.ok) return null;\n const data = (await res.json()) as { items?: RegistryIndexEntry[] };\n const verified = new Set<string>();\n for (const item of data.items ?? []) {\n if (item.meta?.verified === true) verified.add(item.name);\n }\n return verified;\n } catch {\n return null;\n }\n}\n"],"mappings":";;;;;AA0BA,SAAgB,eAAe,WAA2B;CACxD,MAAM,SAAS,GAAG,mBAAmB;AACrC,QAAO,UAAU,WAAW,OAAO,GAC/B,UAAU,MAAM,OAAO,OAAO,GAC9B;;;;;;;;;;;;AAaN,MAAM,YAAY;;AAGlB,SAAgB,gBAAgB,MAAuB;AACrD,QAAO,SAAS,OAAO,SAAS,QAAQ,UAAU,KAAK,KAAK;;;;;;AAO9D,eAAsB,kBAAkB,MAAqC;CAC3E,MAAM,MAAM,2BAA2B,QAAQ,UAAU,KAAK;CAE9D,IAAI;AACJ,KAAI;AACF,QAAM,MAAM,MAAM,IAAI;UACf,KAAK;AACZ,UAAQ,MAAM,oBAAoB,KAAK,SAAS,MAAM;AACtD,UAAQ,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAAG;AACtE,UAAQ,KAAK,EAAE;;AAGjB,KAAI,IAAI,WAAW,KAAK;AACtB,UAAQ,MAAM,IAAI,KAAK,iBAAiB,cAAc,GAAG;AACzD,UAAQ,KAAK,EAAE;;AAEjB,KAAI,CAAC,IAAI,IAAI;AACX,UAAQ,MAAM,0BAA0B,IAAI,OAAO,QAAQ,KAAK,IAAI;AACpE,UAAQ,KAAK,EAAE;;AAGjB,QAAQ,MAAM,IAAI,MAAM;;;;;;;;;;AAiB1B,eAAsB,qBAAkD;AACtE,KAAI;EACF,MAAM,MAAM,MAAM,MAAM,mBAAmB;AAC3C,MAAI,CAAC,IAAI,GAAI,QAAO;EACpB,MAAM,OAAQ,MAAM,IAAI,MAAM;EAC9B,MAAM,2BAAW,IAAI,KAAa;AAClC,OAAK,MAAM,QAAQ,KAAK,SAAS,EAAE,CACjC,KAAI,KAAK,MAAM,aAAa,KAAM,UAAS,IAAI,KAAK,KAAK;AAE3D,SAAO;SACD;AACN,SAAO"}
@@ -1,5 +1,3 @@
1
- import { spawnSync } from "node:child_process";
2
-
3
1
  //#region src/cli/commands/registry/constants.ts
4
2
  /** shadcn registry namespace consumers reference, e.g. `@databricks-appkit/metric-card`. */
5
3
  const REGISTRY_NAMESPACE = "@databricks-appkit";
@@ -13,50 +11,13 @@ const JS_IDENTIFIER = /^[A-Za-z_$][\w$]*$/;
13
11
  const REGISTRY_REPO = "databricks/appkit-registry";
14
12
  const REGISTRY_REF = "main";
15
13
  /**
16
- * Public hosting: once the repo is public, items are fetchable directly from
14
+ * The registry is a public repo, so items are fetched directly from
17
15
  * raw.githubusercontent.com with no auth.
18
16
  */
19
17
  const PUBLIC_RAW_BASE = `https://raw.githubusercontent.com/${REGISTRY_REPO}/${REGISTRY_REF}`;
20
18
  const REGISTRY_ITEM_URL_TEMPLATE = `${PUBLIC_RAW_BASE}/public/r/{name}.json`;
21
19
  const REGISTRY_INDEX_URL = `${PUBLIC_RAW_BASE}/registry.json`;
22
- /**
23
- * Private/internal hosting: while the repo is internal, files are fetched via
24
- * the GitHub Contents API with a token. `Accept: application/vnd.github.raw`
25
- * makes the API return the file bytes directly (the registry-item JSON).
26
- */
27
- const GH_CONTENTS_API = `https://api.github.com/repos/${REGISTRY_REPO}/contents`;
28
- const REGISTRY_ITEM_API_TEMPLATE = `${GH_CONTENTS_API}/public/r/{name}.json?ref=${REGISTRY_REF}`;
29
- const REGISTRY_INDEX_API_URL = `${GH_CONTENTS_API}/registry.json?ref=${REGISTRY_REF}`;
30
- /** Env vars checked (in order) for a token granting read access to the repo. */
31
- const TOKEN_ENV_VARS = [
32
- "APPKIT_REGISTRY_TOKEN",
33
- "GITHUB_TOKEN",
34
- "GH_TOKEN"
35
- ];
36
- /**
37
- * Resolves a token granting read access to the registry repo: first the env
38
- * vars in {@link TOKEN_ENV_VARS}, then the GitHub CLI (`gh auth token`) if the
39
- * user is logged in. Returns null if none are available.
40
- */
41
- function resolveToken(env = process.env) {
42
- for (const envName of TOKEN_ENV_VARS) {
43
- const value = env[envName];
44
- if (value) return {
45
- envName,
46
- value
47
- };
48
- }
49
- try {
50
- const res = spawnSync("gh", ["auth", "token"], { encoding: "utf-8" });
51
- const value = res.status === 0 ? res.stdout.trim() : "";
52
- if (value) return {
53
- envName: "gh auth token",
54
- value
55
- };
56
- } catch {}
57
- return null;
58
- }
59
20
 
60
21
  //#endregion
61
- export { JS_IDENTIFIER, REGISTRY_INDEX_API_URL, REGISTRY_INDEX_URL, REGISTRY_ITEM_API_TEMPLATE, REGISTRY_ITEM_URL_TEMPLATE, REGISTRY_NAMESPACE, REGISTRY_REPO, resolveToken };
22
+ export { JS_IDENTIFIER, REGISTRY_INDEX_URL, REGISTRY_ITEM_URL_TEMPLATE, REGISTRY_NAMESPACE, REGISTRY_REPO };
62
23
  //# sourceMappingURL=constants.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"constants.js","names":[],"sources":["../../../../src/cli/commands/registry/constants.ts"],"sourcesContent":["import { spawnSync } from \"node:child_process\";\n\n/** shadcn registry namespace consumers reference, e.g. `@databricks-appkit/metric-card`. */\nexport const REGISTRY_NAMESPACE = \"@databricks-appkit\";\n\n/**\n * A plain JS identifier. A plugin's export name is interpolated into the user's\n * server source, so it's validated against this before use — a registry item is\n * untrusted, and anything else could inject code.\n */\nexport const JS_IDENTIFIER = /^[A-Za-z_$][\\w$]*$/;\n\n/** GitHub repo hosting the registry, and the branch the built items live on. */\nexport const REGISTRY_REPO = \"databricks/appkit-registry\";\nexport const REGISTRY_REF = \"main\";\n\n/**\n * Public hosting: once the repo is public, items are fetchable directly from\n * raw.githubusercontent.com with no auth.\n */\nconst PUBLIC_RAW_BASE = `https://raw.githubusercontent.com/${REGISTRY_REPO}/${REGISTRY_REF}`;\nexport const REGISTRY_ITEM_URL_TEMPLATE = `${PUBLIC_RAW_BASE}/public/r/{name}.json`;\nexport const REGISTRY_INDEX_URL = `${PUBLIC_RAW_BASE}/registry.json`;\n\n/**\n * Private/internal hosting: while the repo is internal, files are fetched via\n * the GitHub Contents API with a token. `Accept: application/vnd.github.raw`\n * makes the API return the file bytes directly (the registry-item JSON).\n */\nconst GH_CONTENTS_API = `https://api.github.com/repos/${REGISTRY_REPO}/contents`;\nexport const REGISTRY_ITEM_API_TEMPLATE = `${GH_CONTENTS_API}/public/r/{name}.json?ref=${REGISTRY_REF}`;\nexport const REGISTRY_INDEX_API_URL = `${GH_CONTENTS_API}/registry.json?ref=${REGISTRY_REF}`;\n\n/** Env vars checked (in order) for a token granting read access to the repo. */\nexport const TOKEN_ENV_VARS = [\n \"APPKIT_REGISTRY_TOKEN\",\n \"GITHUB_TOKEN\",\n \"GH_TOKEN\",\n];\n\nexport interface RegistryToken {\n envName: string;\n value: string;\n}\n\n/**\n * Resolves a token granting read access to the registry repo: first the env\n * vars in {@link TOKEN_ENV_VARS}, then the GitHub CLI (`gh auth token`) if the\n * user is logged in. Returns null if none are available.\n */\nexport function resolveToken(\n env: NodeJS.ProcessEnv = process.env,\n): RegistryToken | null {\n for (const envName of TOKEN_ENV_VARS) {\n const value = env[envName];\n if (value) return { envName, value };\n }\n try {\n const res = spawnSync(\"gh\", [\"auth\", \"token\"], { encoding: \"utf-8\" });\n const value = res.status === 0 ? res.stdout.trim() : \"\";\n if (value) return { envName: \"gh auth token\", value };\n } catch {\n // gh not installed or not on PATH — fall through.\n }\n return null;\n}\n"],"mappings":";;;;AAGA,MAAa,qBAAqB;;;;;;AAOlC,MAAa,gBAAgB;;AAG7B,MAAa,gBAAgB;AAC7B,MAAa,eAAe;;;;;AAM5B,MAAM,kBAAkB,qCAAqC,cAAc,GAAG;AAC9E,MAAa,6BAA6B,GAAG,gBAAgB;AAC7D,MAAa,qBAAqB,GAAG,gBAAgB;;;;;;AAOrD,MAAM,kBAAkB,gCAAgC,cAAc;AACtE,MAAa,6BAA6B,GAAG,gBAAgB,4BAA4B;AACzF,MAAa,yBAAyB,GAAG,gBAAgB,qBAAqB;;AAG9E,MAAa,iBAAiB;CAC5B;CACA;CACA;CACD;;;;;;AAYD,SAAgB,aACd,MAAyB,QAAQ,KACX;AACtB,MAAK,MAAM,WAAW,gBAAgB;EACpC,MAAM,QAAQ,IAAI;AAClB,MAAI,MAAO,QAAO;GAAE;GAAS;GAAO;;AAEtC,KAAI;EACF,MAAM,MAAM,UAAU,MAAM,CAAC,QAAQ,QAAQ,EAAE,EAAE,UAAU,SAAS,CAAC;EACrE,MAAM,QAAQ,IAAI,WAAW,IAAI,IAAI,OAAO,MAAM,GAAG;AACrD,MAAI,MAAO,QAAO;GAAE,SAAS;GAAiB;GAAO;SAC/C;AAGR,QAAO"}
1
+ {"version":3,"file":"constants.js","names":[],"sources":["../../../../src/cli/commands/registry/constants.ts"],"sourcesContent":["/** shadcn registry namespace consumers reference, e.g. `@databricks-appkit/metric-card`. */\nexport const REGISTRY_NAMESPACE = \"@databricks-appkit\";\n\n/**\n * A plain JS identifier. A plugin's export name is interpolated into the user's\n * server source, so it's validated against this before use — a registry item is\n * untrusted, and anything else could inject code.\n */\nexport const JS_IDENTIFIER = /^[A-Za-z_$][\\w$]*$/;\n\n/** GitHub repo hosting the registry, and the branch the built items live on. */\nexport const REGISTRY_REPO = \"databricks/appkit-registry\";\nexport const REGISTRY_REF = \"main\";\n\n/**\n * The registry is a public repo, so items are fetched directly from\n * raw.githubusercontent.com with no auth.\n */\nconst PUBLIC_RAW_BASE = `https://raw.githubusercontent.com/${REGISTRY_REPO}/${REGISTRY_REF}`;\nexport const REGISTRY_ITEM_URL_TEMPLATE = `${PUBLIC_RAW_BASE}/public/r/{name}.json`;\nexport const REGISTRY_INDEX_URL = `${PUBLIC_RAW_BASE}/registry.json`;\n"],"mappings":";;AACA,MAAa,qBAAqB;;;;;;AAOlC,MAAa,gBAAgB;;AAG7B,MAAa,gBAAgB;AAC7B,MAAa,eAAe;;;;;AAM5B,MAAM,kBAAkB,qCAAqC,cAAc,GAAG;AAC9E,MAAa,6BAA6B,GAAG,gBAAgB;AAC7D,MAAa,qBAAqB,GAAG,gBAAgB"}
@@ -1,4 +1,3 @@
1
- import { resolveToken } from "./constants.js";
2
1
  import { fetchRegistryItem, isValidItemName, stripNamespace } from "./client.js";
3
2
  import { extractRequirements, renderRequirements } from "./requirements.js";
4
3
  import { Command } from "commander";
@@ -7,13 +6,12 @@ import pc from "picocolors";
7
6
 
8
7
  //#region src/cli/commands/registry/info.ts
9
8
  async function runInfo(ref, opts) {
10
- const token = resolveToken();
11
9
  const name = stripNamespace(ref);
12
10
  if (!isValidItemName(name)) {
13
11
  console.error(`Invalid registry item name: ${JSON.stringify(ref)}`);
14
12
  process.exit(1);
15
13
  }
16
- const item = await fetchRegistryItem(name, token);
14
+ const item = await fetchRegistryItem(name);
17
15
  const rows = extractRequirements(item);
18
16
  if (opts.json) {
19
17
  console.log(JSON.stringify({
@@ -1 +1 @@
1
- {"version":3,"file":"info.js","names":[],"sources":["../../../../src/cli/commands/registry/info.ts"],"sourcesContent":["import process from \"node:process\";\n\nimport { Command } from \"commander\";\nimport pc from \"picocolors\";\n\nimport { fetchRegistryItem, isValidItemName, stripNamespace } from \"./client\";\nimport { resolveToken } from \"./constants\";\nimport { extractRequirements, renderRequirements } from \"./requirements\";\n\nasync function runInfo(ref: string, opts: { json?: boolean }): Promise<void> {\n const token = resolveToken();\n // Validate before fetching: the name is interpolated into the fetch path, so\n // reject non-slug refs (matches the `add` guard) rather than let `/` or `..`\n // redirect the request to another path in the repo.\n const name = stripNamespace(ref);\n if (!isValidItemName(name)) {\n console.error(`Invalid registry item name: ${JSON.stringify(ref)}`);\n process.exit(1);\n }\n const item = await fetchRegistryItem(name, token);\n const rows = extractRequirements(item);\n\n if (opts.json) {\n console.log(\n JSON.stringify(\n {\n name: item.name,\n type: item.type,\n dependencies: item.dependencies ?? [],\n registryDependencies: item.registryDependencies ?? [],\n resources: rows,\n },\n null,\n 2,\n ),\n );\n return;\n }\n\n console.log(pc.bold(item.name));\n const deps = item.dependencies ?? [];\n const registryDeps = item.registryDependencies ?? [];\n if (deps.length > 0) {\n console.log(pc.dim(` npm dependencies: ${deps.join(\", \")}`));\n }\n if (registryDeps.length > 0) {\n console.log(pc.dim(` registry dependencies: ${registryDeps.join(\", \")}`));\n }\n console.log(`\\n${renderRequirements(item, rows)}`);\n}\n\nexport const registryInfoCommand = new Command(\"info\")\n .description(\"Show an item's resource requirements and dependencies\")\n .argument(\"<item>\", \"Registry item name, e.g. analytics\")\n .option(\"--json\", \"Output as JSON\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ appkit registry info analytics\n $ appkit registry info @databricks-appkit/analytics --json`,\n )\n .action((ref: string, opts: { json?: boolean }) =>\n runInfo(ref, opts).catch((err) => {\n console.error(err);\n process.exit(1);\n }),\n );\n"],"mappings":";;;;;;;;AASA,eAAe,QAAQ,KAAa,MAAyC;CAC3E,MAAM,QAAQ,cAAc;CAI5B,MAAM,OAAO,eAAe,IAAI;AAChC,KAAI,CAAC,gBAAgB,KAAK,EAAE;AAC1B,UAAQ,MAAM,+BAA+B,KAAK,UAAU,IAAI,GAAG;AACnE,UAAQ,KAAK,EAAE;;CAEjB,MAAM,OAAO,MAAM,kBAAkB,MAAM,MAAM;CACjD,MAAM,OAAO,oBAAoB,KAAK;AAEtC,KAAI,KAAK,MAAM;AACb,UAAQ,IACN,KAAK,UACH;GACE,MAAM,KAAK;GACX,MAAM,KAAK;GACX,cAAc,KAAK,gBAAgB,EAAE;GACrC,sBAAsB,KAAK,wBAAwB,EAAE;GACrD,WAAW;GACZ,EACD,MACA,EACD,CACF;AACD;;AAGF,SAAQ,IAAI,GAAG,KAAK,KAAK,KAAK,CAAC;CAC/B,MAAM,OAAO,KAAK,gBAAgB,EAAE;CACpC,MAAM,eAAe,KAAK,wBAAwB,EAAE;AACpD,KAAI,KAAK,SAAS,EAChB,SAAQ,IAAI,GAAG,IAAI,uBAAuB,KAAK,KAAK,KAAK,GAAG,CAAC;AAE/D,KAAI,aAAa,SAAS,EACxB,SAAQ,IAAI,GAAG,IAAI,4BAA4B,aAAa,KAAK,KAAK,GAAG,CAAC;AAE5E,SAAQ,IAAI,KAAK,mBAAmB,MAAM,KAAK,GAAG;;AAGpD,MAAa,sBAAsB,IAAI,QAAQ,OAAO,CACnD,YAAY,wDAAwD,CACpE,SAAS,UAAU,qCAAqC,CACxD,OAAO,UAAU,iBAAiB,CAClC,YACC,SACA;;;8DAID,CACA,QAAQ,KAAa,SACpB,QAAQ,KAAK,KAAK,CAAC,OAAO,QAAQ;AAChC,SAAQ,MAAM,IAAI;AAClB,SAAQ,KAAK,EAAE;EACf,CACH"}
1
+ {"version":3,"file":"info.js","names":[],"sources":["../../../../src/cli/commands/registry/info.ts"],"sourcesContent":["import process from \"node:process\";\n\nimport { Command } from \"commander\";\nimport pc from \"picocolors\";\n\nimport { fetchRegistryItem, isValidItemName, stripNamespace } from \"./client\";\nimport { extractRequirements, renderRequirements } from \"./requirements\";\n\nasync function runInfo(ref: string, opts: { json?: boolean }): Promise<void> {\n // Validate before fetching: the name is interpolated into the fetch path, so\n // reject non-slug refs (matches the `add` guard) rather than let `/` or `..`\n // redirect the request to another path in the repo.\n const name = stripNamespace(ref);\n if (!isValidItemName(name)) {\n console.error(`Invalid registry item name: ${JSON.stringify(ref)}`);\n process.exit(1);\n }\n const item = await fetchRegistryItem(name);\n const rows = extractRequirements(item);\n\n if (opts.json) {\n console.log(\n JSON.stringify(\n {\n name: item.name,\n type: item.type,\n dependencies: item.dependencies ?? [],\n registryDependencies: item.registryDependencies ?? [],\n resources: rows,\n },\n null,\n 2,\n ),\n );\n return;\n }\n\n console.log(pc.bold(item.name));\n const deps = item.dependencies ?? [];\n const registryDeps = item.registryDependencies ?? [];\n if (deps.length > 0) {\n console.log(pc.dim(` npm dependencies: ${deps.join(\", \")}`));\n }\n if (registryDeps.length > 0) {\n console.log(pc.dim(` registry dependencies: ${registryDeps.join(\", \")}`));\n }\n console.log(`\\n${renderRequirements(item, rows)}`);\n}\n\nexport const registryInfoCommand = new Command(\"info\")\n .description(\"Show an item's resource requirements and dependencies\")\n .argument(\"<item>\", \"Registry item name, e.g. analytics\")\n .option(\"--json\", \"Output as JSON\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ appkit registry info analytics\n $ appkit registry info @databricks-appkit/analytics --json`,\n )\n .action((ref: string, opts: { json?: boolean }) =>\n runInfo(ref, opts).catch((err) => {\n console.error(err);\n process.exit(1);\n }),\n );\n"],"mappings":";;;;;;;AAQA,eAAe,QAAQ,KAAa,MAAyC;CAI3E,MAAM,OAAO,eAAe,IAAI;AAChC,KAAI,CAAC,gBAAgB,KAAK,EAAE;AAC1B,UAAQ,MAAM,+BAA+B,KAAK,UAAU,IAAI,GAAG;AACnE,UAAQ,KAAK,EAAE;;CAEjB,MAAM,OAAO,MAAM,kBAAkB,KAAK;CAC1C,MAAM,OAAO,oBAAoB,KAAK;AAEtC,KAAI,KAAK,MAAM;AACb,UAAQ,IACN,KAAK,UACH;GACE,MAAM,KAAK;GACX,MAAM,KAAK;GACX,cAAc,KAAK,gBAAgB,EAAE;GACrC,sBAAsB,KAAK,wBAAwB,EAAE;GACrD,WAAW;GACZ,EACD,MACA,EACD,CACF;AACD;;AAGF,SAAQ,IAAI,GAAG,KAAK,KAAK,KAAK,CAAC;CAC/B,MAAM,OAAO,KAAK,gBAAgB,EAAE;CACpC,MAAM,eAAe,KAAK,wBAAwB,EAAE;AACpD,KAAI,KAAK,SAAS,EAChB,SAAQ,IAAI,GAAG,IAAI,uBAAuB,KAAK,KAAK,KAAK,GAAG,CAAC;AAE/D,KAAI,aAAa,SAAS,EACxB,SAAQ,IAAI,GAAG,IAAI,4BAA4B,aAAa,KAAK,KAAK,GAAG,CAAC;AAE5E,SAAQ,IAAI,KAAK,mBAAmB,MAAM,KAAK,GAAG;;AAGpD,MAAa,sBAAsB,IAAI,QAAQ,OAAO,CACnD,YAAY,wDAAwD,CACpE,SAAS,UAAU,qCAAqC,CACxD,OAAO,UAAU,iBAAiB,CAClC,YACC,SACA;;;8DAID,CACA,QAAQ,KAAa,SACpB,QAAQ,KAAK,KAAK,CAAC,OAAO,QAAQ;AAChC,SAAQ,MAAM,IAAI;AAClB,SAAQ,KAAK,EAAE;EACf,CACH"}
@@ -1,5 +1,4 @@
1
- import { REGISTRY_INDEX_API_URL, REGISTRY_INDEX_URL, REGISTRY_REPO, resolveToken } from "./constants.js";
2
- import { registryAuthHeaders } from "./client.js";
1
+ import { REGISTRY_INDEX_URL, REGISTRY_REPO } from "./constants.js";
3
2
  import { Command } from "commander";
4
3
  import process from "node:process";
5
4
  import pc from "picocolors";
@@ -66,25 +65,18 @@ function printTable(items) {
66
65
  console.log(`${name} ${kindCell} ${mark} ${verified ? desc : pc.dim(desc)}`);
67
66
  }
68
67
  }
69
- /** Fetches the registry index (token-aware), or exits with a helpful message. */
68
+ /** Fetches the registry index from the public raw URL, or exits with a message. */
70
69
  async function fetchIndex() {
71
- const token = resolveToken();
72
- const url = token ? REGISTRY_INDEX_API_URL : REGISTRY_INDEX_URL;
73
70
  let res;
74
71
  try {
75
- res = await fetch(url, { headers: registryAuthHeaders(token) });
72
+ res = await fetch(REGISTRY_INDEX_URL);
76
73
  } catch (err) {
77
- console.error(pc.red(`Failed to reach the registry at ${url}`));
74
+ console.error(pc.red(`Failed to reach the registry at ${REGISTRY_INDEX_URL}`));
78
75
  console.error(` ${err instanceof Error ? err.message : String(err)}`);
79
76
  process.exit(1);
80
77
  }
81
- if (res.status === 404 || res.status === 401 || res.status === 403) {
82
- console.error(pc.red(`Could not read the registry index from ${REGISTRY_REPO} (HTTP ${res.status}).`));
83
- if (!token) console.error(" If the repo is private, set APPKIT_REGISTRY_TOKEN (or GITHUB_TOKEN) to a token with read access.");
84
- process.exit(1);
85
- }
86
78
  if (!res.ok) {
87
- console.error(pc.red(`Registry returned HTTP ${res.status} for ${url}`));
79
+ console.error(pc.red(`Could not read the registry index from ${REGISTRY_REPO} (HTTP ${res.status}).`));
88
80
  process.exit(1);
89
81
  }
90
82
  return (await res.json()).items ?? [];
@@ -1 +1 @@
1
- {"version":3,"file":"list.js","names":[],"sources":["../../../../src/cli/commands/registry/list.ts"],"sourcesContent":["import process from \"node:process\";\n\nimport { Command } from \"commander\";\nimport pc from \"picocolors\";\n\nimport { registryAuthHeaders } from \"./client\";\nimport {\n REGISTRY_INDEX_API_URL,\n REGISTRY_INDEX_URL,\n REGISTRY_REPO,\n resolveToken,\n} from \"./constants\";\n\ninterface RegistryIndexItem {\n name: string;\n type?: string;\n title?: string;\n description?: string;\n categories?: string[];\n meta?: { verified?: boolean };\n files?: Array<{ path?: string; target?: string }>;\n}\n\nfunction isVerified(item: RegistryIndexItem): boolean {\n return item.meta?.verified === true;\n}\n\n/** Free-text haystack for search matching. */\nfunction searchHaystack(item: RegistryIndexItem): string {\n return [\n item.name,\n item.title ?? \"\",\n item.description ?? \"\",\n itemKind(item),\n ...(item.categories ?? []),\n ]\n .join(\" \")\n .toLowerCase();\n}\n\n/** True if every whitespace-separated term in `query` appears in the item. */\nfunction matchesQuery(item: RegistryIndexItem, query: string): boolean {\n const haystack = searchHaystack(item);\n return query\n .toLowerCase()\n .split(/\\s+/)\n .filter(Boolean)\n .every((term) => haystack.includes(term));\n}\n\n/** A friendly kind for the TYPE column: plugin, component, hook, theme, … */\nfunction itemKind(item: RegistryIndexItem): string {\n const hasManifest = (item.files ?? []).some(\n (f) =>\n f.target?.endsWith(\"manifest.json\") || f.path?.endsWith(\"manifest.json\"),\n );\n if (hasManifest) return \"plugin\";\n switch (item.type) {\n case \"registry:component\":\n case \"registry:block\":\n return \"component\";\n case \"registry:hook\":\n return \"hook\";\n case \"registry:lib\":\n return \"lib\";\n case \"registry:theme\":\n return \"theme\";\n case \"registry:ui\":\n return \"ui\";\n case \"registry:page\":\n return \"page\";\n default:\n return item.type?.replace(/^registry:/, \"\") || \"item\";\n }\n}\n\nconst KIND_COLOR: Record<string, (s: string) => string> = {\n plugin: pc.magenta,\n component: pc.blue,\n hook: pc.cyan,\n theme: pc.yellow,\n lib: pc.green,\n};\n\nfunction printTable(items: RegistryIndexItem[]): void {\n if (items.length === 0) {\n console.log(pc.dim(\"No items found in the registry.\"));\n return;\n }\n const kinds = items.map(itemKind);\n const maxName = Math.max(4, ...items.map((i) => i.name.length));\n const maxKind = Math.max(4, ...kinds.map((k) => k.length));\n const verifiedCol = \"VERIFIED\";\n // Pad plain text before coloring so ANSI codes don't break alignment.\n const header = `${\"NAME\".padEnd(maxName)} ${\"TYPE\".padEnd(maxKind)} ${verifiedCol} DESCRIPTION`;\n console.log(pc.bold(header));\n console.log(pc.dim(\"─\".repeat(header.length)));\n for (const [i, item] of items.entries()) {\n const verified = isVerified(item);\n const kind = kinds[i];\n const colorKind = KIND_COLOR[kind] ?? pc.white;\n const name = pc.cyan(item.name.padEnd(maxName));\n const kindCell = colorKind(kind.padEnd(maxKind));\n const mark = verified\n ? pc.green(\"✓\".padEnd(verifiedCol.length))\n : \" \".repeat(verifiedCol.length);\n const desc = item.description ?? item.title ?? \"\";\n console.log(\n `${name} ${kindCell} ${mark} ${verified ? desc : pc.dim(desc)}`,\n );\n }\n}\n\n/** Fetches the registry index (token-aware), or exits with a helpful message. */\nasync function fetchIndex(): Promise<RegistryIndexItem[]> {\n const token = resolveToken();\n const url = token ? REGISTRY_INDEX_API_URL : REGISTRY_INDEX_URL;\n\n let res: Awaited<ReturnType<typeof fetch>>;\n try {\n res = await fetch(url, { headers: registryAuthHeaders(token) });\n } catch (err) {\n console.error(pc.red(`Failed to reach the registry at ${url}`));\n console.error(` ${err instanceof Error ? err.message : String(err)}`);\n process.exit(1);\n }\n if (res.status === 404 || res.status === 401 || res.status === 403) {\n console.error(\n pc.red(\n `Could not read the registry index from ${REGISTRY_REPO} (HTTP ${res.status}).`,\n ),\n );\n if (!token) {\n console.error(\n \" If the repo is private, set APPKIT_REGISTRY_TOKEN (or GITHUB_TOKEN) to a token with read access.\",\n );\n }\n process.exit(1);\n }\n if (!res.ok) {\n console.error(pc.red(`Registry returned HTTP ${res.status} for ${url}`));\n process.exit(1);\n }\n\n const data = (await res.json()) as { items?: RegistryIndexItem[] };\n return data.items ?? [];\n}\n\nfunction output(items: RegistryIndexItem[], opts: { json?: boolean }): void {\n if (opts.json) {\n // Surface `kind` + `verified` as top-level fields for easy scripting.\n console.log(\n JSON.stringify(\n items.map((i) => ({\n ...i,\n kind: itemKind(i),\n verified: isVerified(i),\n })),\n null,\n 2,\n ),\n );\n } else {\n printTable(items);\n }\n}\n\nasync function runList(opts: {\n json?: boolean;\n verified?: boolean;\n}): Promise<void> {\n let items = await fetchIndex();\n if (opts.verified) items = items.filter(isVerified);\n output(items, opts);\n}\n\nasync function runSearch(\n query: string,\n opts: { json?: boolean; verified?: boolean },\n): Promise<void> {\n let items = await fetchIndex();\n items = items.filter((i) => matchesQuery(i, query));\n if (opts.verified) items = items.filter(isVerified);\n if (items.length === 0 && !opts.json) {\n console.log(pc.dim(`No items match \"${query}\".`));\n return;\n }\n output(items, opts);\n}\n\nexport const registryListCommand = new Command(\"list\")\n .description(\"List items available in the AppKit registry\")\n .option(\"--json\", \"Output as JSON\")\n .option(\"--verified\", \"Show only verified items\")\n .action((opts: { json?: boolean; verified?: boolean }) =>\n runList(opts).catch((err) => {\n console.error(err);\n process.exit(1);\n }),\n );\n\nexport const registrySearchCommand = new Command(\"search\")\n .description(\"Search registry items by name, description, type, or keyword\")\n .argument(\"<query...>\", \"Search terms (all must match)\")\n .option(\"--json\", \"Output as JSON\")\n .option(\"--verified\", \"Show only verified items\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ appkit registry search chart\n $ appkit registry search kpi dashboard\n $ appkit registry search plugin --json`,\n )\n .action((query: string[], opts: { json?: boolean; verified?: boolean }) =>\n runSearch(query.join(\" \"), opts).catch((err) => {\n console.error(err);\n process.exit(1);\n }),\n );\n"],"mappings":";;;;;;;AAuBA,SAAS,WAAW,MAAkC;AACpD,QAAO,KAAK,MAAM,aAAa;;;AAIjC,SAAS,eAAe,MAAiC;AACvD,QAAO;EACL,KAAK;EACL,KAAK,SAAS;EACd,KAAK,eAAe;EACpB,SAAS,KAAK;EACd,GAAI,KAAK,cAAc,EAAE;EAC1B,CACE,KAAK,IAAI,CACT,aAAa;;;AAIlB,SAAS,aAAa,MAAyB,OAAwB;CACrE,MAAM,WAAW,eAAe,KAAK;AACrC,QAAO,MACJ,aAAa,CACb,MAAM,MAAM,CACZ,OAAO,QAAQ,CACf,OAAO,SAAS,SAAS,SAAS,KAAK,CAAC;;;AAI7C,SAAS,SAAS,MAAiC;AAKjD,MAJqB,KAAK,SAAS,EAAE,EAAE,MACpC,MACC,EAAE,QAAQ,SAAS,gBAAgB,IAAI,EAAE,MAAM,SAAS,gBAAgB,CAC3E,CACgB,QAAO;AACxB,SAAQ,KAAK,MAAb;EACE,KAAK;EACL,KAAK,iBACH,QAAO;EACT,KAAK,gBACH,QAAO;EACT,KAAK,eACH,QAAO;EACT,KAAK,iBACH,QAAO;EACT,KAAK,cACH,QAAO;EACT,KAAK,gBACH,QAAO;EACT,QACE,QAAO,KAAK,MAAM,QAAQ,cAAc,GAAG,IAAI;;;AAIrD,MAAM,aAAoD;CACxD,QAAQ,GAAG;CACX,WAAW,GAAG;CACd,MAAM,GAAG;CACT,OAAO,GAAG;CACV,KAAK,GAAG;CACT;AAED,SAAS,WAAW,OAAkC;AACpD,KAAI,MAAM,WAAW,GAAG;AACtB,UAAQ,IAAI,GAAG,IAAI,kCAAkC,CAAC;AACtD;;CAEF,MAAM,QAAQ,MAAM,IAAI,SAAS;CACjC,MAAM,UAAU,KAAK,IAAI,GAAG,GAAG,MAAM,KAAK,MAAM,EAAE,KAAK,OAAO,CAAC;CAC/D,MAAM,UAAU,KAAK,IAAI,GAAG,GAAG,MAAM,KAAK,MAAM,EAAE,OAAO,CAAC;CAG1D,MAAM,SAAS,GAAG,OAAO,OAAO,QAAQ,CAAC,IAAI,OAAO,OAAO,QAAQ,CAAC;AACpE,SAAQ,IAAI,GAAG,KAAK,OAAO,CAAC;AAC5B,SAAQ,IAAI,GAAG,IAAI,IAAI,OAAO,OAAO,OAAO,CAAC,CAAC;AAC9C,MAAK,MAAM,CAAC,GAAG,SAAS,MAAM,SAAS,EAAE;EACvC,MAAM,WAAW,WAAW,KAAK;EACjC,MAAM,OAAO,MAAM;EACnB,MAAM,YAAY,WAAW,SAAS,GAAG;EACzC,MAAM,OAAO,GAAG,KAAK,KAAK,KAAK,OAAO,QAAQ,CAAC;EAC/C,MAAM,WAAW,UAAU,KAAK,OAAO,QAAQ,CAAC;EAChD,MAAM,OAAO,WACT,GAAG,MAAM,IAAI,OAAO,EAAmB,CAAC,GACxC,IAAI,OAAO,EAAmB;EAClC,MAAM,OAAO,KAAK,eAAe,KAAK,SAAS;AAC/C,UAAQ,IACN,GAAG,KAAK,IAAI,SAAS,IAAI,KAAK,IAAI,WAAW,OAAO,GAAG,IAAI,KAAK,GACjE;;;;AAKL,eAAe,aAA2C;CACxD,MAAM,QAAQ,cAAc;CAC5B,MAAM,MAAM,QAAQ,yBAAyB;CAE7C,IAAI;AACJ,KAAI;AACF,QAAM,MAAM,MAAM,KAAK,EAAE,SAAS,oBAAoB,MAAM,EAAE,CAAC;UACxD,KAAK;AACZ,UAAQ,MAAM,GAAG,IAAI,mCAAmC,MAAM,CAAC;AAC/D,UAAQ,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAAG;AACtE,UAAQ,KAAK,EAAE;;AAEjB,KAAI,IAAI,WAAW,OAAO,IAAI,WAAW,OAAO,IAAI,WAAW,KAAK;AAClE,UAAQ,MACN,GAAG,IACD,0CAA0C,cAAc,SAAS,IAAI,OAAO,IAC7E,CACF;AACD,MAAI,CAAC,MACH,SAAQ,MACN,qGACD;AAEH,UAAQ,KAAK,EAAE;;AAEjB,KAAI,CAAC,IAAI,IAAI;AACX,UAAQ,MAAM,GAAG,IAAI,0BAA0B,IAAI,OAAO,OAAO,MAAM,CAAC;AACxE,UAAQ,KAAK,EAAE;;AAIjB,SADc,MAAM,IAAI,MAAM,EAClB,SAAS,EAAE;;AAGzB,SAAS,OAAO,OAA4B,MAAgC;AAC1E,KAAI,KAAK,KAEP,SAAQ,IACN,KAAK,UACH,MAAM,KAAK,OAAO;EAChB,GAAG;EACH,MAAM,SAAS,EAAE;EACjB,UAAU,WAAW,EAAE;EACxB,EAAE,EACH,MACA,EACD,CACF;KAED,YAAW,MAAM;;AAIrB,eAAe,QAAQ,MAGL;CAChB,IAAI,QAAQ,MAAM,YAAY;AAC9B,KAAI,KAAK,SAAU,SAAQ,MAAM,OAAO,WAAW;AACnD,QAAO,OAAO,KAAK;;AAGrB,eAAe,UACb,OACA,MACe;CACf,IAAI,QAAQ,MAAM,YAAY;AAC9B,SAAQ,MAAM,QAAQ,MAAM,aAAa,GAAG,MAAM,CAAC;AACnD,KAAI,KAAK,SAAU,SAAQ,MAAM,OAAO,WAAW;AACnD,KAAI,MAAM,WAAW,KAAK,CAAC,KAAK,MAAM;AACpC,UAAQ,IAAI,GAAG,IAAI,mBAAmB,MAAM,IAAI,CAAC;AACjD;;AAEF,QAAO,OAAO,KAAK;;AAGrB,MAAa,sBAAsB,IAAI,QAAQ,OAAO,CACnD,YAAY,8CAA8C,CAC1D,OAAO,UAAU,iBAAiB,CAClC,OAAO,cAAc,2BAA2B,CAChD,QAAQ,SACP,QAAQ,KAAK,CAAC,OAAO,QAAQ;AAC3B,SAAQ,MAAM,IAAI;AAClB,SAAQ,KAAK,EAAE;EACf,CACH;AAEH,MAAa,wBAAwB,IAAI,QAAQ,SAAS,CACvD,YAAY,+DAA+D,CAC3E,SAAS,cAAc,gCAAgC,CACvD,OAAO,UAAU,iBAAiB,CAClC,OAAO,cAAc,2BAA2B,CAChD,YACC,SACA;;;;0CAKD,CACA,QAAQ,OAAiB,SACxB,UAAU,MAAM,KAAK,IAAI,EAAE,KAAK,CAAC,OAAO,QAAQ;AAC9C,SAAQ,MAAM,IAAI;AAClB,SAAQ,KAAK,EAAE;EACf,CACH"}
1
+ {"version":3,"file":"list.js","names":[],"sources":["../../../../src/cli/commands/registry/list.ts"],"sourcesContent":["import process from \"node:process\";\n\nimport { Command } from \"commander\";\nimport pc from \"picocolors\";\n\nimport { REGISTRY_INDEX_URL, REGISTRY_REPO } from \"./constants\";\n\ninterface RegistryIndexItem {\n name: string;\n type?: string;\n title?: string;\n description?: string;\n categories?: string[];\n meta?: { verified?: boolean };\n files?: Array<{ path?: string; target?: string }>;\n}\n\nfunction isVerified(item: RegistryIndexItem): boolean {\n return item.meta?.verified === true;\n}\n\n/** Free-text haystack for search matching. */\nfunction searchHaystack(item: RegistryIndexItem): string {\n return [\n item.name,\n item.title ?? \"\",\n item.description ?? \"\",\n itemKind(item),\n ...(item.categories ?? []),\n ]\n .join(\" \")\n .toLowerCase();\n}\n\n/** True if every whitespace-separated term in `query` appears in the item. */\nfunction matchesQuery(item: RegistryIndexItem, query: string): boolean {\n const haystack = searchHaystack(item);\n return query\n .toLowerCase()\n .split(/\\s+/)\n .filter(Boolean)\n .every((term) => haystack.includes(term));\n}\n\n/** A friendly kind for the TYPE column: plugin, component, hook, theme, … */\nfunction itemKind(item: RegistryIndexItem): string {\n const hasManifest = (item.files ?? []).some(\n (f) =>\n f.target?.endsWith(\"manifest.json\") || f.path?.endsWith(\"manifest.json\"),\n );\n if (hasManifest) return \"plugin\";\n switch (item.type) {\n case \"registry:component\":\n case \"registry:block\":\n return \"component\";\n case \"registry:hook\":\n return \"hook\";\n case \"registry:lib\":\n return \"lib\";\n case \"registry:theme\":\n return \"theme\";\n case \"registry:ui\":\n return \"ui\";\n case \"registry:page\":\n return \"page\";\n default:\n return item.type?.replace(/^registry:/, \"\") || \"item\";\n }\n}\n\nconst KIND_COLOR: Record<string, (s: string) => string> = {\n plugin: pc.magenta,\n component: pc.blue,\n hook: pc.cyan,\n theme: pc.yellow,\n lib: pc.green,\n};\n\nfunction printTable(items: RegistryIndexItem[]): void {\n if (items.length === 0) {\n console.log(pc.dim(\"No items found in the registry.\"));\n return;\n }\n const kinds = items.map(itemKind);\n const maxName = Math.max(4, ...items.map((i) => i.name.length));\n const maxKind = Math.max(4, ...kinds.map((k) => k.length));\n const verifiedCol = \"VERIFIED\";\n // Pad plain text before coloring so ANSI codes don't break alignment.\n const header = `${\"NAME\".padEnd(maxName)} ${\"TYPE\".padEnd(maxKind)} ${verifiedCol} DESCRIPTION`;\n console.log(pc.bold(header));\n console.log(pc.dim(\"─\".repeat(header.length)));\n for (const [i, item] of items.entries()) {\n const verified = isVerified(item);\n const kind = kinds[i];\n const colorKind = KIND_COLOR[kind] ?? pc.white;\n const name = pc.cyan(item.name.padEnd(maxName));\n const kindCell = colorKind(kind.padEnd(maxKind));\n const mark = verified\n ? pc.green(\"✓\".padEnd(verifiedCol.length))\n : \" \".repeat(verifiedCol.length);\n const desc = item.description ?? item.title ?? \"\";\n console.log(\n `${name} ${kindCell} ${mark} ${verified ? desc : pc.dim(desc)}`,\n );\n }\n}\n\n/** Fetches the registry index from the public raw URL, or exits with a message. */\nasync function fetchIndex(): Promise<RegistryIndexItem[]> {\n let res: Awaited<ReturnType<typeof fetch>>;\n try {\n res = await fetch(REGISTRY_INDEX_URL);\n } catch (err) {\n console.error(\n pc.red(`Failed to reach the registry at ${REGISTRY_INDEX_URL}`),\n );\n console.error(` ${err instanceof Error ? err.message : String(err)}`);\n process.exit(1);\n }\n if (!res.ok) {\n console.error(\n pc.red(\n `Could not read the registry index from ${REGISTRY_REPO} (HTTP ${res.status}).`,\n ),\n );\n process.exit(1);\n }\n\n const data = (await res.json()) as { items?: RegistryIndexItem[] };\n return data.items ?? [];\n}\n\nfunction output(items: RegistryIndexItem[], opts: { json?: boolean }): void {\n if (opts.json) {\n // Surface `kind` + `verified` as top-level fields for easy scripting.\n console.log(\n JSON.stringify(\n items.map((i) => ({\n ...i,\n kind: itemKind(i),\n verified: isVerified(i),\n })),\n null,\n 2,\n ),\n );\n } else {\n printTable(items);\n }\n}\n\nasync function runList(opts: {\n json?: boolean;\n verified?: boolean;\n}): Promise<void> {\n let items = await fetchIndex();\n if (opts.verified) items = items.filter(isVerified);\n output(items, opts);\n}\n\nasync function runSearch(\n query: string,\n opts: { json?: boolean; verified?: boolean },\n): Promise<void> {\n let items = await fetchIndex();\n items = items.filter((i) => matchesQuery(i, query));\n if (opts.verified) items = items.filter(isVerified);\n if (items.length === 0 && !opts.json) {\n console.log(pc.dim(`No items match \"${query}\".`));\n return;\n }\n output(items, opts);\n}\n\nexport const registryListCommand = new Command(\"list\")\n .description(\"List items available in the AppKit registry\")\n .option(\"--json\", \"Output as JSON\")\n .option(\"--verified\", \"Show only verified items\")\n .action((opts: { json?: boolean; verified?: boolean }) =>\n runList(opts).catch((err) => {\n console.error(err);\n process.exit(1);\n }),\n );\n\nexport const registrySearchCommand = new Command(\"search\")\n .description(\"Search registry items by name, description, type, or keyword\")\n .argument(\"<query...>\", \"Search terms (all must match)\")\n .option(\"--json\", \"Output as JSON\")\n .option(\"--verified\", \"Show only verified items\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ appkit registry search chart\n $ appkit registry search kpi dashboard\n $ appkit registry search plugin --json`,\n )\n .action((query: string[], opts: { json?: boolean; verified?: boolean }) =>\n runSearch(query.join(\" \"), opts).catch((err) => {\n console.error(err);\n process.exit(1);\n }),\n );\n"],"mappings":"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"}
@@ -14,58 +14,70 @@ function choiceFrom(item, idField, labelField) {
14
14
  };
15
15
  }
16
16
  /**
17
- * Genie listSpaces returns a single page, not an auto-paginating iterable like
18
- * the other services. Adapt it to one that follows `next_page_token`; the
19
- * repeated-token guard avoids an infinite loop if the API echoes a token back.
17
+ * Follows page tokens until exhausted. The repeated-token guard avoids an
18
+ * infinite loop if the API echoes a token back.
20
19
  */
21
- async function* iterateGenieSpaces(client) {
20
+ async function* paginate(fetchPage) {
22
21
  let pageToken;
23
22
  do {
24
- const res = await client.genie.listSpaces(pageToken ? { page_token: pageToken } : {});
25
- for (const space of res.spaces ?? []) yield space;
26
- const next = res.next_page_token;
23
+ const { items, next } = await fetchPage(pageToken);
24
+ for (const item of items ?? []) yield item;
27
25
  if (next && next === pageToken) break;
28
26
  pageToken = next;
29
27
  } while (pageToken);
30
28
  }
29
+ /** listInferenceEndpoints is unpaginated; adapt its single page. */
30
+ async function* iterateServingEndpoints(client) {
31
+ yield* (await client.modelServing.listInferenceEndpoints({})).endpoints ?? [];
32
+ }
33
+ /** Genie listSpaces returns a single page; follow `nextPageToken`. */
34
+ function iterateGenieSpaces(client) {
35
+ return paginate(async (pageToken) => {
36
+ const res = await client.genie.genieListSpaces(pageToken ? { pageToken } : {});
37
+ return {
38
+ items: res.spaces,
39
+ next: res.nextPageToken
40
+ };
41
+ });
42
+ }
31
43
  /** Flat, top-level listable resource types, backed by SDK services. */
32
44
  const SDK_LISTERS = {
33
45
  sql_warehouse: {
34
- list: (c) => c.warehouses.list({}),
46
+ list: (c) => c.warehouses.listWarehousesIter({}),
35
47
  toChoice: (i) => choiceFrom(i, "id", "name")
36
48
  },
37
49
  job: {
38
- list: (c) => c.jobs.list({}),
50
+ list: (c) => c.jobs.listJobsIter({}),
39
51
  toChoice: (i) => {
40
52
  const settings = i.settings;
41
53
  return choiceFrom({
42
54
  ...i,
43
55
  name: settings?.name
44
- }, "job_id", "name");
56
+ }, "jobId", "name");
45
57
  }
46
58
  },
47
59
  serving_endpoint: {
48
- list: (c) => c.servingEndpoints.list(),
60
+ list: iterateServingEndpoints,
49
61
  toChoice: (i) => choiceFrom(i, "name", "name")
50
62
  },
51
63
  uc_connection: {
52
- list: (c) => c.connections.list({}),
53
- toChoice: (i) => choiceFrom(i, "name", "full_name")
64
+ list: (c) => c.connections.listConnectionsIter({}),
65
+ toChoice: (i) => choiceFrom(i, "name", "fullName")
54
66
  },
55
67
  database: {
56
- list: (c) => c.database.listDatabaseInstances({}),
68
+ list: (c) => c.database.listDatabaseInstancesIter({}),
57
69
  toChoice: (i) => choiceFrom(i, "name", "name")
58
70
  },
59
71
  genie_space: {
60
72
  list: iterateGenieSpaces,
61
- toChoice: (i) => choiceFrom(i, "space_id", "title")
73
+ toChoice: (i) => choiceFrom(i, "spaceId", "title")
62
74
  },
63
75
  experiment: {
64
- list: (c) => c.experiments.listExperiments({}),
65
- toChoice: (i) => choiceFrom(i, "experiment_id", "name")
76
+ list: (c) => c.experiments.listExperimentsIter({}),
77
+ toChoice: (i) => choiceFrom(i, "experimentId", "name")
66
78
  },
67
79
  app: {
68
- list: (c) => c.apps.list({}),
80
+ list: (c) => c.apps.listAppsIter({}),
69
81
  toChoice: (i) => choiceFrom(i, "name", "name")
70
82
  }
71
83
  };
@@ -74,16 +86,14 @@ function isFlatListable(resourceType) {
74
86
  return resourceType in SDK_LISTERS;
75
87
  }
76
88
  /**
77
- * Constructs a raw SDK workspace client for the given profile (or default
78
- * resolution), via the sanctioned `workspace-client` facade. Uses the legacy
79
- * escape hatch because the picker needs services (connections, database,
80
- * experiments, apps) the facade doesn't yet proxy directly.
89
+ * Constructs a workspace client for the given profile (or default resolution),
90
+ * via the sanctioned `workspace-client` facade.
81
91
  */
82
92
  function makeWorkspaceClient(profile) {
83
- return createWorkspaceClient(profile ? { profile } : {}).toLegacyWorkspaceClient();
93
+ return createWorkspaceClient(profile ? { profile } : {});
84
94
  }
85
95
  /**
86
- * Max resources fetched for the picker. `list()` auto-paginates, so on a large
96
+ * Max resources fetched for the picker. `list()` paginates lazily, so on a large
87
97
  * workspace (5000+ warehouses) breaking out at the cap stops pagination early;
88
98
  * the picker's "Enter manually" option covers anything beyond it.
89
99
  */