@contractspec/lib.content-gen 1.57.0 → 1.58.0

package/dist/node/index.js

@@ -0,0 +1,407 @@
+// 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.`;
+  }
+}
+
+// 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) => `• ${metric}`).join(`
+`) ?? "";
+    return `${greeting}
+
+${hook}
+
+Top reasons teams adopt ${brief.title}:
+${brief.solutions.map((solution) => `• ${solution}`).join(`
+`)}
+
+${proof}
+
+${brief.callToAction ?? "Spin up a sandbox"} → ${(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(`
+`) ?? "“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;
+  }
+}
+
+// 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]} → ${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: "→ 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("");
+}
+// src/seo/optimizer.ts
+class SeoOptimizer {
+  optimize(brief) {
+    const keywords = this.keywords(brief);
+    const metaTitle = `${brief.title} | ContractSpec`;
+    const metaDescription = `${brief.summary} — built for ${brief.audience.role}${brief.audience.industry ? ` in ${brief.audience.industry}` : ""}.`;
+    const slug = this.slugify(brief.title);
+    const schemaMarkup = this.schema(brief, metaDescription, keywords);
+    return { metaTitle, metaDescription, keywords, slug, schemaMarkup };
+  }
+  keywords(brief) {
+    const base = [brief.title, ...brief.problems, ...brief.solutions];
+    return [
+      ...new Set(base.flatMap((entry) => entry.toLowerCase().split(/\s+/)))
+    ].filter((word) => word.length > 3).slice(0, 12);
+  }
+  slugify(text) {
+    return text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  }
+  schema(brief, description, keywords) {
+    return {
+      "@context": "https://schema.org",
+      "@type": "Product",
+      name: brief.title,
+      description,
+      audience: {
+        "@type": "Audience",
+        audienceType: brief.audience.role,
+        industry: brief.audience.industry
+      },
+      offers: {
+        "@type": "Offer",
+        description: brief.callToAction ?? "Start building with ContractSpec"
+      },
+      keywords: keywords.join(", "),
+      citation: brief.references?.map((ref) => ref.url)
+    };
+  }
+}
+export {
+  SocialPostGenerator,
+  SeoOptimizer,
+  LandingPageGenerator,
+  EmailCampaignGenerator,
+  BlogGenerator
+};

package/dist/node/seo/index.js

@@ -0,0 +1,42 @@
+// src/seo/optimizer.ts
+class SeoOptimizer {
+  optimize(brief) {
+    const keywords = this.keywords(brief);
+    const metaTitle = `${brief.title} | ContractSpec`;
+    const metaDescription = `${brief.summary} — built for ${brief.audience.role}${brief.audience.industry ? ` in ${brief.audience.industry}` : ""}.`;
+    const slug = this.slugify(brief.title);
+    const schemaMarkup = this.schema(brief, metaDescription, keywords);
+    return { metaTitle, metaDescription, keywords, slug, schemaMarkup };
+  }
+  keywords(brief) {
+    const base = [brief.title, ...brief.problems, ...brief.solutions];
+    return [
+      ...new Set(base.flatMap((entry) => entry.toLowerCase().split(/\s+/)))
+    ].filter((word) => word.length > 3).slice(0, 12);
+  }
+  slugify(text) {
+    return text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  }
+  schema(brief, description, keywords) {
+    return {
+      "@context": "https://schema.org",
+      "@type": "Product",
+      name: brief.title,
+      description,
+      audience: {
+        "@type": "Audience",
+        audienceType: brief.audience.role,
+        industry: brief.audience.industry
+      },
+      offers: {
+        "@type": "Offer",
+        description: brief.callToAction ?? "Start building with ContractSpec"
+      },
+      keywords: keywords.join(", "),
+      citation: brief.references?.map((ref) => ref.url)
+    };
+  }
+}
+export {
+  SeoOptimizer
+};

package/dist/node/seo/optimizer.js

@@ -0,0 +1,42 @@
+// src/seo/optimizer.ts
+class SeoOptimizer {
+  optimize(brief) {
+    const keywords = this.keywords(brief);
+    const metaTitle = `${brief.title} | ContractSpec`;
+    const metaDescription = `${brief.summary} — built for ${brief.audience.role}${brief.audience.industry ? ` in ${brief.audience.industry}` : ""}.`;
+    const slug = this.slugify(brief.title);
+    const schemaMarkup = this.schema(brief, metaDescription, keywords);
+    return { metaTitle, metaDescription, keywords, slug, schemaMarkup };
+  }
+  keywords(brief) {
+    const base = [brief.title, ...brief.problems, ...brief.solutions];
+    return [
+      ...new Set(base.flatMap((entry) => entry.toLowerCase().split(/\s+/)))
+    ].filter((word) => word.length > 3).slice(0, 12);
+  }
+  slugify(text) {
+    return text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  }
+  schema(brief, description, keywords) {
+    return {
+      "@context": "https://schema.org",
+      "@type": "Product",
+      name: brief.title,
+      description,
+      audience: {
+        "@type": "Audience",
+        audienceType: brief.audience.role,
+        industry: brief.audience.industry
+      },
+      offers: {
+        "@type": "Offer",
+        description: brief.callToAction ?? "Start building with ContractSpec"
+      },
+      keywords: keywords.join(", "),
+      citation: brief.references?.map((ref) => ref.url)
+    };
+  }
+}
+export {
+  SeoOptimizer
+};

package/dist/seo/index.d.ts

@@ -1,2 +1,2 @@
-import { SeoOptimizer } from "./optimizer.js";
-export { SeoOptimizer };
+export * from './optimizer';
+//# sourceMappingURL=index.d.ts.map

package/dist/seo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seo/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/seo/index.js

@@ -1,3 +1,43 @@
-import { SeoOptimizer } from "./optimizer.js";
-
-export { SeoOptimizer };
+// @bun
+// src/seo/optimizer.ts
+class SeoOptimizer {
+  optimize(brief) {
+    const keywords = this.keywords(brief);
+    const metaTitle = `${brief.title} | ContractSpec`;
+    const metaDescription = `${brief.summary} \u2014 built for ${brief.audience.role}${brief.audience.industry ? ` in ${brief.audience.industry}` : ""}.`;
+    const slug = this.slugify(brief.title);
+    const schemaMarkup = this.schema(brief, metaDescription, keywords);
+    return { metaTitle, metaDescription, keywords, slug, schemaMarkup };
+  }
+  keywords(brief) {
+    const base = [brief.title, ...brief.problems, ...brief.solutions];
+    return [
+      ...new Set(base.flatMap((entry) => entry.toLowerCase().split(/\s+/)))
+    ].filter((word) => word.length > 3).slice(0, 12);
+  }
+  slugify(text) {
+    return text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  }
+  schema(brief, description, keywords) {
+    return {
+      "@context": "https://schema.org",
+      "@type": "Product",
+      name: brief.title,
+      description,
+      audience: {
+        "@type": "Audience",
+        audienceType: brief.audience.role,
+        industry: brief.audience.industry
+      },
+      offers: {
+        "@type": "Offer",
+        description: brief.callToAction ?? "Start building with ContractSpec"
+      },
+      keywords: keywords.join(", "),
+      citation: brief.references?.map((ref) => ref.url)
+    };
+  }
+}
+export {
+  SeoOptimizer
+};

package/dist/seo/optimizer.d.ts

@@ -1,12 +1,8 @@
-import { ContentBrief, SeoMetadata } from "../types.js";
-
-//#region src/seo/optimizer.d.ts
-declare class SeoOptimizer {
-  optimize(brief: ContentBrief): SeoMetadata;
-  private keywords;
-  private slugify;
-  private schema;
+import type { ContentBrief, SeoMetadata } from '../types';
+export declare class SeoOptimizer {
+    optimize(brief: ContentBrief): SeoMetadata;
+    private keywords;
+    private slugify;
+    private schema;
 }
-//#endregion
-export { SeoOptimizer };
 //# sourceMappingURL=optimizer.d.ts.map

package/dist/seo/optimizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"optimizer.d.ts","names":[],"sources":["../../src/seo/optimizer.ts"],"mappings":";;;cAEa,YAAA;EACX,QAAA,CAAS,KAAA,EAAO,YAAA,GAAe,WAAA;EAAA,QASvB,QAAA;EAAA,QASA,OAAA;EAAA,QAOA,MAAA;AAAA"}
+{"version":3,"file":"optimizer.d.ts","sourceRoot":"","sources":["../../src/seo/optimizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE1D,qBAAa,YAAY;IACvB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW;IAS1C,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,MAAM;CAuBf"}

package/dist/seo/optimizer.js

@@ -1,49 +1,43 @@
-//#region src/seo/optimizer.ts
-var SeoOptimizer = class {
-	optimize(brief) {
-		const keywords = this.keywords(brief);
-		const metaTitle = `${brief.title} | ContractSpec`;
-		const metaDescription = `${brief.summary} — built for ${brief.audience.role}${brief.audience.industry ? ` in ${brief.audience.industry}` : ""}.`;
-		return {
-			metaTitle,
-			metaDescription,
-			keywords,
-			slug: this.slugify(brief.title),
-			schemaMarkup: this.schema(brief, metaDescription, keywords)
-		};
-	}
-	keywords(brief) {
-		const base = [
-			brief.title,
-			...brief.problems,
-			...brief.solutions
-		];
-		return [...new Set(base.flatMap((entry) => entry.toLowerCase().split(/\s+/)))].filter((word) => word.length > 3).slice(0, 12);
-	}
-	slugify(text) {
-		return text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-	}
-	schema(brief, description, keywords) {
-		return {
-			"@context": "https://schema.org",
-			"@type": "Product",
-			name: brief.title,
-			description,
-			audience: {
-				"@type": "Audience",
-				audienceType: brief.audience.role,
-				industry: brief.audience.industry
-			},
-			offers: {
-				"@type": "Offer",
-				description: brief.callToAction ?? "Start building with ContractSpec"
-			},
-			keywords: keywords.join(", "),
-			citation: brief.references?.map((ref) => ref.url)
-		};
-	}
+// @bun
+// src/seo/optimizer.ts
+class SeoOptimizer {
+  optimize(brief) {
+    const keywords = this.keywords(brief);
+    const metaTitle = `${brief.title} | ContractSpec`;
+    const metaDescription = `${brief.summary} \u2014 built for ${brief.audience.role}${brief.audience.industry ? ` in ${brief.audience.industry}` : ""}.`;
+    const slug = this.slugify(brief.title);
+    const schemaMarkup = this.schema(brief, metaDescription, keywords);
+    return { metaTitle, metaDescription, keywords, slug, schemaMarkup };
+  }
+  keywords(brief) {
+    const base = [brief.title, ...brief.problems, ...brief.solutions];
+    return [
+      ...new Set(base.flatMap((entry) => entry.toLowerCase().split(/\s+/)))
+    ].filter((word) => word.length > 3).slice(0, 12);
+  }
+  slugify(text) {
+    return text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  }
+  schema(brief, description, keywords) {
+    return {
+      "@context": "https://schema.org",
+      "@type": "Product",
+      name: brief.title,
+      description,
+      audience: {
+        "@type": "Audience",
+        audienceType: brief.audience.role,
+        industry: brief.audience.industry
+      },
+      offers: {
+        "@type": "Offer",
+        description: brief.callToAction ?? "Start building with ContractSpec"
+      },
+      keywords: keywords.join(", "),
+      citation: brief.references?.map((ref) => ref.url)
+    };
+  }
+}
+export {
+  SeoOptimizer
 };
-
-//#endregion
-export { SeoOptimizer };
-//# sourceMappingURL=optimizer.js.map