@spine-event-engine/proto-tools 2.0.0-snapshot.2

package/dist/src/index.js

@@ -0,0 +1,546 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+import { closeSync, constants, fstatSync, lstatSync, openSync, opendirSync, readFileSync, } from "node:fs";
+import { randomUUID } from "node:crypto";
+import { isAbsolute, join, normalize, sep } from "node:path";
+import { generationMarkerFile } from "./generation/generation-reuse.mjs";
+import { RegistryDependency } from "./model/registry-dependency.js";
+import { NpmPackageName } from "./model/npm-package-name.js";
+/**
+ * Published manifest JSON revision.
+ */
+export const manifestFormatVersion = 2;
+const configFormatVersion = 1;
+const manifestReadAttempts = 3;
+const manifestCommitDelayMs = 25;
+const generationClaimScanLimit = 1_000;
+function waitForManifestCommit() {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT)), 0, 0, manifestCommitDelayMs);
+}
+function hasLiveGenerationClaim(packageRoot) {
+    try {
+        const directory = opendirSync(packageRoot, { encoding: "utf8" });
+        try {
+            let entry;
+            const claimPaths = [];
+            while ((entry = directory.readSync()) !== null) {
+                if (!entry.name.startsWith(".spine-proto-generate.lock."))
+                    continue;
+                claimPaths.push(join(packageRoot, entry.name));
+                if (claimPaths.length > generationClaimScanLimit)
+                    throw new Error("generation claim count exceeds 1000");
+            }
+            for (const path of claimPaths) {
+                let descriptor;
+                let owner;
+                try {
+                    descriptor = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+                    if (!fstatSync(descriptor).isFile())
+                        throw new Error("generation claim is unsafe");
+                    owner = JSON.parse(readFileSync(descriptor, "utf8"));
+                }
+                catch (error) {
+                    if (error instanceof Error && error.message === "generation claim is unsafe")
+                        throw error;
+                    throw new Error("generation claim is unsafe", { cause: error });
+                }
+                finally {
+                    if (descriptor !== undefined)
+                        closeSync(descriptor);
+                }
+                if (typeof owner.pid !== "number" || owner.pid <= 0)
+                    continue;
+                try {
+                    process.kill(owner.pid, 0);
+                    return true;
+                }
+                catch (error) {
+                    if (error.code !== "ESRCH")
+                        return true;
+                }
+            }
+        }
+        finally {
+            directory.closeSync();
+        }
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            ["generation claim count exceeds 1000", "generation claim is unsafe"].includes(error.message))
+            throw error;
+        return false;
+    }
+    return false;
+}
+const reservedBindings = new Set([
+    "await",
+    "break",
+    "case",
+    "catch",
+    "class",
+    "const",
+    "continue",
+    "default",
+    "delete",
+    "do",
+    "else",
+    "enum",
+    "export",
+    "extends",
+    "false",
+    "finally",
+    "for",
+    "function",
+    "if",
+    "import",
+    "in",
+    "instanceof",
+    "let",
+    "new",
+    "null",
+    "return",
+    "super",
+    "switch",
+    "this",
+    "throw",
+    "true",
+    "try",
+    "typeof",
+    "var",
+    "void",
+    "while",
+    "with",
+    "yield",
+]);
+/**
+ * Reports invalid contained Proto package contracts.
+ */
+const ProtoPackageErrors = Object.freeze({
+    fail(name, message) {
+        throw new Error(`spine-proto: ${name}: ${message}`);
+    },
+});
+/**
+ * Reads, validates, and creates contained Proto package contracts.
+ */
+const ProtoPackage = Object.freeze({
+    // prettier-ignore
+    /**
+     * Reads and validates versioned `spine-proto.json` package configuration.
+     */
+    configFromPackage(packageRoot) {
+        const packageJson = ProtoPackage.readPackage(packageRoot);
+        const config = ProtoPackage.objectValue(packageJson.name, ProtoPackage.readJson(join(packageRoot, "spine-proto.json"), packageJson.name), "configuration");
+        if (config.formatVersion !== configFormatVersion)
+            ProtoPackageErrors.fail(packageJson.name, "formatVersion must be 1");
+        if (config.mode !== "model" && config.mode !== "application")
+            ProtoPackageErrors.fail(packageJson.name, "mode must be model or application");
+        if (config.mode === "application") {
+            ProtoPackage.rejectKeys(packageJson.name, config, ["formatVersion", "mode", "modelPackages", "registryOutput"], "application mode");
+            const modelPackages = ProtoPackage.packageNameList(packageJson.name, config.modelPackages, "modelPackages");
+            ProtoPackage.validateRegistryDependencies(packageJson, modelPackages, "model package");
+            const registryOutput = ProtoPackage.packagePath(packageRoot, packageJson.name, config.registryOutput, "registryOutput");
+            if (ProtoPackage.isReservedOutput(registryOutput))
+                ProtoPackageErrors.fail(packageJson.name, "registryOutput must name a safe source file");
+            return {
+                formatVersion: 1,
+                mode: "application",
+                modelPackages,
+                registryOutput,
+            };
+        }
+        ProtoPackage.rejectKeys(packageJson.name, config, [
+            "formatVersion",
+            "mode",
+            "packageName",
+            "protoRoot",
+            "generatedRoot",
+            "exportRoot",
+            "dependencies",
+            "moduleExport",
+        ], "model mode");
+        const packageName = ProtoPackage.packageNameValue(packageJson.name, config.packageName, "packageName");
+        if (packageName !== packageJson.name)
+            ProtoPackageErrors.fail(packageJson.name, "packageName must match package.json name");
+        const dependencies = ProtoPackage.packageNameList(packageJson.name, config.dependencies, "dependencies");
+        ProtoPackage.validateRegistryDependencies(packageJson, dependencies, "dependency");
+        const protoRoot = ProtoPackage.packagePath(packageRoot, packageJson.name, config.protoRoot, "protoRoot");
+        const generatedRoot = ProtoPackage.packagePath(packageRoot, packageJson.name, config.generatedRoot, "generatedRoot");
+        if (generatedRoot === "." ||
+            ["package.json", "spine-proto.json", "spine-proto-manifest.json"].includes(generatedRoot) ||
+            ProtoPackage.pathsOverlap(protoRoot, generatedRoot))
+            ProtoPackageErrors.fail(packageJson.name, "generatedRoot must not overlap protoRoot or package root");
+        const exportRoot = ProtoPackage.packagePath(packageRoot, packageJson.name, config.exportRoot, "exportRoot");
+        ProtoPackage.validateGeneratedExports(packageJson, exportRoot);
+        return {
+            formatVersion: 1,
+            mode: "model",
+            packageName,
+            protoRoot,
+            generatedRoot,
+            exportRoot,
+            dependencies,
+            moduleExport: ProtoPackage.bindingIdentifier(packageJson.name, config.moduleExport, "moduleExport"),
+        };
+    },
+    /**
+     * Validates a deterministic manifest shipped by a model package.
+     */
+    manifestFromPackage(packageRoot, manifestPath = join(packageRoot, "spine-proto-manifest.json")) {
+        const packageJson = ProtoPackage.readPackage(packageRoot);
+        const manifest = ProtoPackage.manifestFromValue(ProtoPackage.readJson(manifestPath, packageJson.name), packageJson.name);
+        if (manifest.packageName !== packageJson.name)
+            ProtoPackageErrors.fail(packageJson.name, "manifest packageName must match package.json name");
+        if (manifest.packageVersion !== packageJson.version)
+            ProtoPackageErrors.fail(packageJson.name, "manifest packageVersion must match package.json version");
+        const config = ProtoPackage.configFromPackage(packageRoot);
+        if (config.mode !== "model")
+            ProtoPackageErrors.fail(packageJson.name, "manifest requires model mode");
+        const marker = ProtoPackage.objectValue(packageJson.name, ProtoPackage.readJson(join(packageRoot, config.generatedRoot, generationMarkerFile), packageJson.name), "generated-root marker");
+        ProtoPackage.rejectKeys(packageJson.name, marker, ["generationId"], "generated-root marker");
+        if (ProtoPackage.stringValue(packageJson.name, marker.generationId, "generated-root marker generationId") !== manifest.generationId)
+            ProtoPackageErrors.fail(packageJson.name, "manifest generationId must match generated-root marker");
+        for (const protoFile of manifest.protoFiles) {
+            ProtoPackage.assertNoSymlinkAncestor(packageRoot, packageJson.name, protoFile, "manifest protoFiles");
+            ProtoPackage.assertNoSymlinkAncestor(packageRoot, packageJson.name, manifest.generatedExports[protoFile] ?? "", `manifest generated export for ${protoFile}`);
+        }
+        return manifest;
+    },
+    /**
+     * Builds a deterministic manifest from a model package's owned Proto paths.
+     */
+    manifestForPackage(packageRoot, ownedProtoFiles, generationId = randomUUID()) {
+        const config = ProtoPackage.configFromPackage(packageRoot);
+        if (config.mode !== "model")
+            ProtoPackageErrors.fail(ProtoPackage.readPackage(packageRoot).name, "manifest requires model mode");
+        const packageJson = ProtoPackage.readPackage(packageRoot);
+        if (ownedProtoFiles !== undefined && ownedProtoFiles.length > 10000)
+            ProtoPackageErrors.fail(packageJson.name, "owned Proto paths exceeds 10000 entries");
+        const protoFiles = (ownedProtoFiles ??
+            ProtoPackage.discoverProtoFiles(join(packageRoot, config.protoRoot), packageJson.name))
+            .map((file) => ProtoPackage.protoPath(packageRoot, packageJson.name, config.protoRoot, file))
+            .sort();
+        if (new Set(protoFiles).size !== protoFiles.length)
+            ProtoPackageErrors.fail(packageJson.name, "duplicate proto path");
+        return {
+            formatVersion: manifestFormatVersion,
+            generationId: ProtoPackage.stringValue(packageJson.name, generationId, "manifest generationId"),
+            packageName: packageJson.name,
+            packageVersion: packageJson.version,
+            protoFiles,
+            generatedExports: Object.fromEntries(protoFiles.map((file) => [
+                file,
+                ProtoPackage.exportPath(packageJson.name, config.exportRoot, file),
+            ])),
+            dependencies: [...config.dependencies].sort(),
+            moduleExport: config.moduleExport,
+        };
+    },
+    manifestFromValue(value, requester) {
+        const manifest = ProtoPackage.objectValue(requester, value, "manifest");
+        ProtoPackage.rejectKeys(requester, manifest, [
+            "formatVersion",
+            "generationId",
+            "packageName",
+            "packageVersion",
+            "protoFiles",
+            "generatedExports",
+            "dependencies",
+            "moduleExport",
+        ], "manifest");
+        if (manifest.formatVersion !== manifestFormatVersion)
+            ProtoPackageErrors.fail(requester, "manifest formatVersion must be 2");
+        const generationId = ProtoPackage.stringValue(requester, manifest.generationId, "manifest generationId");
+        const protoFiles = ProtoPackage.stringList(requester, manifest.protoFiles, "manifest protoFiles")
+            .map((file) => ProtoPackage.manifestPath(requester, file, "manifest protoFiles"))
+            .sort();
+        const generatedExports = ProtoPackage.objectValue(requester, manifest.generatedExports, "manifest generatedExports");
+        ProtoPackage.assertRecordBound(requester, generatedExports, "manifest generatedExports");
+        const keys = Object.keys(generatedExports).sort();
+        if (keys.length !== protoFiles.length || keys.some((key, index) => key !== protoFiles[index])) {
+            ProtoPackageErrors.fail(requester, "manifest generatedExports must map every proto file exactly once");
+        }
+        return {
+            formatVersion: manifestFormatVersion,
+            generationId,
+            packageName: ProtoPackage.packageNameValue(requester, manifest.packageName, "manifest packageName"),
+            packageVersion: ProtoPackage.stringValue(requester, manifest.packageVersion, "manifest packageVersion"),
+            protoFiles,
+            generatedExports: Object.fromEntries(protoFiles.map((file) => [
+                file,
+                ProtoPackage.manifestPath(requester, generatedExports[file], `manifest generated export for ${file}`),
+            ])),
+            dependencies: [
+                ...ProtoPackage.packageNameList(requester, manifest.dependencies, "manifest dependencies"),
+            ].sort(),
+            moduleExport: ProtoPackage.bindingIdentifier(requester, manifest.moduleExport, "manifest moduleExport"),
+        };
+    },
+    discoverProtoFiles(root, name) {
+        const files = [];
+        const pending = [{ path: root, relativePath: "", depth: 0 }];
+        let encountered = 0;
+        while (pending.length > 0) {
+            const directory = pending.pop();
+            if (directory === undefined)
+                break;
+            let directoryHandle;
+            try {
+                directoryHandle = opendirSync(directory.path, { encoding: "utf8" });
+            }
+            catch {
+                ProtoPackageErrors.fail(name, "proto root is missing or inaccessible");
+            }
+            try {
+                for (let entry = directoryHandle.readSync(); entry !== null; entry = directoryHandle.readSync()) {
+                    encountered += 1;
+                    if (encountered > 10000)
+                        ProtoPackageErrors.fail(name, "proto source exceeds 10000 entries");
+                    const relativePath = directory.relativePath === "" ? entry.name : `${directory.relativePath}/${entry.name}`;
+                    if (entry.isDirectory()) {
+                        if (directory.depth >= 100)
+                            ProtoPackageErrors.fail(name, "proto source exceeds 100 directory levels");
+                        pending.push({
+                            path: join(directory.path, entry.name),
+                            relativePath,
+                            depth: directory.depth + 1,
+                        });
+                    }
+                    else if (entry.isFile() && entry.name.endsWith(".proto")) {
+                        files.push(relativePath);
+                    }
+                }
+            }
+            finally {
+                directoryHandle.closeSync();
+            }
+        }
+        return files;
+    },
+    protoPath(packageRoot, name, protoRoot, value) {
+        const path = ProtoPackage.manifestPath(name, value, "proto path");
+        ProtoPackage.assertNoSymlinkAncestor(packageRoot, name, join(protoRoot, path), "proto path");
+        return path;
+    },
+    exportPath(name, exportRoot, protoPath) {
+        return ProtoPackage.manifestPath(name, `${exportRoot}/${protoPath.replace(/\.proto$/, "_pb.js")}`, "generated export");
+    },
+    packagePath(packageRoot, name, value, label) {
+        const path = ProtoPackage.manifestPath(name, value, label);
+        ProtoPackage.assertNoSymlinkAncestor(packageRoot, name, path, label);
+        return path;
+    },
+    pathsOverlap(left, right) {
+        return left === right || left.startsWith(`${right}/`) || right.startsWith(`${left}/`);
+    },
+    isReservedOutput(path) {
+        return (path === "." ||
+            ["package.json", "spine-proto.json", "spine-proto-manifest.json"].includes(path) ||
+            !path.includes("."));
+    },
+    bindingIdentifier(name, value, label) {
+        const identifier = ProtoPackage.stringValue(name, value, label);
+        if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(identifier) || reservedBindings.has(identifier))
+            ProtoPackageErrors.fail(name, `${label} must be a legal ESM binding identifier`);
+        return identifier;
+    },
+    manifestPath(name, value, label) {
+        const path = ProtoPackage.stringValue(name, value, label).replaceAll("\\", "/");
+        if (isAbsolute(path))
+            ProtoPackageErrors.fail(name, `${label} must be relative`);
+        if (path.split("/").includes(".."))
+            ProtoPackageErrors.fail(name, `${label} must not contain traversal`);
+        if (path.endsWith("/") || normalize(path).replaceAll("\\", "/") !== path) {
+            ProtoPackageErrors.fail(name, `${label} must be a normalized contained relative path`);
+        }
+        return path;
+    },
+    assertNoSymlinkAncestor(packageRoot, name, path, label) {
+        let current = packageRoot;
+        for (const segment of path.split("/")) {
+            current = join(current, segment);
+            try {
+                if (lstatSync(current).isSymbolicLink())
+                    ProtoPackageErrors.fail(name, `${label} must not pass through a symlink`);
+            }
+            catch (error) {
+                if (error.code !== "ENOENT")
+                    throw error;
+            }
+        }
+    },
+    validateRegistryDependencies(packageJson, names, label) {
+        for (const name of names) {
+            const specifier = packageJson.dependencies[name];
+            if (specifier === undefined) {
+                ProtoPackageErrors.fail(packageJson.name, `${label} ${name} must be declared in package.json dependencies`);
+            }
+            if (!RegistryDependency.is(specifier)) {
+                ProtoPackageErrors.fail(packageJson.name, `${label} ${name} must use a registry version`);
+            }
+        }
+    },
+    validateGeneratedExports(packageJson, exportRoot) {
+        const key = `./${exportRoot}/*.js`;
+        const entry = packageJson.exports[key];
+        const expectedRuntime = `./dist/${exportRoot}/*.js`;
+        const expectedTypes = `./dist/${exportRoot}/*.d.ts`;
+        if (typeof entry !== "object" ||
+            entry === null ||
+            Array.isArray(entry) ||
+            entry.default !== expectedRuntime ||
+            entry.types !== expectedTypes) {
+            ProtoPackageErrors.fail(packageJson.name, `package.json exports must expose ${key} with default ${expectedRuntime} and types ${expectedTypes}`);
+        }
+    },
+    readPackage(packageRoot) {
+        const value = ProtoPackage.objectValue(packageRoot, ProtoPackage.readJson(join(packageRoot, "package.json"), packageRoot), "package.json");
+        const name = ProtoPackage.packageNameValue(packageRoot, value.name, "package.json name");
+        return {
+            name,
+            version: ProtoPackage.stringValue(name, value.version, "package.json version"),
+            dependencies: ProtoPackage.stringRecord(value.dependencies, name, "package.json dependencies"),
+            exports: value.exports === undefined
+                ? {}
+                : ProtoPackage.objectValue(name, value.exports, "package.json exports"),
+        };
+    },
+    readJson(path, name) {
+        let descriptor;
+        try {
+            descriptor = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+            if (!fstatSync(descriptor).isFile())
+                throw new Error("unsafe JSON input");
+            return JSON.parse(readFileSync(descriptor, "utf8"));
+        }
+        catch {
+            return ProtoPackageErrors.fail(name, `cannot read ${path.split(sep).at(-1) ?? path}`);
+        }
+        finally {
+            if (descriptor !== undefined)
+                closeSync(descriptor);
+        }
+    },
+    objectValue(name, value, label) {
+        if (typeof value !== "object" || value === null || Array.isArray(value))
+            return ProtoPackageErrors.fail(name, `${label} must be an object`);
+        return value;
+    },
+    stringValue(name, value, label) {
+        if (typeof value !== "string" || value.length === 0)
+            return ProtoPackageErrors.fail(name, `${label} must be a non-empty string`);
+        return value;
+    },
+    stringList(name, value, label) {
+        if (!Array.isArray(value))
+            ProtoPackageErrors.fail(name, `${label} must be an array of non-empty strings`);
+        if (value.length > 10000)
+            ProtoPackageErrors.fail(name, `${label} exceeds 10000 entries`);
+        const strings = value.filter((item) => typeof item === "string" && item.length > 0);
+        if (strings.length !== value.length)
+            ProtoPackageErrors.fail(name, `${label} must be an array of non-empty strings`);
+        if (new Set(strings).size !== strings.length)
+            ProtoPackageErrors.fail(name, `${label} must not contain duplicates`);
+        return strings;
+    },
+    packageNameValue(name, value, label) {
+        const packageName = ProtoPackage.stringValue(name, value, label);
+        if (!NpmPackageName.is(packageName))
+            ProtoPackageErrors.fail(name, `${label} must be a valid npm package name`);
+        return packageName;
+    },
+    packageNameList(name, value, label) {
+        return ProtoPackage.stringList(name, value, label).map((packageName) => ProtoPackage.packageNameValue(name, packageName, label));
+    },
+    assertRecordBound(name, record, label) {
+        let count = 0;
+        for (const key in record) {
+            if (!Object.hasOwn(record, key))
+                continue;
+            count += 1;
+            if (count > 10000)
+                ProtoPackageErrors.fail(name, `${label} exceeds 10000 entries`);
+        }
+    },
+    stringRecord(value, name, label) {
+        if (value === undefined)
+            return {};
+        const record = ProtoPackage.objectValue(name, value, label);
+        if (!Object.values(record).every((item) => typeof item === "string"))
+            ProtoPackageErrors.fail(name, `${label} must contain string versions`);
+        return record;
+    },
+    rejectKeys(name, value, allowed, label) {
+        const unexpected = Object.keys(value).find((key) => !allowed.includes(key));
+        if (unexpected !== undefined)
+            ProtoPackageErrors.fail(name, `${label} must not declare ${unexpected}`);
+    },
+});
+/**
+ * Provides access to the versioned Proto package configuration.
+ */
+export const ProtoConfig = Object.freeze({
+    // prettier-ignore
+    /**
+     * Reads and validates `spine-proto.json` at a package root.
+     *
+     * @param packageRoot The package root that contains the configuration.
+     * @returns The validated model or application configuration.
+     */
+    read(packageRoot) {
+        return ProtoPackage.configFromPackage(packageRoot);
+    },
+});
+/**
+ * Provides access to deterministic Proto package manifests.
+ */
+export const ProtoManifest = Object.freeze({
+    // prettier-ignore
+    /**
+     * Reads and validates a package manifest.
+     *
+     * @param packageRoot The package root that owns the manifest.
+     * @param manifestPath The optional manifest path within the package root.
+     * @returns The validated manifest.
+     */
+    read(packageRoot, manifestPath = join(packageRoot, "spine-proto-manifest.json")) {
+        let failure;
+        for (let attempt = 0; attempt < manifestReadAttempts; attempt += 1) {
+            try {
+                return ProtoPackage.manifestFromPackage(packageRoot, manifestPath);
+            }
+            catch (error) {
+                failure = error;
+                if (!hasLiveGenerationClaim(packageRoot))
+                    throw error;
+                if (attempt + 1 < manifestReadAttempts)
+                    waitForManifestCommit();
+            }
+        }
+        throw failure;
+    },
+    /**
+     * Creates a manifest from package-owned Proto paths. Without a supplied generation ID,
+     * a fresh random ID is assigned for a new generated-root marker lifecycle.
+     *
+     * @param packageRoot The model package root.
+     * @param ownedProtoFiles Optional explicit package-relative Proto paths.
+     * @param generationId Optional generation ID; a random ID is used when omitted.
+     * @returns The created manifest.
+     */
+    create(packageRoot, ownedProtoFiles, generationId) {
+        return ProtoPackage.manifestForPackage(packageRoot, ownedProtoFiles, generationId);
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/dist/src/io/atomic-manifest.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Filesystem operations used to stage and atomically replace a manifest.
+ */
+export interface ManifestFileOperations {
+    /**
+     * Writes complete content to a unique staging file.
+     *
+     * @param path The staging-file path.
+     * @param content The complete content to write.
+     */
+    readonly writeFile: (path: string, content: string) => void;
+    /**
+     * Replaces a destination manifest with a staging file.
+     *
+     * @param from The completed staging-file path.
+     * @param to The destination manifest path.
+     */
+    readonly rename: (from: string, to: string) => void;
+    /**
+     * Removes a failed staging file.
+     *
+     * @param path The staging-file path to remove.
+     */
+    readonly remove: (path: string) => void;
+}
+/**
+ * Publishes manifest files through complete sibling staging files.
+ */
+export declare const ManifestFile: Readonly<{
+    writeAtomically(target: string, content: string, operations?: Partial<ManifestFileOperations>): void;
+}>;
+//# sourceMappingURL=atomic-manifest.d.ts.map

package/dist/src/io/atomic-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-manifest.d.ts","sourceRoot":"","sources":["../../../src/io/atomic-manifest.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,MAAM,WAAW,sBAAsB;IAGrC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5D;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAYD;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC;IAClC,eAAe,CACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAC3C,IAAI,CAAC;CACT,CAiCC,CAAC"}