frappebun 0.0.0

package/src/database/filters.ts

@@ -0,0 +1,131 @@
+/**
+ * Parse Frappe filter syntax into parameterized SQL WHERE clauses.
+ */
+
+import type {
+  FilterInput,
+  ObjectFilter,
+  ArrayFilter,
+  FilterValue,
+  FilterCondition,
+} from "../doctype/types"
+
+export interface ParsedFilter {
+  sql: string
+  values: FilterValue[]
+}
+
+export function parseFilters(filters: FilterInput): ParsedFilter {
+  if (
+    filters == null ||
+    (typeof filters === "object" && !Array.isArray(filters) && Object.keys(filters).length === 0)
+  ) {
+    return { sql: "1=1", values: [] }
+  }
+
+  if (Array.isArray(filters)) {
+    return parseArrayFilter(filters as ArrayFilter)
+  }
+
+  return parseObjectFilter(filters as ObjectFilter)
+}
+
+function parseArrayFilter(filters: ArrayFilter): ParsedFilter {
+  const [operator, ...conditions] = filters
+
+  if (operator === "or" || operator === "and") {
+    const parts: string[] = []
+    const values: FilterValue[] = []
+
+    for (const cond of conditions) {
+      const parsed = parseFilters(cond as FilterInput)
+      parts.push(`(${parsed.sql})`)
+      values.push(...parsed.values)
+    }
+
+    return { sql: parts.join(operator === "or" ? " OR " : " AND "), values }
+  }
+
+  // Plain array treated as AND
+  const parts: string[] = []
+  const values: FilterValue[] = []
+  for (const cond of filters.slice(1)) {
+    const parsed = parseFilters(cond as FilterInput)
+    parts.push(`(${parsed.sql})`)
+    values.push(...parsed.values)
+  }
+  return { sql: parts.join(" AND "), values }
+}
+
+function parseObjectFilter(filters: ObjectFilter): ParsedFilter {
+  const parts: string[] = []
+  const values: FilterValue[] = []
+
+  for (const [fieldName, condition] of Object.entries(filters)) {
+    const col = `"${fieldName}"`
+
+    if (condition === null) {
+      parts.push(`${col} IS NULL`)
+    } else if (Array.isArray(condition)) {
+      const parsed = parseOperatorCondition(col, condition as FilterCondition)
+      parts.push(parsed.sql)
+      values.push(...parsed.values)
+    } else {
+      parts.push(`${col} = ?`)
+      values.push(condition as FilterValue)
+    }
+  }
+
+  return { sql: parts.join(" AND "), values }
+}
+
+function parseOperatorCondition(col: string, [op, val]: FilterCondition): ParsedFilter {
+  const opUpper = op.toUpperCase()
+
+  switch (opUpper) {
+    case ">":
+    case "<":
+    case ">=":
+    case "<=":
+    case "=":
+    case "!=":
+      return { sql: `${col} ${op} ?`, values: [val as FilterValue] }
+
+    case "LIKE":
+    case "NOT LIKE":
+      return { sql: `${col} ${opUpper} ?`, values: [val as FilterValue] }
+
+    case "IN":
+      if (Array.isArray(val) && val.length > 0) {
+        const placeholders = val.map(() => "?").join(", ")
+        return { sql: `${col} IN (${placeholders})`, values: val as FilterValue[] }
+      }
+      return { sql: "0=1", values: [] }
+
+    case "NOT IN":
+      if (Array.isArray(val) && val.length > 0) {
+        const placeholders = val.map(() => "?").join(", ")
+        return { sql: `${col} NOT IN (${placeholders})`, values: val as FilterValue[] }
+      }
+      return { sql: "1=1", values: [] }
+
+    case "BETWEEN": {
+      if (Array.isArray(val) && val.length === 2) {
+        return { sql: `${col} BETWEEN ? AND ?`, values: val as FilterValue[] }
+      }
+      throw new Error(`BETWEEN filter expects an array of 2 values`)
+    }
+
+    case "IS":
+      if (val === "set") {
+        return { sql: `${col} IS NOT NULL AND ${col} != ''`, values: [] }
+      }
+      if (val === "not set") {
+        return { sql: `(${col} IS NULL OR ${col} = '')`, values: [] }
+      }
+      throw new Error(`IS filter expects "set" or "not set"`)
+
+    default:
+      throw new Error(`Unknown filter operator: "${op}"`)
+  }
+}

package/src/database/index.ts

@@ -0,0 +1,30 @@
+/**
+ * Database module — re-exports everything.
+ */
+
+export { FrappeDatabase } from "./database"
+export type { GetAllArgs } from "./database"
+export { parseFilters } from "./filters"
+export type { ParsedFilter } from "./filters"
+export { syncSchema, buildCreateTableSQL, buildAlterTableSQL, tableExists } from "./schema"
+export {
+  QueryBuilder,
+  FnExpr,
+  OnCondition,
+  Paginator,
+  fn,
+  q,
+  createQueryBuilder,
+  emptyState,
+} from "./query-builder"
+export type {
+  BuilderState,
+  ConnectedWhere,
+  WhereNode,
+  OrderByNode,
+  HavingNode,
+  JoinDef,
+  CteDef,
+  UnionDef,
+  Connector,
+} from "./query-builder"