orbitdb-relay-pinner 0.1.1 → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Nico Krause
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -2,35 +2,63 @@
 
 OrbitDB relay + pinning/sync service used by our apps and tests.
 
+## AI Agents
+
+See `AGENTS.md` for an architecture and feature guide (entrypoints, data flow, env vars, and extension points).
+
 ## CLI
 
-Build:
+Install:
 
 ```bash
-npm --prefix packages/orbitdb-relay-pinner run build
+npm i orbitdb-relay-pinner
 ```
 
 Run:
 
 ```bash
-node packages/orbitdb-relay-pinner/dist/cli.js
+orbitdb-relay-pinner
 ```
 
-Test mode (deterministic peer id via `TEST_PRIVATE_KEY`):
+Test mode (deterministic peer id via `TEST_PRIVATE_KEY` or `RELAY_PRIV_KEY`):
 
 ```bash
-node packages/orbitdb-relay-pinner/dist/cli.js --test
+orbitdb-relay-pinner --test
 ```
 
-## Why This Exists
-
-- The relay must be able to verify OrbitDB entries created by `did:key` identities.
-- This package registers `@orbitdb/identity-provider-did` with a `key-did-resolver` resolver before opening OrbitDB.
-
 ## Environment Variables (common)
 
 - `RELAY_TCP_PORT`, `RELAY_WS_PORT`, `RELAY_WEBRTC_PORT`
 - `RELAY_DISABLE_WEBRTC=true` to disable UDP `/webrtc-direct` listener in constrained environments
 - `METRICS_PORT=0` to bind metrics on an ephemeral port (avoid `EADDRINUSE`)
-- `TEST_PRIVATE_KEY` for `--test` runs
+- `DATASTORE_PATH` or `RELAY_DATASTORE_PATH` to control where LevelDB data is stored
+- `PUBSUB_TOPICS` to override pubsub peer discovery topics (default: `todo._peer-discovery._p2p._pubsub`)
+- `TEST_PRIVATE_KEY` / `RELAY_PRIV_KEY` for `--test` runs (optional)
+- `PIN_DATABASE_ALLOWLIST` optional comma-separated filter (matches db address/name substrings) to restrict which OrbitDB databases are pinned
+
+## Development
+
+```bash
+npm i
+npm run build
+node dist/cli.js --test
+```
+
+## Pinning Behavior
+
+- The relay scans document payloads for candidate IPFS CIDs and pins them.
+- It prioritizes CID-oriented fields (for example `cid`, `mediaIds`, `...Cid`, `...Cids`, and settings-style CID references) and also parses IPFS links in strings.
+- Extracted CID forms include:
+  - direct CID strings
+  - `ipfs://<cid>`
+  - `/ipfs/<cid>` paths
+  - bare CID tokens (eg `bafy...`, `Qm...`) found in text
+- Pinning is deduplicated per database to avoid re-pinning the same CID repeatedly.
+
+## Docker Compose Example
+
+See `docker-compose.example.yml` for a minimal deployment example with:
 
+- persistent datastore volume (PeerId/key survives restarts)
+- relay + metrics ports exposed (`9091/tcp`, `9092/tcp`, `9093/udp`, `9090/tcp`)
+- WebRTC enabled and AutoTLS left enabled by default

package/dist/services/database.d.ts

@@ -1,14 +1,25 @@
 import { MetricsServer } from './metrics.js';
 export declare class DatabaseService {
+    private static readonly CID_FIELD_KEYS;
     metrics: MetricsServer;
     identityDatabases: Map<string, any>;
     databaseContexts: Map<string, any>;
     updateTimers: Map<string, any>;
     openDatabases: Map<string, any>;
     eventHandlers: Map<string, any>;
+    processedDataCidsByDb: Map<string, Set<string>>;
     orbitdb: any;
+    ipfs: any;
     constructor();
     initialize(ipfs: any): Promise<void>;
+    private shouldPinDatabase;
+    private addCandidateCid;
+    private shouldTreatFieldAsCid;
+    private extractCandidateCids;
+    private pinCidIfNeeded;
+    private pinFromRecord;
+    private processDatabasePins;
+    private setupDatabaseListeners;
     syncAllOrbitDBRecords(dbAddress: string): Promise<void>;
 }
 //# sourceMappingURL=database.d.ts.map

package/dist/services/database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/services/database.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAI5C,qBAAa,eAAe;IAC1B,OAAO,EAAE,aAAa,CAAA;IACtB,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACnC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAClC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC9B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC/B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC/B,OAAO,EAAE,GAAG,CAAA;;IAWN,UAAU,CAAC,IAAI,EAAE,GAAG;IAMpB,qBAAqB,CAAC,SAAS,EAAE,MAAM;CAmD9C"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/services/database.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAI5C,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAOpC;IAEF,OAAO,EAAE,aAAa,CAAA;IACtB,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACnC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAClC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC9B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC/B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC/B,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAC/C,OAAO,EAAE,GAAG,CAAA;IACZ,IAAI,EAAE,GAAG,CAAA;;IAaH,UAAU,CAAC,IAAI,EAAE,GAAG;IAO1B,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,eAAe;IA0CvB,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,oBAAoB;YAiCd,cAAc;YAqBd,aAAa;YAQb,mBAAmB;IAQjC,OAAO,CAAC,sBAAsB;IAqBxB,qBAAqB,CAAC,SAAS,EAAE,MAAM;CAqD9C"}

package/dist/services/database.js

@@ -1,17 +1,28 @@
 import { createOrbitDB, useIdentityProvider } from '@orbitdb/core';
 import OrbitDBIdentityProviderDID from '@orbitdb/identity-provider-did';
 import * as KeyDIDResolver from 'key-did-resolver';
+import { CID } from 'multiformats/cid';
 import { MetricsServer } from './metrics.js';
-import { log, syncLog, logSyncStats } from '../utils/logger.js';
+import { syncLog, logSyncStats } from '../utils/logger.js';
 import { loggingConfig } from '../config/logging.js';
 export class DatabaseService {
+    static CID_FIELD_KEYS = new Set([
+        'cid',
+        'cids',
+        'mediaid',
+        'mediaids',
+        'profilepicture',
+        'profilepicturecid',
+    ]);
     metrics;
     identityDatabases;
     databaseContexts;
     updateTimers;
     openDatabases;
     eventHandlers;
+    processedDataCidsByDb;
     orbitdb;
+    ipfs;
     constructor() {
         this.metrics = new MetricsServer();
         this.identityDatabases = new Map();
@@ -19,12 +30,166 @@ export class DatabaseService {
         this.updateTimers = new Map();
         this.openDatabases = new Map();
         this.eventHandlers = new Map();
+        this.processedDataCidsByDb = new Map();
+        this.ipfs = null;
     }
     async initialize(ipfs) {
         OrbitDBIdentityProviderDID.setDIDResolver(KeyDIDResolver.getResolver());
         useIdentityProvider(OrbitDBIdentityProviderDID);
+        this.ipfs = ipfs;
         this.orbitdb = await createOrbitDB({ ipfs });
     }
+    shouldPinDatabase(dbAddress, dbName) {
+        const rawAllowlist = process.env.PIN_DATABASE_ALLOWLIST;
+        if (!rawAllowlist || rawAllowlist.trim() === '')
+            return true;
+        const allowed = rawAllowlist
+            .split(',')
+            .map((s) => s.trim().toLowerCase())
+            .filter(Boolean);
+        if (allowed.length === 0)
+            return true;
+        const haystack = `${dbAddress} ${dbName || ''}`.toLowerCase();
+        return allowed.some((token) => haystack.includes(token));
+    }
+    addCandidateCid(candidate, out) {
+        if (typeof candidate !== 'string')
+            return;
+        const trimmed = candidate.trim();
+        if (!trimmed)
+            return;
+        try {
+            out.add(CID.parse(trimmed).toString());
+            return;
+        }
+        catch {
+            // ignore
+        }
+        const ipfsUriMatches = [...trimmed.matchAll(/ipfs:\/\/([^/?#\s]+)/gi)];
+        for (const match of ipfsUriMatches) {
+            try {
+                out.add(CID.parse(match[1]).toString());
+            }
+            catch {
+                // ignore
+            }
+        }
+        const ipfsPathMatches = trimmed.match(/\/ipfs\/([^/?#\s]+)/gi) || [];
+        for (const match of ipfsPathMatches) {
+            const part = match.split('/ipfs/')[1];
+            if (!part)
+                continue;
+            try {
+                out.add(CID.parse(part).toString());
+            }
+            catch {
+                // ignore
+            }
+        }
+        const bareCidMatches = [...trimmed.matchAll(/\b(bafy[a-z2-7]{20,}|bafk[a-z2-7]{20,}|Qm[1-9A-HJ-NP-Za-km-z]{44})\b/g)];
+        for (const match of bareCidMatches) {
+            try {
+                out.add(CID.parse(match[1]).toString());
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+    shouldTreatFieldAsCid(lowerKey) {
+        return (DatabaseService.CID_FIELD_KEYS.has(lowerKey) ||
+            lowerKey.endsWith('cid') ||
+            lowerKey.endsWith('cids'));
+    }
+    extractCandidateCids(value, out, visited = new WeakSet()) {
+        if (value == null)
+            return;
+        if (typeof value === 'string') {
+            this.addCandidateCid(value, out);
+            return;
+        }
+        if (Array.isArray(value)) {
+            for (const item of value)
+                this.extractCandidateCids(item, out, visited);
+            return;
+        }
+        if (typeof value === 'object') {
+            const obj = value;
+            if (visited.has(obj))
+                return;
+            visited.add(obj);
+            const idValue = typeof obj._id === 'string' ? obj._id.toLowerCase() : '';
+            const valueIsCidById = idValue.endsWith('cid') || idValue.endsWith('cids') || idValue === 'profilepicture';
+            for (const [key, fieldValue] of Object.entries(obj)) {
+                const lowerKey = key.toLowerCase();
+                if (this.shouldTreatFieldAsCid(lowerKey) || (lowerKey === 'value' && valueIsCidById)) {
+                    this.addCandidateCid(fieldValue, out);
+                }
+                else if (typeof fieldValue === 'string' && (fieldValue.includes('ipfs://') || fieldValue.includes('/ipfs/'))) {
+                    this.addCandidateCid(fieldValue, out);
+                }
+                this.extractCandidateCids(fieldValue, out, visited);
+            }
+        }
+    }
+    async pinCidIfNeeded(dbAddress, cid) {
+        if (!this.ipfs?.pins?.add)
+            return;
+        if (!this.processedDataCidsByDb.has(dbAddress))
+            this.processedDataCidsByDb.set(dbAddress, new Set());
+        const seen = this.processedDataCidsByDb.get(dbAddress);
+        if (seen.has(cid))
+            return;
+        try {
+            await this.ipfs.pins.add(CID.parse(cid));
+            seen.add(cid);
+            if (loggingConfig.logLevels.database) {
+                syncLog(`Pinned data CID for ${dbAddress}:`, cid);
+            }
+        }
+        catch (err) {
+            if (loggingConfig.logLevels.database) {
+                // eslint-disable-next-line no-console
+                console.error(`Failed to pin data CID ${cid} for ${dbAddress}:`, err);
+            }
+        }
+    }
+    async pinFromRecord(dbAddress, record) {
+        const candidateCids = new Set();
+        this.extractCandidateCids(record, candidateCids);
+        for (const cid of candidateCids) {
+            await this.pinCidIfNeeded(dbAddress, cid);
+        }
+    }
+    async processDatabasePins(dbAddress, db, records) {
+        if (!this.shouldPinDatabase(dbAddress, db?.name))
+            return;
+        for (const record of records) {
+            await this.pinFromRecord(dbAddress, record);
+        }
+    }
+    setupDatabaseListeners(dbAddress, db) {
+        if (!db?.events?.on)
+            return;
+        if (this.eventHandlers.has(dbAddress))
+            return;
+        if (!this.shouldPinDatabase(dbAddress, db?.name))
+            return;
+        const updateHandler = async (entry) => {
+            try {
+                await this.pinFromRecord(dbAddress, entry);
+                await this.pinFromRecord(dbAddress, entry?.value);
+            }
+            catch (err) {
+                if (loggingConfig.logLevels.database) {
+                    // eslint-disable-next-line no-console
+                    console.error(`Failed to process update pins for ${dbAddress}:`, err);
+                }
+            }
+        };
+        db.events.on('update', updateHandler);
+        this.eventHandlers.set(dbAddress, updateHandler);
+    }
     async syncAllOrbitDBRecords(dbAddress) {
         syncLog('Starting sync for database:', dbAddress);
         const endTimer = this.metrics.startSyncTimer('all_databases');
@@ -36,9 +201,11 @@ export class DatabaseService {
             else {
                 db = await this.orbitdb.open(dbAddress);
                 this.openDatabases.set(dbAddress, db);
+                this.setupDatabaseListeners(dbAddress, db);
             }
             const previousCounts = this.identityDatabases.get(dbAddress) || { posts: 0, comments: 0, media: 0 };
             const records = await db.all();
+            await this.processDatabasePins(dbAddress, db, records);
             if (records.length > 0) {
                 syncLog(`Sample record from ${db.name}:`, JSON.stringify(records[0], null, 2));
             }

package/dist/services/database.js.map

@@ -1 +1 @@
-{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/services/database.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/services/database.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,16 +1,33 @@
 {
   "name": "orbitdb-relay-pinner",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "private": false,
   "type": "module",
   "description": "OrbitDB relay + pinning/sync service for Helia/libp2p stacks.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NiKrause/orbitdb-relay-pinner.git"
+  },
+  "bugs": {
+    "url": "https://github.com/NiKrause/orbitdb-relay-pinner/issues"
+  },
+  "homepage": "https://github.com/NiKrause/orbitdb-relay-pinner#readme",
+  "keywords": [
+    "orbitdb",
+    "libp2p",
+    "helia",
+    "ipfs",
+    "relay",
+    "pinning"
+  ],
   "license": "MIT",
   "engines": {
     "node": ">=22"
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "main": "./dist/index.js",
   "exports": {
@@ -26,6 +43,9 @@
     "build": "tsc -p tsconfig.json && node scripts/add-shebang.mjs",
     "prepack": "npm run build"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "@chainsafe/libp2p-gossipsub": "^14.1.1",
     "@chainsafe/libp2p-noise": "^16.1.3",
@@ -56,6 +76,7 @@
     "key-did-resolver": "^4.0.0"
   },
   "devDependencies": {
+    "@types/node": "^22.13.1",
     "typescript": "^5.8.3"
   }
 }