@kizlo/woocommerce 0.13.0 → 0.14.0

package/dist/validation-DDEq7ebc.js

@@ -0,0 +1,337 @@
+import z$1 from "zod/v4";
+
+//#region src/field-projections.ts
+/** The native API is a projection of a registered value, never a second storage field. */
+const BillingFieldProjections = { taxId: {
+	id: "kizlo/tax-id",
+	location: "address",
+	group: "billing",
+	excludedGroups: ["shipping"],
+	schema: z$1.string().default("")
+} };
+const BillingNativeFields = Object.fromEntries(Object.entries(BillingFieldProjections).map(([property, projection]) => [property, projection.schema]));
+/** Partial updates must not execute the response/full-submission default for an omitted property. */
+const BillingNativeInputFields = Object.fromEntries(Object.entries(BillingFieldProjections).map(([property, projection]) => [property, projection.schema.removeDefault().optional()]));
+function isProjectedBillingField(id) {
+	return Object.values(BillingFieldProjections).some((projection) => projection.id === id);
+}
+/** Preserve the existing billing-only policy independently of Woo's address registration and UI rules. */
+function isExcludedRegisteredField(id, group) {
+	return Object.values(BillingFieldProjections).some((projection) => projection.id === id && projection.excludedGroups.includes(group));
+}
+function deserializeBillingFields(fields) {
+	return Object.fromEntries(Object.entries(BillingFieldProjections).map(([property, projection]) => {
+		const parsed = projection.schema.safeParse(fields[projection.id]);
+		return [property, parsed.success ? parsed.data : projection.schema.parse(void 0)];
+	}));
+}
+/** Bypass callers must obey the same single-value contract as typed/schema-validated callers. */
+function serializeBillingFields(address) {
+	const fields = {};
+	for (const [property, projection] of Object.entries(BillingFieldProjections)) {
+		if (Object.hasOwn(address.additionalFields ?? {}, projection.id)) throw new TypeError(`Use billingAddress.${property} instead of additionalFields["${projection.id}"].`);
+		const value = address[property];
+		if (value !== void 0) fields[projection.id] = value;
+	}
+	return fields;
+}
+/** Resolve only registered, unambiguous identities. Group-level errors need no invented leaf target. */
+function resolveRegisteredFieldTarget(locations, id, group, surface = "checkout") {
+	const matches = Object.keys(locations).filter((location$1) => locations[location$1].includes(id));
+	const location = matches[0];
+	if (matches.length !== 1 || location === void 0) return null;
+	if (location !== "address") {
+		if (group !== void 0 && group !== "other" || surface === "customer" && location === "order") return null;
+		return {
+			id,
+			location,
+			group: "other",
+			path: ["additionalFields", id],
+			wirePath: ["additional_fields", id]
+		};
+	}
+	if (group !== "billing" && group !== "shipping") return null;
+	if (isExcludedRegisteredField(id, group)) return null;
+	const address = surface === "customer" ? group : `${group}Address`;
+	const wireAddress = surface === "customer" ? group : `${group}_address`;
+	const projection = Object.entries(BillingFieldProjections).find(([, projection$1]) => projection$1.id === id && projection$1.group === group);
+	return {
+		id,
+		location,
+		group,
+		path: projection ? [address, projection[0]] : [
+			address,
+			"additionalFields",
+			id
+		],
+		wirePath: surface === "customer" ? [
+			wireAddress,
+			"additional_fields",
+			id
+		] : [wireAddress, id]
+	};
+}
+
+//#endregion
+//#region src/address-fields.ts
+/** Identity shared by Store API address serialization and storefront bindings. */
+const CoreAddressFieldKeys = {
+	first_name: "firstName",
+	last_name: "lastName",
+	company: "company",
+	address_1: "address1",
+	address_2: "address2",
+	city: "city",
+	state: "state",
+	postcode: "postcode",
+	country: "country",
+	phone: "phone"
+};
+function deserializeCoreAddress(address) {
+	return Object.fromEntries(Object.entries(CoreAddressFieldKeys).map(([id, key]) => [key, address[id]]));
+}
+function serializeCoreAddress(address) {
+	return Object.fromEntries(Object.entries(CoreAddressFieldKeys).flatMap(([id, key]) => address[key] === void 0 ? [] : [[id, address[key]]]));
+}
+
+//#endregion
+//#region src/checkout/validation.ts
+const CheckoutRegisteredFieldReference = z$1.object({
+	id: z$1.string().min(1),
+	bucket: z$1.enum([
+		"billingAddress",
+		"shippingAddress",
+		"additionalFields"
+	]).nullable()
+});
+const Evidence = z$1.object({
+	source: z$1.string().nullable(),
+	sourcePath: z$1.array(z$1.string()),
+	code: z$1.string().nullable(),
+	message: z$1.string(),
+	registeredFields: z$1.array(CheckoutRegisteredFieldReference)
+});
+const CheckoutValidationIssue = z$1.discriminatedUnion("scope", [
+	Evidence.extend({
+		scope: z$1.literal("field"),
+		target: z$1.array(z$1.string()).min(1)
+	}),
+	Evidence.extend({
+		scope: z$1.literal("group"),
+		target: z$1.array(z$1.string()).min(1)
+	}),
+	Evidence.extend({
+		scope: z$1.literal("unresolved"),
+		target: z$1.null()
+	})
+]);
+const CheckoutValidationData = z$1.strictObject({ issues: z$1.array(CheckoutValidationIssue) });
+function record(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function qualifiedPath(name) {
+	for (const [wire, sdk] of [
+		["billing_address", "billingAddress"],
+		["shipping_address", "shippingAddress"],
+		["additional_fields", "additionalFields"]
+	]) for (const prefix of [wire, sdk]) {
+		if (name === prefix) return [wire];
+		if (name.startsWith(`${prefix}.`)) return [wire, name.slice(prefix.length + 1)];
+		if (name.startsWith(`${prefix}[`) && name.endsWith("]")) return [wire, name.slice(prefix.length + 1, -1)];
+	}
+	for (const group of ["billing", "shipping"]) {
+		const id = name.slice(group.length + 1);
+		if (name.startsWith(`${group}_`) && (Object.hasOwn(CoreAddressFieldKeys, id) || Object.values(CoreAddressFieldKeys).some((key) => key === id) || id === "email" || Object.hasOwn(BillingFieldProjections, id))) return [`${group}_address`, id];
+	}
+}
+function sdkBucket(value) {
+	if (value === "billing_address" || value === "billingAddress") return "billingAddress";
+	if (value === "shipping_address" || value === "shippingAddress") return "shippingAddress";
+	if (value === "additional_fields" || value === "additionalFields") return "additionalFields";
+	return null;
+}
+function sourcePath(name) {
+	const qualified = qualifiedPath(name);
+	if (qualified?.length === 1) return qualified;
+	if (!name.includes("/") && qualified && nativeTarget(qualified)) return qualified;
+	return [name];
+}
+function childPath(path, name) {
+	if (path.length === 1 && sdkBucket(path[0])) return [...path, name];
+	const named = sourcePath(name);
+	return path.length && !sdkBucket(named[0]) ? [...path, name] : named;
+}
+function nativeTarget(path) {
+	const bucket = sdkBucket(path[0]);
+	const id = path[1];
+	if (path.length !== 2 || !id || bucket !== "billingAddress" && bucket !== "shippingAddress") return;
+	const core = Object.entries(CoreAddressFieldKeys).find(([wire, sdk]) => id === wire || id === sdk);
+	if (core || bucket === "billingAddress" && id === "email") return [bucket, core?.[1] ?? "email"];
+	const projection = Object.entries(BillingFieldProjections).find(([key, entry]) => id === entry.id || id === key);
+	if (projection && bucket === "billingAddress") return [bucket, projection[0]];
+}
+function normalizeIssue(issue, explicit) {
+	const path = issue.sourcePath;
+	const bucket = sdkBucket(path[0]);
+	if (path.length === 1 && bucket) return {
+		...issue,
+		scope: "group",
+		target: [bucket]
+	};
+	const target = nativeTarget(path);
+	if (target) return {
+		...issue,
+		scope: "field",
+		target
+	};
+	const id = path.length === 1 ? path[0] : path.length === 2 && bucket ? path[1] : explicit && path.length === 3 && (bucket === "billingAddress" || bucket === "shippingAddress") && path[1] === "additionalFields" ? path[2] : void 0;
+	if (!id) return issue;
+	if (bucket === "shippingAddress" && isExcludedRegisteredField(id, "shipping")) return issue;
+	const registeredFields = [{
+		id,
+		bucket: path.length > 1 ? bucket : null
+	}];
+	const qualified = !explicit && path.length === 1 ? qualifiedPath(id) : void 0;
+	if (qualified?.length === 2 && qualified[1]) registeredFields.push({
+		id: qualified[1],
+		bucket: sdkBucket(qualified[0])
+	});
+	return {
+		...issue,
+		registeredFields
+	};
+}
+/** Extract messages and identity evidence before discarding the upstream envelope. */
+function checkoutValidationData(error) {
+	const issues = [];
+	const data = record(error.data) ? error.data : {};
+	const ancestors = /* @__PURE__ */ new Set();
+	function visit(value, source, path, code, explicit = false) {
+		if (typeof value === "object" && value !== null) {
+			if (ancestors.has(value)) return;
+			ancestors.add(value);
+		}
+		try {
+			visitValue(value, source, path, code, explicit);
+		} finally {
+			if (typeof value === "object" && value !== null) ancestors.delete(value);
+		}
+	}
+	function visitValue(value, source, path, code, explicit) {
+		if (Array.isArray(value)) {
+			for (const child of value) visit(child, source, path, code, explicit);
+			return;
+		}
+		const detail = record(value) ? value : void 0;
+		const nextCode = typeof detail?.code === "string" ? detail.code : code;
+		const identity = record(detail?.data) ? detail.data : detail;
+		let nextPath = path;
+		let nextExplicit = explicit;
+		if (Array.isArray(identity?.path) && identity.path.length && identity.path.every((part) => typeof part === "string")) {
+			const first = identity.path[0];
+			nextPath = [sdkBucket(first) ? qualifiedPath(first)?.[0] ?? first : first, ...identity.path.slice(1)];
+			nextExplicit = true;
+		} else if (typeof identity?.param === "string") {
+			nextExplicit = false;
+			const explicit$1 = sourcePath(identity.param);
+			nextPath = explicit$1.length === 1 && ![
+				"billing_address",
+				"shipping_address",
+				"additional_fields"
+			].includes(explicit$1[0] ?? "") && path.length && [
+				"billing_address",
+				"shipping_address",
+				"additional_fields"
+			].includes(path[0] ?? "") ? [path[0], ...explicit$1] : explicit$1;
+		}
+		const context = identity?.group === "billing" || identity?.group === "shipping" ? `${identity.group}_address` : identity?.group === "other" || identity?.location === "contact" || identity?.location === "order" ? "additional_fields" : void 0;
+		const field = typeof identity?.key === "string" ? identity.key : identity?.field;
+		if (typeof field === "string") {
+			nextExplicit = true;
+			const bucket = context ?? (sdkBucket(nextPath[0]) ? nextPath[0] : void 0);
+			nextPath = bucket ? [bucket, field] : [field];
+		} else if (context && nextPath.length === 1 && !sdkBucket(nextPath[0])) nextPath = [context, ...nextPath];
+		else if (nextPath.length === 1 && ["billing_address", "shipping_address"].includes(nextPath[0] ?? "") && nextCode.startsWith("invalid_") && Object.hasOwn(CoreAddressFieldKeys, nextCode.slice(8))) nextPath = [nextPath[0], nextCode.slice(8)];
+		if (!field && nextPath.length === 0 && context) nextPath = [context];
+		const nextSource = source ?? (typeof identity?.param === "string" ? identity.param : typeof field === "string" ? field : null);
+		const message = typeof value === "string" ? value : typeof detail?.message === "string" ? detail.message : void 0;
+		if (message !== void 0) {
+			const issue = normalizeIssue({
+				source: nextSource,
+				sourcePath: nextPath,
+				code: nextCode,
+				message,
+				scope: "unresolved",
+				target: null,
+				registeredFields: []
+			}, nextExplicit);
+			if (!issues.some((other) => other.source === nextSource && other.message === message && JSON.stringify(other.sourcePath) === JSON.stringify(nextPath) && other.code === nextCode && JSON.stringify(other.registeredFields) === JSON.stringify(issue.registeredFields) && JSON.stringify(other.target) === JSON.stringify(issue.target))) issues.push(issue);
+		}
+		if (Array.isArray(detail?.message)) visit(detail.message, nextSource, nextPath, nextCode, nextExplicit);
+		if (Array.isArray(detail?.messages)) visit(detail.messages, nextSource, nextPath, nextCode, nextExplicit);
+		if (!detail) return;
+		for (const [key, child] of Object.entries(detail)) {
+			if ([
+				"code",
+				"message",
+				"messages",
+				"status",
+				"data",
+				"param",
+				"path",
+				"key",
+				"field",
+				"group",
+				"location",
+				"details",
+				"params",
+				"additional_errors",
+				"errors"
+			].includes(key)) continue;
+			visit(child, nextSource ?? key, childPath(nextPath, key), nextCode);
+		}
+		for (const container of identity === detail ? [detail] : [detail, identity]) {
+			if (!container) continue;
+			for (const key of ["additional_errors", "errors"]) if (container[key] !== void 0) visit(container[key], nextSource, path.length ? path : nextPath, nextCode, path.length ? explicit : nextExplicit);
+			for (const key of ["details", "params"]) visitMap(container[key], nextSource, nextPath, nextCode, key === "params", nextExplicit);
+		}
+		if (identity !== detail && (typeof identity?.message === "string" || Array.isArray(identity?.message) || Array.isArray(identity?.messages))) visit(identity, source, nextPath, nextCode, nextExplicit);
+	}
+	function visitMap(value, source, path, code, params = false, explicit = false) {
+		if (!record(value)) {
+			if (typeof value === "string" || Array.isArray(value)) visit(value, source, path, code, explicit);
+			return;
+		}
+		for (const [name, child] of Object.entries(value)) {
+			const next = childPath(path, name);
+			const childSource = source ?? name;
+			if (params && typeof child === "string" && issues.some((issue) => issue.source === childSource && issue.message === child && (JSON.stringify(issue.sourcePath) === JSON.stringify(next) || next.length === 1))) continue;
+			visit(child, childSource, next, code);
+		}
+	}
+	if (Array.isArray(error.data)) visit(error.data, null, [], error.code);
+	else {
+		const keys = [
+			"code",
+			"message",
+			"messages",
+			"details",
+			"params",
+			"errors",
+			"additional_errors",
+			"param",
+			"path",
+			"key",
+			"field",
+			"group",
+			"location",
+			"data"
+		];
+		visit(Object.fromEntries(Object.entries(data).filter(([key]) => keys.includes(key))), null, [], error.code);
+	}
+	if (!issues.length) visit(error.message, null, [], error.code);
+	return { issues };
+}
+
+//#endregion
+export { CoreAddressFieldKeys as a, BillingFieldProjections as c, deserializeBillingFields as d, isExcludedRegisteredField as f, serializeBillingFields as h, checkoutValidationData as i, BillingNativeFields as l, resolveRegisteredFieldTarget as m, CheckoutValidationData as n, deserializeCoreAddress as o, isProjectedBillingField as p, CheckoutValidationIssue as r, serializeCoreAddress as s, CheckoutRegisteredFieldReference as t, BillingNativeInputFields as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kizlo/woocommerce",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "type": "module",
   "sideEffects": false,
   "description": "WooCommerce integration for Kizlo.",
@@ -35,6 +35,12 @@
         "default": "./dist/index.js"
       }
     },
+    "./checkout-validation": {
+      "import": {
+        "types": "./dist/checkout-validation.d.ts",
+        "default": "./dist/checkout-validation.js"
+      }
+    },
     "./test": {
       "import": {
         "types": "./dist/test.d.ts",