@ecomiq/storefront 2.1.3 → 3.0.0

package/src/server.ts

@@ -1,301 +0,0 @@
-/**
- * API storefront que solo corre en el servidor (TanStack Start RPC).
- * En SSR ejecuta el handler localmente; en el cliente llama al Worker.
- *
- * ```ts
- * import { definePage, serverApi } from '@ecomiq/storefront'
- *
- * export default definePage({
- *   loader: () => serverApi.getProducts({ page: 1, pageSize: 12 }),
- *   component: ({ data }) => …,
- * })
- * ```
- *
- * Nota: cada `createServerFn` debe vivir en el top-level del módulo
- * (el compilador de Start asigna IDs estables por call-site).
- * El cliente storefront es singleton → el cache de settings se reutiliza.
- */
-import { createServerFn } from '@tanstack/react-start'
-import {
-  AddCartItemParamsSchema,
-  CartAddressesParamsSchema,
-  CartBuyerParamsSchema,
-  CartCheckoutParamsSchema,
-  CartCheckoutReadParamsSchema,
-  CartPromotionCodeParamsSchema,
-  CreateProductReviewParamsSchema,
-  GetCartParamsSchema,
-  GetDepartmentsParamsSchema,
-  GetDistrictsParamsSchema,
-  GetProvincesParamsSchema,
-  GetShippingOptionsParamsSchema,
-  ListProductReviewsParamsSchema,
-  ProductAutocompleteParamsSchema,
-  ProductDetailParamsSchema,
-  ProductsParamsSchema,
-  PutShippingMethodParamsSchema,
-  RelatedProductsParamsSchema,
-  RemoveCartItemParamsSchema,
-  UpdateCartItemQuantityParamsSchema,
-  type AddCartItemParams,
-  type CartAddressesParams,
-  type CartBuyerParams,
-  type CartCheckoutParams,
-  type CartCheckoutReadParams,
-  type CartPromotionCodeParams,
-  type CreateProductReviewParams,
-  type GetCartParams,
-  type GetDepartmentsParams,
-  type GetDistrictsParams,
-  type GetProvincesParams,
-  type GetShippingOptionsParams,
-  type ListProductReviewsParams,
-  type ProductAutocompleteParams,
-  type ProductDetailParams,
-  type ProductsParamsInput,
-  type PutShippingMethodParams,
-  type RelatedProductsParams,
-  type RemoveCartItemParams,
-  type UpdateCartItemQuantityParams,
-  type UploadPaymentReceiptParams,
-  CartTokenSchema,
-  EntityIdSchema,
-} from '@ecomiq/core'
-import { z } from 'zod'
-import { getStorefrontClient } from './client'
-import {
-  loadActiveCart,
-  submitCartItemQuantity,
-  submitCartItemRemoval,
-  submitProductToCart,
-  type AddProductToCartInput,
-} from './cart-session'
-import { submitProductReview } from './review-submission'
-import {
-  loadActiveStorefrontHome,
-  loadActiveStorefrontPage,
-} from './storefront-runtime'
-
-const getSettingsFn = createServerFn({ method: 'GET' }).handler(() =>
-  getStorefrontClient().getSettings(),
-)
-
-const getActiveStorefrontHomeFn = createServerFn({ method: 'GET' }).handler(
-  () => loadActiveStorefrontHome(),
-)
-
-const getActiveStorefrontPageFn = createServerFn({ method: 'GET' })
-  .validator(z.object({ pathname: z.string().min(1).max(2_048) }))
-  .handler(({ data }) => loadActiveStorefrontPage(data.pathname))
-
-const getStoreIdFn = createServerFn({ method: 'GET' }).handler(() =>
-  getStorefrontClient().getStoreId(),
-)
-
-const getCollectionsFn = createServerFn({ method: 'GET' }).handler(() =>
-  getStorefrontClient().getCollections(),
-)
-
-const getCollectionBySlugFn = createServerFn({ method: 'GET' })
-  .validator(z.object({ slug: z.string().min(1) }))
-  .handler(({ data }) => getStorefrontClient().getCollectionBySlug(data.slug))
-
-const getPageBySlugFn = createServerFn({ method: 'GET' })
-  .validator(z.object({ slug: z.string().min(1) }))
-  .handler(({ data }) => getStorefrontClient().getPageBySlug(data.slug))
-
-const getProductsFn = createServerFn({ method: 'GET' })
-  .validator(ProductsParamsSchema)
-  .handler(({ data }) => getStorefrontClient().getProducts(data))
-
-const ProductBySlugServerParamsSchema = ProductDetailParamsSchema.extend({
-  slug: z.string().min(1),
-})
-
-const getProductBySlugFn = createServerFn({ method: 'GET' })
-  .validator(ProductBySlugServerParamsSchema)
-  .handler(({ data }) =>
-    getStorefrontClient().getProductBySlug(data.slug, { sellerId: data.sellerId }),
-  )
-
-const getRelatedProductsFn = createServerFn({ method: 'GET' })
-  .validator(RelatedProductsParamsSchema)
-  .handler(({ data }) => getStorefrontClient().getRelatedProducts(data))
-
-const autocompleteProductsFn = createServerFn({ method: 'GET' })
-  .validator(ProductAutocompleteParamsSchema)
-  .handler(({ data }) => getStorefrontClient().autocompleteProducts(data))
-
-const listProductReviewsFn = createServerFn({ method: 'GET' })
-  .validator(ListProductReviewsParamsSchema)
-  .handler(({ data }) => getStorefrontClient().listProductReviews(data))
-
-const submitProductReviewFn = createServerFn({ method: 'POST' })
-  .validator(CreateProductReviewParamsSchema)
-  .handler(({ data }) => submitProductReview(getStorefrontClient(), data))
-
-const loadCartFn = createServerFn({ method: 'POST' })
-  .validator(GetCartParamsSchema)
-  .handler(({ data }) => loadActiveCart(getStorefrontClient(), data))
-
-const setCartItemQuantityFn = createServerFn({ method: 'POST' })
-  .validator(UpdateCartItemQuantityParamsSchema)
-  .handler(({ data }) => submitCartItemQuantity(getStorefrontClient(), data))
-
-const removeCartItemFn = createServerFn({ method: 'POST' })
-  .validator(RemoveCartItemParamsSchema)
-  .handler(({ data }) => submitCartItemRemoval(getStorefrontClient(), data))
-
-const AddProductToCartServerSchema = z.object({
-  cartToken: CartTokenSchema.optional(),
-  currencyCode: z.string().length(3),
-  variantId: EntityIdSchema,
-  quantity: z.number().int().positive(),
-})
-
-const addProductToCartFn = createServerFn({ method: 'POST' })
-  .validator(AddProductToCartServerSchema)
-  .handler(({ data }) => submitProductToCart(getStorefrontClient(), data))
-
-const addCartItemFn = createServerFn({ method: 'POST' })
-  .validator(AddCartItemParamsSchema)
-  .handler(({ data }) => getStorefrontClient().addCartItem(data))
-
-const getCartCheckoutFn = createServerFn({ method: 'GET' })
-  .validator(CartCheckoutReadParamsSchema)
-  .handler(({ data }) => getStorefrontClient().getCartCheckout(data))
-
-const getShippingOptionsFn = createServerFn({ method: 'GET' })
-  .validator(GetShippingOptionsParamsSchema)
-  .handler(({ data }) => getStorefrontClient().getShippingOptions(data))
-
-const putCartShippingMethodFn = createServerFn({ method: 'POST' })
-  .validator(PutShippingMethodParamsSchema)
-  .handler(({ data }) => getStorefrontClient().putCartShippingMethod(data))
-
-const patchCartBuyerFn = createServerFn({ method: 'POST' })
-  .validator(CartBuyerParamsSchema)
-  .handler(({ data }) => getStorefrontClient().patchCartBuyer(data))
-
-const patchCartAddressesFn = createServerFn({ method: 'POST' })
-  .validator(CartAddressesParamsSchema)
-  .handler(({ data }) => getStorefrontClient().patchCartAddresses(data))
-
-const checkoutCartFn = createServerFn({ method: 'POST' })
-  .validator(CartCheckoutParamsSchema)
-  .handler(({ data }) => getStorefrontClient().checkoutCart(data))
-
-const CartPaymentReceiptServerSchema = z.object({
-  cartToken: CartTokenSchema,
-  fileBase64: z.string().min(1),
-  fileName: z.string().min(1),
-  mimeType: z.string().min(1).optional(),
-})
-
-const uploadPaymentReceiptFn = createServerFn({ method: 'POST' })
-  .validator(CartPaymentReceiptServerSchema)
-  .handler(({ data }) => {
-    const binary = Uint8Array.from(atob(data.fileBase64), (c) => c.charCodeAt(0))
-    const file = new Blob([binary], { type: data.mimeType ?? 'application/octet-stream' })
-    return getStorefrontClient().uploadPaymentReceipt({
-      cartToken: data.cartToken,
-      file,
-      fileName: data.fileName,
-    })
-  })
-
-const addCartPromotionCodeFn = createServerFn({ method: 'POST' })
-  .validator(CartPromotionCodeParamsSchema)
-  .handler(({ data }) => getStorefrontClient().addCartPromotionCode(data))
-
-const removeCartPromotionCodeFn = createServerFn({ method: 'POST' })
-  .validator(CartPromotionCodeParamsSchema)
-  .handler(({ data }) => getStorefrontClient().removeCartPromotionCode(data))
-
-const getCountriesFn = createServerFn({ method: 'GET' }).handler(() =>
-  getStorefrontClient().getCountries(),
-)
-
-const getDepartmentsFn = createServerFn({ method: 'GET' })
-  .validator(GetDepartmentsParamsSchema)
-  .handler(({ data }) => getStorefrontClient().getDepartments(data))
-
-const getProvincesFn = createServerFn({ method: 'GET' })
-  .validator(GetProvincesParamsSchema)
-  .handler(({ data }) => getStorefrontClient().getProvinces(data))
-
-const getDistrictsFn = createServerFn({ method: 'GET' })
-  .validator(GetDistrictsParamsSchema)
-  .handler(({ data }) => getStorefrontClient().getDistricts(data))
-
-/**
- * Cliente storefront server-only. Misma superficie útil que `createClient()`,
- * pero cada método es una server function reutilizable desde cualquier página.
- */
-export const serverApi = {
-  getSettings: () => getSettingsFn(),
-  getActiveStorefrontHome: () => getActiveStorefrontHomeFn(),
-  getActiveStorefrontPage: (pathname: string) =>
-    getActiveStorefrontPageFn({ data: { pathname } }),
-  getStoreId: () => getStoreIdFn(),
-  getCollections: () => getCollectionsFn(),
-  getCollectionBySlug: (slug: string) => getCollectionBySlugFn({ data: { slug } }),
-  getPageBySlug: (slug: string) => getPageBySlugFn({ data: { slug } }),
-  getProducts: (
-    params: ProductsParamsInput = {},
-    options: { signal?: AbortSignal } = {},
-  ) => getProductsFn({ data: params, signal: options.signal }),
-  getProductBySlug: (slug: string, params: ProductDetailParams = {}) =>
-    getProductBySlugFn({ data: { slug, ...params } }),
-  getRelatedProducts: (params: RelatedProductsParams) =>
-    getRelatedProductsFn({ data: params }),
-  autocompleteProducts: (params: ProductAutocompleteParams) =>
-    autocompleteProductsFn({ data: params }),
-  listProductReviews: (params: ListProductReviewsParams) =>
-    listProductReviewsFn({ data: params }),
-  submitProductReview: (params: CreateProductReviewParams) =>
-    submitProductReviewFn({ data: params }),
-  loadCart: (params: GetCartParams) => loadCartFn({ data: params }),
-  setCartItemQuantity: (params: UpdateCartItemQuantityParams) =>
-    setCartItemQuantityFn({ data: params }),
-  removeCartItem: (params: RemoveCartItemParams) =>
-    removeCartItemFn({ data: params }),
-  addProductToCart: (params: AddProductToCartInput) =>
-    addProductToCartFn({ data: params }),
-  addCartItem: (params: AddCartItemParams) => addCartItemFn({ data: params }),
-  getCartCheckout: (params: CartCheckoutReadParams) =>
-    getCartCheckoutFn({ data: params }),
-  getShippingOptions: (params: GetShippingOptionsParams) =>
-    getShippingOptionsFn({ data: params }),
-  putCartShippingMethod: (params: PutShippingMethodParams) =>
-    putCartShippingMethodFn({ data: params }),
-  patchCartBuyer: (params: CartBuyerParams) => patchCartBuyerFn({ data: params }),
-  patchCartAddresses: (params: CartAddressesParams) =>
-    patchCartAddressesFn({ data: params }),
-  checkoutCart: (params: CartCheckoutParams) => checkoutCartFn({ data: params }),
-  uploadPaymentReceipt: async (params: UploadPaymentReceiptParams) => {
-    const buffer = await params.file.arrayBuffer()
-    const bytes = new Uint8Array(buffer)
-    let binary = ''
-    for (const byte of bytes) binary += String.fromCharCode(byte)
-    return uploadPaymentReceiptFn({
-      data: {
-        cartToken: params.cartToken,
-        fileBase64: btoa(binary),
-        fileName:
-          params.fileName ??
-          (params.file instanceof File ? params.file.name : 'receipt'),
-        mimeType: params.file.type || undefined,
-      },
-    })
-  },
-  addCartPromotionCode: (params: CartPromotionCodeParams) =>
-    addCartPromotionCodeFn({ data: params }),
-  removeCartPromotionCode: (params: CartPromotionCodeParams) =>
-    removeCartPromotionCodeFn({ data: params }),
-  getCountries: () => getCountriesFn(),
-  getDepartments: (params: GetDepartmentsParams) =>
-    getDepartmentsFn({ data: params }),
-  getProvinces: (params: GetProvincesParams) => getProvincesFn({ data: params }),
-  getDistricts: (params: GetDistrictsParams) => getDistrictsFn({ data: params }),
-}

package/src/storefront-definition/contract.ts

@@ -1 +0,0 @@
-export * from '@ecomiq/storefront-definition'

package/src/storefront-definition/data.ts

@@ -1,188 +0,0 @@
-import type {
-  Collection,
-  Collections,
-  ProductsParamsInput,
-  ProductsResponse,
-  ProductSummary,
-} from '@ecomiq/core'
-import {
-  type CollectionGridStorefrontSection,
-  type ProductGridStorefrontSection,
-  type StorefrontDefinition,
-} from '@ecomiq/storefront-definition'
-import { storefrontPageFor } from './renderer'
-import type { DefinitionData } from './renderer'
-
-const MAX_UNIQUE_PRODUCT_SOURCES = 12
-const MANUAL_PRODUCT_PAGE_SIZE = 100
-const MAX_MANUAL_PRODUCT_SCAN_PAGES = 5
-
-export interface StorefrontRuntimeCatalogClient {
-  getProducts(params?: ProductsParamsInput): Promise<ProductsResponse>
-  getCollections(): Promise<Collections>
-}
-
-export interface ResolvedStorefrontDefinitionData
-  extends DefinitionData {
-  productsBySectionId: Record<string, ProductSummary[]>
-  collectionsBySectionId: Record<string, Collection[]>
-}
-
-export function emptyRendererData(): ResolvedStorefrontDefinitionData {
-  return {
-    productsBySectionId: {},
-    collectionsBySectionId: {},
-  }
-}
-
-function productSourceKey(
-  section: ProductGridStorefrontSection,
-): string | null {
-  if (section.source.kind === 'manual') return null
-  if (section.source.kind === 'collection') {
-    return `collection:${section.source.slug}`
-  }
-  return 'all'
-}
-
-async function loadProductSource(
-  section: ProductGridStorefrontSection,
-  client: StorefrontRuntimeCatalogClient,
-): Promise<ProductSummary[]> {
-  const params: ProductsParamsInput = {
-    page: 1,
-    pageSize: section.limit,
-    sort: 'newest',
-  }
-  if (section.source.kind === 'collection') {
-    params.collection = section.source.slug
-  }
-  const response = await client.getProducts(params)
-  return response.products.slice(0, section.limit)
-}
-
-async function scanManualProducts(
-  productIds: ReadonlySet<string>,
-  client: StorefrontRuntimeCatalogClient,
-): Promise<Map<string, ProductSummary>> {
-  const found = new Map<string, ProductSummary>()
-
-  for (let page = 1; page <= MAX_MANUAL_PRODUCT_SCAN_PAGES; page += 1) {
-    const response = await client.getProducts({
-      page,
-      pageSize: MANUAL_PRODUCT_PAGE_SIZE,
-      sort: 'newest',
-    })
-    for (const product of response.products) {
-      if (productIds.has(product.id)) found.set(product.id, product)
-    }
-
-    if (
-      found.size === productIds.size ||
-      page >= response.totalPages ||
-      response.products.length === 0
-    ) {
-      break
-    }
-  }
-
-  return found
-}
-
-export async function resolveStorefrontDefinitionData(
-  definition: StorefrontDefinition,
-  client: StorefrontRuntimeCatalogClient,
-  pageId?: string,
-): Promise<ResolvedStorefrontDefinitionData> {
-  const data = emptyRendererData()
-  const page = storefrontPageFor(definition, pageId)
-  const sections = page?.sections ?? []
-  const productSections = sections.filter(
-    (section): section is ProductGridStorefrontSection =>
-      section.enabled && section.type === 'product-grid',
-  )
-  const collectionSections = sections.filter(
-    (section): section is CollectionGridStorefrontSection =>
-      section.enabled && section.type === 'collection-grid',
-  )
-
-  const sourceSections = new Map<string, ProductGridStorefrontSection>()
-  for (const section of productSections) {
-    const sourceKey = productSourceKey(section)
-    if (!sourceKey) continue
-    const current = sourceSections.get(sourceKey)
-    if (current) {
-      if (section.limit > current.limit) sourceSections.set(sourceKey, section)
-      continue
-    }
-    if (sourceSections.size >= MAX_UNIQUE_PRODUCT_SOURCES) continue
-    sourceSections.set(sourceKey, section)
-  }
-
-  const sourceRequests = new Map<string, Promise<ProductSummary[]>>()
-  for (const [sourceKey, section] of sourceSections) {
-    sourceRequests.set(
-      sourceKey,
-      loadProductSource(section, client).catch(() => []),
-    )
-  }
-
-  const manualIds = new Set(
-    productSections.flatMap((section) =>
-      section.source.kind === 'manual' ? section.source.productIds : [],
-    ),
-  )
-  const manualProducts =
-    manualIds.size > 0
-      ? scanManualProducts(manualIds, client).catch(
-          () => new Map<string, ProductSummary>(),
-        )
-      : Promise.resolve(new Map<string, ProductSummary>())
-
-  await Promise.all(
-    productSections.map(async (section) => {
-      if (section.source.kind === 'manual') {
-        const productsById = await manualProducts
-        data.productsBySectionId[section.id] = section.source.productIds
-          .map((productId) => productsById.get(productId))
-          .filter(
-            (product): product is ProductSummary => product !== undefined,
-          )
-          .slice(0, section.limit)
-        return
-      }
-
-      const sourceKey = productSourceKey(section)
-      const products = sourceKey
-        ? await (sourceRequests.get(sourceKey) ?? Promise.resolve([]))
-        : []
-      data.productsBySectionId[section.id] = products.slice(0, section.limit)
-    }),
-  )
-
-  if (collectionSections.length > 0) {
-    const collections = await client.getCollections().catch(() => [])
-    const collectionsBySlug = new Map(
-      collections.map((collection) => [collection.slug, collection]),
-    )
-
-    for (const section of collectionSections) {
-      if (section.source.kind === 'manual') {
-        data.collectionsBySectionId[section.id] = section.source.slugs
-          .map((slug) => collectionsBySlug.get(slug))
-          .filter(
-            (collection): collection is Collection =>
-              collection !== undefined,
-          )
-          .slice(0, section.limit)
-        continue
-      }
-      data.collectionsBySectionId[section.id] = collections.slice(
-        0,
-        section.limit,
-      )
-    }
-  }
-
-  return data
-}

package/src/storefront-definition/index.ts

@@ -1,2 +0,0 @@
-export * from './contract'
-export * from './renderer'