@lionden/core 0.1.0

package/dist/task-runner.d.ts

@@ -0,0 +1,78 @@
+import type { LionDenRuntimeEnvironment, TaskDefinition, TaskRunner } from "./types.js";
+export declare class TaskNotFoundError extends Error {
+    constructor(taskId: string);
+}
+/**
+ * Manages task registration and execution with support for overrides
+ */
+export declare class TaskRunnerImpl implements TaskRunner {
+    private readonly tasks;
+    private lre;
+    private hasStartedTask;
+    /** Bind the LRE (called once during LRE construction) */
+    setLre(lre: LionDenRuntimeEnvironment): void;
+    /**
+     * Register tasks from plugins (in load order) and config-level tasks.
+     * Override tasks stack on top of existing ones.
+     */
+    registerTasks(definitions: readonly TaskDefinition[]): void;
+    run(taskId: string, args?: Record<string, unknown>): Promise<unknown>;
+    has(taskId: string): boolean;
+    getTaskIds(): string[];
+    getTaskDefinition(taskId: string): TaskDefinition | undefined;
+    private logTaskStart;
+    private buildRunSuper;
+    /**
+     * Prepare task args for an action: normalize CLI spellings (kebab-case →
+     * camelCase, string → number coercion), fill default values for
+     * options/flags, enforce required options, then bind positional arguments.
+     *
+     * Shared by {@link run} and the runSuper chain so override actions receive
+     * the same fully-prepared args as the top-level action. The pipeline is
+     * idempotent on already-prepared args: normalize maps canonical names to
+     * themselves and only coerces strings, mergeDefaults only fills missing
+     * names, enforcement only throws on a missing required option, and positional
+     * binding only fills names not already present.
+     */
+    private prepareArgs;
+    /**
+     * Normalize CLI-parsed args to match the task definition's option, flag, and
+     * positional names.
+     *
+     * The CLI parser stores raw flag names (e.g., "no-compile") and string values
+     * (e.g., "5000" for --timeout 5000). This method:
+     * 1. Maps kebab-case keys to their camelCase equivalents
+     * 2. Coerces string values to the declared option type (number, boolean)
+     *
+     * Positionals are included so a positional supplied on the CLI by its public
+     * name (e.g. `--script-path` for a `scriptPath` positional, which the parser
+     * stores under the kebab key) is canonicalized to the name the action and the
+     * required-positional check read — the validator already allow-lists these
+     * public spellings, so without this they would pass validation but never bind.
+     */
+    private normalizeArgs;
+    private mergeDefaults;
+    /**
+     * Enforce `required: true` on value options, mirroring the required-positional
+     * check in {@link applyPositionalArguments}. Runs after defaults are merged, so
+     * an option with both `required` and a `defaultValue` is satisfied by the
+     * default. This covers every task dispatched through the runner (CLI and
+     * programmatic `lre.tasks.run`); actions that are imported and invoked directly
+     * keep their own guards for that separate entry point.
+     */
+    private enforceRequiredOptions;
+    /**
+     * Bind positional arguments to their declared names.
+     *
+     * The CLI parser stores raw positional values in `args._positional` (kept
+     * populated for back-compat with hand-extraction in plugins). Bare values
+     * fill the positionals not already supplied by name, left-to-right, so an
+     * earlier named positional does not misalign the bare ones; a variadic
+     * positional (declared last) collects every remaining bare value into an
+     * array under its name. Finally it enforces `required` positionals — throwing
+     * a clear error when a required positional was supplied neither by name nor
+     * positionally.
+     */
+    private applyPositionalArguments;
+}
+//# sourceMappingURL=task-runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-runner.d.ts","sourceRoot":"","sources":["../src/task-runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,yBAAyB,EAGzB,cAAc,EACd,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,MAAM,EAAE,MAAM;CAI3B;AAQD;;GAEG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,GAAG,CAA0C;IACrD,OAAO,CAAC,cAAc,CAAS;IAE/B,yDAAyD;IACzD,MAAM,CAAC,GAAG,EAAE,yBAAyB,GAAG,IAAI;IAI5C;;;OAGG;IACH,aAAa,CAAC,WAAW,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI;IA8BrD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA8B/E,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B,UAAU,IAAI,MAAM,EAAE;IAItB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7D,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,aAAa;IAmBrB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,WAAW;IAUnB;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,aAAa;IA8CrB,OAAO,CAAC,aAAa;IAqBrB;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,wBAAwB;CAwCjC"}

package/dist/task-runner.js

@@ -0,0 +1,247 @@
+import { argumentFlagName, getPublicArgumentNames } from "./arg-names.js";
+import { logAction, logDivider, shouldRenderDivider } from "./log-style.js";
+export class TaskNotFoundError extends Error {
+    constructor(taskId) {
+        super(`Task "${taskId}" not found`);
+        this.name = "TaskNotFoundError";
+    }
+}
+/**
+ * Manages task registration and execution with support for overrides
+ */
+export class TaskRunnerImpl {
+    tasks = new Map();
+    lre = null;
+    hasStartedTask = false;
+    /** Bind the LRE (called once during LRE construction) */
+    setLre(lre) {
+        this.lre = lre;
+    }
+    /**
+     * Register tasks from plugins (in load order) and config-level tasks.
+     * Override tasks stack on top of existing ones.
+     */
+    registerTasks(definitions) {
+        for (const def of definitions) {
+            if (def.overrides) {
+                // This is an override — stack on top
+                const existing = this.tasks.get(def.overrides);
+                if (!existing) {
+                    throw new Error(`Cannot override task "${def.overrides}": no such task registered`);
+                }
+                // Push the current action into the override chain
+                existing.overrideChain.unshift(existing.definition.action);
+                existing.definition = {
+                    ...existing.definition,
+                    action: def.action,
+                    description: def.description || existing.definition.description,
+                };
+            }
+            else {
+                // New task
+                if (this.tasks.has(def.id)) {
+                    throw new Error(`Task "${def.id}" is already registered. Use overrideTask() to extend it.`);
+                }
+                this.tasks.set(def.id, {
+                    definition: def,
+                    overrideChain: [],
+                });
+            }
+        }
+    }
+    async run(taskId, args = {}) {
+        const registered = this.tasks.get(taskId);
+        if (!registered) {
+            throw new TaskNotFoundError(taskId);
+        }
+        if (!this.lre) {
+            throw new Error("TaskRunner: LRE not initialized");
+        }
+        const action = registered.definition.action;
+        const finalArgs = this.prepareArgs(registered.definition, args);
+        this.logTaskStart(taskId);
+        // If there are overrides, create the runSuper chain
+        if (registered.overrideChain.length > 0) {
+            const runSuper = this.buildRunSuper(registered.overrideChain, 0, this.lre, registered.definition);
+            // Override actions receive runSuper as third argument
+            return action(finalArgs, this.lre, runSuper);
+        }
+        return action(finalArgs, this.lre);
+    }
+    has(taskId) {
+        return this.tasks.has(taskId);
+    }
+    getTaskIds() {
+        return [...this.tasks.keys()];
+    }
+    getTaskDefinition(taskId) {
+        return this.tasks.get(taskId)?.definition;
+    }
+    logTaskStart(taskId) {
+        if (this.hasStartedTask && shouldRenderDivider()) {
+            console.log(logDivider());
+        }
+        console.log(logAction("Running task") + ` "${taskId}"`);
+        this.hasStartedTask = true;
+    }
+    buildRunSuper(chain, index, lre, definition) {
+        return async (args) => {
+            const action = chain[index];
+            const preparedArgs = this.prepareArgs(definition, args);
+            if (index + 1 < chain.length) {
+                const nextSuper = this.buildRunSuper(chain, index + 1, lre, definition);
+                return action(preparedArgs, lre, nextSuper);
+            }
+            return action(preparedArgs, lre);
+        };
+    }
+    /**
+     * Prepare task args for an action: normalize CLI spellings (kebab-case →
+     * camelCase, string → number coercion), fill default values for
+     * options/flags, enforce required options, then bind positional arguments.
+     *
+     * Shared by {@link run} and the runSuper chain so override actions receive
+     * the same fully-prepared args as the top-level action. The pipeline is
+     * idempotent on already-prepared args: normalize maps canonical names to
+     * themselves and only coerces strings, mergeDefaults only fills missing
+     * names, enforcement only throws on a missing required option, and positional
+     * binding only fills names not already present.
+     */
+    prepareArgs(definition, args) {
+        const normalized = this.normalizeArgs(definition, args);
+        const merged = this.mergeDefaults(definition, normalized);
+        this.enforceRequiredOptions(definition, merged);
+        return this.applyPositionalArguments(definition, merged);
+    }
+    /**
+     * Normalize CLI-parsed args to match the task definition's option, flag, and
+     * positional names.
+     *
+     * The CLI parser stores raw flag names (e.g., "no-compile") and string values
+     * (e.g., "5000" for --timeout 5000). This method:
+     * 1. Maps kebab-case keys to their camelCase equivalents
+     * 2. Coerces string values to the declared option type (number, boolean)
+     *
+     * Positionals are included so a positional supplied on the CLI by its public
+     * name (e.g. `--script-path` for a `scriptPath` positional, which the parser
+     * stores under the kebab key) is canonicalized to the name the action and the
+     * required-positional check read — the validator already allow-lists these
+     * public spellings, so without this they would pass validation but never bind.
+     */
+    normalizeArgs(definition, args) {
+        // Build canonical name lookup: kebab-case → camelCase
+        const canonicalMap = new Map();
+        for (const opt of definition.options ?? []) {
+            for (const publicName of getPublicArgumentNames(opt.name)) {
+                canonicalMap.set(publicName, { name: opt.name, type: opt.type });
+            }
+        }
+        for (const flag of definition.flags ?? []) {
+            for (const publicName of getPublicArgumentNames(flag.name)) {
+                canonicalMap.set(publicName, { name: flag.name, type: "boolean" });
+            }
+        }
+        for (const positional of definition.positionalArguments ?? []) {
+            for (const publicName of getPublicArgumentNames(positional.name)) {
+                // A real option/flag spelling wins over a positional alias on a clash
+                // (a config bug), so only fill names not already claimed above.
+                if (!canonicalMap.has(publicName)) {
+                    canonicalMap.set(publicName, { name: positional.name });
+                }
+            }
+        }
+        const normalized = {};
+        for (const [key, value] of Object.entries(args)) {
+            const canonical = canonicalMap.get(key);
+            if (canonical) {
+                // Coerce string values to declared type
+                if (typeof value === "string" && canonical.type === "number") {
+                    const num = Number(value);
+                    normalized[canonical.name] = Number.isNaN(num) ? value : num;
+                }
+                else {
+                    normalized[canonical.name] = value;
+                }
+            }
+            else {
+                // Pass through unrecognized args (e.g., _positional)
+                normalized[key] = value;
+            }
+        }
+        return normalized;
+    }
+    mergeDefaults(definition, args) {
+        const merged = { ...args };
+        for (const opt of definition.options ?? []) {
+            if (!(opt.name in merged) && opt.defaultValue !== undefined) {
+                merged[opt.name] = opt.defaultValue;
+            }
+        }
+        for (const flag of definition.flags ?? []) {
+            if (!(flag.name in merged)) {
+                merged[flag.name] = false;
+            }
+        }
+        return merged;
+    }
+    /**
+     * Enforce `required: true` on value options, mirroring the required-positional
+     * check in {@link applyPositionalArguments}. Runs after defaults are merged, so
+     * an option with both `required` and a `defaultValue` is satisfied by the
+     * default. This covers every task dispatched through the runner (CLI and
+     * programmatic `lre.tasks.run`); actions that are imported and invoked directly
+     * keep their own guards for that separate entry point.
+     */
+    enforceRequiredOptions(definition, args) {
+        for (const opt of definition.options ?? []) {
+            if (opt.required && args[opt.name] === undefined) {
+                throw new Error(`Task "${definition.id}" is missing required option "${argumentFlagName(opt.name)}".`);
+            }
+        }
+    }
+    /**
+     * Bind positional arguments to their declared names.
+     *
+     * The CLI parser stores raw positional values in `args._positional` (kept
+     * populated for back-compat with hand-extraction in plugins). Bare values
+     * fill the positionals not already supplied by name, left-to-right, so an
+     * earlier named positional does not misalign the bare ones; a variadic
+     * positional (declared last) collects every remaining bare value into an
+     * array under its name. Finally it enforces `required` positionals — throwing
+     * a clear error when a required positional was supplied neither by name nor
+     * positionally.
+     */
+    applyPositionalArguments(definition, args) {
+        const positionalDefs = definition.positionalArguments;
+        if (!positionalDefs || positionalDefs.length === 0) {
+            return args;
+        }
+        const result = { ...args };
+        const positionalValues = Array.isArray(result["_positional"])
+            ? result["_positional"]
+            : [];
+        // Bare values fill only the positionals NOT already supplied by name,
+        // consumed left-to-right via a cursor. Advancing this cursor (rather than
+        // indexing `_positional` by the declaration index) keeps the remaining bare
+        // values aligned when an earlier positional was given by name — e.g. a named
+        // `scriptPath` must not shift the bare args that fill a later positional.
+        let cursor = 0;
+        for (const def of positionalDefs) {
+            // An explicitly-named value (a programmatic run({ script }) or a CLI
+            // `--name` spelling canonicalized in normalizeArgs) wins over the bare
+            // array and does not consume a bare slot. A variadic positional (always
+            // declared last) takes every remaining bare value as an array, so an
+            // action can read the whole tail by name instead of re-extracting from
+            // `_positional`.
+            if (!(def.name in result) && cursor < positionalValues.length) {
+                result[def.name] = def.variadic ? positionalValues.slice(cursor) : positionalValues[cursor];
+                cursor = def.variadic ? positionalValues.length : cursor + 1;
+            }
+            if (def.required && result[def.name] === undefined) {
+                throw new Error(`Task "${definition.id}" is missing required positional argument "${def.name}".`);
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=task-runner.js.map

package/dist/task-runner.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,186 @@
+import type { ConfigVariable, LionDenResolvedConfig, LionDenUserConfig, NamedAccounts } from "@lionden/config";
+export interface ConfigValidationError {
+    /** Dotted path to the offending field, e.g. "networks.testnet.endpoint" */
+    readonly path: string;
+    /** Human-readable error description */
+    readonly message: string;
+}
+export interface ConfigHookHandlers {
+    /** Mutate user config during loading (inject defaults, add networks, etc.) */
+    extendUserConfig?(config: LionDenUserConfig): Promise<LionDenUserConfig> | LionDenUserConfig;
+    /** Validate user config — return errors for plugin-specific fields */
+    validateUserConfig?(config: LionDenUserConfig): Promise<ConfigValidationError[]> | ConfigValidationError[];
+    /** Transform UserConfig → partial ResolvedConfig for plugin-owned settings */
+    resolveConfig?(userConfig: LionDenUserConfig, resolveConfigurationVariable: (v: ConfigVariable) => Promise<string>): Promise<Partial<LionDenResolvedConfig>> | Partial<LionDenResolvedConfig>;
+    /** Final validation on the fully resolved config (cross-field checks) */
+    validateResolvedConfig?(config: LionDenResolvedConfig): Promise<ConfigValidationError[]> | ConfigValidationError[];
+}
+export interface TestingHookHandlers {
+    /** Before test suite begins (devnode lifecycle). */
+    suiteSetup?(context: unknown): Promise<void> | void;
+    /**
+     * After the test suite completes. May run after partial or failed suite setup;
+     * handlers must tolerate uninitialized state.
+     */
+    suiteTeardown?(context: unknown): Promise<void> | void;
+    /** Before each test (snapshot). */
+    testSetup?(context: unknown): Promise<void> | void;
+    /** After each test (revert). */
+    testTeardown?(context: unknown): Promise<void> | void;
+}
+export interface ProgramDeployedContext {
+    readonly programId: string;
+    readonly txId: string;
+    readonly blockHeight: number;
+    readonly network: string;
+}
+export type ProgramUpgradedContext = ProgramDeployedContext;
+export interface DeploymentHookHandlers {
+    /** Called after a program is successfully deployed on-chain. */
+    programDeployed?(ctx: ProgramDeployedContext): Promise<void> | void;
+    /** Called after a program is successfully upgraded on-chain. */
+    programUpgraded?(ctx: ProgramUpgradedContext): Promise<void> | void;
+}
+export type HookCategory = "config" | "testing" | "deployment";
+export type HookHandlerMap = {
+    config: ConfigHookHandlers;
+    testing: TestingHookHandlers;
+    deployment: DeploymentHookHandlers;
+};
+type HookHandlersFor<C extends HookCategory> = HookHandlerMap[C];
+export type HookHandlerProvider<C extends HookCategory> = (() => Promise<HookHandlersFor<C>>) | HookHandlersFor<C>;
+export declare enum ArgumentType {
+    STRING = "STRING",
+    INT = "INT",
+    BOOLEAN = "BOOLEAN",
+    BIGINT = "BIGINT",
+    FILE = "FILE"
+}
+export interface GlobalOptionDefinition {
+    readonly name: string;
+    readonly description: string;
+    readonly type: ArgumentType;
+    readonly defaultValue?: unknown;
+}
+export interface TaskOption {
+    readonly name: string;
+    readonly description: string;
+    readonly type: "string" | "number";
+    readonly defaultValue?: unknown;
+    readonly required?: boolean;
+}
+export interface TaskFlag {
+    readonly name: string;
+    readonly description: string;
+}
+export interface TaskPositionalArgument {
+    readonly name: string;
+    readonly type: ArgumentType;
+    readonly description?: string;
+    readonly required?: boolean;
+    readonly variadic?: boolean;
+}
+export type TaskAction = (args: Record<string, unknown>, lre: LionDenRuntimeEnvironment) => Promise<unknown>;
+export type TaskActionWithSuper = (args: Record<string, unknown>, lre: LionDenRuntimeEnvironment, runSuper: (args: Record<string, unknown>) => Promise<unknown>) => Promise<unknown>;
+export interface TaskDefinition {
+    readonly id: string;
+    readonly description: string;
+    readonly action: TaskAction;
+    readonly options?: readonly TaskOption[];
+    readonly flags?: readonly TaskFlag[];
+    readonly positionalArguments?: readonly TaskPositionalArgument[];
+    /** If set, this task overrides a task with this id */
+    readonly overrides?: string;
+}
+export interface LionDenPlugin {
+    /** Unique identifier, e.g. "@lionden/plugin-leo" */
+    readonly id: string;
+    /** Human-readable name for error messages and logs */
+    readonly name?: string;
+    /** Plugins that MUST be loaded before this one */
+    readonly dependencies?: readonly LionDenPlugin[];
+    /** Hook handlers by category — lazy-loaded via () => import() or eager objects */
+    readonly hookHandlers?: Partial<{
+        [C in HookCategory]: HookHandlerProvider<C>;
+    }>;
+    /** Tasks registered by this plugin */
+    readonly tasks?: readonly TaskDefinition[];
+    /** Global CLI options added by this plugin */
+    readonly globalOptions?: readonly GlobalOptionDefinition[];
+    /**
+     * Called after LRE construction. Allows plugins to inject services
+     * (e.g., network manager) into the runtime environment.
+     */
+    readonly extendLre?: (lre: LionDenRuntimeEnvironment) => void;
+}
+export interface ArtifactStore {
+    /** Get the ABI JSON for a compiled program */
+    getAbi(programId: string): unknown | undefined;
+    /** Get the compiled .aleo source for a program */
+    getAleoSource(programId: string): string | undefined;
+    /** Get all compiled program IDs */
+    getProgramIds(): string[];
+    /** Store the ABI JSON for a compiled program */
+    setAbi(programId: string, abi: unknown): void;
+    /** Store the compiled .aleo source for a program */
+    setAleoSource(programId: string, source: string): void;
+}
+export interface LionDenRuntimeEnvironment {
+    /** Resolved configuration */
+    readonly config: LionDenResolvedConfig;
+    /** Network manager — create connections, manage devnode lifecycle */
+    readonly network: unknown;
+    /** Deployment manager — track and query deployment state */
+    readonly deployments: unknown;
+    /** Task runner — execute tasks programmatically */
+    readonly tasks: TaskRunner;
+    /** Hook dispatcher — invoke hooks programmatically */
+    readonly hooks: HookDispatcher;
+    /** Compilation artifacts (populated after compile task) */
+    readonly artifacts: ArtifactStore;
+    /** Loaded plugins */
+    readonly plugins: readonly LionDenPlugin[];
+    /** Global option values */
+    readonly globalOptions: Record<string, unknown>;
+    /**
+     * Resolved named accounts for the currently active network.
+     * Populated by @lionden/plugin-network after connect().
+     * Empty object ({}) when no namedAccounts are configured or before connect().
+     */
+    readonly namedAccounts: NamedAccounts;
+}
+export interface TaskRunner {
+    /** Run a task by ID with the given arguments */
+    run(taskId: string, args?: Record<string, unknown>): Promise<unknown>;
+    /** Check if a task is registered */
+    has(taskId: string): boolean;
+    /** Get all registered task IDs */
+    getTaskIds(): string[];
+    /** Get the registered task definition, if any */
+    getTaskDefinition(taskId: string): TaskDefinition | undefined;
+}
+export type HookDispatchMode = "serial" | "waterfall" | "collect";
+export interface HookDispatcher {
+    /** Dispatch a hook in serial mode — handlers execute sequentially */
+    serial<TContext>(category: HookCategory, hookName: string, context: TContext): Promise<void>;
+    /** Dispatch a hook in waterfall mode — each handler transforms previous result */
+    waterfall<TValue>(category: HookCategory, hookName: string, initialValue: TValue, ...extraArgs: unknown[]): Promise<TValue>;
+    /** Dispatch a hook in collect mode — gather each handler's return value in plugin order */
+    collect<TResult>(category: HookCategory, hookName: string, context: unknown, ...extraArgs: unknown[]): Promise<TResult[]>;
+}
+/**
+ * A program to deploy: either a bare program name / `.aleo` id, or any object
+ * carrying a `programId` (e.g. a generated contract wrapper). Shared so that
+ * `DeploymentContext.deploy` and `TestContext.deploy` stay structurally
+ * identical by construction.
+ */
+export type ProgramDeploymentTarget = string | {
+    readonly programId: string;
+    readonly sourceProgramId?: string;
+};
+/** Resolve a {@link ProgramDeploymentTarget} to its program name/id string. */
+export declare function programNameFromTarget(program: ProgramDeploymentTarget): string;
+/** Resolve a {@link ProgramDeploymentTarget} to its local source program id, when available. */
+export declare function sourceProgramNameFromTarget(program: ProgramDeploymentTarget): string;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,20 @@
+// ---------------------------------------------------------------------------
+// Arguments
+// ---------------------------------------------------------------------------
+export var ArgumentType;
+(function (ArgumentType) {
+    ArgumentType["STRING"] = "STRING";
+    ArgumentType["INT"] = "INT";
+    ArgumentType["BOOLEAN"] = "BOOLEAN";
+    ArgumentType["BIGINT"] = "BIGINT";
+    ArgumentType["FILE"] = "FILE";
+})(ArgumentType || (ArgumentType = {}));
+/** Resolve a {@link ProgramDeploymentTarget} to its program name/id string. */
+export function programNameFromTarget(program) {
+    return typeof program === "string" ? program : program.programId;
+}
+/** Resolve a {@link ProgramDeploymentTarget} to its local source program id, when available. */
+export function sourceProgramNameFromTarget(program) {
+    return typeof program === "string" ? program : (program.sourceProgramId ?? program.programId);
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAkGA,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,CAAN,IAAY,YAMX;AAND,WAAY,YAAY;IACtB,iCAAiB,CAAA;IACjB,2BAAW,CAAA;IACX,mCAAmB,CAAA;IACnB,iCAAiB,CAAA;IACjB,6BAAa,CAAA;AACf,CAAC,EANW,YAAY,KAAZ,YAAY,QAMvB;AA0LD,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,OAAgC;IACpE,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;AACnE,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,2BAA2B,CAAC,OAAgC;IAC1E,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;AAChG,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@lionden/core",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sealance-io/lionden.git",
+    "directory": "packages/core"
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc --build"
+  },
+  "dependencies": {
+    "@lionden/config": "^0.1.0"
+  }
+}