util

Build the session record that gets stored in $env.SALESFORCE

Build standard Salesforce REST API headers

Central HTTP helper for making Salesforce API calls. Returns the parsed response body (usually a record or table). Automatically handles error responses.

Raise a structured Salesforce error based on status code.

Encode a string or binary value as URL-safe, unpadded Base64 (RFC 7515) — the encoding required for JSON Web Token segments.

Extract the instance host (e.g. mydomain.my.salesforce.com) from a URL such as an OAuth `instance_url` or a SOAP serverUrl.

Resolve the OAuth login host used for the JWT `aud` claim and as the token endpoint host for the JWT and Device flows.

• If an explicit instance (My Domain) is given, use it.
• Otherwise fall back to test/login.salesforce.com based on the domain.

POST form-urlencoded parameters to a Salesforce OAuth token endpoint. Returns the full response as { status, body } without raising on errors, so callers (e.g. Device flow polling) can inspect expected error codes. `http post` form-encodes the record itself when given this content type.

Request an OAuth access token, raising a structured error on failure. Used by the Client Credentials and JWT Bearer flows.

Raise a structured error from a Salesforce OAuth token error response. The body is JSON like { error, error_description }, which `http post` may already have parsed into a record.

Build and RS256-sign a JWT assertion for the OAuth 2.0 JWT Bearer flow. iss = consumer key (client id), sub = username to impersonate, aud = login host URL, exp = now + 3 minutes. Signs `header.claims` with the RSA private key at key_path via openssl.

Validate a SOQL query string for common structural issues. Raises a descriptive error if problems are found. Call this before sending a SOQL query to the Salesforce API.

Convert an ISO 8601 date string or datetime to Salesforce-compatible format.

Find a specific XML element by tag name in a parsed XML tree. The XML tree is in Nushell's `from xml` format: { tag: "name", attributes: {...}, content: [...] } Returns the first matching element's text content, or null if not found.

Loads environment variables from a file

Parses `KEY=value` text into a record