@topgunbuild/server 0.10.0 → 0.10.1

package/dist/chunk-ZTICMRY6.mjs

@@ -0,0 +1,7 @@
+// src/storage/IServerStorage.ts
+var ORMAP_MARKER = "__ORMAP__";
+
+export {
+  ORMAP_MARKER
+};
+//# sourceMappingURL=chunk-ZTICMRY6.mjs.map

package/dist/chunk-ZTICMRY6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storage/IServerStorage.ts"],"sourcesContent":["import { LWWRecord, ORMapRecord } from '@topgunbuild/core';\n\n/**\n * Marker used in ts_node_id column to distinguish ORMap values from LWW records.\n * This allows storing both CRDT types in the same table structure.\n * Used by PostgresAdapter and BetterSqlite3Adapter.\n */\nexport const ORMAP_MARKER = '__ORMAP__';\n\nexport type ORMapValue<V> = {\n  type: 'OR';\n  records: ORMapRecord<V>[];\n};\n\nexport type ORMapTombstones = {\n  type: 'OR_TOMBSTONES';\n  tags: string[];\n};\n\nexport type StorageValue<V> = LWWRecord<V> | ORMapValue<V> | ORMapTombstones;\n\n/**\n * Server Persistence Interface (MapStore).\n * Aligned with specifications/06_SERVER_INTEGRATIONS.md\n * \n * Note: We include mapName in all methods because a single storage adapter\n * instance typically handles multiple maps in the system (e.g. single DB connection).\n */\nexport interface IServerStorage {\n  /**\n   * Initialize the storage connection.\n   */\n  initialize(): Promise<void>;\n\n  /**\n   * Close the storage connection.\n   */\n  close(): Promise<void>;\n\n  /**\n   * Loads the value of a given key.\n   * Called when a client requests a key that is not in the Server RAM (if using partial loading),\n   * or during sync.\n   */\n  load(mapName: string, key: string): Promise<StorageValue<any> | undefined>;\n\n  /**\n   * Loads multiple keys.\n   * Optimization for batch requests.\n   */\n  loadAll(mapName: string, keys: string[]): Promise<Map<string, StorageValue<any>>>;\n\n  /**\n   * Loads all keys from the store for a specific map.\n   * Used for pre-loading the cache on startup or understanding dataset size.\n   */\n  loadAllKeys(mapName: string): Promise<string[]>;\n\n  /**\n   * Stores the key-value pair.\n   */\n  store(mapName: string, key: string, record: StorageValue<any>): Promise<void>;\n\n  /**\n   * Stores multiple entries.\n   * Used for efficient batch writes to the DB.\n   */\n  storeAll(mapName: string, records: Map<string, StorageValue<any>>): Promise<void>;\n\n  /**\n   * Deletes the entry with the given key.\n   */\n  delete(mapName: string, key: string): Promise<void>;\n\n  /**\n   * Deletes multiple entries.\n   */\n  deleteAll(mapName: string, keys: string[]): Promise<void>;\n}\n"],"mappings":";AAOO,IAAM,eAAe;","names":[]}