stagent 0.6.3 → 0.7.0

package/src/lib/tables/types.ts

@@ -0,0 +1,141 @@
+import type {
+  UserTableRow,
+  UserTableColumnRow,
+  UserTableRowRow,
+  UserTableTemplateRow,
+} from "@/lib/db/schema";
+import type { ColumnDataType } from "@/lib/constants/table-status";
+
+// ── Column Definition (stored in column_schema JSON) ─────────────────
+
+export interface ColumnDef {
+  name: string;
+  displayName: string;
+  dataType: ColumnDataType;
+  position: number;
+  required?: boolean;
+  defaultValue?: string | null;
+  config?: ColumnConfig | null;
+}
+
+/** Type-specific column configuration */
+export interface ColumnConfig {
+  /** Select column: available options */
+  options?: string[];
+  /** Computed column: formula expression */
+  formula?: string;
+  /** Computed column: formula type */
+  formulaType?: "arithmetic" | "text_concat" | "date_diff" | "conditional" | "aggregate";
+  /** Computed column: expected result type */
+  resultType?: ColumnDataType;
+  /** Computed column: column names this formula depends on */
+  dependencies?: string[];
+  /** Relation column: target table ID */
+  targetTableId?: string;
+  /** Relation column: display column name in target table */
+  displayColumn?: string;
+}
+
+// ── Filter & Sort Specs ──────────────────────────────────────────────
+
+export type FilterOperator =
+  | "eq"
+  | "neq"
+  | "gt"
+  | "gte"
+  | "lt"
+  | "lte"
+  | "contains"
+  | "starts_with"
+  | "in"
+  | "is_empty"
+  | "is_not_empty";
+
+export interface FilterSpec {
+  column: string;
+  operator: FilterOperator;
+  value?: string | number | boolean | string[];
+}
+
+export interface SortSpec {
+  column: string;
+  direction: "asc" | "desc";
+}
+
+// ── Query Options ────────────────────────────────────────────────────
+
+export interface RowQueryOptions {
+  filters?: FilterSpec[];
+  sorts?: SortSpec[];
+  limit?: number;
+  offset?: number;
+}
+
+// ── Enriched Types (with joins) ──────────────────────────────────────
+
+export interface TableWithRelations extends UserTableRow {
+  projectName?: string | null;
+  columnCount: number;
+  columns?: UserTableColumnRow[];
+}
+
+export interface RowWithMeta extends UserTableRowRow {
+  parsedData: Record<string, unknown>;
+}
+
+// ── Input Types ──────────────────────────────────────────────────────
+
+export interface CreateTableInput {
+  name: string;
+  description?: string | null;
+  projectId?: string | null;
+  columns?: ColumnDef[];
+  source?: "manual" | "imported" | "agent" | "template";
+  templateId?: string | null;
+}
+
+export interface UpdateTableInput {
+  name?: string;
+  description?: string | null;
+  projectId?: string | null;
+}
+
+export interface AddColumnInput {
+  name: string;
+  displayName: string;
+  dataType: ColumnDataType;
+  required?: boolean;
+  defaultValue?: string | null;
+  config?: ColumnConfig | null;
+}
+
+export interface UpdateColumnInput {
+  displayName?: string;
+  dataType?: ColumnDataType;
+  required?: boolean;
+  defaultValue?: string | null;
+  config?: ColumnConfig | null;
+}
+
+export interface AddRowInput {
+  data: Record<string, unknown>;
+  createdBy?: string;
+}
+
+export interface UpdateRowInput {
+  data: Record<string, unknown>;
+}
+
+// ── Template Types ───────────────────────────────────────────────────
+
+export interface TemplateWithPreview extends UserTableTemplateRow {
+  parsedColumns: ColumnDef[];
+  parsedSampleData: Record<string, unknown>[];
+}
+
+export interface CloneFromTemplateInput {
+  templateId: string;
+  name: string;
+  projectId?: string | null;
+  includeSampleData?: boolean;
+}

package/src/lib/tables/validation.ts

@@ -0,0 +1,119 @@
+import { z } from "zod";
+import { COLUMN_DATA_TYPES, TABLE_SOURCES, TEMPLATE_CATEGORIES } from "@/lib/constants/table-status";
+
+// ── Column Definition Schema ─────────────────────────────────────────
+
+const columnConfigSchema = z.object({
+  options: z.array(z.string()).optional(),
+  formula: z.string().optional(),
+  formulaType: z.enum(["arithmetic", "text_concat", "date_diff", "conditional", "aggregate"]).optional(),
+  resultType: z.enum(COLUMN_DATA_TYPES).optional(),
+  dependencies: z.array(z.string()).optional(),
+  targetTableId: z.string().optional(),
+  displayColumn: z.string().optional(),
+}).optional();
+
+const columnDefSchema = z.object({
+  name: z.string().min(1).max(64),
+  displayName: z.string().min(1).max(128),
+  dataType: z.enum(COLUMN_DATA_TYPES),
+  position: z.number().int().min(0),
+  required: z.boolean().optional(),
+  defaultValue: z.string().nullable().optional(),
+  config: columnConfigSchema,
+});
+
+// ── Table Schemas ────────────────────────────────────────────────────
+
+export const createTableSchema = z.object({
+  name: z.string().min(1).max(256),
+  description: z.string().max(1024).nullable().optional(),
+  projectId: z.string().nullable().optional(),
+  columns: z.array(columnDefSchema).optional(),
+  source: z.enum(TABLE_SOURCES).optional(),
+  templateId: z.string().nullable().optional(),
+});
+
+export const updateTableSchema = z.object({
+  name: z.string().min(1).max(256).optional(),
+  description: z.string().max(1024).nullable().optional(),
+  projectId: z.string().nullable().optional(),
+});
+
+// ── Column Schemas ───────────────────────────────────────────────────
+
+export const addColumnSchema = z.object({
+  name: z.string().min(1).max(64),
+  displayName: z.string().min(1).max(128),
+  dataType: z.enum(COLUMN_DATA_TYPES),
+  required: z.boolean().optional(),
+  defaultValue: z.string().nullable().optional(),
+  config: columnConfigSchema,
+});
+
+export const updateColumnSchema = z.object({
+  displayName: z.string().min(1).max(128).optional(),
+  dataType: z.enum(COLUMN_DATA_TYPES).optional(),
+  required: z.boolean().optional(),
+  defaultValue: z.string().nullable().optional(),
+  config: columnConfigSchema,
+});
+
+export const reorderColumnsSchema = z.object({
+  /** Array of column IDs in the desired order */
+  columnIds: z.array(z.string()).min(1),
+});
+
+// ── Row Schemas ──────────────────────────────────────────────────────
+
+export const addRowsSchema = z.object({
+  rows: z.array(
+    z.object({
+      data: z.record(z.string(), z.unknown()),
+      createdBy: z.string().optional(),
+    })
+  ).min(1).max(1000),
+});
+
+export const updateRowSchema = z.object({
+  data: z.record(z.string(), z.unknown()),
+});
+
+// ── Query Schemas ────────────────────────────────────────────────────
+
+const filterOperators = [
+  "eq", "neq", "gt", "gte", "lt", "lte",
+  "contains", "starts_with", "in", "is_empty", "is_not_empty",
+] as const;
+
+export const filterSpecSchema = z.object({
+  column: z.string().min(1),
+  operator: z.enum(filterOperators),
+  value: z.union([z.string(), z.number(), z.boolean(), z.array(z.string())]).optional(),
+});
+
+export const sortSpecSchema = z.object({
+  column: z.string().min(1),
+  direction: z.enum(["asc", "desc"]),
+});
+
+export const rowQuerySchema = z.object({
+  filters: z.array(filterSpecSchema).optional(),
+  sorts: z.array(sortSpecSchema).optional(),
+  limit: z.number().int().min(1).max(1000).optional(),
+  offset: z.number().int().min(0).optional(),
+});
+
+// ── Template Schemas ─────────────────────────────────────────────────
+
+export const cloneFromTemplateSchema = z.object({
+  templateId: z.string(),
+  name: z.string().min(1).max(256),
+  projectId: z.string().nullable().optional(),
+  includeSampleData: z.boolean().optional(),
+});
+
+export const listTemplatesSchema = z.object({
+  category: z.enum(TEMPLATE_CATEGORIES).optional(),
+  scope: z.enum(["system", "user"]).optional(),
+});

package/src/lib/utils/stagent-paths.ts

@@ -20,3 +20,23 @@ export function getStagentBlueprintsDir(): string {
 export function getStagentScreenshotsDir(): string {
   return join(getStagentDataDir(), "screenshots");
 }
+
+export function getStagentSnapshotsDir(): string {
+  return join(getStagentDataDir(), "snapshots");
+}
+
+export function getStagentOutputsDir(): string {
+  return join(getStagentDataDir(), "outputs");
+}
+
+export function getStagentSessionsDir(): string {
+  return join(getStagentDataDir(), "sessions");
+}
+
+export function getStagentLogsDir(): string {
+  return join(getStagentDataDir(), "logs");
+}
+
+export function getStagentDocumentsDir(): string {
+  return join(getStagentDataDir(), "documents");
+}

package/tsconfig.json

@@ -37,6 +37,8 @@
   ],
   "exclude": [
     "node_modules",
-    "vitest.config*.ts"
+    "vitest.config*.ts",
+    "src/**/__tests__/**",
+    "src/__tests__/**"
   ]
 }