@databricks/appkit-ui 0.88.0 → 0.89.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 (142) 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/workspace-picker.js +34 -24
  9. package/dist/cli/commands/registry/workspace-picker.js.map +1 -1
  10. package/dist/react/genie/genie-chart-inference.js.map +1 -1
  11. package/dist/react/genie/genie-query-transform.d.ts +5 -2
  12. package/dist/react/genie/genie-query-transform.d.ts.map +1 -1
  13. package/dist/react/genie/genie-query-transform.js +14 -8
  14. package/dist/react/genie/genie-query-transform.js.map +1 -1
  15. package/dist/react/table/table-wrapper.js +6 -1
  16. package/dist/react/table/table-wrapper.js.map +1 -1
  17. package/dist/react/table/types.d.ts +5 -1
  18. package/dist/react/table/types.d.ts.map +1 -1
  19. package/dist/react/ui/button.d.ts +1 -1
  20. package/dist/shared/src/genie.d.ts +9 -3
  21. package/dist/shared/src/genie.d.ts.map +1 -1
  22. package/dist/shared/src/workspace-client/factory.d.ts +0 -1
  23. package/dist/shared/src/workspace-client/index.d.ts +1 -2
  24. package/dist/shared/src/workspace-client/modular.d.ts +19 -0
  25. package/dist/shared/src/workspace-client/types.d.ts +1 -2
  26. package/dist/workspace-client/client.js +81 -23
  27. package/dist/workspace-client/client.js.map +1 -1
  28. package/dist/workspace-client/errors.d.ts +14 -2
  29. package/dist/workspace-client/errors.d.ts.map +1 -0
  30. package/dist/workspace-client/errors.js +45 -2
  31. package/dist/workspace-client/errors.js.map +1 -0
  32. package/dist/workspace-client/factory.d.ts +1 -1
  33. package/dist/workspace-client/factory.js.map +1 -1
  34. package/dist/workspace-client/index.d.ts +4 -3
  35. package/dist/workspace-client/index.js +2 -2
  36. package/dist/workspace-client/modular.d.ts +109 -0
  37. package/dist/workspace-client/modular.d.ts.map +1 -0
  38. package/dist/workspace-client/modular.js +447 -0
  39. package/dist/workspace-client/modular.js.map +1 -0
  40. package/dist/workspace-client/options.d.ts +29 -0
  41. package/dist/workspace-client/options.d.ts.map +1 -0
  42. package/dist/workspace-client/types.d.ts +35 -38
  43. package/dist/workspace-client/types.d.ts.map +1 -1
  44. package/docs/api/appkit/Class.ApiError.md +110 -0
  45. package/docs/api/appkit/Class.DatabricksAdapter.md +2 -2
  46. package/docs/api/appkit/Class.SupervisorApiAdapter.md +1 -1
  47. package/docs/api/appkit/Function.generateDatabaseCredential.md +2 -2
  48. package/docs/api/appkit/Function.getWorkspaceClient.md +2 -2
  49. package/docs/api/appkit/Interface.DirectoryEntry.md +62 -0
  50. package/docs/api/appkit/Interface.DownloadResponse.md +45 -0
  51. package/docs/api/appkit/Interface.JobAPI.md +20 -12
  52. package/docs/api/appkit/Interface.LakebasePoolConfig.md +1 -1
  53. package/docs/api/appkit/Interface.WorkspaceClient.md +168 -26
  54. package/docs/api/appkit/Interface.WorkspaceClientOptions.md +1 -14
  55. package/docs/api/appkit/TypeAlias.FilesDirectoryEntry.md +8 -0
  56. package/docs/api/appkit/TypeAlias.FilesDownloadResponse.md +8 -0
  57. package/docs/api/appkit/TypeAlias.JobsExport.md +1 -1
  58. package/docs/api/appkit/TypeAlias.WorkspaceClientLike.md +16 -0
  59. package/docs/api/appkit-ui/data/DataTable.md +16 -16
  60. package/docs/api/appkit.md +7 -2
  61. package/docs/plugins/files.md +20 -3
  62. package/docs/plugins/jobs.md +9 -9
  63. package/docs/plugins/testing.md +10 -8
  64. package/llms.txt +7 -2
  65. package/node_modules/@databricks/sdk-genie/LICENSE +203 -0
  66. package/node_modules/@databricks/sdk-genie/README.md +23 -0
  67. package/node_modules/@databricks/sdk-genie/dist/package.js +7 -0
  68. package/node_modules/@databricks/sdk-genie/dist/package.js.map +1 -0
  69. package/node_modules/@databricks/sdk-genie/dist/v1/client.d.ts +175 -0
  70. package/node_modules/@databricks/sdk-genie/dist/v1/client.d.ts.map +1 -0
  71. package/node_modules/@databricks/sdk-genie/dist/v1/client.js +829 -0
  72. package/node_modules/@databricks/sdk-genie/dist/v1/client.js.map +1 -0
  73. package/node_modules/@databricks/sdk-genie/dist/v1/index.d.ts +3 -0
  74. package/node_modules/@databricks/sdk-genie/dist/v1/index.js +4 -0
  75. package/node_modules/@databricks/sdk-genie/dist/v1/model.d.ts +1799 -0
  76. package/node_modules/@databricks/sdk-genie/dist/v1/model.d.ts.map +1 -0
  77. package/node_modules/@databricks/sdk-genie/dist/v1/model.js +1097 -0
  78. package/node_modules/@databricks/sdk-genie/dist/v1/model.js.map +1 -0
  79. package/node_modules/@databricks/sdk-genie/dist/v1/transport.d.ts +37 -0
  80. package/node_modules/@databricks/sdk-genie/dist/v1/transport.d.ts.map +1 -0
  81. package/node_modules/@databricks/sdk-genie/dist/v1/transport.js +73 -0
  82. package/node_modules/@databricks/sdk-genie/dist/v1/transport.js.map +1 -0
  83. package/node_modules/@databricks/sdk-genie/dist/v1/utils.d.ts +43 -0
  84. package/node_modules/@databricks/sdk-genie/dist/v1/utils.d.ts.map +1 -0
  85. package/node_modules/@databricks/sdk-genie/dist/v1/utils.js +130 -0
  86. package/node_modules/@databricks/sdk-genie/dist/v1/utils.js.map +1 -0
  87. package/node_modules/@databricks/sdk-genie/package.json +46 -0
  88. package/node_modules/@databricks/sdk-statementexecution/LICENSE +203 -0
  89. package/node_modules/@databricks/sdk-statementexecution/README.md +23 -0
  90. package/node_modules/@databricks/sdk-statementexecution/dist/package.js +7 -0
  91. package/node_modules/@databricks/sdk-statementexecution/dist/package.js.map +1 -0
  92. package/node_modules/@databricks/sdk-statementexecution/dist/v1/client.d.ts +91 -0
  93. package/node_modules/@databricks/sdk-statementexecution/dist/v1/client.d.ts.map +1 -0
  94. package/node_modules/@databricks/sdk-statementexecution/dist/v1/client.js +183 -0
  95. package/node_modules/@databricks/sdk-statementexecution/dist/v1/client.js.map +1 -0
  96. package/node_modules/@databricks/sdk-statementexecution/dist/v1/index.d.ts +3 -0
  97. package/node_modules/@databricks/sdk-statementexecution/dist/v1/index.js +4 -0
  98. package/node_modules/@databricks/sdk-statementexecution/dist/v1/model.d.ts +506 -0
  99. package/node_modules/@databricks/sdk-statementexecution/dist/v1/model.d.ts.map +1 -0
  100. package/node_modules/@databricks/sdk-statementexecution/dist/v1/model.js +302 -0
  101. package/node_modules/@databricks/sdk-statementexecution/dist/v1/model.js.map +1 -0
  102. package/node_modules/@databricks/sdk-statementexecution/dist/v1/transport.d.ts +37 -0
  103. package/node_modules/@databricks/sdk-statementexecution/dist/v1/transport.d.ts.map +1 -0
  104. package/node_modules/@databricks/sdk-statementexecution/dist/v1/transport.js +73 -0
  105. package/node_modules/@databricks/sdk-statementexecution/dist/v1/transport.js.map +1 -0
  106. package/node_modules/@databricks/sdk-statementexecution/dist/v1/utils.d.ts +25 -0
  107. package/node_modules/@databricks/sdk-statementexecution/dist/v1/utils.d.ts.map +1 -0
  108. package/node_modules/@databricks/sdk-statementexecution/dist/v1/utils.js +87 -0
  109. package/node_modules/@databricks/sdk-statementexecution/dist/v1/utils.js.map +1 -0
  110. package/node_modules/@databricks/sdk-statementexecution/package.json +46 -0
  111. package/node_modules/@databricks/sdk-vectorsearch/LICENSE +203 -0
  112. package/node_modules/@databricks/sdk-vectorsearch/README.md +23 -0
  113. package/node_modules/@databricks/sdk-vectorsearch/dist/package.js +7 -0
  114. package/node_modules/@databricks/sdk-vectorsearch/dist/package.js.map +1 -0
  115. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/client.d.ts +70 -0
  116. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/client.d.ts.map +1 -0
  117. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/client.js +474 -0
  118. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/client.js.map +1 -0
  119. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/index.d.ts +3 -0
  120. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/index.js +4 -0
  121. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/model.d.ts +704 -0
  122. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/model.d.ts.map +1 -0
  123. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/model.js +635 -0
  124. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/model.js.map +1 -0
  125. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/transport.d.ts +37 -0
  126. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/transport.d.ts.map +1 -0
  127. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/transport.js +73 -0
  128. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/transport.js.map +1 -0
  129. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/utils.d.ts +37 -0
  130. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/utils.d.ts.map +1 -0
  131. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/utils.js +104 -0
  132. package/node_modules/@databricks/sdk-vectorsearch/dist/v1/utils.js.map +1 -0
  133. package/node_modules/@databricks/sdk-vectorsearch/package.json +46 -0
  134. package/package.json +29 -4
  135. package/sbom.cdx.json +1 -1
  136. package/dist/shared/src/workspace-client/errors.d.ts +0 -1
  137. package/dist/shared/src/workspace-client/legacy.d.ts +0 -3
  138. package/dist/workspace-client/legacy.d.ts +0 -34
  139. package/dist/workspace-client/legacy.d.ts.map +0 -1
  140. package/dist/workspace-client/legacy.js +0 -23
  141. package/dist/workspace-client/legacy.js.map +0 -1
  142. package/docs/api/appkit/Interface.WorkspaceClientLike.md +0 -67
@@ -1 +1 @@
1
- {"version":3,"file":"workspace-picker.js","names":[],"sources":["../../../../src/cli/commands/registry/workspace-picker.ts"],"sourcesContent":["import { spawnSync } from \"node:child_process\";\n\nimport {\n createWorkspaceClient,\n type LegacyWorkspaceClient,\n} from \"../../../workspace-client\";\n\n/**\n * Lists a user's real Databricks workspace resources so `appkit add` can offer\n * a picker instead of blind free-text entry.\n *\n * Flat resource types are listed via the Databricks SDK client (typed,\n * auto-paginating) obtained through the sanctioned `workspace-client` facade.\n * Parent-context types (volume, uc_function, secret, vector_search_index) still\n * shell out to the `databricks` CLI for their drill-down. Every path fails\n * soft: any error returns an empty list and the caller drops to free-text entry.\n */\n\n/** A workspace resource choice surfaced in the picker. */\nexport interface WorkspaceChoice {\n /** Value written to the env var (the resource id/name). */\n value: string;\n /** Human label shown in the picker (name, falling back to value). */\n label: string;\n}\n\n/**\n * Per-type SDK lister: streams a resource type off the WorkspaceClient into\n * `{value,label}` choices. `list()` returns an async iterable of raw SDK\n * objects; `toChoice` maps each to a picker choice. The SDK auto-paginates, so\n * we simply iterate to completion.\n */\ninterface SdkLister {\n list: (client: LegacyWorkspaceClient) => AsyncIterable<unknown>;\n toChoice: (item: Record<string, unknown>) => WorkspaceChoice | null;\n}\n\n/** Builds a `{value,label}` from an id field and optional label field. */\nfunction choiceFrom(\n item: Record<string, unknown>,\n idField: string,\n labelField?: string,\n): WorkspaceChoice | null {\n const id = item[idField];\n if (id === undefined || id === null) return null;\n const value = String(id);\n const rawLabel = labelField ? item[labelField] : undefined;\n const label =\n typeof rawLabel === \"string\" && rawLabel.length > 0\n ? `${rawLabel} (${value})`\n : value;\n return { value, label };\n}\n\n/**\n * Genie listSpaces returns a single page, not an auto-paginating iterable like\n * the other services. Adapt it to one that follows `next_page_token`; the\n * repeated-token guard avoids an infinite loop if the API echoes a token back.\n */\nasync function* iterateGenieSpaces(\n client: LegacyWorkspaceClient,\n): AsyncIterable<unknown> {\n let pageToken: string | undefined;\n do {\n const res = await client.genie.listSpaces(\n pageToken ? { page_token: pageToken } : {},\n );\n for (const space of res.spaces ?? []) yield space;\n const next = res.next_page_token;\n if (next && next === pageToken) break;\n pageToken = next;\n } while (pageToken);\n}\n\n/** Flat, top-level listable resource types, backed by SDK services. */\nexport const SDK_LISTERS: Record<string, SdkLister> = {\n sql_warehouse: {\n list: (c) => c.warehouses.list({}),\n toChoice: (i) => choiceFrom(i, \"id\", \"name\"),\n },\n job: {\n list: (c) => c.jobs.list({}),\n // job name lives under settings.name; id is top-level job_id\n toChoice: (i) => {\n const settings = i.settings as { name?: string } | undefined;\n return choiceFrom({ ...i, name: settings?.name }, \"job_id\", \"name\");\n },\n },\n serving_endpoint: {\n list: (c) => c.servingEndpoints.list(),\n toChoice: (i) => choiceFrom(i, \"name\", \"name\"),\n },\n uc_connection: {\n list: (c) => c.connections.list({}),\n toChoice: (i) => choiceFrom(i, \"name\", \"full_name\"),\n },\n database: {\n list: (c) => c.database.listDatabaseInstances({}),\n toChoice: (i) => choiceFrom(i, \"name\", \"name\"),\n },\n genie_space: {\n list: iterateGenieSpaces,\n toChoice: (i) => choiceFrom(i, \"space_id\", \"title\"),\n },\n experiment: {\n list: (c) => c.experiments.listExperiments({}),\n toChoice: (i) => choiceFrom(i, \"experiment_id\", \"name\"),\n },\n app: {\n list: (c) => c.apps.list({}),\n toChoice: (i) => choiceFrom(i, \"name\", \"name\"),\n },\n};\n\n/** True when a resource type can be listed flat (no parent context). */\nexport function isFlatListable(resourceType: string): boolean {\n return resourceType in SDK_LISTERS;\n}\n\n/**\n * Constructs a raw SDK workspace client for the given profile (or default\n * resolution), via the sanctioned `workspace-client` facade. Uses the legacy\n * escape hatch because the picker needs services (connections, database,\n * experiments, apps) the facade doesn't yet proxy directly.\n */\nexport function makeWorkspaceClient(profile?: string): LegacyWorkspaceClient {\n return createWorkspaceClient(\n profile ? { profile } : {},\n ).toLegacyWorkspaceClient();\n}\n\n/**\n * Max resources fetched for the picker. `list()` auto-paginates, so on a large\n * workspace (5000+ warehouses) breaking out at the cap stops pagination early;\n * the picker's \"Enter manually\" option covers anything beyond it.\n */\nexport const MAX_PICKER_RESULTS = 200;\n\n/** A listing result plus whether it was truncated at the fetch cap. */\nexport interface WorkspaceListing {\n choices: WorkspaceChoice[];\n truncated: boolean;\n /** Short reason the listing failed (auth/config/network), if it did — lets\n * the caller distinguish a real error from a genuinely empty workspace. */\n error?: string;\n}\n\n/** First line of an error, capped, for a user-facing one-liner. */\nfunction shortErrorMessage(err: unknown): string {\n const msg = err instanceof Error ? err.message : String(err);\n return msg.split(\"\\n\")[0].trim().slice(0, 200);\n}\n\n/**\n * Lists workspace resources of a flat-listable type via the SDK, stopping at\n * MAX_PICKER_RESULTS so pagination doesn't drain a huge workspace. Returns an\n * empty listing on any failure (unknown type, auth/config error, network) so\n * the caller can fall back to free-text entry. `clientFactory` is injectable\n * for tests.\n */\nexport async function listWorkspaceResources(\n resourceType: string,\n profile?: string,\n clientFactory: (\n profile?: string,\n ) => LegacyWorkspaceClient = makeWorkspaceClient,\n): Promise<WorkspaceListing> {\n const lister = SDK_LISTERS[resourceType];\n if (!lister) return { choices: [], truncated: false };\n try {\n const client = clientFactory(profile);\n const choices: WorkspaceChoice[] = [];\n let truncated = false;\n for await (const item of lister.list(client)) {\n if (typeof item !== \"object\" || item === null) continue;\n const choice = lister.toChoice(item as Record<string, unknown>);\n if (!choice) continue;\n choices.push(choice);\n if (choices.length >= MAX_PICKER_RESULTS) {\n // Stop iterating — halts the async iterator, so no further pages fetch.\n truncated = true;\n break;\n }\n }\n return { choices, truncated };\n } catch (err) {\n // Don't swallow silently: return the reason so the caller can tell the user\n // the picker fell back because listing failed (typically auth/profile), not\n // because the workspace has none of this resource.\n return { choices: [], truncated: false, error: shortErrorMessage(err) };\n }\n}\n\n/** Runs a databricks CLI subcommand returning JSON; injectable for tests. */\nexport type CliRunner = (args: string[]) => {\n status: number | null;\n stdout: string;\n};\n\nconst defaultRunner: CliRunner = (args) => {\n // Parent-context lists can be large; raise maxBuffer well above the 1MB\n // default so a big JSON response isn't truncated into \"no resources found\".\n const res = spawnSync(\"databricks\", args, {\n encoding: \"utf-8\",\n maxBuffer: 64 * 1024 * 1024,\n });\n return { status: res.status, stdout: res.stdout ?? \"\" };\n};\n\n/**\n * Extracts `{value,label}` choices from a parsed CLI list response. The CLI\n * returns either a bare array or an object wrapping one; we scan for the first\n * array of objects. Items missing the id field are skipped.\n */\nexport function toChoices(\n parsed: unknown,\n idField: string,\n labelField?: string,\n): WorkspaceChoice[] {\n const arr = firstArray(parsed);\n const choices: WorkspaceChoice[] = [];\n for (const item of arr) {\n if (typeof item !== \"object\" || item === null) continue;\n const choice = choiceFrom(\n item as Record<string, unknown>,\n idField,\n labelField,\n );\n if (choice) choices.push(choice);\n }\n return choices;\n}\n\n/** Finds the first array in a CLI response (bare array or single wrapper key). */\nfunction firstArray(parsed: unknown): unknown[] {\n if (Array.isArray(parsed)) return parsed;\n if (parsed && typeof parsed === \"object\") {\n for (const v of Object.values(parsed)) {\n if (Array.isArray(v)) return v;\n }\n }\n return [];\n}\n\n/**\n * Runs a `databricks … list -o json` command and returns parsed choices, or\n * [] on any failure (CLI missing/errored, empty, non-JSON). `command` is the\n * argv after `databricks`; `-o json` and `-p <profile>` are appended.\n * Used for the parent-context drill-down (catalogs/schemas/scopes/endpoints).\n */\nexport function runList(\n command: string[],\n idField: string,\n labelField: string | undefined,\n profile: string | undefined,\n runner: CliRunner = defaultRunner,\n): WorkspaceChoice[] {\n const args = [...command, \"-o\", \"json\"];\n if (profile) args.push(\"-p\", profile);\n\n let result: { status: number | null; stdout: string };\n try {\n result = runner(args);\n } catch {\n return [];\n }\n if (result.status !== 0 || !result.stdout.trim()) return [];\n\n let parsed: unknown;\n try {\n parsed = JSON.parse(result.stdout);\n } catch {\n return [];\n }\n return toChoices(parsed, idField, labelField);\n}\n\n/**\n * A drill-down step for a parent-context resource type. `list(parents)` builds\n * the CLI argv given the values picked in prior steps (e.g. [catalog] → schema\n * list command). `key` labels the step for prompts.\n */\nexport interface ParentContextStep {\n key: string;\n list: (parents: string[]) => {\n command: string[];\n idField: string;\n labelField?: string;\n };\n}\n\n/**\n * Drill-down chains for parent-context resource types. Each ends by listing\n * the resource itself; earlier steps list the parents to pick first.\n * Positional-arg CLI gotcha: `databricks schemas list <CATALOG>` etc. take the\n * parent as a positional, not a flag.\n */\nexport const PARENT_CONTEXT_CHAINS: Record<string, ParentContextStep[]> = {\n volume: [\n {\n key: \"catalog\",\n list: () => ({\n command: [\"catalogs\", \"list\"],\n idField: \"name\",\n labelField: \"name\",\n }),\n },\n {\n key: \"schema\",\n list: ([catalog]) => ({\n command: [\"schemas\", \"list\", catalog],\n idField: \"name\",\n labelField: \"name\",\n }),\n },\n {\n key: \"volume\",\n list: ([catalog, schema]) => ({\n command: [\"volumes\", \"list\", catalog, schema],\n idField: \"full_name\",\n labelField: \"name\",\n }),\n },\n ],\n uc_function: [\n {\n key: \"catalog\",\n list: () => ({\n command: [\"catalogs\", \"list\"],\n idField: \"name\",\n labelField: \"name\",\n }),\n },\n {\n key: \"schema\",\n list: ([catalog]) => ({\n command: [\"schemas\", \"list\", catalog],\n idField: \"name\",\n labelField: \"name\",\n }),\n },\n {\n key: \"function\",\n list: ([catalog, schema]) => ({\n command: [\"functions\", \"list\", catalog, schema],\n idField: \"full_name\",\n labelField: \"name\",\n }),\n },\n ],\n secret: [\n {\n key: \"scope\",\n list: () => ({\n command: [\"secrets\", \"list-scopes\"],\n idField: \"name\",\n labelField: \"name\",\n }),\n },\n {\n key: \"key\",\n list: ([scope]) => ({\n command: [\"secrets\", \"list-secrets\", scope],\n idField: \"key\",\n labelField: \"key\",\n }),\n },\n ],\n vector_search_index: [\n {\n key: \"endpoint\",\n list: () => ({\n command: [\"vector-search-endpoints\", \"list-endpoints\"],\n idField: \"name\",\n labelField: \"name\",\n }),\n },\n {\n key: \"index\",\n list: ([endpoint]) => ({\n command: [\"vector-search-indexes\", \"list-indexes\", endpoint],\n idField: \"name\",\n labelField: \"name\",\n }),\n },\n ],\n};\n\n/** True when a resource type needs a parent-context drill-down to list. */\nexport function isParentContext(resourceType: string): boolean {\n return resourceType in PARENT_CONTEXT_CHAINS;\n}\n\n/** One resolved step of a drill-down: the choices to present at this level. */\nexport interface DrillStep {\n key: string;\n choices: WorkspaceChoice[];\n}\n\n/**\n * Lists the choices for a single drill-down step given the values picked so\n * far. Returns [] on failure. The caller drives the interaction (present\n * `choices`, collect a pick, call again with it appended to `parents`).\n */\nexport function listParentContextStep(\n resourceType: string,\n stepIndex: number,\n parents: string[],\n profile?: string,\n runner: CliRunner = defaultRunner,\n): DrillStep | null {\n const chain = PARENT_CONTEXT_CHAINS[resourceType];\n if (!chain || stepIndex >= chain.length) return null;\n const step = chain[stepIndex];\n // Prior picks become positional CLI args; a value starting with `-` would be\n // parsed as a flag, so refuse it (empty step → free-text fallback). Real\n // catalog/schema/scope/endpoint names never start with `-`.\n if (parents.some((p) => p.startsWith(\"-\"))) {\n return { key: step.key, choices: [] };\n }\n const spec = step.list(parents);\n return {\n key: step.key,\n choices: runList(\n spec.command,\n spec.idField,\n spec.labelField,\n profile,\n runner,\n ),\n };\n}\n\n/** Number of drill-down steps for a parent-context type (0 if not one). */\nexport function parentContextDepth(resourceType: string): number {\n return PARENT_CONTEXT_CHAINS[resourceType]?.length ?? 0;\n}\n\n/**\n * Builds the final resource identifier from the values picked across a\n * drill-down. Most types end on a self-qualified id (volume/uc_function list\n * `full_name`; a vector-search index name is already catalog.schema-qualified),\n * so the last pick is the whole answer. A `secret` is addressed by both its\n * scope and key (`scope/key`) — returning only the key drops the scope and\n * yields a value that can't locate the secret — so its picks are joined.\n */\nexport function composeResourceId(\n resourceType: string,\n picks: string[],\n): string {\n if (resourceType === \"secret\") return picks.join(\"/\");\n return picks[picks.length - 1];\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"workspace-picker.js","names":[],"sources":["../../../../src/cli/commands/registry/workspace-picker.ts"],"sourcesContent":["import { spawnSync } from \"node:child_process\";\n\nimport {\n createWorkspaceClient,\n type WorkspaceClient,\n} from \"../../../workspace-client\";\n\n/**\n * Lists a user's real Databricks workspace resources so `appkit add` can offer\n * a picker instead of blind free-text entry.\n *\n * Flat resource types are listed through the sanctioned `workspace-client`\n * facade's modular SDK clients.\n * Parent-context types (volume, uc_function, secret, vector_search_index) still\n * shell out to the `databricks` CLI for their drill-down. Every path fails\n * soft: any error returns an empty list and the caller drops to free-text entry.\n */\n\n/** A workspace resource choice surfaced in the picker. */\nexport interface WorkspaceChoice {\n /** Value written to the env var (the resource id/name). */\n value: string;\n /** Human label shown in the picker (name, falling back to value). */\n label: string;\n}\n\n/**\n * Per-type SDK lister: streams a resource type off the WorkspaceClient into\n * `{value,label}` choices. `list()` returns an async iterable of raw SDK\n * objects; `toChoice` maps each to a picker choice. The SDK auto-paginates, so\n * we simply iterate to completion.\n */\ninterface SdkLister {\n list: (client: WorkspaceClient) => AsyncIterable<unknown>;\n toChoice: (item: Record<string, unknown>) => WorkspaceChoice | null;\n}\n\n/** Builds a `{value,label}` from an id field and optional label field. */\nfunction choiceFrom(\n item: Record<string, unknown>,\n idField: string,\n labelField?: string,\n): WorkspaceChoice | null {\n const id = item[idField];\n if (id === undefined || id === null) return null;\n const value = String(id);\n const rawLabel = labelField ? item[labelField] : undefined;\n const label =\n typeof rawLabel === \"string\" && rawLabel.length > 0\n ? `${rawLabel} (${value})`\n : value;\n return { value, label };\n}\n\n/**\n * Follows page tokens until exhausted. The repeated-token guard avoids an\n * infinite loop if the API echoes a token back.\n */\nasync function* paginate(\n fetchPage: (\n pageToken?: string,\n ) => Promise<{ items?: unknown[]; next?: string }>,\n): AsyncIterable<unknown> {\n let pageToken: string | undefined;\n do {\n const { items, next } = await fetchPage(pageToken);\n for (const item of items ?? []) yield item;\n if (next && next === pageToken) break;\n pageToken = next;\n } while (pageToken);\n}\n\n/** listInferenceEndpoints is unpaginated; adapt its single page. */\nasync function* iterateServingEndpoints(\n client: WorkspaceClient,\n): AsyncIterable<unknown> {\n const res = await client.modelServing.listInferenceEndpoints({});\n yield* res.endpoints ?? [];\n}\n\n/** Genie listSpaces returns a single page; follow `nextPageToken`. */\nfunction iterateGenieSpaces(client: WorkspaceClient): AsyncIterable<unknown> {\n return paginate(async (pageToken) => {\n const res = await client.genie.genieListSpaces(\n pageToken ? { pageToken } : {},\n );\n return { items: res.spaces, next: res.nextPageToken };\n });\n}\n\n/** Flat, top-level listable resource types, backed by SDK services. */\nexport const SDK_LISTERS: Record<string, SdkLister> = {\n sql_warehouse: {\n list: (c) => c.warehouses.listWarehousesIter({}),\n toChoice: (i) => choiceFrom(i, \"id\", \"name\"),\n },\n job: {\n list: (c) => c.jobs.listJobsIter({}),\n // job name lives under settings.name; id is top-level jobId (a bigint)\n toChoice: (i) => {\n const settings = i.settings as { name?: string } | undefined;\n return choiceFrom({ ...i, name: settings?.name }, \"jobId\", \"name\");\n },\n },\n serving_endpoint: {\n list: iterateServingEndpoints,\n toChoice: (i) => choiceFrom(i, \"name\", \"name\"),\n },\n uc_connection: {\n list: (c) => c.connections.listConnectionsIter({}),\n toChoice: (i) => choiceFrom(i, \"name\", \"fullName\"),\n },\n database: {\n list: (c) => c.database.listDatabaseInstancesIter({}),\n toChoice: (i) => choiceFrom(i, \"name\", \"name\"),\n },\n genie_space: {\n list: iterateGenieSpaces,\n toChoice: (i) => choiceFrom(i, \"spaceId\", \"title\"),\n },\n experiment: {\n list: (c) => c.experiments.listExperimentsIter({}),\n toChoice: (i) => choiceFrom(i, \"experimentId\", \"name\"),\n },\n app: {\n list: (c) => c.apps.listAppsIter({}),\n toChoice: (i) => choiceFrom(i, \"name\", \"name\"),\n },\n};\n\n/** True when a resource type can be listed flat (no parent context). */\nexport function isFlatListable(resourceType: string): boolean {\n return resourceType in SDK_LISTERS;\n}\n\n/**\n * Constructs a workspace client for the given profile (or default resolution),\n * via the sanctioned `workspace-client` facade.\n */\nexport function makeWorkspaceClient(profile?: string): WorkspaceClient {\n return createWorkspaceClient(profile ? { profile } : {});\n}\n\n/**\n * Max resources fetched for the picker. `list()` paginates lazily, so on a large\n * workspace (5000+ warehouses) breaking out at the cap stops pagination early;\n * the picker's \"Enter manually\" option covers anything beyond it.\n */\nexport const MAX_PICKER_RESULTS = 200;\n\n/** A listing result plus whether it was truncated at the fetch cap. */\nexport interface WorkspaceListing {\n choices: WorkspaceChoice[];\n truncated: boolean;\n /** Short reason the listing failed (auth/config/network), if it did — lets\n * the caller distinguish a real error from a genuinely empty workspace. */\n error?: string;\n}\n\n/** First line of an error, capped, for a user-facing one-liner. */\nfunction shortErrorMessage(err: unknown): string {\n const msg = err instanceof Error ? err.message : String(err);\n return msg.split(\"\\n\")[0].trim().slice(0, 200);\n}\n\n/**\n * Lists workspace resources of a flat-listable type via the SDK, stopping at\n * MAX_PICKER_RESULTS so pagination doesn't drain a huge workspace. Returns an\n * empty listing on any failure (unknown type, auth/config error, network) so\n * the caller can fall back to free-text entry. `clientFactory` is injectable\n * for tests.\n */\nexport async function listWorkspaceResources(\n resourceType: string,\n profile?: string,\n clientFactory: (profile?: string) => WorkspaceClient = makeWorkspaceClient,\n): Promise<WorkspaceListing> {\n const lister = SDK_LISTERS[resourceType];\n if (!lister) return { choices: [], truncated: false };\n try {\n const client = clientFactory(profile);\n const choices: WorkspaceChoice[] = [];\n let truncated = false;\n for await (const item of lister.list(client)) {\n if (typeof item !== \"object\" || item === null) continue;\n const choice = lister.toChoice(item as Record<string, unknown>);\n if (!choice) continue;\n choices.push(choice);\n if (choices.length >= MAX_PICKER_RESULTS) {\n // Stop iterating — halts the async iterator, so no further pages fetch.\n truncated = true;\n break;\n }\n }\n return { choices, truncated };\n } catch (err) {\n // Don't swallow silently: return the reason so the caller can tell the user\n // the picker fell back because listing failed (typically auth/profile), not\n // because the workspace has none of this resource.\n return { choices: [], truncated: false, error: shortErrorMessage(err) };\n }\n}\n\n/** Runs a databricks CLI subcommand returning JSON; injectable for tests. */\nexport type CliRunner = (args: string[]) => {\n status: number | null;\n stdout: string;\n};\n\nconst defaultRunner: CliRunner = (args) => {\n // Parent-context lists can be large; raise maxBuffer well above the 1MB\n // default so a big JSON response isn't truncated into \"no resources found\".\n const res = spawnSync(\"databricks\", args, {\n encoding: \"utf-8\",\n maxBuffer: 64 * 1024 * 1024,\n });\n return { status: res.status, stdout: res.stdout ?? \"\" };\n};\n\n/**\n * Extracts `{value,label}` choices from a parsed CLI list response. The CLI\n * returns either a bare array or an object wrapping one; we scan for the first\n * array of objects. Items missing the id field are skipped.\n */\nexport function toChoices(\n parsed: unknown,\n idField: string,\n labelField?: string,\n): WorkspaceChoice[] {\n const arr = firstArray(parsed);\n const choices: WorkspaceChoice[] = [];\n for (const item of arr) {\n if (typeof item !== \"object\" || item === null) continue;\n const choice = choiceFrom(\n item as Record<string, unknown>,\n idField,\n labelField,\n );\n if (choice) choices.push(choice);\n }\n return choices;\n}\n\n/** Finds the first array in a CLI response (bare array or single wrapper key). */\nfunction firstArray(parsed: unknown): unknown[] {\n if (Array.isArray(parsed)) return parsed;\n if (parsed && typeof parsed === \"object\") {\n for (const v of Object.values(parsed)) {\n if (Array.isArray(v)) return v;\n }\n }\n return [];\n}\n\n/**\n * Runs a `databricks … list -o json` command and returns parsed choices, or\n * [] on any failure (CLI missing/errored, empty, non-JSON). `command` is the\n * argv after `databricks`; `-o json` and `-p <profile>` are appended.\n * Used for the parent-context drill-down (catalogs/schemas/scopes/endpoints).\n */\nexport function runList(\n command: string[],\n idField: string,\n labelField: string | undefined,\n profile: string | undefined,\n runner: CliRunner = defaultRunner,\n): WorkspaceChoice[] {\n const args = [...command, \"-o\", \"json\"];\n if (profile) args.push(\"-p\", profile);\n\n let result: { status: number | null; stdout: string };\n try {\n result = runner(args);\n } catch {\n return [];\n }\n if (result.status !== 0 || !result.stdout.trim()) return [];\n\n let parsed: unknown;\n try {\n parsed = JSON.parse(result.stdout);\n } catch {\n return [];\n }\n return toChoices(parsed, idField, labelField);\n}\n\n/**\n * A drill-down step for a parent-context resource type. `list(parents)` builds\n * the CLI argv given the values picked in prior steps (e.g. [catalog] → schema\n * list command). `key` labels the step for prompts.\n */\nexport interface ParentContextStep {\n key: string;\n list: (parents: string[]) => {\n command: string[];\n idField: string;\n labelField?: string;\n };\n}\n\n/**\n * Drill-down chains for parent-context resource types. Each ends by listing\n * the resource itself; earlier steps list the parents to pick first.\n * Positional-arg CLI gotcha: `databricks schemas list <CATALOG>` etc. take the\n * parent as a positional, not a flag.\n */\nexport const PARENT_CONTEXT_CHAINS: Record<string, ParentContextStep[]> = {\n volume: [\n {\n key: \"catalog\",\n list: () => ({\n command: [\"catalogs\", \"list\"],\n idField: \"name\",\n labelField: \"name\",\n }),\n },\n {\n key: \"schema\",\n list: ([catalog]) => ({\n command: [\"schemas\", \"list\", catalog],\n idField: \"name\",\n labelField: \"name\",\n }),\n },\n {\n key: \"volume\",\n list: ([catalog, schema]) => ({\n command: [\"volumes\", \"list\", catalog, schema],\n idField: \"full_name\",\n labelField: \"name\",\n }),\n },\n ],\n uc_function: [\n {\n key: \"catalog\",\n list: () => ({\n command: [\"catalogs\", \"list\"],\n idField: \"name\",\n labelField: \"name\",\n }),\n },\n {\n key: \"schema\",\n list: ([catalog]) => ({\n command: [\"schemas\", \"list\", catalog],\n idField: \"name\",\n labelField: \"name\",\n }),\n },\n {\n key: \"function\",\n list: ([catalog, schema]) => ({\n command: [\"functions\", \"list\", catalog, schema],\n idField: \"full_name\",\n labelField: \"name\",\n }),\n },\n ],\n secret: [\n {\n key: \"scope\",\n list: () => ({\n command: [\"secrets\", \"list-scopes\"],\n idField: \"name\",\n labelField: \"name\",\n }),\n },\n {\n key: \"key\",\n list: ([scope]) => ({\n command: [\"secrets\", \"list-secrets\", scope],\n idField: \"key\",\n labelField: \"key\",\n }),\n },\n ],\n vector_search_index: [\n {\n key: \"endpoint\",\n list: () => ({\n command: [\"vector-search-endpoints\", \"list-endpoints\"],\n idField: \"name\",\n labelField: \"name\",\n }),\n },\n {\n key: \"index\",\n list: ([endpoint]) => ({\n command: [\"vector-search-indexes\", \"list-indexes\", endpoint],\n idField: \"name\",\n labelField: \"name\",\n }),\n },\n ],\n};\n\n/** True when a resource type needs a parent-context drill-down to list. */\nexport function isParentContext(resourceType: string): boolean {\n return resourceType in PARENT_CONTEXT_CHAINS;\n}\n\n/** One resolved step of a drill-down: the choices to present at this level. */\nexport interface DrillStep {\n key: string;\n choices: WorkspaceChoice[];\n}\n\n/**\n * Lists the choices for a single drill-down step given the values picked so\n * far. Returns [] on failure. The caller drives the interaction (present\n * `choices`, collect a pick, call again with it appended to `parents`).\n */\nexport function listParentContextStep(\n resourceType: string,\n stepIndex: number,\n parents: string[],\n profile?: string,\n runner: CliRunner = defaultRunner,\n): DrillStep | null {\n const chain = PARENT_CONTEXT_CHAINS[resourceType];\n if (!chain || stepIndex >= chain.length) return null;\n const step = chain[stepIndex];\n // Prior picks become positional CLI args; a value starting with `-` would be\n // parsed as a flag, so refuse it (empty step → free-text fallback). Real\n // catalog/schema/scope/endpoint names never start with `-`.\n if (parents.some((p) => p.startsWith(\"-\"))) {\n return { key: step.key, choices: [] };\n }\n const spec = step.list(parents);\n return {\n key: step.key,\n choices: runList(\n spec.command,\n spec.idField,\n spec.labelField,\n profile,\n runner,\n ),\n };\n}\n\n/** Number of drill-down steps for a parent-context type (0 if not one). */\nexport function parentContextDepth(resourceType: string): number {\n return PARENT_CONTEXT_CHAINS[resourceType]?.length ?? 0;\n}\n\n/**\n * Builds the final resource identifier from the values picked across a\n * drill-down. Most types end on a self-qualified id (volume/uc_function list\n * `full_name`; a vector-search index name is already catalog.schema-qualified),\n * so the last pick is the whole answer. A `secret` is addressed by both its\n * scope and key (`scope/key`) — returning only the key drops the scope and\n * yields a value that can't locate the secret — so its picks are joined.\n */\nexport function composeResourceId(\n resourceType: string,\n picks: string[],\n): string {\n if (resourceType === \"secret\") return picks.join(\"/\");\n return picks[picks.length - 1];\n}\n"],"mappings":";;;;;AAsCA,SAAS,WACP,MACA,SACA,YACwB;CACxB,MAAM,KAAK,KAAK;AAChB,KAAI,OAAO,UAAa,OAAO,KAAM,QAAO;CAC5C,MAAM,QAAQ,OAAO,GAAG;CACxB,MAAM,WAAW,aAAa,KAAK,cAAc;AAKjD,QAAO;EAAE;EAAO,OAHd,OAAO,aAAa,YAAY,SAAS,SAAS,IAC9C,GAAG,SAAS,IAAI,MAAM,KACtB;EACiB;;;;;;AAOzB,gBAAgB,SACd,WAGwB;CACxB,IAAI;AACJ,IAAG;EACD,MAAM,EAAE,OAAO,SAAS,MAAM,UAAU,UAAU;AAClD,OAAK,MAAM,QAAQ,SAAS,EAAE,CAAE,OAAM;AACtC,MAAI,QAAQ,SAAS,UAAW;AAChC,cAAY;UACL;;;AAIX,gBAAgB,wBACd,QACwB;AAExB,SADY,MAAM,OAAO,aAAa,uBAAuB,EAAE,CAAC,EACrD,aAAa,EAAE;;;AAI5B,SAAS,mBAAmB,QAAiD;AAC3E,QAAO,SAAS,OAAO,cAAc;EACnC,MAAM,MAAM,MAAM,OAAO,MAAM,gBAC7B,YAAY,EAAE,WAAW,GAAG,EAAE,CAC/B;AACD,SAAO;GAAE,OAAO,IAAI;GAAQ,MAAM,IAAI;GAAe;GACrD;;;AAIJ,MAAa,cAAyC;CACpD,eAAe;EACb,OAAO,MAAM,EAAE,WAAW,mBAAmB,EAAE,CAAC;EAChD,WAAW,MAAM,WAAW,GAAG,MAAM,OAAO;EAC7C;CACD,KAAK;EACH,OAAO,MAAM,EAAE,KAAK,aAAa,EAAE,CAAC;EAEpC,WAAW,MAAM;GACf,MAAM,WAAW,EAAE;AACnB,UAAO,WAAW;IAAE,GAAG;IAAG,MAAM,UAAU;IAAM,EAAE,SAAS,OAAO;;EAErE;CACD,kBAAkB;EAChB,MAAM;EACN,WAAW,MAAM,WAAW,GAAG,QAAQ,OAAO;EAC/C;CACD,eAAe;EACb,OAAO,MAAM,EAAE,YAAY,oBAAoB,EAAE,CAAC;EAClD,WAAW,MAAM,WAAW,GAAG,QAAQ,WAAW;EACnD;CACD,UAAU;EACR,OAAO,MAAM,EAAE,SAAS,0BAA0B,EAAE,CAAC;EACrD,WAAW,MAAM,WAAW,GAAG,QAAQ,OAAO;EAC/C;CACD,aAAa;EACX,MAAM;EACN,WAAW,MAAM,WAAW,GAAG,WAAW,QAAQ;EACnD;CACD,YAAY;EACV,OAAO,MAAM,EAAE,YAAY,oBAAoB,EAAE,CAAC;EAClD,WAAW,MAAM,WAAW,GAAG,gBAAgB,OAAO;EACvD;CACD,KAAK;EACH,OAAO,MAAM,EAAE,KAAK,aAAa,EAAE,CAAC;EACpC,WAAW,MAAM,WAAW,GAAG,QAAQ,OAAO;EAC/C;CACF;;AAGD,SAAgB,eAAe,cAA+B;AAC5D,QAAO,gBAAgB;;;;;;AAOzB,SAAgB,oBAAoB,SAAmC;AACrE,QAAO,sBAAsB,UAAU,EAAE,SAAS,GAAG,EAAE,CAAC;;;;;;;AAQ1D,MAAa,qBAAqB;;AAYlC,SAAS,kBAAkB,KAAsB;AAE/C,SADY,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,EACjD,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,IAAI;;;;;;;;;AAUhD,eAAsB,uBACpB,cACA,SACA,gBAAuD,qBAC5B;CAC3B,MAAM,SAAS,YAAY;AAC3B,KAAI,CAAC,OAAQ,QAAO;EAAE,SAAS,EAAE;EAAE,WAAW;EAAO;AACrD,KAAI;EACF,MAAM,SAAS,cAAc,QAAQ;EACrC,MAAM,UAA6B,EAAE;EACrC,IAAI,YAAY;AAChB,aAAW,MAAM,QAAQ,OAAO,KAAK,OAAO,EAAE;AAC5C,OAAI,OAAO,SAAS,YAAY,SAAS,KAAM;GAC/C,MAAM,SAAS,OAAO,SAAS,KAAgC;AAC/D,OAAI,CAAC,OAAQ;AACb,WAAQ,KAAK,OAAO;AACpB,OAAI,QAAQ,UAAU,oBAAoB;AAExC,gBAAY;AACZ;;;AAGJ,SAAO;GAAE;GAAS;GAAW;UACtB,KAAK;AAIZ,SAAO;GAAE,SAAS,EAAE;GAAE,WAAW;GAAO,OAAO,kBAAkB,IAAI;GAAE;;;AAU3E,MAAM,iBAA4B,SAAS;CAGzC,MAAM,MAAM,UAAU,cAAc,MAAM;EACxC,UAAU;EACV,WAAW,KAAK,OAAO;EACxB,CAAC;AACF,QAAO;EAAE,QAAQ,IAAI;EAAQ,QAAQ,IAAI,UAAU;EAAI;;;;;;;AAQzD,SAAgB,UACd,QACA,SACA,YACmB;CACnB,MAAM,MAAM,WAAW,OAAO;CAC9B,MAAM,UAA6B,EAAE;AACrC,MAAK,MAAM,QAAQ,KAAK;AACtB,MAAI,OAAO,SAAS,YAAY,SAAS,KAAM;EAC/C,MAAM,SAAS,WACb,MACA,SACA,WACD;AACD,MAAI,OAAQ,SAAQ,KAAK,OAAO;;AAElC,QAAO;;;AAIT,SAAS,WAAW,QAA4B;AAC9C,KAAI,MAAM,QAAQ,OAAO,CAAE,QAAO;AAClC,KAAI,UAAU,OAAO,WAAW,UAC9B;OAAK,MAAM,KAAK,OAAO,OAAO,OAAO,CACnC,KAAI,MAAM,QAAQ,EAAE,CAAE,QAAO;;AAGjC,QAAO,EAAE;;;;;;;;AASX,SAAgB,QACd,SACA,SACA,YACA,SACA,SAAoB,eACD;CACnB,MAAM,OAAO;EAAC,GAAG;EAAS;EAAM;EAAO;AACvC,KAAI,QAAS,MAAK,KAAK,MAAM,QAAQ;CAErC,IAAI;AACJ,KAAI;AACF,WAAS,OAAO,KAAK;SACf;AACN,SAAO,EAAE;;AAEX,KAAI,OAAO,WAAW,KAAK,CAAC,OAAO,OAAO,MAAM,CAAE,QAAO,EAAE;CAE3D,IAAI;AACJ,KAAI;AACF,WAAS,KAAK,MAAM,OAAO,OAAO;SAC5B;AACN,SAAO,EAAE;;AAEX,QAAO,UAAU,QAAQ,SAAS,WAAW;;;;;;;;AAuB/C,MAAa,wBAA6D;CACxE,QAAQ;EACN;GACE,KAAK;GACL,aAAa;IACX,SAAS,CAAC,YAAY,OAAO;IAC7B,SAAS;IACT,YAAY;IACb;GACF;EACD;GACE,KAAK;GACL,OAAO,CAAC,cAAc;IACpB,SAAS;KAAC;KAAW;KAAQ;KAAQ;IACrC,SAAS;IACT,YAAY;IACb;GACF;EACD;GACE,KAAK;GACL,OAAO,CAAC,SAAS,aAAa;IAC5B,SAAS;KAAC;KAAW;KAAQ;KAAS;KAAO;IAC7C,SAAS;IACT,YAAY;IACb;GACF;EACF;CACD,aAAa;EACX;GACE,KAAK;GACL,aAAa;IACX,SAAS,CAAC,YAAY,OAAO;IAC7B,SAAS;IACT,YAAY;IACb;GACF;EACD;GACE,KAAK;GACL,OAAO,CAAC,cAAc;IACpB,SAAS;KAAC;KAAW;KAAQ;KAAQ;IACrC,SAAS;IACT,YAAY;IACb;GACF;EACD;GACE,KAAK;GACL,OAAO,CAAC,SAAS,aAAa;IAC5B,SAAS;KAAC;KAAa;KAAQ;KAAS;KAAO;IAC/C,SAAS;IACT,YAAY;IACb;GACF;EACF;CACD,QAAQ,CACN;EACE,KAAK;EACL,aAAa;GACX,SAAS,CAAC,WAAW,cAAc;GACnC,SAAS;GACT,YAAY;GACb;EACF,EACD;EACE,KAAK;EACL,OAAO,CAAC,YAAY;GAClB,SAAS;IAAC;IAAW;IAAgB;IAAM;GAC3C,SAAS;GACT,YAAY;GACb;EACF,CACF;CACD,qBAAqB,CACnB;EACE,KAAK;EACL,aAAa;GACX,SAAS,CAAC,2BAA2B,iBAAiB;GACtD,SAAS;GACT,YAAY;GACb;EACF,EACD;EACE,KAAK;EACL,OAAO,CAAC,eAAe;GACrB,SAAS;IAAC;IAAyB;IAAgB;IAAS;GAC5D,SAAS;GACT,YAAY;GACb;EACF,CACF;CACF;;AAGD,SAAgB,gBAAgB,cAA+B;AAC7D,QAAO,gBAAgB;;;;;;;AAczB,SAAgB,sBACd,cACA,WACA,SACA,SACA,SAAoB,eACF;CAClB,MAAM,QAAQ,sBAAsB;AACpC,KAAI,CAAC,SAAS,aAAa,MAAM,OAAQ,QAAO;CAChD,MAAM,OAAO,MAAM;AAInB,KAAI,QAAQ,MAAM,MAAM,EAAE,WAAW,IAAI,CAAC,CACxC,QAAO;EAAE,KAAK,KAAK;EAAK,SAAS,EAAE;EAAE;CAEvC,MAAM,OAAO,KAAK,KAAK,QAAQ;AAC/B,QAAO;EACL,KAAK,KAAK;EACV,SAAS,QACP,KAAK,SACL,KAAK,SACL,KAAK,YACL,SACA,OACD;EACF;;;AAIH,SAAgB,mBAAmB,cAA8B;AAC/D,QAAO,sBAAsB,eAAe,UAAU;;;;;;;;;;AAWxD,SAAgB,kBACd,cACA,OACQ;AACR,KAAI,iBAAiB,SAAU,QAAO,MAAM,KAAK,IAAI;AACrD,QAAO,MAAM,MAAM,SAAS"}
@@ -1 +1 @@
1
- {"version":3,"file":"genie-chart-inference.js","names":[],"sources":["../../../src/react/genie/genie-chart-inference.ts"],"sourcesContent":["/**\n * ┌─────────────────────────────────────────────────────────────────────┐\n * │ CHART INFERENCE RULES │\n * │ │\n * │ These rules determine what chart type is shown for Genie query │\n * │ results. Modify thresholds and chart type mappings here. │\n * │ │\n * │ Column types are classified from SQL type_name: │\n * │ DATE: DATE, TIMESTAMP, TIMESTAMP_NTZ │\n * │ NUMERIC: DECIMAL, INT, DOUBLE, FLOAT, LONG, etc. │\n * │ STRING: STRING, VARCHAR, CHAR │\n * │ │\n * │ Rules (applied in priority order): │\n * │ │\n * │ SKIP (return null): │\n * │ - < 2 rows │\n * │ - < 2 columns │\n * │ - No numeric columns │\n * │ │\n * │ MATCH: │\n * │ 1. DATE + numeric(s) → line (timeseries) │\n * │ 2. STRING + 1 numeric, ≤7 cats → pie │\n * │ 3. STRING + 1 numeric, ≤100 cats → bar │\n * │ 4. STRING + 1 numeric, >100 cats → line │\n * │ 5. STRING + N numerics, ≤50 cats → bar (grouped) │\n * │ 6. STRING + N numerics, >50 cats → line (multi-series) │\n * │ 7. 2+ numerics only → scatter │\n * │ 8. Otherwise → null (skip) │\n * │ │\n * │ KNOWN LIMITATIONS: │\n * │ - First-column heuristic: picks first string col as category │\n * │ - No semantic understanding (can't tell ID from meaningful val) │\n * └─────────────────────────────────────────────────────────────────────┘\n */\n\nimport type { ChartType } from \"../charts/types\";\nimport type { GenieColumnMeta } from \"./genie-query-transform\";\n\n// ---------------------------------------------------------------------------\n// Configuration — edit thresholds here\n// ---------------------------------------------------------------------------\n\nconst INFERENCE_CONFIG = {\n /** Min rows required to show any chart */\n minRows: 2,\n /** Max unique categories for pie chart */\n pieMaxCategories: 7,\n /** Max unique categories for bar chart (single series) */\n barMaxCategories: 100,\n /** Max unique categories for grouped bar chart (multi series) */\n groupedBarMaxCategories: 50,\n} as const;\n\nexport interface ChartInference {\n chartType: ChartType;\n xKey: string;\n yKey: string | string[];\n}\n\ninterface ClassifiedColumns {\n dateCols: GenieColumnMeta[];\n numericCols: GenieColumnMeta[];\n stringCols: GenieColumnMeta[];\n}\n\nfunction classifyColumns(\n rows: Record<string, unknown>[],\n columns: GenieColumnMeta[],\n): ClassifiedColumns | null {\n if (rows.length < INFERENCE_CONFIG.minRows || columns.length < 2) {\n return null;\n }\n\n const dateCols = columns.filter((c) => c.category === \"date\");\n const numericCols = columns.filter((c) => c.category === \"numeric\");\n const stringCols = columns.filter((c) => c.category === \"string\");\n\n if (numericCols.length === 0) return null;\n\n return { dateCols, numericCols, stringCols };\n}\n\nfunction countUnique(rows: Record<string, unknown>[], key: string): number {\n const seen = new Set<unknown>();\n for (const row of rows) {\n seen.add(row[key]);\n }\n return seen.size;\n}\n\nfunction hasNegativeValues(\n rows: Record<string, unknown>[],\n key: string,\n): boolean {\n for (const row of rows) {\n if (Number(row[key]) < 0) return true;\n }\n return false;\n}\n\n// ---------------------------------------------------------------------------\n// Main inference function\n// ---------------------------------------------------------------------------\n\n/**\n * Infer the best chart type for the given Genie query result.\n * Returns `null` when the data is not suitable for charting.\n */\nexport function inferChartType(\n rows: Record<string, unknown>[],\n columns: GenieColumnMeta[],\n): ChartInference | null {\n const classified = classifyColumns(rows, columns);\n if (!classified) return null;\n\n const { dateCols, numericCols, stringCols } = classified;\n\n // Rule 1: DATE + numeric(s) → line (timeseries)\n if (dateCols.length > 0 && numericCols.length >= 1) {\n return {\n chartType: \"line\",\n xKey: dateCols[0].name,\n yKey:\n numericCols.length === 1\n ? numericCols[0].name\n : numericCols.map((c) => c.name),\n };\n }\n\n // Rules 2–6: STRING + numeric(s)\n if (stringCols.length > 0 && numericCols.length >= 1) {\n const xKey = stringCols[0].name;\n const uniqueCategories = countUnique(rows, xKey);\n\n if (numericCols.length === 1) {\n const yKey = numericCols[0].name;\n\n // Rule 2: few categories → pie (skip if negative values)\n if (\n uniqueCategories <= INFERENCE_CONFIG.pieMaxCategories &&\n !hasNegativeValues(rows, yKey)\n ) {\n return { chartType: \"pie\", xKey, yKey };\n }\n // Rule 3: moderate categories → bar\n if (uniqueCategories <= INFERENCE_CONFIG.barMaxCategories) {\n return { chartType: \"bar\", xKey, yKey };\n }\n // Rule 4: many categories → line\n return { chartType: \"line\", xKey, yKey };\n }\n\n // Multiple numerics\n const yKey = numericCols.map((c) => c.name);\n\n // Rule 5: moderate categories → bar (grouped)\n if (uniqueCategories <= INFERENCE_CONFIG.groupedBarMaxCategories) {\n return { chartType: \"bar\", xKey, yKey };\n }\n // Rule 6: many categories → line (multi-series)\n return { chartType: \"line\", xKey, yKey };\n }\n\n // Rule 7: 2+ numerics only (no string, no date) → scatter\n if (\n numericCols.length >= 2 &&\n stringCols.length === 0 &&\n dateCols.length === 0\n ) {\n return {\n chartType: \"scatter\",\n xKey: numericCols[0].name,\n yKey: numericCols[1].name,\n };\n }\n\n // Rule 8: fallback — no chart\n return null;\n}\n\n/**\n * Return the chart types that are compatible with the given data shape.\n * Used to populate the chart-type selector dropdown.\n */\nexport function getCompatibleChartTypes(\n rows: Record<string, unknown>[],\n columns: GenieColumnMeta[],\n): ChartType[] {\n const classified = classifyColumns(rows, columns);\n if (!classified) return [];\n\n const { dateCols, numericCols, stringCols } = classified;\n\n // DATE + numeric(s) → timeseries-compatible types\n if (dateCols.length > 0 && numericCols.length >= 1) {\n return [\"line\", \"bar\", \"area\"];\n }\n\n // STRING + numeric(s)\n if (stringCols.length > 0 && numericCols.length >= 1) {\n const xKey = stringCols[0].name;\n const uniqueCategories = countUnique(rows, xKey);\n\n if (numericCols.length === 1) {\n const yKey = numericCols[0].name;\n // Few categories and no negatives → pie/donut are viable\n if (\n uniqueCategories <= INFERENCE_CONFIG.pieMaxCategories &&\n !hasNegativeValues(rows, yKey)\n ) {\n return [\"pie\", \"donut\", \"bar\", \"line\", \"area\"];\n }\n return [\"bar\", \"line\", \"area\"];\n }\n\n // Multiple numerics\n return [\"bar\", \"line\", \"area\"];\n }\n\n // 2+ numerics only → scatter-compatible\n if (\n numericCols.length >= 2 &&\n stringCols.length === 0 &&\n dateCols.length === 0\n ) {\n return [\"scatter\", \"line\", \"area\"];\n }\n\n return [];\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"genie-chart-inference.js","names":[],"sources":["../../../src/react/genie/genie-chart-inference.ts"],"sourcesContent":["/**\n * ┌─────────────────────────────────────────────────────────────────────┐\n * │ CHART INFERENCE RULES │\n * │ │\n * │ These rules determine what chart type is shown for Genie query │\n * │ results. Modify thresholds and chart type mappings here. │\n * │ │\n * │ Column types are classified from SQL typeName: │\n * │ DATE: DATE, TIMESTAMP, TIMESTAMP_NTZ │\n * │ NUMERIC: DECIMAL, INT, DOUBLE, FLOAT, LONG, etc. │\n * │ STRING: STRING, VARCHAR, CHAR │\n * │ │\n * │ Rules (applied in priority order): │\n * │ │\n * │ SKIP (return null): │\n * │ - < 2 rows │\n * │ - < 2 columns │\n * │ - No numeric columns │\n * │ │\n * │ MATCH: │\n * │ 1. DATE + numeric(s) → line (timeseries) │\n * │ 2. STRING + 1 numeric, ≤7 cats → pie │\n * │ 3. STRING + 1 numeric, ≤100 cats → bar │\n * │ 4. STRING + 1 numeric, >100 cats → line │\n * │ 5. STRING + N numerics, ≤50 cats → bar (grouped) │\n * │ 6. STRING + N numerics, >50 cats → line (multi-series) │\n * │ 7. 2+ numerics only → scatter │\n * │ 8. Otherwise → null (skip) │\n * │ │\n * │ KNOWN LIMITATIONS: │\n * │ - First-column heuristic: picks first string col as category │\n * │ - No semantic understanding (can't tell ID from meaningful val) │\n * └─────────────────────────────────────────────────────────────────────┘\n */\n\nimport type { ChartType } from \"../charts/types\";\nimport type { GenieColumnMeta } from \"./genie-query-transform\";\n\n// ---------------------------------------------------------------------------\n// Configuration — edit thresholds here\n// ---------------------------------------------------------------------------\n\nconst INFERENCE_CONFIG = {\n /** Min rows required to show any chart */\n minRows: 2,\n /** Max unique categories for pie chart */\n pieMaxCategories: 7,\n /** Max unique categories for bar chart (single series) */\n barMaxCategories: 100,\n /** Max unique categories for grouped bar chart (multi series) */\n groupedBarMaxCategories: 50,\n} as const;\n\nexport interface ChartInference {\n chartType: ChartType;\n xKey: string;\n yKey: string | string[];\n}\n\ninterface ClassifiedColumns {\n dateCols: GenieColumnMeta[];\n numericCols: GenieColumnMeta[];\n stringCols: GenieColumnMeta[];\n}\n\nfunction classifyColumns(\n rows: Record<string, unknown>[],\n columns: GenieColumnMeta[],\n): ClassifiedColumns | null {\n if (rows.length < INFERENCE_CONFIG.minRows || columns.length < 2) {\n return null;\n }\n\n const dateCols = columns.filter((c) => c.category === \"date\");\n const numericCols = columns.filter((c) => c.category === \"numeric\");\n const stringCols = columns.filter((c) => c.category === \"string\");\n\n if (numericCols.length === 0) return null;\n\n return { dateCols, numericCols, stringCols };\n}\n\nfunction countUnique(rows: Record<string, unknown>[], key: string): number {\n const seen = new Set<unknown>();\n for (const row of rows) {\n seen.add(row[key]);\n }\n return seen.size;\n}\n\nfunction hasNegativeValues(\n rows: Record<string, unknown>[],\n key: string,\n): boolean {\n for (const row of rows) {\n if (Number(row[key]) < 0) return true;\n }\n return false;\n}\n\n// ---------------------------------------------------------------------------\n// Main inference function\n// ---------------------------------------------------------------------------\n\n/**\n * Infer the best chart type for the given Genie query result.\n * Returns `null` when the data is not suitable for charting.\n */\nexport function inferChartType(\n rows: Record<string, unknown>[],\n columns: GenieColumnMeta[],\n): ChartInference | null {\n const classified = classifyColumns(rows, columns);\n if (!classified) return null;\n\n const { dateCols, numericCols, stringCols } = classified;\n\n // Rule 1: DATE + numeric(s) → line (timeseries)\n if (dateCols.length > 0 && numericCols.length >= 1) {\n return {\n chartType: \"line\",\n xKey: dateCols[0].name,\n yKey:\n numericCols.length === 1\n ? numericCols[0].name\n : numericCols.map((c) => c.name),\n };\n }\n\n // Rules 2–6: STRING + numeric(s)\n if (stringCols.length > 0 && numericCols.length >= 1) {\n const xKey = stringCols[0].name;\n const uniqueCategories = countUnique(rows, xKey);\n\n if (numericCols.length === 1) {\n const yKey = numericCols[0].name;\n\n // Rule 2: few categories → pie (skip if negative values)\n if (\n uniqueCategories <= INFERENCE_CONFIG.pieMaxCategories &&\n !hasNegativeValues(rows, yKey)\n ) {\n return { chartType: \"pie\", xKey, yKey };\n }\n // Rule 3: moderate categories → bar\n if (uniqueCategories <= INFERENCE_CONFIG.barMaxCategories) {\n return { chartType: \"bar\", xKey, yKey };\n }\n // Rule 4: many categories → line\n return { chartType: \"line\", xKey, yKey };\n }\n\n // Multiple numerics\n const yKey = numericCols.map((c) => c.name);\n\n // Rule 5: moderate categories → bar (grouped)\n if (uniqueCategories <= INFERENCE_CONFIG.groupedBarMaxCategories) {\n return { chartType: \"bar\", xKey, yKey };\n }\n // Rule 6: many categories → line (multi-series)\n return { chartType: \"line\", xKey, yKey };\n }\n\n // Rule 7: 2+ numerics only (no string, no date) → scatter\n if (\n numericCols.length >= 2 &&\n stringCols.length === 0 &&\n dateCols.length === 0\n ) {\n return {\n chartType: \"scatter\",\n xKey: numericCols[0].name,\n yKey: numericCols[1].name,\n };\n }\n\n // Rule 8: fallback — no chart\n return null;\n}\n\n/**\n * Return the chart types that are compatible with the given data shape.\n * Used to populate the chart-type selector dropdown.\n */\nexport function getCompatibleChartTypes(\n rows: Record<string, unknown>[],\n columns: GenieColumnMeta[],\n): ChartType[] {\n const classified = classifyColumns(rows, columns);\n if (!classified) return [];\n\n const { dateCols, numericCols, stringCols } = classified;\n\n // DATE + numeric(s) → timeseries-compatible types\n if (dateCols.length > 0 && numericCols.length >= 1) {\n return [\"line\", \"bar\", \"area\"];\n }\n\n // STRING + numeric(s)\n if (stringCols.length > 0 && numericCols.length >= 1) {\n const xKey = stringCols[0].name;\n const uniqueCategories = countUnique(rows, xKey);\n\n if (numericCols.length === 1) {\n const yKey = numericCols[0].name;\n // Few categories and no negatives → pie/donut are viable\n if (\n uniqueCategories <= INFERENCE_CONFIG.pieMaxCategories &&\n !hasNegativeValues(rows, yKey)\n ) {\n return [\"pie\", \"donut\", \"bar\", \"line\", \"area\"];\n }\n return [\"bar\", \"line\", \"area\"];\n }\n\n // Multiple numerics\n return [\"bar\", \"line\", \"area\"];\n }\n\n // 2+ numerics only → scatter-compatible\n if (\n numericCols.length >= 2 &&\n stringCols.length === 0 &&\n dateCols.length === 0\n ) {\n return [\"scatter\", \"line\", \"area\"];\n }\n\n return [];\n}\n"],"mappings":"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"}
@@ -18,11 +18,14 @@ interface TransformedGenieData {
18
18
  * Expects `data` to have the shape:
19
19
  * ```
20
20
  * {
21
- * manifest: { schema: { columns: [{ name, type_name }, ...] } },
22
- * result: { data_array: [["val", ...], ...] }
21
+ * manifest: { schema: { columns: [{ name, typeName }, ...] } },
22
+ * result: { dataArray: [["val", ...], ...] }
23
23
  * }
24
24
  * ```
25
25
  *
26
+ * The legacy snake_case shape (`type_name`, `data_array`) is also accepted, so
27
+ * this keeps working against servers that predate the modular SDK migration.
28
+ *
26
29
  * Returns `null` when the data is empty or malformed.
27
30
  */
28
31
  declare function transformGenieData(data: GenieStatementResponse | null | undefined): TransformedGenieData | null;
@@ -1 +1 @@
1
- {"version":3,"file":"genie-query-transform.d.ts","names":[],"sources":["../../../src/react/genie/genie-query-transform.ts"],"mappings":";;;;KA8BY,cAAA;AAAA,UAEK,eAAA;EACf,IAAA;EACA,QAAA;EACA,QAAA,EAAU,cAAA;AAAA;AAAA,UAGK,oBAAA;EACf,IAAA,EAAM,MAAA;EACN,OAAA,EAAS,eAAA;AAAA;;;;;;AAuCX;;;;;;;;iBAAgB,kBAAA,CACd,IAAA,EAAM,sBAAA,sBACL,oBAAA"}
1
+ {"version":3,"file":"genie-query-transform.d.ts","names":[],"sources":["../../../src/react/genie/genie-query-transform.ts"],"mappings":";;;;KA8BY,cAAA;AAAA,UAEK,eAAA;EACf,IAAA;EACA,QAAA;EACA,QAAA,EAAU,cAAA;AAAA;AAAA,UAGK,oBAAA;EACf,IAAA,EAAM,MAAA;EACN,OAAA,EAAS,eAAA;AAAA;;;;;;AA0CX;;;;;;;;;;;iBAAgB,kBAAA,CACd,IAAA,EAAM,sBAAA,sBACL,oBAAA"}
@@ -43,24 +43,30 @@ function parseValue(raw, category) {
43
43
  * Expects `data` to have the shape:
44
44
  * ```
45
45
  * {
46
- * manifest: { schema: { columns: [{ name, type_name }, ...] } },
47
- * result: { data_array: [["val", ...], ...] }
46
+ * manifest: { schema: { columns: [{ name, typeName }, ...] } },
47
+ * result: { dataArray: [["val", ...], ...] }
48
48
  * }
49
49
  * ```
50
50
  *
51
+ * The legacy snake_case shape (`type_name`, `data_array`) is also accepted, so
52
+ * this keeps working against servers that predate the modular SDK migration.
53
+ *
51
54
  * Returns `null` when the data is empty or malformed.
52
55
  */
53
56
  function transformGenieData(data) {
54
57
  if (!data) return null;
55
58
  const rawColumns = data.manifest?.schema?.columns;
56
59
  if (!rawColumns || rawColumns.length === 0) return null;
57
- const dataArray = data.result?.data_array;
60
+ const dataArray = data.result?.dataArray ?? data.result?.data_array;
58
61
  if (!dataArray || dataArray.length === 0) return null;
59
- const columns = rawColumns.map((col) => ({
60
- name: col.name,
61
- typeName: col.type_name,
62
- category: classifySqlType(col.type_name)
63
- }));
62
+ const columns = rawColumns.map((col) => {
63
+ const typeName = col.typeName ?? col.type_name ?? "";
64
+ return {
65
+ name: col.name,
66
+ typeName,
67
+ category: classifySqlType(typeName)
68
+ };
69
+ });
64
70
  return {
65
71
  rows: dataArray.map((row) => {
66
72
  const record = {};
@@ -1 +1 @@
1
- {"version":3,"file":"genie-query-transform.js","names":[],"sources":["../../../src/react/genie/genie-query-transform.ts"],"sourcesContent":["/**\n * Converts Genie's statement_response data into a flat record array\n * suitable for charting.\n *\n * The Genie API returns `{ manifest.schema.columns, result.data_array }`\n * where each column carries a SQL `type_name`. This module parses values\n * according to those types so downstream chart code receives proper\n * numbers and strings.\n */\n\nimport type { GenieStatementResponse } from \"shared\";\n\n// SQL type_name values that map to numeric JS values\nconst NUMERIC_SQL_TYPES = new Set([\n \"DECIMAL\",\n \"INT\",\n \"INTEGER\",\n \"BIGINT\",\n \"LONG\",\n \"SMALLINT\",\n \"TINYINT\",\n \"FLOAT\",\n \"DOUBLE\",\n \"SHORT\",\n \"BYTE\",\n]);\n\n// SQL type_name values that map to date/timestamp strings\nconst DATE_SQL_TYPES = new Set([\"DATE\", \"TIMESTAMP\", \"TIMESTAMP_NTZ\"]);\n\nexport type ColumnCategory = \"numeric\" | \"date\" | \"string\";\n\nexport interface GenieColumnMeta {\n name: string;\n typeName: string;\n category: ColumnCategory;\n}\n\nexport interface TransformedGenieData {\n rows: Record<string, unknown>[];\n columns: GenieColumnMeta[];\n}\n\n/**\n * Classify a SQL type_name into a high-level category.\n */\nexport function classifySqlType(typeName: string): ColumnCategory {\n const upper = typeName.toUpperCase();\n if (NUMERIC_SQL_TYPES.has(upper)) return \"numeric\";\n if (DATE_SQL_TYPES.has(upper)) return \"date\";\n return \"string\";\n}\n\n/**\n * Parse a single cell value based on its column category.\n */\nfunction parseValue(raw: string | null, category: ColumnCategory): unknown {\n if (raw == null) return null;\n if (category === \"numeric\") {\n const n = Number(raw);\n return Number.isNaN(n) ? null : n;\n }\n // Dates and strings stay as strings — normalizeChartData detects ISO dates\n return raw;\n}\n\n/**\n * Transform a Genie statement_response into chart-ready rows + column metadata.\n *\n * Expects `data` to have the shape:\n * ```\n * {\n * manifest: { schema: { columns: [{ name, type_name }, ...] } },\n * result: { data_array: [[\"val\", ...], ...] }\n * }\n * ```\n *\n * Returns `null` when the data is empty or malformed.\n */\nexport function transformGenieData(\n data: GenieStatementResponse | null | undefined,\n): TransformedGenieData | null {\n if (!data) return null;\n\n const rawColumns = data.manifest?.schema?.columns;\n if (!rawColumns || rawColumns.length === 0) {\n return null;\n }\n\n const dataArray = data.result?.data_array;\n if (!dataArray || dataArray.length === 0) {\n return null;\n }\n\n const columns: GenieColumnMeta[] = rawColumns.map((col) => ({\n name: col.name,\n typeName: col.type_name,\n category: classifySqlType(col.type_name),\n }));\n\n const rows: Record<string, unknown>[] = dataArray.map((row) => {\n const record: Record<string, unknown> = {};\n for (let i = 0; i < columns.length; i++) {\n const col = columns[i];\n record[col.name] = parseValue(row[i] ?? null, col.category);\n }\n return record;\n });\n\n return { rows, columns };\n}\n"],"mappings":";AAaA,MAAM,oBAAoB,IAAI,IAAI;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAGF,MAAM,iBAAiB,IAAI,IAAI;CAAC;CAAQ;CAAa;CAAgB,CAAC;;;;AAkBtE,SAAgB,gBAAgB,UAAkC;CAChE,MAAM,QAAQ,SAAS,aAAa;AACpC,KAAI,kBAAkB,IAAI,MAAM,CAAE,QAAO;AACzC,KAAI,eAAe,IAAI,MAAM,CAAE,QAAO;AACtC,QAAO;;;;;AAMT,SAAS,WAAW,KAAoB,UAAmC;AACzE,KAAI,OAAO,KAAM,QAAO;AACxB,KAAI,aAAa,WAAW;EAC1B,MAAM,IAAI,OAAO,IAAI;AACrB,SAAO,OAAO,MAAM,EAAE,GAAG,OAAO;;AAGlC,QAAO;;;;;;;;;;;;;;;AAgBT,SAAgB,mBACd,MAC6B;AAC7B,KAAI,CAAC,KAAM,QAAO;CAElB,MAAM,aAAa,KAAK,UAAU,QAAQ;AAC1C,KAAI,CAAC,cAAc,WAAW,WAAW,EACvC,QAAO;CAGT,MAAM,YAAY,KAAK,QAAQ;AAC/B,KAAI,CAAC,aAAa,UAAU,WAAW,EACrC,QAAO;CAGT,MAAM,UAA6B,WAAW,KAAK,SAAS;EAC1D,MAAM,IAAI;EACV,UAAU,IAAI;EACd,UAAU,gBAAgB,IAAI,UAAU;EACzC,EAAE;AAWH,QAAO;EAAE,MAT+B,UAAU,KAAK,QAAQ;GAC7D,MAAM,SAAkC,EAAE;AAC1C,QAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;IACvC,MAAM,MAAM,QAAQ;AACpB,WAAO,IAAI,QAAQ,WAAW,IAAI,MAAM,MAAM,IAAI,SAAS;;AAE7D,UAAO;IACP;EAEa;EAAS"}
1
+ {"version":3,"file":"genie-query-transform.js","names":[],"sources":["../../../src/react/genie/genie-query-transform.ts"],"sourcesContent":["/**\n * Converts Genie's statement_response data into a flat record array\n * suitable for charting.\n *\n * The Genie API returns `{ manifest.schema.columns, result.dataArray }`\n * where each column carries a SQL `typeName`. This module parses values\n * according to those types so downstream chart code receives proper\n * numbers and strings.\n */\n\nimport type { GenieStatementResponse } from \"shared\";\n\n// SQL type_name values that map to numeric JS values\nconst NUMERIC_SQL_TYPES = new Set([\n \"DECIMAL\",\n \"INT\",\n \"INTEGER\",\n \"BIGINT\",\n \"LONG\",\n \"SMALLINT\",\n \"TINYINT\",\n \"FLOAT\",\n \"DOUBLE\",\n \"SHORT\",\n \"BYTE\",\n]);\n\n// SQL type_name values that map to date/timestamp strings\nconst DATE_SQL_TYPES = new Set([\"DATE\", \"TIMESTAMP\", \"TIMESTAMP_NTZ\"]);\n\nexport type ColumnCategory = \"numeric\" | \"date\" | \"string\";\n\nexport interface GenieColumnMeta {\n name: string;\n typeName: string;\n category: ColumnCategory;\n}\n\nexport interface TransformedGenieData {\n rows: Record<string, unknown>[];\n columns: GenieColumnMeta[];\n}\n\n/**\n * Classify a SQL type_name into a high-level category.\n */\nexport function classifySqlType(typeName: string): ColumnCategory {\n const upper = typeName.toUpperCase();\n if (NUMERIC_SQL_TYPES.has(upper)) return \"numeric\";\n if (DATE_SQL_TYPES.has(upper)) return \"date\";\n return \"string\";\n}\n\n/**\n * Parse a single cell value based on its column category.\n */\nfunction parseValue(raw: string | null, category: ColumnCategory): unknown {\n if (raw == null) return null;\n if (category === \"numeric\") {\n const n = Number(raw);\n return Number.isNaN(n) ? null : n;\n }\n // Dates and strings stay as strings — normalizeChartData detects ISO dates\n return raw;\n}\n\n/**\n * Transform a Genie statement_response into chart-ready rows + column metadata.\n *\n * Expects `data` to have the shape:\n * ```\n * {\n * manifest: { schema: { columns: [{ name, typeName }, ...] } },\n * result: { dataArray: [[\"val\", ...], ...] }\n * }\n * ```\n *\n * The legacy snake_case shape (`type_name`, `data_array`) is also accepted, so\n * this keeps working against servers that predate the modular SDK migration.\n *\n * Returns `null` when the data is empty or malformed.\n */\nexport function transformGenieData(\n data: GenieStatementResponse | null | undefined,\n): TransformedGenieData | null {\n if (!data) return null;\n\n const rawColumns = data.manifest?.schema?.columns;\n if (!rawColumns || rawColumns.length === 0) {\n return null;\n }\n\n const dataArray = data.result?.dataArray ?? data.result?.data_array;\n if (!dataArray || dataArray.length === 0) {\n return null;\n }\n\n const columns: GenieColumnMeta[] = rawColumns.map((col) => {\n const typeName = col.typeName ?? col.type_name ?? \"\";\n return { name: col.name, typeName, category: classifySqlType(typeName) };\n });\n\n const rows: Record<string, unknown>[] = dataArray.map((row) => {\n const record: Record<string, unknown> = {};\n for (let i = 0; i < columns.length; i++) {\n const col = columns[i];\n record[col.name] = parseValue(row[i] ?? null, col.category);\n }\n return record;\n });\n\n return { rows, columns };\n}\n"],"mappings":";AAaA,MAAM,oBAAoB,IAAI,IAAI;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAGF,MAAM,iBAAiB,IAAI,IAAI;CAAC;CAAQ;CAAa;CAAgB,CAAC;;;;AAkBtE,SAAgB,gBAAgB,UAAkC;CAChE,MAAM,QAAQ,SAAS,aAAa;AACpC,KAAI,kBAAkB,IAAI,MAAM,CAAE,QAAO;AACzC,KAAI,eAAe,IAAI,MAAM,CAAE,QAAO;AACtC,QAAO;;;;;AAMT,SAAS,WAAW,KAAoB,UAAmC;AACzE,KAAI,OAAO,KAAM,QAAO;AACxB,KAAI,aAAa,WAAW;EAC1B,MAAM,IAAI,OAAO,IAAI;AACrB,SAAO,OAAO,MAAM,EAAE,GAAG,OAAO;;AAGlC,QAAO;;;;;;;;;;;;;;;;;;AAmBT,SAAgB,mBACd,MAC6B;AAC7B,KAAI,CAAC,KAAM,QAAO;CAElB,MAAM,aAAa,KAAK,UAAU,QAAQ;AAC1C,KAAI,CAAC,cAAc,WAAW,WAAW,EACvC,QAAO;CAGT,MAAM,YAAY,KAAK,QAAQ,aAAa,KAAK,QAAQ;AACzD,KAAI,CAAC,aAAa,UAAU,WAAW,EACrC,QAAO;CAGT,MAAM,UAA6B,WAAW,KAAK,QAAQ;EACzD,MAAM,WAAW,IAAI,YAAY,IAAI,aAAa;AAClD,SAAO;GAAE,MAAM,IAAI;GAAM;GAAU,UAAU,gBAAgB,SAAS;GAAE;GACxE;AAWF,QAAO;EAAE,MAT+B,UAAU,KAAK,QAAQ;GAC7D,MAAM,SAAkC,EAAE;AAC1C,QAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;IACvC,MAAM,MAAM,QAAQ;AACpB,WAAO,IAAI,QAAQ,WAAW,IAAI,MAAM,MAAM,IAAI,SAAS;;AAE7D,UAAO;IACP;EAEa;EAAS"}
@@ -12,6 +12,7 @@ import { getCoreRowModel, getFilteredRowModel, getPaginationRowModel, getSortedR
12
12
 
13
13
  //#region src/react/table/table-wrapper.tsx
14
14
  const CHECKBOX_COLUMN_WIDTH = 40;
15
+ const EMPTY_DATA = [];
15
16
  /**
16
17
  * Wrapper component for tables with automatic data fetching and state management
17
18
  * This component handles:
@@ -50,7 +51,11 @@ function TableWrapper(props) {
50
51
  enableRowSelection
51
52
  ]);
52
53
  const hasData = data && data.length > 0;
53
- const processedData = hasData ? transformer ? transformer(data) : data : [];
54
+ const processedData = useMemo(() => hasData ? transformer ? transformer(data) : data : EMPTY_DATA, [
55
+ hasData,
56
+ data,
57
+ transformer
58
+ ]);
54
59
  const table = useReactTable({
55
60
  data: processedData,
56
61
  columns: useMemo(() => {
@@ -1 +1 @@
1
- {"version":3,"file":"table-wrapper.js","names":[],"sources":["../../../src/react/table/table-wrapper.tsx"],"sourcesContent":["import {\n type Column,\n type ColumnFiltersState,\n getCoreRowModel,\n getFilteredRowModel,\n getPaginationRowModel,\n getSortedRowModel,\n type Row,\n type RowSelectionState,\n type SortingState,\n type Table,\n useReactTable,\n type VisibilityState,\n} from \"@tanstack/react-table\";\nimport { ArrowUpDown } from \"lucide-react\";\nimport { useEffect, useMemo, useState } from \"react\";\n\nimport { useAnalyticsQuery } from \"..\";\nimport {\n formatChartValue,\n formatFieldLabel,\n SAFE_KEY_REGEX,\n} from \"../lib/format\";\nimport { Button } from \"../ui/button\";\nimport { Checkbox } from \"../ui/checkbox\";\nimport { EmptyState } from \"./empty\";\nimport { ErrorState } from \"./error\";\nimport { LoadingSkeleton } from \"./loading\";\nimport type { TableWrapperProps } from \"./types\";\n\nconst CHECKBOX_COLUMN_WIDTH = 40;\n\n/**\n * Wrapper component for tables with automatic data fetching and state management\n * This component handles:\n * - Data fetching via useAnalyticsQuery\n * - Loading, error, and empty states with proper UI components\n * - Data transformation (optional)\n * - Dynamic column generation from data structure\n * - TanStack Table instance creation with all features (sorting, filtering, pagination, etc.)\n *\n * @template TRaw - The raw data type returned by the analytics query\n * @template TProcessed - The processed data type after transformation\n *\n * @param props - Props for the TableWrapper component\n * @param props.queryKey - The query key to fetch the data\n * @param props.parameters - The parameters to pass to the query\n * @param props.transformer - Optional function to transform raw data before creating table\n * @param props.children - Render function that receives the TanStack Table instance\n * @param props.className - Optional CSS class name for the wrapper\n * @param props.ariaLabel - Optional accessibility label\n * @param props.testId - Optional test ID for testing\n *\n * @returns The rendered table with state management\n */\nexport function TableWrapper<TRaw = any, TProcessed = any>(\n props: TableWrapperProps<TRaw, TProcessed>,\n) {\n const {\n queryKey,\n parameters,\n transformer,\n children,\n className,\n ariaLabel,\n testId,\n enableRowSelection = false,\n onRowSelectionChange,\n pageSize = 10,\n } = props;\n\n const [sorting, setSorting] = useState<SortingState>([]);\n const [columnFilters, setColumnFilters] = useState<ColumnFiltersState>([]);\n const [columnVisibility, setColumnVisibility] = useState<VisibilityState>({});\n const [rowSelection, setRowSelection] = useState<RowSelectionState>({});\n\n const { data, loading, error } = useAnalyticsQuery<TRaw[]>(\n queryKey,\n parameters,\n );\n\n useEffect(() => {\n if (onRowSelectionChange && enableRowSelection) {\n onRowSelectionChange(rowSelection);\n }\n }, [rowSelection, onRowSelectionChange, enableRowSelection]);\n\n const hasData = data && data.length > 0;\n\n const processedData = hasData\n ? transformer\n ? transformer(data)\n : (data as unknown as TProcessed[])\n : [];\n\n const tableColumns = useMemo(() => {\n if (!hasData) return [];\n\n if (!processedData[0] || typeof processedData[0] !== \"object\") {\n console.warn(\"Invalid data format for DataTable\");\n return [];\n }\n\n const dataColumns = Object.keys(processedData[0] as object)\n .filter((key) => SAFE_KEY_REGEX.test(key))\n .map((key) => {\n const formattedLabel = formatFieldLabel(key);\n return {\n accessorKey: key,\n header: ({ column }: { column: Column<TProcessed> }) => {\n return (\n <Button\n variant=\"ghost\"\n onClick={() =>\n column.toggleSorting(column.getIsSorted() === \"asc\")\n }\n className=\"h-8 px-2\"\n >\n {formattedLabel}\n <ArrowUpDown className=\"ml-2 h-4 w-4\" />\n </Button>\n );\n },\n cell: ({ row }: { row: Row<TProcessed> }) => {\n const value = row.getValue(key);\n if (typeof value === \"number\" || Number.isFinite(Number(value))) {\n return (\n <div className=\"text-right font-mono\">\n {formatChartValue(Number(value), key)}\n </div>\n );\n }\n return <div>{String(value)}</div>;\n },\n };\n });\n\n if (enableRowSelection) {\n return [\n {\n id: \"select\",\n maxSize: CHECKBOX_COLUMN_WIDTH,\n minSize: CHECKBOX_COLUMN_WIDTH,\n header: ({ table }: { table: Table<TProcessed> }) => (\n <div className=\"flex items-center justify-center\">\n <Checkbox\n checked={\n table.getIsAllPageRowsSelected() ||\n (table.getIsSomePageRowsSelected() && \"indeterminate\")\n }\n onCheckedChange={(value) =>\n table.toggleAllPageRowsSelected(!!value)\n }\n aria-label=\"Select all\"\n />\n </div>\n ),\n cell: ({ row }: { row: Row<TProcessed> }) => (\n <div className=\"flex items-center justify-center\">\n <Checkbox\n checked={row.getIsSelected()}\n onCheckedChange={(value) => row.toggleSelected(!!value)}\n aria-label=\"Select row\"\n />\n </div>\n ),\n enableSorting: false,\n enableHiding: false,\n },\n ...dataColumns,\n ];\n }\n\n return dataColumns;\n }, [hasData, processedData, enableRowSelection]);\n\n const table = useReactTable({\n data: processedData,\n columns: tableColumns,\n onSortingChange: setSorting,\n onColumnFiltersChange: setColumnFilters,\n getCoreRowModel: getCoreRowModel(),\n getPaginationRowModel: getPaginationRowModel(),\n getSortedRowModel: getSortedRowModel(),\n getFilteredRowModel: getFilteredRowModel(),\n onColumnVisibilityChange: setColumnVisibility,\n onRowSelectionChange: setRowSelection,\n state: {\n sorting,\n columnFilters,\n columnVisibility,\n rowSelection,\n },\n initialState: {\n pagination: {\n pageSize: pageSize,\n },\n },\n });\n\n if (loading) return <LoadingSkeleton />;\n if (error)\n return (\n <ErrorState error={typeof error === \"string\" ? error : \"Unknown error\"} />\n );\n\n if (!hasData) return <EmptyState />;\n\n return (\n <section className={className} aria-label={ariaLabel} data-testid={testId}>\n {children(table)}\n </section>\n );\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"table-wrapper.js","names":[],"sources":["../../../src/react/table/table-wrapper.tsx"],"sourcesContent":["import {\n type Column,\n type ColumnFiltersState,\n getCoreRowModel,\n getFilteredRowModel,\n getPaginationRowModel,\n getSortedRowModel,\n type Row,\n type RowSelectionState,\n type SortingState,\n type Table,\n useReactTable,\n type VisibilityState,\n} from \"@tanstack/react-table\";\nimport { ArrowUpDown } from \"lucide-react\";\nimport { useEffect, useMemo, useState } from \"react\";\n\nimport { useAnalyticsQuery } from \"..\";\nimport {\n formatChartValue,\n formatFieldLabel,\n SAFE_KEY_REGEX,\n} from \"../lib/format\";\nimport { Button } from \"../ui/button\";\nimport { Checkbox } from \"../ui/checkbox\";\nimport { EmptyState } from \"./empty\";\nimport { ErrorState } from \"./error\";\nimport { LoadingSkeleton } from \"./loading\";\nimport type { TableWrapperProps } from \"./types\";\n\nconst CHECKBOX_COLUMN_WIDTH = 40;\nconst EMPTY_DATA: never[] = [];\n\n/**\n * Wrapper component for tables with automatic data fetching and state management\n * This component handles:\n * - Data fetching via useAnalyticsQuery\n * - Loading, error, and empty states with proper UI components\n * - Data transformation (optional)\n * - Dynamic column generation from data structure\n * - TanStack Table instance creation with all features (sorting, filtering, pagination, etc.)\n *\n * @template TRaw - The raw data type returned by the analytics query\n * @template TProcessed - The processed data type after transformation\n *\n * @param props - Props for the TableWrapper component\n * @param props.queryKey - The query key to fetch the data\n * @param props.parameters - The parameters to pass to the query\n * @param props.transformer - Optional function to transform raw data before creating table\n * @param props.children - Render function that receives the TanStack Table instance\n * @param props.className - Optional CSS class name for the wrapper\n * @param props.ariaLabel - Optional accessibility label\n * @param props.testId - Optional test ID for testing\n *\n * @returns The rendered table with state management\n */\nexport function TableWrapper<TRaw = any, TProcessed = any>(\n props: TableWrapperProps<TRaw, TProcessed>,\n) {\n const {\n queryKey,\n parameters,\n transformer,\n children,\n className,\n ariaLabel,\n testId,\n enableRowSelection = false,\n onRowSelectionChange,\n pageSize = 10,\n } = props;\n\n const [sorting, setSorting] = useState<SortingState>([]);\n const [columnFilters, setColumnFilters] = useState<ColumnFiltersState>([]);\n const [columnVisibility, setColumnVisibility] = useState<VisibilityState>({});\n const [rowSelection, setRowSelection] = useState<RowSelectionState>({});\n\n const { data, loading, error } = useAnalyticsQuery<TRaw[]>(\n queryKey,\n parameters,\n );\n\n useEffect(() => {\n if (onRowSelectionChange && enableRowSelection) {\n onRowSelectionChange(rowSelection);\n }\n }, [rowSelection, onRowSelectionChange, enableRowSelection]);\n\n const hasData = data && data.length > 0;\n\n // TanStack resets the page index (and re-renders) whenever `data` changes\n // identity, so a fresh array per render loops forever.\n const processedData = useMemo(\n () =>\n hasData\n ? transformer\n ? transformer(data)\n : (data as unknown as TProcessed[])\n : (EMPTY_DATA as TProcessed[]),\n [hasData, data, transformer],\n );\n\n const tableColumns = useMemo(() => {\n if (!hasData) return [];\n\n if (!processedData[0] || typeof processedData[0] !== \"object\") {\n console.warn(\"Invalid data format for DataTable\");\n return [];\n }\n\n const dataColumns = Object.keys(processedData[0] as object)\n .filter((key) => SAFE_KEY_REGEX.test(key))\n .map((key) => {\n const formattedLabel = formatFieldLabel(key);\n return {\n accessorKey: key,\n header: ({ column }: { column: Column<TProcessed> }) => {\n return (\n <Button\n variant=\"ghost\"\n onClick={() =>\n column.toggleSorting(column.getIsSorted() === \"asc\")\n }\n className=\"h-8 px-2\"\n >\n {formattedLabel}\n <ArrowUpDown className=\"ml-2 h-4 w-4\" />\n </Button>\n );\n },\n cell: ({ row }: { row: Row<TProcessed> }) => {\n const value = row.getValue(key);\n if (typeof value === \"number\" || Number.isFinite(Number(value))) {\n return (\n <div className=\"text-right font-mono\">\n {formatChartValue(Number(value), key)}\n </div>\n );\n }\n return <div>{String(value)}</div>;\n },\n };\n });\n\n if (enableRowSelection) {\n return [\n {\n id: \"select\",\n maxSize: CHECKBOX_COLUMN_WIDTH,\n minSize: CHECKBOX_COLUMN_WIDTH,\n header: ({ table }: { table: Table<TProcessed> }) => (\n <div className=\"flex items-center justify-center\">\n <Checkbox\n checked={\n table.getIsAllPageRowsSelected() ||\n (table.getIsSomePageRowsSelected() && \"indeterminate\")\n }\n onCheckedChange={(value) =>\n table.toggleAllPageRowsSelected(!!value)\n }\n aria-label=\"Select all\"\n />\n </div>\n ),\n cell: ({ row }: { row: Row<TProcessed> }) => (\n <div className=\"flex items-center justify-center\">\n <Checkbox\n checked={row.getIsSelected()}\n onCheckedChange={(value) => row.toggleSelected(!!value)}\n aria-label=\"Select row\"\n />\n </div>\n ),\n enableSorting: false,\n enableHiding: false,\n },\n ...dataColumns,\n ];\n }\n\n return dataColumns;\n }, [hasData, processedData, enableRowSelection]);\n\n const table = useReactTable({\n data: processedData,\n columns: tableColumns,\n onSortingChange: setSorting,\n onColumnFiltersChange: setColumnFilters,\n getCoreRowModel: getCoreRowModel(),\n getPaginationRowModel: getPaginationRowModel(),\n getSortedRowModel: getSortedRowModel(),\n getFilteredRowModel: getFilteredRowModel(),\n onColumnVisibilityChange: setColumnVisibility,\n onRowSelectionChange: setRowSelection,\n state: {\n sorting,\n columnFilters,\n columnVisibility,\n rowSelection,\n },\n initialState: {\n pagination: {\n pageSize: pageSize,\n },\n },\n });\n\n if (loading) return <LoadingSkeleton />;\n if (error)\n return (\n <ErrorState error={typeof error === \"string\" ? error : \"Unknown error\"} />\n );\n\n if (!hasData) return <EmptyState />;\n\n return (\n <section className={className} aria-label={ariaLabel} data-testid={testId}>\n {children(table)}\n </section>\n );\n}\n"],"mappings":"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"}
@@ -11,7 +11,11 @@ interface DataTableProps {
11
11
  filterColumn?: string;
12
12
  /** Optional placeholder for the filter input */
13
13
  filterPlaceholder?: string;
14
- /** Optional function to transform data before creating table */
14
+ /**
15
+ * Optional function to transform data before creating table.
16
+ * A new function reference re-runs it and resets the table to the first page,
17
+ * so define it outside the component or wrap it in `useCallback`.
18
+ */
15
19
  transform?: (data: any[]) => any[];
16
20
  /** Optional labels for the DataTable component */
17
21
  labels?: DataTableLabels;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/react/table/types.ts"],"mappings":";;;;UA+BiB,cAAA;EAwBI;EAtBnB,QAAA;EAsBkC;EApBlC,UAAA,EAAY,MAAA;EAsBZ;EApBA,YAAA;EAsBe;EApBf,iBAAA;EAwBe;EAtBf,SAAA,IAAa,IAAA;;EAEb,MAAA,GAAS,eAAA;EAsBT;EApBA,SAAA;EAwBA;EAtBA,MAAA;EA0BA;EAxBA,SAAA;EA4BA;EA1BA,kBAAA;EA0BO;EAxBP,oBAAA,IAAwB,YAAA,EAAc,iBAAA;;EAEtC,QAAA,IAAY,KAAA,EAAO,KAAA,UAAe,KAAA,CAAM,SAAA;;EAExC,QAAA;;EAEA,eAAA;AAAA;;UAIe,eAAA;;EAEf,aAAA;;EAEA,SAAA;;EAEA,SAAA;;EAEA,cAAA;;EAEA,UAAA;;EAEA,WAAA;;EAEA,OAAA;AAAA"}
1
+ {"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/react/table/types.ts"],"mappings":";;;;UAmCiB,cAAA;EA8Bf;EA5BA,QAAA;EA8Be;EA5Bf,UAAA,EAAY,MAAA;EAgCG;EA9Bf,YAAA;;EAEA,iBAAA;EA8BA;;;;;EAxBA,SAAA,IAAa,IAAA;EAoCb;EAlCA,MAAA,GAAS,eAAA;EAkCF;EAhCP,SAAA;;EAEA,MAAA;;EAEA,SAAA;;EAEA,kBAAA;;EAEA,oBAAA,IAAwB,YAAA,EAAc,iBAAA;;EAEtC,QAAA,IAAY,KAAA,EAAO,KAAA,UAAe,KAAA,CAAM,SAAA;;EAExC,QAAA;;EAEA,eAAA;AAAA;;UAIe,eAAA;;EAEf,aAAA;;EAEA,SAAA;;EAEA,SAAA;;EAEA,cAAA;;EAEA,UAAA;;EAEA,WAAA;;EAEA,OAAA;AAAA"}
@@ -5,7 +5,7 @@ import * as class_variance_authority_types0 from "class-variance-authority/types
5
5
 
6
6
  //#region src/react/ui/button.d.ts
7
7
  declare const buttonVariants: (props?: ({
8
- variant?: "default" | "link" | "destructive" | "secondary" | "outline" | "ghost" | null | undefined;
8
+ variant?: "default" | "destructive" | "secondary" | "outline" | "ghost" | "link" | null | undefined;
9
9
  size?: "default" | "sm" | "lg" | "icon" | "icon-sm" | "icon-lg" | null | undefined;
10
10
  } & class_variance_authority_types0.ClassProp) | undefined) => string;
11
11
  /** Clickable button with multiple variants and sizes */
@@ -26,18 +26,24 @@ type GenieStreamEvent = {
26
26
  nextPageToken: string | null; /** Total messages returned in this initial load */
27
27
  loadedCount: number;
28
28
  };
29
- /** Shape of the Databricks SQL statement_response returned by Genie queries */
29
+ /**
30
+ * Shape of the Databricks SQL statement response returned by Genie queries.
31
+ * The server sends the modular SDK's camelCase shape; the snake_case fields are
32
+ * the legacy raw-API shape, still accepted by appkit-ui for older servers.
33
+ */
30
34
  interface GenieStatementResponse {
31
35
  manifest: {
32
36
  schema: {
33
37
  columns: Array<{
34
38
  name: string;
35
- type_name: string;
39
+ typeName?: string; /** @deprecated Legacy snake_case shape; use `typeName`. */
40
+ type_name?: string;
36
41
  }>;
37
42
  };
38
43
  };
39
44
  result: {
40
- data_array: (string | null)[][];
45
+ dataArray?: (string | null)[][]; /** @deprecated Legacy snake_case shape; use `dataArray`. */
46
+ data_array?: (string | null)[][];
41
47
  };
42
48
  }
43
49
  /** Cleaned response — subset of SDK GenieMessage */
@@ -1 +1 @@
1
- {"version":3,"file":"genie.d.ts","names":[],"sources":["../../../../shared/src/genie.ts"],"mappings":";;KACY,gBAAA;EAEN,IAAA;EACA,cAAA;EACA,SAAA;EACA,OAAA;AAAA;EAEA,IAAA;EAAgB,MAAA;AAAA;EAChB,IAAA;EAAwB,OAAA,EAAS,oBAAA;AAAA;EAEjC,IAAA;EACA,YAAA;EACA,WAAA;EACA,IAAA,EAAM,sBAAA;AAAA;EAEN,IAAA;EAAe,KAAA;AAAA;EAEf,IAAA;EACA,cAAA;EACA,OAAA,UAEA;EAAA,aAAA,iBAEW;EAAX,WAAA;AAAA;;UAIW,sBAAA;EACf,QAAA;IACE,MAAA;MACE,OAAA,EAAS,KAAA;QAAQ,IAAA;QAAc,SAAA;MAAA;IAAA;EAAA;EAGnC,MAAA;IACE,UAAA;EAAA;AAAA;;UAKa,oBAAA;EACf,SAAA;EACA,cAAA;EACA,OAAA;EACA,MAAA;EACA,OAAA;EACA,WAAA,GAAc,uBAAA;EACd,KAAA;AAAA;AAAA,UAGe,uBAAA;EACf,YAAA;EACA,KAAA;IACE,KAAA;IACA,WAAA;IACA,KAAA;IACA,WAAA;EAAA;EAEF,IAAA;IAAS,OAAA;EAAA;EACT,kBAAA;AAAA"}
1
+ {"version":3,"file":"genie.d.ts","names":[],"sources":["../../../../shared/src/genie.ts"],"mappings":";;KACY,gBAAA;EAEN,IAAA;EACA,cAAA;EACA,SAAA;EACA,OAAA;AAAA;EAEA,IAAA;EAAgB,MAAA;AAAA;EAChB,IAAA;EAAwB,OAAA,EAAS,oBAAA;AAAA;EAEjC,IAAA;EACA,YAAA;EACA,WAAA;EACA,IAAA,EAAM,sBAAA;AAAA;EAEN,IAAA;EAAe,KAAA;AAAA;EAEf,IAAA;EACA,cAAA;EACA,OAAA,UAEA;EAAA,aAAA,iBAEW;EAAX,WAAA;AAAA;;;;;;UAQW,sBAAA;EACf,QAAA;IACE,MAAA;MACE,OAAA,EAAS,KAAA;QACP,IAAA;QACA,QAAA,WAOJ;QALI,SAAA;MAAA;IAAA;EAAA;EAIN,MAAA;IACE,SAAA,wBAamC;IAXnC,UAAA;EAAA;AAAA;;UAKa,oBAAA;EACf,SAAA;EACA,cAAA;EACA,OAAA;EACA,MAAA;EACA,OAAA;EACA,WAAA,GAAc,uBAAA;EACd,KAAA;AAAA;AAAA,UAGe,uBAAA;EACf,YAAA;EACA,KAAA;IACE,KAAA;IACA,WAAA;IACA,KAAA;IACA,WAAA;EAAA;EAEF,IAAA;IAAS,OAAA;EAAA;EACT,kBAAA;AAAA"}
@@ -1,2 +1 @@
1
- import "./legacy.js";
2
1
  import "./types.js";
@@ -1,4 +1,3 @@
1
- import "./errors.js";
2
- import "./legacy.js";
1
+ import "./modular.js";
3
2
  import "./types.js";
4
3
  import "./factory.js";
@@ -0,0 +1,19 @@
1
+ import "@databricks/sdk-core/apierror";
2
+ import "@databricks/sdk-core/http";
3
+ import "@databricks/sdk-core/profiles";
4
+ import "@databricks/sdk-scim/v1";
5
+ import "@databricks/sdk-statementexecution/v1";
6
+ import "@databricks/sdk-warehouses/v1";
7
+ import "@databricks/sdk-apps/v1";
8
+ import "@databricks/sdk-database/v1";
9
+ import "@databricks/sdk-experiments/v1";
10
+ import "@databricks/sdk-files/v2";
11
+ import "@databricks/sdk-genie/v1";
12
+ import "@databricks/sdk-jobs/v2";
13
+ import "@databricks/sdk-modelserving/v1";
14
+ import "@databricks/sdk-postgres/v1";
15
+ import "@databricks/sdk-uc-connections/v1";
16
+ import "@databricks/sdk-uc-functions/v1";
17
+ import "@databricks/sdk-uc-tables/v1";
18
+ import "@databricks/sdk-uc-volumes/v1";
19
+ import "@databricks/sdk-vectorsearch/v1";
@@ -1,2 +1 @@
1
- import "./legacy.js";
2
- import "@databricks/sdk-experimental";
1
+ import "./modular.js";
@@ -1,54 +1,112 @@
1
- import { buildLegacyWorkspaceClient } from "./legacy.js";
1
+ import { buildAppsClient, buildConnectionsClient, buildDatabaseClient, buildExperimentsClient, buildFilesClient, buildFunctionsClient, buildGenieClient, buildJobsClient, buildModelServingClient, buildPostgresClient, buildScimClient, buildStatementExecutionClient, buildTablesClient, buildVectorSearchClient, buildVolumesClient, buildWarehousesClient, buildWorkspaceAuth } from "./modular.js";
2
2
 
3
3
  //#region src/workspace-client/client.ts
4
4
  /**
5
5
  * `AppKitWorkspaceClient` — the facade implementation. Construct via
6
6
  * `createWorkspaceClient(...)`; this class is internal.
7
7
  *
8
- * Every service accessor delegates to a single lazily-constructed legacy SDK
9
- * client. This is the seam: to migrate a service to the modular SDK, replace
10
- * its getter here with a modular client instance (and update its connector +
11
- * the accessor type in `types.ts`). No other AppKit module touches the SDK.
8
+ * Every service accessor builds its modular `@databricks/sdk-*` client lazily
9
+ * (see `modular.ts`); raw REST calls go through the auth + request seam. No
10
+ * other AppKit module touches the SDK.
12
11
  */
13
12
  var AppKitWorkspaceClient = class {
14
13
  #opts;
15
- #legacy;
14
+ #warehouses;
15
+ #statementExecution;
16
+ #auth;
17
+ #currentUser;
18
+ #genie;
19
+ #database;
20
+ #apps;
21
+ #jobs;
22
+ #modelServing;
23
+ #experiments;
24
+ #files;
25
+ #vectorSearch;
26
+ #tables;
27
+ #postgres;
28
+ #volumes;
29
+ #functions;
30
+ #connections;
16
31
  constructor(opts) {
17
32
  this.#opts = opts;
18
33
  }
19
34
  get files() {
20
- return this.#getLegacy().files;
35
+ if (!this.#files) this.#files = buildFilesClient(this.#opts);
36
+ return this.#files;
21
37
  }
22
38
  get warehouses() {
23
- return this.#getLegacy().warehouses;
39
+ if (!this.#warehouses) this.#warehouses = buildWarehousesClient(this.#opts);
40
+ return this.#warehouses;
24
41
  }
25
42
  get genie() {
26
- return this.#getLegacy().genie;
43
+ if (!this.#genie) this.#genie = buildGenieClient(this.#opts);
44
+ return this.#genie;
45
+ }
46
+ get apps() {
47
+ if (!this.#apps) this.#apps = buildAppsClient(this.#opts);
48
+ return this.#apps;
49
+ }
50
+ get database() {
51
+ if (!this.#database) this.#database = buildDatabaseClient(this.#opts);
52
+ return this.#database;
27
53
  }
28
54
  get jobs() {
29
- return this.#getLegacy().jobs;
55
+ if (!this.#jobs) this.#jobs = buildJobsClient(this.#opts);
56
+ return this.#jobs;
57
+ }
58
+ get experiments() {
59
+ if (!this.#experiments) this.#experiments = buildExperimentsClient(this.#opts);
60
+ return this.#experiments;
61
+ }
62
+ get vectorSearch() {
63
+ if (!this.#vectorSearch) this.#vectorSearch = buildVectorSearchClient(this.#opts);
64
+ return this.#vectorSearch;
65
+ }
66
+ get tables() {
67
+ if (!this.#tables) this.#tables = buildTablesClient(this.#opts);
68
+ return this.#tables;
69
+ }
70
+ get postgres() {
71
+ if (!this.#postgres) this.#postgres = buildPostgresClient(this.#opts);
72
+ return this.#postgres;
73
+ }
74
+ get connections() {
75
+ if (!this.#connections) this.#connections = buildConnectionsClient(this.#opts);
76
+ return this.#connections;
77
+ }
78
+ get functions() {
79
+ if (!this.#functions) this.#functions = buildFunctionsClient(this.#opts);
80
+ return this.#functions;
81
+ }
82
+ get volumes() {
83
+ if (!this.#volumes) this.#volumes = buildVolumesClient(this.#opts);
84
+ return this.#volumes;
30
85
  }
31
86
  get statementExecution() {
32
- return this.#getLegacy().statementExecution;
87
+ if (!this.#statementExecution) this.#statementExecution = buildStatementExecutionClient(this.#opts);
88
+ return this.#statementExecution;
33
89
  }
34
- get servingEndpoints() {
35
- return this.#getLegacy().servingEndpoints;
90
+ get modelServing() {
91
+ if (!this.#modelServing) this.#modelServing = buildModelServingClient(this.#opts);
92
+ return this.#modelServing;
36
93
  }
37
94
  get currentUser() {
38
- return this.#getLegacy().currentUser;
95
+ if (!this.#currentUser) this.#currentUser = buildScimClient(this.#opts);
96
+ return this.#currentUser;
39
97
  }
40
- get config() {
41
- return this.#getLegacy().config;
98
+ getHost() {
99
+ return this.#getAuth().getHost();
42
100
  }
43
- get apiClient() {
44
- return this.#getLegacy().apiClient;
101
+ authenticate(headers) {
102
+ return this.#getAuth().authenticate(headers);
45
103
  }
46
- toLegacyWorkspaceClient() {
47
- return this.#getLegacy();
104
+ request(req) {
105
+ return this.#getAuth().request(req);
48
106
  }
49
- #getLegacy() {
50
- if (!this.#legacy) this.#legacy = buildLegacyWorkspaceClient(this.#opts);
51
- return this.#legacy;
107
+ #getAuth() {
108
+ if (!this.#auth) this.#auth = buildWorkspaceAuth(this.#opts);
109
+ return this.#auth;
52
110
  }
53
111
  };
54
112
 
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","names":["#opts","#getLegacy","#legacy"],"sources":["../../src/workspace-client/client.ts"],"sourcesContent":["/**\n * `AppKitWorkspaceClient` — the facade implementation. Construct via\n * `createWorkspaceClient(...)`; this class is internal.\n *\n * Every service accessor delegates to a single lazily-constructed legacy SDK\n * client. This is the seam: to migrate a service to the modular SDK, replace\n * its getter here with a modular client instance (and update its connector +\n * the accessor type in `types.ts`). No other AppKit module touches the SDK.\n */\nimport {\n buildLegacyWorkspaceClient,\n type LegacyWorkspaceClient,\n type WorkspaceClientOptions,\n} from \"./legacy\";\nimport type { WorkspaceClient } from \"./types\";\n\nexport class AppKitWorkspaceClient implements WorkspaceClient {\n readonly #opts: WorkspaceClientOptions;\n #legacy?: LegacyWorkspaceClient;\n\n constructor(opts: WorkspaceClientOptions) {\n this.#opts = opts;\n }\n\n get files() {\n return this.#getLegacy().files;\n }\n\n get warehouses() {\n return this.#getLegacy().warehouses;\n }\n\n get genie() {\n return this.#getLegacy().genie;\n }\n\n get jobs() {\n return this.#getLegacy().jobs;\n }\n\n get statementExecution() {\n return this.#getLegacy().statementExecution;\n }\n\n get servingEndpoints() {\n return this.#getLegacy().servingEndpoints;\n }\n\n get currentUser() {\n return this.#getLegacy().currentUser;\n }\n\n get config() {\n return this.#getLegacy().config;\n }\n\n get apiClient() {\n return this.#getLegacy().apiClient;\n }\n\n toLegacyWorkspaceClient(): LegacyWorkspaceClient {\n return this.#getLegacy();\n }\n\n #getLegacy(): LegacyWorkspaceClient {\n if (!this.#legacy) {\n this.#legacy = buildLegacyWorkspaceClient(this.#opts);\n }\n return this.#legacy;\n }\n}\n"],"mappings":";;;;;;;;;;;;AAgBA,IAAa,wBAAb,MAA8D;CAC5D,CAASA;CACT;CAEA,YAAY,MAA8B;AACxC,QAAKA,OAAQ;;CAGf,IAAI,QAAQ;AACV,SAAO,MAAKC,WAAY,CAAC;;CAG3B,IAAI,aAAa;AACf,SAAO,MAAKA,WAAY,CAAC;;CAG3B,IAAI,QAAQ;AACV,SAAO,MAAKA,WAAY,CAAC;;CAG3B,IAAI,OAAO;AACT,SAAO,MAAKA,WAAY,CAAC;;CAG3B,IAAI,qBAAqB;AACvB,SAAO,MAAKA,WAAY,CAAC;;CAG3B,IAAI,mBAAmB;AACrB,SAAO,MAAKA,WAAY,CAAC;;CAG3B,IAAI,cAAc;AAChB,SAAO,MAAKA,WAAY,CAAC;;CAG3B,IAAI,SAAS;AACX,SAAO,MAAKA,WAAY,CAAC;;CAG3B,IAAI,YAAY;AACd,SAAO,MAAKA,WAAY,CAAC;;CAG3B,0BAAiD;AAC/C,SAAO,MAAKA,WAAY;;CAG1B,aAAoC;AAClC,MAAI,CAAC,MAAKC,OACR,OAAKA,SAAU,2BAA2B,MAAKF,KAAM;AAEvD,SAAO,MAAKE"}
1
+ {"version":3,"file":"client.js","names":["#opts","#files","#warehouses","#genie","#apps","#database","#jobs","#experiments","#vectorSearch","#tables","#postgres","#connections","#functions","#volumes","#statementExecution","#modelServing","#currentUser","#getAuth","#auth"],"sources":["../../src/workspace-client/client.ts"],"sourcesContent":["/**\n * `AppKitWorkspaceClient` — the facade implementation. Construct via\n * `createWorkspaceClient(...)`; this class is internal.\n *\n * Every service accessor builds its modular `@databricks/sdk-*` client lazily\n * (see `modular.ts`); raw REST calls go through the auth + request seam. No\n * other AppKit module touches the SDK.\n */\nimport {\n buildScimClient,\n buildStatementExecutionClient,\n buildWarehousesClient,\n buildWorkspaceAuth,\n type ScimClient,\n buildFunctionsClient,\n buildDatabaseClient,\n type DatabaseClient,\n buildGenieClient,\n type FunctionsClient,\n type GenieClient,\n buildAppsClient,\n type AppsClient,\n buildJobsClient,\n buildExperimentsClient,\n type ExperimentsClient,\n type JobsClient,\n buildModelServingClient,\n type ModelServingClient,\n buildFilesClient,\n type FilesClient,\n buildConnectionsClient,\n type ConnectionsClient,\n buildTablesClient,\n type TablesClient,\n buildPostgresClient,\n type PostgresClient,\n buildVolumesClient,\n type VolumesClient,\n buildVectorSearchClient,\n type VectorSearchClient,\n type StatementExecutionClient,\n type WarehousesClient,\n type WorkspaceAuth,\n type WorkspaceRequest,\n} from \"./modular\";\nimport type { WorkspaceClientOptions } from \"./options\";\nimport type { WorkspaceClient } from \"./types\";\n\nexport class AppKitWorkspaceClient implements WorkspaceClient {\n readonly #opts: WorkspaceClientOptions;\n #warehouses?: WarehousesClient;\n #statementExecution?: StatementExecutionClient;\n #auth?: WorkspaceAuth;\n #currentUser?: ScimClient;\n #genie?: GenieClient;\n #database?: DatabaseClient;\n #apps?: AppsClient;\n #jobs?: JobsClient;\n #modelServing?: ModelServingClient;\n #experiments?: ExperimentsClient;\n #files?: FilesClient;\n #vectorSearch?: VectorSearchClient;\n #tables?: TablesClient;\n #postgres?: PostgresClient;\n #volumes?: VolumesClient;\n #functions?: FunctionsClient;\n #connections?: ConnectionsClient;\n\n constructor(opts: WorkspaceClientOptions) {\n this.#opts = opts;\n }\n\n // Migrated to the modular SDK — built lazily.\n get files(): FilesClient {\n if (!this.#files) {\n this.#files = buildFilesClient(this.#opts);\n }\n return this.#files;\n }\n\n // Migrated to the modular SDK — built lazily.\n get warehouses(): WarehousesClient {\n if (!this.#warehouses) {\n this.#warehouses = buildWarehousesClient(this.#opts);\n }\n return this.#warehouses;\n }\n\n // Migrated to the modular SDK — built lazily.\n get genie(): GenieClient {\n if (!this.#genie) {\n this.#genie = buildGenieClient(this.#opts);\n }\n return this.#genie;\n }\n\n // Migrated to the modular SDK — built lazily.\n get apps(): AppsClient {\n if (!this.#apps) {\n this.#apps = buildAppsClient(this.#opts);\n }\n return this.#apps;\n }\n\n // Migrated to the modular SDK — built lazily.\n get database(): DatabaseClient {\n if (!this.#database) {\n this.#database = buildDatabaseClient(this.#opts);\n }\n return this.#database;\n }\n\n // Migrated to the modular SDK — built lazily.\n get jobs(): JobsClient {\n if (!this.#jobs) {\n this.#jobs = buildJobsClient(this.#opts);\n }\n return this.#jobs;\n }\n\n // Migrated to the modular SDK — built lazily.\n get experiments(): ExperimentsClient {\n if (!this.#experiments) {\n this.#experiments = buildExperimentsClient(this.#opts);\n }\n return this.#experiments;\n }\n\n // Migrated to the modular SDK — built lazily.\n get vectorSearch(): VectorSearchClient {\n if (!this.#vectorSearch) {\n this.#vectorSearch = buildVectorSearchClient(this.#opts);\n }\n return this.#vectorSearch;\n }\n\n // Migrated to the modular SDK — built lazily.\n get tables(): TablesClient {\n if (!this.#tables) {\n this.#tables = buildTablesClient(this.#opts);\n }\n return this.#tables;\n }\n\n // Migrated to the modular SDK — built lazily.\n get postgres(): PostgresClient {\n if (!this.#postgres) {\n this.#postgres = buildPostgresClient(this.#opts);\n }\n return this.#postgres;\n }\n\n // Migrated to the modular SDK — built lazily.\n get connections(): ConnectionsClient {\n if (!this.#connections) {\n this.#connections = buildConnectionsClient(this.#opts);\n }\n return this.#connections;\n }\n\n // Migrated to the modular SDK — built lazily.\n get functions(): FunctionsClient {\n if (!this.#functions) {\n this.#functions = buildFunctionsClient(this.#opts);\n }\n return this.#functions;\n }\n\n // Migrated to the modular SDK — built lazily.\n get volumes(): VolumesClient {\n if (!this.#volumes) {\n this.#volumes = buildVolumesClient(this.#opts);\n }\n return this.#volumes;\n }\n\n // Migrated to the modular SDK — built lazily.\n get statementExecution(): StatementExecutionClient {\n if (!this.#statementExecution) {\n this.#statementExecution = buildStatementExecutionClient(this.#opts);\n }\n return this.#statementExecution;\n }\n\n get modelServing(): ModelServingClient {\n if (!this.#modelServing) {\n this.#modelServing = buildModelServingClient(this.#opts);\n }\n return this.#modelServing;\n }\n\n // Migrated to the modular SDK (SCIM) — built lazily.\n get currentUser(): ScimClient {\n if (!this.#currentUser) {\n this.#currentUser = buildScimClient(this.#opts);\n }\n return this.#currentUser;\n }\n\n // Modular auth + raw-request seam — built lazily.\n getHost(): Promise<string> {\n return this.#getAuth().getHost();\n }\n\n authenticate(headers: Headers): Promise<void> {\n return this.#getAuth().authenticate(headers);\n }\n\n request(req: WorkspaceRequest): Promise<Response> {\n return this.#getAuth().request(req);\n }\n\n #getAuth(): WorkspaceAuth {\n if (!this.#auth) {\n this.#auth = buildWorkspaceAuth(this.#opts);\n }\n return this.#auth;\n }\n}\n"],"mappings":";;;;;;;;;;;AAgDA,IAAa,wBAAb,MAA8D;CAC5D,CAASA;CACT;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA,YAAY,MAA8B;AACxC,QAAKA,OAAQ;;CAIf,IAAI,QAAqB;AACvB,MAAI,CAAC,MAAKC,MACR,OAAKA,QAAS,iBAAiB,MAAKD,KAAM;AAE5C,SAAO,MAAKC;;CAId,IAAI,aAA+B;AACjC,MAAI,CAAC,MAAKC,WACR,OAAKA,aAAc,sBAAsB,MAAKF,KAAM;AAEtD,SAAO,MAAKE;;CAId,IAAI,QAAqB;AACvB,MAAI,CAAC,MAAKC,MACR,OAAKA,QAAS,iBAAiB,MAAKH,KAAM;AAE5C,SAAO,MAAKG;;CAId,IAAI,OAAmB;AACrB,MAAI,CAAC,MAAKC,KACR,OAAKA,OAAQ,gBAAgB,MAAKJ,KAAM;AAE1C,SAAO,MAAKI;;CAId,IAAI,WAA2B;AAC7B,MAAI,CAAC,MAAKC,SACR,OAAKA,WAAY,oBAAoB,MAAKL,KAAM;AAElD,SAAO,MAAKK;;CAId,IAAI,OAAmB;AACrB,MAAI,CAAC,MAAKC,KACR,OAAKA,OAAQ,gBAAgB,MAAKN,KAAM;AAE1C,SAAO,MAAKM;;CAId,IAAI,cAAiC;AACnC,MAAI,CAAC,MAAKC,YACR,OAAKA,cAAe,uBAAuB,MAAKP,KAAM;AAExD,SAAO,MAAKO;;CAId,IAAI,eAAmC;AACrC,MAAI,CAAC,MAAKC,aACR,OAAKA,eAAgB,wBAAwB,MAAKR,KAAM;AAE1D,SAAO,MAAKQ;;CAId,IAAI,SAAuB;AACzB,MAAI,CAAC,MAAKC,OACR,OAAKA,SAAU,kBAAkB,MAAKT,KAAM;AAE9C,SAAO,MAAKS;;CAId,IAAI,WAA2B;AAC7B,MAAI,CAAC,MAAKC,SACR,OAAKA,WAAY,oBAAoB,MAAKV,KAAM;AAElD,SAAO,MAAKU;;CAId,IAAI,cAAiC;AACnC,MAAI,CAAC,MAAKC,YACR,OAAKA,cAAe,uBAAuB,MAAKX,KAAM;AAExD,SAAO,MAAKW;;CAId,IAAI,YAA6B;AAC/B,MAAI,CAAC,MAAKC,UACR,OAAKA,YAAa,qBAAqB,MAAKZ,KAAM;AAEpD,SAAO,MAAKY;;CAId,IAAI,UAAyB;AAC3B,MAAI,CAAC,MAAKC,QACR,OAAKA,UAAW,mBAAmB,MAAKb,KAAM;AAEhD,SAAO,MAAKa;;CAId,IAAI,qBAA+C;AACjD,MAAI,CAAC,MAAKC,mBACR,OAAKA,qBAAsB,8BAA8B,MAAKd,KAAM;AAEtE,SAAO,MAAKc;;CAGd,IAAI,eAAmC;AACrC,MAAI,CAAC,MAAKC,aACR,OAAKA,eAAgB,wBAAwB,MAAKf,KAAM;AAE1D,SAAO,MAAKe;;CAId,IAAI,cAA0B;AAC5B,MAAI,CAAC,MAAKC,YACR,OAAKA,cAAe,gBAAgB,MAAKhB,KAAM;AAEjD,SAAO,MAAKgB;;CAId,UAA2B;AACzB,SAAO,MAAKC,SAAU,CAAC,SAAS;;CAGlC,aAAa,SAAiC;AAC5C,SAAO,MAAKA,SAAU,CAAC,aAAa,QAAQ;;CAG9C,QAAQ,KAA0C;AAChD,SAAO,MAAKA,SAAU,CAAC,QAAQ,IAAI;;CAGrC,WAA0B;AACxB,MAAI,CAAC,MAAKC,KACR,OAAKA,OAAQ,mBAAmB,MAAKlB,KAAM;AAE7C,SAAO,MAAKkB"}
@@ -1,2 +1,14 @@
1
- import { ApiError } from "@databricks/sdk-experimental";
2
- export { ApiError };
1
+ //#region src/workspace-client/errors.d.ts
2
+ declare class ApiError extends Error {
3
+ readonly errorCode: string;
4
+ readonly statusCode: number;
5
+ readonly response?: unknown | undefined;
6
+ readonly details: unknown[];
7
+ constructor(message: string, errorCode: string, statusCode: number, response?: unknown | undefined, details?: unknown[]);
8
+ /** Like the legacy SDK: only 429 is retryable by status alone. */
9
+ isRetryable(): boolean;
10
+ static [Symbol.hasInstance](value: unknown): boolean;
11
+ }
12
+ //#endregion
13
+ export { ApiError };
14
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/workspace-client/errors.ts"],"mappings":";cAkCa,QAAA,SAAiB,KAAA;EAAA,SAGjB,SAAA;EAAA,SACA,UAAA;EAAA,SACA,QAAA;EAAA,SACA,OAAA;cAJT,OAAA,UACS,SAAA,UACA,UAAA,UACA,QAAA,wBACA,OAAA;EAHA;EAUX,WAAA,CAAA;EAAA,QAIQ,MAAA,CAAO,WAAA,EAAa,KAAA;AAAA"}