@apollo-deploy/typescript-sdk 1.0.0

package/dist/src/transport/axios.js.map

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

package/dist/src/types/common.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @generated
+ * This file was automatically generated by sdk-forge.
+ * DO NOT MODIFY THIS FILE DIRECTLY.
+ */
+/**
+ * Pagination query parameters shared across all list endpoints.
+ */
+export interface PaginationQuery {
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Number of items per page */
+    limit?: number;
+    /** Column name to sort by */
+    sortBy?: string;
+    /** Sort direction */
+    sortOrder?: 'asc' | 'desc';
+}
+/**
+ * Page metadata returned by paginated endpoints.
+ */
+export interface PageMeta {
+    /** Number of items in this page */
+    size: number;
+    /** Total number of pages available */
+    totalPages: number;
+    /** Whether more pages exist after the current one */
+    hasMore: boolean;
+}
+/**
+ * Generic paginated response wrapper.
+ *
+ * All list endpoints return data in this shape: an array of items
+ * plus a `page` object with pagination metadata.
+ *
+ * @template T - The type of items in the data array
+ */
+export interface Page<T> {
+    data: T[];
+    page: PageMeta;
+}
+/**
+ * Generic success response returned by mutation endpoints.
+ */
+export interface SuccessResponse {
+    success: boolean;
+    message?: string;
+}
+/**
+ * Message-only response returned by various endpoints.
+ */
+export interface MessageResponse {
+    message: string;
+}
+/**
+ * Raw error response envelope returned by the API.
+ *
+ * This interface represents the raw JSON shape of error responses.
+ * It is used internally by the SDK to construct `SDKError` instances.
+ */
+export interface ApiErrorEnvelope {
+    /** Machine-readable error code */
+    error: string;
+    /** Human-readable error message */
+    message: string;
+    /** HTTP status code */
+    status: number;
+    /** Unique request identifier for debugging */
+    request_id?: string;
+    /** ISO 8601 timestamp of error occurrence */
+    timestamp?: string;
+    /** Request path */
+    path?: string;
+    /** HTTP method */
+    method?: string;
+    /** Helpful hint for resolving the error */
+    hint?: string;
+    /** Source file location (development only) */
+    file?: string;
+    /** Function name (development only) */
+    function?: string;
+    /** Structured error details (4xx only) */
+    details?: unknown;
+    /** Stack trace (development only, 5xx errors only) */
+    stack?: string;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/src/types/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/types/common.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,IAAI,EAAE,QAAQ,CAAC;CAChB;AAID;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAID;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/src/types/common.js

@@ -0,0 +1,7 @@
+/**
+ * @generated
+ * This file was automatically generated by sdk-forge.
+ * DO NOT MODIFY THIS FILE DIRECTLY.
+ */
+export {};
+//# sourceMappingURL=common.js.map

package/dist/src/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/types/common.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/src/types/errors.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @generated
+ * This file was automatically generated by sdk-forge.
+ * DO NOT MODIFY THIS FILE DIRECTLY.
+ */
+import type { ApiErrorEnvelope } from './common.js';
+/**
+ * Structured error thrown by all SDK operations.
+ *
+ * Extends the native Error class to provide structured error information
+ * from API responses. This error is thrown by the SDK when API calls fail.
+ *
+ * Error codes returned by the server:
+ * - `rate_limit_exceeded` - Too many requests (429)
+ * - `unauthorized` - Invalid or missing authentication (401)
+ * - `forbidden` - Insufficient permissions (403)
+ * - `not_found` - Resource doesn't exist (404)
+ * - `conflict` - Resource conflict (409)
+ * - `unprocessable_entity` - Invalid request data (422)
+ * - `bad_request` - Malformed request (400)
+ * - `service_unavailable` - Service temporarily down (503)
+ * - `gateway_timeout` - Request timeout (504)
+ * - `internal_server_error` - Unexpected server error (500)
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const result = await client.someApi.get('id');
+ * } catch (error) {
+ *   if (error instanceof SDKError) {
+ *     console.error(`API Error: ${error.message}`);
+ *     console.error(`Status: ${error.status}`);
+ *     console.error(`Error Code: ${error.code}`);
+ *     console.error(`Request ID: ${error.requestId}`);
+ *
+ *     if (error.isRateLimited()) {
+ *       console.log('Rate limited, retry after delay');
+ *     }
+ *
+ *     if (error.hint) {
+ *       console.log(`Hint: ${error.hint}`);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class SDKError extends Error {
+    /** Machine-readable error code (e.g., 'not_found', 'bad_request', 'rate_limit_exceeded') */
+    readonly code: string;
+    /** HTTP status code of the response (0 for network errors) */
+    readonly status: number;
+    /** Unique request identifier for tracking */
+    readonly requestId?: string;
+    /** ISO 8601 timestamp of error occurrence */
+    readonly timestamp?: string;
+    /** Request path */
+    readonly path?: string;
+    /** HTTP method */
+    readonly method?: string;
+    /** Helpful hint for resolving the error */
+    readonly hint?: string;
+    /** Source file location where error occurred (development only) */
+    readonly file?: string;
+    /** Function name where error occurred (development only) */
+    readonly function?: string;
+    /** Structured error details (4xx only, omitted for 5xx in production) */
+    readonly details?: unknown;
+    /** Stack trace from server (development only, 5xx errors only) */
+    readonly serverStack?: string;
+    /**
+     * Creates a new SDKError instance.
+     *
+     * @param message - Human-readable error message
+     * @param status - HTTP status code (0 for network errors)
+     * @param code - Machine-readable error code
+     * @param requestId - Server-provided request ID
+     */
+    constructor(message: string, status: number, code: string, requestId?: string);
+    /**
+     * Creates a new SDKError instance from an API error envelope.
+     *
+     * @param envelope - The error envelope from the API response
+     * @param status - HTTP status code
+     */
+    constructor(envelope: ApiErrorEnvelope, status: number);
+    /** Check if this is a rate limit error */
+    isRateLimited(): boolean;
+    /** Check if this is an authentication error */
+    isAuthError(): boolean;
+    /** Check if this is a permission error */
+    isForbidden(): boolean;
+    /** Check if this is a not found error */
+    isNotFound(): boolean;
+    /** Check if this is a validation error */
+    isValidationError(): boolean;
+    /** Check if this is a server error (5xx) */
+    isServerError(): boolean;
+    /** Check if this is a client error (4xx) */
+    isClientError(): boolean;
+    /** Check if this error is retryable */
+    isRetryable(): boolean;
+    /** Convert to a plain object for logging/serialization */
+    toJSON(): Record<string, unknown>;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,qBAAa,QAAS,SAAQ,KAAK;IACjC,4FAA4F;IAC5F,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,8DAA8D;IAC9D,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,6CAA6C;IAC7C,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnC,6CAA6C;IAC7C,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnC,mBAAmB;IACnB,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAE9B,kBAAkB;IAClB,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhC,2CAA2C;IAC3C,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAE9B,mEAAmE;IACnE,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAE9B,4DAA4D;IAC5D,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElC,yEAAyE;IACzE,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElC,kEAAkE;IAClE,SAAgB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErC;;;;;;;OAOG;gBACS,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAC7E;;;;;OAKG;gBACS,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM;IAkCtD,0CAA0C;IAC1C,aAAa,IAAI,OAAO;IAIxB,+CAA+C;IAC/C,WAAW,IAAI,OAAO;IAItB,0CAA0C;IAC1C,WAAW,IAAI,OAAO;IAItB,yCAAyC;IACzC,UAAU,IAAI,OAAO;IAIrB,0CAA0C;IAC1C,iBAAiB,IAAI,OAAO;IAI5B,4CAA4C;IAC5C,aAAa,IAAI,OAAO;IAIxB,4CAA4C;IAC5C,aAAa,IAAI,OAAO;IAIxB,uCAAuC;IACvC,WAAW,IAAI,OAAO;IAItB,0DAA0D;IAC1D,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAiBlC"}

package/dist/src/types/errors.js

@@ -0,0 +1,148 @@
+/**
+ * @generated
+ * This file was automatically generated by sdk-forge.
+ * DO NOT MODIFY THIS FILE DIRECTLY.
+ */
+/**
+ * Structured error thrown by all SDK operations.
+ *
+ * Extends the native Error class to provide structured error information
+ * from API responses. This error is thrown by the SDK when API calls fail.
+ *
+ * Error codes returned by the server:
+ * - `rate_limit_exceeded` - Too many requests (429)
+ * - `unauthorized` - Invalid or missing authentication (401)
+ * - `forbidden` - Insufficient permissions (403)
+ * - `not_found` - Resource doesn't exist (404)
+ * - `conflict` - Resource conflict (409)
+ * - `unprocessable_entity` - Invalid request data (422)
+ * - `bad_request` - Malformed request (400)
+ * - `service_unavailable` - Service temporarily down (503)
+ * - `gateway_timeout` - Request timeout (504)
+ * - `internal_server_error` - Unexpected server error (500)
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const result = await client.someApi.get('id');
+ * } catch (error) {
+ *   if (error instanceof SDKError) {
+ *     console.error(`API Error: ${error.message}`);
+ *     console.error(`Status: ${error.status}`);
+ *     console.error(`Error Code: ${error.code}`);
+ *     console.error(`Request ID: ${error.requestId}`);
+ *
+ *     if (error.isRateLimited()) {
+ *       console.log('Rate limited, retry after delay');
+ *     }
+ *
+ *     if (error.hint) {
+ *       console.log(`Hint: ${error.hint}`);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+export class SDKError extends Error {
+    /** Machine-readable error code (e.g., 'not_found', 'bad_request', 'rate_limit_exceeded') */
+    code;
+    /** HTTP status code of the response (0 for network errors) */
+    status;
+    /** Unique request identifier for tracking */
+    requestId;
+    /** ISO 8601 timestamp of error occurrence */
+    timestamp;
+    /** Request path */
+    path;
+    /** HTTP method */
+    method;
+    /** Helpful hint for resolving the error */
+    hint;
+    /** Source file location where error occurred (development only) */
+    file;
+    /** Function name where error occurred (development only) */
+    function;
+    /** Structured error details (4xx only, omitted for 5xx in production) */
+    details;
+    /** Stack trace from server (development only, 5xx errors only) */
+    serverStack;
+    constructor(messageOrEnvelope, status, code, requestId) {
+        if (typeof messageOrEnvelope === 'string') {
+            super(messageOrEnvelope);
+            this.code = code ?? 'unknown_error';
+            this.status = status;
+            this.requestId = requestId;
+        }
+        else {
+            const envelope = messageOrEnvelope;
+            super(envelope.message);
+            this.code = envelope.error;
+            this.status = status;
+            this.requestId = envelope.request_id;
+            this.timestamp = envelope.timestamp;
+            this.path = envelope.path;
+            this.method = envelope.method;
+            this.hint = envelope.hint;
+            this.file = envelope.file;
+            this.function = envelope.function;
+            this.details = envelope.details;
+            this.serverStack = envelope.stack;
+        }
+        this.name = 'SDKError';
+        if ('captureStackTrace' in Error) {
+            Error.captureStackTrace(this, SDKError);
+        }
+    }
+    /** Check if this is a rate limit error */
+    isRateLimited() {
+        return this.code === 'rate_limit_exceeded';
+    }
+    /** Check if this is an authentication error */
+    isAuthError() {
+        return this.code === 'unauthorized' || this.code === 'credential_expired' || this.code === 'credential_revoked';
+    }
+    /** Check if this is a permission error */
+    isForbidden() {
+        return this.code === 'forbidden';
+    }
+    /** Check if this is a not found error */
+    isNotFound() {
+        return this.code === 'not_found';
+    }
+    /** Check if this is a validation error */
+    isValidationError() {
+        return this.code === 'validation_failed' || this.code === 'request_validation_failed' || this.code === 'bad_request' || this.code === 'unprocessable_entity';
+    }
+    /** Check if this is a server error (5xx) */
+    isServerError() {
+        return this.status >= 500;
+    }
+    /** Check if this is a client error (4xx) */
+    isClientError() {
+        return this.status >= 400 && this.status < 500;
+    }
+    /** Check if this error is retryable */
+    isRetryable() {
+        return this.status === 429 || this.status >= 500;
+    }
+    /** Convert to a plain object for logging/serialization */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            status: this.status,
+            code: this.code,
+            requestId: this.requestId,
+            timestamp: this.timestamp,
+            path: this.path,
+            method: this.method,
+            hint: this.hint,
+            file: this.file,
+            function: this.function,
+            details: this.details,
+            serverStack: this.serverStack,
+        };
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/types/errors.js.map

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