@lark-base-open/base-database-cli 1.0.0

package/templates/database-starter/server-functions/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "server-functions",
+  "private": true,
+  "version": "0.0.0",
+  "type": "commonjs",
+  "scripts": {
+    "build": "node scripts/run-tsc.mjs build",
+    "check": "node scripts/run-tsc.mjs check",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "oxlint . --deny-warnings",
+    "quality": "npm run format:check && npm run lint && npm run check && npm run test && npm run build",
+    "test": "vitest run --dir functions --passWithNoTests"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.30",
+    "oxlint": "^1.42.0",
+    "prettier": "^3.7.4",
+    "typescript": "~5.8.3",
+    "vitest": "^4.1.0"
+  }
+}

package/templates/database-starter/server-functions/scripts/run-tsc.mjs

@@ -0,0 +1,50 @@
+import { readdirSync, rmSync } from 'node:fs'
+import { join } from 'node:path'
+import { spawnSync } from 'node:child_process'
+
+const mode = process.argv[2]
+if (mode !== 'build' && mode !== 'check') {
+  throw new Error('usage: node scripts/run-tsc.mjs <build|check>')
+}
+
+if (mode === 'build') {
+  rmSync('dist', { recursive: true, force: true })
+}
+
+if (!hasTypeScriptSource('functions')) {
+  console.log(
+    'No server Function TypeScript sources; skipping TypeScript compilation.',
+  )
+  process.exit(0)
+}
+
+const executable = process.platform === 'win32' ? 'tsc.cmd' : 'tsc'
+const args = ['-p', 'tsconfig.json']
+if (mode === 'check') {
+  args.push('--noEmit')
+}
+
+const result = spawnSync(executable, args, { stdio: 'inherit' })
+if (result.error) {
+  throw result.error
+}
+process.exit(result.status ?? 1)
+
+function hasTypeScriptSource(directory) {
+  let entries
+  try {
+    entries = readdirSync(directory, { withFileTypes: true })
+  } catch (error) {
+    if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+      return false
+    }
+    throw error
+  }
+
+  return entries.some((entry) => {
+    const path = join(directory, entry.name)
+    return entry.isDirectory()
+      ? hasTypeScriptSource(path)
+      : entry.isFile() && entry.name.endsWith('.ts')
+  })
+}

package/templates/database-starter/server-functions/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "module": "CommonJS",
+    "moduleResolution": "Node",
+    "rootDir": ".",
+    "outDir": "dist",
+    "strict": true,
+    "noImplicitAny": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "forceConsistentCasingInFileNames": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["functions/**/*.ts"],
+  "exclude": ["dist", "node_modules"]
+}

package/templates/database-starter/sql/README.md

@@ -0,0 +1,8 @@
+# SQL Functions
+
+每个 SQL Function 放在 `sql/<functionId>/` 中：
+
+- `main.sql`：使用 PostgreSQL 方言编写查询，参数按 `$1`、`$2` 顺序引用。
+- `meta.json`：声明 `name`、`description` 和参数契约；没有参数时可省略 `meta` 或 `meta.params`。
+
+SQL 是应用读取 Base 的一等路径；写入使用 `server-functions/functions/`。完整参数、返回结构、Catalog 和方言以 `lark-base-database` Skill 的 `sql-function.md` 为准。