@agora-sdk/social-core 0.6.0

package/dist/esm/hooks/useSocialWeather.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSocialWeather.js","sourceRoot":"","sources":["../../../src/hooks/useSocialWeather.tsx"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,EAAE;AACF,sGAAsG;AACtG,qGAAqG;AACrG,qGAAqG;AACrG,iGAAiG;AACjG,yCAAyC;AAEzC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAczD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,SAAS,EAAE,CAAC;IACpD,MAAM,OAAO,GAAG,MAAM,EAAE,cAAc,IAAI,KAAK,CAAC;IAEhD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAuB,IAAI,CAAC,CAAC;IACnE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAU,IAAI,CAAC,CAAC;IAElD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACrC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,UAAU,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,6FAA6F;YAC7F,iGAAiG;YACjG,sCAAsC;YACtC,IAAI,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,UAAU,CAAC,IAAI,CAAC,CAAC;gBACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAEpB,qGAAqG;IACrG,0GAA0G;IAC1G,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,aAAa;YAAE,OAAO;QAC1B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,OAAO;QACT,CAAC;QACD,KAAK,OAAO,EAAE,CAAC;IACjB,CAAC,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAEtC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC9C,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,14 @@
+export { SocialProvider, useSocial, ALL_DISABLED_SOCIAL_CONFIG } from "./context/social-context.js";
+export type { SocialProviderProps, SocialContextValue } from "./context/social-context.js";
+export { useSocialWeather } from "./hooks/useSocialWeather.js";
+export type { UseSocialWeatherValues } from "./hooks/useSocialWeather.js";
+export { useSocialConstellation } from "./hooks/useSocialConstellation.js";
+export type { UseSocialConstellationValues } from "./hooks/useSocialConstellation.js";
+export { useSocialNeighborhood } from "./hooks/useSocialNeighborhood.js";
+export type { UseSocialNeighborhoodValues } from "./hooks/useSocialNeighborhood.js";
+export { useSocialTransparency } from "./hooks/useSocialTransparency.js";
+export type { UseSocialTransparencyValues } from "./hooks/useSocialTransparency.js";
+export { SocialRestClient, SocialApiError, isSocialDegradation } from "./transport/rest.js";
+export type { SocialRestConfig } from "./transport/rest.js";
+export { WEATHER_BANDS, BLOB_SIZE_BUCKETS, NEIGHBORHOOD_TIE_KINDS, } from "./contract/index.js";
+export type { SocialWeather, WeatherBand, SocialConstellation, ConstellationBlob, BlobSizeBucket, SocialNeighborhood, NeighborhoodTie, NeighborhoodTieKind, ResolvedSocialConfig, } from "./contract/index.js";

package/dist/esm/index.js

@@ -0,0 +1,17 @@
+// @agora-sdk/social-core — platform-agnostic client for the Agora social graph.
+//
+// Typed REST transport + provider/hooks for the three member-facing lenses (Weather, Constellation,
+// Neighborhood) plus the Transparency endpoint. Pure data — no crypto, no persistence, no realtime.
+// Platform packages (@agora-sdk/social-react-js, etc.) re-export this and add the visual components.
+// ── context / provider ──────────────────────────────────────────────────────
+export { SocialProvider, useSocial, ALL_DISABLED_SOCIAL_CONFIG } from "./context/social-context.js";
+// ── hooks ────────────────────────────────────────────────────────────────────
+export { useSocialWeather } from "./hooks/useSocialWeather.js";
+export { useSocialConstellation } from "./hooks/useSocialConstellation.js";
+export { useSocialNeighborhood } from "./hooks/useSocialNeighborhood.js";
+export { useSocialTransparency } from "./hooks/useSocialTransparency.js";
+// ── transport (for advanced / non-React use) ─────────────────────────────────
+export { SocialRestClient, SocialApiError, isSocialDegradation } from "./transport/rest.js";
+// ── wire contract types + runtime const arrays (transitional — see ./contract) ──
+export { WEATHER_BANDS, BLOB_SIZE_BUCKETS, NEIGHBORHOOD_TIE_KINDS, } from "./contract/index.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,oGAAoG;AACpG,oGAAoG;AACpG,qGAAqG;AAErG,+EAA+E;AAC/E,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAGpG,gFAAgF;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,gFAAgF;AAChF,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG5F,mFAAmF;AACnF,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC"}

package/dist/esm/transport/rest.d.ts

@@ -0,0 +1,105 @@
+import { ResolvedSocialConfig, SocialConstellation, SocialNeighborhood, SocialWeather } from "../contract/index.js";
+/**
+ * Configuration for {@link SocialRestClient}. The base URL and access token are read through resolver
+ * callbacks rather than captured once, so a late-set `baseUrl` or a refreshed token take effect on the
+ * next request without rebuilding the client.
+ */
+export interface SocialRestConfig {
+    /** Resolve the API base URL (e.g. `getApiBaseUrl()` from @agora-sdk/core → `http://host/v7`). */
+    getBaseUrl: () => string;
+    /** Resolve the current access token, or undefined when signed out. */
+    getAccessToken: () => string | undefined;
+    /** The Agora project id (path-scoped on every endpoint — a privacy boundary). */
+    projectId: string;
+}
+/**
+ * A failed social API call. Carries the HTTP `status` and, when the server supplied one, the machine
+ * `code` (e.g. `social/graph-unavailable`, `social/weather-disabled`) so callers can distinguish
+ * "hide this surface" degradation (SOCIAL.md §7) from an unexpected failure.
+ */
+export declare class SocialApiError extends Error {
+    /** HTTP status code, or `0` when the request never got a response (network error). */
+    readonly status: number;
+    /** The server's machine error code (e.g. `social/graph-unavailable`), or `null` if none was sent. */
+    readonly code: string | null;
+    /**
+     * @param message - Human-readable summary (never contains member PII).
+     * @param status - HTTP status code (`0` for a network-level failure).
+     * @param code - The server's machine error code, or `null`.
+     */
+    constructor(message: string, status: number, code: string | null);
+}
+/**
+ * Whether an error is a "hide this surface" degradation (graph unavailable or a feature-disabled lens)
+ * rather than a real failure. Hooks use this to fail soft — clearing data instead of surfacing the
+ * error to members (`docs/SOCIAL.md` §7).
+ *
+ * @param err - Any caught error.
+ * @returns `true` for a {@link SocialApiError} whose `code` is a known degradation code; else `false`.
+ */
+export declare function isSocialDegradation(err: unknown): boolean;
+/**
+ * Typed REST client for the Agora social graph.
+ *
+ * Wraps the four social endpoints in `docs/SOCIAL.md`. Each request lazily resolves the base URL and
+ * bearer token, scopes the path to `{baseUrl}/{projectId}/social`, and normalizes any failure into a
+ * {@link SocialApiError}.
+ *
+ * @remarks
+ * Construct this directly only for advanced / non-React use. Inside React, prefer the `SocialProvider`
+ * + hooks, which build and share one client for you.
+ *
+ * @example
+ * ```typescript
+ * const rest = new SocialRestClient({
+ *   projectId,
+ *   getBaseUrl: () => getApiBaseUrl(),
+ *   getAccessToken: () => session.accessToken,
+ * });
+ * const weather = await rest.getWeather();
+ * ```
+ */
+export declare class SocialRestClient {
+    private readonly config;
+    private readonly http;
+    /** @param config - Lazy resolvers for base URL + token, plus the path-scoped project id. */
+    constructor(config: SocialRestConfig);
+    /**
+     * Fetch the Community Weather scalar (aggregate warmth + band + 7-day trend).
+     *
+     * @returns The current {@link SocialWeather} reading (`value: null` / `band: "quiet"` when no data yet).
+     * @throws {SocialApiError} `400 social/weather-disabled` (feature off) or `503 social/graph-unavailable`.
+     */
+    getWeather(): Promise<SocialWeather>;
+    /**
+     * Fetch the Constellation snapshot (anonymous cluster blobs).
+     *
+     * @returns The current {@link SocialConstellation} (`asOf: null` when no snapshot exists yet).
+     * @throws {SocialApiError} `400 social/constellation-disabled` or `503 social/graph-unavailable`.
+     */
+    getConstellation(): Promise<SocialConstellation>;
+    /**
+     * Fetch the caller's Neighborhood (their own named ties with dyadic brightness). Self-view only.
+     *
+     * @param opts - Optional `includeInteractions` toggle; omit to use the project default. The response
+     *   always echoes the **effective** value via `includesInteractions`.
+     * @returns The caller's {@link SocialNeighborhood}, ties sorted brightest-first.
+     * @throws {SocialApiError} `400 social/neighborhood-disabled` or `503 social/graph-unavailable`.
+     */
+    getNeighborhood(opts?: {
+        includeInteractions?: boolean;
+    }): Promise<SocialNeighborhood>;
+    /**
+     * Fetch the project's resolved social config (which lenses are enabled, decay half-lives, k-floor).
+     * Call this at app init to know which surfaces to render.
+     *
+     * @returns The project's {@link ResolvedSocialConfig}.
+     * @throws {SocialApiError} `503 social/graph-unavailable` when the graph is not configured.
+     */
+    getTransparency(): Promise<ResolvedSocialConfig>;
+    /**
+     * Shared GET helper: issues the request and normalizes any axios failure into a {@link SocialApiError}
+     * carrying the HTTP status + server error code.
+     */
+    private get;
+}

package/dist/esm/transport/rest.js

@@ -0,0 +1,168 @@
+// Typed REST client for the Agora social graph (Weather / Constellation / Neighborhood / Transparency).
+//
+// Covers every endpoint in `docs/SOCIAL.md` §1–4. Base URL and access token are resolved **lazily per
+// request** (matching the @agora-sdk/core base-URL runtime), so a token refresh or a late-set baseUrl
+// always wins. Every endpoint is path-scoped to `{baseUrl}/{projectId}/social` — the `:projectId`
+// boundary is a privacy boundary (no cross-project social data; see SOCIAL.md §6).
+//
+// All four lenses are feature-gated server-side and degrade with specific error codes (SOCIAL.md §7).
+// On any non-2xx, this client throws a typed {@link SocialApiError} carrying the HTTP `status` plus the
+// server's machine `code` (e.g. `social/graph-unavailable`), so hooks/providers can hide a surface
+// rather than surface a raw error to members.
+import axios from "axios";
+/**
+ * A failed social API call. Carries the HTTP `status` and, when the server supplied one, the machine
+ * `code` (e.g. `social/graph-unavailable`, `social/weather-disabled`) so callers can distinguish
+ * "hide this surface" degradation (SOCIAL.md §7) from an unexpected failure.
+ */
+export class SocialApiError extends Error {
+    /**
+     * @param message - Human-readable summary (never contains member PII).
+     * @param status - HTTP status code (`0` for a network-level failure).
+     * @param code - The server's machine error code, or `null`.
+     */
+    constructor(message, status, code) {
+        super(message);
+        this.name = "SocialApiError";
+        this.status = status;
+        this.code = code;
+    }
+}
+/**
+ * Server error codes that mean "this surface is unavailable / turned off" rather than "something went
+ * wrong" — the graph being unconfigured (`503`) or a lens being feature-disabled (`400`). Per
+ * `docs/SOCIAL.md` §7 these should make the client **hide the surface**, never show a member an error.
+ */
+const SOCIAL_DEGRADATION_CODES = new Set([
+    "social/graph-unavailable",
+    "social/weather-disabled",
+    "social/constellation-disabled",
+    "social/neighborhood-disabled",
+]);
+/**
+ * Whether an error is a "hide this surface" degradation (graph unavailable or a feature-disabled lens)
+ * rather than a real failure. Hooks use this to fail soft — clearing data instead of surfacing the
+ * error to members (`docs/SOCIAL.md` §7).
+ *
+ * @param err - Any caught error.
+ * @returns `true` for a {@link SocialApiError} whose `code` is a known degradation code; else `false`.
+ */
+export function isSocialDegradation(err) {
+    return (err instanceof SocialApiError && err.code !== null && SOCIAL_DEGRADATION_CODES.has(err.code));
+}
+/**
+ * Pull the server's machine error code out of an arbitrary error body. agora-server error shapes vary
+ * (`{ error: { code } }`, `{ code }`, or `{ error: "social/…" }`), so probe each defensively and fall
+ * back to `null`. Never throws.
+ */
+function extractCode(data) {
+    if (!data || typeof data !== "object")
+        return null;
+    const body = data;
+    const nested = body.error;
+    if (nested && typeof nested === "object" && typeof nested.code === "string") {
+        return nested.code;
+    }
+    if (typeof body.code === "string")
+        return body.code;
+    if (typeof nested === "string")
+        return nested;
+    return null;
+}
+/**
+ * Typed REST client for the Agora social graph.
+ *
+ * Wraps the four social endpoints in `docs/SOCIAL.md`. Each request lazily resolves the base URL and
+ * bearer token, scopes the path to `{baseUrl}/{projectId}/social`, and normalizes any failure into a
+ * {@link SocialApiError}.
+ *
+ * @remarks
+ * Construct this directly only for advanced / non-React use. Inside React, prefer the `SocialProvider`
+ * + hooks, which build and share one client for you.
+ *
+ * @example
+ * ```typescript
+ * const rest = new SocialRestClient({
+ *   projectId,
+ *   getBaseUrl: () => getApiBaseUrl(),
+ *   getAccessToken: () => session.accessToken,
+ * });
+ * const weather = await rest.getWeather();
+ * ```
+ */
+export class SocialRestClient {
+    /** @param config - Lazy resolvers for base URL + token, plus the path-scoped project id. */
+    constructor(config) {
+        this.config = config;
+        this.http = axios.create();
+        this.http.interceptors.request.use((req) => {
+            const base = config.getBaseUrl().replace(/\/$/, "");
+            req.baseURL = `${base}/${config.projectId}/social`;
+            const token = config.getAccessToken();
+            if (token)
+                req.headers.set("Authorization", `Bearer ${token}`);
+            return req;
+        });
+    }
+    /**
+     * Fetch the Community Weather scalar (aggregate warmth + band + 7-day trend).
+     *
+     * @returns The current {@link SocialWeather} reading (`value: null` / `band: "quiet"` when no data yet).
+     * @throws {SocialApiError} `400 social/weather-disabled` (feature off) or `503 social/graph-unavailable`.
+     */
+    async getWeather() {
+        return this.get("/weather");
+    }
+    /**
+     * Fetch the Constellation snapshot (anonymous cluster blobs).
+     *
+     * @returns The current {@link SocialConstellation} (`asOf: null` when no snapshot exists yet).
+     * @throws {SocialApiError} `400 social/constellation-disabled` or `503 social/graph-unavailable`.
+     */
+    async getConstellation() {
+        return this.get("/constellation");
+    }
+    /**
+     * Fetch the caller's Neighborhood (their own named ties with dyadic brightness). Self-view only.
+     *
+     * @param opts - Optional `includeInteractions` toggle; omit to use the project default. The response
+     *   always echoes the **effective** value via `includesInteractions`.
+     * @returns The caller's {@link SocialNeighborhood}, ties sorted brightest-first.
+     * @throws {SocialApiError} `400 social/neighborhood-disabled` or `503 social/graph-unavailable`.
+     */
+    async getNeighborhood(opts) {
+        const params = opts?.includeInteractions === undefined
+            ? undefined
+            : { includeInteractions: opts.includeInteractions };
+        return this.get("/neighborhood", params);
+    }
+    /**
+     * Fetch the project's resolved social config (which lenses are enabled, decay half-lives, k-floor).
+     * Call this at app init to know which surfaces to render.
+     *
+     * @returns The project's {@link ResolvedSocialConfig}.
+     * @throws {SocialApiError} `503 social/graph-unavailable` when the graph is not configured.
+     */
+    async getTransparency() {
+        return this.get("/transparency");
+    }
+    /**
+     * Shared GET helper: issues the request and normalizes any axios failure into a {@link SocialApiError}
+     * carrying the HTTP status + server error code.
+     */
+    async get(path, params) {
+        try {
+            const { data } = await this.http.get(path, params ? { params } : undefined);
+            return data;
+        }
+        catch (err) {
+            if (axios.isAxiosError(err)) {
+                const status = err.response?.status ?? 0;
+                const code = extractCode(err.response?.data);
+                throw new SocialApiError(code ? `Social request failed: ${code}` : `Social request failed (HTTP ${status}).`, status, code);
+            }
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=rest.js.map

package/dist/esm/transport/rest.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@agora-sdk/social-core",
+  "version": "0.6.0",
+  "private": false,
+  "license": "Apache-2.0",
+  "author": "Agora SDK Plus, maintained by Jenova Marie",
+  "description": "Platform-agnostic client for the Agora social graph (Weather, Constellation, Neighborhood lenses): typed REST transport, provider + feature-gated hooks. Pure data — no crypto.",
+  "keywords": [
+    "agora",
+    "social-graph",
+    "community",
+    "weather",
+    "constellation",
+    "neighborhood",
+    "react",
+    "typescript"
+  ],
+  "bugs": {
+    "url": "https://github.com/jenova-marie/agora-sdk-plus/issues"
+  },
+  "homepage": "https://github.com/jenova-marie/agora-sdk-plus",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jenova-marie/agora-sdk-plus.git",
+    "directory": "packages/social/core"
+  },
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@agora-server/contract": "^0.12.1",
+    "axios": "^1.4.0"
+  },
+  "peerDependencies": {
+    "@agora-sdk/core": "^1.2.2",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "scripts": {
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
+    "build": "rimraf dist && pnpm run build:esm && pnpm run build:cjs",
+    "prepublish": "pnpm run build"
+  }
+}