@techfinityedge/koolbase-react-native 2.1.0 → 2.2.0

package/README.md

@@ -162,6 +162,20 @@ await Koolbase.db.update('record-id', { title: 'Updated' });
 await Koolbase.db.delete('record-id');
 ```
 
+### Handling unique-constraint conflicts
+
+  A write that would violate a unique constraint throws `KoolbaseConflictError`:
+
+  \`\`\`ts
+  try {
+    await koolbase.db.upsert('users', { email }, { name });
+  } catch (e) {
+    if (e instanceof KoolbaseConflictError) {
+      showError('That email is already registered.');
+    }
+  }
+  \`\`\`
+
 ### Upsert
 
 Insert a record, or update the existing one matching a filter.

package/dist/database-errors.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Thrown when a write is rejected because the value would violate a
+ * collection's unique constraint — the server responds with 409 Conflict.
+ * Catch it to handle duplicates, e.g. an email or username already in use.
+ *
+ * Currently surfaced by `upsert` (the online-only write). `insert` and
+ * `update` are optimistic/offline-first: they accept the write locally and
+ * sync in the background, so a constraint conflict on those paths is a
+ * sync-time concern rather than a thrown error.
+ *
+ * @example
+ * try {
+ *   await koolbase.db.upsert('users', { email }, { name });
+ * } catch (e) {
+ *   if (e instanceof KoolbaseConflictError) {
+ *     showError('That email is already registered.');
+ *   }
+ * }
+ */
+export declare class KoolbaseConflictError extends Error {
+    code: string;
+    constructor(message?: string);
+}

package/dist/database-errors.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KoolbaseConflictError = void 0;
+/**
+ * Thrown when a write is rejected because the value would violate a
+ * collection's unique constraint — the server responds with 409 Conflict.
+ * Catch it to handle duplicates, e.g. an email or username already in use.
+ *
+ * Currently surfaced by `upsert` (the online-only write). `insert` and
+ * `update` are optimistic/offline-first: they accept the write locally and
+ * sync in the background, so a constraint conflict on those paths is a
+ * sync-time concern rather than a thrown error.
+ *
+ * @example
+ * try {
+ *   await koolbase.db.upsert('users', { email }, { name });
+ * } catch (e) {
+ *   if (e instanceof KoolbaseConflictError) {
+ *     showError('That email is already registered.');
+ *   }
+ * }
+ */
+class KoolbaseConflictError extends Error {
+    constructor(message) {
+        super(message ?? 'Value violates a unique constraint');
+        this.code = 'unique_violation';
+        this.name = 'KoolbaseConflictError';
+        Object.setPrototypeOf(this, KoolbaseConflictError.prototype);
+    }
+}
+exports.KoolbaseConflictError = KoolbaseConflictError;

package/dist/database.js

@@ -4,6 +4,7 @@ exports.KoolbaseDatabase = void 0;
 const cache_store_1 = require("./cache-store");
 const sync_engine_1 = require("./sync-engine");
 const record_1 = require("./record");
+const database_errors_1 = require("./database-errors");
 function generateId() {
     return 'local_' + Math.random().toString(36).slice(2) + Date.now().toString(36);
 }
@@ -121,6 +122,9 @@ class KoolbaseDatabase {
         });
         const body = await res.json();
         if (!res.ok) {
+            if (res.status === 409) {
+                throw new database_errors_1.KoolbaseConflictError(body.error);
+            }
             throw new Error(body.error ?? `Upsert failed: ${res.status}`);
         }
         const created = res.status === 201;

package/dist/index.d.ts

@@ -18,6 +18,7 @@ import { KoolbaseStorage } from './storage';
 import { KoolbaseConfig, VersionCheckResult } from './types';
 export * from './types';
 export * from './auth-errors';
+export * from './database-errors';
 export { KoolbaseAuth, KoolbaseDatabase, KoolbaseFlags, KoolbaseFunctions, KoolbaseRealtime, KoolbaseStorage };
 export declare const Koolbase: {
     initialize(config: KoolbaseConfig): Promise<void>;

package/dist/index.js

@@ -45,6 +45,7 @@ const storage_1 = require("./storage");
 Object.defineProperty(exports, "KoolbaseStorage", { enumerable: true, get: function () { return storage_1.KoolbaseStorage; } });
 __exportStar(require("./types"), exports);
 __exportStar(require("./auth-errors"), exports);
+__exportStar(require("./database-errors"), exports);
 let _auth = null;
 let _db = null;
 let _storage = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@techfinityedge/koolbase-react-native",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "React Native SDK for Koolbase \u2014 auth, database, storage, realtime, feature flags, and functions in one package.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",