@lark-base-open/base-database-cli 1.1.1 → 1.3.8

package/dist/ai-functions.js

@@ -0,0 +1,436 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync, } from 'node:fs';
+import { basename, dirname, join, resolve } from 'node:path';
+import { readConfig } from './config.js';
+import { assertProjectRuntimeProfile, ONLINE_RUNTIME_PROFILE, } from './environment.js';
+import { LarkCliError } from './lark-cli-error.js';
+import { responseData, runLarkCli } from './lark-cli.js';
+// 服务端对 AI Function 管理接口（list/get/upsert/delete/validate/update/usage）做用户级 feature gate，
+// 未开通时返回 800004011 "ai function feature is not enabled"。这不是 scope 缺失，重新登录无法解决；
+// 这里把它翻译成可执行的降级路径，避免 Agent 把它当作权限错误循环授权。
+export const AI_FUNCTION_FEATURE_NOT_ENABLED_CODE = 800004011;
+export const AI_FUNCTION_FEATURE_NOT_ENABLED_MESSAGE = 'AI Function management is not enabled for the current user (800004011). This is a feature gate, not a missing scope, so `auth login` does not help. Publish without AI Functions via `deploy --skip-ai-functions` (or remove ai/) and report the AI Function part as blocked.';
+export function isAIFunctionFeatureNotEnabled(error) {
+    return (error instanceof LarkCliError &&
+        Number(error.details.code) === AI_FUNCTION_FEATURE_NOT_ENABLED_CODE);
+}
+function aiFunctionAccessError(error) {
+    if (error instanceof LarkCliError &&
+        Number(error.details.code) === AI_FUNCTION_FEATURE_NOT_ENABLED_CODE) {
+        return new LarkCliError({
+            ...error.details,
+            message: AI_FUNCTION_FEATURE_NOT_ENABLED_MESSAGE,
+        });
+    }
+    return error;
+}
+function runAIFunctionApi(args, env, cwd) {
+    try {
+        return runLarkCli(args, env, cwd);
+    }
+    catch (error) {
+        throw aiFunctionAccessError(error);
+    }
+}
+// AI Function 是「功能清单」里的一类声明式资源（function_type=4）：model/System Prompt/能力配置都在
+// ai/<functionKey>/meta.json 里维护，随 deploy 走 OpenAPI 全量覆盖同步。不进 site.zip（不是部署代码，是配置）。
+const FUNCTION_ID_PATTERN = /^[A-Za-z0-9_-]+$/;
+const MAX_AI_FUNCTIONS = 200;
+const AI_FUNCTIONS_DIR = 'ai';
+const CAPABILITY_TYPES = new Set(['text', 'vision', 'image', 'video']);
+function stripPlatformManagedFields(config) {
+    const normalized = { ...config };
+    delete normalized.limits;
+    const text = config.text;
+    if (text && typeof text === 'object' && !Array.isArray(text)) {
+        const rest = { ...text };
+        delete rest.max_tokens;
+        normalized.text = rest;
+    }
+    return normalized;
+}
+function aiFunctionsRoot(workspace) {
+    return join(resolve(workspace), AI_FUNCTIONS_DIR);
+}
+function readAIFunctionMeta(path) {
+    const functionKey = basename(dirname(path));
+    if (functionKey.length < 1 ||
+        functionKey.length > 64 ||
+        !FUNCTION_ID_PATTERN.test(functionKey)) {
+        throw new Error(`Invalid AI Function key: ${functionKey}`);
+    }
+    const manifest = JSON.parse(readFileSync(path, 'utf8'));
+    if (typeof manifest.name !== 'string' || manifest.name === '') {
+        throw new Error(`AI Function name must be a non-empty string: ${path}`);
+    }
+    if (manifest.description !== undefined &&
+        typeof manifest.description !== 'string') {
+        throw new Error(`AI Function description must be a string: ${path}`);
+    }
+    if (!manifest.config || typeof manifest.config !== 'object') {
+        throw new Error(`AI Function config must be an object: ${path}`);
+    }
+    const config = stripPlatformManagedFields(manifest.config);
+    if (typeof config.capability_type !== 'string' ||
+        !CAPABILITY_TYPES.has(config.capability_type)) {
+        throw new Error(`AI Function capability_type must be one of text|vision|image|video: ${path}`);
+    }
+    return {
+        configJson: JSON.stringify(config),
+        description: manifest.description ?? '',
+        functionKey,
+        name: manifest.name,
+    };
+}
+// collectLocalAIFunctions 读取 ai/<key>/meta.json 全集（本地声明），供 deploy 全量覆盖同步与 sync 命令共用。
+export function collectLocalAIFunctions(workspace) {
+    const root = aiFunctionsRoot(workspace);
+    if (!existsSync(root)) {
+        return [];
+    }
+    const items = [];
+    const seen = new Set();
+    for (const entry of readdirSync(root, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const path = join(root, entry.name, 'meta.json');
+        if (!existsSync(path) || !statSync(path).isFile())
+            continue;
+        const item = readAIFunctionMeta(path);
+        if (seen.has(item.functionKey)) {
+            throw new Error(`Duplicate AI Function key: ${item.functionKey}`);
+        }
+        seen.add(item.functionKey);
+        items.push(item);
+    }
+    if (items.length > MAX_AI_FUNCTIONS) {
+        throw new Error(`AI Functions cannot exceed ${MAX_AI_FUNCTIONS}`);
+    }
+    return items;
+}
+// buildUpdatePayload 把本地全集转成 OpenAPIUpsertAIFunctions 的全量覆盖请求体。
+function buildUpdatePayload(items) {
+    return JSON.stringify({
+        ai_functions: items.map((item) => ({
+            config_json: item.configJson,
+            description: item.description,
+            function_key: item.functionKey,
+            name: item.name,
+        })),
+    });
+}
+// assertAIFunctionResultsOk 严格校验逐条结果：任一条 code != 0 立即抛错。
+// 后端整批拒绝时会同时返回顶层失败和 data.results；调用方必须保留逐条诊断，
+// 并阻止 deploy 继续上传产物或发布失败快照。
+function assertAIFunctionResultsOk(data) {
+    const results = data.results ?? data.Results;
+    if (results === undefined || results === null) {
+        return;
+    }
+    if (!Array.isArray(results)) {
+        throw new Error('AI Function sync returned an invalid results payload');
+    }
+    const failures = [];
+    for (const entry of results) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const record = entry;
+        const code = record.code ?? record.Code;
+        if (typeof code === 'number' && code !== 0) {
+            const key = record.function_key ?? record.functionKey ?? record.FunctionKey;
+            const message = record.msg ?? record.Msg ?? record.message ?? '';
+            failures.push(`${String(key ?? '(unknown)')}: code=${code}${message ? ` ${String(message)}` : ''}`);
+        }
+    }
+    if (failures.length > 0) {
+        throw new Error(`AI Function sync failed for ${failures.length} function(s): ${failures.join('; ')}`);
+    }
+}
+// syncAIFunctionsFullCover 走 OpenAPI 全量覆盖同步（对齐 update_functions 心智）：传本地全集，服务端 diff 出
+// add/update/delete + 逐条校验码。deploy 与 `ai sync` 命令共用。空集合仍会清空远端 AI Function（全量覆盖语义）。
+// 任一条 results[].code != 0 立即抛错，避免 deploy 在 AI 同步失败后继续 artifact/publish。
+export function syncAIFunctionsFullCover(appToken, items, env, cwd) {
+    const token = encodeURIComponent(appToken);
+    let response;
+    try {
+        response = runLarkCli([
+            'api',
+            'POST',
+            `/open-apis/base/v3/sites/${token}/ai_functions/update`,
+            '--data',
+            buildUpdatePayload(items),
+        ], env, cwd);
+    }
+    catch (error) {
+        // 顶层失败不能覆盖服务端保留的逐条诊断。
+        if (error instanceof LarkCliError && error.details.results) {
+            assertAIFunctionResultsOk({ results: error.details.results });
+        }
+        throw aiFunctionAccessError(error);
+    }
+    const data = responseData(response);
+    assertAIFunctionResultsOk(data);
+    return data;
+}
+function remoteAIFunctionKeys(appToken, env, cwd) {
+    const data = responseData(runAIFunctionApi([
+        'api',
+        'GET',
+        `/open-apis/base/v3/sites/${encodeURIComponent(appToken)}/ai_functions`,
+    ], env, cwd));
+    const list = Array.isArray(data.functions) ? data.functions : [];
+    return list.flatMap((entry) => {
+        if (!entry || typeof entry !== 'object')
+            return [];
+        const record = entry;
+        const key = record.function_key ?? record.functionKey;
+        return typeof key === 'string' && key !== '' ? [key] : [];
+    });
+}
+// restoreRemoteAIFunctions 把远端 AI Function 草稿配置写回 <workspace>/ai/<key>/meta.json。
+// pull 调用它，让"修改已有应用前先恢复远端 AI Function"由 CLI 完成，而不是交给 Agent 判断。
+// 当前用户未开通 AI Function（800004011）时不算失败：本地不落 ai/，后续 deploy 自动跳过同步，远端保持原样。
+export function restoreRemoteAIFunctions(appToken, workspace, env, cwd) {
+    let keys;
+    try {
+        keys = remoteAIFunctionKeys(appToken, env, cwd);
+    }
+    catch (error) {
+        if (isAIFunctionFeatureNotEnabled(error))
+            return { status: 'not_enabled' };
+        throw error;
+    }
+    const root = aiFunctionsRoot(workspace);
+    for (const functionKey of keys) {
+        if (functionKey.length > 64 || !FUNCTION_ID_PATTERN.test(functionKey)) {
+            throw new Error(`Remote AI Function key is not restorable: ${functionKey}`);
+        }
+        const detail = responseData(runAIFunctionApi([
+            'api',
+            'GET',
+            `/open-apis/base/v3/sites/${encodeURIComponent(appToken)}/ai_functions/${encodeURIComponent(functionKey)}`,
+        ], env, cwd));
+        const view = (detail.function ?? detail);
+        const configJson = view.config_json ?? view.configJson;
+        if (typeof view.name !== 'string' || typeof configJson !== 'string') {
+            throw new Error(`Remote AI Function ${functionKey} did not return name and config_json`);
+        }
+        let config;
+        try {
+            config = JSON.parse(configJson);
+        }
+        catch {
+            throw new Error(`Remote AI Function ${functionKey} config_json is not valid JSON`);
+        }
+        const directory = join(root, functionKey);
+        mkdirSync(directory, { recursive: true });
+        writeFileSync(join(directory, 'meta.json'), `${JSON.stringify({
+            name: view.name,
+            ...(typeof view.description === 'string' && view.description !== ''
+                ? { description: view.description }
+                : {}),
+            config,
+        }, null, 2)}\n`);
+    }
+    return { status: 'restored', functionKeys: keys };
+}
+// assertNoRemoteAIFunctionLoss 在全量覆盖前核对：远端已有的 key 必须都在本地全集中，否则拒绝，
+// 防止本地不完整（未 pull、他人新增）时把远端 AI Function 静默删除。删除只能经显式 `ai-functions sync`。
+// 未开通 AI Function 的用户 list 会被拦（800004011）；此时直接放行，随后的同步会返回带降级说明的同一错误。
+export function assertNoRemoteAIFunctionLoss(appToken, items, env, cwd) {
+    let remote;
+    try {
+        remote = remoteAIFunctionKeys(appToken, env, cwd);
+    }
+    catch (error) {
+        if (isAIFunctionFeatureNotEnabled(error))
+            return;
+        throw error;
+    }
+    const local = new Set(items.map((item) => item.functionKey));
+    const missing = remote.filter((key) => !local.has(key));
+    if (missing.length > 0) {
+        throw new Error(`deploy would delete remote AI Functions missing from local ai/: ${missing.join(', ')}. Restore them with \`pull\` into a fresh directory or \`ai-functions pull <functionKey>\`; deleting requires explicit user authorization and \`ai-functions sync\`.`);
+    }
+}
+// deploy 只在本地声明了 AI Function 时同步。空集合不代表用户显式要求清空远端资源，
+// 因而不能为普通 Page/Database Function/FaaS 发布额外请求尚未开放的 AI Function 接口。
+// 显式 `ai sync` 仍直接调用 syncAIFunctionsFullCover，保留空集合全量清空语义。
+export function syncAIFunctionsForDeploy(appToken, items, env, cwd) {
+    if (items.length === 0) {
+        return { skipped: true, reason: 'no_local_ai_functions' };
+    }
+    assertNoRemoteAIFunctionLoss(appToken, items, env, cwd);
+    return syncAIFunctionsFullCover(appToken, items, env, cwd);
+}
+async function resolveEnv(workspace, runtimeProfile) {
+    const config = readConfig(workspace);
+    assertProjectRuntimeProfile(config.runtimeProfile, runtimeProfile);
+    const env = await runtimeProfile.commandEnvironment();
+    return { config, env };
+}
+// listAIFunctions 列出 Site 下 AI Function。
+export async function listAIFunctions(options) {
+    const workspace = resolve(options.directory);
+    const runtimeProfile = options.runtimeProfile ?? ONLINE_RUNTIME_PROFILE;
+    const { config, env } = await resolveEnv(workspace, runtimeProfile);
+    const response = runAIFunctionApi([
+        'api',
+        'GET',
+        `/open-apis/base/v3/sites/${encodeURIComponent(config.appToken)}/ai_functions`,
+    ], env, workspace);
+    return responseData(response);
+}
+// getAIFunction 读取单个 AI Function 配置（用于本地编辑 / diff）。
+export async function getAIFunction(functionKey, options) {
+    const workspace = resolve(options.directory);
+    const runtimeProfile = options.runtimeProfile ?? ONLINE_RUNTIME_PROFILE;
+    const { config, env } = await resolveEnv(workspace, runtimeProfile);
+    const response = runAIFunctionApi([
+        'api',
+        'GET',
+        `/open-apis/base/v3/sites/${encodeURIComponent(config.appToken)}/ai_functions/${encodeURIComponent(functionKey)}`,
+    ], env, workspace);
+    return responseData(response);
+}
+// syncAIFunctions 把本地 ai/ 全集全量覆盖同步到 Site。
+export async function syncAIFunctions(options) {
+    const workspace = resolve(options.directory);
+    const runtimeProfile = options.runtimeProfile ?? ONLINE_RUNTIME_PROFILE;
+    const { config, env } = await resolveEnv(workspace, runtimeProfile);
+    const items = collectLocalAIFunctions(workspace);
+    const data = syncAIFunctionsFullCover(config.appToken, items, env, workspace);
+    return {
+        ok: true,
+        appToken: config.appToken,
+        count: items.length,
+        results: data,
+    };
+}
+// validateAIFunction 静态校验单个本地 AI Function（保存/发布前，按能力分支），不落库。
+export async function validateAIFunction(functionKey, options) {
+    const workspace = resolve(options.directory);
+    const runtimeProfile = options.runtimeProfile ?? ONLINE_RUNTIME_PROFILE;
+    const { config, env } = await resolveEnv(workspace, runtimeProfile);
+    const items = collectLocalAIFunctions(workspace);
+    const target = items.find((item) => item.functionKey === functionKey);
+    if (!target) {
+        throw new Error(`AI Function not found in ${AI_FUNCTIONS_DIR}/: ${functionKey}`);
+    }
+    const response = runAIFunctionApi([
+        'api',
+        'POST',
+        `/open-apis/base/v3/sites/${encodeURIComponent(config.appToken)}/ai_functions/validate`,
+        '--data',
+        JSON.stringify({
+            function: {
+                config_json: target.configJson,
+                description: target.description,
+                function_key: target.functionKey,
+                name: target.name,
+            },
+        }),
+    ], env, workspace);
+    const data = responseData(response);
+    if (data.is_success !== true) {
+        const message = String(data.err_msg ?? 'unknown validation error');
+        throw new Error(`AI Function validation failed: ${message}`);
+    }
+    return data;
+}
+function readCapabilityType(data) {
+    const value = data.function;
+    if (!value || typeof value !== 'object') {
+        throw new Error('AI Function detail does not contain function');
+    }
+    const view = value;
+    const raw = view.config_json;
+    if (typeof raw !== 'string' || raw === '') {
+        throw new Error('AI Function detail is missing config_json');
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error('AI Function detail config_json is not valid JSON');
+    }
+    if (!parsed || typeof parsed !== 'object') {
+        throw new Error('AI Function detail config_json is not an object');
+    }
+    const capability = parsed.capability_type;
+    if (typeof capability !== 'string' || !CAPABILITY_TYPES.has(capability)) {
+        throw new Error('AI Function detail contains invalid capability_type');
+    }
+    return capability;
+}
+// debugAIFunction 调试 text/vision 时走 unary 聚合；image/video 走统一 tasks 提交接口。
+export async function debugAIFunction(functionKey, options) {
+    const workspace = resolve(options.directory);
+    const runtimeProfile = options.runtimeProfile ?? ONLINE_RUNTIME_PROFILE;
+    const { config, env } = await resolveEnv(workspace, runtimeProfile);
+    const token = encodeURIComponent(config.appToken);
+    const key = encodeURIComponent(functionKey);
+    const detail = runAIFunctionApi(['api', 'GET', `/open-apis/base/v3/sites/${token}/ai_functions/${key}`], env, workspace);
+    const capabilityType = readCapabilityType(responseData(detail));
+    const body = JSON.stringify({
+        input: options.input ?? {},
+        messages: options.messages ?? [],
+        variables: options.variables ?? {},
+    });
+    const response = runAIFunctionApi([
+        'api',
+        'POST',
+        `/open-apis/base/v3/sites/${token}/ai_functions/${key}/${capabilityType === 'image' || capabilityType === 'video' ? 'tasks' : 'invoke'}`,
+        '--params',
+        JSON.stringify({ env: options.env }),
+        '--data',
+        body,
+    ], env, workspace);
+    return responseData(response);
+}
+// getAIFunctionTask 查询 OpenAPI image/video 媒体任务状态。
+export async function getAIFunctionTask(functionKey, taskId, options) {
+    const workspace = resolve(options.directory);
+    const runtimeProfile = options.runtimeProfile ?? ONLINE_RUNTIME_PROFILE;
+    const { config, env } = await resolveEnv(workspace, runtimeProfile);
+    const token = encodeURIComponent(config.appToken);
+    const key = encodeURIComponent(functionKey);
+    const task = encodeURIComponent(taskId);
+    const response = runAIFunctionApi([
+        'api',
+        'GET',
+        `/open-apis/base/v3/sites/${token}/ai_functions/${key}/tasks/${task}`,
+        '--params',
+        JSON.stringify({ env: options.env }),
+    ], env, workspace);
+    return responseData(response);
+}
+// getAIFunctionUsage 读天表聚合的 Owner 可见用量（总量 + 按日期/function/能力分布），走 OpenAPI usage/summary。
+export async function getAIFunctionUsage(options) {
+    const workspace = resolve(options.directory);
+    const runtimeProfile = options.runtimeProfile ?? ONLINE_RUNTIME_PROFILE;
+    const { config, env } = await resolveEnv(workspace, runtimeProfile);
+    const token = encodeURIComponent(config.appToken);
+    const params = {};
+    if (options.from !== undefined)
+        params.from = options.from;
+    if (options.to !== undefined)
+        params.to = options.to;
+    if (options.env)
+        params.env = options.env;
+    if (options.functionKey)
+        params.function_key = options.functionKey;
+    if (options.model)
+        params.model = options.model;
+    if (options.capabilityType)
+        params.capability_type = options.capabilityType;
+    const response = runAIFunctionApi([
+        'api',
+        'GET',
+        `/open-apis/base/v3/sites/${token}/ai_functions/usage/summary`,
+        '--params',
+        JSON.stringify(params),
+    ], env, workspace);
+    return responseData(response);
+}
+//# sourceMappingURL=ai-functions.js.map

package/dist/ai-functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-functions.js","sourceRoot":"","sources":["../src/ai-functions.ts"],"names":[],"mappings":"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"}

package/dist/archive.d.ts

@@ -1,3 +1,15 @@
+interface MetaItem {
+    functionId: string;
+    functionType: 1 | 2 | 5;
+    name: string;
+    description: string;
+    sourceCode: string;
+}
+export interface DatabaseFunctionInputContract {
+    functionId: string;
+    functionType: MetaItem['functionType'];
+    inputSchema: Record<string, unknown>;
+}
 export interface SQLValidationArtifact {
     functionId: string;
     path: string;
@@ -6,6 +18,14 @@ export interface DatabaseMetadataArtifacts {
     metaList: string;
     sqlValidation: SQLValidationArtifact[];
 }
+/** Read the validated Function input contracts used by Page type generation. */
+export declare function readDatabaseFunctionInputContracts(workspace: string): DatabaseFunctionInputContract[];
+/** Validate Function contracts without changing metadata or publish artifacts. */
+export declare function validateDatabaseMetadata(workspace: string): {
+    sql: number;
+    faas: number;
+    mutation: number;
+};
 export declare function prepareDatabaseMetadata(workspace: string): DatabaseMetadataArtifacts;
 export declare function archiveDatabase(workspace: string, metadata?: DatabaseMetadataArtifacts): Promise<{
     archive: string;
@@ -13,4 +33,5 @@ export declare function archiveDatabase(workspace: string, metadata?: DatabaseMe
     sqlValidation: SQLValidationArtifact[];
     displayArchive: string;
 }>;
+export {};
 //# sourceMappingURL=archive.d.ts.map

package/dist/archive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../src/archive.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,qBAAqB,EAAE,CAAC;CACxC;AAmKD,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAChB,yBAAyB,CAK3B;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,yBAA8D;;;;;GAazE"}
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../src/archive.ts"],"names":[],"mappings":"AA4BA,UAAU,QAAQ;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,qBAAqB,EAAE,CAAC;CACxC;AAqID,gFAAgF;AAChF,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,MAAM,GAChB,6BAA6B,EAAE,CAcjC;AAED,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM;IAGtD,GAAG;IACH,IAAI;IACJ,QAAQ;EAEX;AAmFD,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAChB,yBAAyB,CAK3B;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,yBAA8D;;;;;GAazE"}

package/dist/archive.js

@@ -1,7 +1,9 @@
-import { createWriteStream, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync, } from 'node:fs';
+import { createWriteStream, existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync, } from 'node:fs';
 import { basename, dirname, join, relative, resolve } from 'node:path';
 import { ZipArchive } from 'archiver';
+import { readMutationMetaItem } from './mutation.js';
 import { deriveSQLInputSchema, normalizeFunctionInputSchema, } from './function-schema.js';
+import { DATABASE_FUNCTIONS_DIRECTORY, requireDatabaseFunctionsDirectory, } from './project-layout.js';
 const FUNCTION_ID_PATTERN = /^[A-Za-z0-9_-]+$/;
 const MAX_FUNCTIONS = 200;
 function findMetaFiles(directory) {
@@ -38,20 +40,20 @@ function readMetaItem(type, path) {
     };
     if (type === 'sql') {
         if (manifest.inputSchema !== undefined) {
-            throw new Error(`SQL inputSchema is derived from meta.params and must not be set: ${path}`);
+            throw new Error(`Database Function inputSchema is derived from meta.params and must not be set: ${path}`);
         }
         let meta = manifest.meta;
         if (meta === undefined) {
             meta = { params: [] };
         }
         else if (!meta || typeof meta !== 'object' || Array.isArray(meta)) {
-            throw new Error(`SQL meta must be an object: ${path}`);
+            throw new Error(`Database Function meta must be an object: ${path}`);
         }
         else if (!Object.hasOwn(meta, 'params')) {
             meta = { ...meta, params: [] };
         }
         else if (!Array.isArray(meta.params)) {
-            throw new Error(`SQL meta.params must be an array: ${path}`);
+            throw new Error(`Database Function meta.params must be an array: ${path}`);
         }
         const sql = readFileSync(join(dirname(path), 'main.sql'), 'utf8');
         item.sourceCode = JSON.stringify({
@@ -70,13 +72,28 @@ function readMetaItem(type, path) {
     }
     return item;
 }
-function writeMetadata(workspace, output) {
+function readMetadata(workspace) {
+    const databaseFunctions = requireDatabaseFunctionsDirectory(workspace);
+    const mutationRoot = join(workspace, 'mutations');
+    if (existsSync(mutationRoot)) {
+        for (const entry of readdirSync(mutationRoot, { withFileTypes: true })) {
+            if (entry.isDirectory() &&
+                (!existsSync(join(mutationRoot, entry.name, 'meta.json')) ||
+                    !existsSync(join(mutationRoot, entry.name, 'spec.json')))) {
+                throw new Error(`Mutation requires meta.json and spec.json: ${entry.name}`);
+            }
+        }
+    }
     const files = [
+        ...findMetaFiles(mutationRoot).map((path) => ({
+            type: 'mutation',
+            path,
+        })),
         ...findMetaFiles(join(workspace, 'server-functions/functions')).map((path) => ({
             type: 'faas',
             path,
         })),
-        ...findMetaFiles(join(workspace, 'sql')).map((path) => ({
+        ...findMetaFiles(join(workspace, databaseFunctions)).map((path) => ({
             type: 'sql',
             path,
         })),
@@ -86,13 +103,39 @@ function writeMetadata(workspace, output) {
     }
     const ids = new Set();
     const items = files.map(({ type, path }) => {
-        const item = readMetaItem(type, path);
+        const item = type === 'mutation'
+            ? readMutationMetaItem(path, workspace)
+            : readMetaItem(type, path);
         if (ids.has(item.functionId)) {
             throw new Error(`Duplicate Function ID: ${item.functionId}`);
         }
         ids.add(item.functionId);
         return item;
     });
+    return items;
+}
+/** Read the validated Function input contracts used by Page type generation. */
+export function readDatabaseFunctionInputContracts(workspace) {
+    return readMetadata(databaseProject(workspace)).map((item) => ({
+        functionId: item.functionId,
+        functionType: item.functionType,
+        // Mutation uses spec.params rather than discovery inputSchema; keep its local call input as an array.
+        inputSchema: item.functionType === 5
+            ? { type: 'array' }
+            : JSON.parse(item.sourceCode).inputSchema,
+    }));
+}
+/** Validate Function contracts without changing metadata or publish artifacts. */
+export function validateDatabaseMetadata(workspace) {
+    const items = readMetadata(databaseProject(workspace));
+    return {
+        sql: items.filter((item) => item.functionType === 1).length,
+        faas: items.filter((item) => item.functionType === 2).length,
+        mutation: items.filter((item) => item.functionType === 5).length,
+    };
+}
+function writeMetadata(workspace, output) {
+    const items = readMetadata(workspace);
     const validations = join(output, 'sql-validation');
     mkdirSync(output, { recursive: true });
     rmSync(validations, { recursive: true, force: true });
@@ -109,6 +152,11 @@ function writeMetadata(workspace, output) {
     return { metaList, sqlValidation };
 }
 function createArchive(workspace, destination) {
+    const readme = join(workspace, 'README.md');
+    const readmeMetadata = lstatSync(readme, { throwIfNoEntry: false });
+    if (readmeMetadata && !readmeMetadata.isFile()) {
+        return Promise.reject(new Error('Project README.md must be a regular file'));
+    }
     return new Promise((resolvePromise, reject) => {
         const output = createWriteStream(destination);
         const zip = new ZipArchive({ zlib: { level: 9 } });
@@ -117,7 +165,7 @@ function createArchive(workspace, destination) {
         zip.once('warning', reject);
         zip.once('error', reject);
         zip.pipe(output);
-        zip.glob('{page,server-functions,sql}/**/*', {
+        const globOptions = {
             cwd: workspace,
             dot: true,
             ignore: [
@@ -126,18 +174,29 @@ function createArchive(workspace, destination) {
                 '**/.DS_Store',
                 '**/.env',
                 '**/.env.*',
+                '**/.npmrc',
+                '**/.yarnrc',
+                '**/.yarnrc.yml',
+                '**/.pnpmrc',
             ],
-        });
+        };
+        zip.glob('{page,server-functions,mutations}/**/*', globOptions);
+        const databaseFunctions = requireDatabaseFunctionsDirectory(workspace);
+        zip.glob('**/*', { ...globOptions, cwd: join(workspace, databaseFunctions) }, { prefix: DATABASE_FUNCTIONS_DIRECTORY });
+        if (readmeMetadata) {
+            zip.file(readme, { name: 'README.md' });
+        }
         void zip.finalize();
     });
 }
 function databaseProject(workspace) {
     const project = resolve(workspace);
-    for (const directory of ['page', 'server-functions', 'sql']) {
+    for (const directory of ['page', 'server-functions']) {
         if (!existsSync(join(project, directory))) {
             throw new Error(`application source not found: ${join(project, directory)}`);
         }
     }
+    requireDatabaseFunctionsDirectory(project);
     return project;
 }
 export function prepareDatabaseMetadata(workspace) {