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

package/dist/process.js

@@ -0,0 +1,53 @@
+import { spawn, spawnSync } from 'node:child_process';
+export class CommandExecutionError extends Error {
+    stderr;
+    exitCode;
+    constructor(message, stderr, exitCode) {
+        super(message);
+        this.stderr = stderr;
+        this.exitCode = exitCode;
+        this.name = 'CommandExecutionError';
+    }
+}
+export function runCommand(command, args, options = {}) {
+    const result = spawnSync(command, args, {
+        cwd: options.cwd,
+        env: options.env,
+        encoding: 'utf8',
+        stdio: options.capture ? 'pipe' : 'inherit',
+        timeout: options.timeout,
+    });
+    if (result.error)
+        throw result.error;
+    if (result.status !== 0) {
+        const detail = [result.stdout, result.stderr]
+            .filter(Boolean)
+            .join('\n')
+            .trim();
+        throw new Error(detail || `${command} exited with status ${String(result.status)}`);
+    }
+    return result.stdout ?? '';
+}
+export function runCommandAsync(command, args, options = {}) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd: options.cwd,
+            env: options.env,
+            stdio: options.captureStderr ? ['inherit', 'inherit', 'pipe'] : 'inherit',
+        });
+        let stderr = '';
+        child.stderr?.on('data', (chunk) => {
+            stderr = (stderr + chunk.toString('utf8')).slice(-16 * 1024);
+            process.stderr.write(chunk);
+        });
+        child.once('error', reject);
+        child.once('close', (code, signal) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new CommandExecutionError(`${command} failed${signal ? ` with signal ${signal}` : ` with status ${String(code)}`}`, stderr, code));
+        });
+    });
+}
+//# sourceMappingURL=process.js.map

package/dist/process.js.map

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

package/dist/program.d.ts

@@ -0,0 +1,12 @@
+import { Command } from 'commander';
+import type { RuntimeProfile } from './environment.js';
+export interface BaseDatabaseProgramOptions {
+    commandName: string;
+    description: string;
+    version: string;
+    runtimeProfiles: readonly RuntimeProfile[];
+    includeSkillCommand?: boolean;
+}
+export declare function createBaseDatabaseProgram(options: BaseDatabaseProgramOptions): Command;
+export declare function runBaseDatabaseProgram(program: Command): void;
+//# sourceMappingURL=program.d.ts.map

package/dist/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAI5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAYvD,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAMD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CA6TT;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAO7D"}

package/dist/program.js

@@ -0,0 +1,204 @@
+import { Command, Option } from 'commander';
+import { doctor, login, logout, whoami } from './auth.js';
+import { deploymentStatus, deployProject } from './deploy.js';
+import { initializeProject } from './init.js';
+import { runProjectLarkCli } from './lark-cli.js';
+import { pullProject } from './pull.js';
+import { installSkill } from './skill.js';
+import { discoveryArgs, installDatabaseSkill, invocationArgs, runDatabaseSkillRequest, } from './database-skill.js';
+function printJson(value) {
+    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+export function createBaseDatabaseProgram(options) {
+    const [defaultProfile] = options.runtimeProfiles;
+    if (!defaultProfile) {
+        throw new Error('At least one runtime profile is required');
+    }
+    const profiles = new Map(options.runtimeProfiles.map((profile) => [profile.name, profile]));
+    if (profiles.size !== options.runtimeProfiles.length) {
+        throw new Error('Runtime profile names must be unique');
+    }
+    const runtimeProfile = (name) => {
+        const profile = profiles.get(name);
+        if (!profile)
+            throw new Error(`Runtime profile is not available: ${name}`);
+        return profile;
+    };
+    const environmentOption = () => new Option('--env <environment>', options.runtimeProfiles.length === 1
+        ? `Lark environment (${defaultProfile.name} only)`
+        : 'Lark environment')
+        .choices([...profiles.keys()])
+        .default(defaultProfile.name);
+    const program = new Command()
+        .name(options.commandName)
+        .description(options.description)
+        .version(options.version)
+        .showSuggestionAfterError()
+        .showHelpAfterError();
+    const auth = program
+        .command('auth')
+        .description('Manage lark-cli user access');
+    auth
+        .command('login')
+        .addOption(environmentOption())
+        .action(async (commandOptions) => login(runtimeProfile(commandOptions.env)));
+    auth
+        .command('logout')
+        .addOption(environmentOption())
+        .action(async (commandOptions) => logout(runtimeProfile(commandOptions.env)));
+    auth
+        .command('whoami')
+        .addOption(environmentOption())
+        .action(async (commandOptions) => printJson(await whoami(runtimeProfile(commandOptions.env))));
+    program
+        .command('doctor')
+        .description('Verify Node, lark-cli user auth, and database application services')
+        .addOption(environmentOption())
+        .action(async (commandOptions) => printJson(await doctor(runtimeProfile(commandOptions.env))));
+    if (options.includeSkillCommand !== false) {
+        const skill = program
+            .command('skill')
+            .description('Manage the Agent Skill');
+        skill
+            .command('install')
+            .description('Install or update the bundled lark-base-database Skill')
+            .addOption(new Option('--target <target>', 'Agent skills location')
+            .choices(['codex', 'agents', 'claude', 'all'])
+            .default('codex'))
+            .option('--dir <directory>', 'Custom Agent skills root')
+            .option('--force', 'Replace an existing installation', false)
+            .action((commandOptions) => {
+            if (commandOptions.dir && commandOptions.target !== 'codex') {
+                throw new Error('Use either --target or --dir, not both');
+            }
+            const installed = installSkill({
+                target: commandOptions.target,
+                directory: commandOptions.dir,
+                force: commandOptions.force,
+            });
+            printJson({ ok: true, installed });
+        });
+    }
+    const databaseSkill = program
+        .command('database-skill')
+        .description('Install and use an application capability Skill without a project directory');
+    databaseSkill
+        .command('install')
+        .requiredOption('--app-token <token>', 'Application token')
+        .requiredOption('--title <title>', 'Application name used for Skill discovery')
+        .option('--dir <directory>', 'Agent skills root (default: Codex user skills)')
+        .action((args) => {
+        printJson({
+            ok: true,
+            skill: installDatabaseSkill({
+                appToken: args.appToken,
+                title: args.title,
+                directory: args.dir,
+                profile: defaultProfile,
+            }),
+        });
+    });
+    databaseSkill
+        .command('discover')
+        .requiredOption('--app-token <token>', 'Application token')
+        .option('--page-size <count>', 'Functions per page', '20')
+        .option('--page-token <token>', 'Opaque discovery cursor')
+        .action(async (args) => {
+        const request = discoveryArgs(args.appToken, Number(args.pageSize), args.pageToken);
+        printJson(await runDatabaseSkillRequest(defaultProfile, request));
+    });
+    databaseSkill
+        .command('invoke')
+        .requiredOption('--app-token <token>', 'Application token')
+        .requiredOption('--function-id <id>', 'Discovered Function ID')
+        .requiredOption('--params <json>', 'Raw business params as JSON (not an envelope)')
+        .action(async (args) => {
+        const request = invocationArgs(args.appToken, args.functionId, args.params);
+        printJson(await runDatabaseSkillRequest(defaultProfile, request));
+    });
+    program
+        .command('init')
+        .description('Scaffold a database application using a new or existing Base')
+        .argument('[directory]', 'Project directory', '.')
+        .option('--schema <file>', 'Create a Base from this schema JSON file')
+        .option('--base-token <token>', 'Reuse and bind every table in an existing Base')
+        .option('--app-token <token>', 'Bind the selected Base to an existing application instead of creating another application')
+        .requiredOption('--name <name>', 'Application name; also names a Base created with --schema')
+        .option('--description <description>', 'Application description')
+        .option('--time-zone <timeZone>', 'Base time zone', 'Asia/Shanghai')
+        .addOption(environmentOption())
+        .action(async (directory, commandOptions) => {
+        const profile = runtimeProfile(commandOptions.env);
+        printJson(await initializeProject({
+            directory,
+            schema: commandOptions.schema,
+            baseToken: commandOptions.baseToken,
+            appToken: commandOptions.appToken,
+            name: commandOptions.name,
+            description: commandOptions.description,
+            timeZone: commandOptions.timeZone,
+            environment: commandOptions.env,
+            runtimeProfile: profile,
+        }));
+    });
+    program
+        .command('pull')
+        .description('Restore a database application from its source artifact and Catalog')
+        .argument('[directory]', 'Empty project directory', '.')
+        .requiredOption('--app-token <token>', 'Existing Application token')
+        .addOption(environmentOption())
+        .action(async (directory, commandOptions) => {
+        const profile = runtimeProfile(commandOptions.env);
+        printJson(await pullProject({
+            directory,
+            appToken: commandOptions.appToken,
+            environment: commandOptions.env,
+            runtimeProfile: profile,
+        }));
+    });
+    program
+        .command('deploy')
+        .description('Build and publish the current database application')
+        .argument('[directory]', 'Project directory', '.')
+        .option('--no-install', 'Reuse installed Page and FaaS dependencies')
+        .option('--force-install', 'Reinstall Page and FaaS dependencies', false)
+        .option('--production', 'Publish the verified artifact to Prod after Preview')
+        .option('--yes', 'Confirm the requested Prod publish non-interactively', false)
+        .action(async (directory, commandOptions) => {
+        if (commandOptions.yes && !commandOptions.production) {
+            throw new Error('--yes is only valid with --production');
+        }
+        printJson(await deployProject({
+            directory,
+            install: commandOptions.install,
+            forceInstall: commandOptions.forceInstall,
+            production: commandOptions.production,
+            yes: commandOptions.yes,
+            runtimeProfile: defaultProfile,
+        }));
+    });
+    program
+        .command('lark-cli')
+        .description('Run lark-cli with the current project routing (debug only)')
+        .argument('[arguments...]', 'Arguments passed unchanged to lark-cli')
+        .allowUnknownOption()
+        .action(async (args) => runProjectLarkCli(args, defaultProfile));
+    const deployments = program
+        .command('deployments')
+        .description('Inspect database application deployments');
+    deployments
+        .command('status')
+        .description('Read a publish task without creating a new deployment')
+        .argument('<publish-id>', 'Publish ID returned by deploy')
+        .argument('[directory]', 'Project directory', '.')
+        .option('--wait', 'Poll until the task finishes', false)
+        .action(async (publishId, directory, commandOptions) => printJson(await deploymentStatus(directory, publishId, commandOptions.wait, defaultProfile)));
+    return program;
+}
+export function runBaseDatabaseProgram(program) {
+    program.parseAsync().catch((error) => {
+        process.stderr.write(`${program.name()}: ${error instanceof Error ? error.message : String(error)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=program.js.map

package/dist/program.js.map

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

package/dist/pull.d.ts

@@ -0,0 +1,18 @@
+import type { RuntimeProfile } from './environment.js';
+interface PullOptions {
+    directory: string;
+    appToken: string;
+    environment: string;
+    runtimeProfile?: RuntimeProfile;
+}
+export declare function pullProject(options: PullOptions): Promise<{
+    ok: true;
+    environment: string;
+    workspace: string;
+    appToken: string;
+    source: 'artifact';
+    config: string;
+    catalog: string;
+}>;
+export {};
+//# sourceMappingURL=pull.d.ts.map

package/dist/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../src/pull.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAgBvD,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAiXD,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW;;;;;YA+FxC,UAAU;;;GASvB"}

package/dist/pull.js

@@ -0,0 +1,324 @@
+import { createWriteStream } from 'node:fs';
+import { cp, lstat, mkdir, mkdtemp, readFile, readdir, rename, rm, stat, writeFile, } from 'node:fs/promises';
+import { basename, dirname, join, posix, resolve } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import CRC32 from 'crc-32';
+import yauzl from 'yauzl';
+import { starterRoot } from './assets.js';
+import { CONFIG_FILE_NAME, writeConfig } from './config.js';
+import { ONLINE_RUNTIME_PROFILE, resolveRuntimeProfile, } from './environment.js';
+import { responseData, runLarkCli, runLarkCliOutput } from './lark-cli.js';
+const MAX_ARCHIVE_BYTES = 32 * 1024 * 1024;
+const MAX_FILES = 20_000;
+const MAX_EXPANDED_BYTES = 512 * 1024 * 1024;
+const ALLOWED_ROOTS = new Set(['page', 'server-functions', 'sql']);
+const APP_TOKEN_PATTERN = /^[A-Za-z0-9_-]{1,256}$/;
+const UNIX_FILE_TYPE_MASK = 0o170000;
+const UNIX_REGULAR_FILE = 0o100000;
+const UNIX_DIRECTORY = 0o040000;
+function pullError(code, message) {
+    return new Error(`${code}: ${message}`);
+}
+async function assertEmptyWorkspace(workspace) {
+    try {
+        const metadata = await lstat(workspace);
+        if (!metadata.isDirectory() || metadata.isSymbolicLink()) {
+            throw pullError('WORKSPACE_NOT_EMPTY', 'Pull target must be an empty directory');
+        }
+        if ((await readdir(workspace)).length !== 0) {
+            throw pullError('WORKSPACE_NOT_EMPTY', 'Pull target must be completely empty');
+        }
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+function validateEntryName(fileName, directory) {
+    if (fileName === '' ||
+        fileName.includes('\0') ||
+        fileName.includes('\\') ||
+        fileName.startsWith('/') ||
+        /^[A-Za-z]:/.test(fileName)) {
+        throw pullError('UNSAFE_SOURCE_ARCHIVE', `Unsafe ZIP entry path: ${fileName}`);
+    }
+    const withoutTrailingSlash = directory && fileName.endsWith('/') ? fileName.slice(0, -1) : fileName;
+    if (withoutTrailingSlash === '') {
+        throw pullError('UNSAFE_SOURCE_ARCHIVE', 'ZIP entry path must not be empty');
+    }
+    const normalized = posix.normalize(withoutTrailingSlash);
+    if (normalized !== withoutTrailingSlash ||
+        normalized === '..' ||
+        normalized.startsWith('../') ||
+        normalized
+            .split('/')
+            .some((part) => part === '' || part === '.' || part === '..')) {
+        throw pullError('UNSAFE_SOURCE_ARCHIVE', `Unsafe ZIP entry path: ${fileName}`);
+    }
+    const [root, ...rest] = normalized.split('/');
+    if (!root || !ALLOWED_ROOTS.has(root)) {
+        throw pullError('UNSUPPORTED_SOURCE_ENTRY', `ZIP entry is outside the supported source roots: ${fileName}`);
+    }
+    if (!directory && rest.length === 0) {
+        throw pullError('UNSAFE_SOURCE_ARCHIVE', `Source root must be a directory: ${fileName}`);
+    }
+    if (rest.some((part) => part === '.env' || part.startsWith('.env.'))) {
+        throw pullError('UNSAFE_SOURCE_ARCHIVE', `Environment files are not allowed in source archives: ${fileName}`);
+    }
+    return normalized;
+}
+function entryKind(entry) {
+    const directory = entry.fileName.endsWith('/');
+    const madeBy = entry.versionMadeBy >>> 8;
+    if (madeBy === 3) {
+        const mode = (entry.externalFileAttributes >>> 16) & 0xffff;
+        const kind = mode & UNIX_FILE_TYPE_MASK;
+        if (kind !== 0 && kind !== UNIX_REGULAR_FILE && kind !== UNIX_DIRECTORY) {
+            throw pullError('UNSAFE_SOURCE_ARCHIVE', `ZIP entry is not a regular file or directory: ${entry.fileName}`);
+        }
+        if (kind === UNIX_DIRECTORY && !directory) {
+            throw pullError('UNSAFE_SOURCE_ARCHIVE', `ZIP directory entry has an invalid name: ${entry.fileName}`);
+        }
+        if (kind === UNIX_REGULAR_FILE && directory) {
+            throw pullError('UNSAFE_SOURCE_ARCHIVE', `ZIP file entry has an invalid name: ${entry.fileName}`);
+        }
+    }
+    return directory ? 'directory' : 'file';
+}
+function openZip(archive) {
+    return new Promise((resolvePromise, reject) => {
+        yauzl.open(archive, { lazyEntries: true, autoClose: true, validateEntrySizes: true }, (error, zipFile) => {
+            if (error || !zipFile) {
+                reject(pullError('UNSUPPORTED_SOURCE_ARCHIVE', error?.message ?? 'Unable to open ZIP archive'));
+                return;
+            }
+            resolvePromise(zipFile);
+        });
+    });
+}
+function openEntryStream(zipFile, entry) {
+    return new Promise((resolvePromise, reject) => {
+        zipFile.openReadStream(entry, (error, stream) => {
+            if (error || !stream) {
+                reject(pullError('UNSAFE_SOURCE_ARCHIVE', error?.message ?? `Unable to read ${entry.fileName}`));
+                return;
+            }
+            resolvePromise(stream);
+        });
+    });
+}
+async function extractZip(archive, staging) {
+    const zipFile = await openZip(archive);
+    const paths = new Set();
+    let files = 0;
+    let expandedBytes = 0;
+    await new Promise((resolvePromise, reject) => {
+        let settled = false;
+        const finish = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            if (error) {
+                zipFile.close();
+                reject(error);
+            }
+            else {
+                resolvePromise();
+            }
+        };
+        zipFile.once('error', finish);
+        zipFile.once('end', () => finish());
+        zipFile.on('entry', (entry) => {
+            void (async () => {
+                const kind = entryKind(entry);
+                const relativePath = validateEntryName(entry.fileName, kind === 'directory');
+                if (paths.has(relativePath)) {
+                    throw pullError('UNSAFE_SOURCE_ARCHIVE', `ZIP contains a duplicate path: ${relativePath}`);
+                }
+                paths.add(relativePath);
+                const destination = join(staging, ...relativePath.split('/'));
+                if (kind === 'directory') {
+                    await mkdir(destination, { recursive: true });
+                    zipFile.readEntry();
+                    return;
+                }
+                files += 1;
+                if (files > MAX_FILES) {
+                    throw pullError('SOURCE_ARCHIVE_TOO_LARGE', `Source archive contains more than ${MAX_FILES} files`);
+                }
+                if (!Number.isSafeInteger(entry.uncompressedSize) ||
+                    entry.uncompressedSize < 0) {
+                    throw pullError('UNSAFE_SOURCE_ARCHIVE', `ZIP entry has an invalid size: ${entry.fileName}`);
+                }
+                expandedBytes += entry.uncompressedSize;
+                if (expandedBytes > MAX_EXPANDED_BYTES) {
+                    throw pullError('SOURCE_ARCHIVE_TOO_LARGE', 'Expanded source archive exceeds 512 MiB');
+                }
+                await mkdir(dirname(destination), { recursive: true });
+                const stream = await openEntryStream(zipFile, entry);
+                let actualBytes = 0;
+                let crc = 0;
+                stream.on('data', (chunk) => {
+                    actualBytes += chunk.length;
+                    if (actualBytes > entry.uncompressedSize ||
+                        actualBytes > MAX_EXPANDED_BYTES) {
+                        stream.destroy(pullError('UNSAFE_SOURCE_ARCHIVE', `ZIP entry size does not match: ${entry.fileName}`));
+                        return;
+                    }
+                    crc = CRC32.buf(chunk, crc);
+                });
+                await pipeline(stream, createWriteStream(destination, { flags: 'wx', mode: 0o644 }));
+                if (actualBytes !== entry.uncompressedSize ||
+                    crc >>> 0 !== entry.crc32) {
+                    throw pullError('UNSAFE_SOURCE_ARCHIVE', `ZIP entry integrity check failed: ${entry.fileName}`);
+                }
+                zipFile.readEntry();
+            })().catch(finish);
+        });
+        zipFile.readEntry();
+    });
+}
+async function validateSourceTree(staging) {
+    for (const directory of ALLOWED_ROOTS) {
+        let metadata;
+        try {
+            metadata = await lstat(join(staging, directory));
+        }
+        catch {
+            throw pullError('INVALID_SOURCE_ARCHIVE', `Source archive is missing ${directory}/`);
+        }
+        if (!metadata.isDirectory() || metadata.isSymbolicLink()) {
+            throw pullError('INVALID_SOURCE_ARCHIVE', `Source archive ${directory}/ is not a directory`);
+        }
+    }
+}
+function catalogBinding(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw pullError('INVALID_CATALOG', 'Application Catalog must be an object');
+    }
+    const catalog = value;
+    if (!Array.isArray(catalog.tables) || catalog.tables.length === 0) {
+        throw pullError('INVALID_CATALOG', 'Application Catalog must contain at least one table');
+    }
+    const tables = catalog.tables.map((item) => {
+        if (!item || typeof item !== 'object' || Array.isArray(item)) {
+            throw pullError('INVALID_CATALOG', 'Application Catalog contains an invalid table');
+        }
+        const table = item;
+        if (typeof table.baseToken !== 'string' ||
+            table.baseToken.trim() === '' ||
+            typeof table.id !== 'string' ||
+            table.id.trim() === '') {
+            throw pullError('INVALID_CATALOG', 'Every Catalog table must contain baseToken and id');
+        }
+        return { baseToken: table.baseToken.trim(), id: table.id.trim() };
+    });
+    const baseTokens = [...new Set(tables.map((table) => table.baseToken))];
+    if (baseTokens.length !== 1) {
+        throw pullError('MULTIPLE_BASES_NOT_SUPPORTED', 'Artifact reconstruction currently supports exactly one Base');
+    }
+    const tableIds = [...new Set(tables.map((table) => table.id))];
+    if (tableIds.length !== tables.length) {
+        throw pullError('INVALID_CATALOG', 'Application Catalog contains duplicate table IDs');
+    }
+    return { catalog, baseToken: baseTokens[0], tableIds };
+}
+async function addAuxiliaryFiles(staging) {
+    await cp(join(starterRoot, 'README.md'), join(staging, 'README.md'));
+    await cp(join(starterRoot, 'gitignore'), join(staging, '.gitignore'));
+    await cp(join(starterRoot, 'prettierignore'), join(staging, '.prettierignore'));
+}
+async function replaceEmptyWorkspace(workspace, staging, existed) {
+    if (!existed) {
+        await rename(staging, workspace);
+        return;
+    }
+    if ((await readdir(workspace)).length !== 0) {
+        throw pullError('WORKSPACE_NOT_EMPTY', 'Pull target changed while source was being restored');
+    }
+    const backup = `${workspace}.pull-backup-${process.pid}-${Date.now()}`;
+    await rename(workspace, backup);
+    try {
+        await rename(staging, workspace);
+    }
+    catch (error) {
+        await rename(backup, workspace).catch(() => undefined);
+        throw error;
+    }
+    await rm(backup, { recursive: true, force: true });
+}
+export async function pullProject(options) {
+    const appToken = options.appToken.trim();
+    if (!APP_TOKEN_PATTERN.test(appToken)) {
+        throw pullError('INVALID_APP_TOKEN', 'A valid --app-token is required');
+    }
+    const runtimeProfile = resolveRuntimeProfile(options.environment, options.runtimeProfile ?? ONLINE_RUNTIME_PROFILE);
+    const workspace = resolve(options.directory);
+    const parent = dirname(workspace);
+    await mkdir(parent, { recursive: true });
+    const workspaceExisted = await assertEmptyWorkspace(workspace);
+    const temporaryRoot = await mkdtemp(join(parent, `.${basename(workspace)}.pull-`));
+    const archive = join(temporaryRoot, 'source.zip');
+    const staging = join(temporaryRoot, 'workspace');
+    await mkdir(staging);
+    try {
+        const env = await runtimeProfile.commandEnvironment();
+        runLarkCliOutput('GET', `/open-apis/base/v3/sites/${encodeURIComponent(appToken)}/source_code`, archive, env, parent);
+        const archiveMetadata = await stat(archive);
+        if (!archiveMetadata.isFile() || archiveMetadata.size === 0) {
+            throw pullError('UNSUPPORTED_SOURCE_ARCHIVE', 'source_code returned an empty artifact');
+        }
+        if (archiveMetadata.size > MAX_ARCHIVE_BYTES) {
+            throw pullError('SOURCE_ARCHIVE_TOO_LARGE', 'Compressed source archive exceeds 32 MiB');
+        }
+        const magic = (await readFile(archive)).subarray(0, 4);
+        if (magic.length < 4 ||
+            magic[0] !== 0x50 ||
+            magic[1] !== 0x4b ||
+            magic[2] !== 0x03 ||
+            magic[3] !== 0x04) {
+            throw pullError('UNSUPPORTED_SOURCE_ARCHIVE', 'source_code is not a supported ZIP archive');
+        }
+        await extractZip(archive, staging);
+        await validateSourceTree(staging);
+        const catalogResponse = runLarkCli([
+            'api',
+            'GET',
+            `/open-apis/base/v3/sites/${encodeURIComponent(appToken)}/catalog`,
+        ], env, parent);
+        const binding = catalogBinding(responseData(catalogResponse));
+        await writeFile(join(staging, 'catalog.json'), `${JSON.stringify(binding.catalog, null, 2)}\n`);
+        writeConfig(staging, {
+            configVersion: 1,
+            name: basename(workspace),
+            ...(runtimeProfile.name === ONLINE_RUNTIME_PROFILE.name
+                ? {}
+                : { runtimeProfile: runtimeProfile.name }),
+            appToken,
+            bindings: {
+                MAIN_BASE: {
+                    type: 'base',
+                    baseToken: binding.baseToken,
+                    tableIds: binding.tableIds,
+                },
+            },
+        });
+        await addAuxiliaryFiles(staging);
+        await replaceEmptyWorkspace(workspace, staging, workspaceExisted);
+        return {
+            ok: true,
+            environment: runtimeProfile.name,
+            workspace,
+            appToken,
+            source: 'artifact',
+            config: join(workspace, CONFIG_FILE_NAME),
+            catalog: join(workspace, 'catalog.json'),
+        };
+    }
+    finally {
+        await rm(temporaryRoot, { recursive: true, force: true }).catch(() => undefined);
+    }
+}
+//# sourceMappingURL=pull.js.map