@bugbug-io/sdk 13.39.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"visualRegression.types.d.ts","sourceRoot":"","sources":["../../../src/modules/visualRegression/visualRegression.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,8BAA8B,GAAG,mBAAmB,GAAG,wBAAwB,CAAC;AAE5F,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,6BAA6B,EAAE,CAAC;CAC1C"}

package/dist/sdk.d.ts

@@ -0,0 +1,126 @@
+import type { BugBugConfig, RequestOptions } from './types/config';
+import type { ConnectivityStatus } from './types/sdk';
+import { AuthModule } from './modules/auth/auth';
+import { ComponentsModule } from './modules/components/components';
+import { ConfigModule } from './modules/config/config';
+import { GroupsModule } from './modules/groups/groups';
+import { ProfilesModule } from './modules/profiles/profiles';
+import { ProjectModule } from './modules/project/project';
+import { ProjectArtifactsModule } from './modules/projectArtifacts/projectArtifacts';
+import { ProjectsModule } from './modules/projects/projects';
+import { StepRunsModule } from './modules/stepRuns/stepRuns';
+import { StepsModule } from './modules/steps/steps';
+import { SuitesModule } from './modules/suites/suites';
+import { TestsModule } from './modules/tests/tests';
+import { VariablesModule } from './modules/variables/variables';
+import { VisualRegressionModule } from './modules/visualRegression/visualRegression';
+/**
+ * Main BugBug SDK class providing modular access to BugBug API functionality.
+ *
+ * Organizes functionality into dedicated modules:
+ * - `tests` - Test management and execution
+ * - `suites` - Suite management and execution
+ * - `profiles` - Profile management
+ * - `config` - System configuration and connectivity
+ * - `groups` - Groups/components management
+ * - `components` - Reusable test components listing
+ * - `steps` - Individual test steps management
+ * - `project` - Project settings, ZIP export, and ZIP import
+ * - `projectArtifacts` - Project artifact uploads for upload-file steps
+ * - `visualRegression` - Visual regression reference screenshots
+ * - `auth` - OAuth authorization and token identity helpers
+ *
+ * @example
+ * ```typescript
+ * import { createBugBug } from '@bugbug-io/sdk';
+ *
+ * const sdk = createBugBug({
+ *   apiToken: 'your-api-token',
+ *   verbose: true
+ * });
+ *
+ * // Run a test and watch progress
+ * const result = await sdk.tests.startRun('my-test', {
+ *   watchProgress: true,
+ *   onProgress: (run) => console.log(`Status: ${run.status}`)
+ * });
+ * ```
+ */
+export declare class BugBugSDK {
+    #private;
+    readonly tests: TestsModule;
+    readonly suites: SuitesModule;
+    readonly profiles: ProfilesModule;
+    readonly config: ConfigModule;
+    readonly groups: GroupsModule;
+    readonly components: ComponentsModule;
+    readonly steps: StepsModule;
+    readonly stepRuns: StepRunsModule;
+    readonly project: ProjectModule;
+    readonly projectArtifacts: ProjectArtifactsModule;
+    readonly projects: ProjectsModule;
+    readonly variables: VariablesModule;
+    readonly visualRegression: VisualRegressionModule;
+    readonly auth: AuthModule;
+    /**
+     * @param config - SDK configuration (API token, base URL, rate limits, etc.)
+     */
+    constructor(config: BugBugConfig);
+    /**
+     * Get the current SDK configuration.
+     *
+     * @returns Readonly configuration object with all resolved defaults
+     *
+     * @example
+     * ```typescript
+     * const config = sdk.getConfig();
+     * console.log(`API URL: ${config.apiUrl}`);
+     * console.log(`Verbose: ${config.verbose}`);
+     * ```
+     */
+    getConfig: () => Readonly<Required<BugBugConfig>>;
+    /**
+     * Update SDK configuration at runtime.
+     *
+     * @param updates - Partial configuration updates to apply
+     *
+     * @example
+     * ```typescript
+     * sdk.updateConfig({
+     *   verbose: true,
+     *   timeout: 60000
+     * });
+     * ```
+     */
+    updateConfig: (updates: Partial<BugBugConfig>) => void;
+    /**
+     * Set the active project for subsequent project-scoped requests.
+     * Shorthand for `updateConfig({ projectId })`.
+     *
+     * @param projectId - The project id to scope requests to.
+     *
+     * @example
+     * ```typescript
+     * sdk.setProject('00000000-0000-0000-0000-000000000001');
+     * ```
+     */
+    setProject: (projectId: string) => void;
+    /**
+     * Test API connectivity and authentication.
+     *
+     * @param options - Request options including timeout and signal
+     * @returns Connectivity test result with timing and status
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.testConnection();
+     * if (result.connected) {
+     *   console.log(`Connected in ${result.responseTime}ms`);
+     * } else {
+     *   console.error(`Connection failed: ${result.error}`);
+     * }
+     * ```
+     */
+    testConnection: (options?: RequestOptions) => Promise<ConnectivityStatus>;
+}
+//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAGrF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,SAAS;;IAGpB,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,MAAM,EAAE,YAAY,CAAC;IACrC,SAAgB,QAAQ,EAAE,cAAc,CAAC;IACzC,SAAgB,MAAM,EAAE,YAAY,CAAC;IACrC,SAAgB,MAAM,EAAE,YAAY,CAAC;IACrC,SAAgB,UAAU,EAAE,gBAAgB,CAAC;IAC7C,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,QAAQ,EAAE,cAAc,CAAC;IACzC,SAAgB,OAAO,EAAE,aAAa,CAAC;IACvC,SAAgB,gBAAgB,EAAE,sBAAsB,CAAC;IACzD,SAAgB,QAAQ,EAAE,cAAc,CAAC;IACzC,SAAgB,SAAS,EAAE,eAAe,CAAC;IAC3C,SAAgB,gBAAgB,EAAE,sBAAsB,CAAC;IACzD,SAAgB,IAAI,EAAE,UAAU,CAAC;IAEjC;;OAEG;gBACS,MAAM,EAAE,YAAY;IAoBhC;;;;;;;;;;;OAWG;IACH,SAAS,QAAO,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAA6B;IAE7E;;;;;;;;;;;;OAYG;IACH,YAAY,GAAI,SAAS,OAAO,CAAC,YAAY,CAAC,KAAG,IAAI,CAEnD;IAEF;;;;;;;;;;OAUG;IACH,UAAU,GAAI,WAAW,MAAM,KAAG,IAAI,CAEpC;IAEF;;;;;;;;;;;;;;;OAeG;IACH,cAAc,GAAU,UAAS,cAAmB,KAAG,OAAO,CAAC,kBAAkB,CAAC,CAC1C;CACzC"}

package/dist/services/apiClient/apiClient.d.ts

@@ -0,0 +1,167 @@
+import type { BugBugConfig, RequestOptions } from '../../types/config';
+/**
+ * Core HTTP client for the BugBug API.
+ *
+ * Owns the auth/base-URL configuration, request-time rate limiting,
+ * timeout/abort handling, and the OpenAPI→SDK error mapping. Domain modules
+ * (tests/suites/…) call into these methods; integrators rarely instantiate
+ * this directly — use `createBugBug()` from the package root instead.
+ *
+ * Every public HTTP method may throw one of the SDK error classes from
+ * `types/errors.ts`:
+ * - `AuthenticationError` (401), `AuthorizationError` (403)
+ * - `NotFoundError` (404), `ValidationError` (400/422 with DRF field map)
+ * - `RateLimitError` (429), `InternalServerError` (500),
+ *   `ServiceUnavailableError` (502/503/504), `HttpError` (other 4xx/5xx)
+ * - `NetworkError`, `TimeoutError`, `CancellationError`, `UnexpectedResponseError`
+ */
+export declare class BugBugApiClient {
+    #private;
+    constructor(config: BugBugConfig);
+    /**
+     * Issue a GET request through the openapi-fetch JSON path.
+     *
+     * @param path - API path template (e.g. `/tests/{id}/`).
+     * @param options.queryParams - Mapped to URL search params; `undefined`/`null` values are dropped.
+     * @param options.pathParams - Used to substitute `{name}` placeholders in `path`.
+     * @returns Parsed JSON response body typed as `T`.
+     */
+    get: <T = unknown>(path: string, options?: RequestOptions & {
+        queryParams?: Record<string, unknown>;
+        pathParams?: Record<string, string>;
+    }) => Promise<T>;
+    /**
+     * Issue a POST request. The body is JSON-serialized by openapi-fetch.
+     *
+     * @param path - API path template.
+     * @param options.body - Request body (JSON-serialized).
+     * @param options.queryParams - URL search params.
+     * @param options.pathParams - Path-segment values.
+     */
+    post: <T = unknown>(path: string, options?: RequestOptions & {
+        body?: unknown;
+        queryParams?: Record<string, unknown>;
+        pathParams?: Record<string, string>;
+    }) => Promise<T>;
+    getAppRoot: <T = unknown>(path: string, options?: RequestOptions & {
+        acceptRedirect?: boolean;
+        authenticated?: boolean;
+        redirect?: RequestRedirect;
+        queryParams?: Record<string, unknown>;
+        pathParams?: Record<string, string>;
+    }) => Promise<T>;
+    postAppRoot: <T = unknown>(path: string, options?: RequestOptions & {
+        authenticated?: boolean;
+        body?: unknown;
+        queryParams?: Record<string, unknown>;
+        pathParams?: Record<string, string>;
+    }) => Promise<T>;
+    /**
+     * Issue a JSON POST request for endpoints that intentionally return no
+     * response body even on 2xx success.
+     */
+    postNoContent: (path: string, options?: RequestOptions & {
+        body?: unknown;
+        queryParams?: Record<string, unknown>;
+        pathParams?: Record<string, string>;
+    }) => Promise<void>;
+    /** Issue a PUT request (full-replace semantics). See {@link post} for parameters. */
+    put: <T = unknown>(path: string, options?: RequestOptions & {
+        body?: unknown;
+        queryParams?: Record<string, unknown>;
+        pathParams?: Record<string, string>;
+    }) => Promise<T>;
+    /** Issue a PATCH request (partial-update semantics). See {@link post} for parameters. */
+    patch: <T = unknown>(path: string, options?: RequestOptions & {
+        body?: unknown;
+        queryParams?: Record<string, unknown>;
+        pathParams?: Record<string, string>;
+    }) => Promise<T>;
+    /**
+     * Issue a DELETE request. An optional `body` is accepted for DRF endpoints
+     * that require one, though `openapi-fetch` only sends it when the OpenAPI
+     * spec declares it.
+     */
+    delete: <T = unknown>(path: string, options?: RequestOptions & {
+        body?: unknown;
+        queryParams?: Record<string, unknown>;
+        pathParams?: Record<string, string>;
+    }) => Promise<T>;
+    /**
+     * GET an endpoint that returns plain text (e.g. JUnit XML, logs).
+     *
+     * Bypasses the openapi-fetch JSON parser. Errors still flow through the
+     * shared status→error mapping.
+     *
+     * @returns The response body as a string.
+     */
+    getText: (path: string, options?: RequestOptions & {
+        queryParams?: Record<string, unknown>;
+        pathParams?: Record<string, string>;
+    }) => Promise<string>;
+    /**
+     * GET an endpoint returning binary bytes (ZIP / octet-stream).
+     *
+     * @returns The response body as `Uint8Array`.
+     */
+    getBinary: (path: string, options?: RequestOptions & {
+        queryParams?: Record<string, unknown>;
+        pathParams?: Record<string, string>;
+    }) => Promise<Uint8Array>;
+    /**
+     * POST raw bytes or text with an explicit `Content-Type`.
+     *
+     * Used for binary (ZIP) and YAML uploads that don't fit the openapi-fetch
+     * JSON path. The response is parsed as JSON when possible, otherwise the
+     * raw text is returned.
+     *
+     * @param path - API path template.
+     * @param body - Raw bytes or string to send as the request body.
+     * @param options.contentType - MIME type sent in the `Content-Type` header.
+     * @returns Parsed JSON body or raw text.
+     */
+    postRaw: <T = unknown>(path: string, body: Uint8Array | string, options: RequestOptions & {
+        contentType: string;
+        queryParams?: Record<string, unknown>;
+        pathParams?: Record<string, string>;
+    }) => Promise<T>;
+    /**
+     * POST a `multipart/form-data` body. The browser/fetch sets the
+     * `Content-Type` boundary automatically.
+     *
+     * @param path - API path template.
+     * @param form - The `FormData` instance to send.
+     * @returns Parsed JSON body or raw text.
+     */
+    postForm: <T = unknown>(path: string, form: FormData, options?: RequestOptions & {
+        queryParams?: Record<string, unknown>;
+        pathParams?: Record<string, string>;
+        useAppRoot?: boolean;
+    }) => Promise<T>;
+    /**
+     * Return a frozen snapshot of the resolved configuration (defaults applied).
+     */
+    getConfig: () => Readonly<Required<BugBugConfig>>;
+    /**
+     * Patch configuration at runtime. Re-builds the openapi-fetch client when
+     * `apiToken` or `apiUrl` changes, and rebuilds the rate limiter when
+     * `rateLimit` changes — other fields take effect on the next request.
+     *
+     * @param updates - Partial configuration overrides to merge in.
+     */
+    updateConfig: (updates: Partial<BugBugConfig>) => void;
+    /**
+     * Snapshot of the in-process rate-limiter state.
+     *
+     * @returns `{ requestsInWindow, remainingRequests, maxRequests, windowMs, resetTime, canMakeRequest }`.
+     */
+    getRateLimitStatus: () => {
+        requestsInWindow: number;
+        maxRequests: number;
+        remainingRequests: number;
+        windowMs: number;
+        resetTime: number | null;
+        canMakeRequest: boolean;
+    };
+}
+//# sourceMappingURL=apiClient.d.ts.map

package/dist/services/apiClient/apiClient.d.ts.map

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

package/dist/services/apiClient/apiClient.types.d.ts

@@ -0,0 +1,19 @@
+import type { paths } from '@bugbug-io/api-schema';
+import type createClient from 'openapi-fetch';
+/**
+ * OpenAPI client type
+ */
+export type ApiClient = ReturnType<typeof createClient<paths>>;
+/**
+ * OpenAPI request options type
+ */
+export type OpenApiRequestOptions = {
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+    params?: {
+        path?: Record<string, string>;
+        query?: Record<string, unknown>;
+    };
+    body?: unknown;
+};
+//# sourceMappingURL=apiClient.types.d.ts.map

package/dist/services/apiClient/apiClient.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiClient.types.d.ts","sourceRoot":"","sources":["../../../src/services/apiClient/apiClient.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,YAAY,MAAM,eAAe,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IACF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC"}

package/dist/services/apiClient/apiClient.utils.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Best-effort human message from a parsed error body. Returns an empty string
+ * when nothing useful can be extracted so per-status fallbacks in
+ * `handleOpenApiError` (e.g. "Resource not found") take precedence.
+ */
+export declare function formatApiErrorMessage(error: unknown): string;
+export declare function formatNetworkErrorMessage(error: TypeError): string;
+export declare function formatUnexpectedResponseMessage(error: Error, method: string, url: string): string;
+/**
+ * Coerce an error body to an object so it can be walked for field errors.
+ * Strings produced by the raw text/binary paths may be JSON; try to parse.
+ */
+export declare function parseErrorBody(error: unknown): unknown;
+/**
+ * Extract a DRF-style field-error map from an error body.
+ *
+ * DRF returns shapes like:
+ *   { field_name: ["This field is required."] }
+ *   { non_field_errors: ["..."] }
+ *   { nested: { sub_field: ["..."] } }
+ *
+ * This walks the structure (skipping the well-known `detail`/`message`/`error`
+ * keys handled by `formatApiErrorValue`) and produces flat dot-paths mapping
+ * to string arrays so MCP clients can react per-field.
+ */
+export declare function extractFieldErrors(body: unknown): Record<string, string[]> | undefined;
+/**
+ * Parse a response body as JSON, falling back to the raw text when it is not
+ * valid JSON. An empty body resolves to `undefined`.
+ */
+export declare function parseJsonOrText<T>(text: string): T;
+//# sourceMappingURL=apiClient.utils.d.ts.map

package/dist/services/apiClient/apiClient.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiClient.utils.d.ts","sourceRoot":"","sources":["../../../src/services/apiClient/apiClient.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG5D;AAaD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAMlE;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjG;AAwBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAStD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,CAgCtF;AA+BD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAOlD"}

package/dist/services/rateLimiter/rateLimiter.constants.d.ts

@@ -0,0 +1,5 @@
+export declare const RATE_LIMIT_MIN_REQUESTS = 1;
+export declare const RATE_LIMIT_MAX_REQUESTS = 100;
+export declare const RATE_LIMIT_MIN_WINDOW_MS = 1000;
+export declare const RATE_LIMIT_MAX_WINDOW_MS = 60000;
+//# sourceMappingURL=rateLimiter.constants.d.ts.map

package/dist/services/rateLimiter/rateLimiter.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimiter.constants.d.ts","sourceRoot":"","sources":["../../../src/services/rateLimiter/rateLimiter.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,wBAAwB,QAAS,CAAC"}

package/dist/services/rateLimiter/rateLimiter.d.ts

@@ -0,0 +1,49 @@
+import type { RateLimitConfig } from './rateLimiter.types';
+/**
+ * Token-bucket-ish rate limiter with exponential backoff.
+ *
+ * Used internally by `BugBugApiClient`. Integrators rarely instantiate this
+ * directly; instead pass {@link RateLimitConfig} via `BugBugConfig.rateLimit`.
+ */
+export declare class RateLimiter {
+    #private;
+    constructor(config: RateLimitConfig);
+    /**
+     * Execute a function with rate limiting and exponential backoff.
+     *
+     * The retry loop fires when:
+     * 1. The **client-side** gate trips (`canMakeRequest()` returns false) — `fn`
+     *    was never called.
+     * 2. The function throws `RateLimitError` (typically a server 429) AND
+     *    `retryServer429` is enabled. Retrying server 429s on non-idempotent
+     *    requests (POST startRun, POST startRun) can produce duplicate
+     *    resources — set `retryServer429: false` to disable.
+     *
+     * @param fn - The function to execute under rate limiting.
+     * @returns The function's resolved value.
+     * @throws {RateLimitError} When retries are exhausted or `retryServer429` is
+     *   disabled and the server returned 429.
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Snapshot of the current rate-limiter state.
+     *
+     * @returns `requestsInWindow`, `remainingRequests`, `canMakeRequest`,
+     *   `resetTime` (epoch ms when the oldest tracked request leaves the
+     *   window — `null` when no requests are tracked).
+     */
+    getStatus(): {
+        requestsInWindow: number;
+        maxRequests: number;
+        remainingRequests: number;
+        windowMs: number;
+        resetTime: number | null;
+        canMakeRequest: boolean;
+    };
+    /**
+     * Discard all tracked request timestamps. Useful in tests or after a clock
+     * jump. Not normally called in production.
+     */
+    reset(): void;
+}
+//# sourceMappingURL=rateLimiter.d.ts.map

package/dist/services/rateLimiter/rateLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimiter.d.ts","sourceRoot":"","sources":["../../../src/services/rateLimiter/rateLimiter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAW3D;;;;;GAKG;AACH,qBAAa,WAAW;;gBAIV,MAAM,EAAE,eAAe;IA+BnC;;;;;;;;;;;;;;;OAeG;IACG,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA8HlD;;;;;;OAMG;IACH,SAAS;;;;;;;;IAcT;;;OAGG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/services/rateLimiter/rateLimiter.types.d.ts

@@ -0,0 +1,34 @@
+export interface RateLimitConfig {
+    /** Maximum number of requests allowed inside one rolling window. */
+    maxRequests: number;
+    /** Rolling window size in milliseconds. */
+    windowMs: number;
+    /**
+     * Suggested wait time (ms) when the client-side gate trips. Used as the
+     * `retryAfter` on synthetic `RateLimitError` instances. Default: `1000`.
+     */
+    retryAfter?: number;
+    /**
+     * Whether to automatically retry server-side 429 responses with exponential
+     * backoff.
+     * Defaults to `true`.
+     *
+     * **WARNING:** When `true`, a 429 returned mid-POST is retried transparently.
+     * For non-idempotent calls - `tests.startRun`, `suites.startRun`,
+     * `tests.create`, etc. - this can produce **duplicate resources** if the
+     * server already accepted the first request before returning 429. Set to
+     * `false` for production integrations that mutate data; the caller can then
+     * implement an idempotent retry strategy.
+     */
+    retryServer429?: boolean;
+    /** Exponential backoff parameters applied when retrying rate-limited requests. */
+    exponentialBackoff: {
+        /** Starting delay in milliseconds. */
+        baseDelay: number;
+        /** Maximum delay in milliseconds. */
+        maxDelay: number;
+        /** Maximum retry attempts before giving up. */
+        maxRetries: number;
+    };
+}
+//# sourceMappingURL=rateLimiter.types.d.ts.map

package/dist/services/rateLimiter/rateLimiter.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimiter.types.d.ts","sourceRoot":"","sources":["../../../src/services/rateLimiter/rateLimiter.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IAEpB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,kFAAkF;IAClF,kBAAkB,EAAE;QAClB,sCAAsC;QACtC,SAAS,EAAE,MAAM,CAAC;QAClB,qCAAqC;QACrC,QAAQ,EAAE,MAAM,CAAC;QACjB,+CAA+C;QAC/C,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH"}

package/dist/testUtils/fakeFactory.d.ts

@@ -0,0 +1,15 @@
+import type { BugBugConfig } from '../types/config';
+import type { CreatedVariable, Profile, Project, Variable } from '@bugbug-io/api-schema';
+type Override<T> = Partial<T>;
+export declare const createFakeSdk: (overrides?: Partial<BugBugConfig>) => import("../sdk").BugBugSDK;
+export declare const createFakeCursorPage: <T>(results: T[], nextToken?: string | null, count?: number) => {
+    count: number | undefined;
+    nextToken: string | null;
+    results: T[];
+};
+export declare const createFakeProfile: (overrides?: Override<Profile>) => Profile;
+export declare const createFakeProject: (overrides?: Override<Project>) => Project;
+export declare const createFakeVariable: (overrides?: Override<Variable>) => Variable;
+export declare const createFakeCreatedVariable: (overrides?: Override<CreatedVariable>) => CreatedVariable;
+export {};
+//# sourceMappingURL=fakeFactory.d.ts.map

package/dist/testUtils/fakeFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fakeFactory.d.ts","sourceRoot":"","sources":["../../src/testUtils/fakeFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAIzF,KAAK,QAAQ,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;AAE9B,eAAO,MAAM,aAAa,GAAI,YAAW,OAAO,CAAC,YAAY,CAAM,+BAChB,CAAC;AAEpD,eAAO,MAAM,oBAAoB,GAAI,CAAC,EACpC,SAAS,CAAC,EAAE,EACZ,YAAW,MAAM,GAAG,IAAW,EAC/B,QAAQ,MAAM;;;;CAKd,CAAC;AAEH,eAAO,MAAM,iBAAiB,GAAI,YAAW,QAAQ,CAAC,OAAO,CAAM,KAAG,OAKpE,CAAC;AAEH,eAAO,MAAM,iBAAiB,GAAI,YAAW,QAAQ,CAAC,OAAO,CAAM,KAAG,OAOpE,CAAC;AAEH,eAAO,MAAM,kBAAkB,GAAI,YAAW,QAAQ,CAAC,QAAQ,CAAM,KAAG,QAMtE,CAAC;AAEH,eAAO,MAAM,yBAAyB,GACpC,YAAW,QAAQ,CAAC,eAAe,CAAM,KACxC,eAID,CAAC"}

package/dist/testUtils/setup.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/testUtils/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/testUtils/setup.ts"],"names":[],"mappings":""}

package/dist/types/config.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Public configuration types for the BugBug SDK.
+ */
+import type { RateLimitConfig } from '../services/rateLimiter/rateLimiter.types';
+import type { TriggeredBy } from '@bugbug-io/api-schema';
+export interface BugBugConfig {
+    /**
+     * API token used for all requests. When omitted, the SDK resolves it
+     * from `bugbug.yaml`, `.env`, or `BUGBUG_API_TOKEN` (in that order). Throws
+     * a `ConfigurationError` at construction time if no token can be found.
+     */
+    apiToken?: string;
+    /**
+     * Origin marker recorded on runs started via this SDK instance. Defaults to
+     * `'api'`. Set once at SDK construction; individual `tests.startRun`/`suites.startRun`
+     * calls do not override this.
+     *
+     * @internal
+     */
+    triggeredBy?: TriggeredBy;
+    /**
+     * Full API base URL — the SDK does **not** auto-append `/api/v2`. Defaults
+     * to `https://app.bugbug.io/api/v2` when omitted. Use the exported
+     * `normalizeApiBaseUrl` helper if you only have a host-only value (e.g.
+     * from `BUGBUG_API_URL`).
+     *
+     * @internal
+     */
+    apiUrl?: string;
+    /**
+     * Active project id for organization/user tokens, threaded into project-scoped
+     * requests. When omitted, the SDK resolves it from `BUGBUG_PROJECT_ID`,
+     * `bugbug.yaml`, or the persisted current project. Project tokens ignore this —
+     * their project is implied by the token. Use {@link BugBugSDK.setProject} to
+     * change it at runtime.
+     */
+    projectId?: string;
+    /** Enable detailed request/response debug logging. Default: `false`. */
+    verbose?: boolean;
+    /** Lower bound on emitted log severity. Default: `'info'`. */
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    /** Per-request timeout in milliseconds. Default: `30_000` (30s). */
+    timeout?: number;
+    /** Client-side rate limiting and retry-on-429 behavior. See {@link RateLimitConfig}. */
+    rateLimit?: RateLimitConfig;
+    /**
+     * Extra HTTP headers added to every request.
+     * Caller-supplied `Authorization` is still ignored: the SDK's token
+     * always wins.
+     */
+    requestHeaders?: Record<string, string>;
+    /** Hook invoked just before a request is dispatched. */
+    onBeforeRequest?: RequestHook;
+    /** Hook invoked after a successful (non-error) response. */
+    onAfterRequest?: RequestHook;
+    /** Hook invoked after a request errored. Receives the parsed `Response` and the underlying `Error`. */
+    onRequestError?: RequestErrorHook;
+}
+/**
+ * Callback receiving the request data envelope. Used by `onBeforeRequest`
+ * and `onAfterRequest`. Receives a snapshot of the resolved request (method,
+ * path, body, params, signal, timeout, headers).
+ */
+export type RequestHook = (requestData: RequestData) => void;
+/**
+ * Callback receiving the request envelope, the underlying `Response`, and
+ * the originating `Error`. Used by `onRequestError`.
+ */
+export type RequestErrorHook = (requestData: RequestData, response: Response, error: Error) => void;
+/**
+ * Common options shared by polling/wait helpers like
+ * `tests.watchRunProgress` and `suites.watchRunProgress`.
+ *
+ * @typeParam T - The polled resource type (e.g. `TestRunState`, `SuiteRunState`).
+ */
+export interface WaitOptions<T = unknown> {
+    /** Poll interval in milliseconds. Default: `2_000`. */
+    pollInterval?: number;
+    /**
+     * Total wait timeout in milliseconds. When omitted, each wait helper
+     * applies its own resource-appropriate default (5 minutes for tests,
+     * 10 minutes for suites).
+     */
+    timeout?: number;
+    /** Callback invoked on every successful poll with the latest snapshot. */
+    onProgress?: (data: T) => void | Promise<void>;
+}
+export type RequestData = {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    path: string;
+    body?: unknown;
+    params?: {
+        path?: Record<string, string>;
+        query?: Record<string, unknown>;
+    };
+    signal?: RequestOptions['signal'];
+    timeout?: RequestOptions['timeout'];
+    headers?: RequestOptions['headers'];
+};
+export interface RequestOptions {
+    /** Abort signal for client-side cancellation. Throws `CancellationError`. */
+    signal?: AbortSignal;
+    /**
+     * Per-request timeout in milliseconds. Overrides `BugBugConfig.timeout` for
+     * this call only.
+     */
+    timeout?: number;
+    /**
+     * Per-request HTTP headers. These are merged *first* so the SDK's auth and
+     * `User-Agent` headers always win — supplying `Authorization` here will
+     * have no effect.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Whether the SDK should add the configured `projectId` to this request.
+     *
+     * @internal
+     */
+    projectScoped?: boolean;
+}
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAE/C,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,wFAAwF;IACxF,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC,wDAAwD;IACxD,eAAe,CAAC,EAAE,WAAW,CAAC;IAC9B,4DAA4D;IAC5D,cAAc,CAAC,EAAE,WAAW,CAAC;IAC7B,uGAAuG;IACvG,cAAc,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC;AAE7D;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAEpG;;;;;GAKG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC5E,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}