lowdata 0.1.0 → 0.2.0

package/dist/{types--FRrBa-i.d.cts → types-D6fjl8Wy.d.cts}

@@ -35,5 +35,26 @@ interface LowdataRequestError extends Error {
     attempt: number;
     retryAfterMs?: number;
 }
+/**
+ * Where an internal, otherwise-silent failure originated:
+ *  - `'db-open'`: IndexedDB itself couldn't be opened (SSR, unsupported/locked-down browser) —
+ *    persistence is now permanently disabled for this session; lowdata falls back to an
+ *    in-memory queue/draft store.
+ *  - `'db-operation'`: a single IndexedDB operation failed (e.g. a transient
+ *    `QuotaExceededError`, a blocked transaction) — persistence is still available; only that
+ *    one call fell back to memory.
+ *  - `'sync'`: the background sync loop hit an error outside of a single queued item's own
+ *    retry accounting (e.g. it couldn't acquire the shared database or the cross-tab lock).
+ */
+type LowdataErrorScope = 'db-open' | 'db-operation' | 'sync';
+/**
+ * Optional escape hatch for otherwise-silent internal failures. lowdata deliberately never lets
+ * these throw — a failed background sync or a degraded-to-memory fallback shouldn't crash the
+ * host app — but a production app still needs a way to *see* it happened (log it, alert on it),
+ * rather than it vanishing into a single `console.warn`.
+ */
+type LowdataErrorHandler = (error: unknown, context: {
+    scope: LowdataErrorScope;
+}) => void;
 
-export type { ConnectionInfo as C, JitterStrategy as J, LowdataRequestError as L, RequestPriority as R, Unsubscribe as U, ConnectionListener as a, ConnectionQuality as b, RetryBackoffConfig as c };
+export type { ConnectionInfo as C, JitterStrategy as J, LowdataErrorHandler as L, RequestPriority as R, Unsubscribe as U, ConnectionListener as a, ConnectionQuality as b, LowdataErrorScope as c, RetryBackoffConfig as d, LowdataRequestError as e };

package/dist/{types--FRrBa-i.d.ts → types-D6fjl8Wy.d.ts}

@@ -35,5 +35,26 @@ interface LowdataRequestError extends Error {
     attempt: number;
     retryAfterMs?: number;
 }
+/**
+ * Where an internal, otherwise-silent failure originated:
+ *  - `'db-open'`: IndexedDB itself couldn't be opened (SSR, unsupported/locked-down browser) —
+ *    persistence is now permanently disabled for this session; lowdata falls back to an
+ *    in-memory queue/draft store.
+ *  - `'db-operation'`: a single IndexedDB operation failed (e.g. a transient
+ *    `QuotaExceededError`, a blocked transaction) — persistence is still available; only that
+ *    one call fell back to memory.
+ *  - `'sync'`: the background sync loop hit an error outside of a single queued item's own
+ *    retry accounting (e.g. it couldn't acquire the shared database or the cross-tab lock).
+ */
+type LowdataErrorScope = 'db-open' | 'db-operation' | 'sync';
+/**
+ * Optional escape hatch for otherwise-silent internal failures. lowdata deliberately never lets
+ * these throw — a failed background sync or a degraded-to-memory fallback shouldn't crash the
+ * host app — but a production app still needs a way to *see* it happened (log it, alert on it),
+ * rather than it vanishing into a single `console.warn`.
+ */
+type LowdataErrorHandler = (error: unknown, context: {
+    scope: LowdataErrorScope;
+}) => void;
 
-export type { ConnectionInfo as C, JitterStrategy as J, LowdataRequestError as L, RequestPriority as R, Unsubscribe as U, ConnectionListener as a, ConnectionQuality as b, RetryBackoffConfig as c };
+export type { ConnectionInfo as C, JitterStrategy as J, LowdataErrorHandler as L, RequestPriority as R, Unsubscribe as U, ConnectionListener as a, ConnectionQuality as b, LowdataErrorScope as c, RetryBackoffConfig as d, LowdataRequestError as e };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lowdata",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Resilience for the other half of the internet: automatic retries, an offline request queue, and bandwidth-aware media for web apps on poor connections.",
   "keywords": [
     "offline",
@@ -16,6 +16,15 @@
     "pwa"
   ],
   "license": "MIT",
+  "author": "",
+  "homepage": "https://github.com/bassmoses/lowdata#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bassmoses/lowdata.git"
+  },
+  "bugs": {
+    "url": "https://github.com/bassmoses/lowdata/issues"
+  },
   "type": "module",
   "sideEffects": false,
   "main": "./dist/index.cjs",
@@ -55,17 +64,23 @@
   "engines": {
     "node": ">=18"
   },
+  "packageManager": "pnpm@11.9.0",
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
+    "test:e2e": "playwright test",
     "typecheck": "tsc --noEmit",
     "lint": "eslint . --ext .ts,.tsx",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
-    "prepublishOnly": "pnpm typecheck && pnpm build && pnpm test"
+    "prepublishOnly": "pnpm typecheck && pnpm build && pnpm test",
+    "release": "semantic-release"
   },
   "peerDependencies": {
     "react": ">=17"
@@ -76,6 +91,9 @@
     }
   },
   "devDependencies": {
+    "@playwright/test": "^1.62.1",
+    "@semantic-release/changelog": "^7.0.0",
+    "@semantic-release/git": "^11.0.1",
     "@testing-library/react": "^16.0.1",
     "@types/node": "^20.16.11",
     "@types/react": "^18.3.11",
@@ -90,6 +108,8 @@
     "prettier": "^3.3.3",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
+    "semantic-release": "^25.0.9",
+    "serve": "^14.2.6",
     "tsup": "^8.3.0",
     "typescript": "^5.6.3",
     "vitest": "^2.1.2"