crewly 1.4.60 → 1.4.62

package/dist/backend/backend/src/services/onboarding/brand-onboarding.types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Type definitions for the Brand Onboarding flow.
+ *
+ * The onboarding flow collects brand information from SMB owners
+ * and generates a Brand Voice Guide used by marketing team agents.
+ *
+ * @module brand-onboarding-types
+ */
+/** A single onboarding question with metadata. */
+export interface OnboardingQuestion {
+    /** Unique question identifier */
+    id: string;
+    /** Question text displayed to the user */
+    text: string;
+    /** Input type determines UI rendering and validation */
+    type: 'text' | 'select' | 'multi-select';
+    /** Available options for select/multi-select types */
+    options?: string[];
+    /** Whether a response is required */
+    required: boolean;
+    /** Placeholder/hint text */
+    placeholder?: string;
+    /** Default value if not answered */
+    defaultValue?: string;
+    /** Order in the questionnaire (1-based) */
+    order: number;
+}
+/** User's answer to a single question. */
+export interface OnboardingAnswer {
+    /** Matches OnboardingQuestion.id */
+    questionId: string;
+    /** User's response value */
+    value: string;
+    /** Timestamp of when the answer was provided */
+    answeredAt: string;
+}
+/** Status of the onboarding session. */
+export type OnboardingStatus = 'not_started' | 'in_progress' | 'completed' | 'generating' | 'done' | 'failed';
+/** A complete onboarding session tracking state. */
+export interface OnboardingSession {
+    /** Unique session identifier */
+    id: string;
+    /** Team ID this onboarding belongs to */
+    teamId: string;
+    /** Template ID that triggered onboarding */
+    templateId: string;
+    /** Current status */
+    status: OnboardingStatus;
+    /** Collected answers so far */
+    answers: OnboardingAnswer[];
+    /** Index of the current question (0-based) */
+    currentQuestionIndex: number;
+    /** Total number of questions */
+    totalQuestions: number;
+    /** Generated Brand Voice Guide content (populated after completion) */
+    brandVoiceGuide?: string;
+    /** Path where the guide was saved */
+    guidePath?: string;
+    /** Session creation time */
+    createdAt: string;
+    /** Last update time */
+    updatedAt: string;
+    /** Error message if status is 'failed' */
+    error?: string;
+}
+/** Structured brand profile extracted from onboarding answers. */
+export interface BrandProfile {
+    /** Business name */
+    businessName: string;
+    /** Industry/vertical */
+    industry: string;
+    /** One-sentence business description */
+    description: string;
+    /** Target customer description */
+    targetCustomer: string;
+    /** Top competitors */
+    competitors: string[];
+    /** Brand personality words (e.g., Professional, Friendly, Bold) */
+    personality: string[];
+    /** Content tone */
+    tone: 'formal' | 'casual' | 'playful' | 'authoritative';
+    /** Marketing goals */
+    goals: string[];
+    /** Active social platforms */
+    platforms: string[];
+    /** Example content URLs or descriptions */
+    contentExamples: string[];
+}
+/** Options for generating the Brand Voice Guide. */
+export interface GenerateGuideOptions {
+    /** Brand profile from questionnaire answers */
+    profile: BrandProfile;
+    /** Output directory path for the guide file */
+    outputDir: string;
+    /** Whether to use LLM to enhance the guide with Do's/Don'ts */
+    useLLM?: boolean;
+}
+/** The 10 onboarding questions defined by the marketing template spec. */
+export declare const ONBOARDING_QUESTIONS: OnboardingQuestion[];
+/** Default content mix ratios for the Brand Voice Guide. */
+export declare const DEFAULT_CONTENT_MIX: {
+    readonly educational: 60;
+    readonly behindTheScenes: 20;
+    readonly promotional: 15;
+    readonly interactive: 5;
+};
+//# sourceMappingURL=brand-onboarding.types.d.ts.map

package/dist/backend/backend/src/services/onboarding/brand-onboarding.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-onboarding.types.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/onboarding/brand-onboarding.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,cAAc,CAAC;IACzC,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wCAAwC;AACxC,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,aAAa,GACb,WAAW,GACX,YAAY,GACZ,MAAM,GACN,QAAQ,CAAC;AAEb,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,+BAA+B;IAC/B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,8CAA8C;IAC9C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mEAAmE;IACnE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mBAAmB;IACnB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,CAAC;IACxD,sBAAsB;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,2CAA2C;IAC3C,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,OAAO,EAAE,YAAY,CAAC;IACtB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD,0EAA0E;AAC1E,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,EAmFpD,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAC"}

package/dist/backend/backend/src/services/onboarding/brand-onboarding.types.js

@@ -0,0 +1,104 @@
+/**
+ * Type definitions for the Brand Onboarding flow.
+ *
+ * The onboarding flow collects brand information from SMB owners
+ * and generates a Brand Voice Guide used by marketing team agents.
+ *
+ * @module brand-onboarding-types
+ */
+// =============================================================================
+// Constants
+// =============================================================================
+/** The 10 onboarding questions defined by the marketing template spec. */
+export const ONBOARDING_QUESTIONS = [
+    {
+        id: 'business_name',
+        text: 'What is your business name?',
+        type: 'text',
+        required: true,
+        placeholder: 'e.g., Sunrise Bakery',
+        order: 1,
+    },
+    {
+        id: 'industry',
+        text: 'What industry are you in?',
+        type: 'text',
+        required: true,
+        placeholder: 'e.g., Fashion, Food, Fitness, Tech, Education',
+        order: 2,
+    },
+    {
+        id: 'description',
+        text: 'Describe your business in one sentence.',
+        type: 'text',
+        required: true,
+        placeholder: 'e.g., We make artisan sourdough bread for health-conscious families.',
+        order: 3,
+    },
+    {
+        id: 'target_customer',
+        text: 'Who is your target customer? (Age, interests, problems they have)',
+        type: 'text',
+        required: true,
+        placeholder: 'e.g., Health-conscious millennials, 25-40, interested in organic food',
+        order: 4,
+    },
+    {
+        id: 'competitors',
+        text: 'What are your top 3 competitors?',
+        type: 'text',
+        required: false,
+        placeholder: 'e.g., Blue Apron, HelloFresh, Local Bakery XYZ',
+        defaultValue: 'Not specified',
+        order: 5,
+    },
+    {
+        id: 'personality',
+        text: 'Describe your brand personality in 3 words.',
+        type: 'text',
+        required: true,
+        placeholder: 'e.g., Professional, Friendly, Bold',
+        order: 6,
+    },
+    {
+        id: 'tone',
+        text: 'What tone should your content have?',
+        type: 'select',
+        options: ['Formal', 'Casual', 'Playful', 'Authoritative'],
+        required: true,
+        order: 7,
+    },
+    {
+        id: 'goals',
+        text: 'What are your marketing goals?',
+        type: 'multi-select',
+        options: ['Brand awareness', 'Lead generation', 'Sales', 'Community building'],
+        required: true,
+        order: 8,
+    },
+    {
+        id: 'platforms',
+        text: 'Which platforms do you use?',
+        type: 'multi-select',
+        options: ['X (Twitter)', 'LinkedIn', 'Instagram', 'Facebook'],
+        required: true,
+        order: 9,
+    },
+    {
+        id: 'content_examples',
+        text: 'Share 2-3 examples of content you like (URLs or descriptions).',
+        type: 'text',
+        required: false,
+        placeholder: 'e.g., https://twitter.com/brand/status/123, "Wendy\'s snarky tone on Twitter"',
+        defaultValue: 'Not specified',
+        order: 10,
+    },
+];
+/** Default content mix ratios for the Brand Voice Guide. */
+export const DEFAULT_CONTENT_MIX = {
+    educational: 60,
+    behindTheScenes: 20,
+    promotional: 15,
+    interactive: 5,
+};
+//# sourceMappingURL=brand-onboarding.types.js.map

package/dist/backend/backend/src/services/onboarding/brand-onboarding.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-onboarding.types.js","sourceRoot":"","sources":["../../../../../../backend/src/services/onboarding/brand-onboarding.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+GH,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,oBAAoB,GAAyB;IACxD;QACE,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,6BAA6B;QACnC,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,sBAAsB;QACnC,KAAK,EAAE,CAAC;KACT;IACD;QACE,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,2BAA2B;QACjC,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,+CAA+C;QAC5D,KAAK,EAAE,CAAC;KACT;IACD;QACE,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,yCAAyC;QAC/C,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,sEAAsE;QACnF,KAAK,EAAE,CAAC;KACT;IACD;QACE,EAAE,EAAE,iBAAiB;QACrB,IAAI,EAAE,mEAAmE;QACzE,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,uEAAuE;QACpF,KAAK,EAAE,CAAC;KACT;IACD;QACE,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,kCAAkC;QACxC,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,gDAAgD;QAC7D,YAAY,EAAE,eAAe;QAC7B,KAAK,EAAE,CAAC;KACT;IACD;QACE,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,6CAA6C;QACnD,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,oCAAoC;QACjD,KAAK,EAAE,CAAC;KACT;IACD;QACE,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,qCAAqC;QAC3C,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,CAAC;QACzD,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,CAAC;KACT;IACD;QACE,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,gCAAgC;QACtC,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,OAAO,EAAE,oBAAoB,CAAC;QAC9E,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,CAAC;KACT;IACD;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,6BAA6B;QACnC,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,CAAC;QAC7D,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,CAAC;KACT;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,IAAI,EAAE,gEAAgE;QACtE,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,+EAA+E;QAC5F,YAAY,EAAE,eAAe;QAC7B,KAAK,EAAE,EAAE;KACV;CACF,CAAC;AAEF,4DAA4D;AAC5D,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,WAAW,EAAE,EAAE;IACf,eAAe,EAAE,EAAE;IACnB,WAAW,EAAE,EAAE;IACf,WAAW,EAAE,CAAC;CACN,CAAC"}

package/dist/backend/backend/src/services/onboarding/content-approval.service.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Content Approval Service for Marketing Team templates.
+ *
+ * Manages the approval workflow where marketing agents submit content
+ * for human review. Content can be approved/rejected via:
+ *   - Slack text replies ("approve" / "reject")
+ *   - REST API endpoints
+ *
+ * This service is designed for the marketing team use case and is
+ * separate from the F27 ToolApprovalQueue (which handles tool execution).
+ *
+ * @module content-approval-service
+ */
+import { ApprovalResolution, ContentApprovalRequest, ContentApprovalStatus, SubmitForApprovalOptions } from './content-approval.types.js';
+/**
+ * Service managing content approval requests for marketing teams.
+ *
+ * Follows singleton pattern. Stores approvals in memory with optional
+ * Slack message tracking for interactive approval via text replies.
+ */
+export declare class ContentApprovalService {
+    private static instance;
+    private approvals;
+    /**
+     * Get or create the singleton instance.
+     *
+     * @returns Singleton instance
+     */
+    static getInstance(): ContentApprovalService;
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance(): void;
+    /**
+     * Submit content for approval.
+     *
+     * @param options - Content submission details
+     * @returns Created approval request
+     * @throws Error if team has too many pending approvals
+     */
+    submit(options: SubmitForApprovalOptions): ContentApprovalRequest;
+    /**
+     * Approve a content request.
+     *
+     * @param approvalId - ID of the approval request
+     * @param resolvedBy - Who approved (user ID or identifier)
+     * @param feedback - Optional feedback or notes
+     * @returns Updated approval request or null if not found
+     */
+    approve(approvalId: string, resolvedBy: string, feedback?: string): ContentApprovalRequest | null;
+    /**
+     * Reject a content request.
+     *
+     * @param approvalId - ID of the approval request
+     * @param resolvedBy - Who rejected
+     * @param feedback - Reason for rejection or edit instructions
+     * @returns Updated approval request or null if not found
+     */
+    reject(approvalId: string, resolvedBy: string, feedback?: string): ContentApprovalRequest | null;
+    /**
+     * Resolve an approval request (approve or reject).
+     *
+     * @param resolution - Resolution details
+     * @returns Updated request or null
+     */
+    resolve(resolution: ApprovalResolution): ContentApprovalRequest | null;
+    /**
+     * Get a specific approval request.
+     *
+     * @param approvalId - Approval ID
+     * @returns The request or null
+     */
+    get(approvalId: string): ContentApprovalRequest | null;
+    /**
+     * Get all pending approvals for a team.
+     *
+     * @param teamId - Team ID
+     * @returns Array of pending approval requests
+     */
+    getPendingByTeam(teamId: string): ContentApprovalRequest[];
+    /**
+     * Get all approvals for a team (all statuses).
+     *
+     * @param teamId - Team ID
+     * @returns Array of all approval requests
+     */
+    getAllByTeam(teamId: string): ContentApprovalRequest[];
+    /**
+     * Get approval by Slack message timestamp (for Slack reply-based approval).
+     *
+     * @param channelId - Slack channel ID
+     * @param messageTs - Slack message timestamp
+     * @returns Matching approval request or null
+     */
+    getBySlackMessage(channelId: string, messageTs: string): ContentApprovalRequest | null;
+    /**
+     * Link a Slack message to an approval request (for tracking replies).
+     *
+     * @param approvalId - Approval ID
+     * @param channelId - Slack channel where the approval message was posted
+     * @param messageTs - Slack message timestamp
+     * @returns Updated request or null
+     */
+    linkSlackMessage(approvalId: string, channelId: string, messageTs: string): ContentApprovalRequest | null;
+    /**
+     * Get counts by status for a team.
+     *
+     * @param teamId - Team ID
+     * @returns Object with status counts
+     */
+    getStats(teamId: string): Record<ContentApprovalStatus, number>;
+    /**
+     * Format an approval request as a Slack message (plain text for MVP).
+     *
+     * @param request - The approval request to format
+     * @returns Formatted message string ready for Slack
+     */
+    formatForSlack(request: ContentApprovalRequest): string;
+    /**
+     * Expire old pending approvals past the TTL.
+     */
+    private expireOldApprovals;
+}
+//# sourceMappingURL=content-approval.service.d.ts.map

package/dist/backend/backend/src/services/onboarding/content-approval.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-approval.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/onboarding/content-approval.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EAGrB,wBAAwB,EACzB,MAAM,6BAA6B,CAAC;AAMrC;;;;;GAKG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuC;IAC9D,OAAO,CAAC,SAAS,CAAkD;IAEnE;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,sBAAsB;IAO5C;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAQ5B;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,EAAE,wBAAwB,GAAG,sBAAsB;IAgCjE;;;;;;;OAOG;IACH,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,sBAAsB,GAAG,IAAI;IAIhC;;;;;;;OAOG;IACH,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,sBAAsB,GAAG,IAAI;IAIhC;;;;;OAKG;IACH,OAAO,CAAC,UAAU,EAAE,kBAAkB,GAAG,sBAAsB,GAAG,IAAI;IAkBtE;;;;;OAKG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAItD;;;;;OAKG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAO1D;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAMtD;;;;;;OAMG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAStF;;;;;;;OAOG;IACH,gBAAgB,CACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,sBAAsB,GAAG,IAAI;IAUhC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC;IAmB/D;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM;IAiCvD;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAa3B"}

package/dist/backend/backend/src/services/onboarding/content-approval.service.js

@@ -0,0 +1,256 @@
+/**
+ * Content Approval Service for Marketing Team templates.
+ *
+ * Manages the approval workflow where marketing agents submit content
+ * for human review. Content can be approved/rejected via:
+ *   - Slack text replies ("approve" / "reject")
+ *   - REST API endpoints
+ *
+ * This service is designed for the marketing team use case and is
+ * separate from the F27 ToolApprovalQueue (which handles tool execution).
+ *
+ * @module content-approval-service
+ */
+import { randomUUID } from 'crypto';
+import { CONTENT_APPROVAL_TTL_MS, MAX_PENDING_APPROVALS, } from './content-approval.types.js';
+// =============================================================================
+// Service
+// =============================================================================
+/**
+ * Service managing content approval requests for marketing teams.
+ *
+ * Follows singleton pattern. Stores approvals in memory with optional
+ * Slack message tracking for interactive approval via text replies.
+ */
+export class ContentApprovalService {
+    static instance = null;
+    approvals = new Map();
+    /**
+     * Get or create the singleton instance.
+     *
+     * @returns Singleton instance
+     */
+    static getInstance() {
+        if (!ContentApprovalService.instance) {
+            ContentApprovalService.instance = new ContentApprovalService();
+        }
+        return ContentApprovalService.instance;
+    }
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance() {
+        ContentApprovalService.instance = null;
+    }
+    // ---------------------------------------------------------------------------
+    // Submission
+    // ---------------------------------------------------------------------------
+    /**
+     * Submit content for approval.
+     *
+     * @param options - Content submission details
+     * @returns Created approval request
+     * @throws Error if team has too many pending approvals
+     */
+    submit(options) {
+        // Enforce max pending limit
+        this.expireOldApprovals();
+        const teamPending = this.getPendingByTeam(options.teamId);
+        if (teamPending.length >= MAX_PENDING_APPROVALS) {
+            throw new Error(`Team ${options.teamId} has ${teamPending.length} pending approvals (max: ${MAX_PENDING_APPROVALS}). Resolve some before submitting more.`);
+        }
+        const request = {
+            id: randomUUID(),
+            teamId: options.teamId,
+            submittedBy: options.submittedBy,
+            platform: options.platform,
+            contentType: options.contentType,
+            content: options.content,
+            hashtags: options.hashtags,
+            visualDirection: options.visualDirection,
+            scheduledTime: options.scheduledTime,
+            status: 'pending',
+            submittedAt: new Date().toISOString(),
+        };
+        this.approvals.set(request.id, request);
+        return request;
+    }
+    // ---------------------------------------------------------------------------
+    // Resolution
+    // ---------------------------------------------------------------------------
+    /**
+     * Approve a content request.
+     *
+     * @param approvalId - ID of the approval request
+     * @param resolvedBy - Who approved (user ID or identifier)
+     * @param feedback - Optional feedback or notes
+     * @returns Updated approval request or null if not found
+     */
+    approve(approvalId, resolvedBy, feedback) {
+        return this.resolve({ approvalId, status: 'approved', resolvedBy, feedback });
+    }
+    /**
+     * Reject a content request.
+     *
+     * @param approvalId - ID of the approval request
+     * @param resolvedBy - Who rejected
+     * @param feedback - Reason for rejection or edit instructions
+     * @returns Updated approval request or null if not found
+     */
+    reject(approvalId, resolvedBy, feedback) {
+        return this.resolve({ approvalId, status: 'rejected', resolvedBy, feedback });
+    }
+    /**
+     * Resolve an approval request (approve or reject).
+     *
+     * @param resolution - Resolution details
+     * @returns Updated request or null
+     */
+    resolve(resolution) {
+        const request = this.approvals.get(resolution.approvalId);
+        if (!request)
+            return null;
+        if (request.status !== 'pending')
+            return request; // Already resolved
+        request.status = resolution.status;
+        request.resolvedAt = new Date().toISOString();
+        request.resolvedBy = resolution.resolvedBy;
+        request.feedback = resolution.feedback;
+        this.approvals.set(request.id, request);
+        return request;
+    }
+    // ---------------------------------------------------------------------------
+    // Queries
+    // ---------------------------------------------------------------------------
+    /**
+     * Get a specific approval request.
+     *
+     * @param approvalId - Approval ID
+     * @returns The request or null
+     */
+    get(approvalId) {
+        return this.approvals.get(approvalId) ?? null;
+    }
+    /**
+     * Get all pending approvals for a team.
+     *
+     * @param teamId - Team ID
+     * @returns Array of pending approval requests
+     */
+    getPendingByTeam(teamId) {
+        this.expireOldApprovals();
+        return Array.from(this.approvals.values()).filter(r => r.teamId === teamId && r.status === 'pending');
+    }
+    /**
+     * Get all approvals for a team (all statuses).
+     *
+     * @param teamId - Team ID
+     * @returns Array of all approval requests
+     */
+    getAllByTeam(teamId) {
+        return Array.from(this.approvals.values()).filter(r => r.teamId === teamId);
+    }
+    /**
+     * Get approval by Slack message timestamp (for Slack reply-based approval).
+     *
+     * @param channelId - Slack channel ID
+     * @param messageTs - Slack message timestamp
+     * @returns Matching approval request or null
+     */
+    getBySlackMessage(channelId, messageTs) {
+        for (const request of this.approvals.values()) {
+            if (request.slackChannelId === channelId && request.slackMessageTs === messageTs) {
+                return request;
+            }
+        }
+        return null;
+    }
+    /**
+     * Link a Slack message to an approval request (for tracking replies).
+     *
+     * @param approvalId - Approval ID
+     * @param channelId - Slack channel where the approval message was posted
+     * @param messageTs - Slack message timestamp
+     * @returns Updated request or null
+     */
+    linkSlackMessage(approvalId, channelId, messageTs) {
+        const request = this.approvals.get(approvalId);
+        if (!request)
+            return null;
+        request.slackChannelId = channelId;
+        request.slackMessageTs = messageTs;
+        this.approvals.set(request.id, request);
+        return request;
+    }
+    /**
+     * Get counts by status for a team.
+     *
+     * @param teamId - Team ID
+     * @returns Object with status counts
+     */
+    getStats(teamId) {
+        const all = this.getAllByTeam(teamId);
+        const stats = {
+            pending: 0,
+            approved: 0,
+            rejected: 0,
+            expired: 0,
+        };
+        for (const r of all) {
+            stats[r.status] = (stats[r.status] || 0) + 1;
+        }
+        return stats;
+    }
+    // ---------------------------------------------------------------------------
+    // Formatting
+    // ---------------------------------------------------------------------------
+    /**
+     * Format an approval request as a Slack message (plain text for MVP).
+     *
+     * @param request - The approval request to format
+     * @returns Formatted message string ready for Slack
+     */
+    formatForSlack(request) {
+        const lines = [
+            `*Content Approval Request* (ID: \`${request.id.slice(0, 8)}\`)`,
+            '',
+            `*Platform:* ${request.platform}`,
+            `*Type:* ${request.contentType}`,
+            `*Submitted by:* ${request.submittedBy}`,
+            '',
+            '---',
+            request.content,
+            '---',
+        ];
+        if (request.hashtags?.length) {
+            lines.push(`*Hashtags:* ${request.hashtags.join(' ')}`);
+        }
+        if (request.visualDirection) {
+            lines.push(`*Visual Direction:* ${request.visualDirection}`);
+        }
+        if (request.scheduledTime) {
+            lines.push(`*Scheduled:* ${request.scheduledTime}`);
+        }
+        lines.push('');
+        lines.push('Reply with *approve* or *reject [reason]* to this message.');
+        return lines.join('\n');
+    }
+    // ---------------------------------------------------------------------------
+    // Private Helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Expire old pending approvals past the TTL.
+     */
+    expireOldApprovals() {
+        const now = Date.now();
+        for (const [id, request] of this.approvals.entries()) {
+            if (request.status === 'pending' &&
+                now - new Date(request.submittedAt).getTime() > CONTENT_APPROVAL_TTL_MS) {
+                request.status = 'expired';
+                request.resolvedAt = new Date().toISOString();
+                this.approvals.set(id, request);
+            }
+        }
+    }
+}
+//# sourceMappingURL=content-approval.service.js.map

package/dist/backend/backend/src/services/onboarding/content-approval.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-approval.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/onboarding/content-approval.service.ts"],"names":[],"mappings":"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"}