@saastemly/voidcommerce 0.6.0 → 0.7.0

package/dist/catalog.js

@@ -14,7 +14,7 @@ import {
   SIGN_IN,
   TAX,
   UI
-} from "./index-844b3qn9.js";
+} from "./index-mnb7fz2t.js";
 import"./index-0v6na3yp.js";
 export {
   UI,

package/dist/cli.js

@@ -21,7 +21,7 @@ import {
   runVoid,
   version,
   voidAppsIn
-} from "./index-f1wds190.js";
+} from "./index-85m0qkmg.js";
 import {
   PRIVATE_KEY_VAR,
   SECRETS_FILE,
@@ -42,7 +42,7 @@ import {
   setVariable,
   variableNames,
   verifyCloudflareToken
-} from "./index-2qt2yh3z.js";
+} from "./index-6w8rwtsh.js";
 import {
   LAYOUTS,
   oneOrigin,
@@ -50,10 +50,10 @@ import {
   validate,
   writeManifest,
   zoneOf
-} from "./index-xx5p4b8d.js";
+} from "./index-tjy6yygc.js";
 import {
   GROUPS
-} from "./index-844b3qn9.js";
+} from "./index-mnb7fz2t.js";
 import {
   __require
 } from "./index-0v6na3yp.js";

package/dist/generate/auth.d.ts

@@ -1,2 +1,15 @@
 import { type Manifest } from "../manifest";
+/**
+ * Carriers with a provider behind them, and whether each needs `lib/shipping.ts`.
+ *
+ * Exported because `generate/index.ts` has to know which shops get that file,
+ * and a second hand-maintained list of carrier ids WILL drift from this one —
+ * it already did: adding Royal Mail here left the file ungenerated, so the
+ * generated `auth.ts` imported a price table that did not exist.
+ *
+ * The token needs nothing: no origin, no tariff. Everything else needs one or
+ * the other, so the rule is simply "any carrier but the token".
+ */
+export declare const WIRED_CARRIERS: readonly ["royal-mail", "dhl-express", "shippo", "easypost", "ups", "fedex", "nft"];
+export declare const needsShippingConfig: (id: string) => boolean;
 export declare function renderAuthTs(manifest: Manifest): string;

package/dist/{index-2qt2yh3z.js → index-6w8rwtsh.js}

@@ -3,7 +3,7 @@ import {
   hasFrontend,
   isApex,
   zone
-} from "./index-xx5p4b8d.js";
+} from "./index-tjy6yygc.js";
 import {
   __require,
   __toESM
@@ -368,7 +368,7 @@ async function decryptSecrets(project) {
   }
   const expected = committedPublicKey(root);
   if (expected) {
-    const { publicKeyFor } = await import("./keys-qwvt324e.js");
+    const { publicKeyFor } = await import("./keys-92tcdjrc.js");
     const derived = await publicKeyFor(privateKey);
     if (derived && derived.toLowerCase() !== expected.toLowerCase()) {
       return {

package/dist/{index-f1wds190.js → index-85m0qkmg.js}

@@ -9,7 +9,7 @@ import {
   renderEnvLocal,
   renderEnvProduction,
   renderEnvTs
-} from "./index-2qt2yh3z.js";
+} from "./index-6w8rwtsh.js";
 import {
   MANIFEST_FILE,
   has,
@@ -22,10 +22,10 @@ import {
   workerHosts,
   writeManifest,
   zone
-} from "./index-xx5p4b8d.js";
+} from "./index-tjy6yygc.js";
 import {
   CHOICES
-} from "./index-844b3qn9.js";
+} from "./index-mnb7fz2t.js";
 import {
   __require
 } from "./index-0v6na3yp.js";
@@ -48,10 +48,17 @@ var VAT = {
   PL: { rate: 2300, name: "VAT" }
 };
 var social = (manifest, id, envPrefix) => has(manifest, id) ? `			${id}: { clientId: must(env, "${envPrefix}_CLIENT_ID"), clientSecret: must(env, "${envPrefix}_CLIENT_SECRET") },` : null;
+var WIRED_CARRIERS = ["royal-mail", "dhl-express", "shippo", "easypost", "ups", "fedex", "nft"];
+var needsShippingConfig = (id) => WIRED_CARRIERS.includes(id) && id !== "nft";
 function renderAuthTs(manifest) {
   const { shop } = manifest;
   const lines = [];
   const CARRIER_CALLS = {
+    "royal-mail": {
+      label: "Royal Mail",
+      call: `royalMailProvider({ apiKey: must(env, "CLICK_DROP_AUTH_KEY"), services: royalMailServices, currency: "${shop.currency}", carrierName: "Royal Mail" })`,
+      import: `import { royalMailProvider } from "@saastemly/better-commerce/providers/royal-mail";`
+    },
     "dhl-express": {
       label: "DHL Express",
       call: `dhlExpressProvider({ apiKey: must(env, "DHL_API_KEY"), apiSecret: must(env, "DHL_API_SECRET"), accountNumber: must(env, "DHL_ACCOUNT_NUMBER"), from: shipFrom })`,
@@ -86,8 +93,12 @@ import { mintProvider, destinationFor } from "./lib/mint.ts";`
   };
   const carriers = Object.keys(CARRIER_CALLS).filter((id) => has(manifest, id));
   const carrierImports = carriers.map((id) => CARRIER_CALLS[id].import);
-  if (carriers.some((id) => id !== "nft"))
-    carrierImports.push(`import { shipFrom } from "./lib/shipping.ts";`);
+  const shipping = [
+    ...carriers.some((id) => id !== "nft" && id !== "royal-mail") ? ["shipFrom"] : [],
+    ...carriers.includes("royal-mail") ? ["royalMailServices"] : []
+  ];
+  if (shipping.length > 0)
+    carrierImports.push(`import { ${shipping.join(", ")} } from "./lib/shipping.ts";`);
   const wantsNft = has(manifest, "nft");
   const carrierFulfillment = carriers.length ? `, deliveryFulfillment([${carriers.map((id) => CARRIER_CALLS[id].call).join(", ")}])` : "";
   const nftDefault = carriers.length ? `, defaultProvider: "delivery:${carriers.join("+")}"` : "";
@@ -1333,7 +1344,7 @@ import color from "picocolors";
 // package.json
 var package_default = {
   name: "@saastemly/voidcommerce",
-  version: "0.6.0",
+  version: "0.7.0",
   description: "Void, with a shop in it. `vc init` walks you through Better Auth, betterCommerce and every plugin; everything else passes through to `void`.",
   type: "module",
   license: "MIT",
@@ -2181,13 +2192,18 @@ export async function destinationFor(orderId: string): Promise<string | null> {
 `;
 }
 function renderShippingTs(manifest) {
-  return `import type { DeliveryAddress } from "@saastemly/better-commerce/providers/delivery";
-
+  const royalMail = has(manifest, "royal-mail");
+  const origin = ["dhl-express", "shippo", "easypost", "ups", "fedex"].some((id) => has(manifest, id));
+  const imports = [
+    ...origin ? [`import type { DeliveryAddress } from "@saastemly/better-commerce/providers/delivery";`] : [],
+    ...royalMail ? [`import type { RoyalMailService } from "@saastemly/better-commerce/providers/royal-mail";`] : []
+  ];
+  const originBlock = `
 /**
  * The address every parcel is quoted and shipped FROM.
  *
- * TODO VERIFY: this is a placeholder. A carrier quotes against it, and DHL
- * refuses a shipment whose origin has no \`name\` and \`phone\`.
+ * TODO VERIFY: this is a placeholder. A carrier quotes against it, and most
+ * refuse a shipment whose origin has no \`name\` and \`phone\`.
  */
 export const shipFrom: DeliveryAddress = {
 	name: "${manifest.shop.name}",
@@ -2198,6 +2214,9 @@ export const shipFrom: DeliveryAddress = {
 	phone: "TODO VERIFY: +44…",
 };
 `;
+  return `${imports.join(`
+`)}
+${origin ? originBlock : ""}${royalMail ? ROYAL_MAIL_SERVICES() : ""}`;
 }
 function renderErpTs() {
   return `import { businessCentralProvider } from "@saastemly/better-commerce/providers/business-central";
@@ -2226,6 +2245,44 @@ export const erpFulfillment = (currency: string): FulfillmentProvider =>
 	}).fulfillment();
 `;
 }
+var ROYAL_MAIL_SERVICES = () => `
+/**
+ * What this shop charges for Royal Mail, by total parcel weight.
+ *
+ * TODO VERIFY: every \`amount\` below is a placeholder in pence. Replace them
+ * with your own OBA rate card — Click & Drop → Settings → Shipping services
+ * lists exactly which services your account has, and the codes here must be
+ * among them. Service codes are account-specific: the published list is from
+ * 2021 and Royal Mail warn that "available services are unique to your OBA
+ * account and individual service agreements".
+ *
+ * The band whose \`maxGrams\` first covers the parcel wins, so order does not
+ * matter. A parcel heavier than every band gets no rate at all rather than a
+ * wrong one, and Click & Drop refuses anything over 30 kg.
+ */
+export const royalMailServices: RoyalMailService[] = [
+	{
+		code: "TPN24",
+		name: "Tracked 24",
+		estimatedDays: 1,
+		bands: [
+			{ maxGrams: 1000, amount: 0 /* TODO VERIFY */ },
+			{ maxGrams: 2000, amount: 0 /* TODO VERIFY */ },
+			{ maxGrams: 5000, amount: 0 /* TODO VERIFY */ },
+		],
+	},
+	{
+		code: "TPS48",
+		name: "Tracked 48",
+		estimatedDays: 2,
+		bands: [
+			{ maxGrams: 1000, amount: 0 /* TODO VERIFY */ },
+			{ maxGrams: 2000, amount: 0 /* TODO VERIFY */ },
+			{ maxGrams: 5000, amount: 0 /* TODO VERIFY */ },
+		],
+	},
+];
+`;
 
 // src/generate/index.ts
 async function exists(path) {
@@ -2314,7 +2371,7 @@ async function generateApi(root, dir, manifest, result, opts) {
   if (has(manifest, "nft")) {
     await put(root, at("lib/mint.ts"), renderMintTs(), result, own);
   }
-  if (["dhl-express", "shippo", "easypost", "ups", "fedex"].some((id) => has(manifest, id))) {
+  if (WIRED_CARRIERS.some((id) => needsShippingConfig(id) && has(manifest, id))) {
     await put(root, at("lib/shipping.ts"), renderShippingTs(manifest), result, own);
   }
   if (has(manifest, "business-central")) {

package/dist/{index-844b3qn9.js → index-mnb7fz2t.js}

@@ -446,7 +446,18 @@ var CARRIERS = {
     { id: "fedex", label: "FedEx", hint: "your own FedEx account, for negotiated rates an aggregator cannot see", env: [{ key: "FEDEX_CLIENT_ID", breaks: "FedEx rates are not quoted" }, { key: "FEDEX_CLIENT_SECRET", breaks: "the same" }, { key: "FEDEX_ACCOUNT_NUMBER", breaks: "FedEx has no account to bill the transport to" }] },
     { id: "dhl-express", label: "DHL Express", hint: "international express, and the one worth having for a shop that posts abroad", env: [{ key: "DHL_API_KEY", breaks: "DHL rates are not quoted" }, { key: "DHL_API_SECRET", breaks: "the same" }, { key: "DHL_ACCOUNT_NUMBER", breaks: "DHL has no account to bill the transport to" }] },
     { id: "usps", label: "USPS", hint: "US domestic post — the cheapest way to ship a small parcel inside the US", env: [{ key: "USPS_CLIENT_ID", breaks: "USPS rates are not quoted" }, { key: "USPS_CLIENT_SECRET", breaks: "the same" }] },
-    { id: "royal-mail", label: "Royal Mail", hint: "UK post, for a shop whose customers are mostly in Britain", env: [{ key: "ROYAL_MAIL_CLIENT_ID", breaks: "Royal Mail rates are not quoted" }] },
+    {
+      id: "royal-mail",
+      label: "Royal Mail (Click & Drop)",
+      hint: "UK post. Needs an OBA business account — Click & Drop generates labels through the API only for those. Prices come from your own tariff table, because no Royal Mail API quotes rates",
+      env: [
+        {
+          key: "CLICK_DROP_AUTH_KEY",
+          breaks: "no label and no tracking number: orders are created in Click & Drop but never despatched",
+          where: "Click & Drop → Settings → Integrations → Click & Drop API"
+        }
+      ]
+    },
     { id: "aramex", label: "Aramex", hint: "the carrier to reach the Gulf and wider Middle East reliably", env: [{ key: "ARAMEX_API_KEY", breaks: "Aramex rates are not quoted" }] },
     { id: "doordash-drive", label: "DoorDash Drive", hint: "same-day local delivery", env: [{ key: "DOORDASH_DEVELOPER_ID", breaks: "DoorDash is not offered" }] },
     { id: "stuart", label: "Stuart", hint: "same-day courier, Europe", env: [{ key: "STUART_CLIENT_ID", breaks: "Stuart is not offered" }] },

package/dist/{index-xx5p4b8d.js → index-tjy6yygc.js}

@@ -1,7 +1,7 @@
 import {
   CHOICES,
   GROUPS
-} from "./index-844b3qn9.js";
+} from "./index-mnb7fz2t.js";
 
 // src/manifest.ts
 import { readFile, writeFile } from "node:fs/promises";

package/dist/index.js

@@ -51,7 +51,7 @@ import {
   routeProblem,
   strictDependencies,
   upsertJsonc
-} from "./index-f1wds190.js";
+} from "./index-85m0qkmg.js";
 import {
   allEnvKeys,
   envSummary,
@@ -59,7 +59,7 @@ import {
   renderEnvLocal,
   renderEnvProduction,
   renderEnvTs
-} from "./index-2qt2yh3z.js";
+} from "./index-6w8rwtsh.js";
 import {
   LAYOUTS,
   MANIFEST_FILE,
@@ -80,7 +80,7 @@ import {
   writeManifest,
   zone,
   zoneOf
-} from "./index-xx5p4b8d.js";
+} from "./index-tjy6yygc.js";
 import {
   AUTH_PLUGINS,
   CARRIERS,
@@ -97,7 +97,7 @@ import {
   SIGN_IN,
   TAX,
   UI
-} from "./index-844b3qn9.js";
+} from "./index-mnb7fz2t.js";
 import"./index-0v6na3yp.js";
 export {
   zoneOf,

package/dist/{keys-qwvt324e.js → keys-92tcdjrc.js}

@@ -5,9 +5,9 @@ import {
   keysCommand,
   provisionKey,
   publicKeyFor
-} from "./index-2qt2yh3z.js";
-import"./index-xx5p4b8d.js";
-import"./index-844b3qn9.js";
+} from "./index-6w8rwtsh.js";
+import"./index-tjy6yygc.js";
+import"./index-mnb7fz2t.js";
 import"./index-0v6na3yp.js";
 export {
   publicKeyFor,

package/dist/manifest.js

@@ -18,8 +18,8 @@ import {
   writeManifest,
   zone,
   zoneOf
-} from "./index-xx5p4b8d.js";
-import"./index-844b3qn9.js";
+} from "./index-tjy6yygc.js";
+import"./index-mnb7fz2t.js";
 import"./index-0v6na3yp.js";
 export {
   zoneOf,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saastemly/voidcommerce",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Void, with a shop in it. `vc init` walks you through Better Auth, betterCommerce and every plugin; everything else passes through to `void`.",
   "type": "module",
   "license": "MIT",

package/src/catalog.ts

@@ -519,7 +519,18 @@ export const CARRIERS: Group = {
 		{ id: "fedex", label: "FedEx", hint: "your own FedEx account, for negotiated rates an aggregator cannot see", env: [{ key: "FEDEX_CLIENT_ID", breaks: "FedEx rates are not quoted" }, { key: "FEDEX_CLIENT_SECRET", breaks: "the same" }, { key: "FEDEX_ACCOUNT_NUMBER", breaks: "FedEx has no account to bill the transport to" }] },
 		{ id: "dhl-express", label: "DHL Express", hint: "international express, and the one worth having for a shop that posts abroad", env: [{ key: "DHL_API_KEY", breaks: "DHL rates are not quoted" }, { key: "DHL_API_SECRET", breaks: "the same" }, { key: "DHL_ACCOUNT_NUMBER", breaks: "DHL has no account to bill the transport to" }] },
 		{ id: "usps", label: "USPS", hint: "US domestic post — the cheapest way to ship a small parcel inside the US", env: [{ key: "USPS_CLIENT_ID", breaks: "USPS rates are not quoted" }, { key: "USPS_CLIENT_SECRET", breaks: "the same" }] },
-		{ id: "royal-mail", label: "Royal Mail", hint: "UK post, for a shop whose customers are mostly in Britain", env: [{ key: "ROYAL_MAIL_CLIENT_ID", breaks: "Royal Mail rates are not quoted" }] },
+		{
+			id: "royal-mail",
+			label: "Royal Mail (Click & Drop)",
+			hint: "UK post. Needs an OBA business account — Click & Drop generates labels through the API only for those. Prices come from your own tariff table, because no Royal Mail API quotes rates",
+			env: [
+				{
+					key: "CLICK_DROP_AUTH_KEY",
+					breaks: "no label and no tracking number: orders are created in Click & Drop but never despatched",
+					where: "Click & Drop → Settings → Integrations → Click & Drop API",
+				},
+			],
+		},
 		{ id: "aramex", label: "Aramex", hint: "the carrier to reach the Gulf and wider Middle East reliably", env: [{ key: "ARAMEX_API_KEY", breaks: "Aramex rates are not quoted" }] },
 		{ id: "doordash-drive", label: "DoorDash Drive", hint: "same-day local delivery", env: [{ key: "DOORDASH_DEVELOPER_ID", breaks: "DoorDash is not offered" }] },
 		{ id: "stuart", label: "Stuart", hint: "same-day courier, Europe", env: [{ key: "STUART_CLIENT_ID", breaks: "Stuart is not offered" }] },

package/src/generate/auth.ts

@@ -49,6 +49,20 @@ const social = (manifest: Manifest, id: string, envPrefix: string) =>
 		? `			${id}: { clientId: must(env, "${envPrefix}_CLIENT_ID"), clientSecret: must(env, "${envPrefix}_CLIENT_SECRET") },`
 		: null;
 
+/**
+ * Carriers with a provider behind them, and whether each needs `lib/shipping.ts`.
+ *
+ * Exported because `generate/index.ts` has to know which shops get that file,
+ * and a second hand-maintained list of carrier ids WILL drift from this one —
+ * it already did: adding Royal Mail here left the file ungenerated, so the
+ * generated `auth.ts` imported a price table that did not exist.
+ *
+ * The token needs nothing: no origin, no tariff. Everything else needs one or
+ * the other, so the rule is simply "any carrier but the token".
+ */
+export const WIRED_CARRIERS = ["royal-mail", "dhl-express", "shippo", "easypost", "ups", "fedex", "nft"] as const;
+export const needsShippingConfig = (id: string): boolean => WIRED_CARRIERS.includes(id as never) && id !== "nft";
+
 export function renderAuthTs(manifest: Manifest): string {
 	const { shop } = manifest;
 	const lines: Line[] = [];
@@ -68,6 +82,14 @@ export function renderAuthTs(manifest: Manifest): string {
 	const CARRIER_CALLS: Record<string, { call: string; label: string; import: string }> = {
 		// Every real carrier needs the ORIGIN it ships from, which is shop data
 		// rather than a credential — so it lives in an owned lib/shipping.ts.
+		"royal-mail": {
+			label: "Royal Mail",
+			// No `from`: Click & Drop posts from the account's registered
+			// address, so an origin here would be ignored. `services` is the
+			// price table in lib/shipping.ts, because nothing quotes Royal Mail.
+			call: `royalMailProvider({ apiKey: must(env, "CLICK_DROP_AUTH_KEY"), services: royalMailServices, currency: "${shop.currency}", carrierName: "Royal Mail" })`,
+			import: `import { royalMailProvider } from "@saastemly/better-commerce/providers/royal-mail";`,
+		},
 		"dhl-express": {
 			label: "DHL Express",
 			call: `dhlExpressProvider({ apiKey: must(env, "DHL_API_KEY"), apiSecret: must(env, "DHL_API_SECRET"), accountNumber: must(env, "DHL_ACCOUNT_NUMBER"), from: shipFrom })`,
@@ -101,8 +123,18 @@ export function renderAuthTs(manifest: Manifest): string {
 	};
 	const carriers = Object.keys(CARRIER_CALLS).filter((id) => has(manifest, id));
 	const carrierImports = carriers.map((id) => CARRIER_CALLS[id]!.import);
-	// The token needs no origin; every other carrier does.
-	if (carriers.some((id) => id !== "nft")) carrierImports.push(`import { shipFrom } from "./lib/shipping.ts";`);
+	// One import from lib/shipping.ts, naming only what is actually used —
+	// an unused binding is a type error in a shop with `noUnusedLocals`.
+	//
+	// The token needs no origin. Royal Mail needs no origin either: Click &
+	// Drop posts from the address registered on the account, so a `from` here
+	// would be silently ignored. It needs the price table instead, because
+	// nothing quotes Royal Mail.
+	const shipping = [
+		...(carriers.some((id) => id !== "nft" && id !== "royal-mail") ? ["shipFrom"] : []),
+		...(carriers.includes("royal-mail") ? ["royalMailServices"] : []),
+	];
+	if (shipping.length > 0) carrierImports.push(`import { ${shipping.join(", ")} } from "./lib/shipping.ts";`);
 	const wantsNft = has(manifest, "nft");
 	// One bridge for every carrier: which ships is decided by whose rate the
 	// buyer paid for, so a token order mints and a parcel order posts.

package/src/generate/index.ts

@@ -3,7 +3,7 @@ import { existsSync, lstatSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { CHOICES } from "../catalog";
 import { MANIFEST_FILE, type Manifest, has, isSingleApp, oneOrigin, packagesOf, specifier, workerHosts, writeManifest, zone } from "../manifest";
-import { renderAuthTs } from "./auth";
+import { renderAuthTs, WIRED_CARRIERS, needsShippingConfig } from "./auth";
 import {
 	envSummary,
 	renderEnvExample,
@@ -189,8 +189,10 @@ async function generateApi(root: string, dir: string, manifest: Manifest, result
 	if (has(manifest, "nft")) {
 		await put(root, at("lib/mint.ts"), renderMintTs(), result, own);
 	}
-	// Any carrier but the token quotes against an origin, which is shop data.
-	if (["dhl-express", "shippo", "easypost", "ups", "fedex"].some((id) => has(manifest, id))) {
+	// Any carrier but the token needs shop data of its own — an origin to quote
+	// against, or a price table. The list lives with the carriers themselves so
+	// it cannot drift from them.
+	if (WIRED_CARRIERS.some((id) => needsShippingConfig(id) && has(manifest, id))) {
 		await put(root, at("lib/shipping.ts"), renderShippingTs(manifest), result, own);
 	}
 	if (has(manifest, "business-central")) {

package/src/generate/support.ts

@@ -274,13 +274,22 @@ export async function destinationFor(orderId: string): Promise<string | null> {
  * deploy, so both are marked rather than left blank.
  */
 export function renderShippingTs(manifest: Manifest): string {
-	return `import type { DeliveryAddress } from "@saastemly/better-commerce/providers/delivery";
+	const royalMail = has(manifest, "royal-mail");
+	// Royal Mail posts from the address registered on the Click & Drop account,
+	// so an origin here would be ignored. Only carriers that QUOTE need one.
+	const origin = ["dhl-express", "shippo", "easypost", "ups", "fedex"].some((id) => has(manifest, id));
 
+	const imports = [
+		...(origin ? [`import type { DeliveryAddress } from "@saastemly/better-commerce/providers/delivery";`] : []),
+		...(royalMail ? [`import type { RoyalMailService } from "@saastemly/better-commerce/providers/royal-mail";`] : []),
+	];
+
+	const originBlock = `
 /**
  * The address every parcel is quoted and shipped FROM.
  *
- * TODO VERIFY: this is a placeholder. A carrier quotes against it, and DHL
- * refuses a shipment whose origin has no \`name\` and \`phone\`.
+ * TODO VERIFY: this is a placeholder. A carrier quotes against it, and most
+ * refuse a shipment whose origin has no \`name\` and \`phone\`.
  */
 export const shipFrom: DeliveryAddress = {
 	name: "${manifest.shop.name}",
@@ -291,6 +300,8 @@ export const shipFrom: DeliveryAddress = {
 	phone: "TODO VERIFY: +44…",
 };
 `;
+
+	return `${imports.join("\n")}\n${origin ? originBlock : ""}${royalMail ? ROYAL_MAIL_SERVICES() : ""}`;
 }
 
 export function renderErpTs(): string {
@@ -320,3 +331,56 @@ export const erpFulfillment = (currency: string): FulfillmentProvider =>
 	}).fulfillment();
 `;
 }
+
+
+/**
+ * Royal Mail's price table — YOUR prices, because nothing will quote them.
+ *
+ * This is the one carrier here that cannot be asked what postage costs. No
+ * Royal Mail API quotes rates: not Click & Drop, not Shipping V3, not
+ * anything on the developer portal. Click & Drop imports orders and prints
+ * labels; postage is charged afterwards at whatever your OBA agreement says.
+ *
+ * So the shop quotes from this table, and the table has to match the rate
+ * card on your account or you will undercharge every order and find out at
+ * the invoice. The codes below are real Royal Mail service codes; the prices
+ * are NOT — they are placeholders, in pence.
+ */
+const ROYAL_MAIL_SERVICES = (): string => `
+/**
+ * What this shop charges for Royal Mail, by total parcel weight.
+ *
+ * TODO VERIFY: every \`amount\` below is a placeholder in pence. Replace them
+ * with your own OBA rate card — Click & Drop → Settings → Shipping services
+ * lists exactly which services your account has, and the codes here must be
+ * among them. Service codes are account-specific: the published list is from
+ * 2021 and Royal Mail warn that "available services are unique to your OBA
+ * account and individual service agreements".
+ *
+ * The band whose \`maxGrams\` first covers the parcel wins, so order does not
+ * matter. A parcel heavier than every band gets no rate at all rather than a
+ * wrong one, and Click & Drop refuses anything over 30 kg.
+ */
+export const royalMailServices: RoyalMailService[] = [
+	{
+		code: "TPN24",
+		name: "Tracked 24",
+		estimatedDays: 1,
+		bands: [
+			{ maxGrams: 1000, amount: 0 /* TODO VERIFY */ },
+			{ maxGrams: 2000, amount: 0 /* TODO VERIFY */ },
+			{ maxGrams: 5000, amount: 0 /* TODO VERIFY */ },
+		],
+	},
+	{
+		code: "TPS48",
+		name: "Tracked 48",
+		estimatedDays: 2,
+		bands: [
+			{ maxGrams: 1000, amount: 0 /* TODO VERIFY */ },
+			{ maxGrams: 2000, amount: 0 /* TODO VERIFY */ },
+			{ maxGrams: 5000, amount: 0 /* TODO VERIFY */ },
+		],
+	},
+];
+`;