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

package/dist/hooks/useHarkenContext.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useHarkenContext = useHarkenContext;
+const react_1 = require("react");
+const context_1 = require("../context");
+/**
+ * Hook to access the full Harken context.
+ *
+ * Provides access to theme, config, and SDK state.
+ * Must be used within a HarkenProvider.
+ *
+ * @returns The full HarkenContextValue
+ * @throws Error if used outside of HarkenProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { theme, isDarkMode, config } = useHarkenContext();
+ *
+ *   return (
+ *     <View>
+ *       <Text>Dark mode: {isDarkMode ? 'on' : 'off'}</Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+function useHarkenContext() {
+    const context = (0, react_1.useContext)(context_1.HarkenContext);
+    if (!context) {
+        throw new Error('useHarkenContext must be used within a HarkenProvider');
+    }
+    return context;
+}
+//# sourceMappingURL=useHarkenContext.js.map

package/dist/hooks/useHarkenContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHarkenContext.js","sourceRoot":"","sources":["../../src/hooks/useHarkenContext.ts"],"names":[],"mappings":";;AA0BA,4CAQC;AAlCD,iCAAmC;AACnC,wCAA2C;AAG3C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,gBAAgB;IAC9B,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC,uBAAa,CAAC,CAAC;IAE1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/hooks/useHarkenTheme.d.ts

@@ -0,0 +1,26 @@
+import type { HarkenTheme } from '../theme';
+/**
+ * Hook to access the current Harken theme.
+ *
+ * Must be used within a HarkenProvider.
+ *
+ * @returns The resolved HarkenTheme object
+ * @throws Error if used outside of HarkenProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const theme = useHarkenTheme();
+ *
+ *   return (
+ *     <View style={{ backgroundColor: theme.colors.background }}>
+ *       <Text style={{ color: theme.colors.text }}>
+ *         Hello
+ *       </Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export declare function useHarkenTheme(): HarkenTheme;
+//# sourceMappingURL=useHarkenTheme.d.ts.map

package/dist/hooks/useHarkenTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHarkenTheme.d.ts","sourceRoot":"","sources":["../../src/hooks/useHarkenTheme.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAQ5C"}

package/dist/hooks/useHarkenTheme.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useHarkenTheme = useHarkenTheme;
+const react_1 = require("react");
+const context_1 = require("../context");
+/**
+ * Hook to access the current Harken theme.
+ *
+ * Must be used within a HarkenProvider.
+ *
+ * @returns The resolved HarkenTheme object
+ * @throws Error if used outside of HarkenProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const theme = useHarkenTheme();
+ *
+ *   return (
+ *     <View style={{ backgroundColor: theme.colors.background }}>
+ *       <Text style={{ color: theme.colors.text }}>
+ *         Hello
+ *       </Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+function useHarkenTheme() {
+    const context = (0, react_1.useContext)(context_1.HarkenContext);
+    if (!context) {
+        throw new Error('useHarkenTheme must be used within a HarkenProvider');
+    }
+    return context.theme;
+}
+//# sourceMappingURL=useHarkenTheme.js.map

package/dist/hooks/useHarkenTheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHarkenTheme.js","sourceRoot":"","sources":["../../src/hooks/useHarkenTheme.ts"],"names":[],"mappings":";;AA2BA,wCAQC;AAnCD,iCAAmC;AACnC,wCAA2C;AAG3C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,cAAc;IAC5B,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC,uBAAa,CAAC,CAAC;IAE1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,OAAO,CAAC,KAAK,CAAC;AACvB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Harken React Native SDK
+ *
+ * A mobile-first feedback SDK for React Native and Expo applications.
+ *
+ * @example
+ * ```tsx
+ * import { HarkenProvider, FeedbackSheet } from '@harkenapp/sdk-react-native';
+ *
+ * function App() {
+ *   return (
+ *     <HarkenProvider config={{ publishableKey: 'pk_live_xxxx' }}>
+ *       <FeedbackSheet onSuccess={() => console.log('Submitted!')} />
+ *     </HarkenProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { HarkenProvider } from './context';
+export type { HarkenContextValue } from './context';
+export { useHarkenTheme, useHarkenContext, useAnonymousId, useFeedback, } from './hooks';
+export type { SubmitFeedbackParams, UseFeedbackResult } from './hooks';
+export { useAttachmentUpload } from './hooks/useAttachmentUpload';
+export type { AttachmentState, UseAttachmentUploadResult, } from './hooks/useAttachmentUpload';
+export { useAttachmentPicker } from './hooks/useAttachmentPicker';
+export type { AttachmentSourceConfig, UseAttachmentPickerResult, } from './hooks/useAttachmentPicker';
+export { useAttachmentStatus } from './hooks/useAttachmentStatus';
+export type { AttachmentStatus } from './hooks/useAttachmentStatus';
+export type { HarkenColors, HarkenTypography, HarkenSpacing, HarkenRadii, HarkenTheme, PartialHarkenTheme, TextWeight, ThemeMode, } from './theme';
+export { lightColors, darkColors, defaultTypography, defaultSpacing, defaultRadii, lightTheme, darkTheme, createTheme, } from './theme';
+export type { SecureStorage } from './storage';
+export { createSecureStoreAdapter, createMemoryStorage, IdentityStore, } from './storage';
+export { generateUUID } from './utils';
+export { ThemedText, ThemedTextInput, ThemedButton, CategorySelector, FeedbackForm, DEFAULT_CATEGORIES, } from './components';
+export type { ThemedTextProps, TextVariant, ThemedTextInputProps, ThemedButtonProps, ButtonVariant, CategorySelectorProps, CategoryOption, FeedbackFormProps, FeedbackFormData, } from './components';
+export { AttachmentPicker, UploadStatusOverlay, AttachmentPreview, AttachmentGrid, } from './components';
+export type { AttachmentPickerProps, AttachmentSource, PickerOptionConfig, UploadStatusOverlayProps, UploadStatusLabels, AttachmentPreviewProps, AttachmentGridProps, } from './components';
+export { FeedbackSheet } from './attachments/FeedbackSheet';
+export type { FeedbackSheetProps } from './attachments/FeedbackSheet';
+export { HarkenClient, createHarkenClient, HarkenError, HarkenApiError, HarkenNetworkError, withRetry, DEFAULT_RETRY_CONFIG, } from './api';
+export type { HarkenClientConfig, RetryConfig } from './api';
+export type { HarkenConfig, HarkenProviderProps, FeedbackCategory, Platform, DeviceMetadata, } from './types';
+export { UploadPhase, DEFAULT_UPLOAD_RETRY_CONFIG } from './domain';
+export type { QueueItem, QueueStatus, UploadProgress, UploadRetryConfig, } from './domain';
+export { UploadQueueService, uploadQueueService, UploadQueueStorage, } from './services';
+export type { UploadQueueServiceConfig, EnqueueParams, } from './services';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGpD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,YAAY,EACV,eAAe,EACf,yBAAyB,GAC1B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,YAAY,EACV,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,SAAS,GACV,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,GACZ,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,aAAa,GACd,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,OAAO,EACL,UAAU,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGtE,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,oBAAoB,GACrB,MAAM,OAAO,CAAC;AACf,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAG7D,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,QAAQ,EACR,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,WAAW,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AACpE,YAAY,EACV,SAAS,EACT,WAAW,EACX,cAAc,EACd,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,wBAAwB,EACxB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Harken React Native SDK
+ *
+ * A mobile-first feedback SDK for React Native and Expo applications.
+ *
+ * @example
+ * ```tsx
+ * import { HarkenProvider, FeedbackSheet } from '@harkenapp/sdk-react-native';
+ *
+ * function App() {
+ *   return (
+ *     <HarkenProvider config={{ publishableKey: 'pk_live_xxxx' }}>
+ *       <FeedbackSheet onSuccess={() => console.log('Submitted!')} />
+ *     </HarkenProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UploadQueueStorage = exports.uploadQueueService = exports.UploadQueueService = exports.DEFAULT_UPLOAD_RETRY_CONFIG = exports.UploadPhase = exports.DEFAULT_RETRY_CONFIG = exports.withRetry = exports.HarkenNetworkError = exports.HarkenApiError = exports.HarkenError = exports.createHarkenClient = exports.HarkenClient = exports.FeedbackSheet = exports.AttachmentGrid = exports.AttachmentPreview = exports.UploadStatusOverlay = exports.AttachmentPicker = exports.DEFAULT_CATEGORIES = exports.FeedbackForm = exports.CategorySelector = exports.ThemedButton = exports.ThemedTextInput = exports.ThemedText = exports.generateUUID = exports.IdentityStore = exports.createMemoryStorage = exports.createSecureStoreAdapter = exports.createTheme = exports.darkTheme = exports.lightTheme = exports.defaultRadii = exports.defaultSpacing = exports.defaultTypography = exports.darkColors = exports.lightColors = exports.useAttachmentStatus = exports.useAttachmentPicker = exports.useAttachmentUpload = exports.useFeedback = exports.useAnonymousId = exports.useHarkenContext = exports.useHarkenTheme = exports.HarkenProvider = void 0;
+// Provider and context
+var context_1 = require("./context");
+Object.defineProperty(exports, "HarkenProvider", { enumerable: true, get: function () { return context_1.HarkenProvider; } });
+// Hooks (core)
+var hooks_1 = require("./hooks");
+Object.defineProperty(exports, "useHarkenTheme", { enumerable: true, get: function () { return hooks_1.useHarkenTheme; } });
+Object.defineProperty(exports, "useHarkenContext", { enumerable: true, get: function () { return hooks_1.useHarkenContext; } });
+Object.defineProperty(exports, "useAnonymousId", { enumerable: true, get: function () { return hooks_1.useAnonymousId; } });
+Object.defineProperty(exports, "useFeedback", { enumerable: true, get: function () { return hooks_1.useFeedback; } });
+// Hooks (attachments)
+var useAttachmentUpload_1 = require("./hooks/useAttachmentUpload");
+Object.defineProperty(exports, "useAttachmentUpload", { enumerable: true, get: function () { return useAttachmentUpload_1.useAttachmentUpload; } });
+var useAttachmentPicker_1 = require("./hooks/useAttachmentPicker");
+Object.defineProperty(exports, "useAttachmentPicker", { enumerable: true, get: function () { return useAttachmentPicker_1.useAttachmentPicker; } });
+var useAttachmentStatus_1 = require("./hooks/useAttachmentStatus");
+Object.defineProperty(exports, "useAttachmentStatus", { enumerable: true, get: function () { return useAttachmentStatus_1.useAttachmentStatus; } });
+var theme_1 = require("./theme");
+Object.defineProperty(exports, "lightColors", { enumerable: true, get: function () { return theme_1.lightColors; } });
+Object.defineProperty(exports, "darkColors", { enumerable: true, get: function () { return theme_1.darkColors; } });
+Object.defineProperty(exports, "defaultTypography", { enumerable: true, get: function () { return theme_1.defaultTypography; } });
+Object.defineProperty(exports, "defaultSpacing", { enumerable: true, get: function () { return theme_1.defaultSpacing; } });
+Object.defineProperty(exports, "defaultRadii", { enumerable: true, get: function () { return theme_1.defaultRadii; } });
+Object.defineProperty(exports, "lightTheme", { enumerable: true, get: function () { return theme_1.lightTheme; } });
+Object.defineProperty(exports, "darkTheme", { enumerable: true, get: function () { return theme_1.darkTheme; } });
+Object.defineProperty(exports, "createTheme", { enumerable: true, get: function () { return theme_1.createTheme; } });
+var storage_1 = require("./storage");
+Object.defineProperty(exports, "createSecureStoreAdapter", { enumerable: true, get: function () { return storage_1.createSecureStoreAdapter; } });
+Object.defineProperty(exports, "createMemoryStorage", { enumerable: true, get: function () { return storage_1.createMemoryStorage; } });
+Object.defineProperty(exports, "IdentityStore", { enumerable: true, get: function () { return storage_1.IdentityStore; } });
+// Utilities
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "generateUUID", { enumerable: true, get: function () { return utils_1.generateUUID; } });
+// Components (core)
+var components_1 = require("./components");
+Object.defineProperty(exports, "ThemedText", { enumerable: true, get: function () { return components_1.ThemedText; } });
+Object.defineProperty(exports, "ThemedTextInput", { enumerable: true, get: function () { return components_1.ThemedTextInput; } });
+Object.defineProperty(exports, "ThemedButton", { enumerable: true, get: function () { return components_1.ThemedButton; } });
+Object.defineProperty(exports, "CategorySelector", { enumerable: true, get: function () { return components_1.CategorySelector; } });
+Object.defineProperty(exports, "FeedbackForm", { enumerable: true, get: function () { return components_1.FeedbackForm; } });
+Object.defineProperty(exports, "DEFAULT_CATEGORIES", { enumerable: true, get: function () { return components_1.DEFAULT_CATEGORIES; } });
+// Components (attachments)
+var components_2 = require("./components");
+Object.defineProperty(exports, "AttachmentPicker", { enumerable: true, get: function () { return components_2.AttachmentPicker; } });
+Object.defineProperty(exports, "UploadStatusOverlay", { enumerable: true, get: function () { return components_2.UploadStatusOverlay; } });
+Object.defineProperty(exports, "AttachmentPreview", { enumerable: true, get: function () { return components_2.AttachmentPreview; } });
+Object.defineProperty(exports, "AttachmentGrid", { enumerable: true, get: function () { return components_2.AttachmentGrid; } });
+// FeedbackSheet (with full attachment support)
+var FeedbackSheet_1 = require("./attachments/FeedbackSheet");
+Object.defineProperty(exports, "FeedbackSheet", { enumerable: true, get: function () { return FeedbackSheet_1.FeedbackSheet; } });
+// API client
+var api_1 = require("./api");
+Object.defineProperty(exports, "HarkenClient", { enumerable: true, get: function () { return api_1.HarkenClient; } });
+Object.defineProperty(exports, "createHarkenClient", { enumerable: true, get: function () { return api_1.createHarkenClient; } });
+Object.defineProperty(exports, "HarkenError", { enumerable: true, get: function () { return api_1.HarkenError; } });
+Object.defineProperty(exports, "HarkenApiError", { enumerable: true, get: function () { return api_1.HarkenApiError; } });
+Object.defineProperty(exports, "HarkenNetworkError", { enumerable: true, get: function () { return api_1.HarkenNetworkError; } });
+Object.defineProperty(exports, "withRetry", { enumerable: true, get: function () { return api_1.withRetry; } });
+Object.defineProperty(exports, "DEFAULT_RETRY_CONFIG", { enumerable: true, get: function () { return api_1.DEFAULT_RETRY_CONFIG; } });
+// Domain types
+var domain_1 = require("./domain");
+Object.defineProperty(exports, "UploadPhase", { enumerable: true, get: function () { return domain_1.UploadPhase; } });
+Object.defineProperty(exports, "DEFAULT_UPLOAD_RETRY_CONFIG", { enumerable: true, get: function () { return domain_1.DEFAULT_UPLOAD_RETRY_CONFIG; } });
+// Services (for advanced usage)
+var services_1 = require("./services");
+Object.defineProperty(exports, "UploadQueueService", { enumerable: true, get: function () { return services_1.UploadQueueService; } });
+Object.defineProperty(exports, "uploadQueueService", { enumerable: true, get: function () { return services_1.uploadQueueService; } });
+Object.defineProperty(exports, "UploadQueueStorage", { enumerable: true, get: function () { return services_1.UploadQueueStorage; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAEH,uBAAuB;AACvB,qCAA2C;AAAlC,yGAAA,cAAc,OAAA;AAGvB,eAAe;AACf,iCAKiB;AAJf,uGAAA,cAAc,OAAA;AACd,yGAAA,gBAAgB,OAAA;AAChB,uGAAA,cAAc,OAAA;AACd,oGAAA,WAAW,OAAA;AAIb,sBAAsB;AACtB,mEAAkE;AAAzD,0HAAA,mBAAmB,OAAA;AAM5B,mEAAkE;AAAzD,0HAAA,mBAAmB,OAAA;AAM5B,mEAAkE;AAAzD,0HAAA,mBAAmB,OAAA;AAe5B,iCASiB;AARf,oGAAA,WAAW,OAAA;AACX,mGAAA,UAAU,OAAA;AACV,0GAAA,iBAAiB,OAAA;AACjB,uGAAA,cAAc,OAAA;AACd,qGAAA,YAAY,OAAA;AACZ,mGAAA,UAAU,OAAA;AACV,kGAAA,SAAS,OAAA;AACT,oGAAA,WAAW,OAAA;AAKb,qCAImB;AAHjB,mHAAA,wBAAwB,OAAA;AACxB,8GAAA,mBAAmB,OAAA;AACnB,wGAAA,aAAa,OAAA;AAGf,YAAY;AACZ,iCAAuC;AAA9B,qGAAA,YAAY,OAAA;AAErB,oBAAoB;AACpB,2CAOsB;AANpB,wGAAA,UAAU,OAAA;AACV,6GAAA,eAAe,OAAA;AACf,0GAAA,YAAY,OAAA;AACZ,8GAAA,gBAAgB,OAAA;AAChB,0GAAA,YAAY,OAAA;AACZ,gHAAA,kBAAkB,OAAA;AAepB,2BAA2B;AAC3B,2CAKsB;AAJpB,8GAAA,gBAAgB,OAAA;AAChB,iHAAA,mBAAmB,OAAA;AACnB,+GAAA,iBAAiB,OAAA;AACjB,4GAAA,cAAc,OAAA;AAahB,+CAA+C;AAC/C,6DAA4D;AAAnD,8GAAA,aAAa,OAAA;AAGtB,aAAa;AACb,6BAQe;AAPb,mGAAA,YAAY,OAAA;AACZ,yGAAA,kBAAkB,OAAA;AAClB,kGAAA,WAAW,OAAA;AACX,qGAAA,cAAc,OAAA;AACd,yGAAA,kBAAkB,OAAA;AAClB,gGAAA,SAAS,OAAA;AACT,2GAAA,oBAAoB,OAAA;AAatB,eAAe;AACf,mCAAoE;AAA3D,qGAAA,WAAW,OAAA;AAAE,qHAAA,2BAA2B,OAAA;AAQjD,gCAAgC;AAChC,uCAIoB;AAHlB,8GAAA,kBAAkB,OAAA;AAClB,8GAAA,kBAAkB,OAAA;AAClB,8GAAA,kBAAkB,OAAA"}

package/dist/services/index.d.ts

@@ -0,0 +1,4 @@
+export { UploadQueueService, uploadQueueService, } from './uploadQueueService';
+export type { UploadQueueServiceConfig, EnqueueParams, } from './uploadQueueService';
+export { UploadQueueStorage } from './uploadQueueStorage';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,wBAAwB,EACxB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UploadQueueStorage = exports.uploadQueueService = exports.UploadQueueService = void 0;
+var uploadQueueService_1 = require("./uploadQueueService");
+Object.defineProperty(exports, "UploadQueueService", { enumerable: true, get: function () { return uploadQueueService_1.UploadQueueService; } });
+Object.defineProperty(exports, "uploadQueueService", { enumerable: true, get: function () { return uploadQueueService_1.uploadQueueService; } });
+var uploadQueueStorage_1 = require("./uploadQueueStorage");
+Object.defineProperty(exports, "UploadQueueStorage", { enumerable: true, get: function () { return uploadQueueStorage_1.UploadQueueStorage; } });
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;AAAA,2DAG8B;AAF5B,wHAAA,kBAAkB,OAAA;AAClB,wHAAA,kBAAkB,OAAA;AAQpB,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA"}

package/dist/services/uploadQueueService.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Upload Queue Service
+ *
+ * Singleton service that manages background attachment uploads.
+ * Uses expo-file-system/legacy for background upload support.
+ *
+ * Key design decisions (from feature spec):
+ * - D1: Uses expo-file-system/legacy with BACKGROUND session type
+ * - D2: Initialized once at app startup in HarkenProvider
+ * - D3: Persists queue to AsyncStorage
+ * - D4: Exponential backoff (2s base, 60s max, 3 attempts, 1s jitter)
+ * - D5: Auto-pause when offline via NetInfo
+ * - D6: Real progress tracking from expo-file-system
+ */
+import { HarkenClient } from '../api/client';
+import { QueueItem, QueueStatus, UploadProgress, UploadRetryConfig } from '../domain';
+type ProgressCallback = (progress: UploadProgress) => void;
+type CompleteCallback = (attachmentId: string) => void;
+type ErrorCallback = (attachmentId: string, error: string) => void;
+/**
+ * Configuration for initializing the upload queue service.
+ */
+export interface UploadQueueServiceConfig {
+    /** Configured HarkenClient instance */
+    client: HarkenClient;
+    /** Override retry configuration */
+    retryConfig?: Partial<UploadRetryConfig>;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Parameters for enqueuing a new upload.
+ */
+export interface EnqueueParams {
+    /** Local file URI (file://) */
+    localUri: string;
+    /** MIME type (e.g., 'image/png') */
+    mimeType: string;
+    /** Original filename */
+    fileName: string;
+    /** File size in bytes */
+    fileSize: number;
+}
+/**
+ * Singleton service for managing background attachment uploads.
+ */
+export declare class UploadQueueService {
+    private static instance;
+    private client;
+    private retryConfig;
+    private storage;
+    private debug;
+    private items;
+    private isProcessing;
+    private isPaused;
+    private isInitialized;
+    private activeTasks;
+    private progressListeners;
+    private completeListeners;
+    private errorListeners;
+    private networkUnsubscribe;
+    private retryTimerId;
+    private constructor();
+    /**
+     * Get the singleton instance.
+     */
+    static getInstance(): UploadQueueService;
+    /**
+     * Initialize the queue service.
+     *
+     * Must be called once at app startup (in HarkenProvider).
+     * This prevents the race condition where uploads complete
+     * before callbacks are registered.
+     *
+     * Supports hot reload by updating the client reference on subsequent calls.
+     */
+    initialize(config: UploadQueueServiceConfig): Promise<void>;
+    /**
+     * Check if the service is initialized.
+     */
+    get initialized(): boolean;
+    /**
+     * Enqueue a new attachment for upload.
+     *
+     * This method:
+     * 1. Requests a presigned URL from the server
+     * 2. Creates a queue item
+     * 3. Persists the queue
+     * 4. Triggers queue processing
+     *
+     * Returns immediately with the attachment ID (upload happens in background).
+     */
+    enqueue(params: EnqueueParams): Promise<{
+        attachmentId: string;
+        queueItemId: string;
+    }>;
+    /**
+     * Process the upload queue.
+     *
+     * Processes items sequentially (one at a time) to avoid memory pressure
+     * on low-end devices.
+     */
+    processQueue(): Promise<void>;
+    /**
+     * Process a single queue item.
+     */
+    private processItem;
+    /**
+     * Upload file using expo-file-system background upload.
+     *
+     * Uses FileSystemSessionType.BACKGROUND for true background uploads
+     * that continue even when the app is backgrounded.
+     */
+    private uploadFile;
+    /**
+     * Handle permanent item failure (max retries exceeded).
+     */
+    private handleItemFailure;
+    /**
+     * Calculate retry delay with exponential backoff and jitter (D4).
+     */
+    private calculateRetryDelay;
+    /**
+     * Get next item that's ready to process.
+     */
+    private getNextQueuedItem;
+    /**
+     * Schedule a timer to wake up processQueue when the next retry is due.
+     * This prevents retries from stalling indefinitely.
+     */
+    private scheduleNextRetry;
+    /**
+     * Clear any pending retry timer.
+     */
+    private clearRetryTimer;
+    private setupNetworkMonitoring;
+    private emitProgress;
+    private emitComplete;
+    private emitError;
+    /**
+     * Subscribe to progress updates.
+     * @returns Unsubscribe function
+     */
+    onProgress(callback: ProgressCallback): () => void;
+    /**
+     * Subscribe to upload completions.
+     * @returns Unsubscribe function
+     */
+    onComplete(callback: CompleteCallback): () => void;
+    /**
+     * Subscribe to upload errors.
+     * @returns Unsubscribe function
+     */
+    onError(callback: ErrorCallback): () => void;
+    /**
+     * Get current queue status.
+     */
+    getQueueStatus(): QueueStatus;
+    /**
+     * Get a queue item by attachment ID.
+     */
+    getItemByAttachmentId(attachmentId: string): QueueItem | undefined;
+    /**
+     * Retry a failed upload.
+     */
+    retryItem(attachmentId: string): Promise<void>;
+    /**
+     * Cancel and remove an item from the queue.
+     */
+    cancelItem(attachmentId: string): Promise<void>;
+    /**
+     * Clear all completed items from the queue.
+     */
+    clearCompleted(): Promise<void>;
+    /**
+     * Clear all failed items from the queue.
+     */
+    clearFailed(): Promise<void>;
+    private persistQueue;
+    private sleep;
+    private log;
+    /**
+     * Destroy the service instance.
+     * Used primarily for testing.
+     */
+    destroy(): void;
+}
+/**
+ * Singleton instance getter.
+ */
+export declare const uploadQueueService: UploadQueueService;
+export {};
+//# sourceMappingURL=uploadQueueService.d.ts.map

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

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