@degenerate/sharedata 0.7.0 → 0.9.0

package/README.md

@@ -44,7 +44,10 @@ ship here:
 | `FirestoreShareDataRepository` | one Firestore document per block | hosted/multi-node deployments |
 | `InMemoryShareDataRepository` | an in-process `Map` | tests and parity (still round-trips the trust gate) |
 
-`firebase-admin` is an **optional peer dependency** — only install it if you
-use `FirestoreShareDataRepository`. The repository takes an injected
-`firestore.Firestore` instance (the host initializes its own app); the package
-never references `firebase-admin` at runtime.
+`firebase-admin` (13.9+ or 14) is an optional peer dependency, here and in `@degenerate/generic`.
+This package's own code only uses its types: `FirestoreShareDataRepository` takes an injected
+`Firestore` instance (from `firebase-admin/firestore`; the host initializes its own app), so install
+firebase-admin yourself when you use it. Nothing else needs it at runtime. The type declarations
+of this package and `@degenerate/generic` do import its types, so a TypeScript project needs it
+installed (a dev dependency is enough) to typecheck against them; see the `@degenerate/generic`
+README.

package/dist/persistence/firestore-share-data-repository.d.ts

@@ -1,4 +1,4 @@
-import type { firestore } from 'firebase-admin';
+import type { Firestore } from 'firebase-admin/firestore';
 import { LibraryStore, PersistedShareData } from '@degenerate/generic';
 import { ShareData } from '../share-data/share-data';
 import { ShareDataRepository } from './share-data-repository';
@@ -14,7 +14,7 @@ export declare class FirestoreShareDataRepository implements ShareDataRepository
     private readonly firestore;
     private readonly collectionName;
     private readonly libraryStore?;
-    constructor(firestore: firestore.Firestore, collectionName?: string, libraryStore?: LibraryStore | undefined);
+    constructor(firestore: Firestore, collectionName?: string, libraryStore?: LibraryStore | undefined);
     save(snapshot: PersistedShareData): Promise<void>;
     load(id: string): Promise<ShareData | undefined>;
     loadAll(): Promise<ShareData[]>;

package/dist/persistence/firestore-share-data-repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"firestore-share-data-repository.d.ts","sourceRoot":"","sources":["../../src/persistence/firestore-share-data-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAEH,YAAY,EACZ,kBAAkB,EAGrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAU9D;;;;;;;GAOG;AACH,qBAAa,4BAA6B,YAAW,mBAAmB;IAEhE,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAFb,SAAS,EAAE,SAAS,CAAC,SAAS,EAC9B,cAAc,GAAE,MAAuD,EACvE,YAAY,CAAC,EAAE,YAAY,YAAA;IAG1C,IAAI,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAQhD,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAK/B,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAOjD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,OAAO,CAAC,MAAM;IAId;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;;;OAMG;IACH,OAAO,CAAC,KAAK;CAYhB"}
+{"version":3,"file":"firestore-share-data-repository.d.ts","sourceRoot":"","sources":["../../src/persistence/firestore-share-data-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmC,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE3F,OAAO,EAEH,YAAY,EACZ,kBAAkB,EAIrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAU9D;;;;;;;GAOG;AACH,qBAAa,4BAA6B,YAAW,mBAAmB;IAEhE,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAFb,SAAS,EAAE,SAAS,EACpB,cAAc,GAAE,MAAuD,EACvE,YAAY,CAAC,EAAE,YAAY,YAAA;IAG1C,IAAI,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAQhD,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAK/B,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAOjD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,OAAO,CAAC,MAAM;IAId;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;;;OAMG;IACH,OAAO,CAAC,KAAK;CAShB"}

package/dist/persistence/firestore-share-data-repository.js

@@ -66,11 +66,10 @@ class FirestoreShareDataRepository {
      * rejected rather than silently writing to an unexpected document or path.
      */
     docId(id) {
-        if (id.length === 0 ||
-            id.includes('/') ||
-            id === '.' ||
-            id === '..' ||
-            /^__.*__$/.test(id)) {
+        // The shared Firestore id rule: refuses empty, '/', '.', '..', reserved (`__x__`, including
+        // with a line terminator inside), over 1,500 bytes, and a lone UTF-16 surrogate, which
+        // Firestore would turn into U+FFFD and so read, write or delete a different document.
+        if (!(0, generic_1.isFirestoreDocumentId)(id)) {
             throw new generic_1.ShareDataPersistenceError(id, 'invalid Firestore document id');
         }
         return id;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@degenerate/sharedata",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "This contains the ShareData Adaptive Framework Ecosystem (SAFE) network core code",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,6 +16,7 @@
   "scripts": {
     "build": "rm -rf dist/* && tsc -p tsconfig.pkg.json",
     "compile": "rm -rf dist/* && tsc -p tsconfig.pkg.json",
+    "typecheck": "tsc -p tsconfig.test.json --noEmit",
     "test": "jest --forceExit --detectOpenHandles --verbose --silent=false --env node",
     "test:coverage": "jest --forceExit --coverage --detectOpenHandles --verbose --silent=false --env node ",
     "test:clearCache": "jest --clearCache"
@@ -23,13 +24,13 @@
   "devDependencies": {
     "@types/jest": "^30.0.0",
     "@types/node": "^22.19.18",
-    "firebase-admin": "^13.10.0",
+    "firebase-admin": "^14.5.0",
     "jest": "^30.4.2",
     "ts-jest": "^29.4.9",
     "typescript": "^6.0.3"
   },
   "peerDependencies": {
-    "firebase-admin": "^13.10.0"
+    "firebase-admin": "^13.9.0 || ^14.0.0"
   },
   "peerDependenciesMeta": {
     "firebase-admin": {
@@ -49,11 +50,11 @@
     "url": "https://github.com/syncrude/safe/issues"
   },
   "homepage": "https://github.com/syncrude/safe#readme",
-  "gitHead": "1f747e160c9022863c7b2d7b8a6a157f204be95b",
+  "gitHead": "ba6cf5462c9912afb489984812703c0ce889472c",
   "dependencies": {
-    "@degenerate/generic": "^0.7.0",
-    "@degenerate/rules": "^0.7.0",
-    "zod": "^4.4.3"
+    "@degenerate/generic": "^0.9.0",
+    "@degenerate/rules": "^0.9.0",
+    "zod": "^4.6.6"
   },
   "engines": {
     "node": ">=22"