@reblu/site-contracts 1.21.0 → 1.22.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @reblu/site-contracts
 
+## 1.22.0
+
+### Minor Changes
+
+- 01d0e15: Academy catalogue filters by price and instructor (REB-547). `@reblu/site-contracts` exports `AcademyCourseListQuery`, the documented query of `GET /api/site/academy/courses`. `@reblu/site-client` adds `academy.instructors()` (instructors of published courses, for the filter), and `AcademyCourseListParams` is now that query type, so the SDK cannot drift from the API. `@reblu/site-blocks` adds `CourseCatalogFilters`, a drop-in instructor and price filter (bands in integer cents plus «Gratis»), RSC-safe like `ShopFilters`.
+- d1db04e: Tenant-configurable interest question on the contact form (REB-759).
+  - `Config.contactInterest`: `{ label, options }` or `null`, the tenant's own question and options from nexus. `null` means the field must not render; there is no default catalogue.
+  - `ContactFormInput.interests`: the chosen option labels (up to 20). The server keeps only labels the tenant offers.
+  - New drop-in `ContactInterestField` in `@reblu/site-blocks`: a controlled checkbox group that renders nothing when the tenant has no question. Slots: `contact-interest`, `contact-interest-option`.
+
+- 5ca48ee: Discount code usage limits are enforced before payment (REB-912).
+  - New `ShopErrorCode` `DISCOUNT_LIMIT_REACHED` (400): checkout refuses a discount code that has used up its total uses (slots held by open payment sessions count), before any payment session is created. The buyer can continue without the code.
+  - `DEFAULT_SHOP_ERROR_MESSAGES.DISCOUNT_LIMIT_REACHED`: «Este código ya ha alcanzado su límite de usos».
+  - A per-customer limit still answers `DISCOUNT_INVALID` with a neutral message.
+
 ## 1.21.0
 
 ### Minor Changes

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAkFO,IAAM,kBAAA,GAAqB,OAAO,MAAA,CAAO;AAAA,EAC9C,QAAA;AAAA,EACA,eAAA;AAAA,EACA,SAAA;AAAA,EACA,WAAA;AAAA,EACA,aAAA;AAAA,EACA,aAAA;AAAA,EACA,oBAAA;AAAA,EACA;AACF,CAAU","file":"index.cjs","sourcesContent":["/**\n * `@reblu/site-contracts` — public, dependency-free TypeScript types for the\n * Reblu SITE API (REB-414 / design doc §2).\n *\n * These types are the SDK-facing view of every `/api/site/*` response. They are\n * re-derived (`z.infer`) from the hand-authored response schemas that live in\n * base-api (`apps/base-api/src/lib/contracts/*.contract.ts`) and imported here\n * through the build-time-only `@reblu/base-api-contracts` type alias.\n *\n * Guarantees (enforced by the leakage guard tests):\n *   - Everything below is `export type` — the import is erased at build time, so\n *     NO Zod and NO Prisma reaches a consumer's runtime or `node_modules` graph.\n *     The one exception is `DATA_REQUEST_TYPES` (REB-1005): a plain, import-free\n *     array literal, the package's only runtime value.\n *   - The published `.d.ts` is flattened and self-contained: the alias and\n *     `z.infer` do not survive into the emitted declarations.\n *   - Never re-exports an internal / Prisma-generated type — only the public\n *     output DTOs base-api explicitly publishes.\n *\n * When base-api adds a new public contract type, add it to the matching group\n * below. The explicit list (over `export type *`) keeps the public surface a\n * reviewed, intentional decision and avoids leaking internal `*Schema` names.\n */\n\n// Envelope / pagination\nexport type { PaginationMeta } from '@reblu/base-api-contracts'\n\n// Analytics + shared contact-form mode\nexport type { Analytics, ContactFormMode } from '@reblu/base-api-contracts'\n\n// REB-845 — the tenant-editable cookie banner copy shape, standalone (not just\n// nested in `Analytics`), so `@reblu/site-next`'s `cookieBannerToConsentTexts`\n// can type its input against the real contract instead of a hand-rolled copy.\nexport type { CookieBanner } from '@reblu/base-api-contracts'\n\n// Site config\nexport type {\n  Config,\n  ConfigAddress,\n  ConfigFiscal,\n  ConfigFiscalRegistry,\n  ConfigSocial,\n  ConfigTaxIdKind,\n  // REB-826 — typed opening hours.\n  ConfigOpeningHours,\n  ConfigOpeningHoursRange,\n  ConfigOpeningHoursDay,\n} from '@reblu/base-api-contracts'\n\n// REB-871 — the resolved `seo` block on every detail response (pages, blog\n// posts, shop products, academy courses). `seo.title` is the FINAL page title.\nexport type { Seo } from '@reblu/base-api-contracts'\n\n// Contact form\nexport type { ContactFormSubmission, ContactFormInput } from '@reblu/base-api-contracts'\n// REB-1078 — the raw lead-origin touches a SITE sends in `metadata.attribution`\n// (contact form and `/api/site/leads`); base-api classifies the channel.\nexport type { LeadAttribution, LeadTouch } from '@reblu/base-api-contracts'\n\n// Leads\nexport type { LeadInput, LeadSubmission } from '@reblu/base-api-contracts'\n\n// GDPR data-subject requests (REB-77 endpoint, REB-980 SDK) — the public\n// `/derechos-rgpd` form body and its 72h acknowledgement.\nexport type {\n  DataRequestInput,\n  DataRequestSubmission,\n  DataRequestType,\n} from '@reblu/base-api-contracts'\nimport type { DataRequestType } from '@reblu/base-api-contracts'\n\n/**\n * REB-1005 — every GDPR right a data subject can exercise, in base-api's order.\n * The ONE runtime value this package ships: server code (a SITE's Route\n * Handler, `@reblu/site-next`'s `createDataRequestRoute`) needs the list too,\n * and `@reblu/site-blocks` re-exports it as before.\n *\n * Single source: base-api's `dataRequestTypeSchema`. `satisfies` rejects a\n * member base-api does not know, `MissingDataRequestType` below rejects one it\n * knows and this list lacks, and `tests/unit/data-request-types.test.ts` pins\n * the order. Plain array literal, no import — the runtime stays dependency-free.\n */\nexport const DATA_REQUEST_TYPES = Object.freeze([\n  'ACCESS',\n  'RECTIFICATION',\n  'ERASURE',\n  'OBJECTION',\n  'PORTABILITY',\n  'RESTRICTION',\n  'AUTOMATED_DECISION',\n  'INFORMATION',\n] as const) satisfies readonly DataRequestType[]\n\n/** Compile error when base-api adds a right this list does not carry. */\ntype AssertNoneMissing<T extends never> = T\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\ntype MissingDataRequestType = AssertNoneMissing<\n  Exclude<DataRequestType, (typeof DATA_REQUEST_TYPES)[number]>\n>\n\n// Blog\nexport type {\n  BlogAuthor,\n  BlogAuthorDetail,\n  BlogCategory,\n  BlogCategoryWithCount,\n  BlogTag,\n  BlogPostListItem,\n  BlogPostDetail,\n  BlogPostPreview,\n  BlogSlug,\n} from '@reblu/base-api-contracts'\n\n// Pages\nexport type {\n  // The flexible pageType (service|custom|treatments|specialties|team|generic)\n  // — REB-63: this is what `pages.list`'s `type` filter actually validates\n  // against server-side (`pagesListParamsSchema`), not `LegacyPageType`.\n  PageType,\n  // Legacy DB page type (SERVICE|CUSTOM) — the `type`/`category` fields still\n  // carried on each `PageListItem`/`PageDetail` for backward compat during the\n  // REB-75 dual-read window. NOT the `pages.list` filter's value space anymore.\n  LegacyPageType,\n  PageContentMode,\n  SectionLayout,\n  PageCategoryRef,\n  PageListItem,\n  PageSectionImage,\n  PageSection,\n  PageDetail,\n  PageSlug,\n  // REB-63: `pages.list`'s sort param — same reasoning as AcademyCourseSort\n  // below (a typo is a compile error instead of a silent no-op fallback).\n  PagesListSort,\n  // REB-869 — `pages.list`'s query, incl. `featured` (with `category`: that\n  // category's featured pages, max 3, in their stored order).\n  PagesListQuery,\n  // REB-75 D-D — the typed block registry on `PageDetail.blocks[]`.\n  BlockType,\n  Block,\n  // REB-849 — each block mirrors its parent section's heading/backgroundColor/\n  // cta; REB-851 phase 1 — doctor_embed/specialty_embed blocks additionally\n  // carry `resolved` (present only on those two block types).\n  PageBlock,\n  BlockCta,\n  ResolvedEmbed,\n  // REB-867 — slugs are unique per category: the embed reference shape\n  // (`pageId`/`categorySlug`) and the 409 body of an ambiguous `GET /pages/[slug]`.\n  EmbedReferenceData,\n  PageAmbiguousSlugError,\n} from '@reblu/base-api-contracts'\n\n// Professional profile (REB-63) — pageType='team' only. Sector-agnostic\n// structured CV, same platform-shape/tenant-content split as CustomFieldDefinition.\n// REB-1099: `ProfessionalField` — a tenant-defined field (e.g. a registration\n// number) on the card (`ProfessionalSummary.fields`) and profile.\nexport type {\n  ProfessionalField,\n  ProfessionalSummary,\n  ProfessionalProfile,\n  ProfessionalCv,\n  ProfessionalCvEntry,\n  ProfessionalLanguage,\n  ProfessionalLanguageLevel,\n  ProfessionalSocialLink,\n  ProfessionalSocialPlatform,\n} from '@reblu/base-api-contracts'\n\n// Custom-field registry (REB-475 / REB-75) — entity-agnostic, shared with pages/team\nexport type {\n  CustomFieldValueType,\n  CustomFieldEntityType,\n  CustomFieldOption,\n  CustomFieldDefinition,\n} from '@reblu/base-api-contracts'\n\n// Shop\nexport type {\n  TaxType,\n  ProductType,\n  ShopConfig,\n  // Store-wide product trust items (REB-858)\n  ShopProductTrustIcon,\n  ShopProductTrustItem,\n  ShopTaxRateRef,\n  ShopProductImage,\n  ShopProductVideo,\n  ShopProductCategoryRef,\n  ShopInventoryRef,\n  ShopCategory,\n  ShopProductListItem,\n  ShopProductVariant,\n  ShopBundleComponent,\n  ShopRelatedProduct,\n  ShopProductDetail,\n  // Taxonomy + attributes + facets (REB-474/475)\n  ShopTaxonomyTermRef,\n  ShopProductAttributes,\n  // Per-axis selection mode (REB-809/REB-801)\n  ShopTaxonomySelectionMode,\n  ShopSort,\n  ShopProductListParams,\n  ShopFacets,\n  // Write inputs (REB-438)\n  ShopCartItemInput,\n  ShopAddressInput,\n  ShopBillingInput,\n  ShopCheckoutInput,\n  ShopValidateCartInput,\n  ShopApplyDiscountInput,\n  // Write responses (REB-438)\n  ShopCheckoutSession,\n  ShopCartValidationError,\n  ShopCartValidationItem,\n  ShopCartValidation,\n  ShopDiscountApplication,\n  // Automatic staff discount, additive on the write responses (REB-1131)\n  ShopStaffAutoDiscount,\n  // Order lookup (REB-829)\n  ShopOrderItem,\n  ShopOrder,\n  // The order's invoice reference (REB-73)\n  ShopOrderInvoice,\n  // Stable, machine-readable write-endpoint error codes (REB-836)\n  ShopErrorCode,\n} from '@reblu/base-api-contracts'\n\n// REB-834 — `POST /api/site/shop/check-email` is deprecated: it was an\n// account-enumeration oracle and now always answers `{ exists: false }`.\n// Kept (a minor may only deprecate); removed in the next major.\nexport type {\n  /**\n   * @deprecated REB-834 — `POST /api/site/shop/check-email` no longer reveals\n   * whether an account exists. Do not call it; removed in the next major.\n   */\n  ShopCheckEmailInput,\n  /**\n   * @deprecated REB-834 — `exists` is always `false`. Never branch UI on it:\n   * the checkout always offers «Iniciar sesión o continuar como invitado» and\n   * the server links the order to an existing account after payment. Removed\n   * in the next major.\n   */\n  ShopEmailCheck,\n} from '@reblu/base-api-contracts'\n\n// Academy (REB-507) — public course catalogue. `AcademyCourseSort` is the query\n// contract for the `sort` param, so the SDK can type it as a union instead of a\n// bare string (an unknown key is silently ignored server-side).\nexport type {\n  AcademyCourseSort,\n  AcademyCategoryPublic,\n  AcademyLessonPublic,\n  AcademyModulePublic,\n  AcademyInstructorPublic,\n  AcademyCourseSummary,\n  AcademyCourseDetail,\n  // REB-83 — tenant-configurable validation fields (drives the enrollment CTA form).\n  AcademyValidationFieldPublic,\n  // REB-1135 — a free-preview lesson, viewable by the public\n  // (`GET /api/site/academy/courses/{slug}/lessons/{lessonSlug}`).\n  AcademyLessonPreview,\n  AcademyLessonPreviewVideo,\n} from '@reblu/base-api-contracts'\n\n// Legal\nexport type { Legal } from '@reblu/base-api-contracts'\n\n// CTAs\nexport type { Cta } from '@reblu/base-api-contracts'\n\n// Trust badges\nexport type { TrustBadge, TrustBadgeType } from '@reblu/base-api-contracts'\n\n// SITE capability manifest (`/.well-known/reblu-site.json`) — REB-777.\n// Direction note (see `site-manifest.contract.ts` in base-api): this is the\n// one contract group a SITE produces and base-api consumes, the opposite of\n// every group above. The TYPE still flows through this same alias so the\n// SDK and nexus never describe two different shapes for it; the real Zod\n// validation stays in base-api only — this package never gains a Zod\n// runtime dependency.\nexport type {\n  SiteManifest,\n  SiteManifestSurfaceValue,\n  SiteCapabilitySurfaceKey,\n} from '@reblu/base-api-contracts'\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAkFO,IAAM,kBAAA,GAAqB,OAAO,MAAA,CAAO;AAAA,EAC9C,QAAA;AAAA,EACA,eAAA;AAAA,EACA,SAAA;AAAA,EACA,WAAA;AAAA,EACA,aAAA;AAAA,EACA,aAAA;AAAA,EACA,oBAAA;AAAA,EACA;AACF,CAAU","file":"index.cjs","sourcesContent":["/**\n * `@reblu/site-contracts` — public, dependency-free TypeScript types for the\n * Reblu SITE API (REB-414 / design doc §2).\n *\n * These types are the SDK-facing view of every `/api/site/*` response. They are\n * re-derived (`z.infer`) from the hand-authored response schemas that live in\n * base-api (`apps/base-api/src/lib/contracts/*.contract.ts`) and imported here\n * through the build-time-only `@reblu/base-api-contracts` type alias.\n *\n * Guarantees (enforced by the leakage guard tests):\n *   - Everything below is `export type` — the import is erased at build time, so\n *     NO Zod and NO Prisma reaches a consumer's runtime or `node_modules` graph.\n *     The one exception is `DATA_REQUEST_TYPES` (REB-1005): a plain, import-free\n *     array literal, the package's only runtime value.\n *   - The published `.d.ts` is flattened and self-contained: the alias and\n *     `z.infer` do not survive into the emitted declarations.\n *   - Never re-exports an internal / Prisma-generated type — only the public\n *     output DTOs base-api explicitly publishes.\n *\n * When base-api adds a new public contract type, add it to the matching group\n * below. The explicit list (over `export type *`) keeps the public surface a\n * reviewed, intentional decision and avoids leaking internal `*Schema` names.\n */\n\n// Envelope / pagination\nexport type { PaginationMeta } from '@reblu/base-api-contracts'\n\n// Analytics + shared contact-form mode\nexport type { Analytics, ContactFormMode } from '@reblu/base-api-contracts'\n\n// REB-845 — the tenant-editable cookie banner copy shape, standalone (not just\n// nested in `Analytics`), so `@reblu/site-next`'s `cookieBannerToConsentTexts`\n// can type its input against the real contract instead of a hand-rolled copy.\nexport type { CookieBanner } from '@reblu/base-api-contracts'\n\n// Site config\nexport type {\n  Config,\n  ConfigAddress,\n  ConfigFiscal,\n  ConfigFiscalRegistry,\n  ConfigSocial,\n  ConfigTaxIdKind,\n  // REB-826 — typed opening hours.\n  ConfigOpeningHours,\n  ConfigOpeningHoursRange,\n  ConfigOpeningHoursDay,\n} from '@reblu/base-api-contracts'\n\n// REB-871 — the resolved `seo` block on every detail response (pages, blog\n// posts, shop products, academy courses). `seo.title` is the FINAL page title.\nexport type { Seo } from '@reblu/base-api-contracts'\n\n// Contact form\nexport type { ContactFormSubmission, ContactFormInput } from '@reblu/base-api-contracts'\n// REB-1078 — the raw lead-origin touches a SITE sends in `metadata.attribution`\n// (contact form and `/api/site/leads`); base-api classifies the channel.\nexport type { LeadAttribution, LeadTouch } from '@reblu/base-api-contracts'\n\n// Leads\nexport type { LeadInput, LeadSubmission } from '@reblu/base-api-contracts'\n\n// GDPR data-subject requests (REB-77 endpoint, REB-980 SDK) — the public\n// `/derechos-rgpd` form body and its 72h acknowledgement.\nexport type {\n  DataRequestInput,\n  DataRequestSubmission,\n  DataRequestType,\n} from '@reblu/base-api-contracts'\nimport type { DataRequestType } from '@reblu/base-api-contracts'\n\n/**\n * REB-1005 — every GDPR right a data subject can exercise, in base-api's order.\n * The ONE runtime value this package ships: server code (a SITE's Route\n * Handler, `@reblu/site-next`'s `createDataRequestRoute`) needs the list too,\n * and `@reblu/site-blocks` re-exports it as before.\n *\n * Single source: base-api's `dataRequestTypeSchema`. `satisfies` rejects a\n * member base-api does not know, `MissingDataRequestType` below rejects one it\n * knows and this list lacks, and `tests/unit/data-request-types.test.ts` pins\n * the order. Plain array literal, no import — the runtime stays dependency-free.\n */\nexport const DATA_REQUEST_TYPES = Object.freeze([\n  'ACCESS',\n  'RECTIFICATION',\n  'ERASURE',\n  'OBJECTION',\n  'PORTABILITY',\n  'RESTRICTION',\n  'AUTOMATED_DECISION',\n  'INFORMATION',\n] as const) satisfies readonly DataRequestType[]\n\n/** Compile error when base-api adds a right this list does not carry. */\ntype AssertNoneMissing<T extends never> = T\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\ntype MissingDataRequestType = AssertNoneMissing<\n  Exclude<DataRequestType, (typeof DATA_REQUEST_TYPES)[number]>\n>\n\n// Blog\nexport type {\n  BlogAuthor,\n  BlogAuthorDetail,\n  BlogCategory,\n  BlogCategoryWithCount,\n  BlogTag,\n  BlogPostListItem,\n  BlogPostDetail,\n  BlogPostPreview,\n  BlogSlug,\n} from '@reblu/base-api-contracts'\n\n// Pages\nexport type {\n  // The flexible pageType (service|custom|treatments|specialties|team|generic)\n  // — REB-63: this is what `pages.list`'s `type` filter actually validates\n  // against server-side (`pagesListParamsSchema`), not `LegacyPageType`.\n  PageType,\n  // Legacy DB page type (SERVICE|CUSTOM) — the `type`/`category` fields still\n  // carried on each `PageListItem`/`PageDetail` for backward compat during the\n  // REB-75 dual-read window. NOT the `pages.list` filter's value space anymore.\n  LegacyPageType,\n  PageContentMode,\n  SectionLayout,\n  PageCategoryRef,\n  PageListItem,\n  PageSectionImage,\n  PageSection,\n  PageDetail,\n  PageSlug,\n  // REB-63: `pages.list`'s sort param — same reasoning as AcademyCourseSort\n  // below (a typo is a compile error instead of a silent no-op fallback).\n  PagesListSort,\n  // REB-869 — `pages.list`'s query, incl. `featured` (with `category`: that\n  // category's featured pages, max 3, in their stored order).\n  PagesListQuery,\n  // REB-75 D-D — the typed block registry on `PageDetail.blocks[]`.\n  BlockType,\n  Block,\n  // REB-849 — each block mirrors its parent section's heading/backgroundColor/\n  // cta; REB-851 phase 1 — doctor_embed/specialty_embed blocks additionally\n  // carry `resolved` (present only on those two block types).\n  PageBlock,\n  BlockCta,\n  ResolvedEmbed,\n  // REB-867 — slugs are unique per category: the embed reference shape\n  // (`pageId`/`categorySlug`) and the 409 body of an ambiguous `GET /pages/[slug]`.\n  EmbedReferenceData,\n  PageAmbiguousSlugError,\n} from '@reblu/base-api-contracts'\n\n// Professional profile (REB-63) — pageType='team' only. Sector-agnostic\n// structured CV, same platform-shape/tenant-content split as CustomFieldDefinition.\n// REB-1099: `ProfessionalField` — a tenant-defined field (e.g. a registration\n// number) on the card (`ProfessionalSummary.fields`) and profile.\nexport type {\n  ProfessionalField,\n  ProfessionalSummary,\n  ProfessionalProfile,\n  ProfessionalCv,\n  ProfessionalCvEntry,\n  ProfessionalLanguage,\n  ProfessionalLanguageLevel,\n  ProfessionalSocialLink,\n  ProfessionalSocialPlatform,\n} from '@reblu/base-api-contracts'\n\n// Custom-field registry (REB-475 / REB-75) — entity-agnostic, shared with pages/team\nexport type {\n  CustomFieldValueType,\n  CustomFieldEntityType,\n  CustomFieldOption,\n  CustomFieldDefinition,\n} from '@reblu/base-api-contracts'\n\n// Shop\nexport type {\n  TaxType,\n  ProductType,\n  ShopConfig,\n  // Store-wide product trust items (REB-858)\n  ShopProductTrustIcon,\n  ShopProductTrustItem,\n  ShopTaxRateRef,\n  ShopProductImage,\n  ShopProductVideo,\n  ShopProductCategoryRef,\n  ShopInventoryRef,\n  ShopCategory,\n  ShopProductListItem,\n  ShopProductVariant,\n  ShopBundleComponent,\n  ShopRelatedProduct,\n  ShopProductDetail,\n  // Taxonomy + attributes + facets (REB-474/475)\n  ShopTaxonomyTermRef,\n  ShopProductAttributes,\n  // Per-axis selection mode (REB-809/REB-801)\n  ShopTaxonomySelectionMode,\n  ShopSort,\n  ShopProductListParams,\n  ShopFacets,\n  // Write inputs (REB-438)\n  ShopCartItemInput,\n  ShopAddressInput,\n  ShopBillingInput,\n  ShopCheckoutInput,\n  ShopValidateCartInput,\n  ShopApplyDiscountInput,\n  // Write responses (REB-438)\n  ShopCheckoutSession,\n  ShopCartValidationError,\n  ShopCartValidationItem,\n  ShopCartValidation,\n  ShopDiscountApplication,\n  // Automatic staff discount, additive on the write responses (REB-1131)\n  ShopStaffAutoDiscount,\n  // Order lookup (REB-829)\n  ShopOrderItem,\n  ShopOrder,\n  // The order's invoice reference (REB-73)\n  ShopOrderInvoice,\n  // Stable, machine-readable write-endpoint error codes (REB-836)\n  ShopErrorCode,\n} from '@reblu/base-api-contracts'\n\n// REB-834 — `POST /api/site/shop/check-email` is deprecated: it was an\n// account-enumeration oracle and now always answers `{ exists: false }`.\n// Kept (a minor may only deprecate); removed in the next major.\nexport type {\n  /**\n   * @deprecated REB-834 — `POST /api/site/shop/check-email` no longer reveals\n   * whether an account exists. Do not call it; removed in the next major.\n   */\n  ShopCheckEmailInput,\n  /**\n   * @deprecated REB-834 — `exists` is always `false`. Never branch UI on it:\n   * the checkout always offers «Iniciar sesión o continuar como invitado» and\n   * the server links the order to an existing account after payment. Removed\n   * in the next major.\n   */\n  ShopEmailCheck,\n} from '@reblu/base-api-contracts'\n\n// Academy (REB-507) — public course catalogue. `AcademyCourseSort` is the query\n// contract for the `sort` param, so the SDK can type it as a union instead of a\n// bare string (an unknown key is silently ignored server-side).\nexport type {\n  AcademyCourseSort,\n  // REB-547 — the documented catalogue query: q, sort, category, instructor\n  // (a user id from `GET /api/site/academy/instructors`), free and the price\n  // range in integer cents.\n  AcademyCourseListQuery,\n  AcademyCategoryPublic,\n  AcademyLessonPublic,\n  AcademyModulePublic,\n  AcademyInstructorPublic,\n  AcademyCourseSummary,\n  AcademyCourseDetail,\n  // REB-83 — tenant-configurable validation fields (drives the enrollment CTA form).\n  AcademyValidationFieldPublic,\n  // REB-1135 — a free-preview lesson, viewable by the public\n  // (`GET /api/site/academy/courses/{slug}/lessons/{lessonSlug}`).\n  AcademyLessonPreview,\n  AcademyLessonPreviewVideo,\n} from '@reblu/base-api-contracts'\n\n// Legal\nexport type { Legal } from '@reblu/base-api-contracts'\n\n// CTAs\nexport type { Cta } from '@reblu/base-api-contracts'\n\n// Trust badges\nexport type { TrustBadge, TrustBadgeType } from '@reblu/base-api-contracts'\n\n// SITE capability manifest (`/.well-known/reblu-site.json`) — REB-777.\n// Direction note (see `site-manifest.contract.ts` in base-api): this is the\n// one contract group a SITE produces and base-api consumes, the opposite of\n// every group above. The TYPE still flows through this same alias so the\n// SDK and nexus never describe two different shapes for it; the real Zod\n// validation stays in base-api only — this package never gains a Zod\n// runtime dependency.\nexport type {\n  SiteManifest,\n  SiteManifestSurfaceValue,\n  SiteCapabilitySurfaceKey,\n} from '@reblu/base-api-contracts'\n"]}

package/dist/index.d.cts

@@ -8,6 +8,8 @@ export type AcademyCategoryPublic = {    id: string;    name: string;    slug: s
 
 export type AcademyCourseDetail = {    id: string;    slug: string;    title: string;    shortDescription: string | null;    coverUrl: string | null;    priceCents: number;    accessMode: "IMMEDIATE" | "DRIP" | "COHORT";    category: {        id: string;        name: string;        slug: string;        sortOrder: number;    } | null;    description: string | null;    modules: {        id: string;        title: string;        description: string | null;        lessons: {            id: string;            slug: string;            title: string;            isFreePreview: boolean;            durationSeconds: number | null;            hasVideo: boolean;        }[];    }[];    instructors: {        id: string;        firstName: string | null;        lastName: string | null;        avatarUrl: string | null;    }[];    salesEnabled: boolean;    requiresValidation: boolean;    validationFieldLabel: string | null;    validationFields: {        key: string;        label: string;        required: boolean;        maxLength?: number | undefined;    }[];    metaTitle?: string | null | undefined;    seo?: {        title: string;    } | undefined;}
 
+export type AcademyCourseListQuery = {    page?: number | undefined;    limit?: number | undefined;    q?: string | undefined;    sort?: "price_asc" | "price_desc" | "newest" | undefined;    category?: string | undefined;    instructor?: string | undefined;    free?: boolean | undefined;    priceMin?: number | undefined;    priceMax?: number | undefined;}
+
 export type AcademyCourseSort = "price_asc" | "price_desc" | "newest"
 
 export type AcademyCourseSummary = {    id: string;    slug: string;    title: string;    shortDescription: string | null;    coverUrl: string | null;    priceCents: number;    accessMode: "IMMEDIATE" | "DRIP" | "COHORT";    category: {        id: string;        name: string;        slug: string;        sortOrder: number;    } | null;}
@@ -50,7 +52,7 @@ export type BlogSlug = {    slug: string;    updatedAt: string;}
 
 export type BlogTag = {    id: string;    name: string;    slug: string;    color: string;}
 
-export type Config = {    siteName: string;    siteDescription: string | null;    language: string | null;    contactEmail: string | null;    keywords: string[];    businessType: string | null;    isSetupComplete: boolean;    logoLightExpandedUrl: string | null;    logoDarkExpandedUrl: string | null;    logoLightSmallUrl: string | null;    logoDarkSmallUrl: string | null;    ogImageUrl: string | null;    owner: {        name: string | null;        email: string | null;        jobTitle: string | null;    };    business: {        name: string | null;    };    address: {        street: string | null;        city: string | null;        region: string | null;        postalCode: string | null;        country: string | null;        telephone: string | null;        lat: number | null;        lng: number | null;    } | null;    fiscal: {        taxId: string | null;        taxIdKind: "NIF" | "CIF" | null;        legalName: string | null;        registry: {            name: string;            number: string;        } | null;    } | null;    social: {        linkedin: string | null;        twitter: string | null;        facebook: string | null;        instagram: string | null;        youtube: string | null;    } | null;    metadata: unknown;    openingHours: {        ranges: {            days: ("MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "SUN")[];            opens: string;            closes: string;        }[];        note?: string | undefined;    } | null;    contactFormMode: "NOT_CONFIGURED" | "DISABLED" | "DB_ONLY" | "WEBHOOK" | "RESEND";    features: Record<string, unknown>;    seoTitleTemplate?: string | undefined;    seoTitle?: string | null | undefined;    seoDescription?: string | null | undefined;    canonicalUrl?: string | null | undefined;}
+export type Config = {    siteName: string;    siteDescription: string | null;    language: string | null;    contactEmail: string | null;    keywords: string[];    businessType: string | null;    isSetupComplete: boolean;    logoLightExpandedUrl: string | null;    logoDarkExpandedUrl: string | null;    logoLightSmallUrl: string | null;    logoDarkSmallUrl: string | null;    ogImageUrl: string | null;    owner: {        name: string | null;        email: string | null;        jobTitle: string | null;    };    business: {        name: string | null;    };    address: {        street: string | null;        city: string | null;        region: string | null;        postalCode: string | null;        country: string | null;        telephone: string | null;        lat: number | null;        lng: number | null;    } | null;    fiscal: {        taxId: string | null;        taxIdKind: "NIF" | "CIF" | null;        legalName: string | null;        registry: {            name: string;            number: string;        } | null;    } | null;    social: {        linkedin: string | null;        twitter: string | null;        facebook: string | null;        instagram: string | null;        youtube: string | null;    } | null;    metadata: unknown;    openingHours: {        ranges: {            days: ("MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "SUN")[];            opens: string;            closes: string;        }[];        note?: string | undefined;    } | null;    contactFormMode: "NOT_CONFIGURED" | "DISABLED" | "DB_ONLY" | "WEBHOOK" | "RESEND";    features: Record<string, unknown>;    seoTitleTemplate?: string | undefined;    seoTitle?: string | null | undefined;    seoDescription?: string | null | undefined;    canonicalUrl?: string | null | undefined;    contactInterest?: {        label: string;        options: string[];    } | null | undefined;}
 
 export type ConfigAddress = {    street: string | null;    city: string | null;    region: string | null;    postalCode: string | null;    country: string | null;    telephone: string | null;    lat: number | null;    lng: number | null;}
 
@@ -68,7 +70,7 @@ export type ConfigSocial = {    linkedin: string | null;    twitter: string | nu
 
 export type ConfigTaxIdKind = "NIF" | "CIF"
 
-export type ContactFormInput = {    name: string;    email: string;    phone: string;    message: string;    agreement: boolean;    captcha: string;    metadata: {        fromPage: string;        timestamp: string;        currentUrl: string;        leadSource?: {            platform: string;        } | undefined;        attribution?: {            first?: {                utm?: {                    source?: string | undefined;                    medium?: string | undefined;                    campaign?: string | undefined;                    content?: string | undefined;                    term?: string | undefined;                } | undefined;                clickIds?: string[] | undefined;                referrer?: string | undefined;                landingPath?: string | undefined;                at?: string | undefined;            } | undefined;            last?: {                utm?: {                    source?: string | undefined;                    medium?: string | undefined;                    campaign?: string | undefined;                    content?: string | undefined;                    term?: string | undefined;                } | undefined;                clickIds?: string[] | undefined;                referrer?: string | undefined;                landingPath?: string | undefined;                at?: string | undefined;            } | undefined;        } | undefined;    };    surname?: string | undefined;    businessName?: string | undefined;}
+export type ContactFormInput = {    name: string;    email: string;    phone: string;    message: string;    agreement: boolean;    captcha: string;    metadata: {        fromPage: string;        timestamp: string;        currentUrl: string;        leadSource?: {            platform: string;        } | undefined;        attribution?: {            first?: {                utm?: {                    source?: string | undefined;                    medium?: string | undefined;                    campaign?: string | undefined;                    content?: string | undefined;                    term?: string | undefined;                } | undefined;                clickIds?: string[] | undefined;                referrer?: string | undefined;                landingPath?: string | undefined;                at?: string | undefined;            } | undefined;            last?: {                utm?: {                    source?: string | undefined;                    medium?: string | undefined;                    campaign?: string | undefined;                    content?: string | undefined;                    term?: string | undefined;                } | undefined;                clickIds?: string[] | undefined;                referrer?: string | undefined;                landingPath?: string | undefined;                at?: string | undefined;            } | undefined;        } | undefined;    };    surname?: string | undefined;    businessName?: string | undefined;    interests?: string[] | undefined;}
 
 export type ContactFormMode = "NOT_CONFIGURED" | "DISABLED" | "DB_ONLY" | "WEBHOOK" | "RESEND"
 
@@ -198,7 +200,7 @@ export type ShopDiscountApplication = {    valid: boolean;    discount: number;
  */
 export type ShopEmailCheck = {    exists: boolean;}
 
-export type ShopErrorCode = "STOCK_CHANGED" | "PRICE_CHANGED" | "PRODUCT_UNAVAILABLE" | "DISCOUNT_INVALID" | "SHIPPING_UNAVAILABLE" | "INVALID_INPUT" | "STORE_DISABLED" | "PAYMENT_PROVIDER_ERROR" | "INTERNAL_ERROR" | "BILLING_DATA_REQUIRED" | "INVOICING_NOT_READY" | "FULL_INVOICE_UNAVAILABLE"
+export type ShopErrorCode = "STOCK_CHANGED" | "PRICE_CHANGED" | "PRODUCT_UNAVAILABLE" | "DISCOUNT_INVALID" | "SHIPPING_UNAVAILABLE" | "INVALID_INPUT" | "STORE_DISABLED" | "PAYMENT_PROVIDER_ERROR" | "INTERNAL_ERROR" | "BILLING_DATA_REQUIRED" | "INVOICING_NOT_READY" | "FULL_INVOICE_UNAVAILABLE" | "DISCOUNT_LIMIT_REACHED"
 
 export type ShopFacets = {    taxonomies: {        key: string;        label: string;        showAsBadge: boolean;        selectionMode: "single" | "multiple";        terms: {            slug: string;            name: string;            count: number;        }[];    }[];    attributes: {        key: string;        label: string;        valueType: "boolean" | "text" | "select" | "multiselect";        options: {            value: string;            label: string;            count: number;        }[];    }[];    price: {        min: number;        max: number;    };    onSale: {        count: number;    };}
 

package/dist/index.d.ts

@@ -8,6 +8,8 @@ export type AcademyCategoryPublic = {    id: string;    name: string;    slug: s
 
 export type AcademyCourseDetail = {    id: string;    slug: string;    title: string;    shortDescription: string | null;    coverUrl: string | null;    priceCents: number;    accessMode: "IMMEDIATE" | "DRIP" | "COHORT";    category: {        id: string;        name: string;        slug: string;        sortOrder: number;    } | null;    description: string | null;    modules: {        id: string;        title: string;        description: string | null;        lessons: {            id: string;            slug: string;            title: string;            isFreePreview: boolean;            durationSeconds: number | null;            hasVideo: boolean;        }[];    }[];    instructors: {        id: string;        firstName: string | null;        lastName: string | null;        avatarUrl: string | null;    }[];    salesEnabled: boolean;    requiresValidation: boolean;    validationFieldLabel: string | null;    validationFields: {        key: string;        label: string;        required: boolean;        maxLength?: number | undefined;    }[];    metaTitle?: string | null | undefined;    seo?: {        title: string;    } | undefined;}
 
+export type AcademyCourseListQuery = {    page?: number | undefined;    limit?: number | undefined;    q?: string | undefined;    sort?: "price_asc" | "price_desc" | "newest" | undefined;    category?: string | undefined;    instructor?: string | undefined;    free?: boolean | undefined;    priceMin?: number | undefined;    priceMax?: number | undefined;}
+
 export type AcademyCourseSort = "price_asc" | "price_desc" | "newest"
 
 export type AcademyCourseSummary = {    id: string;    slug: string;    title: string;    shortDescription: string | null;    coverUrl: string | null;    priceCents: number;    accessMode: "IMMEDIATE" | "DRIP" | "COHORT";    category: {        id: string;        name: string;        slug: string;        sortOrder: number;    } | null;}
@@ -50,7 +52,7 @@ export type BlogSlug = {    slug: string;    updatedAt: string;}
 
 export type BlogTag = {    id: string;    name: string;    slug: string;    color: string;}
 
-export type Config = {    siteName: string;    siteDescription: string | null;    language: string | null;    contactEmail: string | null;    keywords: string[];    businessType: string | null;    isSetupComplete: boolean;    logoLightExpandedUrl: string | null;    logoDarkExpandedUrl: string | null;    logoLightSmallUrl: string | null;    logoDarkSmallUrl: string | null;    ogImageUrl: string | null;    owner: {        name: string | null;        email: string | null;        jobTitle: string | null;    };    business: {        name: string | null;    };    address: {        street: string | null;        city: string | null;        region: string | null;        postalCode: string | null;        country: string | null;        telephone: string | null;        lat: number | null;        lng: number | null;    } | null;    fiscal: {        taxId: string | null;        taxIdKind: "NIF" | "CIF" | null;        legalName: string | null;        registry: {            name: string;            number: string;        } | null;    } | null;    social: {        linkedin: string | null;        twitter: string | null;        facebook: string | null;        instagram: string | null;        youtube: string | null;    } | null;    metadata: unknown;    openingHours: {        ranges: {            days: ("MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "SUN")[];            opens: string;            closes: string;        }[];        note?: string | undefined;    } | null;    contactFormMode: "NOT_CONFIGURED" | "DISABLED" | "DB_ONLY" | "WEBHOOK" | "RESEND";    features: Record<string, unknown>;    seoTitleTemplate?: string | undefined;    seoTitle?: string | null | undefined;    seoDescription?: string | null | undefined;    canonicalUrl?: string | null | undefined;}
+export type Config = {    siteName: string;    siteDescription: string | null;    language: string | null;    contactEmail: string | null;    keywords: string[];    businessType: string | null;    isSetupComplete: boolean;    logoLightExpandedUrl: string | null;    logoDarkExpandedUrl: string | null;    logoLightSmallUrl: string | null;    logoDarkSmallUrl: string | null;    ogImageUrl: string | null;    owner: {        name: string | null;        email: string | null;        jobTitle: string | null;    };    business: {        name: string | null;    };    address: {        street: string | null;        city: string | null;        region: string | null;        postalCode: string | null;        country: string | null;        telephone: string | null;        lat: number | null;        lng: number | null;    } | null;    fiscal: {        taxId: string | null;        taxIdKind: "NIF" | "CIF" | null;        legalName: string | null;        registry: {            name: string;            number: string;        } | null;    } | null;    social: {        linkedin: string | null;        twitter: string | null;        facebook: string | null;        instagram: string | null;        youtube: string | null;    } | null;    metadata: unknown;    openingHours: {        ranges: {            days: ("MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "SUN")[];            opens: string;            closes: string;        }[];        note?: string | undefined;    } | null;    contactFormMode: "NOT_CONFIGURED" | "DISABLED" | "DB_ONLY" | "WEBHOOK" | "RESEND";    features: Record<string, unknown>;    seoTitleTemplate?: string | undefined;    seoTitle?: string | null | undefined;    seoDescription?: string | null | undefined;    canonicalUrl?: string | null | undefined;    contactInterest?: {        label: string;        options: string[];    } | null | undefined;}
 
 export type ConfigAddress = {    street: string | null;    city: string | null;    region: string | null;    postalCode: string | null;    country: string | null;    telephone: string | null;    lat: number | null;    lng: number | null;}
 
@@ -68,7 +70,7 @@ export type ConfigSocial = {    linkedin: string | null;    twitter: string | nu
 
 export type ConfigTaxIdKind = "NIF" | "CIF"
 
-export type ContactFormInput = {    name: string;    email: string;    phone: string;    message: string;    agreement: boolean;    captcha: string;    metadata: {        fromPage: string;        timestamp: string;        currentUrl: string;        leadSource?: {            platform: string;        } | undefined;        attribution?: {            first?: {                utm?: {                    source?: string | undefined;                    medium?: string | undefined;                    campaign?: string | undefined;                    content?: string | undefined;                    term?: string | undefined;                } | undefined;                clickIds?: string[] | undefined;                referrer?: string | undefined;                landingPath?: string | undefined;                at?: string | undefined;            } | undefined;            last?: {                utm?: {                    source?: string | undefined;                    medium?: string | undefined;                    campaign?: string | undefined;                    content?: string | undefined;                    term?: string | undefined;                } | undefined;                clickIds?: string[] | undefined;                referrer?: string | undefined;                landingPath?: string | undefined;                at?: string | undefined;            } | undefined;        } | undefined;    };    surname?: string | undefined;    businessName?: string | undefined;}
+export type ContactFormInput = {    name: string;    email: string;    phone: string;    message: string;    agreement: boolean;    captcha: string;    metadata: {        fromPage: string;        timestamp: string;        currentUrl: string;        leadSource?: {            platform: string;        } | undefined;        attribution?: {            first?: {                utm?: {                    source?: string | undefined;                    medium?: string | undefined;                    campaign?: string | undefined;                    content?: string | undefined;                    term?: string | undefined;                } | undefined;                clickIds?: string[] | undefined;                referrer?: string | undefined;                landingPath?: string | undefined;                at?: string | undefined;            } | undefined;            last?: {                utm?: {                    source?: string | undefined;                    medium?: string | undefined;                    campaign?: string | undefined;                    content?: string | undefined;                    term?: string | undefined;                } | undefined;                clickIds?: string[] | undefined;                referrer?: string | undefined;                landingPath?: string | undefined;                at?: string | undefined;            } | undefined;        } | undefined;    };    surname?: string | undefined;    businessName?: string | undefined;    interests?: string[] | undefined;}
 
 export type ContactFormMode = "NOT_CONFIGURED" | "DISABLED" | "DB_ONLY" | "WEBHOOK" | "RESEND"
 
@@ -198,7 +200,7 @@ export type ShopDiscountApplication = {    valid: boolean;    discount: number;
  */
 export type ShopEmailCheck = {    exists: boolean;}
 
-export type ShopErrorCode = "STOCK_CHANGED" | "PRICE_CHANGED" | "PRODUCT_UNAVAILABLE" | "DISCOUNT_INVALID" | "SHIPPING_UNAVAILABLE" | "INVALID_INPUT" | "STORE_DISABLED" | "PAYMENT_PROVIDER_ERROR" | "INTERNAL_ERROR" | "BILLING_DATA_REQUIRED" | "INVOICING_NOT_READY" | "FULL_INVOICE_UNAVAILABLE"
+export type ShopErrorCode = "STOCK_CHANGED" | "PRICE_CHANGED" | "PRODUCT_UNAVAILABLE" | "DISCOUNT_INVALID" | "SHIPPING_UNAVAILABLE" | "INVALID_INPUT" | "STORE_DISABLED" | "PAYMENT_PROVIDER_ERROR" | "INTERNAL_ERROR" | "BILLING_DATA_REQUIRED" | "INVOICING_NOT_READY" | "FULL_INVOICE_UNAVAILABLE" | "DISCOUNT_LIMIT_REACHED"
 
 export type ShopFacets = {    taxonomies: {        key: string;        label: string;        showAsBadge: boolean;        selectionMode: "single" | "multiple";        terms: {            slug: string;            name: string;            count: number;        }[];    }[];    attributes: {        key: string;        label: string;        valueType: "boolean" | "text" | "select" | "multiselect";        options: {            value: string;            label: string;            count: number;        }[];    }[];    price: {        min: number;        max: number;    };    onSale: {        count: number;    };}
 

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAkFO,IAAM,kBAAA,GAAqB,OAAO,MAAA,CAAO;AAAA,EAC9C,QAAA;AAAA,EACA,eAAA;AAAA,EACA,SAAA;AAAA,EACA,WAAA;AAAA,EACA,aAAA;AAAA,EACA,aAAA;AAAA,EACA,oBAAA;AAAA,EACA;AACF,CAAU","file":"index.js","sourcesContent":["/**\n * `@reblu/site-contracts` — public, dependency-free TypeScript types for the\n * Reblu SITE API (REB-414 / design doc §2).\n *\n * These types are the SDK-facing view of every `/api/site/*` response. They are\n * re-derived (`z.infer`) from the hand-authored response schemas that live in\n * base-api (`apps/base-api/src/lib/contracts/*.contract.ts`) and imported here\n * through the build-time-only `@reblu/base-api-contracts` type alias.\n *\n * Guarantees (enforced by the leakage guard tests):\n *   - Everything below is `export type` — the import is erased at build time, so\n *     NO Zod and NO Prisma reaches a consumer's runtime or `node_modules` graph.\n *     The one exception is `DATA_REQUEST_TYPES` (REB-1005): a plain, import-free\n *     array literal, the package's only runtime value.\n *   - The published `.d.ts` is flattened and self-contained: the alias and\n *     `z.infer` do not survive into the emitted declarations.\n *   - Never re-exports an internal / Prisma-generated type — only the public\n *     output DTOs base-api explicitly publishes.\n *\n * When base-api adds a new public contract type, add it to the matching group\n * below. The explicit list (over `export type *`) keeps the public surface a\n * reviewed, intentional decision and avoids leaking internal `*Schema` names.\n */\n\n// Envelope / pagination\nexport type { PaginationMeta } from '@reblu/base-api-contracts'\n\n// Analytics + shared contact-form mode\nexport type { Analytics, ContactFormMode } from '@reblu/base-api-contracts'\n\n// REB-845 — the tenant-editable cookie banner copy shape, standalone (not just\n// nested in `Analytics`), so `@reblu/site-next`'s `cookieBannerToConsentTexts`\n// can type its input against the real contract instead of a hand-rolled copy.\nexport type { CookieBanner } from '@reblu/base-api-contracts'\n\n// Site config\nexport type {\n  Config,\n  ConfigAddress,\n  ConfigFiscal,\n  ConfigFiscalRegistry,\n  ConfigSocial,\n  ConfigTaxIdKind,\n  // REB-826 — typed opening hours.\n  ConfigOpeningHours,\n  ConfigOpeningHoursRange,\n  ConfigOpeningHoursDay,\n} from '@reblu/base-api-contracts'\n\n// REB-871 — the resolved `seo` block on every detail response (pages, blog\n// posts, shop products, academy courses). `seo.title` is the FINAL page title.\nexport type { Seo } from '@reblu/base-api-contracts'\n\n// Contact form\nexport type { ContactFormSubmission, ContactFormInput } from '@reblu/base-api-contracts'\n// REB-1078 — the raw lead-origin touches a SITE sends in `metadata.attribution`\n// (contact form and `/api/site/leads`); base-api classifies the channel.\nexport type { LeadAttribution, LeadTouch } from '@reblu/base-api-contracts'\n\n// Leads\nexport type { LeadInput, LeadSubmission } from '@reblu/base-api-contracts'\n\n// GDPR data-subject requests (REB-77 endpoint, REB-980 SDK) — the public\n// `/derechos-rgpd` form body and its 72h acknowledgement.\nexport type {\n  DataRequestInput,\n  DataRequestSubmission,\n  DataRequestType,\n} from '@reblu/base-api-contracts'\nimport type { DataRequestType } from '@reblu/base-api-contracts'\n\n/**\n * REB-1005 — every GDPR right a data subject can exercise, in base-api's order.\n * The ONE runtime value this package ships: server code (a SITE's Route\n * Handler, `@reblu/site-next`'s `createDataRequestRoute`) needs the list too,\n * and `@reblu/site-blocks` re-exports it as before.\n *\n * Single source: base-api's `dataRequestTypeSchema`. `satisfies` rejects a\n * member base-api does not know, `MissingDataRequestType` below rejects one it\n * knows and this list lacks, and `tests/unit/data-request-types.test.ts` pins\n * the order. Plain array literal, no import — the runtime stays dependency-free.\n */\nexport const DATA_REQUEST_TYPES = Object.freeze([\n  'ACCESS',\n  'RECTIFICATION',\n  'ERASURE',\n  'OBJECTION',\n  'PORTABILITY',\n  'RESTRICTION',\n  'AUTOMATED_DECISION',\n  'INFORMATION',\n] as const) satisfies readonly DataRequestType[]\n\n/** Compile error when base-api adds a right this list does not carry. */\ntype AssertNoneMissing<T extends never> = T\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\ntype MissingDataRequestType = AssertNoneMissing<\n  Exclude<DataRequestType, (typeof DATA_REQUEST_TYPES)[number]>\n>\n\n// Blog\nexport type {\n  BlogAuthor,\n  BlogAuthorDetail,\n  BlogCategory,\n  BlogCategoryWithCount,\n  BlogTag,\n  BlogPostListItem,\n  BlogPostDetail,\n  BlogPostPreview,\n  BlogSlug,\n} from '@reblu/base-api-contracts'\n\n// Pages\nexport type {\n  // The flexible pageType (service|custom|treatments|specialties|team|generic)\n  // — REB-63: this is what `pages.list`'s `type` filter actually validates\n  // against server-side (`pagesListParamsSchema`), not `LegacyPageType`.\n  PageType,\n  // Legacy DB page type (SERVICE|CUSTOM) — the `type`/`category` fields still\n  // carried on each `PageListItem`/`PageDetail` for backward compat during the\n  // REB-75 dual-read window. NOT the `pages.list` filter's value space anymore.\n  LegacyPageType,\n  PageContentMode,\n  SectionLayout,\n  PageCategoryRef,\n  PageListItem,\n  PageSectionImage,\n  PageSection,\n  PageDetail,\n  PageSlug,\n  // REB-63: `pages.list`'s sort param — same reasoning as AcademyCourseSort\n  // below (a typo is a compile error instead of a silent no-op fallback).\n  PagesListSort,\n  // REB-869 — `pages.list`'s query, incl. `featured` (with `category`: that\n  // category's featured pages, max 3, in their stored order).\n  PagesListQuery,\n  // REB-75 D-D — the typed block registry on `PageDetail.blocks[]`.\n  BlockType,\n  Block,\n  // REB-849 — each block mirrors its parent section's heading/backgroundColor/\n  // cta; REB-851 phase 1 — doctor_embed/specialty_embed blocks additionally\n  // carry `resolved` (present only on those two block types).\n  PageBlock,\n  BlockCta,\n  ResolvedEmbed,\n  // REB-867 — slugs are unique per category: the embed reference shape\n  // (`pageId`/`categorySlug`) and the 409 body of an ambiguous `GET /pages/[slug]`.\n  EmbedReferenceData,\n  PageAmbiguousSlugError,\n} from '@reblu/base-api-contracts'\n\n// Professional profile (REB-63) — pageType='team' only. Sector-agnostic\n// structured CV, same platform-shape/tenant-content split as CustomFieldDefinition.\n// REB-1099: `ProfessionalField` — a tenant-defined field (e.g. a registration\n// number) on the card (`ProfessionalSummary.fields`) and profile.\nexport type {\n  ProfessionalField,\n  ProfessionalSummary,\n  ProfessionalProfile,\n  ProfessionalCv,\n  ProfessionalCvEntry,\n  ProfessionalLanguage,\n  ProfessionalLanguageLevel,\n  ProfessionalSocialLink,\n  ProfessionalSocialPlatform,\n} from '@reblu/base-api-contracts'\n\n// Custom-field registry (REB-475 / REB-75) — entity-agnostic, shared with pages/team\nexport type {\n  CustomFieldValueType,\n  CustomFieldEntityType,\n  CustomFieldOption,\n  CustomFieldDefinition,\n} from '@reblu/base-api-contracts'\n\n// Shop\nexport type {\n  TaxType,\n  ProductType,\n  ShopConfig,\n  // Store-wide product trust items (REB-858)\n  ShopProductTrustIcon,\n  ShopProductTrustItem,\n  ShopTaxRateRef,\n  ShopProductImage,\n  ShopProductVideo,\n  ShopProductCategoryRef,\n  ShopInventoryRef,\n  ShopCategory,\n  ShopProductListItem,\n  ShopProductVariant,\n  ShopBundleComponent,\n  ShopRelatedProduct,\n  ShopProductDetail,\n  // Taxonomy + attributes + facets (REB-474/475)\n  ShopTaxonomyTermRef,\n  ShopProductAttributes,\n  // Per-axis selection mode (REB-809/REB-801)\n  ShopTaxonomySelectionMode,\n  ShopSort,\n  ShopProductListParams,\n  ShopFacets,\n  // Write inputs (REB-438)\n  ShopCartItemInput,\n  ShopAddressInput,\n  ShopBillingInput,\n  ShopCheckoutInput,\n  ShopValidateCartInput,\n  ShopApplyDiscountInput,\n  // Write responses (REB-438)\n  ShopCheckoutSession,\n  ShopCartValidationError,\n  ShopCartValidationItem,\n  ShopCartValidation,\n  ShopDiscountApplication,\n  // Automatic staff discount, additive on the write responses (REB-1131)\n  ShopStaffAutoDiscount,\n  // Order lookup (REB-829)\n  ShopOrderItem,\n  ShopOrder,\n  // The order's invoice reference (REB-73)\n  ShopOrderInvoice,\n  // Stable, machine-readable write-endpoint error codes (REB-836)\n  ShopErrorCode,\n} from '@reblu/base-api-contracts'\n\n// REB-834 — `POST /api/site/shop/check-email` is deprecated: it was an\n// account-enumeration oracle and now always answers `{ exists: false }`.\n// Kept (a minor may only deprecate); removed in the next major.\nexport type {\n  /**\n   * @deprecated REB-834 — `POST /api/site/shop/check-email` no longer reveals\n   * whether an account exists. Do not call it; removed in the next major.\n   */\n  ShopCheckEmailInput,\n  /**\n   * @deprecated REB-834 — `exists` is always `false`. Never branch UI on it:\n   * the checkout always offers «Iniciar sesión o continuar como invitado» and\n   * the server links the order to an existing account after payment. Removed\n   * in the next major.\n   */\n  ShopEmailCheck,\n} from '@reblu/base-api-contracts'\n\n// Academy (REB-507) — public course catalogue. `AcademyCourseSort` is the query\n// contract for the `sort` param, so the SDK can type it as a union instead of a\n// bare string (an unknown key is silently ignored server-side).\nexport type {\n  AcademyCourseSort,\n  AcademyCategoryPublic,\n  AcademyLessonPublic,\n  AcademyModulePublic,\n  AcademyInstructorPublic,\n  AcademyCourseSummary,\n  AcademyCourseDetail,\n  // REB-83 — tenant-configurable validation fields (drives the enrollment CTA form).\n  AcademyValidationFieldPublic,\n  // REB-1135 — a free-preview lesson, viewable by the public\n  // (`GET /api/site/academy/courses/{slug}/lessons/{lessonSlug}`).\n  AcademyLessonPreview,\n  AcademyLessonPreviewVideo,\n} from '@reblu/base-api-contracts'\n\n// Legal\nexport type { Legal } from '@reblu/base-api-contracts'\n\n// CTAs\nexport type { Cta } from '@reblu/base-api-contracts'\n\n// Trust badges\nexport type { TrustBadge, TrustBadgeType } from '@reblu/base-api-contracts'\n\n// SITE capability manifest (`/.well-known/reblu-site.json`) — REB-777.\n// Direction note (see `site-manifest.contract.ts` in base-api): this is the\n// one contract group a SITE produces and base-api consumes, the opposite of\n// every group above. The TYPE still flows through this same alias so the\n// SDK and nexus never describe two different shapes for it; the real Zod\n// validation stays in base-api only — this package never gains a Zod\n// runtime dependency.\nexport type {\n  SiteManifest,\n  SiteManifestSurfaceValue,\n  SiteCapabilitySurfaceKey,\n} from '@reblu/base-api-contracts'\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAkFO,IAAM,kBAAA,GAAqB,OAAO,MAAA,CAAO;AAAA,EAC9C,QAAA;AAAA,EACA,eAAA;AAAA,EACA,SAAA;AAAA,EACA,WAAA;AAAA,EACA,aAAA;AAAA,EACA,aAAA;AAAA,EACA,oBAAA;AAAA,EACA;AACF,CAAU","file":"index.js","sourcesContent":["/**\n * `@reblu/site-contracts` — public, dependency-free TypeScript types for the\n * Reblu SITE API (REB-414 / design doc §2).\n *\n * These types are the SDK-facing view of every `/api/site/*` response. They are\n * re-derived (`z.infer`) from the hand-authored response schemas that live in\n * base-api (`apps/base-api/src/lib/contracts/*.contract.ts`) and imported here\n * through the build-time-only `@reblu/base-api-contracts` type alias.\n *\n * Guarantees (enforced by the leakage guard tests):\n *   - Everything below is `export type` — the import is erased at build time, so\n *     NO Zod and NO Prisma reaches a consumer's runtime or `node_modules` graph.\n *     The one exception is `DATA_REQUEST_TYPES` (REB-1005): a plain, import-free\n *     array literal, the package's only runtime value.\n *   - The published `.d.ts` is flattened and self-contained: the alias and\n *     `z.infer` do not survive into the emitted declarations.\n *   - Never re-exports an internal / Prisma-generated type — only the public\n *     output DTOs base-api explicitly publishes.\n *\n * When base-api adds a new public contract type, add it to the matching group\n * below. The explicit list (over `export type *`) keeps the public surface a\n * reviewed, intentional decision and avoids leaking internal `*Schema` names.\n */\n\n// Envelope / pagination\nexport type { PaginationMeta } from '@reblu/base-api-contracts'\n\n// Analytics + shared contact-form mode\nexport type { Analytics, ContactFormMode } from '@reblu/base-api-contracts'\n\n// REB-845 — the tenant-editable cookie banner copy shape, standalone (not just\n// nested in `Analytics`), so `@reblu/site-next`'s `cookieBannerToConsentTexts`\n// can type its input against the real contract instead of a hand-rolled copy.\nexport type { CookieBanner } from '@reblu/base-api-contracts'\n\n// Site config\nexport type {\n  Config,\n  ConfigAddress,\n  ConfigFiscal,\n  ConfigFiscalRegistry,\n  ConfigSocial,\n  ConfigTaxIdKind,\n  // REB-826 — typed opening hours.\n  ConfigOpeningHours,\n  ConfigOpeningHoursRange,\n  ConfigOpeningHoursDay,\n} from '@reblu/base-api-contracts'\n\n// REB-871 — the resolved `seo` block on every detail response (pages, blog\n// posts, shop products, academy courses). `seo.title` is the FINAL page title.\nexport type { Seo } from '@reblu/base-api-contracts'\n\n// Contact form\nexport type { ContactFormSubmission, ContactFormInput } from '@reblu/base-api-contracts'\n// REB-1078 — the raw lead-origin touches a SITE sends in `metadata.attribution`\n// (contact form and `/api/site/leads`); base-api classifies the channel.\nexport type { LeadAttribution, LeadTouch } from '@reblu/base-api-contracts'\n\n// Leads\nexport type { LeadInput, LeadSubmission } from '@reblu/base-api-contracts'\n\n// GDPR data-subject requests (REB-77 endpoint, REB-980 SDK) — the public\n// `/derechos-rgpd` form body and its 72h acknowledgement.\nexport type {\n  DataRequestInput,\n  DataRequestSubmission,\n  DataRequestType,\n} from '@reblu/base-api-contracts'\nimport type { DataRequestType } from '@reblu/base-api-contracts'\n\n/**\n * REB-1005 — every GDPR right a data subject can exercise, in base-api's order.\n * The ONE runtime value this package ships: server code (a SITE's Route\n * Handler, `@reblu/site-next`'s `createDataRequestRoute`) needs the list too,\n * and `@reblu/site-blocks` re-exports it as before.\n *\n * Single source: base-api's `dataRequestTypeSchema`. `satisfies` rejects a\n * member base-api does not know, `MissingDataRequestType` below rejects one it\n * knows and this list lacks, and `tests/unit/data-request-types.test.ts` pins\n * the order. Plain array literal, no import — the runtime stays dependency-free.\n */\nexport const DATA_REQUEST_TYPES = Object.freeze([\n  'ACCESS',\n  'RECTIFICATION',\n  'ERASURE',\n  'OBJECTION',\n  'PORTABILITY',\n  'RESTRICTION',\n  'AUTOMATED_DECISION',\n  'INFORMATION',\n] as const) satisfies readonly DataRequestType[]\n\n/** Compile error when base-api adds a right this list does not carry. */\ntype AssertNoneMissing<T extends never> = T\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\ntype MissingDataRequestType = AssertNoneMissing<\n  Exclude<DataRequestType, (typeof DATA_REQUEST_TYPES)[number]>\n>\n\n// Blog\nexport type {\n  BlogAuthor,\n  BlogAuthorDetail,\n  BlogCategory,\n  BlogCategoryWithCount,\n  BlogTag,\n  BlogPostListItem,\n  BlogPostDetail,\n  BlogPostPreview,\n  BlogSlug,\n} from '@reblu/base-api-contracts'\n\n// Pages\nexport type {\n  // The flexible pageType (service|custom|treatments|specialties|team|generic)\n  // — REB-63: this is what `pages.list`'s `type` filter actually validates\n  // against server-side (`pagesListParamsSchema`), not `LegacyPageType`.\n  PageType,\n  // Legacy DB page type (SERVICE|CUSTOM) — the `type`/`category` fields still\n  // carried on each `PageListItem`/`PageDetail` for backward compat during the\n  // REB-75 dual-read window. NOT the `pages.list` filter's value space anymore.\n  LegacyPageType,\n  PageContentMode,\n  SectionLayout,\n  PageCategoryRef,\n  PageListItem,\n  PageSectionImage,\n  PageSection,\n  PageDetail,\n  PageSlug,\n  // REB-63: `pages.list`'s sort param — same reasoning as AcademyCourseSort\n  // below (a typo is a compile error instead of a silent no-op fallback).\n  PagesListSort,\n  // REB-869 — `pages.list`'s query, incl. `featured` (with `category`: that\n  // category's featured pages, max 3, in their stored order).\n  PagesListQuery,\n  // REB-75 D-D — the typed block registry on `PageDetail.blocks[]`.\n  BlockType,\n  Block,\n  // REB-849 — each block mirrors its parent section's heading/backgroundColor/\n  // cta; REB-851 phase 1 — doctor_embed/specialty_embed blocks additionally\n  // carry `resolved` (present only on those two block types).\n  PageBlock,\n  BlockCta,\n  ResolvedEmbed,\n  // REB-867 — slugs are unique per category: the embed reference shape\n  // (`pageId`/`categorySlug`) and the 409 body of an ambiguous `GET /pages/[slug]`.\n  EmbedReferenceData,\n  PageAmbiguousSlugError,\n} from '@reblu/base-api-contracts'\n\n// Professional profile (REB-63) — pageType='team' only. Sector-agnostic\n// structured CV, same platform-shape/tenant-content split as CustomFieldDefinition.\n// REB-1099: `ProfessionalField` — a tenant-defined field (e.g. a registration\n// number) on the card (`ProfessionalSummary.fields`) and profile.\nexport type {\n  ProfessionalField,\n  ProfessionalSummary,\n  ProfessionalProfile,\n  ProfessionalCv,\n  ProfessionalCvEntry,\n  ProfessionalLanguage,\n  ProfessionalLanguageLevel,\n  ProfessionalSocialLink,\n  ProfessionalSocialPlatform,\n} from '@reblu/base-api-contracts'\n\n// Custom-field registry (REB-475 / REB-75) — entity-agnostic, shared with pages/team\nexport type {\n  CustomFieldValueType,\n  CustomFieldEntityType,\n  CustomFieldOption,\n  CustomFieldDefinition,\n} from '@reblu/base-api-contracts'\n\n// Shop\nexport type {\n  TaxType,\n  ProductType,\n  ShopConfig,\n  // Store-wide product trust items (REB-858)\n  ShopProductTrustIcon,\n  ShopProductTrustItem,\n  ShopTaxRateRef,\n  ShopProductImage,\n  ShopProductVideo,\n  ShopProductCategoryRef,\n  ShopInventoryRef,\n  ShopCategory,\n  ShopProductListItem,\n  ShopProductVariant,\n  ShopBundleComponent,\n  ShopRelatedProduct,\n  ShopProductDetail,\n  // Taxonomy + attributes + facets (REB-474/475)\n  ShopTaxonomyTermRef,\n  ShopProductAttributes,\n  // Per-axis selection mode (REB-809/REB-801)\n  ShopTaxonomySelectionMode,\n  ShopSort,\n  ShopProductListParams,\n  ShopFacets,\n  // Write inputs (REB-438)\n  ShopCartItemInput,\n  ShopAddressInput,\n  ShopBillingInput,\n  ShopCheckoutInput,\n  ShopValidateCartInput,\n  ShopApplyDiscountInput,\n  // Write responses (REB-438)\n  ShopCheckoutSession,\n  ShopCartValidationError,\n  ShopCartValidationItem,\n  ShopCartValidation,\n  ShopDiscountApplication,\n  // Automatic staff discount, additive on the write responses (REB-1131)\n  ShopStaffAutoDiscount,\n  // Order lookup (REB-829)\n  ShopOrderItem,\n  ShopOrder,\n  // The order's invoice reference (REB-73)\n  ShopOrderInvoice,\n  // Stable, machine-readable write-endpoint error codes (REB-836)\n  ShopErrorCode,\n} from '@reblu/base-api-contracts'\n\n// REB-834 — `POST /api/site/shop/check-email` is deprecated: it was an\n// account-enumeration oracle and now always answers `{ exists: false }`.\n// Kept (a minor may only deprecate); removed in the next major.\nexport type {\n  /**\n   * @deprecated REB-834 — `POST /api/site/shop/check-email` no longer reveals\n   * whether an account exists. Do not call it; removed in the next major.\n   */\n  ShopCheckEmailInput,\n  /**\n   * @deprecated REB-834 — `exists` is always `false`. Never branch UI on it:\n   * the checkout always offers «Iniciar sesión o continuar como invitado» and\n   * the server links the order to an existing account after payment. Removed\n   * in the next major.\n   */\n  ShopEmailCheck,\n} from '@reblu/base-api-contracts'\n\n// Academy (REB-507) — public course catalogue. `AcademyCourseSort` is the query\n// contract for the `sort` param, so the SDK can type it as a union instead of a\n// bare string (an unknown key is silently ignored server-side).\nexport type {\n  AcademyCourseSort,\n  // REB-547 — the documented catalogue query: q, sort, category, instructor\n  // (a user id from `GET /api/site/academy/instructors`), free and the price\n  // range in integer cents.\n  AcademyCourseListQuery,\n  AcademyCategoryPublic,\n  AcademyLessonPublic,\n  AcademyModulePublic,\n  AcademyInstructorPublic,\n  AcademyCourseSummary,\n  AcademyCourseDetail,\n  // REB-83 — tenant-configurable validation fields (drives the enrollment CTA form).\n  AcademyValidationFieldPublic,\n  // REB-1135 — a free-preview lesson, viewable by the public\n  // (`GET /api/site/academy/courses/{slug}/lessons/{lessonSlug}`).\n  AcademyLessonPreview,\n  AcademyLessonPreviewVideo,\n} from '@reblu/base-api-contracts'\n\n// Legal\nexport type { Legal } from '@reblu/base-api-contracts'\n\n// CTAs\nexport type { Cta } from '@reblu/base-api-contracts'\n\n// Trust badges\nexport type { TrustBadge, TrustBadgeType } from '@reblu/base-api-contracts'\n\n// SITE capability manifest (`/.well-known/reblu-site.json`) — REB-777.\n// Direction note (see `site-manifest.contract.ts` in base-api): this is the\n// one contract group a SITE produces and base-api consumes, the opposite of\n// every group above. The TYPE still flows through this same alias so the\n// SDK and nexus never describe two different shapes for it; the real Zod\n// validation stays in base-api only — this package never gains a Zod\n// runtime dependency.\nexport type {\n  SiteManifest,\n  SiteManifestSurfaceValue,\n  SiteCapabilitySurfaceKey,\n} from '@reblu/base-api-contracts'\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reblu/site-contracts",
-  "version": "1.21.0",
+  "version": "1.22.0",
   "private": false,
   "description": "Public, dependency-free TypeScript types for the Reblu SITE API (no Zod, no Prisma at runtime; one runtime value: DATA_REQUEST_TYPES).",
   "license": "Apache-2.0",