@tpmjs/content-calendar-plan 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2025 TPMJS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+import * as ai from 'ai';
+
+/**
+ * Content Calendar Plan Tool for TPMJS
+ * Generates content calendar structure with themes, topics, and posting schedule
+ *
+ * This is a proper AI SDK v6 tool that can be used with streamText()
+ * Uses jsonSchema() to avoid Zod 4 JSON Schema conversion issues with OpenAI
+ */
+interface ContentItem {
+    date: string;
+    channel: string;
+    contentType: string;
+    theme?: string;
+    topic: string;
+    objective: string;
+    suggestedFormat?: string;
+}
+interface ContentCalendar {
+    duration: string;
+    startDate: string;
+    endDate: string;
+    channels: string[];
+    themes: string[];
+    items: ContentItem[];
+    summary: {
+        totalPosts: number;
+        postsByChannel: Record<string, number>;
+        postsByTheme: Record<string, number>;
+        averagePostsPerWeek: number;
+    };
+}
+/**
+ * Input type for Content Calendar Plan Tool
+ */
+type ContentCalendarPlanInput = {
+    duration: string;
+    channels: string[];
+    themes?: string[];
+};
+/**
+ * Content Calendar Plan Tool
+ * Generates content calendar structure with themes, topics, and posting schedule
+ *
+ * This is a proper AI SDK v6 tool that can be used with streamText()
+ */
+declare const contentCalendarPlanTool: ai.Tool<ContentCalendarPlanInput, {
+    duration: string;
+    startDate: string;
+    endDate: string;
+    channels: string[];
+    themes: string[];
+    items: ContentItem[];
+    summary: {
+        totalPosts: number;
+        postsByChannel: Record<string, number>;
+        postsByTheme: Record<string, number>;
+        averagePostsPerWeek: number;
+    };
+}>;
+
+export { type ContentCalendar, type ContentItem, contentCalendarPlanTool, contentCalendarPlanTool as default };

package/dist/index.js

@@ -0,0 +1,259 @@
+import { tool, jsonSchema } from 'ai';
+
+// src/index.ts
+function calculateDateRange(duration) {
+  const startDate = /* @__PURE__ */ new Date();
+  startDate.setHours(0, 0, 0, 0);
+  const endDate = new Date(startDate);
+  let weeks = 1;
+  const durationLower = duration.toLowerCase();
+  if (durationLower.includes("week")) {
+    const weekMatch = durationLower.match(/(\d+)\s*week/);
+    weeks = weekMatch?.[1] ? Number.parseInt(weekMatch[1]) : 1;
+    endDate.setDate(endDate.getDate() + weeks * 7);
+  } else if (durationLower.includes("month")) {
+    const monthMatch = durationLower.match(/(\d+)\s*month/);
+    const months = monthMatch?.[1] ? Number.parseInt(monthMatch[1]) : 1;
+    endDate.setMonth(endDate.getMonth() + months);
+    weeks = Math.ceil((endDate.getTime() - startDate.getTime()) / (7 * 24 * 60 * 60 * 1e3));
+  } else if (durationLower.includes("quarter")) {
+    endDate.setMonth(endDate.getMonth() + 3);
+    weeks = 13;
+  } else {
+    endDate.setDate(endDate.getDate() + 7);
+    weeks = 1;
+  }
+  return { startDate, endDate, weeks };
+}
+function getChannelFrequency(channel) {
+  const frequencies = {
+    twitter: 7,
+    // Daily
+    instagram: 5,
+    // 5 times per week
+    linkedin: 3,
+    // 3 times per week
+    facebook: 5,
+    // 5 times per week
+    blog: 2,
+    // 2 times per week
+    youtube: 1,
+    // Weekly
+    tiktok: 7,
+    // Daily
+    email: 1,
+    // Weekly
+    newsletter: 1,
+    // Weekly
+    podcast: 1
+    // Weekly
+  };
+  const channelLower = channel.toLowerCase();
+  for (const [key, freq] of Object.entries(frequencies)) {
+    if (channelLower.includes(key)) {
+      return freq;
+    }
+  }
+  return 3;
+}
+function getContentTypes(channel) {
+  const contentTypes = {
+    twitter: ["tweet", "thread", "poll", "quote tweet"],
+    instagram: ["post", "reel", "story", "carousel"],
+    linkedin: ["article", "post", "poll", "document"],
+    facebook: ["post", "video", "live stream", "poll"],
+    blog: ["article", "tutorial", "case study", "listicle"],
+    youtube: ["video", "short", "live stream"],
+    tiktok: ["video", "duet", "stitch"],
+    email: ["newsletter", "promotional", "educational"],
+    newsletter: ["digest", "featured article", "roundup"],
+    podcast: ["episode", "interview", "solo show"]
+  };
+  const channelLower = channel.toLowerCase();
+  for (const [key, types] of Object.entries(contentTypes)) {
+    if (channelLower.includes(key)) {
+      return types;
+    }
+  }
+  return ["post", "article", "video"];
+}
+function generateDefaultThemes() {
+  return ["Educational", "Promotional", "Inspirational", "Engagement", "Behind-the-scenes"];
+}
+function getObjective(theme) {
+  const objectives = {
+    educational: "Provide valuable information and insights",
+    promotional: "Drive conversions and sales",
+    inspirational: "Inspire and motivate audience",
+    engagement: "Encourage interaction and community building",
+    "behind-the-scenes": "Build trust and transparency",
+    awareness: "Increase brand visibility",
+    entertainment: "Entertain and delight audience",
+    "user-generated": "Showcase community content"
+  };
+  const themeLower = theme.toLowerCase();
+  for (const [key, objective] of Object.entries(objectives)) {
+    if (themeLower.includes(key)) {
+      return objective;
+    }
+  }
+  return "Engage and inform audience";
+}
+function generateTopic(theme, _channel, index) {
+  const topics = {
+    educational: [
+      "How-to guide",
+      "Industry insights",
+      "Best practices",
+      "Tips and tricks",
+      "Common mistakes",
+      "Beginner tutorial",
+      "Advanced techniques",
+      "Explainer content"
+    ],
+    promotional: [
+      "Product showcase",
+      "Feature highlight",
+      "Customer testimonial",
+      "Limited offer",
+      "New release",
+      "Product comparison",
+      "Success story"
+    ],
+    inspirational: [
+      "Success story",
+      "Motivational quote",
+      "Transformation story",
+      "Industry leader spotlight",
+      "Achievement celebration"
+    ],
+    engagement: [
+      "Poll question",
+      "Ask Me Anything",
+      "Caption contest",
+      "Community spotlight",
+      "Discussion prompt",
+      "Quiz"
+    ],
+    "behind-the-scenes": [
+      "Team introduction",
+      "Office tour",
+      "Process reveal",
+      "Day in the life",
+      "Product development"
+    ]
+  };
+  const themeLower = theme.toLowerCase();
+  for (const [key, topicList] of Object.entries(topics)) {
+    if (themeLower.includes(key)) {
+      return topicList[index % topicList.length] || topicList[0] || "Content topic";
+    }
+  }
+  return `Content topic ${index + 1}`;
+}
+function generateContentItems(startDate, endDate, channels, themes) {
+  const items = [];
+  let themeIndex = 0;
+  for (const channel of channels) {
+    const frequency = getChannelFrequency(channel);
+    const contentTypes = getContentTypes(channel);
+    const totalDays = Math.ceil((endDate.getTime() - startDate.getTime()) / (24 * 60 * 60 * 1e3));
+    const totalPosts = Math.ceil(totalDays / 7 * frequency);
+    const daysBetweenPosts = Math.floor(totalDays / totalPosts);
+    for (let i = 0; i < totalPosts; i++) {
+      const postDate = new Date(startDate);
+      postDate.setDate(postDate.getDate() + i * daysBetweenPosts);
+      if (postDate > endDate) break;
+      const theme = themes[themeIndex % themes.length] ?? "";
+      const contentType = contentTypes[i % contentTypes.length] ?? "post";
+      const topic = generateTopic(theme, channel, i);
+      const objective = getObjective(theme);
+      const formattedDate = postDate.toISOString().split("T")[0];
+      if (formattedDate) {
+        items.push({
+          date: formattedDate,
+          channel,
+          contentType,
+          theme,
+          topic,
+          objective,
+          suggestedFormat: contentType
+        });
+      }
+      themeIndex++;
+    }
+  }
+  items.sort((a, b) => new Date(a.date).getTime() - new Date(b.date).getTime());
+  return items;
+}
+function calculateSummary(items, channels, themes, weeks) {
+  const postsByChannel = {};
+  const postsByTheme = {};
+  for (const channel of channels) {
+    postsByChannel[channel] = 0;
+  }
+  for (const theme of themes) {
+    postsByTheme[theme] = 0;
+  }
+  for (const item of items) {
+    postsByChannel[item.channel] = (postsByChannel[item.channel] || 0) + 1;
+    if (item.theme) {
+      postsByTheme[item.theme] = (postsByTheme[item.theme] || 0) + 1;
+    }
+  }
+  return {
+    totalPosts: items.length,
+    postsByChannel,
+    postsByTheme,
+    averagePostsPerWeek: Math.round(items.length / weeks * 10) / 10
+  };
+}
+var contentCalendarPlanTool = tool({
+  description: "Generates a structured content calendar with posting schedule, themes, topics, and content types. Organizes content by date, channel, and theme while maintaining consistent posting frequency.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      duration: {
+        type: "string",
+        description: 'Calendar duration (e.g., "1 week", "1 month", "quarter")'
+      },
+      channels: {
+        type: "array",
+        items: { type: "string" },
+        description: 'Content channels to plan for (e.g., ["Twitter", "Instagram", "Blog", "LinkedIn"])',
+        minItems: 1
+      },
+      themes: {
+        type: "array",
+        items: { type: "string" },
+        description: "Content themes or pillars (optional, defaults will be generated)"
+      }
+    },
+    required: ["duration", "channels"],
+    additionalProperties: false
+  }),
+  async execute({ duration, channels, themes }) {
+    if (!duration || duration.trim().length === 0) {
+      throw new Error("Duration is required");
+    }
+    if (!channels || channels.length === 0) {
+      throw new Error("At least one channel is required");
+    }
+    const { startDate, endDate, weeks } = calculateDateRange(duration);
+    const finalThemes = themes && themes.length > 0 ? themes : generateDefaultThemes();
+    const items = generateContentItems(startDate, endDate, channels, finalThemes);
+    const summary = calculateSummary(items, channels, finalThemes, weeks);
+    return {
+      duration,
+      startDate: startDate.toISOString().split("T")[0] || "",
+      endDate: endDate.toISOString().split("T")[0] || "",
+      channels,
+      themes: finalThemes,
+      items,
+      summary
+    };
+  }
+});
+var index_default = contentCalendarPlanTool;
+
+export { contentCalendarPlanTool, index_default as default };

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@tpmjs/content-calendar-plan",
+  "version": "0.1.0",
+  "description": "Generate content calendar structure with themes, topics, and posting schedule",
+  "type": "module",
+  "keywords": [
+    "tpmjs",
+    "content-calendar",
+    "marketing",
+    "planning",
+    "ai"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.9.3",
+    "@tpmjs/tsconfig": "0.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ajaxdavis/tpmjs.git",
+    "directory": "packages/tools/official/content-calendar-plan"
+  },
+  "homepage": "https://tpmjs.com",
+  "license": "MIT",
+  "tpmjs": {
+    "category": "marketing",
+    "frameworks": [
+      "vercel-ai"
+    ],
+    "tools": [
+      {
+        "exportName": "contentCalendarPlanTool",
+        "description": "Generates a structured content calendar with posting schedule, themes, topics, and content types. Organizes content by date, channel, and theme while maintaining consistent posting frequency.",
+        "parameters": [
+          {
+            "name": "duration",
+            "type": "string",
+            "description": "Calendar duration (e.g., '1 week', '1 month', 'quarter')",
+            "required": true
+          },
+          {
+            "name": "channels",
+            "type": "string[]",
+            "description": "Content channels to plan for (e.g., ['Twitter', 'Instagram', 'Blog', 'LinkedIn'])",
+            "required": true
+          },
+          {
+            "name": "themes",
+            "type": "string[]",
+            "description": "Content themes or pillars (optional, defaults will be generated)",
+            "required": false
+          }
+        ],
+        "returns": {
+          "type": "ContentCalendar",
+          "description": "Structured content calendar with items (date, channel, type, theme, topic, objective), summary statistics, and posting frequency breakdown"
+        },
+        "aiAgent": {
+          "useCase": "Use this tool when users need to plan content calendars for social media, blogs, or multi-channel marketing. Automatically distributes content across channels with appropriate frequency and variety.",
+          "limitations": "Generates content structure and topics, not actual content. Posting frequency is based on best practices and may need adjustment based on resources.",
+          "examples": [
+            "Create a 1 month content calendar for Twitter and Instagram",
+            "Plan a quarterly content calendar for our blog and LinkedIn",
+            "Generate a week of content ideas across all our social channels"
+          ]
+        }
+      }
+    ]
+  },
+  "dependencies": {
+    "ai": "6.0.0-beta.124"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  }
+}