bff-store 0.1.0 → 0.1.1

package/.claude/settings.local.json

@@ -39,7 +39,16 @@
       "Bash(npm publish:*)",
       "Bash(rg -rn \"jotai-state-store\" --type-list)",
       "Bash(rg -rn \"jotai-state-store\" .)",
-      "Bash(xargs sed:*)"
+      "Bash(xargs sed:*)",
+      "Bash(npx tsx:*)",
+      "Bash(npm ls:*)",
+      "Bash(perl -e 'alarm 5; exec @ARGV' -- node debug-simple.js)",
+      "Bash(echo \"exit: $?\")",
+      "Bash([ -d node_modules/mongodb ])",
+      "Bash(echo \"---mongodb status: $\\([ -d node_modules/mongodb ] && echo 'INSTALLED' || echo 'NOT INSTALLED'\\)\")",
+      "Bash(echo \"---mongodb: $\\([ -d node_modules/mongodb ] && echo 'INSTALLED' || echo 'NOT INSTALLED'\\)\")",
+      "Bash(xargs kill:*)",
+      "Bash(npm start:*)"
     ]
   }
 }

package/README.md

@@ -124,20 +124,49 @@ await startServer({
 如果不通过 BFF，可以直接在 Node.js 中使用存储适配器：
 
 ```typescript
-import { createStore } from 'bff-store';
+import { createNodeStore, getDefaultStore } from 'bff-store';
 import { jsonlStorage } from 'bff-store/jsonl';
 import { mongodbStorage } from 'bff-store/mongodb';
 
 // 使用 JSONL
-const adapter = jsonlStorage({ dir: './sessions' });
+const store = createNodeStore('entity-123', [
+  { key: 'theme', defaultValue: 'dark' },
+  { key: 'count', defaultValue: 0 },
+], {
+  storage: jsonlStorage({ dir: './sessions' }),
+});
 
-// 使用 MongoDB
-const adapter = await mongodbStorage({
-  url: 'mongodb://localhost:27017',
-  database: 'myapp',
+// 等待初始加载完成
+await store.waitForLoad();
+
+// 使用 jotai getDefaultStore() 读写
+const jotai = getDefaultStore();
+jotai.set(store.atoms.theme, 'light');   // 自动 debounce 持久化
+console.log(jotai.get(store.atoms.count));
+
+// 或使用 MongoDB
+const store2 = createNodeStore('entity-456', [
+  { key: 'data', defaultValue: null },
+], {
+  storage: await mongodbStorage({
+    url: 'mongodb://localhost:27017',
+    database: 'myapp',
+  }),
 });
+```
+
+### 环境检测
 
-const store = createStore('entity-123', config, { storage: adapter });
+```typescript
+import { isNode, isBrowser } from 'bff-store';
+
+if (isNode()) {
+  // Node.js 环境
+}
+
+if (isBrowser()) {
+  // 浏览器环境
+}
 ```
 
 ## API Endpoints (BFF Server)
@@ -213,7 +242,7 @@ Note: Storage backend is configured by the client via `remoteStorage()` options,
 
 | Export | Description | Environment |
 |--------|-------------|-------------|
-| `bff-store` | Main entry: createStore, useStore, memoryStorage, remoteStorage | Browser + Node.js |
+| `bff-store` | Main entry: createStore, useStore, createNodeStore, isNode, isBrowser, memoryStorage, remoteStorage | Browser + Node.js |
 | `bff-store/jsonl` | JSONL storage adapter | Node.js only |
 | `bff-store/mongodb` | MongoDB storage adapter | Node.js only |
 | `bff-store/server` | BFF server (startServer, Router, etc.) | Node.js only |

package/dist/index.d.mts

@@ -229,4 +229,45 @@ interface RemoteStorageOptions {
  */
 declare function remoteStorage(options?: RemoteStorageOptions): StorageAdapter;
 
-export { type AsyncStorageFactory, type AtomConfig, type AtomConfigs, type AtomType, HttpTransport, type MemoryStorageOptions, RestStorageProtocol, type Storage, type StorageAdapter, type StorageFactory, type StorageHttpProtocol, type StorageOptions, type Store, type TransportAdapter, type UseStoreReturn, createMemoryStorage, createPersistedAtom, remoteStorage as createRemoteStorage, createStorageFromTransport, createStorageWithProtocol, createStore, memoryStorage, remoteStorage, useStore };
+/**
+ * Environment detection utilities
+ */
+declare function isNode(): boolean;
+declare function isBrowser(): boolean;
+
+/**
+ * Create a store for Node.js environments.
+ *
+ * @example
+ * ```typescript
+ * import { jsonlStorage } from 'bff-store/jsonl';
+ * import { createNodeStore } from 'bff-store';
+ *
+ * const store = createNodeStore('entity-123', [
+ *   { key: 'theme', defaultValue: 'dark' },
+ * ], {
+ *   storage: jsonlStorage({ dir: './sessions' }),
+ * });
+ *
+ * await store.waitForLoad();
+ *
+ * const jotai = getDefaultStore();
+ * jotai.set(store.atoms.theme, 'light');
+ * ```
+ */
+declare function createNodeStore(entityId: string, config: AtomConfigs, options: {
+    storage: StorageAdapter;
+    debounceMs?: number;
+}): {
+    /** Atoms to use with getDefaultStore().get/set */
+    atoms: StoreAtoms;
+    /** Loading state atoms */
+    loadingAtoms: StoreLoadingAtoms;
+    /**
+     * Wait for all atoms to finish loading from storage.
+     * Call this after creating the store to ensure data is ready.
+     */
+    waitForLoad(): Promise<void>;
+};
+
+export { type AsyncStorageFactory, type AtomConfig, type AtomConfigs, type AtomType, HttpTransport, type MemoryStorageOptions, RestStorageProtocol, type Storage, type StorageAdapter, type StorageFactory, type StorageHttpProtocol, type StorageOptions, type Store, type TransportAdapter, type UseStoreReturn, createMemoryStorage, createNodeStore, createPersistedAtom, remoteStorage as createRemoteStorage, createStorageFromTransport, createStorageWithProtocol, createStore, isBrowser, isNode, memoryStorage, remoteStorage, useStore };

package/dist/index.d.ts

@@ -229,4 +229,45 @@ interface RemoteStorageOptions {
  */
 declare function remoteStorage(options?: RemoteStorageOptions): StorageAdapter;
 
-export { type AsyncStorageFactory, type AtomConfig, type AtomConfigs, type AtomType, HttpTransport, type MemoryStorageOptions, RestStorageProtocol, type Storage, type StorageAdapter, type StorageFactory, type StorageHttpProtocol, type StorageOptions, type Store, type TransportAdapter, type UseStoreReturn, createMemoryStorage, createPersistedAtom, remoteStorage as createRemoteStorage, createStorageFromTransport, createStorageWithProtocol, createStore, memoryStorage, remoteStorage, useStore };
+/**
+ * Environment detection utilities
+ */
+declare function isNode(): boolean;
+declare function isBrowser(): boolean;
+
+/**
+ * Create a store for Node.js environments.
+ *
+ * @example
+ * ```typescript
+ * import { jsonlStorage } from 'bff-store/jsonl';
+ * import { createNodeStore } from 'bff-store';
+ *
+ * const store = createNodeStore('entity-123', [
+ *   { key: 'theme', defaultValue: 'dark' },
+ * ], {
+ *   storage: jsonlStorage({ dir: './sessions' }),
+ * });
+ *
+ * await store.waitForLoad();
+ *
+ * const jotai = getDefaultStore();
+ * jotai.set(store.atoms.theme, 'light');
+ * ```
+ */
+declare function createNodeStore(entityId: string, config: AtomConfigs, options: {
+    storage: StorageAdapter;
+    debounceMs?: number;
+}): {
+    /** Atoms to use with getDefaultStore().get/set */
+    atoms: StoreAtoms;
+    /** Loading state atoms */
+    loadingAtoms: StoreLoadingAtoms;
+    /**
+     * Wait for all atoms to finish loading from storage.
+     * Call this after creating the store to ensure data is ready.
+     */
+    waitForLoad(): Promise<void>;
+};
+
+export { type AsyncStorageFactory, type AtomConfig, type AtomConfigs, type AtomType, HttpTransport, type MemoryStorageOptions, RestStorageProtocol, type Storage, type StorageAdapter, type StorageFactory, type StorageHttpProtocol, type StorageOptions, type Store, type TransportAdapter, type UseStoreReturn, createMemoryStorage, createNodeStore, createPersistedAtom, remoteStorage as createRemoteStorage, createStorageFromTransport, createStorageWithProtocol, createStore, isBrowser, isNode, memoryStorage, remoteStorage, useStore };

package/dist/index.mjs

@@ -415,15 +415,58 @@ function remoteStorage(options = {}) {
   };
   return adapter;
 }
+
+// src/environment.ts
+function isNode() {
+  return typeof window === "undefined" && typeof process !== "undefined";
+}
+function isBrowser() {
+  return typeof window !== "undefined";
+}
+
+// src/nodeStore.ts
+import { getDefaultStore as getDefaultStore3 } from "jotai";
+function createNodeStore(entityId, config, options) {
+  const store = createStore(entityId, config, options);
+  const jotaiStore = getDefaultStore3();
+  async function waitForLoad() {
+    for (const atom2 of Object.values(store.atoms)) {
+      jotaiStore.sub(atom2, () => {
+      });
+    }
+    return new Promise((resolve) => {
+      const loadingAtoms = Object.values(store.loadingAtoms);
+      const stillLoading = () => loadingAtoms.some((atom2) => jotaiStore.get(atom2));
+      if (!stillLoading()) {
+        resolve();
+        return;
+      }
+      const interval = setInterval(() => {
+        if (!stillLoading()) {
+          clearInterval(interval);
+          resolve();
+        }
+      }, 10);
+    });
+  }
+  return {
+    atoms: store.atoms,
+    loadingAtoms: store.loadingAtoms,
+    waitForLoad
+  };
+}
 export {
   HttpTransport,
   RestStorageProtocol,
   createMemoryStorage,
+  createNodeStore,
   createPersistedAtom,
   remoteStorage as createRemoteStorage,
   createStorageFromTransport,
   createStorageWithProtocol,
   createStore,
+  isBrowser,
+  isNode,
   memoryStorage,
   remoteStorage,
   useStore

package/dist/package.json

@@ -8,8 +8,7 @@
   "exports": {
     ".": {
       "types": "./index.d.ts",
-      "import": "./index.mjs",
-      "require": "./index.js"
+      "import": "./index.mjs"
     },
     "./jsonl": {
       "types": "./storage/jsonl-entry.d.ts",
@@ -50,13 +49,11 @@
     "@types/react": "^19.2.16",
     "jotai": "^2.6.0",
     "jsdom": "^29.1.1",
+    "mongodb": "^6.21.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
     "vitest": "^1.0.0"
-  },
-  "dependencies": {
-    "mongodb": "^6.21.0"
   }
 }