@moinulmoin/eden 0.1.0

package/dist/eve-packaging.d.ts

@@ -0,0 +1,261 @@
+import type { EveRuntimeInputIdentity } from "./eve-runtime-config.js";
+export type EvePackagingCode = "ROOT_INVALID" | "UNSUPPORTED_TOOLCHAIN" | "DEPENDENCY_AMBIGUITY" | "SOURCE_RACE" | "EVE_BUILD_FAILED" | "UNSUPPORTED_EVE_OUTPUT" | "RUNTIME_CLOSURE_INCOMPLETE" | "SECRET_EXCLUSION_FAILED" | "DOCKER_PLATFORM_BLOCKED" | "UNSUPPORTED_HOST_REQUIREMENT" | "EVE_HEALTH_FAILED" | "CLEANUP_UNVERIFIED" | "PACKAGE_VERIFICATION_FAILED";
+export interface EveRuntimeConfigExclusion {
+    /**
+     * This path is opaque. The packaging worker only uses its lexical identity
+     * to exclude it from a copied snapshot and never opens or stats it.
+     */
+    readonly envFilePath?: string;
+    /**
+     * The deployment-safety seam owns this identity. It may represent the
+     * explicit env file and parsed runtime configuration without exposing values.
+     */
+    readonly inputIdentity?: string | EveRuntimeInputIdentity;
+    readonly readInputIdentity?: () => string | EveRuntimeInputIdentity | Promise<string | EveRuntimeInputIdentity>;
+    readonly variableNames?: readonly string[];
+    readonly redactionRegistered?: boolean;
+}
+export interface EveNodeImage {
+    readonly reference: string;
+    readonly digest: string;
+}
+export interface EveProjectBuilderRequest {
+    readonly generationRoot: string;
+    readonly snapshotRoot: string;
+    readonly inputManifestPath: string;
+    readonly dockerfilePath: string | undefined;
+    readonly packageManagerVersion: string;
+    readonly installCommand: readonly [
+        "corepack",
+        "pnpm",
+        "install",
+        "--frozen-lockfile"
+    ];
+    readonly buildCommand: readonly ["./node_modules/.bin/eve", "build"];
+    readonly platform: "linux/amd64";
+    readonly sourceDigest: string;
+    /**
+     * The builder must execute only from this Eden-owned immutable snapshot.
+     * It is metadata for builders and test seams, not a permission to read the
+     * authored project root.
+     */
+    readonly buildContext: "immutable-snapshot";
+}
+export interface EveProjectBuilderResult {
+    readonly eveVersion?: string;
+    readonly imageId?: string;
+    readonly imagePlatform?: "linux/amd64";
+    readonly imageReference?: string;
+    readonly imageDigest?: string;
+}
+export interface EveProjectBuilder {
+    readonly nodeImage?: EveNodeImage;
+    build(request: EveProjectBuilderRequest): Promise<EveProjectBuilderResult>;
+    discard?(result: EveProjectBuilderResult): Promise<void>;
+}
+export interface EveProjectSnapshotOptions {
+    readonly projectRoot: string;
+    /**
+     * This must identify one new Eden-owned generation directory. The function
+     * refuses an existing directory and never writes to a prior generation.
+     */
+    readonly artifactRoot: string;
+    readonly builder: EveProjectBuilder;
+    readonly runtimeConfig?: EveRuntimeConfigExclusion;
+    readonly nodeImage?: EveNodeImage;
+}
+export interface EveProjectFile {
+    readonly relativePath: string;
+    readonly sha256: string;
+    readonly byteLength: number;
+    readonly mode: number;
+}
+export interface EveProjectInputManifest {
+    readonly version: 1;
+    readonly requestedRoot: string;
+    readonly canonicalRoot: string;
+    readonly projectId: string;
+    readonly packageManager: "pnpm";
+    readonly packageManagerVersion: string;
+    readonly packageJsonSha256: string;
+    readonly lockfileSha256: string;
+    readonly sourceDigest: string;
+    readonly files: readonly EveProjectFile[];
+    readonly excludedRelativePaths: readonly string[];
+    readonly runtimeConfigInputIdentity?: string;
+    readonly runtimeVariableNames: readonly string[];
+}
+export interface EveProjectSnapshot {
+    readonly generationId: string;
+    readonly path: string;
+    readonly sha256: string;
+    readonly includedFileCount: number;
+    readonly excludedCategories: readonly string[];
+    readonly sourceRaceChecked: boolean;
+}
+export interface EveProjectOutput {
+    readonly entrypointPath: ".output/server/index.mjs";
+    readonly sha256: string;
+    readonly regularFile: true;
+    readonly symlinkEscape: false;
+    readonly outputDigest: string;
+    readonly fileCount: number;
+}
+export interface EveProjectBuildCandidate {
+    readonly generationId: string;
+    readonly generationRoot: string;
+    readonly snapshotRoot: string;
+    readonly inputManifestPath: string;
+    readonly packageManager: "pnpm";
+    readonly packageManagerVersion: string;
+    readonly installCommand: readonly [
+        "corepack",
+        "pnpm",
+        "install",
+        "--frozen-lockfile"
+    ];
+    readonly buildCommand: readonly ["./node_modules/.bin/eve", "build"];
+    readonly eveExecutable: "node_modules/.bin/eve";
+    readonly eveVersion: string;
+    readonly packageJsonSha256: string;
+    readonly lockfileSha256: string;
+    readonly sourceDigest: string;
+    readonly snapshotDigest: string;
+    readonly generatedOutput: EveProjectOutput;
+    readonly runtimeConfigInputIdentity?: string;
+    readonly runtimeVariableNames: readonly string[];
+}
+export interface EveProjectToolchain {
+    readonly nodeVersion: "24.17.0";
+    readonly packageManager: "pnpm";
+    readonly packageManagerVersion: string;
+    readonly installCommand: readonly [
+        "corepack",
+        "pnpm",
+        "install",
+        "--frozen-lockfile"
+    ];
+    readonly buildCommand: readonly ["./node_modules/.bin/eve", "build"];
+    readonly startCommand: readonly [
+        "./node_modules/.bin/eve",
+        "start",
+        "--host",
+        "0.0.0.0",
+        "--port",
+        "8080"
+    ];
+    readonly eveExecutable: "node_modules/.bin/eve";
+    readonly eveVersion: string;
+    readonly lockfileUnchanged: true;
+    readonly nativeBuildPlatform: "linux/amd64";
+}
+export interface EveProjectImage {
+    readonly dockerfilePath: string | null;
+    readonly platform: "linux/amd64";
+    readonly builderImage: string | null;
+    readonly runtimeImage: string | null;
+    readonly imageId: string | null;
+    readonly imageReference: string | null;
+    readonly imageDigest: string | null;
+    readonly launchCommand: readonly [
+        "./node_modules/.bin/eve",
+        "start",
+        "--host",
+        "0.0.0.0",
+        "--port",
+        "8080"
+    ];
+    readonly workingDirectory: "/app";
+    readonly hostEnvironment: {
+        readonly HOST: "0.0.0.0";
+        readonly NITRO_HOST: "0.0.0.0";
+        readonly PORT: "8080";
+        readonly NITRO_PORT: "8080";
+        readonly NODE_ENV: "production";
+    };
+    readonly generatedOutput: EveProjectOutput | null;
+}
+export interface EveProjectRuntime {
+    readonly listenHost: "0.0.0.0";
+    readonly listenPort: 8080;
+    readonly healthMethod: "GET";
+    readonly healthPath: "/eve/v1/health";
+    readonly healthStatus: "not-run";
+    readonly healthVerified: false;
+    readonly durableLocalFilesystemClaim: false;
+}
+export interface EveProjectSecretsEvidence {
+    readonly runtimeVariableNames: readonly string[];
+    readonly valuesRecorded: false;
+    readonly excludedFromSnapshot: true;
+    readonly excludedFromBuildEnvironment: true;
+    readonly excludedFromDockerContext: true;
+    readonly excludedFromImage: true;
+    readonly excludedFromHistory: true;
+    readonly excludedFromManifestsAndLogs: true;
+    readonly redactionRegisteredBeforeChildren: boolean;
+}
+export interface EvePackagingCheck {
+    readonly id: string;
+    readonly status: "pass" | "blocked";
+    readonly subject: string;
+    readonly reason: string;
+    readonly remediation: string | null;
+}
+export interface EveProjectPackagingResult {
+    readonly schemaVersion: 1;
+    readonly worker: "eve-packaging-worker";
+    readonly operation: "local-package";
+    readonly status: "ready" | "blocked" | "failed";
+    readonly returnCode: EvePackagingCode | "EVE_PACKAGE_READY";
+    readonly deployable: boolean;
+    readonly project: {
+        readonly requestedRoot: string;
+        readonly canonicalRoot: string;
+        readonly projectId: string;
+        readonly packageJson: {
+            readonly path: "package.json";
+            readonly sha256: string;
+        };
+        readonly lockfile: {
+            readonly path: "pnpm-lock.yaml";
+            readonly sha256: string;
+        };
+        readonly sourceDigest: string;
+        readonly inputManifestPath: string;
+    } | null;
+    readonly candidate: EveProjectBuildCandidate | null;
+    readonly snapshot: EveProjectSnapshot | null;
+    readonly toolchain: EveProjectToolchain | null;
+    readonly image: EveProjectImage | null;
+    readonly runtime: EveProjectRuntime | null;
+    readonly secrets: EveProjectSecretsEvidence;
+    readonly checks: readonly EvePackagingCheck[];
+    readonly candidateImageId: string | null;
+    readonly candidateImageRetainedLocally: boolean;
+    readonly writtenPaths: readonly string[];
+    readonly error: {
+        readonly code: EvePackagingCode;
+        readonly subject: string;
+        readonly reason: string;
+        readonly remediation: string;
+    } | null;
+}
+export declare class EvePackagingError extends Error {
+    readonly code: EvePackagingCode;
+    readonly subject: string;
+    readonly remediation: string;
+    constructor(options: {
+        readonly code: EvePackagingCode;
+        readonly subject: string;
+        readonly reason: string;
+        readonly remediation: string;
+    });
+}
+export declare function buildEveProjectSnapshot(options: EveProjectSnapshotOptions): Promise<EveProjectPackagingResult>;
+export declare function revalidateEveProjectCandidateInputs(candidate: EveProjectBuildCandidate, runtimeConfig?: EveRuntimeConfigExclusion): Promise<void>;
+export declare function createDockerEveProjectBuilder(options: {
+    readonly nodeImage: EveNodeImage;
+    readonly dockerCommand?: string;
+}): EveProjectBuilder;
+//# sourceMappingURL=eve-packaging.d.ts.map