@componentonce/compiler-esbuild 0.1.0-beta.0 → 0.1.0-beta.1

package/dist/index.js

@@ -1,290 +1,3 @@
-import { createHash } from "node:crypto";
-import { build, } from "esbuild";
-/** Stable identifier for the trusted CommonJS bundle contract emitted by this package. */
-export const COMPONENTONCE_TRUSTED_BUNDLE_FORMAT = "componentonce.trusted-cjs.v1";
-const DEFAULT_SOURCE_FILE_NAME = "componentonce-module.ts";
-const DEFAULT_REACT_SOURCE_FILE_NAME = "componentonce-module.tsx";
-const DEFAULT_EVALUATED_SOURCE_NAME = "componentonce-trusted-bundle.js";
-const REACT_EXTERNALS = ["react", "react/jsx-runtime", "react/jsx-dev-runtime"];
-/** Compilation failure with stable, normalized esbuild diagnostics. */
-export class ComponentOnceCompileError extends Error {
-    /** Compiler errors that caused the build to fail. */
-    diagnostics;
-    constructor(diagnostics) {
-        super(formatCompileErrorMessage(diagnostics));
-        this.name = "ComponentOnceCompileError";
-        this.diagnostics = Object.freeze([...diagnostics]);
-    }
-}
-/** Deterministic error raised when a bundle requests an external the host did not inject. */
-export class ComponentOnceMissingExternalError extends Error {
-    /** Exact module specifier requested by the bundle. */
-    specifier;
-    /** Sorted external specifiers supplied by the host. */
-    availableExternals;
-    constructor(specifier, availableExternals) {
-        const sortedExternals = Object.freeze([...availableExternals].sort());
-        const available = sortedExternals.length === 0 ? "(none)" : sortedExternals.join(", ");
-        super(`Missing trusted bundle external "${specifier}". Available externals: ${available}.`);
-        this.name = "ComponentOnceMissingExternalError";
-        this.specifier = specifier;
-        this.availableExternals = sortedExternals;
-    }
-}
-/** Error raised when loaded bundle content does not match its expected SHA-256 integrity. */
-export class ComponentOnceIntegrityError extends Error {
-    /** Expected subresource-integrity-style SHA-256 value. */
-    expectedIntegrity;
-    /** Actual subresource-integrity-style SHA-256 value. */
-    actualIntegrity;
-    constructor(expectedIntegrity, actualIntegrity) {
-        super(`Trusted bundle integrity mismatch. Expected "${expectedIntegrity}" but received "${actualIntegrity}".`);
-        this.name = "ComponentOnceIntegrityError";
-        this.expectedIntegrity = expectedIntegrity;
-        this.actualIntegrity = actualIntegrity;
-    }
-}
-/**
- * Compile one trusted module into a deterministic CommonJS artifact.
- *
- * Only caller-declared imports remain external. This generic path does not add React or any other
- * runtime implicitly; every external must be injected explicitly by the host at instantiation.
- */
-export async function compileTrustedModule(input) {
-    const sourceFileName = input.sourceFileName ?? DEFAULT_SOURCE_FILE_NAME;
-    const loader = input.loader ?? inferLoader(sourceFileName);
-    const allowedExternals = normalizeAllowedExternals(input.externalModules ?? []);
-    try {
-        const result = await build({
-            bundle: true,
-            charset: "utf8",
-            format: "cjs",
-            jsx: input.jsx ?? "transform",
-            legalComments: "none",
-            logLevel: "silent",
-            metafile: true,
-            minify: false,
-            platform: "neutral",
-            plugins: [createHostExternalPlugin(allowedExternals)],
-            sourcemap: "inline",
-            sourcesContent: true,
-            stdin: {
-                contents: input.source,
-                loader: loader,
-                sourcefile: sourceFileName,
-            },
-            target: "es2022",
-            treeShaking: true,
-            write: false,
-        });
-        const output = result.outputFiles?.[0];
-        if (output === undefined || result.metafile === undefined) {
-            throw new ComponentOnceCompileError([
-                createInternalDiagnostic("esbuild did not return an in-memory bundle and metafile."),
-            ]);
-        }
-        const code = output.text;
-        const hashes = hashBundleSource(code);
-        const metafile = deepFreeze(result.metafile);
-        const diagnostics = Object.freeze(result.warnings.map((warning) => normalizeMessage("warning", warning)));
-        const externalModules = Object.freeze(collectExternalModules(metafile));
-        return Object.freeze({
-            format: COMPONENTONCE_TRUSTED_BUNDLE_FORMAT,
-            code,
-            byteLength: hashes.byteLength,
-            sha256: hashes.sha256,
-            integrity: hashes.integrity,
-            externalModules,
-            diagnostics,
-            metafile,
-        });
-    }
-    catch (error) {
-        if (error instanceof ComponentOnceCompileError)
-            throw error;
-        if (isBuildFailure(error)) {
-            throw new ComponentOnceCompileError(error.errors.map((message) => normalizeMessage("error", message)));
-        }
-        throw error;
-    }
-}
-/** Compile a trusted React module while keeping the host React singleton external. */
-export function compileTrustedReactModule(input) {
-    return compileTrustedModule({
-        source: input.source,
-        sourceFileName: input.sourceFileName ?? DEFAULT_REACT_SOURCE_FILE_NAME,
-        ...(input.loader === undefined ? {} : { loader: input.loader }),
-        externalModules: [
-            ...REACT_EXTERNALS,
-            ...(input.additionalExternalModules ?? []),
-        ],
-        jsx: "automatic",
-    });
-}
-/** Calculate a subresource-integrity-style SHA-256 value for bundle text or UTF-8 bytes. */
-export function calculateTrustedBundleIntegrity(source) {
-    return hashBundleSource(source).integrity;
-}
-/** Throw when bundle text or bytes do not match an expected SHA-256 integrity value. */
-export function assertTrustedBundleIntegrity(source, expectedIntegrity) {
-    const actualIntegrity = calculateTrustedBundleIntegrity(source);
-    if (actualIntegrity !== expectedIntegrity) {
-        throw new ComponentOnceIntegrityError(expectedIntegrity, actualIntegrity);
-    }
-}
-/**
- * Execute a trusted bundle with a deliberately narrow CommonJS environment.
- *
- * This API uses `new Function` and is only for trusted internal code. It is not a sandbox: evaluated
- * code retains access to JavaScript globals. The only available `require` values are provided by
- * `options.externals`, so React is always the exact instance selected by the host.
- */
-export function instantiateTrustedBundle(source, options) {
-    const artifact = isBundleArtifact(source) ? source : undefined;
-    if (artifact !== undefined && artifact.format !== COMPONENTONCE_TRUSTED_BUNDLE_FORMAT) {
-        throw new TypeError(`Unsupported trusted bundle format: "${String(artifact.format)}".`);
-    }
-    const bundleSource = artifact === undefined ? source : artifact.code;
-    const expectedIntegrity = options.expectedIntegrity ?? artifact?.integrity;
-    if (expectedIntegrity !== undefined) {
-        assertTrustedBundleIntegrity(bundleSource, expectedIntegrity);
-    }
-    const code = typeof bundleSource === "string" ? bundleSource : decodeUtf8(bundleSource);
-    const availableExternals = Object.keys(options.externals).sort();
-    const trustedRequire = (specifier) => {
-        if (!Object.prototype.hasOwnProperty.call(options.externals, specifier)) {
-            throw new ComponentOnceMissingExternalError(specifier, availableExternals);
-        }
-        return options.externals[specifier];
-    };
-    const commonJsModule = { exports: {} };
-    const sourceName = sanitizeSourceName(options.sourceName ?? DEFAULT_EVALUATED_SOURCE_NAME);
-    const evaluate = new Function("module", "exports", "require", `"use strict";\n${code}\n//# sourceURL=${sourceName}`);
-    evaluate(commonJsModule, commonJsModule.exports, trustedRequire);
-    return commonJsModule.exports;
-}
-function createHostExternalPlugin(allowedExternals) {
-    return {
-        name: "componentonce-host-externals",
-        setup(buildApi) {
-            buildApi.onResolve({ filter: /.*/ }, (args) => {
-                if (allowedExternals.has(args.path)) {
-                    return { external: true, path: args.path };
-                }
-                return {
-                    errors: [
-                        {
-                            text: `Import "${args.path}" is not an allowed host external. ` +
-                                "Add its exact specifier to externalModules (or additionalExternalModules for the React helper).",
-                        },
-                    ],
-                };
-            });
-        },
-    };
-}
-function normalizeAllowedExternals(additionalExternals) {
-    const externals = new Set();
-    for (const specifier of additionalExternals) {
-        if (specifier.length === 0 ||
-            specifier !== specifier.trim() ||
-            specifier.includes("\0") ||
-            specifier.includes("\n") ||
-            specifier.includes("\r")) {
-            throw new ComponentOnceCompileError([
-                createInternalDiagnostic(`Invalid additional external module specifier: ${JSON.stringify(specifier)}.`),
-            ]);
-        }
-        externals.add(specifier);
-    }
-    return externals;
-}
-function inferLoader(sourceFileName) {
-    const lowerName = sourceFileName.toLowerCase();
-    if (lowerName.endsWith(".jsx"))
-        return "jsx";
-    if (lowerName.endsWith(".js") || lowerName.endsWith(".mjs") || lowerName.endsWith(".cjs")) {
-        return "js";
-    }
-    if (lowerName.endsWith(".ts") || lowerName.endsWith(".mts") || lowerName.endsWith(".cts")) {
-        return "ts";
-    }
-    return "tsx";
-}
-function normalizeMessage(kind, message) {
-    return Object.freeze({
-        kind,
-        text: message.text,
-        ...(message.location === null ? {} : { location: normalizeLocation(message.location) }),
-        notes: Object.freeze(message.notes.map((note) => Object.freeze({
-            text: note.text,
-            ...(note.location === null ? {} : { location: normalizeLocation(note.location) }),
-        }))),
-    });
-}
-function normalizeLocation(location) {
-    return Object.freeze({
-        file: location.file,
-        line: location.line,
-        column: location.column,
-        length: location.length,
-        lineText: location.lineText,
-    });
-}
-function createInternalDiagnostic(text) {
-    return Object.freeze({ kind: "error", text, notes: Object.freeze([]) });
-}
-function formatCompileErrorMessage(diagnostics) {
-    const details = diagnostics.map((diagnostic) => {
-        const location = diagnostic.location;
-        const prefix = location === undefined
-            ? diagnostic.kind
-            : `${location.file}:${location.line}:${location.column + 1}`;
-        return `${prefix}: ${diagnostic.text}`;
-    });
-    return `ComponentOnce compilation failed${details.length === 0 ? "." : `:\n${details.join("\n")}`}`;
-}
-function isBuildFailure(error) {
-    return (typeof error === "object" &&
-        error !== null &&
-        "errors" in error &&
-        Array.isArray(error.errors));
-}
-function collectExternalModules(metafile) {
-    const modules = new Set();
-    for (const output of Object.values(metafile.outputs)) {
-        for (const imported of output.imports) {
-            if (imported.external)
-                modules.add(imported.path);
-        }
-    }
-    return [...modules].sort();
-}
-function hashBundleSource(source) {
-    const bytes = typeof source === "string" ? Buffer.from(source, "utf8") : source;
-    const digest = createHash("sha256").update(bytes).digest();
-    return {
-        byteLength: bytes.byteLength,
-        sha256: digest.toString("hex"),
-        integrity: `sha256-${digest.toString("base64")}`,
-    };
-}
-function isBundleArtifact(source) {
-    return typeof source === "object" && !(source instanceof Uint8Array);
-}
-function decodeUtf8(source) {
-    return new TextDecoder("utf-8", { fatal: true }).decode(source);
-}
-function sanitizeSourceName(sourceName) {
-    return sourceName.replace(/[\r\n\u2028\u2029]/g, "_");
-}
-function deepFreeze(value) {
-    if (value !== null && typeof value === "object" && !Object.isFrozen(value)) {
-        for (const child of Object.values(value)) {
-            deepFreeze(child);
-        }
-        Object.freeze(value);
-    }
-    return value;
-}
+export * from "./compiler.js";
+export * from "./package.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/package.d.ts

@@ -0,0 +1,88 @@
+import type { AnyComponentOnceDefinition, ComponentOnceManifest } from "@componentonce/core";
+import { type ComponentOnceCompileInput, type ComponentOnceHostExternals, type ComponentOnceReactCompileInput, type ComponentOnceTrustedBundleArtifact, type InstantiateTrustedBundleOptions } from "./compiler.js";
+/** Stable identifier for a self-describing ComponentOnce package envelope. */
+export declare const COMPONENTONCE_TRUSTED_PACKAGE_FORMAT: "componentonce.trusted-package.v1";
+/** Conventional named export containing a packaged ComponentOnce definition. */
+export declare const COMPONENTONCE_DEFAULT_DEFINITION_EXPORT: "definition";
+/** Persistable package containing inspectable metadata plus one trusted executable bundle. */
+export interface ComponentOnceTrustedPackage {
+    /** Package-envelope contract version. */
+    readonly format: typeof COMPONENTONCE_TRUSTED_PACKAGE_FORMAT;
+    /** Renderer/adapter id such as react or dom; custom adapters may use their own stable id. */
+    readonly renderer: string;
+    /** Component identity and compatibility metadata readable without executing the bundle. */
+    readonly manifest: ComponentOnceManifest;
+    /** Named module export containing the ComponentOnce definition. */
+    readonly definitionExport: string;
+    /** Integrity-protected executable bundle produced by this compiler. */
+    readonly bundle: ComponentOnceTrustedBundleArtifact;
+}
+/** Explicit inputs for wrapping an existing trusted bundle in a self-describing package. */
+export interface CreateTrustedComponentPackageInput {
+    readonly renderer: string;
+    readonly manifest: ComponentOnceManifest;
+    readonly bundle: ComponentOnceTrustedBundleArtifact;
+    readonly definitionExport?: string;
+}
+/** Generic trusted-definition build that discovers the manifest once at build time. */
+export interface ComponentOnceDefinitionPackageBuildInput extends ComponentOnceCompileInput {
+    /** Stable renderer/adapter id recorded in package metadata. */
+    readonly renderer: string;
+    /** Build-time module values used to evaluate the trusted definition once. */
+    readonly externals?: ComponentOnceHostExternals;
+    /** Named definition export; defaults to definition. */
+    readonly definitionExport?: string;
+}
+/** React package build that keeps React external and discovers metadata once at build time. */
+export interface ComponentOnceReactPackageBuildInput extends ComponentOnceReactCompileInput {
+    /** Build-time values including the exact React/JSX runtime used by this build. */
+    readonly externals: ComponentOnceHostExternals;
+    /** Named definition export; defaults to definition. */
+    readonly definitionExport?: string;
+}
+/** Error raised when a high-level package builder cannot find a valid definition export. */
+export declare class ComponentOncePackageDefinitionError extends Error {
+    /** Export name that was missing or invalid. */
+    readonly definitionExport: string;
+    constructor(definitionExport: string);
+}
+/** Error raised when package metadata disagrees with the definition in its executable bundle. */
+export declare class ComponentOncePackageManifestMismatchError extends Error {
+    /** Manifest persisted in the package envelope. */
+    readonly packaged: ComponentOnceManifest;
+    /** Manifest produced by the executable definition. */
+    readonly loaded: ComponentOnceManifest;
+    constructor(packaged: ComponentOnceManifest, loaded: ComponentOnceManifest);
+}
+/**
+ * Wrap an already compiled trusted bundle with metadata catalogs can inspect without executing code.
+ *
+ * This low-level helper does not evaluate the bundle. High-level builders evaluate trusted source
+ * once during build time to discover the exported definition and then persist its manifest here.
+ */
+export declare function createTrustedComponentPackage(input: CreateTrustedComponentPackageInput): ComponentOnceTrustedPackage;
+/**
+ * Compile a generic trusted definition and emit a self-describing package.
+ *
+ * The module executes exactly once during trusted build time so its manifest can be captured. Later
+ * catalogs can inspect the package metadata without evaluating the executable component.
+ */
+export declare function buildTrustedDefinitionPackage(input: ComponentOnceDefinitionPackageBuildInput): Promise<ComponentOnceTrustedPackage>;
+/**
+ * Compile a trusted React definition and emit a self-describing package.
+ *
+ * React and its JSX runtimes remain external in the executable artifact. The supplied build-time
+ * externals are only used for the one-time trusted metadata discovery.
+ */
+export declare function buildTrustedReactPackage(input: ComponentOnceReactPackageBuildInput): Promise<ComponentOnceTrustedPackage>;
+/** Serialize a trusted package to portable JSON for any host-owned storage adapter. */
+export declare function serializeTrustedComponentPackage(componentPackage: ComponentOnceTrustedPackage, space?: number): string;
+/** Parse a persisted trusted package and verify the executable bundle integrity metadata. */
+export declare function parseTrustedComponentPackage(source: string | Uint8Array): ComponentOnceTrustedPackage;
+/**
+ * Instantiate a self-describing package and verify its executable definition still matches metadata.
+ *
+ * Hosts should use this at the trusted-code boundary after loading a package from storage.
+ */
+export declare function instantiateTrustedComponentPackage<TDefinition extends AnyComponentOnceDefinition = AnyComponentOnceDefinition>(componentPackage: ComponentOnceTrustedPackage, options: InstantiateTrustedBundleOptions): TDefinition;
+//# sourceMappingURL=package.d.ts.map

package/dist/package.d.ts.map

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

package/dist/package.js

@@ -0,0 +1,229 @@
+import { createHash } from "node:crypto";
+import { COMPONENTONCE_TRUSTED_BUNDLE_FORMAT, assertTrustedBundleIntegrity, compileTrustedModule, compileTrustedReactModule, instantiateTrustedBundle, } from "./compiler.js";
+/** Stable identifier for a self-describing ComponentOnce package envelope. */
+export const COMPONENTONCE_TRUSTED_PACKAGE_FORMAT = "componentonce.trusted-package.v1";
+/** Conventional named export containing a packaged ComponentOnce definition. */
+export const COMPONENTONCE_DEFAULT_DEFINITION_EXPORT = "definition";
+const REACT_EXTERNALS = ["react", "react/jsx-runtime", "react/jsx-dev-runtime"];
+/** Error raised when a high-level package builder cannot find a valid definition export. */
+export class ComponentOncePackageDefinitionError extends Error {
+    /** Export name that was missing or invalid. */
+    definitionExport;
+    constructor(definitionExport) {
+        super("Trusted module export \"" +
+            definitionExport +
+            "\" is not a ComponentOnce definition with a manifest and implementation.");
+        this.name = "ComponentOncePackageDefinitionError";
+        this.definitionExport = definitionExport;
+    }
+}
+/** Error raised when package metadata disagrees with the definition in its executable bundle. */
+export class ComponentOncePackageManifestMismatchError extends Error {
+    /** Manifest persisted in the package envelope. */
+    packaged;
+    /** Manifest produced by the executable definition. */
+    loaded;
+    constructor(packaged, loaded) {
+        super("Packaged manifest \"" +
+            packaged.id +
+            "\" version \"" +
+            packaged.version +
+            "\" does not match the loaded definition \"" +
+            loaded.id +
+            "\" version \"" +
+            loaded.version +
+            "\".");
+        this.name = "ComponentOncePackageManifestMismatchError";
+        this.packaged = packaged;
+        this.loaded = loaded;
+    }
+}
+/**
+ * Wrap an already compiled trusted bundle with metadata catalogs can inspect without executing code.
+ *
+ * This low-level helper does not evaluate the bundle. High-level builders evaluate trusted source
+ * once during build time to discover the exported definition and then persist its manifest here.
+ */
+export function createTrustedComponentPackage(input) {
+    const renderer = requireNonEmptyString(input.renderer, "renderer");
+    const definitionExport = requireNonEmptyString(input.definitionExport ?? COMPONENTONCE_DEFAULT_DEFINITION_EXPORT, "definitionExport");
+    return deepFreeze({
+        format: COMPONENTONCE_TRUSTED_PACKAGE_FORMAT,
+        renderer,
+        manifest: copyManifest(input.manifest),
+        definitionExport,
+        bundle: input.bundle,
+    });
+}
+/**
+ * Compile a generic trusted definition and emit a self-describing package.
+ *
+ * The module executes exactly once during trusted build time so its manifest can be captured. Later
+ * catalogs can inspect the package metadata without evaluating the executable component.
+ */
+export async function buildTrustedDefinitionPackage(input) {
+    const externals = input.externals ?? {};
+    const artifact = await compileTrustedModule({
+        source: input.source,
+        ...(input.sourceFileName === undefined ? {} : { sourceFileName: input.sourceFileName }),
+        ...(input.loader === undefined ? {} : { loader: input.loader }),
+        ...(input.resolveDir === undefined ? {} : { resolveDir: input.resolveDir }),
+        externalModules: uniqueStrings([
+            ...(input.externalModules ?? []),
+            ...Object.keys(externals),
+        ]),
+        ...(input.jsx === undefined ? {} : { jsx: input.jsx }),
+    });
+    return packageTrustedDefinitionArtifact(artifact, input.renderer, externals, input.definitionExport);
+}
+/**
+ * Compile a trusted React definition and emit a self-describing package.
+ *
+ * React and its JSX runtimes remain external in the executable artifact. The supplied build-time
+ * externals are only used for the one-time trusted metadata discovery.
+ */
+export async function buildTrustedReactPackage(input) {
+    const additionalExternals = Object.keys(input.externals).filter((specifier) => !REACT_EXTERNALS.includes(specifier));
+    const artifact = await compileTrustedReactModule({
+        source: input.source,
+        ...(input.sourceFileName === undefined ? {} : { sourceFileName: input.sourceFileName }),
+        ...(input.loader === undefined ? {} : { loader: input.loader }),
+        ...(input.resolveDir === undefined ? {} : { resolveDir: input.resolveDir }),
+        additionalExternalModules: uniqueStrings([
+            ...(input.additionalExternalModules ?? []),
+            ...additionalExternals,
+        ]),
+    });
+    return packageTrustedDefinitionArtifact(artifact, "react", input.externals, input.definitionExport);
+}
+/** Serialize a trusted package to portable JSON for any host-owned storage adapter. */
+export function serializeTrustedComponentPackage(componentPackage, space = 2) {
+    return JSON.stringify(componentPackage, null, space);
+}
+/** Parse a persisted trusted package and verify the executable bundle integrity metadata. */
+export function parseTrustedComponentPackage(source) {
+    const text = typeof source === "string" ? source : decodeUtf8(source);
+    const parsed = JSON.parse(text);
+    if (!isRecord(parsed) || parsed.format !== COMPONENTONCE_TRUSTED_PACKAGE_FORMAT) {
+        throw new TypeError("Unsupported or invalid ComponentOnce package format.");
+    }
+    if (!isRecord(parsed.bundle) || parsed.bundle.format !== COMPONENTONCE_TRUSTED_BUNDLE_FORMAT) {
+        throw new TypeError("ComponentOnce package does not contain a supported trusted bundle.");
+    }
+    const bundle = parsed.bundle;
+    if (typeof bundle.code !== "string" ||
+        typeof bundle.integrity !== "string" ||
+        typeof bundle.sha256 !== "string" ||
+        typeof bundle.byteLength !== "number" ||
+        !Array.isArray(bundle.externalModules) ||
+        !bundle.externalModules.every((specifier) => typeof specifier === "string")) {
+        throw new TypeError("ComponentOnce package bundle metadata is incomplete.");
+    }
+    assertTrustedBundleIntegrity(bundle.code, bundle.integrity);
+    const hashes = hashBundleSource(bundle.code);
+    if (hashes.sha256 !== bundle.sha256 || hashes.byteLength !== bundle.byteLength) {
+        throw new TypeError("ComponentOnce package bundle hash metadata does not match its code.");
+    }
+    if (typeof parsed.renderer !== "string" || !isRecord(parsed.manifest)) {
+        throw new TypeError("ComponentOnce package renderer or manifest is invalid.");
+    }
+    return createTrustedComponentPackage({
+        renderer: parsed.renderer,
+        manifest: parsed.manifest,
+        bundle,
+        definitionExport: typeof parsed.definitionExport === "string"
+            ? parsed.definitionExport
+            : COMPONENTONCE_DEFAULT_DEFINITION_EXPORT,
+    });
+}
+/**
+ * Instantiate a self-describing package and verify its executable definition still matches metadata.
+ *
+ * Hosts should use this at the trusted-code boundary after loading a package from storage.
+ */
+export function instantiateTrustedComponentPackage(componentPackage, options) {
+    const moduleExports = instantiateTrustedBundle(componentPackage.bundle, options);
+    const definition = readDefinitionExport(moduleExports, componentPackage.definitionExport);
+    if (!sameManifest(componentPackage.manifest, definition.manifest)) {
+        throw new ComponentOncePackageManifestMismatchError(componentPackage.manifest, definition.manifest);
+    }
+    return definition;
+}
+function packageTrustedDefinitionArtifact(artifact, renderer, externals, definitionExport = COMPONENTONCE_DEFAULT_DEFINITION_EXPORT) {
+    const moduleExports = instantiateTrustedBundle(artifact, { externals });
+    const definition = readDefinitionExport(moduleExports, definitionExport);
+    return createTrustedComponentPackage({
+        renderer,
+        manifest: definition.manifest,
+        bundle: artifact,
+        definitionExport,
+    });
+}
+function readDefinitionExport(moduleExports, definitionExport) {
+    const value = moduleExports[definitionExport];
+    if (!isRecord(value) || !isRecord(value.manifest) || !("implementation" in value)) {
+        throw new ComponentOncePackageDefinitionError(definitionExport);
+    }
+    copyManifest(value.manifest);
+    return value;
+}
+function copyManifest(manifest) {
+    if (!isRecord(manifest)) {
+        throw new TypeError("ComponentOnce manifest must be an object.");
+    }
+    const id = requireNonEmptyString(manifest.id, "manifest.id");
+    const version = requireNonEmptyString(manifest.version, "manifest.version");
+    if (manifest.displayName !== undefined && typeof manifest.displayName !== "string") {
+        throw new TypeError("manifest.displayName must be a string when supplied.");
+    }
+    const requirements = manifest.requirements?.map((requirement, index) => {
+        if (!isRecord(requirement)) {
+            throw new TypeError("manifest.requirements[" + index + "] must be an object.");
+        }
+        return {
+            name: requireNonEmptyString(requirement.name, "manifest.requirements[" + index + "].name"),
+            version: requireNonEmptyString(requirement.version, "manifest.requirements[" + index + "].version"),
+        };
+    });
+    return {
+        id,
+        version,
+        ...(manifest.displayName === undefined ? {} : { displayName: manifest.displayName }),
+        ...(requirements === undefined ? {} : { requirements }),
+    };
+}
+function sameManifest(left, right) {
+    return JSON.stringify(copyManifest(left)) === JSON.stringify(copyManifest(right));
+}
+function requireNonEmptyString(value, field) {
+    if (typeof value !== "string" || value.trim() === "") {
+        throw new TypeError(field + " must be a non-empty string.");
+    }
+    return value;
+}
+function uniqueStrings(values) {
+    return [...new Set(values)];
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function decodeUtf8(source) {
+    return new TextDecoder("utf-8", { fatal: true }).decode(source);
+}
+function hashBundleSource(source) {
+    const bytes = Buffer.from(source, "utf8");
+    return {
+        byteLength: bytes.byteLength,
+        sha256: createHash("sha256").update(bytes).digest("hex"),
+    };
+}
+function deepFreeze(value) {
+    if (value !== null && typeof value === "object" && !Object.isFrozen(value)) {
+        for (const child of Object.values(value)) {
+            deepFreeze(child);
+        }
+        Object.freeze(value);
+    }
+    return value;
+}
+//# sourceMappingURL=package.js.map

package/dist/package.js.map

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