@gooddata/sdk-ui-pluggable-application 11.28.0-alpha.9 → 11.29.0-alpha.0

package/esm/backend.d.ts

@@ -0,0 +1,43 @@
+import { type IAnalyticalBackend } from "@gooddata/sdk-backend-spi";
+import { type IAuthCredentials } from "@gooddata/sdk-pluggable-application-model";
+/**
+ * Options for {@link createBackendForModule}.
+ *
+ * @alpha
+ */
+export interface ICreateBackendForModuleOptions {
+    /**
+     * Package name reported to the backend for telemetry.
+     */
+    packageName: string;
+    /**
+     * Package version reported to the backend for telemetry.
+     */
+    packageVersion?: string;
+}
+/**
+ * Creates an analytical backend instance from the platform context auth credentials.
+ *
+ * @remarks
+ * Each pluggable application module should create its own backend instance using this
+ * function rather than sharing the host's internal backend singleton. This ensures
+ * modules remain decoupled and avoids SDK version desync between independently built
+ * artifacts.
+ *
+ * @example
+ * ```tsx
+ * import { createBackendForModule } from "@gooddata/sdk-ui-pluggable-application";
+ *
+ * function MyApp({ ctx }: { ctx: IPlatformContext }) {
+ *     const backend = useMemo(
+ *         () => createBackendForModule(ctx.auth, { packageName: "my-module" }),
+ *         [ctx.auth],
+ *     );
+ *     // use backend...
+ * }
+ * ```
+ *
+ * @alpha
+ */
+export declare function createBackendForModule(auth: IAuthCredentials, options: ICreateBackendForModuleOptions): IAnalyticalBackend;
+//# sourceMappingURL=backend.d.ts.map

package/esm/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAMpE,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAElF;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC3C;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CAClC,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,8BAA8B,GACxC,kBAAkB,CAuBpB"}

package/esm/backend.js

@@ -0,0 +1,44 @@
+// (C) 2026 GoodData Corporation
+import { RecommendedCachingConfiguration, withCaching } from "@gooddata/sdk-backend-base";
+import { ContextDeferredAuthProvider, TigerTokenAuthProvider, tigerFactory, } from "@gooddata/sdk-backend-tiger";
+/**
+ * Creates an analytical backend instance from the platform context auth credentials.
+ *
+ * @remarks
+ * Each pluggable application module should create its own backend instance using this
+ * function rather than sharing the host's internal backend singleton. This ensures
+ * modules remain decoupled and avoids SDK version desync between independently built
+ * artifacts.
+ *
+ * @example
+ * ```tsx
+ * import { createBackendForModule } from "@gooddata/sdk-ui-pluggable-application";
+ *
+ * function MyApp({ ctx }: { ctx: IPlatformContext }) {
+ *     const backend = useMemo(
+ *         () => createBackendForModule(ctx.auth, { packageName: "my-module" }),
+ *         [ctx.auth],
+ *     );
+ *     // use backend...
+ * }
+ * ```
+ *
+ * @alpha
+ */
+export function createBackendForModule(auth, options) {
+    const base = tigerFactory(undefined, {
+        packageName: options.packageName,
+        packageVersion: options.packageVersion ?? "unknown",
+    });
+    switch (auth.type) {
+        case "apiToken":
+        case "jwt":
+            return withCaching(base.withAuthentication(new TigerTokenAuthProvider(auth.token)), RecommendedCachingConfiguration);
+        case "contextDeferred":
+            return withCaching(base.withAuthentication(new ContextDeferredAuthProvider()), RecommendedCachingConfiguration);
+        default: {
+            throw new Error(`[sdk-ui-pluggable-application/backend] Unsupported auth type "${String(auth.type)}".`);
+        }
+    }
+}
+//# sourceMappingURL=backend.js.map

package/esm/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,OAAO,EAAE,+BAA+B,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE1F,OAAO,EACH,2BAA2B,EAC3B,sBAAsB,EACtB,YAAY,GACf,MAAM,6BAA6B,CAAC;AAoBrC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,sBAAsB,CAClC,IAAsB,EACtB,OAAuC,EACrB;IAClB,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,EAAE;QACjC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,SAAS;KACtD,CAAC,CAAC;IACH,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,UAAU,CAAC;QAChB,KAAK,KAAK;YACN,OAAO,WAAW,CACd,IAAI,CAAC,kBAAkB,CAAC,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAC/D,+BAA+B,CAClC,CAAC;QACN,KAAK,iBAAiB;YAClB,OAAO,WAAW,CACd,IAAI,CAAC,kBAAkB,CAAC,IAAI,2BAA2B,EAAE,CAAC,EAC1D,+BAA+B,CAClC,CAAC;QACN,SAAS,CAAC;YACN,MAAM,IAAI,KAAK,CACX,iEAAiE,MAAM,CAAE,IAA2B,CAAC,IAAI,CAAC,IAAI,CACjH,CAAC;QACN,CAAC;IACL,CAAC;AAAA,CACJ"}

package/esm/index.d.ts

@@ -4,4 +4,5 @@
  * @packageDocumentation
  */
 export { type IClientPlatformContext, PlatformContextProvider, type IPlatformContextProviderProps, usePlatformContext, usePlatformContextStrict, } from "./context.js";
+export { createBackendForModule, type ICreateBackendForModuleOptions } from "./backend.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,OAAO,EACH,KAAK,sBAAsB,EAC3B,uBAAuB,EACvB,KAAK,6BAA6B,EAClC,kBAAkB,EAClB,wBAAwB,GAC3B,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,OAAO,EACH,KAAK,sBAAsB,EAC3B,uBAAuB,EACvB,KAAK,6BAA6B,EAClC,kBAAkB,EAClB,wBAAwB,GAC3B,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,sBAAsB,EAAE,KAAK,8BAA8B,EAAE,MAAM,cAAc,CAAC"}

package/esm/index.js

@@ -6,4 +6,5 @@
  * @packageDocumentation
  */
 export { PlatformContextProvider, usePlatformContext, usePlatformContextStrict, } from "./context.js";
+export { createBackendForModule } from "./backend.js";
 //# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,oDAAoD;AAEpD;;;;GAIG;AAEH,OAAO,EAEH,uBAAuB,EAEvB,kBAAkB,EAClB,wBAAwB,GAC3B,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,oDAAoD;AAEpD;;;;GAIG;AAEH,OAAO,EAEH,uBAAuB,EAEvB,kBAAkB,EAClB,wBAAwB,GAC3B,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,sBAAsB,EAAuC,MAAM,cAAc,CAAC"}

package/esm/sdk-ui-pluggable-application.d.ts

@@ -5,10 +5,37 @@
  */
 
 import { IAnalyticalBackend } from '@gooddata/sdk-backend-spi';
+import { IAuthCredentials } from '@gooddata/sdk-pluggable-application-model';
 import { IPlatformContext } from '@gooddata/sdk-pluggable-application-model';
 import { JSX } from 'react/jsx-runtime';
 import { PropsWithChildren } from 'react';
 
+/**
+ * Creates an analytical backend instance from the platform context auth credentials.
+ *
+ * @remarks
+ * Each pluggable application module should create its own backend instance using this
+ * function rather than sharing the host's internal backend singleton. This ensures
+ * modules remain decoupled and avoids SDK version desync between independently built
+ * artifacts.
+ *
+ * @example
+ * ```tsx
+ * import { createBackendForModule } from "@gooddata/sdk-ui-pluggable-application";
+ *
+ * function MyApp({ ctx }: { ctx: IPlatformContext }) {
+ *     const backend = useMemo(
+ *         () => createBackendForModule(ctx.auth, { packageName: "my-module" }),
+ *         [ctx.auth],
+ *     );
+ *     // use backend...
+ * }
+ * ```
+ *
+ * @alpha
+ */
+export declare function createBackendForModule(auth: IAuthCredentials, options: ICreateBackendForModuleOptions): IAnalyticalBackend;
+
 /**
  * Platform context extended with a client-created backend instance.
  *
@@ -32,6 +59,22 @@ export declare interface IClientPlatformContext extends IPlatformContext {
     backend: IAnalyticalBackend;
 }
 
+/**
+ * Options for {@link createBackendForModule}.
+ *
+ * @alpha
+ */
+export declare interface ICreateBackendForModuleOptions {
+    /**
+     * Package name reported to the backend for telemetry.
+     */
+    packageName: string;
+    /**
+     * Package version reported to the backend for telemetry.
+     */
+    packageVersion?: string;
+}
+
 /**
  * Props for {@link PlatformContextProvider}.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-ui-pluggable-application",
-  "version": "11.28.0-alpha.9",
+  "version": "11.29.0-alpha.0",
   "description": "GoodData SDK React helpers for pluggable applications",
   "license": "MIT",
   "author": "GoodData Corporation",
@@ -23,8 +23,10 @@
   "dependencies": {
     "ts-invariant": "0.10.3",
     "tslib": "2.8.1",
-    "@gooddata/sdk-backend-spi": "11.28.0-alpha.9",
-    "@gooddata/sdk-pluggable-application-model": "11.28.0-alpha.9"
+    "@gooddata/sdk-backend-base": "11.29.0-alpha.0",
+    "@gooddata/sdk-backend-spi": "11.29.0-alpha.0",
+    "@gooddata/sdk-backend-tiger": "11.29.0-alpha.0",
+    "@gooddata/sdk-pluggable-application-model": "11.29.0-alpha.0"
   },
   "devDependencies": {
     "@microsoft/api-documenter": "^7.17.0",
@@ -56,8 +58,8 @@
     "react-dom": "19.1.1",
     "typescript": "5.9.3",
     "vitest": "4.1.0",
-    "@gooddata/eslint-config": "11.28.0-alpha.9",
-    "@gooddata/oxlint-config": "11.28.0-alpha.9"
+    "@gooddata/oxlint-config": "11.29.0-alpha.0",
+    "@gooddata/eslint-config": "11.29.0-alpha.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",