@danielarndt0/cnpj-db-loader 2.4.0-beta.3 → 2.4.0-beta.4

package/dist/cli.js

@@ -100,6 +100,222 @@ function getConfigFilePath() {
   return path2.join(os2.homedir(), ".config", "cnpj-db-loader", "config.json");
 }
 
+// src/services/federal-revenue/client.ts
+var DEFAULT_FEDERAL_REVENUE_WEBDAV_URL = "https://arquivos.receitafederal.gov.br/public.php/webdav";
+var DEFAULT_FEDERAL_REVENUE_USER_AGENT = "cnpj-db-loader federal-revenue-client";
+var REFERENCE_PATTERN = /^\d{4}-\d{2}$/;
+function trimTrailingSlash(value) {
+  return value.replace(/\/+$/g, "");
+}
+function normalizeBaseUrl(value) {
+  return trimTrailingSlash(value ?? DEFAULT_FEDERAL_REVENUE_WEBDAV_URL);
+}
+function getShareToken(value) {
+  const shareToken = value?.trim();
+  if (!shareToken) {
+    throw new ValidationError(
+      "Federal Revenue public share token is not configured. Run `cnpj-db-loader federal-revenue config set share-token <token>` or pass --share-token."
+    );
+  }
+  return shareToken;
+}
+function encodePathSegment(value) {
+  return encodeURIComponent(value).replace(/%2F/gi, "/");
+}
+function decodeXml(value) {
+  return value.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'");
+}
+function decodeHrefSegment(value) {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+}
+function getAuthHeader(shareToken) {
+  return `Basic ${Buffer.from(`${shareToken}:`).toString("base64")}`;
+}
+function buildUrl(baseUrl, segments = []) {
+  if (segments.length === 0) {
+    return `${baseUrl}/`;
+  }
+  return `${baseUrl}/${segments.map(encodePathSegment).join("/")}`;
+}
+function extractFirst(block, tagName) {
+  const pattern = new RegExp(
+    `<(?:[a-zA-Z0-9_-]+:)?${tagName}\\b[^>]*>([\\s\\S]*?)<\\/(?:[a-zA-Z0-9_-]+:)?${tagName}>`,
+    "i"
+  );
+  const match = block.match(pattern);
+  return match?.[1] ? decodeXml(match[1].trim()) : void 0;
+}
+function isCollectionResponse(block) {
+  return /<(?:[a-zA-Z0-9_-]+:)?collection\b/i.test(block);
+}
+function getNameFromHref(href) {
+  const cleanHref = href.split("?")[0] ?? href;
+  const withoutTrailingSlash = cleanHref.replace(/\/+$/g, "");
+  const rawName = withoutTrailingSlash.split("/").pop() ?? withoutTrailingSlash;
+  return decodeHrefSegment(rawName);
+}
+function parsePropfindXml(xml) {
+  const responseBlocks = xml.match(
+    /<(?:[a-zA-Z0-9_-]+:)?response\b[\s\S]*?<\/(?:[a-zA-Z0-9_-]+:)?response>/gi
+  );
+  if (!responseBlocks) {
+    return [];
+  }
+  return responseBlocks.map((block) => {
+    const href = extractFirst(block, "href");
+    if (!href) {
+      return void 0;
+    }
+    const size = extractFirst(block, "getcontentlength");
+    const parsedSize = size ? Number.parseInt(size, 10) : void 0;
+    const lastModified = extractFirst(block, "getlastmodified");
+    const etag = extractFirst(block, "getetag");
+    return {
+      href,
+      name: getNameFromHref(href),
+      isCollection: isCollectionResponse(block),
+      ...Number.isFinite(parsedSize) ? { sizeInBytes: parsedSize } : {},
+      ...lastModified ? { lastModified } : {},
+      ...etag ? { etag } : {}
+    };
+  }).filter((entry) => entry !== void 0);
+}
+async function propfind(pathSegments, options = {}) {
+  const baseUrl = normalizeBaseUrl(options.baseUrl);
+  const shareToken = getShareToken(options.shareToken);
+  let response;
+  try {
+    response = await fetch(buildUrl(baseUrl, pathSegments), {
+      method: "PROPFIND",
+      headers: {
+        Accept: "application/xml,text/xml,*/*",
+        Authorization: getAuthHeader(shareToken),
+        Depth: "1",
+        "User-Agent": options.userAgent ?? DEFAULT_FEDERAL_REVENUE_USER_AGENT
+      }
+    });
+  } catch (error) {
+    throw new ValidationError(
+      `Federal Revenue WebDAV request failed before receiving a response: ${error instanceof Error ? error.message : String(error)}.`,
+      { baseUrl, pathSegments }
+    );
+  }
+  if (!response.ok) {
+    throw new ValidationError(
+      `Federal Revenue WebDAV request failed with status ${response.status} ${response.statusText}.`,
+      { status: response.status, statusText: response.statusText }
+    );
+  }
+  const xml = await response.text();
+  return {
+    entries: parsePropfindXml(xml),
+    baseUrl,
+    shareToken
+  };
+}
+function validateFederalRevenueReference(reference) {
+  if (!REFERENCE_PATTERN.test(reference)) {
+    throw new ValidationError(
+      `Federal Revenue reference is invalid: ${reference}. Expected YYYY-MM.`
+    );
+  }
+}
+function getCurrentFederalRevenueReference(date = /* @__PURE__ */ new Date()) {
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  return `${year}-${month}`;
+}
+async function listFederalRevenueReferences(options = {}) {
+  const result = await propfind([], options);
+  const references = result.entries.filter((entry) => entry.isCollection && REFERENCE_PATTERN.test(entry.name)).map((entry) => ({
+    reference: entry.name,
+    href: entry.href
+  })).sort((left, right) => left.reference.localeCompare(right.reference));
+  return {
+    references,
+    remoteBaseUrl: result.baseUrl
+  };
+}
+async function resolveFederalRevenueReference(input2 = {}) {
+  const { references } = await listFederalRevenueReferences(input2);
+  const availableReferences = references.map((item) => item.reference);
+  const latest = availableReferences.at(-1);
+  if (!latest) {
+    throw new ValidationError(
+      "Federal Revenue reference discovery failed: no monthly references were found in the public share."
+    );
+  }
+  if (input2.reference) {
+    validateFederalRevenueReference(input2.reference);
+    if (!availableReferences.includes(input2.reference)) {
+      throw new ValidationError(
+        `Federal Revenue reference not found: ${input2.reference}. Latest available reference is ${latest}.`,
+        {
+          requestedReference: input2.reference,
+          latestAvailableReference: latest,
+          availableReferences
+        }
+      );
+    }
+    return {
+      mode: "explicit",
+      selectedReference: input2.reference,
+      availableReferences
+    };
+  }
+  if (input2.current) {
+    const currentReference = getCurrentFederalRevenueReference();
+    if (!availableReferences.includes(currentReference)) {
+      throw new ValidationError(
+        `Federal Revenue current reference is not available yet: ${currentReference}. Latest available reference is ${latest}.`,
+        {
+          requestedReference: currentReference,
+          latestAvailableReference: latest,
+          availableReferences
+        }
+      );
+    }
+    return {
+      mode: "current",
+      selectedReference: currentReference,
+      availableReferences
+    };
+  }
+  return {
+    mode: "latest",
+    selectedReference: latest,
+    availableReferences
+  };
+}
+async function listFederalRevenueFiles(reference, options = {}) {
+  validateFederalRevenueReference(reference);
+  const result = await propfind([reference], options);
+  const files = result.entries.filter(
+    (entry) => !entry.isCollection && entry.name.toLowerCase().endsWith(".zip")
+  ).map((entry) => ({
+    name: entry.name,
+    href: entry.href,
+    downloadUrl: buildUrl(result.baseUrl, [reference, entry.name]),
+    ...entry.sizeInBytes !== void 0 ? { sizeInBytes: entry.sizeInBytes } : {},
+    ...entry.lastModified ? { lastModified: entry.lastModified } : {},
+    ...entry.etag ? { etag: entry.etag } : {}
+  })).sort((left, right) => left.name.localeCompare(right.name));
+  return {
+    files,
+    remoteBaseUrl: result.baseUrl
+  };
+}
+function buildFederalRevenueDownloadHeaders(options = {}) {
+  return {
+    Authorization: getAuthHeader(getShareToken(options.shareToken)),
+    "User-Agent": options.userAgent ?? DEFAULT_FEDERAL_REVENUE_USER_AGENT
+  };
+}
+
 // src/services/config.service.ts
 async function readDatabaseConfig() {
   const raw = await safeReadText(getConfigFilePath());
@@ -127,12 +343,149 @@ function assertPostgresUrl(url) {
     );
   }
 }
+function assertHttpUrl(url, label) {
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    throw new ValidationError(`${label} is not a valid URL.`, { url });
+  }
+  if (!["http:", "https:"].includes(parsed.protocol)) {
+    throw new ValidationError(`${label} must use the http or https protocol.`, {
+      url
+    });
+  }
+}
+function assertNonEmpty(value, label) {
+  const trimmed = value.trim();
+  if (!trimmed) {
+    throw new ValidationError(`${label} cannot be empty.`);
+  }
+  return trimmed;
+}
+function normalizeFederalRevenueConfigKey(key) {
+  const normalized = key.trim().toLowerCase();
+  if (["share-token", "share_token", "token"].includes(normalized)) {
+    return "share-token";
+  }
+  if (["webdav-url", "webdav_url", "base-url", "base_url", "url"].includes(
+    normalized
+  )) {
+    return "webdav-url";
+  }
+  if (["user-agent", "user_agent"].includes(normalized)) {
+    return "user-agent";
+  }
+  throw new ValidationError(
+    `Unknown Federal Revenue config key: ${key}. Expected share-token, webdav-url, or user-agent.`
+  );
+}
+function assignFederalRevenueConfigValue(config, key, value) {
+  if (key === "share-token") {
+    return {
+      ...config,
+      shareToken: assertNonEmpty(value, "Federal Revenue share token")
+    };
+  }
+  if (key === "webdav-url") {
+    const webdavUrl = assertNonEmpty(value, "Federal Revenue WebDAV URL");
+    assertHttpUrl(webdavUrl, "Federal Revenue WebDAV URL");
+    return { ...config, webdavUrl };
+  }
+  return {
+    ...config,
+    userAgent: assertNonEmpty(value, "Federal Revenue user agent")
+  };
+}
+function deleteFederalRevenueConfigValue(config, key) {
+  const nextConfig = { ...config };
+  if (key === "share-token") {
+    delete nextConfig.shareToken;
+  }
+  if (key === "webdav-url") {
+    delete nextConfig.webdavUrl;
+  }
+  if (key === "user-agent") {
+    delete nextConfig.userAgent;
+  }
+  return nextConfig;
+}
+function isFederalRevenueConfigEmpty(config) {
+  return !config.shareToken && !config.webdavUrl && !config.userAgent;
+}
 async function setDefaultDbUrl(url) {
   assertPostgresUrl(url);
-  await writeDatabaseConfig({ defaultDbUrl: url });
+  const currentConfig = await readDatabaseConfig();
+  await writeDatabaseConfig({ ...currentConfig, defaultDbUrl: url });
 }
 async function resetDefaultDbUrl() {
-  await writeDatabaseConfig({});
+  const currentConfig = await readDatabaseConfig();
+  const nextConfig = { ...currentConfig };
+  delete nextConfig.defaultDbUrl;
+  await writeDatabaseConfig(nextConfig);
+}
+async function setFederalRevenueConfigValue(key, value) {
+  const normalizedKey = normalizeFederalRevenueConfigKey(key);
+  const currentConfig = await readDatabaseConfig();
+  const federalRevenueConfig = assignFederalRevenueConfigValue(
+    currentConfig.federalRevenue ?? {},
+    normalizedKey,
+    value
+  );
+  await writeDatabaseConfig({
+    ...currentConfig,
+    federalRevenue: federalRevenueConfig
+  });
+  return getFederalRevenueEffectiveConfig(federalRevenueConfig);
+}
+async function resetFederalRevenueConfig(key) {
+  const currentConfig = await readDatabaseConfig();
+  if (!key) {
+    const nextConfig2 = { ...currentConfig };
+    delete nextConfig2.federalRevenue;
+    await writeDatabaseConfig(nextConfig2);
+    return getFederalRevenueEffectiveConfig({});
+  }
+  const normalizedKey = normalizeFederalRevenueConfigKey(key);
+  const federalRevenueConfig = deleteFederalRevenueConfigValue(
+    currentConfig.federalRevenue ?? {},
+    normalizedKey
+  );
+  const nextConfig = { ...currentConfig };
+  if (isFederalRevenueConfigEmpty(federalRevenueConfig)) {
+    delete nextConfig.federalRevenue;
+  } else {
+    nextConfig.federalRevenue = federalRevenueConfig;
+  }
+  await writeDatabaseConfig(nextConfig);
+  return getFederalRevenueEffectiveConfig(federalRevenueConfig);
+}
+function getFederalRevenueEffectiveConfig(config = {}) {
+  return {
+    webdavUrl: config.webdavUrl ?? DEFAULT_FEDERAL_REVENUE_WEBDAV_URL,
+    userAgent: config.userAgent ?? DEFAULT_FEDERAL_REVENUE_USER_AGENT,
+    ...config.shareToken ? { shareToken: config.shareToken } : {},
+    configured: {
+      webdavUrl: Boolean(config.webdavUrl),
+      userAgent: Boolean(config.userAgent),
+      shareToken: Boolean(config.shareToken)
+    }
+  };
+}
+async function readFederalRevenueEffectiveConfig() {
+  const currentConfig = await readDatabaseConfig();
+  return getFederalRevenueEffectiveConfig(currentConfig.federalRevenue ?? {});
+}
+async function resolveFederalRevenueClientOptions(overrides = {}) {
+  const currentConfig = await readDatabaseConfig();
+  const effectiveConfig = getFederalRevenueEffectiveConfig(
+    currentConfig.federalRevenue ?? {}
+  );
+  return {
+    baseUrl: overrides.baseUrl ?? effectiveConfig.webdavUrl,
+    shareToken: overrides.shareToken ?? effectiveConfig.shareToken,
+    userAgent: overrides.userAgent ?? effectiveConfig.userAgent
+  };
 }
 
 // src/services/database.service.ts
@@ -6685,217 +7038,6 @@ async function showQuarantineRow(id, options) {
   return record;
 }
 
-// src/services/federal-revenue/client.ts
-var DEFAULT_FEDERAL_REVENUE_SHARE_TOKEN = "YggdBLfdninEJX9";
-var DEFAULT_FEDERAL_REVENUE_WEBDAV_URL = "https://arquivos.receitafederal.gov.br/public.php/webdav";
-var DEFAULT_FEDERAL_REVENUE_USER_AGENT = "cnpj-db-loader federal-revenue-client";
-var REFERENCE_PATTERN = /^\d{4}-\d{2}$/;
-function trimTrailingSlash(value) {
-  return value.replace(/\/+$/g, "");
-}
-function normalizeBaseUrl(value) {
-  return trimTrailingSlash(value ?? DEFAULT_FEDERAL_REVENUE_WEBDAV_URL);
-}
-function getShareToken(value) {
-  return value ?? DEFAULT_FEDERAL_REVENUE_SHARE_TOKEN;
-}
-function encodePathSegment(value) {
-  return encodeURIComponent(value).replace(/%2F/gi, "/");
-}
-function decodeXml(value) {
-  return value.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'");
-}
-function decodeHrefSegment(value) {
-  try {
-    return decodeURIComponent(value);
-  } catch {
-    return value;
-  }
-}
-function getAuthHeader(shareToken) {
-  return `Basic ${Buffer.from(`${shareToken}:`).toString("base64")}`;
-}
-function buildUrl(baseUrl, segments = []) {
-  if (segments.length === 0) {
-    return `${baseUrl}/`;
-  }
-  return `${baseUrl}/${segments.map(encodePathSegment).join("/")}`;
-}
-function extractFirst(block, tagName) {
-  const pattern = new RegExp(
-    `<(?:[a-zA-Z0-9_-]+:)?${tagName}\\b[^>]*>([\\s\\S]*?)<\\/(?:[a-zA-Z0-9_-]+:)?${tagName}>`,
-    "i"
-  );
-  const match = block.match(pattern);
-  return match?.[1] ? decodeXml(match[1].trim()) : void 0;
-}
-function isCollectionResponse(block) {
-  return /<(?:[a-zA-Z0-9_-]+:)?collection\b/i.test(block);
-}
-function getNameFromHref(href) {
-  const cleanHref = href.split("?")[0] ?? href;
-  const withoutTrailingSlash = cleanHref.replace(/\/+$/g, "");
-  const rawName = withoutTrailingSlash.split("/").pop() ?? withoutTrailingSlash;
-  return decodeHrefSegment(rawName);
-}
-function parsePropfindXml(xml) {
-  const responseBlocks = xml.match(
-    /<(?:[a-zA-Z0-9_-]+:)?response\b[\s\S]*?<\/(?:[a-zA-Z0-9_-]+:)?response>/gi
-  );
-  if (!responseBlocks) {
-    return [];
-  }
-  return responseBlocks.map((block) => {
-    const href = extractFirst(block, "href");
-    if (!href) {
-      return void 0;
-    }
-    const size = extractFirst(block, "getcontentlength");
-    const parsedSize = size ? Number.parseInt(size, 10) : void 0;
-    const lastModified = extractFirst(block, "getlastmodified");
-    const etag = extractFirst(block, "getetag");
-    return {
-      href,
-      name: getNameFromHref(href),
-      isCollection: isCollectionResponse(block),
-      ...Number.isFinite(parsedSize) ? { sizeInBytes: parsedSize } : {},
-      ...lastModified ? { lastModified } : {},
-      ...etag ? { etag } : {}
-    };
-  }).filter((entry) => entry !== void 0);
-}
-async function propfind(pathSegments, options = {}) {
-  const baseUrl = normalizeBaseUrl(options.baseUrl);
-  const shareToken = getShareToken(options.shareToken);
-  let response;
-  try {
-    response = await fetch(buildUrl(baseUrl, pathSegments), {
-      method: "PROPFIND",
-      headers: {
-        Accept: "application/xml,text/xml,*/*",
-        Authorization: getAuthHeader(shareToken),
-        Depth: "1",
-        "User-Agent": options.userAgent ?? DEFAULT_FEDERAL_REVENUE_USER_AGENT
-      }
-    });
-  } catch (error) {
-    throw new ValidationError(
-      `Federal Revenue WebDAV request failed before receiving a response: ${error instanceof Error ? error.message : String(error)}.`,
-      { baseUrl, pathSegments }
-    );
-  }
-  if (!response.ok) {
-    throw new ValidationError(
-      `Federal Revenue WebDAV request failed with status ${response.status} ${response.statusText}.`,
-      { status: response.status, statusText: response.statusText }
-    );
-  }
-  const xml = await response.text();
-  return {
-    entries: parsePropfindXml(xml),
-    baseUrl,
-    shareToken
-  };
-}
-function validateFederalRevenueReference(reference) {
-  if (!REFERENCE_PATTERN.test(reference)) {
-    throw new ValidationError(
-      `Federal Revenue reference is invalid: ${reference}. Expected YYYY-MM.`
-    );
-  }
-}
-function getCurrentFederalRevenueReference(date = /* @__PURE__ */ new Date()) {
-  const year = date.getFullYear();
-  const month = String(date.getMonth() + 1).padStart(2, "0");
-  return `${year}-${month}`;
-}
-async function listFederalRevenueReferences(options = {}) {
-  const result = await propfind([], options);
-  const references = result.entries.filter((entry) => entry.isCollection && REFERENCE_PATTERN.test(entry.name)).map((entry) => ({
-    reference: entry.name,
-    href: entry.href
-  })).sort((left, right) => left.reference.localeCompare(right.reference));
-  return {
-    references,
-    remoteBaseUrl: result.baseUrl
-  };
-}
-async function resolveFederalRevenueReference(input2 = {}) {
-  const { references } = await listFederalRevenueReferences(input2);
-  const availableReferences = references.map((item) => item.reference);
-  const latest = availableReferences.at(-1);
-  if (!latest) {
-    throw new ValidationError(
-      "Federal Revenue reference discovery failed: no monthly references were found in the public share."
-    );
-  }
-  if (input2.reference) {
-    validateFederalRevenueReference(input2.reference);
-    if (!availableReferences.includes(input2.reference)) {
-      throw new ValidationError(
-        `Federal Revenue reference not found: ${input2.reference}. Latest available reference is ${latest}.`,
-        {
-          requestedReference: input2.reference,
-          latestAvailableReference: latest,
-          availableReferences
-        }
-      );
-    }
-    return {
-      mode: "explicit",
-      selectedReference: input2.reference,
-      availableReferences
-    };
-  }
-  if (input2.current) {
-    const currentReference = getCurrentFederalRevenueReference();
-    if (!availableReferences.includes(currentReference)) {
-      throw new ValidationError(
-        `Federal Revenue current reference is not available yet: ${currentReference}. Latest available reference is ${latest}.`,
-        {
-          requestedReference: currentReference,
-          latestAvailableReference: latest,
-          availableReferences
-        }
-      );
-    }
-    return {
-      mode: "current",
-      selectedReference: currentReference,
-      availableReferences
-    };
-  }
-  return {
-    mode: "latest",
-    selectedReference: latest,
-    availableReferences
-  };
-}
-async function listFederalRevenueFiles(reference, options = {}) {
-  validateFederalRevenueReference(reference);
-  const result = await propfind([reference], options);
-  const files = result.entries.filter(
-    (entry) => !entry.isCollection && entry.name.toLowerCase().endsWith(".zip")
-  ).map((entry) => ({
-    name: entry.name,
-    href: entry.href,
-    downloadUrl: buildUrl(result.baseUrl, [reference, entry.name]),
-    ...entry.sizeInBytes !== void 0 ? { sizeInBytes: entry.sizeInBytes } : {},
-    ...entry.lastModified ? { lastModified: entry.lastModified } : {},
-    ...entry.etag ? { etag: entry.etag } : {}
-  })).sort((left, right) => left.name.localeCompare(right.name));
-  return {
-    files,
-    remoteBaseUrl: result.baseUrl
-  };
-}
-function buildFederalRevenueDownloadHeaders(options = {}) {
-  return {
-    Authorization: getAuthHeader(getShareToken(options.shareToken)),
-    "User-Agent": options.userAgent ?? DEFAULT_FEDERAL_REVENUE_USER_AGENT
-  };
-}
-
 // src/services/federal-revenue/download.ts
 import { createWriteStream } from "fs";
 import { mkdir as mkdir5, rename, stat as stat5, unlink } from "fs/promises";
@@ -9852,6 +9994,28 @@ function printDatabaseConfigSummary(config, logFilePath) {
   );
   console.log(`${theme.muted("Log file:")} ${resolveLogFilePath(logFilePath)}`);
 }
+function printFederalRevenueConfigSummary(config, logFilePath) {
+  console.log(
+    theme.successLabel("FEDERAL REVENUE"),
+    "Federal Revenue configuration loaded."
+  );
+  console.log(
+    formatKeyValue(
+      "WebDAV URL",
+      `${config.webdavUrl}${config.configured.webdavUrl ? "" : " (default)"}`
+    )
+  );
+  console.log(
+    formatKeyValue(
+      "User agent",
+      `${config.userAgent}${config.configured.userAgent ? "" : " (default)"}`
+    )
+  );
+  console.log(
+    formatKeyValue("Share token", config.shareToken ?? "not configured")
+  );
+  console.log(`${theme.muted("Log file:")} ${resolveLogFilePath(logFilePath)}`);
+}
 function printDatabaseCleanupSummary(summary, logFilePath) {
   console.log(
     theme.successLabel("DATABASE"),
@@ -11377,8 +11541,21 @@ function applySharedOptions(options, target) {
   if (options.shareToken) {
     target.shareToken = options.shareToken;
   }
+  if (options.userAgent) {
+    target.userAgent = options.userAgent;
+  }
   return target;
 }
+async function resolveSharedOptions(referenceArgument, options) {
+  const mergedOptions = mergeSharedOptions(referenceArgument, options);
+  const clientOptions = await resolveFederalRevenueClientOptions(mergedOptions);
+  return {
+    ...mergedOptions,
+    ...clientOptions.baseUrl ? { baseUrl: clientOptions.baseUrl } : {},
+    ...clientOptions.shareToken ? { shareToken: clientOptions.shareToken } : {},
+    ...clientOptions.userAgent ? { userAgent: clientOptions.userAgent } : {}
+  };
+}
 function buildDownloadOptions(options) {
   const downloadOptions = applySharedOptions(
     options,
@@ -11463,6 +11640,9 @@ function registerSharedOptions(command) {
   ).option(
     "--share-token <token>",
     "Override the public Federal Revenue share token."
+  ).option(
+    "--user-agent <value>",
+    "Override the Federal Revenue HTTP user agent."
   );
 }
 function registerDownloadOptions(command) {
@@ -11497,6 +11677,70 @@ function registerFederalRevenueCommands(program) {
   const federalRevenue = program.command("federal-revenue").alias("revenue").description(
     "Check, download, sync, and maintain CNPJ monthly files from the Federal Revenue public share."
   );
+  const config = federalRevenue.command("config").description(
+    "Read, persist, test, or reset Federal Revenue public share settings."
+  );
+  config.command("set").argument(
+    "<key>",
+    "Configuration key: share-token, webdav-url, or user-agent."
+  ).argument("<value>", "Configuration value to persist.").description(
+    "Persist a Federal Revenue setting in the local CNPJ DB Loader config file."
+  ).action(async (key, value) => {
+    const effectiveConfig = await setFederalRevenueConfigValue(key, value);
+    const logFilePath = await writeCommandLog("federal-revenue-config-set", {
+      key,
+      effectiveConfig
+    });
+    printFederalRevenueConfigSummary(effectiveConfig, logFilePath);
+  });
+  config.command("show").description("Show the currently persisted Federal Revenue configuration.").action(async () => {
+    const effectiveConfig = await readFederalRevenueEffectiveConfig();
+    const logFilePath = await writeCommandLog(
+      "federal-revenue-config-show",
+      effectiveConfig
+    );
+    printFederalRevenueConfigSummary(effectiveConfig, logFilePath);
+  });
+  config.command("test").description("Test the configured Federal Revenue WebDAV connection.").action(async () => {
+    const clientOptions = await resolveFederalRevenueClientOptions();
+    const result = await listFederalRevenueReferences(clientOptions);
+    const references = result.references.map((item) => item.reference);
+    const latestReference = references.at(-1) ?? "not found";
+    const logFilePath = await writeCommandLog("federal-revenue-config-test", {
+      remoteBaseUrl: result.remoteBaseUrl,
+      referencesFound: references.length,
+      latestReference
+    });
+    printFederalRevenueConfigSummary(
+      await readFederalRevenueEffectiveConfig(),
+      logFilePath
+    );
+    console.log(
+      `Federal Revenue WebDAV connection succeeded. References found: ${references.length}. Latest reference: ${latestReference}.`
+    );
+  });
+  config.command("reset").argument(
+    "[key]",
+    "Optional key to reset: share-token, webdav-url, or user-agent. When omitted, all Federal Revenue settings are reset."
+  ).option("-f, --force", "Skip the confirmation prompt.").description(
+    "Reset one Federal Revenue setting or all persisted Federal Revenue settings."
+  ).action(async (key, options) => {
+    const target = key ? `Federal Revenue ${key}` : "all Federal Revenue";
+    const confirmed = await confirmFederalRevenueAction(
+      `Reset ${target} configuration?`,
+      options.force
+    );
+    if (!confirmed) {
+      console.log("Federal Revenue config reset cancelled.");
+      return;
+    }
+    const effectiveConfig = await resetFederalRevenueConfig(key);
+    const logFilePath = await writeCommandLog(
+      "federal-revenue-config-reset",
+      { key: key ?? "all", effectiveConfig }
+    );
+    printFederalRevenueConfigSummary(effectiveConfig, logFilePath);
+  });
   registerSharedOptions(
     federalRevenue.command("check").argument(
       "[reference]",
@@ -11506,7 +11750,10 @@ function registerFederalRevenueCommands(program) {
     )
   ).action(
     async (referenceArgument, options) => {
-      const resolvedOptions = mergeSharedOptions(referenceArgument, options);
+      const resolvedOptions = await resolveSharedOptions(
+        referenceArgument,
+        options
+      );
       const summary = await checkFederalRevenueDataset(
         applySharedOptions(resolvedOptions, {})
       );
@@ -11526,7 +11773,10 @@ function registerFederalRevenueCommands(program) {
     )
   ).action(
     async (referenceArgument, options) => {
-      const resolvedOptions = mergeSharedOptions(referenceArgument, options);
+      const resolvedOptions = await resolveSharedOptions(
+        referenceArgument,
+        options
+      );
       const confirmed = await confirmFederalRevenueAction(
         "Download Federal Revenue CNPJ ZIP files now? Existing completed files are skipped unless --overwrite is used.",
         options.force
@@ -11559,7 +11809,10 @@ function registerFederalRevenueCommands(program) {
     )
   ).action(
     async (referenceArgument, options) => {
-      const resolvedOptions = mergeSharedOptions(referenceArgument, options);
+      const resolvedOptions = await resolveSharedOptions(
+        referenceArgument,
+        options
+      );
       const summary = await getFederalRevenueStatus(
         buildStatusOptions({ ...options, ...resolvedOptions })
       );
@@ -11582,7 +11835,10 @@ function registerFederalRevenueCommands(program) {
     )
   ).action(
     async (referenceArgument, options) => {
-      const resolvedOptions = mergeSharedOptions(referenceArgument, options);
+      const resolvedOptions = await resolveSharedOptions(
+        referenceArgument,
+        options
+      );
       const confirmed = await confirmFederalRevenueAction(
         "Retry incomplete Federal Revenue files now? Completed files are kept.",
         options.force
@@ -11615,7 +11871,10 @@ function registerFederalRevenueCommands(program) {
     )
   ).action(
     async (referenceArgument, options) => {
-      const resolvedOptions = mergeSharedOptions(referenceArgument, options);
+      const resolvedOptions = await resolveSharedOptions(
+        referenceArgument,
+        options
+      );
       const actionLabel = options.all ? "remove the entire selected Federal Revenue reference folder" : options.failed ? "remove failed and partial Federal Revenue files" : "remove Federal Revenue .part files";
       const confirmed = await confirmFederalRevenueAction(
         `This will ${actionLabel}. Continue?`,
@@ -11670,7 +11929,10 @@ function registerFederalRevenueCommands(program) {
     )
   ).action(
     async (referenceArgument, options) => {
-      const resolvedOptions = mergeSharedOptions(referenceArgument, options);
+      const resolvedOptions = await resolveSharedOptions(
+        referenceArgument,
+        options
+      );
       const confirmed = await confirmFederalRevenueAction(
         "Run the full Federal Revenue sync now? This downloads files, extracts archives, sanitizes the dataset, and imports it into PostgreSQL.",
         options.force