@nbt-dev/components 0.0.7 → 0.0.8

package/dist/core/index.d.ts

@@ -5,5 +5,7 @@ export { BulkStreamProvider, useBulkSubscription, useBulkRowCounts, } from "./us
 export type { BulkSubscription } from "./use-bulk-stream";
 export { useLiveBulkRegistry } from "./use-cartridge-info";
 export type { BulkEntity, BulkRegistry, LiveRegistryState, } from "./use-cartridge-info";
+export { useGsheetsApi } from "./use-gsheets";
+export type { GsheetSyncConfig, GsheetSaveInput } from "./use-gsheets";
 export { getDevToolsToken, setDevToolsToken, clearDevToolsToken, authHeaders, fetchWhoAmI, devToolsSignIn, devToolsSignUp, devToolsSignOut, wsAuthProtocols, } from "./auth";
 export type { WhoAmI } from "./auth";

package/dist/core/use-gsheets.d.ts

@@ -0,0 +1,29 @@
+export type GsheetSyncConfig = {
+    cartridge: string;
+    spreadsheetId: string;
+    saEmail: string;
+    hasServiceAccount: boolean;
+    intervalSeconds: number;
+    enabled: boolean;
+    lastSyncAt: number;
+    status: string;
+    lastError: string;
+};
+export type GsheetSaveInput = {
+    cartridge: string;
+    spreadsheetUrl: string;
+    serviceAccountJson?: string;
+    intervalSeconds: number;
+    enabled: boolean;
+};
+export declare function useGsheetsApi(): {
+    list: () => Promise<GsheetSyncConfig[]>;
+    save: (input: GsheetSaveInput) => Promise<GsheetSyncConfig>;
+    syncNow: (cartridge: string) => Promise<{
+        ok: boolean;
+        error: string;
+    }>;
+    remove: (cartridge: string) => Promise<{
+        ok: boolean;
+    }>;
+};

package/dist/index.js

@@ -101,6 +101,59 @@ function useLiveBulkRegistry() {
   const carts = Object.keys(registry).sort();
   return { registry, carts, coreCarts, loading, error };
 }
+
+// src/core/use-gsheets.ts
+import { useCallback, useMemo } from "react";
+async function jsonOrThrow(r) {
+  const body = await r.json().catch(() => ({}));
+  if (!r.ok) throw new Error(body?.error ?? `HTTP ${r.status}`);
+  return body;
+}
+function useGsheetsApi() {
+  const { apiBaseUrl } = useDevToolsConfig();
+  const list = useCallback(
+    async () => jsonOrThrow(
+      await fetch(`${apiBaseUrl}/_console/integrations/gsheets`, {
+        credentials: "include",
+        headers: authHeaders()
+      })
+    ),
+    [apiBaseUrl]
+  );
+  const save = useCallback(
+    async (input) => jsonOrThrow(
+      await fetch(`${apiBaseUrl}/_console/integrations/gsheets`, {
+        method: "POST",
+        credentials: "include",
+        headers: authHeaders({ "content-type": "application/json" }),
+        body: JSON.stringify(input)
+      })
+    ),
+    [apiBaseUrl]
+  );
+  const syncNow = useCallback(
+    async (cartridge) => jsonOrThrow(
+      await fetch(`${apiBaseUrl}/_console/integrations/gsheets/sync`, {
+        method: "POST",
+        credentials: "include",
+        headers: authHeaders({ "content-type": "application/json" }),
+        body: JSON.stringify({ cartridge })
+      })
+    ),
+    [apiBaseUrl]
+  );
+  const remove = useCallback(
+    async (cartridge) => jsonOrThrow(
+      await fetch(`${apiBaseUrl}/_console/integrations/gsheets/${encodeURIComponent(cartridge)}`, {
+        method: "DELETE",
+        credentials: "include",
+        headers: authHeaders()
+      })
+    ),
+    [apiBaseUrl]
+  );
+  return useMemo(() => ({ list, save, syncNow, remove }), [list, save, syncNow, remove]);
+}
 export {
   BulkStreamProvider,
   data_table_default as DataTable,
@@ -129,6 +182,7 @@ export {
   useBulkRowCounts,
   useBulkSubscription,
   useDevToolsConfig,
+  useGsheetsApi,
   useLiveBulkRegistry,
   wsAuthProtocols,
   wsBaseFrom

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/core/use-cartridge-info.ts"],
-  "sourcesContent": ["import { useEffect, useState } from \"react\";\nimport { useDevToolsConfig } from \"./config\";\nimport { authHeaders } from \"./auth\";\n\n// Live cartridge/entity registry for the Data tab. Instead of the build-time\n// `BULK_REGISTRY` (every cart in the repo, generated by `nbt generate`), we\n// read the daemon's `/_console/contracts` \u2014 which only lists *running*\n// cartridges and carries each entity's `searchFields`. Bulk WS routes are\n// derived live (`/_ws/bulk/<cart>/<entity-lower>`) and fed straight into\n// useBulkStream. So the tab reflects what is actually installed right now.\n\nexport type BulkEntity = {\n  name: string;\n  route: string;\n  searchFields: readonly string[];\n};\nexport type BulkRegistry = Record<string, BulkEntity[]>;\n\ntype Contract = {\n  cartridge?: string;\n  core?: boolean;\n  owns?: Record<string, { searchFields?: string[] }>;\n};\n\nfunction buildRegistry(contracts: Contract[]): { reg: BulkRegistry; core: Set<string> } {\n  const reg: BulkRegistry = {};\n  const core = new Set<string>();\n  for (const c of contracts) {\n    const cart = c.cartridge;\n    if (!cart || !c.owns) continue;\n    const entities: BulkEntity[] = [];\n    for (const [name, ent] of Object.entries(c.owns)) {\n      const sf = Array.isArray(ent?.searchFields) ? ent.searchFields : [];\n      entities.push({\n        name,\n        route: `/_ws/bulk/${cart}/${name.toLowerCase()}`,\n        searchFields: sf,\n      });\n    }\n    if (entities.length > 0) {\n      reg[cart] = entities;\n      if (c.core) core.add(cart);\n    }\n  }\n  return { reg, core };\n}\n\nexport type LiveRegistryState = {\n  registry: BulkRegistry;\n  carts: string[];\n  // Cartridge slugs flagged `core` by the daemon. The Data tab keeps `auth`\n  // visible but tucks the rest of these behind a \"more cartridges\" menu so\n  // deployed (user) cartridges are what's shown by default.\n  coreCarts: Set<string>;\n  loading: boolean;\n  error: string | null;\n};\n\nexport function useLiveBulkRegistry(): LiveRegistryState {\n  const { apiBaseUrl } = useDevToolsConfig();\n  const [registry, setRegistry] = useState<BulkRegistry>({});\n  const [coreCarts, setCoreCarts] = useState<Set<string>>(new Set());\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<string | null>(null);\n\n  useEffect(() => {\n    const ac = new AbortController();\n    let cancelled = false;\n    setLoading(true);\n    setError(null);\n    (async () => {\n      try {\n        const r = await fetch(`${apiBaseUrl}/_console/contracts`, {\n          signal: ac.signal,\n          credentials: \"include\",\n          headers: authHeaders(),\n        });\n        if (!r.ok) throw new Error(`HTTP ${r.status}`);\n        const data = (await r.json()) as Contract[];\n        if (!Array.isArray(data)) throw new Error(\"malformed contracts response\");\n        if (cancelled) return;\n        const { reg, core } = buildRegistry(data);\n        setRegistry(reg);\n        setCoreCarts(core);\n      } catch (e) {\n        if (cancelled || (e as { name?: string }).name === \"AbortError\") return;\n        setError(e instanceof Error ? e.message : String(e));\n      } finally {\n        if (!cancelled) setLoading(false);\n      }\n    })();\n    return () => {\n      cancelled = true;\n      ac.abort();\n    };\n  }, [apiBaseUrl]);\n\n  const carts = Object.keys(registry).sort();\n  return { registry, carts, coreCarts, loading, error };\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,WAAW,gBAAgB;AAwBpC,SAAS,cAAc,WAAiE;AACtF,QAAM,MAAoB,CAAC;AAC3B,QAAM,OAAO,oBAAI,IAAY;AAC7B,aAAW,KAAK,WAAW;AACzB,UAAM,OAAO,EAAE;AACf,QAAI,CAAC,QAAQ,CAAC,EAAE,KAAM;AACtB,UAAM,WAAyB,CAAC;AAChC,eAAW,CAAC,MAAM,GAAG,KAAK,OAAO,QAAQ,EAAE,IAAI,GAAG;AAChD,YAAM,KAAK,MAAM,QAAQ,KAAK,YAAY,IAAI,IAAI,eAAe,CAAC;AAClE,eAAS,KAAK;AAAA,QACZ;AAAA,QACA,OAAO,aAAa,IAAI,IAAI,KAAK,YAAY,CAAC;AAAA,QAC9C,cAAc;AAAA,MAChB,CAAC;AAAA,IACH;AACA,QAAI,SAAS,SAAS,GAAG;AACvB,UAAI,IAAI,IAAI;AACZ,UAAI,EAAE,KAAM,MAAK,IAAI,IAAI;AAAA,IAC3B;AAAA,EACF;AACA,SAAO,EAAE,KAAK,KAAK;AACrB;AAaO,SAAS,sBAAyC;AACvD,QAAM,EAAE,WAAW,IAAI,kBAAkB;AACzC,QAAM,CAAC,UAAU,WAAW,IAAI,SAAuB,CAAC,CAAC;AACzD,QAAM,CAAC,WAAW,YAAY,IAAI,SAAsB,oBAAI,IAAI,CAAC;AACjE,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,IAAI;AAC3C,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAwB,IAAI;AAEtD,YAAU,MAAM;AACd,UAAM,KAAK,IAAI,gBAAgB;AAC/B,QAAI,YAAY;AAChB,eAAW,IAAI;AACf,aAAS,IAAI;AACb,KAAC,YAAY;AACX,UAAI;AACF,cAAM,IAAI,MAAM,MAAM,GAAG,UAAU,uBAAuB;AAAA,UACxD,QAAQ,GAAG;AAAA,UACX,aAAa;AAAA,UACb,SAAS,YAAY;AAAA,QACvB,CAAC;AACD,YAAI,CAAC,EAAE,GAAI,OAAM,IAAI,MAAM,QAAQ,EAAE,MAAM,EAAE;AAC7C,cAAM,OAAQ,MAAM,EAAE,KAAK;AAC3B,YAAI,CAAC,MAAM,QAAQ,IAAI,EAAG,OAAM,IAAI,MAAM,8BAA8B;AACxE,YAAI,UAAW;AACf,cAAM,EAAE,KAAK,KAAK,IAAI,cAAc,IAAI;AACxC,oBAAY,GAAG;AACf,qBAAa,IAAI;AAAA,MACnB,SAAS,GAAG;AACV,YAAI,aAAc,EAAwB,SAAS,aAAc;AACjE,iBAAS,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC,CAAC;AAAA,MACrD,UAAE;AACA,YAAI,CAAC,UAAW,YAAW,KAAK;AAAA,MAClC;AAAA,IACF,GAAG;AACH,WAAO,MAAM;AACX,kBAAY;AACZ,SAAG,MAAM;AAAA,IACX;AAAA,EACF,GAAG,CAAC,UAAU,CAAC;AAEf,QAAM,QAAQ,OAAO,KAAK,QAAQ,EAAE,KAAK;AACzC,SAAO,EAAE,UAAU,OAAO,WAAW,SAAS,MAAM;AACtD;",
+  "sources": ["../src/core/use-cartridge-info.ts", "../src/core/use-gsheets.ts"],
+  "sourcesContent": ["import { useEffect, useState } from \"react\";\nimport { useDevToolsConfig } from \"./config\";\nimport { authHeaders } from \"./auth\";\n\n// Live cartridge/entity registry for the Data tab. Instead of the build-time\n// `BULK_REGISTRY` (every cart in the repo, generated by `nbt generate`), we\n// read the daemon's `/_console/contracts` \u2014 which only lists *running*\n// cartridges and carries each entity's `searchFields`. Bulk WS routes are\n// derived live (`/_ws/bulk/<cart>/<entity-lower>`) and fed straight into\n// useBulkStream. So the tab reflects what is actually installed right now.\n\nexport type BulkEntity = {\n  name: string;\n  route: string;\n  searchFields: readonly string[];\n};\nexport type BulkRegistry = Record<string, BulkEntity[]>;\n\ntype Contract = {\n  cartridge?: string;\n  core?: boolean;\n  owns?: Record<string, { searchFields?: string[] }>;\n};\n\nfunction buildRegistry(contracts: Contract[]): { reg: BulkRegistry; core: Set<string> } {\n  const reg: BulkRegistry = {};\n  const core = new Set<string>();\n  for (const c of contracts) {\n    const cart = c.cartridge;\n    if (!cart || !c.owns) continue;\n    const entities: BulkEntity[] = [];\n    for (const [name, ent] of Object.entries(c.owns)) {\n      const sf = Array.isArray(ent?.searchFields) ? ent.searchFields : [];\n      entities.push({\n        name,\n        route: `/_ws/bulk/${cart}/${name.toLowerCase()}`,\n        searchFields: sf,\n      });\n    }\n    if (entities.length > 0) {\n      reg[cart] = entities;\n      if (c.core) core.add(cart);\n    }\n  }\n  return { reg, core };\n}\n\nexport type LiveRegistryState = {\n  registry: BulkRegistry;\n  carts: string[];\n  // Cartridge slugs flagged `core` by the daemon. The Data tab keeps `auth`\n  // visible but tucks the rest of these behind a \"more cartridges\" menu so\n  // deployed (user) cartridges are what's shown by default.\n  coreCarts: Set<string>;\n  loading: boolean;\n  error: string | null;\n};\n\nexport function useLiveBulkRegistry(): LiveRegistryState {\n  const { apiBaseUrl } = useDevToolsConfig();\n  const [registry, setRegistry] = useState<BulkRegistry>({});\n  const [coreCarts, setCoreCarts] = useState<Set<string>>(new Set());\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<string | null>(null);\n\n  useEffect(() => {\n    const ac = new AbortController();\n    let cancelled = false;\n    setLoading(true);\n    setError(null);\n    (async () => {\n      try {\n        const r = await fetch(`${apiBaseUrl}/_console/contracts`, {\n          signal: ac.signal,\n          credentials: \"include\",\n          headers: authHeaders(),\n        });\n        if (!r.ok) throw new Error(`HTTP ${r.status}`);\n        const data = (await r.json()) as Contract[];\n        if (!Array.isArray(data)) throw new Error(\"malformed contracts response\");\n        if (cancelled) return;\n        const { reg, core } = buildRegistry(data);\n        setRegistry(reg);\n        setCoreCarts(core);\n      } catch (e) {\n        if (cancelled || (e as { name?: string }).name === \"AbortError\") return;\n        setError(e instanceof Error ? e.message : String(e));\n      } finally {\n        if (!cancelled) setLoading(false);\n      }\n    })();\n    return () => {\n      cancelled = true;\n      ac.abort();\n    };\n  }, [apiBaseUrl]);\n\n  const carts = Object.keys(registry).sort();\n  return { registry, carts, coreCarts, loading, error };\n}\n", "// Fetchers + hook for the Google Sheets cartridge-sync admin endpoints\n// (/_console/integrations/gsheets/*). Admin-gated server-side \u2014 the requests\n// carry the devtools Bearer token (authHeaders) like the contracts probe.\n\nimport { useCallback, useMemo } from \"react\";\nimport { useDevToolsConfig } from \"./config\";\nimport { authHeaders } from \"./auth\";\n\nexport type GsheetSyncConfig = {\n  cartridge: string;\n  spreadsheetId: string;\n  saEmail: string;\n  hasServiceAccount: boolean;\n  intervalSeconds: number;\n  enabled: boolean;\n  lastSyncAt: number; // ms epoch, 0 = never\n  status: string; // \"ok\" | \"error\" | \"\"\n  lastError: string;\n};\n\nexport type GsheetSaveInput = {\n  cartridge: string;\n  spreadsheetUrl: string;\n  serviceAccountJson?: string; // omit to keep the stored key\n  intervalSeconds: number;\n  enabled: boolean;\n};\n\nasync function jsonOrThrow(r: Response) {\n  const body = await r.json().catch(() => ({}));\n  if (!r.ok) throw new Error((body as { error?: string })?.error ?? `HTTP ${r.status}`);\n  return body;\n}\n\nexport function useGsheetsApi() {\n  const { apiBaseUrl } = useDevToolsConfig();\n\n  const list = useCallback(\n    async (): Promise<GsheetSyncConfig[]> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/integrations/gsheets`, {\n          credentials: \"include\",\n          headers: authHeaders(),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  const save = useCallback(\n    async (input: GsheetSaveInput): Promise<GsheetSyncConfig> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/integrations/gsheets`, {\n          method: \"POST\",\n          credentials: \"include\",\n          headers: authHeaders({ \"content-type\": \"application/json\" }),\n          body: JSON.stringify(input),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  const syncNow = useCallback(\n    async (cartridge: string): Promise<{ ok: boolean; error: string }> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/integrations/gsheets/sync`, {\n          method: \"POST\",\n          credentials: \"include\",\n          headers: authHeaders({ \"content-type\": \"application/json\" }),\n          body: JSON.stringify({ cartridge }),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  const remove = useCallback(\n    async (cartridge: string): Promise<{ ok: boolean }> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/integrations/gsheets/${encodeURIComponent(cartridge)}`, {\n          method: \"DELETE\",\n          credentials: \"include\",\n          headers: authHeaders(),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  return useMemo(() => ({ list, save, syncNow, remove }), [list, save, syncNow, remove]);\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nbt-dev/components",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "Reusable React building blocks for NBT-console apps: the CodeMirror NBT editor (+LSP), the entity graph, and the live data table.",
   "type": "module",
   "main": "dist/index.js",

package/src/core/index.ts

@@ -21,6 +21,8 @@ export type {
   BulkRegistry,
   LiveRegistryState,
 } from "./use-cartridge-info";
+export { useGsheetsApi } from "./use-gsheets";
+export type { GsheetSyncConfig, GsheetSaveInput } from "./use-gsheets";
 export {
   getDevToolsToken,
   setDevToolsToken,

package/src/core/use-gsheets.ts

@@ -0,0 +1,88 @@
+// Fetchers + hook for the Google Sheets cartridge-sync admin endpoints
+// (/_console/integrations/gsheets/*). Admin-gated server-side — the requests
+// carry the devtools Bearer token (authHeaders) like the contracts probe.
+
+import { useCallback, useMemo } from "react";
+import { useDevToolsConfig } from "./config";
+import { authHeaders } from "./auth";
+
+export type GsheetSyncConfig = {
+  cartridge: string;
+  spreadsheetId: string;
+  saEmail: string;
+  hasServiceAccount: boolean;
+  intervalSeconds: number;
+  enabled: boolean;
+  lastSyncAt: number; // ms epoch, 0 = never
+  status: string; // "ok" | "error" | ""
+  lastError: string;
+};
+
+export type GsheetSaveInput = {
+  cartridge: string;
+  spreadsheetUrl: string;
+  serviceAccountJson?: string; // omit to keep the stored key
+  intervalSeconds: number;
+  enabled: boolean;
+};
+
+async function jsonOrThrow(r: Response) {
+  const body = await r.json().catch(() => ({}));
+  if (!r.ok) throw new Error((body as { error?: string })?.error ?? `HTTP ${r.status}`);
+  return body;
+}
+
+export function useGsheetsApi() {
+  const { apiBaseUrl } = useDevToolsConfig();
+
+  const list = useCallback(
+    async (): Promise<GsheetSyncConfig[]> =>
+      jsonOrThrow(
+        await fetch(`${apiBaseUrl}/_console/integrations/gsheets`, {
+          credentials: "include",
+          headers: authHeaders(),
+        }),
+      ),
+    [apiBaseUrl],
+  );
+
+  const save = useCallback(
+    async (input: GsheetSaveInput): Promise<GsheetSyncConfig> =>
+      jsonOrThrow(
+        await fetch(`${apiBaseUrl}/_console/integrations/gsheets`, {
+          method: "POST",
+          credentials: "include",
+          headers: authHeaders({ "content-type": "application/json" }),
+          body: JSON.stringify(input),
+        }),
+      ),
+    [apiBaseUrl],
+  );
+
+  const syncNow = useCallback(
+    async (cartridge: string): Promise<{ ok: boolean; error: string }> =>
+      jsonOrThrow(
+        await fetch(`${apiBaseUrl}/_console/integrations/gsheets/sync`, {
+          method: "POST",
+          credentials: "include",
+          headers: authHeaders({ "content-type": "application/json" }),
+          body: JSON.stringify({ cartridge }),
+        }),
+      ),
+    [apiBaseUrl],
+  );
+
+  const remove = useCallback(
+    async (cartridge: string): Promise<{ ok: boolean }> =>
+      jsonOrThrow(
+        await fetch(`${apiBaseUrl}/_console/integrations/gsheets/${encodeURIComponent(cartridge)}`, {
+          method: "DELETE",
+          credentials: "include",
+          headers: authHeaders(),
+        }),
+      ),
+    [apiBaseUrl],
+  );
+
+  return useMemo(() => ({ list, save, syncNow, remove }), [list, save, syncNow, remove]);
+}