@capxul/sandbox 3.2.0 → 4.0.0

package/dist/main.mjs

@@ -231,10 +231,9 @@ function createConvexPathRunner({ target, env: sourceEnv = process.env, spawn =
 		};
 	};
 }
-const ORG_HANDLE_SHAPE_PATTERN = /^[a-zA-Z0-9-]+$/;
+const HANDLE_SHAPE_PATTERN = /^[a-zA-Z0-9_-]+$/;
 /**
-* Classify a faucet recipient prompt value: Capxul email, @org-handle, or —
-* as an explicit escape hatch — a raw EVM address. Canonical normalization
+* Classify a faucet recipient prompt value as an email, handle, or EVM address. Canonical normalization
 * (email lowercasing, handle validation) is left to the backend resolver.
 */
 function parseFaucetRecipient(value) {
@@ -247,12 +246,12 @@ function parseFaucetRecipient(value) {
 		kind: "email",
 		email: trimmed
 	};
-	const orgHandle = trimmed.startsWith("@") ? trimmed.slice(1) : trimmed;
-	if (orgHandle.length > 0 && !orgHandle.toLowerCase().startsWith("0x") && ORG_HANDLE_SHAPE_PATTERN.test(orgHandle)) return {
-		kind: "orgHandle",
-		orgHandle
+	const handle = trimmed.startsWith("@") ? trimmed.slice(1) : trimmed;
+	if (handle.length > 0 && !handle.toLowerCase().startsWith("0x") && HANDLE_SHAPE_PATTERN.test(handle)) return {
+		kind: "handle",
+		handle
 	};
-	throw new Error("Recipient must be a Capxul email, @org-handle, or 0x address (escape hatch).");
+	throw new Error("Recipient must be an email, handle, or 0x address.");
 }
 function usdAmountToBaseUnits(value) {
 	const amount = value.trim();
@@ -281,18 +280,17 @@ function canonicalConvexRunner(env = process.env) {
 //#endregion
 //#region src/commands/faucet-send.ts
 const DEFAULT_FAUCET_AMOUNT = "10";
-const FAUCET_ADDRESS_FUNCTION = "dev/faucetMintTo:mintTo";
 const FAUCET_RECIPIENT_FUNCTION = "dev/faucetMintTo:mintToRecipient";
 function recipientLabel(recipient) {
 	switch (recipient.kind) {
 		case "address": return recipient.address;
 		case "email": return recipient.email;
-		case "orgHandle": return `@${recipient.orgHandle}`;
+		case "handle": return `@${recipient.handle}`;
 	}
 }
 function mintFailureMessage(recipient, output) {
 	const message = output.length > 0 ? output : "Faucet mint failed.";
-	if (recipient.kind === "orgHandle" && message.includes("INVALID_INPUT")) return [message, "Hint: personal payee handles are owner-scoped and cannot be funded by the faucet — use a Capxul email or an org handle."].join("\n");
+	if (recipient.kind === "handle" && message.includes("INVALID_INPUT")) return `${message}\nHint: no Capxul account uses this handle.`;
 	return message;
 }
 async function runFaucetSend() {
@@ -304,7 +302,7 @@ async function runFaucetSend() {
 		"This command calls the canonical backend dev faucet and cannot select live/mainnet."
 	].join("\n"), "Canonical sandbox");
 	const recipientPrompt = await text({
-		message: "Recipient (Capxul email or @org-handle)",
+		message: "Recipient (email, handle, or 0x address)",
 		validate(value) {
 			try {
 				parseFaucetRecipient(value ?? "");
@@ -336,16 +334,6 @@ async function runFaucetSend() {
 	const rawAmount = usdAmountToBaseUnits(amountPrompt);
 	const displayAmount = amountPrompt.trim();
 	const identity = recipientLabel(recipient);
-	if (recipient.kind === "address") {
-		const escapeHatch = await confirm({
-			message: `Raw-address escape hatch — this skips Capxul identity resolution. Fund ${identity} directly?`,
-			initialValue: false
-		});
-		if (isCancel(escapeHatch) || escapeHatch === false) {
-			cancel("No faucet funds sent.");
-			return 0;
-		}
-	}
 	const shouldSend = await confirm({
 		message: `Mint ${displayAmount} test USDX to ${identity}?`,
 		initialValue: true
@@ -357,15 +345,7 @@ async function runFaucetSend() {
 	const s = spinner();
 	s.start("Minting testnet funds");
 	try {
-		const runConvex = canonicalConvexRunner();
-		const result = recipient.kind === "address" ? runConvex("", [
-			"run",
-			FAUCET_ADDRESS_FUNCTION,
-			JSON.stringify({
-				holderAddress: recipient.address,
-				rawAmount
-			})
-		]) : runConvex("", [
+		const result = canonicalConvexRunner()("", [
 			"run",
 			FAUCET_RECIPIENT_FUNCTION,
 			JSON.stringify({
@@ -375,7 +355,7 @@ async function runFaucetSend() {
 		]);
 		if (!result.ok) throw new Error(mintFailureMessage(recipient, result.output));
 		const txHash = extractField(result.output, "txHash");
-		const safeAddress = recipient.kind === "address" ? recipient.address : extractField(result.output, "safeAddress");
+		const safeAddress = extractField(result.output, "safeAddress");
 		s.stop("Faucet funds sent");
 		note([
 			`Recipient: ${identity}`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capxul/sandbox",
-  "version": "3.2.0",
+  "version": "4.0.0",
   "private": false,
   "description": "Capxul sandbox CLI for canonical quickstart keys and testnet faucet funds.",
   "keywords": [