webcake-storefront-mcp 1.15.1 → 1.17.0

package/dist/api.js

@@ -520,4 +520,469 @@ export class WebcakeCmsApi {
     sendMail(params) {
         return this.request("POST", `/api/v1/cms_function/${this.siteId}/application/automation/send_mail`, { body: params });
     }
+    // ── App lifecycle (applications/subcriptions) ──
+    /** Uninstall an app by its subscription id (the `id` from list_apps / get_app). */
+    uninstallApp(id) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/applications/subcriptions/uninstall_app`, { body: { id } });
+    }
+    /** Update an installed app's settings. `attrs` is merged onto the subscription (e.g. { settings: {...}, status }). */
+    updateApp(id, attrs) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/applications/subcriptions/update_app`, { body: { id, attrs } });
+    }
+    /** Update the product-review app's settings (shop_info, display options…). */
+    updateAppReview(id, settings) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/applications/subcriptions/update_app_review`, { body: { id, settings } });
+    }
+    // ── Product reviews (product_review app) ──
+    listReviews(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/applications/product_reviews/all_review_admin`, { query });
+    }
+    getReview(reviewId) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/applications/product_reviews/${reviewId}`);
+    }
+    getReviewProducts(reviewId) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/applications/product_reviews/products`, { query: { review_id: reviewId } });
+    }
+    /** Create or update a review/reply. `body` is the review payload (id, customer_info, rating, title,
+     *  comment, images, parent_id, apply_to, categories, permission, is_shop, product_reviews…). */
+    createOrUpdateReview(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/applications/product_reviews/create_or_update`, { body });
+    }
+    removeReviews(ids) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/applications/product_reviews/remove`, { body: { ids } });
+    }
+    /** Approve/hide reviews. `payload` typically { ids, permission } (permission 0=approved, 1=pending…). */
+    updateReviewStatus(payload) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/applications/product_reviews/update_status`, { body: payload });
+    }
+    // ── Appointment app ──
+    listAppointmentCalendars(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/appointment/appointment_calendars`, { query });
+    }
+    createAppointmentCalendar(appointment_calendar) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/appointment/create_appointment_calendar`, { body: { appointment_calendar } });
+    }
+    updateAppointmentCalendar(appointment_calendar) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/appointment/update_appointment_calendar`, { body: { appointment_calendar } });
+    }
+    deleteAppointmentCalendars(ids) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/appointment/delete_appointment_calendars`, { body: { ids } });
+    }
+    duplicateAppointmentCalendars(ids) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/appointment/duplicate_appointment_calendars`, { body: { ids } });
+    }
+    listAppointments(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/appointment/appointments`, { query });
+    }
+    listAppointmentAddresses(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/appointment/appointment_addresses`, { query });
+    }
+    createAppointmentAddress(appointment_address) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/appointment/create_appointment_address`, { body: { appointment_address } });
+    }
+    updateAppointmentAddress(appointment_address) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/appointment/update_appointment_address`, { body: { appointment_address } });
+    }
+    deleteAppointmentAddresses(ids) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/appointment/delete_appointment_addresses`, { body: { ids } });
+    }
+    listAppointmentClassifies(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/appointment/appointment_classifies`, { query });
+    }
+    createAppointmentClassify(appointment_classify) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/appointment/create_appointment_classify`, { body: { appointment_classify } });
+    }
+    updateAppointmentClassify(appointment_classify) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/appointment/update_appointment_classify`, { body: { appointment_classify } });
+    }
+    deleteAppointmentClassifies(ids) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/appointment/delete_appointment_classifies`, { body: { ids } });
+    }
+    listAppointmentEmployees(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/appointment/appointment_employees`, { query });
+    }
+    createAppointmentEmployee(appointment_employee) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/appointment/create_appointment_employee`, { body: { appointment_employee } });
+    }
+    updateAppointmentEmployee(appointment_employee) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/appointment/update_appointment_employee`, { body: { appointment_employee } });
+    }
+    deleteAppointmentEmployees(ids) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/appointment/delete_appointment_employees`, { body: { ids } });
+    }
+    // ── Affiliate app ──
+    getProgramAffiliates() {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/affiliate/program_affiliates`);
+    }
+    getProductAffiliates(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/affiliate/product_affiliates`, { query });
+    }
+    getOrderAffiliates(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/affiliate/order_affiliates`, { query });
+    }
+    getAccountAffiliates(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/affiliate/account_affiliates`, { query });
+    }
+    getPayoutAffiliates(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/affiliate/payout_affiliates`, { query });
+    }
+    getAffiliateStatistic() {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/affiliate/statistic`);
+    }
+    upsertOrderProgramAffiliate(payload) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/affiliate/upsert_order_program_affiliate`, { body: payload });
+    }
+    upsertProductProgramAffiliate(payload) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/affiliate/upsert_product_program_affiliate`, { body: payload });
+    }
+    upsertProductAffiliate(payload) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/affiliate/upsert_product_affiliate`, { body: payload });
+    }
+    deleteProductAffiliates(payload) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/affiliate/delete_product_affiliates`, { body: payload });
+    }
+    updatePayoutAffiliateStatus(payload) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/affiliate/update_status_payout_affiliate`, { body: payload });
+    }
+    deleteAccountAffiliates(payload) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/affiliate/delete_account_affiliates`, { body: payload });
+    }
+    updateAccountAffiliate(payload) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/affiliate/update_account_affiliate`, { body: payload });
+    }
+    // ── Catalog extras (brands / suppliers / tags / ribbons / materials / variations) ──
+    listProductBrands() {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/products/product_brands/all`);
+    }
+    upsertProductBrand(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/products/product_brands/create_or_update`, { body });
+    }
+    listProductSuppliers() {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/products/product_suppliers/all`);
+    }
+    upsertProductSupplier(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/products/product_suppliers/create_or_update`, { body });
+    }
+    listProductTags(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/products/product_tags/all`, { query });
+    }
+    upsertProductTag(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/products/product_tags/create_or_update`, { body });
+    }
+    listRibbons() {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/products/ribbons/all`);
+    }
+    upsertRibbon(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/products/ribbons/create_or_update`, { body });
+    }
+    listMaterials() {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/products/materials/all`);
+    }
+    upsertMaterial(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/products/materials/create_or_update`, { body });
+    }
+    getVariation(variationId) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/products/variation/${variationId}`);
+    }
+    getProductMeasurement() {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/settings/product_measurement`);
+    }
+    updateProductMeasurement(product_measurement) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/settings/product_measurement/update`, { body: { product_measurement } });
+    }
+    listBlockPhoneNumbers(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/settings/block_phone_number/all`, { query });
+    }
+    upsertBlockPhoneCustomers(phone_numbers) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/settings/block_phone_number/upsert_block_phone_customers`, { body: { phone_numbers } });
+    }
+    removeAllBlockPhoneCustomers() {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/settings/block_phone_number/remove_all_block_phone_customers`, { body: {} });
+    }
+    getPriceContacts(type) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/settings/price_contact/get`, { query: { type } });
+    }
+    updatePriceContact(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/settings/price_contact/update`, { body });
+    }
+    getCategoryById(categoryId) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/categories/${categoryId}`);
+    }
+    // ── Site config (domains / redirects / shipping / utms / logs / filters / settings / fonts) ──
+    listDomains(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/domains/all`, { query });
+    }
+    createDomain(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/domains/create`, { body });
+    }
+    updateDomain(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/domains/update`, { body });
+    }
+    verifyDomain(domain_id) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/domains/verify`, { body: { domain_id } });
+    }
+    deleteDomain(domain_id) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/domains/delete`, { body: { domain_id } });
+    }
+    checkDomain(domain) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/domains/check_domain`, { body: { domain } });
+    }
+    listRedirectUrls(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/seos/redirect_urls/all`, { query });
+    }
+    createRedirectUrl(redirect_url) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/seos/redirect_urls/create`, { body: { redirect_url } });
+    }
+    updateRedirectUrl(redirect_url) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/seos/redirect_urls/update`, { body: { redirect_url } });
+    }
+    deleteRedirectUrls(redirect_url_ids) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/seos/redirect_urls/delete`, { body: { redirect_url_ids } });
+    }
+    getShipping() {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/settings/shipping`);
+    }
+    updateShipping(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/settings/shipping/update`, { body });
+    }
+    listSiteUtms(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/site_utms/all`, { query });
+    }
+    createSiteUtm(site_utm) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/site_utms/create`, { body: { site_utm } });
+    }
+    updateSiteUtm(site_utm) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/site_utms/update`, { body: { site_utm } });
+    }
+    deleteSiteUtms(ids) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/site_utms/delete`, { body: { ids } });
+    }
+    listSystemLogs(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/system_logs/all`, { query });
+    }
+    listSavedFilters(table_key) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/saved_filters/`, { query: { table_key } });
+    }
+    createSavedFilter(saved_filter) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/saved_filters/create`, { body: { saved_filter } });
+    }
+    updateSavedFilter(id, saved_filter) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/saved_filters/${id}/update`, { body: { saved_filter } });
+    }
+    deleteSavedFilter(id) {
+        return this.request("DELETE", `/api/v1/dashboard/site/${this.siteId}/saved_filters/${id}`);
+    }
+    /** Raw /update_site call. `body` top-level keys replace; a nested `settings` key is merged server-side. */
+    updateSiteRaw(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/update_site`, { body });
+    }
+    updateSiteName(name) {
+        return this.request("POST", `/api/v1/site/${this.siteId}/update_site_name`, { body: { name } });
+    }
+    updateSiteSlug(slug) {
+        return this.request("POST", `/api/v1/site/${this.siteId}/update_slug_name`, { body: { slug } });
+    }
+    loadFonts() {
+        return this.request("GET", `/api/v1/site/${this.siteId}/load_fonts`);
+    }
+    removeFont(id) {
+        return this.request("DELETE", `/api/v1/site/${this.siteId}/remove_font`, { body: { id } });
+    }
+    loadFontGroups() {
+        return this.request("GET", `/api/v1/site/${this.siteId}/load_font_groups`);
+    }
+    createFontGroup(body) {
+        return this.request("POST", `/api/v1/site/${this.siteId}/create_font_group`, { body: { ...body, site_id: this.siteId } });
+    }
+    removeFontGroup(id) {
+        return this.request("DELETE", `/api/v1/site/${this.siteId}/remove_font_groups`, { body: { id, site_id: this.siteId } });
+    }
+    listApiKeys(query) {
+        return this.request("GET", `/api/v1/site/${this.siteId}/api_keys/all`, { query });
+    }
+    listPublishHistories(query) {
+        return this.request("GET", `/api/v1/site/${this.siteId}/publish_histories`, { query });
+    }
+    // ── Marketing / CRM / team ──
+    getSendEmail() {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/send_email/all`);
+    }
+    saveSendEmail(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/send_email/save`, { body });
+    }
+    listContacts(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/contact/all`, { query });
+    }
+    createContact(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/contact/create`, { body: { ...body, site_id: this.siteId } });
+    }
+    deleteContacts(ids) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/contact/delete`, { body: { ids } });
+    }
+    listSubscribers(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/subscriber/all`, { query });
+    }
+    createSubscriber(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/subscriber/create`, { body });
+    }
+    deleteSubscribers(ids) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/subscriber/delete`, { body: { ids } });
+    }
+    listEmployees() {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/settings/employee/all`);
+    }
+    inviteEmployee(email) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/settings/employee/invite`, { body: { email } });
+    }
+    updateEmployeePermissions(site_permission) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/settings/employee/change_permissions`, { body: { site_permission } });
+    }
+    deleteEmployees(site_permission_ids) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/settings/employee/delete_employees`, { body: { site_permission_ids } });
+    }
+    listInvitations() {
+        return this.request("GET", `/api/v1/dashboard/site/invitations/all`);
+    }
+    acceptInvitation(invitation_id) {
+        return this.request("POST", `/api/v1/dashboard/site/invitations/accept`, { body: { invitation_id } });
+    }
+    refuseInvitation(invitation_id) {
+        return this.request("POST", `/api/v1/dashboard/site/invitations/refuse`, { body: { invitation_id } });
+    }
+    listCustomerTags() {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/customer/customer_tags`);
+    }
+    upsertCustomerTag(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/customer/upsert_customer_tag`, { body: { ...body, site_id: this.siteId } });
+    }
+    assignCustomerTags(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/customer/update_tags_for_multiple_customers`, { body: { ...body, site_id: this.siteId } });
+    }
+    getInsightToday() {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/insight/today`);
+    }
+    getInsight(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/insight/all`, { query });
+    }
+    listNotifications() {
+        return this.request("GET", `/api/v1/dashboard/site/notifications/all`);
+    }
+    markNotificationRead(notification_id) {
+        return this.request("POST", `/api/v1/dashboard/site/notifications/mark_as_read`, { body: { notification_id } });
+    }
+    // ── Multilingual / translations ──
+    mlAddLanguages(languages) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/multilingual/add_multiple_language`, { body: { languages } });
+    }
+    mlChangeDefault(language_code) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/multilingual/change_language_default`, { body: { language_code } });
+    }
+    mlGetTranslations(resource, query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/multilingual/${resource}`, { query });
+    }
+    mlSaveTranslations(action, body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/multilingual/${action}`, { body });
+    }
+    mlTranslateJson(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/multilingual/translate_json`, { body });
+    }
+    // ── Media library + PWA ──
+    listMediaFolders(query) {
+        return this.request("GET", `/api/v1/site/${this.siteId}/media/folder`, { query });
+    }
+    listMediaContent(query) {
+        return this.request("GET", `/api/v1/site/${this.siteId}/media/content`, { query });
+    }
+    listMediaAll(query) {
+        return this.request("GET", `/api/v1/site/${this.siteId}/media/all`, { query });
+    }
+    getMediaCapacity() {
+        return this.request("GET", `/api/v1/site/${this.siteId}/media/capacity`);
+    }
+    emptyMediaTrash() {
+        return this.request("POST", `/api/v1/site/${this.siteId}/media/empty_trash`, { body: {} });
+    }
+    uploadBase64Media(base64) {
+        return this.request("POST", `/api/v1/site/${this.siteId}/media/content/b64`, { body: { base64 }, timeout: 60000 });
+    }
+    updateMediaFolder(body) {
+        return this.request("POST", `/api/v1/site/${this.siteId}/media/folder/update`, { body });
+    }
+    updateMediaContent(body) {
+        return this.request("POST", `/api/v1/site/${this.siteId}/media/content/update`, { body });
+    }
+    getPwa() {
+        return this.request("GET", `/api/v1/site/${this.siteId}/pwa`);
+    }
+    upsertPwa(body) {
+        return this.request("POST", `/api/v1/site/${this.siteId}/pwa/upsert`, { body });
+    }
+    // ── Apps: product design / personal product design / course ──
+    getDeviceTemplates() {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/applications/product_design/get_group_device_tempalte`);
+    }
+    createProductsByDeviceTemplate(groups) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/applications/product_design/create_product_by_device_template`, { body: { groups, site_id: this.siteId } });
+    }
+    getAllPpd(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/applications/personal_product_design/get_all_ppd`, { query });
+    }
+    upsertPpd(ppds) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/applications/personal_product_design/upsert_ppd`, { body: { ppds, site_id: this.siteId } });
+    }
+    removePpd(ids) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/applications/personal_product_design/remove_ppd`, { body: { ids, site_id: this.siteId } });
+    }
+    getProductVariationTemplate(product_id) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/applications/personal_product_design/get_product_variation_template`, { query: { product_id } });
+    }
+    listCourses(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/course-app`, { query });
+    }
+    getCourse(id) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/course-app/${id}`);
+    }
+    createCourse(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/course-app`, { body: { ...body, site_id: this.siteId } });
+    }
+    updateCourse(id, body) {
+        return this.request("PATCH", `/api/v1/dashboard/site/${this.siteId}/course-app/${id}`, { body });
+    }
+    deleteCourse(id) {
+        return this.request("DELETE", `/api/v1/dashboard/site/${this.siteId}/course-app/${id}`);
+    }
+    deleteManyCourses(ids) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/course-app/delete_many`, { body: { ids, site_id: this.siteId } });
+    }
+    getCourseMembers(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/course-app/members`, { query });
+    }
+    // ── Sale channels: sitemap + partner feeds + catalogs ──
+    sitemapSync(kind) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/sale_channels/sitemap/sync_${kind}`, { body: {} });
+    }
+    sitemapRebuild(type) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/sale_channels/sitemap/rebuild`, { body: { type } });
+    }
+    listPartnerFeeds(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/sale_channels/partner_feeds/all`, { query });
+    }
+    createPartnerFeed(body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/sale_channels/partner_feeds/create`, { body });
+    }
+    updatePartnerFeed(partnerFeedId, body) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/sale_channels/partner_feeds/${partnerFeedId}/update`, { body });
+    }
+    deletePartnerFeeds(partner_feed_ids) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/sale_channels/partner_feeds/delete`, { body: { partner_feed_ids } });
+    }
+    listPartnerFeedProducts(partnerFeedId, query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/sale_channels/partner_feeds/${partnerFeedId}/products/all`, { query });
+    }
+    syncPartnerFeed(partnerFeedId) {
+        return this.request("POST", `/api/v1/dashboard/site/${this.siteId}/sale_channels/partner_feeds/${partnerFeedId}/products/sync`, { body: { partner_feed_id: partnerFeedId } });
+    }
+    listGoogleMerchants(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/sale_channels/google/merchants`, { query });
+    }
 }

package/dist/builder/guide.js

@@ -36,7 +36,26 @@ children with a grid:
 - each child config also has \`rowStart/rowEnd\` (1-based grid lines),
   \`constraintX\` (['left'|'right'|'centerLeft']), \`constraintY\` (['top'|'bottom'|'centerTop']).
 new_section does ALL of this for you: pass children and they are stacked one row each in
-the centre column. To build multi-column layouts, nest a container child with its own grid.
+the centre column.
+
+## Multi-column rows (cards side by side) — USE THIS, real pages are full of them
+A plain vertical stack looks like a blog post, not a designed page. Feature cards,
+category tiles, footer columns, a text+image hero — all are HORIZONTAL rows. Two ways:
+- new_row(children=[colA, colB, colC]) → a container whose children sit SIDE BY SIDE in
+  equal columns. Place the returned node as a child of a section.
+- Inside new_section, add \`layout:"row"\` to a CONTAINER child spec and its children become
+  columns: \`{ type:"container", layout:"row", children:[ {..}, {..}, {..} ] }\`.
+Rows are RESPONSIVE automatically: finalizeForRender collapses them on small screens
+(default tablet=2 columns, mobile=1) so cards never shrink to slivers — override with
+\`collapse:{bp3:2,bp4:1}\`. Uneven columns via \`colWidths\` (e.g. a 2:1 text/image split:
+\`colWidths:[{unit:'fr',value:2},{unit:'fr',value:1}]\`), spacing via \`columnGap\`/\`rowGap\`.
+Each column is usually a \`container\` holding its own stacked children (image + title +
+text). Example feature row:
+\`new_row(children=[
+  { type:"container", children:[ {type:"image",opts:{...}}, {type:"text",opts:{text:"Giao nhanh"}} ] },
+  { type:"container", children:[ {type:"image",opts:{...}}, {type:"text",opts:{text:"Chất lượng"}} ] },
+  { type:"container", children:[ {type:"image",opts:{...}}, {type:"text",opts:{text:"Bảo hành"}} ] },
+])\`
 
 ## Where layout/style live: per-breakpoint keys (NOT \`runtime\`)
 new_section / new_element emit a temporary \`runtime: { style, config }\`. That is a

package/dist/builder/page.js

@@ -84,6 +84,68 @@ export function stackChildren(container, children, opts = {}) {
     container.children = children;
     return container;
 }
+const ROW_PLACEHOLDER_ROW = () => ({ unit: "min/max", min: { unit: "px", absValue: 50 }, max: { unit: "max-c" } });
+/** Default responsive collapse for a multi-column row: full columns on desktop/laptop,
+ *  2 columns on tablet, 1 column on mobile. `null` = keep the full column count. */
+const ROW_COLLAPSE_DEFAULT = { bp1: null, bp2: null, bp3: 2, bp4: 1 };
+/**
+ * Lay children out HORIZONTALLY — side by side in one grid row — the way real BuilderX
+ * pages build feature cards, category tiles, footer columns, 2-col hero, etc. The grid is
+ * `Nx1` with N equal `fr` columns and each child placed in its own column. Values go to
+ * `runtime` plus `__row`/`__cell` markers that finalizeForRender() reads to emit a
+ * RESPONSIVE grid per breakpoint (it auto-collapses to fewer columns on tablet/mobile so
+ * the row never renders as cramped slivers).
+ */
+export function rowChildren(container, children, opts = {}) {
+    const cols = children.length || 1;
+    const colWidths = opts.colWidths && opts.colWidths.length === cols
+        ? opts.colWidths
+        : Array.from({ length: cols }, () => ({ unit: "fr", value: 1 }));
+    const collapse = { ...ROW_COLLAPSE_DEFAULT, ...(opts.collapse || {}) };
+    const columnGap = opts.columnGap ?? 24;
+    const rowGap = opts.rowGap ?? 24;
+    const meta = { cols, count: children.length, collapse, columnGap, rowGap };
+    container.runtime = container.runtime || {};
+    container.runtime.config = {
+        ...(container.runtime.config || {}),
+        grid: `${cols}x1`,
+        columns: colWidths,
+        rows: [ROW_PLACEHOLDER_ROW()],
+        columnGap,
+        rowGap,
+        heightUnit: "auto",
+        __row: meta,
+    };
+    children.forEach((child, i) => {
+        child.runtime = child.runtime || {};
+        child.runtime.config = {
+            ...(child.runtime.config || {}),
+            columnStart: i + 1,
+            columnEnd: i + 2,
+            rowStart: 1,
+            rowEnd: 2,
+            constraintX: (child.runtime.config && child.runtime.config.constraintX) || ["centerLeft"],
+            constraintY: (child.runtime.config && child.runtime.config.constraintY) || ["top"],
+            loaded: true,
+            __cell: { index: i, ...meta },
+        };
+    });
+    container.children = children;
+    return container;
+}
+/** Build a standalone multi-column ROW container from child specs (each laid side by side).
+ *  Used by the new_row tool; inside new_section pass `layout:"row"` on a container spec. */
+export function buildRow(childSpecs = [], opts = {}) {
+    const container = buildElement("container", opts.containerOpts || {});
+    const children = childSpecs.map((spec) => buildFromSpec(spec));
+    return rowChildren(container, children, opts);
+}
+/** How many columns a row shows at a given breakpoint (clamped to its real column count). */
+function colsForBp(meta, bp) {
+    const c = meta.collapse ? meta.collapse[bp] : null;
+    const k = c == null ? meta.cols : Math.min(c, meta.cols);
+    return Math.max(1, k);
+}
 /**
  * Build a ready-to-place section from a list of child specs.
  * Each spec: { type, opts?, children? } where children is a nested array of specs.
@@ -118,7 +180,19 @@ function buildFromSpec(spec) {
     const node = buildElement(spec.type, spec.opts || {});
     if (Array.isArray(spec.children) && spec.children.length) {
         const kids = spec.children.map((c) => buildFromSpec(c));
-        stackChildren(node, kids);
+        // `layout:"row"` lays the children out side by side (responsive); default is a
+        // top-to-bottom vertical stack. rowGap/columnGap/colWidths/collapse tune the layout.
+        if (spec.layout === "row") {
+            rowChildren(node, kids, {
+                columnGap: spec.columnGap,
+                rowGap: spec.rowGap,
+                colWidths: spec.colWidths,
+                collapse: spec.collapse,
+            });
+        }
+        else {
+            stackChildren(node, kids, { rowGap: spec.rowGap });
+        }
     }
     return node;
 }
@@ -193,9 +267,14 @@ function expandNodeToBreakpoints(node) {
         const baseStyle = rt.style || {};
         const baseConfig = { ...(rt.config || {}), loaded: true };
         const isSection = node.type === "section";
+        const rowMeta = baseConfig.__row; // this node is a multi-column row container
+        const cellMeta = baseConfig.__cell; // this node is a cell inside a row
         for (const [bp, [minW]] of Object.entries(BREAKPOINTS)) {
             const style = clone(baseStyle);
             const config = clone(baseConfig);
+            // Internal build-time markers never get persisted.
+            delete config.__row;
+            delete config.__cell;
             if (isSection) {
                 const g = genGridByBp(minW);
                 const sectionRows = baseConfig.rows && baseConfig.rows.length ? clone(baseConfig.rows) : clone(g.rows);
@@ -204,6 +283,29 @@ function expandNodeToBreakpoints(node) {
                 config.grid = `3x${sectionRows.length}`;
                 config.heightUnit = config.heightUnit || "auto";
             }
+            // A multi-column row collapses to fewer columns on smaller screens so cards never
+            // shrink to slivers: recompute the grid + this container's columns per breakpoint.
+            if (rowMeta) {
+                const k = colsForBp(rowMeta, bp);
+                const nrows = Math.ceil(rowMeta.count / k);
+                config.columns =
+                    k === rowMeta.cols && Array.isArray(baseConfig.columns) && baseConfig.columns.length === k
+                        ? clone(baseConfig.columns)
+                        : Array.from({ length: k }, () => ({ unit: "fr", value: 1 }));
+                config.rows = Array.from({ length: nrows }, () => ROW_PLACEHOLDER_ROW());
+                config.grid = `${k}x${nrows}`;
+                config.heightUnit = config.heightUnit || "auto";
+            }
+            // A cell repositions itself into the collapsed grid (wraps to a new row as needed).
+            if (cellMeta) {
+                const k = colsForBp(cellMeta, bp);
+                const c = cellMeta.index % k;
+                const r = Math.floor(cellMeta.index / k);
+                config.columnStart = c + 1;
+                config.columnEnd = c + 2;
+                config.rowStart = r + 1;
+                config.rowEnd = r + 2;
+            }
             node[bp] = { style, config };
         }
         delete node.runtime;