sea-dev 1.0.0

package/libs/util/src/invariant.ts

@@ -0,0 +1,31 @@
+const prefix: string = "Invariant failed";
+
+export class InvariantError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = "InvariantError";
+  }
+}
+
+export function hasValue(value: unknown): boolean {
+  if (typeof value === "undefined" || value === null) {
+    return false;
+  }
+  return true;
+}
+
+export function invariant(
+  condition: unknown,
+  message?: string | (() => string),
+): asserts condition {
+  // Note we're using our own definition of truthy...
+  if (condition === true || hasValue(condition)) {
+    return;
+  }
+  const provided: string | undefined = typeof message === "function" ? message() : message;
+  const value: string = provided ? `${prefix}: ${provided}` : prefix;
+  if (process.env.NODE_ENV === "production") {
+    throw new InvariantError(prefix);
+  }
+  throw new InvariantError(value);
+}

package/libs/util/src/sub-name.ts

@@ -0,0 +1,7 @@
+export function subName(submission: { id: string; name: string | null }) {
+  return submission.name ?? `Submission ${submission.id.slice(0, 4)}`;
+}
+
+export function subNameShort(submission: { id: string; name: string | null }) {
+  return submission.name ?? submission.id.slice(0, 4);
+}

package/libs/util/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "declaration": true,
+    "moduleResolution": "Bundler",
+    "module": "ESNext",
+    "target": "ES2022",
+    "skipLibCheck": true,
+    "strict": true,
+    "strictNullChecks": true,
+    "noUncheckedIndexedAccess": true,
+    "baseUrl": ".",
+    "outDir": "./dist",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["dist"]
+}

package/libs/util/vite.config.ts

@@ -0,0 +1,34 @@
+import { globSync } from "glob";
+import { resolve } from "path";
+import { defineConfig } from "vite";
+import dts from "vite-plugin-dts";
+
+const entries = Object.fromEntries(
+  globSync("src/**/*.ts", { ignore: "src/**/*.d.ts" }).map((file) => [
+    // Remove src/ and .ts extension for the key
+    file.slice(4, -3),
+    resolve(__dirname, file),
+  ]),
+);
+
+// https://vitejs.dev/config/
+export default defineConfig({
+  build: {
+    lib: {
+      entry: entries,
+      formats: ["es"],
+    },
+    rollupOptions: {
+      external: (id) => {
+        // Externalize all dependencies (anything from node_modules)
+        return !id.startsWith(".") && !id.startsWith("/") && !id.startsWith("@/");
+      },
+    },
+  },
+  resolve: {
+    alias: {
+      "@": resolve(__dirname, "src"),
+    },
+  },
+  plugins: [dts()],
+});

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "sea-dev",
+  "version": "1.0.0",
+  "description": "",
+  "packageManager": "pnpm@10.29.3",
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "eslint": "^9.36.0",
+    "prettier": "^3.6.2",
+    "prettier-plugin-organize-imports": "^4.1.0",
+    "prettier-plugin-tailwindcss": "^0.6.13",
+    "tsx": "^4.20.6",
+    "typescript": "5.8.3",
+    "typescript-eslint": "^8.46.4",
+    "yaml": "^2.8.1"
+  },
+  "pnpm": {
+    "overrides": {
+      "@types/react": "^19.1.2",
+      "@types/react-dom": "^19.1.3",
+      "@ai-sdk/provider": "^3.0.0",
+      "zod": "^3.25.76"
+    }
+  },
+  "dependencies": {
+    "exceljs": "^4.4.0"
+  }
+}

package/packages/widget/.prettierignore

@@ -0,0 +1,6 @@
+dist
+*.gen.ts
+*.md
+.tanstack
+.nitro
+.output

package/packages/widget/.prettierrc.js

@@ -0,0 +1,12 @@
+/* eslint-env node */
+/** @type {import("prettier").Config} */
+const config = {
+  plugins: ["prettier-plugin-organize-imports", "prettier-plugin-tailwindcss"],
+  tailwindFunctions: ["cva", "clsx", "cn"],
+  printWidth: 100,
+  tabWidth: 2,
+  singleQuote: false,
+  quoteProps: "as-needed",
+};
+
+export default config;

package/packages/widget/README.md

@@ -0,0 +1,95 @@
+# sea.dev widget
+
+## Installation
+
+```bash
+npm install @sea-dev/widget
+```
+
+## Components
+
+The widget package exports three main React components and one initialization function for use in different scenarios.
+
+### SeaWidget
+
+The primary widget component that displays a full submission management interface with document upload, data extraction, and viewing capabilities.
+
+```typescript
+import { SeaWidget } from "@sea-dev/widget";
+import "@sea-dev/widget/style.css";
+
+export default function YourPage() {
+  return (
+    <div className="h-full">
+      <SeaWidget
+        apiKey="your-api-key-here"
+        className="h-full"
+      />
+    </div>
+  );
+}
+```
+
+**Props:**
+
+- `apiKey` (required): Your Sea.dev API key
+- `submissionId` (optional): Pre-select a specific submission to display
+- `formId` (optional): Filter submissions by form ID
+- `dealId` (optional): Filter submissions by deal ID
+- `className` (optional): Additional CSS classes
+- `style` (optional): Inline styles
+
+### SeaDataViewer
+
+A read-only component for viewing extracted data from a specific submission.
+
+```typescript
+import { SeaDataViewer } from "@sea-dev/widget";
+import "@sea-dev/widget/style.css";
+
+export default function ViewSubmission() {
+  return (
+    <SeaDataViewer
+      apiKey="your-api-key-here"
+      submissionId="sub_123456"
+      className="w-full"
+    />
+  );
+}
+```
+
+**Props:**
+
+- `apiKey` (required): Your Sea.dev API key
+- `submissionId` (required): The submission ID to display
+- `className` (optional): Additional CSS classes
+- `style` (optional): Inline styles
+
+### SeaFileUpload
+
+A standalone file upload component for adding documents to an existing submission.
+
+```typescript
+import { SeaFileUpload } from "@sea-dev/widget";
+import "@sea-dev/widget/style.css";
+
+export default function UploadPage() {
+  const handleUpload = () => {
+    console.log("File uploaded successfully!");
+  };
+
+  return (
+    <SeaFileUpload
+      apiKey="your-api-key-here"
+      submissionId="sub_123456"
+      onUpload={handleUpload}
+    />
+  );
+}
+```
+
+**Props:**
+
+- `apiKey` (required): Your Sea.dev API key
+- `submissionId` (required): The submission ID to upload files to
+- `onUpload` (required): Callback function called after successful upload

package/packages/widget/eslint.config.mjs

@@ -0,0 +1,11 @@
+import config from "@sea/lint/eslint";
+
+export default [
+  ...config,
+  {
+    files: ["src/clients/api/**/*.{ts,tsx}"],
+    rules: {
+      "@typescript-eslint/no-explicit-any": "off",
+    },
+  },
+];

package/packages/widget/openapi-ts.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "@hey-api/openapi-ts";
+
+const API_BASE_URL = process.env.API_BASE_URL ?? "https://api.sea.dev";
+
+export default defineConfig({
+  input: `${API_BASE_URL}/docs/openapi.json`,
+  output: "src/clients/api",
+});

package/packages/widget/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@sea-dev/widget",
+  "private": false,
+  "version": "0.2.22",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "style": "dist/index.css",
+  "files": [
+    "dist/index.css",
+    "dist/index.d.ts",
+    "dist/index.js"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./style.css": "./dist/index.css"
+  },
+  "scripts": {
+    "dev": "dotenvx run -- vite build --mode development",
+    "publish:patch": "pnpm version patch && pnpm publish --no-git-checks",
+    "preview": "vite preview",
+    "client": "dotenvx run -- openapi-ts",
+    "build": "vite build --mode production",
+    "build:standalone": "VITE_BUILD_STANDALONE=true vite build --mode production",
+    "fmt": "prettier --log-level warn --write .",
+    "lint": "eslint . --ext .js,.jsx,.ts,.tsx",
+    "check": "tsc --noEmit",
+    "test": "echo no tests",
+    "ci:fmt": "prettier --check .",
+    "ci:test": "echo no tests",
+    "all": "pnpm run fmt && pnpm run lint && pnpm run check && pnpm run ci:test"
+  },
+  "dependencies": {
+    "@tanstack/react-pacer": "^0.8.0",
+    "@tanstack/react-table": "^8.21.3",
+    "@tanstack/react-virtual": "^3.13.12",
+    "date-fns": "^4.1.0",
+    "jsonpath-plus": "^10.3.0",
+    "lucide-react": "^0.503.0",
+    "pdfjs-dist": "4.8.69",
+    "react-pdf": "^9.2.1",
+    "react-resizable-panels": "^3.0.4",
+    "sonner": "^2.0.3",
+    "tailwind-merge": "^3.2.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@dotenvx/dotenvx": "^1.42.0",
+    "@eslint/js": "^9.33.0",
+    "@hey-api/openapi-ts": "^0.78.3",
+    "@sea/db": "workspace:*",
+    "@sea/lint": "workspace:*",
+    "@sea/schemas": "workspace:*",
+    "@sea/ui": "workspace:*",
+    "@sea/util": "workspace:*",
+    "@sea/core": "workspace:*",
+    "@tailwindcss/postcss": "^4.1.8",
+    "@tailwindcss/vite": "^4.1.8",
+    "@types/node": "^22.16.2",
+    "@types/react": "^19.1.1",
+    "@types/react-dom": "^19.1.1",
+    "@vitejs/plugin-react": "^5.0.0",
+    "eslint-config-prettier": "^10.1.1",
+    "eslint-plugin-react": "^7.37.4",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-plugin-react-refresh": "^0.4.20",
+    "postcss": "^8.5.6",
+    "postcss-prefixer": "^3.0.0",
+    "react": "^19.2.1",
+    "react-dom": "^19.2.1",
+    "rollup-plugin-visualizer": "^6.0.3",
+    "rollup-preserve-directives": "^1.1.3",
+    "tailwind-prefixer": "^0.1.1",
+    "tailwindcss": "^4.1.11",
+    "tsx": "^4.19.3",
+    "vite": "^7.1.2",
+    "vite-plugin-dts": "^4.5.4",
+    "vite-tsconfig-paths": "^5.1.4"
+  },
+  "peerDependencies": {
+    "react": ">=18.2.0 <20",
+    "react-dom": ">=18.2.0 <20"
+  }
+}

package/packages/widget/postcss.config.mjs

@@ -0,0 +1,10 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+    "postcss-prefixer": {
+      prefix: "sea:",
+    },
+  },
+};
+
+export default config;

package/packages/widget/src/clients/api/client/client.ts

@@ -0,0 +1,187 @@
+import type { Client, Config, RequestOptions } from "./types";
+import {
+  buildUrl,
+  createConfig,
+  createInterceptors,
+  getParseAs,
+  mergeConfigs,
+  mergeHeaders,
+  setAuthParams,
+} from "./utils";
+
+type ReqInit = Omit<RequestInit, "body" | "headers"> & {
+  body?: unknown;
+  headers: ReturnType<typeof mergeHeaders>;
+};
+
+export const createClient = (config: Config = {}): Client => {
+  let _config = mergeConfigs(createConfig(), config);
+
+  const getConfig = (): Config => ({ ..._config });
+
+  const setConfig = (config: Config): Config => {
+    _config = mergeConfigs(_config, config);
+    return getConfig();
+  };
+
+  const interceptors = createInterceptors<Request, Response, unknown, RequestOptions>();
+
+  const request: Client["request"] = async (options) => {
+    const opts = {
+      ..._config,
+      ...options,
+      fetch: options.fetch ?? _config.fetch ?? globalThis.fetch,
+      headers: mergeHeaders(_config.headers, options.headers),
+    };
+
+    if (opts.security) {
+      await setAuthParams({
+        ...opts,
+        security: opts.security,
+      });
+    }
+
+    if (opts.requestValidator) {
+      await opts.requestValidator(opts);
+    }
+
+    if (opts.body && opts.bodySerializer) {
+      opts.body = opts.bodySerializer(opts.body);
+    }
+
+    // remove Content-Type header if body is empty to avoid sending invalid requests
+    if (opts.body === undefined || opts.body === "") {
+      opts.headers.delete("Content-Type");
+    }
+
+    const url = buildUrl(opts);
+    const requestInit: ReqInit = {
+      redirect: "follow",
+      ...opts,
+    };
+
+    let request = new Request(url, requestInit);
+
+    for (const fn of interceptors.request._fns) {
+      if (fn) {
+        request = await fn(request, opts);
+      }
+    }
+
+    // fetch must be assigned here, otherwise it would throw the error:
+    // TypeError: Failed to execute 'fetch' on 'Window': Illegal invocation
+    const _fetch = opts.fetch!;
+    let response = await _fetch(request);
+
+    for (const fn of interceptors.response._fns) {
+      if (fn) {
+        response = await fn(response, request, opts);
+      }
+    }
+
+    const result = {
+      request,
+      response,
+    };
+
+    if (response.ok) {
+      if (response.status === 204 || response.headers.get("Content-Length") === "0") {
+        return opts.responseStyle === "data"
+          ? {}
+          : {
+              data: {},
+              ...result,
+            };
+      }
+
+      const parseAs =
+        (opts.parseAs === "auto"
+          ? getParseAs(response.headers.get("Content-Type"))
+          : opts.parseAs) ?? "json";
+
+      let data: unknown;
+      switch (parseAs) {
+        case "arrayBuffer":
+        case "blob":
+        case "formData":
+        case "json":
+        case "text":
+          data = await response[parseAs]();
+          break;
+        case "stream":
+          return opts.responseStyle === "data"
+            ? response.body
+            : {
+                data: response.body,
+                ...result,
+              };
+      }
+
+      if (parseAs === "json") {
+        if (opts.responseValidator) {
+          await opts.responseValidator(data);
+        }
+
+        if (opts.responseTransformer) {
+          data = await opts.responseTransformer(data);
+        }
+      }
+
+      return opts.responseStyle === "data"
+        ? data
+        : {
+            data,
+            ...result,
+          };
+    }
+
+    const textError = await response.text();
+    let jsonError: unknown;
+
+    try {
+      jsonError = JSON.parse(textError);
+    } catch {
+      // noop
+    }
+
+    const error = jsonError ?? textError;
+    let finalError = error;
+
+    for (const fn of interceptors.error._fns) {
+      if (fn) {
+        finalError = (await fn(error, response, request, opts)) as string;
+      }
+    }
+
+    finalError = finalError || ({} as string);
+
+    if (opts.throwOnError) {
+      throw finalError;
+    }
+
+    // TODO: we probably want to return error and improve types
+    return opts.responseStyle === "data"
+      ? undefined
+      : {
+          error: finalError,
+          ...result,
+        };
+  };
+
+  return {
+    buildUrl,
+    connect: (options) => request({ ...options, method: "CONNECT" }),
+    delete: (options) => request({ ...options, method: "DELETE" }),
+    get: (options) => request({ ...options, method: "GET" }),
+    getConfig,
+    head: (options) => request({ ...options, method: "HEAD" }),
+    interceptors,
+    options: (options) => request({ ...options, method: "OPTIONS" }),
+    patch: (options) => request({ ...options, method: "PATCH" }),
+    post: (options) => request({ ...options, method: "POST" }),
+    put: (options) => request({ ...options, method: "PUT" }),
+    request,
+    setConfig,
+    trace: (options) => request({ ...options, method: "TRACE" }),
+  };
+};

package/packages/widget/src/clients/api/client/index.ts

@@ -0,0 +1,22 @@
+export type { Auth } from "../core/auth";
+export {
+  formDataBodySerializer,
+  jsonBodySerializer,
+  urlSearchParamsBodySerializer,
+} from "../core/bodySerializer";
+export type { QuerySerializerOptions } from "../core/bodySerializer";
+export { buildClientParams } from "../core/params";
+export { createClient } from "./client";
+export type {
+  Client,
+  ClientOptions,
+  Config,
+  CreateClientConfig,
+  Options,
+  OptionsLegacyParser,
+  RequestOptions,
+  RequestResult,
+  ResponseStyle,
+  TDataShape,
+} from "./types";
+export { createConfig, mergeHeaders } from "./utils";