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

package/dist/domain/upload-queue.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Upload queue domain types.
+ *
+ * These types define the state machine for background attachment uploads.
+ */
+/**
+ * Phases of the upload lifecycle.
+ */
+export declare enum UploadPhase {
+    /** Waiting in queue to be processed */
+    QUEUED = "queued",
+    /** Currently uploading to storage */
+    UPLOADING = "uploading",
+    /** Upload complete, confirming with server */
+    CONFIRMING = "confirming",
+    /** Successfully uploaded and confirmed */
+    COMPLETED = "completed",
+    /** Failed after max retries */
+    FAILED = "failed"
+}
+/**
+ * A single item in the upload queue.
+ */
+export interface QueueItem {
+    /** Internal queue item ID */
+    id: string;
+    /** Server-assigned attachment ID */
+    attachmentId: string;
+    /** Local file URI (file://) */
+    localUri: string;
+    /** Presigned upload URL */
+    uploadUrl: string;
+    /** ISO timestamp when upload URL expires */
+    uploadExpiresAt: string;
+    /** MIME type (e.g., 'image/png') */
+    mimeType: string;
+    /** Original filename */
+    fileName: string;
+    /** File size in bytes */
+    fileSize: number;
+    /** Current phase in upload lifecycle */
+    phase: UploadPhase;
+    /** Upload progress (0.0 - 1.0) */
+    progress: number;
+    /** Current attempt number (1-based) */
+    attemptNumber: number;
+    /** Maximum retry attempts */
+    maxAttempts: number;
+    /** Last error message if failed */
+    lastError?: string;
+    /** ISO timestamp when item was queued */
+    createdAt: string;
+    /** ISO timestamp when upload started */
+    startedAt?: string;
+    /** ISO timestamp when completed or failed */
+    completedAt?: string;
+    /** ISO timestamp for scheduled retry (backoff) */
+    scheduledRetryAt?: string;
+}
+/**
+ * Summary of queue state.
+ */
+export interface QueueStatus {
+    /** Total items in queue */
+    total: number;
+    /** Items waiting to be processed */
+    queued: number;
+    /** Items currently uploading or confirming */
+    uploading: number;
+    /** Successfully completed items */
+    completed: number;
+    /** Failed items (max retries exceeded) */
+    failed: number;
+    /** Whether queue is paused (e.g., offline) */
+    isPaused: boolean;
+}
+/**
+ * Progress update for a single attachment.
+ */
+export interface UploadProgress {
+    /** Server-assigned attachment ID */
+    attachmentId: string;
+    /** Current phase */
+    phase: UploadPhase;
+    /** Upload progress (0.0 - 1.0) */
+    progress: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Persisted queue schema for AsyncStorage.
+ */
+export interface PersistedQueue {
+    /** Schema version for migrations */
+    version: number;
+    /** Queue items */
+    items: QueueItem[];
+}
+/**
+ * Configuration for upload retry behavior.
+ */
+export interface UploadRetryConfig {
+    /** Base delay in milliseconds (default: 2000) */
+    baseDelayMs: number;
+    /** Maximum delay in milliseconds (default: 60000) */
+    maxDelayMs: number;
+    /** Maximum number of attempts (default: 3) */
+    maxAttempts: number;
+    /** Random jitter in milliseconds (default: 1000) */
+    jitterMs: number;
+}
+/**
+ * Default retry configuration per feature spec D4.
+ */
+export declare const DEFAULT_UPLOAD_RETRY_CONFIG: UploadRetryConfig;
+//# sourceMappingURL=upload-queue.d.ts.map

package/dist/domain/upload-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-queue.d.ts","sourceRoot":"","sources":["../../src/domain/upload-queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,oBAAY,WAAW;IACrB,uCAAuC;IACvC,MAAM,WAAW;IACjB,qCAAqC;IACrC,SAAS,cAAc;IACvB,8CAA8C;IAC9C,UAAU,eAAe;IACzB,0CAA0C;IAC1C,SAAS,cAAc;IACvB,+BAA+B;IAC/B,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IAGjB,wCAAwC;IACxC,KAAK,EAAE,WAAW,CAAC;IACnB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,KAAK,EAAE,WAAW,CAAC;IACnB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,iBAKzC,CAAC"}

package/dist/domain/upload-queue.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Upload queue domain types.
+ *
+ * These types define the state machine for background attachment uploads.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_UPLOAD_RETRY_CONFIG = exports.UploadPhase = void 0;
+/**
+ * Phases of the upload lifecycle.
+ */
+var UploadPhase;
+(function (UploadPhase) {
+    /** Waiting in queue to be processed */
+    UploadPhase["QUEUED"] = "queued";
+    /** Currently uploading to storage */
+    UploadPhase["UPLOADING"] = "uploading";
+    /** Upload complete, confirming with server */
+    UploadPhase["CONFIRMING"] = "confirming";
+    /** Successfully uploaded and confirmed */
+    UploadPhase["COMPLETED"] = "completed";
+    /** Failed after max retries */
+    UploadPhase["FAILED"] = "failed";
+})(UploadPhase || (exports.UploadPhase = UploadPhase = {}));
+/**
+ * Default retry configuration per feature spec D4.
+ */
+exports.DEFAULT_UPLOAD_RETRY_CONFIG = {
+    baseDelayMs: 2000,
+    maxDelayMs: 60000,
+    maxAttempts: 3,
+    jitterMs: 1000,
+};
+//# sourceMappingURL=upload-queue.js.map

package/dist/domain/upload-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-queue.js","sourceRoot":"","sources":["../../src/domain/upload-queue.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH;;GAEG;AACH,IAAY,WAWX;AAXD,WAAY,WAAW;IACrB,uCAAuC;IACvC,gCAAiB,CAAA;IACjB,qCAAqC;IACrC,sCAAuB,CAAA;IACvB,8CAA8C;IAC9C,wCAAyB,CAAA;IACzB,0CAA0C;IAC1C,sCAAuB,CAAA;IACvB,+BAA+B;IAC/B,gCAAiB,CAAA;AACnB,CAAC,EAXW,WAAW,2BAAX,WAAW,QAWtB;AAsGD;;GAEG;AACU,QAAA,2BAA2B,GAAsB;IAC5D,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,KAAK;IACjB,WAAW,EAAE,CAAC;IACd,QAAQ,EAAE,IAAI;CACf,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,6 @@
+export { useHarkenTheme } from './useHarkenTheme';
+export { useHarkenContext } from './useHarkenContext';
+export { useAnonymousId } from './useAnonymousId';
+export { useFeedback } from './useFeedback';
+export type { SubmitFeedbackParams, UseFeedbackResult } from './useFeedback';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFeedback = exports.useAnonymousId = exports.useHarkenContext = exports.useHarkenTheme = void 0;
+// Core hooks (no native module dependencies)
+var useHarkenTheme_1 = require("./useHarkenTheme");
+Object.defineProperty(exports, "useHarkenTheme", { enumerable: true, get: function () { return useHarkenTheme_1.useHarkenTheme; } });
+var useHarkenContext_1 = require("./useHarkenContext");
+Object.defineProperty(exports, "useHarkenContext", { enumerable: true, get: function () { return useHarkenContext_1.useHarkenContext; } });
+var useAnonymousId_1 = require("./useAnonymousId");
+Object.defineProperty(exports, "useAnonymousId", { enumerable: true, get: function () { return useAnonymousId_1.useAnonymousId; } });
+var useFeedback_1 = require("./useFeedback");
+Object.defineProperty(exports, "useFeedback", { enumerable: true, get: function () { return useFeedback_1.useFeedback; } });
+// Note: Attachment hooks (useAttachmentUpload, useAttachmentStatus) are
+// exported from '@harkenapp/sdk-react-native/attachments' to avoid eager
+// loading of native modules (expo-file-system, expo-image-picker, etc.)
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":";;;AAAA,6CAA6C;AAC7C,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AAGpB,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE"}

package/dist/hooks/useAnonymousId.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Hook to access the anonymous ID for the current installation.
+ *
+ * The anonymous ID is a stable UUID that persists across app sessions.
+ * It's generated once and stored securely on the device.
+ *
+ * @returns Object with the anonymous ID and loading state
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { anonymousId, isLoading } = useAnonymousId();
+ *
+ *   if (isLoading) {
+ *     return <Text>Loading...</Text>;
+ *   }
+ *
+ *   return <Text>ID: {anonymousId}</Text>;
+ * }
+ * ```
+ */
+export declare function useAnonymousId(): {
+    /** The anonymous ID, or null while loading */
+    anonymousId: string | null;
+    /** True while the ID is being loaded from storage */
+    isLoading: boolean;
+};
+//# sourceMappingURL=useAnonymousId.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAnonymousId.d.ts","sourceRoot":"","sources":["../../src/hooks/useAnonymousId.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,IAAI;IAChC,8CAA8C;IAC9C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qDAAqD;IACrD,SAAS,EAAE,OAAO,CAAC;CACpB,CAsCA"}

package/dist/hooks/useAnonymousId.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAnonymousId = useAnonymousId;
+const react_1 = require("react");
+const context_1 = require("../context");
+/**
+ * Hook to access the anonymous ID for the current installation.
+ *
+ * The anonymous ID is a stable UUID that persists across app sessions.
+ * It's generated once and stored securely on the device.
+ *
+ * @returns Object with the anonymous ID and loading state
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { anonymousId, isLoading } = useAnonymousId();
+ *
+ *   if (isLoading) {
+ *     return <Text>Loading...</Text>;
+ *   }
+ *
+ *   return <Text>ID: {anonymousId}</Text>;
+ * }
+ * ```
+ */
+function useAnonymousId() {
+    const context = (0, react_1.useContext)(context_1.HarkenContext);
+    if (!context) {
+        throw new Error('useAnonymousId must be used within a HarkenProvider');
+    }
+    // Capture identityStore to satisfy TypeScript narrowing in useEffect
+    const { identityStore } = context;
+    const [anonymousId, setAnonymousId] = (0, react_1.useState)(null);
+    const [isLoading, setIsLoading] = (0, react_1.useState)(true);
+    (0, react_1.useEffect)(() => {
+        let mounted = true;
+        async function loadAnonymousId() {
+            try {
+                const id = await identityStore.getAnonymousId();
+                if (mounted) {
+                    setAnonymousId(id);
+                    setIsLoading(false);
+                }
+            }
+            catch {
+                if (mounted) {
+                    setIsLoading(false);
+                }
+            }
+        }
+        void loadAnonymousId();
+        return () => {
+            mounted = false;
+        };
+    }, [identityStore]);
+    return { anonymousId, isLoading };
+}
+//# sourceMappingURL=useAnonymousId.js.map

package/dist/hooks/useAnonymousId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnonymousId.js","sourceRoot":"","sources":["../../src/hooks/useAnonymousId.ts"],"names":[],"mappings":";;AAwBA,wCA2CC;AAnED,iCAAwD;AACxD,wCAA2C;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,cAAc;IAM5B,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,qEAAqE;IACrE,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAElC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,IAAA,gBAAQ,EAAgB,IAAI,CAAC,CAAC;IACpE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,IAAA,gBAAQ,EAAC,IAAI,CAAC,CAAC;IAEjD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,OAAO,GAAG,IAAI,CAAC;QAEnB,KAAK,UAAU,eAAe;YAC5B,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,cAAc,EAAE,CAAC;gBAChD,IAAI,OAAO,EAAE,CAAC;oBACZ,cAAc,CAAC,EAAE,CAAC,CAAC;oBACnB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,OAAO,EAAE,CAAC;oBACZ,YAAY,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,eAAe,EAAE,CAAC;QAEvB,OAAO,GAAG,EAAE;YACV,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AACpC,CAAC"}

package/dist/hooks/useAttachmentPicker.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Hook for managing the attachment picker with smart source selection.
+ *
+ * Provides configurable attachment sources and automatically handles:
+ * - Skipping the picker modal when only one source is enabled
+ * - Warning when no sources are enabled
+ */
+import type { UseAttachmentUploadResult } from './useAttachmentUpload';
+import type { AttachmentPickerProps } from '../components/AttachmentPicker';
+/**
+ * Configuration for which attachment sources are enabled.
+ */
+export interface AttachmentSourceConfig {
+    /** Enable camera source. @default true */
+    camera?: boolean;
+    /** Enable photo library source. @default true */
+    library?: boolean;
+    /** Enable file/document picker source. @default true */
+    files?: boolean;
+}
+/**
+ * Return type for useAttachmentPicker hook.
+ */
+export interface UseAttachmentPickerResult extends UseAttachmentUploadResult {
+    /** Open the attachment picker (or directly invoke source if only one enabled) */
+    openPicker: () => void;
+    /** Whether the picker modal is visible */
+    isPickerVisible: boolean;
+    /** Close the picker modal */
+    closePicker: () => void;
+    /** Props to spread onto AttachmentPicker component */
+    pickerProps: Pick<AttachmentPickerProps, 'visible' | 'onClose' | 'onTakePhoto' | 'onPickFromLibrary' | 'onPickDocument' | 'options'>;
+    /** Which sources are enabled */
+    enabledSources: {
+        camera: boolean;
+        library: boolean;
+        files: boolean;
+    };
+    /** Count of enabled sources */
+    enabledSourceCount: number;
+}
+/**
+ * Hook for managing the attachment picker with smart source selection.
+ *
+ * When only one source is enabled, calling `openPicker()` will skip the modal
+ * and directly open that source. When no sources are enabled, a warning is logged.
+ *
+ * @example
+ * ```tsx
+ * // Allow only photo library
+ * const { openPicker, pickerProps, attachments } = useAttachmentPicker({
+ *   camera: false,
+ *   library: true,
+ *   files: false,
+ * });
+ *
+ * // openPicker() will directly open photo library without showing modal
+ *
+ * return (
+ *   <>
+ *     <Button onPress={openPicker} title="Add Photo" />
+ *     <AttachmentPicker {...pickerProps} />
+ *   </>
+ * );
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With FeedbackSheet integration
+ * const {
+ *   openPicker,
+ *   pickerProps,
+ *   attachments,
+ *   removeAttachment,
+ *   retryAttachment,
+ * } = useAttachmentPicker({
+ *   camera: true,
+ *   library: true,
+ *   files: false, // Disable document picker
+ * });
+ * ```
+ */
+export declare function useAttachmentPicker(sourceConfig?: AttachmentSourceConfig): UseAttachmentPickerResult;
+//# sourceMappingURL=useAttachmentPicker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachmentPicker.d.ts","sourceRoot":"","sources":["../../src/hooks/useAttachmentPicker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,yBAAyB;IAC1E,iFAAiF;IACjF,UAAU,EAAE,MAAM,IAAI,CAAC;IAEvB,0CAA0C;IAC1C,eAAe,EAAE,OAAO,CAAC;IAEzB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,IAAI,CAAC;IAExB,sDAAsD;IACtD,WAAW,EAAE,IAAI,CACf,qBAAqB,EACrB,SAAS,GAAG,SAAS,GAAG,aAAa,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,SAAS,CAC3F,CAAC;IAEF,gCAAgC;IAChC,cAAc,EAAE;QACd,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;IAEF,+BAA+B;IAC/B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,GAAE,sBAA2B,GACxC,yBAAyB,CAgJ3B"}

package/dist/hooks/useAttachmentPicker.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * Hook for managing the attachment picker with smart source selection.
+ *
+ * Provides configurable attachment sources and automatically handles:
+ * - Skipping the picker modal when only one source is enabled
+ * - Warning when no sources are enabled
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAttachmentPicker = useAttachmentPicker;
+const react_1 = require("react");
+const useAttachmentUpload_1 = require("./useAttachmentUpload");
+/**
+ * Hook for managing the attachment picker with smart source selection.
+ *
+ * When only one source is enabled, calling `openPicker()` will skip the modal
+ * and directly open that source. When no sources are enabled, a warning is logged.
+ *
+ * @example
+ * ```tsx
+ * // Allow only photo library
+ * const { openPicker, pickerProps, attachments } = useAttachmentPicker({
+ *   camera: false,
+ *   library: true,
+ *   files: false,
+ * });
+ *
+ * // openPicker() will directly open photo library without showing modal
+ *
+ * return (
+ *   <>
+ *     <Button onPress={openPicker} title="Add Photo" />
+ *     <AttachmentPicker {...pickerProps} />
+ *   </>
+ * );
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With FeedbackSheet integration
+ * const {
+ *   openPicker,
+ *   pickerProps,
+ *   attachments,
+ *   removeAttachment,
+ *   retryAttachment,
+ * } = useAttachmentPicker({
+ *   camera: true,
+ *   library: true,
+ *   files: false, // Disable document picker
+ * });
+ * ```
+ */
+function useAttachmentPicker(sourceConfig = {}) {
+    const { camera: cameraEnabled = true, library: libraryEnabled = true, files: filesEnabled = true, } = sourceConfig;
+    const [isPickerVisible, setIsPickerVisible] = (0, react_1.useState)(false);
+    const uploadResult = (0, useAttachmentUpload_1.useAttachmentUpload)();
+    const { pickImage, pickDocument } = uploadResult;
+    // Calculate enabled sources
+    const enabledSources = (0, react_1.useMemo)(() => ({
+        camera: cameraEnabled,
+        library: libraryEnabled,
+        files: filesEnabled,
+    }), [cameraEnabled, libraryEnabled, filesEnabled]);
+    const enabledSourceCount = (0, react_1.useMemo)(() => {
+        let count = 0;
+        if (cameraEnabled)
+            count++;
+        if (libraryEnabled)
+            count++;
+        if (filesEnabled)
+            count++;
+        return count;
+    }, [cameraEnabled, libraryEnabled, filesEnabled]);
+    // Auto-close picker if sources change to 0 or 1 while visible
+    // This prevents the iOS ActionSheet from showing with no/single options
+    (0, react_1.useEffect)(() => {
+        if (isPickerVisible && enabledSourceCount < 2) {
+            setIsPickerVisible(false);
+        }
+    }, [isPickerVisible, enabledSourceCount]);
+    // Handlers for each source
+    const handleTakePhoto = (0, react_1.useCallback)(async () => {
+        setIsPickerVisible(false);
+        try {
+            await pickImage('camera');
+        }
+        catch (e) {
+            console.error('[Harken] Failed to take photo:', e);
+        }
+    }, [pickImage]);
+    const handlePickFromLibrary = (0, react_1.useCallback)(async () => {
+        setIsPickerVisible(false);
+        try {
+            await pickImage('library');
+        }
+        catch (e) {
+            console.error('[Harken] Failed to pick from library:', e);
+        }
+    }, [pickImage]);
+    const handlePickDocument = (0, react_1.useCallback)(async () => {
+        setIsPickerVisible(false);
+        try {
+            await pickDocument();
+        }
+        catch (e) {
+            console.error('[Harken] Failed to pick document:', e);
+        }
+    }, [pickDocument]);
+    const closePicker = (0, react_1.useCallback)(() => {
+        setIsPickerVisible(false);
+    }, []);
+    /**
+     * Smart picker opener:
+     * - 0 sources enabled: log warning, do nothing
+     * - 1 source enabled: directly invoke that source
+     * - 2+ sources enabled: show picker modal
+     */
+    const openPicker = (0, react_1.useCallback)(() => {
+        if (enabledSourceCount === 0) {
+            console.warn('[Harken] useAttachmentPicker: No attachment sources are enabled. ' +
+                'Enable at least one of: camera, library, or files.');
+            return;
+        }
+        if (enabledSourceCount === 1) {
+            // Directly invoke the single enabled source
+            if (cameraEnabled) {
+                void handleTakePhoto();
+            }
+            else if (libraryEnabled) {
+                void handlePickFromLibrary();
+            }
+            else if (filesEnabled) {
+                void handlePickDocument();
+            }
+            return;
+        }
+        // Multiple sources enabled - show the picker
+        setIsPickerVisible(true);
+    }, [
+        enabledSourceCount,
+        cameraEnabled,
+        libraryEnabled,
+        filesEnabled,
+        handleTakePhoto,
+        handlePickFromLibrary,
+        handlePickDocument,
+    ]);
+    // Build picker props with hidden options for disabled sources
+    const pickerProps = (0, react_1.useMemo)(() => ({
+        visible: isPickerVisible,
+        onClose: closePicker,
+        onTakePhoto: handleTakePhoto,
+        onPickFromLibrary: handlePickFromLibrary,
+        onPickDocument: handlePickDocument,
+        options: {
+            camera: { hidden: !cameraEnabled },
+            library: { hidden: !libraryEnabled },
+            document: { hidden: !filesEnabled },
+        },
+    }), [
+        isPickerVisible,
+        closePicker,
+        handleTakePhoto,
+        handlePickFromLibrary,
+        handlePickDocument,
+        cameraEnabled,
+        libraryEnabled,
+        filesEnabled,
+    ]);
+    return {
+        ...uploadResult,
+        openPicker,
+        isPickerVisible,
+        closePicker,
+        pickerProps,
+        enabledSources,
+        enabledSourceCount,
+    };
+}
+//# sourceMappingURL=useAttachmentPicker.js.map

package/dist/hooks/useAttachmentPicker.js.map

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

package/dist/hooks/useAttachmentStatus.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Hook for subscribing to a single attachment's upload status.
+ *
+ * Useful for components that display a single attachment with progress indicator.
+ */
+import { UploadPhase } from '../domain';
+/**
+ * Status information for a single attachment.
+ */
+export interface AttachmentStatus {
+    /** Current upload phase */
+    phase: UploadPhase;
+    /** Upload progress (0.0 - 1.0) */
+    progress: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Hook to subscribe to a single attachment's upload status.
+ *
+ * Returns null if the attachment is not found in the queue.
+ *
+ * @param attachmentId - Server-assigned attachment ID
+ * @returns Current status or null if not found
+ *
+ * @example
+ * ```tsx
+ * function AttachmentThumbnail({ attachmentId, uri }: Props) {
+ *   const status = useAttachmentStatus(attachmentId);
+ *
+ *   if (!status) return null;
+ *
+ *   return (
+ *     <View>
+ *       <Image source={{ uri }} />
+ *       {status.phase === 'uploading' && (
+ *         <ProgressBar progress={status.progress} />
+ *       )}
+ *       {status.phase === 'failed' && (
+ *         <Text>Error: {status.error}</Text>
+ *       )}
+ *       {status.phase === 'completed' && (
+ *         <Icon name="checkmark" />
+ *       )}
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export declare function useAttachmentStatus(attachmentId: string): AttachmentStatus | null;
+//# sourceMappingURL=useAttachmentStatus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachmentStatus.d.ts","sourceRoot":"","sources":["../../src/hooks/useAttachmentStatus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,WAAW,EAAkB,MAAM,WAAW,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,GACnB,gBAAgB,GAAG,IAAI,CA6BzB"}