@timmeck/marketing-brain 0.2.0

package/src/types/post.types.ts

@@ -0,0 +1,156 @@
+export type Platform = 'x' | 'reddit' | 'linkedin' | 'bluesky' | 'mastodon' | 'threads' | 'other';
+export type PostFormat = 'text' | 'image' | 'video' | 'carousel' | 'thread' | 'article' | 'poll';
+export type PostStatus = 'draft' | 'scheduled' | 'published' | 'archived';
+
+export interface Post {
+  id: number;
+  campaign_id: number | null;
+  platform: Platform;
+  content: string;
+  format: PostFormat;
+  hashtags: string | null;
+  url: string | null;
+  published_at: string | null;
+  fingerprint: string;
+  status: PostStatus;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface PostCreate {
+  campaign_id?: number | null;
+  platform: Platform;
+  content: string;
+  format?: PostFormat;
+  hashtags?: string;
+  url?: string;
+  published_at?: string;
+  status?: PostStatus;
+}
+
+export interface Engagement {
+  id: number;
+  post_id: number;
+  timestamp: string;
+  likes: number;
+  comments: number;
+  shares: number;
+  impressions: number;
+  clicks: number;
+  saves: number;
+  reach: number;
+}
+
+export interface EngagementCreate {
+  post_id: number;
+  likes?: number;
+  comments?: number;
+  shares?: number;
+  impressions?: number;
+  clicks?: number;
+  saves?: number;
+  reach?: number;
+}
+
+export interface Campaign {
+  id: number;
+  name: string;
+  brand: string | null;
+  goal: string | null;
+  platform: string | null;
+  status: string;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface CampaignCreate {
+  name: string;
+  brand?: string;
+  goal?: string;
+  platform?: string;
+}
+
+export interface Audience {
+  id: number;
+  name: string;
+  platform: Platform | null;
+  demographics: string | null;
+  interests: string | null;
+  created_at: string;
+}
+
+export interface Strategy {
+  id: number;
+  post_id: number | null;
+  description: string;
+  approach: string | null;
+  outcome: string | null;
+  confidence: number;
+  created_at: string;
+}
+
+export interface StrategyCreate {
+  post_id?: number;
+  description: string;
+  approach?: string;
+  outcome?: string;
+}
+
+export interface ContentTemplate {
+  id: number;
+  name: string;
+  structure: string;
+  example: string | null;
+  platform: Platform | null;
+  avg_engagement: number;
+  use_count: number;
+  created_at: string;
+}
+
+export interface ContentTemplateCreate {
+  name: string;
+  structure: string;
+  example?: string;
+  platform?: Platform;
+}
+
+export interface MarketingRule {
+  id: number;
+  pattern: string;
+  recommendation: string;
+  confidence: number;
+  trigger_count: number;
+  success_count: number;
+  active: number;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface RuleCreate {
+  pattern: string;
+  recommendation: string;
+  confidence?: number;
+}
+
+export interface Insight {
+  id: number;
+  type: string;
+  title: string;
+  description: string;
+  confidence: number;
+  priority: number;
+  campaign_id: number | null;
+  active: number;
+  expires_at: string | null;
+  created_at: string;
+}
+
+export interface InsightCreate {
+  type: string;
+  title: string;
+  description: string;
+  confidence?: number;
+  priority?: number;
+  campaign_id?: number | null;
+  expires_at?: string;
+}

package/src/types/synapse.types.ts

@@ -0,0 +1,43 @@
+export type NodeType =
+  | 'post'
+  | 'campaign'
+  | 'strategy'
+  | 'template'
+  | 'rule'
+  | 'audience'
+  | 'insight';
+
+export type SynapseType =
+  | 'belongs_to'
+  | 'similar_to'
+  | 'engages_with'
+  | 'improves'
+  | 'prevents'
+  | 'recommends'
+  | 'generated_from'
+  | 'cross_promotes'
+  | 'informs'
+  | 'co_occurs';
+
+export interface SynapseRecord {
+  id: number;
+  source_type: NodeType;
+  source_id: number;
+  target_type: NodeType;
+  target_id: number;
+  synapse_type: SynapseType;
+  weight: number;
+  activation_count: number;
+  last_activated_at: string;
+  metadata: string | null;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface NetworkStats {
+  totalNodes: number;
+  totalSynapses: number;
+  avgWeight: number;
+  nodesByType: Record<NodeType, number>;
+  synapsesByType: Record<SynapseType, number>;
+}

package/src/utils/events.ts

@@ -0,0 +1,44 @@
+import { EventEmitter } from 'node:events';
+
+export interface MarketingEvents {
+  'post:created': { postId: number; campaignId: number | null; platform: string };
+  'post:published': { postId: number; platform: string };
+  'engagement:updated': { postId: number; engagementId: number };
+  'strategy:reported': { strategyId: number; postId: number };
+  'rule:learned': { ruleId: number; pattern: string };
+  'rule:triggered': { ruleId: number; postId: number };
+  'template:created': { templateId: number; platform: string };
+  'campaign:created': { campaignId: number; name: string };
+  'insight:created': { insightId: number; type: string };
+  'synapse:created': { synapseId: number; sourceType: string; targetType: string };
+  'synapse:strengthened': { synapseId: number; newWeight: number };
+}
+
+export type MarketingEventName = keyof MarketingEvents;
+
+export class TypedEventBus extends EventEmitter {
+  emit<K extends MarketingEventName>(event: K, data: MarketingEvents[K]): boolean {
+    return super.emit(event, data);
+  }
+
+  on<K extends MarketingEventName>(event: K, listener: (data: MarketingEvents[K]) => void): this {
+    return super.on(event, listener);
+  }
+
+  once<K extends MarketingEventName>(event: K, listener: (data: MarketingEvents[K]) => void): this {
+    return super.once(event, listener);
+  }
+
+  off<K extends MarketingEventName>(event: K, listener: (data: MarketingEvents[K]) => void): this {
+    return super.off(event, listener);
+  }
+}
+
+let busInstance: TypedEventBus | null = null;
+
+export function getEventBus(): TypedEventBus {
+  if (!busInstance) {
+    busInstance = new TypedEventBus();
+  }
+  return busInstance;
+}

package/src/utils/hash.ts

@@ -0,0 +1,5 @@
+import { createHash } from 'node:crypto';
+
+export function sha256(input: string): string {
+  return createHash('sha256').update(input).digest('hex');
+}

package/src/utils/logger.ts

@@ -0,0 +1,48 @@
+import winston from 'winston';
+import path from 'node:path';
+import { getDataDir } from './paths.js';
+
+const { combine, timestamp, printf, colorize } = winston.format;
+
+const logFormat = printf(({ level, message, timestamp, ...meta }) => {
+  const metaStr = Object.keys(meta).length ? ` ${JSON.stringify(meta)}` : '';
+  return `${timestamp} [${level}]${metaStr} ${message}`;
+});
+
+let loggerInstance: winston.Logger | null = null;
+
+export function createLogger(opts?: { level?: string; file?: string; maxSize?: number; maxFiles?: number }): winston.Logger {
+  if (loggerInstance) return loggerInstance;
+
+  const level = opts?.level ?? process.env['MARKETING_BRAIN_LOG_LEVEL'] ?? 'info';
+  const logFile = opts?.file ?? path.join(getDataDir(), 'marketing-brain.log');
+  const maxSize = opts?.maxSize ?? 10 * 1024 * 1024;
+  const maxFiles = opts?.maxFiles ?? 3;
+
+  const transports: winston.transport[] = [
+    new winston.transports.File({
+      filename: logFile,
+      maxsize: maxSize,
+      maxFiles,
+      format: combine(timestamp(), logFormat),
+    }),
+  ];
+
+  if (process.env['NODE_ENV'] !== 'production') {
+    transports.push(
+      new winston.transports.Console({
+        format: combine(colorize(), timestamp(), logFormat),
+      })
+    );
+  }
+
+  loggerInstance = winston.createLogger({ level, transports });
+  return loggerInstance;
+}
+
+export function getLogger(): winston.Logger {
+  if (!loggerInstance) {
+    return createLogger();
+  }
+  return loggerInstance;
+}

package/src/utils/paths.ts

@@ -0,0 +1,19 @@
+import path from 'node:path';
+import os from 'node:os';
+
+export function normalizePath(filePath: string): string {
+  return filePath.replace(/\\/g, '/');
+}
+
+export function getDataDir(): string {
+  const envDir = process.env['MARKETING_BRAIN_DATA_DIR'];
+  if (envDir) return path.resolve(envDir);
+  return path.join(os.homedir(), '.marketing-brain');
+}
+
+export function getPipeName(name: string = 'marketing-brain'): string {
+  if (process.platform === 'win32') {
+    return `\\\\.\\pipe\\${name}`;
+  }
+  return path.join(os.tmpdir(), `${name}.sock`);
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true,
+    "sourceMap": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}