@de-otio/trellis 0.7.0 → 0.9.0

package/dist/lib/graph/postgres/postgres-graph-service.d.ts

@@ -0,0 +1,74 @@
+/**
+ * PostgresGraphService — the graph serving path backed by Postgres
+ * (joins + recursive CTEs on the existing RDS). No separate graph DB,
+ * no dual-write. See the graph-backend contract in
+ * plans/redesign/graph-backend-contract.md.
+ *
+ * The implementation is split into per-method-group modules (relationships,
+ * circles, entity-relationships, discovery, scoring, sync) so Phase 1 can be
+ * filled in concurrently without merge conflicts. This service file is the
+ * stable composition + connection/health layer written in Phase 0; it should
+ * not need editing as the groups land.
+ */
+import type { PrismaClient } from "@prisma/client";
+import type { GraphConnection, GraphService } from "../graph-service.js";
+import type { EntityGeoLookup } from "../../geo/entity-geo-repository.js";
+import type { CircleTier, CreateEntityRelationshipInput, CreateRelationshipInput, DiscoveryFilters, EntityRelationshipStatus, GraphConnectionConfig, GraphHealthStatus, GraphNodeType, NearbyFilters, PaginationInput, RecordInteractionInput, SyncEntityInput, SyncOwnershipInput, SyncPostInput, SyncPostSubjectsInput, SyncUserInput, UpdateRelationshipScoreInput } from "../types.js";
+import type { InteractionEventConfig } from "./interaction-events.js";
+export declare class PostgresGraphService implements GraphService, GraphConnection {
+    private readonly prisma;
+    private connected;
+    private readonly relationships;
+    private readonly circles;
+    private readonly entityRelationships;
+    private readonly discovery;
+    private readonly scoring;
+    private readonly sync;
+    constructor(prisma: PrismaClient, geoLookup?: EntityGeoLookup, eventConfig?: InteractionEventConfig);
+    connect(_config: GraphConnectionConfig): Promise<void>;
+    close(): Promise<void>;
+    isConnected(): boolean;
+    healthCheck(): Promise<GraphHealthStatus>;
+    createRelationship(input: CreateRelationshipInput): Promise<import("../types.js").Relationship>;
+    removeRelationship(userId: string, targetType: GraphNodeType, targetId: string): Promise<void>;
+    updateRelationshipScore(input: UpdateRelationshipScoreInput): Promise<import("../types.js").Relationship>;
+    getRelationship(userId: string, targetType: GraphNodeType, targetId: string): Promise<import("../types.js").Relationship | null>;
+    getRelationships(userId: string, options?: {
+        tier?: CircleTier;
+        targetType?: GraphNodeType;
+        pagination?: PaginationInput;
+    }): Promise<import("../types.js").PaginatedResult<import("../types.js").Relationship>>;
+    getRelationshipGraph(userId: string): Promise<import("../types.js").GraphData>;
+    getCircleMembers(userId: string, tier: CircleTier): Promise<import("../types.js").CircleMember[]>;
+    getVisiblePostIds(userId: string, tier: CircleTier, since: Date, pagination: PaginationInput): Promise<import("../types.js").PaginatedResult<import("../types.js").VisiblePostResult>>;
+    getGlanceItems(userId: string, tier: CircleTier, limit: number): Promise<import("../types.js").GlanceItem[]>;
+    getDepthPostIds(userId: string, targetType: GraphNodeType, targetId: string, since: Date, limit: number): Promise<string[]>;
+    getCircleStatus(userId: string): Promise<import("../types.js").CircleTierStatus[]>;
+    getCircleEntityStatus(userId: string, tier: CircleTier): Promise<import("../types.js").CircleEntityStatus[]>;
+    markCircleRead(userId: string, tier: CircleTier, readAt?: Date): Promise<void>;
+    createEntityRelationship(input: CreateEntityRelationshipInput): Promise<import("../types.js").EntityRelationship>;
+    confirmEntityRelationship(entityId: string, relatedEntityId: string, confirmingUserId: string): Promise<import("../types.js").EntityRelationship>;
+    rejectEntityRelationship(entityId: string, relatedEntityId: string, rejectingUserId: string): Promise<void>;
+    removeEntityRelationship(entityId: string, relatedEntityId: string, removingUserId: string): Promise<void>;
+    getEntityRelationships(entityId: string, options?: {
+        type?: string;
+        status?: EntityRelationshipStatus;
+    }): Promise<import("../types.js").EntityRelationship[]>;
+    getPendingEntityRelationships(userId: string): Promise<import("../types.js").EntityRelationship[]>;
+    discoverByGraph(userId: string, hops: number, filters?: DiscoveryFilters): Promise<import("../types.js").DiscoveryResult[]>;
+    discoverNearby(userId: string, lat: number, lng: number, radiusMeters: number, filters?: NearbyFilters): Promise<import("../types.js").DiscoveryResult[]>;
+    getRecommendations(userId: string, limit: number): Promise<import("../types.js").Recommendation[]>;
+    recordInteraction(input: RecordInteractionInput): Promise<void>;
+    recomputeScores(userId: string): Promise<import("../types.js").ScoreUpdate[]>;
+    applyDecay(userId: string): Promise<import("../types.js").ScoreUpdate[]>;
+    syncUser(input: SyncUserInput): Promise<void>;
+    removeUser(userId: string): Promise<void>;
+    syncEntity(input: SyncEntityInput): Promise<void>;
+    removeEntity(entityId: string): Promise<void>;
+    syncPost(input: SyncPostInput): Promise<void>;
+    removePost(postId: string): Promise<void>;
+    syncPostSubjects(input: SyncPostSubjectsInput): Promise<void>;
+    syncOwnership(input: SyncOwnershipInput): Promise<void>;
+    removeOwnership(entityId: string, userId: string): Promise<void>;
+}
+//# sourceMappingURL=postgres-graph-service.d.ts.map

package/dist/lib/graph/postgres/postgres-graph-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-graph-service.d.ts","sourceRoot":"","sources":["../../../../src/lib/graph/postgres/postgres-graph-service.ts"],"names":[],"mappings":"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"}

package/dist/lib/graph/postgres/postgres-graph-service.js

@@ -0,0 +1,167 @@
+import { CircleOps } from "./circles.js";
+import { DiscoveryOps } from "./discovery.js";
+import { EntityRelationshipOps } from "./entity-relationships.js";
+import { RelationshipOps } from "./relationships.js";
+import { ScoringOps } from "./scoring.js";
+import { SyncOps } from "./sync.js";
+export class PostgresGraphService {
+    prisma;
+    connected = false;
+    relationships;
+    circles;
+    entityRelationships;
+    discovery;
+    scoring;
+    sync;
+    constructor(prisma, geoLookup, 
+    // Surveillance-hardening Phase 0 (P2): InteractionEvent dual-write config,
+    // threaded from env by graph-factory. Optional — existing call sites
+    // (tests) keep the conservative defaults.
+    eventConfig) {
+        this.prisma = prisma;
+        this.relationships = new RelationshipOps(prisma);
+        this.circles = new CircleOps(prisma);
+        this.entityRelationships = new EntityRelationshipOps(prisma);
+        this.discovery = new DiscoveryOps(prisma, geoLookup);
+        this.scoring = new ScoringOps(prisma, eventConfig);
+        this.sync = new SyncOps(prisma, geoLookup);
+    }
+    // ---- Connection & health -------------------------------------------------
+    async connect(_config) {
+        await this.prisma.$queryRaw `SELECT 1`;
+        this.connected = true;
+    }
+    async close() {
+        // The Prisma client lifecycle is owned by the factory/caller (it may be
+        // shared with other repositories); closing the graph service just marks
+        // it disconnected rather than disconnecting a possibly-shared client.
+        this.connected = false;
+    }
+    isConnected() {
+        return this.connected;
+    }
+    async healthCheck() {
+        const start = Date.now();
+        try {
+            await this.prisma.$queryRaw `SELECT 1`;
+            return { healthy: true, latencyMs: Date.now() - start, backend: "postgres" };
+        }
+        catch (error) {
+            return {
+                healthy: false,
+                latencyMs: Date.now() - start,
+                backend: "postgres",
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    // ---- Relationships (B1) --------------------------------------------------
+    createRelationship(input) {
+        return this.relationships.createRelationship(input);
+    }
+    removeRelationship(userId, targetType, targetId) {
+        return this.relationships.removeRelationship(userId, targetType, targetId);
+    }
+    updateRelationshipScore(input) {
+        return this.relationships.updateRelationshipScore(input);
+    }
+    getRelationship(userId, targetType, targetId) {
+        return this.relationships.getRelationship(userId, targetType, targetId);
+    }
+    getRelationships(userId, options) {
+        return this.relationships.getRelationships(userId, options);
+    }
+    getRelationshipGraph(userId) {
+        return this.relationships.getRelationshipGraph(userId);
+    }
+    // ---- Circles (B2) --------------------------------------------------------
+    getCircleMembers(userId, tier) {
+        return this.circles.getCircleMembers(userId, tier);
+    }
+    getVisiblePostIds(userId, tier, since, pagination) {
+        return this.circles.getVisiblePostIds(userId, tier, since, pagination);
+    }
+    getGlanceItems(userId, tier, limit) {
+        return this.circles.getGlanceItems(userId, tier, limit);
+    }
+    getDepthPostIds(userId, targetType, targetId, since, limit) {
+        return this.circles.getDepthPostIds(userId, targetType, targetId, since, limit);
+    }
+    getCircleStatus(userId) {
+        return this.circles.getCircleStatus(userId);
+    }
+    getCircleEntityStatus(userId, tier) {
+        return this.circles.getCircleEntityStatus(userId, tier);
+    }
+    markCircleRead(userId, tier, readAt) {
+        return this.circles.markCircleRead(userId, tier, readAt);
+    }
+    // ---- Entity relationships (B3) ------------------------------------------
+    createEntityRelationship(input) {
+        return this.entityRelationships.createEntityRelationship(input);
+    }
+    confirmEntityRelationship(entityId, relatedEntityId, confirmingUserId) {
+        return this.entityRelationships.confirmEntityRelationship(entityId, relatedEntityId, confirmingUserId);
+    }
+    rejectEntityRelationship(entityId, relatedEntityId, rejectingUserId) {
+        return this.entityRelationships.rejectEntityRelationship(entityId, relatedEntityId, rejectingUserId);
+    }
+    removeEntityRelationship(entityId, relatedEntityId, removingUserId) {
+        return this.entityRelationships.removeEntityRelationship(entityId, relatedEntityId, removingUserId);
+    }
+    getEntityRelationships(entityId, options) {
+        return this.entityRelationships.getEntityRelationships(entityId, options);
+    }
+    getPendingEntityRelationships(userId) {
+        return this.entityRelationships.getPendingEntityRelationships(userId);
+    }
+    // ---- Discovery (B4) ------------------------------------------------------
+    discoverByGraph(userId, hops, filters) {
+        return this.discovery.discoverByGraph(userId, hops, filters);
+    }
+    discoverNearby(userId, lat, lng, radiusMeters, filters) {
+        return this.discovery.discoverNearby(userId, lat, lng, radiusMeters, filters);
+    }
+    getRecommendations(userId, limit) {
+        return this.discovery.getRecommendations(userId, limit);
+    }
+    // ---- Scoring (B5) --------------------------------------------------------
+    recordInteraction(input) {
+        return this.scoring.recordInteraction(input);
+    }
+    recomputeScores(userId) {
+        return this.scoring.recomputeScores(userId);
+    }
+    applyDecay(userId) {
+        return this.scoring.applyDecay(userId);
+    }
+    // ---- Sync (B6) -----------------------------------------------------------
+    syncUser(input) {
+        return this.sync.syncUser(input);
+    }
+    removeUser(userId) {
+        return this.sync.removeUser(userId);
+    }
+    syncEntity(input) {
+        return this.sync.syncEntity(input);
+    }
+    removeEntity(entityId) {
+        return this.sync.removeEntity(entityId);
+    }
+    syncPost(input) {
+        return this.sync.syncPost(input);
+    }
+    removePost(postId) {
+        return this.sync.removePost(postId);
+    }
+    syncPostSubjects(input) {
+        return this.sync.syncPostSubjects(input);
+    }
+    syncOwnership(input) {
+        return this.sync.syncOwnership(input);
+    }
+    removeOwnership(entityId, userId) {
+        return this.sync.removeOwnership(entityId, userId);
+    }
+}
+//# sourceMappingURL=postgres-graph-service.js.map

package/dist/lib/graph/postgres/postgres-graph-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-graph-service.js","sourceRoot":"","sources":["../../../../src/lib/graph/postgres/postgres-graph-service.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,OAAO,oBAAoB;IAUZ;IATX,SAAS,GAAG,KAAK,CAAC;IACT,aAAa,CAAkB;IAC/B,OAAO,CAAY;IACnB,mBAAmB,CAAwB;IAC3C,SAAS,CAAe;IACxB,OAAO,CAAa;IACpB,IAAI,CAAU;IAE/B,YACmB,MAAoB,EACrC,SAA2B;IAC3B,2EAA2E;IAC3E,qEAAqE;IACrE,0CAA0C;IAC1C,WAAoC;QALnB,WAAM,GAAN,MAAM,CAAc;QAOrC,IAAI,CAAC,aAAa,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,mBAAmB,GAAG,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,SAAS,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,OAAO,CAAC,OAA8B;QAC1C,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAA,UAAU,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,wEAAwE;QACxE,wEAAwE;QACxE,sEAAsE;QACtE,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAA,UAAU,CAAC;YACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;QAC/E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;gBAC7B,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,6EAA6E;IAE7E,kBAAkB,CAAC,KAA8B;QAC/C,OAAO,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC;IACD,kBAAkB,CAAC,MAAc,EAAE,UAAyB,EAAE,QAAgB;QAC5E,OAAO,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC7E,CAAC;IACD,uBAAuB,CAAC,KAAmC;QACzD,OAAO,IAAI,CAAC,aAAa,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC;IACD,eAAe,CAAC,MAAc,EAAE,UAAyB,EAAE,QAAgB;QACzE,OAAO,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC1E,CAAC;IACD,gBAAgB,CACd,MAAc,EACd,OAIC;QAED,OAAO,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IACD,oBAAoB,CAAC,MAAc;QACjC,OAAO,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,6EAA6E;IAE7E,gBAAgB,CAAC,MAAc,EAAE,IAAgB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IACD,iBAAiB,CACf,MAAc,EACd,IAAgB,EAChB,KAAW,EACX,UAA2B;QAE3B,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IACzE,CAAC;IACD,cAAc,CAAC,MAAc,EAAE,IAAgB,EAAE,KAAa;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;IACD,eAAe,CACb,MAAc,EACd,UAAyB,EACzB,QAAgB,EAChB,KAAW,EACX,KAAa;QAEb,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAClF,CAAC;IACD,eAAe,CAAC,MAAc;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,qBAAqB,CAAC,MAAc,EAAE,IAAgB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IACD,cAAc,CAAC,MAAc,EAAE,IAAgB,EAAE,MAAa;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED,4EAA4E;IAE5E,wBAAwB,CAAC,KAAoC;QAC3D,OAAO,IAAI,CAAC,mBAAmB,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAClE,CAAC;IACD,yBAAyB,CACvB,QAAgB,EAChB,eAAuB,EACvB,gBAAwB;QAExB,OAAO,IAAI,CAAC,mBAAmB,CAAC,yBAAyB,CACvD,QAAQ,EACR,eAAe,EACf,gBAAgB,CACjB,CAAC;IACJ,CAAC;IACD,wBAAwB,CACtB,QAAgB,EAChB,eAAuB,EACvB,eAAuB;QAEvB,OAAO,IAAI,CAAC,mBAAmB,CAAC,wBAAwB,CACtD,QAAQ,EACR,eAAe,EACf,eAAe,CAChB,CAAC;IACJ,CAAC;IACD,wBAAwB,CACtB,QAAgB,EAChB,eAAuB,EACvB,cAAsB;QAEtB,OAAO,IAAI,CAAC,mBAAmB,CAAC,wBAAwB,CACtD,QAAQ,EACR,eAAe,EACf,cAAc,CACf,CAAC;IACJ,CAAC;IACD,sBAAsB,CACpB,QAAgB,EAChB,OAA8D;QAE9D,OAAO,IAAI,CAAC,mBAAmB,CAAC,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IACD,6BAA6B,CAAC,MAAc;QAC1C,OAAO,IAAI,CAAC,mBAAmB,CAAC,6BAA6B,CAAC,MAAM,CAAC,CAAC;IACxE,CAAC;IAED,6EAA6E;IAE7E,eAAe,CAAC,MAAc,EAAE,IAAY,EAAE,OAA0B;QACtE,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IACD,cAAc,CACZ,MAAc,EACd,GAAW,EACX,GAAW,EACX,YAAoB,EACpB,OAAuB;QAEvB,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;IACD,kBAAkB,CAAC,MAAc,EAAE,KAAa;QAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;IAED,6EAA6E;IAE7E,iBAAiB,CAAC,KAA6B;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD,eAAe,CAAC,MAAc;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,UAAU,CAAC,MAAc;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,6EAA6E;IAE7E,QAAQ,CAAC,KAAoB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IACD,UAAU,CAAC,MAAc;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IACD,UAAU,CAAC,KAAsB;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IACD,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IACD,QAAQ,CAAC,KAAoB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IACD,UAAU,CAAC,MAAc;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IACD,gBAAgB,CAAC,KAA4B;QAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IACD,aAAa,CAAC,KAAyB;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IACD,eAAe,CAAC,QAAgB,EAAE,MAAc;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/lib/graph/postgres/relationships.d.ts

@@ -0,0 +1,58 @@
+/**
+ * RELATES_TO edge operations on Postgres (`relationships` table).
+ *
+ * Phase 1 · B1. PORT from neo4j-graph-service.ts (relationship methods).
+ * Single-hop edge CRUD + per-user edge list + the visualization aggregation.
+ */
+import type { PrismaClient } from "@prisma/client";
+import type { CircleTier, CreateRelationshipInput, GraphData, GraphNodeType, PaginatedResult, PaginationInput, Relationship, UpdateRelationshipScoreInput } from "../types.js";
+export declare class RelationshipOps {
+    private readonly prisma;
+    constructor(prisma: PrismaClient);
+    /**
+     * Create a scored relationship from a user to a target (user or entity).
+     *
+     * Initial score comes from the connection method (CONNECTION_BONUSES, default
+     * 0.3 for `discovery`). For user→user targets, if the reverse edge already
+     * exists both edges are marked `reciprocated`. Idempotent like the Neo4j
+     * MERGE: a pre-existing edge is returned unchanged rather than throwing.
+     */
+    createRelationship(input: CreateRelationshipInput): Promise<Relationship>;
+    /**
+     * Remove a relationship. If a reciprocated user→user edge is removed, the
+     * reverse edge's `reciprocated` flag is cleared. Throws GraphNotFoundError
+     * when no edge exists.
+     */
+    removeRelationship(userId: string, targetType: GraphNodeType, targetId: string): Promise<void>;
+    /**
+     * Set or clear the manual score override. When `manualScore` is null the
+     * computed score takes over again. The effective score / tier are derived
+     * in {@link rowToRelationship}.
+     */
+    updateRelationshipScore(input: UpdateRelationshipScoreInput): Promise<Relationship>;
+    /** Get a specific relationship, or null if it does not exist. */
+    getRelationship(userId: string, targetType: GraphNodeType, targetId: string): Promise<Relationship | null>;
+    /**
+     * List a user's relationships, ordered by effective score descending, with
+     * optional tier / target-type filters and score-cursor pagination.
+     *
+     * Ordering and the cursor are over the EFFECTIVE score (manual override wins
+     * over computed). There is no stored effective-score column, so the ordering
+     * key is computed as `COALESCE(manual_score, computed_score)` in SQL.
+     */
+    getRelationships(userId: string, options?: {
+        tier?: CircleTier;
+        targetType?: GraphNodeType;
+        pagination?: PaginationInput;
+    }): Promise<PaginatedResult<Relationship>>;
+    /**
+     * Build the relationship-graph visualization payload.
+     *
+     * SECURITY: raw scores are NEVER returned. Each node exposes only `tier` and
+     * a coarse `closeness` value bucketed to the nearest 10 in [0, 100]
+     * (`round(score * 10) * 10`). Recent-auth, rate-limiting, and audit-logging
+     * are enforced by the caller; the score coarsening is applied here.
+     */
+    getRelationshipGraph(userId: string): Promise<GraphData>;
+}
+//# sourceMappingURL=relationships.d.ts.map

package/dist/lib/graph/postgres/relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../../../src/lib/graph/postgres/relationships.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AASnD,OAAO,KAAK,EACV,UAAU,EAEV,uBAAuB,EACvB,SAAS,EAET,aAAa,EACb,eAAe,EACf,eAAe,EACf,YAAY,EAEZ,4BAA4B,EAC7B,MAAM,aAAa,CAAC;AA0ErB,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IAEjD;;;;;;;OAOG;IACG,kBAAkB,CACtB,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,YAAY,CAAC;IAoExB;;;;OAIG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,aAAa,EACzB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAgChB;;;;OAIG;IACG,uBAAuB,CAC3B,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,YAAY,CAAC;IA8BxB,iEAAiE;IAC3D,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,aAAa,EACzB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAQ/B;;;;;;;OAOG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,UAAU,CAAC;QAClB,UAAU,CAAC,EAAE,aAAa,CAAC;QAC3B,UAAU,CAAC,EAAE,eAAe,CAAC;KAC9B,GACA,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;IA6CzC;;;;;;;OAOG;IACG,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CA2F/D"}

package/dist/lib/graph/postgres/relationships.js

@@ -0,0 +1,314 @@
+import { getCurrentTenantId } from "@de-otio/saas-foundation/tenant";
+import { GraphNotFoundError } from "../errors.js";
+import { CONNECTION_BONUSES, effectiveScore, scoreToTier, TIER_THRESHOLDS, } from "../scoring-engine.js";
+/**
+ * Map a `relationships` row to the Relationship DTO.
+ *
+ * Mirrors neo4j-graph-service.ts `recordToRelationship`: the effective `score`
+ * is `effectiveScore(manualScore, computedScore)` and `tier` is derived from
+ * that effective score (never read from a stored column — the persisted `tier`
+ * column is advisory/denormalized only).
+ */
+function rowToRelationship(row) {
+    const score = effectiveScore(row.manualScore, row.computedScore);
+    return {
+        userId: row.userId,
+        targetType: row.targetType,
+        targetId: row.targetId,
+        score,
+        computedScore: row.computedScore,
+        manualScore: row.manualScore,
+        tier: scoreToTier(score),
+        interactionCount: row.interactionCount,
+        lastInteractionAt: row.lastInteractionAt,
+        connectionMethod: (row.connectionMethod ?? "discovery"),
+        reciprocated: row.reciprocated === true,
+        createdAt: row.createdAt,
+    };
+}
+const TIER_NAMES = {
+    0: "inner",
+    1: "closeFriends",
+    2: "community",
+    3: "ambient",
+};
+/** Encode a score-based pagination cursor (base64 JSON, matches neo4j). */
+function encodeCursor(score) {
+    return Buffer.from(JSON.stringify({ score })).toString("base64");
+}
+/** Decode a score-based pagination cursor. Returns null if invalid. */
+function decodeCursor(cursor) {
+    try {
+        const parsed = JSON.parse(Buffer.from(cursor, "base64").toString("utf8"));
+        if (parsed && typeof parsed === "object" && "score" in parsed) {
+            const score = parsed.score;
+            if (typeof score === "number")
+                return score;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export class RelationshipOps {
+    prisma;
+    constructor(prisma) {
+        this.prisma = prisma;
+    }
+    /**
+     * Create a scored relationship from a user to a target (user or entity).
+     *
+     * Initial score comes from the connection method (CONNECTION_BONUSES, default
+     * 0.3 for `discovery`). For user→user targets, if the reverse edge already
+     * exists both edges are marked `reciprocated`. Idempotent like the Neo4j
+     * MERGE: a pre-existing edge is returned unchanged rather than throwing.
+     */
+    async createRelationship(input) {
+        const { userId, targetType, targetId, connectionMethod = "discovery" } = input;
+        const tenantId = getCurrentTenantId();
+        if (!tenantId) {
+            throw new GraphNotFoundError(`No tenant context for relationship from user ${userId} to ${targetType} ${targetId}`);
+        }
+        // Initial score by connection method (from scoring engine constants).
+        const initialScore = CONNECTION_BONUSES[connectionMethod] ?? 0.3;
+        const created = await this.prisma.$transaction(async (tx) => {
+            // Idempotent on (userId, targetType, targetId): if the edge already
+            // exists, return it (mirrors the Neo4j MERGE ON MATCH behavior).
+            const existing = await tx.relationship.findUnique({
+                where: {
+                    userId_targetType_targetId: { userId, targetType, targetId },
+                },
+            });
+            if (existing) {
+                return existing;
+            }
+            // For user→user targets, reciprocity is determined by the presence of the
+            // reverse edge (target → source).
+            let reciprocated = false;
+            if (targetType === "user") {
+                const reverse = await tx.relationship.findUnique({
+                    where: {
+                        userId_targetType_targetId: {
+                            userId: targetId,
+                            targetType: "user",
+                            targetId: userId,
+                        },
+                    },
+                });
+                if (reverse) {
+                    reciprocated = true;
+                    // Mark the reverse edge reciprocated too (both edges flip).
+                    await tx.relationship.update({
+                        where: { id: reverse.id },
+                        data: { reciprocated: true },
+                    });
+                }
+            }
+            return tx.relationship.create({
+                data: {
+                    tenantId,
+                    userId,
+                    targetType,
+                    targetId,
+                    computedScore: initialScore,
+                    manualScore: null,
+                    tier: scoreToTier(initialScore),
+                    interactionCount: 0,
+                    lastInteractionAt: null,
+                    connectionMethod,
+                    reciprocated,
+                },
+            });
+        });
+        return rowToRelationship(created);
+    }
+    /**
+     * Remove a relationship. If a reciprocated user→user edge is removed, the
+     * reverse edge's `reciprocated` flag is cleared. Throws GraphNotFoundError
+     * when no edge exists.
+     */
+    async removeRelationship(userId, targetType, targetId) {
+        const tenantId = getCurrentTenantId();
+        await this.prisma.$transaction(async (tx) => {
+            const existing = await tx.relationship.findFirst({
+                where: { userId, targetType, targetId, tenantId },
+            });
+            if (!existing) {
+                throw new GraphNotFoundError(`Relationship from user ${userId} to ${targetType} ${targetId} not found`, "relationship", `${userId}->${targetId}`);
+            }
+            // Clear the reverse reciprocated flag for user→user edges.
+            if (targetType === "user") {
+                await tx.relationship.updateMany({
+                    where: {
+                        userId: targetId,
+                        targetType: "user",
+                        targetId: userId,
+                        tenantId,
+                    },
+                    data: { reciprocated: false },
+                });
+            }
+            await tx.relationship.delete({ where: { id: existing.id } });
+        });
+    }
+    /**
+     * Set or clear the manual score override. When `manualScore` is null the
+     * computed score takes over again. The effective score / tier are derived
+     * in {@link rowToRelationship}.
+     */
+    async updateRelationshipScore(input) {
+        const { userId, targetType, targetId, manualScore } = input;
+        const tenantId = getCurrentTenantId();
+        const existing = await this.prisma.relationship.findFirst({
+            where: { userId, targetType, targetId, tenantId },
+        });
+        if (!existing) {
+            throw new GraphNotFoundError(`Relationship from user ${userId} to ${targetType} ${targetId} not found`, "relationship", `${userId}->${targetId}`);
+        }
+        const newScore = effectiveScore(manualScore ?? null, existing.computedScore);
+        const updated = await this.prisma.relationship.update({
+            where: { id: existing.id },
+            data: {
+                manualScore: manualScore ?? null,
+                tier: scoreToTier(newScore),
+            },
+        });
+        return rowToRelationship(updated);
+    }
+    /** Get a specific relationship, or null if it does not exist. */
+    async getRelationship(userId, targetType, targetId) {
+        const tenantId = getCurrentTenantId();
+        const row = await this.prisma.relationship.findFirst({
+            where: { userId, targetType, targetId, tenantId },
+        });
+        return row ? rowToRelationship(row) : null;
+    }
+    /**
+     * List a user's relationships, ordered by effective score descending, with
+     * optional tier / target-type filters and score-cursor pagination.
+     *
+     * Ordering and the cursor are over the EFFECTIVE score (manual override wins
+     * over computed). There is no stored effective-score column, so the ordering
+     * key is computed as `COALESCE(manual_score, computed_score)` in SQL.
+     */
+    async getRelationships(userId, options) {
+        const limit = options?.pagination?.limit ?? 50;
+        const cursor = options?.pagination?.cursor ?? null;
+        const cursorScore = cursor !== null ? decodeCursor(cursor) : null;
+        const tenantId = getCurrentTenantId();
+        const where = { userId };
+        if (tenantId !== undefined)
+            where.tenantId = tenantId;
+        if (options?.targetType !== undefined)
+            where.targetType = options.targetType;
+        // The persisted `tier` column is kept in sync on writes, so a tier filter
+        // can use it directly (matches the Neo4j `r.tier = $tier` predicate).
+        if (options?.tier !== undefined)
+            where.tier = options.tier;
+        // Fetch a page ordered by effective score. Prisma cannot order/filter by a
+        // COALESCE expression, so order by (manualScore desc nulls last, computed
+        // desc) is not equivalent — instead fetch the user's edges (filtered) and
+        // sort/paginate on the computed effective score in-app. Edge counts per
+        // user are bounded (a user's circle), so this is acceptable and exact.
+        const rows = await this.prisma.relationship.findMany({ where });
+        const mapped = rows
+            .map(rowToRelationship)
+            .sort((a, b) => b.score - a.score);
+        // Score-cursor pagination: take items strictly below the cursor score.
+        const afterCursor = cursorScore !== null
+            ? mapped.filter((r) => r.score < cursorScore)
+            : mapped;
+        const hasMore = afterCursor.length > limit;
+        const items = hasMore ? afterCursor.slice(0, limit) : afterCursor;
+        const lastItem = items[items.length - 1];
+        const nextCursor = hasMore && lastItem ? encodeCursor(lastItem.score) : null;
+        return { items, cursor: nextCursor, hasMore };
+    }
+    /**
+     * Build the relationship-graph visualization payload.
+     *
+     * SECURITY: raw scores are NEVER returned. Each node exposes only `tier` and
+     * a coarse `closeness` value bucketed to the nearest 10 in [0, 100]
+     * (`round(score * 10) * 10`). Recent-auth, rate-limiting, and audit-logging
+     * are enforced by the caller; the score coarsening is applied here.
+     */
+    async getRelationshipGraph(userId) {
+        const tenantId = getCurrentTenantId();
+        const rows = await this.prisma.relationship.findMany({
+            where: tenantId !== undefined ? { userId, tenantId } : { userId },
+        });
+        // Resolve node display names from the user/entity tables by id+type.
+        // targetId is polymorphic with no FK, so look each set up separately.
+        const userIds = rows
+            .filter((r) => r.targetType === "user")
+            .map((r) => r.targetId);
+        const entityIds = rows
+            .filter((r) => r.targetType === "entity")
+            .map((r) => r.targetId);
+        const [users, entities] = await Promise.all([
+            userIds.length > 0
+                ? this.prisma.user.findMany({
+                    where: { id: { in: userIds } },
+                    select: { id: true, handle: true, username: true },
+                })
+                : Promise.resolve([]),
+            entityIds.length > 0
+                ? this.prisma.entity.findMany({
+                    where: { id: { in: entityIds } },
+                    select: { id: true, name: true },
+                })
+                : Promise.resolve([]),
+        ]);
+        // Users carry no PII in the graph; fall back to handle/username (both
+        // optional) and finally empty string — matches the Neo4j `tgt.name ?? ""`.
+        const userNameById = new Map(users.map((u) => [u.id, u.handle ?? u.username ?? ""]));
+        const entityNameById = new Map(entities.map((e) => [e.id, e.name ?? ""]));
+        const nodes = rows
+            .map((row) => {
+            const score = effectiveScore(row.manualScore, row.computedScore);
+            const targetType = row.targetType;
+            const name = targetType === "user"
+                ? (userNameById.get(row.targetId) ?? "")
+                : (entityNameById.get(row.targetId) ?? "");
+            return {
+                score,
+                node: {
+                    id: row.targetId,
+                    type: targetType,
+                    name,
+                    // Coarsen to nearest 10 (0-100); never expose the raw score.
+                    closeness: Math.round(score * 10) * 10,
+                    tier: scoreToTier(score),
+                },
+            };
+        })
+            // Order by score descending (matches Neo4j ORDER BY r.score DESC).
+            .sort((a, b) => b.score - a.score)
+            .map((x) => x.node);
+        // Tier summary counts.
+        const counts = {
+            inner: 0,
+            closeFriends: 0,
+            community: 0,
+            ambient: 0,
+        };
+        for (const node of nodes) {
+            counts[TIER_NAMES[node.tier]]++;
+        }
+        const thresholdFor = (tier) => TIER_THRESHOLDS.find((t) => t.tier === tier)?.minScore ?? 0;
+        return {
+            nodes,
+            tiers: {
+                inner: { threshold: thresholdFor(0), count: counts.inner },
+                closeFriends: {
+                    threshold: thresholdFor(1),
+                    count: counts.closeFriends,
+                },
+                community: { threshold: thresholdFor(2), count: counts.community },
+                ambient: { threshold: thresholdFor(3), count: counts.ambient },
+            },
+        };
+    }
+}
+//# sourceMappingURL=relationships.js.map

package/dist/lib/graph/postgres/relationships.js.map

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