@gearbox-protocol/cli-utils 5.33.0-next.2 → 5.33.0

package/dist/Zommand.d.ts

@@ -0,0 +1,17 @@
+import { Command } from "@commander-js/extra-typings";
+import * as z4 from "zod/v4/core";
+export declare const zodCmdRegistry: z4.$ZodRegistry<{
+    flags: string;
+    env?: string;
+    description?: string;
+}, z4.$ZodType<unknown, unknown>>;
+export interface ZommandOptions<T extends z4.$ZodObject> {
+    schema: T;
+    templateData?: Record<string, string>;
+    configFile?: boolean;
+}
+export declare class Zommand<T extends z4.$ZodObject, Args extends any[] = []> extends Command<Args, z4.output<T>> {
+    #private;
+    constructor(name: string, opts: ZommandOptions<T>);
+    action(fn: (this: this, ...args: [...Args, z4.output<T>, this]) => void | Promise<void>): this;
+}

package/dist/Zommand.js

@@ -0,0 +1,58 @@
+import { Command, Option } from "@commander-js/extra-typings";
+import * as z4 from "zod/v4/core";
+import { resolveYamlFiles } from "./resolveYamlFiles.js";
+export const zodCmdRegistry = z4.registry();
+export class Zommand extends Command {
+    #schema;
+    #templatedData;
+    constructor(name, opts) {
+        super(name);
+        const { schema, templateData, configFile = true } = opts;
+        this.#schema = schema;
+        this.#templatedData = templateData;
+        const def = this.#schema._zod.def;
+        if (def.type !== "object") {
+            throw new Error(`expected object schema, got ${this.#schema._zod.def.type}`);
+        }
+        for (const optionSchema of Object.values(def.shape)) {
+            const meta = zodCmdRegistry.get(optionSchema);
+            if (!meta) {
+                continue;
+            }
+            this.addOption(new Option(meta.flags, meta.description));
+        }
+        if (configFile) {
+            this.addOption(new Option("--config [file]", "config file"));
+        }
+    }
+    action(fn) {
+        return super.action(async (...args) => {
+            const argz = args;
+            const _cmd = argz.splice(-1);
+            let [{ config, ...opts }] = argz.splice(-1);
+            let fromYaml = {};
+            if (config) {
+                fromYaml = await resolveYamlFiles(config, {
+                    ...process.env,
+                    ...this.#templatedData,
+                });
+            }
+            const def = this.#schema._zod.def;
+            const schemaFromEnv = {};
+            for (const [key, optionSchema] of Object.entries(def.shape)) {
+                const meta = zodCmdRegistry.get(optionSchema);
+                if (meta?.env && process.env[meta.env]) {
+                    schemaFromEnv[key] = process.env[meta.env];
+                }
+            }
+            // deep merge is not required: env and cli flags are for top-level only
+            let combined = {
+                ...schemaFromEnv,
+                ...fromYaml,
+                ...opts,
+            };
+            const data = await z4.parse(this.#schema, combined);
+            await fn.apply(this, [...argz, data, this]);
+        });
+    }
+}

package/dist/index.d.ts

@@ -1 +1,3 @@
 export * from "./resolveYamlFiles.js";
+export * from "./schema-primitives.js";
+export * from "./Zommand.js";

package/dist/index.js

@@ -1 +1,3 @@
 export * from "./resolveYamlFiles.js";
+export * from "./schema-primitives.js";
+export * from "./Zommand.js";

package/dist/schema-primitives.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod/v4";
+export declare const boolLike: z.ZodUnion<readonly [z.ZodCoercedBoolean<unknown>, z.ZodPipe<z.ZodUnknown, z.ZodBoolean>]>;
+export declare const stringArrayLike: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>;
+/**
+ * Like Address from abitype/zod, but for zod/v4
+ */
+export declare const addressLike: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+export declare const addressArrayLike: z.ZodPipe<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>, z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
+export declare const optionalAddressArrayLike: z.ZodPipe<z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>, z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>>, z.ZodTransform<`0x${string}`[] | undefined, `0x${string}`[] | undefined>>;

package/dist/schema-primitives.js

@@ -0,0 +1,25 @@
+import { z } from "zod/v4";
+export const boolLike = z.union([z.coerce.boolean(), z.stringbool()]);
+export const stringArrayLike = z.union([
+    z.array(z.string()),
+    z.string().transform(val => val.split(",")),
+]);
+/**
+ * Like Address from abitype/zod, but for zod/v4
+ */
+export const addressLike = z.string().transform((val, ctx) => {
+    const regex = /^0x[a-fA-F0-9]{40}$/;
+    if (!regex.test(val)) {
+        ctx.issues.push({
+            code: "custom",
+            message: `invalid address ${val}`,
+            input: ctx.value,
+        });
+    }
+    return val;
+});
+export const addressArrayLike = stringArrayLike.pipe(z.array(addressLike));
+export const optionalAddressArrayLike = stringArrayLike
+    .pipe(z.array(addressLike))
+    .optional()
+    .transform(v => (v?.length ? v : undefined));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gearbox-protocol/cli-utils",
   "description": "Utils for creating cli apps",
-  "version": "5.33.0-next.2",
+  "version": "5.33.0",
   "homepage": "https://gearbox.fi",
   "keywords": [
     "gearbox"
@@ -33,11 +33,14 @@
     "package:version": "yarn version"
   },
   "dependencies": {
+    "abitype": "^1.0.8",
+    "commander": "^14.0.0",
     "lodash-es": "^4.17.21",
     "yaml": "^2.8.0",
     "zod": "^3.25.42"
   },
   "devDependencies": {
+    "@commander-js/extra-typings": "^14.0.0",
     "@types/lodash-es": "^4.17.12",
     "@types/node": "^22.15.21"
   },