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

package/dist/auth.js

@@ -0,0 +1,63 @@
+import { ONLINE_RUNTIME_PROFILE } from './environment.js';
+import { resolveLarkCliExecutable, runLarkCli } from './lark-cli.js';
+import { runCommand } from './process.js';
+function isNotConfigured(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return /"subtype"\s*:\s*"not_configured"/.test(message);
+}
+export function ensureConfiguration(env, runner = runCommand) {
+    const executable = resolveLarkCliExecutable(env);
+    try {
+        runner(executable, ['config', 'show'], { env, capture: true });
+    }
+    catch (error) {
+        if (!isNotConfigured(error))
+            throw error;
+        process.stderr.write('lark-cli is not configured for this environment; starting first-time setup...\n');
+        runner(executable, ['config', 'init', '--new'], { env });
+    }
+}
+export async function login(profile = ONLINE_RUNTIME_PROFILE) {
+    const env = await profile.commandEnvironment();
+    ensureConfiguration(env);
+    runCommand(resolveLarkCliExecutable(env), ['auth', 'login', '--domain', 'base'], { env });
+}
+export async function logout(profile = ONLINE_RUNTIME_PROFILE) {
+    const env = await profile.commandEnvironment();
+    runCommand(resolveLarkCliExecutable(env), ['auth', 'logout'], { env });
+}
+export async function whoami(profile = ONLINE_RUNTIME_PROFILE) {
+    const env = await profile.commandEnvironment();
+    return runLarkCli(['auth', 'status', '--verify'], env);
+}
+export async function doctor(profile = ONLINE_RUNTIME_PROFILE) {
+    const major = Number(process.versions.node.split('.')[0]);
+    if (major < 20)
+        throw new Error('Node.js 20 or newer is required');
+    const env = await profile.commandEnvironment();
+    runCommand(resolveLarkCliExecutable(env), ['config', 'show'], {
+        env,
+        capture: true,
+    });
+    const identity = runLarkCli(['auth', 'status', '--verify'], env);
+    runLarkCli([
+        'api',
+        'GET',
+        '/open-apis/base/v3/sites/list',
+        '--params',
+        '{"pageSize":1}',
+    ], env);
+    const identityData = identity.data;
+    const user = identityData?.identities?.user;
+    return {
+        ok: true,
+        environment: profile.name,
+        node: process.version,
+        user: {
+            status: user?.status,
+            available: user?.available,
+            verified: user?.verified,
+        },
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { ONLINE_RUNTIME_PROFILE } from './environment.js';
+import { createBaseDatabaseProgram, runBaseDatabaseProgram, } from './program.js';
+const packageRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
+const packageJson = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'));
+runBaseDatabaseProgram(createBaseDatabaseProgram({
+    commandName: 'base-database-cli',
+    description: 'Build and deploy database applications on Lark Base',
+    version: packageJson.version,
+    runtimeProfiles: [ONLINE_RUNTIME_PROFILE],
+}));
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACxE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CACjC,CAAC;AAEzB,sBAAsB,CACpB,yBAAyB,CAAC;IACxB,WAAW,EAAE,mBAAmB;IAChC,WAAW,EAAE,qDAAqD;IAClE,OAAO,EAAE,WAAW,CAAC,OAAO;IAC5B,eAAe,EAAE,CAAC,sBAAsB,CAAC;CAC1C,CAAC,CACH,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,5 @@
+import type { BaseDatabaseConfig } from './types.js';
+export declare const CONFIG_FILE_NAME = "base-database.jsonc";
+export declare function readConfig(workspace?: string): BaseDatabaseConfig;
+export declare function writeConfig(workspace: string, config: BaseDatabaseConfig): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAOrD,eAAO,MAAM,gBAAgB,wBAAwB,CAAC;AAEtD,wBAAgB,UAAU,CAAC,SAAS,SAAgB,GAAG,kBAAkB,CA8BxE;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,kBAAkB,GACzB,MAAM,CAUR"}

package/dist/config.js

@@ -0,0 +1,50 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import Ajv2020 from 'ajv/dist/2020.js';
+import { parse, printParseErrorCode } from 'jsonc-parser';
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const schema = JSON.parse(readFileSync(join(packageRoot, 'config-schema.json'), 'utf8'));
+const validate = new Ajv2020({ allErrors: true }).compile(schema);
+export const CONFIG_FILE_NAME = 'base-database.jsonc';
+export function readConfig(workspace = process.cwd()) {
+    const root = resolve(workspace);
+    const configPath = join(root, CONFIG_FILE_NAME);
+    let source;
+    try {
+        source = readFileSync(configPath, 'utf8');
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            throw new Error(`Base Database project not found: expected ${configPath}`);
+        }
+        throw error;
+    }
+    const errors = [];
+    const value = parse(source, errors, { allowTrailingComma: true });
+    if (errors.length > 0) {
+        const detail = errors
+            .map((error) => `${printParseErrorCode(error.error)} at ${error.offset}`)
+            .join(', ');
+        throw new Error(`Invalid ${configPath}: ${detail}`);
+    }
+    if (!validate(value)) {
+        const detail = validate.errors
+            ?.map((error) => `${error.instancePath || '/'} ${error.message}`)
+            .join('; ');
+        throw new Error(`Invalid ${configPath}: ${detail}`);
+    }
+    return value;
+}
+export function writeConfig(workspace, config) {
+    if (!validate(config)) {
+        const detail = validate.errors
+            ?.map((error) => `${error.instancePath || '/'} ${error.message}`)
+            .join('; ');
+        throw new Error(`Cannot write invalid Base Database config: ${detail}`);
+    }
+    const path = join(resolve(workspace), CONFIG_FILE_NAME);
+    writeFileSync(path, `${JSON.stringify(config, null, 2)}\n`);
+    return path;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/database-skill.d.ts

@@ -0,0 +1,22 @@
+import type { RuntimeProfile } from './environment.js';
+export declare function databaseSkillName(token: string, environment: string): string;
+export declare function databaseSkillCommandPrefix(profile: RuntimeProfile): string;
+export declare function renderDatabaseSkill(options: {
+    appToken: string;
+    title: string;
+    profile: RuntimeProfile;
+}): string;
+export declare function installDatabaseSkill(options: {
+    appToken: string;
+    title: string;
+    profile: RuntimeProfile;
+    directory?: string;
+}): {
+    status: "installed" | "updated";
+    name: string;
+    path: string;
+};
+export declare function discoveryArgs(appToken: string, pageSize: number, pageToken?: string): string[];
+export declare function invocationArgs(appToken: string, functionId: string, params: string): string[];
+export declare function runDatabaseSkillRequest(profile: RuntimeProfile, args: string[]): Promise<import("./types.js").CommandResult>;
+//# sourceMappingURL=database-skill.d.ts.map

package/dist/database-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-skill.d.ts","sourceRoot":"","sources":["../src/database-skill.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAQvD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAM5E;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAI1E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;CACzB,GAAG,MAAM,CA0BT;AAoCD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;EAwBA;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,EAAE,CAgBV;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,MAAM,EAAE,CAgBV;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EAAE,+CAGf"}

package/dist/database-skill.js

@@ -0,0 +1,135 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { lstatSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { packageRoot } from './assets.js';
+import { runLarkCli } from './lark-cli.js';
+function validateAppToken(token) {
+    if (!/^[A-Za-z0-9_-]{1,128}$/.test(token))
+        throw new Error('Invalid Application token');
+}
+export function databaseSkillName(token, environment) {
+    validateAppToken(token);
+    return `base-database-${createHash('sha256')
+        .update(JSON.stringify([environment, token]))
+        .digest('hex')
+        .slice(0, 20)}`;
+}
+export function databaseSkillCommandPrefix(profile) {
+    if (!profile.deployCommand.endsWith(' deploy'))
+        throw new Error('Runtime profile has no CLI command prefix');
+    return profile.deployCommand.slice(0, -' deploy'.length);
+}
+export function renderDatabaseSkill(options) {
+    const { appToken, profile } = options;
+    const name = databaseSkillName(appToken, profile.name);
+    if (!/^[a-z][a-z0-9-]*$/.test(profile.name))
+        throw new Error('Invalid runtime profile name');
+    const title = options.title.replace(/\s+/g, ' ').trim().slice(0, 200) || appToken;
+    const values = {
+        skill_name: name,
+        description_json: JSON.stringify(`当用户希望查询或操作“${title}”应用时使用。通过实时 Function 发现和参数 Schema 使用该应用业务能力；不用于修改源码或部署。应用 ${appToken}，环境 ${profile.name}。`),
+        app_token: appToken,
+        environment: profile.name,
+        command_prefix: databaseSkillCommandPrefix(profile),
+        managed_marker: `<!-- base-database-managed-skill:${profile.name}:${appToken} -->`,
+    };
+    return readFileSync(join(packageRoot, 'templates/database-capability/SKILL.md.tmpl'), 'utf8').replace(/\{\{([a-z_]+)\}\}/g, (_, key) => {
+        const value = values[key];
+        if (value === undefined)
+            throw new Error(`Unknown Skill template field: ${key}`);
+        return value;
+    });
+}
+function fileStat(path) {
+    try {
+        return lstatSync(path);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+}
+function assertManagedDirectory(directory, marker) {
+    const directoryStat = fileStat(directory);
+    if (!directoryStat)
+        return false;
+    if (!directoryStat.isDirectory() || directoryStat.isSymbolicLink()) {
+        throw new Error(`Refusing to replace non-directory or symlink: ${directory}`);
+    }
+    const path = join(directory, 'SKILL.md');
+    const existing = fileStat(path);
+    if (!existing) {
+        throw new Error(`Skill directory is not managed by Base Database CLI: ${directory}`);
+    }
+    if (!existing.isFile() ||
+        existing.isSymbolicLink() ||
+        !readFileSync(path, 'utf8').split('\n').includes(marker)) {
+        throw new Error(`Refusing to overwrite an unmanaged Skill: ${path}`);
+    }
+    return true;
+}
+export function installDatabaseSkill(options) {
+    const name = databaseSkillName(options.appToken, options.profile.name);
+    const root = resolve(options.directory ??
+        join(process.env.CODEX_HOME || join(homedir(), '.codex'), 'skills'));
+    const directory = join(root, name);
+    const path = join(directory, 'SKILL.md');
+    const content = renderDatabaseSkill(options);
+    const marker = `<!-- base-database-managed-skill:${options.profile.name}:${options.appToken} -->`;
+    const existing = assertManagedDirectory(directory, marker);
+    mkdirSync(directory, { recursive: true });
+    const temporary = join(directory, `.SKILL-${randomUUID()}.tmp`);
+    try {
+        writeFileSync(temporary, content, { flag: 'wx', mode: 0o600 });
+        renameSync(temporary, path);
+    }
+    finally {
+        if (fileStat(temporary))
+            unlinkSync(temporary);
+    }
+    return {
+        status: existing ? 'updated' : 'installed',
+        name,
+        path,
+    };
+}
+export function discoveryArgs(appToken, pageSize, pageToken) {
+    validateAppToken(appToken);
+    if (!Number.isSafeInteger(pageSize) || pageSize < 1)
+        throw new Error('page-size must be a positive integer');
+    return [
+        'api',
+        'GET',
+        `/open-apis/base/v3/sites/${appToken}/functions`,
+        '--params',
+        JSON.stringify({
+            pageSize,
+            ...(pageToken === undefined ? {} : { pageToken }),
+        }),
+        '--as',
+        'user',
+    ];
+}
+export function invocationArgs(appToken, functionId, params) {
+    validateAppToken(appToken);
+    if (!/^[A-Za-z0-9_-]{1,64}$/.test(functionId))
+        throw new Error('Invalid Function ID');
+    const value = JSON.parse(params);
+    return [
+        'api',
+        'POST',
+        `/open-apis/base/v3/sites/${appToken}/invoke_function/${functionId}`,
+        '--params',
+        '{"env":"prod"}',
+        '--data',
+        JSON.stringify({ params: value }),
+        '--as',
+        'user',
+    ];
+}
+export async function runDatabaseSkillRequest(profile, args) {
+    return runLarkCli(args, await profile.commandEnvironment());
+}
+//# sourceMappingURL=database-skill.js.map

package/dist/database-skill.js.map

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

package/dist/deploy.d.ts

@@ -0,0 +1,28 @@
+import { type RuntimeProfile } from './environment.js';
+import { type WorkspaceNpm } from './npm.js';
+import type { BaseDatabaseConfig } from './types.js';
+interface ResolvedBaseBinding {
+    names: string[];
+    baseToken: string;
+    tableIds: string[];
+}
+export declare function collectBaseBinding(config: BaseDatabaseConfig, warn?: (message: string) => void): ResolvedBaseBinding | undefined;
+export declare function deploymentStatus(directory: string, id: string, wait: boolean, runtimeProfile?: RuntimeProfile): Promise<{
+    ok: true;
+    environment: string;
+    appToken: string;
+    publishId: string;
+    status: unknown;
+    baseAppUrl?: string | undefined;
+}>;
+export interface DeployOptions {
+    directory: string;
+    install: boolean;
+    forceInstall?: boolean;
+    production: boolean;
+    yes: boolean;
+    runtimeProfile?: RuntimeProfile;
+}
+export declare function deployProject(options: DeployOptions, suppliedNpm?: WorkspaceNpm): Promise<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=deploy.d.ts.map

package/dist/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../src/deploy.ts"],"names":[],"mappings":"AAoBA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,UAAU,CAAC;AAQlB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGrD,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAkBD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,EAC1B,IAAI,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IACoB,GAC9C,mBAAmB,GAAG,SAAS,CA6DjC;AAsQD,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,EACb,cAAc,GAAE,cAAuC;;;;;;;GAuDxD;AA4FD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,aAAa,EACtB,WAAW,CAAC,EAAE,YAAY,oCA6K3B"}