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

package/dist/project-build.js

@@ -0,0 +1,229 @@
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { lockRepairHint, validateDependencyLock, } from './npm.js';
+import { CommandExecutionError } from './process.js';
+import { workspaceInputFingerprint } from './workspace-fingerprint.js';
+export const dependencyDirectories = ['page', 'server-functions'];
+export class ProjectBuildError extends Error {
+    results;
+    constructor(results) {
+        const failures = results.filter((result) => result.status === 'failed');
+        super(failures
+            .map((failure) => `${failure.target} build failed: ${failure.message ?? 'unknown error'}`)
+            .join('\n'));
+        this.results = results;
+        this.name = 'ProjectBuildError';
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function validateProjectDependencyLocks(workspace, npm) {
+    for (const directory of dependencyDirectories) {
+        validateDependencyLock(join(workspace, directory), directory, npm.version);
+    }
+}
+function dependencyFingerprint(workspace, directory, npmVersion) {
+    const hash = createHash('sha256');
+    const project = join(workspace, directory);
+    for (const filename of [
+        'package.json',
+        'package-lock.json',
+        'npm-shrinkwrap.json',
+        '.npmrc',
+    ]) {
+        const path = join(project, filename);
+        hash.update(filename);
+        hash.update('\0');
+        hash.update(existsSync(path) ? readFileSync(path) : '<missing>');
+        hash.update('\0');
+    }
+    hash.update(process.version);
+    hash.update('\0');
+    hash.update(npmVersion);
+    hash.update('\0');
+    hash.update(process.platform);
+    hash.update('\0');
+    hash.update(process.arch);
+    return hash.digest('hex');
+}
+function dependencyStatePath(workspace, directory) {
+    return join(workspace, '.base-database-cli/state/dependencies', `${directory}.json`);
+}
+function readDependencyState(path) {
+    try {
+        const value = JSON.parse(readFileSync(path, 'utf8'));
+        if (isRecord(value) &&
+            typeof value.fingerprint === 'string' &&
+            typeof value.nodeVersion === 'string' &&
+            typeof value.npmVersion === 'string' &&
+            typeof value.platform === 'string' &&
+            typeof value.arch === 'string') {
+            return {
+                fingerprint: value.fingerprint,
+                nodeVersion: value.nodeVersion,
+                npmVersion: value.npmVersion,
+                platform: value.platform,
+                arch: value.arch,
+            };
+        }
+    }
+    catch {
+        // 缓存缺失或损坏时重新安装依赖。
+    }
+    return undefined;
+}
+function writeDependencyState(path, state) {
+    mkdirSync(dirname(path), { recursive: true });
+    const temporary = `${path}.${String(process.pid)}.tmp`;
+    writeFileSync(temporary, `${JSON.stringify(state, null, 2)}\n`);
+    renameSync(temporary, path);
+}
+function canReuseDependencies(workspace, directory, fingerprint, npmVersion) {
+    const state = readDependencyState(dependencyStatePath(workspace, directory));
+    return (state?.fingerprint === fingerprint &&
+        state.nodeVersion === process.version &&
+        state.npmVersion === npmVersion &&
+        state.platform === process.platform &&
+        state.arch === process.arch &&
+        existsSync(join(workspace, directory, 'node_modules')));
+}
+export async function installDependencies(workspace, forceInstall, npm, options = {}) {
+    await Promise.all(dependencyDirectories.map(async (directory) => {
+        const fingerprint = dependencyFingerprint(workspace, directory, npm.version);
+        if (!forceInstall &&
+            canReuseDependencies(workspace, directory, fingerprint, npm.version)) {
+            if (!options.captureOutput) {
+                process.stderr.write(`Dependencies unchanged; skipping npm ci for ${directory}.\n`);
+            }
+            return;
+        }
+        const statePath = dependencyStatePath(workspace, directory);
+        rmSync(statePath, { force: true });
+        if (!options.captureOutput) {
+            process.stderr.write(`Installing ${directory} dependencies with npm@${npm.version} (Node ${process.version}).\n`);
+        }
+        try {
+            await npm.run(['ci'], {
+                cwd: join(workspace, directory),
+                captureOutput: options.captureOutput,
+            });
+        }
+        catch (error) {
+            const diagnostics = error instanceof CommandExecutionError ? error.stderr : '';
+            const lockFailure = /EUSAGE|Invalid: lock file|Missing: .*from lock file|package\.json and .*lock.*in sync/is.test(diagnostics);
+            const hint = lockFailure
+                ? lockRepairHint(directory, npm.version)
+                : `Check the npm diagnostic above for ${directory}. Fix network, registry, authentication or installer errors before retrying; do not delete the lock or bypass installation.`;
+            throw new Error(`Dependency installation failed for ${directory} using npm@${npm.version}: ${error instanceof Error ? error.message : String(error)}. ${hint}`, { cause: error });
+        }
+        if (!existsSync(join(workspace, directory, 'node_modules'))) {
+            throw new Error(`npm ci completed without creating node_modules for ${directory}`);
+        }
+        writeDependencyState(statePath, {
+            fingerprint,
+            nodeVersion: process.version,
+            npmVersion: npm.version,
+            platform: process.platform,
+            arch: process.arch,
+        });
+    }));
+}
+function buildStatePath(workspace, directory) {
+    return join(workspace, '.base-database-cli/state/check-build', `${directory}.json`);
+}
+function readBuildState(path) {
+    try {
+        const value = JSON.parse(readFileSync(path, 'utf8'));
+        if (isRecord(value) &&
+            value.version === 1 &&
+            typeof value.fingerprint === 'string') {
+            return { version: 1, fingerprint: value.fingerprint };
+        }
+    }
+    catch {
+        // A missing or damaged build cache is a normal cache miss.
+    }
+    return undefined;
+}
+function buildFingerprint(workspace, directory, env, npmVersion) {
+    const hash = createHash('sha256');
+    const input = workspaceInputFingerprint(join(workspace, directory));
+    hash.update('base-database-check-build-v1\0');
+    hash.update(input.algorithm);
+    hash.update('\0');
+    hash.update(input.sha256);
+    hash.update('\0');
+    hash.update(process.version);
+    hash.update('\0');
+    hash.update(npmVersion);
+    hash.update('\0');
+    hash.update(process.platform);
+    hash.update('\0');
+    hash.update(process.arch);
+    hash.update('\0');
+    for (const [name, value] of Object.entries(env).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0)) {
+        hash.update(name);
+        hash.update('\0');
+        hash.update(value ?? '<undefined>');
+        hash.update('\0');
+    }
+    return hash.digest('hex');
+}
+function writeBuildState(path, fingerprint) {
+    mkdirSync(dirname(path), { recursive: true });
+    const temporary = `${path}.${String(process.pid)}.tmp`;
+    writeFileSync(temporary, `${JSON.stringify({ version: 1, fingerprint }, null, 2)}\n`);
+    renameSync(temporary, path);
+}
+function commandDiagnostics(error) {
+    if (!(error instanceof CommandExecutionError))
+        return undefined;
+    const output = [error.stdout, error.stderr]
+        .filter((value) => value.trim() !== '')
+        .join('\n')
+        .trim();
+    return output === '' ? undefined : output;
+}
+export async function buildProject(workspace, env, npm, options = {}) {
+    const results = await Promise.all(dependencyDirectories.map(async (directory) => {
+        const statePath = buildStatePath(workspace, directory);
+        const fingerprint = options.incremental
+            ? buildFingerprint(workspace, directory, env, npm.version)
+            : undefined;
+        if (fingerprint &&
+            !options.force &&
+            readBuildState(statePath)?.fingerprint === fingerprint) {
+            if (!options.captureOutput) {
+                process.stderr.write(`Build inputs unchanged; skipping ${directory} build.\n`);
+            }
+            return { target: directory, status: 'cached' };
+        }
+        if (options.incremental)
+            rmSync(statePath, { force: true });
+        try {
+            await npm.run(['run', 'build'], {
+                cwd: join(workspace, directory),
+                env,
+                captureOutput: options.captureOutput,
+            });
+            if (fingerprint)
+                writeBuildState(statePath, fingerprint);
+            return { target: directory, status: 'passed' };
+        }
+        catch (error) {
+            return {
+                target: directory,
+                status: 'failed',
+                message: error instanceof Error ? error.message : String(error),
+                diagnostics: commandDiagnostics(error),
+            };
+        }
+    }));
+    if (results.some((result) => result.status === 'failed')) {
+        throw new ProjectBuildError(results);
+    }
+    return results;
+}
+//# sourceMappingURL=project-build.js.map

package/dist/project-build.js.map

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

package/dist/project-context.d.ts

@@ -0,0 +1,344 @@
+import { type RedactedWorkspaceInputFingerprint } from './workspace-fingerprint.js';
+export declare const PROJECT_CONTEXT_SCHEMA_VERSION = "base-database-project-context.v1";
+export declare const PROJECT_CONTEXT_SUMMARY_SCHEMA_VERSION = "base-database-project-context-summary.v1";
+type Warning = {
+    code: string;
+    message: string;
+};
+type Readiness = {
+    ready: boolean;
+    blockers: string[];
+};
+type NextAction = {
+    id: string;
+    command: string;
+    reasonCode: string;
+};
+export interface ProjectContextOptions {
+    directory?: string;
+    cliVersion: string;
+    defaultEnvironment: string;
+    larkProfile?: string;
+}
+export declare function getProjectContext(options: ProjectContextOptions): {
+    schemaVersion: string;
+    cli: {
+        version: string;
+        nodeVersion: string;
+        environment: string;
+    };
+    project: {
+        status: 'uninitialized';
+        workspace: string;
+        title: null;
+        larkProfile: string | null;
+        sourceFingerprint: null;
+    };
+    application: {
+        appToken: null;
+    };
+    database: {
+        baseToken: null;
+        tables: never[];
+    };
+    functions: {
+        database: never[];
+        mutation: never[];
+        faas: never[];
+    };
+    receipts: {
+        initialization: {
+            status: string;
+        };
+        preview: {
+            status: 'missing';
+        };
+    };
+    readiness: {
+        init: Readiness;
+        check: {
+            ready: boolean;
+            blockers: string[];
+        };
+        deploy: {
+            ready: boolean;
+            blockers: string[];
+        };
+    };
+    warnings: Warning[];
+    nextActions: {
+        id: string;
+        command: string;
+        reasonCode: string;
+    }[];
+} | {
+    schemaVersion: string;
+    cli: {
+        version: string;
+        nodeVersion: string;
+        environment: string;
+    };
+    application: {
+        appToken: null;
+    };
+    database: {
+        baseToken: null;
+        tables: never[];
+    };
+    functions: {
+        database: never[];
+        mutation: never[];
+        faas: never[];
+    };
+    receipts: {
+        initialization: {
+            status: string;
+        };
+        preview: {
+            status: 'missing';
+        };
+    };
+    warnings: Warning[];
+    project: {
+        workspace: string;
+        title: null;
+        larkProfile: string | null;
+        sourceFingerprint: null;
+        status: 'invalid';
+    };
+    readiness: {
+        init: {
+            ready: boolean;
+            blockers: string[];
+        };
+        check: {
+            ready: boolean;
+            blockers: string[];
+        };
+        deploy: {
+            ready: boolean;
+            blockers: string[];
+        };
+    };
+    nextActions: {
+        id: string;
+        command: string;
+        reasonCode: string;
+    }[];
+} | {
+    schemaVersion: string;
+    cli: {
+        version: string;
+        nodeVersion: string;
+        environment: string;
+    };
+    project: {
+        status: "incomplete" | "initialized";
+        workspace: string;
+        title: string;
+        larkProfile: string | null;
+        sourceFingerprint: RedactedWorkspaceInputFingerprint | null;
+    };
+    application: {
+        appToken: string;
+    };
+    database: {
+        baseToken: string | null | undefined;
+        tables: {
+            id: string | null;
+            name: string | null;
+            primaryField: string | null;
+            fieldCount: number;
+        }[];
+    };
+    functions: {
+        database: {
+            id: string;
+            input: {
+                type: string;
+                parameterCount: number | null;
+                propertyCount?: undefined;
+                required?: undefined;
+            } | {
+                parameterCount?: undefined;
+                type: string;
+                propertyCount: number;
+                required: string[];
+            } | {
+                parameterCount?: undefined;
+                propertyCount?: undefined;
+                required?: undefined;
+                type: string;
+            };
+        }[];
+        mutation: {
+            id: string;
+            input: {
+                type: string;
+                parameterCount: number | null;
+                propertyCount?: undefined;
+                required?: undefined;
+            } | {
+                parameterCount?: undefined;
+                type: string;
+                propertyCount: number;
+                required: string[];
+            } | {
+                parameterCount?: undefined;
+                propertyCount?: undefined;
+                required?: undefined;
+                type: string;
+            };
+        }[];
+        faas: {
+            id: string;
+            input: {
+                type: string;
+                parameterCount: number | null;
+                propertyCount?: undefined;
+                required?: undefined;
+            } | {
+                parameterCount?: undefined;
+                type: string;
+                propertyCount: number;
+                required: string[];
+            } | {
+                parameterCount?: undefined;
+                propertyCount?: undefined;
+                required?: undefined;
+                type: string;
+            };
+        }[];
+    };
+    receipts: {
+        initialization: {
+            status: string;
+        };
+        preview: {
+            status: 'missing';
+            publishId?: undefined;
+            sourceFingerprintMatches?: undefined;
+        } | {
+            status: 'invalid';
+            publishId?: undefined;
+            sourceFingerprintMatches?: undefined;
+        } | {
+            status: "published" | "stale" | "unverified";
+            publishId: string;
+            sourceFingerprintMatches: boolean | null;
+        };
+    };
+    readiness: {
+        init: {
+            ready: boolean;
+            blockers: string[];
+        };
+        check: {
+            ready: boolean;
+            blockers: string[];
+        };
+        deploy: {
+            ready: boolean;
+            blockers: string[];
+        };
+    };
+    warnings: Warning[];
+    nextActions: NextAction[];
+};
+export declare function summarizeProjectContext(value: ReturnType<typeof getProjectContext>): {
+    schemaVersion: string;
+    environment: string;
+    project: {
+        status: "incomplete" | "initialized" | "invalid" | "uninitialized";
+        title: string | null;
+        larkProfile: string | null;
+    };
+    application: {
+        appToken: null;
+    } | {
+        appToken: string;
+    };
+    database: {
+        baseToken: string | null | undefined;
+        tableCount: number;
+    };
+    functions: {
+        databaseCount: number;
+        mutationCount: number;
+        faasCount: number;
+    };
+    receipts: {
+        initialization: {
+            status: string;
+        };
+        preview: {
+            status: 'missing';
+        };
+    } | {
+        initialization: {
+            status: string;
+        };
+        preview: {
+            status: 'missing';
+            publishId?: undefined;
+            sourceFingerprintMatches?: undefined;
+        } | {
+            status: 'invalid';
+            publishId?: undefined;
+            sourceFingerprintMatches?: undefined;
+        } | {
+            status: "published" | "stale" | "unverified";
+            publishId: string;
+            sourceFingerprintMatches: boolean | null;
+        };
+    };
+    readiness: {
+        init: Readiness;
+        check: {
+            ready: boolean;
+            blockers: string[];
+        };
+        deploy: {
+            ready: boolean;
+            blockers: string[];
+        };
+    } | {
+        init: {
+            ready: boolean;
+            blockers: string[];
+        };
+        check: {
+            ready: boolean;
+            blockers: string[];
+        };
+        deploy: {
+            ready: boolean;
+            blockers: string[];
+        };
+    } | {
+        init: {
+            ready: boolean;
+            blockers: string[];
+        };
+        check: {
+            ready: boolean;
+            blockers: string[];
+        };
+        deploy: {
+            ready: boolean;
+            blockers: string[];
+        };
+    };
+    warnings: Warning[];
+    nextActions: NextAction[] | {
+        id: string;
+        command: string;
+        reasonCode: string;
+    }[] | {
+        id: string;
+        command: string;
+        reasonCode: string;
+    }[];
+};
+export {};
+//# sourceMappingURL=project-context.d.ts.map

package/dist/project-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.d.ts","sourceRoot":"","sources":["../src/project-context.ts"],"names":[],"mappings":"AAWA,OAAO,EASL,KAAK,iCAAiC,EACvC,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,8BAA8B,qCACP,CAAC;AACrC,eAAO,MAAM,sCAAsC,6CACP,CAAC;AAE7C,KAAK,OAAO,GAAG;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAIF,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAwcD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,qBAAqB;;;QAtC1D,OAAO;QACP,WAAW;QACX,WAAW;;;gBAGH,eAAe;;;;;;;QAMV,QAAQ;;;QACX,SAAS;QAAQ,MAAM;;;QACtB,QAAQ;QAAM,QAAQ;QAAM,IAAI;;;QAE3C,cAAc;;;QACd,OAAO;YAAI,MAAM,EAAE,SAAS;;;;QAG5B,IAAI;QACJ,KAAK;YAAI,KAAK;YAAS,QAAQ;;QAC/B,MAAM;YAAI,KAAK;YAAS,QAAQ;;;;;;;;;;;;QArBhC,OAAO;QACP,WAAW;QACX,WAAW;;;QASE,QAAQ;;;QACX,SAAS;QAAQ,MAAM;;;QACtB,QAAQ;QAAM,QAAQ;QAAM,IAAI;;;QAE3C,cAAc;;;QACd,OAAO;YAAI,MAAM,EAAE,SAAS;;;;;;;;;gBAiDU,SAAS;;;QAE7C,IAAI;YAAI,KAAK;YAAS,QAAQ;;QAC9B,KAAK;YAAI,KAAK;YAAS,QAAQ;;QAC/B,MAAM;YAAI,KAAK;YAAS,QAAQ;;;;;;;;;;;QAoElC,OAAO;QACP,WAAW;QACX,WAAW;;;;;;;;;;QASE,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA7Re,SAAS;;;;oBAiB5B,SAAS;;;;;;;;;;;YAoRlB,KAAK;YAAS,QAAQ;;;;;;;;;;;;;EAOnC;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC;;;;QAMvC,MAAM;QACN,KAAK;QACL,WAAW;;;;;;;;QAIX,SAAS;QACT,UAAU;;;QAGV,aAAa;QACb,aAAa;QACb,SAAS;;;;;;;YAxKE,MAAM,EAAE,SAAS;;;;;;;oBAzJQ,SAAS;;;;oBAiB5B,SAAS;;;;;;;;;;;;YA4IjB,KAAK;YAAS,QAAQ;;;YACrB,KAAK;YAAS,QAAQ;;;;YA8CtB,KAAK;YAAS,QAAQ;;;YACrB,KAAK;YAAS,QAAQ;;;YACrB,KAAK;YAAS,QAAQ;;;;YAuF1B,KAAK;YAAS,QAAQ;;;;;;;;;;;;;;;;;;;;;EAmCnC"}