@fluid-app/fluid-cli-localization 0.1.410 → 0.1.411

package/README.md

@@ -169,6 +169,17 @@ to and whether enrollment asks for it (`collected`, `inDraft`, `missing` or
   whole save and the command says so. `--skip-sensitive` creates the rest and
   lists the ones it left out.
 
+## `fluid markets` ordering and currencies
+
+| Command                               | What it does                                                                                                                                                   |
+| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `reorder <market...>`                 | Sets the full market order (ids or names, every market once). The first becomes the fallback. `--preview` writes nothing; `--yes` skips the prompt.            |
+| `set-fallback <market>`               | Makes a market the fallback. Refused, with the countries listed, while the fallback prices countries that have no market. `--preview` writes nothing; `--yes`. |
+| `currency add <market> <currency>`    | Adds a currency to a market. Adding one it already has is a no-op.                                                                                             |
+| `currency remove <market> <currency>` | Removes a currency from a market. Refused with the counts while it is billed, priced, or the market's last. `--yes` skips the prompt.                          |
+
+Every API refusal prints its code and details. Needs the market-config release.
+
 ## `fluid translations`
 
 | Command                                          | What it does                                                                      |

package/dist/index.d.mts

@@ -6,7 +6,7 @@ declare function registerCountriesCommands(parent: Command, ctx: CommandContext)
 //#endregion
 //#region src/markets/commands.d.ts
 /**
- * Register `fluid markets list|add-country|remove-country|rename|create|move|delete` on `parent`.
+ * Register `fluid markets list|add-country|remove-country|rename|create|move|delete|reorder|set-fallback|currency add|currency remove` on `parent`.
  *
  * @param parent - the `markets` command group
  * @param ctx - the CLI command context

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/countries/commands.ts","../src/markets/commands.ts","../src/translations/commands.ts","../src/index.ts"],"mappings":";;;;iBAiMgB,yBAAA,CACd,MAAA,EAAQ,OAAA,EACR,GAAA,EAAK,cAAA;;;;;AAFP;;;;iBC9HgB,uBAAA,CACd,MAAA,EAAQ,OAAA,EACR,GAAA,EAAK,cAAA;;;iBC+BS,4BAAA,CACd,MAAA,EAAQ,OAAA,EACR,GAAA,EAAK,cAAA;;;AF2FP;;;;;;AAAA,cGhLM,MAAA,EAAQ,WAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/countries/commands.ts","../src/markets/commands.ts","../src/translations/commands.ts","../src/index.ts"],"mappings":";;;;iBAiMgB,yBAAA,CACd,MAAA,EAAQ,OAAA,EACR,GAAA,EAAK,cAAA;;;;;AAFP;;;;iBCnHgB,uBAAA,CACd,MAAA,EAAQ,OAAA,EACR,GAAA,EAAK,cAAA;;;iBCoBS,4BAAA,CACd,MAAA,EAAQ,OAAA,EACR,GAAA,EAAK,cAAA;;;AF2FP;;;;;;AAAA,cGhLM,MAAA,EAAQ,WAAA"}

package/dist/index.mjs

@@ -4162,10 +4162,39 @@ function registerCountriesCommands(parent, ctx) {
 //#region src/markets/api.ts
 const MARKETS_PATH = "/api/company/v2026-10/markets";
 const MARKET_CONFIG_DISABLED_MESSAGE = "Markets configuration is not enabled for this company.";
+function listed(value) {
+	if (Array.isArray(value)) return value.map(listed).join(", ");
+	if (value && typeof value === "object") return Object.entries(value).map(([k, v]) => `${k} ${listed(v)}`).join(", ");
+	return String(value);
+}
+function summaryOf(code, details) {
+	const has = (key) => details[key] !== void 0;
+	switch (code) {
+		case "fallback_would_unprice": return has("isos") ? `would leave ${listed(details["isos"])} unpriced` : void 0;
+		case "currency_billed": return has("countries") ? `billed in ${listed(details["countries"])}` : void 0;
+		case "currency_has_prices": {
+			const parts = [
+				["prices per tier", "prices_per_tier"],
+				["bundle prices", "bundle_prices"],
+				["adjusted price lists", "adjusted_price_lists"]
+			].flatMap(([label, key]) => {
+				const value = details[key];
+				return !value || Array.isArray(value) && value.length === 0 || typeof value === "object" && Object.keys(value).length === 0 ? [] : [`${label}: ${listed(value)}`];
+			});
+			return parts.length > 0 ? parts.join("; ") : void 0;
+		}
+		case "positions_mismatch": {
+			const parts = Object.entries(details).map(([key, value]) => `${key.replace(/_/g, " ")}: ${listed(value)}`);
+			return parts.length > 0 ? parts.join("; ") : void 0;
+		}
+		default: return;
+	}
+}
 /**
 * The error to show for a failed markets call: the server's `message`, a
 * fixed text for a disabled release, and a retry hint for `retry_later`.
-* Keeps the HTTP status so the failure report carries it.
+* Known refusal codes with details print a readable summary; others append
+* the details as JSON. Keeps the HTTP status, `code` and raw `details` on the error.
 */
 function marketsFailure(err, withCode = false) {
 	const status = statusOf(err);
@@ -4180,8 +4209,14 @@ function marketsFailure(err, withCode = false) {
 	} else if (code === "retry_later") message = "The company is busy. Try again.";
 	else message = errorDetail(err).message;
 	const details = body?.["details"];
-	if (details && typeof details === "object" && Object.keys(details).length > 0) message = `${message} (${JSON.stringify(details)})`;
-	const failure = new LocalizationError(message);
+	if (details && typeof details === "object" && Object.keys(details).length > 0) {
+		const summary = summaryOf(code, details);
+		message = summary ? `${message.replace(` [${code}]`, "")} (${code}): ${summary}` : `${message} (${JSON.stringify(details)})`;
+	}
+	const failure = Object.assign(new LocalizationError(message), {
+		...code ? { code } : {},
+		...details ? { details } : {}
+	});
 	return status === void 0 ? failure : Object.assign(failure, { status });
 }
 async function guarded(call, withCode = false) {
@@ -4234,12 +4269,40 @@ function previewMarketDeletion(client, id) {
 async function deleteMarket(client, id, confirmName) {
 	await guarded(() => client.delete(`${MARKETS_PATH}/${encodeURIComponent(id)}?confirm_name=${encodeURIComponent(confirmName)}`), true);
 }
+/** GET /api/company/v2026-10/markets/positions/preview: what putting the markets in this order would change. */
+function previewReorder(client, ids) {
+	const query = ids.map((id) => `market_ids[]=${encodeURIComponent(id)}`).join("&");
+	return guarded(() => client.get(`${MARKETS_PATH}/positions/preview?${query}`), true);
+}
+/** PUT /api/company/v2026-10/markets/positions: sets the full market order; the first market becomes the fallback. Returns the markets. */
+function reorderMarkets(client, ids) {
+	return guarded(() => client.put(`${MARKETS_PATH}/positions`, { market_ids: ids }), true);
+}
+/** GET /api/company/v2026-10/markets/:id/fallback/preview: what making the market the fallback would change. */
+function previewFallback(client, id) {
+	return guarded(() => client.get(`${MARKETS_PATH}/${encodeURIComponent(id)}/fallback/preview`), true);
+}
+/** POST /api/company/v2026-10/markets/:id/fallback: makes the market the fallback. Sends no body. Returns the markets. */
+function setFallback(client, id) {
+	return guarded(() => client.post(`${MARKETS_PATH}/${encodeURIComponent(id)}/fallback`), true);
+}
+/** POST /api/company/v2026-10/markets/:id/currencies: adds a currency to the market. */
+function addMarketCurrency(client, id, code) {
+	return guarded(() => client.post(`${MARKETS_PATH}/${encodeURIComponent(id)}/currencies`, { currency: code }), true);
+}
+/** DELETE /api/company/v2026-10/markets/:id/currencies/:iso: removes an unused currency from the market. */
+async function removeMarketCurrency(client, id, code) {
+	await guarded(() => client.delete(`${MARKETS_PATH}/${encodeURIComponent(id)}/currencies/${encodeURIComponent(code)}`), true);
+}
 //#endregion
 //#region src/markets/commands.ts
 const MAX_CREATE_COUNTRIES = 10;
 const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 async function resolveMarketId(api, ref) {
 	const { markets } = await listMarkets(api);
+	return marketIdIn(markets, ref);
+}
+function marketIdIn(markets, ref) {
 	const byId = markets.find((m) => m.id.toLowerCase() === ref.toLowerCase());
 	if (byId) return byId.id;
 	if (UUID.test(ref)) throw new LocalizationError(`No market with id ${ref}.`);
@@ -4258,7 +4321,7 @@ function currencyCodeOf(raw) {
 	return code;
 }
 /**
-* Register `fluid markets list|add-country|remove-country|rename|create|move|delete` on `parent`.
+* Register `fluid markets list|add-country|remove-country|rename|create|move|delete|reorder|set-fallback|currency add|currency remove` on `parent`.
 *
 * @param parent - the `markets` command group
 * @param ctx - the CLI command context
@@ -4324,6 +4387,66 @@ function registerMarketsCommands(parent, ctx) {
 			deleted: true
 		});
 	}));
+	parent.command("reorder <market...>").description("Set the full market order (ids or names, every market once). The first market becomes the fallback").option("--preview", "Show what the new order would change; write nothing", false).option("--yes", "Confirm without a prompt", false).action((refs, opts) => run(async () => {
+		const api = await client$1(ctx);
+		const { markets } = await listMarkets(api);
+		const ids = refs.map((ref) => marketIdIn(markets, ref));
+		const repeated = refs.filter((_, i) => ids.indexOf(ids[i]) !== i);
+		if (repeated.length > 0) throw new LocalizationError(`Each market can be listed once: ${repeated.join(", ")} repeated.`);
+		const missing = markets.filter((m) => !ids.includes(m.id));
+		if (missing.length > 0) throw new LocalizationError(`The order must list every market. Missing: ${missing.map((m) => m.name).join(", ")}.`);
+		if (opts.preview) {
+			ctx.output(await previewReorder(api, ids));
+			return;
+		}
+		const current = markets.some((m) => m.is_fallback !== void 0) ? markets.find((m) => m.is_fallback) : markets[0];
+		if (!opts.yes && process.stdin.isTTY) ctx.output(await previewReorder(api, ids));
+		if (current && current.id !== ids[0]) await confirmChange(`Reorder markets? ${markets.find((m) => m.id === ids[0]).name} becomes the fallback.`, opts.yes);
+		ctx.output(await reorderMarkets(api, ids));
+	}));
+	parent.command("set-fallback <market>").description("Make a market the fallback. Refused while the fallback prices countries that have no market").option("--preview", "Show what the change would affect; write nothing", false).option("--yes", "Confirm without a prompt", false).action((ref, opts) => run(async () => {
+		const api = await client$1(ctx);
+		const id = await resolveMarketId(api, ref);
+		const preview = await previewFallback(api, id);
+		if (!preview.fallback && !preview.proposed_fallback) {
+			ctx.output({ message: "No fallback is configured." });
+			return;
+		}
+		const blocked = preview.unpriced_countries ?? [];
+		if (blocked.length > 0) {
+			if (opts.preview) ctx.output(preview);
+			throw new LocalizationError(`Cannot change the fallback while these countries are priced through it: ${blocked.join(", ")}. Assign them to a market first.`);
+		}
+		if (opts.preview) {
+			ctx.output(preview);
+			return;
+		}
+		if (!opts.yes && process.stdin.isTTY) ctx.output(preview);
+		await confirmChange(`Make ${ref} the fallback market?`, opts.yes);
+		ctx.output(await setFallback(api, id));
+	}));
+	const currency = parent.command("currency").description("Add or remove a currency on a market");
+	currency.command("add <market> <currency>").description("Add a currency to a market. Adding one it has is a no-op").action((ref, raw) => run(async () => {
+		const code = currencyCodeOf(raw);
+		const api = await client$1(ctx);
+		const written = await addMarketCurrency(api, await resolveMarketId(api, ref), code);
+		ctx.output({
+			...written,
+			note: written.outcome === "added" ? `${code} added.` : `${code} already present.`
+		});
+	}));
+	currency.command("remove <market> <currency>").description("Remove a currency from a market. Refused while it is billed, priced, or the market's last").option("--yes", "Confirm without a prompt", false).action((ref, raw, opts) => run(async () => {
+		const code = currencyCodeOf(raw);
+		const api = await client$1(ctx);
+		const id = await resolveMarketId(api, ref);
+		await confirmChange(`Remove ${code} from market ${ref}?`, opts.yes);
+		await removeMarketCurrency(api, id, code);
+		ctx.output({
+			market_id: id,
+			currency: code,
+			removed: true
+		});
+	}));
 }
 //#endregion
 //#region src/translations/commands.ts