perspectapi-ts-sdk 1.3.1 → 1.4.0

package/dist/index.d.mts

@@ -5,7 +5,8 @@ interface ApiResponse<T = any> {
     data?: T;
     message?: string;
     error?: string;
-    success?: boolean;
+    success: boolean;
+    code?: string;
 }
 interface PaginationParams {
     page?: number;
@@ -141,6 +142,8 @@ interface NewsletterPreferences {
     track_clicks?: boolean;
 }
 interface NewsletterStatusResponse {
+    success: boolean;
+    code?: string;
     subscribed: boolean;
     status: string;
     frequency?: string;
@@ -148,12 +151,17 @@ interface NewsletterStatusResponse {
     confirmed_at?: string;
 }
 interface NewsletterSubscribeResponse {
+    success: boolean;
+    code: string;
     message: string;
     status: string;
     subscription_id?: string;
 }
 interface NewsletterConfirmResponse {
+    success: boolean;
+    code: string;
     message: string;
+    status?: string;
     subscription?: {
         email: string;
         name?: string;
@@ -165,6 +173,12 @@ interface NewsletterUnsubscribeRequest {
     email?: string;
     reason?: string;
 }
+interface NewsletterUnsubscribeResponse {
+    success: boolean;
+    code: string;
+    message: string;
+    status?: string;
+}
 type ContentStatus = 'draft' | 'publish' | 'private' | 'trash';
 type ContentType = 'post' | 'page';
 interface Content {
@@ -374,6 +388,22 @@ interface CreateContactRequest {
     subject?: string;
     message: string;
 }
+interface ContactSubmitResponse {
+    success: boolean;
+    code: string;
+    contact_id: string;
+    message: string;
+    status: string;
+}
+interface ContactStatusResponse {
+    success: boolean;
+    code: string;
+    contact_id: string;
+    status: string;
+    submitted_at: string;
+    processed_at?: string;
+    metadata?: Record<string, any>;
+}
 interface ApiError {
     message: string;
     code?: string;
@@ -1460,20 +1490,11 @@ declare class ContactClient extends BaseClient {
      * @param data - Contact form data
      * @param csrfToken - CSRF token (required for browser-based submissions)
      */
-    submitContact(siteName: string, data: CreateContactRequest, csrfToken?: string): Promise<ApiResponse<{
-        id: string;
-        message: string;
-        status: string;
-    }>>;
+    submitContact(siteName: string, data: CreateContactRequest, csrfToken?: string): Promise<ApiResponse<ContactSubmitResponse>>;
     /**
      * Get contact submission status
      */
-    getContactStatus(siteName: string, id: string): Promise<ApiResponse<{
-        id: string;
-        status: string;
-        submittedAt: string;
-        processedAt?: string;
-    }>>;
+    getContactStatus(siteName: string, id: string): Promise<ApiResponse<ContactStatusResponse>>;
     /**
      * Get all contact submissions (admin only)
      */
@@ -1627,9 +1648,7 @@ declare class NewsletterClient extends BaseClient {
      * @param data - Unsubscribe data
      * @param csrfToken - CSRF token (required for browser-based submissions)
      */
-    unsubscribe(siteName: string, data: NewsletterUnsubscribeRequest, csrfToken?: string): Promise<ApiResponse<{
-        message: string;
-    }>>;
+    unsubscribe(siteName: string, data: NewsletterUnsubscribeRequest, csrfToken?: string): Promise<ApiResponse<NewsletterUnsubscribeResponse>>;
     /**
      * One-click unsubscribe via token (GET request)
      */
@@ -2038,4 +2057,4 @@ declare function createCheckoutSession(options: CheckoutSessionOptions): Promise
     error: string;
 }>;
 
-export { type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, type AuthResponse, BaseClient, type BlogPost, CategoriesClient, type Category, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, ContactClient, type ContactSubmission, type Content, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreateProductRequest, type CreateSiteRequest, type CreateWebhookRequest, HttpClient, type HttpMethod, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, NewsletterClient, type NewsletterConfirmResponse, type NewsletterList, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterUnsubscribeRequest, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, PerspectApiClient, type PerspectApiConfig, type Product, type ProductQueryParams, ProductsClient, type RequestOptions, type SignInRequest, type SignUpRequest, type Site, SitesClient, type UpdateApiKeyRequest, type UpdateContentRequest, type User, type Webhook, WebhooksClient, createApiError, createCheckoutSession, createPerspectApiClient, PerspectApiClient as default, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformProduct };
+export { type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, type AuthResponse, BaseClient, type BlogPost, CategoriesClient, type Category, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, ContactClient, type ContactStatusResponse, type ContactSubmission, type ContactSubmitResponse, type Content, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreateProductRequest, type CreateSiteRequest, type CreateWebhookRequest, HttpClient, type HttpMethod, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, NewsletterClient, type NewsletterConfirmResponse, type NewsletterList, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterUnsubscribeRequest, type NewsletterUnsubscribeResponse, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, PerspectApiClient, type PerspectApiConfig, type Product, type ProductQueryParams, ProductsClient, type RequestOptions, type SignInRequest, type SignUpRequest, type Site, SitesClient, type UpdateApiKeyRequest, type UpdateContentRequest, type User, type Webhook, WebhooksClient, createApiError, createCheckoutSession, createPerspectApiClient, PerspectApiClient as default, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformProduct };

package/dist/index.d.ts

@@ -5,7 +5,8 @@ interface ApiResponse<T = any> {
     data?: T;
     message?: string;
     error?: string;
-    success?: boolean;
+    success: boolean;
+    code?: string;
 }
 interface PaginationParams {
     page?: number;
@@ -141,6 +142,8 @@ interface NewsletterPreferences {
     track_clicks?: boolean;
 }
 interface NewsletterStatusResponse {
+    success: boolean;
+    code?: string;
     subscribed: boolean;
     status: string;
     frequency?: string;
@@ -148,12 +151,17 @@ interface NewsletterStatusResponse {
     confirmed_at?: string;
 }
 interface NewsletterSubscribeResponse {
+    success: boolean;
+    code: string;
     message: string;
     status: string;
     subscription_id?: string;
 }
 interface NewsletterConfirmResponse {
+    success: boolean;
+    code: string;
     message: string;
+    status?: string;
     subscription?: {
         email: string;
         name?: string;
@@ -165,6 +173,12 @@ interface NewsletterUnsubscribeRequest {
     email?: string;
     reason?: string;
 }
+interface NewsletterUnsubscribeResponse {
+    success: boolean;
+    code: string;
+    message: string;
+    status?: string;
+}
 type ContentStatus = 'draft' | 'publish' | 'private' | 'trash';
 type ContentType = 'post' | 'page';
 interface Content {
@@ -374,6 +388,22 @@ interface CreateContactRequest {
     subject?: string;
     message: string;
 }
+interface ContactSubmitResponse {
+    success: boolean;
+    code: string;
+    contact_id: string;
+    message: string;
+    status: string;
+}
+interface ContactStatusResponse {
+    success: boolean;
+    code: string;
+    contact_id: string;
+    status: string;
+    submitted_at: string;
+    processed_at?: string;
+    metadata?: Record<string, any>;
+}
 interface ApiError {
     message: string;
     code?: string;
@@ -1460,20 +1490,11 @@ declare class ContactClient extends BaseClient {
      * @param data - Contact form data
      * @param csrfToken - CSRF token (required for browser-based submissions)
      */
-    submitContact(siteName: string, data: CreateContactRequest, csrfToken?: string): Promise<ApiResponse<{
-        id: string;
-        message: string;
-        status: string;
-    }>>;
+    submitContact(siteName: string, data: CreateContactRequest, csrfToken?: string): Promise<ApiResponse<ContactSubmitResponse>>;
     /**
      * Get contact submission status
      */
-    getContactStatus(siteName: string, id: string): Promise<ApiResponse<{
-        id: string;
-        status: string;
-        submittedAt: string;
-        processedAt?: string;
-    }>>;
+    getContactStatus(siteName: string, id: string): Promise<ApiResponse<ContactStatusResponse>>;
     /**
      * Get all contact submissions (admin only)
      */
@@ -1627,9 +1648,7 @@ declare class NewsletterClient extends BaseClient {
      * @param data - Unsubscribe data
      * @param csrfToken - CSRF token (required for browser-based submissions)
      */
-    unsubscribe(siteName: string, data: NewsletterUnsubscribeRequest, csrfToken?: string): Promise<ApiResponse<{
-        message: string;
-    }>>;
+    unsubscribe(siteName: string, data: NewsletterUnsubscribeRequest, csrfToken?: string): Promise<ApiResponse<NewsletterUnsubscribeResponse>>;
     /**
      * One-click unsubscribe via token (GET request)
      */
@@ -2038,4 +2057,4 @@ declare function createCheckoutSession(options: CheckoutSessionOptions): Promise
     error: string;
 }>;
 
-export { type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, type AuthResponse, BaseClient, type BlogPost, CategoriesClient, type Category, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, ContactClient, type ContactSubmission, type Content, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreateProductRequest, type CreateSiteRequest, type CreateWebhookRequest, HttpClient, type HttpMethod, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, NewsletterClient, type NewsletterConfirmResponse, type NewsletterList, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterUnsubscribeRequest, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, PerspectApiClient, type PerspectApiConfig, type Product, type ProductQueryParams, ProductsClient, type RequestOptions, type SignInRequest, type SignUpRequest, type Site, SitesClient, type UpdateApiKeyRequest, type UpdateContentRequest, type User, type Webhook, WebhooksClient, createApiError, createCheckoutSession, createPerspectApiClient, PerspectApiClient as default, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformProduct };
+export { type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, type AuthResponse, BaseClient, type BlogPost, CategoriesClient, type Category, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, ContactClient, type ContactStatusResponse, type ContactSubmission, type ContactSubmitResponse, type Content, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreateProductRequest, type CreateSiteRequest, type CreateWebhookRequest, HttpClient, type HttpMethod, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, NewsletterClient, type NewsletterConfirmResponse, type NewsletterList, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterUnsubscribeRequest, type NewsletterUnsubscribeResponse, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, PerspectApiClient, type PerspectApiConfig, type Product, type ProductQueryParams, ProductsClient, type RequestOptions, type SignInRequest, type SignUpRequest, type Site, SitesClient, type UpdateApiKeyRequest, type UpdateContentRequest, type User, type Webhook, WebhooksClient, createApiError, createCheckoutSession, createPerspectApiClient, PerspectApiClient as default, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformProduct };

package/dist/index.js

@@ -1195,7 +1195,11 @@ var ContactClient = class extends BaseClient {
     if (typeof window !== "undefined" && !csrfToken) {
       console.warn("CSRF token recommended for browser-based contact form submissions");
     }
-    return this.create(this.contactEndpoint(siteName, "/contact/submit"), data, csrfToken);
+    return this.create(
+      this.contactEndpoint(siteName, "/contact/submit"),
+      data,
+      csrfToken
+    );
   }
   /**
    * Get contact submission status

package/dist/index.mjs

@@ -1144,7 +1144,11 @@ var ContactClient = class extends BaseClient {
     if (typeof window !== "undefined" && !csrfToken) {
       console.warn("CSRF token recommended for browser-based contact form submissions");
     }
-    return this.create(this.contactEndpoint(siteName, "/contact/submit"), data, csrfToken);
+    return this.create(
+      this.contactEndpoint(siteName, "/contact/submit"),
+      data,
+      csrfToken
+    );
   }
   /**
    * Get contact submission status

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perspectapi-ts-sdk",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "TypeScript SDK for PerspectAPI - Cloudflare Workers compatible",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/client/contact-client.ts

@@ -6,6 +6,8 @@ import { BaseClient } from './base-client';
 import type {
   ContactSubmission,
   CreateContactRequest,
+  ContactSubmitResponse,
+  ContactStatusResponse,
   PaginatedResponse,
   ApiResponse,
 } from '../types';
@@ -32,32 +34,23 @@ export class ContactClient extends BaseClient {
     siteName: string, 
     data: CreateContactRequest,
     csrfToken?: string
-  ): Promise<ApiResponse<{
-    id: string;
-    message: string;
-    status: string;
-  }>> {
+  ): Promise<ApiResponse<ContactSubmitResponse>> {
     // CSRF token is required for browser submissions
     if (typeof window !== 'undefined' && !csrfToken) {
       console.warn('CSRF token recommended for browser-based contact form submissions');
     }
     
-    return this.create<CreateContactRequest, {
-      id: string;
-      message: string;
-      status: string;
-    }>(this.contactEndpoint(siteName, '/contact/submit'), data, csrfToken);
+    return this.create<CreateContactRequest, ContactSubmitResponse>(
+      this.contactEndpoint(siteName, '/contact/submit'), 
+      data, 
+      csrfToken
+    );
   }
 
   /**
    * Get contact submission status
    */
-  async getContactStatus(siteName: string, id: string): Promise<ApiResponse<{
-    id: string;
-    status: string;
-    submittedAt: string;
-    processedAt?: string;
-  }>> {
+  async getContactStatus(siteName: string, id: string): Promise<ApiResponse<ContactStatusResponse>> {
     return this.getSingle(this.contactEndpoint(siteName, `/contact/status/${encodeURIComponent(id)}`));
   }
 

package/src/client/newsletter-client.ts

@@ -12,6 +12,7 @@ import type {
   NewsletterSubscribeResponse,
   NewsletterConfirmResponse,
   NewsletterUnsubscribeRequest,
+  NewsletterUnsubscribeResponse,
   PaginatedResponse,
   ApiResponse,
 } from '../types';
@@ -73,8 +74,8 @@ export class NewsletterClient extends BaseClient {
     siteName: string,
     data: NewsletterUnsubscribeRequest,
     csrfToken?: string
-  ): Promise<ApiResponse<{ message: string }>> {
-    return this.create<NewsletterUnsubscribeRequest, { message: string }>(
+  ): Promise<ApiResponse<NewsletterUnsubscribeResponse>> {
+    return this.create<NewsletterUnsubscribeRequest, NewsletterUnsubscribeResponse>(
       this.newsletterEndpoint(siteName, '/newsletter/unsubscribe'),
       data,
       csrfToken

package/src/index.ts

@@ -80,4 +80,7 @@ export type {
   NewsletterSubscribeResponse,
   NewsletterConfirmResponse,
   NewsletterUnsubscribeRequest,
+  NewsletterUnsubscribeResponse,
+  ContactSubmitResponse,
+  ContactStatusResponse,
 } from './types';

package/src/types/index.ts

@@ -7,7 +7,8 @@ export interface ApiResponse<T = any> {
   data?: T;
   message?: string;
   error?: string;
-  success?: boolean;
+  success: boolean;
+  code?: string;
 }
 
 // Pagination
@@ -167,6 +168,8 @@ export interface NewsletterPreferences {
 }
 
 export interface NewsletterStatusResponse {
+  success: boolean;
+  code?: string;
   subscribed: boolean;
   status: string;
   frequency?: string;
@@ -175,13 +178,18 @@ export interface NewsletterStatusResponse {
 }
 
 export interface NewsletterSubscribeResponse {
+  success: boolean;
+  code: string;
   message: string;
   status: string;
   subscription_id?: string;
 }
 
 export interface NewsletterConfirmResponse {
+  success: boolean;
+  code: string;
   message: string;
+  status?: string;
   subscription?: {
     email: string;
     name?: string;
@@ -195,6 +203,13 @@ export interface NewsletterUnsubscribeRequest {
   reason?: string;
 }
 
+export interface NewsletterUnsubscribeResponse {
+  success: boolean;
+  code: string;
+  message: string;
+  status?: string;
+}
+
 // Content Management
 export type ContentStatus = 'draft' | 'publish' | 'private' | 'trash';
 export type ContentType = 'post' | 'page';
@@ -443,6 +458,24 @@ export interface CreateContactRequest {
   message: string;
 }
 
+export interface ContactSubmitResponse {
+  success: boolean;
+  code: string;
+  contact_id: string;
+  message: string;
+  status: string;
+}
+
+export interface ContactStatusResponse {
+  success: boolean;
+  code: string;
+  contact_id: string;
+  status: string;
+  submitted_at: string;
+  processed_at?: string;
+  metadata?: Record<string, any>;
+}
+
 // Error Types
 export interface ApiError {
   message: string;