@fluid-app/fluid-cli-localization 0.1.310 → 0.1.311

package/dist/index.d.mts

@@ -4,17 +4,26 @@ import { Command } from "commander";
 //#region src/countries/commands.d.ts
 declare function registerCountriesCommands(parent: Command, ctx: CommandContext): void;
 //#endregion
+//#region src/markets/commands.d.ts
+/**
+ * Register `fluid markets list|add-country|remove-country` on `parent`.
+ *
+ * @param parent - the `markets` command group
+ * @param ctx - the CLI command context
+ */
+declare function registerMarketsCommands(parent: Command, ctx: CommandContext): void;
+//#endregion
 //#region src/translations/commands.d.ts
 declare function registerTranslationsCommands(parent: Command, ctx: CommandContext): void;
 //#endregion
 //#region src/index.d.ts
 /**
- * One plugin, two command groups: `fluid countries` opens a market and
- * `fluid translations` translates what its shoppers see. The country flow
- * hands language and translation work to `fluid translations`, so each step
+ * One plugin, three command groups: `fluid countries` opens a market,
+ * `fluid markets` configures them, and `fluid translations` translates what
+ * its shoppers see. The country flow hands language and translation work to `fluid translations`, so each step
  * has one implementation.
  */
 declare const plugin: FluidPlugin;
 //#endregion
-export { plugin as default, registerCountriesCommands, registerTranslationsCommands };
+export { plugin as default, registerCountriesCommands, registerMarketsCommands, registerTranslationsCommands };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/countries/commands.ts","../src/translations/commands.ts","../src/index.ts"],"mappings":";;;;iBAiMgB,yBAAA,CACd,MAAA,EAAQ,OAAA,EACR,GAAA,EAAK,cAAA;;;iBC/FS,4BAAA,CACd,MAAA,EAAQ,OAAA,EACR,GAAA,EAAK,cAAA;;;;AD2FP;;;;;cElLM,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;;;;iBCpKgB,uBAAA,CACd,MAAA,EAAQ,OAAA,EACR,GAAA,EAAK,cAAA;;;iBCqES,4BAAA,CACd,MAAA,EAAQ,OAAA,EACR,GAAA,EAAK,cAAA;;;AF2FP;;;;;;AAAA,cGhLM,MAAA,EAAQ,WAAA"}

package/dist/index.mjs

@@ -3736,7 +3736,7 @@ function clip(text, max = 200) {
 }
 //#endregion
 //#region src/countries/commands.ts
-async function client$1(ctx) {
+async function client$2(ctx) {
 	return await ctx.getClient();
 }
 /** The company_country attributes `plan` shows and `open` sends. */
@@ -3789,7 +3789,7 @@ async function countryEnrollment(api, countryCode, atlas) {
 }
 function registerCountriesCommands(parent, ctx) {
 	parent.command("atlas <iso>").description("Show Fluid's Country Atlas for a market: modes, tax, legal, address, payments, languages, agreements").option("--agreement <localId>", "Print one atlas agreement's full text in every language instead").action((iso, opts) => run(async () => {
-		const result = await fetchAtlas(await client$1(ctx), iso);
+		const result = await fetchAtlas(await client$2(ctx), iso);
 		if (!result.covered || !result.atlas) {
 			ctx.output({
 				country: result.countryCode,
@@ -3813,11 +3813,11 @@ function registerCountriesCommands(parent, ctx) {
 		});
 	}));
 	parent.command("compliance <iso>").description("Show the compliance view of the atlas: disclosure pages, cookie rule, tax display, unit pricing").action((iso) => run(async () => {
-		const { countryCode, atlas } = await requireAtlas(await client$1(ctx), iso);
+		const { countryCode, atlas } = await requireAtlas(await client$2(ctx), iso);
 		ctx.output(complianceView(countryCode, atlas));
 	}));
 	parent.command("list").description("List the countries this company sells in").action(() => run(async () => {
-		const countries = await listCompanyCountries(await client$1(ctx));
+		const countries = await listCompanyCountries(await client$2(ctx));
 		ctx.output(countries.map((cc) => ({
 			companyCountryId: cc.id,
 			iso: cc.country?.iso ?? null,
@@ -3835,7 +3835,7 @@ function registerCountriesCommands(parent, ctx) {
 		})));
 	}));
 	withOpenOptions(parent.command("plan <iso>").description("Preview a country setup without changing anything: the seeded settings, languages, agreements, and checklist")).action((iso, opts) => run(async () => {
-		const api = await client$1(ctx);
+		const api = await client$2(ctx);
 		const { countryCode, atlas, mode, attributes } = await seededAttributes(api, iso, opts);
 		const [existing, languages, agreements, warehouses] = await Promise.all([
 			findCompanyCountry(api, countryCode),
@@ -3863,7 +3863,7 @@ function registerCountriesCommands(parent, ctx) {
 		});
 	}));
 	withOpenOptions(parent.command("open <iso>").description("Add the country to the company, seeded from the atlas: currency, mode, tax, 3-D Secure, legal, address layout, payment order (changes live config)").option("--legacy-defaults", "Also let Fluid add its generic country agreements and forms", false).option("--reseed", "If the country is already open, write the atlas values over its current settings", false).option("--yes", "Confirm without a prompt", false)).action((iso, opts) => run(async () => {
-		const api = await client$1(ctx);
+		const api = await client$2(ctx);
 		const { countryCode, attributes } = await seededAttributes(api, iso, opts);
 		const existing = await findCompanyCountry(api, countryCode);
 		if (existing && !opts.reseed) {
@@ -3894,7 +3894,7 @@ function registerCountriesCommands(parent, ctx) {
 		});
 	}));
 	parent.command("update <iso>").description("Change named settings on an open country and leave the rest as they are, e.g. its entity or settlement currency (changes live config)").option("--warehouse-id <id>", "The warehouse that fulfills orders for the country").option("--business-id <id>", "The local tax or business registration number").option("--entity-registered", "The company has a legally registered local entity").option("--settlement-currency <code>", "Settle in this currency, e.g. USD").option("--set <key=value>", "Set a company country field, e.g. entity_id=12 or legal_settings.cooling_off_period_days=30 (repeatable)", collect, []).option("--yes", "Confirm without a prompt", false).action((iso, opts) => run(async () => {
-		const api = await client$1(ctx);
+		const api = await client$2(ctx);
 		const countryCode = countryCodeOf(iso);
 		const existing = await requireCompanyCountry(api, countryCode);
 		const body = partialCountryUpdate(existing, {
@@ -3912,7 +3912,7 @@ function registerCountriesCommands(parent, ctx) {
 		});
 	}));
 	parent.command("languages <iso>").description("Compare the market's major languages with the company's; `fluid translations enable` turns the missing ones on").action((iso) => run(async () => {
-		const api = await client$1(ctx);
+		const api = await client$2(ctx);
 		const { countryCode, atlas } = await requireAtlas(api, iso);
 		const states = languageStates(atlas, await listLanguages(api));
 		const off = states.filter((s) => !s.enabled && s.languageId !== null);
@@ -3924,7 +3924,7 @@ function registerCountriesCommands(parent, ctx) {
 		});
 	}));
 	parent.command("agreements <iso>").description("Match the atlas agreements to the company's; --create adds the missing ones to the country in every atlas language, --translate rewrites the atlas translations onto ones already on it (changes live config)").option("--create", "Create each missing atlas agreement on the country", false).option("--translate", "Write the atlas translations onto the agreements already on the country, e.g. after enabling a language", false).option("--only <localId>", "With --create or --translate, just this atlas agreement, e.g. agreement_2 (repeatable)", collect, []).option("--yes", "Confirm without a prompt", false).action((iso, opts) => run(async () => {
-		const api = await client$1(ctx);
+		const api = await client$2(ctx);
 		const { countryCode, atlas } = await requireAtlas(api, iso);
 		const cc = await requireCompanyCountry(api, countryCode);
 		const states = agreementStates(atlas, await listAgreements(api), cc.id);
@@ -3997,7 +3997,7 @@ function registerCountriesCommands(parent, ctx) {
 	}));
 	parent.command("forms <iso>").description("Compare the atlas enrollment fields with the country's Post Purchase forms; --create sets up its enrollment form, as a draft unless --activate (changes live config)").option("--create", "Create the country's enrollment form, or add the missing atlas fields to it", false).option("--form <id>", "With --create, add to this Post Purchase form for the country instead").option("--activate", "With --create, publish the form so enrollment asks for its fields now", false).option("--skip-sensitive", "With --create, leave out fields stored as sensitive, which need the forms manage-sensitive permission", false).option("--yes", "Confirm without a prompt", false).action((iso, opts) => run(async () => {
 		if (!opts.create && (opts.form || opts.activate || opts.skipSensitive)) throw new LocalizationError("--form, --activate and --skip-sensitive go with --create.");
-		const api = await client$1(ctx);
+		const api = await client$2(ctx);
 		const { countryCode, atlas } = await requireAtlas(api, iso);
 		const country = await catalogCountry(api, countryCode);
 		const options = {
@@ -4036,7 +4036,7 @@ function registerCountriesCommands(parent, ctx) {
 		});
 	}));
 	parent.command("prices <iso>").description("Convert every variant's price from another country into this one's currency at an exchange rate. A dry run unless --write (changes live prices)").option("--from-country <iso>", "The country whose prices are converted", "US").option("--rate <rate>", "Units of the new currency per unit of the source currency, e.g. 0.92; --write needs it").option("--fields <list>", `Price fields to convert, comma-separated, from ${PRICE_FIELDS.join(", ")}`, DEFAULT_PRICE_FIELDS.join(",")).option("--status <status>", "Product status to include (repeatable)", collect, []).option("--overwrite", "Also replace prices the country already has", false).option("--activate", "Put each converted variant on sale in the country", false).option("--sample <n>", "How many before→after examples to print", "10").option("--write", "Save the converted prices; without it nothing is written", false).option("--yes", "Confirm --write without a prompt", false).action((iso, opts) => run(async () => {
-		const api = await client$1(ctx);
+		const api = await client$2(ctx);
 		const targetIso = countryCodeOf(iso);
 		const sourceIso = countryCodeOf(opts.fromCountry);
 		if (targetIso === sourceIso) throw new LocalizationError("--from-country is the country being priced.");
@@ -4128,7 +4128,7 @@ function registerCountriesCommands(parent, ctx) {
 	}));
 	parent.command("walk [iso]").description("Open a country by answering questions: the atlas, mode, languages, agreements and defaults, then prices and translations (changes live config)").action((iso) => run(async () => {
 		assertInteractive("`plan`, `open`, `prices`, `agreements` and `fluid translations enable`");
-		const api = await client$1(ctx);
+		const api = await client$2(ctx);
 		const prompter = terminalPrompter();
 		const result = await walkCountry({
 			api,
@@ -4142,7 +4142,7 @@ function registerCountriesCommands(parent, ctx) {
 		if (result.failures.length > 0) process.exitCode = 1;
 	}));
 	parent.command("status <iso>").description("Check a country's setup against the atlas, including whether your active products have prices in it, and list what's left, ending with the launch checklist").action((iso) => run(async () => {
-		const api = await client$1(ctx);
+		const api = await client$2(ctx);
 		const { countryCode, atlas } = await requireAtlas(api, iso);
 		const cc = await findCompanyCountry(api, countryCode);
 		const [languages, agreements] = cc ? await Promise.all([listLanguages(api), listAgreements(api)]) : [[], []];
@@ -4159,6 +4159,88 @@ function registerCountriesCommands(parent, ctx) {
 	}));
 }
 //#endregion
+//#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.";
+/**
+* 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.
+*/
+function marketsFailure(err) {
+	const status = statusOf(err);
+	const body = err?.body;
+	const code = typeof body?.["error"] === "string" ? body["error"] : void 0;
+	let message;
+	if (code === "market_config_disabled") message = MARKET_CONFIG_DISABLED_MESSAGE;
+	else if (typeof body?.["message"] === "string") {
+		message = body["message"];
+		if (code === "retry_later" && !/try again/i.test(message)) message = `${message} Try again.`;
+	} 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);
+	return status === void 0 ? failure : Object.assign(failure, { status });
+}
+async function guarded(call) {
+	try {
+		return await call();
+	} catch (err) {
+		throw marketsFailure(err);
+	}
+}
+/** GET /api/company/v2026-10/markets: markets, their countries, and active countries without a market. */
+function listMarkets(client) {
+	return guarded(() => client.get(MARKETS_PATH));
+}
+/** POST /api/company/v2026-10/markets/countries: gives a country its own market, creating the company country when it is new. */
+function addMarketCountry(client, iso, currency) {
+	return guarded(() => client.post(`${MARKETS_PATH}/countries`, {
+		country_iso: iso,
+		...currency ? { currency } : {}
+	}));
+}
+/** DELETE /api/company/v2026-10/markets/countries/:iso: removes the company country, and its market when it was the market's last country and no other country falls back to it. */
+async function removeMarketCountry(client, iso) {
+	await guarded(() => client.delete(`${MARKETS_PATH}/countries/${iso}`));
+}
+//#endregion
+//#region src/markets/commands.ts
+async function client$1(ctx) {
+	return await ctx.getClient();
+}
+function currencyCodeOf(raw) {
+	const code = raw.trim().toUpperCase();
+	if (!/^[A-Z]{3}$/.test(code)) throw new LocalizationError(`"${raw}" isn't a three-letter currency code, e.g. EUR or JPY.`);
+	return code;
+}
+/**
+* Register `fluid markets list|add-country|remove-country` on `parent`.
+*
+* @param parent - the `markets` command group
+* @param ctx - the CLI command context
+*/
+function registerMarketsCommands(parent, ctx) {
+	parent.command("list").description("List the company's markets with their countries and currencies, and active countries that have no market").option("--json", "Print JSON (the default output)", false).action(() => run(async () => {
+		ctx.output(await listMarkets(await client$1(ctx)));
+	}));
+	parent.command("add-country <iso>").description("Give a country its own market. A new country needs --currency; an existing unassigned one is provisioned").option("--currency <code>", "Currency for a new country, e.g. EUR. For an existing country it must match its currency").action((iso, opts) => run(async () => {
+		const code = countryCodeOf(iso);
+		const currency = opts.currency ? currencyCodeOf(opts.currency) : void 0;
+		ctx.output(await addMarketCountry(await client$1(ctx), code, currency));
+	}));
+	parent.command("remove-country <iso>").description("Remove a country from the company, and its market when it was the market's last country and no other country falls back to it").option("--yes", "Confirm without a prompt", false).action((iso, opts) => run(async () => {
+		const code = countryCodeOf(iso);
+		await confirmChange(`Remove ${code} and its market settings from this company?`, opts.yes);
+		await removeMarketCountry(await client$1(ctx), code);
+		ctx.output({
+			country: code,
+			removed: true
+		});
+	}));
+}
+//#endregion
 //#region src/translations/commands.ts
 async function client(ctx) {
 	return await ctx.getClient();
@@ -4492,9 +4574,9 @@ function registerTranslationsCommands(parent, ctx) {
 //#endregion
 //#region src/index.ts
 /**
-* One plugin, two command groups: `fluid countries` opens a market and
-* `fluid translations` translates what its shoppers see. The country flow
-* hands language and translation work to `fluid translations`, so each step
+* One plugin, three command groups: `fluid countries` opens a market,
+* `fluid markets` configures them, and `fluid translations` translates what
+* its shoppers see. The country flow hands language and translation work to `fluid translations`, so each step
 * has one implementation.
 */
 const plugin = {
@@ -4502,10 +4584,11 @@ const plugin = {
 	version: "0.1.1",
 	register(ctx) {
 		ctx.program.addCommand(createDomainCommand("countries", "Open a country from Fluid's Country Atlas: settings, prices in its currency, agreements, and a status check", registerCountriesCommands));
+		ctx.program.addCommand(createDomainCommand("markets", "List the company's markets and add or remove a country with its own market", registerMarketsCommands));
 		ctx.program.addCommand(createDomainCommand("translations", "Add a language and translate what shoppers see: storefront, navigation, theme, agreements, and more", registerTranslationsCommands));
 	}
 };
 //#endregion
-export { plugin as default, registerCountriesCommands, registerTranslationsCommands };
+export { plugin as default, registerCountriesCommands, registerMarketsCommands, registerTranslationsCommands };
 
 //# sourceMappingURL=index.mjs.map