@salesforce/b2c-tooling-sdk 1.10.0 → 1.11.0

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

@@ -1,14 +0,0 @@
-/*
- * 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
- */
-/**
- * ODS (On-Demand Sandbox) operations.
- *
- * @module operations/ods
- */
-export { isUuid, isFriendlySandboxId, parseFriendlySandboxId, resolveSandboxId, SandboxNotFoundError, } from './sandbox-lookup.js';
-export { waitForSandbox, SandboxPollingTimeoutError, SandboxPollingError, SandboxTerminalStateError, } from './wait-for-sandbox.js';
-export { waitForClone, ClonePollingTimeoutError, ClonePollingError, CloneFailedError } from './wait-for-clone.js';
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/ods/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;AAEH,OAAO,EACL,MAAM,EACN,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAC,YAAY,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,gBAAgB,EAAC,MAAM,qBAAqB,CAAC"}

package/dist/cjs/operations/ods/sandbox-lookup.d.ts

@@ -1,63 +0,0 @@
-/**
- * Sandbox ID lookup utilities for resolving friendly sandbox identifiers.
- *
- * @module operations/ods/sandbox-lookup
- */
-import type { OdsClient } from '../../clients/ods.js';
-/**
- * Error thrown when a sandbox cannot be found by its friendly identifier.
- */
-export declare class SandboxNotFoundError extends Error {
-    readonly identifier: string;
-    readonly realm?: string | undefined;
-    readonly instance?: string | undefined;
-    constructor(identifier: string, realm?: string | undefined, instance?: string | undefined);
-}
-/**
- * Checks if a string is a valid UUID.
- *
- * @param value - The string to check
- * @returns true if the value is a valid UUID
- */
-export declare function isUuid(value: string): boolean;
-/**
- * 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 declare function isFriendlySandboxId(value: string): boolean;
-/**
- * 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 declare function parseFriendlySandboxId(value: string): {
-    realm: string;
-    instance: string;
-} | null;
-/**
- * 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 declare function resolveSandboxId(client: OdsClient, identifier: string): Promise<string>;

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

@@ -1,130 +0,0 @@
-/**
- * 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

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

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

@@ -1,46 +0,0 @@
-import type { OdsClient } from '../../clients/ods.js';
-export type CloneState = 'COMPLETED' | 'FAILED' | 'IN_PROGRESS' | 'PENDING' | (string & {});
-export declare class ClonePollingTimeoutError extends Error {
-    readonly sandboxId: string;
-    readonly cloneId: string;
-    readonly timeoutSeconds: number;
-    readonly lastStatus?: CloneState | undefined;
-    constructor(sandboxId: string, cloneId: string, timeoutSeconds: number, lastStatus?: CloneState | undefined);
-}
-export declare class ClonePollingError extends Error {
-    readonly sandboxId: string;
-    readonly cloneId: string;
-    constructor(sandboxId: string, cloneId: string, message: string);
-}
-export declare class CloneFailedError extends Error {
-    readonly sandboxId: string;
-    readonly cloneId: string;
-    readonly status: CloneState;
-    constructor(sandboxId: string, cloneId: string, status: CloneState);
-}
-export interface WaitForClonePollInfo {
-    sandboxId: string;
-    cloneId: string;
-    elapsedSeconds: number;
-    status: CloneState;
-    progressPercentage?: number;
-}
-export interface WaitForCloneOptions {
-    sandboxId: string;
-    cloneId: string;
-    pollIntervalSeconds: number;
-    timeoutSeconds: number;
-    onPoll?: (info: WaitForClonePollInfo) => void;
-    sleep?: (ms: number) => Promise<void>;
-}
-/**
- * Waits for a sandbox clone to reach COMPLETED or FAILED state by polling its status.
- *
- * @param client - ODS client for API calls
- * @param options - Polling configuration options
- *
- * @throws {ClonePollingTimeoutError} If the timeout is exceeded before completion
- * @throws {ClonePollingError} If the API request fails
- * @throws {CloneFailedError} If the clone enters the FAILED state
- */
-export declare function waitForClone(client: OdsClient, options: WaitForCloneOptions): Promise<void>;

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

@@ -1,100 +0,0 @@
-/*
- * 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 ClonePollingTimeoutError extends Error {
-    sandboxId;
-    cloneId;
-    timeoutSeconds;
-    lastStatus;
-    constructor(sandboxId, cloneId, timeoutSeconds, lastStatus) {
-        super(`Timeout waiting for clone ${cloneId} of sandbox ${sandboxId} after ${timeoutSeconds} seconds${lastStatus ? ` (lastStatus=${lastStatus})` : ''}`);
-        this.sandboxId = sandboxId;
-        this.cloneId = cloneId;
-        this.timeoutSeconds = timeoutSeconds;
-        this.lastStatus = lastStatus;
-        this.name = 'ClonePollingTimeoutError';
-    }
-}
-export class ClonePollingError extends Error {
-    sandboxId;
-    cloneId;
-    constructor(sandboxId, cloneId, message) {
-        super(`Failed to fetch clone status for ${cloneId} of sandbox ${sandboxId}: ${message}`);
-        this.sandboxId = sandboxId;
-        this.cloneId = cloneId;
-        this.name = 'ClonePollingError';
-    }
-}
-export class CloneFailedError extends Error {
-    sandboxId;
-    cloneId;
-    status;
-    constructor(sandboxId, cloneId, status) {
-        super(`Clone ${cloneId} of sandbox ${sandboxId} failed`);
-        this.sandboxId = sandboxId;
-        this.cloneId = cloneId;
-        this.status = status;
-        this.name = 'CloneFailedError';
-    }
-}
-async function defaultSleep(ms) {
-    await new Promise((resolve) => {
-        setTimeout(resolve, ms);
-    });
-}
-/**
- * Waits for a sandbox clone to reach COMPLETED or FAILED state by polling its status.
- *
- * @param client - ODS client for API calls
- * @param options - Polling configuration options
- *
- * @throws {ClonePollingTimeoutError} If the timeout is exceeded before completion
- * @throws {ClonePollingError} If the API request fails
- * @throws {CloneFailedError} If the clone enters the FAILED state
- */
-export async function waitForClone(client, options) {
-    const logger = getLogger();
-    const { sandboxId, cloneId, pollIntervalSeconds, timeoutSeconds } = options;
-    const sleepFn = options.sleep ?? defaultSleep;
-    const startTime = Date.now();
-    const pollIntervalMs = pollIntervalSeconds * 1000;
-    const timeoutMs = timeoutSeconds * 1000;
-    await sleepFn(pollIntervalMs);
-    let lastStatus;
-    while (true) {
-        const elapsedSeconds = Math.round((Date.now() - startTime) / 1000);
-        if (timeoutSeconds > 0 && Date.now() - startTime > timeoutMs) {
-            throw new ClonePollingTimeoutError(sandboxId, cloneId, timeoutSeconds, lastStatus);
-        }
-        const result = await client.GET('/sandboxes/{sandboxId}/clones/{cloneId}', {
-            params: {
-                path: { sandboxId, cloneId },
-            },
-        });
-        if (!result.data?.data) {
-            throw new ClonePollingError(sandboxId, cloneId, result.response?.statusText || 'Unknown error');
-        }
-        const clone = result.data.data;
-        const currentStatus = clone.status || 'unknown';
-        lastStatus = currentStatus;
-        logger.trace({ sandboxId, cloneId, elapsedSeconds, status: currentStatus }, '[ODS] Clone poll');
-        options.onPoll?.({
-            sandboxId,
-            cloneId,
-            elapsedSeconds,
-            status: currentStatus,
-            progressPercentage: clone.progressPercentage,
-        });
-        if (currentStatus === 'COMPLETED') {
-            return;
-        }
-        if (currentStatus === 'FAILED') {
-            throw new CloneFailedError(sandboxId, cloneId, currentStatus);
-        }
-        await sleepFn(pollIntervalMs);
-    }
-}
-//# sourceMappingURL=wait-for-clone.js.map

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

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

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

@@ -1,64 +0,0 @@
-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

@@ -1,114 +0,0 @@
-/*
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,74 +0,0 @@
-/**
- * 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

@@ -1,33 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}