@contractspec/lib.content-gen 1.57.0 → 1.59.0

package/dist/generators/index.js

@@ -1,6 +1,368 @@
-import { BlogGenerator } from "./blog.js";
-import { LandingPageGenerator } from "./landing-page.js";
-import { EmailCampaignGenerator } from "./email.js";
-import { SocialPostGenerator } from "./social.js";
+// @bun
+// src/generators/blog.ts
+class BlogGenerator {
+  llm;
+  model;
+  temperature;
+  constructor(options) {
+    this.llm = options?.llm;
+    this.model = options?.model;
+    this.temperature = options?.temperature ?? 0.4;
+  }
+  async generate(brief) {
+    if (this.llm) {
+      return this.generateWithLlm(brief);
+    }
+    return this.generateDeterministic(brief);
+  }
+  async generateWithLlm(brief) {
+    if (!this.llm) {
+      return this.generateDeterministic(brief);
+    }
+    const response = await this.llm.chat([
+      {
+        role: "system",
+        content: [
+          {
+            type: "text",
+            text: "You are a product marketing writer. Produce JSON with title, subtitle, intro, sections[].heading/body/bullets, outro."
+          }
+        ]
+      },
+      {
+        role: "user",
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({ brief })
+          }
+        ]
+      }
+    ], {
+      responseFormat: "json",
+      model: this.model,
+      temperature: this.temperature
+    });
+    const jsonPart = response.message.content.find((part) => ("text" in part));
+    if (jsonPart && "text" in jsonPart) {
+      return JSON.parse(jsonPart.text);
+    }
+    return this.generateDeterministic(brief);
+  }
+  generateDeterministic(brief) {
+    const intro = `Operators like ${brief.audience.role} teams face ${brief.problems.slice(0, 2).join(" and ")}. ${brief.title} changes that by ${brief.summary}.`;
+    const sections = [
+      {
+        heading: "Why now",
+        body: this.renderWhyNow(brief)
+      },
+      {
+        heading: "What you get",
+        body: "A focused stack built for policy-safe automation.",
+        bullets: brief.solutions
+      },
+      {
+        heading: "Proof it works",
+        body: "Teams using the blueprint report measurable wins.",
+        bullets: brief.metrics ?? [
+          "Launch workflows in minutes",
+          "Cut review time by 60%"
+        ]
+      }
+    ];
+    return {
+      title: brief.title,
+      subtitle: brief.summary,
+      intro,
+      sections,
+      outro: brief.callToAction ?? "Ready to see it live? Spin up a sandbox in under 5 minutes."
+    };
+  }
+  renderWhyNow(brief) {
+    const audience = `${brief.audience.role}${brief.audience.industry ? ` in ${brief.audience.industry}` : ""}`;
+    const pains = brief.problems.slice(0, 2).join("; ");
+    return `${audience} teams are stuck with ${pains}. ${brief.title} delivers guardrails without slowing shipping.`;
+  }
+}
 
-export { BlogGenerator, EmailCampaignGenerator, LandingPageGenerator, SocialPostGenerator };
+// src/generators/email.ts
+class EmailCampaignGenerator {
+  llm;
+  model;
+  temperature;
+  constructor(options) {
+    this.llm = options?.llm;
+    this.model = options?.model;
+    this.temperature = options?.temperature ?? 0.6;
+  }
+  async generate(input) {
+    if (this.llm) {
+      const draft = await this.generateWithLlm(input);
+      if (draft)
+        return draft;
+    }
+    return this.generateFallback(input);
+  }
+  async generateWithLlm(input) {
+    if (!this.llm)
+      return null;
+    const response = await this.llm.chat([
+      {
+        role: "system",
+        content: [
+          {
+            type: "text",
+            text: "Draft product marketing email as JSON {subject, previewText, body, cta}."
+          }
+        ]
+      },
+      {
+        role: "user",
+        content: [{ type: "text", text: JSON.stringify(input) }]
+      }
+    ], {
+      responseFormat: "json",
+      model: this.model,
+      temperature: this.temperature
+    });
+    const jsonPart = response.message.content.find((chunk) => ("text" in chunk));
+    if (!jsonPart || !("text" in jsonPart))
+      return null;
+    const parsed = JSON.parse(jsonPart.text);
+    if (!parsed.subject || !parsed.body || !parsed.cta)
+      return null;
+    return {
+      subject: parsed.subject,
+      previewText: parsed.previewText ?? this.defaultPreview(input),
+      body: parsed.body,
+      cta: parsed.cta,
+      variant: input.variant
+    };
+  }
+  generateFallback(input) {
+    const { brief, variant } = input;
+    const subject = this.subjects(brief.title, variant)[0] ?? `${brief.title} update`;
+    const previewText = this.defaultPreview(input);
+    const body = this.renderBody(input);
+    const cta = brief.callToAction ?? "Explore the sandbox";
+    return { subject, previewText, body, cta, variant };
+  }
+  subjects(title, variant) {
+    switch (variant) {
+      case "announcement":
+        return [`Launch: ${title}`, `${title} is live`, `New: ${title}`];
+      case "onboarding":
+        return [`Get started with ${title}`, `Your ${title} guide`];
+      case "nurture":
+      default:
+        return [`How ${title} speeds ops`, `Proof ${title} works`];
+    }
+  }
+  defaultPreview(input) {
+    const win = input.brief.metrics?.[0] ?? "ship faster without policy gaps";
+    return `See how teams ${win}.`;
+  }
+  renderBody(input) {
+    const { brief, variant } = input;
+    const greeting = "Hi there,";
+    const hook = this.variantHook(variant, brief);
+    const proof = brief.metrics?.map((metric) => `\u2022 ${metric}`).join(`
+`) ?? "";
+    return `${greeting}
+
+${hook}
+
+Top reasons teams adopt ${brief.title}:
+${brief.solutions.map((solution) => `\u2022 ${solution}`).join(`
+`)}
+
+${proof}
+
+${brief.callToAction ?? "Spin up a sandbox"} \u2192 ${(input.cadenceDay ?? 0) + 1}
+`;
+  }
+  variantHook(variant, brief) {
+    switch (variant) {
+      case "announcement":
+        return `${brief.title} is live. ${brief.summary}`;
+      case "onboarding":
+        return `Here is your next step to unlock ${brief.title}.`;
+      case "nurture":
+      default:
+        return `Operators like ${brief.audience.role} keep asking how to automate policy checks. Here is what works.`;
+    }
+  }
+}
+
+// src/generators/landing-page.ts
+class LandingPageGenerator {
+  options;
+  llm;
+  model;
+  constructor(options) {
+    this.options = options;
+    this.llm = options?.llm;
+    this.model = options?.model;
+  }
+  async generate(brief) {
+    if (this.llm) {
+      return this.generateWithLlm(brief);
+    }
+    return this.generateFallback(brief);
+  }
+  async generateWithLlm(brief) {
+    if (!this.llm) {
+      return this.generateFallback(brief);
+    }
+    const response = await this.llm.chat([
+      {
+        role: "system",
+        content: [
+          {
+            type: "text",
+            text: "Write JSON landing page copy with hero/highlights/socialProof/faq arrays."
+          }
+        ]
+      },
+      {
+        role: "user",
+        content: [{ type: "text", text: JSON.stringify({ brief }) }]
+      }
+    ], {
+      responseFormat: "json",
+      model: this.model,
+      temperature: this.options?.temperature ?? 0.5
+    });
+    const part = response.message.content.find((chunk) => ("text" in chunk));
+    if (part && "text" in part) {
+      return JSON.parse(part.text);
+    }
+    return this.generateFallback(brief);
+  }
+  generateFallback(brief) {
+    return {
+      hero: {
+        eyebrow: `${brief.audience.industry ?? "Operations"} teams`,
+        title: brief.title,
+        subtitle: brief.summary,
+        primaryCta: brief.callToAction ?? "Launch a sandbox",
+        secondaryCta: "View docs"
+      },
+      highlights: brief.solutions.slice(0, 3).map((solution, index) => ({
+        heading: [
+          "Policy-safe by default",
+          "Auto-adapts per tenant",
+          "Launch-ready in days"
+        ][index] ?? "Key capability",
+        body: solution
+      })),
+      socialProof: {
+        heading: "Teams using ContractSpec",
+        body: brief.proofPoints?.join(`
+`) ?? "\u201CWe ship compliant workflows 5x faster while cutting ops toil in half.\u201D"
+      },
+      faq: this.buildFaq(brief)
+    };
+  }
+  buildFaq(brief) {
+    const faqs = [
+      {
+        heading: "How does this keep policies enforced?",
+        body: "All workflows compile from TypeScript specs and pass through PDP checks before execution, so no shadow logic slips through."
+      },
+      {
+        heading: "Will it fit our existing stack?",
+        body: "Runtime adapters plug into REST, GraphQL, or MCP. Integrations stay vendor agnostic."
+      }
+    ];
+    if (brief.complianceNotes?.length) {
+      faqs.push({
+        heading: "What about compliance requirements?",
+        body: brief.complianceNotes.join(" ")
+      });
+    }
+    return faqs;
+  }
+}
+
+// src/generators/social.ts
+class SocialPostGenerator {
+  llm;
+  model;
+  constructor(options) {
+    this.llm = options?.llm;
+    this.model = options?.model;
+  }
+  async generate(brief) {
+    if (this.llm) {
+      const posts = await this.generateWithLlm(brief);
+      if (posts.length)
+        return posts;
+    }
+    return this.generateFallback(brief);
+  }
+  async generateWithLlm(brief) {
+    if (!this.llm)
+      return [];
+    const response = await this.llm.chat([
+      {
+        role: "system",
+        content: [
+          {
+            type: "text",
+            text: "Create JSON array of social posts for twitter/linkedin/threads with body, hashtags, cta."
+          }
+        ]
+      },
+      {
+        role: "user",
+        content: [{ type: "text", text: JSON.stringify(brief) }]
+      }
+    ], { responseFormat: "json", model: this.model });
+    const part = response.message.content.find((chunk) => ("text" in chunk));
+    if (!part || !("text" in part))
+      return [];
+    return JSON.parse(part.text);
+  }
+  generateFallback(brief) {
+    const hashtags = this.buildHashtags(brief);
+    return [
+      {
+        channel: "linkedin",
+        body: `${brief.title}: ${brief.summary}
+${brief.problems[0]} \u2192 ${brief.solutions[0]}`,
+        hashtags,
+        cta: brief.callToAction ?? "Book a 15-min run-through"
+      },
+      {
+        channel: "twitter",
+        body: `${brief.solutions[0]} in <60s. ${brief.solutions[1] ?? ""}`.trim(),
+        hashtags: hashtags.slice(0, 3),
+        cta: "\u2192 contractspec.io/sandbox"
+      },
+      {
+        channel: "threads",
+        body: `Ops + policy can move fast. ${brief.title} automates guardrails so teams ship daily.`,
+        hashtags: hashtags.slice(1, 4)
+      }
+    ];
+  }
+  buildHashtags(brief) {
+    const base = [
+      brief.audience.industry ? `#${camel(brief.audience.industry)}` : "#operations",
+      "#automation",
+      "#aiops",
+      "#compliance"
+    ];
+    return [...new Set(base.map((tag) => tag.replace(/\s+/g, "")))].slice(0, 5);
+  }
+}
+function camel(text) {
+  return text.split(/\s|-/).filter(Boolean).map((word) => word[0]?.toUpperCase() + word.slice(1)).join("");
+}
+export {
+  SocialPostGenerator,
+  LandingPageGenerator,
+  EmailCampaignGenerator,
+  BlogGenerator
+};

package/dist/generators/landing-page.d.ts

@@ -1,28 +1,24 @@
-import { ContentBlock, ContentBrief, GeneratorOptions } from "../types.js";
-
-//#region src/generators/landing-page.d.ts
-interface LandingPageCopy {
-  hero: {
-    eyebrow?: string;
-    title: string;
-    subtitle: string;
-    primaryCta: string;
-    secondaryCta?: string;
-  };
-  highlights: ContentBlock[];
-  socialProof: ContentBlock;
-  faq: ContentBlock[];
+import type { ContentBrief, ContentBlock, GeneratorOptions } from '../types';
+export interface LandingPageCopy {
+    hero: {
+        eyebrow?: string;
+        title: string;
+        subtitle: string;
+        primaryCta: string;
+        secondaryCta?: string;
+    };
+    highlights: ContentBlock[];
+    socialProof: ContentBlock;
+    faq: ContentBlock[];
 }
-declare class LandingPageGenerator {
-  private readonly options?;
-  private readonly llm?;
-  private readonly model?;
-  constructor(options?: GeneratorOptions | undefined);
-  generate(brief: ContentBrief): Promise<LandingPageCopy>;
-  private generateWithLlm;
-  private generateFallback;
-  private buildFaq;
+export declare class LandingPageGenerator {
+    private readonly options?;
+    private readonly llm?;
+    private readonly model?;
+    constructor(options?: GeneratorOptions | undefined);
+    generate(brief: ContentBrief): Promise<LandingPageCopy>;
+    private generateWithLlm;
+    private generateFallback;
+    private buildFaq;
 }
-//#endregion
-export { LandingPageCopy, LandingPageGenerator };
 //# sourceMappingURL=landing-page.d.ts.map

package/dist/generators/landing-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"landing-page.d.ts","names":[],"sources":["../../src/generators/landing-page.ts"],"mappings":";;;UAGiB,eAAA;EACf,IAAA;IACE,OAAA;IACA,KAAA;IACA,QAAA;IACA,UAAA;IACA,YAAA;EAAA;EAEF,UAAA,EAAY,YAAA;EACZ,WAAA,EAAa,YAAA;EACb,GAAA,EAAK,YAAA;AAAA;AAAA,cAGM,oBAAA;EAAA,iBAIkB,OAAA;EAAA,iBAHZ,GAAA;EAAA,iBACA,KAAA;cAEY,OAAA,GAAU,gBAAA;EAKjC,QAAA,CAAS,KAAA,EAAO,YAAA,GAAe,OAAA,CAAQ,eAAA;EAAA,QAO/B,eAAA;EAAA,QAiCN,gBAAA;EAAA,QA4BA,QAAA;AAAA"}
+{"version":3,"file":"landing-page.d.ts","sourceRoot":"","sources":["../../src/generators/landing-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG7E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE;QACJ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,WAAW,EAAE,YAAY,CAAC;IAC1B,GAAG,EAAE,YAAY,EAAE,CAAC;CACrB;AAED,qBAAa,oBAAoB;IAInB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAHrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;gBAEH,OAAO,CAAC,EAAE,gBAAgB,YAAA;IAKjD,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC;YAO/C,eAAe;IAiC7B,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,QAAQ;CAmBjB"}

package/dist/generators/landing-page.js

@@ -1,78 +1,94 @@
-//#region src/generators/landing-page.ts
-var LandingPageGenerator = class {
-	llm;
-	model;
-	constructor(options) {
-		this.options = options;
-		this.llm = options?.llm;
-		this.model = options?.model;
-	}
-	async generate(brief) {
-		if (this.llm) return this.generateWithLlm(brief);
-		return this.generateFallback(brief);
-	}
-	async generateWithLlm(brief) {
-		if (!this.llm) return this.generateFallback(brief);
-		const part = (await this.llm.chat([{
-			role: "system",
-			content: [{
-				type: "text",
-				text: "Write JSON landing page copy with hero/highlights/socialProof/faq arrays."
-			}]
-		}, {
-			role: "user",
-			content: [{
-				type: "text",
-				text: JSON.stringify({ brief })
-			}]
-		}], {
-			responseFormat: "json",
-			model: this.model,
-			temperature: this.options?.temperature ?? .5
-		})).message.content.find((chunk) => "text" in chunk);
-		if (part && "text" in part) return JSON.parse(part.text);
-		return this.generateFallback(brief);
-	}
-	generateFallback(brief) {
-		return {
-			hero: {
-				eyebrow: `${brief.audience.industry ?? "Operations"} teams`,
-				title: brief.title,
-				subtitle: brief.summary,
-				primaryCta: brief.callToAction ?? "Launch a sandbox",
-				secondaryCta: "View docs"
-			},
-			highlights: brief.solutions.slice(0, 3).map((solution, index) => ({
-				heading: [
-					"Policy-safe by default",
-					"Auto-adapts per tenant",
-					"Launch-ready in days"
-				][index] ?? "Key capability",
-				body: solution
-			})),
-			socialProof: {
-				heading: "Teams using ContractSpec",
-				body: brief.proofPoints?.join("\n") ?? "“We ship compliant workflows 5x faster while cutting ops toil in half.”"
-			},
-			faq: this.buildFaq(brief)
-		};
-	}
-	buildFaq(brief) {
-		const faqs = [{
-			heading: "How does this keep policies enforced?",
-			body: "All workflows compile from TypeScript specs and pass through PDP checks before execution, so no shadow logic slips through."
-		}, {
-			heading: "Will it fit our existing stack?",
-			body: "Runtime adapters plug into REST, GraphQL, or MCP. Integrations stay vendor agnostic."
-		}];
-		if (brief.complianceNotes?.length) faqs.push({
-			heading: "What about compliance requirements?",
-			body: brief.complianceNotes.join(" ")
-		});
-		return faqs;
-	}
+// @bun
+// src/generators/landing-page.ts
+class LandingPageGenerator {
+  options;
+  llm;
+  model;
+  constructor(options) {
+    this.options = options;
+    this.llm = options?.llm;
+    this.model = options?.model;
+  }
+  async generate(brief) {
+    if (this.llm) {
+      return this.generateWithLlm(brief);
+    }
+    return this.generateFallback(brief);
+  }
+  async generateWithLlm(brief) {
+    if (!this.llm) {
+      return this.generateFallback(brief);
+    }
+    const response = await this.llm.chat([
+      {
+        role: "system",
+        content: [
+          {
+            type: "text",
+            text: "Write JSON landing page copy with hero/highlights/socialProof/faq arrays."
+          }
+        ]
+      },
+      {
+        role: "user",
+        content: [{ type: "text", text: JSON.stringify({ brief }) }]
+      }
+    ], {
+      responseFormat: "json",
+      model: this.model,
+      temperature: this.options?.temperature ?? 0.5
+    });
+    const part = response.message.content.find((chunk) => ("text" in chunk));
+    if (part && "text" in part) {
+      return JSON.parse(part.text);
+    }
+    return this.generateFallback(brief);
+  }
+  generateFallback(brief) {
+    return {
+      hero: {
+        eyebrow: `${brief.audience.industry ?? "Operations"} teams`,
+        title: brief.title,
+        subtitle: brief.summary,
+        primaryCta: brief.callToAction ?? "Launch a sandbox",
+        secondaryCta: "View docs"
+      },
+      highlights: brief.solutions.slice(0, 3).map((solution, index) => ({
+        heading: [
+          "Policy-safe by default",
+          "Auto-adapts per tenant",
+          "Launch-ready in days"
+        ][index] ?? "Key capability",
+        body: solution
+      })),
+      socialProof: {
+        heading: "Teams using ContractSpec",
+        body: brief.proofPoints?.join(`
+`) ?? "\u201CWe ship compliant workflows 5x faster while cutting ops toil in half.\u201D"
+      },
+      faq: this.buildFaq(brief)
+    };
+  }
+  buildFaq(brief) {
+    const faqs = [
+      {
+        heading: "How does this keep policies enforced?",
+        body: "All workflows compile from TypeScript specs and pass through PDP checks before execution, so no shadow logic slips through."
+      },
+      {
+        heading: "Will it fit our existing stack?",
+        body: "Runtime adapters plug into REST, GraphQL, or MCP. Integrations stay vendor agnostic."
+      }
+    ];
+    if (brief.complianceNotes?.length) {
+      faqs.push({
+        heading: "What about compliance requirements?",
+        body: brief.complianceNotes.join(" ")
+      });
+    }
+    return faqs;
+  }
+}
+export {
+  LandingPageGenerator
 };
-
-//#endregion
-export { LandingPageGenerator };
-//# sourceMappingURL=landing-page.js.map

package/dist/generators/social.d.ts

@@ -1,15 +1,11 @@
-import { ContentBrief, GeneratorOptions, SocialPost } from "../types.js";
-
-//#region src/generators/social.d.ts
-declare class SocialPostGenerator {
-  private readonly llm?;
-  private readonly model?;
-  constructor(options?: GeneratorOptions);
-  generate(brief: ContentBrief): Promise<SocialPost[]>;
-  private generateWithLlm;
-  private generateFallback;
-  private buildHashtags;
+import type { ContentBrief, GeneratorOptions, SocialPost } from '../types';
+export declare class SocialPostGenerator {
+    private readonly llm?;
+    private readonly model?;
+    constructor(options?: GeneratorOptions);
+    generate(brief: ContentBrief): Promise<SocialPost[]>;
+    private generateWithLlm;
+    private generateFallback;
+    private buildHashtags;
 }
-//#endregion
-export { SocialPostGenerator };
 //# sourceMappingURL=social.d.ts.map

package/dist/generators/social.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"social.d.ts","names":[],"sources":["../../src/generators/social.ts"],"mappings":";;;cAGa,mBAAA;EAAA,iBACM,GAAA;EAAA,iBACA,KAAA;cAEL,OAAA,GAAU,gBAAA;EAKhB,QAAA,CAAS,KAAA,EAAO,YAAA,GAAe,OAAA,CAAQ,UAAA;EAAA,QAQ/B,eAAA;EAAA,QAyBN,gBAAA;EAAA,QAuBA,aAAA;AAAA"}
+{"version":3,"file":"social.d.ts","sourceRoot":"","sources":["../../src/generators/social.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3E,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;gBAEpB,OAAO,CAAC,EAAE,gBAAgB;IAKhC,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;YAQ5C,eAAe;IAyB7B,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,aAAa;CAWtB"}