@sudobility/sider_client 0.1.12 → 0.1.13

package/dist/core.d.ts

@@ -1,3 +1,4 @@
 export { SiderClient } from "./network/SiderClient";
+export type { PointsSummary } from "./network/SiderClient";
 export { createFetchNetworkClient } from "./network/fetchClient";
 export type * from "@sudobility/sider_types";

package/dist/hooks.d.ts

@@ -25,6 +25,13 @@ export declare function useMcpList(networkClient: NetworkClient, baseUrl: string
     offset?: number;
     q?: string;
 }, options?: QueryOpts<Awaited<ReturnType<SiderClient["listMcp"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("./network/SiderClient").DirectoryPage>, Error>;
+/**
+ * This contributor's points.
+ *
+ * Enabled only when signed in: the endpoint is authenticated, so calling it
+ * without a token buys a 401 on every mount.
+ */
+export declare function usePoints(networkClient: NetworkClient, baseUrl: string, options?: QueryOpts<Awaited<ReturnType<SiderClient["points"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("./core").PointsSummary>, Error>;
 export declare function useMcpManifest(networkClient: NetworkClient, baseUrl: string, host: string | null, options?: QueryOpts<Awaited<ReturnType<SiderClient["mcpManifest"]>>>): import("@tanstack/react-query").UseQueryResult<unknown, Error>;
 export declare function useGraphList(networkClient: NetworkClient, baseUrl: string, params: {
     limit?: number;

package/dist/hooks.js

@@ -132,6 +132,19 @@ export function useMcpList(networkClient, baseUrl, params, options) {
         ...options,
     });
 }
+/**
+ * This contributor's points.
+ *
+ * Enabled only when signed in: the endpoint is authenticated, so calling it
+ * without a token buys a 401 on every mount.
+ */
+export function usePoints(networkClient, baseUrl, options) {
+    return useQuery({
+        queryKey: ["sider", "points"],
+        queryFn: () => client(networkClient, baseUrl).points(),
+        ...options,
+    });
+}
 export function useMcpManifest(networkClient, baseUrl, host, options) {
     return useQuery({
         queryKey: ["sider", "mcp", "manifest", host],

package/dist/network/SiderClient.d.ts

@@ -5,6 +5,12 @@ import type { CaptureRequest, CaptureResponse, EndpointGraphEdge, EndpointTempla
  * concern (e.g. auth_lib's Firebase Bearer client); this class only builds
  * URLs and unwraps the ApiResponse envelope.
  */
+/** Points earned for contributing training data. */
+export interface PointsSummary {
+    total: number;
+    /** How many pages this contributor was first to land on. */
+    newPages: number;
+}
 export declare class SiderClient {
     private readonly network;
     private readonly baseUrl;
@@ -28,6 +34,14 @@ export declare class SiderClient {
     getSiteSlots(siteId: string): Promise<SecretSlot[]>;
     getSiteGraph(siteId: string): Promise<EndpointGraphEdge[]>;
     getToolDetail(toolId: string): Promise<ToolDetailResponse>;
+    /**
+     * What this contributor has earned.
+     *
+     * Authenticated, and always about the caller: the server reads the
+     * contributor from the verified token, so there is no parameter to pass and
+     * no way to ask about anybody else.
+     */
+    points(): Promise<PointsSummary>;
     listMcp(params: {
         limit?: number;
         offset?: number;

package/dist/network/SiderClient.js

@@ -1,8 +1,3 @@
-/**
- * Typed wrapper over the Sider API. Auth is the injected NetworkClient's
- * concern (e.g. auth_lib's Firebase Bearer client); this class only builds
- * URLs and unwraps the ApiResponse envelope.
- */
 export class SiderClient {
     network;
     baseUrl;
@@ -68,6 +63,16 @@ export class SiderClient {
     getToolDetail(toolId) {
         return this.get(`/api/v1/tools/${toolId}`);
     }
+    /**
+     * What this contributor has earned.
+     *
+     * Authenticated, and always about the caller: the server reads the
+     * contributor from the verified token, so there is no parameter to pass and
+     * no way to ask about anybody else.
+     */
+    points() {
+        return this.get("/api/v1/points");
+    }
     // --- public directories of what the graph knows -------------------------
     listMcp(params) {
         return this.get(`/api/v1/mcp${queryString(params)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudobility/sider_client",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "Sider frontend network library — injected NetworkClient + React Query hooks.",
   "license": "BUSL-1.1",
   "publishConfig": {

package/src/core.ts

@@ -1,4 +1,5 @@
 // React-free entry for service workers / non-React contexts.
 export { SiderClient } from "./network/SiderClient";
+export type { PointsSummary } from "./network/SiderClient";
 export { createFetchNetworkClient } from "./network/fetchClient";
 export type * from "@sudobility/sider_types";

package/src/hooks.ts

@@ -228,6 +228,24 @@ export function useMcpList(
   });
 }
 
+/**
+ * This contributor's points.
+ *
+ * Enabled only when signed in: the endpoint is authenticated, so calling it
+ * without a token buys a 401 on every mount.
+ */
+export function usePoints(
+  networkClient: NetworkClient,
+  baseUrl: string,
+  options?: QueryOpts<Awaited<ReturnType<SiderClient["points"]>>>,
+) {
+  return useQuery({
+    queryKey: ["sider", "points"],
+    queryFn: () => client(networkClient, baseUrl).points(),
+    ...options,
+  });
+}
+
 export function useMcpManifest(
   networkClient: NetworkClient,
   baseUrl: string,

package/src/network/SiderClient.ts

@@ -22,6 +22,13 @@ import type {
  * concern (e.g. auth_lib's Firebase Bearer client); this class only builds
  * URLs and unwraps the ApiResponse envelope.
  */
+/** Points earned for contributing training data. */
+export interface PointsSummary {
+  total: number;
+  /** How many pages this contributor was first to land on. */
+  newPages: number;
+}
+
 export class SiderClient {
   constructor(
     private readonly network: NetworkClient,
@@ -107,6 +114,17 @@ export class SiderClient {
     return this.get(`/api/v1/tools/${toolId}`);
   }
 
+  /**
+   * What this contributor has earned.
+   *
+   * Authenticated, and always about the caller: the server reads the
+   * contributor from the verified token, so there is no parameter to pass and
+   * no way to ask about anybody else.
+   */
+  points(): Promise<PointsSummary> {
+    return this.get("/api/v1/points");
+  }
+
   // --- public directories of what the graph knows -------------------------
 
   listMcp(params: { limit?: number; offset?: number; q?: string }): Promise<DirectoryPage> {