@lionden/plugin-deploy 0.1.0

package/dist/deployment-state.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Deployment state file I/O.
+ *
+ * Directory layout under `deploymentsDir`:
+ *
+ * ```
+ * deployments/<networkName>/
+ *   .network.json                                       # NetworkMetadata
+ *   <programId>.json                                    # DeploymentRecord (latest)
+ *   <programId>.abi.json                                # ABI snapshot (for export)
+ *   .history/<programId>/<historyCount>-<timestamp>.json # historical entries
+ *   .pending/<programId>.json                           # crash recovery markers
+ * deployments/_exports/<networkName>.json            # export bundles
+ * ```
+ *
+ * All writes use write-to-tmp + rename for atomicity.
+ */
+import type { ProgramABI } from "@lionden/leo-compiler";
+import type { DeploymentHistoryEntry, DeploymentRecord, ExportBundle, NetworkMetadata, PendingDeployment } from "./deployment-types.js";
+export declare function writeDeploymentRecord(deploymentsDir: string, network: string, record: DeploymentRecord): void;
+export declare function readDeploymentRecord(deploymentsDir: string, network: string, programId: string): DeploymentRecord | null;
+/**
+ * Read all deployment records for a network.
+ * Excludes dotfiles (`.network.json`, `.history/`, `.pending/`) and
+ * ABI snapshots (`*.abi.json`).
+ */
+export declare function readAllDeploymentRecords(deploymentsDir: string, network: string): DeploymentRecord[];
+export declare function writeAbiSnapshot(deploymentsDir: string, network: string, programId: string, abi: ProgramABI): void;
+export declare function readAbiSnapshot(deploymentsDir: string, network: string, programId: string): ProgramABI | null;
+export declare function deleteAbiSnapshot(deploymentsDir: string, network: string, programId: string): void;
+export declare function appendHistory(deploymentsDir: string, network: string, programId: string, entry: DeploymentHistoryEntry): void;
+export declare function readHistory(deploymentsDir: string, network: string, programId: string): DeploymentHistoryEntry[];
+export declare function writeNetworkMetadata(deploymentsDir: string, network: string, meta: NetworkMetadata): void;
+export declare function readNetworkMetadata(deploymentsDir: string, network: string): NetworkMetadata | null;
+export declare function writePendingMarker(deploymentsDir: string, network: string, pending: PendingDeployment): void;
+export declare function readPendingMarker(deploymentsDir: string, network: string, programId: string): PendingDeployment | null;
+export declare function deletePendingMarker(deploymentsDir: string, network: string, programId: string): void;
+export declare function listPendingMarkers(deploymentsDir: string, network: string): string[];
+export declare function writeExportBundle(deploymentsDir: string, network: string, bundle: ExportBundle): void;
+//# sourceMappingURL=deployment-state.d.ts.map

package/dist/deployment-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-state.d.ts","sourceRoot":"","sources":["../src/deployment-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAqD/B,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAKN;AAED,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,gBAAgB,GAAG,IAAI,CAIzB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GACd,gBAAgB,EAAE,CAmBpB;AAMD,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,UAAU,GACd,IAAI,CAKN;AAED,wBAAgB,eAAe,CAC7B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,UAAU,GAAG,IAAI,CASnB;AAED,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,IAAI,CAEN;AAMD,wBAAgB,aAAa,CAC3B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,sBAAsB,GAC5B,IAAI,CAKN;AAED,wBAAgB,WAAW,CACzB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,sBAAsB,EAAE,CAkB1B;AAMD,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,GACpB,IAAI,CAEN;AAED,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GACd,eAAe,GAAG,IAAI,CAQxB;AAMD,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,GACzB,IAAI,CAKN;AAED,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,iBAAiB,GAAG,IAAI,CAQ1B;AAED,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,IAAI,CAKN;AAED,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAOpF;AAMD,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,YAAY,GACnB,IAAI,CAEN"}

package/dist/deployment-state.js

@@ -0,0 +1,204 @@
+/**
+ * Deployment state file I/O.
+ *
+ * Directory layout under `deploymentsDir`:
+ *
+ * ```
+ * deployments/<networkName>/
+ *   .network.json                                       # NetworkMetadata
+ *   <programId>.json                                    # DeploymentRecord (latest)
+ *   <programId>.abi.json                                # ABI snapshot (for export)
+ *   .history/<programId>/<historyCount>-<timestamp>.json # historical entries
+ *   .pending/<programId>.json                           # crash recovery markers
+ * deployments/_exports/<networkName>.json            # export bundles
+ * ```
+ *
+ * All writes use write-to-tmp + rename for atomicity.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { parseAbi } from "@lionden/leo-compiler";
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+function networkDir(deploymentsDir, network) {
+    return path.join(deploymentsDir, network);
+}
+function recordPath(deploymentsDir, network, programId) {
+    return path.join(networkDir(deploymentsDir, network), `${programId}.json`);
+}
+function abiSnapshotPath(deploymentsDir, network, programId) {
+    return path.join(networkDir(deploymentsDir, network), `${programId}.abi.json`);
+}
+function networkMetaPath(deploymentsDir, network) {
+    return path.join(networkDir(deploymentsDir, network), ".network.json");
+}
+function pendingDir(deploymentsDir, network) {
+    return path.join(networkDir(deploymentsDir, network), ".pending");
+}
+function pendingPath(deploymentsDir, network, programId) {
+    return path.join(pendingDir(deploymentsDir, network), `${programId}.json`);
+}
+function historyDir(deploymentsDir, network, programId) {
+    return path.join(networkDir(deploymentsDir, network), ".history", programId);
+}
+function exportPath(deploymentsDir, network) {
+    return path.join(deploymentsDir, "_exports", `${network}.json`);
+}
+/**
+ * Atomic write: write to a temp file, then rename into place.
+ */
+function atomicWrite(filePath, content) {
+    const dir = path.dirname(filePath);
+    fs.mkdirSync(dir, { recursive: true });
+    const tmp = `${filePath}.tmp`;
+    fs.writeFileSync(tmp, content, "utf-8");
+    fs.renameSync(tmp, filePath);
+}
+// ---------------------------------------------------------------------------
+// Deployment records
+// ---------------------------------------------------------------------------
+export function writeDeploymentRecord(deploymentsDir, network, record) {
+    atomicWrite(recordPath(deploymentsDir, network, record.programId), JSON.stringify(record, null, 2) + "\n");
+}
+export function readDeploymentRecord(deploymentsDir, network, programId) {
+    const p = recordPath(deploymentsDir, network, programId);
+    if (!fs.existsSync(p))
+        return null;
+    return JSON.parse(fs.readFileSync(p, "utf-8"));
+}
+/**
+ * Read all deployment records for a network.
+ * Excludes dotfiles (`.network.json`, `.history/`, `.pending/`) and
+ * ABI snapshots (`*.abi.json`).
+ */
+export function readAllDeploymentRecords(deploymentsDir, network) {
+    const dir = networkDir(deploymentsDir, network);
+    if (!fs.existsSync(dir))
+        return [];
+    const records = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (!entry.isFile())
+            continue;
+        if (entry.name.startsWith("."))
+            continue;
+        if (!entry.name.endsWith(".json"))
+            continue;
+        if (entry.name.endsWith(".abi.json"))
+            continue;
+        try {
+            const raw = fs.readFileSync(path.join(dir, entry.name), "utf-8");
+            records.push(JSON.parse(raw));
+        }
+        catch {
+            // Skip corrupt files
+        }
+    }
+    return records;
+}
+// ---------------------------------------------------------------------------
+// ABI snapshots
+// ---------------------------------------------------------------------------
+export function writeAbiSnapshot(deploymentsDir, network, programId, abi) {
+    atomicWrite(abiSnapshotPath(deploymentsDir, network, programId), JSON.stringify(abi, null, 2) + "\n");
+}
+export function readAbiSnapshot(deploymentsDir, network, programId) {
+    const p = abiSnapshotPath(deploymentsDir, network, programId);
+    if (!fs.existsSync(p))
+        return null;
+    try {
+        // Use parseAbi for normalization (ensures all arrays are present, same as readAbiFromArtifacts)
+        return parseAbi(fs.readFileSync(p, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function deleteAbiSnapshot(deploymentsDir, network, programId) {
+    fs.rmSync(abiSnapshotPath(deploymentsDir, network, programId), { force: true });
+}
+// ---------------------------------------------------------------------------
+// History
+// ---------------------------------------------------------------------------
+export function appendHistory(deploymentsDir, network, programId, entry) {
+    const dir = historyDir(deploymentsDir, network, programId);
+    const ts = new Date().toISOString().replace(/[:.]/g, "-");
+    const filename = `${String(entry.record.historyCount).padStart(6, "0")}-${ts}.json`;
+    atomicWrite(path.join(dir, filename), JSON.stringify(entry, null, 2) + "\n");
+}
+export function readHistory(deploymentsDir, network, programId) {
+    const dir = historyDir(deploymentsDir, network, programId);
+    if (!fs.existsSync(dir))
+        return [];
+    const entries = [];
+    const files = fs
+        .readdirSync(dir)
+        .filter((f) => f.endsWith(".json"))
+        .sort();
+    for (const file of files) {
+        try {
+            const raw = fs.readFileSync(path.join(dir, file), "utf-8");
+            entries.push(JSON.parse(raw));
+        }
+        catch {
+            // Skip corrupt files
+        }
+    }
+    return entries;
+}
+// ---------------------------------------------------------------------------
+// Network metadata
+// ---------------------------------------------------------------------------
+export function writeNetworkMetadata(deploymentsDir, network, meta) {
+    atomicWrite(networkMetaPath(deploymentsDir, network), JSON.stringify(meta, null, 2) + "\n");
+}
+export function readNetworkMetadata(deploymentsDir, network) {
+    const p = networkMetaPath(deploymentsDir, network);
+    if (!fs.existsSync(p))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(p, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Pending markers
+// ---------------------------------------------------------------------------
+export function writePendingMarker(deploymentsDir, network, pending) {
+    atomicWrite(pendingPath(deploymentsDir, network, pending.programId), JSON.stringify(pending, null, 2) + "\n");
+}
+export function readPendingMarker(deploymentsDir, network, programId) {
+    const p = pendingPath(deploymentsDir, network, programId);
+    if (!fs.existsSync(p))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(p, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function deletePendingMarker(deploymentsDir, network, programId) {
+    const p = pendingPath(deploymentsDir, network, programId);
+    if (fs.existsSync(p)) {
+        fs.unlinkSync(p);
+    }
+}
+export function listPendingMarkers(deploymentsDir, network) {
+    const dir = pendingDir(deploymentsDir, network);
+    if (!fs.existsSync(dir))
+        return [];
+    return fs
+        .readdirSync(dir)
+        .filter((f) => f.endsWith(".json"))
+        .map((f) => f.slice(0, -".json".length));
+}
+// ---------------------------------------------------------------------------
+// Export bundles
+// ---------------------------------------------------------------------------
+export function writeExportBundle(deploymentsDir, network, bundle) {
+    atomicWrite(exportPath(deploymentsDir, network), JSON.stringify(bundle, null, 2) + "\n");
+}
+//# sourceMappingURL=deployment-state.js.map

package/dist/deployment-state.js.map

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

package/dist/deployment-types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Deployment state types.
+ *
+ * Defines the record union (CompleteDeploymentRecord | DegradedDeploymentRecord |
+ * RecoveredDeploymentRecord), history entries, network metadata, pending markers,
+ * and export bundle shapes.
+ */
+import type { AleoNetwork } from "@lionden/config";
+import type { ProgramABI } from "@lionden/leo-compiler";
+interface DeploymentRecordBase {
+    readonly programId: string;
+    /** Canonical local source identity when deployment used a runtime rename. */
+    readonly sourceProgramId?: string;
+    /** Name of the network in config (e.g. "devnode", "testnet") */
+    readonly network: string;
+    /** REST API endpoint of the node */
+    readonly endpoint: string;
+    /** ISO 8601 timestamp of last update */
+    readonly updatedAt: string;
+    /** On-chain program edition. */
+    readonly edition: number;
+    /** Number of historical entries for this program */
+    readonly historyCount: number;
+}
+/**
+ * Full provenance — written after a successful deploy or upgrade.
+ */
+export interface CompleteDeploymentRecord extends DeploymentRecordBase {
+    readonly status: "complete";
+    readonly txId: string;
+    readonly blockHeight: number;
+    readonly deployerAddress: string;
+    readonly deployedAt: string;
+    readonly feePaid?: number;
+}
+/**
+ * Discovered on-chain with no local provenance (imported from another
+ * deploy process, or present before LionDen was used).
+ */
+export interface DegradedDeploymentRecord extends DeploymentRecordBase {
+    readonly status: "degraded";
+    readonly txId: null;
+    readonly blockHeight: null;
+    readonly deployerAddress: null;
+    readonly deployedAt: null;
+    readonly feePaid: null;
+}
+/**
+ * Recovered from a pending marker after a crash — we know the intent and
+ * deployer, and may know confirmed transaction provenance.
+ */
+export interface RecoveredDeploymentRecord extends DeploymentRecordBase {
+    readonly status: "recovered";
+    readonly txId: string | null;
+    readonly blockHeight: number | null;
+    readonly deployerAddress: string;
+    readonly deployedAt: string;
+    readonly feePaid: null;
+}
+export type DeploymentRecord = CompleteDeploymentRecord | DegradedDeploymentRecord | RecoveredDeploymentRecord;
+export interface DeploymentHistoryEntry {
+    readonly record: DeploymentRecord;
+    readonly action: "deploy" | "upgrade";
+}
+/**
+ * Written to `deployments/<network>/.network.json`.
+ * Used to detect config drift (e.g. "testnet" endpoint changed).
+ */
+export interface NetworkMetadata {
+    readonly type: "devnode" | "http";
+    readonly networkId: AleoNetwork;
+    readonly endpoint: string;
+    /** Reserved for future genesis-hash verification */
+    readonly chainIdentifier?: string;
+}
+/**
+ * Written to `deployments/<network>/.pending/<programId>.json` before
+ * broadcast, deleted by `record()` after confirmation.
+ * Used for crash recovery.
+ */
+export interface PendingDeployment {
+    readonly programId: string;
+    readonly sourceProgramId?: string;
+    readonly action: "deploy" | "upgrade";
+    readonly txId?: string;
+    readonly blockHeight?: number;
+    readonly previousEdition?: number;
+    readonly startedAt: string;
+    readonly deployerAddress: string;
+    readonly priorityFee: number;
+    readonly privateFee: boolean;
+    readonly network: string;
+    readonly endpoint: string;
+}
+export interface ExportedProgram {
+    readonly programId: string;
+    readonly abi: ProgramABI | null;
+    readonly txId: string | null;
+    readonly status: "complete" | "degraded" | "recovered";
+}
+export interface ExportBundle {
+    readonly network: string;
+    readonly networkInfo: {
+        readonly type: "devnode" | "http";
+        readonly networkId: AleoNetwork;
+        readonly endpoint: string;
+    };
+    readonly exportedAt: string;
+    readonly programs: Record<string, ExportedProgram>;
+}
+export {};
+//# sourceMappingURL=deployment-types.d.ts.map

package/dist/deployment-types.d.ts.map

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

package/dist/deployment-types.js

@@ -0,0 +1,9 @@
+/**
+ * Deployment state types.
+ *
+ * Defines the record union (CompleteDeploymentRecord | DegradedDeploymentRecord |
+ * RecoveredDeploymentRecord), history entries, network metadata, pending markers,
+ * and export bundle shapes.
+ */
+export {};
+//# sourceMappingURL=deployment-types.js.map

package/dist/deployment-types.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Shared error classes for the deploy plugin.
+ */
+export declare class DeployError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,10 @@
+/**
+ * Shared error classes for the deploy plugin.
+ */
+export class DeployError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "DeployError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import { type LionDenPlugin } from "@lionden/core";
+declare const pluginDeploy: LionDenPlugin;
+export default pluginDeploy;
+export type { DeployOptions, DeployResult, DeployTaskResult, DryRunResult, } from "./deploy-task.js";
+export { DeployError, readLeoSourcesFromDir, resolveDeployTargets, } from "./deploy-task.js";
+export type { DeploymentManager, PreflightOptions, RecordOptions } from "./deployment-manager.js";
+export { DeploymentManagerImpl } from "./deployment-manager.js";
+export type { CompleteDeploymentRecord, DegradedDeploymentRecord, DeploymentHistoryEntry, DeploymentRecord, ExportBundle, ExportedProgram, NetworkMetadata, PendingDeployment, RecoveredDeploymentRecord, } from "./deployment-types.js";
+export { checkProgramOnChain } from "./on-chain-check.js";
+export type { DeployPreflightResult, PreflightError, PreflightWarning, ProgramPreflightOutcome, } from "./preflight.js";
+export type { DeploymentContext, DeploymentRecipe, ProgramDeploymentTarget, RecipeDeployOptions, RecipeDeployResult, RecipeExecuteOptions, RecipeExecuteResult, } from "./recipe-types.js";
+export type { UpgradeOptions, UpgradeResult } from "./upgrade-task.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,aAAa,EAKnB,MAAM,eAAe,CAAC;AA6LvB,QAAA,MAAM,YAAY,EAAE,aAmBnB,CAAC;AAEF,eAAe,YAAY,CAAC;AAM5B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAClG,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,YAAY,EACV,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,YAAY,EACV,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,184 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { logSuccess, pluralize, task, } from "@lionden/core";
+import { deployAction } from "./deploy-task.js";
+import { DeploymentManagerImpl } from "./deployment-manager.js";
+import { DeployError } from "./errors.js";
+import { recipeAction } from "./recipe-task.js";
+import { upgradeAction } from "./upgrade-task.js";
+// ---------------------------------------------------------------------------
+// Config hooks
+// ---------------------------------------------------------------------------
+const configHooks = {
+    validateResolvedConfig(config) {
+        const errors = [];
+        if (config.deploy.defaultPriorityFee < 0) {
+            errors.push({
+                path: "deploy.defaultPriorityFee",
+                message: "Priority fee cannot be negative",
+            });
+        }
+        if (config.deploy.confirmationTimeout <= 0) {
+            errors.push({
+                path: "deploy.confirmationTimeout",
+                message: "Confirmation timeout must be positive",
+            });
+        }
+        if (config.deploy.interDeploymentDelay !== undefined &&
+            config.deploy.interDeploymentDelay < 0) {
+            errors.push({
+                path: "deploy.interDeploymentDelay",
+                message: "Inter-deployment delay cannot be negative",
+            });
+        }
+        if ("deploymentsDir" in config.deploy &&
+            typeof config.deploy.deploymentsDir === "string" &&
+            config.deploy.deploymentsDir.trim() === "") {
+            errors.push({
+                path: "deploy.deploymentsDir",
+                message: "Deployments directory cannot be empty",
+            });
+        }
+        return errors;
+    },
+};
+// ---------------------------------------------------------------------------
+// Tasks
+// ---------------------------------------------------------------------------
+const deployTask = task("deploy", "Deploy Aleo programs to a network")
+    .addOption({
+    name: "program",
+    type: "string",
+    description: "Deploy only the specified program",
+})
+    .addOption({
+    name: "priorityFee",
+    type: "number",
+    description: "Priority fee in microcredits",
+})
+    .addOption({
+    name: "rename",
+    type: "string",
+    description: "Deploy the selected source program under a different on-chain program id",
+})
+    .addFlag({
+    name: "skipConfirm",
+    description: "Skip waiting for transaction confirmation",
+})
+    .addFlag({
+    name: "noCompile",
+    description: "Skip compilation before deploying (artifacts must already exist)",
+})
+    .addFlag({
+    name: "preflight",
+    description: "Run pre-flight checks only — do not deploy",
+})
+    .addFlag({
+    name: "dryRun",
+    description: "Build transaction but do not broadcast (devnode only)",
+})
+    .addFlag({
+    name: "noSkipDeployed",
+    description: "Fail if any program is already deployed on-chain",
+})
+    .addFlag({
+    name: "export",
+    description: "Export deployment bundle after deploying",
+})
+    .setAction(deployAction)
+    .build();
+const upgradeTask = task("upgrade", "Upgrade a deployed Aleo program")
+    .addOption({
+    name: "program",
+    type: "string",
+    description: "Program to upgrade (required)",
+    required: true,
+})
+    .addOption({
+    name: "priorityFee",
+    type: "number",
+    description: "Priority fee in microcredits",
+})
+    .addFlag({
+    name: "skipConfirm",
+    description: "Skip waiting for transaction confirmation",
+})
+    .setAction(upgradeAction)
+    .build();
+const exportTask = task("export", "Export deployment addresses and ABIs for frontend consumption")
+    .addOption({
+    name: "out",
+    type: "string",
+    description: "Output file path (default: deployments/_exports/<network>.json)",
+})
+    .setAction(exportAction)
+    .build();
+const recipeTask = task("recipe", "Run a deployment recipe")
+    .addOption({
+    name: "file",
+    type: "string",
+    description: "Path to recipe file (relative to project root)",
+    required: true,
+})
+    .addOption({
+    name: "export",
+    type: "string",
+    description: "Named export to run (default: 'default')",
+})
+    .addFlag({
+    name: "noCompile",
+    description: "Skip compilation before running recipe",
+})
+    .setAction(recipeAction)
+    .build();
+async function exportAction(args, lre) {
+    const networkName = args["network"] ?? lre.config.defaultNetwork;
+    const outPath = args["out"];
+    const manager = lre.deployments;
+    if (!manager) {
+        throw new DeployError("DeploymentManager not available. Ensure @lionden/plugin-deploy is registered as a plugin.");
+    }
+    const networkConfig = lre.config.networks[networkName];
+    if (networkConfig?.type === "devnode") {
+        const networkManager = lre.network;
+        await networkManager.connect(networkName);
+    }
+    const bundle = await manager.export(networkName);
+    const programCount = Object.keys(bundle.programs).length;
+    const programCountText = `${programCount} ${pluralize("program", programCount)}`;
+    if (outPath) {
+        fs.mkdirSync(path.dirname(path.resolve(outPath)), { recursive: true });
+        fs.writeFileSync(path.resolve(outPath), JSON.stringify(bundle, null, 2));
+        console.log(`${logSuccess("Exported")} ${programCountText} to ${outPath}`);
+    }
+    else {
+        console.log(`${logSuccess("Exported")} ${programCountText} for network "${networkName}"`);
+    }
+    return bundle;
+}
+// ---------------------------------------------------------------------------
+// Plugin definition
+// ---------------------------------------------------------------------------
+const pluginDeploy = {
+    id: "@lionden/plugin-deploy",
+    name: "Deploy Plugin",
+    hookHandlers: {
+        config: configHooks,
+    },
+    // --prove is a framework built-in global (see arg-names.ts), so it is not
+    // declared here. deployAction/upgradeAction still read it via
+    // resolveProveOption(), which consults lre.globalOptions["prove"] (seeded by
+    // the CLI from the built-in --prove) and LIONDEN_PROVE.
+    tasks: [deployTask, upgradeTask, exportTask, recipeTask],
+    extendLre(lre) {
+        const networkAccessor = () => lre.network;
+        lre["deployments"] = new DeploymentManagerImpl(lre.config, networkAccessor, lre.artifacts);
+    },
+};
+export default pluginDeploy;
+// Deploy task
+export { DeployError, readLeoSourcesFromDir, resolveDeployTargets, } from "./deploy-task.js";
+export { DeploymentManagerImpl } from "./deployment-manager.js";
+// On-chain check
+export { checkProgramOnChain } from "./on-chain-check.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/leo-sources.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Utility for reading Leo source files from a directory.
+ * Extracted to avoid circular dependencies between deploy-task and upgrade-task.
+ */
+/**
+ * Read all .leo source files from an absolute source directory.
+ * Uses the discovered sourceDir (from discoverUnits) rather than
+ * deriving the path from the program ID.
+ */
+export declare function readLeoSourcesFromDir(sourceDir: string): string;
+//# sourceMappingURL=leo-sources.d.ts.map

package/dist/leo-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leo-sources.d.ts","sourceRoot":"","sources":["../src/leo-sources.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAM/D"}