@littlebigbrain/client 0.1.0 → 0.3.0

package/src/contract-routes.test.ts

@@ -1,91 +0,0 @@
-import { test } from "node:test";
-import assert from "node:assert/strict";
-import { readFileSync } from "node:fs";
-import { resolve } from "node:path";
-
-// Contract-drift guard for the hand-written TS client surface (S8). The
-// generated types (schema.ts) are gated by the `contracts` CI job, but the
-// hand-written `this.request("METHOD", "/path")` calls embed route strings
-// nothing checks. This asserts every literal route the client issues is either
-// a real operation in contracts/openapi.json or an explicitly allow-listed
-// control-plane route.
-//
-// `npm test` runs from the package dir, so cwd is packages/lbb-client.
-const REPO_ROOT = resolve(process.cwd(), "../..");
-const OPENAPI = resolve(REPO_ROOT, "contracts/openapi.json");
-const CLIENT = resolve(process.cwd(), "src/client.ts");
-
-// Control-plane routes the TS client legitimately calls that are intentionally
-// NOT in the public data-plane OpenAPI contract (SaaS admin/session
-// orchestration). This allow-list is the visible debt register: adding a route
-// here is a conscious decision to leave it uncontracted.
-const UNCONTRACTED = new Set<string>([
-  "DELETE /api/admin/stacks",
-  "GET /api/admin/stacks",
-  "GET /api/admin/stacks/activity",
-  "GET /v1/stack/activity",
-  "POST /api/admin/sessions",
-  "POST /api/admin/stacks",
-  "POST /api/admin/stacks/rotate-key",
-]);
-
-const HTTP_METHODS = new Set(["get", "post", "put", "patch", "delete"]);
-
-function specOperations(): Set<string> {
-  const spec = JSON.parse(readFileSync(OPENAPI, "utf8")) as {
-    paths: Record<string, Record<string, unknown>>;
-  };
-  const ops = new Set<string>();
-  for (const [path, methods] of Object.entries(spec.paths)) {
-    for (const method of Object.keys(methods)) {
-      if (HTTP_METHODS.has(method.toLowerCase())) {
-        ops.add(`${method.toUpperCase()} ${path}`);
-      }
-    }
-  }
-  return ops;
-}
-
-function clientRoutes(): Set<string> {
-  // Matches `this.request("POST", "/v1/graph/commit"`; only static string-literal
-  // paths are captured (template-literal path-param routes are covered by the
-  // methods that build them and are invisible here).
-  const source = readFileSync(CLIENT, "utf8");
-  const re = /request\(\s*"([A-Z]+)",\s*"([^"]+)"/g;
-  const routes = new Set<string>();
-  let match: RegExpExecArray | null;
-  while ((match = re.exec(source)) !== null) {
-    routes.add(`${match[1]} ${match[2]}`);
-  }
-  return routes;
-}
-
-test("every TS client route is contracted or explicitly allow-listed", () => {
-  const spec = specOperations();
-  const routes = clientRoutes();
-  assert.ok(routes.size > 0, "no request routes parsed from client.ts");
-  const missing = [...routes]
-    .filter((route) => !spec.has(route) && !UNCONTRACTED.has(route))
-    .sort();
-  assert.deepEqual(
-    missing,
-    [],
-    `client calls route(s) absent from contracts/openapi.json and not allow-listed ` +
-      `(typo or removed route?): ${missing.join(", ")}`,
-  );
-});
-
-test("the uncontracted allow-list has no stale entries", () => {
-  // Prune an allow-listed route the client no longer calls, or that has since
-  // been added to the contract — keep the debt register honest.
-  const spec = specOperations();
-  const routes = clientRoutes();
-  const stale = [...UNCONTRACTED]
-    .filter((route) => !routes.has(route) || spec.has(route))
-    .sort();
-  assert.deepEqual(
-    stale,
-    [],
-    `stale allow-list entries (client no longer calls, or now contracted): ${stale.join(", ")}`,
-  );
-});

package/src/index.ts

@@ -1,16 +0,0 @@
-export { LbbClient, LbbError, parseSparqlResults } from "./client.js";
-export type {
-  LbbAdminStackCreateRequest,
-  LbbAdminStackDeleteResponse,
-  LbbAdminStackResponse,
-  LbbClientOptions,
-  LbbStackActivityResponse,
-  LbbStackActivityWindow,
-  LbbStackView,
-  FetchLike,
-  Schemas,
-  SparqlResults,
-  SparqlResultsJson,
-  SparqlTerm,
-} from "./client.js";
-export type { components, paths, operations } from "./schema.js";

package/src/node-test-shim.d.ts

@@ -1,16 +0,0 @@
-declare module "node:test" {
-  export function test(name: string, fn: () => unknown | Promise<unknown>): void;
-}
-
-declare module "node:assert/strict" {
-  const assert: {
-    equal(actual: unknown, expected: unknown, message?: string): void;
-    deepEqual(actual: unknown, expected: unknown, message?: string): void;
-    match(actual: string, expected: RegExp, message?: string): void;
-    rejects(
-      fn: () => unknown | Promise<unknown>,
-      predicate?: (error: unknown) => boolean,
-    ): Promise<void>;
-  };
-  export default assert;
-}