@salesforce/mcp-provider-lwc-experts 0.1.0

package/agents/lds/resources/lwc/guides/reference/wire-adapters/reference-wire-adapters-records.md

@@ -0,0 +1,142 @@
+# `getRecords`
+
+Use this wire adapter to retrieve data for multiple records across different objects or record types.
+
+## Syntax
+
+```js
+import { LightningElement, wire } from 'lwc';
+import { getRecords } from 'lightning/uiRecordApi';
+
+@wire(getRecords, { records: [ { recordIds: string[], fields: string[] } ] })
+propertyOrFunction;
+
+@wire(getRecords, { records: [ { recordIds: string[], fields: string[], optionalFields?: string[] } ] })
+propertyOrFunction;
+```
+
+## Parameters
+
+- **`records`** (Object[], Required) – Array of record requests, which can span multiple objects or record types.
+
+### `records` Properties
+
+- **`recordIds`** (String[], Required) – Record IDs from supported objects.
+- **`fields`** (String[]) – Fields to return. If a field is inaccessible, an error occurs. Use `optionalFields` if unsure about access.
+- **`optionalFields`** (String[]) – Additional fields to return. Inaccessible fields are ignored without causing an error.
+
+## Returns
+
+- **`data`** – Batch Results.
+- **`error`** – FetchResponse.
+
+## Usage
+
+For a single record, use `getRecord`.
+
+### Example: Fetching Multiple Records
+
+```js
+import { LightningElement, wire } from 'lwc';
+import { getRecords } from 'lightning/uiRecordApi';
+import NAME_FIELD from '@salesforce/schema/User.Name';
+import EMAIL_FIELD from '@salesforce/schema/User.Email';
+
+export default class GetRecordsExample extends LightningElement {
+  @wire(getRecords, {
+    records: [
+      {
+        recordIds: ['005XXXXXXXXXXXXXXX'],
+        fields: [NAME_FIELD],
+        optionalFields: [EMAIL_FIELD],
+      },
+    ],
+  })
+  wiredRecords;
+}
+```
+
+### Example: Fetching Records Across Multiple Objects
+
+```js
+import { LightningElement, wire } from 'lwc';
+import { getRecords } from 'lightning/uiRecordApi';
+import USER_NAME_FIELD from '@salesforce/schema/User.Name';
+import ACCOUNT_NAME_FIELD from '@salesforce/schema/Account.Name';
+
+export default class GetRecordsExample extends LightningElement {
+  @wire(getRecords, {
+    records: [
+      { recordIds: ['005XXXXXXXXXXXXXXX'], fields: [USER_NAME_FIELD] },
+      { recordIds: ['001XXXXXXXXXXXXXXX'], fields: [ACCOUNT_NAME_FIELD] },
+    ],
+  })
+  wiredRecords;
+}
+```
+
+### Error Handling
+
+Errors are included in the `error` property. To identify subrequest errors, check `data.results[].result`.
+
+```json
+{
+  "results": [
+    {
+      "statusCode": 200,
+      "result": {
+        "apiName": "Contact",
+        "fields": {
+          "Name": { "value": "Sean Forbes" },
+          "Email": { "value": "sean@edge.com" }
+        }
+      }
+    },
+    {
+      "statusCode": 400,
+      "result": [
+        {
+          "errorCode": "UNKNOWN_EXCEPTION",
+          "message": "Record ID is malformed"
+        }
+      ]
+    }
+  ]
+}
+```
+
+### Example: Handling Errors in LWC
+
+```js
+import { LightningElement, api, wire } from 'lwc';
+import { ShowToastEvent } from 'lightning/platformShowToastEvent';
+import { getRecords } from 'lightning/uiRecordApi';
+
+const FIELDS = ['Contact.Name', 'Contact.Phone'];
+
+export default class LoadContact extends LightningElement {
+  @api recordId;
+  contacts;
+  name;
+  phone;
+  @wire(getRecords, {
+    records: [{ recordIds: ['005XXXXXXXXXXXXXXX'], fields: FIELDS }],
+  })
+  wiredRecord({ error, data }) {
+    if (error) {
+      let message = error.body.message || 'Unknown error';
+      this.dispatchEvent(
+        new ShowToastEvent({
+          title: 'Error loading contacts',
+          message,
+          variant: 'error',
+        }),
+      );
+    } else if (data) {
+      this.contacts = data;
+      this.name = this.contacts.results[0].result.fields.Name.value;
+      this.phone = this.contacts.results[0].result.fields.Phone.value;
+    }
+  }
+}
+```

package/index.bundle.d.ts

@@ -0,0 +1,10 @@
+// Generated by dts-bundle-generator v9.5.1
+
+import { McpProvider, McpTool, Services } from '@salesforce/mcp-provider-api';
+
+export declare class LwcExpertsMcpProvider extends McpProvider {
+	getName(): string;
+	provideTools(_services: Services): Promise<McpTool[]>;
+}
+
+export {};