@celljs/cli 3.8.0 → 4.0.0

package/lib/deploy/request-signer.js.map

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

package/lib/deploy/zip-writer.d.ts

@@ -0,0 +1,32 @@
+interface ZipEntry {
+    name: Buffer;
+    crc: number;
+    size: number;
+    compressed: Buffer;
+    method: 0 | 8;
+    mode: number;
+    offset: number;
+}
+/**
+ * Writes zip archives (the code packages of FC, SCF and Lambda) without a dependency: deflate from
+ * node:zlib, Unix permissions in the external attributes so start scripts stay executable, a fixed
+ * timestamp so the same output gives the same archive.
+ */
+export declare class ZipWriter {
+    /** 1980-01-01 00:00, the earliest DOS date. */
+    static readonly DOS_DATE: number;
+    protected static readonly CRC_TABLE: Uint32Array<ArrayBufferLike>;
+    protected readonly entries: ZipEntry[];
+    protected readonly chunks: Buffer[];
+    protected offset: number;
+    /** Adds every file under `dir`, sorted, at `prefix` (`a/b` style) in the archive. */
+    addDirectory(dir: string, prefix?: string): this;
+    add(name: string, content: Buffer | string, mode?: number): this;
+    toBuffer(): Buffer;
+    get files(): number;
+    protected push(...buffers: Buffer[]): void;
+    static crc32(data: Buffer): number;
+    protected static crcTable(): Uint32Array;
+}
+export {};
+//# sourceMappingURL=zip-writer.d.ts.map

package/lib/deploy/zip-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-writer.d.ts","sourceRoot":"","sources":["../../src/deploy/zip-writer.ts"],"names":[],"mappings":"AAIA,UAAU,QAAQ;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,SAAS;IAClB,+CAA+C;IAC/C,MAAM,CAAC,QAAQ,CAAC,QAAQ,SAA2B;IACnD,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,+BAAwB;IAE3D,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAM;IAC5C,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM;IACzC,SAAS,CAAC,MAAM,SAAK;IAErB,qFAAqF;IACrF,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,IAAI,CAS3C;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,SAAQ,GAAG,IAAI,CA4B9D;IAED,QAAQ,IAAI,MAAM,CA6BjB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,SAAS,CAAC,IAAI,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAKzC;IAED,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMjC;IAED,SAAS,CAAC,MAAM,CAAC,QAAQ,IAAI,WAAW,CAUvC;CACJ"}

package/lib/deploy/zip-writer.js

@@ -0,0 +1,114 @@
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, sep } from 'node:path';
+import { deflateRawSync } from 'node:zlib';
+/**
+ * Writes zip archives (the code packages of FC, SCF and Lambda) without a dependency: deflate from
+ * node:zlib, Unix permissions in the external attributes so start scripts stay executable, a fixed
+ * timestamp so the same output gives the same archive.
+ */
+export class ZipWriter {
+    /** 1980-01-01 00:00, the earliest DOS date. */
+    static DOS_DATE = (0 << 9) | (1 << 5) | 1;
+    static CRC_TABLE = ZipWriter.crcTable();
+    entries = [];
+    chunks = [];
+    offset = 0;
+    /** Adds every file under `dir`, sorted, at `prefix` (`a/b` style) in the archive. */
+    addDirectory(dir, prefix = '') {
+        for (const name of readdirSync(dir, { recursive: true }).sort()) {
+            const file = join(dir, name);
+            const stat = statSync(file);
+            if (stat.isFile()) {
+                this.add(`${prefix}${name.split(sep).join('/')}`, readFileSync(file), stat.mode & 0o777);
+            }
+        }
+        return this;
+    }
+    add(name, content, mode = 0o644) {
+        const data = typeof content === 'string' ? Buffer.from(content) : content;
+        const deflated = deflateRawSync(data, { level: 9 });
+        const stored = deflated.length >= data.length;
+        const entry = {
+            name: Buffer.from(name),
+            crc: ZipWriter.crc32(data),
+            size: data.length,
+            compressed: stored ? data : deflated,
+            method: stored ? 0 : 8,
+            mode,
+            offset: this.offset,
+        };
+        const header = Buffer.alloc(30);
+        header.writeUInt32LE(0x04034b50, 0);
+        header.writeUInt16LE(20, 4);
+        header.writeUInt16LE(0x0800, 6);
+        header.writeUInt16LE(entry.method, 8);
+        header.writeUInt16LE(0, 10);
+        header.writeUInt16LE(ZipWriter.DOS_DATE, 12);
+        header.writeUInt32LE(entry.crc, 14);
+        header.writeUInt32LE(entry.compressed.length, 18);
+        header.writeUInt32LE(entry.size, 22);
+        header.writeUInt16LE(entry.name.length, 26);
+        header.writeUInt16LE(0, 28);
+        this.push(header, entry.name, entry.compressed);
+        this.entries.push(entry);
+        return this;
+    }
+    toBuffer() {
+        const start = this.offset;
+        const central = [];
+        for (const entry of this.entries) {
+            const header = Buffer.alloc(46);
+            header.writeUInt32LE(0x02014b50, 0);
+            // Made by Unix (3), so the external attributes carry the file mode.
+            header.writeUInt16LE((3 << 8) | 20, 4);
+            header.writeUInt16LE(20, 6);
+            header.writeUInt16LE(0x0800, 8);
+            header.writeUInt16LE(entry.method, 10);
+            header.writeUInt16LE(0, 12);
+            header.writeUInt16LE(ZipWriter.DOS_DATE, 14);
+            header.writeUInt32LE(entry.crc, 16);
+            header.writeUInt32LE(entry.compressed.length, 20);
+            header.writeUInt32LE(entry.size, 24);
+            header.writeUInt16LE(entry.name.length, 28);
+            header.writeUInt32LE(((0o100000 | entry.mode) << 16) >>> 0, 38);
+            header.writeUInt32LE(entry.offset, 42);
+            central.push(header, entry.name);
+        }
+        const size = central.reduce((n, b) => n + b.length, 0);
+        const end = Buffer.alloc(22);
+        end.writeUInt32LE(0x06054b50, 0);
+        end.writeUInt16LE(this.entries.length, 8);
+        end.writeUInt16LE(this.entries.length, 10);
+        end.writeUInt32LE(size, 12);
+        end.writeUInt32LE(start, 16);
+        return Buffer.concat([...this.chunks, ...central, end]);
+    }
+    get files() {
+        return this.entries.length;
+    }
+    push(...buffers) {
+        for (const buffer of buffers) {
+            this.chunks.push(buffer);
+            this.offset += buffer.length;
+        }
+    }
+    static crc32(data) {
+        let crc = 0xffffffff;
+        for (let i = 0; i < data.length; i++) {
+            crc = ZipWriter.CRC_TABLE[(crc ^ data[i]) & 0xff] ^ (crc >>> 8);
+        }
+        return (crc ^ 0xffffffff) >>> 0;
+    }
+    static crcTable() {
+        const table = new Uint32Array(256);
+        for (let n = 0; n < 256; n++) {
+            let c = n;
+            for (let k = 0; k < 8; k++) {
+                c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+            }
+            table[n] = c >>> 0;
+        }
+        return table;
+    }
+}
+//# sourceMappingURL=zip-writer.js.map

package/lib/deploy/zip-writer.js.map

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

package/lib/docs/docs-index.d.ts

@@ -0,0 +1,54 @@
+/** Where documentation is read from: a directory of Markdown or one file, and who provides it. */
+export interface DocsSource {
+    path: string;
+    /** Component or toolchain module that provides it. */
+    source: string;
+}
+/** A section of a Markdown file: from one heading to the next. */
+export interface DocsSection {
+    /** Relative to the project root. */
+    file: string;
+    line: number;
+    title: string;
+    source: string;
+    text: string;
+}
+export interface DocsHit extends Omit<DocsSection, 'text'> {
+    score: number;
+    text: string;
+    /** The section was longer than the text. */
+    truncated?: true;
+}
+/**
+ * Searches the Markdown that ships with the installed components and toolchain modules (README.md
+ * and `docs/` of each component, `cell.addDocs()` directories), so agents read the docs of the
+ * versions the project uses (docs/design/agent-first.md R7). Sections are ranked by how many query
+ * words they contain, headings counting more.
+ */
+export declare class DocsIndex {
+    protected readonly root: string;
+    protected readonly sources: DocsSource[];
+    static readonly MAX_TEXT = 1500;
+    static readonly MAX_FILES = 2000;
+    protected sections?: DocsSection[];
+    protected fileCount: number;
+    constructor(root: string, sources: DocsSource[]);
+    /** README.md and docs/ of each component directory, then the modules' docs directories. */
+    static sourcesOf(components: readonly {
+        name: string;
+        dir: string;
+    }[], moduleDocs: readonly {
+        source: string;
+        value: string;
+    }[]): DocsSource[];
+    get files(): number;
+    search(query: string, limit?: number): DocsHit[];
+    /** Lowercased words of the query; words of two characters or fewer only when nothing else is left. */
+    static terms(query: string): string[];
+    protected static count(text: string, term: string): number;
+    protected load(): DocsSection[];
+    protected markdownFiles(path: string): string[];
+    /** Splits Markdown at headings, ignoring `#` lines inside fenced code. */
+    static split(markdown: string, file: string, source: string): DocsSection[];
+}
+//# sourceMappingURL=docs-index.d.ts.map

package/lib/docs/docs-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-index.d.ts","sourceRoot":"","sources":["../../src/docs/docs-index.ts"],"names":[],"mappings":"AAGA,kGAAkG;AAClG,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,kEAAkE;AAClE,MAAM,WAAW,WAAW;IACxB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,OAAQ,SAAQ,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,SAAS,CAAC,EAAE,IAAI,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IAQd,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAC/B,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE;IAR5C,MAAM,CAAC,QAAQ,CAAC,QAAQ,QAAQ;IAChC,MAAM,CAAC,QAAQ,CAAC,SAAS,QAAQ;IAEjC,SAAS,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACnC,SAAS,CAAC,SAAS,SAAK;IAExB,YACuB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,EAAE,EACxC;IAEJ,2FAA2F;IAC3F,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,EAAE,UAAU,EAAE,SAAS;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,UAAU,EAAE,CAQ7I;IAED,IAAI,KAAK,IAAI,MAAM,CAGlB;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,EAAE,CAgC1C;IAED,sGAAsG;IACtG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAWpC;IAED,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMzD;IAED,SAAS,CAAC,IAAI,IAAI,WAAW,EAAE,CAgB9B;IAED,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAS9C;IAED,0EAA0E;IAC1E,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAyB1E;CACJ"}

package/lib/docs/docs-index.js

@@ -0,0 +1,140 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+/**
+ * Searches the Markdown that ships with the installed components and toolchain modules (README.md
+ * and `docs/` of each component, `cell.addDocs()` directories), so agents read the docs of the
+ * versions the project uses (docs/design/agent-first.md R7). Sections are ranked by how many query
+ * words they contain, headings counting more.
+ */
+export class DocsIndex {
+    root;
+    sources;
+    static MAX_TEXT = 1500;
+    static MAX_FILES = 2000;
+    sections;
+    fileCount = 0;
+    constructor(root, sources) {
+        this.root = root;
+        this.sources = sources;
+    }
+    /** README.md and docs/ of each component directory, then the modules' docs directories. */
+    static sourcesOf(components, moduleDocs) {
+        return [
+            ...components.flatMap(c => [
+                { path: join(c.dir, 'README.md'), source: c.name },
+                { path: join(c.dir, 'docs'), source: c.name },
+            ]),
+            ...moduleDocs.map(d => ({ path: d.value, source: d.source })),
+        ].filter(s => existsSync(s.path));
+    }
+    get files() {
+        this.load();
+        return this.fileCount;
+    }
+    search(query, limit = 5) {
+        const terms = DocsIndex.terms(query);
+        if (terms.length === 0) {
+            return [];
+        }
+        const hits = [];
+        for (const section of this.load()) {
+            const title = section.title.toLowerCase();
+            const body = section.text.toLowerCase();
+            let score = 0;
+            let matched = 0;
+            for (const term of terms) {
+                const inTitle = DocsIndex.count(title, term);
+                const inBody = Math.min(DocsIndex.count(body, term), 10);
+                if (inTitle + inBody > 0) {
+                    matched++;
+                    score += inTitle * 5 + inBody;
+                }
+            }
+            if (matched > 0) {
+                // Sections with every word come first.
+                score = Math.round(score * (matched / terms.length) ** 2 * 100) / 100;
+                const truncated = section.text.length > DocsIndex.MAX_TEXT;
+                hits.push({
+                    ...section,
+                    score,
+                    text: truncated ? `${section.text.slice(0, DocsIndex.MAX_TEXT)}…` : section.text,
+                    ...(truncated ? { truncated: true } : {}),
+                });
+            }
+        }
+        return hits.sort((a, b) => b.score - a.score || a.file.localeCompare(b.file) || a.line - b.line).slice(0, limit);
+    }
+    /** Lowercased words of the query; words of two characters or fewer only when nothing else is left. */
+    static terms(query) {
+        const words = [
+            ...new Set(query
+                .toLowerCase()
+                .split(/[\s,;:!?()[\]{}"'\x60]+/)
+                .filter(Boolean)),
+        ];
+        const long = words.filter(w => w.length > 2);
+        return long.length > 0 ? long : words;
+    }
+    static count(text, term) {
+        let n = 0;
+        for (let i = text.indexOf(term); i !== -1; i = text.indexOf(term, i + term.length)) {
+            n++;
+        }
+        return n;
+    }
+    load() {
+        if (!this.sections) {
+            this.sections = [];
+            const seen = new Set();
+            for (const { path, source } of this.sources) {
+                for (const file of this.markdownFiles(path)) {
+                    if (seen.has(file) || seen.size >= DocsIndex.MAX_FILES) {
+                        continue;
+                    }
+                    seen.add(file);
+                    this.sections.push(...DocsIndex.split(readFileSync(file, 'utf8'), relative(this.root, file) || file, source));
+                }
+            }
+            this.fileCount = seen.size;
+        }
+        return this.sections;
+    }
+    markdownFiles(path) {
+        if (statSync(path).isFile()) {
+            return /\.mdx?$/i.test(path) ? [path] : [];
+        }
+        return readdirSync(path, { recursive: true })
+            .filter(name => /\.mdx?$/i.test(name) && !name.split(/[\\/]/).includes('node_modules'))
+            .map(name => join(path, name))
+            .filter(file => statSync(file).isFile())
+            .sort();
+    }
+    /** Splits Markdown at headings, ignoring `#` lines inside fenced code. */
+    static split(markdown, file, source) {
+        const sections = [];
+        let current = { file, line: 1, title: file, source, text: '' };
+        const lines = [];
+        let fence = false;
+        const flush = () => {
+            current.text = lines.join('\n').trim();
+            if (current.text || current.title !== file) {
+                sections.push(current);
+            }
+            lines.length = 0;
+        };
+        markdown.split(/\r?\n/).forEach((line, i) => {
+            if (/^\s*(\x60\x60\x60|~~~)/.test(line)) {
+                fence = !fence;
+            }
+            const heading = fence ? null : /^#{1,6}\s+(.+?)\s*#*\s*$/.exec(line);
+            if (heading) {
+                flush();
+                current = { file, line: i + 1, title: heading[1], source, text: '' };
+            }
+            lines.push(line);
+        });
+        flush();
+        return sections;
+    }
+}
+//# sourceMappingURL=docs-index.js.map

package/lib/docs/docs-index.js.map

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

package/lib/docs/docs-index.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=docs-index.spec.d.ts.map

package/lib/docs/docs-index.spec.d.ts.map

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

package/lib/docs/docs-index.spec.js

@@ -0,0 +1,52 @@
+import { afterAll, describe, expect, it } from 'bun:test';
+import { CellCli } from '../cli/cell-cli.js';
+import { FixtureProject } from '../test/fixture-project.js';
+import { DocsIndex } from './docs-index.js';
+describe('DocsIndex', () => {
+    it('splits Markdown at headings, not at # lines of code blocks', () => {
+        const sections = DocsIndex.split(['intro', '# Title', 'text', '\x60\x60\x60sh', '# a comment', '\x60\x60\x60', '## Sub ##', 'more'].join('\n'), 'a.md', 'x');
+        expect(sections.map(s => [s.title, s.line])).toEqual([
+            ['a.md', 1],
+            ['Title', 2],
+            ['Sub', 7],
+        ]);
+        expect(sections[1].text).toBe('# Title\ntext\n\x60\x60\x60sh\n# a comment\n\x60\x60\x60');
+    });
+    it('drops short words unless nothing else is left', () => {
+        expect(DocsIndex.terms('How to use @Transactional in typeorm?')).toEqual(['how', 'use', '@transactional', 'typeorm']);
+        expect(DocsIndex.terms('DI')).toEqual(['di']);
+    });
+});
+describe('cell docs', () => {
+    const fixture = new FixtureProject('cli-docs')
+        .file('package.json', { name: 'cli-docs', dependencies: { '@x/orm': '*' } })
+        .dependency('@x/orm', { cell: { toolchain: 'module.mjs' } }, {
+        'README.md': '# @x/orm\n\nAn ORM component.\n\n## Transactions\n\nUse @Transactional on a method; transactions roll back on errors.\n',
+        'docs/entities.md': '# Entities\n\nDeclare entities in cell.yml.\n',
+        'module.mjs': "export default cell => { cell.addDocs('guide'); };\n",
+        'guide/AGENTS.md': '# Agent guide\n\nRun cell check after adding an entity.\n',
+    })
+        .file('README.md', '# cli-docs\n\nThe app.\n');
+    afterAll(() => fixture.dispose());
+    async function docs(...args) {
+        let stdout = '';
+        const code = await new CellCli({ stdout: { write: s => (stdout += s) }, stderr: { write: () => true } }).run(['docs', ...args, '--root', fixture.root]);
+        return { code, stdout };
+    }
+    it('finds sections in README, docs/ and module docs with file and line, best first', async () => {
+        const { code, stdout } = await docs('transactional', 'transactions', '--json');
+        expect(code).toBe(0);
+        const json = JSON.parse(stdout);
+        expect(json).toMatchObject({ command: 'docs', ok: true, query: 'transactional transactions', files: 4 });
+        expect(json.results[0]).toMatchObject({ file: 'node_modules/@x/orm/README.md', line: 5, title: 'Transactions', source: '@x/orm' });
+        const entity = JSON.parse((await docs('entity', '--json')).stdout);
+        expect(entity.results.map((r) => r.file)).toEqual(['node_modules/@x/orm/guide/AGENTS.md']);
+    });
+    it('prints sections as text, says when nothing matches, and checks its arguments', async () => {
+        expect((await docs('entities', '--limit', '1')).stdout).toBe('── node_modules/@x/orm/docs/entities.md:1 (@x/orm)\n# Entities\n\nDeclare entities in cell.yml.\n');
+        expect((await docs('kubernetes')).stdout).toBe("No section of 4 doc files matches 'kubernetes'.\n");
+        expect((await docs()).code).toBe(2);
+        expect((await docs('x', '--limit', '0')).code).toBe(2);
+    });
+});
+//# sourceMappingURL=docs-index.spec.js.map

package/lib/docs/docs-index.spec.js.map

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

package/lib/events/event-bus.d.ts

@@ -0,0 +1,30 @@
+import { CellError, type CellEventName, type GateResult } from '@celljs/kit';
+export type EventHandler = (event: any) => unknown;
+interface Subscription {
+    handler: EventHandler;
+    /** Who registered the handler: a module name or `hooks`; reported when it fails. */
+    source: string;
+}
+/**
+ * Dispatches toolchain events by the fixed rule of each event (docs/design/modules.md §3.2). Handlers
+ * run one after another in registration order; a dispatch works on a snapshot of the handlers.
+ */
+export declare class EventBus {
+    protected readonly onNotifyError?: ((error: CellError) => void) | undefined;
+    protected readonly handlers: Map<"build:before" | "build:done" | "close" | "config:resolved" | "deploy:before" | "deploy:done" | "deploy:plan" | "dev:ready" | "dev:reload" | "modules:done" | "output:done", Subscription[]>;
+    /**
+     * @param onNotifyError where failures of notification handlers go instead of failing the dispatch:
+     * `cell dev` keeps running (docs/design/modules.md §3.4); builds leave it unset and fail.
+     */
+    constructor(onNotifyError?: ((error: CellError) => void) | undefined);
+    on(event: CellEventName, handler: EventHandler, source?: string): () => void;
+    /** Notification and mutation events: every handler runs; the first failure stops the dispatch. */
+    emit<E extends object>(event: CellEventName, payload: E): Promise<E>;
+    /** Gate events: the first handler returning `{ cancel: true }` or throwing (fail closed) stops the operation. */
+    gate(event: CellEventName, payload: object): Promise<GateResult | undefined>;
+    protected snapshot(event: CellEventName): Subscription[];
+    /** Cell errors keep their code; anything else becomes `CELL_MODULE_ERROR` naming the source. */
+    static handlerError(event: CellEventName, source: string, error: unknown): CellError;
+}
+export {};
+//# sourceMappingURL=event-bus.d.ts.map

package/lib/events/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/events/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAe,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1F,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC;AAEnD,UAAU,YAAY;IAClB,OAAO,EAAE,YAAY,CAAC;IACtB,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,QAAQ;IAOL,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI;IANzE,SAAS,CAAC,QAAQ,CAAC,QAAQ,mMAA4C;IAEvE;;;OAGG;IACH,YAA+B,aAAa,CAAC,GAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,aAAA,EAAI;IAE7E,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAY,GAAG,MAAM,IAAI,CAS9E;IAED,kGAAkG;IAC5F,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAiBzE;IAED,iHAAiH;IAC3G,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAoBjF;IAED,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,EAAE,CAEvD;IAED,gGAAgG;IAChG,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,CAUnF;CACJ"}

package/lib/events/event-bus.js

@@ -0,0 +1,81 @@
+import { CellError, EVENT_RULES } from '@celljs/kit';
+/**
+ * Dispatches toolchain events by the fixed rule of each event (docs/design/modules.md §3.2). Handlers
+ * run one after another in registration order; a dispatch works on a snapshot of the handlers.
+ */
+export class EventBus {
+    onNotifyError;
+    handlers = new Map();
+    /**
+     * @param onNotifyError where failures of notification handlers go instead of failing the dispatch:
+     * `cell dev` keeps running (docs/design/modules.md §3.4); builds leave it unset and fail.
+     */
+    constructor(onNotifyError) {
+        this.onNotifyError = onNotifyError;
+    }
+    on(event, handler, source = 'unknown') {
+        const list = this.handlers.get(event) ?? [];
+        const subscription = { handler, source };
+        this.handlers.set(event, [...list, subscription]);
+        return () => this.handlers.set(event, (this.handlers.get(event) ?? []).filter(s => s !== subscription));
+    }
+    /** Notification and mutation events: every handler runs; the first failure stops the dispatch. */
+    async emit(event, payload) {
+        if (EVENT_RULES[event] === 'gate') {
+            throw new Error(`${event} is a gate event; dispatch it with gate().`);
+        }
+        for (const { handler, source } of this.snapshot(event)) {
+            try {
+                await handler(payload);
+            }
+            catch (error) {
+                const failure = EventBus.handlerError(event, source, error);
+                if (this.onNotifyError && EVENT_RULES[event] === 'notify') {
+                    this.onNotifyError(failure);
+                    continue;
+                }
+                throw failure;
+            }
+        }
+        return payload;
+    }
+    /** Gate events: the first handler returning `{ cancel: true }` or throwing (fail closed) stops the operation. */
+    async gate(event, payload) {
+        if (EVENT_RULES[event] !== 'gate') {
+            throw new Error(`${event} is not a gate event; dispatch it with emit().`);
+        }
+        for (const { handler, source } of this.snapshot(event)) {
+            let result;
+            try {
+                result = await handler(payload);
+            }
+            catch (error) {
+                return {
+                    cancel: true,
+                    reason: `${source} failed on ${event}: ${CellError.is(error) ? error.message : String(error?.message ?? error)}`,
+                };
+            }
+            const gate = result;
+            if (gate?.cancel === true) {
+                return { cancel: true, reason: gate.reason ?? `cancelled by ${source}` };
+            }
+        }
+        return undefined;
+    }
+    snapshot(event) {
+        return [...(this.handlers.get(event) ?? [])];
+    }
+    /** Cell errors keep their code; anything else becomes `CELL_MODULE_ERROR` naming the source. */
+    static handlerError(event, source, error) {
+        if (CellError.is(error)) {
+            return error;
+        }
+        return new CellError({
+            code: 'CELL_MODULE_ERROR',
+            message: `${source} failed on ${event}: ${error?.message ?? String(error)}`,
+            hint: `Fix the ${event} handler of ${source}.`,
+            cause: error,
+        });
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/lib/events/event-bus.js.map

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

package/lib/events/event-bus.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=event-bus.spec.d.ts.map

package/lib/events/event-bus.spec.d.ts.map

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