@shop-on/theme-routes 0.2.0 → 0.4.0

package/dist/adapter.d.ts

@@ -195,6 +195,21 @@ export interface AccountSeam {
     url: string;
   }>;
 }
+export interface CheckoutSeam {
+  /** The theme's cart → checkout server fn: without `state`, checkout's
+   * `/begin` URL; with the `checkout_state` it sent back, a minted handoff. */
+  startCheckoutFn(opts: {
+    data: {
+      state?: string;
+    };
+  }): Promise<{
+    ok: true;
+    redirectTo: string;
+  } | {
+    ok: false;
+    reason: string;
+  }>;
+}
 export interface PreviewSeam {
   /** Rendered when there is nothing to preview, or when the section throws. */
   Unavailable: ComponentType;
@@ -211,6 +226,7 @@ export interface ThemeRouteAdapter extends RendererSeam, I18nSeam {
   fns: TemplateFns;
   parsers: SearchParsers;
   account: AccountSeam;
+  checkout: CheckoutSeam;
   preview: PreviewSeam;
 }
 //#endregion

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { DepsArg, HeadArg, LoaderArg, NullableHeadArg, NullableTemplateRouteOptions, ParsedBlogSearch, ParsedListingSearch, PreviewDeps, SeoHeadResult, ServerRouteHandler, TemplateRouteOptions } from "./types.js";
-import { AccountSeam, ArticleTemplateArgs, BlogPageTemplateArgs, BlogSearchSeam, CollectionPageTemplateArgs, CollectionSearchSeam, CollectionsTemplateArgs, HomeTemplateArgs, I18nSeam, PageTemplateArgs, PasswordTemplateArgs, PolicyTemplateArgs, PreviewSeam, ProductSearchSeam, ProductTemplateArgs, RendererSeam, SearchPageTemplateArgs, SearchParsers, SectionPreviewArgs, SeoSeam, TemplateByIdArgs, TemplateFn, TemplateFns, ThemeRouteAdapter } from "./adapter.js";
+import { AccountSeam, ArticleTemplateArgs, BlogPageTemplateArgs, BlogSearchSeam, CheckoutSeam, CollectionPageTemplateArgs, CollectionSearchSeam, CollectionsTemplateArgs, HomeTemplateArgs, I18nSeam, PageTemplateArgs, PasswordTemplateArgs, PolicyTemplateArgs, PreviewSeam, ProductSearchSeam, ProductTemplateArgs, RendererSeam, SearchPageTemplateArgs, SearchParsers, SectionPreviewArgs, SeoSeam, TemplateByIdArgs, TemplateFn, TemplateFns, ThemeRouteAdapter } from "./adapter.js";
 import { templatePreloadLinks } from "./preload-links.js";
 import { SeoHelpers, SeoHelpersOptions, createSeoHelpers, isPreviewSearch, paginatedPath } from "./seo-head.js";
 import { ThemeRouterOptions, createThemeRouter } from "./router.js";
@@ -7,6 +7,7 @@ import { useOptionalTemplate, useTemplate } from "./use-template.js";
 import { accountBounceOptions, accountIndexRouteOptions } from "./routes/account.js";
 import { articleRouteOptions, blogRouteOptions } from "./routes/blog.js";
 import { cartRouteOptions } from "./routes/cart.js";
+import { checkoutRouteOptions } from "./routes/checkout.js";
 import { collectionRouteOptions, collectionsIndexRouteOptions } from "./routes/collection.js";
 import { homeRouteOptions } from "./routes/home.js";
 import { localeLayoutRouteOptions } from "./routes/locale-layout.js";
@@ -26,4 +27,4 @@ import { analyticsEventsHandler, analyticsVisitsHandler } from "./routes/server/
 import { analyticsScriptHandler } from "./routes/server/analytics-script.js";
 import { customerLogoutHandler } from "./routes/server/customer-logout.js";
 import { robotsHandler, sitemapHandler } from "./routes/server/seo-proxy.js";
-export { type AccountSeam, type ArticleTemplateArgs, type BlogPageTemplateArgs, type BlogSearchSeam, type CollectionPageTemplateArgs, type CollectionSearchSeam, type CollectionsTemplateArgs, type DepsArg, type HeadArg, type HomeTemplateArgs, type I18nSeam, type LoaderArg, type NullableHeadArg, type NullableTemplateRouteOptions, type PageTemplateArgs, type ParsedBlogSearch, type ParsedListingSearch, type PasswordTemplateArgs, type PolicyTemplateArgs, type PreviewDeps, type PreviewSeam, type ProductSearchSeam, type ProductTemplateArgs, type RendererSeam, type SearchPageTemplateArgs, type SearchParsers, type SectionPreviewArgs, type SeoHeadResult, type SeoHelpers, type SeoHelpersOptions, type SeoSeam, type ServerRouteHandler, type TemplateByIdArgs, type TemplateFn, type TemplateFns, type TemplateRouteOptions, type ThemeRouteAdapter, type ThemeRouterOptions, accountBounceOptions, accountIndexRouteOptions, analyticsEventsHandler, analyticsScriptHandler, analyticsVisitsHandler, articleRouteComponent, articleRouteOptions, blogRouteOptions, cartRouteOptions, collectionProductRouteOptions, collectionRouteOptions, collectionsIndexRouteOptions, createSeoHelpers, createThemeRouter, customerLogoutHandler, homeRouteComponent, homeRouteOptions, isPreviewSearch, localeLayoutComponent, localeLayoutRouteOptions, notFoundRouteOptions, optionalTemplatePageComponent, pageRouteOptions, paginatedPath, passwordRouteOptions, policyRouteOptions, productRouteComponent, productRouteOptions, robotsHandler, searchRouteOptions, sectionPreviewErrorComponent, sectionPreviewRouteComponent, sectionPreviewRouteOptions, sitemapHandler, templatePageComponent, templatePreloadLinks, useOptionalTemplate, useTemplate };
+export { type AccountSeam, type ArticleTemplateArgs, type BlogPageTemplateArgs, type BlogSearchSeam, type CheckoutSeam, type CollectionPageTemplateArgs, type CollectionSearchSeam, type CollectionsTemplateArgs, type DepsArg, type HeadArg, type HomeTemplateArgs, type I18nSeam, type LoaderArg, type NullableHeadArg, type NullableTemplateRouteOptions, type PageTemplateArgs, type ParsedBlogSearch, type ParsedListingSearch, type PasswordTemplateArgs, type PolicyTemplateArgs, type PreviewDeps, type PreviewSeam, type ProductSearchSeam, type ProductTemplateArgs, type RendererSeam, type SearchPageTemplateArgs, type SearchParsers, type SectionPreviewArgs, type SeoHeadResult, type SeoHelpers, type SeoHelpersOptions, type SeoSeam, type ServerRouteHandler, type TemplateByIdArgs, type TemplateFn, type TemplateFns, type TemplateRouteOptions, type ThemeRouteAdapter, type ThemeRouterOptions, accountBounceOptions, accountIndexRouteOptions, analyticsEventsHandler, analyticsScriptHandler, analyticsVisitsHandler, articleRouteComponent, articleRouteOptions, blogRouteOptions, cartRouteOptions, checkoutRouteOptions, collectionProductRouteOptions, collectionRouteOptions, collectionsIndexRouteOptions, createSeoHelpers, createThemeRouter, customerLogoutHandler, homeRouteComponent, homeRouteOptions, isPreviewSearch, localeLayoutComponent, localeLayoutRouteOptions, notFoundRouteOptions, optionalTemplatePageComponent, pageRouteOptions, paginatedPath, passwordRouteOptions, policyRouteOptions, productRouteComponent, productRouteOptions, robotsHandler, searchRouteOptions, sectionPreviewErrorComponent, sectionPreviewRouteComponent, sectionPreviewRouteOptions, sitemapHandler, templatePageComponent, templatePreloadLinks, useOptionalTemplate, useTemplate };

package/dist/index.js

@@ -5,6 +5,7 @@ import { useOptionalTemplate, useTemplate } from "./use-template.js";
 import { accountBounceOptions, accountIndexRouteOptions } from "./routes/account.js";
 import { articleRouteOptions, blogRouteOptions } from "./routes/blog.js";
 import { cartRouteOptions } from "./routes/cart.js";
+import { checkoutRouteOptions } from "./routes/checkout.js";
 import { collectionRouteOptions, collectionsIndexRouteOptions } from "./routes/collection.js";
 import { homeRouteOptions } from "./routes/home.js";
 import { localeLayoutRouteOptions } from "./routes/locale-layout.js";
@@ -24,4 +25,4 @@ import { analyticsEventsHandler, analyticsVisitsHandler } from "./routes/server/
 import { analyticsScriptHandler } from "./routes/server/analytics-script.js";
 import { customerLogoutHandler } from "./routes/server/customer-logout.js";
 import { robotsHandler, sitemapHandler } from "./routes/server/seo-proxy.js";
-export { accountBounceOptions, accountIndexRouteOptions, analyticsEventsHandler, analyticsScriptHandler, analyticsVisitsHandler, articleRouteComponent, articleRouteOptions, blogRouteOptions, cartRouteOptions, collectionProductRouteOptions, collectionRouteOptions, collectionsIndexRouteOptions, createSeoHelpers, createThemeRouter, customerLogoutHandler, homeRouteComponent, homeRouteOptions, isPreviewSearch, localeLayoutComponent, localeLayoutRouteOptions, notFoundRouteOptions, optionalTemplatePageComponent, pageRouteOptions, paginatedPath, passwordRouteOptions, policyRouteOptions, productRouteComponent, productRouteOptions, robotsHandler, searchRouteOptions, sectionPreviewErrorComponent, sectionPreviewRouteComponent, sectionPreviewRouteOptions, sitemapHandler, templatePageComponent, templatePreloadLinks, useOptionalTemplate, useTemplate };
+export { accountBounceOptions, accountIndexRouteOptions, analyticsEventsHandler, analyticsScriptHandler, analyticsVisitsHandler, articleRouteComponent, articleRouteOptions, blogRouteOptions, cartRouteOptions, checkoutRouteOptions, collectionProductRouteOptions, collectionRouteOptions, collectionsIndexRouteOptions, createSeoHelpers, createThemeRouter, customerLogoutHandler, homeRouteComponent, homeRouteOptions, isPreviewSearch, localeLayoutComponent, localeLayoutRouteOptions, notFoundRouteOptions, optionalTemplatePageComponent, pageRouteOptions, paginatedPath, passwordRouteOptions, policyRouteOptions, productRouteComponent, productRouteOptions, robotsHandler, searchRouteOptions, sectionPreviewErrorComponent, sectionPreviewRouteComponent, sectionPreviewRouteOptions, sitemapHandler, templatePageComponent, templatePreloadLinks, useOptionalTemplate, useTemplate };

package/dist/routes/checkout.d.ts

@@ -0,0 +1,25 @@
+import { CheckoutSeam } from "../adapter.js";
+import { PreviewSearch } from "@shop-on/theme-react/preview-guard";
+//#region src/routes/checkout.d.ts
+interface CheckoutSearch extends PreviewSearch {
+  checkout_state?: string;
+}
+/**
+ * `/checkout`: a server-side bounce, twice. First visit (no `checkout_state`):
+ * off to the central checkout's `/begin`, which binds this browser and sends
+ * the buyer back here with a state. Second visit: mint the cart handoff with
+ * that state and go to checkout. Never renders, and never on a URL holding a
+ * state: any failure goes home. From `beforeLoad`, like the account bouncers,
+ * so the root loader's fan-out never runs for a redirect.
+ */
+export declare function checkoutRouteOptions(adapter: CheckoutSeam): {
+  validateSearch: (search: Record<string, unknown>) => CheckoutSearch;
+  beforeLoad: ({ params, search }: {
+    params: {
+      locale?: string;
+    };
+    search: CheckoutSearch;
+  }) => Promise<never>;
+};
+//#endregion
+export {};

package/dist/routes/checkout.js

@@ -0,0 +1,34 @@
+import { redirect } from "@tanstack/react-router";
+import { bouncePreviewToNotFound } from "@shop-on/theme-react/preview-guard";
+//#region src/routes/checkout.ts
+/**
+* `/checkout`: a server-side bounce, twice. First visit (no `checkout_state`):
+* off to the central checkout's `/begin`, which binds this browser and sends
+* the buyer back here with a state. Second visit: mint the cart handoff with
+* that state and go to checkout. Never renders, and never on a URL holding a
+* state: any failure goes home. From `beforeLoad`, like the account bouncers,
+* so the root loader's fan-out never runs for a redirect.
+*/
+function checkoutRouteOptions(adapter) {
+	return {
+		validateSearch: (search) => ({
+			preview: typeof search.preview === "string" ? search.preview : void 0,
+			checkout_state: typeof search.checkout_state === "string" ? search.checkout_state : void 0
+		}),
+		beforeLoad: async ({ params, search }) => {
+			bouncePreviewToNotFound(search);
+			const result = await adapter.startCheckoutFn({ data: { state: search.checkout_state } }).catch((err) => {
+				console.warn("[checkout] handoff failed:", err);
+				return null;
+			});
+			if (!result?.ok) throw redirect({
+				to: "/{-$locale}",
+				params: { locale: params.locale },
+				search: { preview: void 0 }
+			});
+			throw redirect({ href: result.redirectTo });
+		}
+	};
+}
+//#endregion
+export { checkoutRouteOptions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shop-on/theme-routes",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "license": "SEE LICENSE IN dist/LICENSE.md",
   "files": [
     "dist"
@@ -17,8 +17,8 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@shop-on/theme-react": "0.2.0",
-    "@shop-on/theme-runtime": "0.2.0"
+    "@shop-on/theme-react": "0.4.0",
+    "@shop-on/theme-runtime": "0.4.0"
   },
   "devDependencies": {
     "@bprogress/core": "1.3.4",