@fluid-app/fluid-cli-localization 0.1.0 → 0.1.2

package/README.md

@@ -70,6 +70,7 @@ and agents use the commands instead.
 | `list`                  | The countries the company sells in.                                                                                                                                                                                     |
 | `plan <iso> --mode <m>` | What `open` would send, with language and agreement status, warehouses and the launch checklist. Read-only.                                                                                                             |
 | `open <iso> --mode <m>` | Adds the country, seeded from the atlas: currency, mode, tax name, tax-inclusive pricing, tax invoices, 3-D Secure, legal settings, address layout and payment method order.                                            |
+| `update <iso>`          | Changes only the settings you name on an open country (`--set key=value`, `--warehouse-id`, `--business-id`, `--entity-registered`, `--settlement-currency`), e.g. its entity. Nested settings merge into the current ones. |
 | `prices <iso>`          | Converts each variant's price from another country (`--from-country`, default `US`) into this country's currency. A dry run unless `--write`.                                                                           |
 | `languages <iso>`       | The market's major languages and whether each is on, with the `fluid translations enable` command for the ones that are off.                                                                                            |
 | `agreements <iso>`      | Atlas agreements matched to the company's by title. `--create` adds the missing ones; `--translate` writes the atlas translations onto ones already on the country.                                                     |
@@ -79,7 +80,8 @@ and agents use the commands instead.
 `--settlement-currency` for what the atlas can't know, and `--set key=value`
 to override a seeded value. It skips Fluid's generic country agreements and
 forms (pass `--legacy-defaults` to keep them), and changes nothing on an open
-country unless you pass `--reseed`.
+country unless you pass `--reseed`, which writes every atlas value over it.
+To change a few fields on an open country, use `update`.
 
 ### Converting prices
 

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":";;;;iBA6JgB,yBAAA,CACd,MAAA,EAAQ,OAAA,EACR,GAAA,EAAK,cAAA;;;iBC/DS,4BAAA,CACd,MAAA,EAAQ,OAAA,EACR,GAAA,EAAK,cAAA;;;;AD2DP;;;;;cE9IM,MAAA,EAAQ,WAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/countries/commands.ts","../src/translations/commands.ts","../src/index.ts"],"mappings":";;;;iBAiKgB,yBAAA,CACd,MAAA,EAAQ,OAAA,EACR,GAAA,EAAK,cAAA;;;iBCnES,4BAAA,CACd,MAAA,EAAQ,OAAA,EACR,GAAA,EAAK,cAAA;;;;AD+DP;;;;;cElJM,MAAA,EAAQ,WAAA"}

package/dist/index.mjs

@@ -1087,7 +1087,7 @@ function companyCountryFromAtlas(atlas, options) {
 	};
 	const tax = atlas.taxSettings;
 	if (tax) {
-		if (typeof tax.taxName === "string" && tax.taxName !== "") body["tax_name"] = tax.taxName;
+		if (tax.taxInclusive === true && typeof tax.taxName === "string" && tax.taxName !== "") body["tax_name"] = tax.taxName;
 		if (typeof tax.taxInclusive === "boolean") body["tax_inclusive_pricing"] = tax.taxInclusive;
 		if (typeof tax.invoiceRequired === "boolean") body["tax_invoice_required"] = tax.invoiceRequired;
 	}
@@ -1120,6 +1120,18 @@ function applyOverrides(body, overrides) {
 function isPlainObject(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+/**
+* The body for changing named fields on an open country, leaving the rest as
+* they are. A nested override (`legal_settings.x=…`) merges into the
+* country's current object, so its other keys are kept.
+*/
+function partialCountryUpdate(current, overrides) {
+	const values = current;
+	if (Object.keys(overrides).length === 0) throw new LocalizationError("Name at least one setting to change, e.g. --set entity_id=12 or --settlement-currency USD.");
+	const base = {};
+	for (const key of Object.keys(overrides)) if (isPlainObject(values[key])) base[key] = values[key];
+	return applyOverrides(base, overrides);
+}
 //#endregion
 //#region src/countries/status.ts
 function same(a, b) {
@@ -1141,10 +1153,15 @@ function settingsChecks(atlas, cc) {
 	});
 	const tax = atlas.taxSettings;
 	if (tax) {
-		checks.push({
+		const inclusive = cc.tax_inclusive_pricing === true;
+		checks.push(inclusive ? {
 			id: "tax_name",
 			ok: same(cc.tax_name, tax.taxName),
 			detail: `Tax name ${cc.tax_name ?? "unset"}; the atlas says ${tax.taxName}.`
+		} : {
+			id: "tax_name",
+			ok: true,
+			detail: `No tax name needed: prices are tax-exclusive, so tax is added at checkout (Fluid stores a tax name only with tax-inclusive pricing).`
 		});
 		checks.push({
 			id: "tax_inclusive_pricing",
@@ -1590,14 +1607,17 @@ async function walkCountry(deps, options = {}) {
 					}
 					ctx.note(`"${value}" isn't a three-letter currency code, such as EUR.`);
 				}
-				const taxName = String(seeded["tax_name"] ?? "");
-				if (!await keep("Tax name", taxName || "(none)")) overrides["tax_name"] = (await ctx.ask({
-					message: "Tax name",
-					kind: "text",
-					current: taxName
-				})).trim() || taxName;
-				const inclusive = seeded["tax_inclusive_pricing"] === true;
-				if (!await keep("Prices include tax", inclusive ? "yes" : "no")) overrides["tax_inclusive_pricing"] = !inclusive;
+				const seededInclusive = seeded["tax_inclusive_pricing"] === true;
+				if (!await keep("Prices include tax", seededInclusive ? "yes" : "no")) overrides["tax_inclusive_pricing"] = !seededInclusive;
+				if ((overrides["tax_inclusive_pricing"] ?? seededInclusive) === true) {
+					const taxName = String(seeded["tax_name"] ?? draft.atlas?.taxSettings?.taxName ?? "");
+					if (!await keep("Tax name", taxName || "(none)")) overrides["tax_name"] = (await ctx.ask({
+						message: "Tax name",
+						kind: "text",
+						current: taxName
+					})).trim() || taxName;
+					else if (taxName && seeded["tax_name"] === void 0) overrides["tax_name"] = taxName;
+				} else delete overrides["tax_name"];
 				const threeDs = seeded["requires_3ds"] === true;
 				if (!await keep("Card payments need 3-D Secure", threeDs ? "yes" : "no")) overrides["requires_3ds"] = !threeDs;
 				const order = seeded["payment_method_priority"] ?? [];
@@ -3410,6 +3430,24 @@ function registerCountriesCommands(parent, ctx) {
 			companyCountry: created
 		});
 	}));
+	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 countryCode = countryCodeOf(iso);
+		const existing = await requireCompanyCountry(api, countryCode);
+		const body = partialCountryUpdate(existing, {
+			...opts.warehouseId ? { warehouse_id: positiveInt(opts.warehouseId, "--warehouse-id") } : {},
+			...opts.businessId ? { tax_business_id: opts.businessId } : {},
+			...opts.entityRegistered ? { entity_legally_registered: true } : {},
+			...opts.settlementCurrency ? { settlement_currency: opts.settlementCurrency.toUpperCase() } : {},
+			...parseSettingAssignments(opts.set)
+		});
+		await confirmChange(`Change ${Object.keys(body).join(", ")} on ${countryCode}?`, opts.yes);
+		ctx.output({
+			country: countryCode,
+			updated: Object.keys(body),
+			companyCountry: await updateCompanyCountry(api, existing.id, body, existing.revision)
+		});
+	}));
 	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 { countryCode, atlas } = await requireAtlas(api, iso);
@@ -3953,7 +3991,7 @@ function registerTranslationsCommands(parent, ctx) {
 */
 const plugin = {
 	name: "@fluid-app/fluid-cli-localization",
-	version: "0.1.0",
+	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("translations", "Add a language and translate what shoppers see: storefront, navigation, theme, agreements, and more", registerTranslationsCommands));