@contractspec/example.content-generation 1.57.0 → 1.58.0

package/dist/generate.js

@@ -1,48 +1,51 @@
-import { BlogGenerator, EmailCampaignGenerator, LandingPageGenerator, SocialPostGenerator } from "@contractspec/lib.content-gen/generators";
+// @bun
+// src/generate.ts
+import {
+  BlogGenerator,
+  EmailCampaignGenerator,
+  LandingPageGenerator,
+  SocialPostGenerator
+} from "@contractspec/lib.content-gen/generators";
 import { SeoOptimizer } from "@contractspec/lib.content-gen/seo";
-import { LogLevel, Logger } from "@contractspec/lib.logger";
-
-//#region src/generate.ts
-const logger = new Logger({
-	level: process.env.NODE_ENV === "production" ? LogLevel.INFO : LogLevel.DEBUG,
-	environment: process.env.NODE_ENV || "development",
-	enableColors: process.env.NODE_ENV !== "production"
+import { Logger, LogLevel } from "@contractspec/lib.logger";
+var logger = new Logger({
+  level: LogLevel.DEBUG,
+  environment: "development",
+  enableColors: true
 });
 async function runContentGenerationExample() {
-	const brief = {
-		title: "AI-Native Operations Copilot",
-		summary: "Automates support resolutions, growth playbooks, and DevOps rituals.",
-		problems: ["Support queues pile up after hours", "Growth teams lack fresh experiments"],
-		solutions: [
-			"Stateful AI agents grounded in your knowledge spaces",
-			"CI-safe approval workflows for human review",
-			"Analytics + experimentation stack built into ContractSpec"
-		],
-		metrics: ["80% auto-resolution rate", "10+ experiments shipped weekly"],
-		audience: {
-			role: "COO",
-			industry: "Fintech",
-			maturity: "scaleup"
-		},
-		callToAction: "Book a 15‑minute pilot run"
-	};
-	const blog = await new BlogGenerator().generate(brief);
-	const landing = await new LandingPageGenerator().generate(brief);
-	const email = await new EmailCampaignGenerator().generate({
-		brief,
-		variant: "announcement"
-	});
-	const social = await new SocialPostGenerator().generate(brief);
-	const seo = new SeoOptimizer().optimize(brief);
-	logger.info("Generated content assets", {
-		blogIntro: blog.intro,
-		landingHero: landing.hero,
-		emailSubject: email.subject,
-		socialPosts: social.map((post) => post.body),
-		seo
-	});
+  const brief = {
+    title: "AI-Native Operations Copilot",
+    summary: "Automates support resolutions, growth playbooks, and DevOps rituals.",
+    problems: [
+      "Support queues pile up after hours",
+      "Growth teams lack fresh experiments"
+    ],
+    solutions: [
+      "Stateful AI agents grounded in your knowledge spaces",
+      "CI-safe approval workflows for human review",
+      "Analytics + experimentation stack built into ContractSpec"
+    ],
+    metrics: ["80% auto-resolution rate", "10+ experiments shipped weekly"],
+    audience: { role: "COO", industry: "Fintech", maturity: "scaleup" },
+    callToAction: "Book a 15\u2011minute pilot run"
+  };
+  const blog = await new BlogGenerator().generate(brief);
+  const landing = await new LandingPageGenerator().generate(brief);
+  const email = await new EmailCampaignGenerator().generate({
+    brief,
+    variant: "announcement"
+  });
+  const social = await new SocialPostGenerator().generate(brief);
+  const seo = new SeoOptimizer().optimize(brief);
+  logger.info("Generated content assets", {
+    blogIntro: blog.intro,
+    landingHero: landing.hero,
+    emailSubject: email.subject,
+    socialPosts: social.map((post) => post.body),
+    seo
+  });
 }
-
-//#endregion
-export { runContentGenerationExample };
-//# sourceMappingURL=generate.js.map
+export {
+  runContentGenerationExample
+};

package/dist/index.d.ts

@@ -1,3 +1,4 @@
-import example from "./example.js";
-import { runContentGenerationExample } from "./generate.js";
-export { example, runContentGenerationExample };
+export * from './generate';
+export { default as example } from './example';
+import './docs';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,QAAQ,CAAC"}

package/dist/index.js

@@ -1,5 +1,123 @@
-import example from "./example.js";
-import { runContentGenerationExample } from "./generate.js";
-import "./docs/index.js";
+// @bun
+// src/docs/content-generation.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.content-generation",
+    title: "Content Generation (example)",
+    summary: "Generate a consistent set of marketing assets from a typed ContentBrief (blog, landing hero, email, social, SEO).",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/content-generation",
+    tags: ["content", "marketing", "example"],
+    body: `## What this example shows
+- A spec-first-ish interface for content brief inputs (typed, validated).
+- Deterministic orchestration of generators (same input \u2192 same structure).
 
-export { example, runContentGenerationExample };
+## Outputs
+- Blog intro
+- Landing hero
+- Email subject/body
+- Social post bodies
+- SEO metadata`
+  },
+  {
+    id: "docs.examples.content-generation.usage",
+    title: "Content Generation \u2014 Usage",
+    summary: "How to run the example and extend the brief.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/content-generation/usage",
+    tags: ["content", "usage"],
+    body: `## Usage
+- Call \`runContentGenerationExample()\`.
+- Modify the \`ContentBrief\` fields to drive different outputs.
+
+## Guardrails
+- Avoid PII in briefs.
+- Keep output logging structured; no raw \`console.log\` in library code.`
+  }
+];
+registerDocBlocks(blocks);
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "content-generation",
+    version: "1.0.0",
+    title: "Content Generation",
+    description: "Generate blog/landing/email/social/SEO assets from a typed ContentBrief using @contractspec/lib.content-gen.",
+    kind: "script",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["content", "marketing", "generation", "ai"]
+  },
+  docs: {
+    rootDocId: "docs.examples.content-generation",
+    usageDocId: "docs.examples.content-generation.usage"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.content-generation",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ["markdown"] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+
+// src/generate.ts
+import {
+  BlogGenerator,
+  EmailCampaignGenerator,
+  LandingPageGenerator,
+  SocialPostGenerator
+} from "@contractspec/lib.content-gen/generators";
+import { SeoOptimizer } from "@contractspec/lib.content-gen/seo";
+import { Logger, LogLevel } from "@contractspec/lib.logger";
+var logger = new Logger({
+  level: LogLevel.DEBUG,
+  environment: "development",
+  enableColors: true
+});
+async function runContentGenerationExample() {
+  const brief = {
+    title: "AI-Native Operations Copilot",
+    summary: "Automates support resolutions, growth playbooks, and DevOps rituals.",
+    problems: [
+      "Support queues pile up after hours",
+      "Growth teams lack fresh experiments"
+    ],
+    solutions: [
+      "Stateful AI agents grounded in your knowledge spaces",
+      "CI-safe approval workflows for human review",
+      "Analytics + experimentation stack built into ContractSpec"
+    ],
+    metrics: ["80% auto-resolution rate", "10+ experiments shipped weekly"],
+    audience: { role: "COO", industry: "Fintech", maturity: "scaleup" },
+    callToAction: "Book a 15\u2011minute pilot run"
+  };
+  const blog = await new BlogGenerator().generate(brief);
+  const landing = await new LandingPageGenerator().generate(brief);
+  const email = await new EmailCampaignGenerator().generate({
+    brief,
+    variant: "announcement"
+  });
+  const social = await new SocialPostGenerator().generate(brief);
+  const seo = new SeoOptimizer().optimize(brief);
+  logger.info("Generated content assets", {
+    blogIntro: blog.intro,
+    landingHero: landing.hero,
+    emailSubject: email.subject,
+    socialPosts: social.map((post) => post.body),
+    seo
+  });
+}
+export {
+  runContentGenerationExample,
+  example_default as example
+};

package/dist/node/docs/content-generation.docblock.js

@@ -0,0 +1,40 @@
+// src/docs/content-generation.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.content-generation",
+    title: "Content Generation (example)",
+    summary: "Generate a consistent set of marketing assets from a typed ContentBrief (blog, landing hero, email, social, SEO).",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/content-generation",
+    tags: ["content", "marketing", "example"],
+    body: `## What this example shows
+- A spec-first-ish interface for content brief inputs (typed, validated).
+- Deterministic orchestration of generators (same input → same structure).
+
+## Outputs
+- Blog intro
+- Landing hero
+- Email subject/body
+- Social post bodies
+- SEO metadata`
+  },
+  {
+    id: "docs.examples.content-generation.usage",
+    title: "Content Generation — Usage",
+    summary: "How to run the example and extend the brief.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/content-generation/usage",
+    tags: ["content", "usage"],
+    body: `## Usage
+- Call \`runContentGenerationExample()\`.
+- Modify the \`ContentBrief\` fields to drive different outputs.
+
+## Guardrails
+- Avoid PII in briefs.
+- Keep output logging structured; no raw \`console.log\` in library code.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/node/docs/index.js

@@ -0,0 +1,40 @@
+// src/docs/content-generation.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.content-generation",
+    title: "Content Generation (example)",
+    summary: "Generate a consistent set of marketing assets from a typed ContentBrief (blog, landing hero, email, social, SEO).",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/content-generation",
+    tags: ["content", "marketing", "example"],
+    body: `## What this example shows
+- A spec-first-ish interface for content brief inputs (typed, validated).
+- Deterministic orchestration of generators (same input → same structure).
+
+## Outputs
+- Blog intro
+- Landing hero
+- Email subject/body
+- Social post bodies
+- SEO metadata`
+  },
+  {
+    id: "docs.examples.content-generation.usage",
+    title: "Content Generation — Usage",
+    summary: "How to run the example and extend the brief.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/content-generation/usage",
+    tags: ["content", "usage"],
+    body: `## Usage
+- Call \`runContentGenerationExample()\`.
+- Modify the \`ContentBrief\` fields to drive different outputs.
+
+## Guardrails
+- Avoid PII in briefs.
+- Keep output logging structured; no raw \`console.log\` in library code.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/node/example.js

@@ -0,0 +1,33 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "content-generation",
+    version: "1.0.0",
+    title: "Content Generation",
+    description: "Generate blog/landing/email/social/SEO assets from a typed ContentBrief using @contractspec/lib.content-gen.",
+    kind: "script",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["content", "marketing", "generation", "ai"]
+  },
+  docs: {
+    rootDocId: "docs.examples.content-generation",
+    usageDocId: "docs.examples.content-generation.usage"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.content-generation",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ["markdown"] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/node/generate.js

@@ -0,0 +1,50 @@
+// src/generate.ts
+import {
+  BlogGenerator,
+  EmailCampaignGenerator,
+  LandingPageGenerator,
+  SocialPostGenerator
+} from "@contractspec/lib.content-gen/generators";
+import { SeoOptimizer } from "@contractspec/lib.content-gen/seo";
+import { Logger, LogLevel } from "@contractspec/lib.logger";
+var logger = new Logger({
+  level: LogLevel.DEBUG,
+  environment: "development",
+  enableColors: true
+});
+async function runContentGenerationExample() {
+  const brief = {
+    title: "AI-Native Operations Copilot",
+    summary: "Automates support resolutions, growth playbooks, and DevOps rituals.",
+    problems: [
+      "Support queues pile up after hours",
+      "Growth teams lack fresh experiments"
+    ],
+    solutions: [
+      "Stateful AI agents grounded in your knowledge spaces",
+      "CI-safe approval workflows for human review",
+      "Analytics + experimentation stack built into ContractSpec"
+    ],
+    metrics: ["80% auto-resolution rate", "10+ experiments shipped weekly"],
+    audience: { role: "COO", industry: "Fintech", maturity: "scaleup" },
+    callToAction: "Book a 15‑minute pilot run"
+  };
+  const blog = await new BlogGenerator().generate(brief);
+  const landing = await new LandingPageGenerator().generate(brief);
+  const email = await new EmailCampaignGenerator().generate({
+    brief,
+    variant: "announcement"
+  });
+  const social = await new SocialPostGenerator().generate(brief);
+  const seo = new SeoOptimizer().optimize(brief);
+  logger.info("Generated content assets", {
+    blogIntro: blog.intro,
+    landingHero: landing.hero,
+    emailSubject: email.subject,
+    socialPosts: social.map((post) => post.body),
+    seo
+  });
+}
+export {
+  runContentGenerationExample
+};

package/dist/node/index.js

@@ -0,0 +1,122 @@
+// src/docs/content-generation.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.content-generation",
+    title: "Content Generation (example)",
+    summary: "Generate a consistent set of marketing assets from a typed ContentBrief (blog, landing hero, email, social, SEO).",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/content-generation",
+    tags: ["content", "marketing", "example"],
+    body: `## What this example shows
+- A spec-first-ish interface for content brief inputs (typed, validated).
+- Deterministic orchestration of generators (same input → same structure).
+
+## Outputs
+- Blog intro
+- Landing hero
+- Email subject/body
+- Social post bodies
+- SEO metadata`
+  },
+  {
+    id: "docs.examples.content-generation.usage",
+    title: "Content Generation — Usage",
+    summary: "How to run the example and extend the brief.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/content-generation/usage",
+    tags: ["content", "usage"],
+    body: `## Usage
+- Call \`runContentGenerationExample()\`.
+- Modify the \`ContentBrief\` fields to drive different outputs.
+
+## Guardrails
+- Avoid PII in briefs.
+- Keep output logging structured; no raw \`console.log\` in library code.`
+  }
+];
+registerDocBlocks(blocks);
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "content-generation",
+    version: "1.0.0",
+    title: "Content Generation",
+    description: "Generate blog/landing/email/social/SEO assets from a typed ContentBrief using @contractspec/lib.content-gen.",
+    kind: "script",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["content", "marketing", "generation", "ai"]
+  },
+  docs: {
+    rootDocId: "docs.examples.content-generation",
+    usageDocId: "docs.examples.content-generation.usage"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.content-generation",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ["markdown"] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+
+// src/generate.ts
+import {
+  BlogGenerator,
+  EmailCampaignGenerator,
+  LandingPageGenerator,
+  SocialPostGenerator
+} from "@contractspec/lib.content-gen/generators";
+import { SeoOptimizer } from "@contractspec/lib.content-gen/seo";
+import { Logger, LogLevel } from "@contractspec/lib.logger";
+var logger = new Logger({
+  level: LogLevel.DEBUG,
+  environment: "development",
+  enableColors: true
+});
+async function runContentGenerationExample() {
+  const brief = {
+    title: "AI-Native Operations Copilot",
+    summary: "Automates support resolutions, growth playbooks, and DevOps rituals.",
+    problems: [
+      "Support queues pile up after hours",
+      "Growth teams lack fresh experiments"
+    ],
+    solutions: [
+      "Stateful AI agents grounded in your knowledge spaces",
+      "CI-safe approval workflows for human review",
+      "Analytics + experimentation stack built into ContractSpec"
+    ],
+    metrics: ["80% auto-resolution rate", "10+ experiments shipped weekly"],
+    audience: { role: "COO", industry: "Fintech", maturity: "scaleup" },
+    callToAction: "Book a 15‑minute pilot run"
+  };
+  const blog = await new BlogGenerator().generate(brief);
+  const landing = await new LandingPageGenerator().generate(brief);
+  const email = await new EmailCampaignGenerator().generate({
+    brief,
+    variant: "announcement"
+  });
+  const social = await new SocialPostGenerator().generate(brief);
+  const seo = new SeoOptimizer().optimize(brief);
+  logger.info("Generated content assets", {
+    blogIntro: blog.intro,
+    landingHero: landing.hero,
+    emailSubject: email.subject,
+    socialPosts: social.map((post) => post.body),
+    seo
+  });
+}
+export {
+  runContentGenerationExample,
+  example_default as example
+};

package/package.json

@@ -1,50 +1,87 @@
 {
   "name": "@contractspec/example.content-generation",
-  "version": "1.57.0",
+  "version": "1.58.0",
   "description": "Content generation example using @contractspec/lib.content-gen.",
   "type": "module",
   "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./dist/index.js",
-    "./docs": "./dist/docs/index.js",
-    "./docs/content-generation.docblock": "./dist/docs/content-generation.docblock.js",
-    "./example": "./dist/example.js",
-    "./generate": "./dist/generate.js",
-    "./*": "./*"
+    ".": "./src/index.ts",
+    "./docs": "./src/docs/index.ts",
+    "./docs/content-generation.docblock": "./src/docs/content-generation.docblock.ts",
+    "./docs/index": "./src/docs/index.ts",
+    "./example": "./src/example.ts",
+    "./generate": "./src/generate.ts"
   },
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
-    "build": "bun build:types && bun build:bundle",
-    "build:bundle": "tsdown",
-    "build:types": "tsc --noEmit",
-    "dev": "bun build:bundle --watch",
+    "build": "bun run prebuild && bun run build:bundle && bun run build:types",
+    "build:bundle": "contractspec-bun-build transpile",
+    "build:types": "contractspec-bun-build types",
+    "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
     "lint:fix": "eslint src --fix",
     "lint:check": "eslint src",
-    "test": "bun test"
+    "test": "bun test",
+    "prebuild": "contractspec-bun-build prebuild",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts": "1.57.0",
-    "@contractspec/lib.content-gen": "1.57.0",
-    "@contractspec/lib.logger": "1.57.0"
+    "@contractspec/lib.contracts": "1.58.0",
+    "@contractspec/lib.content-gen": "1.58.0",
+    "@contractspec/lib.logger": "1.58.0"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.57.0",
-    "@contractspec/tool.typescript": "1.57.0",
-    "tsdown": "^0.20.3",
-    "typescript": "^5.9.3"
+    "@contractspec/tool.typescript": "1.58.0",
+    "typescript": "^5.9.3",
+    "@contractspec/tool.bun": "1.57.0"
   },
   "publishConfig": {
     "access": "public",
     "exports": {
-      ".": "./dist/index.js",
-      "./docs": "./dist/docs/index.js",
-      "./docs/content-generation.docblock": "./dist/docs/content-generation.docblock.js",
-      "./example": "./dist/example.js",
-      "./generate": "./dist/generate.js",
-      "./*": "./*"
+      ".": {
+        "types": "./dist/index.d.ts",
+        "bun": "./dist/index.js",
+        "node": "./dist/node/index.mjs",
+        "browser": "./dist/browser/index.js",
+        "default": "./dist/index.js"
+      },
+      "./docs": {
+        "types": "./dist/docs/index.d.ts",
+        "bun": "./dist/docs/index.js",
+        "node": "./dist/node/docs/index.mjs",
+        "browser": "./dist/browser/docs/index.js",
+        "default": "./dist/docs/index.js"
+      },
+      "./docs/content-generation.docblock": {
+        "types": "./dist/docs/content-generation.docblock.d.ts",
+        "bun": "./dist/docs/content-generation.docblock.js",
+        "node": "./dist/node/docs/content-generation.docblock.mjs",
+        "browser": "./dist/browser/docs/content-generation.docblock.js",
+        "default": "./dist/docs/content-generation.docblock.js"
+      },
+      "./docs/index": {
+        "types": "./dist/docs/index.d.ts",
+        "bun": "./dist/docs/index.js",
+        "node": "./dist/node/docs/index.mjs",
+        "browser": "./dist/browser/docs/index.js",
+        "default": "./dist/docs/index.js"
+      },
+      "./example": {
+        "types": "./dist/example.d.ts",
+        "bun": "./dist/example.js",
+        "node": "./dist/node/example.mjs",
+        "browser": "./dist/browser/example.js",
+        "default": "./dist/example.js"
+      },
+      "./generate": {
+        "types": "./dist/generate.d.ts",
+        "bun": "./dist/generate.js",
+        "node": "./dist/node/generate.mjs",
+        "browser": "./dist/browser/generate.js",
+        "default": "./dist/generate.js"
+      }
     },
     "registry": "https://registry.npmjs.org/"
   },

package/tsdown.config.js

@@ -1,5 +1,4 @@
-import { defineConfig } from 'tsdown';
-import { moduleLibrary } from '@contractspec/tool.tsdown';
+import { defineConfig, moduleLibrary } from '@contractspec/tool.bun';
 
 export default defineConfig(() => ({
   ...moduleLibrary,