@ecomiq/core 0.1.8 → 1.0.0

package/dist/models/urls-Dt_dTt4Q.js

@@ -0,0 +1,33 @@
+import { CategoryDetailSchema } from "./categories-CKkJY8_P.js";
+import { ProductDetailSchema } from "./products.js";
+import { z } from "zod";
+// src/models/urls.ts
+const UrlResolutionSchema = z.discriminatedUnion("kind", [
+	z.object({
+		kind: z.literal("product"),
+		url: z.string(),
+		handle: z.string(),
+		product: ProductDetailSchema
+	}),
+	z.object({
+		kind: z.literal("category"),
+		url: z.string(),
+		handle: z.string(),
+		category: CategoryDetailSchema
+	}),
+	z.object({
+		kind: z.literal("redirect"),
+		url: z.string(),
+		handle: z.null()
+	})
+]);
+const SitemapItemSchema = z.object({
+	url: z.string(),
+	updatedOn: z.string().datetime({ offset: true }).nullable()
+});
+const SitemapPageSchema = z.object({
+	items: z.array(SitemapItemSchema),
+	nextPage: z.number().int().positive().nullable(),
+	totalPages: z.number().int().positive()
+});
+export { SitemapItemSchema, SitemapPageSchema, UrlResolutionSchema };

package/dist/models/urls.d.cts

@@ -0,0 +1,201 @@
+import { z } from "zod";
+export declare const UrlResolutionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  kind: z.ZodLiteral<"product">;
+  url: z.ZodString;
+  handle: z.ZodString;
+  product: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodString;
+    url: z.ZodString;
+    description: z.ZodString;
+    productType: z.ZodString;
+    status: z.ZodString;
+    imageUrl: z.ZodString;
+    price: z.ZodNumber;
+    compareAtPrice: z.ZodNullable<z.ZodNumber>;
+    isAvailable: z.ZodBoolean;
+    totalInventory: z.ZodNumber;
+    brand: z.ZodString;
+    category: z.ZodString;
+    categoryId: z.ZodNullable<z.ZodString>;
+    tags: z.ZodArray<z.ZodString>;
+    specifications: z.ZodArray<z.ZodObject<{
+      key: z.ZodString;
+      name: z.ZodString;
+      value: z.ZodString;
+      valueId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      valueName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      type: z.ZodOptional<z.ZodEnum<{
+        checkbox: "checkbox";
+        colorPicker: "colorPicker";
+        datePicker: "datePicker";
+        dateTimePicker: "dateTimePicker";
+        file: "file";
+        input: "input";
+        number: "number";
+        select: "select";
+        textArea: "textArea";
+        timePicker: "timePicker";
+        url: "url";
+      }>>;
+      color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      imageUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      unit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    variants: z.ZodArray<z.ZodObject<{
+      id: z.ZodNullable<z.ZodString>;
+      sku: z.ZodString;
+      status: z.ZodString;
+      price: z.ZodNumber;
+      compareAtPrice: z.ZodNullable<z.ZodNumber>;
+      quantity: z.ZodNumber;
+      isAvailable: z.ZodNullable<z.ZodBoolean>;
+      requiresShipping: z.ZodBoolean;
+      options: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        name: z.ZodString;
+        value: z.ZodString;
+        valueId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        valueName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        type: z.ZodOptional<z.ZodEnum<{
+          checkbox: "checkbox";
+          colorPicker: "colorPicker";
+          datePicker: "datePicker";
+          dateTimePicker: "dateTimePicker";
+          file: "file";
+          input: "input";
+          number: "number";
+          select: "select";
+          textArea: "textArea";
+          timePicker: "timePicker";
+          url: "url";
+        }>>;
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        imageUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        unit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      }, z.core.$strip>>;
+      images: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        name: z.ZodString;
+        order: z.ZodNumber;
+        type: z.ZodDefault<z.ZodCatch<z.ZodEnum<{
+          image: "image";
+          video: "video";
+        }>>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    images: z.ZodArray<z.ZodObject<{
+      url: z.ZodString;
+      name: z.ZodString;
+      order: z.ZodNumber;
+      type: z.ZodDefault<z.ZodCatch<z.ZodEnum<{
+        image: "image";
+        video: "video";
+      }>>>;
+    }, z.core.$strip>>;
+    bundleItems: z.ZodArray<z.ZodObject<{
+      productId: z.ZodString;
+      variantId: z.ZodString;
+      productName: z.ZodString;
+      variantName: z.ZodNullable<z.ZodString>;
+      sku: z.ZodNullable<z.ZodString>;
+      brand: z.ZodNullable<z.ZodString>;
+      imageUrl: z.ZodNullable<z.ZodString>;
+      quantity: z.ZodNumber;
+      available: z.ZodNumber;
+      allowBackorders: z.ZodBoolean;
+      requiresShipping: z.ZodBoolean;
+    }, z.core.$strip>>;
+    sizeGuide: z.ZodNullable<z.ZodObject<{
+      id: z.ZodString;
+      name: z.ZodString;
+      slug: z.ZodString;
+      description: z.ZodNullable<z.ZodString>;
+      imageUrl: z.ZodNullable<z.ZodString>;
+      gender: z.ZodString;
+      measurementType: z.ZodString;
+      unit: z.ZodString;
+      notes: z.ZodNullable<z.ZodString>;
+      rows: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        sizeKey: z.ZodString;
+        order: z.ZodNumber;
+        measurements: z.ZodArray<z.ZodObject<{
+          key: z.ZodString;
+          name: z.ZodString;
+          min: z.ZodNullable<z.ZodNumber>;
+          max: z.ZodNullable<z.ZodNumber>;
+          value: z.ZodNullable<z.ZodNumber>;
+          description: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    priceTiers: z.ZodArray<z.ZodObject<{
+      variantId: z.ZodString;
+      minQuantity: z.ZodNumber;
+      maxQuantity: z.ZodNullable<z.ZodNumber>;
+      unitPrice: z.ZodNumber;
+    }, z.core.$strip>>;
+    createdAt: z.ZodNullable<z.ZodString>;
+    updatedAt: z.ZodNullable<z.ZodString>;
+    seller: z.ZodNullable<z.ZodObject<{
+      id: z.ZodString;
+      name: z.ZodString;
+      slug: z.ZodString;
+    }, z.core.$strip>>;
+    isPreview: z.ZodDefault<z.ZodBoolean>;
+    template: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"category">;
+  url: z.ZodString;
+  handle: z.ZodString;
+  category: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodString;
+    url: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    imageUrl: z.ZodNullable<z.ZodString>;
+    metaTitle: z.ZodNullable<z.ZodString>;
+    metaDescription: z.ZodNullable<z.ZodString>;
+    parentId: z.ZodNullable<z.ZodString>;
+    productCount: z.ZodNumber;
+    ancestors: z.ZodArray<z.ZodObject<{
+      id: z.ZodString;
+      name: z.ZodString;
+      url: z.ZodString;
+    }, z.core.$strip>>;
+    children: z.ZodArray<z.ZodObject<{
+      id: z.ZodString;
+      name: z.ZodString;
+      slug: z.ZodString;
+      url: z.ZodString;
+      imageUrl: z.ZodNullable<z.ZodString>;
+      productCount: z.ZodNumber;
+    }, z.core.$strip>>;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"redirect">;
+  url: z.ZodString;
+  handle: z.ZodNull;
+}, z.core.$strip>], "kind">;
+export declare const SitemapItemSchema: z.ZodObject<{
+  url: z.ZodString;
+  updatedOn: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const SitemapPageSchema: z.ZodObject<{
+  items: z.ZodArray<z.ZodObject<{
+    url: z.ZodString;
+    updatedOn: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  nextPage: z.ZodNullable<z.ZodNumber>;
+  totalPages: z.ZodNumber;
+}, z.core.$strip>;
+export type UrlResolution = z.infer<typeof UrlResolutionSchema>;
+export type SitemapItem = z.infer<typeof SitemapItemSchema>;
+export type SitemapPage = z.infer<typeof SitemapPageSchema>;
+export interface UrlResolutionOptions {
+  previewKey?: string;
+}

package/dist/models/urls.d.ts

@@ -0,0 +1,201 @@
+import { z } from "zod";
+export declare const UrlResolutionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  kind: z.ZodLiteral<"product">;
+  url: z.ZodString;
+  handle: z.ZodString;
+  product: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodString;
+    url: z.ZodString;
+    description: z.ZodString;
+    productType: z.ZodString;
+    status: z.ZodString;
+    imageUrl: z.ZodString;
+    price: z.ZodNumber;
+    compareAtPrice: z.ZodNullable<z.ZodNumber>;
+    isAvailable: z.ZodBoolean;
+    totalInventory: z.ZodNumber;
+    brand: z.ZodString;
+    category: z.ZodString;
+    categoryId: z.ZodNullable<z.ZodString>;
+    tags: z.ZodArray<z.ZodString>;
+    specifications: z.ZodArray<z.ZodObject<{
+      key: z.ZodString;
+      name: z.ZodString;
+      value: z.ZodString;
+      valueId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      valueName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      type: z.ZodOptional<z.ZodEnum<{
+        checkbox: "checkbox";
+        colorPicker: "colorPicker";
+        datePicker: "datePicker";
+        dateTimePicker: "dateTimePicker";
+        file: "file";
+        input: "input";
+        number: "number";
+        select: "select";
+        textArea: "textArea";
+        timePicker: "timePicker";
+        url: "url";
+      }>>;
+      color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      imageUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      unit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    variants: z.ZodArray<z.ZodObject<{
+      id: z.ZodNullable<z.ZodString>;
+      sku: z.ZodString;
+      status: z.ZodString;
+      price: z.ZodNumber;
+      compareAtPrice: z.ZodNullable<z.ZodNumber>;
+      quantity: z.ZodNumber;
+      isAvailable: z.ZodNullable<z.ZodBoolean>;
+      requiresShipping: z.ZodBoolean;
+      options: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        name: z.ZodString;
+        value: z.ZodString;
+        valueId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        valueName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        type: z.ZodOptional<z.ZodEnum<{
+          checkbox: "checkbox";
+          colorPicker: "colorPicker";
+          datePicker: "datePicker";
+          dateTimePicker: "dateTimePicker";
+          file: "file";
+          input: "input";
+          number: "number";
+          select: "select";
+          textArea: "textArea";
+          timePicker: "timePicker";
+          url: "url";
+        }>>;
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        imageUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        unit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      }, z.core.$strip>>;
+      images: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        name: z.ZodString;
+        order: z.ZodNumber;
+        type: z.ZodDefault<z.ZodCatch<z.ZodEnum<{
+          image: "image";
+          video: "video";
+        }>>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    images: z.ZodArray<z.ZodObject<{
+      url: z.ZodString;
+      name: z.ZodString;
+      order: z.ZodNumber;
+      type: z.ZodDefault<z.ZodCatch<z.ZodEnum<{
+        image: "image";
+        video: "video";
+      }>>>;
+    }, z.core.$strip>>;
+    bundleItems: z.ZodArray<z.ZodObject<{
+      productId: z.ZodString;
+      variantId: z.ZodString;
+      productName: z.ZodString;
+      variantName: z.ZodNullable<z.ZodString>;
+      sku: z.ZodNullable<z.ZodString>;
+      brand: z.ZodNullable<z.ZodString>;
+      imageUrl: z.ZodNullable<z.ZodString>;
+      quantity: z.ZodNumber;
+      available: z.ZodNumber;
+      allowBackorders: z.ZodBoolean;
+      requiresShipping: z.ZodBoolean;
+    }, z.core.$strip>>;
+    sizeGuide: z.ZodNullable<z.ZodObject<{
+      id: z.ZodString;
+      name: z.ZodString;
+      slug: z.ZodString;
+      description: z.ZodNullable<z.ZodString>;
+      imageUrl: z.ZodNullable<z.ZodString>;
+      gender: z.ZodString;
+      measurementType: z.ZodString;
+      unit: z.ZodString;
+      notes: z.ZodNullable<z.ZodString>;
+      rows: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        sizeKey: z.ZodString;
+        order: z.ZodNumber;
+        measurements: z.ZodArray<z.ZodObject<{
+          key: z.ZodString;
+          name: z.ZodString;
+          min: z.ZodNullable<z.ZodNumber>;
+          max: z.ZodNullable<z.ZodNumber>;
+          value: z.ZodNullable<z.ZodNumber>;
+          description: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    priceTiers: z.ZodArray<z.ZodObject<{
+      variantId: z.ZodString;
+      minQuantity: z.ZodNumber;
+      maxQuantity: z.ZodNullable<z.ZodNumber>;
+      unitPrice: z.ZodNumber;
+    }, z.core.$strip>>;
+    createdAt: z.ZodNullable<z.ZodString>;
+    updatedAt: z.ZodNullable<z.ZodString>;
+    seller: z.ZodNullable<z.ZodObject<{
+      id: z.ZodString;
+      name: z.ZodString;
+      slug: z.ZodString;
+    }, z.core.$strip>>;
+    isPreview: z.ZodDefault<z.ZodBoolean>;
+    template: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"category">;
+  url: z.ZodString;
+  handle: z.ZodString;
+  category: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodString;
+    url: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    imageUrl: z.ZodNullable<z.ZodString>;
+    metaTitle: z.ZodNullable<z.ZodString>;
+    metaDescription: z.ZodNullable<z.ZodString>;
+    parentId: z.ZodNullable<z.ZodString>;
+    productCount: z.ZodNumber;
+    ancestors: z.ZodArray<z.ZodObject<{
+      id: z.ZodString;
+      name: z.ZodString;
+      url: z.ZodString;
+    }, z.core.$strip>>;
+    children: z.ZodArray<z.ZodObject<{
+      id: z.ZodString;
+      name: z.ZodString;
+      slug: z.ZodString;
+      url: z.ZodString;
+      imageUrl: z.ZodNullable<z.ZodString>;
+      productCount: z.ZodNumber;
+    }, z.core.$strip>>;
+  }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"redirect">;
+  url: z.ZodString;
+  handle: z.ZodNull;
+}, z.core.$strip>], "kind">;
+export declare const SitemapItemSchema: z.ZodObject<{
+  url: z.ZodString;
+  updatedOn: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const SitemapPageSchema: z.ZodObject<{
+  items: z.ZodArray<z.ZodObject<{
+    url: z.ZodString;
+    updatedOn: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  nextPage: z.ZodNullable<z.ZodNumber>;
+  totalPages: z.ZodNumber;
+}, z.core.$strip>;
+export type UrlResolution = z.infer<typeof UrlResolutionSchema>;
+export type SitemapItem = z.infer<typeof SitemapItemSchema>;
+export type SitemapPage = z.infer<typeof SitemapPageSchema>;
+export interface UrlResolutionOptions {
+  previewKey?: string;
+}

package/dist/redirects.cjs

@@ -0,0 +1,113 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let zod = require("zod");
+// src/redirects.ts
+const matchSchema = zod.z.object({ redirect: zod.z.object({
+	location: zod.z.string().min(1).max(2048),
+	statusCode: zod.z.union([zod.z.literal(301), zod.z.literal(302)]),
+	preserveQuery: zod.z.boolean()
+}).nullable() });
+const PRIVATE_STOREFRONT_SUBTREES = [
+	"account",
+	"checkout",
+	"cart",
+	"orders",
+	"drafts"
+];
+const protectedSubtrees = /* @__PURE__ */ new Set([
+	...PRIVATE_STOREFRONT_SUBTREES,
+	"thank-you",
+	"auth",
+	"track",
+	"review",
+	"api",
+	"_server",
+	"_build",
+	"assets",
+	"_ecomiq",
+	"__ecomiq",
+	".well-known"
+]);
+const protectedPaths = /* @__PURE__ */ new Set([
+	"login",
+	"register",
+	"demo",
+	"ping",
+	"robots.txt",
+	"sitemap.xml",
+	"favicon.ico"
+]);
+/** Exact, case-sensitive paths; trailing slash and equivalent escapes match. */
+function storefrontRedirectPath(input) {
+	const path = input.trim().replace(/\/+$/, "") || "/";
+	if (!path.startsWith("/") || path.startsWith("//") || /[\\?#\s\u0000-\u001f\u007f]/u.test(path)) return null;
+	if (path === "/") return path;
+	try {
+		return "/" + path.slice(1).split("/").map((segment) => {
+			const decoded = decodeURIComponent(segment);
+			if (!decoded || decoded === "." || decoded === ".." || /[/\\%\u0000-\u001f\u007f]/u.test(decoded)) throw new Error("Invalid path");
+			return encodeURIComponent(decoded).replace(/[!'()*]/g, (character) => "%" + character.charCodeAt(0).toString(16).toUpperCase());
+		}).join("/");
+	} catch {
+		return null;
+	}
+}
+function isStorefrontRedirectSource(path) {
+	const canonical = storefrontRedirectPath(path);
+	if (canonical === null || canonical === "/") return false;
+	let segments = canonical.slice(1).toLowerCase().split("/");
+	if (segments.length > 1 && /^[a-z]{2}(?:-[a-z]{2})?$/.test(segments[0])) segments = segments.slice(1);
+	return !protectedSubtrees.has(segments[0]) && !(segments.length === 1 && protectedPaths.has(segments[0]));
+}
+function storefrontRedirectLocation(requestUrl, location, preserveQuery) {
+	if (/[\\\s\u0000-\u001f\u007f]/u.test(location) || /%0[ad]/i.test(location)) return null;
+	const local = location.startsWith("/") && !location.startsWith("//");
+	if (!local && !location.startsWith("https://")) return null;
+	try {
+		const target = new URL(location, requestUrl);
+		if (target.username || target.password || !local && target.protocol !== "https:") return null;
+		if (storefrontRedirectPath(local ? location.split(/[?#]/)[0] : location.slice(8).replace(/^[^/?#]+/, "").split(/[?#]/)[0] || "/") === null) return null;
+		if (target.origin === requestUrl.origin && storefrontRedirectPath(target.pathname) === storefrontRedirectPath(requestUrl.pathname)) return null;
+		if (preserveQuery) {
+			const explicit = new Set(target.searchParams.keys());
+			for (const [key, value] of requestUrl.searchParams) if (!explicit.has(key)) target.searchParams.append(key, value);
+		}
+		return local ? `${target.pathname}${target.search}${target.hash}` : target.href;
+	} catch {
+		return null;
+	}
+}
+/** Resolve before rendering. Redirect responses and lookups never enter HTML caches. */
+async function redirectStorefrontRequest(request, options) {
+	const url = new URL(request.url);
+	if (!["GET", "HEAD"].includes(request.method) || !isStorefrontRedirectSource(url.pathname)) return null;
+	const endpoint = new URL("v1/redirects/resolve", options.apiBaseUrl.replace(/\/v1\/?$/, "").replace(/\/?$/, "/"));
+	endpoint.searchParams.set("path", url.pathname);
+	const response = await (options.fetch ?? fetch)(endpoint, {
+		headers: {
+			accept: "application/json",
+			"x-Store-Domain": options.storeDomain
+		},
+		cache: "no-store",
+		redirect: "manual",
+		signal: AbortSignal.timeout(3e3)
+	});
+	if (response.type === "opaqueredirect" || response.status >= 300 && response.status < 400) throw new Error(`Storefront redirect lookup was redirected (HTTP ${response.status})`);
+	if (response.status === 404) return null;
+	if (!response.ok) throw new Error(`Storefront redirect lookup failed (HTTP ${response.status})`);
+	const { redirect } = matchSchema.parse(await response.json());
+	if (redirect === null) return null;
+	const location = storefrontRedirectLocation(url, redirect.location, redirect.preserveQuery);
+	if (location === null) throw new Error("Invalid storefront redirect target");
+	return new Response(null, {
+		status: redirect.statusCode,
+		headers: {
+			location,
+			"cache-control": "no-store"
+		}
+	});
+}
+exports.PRIVATE_STOREFRONT_SUBTREES = PRIVATE_STOREFRONT_SUBTREES;
+exports.isStorefrontRedirectSource = isStorefrontRedirectSource;
+exports.redirectStorefrontRequest = redirectStorefrontRequest;
+exports.storefrontRedirectLocation = storefrontRedirectLocation;
+exports.storefrontRedirectPath = storefrontRedirectPath;

package/dist/redirects.d.cts

@@ -0,0 +1,11 @@
+export declare const PRIVATE_STOREFRONT_SUBTREES: readonly ['account', 'checkout', 'cart', 'orders', 'drafts'];
+/** Exact, case-sensitive paths; trailing slash and equivalent escapes match. */
+export declare function storefrontRedirectPath(input: string): string | null;
+export declare function isStorefrontRedirectSource(path: string): boolean;
+export declare function storefrontRedirectLocation(requestUrl: URL, location: string, preserveQuery: boolean): string | null;
+/** Resolve before rendering. Redirect responses and lookups never enter HTML caches. */
+export declare function redirectStorefrontRequest(request: Request, options: {
+  apiBaseUrl: string;
+  storeDomain: string;
+  fetch?: typeof fetch;
+}): Promise<Response | null>;

package/dist/redirects.d.ts

@@ -0,0 +1,11 @@
+export declare const PRIVATE_STOREFRONT_SUBTREES: readonly ['account', 'checkout', 'cart', 'orders', 'drafts'];
+/** Exact, case-sensitive paths; trailing slash and equivalent escapes match. */
+export declare function storefrontRedirectPath(input: string): string | null;
+export declare function isStorefrontRedirectSource(path: string): boolean;
+export declare function storefrontRedirectLocation(requestUrl: URL, location: string, preserveQuery: boolean): string | null;
+/** Resolve before rendering. Redirect responses and lookups never enter HTML caches. */
+export declare function redirectStorefrontRequest(request: Request, options: {
+  apiBaseUrl: string;
+  storeDomain: string;
+  fetch?: typeof fetch;
+}): Promise<Response | null>;

package/dist/redirects.js

@@ -0,0 +1,108 @@
+import { z } from "zod";
+// src/redirects.ts
+const matchSchema = z.object({ redirect: z.object({
+	location: z.string().min(1).max(2048),
+	statusCode: z.union([z.literal(301), z.literal(302)]),
+	preserveQuery: z.boolean()
+}).nullable() });
+const PRIVATE_STOREFRONT_SUBTREES = [
+	"account",
+	"checkout",
+	"cart",
+	"orders",
+	"drafts"
+];
+const protectedSubtrees = /* @__PURE__ */ new Set([
+	...PRIVATE_STOREFRONT_SUBTREES,
+	"thank-you",
+	"auth",
+	"track",
+	"review",
+	"api",
+	"_server",
+	"_build",
+	"assets",
+	"_ecomiq",
+	"__ecomiq",
+	".well-known"
+]);
+const protectedPaths = /* @__PURE__ */ new Set([
+	"login",
+	"register",
+	"demo",
+	"ping",
+	"robots.txt",
+	"sitemap.xml",
+	"favicon.ico"
+]);
+/** Exact, case-sensitive paths; trailing slash and equivalent escapes match. */
+function storefrontRedirectPath(input) {
+	const path = input.trim().replace(/\/+$/, "") || "/";
+	if (!path.startsWith("/") || path.startsWith("//") || /[\\?#\s\u0000-\u001f\u007f]/u.test(path)) return null;
+	if (path === "/") return path;
+	try {
+		return "/" + path.slice(1).split("/").map((segment) => {
+			const decoded = decodeURIComponent(segment);
+			if (!decoded || decoded === "." || decoded === ".." || /[/\\%\u0000-\u001f\u007f]/u.test(decoded)) throw new Error("Invalid path");
+			return encodeURIComponent(decoded).replace(/[!'()*]/g, (character) => "%" + character.charCodeAt(0).toString(16).toUpperCase());
+		}).join("/");
+	} catch {
+		return null;
+	}
+}
+function isStorefrontRedirectSource(path) {
+	const canonical = storefrontRedirectPath(path);
+	if (canonical === null || canonical === "/") return false;
+	let segments = canonical.slice(1).toLowerCase().split("/");
+	if (segments.length > 1 && /^[a-z]{2}(?:-[a-z]{2})?$/.test(segments[0])) segments = segments.slice(1);
+	return !protectedSubtrees.has(segments[0]) && !(segments.length === 1 && protectedPaths.has(segments[0]));
+}
+function storefrontRedirectLocation(requestUrl, location, preserveQuery) {
+	if (/[\\\s\u0000-\u001f\u007f]/u.test(location) || /%0[ad]/i.test(location)) return null;
+	const local = location.startsWith("/") && !location.startsWith("//");
+	if (!local && !location.startsWith("https://")) return null;
+	try {
+		const target = new URL(location, requestUrl);
+		if (target.username || target.password || !local && target.protocol !== "https:") return null;
+		if (storefrontRedirectPath(local ? location.split(/[?#]/)[0] : location.slice(8).replace(/^[^/?#]+/, "").split(/[?#]/)[0] || "/") === null) return null;
+		if (target.origin === requestUrl.origin && storefrontRedirectPath(target.pathname) === storefrontRedirectPath(requestUrl.pathname)) return null;
+		if (preserveQuery) {
+			const explicit = new Set(target.searchParams.keys());
+			for (const [key, value] of requestUrl.searchParams) if (!explicit.has(key)) target.searchParams.append(key, value);
+		}
+		return local ? `${target.pathname}${target.search}${target.hash}` : target.href;
+	} catch {
+		return null;
+	}
+}
+/** Resolve before rendering. Redirect responses and lookups never enter HTML caches. */
+async function redirectStorefrontRequest(request, options) {
+	const url = new URL(request.url);
+	if (!["GET", "HEAD"].includes(request.method) || !isStorefrontRedirectSource(url.pathname)) return null;
+	const endpoint = new URL("v1/redirects/resolve", options.apiBaseUrl.replace(/\/v1\/?$/, "").replace(/\/?$/, "/"));
+	endpoint.searchParams.set("path", url.pathname);
+	const response = await (options.fetch ?? fetch)(endpoint, {
+		headers: {
+			accept: "application/json",
+			"x-Store-Domain": options.storeDomain
+		},
+		cache: "no-store",
+		redirect: "manual",
+		signal: AbortSignal.timeout(3e3)
+	});
+	if (response.type === "opaqueredirect" || response.status >= 300 && response.status < 400) throw new Error(`Storefront redirect lookup was redirected (HTTP ${response.status})`);
+	if (response.status === 404) return null;
+	if (!response.ok) throw new Error(`Storefront redirect lookup failed (HTTP ${response.status})`);
+	const { redirect } = matchSchema.parse(await response.json());
+	if (redirect === null) return null;
+	const location = storefrontRedirectLocation(url, redirect.location, redirect.preserveQuery);
+	if (location === null) throw new Error("Invalid storefront redirect target");
+	return new Response(null, {
+		status: redirect.statusCode,
+		headers: {
+			location,
+			"cache-control": "no-store"
+		}
+	});
+}
+export { PRIVATE_STOREFRONT_SUBTREES, isStorefrontRedirectSource, redirectStorefrontRequest, storefrontRedirectLocation, storefrontRedirectPath };