@testerpaykit/storage-browser 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,3 @@
-# Temporary Holding Version
+# @testerpaykit/storage-browser
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+IndexedDB storage (Dexie) for the TesterPayKit web SDK, so queued reports survive reloads. Used with [`@testerpaykit/react`](https://www.npmjs.com/package/@testerpaykit/react) — start there.

package/dist/index.d.mts

@@ -0,0 +1,287 @@
+import { IStorage, Where } from '@testerpaykit/core';
+import Dexie, { Table } from 'dexie';
+
+interface SessionRecord {
+    id: string;
+    started_at: number;
+    ended_at: number | null;
+    duration_seconds: number | null;
+    screen_view_count: number;
+    tap_count: number;
+    end_reason: string | null;
+    foreground_seconds: number | null;
+    metadata?: string;
+}
+interface EventRecord {
+    id: string;
+    session_id: string;
+    timestamp: number;
+    event_type: string;
+    screen_name: string | null;
+    element_id: string | null;
+    metadata: string | null;
+}
+interface OutboxRecord {
+    local_id: string;
+    type: string;
+    payload: string;
+    state: string;
+    attempts: number;
+    last_error: string | null;
+    created_at: string;
+}
+interface SdkMetaRecord {
+    key: string;
+    value: string;
+}
+interface BugReportRecord {
+    id: string;
+    session_id: string;
+    timestamp: number;
+    message: string;
+    stack: string | null;
+    severity: string;
+}
+interface FeedbackRecord {
+    id: string;
+    session_id: string;
+    content: string;
+    rating: number | null;
+    created_at: number;
+}
+interface TaskRecord {
+    id: string;
+    task_preset_id: string;
+    title: string;
+    started_at: number | null;
+    completed_at: number | null;
+    is_completed: number;
+    created_at: number;
+}
+interface WeeklySummaryRecord {
+    id: string;
+    data: string;
+    status: string;
+    created_at: number;
+}
+interface Event {
+    id?: string;
+    sessionId: string;
+    type: string;
+    timestamp: Date;
+    screenRoute?: string;
+    metadata?: string;
+}
+interface Session {
+    id?: string;
+    startedAt: Date;
+    endedAt?: Date;
+    durationSeconds?: number;
+    screenViewCount?: number;
+    tapCount?: number;
+    endReason?: string;
+    foregroundSeconds?: number;
+    metadata?: string;
+}
+interface Task {
+    id?: string;
+    taskPresetId: string;
+    title: string;
+    description?: string;
+    startedAt?: Date;
+    completedAt?: Date;
+    isCompleted?: boolean;
+    createdAt: Date;
+}
+interface Feedback {
+    id?: string;
+    sessionId?: string;
+    content: string;
+    rating?: number;
+    createdAt: Date;
+    metadata?: string;
+}
+interface Submission {
+    id?: string;
+    projectId: string;
+    testerId: string;
+    deviceId: string;
+    periodStart: Date;
+    periodEnd: Date;
+    metrics: string;
+    integrityHash: string;
+    deviceMetadata: string;
+    appMetadata: string;
+    status: string;
+    rejectionReason?: string;
+    estimatedPayout?: number;
+    actualPayout?: number;
+    createdAt: Date;
+    updatedAt: Date;
+    submittedAt?: Date;
+}
+interface BugReport {
+    id?: string;
+    sessionId: string;
+    testerId?: string;
+    type: string;
+    severity: string;
+    category: string;
+    title: string;
+    description: string;
+    affectedFeature?: string;
+    frequency?: string;
+    reproductionSteps?: string;
+    expectedBehavior?: string;
+    actualBehavior?: string;
+    currentScreen: string;
+    breadcrumbs?: string;
+    deviceSnapshot: string;
+    appSnapshot: string;
+    screenshotPath?: string;
+    annotatedScreenshotPath?: string;
+    screenRecordingPath?: string;
+    attachments?: string;
+    createdAt: Date;
+    submittedAt?: Date;
+    status?: string;
+    assignedTo?: string;
+    coordinatorNotes?: string;
+    severityConfidence?: number;
+    suggestedCategory?: string;
+    duplicateOf?: string;
+}
+interface Breadcrumb {
+    id?: string;
+    sessionId: string;
+    type: string;
+    timestamp: Date;
+    screen?: string;
+    action?: string;
+    data?: string;
+    message?: string;
+}
+interface CrashContext {
+    id?: string;
+    sessionId?: string;
+    error: string;
+    stackTrace: string;
+    breadcrumbs?: string;
+    deviceSnapshot: string;
+    appSnapshot: string;
+    crashTime: Date;
+    reported?: boolean;
+}
+interface SessionEndFeedback {
+    id?: string;
+    sessionId: string;
+    rating: number;
+    comment?: string;
+    categories?: string;
+    wouldRecommend?: boolean;
+    createdAt: Date;
+}
+interface DeviceIdMetadata {
+    id?: string;
+    deviceId: string;
+    isActive: boolean;
+    createdAt: Date;
+    expiresAt: Date;
+}
+interface TaskTracking {
+    id?: string;
+    taskId: string;
+    sessionId: string;
+    startedAt: Date;
+    completedAt?: Date;
+    abandonedAt?: Date;
+    durationSeconds?: number;
+    status: string;
+    metadata?: string;
+}
+interface WidgetAnnotation {
+    id?: string;
+    taskId: string;
+    widgetKey: string;
+    annotationType: string;
+    message: string;
+    priority: string;
+    elementBounds?: string;
+    metadata?: string;
+    createdAt: Date;
+}
+interface AnnotationInteraction {
+    id?: string;
+    sessionId: string;
+    annotationId: string;
+    taskId: string;
+    interactionType: string;
+    timestamp: Date;
+    elementBounds?: string;
+    metadata?: string;
+    inputValue?: string;
+    durationMs?: number;
+    triggeredCompletion?: boolean;
+}
+declare class TesterPayKitDB extends Dexie {
+    events: Table<Event, string>;
+    sessions: Table<Session, string>;
+    tasks: Table<Task, string>;
+    feedbacks: Table<Feedback, string>;
+    submissions: Table<Submission, string>;
+    bugReports: Table<BugReport, string>;
+    breadcrumbs: Table<Breadcrumb, string>;
+    crashContexts: Table<CrashContext, string>;
+    sessionEndFeedbacks: Table<SessionEndFeedback, string>;
+    deviceIdMetadata: Table<DeviceIdMetadata, string>;
+    taskTracking: Table<TaskTracking, string>;
+    widgetAnnotations: Table<WidgetAnnotation, string>;
+    annotationInteractions: Table<AnnotationInteraction, string>;
+    sdk_sessions: Table<SessionRecord, string>;
+    sdk_events: Table<EventRecord, string>;
+    outbox: Table<OutboxRecord, string>;
+    sdk_meta: Table<SdkMetaRecord, string>;
+    bug_reports: Table<BugReportRecord, string>;
+    sdk_feedbacks: Table<FeedbackRecord, string>;
+    sdk_tasks: Table<TaskRecord, string>;
+    weekly_summaries: Table<WeeklySummaryRecord, string>;
+    constructor();
+}
+
+/**
+ * IndexedDB storage adapter for browser environments.
+ *
+ * Implements IStorage using Dexie.js. All operations go through the typed
+ * document/collection API (insert/find/findOne/update/delete/count) — no SQL.
+ *
+ * Collection names follow COLLECTIONS constants; each maps to a dedicated
+ * Dexie object store declared in schema version 2.
+ *
+ * The legacy getDB() / transaction() methods are kept so existing direct-Dexie
+ * tests continue to work.
+ */
+declare class IndexedDBAdapter implements IStorage {
+    private db;
+    constructor();
+    init(): Promise<void>;
+    close(): Promise<void>;
+    insert<T extends Record<string, unknown>>(collection: string, record: T): Promise<void>;
+    find<T>(collection: string, where?: Where): Promise<T[]>;
+    findOne<T>(collection: string, where: Where): Promise<T | null>;
+    update(collection: string, where: Where, patch: Record<string, unknown>): Promise<number>;
+    delete(collection: string, where: Where): Promise<number>;
+    count(collection: string, where?: Where): Promise<number>;
+    transaction<T>(fn: () => Promise<T>): Promise<T>;
+    getDB(): TesterPayKitDB;
+    getVersion(): Promise<number>;
+    migrate(_targetVersion: number): Promise<void>;
+    private _table;
+    /**
+     * Return the primary key field name for a given collection.
+     * Used by delete() to retrieve the PK value from each matched record.
+     */
+    private _primaryKey;
+}
+
+export { IndexedDBAdapter, TesterPayKitDB };
+export type { AnnotationInteraction, Breadcrumb, BugReport, BugReportRecord, CrashContext, DeviceIdMetadata, Event, EventRecord, Feedback, FeedbackRecord, OutboxRecord, SdkMetaRecord, Session, SessionEndFeedback, SessionRecord, Submission, Task, TaskRecord, TaskTracking, WeeklySummaryRecord, WidgetAnnotation };

package/dist/index.d.ts

@@ -0,0 +1,287 @@
+import { IStorage, Where } from '@testerpaykit/core';
+import Dexie, { Table } from 'dexie';
+
+interface SessionRecord {
+    id: string;
+    started_at: number;
+    ended_at: number | null;
+    duration_seconds: number | null;
+    screen_view_count: number;
+    tap_count: number;
+    end_reason: string | null;
+    foreground_seconds: number | null;
+    metadata?: string;
+}
+interface EventRecord {
+    id: string;
+    session_id: string;
+    timestamp: number;
+    event_type: string;
+    screen_name: string | null;
+    element_id: string | null;
+    metadata: string | null;
+}
+interface OutboxRecord {
+    local_id: string;
+    type: string;
+    payload: string;
+    state: string;
+    attempts: number;
+    last_error: string | null;
+    created_at: string;
+}
+interface SdkMetaRecord {
+    key: string;
+    value: string;
+}
+interface BugReportRecord {
+    id: string;
+    session_id: string;
+    timestamp: number;
+    message: string;
+    stack: string | null;
+    severity: string;
+}
+interface FeedbackRecord {
+    id: string;
+    session_id: string;
+    content: string;
+    rating: number | null;
+    created_at: number;
+}
+interface TaskRecord {
+    id: string;
+    task_preset_id: string;
+    title: string;
+    started_at: number | null;
+    completed_at: number | null;
+    is_completed: number;
+    created_at: number;
+}
+interface WeeklySummaryRecord {
+    id: string;
+    data: string;
+    status: string;
+    created_at: number;
+}
+interface Event {
+    id?: string;
+    sessionId: string;
+    type: string;
+    timestamp: Date;
+    screenRoute?: string;
+    metadata?: string;
+}
+interface Session {
+    id?: string;
+    startedAt: Date;
+    endedAt?: Date;
+    durationSeconds?: number;
+    screenViewCount?: number;
+    tapCount?: number;
+    endReason?: string;
+    foregroundSeconds?: number;
+    metadata?: string;
+}
+interface Task {
+    id?: string;
+    taskPresetId: string;
+    title: string;
+    description?: string;
+    startedAt?: Date;
+    completedAt?: Date;
+    isCompleted?: boolean;
+    createdAt: Date;
+}
+interface Feedback {
+    id?: string;
+    sessionId?: string;
+    content: string;
+    rating?: number;
+    createdAt: Date;
+    metadata?: string;
+}
+interface Submission {
+    id?: string;
+    projectId: string;
+    testerId: string;
+    deviceId: string;
+    periodStart: Date;
+    periodEnd: Date;
+    metrics: string;
+    integrityHash: string;
+    deviceMetadata: string;
+    appMetadata: string;
+    status: string;
+    rejectionReason?: string;
+    estimatedPayout?: number;
+    actualPayout?: number;
+    createdAt: Date;
+    updatedAt: Date;
+    submittedAt?: Date;
+}
+interface BugReport {
+    id?: string;
+    sessionId: string;
+    testerId?: string;
+    type: string;
+    severity: string;
+    category: string;
+    title: string;
+    description: string;
+    affectedFeature?: string;
+    frequency?: string;
+    reproductionSteps?: string;
+    expectedBehavior?: string;
+    actualBehavior?: string;
+    currentScreen: string;
+    breadcrumbs?: string;
+    deviceSnapshot: string;
+    appSnapshot: string;
+    screenshotPath?: string;
+    annotatedScreenshotPath?: string;
+    screenRecordingPath?: string;
+    attachments?: string;
+    createdAt: Date;
+    submittedAt?: Date;
+    status?: string;
+    assignedTo?: string;
+    coordinatorNotes?: string;
+    severityConfidence?: number;
+    suggestedCategory?: string;
+    duplicateOf?: string;
+}
+interface Breadcrumb {
+    id?: string;
+    sessionId: string;
+    type: string;
+    timestamp: Date;
+    screen?: string;
+    action?: string;
+    data?: string;
+    message?: string;
+}
+interface CrashContext {
+    id?: string;
+    sessionId?: string;
+    error: string;
+    stackTrace: string;
+    breadcrumbs?: string;
+    deviceSnapshot: string;
+    appSnapshot: string;
+    crashTime: Date;
+    reported?: boolean;
+}
+interface SessionEndFeedback {
+    id?: string;
+    sessionId: string;
+    rating: number;
+    comment?: string;
+    categories?: string;
+    wouldRecommend?: boolean;
+    createdAt: Date;
+}
+interface DeviceIdMetadata {
+    id?: string;
+    deviceId: string;
+    isActive: boolean;
+    createdAt: Date;
+    expiresAt: Date;
+}
+interface TaskTracking {
+    id?: string;
+    taskId: string;
+    sessionId: string;
+    startedAt: Date;
+    completedAt?: Date;
+    abandonedAt?: Date;
+    durationSeconds?: number;
+    status: string;
+    metadata?: string;
+}
+interface WidgetAnnotation {
+    id?: string;
+    taskId: string;
+    widgetKey: string;
+    annotationType: string;
+    message: string;
+    priority: string;
+    elementBounds?: string;
+    metadata?: string;
+    createdAt: Date;
+}
+interface AnnotationInteraction {
+    id?: string;
+    sessionId: string;
+    annotationId: string;
+    taskId: string;
+    interactionType: string;
+    timestamp: Date;
+    elementBounds?: string;
+    metadata?: string;
+    inputValue?: string;
+    durationMs?: number;
+    triggeredCompletion?: boolean;
+}
+declare class TesterPayKitDB extends Dexie {
+    events: Table<Event, string>;
+    sessions: Table<Session, string>;
+    tasks: Table<Task, string>;
+    feedbacks: Table<Feedback, string>;
+    submissions: Table<Submission, string>;
+    bugReports: Table<BugReport, string>;
+    breadcrumbs: Table<Breadcrumb, string>;
+    crashContexts: Table<CrashContext, string>;
+    sessionEndFeedbacks: Table<SessionEndFeedback, string>;
+    deviceIdMetadata: Table<DeviceIdMetadata, string>;
+    taskTracking: Table<TaskTracking, string>;
+    widgetAnnotations: Table<WidgetAnnotation, string>;
+    annotationInteractions: Table<AnnotationInteraction, string>;
+    sdk_sessions: Table<SessionRecord, string>;
+    sdk_events: Table<EventRecord, string>;
+    outbox: Table<OutboxRecord, string>;
+    sdk_meta: Table<SdkMetaRecord, string>;
+    bug_reports: Table<BugReportRecord, string>;
+    sdk_feedbacks: Table<FeedbackRecord, string>;
+    sdk_tasks: Table<TaskRecord, string>;
+    weekly_summaries: Table<WeeklySummaryRecord, string>;
+    constructor();
+}
+
+/**
+ * IndexedDB storage adapter for browser environments.
+ *
+ * Implements IStorage using Dexie.js. All operations go through the typed
+ * document/collection API (insert/find/findOne/update/delete/count) — no SQL.
+ *
+ * Collection names follow COLLECTIONS constants; each maps to a dedicated
+ * Dexie object store declared in schema version 2.
+ *
+ * The legacy getDB() / transaction() methods are kept so existing direct-Dexie
+ * tests continue to work.
+ */
+declare class IndexedDBAdapter implements IStorage {
+    private db;
+    constructor();
+    init(): Promise<void>;
+    close(): Promise<void>;
+    insert<T extends Record<string, unknown>>(collection: string, record: T): Promise<void>;
+    find<T>(collection: string, where?: Where): Promise<T[]>;
+    findOne<T>(collection: string, where: Where): Promise<T | null>;
+    update(collection: string, where: Where, patch: Record<string, unknown>): Promise<number>;
+    delete(collection: string, where: Where): Promise<number>;
+    count(collection: string, where?: Where): Promise<number>;
+    transaction<T>(fn: () => Promise<T>): Promise<T>;
+    getDB(): TesterPayKitDB;
+    getVersion(): Promise<number>;
+    migrate(_targetVersion: number): Promise<void>;
+    private _table;
+    /**
+     * Return the primary key field name for a given collection.
+     * Used by delete() to retrieve the PK value from each matched record.
+     */
+    private _primaryKey;
+}
+
+export { IndexedDBAdapter, TesterPayKitDB };
+export type { AnnotationInteraction, Breadcrumb, BugReport, BugReportRecord, CrashContext, DeviceIdMetadata, Event, EventRecord, Feedback, FeedbackRecord, OutboxRecord, SdkMetaRecord, Session, SessionEndFeedback, SessionRecord, Submission, Task, TaskRecord, TaskTracking, WeeklySummaryRecord, WidgetAnnotation };

package/dist/index.js

@@ -0,0 +1,233 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  IndexedDBAdapter: () => IndexedDBAdapter,
+  TesterPayKitDB: () => TesterPayKitDB
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/IndexedDBAdapter.ts
+var import_core = require("@testerpaykit/core");
+
+// src/schema.ts
+var import_dexie = __toESM(require("dexie"));
+var TesterPayKitDB = class extends import_dexie.default {
+  constructor() {
+    super("TesterPayKitDB");
+    this.version(1).stores({
+      events: "++id, sessionId, timestamp, type",
+      sessions: "++id, startedAt",
+      tasks: "++id, taskPresetId, isCompleted, createdAt",
+      feedbacks: "++id, sessionId, createdAt",
+      submissions: "++id, projectId, testerId, deviceId, status, createdAt",
+      bugReports: "++id, sessionId, testerId, type, severity, status, createdAt",
+      breadcrumbs: "++id, sessionId, timestamp, type",
+      crashContexts: "++id, sessionId, crashTime, reported",
+      sessionEndFeedbacks: "++id, sessionId, createdAt",
+      deviceIdMetadata: "++id, deviceId, isActive, expiresAt",
+      taskTracking: "++id, taskId, sessionId, status, startedAt",
+      widgetAnnotations: "++id, taskId, widgetKey, createdAt",
+      annotationInteractions: "++id, sessionId, annotationId, taskId, timestamp"
+    });
+    this.version(2).stores({
+      events: "++id, sessionId, timestamp, type",
+      sessions: "++id, startedAt",
+      tasks: "++id, taskPresetId, isCompleted, createdAt",
+      feedbacks: "++id, sessionId, createdAt",
+      submissions: "++id, projectId, testerId, deviceId, status, createdAt",
+      bugReports: "++id, sessionId, testerId, type, severity, status, createdAt",
+      breadcrumbs: "++id, sessionId, timestamp, type",
+      crashContexts: "++id, sessionId, crashTime, reported",
+      sessionEndFeedbacks: "++id, sessionId, createdAt",
+      deviceIdMetadata: "++id, deviceId, isActive, expiresAt",
+      taskTracking: "++id, taskId, sessionId, status, startedAt",
+      widgetAnnotations: "++id, taskId, widgetKey, createdAt",
+      annotationInteractions: "++id, sessionId, annotationId, taskId, timestamp",
+      // SDK-core flat stores
+      sdk_sessions: "id, started_at, ended_at",
+      sdk_events: "id, session_id, timestamp, event_type",
+      outbox: "local_id, state",
+      sdk_meta: "key",
+      bug_reports: "id, session_id, timestamp, severity",
+      sdk_feedbacks: "id, session_id, created_at",
+      sdk_tasks: "id, task_preset_id, is_completed, created_at",
+      weekly_summaries: "id, status, created_at"
+    });
+  }
+};
+
+// src/IndexedDBAdapter.ts
+var COLLECTION_TO_TABLE = {
+  [import_core.COLLECTIONS.sessions]: "sdk_sessions",
+  [import_core.COLLECTIONS.events]: "sdk_events",
+  [import_core.COLLECTIONS.outbox]: "outbox",
+  [import_core.COLLECTIONS.sdkMeta]: "sdk_meta",
+  [import_core.COLLECTIONS.bugReports]: "bug_reports",
+  [import_core.COLLECTIONS.feedbacks]: "sdk_feedbacks",
+  [import_core.COLLECTIONS.tasks]: "sdk_tasks",
+  [import_core.COLLECTIONS.weeklySummaries]: "weekly_summaries"
+};
+function matchesWhere(record, where) {
+  for (const [field, condition] of Object.entries(where)) {
+    const val = record[field];
+    if (condition === null) {
+      if (val !== null && val !== void 0) return false;
+    } else if (typeof condition === "object" && !Array.isArray(condition)) {
+      const cond = condition;
+      if (cond.ne !== void 0) {
+        if (cond.ne === null) {
+          if (val === null || val === void 0) return false;
+        } else {
+          if (val === cond.ne) return false;
+        }
+      }
+      if (cond.in !== void 0) {
+        if (!cond.in.includes(val)) return false;
+      }
+    } else {
+      if (val !== condition) return false;
+    }
+  }
+  return true;
+}
+var IndexedDBAdapter = class {
+  constructor() {
+    this.db = new TesterPayKitDB();
+  }
+  // ── IStorage.init ──────────────────────────────────────────────────────────
+  async init() {
+    await this.db.open();
+  }
+  // ── IStorage.close ─────────────────────────────────────────────────────────
+  async close() {
+    this.db.close();
+  }
+  // ── IStorage.insert ────────────────────────────────────────────────────────
+  async insert(collection, record) {
+    const table = this._table(collection);
+    await table.put(record);
+  }
+  // ── IStorage.find ──────────────────────────────────────────────────────────
+  async find(collection, where) {
+    const table = this._table(collection);
+    if (!where || Object.keys(where).length === 0) {
+      return table.toArray();
+    }
+    const all = await table.toArray();
+    return all.filter(
+      (r) => matchesWhere(r, where)
+    );
+  }
+  // ── IStorage.findOne ───────────────────────────────────────────────────────
+  async findOne(collection, where) {
+    const table = this._table(collection);
+    const all = await table.toArray();
+    const match = all.find(
+      (r) => matchesWhere(r, where)
+    );
+    return match ?? null;
+  }
+  // ── IStorage.update ────────────────────────────────────────────────────────
+  async update(collection, where, patch) {
+    const table = this._table(collection);
+    const all = await table.toArray();
+    const matches = all.filter(
+      (r) => matchesWhere(r, where)
+    );
+    for (const record of matches) {
+      const updated = { ...record, ...patch };
+      await table.put(updated);
+    }
+    return matches.length;
+  }
+  // ── IStorage.delete ────────────────────────────────────────────────────────
+  async delete(collection, where) {
+    const table = this._table(collection);
+    const pk = this._primaryKey(collection);
+    const all = await table.toArray();
+    const matches = all.filter(
+      (r) => matchesWhere(r, where)
+    );
+    for (const record of matches) {
+      const key = record[pk];
+      await table.delete(key);
+    }
+    return matches.length;
+  }
+  // ── IStorage.count ─────────────────────────────────────────────────────────
+  async count(collection, where) {
+    if (!where || Object.keys(where).length === 0) {
+      return this._table(collection).count();
+    }
+    const rows = await this.find(collection, where);
+    return rows.length;
+  }
+  // ── Legacy helpers (kept for existing direct-Dexie tests) ──────────────────
+  async transaction(fn) {
+    return this.db.transaction("rw", this.db.tables, fn);
+  }
+  getDB() {
+    return this.db;
+  }
+  async getVersion() {
+    return this.db.verno;
+  }
+  async migrate(_targetVersion) {
+  }
+  // ── Private helpers ─────────────────────────────────────────────────────────
+  _table(collection) {
+    const prop = COLLECTION_TO_TABLE[collection];
+    if (!prop) {
+      throw new Error(`Unknown collection: ${collection}`);
+    }
+    return this.db[prop];
+  }
+  /**
+   * Return the primary key field name for a given collection.
+   * Used by delete() to retrieve the PK value from each matched record.
+   */
+  _primaryKey(collection) {
+    switch (collection) {
+      case import_core.COLLECTIONS.outbox:
+        return "local_id";
+      case import_core.COLLECTIONS.sdkMeta:
+        return "key";
+      default:
+        return "id";
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  IndexedDBAdapter,
+  TesterPayKitDB
+});

package/dist/index.mjs

@@ -0,0 +1,195 @@
+// src/IndexedDBAdapter.ts
+import { COLLECTIONS } from "@testerpaykit/core";
+
+// src/schema.ts
+import Dexie from "dexie";
+var TesterPayKitDB = class extends Dexie {
+  constructor() {
+    super("TesterPayKitDB");
+    this.version(1).stores({
+      events: "++id, sessionId, timestamp, type",
+      sessions: "++id, startedAt",
+      tasks: "++id, taskPresetId, isCompleted, createdAt",
+      feedbacks: "++id, sessionId, createdAt",
+      submissions: "++id, projectId, testerId, deviceId, status, createdAt",
+      bugReports: "++id, sessionId, testerId, type, severity, status, createdAt",
+      breadcrumbs: "++id, sessionId, timestamp, type",
+      crashContexts: "++id, sessionId, crashTime, reported",
+      sessionEndFeedbacks: "++id, sessionId, createdAt",
+      deviceIdMetadata: "++id, deviceId, isActive, expiresAt",
+      taskTracking: "++id, taskId, sessionId, status, startedAt",
+      widgetAnnotations: "++id, taskId, widgetKey, createdAt",
+      annotationInteractions: "++id, sessionId, annotationId, taskId, timestamp"
+    });
+    this.version(2).stores({
+      events: "++id, sessionId, timestamp, type",
+      sessions: "++id, startedAt",
+      tasks: "++id, taskPresetId, isCompleted, createdAt",
+      feedbacks: "++id, sessionId, createdAt",
+      submissions: "++id, projectId, testerId, deviceId, status, createdAt",
+      bugReports: "++id, sessionId, testerId, type, severity, status, createdAt",
+      breadcrumbs: "++id, sessionId, timestamp, type",
+      crashContexts: "++id, sessionId, crashTime, reported",
+      sessionEndFeedbacks: "++id, sessionId, createdAt",
+      deviceIdMetadata: "++id, deviceId, isActive, expiresAt",
+      taskTracking: "++id, taskId, sessionId, status, startedAt",
+      widgetAnnotations: "++id, taskId, widgetKey, createdAt",
+      annotationInteractions: "++id, sessionId, annotationId, taskId, timestamp",
+      // SDK-core flat stores
+      sdk_sessions: "id, started_at, ended_at",
+      sdk_events: "id, session_id, timestamp, event_type",
+      outbox: "local_id, state",
+      sdk_meta: "key",
+      bug_reports: "id, session_id, timestamp, severity",
+      sdk_feedbacks: "id, session_id, created_at",
+      sdk_tasks: "id, task_preset_id, is_completed, created_at",
+      weekly_summaries: "id, status, created_at"
+    });
+  }
+};
+
+// src/IndexedDBAdapter.ts
+var COLLECTION_TO_TABLE = {
+  [COLLECTIONS.sessions]: "sdk_sessions",
+  [COLLECTIONS.events]: "sdk_events",
+  [COLLECTIONS.outbox]: "outbox",
+  [COLLECTIONS.sdkMeta]: "sdk_meta",
+  [COLLECTIONS.bugReports]: "bug_reports",
+  [COLLECTIONS.feedbacks]: "sdk_feedbacks",
+  [COLLECTIONS.tasks]: "sdk_tasks",
+  [COLLECTIONS.weeklySummaries]: "weekly_summaries"
+};
+function matchesWhere(record, where) {
+  for (const [field, condition] of Object.entries(where)) {
+    const val = record[field];
+    if (condition === null) {
+      if (val !== null && val !== void 0) return false;
+    } else if (typeof condition === "object" && !Array.isArray(condition)) {
+      const cond = condition;
+      if (cond.ne !== void 0) {
+        if (cond.ne === null) {
+          if (val === null || val === void 0) return false;
+        } else {
+          if (val === cond.ne) return false;
+        }
+      }
+      if (cond.in !== void 0) {
+        if (!cond.in.includes(val)) return false;
+      }
+    } else {
+      if (val !== condition) return false;
+    }
+  }
+  return true;
+}
+var IndexedDBAdapter = class {
+  constructor() {
+    this.db = new TesterPayKitDB();
+  }
+  // ── IStorage.init ──────────────────────────────────────────────────────────
+  async init() {
+    await this.db.open();
+  }
+  // ── IStorage.close ─────────────────────────────────────────────────────────
+  async close() {
+    this.db.close();
+  }
+  // ── IStorage.insert ────────────────────────────────────────────────────────
+  async insert(collection, record) {
+    const table = this._table(collection);
+    await table.put(record);
+  }
+  // ── IStorage.find ──────────────────────────────────────────────────────────
+  async find(collection, where) {
+    const table = this._table(collection);
+    if (!where || Object.keys(where).length === 0) {
+      return table.toArray();
+    }
+    const all = await table.toArray();
+    return all.filter(
+      (r) => matchesWhere(r, where)
+    );
+  }
+  // ── IStorage.findOne ───────────────────────────────────────────────────────
+  async findOne(collection, where) {
+    const table = this._table(collection);
+    const all = await table.toArray();
+    const match = all.find(
+      (r) => matchesWhere(r, where)
+    );
+    return match ?? null;
+  }
+  // ── IStorage.update ────────────────────────────────────────────────────────
+  async update(collection, where, patch) {
+    const table = this._table(collection);
+    const all = await table.toArray();
+    const matches = all.filter(
+      (r) => matchesWhere(r, where)
+    );
+    for (const record of matches) {
+      const updated = { ...record, ...patch };
+      await table.put(updated);
+    }
+    return matches.length;
+  }
+  // ── IStorage.delete ────────────────────────────────────────────────────────
+  async delete(collection, where) {
+    const table = this._table(collection);
+    const pk = this._primaryKey(collection);
+    const all = await table.toArray();
+    const matches = all.filter(
+      (r) => matchesWhere(r, where)
+    );
+    for (const record of matches) {
+      const key = record[pk];
+      await table.delete(key);
+    }
+    return matches.length;
+  }
+  // ── IStorage.count ─────────────────────────────────────────────────────────
+  async count(collection, where) {
+    if (!where || Object.keys(where).length === 0) {
+      return this._table(collection).count();
+    }
+    const rows = await this.find(collection, where);
+    return rows.length;
+  }
+  // ── Legacy helpers (kept for existing direct-Dexie tests) ──────────────────
+  async transaction(fn) {
+    return this.db.transaction("rw", this.db.tables, fn);
+  }
+  getDB() {
+    return this.db;
+  }
+  async getVersion() {
+    return this.db.verno;
+  }
+  async migrate(_targetVersion) {
+  }
+  // ── Private helpers ─────────────────────────────────────────────────────────
+  _table(collection) {
+    const prop = COLLECTION_TO_TABLE[collection];
+    if (!prop) {
+      throw new Error(`Unknown collection: ${collection}`);
+    }
+    return this.db[prop];
+  }
+  /**
+   * Return the primary key field name for a given collection.
+   * Used by delete() to retrieve the PK value from each matched record.
+   */
+  _primaryKey(collection) {
+    switch (collection) {
+      case COLLECTIONS.outbox:
+        return "local_id";
+      case COLLECTIONS.sdkMeta:
+        return "key";
+      default:
+        return "id";
+    }
+  }
+};
+export {
+  IndexedDBAdapter,
+  TesterPayKitDB
+};

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@testerpaykit/storage-browser",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "description": "IndexedDB storage adapter for TesterPayKit SDK",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "dexie": "^4.4.6",
+    "@testerpaykit/core": "1.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.5",
+    "fake-indexeddb": "^6.2.6",
+    "jsdom": "^30.1.3",
+    "tsup": "^9.0.0",
+    "typescript": "^6.0.3",
+    "vitest": "^5.0.5"
+  },
+  "keywords": [
+    "testerpaykit",
+    "storage",
+    "indexeddb",
+    "browser",
+    "typescript"
+  ],
+  "author": "TesterPayKit Team",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "test": "vitest",
+    "lint": "eslint src --ext .ts"
+  }
 }