@stack0/sdk 0.3.0 → 0.3.1

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 import { Mail } from './mail/index.js';
 export { Attachment, EmailAddress, EmailRecipient, GetEmailResponse, SendEmailRequest, SendEmailResponse, Stack0Error } from './mail/index.js';
 import { CDN } from './cdn/index.js';
-export { Asset, AssetStatus, AssetType, ConfirmUploadRequest, ConfirmUploadResponse, CreateFolderRequest, DeleteAssetRequest, DeleteAssetsRequest, DeleteAssetsResponse, ExtractAudioRequest, ExtractAudioResponse, Folder, FolderTreeNode, GetAssetRequest, GetFolderTreeRequest, GetTransformUrlRequest, GetTransformUrlResponse, ListAssetsRequest, ListAssetsResponse, ListJobsRequest, ListJobsResponse, MoveAssetsRequest, MoveAssetsResponse, StreamingUrls, ThumbnailRequest, ThumbnailResponse, TranscodeJob, TranscodeVideoRequest, TranscodingStatus, TransformOptions, TrimOptions, UpdateAssetRequest, UploadUrlRequest, UploadUrlResponse, VideoCodec, VideoOutputFormat, VideoQuality, VideoVariant, WatermarkOptions } from './cdn/index.js';
+export { Asset, AssetStatus, AssetType, ConfirmUploadRequest, ConfirmUploadResponse, CreateFolderRequest, DeleteAssetRequest, DeleteAssetsRequest, DeleteAssetsResponse, ExtractAudioRequest, ExtractAudioResponse, Folder, FolderTreeNode, GetAssetRequest, GetFolderTreeRequest, ListAssetsRequest, ListAssetsResponse, ListJobsRequest, ListJobsResponse, MoveAssetsRequest, MoveAssetsResponse, StreamingUrls, ThumbnailRequest, ThumbnailResponse, TranscodeJob, TranscodeVideoRequest, TranscodingStatus, TransformOptions, TrimOptions, UpdateAssetRequest, UploadUrlRequest, UploadUrlResponse, VideoCodec, VideoOutputFormat, VideoQuality, VideoVariant, WatermarkOptions } from './cdn/index.js';
 import { Screenshots } from './screenshots/index.js';
 export { BatchScreenshotJob, Clip, CreateBatchScreenshotsRequest, CreateScreenshotRequest, CreateScreenshotResponse, CreateScreenshotScheduleRequest, DeviceType, GetScreenshotRequest, ListScreenshotsRequest, ListScreenshotsResponse, ResourceType, Screenshot, ScreenshotBatchJobsResponse, ScreenshotFormat, ScreenshotSchedule, ScreenshotSchedulesResponse, ScreenshotStatus, UpdateScreenshotScheduleRequest } from './screenshots/index.js';
 import { Extraction } from './extraction/index.js';
 export { BatchExtractionJob, CreateBatchExtractionsRequest, CreateExtractionRequest, CreateExtractionResponse, CreateExtractionScheduleRequest, ExtractionBatchJobsResponse, ExtractionMode, ExtractionResult, ExtractionSchedule, ExtractionSchedulesResponse, ExtractionStatus, ExtractionUsage, GetExtractionRequest, GetUsageRequest, ListExtractionsRequest, ListExtractionsResponse, PageMetadata, UpdateExtractionScheduleRequest } from './extraction/index.js';
 import { Webdata } from './webdata/index.js';
-import { H as HttpClient, a as HttpClientConfig } from './http-client-DjrRWvXA.js';
+import { H as HttpClient, a as HttpClientConfig } from './http-client-Cgie_Rv6.js';
 export { B as BatchJobStatus, C as CreateBatchResponse, c as CreateScheduleResponse, E as Environment, G as GetBatchJobRequest, a as GetScheduleRequest, L as ListBatchJobsRequest, b as ListSchedulesRequest, S as ScheduleFrequency } from './shared-types-B0PyC7cF.js';
 
 /**
@@ -531,6 +531,466 @@ declare class Integrations {
     passthrough(request: PassthroughRequest): Promise<unknown>;
 }
 
+/**
+ * Marketing SDK Types
+ */
+type MarketingEnvironment = "sandbox" | "production";
+type ContentStatus = "draft" | "pending_review" | "approved" | "rejected" | "publishing" | "published" | "failed" | "archived";
+type TrendStatus = "discovered" | "analyzing" | "active" | "declining" | "expired";
+type ContentType = "tiktok_slideshow" | "instagram_reel" | "youtube_short" | "blog_post" | "twitter_thread";
+type ApprovalStatus = "pending" | "approved" | "rejected";
+interface Trend {
+    id: string;
+    organizationId: string;
+    projectId: string;
+    environment: MarketingEnvironment;
+    keyword: string;
+    source: string;
+    category?: string | null;
+    searchVolume?: number | null;
+    growthRate?: number | null;
+    trendScore: number;
+    status: TrendStatus;
+    sourceData?: Record<string, unknown> | null;
+    firstSeenAt: Date;
+    lastUpdatedAt: Date;
+    expiresAt?: Date | null;
+    createdAt: Date;
+}
+interface DiscoverTrendsRequest {
+    projectSlug: string;
+    environment: MarketingEnvironment;
+}
+interface DiscoverTrendsResponse {
+    success: boolean;
+    trendsDiscovered: number;
+    trends: Trend[];
+}
+interface ListTrendsRequest {
+    projectSlug: string;
+    environment: MarketingEnvironment;
+    status?: TrendStatus;
+    limit?: number;
+}
+type ListTrendsResponse = Trend[];
+interface Opportunity {
+    id: string;
+    organizationId: string;
+    projectId: string;
+    environment: MarketingEnvironment;
+    title: string;
+    description?: string | null;
+    contentType: ContentType;
+    opportunityScore: number;
+    estimatedViews?: number | null;
+    confidenceLevel?: number | null;
+    trendIds?: string[] | null;
+    reasoning?: string | null;
+    suggestedAngle?: string | null;
+    targetAudience?: string | null;
+    contentId?: string | null;
+    status: string;
+    usedAt?: Date | null;
+    createdAt: Date;
+    expiresAt?: Date | null;
+}
+interface GenerateOpportunitiesRequest {
+    projectSlug: string;
+    environment: MarketingEnvironment;
+}
+interface GenerateOpportunitiesResponse {
+    success: boolean;
+    opportunitiesGenerated: number;
+    opportunities: Opportunity[];
+}
+interface ListOpportunitiesRequest {
+    projectSlug: string;
+    environment: MarketingEnvironment;
+    status?: string;
+    limit?: number;
+}
+type ListOpportunitiesResponse = Opportunity[];
+interface DismissOpportunityRequest {
+    opportunityId: string;
+}
+interface Content {
+    id: string;
+    organizationId: string;
+    projectId: string;
+    environment: MarketingEnvironment;
+    contentType: ContentType;
+    title: string;
+    description?: string | null;
+    opportunityId?: string | null;
+    scriptId?: string | null;
+    assetUrls?: {
+        slides?: string[];
+        video?: string;
+        thumbnail?: string;
+        captions?: string;
+    } | null;
+    duration?: number | null;
+    slideCount?: number | null;
+    fileSize?: number | null;
+    platformData?: Record<string, unknown> | null;
+    status: ContentStatus;
+    approvalStatus: ApprovalStatus;
+    reviewedByUserId?: string | null;
+    reviewedAt?: Date | null;
+    reviewNotes?: string | null;
+    publishedAt?: Date | null;
+    publishedUrl?: string | null;
+    views?: number | null;
+    likes?: number | null;
+    shares?: number | null;
+    comments?: number | null;
+    creditsUsed?: number | null;
+    createdAt: Date;
+    updatedAt?: Date | null;
+}
+interface CreateContentRequest {
+    projectSlug: string;
+    environment: MarketingEnvironment;
+    contentType: ContentType;
+    title: string;
+    description?: string;
+    opportunityId?: string;
+    scriptId?: string;
+}
+interface ListContentRequest {
+    projectSlug: string;
+    environment: MarketingEnvironment;
+    status?: ContentStatus;
+    contentType?: ContentType;
+    approvalStatus?: ApprovalStatus;
+    limit?: number;
+    offset?: number;
+}
+type ListContentResponse = Content[];
+interface UpdateContentRequest {
+    contentId: string;
+    title?: string;
+    description?: string;
+    status?: ContentStatus;
+    assetUrls?: {
+        slides?: string[];
+        video?: string;
+        thumbnail?: string;
+        captions?: string;
+    };
+    platformData?: Record<string, unknown>;
+    publishedUrl?: string;
+}
+interface ApproveContentRequest {
+    contentId: string;
+    reviewNotes?: string;
+}
+interface RejectContentRequest {
+    contentId: string;
+    reviewNotes: string;
+}
+interface ScriptSlide {
+    order: number;
+    text: string;
+    voiceoverText: string;
+    duration: number;
+    visualStyle?: string;
+}
+interface Script {
+    id: string;
+    organizationId: string;
+    projectId: string;
+    environment: MarketingEnvironment;
+    contentId?: string | null;
+    hook: string;
+    slides: ScriptSlide[];
+    cta: string;
+    prompt?: string | null;
+    model?: string | null;
+    tokensUsed?: number | null;
+    generationTimeMs?: number | null;
+    version: number;
+    previousVersionId?: string | null;
+    createdAt: Date;
+}
+interface CreateScriptRequest {
+    projectSlug: string;
+    environment: MarketingEnvironment;
+    contentId?: string;
+    hook: string;
+    slides: ScriptSlide[];
+    cta: string;
+    prompt?: string;
+    model?: string;
+    tokensUsed?: number;
+    generationTimeMs?: number;
+}
+interface ListScriptsRequest {
+    projectSlug: string;
+    environment: MarketingEnvironment;
+    contentId?: string;
+    limit?: number;
+}
+type ListScriptsResponse = Script[];
+interface AnalyticsOverviewRequest {
+    projectSlug: string;
+    environment: MarketingEnvironment;
+    startDate?: Date;
+    endDate?: Date;
+}
+interface AnalyticsOverviewResponse {
+    totalContent: number;
+    publishedContent: number;
+    draftContent: number;
+    engagement: {
+        views: number;
+        likes: number;
+        shares: number;
+        comments: number;
+    };
+    contentByType: Array<{
+        contentType: ContentType;
+        count: number;
+    }>;
+    contentByStatus: Array<{
+        status: ContentStatus;
+        count: number;
+    }>;
+}
+interface ContentPerformanceRequest {
+    projectSlug: string;
+    environment: MarketingEnvironment;
+    contentType?: ContentType;
+    limit?: number;
+}
+interface ContentPerformanceItem {
+    id: string;
+    title: string;
+    contentType: ContentType;
+    views: number | null;
+    likes: number | null;
+    shares: number | null;
+    comments: number | null;
+    publishedAt: Date | null;
+    engagementRate: number;
+}
+type ContentPerformanceResponse = ContentPerformanceItem[];
+
+/**
+ * Stack0 Marketing Client
+ * Discover trends, generate content opportunities, and manage marketing content
+ */
+
+declare class Marketing {
+    private http;
+    constructor(config: HttpClientConfig);
+    /**
+     * Discover new trends from all sources
+     *
+     * @example
+     * ```typescript
+     * const { trendsDiscovered, trends } = await marketing.discoverTrends({
+     *   projectSlug: 'my-project',
+     *   environment: 'production',
+     * });
+     * console.log(`Discovered ${trendsDiscovered} new trends`);
+     * ```
+     */
+    discoverTrends(request: DiscoverTrendsRequest): Promise<DiscoverTrendsResponse>;
+    /**
+     * List trends for a project
+     *
+     * @example
+     * ```typescript
+     * const trends = await marketing.listTrends({
+     *   projectSlug: 'my-project',
+     *   environment: 'production',
+     *   limit: 20,
+     * });
+     * ```
+     */
+    listTrends(request: ListTrendsRequest): Promise<Trend[]>;
+    /**
+     * Get a single trend by ID
+     */
+    getTrend(trendId: string): Promise<Trend>;
+    /**
+     * Generate content opportunities from active trends
+     *
+     * @example
+     * ```typescript
+     * const { opportunitiesGenerated, opportunities } = await marketing.generateOpportunities({
+     *   projectSlug: 'my-project',
+     *   environment: 'production',
+     * });
+     * console.log(`Generated ${opportunitiesGenerated} new content ideas`);
+     * ```
+     */
+    generateOpportunities(request: GenerateOpportunitiesRequest): Promise<GenerateOpportunitiesResponse>;
+    /**
+     * List opportunities for a project
+     *
+     * @example
+     * ```typescript
+     * const opportunities = await marketing.listOpportunities({
+     *   projectSlug: 'my-project',
+     *   environment: 'production',
+     *   status: 'pending',
+     *   limit: 20,
+     * });
+     * ```
+     */
+    listOpportunities(request: ListOpportunitiesRequest): Promise<Opportunity[]>;
+    /**
+     * Get a single opportunity by ID
+     */
+    getOpportunity(opportunityId: string): Promise<Opportunity>;
+    /**
+     * Dismiss an opportunity
+     *
+     * @example
+     * ```typescript
+     * await marketing.dismissOpportunity({ opportunityId: 'opp-id' });
+     * ```
+     */
+    dismissOpportunity(request: DismissOpportunityRequest): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Create new marketing content
+     *
+     * @example
+     * ```typescript
+     * const content = await marketing.createContent({
+     *   projectSlug: 'my-project',
+     *   environment: 'production',
+     *   contentType: 'tiktok_slideshow',
+     *   title: 'How AI is Changing Marketing',
+     *   opportunityId: 'opp-id',
+     * });
+     * ```
+     */
+    createContent(request: CreateContentRequest): Promise<Content>;
+    /**
+     * List content with filters
+     *
+     * @example
+     * ```typescript
+     * const content = await marketing.listContent({
+     *   projectSlug: 'my-project',
+     *   environment: 'production',
+     *   status: 'published',
+     *   limit: 20,
+     * });
+     * ```
+     */
+    listContent(request: ListContentRequest): Promise<Content[]>;
+    /**
+     * Get a single content by ID
+     */
+    getContent(contentId: string): Promise<Content>;
+    /**
+     * Update content
+     *
+     * @example
+     * ```typescript
+     * const updated = await marketing.updateContent({
+     *   contentId: 'content-id',
+     *   title: 'Updated Title',
+     *   status: 'published',
+     * });
+     * ```
+     */
+    updateContent(request: UpdateContentRequest): Promise<Content>;
+    /**
+     * Approve content for publishing
+     *
+     * @example
+     * ```typescript
+     * await marketing.approveContent({
+     *   contentId: 'content-id',
+     *   reviewNotes: 'Looks great!',
+     * });
+     * ```
+     */
+    approveContent(request: ApproveContentRequest): Promise<Content>;
+    /**
+     * Reject content
+     *
+     * @example
+     * ```typescript
+     * await marketing.rejectContent({
+     *   contentId: 'content-id',
+     *   reviewNotes: 'Needs revisions',
+     * });
+     * ```
+     */
+    rejectContent(request: RejectContentRequest): Promise<Content>;
+    /**
+     * Delete content
+     */
+    deleteContent(contentId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Create a new script
+     *
+     * @example
+     * ```typescript
+     * const script = await marketing.createScript({
+     *   projectSlug: 'my-project',
+     *   environment: 'production',
+     *   hook: 'Are you ready to see the future?',
+     *   slides: [
+     *     { order: 0, text: 'AI is changing everything', voiceoverText: 'AI is transforming how we work', duration: 3 },
+     *   ],
+     *   cta: 'Follow for more insights!',
+     * });
+     * ```
+     */
+    createScript(request: CreateScriptRequest): Promise<Script>;
+    /**
+     * List scripts
+     */
+    listScripts(request: ListScriptsRequest): Promise<Script[]>;
+    /**
+     * Get a single script by ID
+     */
+    getScript(scriptId: string): Promise<Script>;
+    /**
+     * Get analytics overview
+     *
+     * @example
+     * ```typescript
+     * const analytics = await marketing.getAnalyticsOverview({
+     *   projectSlug: 'my-project',
+     *   environment: 'production',
+     * });
+     * console.log(`Total content: ${analytics.totalContent}`);
+     * console.log(`Total views: ${analytics.engagement.views}`);
+     * ```
+     */
+    getAnalyticsOverview(request: AnalyticsOverviewRequest): Promise<AnalyticsOverviewResponse>;
+    /**
+     * Get content performance metrics
+     *
+     * @example
+     * ```typescript
+     * const topContent = await marketing.getContentPerformance({
+     *   projectSlug: 'my-project',
+     *   environment: 'production',
+     *   contentType: 'tiktok_slideshow',
+     *   limit: 10,
+     * });
+     * ```
+     */
+    getContentPerformance(request: ContentPerformanceRequest): Promise<ContentPerformanceResponse>;
+    private convertTrendDates;
+    private convertOpportunityDates;
+    private convertContentDates;
+    private convertScriptDates;
+}
+
 /**
  * Stack0 SDK
  * Official SDK for Stack0 services
@@ -578,12 +1038,23 @@ declare class Integrations {
  *   channelId: 'C123',
  *   content: 'Hello from Stack0!',
  * });
+ *
+ * // Discover trends and generate content ideas
+ * const { trendsDiscovered, trends } = await stack0.marketing.discoverTrends({
+ *   projectSlug: 'my-project',
+ *   environment: 'production',
+ * });
  * ```
  */
 
 interface Stack0Config extends HttpClientConfig {
     apiKey: string;
     baseUrl?: string;
+    /**
+     * CDN base URL for image transformations (e.g., 'https://cdn.yourproject.stack0.dev')
+     * When provided, transform URLs are generated client-side without API calls
+     */
+    cdnUrl?: string;
 }
 /**
  * Main Stack0 SDK class
@@ -595,6 +1066,7 @@ declare class Stack0 {
     screenshots: Screenshots;
     extraction: Extraction;
     integrations: Integrations;
+    marketing: Marketing;
     /**
      * @deprecated Use `screenshots` and `extraction` instead. Will be removed in a future version.
      */
@@ -602,4 +1074,4 @@ declare class Stack0 {
     constructor(config: Stack0Config);
 }
 
-export { CDN, type Channel, type CommunicationUser, type Company, type Connection, type Connector, type ConnectorCategory, type Contact, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type Deal, Extraction, type Address as IntegrationAddress, type ColumnType as IntegrationColumnType, type CreateDocumentInput as IntegrationCreateDocumentInput, type CreateFolderInput as IntegrationCreateFolderInput, type CreateTableRowInput as IntegrationCreateTableRowInput, type Document as IntegrationDocument, type IntegrationEmailAddress, type File as IntegrationFile, type FilePermission as IntegrationFilePermission, type IntegrationFolder, type MessageAttachment as IntegrationMessageAttachment, type MessageReaction as IntegrationMessageReaction, type PhoneNumber as IntegrationPhoneNumber, type SelectOption as IntegrationSelectOption, type Table as IntegrationTable, type TableColumn as IntegrationTableColumn, type TableRow as IntegrationTableRow, type UpdateDocumentInput as IntegrationUpdateDocumentInput, type UpdateTableRowInput as IntegrationUpdateTableRowInput, Integrations, type ListOptions as IntegrationsListOptions, type PaginatedResult as IntegrationsPaginatedResult, Mail, type Message, type PassthroughRequest, Screenshots, type SendMessageInput, Stack0, type Stack0Config, type UpdateCompanyInput, type UpdateContactInput, type UpdateDealInput, type UploadFileInput, Webdata, Stack0 as default };
+export { type AnalyticsOverviewRequest, type AnalyticsOverviewResponse, type ApprovalStatus, type ApproveContentRequest, CDN, type Channel, type CommunicationUser, type Company, type Connection, type Connector, type ConnectorCategory, type Contact, type Content, type ContentPerformanceItem, type ContentPerformanceRequest, type ContentPerformanceResponse, type ContentStatus, type ContentType, type CreateCompanyInput, type CreateContactInput, type CreateContentRequest, type CreateDealInput, type CreateScriptRequest, type Deal, type DiscoverTrendsRequest, type DiscoverTrendsResponse, type DismissOpportunityRequest, Extraction, type GenerateOpportunitiesRequest, type GenerateOpportunitiesResponse, type Address as IntegrationAddress, type ColumnType as IntegrationColumnType, type CreateDocumentInput as IntegrationCreateDocumentInput, type CreateFolderInput as IntegrationCreateFolderInput, type CreateTableRowInput as IntegrationCreateTableRowInput, type Document as IntegrationDocument, type IntegrationEmailAddress, type File as IntegrationFile, type FilePermission as IntegrationFilePermission, type IntegrationFolder, type MessageAttachment as IntegrationMessageAttachment, type MessageReaction as IntegrationMessageReaction, type PhoneNumber as IntegrationPhoneNumber, type SelectOption as IntegrationSelectOption, type Table as IntegrationTable, type TableColumn as IntegrationTableColumn, type TableRow as IntegrationTableRow, type UpdateDocumentInput as IntegrationUpdateDocumentInput, type UpdateTableRowInput as IntegrationUpdateTableRowInput, Integrations, type ListOptions as IntegrationsListOptions, type PaginatedResult as IntegrationsPaginatedResult, type ListContentRequest, type ListContentResponse, type ListOpportunitiesRequest, type ListOpportunitiesResponse, type ListScriptsRequest, type ListScriptsResponse, type ListTrendsRequest, type ListTrendsResponse, Mail, Marketing, type MarketingEnvironment, type Message, type Opportunity, type PassthroughRequest, type RejectContentRequest, Screenshots, type Script, type ScriptSlide, type SendMessageInput, Stack0, type Stack0Config, type Trend, type TrendStatus, type UpdateCompanyInput, type UpdateContactInput, type UpdateContentRequest, type UpdateDealInput, type UploadFileInput, Webdata, Stack0 as default };