@samva/markup 0.1.0

package/dist/compile-whatsapp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-whatsapp.js","names":[],"sources":["../src/compile-whatsapp.ts"],"sourcesContent":["import { Result } from \"effect\";\n\nimport type { ElementNode } from \"./ast\";\nimport { stringAttribute } from \"./ast\";\nimport type { InterpolationWidth } from \"./channel-text\";\nimport { channelTextVariants, flattenChannelText } from \"./channel-text\";\nimport type { Diagnostic } from \"./diagnostics\";\nimport { SmlCompileError } from \"./diagnostics\";\nimport { variableReferences } from \"./interpolate\";\nimport type { WHATSAPP_TAG_SPECS } from \"./parser\";\nimport { COMPILER_VERSION } from \"./version\";\n\n// The whatsapp compile backend: a <WhatsApp> document lowers 1:1 onto the\n// whatsapp_template_variants columns (name/language/category, header parts,\n// body/footer content, buttons jsonb, examples jsonb). Text slots carry\n// literal `{{vars}}` and `sml:` conditional markers like every other channel's\n// compiled content; provider registration payloads are the API layer's job.\n//\n// Meta constraints ride along as diagnostics, ported from @samva/document\n// channel-checks and the dashboard editor rather than re-derived from Meta's\n// docs: length limits (header/footer 60, body 1024, button text 25) are\n// warnings (the advisory posture channel-checks had); button count limits and\n// per-type attribute requirements are hard errors (the dashboard editor\n// blocked those outright).\n// @see https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/components/\n\ntype WhatsAppSpecs = typeof WHATSAPP_TAG_SPECS;\n\n/** Mirrors whatsappTemplateCategoryEnum, derived from the grammar's closed set. */\nexport type WhatsAppTemplateCategory =\n  WhatsAppSpecs[\"WhatsApp\"][\"attributes\"][\"category\"][\"values\"][number];\n\n/** Header type as authored (`type` attribute; defaults to \"text\"). */\nexport type WhatsAppHeaderType = WhatsAppSpecs[\"Header\"][\"attributes\"][\"type\"][\"values\"][number];\n\nexport type WhatsAppHeaderMediaType = Exclude<WhatsAppHeaderType, \"text\">;\n\ntype WhatsAppButtonSourceType = WhatsAppSpecs[\"Button\"][\"attributes\"][\"type\"][\"values\"][number];\n\n/** Meta-wire button rows, stored as-is in the buttons jsonb column. */\nexport type WhatsAppButtonPayload =\n  | { readonly type: \"QUICK_REPLY\"; readonly text: string }\n  | { readonly type: \"URL\"; readonly text: string; readonly url: string }\n  | { readonly type: \"PHONE_NUMBER\"; readonly text: string; readonly phone_number: string }\n  | { readonly type: \"COPY_CODE\"; readonly example: string };\n\n/** Variable names referenced per slot — the raw material for Meta example payloads. */\nexport interface WhatsAppExamples {\n  readonly header?: ReadonlyArray<string> | undefined;\n  readonly body?: ReadonlyArray<string> | undefined;\n  readonly footer?: ReadonlyArray<string> | undefined;\n  readonly buttons?: ReadonlyArray<string> | undefined;\n}\n\nexport interface CompiledWhatsApp {\n  readonly channel: \"whatsapp\";\n  /** Authoring-intent metadata; the API layer defaults name from the template slug. */\n  readonly name?: string | undefined;\n  /** The API layer defaults language from the variant locale (\"en_US\"). */\n  readonly language?: string | undefined;\n  readonly category: WhatsAppTemplateCategory;\n  readonly headerType?: WhatsAppHeaderType | undefined;\n  readonly headerMediaType?: WhatsAppHeaderMediaType | undefined;\n  readonly headerContent?: string | undefined;\n  readonly bodyContent: string;\n  readonly footerContent?: string | undefined;\n  readonly buttons: ReadonlyArray<WhatsAppButtonPayload>;\n  readonly examples: WhatsAppExamples;\n  readonly warnings: ReadonlyArray<Diagnostic>;\n  readonly compilerVersion: string;\n}\n\n// Meta message-template limits, ported from @samva/document channel-checks.\nconst WHATSAPP_BUTTON_LIMITS = {\n  URL: 2,\n  PHONE_NUMBER: 1,\n  QUICK_REPLY: 10,\n  total: 10,\n} as const;\n\nconst WHATSAPP_HEADER_MAX = 60;\nconst WHATSAPP_FOOTER_MAX = 60;\nconst WHATSAPP_BODY_MAX = 1024;\nconst WHATSAPP_BUTTON_TEXT_MAX = 25;\n\nconst POSITIONAL_PATTERN = /\\{\\{\\s*(\\d+)\\s*\\}\\}/;\nconst NAMED_PATTERN = /\\{\\{\\s*([A-Za-z_][\\w.]*)\\s*\\}\\}/;\n\nconst LITERAL: InterpolationWidth = \"literal\";\n\n/** Longest possible send-time rendering of a slot, with literal placeholders. */\nconst worstCaseLength = (node: ElementNode): number =>\n  Math.max(0, ...channelTextVariants(node.children, LITERAL).map((variant) => variant.length));\n\nconst component = (root: ElementNode, tag: string): ElementNode | undefined =>\n  root.children.find(\n    (child): child is ElementNode => child.kind === \"element\" && child.tag === tag,\n  );\n\nconst slotExamples = (texts: ReadonlyArray<string>): ReadonlyArray<string> | undefined => {\n  const names = new Set<string>();\n  for (const text of texts) {\n    for (const name of variableReferences(text)) names.add(name);\n  }\n  return names.size === 0 ? undefined : [...names].sort();\n};\n\n/** Root is a parsed `<WhatsApp>` element; the grammar already validated its anatomy. */\nexport const compileWhatsAppRoot = (\n  root: ElementNode,\n): Result.Result<CompiledWhatsApp, SmlCompileError> => {\n  const errors: Array<Diagnostic> = [];\n  const warnings: Array<Diagnostic> = [];\n\n  const header = component(root, \"Header\");\n  const body = component(root, \"Body\")!; // grammar: <Body> is required\n  const footer = component(root, \"Footer\");\n  const buttonsNode = component(root, \"Buttons\");\n\n  const headerType =\n    header === undefined\n      ? undefined\n      : ((stringAttribute(header, \"type\") ?? \"text\") as WhatsAppHeaderType);\n  const headerContent = header === undefined ? undefined : flattenChannelText(header.children);\n  const bodyContent = flattenChannelText(body.children);\n  const footerContent = footer === undefined ? undefined : flattenChannelText(footer.children);\n\n  // ── Length limits (ported advisory checks, now with spans) ────────────────\n  if (\n    header !== undefined &&\n    headerType === \"text\" &&\n    worstCaseLength(header) > WHATSAPP_HEADER_MAX\n  ) {\n    warnings.push({\n      code: \"whatsapp-header-length\",\n      message: `whatsapp header should stay under ${WHATSAPP_HEADER_MAX} characters`,\n      span: header.span,\n    });\n  }\n  if (worstCaseLength(body) > WHATSAPP_BODY_MAX) {\n    warnings.push({\n      code: \"whatsapp-body-length\",\n      message: `whatsapp body should stay under ${WHATSAPP_BODY_MAX} characters`,\n      span: body.span,\n    });\n  }\n  if (footer !== undefined && worstCaseLength(footer) > WHATSAPP_FOOTER_MAX) {\n    warnings.push({\n      code: \"whatsapp-footer-length\",\n      message: `whatsapp footer should stay under ${WHATSAPP_FOOTER_MAX} characters`,\n      span: footer.span,\n    });\n  }\n\n  // ── Buttons ────────────────────────────────────────────────────────────────\n  const buttonElements =\n    buttonsNode === undefined\n      ? []\n      : buttonsNode.children.filter(\n          (child): child is ElementNode => child.kind === \"element\" && child.tag === \"Button\",\n        );\n  const buttons: Array<WhatsAppButtonPayload> = [];\n  for (const button of buttonElements) {\n    const type = stringAttribute(button, \"type\") as WhatsAppButtonSourceType;\n    const text = flattenChannelText(button.children);\n    const url = stringAttribute(button, \"url\");\n    const phone = stringAttribute(button, \"phone\");\n\n    if (url !== undefined && type !== \"url\") {\n      errors.push({\n        code: \"whatsapp-button-url\",\n        message: `url is only valid on <Button type=\"url\"> — remove it or change the type`,\n        span: button.span,\n      });\n      continue;\n    }\n    if (phone !== undefined && type !== \"phone\") {\n      errors.push({\n        code: \"whatsapp-button-phone\",\n        message: `phone is only valid on <Button type=\"phone\"> — remove it or change the type`,\n        span: button.span,\n      });\n      continue;\n    }\n    if (type !== \"copy-code\" && worstCaseLength(button) > WHATSAPP_BUTTON_TEXT_MAX) {\n      warnings.push({\n        code: \"whatsapp-button-text-length\",\n        message: `whatsapp button text should stay under ${WHATSAPP_BUTTON_TEXT_MAX} characters`,\n        span: button.span,\n      });\n    }\n    switch (type) {\n      case \"quick-reply\":\n        buttons.push({ type: \"QUICK_REPLY\", text });\n        break;\n      case \"url\": {\n        if (url === undefined) {\n          errors.push({\n            code: \"whatsapp-button-url\",\n            message: `<Button type=\"url\"> requires a url attribute — add url=\"https://...\"`,\n            span: button.span,\n          });\n          break;\n        }\n        buttons.push({ type: \"URL\", text, url });\n        break;\n      }\n      case \"phone\": {\n        if (phone === undefined) {\n          errors.push({\n            code: \"whatsapp-button-phone\",\n            message: `<Button type=\"phone\"> requires a phone attribute — add phone=\"+15551234567\"`,\n            span: button.span,\n          });\n          break;\n        }\n        buttons.push({ type: \"PHONE_NUMBER\", text, phone_number: phone });\n        break;\n      }\n      case \"copy-code\":\n        // The label is fixed by WhatsApp; the content is the code to copy.\n        buttons.push({ type: \"COPY_CODE\", example: text });\n        break;\n    }\n  }\n\n  // Count limits (ported; the dashboard editor blocks these, so they are errors).\n  const buttonsSpan = buttonsNode?.span ?? root.span;\n  const countOf = (type: WhatsAppButtonPayload[\"type\"]): number =>\n    buttons.filter((button) => button.type === type).length;\n  if (countOf(\"URL\") > WHATSAPP_BUTTON_LIMITS.URL) {\n    errors.push({\n      code: \"whatsapp-button-limit\",\n      message: `whatsapp allows at most ${WHATSAPP_BUTTON_LIMITS.URL} URL buttons`,\n      span: buttonsSpan,\n    });\n  }\n  if (countOf(\"PHONE_NUMBER\") > WHATSAPP_BUTTON_LIMITS.PHONE_NUMBER) {\n    errors.push({\n      code: \"whatsapp-button-limit\",\n      message: `whatsapp allows at most ${WHATSAPP_BUTTON_LIMITS.PHONE_NUMBER} phone-number button`,\n      span: buttonsSpan,\n    });\n  }\n  if (countOf(\"QUICK_REPLY\") > WHATSAPP_BUTTON_LIMITS.QUICK_REPLY) {\n    errors.push({\n      code: \"whatsapp-button-limit\",\n      message: `whatsapp allows at most ${WHATSAPP_BUTTON_LIMITS.QUICK_REPLY} quick-reply buttons`,\n      span: buttonsSpan,\n    });\n  }\n  if (buttonElements.length > WHATSAPP_BUTTON_LIMITS.total) {\n    errors.push({\n      code: \"whatsapp-button-limit\",\n      message: `whatsapp allows at most ${WHATSAPP_BUTTON_LIMITS.total} buttons total`,\n      span: buttonsSpan,\n    });\n  }\n\n  // ── Placeholder style mixing (ported) ─────────────────────────────────────\n  // Meta requires one placeholder style per template: positional {{1}} or\n  // named {{var}}. Scan component text and dynamic button urls.\n  const placeholderSources = [\n    headerContent ?? \"\",\n    bodyContent,\n    footerContent ?? \"\",\n    ...buttons.map((button) => (button.type === \"URL\" ? button.url : \"\")),\n  ];\n  const hasPositional = placeholderSources.some((source) => POSITIONAL_PATTERN.test(source));\n  const hasNamed = placeholderSources.some((source) => NAMED_PATTERN.test(source));\n  if (hasPositional && hasNamed) {\n    warnings.push({\n      code: \"whatsapp-mixed-placeholders\",\n      message:\n        \"whatsapp mixes positional {{1}} and named {{var}} placeholders; Meta requires one style\",\n      span: root.span,\n    });\n  }\n\n  if (errors.length > 0) {\n    return Result.fail(new SmlCompileError({ diagnostics: errors }));\n  }\n\n  return Result.succeed({\n    channel: \"whatsapp\",\n    name: stringAttribute(root, \"name\"),\n    language: stringAttribute(root, \"language\"),\n    category: stringAttribute(root, \"category\") as WhatsAppTemplateCategory,\n    headerType,\n    headerMediaType:\n      headerType === undefined || headerType === \"text\"\n        ? undefined\n        : (headerType satisfies WhatsAppHeaderMediaType),\n    headerContent,\n    bodyContent,\n    footerContent,\n    buttons,\n    examples: {\n      header: slotExamples([headerContent ?? \"\"]),\n      body: slotExamples([bodyContent]),\n      footer: slotExamples([footerContent ?? \"\"]),\n      buttons: slotExamples(\n        buttons.map((button) =>\n          button.type === \"URL\"\n            ? `${button.text} ${button.url}`\n            : button.type === \"COPY_CODE\"\n              ? button.example\n              : button.text,\n        ),\n      ),\n    },\n    warnings,\n    compilerVersion: COMPILER_VERSION,\n  });\n};\n"],"mappings":"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"}

package/dist/compile.d.ts

@@ -0,0 +1,93 @@
+import { a as SmlCompileError, o as SmlParseError, t as Diagnostic } from "./diagnostics-oveE-laV.js";
+import { C as SmlDocument } from "./ast-DAhnAvQN.js";
+import { a as ThemeLayers, s as TokenTable } from "./theme-6ApjjiBo.js";
+import { Declaration } from "./registry.js";
+import { CompiledSms } from "./compile-sms.js";
+import { CompiledWhatsApp } from "./compile-whatsapp.js";
+import { Result } from "effect";
+//#region src/version.d.ts
+declare const COMPILER_VERSION = "0.1.0";
+//#endregion
+//#region src/compile.d.ts
+type CompileBase = "outlook-safe" | "modern";
+/** Email-only knobs; sms/whatsapp compile ignores both (no theming, no bases). */
+interface CompileOptions {
+  readonly base?: CompileBase | undefined;
+  readonly theme?: (Omit<ThemeLayers, "base"> & {
+    readonly base?: TokenTable | undefined;
+  }) | undefined;
+  /** Omit editor DOM instrumentation from exported/sent HTML artifacts. */
+  readonly stripInstrumentation?: boolean | undefined;
+}
+interface CompiledEmail {
+  readonly channel: "email";
+  readonly html: string;
+  /** Plain-text alternative ({{vars}} verbatim, envelope metadata skipped). */
+  readonly text: string;
+  /** Authored <Subject> text with interpolation tokens preserved; null when absent. */
+  readonly subjectText: string | null;
+  readonly warnings: ReadonlyArray<Diagnostic>;
+  readonly base: CompileBase;
+  readonly compilerVersion: string;
+}
+/**
+ * The compile result, discriminated on `channel` — which the root tag
+ * declares. email → HTML + plain-text artifacts; sms → body + segment math;
+ * whatsapp → whatsapp_template_variants column shapes.
+ */
+type CompiledTemplate = CompiledEmail | CompiledSms | CompiledWhatsApp;
+interface HtmlElement {
+  readonly kind: "element";
+  readonly tag: string;
+  /** Ordered; serialized before style. */
+  readonly attrs: ReadonlyArray<readonly [string, string]>;
+  /** Serialized as style="" in order — CSS last-wins handles overrides. */
+  readonly style: ReadonlyArray<Declaration>;
+  readonly children: ReadonlyArray<HtmlNode>;
+  readonly void?: boolean | undefined;
+}
+type HtmlTextNode = {
+  readonly kind: "text";
+  readonly value: string;
+};
+type HtmlRawNode = {
+  readonly kind: "raw";
+  readonly html: string;
+};
+/** Children spliced into the parent's block flow — <If> lowers to one. */
+interface HtmlFragment {
+  readonly kind: "fragment";
+  readonly children: ReadonlyArray<HtmlNode>;
+}
+type HtmlNode = HtmlElement | HtmlTextNode | HtmlRawNode | HtmlFragment;
+interface CompileHeadStyleAsset {
+  readonly kind: "style";
+  readonly css: string;
+  /** Serialized style asset as emitted in <head>. */
+  readonly html: string;
+  /** True for the Outlook-hidden webfont style block. */
+  readonly outlookHidden: boolean;
+}
+interface CompileHeadAssets {
+  readonly styles: ReadonlyArray<CompileHeadStyleAsset>;
+  readonly links: ReadonlyArray<HtmlElement>;
+}
+type HtmlNodeIdMap = Readonly<Record<string, ReadonlyArray<HtmlElement>>>;
+interface CompiledEmailArtifact extends CompiledEmail {
+  /** Resolved primary document width in pixels. */
+  readonly width: number;
+  readonly tree: HtmlElement;
+  readonly doctype: string;
+  readonly headAssets: CompileHeadAssets;
+  readonly nodeIdMap: HtmlNodeIdMap;
+}
+type CompiledTemplateArtifact = CompiledEmailArtifact | CompiledSms | CompiledWhatsApp;
+declare const serializeHtmlNode: (node: HtmlNode) => string;
+/** Compile a parsed document; the root tag routes to its channel backend. */
+declare const compileSml: (document: SmlDocument, options?: CompileOptions) => Result.Result<CompiledTemplate, SmlCompileError>;
+declare const compileSmlArtifact: (document: SmlDocument, options?: CompileOptions) => Result.Result<CompiledTemplateArtifact, SmlCompileError>;
+declare const compileSource: (source: string, options?: CompileOptions) => Result.Result<CompiledTemplate, SmlParseError | SmlCompileError>;
+declare const compileSourceArtifact: (source: string, options?: CompileOptions) => Result.Result<CompiledTemplateArtifact, SmlParseError | SmlCompileError>;
+//#endregion
+export { COMPILER_VERSION, CompileBase, CompileHeadAssets, CompileHeadStyleAsset, CompileOptions, CompiledEmail, CompiledEmailArtifact, CompiledTemplate, CompiledTemplateArtifact, HtmlElement, HtmlFragment, HtmlNode, HtmlNodeIdMap, HtmlRawNode, HtmlTextNode, compileSml, compileSmlArtifact, compileSource, compileSourceArtifact, serializeHtmlNode };
+//# sourceMappingURL=compile.d.ts.map