@agora-server/contract 0.10.0 → 0.12.1

package/dist/index.d.ts

@@ -4,4 +4,5 @@ export * from "./pagination.js";
 export * from "./errors.js";
 export * from "./schemas.js";
 export * from "./secure-chat.js";
+export * from "./social.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -6,3 +6,4 @@ export * from "./pagination.js";
 export * from "./errors.js";
 export * from "./schemas.js";
 export * from "./secure-chat.js";
+export * from "./social.js";

package/dist/schemas.d.ts

@@ -471,6 +471,16 @@ export declare const refreshSchema: z.ZodObject<{
 }, {
     refreshToken: string;
 }>;
+export declare const grantRoleSchema: z.ZodObject<{
+    userId: z.ZodString;
+    role: z.ZodEnum<["owner", "admin", "steward"]>;
+}, "strip", z.ZodTypeAny, {
+    role: "admin" | "owner" | "steward";
+    userId: string;
+}, {
+    role: "admin" | "owner" | "steward";
+    userId: string;
+}>;
 export declare const signOutSchema: z.ZodObject<{
     refreshToken: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -505,21 +515,31 @@ export declare const verifyEmailSchema: z.ZodObject<{
     tokenHash: string;
     type?: "email" | "signup" | "recovery" | undefined;
 }>;
+export declare const resetPasswordSchema: z.ZodObject<{
+    token: z.ZodString;
+    newPassword: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    newPassword: string;
+    token: string;
+}, {
+    newPassword: string;
+    token: string;
+}>;
 export declare const externalUserSchema: z.ZodEffects<z.ZodObject<{
     userJwt: z.ZodOptional<z.ZodString>;
     token: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    userJwt?: string | undefined;
     token?: string | undefined;
-}, {
     userJwt?: string | undefined;
+}, {
     token?: string | undefined;
-}>, {
     userJwt?: string | undefined;
+}>, {
     token?: string | undefined;
-}, {
     userJwt?: string | undefined;
+}, {
     token?: string | undefined;
+    userJwt?: string | undefined;
 }>;
 export declare const signTestingJwtSchema: z.ZodObject<{
     privateKey: z.ZodString;
@@ -563,8 +583,6 @@ export declare const webhookConfigSchema: z.ZodObject<{
 }>;
 export declare const DEFAULT_MODERATION_CATEGORIES: readonly ["fake-news", "conspiracy", "racism", "alcohol-promotion", "drug-promotion", "foul-language", "harassment", "hate-promotion", "sexual", "violence-promotion", "self-harm", "spam", "illicit", "pii"];
 export declare const moderatorConfigSchema: z.ZodObject<{
-    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    secret: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     blockAutoActionThreshold: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     reviewAutoActionThreshold: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     llmProvider: z.ZodOptional<z.ZodNullable<z.ZodEnum<["openai", "anthropic"]>>>;
@@ -574,8 +592,6 @@ export declare const moderatorConfigSchema: z.ZodObject<{
     llmMaxTokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     categories: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
 }, "strip", z.ZodTypeAny, {
-    url?: string | null | undefined;
-    secret?: string | null | undefined;
     blockAutoActionThreshold?: number | null | undefined;
     reviewAutoActionThreshold?: number | null | undefined;
     llmProvider?: "openai" | "anthropic" | null | undefined;
@@ -585,8 +601,6 @@ export declare const moderatorConfigSchema: z.ZodObject<{
     llmMaxTokens?: number | null | undefined;
     categories?: string[] | null | undefined;
 }, {
-    url?: string | null | undefined;
-    secret?: string | null | undefined;
     blockAutoActionThreshold?: number | null | undefined;
     reviewAutoActionThreshold?: number | null | undefined;
     llmProvider?: "openai" | "anthropic" | null | undefined;

package/dist/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASyD,CAAC;AAEzF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;EAQ9B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;EAOwD,CAAC;AAIzF,eAAO,MAAM,cAAc;;;;;;EAEzB,CAAC;AAKH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;EAQjB,CAAC;AAIb,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBjB,CAAC;AAMb,eAAO,MAAM,uBAAuB,0DAA2D,CAAC;AAChG,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAI3E,eAAO,MAAM,uBAAuB,+BAAgC,CAAC;AACrE,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAG5E,eAAO,MAAM,0BAA0B,4DAA6D,CAAC;AACrG,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAClF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAIpB,CAAC;AACb,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,mBAAmB,CAAC;IAClC,aAAa,EAAE,oBAAoB,CAAC;IACpC,gBAAgB,EAAE,uBAAuB,CAAC;CAC3C;AAGD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQwD,CAAC;AAMzF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW0D,CAAC;AAEzF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;EAM2D,CAAC;AAEzF,eAAO,MAAM,kBAAkB;;;;;;EAE7B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC;AAGH,eAAO,MAAM,sBAAsB;;;;;;;;;EAGjC,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;EAE1B,CAAC;AAGH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAM7B,CAAC;AAGH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;EAKvB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;EAGvB,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;EAExB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;EAG1B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;EAExB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;EAEtB,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;EAG9B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAMkE,CAAC;AAElG,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;EAK/B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAI9B,CAAC;AAKH,eAAO,MAAM,6BAA6B,+MAehC,CAAC;AASX,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAShC,CAAC;AAKH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;EAMlC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;EAK/B,CAAC;AAGH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;EAOnC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;EAEnC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAKmD,CAAC;AAQzF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKqD,CAAC;AAEpF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;EAE0D,CAAC;AAEzF,eAAO,MAAM,qBAAqB;;;;;;EAEhC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;EAG9B,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;EAGtC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;EAE/B,CAAC;AAGH,eAAO,MAAM,uBAAuB;;;;;;EAElC,CAAC"}

package/dist/schemas.js

@@ -178,7 +178,7 @@ export const createReportSchema = z.object({
 });
 // ─── auth ──────────────────────────────────────────────────────────────────
 export const signUpSchema = z.object({
-    email: z.string().email(),
+    email: z.string().email().max(254),
     password: z.string().min(8).max(128),
     name: z.string().max(120).optional(),
     username: z.string().min(1).max(60).optional(),
@@ -190,6 +190,10 @@ export const signInSchema = z.object({
 export const refreshSchema = z.object({
     refreshToken: z.string().min(1),
 });
+export const grantRoleSchema = z.object({
+    userId: z.string().uuid(),
+    role: z.enum(["owner", "admin", "steward"]),
+});
 export const signOutSchema = z.object({
     refreshToken: z.string().min(1).optional(),
 });
@@ -198,12 +202,16 @@ export const changePasswordSchema = z.object({
     newPassword: z.string().min(8).max(128),
 });
 export const emailSchema = z.object({
-    email: z.string().email(),
+    email: z.string().email().max(254),
 });
 export const verifyEmailSchema = z.object({
     tokenHash: z.string().min(1),
     type: z.enum(["signup", "email", "recovery"]).optional(),
 });
+export const resetPasswordSchema = z.object({
+    token: z.string().min(1),
+    newPassword: z.string().min(8).max(128),
+});
 export const externalUserSchema = z
     .object({
     // The SDK posts `userJwt`; `token` kept as a legacy alias.
@@ -241,17 +249,14 @@ export const DEFAULT_MODERATION_CATEGORIES = [
     "illicit",
     "pii",
 ];
-// The @agora/moderator integration (PATCH /settings/moderator). Groups everything about automated
-// moderation for one project:
-//   - the internal notifier the API fans content `*.complete` events to (url + write-only secret) —
-//     separate from the project's (external) webhook notifier;
-//   - the block/review auto-action thresholds + LLM-provider tuning the moderator overlays on its env defaults;
+// The services/scorer integration (PATCH /settings/moderator). Per-project tuning the scorer overlays
+// on its env defaults:
+//   - the block/review auto-action thresholds + LLM-provider tuning;
 //   - the per-project moderation category list (`categories`).
-// Every field is nullish: omit to leave unchanged, null to clear (→ the moderator's env default /
-// the seed categories). `secret` and `llmApiKey` are write-only (GET exposes only hasSecret / hasLlmApiKey).
+// (Scoring transport is the scorer's pgmq enqueue — there is no per-project notifier URL/secret.)
+// Every field is nullish: omit to leave unchanged, null to clear (→ the scorer's env default /
+// the seed categories). `llmApiKey` is write-only (GET exposes only hasLlmApiKey).
 export const moderatorConfigSchema = z.object({
-    url: z.string().url().nullish(),
-    secret: z.string().min(1).nullish(),
     blockAutoActionThreshold: z.number().min(0).max(1).nullish(),
     reviewAutoActionThreshold: z.number().min(0).max(1).nullish(),
     llmProvider: z.enum(["openai", "anthropic"]).nullish(),
@@ -261,7 +266,7 @@ export const moderatorConfigSchema = z.object({
     llmMaxTokens: z.number().int().positive().nullish(),
     categories: z.array(z.string().trim().min(1).max(64)).max(100).nullish(),
 });
-// ─── automated moderation (@agora/moderator) ────────────────────────────────
+// ─── automated moderation (services/scorer) ────────────────────────────────
 // Body for the moderator's on-demand POST /moderation/analyze (admin "Re-analyze"). The admin
 // already has the content loaded, so it passes the text directly along with what's being judged.
 export const moderationAnalyzeSchema = z.object({

package/dist/social.d.ts

@@ -0,0 +1,267 @@
+import { z } from "zod";
+export declare const SOCIAL_PRIVACY_TIERS: readonly ["community", "corporate"];
+export type SocialPrivacyTier = (typeof SOCIAL_PRIVACY_TIERS)[number];
+export declare const CORPORATE_ONLY_FLAGS: readonly ["influenceScoresEnabled", "siloDetectionEnabled", "engagementScoresEnabled", "frictionAnalyticsEnabled", "readReceiptsAllowed"];
+export type CorporateOnlyFlag = (typeof CORPORATE_ONLY_FLAGS)[number];
+export interface ResolvedSocialConfig {
+    privacyTier: SocialPrivacyTier;
+    graphEnabled: boolean;
+    weatherEnabled: boolean;
+    constellationEnabled: boolean;
+    constellationKFloor: number;
+    neighborhoodEnabled: boolean;
+    /** When true, a member's Neighborhood also includes people they've recently *interacted* with (not
+     *  just follows/connections). Default false — the project-wide default; a member can override it for
+     *  their own view via the endpoint's `?includeInteractions=` query param. */
+    neighborhoodIncludeInteractions: boolean;
+    influenceScoresEnabled: boolean;
+    siloDetectionEnabled: boolean;
+    engagementScoresEnabled: boolean;
+    frictionVisibleToStewards: boolean;
+    frictionAnalyticsEnabled: boolean;
+    readAffinityEnabled: boolean;
+    readReceiptsAllowed: boolean;
+    warmthHalfLifeDays: number;
+    frictionHalfLifeDays: number;
+}
+export declare const SOCIAL_TIER_DEFAULTS: Record<SocialPrivacyTier, ResolvedSocialConfig>;
+export declare const socialConfigSchema: z.ZodObject<{
+    privacyTier: z.ZodOptional<z.ZodNullable<z.ZodEnum<["community", "corporate"]>>>;
+    graphEnabled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    weatherEnabled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    constellationEnabled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    constellationKFloor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    neighborhoodEnabled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    neighborhoodIncludeInteractions: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    influenceScoresEnabled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    siloDetectionEnabled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    engagementScoresEnabled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    frictionVisibleToStewards: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    frictionAnalyticsEnabled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    readAffinityEnabled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    readReceiptsAllowed: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    warmthHalfLifeDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    frictionHalfLifeDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    influenceScoresEnabled?: boolean | null | undefined;
+    siloDetectionEnabled?: boolean | null | undefined;
+    engagementScoresEnabled?: boolean | null | undefined;
+    frictionAnalyticsEnabled?: boolean | null | undefined;
+    readReceiptsAllowed?: boolean | null | undefined;
+    privacyTier?: "community" | "corporate" | null | undefined;
+    graphEnabled?: boolean | null | undefined;
+    weatherEnabled?: boolean | null | undefined;
+    constellationEnabled?: boolean | null | undefined;
+    constellationKFloor?: number | null | undefined;
+    neighborhoodEnabled?: boolean | null | undefined;
+    neighborhoodIncludeInteractions?: boolean | null | undefined;
+    frictionVisibleToStewards?: boolean | null | undefined;
+    readAffinityEnabled?: boolean | null | undefined;
+    warmthHalfLifeDays?: number | null | undefined;
+    frictionHalfLifeDays?: number | null | undefined;
+}, {
+    influenceScoresEnabled?: boolean | null | undefined;
+    siloDetectionEnabled?: boolean | null | undefined;
+    engagementScoresEnabled?: boolean | null | undefined;
+    frictionAnalyticsEnabled?: boolean | null | undefined;
+    readReceiptsAllowed?: boolean | null | undefined;
+    privacyTier?: "community" | "corporate" | null | undefined;
+    graphEnabled?: boolean | null | undefined;
+    weatherEnabled?: boolean | null | undefined;
+    constellationEnabled?: boolean | null | undefined;
+    constellationKFloor?: number | null | undefined;
+    neighborhoodEnabled?: boolean | null | undefined;
+    neighborhoodIncludeInteractions?: boolean | null | undefined;
+    frictionVisibleToStewards?: boolean | null | undefined;
+    readAffinityEnabled?: boolean | null | undefined;
+    warmthHalfLifeDays?: number | null | undefined;
+    frictionHalfLifeDays?: number | null | undefined;
+}>;
+export type SocialConfigPatch = z.infer<typeof socialConfigSchema>;
+/** The tier that results from applying `patch` over the currently-stored tier.
+ *  `privacyTier: null` in a patch clears the override → community default. */
+export declare function resultingSocialTier(patch: {
+    privacyTier?: SocialPrivacyTier | null | undefined;
+}, currentTier: SocialPrivacyTier): SocialPrivacyTier;
+/** Reject-on-write: keys in `patch` that the RESULTING tier (after applying the patch's own
+ *  privacyTier, if any) forbids. Empty array = OK. Pass the currently-STORED tier — the
+ *  current-vs-resulting derivation happens here so call sites can't get it wrong. */
+export declare function forbiddenSocialKeys(patch: Partial<Record<string, unknown>> & {
+    privacyTier?: SocialPrivacyTier | null;
+}, currentTier: SocialPrivacyTier): string[];
+/** Clamp-on-read: overlay stored jsonb onto tier defaults, neutralizing anything the tier forbids. */
+export declare function resolveSocialConfig(raw: unknown): ResolvedSocialConfig;
+export declare const WEATHER_BANDS: readonly ["quiet", "stormy", "overcast", "fine", "sunny"];
+export type WeatherBand = (typeof WEATHER_BANDS)[number];
+export interface SocialWeather {
+    /** Mean S_p over the project; null when the graph has no interactions yet. 0..1 rounded to 2dp
+     *  is a runtime convention of the server's weather computation, not enforced by this type. */
+    value: number | null;
+    /** Bucketed label, never null. "quiet" is ONLY the no-data sentinel (value === null); a low
+     *  score with data is "stormy". Band moves with hysteresis — see apps/api lib/social-weather. */
+    band: WeatherBand;
+    /** value(now) − value(as of 7 days ago), 3dp; null when either window has no data. */
+    trend: number | null;
+    /** ISO timestamp of computation (results are cached ~1h server-side). */
+    asOf: string;
+}
+export declare const NEIGHBORHOOD_TIE_KINDS: readonly ["follow", "connection", "interaction"];
+export type NeighborhoodTieKind = (typeof NEIGHBORHOOD_TIE_KINDS)[number];
+export interface NeighborhoodTie {
+    /** The friend's profile id (= the graph User id). */
+    userId: string;
+    username: string | null;
+    name: string | null;
+    avatar: string | null;
+    /** Dyadic brightness B(me, them) in [0.15, 1], rounded to 2dp. This is the caller's *tie* warmth —
+     *  NOT the friend's global S_p, which is never exposed to a member. */
+    brightness: number;
+    /** Which relationship(s) make this person a tie: a follow, a (mutual) connection, and/or recent
+     *  interaction. A pair whose only edge is friction never appears (friction isn't structure). */
+    tieKinds: NeighborhoodTieKind[];
+}
+export interface SocialNeighborhood {
+    /** The caller's ties, brightest-first. */
+    ties: NeighborhoodTie[];
+    /** The effective tie-set rule for this response: when true, interaction-only ties are included
+     *  (not just follows/connections). Echoes the resolved query-param-or-project-default so a client
+     *  can reflect the actual state of its toggle. */
+    includesInteractions: boolean;
+    /** ISO timestamp of computation. */
+    asOf: string;
+}
+export declare const BLOB_SIZE_BUCKETS: readonly ["5–9", "10–19", "20–49", "50–99", "100+"];
+export type BlobSizeBucket = (typeof BLOB_SIZE_BUCKETS)[number];
+export interface ConstellationBlob {
+    /** Bucketed member count — coarse on purpose (one of the §12 protections). Never an exact size. */
+    size: BlobSizeBucket;
+    /** Warmth tint, banded (reuses the Weather band scale). Warmth-only — friction never renders here. */
+    warmth: WeatherBand;
+}
+export interface SocialConstellation {
+    /** The community's blobs, shuffled — there is NO stable identity or ordering across epochs. Blobs
+     *  carry no ids, names, or member lists; a cluster smaller than the k-anonymity floor is omitted. */
+    blobs: ConstellationBlob[];
+    /** ISO timestamp of the materialized snapshot, or null when none has been computed yet ("forming"). */
+    asOf: string | null;
+    /** Which clustering produced this snapshot (transparency): GDS Louvain, the by-space fallback, or
+     *  null when not yet materialized. */
+    method: "louvain" | "space" | null;
+}
+export declare const SOCIAL_ANALYTICS_REPORTS: readonly ["influence", "silos", "engagement"];
+export type SocialAnalyticsReport = (typeof SOCIAL_ANALYTICS_REPORTS)[number];
+export interface InfluenceMember {
+    /** Profile id (= the graph User id). */
+    userId: string;
+    username: string | null;
+    name: string | null;
+    avatar: string | null;
+    /** GDS PageRank centrality — overall influence across the interaction/structural graph. */
+    pageRank: number;
+    /** GDS betweenness centrality — how often this person sits on shortest paths (a bridge/broker). */
+    betweenness: number;
+}
+export interface SocialInfluence {
+    /** Informal leaders, highest PageRank first. */
+    leaders: InfluenceMember[];
+    /** Bridge people, highest betweenness first. */
+    bridges: InfluenceMember[];
+    /** ISO timestamp of the materialized snapshot, or null when none has been computed yet. */
+    asOf: string | null;
+}
+export interface SiloMember {
+    userId: string;
+    username: string | null;
+    name: string | null;
+    avatar: string | null;
+}
+export interface SiloSpace {
+    spaceId: string;
+    name: string | null;
+    /** How many of this silo's members belong to the space — the mapping that labels the cluster. */
+    memberCount: number;
+}
+export interface Silo {
+    /** Stable only WITHIN a snapshot (the GDS community id); no identity across epochs. */
+    id: string;
+    /** Exact member count — operator view, no bucketing and no suppression. */
+    size: number;
+    members: SiloMember[];
+    /** The spaces this silo concentrates in, most-represented first — the human label for the cluster. */
+    spaces: SiloSpace[];
+}
+export interface SocialSilos {
+    silos: Silo[];
+    asOf: string | null;
+}
+export declare const CHURN_RISK_BANDS: readonly ["none", "watch", "at-risk"];
+export type ChurnRiskBand = (typeof CHURN_RISK_BANDS)[number];
+export interface EngagementMember {
+    userId: string;
+    username: string | null;
+    name: string | null;
+    avatar: string | null;
+    /** Current mean inbound brightness S_p (warmth this person receives) — the latest snapshot's value. */
+    sP: number;
+    /** Trailing per-snapshot S_p series, oldest→newest (one point per weekly epoch in the window). */
+    trend: number[];
+    /** sP(current) − sP(window start); negative = cooling. */
+    delta: number;
+    /** Banded churn risk derived from the trend's relative decline over the window. */
+    churnRisk: ChurnRiskBand;
+}
+export interface SocialEngagement {
+    members: EngagementMember[];
+    asOf: string | null;
+}
+export declare const SOCIAL_ANALYTICS_RECOMPUTE_TARGETS: readonly ["influence", "silos", "engagement", "all"];
+export declare const socialAnalyticsRecomputeSchema: z.ZodObject<{
+    report: z.ZodOptional<z.ZodNullable<z.ZodEnum<["influence", "silos", "engagement", "all"]>>>;
+}, "strip", z.ZodTypeAny, {
+    report?: "influence" | "silos" | "engagement" | "all" | null | undefined;
+}, {
+    report?: "influence" | "silos" | "engagement" | "all" | null | undefined;
+}>;
+export type SocialAnalyticsRecompute = z.infer<typeof socialAnalyticsRecomputeSchema>;
+export interface ReadReceiptRecorded {
+    recorded: boolean;
+    /** ISO timestamp the read was recorded/refreshed. */
+    readAt: string;
+}
+export interface ReceiptAnnouncement {
+    /** The announcement entity (post) id. */
+    entityId: string;
+    /** The entity's title, hydrated fresh at read; null when the post has no title. */
+    title: string | null;
+    /** ISO creation timestamp of the post. */
+    createdAt: string;
+    /** Distinct active space members who have read this post. */
+    readerCount: number;
+    /** readerCount / memberCount in [0,1], 2dp — the share of the space that has seen this post. */
+    coverage: number;
+}
+export interface ReceiptSpace {
+    spaceId: string;
+    name: string | null;
+    /** Active members of the space — the coverage denominator. */
+    memberCount: number;
+    /** Recent posts in the space, newest first. */
+    announcements: ReceiptAnnouncement[];
+}
+export interface SocialReadReceipts {
+    spaces: ReceiptSpace[];
+    /** ISO timestamp of the (live) computation. */
+    asOf: string;
+}
+/** Coverage = distinct member readers / active members, clamped to [0,1] and rounded to 2dp.
+ *  Zero members → 0 (no denominator). Pure so it's unit-testable and identical on both sides. */
+export declare function readReceiptCoverage(readerCount: number, memberCount: number): number;
+export declare const readReceiptsToggleSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+}, {
+    enabled: boolean;
+}>;
+export type ReadReceiptsToggle = z.infer<typeof readReceiptsToggleSchema>;
+//# sourceMappingURL=social.d.ts.map

package/dist/social.d.ts.map

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

package/dist/social.js

@@ -0,0 +1,166 @@
+import { z } from "zod";
+// ── Social graph config (projects.social_config jsonb) ──────────────────────────────────────────
+// The community↔corporate privacy switch — see docs/SOCIAL-GRAPH.md §5 and docs/AGORA-CORP.md §4.
+// The tier selects DEFAULTS; stored keys override within what the tier allows. Two enforcement
+// points, both server-side: forbiddenSocialKeys() rejects disallowed writes (400), and
+// resolveSocialConfig() clamps at read time (defense-in-depth for stale flags left behind by a
+// corporate→community switch). Fail closed: garbage resolves to community defaults.
+export const SOCIAL_PRIVACY_TIERS = ["community", "corporate"];
+// Flags that may only be true under the corporate tier. INVARIANT (docs/AGORA-CORP.md §4): the
+// k-anonymity floor is NOT in this list — no tier relaxes it below 5.
+export const CORPORATE_ONLY_FLAGS = [
+    "influenceScoresEnabled",
+    "siloDetectionEnabled",
+    "engagementScoresEnabled",
+    "frictionAnalyticsEnabled",
+    "readReceiptsAllowed",
+];
+const COMMUNITY_DEFAULTS = {
+    privacyTier: "community",
+    graphEnabled: true,
+    weatherEnabled: true,
+    constellationEnabled: true,
+    constellationKFloor: 5,
+    neighborhoodEnabled: true,
+    neighborhoodIncludeInteractions: false,
+    influenceScoresEnabled: false,
+    siloDetectionEnabled: false,
+    engagementScoresEnabled: false,
+    frictionVisibleToStewards: true,
+    frictionAnalyticsEnabled: false,
+    readAffinityEnabled: true,
+    readReceiptsAllowed: false,
+    warmthHalfLifeDays: 30,
+    frictionHalfLifeDays: 14,
+};
+export const SOCIAL_TIER_DEFAULTS = {
+    community: COMMUNITY_DEFAULTS,
+    corporate: {
+        ...COMMUNITY_DEFAULTS,
+        privacyTier: "corporate",
+        influenceScoresEnabled: true,
+        siloDetectionEnabled: true,
+        engagementScoresEnabled: true,
+        frictionAnalyticsEnabled: true,
+        readReceiptsAllowed: true,
+    },
+};
+// PATCH body (admin Settings → Social Graph). Every field nullish: omit = leave unchanged,
+// null = clear the override (→ tier default). Mirrors moderatorConfigSchema.
+export const socialConfigSchema = z.object({
+    privacyTier: z.enum(SOCIAL_PRIVACY_TIERS).nullish(),
+    graphEnabled: z.boolean().nullish(),
+    weatherEnabled: z.boolean().nullish(),
+    constellationEnabled: z.boolean().nullish(),
+    // LOCKSTEP: schema write bounds (5–1000) must stay aligned with resolver read bounds (intIn 1–1000 + Math.max(5)); change both together.
+    constellationKFloor: z.number().int().min(5).max(1000).nullish(),
+    neighborhoodEnabled: z.boolean().nullish(),
+    neighborhoodIncludeInteractions: z.boolean().nullish(),
+    influenceScoresEnabled: z.boolean().nullish(),
+    siloDetectionEnabled: z.boolean().nullish(),
+    engagementScoresEnabled: z.boolean().nullish(),
+    frictionVisibleToStewards: z.boolean().nullish(),
+    frictionAnalyticsEnabled: z.boolean().nullish(),
+    readAffinityEnabled: z.boolean().nullish(),
+    readReceiptsAllowed: z.boolean().nullish(),
+    warmthHalfLifeDays: z.number().int().min(1).max(365).nullish(),
+    frictionHalfLifeDays: z.number().int().min(1).max(365).nullish(),
+});
+/** The tier that results from applying `patch` over the currently-stored tier.
+ *  `privacyTier: null` in a patch clears the override → community default. */
+export function resultingSocialTier(patch, currentTier) {
+    if (patch.privacyTier === null)
+        return "community";
+    return patch.privacyTier ?? currentTier;
+}
+/** Reject-on-write: keys in `patch` that the RESULTING tier (after applying the patch's own
+ *  privacyTier, if any) forbids. Empty array = OK. Pass the currently-STORED tier — the
+ *  current-vs-resulting derivation happens here so call sites can't get it wrong. */
+export function forbiddenSocialKeys(patch, currentTier) {
+    const tier = resultingSocialTier(patch, currentTier);
+    if (tier === "corporate")
+        return [];
+    return CORPORATE_ONLY_FLAGS.filter((k) => patch[k] === true);
+}
+const bool = (v, d) => (typeof v === "boolean" ? v : d);
+const intIn = (v, d, min, max) => typeof v === "number" && Number.isInteger(v) && v >= min && v <= max ? v : d;
+/** Clamp-on-read: overlay stored jsonb onto tier defaults, neutralizing anything the tier forbids. */
+export function resolveSocialConfig(raw) {
+    const r = (raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {});
+    const tier = SOCIAL_PRIVACY_TIERS.includes(r.privacyTier)
+        ? r.privacyTier
+        : "community";
+    const d = SOCIAL_TIER_DEFAULTS[tier];
+    const cfg = {
+        privacyTier: tier,
+        graphEnabled: bool(r.graphEnabled, d.graphEnabled),
+        weatherEnabled: bool(r.weatherEnabled, d.weatherEnabled),
+        constellationEnabled: bool(r.constellationEnabled, d.constellationEnabled),
+        // LOCKSTEP: resolver read bounds (1–1000 + Math.max(5)) must stay aligned with schema write bounds (min 5, max 1000); change both together.
+        // The k-floor clamps UP only — a stored value below 5 is raised, never honored.
+        constellationKFloor: Math.max(5, intIn(r.constellationKFloor, d.constellationKFloor, 1, 1000)),
+        neighborhoodEnabled: bool(r.neighborhoodEnabled, d.neighborhoodEnabled),
+        neighborhoodIncludeInteractions: bool(r.neighborhoodIncludeInteractions, d.neighborhoodIncludeInteractions),
+        influenceScoresEnabled: bool(r.influenceScoresEnabled, d.influenceScoresEnabled),
+        siloDetectionEnabled: bool(r.siloDetectionEnabled, d.siloDetectionEnabled),
+        engagementScoresEnabled: bool(r.engagementScoresEnabled, d.engagementScoresEnabled),
+        frictionVisibleToStewards: bool(r.frictionVisibleToStewards, d.frictionVisibleToStewards),
+        frictionAnalyticsEnabled: bool(r.frictionAnalyticsEnabled, d.frictionAnalyticsEnabled),
+        readAffinityEnabled: bool(r.readAffinityEnabled, d.readAffinityEnabled),
+        readReceiptsAllowed: bool(r.readReceiptsAllowed, d.readReceiptsAllowed),
+        warmthHalfLifeDays: intIn(r.warmthHalfLifeDays, d.warmthHalfLifeDays, 1, 365),
+        frictionHalfLifeDays: intIn(r.frictionHalfLifeDays, d.frictionHalfLifeDays, 1, 365),
+    };
+    if (tier === "community") {
+        for (const k of CORPORATE_ONLY_FLAGS)
+            cfg[k] = false;
+    }
+    return cfg;
+}
+// ── Community Weather (GET /v7/:projectId/social/weather) ───────────────────────────────────────
+// One aggregate scalar — the only place friction shows publicly, as a dip in collective climate
+// (docs/AGORA-SOCIAL.md §5). Safe to publish per the magnitude-regime theorem: friction big enough
+// to move this number involves too many people to single anyone out.
+export const WEATHER_BANDS = ["quiet", "stormy", "overcast", "fine", "sunny"];
+// ── Neighborhood (GET /v7/:projectId/social/neighborhood) ───────────────────────────────────────
+// The most personal Garden lens (docs/AGORA-SOCIAL.md): zoom to YOURSELF — your own named ties, each
+// rendered with its DYADIC brightness B(me, them). Self-view only. The brightness is *your tie's*
+// warmth, NEVER the friend's global score — the asymmetry rule that closes the friction side-channel
+// (cheat-sheet #6). Friction only DIMS an existing tie (FLOOR-bounded, so dim = friction-or-loneliness,
+// unreadable); it never creates one.
+export const NEIGHBORHOOD_TIE_KINDS = ["follow", "connection", "interaction"];
+// ── Constellation (GET /v7/:projectId/social/constellation) ─────────────────────────────────────
+// The anonymous *shape* of the community (docs/AGORA-SOCIAL.md, §12): cluster blobs — size + warmth
+// tint only, NEVER individual nodes. k-anonymity (clusters below the floor are suppressed), no
+// persistent blob identity (re-clustered fresh each epoch, shuffled), warmth-only (friction never
+// renders as structure). Materialized on a slow seasonal cadence (never per-load — §12), so the read
+// just returns the latest snapshot.
+export const BLOB_SIZE_BUCKETS = ["5–9", "10–19", "20–49", "50–99", "100+"];
+// ── Admin Analytics (corporate tier · operator-only · NAMED) ────────────────────────────────────
+// The corporate counterpart to the Garden (docs/AGORA-CORP.md; docs/SOCIAL-GRAPH.md §7 Phase 4).
+// Unlike the member-facing lenses these NAME real people — the operator is the accountable employer,
+// so the temporal-anonymity protections do NOT apply. Each report is corporate-tier-only, gated by its
+// CORPORATE_ONLY_FLAG (`influenceScoresEnabled` / `siloDetectionEnabled` / `engagementScoresEnabled`),
+// which the community tier forces off. Materialized on a slow (weekly) cadence plus an operator-forced
+// recompute; the reads return the latest snapshot, names hydrated fresh so they never go stale.
+export const SOCIAL_ANALYTICS_REPORTS = ["influence", "silos", "engagement"];
+// Engagement — per-person warmth-RECEIVED (S_p) with a churn-risk trend. GET /admin/social/engagement.
+export const CHURN_RISK_BANDS = ["none", "watch", "at-risk"];
+// POST /admin/social/recompute — operator-forced, synchronous re-materialization. The body selects a
+// single report or "all" (default); the request blocks while GDS runs over the whole graph.
+export const SOCIAL_ANALYTICS_RECOMPUTE_TARGETS = [...SOCIAL_ANALYTICS_REPORTS, "all"];
+export const socialAnalyticsRecomputeSchema = z.object({
+    report: z.enum(SOCIAL_ANALYTICS_RECOMPUTE_TARGETS).nullish(),
+});
+/** Coverage = distinct member readers / active members, clamped to [0,1] and rounded to 2dp.
+ *  Zero members → 0 (no denominator). Pure so it's unit-testable and identical on both sides. */
+export function readReceiptCoverage(readerCount, memberCount) {
+    if (memberCount <= 0)
+        return 0;
+    const c = Math.min(1, Math.max(0, readerCount / memberCount));
+    return Math.round(c * 100) / 100;
+}
+// PATCH /admin/social/read-receipts/spaces/:spaceId — operator flips a single space's opt-in.
+export const readReceiptsToggleSchema = z.object({
+    enabled: z.boolean(),
+});

package/dist/types.d.ts

@@ -94,6 +94,8 @@ export interface AuthUser extends User {
     }[];
     authMethods: string[];
     isOperator: boolean;
+    isProjectOwner: boolean;
+    isProjectAdmin: boolean;
     isSteward: boolean;
 }
 export type ReportTargetType = "entity" | "comment" | "message";
@@ -122,6 +124,8 @@ export interface AuthContext {
     userId: string;
     role: "admin" | "moderator" | "visitor";
     isOperator: boolean;
+    isProjectOwner: boolean;
+    isProjectAdmin: boolean;
     isSteward: boolean;
 }
 export type ModerationVerdict = "allow" | "block" | "review";

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agora-server/contract",
-  "version": "0.10.0",
+  "version": "0.12.1",
   "type": "module",
   "description": "Shared Agora API contract — response-model types + zod request schemas (no hono/drizzle).",
   "license": "Apache-2.0",