@sudobility/sider_client 0.1.7 → 0.1.9

package/dist/hooks.d.ts

@@ -3,21 +3,33 @@ import type { NetworkClient } from "@sudobility/types";
 import type { CaptureRequest } from "@sudobility/sider_types";
 import { SiderClient } from "./network/SiderClient";
 type QueryOpts<T> = Omit<UseQueryOptions<T>, "queryKey" | "queryFn">;
-export declare function useSiteLookup(networkClient: NetworkClient, baseUrl: string, _token: string, origin: string | null, options?: QueryOpts<Awaited<ReturnType<SiderClient["lookup"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").SiteLookupResult>, Error>;
-export declare function useSites(networkClient: NetworkClient, baseUrl: string, _token: string, options?: QueryOpts<Awaited<ReturnType<SiderClient["listSites"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").Site[]>, Error>;
-export declare function useSite(networkClient: NetworkClient, baseUrl: string, _token: string, siteId: string | null, options?: QueryOpts<Awaited<ReturnType<SiderClient["getSite"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").Site>, Error>;
-export declare function useStats(networkClient: NetworkClient, baseUrl: string, _token: string, options?: QueryOpts<Awaited<ReturnType<SiderClient["getStats"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").StatsResponse>, Error>;
-export declare function useToolCatalog(networkClient: NetworkClient, baseUrl: string, _token: string, siteId: string | null, opts?: {
+export declare function useSiteLookup(networkClient: NetworkClient, baseUrl: string, origin: string | null, options?: QueryOpts<Awaited<ReturnType<SiderClient["lookup"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").SiteLookupResult>, Error>;
+export declare function useSites(networkClient: NetworkClient, baseUrl: string, options?: QueryOpts<Awaited<ReturnType<SiderClient["listSites"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").Site[]>, Error>;
+export declare function useSite(networkClient: NetworkClient, baseUrl: string, siteId: string | null, options?: QueryOpts<Awaited<ReturnType<SiderClient["getSite"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").Site>, Error>;
+export declare function useStats(networkClient: NetworkClient, baseUrl: string, options?: QueryOpts<Awaited<ReturnType<SiderClient["getStats"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").StatsResponse>, Error>;
+export declare function useToolCatalog(networkClient: NetworkClient, baseUrl: string, siteId: string | null, opts?: {
     includeProvisional?: boolean;
     includeFlagged?: boolean;
 }, options?: QueryOpts<Awaited<ReturnType<SiderClient["getTools"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").ToolCatalog>, Error>;
-export declare function useSiteTemplates(networkClient: NetworkClient, baseUrl: string, _token: string, siteId: string | null, options?: QueryOpts<Awaited<ReturnType<SiderClient["getSiteTemplates"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").EndpointTemplate[]>, Error>;
-export declare function useSiteSlots(networkClient: NetworkClient, baseUrl: string, _token: string, siteId: string | null, options?: QueryOpts<Awaited<ReturnType<SiderClient["getSiteSlots"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").SecretSlot[]>, Error>;
-export declare function useSiteGraph(networkClient: NetworkClient, baseUrl: string, _token: string, siteId: string | null, options?: QueryOpts<Awaited<ReturnType<SiderClient["getSiteGraph"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").EndpointGraphEdge[]>, Error>;
-export declare function useToolDetail(networkClient: NetworkClient, baseUrl: string, _token: string, toolId: string | null, options?: QueryOpts<Awaited<ReturnType<SiderClient["getToolDetail"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").ToolDetailResponse>, Error>;
+export declare function useSiteTemplates(networkClient: NetworkClient, baseUrl: string, siteId: string | null, options?: QueryOpts<Awaited<ReturnType<SiderClient["getSiteTemplates"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").EndpointTemplate[]>, Error>;
+export declare function useSiteSlots(networkClient: NetworkClient, baseUrl: string, siteId: string | null, options?: QueryOpts<Awaited<ReturnType<SiderClient["getSiteSlots"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").SecretSlot[]>, Error>;
+export declare function useSiteGraph(networkClient: NetworkClient, baseUrl: string, siteId: string | null, options?: QueryOpts<Awaited<ReturnType<SiderClient["getSiteGraph"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").EndpointGraphEdge[]>, Error>;
+export declare function useToolDetail(networkClient: NetworkClient, baseUrl: string, toolId: string | null, options?: QueryOpts<Awaited<ReturnType<SiderClient["getToolDetail"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").ToolDetailResponse>, Error>;
 export declare function useMe(networkClient: NetworkClient, baseUrl: string, token: string, options?: QueryOpts<Awaited<ReturnType<SiderClient["getMe"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").MeResponse>, Error>;
 export declare function useMyCaptureBatches(networkClient: NetworkClient, baseUrl: string, token: string, siteId?: string, options?: QueryOpts<Awaited<ReturnType<SiderClient["getMyCaptureBatches"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").MyCaptureBatchSummary[]>, Error>;
 export declare function useMyCaptureBatch(networkClient: NetworkClient, baseUrl: string, token: string, batchId: string | null, options?: QueryOpts<Awaited<ReturnType<SiderClient["getMyCaptureBatch"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").MyCaptureBatchDetail>, Error>;
 export declare function useMyTools(networkClient: NetworkClient, baseUrl: string, token: string, options?: QueryOpts<Awaited<ReturnType<SiderClient["getMyTools"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").MyToolEntry[]>, Error>;
-export declare function useCaptureUpload(networkClient: NetworkClient, baseUrl: string, _token: string): import("@tanstack/react-query").UseMutationResult<import("@sudobility/sider_types").CaptureResponse, Error, CaptureRequest, unknown>;
+export declare function useCaptureUpload(networkClient: NetworkClient, baseUrl: string): import("@tanstack/react-query").UseMutationResult<import("@sudobility/sider_types").CaptureResponse, Error, CaptureRequest, unknown>;
+export declare function useMcpList(networkClient: NetworkClient, baseUrl: string, params: {
+    limit?: number;
+    offset?: number;
+    q?: string;
+}, options?: QueryOpts<Awaited<ReturnType<SiderClient["listMcp"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("./network/SiderClient").DirectoryPage>, 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;
+    offset?: number;
+    q?: string;
+}, options?: QueryOpts<Awaited<ReturnType<SiderClient["listGraphs"]>>>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("./network/SiderClient").DirectoryPage>, Error>;
+export declare function useGraphDetail(networkClient: NetworkClient, baseUrl: string, appKey: string | null, options?: QueryOpts<Awaited<ReturnType<SiderClient["graphDetail"]>>>): import("@tanstack/react-query").UseQueryResult<unknown, Error>;
 export {};

package/dist/hooks.js

@@ -3,8 +3,14 @@ import { SiderClient } from "./network/SiderClient";
 function client(networkClient, baseUrl) {
     return new SiderClient(networkClient, baseUrl);
 }
+// No token parameter on these: auth travels on the injected NetworkClient, which
+// is what SiderClient's contract says. They used to accept a `_token` they
+// ignored, so a caller could pass a real token and believe it had authenticated.
+//
+// The per-user hooks below DO keep a `token` — not as a credential, but as the
+// signed-in signal that stops a private query firing for nobody.
 // --- public data: enabled regardless of token ------------------------------
-export function useSiteLookup(networkClient, baseUrl, _token, origin, options) {
+export function useSiteLookup(networkClient, baseUrl, origin, options) {
     return useQuery({
         queryKey: ["sider", "lookup", origin],
         queryFn: () => client(networkClient, baseUrl).lookup(origin),
@@ -12,14 +18,14 @@ export function useSiteLookup(networkClient, baseUrl, _token, origin, options) {
         enabled: !!origin && (options?.enabled ?? true),
     });
 }
-export function useSites(networkClient, baseUrl, _token, options) {
+export function useSites(networkClient, baseUrl, options) {
     return useQuery({
         queryKey: ["sider", "sites"],
         queryFn: () => client(networkClient, baseUrl).listSites(),
         ...options,
     });
 }
-export function useSite(networkClient, baseUrl, _token, siteId, options) {
+export function useSite(networkClient, baseUrl, siteId, options) {
     return useQuery({
         queryKey: ["sider", "site", siteId],
         queryFn: () => client(networkClient, baseUrl).getSite(siteId),
@@ -27,14 +33,14 @@ export function useSite(networkClient, baseUrl, _token, siteId, options) {
         enabled: !!siteId && (options?.enabled ?? true),
     });
 }
-export function useStats(networkClient, baseUrl, _token, options) {
+export function useStats(networkClient, baseUrl, options) {
     return useQuery({
         queryKey: ["sider", "stats"],
         queryFn: () => client(networkClient, baseUrl).getStats(),
         ...options,
     });
 }
-export function useToolCatalog(networkClient, baseUrl, _token, siteId, opts, options) {
+export function useToolCatalog(networkClient, baseUrl, siteId, opts, options) {
     return useQuery({
         queryKey: [
             "sider",
@@ -48,7 +54,7 @@ export function useToolCatalog(networkClient, baseUrl, _token, siteId, opts, opt
         enabled: !!siteId && (options?.enabled ?? true),
     });
 }
-export function useSiteTemplates(networkClient, baseUrl, _token, siteId, options) {
+export function useSiteTemplates(networkClient, baseUrl, siteId, options) {
     return useQuery({
         queryKey: ["sider", "templates", siteId],
         queryFn: () => client(networkClient, baseUrl).getSiteTemplates(siteId),
@@ -56,7 +62,7 @@ export function useSiteTemplates(networkClient, baseUrl, _token, siteId, options
         enabled: !!siteId && (options?.enabled ?? true),
     });
 }
-export function useSiteSlots(networkClient, baseUrl, _token, siteId, options) {
+export function useSiteSlots(networkClient, baseUrl, siteId, options) {
     return useQuery({
         queryKey: ["sider", "slots", siteId],
         queryFn: () => client(networkClient, baseUrl).getSiteSlots(siteId),
@@ -64,7 +70,7 @@ export function useSiteSlots(networkClient, baseUrl, _token, siteId, options) {
         enabled: !!siteId && (options?.enabled ?? true),
     });
 }
-export function useSiteGraph(networkClient, baseUrl, _token, siteId, options) {
+export function useSiteGraph(networkClient, baseUrl, siteId, options) {
     return useQuery({
         queryKey: ["sider", "graph", siteId],
         queryFn: () => client(networkClient, baseUrl).getSiteGraph(siteId),
@@ -72,7 +78,7 @@ export function useSiteGraph(networkClient, baseUrl, _token, siteId, options) {
         enabled: !!siteId && (options?.enabled ?? true),
     });
 }
-export function useToolDetail(networkClient, baseUrl, _token, toolId, options) {
+export function useToolDetail(networkClient, baseUrl, toolId, options) {
     return useQuery({
         queryKey: ["sider", "tool", toolId],
         queryFn: () => client(networkClient, baseUrl).getToolDetail(toolId),
@@ -113,8 +119,39 @@ export function useMyTools(networkClient, baseUrl, token, options) {
         enabled: !!token && (options?.enabled ?? true),
     });
 }
-export function useCaptureUpload(networkClient, baseUrl, _token) {
+export function useCaptureUpload(networkClient, baseUrl) {
     return useMutation({
         mutationFn: (body) => client(networkClient, baseUrl).uploadCapture(body),
     });
 }
+// --- public directories: what the graph knows ------------------------------
+export function useMcpList(networkClient, baseUrl, params, options) {
+    return useQuery({
+        queryKey: ["sider", "mcp", params],
+        queryFn: () => client(networkClient, baseUrl).listMcp(params),
+        ...options,
+    });
+}
+export function useMcpManifest(networkClient, baseUrl, host, options) {
+    return useQuery({
+        queryKey: ["sider", "mcp", "manifest", host],
+        queryFn: () => client(networkClient, baseUrl).mcpManifest(host),
+        ...options,
+        enabled: !!host && (options?.enabled ?? true),
+    });
+}
+export function useGraphList(networkClient, baseUrl, params, options) {
+    return useQuery({
+        queryKey: ["sider", "graph", params],
+        queryFn: () => client(networkClient, baseUrl).listGraphs(params),
+        ...options,
+    });
+}
+export function useGraphDetail(networkClient, baseUrl, appKey, options) {
+    return useQuery({
+        queryKey: ["sider", "graph", "detail", appKey],
+        queryFn: () => client(networkClient, baseUrl).graphDetail(appKey),
+        ...options,
+        enabled: !!appKey && (options?.enabled ?? true),
+    });
+}

package/dist/network/SiderClient.d.ts

@@ -28,4 +28,32 @@ export declare class SiderClient {
     getSiteSlots(siteId: string): Promise<SecretSlot[]>;
     getSiteGraph(siteId: string): Promise<EndpointGraphEdge[]>;
     getToolDetail(toolId: string): Promise<ToolDetailResponse>;
+    listMcp(params: {
+        limit?: number;
+        offset?: number;
+        q?: string;
+    }): Promise<DirectoryPage>;
+    mcpManifest(host: string): Promise<unknown>;
+    listGraphs(params: {
+        limit?: number;
+        offset?: number;
+        q?: string;
+    }): Promise<DirectoryPage>;
+    graphDetail(appKey: string): Promise<unknown>;
+}
+/** One row of the public directories. */
+export interface DirectoryApp {
+    id: number;
+    key: string;
+    host: string | null;
+    title: string | null;
+    endpointCount: number;
+    viewCount: number;
+    lastEndpointAt: string | null;
+    lastViewAt: string | null;
+}
+export interface DirectoryPage {
+    apps: DirectoryApp[];
+    /** The count BEFORE the limit, so a pager knows how many pages there are. */
+    total: number;
 }

package/dist/network/SiderClient.js

@@ -68,4 +68,26 @@ export class SiderClient {
     getToolDetail(toolId) {
         return this.get(`/api/v1/tools/${toolId}`);
     }
+    // --- public directories of what the graph knows -------------------------
+    listMcp(params) {
+        return this.get(`/api/v1/mcp${queryString(params)}`);
+    }
+    mcpManifest(host) {
+        return this.get(`/api/v1/mcp/${encodeURIComponent(host)}`);
+    }
+    listGraphs(params) {
+        return this.get(`/api/v1/graph${queryString(params)}`);
+    }
+    graphDetail(appKey) {
+        return this.get(`/api/v1/graph/${encodeURIComponent(appKey)}`);
+    }
+}
+function queryString(params) {
+    const qs = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined && v !== null && v !== "")
+            qs.set(k, String(v));
+    }
+    const s = qs.toString();
+    return s ? `?${s}` : "";
 }

package/package.json

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

package/src/hooks.ts

@@ -9,12 +9,18 @@ function client(networkClient: NetworkClient, baseUrl: string): SiderClient {
   return new SiderClient(networkClient, baseUrl);
 }
 
+// No token parameter on these: auth travels on the injected NetworkClient, which
+// is what SiderClient's contract says. They used to accept a `_token` they
+// ignored, so a caller could pass a real token and believe it had authenticated.
+//
+// The per-user hooks below DO keep a `token` — not as a credential, but as the
+// signed-in signal that stops a private query firing for nobody.
+
 // --- public data: enabled regardless of token ------------------------------
 
 export function useSiteLookup(
   networkClient: NetworkClient,
   baseUrl: string,
-  _token: string,
   origin: string | null,
   options?: QueryOpts<Awaited<ReturnType<SiderClient["lookup"]>>>,
 ) {
@@ -29,7 +35,6 @@ export function useSiteLookup(
 export function useSites(
   networkClient: NetworkClient,
   baseUrl: string,
-  _token: string,
   options?: QueryOpts<Awaited<ReturnType<SiderClient["listSites"]>>>,
 ) {
   return useQuery({
@@ -42,7 +47,6 @@ export function useSites(
 export function useSite(
   networkClient: NetworkClient,
   baseUrl: string,
-  _token: string,
   siteId: string | null,
   options?: QueryOpts<Awaited<ReturnType<SiderClient["getSite"]>>>,
 ) {
@@ -57,7 +61,6 @@ export function useSite(
 export function useStats(
   networkClient: NetworkClient,
   baseUrl: string,
-  _token: string,
   options?: QueryOpts<Awaited<ReturnType<SiderClient["getStats"]>>>,
 ) {
   return useQuery({
@@ -70,7 +73,6 @@ export function useStats(
 export function useToolCatalog(
   networkClient: NetworkClient,
   baseUrl: string,
-  _token: string,
   siteId: string | null,
   opts?: { includeProvisional?: boolean; includeFlagged?: boolean },
   options?: QueryOpts<Awaited<ReturnType<SiderClient["getTools"]>>>,
@@ -92,7 +94,6 @@ export function useToolCatalog(
 export function useSiteTemplates(
   networkClient: NetworkClient,
   baseUrl: string,
-  _token: string,
   siteId: string | null,
   options?: QueryOpts<Awaited<ReturnType<SiderClient["getSiteTemplates"]>>>,
 ) {
@@ -107,7 +108,6 @@ export function useSiteTemplates(
 export function useSiteSlots(
   networkClient: NetworkClient,
   baseUrl: string,
-  _token: string,
   siteId: string | null,
   options?: QueryOpts<Awaited<ReturnType<SiderClient["getSiteSlots"]>>>,
 ) {
@@ -122,7 +122,6 @@ export function useSiteSlots(
 export function useSiteGraph(
   networkClient: NetworkClient,
   baseUrl: string,
-  _token: string,
   siteId: string | null,
   options?: QueryOpts<Awaited<ReturnType<SiderClient["getSiteGraph"]>>>,
 ) {
@@ -137,7 +136,6 @@ export function useSiteGraph(
 export function useToolDetail(
   networkClient: NetworkClient,
   baseUrl: string,
-  _token: string,
   toolId: string | null,
   options?: QueryOpts<Awaited<ReturnType<SiderClient["getToolDetail"]>>>,
 ) {
@@ -209,8 +207,64 @@ export function useMyTools(
   });
 }
 
-export function useCaptureUpload(networkClient: NetworkClient, baseUrl: string, _token: string) {
+export function useCaptureUpload(networkClient: NetworkClient, baseUrl: string) {
   return useMutation({
     mutationFn: (body: CaptureRequest) => client(networkClient, baseUrl).uploadCapture(body),
   });
 }
+
+// --- public directories: what the graph knows ------------------------------
+
+export function useMcpList(
+  networkClient: NetworkClient,
+  baseUrl: string,
+  params: { limit?: number; offset?: number; q?: string },
+  options?: QueryOpts<Awaited<ReturnType<SiderClient["listMcp"]>>>,
+) {
+  return useQuery({
+    queryKey: ["sider", "mcp", params],
+    queryFn: () => client(networkClient, baseUrl).listMcp(params),
+    ...options,
+  });
+}
+
+export function useMcpManifest(
+  networkClient: NetworkClient,
+  baseUrl: string,
+  host: string | null,
+  options?: QueryOpts<Awaited<ReturnType<SiderClient["mcpManifest"]>>>,
+) {
+  return useQuery({
+    queryKey: ["sider", "mcp", "manifest", host],
+    queryFn: () => client(networkClient, baseUrl).mcpManifest(host as string),
+    ...options,
+    enabled: !!host && (options?.enabled ?? true),
+  });
+}
+
+export function useGraphList(
+  networkClient: NetworkClient,
+  baseUrl: string,
+  params: { limit?: number; offset?: number; q?: string },
+  options?: QueryOpts<Awaited<ReturnType<SiderClient["listGraphs"]>>>,
+) {
+  return useQuery({
+    queryKey: ["sider", "graph", params],
+    queryFn: () => client(networkClient, baseUrl).listGraphs(params),
+    ...options,
+  });
+}
+
+export function useGraphDetail(
+  networkClient: NetworkClient,
+  baseUrl: string,
+  appKey: string | null,
+  options?: QueryOpts<Awaited<ReturnType<SiderClient["graphDetail"]>>>,
+) {
+  return useQuery({
+    queryKey: ["sider", "graph", "detail", appKey],
+    queryFn: () => client(networkClient, baseUrl).graphDetail(appKey as string),
+    ...options,
+    enabled: !!appKey && (options?.enabled ?? true),
+  });
+}

package/src/network/SiderClient.ts

@@ -106,4 +106,49 @@ export class SiderClient {
   getToolDetail(toolId: string): Promise<ToolDetailResponse> {
     return this.get(`/api/v1/tools/${toolId}`);
   }
+
+  // --- public directories of what the graph knows -------------------------
+
+  listMcp(params: { limit?: number; offset?: number; q?: string }): Promise<DirectoryPage> {
+    return this.get(`/api/v1/mcp${queryString(params)}`);
+  }
+
+  mcpManifest(host: string): Promise<unknown> {
+    return this.get(`/api/v1/mcp/${encodeURIComponent(host)}`);
+  }
+
+  listGraphs(params: { limit?: number; offset?: number; q?: string }): Promise<DirectoryPage> {
+    return this.get(`/api/v1/graph${queryString(params)}`);
+  }
+
+  graphDetail(appKey: string): Promise<unknown> {
+    return this.get(`/api/v1/graph/${encodeURIComponent(appKey)}`);
+  }
+}
+
+/** One row of the public directories. */
+export interface DirectoryApp {
+  id: number;
+  key: string;
+  host: string | null;
+  title: string | null;
+  endpointCount: number;
+  viewCount: number;
+  lastEndpointAt: string | null;
+  lastViewAt: string | null;
+}
+
+export interface DirectoryPage {
+  apps: DirectoryApp[];
+  /** The count BEFORE the limit, so a pager knows how many pages there are. */
+  total: number;
+}
+
+function queryString(params: Record<string, unknown>): string {
+  const qs = new URLSearchParams();
+  for (const [k, v] of Object.entries(params)) {
+    if (v !== undefined && v !== null && v !== "") qs.set(k, String(v));
+  }
+  const s = qs.toString();
+  return s ? `?${s}` : "";
 }