@taladb/react-native 0.9.2 → 0.9.4

package/cpp/TalaDBHostObject.cpp

@@ -241,6 +241,7 @@ Value TalaDBHostObject::awaitJobAsPromise(Runtime &rt, TalaDbJob *job, bool pars
 std::vector<PropNameID> TalaDBHostObject::getPropertyNames(Runtime &rt) {
     std::vector<std::string> names = {
         "insert", "insertMany",
+        "replaceManyWithIds", "deleteManyWithIds",
         "find", "findOne",
         "updateOne", "updateMany",
         "deleteOne", "deleteMany",
@@ -313,6 +314,46 @@ Value TalaDBHostObject::get(Runtime &rt, const PropNameID &propName) {
             });
     }
 
+    // ------------------------------------------------------------------
+    // replaceManyWithIds(collection: string, docs: object[], origin: string): string[]
+    // ------------------------------------------------------------------
+    if (name == "replaceManyWithIds") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "replaceManyWithIds"), 3,
+            [this](Runtime &rt, const Value &, const Value *args, size_t count) -> Value {
+                if (count < 3) throw JSError(rt, "replaceManyWithIds requires 3 arguments");
+                auto col      = args[0].getString(rt).utf8(rt);
+                auto docsJson = stringify(rt, args[1]);
+                auto origin   = args[2].getString(rt).utf8(rt);
+                char *result  = taladb_replace_many_with_ids(
+                    db_, col.c_str(), docsJson.c_str(), origin.c_str());
+                if (!result) throw ffiError(rt, "taladb_replace_many_with_ids failed");
+                std::string json(result);
+                taladb_free_string(result);
+                return parse(rt, json);
+            });
+    }
+
+    // ------------------------------------------------------------------
+    // deleteManyWithIds(collection: string, ids: string[], origin: string): number
+    // ------------------------------------------------------------------
+    if (name == "deleteManyWithIds") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "deleteManyWithIds"), 3,
+            [this](Runtime &rt, const Value &, const Value *args, size_t count) -> Value {
+                if (count < 3) throw JSError(rt, "deleteManyWithIds requires 3 arguments");
+                auto col     = args[0].getString(rt).utf8(rt);
+                auto idsJson = stringify(rt, args[1]);
+                auto origin  = args[2].getString(rt).utf8(rt);
+                char *result = taladb_delete_many_with_ids(
+                    db_, col.c_str(), idsJson.c_str(), origin.c_str());
+                if (!result) throw ffiError(rt, "taladb_delete_many_with_ids failed");
+                std::string json(result);
+                taladb_free_string(result);
+                return parse(rt, json);
+            });
+    }
+
     // ------------------------------------------------------------------
     // find(collection: string, filter: object | null): object[]
     // ------------------------------------------------------------------

package/cpp/taladb.h

@@ -79,6 +79,39 @@ char *taladb_insert_many(TalaDbHandle *handle,
                          const char   *collection,
                          const char   *docs_json);
 
+/* -------------------------------------------------------------------------
+ * Replication writes — id-addressed upsert / delete
+ * ---------------------------------------------------------------------- */
+
+/**
+ * Upsert many documents by caller-supplied `_id`, in one commit.
+ *
+ * Unlike taladb_insert_many(), which discards `_id` and mints a fresh ULID, this
+ * honours the id on each document — which is what makes a replication upsert
+ * idempotent across repeated fetches of the same remote row.
+ *
+ * `origin` is "remote" (authoritative rows replicated in from an origin) or
+ * "local" (ordinary user writes). Remote rows are marked so they never replicate
+ * back out.
+ *
+ * Returns a JSON array of ULID strings, or NULL on error.
+ * Caller must free with taladb_free_string().
+ */
+char *taladb_replace_many_with_ids(TalaDbHandle *handle,
+                                   const char   *collection,
+                                   const char   *docs_json,
+                                   const char   *origin);
+
+/**
+ * Delete many documents by id, in one commit.
+ * Returns a JSON number (the count removed), or NULL on error.
+ * Caller must free with taladb_free_string().
+ */
+char *taladb_delete_many_with_ids(TalaDbHandle *handle,
+                                  const char   *collection,
+                                  const char   *ids_json,
+                                  const char   *origin);
+
 /* -------------------------------------------------------------------------
  * Find
  * ---------------------------------------------------------------------- */

package/ios/TalaDBFfi.xcframework/ios-arm64/Headers/TalaDBHostObject.cpp

@@ -241,6 +241,7 @@ Value TalaDBHostObject::awaitJobAsPromise(Runtime &rt, TalaDbJob *job, bool pars
 std::vector<PropNameID> TalaDBHostObject::getPropertyNames(Runtime &rt) {
     std::vector<std::string> names = {
         "insert", "insertMany",
+        "replaceManyWithIds", "deleteManyWithIds",
         "find", "findOne",
         "updateOne", "updateMany",
         "deleteOne", "deleteMany",
@@ -313,6 +314,46 @@ Value TalaDBHostObject::get(Runtime &rt, const PropNameID &propName) {
             });
     }
 
+    // ------------------------------------------------------------------
+    // replaceManyWithIds(collection: string, docs: object[], origin: string): string[]
+    // ------------------------------------------------------------------
+    if (name == "replaceManyWithIds") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "replaceManyWithIds"), 3,
+            [this](Runtime &rt, const Value &, const Value *args, size_t count) -> Value {
+                if (count < 3) throw JSError(rt, "replaceManyWithIds requires 3 arguments");
+                auto col      = args[0].getString(rt).utf8(rt);
+                auto docsJson = stringify(rt, args[1]);
+                auto origin   = args[2].getString(rt).utf8(rt);
+                char *result  = taladb_replace_many_with_ids(
+                    db_, col.c_str(), docsJson.c_str(), origin.c_str());
+                if (!result) throw ffiError(rt, "taladb_replace_many_with_ids failed");
+                std::string json(result);
+                taladb_free_string(result);
+                return parse(rt, json);
+            });
+    }
+
+    // ------------------------------------------------------------------
+    // deleteManyWithIds(collection: string, ids: string[], origin: string): number
+    // ------------------------------------------------------------------
+    if (name == "deleteManyWithIds") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "deleteManyWithIds"), 3,
+            [this](Runtime &rt, const Value &, const Value *args, size_t count) -> Value {
+                if (count < 3) throw JSError(rt, "deleteManyWithIds requires 3 arguments");
+                auto col     = args[0].getString(rt).utf8(rt);
+                auto idsJson = stringify(rt, args[1]);
+                auto origin  = args[2].getString(rt).utf8(rt);
+                char *result = taladb_delete_many_with_ids(
+                    db_, col.c_str(), idsJson.c_str(), origin.c_str());
+                if (!result) throw ffiError(rt, "taladb_delete_many_with_ids failed");
+                std::string json(result);
+                taladb_free_string(result);
+                return parse(rt, json);
+            });
+    }
+
     // ------------------------------------------------------------------
     // find(collection: string, filter: object | null): object[]
     // ------------------------------------------------------------------

package/ios/TalaDBFfi.xcframework/ios-arm64/Headers/taladb.h

@@ -79,6 +79,39 @@ char *taladb_insert_many(TalaDbHandle *handle,
                          const char   *collection,
                          const char   *docs_json);
 
+/* -------------------------------------------------------------------------
+ * Replication writes — id-addressed upsert / delete
+ * ---------------------------------------------------------------------- */
+
+/**
+ * Upsert many documents by caller-supplied `_id`, in one commit.
+ *
+ * Unlike taladb_insert_many(), which discards `_id` and mints a fresh ULID, this
+ * honours the id on each document — which is what makes a replication upsert
+ * idempotent across repeated fetches of the same remote row.
+ *
+ * `origin` is "remote" (authoritative rows replicated in from an origin) or
+ * "local" (ordinary user writes). Remote rows are marked so they never replicate
+ * back out.
+ *
+ * Returns a JSON array of ULID strings, or NULL on error.
+ * Caller must free with taladb_free_string().
+ */
+char *taladb_replace_many_with_ids(TalaDbHandle *handle,
+                                   const char   *collection,
+                                   const char   *docs_json,
+                                   const char   *origin);
+
+/**
+ * Delete many documents by id, in one commit.
+ * Returns a JSON number (the count removed), or NULL on error.
+ * Caller must free with taladb_free_string().
+ */
+char *taladb_delete_many_with_ids(TalaDbHandle *handle,
+                                  const char   *collection,
+                                  const char   *ids_json,
+                                  const char   *origin);
+
 /* -------------------------------------------------------------------------
  * Find
  * ---------------------------------------------------------------------- */

package/ios/TalaDBFfi.xcframework/ios-arm64_x86_64-simulator/Headers/TalaDBHostObject.cpp

@@ -241,6 +241,7 @@ Value TalaDBHostObject::awaitJobAsPromise(Runtime &rt, TalaDbJob *job, bool pars
 std::vector<PropNameID> TalaDBHostObject::getPropertyNames(Runtime &rt) {
     std::vector<std::string> names = {
         "insert", "insertMany",
+        "replaceManyWithIds", "deleteManyWithIds",
         "find", "findOne",
         "updateOne", "updateMany",
         "deleteOne", "deleteMany",
@@ -313,6 +314,46 @@ Value TalaDBHostObject::get(Runtime &rt, const PropNameID &propName) {
             });
     }
 
+    // ------------------------------------------------------------------
+    // replaceManyWithIds(collection: string, docs: object[], origin: string): string[]
+    // ------------------------------------------------------------------
+    if (name == "replaceManyWithIds") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "replaceManyWithIds"), 3,
+            [this](Runtime &rt, const Value &, const Value *args, size_t count) -> Value {
+                if (count < 3) throw JSError(rt, "replaceManyWithIds requires 3 arguments");
+                auto col      = args[0].getString(rt).utf8(rt);
+                auto docsJson = stringify(rt, args[1]);
+                auto origin   = args[2].getString(rt).utf8(rt);
+                char *result  = taladb_replace_many_with_ids(
+                    db_, col.c_str(), docsJson.c_str(), origin.c_str());
+                if (!result) throw ffiError(rt, "taladb_replace_many_with_ids failed");
+                std::string json(result);
+                taladb_free_string(result);
+                return parse(rt, json);
+            });
+    }
+
+    // ------------------------------------------------------------------
+    // deleteManyWithIds(collection: string, ids: string[], origin: string): number
+    // ------------------------------------------------------------------
+    if (name == "deleteManyWithIds") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "deleteManyWithIds"), 3,
+            [this](Runtime &rt, const Value &, const Value *args, size_t count) -> Value {
+                if (count < 3) throw JSError(rt, "deleteManyWithIds requires 3 arguments");
+                auto col     = args[0].getString(rt).utf8(rt);
+                auto idsJson = stringify(rt, args[1]);
+                auto origin  = args[2].getString(rt).utf8(rt);
+                char *result = taladb_delete_many_with_ids(
+                    db_, col.c_str(), idsJson.c_str(), origin.c_str());
+                if (!result) throw ffiError(rt, "taladb_delete_many_with_ids failed");
+                std::string json(result);
+                taladb_free_string(result);
+                return parse(rt, json);
+            });
+    }
+
     // ------------------------------------------------------------------
     // find(collection: string, filter: object | null): object[]
     // ------------------------------------------------------------------

package/ios/TalaDBFfi.xcframework/ios-arm64_x86_64-simulator/Headers/taladb.h

@@ -79,6 +79,39 @@ char *taladb_insert_many(TalaDbHandle *handle,
                          const char   *collection,
                          const char   *docs_json);
 
+/* -------------------------------------------------------------------------
+ * Replication writes — id-addressed upsert / delete
+ * ---------------------------------------------------------------------- */
+
+/**
+ * Upsert many documents by caller-supplied `_id`, in one commit.
+ *
+ * Unlike taladb_insert_many(), which discards `_id` and mints a fresh ULID, this
+ * honours the id on each document — which is what makes a replication upsert
+ * idempotent across repeated fetches of the same remote row.
+ *
+ * `origin` is "remote" (authoritative rows replicated in from an origin) or
+ * "local" (ordinary user writes). Remote rows are marked so they never replicate
+ * back out.
+ *
+ * Returns a JSON array of ULID strings, or NULL on error.
+ * Caller must free with taladb_free_string().
+ */
+char *taladb_replace_many_with_ids(TalaDbHandle *handle,
+                                   const char   *collection,
+                                   const char   *docs_json,
+                                   const char   *origin);
+
+/**
+ * Delete many documents by id, in one commit.
+ * Returns a JSON number (the count removed), or NULL on error.
+ * Caller must free with taladb_free_string().
+ */
+char *taladb_delete_many_with_ids(TalaDbHandle *handle,
+                                  const char   *collection,
+                                  const char   *ids_json,
+                                  const char   *origin);
+
 /* -------------------------------------------------------------------------
  * Find
  * ---------------------------------------------------------------------- */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taladb/react-native",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "description": "TalaDB React Native module — document and vector database via JSI HostObject",
   "main": "src/index",
   "types": "src/index.tsx",

package/src/NativeTalaDB.ts

@@ -31,6 +31,29 @@ export interface Spec extends TurboModule {
   /** Insert multiple documents. Returns an array of ULID string ids. */
   insertMany(collection: string, docs: Object[]): string[];
 
+  /**
+   * Upsert many documents **by caller-supplied `_id`**, in one commit.
+   *
+   * Unlike `insertMany`, which discards `_id` and mints a fresh ULID, this honours
+   * the id on each document — which is what makes a replication upsert idempotent
+   * across repeated fetches of the same remote row.
+   *
+   * `origin` is `'remote'` for authoritative rows replicated in from an origin, or
+   * `'local'` for ordinary user writes.
+   */
+  replaceManyWithIds(
+    collection: string,
+    docs: Object[],
+    origin: 'local' | 'remote',
+  ): string[];
+
+  /** Delete many documents by id, in one commit. Returns the number removed. */
+  deleteManyWithIds(
+    collection: string,
+    ids: string[],
+    origin: 'local' | 'remote',
+  ): number;
+
   /** Find documents matching the filter. */
   find(collection: string, filter: Object | null): Object[];
 

package/src/index.tsx

@@ -56,6 +56,16 @@ export type Update = Record<string, unknown>;
 export interface Collection<T extends Document = Document> {
   insert(doc: Omit<T, '_id'>): string;
   insertMany(docs: Omit<T, '_id'>[]): string[];
+  /**
+   * Upsert many documents **by `_id`**, in one commit. Requires an `_id` on every
+   * document — for replicated rows that comes from `deriveDocId(collection, key)`.
+   *
+   * `origin: 'remote'` marks rows as replicated in from an authoritative origin so
+   * they are never replicated back out; it defaults to `'local'`.
+   */
+  replaceManyWithIds(docs: T[], origin?: 'local' | 'remote'): string[];
+  /** Delete many documents by id, in one commit. Returns the number removed. */
+  deleteManyWithIds(ids: string[], origin?: 'local' | 'remote'): number;
   find(filter?: Filter): T[];
   findOne(filter: Filter): T | null;
   updateOne(filter: Filter, update: Update): boolean;
@@ -79,6 +89,16 @@ export interface DB {
 interface JsiTalaDB {
   insert(collection: string, doc: Object): string;
   insertMany(collection: string, docs: Object[]): string[];
+  replaceManyWithIds(
+    collection: string,
+    docs: Object[],
+    origin: 'local' | 'remote',
+  ): string[];
+  deleteManyWithIds(
+    collection: string,
+    ids: string[],
+    origin: 'local' | 'remote',
+  ): number;
   find(collection: string, filter: Object | null): Object[];
   findOne(collection: string, filter: Object | null): Object | null;
   updateOne(collection: string, filter: Object, update: Object): boolean;
@@ -114,6 +134,10 @@ function collection<T extends Document>(colName: string): Collection<T> {
   return {
     insert: (doc) => native().insert(colName, doc as Object),
     insertMany: (docs) => native().insertMany(colName, docs as Object[]),
+    replaceManyWithIds: (docs, origin = 'local') =>
+      native().replaceManyWithIds(colName, docs as Object[], origin),
+    deleteManyWithIds: (ids, origin = 'local') =>
+      native().deleteManyWithIds(colName, ids, origin),
     find: (filter?) => native().find(colName, filter ?? null) as T[],
     findOne: (filter) => native().findOne(colName, filter) as T | null,
     updateOne: (filter, update) => native().updateOne(colName, filter, update),