@dereekb/dbx-cli 13.11.2 → 13.11.3

package/firebase-api-manifest/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-cli-firebase-api-manifest",
-  "version": "13.11.2",
+  "version": "13.11.3",
   "private": true,
   "type": "module",
   "devDependencies": {

package/index.cjs.js

@@ -274,6 +274,7 @@ var _errorMapper;
  * @param extension - File extension to append (`json` for full responses, `ndjson` for streaming dumps).
  * @param suffix - Optional suffix appended to the filename before the extension.
  * @returns The absolute file path, or `undefined` when `dumpDir` is not configured.
+ * @__NO_SIDE_EFFECTS__
  */ function buildDumpFilePath(extension, suffix) {
     var dumpDir = _outputOptions.dumpDir, commandPath = _outputOptions.commandPath;
     if (!dumpDir) {
@@ -410,6 +411,7 @@ function pickFromObject(obj, fields) {
  *
  * @param error - The thrown value to convert.
  * @returns The structured {@link CliErrorOutput}.
+ * @__NO_SIDE_EFFECTS__
  */ function buildErrorOutput(error) {
     if (_errorMapper) {
         var mapped = _errorMapper(error);
@@ -671,6 +673,7 @@ function trimSlash$1(url) {
  * @param input - Optional slot configuration.
  * @param input.notInitializedMessage - Custom error message thrown by `require()` when the slot is unset.
  * @returns A new {@link ContextSlot} for type `T`.
+ * @__NO_SIDE_EFFECTS__
  */ function createContextSlot(input) {
     var _ref;
     var _value;
@@ -715,6 +718,7 @@ var getCliContext = _cliContextSlot.get;
  * @param input.env - The resolved {@link CliEnvConfig} for the active env.
  * @param input.accessToken - The Bearer access token to include on outgoing API calls.
  * @returns The constructed {@link CliContext}.
+ * @__NO_SIDE_EFFECTS__
  */ function createCliContext(input) {
     return {
         cliName: input.cliName,
@@ -914,6 +918,7 @@ function _ts_generator$e(thisArg, body) {
  *
  * @param spec - The command spec describing the yargs command surface plus how to map argv into the typed call params and the result.
  * @returns A yargs `CommandModule` whose handler runs the spec against the active CLI context.
+ * @__NO_SIDE_EFFECTS__
  */ function createCallModelCommand(spec) {
     return {
         command: spec.command,
@@ -1788,6 +1793,7 @@ function nonEmpty(value) {
  * @param config.cliName - The CLI's binary name; the default config dir is `~/.<cliName>`.
  * @param config.configDirOverride - Optional override that replaces the default config directory verbatim (used by tests).
  * @returns The {@link CliPaths} pointing at `configDir`, the config file, and the token cache file.
+ * @__NO_SIDE_EFFECTS__
  */ function buildCliPaths(config) {
     var _config_configDirOverride;
     var configDir = (_config_configDirOverride = config.configDirOverride) !== null && _config_configDirOverride !== void 0 ? _config_configDirOverride : node_path.join(node_os.homedir(), ".".concat(config.cliName));
@@ -1807,6 +1813,7 @@ function nonEmpty(value) {
  * @param input - The cache store inputs.
  * @param input.tokenCachePath - Absolute path to the JSON file backing the cache.
  * @returns A {@link CliTokenCacheStore} keyed by env name.
+ * @__NO_SIDE_EFFECTS__
  */ function createCliTokenCacheStore(input) {
     return nestjs.createMemoizedJsonFileAsyncKeyedValueCache({
         filePath: input.tokenCachePath
@@ -2534,6 +2541,7 @@ function _ts_generator$a(thisArg, body) {
  * @param input.state - The opaque OAuth state token used for CSRF protection.
  * @param input.codeChallenge - The PKCE code challenge derived from the verifier.
  * @returns The full authorization URL with all OAuth params merged in.
+ * @__NO_SIDE_EFFECTS__
  */ function buildAuthorizationUrl(input) {
     var _input_scopes;
     var authParams = {
@@ -3066,6 +3074,7 @@ function maskEnv$1(env) {
  * @param input.envVarName - Override for the env-name env var. Defaults to `<CLINAME>_ENV` (e.g. `DEMO_CLI_ENV`).
  * @param input.defaultEnvs - Built-in env presets merged underneath the user's stored env when names match.
  * @returns A yargs `CommandModule` exposing the full `auth` subcommand surface.
+ * @__NO_SIDE_EFFECTS__
  */ function createAuthCommand(input) {
     var _input_envVarName;
     var cliName = input.cliName;
@@ -4413,6 +4422,7 @@ function _ts_generator$8(thisArg, body) {
  * @param input.checks - Additional checks to append after the default check list.
  * @param input.defaultEnvs - Built-in env presets merged underneath the user's stored env when names match.
  * @returns A yargs `CommandModule` exposing the `doctor` command.
+ * @__NO_SIDE_EFFECTS__
  */ function createDoctorCommand(input) {
     var _input_checks;
     var cliName = input.cliName;
@@ -4851,6 +4861,7 @@ function resolveEnvWithDefault(input) {
  * @param input.cliName - The CLI's binary name.
  * @param input.defaultEnvs - Built-in env presets merged underneath the user's stored env when names match.
  * @returns A yargs `CommandModule` exposing the full `env` subcommand surface.
+ * @__NO_SIDE_EFFECTS__
  */ function createEnvCommand(input) {
     var paths = buildCliPaths({
         cliName: input.cliName
@@ -5466,6 +5477,7 @@ function _ts_generator$6(thisArg, body) {
  * @param input.skipCommands - Top-level command names that bypass authentication entirely.
  * @param input.defaultEnvs - Built-in env presets merged underneath the user's stored env when names match.
  * @returns A yargs middleware function suitable for `.middleware([..., true])`.
+ * @__NO_SIDE_EFFECTS__
  */ function createAuthMiddleware(input) {
     var paths = buildCliPaths({
         cliName: input.cliName
@@ -5784,6 +5796,7 @@ function _ts_generator$5(thisArg, body) {
  * @param input.loadOutputConfig - Optional override for how the output config is read.
  * @param input.saveCommandOutputConfig - Optional override for how a per-command output config is persisted.
  * @returns A yargs middleware function suitable for `.middleware([..., true])`.
+ * @__NO_SIDE_EFFECTS__
  */ function createOutputMiddleware(input) {
     var _input_loadOutputConfig, _input_saveCommandOutputConfig;
     var paths = buildCliPaths({
@@ -6343,6 +6356,7 @@ function resolveCallbacks(input) {
  * @param input.mergeOutputConfig - Optional override for persisting partial output-config updates.
  * @param input.clearOutputConfig - Optional override for clearing the persisted output config entirely.
  * @returns A yargs `CommandModule` exposing the full `output` subcommand surface.
+ * @__NO_SIDE_EFFECTS__
  */ function createOutputCommand(input) {
     var callbacks = resolveCallbacks(input);
     var setCommand = {
@@ -6704,6 +6718,7 @@ function _ts_generator$2(thisArg, body) {
  * @param input.argv - Argv to parse. Defaults to `hideBin(process.argv)`.
  * @param input.disableCallPassthrough - When `true`, omits the built-in `call` passthrough.
  * @returns The configured yargs `Argv` ready to be `.parse()`-d.
+ * @__NO_SIDE_EFFECTS__
  */ function createCli(input) {
     var _input_configCommands, _input_apiCommands, _input_argv;
     var cliName = input.cliName;
@@ -7133,6 +7148,7 @@ var DATA_HELP_FLAG = '--data-help';
  * @param options - Optional overrides; see {@link BuildManifestCommandsOptions}.
  * @returns The yargs `CommandModule[]` ready to be passed to `runCli({ apiCommands })`. Empty
  *   when the manifest has no callable entries.
+ * @__NO_SIDE_EFFECTS__
  */ function buildManifestCommands(manifest, options) {
     var _ref, _ref1, _ref2, _ref3, _ref4, _ref5;
     var callable = manifest.filter(function(e) {

package/index.esm.js

@@ -272,6 +272,7 @@ var _errorMapper;
  * @param extension - File extension to append (`json` for full responses, `ndjson` for streaming dumps).
  * @param suffix - Optional suffix appended to the filename before the extension.
  * @returns The absolute file path, or `undefined` when `dumpDir` is not configured.
+ * @__NO_SIDE_EFFECTS__
  */ function buildDumpFilePath(extension, suffix) {
     var dumpDir = _outputOptions.dumpDir, commandPath = _outputOptions.commandPath;
     if (!dumpDir) {
@@ -408,6 +409,7 @@ function pickFromObject(obj, fields) {
  *
  * @param error - The thrown value to convert.
  * @returns The structured {@link CliErrorOutput}.
+ * @__NO_SIDE_EFFECTS__
  */ function buildErrorOutput(error) {
     if (_errorMapper) {
         var mapped = _errorMapper(error);
@@ -669,6 +671,7 @@ function trimSlash$1(url) {
  * @param input - Optional slot configuration.
  * @param input.notInitializedMessage - Custom error message thrown by `require()` when the slot is unset.
  * @returns A new {@link ContextSlot} for type `T`.
+ * @__NO_SIDE_EFFECTS__
  */ function createContextSlot(input) {
     var _ref;
     var _value;
@@ -713,6 +716,7 @@ var getCliContext = _cliContextSlot.get;
  * @param input.env - The resolved {@link CliEnvConfig} for the active env.
  * @param input.accessToken - The Bearer access token to include on outgoing API calls.
  * @returns The constructed {@link CliContext}.
+ * @__NO_SIDE_EFFECTS__
  */ function createCliContext(input) {
     return {
         cliName: input.cliName,
@@ -912,6 +916,7 @@ function _ts_generator$e(thisArg, body) {
  *
  * @param spec - The command spec describing the yargs command surface plus how to map argv into the typed call params and the result.
  * @returns A yargs `CommandModule` whose handler runs the spec against the active CLI context.
+ * @__NO_SIDE_EFFECTS__
  */ function createCallModelCommand(spec) {
     return {
         command: spec.command,
@@ -1786,6 +1791,7 @@ function nonEmpty(value) {
  * @param config.cliName - The CLI's binary name; the default config dir is `~/.<cliName>`.
  * @param config.configDirOverride - Optional override that replaces the default config directory verbatim (used by tests).
  * @returns The {@link CliPaths} pointing at `configDir`, the config file, and the token cache file.
+ * @__NO_SIDE_EFFECTS__
  */ function buildCliPaths(config) {
     var _config_configDirOverride;
     var configDir = (_config_configDirOverride = config.configDirOverride) !== null && _config_configDirOverride !== void 0 ? _config_configDirOverride : join(homedir(), ".".concat(config.cliName));
@@ -1805,6 +1811,7 @@ function nonEmpty(value) {
  * @param input - The cache store inputs.
  * @param input.tokenCachePath - Absolute path to the JSON file backing the cache.
  * @returns A {@link CliTokenCacheStore} keyed by env name.
+ * @__NO_SIDE_EFFECTS__
  */ function createCliTokenCacheStore(input) {
     return createMemoizedJsonFileAsyncKeyedValueCache({
         filePath: input.tokenCachePath
@@ -2532,6 +2539,7 @@ function _ts_generator$a(thisArg, body) {
  * @param input.state - The opaque OAuth state token used for CSRF protection.
  * @param input.codeChallenge - The PKCE code challenge derived from the verifier.
  * @returns The full authorization URL with all OAuth params merged in.
+ * @__NO_SIDE_EFFECTS__
  */ function buildAuthorizationUrl(input) {
     var _input_scopes;
     var authParams = {
@@ -3064,6 +3072,7 @@ function maskEnv$1(env) {
  * @param input.envVarName - Override for the env-name env var. Defaults to `<CLINAME>_ENV` (e.g. `DEMO_CLI_ENV`).
  * @param input.defaultEnvs - Built-in env presets merged underneath the user's stored env when names match.
  * @returns A yargs `CommandModule` exposing the full `auth` subcommand surface.
+ * @__NO_SIDE_EFFECTS__
  */ function createAuthCommand(input) {
     var _input_envVarName;
     var cliName = input.cliName;
@@ -4411,6 +4420,7 @@ function _ts_generator$8(thisArg, body) {
  * @param input.checks - Additional checks to append after the default check list.
  * @param input.defaultEnvs - Built-in env presets merged underneath the user's stored env when names match.
  * @returns A yargs `CommandModule` exposing the `doctor` command.
+ * @__NO_SIDE_EFFECTS__
  */ function createDoctorCommand(input) {
     var _input_checks;
     var cliName = input.cliName;
@@ -4849,6 +4859,7 @@ function resolveEnvWithDefault(input) {
  * @param input.cliName - The CLI's binary name.
  * @param input.defaultEnvs - Built-in env presets merged underneath the user's stored env when names match.
  * @returns A yargs `CommandModule` exposing the full `env` subcommand surface.
+ * @__NO_SIDE_EFFECTS__
  */ function createEnvCommand(input) {
     var paths = buildCliPaths({
         cliName: input.cliName
@@ -5464,6 +5475,7 @@ function _ts_generator$6(thisArg, body) {
  * @param input.skipCommands - Top-level command names that bypass authentication entirely.
  * @param input.defaultEnvs - Built-in env presets merged underneath the user's stored env when names match.
  * @returns A yargs middleware function suitable for `.middleware([..., true])`.
+ * @__NO_SIDE_EFFECTS__
  */ function createAuthMiddleware(input) {
     var paths = buildCliPaths({
         cliName: input.cliName
@@ -5782,6 +5794,7 @@ function _ts_generator$5(thisArg, body) {
  * @param input.loadOutputConfig - Optional override for how the output config is read.
  * @param input.saveCommandOutputConfig - Optional override for how a per-command output config is persisted.
  * @returns A yargs middleware function suitable for `.middleware([..., true])`.
+ * @__NO_SIDE_EFFECTS__
  */ function createOutputMiddleware(input) {
     var _input_loadOutputConfig, _input_saveCommandOutputConfig;
     var paths = buildCliPaths({
@@ -6341,6 +6354,7 @@ function resolveCallbacks(input) {
  * @param input.mergeOutputConfig - Optional override for persisting partial output-config updates.
  * @param input.clearOutputConfig - Optional override for clearing the persisted output config entirely.
  * @returns A yargs `CommandModule` exposing the full `output` subcommand surface.
+ * @__NO_SIDE_EFFECTS__
  */ function createOutputCommand(input) {
     var callbacks = resolveCallbacks(input);
     var setCommand = {
@@ -6702,6 +6716,7 @@ function _ts_generator$2(thisArg, body) {
  * @param input.argv - Argv to parse. Defaults to `hideBin(process.argv)`.
  * @param input.disableCallPassthrough - When `true`, omits the built-in `call` passthrough.
  * @returns The configured yargs `Argv` ready to be `.parse()`-d.
+ * @__NO_SIDE_EFFECTS__
  */ function createCli(input) {
     var _input_configCommands, _input_apiCommands, _input_argv;
     var cliName = input.cliName;
@@ -7131,6 +7146,7 @@ var DATA_HELP_FLAG = '--data-help';
  * @param options - Optional overrides; see {@link BuildManifestCommandsOptions}.
  * @returns The yargs `CommandModule[]` ready to be passed to `runCli({ apiCommands })`. Empty
  *   when the manifest has no callable entries.
+ * @__NO_SIDE_EFFECTS__
  */ function buildManifestCommands(manifest, options) {
     var _ref, _ref1, _ref2, _ref3, _ref4, _ref5;
     var callable = manifest.filter(function(e) {

package/manifest-extract/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-cli/manifest-extract",
-  "version": "13.11.2",
+  "version": "13.11.3",
   "sideEffects": false,
   "peerDependencies": {
     "ts-morph": "^21.0.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-cli",
-  "version": "13.11.2",
+  "version": "13.11.3",
   "sideEffects": false,
   "bin": {
     "dbx-cli-generate-firebase-api-manifest": "firebase-api-manifest/main.js"
@@ -24,9 +24,9 @@
     }
   },
   "peerDependencies": {
-    "@dereekb/firebase": "13.11.2",
-    "@dereekb/nestjs": "13.11.2",
-    "@dereekb/util": "13.11.2",
+    "@dereekb/firebase": "13.11.3",
+    "@dereekb/nestjs": "13.11.3",
+    "@dereekb/util": "13.11.3",
     "arktype": "^2.2.0",
     "yargs": "^18.0.0"
   },

package/src/lib/api/call-model.command.factory.d.ts

@@ -38,5 +38,6 @@ export interface CallModelCommandSpec<TParams = unknown, TResult = unknown> {
  *
  * @param spec - The command spec describing the yargs command surface plus how to map argv into the typed call params and the result.
  * @returns A yargs `CommandModule` whose handler runs the spec against the active CLI context.
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function createCallModelCommand<TParams = unknown, TResult = unknown>(spec: CallModelCommandSpec<TParams, TResult>): CommandModule;

package/src/lib/auth/auth.command.factory.d.ts

@@ -25,5 +25,6 @@ export interface CreateAuthCommandInput {
  * @param input.envVarName - Override for the env-name env var. Defaults to `<CLINAME>_ENV` (e.g. `DEMO_CLI_ENV`).
  * @param input.defaultEnvs - Built-in env presets merged underneath the user's stored env when names match.
  * @returns A yargs `CommandModule` exposing the full `auth` subcommand surface.
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function createAuthCommand(input: CreateAuthCommandInput): CommandModule;

package/src/lib/auth/oidc.flow.d.ts

@@ -40,6 +40,7 @@ export interface BuildAuthorizationUrlInput {
  * @param input.state - The opaque OAuth state token used for CSRF protection.
  * @param input.codeChallenge - The PKCE code challenge derived from the verifier.
  * @returns The full authorization URL with all OAuth params merged in.
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function buildAuthorizationUrl(input: BuildAuthorizationUrlInput): string;
 export interface PkceMaterial {

package/src/lib/config/paths.d.ts

@@ -29,5 +29,6 @@ export interface CliPathsConfig {
  * @param config.cliName - The CLI's binary name; the default config dir is `~/.<cliName>`.
  * @param config.configDirOverride - Optional override that replaces the default config directory verbatim (used by tests).
  * @returns The {@link CliPaths} pointing at `configDir`, the config file, and the token cache file.
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function buildCliPaths(config: CliPathsConfig): CliPaths;

package/src/lib/config/token.cache.d.ts

@@ -36,6 +36,7 @@ export interface CreateCliTokenCacheStoreInput {
  * @param input - The cache store inputs.
  * @param input.tokenCachePath - Absolute path to the JSON file backing the cache.
  * @returns A {@link CliTokenCacheStore} keyed by env name.
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function createCliTokenCacheStore(input: CreateCliTokenCacheStoreInput): CliTokenCacheStore;
 /**

package/src/lib/context/cli.context.d.ts

@@ -37,5 +37,6 @@ export interface CreateCliContextInput {
  * @param input.env - The resolved {@link CliEnvConfig} for the active env.
  * @param input.accessToken - The Bearer access token to include on outgoing API calls.
  * @returns The constructed {@link CliContext}.
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function createCliContext(input: CreateCliContextInput): CliContext;

package/src/lib/doctor/doctor.command.factory.d.ts

@@ -44,5 +44,6 @@ export interface CreateDoctorCommandInput {
  * @param input.checks - Additional checks to append after the default check list.
  * @param input.defaultEnvs - Built-in env presets merged underneath the user's stored env when names match.
  * @returns A yargs `CommandModule` exposing the `doctor` command.
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function createDoctorCommand(input: CreateDoctorCommandInput): CommandModule;

package/src/lib/env/env.command.factory.d.ts

@@ -18,5 +18,6 @@ export interface CreateEnvCommandInput {
  * @param input.cliName - The CLI's binary name.
  * @param input.defaultEnvs - Built-in env presets merged underneath the user's stored env when names match.
  * @returns A yargs `CommandModule` exposing the full `env` subcommand surface.
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function createEnvCommand(input: CreateEnvCommandInput): CommandModule;

package/src/lib/manifest/build-manifest-commands.d.ts

@@ -103,6 +103,7 @@ export declare const DEFAULT_MANIFEST_MODEL_COMMAND_NAME = "model";
  * @param options - Optional overrides; see {@link BuildManifestCommandsOptions}.
  * @returns The yargs `CommandModule[]` ready to be passed to `runCli({ apiCommands })`. Empty
  *   when the manifest has no callable entries.
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function buildManifestCommands(manifest: CliApiManifest, options?: BuildManifestCommandsOptions): CommandModule[];
 /**

package/src/lib/middleware/auth.middleware.d.ts

@@ -25,5 +25,6 @@ export interface CreateAuthMiddlewareInput {
  * @param input.skipCommands - Top-level command names that bypass authentication entirely.
  * @param input.defaultEnvs - Built-in env presets merged underneath the user's stored env when names match.
  * @returns A yargs middleware function suitable for `.middleware([..., true])`.
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function createAuthMiddleware(input: CreateAuthMiddlewareInput): MiddlewareFunction;

package/src/lib/middleware/output.middleware.d.ts

@@ -50,5 +50,6 @@ export interface CreateOutputMiddlewareInput {
  * @param input.loadOutputConfig - Optional override for how the output config is read.
  * @param input.saveCommandOutputConfig - Optional override for how a per-command output config is persisted.
  * @returns A yargs middleware function suitable for `.middleware([..., true])`.
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function createOutputMiddleware(input: CreateOutputMiddlewareInput): MiddlewareFunction;

package/src/lib/output/output.command.factory.d.ts

@@ -51,5 +51,6 @@ export interface CreateOutputCommandInput {
  * @param input.mergeOutputConfig - Optional override for persisting partial output-config updates.
  * @param input.clearOutputConfig - Optional override for clearing the persisted output config entirely.
  * @returns A yargs `CommandModule` exposing the full `output` subcommand surface.
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function createOutputCommand(input: CreateOutputCommandInput): CommandModule;

package/src/lib/runner/run.d.ts

@@ -62,6 +62,7 @@ export interface CreateCliInput {
  * @param input.argv - Argv to parse. Defaults to `hideBin(process.argv)`.
  * @param input.disableCallPassthrough - When `true`, omits the built-in `call` passthrough.
  * @returns The configured yargs `Argv` ready to be `.parse()`-d.
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function createCli(input: CreateCliInput): Argv;
 /**

package/src/lib/util/context.slot.d.ts

@@ -46,5 +46,6 @@ export interface CreateContextSlotInput {
  * @param input - Optional slot configuration.
  * @param input.notInitializedMessage - Custom error message thrown by `require()` when the slot is unset.
  * @returns A new {@link ContextSlot} for type `T`.
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function createContextSlot<T>(input?: CreateContextSlotInput): ContextSlot<T>;

package/src/lib/util/output.d.ts

@@ -95,6 +95,7 @@ export declare function dumpTimestamp(): string;
  * @param extension - File extension to append (`json` for full responses, `ndjson` for streaming dumps).
  * @param suffix - Optional suffix appended to the filename before the extension.
  * @returns The absolute file path, or `undefined` when `dumpDir` is not configured.
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function buildDumpFilePath(extension: 'json' | 'ndjson', suffix?: string): Maybe<string>;
 /**
@@ -148,5 +149,6 @@ export declare class CliError extends Error {
  *
  * @param error - The thrown value to convert.
  * @returns The structured {@link CliErrorOutput}.
+ * @__NO_SIDE_EFFECTS__
  */
 export declare function buildErrorOutput(error: unknown): CliErrorOutput;