@harkenapp/sdk-react-native 0.0.1-alpha.1

package/README.md

@@ -0,0 +1,67 @@
+# Harken React Native SDK
+
+React Native / Expo SDK for submitting in-app feedback.
+
+## Installation
+
+```bash
+npx expo install @harkenapp/sdk-react-native
+```
+
+## Permissions
+
+The SDK requires camera and photo library permissions to support attachment features. The SDK includes an Expo config plugin that automatically configures these permissions.
+
+### Automatic Configuration (Recommended)
+
+Add the SDK to your `app.json` or `app.config.js` plugins:
+
+```json
+{
+  "expo": {
+    "plugins": [
+      "@harkenapp/sdk-react-native"
+    ]
+  }
+}
+```
+
+This automatically configures:
+
+**iOS (Info.plist):**
+- `NSCameraUsageDescription` - Camera access for taking photos
+- `NSPhotoLibraryUsageDescription` - Photo library access for selecting images
+
+> **Note:** `NSDocumentsFolderUsageDescription` is not required. The SDK uses `expo-document-picker` which presents the system document picker UI, handling file access permissions automatically without needing an Info.plist entry.
+
+**Android (AndroidManifest.xml):**
+- `android.permission.CAMERA` - Camera access
+- `android.permission.READ_MEDIA_IMAGES` - Photo library access (Android 13+)
+- `android.permission.READ_EXTERNAL_STORAGE` - Photo library access (Android 12 and below)
+
+### Custom Permission Strings
+
+You can customize the iOS permission dialog strings:
+
+```json
+{
+  "expo": {
+    "plugins": [
+      ["@harkenapp/sdk-react-native", {
+        "cameraPermission": "Take photos to include with your feedback",
+        "photoLibraryPermission": "Select photos to include with your feedback"
+      }]
+    ]
+  }
+}
+```
+
+### After Configuration
+
+Run prebuild to apply the permissions:
+
+```bash
+npx expo prebuild
+```
+
+Or if using EAS Build, permissions are applied automatically during the build process.

package/app.plugin.cjs

@@ -0,0 +1,135 @@
+/**
+ * Expo config plugin for @harkenapp/sdk-react-native
+ *
+ * Automatically configures iOS and Android permissions required for
+ * camera, photo library, and document picker functionality.
+ *
+ * @example
+ * // app.json or app.config.js
+ * {
+ *   "expo": {
+ *     "plugins": [
+ *       "@harkenapp/sdk-react-native"
+ *     ]
+ *   }
+ * }
+ *
+ * @example
+ * // With custom permission strings
+ * {
+ *   "expo": {
+ *     "plugins": [
+ *       ["@harkenapp/sdk-react-native", {
+ *         "cameraPermission": "Take photos to include with your feedback",
+ *         "photoLibraryPermission": "Select photos to include with your feedback"
+ *       }]
+ *     ]
+ *   }
+ * }
+ */
+
+const {
+  withInfoPlist,
+  withAndroidManifest,
+} = require('@expo/config-plugins');
+
+/**
+ * Default permission strings for iOS
+ */
+const DEFAULT_PERMISSIONS = {
+  cameraPermission: 'Allow $(PRODUCT_NAME) to access your camera to take photos for feedback',
+  photoLibraryPermission: 'Allow $(PRODUCT_NAME) to access your photos to include with feedback',
+};
+
+/**
+ * Configure iOS Info.plist permissions
+ */
+function withIosPermissions(config, options) {
+  return withInfoPlist(config, (config) => {
+    // Camera permission
+    // Custom option overrides existing; default only sets if missing
+    if (options.cameraPermission) {
+      config.modResults.NSCameraUsageDescription = options.cameraPermission;
+    } else if (!config.modResults.NSCameraUsageDescription) {
+      config.modResults.NSCameraUsageDescription = DEFAULT_PERMISSIONS.cameraPermission;
+    }
+
+    // Photo library permission
+    // Custom option overrides existing; default only sets if missing
+    if (options.photoLibraryPermission) {
+      config.modResults.NSPhotoLibraryUsageDescription = options.photoLibraryPermission;
+    } else if (!config.modResults.NSPhotoLibraryUsageDescription) {
+      config.modResults.NSPhotoLibraryUsageDescription = DEFAULT_PERMISSIONS.photoLibraryPermission;
+    }
+
+    return config;
+  });
+}
+
+/**
+ * Configure Android AndroidManifest.xml permissions
+ */
+function withAndroidPermissions(config) {
+  return withAndroidManifest(config, (config) => {
+    const manifest = config.modResults.manifest;
+
+    // Ensure uses-permission array exists
+    if (!manifest['uses-permission']) {
+      manifest['uses-permission'] = [];
+    }
+
+    const permissions = manifest['uses-permission'];
+
+    /**
+     * Add a permission if it doesn't already exist
+     */
+    function addPermission(name, attributes = {}) {
+      const exists = permissions.some(
+        (p) => p.$?.['android:name'] === name
+      );
+      if (!exists) {
+        permissions.push({
+          $: {
+            'android:name': name,
+            ...attributes,
+          },
+        });
+      }
+    }
+
+    // Camera permission
+    addPermission('android.permission.CAMERA');
+
+    // Photo library permissions
+    // READ_MEDIA_IMAGES for Android 13+ (API 33+)
+    addPermission('android.permission.READ_MEDIA_IMAGES');
+
+    // READ_EXTERNAL_STORAGE for Android 12 and below
+    // Use maxSdkVersion to limit to older APIs
+    addPermission('android.permission.READ_EXTERNAL_STORAGE', {
+      'android:maxSdkVersion': '32',
+    });
+
+    return config;
+  });
+}
+
+/**
+ * Main plugin function
+ *
+ * @param {import('@expo/config-plugins').ExpoConfig} config - Expo config
+ * @param {Object} options - Plugin options
+ * @param {string} [options.cameraPermission] - Custom iOS camera permission string
+ * @param {string} [options.photoLibraryPermission] - Custom iOS photo library permission string
+ */
+function withHarkenPermissions(config, options = {}) {
+  // Apply iOS permissions
+  config = withIosPermissions(config, options);
+
+  // Apply Android permissions
+  config = withAndroidPermissions(config);
+
+  return config;
+}
+
+module.exports = withHarkenPermissions;

package/app.plugin.js

@@ -0,0 +1 @@
+module.exports = require("./app.plugin.cjs");

package/dist/api/client.d.ts

@@ -0,0 +1,67 @@
+import type { components } from '../types/index.js';
+import type { RetryConfig } from './retry';
+type FeedbackSubmission = components['schemas']['FeedbackSubmission'];
+type FeedbackSubmissionResponse = components['schemas']['FeedbackSubmissionResponse'];
+type AttachmentPresignRequest = components['schemas']['AttachmentPresignRequest'];
+type AttachmentPresignResponse = components['schemas']['AttachmentPresignResponse'];
+type AttachmentConfirmRequest = components['schemas']['AttachmentConfirmRequest'];
+type AttachmentStatusResponse = components['schemas']['AttachmentStatusResponse'];
+export interface HarkenClientConfig {
+    /** Publishable API key */
+    publishableKey: string;
+    /** Optional user token for verified identity */
+    userToken?: string;
+    /** Base URL for API (defaults to production) */
+    baseUrl?: string;
+    /** Retry configuration */
+    retry?: Partial<RetryConfig>;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+}
+/**
+ * Low-level API client for Harken.
+ */
+export declare class HarkenClient {
+    private readonly config;
+    constructor(config: HarkenClientConfig);
+    /**
+     * Submit feedback to the API.
+     */
+    submitFeedback(submission: FeedbackSubmission): Promise<FeedbackSubmissionResponse>;
+    /**
+     * Create a presigned URL for attachment upload.
+     */
+    createAttachmentUpload(request: AttachmentPresignRequest): Promise<AttachmentPresignResponse>;
+    /**
+     * Confirm successful attachment upload.
+     */
+    confirmAttachment(attachmentId: string, request?: AttachmentConfirmRequest): Promise<AttachmentStatusResponse>;
+    /**
+     * Report attachment upload failure.
+     * This is a terminal state, so no retry is applied.
+     */
+    reportAttachmentFailure(attachmentId: string, error?: string): Promise<AttachmentStatusResponse>;
+    /**
+     * Get attachment status and download URLs.
+     */
+    getAttachmentStatus(attachmentId: string): Promise<AttachmentStatusResponse>;
+    /**
+     * Make an authenticated request to the API.
+     */
+    private request;
+    /**
+     * Parse error response body, with fallback for non-JSON responses.
+     */
+    private parseErrorResponse;
+    /**
+     * Parse Retry-After header value in seconds.
+     * Supports both delta-seconds and HTTP-date formats.
+     */
+    private parseRetryAfter;
+}
+/**
+ * Create a configured Harken client.
+ */
+export declare function createHarkenClient(config: HarkenClientConfig): HarkenClient;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3C,KAAK,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,CAAC;AACtE,KAAK,0BAA0B,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,4BAA4B,CAAC,CAAC;AAItF,KAAK,wBAAwB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,0BAA0B,CAAC,CAAC;AAClF,KAAK,yBAAyB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,2BAA2B,CAAC,CAAC;AACpF,KAAK,wBAAwB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,0BAA0B,CAAC,CAAC;AAClF,KAAK,wBAAwB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,0BAA0B,CAAC,CAAC;AAIlF,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAG2B;gBAEtC,MAAM,EAAE,kBAAkB;IAUtC;;OAEG;IACG,cAAc,CAClB,UAAU,EAAE,kBAAkB,GAC7B,OAAO,CAAC,0BAA0B,CAAC;IAUtC;;OAEG;IACG,sBAAsB,CAC1B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,yBAAyB,CAAC;IAcrC;;OAEG;IACG,iBAAiB,CACrB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,wBAAwB,CAAC;IAcpC;;;OAGG;IACG,uBAAuB,CAC3B,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,wBAAwB,CAAC;IAUpC;;OAEG;IACG,mBAAmB,CACvB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,wBAAwB,CAAC;IAMpC;;OAEG;YACW,OAAO;IAiErB;;OAEG;YACW,kBAAkB;IAchC;;;OAGG;IACH,OAAO,CAAC,eAAe;CAqBxB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAE3E"}

package/dist/api/client.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HarkenClient = void 0;
+exports.createHarkenClient = createHarkenClient;
+const errors_1 = require("./errors");
+const retry_1 = require("./retry");
+const DEFAULT_API_BASE_URL = 'https://api.harken.app';
+/**
+ * Low-level API client for Harken.
+ */
+class HarkenClient {
+    config;
+    constructor(config) {
+        this.config = {
+            publishableKey: config.publishableKey,
+            userToken: config.userToken,
+            baseUrl: config.baseUrl ?? DEFAULT_API_BASE_URL,
+            retry: config.retry,
+            timeout: config.timeout ?? 30000,
+        };
+    }
+    /**
+     * Submit feedback to the API.
+     */
+    async submitFeedback(submission) {
+        return (0, retry_1.withRetry)(() => this.request('/v1/feedback', {
+            method: 'POST',
+            body: JSON.stringify(submission),
+        }), this.config.retry);
+    }
+    /**
+     * Create a presigned URL for attachment upload.
+     */
+    async createAttachmentUpload(request) {
+        return (0, retry_1.withRetry)(() => this.request('/v1/feedback/attachments/presign', {
+            method: 'POST',
+            body: JSON.stringify(request),
+        }), this.config.retry);
+    }
+    /**
+     * Confirm successful attachment upload.
+     */
+    async confirmAttachment(attachmentId, request) {
+        return (0, retry_1.withRetry)(() => this.request(`/v1/feedback/attachments/${attachmentId}/confirm`, {
+            method: 'POST',
+            body: request ? JSON.stringify(request) : undefined,
+        }), this.config.retry);
+    }
+    /**
+     * Report attachment upload failure.
+     * This is a terminal state, so no retry is applied.
+     */
+    async reportAttachmentFailure(attachmentId, error) {
+        return this.request(`/v1/feedback/attachments/${attachmentId}/fail`, {
+            method: 'POST',
+            body: error ? JSON.stringify({ error }) : undefined,
+        });
+    }
+    /**
+     * Get attachment status and download URLs.
+     */
+    async getAttachmentStatus(attachmentId) {
+        return this.request(`/v1/feedback/attachments/${attachmentId}`);
+    }
+    /**
+     * Make an authenticated request to the API.
+     */
+    async request(path, options = {}) {
+        const url = `${this.config.baseUrl}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            'X-Publishable-Key': this.config.publishableKey,
+            ...options.headers,
+        };
+        if (this.config.userToken) {
+            headers['X-User-Token'] = this.config.userToken;
+        }
+        // Create abort controller for timeout
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        try {
+            const response = await fetch(url, {
+                ...options,
+                headers,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const errorBody = await this.parseErrorResponse(response);
+                // Only parse Retry-After for 429 responses
+                const retryAfter = response.status === 429
+                    ? this.parseRetryAfter(response)
+                    : undefined;
+                throw new errors_1.HarkenApiError(response.status, errorBody, { retryAfter });
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            // Re-throw HarkenApiError as-is
+            if (error instanceof errors_1.HarkenApiError) {
+                throw error;
+            }
+            // Handle abort (timeout)
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new errors_1.HarkenNetworkError('Request timed out', error);
+            }
+            // Handle other fetch errors (network issues)
+            if (error instanceof TypeError) {
+                throw new errors_1.HarkenNetworkError('Network request failed', error);
+            }
+            // Unknown error
+            throw new errors_1.HarkenNetworkError(error instanceof Error ? error.message : 'Unknown error', error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Parse error response body, with fallback for non-JSON responses.
+     */
+    async parseErrorResponse(response) {
+        try {
+            return (await response.json());
+        }
+        catch {
+            // Fallback for non-JSON error responses
+            return {
+                error: {
+                    code: `http_${response.status}`,
+                    message: response.statusText || 'Request failed',
+                },
+            };
+        }
+    }
+    /**
+     * Parse Retry-After header value in seconds.
+     * Supports both delta-seconds and HTTP-date formats.
+     */
+    parseRetryAfter(response) {
+        const retryAfter = response.headers.get('Retry-After');
+        if (!retryAfter) {
+            return undefined;
+        }
+        // Try parsing as integer (delta-seconds)
+        const seconds = parseInt(retryAfter, 10);
+        if (!isNaN(seconds) && seconds >= 0) {
+            return seconds;
+        }
+        // Try parsing as HTTP-date
+        const date = Date.parse(retryAfter);
+        if (!isNaN(date)) {
+            const delayMs = date - Date.now();
+            return delayMs > 0 ? Math.ceil(delayMs / 1000) : 0;
+        }
+        return undefined;
+    }
+}
+exports.HarkenClient = HarkenClient;
+/**
+ * Create a configured Harken client.
+ */
+function createHarkenClient(config) {
+    return new HarkenClient(config);
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/api/errors.d.ts

@@ -0,0 +1,46 @@
+import type { components } from '../types/index.js';
+type ErrorResponse = components['schemas']['ErrorResponse'];
+type ErrorDetail = components['schemas']['ErrorDetail'];
+/**
+ * Base error class for Harken API errors.
+ */
+export declare class HarkenError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when the API returns an error response.
+ */
+export declare class HarkenApiError extends HarkenError {
+    /** HTTP status code */
+    readonly status: number;
+    /** Machine-readable error code */
+    readonly code: string;
+    /** Validation error details (if present) */
+    readonly details?: ErrorDetail[];
+    /** Retry-After value in seconds (from 429 responses) */
+    readonly retryAfter?: number;
+    constructor(status: number, response: ErrorResponse, options?: {
+        retryAfter?: number;
+    });
+    /** True if this is a validation error (400) */
+    get isValidationError(): boolean;
+    /** True if this is an auth error (401) */
+    get isUnauthorized(): boolean;
+    /** True if this is a rate limit error (429) */
+    get isRateLimited(): boolean;
+    /** True if this is a server error (5xx) */
+    get isServerError(): boolean;
+    /** True if this error is retryable */
+    get isRetryable(): boolean;
+}
+/**
+ * Error thrown when a network request fails.
+ */
+export declare class HarkenNetworkError extends HarkenError {
+    readonly cause?: Error;
+    constructor(message: string, cause?: Error);
+    /** Network errors are always retryable */
+    get isRetryable(): boolean;
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/api/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/api/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,KAAK,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC,CAAC;AAC5D,KAAK,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC;AAExD;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,uBAAuB;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACjC,wDAAwD;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAG3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAUnC,+CAA+C;IAC/C,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED,0CAA0C;IAC1C,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,+CAA+C;IAC/C,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,2CAA2C;IAC3C,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,sCAAsC;IACtC,IAAI,WAAW,IAAI,OAAO,CAEzB;CACF;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;IAM1C,0CAA0C;IAC1C,IAAI,WAAW,IAAI,OAAO,CAEzB;CACF"}

package/dist/api/errors.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HarkenNetworkError = exports.HarkenApiError = exports.HarkenError = void 0;
+/**
+ * Base error class for Harken API errors.
+ */
+class HarkenError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'HarkenError';
+    }
+}
+exports.HarkenError = HarkenError;
+/**
+ * Error thrown when the API returns an error response.
+ */
+class HarkenApiError extends HarkenError {
+    /** HTTP status code */
+    status;
+    /** Machine-readable error code */
+    code;
+    /** Validation error details (if present) */
+    details;
+    /** Retry-After value in seconds (from 429 responses) */
+    retryAfter;
+    constructor(status, response, options) {
+        super(response.error.message);
+        this.name = 'HarkenApiError';
+        this.status = status;
+        this.code = response.error.code;
+        this.details = response.error.details;
+        this.retryAfter = options?.retryAfter;
+    }
+    /** True if this is a validation error (400) */
+    get isValidationError() {
+        return this.status === 400;
+    }
+    /** True if this is an auth error (401) */
+    get isUnauthorized() {
+        return this.status === 401;
+    }
+    /** True if this is a rate limit error (429) */
+    get isRateLimited() {
+        return this.status === 429;
+    }
+    /** True if this is a server error (5xx) */
+    get isServerError() {
+        return this.status >= 500;
+    }
+    /** True if this error is retryable */
+    get isRetryable() {
+        return this.isRateLimited || this.isServerError;
+    }
+}
+exports.HarkenApiError = HarkenApiError;
+/**
+ * Error thrown when a network request fails.
+ */
+class HarkenNetworkError extends HarkenError {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.name = 'HarkenNetworkError';
+        this.cause = cause;
+    }
+    /** Network errors are always retryable */
+    get isRetryable() {
+        return true;
+    }
+}
+exports.HarkenNetworkError = HarkenNetworkError;
+//# sourceMappingURL=errors.js.map

package/dist/api/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/api/errors.ts"],"names":[],"mappings":";;;AAKA;;GAEG;AACH,MAAa,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AALD,kCAKC;AAED;;GAEG;AACH,MAAa,cAAe,SAAQ,WAAW;IAC7C,uBAAuB;IACd,MAAM,CAAS;IACxB,kCAAkC;IACzB,IAAI,CAAS;IACtB,4CAA4C;IACnC,OAAO,CAAiB;IACjC,wDAAwD;IAC/C,UAAU,CAAU;IAE7B,YACE,MAAc,EACd,QAAuB,EACvB,OAAiC;QAEjC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;IACxC,CAAC;IAED,+CAA+C;IAC/C,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC;IAC7B,CAAC;IAED,0CAA0C;IAC1C,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC;IAC7B,CAAC;IAED,+CAA+C;IAC/C,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC;IAC7B,CAAC;IAED,2CAA2C;IAC3C,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC;IAC5B,CAAC;IAED,sCAAsC;IACtC,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,CAAC;IAClD,CAAC;CACF;AA/CD,wCA+CC;AAED;;GAEG;AACH,MAAa,kBAAmB,SAAQ,WAAW;IACxC,KAAK,CAAS;IAEvB,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,0CAA0C;IAC1C,IAAI,WAAW;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAbD,gDAaC"}

package/dist/api/index.d.ts

@@ -0,0 +1,7 @@
+export { HarkenClient, createHarkenClient } from './client';
+export type { HarkenClientConfig } from './client';
+export { HarkenError, HarkenApiError, HarkenNetworkError, } from './errors';
+export { withRetry, calculateRetryDelay, isRetryableError } from './retry';
+export type { RetryConfig } from './retry';
+export { DEFAULT_RETRY_CONFIG } from './retry';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGnD,OAAO,EACL,WAAW,EACX,cAAc,EACd,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3E,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RETRY_CONFIG = exports.isRetryableError = exports.calculateRetryDelay = exports.withRetry = exports.HarkenNetworkError = exports.HarkenApiError = exports.HarkenError = exports.createHarkenClient = exports.HarkenClient = void 0;
+// Client
+var client_1 = require("./client");
+Object.defineProperty(exports, "HarkenClient", { enumerable: true, get: function () { return client_1.HarkenClient; } });
+Object.defineProperty(exports, "createHarkenClient", { enumerable: true, get: function () { return client_1.createHarkenClient; } });
+// Errors
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "HarkenError", { enumerable: true, get: function () { return errors_1.HarkenError; } });
+Object.defineProperty(exports, "HarkenApiError", { enumerable: true, get: function () { return errors_1.HarkenApiError; } });
+Object.defineProperty(exports, "HarkenNetworkError", { enumerable: true, get: function () { return errors_1.HarkenNetworkError; } });
+// Retry utilities
+var retry_1 = require("./retry");
+Object.defineProperty(exports, "withRetry", { enumerable: true, get: function () { return retry_1.withRetry; } });
+Object.defineProperty(exports, "calculateRetryDelay", { enumerable: true, get: function () { return retry_1.calculateRetryDelay; } });
+Object.defineProperty(exports, "isRetryableError", { enumerable: true, get: function () { return retry_1.isRetryableError; } });
+var retry_2 = require("./retry");
+Object.defineProperty(exports, "DEFAULT_RETRY_CONFIG", { enumerable: true, get: function () { return retry_2.DEFAULT_RETRY_CONFIG; } });
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";;;AAAA,SAAS;AACT,mCAA4D;AAAnD,sGAAA,YAAY,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAGzC,SAAS;AACT,mCAIkB;AAHhB,qGAAA,WAAW,OAAA;AACX,wGAAA,cAAc,OAAA;AACd,4GAAA,kBAAkB,OAAA;AAGpB,kBAAkB;AAClB,iCAA2E;AAAlE,kGAAA,SAAS,OAAA;AAAE,4GAAA,mBAAmB,OAAA;AAAE,yGAAA,gBAAgB,OAAA;AAEzD,iCAA+C;AAAtC,6GAAA,oBAAoB,OAAA"}

package/dist/api/retry.d.ts

@@ -0,0 +1,29 @@
+import { HarkenApiError, HarkenNetworkError } from './errors';
+export interface RetryConfig {
+    /** Maximum number of retry attempts (default: 3) */
+    maxRetries: number;
+    /** Base delay in ms for exponential backoff (default: 1000) */
+    baseDelay: number;
+    /** Maximum delay in ms (default: 30000) */
+    maxDelay: number;
+    /** Jitter factor 0-1 to randomize delays (default: 0.1) */
+    jitter: number;
+}
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/**
+ * Calculate delay for a retry attempt with exponential backoff and jitter.
+ */
+export declare function calculateRetryDelay(attempt: number, config: RetryConfig, retryAfter?: number): number;
+/**
+ * Check if an error is retryable.
+ */
+export declare function isRetryableError(error: unknown): error is HarkenApiError | HarkenNetworkError;
+/**
+ * Sleep for a given number of milliseconds.
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Execute a function with retry logic.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, config?: Partial<RetryConfig>): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/api/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/api/retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,oBAAoB,EAAE,WAKlC,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,cAAc,GAAG,kBAAkB,CAQ9C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAChC,OAAO,CAAC,CAAC,CAAC,CA0BZ"}