@salesforce/vite-plugin-lwc-ui-bundle 1.134.5 → 2.0.0

package/skills/setup-lwc-vite-plugin/references/bootstrap-js-patterns.md

@@ -21,7 +21,7 @@ bundle, so the guard short-circuits and real host calls run.
 
 Do **not** expect `npm run build && open dist/index.html` to render mock
 data. Rollup hoists module-init code to the top of the bundle, which
-means `@salesforce/sdk-chat`'s `detectSurface()` runs _before_ the
+means `@salesforce/platform-sdk-chat`'s `detectSurface()` runs _before_ the
 `main.js` / `bootstrap.js` body executes the `if (!window.openai?.
 callTool)` block. The SDK caches surface = `"WebApp"` and never observes
 the mock — LDS / graphql wire adapters silently return empty data.

package/skills/setup-lwc-vite-plugin/references/known-pitfalls.md

@@ -33,53 +33,31 @@ Prerelease tags get unpublished from the registry over time.
 `npm view <pkg> version` and pin to `^<that>` instead of copying from
 the snippet.
 
-## 3. Hand-rolled `lightningGraphql` in `vite.config.js`
+## 3. Hand-rolled GraphQL or LDS providers in `vite.config.js`
 
-**Symptom:** `@wire(graphql)` returns empty data; console shows
-`No window.openai.callTool available` or a hand-written
-`[lightningGraphql] ...` log message.
+**Symptom:** `@wire(graphql)` or `@wire(getRecord)` returns empty data;
+console shows `No window.openai.callTool available` or a hand-written
+`[graphql] ...` / `[lds] ...` log message.
 
-**Cause:** The generator treated the "include `builtins.lightningGraphql()`"
-instruction as "write a provider called `lightningGraphql`" and inlined
-a custom provider factory in `vite.config.js` instead of importing
-`builtins` from the plugin. The hand-rolled version bypasses the
-plugin's real runtime (which handles `globalThis.__sfdc_sdk__`,
-`getChatSDK()`, and `normalizeMcpResponse`).
+**Cause:** The generator treated the "include `builtins.lds()`"
+instruction as "write a provider called `lds`" and inlined a custom
+provider factory in `vite.config.js` instead of importing `builtins`
+from the plugin. The hand-rolled version bypasses the plugin's real
+runtime (which handles `getChatSDK()` MCP dispatch, `normalizeMcpResponse`
+envelope parsing, and the graphql-specific `{ data, errors[] }`
+envelope).
 
 **Fix:** Replace with:
 
 ```js
 import lwcVitePlugin, { builtins } from "@salesforce/vite-plugin-lwc-ui-bundle";
 // inside lwcVitePlugin({ providers: [...] })
-builtins.lightningGraphql(),
-builtins.lds(),
+builtins.lds(),   // covers lightning/uiRecordApi, uiObjectInfoApi, and lightning/graphql
 ```
 
-Same rule for `lds` and every other provider — never hand-write them.
+Same rule for every other provider — never hand-write them.
 
-## 4. `this`-binding bug in `lightning/graphql` runtime
-
-**Symptom:** `@wire(graphql)` with a class-based SDK (e.g.
-`@salesforce/sdk-data`'s `WebApp`) silently emits
-`{data: undefined, errors: [TypeError]}`; component falls through to an
-empty state.
-
-**Cause:** Plugin versions ≤ 1.132.0 destructure `graphql` off
-`globalThis.__sfdc_sdk__` before calling it, which loses the method's
-`this` binding. The method internally calls `this.fetch(...)` and
-blows up.
-
-**Fix:** Fixed in webapps PR #477 (plugin version > 1.132.0). Until the
-fix ships in a release, add this to `bootstrap.js` after creating the
-SDK:
-
-```js
-sdk.graphql = sdk.graphql.bind(sdk);
-sdk.fetch = sdk.fetch.bind(sdk);
-globalThis.__sfdc_sdk__ = sdk;
-```
-
-## 5. Wrong tool name in mock branch (graphql foot-gun)
+## 4. Wrong tool name in mock branch (graphql foot-gun)
 
 **Symptom:** `@wire(graphql)` returns empty data even though the mock
 shim is installed; console shows "[mock] unhandled tool: graphqlQuery"
@@ -93,8 +71,13 @@ variables })` by default, but the mock branches on `"graphql"` or
 the same custom name to both the provider and the mock:
 
 ```js
-// vite.config.js
-builtins.lightningGraphql({ toolName: "myCustomGraphql" }),
+// vite.config.js — override the default "graphqlQuery" tool name
+builtins.lds({
+  "lightning/graphql": {
+    graphql: { type: "graphql-wire", mcp: { toolName: "myCustomGraphql" } },
+    executeMutation: { type: "graphql-mutation", mcp: { toolName: "myCustomGraphql" } },
+  },
+}),
 
 // bootstrap.js
 if (name === "myCustomGraphql") { /* ... */ }
@@ -103,7 +86,7 @@ if (name === "myCustomGraphql") { /* ... */ }
 The vite-config tool name and the mock-branch string must match
 exactly.
 
-## 6. `.properties` wrap in Avro/JSON-schema-serialized tool output
+## 5. `.properties` wrap in Avro/JSON-schema-serialized tool output
 
 **Symptom:** Chat wrapper renders "Waiting for tool output..." even
 though the host fired tool output; mapper's `Object.keys(records)[0]`
@@ -128,7 +111,7 @@ function unwrapPropertiesMap(value) {
 
 Apply this in every mapper that reads map-shaped fields.
 
-## 7. Missing `viteSingleFile()`
+## 6. Missing `viteSingleFile()`
 
 **Symptom:** `dist/index.html` is 1-2 KB (just a stub); component
 doesn't render when opened locally.
@@ -155,7 +138,7 @@ build: {
 
 A correctly built `dist/index.html` is typically 100 KB+.
 
-## 8. `@salesforce/label/...` warnings
+## 7. `@salesforce/label/...` warnings
 
 **Symptom:** Build warns `Unhandled import: @salesforce/label/...`,
 but the build succeeds.
@@ -166,7 +149,7 @@ when no override is provided.
 **Fix:** Not a bug. Add overrides to `builtins.label({...})` to
 customize the displayed text.
 
-## 9. Missing gate / accessCheck providers with lightning-base-components
+## 8. Missing gate / accessCheck providers with lightning-base-components
 
 **Symptom:** Build fails with `Cannot read properties of undefined
 (reading 'isOpen')`.
@@ -179,7 +162,7 @@ import them.
 (and `builtins.primitiveUtils()`) whenever `lightning-base-components`
 is in the modules config.
 
-## 10. Core-only imports
+## 9. Core-only imports
 
 **Symptom:** `Rollup failed to resolve import "force/someModule"` (or
 `aura`, `logger`, etc.).
@@ -198,14 +181,14 @@ lwcVitePlugin({
 Point the stub at a minimal file that exports the shape the importer
 expects.
 
-## 11. Mock data doesn't work in production build
+## 10. Mock data doesn't work in production build
 
 **Symptom:** `npm run build && open dist/index.html` shows wrappers in
 "Waiting" state; `sdk.callTool is not available on this surface` in
 the console. Dev server (`npm run dev`) works fine.
 
 **Cause:** Rollup hoists module-init code to the top of the bundle.
-`@salesforce/sdk-chat`'s top-level `const surface = detectSurface()`
+`@salesforce/platform-sdk-chat`'s top-level `const surface = detectSurface()`
 runs before `main.js` / `bootstrap.js` installs the mock, so the SDK
 caches `surface = "WebApp"` forever.
 
@@ -213,3 +196,128 @@ caches `surface = "WebApp"` forever.
 builds only target real MCP hosts (where the host sets `window.openai`
 before the bundle loads, so surface detection correctly resolves to
 `OpenAI`). See `bootstrap-js-patterns.md` for the full explanation.
+
+## 11. `providers` array missing entirely from `vite.config.js`
+
+**Symptom:** Build succeeds, but:
+
+- Labels render as `undefined` instead of their configured values
+- `@wire(graphql)` returns `undefined` or silently no-ops
+- `executeMutation()` fails with "No SDK found" or similar
+- Console shows `[scoped-module-providers] Unhandled import: @salesforce/...`
+  lines for every scoped import
+
+**Cause:** `lwcVitePlugin({ modules: {...} })` is called **without** a
+`providers: [...]` array. The plugin loads and compiles LWC just fine,
+but no scoped-module providers are registered — so every
+`@salesforce/label/*`, `@salesforce/i18n/*`, `@salesforce/gate/*`,
+`@salesforce/accessCheck/*`, `lightning/graphql`, `lightning/uiRecordApi`
+import resolves to `undefined` at runtime.
+
+**Fix:** Add the `providers: [...]` array with the appropriate builtins
+for what the component tree actually uses:
+
+```js
+import lwcVitePlugin, { builtins } from "@salesforce/vite-plugin-lwc-ui-bundle";
+
+lwcVitePlugin({
+  modules: {
+    /* ... */
+  },
+  providers: [
+    builtins.label({
+      /* label overrides */
+    }),
+    builtins.i18n(),
+    builtins.client(),
+    // Required when using base components:
+    builtins.gate(),
+    builtins.accessCheck(),
+    builtins.primitiveUtils(),
+    // Add only if detected in the component tree:
+    builtins.lds(), // covers lightning/uiRecordApi and lightning/graphql
+  ],
+});
+```
+
+**Prevention:** SKILL.md Step 4.5 ("Verify existing `vite.config.js`
+against findings") catches this by cross-checking Step 4's tree-walk
+findings against the providers actually listed in the config.
+
+## 12. `lwc-components-lightning` vs `lightning-base-components`
+
+**Symptom:** Config references one package name but the project has the
+other installed, or provider behavior differs between environments.
+
+**Cause:** Both names appear in the wild:
+
+- `lightning-base-components` — the public npm package
+- `lwc-components-lightning` — an internal-workspace name that some
+  Salesforce projects resolve through private registries, aliases, or
+  monorepo linking. The public-registry entry for this name is a
+  security-reserved placeholder, not a real package.
+
+Both resolve to the same LWC base components and **require the same
+scoped providers**: `builtins.gate()`, `builtins.accessCheck()`,
+`builtins.primitiveUtils()`.
+
+**Fix:** Use whichever package your project already depends on. For
+public-facing consumers, use `lightning-base-components`. In either
+case, make sure the three providers above are in the `providers` array
+whenever the package name is in `modules.npm`.
+
+## 13. Missing `@conduit-client/*` peers for `builtins.lds()`
+
+**Symptom:** `vite build` fails with:
+
+```
+Rollup failed to resolve import "@conduit-client/service-bindings-imperative/v1"
+  from "\0sf-lds-adapter:lightning/graphql"
+```
+
+(or `service-bindings-lwc`, or `utils` — errors cascade one at a time as
+each is resolved.)
+
+**Cause:** The plugin's LDS runtime
+(`node_modules/@salesforce/vite-plugin-lwc-ui-bundle/dist/providers/lds/runtime.js`)
+statically imports three `@conduit-client/*` packages. Depending on the
+plugin version, these may be declared as the plugin's own
+`dependencies` / `optionalDependencies`, or may be left undeclared (as
+of `@salesforce/vite-plugin-lwc-ui-bundle@1.135.0`). The plugin reads
+`runtime.js` as a string at init, so nothing resolves until a consumer
+module imports `lightning/graphql`, `lightning/uiRecordApi`, or
+`lightning/uiObjectInfoApi` — then Rollup has to resolve the
+conduit-client imports in the consumer's `node_modules`, where they may
+be missing.
+
+The packages **are** publicly published on `registry.npmjs.org`; this
+is a missing-peer-declaration issue in the plugin for the plugin
+versions that don't ship them, not a registry / auth issue.
+
+**Fix (consumer side, works against any plugin version):** when a
+component actually imports `lightning/graphql`,
+`lightning/uiRecordApi`, or `lightning/uiObjectInfoApi`, install the
+three packages directly:
+
+```bash
+npm install --save \
+  @conduit-client/service-bindings-imperative@^3 \
+  @conduit-client/service-bindings-lwc@^3 \
+  @conduit-client/utils@^3
+```
+
+If no component imports those specifiers, the packages are not
+needed — omit them AND omit `builtins.lds()` from the `providers`
+array.
+
+**Forward compatibility:** if a future plugin version adds these to its
+own `dependencies` / `optionalDependencies`, they will already be
+present after `npm install @salesforce/vite-plugin-lwc-ui-bundle` and
+Step 8.1's post-install check becomes a no-op — it simply observes that
+the packages are already resolvable and skips the additional install.
+No skill change needed.
+
+**Prevention:** SKILL.md Step 8.1 ("Verify LDS runtime peers") runs the
+`require.resolve()` check after `npm install` and installs the three
+packages only when they are actually missing AND the component tree
+uses LDS specifiers.

package/dist/providers/lightning-graphql/index.d.ts

@@ -1,10 +0,0 @@
-import { Provider } from '../../types';
-export interface LightningGraphqlOptions {
-    /**
-     * Name of the MCP tool to call for GraphQL query execution.
-     * Defaults to `'graphqlQuery'`.
-     */
-    toolName?: string;
-}
-export declare function lightningGraphql(options?: LightningGraphqlOptions): Provider;
-//# sourceMappingURL=index.d.ts.map

package/dist/providers/lightning-graphql/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/lightning-graphql/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,uBAAuB;IACvC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAOD,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,QAAQ,CAUhF"}

package/dist/providers/lightning-graphql/index.js

@@ -1,24 +0,0 @@
-import { readFileSync } from "node:fs";
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-const runtimeSource = readFileSync(
-  join(dirname(fileURLToPath(import.meta.url)), "runtime.js"),
-  "utf-8"
-);
-function lightningGraphql(options = {}) {
-  const toolName = options.toolName ?? "graphqlQuery";
-  const source = `${runtimeSource}
-TOOL_NAME = ${JSON.stringify(toolName)};
-`;
-  return {
-    match: (id) => id === "lightning/graphql",
-    resolve(specifier) {
-      if (specifier !== "lightning/graphql") return null;
-      return source;
-    }
-  };
-}
-export {
-  lightningGraphql
-};
-//# sourceMappingURL=index.js.map

package/dist/providers/lightning-graphql/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sources":["../../../src/providers/lightning-graphql/index.ts"],"sourcesContent":["/**\n * Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n */\nimport { readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type { Provider } from \"../../types\";\n\nexport interface LightningGraphqlOptions {\n\t/**\n\t * Name of the MCP tool to call for GraphQL query execution.\n\t * Defaults to `'graphqlQuery'`.\n\t */\n\ttoolName?: string;\n}\n\nconst runtimeSource = readFileSync(\n\tjoin(dirname(fileURLToPath(import.meta.url)), \"runtime.js\"),\n\t\"utf-8\",\n);\n\nexport function lightningGraphql(options: LightningGraphqlOptions = {}): Provider {\n\tconst toolName = options.toolName ?? \"graphqlQuery\";\n\tconst source = `${runtimeSource}\\nTOOL_NAME = ${JSON.stringify(toolName)};\\n`;\n\treturn {\n\t\tmatch: (id) => id === \"lightning/graphql\",\n\t\tresolve(specifier) {\n\t\t\tif (specifier !== \"lightning/graphql\") return null;\n\t\t\treturn source;\n\t\t},\n\t};\n}\n"],"names":[],"mappings":";;;AAkBA,MAAM,gBAAgB;AAAA,EACrB,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC,GAAG,YAAY;AAAA,EAC1D;AACD;AAEO,SAAS,iBAAiB,UAAmC,IAAc;AACjF,QAAM,WAAW,QAAQ,YAAY;AACrC,QAAM,SAAS,GAAG,aAAa;AAAA,cAAiB,KAAK,UAAU,QAAQ,CAAC;AAAA;AACxE,SAAO;AAAA,IACN,OAAO,CAAC,OAAO,OAAO;AAAA,IACtB,QAAQ,WAAW;AAClB,UAAI,cAAc,oBAAqB,QAAO;AAC9C,aAAO;AAAA,IACR;AAAA,EAAA;AAEF;"}

package/dist/providers/lightning-graphql/runtime.js

@@ -1,103 +0,0 @@
-import { getChatSDK } from "@salesforce/sdk-chat";
-function normalizeMcpResponse(raw) {
-  if (raw && typeof raw === "object" && "structuredContent" in raw) {
-    return raw.structuredContent;
-  }
-  if (raw && typeof raw === "object" && typeof raw.result === "string") {
-    const parsed = JSON.parse(raw.result);
-    if (Array.isArray(parsed)) {
-      const textBlock = parsed.find(
-        (b) => b && b.type === "text" && typeof b.text === "string"
-      );
-      const text = textBlock ? textBlock.text : null;
-      if (text) {
-        return JSON.parse(text);
-      }
-      return {};
-    }
-    return parsed;
-  }
-  return raw ?? {};
-}
-let TOOL_NAME = "graphqlQuery";
-function gql(strings, ...values) {
-  let result = "";
-  strings.forEach((string, i) => {
-    result += string;
-    if (i < values.length) result += String(values[i]);
-  });
-  return result;
-}
-async function runQuery(config) {
-  const { query, variables } = config;
-  if (!query) return { data: void 0, errors: void 0 };
-  const sdkRef = globalThis.__sfdc_sdk__;
-  if (sdkRef && typeof sdkRef.graphql === "function") {
-    const result = await sdkRef.graphql({ query, variables: variables ?? {} });
-    return { data: result?.data, errors: result?.errors };
-  }
-  const sdk = await getChatSDK();
-  if (typeof sdk.callTool !== "function") {
-    throw new Error(
-      "[lightning/graphql] No data surface available. Either initialise globalThis.__sfdc_sdk__ with createDataSDK, or run inside a ChatGPT / MCP Apps context."
-    );
-  }
-  const raw = await sdk.callTool({
-    toolName: TOOL_NAME,
-    params: { query, variables: variables ?? {} }
-  });
-  return normalizeMcpResponse(raw) ?? {};
-}
-class graphql {
-  _dataCallback;
-  _config;
-  constructor(dataCallback) {
-    this._dataCallback = dataCallback;
-  }
-  connect() {
-    this._fetch();
-  }
-  // eslint-disable-next-line @typescript-eslint/no-empty-function
-  disconnect() {
-  }
-  update(config) {
-    this._config = config;
-    this._fetch();
-  }
-  refresh() {
-    return this._fetch();
-  }
-  async _fetch() {
-    try {
-      const result = await runQuery(this._config ?? {});
-      this._emit(result);
-    } catch (error) {
-      this._emit({
-        data: void 0,
-        errors: [{ message: error.message }]
-      });
-    }
-  }
-  _emit({ data, errors }) {
-    this._dataCallback({
-      data,
-      errors: errors?.length ? errors : void 0,
-      refresh: () => this.refresh()
-    });
-  }
-}
-async function executeMutation(config) {
-  if (!config?.query) return { data: void 0, errors: [{ message: "No query provided" }] };
-  try {
-    return await runQuery(config);
-  } catch (error) {
-    return { data: void 0, errors: [{ message: error.message }] };
-  }
-}
-export {
-  TOOL_NAME,
-  executeMutation,
-  gql,
-  graphql
-};
-//# sourceMappingURL=runtime.js.map

package/dist/providers/lightning-graphql/runtime.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime.js","sources":["../../../src/providers/shared/normalize-mcp-response.ts","../../../src/providers/lightning-graphql/runtime.ts"],"sourcesContent":["/**\n * Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n */\n\n/**\n * Unwraps the MCP tool transport envelope and returns the tool's payload as-is.\n *\n * Handles the three surface shapes `sdk.callTool()` can resolve with:\n * - MCP Apps surface: `{ structuredContent, content }`\n * - OpenAI surface: `{ result: \"<JSON string>\" }`, where the JSON may itself be\n *   an MCP content array (`[{ type: 'text', text: \"<JSON string>\" }, ...]`)\n * - Fallback: the raw value returned by `callTool`\n *\n * The shape of the unwrapped payload is the tool's responsibility — this helper\n * does not project out `data` / `error` / `errors`. Callers read whichever keys\n * their tool contract defines.\n */\nexport function normalizeMcpResponse(raw: unknown): unknown {\n\tif (raw && typeof raw === \"object\" && \"structuredContent\" in raw) {\n\t\treturn (raw as { structuredContent: unknown }).structuredContent;\n\t}\n\n\tif (raw && typeof raw === \"object\" && typeof (raw as { result?: unknown }).result === \"string\") {\n\t\tconst parsed = JSON.parse((raw as { result: string }).result);\n\t\tif (Array.isArray(parsed)) {\n\t\t\tconst textBlock = parsed.find(\n\t\t\t\t(b: { type?: string; text?: string }) =>\n\t\t\t\t\tb && b.type === \"text\" && typeof b.text === \"string\",\n\t\t\t);\n\t\t\tconst text = textBlock ? textBlock.text : null;\n\t\t\tif (text) {\n\t\t\t\treturn JSON.parse(text);\n\t\t\t}\n\t\t\treturn {};\n\t\t}\n\t\treturn parsed;\n\t}\n\n\treturn raw ?? {};\n}\n","/**\n * Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n */\nimport { getChatSDK } from \"@salesforce/sdk-chat\";\nimport { normalizeMcpResponse } from \"../shared/normalize-mcp-response\";\n\n// Overwritten at plugin-load time by the `lightningGraphql` Vite shim, which\n// appends `TOOL_NAME = \"<configured-name>\";` to the bundled output. The initial\n// value is the default.\n// eslint-disable-next-line prefer-const\nexport let TOOL_NAME = \"graphqlQuery\";\n\ninterface GraphqlConfig {\n\tquery?: string;\n\tvariables?: Record<string, unknown>;\n}\n\ninterface GraphqlResult {\n\tdata?: unknown;\n\terrors?: { message: string }[];\n}\n\ntype WireCallback = (result: {\n\tdata: unknown;\n\terrors: { message: string }[] | undefined;\n\trefresh: () => Promise<void>;\n}) => void;\n\nexport function gql(strings: TemplateStringsArray, ...values: unknown[]): string {\n\tlet result = \"\";\n\tstrings.forEach((string, i) => {\n\t\tresult += string;\n\t\tif (i < values.length) result += String(values[i]);\n\t});\n\treturn result;\n}\n\nasync function runQuery(config: GraphqlConfig): Promise<GraphqlResult> {\n\tconst { query, variables } = config;\n\tif (!query) return { data: undefined, errors: undefined };\n\n\t// 1. UIBundle / local dev: use globalThis.__sfdc_sdk__.graphql if available.\n\t// Invoke as a method (not a destructured reference) so class-based SDK\n\t// implementations keep their `this` binding — some SDKs implement\n\t// `graphql` as a method that calls `this.fetch(...)` internally.\n\tconst sdkRef = (globalThis as Record<string, unknown>).__sfdc_sdk__ as\n\t\t| {\n\t\t\t\tgraphql?: (args: {\n\t\t\t\t\tquery: string;\n\t\t\t\t\tvariables: Record<string, unknown>;\n\t\t\t\t}) => Promise<GraphqlResult>;\n\t\t  }\n\t\t| undefined;\n\tif (sdkRef && typeof sdkRef.graphql === \"function\") {\n\t\tconst result = await sdkRef.graphql({ query, variables: variables ?? {} });\n\t\treturn { data: result?.data, errors: result?.errors };\n\t}\n\n\t// 2. MCP surface: use getChatSDK().callTool\n\tconst sdk = await getChatSDK();\n\tif (typeof sdk.callTool !== \"function\") {\n\t\tthrow new Error(\n\t\t\t\"[lightning/graphql] No data surface available. \" +\n\t\t\t\t\"Either initialise globalThis.__sfdc_sdk__ with createDataSDK, \" +\n\t\t\t\t\"or run inside a ChatGPT / MCP Apps context.\",\n\t\t);\n\t}\n\n\tconst raw = await sdk.callTool({\n\t\ttoolName: TOOL_NAME,\n\t\tparams: { query, variables: variables ?? {} },\n\t});\n\n\treturn (normalizeMcpResponse(raw) as GraphqlResult) ?? {};\n}\n\nexport class graphql {\n\t_dataCallback: WireCallback;\n\t_config: GraphqlConfig | undefined;\n\n\tconstructor(dataCallback: WireCallback) {\n\t\tthis._dataCallback = dataCallback;\n\t}\n\n\tconnect() {\n\t\tthis._fetch();\n\t}\n\n\t// eslint-disable-next-line @typescript-eslint/no-empty-function\n\tdisconnect() {}\n\n\tupdate(config: GraphqlConfig) {\n\t\tthis._config = config;\n\t\tthis._fetch();\n\t}\n\n\trefresh() {\n\t\treturn this._fetch();\n\t}\n\n\tasync _fetch() {\n\t\ttry {\n\t\t\tconst result = await runQuery(this._config ?? {});\n\t\t\tthis._emit(result);\n\t\t} catch (error) {\n\t\t\tthis._emit({\n\t\t\t\tdata: undefined,\n\t\t\t\terrors: [{ message: (error as Error).message }],\n\t\t\t});\n\t\t}\n\t}\n\n\t_emit({ data, errors }: GraphqlResult) {\n\t\tthis._dataCallback({\n\t\t\tdata,\n\t\t\terrors: errors?.length ? errors : undefined,\n\t\t\trefresh: () => this.refresh(),\n\t\t});\n\t}\n}\n\nexport async function executeMutation(config: GraphqlConfig): Promise<GraphqlResult> {\n\tif (!config?.query) return { data: undefined, errors: [{ message: \"No query provided\" }] };\n\ttry {\n\t\treturn await runQuery(config);\n\t} catch (error) {\n\t\treturn { data: undefined, errors: [{ message: (error as Error).message }] };\n\t}\n}\n"],"names":[],"mappings":"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"}