hyperchess-store 0.1.0

package/dist/types/game-store.js

@@ -0,0 +1,66 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// HyperChess Core — hyperchess-store
+// File: packages/store/src/types/game-store.ts
+// Version: 1.0.0
+// Copyright (c) 2026 HyperChess Developer Team
+/**
+ * Check if a game store is reachable, without letting a backend failure escape.
+ *
+ * Wraps `isHealthy()` so that a driver-level throw (connection refused, expired
+ * credentials) reads as "offline" rather than crashing the caller — the intended
+ * use is an availability probe on a sync path, not error reporting.
+ *
+ * @param store - Store to probe.
+ * @returns `true` only if `isHealthy()` resolved `true`; `false` if it resolved
+ *   `false` or threw.
+ */
+export async function isStoreOnline(store) {
+    try {
+        return await store.isHealthy();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Copy games from one store into another, one record at a time.
+ *
+ * Best-effort and non-transactional: a game that fails to save is logged and
+ * skipped so a single bad record cannot abort the whole sync, which matters when
+ * draining an offline queue on reconnect. Records are not deleted from the
+ * source, so this is a copy rather than a move.
+ *
+ * @param fromStore - Source of truth to read from.
+ * @param toStore - Destination the games are written into.
+ * @param options - `userId` restricts the copy to one owner's games;
+ *   `overwrite` deletes the destination record first so the source version wins
+ *   outright instead of being merged by the destination's upsert semantics.
+ * @returns How many games were saved successfully — may be fewer than the number
+ *   read from the source.
+ */
+export async function syncStores(fromStore, toStore, options) {
+    const games = await fromStore.listGames({
+        userId: options?.userId,
+    });
+    let syncedCount = 0;
+    for (const game of games) {
+        try {
+            if (options?.overwrite) {
+                // Delete if exists, then save
+                try {
+                    await toStore.deleteGame(game.id);
+                }
+                catch {
+                    // Game doesn't exist in target, that's ok
+                }
+            }
+            await toStore.saveGame(game);
+            syncedCount++;
+        }
+        catch (error) {
+            console.warn(`Failed to sync game ${game.id}:`, error);
+        }
+    }
+    return syncedCount;
+}
+//# sourceMappingURL=game-store.js.map

package/dist/types/game-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-store.js","sourceRoot":"","sources":["../../src/types/game-store.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,qCAAqC;AACrC,+CAA+C;AAC/C,iBAAiB;AACjB,+CAA+C;AA+E/C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAgB;IAClD,IAAI,CAAC;QACH,OAAO,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,SAAoB,EACpB,OAAkB,EAClB,OAAkD;IAElD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC;QACtC,MAAM,EAAE,OAAO,EAAE,MAAM;KACxB,CAAC,CAAC;IAEH,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;gBACvB,8BAA8B;gBAC9B,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACpC,CAAC;gBAAC,MAAM,CAAC;oBACP,0CAA0C;gBAC5C,CAAC;YACH,CAAC;YAED,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC7B,WAAW,EAAE,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "hyperchess-store",
+  "version": "0.1.0",
+  "description": "HyperChess game storage abstraction - works with any backend",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./postgres": {
+      "import": "./dist/adapters/postgres.js",
+      "types": "./dist/adapters/postgres.d.ts"
+    },
+    "./sqlite": {
+      "import": "./dist/adapters/sqlite.js",
+      "types": "./dist/adapters/sqlite.d.ts"
+    },
+    "./firebase": {
+      "import": "./dist/adapters/firebase.js",
+      "types": "./dist/adapters/firebase.d.ts"
+    },
+    "./supabase": {
+      "import": "./dist/adapters/supabase.js",
+      "types": "./dist/adapters/supabase.d.ts"
+    },
+    "./memory": {
+      "import": "./dist/adapters/memory.js",
+      "types": "./dist/adapters/memory.d.ts"
+    }
+  },
+  "peerDependencies": {
+    "pg": "^8.0.0",
+    "better-sqlite3": "^8.0.0 || ^9.0.0 || ^10.0.0 || ^11.0.0 || ^12.0.0",
+    "firebase": "^9.0.0 || ^10.0.0 || ^11.0.0 || ^12.0.0",
+    "@supabase/supabase-js": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "pg": {
+      "optional": true
+    },
+    "better-sqlite3": {
+      "optional": true
+    },
+    "firebase": {
+      "optional": true
+    },
+    "@supabase/supabase-js": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "hyperchess-core": "0.1.0"
+  },
+  "devDependencies": {
+    "firebase": "^12.0.0",
+    "typescript": "^5.2.0",
+    "vitest": "^0.34.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "hyperchess",
+    "storage",
+    "database",
+    "postgres",
+    "sqlite",
+    "firebase",
+    "supabase"
+  ],
+  "author": "HyperChess Contributors",
+  "license": "GPL-3.0-or-later",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KyrpyDev/hyperchess-core.git",
+    "directory": "packages/store"
+  },
+  "homepage": "https://github.com/KyrpyDev/hyperchess-core#readme",
+  "bugs": {
+    "url": "https://github.com/KyrpyDev/hyperchess-core/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}