rastack 0.0.58 → 0.0.59

package/test/dev.spec.ts

@@ -1,414 +0,0 @@
-import {
-  ADMIN_DEFAULTS,
-  APP_ENTRY,
-  DEV_DEFAULTS,
-  WASM_ENTRY,
-  appRootCandidates,
-  contentType,
-  parseAdminArgs,
-  parseDevArgs,
-  renderShell,
-  renderWelcome,
-  wasmBundleCandidates,
-} from "../src/dev/harness";
-import {
-  boolFilterOptions,
-  buildWriteBody,
-  changelistHeaders,
-  coerceFormValue,
-  distinctValueOptions,
-  errorDetail,
-  fieldControlType,
-  filterableFields,
-  findResource,
-  fkFilterOptions,
-  formFields,
-  initialFormValues,
-  listPath,
-  detailPath,
-  optionLabel,
-  optionsFromRows,
-  pageCount,
-  parseManifest,
-  readListEnvelope,
-  withFilters,
-  PAGE_SIZE,
-  type AdminResource,
-} from "../admin/adapters";
-
-// -- harness core -----------------------------------------------------------
-
-describe("rastack dev — arg parsing", () => {
-  it("defaults resources/out/warehouse/port and opens the browser", () => {
-    expect(parseDevArgs([])).toEqual(DEV_DEFAULTS);
-    expect(DEV_DEFAULTS.port).toBe(4321);
-    expect(DEV_DEFAULTS.warehouseDir).toBe("data/warehouse");
-  });
-
-  it("reads --port, --warehouse, --out, --no-open and a positional dir", () => {
-    const args = parseDevArgs([
-      "app/resources",
-      "--port",
-      "5000",
-      "--warehouse",
-      "data/wh",
-      "--out",
-      "build",
-      "--no-open",
-    ]);
-    expect(args).toEqual({
-      resourcesDir: "app/resources",
-      outDir: "build",
-      warehouseDir: "data/wh",
-      appDir: "",
-      port: 5000,
-      open: false,
-    });
-  });
-
-  it("ignores a non-numeric --port (keeps the default)", () => {
-    expect(parseDevArgs(["--port", "abc"]).port).toBe(4321);
-  });
-});
-
-describe("rastack admin — arg parsing", () => {
-  it("defaults to the server's port 8000 and the same dirs as dev", () => {
-    expect(parseAdminArgs([])).toEqual(ADMIN_DEFAULTS);
-    expect(ADMIN_DEFAULTS.port).toBe(8000);
-    expect(ADMIN_DEFAULTS.warehouseDir).toBe("data/warehouse");
-  });
-
-  it("reads --port, --warehouse, --out, --no-open and a positional dir", () => {
-    expect(
-      parseAdminArgs(["res", "--port", "9100", "--warehouse", "wh", "--no-open"]),
-    ).toEqual({
-      resourcesDir: "res",
-      outDir: ".rastack",
-      warehouseDir: "wh",
-      port: 9100,
-      open: false,
-    });
-  });
-});
-
-describe("rastack dev — content types", () => {
-  it("maps wasm to application/wasm (required for streaming instantiation)", () => {
-    expect(contentType("/wasm/rastack_wasm_bg.wasm")).toBe("application/wasm");
-  });
-  it("maps the common asset types", () => {
-    expect(contentType("/dev/admin.js")).toBe("text/javascript; charset=utf-8");
-    expect(contentType("/schema.rastack.json")).toBe(
-      "application/json; charset=utf-8",
-    );
-    expect(contentType("a/version-hint.text")).toBe("text/plain; charset=utf-8");
-    expect(contentType("data/v3.parquet")).toBe("application/octet-stream");
-  });
-  it("falls back to octet-stream for unknown extensions", () => {
-    expect(contentType("mystery.bin")).toBe("application/octet-stream");
-  });
-});
-
-describe("rastack dev — wasm bundle resolution", () => {
-  it("includes the installed dist/wasm and repo tools/wasm locations", () => {
-    const dirs = wasmBundleCandidates("/opt/rastack/dist", "/repo");
-    expect(dirs).toContain("/opt/rastack/dist/wasm");
-    expect(dirs).toContain("/repo/tools/wasm");
-    // The entry filename the resolver probes for.
-    expect(WASM_ENTRY).toBe("rastack_wasm.js");
-  });
-});
-
-describe("rastack admin — HTML shell", () => {
-  it("mounts #root and loads the bundled admin", () => {
-    const html = renderShell();
-    expect(html).toContain('<div id="root">');
-    expect(html).toContain('<script src="/dev/admin.js">');
-    expect(html.startsWith("<!doctype html>")).toBe(true);
-  });
-});
-
-describe("rastack dev — app resolution", () => {
-  it("defaults appDir to empty (probe the conventional roots)", () => {
-    expect(DEV_DEFAULTS.appDir).toBe("");
-  });
-
-  it("reads --app as an explicit app root", () => {
-    expect(parseDevArgs(["--app", "site"]).appDir).toBe("site");
-  });
-
-  it("probes public/www/app/root when no --app is given", () => {
-    const dirs = appRootCandidates("", "/repo");
-    expect(dirs).toEqual([
-      "/repo/public",
-      "/repo/www",
-      "/repo/app",
-      "/repo",
-    ]);
-    expect(APP_ENTRY).toBe("index.html");
-  });
-
-  it("uses only the explicit --app dir when set", () => {
-    expect(appRootCandidates("site", "/repo")).toEqual(["/repo/site"]);
-  });
-});
-
-describe("rastack dev — welcome page (no app)", () => {
-  it("is a self-contained page pointing at the backend and admin", () => {
-    const html = renderWelcome();
-    expect(html.startsWith("<!doctype html>")).toBe(true);
-    // Django-style "it worked" confirmation, not the admin bundle.
-    expect(html).not.toContain("/dev/admin.js");
-    expect(html).toContain("dev server is running");
-    expect(html).toContain("/schema.rastack.json");
-    expect(html).toContain("rastack admin");
-  });
-});
-
-// -- admin adapters ---------------------------------------------------------
-
-/** The in-repo airline fixtures, in manifest JSON shape. */
-const MANIFEST = {
-  version: 1,
-  resources: [
-    {
-      app: "airports",
-      model: "airport",
-      fields: [
-        { name: "code", type: "string", maxLength: 3, unique: true },
-        { name: "name", type: "string", maxLength: 120 },
-      ],
-      search: ["code", "name"],
-      admin: { listDisplay: ["code", "name"] },
-    },
-    {
-      app: "airports",
-      model: "terminal",
-      fields: [
-        {
-          name: "airport",
-          type: "fk",
-          relation: { app: "airports", model: "airport" },
-        },
-        { name: "label", type: "string", maxLength: 20 },
-        { name: "active", type: "bool", null: true },
-      ],
-    },
-    {
-      app: "airports",
-      model: "secret",
-      fields: [{ name: "value", type: "string" }],
-      admin: false,
-    },
-  ],
-};
-
-describe("admin adapters — manifest parsing", () => {
-  const resources = parseManifest(MANIFEST);
-
-  it("parses resources, fields, search, listDisplay and admin visibility", () => {
-    const airport = findResource(resources, "airports", "airport")!;
-    expect(airport.key).toBe("airports.airport");
-    expect(airport.label).toBe("Airport");
-    expect(airport.search).toEqual(["code", "name"]);
-    expect(airport.listDisplay).toEqual(["code", "name"]);
-    expect(airport.adminEnabled).toBe(true);
-
-    const secret = findResource(resources, "airports", "secret")!;
-    expect(secret.adminEnabled).toBe(false);
-  });
-
-  it("accepts a JSON string as well as an object", () => {
-    expect(parseManifest(JSON.stringify(MANIFEST)).length).toBe(3);
-  });
-
-  it("carries FK relation + nullability on fields", () => {
-    const terminal = findResource(resources, "airports", "terminal")!;
-    const fk = terminal.fields.find((f) => f.name === "airport")!;
-    expect(fk.type).toBe("fk");
-    expect(fk.relation).toEqual({ app: "airports", model: "airport" });
-    const active = terminal.fields.find((f) => f.name === "active")!;
-    expect(active.nullable).toBe(true);
-  });
-});
-
-describe("admin adapters — changelist", () => {
-  const resources = parseManifest(MANIFEST);
-  const airport = findResource(resources, "airports", "airport")!;
-  const terminal = findResource(resources, "airports", "terminal")!;
-
-  it("prepends an id column, then listDisplay (else all fields)", () => {
-    expect(changelistHeaders(airport).map((h) => h.key)).toEqual([
-      "id",
-      "code",
-      "name",
-    ]);
-    // terminal has no listDisplay → all fields after id
-    expect(changelistHeaders(terminal).map((h) => h.key)).toEqual([
-      "id",
-      "airport",
-      "label",
-      "active",
-    ]);
-  });
-
-  it("uses the admin's fixed page size and correct page count", () => {
-    expect(PAGE_SIZE).toBe(25);
-    expect(pageCount(0, 25)).toBe(1);
-    expect(pageCount(25, 25)).toBe(1);
-    expect(pageCount(26, 25)).toBe(2);
-  });
-
-  it("reads the DRF list envelope defensively", () => {
-    expect(readListEnvelope({ count: 2, results: [{ id: 1 }] })).toEqual({
-      count: 2,
-      results: [{ id: 1 }],
-    });
-    expect(readListEnvelope(undefined)).toEqual({ count: 0, results: [] });
-  });
-
-  it("builds the REST paths the WASM engine answers", () => {
-    expect(listPath("airports", "airport")).toBe("/api/airports/v1/airport/");
-    expect(detailPath("airports", "airport", 7)).toBe(
-      "/api/airports/v1/airport/7/",
-    );
-  });
-});
-
-describe("admin adapters — forms", () => {
-  const resources = parseManifest(MANIFEST);
-  const airport = findResource(resources, "airports", "airport")!;
-  const terminal = findResource(resources, "airports", "terminal")!;
-
-  it("chooses controls from the field datatype (FK → select)", () => {
-    const fk = terminal.fields.find((f) => f.name === "airport")!;
-    const label = terminal.fields.find((f) => f.name === "label")!;
-    const active = terminal.fields.find((f) => f.name === "active")!;
-    expect(fieldControlType(fk)).toBe("select");
-    expect(fieldControlType(label)).toBe("text");
-    expect(fieldControlType(active)).toBe("boolean");
-  });
-
-  it("seeds initial values (blank strings, false for booleans)", () => {
-    expect(initialFormValues(terminal)).toEqual({
-      airport: "",
-      label: "",
-      active: false,
-    });
-  });
-
-  it("coerces values like the Rust admin (numbers/bools parsed, empties omitted)", () => {
-    const fk = terminal.fields.find((f) => f.name === "airport")!;
-    const active = terminal.fields.find((f) => f.name === "active")!;
-    const label = terminal.fields.find((f) => f.name === "label")!;
-    expect(coerceFormValue(fk, "12")).toBe(12);
-    expect(coerceFormValue(active, "true")).toBe(true);
-    expect(coerceFormValue(active, false)).toBe(false);
-    expect(coerceFormValue(label, "")).toBeUndefined(); // omitted
-  });
-
-  it("builds a write body, omitting empty non-bool fields", () => {
-    const body = buildWriteBody(terminal, {
-      airport: "3",
-      label: "",
-      active: true,
-    });
-    expect(body).toEqual({ airport: 3, active: true });
-    expect("label" in body).toBe(false);
-  });
-
-  it("labels FK options by the first string field, else #id", () => {
-    expect(optionLabel({ id: 5, code: "JFK", name: "Kennedy" })).toBe(
-      "JFK (#5)",
-    );
-    expect(optionLabel({ id: 9 })).toBe("#9");
-    expect(optionsFromRows([{ id: 1, code: "LAX" }])).toEqual([
-      { label: "LAX (#1)", value: 1 },
-    ]);
-  });
-
-  it("form fields exclude the primary key", () => {
-    const withPk: AdminResource = {
-      ...airport,
-      fields: [
-        { name: "id", type: "int", primaryKey: true, nullable: false },
-        ...airport.fields,
-      ],
-    };
-    expect(formFields(withPk).map((f) => f.name)).toEqual(["code", "name"]);
-  });
-
-  it("extracts a {detail} error message", () => {
-    expect(errorDetail({ detail: "nope" })).toBe("nope");
-    expect(errorDetail("raw string")).toBe("raw string");
-    expect(errorDetail({})).toBe("Request failed");
-  });
-});
-
-describe("admin adapters — Linear-style filters", () => {
-  const resources = parseManifest(MANIFEST);
-  const airport = findResource(resources, "airports", "airport")!;
-  const terminal = findResource(resources, "airports", "terminal")!;
-
-  it("offers FK, boolean and non-unique string fields as facets", () => {
-    // `airport`: `code` is unique (an identifier, not a facet), `name` is a
-    // plain string → a single `choice` facet.
-    expect(filterableFields(airport)).toEqual([
-      { name: "name", label: "Name", kind: "choice" },
-    ]);
-    // `terminal`: FK + string + bool all filterable.
-    expect(filterableFields(terminal)).toEqual([
-      {
-        name: "airport",
-        label: "Airport",
-        kind: "fk",
-        relation: { app: "airports", model: "airport" },
-      },
-      { name: "label", label: "Label", kind: "choice" },
-      { name: "active", label: "Active", kind: "bool" },
-    ]);
-  });
-
-  it("booleans are True/False", () => {
-    expect(boolFilterOptions()).toEqual([
-      { value: "true", label: "True" },
-      { value: "false", label: "False" },
-    ]);
-  });
-
-  it("distinct values become sorted options, dropping empties", () => {
-    const rows = [
-      { label: "B" },
-      { label: "A" },
-      { label: "B" },
-      { label: "" },
-      { label: null },
-    ];
-    expect(distinctValueOptions(rows, "label")).toEqual([
-      { value: "A", label: "A" },
-      { value: "B", label: "B" },
-    ]);
-  });
-
-  it("drops a high-cardinality field (no useful facet)", () => {
-    const rows = Array.from({ length: 5 }, (_, i) => ({ v: `x${i}` }));
-    expect(distinctValueOptions(rows, "v", 3)).toEqual([]);
-  });
-
-  it("FK options reuse the option-label heuristic against the target rows", () => {
-    expect(
-      fkFilterOptions([
-        { id: 1, code: "JFK" },
-        { id: 2, code: "LHR" },
-      ]),
-    ).toEqual([
-      { value: "1", label: "JFK (#1)" },
-      { value: "2", label: "LHR (#2)" },
-    ]);
-  });
-
-  it("merges filters under the reserved keys (page/search always win)", () => {
-    expect(
-      withFilters({ page: "2", search: "x" }, { status: "active", page: "9" }),
-    ).toEqual({ status: "active", page: "2", search: "x" });
-  });
-});