@taladb/react-native 0.4.0 → 0.6.0

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

@@ -0,0 +1,151 @@
+#pragma once
+#ifndef TALADB_FFI_H
+#define TALADB_FFI_H
+
+/*
+ * TalaDB C FFI header.
+ *
+ * This file is the stable C interface between the Rust taladb-ffi crate and
+ * the C++ JSI HostObject.  It is kept in sync with rust/src/lib.rs manually
+ * (or regenerated with cbindgen — see rust/cbindgen.toml).
+ *
+ * Ownership rules
+ * ---------------
+ *  - Strings IN  : caller-owned, UTF-8, null-terminated.
+ *  - Strings OUT : heap-allocated by Rust; caller must free with
+ *                  taladb_free_string().
+ *  - Handles     : allocated by taladb_open(); freed by taladb_close().
+ *  - Errors      : string functions return NULL; integer functions return -1.
+ */
+
+#include <stdint.h>
+#include <stdlib.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* -------------------------------------------------------------------------
+ * Opaque database handle
+ * ---------------------------------------------------------------------- */
+typedef struct TalaDbHandle TalaDbHandle;
+
+/* -------------------------------------------------------------------------
+ * Lifecycle
+ * ---------------------------------------------------------------------- */
+
+/** Open (or create) a database at the given file-system path. */
+TalaDbHandle *taladb_open(const char *path);
+
+/**
+ * Open (or create) a database with HTTP push sync configuration.
+ *
+ * config_json — JSON-serialised TalaDbConfig, or NULL to open without sync.
+ * Returns an opaque handle (same semantics as taladb_open), or NULL on failure.
+ */
+TalaDbHandle *taladb_open_with_config(const char *path, const char *config_json);
+
+/** Flush and close the database, freeing the handle. */
+void taladb_close(TalaDbHandle *handle);
+
+/** Free a C string returned by any taladb_* function. */
+void taladb_free_string(char *s);
+
+/* -------------------------------------------------------------------------
+ * Insert
+ * ---------------------------------------------------------------------- */
+
+/**
+ * Insert a document (JSON object).
+ * Returns the new document's ULID as a C string, or NULL on error.
+ * Caller must free with taladb_free_string().
+ */
+char *taladb_insert(TalaDbHandle *handle,
+                    const char   *collection,
+                    const char   *doc_json);
+
+/**
+ * Insert multiple documents (JSON array of objects).
+ * Returns a JSON array of ULID strings, or NULL on error.
+ * Caller must free with taladb_free_string().
+ */
+char *taladb_insert_many(TalaDbHandle *handle,
+                         const char   *collection,
+                         const char   *docs_json);
+
+/* -------------------------------------------------------------------------
+ * Find
+ * ---------------------------------------------------------------------- */
+
+/**
+ * Find all documents matching filter_json.
+ * Pass "{}" or "null" to match all.
+ * Returns a JSON array string, or NULL on error.
+ * Caller must free with taladb_free_string().
+ */
+char *taladb_find(TalaDbHandle *handle,
+                  const char   *collection,
+                  const char   *filter_json);
+
+/**
+ * Find the first document matching filter_json.
+ * Returns a JSON object string, or the string "null" if not found.
+ * Caller must free with taladb_free_string().
+ */
+char *taladb_find_one(TalaDbHandle *handle,
+                      const char   *collection,
+                      const char   *filter_json);
+
+/* -------------------------------------------------------------------------
+ * Update
+ * ---------------------------------------------------------------------- */
+
+/** Update the first matching document. Returns 1 updated, 0 not found, -1 error. */
+int32_t taladb_update_one(TalaDbHandle *handle,
+                          const char   *collection,
+                          const char   *filter_json,
+                          const char   *update_json);
+
+/** Update all matching documents. Returns count updated, or -1 on error. */
+int32_t taladb_update_many(TalaDbHandle *handle,
+                           const char   *collection,
+                           const char   *filter_json,
+                           const char   *update_json);
+
+/* -------------------------------------------------------------------------
+ * Delete
+ * ---------------------------------------------------------------------- */
+
+/** Delete the first matching document. Returns 1 deleted, 0 not found, -1 error. */
+int32_t taladb_delete_one(TalaDbHandle *handle,
+                          const char   *collection,
+                          const char   *filter_json);
+
+/** Delete all matching documents. Returns count deleted, or -1 on error. */
+int32_t taladb_delete_many(TalaDbHandle *handle,
+                           const char   *collection,
+                           const char   *filter_json);
+
+/* -------------------------------------------------------------------------
+ * Count
+ * ---------------------------------------------------------------------- */
+
+/** Count documents matching filter_json. Returns count, or -1 on error. */
+int32_t taladb_count(TalaDbHandle *handle,
+                     const char   *collection,
+                     const char   *filter_json);
+
+/* -------------------------------------------------------------------------
+ * Index management
+ * ---------------------------------------------------------------------- */
+
+void taladb_create_index    (TalaDbHandle *handle, const char *collection, const char *field);
+void taladb_drop_index      (TalaDbHandle *handle, const char *collection, const char *field);
+void taladb_create_fts_index(TalaDbHandle *handle, const char *collection, const char *field);
+void taladb_drop_fts_index  (TalaDbHandle *handle, const char *collection, const char *field);
+
+#ifdef __cplusplus
+} /* extern "C" */
+#endif
+
+#endif /* TALADB_FFI_H */

package/package.json

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

package/src/NativeTalaDB.ts

@@ -12,8 +12,11 @@ export interface Spec extends TurboModule {
   /**
    * Open (or create) a TalaDB database file at the platform default path.
    * Must be called once at app startup before using `collection()`.
+   *
+   * @param configJson  Optional JSON-serialised `TalaDbConfig`. Pass to enable
+   *                    HTTP push sync. When omitted, sync is disabled.
    */
-  initialize(dbName: string): Promise<void>;
+  initialize(dbName: string, configJson?: string): Promise<void>;
 
   /** Close the database and flush all pending writes. */
   close(): Promise<void>;

package/src/index.tsx

@@ -24,8 +24,15 @@ import NativeTalaDB from './NativeTalaDB';
 // ---------------------------------------------------------------------------
 
 export const TalaDBModule = {
-  /** Open (or create) the database. Call once at app startup. */
-  initialize: (dbName: string) => NativeTalaDB.initialize(dbName),
+  /**
+   * Open (or create) the database. Call once at app startup.
+   *
+   * @param configJson  Optional JSON-serialised `TalaDbConfig` for HTTP push
+   *                    sync. Example: `JSON.stringify({ sync: { enabled: true,
+   *                    endpoint: 'https://api.example.com/events' } })`.
+   */
+  initialize: (dbName: string, configJson?: string) =>
+    NativeTalaDB.initialize(dbName, configJson),
   /** Close the database gracefully. */
   close: () => NativeTalaDB.close(),
 };

package/taladb-react-native.podspec

@@ -18,27 +18,24 @@ Pod::Spec.new do |s|
   s.source_files  = "ios/**/*.{h,m,mm}", "cpp/**/*.{h,cpp}"
 
   # ---------------------------------------------------------------------------
-  # Pre-built Rust static library
+  # Pre-built Rust XCFramework
   # ---------------------------------------------------------------------------
-  # Build with:
-  #   cargo build --target aarch64-apple-ios          --release   (device)
-  #   cargo build --target x86_64-apple-ios           --release   (simulator Intel)
-  #   cargo build --target aarch64-apple-ios-sim      --release   (simulator Apple Silicon)
-  #   lipo device + sim → ios/libtaladb_ffi.a (fat / xcframework)
-  #
-  # The podspec expects the lipo'd archive at ios/libtaladb_ffi.a.
-  s.vendored_libraries = "ios/libtaladb_ffi.a"
+  # Built by scripts/build-ios.sh (or the release CI):
+  #   cargo build --target aarch64-apple-ios        --release  (device)
+  #   cargo build --target aarch64-apple-ios-sim    --release  (Apple Silicon simulator)
+  #   cargo build --target x86_64-apple-ios         --release  (Intel simulator)
+  #   lipo sim slices → fat sim lib
+  #   xcodebuild -create-xcframework → ios/TalaDBFfi.xcframework
+  s.vendored_frameworks = "ios/TalaDBFfi.xcframework"
 
   # ---------------------------------------------------------------------------
   # Compiler settings
   # ---------------------------------------------------------------------------
   s.pod_target_xcconfig = {
-    "CLANG_CXX_LANGUAGE_STANDARD"   => "c++17",
-    "OTHER_CPLUSPLUSFLAGS"           => "-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1",
-    "HEADER_SEARCH_PATHS"            => "$(PODS_ROOT)/Headers/Public/React-Core $(PODS_ROOT)/Headers/Public/React-RCTFabric",
-    "LIBRARY_SEARCH_PATHS"           => "$(PODS_ROOT)/../ios",
-    # Suppress linker warnings from the Rust archive
-    "OTHER_LDFLAGS"                  => "-lc++ -lz",
+    "CLANG_CXX_LANGUAGE_STANDARD" => "c++17",
+    "OTHER_CPLUSPLUSFLAGS"        => "-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1",
+    "HEADER_SEARCH_PATHS"         => "$(PODS_ROOT)/Headers/Public/React-Core $(PODS_ROOT)/Headers/Public/React-RCTFabric",
+    "OTHER_LDFLAGS"               => "-lc++ -lz",
   }
 
   # ---------------------------------------------------------------------------