@bugbug-io/sdk 13.39.1

package/dist/modules/auth/auth.d.ts

@@ -0,0 +1,11 @@
+import type { BugBugApiClient } from '../../services/apiClient/apiClient';
+import type { RequestOptions } from '../../types/config';
+import type { AuthAuthorizeParams, AuthAuthorizeResponse, AuthIdentity, AuthTokenRequest, AuthTokenResponse } from './auth.types';
+export declare class AuthModule {
+    #private;
+    constructor(client: BugBugApiClient);
+    getAuth: (params: AuthAuthorizeParams, options?: RequestOptions) => Promise<AuthAuthorizeResponse>;
+    exchangeCode: (payload: AuthTokenRequest, options?: RequestOptions) => Promise<AuthTokenResponse>;
+    identity: (options?: RequestOptions) => Promise<AuthIdentity>;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/modules/auth/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/modules/auth/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAEtB,qBAAa,UAAU;;gBAGT,MAAM,EAAE,eAAe;IAInC,OAAO,GACL,QAAQ,mBAAmB,EAC3B,UAAS,cAAmB,KAC3B,OAAO,CAAC,qBAAqB,CAAC,CAwB/B;IAEF,YAAY,GACV,SAAS,gBAAgB,EACzB,UAAS,cAAmB,KAC3B,OAAO,CAAC,iBAAiB,CAAC,CAWxB;IAEL,QAAQ,GAAU,UAAS,cAAmB,KAAG,OAAO,CAAC,YAAY,CAAC,CACH;CACpE"}

package/dist/modules/auth/auth.types.d.ts

@@ -0,0 +1,34 @@
+export declare const BUGBUG_CLI_OAUTH_CLIENT_ID = "bugbug-cli";
+export declare const BUGBUG_MCP_OAUTH_CLIENT_ID = "bugbug-mcp";
+export declare const BUGBUG_OAUTH_CODE_CHALLENGE_METHOD = "S256";
+export interface AuthAuthorizeParams {
+    clientId: string;
+    redirectUri: string;
+    codeChallenge: string;
+    codeChallengeMethod: typeof BUGBUG_OAUTH_CODE_CHALLENGE_METHOD;
+    state: string;
+}
+export interface AuthAuthorizeResponse {
+    authorizeUrl: string;
+}
+export interface AuthTokenRequest {
+    grantType: 'authorization_code';
+    clientId: string;
+    redirectUri: string;
+    code: string;
+    codeVerifier: string;
+}
+export interface AuthTokenResponse {
+    token: string;
+}
+export interface AuthIdentity {
+    tokenType: 'project' | 'organization' | 'user';
+    name: string;
+    expiresAt: string | null;
+    subscriptionType: string | null;
+    subscriptionExpiresAt: string | null;
+    projectId: string | null;
+    organizationId: string | null;
+    userId: string | null;
+}
+//# sourceMappingURL=auth.types.d.ts.map

package/dist/modules/auth/auth.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.types.d.ts","sourceRoot":"","sources":["../../../src/modules/auth/auth.types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,eAAe,CAAC;AACvD,eAAO,MAAM,0BAA0B,eAAe,CAAC;AACvD,eAAO,MAAM,kCAAkC,SAAS,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,OAAO,kCAAkC,CAAC;IAC/D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,oBAAoB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,SAAS,GAAG,cAAc,GAAG,MAAM,CAAC;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB"}

package/dist/modules/auth/auth.utils.d.ts

@@ -0,0 +1,4 @@
+export declare const createOAuthState: () => string;
+export declare const createOAuthCodeVerifier: () => string;
+export declare const createOAuthCodeChallenge: (verifier: string) => string;
+//# sourceMappingURL=auth.utils.d.ts.map

package/dist/modules/auth/auth.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.utils.d.ts","sourceRoot":"","sources":["../../../src/modules/auth/auth.utils.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,QAAO,MAAsB,CAAC;AAE3D,eAAO,MAAM,uBAAuB,QAAO,MAA+C,CAAC;AAE3F,eAAO,MAAM,wBAAwB,GAAI,UAAU,MAAM,KAAG,MACD,CAAC"}

package/dist/modules/components/components.d.ts

@@ -0,0 +1,43 @@
+import type { BugBugApiClient } from '../../services/apiClient/apiClient';
+import type { RequestOptions } from '../../types/config';
+import type { ComponentsListQuery, ComponentsListResponse, ComponentUsageResponse } from '@bugbug-io/api-schema';
+/**
+ * Components module for managing reusable test components
+ */
+export declare class ComponentsModule {
+    #private;
+    constructor(client: BugBugApiClient);
+    /**
+     * List all components with optional filtering and pagination
+     *
+     * @param options - Query options including search query, page, and page size
+     * @returns Paginated list of components with nested structure
+     *
+     * @example
+     * ```typescript
+     * // List all components
+     * const components = await sdk.components.list();
+     *
+     * // Search for specific components
+     * const loginComponents = await sdk.components.list({
+     *   query: 'login',
+     *   cursor: nextToken,
+     *   pageSize: 50
+     * });
+     * ```
+     */
+    list: (options?: {
+        query?: ComponentsListQuery["query"];
+        cursor?: ComponentsListQuery["cursor"];
+        pageSize?: ComponentsListQuery["page_size"];
+        ordering?: ComponentsListQuery["ordering"];
+    } & RequestOptions) => Promise<ComponentsListResponse>;
+    /**
+     * Fetch component usage — how many tests reference this component and which.
+     *
+     * @param componentId - UUID of the component.
+     * @returns `{ usage, testsIds }` from `GET /components/{id}/usage/`.
+     */
+    getUsage: (componentId: string, options?: RequestOptions) => Promise<ComponentUsageResponse>;
+}
+//# sourceMappingURL=components.d.ts.map

package/dist/modules/components/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../../src/modules/components/components.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,qBAAa,gBAAgB;;gBAGf,MAAM,EAAE,eAAe;IAInC;;;;;;;;;;;;;;;;;;OAkBG;IACH,IAAI,GACF,UAAS;QACP,KAAK,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACvC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAC5C,QAAQ,CAAC,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;KAC5C,GAAG,cAAmB,KACtB,OAAO,CAAC,sBAAsB,CAAC,CAYhC;IAEF;;;;;OAKG;IACH,QAAQ,GACN,aAAa,MAAM,EACnB,UAAS,cAAmB,KAC3B,OAAO,CAAC,sBAAsB,CAAC,CAI7B;CACN"}

package/dist/modules/config/config.d.ts

@@ -0,0 +1,48 @@
+import type { BugBugApiClient } from '../../services/apiClient/apiClient';
+import type { RequestOptions } from '../../types/config';
+import type { ApiStatus, ConnectivityStatus, SdkSystemInfo } from '../../types/sdk';
+import type { IpAddressesResponse } from '@bugbug-io/api-schema';
+/**
+ * Config module — BugBug-side configuration and connectivity probes.
+ *
+ * Used by integrators to check API reachability, get IP ranges for firewall
+ * allowlists, and surface a one-shot system summary.
+ */
+export declare class ConfigModule {
+    #private;
+    constructor(client: BugBugApiClient);
+    /**
+     * Fetch the BugBug infrastructure IP ranges that should be allowlisted for
+     * outbound runner traffic.
+     */
+    getIpAddresses: (options?: RequestOptions) => Promise<IpAddressesResponse>;
+    /**
+     * Liveness probe + token check.
+     *
+     * `GET /config/status/` is unauthenticated. If the SDK's `apiToken` is sent,
+     * the server validates it and reports the result via `authenticated`; an
+     * invalid token still returns 200, so this method only throws on
+     * transport-level failures.
+     */
+    getStatus: (options?: RequestOptions) => Promise<ApiStatus>;
+    /**
+     * Probe API connectivity and authentication by making one lightweight call.
+     *
+     * Never throws — transport failures are returned as `connected: false` with
+     * the error message. When the call succeeds, `authenticated` reflects whether
+     * the configured API token is currently valid.
+     *
+     * @returns A `ConnectivityStatus` snapshot with response time and message.
+     */
+    testConnectivity: (options?: RequestOptions) => Promise<ConnectivityStatus>;
+    /**
+     * Single-shot system summary: IP ranges + connectivity probe.
+     *
+     * Internally issues one IP-fetch and reuses it as the connectivity probe to
+     * avoid duplicate requests.
+     *
+     * @returns A {@link SdkSystemInfo} snapshot with `{ ipAddresses, connectivity, timestamp }`.
+     */
+    getSystemInfo: (options?: RequestOptions) => Promise<SdkSystemInfo>;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/modules/config/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/modules/config/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACpF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE;;;;;GAKG;AACH,qBAAa,YAAY;;gBAGX,MAAM,EAAE,eAAe;IAInC;;;OAGG;IACH,cAAc,GAAU,UAAS,cAAmB,KAAG,OAAO,CAAC,mBAAmB,CAAC,CAClB;IAEjE;;;;;;;OAOG;IACH,SAAS,GAAU,UAAS,cAAmB,KAAG,OAAO,CAAC,SAAS,CAAC,CACV;IAE1D;;;;;;;;OAQG;IACH,gBAAgB,GAAU,UAAS,cAAmB,KAAG,OAAO,CAAC,kBAAkB,CAAC,CAsBlF;IAEF;;;;;;;OAOG;IACH,aAAa,GAAU,UAAS,cAAmB,KAAG,OAAO,CAAC,aAAa,CAAC,CA4B1E;CACH"}

package/dist/modules/groups/groups.d.ts

@@ -0,0 +1,62 @@
+import type { BugBugApiClient } from '../../services/apiClient/apiClient';
+import type { RequestOptions } from '../../types/config';
+import type { Group, GroupCreateRequest, GroupsListQuery, GroupsListResponse, GroupUpdateRequest, GroupPartialUpdateRequest } from '@bugbug-io/api-schema';
+/**
+ * Groups module — manage reusable test groups (also called "components" in
+ * the public BugBug UI). A group is an ordered list of steps that can be
+ * inlined into multiple tests via {@link TestsModule.linkComponent}.
+ */
+export declare class GroupsModule {
+    #private;
+    constructor(client: BugBugApiClient);
+    /**
+     * List groups with pagination, search, and ordering.
+     *
+     * @param options.query - Search query matched against group name.
+     * @param options.ordering - Sort key; prefix with `-` for descending.
+     * @returns Paginated `GroupsListResponse`.
+     */
+    list: (options?: {
+        query?: GroupsListQuery["query"];
+        cursor?: GroupsListQuery["cursor"];
+        pageSize?: GroupsListQuery["page_size"];
+        ordering?: GroupsListQuery["ordering"];
+    } & RequestOptions) => Promise<GroupsListResponse>;
+    /**
+     * Fetch every group across all pages.
+     */
+    getAll: (options?: Omit<Parameters<GroupsModule["list"]>[0], "cursor">) => Promise<Group[]>;
+    /**
+     * Fetch a single group by ID (with nested steps).
+     *
+     * @throws {NotFoundError} When no group matches `groupId`.
+     */
+    get: (groupId: string, options?: RequestOptions) => Promise<Group>;
+    /**
+     * Create a new (empty) group.
+     *
+     * @throws {ValidationError} On invalid payload.
+     */
+    create: (data: GroupCreateRequest, options?: RequestOptions) => Promise<Group>;
+    /**
+     * Fully replace a group via PUT. Use {@link partialUpdate} for PATCH semantics.
+     *
+     * @throws {NotFoundError} When the group does not exist.
+     * @throws {ValidationError} On invalid payload.
+     */
+    update: (groupId: string, data: GroupUpdateRequest, options?: RequestOptions) => Promise<Group>;
+    /**
+     * Patch selected fields on a group (PATCH semantics).
+     *
+     * @throws {NotFoundError} When the group does not exist.
+     * @throws {ValidationError} On invalid payload.
+     */
+    partialUpdate: (groupId: string, data: GroupPartialUpdateRequest, options?: RequestOptions) => Promise<Group>;
+    /**
+     * Delete a group by ID. Tests that reference this group will lose those steps.
+     *
+     * @throws {NotFoundError} When the group does not exist.
+     */
+    delete: (groupId: string, options?: RequestOptions) => Promise<void>;
+}
+//# sourceMappingURL=groups.d.ts.map

package/dist/modules/groups/groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../../src/modules/groups/groups.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EACV,KAAK,EACL,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAI/B;;;;GAIG;AACH,qBAAa,YAAY;;gBAGX,MAAM,EAAE,eAAe;IAInC;;;;;;OAMG;IACH,IAAI,GACF,UAAS;QACP,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;QACnC,QAAQ,CAAC,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC;QACxC,QAAQ,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;KACxC,GAAG,cAAmB,KACtB,OAAO,CAAC,kBAAkB,CAAC,CAY5B;IAEF;;OAEG;IACH,MAAM,GACJ,UAAS,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAM,KAChE,OAAO,CAAC,KAAK,EAAE,CAAC,CAC8D;IAEjF;;;;OAIG;IACH,GAAG,GAAU,SAAS,MAAM,EAAE,UAAS,cAAmB,KAAG,OAAO,CAAC,KAAK,CAAC,CAItE;IAEL;;;;OAIG;IACH,MAAM,GAAU,MAAM,kBAAkB,EAAE,UAAS,cAAmB,KAAG,OAAO,CAAC,KAAK,CAAC,CAIlF;IAEL;;;;;OAKG;IACH,MAAM,GACJ,SAAS,MAAM,EACf,MAAM,kBAAkB,EACxB,UAAS,cAAmB,KAC3B,OAAO,CAAC,KAAK,CAAC,CAKZ;IAEL;;;;;OAKG;IACH,aAAa,GACX,SAAS,MAAM,EACf,MAAM,yBAAyB,EAC/B,UAAS,cAAmB,KAC3B,OAAO,CAAC,KAAK,CAAC,CAKZ;IAEL;;;;OAIG;IACH,MAAM,GAAU,SAAS,MAAM,EAAE,UAAS,cAAmB,KAAG,OAAO,CAAC,IAAI,CAAC,CAIxE;CACN"}

package/dist/modules/profiles/profiles.d.ts

@@ -0,0 +1,71 @@
+import type { BugBugApiClient } from '../../services/apiClient/apiClient';
+import type { RequestOptions } from '../../types/config';
+import type { ProfilesListQuery, ProfilesListResponse, Profile } from '@bugbug-io/api-schema';
+/**
+ * Profiles module — list and resolve BugBug run profiles.
+ *
+ * Run profiles bundle browser/device/region settings used when starting a
+ * test or suite run. {@link resolveId} is the most commonly-used helper:
+ * it accepts either a UUID (passthrough) or a profile name (looked up).
+ */
+export declare class ProfilesModule {
+    #private;
+    constructor(client: BugBugApiClient);
+    /**
+     * List run profiles, one page at a time.
+     *
+     * @param options.cursor - Opaque cursor returned as `nextToken` by the previous page.
+     * @param options.pageSize - Items per page.
+     * @returns Paginated `ProfilesListResponse` (validated via Zod).
+     * @throws {UnexpectedResponseError} On Zod validation failure.
+     */
+    list: (options?: {
+        cursor?: ProfilesListQuery["cursor"];
+        pageSize?: ProfilesListQuery["page_size"];
+    } & RequestOptions) => Promise<ProfilesListResponse>;
+    /**
+     * Fetch a single profile by ID.
+     *
+     * @throws {NotFoundError} When no profile matches `profileId`.
+     */
+    get: (profileId: string, options?: RequestOptions) => Promise<Profile>;
+    /**
+     * Find a profile by name across all pages.
+     *
+     * @returns The matching profile, or `null` when no profile has that name.
+     */
+    findByName: (profileName: string, options?: RequestOptions) => Promise<Profile | null>;
+    /**
+     * Fetch every profile across all pages.
+     *
+     * Internally follows `nextToken` until the API signals exhaustion.
+     * For large tenants this can issue multiple sequential requests; cache the
+     * result where possible.
+     */
+    getAll: (options?: RequestOptions) => Promise<Profile[]>;
+    /**
+     * Return the profile flagged `isDefault`, falling back to the first profile.
+     *
+     * @returns The default `Profile`, or `null` when the tenant has no profiles.
+     */
+    getDefault: (options?: RequestOptions) => Promise<Profile | null>;
+    /**
+     * Resolve a profile name **or** UUID to a profile UUID suitable for the
+     * `runProfileId` field on a run request.
+     *
+     * - UUID input → returned unchanged with **no** API call.
+     * - Name input → looked up via {@link findByName}.
+     *
+     * @param profileNameOrId - Human-readable profile name (e.g. `"Production"`) or UUID.
+     * @returns The matching profile UUID.
+     * @throws {NotFoundError} When `profileNameOrId` is not a UUID and no profile has that name.
+     *
+     * @example
+     * ```typescript
+     * const profileId = await sdk.profiles.resolveId('Production');
+     * await sdk.tests.startRun(testId, { profileName: profileId });
+     * ```
+     */
+    resolveId: (profileNameOrId: string, options?: RequestOptions) => Promise<string>;
+}
+//# sourceMappingURL=profiles.d.ts.map

package/dist/modules/profiles/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../../src/modules/profiles/profiles.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAK9F;;;;;;GAMG;AACH,qBAAa,cAAc;;gBAGb,MAAM,EAAE,eAAe;IAInC;;;;;;;OAOG;IACH,IAAI,GACF,UAAS;QACP,MAAM,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACrC,QAAQ,CAAC,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;KAC3C,GAAG,cAAmB,KACtB,OAAO,CAAC,oBAAoB,CAAC,CAU9B;IAEF;;;;OAIG;IACH,GAAG,GAAU,WAAW,MAAM,EAAE,UAAS,cAAmB,KAAG,OAAO,CAAC,OAAO,CAAC,CAI1E;IAEL;;;;OAIG;IACH,UAAU,GACR,aAAa,MAAM,EACnB,UAAS,cAAmB,KAC3B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAGxB;IAEF;;;;;;OAMG;IACH,MAAM,GAAU,UAAS,cAAmB,KAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CACkB;IAEnF;;;;OAIG;IACH,UAAU,GAAU,UAAS,cAAmB,KAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAGxE;IAEF;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,GAAU,iBAAiB,MAAM,EAAE,UAAS,cAAmB,KAAG,OAAO,CAAC,MAAM,CAAC,CAWxF;CACH"}

package/dist/modules/project/project.d.ts

@@ -0,0 +1,58 @@
+import type { BugBugApiClient } from '../../services/apiClient/apiClient';
+import type { RequestOptions } from '../../types/config';
+import type { ProjectSettings } from '@bugbug-io/api-schema';
+/**
+ * Project-level operations: settings, ZIP export, and ZIP import.
+ *
+ * Import is exposed as a single high-level call — the API's two-step
+ * `validate → run` flow is handled internally. The validate step is what
+ * surfaces user-correctable errors (e.g. malformed ZIP, naming conflicts).
+ */
+export declare class ProjectModule {
+    #private;
+    constructor(client: BugBugApiClient);
+    /**
+     * Fetch project settings (e.g. retention, integrations).
+     *
+     * @returns The `ProjectSettings` object for the project.
+     */
+    getSettings: (options?: RequestOptions) => Promise<ProjectSettings>;
+    /**
+     * Export the entire project as a ZIP archive (tests, suites, components,
+     * profiles, settings).
+     *
+     * @returns Raw ZIP bytes ready to be written to disk or uploaded elsewhere.
+     *
+     * @example
+     * ```typescript
+     * import { writeFile } from 'node:fs/promises';
+     * const zipBytes = await sdk.project.export();
+     * await writeFile('project.zip', zipBytes);
+     * ```
+     */
+    export: (options?: RequestOptions) => Promise<Uint8Array>;
+    /**
+     * Import a project from a ZIP archive.
+     *
+     * Performs the two-step server flow:
+     * 1. **Validate** the upload — surfaces server-side errors (malformed ZIP,
+     *    naming conflicts, …) as {@link ValidationError}.
+     * 2. **Run** the import asynchronously using the validated upload id.
+     *
+     * @param zipBytes - Raw ZIP archive bytes.
+     * @returns The response from the import run endpoint (typically a 202 with
+     *   empty body — kept as `unknown` until the API stabilizes the shape).
+     * @throws {UnexpectedResponseError} When validation succeeds but the server
+     *   omits the `uploadId` needed to trigger the run step.
+     * @throws {ValidationError} When the ZIP is rejected by validate.
+     *
+     * @example
+     * ```typescript
+     * import { readFile } from 'node:fs/promises';
+     * const bytes = await readFile('project.zip');
+     * await sdk.project.import(bytes);
+     * ```
+     */
+    import: (zipBytes: Uint8Array, options?: RequestOptions) => Promise<unknown>;
+}
+//# sourceMappingURL=project.d.ts.map

package/dist/modules/project/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/modules/project/project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI7D;;;;;;GAMG;AACH,qBAAa,aAAa;;gBAGZ,MAAM,EAAE,eAAe;IAInC;;;;OAIG;IACH,WAAW,GAAU,UAAS,cAAmB,KAAG,OAAO,CAAC,eAAe,CAAC,CACjB;IAE3D;;;;;;;;;;;;OAYG;IACH,MAAM,GAAU,UAAS,cAAmB,KAAG,OAAO,CAAC,UAAU,CAAC,CACZ;IAEtD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,GAAU,UAAU,UAAU,EAAE,UAAS,cAAmB,KAAG,OAAO,CAAC,OAAO,CAAC,CAYnF;CAoBH"}

package/dist/modules/projectArtifacts/projectArtifacts.d.ts

@@ -0,0 +1,8 @@
+import type { BugBugApiClient } from '../../services/apiClient/apiClient';
+import type { ProjectArtifact, UploadProjectArtifactOptions } from './projectArtifacts.types';
+export declare class ProjectArtifactsModule {
+    #private;
+    constructor(client: BugBugApiClient);
+    upload: ({ projectId, file, fileName, contentType, stepId, ...options }: UploadProjectArtifactOptions) => Promise<ProjectArtifact>;
+}
+//# sourceMappingURL=projectArtifacts.d.ts.map

package/dist/modules/projectArtifacts/projectArtifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectArtifacts.d.ts","sourceRoot":"","sources":["../../../src/modules/projectArtifacts/projectArtifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAE9F,qBAAa,sBAAsB;;gBAGrB,MAAM,EAAE,eAAe;IAInC,MAAM,GAAU,gEAOb,4BAA4B,KAAG,OAAO,CAAC,eAAe,CAAC,CAaxD;CACH"}

package/dist/modules/projectArtifacts/projectArtifacts.types.d.ts

@@ -0,0 +1,14 @@
+import type { RequestOptions } from '../../types/config';
+export interface ProjectArtifact {
+    id: string;
+    project: string;
+    file: string;
+}
+export interface UploadProjectArtifactOptions extends RequestOptions {
+    projectId: string;
+    file: Uint8Array | Blob;
+    fileName: string;
+    contentType?: string;
+    stepId?: string;
+}
+//# sourceMappingURL=projectArtifacts.types.d.ts.map

package/dist/modules/projectArtifacts/projectArtifacts.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectArtifacts.types.d.ts","sourceRoot":"","sources":["../../../src/modules/projectArtifacts/projectArtifacts.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,4BAA6B,SAAQ,cAAc;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/modules/projects/projects.d.ts

@@ -0,0 +1,36 @@
+import type { BugBugApiClient } from '../../services/apiClient/apiClient';
+import type { RequestOptions } from '../../types/config';
+import type { Project, ProjectsListQuery, ProjectsListResponse } from './projects.types';
+/**
+ * Projects module — lists the projects the current token can access.
+ */
+export declare class ProjectsModule {
+    #private;
+    constructor(client: BugBugApiClient);
+    /**
+     * List projects accessible with the current token, one page at a time.
+     *
+     * @param options.cursor - Opaque cursor returned as `nextToken` by the previous page.
+     * @param options.pageSize - Items per page.
+     * @param options.query - Case-insensitive name filter.
+     * @returns Paginated `ProjectsListResponse`.
+     */
+    list: (options?: {
+        cursor?: ProjectsListQuery["cursor"];
+        pageSize?: ProjectsListQuery["page_size"];
+        query?: ProjectsListQuery["query"];
+    } & RequestOptions) => Promise<ProjectsListResponse>;
+    /**
+     * Fetch every project across all pages.
+     *
+     * Internally follows `nextToken` until the API signals exhaustion.
+     */
+    getAll: (options?: RequestOptions) => Promise<Project[]>;
+    /**
+     * Find a project by its id across all pages.
+     *
+     * @returns The matching project, or `null` when no project has that id.
+     */
+    findById: (projectId: string, options?: RequestOptions) => Promise<Project | null>;
+}
+//# sourceMappingURL=projects.d.ts.map

package/dist/modules/projects/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../../src/modules/projects/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAIzF;;GAEG;AACH,qBAAa,cAAc;;gBAGb,MAAM,EAAE,eAAe;IAInC;;;;;;;OAOG;IACH,IAAI,GACF,UAAS;QACP,MAAM,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACrC,QAAQ,CAAC,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAC1C,KAAK,CAAC,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;KACpC,GAAG,cAAmB,KACtB,OAAO,CAAC,oBAAoB,CAAC,CAY9B;IAEF;;;;OAIG;IACH,MAAM,GAAU,UAAS,cAAmB,KAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CACkB;IAEnF;;;;OAIG;IACH,QAAQ,GAAU,WAAW,MAAM,EAAE,UAAS,cAAmB,KAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAGzF;CACH"}

package/dist/modules/projects/projects.types.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Project-listing types, sourced from the generated API schema
+ * (`GET /api/v2/projects/`).
+ */
+export type { Project, ProjectsListResponse, ProjectsListQuery } from '@bugbug-io/api-schema';
+//# sourceMappingURL=projects.types.d.ts.map

package/dist/modules/projects/projects.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.types.d.ts","sourceRoot":"","sources":["../../../src/modules/projects/projects.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/modules/stepRuns/stepRuns.d.ts

@@ -0,0 +1,22 @@
+import type { BugBugApiClient } from '../../services/apiClient/apiClient';
+import type { RequestOptions } from '../../types/config';
+import type { StepRunDetails } from '@bugbug-io/api-schema';
+/**
+ * Step runs module — fetch per-step execution details from a test run.
+ *
+ * Used to drill down into failure diagnostics: each test run owns N step
+ * runs, each of which carries timing, error code, and screenshot metadata.
+ */
+export declare class StepRunsModule {
+    #private;
+    constructor(client: BugBugApiClient);
+    /**
+     * Fetch full details for a single step run.
+     *
+     * @param stepRunId - UUID of the step run (from a `TestRun.stepsRuns` entry).
+     * @returns The step-run record including error code and timing.
+     * @throws {NotFoundError} When no step run matches `stepRunId`.
+     */
+    get: (stepRunId: string, options?: RequestOptions) => Promise<StepRunDetails>;
+}
+//# sourceMappingURL=stepRuns.d.ts.map

package/dist/modules/stepRuns/stepRuns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepRuns.d.ts","sourceRoot":"","sources":["../../../src/modules/stepRuns/stepRuns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;GAKG;AACH,qBAAa,cAAc;;gBAGb,MAAM,EAAE,eAAe;IAInC;;;;;;OAMG;IACH,GAAG,GAAU,WAAW,MAAM,EAAE,UAAS,cAAmB,KAAG,OAAO,CAAC,cAAc,CAAC,CAIjF;CACN"}

package/dist/modules/steps/steps.d.ts

@@ -0,0 +1,47 @@
+import type { BugBugApiClient } from '../../services/apiClient/apiClient';
+import type { RequestOptions } from '../../types/config';
+import type { StepDetails, StepCreateRequest, StepUpdateRequest, StepPatchRequest } from '@bugbug-io/api-schema';
+/**
+ * Steps module — CRUD over individual test steps.
+ *
+ * Steps belong to a group ({@link GroupsModule}). To list a group's steps,
+ * fetch the group and read `group.steps` — there is no `/steps/` list endpoint.
+ */
+export declare class StepsModule {
+    #private;
+    constructor(client: BugBugApiClient);
+    /**
+     * Fetch full details of a single step.
+     *
+     * @throws {NotFoundError} When no step matches `stepId`.
+     */
+    get: (stepId: string, options?: RequestOptions) => Promise<StepDetails>;
+    /**
+     * Create a new step inside an existing group.
+     *
+     * @param data - Step payload; `type` discriminates the validation schema.
+     * @throws {ValidationError} On invalid payload (DRF field errors on `error.fields`).
+     */
+    create: (data: StepCreateRequest, options?: RequestOptions) => Promise<StepDetails>;
+    /**
+     * Fully replace a step via PUT. Use {@link partialUpdate} for PATCH semantics.
+     *
+     * @throws {NotFoundError} When the step does not exist.
+     * @throws {ValidationError} On invalid payload.
+     */
+    update: (stepId: string, data: StepUpdateRequest, options?: RequestOptions) => Promise<StepDetails>;
+    /**
+     * Patch selected fields on a step (PATCH semantics).
+     *
+     * @throws {NotFoundError} When the step does not exist.
+     * @throws {ValidationError} On invalid payload.
+     */
+    partialUpdate: (stepId: string, data: StepPatchRequest, options?: RequestOptions) => Promise<StepDetails>;
+    /**
+     * Delete a step by ID.
+     *
+     * @throws {NotFoundError} When the step does not exist.
+     */
+    delete: (stepId: string, options?: RequestOptions) => Promise<void>;
+}
+//# sourceMappingURL=steps.d.ts.map

package/dist/modules/steps/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../../src/modules/steps/steps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAE/B;;;;;GAKG;AACH,qBAAa,WAAW;;gBAGV,MAAM,EAAE,eAAe;IAInC;;;;OAIG;IACH,GAAG,GAAU,QAAQ,MAAM,EAAE,UAAS,cAAmB,KAAG,OAAO,CAAC,WAAW,CAAC,CAI3E;IAEL;;;;;OAKG;IACH,MAAM,GAAU,MAAM,iBAAiB,EAAE,UAAS,cAAmB,KAAG,OAAO,CAAC,WAAW,CAAC,CAIvF;IAEL;;;;;OAKG;IACH,MAAM,GACJ,QAAQ,MAAM,EACd,MAAM,iBAAiB,EACvB,UAAS,cAAmB,KAC3B,OAAO,CAAC,WAAW,CAAC,CAKlB;IAEL;;;;;OAKG;IACH,aAAa,GACX,QAAQ,MAAM,EACd,MAAM,gBAAgB,EACtB,UAAS,cAAmB,KAC3B,OAAO,CAAC,WAAW,CAAC,CAKlB;IAEL;;;;OAIG;IACH,MAAM,GAAU,QAAQ,MAAM,EAAE,UAAS,cAAmB,KAAG,OAAO,CAAC,IAAI,CAAC,CAIvE;CACN"}

package/dist/modules/steps/steps.utils.d.ts

@@ -0,0 +1,11 @@
+import type { StepType } from '@bugbug-io/api-schema';
+export declare const ASSERTION_STEP_TYPES: readonly ["assert", "ifCondition"];
+export declare const VISUAL_REGRESSION_STEP_TYPES: readonly ["elementVisualRegression", "pageVisualRegression"];
+export declare const isAssertionStepType: (stepType: StepType | string | null | undefined) => boolean;
+/**
+ * True when the step type is a visual-regression step (`elementVisualRegression`
+ * or `pageVisualRegression`), i.e. it carries an observed-vs-max screenshot diff.
+ * Accepts loose input (e.g. a step run's `type` string).
+ */
+export declare const isVisualRegressionStepType: (stepType: StepType | string | null | undefined) => boolean;
+//# sourceMappingURL=steps.utils.d.ts.map

package/dist/modules/steps/steps.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.utils.d.ts","sourceRoot":"","sources":["../../../src/modules/steps/steps.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,eAAO,MAAM,oBAAoB,oCAGO,CAAC;AAEzC,eAAO,MAAM,4BAA4B,8DAGD,CAAC;AAEzC,eAAO,MAAM,mBAAmB,GAAI,UAAU,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,OACW,CAAC;AAEjG;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,UAAU,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,KAC7C,OAEqE,CAAC"}