@sudobility/sider_client 0.0.2

package/dist/client.d.ts

@@ -0,0 +1,17 @@
+import type { CaptureRequest, CaptureResponse, Site, SiteLookupResult, StatsResponse, ToolCatalog } from "@sudobility/sider_types";
+export interface SiderClientConfig {
+    baseUrl: string;
+    /** Supplies auth headers (dev uid now, Firebase bearer later). */
+    getAuthHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
+}
+export declare class SiderClient {
+    private readonly config;
+    constructor(config: SiderClientConfig);
+    private req;
+    lookup(origin: string): Promise<SiteLookupResult>;
+    getSite(id: string): Promise<Site>;
+    listSites(): Promise<Site[]>;
+    getStats(): Promise<StatsResponse>;
+    getTools(siteId: string, includeProvisional?: boolean): Promise<ToolCatalog>;
+    uploadCapture(body: CaptureRequest): Promise<CaptureResponse>;
+}

package/dist/client.js

@@ -0,0 +1,38 @@
+// SiderClient — the typed transport over sider_api. Usable in any JS context
+// (React or a service worker); the React hooks in ./hooks wrap it. It unwraps
+// the ApiResponse envelope and throws on error.
+export class SiderClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async req(path, init) {
+        const auth = (await this.config.getAuthHeaders?.()) ?? {};
+        const res = await fetch(`${this.config.baseUrl}${path}`, {
+            ...init,
+            headers: { "content-type": "application/json", ...auth, ...(init?.headers ?? {}) },
+        });
+        const json = (await res.json());
+        if (!json.success)
+            throw new Error(json.error);
+        return json.data;
+    }
+    lookup(origin) {
+        return this.req(`/api/v1/sites/lookup?origin=${encodeURIComponent(origin)}`);
+    }
+    getSite(id) {
+        return this.req(`/api/v1/sites/${id}`);
+    }
+    listSites() {
+        return this.req(`/api/v1/sites`);
+    }
+    getStats() {
+        return this.req(`/api/v1/stats`);
+    }
+    getTools(siteId, includeProvisional = false) {
+        return this.req(`/api/v1/sites/${siteId}/tools${includeProvisional ? "?includeProvisional=1" : ""}`);
+    }
+    uploadCapture(body) {
+        return this.req(`/api/v1/capture`, { method: "POST", body: JSON.stringify(body) });
+    }
+}

package/dist/context.d.ts

@@ -0,0 +1,7 @@
+import { type ReactNode } from "react";
+import { SiderClient } from "./client";
+export declare function SiderClientProvider({ client, children }: {
+    client: SiderClient;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useSiderClient(): SiderClient;

package/dist/context.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+import { SiderClient } from "./client";
+const SiderClientContext = createContext(null);
+export function SiderClientProvider({ client, children }) {
+    return _jsx(SiderClientContext.Provider, { value: client, children: children });
+}
+export function useSiderClient() {
+    const c = useContext(SiderClientContext);
+    if (!c)
+        throw new Error("useSiderClient must be used within a <SiderClientProvider>");
+    return c;
+}

package/dist/core.d.ts

@@ -0,0 +1,2 @@
+export * from "./client";
+export type { CaptureRequest, CaptureResponse, PlannerStep, PlanStartResponse, PlanStepResponse, SiteLookupResult, StatsResponse, ToolCatalog, } from "@sudobility/sider_types";

package/dist/core.js

@@ -0,0 +1,2 @@
+// React-free entry point (for service workers / non-React contexts).
+export * from "./client";

package/dist/hooks.d.ts

@@ -0,0 +1,6 @@
+import type { CaptureRequest } from "@sudobility/sider_types";
+export declare function useSiteLookup(origin: string): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").SiteLookupResult>, Error>;
+export declare function useStats(): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").StatsResponse>, Error>;
+export declare function useSites(): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").Site[]>, Error>;
+export declare function useToolCatalog(siteId: string | undefined, includeProvisional?: boolean): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@sudobility/sider_types").ToolCatalog>, Error>;
+export declare function useCaptureUpload(): import("@tanstack/react-query").UseMutationResult<import("@sudobility/sider_types").CaptureResponse, Error, CaptureRequest, unknown>;

package/dist/hooks.js

@@ -0,0 +1,30 @@
+import { useMutation, useQuery } from "@tanstack/react-query";
+import { useSiderClient } from "./context";
+export function useSiteLookup(origin) {
+    const client = useSiderClient();
+    return useQuery({
+        queryKey: ["sider", "lookup", origin],
+        queryFn: () => client.lookup(origin),
+        enabled: Boolean(origin),
+    });
+}
+export function useStats() {
+    const client = useSiderClient();
+    return useQuery({ queryKey: ["sider", "stats"], queryFn: () => client.getStats() });
+}
+export function useSites() {
+    const client = useSiderClient();
+    return useQuery({ queryKey: ["sider", "sites"], queryFn: () => client.listSites() });
+}
+export function useToolCatalog(siteId, includeProvisional = false) {
+    const client = useSiderClient();
+    return useQuery({
+        queryKey: ["sider", "tools", siteId, includeProvisional],
+        queryFn: () => client.getTools(siteId, includeProvisional),
+        enabled: Boolean(siteId),
+    });
+}
+export function useCaptureUpload() {
+    const client = useSiderClient();
+    return useMutation({ mutationFn: (v) => client.uploadCapture(v) });
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./client";
+export * from "./context";
+export * from "./hooks";
+export type { CaptureRequest, CaptureResponse, PlannerStep, PlanStartResponse, PlanStepResponse, SiteLookupResult, StatsResponse, ToolCatalog, } from "@sudobility/sider_types";

package/dist/index.js

@@ -0,0 +1,4 @@
+// @sudobility/sider_client — typed API client + React Query hooks for sider_api.
+export * from "./client";
+export * from "./context";
+export * from "./hooks";

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@sudobility/sider_client",
+  "version": "0.0.2",
+  "description": "Sider frontend network library — typed API client + React Query hooks.",
+  "license": "BUSL-1.1",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    },
+    "./core": {
+      "types": "./src/core.ts",
+      "default": "./src/core.ts"
+    }
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@sudobility/sider_types": "^0.0.2"
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": "^5",
+    "react": "^18 || ^19"
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.62.7",
+    "@types/react": "^18.3.12",
+    "react": "^18.3.1",
+    "typescript": "^5.9.3"
+  }
+}

package/src/client.ts

@@ -0,0 +1,60 @@
+// SiderClient — the typed transport over sider_api. Usable in any JS context
+// (React or a service worker); the React hooks in ./hooks wrap it. It unwraps
+// the ApiResponse envelope and throws on error.
+
+import type {
+  ApiResponse,
+  CaptureRequest,
+  CaptureResponse,
+  Site,
+  SiteLookupResult,
+  StatsResponse,
+  ToolCatalog,
+} from "@sudobility/sider_types";
+
+export interface SiderClientConfig {
+  baseUrl: string;
+  /** Supplies auth headers (dev uid now, Firebase bearer later). */
+  getAuthHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
+}
+
+export class SiderClient {
+  constructor(private readonly config: SiderClientConfig) {}
+
+  private async req<T>(path: string, init?: RequestInit): Promise<T> {
+    const auth = (await this.config.getAuthHeaders?.()) ?? {};
+    const res = await fetch(`${this.config.baseUrl}${path}`, {
+      ...init,
+      headers: { "content-type": "application/json", ...auth, ...(init?.headers ?? {}) },
+    });
+    const json = (await res.json()) as ApiResponse<T>;
+    if (!json.success) throw new Error(json.error);
+    return json.data;
+  }
+
+  lookup(origin: string) {
+    return this.req<SiteLookupResult>(`/api/v1/sites/lookup?origin=${encodeURIComponent(origin)}`);
+  }
+
+  getSite(id: string) {
+    return this.req<Site>(`/api/v1/sites/${id}`);
+  }
+
+  listSites() {
+    return this.req<Site[]>(`/api/v1/sites`);
+  }
+
+  getStats() {
+    return this.req<StatsResponse>(`/api/v1/stats`);
+  }
+
+  getTools(siteId: string, includeProvisional = false) {
+    return this.req<ToolCatalog>(
+      `/api/v1/sites/${siteId}/tools${includeProvisional ? "?includeProvisional=1" : ""}`,
+    );
+  }
+
+  uploadCapture(body: CaptureRequest) {
+    return this.req<CaptureResponse>(`/api/v1/capture`, { method: "POST", body: JSON.stringify(body) });
+  }
+}

package/src/context.tsx

@@ -0,0 +1,14 @@
+import { createContext, useContext, type ReactNode } from "react";
+import { SiderClient } from "./client";
+
+const SiderClientContext = createContext<SiderClient | null>(null);
+
+export function SiderClientProvider({ client, children }: { client: SiderClient; children: ReactNode }) {
+  return <SiderClientContext.Provider value={client}>{children}</SiderClientContext.Provider>;
+}
+
+export function useSiderClient(): SiderClient {
+  const c = useContext(SiderClientContext);
+  if (!c) throw new Error("useSiderClient must be used within a <SiderClientProvider>");
+  return c;
+}

package/src/core.ts

@@ -0,0 +1,12 @@
+// React-free entry point (for service workers / non-React contexts).
+export * from "./client";
+export type {
+  CaptureRequest,
+  CaptureResponse,
+  PlannerStep,
+  PlanStartResponse,
+  PlanStepResponse,
+  SiteLookupResult,
+  StatsResponse,
+  ToolCatalog,
+} from "@sudobility/sider_types";

package/src/hooks.ts

@@ -0,0 +1,36 @@
+import { useMutation, useQuery } from "@tanstack/react-query";
+import type { CaptureRequest } from "@sudobility/sider_types";
+import { useSiderClient } from "./context";
+
+export function useSiteLookup(origin: string) {
+  const client = useSiderClient();
+  return useQuery({
+    queryKey: ["sider", "lookup", origin],
+    queryFn: () => client.lookup(origin),
+    enabled: Boolean(origin),
+  });
+}
+
+export function useStats() {
+  const client = useSiderClient();
+  return useQuery({ queryKey: ["sider", "stats"], queryFn: () => client.getStats() });
+}
+
+export function useSites() {
+  const client = useSiderClient();
+  return useQuery({ queryKey: ["sider", "sites"], queryFn: () => client.listSites() });
+}
+
+export function useToolCatalog(siteId: string | undefined, includeProvisional = false) {
+  const client = useSiderClient();
+  return useQuery({
+    queryKey: ["sider", "tools", siteId, includeProvisional],
+    queryFn: () => client.getTools(siteId as string, includeProvisional),
+    enabled: Boolean(siteId),
+  });
+}
+
+export function useCaptureUpload() {
+  const client = useSiderClient();
+  return useMutation({ mutationFn: (v: CaptureRequest) => client.uploadCapture(v) });
+}

package/src/index.ts

@@ -0,0 +1,14 @@
+// @sudobility/sider_client — typed API client + React Query hooks for sider_api.
+export * from "./client";
+export * from "./context";
+export * from "./hooks";
+export type {
+  CaptureRequest,
+  CaptureResponse,
+  PlannerStep,
+  PlanStartResponse,
+  PlanStepResponse,
+  SiteLookupResult,
+  StatsResponse,
+  ToolCatalog,
+} from "@sudobility/sider_types";