@salesforce/b2c-tooling-sdk 0.2.1 → 0.4.0

package/dist/cjs/operations/ods/sandbox-lookup.js

@@ -0,0 +1,130 @@
+/**
+ * UUID regex pattern (standard 8-4-4-4-12 format).
+ */
+const UUID_REGEX = /^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/i;
+/**
+ * Friendly sandbox ID pattern: realm-instance or realm_instance
+ * - realm: 4 alphanumeric characters
+ * - separator: dash or underscore
+ * - instance: 1+ alphanumeric characters
+ */
+const FRIENDLY_ID_REGEX = /^([a-z\d]{4})[-_]([a-z\d]+)$/i;
+/**
+ * Prefix used in organization ID format (e.g., f_ecom_zzpq_013).
+ */
+const ECOM_PREFIX = 'f_ecom_';
+/**
+ * Strips the f_ecom_ prefix if present.
+ */
+function normalizeIdentifier(value) {
+    if (value.toLowerCase().startsWith(ECOM_PREFIX)) {
+        return value.slice(ECOM_PREFIX.length);
+    }
+    return value;
+}
+/**
+ * Error thrown when a sandbox cannot be found by its friendly identifier.
+ */
+export class SandboxNotFoundError extends Error {
+    identifier;
+    realm;
+    instance;
+    constructor(identifier, realm, instance) {
+        const message = realm && instance
+            ? `Sandbox not found: ${identifier} (realm=${realm}, instance=${instance})`
+            : `Sandbox not found: ${identifier}`;
+        super(message);
+        this.identifier = identifier;
+        this.realm = realm;
+        this.instance = instance;
+        this.name = 'SandboxNotFoundError';
+    }
+}
+/**
+ * Checks if a string is a valid UUID.
+ *
+ * @param value - The string to check
+ * @returns true if the value is a valid UUID
+ */
+export function isUuid(value) {
+    return UUID_REGEX.test(value);
+}
+/**
+ * Checks if a string matches the friendly sandbox ID format (realm-instance or realm_instance).
+ *
+ * @param value - The string to check
+ * @returns true if the value matches the friendly format
+ */
+export function isFriendlySandboxId(value) {
+    return FRIENDLY_ID_REGEX.test(normalizeIdentifier(value));
+}
+/**
+ * Parses a friendly sandbox ID into its realm and instance components.
+ *
+ * @param value - The friendly ID to parse (e.g., "abcd-123" or "abcd_123")
+ * @returns Object with realm and instance, or null if not a valid friendly ID
+ */
+export function parseFriendlySandboxId(value) {
+    const normalized = normalizeIdentifier(value);
+    const match = normalized.match(FRIENDLY_ID_REGEX);
+    if (!match) {
+        return null;
+    }
+    return {
+        realm: match[1].toLowerCase(),
+        instance: match[2].toLowerCase(),
+    };
+}
+/**
+ * Resolves a sandbox identifier to a UUID.
+ *
+ * If the identifier is already a UUID, it is returned directly without making an API call.
+ * If the identifier is a friendly format (realm-instance), it queries the ODS API to find
+ * the matching sandbox and returns its UUID.
+ *
+ * @param client - The ODS API client
+ * @param identifier - Sandbox identifier (UUID or friendly format like "abcd-123")
+ * @returns The sandbox UUID
+ * @throws {SandboxNotFoundError} If the sandbox cannot be found
+ *
+ * @example
+ * ```typescript
+ * // UUID is returned directly
+ * const uuid = await resolveSandboxId(client, 'abc12345-1234-1234-1234-abc123456789');
+ * // => 'abc12345-1234-1234-1234-abc123456789'
+ *
+ * // Friendly ID is looked up
+ * const uuid = await resolveSandboxId(client, 'zzzv-123');
+ * // => 'abc12345-1234-1234-1234-abc123456789' (actual UUID from API)
+ * ```
+ */
+export async function resolveSandboxId(client, identifier) {
+    // If already a UUID, return directly
+    if (isUuid(identifier)) {
+        return identifier;
+    }
+    // Try to parse as friendly ID
+    const parsed = parseFriendlySandboxId(identifier);
+    if (!parsed) {
+        // Not a UUID and not a friendly ID - treat as UUID and let API return 404
+        return identifier;
+    }
+    // Query sandboxes filtered by realm
+    const { data, error } = await client.GET('/sandboxes', {
+        params: {
+            query: {
+                filter_params: `realm=${parsed.realm}`,
+            },
+        },
+    });
+    if (error || !data?.data) {
+        throw new SandboxNotFoundError(identifier, parsed.realm, parsed.instance);
+    }
+    // Find sandbox with matching instance
+    const sandbox = data.data.find((s) => s.instance?.toLowerCase() === parsed.instance);
+    if (!sandbox?.id) {
+        throw new SandboxNotFoundError(identifier, parsed.realm, parsed.instance);
+    }
+    return sandbox.id;
+}
+//# sourceMappingURL=sandbox-lookup.js.map

package/dist/cjs/operations/ods/sandbox-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-lookup.js","sourceRoot":"","sources":["../../../../src/operations/ods/sandbox-lookup.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,UAAU,GAAG,4DAA4D,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,+BAA+B,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,GAAG,SAAS,CAAC;AAE9B;;GAEG;AACH,SAAS,mBAAmB,CAAC,KAAa;IACxC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAE3B;IACA;IACA;IAHlB,YACkB,UAAkB,EAClB,KAAc,EACd,QAAiB;QAEjC,MAAM,OAAO,GACX,KAAK,IAAI,QAAQ;YACf,CAAC,CAAC,sBAAsB,UAAU,WAAW,KAAK,cAAc,QAAQ,GAAG;YAC3E,CAAC,CAAC,sBAAsB,UAAU,EAAE,CAAC;QACzC,KAAK,CAAC,OAAO,CAAC,CAAC;QARC,eAAU,GAAV,UAAU,CAAQ;QAClB,UAAK,GAAL,KAAK,CAAS;QACd,aAAQ,GAAR,QAAQ,CAAS;QAOjC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,iBAAiB,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;QAC7B,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;KACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAiB,EAAE,UAAkB;IAC1E,qCAAqC;IACrC,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,8BAA8B;IAC9B,MAAM,MAAM,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,0EAA0E;QAC1E,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,oCAAoC;IACpC,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE;QACnD,MAAM,EAAE;YACN,KAAK,EAAE;gBACL,aAAa,EAAE,SAAS,MAAM,CAAC,KAAK,EAAE;aACvC;SACF;KACF,CAAC,CAAC;IAEH,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5E,CAAC;IAED,sCAAsC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC;IAErF,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,OAAO,CAAC,EAAE,CAAC;AACpB,CAAC"}

package/dist/cjs/operations/ods/wait-for-sandbox.d.ts

@@ -0,0 +1,64 @@
+import type { OdsClient } from '../../clients/ods.js';
+export type SandboxState = 'deleted' | 'failed' | 'started' | 'stopped' | (string & {});
+export declare class SandboxPollingTimeoutError extends Error {
+    readonly sandboxId: string;
+    readonly targetState: SandboxState;
+    readonly timeoutSeconds: number;
+    readonly lastState?: SandboxState | undefined;
+    constructor(sandboxId: string, targetState: SandboxState, timeoutSeconds: number, lastState?: SandboxState | undefined);
+}
+export declare class SandboxPollingError extends Error {
+    readonly sandboxId: string;
+    readonly message: string;
+    constructor(sandboxId: string, message: string);
+}
+export declare class SandboxTerminalStateError extends Error {
+    readonly sandboxId: string;
+    readonly targetState: SandboxState;
+    readonly state: SandboxState;
+    constructor(sandboxId: string, targetState: SandboxState, state: SandboxState);
+}
+export interface WaitForSandboxPollInfo {
+    sandboxId: string;
+    elapsedSeconds: number;
+    state: SandboxState;
+}
+export interface WaitForSandboxOptions {
+    sandboxId: string;
+    targetState: SandboxState;
+    pollIntervalSeconds: number;
+    timeoutSeconds: number;
+    onPoll?: (info: WaitForSandboxPollInfo) => void;
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * Waits for a sandbox to reach a target state by polling its status.
+ *
+ * This function polls the ODS API at regular intervals until the sandbox reaches the desired state,
+ * times out, or enters a terminal error state (failed/deleted).
+ *
+ * @param client - ODS client for API calls
+ * @param options - Polling configuration options
+ * @param options.sandboxId - ID of the sandbox to monitor
+ * @param options.targetState - Desired sandbox state (e.g., 'started', 'stopped', 'deleted')
+ * @param options.pollIntervalSeconds - Seconds between status checks
+ * @param options.timeoutSeconds - Maximum seconds to wait (0 = no timeout)
+ * @param options.onPoll - Optional callback invoked on each poll with current state
+ * @param options.sleep - Optional custom sleep function (primarily for testing)
+ *
+ * @throws {SandboxPollingTimeoutError} If the timeout is exceeded before reaching target state
+ * @throws {SandboxPollingError} If the API request fails
+ * @throws {SandboxTerminalStateError} If the sandbox enters a terminal error state
+ *
+ * @example
+ * ```typescript
+ * await waitForSandbox(odsClient, {
+ *   sandboxId: 'abc-123',
+ *   targetState: 'started',
+ *   pollIntervalSeconds: 5,
+ *   timeoutSeconds: 300,
+ *   onPoll: (info) => console.log(`State: ${info.state} (${info.elapsedSeconds}s)`),
+ * });
+ * ```
+ */
+export declare function waitForSandbox(client: OdsClient, options: WaitForSandboxOptions): Promise<void>;

package/dist/cjs/operations/ods/wait-for-sandbox.js

@@ -0,0 +1,114 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import { getLogger } from '../../logging/logger.js';
+export class SandboxPollingTimeoutError extends Error {
+    sandboxId;
+    targetState;
+    timeoutSeconds;
+    lastState;
+    constructor(sandboxId, targetState, timeoutSeconds, lastState) {
+        super(`Timeout waiting for sandbox ${sandboxId} to reach state ${targetState} after ${timeoutSeconds} seconds${lastState ? ` (lastState=${lastState})` : ''}`);
+        this.sandboxId = sandboxId;
+        this.targetState = targetState;
+        this.timeoutSeconds = timeoutSeconds;
+        this.lastState = lastState;
+        this.name = 'SandboxPollingTimeoutError';
+    }
+}
+export class SandboxPollingError extends Error {
+    sandboxId;
+    message;
+    constructor(sandboxId, message) {
+        super(`Failed to fetch sandbox status for ${sandboxId}: ${message}`);
+        this.sandboxId = sandboxId;
+        this.message = message;
+        this.name = 'SandboxPollingError';
+    }
+}
+export class SandboxTerminalStateError extends Error {
+    sandboxId;
+    targetState;
+    state;
+    constructor(sandboxId, targetState, state) {
+        super(`Sandbox ${sandboxId} reached terminal state ${state} while waiting for ${targetState}`);
+        this.sandboxId = sandboxId;
+        this.targetState = targetState;
+        this.state = state;
+        this.name = 'SandboxTerminalStateError';
+    }
+}
+async function defaultSleep(ms) {
+    await new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+/**
+ * Waits for a sandbox to reach a target state by polling its status.
+ *
+ * This function polls the ODS API at regular intervals until the sandbox reaches the desired state,
+ * times out, or enters a terminal error state (failed/deleted).
+ *
+ * @param client - ODS client for API calls
+ * @param options - Polling configuration options
+ * @param options.sandboxId - ID of the sandbox to monitor
+ * @param options.targetState - Desired sandbox state (e.g., 'started', 'stopped', 'deleted')
+ * @param options.pollIntervalSeconds - Seconds between status checks
+ * @param options.timeoutSeconds - Maximum seconds to wait (0 = no timeout)
+ * @param options.onPoll - Optional callback invoked on each poll with current state
+ * @param options.sleep - Optional custom sleep function (primarily for testing)
+ *
+ * @throws {SandboxPollingTimeoutError} If the timeout is exceeded before reaching target state
+ * @throws {SandboxPollingError} If the API request fails
+ * @throws {SandboxTerminalStateError} If the sandbox enters a terminal error state
+ *
+ * @example
+ * ```typescript
+ * await waitForSandbox(odsClient, {
+ *   sandboxId: 'abc-123',
+ *   targetState: 'started',
+ *   pollIntervalSeconds: 5,
+ *   timeoutSeconds: 300,
+ *   onPoll: (info) => console.log(`State: ${info.state} (${info.elapsedSeconds}s)`),
+ * });
+ * ```
+ */
+export async function waitForSandbox(client, options) {
+    const logger = getLogger();
+    const { sandboxId, targetState, pollIntervalSeconds, timeoutSeconds } = options;
+    const sleepFn = options.sleep ?? defaultSleep;
+    const startTime = Date.now();
+    const pollIntervalMs = pollIntervalSeconds * 1000;
+    const timeoutMs = timeoutSeconds * 1000;
+    await sleepFn(pollIntervalMs);
+    let lastState;
+    while (true) {
+        const elapsedSeconds = Math.round((Date.now() - startTime) / 1000);
+        if (timeoutSeconds > 0 && Date.now() - startTime > timeoutMs) {
+            throw new SandboxPollingTimeoutError(sandboxId, targetState, timeoutSeconds, lastState);
+        }
+        const result = await client.GET('/sandboxes/{sandboxId}', {
+            params: {
+                path: { sandboxId },
+            },
+        });
+        if (!result.data?.data) {
+            throw new SandboxPollingError(sandboxId, result.response?.statusText || 'Unknown error');
+        }
+        const sandbox = result.data.data;
+        const currentState = sandbox.state || 'unknown';
+        lastState = currentState;
+        logger.trace({ sandboxId, elapsedSeconds, state: currentState }, '[ODS] Sandbox poll');
+        options.onPoll?.({ sandboxId, elapsedSeconds, state: currentState });
+        if (currentState === targetState) {
+            return;
+        }
+        if (currentState === 'failed' || currentState === 'deleted') {
+            throw new SandboxTerminalStateError(sandboxId, targetState, currentState);
+        }
+        await sleepFn(pollIntervalMs);
+    }
+}
+//# sourceMappingURL=wait-for-sandbox.js.map

package/dist/cjs/operations/ods/wait-for-sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-sandbox.js","sourceRoot":"","sources":["../../../../src/operations/ods/wait-for-sandbox.ts"],"names":[],"mappings":"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"}

package/dist/cjs/operations/orgs/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Account Manager organization management operations.
+ *
+ * This module provides high-level functions for managing organizations in Account Manager,
+ * including retrieving organization details.
+ *
+ * ## Core Organization Functions
+ *
+ * - {@link getOrg} - Get organization details by ID
+ * - {@link getOrgByName} - Get organization details by name
+ * - {@link listOrgs} - List organizations with pagination
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import {
+ *   getOrg,
+ *   getOrgByName,
+ *   listOrgs,
+ * } from '@salesforce/b2c-tooling-sdk/operations/orgs';
+ * import {createAccountManagerOrgsClient} from '@salesforce/b2c-tooling-sdk/clients';
+ * import {OAuthStrategy} from '@salesforce/b2c-tooling-sdk/auth';
+ *
+ * const auth = new OAuthStrategy({
+ *   clientId: 'your-client-id',
+ *   clientSecret: 'your-client-secret',
+ * });
+ *
+ * const client = createAccountManagerOrgsClient({}, auth);
+ *
+ * // Get an organization by ID
+ * const org = await getOrg(client, 'org-id');
+ *
+ * // Get an organization by name
+ * const org = await getOrgByName(client, 'My Organization');
+ *
+ * // List organizations
+ * const orgs = await listOrgs(client, {size: 25, page: 0});
+ * ```
+ *
+ * ## Authentication
+ *
+ * Organization operations require OAuth authentication with appropriate Account Manager permissions.
+ *
+ * @module operations/orgs
+ */
+import type { AccountManagerOrgsClient, AccountManagerOrganization, OrganizationCollection, ListOrgsOptions } from '../../clients/am-api.js';
+export type { AccountManagerOrganization, OrganizationCollection, ListOrgsOptions } from '../../clients/am-api.js';
+/**
+ * Gets an organization by ID.
+ *
+ * @param client - Account Manager Organizations client
+ * @param orgId - Organization ID
+ * @returns Organization details
+ * @throws Error if organization is not found
+ */
+export declare function getOrg(client: AccountManagerOrgsClient, orgId: string): Promise<AccountManagerOrganization>;
+/**
+ * Gets an organization by name (searches for exact or partial match).
+ *
+ * @param client - Account Manager Organizations client
+ * @param name - Organization name
+ * @returns Organization details
+ * @throws Error if organization is not found or ambiguous
+ */
+export declare function getOrgByName(client: AccountManagerOrgsClient, name: string): Promise<AccountManagerOrganization>;
+/**
+ * Lists organizations with pagination.
+ *
+ * @param client - Account Manager Organizations client
+ * @param options - List options (size, page, all)
+ * @returns Organization collection
+ */
+export declare function listOrgs(client: AccountManagerOrgsClient, options?: ListOrgsOptions): Promise<OrganizationCollection>;

package/dist/cjs/operations/orgs/index.js

@@ -0,0 +1,33 @@
+/**
+ * Gets an organization by ID.
+ *
+ * @param client - Account Manager Organizations client
+ * @param orgId - Organization ID
+ * @returns Organization details
+ * @throws Error if organization is not found
+ */
+export async function getOrg(client, orgId) {
+    return client.getOrg(orgId);
+}
+/**
+ * Gets an organization by name (searches for exact or partial match).
+ *
+ * @param client - Account Manager Organizations client
+ * @param name - Organization name
+ * @returns Organization details
+ * @throws Error if organization is not found or ambiguous
+ */
+export async function getOrgByName(client, name) {
+    return client.getOrgByName(name);
+}
+/**
+ * Lists organizations with pagination.
+ *
+ * @param client - Account Manager Organizations client
+ * @param options - List options (size, page, all)
+ * @returns Organization collection
+ */
+export async function listOrgs(client, options) {
+    return client.listOrgs(options);
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/operations/orgs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/orgs/index.ts"],"names":[],"mappings":"AA6DA;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAgC,EAAE,KAAa;IAC1E,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAgC,EAChC,IAAY;IAEZ,OAAO,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAgC,EAChC,OAAyB;IAEzB,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}

package/dist/cjs/operations/roles/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Account Manager role management operations.
+ *
+ * This module provides high-level functions for retrieving role information
+ * in Account Manager, including listing roles and getting role details.
+ *
+ * ## Core Role Functions
+ *
+ * - {@link getRole} - Get role details by ID
+ * - {@link listRoles} - List roles with pagination
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import {getRole, listRoles} from '@salesforce/b2c-tooling-sdk/operations/roles';
+ * import {createAccountManagerRolesClient} from '@salesforce/b2c-tooling-sdk/clients';
+ * import {OAuthStrategy} from '@salesforce/b2c-tooling-sdk/auth';
+ *
+ * const auth = new OAuthStrategy({
+ *   clientId: 'your-client-id',
+ *   clientSecret: 'your-client-secret',
+ * });
+ *
+ * const client = createAccountManagerRolesClient({}, auth);
+ *
+ * // Get a role by ID
+ * const role = await getRole(client, 'bm-admin');
+ *
+ * // List roles
+ * const roles = await listRoles(client, {size: 25, page: 0});
+ *
+ * // List roles filtered by target type
+ * const userRoles = await listRoles(client, {size: 25, page: 0, roleTargetType: 'User'});
+ * ```
+ *
+ * ## Authentication
+ *
+ * Role operations require OAuth authentication with appropriate Account Manager permissions.
+ *
+ * @module operations/roles
+ */
+export { getRole, listRoles } from '../../clients/am-api.js';
+export type { AccountManagerRole, RoleCollection, ListRolesOptions } from '../../clients/am-api.js';

package/dist/cjs/operations/roles/index.js

@@ -0,0 +1,48 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * Account Manager role management operations.
+ *
+ * This module provides high-level functions for retrieving role information
+ * in Account Manager, including listing roles and getting role details.
+ *
+ * ## Core Role Functions
+ *
+ * - {@link getRole} - Get role details by ID
+ * - {@link listRoles} - List roles with pagination
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import {getRole, listRoles} from '@salesforce/b2c-tooling-sdk/operations/roles';
+ * import {createAccountManagerRolesClient} from '@salesforce/b2c-tooling-sdk/clients';
+ * import {OAuthStrategy} from '@salesforce/b2c-tooling-sdk/auth';
+ *
+ * const auth = new OAuthStrategy({
+ *   clientId: 'your-client-id',
+ *   clientSecret: 'your-client-secret',
+ * });
+ *
+ * const client = createAccountManagerRolesClient({}, auth);
+ *
+ * // Get a role by ID
+ * const role = await getRole(client, 'bm-admin');
+ *
+ * // List roles
+ * const roles = await listRoles(client, {size: 25, page: 0});
+ *
+ * // List roles filtered by target type
+ * const userRoles = await listRoles(client, {size: 25, page: 0, roleTargetType: 'User'});
+ * ```
+ *
+ * ## Authentication
+ *
+ * Role operations require OAuth authentication with appropriate Account Manager permissions.
+ *
+ * @module operations/roles
+ */
+export { getRole, listRoles } from '../../clients/am-api.js';
+//# sourceMappingURL=index.js.map

package/dist/cjs/operations/roles/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/roles/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,OAAO,EAAC,OAAO,EAAE,SAAS,EAAC,MAAM,yBAAyB,CAAC"}

package/dist/cjs/operations/users/index.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Account Manager user management operations.
+ *
+ * This module provides high-level functions for managing users in Account Manager,
+ * including CRUD operations, role management, and user lifecycle operations.
+ *
+ * ## Core User Functions
+ *
+ * - {@link getUser} - Get user details by ID
+ * - {@link getUserByLogin} - Get user details by login (email)
+ * - {@link listUsers} - List users with pagination
+ * - {@link createUser} - Create a new user
+ * - {@link updateUser} - Update an existing user
+ * - {@link deleteUser} - Disable a user (soft delete)
+ * - {@link purgeUser} - Purge a disabled user (hard delete)
+ * - {@link resetUser} - Reset a user to INITIAL state
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import {
+ *   getUserByLogin,
+ *   listUsers,
+ *   createUser,
+ *   grantRole,
+ * } from '@salesforce/b2c-tooling-sdk/operations/users';
+ * import { createAccountManagerUsersClient } from '@salesforce/b2c-tooling-sdk/clients';
+ * import { OAuthStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ *
+ * const auth = new OAuthStrategy({
+ *   clientId: 'your-client-id',
+ *   clientSecret: 'your-client-secret',
+ * });
+ *
+ * const client = createAccountManagerUsersClient({}, auth);
+ *
+ * // Get a user by login
+ * const user = await getUserByLogin(client, 'user@example.com');
+ *
+ * // List users
+ * const users = await listUsers(client, { size: 25, page: 0 });
+ *
+ * // Create a new user
+ * const newUser = await createUser(client, {
+ *   mail: 'newuser@example.com',
+ *   firstName: 'John',
+ *   lastName: 'Doe',
+ *   organizations: ['org-id'],
+ *   primaryOrganization: 'org-id',
+ * });
+ * ```
+ *
+ * ## Authentication
+ *
+ * User operations require OAuth authentication with appropriate Account Manager permissions.
+ *
+ * @module operations/users
+ */
+import type { AccountManagerUsersClient, AccountManagerUser, UserCreate, UserUpdate } from '../../clients/am-api.js';
+import { getUser, listUsers, deleteUser, purgeUser, resetUser } from '../../clients/am-api.js';
+/**
+ * Options for creating a user.
+ */
+export interface CreateUserOptions {
+    /** User details */
+    user: UserCreate;
+}
+/**
+ * Options for updating a user.
+ */
+export interface UpdateUserOptions {
+    /** User ID */
+    userId: string;
+    /** Changes to apply */
+    changes: UserUpdate;
+}
+/**
+ * Options for granting a role.
+ */
+export interface GrantRoleOptions {
+    /** User ID */
+    userId: string;
+    /** Role to grant */
+    role: string;
+    /** Optional scope for the role (tenant IDs, comma-separated) */
+    scope?: string;
+}
+/**
+ * Options for revoking a role.
+ */
+export interface RevokeRoleOptions {
+    /** User ID */
+    userId: string;
+    /** Role to revoke */
+    role: string;
+    /** Optional scope to remove (if not provided, removes entire role) */
+    scope?: string;
+}
+export { getUser, listUsers, deleteUser, purgeUser, resetUser };
+/**
+ * Retrieves details of a user by login (email).
+ * This searches through paginated results to find the user.
+ *
+ * @param client - Account Manager client
+ * @param login - User login (email)
+ * @returns User details
+ * @throws Error if user is not found
+ */
+export declare function getUserByLogin(client: AccountManagerUsersClient, login: string): Promise<AccountManagerUser>;
+/**
+ * Creates a new user.
+ *
+ * @param client - Account Manager client
+ * @param options - Create options (user details)
+ * @returns Created user
+ */
+export declare function createUser(client: AccountManagerUsersClient, options: CreateUserOptions): Promise<AccountManagerUser>;
+/**
+ * Updates an existing user.
+ *
+ * @param client - Account Manager client
+ * @param options - Update options (userId, changes)
+ * @returns Updated user
+ */
+export declare function updateUser(client: AccountManagerUsersClient, options: UpdateUserOptions): Promise<AccountManagerUser>;
+/**
+ * Grants a role to a user, optionally with scope.
+ * This updates the user's roles and roleTenantFilter.
+ *
+ * @param client - Account Manager client
+ * @param options - Grant options (userId, role, optional scope)
+ * @returns Updated user
+ */
+export declare function grantRole(client: AccountManagerUsersClient, options: GrantRoleOptions): Promise<AccountManagerUser>;
+/**
+ * Revokes a role from a user, optionally removing specific scope.
+ *
+ * @param client - Account Manager client
+ * @param options - Revoke options (userId, role, optional scope)
+ * @returns Updated user
+ */
+export declare function revokeRole(client: AccountManagerUsersClient, options: RevokeRoleOptions): Promise<AccountManagerUser>;
+export type { AccountManagerUser, UserCreate, UserUpdate, UserCollection } from '../../clients/am-api.js';