@backblaze-labs/b2-sdk 0.2.0 → 0.3.0

package/dist/partner/raw.d.cts

@@ -0,0 +1,223 @@
+import { RetryOptions } from '../http/retry.js';
+import { HttpTransport } from '../http/transport.js';
+import { CreateGroupMemberRequest, CreateGroupMemberResponse, EjectGroupMemberRequest, EjectGroupMemberResponse, ListGroupMembersRequest, ListGroupMembersResponse, ListGroupsRequest, ListGroupsResponse, PartnerAuthorizeResponse, ReserveTrialCreateAccountRequest, ReserveTrialCreateAccountRequestEntry, ReserveTrialCreateAccountResponse } from '../types/partner.js';
+/** Configuration for constructing a {@link PartnerRawClient}. */
+export interface PartnerRawClientOptions {
+    /**
+     * The HTTP transport used to send requests.
+     *
+     * Partner endpoint calls validate URLs against suffixes recorded by
+     * `authorizePartner()`. A rehydrated client that skips authorization must use
+     * `authorizedPartnerEndpointSuffixes` or a {@link UrlGuardedTransport} with a
+     * locked `urlGuard`. Because Partner authorize responses redact
+     * `authorizationToken` under `JSON.stringify`, durable caches should persist
+     * `partnerAuthorizeResponseForPersistence(auth)` only to encrypted or
+     * otherwise credential-grade storage, or use another secure token-preserving
+     * representation.
+     */
+    readonly transport: HttpTransport;
+    /**
+     * Validated Partner endpoint host suffixes restored from cached
+     * authorization. Facades normally manage this after authorization; direct raw
+     * clients can pass suffixes derived from trusted Partner authorization when
+     * rehydrating an auth cache. Do not derive this cache with
+     * `JSON.stringify(authorizePartner())`, which intentionally stores a redacted
+     * token placeholder instead of a usable Partner token. Rehydrating that
+     * placeholder fails fast.
+     */
+    readonly authorizedPartnerEndpointSuffixes?: readonly string[];
+    /**
+     * Allow direct custom authorize realms for tests or private proxies.
+     * Leave disabled unless the configured host is trusted with the Master Application Key.
+     */
+    readonly allowCustomAuthorizeRealm?: boolean;
+}
+/** Optional controls for raw Partner API requests. */
+export interface PartnerRawRequestOptions {
+    /** Abort signal for cancelling the request. */
+    readonly signal?: AbortSignal;
+    /** Per-request retry override. */
+    readonly retry?: Partial<RetryOptions>;
+}
+/**
+ * Derives the Partner authorize and endpoint host suffixes that may receive
+ * Partner tokens after a trusted authorize response has been validated.
+ *
+ * @param auth - Normalized Partner authorize response.
+ * @param realmUrl - Realm URL used for Partner authorization.
+ *
+ * @returns Sorted list of unique host suffixes to allow.
+ *
+ * @internal
+ */
+export declare function derivePartnerAllowedSuffixes(auth: PartnerAuthorizeResponse, realmUrl: string): readonly string[];
+/**
+ * Validates cached Partner authorize endpoint URLs with the same realm policy
+ * applied to fresh `authorizePartner()` responses and returns guard suffixes.
+ *
+ * @param auth - Cached Partner authorize response to validate.
+ * @param realmUrl - Realm URL used for Partner authorization.
+ * @param allowCustomAuthorizeRealm - Whether custom authorize realms are trusted.
+ *
+ * @returns Sorted list of host suffixes derived from the validated auth state.
+ *
+ * @throws B2PartnerAuthorizationError if the cached auth endpoints are unsafe.
+ *
+ * @internal
+ */
+export declare function validatePartnerAuthorizeResponseEndpoints(auth: PartnerAuthorizeResponse, realmUrl: string, allowCustomAuthorizeRealm: boolean): readonly string[];
+/**
+ * Low-level client for Partner API authorization and endpoint bindings.
+ */
+export declare class PartnerRawClient {
+    /** @internal */
+    private readonly transport;
+    private readonly allowCustomAuthorizeRealm;
+    private authorizedEndpointSuffixes;
+    /**
+     * Creates a new PartnerRawClient with the given transport.
+     *
+     * @param options - The constructor configuration.
+     */
+    constructor(options: PartnerRawClientOptions);
+    /**
+     * Replaces the validated Partner endpoint host suffixes.
+     *
+     * @param suffixes - Host suffixes derived from Partner authorization.
+     *
+     * @internal
+     */
+    setAuthorizedEndpointSuffixes(suffixes: readonly string[]): void;
+    /**
+     * Calls `b2_authorize_account` with Master Application Key credentials and
+     * normalizes the Partner/Backup suites into a Partner-specific auth shape.
+     *
+     * The Partner API documentation currently shows the v3 authorize path, so
+     * this method intentionally uses `/b2api/v3/b2_authorize_account` while the
+     * storage raw client keeps using v4.
+     *
+     * @param masterKeyId - The Master Application Key ID for authentication.
+     * @param masterKey - The Master Application Key secret.
+     * @param realmUrl - The B2 realm URL to authenticate against.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The normalized Partner authorization response.
+     *
+     * @throws B2RealmConfigurationError if the realm URL is unsafe for Master Application Key credentials.
+     * @throws B2PartnerAuthorizationError if the response omits or returns unsafe Partner endpoint data.
+     */
+    authorizePartner(masterKeyId: string, masterKey: string, realmUrl?: string, options?: PartnerRawRequestOptions): Promise<PartnerAuthorizeResponse>;
+    /**
+     * Calls {@link https://www.backblaze.com/apidocs/b2-create-group-member | b2_create_group_member}.
+     *
+     * The Partner API creates a new Backblaze account for an email address that
+     * is not already a Backblaze account and adds that account to the managed
+     * group. The wire response is a JSON array.
+     *
+     * @param groupsApiUrl - The Partner API base URL from `authorizePartner`.
+     * @param authToken - The Partner API authorization token.
+     * @param request - The group-member creation request body.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The created member result array, including the member application key.
+     */
+    createGroupMember(groupsApiUrl: string, authToken: string, request: CreateGroupMemberRequest, options?: PartnerRawRequestOptions): Promise<CreateGroupMemberResponse>;
+    /**
+     * Calls {@link https://www.backblaze.com/apidocs/b2-eject-group-member | b2_eject_group_member}.
+     *
+     * Ejection removes the member account from the group but does not delete the
+     * Backblaze account. The wire response is a single JSON object.
+     *
+     * @param groupsApiUrl - The Partner API base URL from `authorizePartner`.
+     * @param authToken - The Partner API authorization token.
+     * @param request - The group-member ejection request body.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The ejected member object.
+     */
+    ejectGroupMember(groupsApiUrl: string, authToken: string, request: EjectGroupMemberRequest, options?: PartnerRawRequestOptions): Promise<EjectGroupMemberResponse>;
+    /**
+     * Calls {@link https://www.backblaze.com/apidocs/b2-reserve-trial-create-account | b2_reserve_trial_create_account}.
+     *
+     * The Partner API creates one or more new Backblaze B2 accounts and starts
+     * B2 Reserve trials for them. Backblaze documents both the wire request and
+     * the success response as JSON arrays. The array form must include at least
+     * one request entry. For convenience, this raw binding intentionally accepts
+     * one request entry for the one-account case and always sends an array on the
+     * wire.
+     *
+     * Each email address must not already be a Backblaze account. `term` is the
+     * trial duration in days, documented as 7 through 30 inclusive. `storage` is
+     * the requested storage in TB, documented as 1 through 50 inclusive.
+     *
+     * This operation is non-idempotent and creates billable accounts. Automatic
+     * retries and expired-token reauthorization are disabled; long-lived batch
+     * callers must catch auth expiry, reauthorize, and then decide whether to
+     * issue a new request. A network or timeout failure after the server has
+     * processed the request may still have created one or more accounts, and the
+     * application keys from a lost response are not recoverable from B2. Bulk
+     * callers should reconcile account state out of band, such as through Partner
+     * account listing, before re-issuing the same batch.
+     *
+     * @param groupsApiUrl - The Partner API base URL from `authorizePartner`. The authorize response currently exposes the shared Partner endpoint base as `groupsApiUrl`.
+     * @param authToken - The Partner API authorization token.
+     * @param request - One reserve-trial account request, or one or more entries.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The created reserve-trial account result array.
+     *
+     * @experimental Partner API surface; shape may change as the Partner API docs evolve.
+     */
+    reserveTrialCreateAccount(groupsApiUrl: string, authToken: string, request: ReserveTrialCreateAccountRequestEntry | ReserveTrialCreateAccountRequest, options?: PartnerRawRequestOptions): Promise<ReserveTrialCreateAccountResponse>;
+    /**
+     * Calls {@link https://www.backblaze.com/apidocs/b2-list-groups | b2_list_groups}.
+     *
+     * Uses the documented canonical GET form. The wire response is a single JSON
+     * object that surfaces `nextGroupId` for cursor-based pagination.
+     *
+     * @param groupsApiUrl - The Partner API base URL from `authorizePartner`.
+     * @param authToken - The Partner API authorization token.
+     * @param request - The group listing query parameters.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The groups page object.
+     */
+    listGroups(groupsApiUrl: string, authToken: string, request: ListGroupsRequest, options?: PartnerRawRequestOptions): Promise<ListGroupsResponse>;
+    /**
+     * Calls {@link https://www.backblaze.com/apidocs/b2-list-group-members | b2_list_group_members}.
+     *
+     * Uses the documented canonical GET form. The wire response is a JSON array
+     * whose result objects surface `nextEmail` for cursor-based pagination.
+     *
+     * @param groupsApiUrl - The Partner API base URL from `authorizePartner`.
+     * @param authToken - The Partner API authorization token.
+     * @param request - The member listing query parameters.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The group-member page result array.
+     */
+    listGroupMembers(groupsApiUrl: string, authToken: string, request: ListGroupMembersRequest, options?: PartnerRawRequestOptions): Promise<ListGroupMembersResponse>;
+    /**
+     * Sends a JSON GET request to the specified Partner API endpoint.
+     * @param groupsApiUrl - The Partner API base URL.
+     * @param authToken - The Partner API authorization token.
+     * @param endpoint - The Partner API endpoint name.
+     * @param query - The query-string parameters.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The parsed JSON response.
+     */
+    private getJson;
+    /**
+     * Sends a JSON POST request to the specified Partner API endpoint.
+     * @param groupsApiUrl - The Partner API base URL.
+     * @param authToken - The Partner API authorization token.
+     * @param endpoint - The Partner API endpoint name.
+     * @param body - The JSON request body.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The parsed JSON response.
+     */
+    private postJson;
+}
+//# sourceMappingURL=raw.d.ts.map

package/dist/partner/raw.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../../src/partner/raw.js"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,sBAAsB,CAAA;AAI7B,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAElB,wBAAwB,EAGxB,gCAAgC,EAChC,qCAAqC,EACrC,iCAAiC,EAClC,MAAM,qBAAqB,CAAA;AAyB5B,iEAAiE;AACjE,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC;;;;;;;;OAQG;IACH,QAAQ,CAAC,iCAAiC,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9D;;;OAGG;IACH,QAAQ,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAA;CAC7C;AAED,sDAAsD;AACtD,MAAM,WAAW,wBAAwB;IACvC,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;CACvC;AAmID;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,wBAAwB,EAC9B,QAAQ,EAAE,MAAM,GACf,SAAS,MAAM,EAAE,CASnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yCAAyC,CACvD,IAAI,EAAE,wBAAwB,EAC9B,QAAQ,EAAE,MAAM,EAChB,yBAAyB,EAAE,OAAO,GACjC,SAAS,MAAM,EAAE,CAenB;AA8CD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAS;IACnD,OAAO,CAAC,0BAA0B,CAAmB;IAErD;;;;OAIG;gBACS,OAAO,EAAE,uBAAuB;IAM5C;;;;;;OAMG;IACH,6BAA6B,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAIhE;;;;;;;;;;;;;;;;;OAiBG;IACG,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,SAA4B,EACpC,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,wBAAwB,CAAC;IAuBpC;;;;;;;;;;;;;OAaG;IACG,iBAAiB,CACrB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,wBAAwB,EACjC,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,yBAAyB,CAAC;IAgBrC;;;;;;;;;;;;OAYG;IACG,gBAAgB,CACpB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,uBAAuB,EAChC,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,wBAAwB,CAAC;IAepC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,yBAAyB,CAC7B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,qCAAqC,GAAG,gCAAgC,EACjF,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,iCAAiC,CAAC;IAW7C;;;;;;;;;;;;OAYG;IACG,UAAU,CACd,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,kBAAkB,CAAC;IAe9B;;;;;;;;;;;;OAYG;IACG,gBAAgB,CACpB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,uBAAuB,EAChC,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,wBAAwB,CAAC;IAepC;;;;;;;;;OASG;YACW,OAAO;IAwBrB;;;;;;;;;OASG;YACW,QAAQ;CAyBvB"}

package/dist/partner/raw.d.ts

@@ -0,0 +1,223 @@
+import { RetryOptions } from '../http/retry.js';
+import { HttpTransport } from '../http/transport.js';
+import { CreateGroupMemberRequest, CreateGroupMemberResponse, EjectGroupMemberRequest, EjectGroupMemberResponse, ListGroupMembersRequest, ListGroupMembersResponse, ListGroupsRequest, ListGroupsResponse, PartnerAuthorizeResponse, ReserveTrialCreateAccountRequest, ReserveTrialCreateAccountRequestEntry, ReserveTrialCreateAccountResponse } from '../types/partner.js';
+/** Configuration for constructing a {@link PartnerRawClient}. */
+export interface PartnerRawClientOptions {
+    /**
+     * The HTTP transport used to send requests.
+     *
+     * Partner endpoint calls validate URLs against suffixes recorded by
+     * `authorizePartner()`. A rehydrated client that skips authorization must use
+     * `authorizedPartnerEndpointSuffixes` or a {@link UrlGuardedTransport} with a
+     * locked `urlGuard`. Because Partner authorize responses redact
+     * `authorizationToken` under `JSON.stringify`, durable caches should persist
+     * `partnerAuthorizeResponseForPersistence(auth)` only to encrypted or
+     * otherwise credential-grade storage, or use another secure token-preserving
+     * representation.
+     */
+    readonly transport: HttpTransport;
+    /**
+     * Validated Partner endpoint host suffixes restored from cached
+     * authorization. Facades normally manage this after authorization; direct raw
+     * clients can pass suffixes derived from trusted Partner authorization when
+     * rehydrating an auth cache. Do not derive this cache with
+     * `JSON.stringify(authorizePartner())`, which intentionally stores a redacted
+     * token placeholder instead of a usable Partner token. Rehydrating that
+     * placeholder fails fast.
+     */
+    readonly authorizedPartnerEndpointSuffixes?: readonly string[];
+    /**
+     * Allow direct custom authorize realms for tests or private proxies.
+     * Leave disabled unless the configured host is trusted with the Master Application Key.
+     */
+    readonly allowCustomAuthorizeRealm?: boolean;
+}
+/** Optional controls for raw Partner API requests. */
+export interface PartnerRawRequestOptions {
+    /** Abort signal for cancelling the request. */
+    readonly signal?: AbortSignal;
+    /** Per-request retry override. */
+    readonly retry?: Partial<RetryOptions>;
+}
+/**
+ * Derives the Partner authorize and endpoint host suffixes that may receive
+ * Partner tokens after a trusted authorize response has been validated.
+ *
+ * @param auth - Normalized Partner authorize response.
+ * @param realmUrl - Realm URL used for Partner authorization.
+ *
+ * @returns Sorted list of unique host suffixes to allow.
+ *
+ * @internal
+ */
+export declare function derivePartnerAllowedSuffixes(auth: PartnerAuthorizeResponse, realmUrl: string): readonly string[];
+/**
+ * Validates cached Partner authorize endpoint URLs with the same realm policy
+ * applied to fresh `authorizePartner()` responses and returns guard suffixes.
+ *
+ * @param auth - Cached Partner authorize response to validate.
+ * @param realmUrl - Realm URL used for Partner authorization.
+ * @param allowCustomAuthorizeRealm - Whether custom authorize realms are trusted.
+ *
+ * @returns Sorted list of host suffixes derived from the validated auth state.
+ *
+ * @throws B2PartnerAuthorizationError if the cached auth endpoints are unsafe.
+ *
+ * @internal
+ */
+export declare function validatePartnerAuthorizeResponseEndpoints(auth: PartnerAuthorizeResponse, realmUrl: string, allowCustomAuthorizeRealm: boolean): readonly string[];
+/**
+ * Low-level client for Partner API authorization and endpoint bindings.
+ */
+export declare class PartnerRawClient {
+    /** @internal */
+    private readonly transport;
+    private readonly allowCustomAuthorizeRealm;
+    private authorizedEndpointSuffixes;
+    /**
+     * Creates a new PartnerRawClient with the given transport.
+     *
+     * @param options - The constructor configuration.
+     */
+    constructor(options: PartnerRawClientOptions);
+    /**
+     * Replaces the validated Partner endpoint host suffixes.
+     *
+     * @param suffixes - Host suffixes derived from Partner authorization.
+     *
+     * @internal
+     */
+    setAuthorizedEndpointSuffixes(suffixes: readonly string[]): void;
+    /**
+     * Calls `b2_authorize_account` with Master Application Key credentials and
+     * normalizes the Partner/Backup suites into a Partner-specific auth shape.
+     *
+     * The Partner API documentation currently shows the v3 authorize path, so
+     * this method intentionally uses `/b2api/v3/b2_authorize_account` while the
+     * storage raw client keeps using v4.
+     *
+     * @param masterKeyId - The Master Application Key ID for authentication.
+     * @param masterKey - The Master Application Key secret.
+     * @param realmUrl - The B2 realm URL to authenticate against.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The normalized Partner authorization response.
+     *
+     * @throws B2RealmConfigurationError if the realm URL is unsafe for Master Application Key credentials.
+     * @throws B2PartnerAuthorizationError if the response omits or returns unsafe Partner endpoint data.
+     */
+    authorizePartner(masterKeyId: string, masterKey: string, realmUrl?: string, options?: PartnerRawRequestOptions): Promise<PartnerAuthorizeResponse>;
+    /**
+     * Calls {@link https://www.backblaze.com/apidocs/b2-create-group-member | b2_create_group_member}.
+     *
+     * The Partner API creates a new Backblaze account for an email address that
+     * is not already a Backblaze account and adds that account to the managed
+     * group. The wire response is a JSON array.
+     *
+     * @param groupsApiUrl - The Partner API base URL from `authorizePartner`.
+     * @param authToken - The Partner API authorization token.
+     * @param request - The group-member creation request body.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The created member result array, including the member application key.
+     */
+    createGroupMember(groupsApiUrl: string, authToken: string, request: CreateGroupMemberRequest, options?: PartnerRawRequestOptions): Promise<CreateGroupMemberResponse>;
+    /**
+     * Calls {@link https://www.backblaze.com/apidocs/b2-eject-group-member | b2_eject_group_member}.
+     *
+     * Ejection removes the member account from the group but does not delete the
+     * Backblaze account. The wire response is a single JSON object.
+     *
+     * @param groupsApiUrl - The Partner API base URL from `authorizePartner`.
+     * @param authToken - The Partner API authorization token.
+     * @param request - The group-member ejection request body.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The ejected member object.
+     */
+    ejectGroupMember(groupsApiUrl: string, authToken: string, request: EjectGroupMemberRequest, options?: PartnerRawRequestOptions): Promise<EjectGroupMemberResponse>;
+    /**
+     * Calls {@link https://www.backblaze.com/apidocs/b2-reserve-trial-create-account | b2_reserve_trial_create_account}.
+     *
+     * The Partner API creates one or more new Backblaze B2 accounts and starts
+     * B2 Reserve trials for them. Backblaze documents both the wire request and
+     * the success response as JSON arrays. The array form must include at least
+     * one request entry. For convenience, this raw binding intentionally accepts
+     * one request entry for the one-account case and always sends an array on the
+     * wire.
+     *
+     * Each email address must not already be a Backblaze account. `term` is the
+     * trial duration in days, documented as 7 through 30 inclusive. `storage` is
+     * the requested storage in TB, documented as 1 through 50 inclusive.
+     *
+     * This operation is non-idempotent and creates billable accounts. Automatic
+     * retries and expired-token reauthorization are disabled; long-lived batch
+     * callers must catch auth expiry, reauthorize, and then decide whether to
+     * issue a new request. A network or timeout failure after the server has
+     * processed the request may still have created one or more accounts, and the
+     * application keys from a lost response are not recoverable from B2. Bulk
+     * callers should reconcile account state out of band, such as through Partner
+     * account listing, before re-issuing the same batch.
+     *
+     * @param groupsApiUrl - The Partner API base URL from `authorizePartner`. The authorize response currently exposes the shared Partner endpoint base as `groupsApiUrl`.
+     * @param authToken - The Partner API authorization token.
+     * @param request - One reserve-trial account request, or one or more entries.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The created reserve-trial account result array.
+     *
+     * @experimental Partner API surface; shape may change as the Partner API docs evolve.
+     */
+    reserveTrialCreateAccount(groupsApiUrl: string, authToken: string, request: ReserveTrialCreateAccountRequestEntry | ReserveTrialCreateAccountRequest, options?: PartnerRawRequestOptions): Promise<ReserveTrialCreateAccountResponse>;
+    /**
+     * Calls {@link https://www.backblaze.com/apidocs/b2-list-groups | b2_list_groups}.
+     *
+     * Uses the documented canonical GET form. The wire response is a single JSON
+     * object that surfaces `nextGroupId` for cursor-based pagination.
+     *
+     * @param groupsApiUrl - The Partner API base URL from `authorizePartner`.
+     * @param authToken - The Partner API authorization token.
+     * @param request - The group listing query parameters.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The groups page object.
+     */
+    listGroups(groupsApiUrl: string, authToken: string, request: ListGroupsRequest, options?: PartnerRawRequestOptions): Promise<ListGroupsResponse>;
+    /**
+     * Calls {@link https://www.backblaze.com/apidocs/b2-list-group-members | b2_list_group_members}.
+     *
+     * Uses the documented canonical GET form. The wire response is a JSON array
+     * whose result objects surface `nextEmail` for cursor-based pagination.
+     *
+     * @param groupsApiUrl - The Partner API base URL from `authorizePartner`.
+     * @param authToken - The Partner API authorization token.
+     * @param request - The member listing query parameters.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The group-member page result array.
+     */
+    listGroupMembers(groupsApiUrl: string, authToken: string, request: ListGroupMembersRequest, options?: PartnerRawRequestOptions): Promise<ListGroupMembersResponse>;
+    /**
+     * Sends a JSON GET request to the specified Partner API endpoint.
+     * @param groupsApiUrl - The Partner API base URL.
+     * @param authToken - The Partner API authorization token.
+     * @param endpoint - The Partner API endpoint name.
+     * @param query - The query-string parameters.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The parsed JSON response.
+     */
+    private getJson;
+    /**
+     * Sends a JSON POST request to the specified Partner API endpoint.
+     * @param groupsApiUrl - The Partner API base URL.
+     * @param authToken - The Partner API authorization token.
+     * @param endpoint - The Partner API endpoint name.
+     * @param body - The JSON request body.
+     * @param options - Optional abort and per-request retry settings.
+     *
+     * @returns The parsed JSON response.
+     */
+    private postJson;
+}
+//# sourceMappingURL=raw.d.ts.map

package/dist/partner/raw.d.ts.map

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