@saastemly/voidcommerce 0.1.0 → 0.2.1

package/dist/catalog.js

@@ -14,7 +14,7 @@ import {
   SIGN_IN,
   TAX,
   UI
-} from "./index-s7sq41qs.js";
+} from "./index-z4qazajn.js";
 export {
   UI,
   TAX,

package/dist/cli.js

@@ -22,16 +22,16 @@ import {
   runVoid,
   version,
   voidAppsIn
-} from "./index-wzy1xtr1.js";
+} from "./index-xdsp97e4.js";
 import {
   LAYOUTS,
   readManifest,
   validate,
   zoneOf
-} from "./index-ssv3a6wc.js";
+} from "./index-zh3tmj08.js";
 import {
   GROUPS
-} from "./index-s7sq41qs.js";
+} from "./index-z4qazajn.js";
 
 // src/deploy/index.ts
 import color from "picocolors";

package/dist/generate/support.d.ts

@@ -20,4 +20,17 @@ export declare function renderNotificationsTs(): string;
  * because the choice lives on the line, not in the catalogue.
  */
 export declare function renderMintTs(): string;
+/**
+ * Where parcels leave from. Written once, then yours.
+ *
+ * Every carrier needs an origin to quote against, and it is shop data rather
+ * than a credential — a postcode changes when you move, not when a key
+ * rotates. So it is a file you edit, not an env var, and it ships with your
+ * own details already in the shape the carriers want.
+ *
+ * DHL in particular rejects a shipment whose origin has no name and phone,
+ * which is a failure that shows up at the first real order rather than at
+ * deploy, so both are marked rather than left blank.
+ */
+export declare function renderShippingTs(manifest: Manifest): string;
 export declare function renderErpTs(): string;

package/dist/{index-wzy1xtr1.js → index-xdsp97e4.js}

@@ -11,11 +11,11 @@ import {
   workerHosts,
   writeManifest,
   zone
-} from "./index-ssv3a6wc.js";
+} from "./index-zh3tmj08.js";
 import {
   CHOICES,
   __require
-} from "./index-s7sq41qs.js";
+} from "./index-z4qazajn.js";
 
 // src/generate/auth.ts
 var VAT = {
@@ -38,9 +38,46 @@ var social = (manifest, id, envPrefix) => has(manifest, id) ? `			${id}: { clien
 function renderAuthTs(manifest) {
   const { shop } = manifest;
   const lines = [];
+  const CARRIER_CALLS = {
+    "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 })`,
+      import: `import { dhlExpressProvider } from "@saastemly/better-commerce/providers/dhl-express";`
+    },
+    shippo: {
+      label: "Shippo",
+      call: `shippoProvider({ apiToken: must(env, "SHIPPO_API_TOKEN"), from: shipFrom })`,
+      import: `import { shippoProvider } from "@saastemly/better-commerce/providers/shippo";`
+    },
+    easypost: {
+      label: "EasyPost",
+      call: `easypostProvider({ apiKey: must(env, "EASYPOST_API_KEY"), from: shipFrom })`,
+      import: `import { easypostProvider } from "@saastemly/better-commerce/providers/easypost";`
+    },
+    ups: {
+      label: "UPS",
+      call: `upsProvider({ clientId: must(env, "UPS_CLIENT_ID"), clientSecret: must(env, "UPS_CLIENT_SECRET"), accountNumber: must(env, "UPS_ACCOUNT_NUMBER"), from: shipFrom })`,
+      import: `import { upsProvider } from "@saastemly/better-commerce/providers/ups";`
+    },
+    fedex: {
+      label: "FedEx",
+      call: `fedexProvider({ clientId: must(env, "FEDEX_CLIENT_ID"), clientSecret: must(env, "FEDEX_CLIENT_SECRET"), accountNumber: must(env, "FEDEX_ACCOUNT_NUMBER"), from: shipFrom })`,
+      import: `import { fedexProvider } from "@saastemly/better-commerce/providers/fedex";`
+    },
+    nft: {
+      label: "A token, not a parcel",
+      call: `nftDelivery({ mint: mintProvider, destinationFor })`,
+      import: `import { nftDelivery } from "@saastemly/better-commerce/providers/nft-delivery";
+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 wantsNft = has(manifest, "nft");
-  const nftProvider = wantsNft ? `, nftOrPhysical({ mint: mintProvider, physical: ${has(manifest, "business-central") ? `erpFulfillment("${shop.currency.toUpperCase()}")` : "manualFulfillment()"} })` : "";
-  const nftDefault = wantsNft ? `, defaultProvider: "nft-or-physical"` : "";
+  const carrierFulfillment = carriers.length ? `, deliveryFulfillment([${carriers.map((id) => CARRIER_CALLS[id].call).join(", ")}])` : "";
+  const nftDefault = carriers.length ? `, defaultProvider: "delivery:${carriers.join("+")}"` : "";
   const vat = VAT[shop.country];
   lines.push({
     import: `import { admin } from "better-auth/plugins/admin";`,
@@ -168,9 +205,12 @@ import { memorySearchProvider } from "@saastemly/better-commerce/providers/searc
   commerce("reviews", `reviews()`, "verified badge derived from a paid order");
   commerce("customer-groups", `customerGroups()`, "segments with their own prices");
   commerce("acp", `acp({ merchantDisplayName: "${shop.name}" })`, "agentic commerce", `import { acp } from "@saastemly/better-commerce/acp";`);
-  commerce("fulfillments", `fulfillments({ providers: [authFulfillment(), creditsFulfillment()${has(manifest, "gift-cards") ? ", giftCardFulfillment()" : ""}${has(manifest, "business-central") ? `, erpFulfillment("${shop.currency.toUpperCase()}")` : ""}${nftProvider}]${nftDefault} })`, "what happens when the money is confirmed", `import { authFulfillment, creditsFulfillment, fulfillments, manualFulfillment } from "@saastemly/better-commerce/plugins/fulfillments";${has(manifest, "business-central") ? `
+  commerce("fulfillments", `fulfillments({ providers: [authFulfillment(), creditsFulfillment()${has(manifest, "gift-cards") ? ", giftCardFulfillment()" : ""}${has(manifest, "business-central") ? `, erpFulfillment("${shop.currency.toUpperCase()}")` : ""}${carrierFulfillment}]${nftDefault} })`, "what happens when the money is confirmed", `import { authFulfillment, creditsFulfillment, fulfillments, manualFulfillment } from "@saastemly/better-commerce/plugins/fulfillments";${carriers.length ? `
+import { deliveryFulfillment } from "@saastemly/better-commerce/providers/delivery";` : ""}${carrierImports.length ? `
+${carrierImports.join(`
+`)}` : ""}${has(manifest, "business-central") ? `
 import { erpFulfillment } from "./lib/erp.ts";` : ""}`);
-  commerce("shipping-zones", `shippingZones({ zones: [{ id: "domestic", name: "${shop.country}", countries: ["${shop.country}"], rank: 0 }], shippingOptions: [{ id: "standard", zoneId: "domestic", name: "Standard", priceType: "flat", amount: Number(must(env, "SHIPPING_DOMESTIC_MINOR")), currency: "${shop.currency}", rank: 0 }, { id: "free", zoneId: "domestic", name: "Free", priceType: "free", currency: "${shop.currency}", minSubtotal: Number(must(env, "SHIPPING_FREE_FROM_MINOR")), rank: 1 }] })`, "quoted from required env; a shop with no option quotes FREE delivery silently");
+  commerce("shipping-zones", `shippingZones({ zones: [{ id: "domestic", name: "${shop.country}", countries: ["${shop.country}"], rank: 0 }], shippingOptions: [${carriers.length === 0 ? `{ id: "standard", zoneId: "domestic", name: "Standard", priceType: "flat", amount: Number(must(env, "SHIPPING_DOMESTIC_MINOR")), currency: "${shop.currency}", rank: 0 }, { id: "free", zoneId: "domestic", name: "Free", priceType: "free", currency: "${shop.currency}", minSubtotal: Number(must(env, "SHIPPING_FREE_FROM_MINOR")), rank: 1 }` : carriers.map((id, rank) => `{ id: "${id}", zoneId: "domestic", name: "${CARRIER_CALLS[id].label}", priceType: "calculated", carrierProviderId: "${id === "nft" ? "nft" : id}", currency: "${shop.currency}", rank: ${rank} }`).join(", ")}]${carriers.length ? `, carriers: [${carriers.map((id) => CARRIER_CALLS[id].call).join(", ")}]` : ""} })`, "quoted from required env; a shop with no option quotes FREE delivery silently");
   const registered = shop.taxRegistered === true;
   const askedLive = has(manifest, "stripe-tax");
   commerce("tax-regions", askedLive ? `taxRegions({ regions: [{ countryCode: "${shop.country}", name: "${shop.country}", rates: [] }], attachTax: false })` : !registered ? `taxRegions({ regions: [{ countryCode: "${shop.country}", name: "${shop.country}", rates: [] }] })` : vat ? `taxRegions({ regions: [{ countryCode: "${shop.country}", name: "${shop.country}", rates: [{ name: "${vat.name}", code: "vat", rate: ${vat.rate} }] }] })` : `taxRegions({ regions: [{ countryCode: "${shop.country}", name: "${shop.country}", rates: [] }] /* TODO VERIFY: no standard rate known for ${shop.country} */ })`, askedLive ? "Stripe is asked per basket, so an unregistered shop charges nothing and a registered one charges the buyer's own rate — with nothing here to keep up to date" : !registered ? `NOT registered for ${vat?.name ?? "VAT"}: no tax is added, because a business below the threshold must not charge it. Set taxRegistered in voidcommerce.json when you register.` : vat ? `${vat.rate / 100}% ${vat.name} declared in code, so a fresh deploy is never tax-free` : "TODO VERIFY: registered, but no standard rate is known for this country — declare it");
@@ -191,8 +231,7 @@ import { memoryFileProvider } from "@saastemly/better-commerce/providers/file";`
   commerce("merchants", `merchants()`, "several sellers, with payouts");
   if (has(manifest, "nft"))
     lines.push({
-      import: `import { nft, nftOrPhysical } from "@saastemly/better-commerce/plugins/nft";
-import { mintProvider } from "./lib/mint.ts";`,
+      import: `import { nft } from "@saastemly/better-commerce/plugins/nft";`,
       call: `nft({ blurb: "Rather not have the object? Take an authentic, completely useless token of it instead. Nothing gets printed, nothing gets posted." })`,
       ring: "commerce",
       why: "the buyer chooses a parcel or a token; the catalogue is the same either way"
@@ -1397,7 +1436,7 @@ import color from "picocolors";
 // package.json
 var package_default = {
   name: "@saastemly/voidcommerce",
-  version: "0.1.0",
+  version: "0.2.1",
   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",
@@ -2138,6 +2177,60 @@ function renderMintTs() {
  * after payment, and an exception there strands a paid order.
  */
 export const mintProvider: MintProvider = recordedMint();
+
+/**
+ * Where THIS order's token goes.
+ *
+ * The buyer's own email, because a custodial mint provider will make them a
+ * wallet from it — so somebody who has never held one still receives the
+ * token, and the checkout never has to ask for a wallet address. Returning
+ * null refuses the shipment rather than minting into the void.
+ *
+ * The adapter is reached the way the emailer reaches it: through the current
+ * auth context, which exists because this runs inside a request.
+ */
+export async function destinationFor(orderId: string): Promise<string | null> {
+	try {
+		const endpoint = (await getCurrentAuthContext()) as unknown as {
+			context?: { adapter?: { findOne: (q: unknown) => Promise<unknown> } };
+		};
+		const adapter = endpoint.context?.adapter;
+		if (!adapter) return null;
+
+		const order = (await adapter.findOne({
+			model: "order",
+			where: [{ field: "id", value: orderId }],
+		})) as { userId?: string | null } | null;
+		if (!order?.userId) return null;
+
+		const user = (await adapter.findOne({
+			model: "user",
+			where: [{ field: "id", value: order.userId }],
+		})) as { email?: string | null } | null;
+		return user?.email ?? null;
+	} catch {
+		return null;
+	}
+}
+`;
+}
+function renderShippingTs(manifest) {
+  return `import type { DeliveryAddress } from "@saastemly/better-commerce/providers/delivery";
+
+/**
+ * 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\`.
+ */
+export const shipFrom: DeliveryAddress = {
+	name: "${manifest.shop.name}",
+	line1: "TODO VERIFY: street",
+	city: "TODO VERIFY: town",
+	postalCode: "TODO VERIFY",
+	country: "${manifest.shop.country}",
+	phone: "TODO VERIFY: +44…",
+};
 `;
 }
 function renderErpTs() {
@@ -2248,6 +2341,9 @@ 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))) {
+    await put(root, at("lib/shipping.ts"), renderShippingTs(manifest), result, own);
+  }
   if (has(manifest, "business-central")) {
     await put(root, at("lib/erp.ts"), renderErpTs(), result, own);
   }

package/dist/{index-s7sq41qs.js → index-z4qazajn.js}

@@ -340,12 +340,6 @@ var COMMERCE_OPERATIONS = {
       hint: "order confirmations and shipping updates, queued and retried",
       required: true
     },
-    {
-      id: "nft",
-      label: "Token instead of a parcel",
-      hint: "a buyer who would rather not have the object can take an NFT of it instead — same price, same order, nothing shipped. Needs a mint provider before it mints anything",
-      recommended: false
-    },
     {
       id: "events",
       label: "Webhooks",
@@ -445,20 +439,25 @@ var TAX = {
 };
 var CARRIERS = {
   id: "carriers",
-  title: "Carriers for calculated shipping rates",
-  intro: "Optional. Flat-rate shipping needs none of these.",
+  title: "How an order reaches a buyer",
+  intro: "Live rates at checkout, quoted per carrier. Flat-rate shipping needs none of these.",
   kind: "multiselect",
   choices: [
-    { id: "shippo", label: "Shippo", hint: "many carriers through one API", env: [{ key: "SHIPPO_API_KEY", breaks: "calculated rates fall back to flat" }] },
+    { id: "shippo", label: "Shippo", hint: "many carriers through one API", env: [{ key: "SHIPPO_API_TOKEN", breaks: "calculated rates fall back to flat" }] },
     { id: "easypost", label: "EasyPost", hint: "the same, US-leaning", env: [{ key: "EASYPOST_API_KEY", breaks: "calculated rates fall back to flat" }] },
-    { id: "ups", label: "UPS", hint: "your own UPS account, for negotiated rates an aggregator cannot see", env: [{ key: "UPS_CLIENT_ID", breaks: "UPS rates are not quoted" }, { key: "UPS_CLIENT_SECRET", breaks: "the same" }] },
-    { 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" }] },
-    { id: "dhl-express", label: "DHL Express", hint: "international", env: [{ key: "DHL_API_KEY", breaks: "DHL rates are not quoted" }] },
+    { id: "ups", label: "UPS", hint: "your own UPS account, for negotiated rates an aggregator cannot see", env: [{ key: "UPS_CLIENT_ID", breaks: "UPS rates are not quoted" }, { key: "UPS_CLIENT_SECRET", breaks: "the same" }, { key: "UPS_ACCOUNT_NUMBER", breaks: "UPS has no account to bill the transport to" }] },
+    { 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: "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" }] }
+    { id: "stuart", label: "Stuart", hint: "same-day courier, Europe", env: [{ key: "STUART_CLIENT_ID", breaks: "Stuart is not offered" }] },
+    {
+      id: "nft",
+      label: "A token, not a parcel",
+      hint: "the buyer takes an NFT of what they bought instead of the object — quotes free, ships nothing, needs no address. It mints to their email, so they need no wallet"
+    }
   ]
 };
 var ERP = {

package/dist/{index-ssv3a6wc.js → index-zh3tmj08.js}

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

package/dist/index.js

@@ -57,7 +57,7 @@ import {
   routeProblem,
   strictDependencies,
   upsertJsonc
-} from "./index-wzy1xtr1.js";
+} from "./index-xdsp97e4.js";
 import {
   LAYOUTS,
   MANIFEST_FILE,
@@ -77,7 +77,7 @@ import {
   writeManifest,
   zone,
   zoneOf
-} from "./index-ssv3a6wc.js";
+} from "./index-zh3tmj08.js";
 import {
   AUTH_PLUGINS,
   CARRIERS,
@@ -94,7 +94,7 @@ import {
   SIGN_IN,
   TAX,
   UI
-} from "./index-s7sq41qs.js";
+} from "./index-z4qazajn.js";
 export {
   zoneOf,
   zone,

package/dist/manifest.js

@@ -17,8 +17,8 @@ import {
   writeManifest,
   zone,
   zoneOf
-} from "./index-ssv3a6wc.js";
-import"./index-s7sq41qs.js";
+} from "./index-zh3tmj08.js";
+import"./index-z4qazajn.js";
 export {
   zoneOf,
   zone,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saastemly/voidcommerce",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "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

@@ -404,12 +404,6 @@ export const COMMERCE_OPERATIONS: Group = {
 			hint: "order confirmations and shipping updates, queued and retried",
 			required: true,
 		},
-		{
-			id: "nft",
-			label: "Token instead of a parcel",
-			hint: "a buyer who would rather not have the object can take an NFT of it instead — same price, same order, nothing shipped. Needs a mint provider before it mints anything",
-			recommended: false,
-		},
 		{
 			id: "events",
 			label: "Webhooks",
@@ -515,20 +509,25 @@ export const TAX: Group = {
 
 export const CARRIERS: Group = {
 	id: "carriers",
-	title: "Carriers for calculated shipping rates",
-	intro: "Optional. Flat-rate shipping needs none of these.",
+	title: "How an order reaches a buyer",
+	intro: "Live rates at checkout, quoted per carrier. Flat-rate shipping needs none of these.",
 	kind: "multiselect",
 	choices: [
-		{ id: "shippo", label: "Shippo", hint: "many carriers through one API", env: [{ key: "SHIPPO_API_KEY", breaks: "calculated rates fall back to flat" }] },
+		{ id: "shippo", label: "Shippo", hint: "many carriers through one API", env: [{ key: "SHIPPO_API_TOKEN", breaks: "calculated rates fall back to flat" }] },
 		{ id: "easypost", label: "EasyPost", hint: "the same, US-leaning", env: [{ key: "EASYPOST_API_KEY", breaks: "calculated rates fall back to flat" }] },
-		{ id: "ups", label: "UPS", hint: "your own UPS account, for negotiated rates an aggregator cannot see", env: [{ key: "UPS_CLIENT_ID", breaks: "UPS rates are not quoted" }, { key: "UPS_CLIENT_SECRET", breaks: "the same" }] },
-		{ 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" }] },
-		{ id: "dhl-express", label: "DHL Express", hint: "international", env: [{ key: "DHL_API_KEY", breaks: "DHL rates are not quoted" }] },
+		{ id: "ups", label: "UPS", hint: "your own UPS account, for negotiated rates an aggregator cannot see", env: [{ key: "UPS_CLIENT_ID", breaks: "UPS rates are not quoted" }, { key: "UPS_CLIENT_SECRET", breaks: "the same" }, { key: "UPS_ACCOUNT_NUMBER", breaks: "UPS has no account to bill the transport to" }] },
+		{ 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: "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" }] },
+		{
+			id: "nft",
+			label: "A token, not a parcel",
+			hint: "the buyer takes an NFT of what they bought instead of the object — quotes free, ships nothing, needs no address. It mints to their email, so they need no wallet",
+		},
 	],
 };
 

package/src/generate/auth.ts

@@ -60,11 +60,56 @@ export function renderAuthTs(manifest: Manifest): string {
 	 * the intent and mints nothing, which is the honest state for a shop that
 	 * has not chosen a chain.
 	 */
+	/**
+	 * Carriers. Each chosen one becomes a `calculated` shipping option naming
+	 * it, so the buyer picks a delivery method at checkout and the total
+	 * follows — including the token, which quotes zero and ships nothing.
+	 */
+	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.
+		"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 })`,
+			import: `import { dhlExpressProvider } from "@saastemly/better-commerce/providers/dhl-express";`,
+		},
+		shippo: {
+			label: "Shippo",
+			call: `shippoProvider({ apiToken: must(env, "SHIPPO_API_TOKEN"), from: shipFrom })`,
+			import: `import { shippoProvider } from "@saastemly/better-commerce/providers/shippo";`,
+		},
+		easypost: {
+			label: "EasyPost",
+			call: `easypostProvider({ apiKey: must(env, "EASYPOST_API_KEY"), from: shipFrom })`,
+			import: `import { easypostProvider } from "@saastemly/better-commerce/providers/easypost";`,
+		},
+		ups: {
+			label: "UPS",
+			call: `upsProvider({ clientId: must(env, "UPS_CLIENT_ID"), clientSecret: must(env, "UPS_CLIENT_SECRET"), accountNumber: must(env, "UPS_ACCOUNT_NUMBER"), from: shipFrom })`,
+			import: `import { upsProvider } from "@saastemly/better-commerce/providers/ups";`,
+		},
+		fedex: {
+			label: "FedEx",
+			call: `fedexProvider({ clientId: must(env, "FEDEX_CLIENT_ID"), clientSecret: must(env, "FEDEX_CLIENT_SECRET"), accountNumber: must(env, "FEDEX_ACCOUNT_NUMBER"), from: shipFrom })`,
+			import: `import { fedexProvider } from "@saastemly/better-commerce/providers/fedex";`,
+		},
+		nft: {
+			label: "A token, not a parcel",
+			call: `nftDelivery({ mint: mintProvider, destinationFor })`,
+			import: `import { nftDelivery } from "@saastemly/better-commerce/providers/nft-delivery";\nimport { 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);
+	// The token needs no origin; every other carrier does.
+	if (carriers.some((id) => id !== "nft")) carrierImports.push(`import { shipFrom } from "./lib/shipping.ts";`);
 	const wantsNft = has(manifest, "nft");
-	const nftProvider = wantsNft
-		? `, nftOrPhysical({ mint: mintProvider, physical: ${has(manifest, "business-central") ? `erpFulfillment("${shop.currency.toUpperCase()}")` : "manualFulfillment()"} })`
+	// 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.
+	const carrierFulfillment = carriers.length
+		? `, deliveryFulfillment([${carriers.map((id) => CARRIER_CALLS[id]!.call).join(", ")}])`
 		: "";
-	const nftDefault = wantsNft ? `, defaultProvider: "nft-or-physical"` : "";
+	const nftDefault = carriers.length ? `, defaultProvider: "delivery:${carriers.join("+")}"` : "";
 
 	const vat = VAT[shop.country];
 
@@ -197,13 +242,22 @@ export function renderAuthTs(manifest: Manifest): string {
 	commerce("acp", `acp({ merchantDisplayName: "${shop.name}" })`, "agentic commerce", `import { acp } from "@saastemly/better-commerce/acp";`);
 	commerce(
 		"fulfillments",
-		`fulfillments({ providers: [authFulfillment(), creditsFulfillment()${has(manifest, "gift-cards") ? ", giftCardFulfillment()" : ""}${has(manifest, "business-central") ? `, erpFulfillment("${shop.currency.toUpperCase()}")` : ""}${nftProvider}]${nftDefault} })`,
+		`fulfillments({ providers: [authFulfillment(), creditsFulfillment()${has(manifest, "gift-cards") ? ", giftCardFulfillment()" : ""}${has(manifest, "business-central") ? `, erpFulfillment("${shop.currency.toUpperCase()}")` : ""}${carrierFulfillment}]${nftDefault} })`,
 		"what happens when the money is confirmed",
-		`import { authFulfillment, creditsFulfillment, fulfillments, manualFulfillment } from "@saastemly/better-commerce/plugins/fulfillments";${has(manifest, "business-central") ? `\nimport { erpFulfillment } from "./lib/erp.ts";` : ""}`,
+		`import { authFulfillment, creditsFulfillment, fulfillments, manualFulfillment } from "@saastemly/better-commerce/plugins/fulfillments";${carriers.length ? `\nimport { deliveryFulfillment } from "@saastemly/better-commerce/providers/delivery";` : ""}${carrierImports.length ? `\n${carrierImports.join("\n")}` : ""}${has(manifest, "business-central") ? `\nimport { erpFulfillment } from "./lib/erp.ts";` : ""}`,
 	);
 	commerce(
 		"shipping-zones",
-		`shippingZones({ zones: [{ id: "domestic", name: "${shop.country}", countries: ["${shop.country}"], rank: 0 }], shippingOptions: [{ id: "standard", zoneId: "domestic", name: "Standard", priceType: "flat", amount: Number(must(env, "SHIPPING_DOMESTIC_MINOR")), currency: "${shop.currency}", rank: 0 }, { id: "free", zoneId: "domestic", name: "Free", priceType: "free", currency: "${shop.currency}", minSubtotal: Number(must(env, "SHIPPING_FREE_FROM_MINOR")), rank: 1 }] })`,
+		`shippingZones({ zones: [{ id: "domestic", name: "${shop.country}", countries: ["${shop.country}"], rank: 0 }], shippingOptions: [${
+			carriers.length === 0
+				? `{ id: "standard", zoneId: "domestic", name: "Standard", priceType: "flat", amount: Number(must(env, "SHIPPING_DOMESTIC_MINOR")), currency: "${shop.currency}", rank: 0 }, { id: "free", zoneId: "domestic", name: "Free", priceType: "free", currency: "${shop.currency}", minSubtotal: Number(must(env, "SHIPPING_FREE_FROM_MINOR")), rank: 1 }`
+				: carriers
+						.map(
+							(id, rank) =>
+								`{ id: "${id}", zoneId: "domestic", name: "${CARRIER_CALLS[id]!.label}", priceType: "calculated", carrierProviderId: "${id === "nft" ? "nft" : id}", currency: "${shop.currency}", rank: ${rank} }`,
+						)
+						.join(", ")
+		}]${carriers.length ? `, carriers: [${carriers.map((id) => CARRIER_CALLS[id]!.call).join(", ")}]` : ""} })`,
 		"quoted from required env; a shop with no option quotes FREE delivery silently",
 	);
 	/**
@@ -247,7 +301,7 @@ export function renderAuthTs(manifest: Manifest): string {
 	commerce("merchants", `merchants()`, "several sellers, with payouts");
 	if (has(manifest, "nft"))
 		lines.push({
-			import: `import { nft, nftOrPhysical } from "@saastemly/better-commerce/plugins/nft";\nimport { mintProvider } from "./lib/mint.ts";`,
+			import: `import { nft } from "@saastemly/better-commerce/plugins/nft";`,
 			call: `nft({ blurb: "Rather not have the object? Take an authentic, completely useless token of it instead. Nothing gets printed, nothing gets posted." })`,
 			ring: "commerce",
 			why: "the buyer chooses a parcel or a token; the catalogue is the same either way",

package/src/generate/index.ts

@@ -50,7 +50,7 @@ import {
 	renderVoidPatch,
 	strictDependencies,
 } from "./strict";
-import { renderDomainTs, renderErpTs, renderMintTs, renderNotificationsTs, renderPaymentTs } from "./support";
+import { renderDomainTs, renderErpTs, renderMintTs, renderNotificationsTs, renderPaymentTs, renderShippingTs } from "./support";
 
 /**
  * Turn a manifest into files.
@@ -173,6 +173,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))) {
+		await put(root, at("lib/shipping.ts"), renderShippingTs(manifest), result, own);
+	}
 	if (has(manifest, "business-central")) {
 		await put(root, at("lib/erp.ts"), renderErpTs(), result, own);
 	}

package/src/generate/support.ts

@@ -220,6 +220,73 @@ export function renderMintTs(): string {
  * after payment, and an exception there strands a paid order.
  */
 export const mintProvider: MintProvider = recordedMint();
+
+/**
+ * Where THIS order's token goes.
+ *
+ * The buyer's own email, because a custodial mint provider will make them a
+ * wallet from it — so somebody who has never held one still receives the
+ * token, and the checkout never has to ask for a wallet address. Returning
+ * null refuses the shipment rather than minting into the void.
+ *
+ * The adapter is reached the way the emailer reaches it: through the current
+ * auth context, which exists because this runs inside a request.
+ */
+export async function destinationFor(orderId: string): Promise<string | null> {
+	try {
+		const endpoint = (await getCurrentAuthContext()) as unknown as {
+			context?: { adapter?: { findOne: (q: unknown) => Promise<unknown> } };
+		};
+		const adapter = endpoint.context?.adapter;
+		if (!adapter) return null;
+
+		const order = (await adapter.findOne({
+			model: "order",
+			where: [{ field: "id", value: orderId }],
+		})) as { userId?: string | null } | null;
+		if (!order?.userId) return null;
+
+		const user = (await adapter.findOne({
+			model: "user",
+			where: [{ field: "id", value: order.userId }],
+		})) as { email?: string | null } | null;
+		return user?.email ?? null;
+	} catch {
+		return null;
+	}
+}
+`;
+}
+
+/**
+ * Where parcels leave from. Written once, then yours.
+ *
+ * Every carrier needs an origin to quote against, and it is shop data rather
+ * than a credential — a postcode changes when you move, not when a key
+ * rotates. So it is a file you edit, not an env var, and it ships with your
+ * own details already in the shape the carriers want.
+ *
+ * DHL in particular rejects a shipment whose origin has no name and phone,
+ * which is a failure that shows up at the first real order rather than at
+ * 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";
+
+/**
+ * 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\`.
+ */
+export const shipFrom: DeliveryAddress = {
+	name: "${manifest.shop.name}",
+	line1: "TODO VERIFY: street",
+	city: "TODO VERIFY: town",
+	postalCode: "TODO VERIFY",
+	country: "${manifest.shop.country}",
+	phone: "TODO VERIFY: +44…",
+};
 `;
 }