@grafana/plugin-ui 0.14.0-dev.1 → 0.14.1-dsconfig.032cfc4

package/dist/esm/schema/utils/provisioning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provisioning.js","sources":["../../../../src/schema/utils/provisioning.ts"],"sourcesContent":["// @ts-expect-error — js-yaml has no bundled type declarations; used only for scalar serialization\nimport yaml from 'js-yaml';\nimport { resolveGroups } from '../../components/ConfigEditor/DatasourceConfigWizard/config';\nimport { ROOT_CONFIG_FIELDS } from './dsconfig';\nimport type { AllowedValuesValidationRule, ConfigField, ConfigGroup, DatasourceConfigSchema } from '../schema';\n\ntype YamlRenderOptions = { jsonDataKeys?: string[]; secureKeys?: string[] };\n\n// ============================================================\n// Provisioning YAML generation\n// ============================================================\n\n/** Indent each line by `depth * 2` spaces. */\nfunction yamlIndent(depth: number): string {\n  return '  '.repeat(depth);\n}\n\n/** Serialize a scalar value as a safe YAML string using js-yaml. */\nfunction yamlString(value: unknown): string {\n  if (value === null || value === undefined) {\n    return '\"\"';\n  }\n  const s = String(value);\n  if (s === '') {\n    return '\"\"';\n  }\n  return yaml.dump(s, { lineWidth: -1 }).trimEnd();\n}\n\n/** Format a value as YAML inline. */\nfunction yamlValue(value: unknown, depth: number): string {\n  if (value === null || value === undefined) {\n    return '\"\"';\n  }\n  if (typeof value === 'boolean') {\n    return value ? 'true' : 'false';\n  }\n  if (typeof value === 'number') {\n    return String(value);\n  }\n  if (typeof value === 'string') {\n    return yamlString(value);\n  }\n  if (Array.isArray(value)) {\n    if (value.length === 0) {\n      return '[]';\n    }\n    const lines = value.map((item) => {\n      if (typeof item === 'object' && item !== null && !Array.isArray(item)) {\n        const entries = Object.entries(item as Record<string, unknown>);\n        if (entries.length === 0) {\n          return `${yamlIndent(depth)}- {}`;\n        }\n        const [firstKey, firstVal] = entries[0];\n        const firstLine = `${yamlIndent(depth)}- ${yamlString(firstKey)}: ${yamlValue(firstVal, depth + 2)}`;\n        const rest = entries\n          .slice(1)\n          .map(([k, v]) => `${yamlIndent(depth + 1)}${yamlString(k)}: ${yamlValue(v, depth + 2)}`);\n        return [firstLine, ...rest].join('\\n');\n      }\n      return `${yamlIndent(depth)}- ${yamlValue(item, depth + 1)}`;\n    });\n    return '\\n' + lines.join('\\n');\n  }\n  if (typeof value === 'object') {\n    const entries = Object.entries(value as Record<string, unknown>);\n    if (entries.length === 0) {\n      return '{}';\n    }\n    const lines = entries.map(([k, v]) => `${yamlIndent(depth)}${yamlString(k)}: ${yamlValue(v, depth + 1)}`);\n    return '\\n' + lines.join('\\n');\n  }\n  return yamlString(value);\n}\n\n/** True if the field is a certificate or key (multiline secret). */\nfunction isCertField(field: ConfigField): boolean {\n  const k = field.key.toLowerCase();\n  return (\n    field.target === 'secureJsonData' && (k.includes('cert') || k.includes('key') || field.ui?.component === 'textarea')\n  );\n}\n\n/** True if the field should be excluded from provisioning YAML output. */\nfunction isExcludedFromProvisioning(field: ConfigField): boolean {\n  if (field.kind === 'virtual') {\n    return true;\n  }\n  if (field.isItemField) {\n    return true;\n  }\n  // Fields tagged \"managed-by:*\" are auto-set by the wizard UI via effects.\n  // Root fields like basicAuth still need to appear in provisioning YAML\n  // because they are real storage fields. Only exclude managed jsonData fields.\n  if (field.tags?.some((t) => t.startsWith('managed-by:')) && field.target !== 'root') {\n    return true;\n  }\n  // Skip indexedPair storage — these are handled separately (e.g. httpHeaders)\n  if (field.storage?.type === 'indexedPair') {\n    return true;\n  }\n  return false;\n}\n\n/** Format a secureJsonData placeholder value. */\nfunction secretPlaceholder(field: ConfigField): string {\n  if (isCertField(field)) {\n    return '|\\n      xxxxxx';\n  }\n  return 'xxxxxx';\n}\n\n/** Default YAML value for a field in template mode. */\nfunction templateValue(field: ConfigField): unknown {\n  if (field.defaultValue !== undefined) {\n    return field.defaultValue;\n  }\n  // Use first option value as a sensible default\n  if (field.ui?.options && field.ui.options.length > 0) {\n    return field.ui.options[0].value;\n  }\n  switch (field.valueType) {\n    case 'string':\n      return '';\n    case 'number':\n      return 0;\n    case 'boolean':\n      return false;\n    case 'array':\n      return [];\n    case 'object':\n    case 'map':\n      return {};\n    default:\n      return '';\n  }\n}\n\n/**\n * Format a YAML comment for a field in template mode.\n * Includes label, description, allowed values, and default.\n */\nfunction fieldComment(field: ConfigField, indent: string): string {\n  const parts: string[] = [];\n  const label = field.label ?? field.key;\n  let line = label;\n  if (field.required) {\n    line += ' (REQUIRED)';\n  }\n  if (field.description) {\n    line += ` — ${field.description}`;\n  }\n  parts.push(`${indent}# ${line}`);\n\n  const options = field.ui?.options;\n  if (options && options.length > 0) {\n    const vals = options.map((o) => String(o.value)).join(', ');\n    parts.push(`${indent}# Allowed values: ${vals}`);\n  }\n\n  const allowedValuesRule = field.validations?.find(\n    (v): v is AllowedValuesValidationRule => v.type === 'allowedValues'\n  );\n  if (allowedValuesRule && !options) {\n    const vals = allowedValuesRule.values.map((v) => String(v)).join(', ');\n    parts.push(`${indent}# Allowed values: ${vals}`);\n  }\n\n  if (field.dependsOn) {\n    parts.push(`${indent}# Only when: ${field.dependsOn}`);\n  }\n\n  return parts.join('\\n');\n}\n\nexport type ProvisioningYamlOptions = {\n  /** Include comments with field descriptions. Default: true for template, false for export. */\n  comments?: boolean;\n  /** Name override (used in template mode). */\n  name?: string;\n};\n\n/**\n * Generate a Grafana provisioning YAML from a dsconfig schema.\n * In template mode (no values), emits all fields with defaults and comments.\n * When values are provided, emits actual values — used for existing datasource export.\n */\nexport function toProvisioningYaml(\n  schema: DatasourceConfigSchema,\n  values?: Record<string, unknown>,\n  options?: ProvisioningYamlOptions\n): string {\n  const isTemplate = !values;\n  const showComments = options?.comments ?? isTemplate;\n  const indent2 = '    ';\n  const indent3 = '      ';\n\n  // Use schema groups to order fields logically (connection → auth → network → etc.)\n  const groups = resolveGroups(schema);\n  const rootFields: ConfigField[] = [];\n  const jsonDataFieldsByGroup: Array<{ group: ConfigGroup; fields: ConfigField[] }> = [];\n  const secureJsonDataFieldsByGroup: Array<{ group: ConfigGroup; fields: ConfigField[] }> = [];\n  const virtualFieldsWithOptions: ConfigField[] = [];\n\n  for (const { group, fields } of groups) {\n    const jd: ConfigField[] = [];\n    const sd: ConfigField[] = [];\n    for (const field of fields) {\n      // Collect virtual fields with UI options (e.g. auth.method) for comment-only output\n      if (field.kind === 'virtual' && field.ui?.options && field.ui.options.length > 0) {\n        virtualFieldsWithOptions.push(field);\n        continue;\n      }\n      if (isExcludedFromProvisioning(field)) {\n        continue;\n      }\n      switch (field.target) {\n        case 'root':\n          rootFields.push(field);\n          break;\n        case 'jsonData':\n          jd.push(field);\n          break;\n        case 'secureJsonData':\n          sd.push(field);\n          break;\n      }\n    }\n    if (jd.length > 0) {\n      jsonDataFieldsByGroup.push({ group, fields: jd });\n    }\n    if (sd.length > 0) {\n      secureJsonDataFieldsByGroup.push({ group, fields: sd });\n    }\n  }\n\n  const allSecureJsonDataFields = secureJsonDataFieldsByGroup.flatMap((g) => g.fields);\n\n  // Pick up root fields not referenced in any group (e.g. root.basicAuth is managed\n  // by auth.method effects and not listed in the auth group's fieldRefs).\n  const groupedFieldIds = new Set(groups.flatMap(({ group }) => group.fieldRefs));\n  for (const field of schema.fields) {\n    if (field.target === 'root' && !groupedFieldIds.has(field.id) && !isExcludedFromProvisioning(field)) {\n      rootFields.push(field);\n    }\n  }\n\n  const lines: string[] = [];\n  lines.push('apiVersion: 1');\n  lines.push('');\n  lines.push('datasources:');\n  lines.push(`${indent2.slice(2)}- name: ${yamlString(options?.name ?? values?.name ?? `my-${schema.pluginType}`)}`);\n  lines.push(`${indent2}type: ${schema.pluginType}`);\n\n  // In export mode, emit uid so the provisioning YAML can be used for idempotent upserts.\n  if (!isTemplate && values?.uid) {\n    lines.push(`${indent2}uid: ${yamlString(values.uid)}`);\n  }\n\n  // Root fields (url, basicAuth, basicAuthUser, database, etc.)\n  const ALREADY_EMITTED_ROOT = new Set(['name', 'type', 'uid']);\n  for (const field of rootFields) {\n    if (ALREADY_EMITTED_ROOT.has(field.key)) {\n      continue;\n    }\n    const val = values ? values[field.key] : templateValue(field);\n    if (val === undefined || val === null) {\n      continue;\n    }\n    // Skip false booleans in export mode to keep YAML clean\n    if (!isTemplate && val === false) {\n      continue;\n    }\n    if (showComments) {\n      lines.push(fieldComment(field, indent2));\n    }\n    lines.push(`${indent2}${field.key}: ${yamlValue(val, 3)}`);\n  }\n\n  // Emit virtual fields with UI options as comments (e.g. auth.method selector)\n  // These explain configuration choices even though they aren't stored directly.\n  if (showComments) {\n    for (const vf of virtualFieldsWithOptions) {\n      const label = vf.label ?? vf.key;\n      const opts = vf.ui!.options!.map((o) => `${String(o.value)} (${o.label})`).join(', ');\n      lines.push(`${indent2}# ${label}: ${opts}`);\n      if (vf.description) {\n        lines.push(`${indent2}#   ${vf.description}`);\n      }\n    }\n  }\n\n  // Collect jsonData keys emitted by schema fields so we can detect extra keys in export mode.\n  const emittedJsonDataKeys = new Set<string>();\n  const emittedSecureJsonDataKeys = new Set<string>();\n\n  // jsonData section — ordered by schema groups\n  const jsonDataValues = values?.jsonData as Record<string, unknown> | undefined;\n  const hasJsonDataFromSchema = jsonDataFieldsByGroup.length > 0;\n  const hasJsonDataFromValues = !isTemplate && jsonDataValues && Object.keys(jsonDataValues).length > 0;\n\n  if (hasJsonDataFromSchema || hasJsonDataFromValues) {\n    lines.push(`${indent2}jsonData:`);\n\n    // Schema-declared fields, grouped by section\n    for (const { group, fields: groupFields } of jsonDataFieldsByGroup) {\n      if (showComments && jsonDataFieldsByGroup.length > 1) {\n        lines.push(`${indent3}# --- ${group.title} ---`);\n      }\n      for (const field of groupFields) {\n        const val = values ? getNestedValue(values, 'jsonData', field) : templateValue(field);\n        if (val === undefined || val === null) {\n          continue;\n        }\n        // In export mode, skip default-value fields to keep YAML minimal\n        if (!isTemplate && field.defaultValue !== undefined && val === field.defaultValue) {\n          continue;\n        }\n        emittedJsonDataKeys.add(field.key);\n        if (showComments) {\n          lines.push(fieldComment(field, indent3));\n        }\n        const rendered = yamlValue(val, 4);\n        if (rendered.startsWith('\\n')) {\n          lines.push(`${indent3}${field.key}:${rendered}`);\n        } else {\n          lines.push(`${indent3}${field.key}: ${rendered}`);\n        }\n      }\n    }\n\n    // In export mode, emit extra jsonData keys not declared in the schema\n    // (e.g. httpHeaderName1 from indexedPair storage, or plugin-specific keys)\n    if (!isTemplate && jsonDataValues) {\n      for (const [key, val] of Object.entries(jsonDataValues)) {\n        if (emittedJsonDataKeys.has(key)) {\n          continue;\n        }\n        if (val === undefined || val === null) {\n          continue;\n        }\n        const rendered = yamlValue(val, 4);\n        if (rendered.startsWith('\\n')) {\n          lines.push(`${indent3}${key}:${rendered}`);\n        } else {\n          lines.push(`${indent3}${key}: ${rendered}`);\n        }\n      }\n    }\n  }\n\n  // secureJsonData section\n  // In export mode, the Grafana API returns `secureJsonFields: { key: true }` indicating which\n  // secure fields are actually configured. Only emit those — not all schema-declared secure fields.\n  // In template mode, emit all schema-declared secure fields with placeholders.\n  const secureJsonFields = (values?.secureJsonFields ?? {}) as Record<string, boolean>;\n  const inferredSecureKeys = !isTemplate ? inferSecureJsonDataKeys(jsonDataValues) : [];\n\n  // Filter secure fields: in export mode, only emit fields that are actually set on the datasource\n  const activeSecureFields = isTemplate\n    ? allSecureJsonDataFields\n    : allSecureJsonDataFields.filter((f) => secureJsonFields[f.key] === true);\n\n  if (activeSecureFields.length > 0 || inferredSecureKeys.length > 0) {\n    lines.push(`${indent2}secureJsonData:`);\n    for (const field of activeSecureFields) {\n      emittedSecureJsonDataKeys.add(field.key);\n      if (showComments) {\n        lines.push(fieldComment(field, indent3));\n      }\n      lines.push(`${indent3}${field.key}: ${secretPlaceholder(field)}`);\n    }\n    // Inferred secure keys (e.g. httpHeaderValue1 matching httpHeaderName1)\n    for (const key of inferredSecureKeys) {\n      if (emittedSecureJsonDataKeys.has(key)) {\n        continue;\n      }\n      lines.push(`${indent3}${key}: xxxxxx`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Infer secureJsonData keys from jsonData keys.\n * For example, httpHeaderName1 → httpHeaderValue1 (Grafana's indexedPair convention).\n */\nfunction inferSecureJsonDataKeys(jsonData: Record<string, unknown> | undefined): string[] {\n  if (!jsonData) {\n    return [];\n  }\n  const keys: string[] = [];\n  for (const key of Object.keys(jsonData)) {\n    const match = key.match(/^httpHeaderName(\\d+)$/);\n    if (match) {\n      keys.push(`httpHeaderValue${match[1]}`);\n    }\n  }\n  return keys;\n}\n\n/** Retrieve a nested value for a jsonData/secureJsonData field from a flat or nested values object. */\nfunction getNestedValue(values: Record<string, unknown>, target: string, field: ConfigField): unknown {\n  const nested = values[target];\n  if (nested && typeof nested === 'object') {\n    return (nested as Record<string, unknown>)[field.key];\n  }\n  return undefined;\n}\n\n/**\n * Generate provisioning YAML from an existing Grafana datasource API response.\n * If a dsconfig schema is available, uses it for field ordering and comments.\n * If not, generates basic YAML from the raw API response.\n */\nexport function datasourceToProvisioningYaml(\n  ds: Record<string, unknown>,\n  schema: DatasourceConfigSchema | null\n): string {\n  if (schema) {\n    return toProvisioningYaml(schema, ds, { comments: false });\n  }\n\n  // No schema — generate basic YAML from the raw API response\n  const lines: string[] = [];\n  lines.push('apiVersion: 1');\n  lines.push('');\n  lines.push('datasources:');\n  lines.push(`  - name: ${yamlString(ds.name)}`);\n  if (ds.uid) {\n    lines.push(`    uid: ${yamlString(ds.uid)}`);\n  }\n  lines.push(`    type: ${yamlString(ds.type)}`);\n  if (ds.url) {\n    lines.push(`    url: ${yamlString(ds.url)}`);\n  }\n  if (ds.database) {\n    lines.push(`    database: ${yamlString(ds.database)}`);\n  }\n  if (ds.isDefault) {\n    lines.push('    isDefault: true');\n  }\n  if (ds.basicAuth) {\n    lines.push('    basicAuth: true');\n    if (ds.basicAuthUser) {\n      lines.push(`    basicAuthUser: ${yamlString(ds.basicAuthUser)}`);\n    }\n  }\n\n  const jsonData = ds.jsonData as Record<string, unknown> | undefined;\n  if (jsonData && Object.keys(jsonData).length > 0) {\n    lines.push('    jsonData:');\n    for (const [key, val] of Object.entries(jsonData)) {\n      const rendered = yamlValue(val, 4);\n      if (rendered.startsWith('\\n')) {\n        lines.push(`      ${key}:${rendered}`);\n      } else {\n        lines.push(`      ${key}: ${rendered}`);\n      }\n    }\n  }\n\n  // secureJsonData is never returned by the API — emit placeholder comment\n  lines.push('    # secureJsonData: (secrets are not exported — add manually)');\n  lines.push('    #   mySecret: xxxxxx');\n\n  return lines.join('\\n');\n}\n\nfunction getYamlRenderOptions(ds: Record<string, unknown>): Required<YamlRenderOptions> {\n  return {\n    jsonDataKeys: Object.keys((ds.jsonData ?? {}) as Record<string, unknown>).sort(),\n    secureKeys: [\n      ...new Set([\n        ...Object.keys((ds.secureJsonData ?? {}) as Record<string, unknown>),\n        ...Object.keys((ds.secureJsonFields ?? {}) as Record<string, boolean>),\n      ]),\n    ].sort(),\n  };\n}\n\nexport const configToYaml = (ds: Record<string, unknown>, options: YamlRenderOptions = {}): string => {\n  const { jsonDataKeys, secureKeys } = {\n    ...getYamlRenderOptions(ds),\n    ...options,\n  };\n  const root: Record<string, unknown> = {};\n\n  for (const key of ROOT_CONFIG_FIELDS) {\n    root[key] = ds[key] ?? '';\n  }\n\n  const jsonData = (ds.jsonData ?? {}) as Record<string, unknown>;\n  if (jsonDataKeys.length > 0) {\n    const jsonDataYaml: Record<string, unknown> = {};\n    for (const key of jsonDataKeys) {\n      jsonDataYaml[key] = jsonData[key] ?? '';\n    }\n    root.jsonData = jsonDataYaml;\n  }\n\n  if (secureKeys.length > 0) {\n    const secureJsonData: Record<string, string> = {};\n    for (const key of secureKeys) {\n      secureJsonData[key] = '********';\n    }\n    root.secureJsonData = secureJsonData;\n  }\n\n  return yaml.dump(root, { lineWidth: -1, sortKeys: false, noRefs: true }).trimEnd();\n};\n\nexport const formatYamlDiff = (existing: Record<string, unknown>, body: Record<string, unknown>): string => {\n  const updated = { ...existing, ...body };\n\n  const existingJD = (existing.jsonData ?? {}) as Record<string, unknown>;\n  const updatedJD = (updated.jsonData ?? {}) as Record<string, unknown>;\n  const jsonDataKeys = [...new Set([...Object.keys(existingJD), ...Object.keys(updatedJD)])].sort();\n\n  const secureKeys = [\n    ...new Set([\n      ...Object.keys((existing.secureJsonData ?? {}) as Record<string, unknown>),\n      ...Object.keys((existing.secureJsonFields ?? {}) as Record<string, boolean>),\n      ...Object.keys((updated.secureJsonData ?? {}) as Record<string, unknown>),\n      ...Object.keys((updated.secureJsonFields ?? {}) as Record<string, boolean>),\n    ]),\n  ].sort();\n\n  const currentYaml = configToYaml(existing, { jsonDataKeys, secureKeys });\n  const updatedYaml = configToYaml(updated, { jsonDataKeys, secureKeys });\n\n  const oldLines = currentYaml.split('\\n');\n  const newLines = updatedYaml.split('\\n');\n  const maxLen = Math.max(oldLines.length, newLines.length);\n  const diffLines: string[] = [];\n\n  for (let i = 0; i < maxLen; i++) {\n    const oldLine = oldLines[i];\n    const newLine = newLines[i];\n    if (oldLine === newLine) {\n      diffLines.push(` ${oldLine}`);\n      continue;\n    }\n    if (oldLine !== undefined) {\n      diffLines.push(`-${oldLine}`);\n    }\n    if (newLine !== undefined) {\n      diffLines.push(`+${newLine}`);\n    }\n  }\n\n  return '```diff\\n' + diffLines.join('\\n') + '\\n```';\n};\n"],"names":[],"mappings":"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"}

package/dist/esm/schema/utils/useDatasourceSchema.js

@@ -0,0 +1,16 @@
+import { useMemo } from 'react';
+import { getConfigSchema } from '../registry/index.js';
+
+function useDatasourceSchema(pluginType) {
+  const schema = useMemo(() => fetchConfigSchema(pluginType), [pluginType]);
+  return { schema, loading: false, error: null };
+}
+function fetchConfigSchema(pluginType) {
+  if (!pluginType) {
+    return null;
+  }
+  return getConfigSchema(pluginType);
+}
+
+export { fetchConfigSchema, useDatasourceSchema };
+//# sourceMappingURL=useDatasourceSchema.js.map

package/dist/esm/schema/utils/useDatasourceSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDatasourceSchema.js","sources":["../../../../src/schema/utils/useDatasourceSchema.ts"],"sourcesContent":["import { useMemo } from 'react';\nimport { getConfigSchema } from '../registry';\nimport type { DatasourceConfigSchema } from '../schema';\n\ntype UseDatasourceSchemaResult = { schema: DatasourceConfigSchema | null; loading: boolean; error: string | null };\n\nexport function useDatasourceSchema(pluginType: string): UseDatasourceSchemaResult {\n  const schema = useMemo(() => fetchConfigSchema(pluginType), [pluginType]);\n  return { schema, loading: false, error: null };\n}\n\nexport function fetchConfigSchema(pluginType: string): DatasourceConfigSchema | null {\n  if (!pluginType) {\n    return null;\n  }\n  return getConfigSchema(pluginType);\n}\n"],"names":[],"mappings":";;;AAMO,SAAS,oBAAoB,UAAA,EAA+C;AACjF,EAAA,MAAM,MAAA,GAAS,QAAQ,MAAM,iBAAA,CAAkB,UAAU,CAAA,EAAG,CAAC,UAAU,CAAC,CAAA;AACxE,EAAA,OAAO,EAAE,MAAA,EAAQ,OAAA,EAAS,KAAA,EAAO,OAAO,IAAA,EAAK;AAC/C;AAEO,SAAS,kBAAkB,UAAA,EAAmD;AACnF,EAAA,IAAI,CAAC,UAAA,EAAY;AACf,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,gBAAgB,UAAU,CAAA;AACnC;;;;"}

package/dist/esm/schemas.d.ts

@@ -0,0 +1,448 @@
+interface DatasourceConfigSchema {
+    /**
+     * Schema version (required)
+     * Used for compatibility and migrations
+     *
+     * Example: "v2"
+     */
+    schemaVersion: string;
+    /**
+     * Unique datasource plugin identifier
+     * Example: "prometheus"
+     */
+    pluginType: string;
+    /**
+     * Human-readable name
+     */
+    pluginName: string;
+    /**
+     * Optional documentation URL
+     */
+    docURL?: string;
+    /**
+     * Source of truth for configuration
+     */
+    fields: ConfigField[];
+    /**
+     * Optional UI grouping
+     */
+    groups?: ConfigGroup[];
+    /**
+     * Relationships between fields
+     */
+    relationships?: FieldRelationship[];
+}
+interface ConfigField {
+    /**
+     * Globally unique identifier
+     * Recommended format: dot-separated path
+     * Example: "auth.method", "httpHeaders.item.key"
+     */
+    id: string;
+    /**
+     * Local key used in storage or object
+     */
+    key: string;
+    /**
+     * UI metadata
+     */
+    label?: string;
+    description?: string;
+    docURL?: string;
+    /**
+     * Core type of the field
+     */
+    valueType: ValueType;
+    /**
+     * Semantic meaning (optional)
+     */
+    semanticType?: SemanticType;
+    /**
+     * Storage location (required for storage fields)
+     */
+    target?: TargetLocation;
+    /**
+     * Dotted path prefix within the target for nested objects.
+     * Example: for jsonData.tracesToLogs.datasourceUid,
+     * target="jsonData", section="tracesToLogs", key="datasourceUid".
+     */
+    section?: string;
+    /**
+     * Field kind.
+     * @default "storage"
+     */
+    kind?: FieldKind;
+    /**
+     * True if field belongs to array item schema
+     */
+    isItemField?: boolean;
+    /**
+     * Lifecycle state
+     */
+    lifecycle?: Lifecycle;
+    /**
+     * UI rendering hints
+     */
+    ui?: FieldUI;
+    /**
+     * Validations rules
+     */
+    validations?: FieldValidationRule[];
+    /**
+     * Visibility condition (CEL expression)
+     */
+    dependsOn?: Expression;
+    /**
+     * Always required
+     */
+    required?: boolean;
+    /**
+     * Conditionally required
+     */
+    requiredWhen?: Expression;
+    /**
+     * Disabled condition
+     */
+    disabledWhen?: Expression;
+    /**
+     * Dynamic overrides
+     */
+    overrides?: FieldOverride[];
+    /**
+     * Declarative multi-field write side-effects.
+     * When this field's value matches a condition, the listed target
+     * fields are set to specified values. Typically used on virtual
+     * selector fields (e.g. auth method dropdown).
+     */
+    effects?: FieldEffect[];
+    /**
+     * Item schema for array elements or map values.
+     * Required if valueType === "array" or "map".
+     */
+    item?: FieldItemSchema;
+    /**
+     * Legacy indexed fields (deprecated)
+     */
+    repeatable?: boolean;
+    pattern?: string;
+    /**
+     * Storage mapping
+     */
+    storage?: StorageMapping;
+    /**
+     * Metadata
+     */
+    tags?: string[];
+    examples?: unknown[];
+    defaultValue?: unknown;
+}
+interface FieldItemSchema {
+    /**
+     * Type of array items or map values.
+     * For arrays, describes each element.
+     * For maps, describes each value (keys are always strings).
+     */
+    valueType: ValueType;
+    /**
+     * Sub-fields for object items. Optional even when valueType = "object"
+     * (omitting allows an unconstrained object).
+     */
+    fields?: ConfigField[];
+}
+/**
+ * CEL expression string
+ */
+type Expression = string;
+type ValueType = 'string' | 'number' | 'boolean' | 'array' | 'object' | 'map' | 'any';
+type SemanticType = 'url' | 'password' | 'token' | 'hostname' | 'duration' | 'datasourceUid' | 'query';
+type FieldKind = 'storage' | 'virtual';
+type Lifecycle = 'stable' | 'deprecated' | 'experimental';
+type TargetLocation = 'root' | 'jsonData' | 'secureJsonData';
+type UIComponent = 'input' | 'textarea' | 'select' | 'multiselect' | 'radio' | 'checkbox' | 'switch' | 'code' | 'keyvalue' | 'list' | 'fileUpload';
+type UIWidth = 'full' | 'half';
+/**
+ * UI configuration
+ */
+interface FieldUI {
+    component: UIComponent;
+    multiline?: boolean;
+    rows?: number;
+    options?: FieldOption[];
+    allowCustom?: boolean;
+    width?: UIWidth;
+    placeholder?: string;
+    /**
+     * Language hint for code editor components.
+     * Example: "promql", "logql", "traceql", "sql", "json"
+     */
+    language?: string;
+    /**
+     * Layout row index for item fields inside object arrays.
+     * Fields with the same row number are rendered horizontally.
+     * Fields without a row number use auto-layout:
+     * - ≤3 fields: all on one row
+     * - >3 fields: each on its own row
+     */
+    row?: number;
+    /**
+     * Accepted file types for fileUpload component.
+     * Uses HTML accept attribute format with leading dot.
+     * Example: [".json"]
+     */
+    accept?: string[];
+    /**
+     * Maps keys in an uploaded JSON file to target field IDs.
+     * Used by fileUpload to distribute parsed values to other form fields.
+     * Example: { "private_key": "secureJsonData.privateKey", "client_email": "jsonData.clientEmail" }
+     */
+    fileMapping?: Record<string, string>;
+}
+type FieldValidationRule = PatternValidationRule | RangeValidationRule | LengthValidationRule | ItemCountValidationRule | AllowedValuesValidationRule | CustomValidationRule;
+interface BaseValidationRule {
+    /**
+     * Optional stable ID for the validation rule.
+     * Useful for docs, localization, and test snapshots.
+     */
+    id?: string;
+    /**
+     * Human-readable validation error message.
+     */
+    message?: string;
+}
+interface PatternValidationRule extends BaseValidationRule {
+    type: 'pattern';
+    pattern: string;
+}
+interface RangeValidationRule extends BaseValidationRule {
+    type: 'range';
+    min?: number;
+    max?: number;
+}
+interface LengthValidationRule extends BaseValidationRule {
+    type: 'length';
+    min?: number;
+    max?: number;
+}
+interface ItemCountValidationRule extends BaseValidationRule {
+    type: 'itemCount';
+    min?: number;
+    max?: number;
+}
+interface AllowedValuesValidationRule extends BaseValidationRule {
+    type: 'allowedValues';
+    values: unknown[];
+}
+interface CustomValidationRule extends BaseValidationRule {
+    type: 'custom';
+    /**
+     * CEL expression.
+     *
+     * Should evaluate to true when the field value is valid.
+     */
+    expression: Expression;
+}
+interface FieldOverride {
+    /**
+     * CEL condition
+     */
+    when: Expression;
+    defaultValue?: unknown;
+    /**
+     * When true, the field is disabled/read-only while this override is active.
+     */
+    readOnly?: boolean;
+    description?: string;
+    placeholder?: string;
+    tooltip?: string;
+    validations?: FieldValidationRule[];
+    options?: FieldOption[];
+    /**
+     * When present on an `isItemField` field, the value is routed to
+     * `secureJsonData` under the resolved key instead of being stored
+     * inline in the parent array.
+     *
+     * The template string supports placeholders:
+     * - `{index}`  — 0-based array position
+     * - `{index1}` — 1-based array position
+     * - `{item.KEY}` — value of sibling item field `KEY`
+     *
+     * Examples:
+     * - `"secureHttpHeaders.{item.name}"` (ClickHouse)
+     * - `"httpHeaderValue{index1}"` (Grafana core headers)
+     */
+    secureKey?: string;
+}
+/**
+ * Declares that when a field's value matches a condition,
+ * listed target fields should be set to specified values.
+ *
+ * Use "value" in the `when` expression to refer to the field's value.
+ */
+interface FieldEffect {
+    /**
+     * CEL expression. Example: "value == 'basic-auth'"
+     */
+    when: Expression;
+    /**
+     * Maps field IDs to the values they should be set to.
+     * Must contain at least one entry.
+     */
+    set: Record<string, unknown> & {
+        [k: string]: unknown;
+    };
+}
+type StorageMapping = DirectMapping | IndexedPairMapping | ComputedMapping;
+/**
+ * Direct mapping
+ */
+interface DirectMapping {
+    type: 'direct';
+}
+/**
+ * Indexed pair mapping (headers)
+ */
+interface IndexedPairMapping {
+    type: 'indexedPair';
+    key: MappingField;
+    value: MappingField;
+    startIndex?: number;
+}
+/**
+ * Computed mapping (virtual fields).
+ * At least one of `read` or `write` must be provided.
+ */
+type ComputedMapping = {
+    type: 'computed';
+    read: Expression;
+    write?: Expression;
+} | {
+    type: 'computed';
+    read?: Expression;
+    write: Expression;
+};
+/**
+ * Mapping field
+ */
+interface MappingField {
+    target: TargetLocation;
+    pattern: string;
+}
+interface FieldOption {
+    label: string;
+    /**
+     * Must match parent field valueType.
+     * Must not be null.
+     */
+    value: NonNullable<unknown>;
+    /**
+     * Optional human-readable description of the option.
+     */
+    description?: string;
+}
+interface ConfigGroup {
+    id: string;
+    title: string;
+    description?: string;
+    order?: number;
+    /**
+     * When true, the group is optional and can be collapsed/hidden by default.
+     */
+    optional?: boolean;
+    /**
+     * References field IDs (not keys)
+     */
+    fieldRefs: string[];
+}
+type RelationshipType = 'pair' | 'group' | 'datasourceReference';
+interface FieldRelationship {
+    type: RelationshipType;
+    /**
+     * References field IDs
+     */
+    fields: string[];
+    description?: string;
+    /**
+     * Constrains the datasource UID to a specific plugin type.
+     * Only applicable when type is "datasourceReference".
+     */
+    targetPluginType?: string;
+}
+type SecureFieldState = {
+    type: 'unset';
+} | {
+    type: 'configured';
+} | {
+    type: 'updated';
+    value: string;
+};
+interface FormState {
+    values: Record<string, unknown>;
+    secure: Record<string, SecureFieldState>;
+}
+
+declare function getConfigSchema(pluginType: string): DatasourceConfigSchema | null;
+
+/**
+ * Generate LLM hints for select fields (used when creating datasources).
+ */
+declare function generateLLMHint(schema: DatasourceConfigSchema): string;
+/**
+ * Generate comprehensive structured field data for troubleshooting context.
+ * Returns an array of field descriptors the LLM can use to render rich tables.
+ */
+declare function generateTroubleshootingFields(schema: DatasourceConfigSchema): Array<{
+    label: string;
+    key: string;
+    target: string;
+    type: string;
+    required: boolean;
+    description?: string;
+    defaultValue?: unknown;
+    options?: string[];
+    section?: string;
+    dependsOn?: string;
+}>;
+
+type YamlRenderOptions = {
+    jsonDataKeys?: string[];
+    secureKeys?: string[];
+};
+type ProvisioningYamlOptions = {
+    /** Include comments with field descriptions. Default: true for template, false for export. */
+    comments?: boolean;
+    /** Name override (used in template mode). */
+    name?: string;
+};
+/**
+ * Generate a Grafana provisioning YAML from a dsconfig schema.
+ * In template mode (no values), emits all fields with defaults and comments.
+ * When values are provided, emits actual values — used for existing datasource export.
+ */
+declare function toProvisioningYaml(schema: DatasourceConfigSchema, values?: Record<string, unknown>, options?: ProvisioningYamlOptions): string;
+/**
+ * Generate provisioning YAML from an existing Grafana datasource API response.
+ * If a dsconfig schema is available, uses it for field ordering and comments.
+ * If not, generates basic YAML from the raw API response.
+ */
+declare function datasourceToProvisioningYaml(ds: Record<string, unknown>, schema: DatasourceConfigSchema | null): string;
+declare const configToYaml: (ds: Record<string, unknown>, options?: YamlRenderOptions) => string;
+declare const formatYamlDiff: (existing: Record<string, unknown>, body: Record<string, unknown>) => string;
+
+type UseDatasourceSchemaResult = {
+    schema: DatasourceConfigSchema | null;
+    loading: boolean;
+    error: string | null;
+};
+declare function useDatasourceSchema(pluginType: string): UseDatasourceSchemaResult;
+declare function fetchConfigSchema(pluginType: string): DatasourceConfigSchema | null;
+
+declare const ROOT_CONFIG_FIELDS: readonly ["name", "type", "id", "uid", "access", "url", "basicAuth", "basicAuthUser", "user", "isDefault", "database", "withCredentials"];
+type DatasourceConfig = Record<any, any>;
+declare const buildCreateDatasourcePayload: (input: DatasourceConfig) => DatasourceConfig;
+declare const buildCloneDatasourcePayload: (source: DatasourceConfig, name: string) => DatasourceConfig;
+declare const buildUpdateDatasourcePayload: (existing: DatasourceConfig, input: DatasourceConfig) => {
+    body: DatasourceConfig;
+    hasChanges: boolean;
+};
+
+export { type AllowedValuesValidationRule, type BaseValidationRule, type ComputedMapping, type ConfigField, type ConfigGroup, type CustomValidationRule, type DatasourceConfigSchema, type DirectMapping, type Expression, type FieldEffect, type FieldItemSchema, type FieldKind, type FieldOption, type FieldOverride, type FieldRelationship, type FieldUI, type FieldValidationRule, type FormState, type IndexedPairMapping, type ItemCountValidationRule, type LengthValidationRule, type Lifecycle, type MappingField, type PatternValidationRule, type ProvisioningYamlOptions, ROOT_CONFIG_FIELDS, type RangeValidationRule, type RelationshipType, type SecureFieldState, type SemanticType, type StorageMapping, type TargetLocation, type UIComponent, type UIWidth, type ValueType, buildCloneDatasourcePayload, buildCreateDatasourcePayload, buildUpdateDatasourcePayload, configToYaml, datasourceToProvisioningYaml, fetchConfigSchema, formatYamlDiff, generateLLMHint, generateTroubleshootingFields, getConfigSchema, toProvisioningYaml, useDatasourceSchema };

package/dist/esm/schemas.js

@@ -0,0 +1,6 @@
+export { getConfigSchema } from './schema/registry/index.js';
+export { generateLLMHint, generateTroubleshootingFields } from './schema/utils/llm.js';
+export { configToYaml, datasourceToProvisioningYaml, formatYamlDiff, toProvisioningYaml } from './schema/utils/provisioning.js';
+export { fetchConfigSchema, useDatasourceSchema } from './schema/utils/useDatasourceSchema.js';
+export { ROOT_CONFIG_FIELDS, buildCloneDatasourcePayload, buildCreateDatasourcePayload, buildUpdateDatasourcePayload } from './schema/utils/dsconfig.js';
+//# sourceMappingURL=schemas.js.map

package/dist/esm/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

package/dist/esm/test-utils.d.ts

@@ -3,38 +3,38 @@ import { DataSourceInstanceSettings, DataQuery, DataSourcePluginMeta, PluginDepe
 import { DataSourceWithBackend } from '@grafana/runtime';
 
 declare class DatasourceMock extends DataSourceWithBackend {
-    query: jest.Mock<any, any>;
+    query: jest.Mock<any, any, any>;
     filterQuery: any;
-    applyTemplateVariables: jest.Mock<any, any>;
-    getResource: jest.Mock<any, any>;
-    postResource: jest.Mock<any, any>;
-    callHealthCheck: jest.Mock<any, any>;
-    testDatasource: jest.Mock<any, any>;
+    applyTemplateVariables: jest.Mock<any, any, any>;
+    getResource: jest.Mock<any, any, any>;
+    postResource: jest.Mock<any, any, any>;
+    callHealthCheck: jest.Mock<any, any, any>;
+    testDatasource: jest.Mock<any, any, any>;
     uid: string;
     name: string;
     id: number;
     type: string;
     interval: string;
-    importQueries: jest.Mock<any, any>;
-    init: jest.Mock<any, any>;
-    getQueryHints: jest.Mock<any, any>;
-    getQueryDisplayText: jest.Mock<any, any>;
-    metricFindQuery: jest.Mock<any, any>;
-    getTagKeys: jest.Mock<any, any>;
-    getTagValues: jest.Mock<any, any>;
+    importQueries: jest.Mock<any, any, any>;
+    init: jest.Mock<any, any, any>;
+    getQueryHints: jest.Mock<any, any, any>;
+    getQueryDisplayText: jest.Mock<any, any, any>;
+    metricFindQuery: jest.Mock<any, any, any>;
+    getTagKeys: jest.Mock<any, any, any>;
+    getTagValues: jest.Mock<any, any, any>;
     components: {};
     meta: _grafana_data.DataSourcePluginMeta<{}>;
-    targetContainsTemplate: jest.Mock<any, any>;
-    modifyQuery: jest.Mock<any, any>;
-    getHighlighterExpression: jest.Mock<any, any>;
-    languageProvider: jest.Mock<any, any>;
-    getVersion: jest.Mock<any, any>;
-    interpolateVariablesInQueries: jest.Mock<any, any>;
+    targetContainsTemplate: jest.Mock<any, any, any>;
+    modifyQuery: jest.Mock<any, any, any>;
+    getHighlighterExpression: jest.Mock<any, any, any>;
+    languageProvider: jest.Mock<any, any, any>;
+    getVersion: jest.Mock<any, any, any>;
+    interpolateVariablesInQueries: jest.Mock<any, any, any>;
     annotations: {};
-    annotationQuery: jest.Mock<any, any>;
-    streamOptionsProvider: jest.Mock<any, any>;
-    getRef: jest.Mock<any, any>;
-    protected getRequestHeaders: jest.Mock<any, any>;
+    annotationQuery: jest.Mock<any, any, any>;
+    streamOptionsProvider: jest.Mock<any, any, any>;
+    getRef: jest.Mock<any, any, any>;
+    protected getRequestHeaders: jest.Mock<any, any, any>;
 }
 declare const mockDatasource: () => DatasourceMock;
 declare const mockDatasourceInstanceSettings: () => DataSourceInstanceSettings;