@lark-base-open/base-database-cli 1.3.9 → 1.4.3

package/templates/database-starter-v2/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "base-database-app",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "workspaces": [
+    "page",
+    "server"
+  ],
+  "scripts": {
+    "dev": "base-database-cli dev",
+    "check": "base-database-cli check --json",
+    "build:page": "npm run build --workspace page"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}

package/templates/database-starter-v2/page/index.html

@@ -0,0 +1,2 @@
+<!doctype html>
+<html lang="zh"><head><meta charset="UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><title></title></head><body><div id="root"></div><script type="module" src="/src/main.tsx"></script></body></html>

package/templates/database-starter-v2/page/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "page",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "check": "tsc --noEmit",
+    "build": "tsc --noEmit && vite build"
+  },
+  "dependencies": {
+    "@lark-base-open/base-database-app-sdk": "0.1.0",
+    "react": "19.2.7",
+    "react-dom": "19.2.7",
+    "@tanstack/react-query": "5.104.1"
+  },
+  "devDependencies": {
+    "typescript": "7.0.2",
+    "@types/react": "19.2.17",
+    "@types/react-dom": "19.2.3",
+    "@types/node": "26.1.1",
+    "vite": "8.1.4",
+    "@vitejs/plugin-react": "6.0.3"
+  }
+}

package/templates/database-starter-v2/page/src/App.tsx

@@ -0,0 +1,12 @@
+import { DatabaseUserMenu } from '@lark-base-open/base-database-app-sdk/page';
+export default function App() {
+  return (
+    <main>
+      <header>
+        <h1>我的应用</h1>
+        <DatabaseUserMenu audience="enterprise" />
+      </header>
+      <p>根据业务需求实现页面。</p>
+    </main>
+  );
+}

package/templates/database-starter-v2/page/src/generated/README.md

@@ -0,0 +1 @@
+由 CLI contracts generate 和 check 生成契约与输入类型。不要手工维护生成代码。

package/templates/database-starter-v2/page/src/index.css

@@ -0,0 +1 @@
+body { margin: 0; font-family: system-ui, sans-serif; } main { padding: 24px; } header { display: flex; align-items: center; justify-content: space-between; }

package/templates/database-starter-v2/page/src/lib/date-time.ts

@@ -0,0 +1,61 @@
+/** 将时间点投影到显式指定的业务时区，不使用浏览器或服务器默认时区。 */
+function zonedParts(epochMs: number, timeZone: string) {
+  if (
+    !Number.isFinite(epochMs) ||
+    !Number.isFinite(new Date(epochMs).getTime())
+  ) {
+    throw new RangeError('Expected a valid Unix timestamp in milliseconds');
+  }
+  if (!timeZone || timeZone.trim() !== timeZone) {
+    throw new RangeError('An explicit business time zone is required');
+  }
+  const formatter = new Intl.DateTimeFormat('en-US', {
+    timeZone,
+    calendar: 'gregory',
+    numberingSystem: 'latn',
+    era: 'short',
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+    hourCycle: 'h23',
+  });
+  const parts = formatter.formatToParts(new Date(epochMs));
+  const get = (type: Intl.DateTimeFormatPartTypes) =>
+    parts.find((part) => part.type === type)!.value;
+  if (get('era') !== 'AD' || Number(get('year')) > 9999) {
+    throw new RangeError('Expected a calendar year between 0001 and 9999');
+  }
+  return {
+    date: `${get('year').padStart(4, '0')}-${get('month')}-${get('day')}`,
+    time: `${get('hour')}:${get('minute')}:${get('second')}`,
+  };
+}
+
+/** TIMESTAMP → date input；空值由表单显式处理，不转换成今天。 */
+export function formatDateInput(epochMs: number, timeZone: string): string {
+  return zonedParts(epochMs, timeZone).date;
+}
+
+/** 时间点 → 指定时区的无偏移文本；写入方必须使用同一时区解析。 */
+export function formatBaseDateTime(epochMs: number, timeZone: string): string {
+  const { date, time } = zonedParts(epochMs, timeZone);
+  return `${date} ${time}`;
+}
+
+/** 日历日期 → Base 日期字段文本；不经 Date 解析或时区偏移。 */
+export function dateInputToBaseDateTime(value: string): string {
+  const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+  if (!match) throw new RangeError('Expected a calendar date: YYYY-MM-DD');
+  const year = Number(match[1]);
+  const month = Number(match[2]);
+  const day = Number(match[3]);
+  const leap = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+  const days = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+  if (year < 1 || month < 1 || month > 12 || day < 1 || day > days[month - 1]) {
+    throw new RangeError('Invalid calendar date');
+  }
+  return `${value} 00:00:00`;
+}

package/templates/database-starter-v2/page/src/main.tsx

@@ -0,0 +1,6 @@
+import { startBaseApp } from '@lark-base-open/base-database-app-sdk/page';
+import options from '../../base-app.config';
+import '@lark-base-open/base-database-app-sdk/page/styles.css';
+import './index.css';
+
+startBaseApp(options);

package/templates/database-starter-v2/page/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "types": [
+      "vite/client"
+    ]
+  },
+  "include": [
+    "src",
+    "../base-app.config.ts",
+    "vite.config.ts"
+  ]
+}

package/templates/database-starter-v2/page/vite.config.ts

@@ -0,0 +1,3 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+export default defineConfig({ base: './', plugins: [react()] });

package/templates/database-starter-v2/prettierignore

@@ -0,0 +1,3 @@
+node_modules
+dist
+.base-database-cli

package/templates/database-starter-v2/server/functions/README.md

@@ -0,0 +1 @@
+每个 Function 使用独立目录，包含 index.ts、contract.ts 和 meta.json。源码为 ESM，由 check 调用内置构建器生成 CJS。

package/templates/database-starter-v2/server/functions/hello/contract.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export const input = z.object({
+  name: z.string().describe('要问候的用户姓名，用于生成个性化问候语'),
+});
+export const output = z.object({ greeting: z.string() });

package/templates/database-starter-v2/server/functions/hello/index.ts

@@ -0,0 +1,7 @@
+import { defineFunction } from '@lark-base-open/base-database-app-sdk/server';
+import { input, output } from './contract.js';
+export default defineFunction({
+  input,
+  output,
+  handler: async (params) => ({ greeting: `你好，${params.name}` }),
+});

package/templates/database-starter-v2/server/functions/hello/meta.json

@@ -0,0 +1 @@
+{"name":"问候示例","description":"接收 name 字符串并返回 greeting 问候文本，用于验证页面调用和服务端契约；不读取或修改任何 Base 记录。"}

package/templates/database-starter-v2/server/generated/runtime-profile.ts

@@ -0,0 +1,5 @@
+// CLI-generated non-credential binding.
+export const runtimeProfile = {
+  platformEnv: 'online',
+  brand: 'feishu',
+} as const;

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

@@ -0,0 +1,17 @@
+{
+  "name": "server",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@lark-base-open/base-database-app-sdk": "0.1.0",
+    "zod": "4.6.5"
+  },
+  "devDependencies": {
+    "typescript": "7.0.2",
+    "@types/node": "26.1.1"
+  }
+}

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

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true
+  },
+  "include": [
+    "functions",
+    "generated"
+  ]
+}