@taladb/react-native 0.9.1 → 0.9.3

package/cpp/TalaDBHostObject.cpp

@@ -247,6 +247,9 @@ std::vector<PropNameID> TalaDBHostObject::getPropertyNames(Runtime &rt) {
         "count",
         "aggregate",
         "exportChanges", "importChanges", "listCollectionNames",
+        "importChangesValidated", "quarantined",
+        "userVersion", "setUserVersion",
+        "flush",
         "createIndex", "dropIndex",
         "createCompoundIndex", "dropCompoundIndex",
         "createFtsIndex", "dropFtsIndex",
@@ -493,6 +496,72 @@ Value TalaDBHostObject::get(Runtime &rt, const PropNameID &propName) {
             });
     }
 
+    // ------------------------------------------------------------------
+    // Validate-on-import — importChangesValidated / quarantined
+    // ------------------------------------------------------------------
+    if (name == "importChangesValidated") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "importChangesValidated"), 2,
+            [this](Runtime &rt, const Value &, const Value *args, size_t count) -> Value {
+                if (count < 2) throw JSError(rt, "importChangesValidated requires 2 arguments");
+                auto changeset = args[0].getString(rt).utf8(rt);
+                auto schemas   = args[1].getString(rt).utf8(rt);
+                char *result = taladb_import_changes_validated(db_, changeset.c_str(), schemas.c_str());
+                if (!result) throw JSError(rt, "taladb_import_changes_validated failed");
+                std::string json(result);
+                taladb_free_string(result);
+                return parse(rt, json);  // { applied, skipped, quarantined }
+            });
+    }
+
+    if (name == "quarantined") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "quarantined"), 1,
+            [this](Runtime &rt, const Value &, const Value *args, size_t count) -> Value {
+                if (count < 1) throw JSError(rt, "quarantined requires 1 argument");
+                auto col = args[0].getString(rt).utf8(rt);
+                char *result = taladb_quarantined(db_, col.c_str());
+                if (!result) throw JSError(rt, "taladb_quarantined failed");
+                std::string json(result);
+                taladb_free_string(result);
+                return parse(rt, json);  // [{ document, reason, changedAt }]
+            });
+    }
+
+    // ------------------------------------------------------------------
+    // Application migrations — userVersion / setUserVersion
+    // ------------------------------------------------------------------
+    if (name == "userVersion") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "userVersion"), 0,
+            [this](Runtime &rt, const Value &, const Value *, size_t) -> Value {
+                int64_t v = taladb_user_version(db_);
+                if (v < 0) throw JSError(rt, "taladb_user_version failed");
+                return Value(static_cast<double>(v));
+            });
+    }
+
+    if (name == "setUserVersion") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "setUserVersion"), 1,
+            [this](Runtime &rt, const Value &, const Value *args, size_t count) -> Value {
+                if (count < 1) throw JSError(rt, "setUserVersion requires 1 argument");
+                uint32_t version = static_cast<uint32_t>(args[0].getNumber());
+                if (taladb_set_user_version(db_, version) < 0)
+                    throw JSError(rt, "taladb_set_user_version failed");
+                return Value::undefined();
+            });
+    }
+
+    if (name == "flush") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "flush"), 0,
+            [this](Runtime &rt, const Value &, const Value *, size_t) -> Value {
+                if (taladb_flush(db_) < 0) throw JSError(rt, "taladb_flush failed");
+                return Value::undefined();
+            });
+    }
+
     // ------------------------------------------------------------------
     // createIndex / dropIndex / createFtsIndex / dropFtsIndex
     // ------------------------------------------------------------------

package/cpp/taladb.h

@@ -180,6 +180,37 @@ int32_t taladb_import_changes(TalaDbHandle *handle,
  */
 char *taladb_list_collection_names(TalaDbHandle *handle);
 
+/**
+ * Merge a JSON changeset through a tolerant structural validator built from
+ * schemas_json ({ "<collection>": { version, required, types, defaults,
+ * renames } }). Returns a JSON "{ applied, skipped, quarantined }" string, or
+ * NULL on error. Caller must free with taladb_free_string().
+ */
+char *taladb_import_changes_validated(TalaDbHandle *handle,
+                                      const char   *changeset_json,
+                                      const char   *schemas_json);
+
+/**
+ * Documents set aside in a collection's quarantine table by a validated import,
+ * as a JSON array of { document, reason, changedAt }. NULL on error. Caller
+ * must free with taladb_free_string().
+ */
+char *taladb_quarantined(TalaDbHandle *handle, const char *collection);
+
+/**
+ * Read / write the application migration version (backs openDB({ migrations })).
+ * taladb_user_version returns the version (0 if unset) or -1 on error;
+ * taladb_set_user_version returns 0 on success, -1 on error.
+ */
+int64_t taladb_user_version(TalaDbHandle *handle);
+int32_t taladb_set_user_version(TalaDbHandle *handle, uint32_t version);
+
+/**
+ * Force any batched (eventual-durability) writes to disk. Returns 0 on success,
+ * -1 on error. No-op under the default immediate durability. Backs db.flush().
+ */
+int32_t taladb_flush(TalaDbHandle *handle);
+
 /* -------------------------------------------------------------------------
  * Index management
  * ---------------------------------------------------------------------- */

package/ios/TalaDBFfi.xcframework/Info.plist

@@ -6,38 +6,38 @@
 	<array>
 		<dict>
 			<key>BinaryPath</key>
-			<string>libtaladb_ffi_sim.a</string>
+			<string>libtaladb_ffi.a</string>
 			<key>HeadersPath</key>
 			<string>Headers</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-simulator</string>
+			<string>ios-arm64</string>
 			<key>LibraryPath</key>
-			<string>libtaladb_ffi_sim.a</string>
+			<string>libtaladb_ffi.a</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
-			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
 		</dict>
 		<dict>
 			<key>BinaryPath</key>
-			<string>libtaladb_ffi.a</string>
+			<string>libtaladb_ffi_sim.a</string>
 			<key>HeadersPath</key>
 			<string>Headers</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64</string>
+			<string>ios-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
-			<string>libtaladb_ffi.a</string>
+			<string>libtaladb_ffi_sim.a</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
 		</dict>
 	</array>
 	<key>CFBundlePackageType</key>

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

@@ -247,6 +247,9 @@ std::vector<PropNameID> TalaDBHostObject::getPropertyNames(Runtime &rt) {
         "count",
         "aggregate",
         "exportChanges", "importChanges", "listCollectionNames",
+        "importChangesValidated", "quarantined",
+        "userVersion", "setUserVersion",
+        "flush",
         "createIndex", "dropIndex",
         "createCompoundIndex", "dropCompoundIndex",
         "createFtsIndex", "dropFtsIndex",
@@ -493,6 +496,72 @@ Value TalaDBHostObject::get(Runtime &rt, const PropNameID &propName) {
             });
     }
 
+    // ------------------------------------------------------------------
+    // Validate-on-import — importChangesValidated / quarantined
+    // ------------------------------------------------------------------
+    if (name == "importChangesValidated") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "importChangesValidated"), 2,
+            [this](Runtime &rt, const Value &, const Value *args, size_t count) -> Value {
+                if (count < 2) throw JSError(rt, "importChangesValidated requires 2 arguments");
+                auto changeset = args[0].getString(rt).utf8(rt);
+                auto schemas   = args[1].getString(rt).utf8(rt);
+                char *result = taladb_import_changes_validated(db_, changeset.c_str(), schemas.c_str());
+                if (!result) throw JSError(rt, "taladb_import_changes_validated failed");
+                std::string json(result);
+                taladb_free_string(result);
+                return parse(rt, json);  // { applied, skipped, quarantined }
+            });
+    }
+
+    if (name == "quarantined") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "quarantined"), 1,
+            [this](Runtime &rt, const Value &, const Value *args, size_t count) -> Value {
+                if (count < 1) throw JSError(rt, "quarantined requires 1 argument");
+                auto col = args[0].getString(rt).utf8(rt);
+                char *result = taladb_quarantined(db_, col.c_str());
+                if (!result) throw JSError(rt, "taladb_quarantined failed");
+                std::string json(result);
+                taladb_free_string(result);
+                return parse(rt, json);  // [{ document, reason, changedAt }]
+            });
+    }
+
+    // ------------------------------------------------------------------
+    // Application migrations — userVersion / setUserVersion
+    // ------------------------------------------------------------------
+    if (name == "userVersion") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "userVersion"), 0,
+            [this](Runtime &rt, const Value &, const Value *, size_t) -> Value {
+                int64_t v = taladb_user_version(db_);
+                if (v < 0) throw JSError(rt, "taladb_user_version failed");
+                return Value(static_cast<double>(v));
+            });
+    }
+
+    if (name == "setUserVersion") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "setUserVersion"), 1,
+            [this](Runtime &rt, const Value &, const Value *args, size_t count) -> Value {
+                if (count < 1) throw JSError(rt, "setUserVersion requires 1 argument");
+                uint32_t version = static_cast<uint32_t>(args[0].getNumber());
+                if (taladb_set_user_version(db_, version) < 0)
+                    throw JSError(rt, "taladb_set_user_version failed");
+                return Value::undefined();
+            });
+    }
+
+    if (name == "flush") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "flush"), 0,
+            [this](Runtime &rt, const Value &, const Value *, size_t) -> Value {
+                if (taladb_flush(db_) < 0) throw JSError(rt, "taladb_flush failed");
+                return Value::undefined();
+            });
+    }
+
     // ------------------------------------------------------------------
     // createIndex / dropIndex / createFtsIndex / dropFtsIndex
     // ------------------------------------------------------------------

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

@@ -180,6 +180,37 @@ int32_t taladb_import_changes(TalaDbHandle *handle,
  */
 char *taladb_list_collection_names(TalaDbHandle *handle);
 
+/**
+ * Merge a JSON changeset through a tolerant structural validator built from
+ * schemas_json ({ "<collection>": { version, required, types, defaults,
+ * renames } }). Returns a JSON "{ applied, skipped, quarantined }" string, or
+ * NULL on error. Caller must free with taladb_free_string().
+ */
+char *taladb_import_changes_validated(TalaDbHandle *handle,
+                                      const char   *changeset_json,
+                                      const char   *schemas_json);
+
+/**
+ * Documents set aside in a collection's quarantine table by a validated import,
+ * as a JSON array of { document, reason, changedAt }. NULL on error. Caller
+ * must free with taladb_free_string().
+ */
+char *taladb_quarantined(TalaDbHandle *handle, const char *collection);
+
+/**
+ * Read / write the application migration version (backs openDB({ migrations })).
+ * taladb_user_version returns the version (0 if unset) or -1 on error;
+ * taladb_set_user_version returns 0 on success, -1 on error.
+ */
+int64_t taladb_user_version(TalaDbHandle *handle);
+int32_t taladb_set_user_version(TalaDbHandle *handle, uint32_t version);
+
+/**
+ * Force any batched (eventual-durability) writes to disk. Returns 0 on success,
+ * -1 on error. No-op under the default immediate durability. Backs db.flush().
+ */
+int32_t taladb_flush(TalaDbHandle *handle);
+
 /* -------------------------------------------------------------------------
  * Index management
  * ---------------------------------------------------------------------- */

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

@@ -247,6 +247,9 @@ std::vector<PropNameID> TalaDBHostObject::getPropertyNames(Runtime &rt) {
         "count",
         "aggregate",
         "exportChanges", "importChanges", "listCollectionNames",
+        "importChangesValidated", "quarantined",
+        "userVersion", "setUserVersion",
+        "flush",
         "createIndex", "dropIndex",
         "createCompoundIndex", "dropCompoundIndex",
         "createFtsIndex", "dropFtsIndex",
@@ -493,6 +496,72 @@ Value TalaDBHostObject::get(Runtime &rt, const PropNameID &propName) {
             });
     }
 
+    // ------------------------------------------------------------------
+    // Validate-on-import — importChangesValidated / quarantined
+    // ------------------------------------------------------------------
+    if (name == "importChangesValidated") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "importChangesValidated"), 2,
+            [this](Runtime &rt, const Value &, const Value *args, size_t count) -> Value {
+                if (count < 2) throw JSError(rt, "importChangesValidated requires 2 arguments");
+                auto changeset = args[0].getString(rt).utf8(rt);
+                auto schemas   = args[1].getString(rt).utf8(rt);
+                char *result = taladb_import_changes_validated(db_, changeset.c_str(), schemas.c_str());
+                if (!result) throw JSError(rt, "taladb_import_changes_validated failed");
+                std::string json(result);
+                taladb_free_string(result);
+                return parse(rt, json);  // { applied, skipped, quarantined }
+            });
+    }
+
+    if (name == "quarantined") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "quarantined"), 1,
+            [this](Runtime &rt, const Value &, const Value *args, size_t count) -> Value {
+                if (count < 1) throw JSError(rt, "quarantined requires 1 argument");
+                auto col = args[0].getString(rt).utf8(rt);
+                char *result = taladb_quarantined(db_, col.c_str());
+                if (!result) throw JSError(rt, "taladb_quarantined failed");
+                std::string json(result);
+                taladb_free_string(result);
+                return parse(rt, json);  // [{ document, reason, changedAt }]
+            });
+    }
+
+    // ------------------------------------------------------------------
+    // Application migrations — userVersion / setUserVersion
+    // ------------------------------------------------------------------
+    if (name == "userVersion") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "userVersion"), 0,
+            [this](Runtime &rt, const Value &, const Value *, size_t) -> Value {
+                int64_t v = taladb_user_version(db_);
+                if (v < 0) throw JSError(rt, "taladb_user_version failed");
+                return Value(static_cast<double>(v));
+            });
+    }
+
+    if (name == "setUserVersion") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "setUserVersion"), 1,
+            [this](Runtime &rt, const Value &, const Value *args, size_t count) -> Value {
+                if (count < 1) throw JSError(rt, "setUserVersion requires 1 argument");
+                uint32_t version = static_cast<uint32_t>(args[0].getNumber());
+                if (taladb_set_user_version(db_, version) < 0)
+                    throw JSError(rt, "taladb_set_user_version failed");
+                return Value::undefined();
+            });
+    }
+
+    if (name == "flush") {
+        return Function::createFromHostFunction(
+            rt, PropNameID::forAscii(rt, "flush"), 0,
+            [this](Runtime &rt, const Value &, const Value *, size_t) -> Value {
+                if (taladb_flush(db_) < 0) throw JSError(rt, "taladb_flush failed");
+                return Value::undefined();
+            });
+    }
+
     // ------------------------------------------------------------------
     // createIndex / dropIndex / createFtsIndex / dropFtsIndex
     // ------------------------------------------------------------------

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

@@ -180,6 +180,37 @@ int32_t taladb_import_changes(TalaDbHandle *handle,
  */
 char *taladb_list_collection_names(TalaDbHandle *handle);
 
+/**
+ * Merge a JSON changeset through a tolerant structural validator built from
+ * schemas_json ({ "<collection>": { version, required, types, defaults,
+ * renames } }). Returns a JSON "{ applied, skipped, quarantined }" string, or
+ * NULL on error. Caller must free with taladb_free_string().
+ */
+char *taladb_import_changes_validated(TalaDbHandle *handle,
+                                      const char   *changeset_json,
+                                      const char   *schemas_json);
+
+/**
+ * Documents set aside in a collection's quarantine table by a validated import,
+ * as a JSON array of { document, reason, changedAt }. NULL on error. Caller
+ * must free with taladb_free_string().
+ */
+char *taladb_quarantined(TalaDbHandle *handle, const char *collection);
+
+/**
+ * Read / write the application migration version (backs openDB({ migrations })).
+ * taladb_user_version returns the version (0 if unset) or -1 on error;
+ * taladb_set_user_version returns 0 on success, -1 on error.
+ */
+int64_t taladb_user_version(TalaDbHandle *handle);
+int32_t taladb_set_user_version(TalaDbHandle *handle, uint32_t version);
+
+/**
+ * Force any batched (eventual-durability) writes to disk. Returns 0 on success,
+ * -1 on error. No-op under the default immediate durability. Backs db.flush().
+ */
+int32_t taladb_flush(TalaDbHandle *handle);
+
 /* -------------------------------------------------------------------------
  * Index management
  * ---------------------------------------------------------------------- */

package/package.json

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