sea-dev 1.0.0

package/libs/ai/vite.config.ts

@@ -0,0 +1,38 @@
+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)
+        // Also externalize app-specific @/ imports
+        if (id.startsWith("@/clients/") || id.startsWith("@/lib/")) {
+          return true;
+        }
+        return !id.startsWith(".") && !id.startsWith("/") && !id.startsWith("@/");
+      },
+    },
+  },
+  resolve: {
+    alias: {
+      "@": resolve(__dirname, "src"),
+    },
+  },
+  plugins: [dts()],
+});

package/libs/cache/.prettierignore

@@ -0,0 +1,2 @@
+dist
+node_modules

package/libs/cache/eslint.config.mjs

@@ -0,0 +1,3 @@
+import config from "@sea/lint/eslint";
+
+export default config;

package/libs/cache/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@sea/cache",
+  "private": true,
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./feedback": "./dist/feedback.js"
+  },
+  "scripts": {
+    "build": "vite build",
+    "fmt": "prettier --log-level warn --write .",
+    "lint": "eslint --fix . --ext .js,.jsx,.ts,.tsx",
+    "check": "tsc --noEmit",
+    "ci:fmt": "prettier --check .",
+    "ci:lint": "eslint . --ext .js,.jsx,.ts,.tsx",
+    "ci:check": "pnpm run check",
+    "all": "pnpm run fmt && pnpm run lint && pnpm run check"
+  },
+  "dependencies": {
+    "lru-cache": "^11.0.2"
+  },
+  "devDependencies": {
+    "@sea/lint": "workspace:*",
+    "glob": "^11.0.3",
+    "vite": "^7.1.2",
+    "vite-plugin-dts": "^4.5.4"
+  },
+  "engines": {
+    "node": ">=22.0.0 <23.0.0",
+    "pnpm": ">=10.13.0 <11.0.0"
+  }
+}

package/libs/cache/src/feedback.ts

@@ -0,0 +1,77 @@
+import { createHash } from "crypto";
+import { LRUCache } from "lru-cache";
+
+interface AnalysisResult {
+  analysis: string;
+  timestamp: number;
+}
+
+// Memory-based LRU cache for feedback analysis results
+const feedbackAnalysisCache = new LRUCache<string, AnalysisResult>({
+  max: 1000, // Maximum 1000 cached analyses
+  ttl: 1000 * 60 * 60, // 1 hour TTL
+});
+
+export function getCachedFeedbackAnalysis(cacheKey: string): string | null {
+  const cached = feedbackAnalysisCache.get(cacheKey);
+  return cached?.analysis || null;
+}
+
+export function setCachedFeedbackAnalysis(
+  cacheKey: string,
+  analysis: string,
+): void {
+  feedbackAnalysisCache.set(cacheKey, {
+    analysis,
+    timestamp: Date.now(),
+  });
+}
+
+export function generateCacheKey(params: {
+  organizationId: string;
+  type: "item" | "pattern";
+  itemId?: string;
+  formId?: string;
+  correctionsHash?: string;
+}): string {
+  const { organizationId, type, itemId, formId, correctionsHash } = params;
+  return `feedback_analysis:${organizationId}:${type}:${itemId || "all"}:${formId || "all"}:${correctionsHash || "latest"}`;
+}
+
+export function generateCorrectionsHash(
+  corrections: Array<{
+    id: string;
+    extractedValue: unknown;
+    correctedValue: unknown;
+  }>,
+): string {
+  return createHash("md5")
+    .update(
+      JSON.stringify(
+        corrections.map((c) => ({
+          id: c.id,
+          extractedValue: c.extractedValue,
+          correctedValue: c.correctedValue,
+        })),
+      ),
+    )
+    .digest("hex");
+}
+
+export function invalidateMemoryCache(
+  organizationId: string,
+  type?: "item" | "pattern",
+  itemId?: string,
+): void {
+  // Get all keys and filter by organization and type
+  const keys = Array.from(feedbackAnalysisCache.keys());
+  const keysToDelete = keys.filter((key) => {
+    const parts = key.split(":");
+    if (parts.length < 3 || parts[1] !== organizationId) return false;
+    if (type && parts[2] !== type) return false;
+    if (itemId && parts[3] !== itemId) return false;
+    return true;
+  });
+
+  keysToDelete.forEach((key) => feedbackAnalysisCache.delete(key));
+}

package/libs/cache/src/index.ts

@@ -0,0 +1,2 @@
+// Export all cache utilities
+export * from "./feedback";

package/libs/cache/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/cache/vite.config.ts

@@ -0,0 +1,36 @@
+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/libs/clients/.prettierignore

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

package/libs/clients/eslint.config.mjs

@@ -0,0 +1,3 @@
+import config from "@sea/lint/eslint";
+
+export default config;

package/libs/clients/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@sea/clients",
+  "private": true,
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./*": {
+      "import": "./dist/*.js",
+      "types": "./dist/*.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "vite build",
+    "fmt": "prettier --log-level warn --write .",
+    "lint": "eslint --fix . --ext .js,.jsx,.ts,.tsx",
+    "check": "tsc --noEmit",
+    "test": "echo no tests",
+    "ci:fmt": "prettier --check .",
+    "ci:lint": "eslint . --ext .js,.jsx,.ts,.tsx",
+    "ci:check": "pnpm run check",
+    "ci:test": "pnpm run test",
+    "all": "pnpm run fmt && pnpm run lint && pnpm run check && pnpm run test"
+  },
+  "dependencies": {
+    "@azure-rest/ai-document-intelligence": "^1.1.0",
+    "@azure/core-auth": "^1.10.1",
+    "@azure/storage-blob": "^12.27.0",
+    "@google-cloud/documentai": "^9.3.0",
+    "@google-cloud/storage": "^7.16.0",
+    "@google/genai": "^1.34.0",
+    "@hatchet-dev/typescript-sdk": "^1.9.2",
+    "@polar-sh/sdk": "^0.34.9",
+    "@sea/config": "workspace:*",
+    "@sea/dal": "workspace:*",
+    "@sea/db": "workspace:*",
+    "drizzle-orm": "^0.43.1",
+    "loops": "^3.4.1",
+    "posthog-node": "catalog:"
+  },
+  "devDependencies": {
+    "@sea/lint": "workspace:*",
+    "@types/node": "^22.10.5",
+    "glob": "^11.0.3",
+    "vite": "^7.1.2",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^3.0.8"
+  },
+  "engines": {
+    "node": ">=22.0.0 <23.0.0",
+    "pnpm": ">=10.13.0 <11.0.0"
+  },
+  "overrides": {}
+}

package/libs/clients/src/azure.ts

@@ -0,0 +1,249 @@
+import type {
+  AnalyzedDocumentOutput,
+  AnalyzeResultOutput,
+  DocumentFieldOutput,
+  DocumentParagraphOutput,
+  DocumentSectionOutput,
+  DocumentTableCellOutput,
+  DocumentTableOutput,
+} from "@azure-rest/ai-document-intelligence";
+import {
+  BlobSASPermissions,
+  BlobServiceClient,
+  generateBlobSASQueryParameters,
+  StorageSharedKeyCredential,
+} from "@azure/storage-blob";
+import { URL } from "url";
+import type { AzureStorageConfig, AzureConfig } from "@sea/config";
+
+export type AzureDocumentResult = AnalyzeResultOutput;
+export type AzureDocument = AnalyzedDocumentOutput;
+export type AzureParagraph = DocumentParagraphOutput;
+export type AzureSection = DocumentSectionOutput;
+export type AzureTable = DocumentTableOutput;
+export type AzureTableCell = DocumentTableCellOutput;
+export type AzureFieldOutput = DocumentFieldOutput;
+
+export class AzureStorageClient {
+  private credential: StorageSharedKeyCredential;
+  private blobServiceClient: BlobServiceClient;
+
+  constructor(config: AzureStorageConfig) {
+    if (!config.accountKey || !config.accountName) {
+      throw new Error(
+        "Calling storage client in browser context is not allowed",
+      );
+    }
+    this.credential = new StorageSharedKeyCredential(
+      config.accountName,
+      config.accountKey,
+    );
+
+    this.blobServiceClient = new BlobServiceClient(
+      `https://${config.accountName}.blob.core.windows.net`,
+      this.credential,
+    );
+  }
+
+  /**
+   * Generates a read-only SAS URL valid for `expireInHours` hours.
+   */
+  public generateSas(
+    blobName: string,
+    expireInHours: number = 12,
+    containerName: string = "documents",
+  ): { url: string; expiry: Date } {
+    const now = new Date();
+    const expiry = new Date(now.valueOf() + expireInHours * 3600 * 1000);
+    const sasParams = generateBlobSASQueryParameters(
+      {
+        containerName,
+        blobName,
+        permissions: BlobSASPermissions.parse("r"),
+        startsOn: now,
+        expiresOn: expiry,
+      },
+      this.credential,
+    );
+
+    const sasToken = sasParams.toString();
+    const url = `https://${this.credential.accountName}.blob.core.windows.net/${containerName}/${blobName}?${sasToken}`;
+
+    return { url, expiry };
+  }
+
+  /**
+   * Returns true if the SAS URL has already expired.
+   */
+  public checkUrlExpiry(sasUrl: string): boolean {
+    const parsed = new URL(sasUrl);
+    const se = parsed.searchParams.get("se");
+    if (!se) {
+      throw new Error(
+        "URL does not contain an 'se' (signed expiry) parameter.",
+      );
+    }
+    // se is in ISO8601, e.g. "2025-05-30T12:34:56Z"
+    const expiryDate = new Date(se);
+    return Date.now() >= expiryDate.getTime();
+  }
+
+  /**
+   * Uploads a Buffer (or Uint8Array) to the given blob name.
+   */
+  public async uploadFile(
+    data: Buffer | Uint8Array,
+    blobName: string,
+    containerName: string = "documents",
+  ): Promise<boolean> {
+    try {
+      const containerClient =
+        this.blobServiceClient.getContainerClient(containerName);
+      const blockBlobClient = containerClient.getBlockBlobClient(blobName);
+      await blockBlobClient.uploadData(data);
+      return true;
+    } catch (err) {
+      console.error("Error uploading blob:", err);
+      return false;
+    }
+  }
+
+  /**
+   * Downloads a blob into a Buffer.
+   */
+  public async downloadFile(
+    blobName: string,
+    containerName: string = "documents",
+  ): Promise<Buffer | null> {
+    try {
+      const containerClient =
+        this.blobServiceClient.getContainerClient(containerName);
+      const blockBlobClient = containerClient.getBlockBlobClient(blobName);
+      const downloadResponse = await blockBlobClient.download();
+      const chunks: Buffer[] = [];
+      for await (const chunk of downloadResponse.readableStreamBody!) {
+        chunks.push(Buffer.from(chunk));
+      }
+      return Buffer.concat(chunks);
+    } catch (err) {
+      console.error("Error downloading blob:", err);
+      return null;
+    }
+  }
+
+  /**
+   * Deletes the specified blob.
+   */
+  public async deleteBlob(
+    blobName: string,
+    containerName: string = "documents",
+  ): Promise<boolean> {
+    try {
+      const containerClient =
+        this.blobServiceClient.getContainerClient(containerName);
+      const blockBlobClient = containerClient.getBlockBlobClient(blobName);
+      await blockBlobClient.delete();
+      return true;
+    } catch (err) {
+      console.error("Error deleting blob:", err);
+      return false;
+    }
+  }
+}
+
+export class AzureClient {
+  private storageClient?: AzureStorageClient;
+
+  constructor(config: AzureConfig) {
+    if (config.storage) {
+      this.storageClient = new AzureStorageClient(config.storage);
+    }
+  }
+
+  public getStorageClient(): AzureStorageClient {
+    if (!this.storageClient) {
+      throw new Error(
+        "Storage client is not configured. Please provide credentials in the config.",
+      );
+    }
+    return this.storageClient;
+  }
+
+  public async getSignedUrl(
+    blobName: string,
+    expireInHours: number = 12,
+    containerName: string = "documents",
+  ): Promise<{ url: string; expiry: Date }> {
+    if (!this.storageClient) {
+      throw new Error(
+        "Storage client is not configured. Please provide credentials in the config.",
+      );
+    }
+    return this.storageClient.generateSas(
+      blobName,
+      expireInHours,
+      containerName,
+    );
+  }
+
+  public checkUrlExpiry(sasUrl: string): boolean {
+    if (!this.storageClient) {
+      throw new Error(
+        "Storage client is not configured. Please provide credentials in the config.",
+      );
+    }
+    return this.storageClient.checkUrlExpiry(sasUrl);
+  }
+
+  public uploadFile(
+    data: Buffer | Uint8Array,
+    blobName: string,
+    containerName: string = "documents",
+  ): Promise<boolean> {
+    if (!this.storageClient) {
+      throw new Error(
+        "Storage client is not configured. Please provide credentials in the config.",
+      );
+    }
+    return this.storageClient.uploadFile(data, blobName, containerName);
+  }
+
+  public downloadFile(
+    blobName: string,
+    containerName: string = "documents",
+  ): Promise<Buffer | null> {
+    if (!this.storageClient) {
+      throw new Error(
+        "Storage client is not configured. Please provide credentials in the config.",
+      );
+    }
+    return this.storageClient.downloadFile(blobName, containerName);
+  }
+
+  public deleteBlob(
+    blobName: string,
+    containerName: string = "documents",
+  ): Promise<boolean> {
+    if (!this.storageClient) {
+      throw new Error(
+        "Storage client is not configured. Please provide credentials in the config.",
+      );
+    }
+    return this.storageClient.deleteBlob(blobName, containerName);
+  }
+
+  public async getExtractionOutput(uri: string): Promise<AzureDocumentResult> {
+    if (!this.storageClient) {
+      throw new Error(
+        "Storage client is not configured. Please provide credentials in the config.",
+      );
+    }
+    const result = await this.storageClient.downloadFile(uri, "output");
+    if (!result) {
+      throw new Error(
+        "Failed to download document output from Azure Blob Storage",
+      );
+    }
+    return JSON.parse(result.toString("utf8"));
+  }
+}