@tpmjs/audience-persona 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,88 @@
+import * as ai from 'ai';
+
+/**
+ * Audience Persona Tool for TPMJS
+ * Creates detailed audience persona profiles from demographic and behavioral data
+ *
+ * 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 AudiencePersona {
+    name: string;
+    demographics: {
+        ageRange: string;
+        gender?: string;
+        location?: string;
+        education?: string;
+        occupation?: string;
+        income?: string;
+    };
+    psychographics: {
+        interests: string[];
+        values: string[];
+        lifestyle?: string;
+        personality?: string;
+    };
+    goals: string[];
+    painPoints: string[];
+    behaviors: {
+        preferredChannels: string[];
+        buyingPatterns?: string;
+        contentPreferences: string[];
+        deviceUsage?: string[];
+    };
+    marketingImplications: {
+        messagingStrategy: string;
+        contentRecommendations: string[];
+        channelStrategy: string;
+        keyTriggers: string[];
+    };
+    quote?: string;
+}
+/**
+ * Input type for Audience Persona Tool
+ */
+type AudiencePersonaInput = {
+    data: Record<string, unknown>;
+    productContext: string;
+};
+/**
+ * Audience Persona Tool
+ * Creates detailed audience persona profiles from demographic and behavioral data
+ *
+ * This is a proper AI SDK v6 tool that can be used with streamText()
+ */
+declare const audiencePersonaTool: ai.Tool<AudiencePersonaInput, {
+    name: string;
+    demographics: {
+        ageRange: string;
+        gender?: string;
+        location?: string;
+        education?: string;
+        occupation?: string;
+        income?: string;
+    };
+    psychographics: {
+        interests: string[];
+        values: string[];
+        lifestyle?: string;
+        personality?: string;
+    };
+    goals: string[];
+    painPoints: string[];
+    behaviors: {
+        preferredChannels: string[];
+        buyingPatterns?: string;
+        contentPreferences: string[];
+        deviceUsage?: string[];
+    };
+    marketingImplications: {
+        messagingStrategy: string;
+        contentRecommendations: string[];
+        channelStrategy: string;
+        keyTriggers: string[];
+    };
+    quote: string;
+}>;
+
+export { type AudiencePersona, audiencePersonaTool, audiencePersonaTool as default };

package/dist/index.js

@@ -0,0 +1,215 @@
+import { tool, jsonSchema } from 'ai';
+
+// src/index.ts
+function extractDemographics(data) {
+  const demographics = {
+    ageRange: "Not specified"
+  };
+  if (data.age) {
+    const age = Number(data.age);
+    if (!isNaN(age)) {
+      if (age < 18) demographics.ageRange = "Under 18";
+      else if (age < 25) demographics.ageRange = "18-24";
+      else if (age < 35) demographics.ageRange = "25-34";
+      else if (age < 45) demographics.ageRange = "35-44";
+      else if (age < 55) demographics.ageRange = "45-54";
+      else if (age < 65) demographics.ageRange = "55-64";
+      else demographics.ageRange = "65+";
+    }
+  } else if (data.ageRange) {
+    demographics.ageRange = String(data.ageRange);
+  }
+  if (data.gender) demographics.gender = String(data.gender);
+  if (data.location) demographics.location = String(data.location);
+  if (data.education) demographics.education = String(data.education);
+  if (data.occupation) demographics.occupation = String(data.occupation);
+  if (data.income) demographics.income = String(data.income);
+  return demographics;
+}
+function extractPsychographics(data) {
+  const psychographics = {
+    interests: [],
+    values: []
+  };
+  if (Array.isArray(data.interests)) {
+    psychographics.interests = data.interests.map(String);
+  } else if (typeof data.interests === "string") {
+    psychographics.interests = data.interests.split(",").map((s) => s.trim());
+  }
+  if (Array.isArray(data.values)) {
+    psychographics.values = data.values.map(String);
+  } else if (typeof data.values === "string") {
+    psychographics.values = data.values.split(",").map((s) => s.trim());
+  }
+  if (data.lifestyle) psychographics.lifestyle = String(data.lifestyle);
+  if (data.personality) psychographics.personality = String(data.personality);
+  return psychographics;
+}
+function extractGoals(data) {
+  if (Array.isArray(data.goals)) {
+    return data.goals.map(String);
+  } else if (typeof data.goals === "string") {
+    return data.goals.split(/[,;]/).map((s) => s.trim()).filter(Boolean);
+  }
+  return [];
+}
+function extractPainPoints(data) {
+  if (Array.isArray(data.painPoints)) {
+    return data.painPoints.map(String);
+  } else if (typeof data.painPoints === "string") {
+    return data.painPoints.split(/[,;]/).map((s) => s.trim()).filter(Boolean);
+  }
+  return [];
+}
+function extractBehaviors(data) {
+  const behaviors = {
+    preferredChannels: [],
+    contentPreferences: []
+  };
+  if (Array.isArray(data.preferredChannels)) {
+    behaviors.preferredChannels = data.preferredChannels.map(String);
+  } else if (typeof data.preferredChannels === "string") {
+    behaviors.preferredChannels = data.preferredChannels.split(",").map((s) => s.trim());
+  }
+  if (Array.isArray(data.contentPreferences)) {
+    behaviors.contentPreferences = data.contentPreferences.map(String);
+  } else if (typeof data.contentPreferences === "string") {
+    behaviors.contentPreferences = data.contentPreferences.split(",").map((s) => s.trim());
+  }
+  if (data.buyingPatterns) {
+    behaviors.buyingPatterns = String(data.buyingPatterns);
+  }
+  if (Array.isArray(data.deviceUsage)) {
+    behaviors.deviceUsage = data.deviceUsage.map(String);
+  } else if (typeof data.deviceUsage === "string") {
+    behaviors.deviceUsage = data.deviceUsage.split(",").map((s) => s.trim());
+  }
+  return behaviors;
+}
+function generatePersonaName(demographics, _productContext) {
+  const occupation = demographics.occupation || "Professional";
+  const firstNames = ["Alex", "Beth", "Chris", "Dana", "Emma", "Frank", "Grace", "Henry"];
+  const lastNames = ["Anderson", "Baker", "Chen", "Davis", "Evans", "Foster", "Garcia", "Harris"];
+  const firstInitial = occupation.charAt(0).toUpperCase();
+  const firstName = firstNames.find((n) => n.startsWith(firstInitial)) || firstNames[0];
+  const lastName = lastNames[Math.floor(Math.random() * lastNames.length)];
+  return `${firstName} ${lastName}`;
+}
+function generateMarketingImplications(demographics, psychographics, goals, painPoints, behaviors, _productContext) {
+  let messagingStrategy = "Focus on ";
+  if (painPoints.length > 0) {
+    messagingStrategy += `addressing ${painPoints[0]?.toLowerCase() ?? "key challenges"}`;
+  } else if (goals.length > 0) {
+    messagingStrategy += `helping achieve ${goals[0]?.toLowerCase() ?? "objectives"}`;
+  } else {
+    messagingStrategy += "product benefits and value proposition";
+  }
+  const contentRecommendations = [];
+  if (behaviors.contentPreferences.length > 0) {
+    behaviors.contentPreferences.forEach((pref) => {
+      contentRecommendations.push(`Create ${pref.toLowerCase()} content`);
+    });
+  } else {
+    contentRecommendations.push("Create educational content about product benefits");
+    contentRecommendations.push("Share customer success stories");
+    contentRecommendations.push("Provide how-to guides and tutorials");
+  }
+  const ageNum = Number.parseInt(demographics.ageRange.split("-")[0] || "0");
+  if (ageNum < 35) {
+    contentRecommendations.push("Use short-form video content (TikTok, Reels)");
+  } else if (ageNum >= 35 && ageNum < 55) {
+    contentRecommendations.push("Mix video and written content");
+  } else {
+    contentRecommendations.push("Provide detailed written guides");
+  }
+  let channelStrategy = "Prioritize ";
+  if (behaviors.preferredChannels.length > 0) {
+    channelStrategy += behaviors.preferredChannels.slice(0, 2).join(" and ");
+  } else {
+    channelStrategy += "email and social media";
+  }
+  const keyTriggers = [];
+  if (psychographics.values.length > 0) {
+    keyTriggers.push(`Values: ${psychographics.values.slice(0, 2).join(", ")}`);
+  }
+  if (painPoints.length > 0 && painPoints[0]) {
+    keyTriggers.push(`Pain point: ${painPoints[0]}`);
+  }
+  if (goals.length > 0 && goals[0]) {
+    keyTriggers.push(`Goal: ${goals[0]}`);
+  }
+  if (keyTriggers.length === 0) {
+    keyTriggers.push("Product benefits and features");
+    keyTriggers.push("Social proof and testimonials");
+  }
+  return {
+    messagingStrategy,
+    contentRecommendations,
+    channelStrategy,
+    keyTriggers
+  };
+}
+function generateQuote(goals, painPoints, _productContext) {
+  if (painPoints.length > 0 && goals.length > 0 && painPoints[0] && goals[0]) {
+    return `"I struggle with ${painPoints[0].toLowerCase()}, and I need a solution that helps me ${goals[0].toLowerCase()}."`;
+  } else if (painPoints.length > 0 && painPoints[0]) {
+    return `"My biggest challenge is ${painPoints[0].toLowerCase()}."`;
+  } else if (goals.length > 0 && goals[0]) {
+    return `"I want to ${goals[0].toLowerCase()}."`;
+  } else {
+    return `"I'm looking for a solution that makes my life easier."`;
+  }
+}
+var audiencePersonaTool = tool({
+  description: "Creates detailed audience persona profiles from demographic and behavioral data. Generates personas with demographics, psychographics, goals, pain points, behaviors, and actionable marketing implications.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      data: {
+        type: "object",
+        description: "Audience data points (age/ageRange, gender, location, education, occupation, income, interests, values, lifestyle, personality, goals, painPoints, preferredChannels, contentPreferences, buyingPatterns, deviceUsage)",
+        additionalProperties: true
+      },
+      productContext: {
+        type: "string",
+        description: "Product or service context for persona development"
+      }
+    },
+    required: ["data", "productContext"],
+    additionalProperties: false
+  }),
+  async execute({ data, productContext }) {
+    if (!data || typeof data !== "object") {
+      throw new Error("Data must be a non-empty object");
+    }
+    if (!productContext || productContext.trim().length === 0) {
+      throw new Error("Product context is required");
+    }
+    const demographics = extractDemographics(data);
+    const psychographics = extractPsychographics(data);
+    const goals = extractGoals(data);
+    const painPoints = extractPainPoints(data);
+    const behaviors = extractBehaviors(data);
+    const name = generatePersonaName(demographics);
+    const marketingImplications = generateMarketingImplications(
+      demographics,
+      psychographics,
+      goals,
+      painPoints,
+      behaviors);
+    const quote = generateQuote(goals, painPoints);
+    return {
+      name,
+      demographics,
+      psychographics,
+      goals,
+      painPoints,
+      behaviors,
+      marketingImplications,
+      quote
+    };
+  }
+});
+var index_default = audiencePersonaTool;
+
+export { audiencePersonaTool, index_default as default };

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@tpmjs/audience-persona",
+  "version": "0.1.0",
+  "description": "Create audience persona profiles from demographic and behavioral data",
+  "type": "module",
+  "keywords": [
+    "tpmjs",
+    "marketing",
+    "persona",
+    "audience",
+    "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/audience-persona"
+  },
+  "homepage": "https://tpmjs.com",
+  "license": "MIT",
+  "tpmjs": {
+    "category": "marketing",
+    "frameworks": [
+      "vercel-ai"
+    ],
+    "tools": [
+      {
+        "exportName": "audiencePersonaTool",
+        "description": "Creates detailed audience persona profiles from demographic and behavioral data. Generates personas with demographics, psychographics, goals, pain points, behaviors, and actionable marketing implications.",
+        "parameters": [
+          {
+            "name": "data",
+            "type": "object",
+            "description": "Audience data points (age/ageRange, gender, location, education, occupation, income, interests, values, lifestyle, personality, goals, painPoints, preferredChannels, contentPreferences, buyingPatterns, deviceUsage)",
+            "required": true
+          },
+          {
+            "name": "productContext",
+            "type": "string",
+            "description": "Product or service context for persona development",
+            "required": true
+          }
+        ],
+        "returns": {
+          "type": "AudiencePersona",
+          "description": "Complete persona profile with demographics, psychographics, goals, pain points, behaviors, marketing implications, and representative quote"
+        },
+        "aiAgent": {
+          "useCase": "Use this tool when users need to create detailed audience personas for marketing strategy. Transforms raw audience data into actionable persona profiles with marketing recommendations.",
+          "limitations": "Requires structured input data. Generated names are fictional. Marketing implications are strategic suggestions, not guaranteed results.",
+          "examples": [
+            "Create a persona for our SaaS product targeting small business owners",
+            "Build an audience profile from our customer survey data",
+            "Generate a marketing persona for 25-34 year old tech professionals"
+          ]
+        }
+      }
+    ]
+  },
+  "dependencies": {
+    "ai": "6.0.0-beta.124"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  }
+}