rastack 0.0.21 → 0.0.23

package/dist/{rad.js → rastack.js}

@@ -1,19 +1,19 @@
 #!/usr/bin/env node
 "use strict";
 /**
- * rad — unified CLI for React API Stack
+ * rastack — unified CLI for React API Stack
  *
  * Commands:
- *   rad compile [resourcesDir] [outDir]     TypeScript resources → schema.rad.json + openapi.json
- *   rad check   [resourcesDir]              Validate the resource graph
- *   rad list    [resourcesDir]              Print resources, fields and relations
- *   rad urls    [resourcesDir]              Print the generated /api/{app}/v1/{model}/ routes
- *   rad generate [--schema-only]            Generate typed hooks from OpenAPI
- *   rad serve   [--warehouse dir]           Run the Rust API over an Iceberg warehouse
- *   rad admin   [--warehouse dir]           Run the Rust admin (Django-admin-style DB browser)
- *   rad wasm                                Compile the API to WebAssembly (in-browser local dev)
- *   rad scan   [files...] [--fail-on-pii]   Scan CSVs for PII and schema info
- *   rad seed   [--env dev] [--source gs://] Load CSVs into Iceberg namespace
+ *   rastack compile [resourcesDir] [outDir]     TypeScript resources → schema.rastack.json + openapi.json
+ *   rastack check   [resourcesDir]              Validate the resource graph
+ *   rastack list    [resourcesDir]              Print resources, fields and relations
+ *   rastack urls    [resourcesDir]              Print the generated /api/{app}/v1/{model}/ routes
+ *   rastack generate [--schema-only]            Generate typed hooks from OpenAPI
+ *   rastack serve   [--warehouse dir]           Run the Rust API over an Iceberg warehouse
+ *   rastack admin   [--warehouse dir]           Run the Rust admin (Django-admin-style DB browser)
+ *   rastack wasm                                Compile the API to WebAssembly (in-browser local dev)
+ *   rastack scan   [files...] [--fail-on-pii]   Scan CSVs for PII and schema info
+ *   rastack seed   [--env dev] [--source gs://] Load CSVs into Iceberg namespace
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
@@ -23,7 +23,7 @@ const child_process_1 = require("child_process");
 const path_1 = __importDefault(require("path"));
 const [command, ...rest] = process.argv.slice(2);
 function run(script, args = rest) {
-    // `rad` is a local developer CLI: `script` is a fixed internal dist filename
+    // `rastack` is a local developer CLI: `script` is a fixed internal dist filename
     // and `args` come from the developer's own shell (process.argv), not from an
     // untrusted network request — there is no command-injection surface here.
     // nosemgrep: javascript.lang.security.detect-child-process.detect-child-process
@@ -35,8 +35,8 @@ function run(script, args = rest) {
 /** Invoke the compiled Rust server binary (built by `cargo build` in rust/). */
 function runRust(subcommand) {
     const repoRoot = path_1.default.resolve(__dirname, "..", "..");
-    const binary = process.env.RAD_SERVER_BIN ||
-        path_1.default.join(repoRoot, "rust", "target", "release", "rad-server");
+    const binary = process.env.RASTACK_SERVER_BIN ||
+        path_1.default.join(repoRoot, "rust", "target", "release", "rastack-server");
     // Runs the locally-built Rust server binary with a fixed internal subcommand
     // ("serve"/"admin"); `rest` is the developer's own CLI args, not untrusted
     // input — no command-injection surface.
@@ -57,8 +57,8 @@ switch (command) {
     case "check":
     case "list":
     case "urls":
-        // rad-compile dispatches on its own first argument, so pass the command.
-        run("rad-compile.js", [command, ...rest]);
+        // rastack-compile dispatches on its own first argument, so pass the command.
+        run("rastack-compile.js", [command, ...rest]);
         break;
     case "serve":
         runRust("serve");
@@ -68,7 +68,7 @@ switch (command) {
         break;
     case "wasm":
         // Compile the API to WebAssembly for in-browser local dev.
-        run("rad-wasm-build.js", rest);
+        run("rastack-wasm-build.js", rest);
         break;
     case "scan":
         run("scan.js");
@@ -84,12 +84,12 @@ switch (command) {
     default:
         console.error(`Unknown command: "${command}"\n\n` +
             `Usage:\n` +
-            `  rad compile [resourcesDir] [outDir]\n` +
-            `  rad check | list | urls [resourcesDir]\n` +
-            `  rad generate [--schema-only]\n` +
-            `  rad serve | admin [--warehouse dir]\n` +
-            `  rad wasm                                Compile the API to WebAssembly (browser local dev)\n` +
-            `  rad scan   [files...] [--fail-on-pii]\n` +
-            `  rad seed   [--env dev|staging] [--source gs://bucket/ | ./myapp-dev/]\n`);
+            `  rastack compile [resourcesDir] [outDir]\n` +
+            `  rastack check | list | urls [resourcesDir]\n` +
+            `  rastack generate [--schema-only]\n` +
+            `  rastack serve | admin [--warehouse dir]\n` +
+            `  rastack wasm                                Compile the API to WebAssembly (browser local dev)\n` +
+            `  rastack scan   [files...] [--fail-on-pii]\n` +
+            `  rastack seed   [--env dev|staging] [--source gs://bucket/ | ./myapp-dev/]\n`);
         process.exit(1);
 }

package/dist/scan.d.ts

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 /**
- * rad scan
+ * rastack scan
  *
  * Scans CSV files in myapp-dev/ for PII column patterns and schema issues.
  * Exits non-zero if violations are found and --fail-on-pii is passed.
  *
  * Usage:
- *   rad scan [files...] [--fail-on-pii]
- *   rad scan myapp-dev/passengers.csv myapp-dev/flights.csv --fail-on-pii
+ *   rastack scan [files...] [--fail-on-pii]
+ *   rastack scan myapp-dev/passengers.csv myapp-dev/flights.csv --fail-on-pii
  */
 export {};

package/dist/scan.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 "use strict";
 /**
- * rad scan
+ * rastack scan
  *
  * Scans CSV files in myapp-dev/ for PII column patterns and schema issues.
  * Exits non-zero if violations are found and --fail-on-pii is passed.
  *
  * Usage:
- *   rad scan [files...] [--fail-on-pii]
- *   rad scan myapp-dev/passengers.csv myapp-dev/flights.csv --fail-on-pii
+ *   rastack scan [files...] [--fail-on-pii]
+ *   rastack scan myapp-dev/passengers.csv myapp-dev/flights.csv --fail-on-pii
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
@@ -70,7 +70,7 @@ if (hasErrors) {
 if (totalViolations > 0) {
     console.warn(`Scan found ${totalViolations} PII violation(s) across ${files.length} file(s).`);
     if (failOnPii) {
-        console.error("Failing because --fail-on-pii is set. Remove PII data or add access policies in .rad/policies/.");
+        console.error("Failing because --fail-on-pii is set. Remove PII data or add access policies in .rastack/policies/.");
         process.exit(1);
     }
 }

package/dist/seed.d.ts

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 /**
- * rad seed
+ * rastack seed
  *
  * Loads CSV files from a local directory or GCS bucket into the target
  * Iceberg namespace. Performs schema inference, PII check, and idempotent
  * table creation before writing rows.
  *
  * Usage:
- *   rad seed [--env dev|staging] [--source gs://bucket/ | --source ./myapp-dev/]
+ *   rastack seed [--env dev|staging] [--source gs://bucket/ | --source ./myapp-dev/]
  *
  * Environment variables (set via CI secrets or .env):
  *   GCP_PROJECT             GCP project ID

package/dist/seed.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 "use strict";
 /**
- * rad seed
+ * rastack seed
  *
  * Loads CSV files from a local directory or GCS bucket into the target
  * Iceberg namespace. Performs schema inference, PII check, and idempotent
  * table creation before writing rows.
  *
  * Usage:
- *   rad seed [--env dev|staging] [--source gs://bucket/ | --source ./myapp-dev/]
+ *   rastack seed [--env dev|staging] [--source gs://bucket/ | --source ./myapp-dev/]
  *
  * Environment variables (set via CI secrets or .env):
  *   GCP_PROJECT             GCP project ID
@@ -44,10 +44,10 @@ function resolveFiles() {
     return (0, csv_schema_1.discoverCsvFiles)(source);
 }
 function downloadFromGcs(gcsUri) {
-    const tmpDir = path_1.default.join(repoRoot, ".rad", "tmp", "seed");
+    const tmpDir = path_1.default.join(repoRoot, ".rastack", "tmp", "seed");
     fs_1.default.mkdirSync(tmpDir, { recursive: true });
     console.log(`Downloading CSVs from ${gcsUri} ...`);
-    // `rad seed` is a local/CI developer tool; `gcsUri` is an operator-supplied
+    // `rastack seed` is a local/CI developer tool; `gcsUri` is an operator-supplied
     // --source argument (a gs:// bucket the operator controls), not untrusted
     // network input, so there is no command-injection surface here.
     try {
@@ -75,7 +75,7 @@ function validateSchema(csvPath) {
             .map((v) => `  ${v.column}: ${v.reason}`)
             .join("\n");
         throw new Error(`PII detected in ${path_1.default.basename(csvPath)}:\n${list}\n` +
-            `Remove PII data before seeding. Run "rad scan" to review.`);
+            `Remove PII data before seeding. Run "rastack scan" to review.`);
     }
     return schema;
 }
@@ -118,7 +118,7 @@ function buildCreateTableSql(schema, namespace) {
 // Step 4: write schema fingerprints to registry
 // ---------------------------------------------------------------------------
 function writeFingerprint(schema) {
-    const registryDir = path_1.default.join(repoRoot, ".rad", "registry");
+    const registryDir = path_1.default.join(repoRoot, ".rastack", "registry");
     fs_1.default.mkdirSync(registryDir, { recursive: true });
     const registryPath = path_1.default.join(registryDir, `${schema.tableName}.json`);
     let existing = {};
@@ -216,16 +216,16 @@ async function main() {
         writeFingerprint(schema);
     }
     // Emit DDL summary
-    const ddlDir = path_1.default.join(repoRoot, ".rad", "ddl");
+    const ddlDir = path_1.default.join(repoRoot, ".rastack", "ddl");
     fs_1.default.mkdirSync(ddlDir, { recursive: true });
     for (const schema of schemas) {
         const ddl = buildCreateTableSql(schema, env);
         fs_1.default.writeFileSync(path_1.default.join(ddlDir, `${schema.tableName}.sql`), ddl + "\n");
     }
-    console.log(`\nDDL written to .rad/ddl/`);
+    console.log(`\nDDL written to .rastack/ddl/`);
     // Run Python seed via pyiceberg if available
     const seedScript = buildPythonSeedScript(schemas, files);
-    const scriptPath = path_1.default.join(repoRoot, ".rad", "tmp", "seed.py");
+    const scriptPath = path_1.default.join(repoRoot, ".rastack", "tmp", "seed.py");
     fs_1.default.mkdirSync(path_1.default.dirname(scriptPath), { recursive: true });
     fs_1.default.writeFileSync(scriptPath, seedScript);
     const pythonBin = process.env.PYTHON ?? "python";

package/hooks/real-time/pusher.ts

@@ -2,7 +2,7 @@ import { useEffect } from "react";
 import { useSyncEngineOptional } from "../../sync/provider";
 
 export interface PusherWakeOptions {
-  /** Channel to subscribe to. Defaults to "rad-sync". */
+  /** Channel to subscribe to. Defaults to "rastack-sync". */
   channel?: string;
   /** Event name carrying sync notifications. Defaults to "sync". */
   event?: string;
@@ -20,7 +20,7 @@ export interface PusherWakeOptions {
  */
 export function usePusher(options?: PusherWakeOptions) {
   const engine = useSyncEngineOptional();
-  const channelName = options?.channel || "rad-sync";
+  const channelName = options?.channel || "rastack-sync";
   const eventName = options?.event || "sync";
   const client =
     options?.client ??

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "rastack",
-  "version": "0.0.21",
+  "version": "0.0.23",
   "description": "",
   "main": "runtime.ts",
   "types": "runtime.ts",
   "bin": {
-    "rastack": "dist/index.js",
-    "rad": "dist/rad.js"
+    "rastack": "dist/rastack.js"
   },
   "publishConfig": {
     "access": "public"

package/provider/provider.tsx

@@ -9,8 +9,8 @@ import React, {
 } from "react";
 import { API, configureApi, resetApi } from "../hooks/query/api";
 import {
-  RadClient,
-  RadEngine,
+  RastackClient,
+  RastackEngine,
   RAStackProviderConfig,
   RadStatus,
   WarehouseSource,
@@ -33,7 +33,7 @@ import {
   purgeIdentityCache,
 } from "../cache";
 
-const RadContext = createContext<RadClient | null>(null);
+const RastackContext = createContext<RastackClient | null>(null);
 
 /**
  * The one place a React app configures *where the API runs* — over HTTP
@@ -52,7 +52,7 @@ export function RAStackProvider({
   ...config
 }: RAStackProviderConfig & { children: ReactNode }): JSX.Element {
   const [status, setStatus] = useState<RadStatus>("idle");
-  const engineRef = useRef<RadEngine | null>(null);
+  const engineRef = useRef<RastackEngine | null>(null);
   const persistRef = useRef<(() => void) & { flush: () => void }>();
   const cacheStorageRef = useRef<CacheStorage | null>(null);
 
@@ -64,7 +64,7 @@ export function RAStackProvider({
   // Locally persisted state is namespaced per identity, so two accounts on
   // one device never share bytes.
   const warehouseDb = withIdentity(
-    config.databaseName || "rad-warehouse",
+    config.databaseName || "rastack-warehouse",
     config.identity,
   );
 
@@ -76,7 +76,7 @@ export function RAStackProvider({
     await deleteIndexedDb(warehouseDb);
     // Replicated rows in the sync engine's store are derived from the same
     // access — they go too.
-    await deleteIndexedDb(config.syncDatabaseName || "rad-sync");
+    await deleteIndexedDb(config.syncDatabaseName || "rastack-sync");
   };
 
   /** Revocation entry point shared by automatic detection and app signals. */
@@ -196,7 +196,7 @@ export function RAStackProvider({
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [config.mode, config.baseURL, config.warehouseBaseUrl, config.identity]);
 
-  const client = useMemo<RadClient>(
+  const client = useMemo<RastackClient>(
     () => ({
       mode: config.mode,
       status,
@@ -227,7 +227,7 @@ export function RAStackProvider({
     [config.mode, status, config.identity],
   );
 
-  return <RadContext.Provider value={client}>{children}</RadContext.Provider>;
+  return <RastackContext.Provider value={client}>{children}</RastackContext.Provider>;
 }
 
 function pickPersistence(
@@ -255,15 +255,15 @@ function withIdentity(name: string, identity?: string): string {
 }
 
 /** Access the imperative Rad client (engine, status, warehouse helpers). */
-export function useRadClient(): RadClient {
-  const client = useContext(RadContext);
+export function useRastackClient(): RastackClient {
+  const client = useContext(RastackContext);
   if (!client) {
-    throw new Error("useRadClient must be used within a <RAStackProvider>.");
+    throw new Error("useRastackClient must be used within a <RAStackProvider>.");
   }
   return client;
 }
 
 /** Just the current status — handy for a loading gate while WASM boots. */
 export function useRadStatus(): RadStatus {
-  return useRadClient().status;
+  return useRastackClient().status;
 }

package/provider/types.ts

@@ -2,7 +2,7 @@
  * Configuration for `<RAStackProvider>` — the single place a React app chooses
  * *where the API runs*:
  *
- * - `remote` — talk to the Rust API over HTTP (Lambda in prod, `rad serve`
+ * - `remote` — talk to the Rust API over HTTP (Lambda in prod, `rastack serve`
  *   locally). The classic client/server split.
  * - `local`  — compile-free local development: the entire API runs in the
  *   browser via WebAssembly over an in-memory Iceberg warehouse, seeded from a
@@ -14,8 +14,8 @@
  */
 export type RadMode = "remote" | "local" | "s3";
 
-/** The subset of the WASM `RadApi` class the provider uses. */
-export interface RadEngine {
+/** The subset of the WASM `RastackApi` class the provider uses. */
+export interface RastackEngine {
   handle(
     method: string,
     path: string,
@@ -34,21 +34,21 @@ export interface RadEngine {
   setAuth?(subject: string | undefined, groups?: string[]): void;
 }
 
-/** Constructor of the generated `RadApi` class. */
-export interface RadEngineCtor {
-  new (manifestJson: string, openapiJson?: string): RadEngine;
+/** Constructor of the generated `RastackApi` class. */
+export interface RastackEngineCtor {
+  new (manifestJson: string, openapiJson?: string): RastackEngine;
 }
 
 /** What a WASM bundle loader must resolve to. */
-export interface RadWasmModule {
+export interface RastackWasmModule {
   /** wasm-pack `web` target exposes an init fn that fetches the `.wasm`. */
   default?: (input?: any) => Promise<any>;
   init?: (input?: any) => Promise<any>;
-  RadApi: RadEngineCtor;
+  RastackApi: RastackEngineCtor;
 }
 
 /** Load and initialise the compiled WASM engine module. */
-export type RadEngineLoader = () => Promise<RadWasmModule>;
+export type RastackEngineLoader = () => Promise<RastackWasmModule>;
 
 /** Where to read/write the warehouse blob in `s3` mode (or any custom sink). */
 export interface WarehouseSource {
@@ -84,7 +84,7 @@ export interface RAStackProviderConfig {
    */
   onAccessRevoked?: () => void;
   /**
-   * The sync engine's IndexedDB database (`rad-sync` by default) so
+   * The sync engine's IndexedDB database (`rastack-sync` by default) so
    * revocation and `purgeLocal()` erase replicated rows too. Set to the same
    * `databaseName` you pass the sync engine if you changed it.
    */
@@ -97,7 +97,7 @@ export interface RAStackProviderConfig {
   maxOfflineMs?: number;
 
   // -- local / s3 mode --
-  /** `schema.rad.json` — object or JSON string. Required for WASM modes. */
+  /** `schema.rastack.json` — object or JSON string. Required for WASM modes. */
   manifest?: object | string;
   /** `openapi.json` — object or JSON string. Optional (`/api/schema/`). */
   openapi?: object | string;
@@ -133,9 +133,9 @@ export interface RAStackProviderConfig {
   /**
    * Override how the WASM module is loaded. Supply this from app code (where
    * your bundler can resolve the generated bundle) if the default loader can't
-   * find it. Defaults to importing `rastack/wasm/rad_wasm.js`.
+   * find it. Defaults to importing `rastack/wasm/rastack_wasm.js`.
    */
-  loadEngine?: RadEngineLoader;
+  loadEngine?: RastackEngineLoader;
 
   // -- lifecycle --
   onStatusChange?: (status: RadStatus) => void;
@@ -150,12 +150,12 @@ export type RadStatus =
   | "revoked" // access revoked — local data has been deleted
   | "error";
 
-/** Imperative handle exposed via `useRadClient()`. */
-export interface RadClient {
+/** Imperative handle exposed via `useRastackClient()`. */
+export interface RastackClient {
   mode: RadMode;
   status: RadStatus;
   /** The live WASM engine (null in `remote` mode). */
-  engine: RadEngine | null;
+  engine: RastackEngine | null;
   /** Snapshot the local warehouse to a portable blob (WASM modes only). */
   exportWarehouse(): Promise<Uint8Array>;
   /** Download that snapshot as a file — a portable backup of local edits. */

package/provider/warehouse.ts

@@ -1,6 +1,6 @@
 /**
  * Persistence for the in-browser warehouse blob produced by
- * `RadApi.exportWarehouse()`. A single blob (the whole Iceberg warehouse)
+ * `RastackApi.exportWarehouse()`. A single blob (the whole Iceberg warehouse)
  * lives in a one-row IndexedDB store so `local` mode survives reloads; `s3`
  * mode swaps this for a {@link WarehouseSource} over object storage.
  */

package/provider/wasm.ts

@@ -1,9 +1,9 @@
 import { AxiosAdapter, AxiosError, AxiosResponse } from "axios";
-import { RadEngine, RadEngineLoader, RadWasmModule } from "./types";
+import { RastackEngine, RastackEngineLoader, RastackWasmModule } from "./types";
 
 /**
- * Default WASM loader: import the bundle `rad wasm` generates
- * (`rastack/wasm/rad_wasm.js`) and run its init. The indirection through
+ * Default WASM loader: import the bundle `rastack wasm` generates
+ * (`rastack/wasm/rastack_wasm.js`) and run its init. The indirection through
  * `new Function` keeps a genuine dynamic `import()` at runtime even when the
  * package is transpiled to CommonJS, so the consumer's bundler resolves and
  * code-splits the `.wasm`.
@@ -12,8 +12,8 @@ const runtimeImport: (specifier: string) => Promise<any> =
   // eslint-disable-next-line no-new-func
   new Function("s", "return import(s)") as any;
 
-export const defaultEngineLoader: RadEngineLoader = async () => {
-  const mod: RadWasmModule = await runtimeImport("rastack/wasm/rad_wasm.js");
+export const defaultEngineLoader: RastackEngineLoader = async () => {
+  const mod: RastackWasmModule = await runtimeImport("rastack/wasm/rastack_wasm.js");
   const init = mod.default || mod.init;
   if (typeof init === "function") {
     await init();
@@ -23,14 +23,14 @@ export const defaultEngineLoader: RadEngineLoader = async () => {
 
 /**
  * Instantiate the engine from a loaded module and the compiled schema. The
- * manifest/openapi are passed as JSON strings — the same `schema.rad.json` /
+ * manifest/openapi are passed as JSON strings — the same `schema.rastack.json` /
  * `openapi.json` the Rust server reads.
  */
 export function createEngine(
-  mod: RadWasmModule,
+  mod: RastackWasmModule,
   manifest: object | string,
   openapi?: object | string,
-): RadEngine {
+): RastackEngine {
   const manifestJson =
     typeof manifest === "string" ? manifest : JSON.stringify(manifest);
   const openapiJson =
@@ -39,7 +39,7 @@ export function createEngine(
       : typeof openapi === "string"
         ? openapi
         : JSON.stringify(openapi);
-  return new mod.RadApi(manifestJson, openapiJson);
+  return new mod.RastackApi(manifestJson, openapiJson);
 }
 
 const MUTATING = new Set(["POST", "PUT", "PATCH", "DELETE"]);
@@ -55,7 +55,7 @@ const MUTATING = new Set(["POST", "PUT", "PATCH", "DELETE"]);
  * persist of the warehouse.
  */
 export function createWasmAdapter(
-  engine: RadEngine,
+  engine: RastackEngine,
   onWrite?: () => void,
 ): AxiosAdapter {
   return async (config: any): Promise<AxiosResponse> => {

package/src/compile/analyze.ts

@@ -111,7 +111,7 @@ function analyzeField(
 
   // Foreign key: the field type is Ref<App, Model>. Recover the target from
   // the string-literal type arguments — this is the "infer FK from types" step.
-  if (fieldType.getProperty("__radRef")) {
+  if (fieldType.getProperty("__rastackRef")) {
     const app = literalTypeProp(fieldType, "__app", checker, initializer);
     const model = literalTypeProp(fieldType, "__model", checker, initializer);
     if (app && model) {
@@ -120,8 +120,8 @@ function analyzeField(
     return undefined;
   }
 
-  // Scalar: the field type carries a `__radScalar` string-literal discriminant.
-  const scalar = literalTypeProp(fieldType, "__radScalar", checker, initializer);
+  // Scalar: the field type carries a `__rastackScalar` string-literal discriminant.
+  const scalar = literalTypeProp(fieldType, "__rastackScalar", checker, initializer);
   if (!scalar) return undefined;
 
   const field: FieldModel = { name, type: scalar as ScalarType };