@ifc-lite/flow-nodes 0.6.0 → 0.9.0

package/dist/bcf-publication-store.d.ts

@@ -0,0 +1,40 @@
+import type { NativeBcfOwnerStatus, NativeBcfPublicationEntry, NativeBcfPublicationPageOptions, StoredBcfAttempt, StoredBcfCheck, StoredBcfOutcome } from './bcf-publication-types.js';
+export interface LoadedAttempt {
+    attempt: StoredBcfAttempt;
+    outcome?: StoredBcfOutcome;
+    checks: StoredBcfCheck[];
+    reconciled?: StoredBcfOutcome;
+    ownerStatus: NativeBcfOwnerStatus;
+    ownerConfirmed?: boolean;
+    checkPending?: boolean;
+}
+export declare function entryOf(item: LoadedAttempt, sendFinished?: boolean): NativeBcfPublicationEntry;
+/** Immutable fsynced v2 records. No receipt, capacity slot or predecessor is ever deleted. */
+export declare class BcfPublicationStore {
+    readonly directory: string;
+    constructor(directory: string);
+    private bucket;
+    private path;
+    prepare(): Promise<void>;
+    private syncDirectory;
+    private publishAt;
+    publish(filename: string, value: unknown, secrets?: readonly string[], onLinked?: () => void): Promise<void>;
+    private readAt;
+    private epochPath;
+    private epochRead;
+    private checks;
+    ensureEpoch(attempt: StoredBcfAttempt, previous?: StoredBcfCheck, secrets?: readonly string[]): Promise<void>;
+    private names;
+    load(digest: string, targetId?: string, secrets?: readonly string[]): Promise<LoadedAttempt[]>;
+    /** Acknowledgment follows one fsync AFTER all verified root reads; no receipt escapes before it. */
+    private history;
+    /** Weakly consistent pages: a cursor progresses at the work/byte bound, even without rows. */
+    page(options?: NativeBcfPublicationPageOptions, secrets?: readonly string[]): Promise<{
+        entries: NativeBcfPublicationEntry[];
+        nextCursor: string;
+    } | {
+        entries: NativeBcfPublicationEntry[];
+        nextCursor?: undefined;
+    }>;
+}
+//# sourceMappingURL=bcf-publication-store.d.ts.map

package/dist/bcf-publication-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bcf-publication-store.d.ts","sourceRoot":"","sources":["../src/bcf-publication-store.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,+BAA+B,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEvL,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,WAAW,EAAE,oBAAoB,CAAC;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,YAAY,UAAQ,GAAG,yBAAyB,CAO5F;AAED,8FAA8F;AAC9F,qBAAa,mBAAmB;IAClB,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;IACtC,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,IAAI;IACN,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAyBhB,aAAa;YAIb,SAAS;IAoBjB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,SAAS,MAAM,EAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YAoBxG,MAAM;IAcpB,OAAO,CAAC,SAAS;YACH,SAAS;IASvB,OAAO,CAAC,MAAM;IAMR,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE,cAAc,EAAE,OAAO,GAAE,SAAS,MAAM,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YAgBzG,KAAK;IAoBb,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,SAAS,MAAM,EAAO,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAMxG,oGAAoG;YACtF,OAAO;IAQrB,8FAA8F;IACxF,IAAI,CAAC,OAAO,GAAE,+BAAoC,EAAE,OAAO,GAAE,SAAS,MAAM,EAAO;;;;;;;CAwD1F"}

package/dist/bcf-publication-store.js

@@ -0,0 +1,312 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { Buffer } from 'node:buffer';
+import { constants } from 'node:fs';
+import { link, lstat, mkdir, open, opendir, unlink } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { credentialFree, MAX_GENERATIONS, MAX_RECORD_BYTES, MAX_RECORDS, NATIVE_METADATA, record, refuse } from './bcf-publication-codec.js';
+import { epochOf, loadCheckEpoch, verifyCheckEpoch } from './bcf-publication-epochs.js';
+import { loadBcfHistory } from './bcf-publication-history.js';
+import { capacityDigest, DIGEST_SLOTS, reserveDigest } from './bcf-publication-capacity.js';
+const errorCode = (error) => record(error) ? error.code : undefined;
+export function entryOf(item, sendFinished = false) {
+    const outcome = item.reconciled ?? item.outcome;
+    const check = item.checks.at(-1)?.check;
+    return { id: item.attempt.id, intent: item.attempt.intent, queuedAt: item.attempt.queuedAt,
+        state: outcome?.state ?? (item.ownerStatus === 'alive' && !sendFinished ? NATIVE_METADATA.state.sending : NATIVE_METADATA.state.uncertain),
+        ...(outcome?.receipt ? { receipt: outcome.receipt } : {}), ...(outcome?.failure ? { failure: outcome.failure } : {}),
+        ...(check ? { check } : {}), ...(!outcome ? { ownerStatus: item.ownerStatus } : {}) };
+}
+/** Immutable fsynced v2 records. No receipt, capacity slot or predecessor is ever deleted. */
+export class BcfPublicationStore {
+    directory;
+    constructor(directory) {
+        this.directory = directory;
+    }
+    bucket(prefix) { return join(this.directory, 'v2', prefix); }
+    path(digest) { return join(this.bucket(digest.slice(0, 2)), digest); }
+    async prepare() {
+        const ancestors = [];
+        for (let path = this.directory;; path = dirname(path)) {
+            if (ancestors.length >= 128)
+                refuse('configured outbox exceeds directory depth bound');
+            ancestors.push(path);
+            if (dirname(path) === path)
+                break;
+        }
+        const firstCreated = await mkdir(this.directory, { recursive: true, mode: 0o700 });
+        if (!(await lstat(this.directory)).isDirectory())
+            refuse('invalid namespace directory');
+        const entries = await opendir(this.directory);
+        for await (const item of entries) {
+            if (item.name !== 'v2' || !item.isDirectory()) {
+                refuse('old flat publication layout: preserve this outbox; recover with its original build before selecting a new empty outbox');
+            }
+        }
+        await mkdir(join(this.directory, 'v2'), { recursive: true, mode: 0o700 });
+        await this.syncDirectory(join(this.directory, 'v2'));
+        // Existing ancestors may have just been created by a different first-use writer.
+        // Persist every parent entry before effects, not only the mkdir winner's subtree.
+        if (firstCreated !== undefined && !ancestors.includes(firstCreated))
+            refuse('created namespace ancestor identity mismatch');
+        for (const path of ancestors) {
+            if (!(await lstat(path)).isDirectory())
+                refuse('invalid publication ancestor');
+            await this.syncDirectory(path);
+        }
+    }
+    async syncDirectory(directory) {
+        const handle = await open(directory, constants.O_RDONLY | constants.O_DIRECTORY);
+        try {
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    async publishAt(directory, filename, value, prefix, onLinked) {
+        const bytes = JSON.stringify(value);
+        if (Buffer.byteLength(bytes) > MAX_RECORD_BYTES)
+            refuse('record exceeds storage bound');
+        credentialFree(value, []);
+        // Temporary debris stays outside the bounded per-digest recovery history.
+        // Same-filesystem hardlink publication remains exclusive; no active temporary is deleted by recovery.
+        if (!/^[a-f0-9]{2}$/.test(prefix))
+            refuse('invalid temporary bucket prefix');
+        const temporary = join(this.bucket(prefix), `.tmp-${randomUUID()}`);
+        const handle = await open(temporary, 'wx', 0o600);
+        try {
+            await handle.writeFile(bytes);
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        try {
+            await link(temporary, join(directory, filename));
+            onLinked?.();
+            await this.syncDirectory(directory);
+        }
+        finally {
+            try {
+                await unlink(temporary);
+            }
+            catch (error) {
+                if (errorCode(error) !== 'ENOENT')
+                    console.warn('[BCF publication] Could not remove temporary intent file', error);
+            }
+        }
+    }
+    async publish(filename, value, secrets = [], onLinked) {
+        credentialFree(value, secrets);
+        if (!/^[a-f0-9]{64}-[1-9][0-9]*\.(?:intent|outcome|owner-stopped|(?:check|checked)-[1-9][0-9]{0,15})\.json$/.test(filename))
+            refuse('invalid publication filename');
+        const digest = filename.slice(0, 64);
+        const bucket = this.bucket(digest.slice(0, 2));
+        await mkdir(bucket, { recursive: true, mode: 0o700 });
+        if (!(await lstat(bucket)).isDirectory())
+            refuse('invalid digest bucket');
+        await this.syncDirectory(join(this.directory, 'v2'));
+        await reserveDigest(bucket, digest, (directory, file, value) => {
+            credentialFree(value, secrets);
+            return this.publishAt(directory, file, value, digest.slice(0, 2));
+        }, (directory, file) => this.readAt(directory, file, false), this.syncDirectory.bind(this));
+        const path = this.path(digest);
+        await mkdir(path, { recursive: true, mode: 0o700 });
+        if (!(await lstat(path)).isDirectory())
+            refuse('invalid publication directory');
+        await this.syncDirectory(bucket);
+        const check = /\.(?:check|checked)-([1-9][0-9]*)\.json$/.exec(filename);
+        await this.publishAt(check ? this.epochPath(filename.slice(0, filename.indexOf('.')), epochOf(check[1])) : path, filename, value, digest.slice(0, 2), filename.endsWith('.intent.json') ? onLinked : undefined);
+    }
+    async readAt(directory, filename, syncEntry = true) {
+        const handle = await open(join(directory, filename), constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+        try {
+            const stat = await handle.stat();
+            if (!stat.isFile() || stat.size > MAX_RECORD_BYTES)
+                refuse('invalid or oversized stored record');
+            const bytes = Buffer.alloc(MAX_RECORD_BYTES + 1);
+            const result = await handle.read(bytes, 0, bytes.length, 0);
+            if (result.bytesRead > MAX_RECORD_BYTES)
+                refuse('record exceeds storage bound');
+            // A prior publisher may have linked this visible record before its directory fsync failed.
+            // Repair that durability boundary before acknowledging a receipt or recovery proof.
+            if (syncEntry)
+                await this.syncDirectory(directory);
+            return JSON.parse(bytes.subarray(0, result.bytesRead).toString('utf8'));
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    epochPath(id, epoch) { return join(this.path(id.slice(0, 64)), `${id}.epochs`, String(epoch)); }
+    async epochRead(id, epoch, filename) {
+        const directory = this.epochPath(id, epoch);
+        for (const path of [join(directory, '..'), directory]) {
+            if (!(await lstat(path)).isDirectory())
+                refuse('invalid recovery epoch directory');
+        }
+        const value = await this.readAt(directory, filename);
+        await this.syncDirectory(join(directory, '..'));
+        return value;
+    }
+    checks(attempt, secrets) {
+        return loadCheckEpoch(attempt, async (epoch, filename) => {
+            const value = await this.epochRead(attempt.id, epoch, filename);
+            credentialFree(value, secrets);
+            return value;
+        });
+    }
+    async ensureEpoch(attempt, previous, secrets = []) {
+        const nextId = String(Number(previous?.checkId ?? 0) + 1), epoch = epochOf(nextId);
+        const expected = { version: 1, id: attempt.id, digest: attempt.digest, epoch,
+            ...(epoch > 1 ? { previous } : {}) };
+        credentialFree(expected, secrets);
+        const directory = this.epochPath(attempt.id, epoch);
+        await mkdir(directory, { recursive: true, mode: 0o700 });
+        for (const path of [join(directory, '..'), directory]) {
+            if (!(await lstat(path)).isDirectory())
+                refuse('invalid recovery epoch directory');
+        }
+        await this.syncDirectory(join(directory, '..'));
+        await this.syncDirectory(this.path(attempt.digest));
+        try {
+            await this.publishAt(directory, 'marker.json', expected, attempt.digest.slice(0, 2));
+        }
+        catch (error) {
+            if (errorCode(error) !== 'EEXIST')
+                throw error;
+        }
+        verifyCheckEpoch(await this.epochRead(attempt.id, epoch, 'marker.json'), expected, attempt);
+        await this.syncDirectory(directory);
+    }
+    async names(digest, syncBucket = true) {
+        if (!/^[a-f0-9]{64}$/.test(digest))
+            refuse('invalid publication digest');
+        const path = this.path(digest);
+        try {
+            if (!(await lstat(this.bucket(digest.slice(0, 2)))).isDirectory())
+                refuse('invalid digest bucket');
+            if (!(await lstat(path)).isDirectory())
+                refuse('invalid publication directory');
+        }
+        catch (error) {
+            if (errorCode(error) === 'ENOENT')
+                return [];
+            throw error;
+        }
+        if (syncBucket)
+            await this.syncDirectory(this.bucket(digest.slice(0, 2)));
+        await this.syncDirectory(path);
+        const names = [];
+        const directory = await opendir(path);
+        for await (const item of directory) {
+            if (names.length >= MAX_RECORDS)
+                refuse('publication record limit reached');
+            if ((!item.isFile() && !(item.isDirectory() && item.name.endsWith('.epochs'))) || !/^(?:\.tmp-[a-f0-9-]{36}|[a-f0-9]{64}-[1-9][0-9]*\.(?:(?:intent|outcome|owner-stopped)\.json|epochs))$/.test(item.name)
+                || (!item.name.startsWith('.tmp-') && !item.name.startsWith(`${digest}-`)))
+                refuse('unrecognized publication state');
+            names.push(item.name);
+        }
+        return names;
+    }
+    async load(digest, targetId, secrets = []) {
+        await this.prepare();
+        const selected = await this.history(await this.names(digest), digest, targetId, secrets);
+        return selected ? [selected] : [];
+    }
+    /** Acknowledgment follows one fsync AFTER all verified root reads; no receipt escapes before it. */
+    async history(names, digest, targetId, secrets, visit) {
+        const selected = await loadBcfHistory(names, name => this.readAt(this.path(digest), name, false), attempt => this.checks(attempt, secrets), targetId, secrets, visit);
+        if (names.length)
+            await this.syncDirectory(this.path(digest));
+        return selected;
+    }
+    /** Weakly consistent pages: a cursor progresses at the work/byte bound, even without rows. */
+    async page(options = {}, secrets = []) {
+        await this.prepare();
+        const limit = options.limit ?? 100;
+        if (!Number.isSafeInteger(limit) || limit < 1 || limit > 1_000)
+            refuse('page limit must be between 1 and 1000');
+        const match = options.cursor === undefined ? ['00:0:0', '00', '0', '0'] : /^([a-f0-9]{2}):([0-9]{1,4}):([0-9]{1,3})$/.exec(options.cursor);
+        if (!match || Number(match[2]) >= DIGEST_SLOTS || Number(match[3]) > MAX_GENERATIONS)
+            refuse('invalid page cursor');
+        let prefix = Number.parseInt(match[1], 16), slot = Number(match[2]), generation = Number(match[3]);
+        let work = 0, bytes = 0;
+        const entries = [];
+        const cursor = () => `${prefix.toString(16).padStart(2, '0')}:${slot}:${generation}`;
+        while (prefix < 256) {
+            const bucket = this.bucket(prefix.toString(16).padStart(2, '0'));
+            try {
+                if (!(await lstat(bucket)).isDirectory())
+                    refuse('invalid digest bucket');
+            }
+            catch (error) {
+                if (errorCode(error) !== 'ENOENT')
+                    throw error;
+                prefix += 1;
+                slot = 0;
+                generation = 0;
+                continue;
+            }
+            try {
+                while (slot < DIGEST_SLOTS) {
+                    if (work >= 50_000 || entries.length >= limit)
+                        return { entries, nextCursor: cursor() };
+                    work += 1;
+                    let digest;
+                    try {
+                        digest = capacityDigest(await this.readAt(bucket, `slot-${slot}.json`, false));
+                    }
+                    catch (error) {
+                        if (errorCode(error) !== 'ENOENT')
+                            throw error;
+                        break; // Claims fill the first free slot and are never deleted: no holes.
+                    }
+                    if (!digest.startsWith(prefix.toString(16).padStart(2, '0')))
+                        refuse('capacity bucket identity mismatch');
+                    const names = await this.names(digest, false);
+                    // Each attempt: <=106 marker probes, 32 event probes and bounded root reads.
+                    const attempts = names.filter(name => name.endsWith('.intent.json')).length;
+                    if (attempts > MAX_GENERATIONS)
+                        refuse('excessive attempt generations');
+                    const cost = 2 * names.length + 142 * attempts;
+                    if (work + cost > 50_000)
+                        return { entries, nextCursor: cursor() };
+                    work += cost;
+                    let stopped = false;
+                    // Validate one history once, retaining only bounded public rows and current history state.
+                    await this.history(names, digest, undefined, secrets, item => {
+                        if (stopped || item.attempt.generation <= generation)
+                            return;
+                        const entry = entryOf(item);
+                        const size = Buffer.byteLength(JSON.stringify(entry));
+                        if (entries.length >= limit || bytes + size > 5 * 1024 * 1024) {
+                            stopped = true;
+                            return;
+                        }
+                        entries.push(entry);
+                        bytes += size;
+                        generation = item.attempt.generation;
+                    });
+                    if (stopped)
+                        return { entries, nextCursor: cursor() };
+                    slot += 1;
+                    generation = 0;
+                }
+            }
+            finally {
+                // Persist all observed slot and digest links AFTER these reads, including
+                // concurrent links observed after entering the bucket, before any return.
+                await this.syncDirectory(bucket);
+            }
+            prefix += 1;
+            slot = 0;
+            generation = 0;
+        }
+        return { entries };
+    }
+}
+//# sourceMappingURL=bcf-publication-store.js.map

package/dist/bcf-publication-store.js.map

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

package/dist/bcf-publication-types.d.ts

@@ -0,0 +1,105 @@
+import type { Capability } from '@ifc-lite/extensions';
+import type { FetchTransport } from '@ifc-lite/sandbox';
+import type { BcfWriteGateway, BcfWriteIntent } from './bcf-write-gateway.js';
+import type { BcfPublicationFailure } from './bcf-publication.js';
+export interface NativeBcfPublicationOptions {
+    directory?: string;
+    /** Storage isolation, e.g. a stable authenticated MCP principal. Never a credential. */
+    namespace?: string;
+    /** Known run secrets: an intent containing one is refused before persistence. */
+    secrets?: readonly string[];
+}
+export interface NativeBcfPublicationCheckOptions {
+    token?: string;
+    networkGrants: readonly Capability[];
+    signal?: AbortSignal;
+    networkTransport?: FetchTransport;
+    /** Operator confirms an unverifiable owner stopped; never overrides an observed live process. */
+    confirmOwnerStopped?: boolean;
+    /** Operator asserts this read sees the complete target collection in the original write access scope. */
+    confirmFullReadAccess?: boolean;
+}
+export type NativeBcfOwnerStatus = 'alive' | 'dead' | 'unknown';
+export interface NativeBcfPublicationCheck {
+    at: string;
+    /** A match remains a candidate until an explicit reconciliation. */
+    result: 'ambiguous' | 'absent' | 'unavailable';
+    candidates: {
+        guid: string;
+    }[];
+    /** Present only on complete absence proven under an explicit full-visibility assertion. */
+    fullReadAccessConfirmed?: true;
+}
+export interface NativeBcfPublicationEntry {
+    id: string;
+    intent: BcfWriteIntent;
+    state: 'sending' | 'uncertain' | 'failed' | 'done';
+    queuedAt: string;
+    receipt?: {
+        remoteGuid: string;
+        at: string;
+        evidence: 'response' | 'reconciled';
+    };
+    failure?: BcfPublicationFailure;
+    check?: NativeBcfPublicationCheck;
+    ownerStatus?: NativeBcfOwnerStatus;
+}
+export interface NativeBcfPublicationPage {
+    entries: NativeBcfPublicationEntry[];
+    nextCursor?: string;
+}
+export interface NativeBcfPublicationPageOptions {
+    cursor?: string;
+    limit?: number;
+}
+export interface NativeBcfWriteGateway extends BcfWriteGateway {
+    list(): Promise<NativeBcfPublicationEntry[]>;
+    listPage(options?: NativeBcfPublicationPageOptions): Promise<NativeBcfPublicationPage>;
+    check(entryId: string, options: NativeBcfPublicationCheckOptions): Promise<NativeBcfPublicationEntry>;
+    reconcile(entryId: string, candidateGuid: string): Promise<NativeBcfPublicationEntry>;
+    /** Explicitly release an unresolved intent after the latest successful check found no effect. */
+    confirmAbsent(entryId: string): Promise<NativeBcfPublicationEntry>;
+}
+/** Stored immutable attempt; PID ownership is conservative and never stolen. */
+export interface StoredBcfAttempt {
+    version: 1;
+    id: string;
+    digest: string;
+    generation: number;
+    intent: BcfWriteIntent;
+    queuedAt: string;
+    owner: {
+        pid: number;
+        host: string;
+        boot?: string;
+        domain?: string;
+        instance?: string;
+    };
+}
+export interface StoredBcfOwnerConfirmation {
+    version: 1;
+    id: string;
+    digest: string;
+    at: string;
+    assertion: 'owner-stopped';
+}
+export interface StoredBcfOutcome {
+    version: 1;
+    id: string;
+    digest: string;
+    state: 'done' | 'failed' | 'uncertain';
+    receipt?: NativeBcfPublicationEntry['receipt'];
+    failure?: BcfPublicationFailure;
+}
+export interface StoredBcfCheck {
+    version: 1;
+    id: string;
+    digest: string;
+    checkId: string;
+    check: NativeBcfPublicationCheck;
+    settlement?: {
+        outcome: StoredBcfOutcome;
+        proofCheckId: string;
+    };
+}
+//# sourceMappingURL=bcf-publication-types.d.ts.map

package/dist/bcf-publication-types.d.ts.map

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

package/dist/bcf-publication-types.js

@@ -0,0 +1,5 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+export {};
+//# sourceMappingURL=bcf-publication-types.js.map

package/dist/bcf-publication-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bcf-publication-types.js","sourceRoot":"","sources":["../src/bcf-publication-types.ts"],"names":[],"mappings":"AAAA;;+DAE+D"}

package/dist/bcf-publication.d.ts

@@ -0,0 +1,13 @@
+/** Credential-free failure shape shared with browser publication. */
+export interface BcfPublicationFailure {
+    code: 'auth' | 'permission' | 'vocabulary' | 'rejected' | 'no-response' | 'server-error' | 'conflict-exists' | 'interrupted' | 'confirmed-absent' | 'discarded';
+    message: string;
+    status?: number;
+    at: string;
+}
+/** Only valid 4xx refusals are definite; 409, other answers and unqualified denials remain uncertain. */
+export declare function classifyWriteError(error: unknown, at: string): {
+    state: 'failed' | 'uncertain';
+    failure: BcfPublicationFailure;
+};
+//# sourceMappingURL=bcf-publication.d.ts.map

package/dist/bcf-publication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bcf-publication.d.ts","sourceRoot":"","sources":["../src/bcf-publication.ts"],"names":[],"mappings":"AAIA,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,aAAa,GAAG,cAAc,GAAG,iBAAiB,GACxG,aAAa,GAAG,kBAAkB,GAAG,WAAW,CAAC;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,yGAAyG;AACzG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG;IAC9D,KAAK,EAAE,QAAQ,GAAG,WAAW,CAAC;IAAC,OAAO,EAAE,qBAAqB,CAAC;CAC/D,CAeA"}

package/dist/bcf-publication.js

@@ -0,0 +1,24 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/** Only valid 4xx refusals are definite; 409, other answers and unqualified denials remain uncertain. */
+export function classifyWriteError(error, at) {
+    const message = error instanceof Error ? error.message : String(error);
+    // Only typed preflight provenance proves that a request never left the host.
+    if (error instanceof Error && error.name === 'NetworkDeniedError'
+        && error.dispatched === false) {
+        return { state: 'failed', failure: { code: 'permission', message, at } };
+    }
+    const value = error instanceof Error && /ApiError$|AuthenticationError$/.test(error.name)
+        ? error.status : undefined;
+    const status = typeof value === 'number' && Number.isInteger(value) ? value : undefined;
+    if (status === undefined || status < 400 || status > 599)
+        return { state: 'uncertain', failure: { code: 'no-response', message, at } };
+    if (status >= 500)
+        return { state: 'uncertain', failure: { code: 'server-error', message, status, at } };
+    if (status === 409)
+        return { state: 'uncertain', failure: { code: 'conflict-exists', message, status, at } };
+    const code = status === 401 ? 'auth' : status === 403 ? 'permission' : 'rejected';
+    return { state: 'failed', failure: { code, message, status, at } };
+}
+//# sourceMappingURL=bcf-publication.js.map

package/dist/bcf-publication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bcf-publication.js","sourceRoot":"","sources":["../src/bcf-publication.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAW/D,yGAAyG;AACzG,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,EAAU;IAG3D,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,6EAA6E;IAC7E,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB;WAC3D,KAA0C,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;QACtE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC;IAC3E,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,IAAI,gCAAgC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QACvF,CAAC,CAAE,KAAsC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC;IACvI,IAAI,MAAM,IAAI,GAAG;QAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;IACzG,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;IAC7G,MAAM,IAAI,GAAG,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC;IAClF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;AACrE,CAAC"}

package/dist/bcf-write-gateway.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The one path every `bcf.*` write node takes to the server (#6896).
+ *
+ * A BCF create is not idempotent: a lost response after the server committed
+ * leaves a real topic or comment behind, and the node is `volatile`, so a
+ * plain rerun would create it again. A host that keeps durable publication
+ * state (the viewer) supplies `FlowHost.bcfWrites`: it records the intent
+ * before sending, the receipt after, and refuses to resend a write whose
+ * earlier attempt has an unknown outcome until someone reconciles it. A host
+ * without that state still never retries, and names the unknown outcome
+ * instead of reporting a plain failure.
+ */
+import type { BcfCommentWriteDto, BcfTopicWriteDto } from '@ifc-lite/bcf-api';
+import type { Ctx } from './host.js';
+/** What a node is about to write, without the bearer token. */
+export interface BcfWriteIntent {
+    readonly nodeType: string;
+    readonly operation: 'createTopic' | 'createComment';
+    /** Base URL up to but excluding the version segment, as the node was configured. */
+    readonly baseUrl: string;
+    readonly version: string;
+    readonly projectId: string;
+    /** The topic a comment is written to. */
+    readonly topicGuid?: string;
+    readonly payload: BcfTopicWriteDto | BcfCommentWriteDto;
+}
+/**
+ * Host-owned durable write path. `write` must persist the intent before
+ * calling `send`, persist the receipt or failure after, and reject without
+ * calling `send` when an identical earlier write is still unresolved.
+ */
+export interface BcfWriteGateway {
+    write<T extends {
+        guid: string;
+    }>(intent: BcfWriteIntent, send: () => Promise<T>, secrets?: readonly string[]): Promise<T>;
+}
+/** Send one write through the host gateway, or directly with explicit unknown-outcome reporting. */
+export declare function sendBcfWrite<T extends {
+    guid: string;
+}>(ctx: Ctx, intent: BcfWriteIntent, send: () => Promise<T>, secrets?: readonly string[]): Promise<T>;
+//# sourceMappingURL=bcf-write-gateway.d.ts.map

package/dist/bcf-write-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bcf-write-gateway.d.ts","sourceRoot":"","sources":["../src/bcf-write-gateway.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG9E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAKrC,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,eAAe,CAAC;IACpD,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,kBAAkB,CAAC;CACzD;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC5H;AAED,oGAAoG;AACpG,wBAAsB,YAAY,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAC3D,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,OAAO,GAAE,SAAS,MAAM,EAAO,GAC9B,OAAO,CAAC,CAAC,CAAC,CA4DZ"}