@dbx-tools/cli-appkit-env 0.6.74 → 0.6.76

package/README.md

@@ -2,7 +2,7 @@
 
 CLI and formatting helpers for exporting AppKit auto-configuration results.
 
-Use the `dbx-tools-appkit-env` bin when a shell or process manager needs the Lakebase /
+Use `dbx appkit env` when a shell or process manager needs the Lakebase /
 AppKit environment that [`@dbx-tools/appkit`](../../node/appkit) would
 resolve before `createApp()`.
 
@@ -19,29 +19,33 @@ Key features:
 ## Load Env Into A Shell
 
 ```sh
-eval "$(dbx-tools-appkit-env --quiet)"
+eval "$(dbx appkit env --quiet)"
 ```
 
 The command snapshots `process.env`, runs AppKit auto-config, diffs the result,
 and prints only new or changed variables. On POSIX shells the default output is
 `export KEY=value`.
 
-The package installs two equivalent commands: `dbx-tools-appkit-env` and the
-shorter `dbxt-appkit-env`. Neither matches the package name, so a one-off run
-has to name the command explicitly:
+This package ships no bin of its own. It contributes the `appkit` command group
+to the single `dbx` CLI in [`@dbx-tools/cli`](../dbx-tools), which is what you
+install:
 
 ```sh
-npx --package @dbx-tools/cli-appkit-env dbx-tools-appkit-env --quiet
+npm install --global @dbx-tools/cli
+dbx appkit env --quiet
 ```
 
+`dbx` imports this package lazily, so AppKit loads only when an `appkit`
+command actually runs.
+
 This is useful when another process must start after Lakebase discovery has
 filled `PGHOST`, `PGDATABASE`, `PGUSER`, or related AppKit variables.
 
 ## Inspect JSON Or Windows Output
 
 ```sh
-dbx-tools-appkit-env --format json
-dbx-tools-appkit-env --format windows
+dbx appkit env --format json
+dbx appkit env --format windows
 ```
 
 Use JSON for process managers and tests. Use Windows format for `cmd.exe`
@@ -64,6 +68,8 @@ that want the same output formats without invoking the bin.
 
 ## Modules
 
+- `cli` - the `dbx appkit` commander program: `buildProgram(name?)` (what
+  `@dbx-tools/cli` mounts), `buildEnvCommand()`, and `runCli()`.
 - `envExport` - env snapshots, env diffs, default format detection,
   `formatEnvExport()`, and `parseEnvExportFormat()`.
 

package/index.ts

@@ -2,5 +2,7 @@
 // Regenerated from the exporting modules in ./src.
 // Hand edits are overwritten on the next watch; this file is read-only.
 
+export * as cli from "./src/cli.ts";
 export * as envExport from "./src/env-export.ts";
+export { CommanderError } from "./src/cli.ts";
 export type { EnvExportFormat } from "./src/env-export.ts";

package/lib/index.d.ts

@@ -1,2 +1,4 @@
+export * as cli from "./src/cli.ts";
 export * as envExport from "./src/env-export.ts";
+export { CommanderError } from "./src/cli.ts";
 export type { EnvExportFormat } from "./src/env-export.ts";

package/lib/index.js

@@ -1,5 +1,7 @@
 // GENERATED by projen watch - DO NOT EDIT.
 // Regenerated from the exporting modules in ./src.
 // Hand edits are overwritten on the next watch; this file is read-only.
+export * as cli from "./src/cli.js";
 export * as envExport from "./src/env-export.js";
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwyQ0FBMkM7QUFDM0MsbURBQW1EO0FBQ25ELHdFQUF3RTtBQUV4RSxPQUFPLEtBQUssU0FBUyxNQUFNLHFCQUFxQixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLy8gR0VORVJBVEVEIGJ5IHByb2plbiB3YXRjaCAtIERPIE5PVCBFRElULlxuLy8gUmVnZW5lcmF0ZWQgZnJvbSB0aGUgZXhwb3J0aW5nIG1vZHVsZXMgaW4gLi9zcmMuXG4vLyBIYW5kIGVkaXRzIGFyZSBvdmVyd3JpdHRlbiBvbiB0aGUgbmV4dCB3YXRjaDsgdGhpcyBmaWxlIGlzIHJlYWQtb25seS5cblxuZXhwb3J0ICogYXMgZW52RXhwb3J0IGZyb20gXCIuL3NyYy9lbnYtZXhwb3J0LnRzXCI7XG5leHBvcnQgdHlwZSB7IEVudkV4cG9ydEZvcm1hdCB9IGZyb20gXCIuL3NyYy9lbnYtZXhwb3J0LnRzXCI7XG4iXX0=
+export { CommanderError } from "./src/cli.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwyQ0FBMkM7QUFDM0MsbURBQW1EO0FBQ25ELHdFQUF3RTtBQUV4RSxPQUFPLEtBQUssR0FBRyxNQUFNLGNBQWMsQ0FBQztBQUNwQyxPQUFPLEtBQUssU0FBUyxNQUFNLHFCQUFxQixDQUFDO0FBQ2pELE9BQU8sRUFBRSxjQUFjLEVBQUUsTUFBTSxjQUFjLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBHRU5FUkFURUQgYnkgcHJvamVuIHdhdGNoIC0gRE8gTk9UIEVESVQuXG4vLyBSZWdlbmVyYXRlZCBmcm9tIHRoZSBleHBvcnRpbmcgbW9kdWxlcyBpbiAuL3NyYy5cbi8vIEhhbmQgZWRpdHMgYXJlIG92ZXJ3cml0dGVuIG9uIHRoZSBuZXh0IHdhdGNoOyB0aGlzIGZpbGUgaXMgcmVhZC1vbmx5LlxuXG5leHBvcnQgKiBhcyBjbGkgZnJvbSBcIi4vc3JjL2NsaS50c1wiO1xuZXhwb3J0ICogYXMgZW52RXhwb3J0IGZyb20gXCIuL3NyYy9lbnYtZXhwb3J0LnRzXCI7XG5leHBvcnQgeyBDb21tYW5kZXJFcnJvciB9IGZyb20gXCIuL3NyYy9jbGkudHNcIjtcbmV4cG9ydCB0eXBlIHsgRW52RXhwb3J0Rm9ybWF0IH0gZnJvbSBcIi4vc3JjL2Vudi1leHBvcnQudHNcIjtcbiJdfQ==

package/lib/src/cli.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `dbx appkit` commander program.
+ *
+ * `env` runs AppKit auto-config and prints the env vars it added or changed as
+ * eval-able `export` / `set` lines (or JSON) - e.g. `eval "$(dbx appkit env)"`
+ * to load a resolved Lakebase connection into your shell.
+ *
+ * This package ships no bin of its own: {@link buildProgram} is mounted as the
+ * `appkit` subcommand of the single `dbx` CLI (`@dbx-tools/cli`), which imports
+ * this module lazily so `dbx dev` never pays for the AppKit load.
+ *
+ * @module
+ */
+import { Command, CommanderError } from "commander";
+/**
+ * Build the `env` command on its own, so a host CLI can mount it under a
+ * different parent than {@link buildProgram}'s.
+ */
+export declare function buildEnvCommand(name?: string): Command;
+/** Build the `dbx appkit` commander program (no side effects until parsed). */
+export declare function buildProgram(name?: string): Command;
+/** Parse `argv` and run the matching command. Throws {@link CommanderError} on flag errors. */
+export declare function runCli(argv: string[]): Promise<void>;
+export { CommanderError };

package/lib/src/cli.js

@@ -0,0 +1,55 @@
+/**
+ * `dbx appkit` commander program.
+ *
+ * `env` runs AppKit auto-config and prints the env vars it added or changed as
+ * eval-able `export` / `set` lines (or JSON) - e.g. `eval "$(dbx appkit env)"`
+ * to load a resolved Lakebase connection into your shell.
+ *
+ * This package ships no bin of its own: {@link buildProgram} is mounted as the
+ * `appkit` subcommand of the single `dbx` CLI (`@dbx-tools/cli`), which imports
+ * this module lazily so `dbx dev` never pays for the AppKit load.
+ *
+ * @module
+ */
+import { appkit } from "@dbx-tools/appkit";
+import { log } from "@dbx-tools/shared-core";
+import { Command, CommanderError } from "commander";
+import { defaultEnvExportFormat, diffEnv, formatEnvExport, parseEnvExportFormat, snapshotEnv, } from "./env-export.js";
+const logger = log.logger("appkit-env");
+/** Run auto-config and write the resulting env delta to stdout. */
+async function writeEnvExport(opts) {
+    if (opts.quiet) {
+        process.env.LOG_LEVEL = "error";
+    }
+    const format = opts.format ? parseEnvExportFormat(opts.format) : defaultEnvExportFormat();
+    logger.debug("Snapshotting env vars");
+    const before = snapshotEnv();
+    await appkit.autoConfigure({ autoConfigure: "env" });
+    const changes = diffEnv(before, snapshotEnv());
+    process.stdout.write(formatEnvExport(changes, format));
+}
+/**
+ * Build the `env` command on its own, so a host CLI can mount it under a
+ * different parent than {@link buildProgram}'s.
+ */
+export function buildEnvCommand(name = "env") {
+    return new Command(name)
+        .description("Run AppKit auto-config and print new/changed env vars.")
+        .option("-f, --format <format>", "Output: export (POSIX shell), windows (cmd set), or json. Defaults by platform.")
+        .option("-q, --quiet", "Suppress auto-config log output (LOG_LEVEL=error)")
+        .action(writeEnvExport);
+}
+/** Build the `dbx appkit` commander program (no side effects until parsed). */
+export function buildProgram(name = "dbx appkit") {
+    return new Command()
+        .name(name)
+        .description("AppKit helpers: resolve the environment an AppKit app would start with.")
+        .addCommand(buildEnvCommand())
+        .showHelpAfterError();
+}
+/** Parse `argv` and run the matching command. Throws {@link CommanderError} on flag errors. */
+export async function runCli(argv) {
+    await buildProgram().parseAsync(argv);
+}
+export { CommanderError };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NsaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7O0dBWUc7QUFFSCxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFDM0MsT0FBTyxFQUFFLEdBQUcsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQzdDLE9BQU8sRUFBRSxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sV0FBVyxDQUFDO0FBRXBELE9BQU8sRUFDTCxzQkFBc0IsRUFDdEIsT0FBTyxFQUNQLGVBQWUsRUFDZixvQkFBb0IsRUFDcEIsV0FBVyxHQUNaLE1BQU0saUJBQWlCLENBQUM7QUFFekIsTUFBTSxNQUFNLEdBQUcsR0FBRyxDQUFDLE1BQU0sQ0FBQyxZQUFZLENBQUMsQ0FBQztBQVF4QyxtRUFBbUU7QUFDbkUsS0FBSyxVQUFVLGNBQWMsQ0FBQyxJQUFhO0lBQ3pDLElBQUksSUFBSSxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ2YsT0FBTyxDQUFDLEdBQUcsQ0FBQyxTQUFTLEdBQUcsT0FBTyxDQUFDO0lBQ2xDLENBQUM7SUFFRCxNQUFNLE1BQU0sR0FBRyxJQUFJLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxvQkFBb0IsQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxDQUFDLHNCQUFzQixFQUFFLENBQUM7SUFDMUYsTUFBTSxDQUFDLEtBQUssQ0FBQyx1QkFBdUIsQ0FBQyxDQUFDO0lBQ3RDLE1BQU0sTUFBTSxHQUFHLFdBQVcsRUFBRSxDQUFDO0lBQzdCLE1BQU0sTUFBTSxDQUFDLGFBQWEsQ0FBQyxFQUFFLGFBQWEsRUFBRSxLQUFLLEVBQUUsQ0FBQyxDQUFDO0lBQ3JELE1BQU0sT0FBTyxHQUFHLE9BQU8sQ0FBQyxNQUFNLEVBQUUsV0FBVyxFQUFFLENBQUMsQ0FBQztJQUUvQyxPQUFPLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxlQUFlLENBQUMsT0FBTyxFQUFFLE1BQU0sQ0FBQyxDQUFDLENBQUM7QUFDekQsQ0FBQztBQUVEOzs7R0FHRztBQUNILE1BQU0sVUFBVSxlQUFlLENBQUMsSUFBSSxHQUFHLEtBQUs7SUFDMUMsT0FBTyxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUM7U0FDckIsV0FBVyxDQUFDLHdEQUF3RCxDQUFDO1NBQ3JFLE1BQU0sQ0FDTCx1QkFBdUIsRUFDdkIsaUZBQWlGLENBQ2xGO1NBQ0EsTUFBTSxDQUFDLGFBQWEsRUFBRSxtREFBbUQsQ0FBQztTQUMxRSxNQUFNLENBQUMsY0FBYyxDQUFDLENBQUM7QUFDNUIsQ0FBQztBQUVELCtFQUErRTtBQUMvRSxNQUFNLFVBQVUsWUFBWSxDQUFDLElBQUksR0FBRyxZQUFZO0lBQzlDLE9BQU8sSUFBSSxPQUFPLEVBQUU7U0FDakIsSUFBSSxDQUFDLElBQUksQ0FBQztTQUNWLFdBQVcsQ0FBQyx5RUFBeUUsQ0FBQztTQUN0RixVQUFVLENBQUMsZUFBZSxFQUFFLENBQUM7U0FDN0Isa0JBQWtCLEVBQUUsQ0FBQztBQUMxQixDQUFDO0FBRUQsK0ZBQStGO0FBQy9GLE1BQU0sQ0FBQyxLQUFLLFVBQVUsTUFBTSxDQUFDLElBQWM7SUFDekMsTUFBTSxZQUFZLEVBQUUsQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLENBQUM7QUFDeEMsQ0FBQztBQUVELE9BQU8sRUFBRSxjQUFjLEVBQUUsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogYGRieCBhcHBraXRgIGNvbW1hbmRlciBwcm9ncmFtLlxuICpcbiAqIGBlbnZgIHJ1bnMgQXBwS2l0IGF1dG8tY29uZmlnIGFuZCBwcmludHMgdGhlIGVudiB2YXJzIGl0IGFkZGVkIG9yIGNoYW5nZWQgYXNcbiAqIGV2YWwtYWJsZSBgZXhwb3J0YCAvIGBzZXRgIGxpbmVzIChvciBKU09OKSAtIGUuZy4gYGV2YWwgXCIkKGRieCBhcHBraXQgZW52KVwiYFxuICogdG8gbG9hZCBhIHJlc29sdmVkIExha2ViYXNlIGNvbm5lY3Rpb24gaW50byB5b3VyIHNoZWxsLlxuICpcbiAqIFRoaXMgcGFja2FnZSBzaGlwcyBubyBiaW4gb2YgaXRzIG93bjoge0BsaW5rIGJ1aWxkUHJvZ3JhbX0gaXMgbW91bnRlZCBhcyB0aGVcbiAqIGBhcHBraXRgIHN1YmNvbW1hbmQgb2YgdGhlIHNpbmdsZSBgZGJ4YCBDTEkgKGBAZGJ4LXRvb2xzL2NsaWApLCB3aGljaCBpbXBvcnRzXG4gKiB0aGlzIG1vZHVsZSBsYXppbHkgc28gYGRieCBkZXZgIG5ldmVyIHBheXMgZm9yIHRoZSBBcHBLaXQgbG9hZC5cbiAqXG4gKiBAbW9kdWxlXG4gKi9cblxuaW1wb3J0IHsgYXBwa2l0IH0gZnJvbSBcIkBkYngtdG9vbHMvYXBwa2l0XCI7XG5pbXBvcnQgeyBsb2cgfSBmcm9tIFwiQGRieC10b29scy9zaGFyZWQtY29yZVwiO1xuaW1wb3J0IHsgQ29tbWFuZCwgQ29tbWFuZGVyRXJyb3IgfSBmcm9tIFwiY29tbWFuZGVyXCI7XG5cbmltcG9ydCB7XG4gIGRlZmF1bHRFbnZFeHBvcnRGb3JtYXQsXG4gIGRpZmZFbnYsXG4gIGZvcm1hdEVudkV4cG9ydCxcbiAgcGFyc2VFbnZFeHBvcnRGb3JtYXQsXG4gIHNuYXBzaG90RW52LFxufSBmcm9tIFwiLi9lbnYtZXhwb3J0LnRzXCI7XG5cbmNvbnN0IGxvZ2dlciA9IGxvZy5sb2dnZXIoXCJhcHBraXQtZW52XCIpO1xuXG4vKiogT3B0aW9ucyBmb3IgdGhlIGBlbnZgIGNvbW1hbmQuICovXG5pbnRlcmZhY2UgRW52T3B0cyB7XG4gIGZvcm1hdD86IHN0cmluZztcbiAgcXVpZXQ/OiBib29sZWFuO1xufVxuXG4vKiogUnVuIGF1dG8tY29uZmlnIGFuZCB3cml0ZSB0aGUgcmVzdWx0aW5nIGVudiBkZWx0YSB0byBzdGRvdXQuICovXG5hc3luYyBmdW5jdGlvbiB3cml0ZUVudkV4cG9ydChvcHRzOiBFbnZPcHRzKTogUHJvbWlzZTx2b2lkPiB7XG4gIGlmIChvcHRzLnF1aWV0KSB7XG4gICAgcHJvY2Vzcy5lbnYuTE9HX0xFVkVMID0gXCJlcnJvclwiO1xuICB9XG5cbiAgY29uc3QgZm9ybWF0ID0gb3B0cy5mb3JtYXQgPyBwYXJzZUVudkV4cG9ydEZvcm1hdChvcHRzLmZvcm1hdCkgOiBkZWZhdWx0RW52RXhwb3J0Rm9ybWF0KCk7XG4gIGxvZ2dlci5kZWJ1ZyhcIlNuYXBzaG90dGluZyBlbnYgdmFyc1wiKTtcbiAgY29uc3QgYmVmb3JlID0gc25hcHNob3RFbnYoKTtcbiAgYXdhaXQgYXBwa2l0LmF1dG9Db25maWd1cmUoeyBhdXRvQ29uZmlndXJlOiBcImVudlwiIH0pO1xuICBjb25zdCBjaGFuZ2VzID0gZGlmZkVudihiZWZvcmUsIHNuYXBzaG90RW52KCkpO1xuXG4gIHByb2Nlc3Muc3Rkb3V0LndyaXRlKGZvcm1hdEVudkV4cG9ydChjaGFuZ2VzLCBmb3JtYXQpKTtcbn1cblxuLyoqXG4gKiBCdWlsZCB0aGUgYGVudmAgY29tbWFuZCBvbiBpdHMgb3duLCBzbyBhIGhvc3QgQ0xJIGNhbiBtb3VudCBpdCB1bmRlciBhXG4gKiBkaWZmZXJlbnQgcGFyZW50IHRoYW4ge0BsaW5rIGJ1aWxkUHJvZ3JhbX0ncy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGJ1aWxkRW52Q29tbWFuZChuYW1lID0gXCJlbnZcIik6IENvbW1hbmQge1xuICByZXR1cm4gbmV3IENvbW1hbmQobmFtZSlcbiAgICAuZGVzY3JpcHRpb24oXCJSdW4gQXBwS2l0IGF1dG8tY29uZmlnIGFuZCBwcmludCBuZXcvY2hhbmdlZCBlbnYgdmFycy5cIilcbiAgICAub3B0aW9uKFxuICAgICAgXCItZiwgLS1mb3JtYXQgPGZvcm1hdD5cIixcbiAgICAgIFwiT3V0cHV0OiBleHBvcnQgKFBPU0lYIHNoZWxsKSwgd2luZG93cyAoY21kIHNldCksIG9yIGpzb24uIERlZmF1bHRzIGJ5IHBsYXRmb3JtLlwiLFxuICAgIClcbiAgICAub3B0aW9uKFwiLXEsIC0tcXVpZXRcIiwgXCJTdXBwcmVzcyBhdXRvLWNvbmZpZyBsb2cgb3V0cHV0IChMT0dfTEVWRUw9ZXJyb3IpXCIpXG4gICAgLmFjdGlvbih3cml0ZUVudkV4cG9ydCk7XG59XG5cbi8qKiBCdWlsZCB0aGUgYGRieCBhcHBraXRgIGNvbW1hbmRlciBwcm9ncmFtIChubyBzaWRlIGVmZmVjdHMgdW50aWwgcGFyc2VkKS4gKi9cbmV4cG9ydCBmdW5jdGlvbiBidWlsZFByb2dyYW0obmFtZSA9IFwiZGJ4IGFwcGtpdFwiKTogQ29tbWFuZCB7XG4gIHJldHVybiBuZXcgQ29tbWFuZCgpXG4gICAgLm5hbWUobmFtZSlcbiAgICAuZGVzY3JpcHRpb24oXCJBcHBLaXQgaGVscGVyczogcmVzb2x2ZSB0aGUgZW52aXJvbm1lbnQgYW4gQXBwS2l0IGFwcCB3b3VsZCBzdGFydCB3aXRoLlwiKVxuICAgIC5hZGRDb21tYW5kKGJ1aWxkRW52Q29tbWFuZCgpKVxuICAgIC5zaG93SGVscEFmdGVyRXJyb3IoKTtcbn1cblxuLyoqIFBhcnNlIGBhcmd2YCBhbmQgcnVuIHRoZSBtYXRjaGluZyBjb21tYW5kLiBUaHJvd3Mge0BsaW5rIENvbW1hbmRlckVycm9yfSBvbiBmbGFnIGVycm9ycy4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBydW5DbGkoYXJndjogc3RyaW5nW10pOiBQcm9taXNlPHZvaWQ+IHtcbiAgYXdhaXQgYnVpbGRQcm9ncmFtKCkucGFyc2VBc3luYyhhcmd2KTtcbn1cblxuZXhwb3J0IHsgQ29tbWFuZGVyRXJyb3IgfTtcbiJdfQ==

package/lib/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/env-export.ts","../index.ts","../bin/dbx-tools-appkit-env.ts"],"version":"5.9.3"}
+{"root":["../src/cli.ts","../src/env-export.ts","../index.ts"],"version":"5.9.3"}

package/package.json

@@ -3,11 +3,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/reggie-db/dbx-tools.git",
-    "directory": "js-packages/cli/appkit-env"
-  },
-  "bin": {
-    "dbx-tools-appkit-env": "./lib/bin/dbx-tools-appkit-env.js",
-    "dbxt-appkit-env": "./lib/bin/dbx-tools-appkit-env.js"
+    "directory": "packages/js/cli/appkit-env"
   },
   "scripts": {
     "build": "projen build",
@@ -28,8 +24,8 @@
   },
   "dependencies": {
     "@databricks/appkit": "^0.43.0",
-    "@dbx-tools/appkit": "0.6.74",
-    "@dbx-tools/shared-core": "0.6.74",
+    "@dbx-tools/appkit": "0.6.76",
+    "@dbx-tools/shared-core": "0.6.76",
     "commander": "^15.0.0"
   },
   "main": "./lib/index.js",
@@ -38,15 +34,15 @@
     "access": "public",
     "main": "./lib/index.js",
     "types": "./lib/index.d.ts",
-    "bin": {
-      "dbx-tools-appkit-env": "./lib/bin/dbx-tools-appkit-env.js",
-      "dbxt-appkit-env": "./lib/bin/dbx-tools-appkit-env.js"
-    },
     "exports": {
       ".": {
         "types": "./lib/index.d.ts",
         "default": "./lib/index.js"
       },
+      "./cli": {
+        "types": "./lib/src/cli.d.ts",
+        "default": "./lib/src/cli.js"
+      },
       "./env-export": {
         "types": "./lib/src/env-export.d.ts",
         "default": "./lib/src/env-export.js"
@@ -54,7 +50,7 @@
       "./package.json": "./package.json"
     }
   },
-  "version": "0.6.74",
+  "version": "0.6.76",
   "types": "./lib/index.d.ts",
   "type": "module",
   "exports": {
@@ -62,6 +58,10 @@
       "types": "./lib/index.d.ts",
       "default": "./lib/index.js"
     },
+    "./cli": {
+      "types": "./lib/src/cli.d.ts",
+      "default": "./lib/src/cli.js"
+    },
     "./env-export": {
       "types": "./lib/src/env-export.d.ts",
       "default": "./lib/src/env-export.js"

package/src/cli.ts

@@ -0,0 +1,79 @@
+/**
+ * `dbx appkit` commander program.
+ *
+ * `env` runs AppKit auto-config and prints the env vars it added or changed as
+ * eval-able `export` / `set` lines (or JSON) - e.g. `eval "$(dbx appkit env)"`
+ * to load a resolved Lakebase connection into your shell.
+ *
+ * This package ships no bin of its own: {@link buildProgram} is mounted as the
+ * `appkit` subcommand of the single `dbx` CLI (`@dbx-tools/cli`), which imports
+ * this module lazily so `dbx dev` never pays for the AppKit load.
+ *
+ * @module
+ */
+
+import { appkit } from "@dbx-tools/appkit";
+import { log } from "@dbx-tools/shared-core";
+import { Command, CommanderError } from "commander";
+
+import {
+  defaultEnvExportFormat,
+  diffEnv,
+  formatEnvExport,
+  parseEnvExportFormat,
+  snapshotEnv,
+} from "./env-export.ts";
+
+const logger = log.logger("appkit-env");
+
+/** Options for the `env` command. */
+interface EnvOpts {
+  format?: string;
+  quiet?: boolean;
+}
+
+/** Run auto-config and write the resulting env delta to stdout. */
+async function writeEnvExport(opts: EnvOpts): Promise<void> {
+  if (opts.quiet) {
+    process.env.LOG_LEVEL = "error";
+  }
+
+  const format = opts.format ? parseEnvExportFormat(opts.format) : defaultEnvExportFormat();
+  logger.debug("Snapshotting env vars");
+  const before = snapshotEnv();
+  await appkit.autoConfigure({ autoConfigure: "env" });
+  const changes = diffEnv(before, snapshotEnv());
+
+  process.stdout.write(formatEnvExport(changes, format));
+}
+
+/**
+ * Build the `env` command on its own, so a host CLI can mount it under a
+ * different parent than {@link buildProgram}'s.
+ */
+export function buildEnvCommand(name = "env"): Command {
+  return new Command(name)
+    .description("Run AppKit auto-config and print new/changed env vars.")
+    .option(
+      "-f, --format <format>",
+      "Output: export (POSIX shell), windows (cmd set), or json. Defaults by platform.",
+    )
+    .option("-q, --quiet", "Suppress auto-config log output (LOG_LEVEL=error)")
+    .action(writeEnvExport);
+}
+
+/** Build the `dbx appkit` commander program (no side effects until parsed). */
+export function buildProgram(name = "dbx appkit"): Command {
+  return new Command()
+    .name(name)
+    .description("AppKit helpers: resolve the environment an AppKit app would start with.")
+    .addCommand(buildEnvCommand())
+    .showHelpAfterError();
+}
+
+/** Parse `argv` and run the matching command. Throws {@link CommanderError} on flag errors. */
+export async function runCli(argv: string[]): Promise<void> {
+  await buildProgram().parseAsync(argv);
+}
+
+export { CommanderError };

package/bin/dbx-tools-appkit-env.ts

@@ -1,50 +0,0 @@
-#!/usr/bin/env node
-/**
- * `dbx-tools-appkit-env`: run AppKit auto-config and print the env vars it added or
- * changed. Snapshots `process.env`, runs auto-config, diffs, and writes
- * eval-able `export` / `set` lines (or JSON) to stdout - e.g.
- * `eval "$(dbx-tools-appkit-env)"` to load a resolved Lakebase connection into your shell.
- */
-
-import { appkit } from "@dbx-tools/appkit";
-import { log } from "@dbx-tools/shared-core";
-import { Command, CommanderError } from "commander";
-import {
-  defaultEnvExportFormat,
-  diffEnv,
-  formatEnvExport,
-  parseEnvExportFormat,
-  snapshotEnv,
-} from "../src/env-export.ts";
-
-const logger = log.logger("appkit-env");
-
-const program = new Command()
-  .name("dbx-tools-appkit-env")
-  .description("Run AppKit auto-config and print new/changed env vars.")
-  .option(
-    "-f, --format <format>",
-    "Output: export (POSIX shell), windows (cmd set), or json. Defaults by platform.",
-  )
-  .option("-q, --quiet", "Suppress auto-config log output (LOG_LEVEL=error)")
-  .action(async (opts: { format?: string; quiet?: boolean }) => {
-    if (opts.quiet) {
-      process.env.LOG_LEVEL = "error";
-    }
-
-    const format = opts.format ? parseEnvExportFormat(opts.format) : defaultEnvExportFormat();
-    logger.debug("Snapshotting env vars");
-    const before = snapshotEnv();
-    await appkit.autoConfigure({ autoConfigure: "env" });
-    const changes = diffEnv(before, snapshotEnv());
-
-    process.stdout.write(formatEnvExport(changes, format));
-  });
-
-program.parseAsync(process.argv).catch((err: unknown) => {
-  if (err instanceof CommanderError) {
-    process.exit(err.exitCode);
-  }
-  process.stderr.write(`${err instanceof Error ? (err.stack ?? err.message) : String(err)}\n`);
-  process.exit(1);
-});

package/lib/bin/dbx-tools-appkit-env.d.ts

@@ -1,8 +0,0 @@
-#!/usr/bin/env node
-/**
- * `dbx-tools-appkit-env`: run AppKit auto-config and print the env vars it added or
- * changed. Snapshots `process.env`, runs auto-config, diffs, and writes
- * eval-able `export` / `set` lines (or JSON) to stdout - e.g.
- * `eval "$(dbx-tools-appkit-env)"` to load a resolved Lakebase connection into your shell.
- */
-export {};

package/lib/bin/dbx-tools-appkit-env.js

@@ -1,36 +0,0 @@
-#!/usr/bin/env node
-/**
- * `dbx-tools-appkit-env`: run AppKit auto-config and print the env vars it added or
- * changed. Snapshots `process.env`, runs auto-config, diffs, and writes
- * eval-able `export` / `set` lines (or JSON) to stdout - e.g.
- * `eval "$(dbx-tools-appkit-env)"` to load a resolved Lakebase connection into your shell.
- */
-import { appkit } from "@dbx-tools/appkit";
-import { log } from "@dbx-tools/shared-core";
-import { Command, CommanderError } from "commander";
-import { defaultEnvExportFormat, diffEnv, formatEnvExport, parseEnvExportFormat, snapshotEnv, } from "../src/env-export.js";
-const logger = log.logger("appkit-env");
-const program = new Command()
-    .name("dbx-tools-appkit-env")
-    .description("Run AppKit auto-config and print new/changed env vars.")
-    .option("-f, --format <format>", "Output: export (POSIX shell), windows (cmd set), or json. Defaults by platform.")
-    .option("-q, --quiet", "Suppress auto-config log output (LOG_LEVEL=error)")
-    .action(async (opts) => {
-    if (opts.quiet) {
-        process.env.LOG_LEVEL = "error";
-    }
-    const format = opts.format ? parseEnvExportFormat(opts.format) : defaultEnvExportFormat();
-    logger.debug("Snapshotting env vars");
-    const before = snapshotEnv();
-    await appkit.autoConfigure({ autoConfigure: "env" });
-    const changes = diffEnv(before, snapshotEnv());
-    process.stdout.write(formatEnvExport(changes, format));
-});
-program.parseAsync(process.argv).catch((err) => {
-    if (err instanceof CommanderError) {
-        process.exit(err.exitCode);
-    }
-    process.stderr.write(`${err instanceof Error ? (err.stack ?? err.message) : String(err)}\n`);
-    process.exit(1);
-});
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGJ4LXRvb2xzLWFwcGtpdC1lbnYuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9iaW4vZGJ4LXRvb2xzLWFwcGtpdC1lbnYudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUNBOzs7OztHQUtHO0FBRUgsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBQzNDLE9BQU8sRUFBRSxHQUFHLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUM3QyxPQUFPLEVBQUUsT0FBTyxFQUFFLGNBQWMsRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUNwRCxPQUFPLEVBQ0wsc0JBQXNCLEVBQ3RCLE9BQU8sRUFDUCxlQUFlLEVBQ2Ysb0JBQW9CLEVBQ3BCLFdBQVcsR0FDWixNQUFNLHNCQUFzQixDQUFDO0FBRTlCLE1BQU0sTUFBTSxHQUFHLEdBQUcsQ0FBQyxNQUFNLENBQUMsWUFBWSxDQUFDLENBQUM7QUFFeEMsTUFBTSxPQUFPLEdBQUcsSUFBSSxPQUFPLEVBQUU7S0FDMUIsSUFBSSxDQUFDLHNCQUFzQixDQUFDO0tBQzVCLFdBQVcsQ0FBQyx3REFBd0QsQ0FBQztLQUNyRSxNQUFNLENBQ0wsdUJBQXVCLEVBQ3ZCLGlGQUFpRixDQUNsRjtLQUNBLE1BQU0sQ0FBQyxhQUFhLEVBQUUsbURBQW1ELENBQUM7S0FDMUUsTUFBTSxDQUFDLEtBQUssRUFBRSxJQUEwQyxFQUFFLEVBQUU7SUFDM0QsSUFBSSxJQUFJLENBQUMsS0FBSyxFQUFFLENBQUM7UUFDZixPQUFPLENBQUMsR0FBRyxDQUFDLFNBQVMsR0FBRyxPQUFPLENBQUM7SUFDbEMsQ0FBQztJQUVELE1BQU0sTUFBTSxHQUFHLElBQUksQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLG9CQUFvQixDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLENBQUMsc0JBQXNCLEVBQUUsQ0FBQztJQUMxRixNQUFNLENBQUMsS0FBSyxDQUFDLHVCQUF1QixDQUFDLENBQUM7SUFDdEMsTUFBTSxNQUFNLEdBQUcsV0FBVyxFQUFFLENBQUM7SUFDN0IsTUFBTSxNQUFNLENBQUMsYUFBYSxDQUFDLEVBQUUsYUFBYSxFQUFFLEtBQUssRUFBRSxDQUFDLENBQUM7SUFDckQsTUFBTSxPQUFPLEdBQUcsT0FBTyxDQUFDLE1BQU0sRUFBRSxXQUFXLEVBQUUsQ0FBQyxDQUFDO0lBRS9DLE9BQU8sQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLGVBQWUsQ0FBQyxPQUFPLEVBQUUsTUFBTSxDQUFDLENBQUMsQ0FBQztBQUN6RCxDQUFDLENBQUMsQ0FBQztBQUVMLE9BQU8sQ0FBQyxVQUFVLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLEtBQUssQ0FBQyxDQUFDLEdBQVksRUFBRSxFQUFFO0lBQ3RELElBQUksR0FBRyxZQUFZLGNBQWMsRUFBRSxDQUFDO1FBQ2xDLE9BQU8sQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLFFBQVEsQ0FBQyxDQUFDO0lBQzdCLENBQUM7SUFDRCxPQUFPLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxHQUFHLEdBQUcsWUFBWSxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLEtBQUssSUFBSSxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDN0YsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQztBQUNsQixDQUFDLENBQUMsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIiMhL3Vzci9iaW4vZW52IG5vZGVcbi8qKlxuICogYGRieC10b29scy1hcHBraXQtZW52YDogcnVuIEFwcEtpdCBhdXRvLWNvbmZpZyBhbmQgcHJpbnQgdGhlIGVudiB2YXJzIGl0IGFkZGVkIG9yXG4gKiBjaGFuZ2VkLiBTbmFwc2hvdHMgYHByb2Nlc3MuZW52YCwgcnVucyBhdXRvLWNvbmZpZywgZGlmZnMsIGFuZCB3cml0ZXNcbiAqIGV2YWwtYWJsZSBgZXhwb3J0YCAvIGBzZXRgIGxpbmVzIChvciBKU09OKSB0byBzdGRvdXQgLSBlLmcuXG4gKiBgZXZhbCBcIiQoZGJ4LXRvb2xzLWFwcGtpdC1lbnYpXCJgIHRvIGxvYWQgYSByZXNvbHZlZCBMYWtlYmFzZSBjb25uZWN0aW9uIGludG8geW91ciBzaGVsbC5cbiAqL1xuXG5pbXBvcnQgeyBhcHBraXQgfSBmcm9tIFwiQGRieC10b29scy9hcHBraXRcIjtcbmltcG9ydCB7IGxvZyB9IGZyb20gXCJAZGJ4LXRvb2xzL3NoYXJlZC1jb3JlXCI7XG5pbXBvcnQgeyBDb21tYW5kLCBDb21tYW5kZXJFcnJvciB9IGZyb20gXCJjb21tYW5kZXJcIjtcbmltcG9ydCB7XG4gIGRlZmF1bHRFbnZFeHBvcnRGb3JtYXQsXG4gIGRpZmZFbnYsXG4gIGZvcm1hdEVudkV4cG9ydCxcbiAgcGFyc2VFbnZFeHBvcnRGb3JtYXQsXG4gIHNuYXBzaG90RW52LFxufSBmcm9tIFwiLi4vc3JjL2Vudi1leHBvcnQudHNcIjtcblxuY29uc3QgbG9nZ2VyID0gbG9nLmxvZ2dlcihcImFwcGtpdC1lbnZcIik7XG5cbmNvbnN0IHByb2dyYW0gPSBuZXcgQ29tbWFuZCgpXG4gIC5uYW1lKFwiZGJ4LXRvb2xzLWFwcGtpdC1lbnZcIilcbiAgLmRlc2NyaXB0aW9uKFwiUnVuIEFwcEtpdCBhdXRvLWNvbmZpZyBhbmQgcHJpbnQgbmV3L2NoYW5nZWQgZW52IHZhcnMuXCIpXG4gIC5vcHRpb24oXG4gICAgXCItZiwgLS1mb3JtYXQgPGZvcm1hdD5cIixcbiAgICBcIk91dHB1dDogZXhwb3J0IChQT1NJWCBzaGVsbCksIHdpbmRvd3MgKGNtZCBzZXQpLCBvciBqc29uLiBEZWZhdWx0cyBieSBwbGF0Zm9ybS5cIixcbiAgKVxuICAub3B0aW9uKFwiLXEsIC0tcXVpZXRcIiwgXCJTdXBwcmVzcyBhdXRvLWNvbmZpZyBsb2cgb3V0cHV0IChMT0dfTEVWRUw9ZXJyb3IpXCIpXG4gIC5hY3Rpb24oYXN5bmMgKG9wdHM6IHsgZm9ybWF0Pzogc3RyaW5nOyBxdWlldD86IGJvb2xlYW4gfSkgPT4ge1xuICAgIGlmIChvcHRzLnF1aWV0KSB7XG4gICAgICBwcm9jZXNzLmVudi5MT0dfTEVWRUwgPSBcImVycm9yXCI7XG4gICAgfVxuXG4gICAgY29uc3QgZm9ybWF0ID0gb3B0cy5mb3JtYXQgPyBwYXJzZUVudkV4cG9ydEZvcm1hdChvcHRzLmZvcm1hdCkgOiBkZWZhdWx0RW52RXhwb3J0Rm9ybWF0KCk7XG4gICAgbG9nZ2VyLmRlYnVnKFwiU25hcHNob3R0aW5nIGVudiB2YXJzXCIpO1xuICAgIGNvbnN0IGJlZm9yZSA9IHNuYXBzaG90RW52KCk7XG4gICAgYXdhaXQgYXBwa2l0LmF1dG9Db25maWd1cmUoeyBhdXRvQ29uZmlndXJlOiBcImVudlwiIH0pO1xuICAgIGNvbnN0IGNoYW5nZXMgPSBkaWZmRW52KGJlZm9yZSwgc25hcHNob3RFbnYoKSk7XG5cbiAgICBwcm9jZXNzLnN0ZG91dC53cml0ZShmb3JtYXRFbnZFeHBvcnQoY2hhbmdlcywgZm9ybWF0KSk7XG4gIH0pO1xuXG5wcm9ncmFtLnBhcnNlQXN5bmMocHJvY2Vzcy5hcmd2KS5jYXRjaCgoZXJyOiB1bmtub3duKSA9PiB7XG4gIGlmIChlcnIgaW5zdGFuY2VvZiBDb21tYW5kZXJFcnJvcikge1xuICAgIHByb2Nlc3MuZXhpdChlcnIuZXhpdENvZGUpO1xuICB9XG4gIHByb2Nlc3Muc3RkZXJyLndyaXRlKGAke2VyciBpbnN0YW5jZW9mIEVycm9yID8gKGVyci5zdGFjayA/PyBlcnIubWVzc2FnZSkgOiBTdHJpbmcoZXJyKX1cXG5gKTtcbiAgcHJvY2Vzcy5leGl0KDEpO1xufSk7XG4iXX0=