react-native-ensys-camera-x 1.0.7

package/lib/typescript/src/db/MediaMapper.d.ts

@@ -0,0 +1,77 @@
+/**
+ * MediaMapper — the single translation boundary between the UI-facing
+ * `CameraAsset` type and the persisted `MediaRecord`/SQL row.
+ *
+ * Keeping all field mapping here means the rest of the app (screens, hooks) and
+ * the database schema can evolve independently. Two directions are supported:
+ *   - `assetToRecordInput`  CameraAsset  → MediaRecordInput (for writes)
+ *   - `rowToRecord` / `recordToAsset`   SQL row → MediaRecord → CameraAsset (reads)
+ */
+import type { CameraAsset } from '../types';
+import { type MediaRecord, type MediaRecordInput, type MediaSource, type MediaType } from './types';
+/**
+ * UI uses `photo`; the database normalizes photos to `image`. Videos, documents
+ * and audio are preserved as-is so a picked PDF or track keeps its true kind
+ * instead of collapsing into `image` (the historical cause of documents/audio
+ * showing up under the Photos filter).
+ */
+export declare function assetTypeToMediaType(type: CameraAsset['type']): MediaType;
+/** Inverse of {@link assetTypeToMediaType}. */
+export declare function mediaTypeToAssetType(type: MediaType): CameraAsset['type'];
+/**
+ * The file extension a synthesized name should carry for `mimeType`, defaulting to the given
+ * fallback when the type is missing or unrecognised.
+ */
+export declare function extensionForMimeType(mimeType: string | null | undefined, fallback: string): string;
+/**
+ * Resolves the canonical persisted {@link MediaType} for an asset using every
+ * available signal — the caller-provided `type`, the MIME type, then the file
+ * extension — so a mis-tagged or MIME-less item is still classified correctly.
+ * Order of precedence: a document path → MIME family → extension → the UI `type`
+ * fallback.
+ */
+export declare function classifyMediaType(asset: CameraAsset): MediaType;
+/** Normalizes an arbitrary source hint onto the allowed enum. */
+export declare function normalizeSource(source: unknown): MediaSource;
+/**
+ * Resolves the FINAL, persistent Documents path for an asset — the path that
+ * must be stored in SQLCipher — or `null` if the asset is not (yet) in the
+ * Documents directory.
+ *
+ * The native Send workflow moves a confirmed file from cache to
+ * `.../Documents/media_documents/...`, clears `cachePath`, and sets
+ * `documentUri`. This helper therefore prefers `documentUri`, then falls back to
+ * `uri` ONLY when that uri is itself a published Documents path (not a cache or
+ * `content://` gallery path). A still-cached / publish-failed asset returns
+ * `null`, so callers can skip it and never persist a temporary location.
+ */
+export declare function resolveDocumentsPath(asset: CameraAsset): string | null;
+/**
+ * True when an asset has been successfully moved to the Documents directory and
+ * is therefore eligible to be persisted in SQLCipher. Cache-only or
+ * publish-failed assets return false.
+ */
+export declare function isPublishedToDocuments(asset: CameraAsset): boolean;
+/**
+ * Auto-detects the origin of an asset. Gallery-selected media retains its
+ * original `content://`/gallery uri in `originalUri`; camera captures do not.
+ * An explicit hint always wins.
+ */
+export declare function detectSource(asset: CameraAsset, hint?: MediaSource): MediaSource;
+/**
+ * Builds a `MediaRecordInput` from a UI asset, storing the FINAL Documents path.
+ *
+ * @param source optional origin hint; when omitted the origin is auto-detected
+ *   (gallery vs camera). The stored `filePath` is always the resolved Documents
+ *   path — callers must only pass assets for which {@link isPublishedToDocuments}
+ *   is true (the repository enforces this).
+ */
+export declare function assetToRecordInput(asset: CameraAsset, source?: MediaSource): MediaRecordInput;
+/** Maps a raw SQL row (snake_case columns) into a typed `MediaRecord`. */
+export declare function rowToRecord(row: Record<string, any>): MediaRecord;
+/**
+ * Maps a persisted record back to the UI `CameraAsset` shape so the existing
+ * Media Library renders identically — only the data source changed.
+ */
+export declare function recordToAsset(record: MediaRecord): CameraAsset;
+//# sourceMappingURL=MediaMapper.d.ts.map

package/lib/typescript/src/db/MediaMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaMapper.d.ts","sourceRoot":"","sources":["../../../../src/db/MediaMapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAWzE;AAED,+CAA+C;AAC/C,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAWzE;AA4FD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,QAAQ,EAAE,MAAM,GACf,MAAM,CAGR;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAiC/D;AAsBD,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,CAE5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAUtE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAElE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,IAAI,CAAC,EAAE,WAAW,GACjB,WAAW,CAMb;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,gBAAgB,CAiClB;AASD,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,WAAW,CAgBjE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAe9D"}

package/lib/typescript/src/db/MediaRepository.d.ts

@@ -0,0 +1,66 @@
+/**
+ * MediaRepository — the CRUD/service layer over the `media` table.
+ *
+ * This is the ONLY module that writes SQL for media rows. UI code and hooks talk
+ * to strongly-typed `MediaRecord`/`CameraAsset` objects and never see a query
+ * string, keeping a clean separation between presentation and persistence.
+ *
+ * All operations delegate raw execution to the centralized `DatabaseManager`.
+ */
+import type { CameraAsset } from '../types';
+import { type DatabaseManager } from './DatabaseManager';
+import { type MediaCounts, type MediaQueryOptions, type MediaRecord, type MediaRecordInput, type MediaSource } from './types';
+export declare class MediaRepository {
+    private readonly db;
+    constructor(db?: DatabaseManager);
+    /** Builds an idempotent UPSERT statement for one record. */
+    private upsertStatement;
+    /** Inserts (or updates on id/path conflict) a single record. */
+    insert(input: MediaRecordInput): Promise<void>;
+    /** Inserts many records atomically in one transaction. */
+    insertMany(inputs: MediaRecordInput[]): Promise<void>;
+    /**
+     * Persists confirmed, Documents-backed media from the capture/gallery Send
+     * flows. This is the ONLY path the app uses after a successful Send.
+     *
+     * Contract enforced here (so callers can't create inconsistent records):
+     *   1. Only assets that have been successfully moved to the Documents
+     *      directory are persisted — see {@link isPublishedToDocuments}. A
+     *      cache-only or publish-failed asset is skipped, never stored.
+     *   2. The stored `filePath` is always the final Documents path, never cache.
+     *   3. The write is atomic; on failure nothing is committed (all-or-nothing),
+     *      so a partial batch can't leave dangling rows.
+     *
+     * @param source optional origin hint; when omitted, each asset's origin is
+     *   auto-detected (gallery vs camera).
+     * @returns the records actually persisted (may be fewer than `assets`).
+     */
+    insertAssets(assets: CameraAsset[], source?: MediaSource): Promise<MediaRecord[]>;
+    private buildWhere;
+    /** Returns records matching the query, newest first by default. */
+    getAll(options?: MediaQueryOptions): Promise<MediaRecord[]>;
+    /** Returns only image records (backs the "Photos" filter). */
+    getImages(options?: Omit<MediaQueryOptions, 'filter'>): Promise<MediaRecord[]>;
+    /** Returns only video records (backs the "Videos" filter). */
+    getVideos(options?: Omit<MediaQueryOptions, 'filter'>): Promise<MediaRecord[]>;
+    /** Returns records mapped straight to UI `CameraAsset`s. */
+    getAssets(options?: MediaQueryOptions): Promise<CameraAsset[]>;
+    /** Fetches a single record by id, or null. */
+    getById(id: string): Promise<MediaRecord | null>;
+    /**
+     * Computes the filter-card counts directly from the database in one query,
+     * one bucket per media kind (image / video / document / audio).
+     */
+    getCounts(): Promise<MediaCounts>;
+    /** Deletes a record by id. Returns true if a row was removed. */
+    deleteById(id: string): Promise<boolean>;
+    /** Deletes a record by its file path/URI. Returns true if a row was removed. */
+    deleteByPath(filePath: string): Promise<boolean>;
+    /** Deletes multiple records by id atomically. Returns the number requested. */
+    deleteMany(ids: string[]): Promise<void>;
+    /** Removes every media row. */
+    clear(): Promise<void>;
+}
+/** Returns the shared `MediaRepository` singleton. */
+export declare function getMediaRepository(): MediaRepository;
+//# sourceMappingURL=MediaRepository.d.ts.map

package/lib/typescript/src/db/MediaRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaRepository.d.ts","sourceRoot":"","sources":["../../../../src/db/MediaRepository.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAO3B,OAAO,EAGL,KAAK,WAAW,EAEhB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,SAAS,CAAC;AAkBjB,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,GAAE,eAAsC;IAEvE,4DAA4D;IAC5D,OAAO,CAAC,eAAe;IA0CvB,gEAAgE;IAC1D,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD,0DAA0D;IACpD,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3D;;;;;;;;;;;;;;;OAeG;IACG,YAAY,CAChB,MAAM,EAAE,WAAW,EAAE,EACrB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,EAAE,CAAC;IAmCzB,OAAO,CAAC,UAAU;IAYlB,mEAAmE;IAC7D,MAAM,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAiCrE,8DAA8D;IAC9D,SAAS,CAAC,OAAO,GAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAM;IAIzD,8DAA8D;IAC9D,SAAS,CAAC,OAAO,GAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAM;IAIzD,4DAA4D;IACtD,SAAS,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKxE,8CAA8C;IACxC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAQtD;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC;IAiCvC,iEAAiE;IAC3D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ9C,gFAAgF;IAC1E,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQtD,+EAA+E;IACzE,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9C,+BAA+B;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAKD,sDAAsD;AACtD,wBAAgB,kBAAkB,IAAI,eAAe,CAKpD"}

package/lib/typescript/src/db/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Encrypted media database — public API.
+ *
+ * A modular SQLCipher persistence layer for the camera plugin:
+ *   - `DatabaseManager`     centralized encrypted connection + primitives
+ *   - `migrations`          schema versioning (PRAGMA user_version)
+ *   - `MediaRepository`     typed CRUD/service layer
+ *   - `MediaMapper`         CameraAsset ⇆ MediaRecord translation
+ *   - `useMediaDatabase`    React hook bridging UI and the store
+ *   - `secureKey`           Keystore-backed encryption-key provisioning
+ *
+ * Consumers should generally use `useMediaDatabase` (UI) or `getMediaRepository`
+ * (imperative), and call `initializeMediaDatabase()` once at startup.
+ */
+export type { MediaRecord, MediaRecordInput, MediaType, MediaSource, MediaFilter, MediaCounts, MediaQueryOptions, } from './types';
+export { MEDIA_TABLE, MediaColumns } from './types';
+export { DatabaseManager, getDatabaseManager, initializeMediaDatabase, type BatchStatement, } from './DatabaseManager';
+export { MIGRATIONS, LATEST_SCHEMA_VERSION, runMigrations, type Migration, type MigrationExecutor, } from './migrations';
+export { MediaRepository, getMediaRepository } from './MediaRepository';
+export { assetToRecordInput, recordToAsset, rowToRecord, assetTypeToMediaType, mediaTypeToAssetType, normalizeSource, extensionForMimeType, resolveDocumentsPath, isPublishedToDocuments, detectSource, } from './MediaMapper';
+export { getDatabaseKey, isHardwareBackedKeyAvailable, } from './secureKey';
+export { useMediaDatabase, type UseMediaDatabaseResult, } from './useMediaDatabase';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/db/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,WAAW,EACX,WAAW,EACX,iBAAiB,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGpD,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,UAAU,EACV,qBAAqB,EACrB,aAAa,EACb,KAAK,SAAS,EACd,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGxE,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EAEpB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,GACb,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,cAAc,EACd,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,GAC5B,MAAM,oBAAoB,CAAC"}

package/lib/typescript/src/db/migrations.d.ts

@@ -0,0 +1,31 @@
+/** A single forward migration step. */
+export interface Migration {
+    /** Target `user_version` this migration upgrades the database to. */
+    version: number;
+    /** Human-readable description (documentation only). */
+    description: string;
+    /** Ordered SQL statements executed to reach `version`. */
+    statements: string[];
+}
+/**
+ * Ordered list of migrations. `LATEST_SCHEMA_VERSION` is derived from the last
+ * entry, so bumping the schema only requires appending a new `Migration`.
+ */
+export declare const MIGRATIONS: Migration[];
+/** The schema version the app expects after all migrations are applied. */
+export declare const LATEST_SCHEMA_VERSION: number;
+/** Minimal executor contract so migrations don't depend on the concrete manager. */
+export interface MigrationExecutor {
+    /** Reads the current `PRAGMA user_version`. */
+    getVersion(): Promise<number>;
+    /** Runs the given statements atomically in a single transaction. */
+    runBatch(statements: string[]): Promise<void>;
+}
+/**
+ * Applies all pending migrations. Safe to call on every launch — a fully
+ * up-to-date database performs only a cheap version read and returns.
+ *
+ * @returns the schema version after migration.
+ */
+export declare function runMigrations(executor: MigrationExecutor): Promise<number>;
+//# sourceMappingURL=migrations.d.ts.map

package/lib/typescript/src/db/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../../src/db/migrations.ts"],"names":[],"mappings":"AAWA,uCAAuC;AACvC,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,EAyJjC,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,QACsC,CAAC;AAEzE,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAqBjB"}

package/lib/typescript/src/db/secureKey.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Resolve the SQLCipher passphrase, preferring the hardware-backed native key.
+ * The result is memoized for the lifetime of the JS runtime.
+ */
+export declare function getDatabaseKey(): Promise<string>;
+/** True when the hardware-backed native key module is available. */
+export declare function isHardwareBackedKeyAvailable(): boolean;
+/** Test/hot-reload helper: clears the in-memory key cache. */
+export declare function __resetDatabaseKeyCache(): void;
+//# sourceMappingURL=secureKey.d.ts.map

package/lib/typescript/src/db/secureKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secureKey.d.ts","sourceRoot":"","sources":["../../../../src/db/secureKey.ts"],"names":[],"mappings":"AAyDA;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CA4BtD;AAED,oEAAoE;AACpE,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAED,8DAA8D;AAC9D,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/lib/typescript/src/db/types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Strongly-typed media models for the encrypted SQLCipher database.
+ *
+ * These types describe the *persistence* shape of a media item — the exact
+ * columns stored in the `media` table — independently of the UI-facing
+ * `CameraAsset` type. Mapping between the two lives in `MediaMapper.ts`, keeping
+ * a clean separation between the database schema and the rest of the app.
+ */
+/**
+ * Persisted media kind. Photos are normalized to `image`; documents and audio
+ * are first-class kinds so a picked PDF/track is never mis-stored as an image.
+ */
+export type MediaType = 'image' | 'video' | 'document' | 'audio';
+/** Where a media item originated. */
+export type MediaSource = 'camera' | 'gallery';
+/**
+ * A single row of the `media` table — the canonical, strongly-typed record.
+ *
+ * `null` is used (never `undefined`) for absent optional columns so the shape
+ * maps 1:1 onto SQL rows.
+ */
+export interface MediaRecord {
+    /** Unique identifier (primary key). */
+    id: string;
+    /** `image` or `video`. */
+    mediaType: MediaType;
+    /** `camera` or `gallery`. */
+    source: MediaSource;
+    /** Absolute file path or content URI. */
+    filePath: string;
+    /** Display file name, e.g. `photo_1699999999999.jpg`. */
+    fileName: string;
+    /** File size in bytes, or null if unknown. */
+    fileSize: number | null;
+    /** Pixel width, or null if unknown. */
+    width: number | null;
+    /** Pixel height, or null if unknown. */
+    height: number | null;
+    /** Duration in milliseconds (videos only), or null. */
+    duration: number | null;
+    /** MIME type such as `image/jpeg` or `video/mp4`, or null. */
+    mimeType: string | null;
+    /** Creation timestamp (epoch ms). */
+    createdAt: number;
+    /** Last-updated timestamp (epoch ms). */
+    updatedAt: number;
+    /**
+     * True when {@link fileSize} is a DISPLAY convention (a compressed video's
+     * proportional figure) rather than the exact bytes on disk. Read back onto
+     * `CameraAsset.sizeIsDisplayEstimate` so the preview / Info panel keeps the
+     * quoted size instead of re-statting the file. Absent (legacy) rows read false.
+     */
+    sizeIsDisplayEstimate: boolean;
+}
+/**
+ * Fields required to insert a new media record. Timestamps are optional on
+ * input — the repository fills `createdAt`/`updatedAt` when omitted.
+ */
+export interface MediaRecordInput {
+    id: string;
+    mediaType: MediaType;
+    source: MediaSource;
+    filePath: string;
+    fileName: string;
+    fileSize?: number | null;
+    width?: number | null;
+    height?: number | null;
+    duration?: number | null;
+    mimeType?: string | null;
+    createdAt?: number;
+    updatedAt?: number;
+    /** See {@link MediaRecord.sizeIsDisplayEstimate}. Stored as INTEGER 1/0. */
+    sizeIsDisplayEstimate?: boolean | null;
+}
+/** Filter used when querying the media list. */
+export type MediaFilter = 'all' | 'image' | 'video' | 'document' | 'audio';
+/**
+ * Aggregate counts computed directly from the database via `COUNT(*)`.
+ * Backs the filter-card counters (All / Photos / Videos / Documents / Audio).
+ */
+export interface MediaCounts {
+    all: number;
+    image: number;
+    video: number;
+    document: number;
+    audio: number;
+}
+/** Options for ordered/paged queries against the media table. */
+export interface MediaQueryOptions {
+    filter?: MediaFilter;
+    /** Column to order by. Defaults to `createdAt`. */
+    orderBy?: 'createdAt' | 'updatedAt' | 'fileName';
+    /** Sort direction. Defaults to `DESC` (newest first). */
+    direction?: 'ASC' | 'DESC';
+    limit?: number;
+    offset?: number;
+}
+/** Table + column name constants — single source of truth for SQL strings. */
+export declare const MEDIA_TABLE = "media";
+export declare const MediaColumns: {
+    readonly id: "id";
+    readonly mediaType: "media_type";
+    readonly source: "source";
+    readonly filePath: "file_path";
+    readonly fileName: "file_name";
+    readonly fileSize: "file_size";
+    readonly width: "width";
+    readonly height: "height";
+    readonly duration: "duration";
+    readonly mimeType: "mime_type";
+    readonly createdAt: "created_at";
+    readonly updatedAt: "updated_at";
+    readonly sizeIsDisplayEstimate: "size_is_display_estimate";
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/db/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/db/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAEjE,qCAAqC;AACrC,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,SAAS,EAAE,SAAS,CAAC;IACrB,6BAA6B;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,uCAAuC;IACvC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,wCAAwC;IACxC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,qBAAqB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACxC;AAED,gDAAgD;AAChD,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mDAAmD;IACnD,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;IACjD,yDAAyD;IACzD,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8EAA8E;AAC9E,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,eAAO,MAAM,YAAY;;;;;;;;;;;;;;CAcf,CAAC"}

package/lib/typescript/src/db/useMediaDatabase.d.ts

@@ -0,0 +1,41 @@
+import type { CameraAsset, SecureDeleteResult } from '../types';
+import type { MediaCounts, MediaSource } from './types';
+export interface UseMediaDatabaseResult {
+    /** All media as UI assets, newest first — the single source of truth. */
+    assets: CameraAsset[];
+    /** Filter-card counters computed directly from the database. */
+    counts: MediaCounts;
+    /** True during the initial load. */
+    loading: boolean;
+    /** Non-null if initialization/loading failed. */
+    error: Error | null;
+    /** Persist captured/selected assets, then refresh state from the DB. */
+    addAssets: (assets: CameraAsset[], source?: MediaSource) => Promise<CameraAsset[]>;
+    /** Delete one media item from the DB and update state. */
+    removeById: (id: string) => Promise<void>;
+    /** Delete several media items from the DB and update state. */
+    removeMany: (ids: string[]) => Promise<void>;
+    /**
+     * Securely destroy one media item's FILE and then remove its SQLCipher row.
+     *
+     * This is the deletion path to prefer over {@link removeById}, which only drops
+     * the database row and leaves the media on disk. Here the native layer measures
+     * the file's exact size, overwrites it with encrypted cryptographically secure
+     * random data 2 MB larger than that size, flushes it to storage, unlinks it, and
+     * sweeps thumbnails, cached copies and derived variants — and only then is the
+     * row deleted and the list refreshed.
+     *
+     * The row is removed even when the secure overwrite fails, because the user
+     * asked for the item to be gone; the returned report says what actually
+     * happened, and only `fullySecure` justifies telling them it was securely
+     * erased. Returns null when no row exists for `id`.
+     */
+    secureRemoveById: (id: string) => Promise<SecureDeleteResult | null>;
+    /** Re-read everything from the DB (list + counts). */
+    refresh: () => Promise<void>;
+}
+/**
+ * @param autoInit when true (default) the hook opens the DB and loads on mount.
+ */
+export declare function useMediaDatabase(autoInit?: boolean): UseMediaDatabaseResult;
+//# sourceMappingURL=useMediaDatabase.d.ts.map

package/lib/typescript/src/db/useMediaDatabase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMediaDatabase.d.ts","sourceRoot":"","sources":["../../../../src/db/useMediaDatabase.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAOhE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAUxD,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,gEAAgE;IAChE,MAAM,EAAE,WAAW,CAAC;IACpB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,wEAAwE;IACxE,SAAS,EAAE,CACT,MAAM,EAAE,WAAW,EAAE,EACrB,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5B,0DAA0D;IAC1D,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,+DAA+D;IAC/D,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C;;;;;;;;;;;;;;OAcG;IACH,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACrE,sDAAsD;IACtD,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,UAAO,GAAG,sBAAsB,CAyHxE"}

package/lib/typescript/src/defaultIcons.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Default icon implementations built entirely from React Native primitives.
+ *
+ * NO external dependencies required:
+ * - No react-native-vector-icons
+ * - No @expo/vector-icons
+ * - No react-native-svg
+ * - No custom assets or image files
+ *
+ * All icons are drawn using View and simple geometric shapes.
+ * This ensures the plugin works anywhere React Native works, with zero
+ * additional setup or configuration.
+ */
+import type { IconComponent } from './icons';
+/** X icon / close button */
+export declare const CloseIcon: IconComponent;
+/** Left arrow / back button */
+export declare const BackIcon: IconComponent;
+/** Checkmark / done button */
+export declare const DoneIcon: IconComponent;
+/** Cancel / stop button */
+export declare const CancelIcon: IconComponent;
+/** Camera icon */
+export declare const CameraIcon: IconComponent;
+/** Video/camcorder icon */
+export declare const VideoIcon: IconComponent;
+/** Photo/picture icon */
+export declare const PhotoIcon: IconComponent;
+/** Flip/mirror camera icon */
+export declare const FlipIcon: IconComponent;
+/** Flash on icon */
+export declare const FlashOnIcon: IconComponent;
+/** Flash off icon */
+export declare const FlashOffIcon: IconComponent;
+/** Flash auto icon */
+export declare const FlashAutoIcon: IconComponent;
+/** Gallery icon */
+export declare const GalleryIcon: IconComponent;
+/** Crop icon */
+export declare const CropIcon: IconComponent;
+/** Rotate icon */
+export declare const RotateIcon: IconComponent;
+/** Filter icon */
+export declare const FilterIcon: IconComponent;
+/** Sticker icon */
+export declare const StickerIcon: IconComponent;
+/** Emoji icon */
+export declare const EmojiIcon: IconComponent;
+/** Text icon */
+export declare const TextIcon: IconComponent;
+/** Draw/pencil icon */
+export declare const DrawIcon: IconComponent;
+/** Undo icon */
+export declare const UndoIcon: IconComponent;
+/** Redo icon */
+export declare const RedoIcon: IconComponent;
+/** Delete/trash icon */
+export declare const DeleteIcon: IconComponent;
+/** Play button */
+export declare const PlayIcon: IconComponent;
+/** Pause button */
+export declare const PauseIcon: IconComponent;
+/** Download icon */
+export declare const DownloadIcon: IconComponent;
+/** Share icon */
+export declare const ShareIcon: IconComponent;
+/** Send/paper plane icon */
+export declare const SendIcon: IconComponent;
+/** More/menu icon (three dots) */
+export declare const MoreIcon: IconComponent;
+/** Document icon */
+export declare const DocumentIcon: IconComponent;
+/** Audio icon */
+export declare const AudioIcon: IconComponent;
+/** Lock icon */
+export declare const LockIcon: IconComponent;
+/** Unlock icon */
+export declare const LockOpenIcon: IconComponent;
+/** Chevron up / collapse icon */
+export declare const ChevronUpIcon: IconComponent;
+/** Checkmark/check icon */
+export declare const CheckIcon: IconComponent;
+/** Volume on icon */
+export declare const VolumeOnIcon: IconComponent;
+/** Volume off / mute icon */
+export declare const VolumeOffIcon: IconComponent;
+/** Trim icon */
+export declare const TrimIcon: IconComponent;
+/** Cover/frame icon */
+export declare const CoverIcon: IconComponent;
+/** Compress icon */
+export declare const CompressIcon: IconComponent;
+/** Export icon */
+export declare const ExportIcon: IconComponent;
+/** Upload icon */
+export declare const UploadIcon: IconComponent;
+/** Plus/add icon */
+export declare const PlusIcon: IconComponent;
+/** Minus/subtract icon */
+export declare const MinusIcon: IconComponent;
+/** Stop button (square) */
+export declare const StopIcon: IconComponent;
+/** Mute icon (speaker with X) */
+export declare const MuteIcon: IconComponent;
+/** Photo-mode indicator — reuses the camera glyph. */
+export declare const PhotoModeIcon: IconComponent;
+/** Video-mode indicator — reuses the video glyph. */
+export declare const VideoModeIcon: IconComponent;
+/** Browse-audio default — reuses the audio glyph. */
+export declare const BrowseAudioIcon: IconComponent;
+/** Image+video (combined media) default — reuses the photo glyph. */
+export declare const ImageVideoIcon: IconComponent;
+/** Chevron right / disclosure icon */
+export declare const ChevronRightIcon: IconComponent;
+/** Record button — filled circle (color-driven). */
+export declare const RecordIcon: IconComponent;
+/** Warning — triangle outline with an exclamation mark. */
+export declare const WarningIcon: IconComponent;
+/** Microphone — rounded capsule head, stand arc, and base. */
+export declare const MicIcon: IconComponent;
+/**
+ * Plus icon that morphs into a Cross (✕) as [progress] animates 0 → 1.
+ * When progress is omitted or 0, renders a static Plus (+).
+ */
+export declare const PlusCloseIcon: IconComponent;
+/**
+ * Circular seek skip ring icon (◀ -10s / ▶ +10s).
+ * Renders an open-topped circular arrow ring with directional arrowhead
+ * and a centered seconds label.
+ */
+export declare const CircularSeekIcon: IconComponent;
+/**
+ * View Details / Info (ⓘ) icon.
+ * Renders an outlined circular badge with a centered 'i' glyph (dot + stem).
+ */
+export declare const ViewDetailsIcon: IconComponent;
+/** Alias for ViewDetailsIcon */
+export declare const InfoIcon: IconComponent;
+//# sourceMappingURL=defaultIcons.d.ts.map

package/lib/typescript/src/defaultIcons.d.ts.map

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

package/lib/typescript/src/deviceCapabilities.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Device capability detection for optimization
+ */
+export interface DeviceSpecs {
+    ram: 'low' | 'medium' | 'high';
+    processor: 'weak' | 'medium' | 'strong';
+    isLowEnd: boolean;
+    totalRamMb?: number;
+    availableRamMb?: number;
+    cpuCores?: number;
+}
+/**
+ * Detect device capabilities.
+ *
+ * On Android this asks the native module for ground truth (ActivityManager:
+ * isLowRamDevice / memoryClass / totalMem / availMem + CPU core count) and
+ * classifies from that. The screen-size heuristic remains only as a fallback
+ * for environments without the native module (web, tests, remote debugging).
+ */
+export declare function detectDeviceCapabilities(): Promise<DeviceSpecs>;
+/**
+ * Check if device is low-end
+ */
+export declare function isLowEndDevice(deviceSpecs: DeviceSpecs): boolean;
+/**
+ * Get optimization level based on device specs
+ */
+export declare function getOptimizationLevel(deviceSpecs: DeviceSpecs): 'aggressive' | 'moderate' | 'none';
+/**
+ * Get memory optimization settings
+ */
+export declare function getMemorySettings(deviceSpecs: DeviceSpecs): {
+    maxCacheSizeMb: number;
+    batchSize: number;
+    concurrentOperations: number;
+};
+/**
+ * Get CPU optimization settings
+ */
+export declare function getCpuSettings(deviceSpecs: DeviceSpecs): {
+    debounceMs: number;
+    throttleMs: number;
+    maxConcurrent: number;
+    useIdleCallback: boolean;
+};
+/**
+ * Get rendering optimization settings
+ */
+export declare function getRenderingSettings(deviceSpecs: DeviceSpecs): {
+    initialNumToRender: number;
+    maxToRenderPerBatch: number;
+    windowSize: number;
+    useAnimations: boolean;
+    useComplexEffects: boolean;
+};
+/**
+ * Get network optimization settings
+ */
+export declare function getNetworkSettings(deviceSpecs: DeviceSpecs): {
+    maxConcurrentUploads: number;
+    chunkSize: number;
+    compressionQuality: number;
+    retryCount: number;
+    useWiFiOnly: boolean;
+};
+/**
+ * Get image quality settings based on device
+ */
+export declare function getImageQualitySettings(deviceSpecs: DeviceSpecs): {
+    maxDimension: number;
+    compressionQuality: number;
+    previewQuality: 'low' | 'medium' | 'high';
+};
+/**
+ * Check if device specs indicate a specific optimization should be used
+ */
+export declare function shouldUseOptimization(deviceSpecs: DeviceSpecs, _optimization: 'memory' | 'cpu' | 'rendering' | 'network'): boolean;
+/**
+ * Create optimized configuration based on device specs
+ */
+export declare function createOptimizedConfig(deviceSpecs: DeviceSpecs): {
+    memory: ReturnType<typeof getMemorySettings>;
+    cpu: ReturnType<typeof getCpuSettings>;
+    rendering: ReturnType<typeof getRenderingSettings>;
+    network: ReturnType<typeof getNetworkSettings>;
+    images: ReturnType<typeof getImageQualitySettings>;
+};
+/**
+ * Fallback device specs for testing
+ */
+export declare function createTestDeviceSpecs(type?: 'low' | 'medium' | 'high'): DeviceSpecs;
+//# sourceMappingURL=deviceCapabilities.d.ts.map

package/lib/typescript/src/deviceCapabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceCapabilities.d.ts","sourceRoot":"","sources":["../../../src/deviceCapabilities.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/B,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAoDD;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,WAAW,CAAC,CAerE;AAiFD;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAMhE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,WAAW,GACvB,YAAY,GAAG,UAAU,GAAG,MAAM,CAUpC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAsBA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAyBA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG;IAC9D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;CAC5B,CA4BA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG;IAC5D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACtB,CA4BA;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,WAAW,GAAG;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC3C,CAsBA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,QAAQ,GAAG,KAAK,GAAG,WAAW,GAAG,SAAS,GACxD,OAAO,CAOT;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG;IAC/D,MAAM,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;IAC7C,GAAG,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IACvC,SAAS,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IACnD,OAAO,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IAC/C,MAAM,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;CACpD,CAQA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,GAAE,KAAK,GAAG,QAAQ,GAAG,MAAc,GACtC,WAAW,CAyBb"}