@stack0/sdk 0.5.3 → 0.5.4

package/dist/index.mjs

@@ -2492,6 +2492,28 @@ var Extraction = class {
     const response = await this.http.get(`/webdata/usage${query ? `?${query}` : ""}`);
     return this.convertUsageDates(response);
   }
+  /**
+   * Get daily usage breakdown
+   *
+   * @example
+   * ```typescript
+   * const { days } = await extraction.getUsageDaily({
+   *   periodStart: '2024-01-01T00:00:00Z',
+   *   periodEnd: '2024-01-31T23:59:59Z',
+   * });
+   * days.forEach(day => {
+   *   console.log(`${day.date}: ${day.screenshots} screenshots, ${day.extractions} extractions`);
+   * });
+   * ```
+   */
+  async getUsageDaily(request = {}) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.periodStart) params.set("periodStart", request.periodStart);
+    if (request.periodEnd) params.set("periodEnd", request.periodEnd);
+    const query = params.toString();
+    return this.http.get(`/webdata/usage/daily${query ? `?${query}` : ""}`);
+  }
   // ==========================================================================
   // HELPERS
   // ==========================================================================
@@ -3424,41 +3446,150 @@ var Integrations = class {
   // ============================================================================
   /**
    * List all connections
+   *
+   * @example
+   * ```typescript
+   * const { connections } = await integrations.listConnections({
+   *   environment: 'production',
+   *   status: 'connected',
+   * });
+   * ```
    */
-  async listConnections(options) {
+  async listConnections(request) {
     const params = new URLSearchParams();
-    if (options?.connectorId) params.set("connectorId", options.connectorId);
-    if (options?.status) params.set("status", options.status);
+    if (request?.projectId) params.set("projectId", request.projectId);
+    if (request?.environment) params.set("environment", request.environment);
+    if (request?.connectorSlug) params.set("connectorSlug", request.connectorSlug);
+    if (request?.status) params.set("status", request.status);
+    if (request?.limit) params.set("limit", request.limit.toString());
     const queryString = params.toString();
-    return this.http.get(`/integrations/connections${queryString ? `?${queryString}` : ""}`);
+    const response = await this.http.get(
+      `/integrations/connections${queryString ? `?${queryString}` : ""}`
+    );
+    return {
+      ...response,
+      connections: response.connections.map((c) => this.convertConnectionDates(c))
+    };
   }
   /**
    * Get a specific connection
    */
-  async getConnection(id) {
-    return this.http.get(`/integrations/connections/${id}`);
+  async getConnection(connectionId) {
+    const response = await this.http.get(`/integrations/connections/${connectionId}`);
+    return this.convertConnectionDetailsDates(response);
   }
   /**
-   * Create a new connection (initiates OAuth flow)
-   * Returns the OAuth authorization URL to redirect the user to
+   * Initiate OAuth flow for a connector
+   *
+   * @example
+   * ```typescript
+   * const { authUrl, connectionId, state } = await integrations.initiateOAuth({
+   *   connectorSlug: 'hubspot',
+   *   redirectUrl: 'https://yourapp.com/oauth/callback',
+   *   name: 'My HubSpot Connection',
+   * });
+   * // Redirect user to authUrl
+   * ```
    */
-  async createConnection(connectorSlug, options) {
-    return this.http.post("/integrations/connections", {
-      connectorSlug,
-      ...options
-    });
+  async initiateOAuth(request) {
+    return this.http.post("/integrations/connections/oauth/initiate", request);
+  }
+  /**
+   * Complete OAuth flow with callback data
+   *
+   * @example
+   * ```typescript
+   * const result = await integrations.completeOAuth({
+   *   code: 'auth_code_from_callback',
+   *   state: 'state_from_initiate',
+   *   redirectUrl: 'https://yourapp.com/oauth/callback',
+   * });
+   * console.log(`Connected to: ${result.externalAccountName}`);
+   * ```
+   */
+  async completeOAuth(request) {
+    return this.http.post("/integrations/connections/oauth/callback", request);
+  }
+  /**
+   * Update a connection
+   */
+  async updateConnection(request) {
+    const { connectionId, ...data } = request;
+    return this.http.patch(`/integrations/connections/${connectionId}`, data);
   }
   /**
    * Delete a connection
    */
-  async deleteConnection(id) {
-    return this.http.delete(`/integrations/connections/${id}`);
+  async deleteConnection(connectionId) {
+    return this.http.delete(`/integrations/connections/${connectionId}`);
   }
   /**
-   * Test a connection's credentials
+   * Reconnect an expired or errored connection
+   *
+   * @example
+   * ```typescript
+   * const { authUrl, state } = await integrations.reconnectConnection({
+   *   connectionId: 'conn_123',
+   *   redirectUrl: 'https://yourapp.com/oauth/callback',
+   * });
+   * // Redirect user to authUrl
+   * ```
+   */
+  async reconnectConnection(request) {
+    return this.http.post(
+      `/integrations/connections/${request.connectionId}/reconnect`,
+      { redirectUrl: request.redirectUrl }
+    );
+  }
+  /**
+   * Get integration statistics
+   *
+   * @example
+   * ```typescript
+   * const stats = await integrations.getStats({ environment: 'production' });
+   * console.log(`Active connections: ${stats.activeConnections}`);
+   * console.log(`API calls last 30 days: ${stats.apiCallsLast30Days}`);
+   * ```
+   */
+  async getStats(request) {
+    const params = new URLSearchParams();
+    if (request?.environment) params.set("environment", request.environment);
+    const queryString = params.toString();
+    return this.http.get(
+      `/integrations/connections/stats${queryString ? `?${queryString}` : ""}`
+    );
+  }
+  // ============================================================================
+  // LOGS
+  // ============================================================================
+  /**
+   * List API logs
+   *
+   * @example
+   * ```typescript
+   * const { logs } = await integrations.listLogs({
+   *   connectionId: 'conn_123',
+   *   limit: 50,
+   * });
+   * ```
    */
-  async testConnection(id) {
-    return this.http.post(`/integrations/connections/${id}/test`, {});
+  async listLogs(request) {
+    const params = new URLSearchParams();
+    if (request?.connectionId) params.set("connectionId", request.connectionId);
+    if (request?.connectorSlug) params.set("connectorSlug", request.connectorSlug);
+    if (request?.statusCode) params.set("statusCode", request.statusCode.toString());
+    if (request?.method) params.set("method", request.method);
+    if (request?.search) params.set("search", request.search);
+    if (request?.limit) params.set("limit", request.limit.toString());
+    if (request?.cursor) params.set("cursor", request.cursor);
+    const queryString = params.toString();
+    const response = await this.http.get(
+      `/integrations/logs${queryString ? `?${queryString}` : ""}`
+    );
+    return {
+      ...response,
+      logs: response.logs.map((log) => this.convertLogDates(log))
+    };
   }
   // ============================================================================
   // PASSTHROUGH
@@ -3469,6 +3600,45 @@ var Integrations = class {
   async passthrough(request) {
     return this.http.post("/integrations/passthrough", request);
   }
+  // ============================================================================
+  // Date Conversion Helpers
+  // ============================================================================
+  convertConnectionDates(connection) {
+    if (connection.connectedAt && typeof connection.connectedAt === "string") {
+      connection.connectedAt = new Date(connection.connectedAt);
+    }
+    if (connection.lastUsedAt && typeof connection.lastUsedAt === "string") {
+      connection.lastUsedAt = new Date(connection.lastUsedAt);
+    }
+    if (connection.createdAt && typeof connection.createdAt === "string") {
+      connection.createdAt = new Date(connection.createdAt);
+    }
+    return connection;
+  }
+  convertConnectionDetailsDates(connection) {
+    if (connection.connectedAt && typeof connection.connectedAt === "string") {
+      connection.connectedAt = new Date(connection.connectedAt);
+    }
+    if (connection.lastUsedAt && typeof connection.lastUsedAt === "string") {
+      connection.lastUsedAt = new Date(connection.lastUsedAt);
+    }
+    if (connection.lastErrorAt && typeof connection.lastErrorAt === "string") {
+      connection.lastErrorAt = new Date(connection.lastErrorAt);
+    }
+    if (connection.createdAt && typeof connection.createdAt === "string") {
+      connection.createdAt = new Date(connection.createdAt);
+    }
+    if (connection.updatedAt && typeof connection.updatedAt === "string") {
+      connection.updatedAt = new Date(connection.updatedAt);
+    }
+    return connection;
+  }
+  convertLogDates(log) {
+    if (typeof log.createdAt === "string") {
+      log.createdAt = new Date(log.createdAt);
+    }
+    return log;
+  }
 };
 
 // src/marketing/client.ts
@@ -3524,6 +3694,22 @@ var Marketing = class {
     const response = await this.http.get(`/marketing/trends/${trendId}`);
     return this.convertTrendDates(response);
   }
+  /**
+   * Update trend status
+   *
+   * @example
+   * ```typescript
+   * await marketing.updateTrendStatus({
+   *   trendId: 'trend-id',
+   *   status: 'active',
+   * });
+   * ```
+   */
+  async updateTrendStatus(request) {
+    return this.http.patch(`/marketing/trends/${request.trendId}/status`, {
+      status: request.status
+    });
+  }
   // ============================================================================
   // Opportunities
   // ============================================================================
@@ -3732,6 +3918,54 @@ var Marketing = class {
     const response = await this.http.get(`/marketing/scripts/${scriptId}`);
     return this.convertScriptDates(response);
   }
+  /**
+   * Update a script
+   *
+   * @example
+   * ```typescript
+   * const updated = await marketing.updateScript({
+   *   scriptId: 'script-id',
+   *   hook: 'Updated hook line',
+   *   cta: 'New call to action!',
+   * });
+   * ```
+   */
+  async updateScript(request) {
+    const { scriptId, ...data } = request;
+    const response = await this.http.patch(`/marketing/scripts/${scriptId}`, data);
+    return this.convertScriptDates(response);
+  }
+  /**
+   * Create a new version of a script
+   *
+   * @example
+   * ```typescript
+   * const newVersion = await marketing.createScriptVersion({
+   *   scriptId: 'script-id',
+   *   hook: 'Updated hook for v2',
+   *   slides: [...],
+   *   cta: 'Updated CTA',
+   * });
+   * ```
+   */
+  async createScriptVersion(request) {
+    const { scriptId, ...data } = request;
+    const response = await this.http.post(`/marketing/scripts/${scriptId}/versions`, data);
+    return this.convertScriptDates(response);
+  }
+  /**
+   * Get all versions of a script
+   */
+  async getScriptVersions(scriptId) {
+    const response = await this.http.get(`/marketing/scripts/${scriptId}/versions`);
+    return response.map((s) => this.convertScriptDates(s));
+  }
+  /**
+   * Delete a script
+   */
+  async deleteScript(scriptId) {
+    return this.http.delete(`/marketing/scripts/${scriptId}`);
+  }
   // ============================================================================
   // Analytics
   // ============================================================================
@@ -3779,6 +4013,318 @@ var Marketing = class {
     });
     return this.http.get(`/marketing/analytics/performance?${params.toString()}`);
   }
+  /**
+   * Get trend discovery analytics
+   *
+   * @example
+   * ```typescript
+   * const trendStats = await marketing.getTrendAnalytics({
+   *   projectSlug: 'my-project',
+   *   environment: 'production',
+   * });
+   * console.log(`Total trends: ${trendStats.totalTrends}`);
+   * ```
+   */
+  async getTrendAnalytics(request) {
+    const params = new URLSearchParams({
+      projectSlug: request.projectSlug,
+      ...request.environment && { environment: request.environment },
+      ...request.startDate && { startDate: request.startDate.toISOString() },
+      ...request.endDate && { endDate: request.endDate.toISOString() }
+    });
+    return this.http.get(`/marketing/analytics/trends?${params.toString()}`);
+  }
+  /**
+   * Get opportunity conversion analytics
+   *
+   * @example
+   * ```typescript
+   * const conversion = await marketing.getOpportunityConversion({
+   *   projectSlug: 'my-project',
+   *   environment: 'production',
+   * });
+   * console.log(`Conversion rate: ${conversion.conversionRate}%`);
+   * ```
+   */
+  async getOpportunityConversion(request) {
+    const params = new URLSearchParams({
+      projectSlug: request.projectSlug,
+      ...request.environment && { environment: request.environment },
+      ...request.startDate && { startDate: request.startDate.toISOString() },
+      ...request.endDate && { endDate: request.endDate.toISOString() }
+    });
+    return this.http.get(`/marketing/analytics/conversion?${params.toString()}`);
+  }
+  // ============================================================================
+  // Calendar
+  // ============================================================================
+  /**
+   * Schedule content for publishing
+   *
+   * @example
+   * ```typescript
+   * const entry = await marketing.scheduleContent({
+   *   projectSlug: 'my-project',
+   *   contentId: 'content-id',
+   *   scheduledFor: new Date('2024-12-25T10:00:00Z'),
+   *   autoPublish: true,
+   * });
+   * ```
+   */
+  async scheduleContent(request) {
+    const response = await this.http.post("/marketing/calendar/schedule", {
+      ...request,
+      scheduledFor: request.scheduledFor.toISOString()
+    });
+    return this.convertCalendarEntryDates(response);
+  }
+  /**
+   * List scheduled content
+   *
+   * @example
+   * ```typescript
+   * const entries = await marketing.listCalendarEntries({
+   *   projectSlug: 'my-project',
+   *   startDate: new Date('2024-12-01'),
+   *   endDate: new Date('2024-12-31'),
+   * });
+   * ```
+   */
+  async listCalendarEntries(request) {
+    const params = new URLSearchParams({
+      projectSlug: request.projectSlug,
+      ...request.environment && { environment: request.environment },
+      ...request.startDate && { startDate: request.startDate.toISOString() },
+      ...request.endDate && { endDate: request.endDate.toISOString() },
+      ...request.limit && { limit: request.limit.toString() },
+      ...request.offset && { offset: request.offset.toString() }
+    });
+    const response = await this.http.get(`/marketing/calendar?${params.toString()}`);
+    return response.map((e) => this.convertCalendarEntryDates(e));
+  }
+  /**
+   * Get a single calendar entry by ID
+   */
+  async getCalendarEntry(entryId) {
+    const response = await this.http.get(`/marketing/calendar/${entryId}`);
+    return this.convertCalendarEntryDates(response);
+  }
+  /**
+   * Update a calendar entry
+   *
+   * @example
+   * ```typescript
+   * const updated = await marketing.updateCalendarEntry({
+   *   entryId: 'entry-id',
+   *   scheduledFor: new Date('2024-12-26T10:00:00Z'),
+   * });
+   * ```
+   */
+  async updateCalendarEntry(request) {
+    const { entryId, ...data } = request;
+    const response = await this.http.patch(`/marketing/calendar/${entryId}`, {
+      ...data,
+      ...data.scheduledFor && { scheduledFor: data.scheduledFor.toISOString() }
+    });
+    return this.convertCalendarEntryDates(response);
+  }
+  /**
+   * Cancel a scheduled calendar entry
+   */
+  async cancelCalendarEntry(entryId) {
+    return this.http.post(`/marketing/calendar/${entryId}/cancel`, {});
+  }
+  /**
+   * Mark content as published
+   */
+  async markContentPublished(request) {
+    const response = await this.http.post(`/marketing/calendar/${request.entryId}/published`, {
+      ...request.publishedAt && { publishedAt: request.publishedAt.toISOString() }
+    });
+    return this.convertCalendarEntryDates(response);
+  }
+  // ============================================================================
+  // Assets (Asset Jobs)
+  // ============================================================================
+  /**
+   * Create an asset generation job
+   *
+   * @example
+   * ```typescript
+   * const job = await marketing.createAssetJob({
+   *   projectSlug: 'my-project',
+   *   contentId: 'content-id',
+   *   jobType: 'slide_generation',
+   *   input: { style: 'modern' },
+   * });
+   * ```
+   */
+  async createAssetJob(request) {
+    const response = await this.http.post("/marketing/assets/jobs", request);
+    return this.convertAssetJobDates(response);
+  }
+  /**
+   * List asset jobs
+   *
+   * @example
+   * ```typescript
+   * const jobs = await marketing.listAssetJobs({
+   *   projectSlug: 'my-project',
+   *   status: 'processing',
+   * });
+   * ```
+   */
+  async listAssetJobs(request) {
+    const params = new URLSearchParams({
+      projectSlug: request.projectSlug,
+      ...request.contentId && { contentId: request.contentId },
+      ...request.status && { status: request.status },
+      ...request.jobType && { jobType: request.jobType },
+      ...request.limit && { limit: request.limit.toString() },
+      ...request.offset && { offset: request.offset.toString() }
+    });
+    const response = await this.http.get(`/marketing/assets/jobs?${params.toString()}`);
+    return response.map((j) => this.convertAssetJobDates(j));
+  }
+  /**
+   * Get an asset job by ID
+   */
+  async getAssetJob(jobId) {
+    const response = await this.http.get(`/marketing/assets/jobs/${jobId}`);
+    return this.convertAssetJobDates(response);
+  }
+  /**
+   * Update asset job status
+   */
+  async updateAssetJobStatus(request) {
+    const { jobId, ...data } = request;
+    const response = await this.http.patch(`/marketing/assets/jobs/${jobId}/status`, data);
+    return this.convertAssetJobDates(response);
+  }
+  /**
+   * Retry a failed asset job
+   */
+  async retryAssetJob(jobId) {
+    const response = await this.http.post(`/marketing/assets/jobs/${jobId}/retry`, {});
+    return this.convertAssetJobDates(response);
+  }
+  /**
+   * Cancel an asset job
+   */
+  async cancelAssetJob(jobId) {
+    const response = await this.http.post(`/marketing/assets/jobs/${jobId}/cancel`, {});
+    return this.convertAssetJobDates(response);
+  }
+  // ============================================================================
+  // Settings
+  // ============================================================================
+  /**
+   * Get marketing settings for a project
+   *
+   * @example
+   * ```typescript
+   * const settings = await marketing.getSettings({
+   *   projectSlug: 'my-project',
+   *   environment: 'production',
+   * });
+   * console.log(`Brand voice: ${settings.brandVoice}`);
+   * ```
+   */
+  async getSettings(request) {
+    const params = new URLSearchParams({
+      projectSlug: request.projectSlug,
+      ...request.environment && { environment: request.environment }
+    });
+    return this.http.get(`/marketing/settings?${params.toString()}`);
+  }
+  /**
+   * Update marketing settings
+   *
+   * @example
+   * ```typescript
+   * await marketing.updateSettings({
+   *   projectSlug: 'my-project',
+   *   brandVoice: 'Professional yet approachable',
+   *   monitoredKeywords: ['AI', 'startup', 'tech'],
+   * });
+   * ```
+   */
+  async updateSettings(request) {
+    return this.http.post("/marketing/settings", request);
+  }
+  // ============================================================================
+  // Usage
+  // ============================================================================
+  /**
+   * Get current period usage
+   *
+   * @example
+   * ```typescript
+   * const usage = await marketing.getCurrentUsage({
+   *   projectSlug: 'my-project',
+   *   environment: 'production',
+   * });
+   * console.log(`AI tokens used: ${usage.aiTokensUsed}`);
+   * ```
+   */
+  async getCurrentUsage(request) {
+    const params = new URLSearchParams({
+      projectSlug: request.projectSlug,
+      ...request.environment && { environment: request.environment }
+    });
+    const response = await this.http.get(`/marketing/usage/current?${params.toString()}`);
+    return this.convertUsageDates(response);
+  }
+  /**
+   * Get usage history
+   *
+   * @example
+   * ```typescript
+   * const history = await marketing.getUsageHistory({
+   *   projectSlug: 'my-project',
+   *   limit: 6, // Last 6 months
+   * });
+   * ```
+   */
+  async getUsageHistory(request) {
+    const params = new URLSearchParams({
+      projectSlug: request.projectSlug,
+      ...request.environment && { environment: request.environment },
+      ...request.startDate && { startDate: request.startDate.toISOString() },
+      ...request.endDate && { endDate: request.endDate.toISOString() },
+      ...request.limit && { limit: request.limit.toString() }
+    });
+    const response = await this.http.get(`/marketing/usage/history?${params.toString()}`);
+    return response.map((u) => this.convertMarketingUsageDates(u));
+  }
+  /**
+   * Get total usage across all periods
+   *
+   * @example
+   * ```typescript
+   * const totals = await marketing.getTotalUsage({
+   *   projectSlug: 'my-project',
+   *   startDate: new Date('2024-01-01'),
+   * });
+   * console.log(`Total content generated: ${totals.contentGenerated}`);
+   * ```
+   */
+  async getTotalUsage(request) {
+    const params = new URLSearchParams({
+      projectSlug: request.projectSlug,
+      ...request.environment && { environment: request.environment },
+      ...request.startDate && { startDate: request.startDate.toISOString() },
+      ...request.endDate && { endDate: request.endDate.toISOString() }
+    });
+    return this.http.get(`/marketing/usage/total?${params.toString()}`);
+  }
+  /**
+   * Record usage (typically called internally)
+   */
+  async recordUsage(request) {
+    const response = await this.http.post("/marketing/usage/record", request);
+    return this.convertMarketingUsageDates(response);
+  }
   // ============================================================================
   // Date Conversion Helpers
   // ============================================================================
@@ -3830,6 +4376,57 @@ var Marketing = class {
     }
     return script;
   }
+  convertCalendarEntryDates(entry) {
+    if (typeof entry.scheduledFor === "string") {
+      entry.scheduledFor = new Date(entry.scheduledFor);
+    }
+    if (typeof entry.createdAt === "string") {
+      entry.createdAt = new Date(entry.createdAt);
+    }
+    if (entry.updatedAt && typeof entry.updatedAt === "string") {
+      entry.updatedAt = new Date(entry.updatedAt);
+    }
+    if (entry.publishedAt && typeof entry.publishedAt === "string") {
+      entry.publishedAt = new Date(entry.publishedAt);
+    }
+    return entry;
+  }
+  convertAssetJobDates(job) {
+    if (typeof job.createdAt === "string") {
+      job.createdAt = new Date(job.createdAt);
+    }
+    if (job.startedAt && typeof job.startedAt === "string") {
+      job.startedAt = new Date(job.startedAt);
+    }
+    if (job.completedAt && typeof job.completedAt === "string") {
+      job.completedAt = new Date(job.completedAt);
+    }
+    return job;
+  }
+  convertUsageDates(usage) {
+    if (typeof usage.periodStart === "string") {
+      usage.periodStart = new Date(usage.periodStart);
+    }
+    if (typeof usage.periodEnd === "string") {
+      usage.periodEnd = new Date(usage.periodEnd);
+    }
+    return usage;
+  }
+  convertMarketingUsageDates(usage) {
+    if (typeof usage.periodStart === "string") {
+      usage.periodStart = new Date(usage.periodStart);
+    }
+    if (typeof usage.periodEnd === "string") {
+      usage.periodEnd = new Date(usage.periodEnd);
+    }
+    if (typeof usage.createdAt === "string") {
+      usage.createdAt = new Date(usage.createdAt);
+    }
+    if (usage.updatedAt && typeof usage.updatedAt === "string") {
+      usage.updatedAt = new Date(usage.updatedAt);
+    }
+    return usage;
+  }
 };
 
 // src/index.ts