@saastemly/voidcommerce 0.1.0 → 0.2.0

package/dist/catalog.js

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

package/dist/cli.js

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

package/dist/{index-ssv3a6wc.js → index-0vt6g4cb.js}

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

package/dist/{index-wzy1xtr1.js → index-9x9q9ng2.js}

@@ -11,11 +11,11 @@ import {
   workerHosts,
   writeManifest,
   zone
-} from "./index-ssv3a6wc.js";
+} from "./index-0vt6g4cb.js";
 import {
   CHOICES,
   __require
-} from "./index-s7sq41qs.js";
+} from "./index-yk361vn2.js";
 
 // src/generate/auth.ts
 var VAT = {
@@ -38,9 +38,29 @@ 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") })`,
+      import: `import { dhlExpressProvider } from "@saastemly/better-commerce/providers/dhl-express";`
+    },
+    shippo: { label: "Shippo", call: `shippoProvider({ apiKey: must(env, "SHIPPO_API_KEY") })`, import: `import { shippoProvider } from "@saastemly/better-commerce/providers/shippo";` },
+    easypost: { label: "EasyPost", call: `easypostProvider({ apiKey: must(env, "EASYPOST_API_KEY") })`, 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") })`, 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") })`, import: `import { fedexProvider } from "@saastemly/better-commerce/providers/fedex";` },
+    "royal-mail": { label: "Royal Mail", call: `royalMailProvider({ clientId: must(env, "ROYAL_MAIL_CLIENT_ID") })`, import: `import { royalMailProvider } from "@saastemly/better-commerce/providers/royal-mail";` },
+    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);
   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 +188,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 +214,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 +1419,7 @@ import color from "picocolors";
 // package.json
 var package_default = {
   name: "@saastemly/voidcommerce",
-  version: "0.1.0",
+  version: "0.2.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",
@@ -2138,6 +2160,41 @@ 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 renderErpTs() {

package/dist/{index-s7sq41qs.js → index-yk361vn2.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,8 +439,8 @@ 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" }] },
@@ -458,7 +452,12 @@ var CARRIERS = {
     { 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.js

@@ -57,7 +57,7 @@ import {
   routeProblem,
   strictDependencies,
   upsertJsonc
-} from "./index-wzy1xtr1.js";
+} from "./index-9x9q9ng2.js";
 import {
   LAYOUTS,
   MANIFEST_FILE,
@@ -77,7 +77,7 @@ import {
   writeManifest,
   zone,
   zoneOf
-} from "./index-ssv3a6wc.js";
+} from "./index-0vt6g4cb.js";
 import {
   AUTH_PLUGINS,
   CARRIERS,
@@ -94,7 +94,7 @@ import {
   SIGN_IN,
   TAX,
   UI
-} from "./index-s7sq41qs.js";
+} from "./index-yk361vn2.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-0vt6g4cb.js";
+import"./index-yk361vn2.js";
 export {
   zoneOf,
   zone,

package/package.json

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

@@ -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,8 +509,8 @@ 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" }] },
@@ -529,6 +523,11 @@ export const CARRIERS: Group = {
 		{ 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,37 @@ 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 }> = {
+		"dhl-express": {
+			label: "DHL Express",
+			call: `dhlExpressProvider({ apiKey: must(env, "DHL_API_KEY") })`,
+			import: `import { dhlExpressProvider } from "@saastemly/better-commerce/providers/dhl-express";`,
+		},
+		shippo: { label: "Shippo", call: `shippoProvider({ apiKey: must(env, "SHIPPO_API_KEY") })`, import: `import { shippoProvider } from "@saastemly/better-commerce/providers/shippo";` },
+		easypost: { label: "EasyPost", call: `easypostProvider({ apiKey: must(env, "EASYPOST_API_KEY") })`, 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") })`, 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") })`, import: `import { fedexProvider } from "@saastemly/better-commerce/providers/fedex";` },
+		"royal-mail": { label: "Royal Mail", call: `royalMailProvider({ clientId: must(env, "ROYAL_MAIL_CLIENT_ID") })`, import: `import { royalMailProvider } from "@saastemly/better-commerce/providers/royal-mail";` },
+		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);
 	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 +223,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 +282,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/support.ts

@@ -220,6 +220,41 @@ 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;
+	}
+}
 `;
 }