@lionden/plugin-deploy 0.1.0

package/dist/recipe-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-task.d.ts","sourceRoot":"","sources":["../src/recipe-task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE/D,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,kBAAkB,CAAC;AAM1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAM3D,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,yBAAyB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAmDlB;AAMD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,yBAAyB,EAC9B,UAAU,EAAE,iBAAiB,EAC7B,WAAW,EAAE,MAAM,EACnB,aAAa,UAAQ,GACpB,iBAAiB,CAgGnB"}

package/dist/recipe-task.js

@@ -0,0 +1,201 @@
+/**
+ * Recipe task — run a deployment recipe from the CLI.
+ *
+ * A recipe is a user-defined async function exported from a TypeScript/JS file.
+ * The task compiles the project once, creates a DeploymentContext, then calls
+ * the recipe function.
+ *
+ * Usage:
+ *   lionden recipe --file ./recipes/setup.ts
+ *   lionden recipe --file ./recipes/setup.ts --export setupToken
+ *   lionden recipe --file ./recipes/setup.ts --network testnet
+ */
+import * as path from "node:path";
+import { createNamedAccountAccessor, normalizeProgramId } from "@lionden/config";
+import { logAction, programNameFromTarget, sourceProgramNameFromTarget } from "@lionden/core";
+import { DEVNODE_ACCOUNTS } from "@lionden/network";
+import { DeployError } from "./errors.js";
+import { resolveProveOption } from "./prove.js";
+// ---------------------------------------------------------------------------
+// Recipe action
+// ---------------------------------------------------------------------------
+export async function recipeAction(args, lre) {
+    const file = args["file"];
+    if (!file) {
+        throw new DeployError("The --file option is required.\nUsage: lionden recipe --file ./recipes/setup.ts");
+    }
+    const exportName = args["export"] ?? "default";
+    // Capture the explicit network separately from the resolved `networkName`: only
+    // an explicitly-supplied network is forwarded into the implicit compile, so a
+    // default run (no `network` arg) leaves compile on `config.defaultNetwork`.
+    const explicitNetwork = typeof args["network"] === "string" ? args["network"] : undefined;
+    const networkName = explicitNetwork ?? lre.config.defaultNetwork;
+    const noCompile = args["noCompile"] ?? false;
+    // 1. Compile first (unless --no-compile). Forward the explicit network so the
+    // implicit compile resolves imported on-chain sources + `.env` from the
+    // deploying network; omit it on a default run (byte-for-byte unchanged).
+    if (!noCompile) {
+        if (explicitNetwork) {
+            await lre.tasks.run("compile", { network: explicitNetwork });
+        }
+        else {
+            await lre.tasks.run("compile");
+        }
+    }
+    // 2. Connect to network
+    const networkManager = lre.network;
+    const connection = await networkManager.connect(networkName);
+    // 3. Create deployment context. Resolve the run-level prove preference once
+    // (programmatic args.prove → --prove global → LIONDEN_PROVE → false) so
+    // ctx.execute inherits it; per-call opts can still override.
+    const resolvedRecipeProve = resolveProveOption(args, lre);
+    const ctx = createCliDeploymentContext(lre, connection, networkName, resolvedRecipeProve);
+    // 4. Import and run recipe — resolve relative to project root, not cwd
+    const resolved = path.isAbsolute(file) ? file : path.resolve(lre.config.paths.root, file);
+    const mod = await import(resolved);
+    const recipeFn = mod[exportName];
+    if (typeof recipeFn !== "function") {
+        throw new DeployError(`No function "${exportName}" exported from "${file}".`);
+    }
+    console.log(`${logAction("Running recipe")} ${resolved}#${exportName} on network "${networkName}"`);
+    const result = await recipeFn(ctx);
+    return result;
+}
+// ---------------------------------------------------------------------------
+// CLI deployment context factory
+// ---------------------------------------------------------------------------
+export function createCliDeploymentContext(lre, connection, networkName, resolvedProve = false) {
+    return {
+        lre,
+        connection,
+        network: networkName,
+        accounts: connection.type === "devnode" ? DEVNODE_ACCOUNTS : [],
+        namedAccounts: lre.namedAccounts,
+        named: createNamedAccountAccessor(lre.namedAccounts, networkName),
+        async deploy(program, opts) {
+            const programName = programNameFromTarget(program);
+            const sourceProgramName = sourceProgramNameFromTarget(program);
+            const normalizedId = normalizeProgramId(programName);
+            const normalizedSourceId = normalizeProgramId(sourceProgramName);
+            const rename = normalizedSourceId === normalizedId ? undefined : normalizedId;
+            const expectedSourceProgramId = rename ? normalizedSourceId : undefined;
+            const defaultNoCompile = !rename;
+            const deploymentCache = lre.deployments;
+            if (!opts?.noSkipDeployed) {
+                const cached = getCachedDeployment(deploymentCache, normalizedId, networkName);
+                if (isCompleteMatchingRecord(cached, normalizedId, expectedSourceProgramId)) {
+                    return { programId: normalizedId, txId: cached.txId };
+                }
+            }
+            const taskResult = await lre.tasks.run("deploy", {
+                program: rename ? normalizedSourceId : programName,
+                ...(rename ? { rename } : {}),
+                network: networkName,
+                noCompile: opts?.noCompile ?? defaultNoCompile,
+                priorityFee: opts?.priorityFee,
+                noSkipDeployed: opts?.noSkipDeployed,
+                // Forward the recipe's authoritative prove value (a per-call override
+                // wins; otherwise inherit the run-level `resolvedProve`), mirroring
+                // ctx.execute. resolvedProve already encodes the full args > --prove >
+                // LIONDEN_PROVE precedence, so passing it explicitly keeps deploy and
+                // execute consistent — including programmatic `tasks.run("recipe", {
+                // prove })` and an explicit `{ prove: false }` that must beat a truthy
+                // ambient env (Finding 2 escape hatch + run-level inheritance).
+                prove: opts?.prove ?? resolvedProve,
+            });
+            if (rename) {
+                const results = getDeployResults(taskResult);
+                const deployed = getDeployResultForProgram(results, normalizedId);
+                if (deployed) {
+                    return {
+                        programId: normalizeProgramId(deployed.programId),
+                        txId: deployed.txId,
+                    };
+                }
+                const cached = getCachedDeployment(deploymentCache, normalizedId, networkName);
+                if (isCompleteMatchingRecord(cached, normalizedId, expectedSourceProgramId)) {
+                    return { programId: normalizedId, txId: cached.txId };
+                }
+                throw createEmptyDeployResultError(programName, normalizedId, networkName, cached, true);
+            }
+            const results = getDeployResults(taskResult);
+            const deployed = getDeployResultForProgram(results, normalizedId);
+            if (deployed) {
+                return {
+                    programId: normalizeProgramId(deployed.programId),
+                    txId: deployed.txId,
+                };
+            }
+            const cached = getCachedDeployment(deploymentCache, normalizedId, networkName);
+            if (isCompleteMatchingRecord(cached, normalizedId)) {
+                return { programId: normalizedId, txId: cached.txId };
+            }
+            throw createEmptyDeployResultError(programName, normalizedId, networkName, cached);
+        },
+        async execute(programId, transitionName, args, opts) {
+            const mode = opts?.mode ?? "onchain";
+            const awaitOpt = mode === "onchain" ? { awaitConfirmation: opts?.awaitConfirmation ?? true } : {};
+            const result = await connection.execute(programId, transitionName, args, {
+                mode,
+                fee: opts?.fee,
+                prove: opts?.prove ?? resolvedProve,
+                signer: opts?.signer,
+                ...awaitOpt,
+            });
+            return {
+                outputs: result.outputs,
+                ...(result.rawOutputs === undefined ? {} : { rawOutputs: result.rawOutputs }),
+                txId: result.txId,
+            };
+        },
+    };
+}
+function getCachedDeployment(deploymentCache, programId, networkName) {
+    return deploymentCache?.getCached(programId, networkName) ?? null;
+}
+function isCompleteDeploymentWithTxId(record) {
+    return record?.status === "complete" && typeof record.txId === "string" && record.txId.length > 0;
+}
+function getDeployResultForProgram(results, normalizedId) {
+    return results.find((result) => normalizeProgramId(result.programId) === normalizedId);
+}
+function getDeployResults(taskResult) {
+    const wrapped = taskResult;
+    if (wrapped.mode !== "deploy") {
+        throw new DeployError(`Expected deploy task to return mode "deploy", got "${wrapped.mode}". ` +
+            `This may indicate --preflight or --dry-run was passed unexpectedly.`);
+    }
+    if (!Array.isArray(wrapped.results)) {
+        throw new DeployError('Expected deploy task to return { mode: "deploy", results: [...] }.');
+    }
+    return wrapped.results;
+}
+function isCompleteMatchingRecord(record, normalizedId, expectedSourceProgramId) {
+    const maybeRecord = record ?? null;
+    if (!isCompleteDeploymentWithTxId(maybeRecord))
+        return false;
+    if (expectedSourceProgramId === undefined) {
+        return (maybeRecord.sourceProgramId === undefined || maybeRecord.sourceProgramId === normalizedId);
+    }
+    return (maybeRecord.programId === normalizedId &&
+        maybeRecord.sourceProgramId === expectedSourceProgramId);
+}
+function createEmptyDeployResultError(requestedProgram, normalizedId, networkName, cached, expectsRename = false) {
+    const cacheRequirement = expectsRename
+        ? "no complete cached deployment with matching rename provenance exists"
+        : "no complete cached deployment with a txId exists";
+    return new DeployError(`Deploy task produced no transaction for "${requestedProgram}" on network "${networkName}", ` +
+        `and ${cacheRequirement} for "${normalizedId}" ` +
+        `(${describeCachedDeployment(cached)}). ` +
+        `Use { noSkipDeployed: true } when the recipe must fail instead of reusing or skipping an existing deployment.`);
+}
+function describeCachedDeployment(cached) {
+    if (!cached) {
+        return "cached state: none";
+    }
+    if (cached.status === "complete") {
+        return "cached state: complete record without txId";
+    }
+    return `cached state: ${cached.status} record without txId`;
+}
+//# sourceMappingURL=recipe-task.js.map

package/dist/recipe-task.js.map

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

package/dist/recipe-types.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Deployment recipe types.
+ *
+ * A deployment recipe is a reusable async function that deploys programs
+ * and executes setup transactions. The same recipe can run from tests
+ * (via TestContext, which structurally satisfies DeploymentContext) or
+ * from the CLI (via `lionden recipe --file ./path.ts`).
+ */
+import type { NamedAccountAccessor, NamedAccounts } from "@lionden/config";
+import type { LionDenRuntimeEnvironment, ProgramDeploymentTarget } from "@lionden/core";
+import type { DevnodeAccount, NetworkConnection, RawTransitionOutput, Signer } from "@lionden/network";
+export type { ProgramDeploymentTarget };
+export interface DeploymentContext {
+    /** Deploy a program by name or generated wrapper. Deploys transitive deps first. */
+    deploy(program: ProgramDeploymentTarget, options?: RecipeDeployOptions): Promise<RecipeDeployResult>;
+    /** Execute a transition on a deployed program. */
+    execute(programId: string, transitionName: string, args: string[], options?: RecipeExecuteOptions): Promise<RecipeExecuteResult>;
+    /** Pre-funded devnode accounts (empty on non-devnode networks). */
+    readonly accounts: readonly DevnodeAccount[];
+    /** Active network connection. */
+    readonly connection: NetworkConnection;
+    /** Full LRE for advanced use cases. */
+    readonly lre: LionDenRuntimeEnvironment;
+    /** The network name this context is connected to. */
+    readonly network: string;
+    /**
+     * Resolved named accounts for the active network.
+     * Empty object ({}) when no namedAccounts are configured in the project.
+     */
+    readonly namedAccounts: NamedAccounts;
+    /** Domain-native accessor for required named account roles. */
+    readonly named: NamedAccountAccessor;
+}
+export interface RecipeDeployOptions {
+    priorityFee?: number;
+    noCompile?: boolean;
+    /** Fail instead of reusing or skipping already-deployed programs. */
+    noSkipDeployed?: boolean;
+    /**
+     * Override proof generation for this deploy. When omitted, the deploy task
+     * self-resolves the run-level preference (`--prove` / `LIONDEN_PROVE`); set
+     * it (e.g. `{ prove: false }`) to skip proving one fixture deploy while the
+     * rest of the recipe proves.
+     */
+    prove?: boolean;
+}
+export interface RecipeDeployResult {
+    readonly programId: string;
+    readonly txId: string;
+}
+export interface RecipeExecuteOptions {
+    mode?: "local" | "onchain";
+    fee?: number;
+    /**
+     * Override proof generation for this execution. Defaults to the recipe's
+     * run-level prove preference (`--prove` / `LIONDEN_PROVE`); a per-call value
+     * beats it.
+     */
+    prove?: boolean;
+    signer?: Signer;
+    /**
+     * On-chain mode only. When omitted or `true`, the call awaits confirmation
+     * and returns the matching transition's parsed outputs. When `false`, the
+     * call returns immediately after broadcast with `outputs: []`; callers can
+     * fetch outputs later via `connection.getTransitionOutputs(...)`.
+     */
+    awaitConfirmation?: boolean;
+}
+export interface RecipeExecuteResult {
+    readonly outputs: string[];
+    /**
+     * Faithful on-chain output shape including the `idOnly` discriminator for
+     * dynamic-record outputs. Present only when the call awaited confirmation.
+     */
+    readonly rawOutputs?: readonly RawTransitionOutput[];
+    readonly txId?: string;
+}
+/**
+ * A deployment recipe is an async function that receives a {@link DeploymentContext}
+ * and performs deployment + setup steps. Recipes are the reusable unit — the
+ * same function can run from both tests and CLI.
+ *
+ * @example
+ * ```typescript
+ * import type { DeploymentRecipe } from "@lionden/plugin-deploy";
+ *
+ * export const setupToken: DeploymentRecipe<{ tokenId: string }> = async (ctx) => {
+ *   const result = await ctx.deploy("token", { noCompile: true });
+ *   await ctx.execute("token.aleo", "mint_public", [ctx.accounts[0].address, "1000u64"]);
+ *   return { tokenId: result.programId };
+ * };
+ * ```
+ */
+export type DeploymentRecipe<T = void> = (ctx: DeploymentContext) => Promise<T>;
+//# sourceMappingURL=recipe-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-types.d.ts","sourceRoot":"","sources":["../src/recipe-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,KAAK,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxF,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,MAAM,EACP,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,uBAAuB,EAAE,CAAC;AAMxC,MAAM,WAAW,iBAAiB;IAChC,oFAAoF;IACpF,MAAM,CACJ,OAAO,EAAE,uBAAuB,EAChC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/B,kDAAkD;IAClD,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,iCAAiC;IACjC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,uCAAuC;IACvC,QAAQ,CAAC,GAAG,EAAE,yBAAyB,CAAC;IACxC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qEAAqE;IACrE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/recipe-types.js

@@ -0,0 +1,10 @@
+/**
+ * Deployment recipe types.
+ *
+ * A deployment recipe is a reusable async function that deploys programs
+ * and executes setup transactions. The same recipe can run from tests
+ * (via TestContext, which structurally satisfies DeploymentContext) or
+ * from the CLI (via `lionden recipe --file ./path.ts`).
+ */
+export {};
+//# sourceMappingURL=recipe-types.js.map

package/dist/recipe-types.js.map

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

package/dist/upgrade-task.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Upgrade task implementation (thin).
+ *
+ * Flow: connect → resolve signer → guard a prior record exists → compile v2 →
+ * build upgrade tx → broadcast → wait → record → fire hook → optional export.
+ *
+ * No ABI-compatibility, constructor-immutability, edition, or admin-address
+ * validation — Leo's built-in tooling owns upgrade correctness. The newly
+ * compiled ABI is still recorded so `export` has it.
+ */
+import { type LionDenRuntimeEnvironment } from "@lionden/core";
+export interface UpgradeOptions {
+    /** Program to upgrade (required) */
+    program: string;
+    /** Priority fee in microcredits */
+    priorityFee?: number;
+    /** Skip waiting for transaction confirmation */
+    skipConfirm?: boolean;
+    /** Target network (overrides defaultNetwork) */
+    network?: string;
+    /** Build a standard/proven transaction even on devnode. */
+    prove?: boolean;
+}
+export interface UpgradeResult {
+    readonly programId: string;
+    readonly txId: string;
+    readonly blockHeight: number;
+}
+export declare function upgradeAction(args: Record<string, unknown>, lre: LionDenRuntimeEnvironment): Promise<UpgradeResult>;
+//# sourceMappingURL=upgrade-task.d.ts.map

package/dist/upgrade-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-task.d.ts","sourceRoot":"","sources":["../src/upgrade-task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAEL,KAAK,yBAAyB,EAK/B,MAAM,eAAe,CAAC;AAuBvB,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAMD,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,yBAAyB,GAC7B,OAAO,CAAC,aAAa,CAAC,CAwQxB"}