@kotao/storefront-contracts
Il livello di contratto tra il tuo tema e la piattaforma: schemi Zod che la build valida il tuo tema contro, più i primitivi di contesto firmati che il runtime utilizza.
Schemi di sezione e impostazioni
Sezione intitolata “Schemi di sezione e impostazioni”SectionSchemaSchema— valida l’exportschemadi una sezione (nome, impostazioni, blocchi, preset). Le tue sezioni sono controllate contro di esso al momento della build.SettingInputSchema+SETTING_INPUT_TYPES— i tipi di input di impostazione consentiti (text, select, color, image, …) i commercianti configurano nell’editor.BlockDefSchema/BlockInstanceSchema,PresetSchema,SectionInstanceSchema,ValuesDocumentSchema— i blocchi di costruzione dei documenti impostazioni‑come‑dati.
Manifesto tema
Sezione intitolata “Manifesto tema”ThemeManifestSchema valida kotao.theme.json — il manifesto contro cui ogni deploy è controllato. AllowedOriginSchema e ScriptTagsSchema (+ parseStorefrontScriptTags) governano cosa un tema può caricare da dove.
Contesto shop firmato
Sezione intitolata “Contesto shop firmato”signShopContext / verifyShopContext e signAssertion / verifyAssertion trasportano l’identità shop autenticata tra la piattaforma e il tuo tema (SHOP_HEADER, SHOP_SIGNATURE_HEADER, CLIENT_IP_HEADER). Raramente li chiami tu — l’entry Worker dello scaffold li collega — ma spiegano come una richiesta dimostri a quale shop appartiene.