@evolu/react-native 14.3.0 → 15.0.0-next.1

package/src/createExpoDeps.ts

@@ -1,162 +1,164 @@
-import { CreateSqliteDriverDep, LocalAuth } from "@evolu/common";
-import { EvoluDeps, ReloadApp } from "@evolu/common/local-first";
-import * as Expo from "expo";
-import { createSharedEvoluDeps, createSharedLocalAuth } from "./shared.js";
-import type {
-  AccessControl,
-  LocalAuthOptions,
-  SecureStorage,
-  SensitiveInfoItem,
-  StorageMetadata,
-} from "@evolu/common";
-import { localAuthDefaultOptions } from "@evolu/common";
-import * as SecureStore from "expo-secure-store";
-import KVStore from "expo-sqlite/kv-store";
+// import type {
+//   AccessControl,
+//   LocalAuthOptions,
+//   SecureStorage,
+//   SensitiveInfoItem,
+//   StorageMetadata,
+// } from "@evolu/common";
+// import {
+//   type CreateSqliteDriverDep,
+//   type LocalAuth,
+//   localAuthDefaultOptions,
+//   type ReloadApp,
+// } from "@evolu/common";
+// import type { EvoluDeps } from "@evolu/common/local-first";
+// import * as Expo from "expo";
+// import * as SecureStore from "expo-secure-store";
+// import KVStore from "expo-sqlite/kv-store";
+// import { createSharedEvoluDeps, createSharedLocalAuth } from "./shared.js";
 
-const reloadApp: ReloadApp = () => {
-  void Expo.reloadAppAsync();
-};
+// const reloadApp: ReloadApp = () => {
+//   void Expo.reloadAppAsync();
+// };
+//
+// const createSecureStore = (): SecureStorage => {
+//   const store: SecureStorage = {
+//     setItem: async (key, value, options) => {
+//       const rnsiOpts = convertOptions(options);
+//       const service = options?.service ?? "default";
+//       const metadata = createMetadata(options?.accessControl === "none");
+//       await KVStore.setItem(`${service}-${key}`, "1");
+//       await SecureStore.setItemAsync(
+//         key,
+//         JSON.stringify({ value, metadata }),
+//         rnsiOpts,
+//       );
+//       return { metadata };
+//     },
+//
+//     getItem: async (key, options) => {
+//       const rnsiOpts = convertOptions(options);
+//       const service = options?.service ?? "default";
+//       let data: { value: string; metadata: StorageMetadata };
+//       try {
+//         const result = await SecureStore.getItemAsync(key, rnsiOpts);
+//         if (!result) return null;
+//         data = JSON.parse(result) as {
+//           value: string;
+//           metadata: StorageMetadata;
+//         };
+//       } catch (_error) {
+//         return null;
+//       }
+//       return { key, service, ...data };
+//     },
+//
+//     deleteItem: async (key, options) => {
+//       const rnsiOpts = convertOptions(options);
+//       const service = options?.service ?? "default";
+//       await Promise.all([
+//         KVStore.removeItemAsync(`${service}-${key}`),
+//         SecureStore.deleteItemAsync(key, rnsiOpts),
+//       ]);
+//       return true;
+//     },
+//
+//     getAllItems: async (options) => {
+//       const keys = await KVStore.getAllKeysAsync();
+//       const service = options?.service ?? "default";
+//       const metadata = createMetadata(options?.accessControl === "none");
+//       return keys
+//         .filter((key) => key.startsWith(`${service}-`))
+//         .map((key) => ({
+//           key: key.slice(service.length + 1),
+//           service,
+//           metadata,
+//         }));
+//     },
+//
+//     clearService: async (options) => {
+//       const rnsiOpts = convertOptions(options);
+//       const service = options?.service ?? "default";
+//       const items = await store.getAllItems(options);
+//       await KVStore.multiRemove(items.map((item) => `${service}-${item.key}`));
+//       await Promise.all(
+//         items.map(async (item) => {
+//           await SecureStore.deleteItemAsync(item.key, rnsiOpts);
+//         }),
+//       );
+//     },
+//   };
+//
+//   return store;
+// };
 
-const createSecureStore = (): SecureStorage => {
-  const store: SecureStorage = {
-    setItem: async (key, value, options) => {
-      const rnsiOpts = convertOptions(options);
-      const service = options?.service ?? "default";
-      const metadata = createMetadata(options?.accessControl === "none");
-      await KVStore.setItem(`${service}-${key}`, "1");
-      await SecureStore.setItemAsync(
-        key,
-        JSON.stringify({ value, metadata }),
-        rnsiOpts,
-      );
-      return { metadata };
-    },
-
-    getItem: async (key, options) => {
-      const rnsiOpts = convertOptions(options);
-      const service = options?.service ?? "default";
-      let data: { value: string; metadata: StorageMetadata };
-      try {
-        const result = await SecureStore.getItemAsync(key, rnsiOpts);
-        if (!result) return null;
-        data = JSON.parse(result) as {
-          value: string;
-          metadata: StorageMetadata;
-        };
-      } catch (_error) {
-        return null;
-      }
-      return { key, service, ...data };
-    },
-
-    deleteItem: async (key, options) => {
-      const rnsiOpts = convertOptions(options);
-      const service = options?.service ?? "default";
-      await Promise.all([
-        KVStore.removeItemAsync(`${service}-${key}`),
-        SecureStore.deleteItemAsync(key, rnsiOpts),
-      ]);
-      return true;
-    },
-
-    getAllItems: async (options) => {
-      const keys = await KVStore.getAllKeysAsync();
-      const service = options?.service ?? "default";
-      const metadata = createMetadata(options?.accessControl === "none");
-      return keys
-        .filter((key) => key.startsWith(`${service}-`))
-        .map((key) => ({
-          key: key.slice(service.length + 1),
-          service,
-          metadata,
-        }));
-    },
-
-    clearService: async (options) => {
-      const rnsiOpts = convertOptions(options);
-      const service = options?.service ?? "default";
-      const items = await store.getAllItems(options);
-      await KVStore.multiRemove(items.map((item) => `${service}-${item.key}`));
-      await Promise.all(
-        items.map(async (item) => {
-          await SecureStore.deleteItemAsync(item.key, rnsiOpts);
-        }),
-      );
-    },
-  };
-
-  return store;
-};
-
-/**
- * Create default metadata for backwards compatibility with items that don't
- * have stored metadata.
- */
-const createMetadata = (isSecure = true): SensitiveInfoItem["metadata"] => {
-  return {
-    backend: "keychain",
-    accessControl: isSecure ? "biometryCurrentSet" : "none",
-    securityLevel: isSecure ? "biometry" : "software",
-    timestamp: Date.now(),
-  };
-};
-
-function convertOptions(
-  options?: LocalAuthOptions,
-): SecureStore.SecureStoreOptions {
-  const accessGroup =
-    options?.keychainGroup ?? localAuthDefaultOptions.keychainGroup ?? "";
-  const keychainService =
-    options?.service ?? localAuthDefaultOptions.service ?? "";
-  const keychainAccessible = convertKeychainAccessible(
-    options?.accessControl ??
-      localAuthDefaultOptions.accessControl ??
-      "biometryCurrentSet",
-  );
-  const authenticationPrompt =
-    options?.authenticationPrompt?.title ??
-    localAuthDefaultOptions.authenticationPrompt?.title ??
-    "";
-  return {
-    accessGroup,
-    keychainService,
-    keychainAccessible,
-    authenticationPrompt,
-    requireAuthentication: options?.accessControl !== "none",
-  };
-}
-
-function convertKeychainAccessible(
-  accessControl: AccessControl,
-): SecureStore.KeychainAccessibilityConstant {
-  switch (accessControl) {
-    case "none":
-      // eslint-disable-next-line @typescript-eslint/no-deprecated
-      return SecureStore.ALWAYS;
-    case "biometryCurrentSet":
-      return SecureStore.AFTER_FIRST_UNLOCK;
-    case "biometryAny":
-      return SecureStore.AFTER_FIRST_UNLOCK;
-    case "devicePasscode":
-      return SecureStore.AFTER_FIRST_UNLOCK;
-    case "secureEnclaveBiometry":
-      return SecureStore.AFTER_FIRST_UNLOCK;
-    // Exhaustive check
-    default:
-      accessControl satisfies never;
-      // Default (for typescript, should never hit)
-      return SecureStore.AFTER_FIRST_UNLOCK;
-  }
-}
-
-const localAuth = createSharedLocalAuth(createSecureStore());
-
-export const createExpoDeps = (
-  deps: CreateSqliteDriverDep,
-): { evoluReactNativeDeps: EvoluDeps; localAuth: LocalAuth } => ({
-  evoluReactNativeDeps: createSharedEvoluDeps({
-    ...deps,
-    reloadApp,
-  }),
-  localAuth,
-});
+// /**
+//  * Create default metadata for backwards compatibility with items that don't
+//  * have stored metadata.
+//  */
+// const createMetadata = (isSecure = true): SensitiveInfoItem["metadata"] => ({
+//   backend: "keychain",
+//   accessControl: isSecure ? "biometryCurrentSet" : "none",
+//   securityLevel: isSecure ? "biometry" : "software",
+//   timestamp: Date.now(),
+// });
+//
+// const convertOptions = (
+//   options?: LocalAuthOptions,
+// ): SecureStore.SecureStoreOptions => {
+//   const accessGroup =
+//     options?.keychainGroup ?? localAuthDefaultOptions.keychainGroup ?? "";
+//   const keychainService =
+//     options?.service ?? localAuthDefaultOptions.service ?? "";
+//   const keychainAccessible = convertKeychainAccessible(
+//     options?.accessControl ??
+//       localAuthDefaultOptions.accessControl ??
+//       "biometryCurrentSet",
+//   );
+//   const authenticationPrompt =
+//     options?.authenticationPrompt?.title ??
+//     localAuthDefaultOptions.authenticationPrompt?.title ??
+//     "";
+//   return {
+//     accessGroup,
+//     keychainService,
+//     keychainAccessible,
+//     authenticationPrompt,
+//     requireAuthentication: options?.accessControl !== "none",
+//   };
+// };
+//
+// const convertKeychainAccessible = (
+//   accessControl: AccessControl,
+// ): SecureStore.KeychainAccessibilityConstant => {
+//   switch (accessControl) {
+//     case "none":
+//       // eslint-disable-next-line @typescript-eslint/no-deprecated
+//       return SecureStore.ALWAYS;
+//     case "biometryCurrentSet":
+//       return SecureStore.AFTER_FIRST_UNLOCK;
+//     case "biometryAny":
+//       return SecureStore.AFTER_FIRST_UNLOCK;
+//     case "devicePasscode":
+//       return SecureStore.AFTER_FIRST_UNLOCK;
+//     case "secureEnclaveBiometry":
+//       return SecureStore.AFTER_FIRST_UNLOCK;
+//     // Exhaustive check
+//     default:
+//       accessControl satisfies never;
+//       // Default (for typescript, should never hit)
+//       return SecureStore.AFTER_FIRST_UNLOCK;
+//   }
+// };
+//
+// const localAuth = createSharedLocalAuth(createSecureStore());
+//
+// export const createExpoDeps = (
+//   deps: CreateSqliteDriverDep,
+// ): { evoluReactNativeDeps: EvoluDeps; localAuth: LocalAuth } => ({
+//   evoluReactNativeDeps: createSharedEvoluDeps({
+//     ...deps,
+//     reloadApp,
+//   }),
+//   localAuth,
+// });

package/src/exports/bare-op-sqlite.ts

@@ -1,28 +1,30 @@
-/**
- * Public entry point for bare React Native with OP-SQLite. Exported as
- * "@evolu/react-native/bare-op-sqlite" in package.json.
- *
- * Use this with bare React Native projects (not Expo) that use
- * `@op-engineering/op-sqlite`.
- */
-
-import { ReloadApp } from "@evolu/common/local-first";
-import { DevSettings } from "react-native";
-import { SensitiveInfo } from "react-native-sensitive-info";
-import { createSharedEvoluDeps, createSharedLocalAuth } from "../shared.js";
-import { createOpSqliteDriver } from "../sqlite-drivers/createOpSqliteDriver.js";
-
-const reloadApp: ReloadApp = () => {
-  if (process.env.NODE_ENV === "development") {
-    DevSettings.reload();
-  } else {
-    // TODO: reload not implemented for bare rn
-  }
-};
-
-export const evoluReactNativeDeps = createSharedEvoluDeps({
-  createSqliteDriver: createOpSqliteDriver,
-  reloadApp,
-});
-
-export const localAuth = createSharedLocalAuth(SensitiveInfo);
+// /**
+//  * Public entry point for bare React Native with OP-SQLite. Exported as
+//  * "@evolu/react-native/bare-op-sqlite" in package.json.
+//  *
+//  * Use this with bare React Native projects (not Expo) that use
+//  * `@op-engineering/op-sqlite`.
+//  */
+//
+// import { type ReloadApp } from "@evolu/common";
+// import { DevSettings } from "react-native";
+// import { SensitiveInfo } from "react-native-sensitive-info";
+// import { createSharedEvoluDeps, createSharedLocalAuth } from "../shared.js";
+// import { createOpSqliteDriver } from "../sqlite-drivers/createOpSqliteDriver.js";
+//
+// const reloadApp: ReloadApp = () => {
+//   if (process.env.NODE_ENV === "development") {
+//     DevSettings.reload();
+//   } else {
+//     // TODO: reload not implemented for bare rn
+//   }
+// };
+//
+// // eslint-disable-next-line evolu/require-pure-annotation
+// export const evoluReactNativeDeps = createSharedEvoluDeps({
+//   createSqliteDriver: createOpSqliteDriver,
+//   reloadApp,
+// });
+//
+// // eslint-disable-next-line evolu/require-pure-annotation
+// export const localAuth = createSharedLocalAuth(SensitiveInfo);

package/src/exports/expo-op-sqlite.ts

@@ -1,14 +1,15 @@
-/**
- * Public entry point for Expo with OP-SQLite. Exported as
- * "@evolu/react-native/expo-op-sqlite" in package.json.
- *
- * Use this with Expo projects that use `@op-engineering/op-sqlite` for better
- * performance.
- */
-
-import { createExpoDeps } from "../createExpoDeps.js";
-import { createOpSqliteDriver } from "../sqlite-drivers/createOpSqliteDriver.js";
-
-export const { evoluReactNativeDeps, localAuth } = createExpoDeps({
-  createSqliteDriver: createOpSqliteDriver,
-});
+// /**
+//  * Public entry point for Expo with OP-SQLite. Exported as
+//  * "@evolu/react-native/expo-op-sqlite" in package.json.
+//  *
+//  * Use this with Expo projects that use `@op-engineering/op-sqlite` for better
+//  * performance.
+//  */
+//
+// import { createExpoDeps } from "../createExpoDeps.js";
+// import { createOpSqliteDriver } from "../sqlite-drivers/createOpSqliteDriver.js";
+//
+// // eslint-disable-next-line evolu/require-pure-annotation
+// export const { evoluReactNativeDeps, localAuth } = createExpoDeps({
+//   createSqliteDriver: createOpSqliteDriver,
+// });

package/src/exports/expo-sqlite.ts

@@ -5,9 +5,26 @@
  * Use this with Expo projects that use expo-sqlite.
  */
 
-import { createExpoDeps } from "../createExpoDeps.js";
+import type { ConsoleDep } from "@evolu/common";
+import type { EvoluDeps } from "@evolu/common/local-first";
+import * as Expo from "expo";
+import { createEvoluDeps as createSharedEvoluDeps } from "../shared.js";
 import { createExpoSqliteDriver } from "../sqlite-drivers/createExpoSqliteDriver.js";
 
-export const { evoluReactNativeDeps, localAuth } = createExpoDeps({
-  createSqliteDriver: createExpoSqliteDriver,
-});
+/** Creates Evolu dependencies for Expo. */
+export const createEvoluDeps = (deps: Partial<ConsoleDep> = {}): EvoluDeps =>
+  createSharedEvoluDeps({
+    ...deps,
+    createSqliteDriver: createExpoSqliteDriver,
+    reloadApp: () => {
+      void Expo.reloadAppAsync();
+    },
+  });
+
+// import { createExpoDeps } from "../createExpoDeps.js";
+// import { createExpoSqliteDriver } from "../sqlite-drivers/createExpoSqliteDriver.js";
+//
+// // eslint-disable-next-line evolu/require-pure-annotation
+// export const { evoluReactNativeDeps, localAuth } = createExpoDeps({
+//   createSqliteDriver: createExpoSqliteDriver,
+// });

package/src/index.ts

@@ -1 +1,3 @@
 export * from "./components/EvoluIdenticon.js";
+export * from "./LockManager.js";
+export * from "./Task.js";

package/src/shared.ts

@@ -1,63 +1,129 @@
 import {
   createConsole,
-  createLocalAuth,
-  createRandom,
+  createConsoleStoreOutput,
+  createBroadcastChannel,
+  createMessageChannel,
+  createMessagePort,
   createRandomBytes,
-  CreateSqliteDriverDep,
-  createTime,
+  createRun,
+  createSharedWorker,
   createWebSocket,
-  LocalAuth,
-  SecureStorage,
+  createWorker,
+  type ConsoleDep,
+  type CreateSqliteDriverDep,
+  type ReloadAppDep,
 } from "@evolu/common";
-import {
-  createDbWorkerForPlatform,
+import type {
+  CreateDbWorker,
+  DbWorker,
+  DbWorkerInit,
   EvoluDeps,
-  ReloadAppDep,
+  SharedWorkerInput,
+  SharedWorkerOutput,
+} from "@evolu/common/local-first";
+import {
+  createEvoluDeps as createCommonEvoluDeps,
+  initSharedWorker,
+  startDbWorker,
 } from "@evolu/common/local-first";
+import { lockManager } from "./LockManager.js";
 
-/**
- * Polyfills `Promise.withResolvers`.
- *
- * @see https://github.com/facebook/hermes/pull/1452
- */
-if (typeof Promise.withResolvers === "undefined") {
-  // @ts-expect-error This is OK.
-  Promise.withResolvers = function () {
-    let resolve, reject;
-    const promise = new Promise((res, rej) => {
-      resolve = res;
-      reject = rej;
+/** Creates Evolu dependencies for React Native. */
+export const createEvoluDeps = (
+  deps: ReloadAppDep & CreateSqliteDriverDep & Partial<ConsoleDep>,
+): EvoluDeps => {
+  // Worker-side Run lives as long as the app. When RN supports real workers,
+  // this moves to the worker entry point (like web's Worker.worker.ts).
+  const createWorkerRun = () => {
+    const consoleStoreOutput = createConsoleStoreOutput();
+    const workerConsole = createConsole({
+      output: consoleStoreOutput,
+      ...(deps.console && { level: deps.console.getLevel() }),
+    });
+
+    return createRun({
+      console: workerConsole,
+      consoleStoreOutputEntry: consoleStoreOutput.entry,
+      createBroadcastChannel,
+      createMessageChannel,
+      createMessagePort,
+      createWebSocket,
+      createSqliteDriver: deps.createSqliteDriver,
+      lockManager,
+      randomBytes: createRandomBytes(),
     });
-    return { promise, resolve, reject };
   };
-}
 
-const console = createConsole();
-const randomBytes = createRandomBytes();
-const time = createTime();
+  const createDbWorker: CreateDbWorker = (): DbWorker =>
+    createWorker<DbWorkerInit, never>((self) => {
+      const dbWorkerRun = createWorkerRun();
+      dbWorkerRun(startDbWorker(self));
+    });
 
-export const createSharedEvoluDeps = (
-  deps: CreateSqliteDriverDep & ReloadAppDep,
-): EvoluDeps => ({
-  ...deps,
-  console,
-  createDbWorker: () =>
-    createDbWorkerForPlatform({
-      ...deps,
-      console,
-      createWebSocket,
-      random: createRandom(),
-      randomBytes,
-      time,
-    }),
-  randomBytes,
-  time,
-});
+  const sharedWorker = createSharedWorker<
+    SharedWorkerInput,
+    SharedWorkerOutput
+  >((self) => {
+    const sharedWorkerRun = createWorkerRun();
+    sharedWorkerRun(initSharedWorker(self));
+  });
 
-export const createSharedLocalAuth = (
-  secureStorage: SecureStorage,
-): LocalAuth =>
-  createLocalAuth({
-    randomBytes,
-    secureStorage,
+  return createCommonEvoluDeps({
+    ...deps,
+    createDbWorker,
+    createBroadcastChannel,
+    createMessageChannel,
+    lockManager,
+    reloadApp: deps.reloadApp,
+    sharedWorker,
   });
+};
+
+// TODO: Reimplement local auth for React Native from scratch.
+// export const createSharedLocalAuth = (
+//   secureStorage: SecureStorage,
+// ): LocalAuth =>
+//   createLocalAuth({
+//     randomBytes,
+//     secureStorage,
+//   });
+
+// import {
+//   createConsole,
+//   createLocalAuth,
+//   createRandomBytes,
+//   type CreateSqliteDriverDep,
+//   type LocalAuth,
+//   type ReloadAppDep,
+//   type SecureStorage,
+// } from "@evolu/common";
+// import type {
+//   // createDbWorkerForPlatform,
+//   // createDbWorkerForPlatform,
+//   EvoluDeps,
+// } from "@evolu/common/local-first";
+//
+// const _console = createConsole();
+// const randomBytes = createRandomBytes();
+//
+// export const createSharedEvoluDeps = (
+//   _deps: CreateSqliteDriverDep & ReloadAppDep,
+// ): EvoluDeps => {
+//   throw new Error("todo");
+// };
+//
+//   ({
+//   ...deps,
+//   console,
+//   sharedWorker: "TODO" as never,
+//   // createDbWorker: () =>
+//   //   createDbWorkerForPlatform({
+//   //     ...deps,
+//   //     console,
+//   //     createWebSocket,
+//   //     random: createRandom(),
+//   //     randomBytes,
+//   //     time: createTime(),
+//   //   }),
+//   randomBytes,
+// });