rastack 0.0.43 → 0.0.44

package/test/dev.spec.ts

@@ -0,0 +1,277 @@
+import {
+  DEV_DEFAULTS,
+  WASM_ENTRY,
+  contentType,
+  parseDevArgs,
+  renderShell,
+  wasmBundleCandidates,
+} from "../src/dev/harness";
+import {
+  buildWriteBody,
+  changelistHeaders,
+  coerceFormValue,
+  errorDetail,
+  fieldControlType,
+  findResource,
+  formFields,
+  initialFormValues,
+  listPath,
+  detailPath,
+  optionLabel,
+  optionsFromRows,
+  pageCount,
+  parseManifest,
+  readListEnvelope,
+  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",
+      port: 5000,
+      open: false,
+    });
+  });
+
+  it("ignores a non-numeric --port (keeps the default)", () => {
+    expect(parseDevArgs(["--port", "abc"]).port).toBe(4321);
+  });
+});
+
+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 dev — 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);
+  });
+});
+
+// -- 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");
+  });
+});

package/wasm/package.json

@@ -0,0 +1,4 @@
+{
+  "type": "module",
+  "sideEffects": false
+}

package/wasm/rastack_wasm.d.ts

@@ -0,0 +1,100 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/**
+ * The in-browser API engine. Cheap to clone (everything behind `Arc`), which
+ * is what lets each async call own its state without borrowing across `await`.
+ */
+export class RastackApi {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Snapshot the entire warehouse to a blob for persistence (`data/` folder,
+     * IndexedDB, or an upload to S3).
+     */
+    exportWarehouse(): Promise<any>;
+    /**
+     * Handle one request. `query` is a `{ [k]: string }` object, `body` any
+     * JSON value (or `undefined`). Resolves to `{ status, body }`.
+     */
+    handle(method: string, path: string, query: any, body: any): Promise<any>;
+    /**
+     * Seed the warehouse from a blob previously produced by
+     * [`export_warehouse`](Self::export_warehouse) (the `data/` folder or an
+     * IndexedDB/OPFS snapshot).
+     */
+    importWarehouse(blob: Uint8Array): Promise<any>;
+    /**
+     * Build an engine from the compiled manifest (`schema.rastack.json`) and an
+     * optional OpenAPI document (`openapi.json`, served at `/api/schema/`).
+     */
+    constructor(manifest_json: string, openapi_json?: string | null);
+    /**
+     * Seed one Iceberg file (metadata or data file) at its warehouse key. The
+     * provider walks the committed `data/warehouse` Iceberg tree over HTTP and
+     * calls this for each file, so the browser reads the *actual* Iceberg files
+     * — no bundled blob.
+     */
+    seedFile(key: string, bytes: Uint8Array): Promise<any>;
+    /**
+     * Run subsequent requests as a signed-in identity (the Cognito `sub` and
+     * `cognito:groups` claims). Owner fields are stamped from — and row
+     * filters and tenant scoping keyed by — this subject, matching the server
+     * byte-for-byte. Pass no subject to fall back to the trusted local
+     * context.
+     */
+    setAuth(subject: string | null | undefined, groups: any): void;
+}
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+    readonly memory: WebAssembly.Memory;
+    readonly __wbg_rastackapi_free: (a: number, b: number) => void;
+    readonly rastackapi_exportWarehouse: (a: number) => any;
+    readonly rastackapi_handle: (a: number, b: number, c: number, d: number, e: number, f: any, g: any) => any;
+    readonly rastackapi_importWarehouse: (a: number, b: number, c: number) => any;
+    readonly rastackapi_new: (a: number, b: number, c: number, d: number) => [number, number, number];
+    readonly rastackapi_seedFile: (a: number, b: number, c: number, d: number, e: number) => any;
+    readonly rastackapi_setAuth: (a: number, b: number, c: number, d: any) => [number, number];
+    readonly rust_zstd_wasm_shim_calloc: (a: number, b: number) => number;
+    readonly rust_zstd_wasm_shim_free: (a: number) => void;
+    readonly rust_zstd_wasm_shim_malloc: (a: number) => number;
+    readonly rust_zstd_wasm_shim_memcmp: (a: number, b: number, c: number) => number;
+    readonly rust_zstd_wasm_shim_memcpy: (a: number, b: number, c: number) => number;
+    readonly rust_zstd_wasm_shim_memmove: (a: number, b: number, c: number) => number;
+    readonly rust_zstd_wasm_shim_memset: (a: number, b: number, c: number) => number;
+    readonly rust_zstd_wasm_shim_qsort: (a: number, b: number, c: number, d: number) => void;
+    readonly wasm_bindgen_1a7aa9db5392c486___convert__closures_____invoke___wasm_bindgen_1a7aa9db5392c486___JsValue__core_7d5f0a2ba6a62c33___result__Result_____wasm_bindgen_1a7aa9db5392c486___JsError___true_: (a: number, b: number, c: any) => [number, number];
+    readonly wasm_bindgen_1a7aa9db5392c486___convert__closures_____invoke___js_sys_191ff9fb2bd47800___Function_fn_wasm_bindgen_1a7aa9db5392c486___JsValue_____wasm_bindgen_1a7aa9db5392c486___sys__Undefined___js_sys_191ff9fb2bd47800___Function_fn_wasm_bindgen_1a7aa9db5392c486___JsValue_____wasm_bindgen_1a7aa9db5392c486___sys__Undefined_______true_: (a: number, b: number, c: any, d: any) => void;
+    readonly __wbindgen_malloc: (a: number, b: number) => number;
+    readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_exn_store: (a: number) => void;
+    readonly __externref_table_alloc: () => number;
+    readonly __wbindgen_externrefs: WebAssembly.Table;
+    readonly __wbindgen_destroy_closure: (a: number, b: number) => void;
+    readonly __externref_table_dealloc: (a: number) => void;
+    readonly __wbindgen_start: () => void;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+
+/**
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;