@grafana/plugin-compat 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+# 0.5.0 (2026-10-12)
+
+`getPluginSettings` and `updateAppPluginSettings` now use the host's stable `@grafana/runtime` exports when available, then `@grafana/runtime/unstable`, then the legacy `getBackendSrv()` plugin-settings endpoints, so they keep working once the host removes them from `unstable`.
+
+Add `useDataSourceInstance` to `@grafana/plugin-compat/datasources`. It uses the host's stable `@grafana/runtime` hook when available, then `@grafana/runtime/unstable`, then resolves through `getDataSourceInstance`, so it works on hosts without the async data source hooks.
+
 # 0.4.0 (2026-10-09)
 
 The data source functions now use the host's stable `@grafana/runtime` exports when available, then `@grafana/runtime/unstable`, then the legacy `getDataSourceSrv()` APIs, so they keep working on hosts that only expose the async APIs under `unstable`.

package/dist/cjs/apps.cjs

@@ -7,6 +7,9 @@ var unstable = require('@grafana/runtime/unstable');
 
 "use strict";
 async function getPluginSettings(pluginId, showErrorAlert = false) {
+  if (typeof runtime.getPluginSettings === "function") {
+    return runtime.getPluginSettings(pluginId, showErrorAlert);
+  }
   if (typeof unstable.getPluginSettings === "function") {
     return unstable.getPluginSettings(pluginId, showErrorAlert);
   }
@@ -19,6 +22,9 @@ async function backwardsCompatibleGetPluginSettings(pluginId, showErrorAlert = f
   });
 }
 async function updateAppPluginSettings(pluginId, data) {
+  if (typeof runtime.updateAppPluginSettings === "function") {
+    return runtime.updateAppPluginSettings(pluginId, data);
+  }
   if (typeof unstable.updateAppPluginSettings === "function") {
     return unstable.updateAppPluginSettings(pluginId, data);
   }

package/dist/cjs/apps.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"apps.cjs","sources":["../../src/apps.ts"],"sourcesContent":["import { type PluginMeta } from '@grafana/data';\nimport { getBackendSrv } from '@grafana/runtime';\nimport {\n  getPluginSettings as runtimeGetPluginSettings,\n  updateAppPluginSettings as runtimeUpdateAppPluginSettings,\n} from '@grafana/runtime/unstable';\n\nexport async function getPluginSettings(pluginId: string, showErrorAlert = false): Promise<PluginMeta> {\n  if (typeof runtimeGetPluginSettings === 'function') {\n    return runtimeGetPluginSettings(pluginId, showErrorAlert);\n  }\n\n  return backwardsCompatibleGetPluginSettings(pluginId, showErrorAlert);\n}\n\nasync function backwardsCompatibleGetPluginSettings(pluginId: string, showErrorAlert = false): Promise<PluginMeta> {\n  return getBackendSrv().get(`/api/plugins/${pluginId}/settings`, undefined, undefined, {\n    showErrorAlert,\n    validatePath: true,\n  });\n}\n\nexport async function updateAppPluginSettings(pluginId: string, data: Partial<PluginMeta>): Promise<PluginMeta> {\n  if (typeof runtimeUpdateAppPluginSettings === 'function') {\n    return runtimeUpdateAppPluginSettings(pluginId, data);\n  }\n\n  return backwardsCompatibleUpdatePluginSettings(pluginId, data);\n}\n\nasync function backwardsCompatibleUpdatePluginSettings(\n  pluginId: string,\n  data: Partial<PluginMeta>\n): Promise<PluginMeta> {\n  await getBackendSrv().post(`/api/plugins/${pluginId}/settings`, data, { validatePath: true });\n  return backwardsCompatibleGetPluginSettings(pluginId);\n}\n"],"names":["runtimeGetPluginSettings","getBackendSrv","runtimeUpdateAppPluginSettings"],"mappings":";;;;;;;;AAOA,eAAsB,iBAAA,CAAkB,QAAA,EAAkB,cAAA,GAAiB,KAAA,EAA4B;AACrG,EAAA,IAAI,OAAOA,+BAA6B,UAAA,EAAY;AAClD,IAAA,OAAOA,0BAAA,CAAyB,UAAU,cAAc,CAAA;AAAA,EAC1D;AAEA,EAAA,OAAO,oCAAA,CAAqC,UAAU,cAAc,CAAA;AACtE;AAEA,eAAe,oCAAA,CAAqC,QAAA,EAAkB,cAAA,GAAiB,KAAA,EAA4B;AACjH,EAAA,OAAOC,uBAAc,CAAE,GAAA,CAAI,gBAAgB,QAAQ,CAAA,SAAA,CAAA,EAAa,QAAW,KAAA,CAAA,EAAW;AAAA,IACpF,cAAA;AAAA,IACA,YAAA,EAAc;AAAA,GACf,CAAA;AACH;AAEA,eAAsB,uBAAA,CAAwB,UAAkB,IAAA,EAAgD;AAC9G,EAAA,IAAI,OAAOC,qCAAmC,UAAA,EAAY;AACxD,IAAA,OAAOA,gCAAA,CAA+B,UAAU,IAAI,CAAA;AAAA,EACtD;AAEA,EAAA,OAAO,uCAAA,CAAwC,UAAU,IAAI,CAAA;AAC/D;AAEA,eAAe,uCAAA,CACb,UACA,IAAA,EACqB;AACrB,EAAA,MAAMD,qBAAA,EAAc,CAAE,IAAA,CAAK,CAAA,aAAA,EAAgB,QAAQ,aAAa,IAAA,EAAM,EAAE,YAAA,EAAc,IAAA,EAAM,CAAA;AAC5F,EAAA,OAAO,qCAAqC,QAAQ,CAAA;AACtD;;;;;"}
+{"version":3,"file":"apps.cjs","sources":["../../src/apps.ts"],"sourcesContent":["import { type PluginMeta } from '@grafana/data';\nimport {\n  getBackendSrv,\n  getPluginSettings as stableGetPluginSettings,\n  updateAppPluginSettings as stableUpdateAppPluginSettings,\n} from '@grafana/runtime';\nimport {\n  getPluginSettings as unstableGetPluginSettings,\n  updateAppPluginSettings as unstableUpdateAppPluginSettings,\n} from '@grafana/runtime/unstable';\n\nexport async function getPluginSettings(pluginId: string, showErrorAlert = false): Promise<PluginMeta> {\n  if (typeof stableGetPluginSettings === 'function') {\n    return stableGetPluginSettings(pluginId, showErrorAlert);\n  }\n\n  if (typeof unstableGetPluginSettings === 'function') {\n    return unstableGetPluginSettings(pluginId, showErrorAlert);\n  }\n\n  return backwardsCompatibleGetPluginSettings(pluginId, showErrorAlert);\n}\n\nasync function backwardsCompatibleGetPluginSettings(pluginId: string, showErrorAlert = false): Promise<PluginMeta> {\n  return getBackendSrv().get(`/api/plugins/${pluginId}/settings`, undefined, undefined, {\n    showErrorAlert,\n    validatePath: true,\n  });\n}\n\nexport async function updateAppPluginSettings(pluginId: string, data: Partial<PluginMeta>): Promise<PluginMeta> {\n  if (typeof stableUpdateAppPluginSettings === 'function') {\n    return stableUpdateAppPluginSettings(pluginId, data);\n  }\n\n  if (typeof unstableUpdateAppPluginSettings === 'function') {\n    return unstableUpdateAppPluginSettings(pluginId, data);\n  }\n\n  return backwardsCompatibleUpdatePluginSettings(pluginId, data);\n}\n\nasync function backwardsCompatibleUpdatePluginSettings(\n  pluginId: string,\n  data: Partial<PluginMeta>\n): Promise<PluginMeta> {\n  await getBackendSrv().post(`/api/plugins/${pluginId}/settings`, data, { validatePath: true });\n  return backwardsCompatibleGetPluginSettings(pluginId);\n}\n"],"names":["stableGetPluginSettings","unstableGetPluginSettings","getBackendSrv","stableUpdateAppPluginSettings","unstableUpdateAppPluginSettings"],"mappings":";;;;;;;;AAWA,eAAsB,iBAAA,CAAkB,QAAA,EAAkB,cAAA,GAAiB,KAAA,EAA4B;AACrG,EAAA,IAAI,OAAOA,8BAA4B,UAAA,EAAY;AACjD,IAAA,OAAOA,yBAAA,CAAwB,UAAU,cAAc,CAAA;AAAA,EACzD;AAEA,EAAA,IAAI,OAAOC,+BAA8B,UAAA,EAAY;AACnD,IAAA,OAAOA,0BAAA,CAA0B,UAAU,cAAc,CAAA;AAAA,EAC3D;AAEA,EAAA,OAAO,oCAAA,CAAqC,UAAU,cAAc,CAAA;AACtE;AAEA,eAAe,oCAAA,CAAqC,QAAA,EAAkB,cAAA,GAAiB,KAAA,EAA4B;AACjH,EAAA,OAAOC,uBAAc,CAAE,GAAA,CAAI,gBAAgB,QAAQ,CAAA,SAAA,CAAA,EAAa,QAAW,KAAA,CAAA,EAAW;AAAA,IACpF,cAAA;AAAA,IACA,YAAA,EAAc;AAAA,GACf,CAAA;AACH;AAEA,eAAsB,uBAAA,CAAwB,UAAkB,IAAA,EAAgD;AAC9G,EAAA,IAAI,OAAOC,oCAAkC,UAAA,EAAY;AACvD,IAAA,OAAOA,+BAAA,CAA8B,UAAU,IAAI,CAAA;AAAA,EACrD;AAEA,EAAA,IAAI,OAAOC,qCAAoC,UAAA,EAAY;AACzD,IAAA,OAAOA,gCAAA,CAAgC,UAAU,IAAI,CAAA;AAAA,EACvD;AAEA,EAAA,OAAO,uCAAA,CAAwC,UAAU,IAAI,CAAA;AAC/D;AAEA,eAAe,uCAAA,CACb,UACA,IAAA,EACqB;AACrB,EAAA,MAAMF,qBAAA,EAAc,CAAE,IAAA,CAAK,CAAA,aAAA,EAAgB,QAAQ,aAAa,IAAA,EAAM,EAAE,YAAA,EAAc,IAAA,EAAM,CAAA;AAC5F,EAAA,OAAO,qCAAqC,QAAQ,CAAA;AACtD;;;;;"}

package/dist/cjs/datasources/useDataSourceInstance.cjs

@@ -0,0 +1,30 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var react = require('react');
+var runtime = require('@grafana/runtime');
+var unstable = require('@grafana/runtime/unstable');
+var getDataSourceInstance = require('./getDataSourceInstance.cjs');
+
+"use strict";
+const useDataSourceInstance = typeof runtime.useDataSourceInstance === "function" ? runtime.useDataSourceInstance : typeof unstable.useDataSourceInstance === "function" ? unstable.useDataSourceInstance : useBackwardsCompatibleDataSourceInstance;
+function useBackwardsCompatibleDataSourceInstance(ref) {
+  const [result, setResult] = react.useState({ isLoading: true });
+  const refKey = JSON.stringify(ref != null ? ref : null);
+  react.useEffect(() => {
+    let isCurrent = true;
+    setResult((previous) => ({ ...previous, isLoading: true }));
+    getDataSourceInstance.getDataSourceInstance(ref).then(
+      (dataSource) => isCurrent && setResult({ isLoading: false, dataSource }),
+      (error) => isCurrent && setResult({ isLoading: false, error })
+    );
+    return () => {
+      isCurrent = false;
+    };
+  }, [refKey]);
+  return result;
+}
+
+exports.useDataSourceInstance = useDataSourceInstance;
+//# sourceMappingURL=useDataSourceInstance.cjs.map

package/dist/cjs/datasources/useDataSourceInstance.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataSourceInstance.cjs","sources":["../../../src/datasources/useDataSourceInstance.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport { type DataSourceApi } from '@grafana/data';\nimport { useDataSourceInstance as stableUseDataSourceInstance } from '@grafana/runtime';\nimport { useDataSourceInstance as unstableUseDataSourceInstance } from '@grafana/runtime/unstable';\n\nimport { getDataSourceInstance } from './getDataSourceInstance';\nimport { type Ref } from './types';\n\n/** Declared here because `@grafana/runtime` lacks it on older supported hosts. */\nexport interface UseDataSourceInstanceResult {\n  isLoading: boolean;\n  error?: Error;\n  dataSource?: DataSourceApi;\n}\n\n/**\n * Uses the host hook when available. The fallback re-resolves only when `ref` changes, not on data source cache\n * changes. Picked once at load so the hook order stays stable.\n */\nexport const useDataSourceInstance: (ref?: Ref) => UseDataSourceInstanceResult =\n  typeof stableUseDataSourceInstance === 'function'\n    ? stableUseDataSourceInstance\n    : typeof unstableUseDataSourceInstance === 'function'\n      ? unstableUseDataSourceInstance\n      : useBackwardsCompatibleDataSourceInstance;\n\nfunction useBackwardsCompatibleDataSourceInstance(ref?: Ref): UseDataSourceInstanceResult {\n  const [result, setResult] = useState<UseDataSourceInstanceResult>({ isLoading: true });\n  // Same key as the host hook, so inline ref objects don't refetch and `null` matches `undefined`.\n  const refKey = JSON.stringify(ref ?? null);\n\n  useEffect(() => {\n    let isCurrent = true;\n    setResult((previous) => ({ ...previous, isLoading: true }));\n\n    getDataSourceInstance(ref).then(\n      (dataSource) => isCurrent && setResult({ isLoading: false, dataSource }),\n      (error: Error) => isCurrent && setResult({ isLoading: false, error })\n    );\n\n    return () => {\n      isCurrent = false;\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [refKey]);\n\n  return result;\n}\n"],"names":["stableUseDataSourceInstance","unstableUseDataSourceInstance","useState","useEffect","getDataSourceInstance"],"mappings":";;;;;;;;;;AAoBO,MAAM,qBAAA,GACX,OAAOA,6BAAA,KAAgC,UAAA,GACnCA,gCACA,OAAOC,8BAAA,KAAkC,aACvCA,8BAAA,GACA;AAER,SAAS,yCAAyC,GAAA,EAAwC;AACxF,EAAA,MAAM,CAAC,QAAQ,SAAS,CAAA,GAAIC,eAAsC,EAAE,SAAA,EAAW,MAAM,CAAA;AAErF,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,SAAA,CAAU,GAAA,IAAA,IAAA,GAAA,GAAA,GAAO,IAAI,CAAA;AAEzC,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,SAAA,GAAY,IAAA;AAChB,IAAA,SAAA,CAAU,CAAC,QAAA,MAAc,EAAE,GAAG,QAAA,EAAU,SAAA,EAAW,MAAK,CAAE,CAAA;AAE1D,IAAAC,2CAAA,CAAsB,GAAG,CAAA,CAAE,IAAA;AAAA,MACzB,CAAC,eAAe,SAAA,IAAa,SAAA,CAAU,EAAE,SAAA,EAAW,KAAA,EAAO,YAAY,CAAA;AAAA,MACvE,CAAC,UAAiB,SAAA,IAAa,SAAA,CAAU,EAAE,SAAA,EAAW,KAAA,EAAO,OAAO;AAAA,KACtE;AAEA,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,GAAY,KAAA;AAAA,IACd,CAAA;AAAA,EAEF,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,OAAO,MAAA;AACT;;;;"}

package/dist/cjs/datasources.cjs

@@ -7,6 +7,7 @@ var getDataSourceInstanceList = require('./datasources/getDataSourceInstanceList
 var getDataSourceInstanceSettings = require('./datasources/getDataSourceInstanceSettings.cjs');
 var getDefaultDataSourceInstanceListItem = require('./datasources/getDefaultDataSourceInstanceListItem.cjs');
 var registerRuntimeDataSourceInstance = require('./datasources/registerRuntimeDataSourceInstance.cjs');
+var useDataSourceInstance = require('./datasources/useDataSourceInstance.cjs');
 var useDefaultDataSourceInstanceListItem = require('./datasources/useDefaultDataSourceInstanceListItem.cjs');
 
 "use strict";
@@ -16,5 +17,6 @@ exports.getDataSourceInstanceList = getDataSourceInstanceList.getDataSourceInsta
 exports.getDataSourceInstanceSettings = getDataSourceInstanceSettings.getDataSourceInstanceSettings;
 exports.getDefaultDataSourceInstanceListItem = getDefaultDataSourceInstanceListItem.getDefaultDataSourceInstanceListItem;
 exports.registerRuntimeDataSourceInstance = registerRuntimeDataSourceInstance.registerRuntimeDataSourceInstance;
+exports.useDataSourceInstance = useDataSourceInstance.useDataSourceInstance;
 exports.useDefaultDataSourceInstanceListItem = useDefaultDataSourceInstanceListItem.useDefaultDataSourceInstanceListItem;
 //# sourceMappingURL=datasources.cjs.map

package/dist/cjs/datasources.cjs.map

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

package/dist/esm/apps.mjs

@@ -1,11 +1,14 @@
-import { getBackendSrv } from '@grafana/runtime';
-import { getPluginSettings as getPluginSettings$1, updateAppPluginSettings as updateAppPluginSettings$1 } from '@grafana/runtime/unstable';
+import { getPluginSettings as getPluginSettings$1, getBackendSrv, updateAppPluginSettings as updateAppPluginSettings$1 } from '@grafana/runtime';
+import { getPluginSettings as getPluginSettings$2, updateAppPluginSettings as updateAppPluginSettings$2 } from '@grafana/runtime/unstable';
 
 "use strict";
 async function getPluginSettings(pluginId, showErrorAlert = false) {
   if (typeof getPluginSettings$1 === "function") {
     return getPluginSettings$1(pluginId, showErrorAlert);
   }
+  if (typeof getPluginSettings$2 === "function") {
+    return getPluginSettings$2(pluginId, showErrorAlert);
+  }
   return backwardsCompatibleGetPluginSettings(pluginId, showErrorAlert);
 }
 async function backwardsCompatibleGetPluginSettings(pluginId, showErrorAlert = false) {
@@ -18,6 +21,9 @@ async function updateAppPluginSettings(pluginId, data) {
   if (typeof updateAppPluginSettings$1 === "function") {
     return updateAppPluginSettings$1(pluginId, data);
   }
+  if (typeof updateAppPluginSettings$2 === "function") {
+    return updateAppPluginSettings$2(pluginId, data);
+  }
   return backwardsCompatibleUpdatePluginSettings(pluginId, data);
 }
 async function backwardsCompatibleUpdatePluginSettings(pluginId, data) {

package/dist/esm/apps.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"apps.mjs","sources":["../../src/apps.ts"],"sourcesContent":["import { type PluginMeta } from '@grafana/data';\nimport { getBackendSrv } from '@grafana/runtime';\nimport {\n  getPluginSettings as runtimeGetPluginSettings,\n  updateAppPluginSettings as runtimeUpdateAppPluginSettings,\n} from '@grafana/runtime/unstable';\n\nexport async function getPluginSettings(pluginId: string, showErrorAlert = false): Promise<PluginMeta> {\n  if (typeof runtimeGetPluginSettings === 'function') {\n    return runtimeGetPluginSettings(pluginId, showErrorAlert);\n  }\n\n  return backwardsCompatibleGetPluginSettings(pluginId, showErrorAlert);\n}\n\nasync function backwardsCompatibleGetPluginSettings(pluginId: string, showErrorAlert = false): Promise<PluginMeta> {\n  return getBackendSrv().get(`/api/plugins/${pluginId}/settings`, undefined, undefined, {\n    showErrorAlert,\n    validatePath: true,\n  });\n}\n\nexport async function updateAppPluginSettings(pluginId: string, data: Partial<PluginMeta>): Promise<PluginMeta> {\n  if (typeof runtimeUpdateAppPluginSettings === 'function') {\n    return runtimeUpdateAppPluginSettings(pluginId, data);\n  }\n\n  return backwardsCompatibleUpdatePluginSettings(pluginId, data);\n}\n\nasync function backwardsCompatibleUpdatePluginSettings(\n  pluginId: string,\n  data: Partial<PluginMeta>\n): Promise<PluginMeta> {\n  await getBackendSrv().post(`/api/plugins/${pluginId}/settings`, data, { validatePath: true });\n  return backwardsCompatibleGetPluginSettings(pluginId);\n}\n"],"names":["runtimeGetPluginSettings","runtimeUpdateAppPluginSettings"],"mappings":";;;;AAOA,eAAsB,iBAAA,CAAkB,QAAA,EAAkB,cAAA,GAAiB,KAAA,EAA4B;AACrG,EAAA,IAAI,OAAOA,wBAA6B,UAAA,EAAY;AAClD,IAAA,OAAOA,mBAAA,CAAyB,UAAU,cAAc,CAAA;AAAA,EAC1D;AAEA,EAAA,OAAO,oCAAA,CAAqC,UAAU,cAAc,CAAA;AACtE;AAEA,eAAe,oCAAA,CAAqC,QAAA,EAAkB,cAAA,GAAiB,KAAA,EAA4B;AACjH,EAAA,OAAO,eAAc,CAAE,GAAA,CAAI,gBAAgB,QAAQ,CAAA,SAAA,CAAA,EAAa,QAAW,KAAA,CAAA,EAAW;AAAA,IACpF,cAAA;AAAA,IACA,YAAA,EAAc;AAAA,GACf,CAAA;AACH;AAEA,eAAsB,uBAAA,CAAwB,UAAkB,IAAA,EAAgD;AAC9G,EAAA,IAAI,OAAOC,8BAAmC,UAAA,EAAY;AACxD,IAAA,OAAOA,yBAAA,CAA+B,UAAU,IAAI,CAAA;AAAA,EACtD;AAEA,EAAA,OAAO,uCAAA,CAAwC,UAAU,IAAI,CAAA;AAC/D;AAEA,eAAe,uCAAA,CACb,UACA,IAAA,EACqB;AACrB,EAAA,MAAM,aAAA,EAAc,CAAE,IAAA,CAAK,CAAA,aAAA,EAAgB,QAAQ,aAAa,IAAA,EAAM,EAAE,YAAA,EAAc,IAAA,EAAM,CAAA;AAC5F,EAAA,OAAO,qCAAqC,QAAQ,CAAA;AACtD;;;;"}
+{"version":3,"file":"apps.mjs","sources":["../../src/apps.ts"],"sourcesContent":["import { type PluginMeta } from '@grafana/data';\nimport {\n  getBackendSrv,\n  getPluginSettings as stableGetPluginSettings,\n  updateAppPluginSettings as stableUpdateAppPluginSettings,\n} from '@grafana/runtime';\nimport {\n  getPluginSettings as unstableGetPluginSettings,\n  updateAppPluginSettings as unstableUpdateAppPluginSettings,\n} from '@grafana/runtime/unstable';\n\nexport async function getPluginSettings(pluginId: string, showErrorAlert = false): Promise<PluginMeta> {\n  if (typeof stableGetPluginSettings === 'function') {\n    return stableGetPluginSettings(pluginId, showErrorAlert);\n  }\n\n  if (typeof unstableGetPluginSettings === 'function') {\n    return unstableGetPluginSettings(pluginId, showErrorAlert);\n  }\n\n  return backwardsCompatibleGetPluginSettings(pluginId, showErrorAlert);\n}\n\nasync function backwardsCompatibleGetPluginSettings(pluginId: string, showErrorAlert = false): Promise<PluginMeta> {\n  return getBackendSrv().get(`/api/plugins/${pluginId}/settings`, undefined, undefined, {\n    showErrorAlert,\n    validatePath: true,\n  });\n}\n\nexport async function updateAppPluginSettings(pluginId: string, data: Partial<PluginMeta>): Promise<PluginMeta> {\n  if (typeof stableUpdateAppPluginSettings === 'function') {\n    return stableUpdateAppPluginSettings(pluginId, data);\n  }\n\n  if (typeof unstableUpdateAppPluginSettings === 'function') {\n    return unstableUpdateAppPluginSettings(pluginId, data);\n  }\n\n  return backwardsCompatibleUpdatePluginSettings(pluginId, data);\n}\n\nasync function backwardsCompatibleUpdatePluginSettings(\n  pluginId: string,\n  data: Partial<PluginMeta>\n): Promise<PluginMeta> {\n  await getBackendSrv().post(`/api/plugins/${pluginId}/settings`, data, { validatePath: true });\n  return backwardsCompatibleGetPluginSettings(pluginId);\n}\n"],"names":["stableGetPluginSettings","unstableGetPluginSettings","stableUpdateAppPluginSettings","unstableUpdateAppPluginSettings"],"mappings":";;;;AAWA,eAAsB,iBAAA,CAAkB,QAAA,EAAkB,cAAA,GAAiB,KAAA,EAA4B;AACrG,EAAA,IAAI,OAAOA,wBAA4B,UAAA,EAAY;AACjD,IAAA,OAAOA,mBAAA,CAAwB,UAAU,cAAc,CAAA;AAAA,EACzD;AAEA,EAAA,IAAI,OAAOC,wBAA8B,UAAA,EAAY;AACnD,IAAA,OAAOA,mBAAA,CAA0B,UAAU,cAAc,CAAA;AAAA,EAC3D;AAEA,EAAA,OAAO,oCAAA,CAAqC,UAAU,cAAc,CAAA;AACtE;AAEA,eAAe,oCAAA,CAAqC,QAAA,EAAkB,cAAA,GAAiB,KAAA,EAA4B;AACjH,EAAA,OAAO,eAAc,CAAE,GAAA,CAAI,gBAAgB,QAAQ,CAAA,SAAA,CAAA,EAAa,QAAW,KAAA,CAAA,EAAW;AAAA,IACpF,cAAA;AAAA,IACA,YAAA,EAAc;AAAA,GACf,CAAA;AACH;AAEA,eAAsB,uBAAA,CAAwB,UAAkB,IAAA,EAAgD;AAC9G,EAAA,IAAI,OAAOC,8BAAkC,UAAA,EAAY;AACvD,IAAA,OAAOA,yBAAA,CAA8B,UAAU,IAAI,CAAA;AAAA,EACrD;AAEA,EAAA,IAAI,OAAOC,8BAAoC,UAAA,EAAY;AACzD,IAAA,OAAOA,yBAAA,CAAgC,UAAU,IAAI,CAAA;AAAA,EACvD;AAEA,EAAA,OAAO,uCAAA,CAAwC,UAAU,IAAI,CAAA;AAC/D;AAEA,eAAe,uCAAA,CACb,UACA,IAAA,EACqB;AACrB,EAAA,MAAM,aAAA,EAAc,CAAE,IAAA,CAAK,CAAA,aAAA,EAAgB,QAAQ,aAAa,IAAA,EAAM,EAAE,YAAA,EAAc,IAAA,EAAM,CAAA;AAC5F,EAAA,OAAO,qCAAqC,QAAQ,CAAA;AACtD;;;;"}

package/dist/esm/datasources/useDataSourceInstance.mjs

@@ -0,0 +1,26 @@
+import { useState, useEffect } from 'react';
+import { useDataSourceInstance as useDataSourceInstance$1 } from '@grafana/runtime';
+import { useDataSourceInstance as useDataSourceInstance$2 } from '@grafana/runtime/unstable';
+import { getDataSourceInstance } from './getDataSourceInstance.mjs';
+
+"use strict";
+const useDataSourceInstance = typeof useDataSourceInstance$1 === "function" ? useDataSourceInstance$1 : typeof useDataSourceInstance$2 === "function" ? useDataSourceInstance$2 : useBackwardsCompatibleDataSourceInstance;
+function useBackwardsCompatibleDataSourceInstance(ref) {
+  const [result, setResult] = useState({ isLoading: true });
+  const refKey = JSON.stringify(ref != null ? ref : null);
+  useEffect(() => {
+    let isCurrent = true;
+    setResult((previous) => ({ ...previous, isLoading: true }));
+    getDataSourceInstance(ref).then(
+      (dataSource) => isCurrent && setResult({ isLoading: false, dataSource }),
+      (error) => isCurrent && setResult({ isLoading: false, error })
+    );
+    return () => {
+      isCurrent = false;
+    };
+  }, [refKey]);
+  return result;
+}
+
+export { useDataSourceInstance };
+//# sourceMappingURL=useDataSourceInstance.mjs.map

package/dist/esm/datasources/useDataSourceInstance.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataSourceInstance.mjs","sources":["../../../src/datasources/useDataSourceInstance.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport { type DataSourceApi } from '@grafana/data';\nimport { useDataSourceInstance as stableUseDataSourceInstance } from '@grafana/runtime';\nimport { useDataSourceInstance as unstableUseDataSourceInstance } from '@grafana/runtime/unstable';\n\nimport { getDataSourceInstance } from './getDataSourceInstance';\nimport { type Ref } from './types';\n\n/** Declared here because `@grafana/runtime` lacks it on older supported hosts. */\nexport interface UseDataSourceInstanceResult {\n  isLoading: boolean;\n  error?: Error;\n  dataSource?: DataSourceApi;\n}\n\n/**\n * Uses the host hook when available. The fallback re-resolves only when `ref` changes, not on data source cache\n * changes. Picked once at load so the hook order stays stable.\n */\nexport const useDataSourceInstance: (ref?: Ref) => UseDataSourceInstanceResult =\n  typeof stableUseDataSourceInstance === 'function'\n    ? stableUseDataSourceInstance\n    : typeof unstableUseDataSourceInstance === 'function'\n      ? unstableUseDataSourceInstance\n      : useBackwardsCompatibleDataSourceInstance;\n\nfunction useBackwardsCompatibleDataSourceInstance(ref?: Ref): UseDataSourceInstanceResult {\n  const [result, setResult] = useState<UseDataSourceInstanceResult>({ isLoading: true });\n  // Same key as the host hook, so inline ref objects don't refetch and `null` matches `undefined`.\n  const refKey = JSON.stringify(ref ?? null);\n\n  useEffect(() => {\n    let isCurrent = true;\n    setResult((previous) => ({ ...previous, isLoading: true }));\n\n    getDataSourceInstance(ref).then(\n      (dataSource) => isCurrent && setResult({ isLoading: false, dataSource }),\n      (error: Error) => isCurrent && setResult({ isLoading: false, error })\n    );\n\n    return () => {\n      isCurrent = false;\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [refKey]);\n\n  return result;\n}\n"],"names":["stableUseDataSourceInstance","unstableUseDataSourceInstance"],"mappings":";;;;;;AAoBO,MAAM,qBAAA,GACX,OAAOA,uBAAA,KAAgC,UAAA,GACnCA,0BACA,OAAOC,uBAAA,KAAkC,aACvCA,uBAAA,GACA;AAER,SAAS,yCAAyC,GAAA,EAAwC;AACxF,EAAA,MAAM,CAAC,QAAQ,SAAS,CAAA,GAAI,SAAsC,EAAE,SAAA,EAAW,MAAM,CAAA;AAErF,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,SAAA,CAAU,GAAA,IAAA,IAAA,GAAA,GAAA,GAAO,IAAI,CAAA;AAEzC,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,SAAA,GAAY,IAAA;AAChB,IAAA,SAAA,CAAU,CAAC,QAAA,MAAc,EAAE,GAAG,QAAA,EAAU,SAAA,EAAW,MAAK,CAAE,CAAA;AAE1D,IAAA,qBAAA,CAAsB,GAAG,CAAA,CAAE,IAAA;AAAA,MACzB,CAAC,eAAe,SAAA,IAAa,SAAA,CAAU,EAAE,SAAA,EAAW,KAAA,EAAO,YAAY,CAAA;AAAA,MACvE,CAAC,UAAiB,SAAA,IAAa,SAAA,CAAU,EAAE,SAAA,EAAW,KAAA,EAAO,OAAO;AAAA,KACtE;AAEA,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,GAAY,KAAA;AAAA,IACd,CAAA;AAAA,EAEF,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,OAAO,MAAA;AACT;;;;"}

package/dist/esm/datasources.mjs

@@ -3,6 +3,7 @@ export { getDataSourceInstanceList } from './datasources/getDataSourceInstanceLi
 export { getDataSourceInstanceSettings } from './datasources/getDataSourceInstanceSettings.mjs';
 export { getDefaultDataSourceInstanceListItem } from './datasources/getDefaultDataSourceInstanceListItem.mjs';
 export { registerRuntimeDataSourceInstance } from './datasources/registerRuntimeDataSourceInstance.mjs';
+export { useDataSourceInstance } from './datasources/useDataSourceInstance.mjs';
 export { useDefaultDataSourceInstanceListItem } from './datasources/useDefaultDataSourceInstanceListItem.mjs';
 
 "use strict";

package/dist/esm/datasources.mjs.map

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

package/dist/types/datasources/useDataSourceInstance.d.ts

@@ -0,0 +1,13 @@
+import { type DataSourceApi } from '@grafana/data';
+import { type Ref } from './types';
+/** Declared here because `@grafana/runtime` lacks it on older supported hosts. */
+export interface UseDataSourceInstanceResult {
+    isLoading: boolean;
+    error?: Error;
+    dataSource?: DataSourceApi;
+}
+/**
+ * Uses the host hook when available. The fallback re-resolves only when `ref` changes, not on data source cache
+ * changes. Picked once at load so the hook order stays stable.
+ */
+export declare const useDataSourceInstance: (ref?: Ref) => UseDataSourceInstanceResult;

package/dist/types/datasources.d.ts

@@ -3,4 +3,5 @@ export { getDataSourceInstanceList } from './datasources/getDataSourceInstanceLi
 export { getDataSourceInstanceSettings } from './datasources/getDataSourceInstanceSettings';
 export { getDefaultDataSourceInstanceListItem } from './datasources/getDefaultDataSourceInstanceListItem';
 export { registerRuntimeDataSourceInstance } from './datasources/registerRuntimeDataSourceInstance';
+export { useDataSourceInstance, type UseDataSourceInstanceResult } from './datasources/useDataSourceInstance';
 export { useDefaultDataSourceInstanceListItem, type UseDefaultDataSourceInstanceListItemResult, } from './datasources/useDefaultDataSourceInstanceListItem';

package/package.json

@@ -2,7 +2,7 @@
   "author": "Grafana Labs",
   "license": "Apache-2.0",
   "name": "@grafana/plugin-compat",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Compatibility shims that let Grafana plugins adopt new Grafana host APIs across a range of host versions",
   "keywords": [
     "grafana",
@@ -72,5 +72,5 @@
     "@grafana/schema": ">=12.0.0",
     "react": ">=18"
   },
-  "gitHead": "891f7973f81c6e4e0a24bed3120cca3b3cc93ebc"
+  "gitHead": "e664af940679e7ccfe3106ac9fb0d11a82f03ed2"
 }