@joai/sdk 4.5.0 → 4.7.0

package/dist/index.d.mts

@@ -16,6 +16,7 @@ interface IHttpService {
   onUnauthorized: (response: IAppResponse<any>) => void;
   onSuccessfulResponse: (response: IAppResponse<any>) => void;
   onMaintenanceMode: (response: IAppResponse<any>) => void;
+  onTooManyRequests: (response: IAppResponse<any>) => void;
   get: <T>(url: string, options?: IRequestOptions) => Promise<IAppResponse<T>>;
   post: <T>(url: string, data?: any, options?: IRequestOptions) => Promise<IAppResponse<T>>;
   put: <T>(url: string, data?: any, options?: IRequestOptions) => Promise<IAppResponse<T>>;
@@ -394,6 +395,37 @@ type ContactFormData = {
 type ContactCreatePayload = ContactFormData & {
   name: string;
   wallets?: WalletList;
+};
+type ContactRelationType = 'parent_of' | 'child_of' | 'spouse_of' | 'sibling_of' | 'aunt_of' | 'nibling_of' | 'manages' | 'reports_to' | 'colleague_of' | 'partner_of' | 'client_of' | 'supplier_of' | 'referred_by' | 'referred';
+type ContactRelationCategory = 'family' | 'organization' | 'business' | 'referral';
+type ContactRelationDirection = 'outgoing' | 'incoming';
+type ContactRelationContact = {
+  id: string;
+  name: string;
+  avatar: string | null;
+  company: string | null;
+  title: string | null;
+};
+type ContactRelation = {
+  id: string;
+  type: ContactRelationType;
+  category: ContactRelationCategory;
+  direction: ContactRelationDirection;
+  contact: ContactRelationContact;
+  meta: Record<string, JsonValue> | null;
+  notes: string | null;
+  createdAt: string;
+};
+type ContactRelationPayload = {
+  relatedContactId: string;
+  type: ContactRelationType;
+  notes?: string;
+  meta?: Record<string, JsonValue>;
+};
+type ContactRelationUpdatePayload = {
+  type?: ContactRelationType;
+  notes?: string;
+  meta?: Record<string, JsonValue>;
 }; //#endregion
 //#region src/media/types.d.ts
 type MediaLibraryAttributes = {
@@ -996,9 +1028,12 @@ type Order = {
   justCreated?: boolean;
   createdAt: string;
   invoiceDate: string;
+  serviceDate: string;
   meta: Record<string, JsonValue> | null;
   contactId: string | null;
   contact?: Contact | null;
+  invoiceContactId?: string | null;
+  invoiceContact?: Contact | null;
   source: OrderSource | null;
   context: OrderContext | null;
   paymentMode: string | null;
@@ -1014,6 +1049,7 @@ type Order = {
   } | null;
   shippingFee?: number;
   fulfillments?: Fulfillment[];
+  returns?: Return[];
   subscription?: Subscription | null;
   configuration?: OrderConfigurationItem[];
   items: OrderItem[];
@@ -1098,7 +1134,7 @@ type Skill = {
   screenshots: string[];
 }; //#endregion
 //#region src/integration/types.d.ts
-type IntegrationType = 'none' | 'webhook' | 'api-token' | 'telegram' | 'slack' | 'whatsapp' | 'whatsapp-personal' | 'twilio' | 'sms' | 'n8n' | 'apple-health' | 'mcp' | 'x' | 'xchat' | 'instagram' | 'grok' | 'email' | 'calendar' | 'embed' | 'discord' | 'github' | 'push' | 'sentry' | 'readwise';
+type IntegrationType = 'none' | 'webhook' | 'api-token' | 'telegram' | 'slack' | 'whatsapp' | 'whatsapp-personal' | 'twilio' | 'sms' | 'n8n' | 'apple-health' | 'mcp' | 'x' | 'xchat' | 'instagram' | 'grok' | 'cloudflare' | 'email' | 'calendar' | 'embed' | 'discord' | 'github' | 'push' | 'sentry' | 'readwise';
 type IntegrationDetails = {
   type: IntegrationType;
   name: string;
@@ -1634,6 +1670,12 @@ type ArtifactLink = {
   url: string;
   label?: string | null;
 };
+type ArtifactBlockType = 'heading' | 'richText' | 'metrics' | 'table' | 'callout' | 'actions' | 'media' | 'divider';
+type ArtifactBlock = {
+  id: string;
+  type: ArtifactBlockType;
+  data: Record<string, unknown>;
+};
 type ArtifactContactSummary = {
   id: string;
   name: string | null;
@@ -1646,9 +1688,11 @@ type Artifact = {
   status: ArtifactStatus;
   title: string;
   summary: string | null;
+  blocks: ArtifactBlock[] | null;
   url: string | null;
   password: string | null;
   links: ArtifactLink[];
+  media: Media[];
   meta: Record<string, unknown> | null;
   contactId: string | null;
   orderId: string | null;
@@ -1662,22 +1706,27 @@ type ArtifactCreatePayload = {
   type: ArtifactType;
   status?: ArtifactStatus;
   summary?: string;
+  blocks?: ArtifactBlock[];
   url?: string;
   password?: string;
   links?: ArtifactLink[];
   extraLinkUrl?: string;
   extraLinkLabel?: string;
+  media?: string[];
   meta?: Record<string, unknown>;
   contactId?: string;
   orderId?: string;
 };
-type ArtifactUpdatePayload = Partial<ArtifactCreatePayload>;
+type ArtifactUpdatePayload = Omit<Partial<ArtifactCreatePayload>, 'blocks'> & {
+  blocks?: ArtifactBlock[] | null;
+};
 type ArtifactDeliverPayload = {
   artifactIds: string[];
   message: string;
   integration: ArtifactDeliverIntegration;
   subject?: string;
   contactIds?: string[];
+  agentId?: string;
 };
 type ArtifactDelivery = {
   id: string;
@@ -1849,6 +1898,88 @@ type AppointmentRequest = {
   configuration?: Configuration;
   createdAt: string;
 }; //#endregion
+//#region src/automation/types.d.ts
+type AutomationTriggerType = 'prop' | 'segment' | 'manual';
+type AutomationActionType = 'wait' | 'send_email' | 'halt';
+type AutomationSendMode = 'direct' | 'campaign';
+type AutomationEnrollmentStatus = 'active' | 'completed' | 'skipped';
+type AutomationSkipReason = 'pending_consent' | 'opted_out' | 'missing_channel' | 'automation_disabled' | 'already_completed';
+type AutomationTriggerConfig = {
+  propKey?: string;
+  propValue?: string | number | boolean;
+  segmentId?: string;
+};
+type AutomationActionConfig = {
+  delayMinutes?: number;
+  sendMode?: AutomationSendMode;
+  campaignId?: string;
+  subject?: string;
+  body?: string;
+  contentHtml?: boolean;
+  sentPropKey?: string;
+  [key: string]: unknown;
+};
+type AutomationAction = {
+  id: string;
+  position: number;
+  type: AutomationActionType;
+  config: AutomationActionConfig;
+};
+type Automation = {
+  id: string;
+  name: string;
+  triggerType: AutomationTriggerType;
+  triggerConfig: AutomationTriggerConfig;
+  enabled: boolean;
+  agent: AgentSimple | null;
+  actions?: AutomationAction[];
+  createdAt: string;
+  updatedAt: string;
+};
+type AutomationEnrollment = {
+  id: string;
+  automationId: string;
+  contactId: string | null;
+  contact?: {
+    id: string;
+    name: string | null;
+    email: string | null;
+  };
+  status: AutomationEnrollmentStatus;
+  currentPosition: number;
+  enteredAt: string | null;
+  eligibleAt: string | null;
+  sentAt: string | null;
+  completedAt: string | null;
+  skippedAt: string | null;
+  skipReason: AutomationSkipReason | null;
+  error: string | null;
+  createdAt: string;
+  updatedAt: string;
+};
+type AutomationActionInput = {
+  type: AutomationActionType;
+  config?: AutomationActionConfig;
+};
+type AutomationCreatePayload = {
+  name: string;
+  triggerType: AutomationTriggerType;
+  triggerConfig?: AutomationTriggerConfig;
+  actions?: AutomationActionInput[];
+  enabled?: boolean;
+  agentId?: string;
+};
+type AutomationUpdatePayload = {
+  name?: string;
+  triggerType?: AutomationTriggerType;
+  triggerConfig?: AutomationTriggerConfig;
+  enabled?: boolean;
+  agentId?: string | null;
+};
+type AutomationAudiencePreview = {
+  count: number;
+  sampleContactIds: string[];
+}; //#endregion
 //#region src/content/types.d.ts
 type ContentStatus = 'draft' | 'published' | 'archived';
 type ContentFieldType = 'text' | 'richText' | 'number' | 'boolean' | 'url' | 'image' | 'media' | 'list' | 'object' | 'reference';
@@ -2227,6 +2358,20 @@ type McpToolCall = {
   createdAt: string;
 };
 //#endregion
+//#region src/metric/types.d.ts
+type MetricSource = 'cloudflare';
+type Metric = {
+  key: string;
+  value: number;
+  unit: string;
+};
+type MetricsResult = {
+  source: MetricSource;
+  resource: string;
+  from: string;
+  to: string;
+  metrics: Metric[];
+}; //#endregion
 //#region src/memory/types.d.ts
 type Memory = {
   id: string;
@@ -2729,9 +2874,14 @@ type SiteAgent = {
 };
 type Site = {
   id: number;
-  brandSlug: string;
+  slug: string;
+  brandSlug: string | null;
   customDomain: string | null;
   enabled: boolean;
+  contactId?: string | null;
+  metricsSource?: string | null;
+  metricsResource?: string | null;
+  monthlyReport?: boolean;
   team: SiteTeam | null;
   agent: SiteAgent | null;
   settings: Record<string, JsonValue>;
@@ -2920,7 +3070,7 @@ type LoyaltyMember = {
   updatedAt: string;
 }; //#endregion
 //#region src/segment/types.d.ts
-type SegmentConditionType = 'tag' | 'has_email' | 'has_phone' | 'has_user' | 'last_purchase_after' | 'last_purchase_before' | 'total_order_amount' | 'order_count_at_least' | 'never_purchased' | 'avg_order_value_at_least' | 'last_contact_after' | 'last_contact_before' | 'waiting_on' | 'created_after' | 'created_before' | 'email_contains';
+type SegmentConditionType = 'tag' | 'has_email' | 'has_phone' | 'has_user' | 'last_purchase_after' | 'last_purchase_before' | 'total_order_amount' | 'order_count_at_least' | 'never_purchased' | 'avg_order_value_at_least' | 'last_contact_after' | 'last_contact_before' | 'waiting_on' | 'created_after' | 'created_before' | 'email_contains' | 'prop' | 'marketing_opt_out';
 type SegmentCondition = {
   type: SegmentConditionType;
   value: string | boolean;
@@ -2952,10 +3102,24 @@ type SegmentCountResult = {
 }; //#endregion
 //#region src/campaign/types.d.ts
 type CampaignChannel = 'email' | 'whatsapp' | 'sms' | 'push';
-type CampaignStatus = 'draft' | 'pending' | 'approved' | 'rejected' | 'sending' | 'completed' | 'failed';
+type CampaignStatus = 'draft' | 'pending' | 'approved' | 'rejected' | 'scheduled' | 'sending' | 'completed' | 'failed';
 type CampaignCategory = 'MARKETING' | 'UTILITY' | 'AUTHENTICATION';
 type CampaignSkipReason = 'pending_consent' | 'opted_out' | 'missing_channel' | 'approval_skipped';
 type CampaignSkipReasons = Record<CampaignSkipReason, number>;
+type CampaignRecipientStatus = 'sent' | 'failed' | 'skipped' | 'pending';
+type CampaignRecipient = {
+  id: string;
+  name: string | null;
+  email: string | null;
+  phone: string | null;
+  status: CampaignRecipientStatus;
+  error: string | null;
+  skipReason: CampaignSkipReason | null;
+  retryable: boolean;
+  sentAt: string | null;
+  openedAt: string | null;
+  clickedAt: string | null;
+};
 type CampaignAudiencePreview = {
   total: number;
   sendable: number;
@@ -2977,9 +3141,15 @@ type Campaign = {
   channel: CampaignChannel;
   subject: string | null;
   content: string;
+  contentHtml?: boolean;
+  scheduledAt?: string | null;
+  openedCount?: number;
+  clickedCount?: number;
   approval: CampaignApproval;
   agent: AgentSimple | null;
   tags: string[];
+  segmentId?: string | null;
+  contactIds?: string[];
   status: CampaignStatus;
   totalCount: number;
   remainingCount: number;
@@ -2996,6 +3166,7 @@ type CampaignCreatePayload = {
   channel: CampaignChannel;
   subject?: string;
   content: string;
+  contentHtml?: boolean;
   language?: string;
   category?: CampaignCategory;
   templateParams?: Record<string, string>;
@@ -3009,11 +3180,15 @@ type CampaignUpdatePayload = {
   name: string;
   subject?: string;
   content: string;
+  contentHtml?: boolean;
   language?: string;
   category?: CampaignCategory;
   templateParams?: Record<string, string>;
   aiParams?: Record<string, string>;
   agentId?: string;
+  tags?: string[];
+  contactIds?: string[];
+  segmentId?: string;
 };
 type CampaignAudiencePreviewPayload = {
   campaignId: string;
@@ -3027,9 +3202,11 @@ type CampaignStats = {
   totalCampaigns: number;
   draftCampaigns: number;
   totalSent: number;
+  totalOpened?: number;
+  totalClicked?: number;
 }; //#endregion
 //#region src/update/types.d.ts
-type UpdateType = 'deal' | 'event' | 'news';
+type UpdateType = 'deal' | 'event' | 'news' | 'article';
 type UpdateStatus = 'draft' | 'published' | 'archived';
 type UpdateRelation = 'team';
 type Update = {
@@ -3065,6 +3242,7 @@ type UpdateStats = {
   dealsCount: number;
   eventsCount: number;
   newsCount: number;
+  articlesCount: number;
   publishedCount: number;
   draftCount: number;
   archivedCount: number;
@@ -3865,6 +4043,10 @@ declare class ContactsResource {
   deleteActivity(id: string, activityId: string): Promise<IAppResponse<void>>;
   send(id: string, message: string, subject?: string, integration?: IntegrationType | 'preferred'): Promise<IAppResponse<void>>;
   setProperty(id: string, key: string, value: string): Promise<IAppResponse<void>>;
+  listRelations(id: string): Promise<IAppResponse<ContactRelation[]>>;
+  createRelation(id: string, data: ContactRelationPayload): Promise<IAppResponse<ContactRelation>>;
+  updateRelation(id: string, relationId: string, data: ContactRelationUpdatePayload): Promise<IAppResponse<ContactRelation>>;
+  deleteRelation(id: string, relationId: string): Promise<IAppResponse<void>>;
 }
 //#endregion
 //#region src/resources/contracts.d.ts
@@ -4247,6 +4429,19 @@ declare class MediaResource {
   download(team: string, mediaId: string, name: string, mime: string): Promise<File>;
 }
 //#endregion
+//#region src/resources/metrics.d.ts
+type MetricsQuery = {
+  source: MetricSource;
+  resource: string;
+  from: string;
+  to: string;
+};
+declare class MetricsResource {
+  private readonly http;
+  constructor(http: IHttpService);
+  query(params: MetricsQuery): Promise<IAppResponse<MetricsResult>>;
+}
+//#endregion
 //#region src/resources/meetings.d.ts
 declare class MeetingsResource {
   private readonly http;
@@ -4361,6 +4556,7 @@ declare class OrdersResource {
   get(id: string, accessToken?: string): Promise<IAppResponse<Order>>;
   create(data: {
     contactId?: string;
+    invoiceContactId?: string;
     notes?: string;
     team: string;
     fresh?: boolean;
@@ -4370,6 +4566,8 @@ declare class OrdersResource {
     priceMode?: string;
     type?: OrderType;
     sendConfirmation?: boolean;
+    invoiceDate?: string;
+    serviceDate?: string;
     items?: {
       id?: string;
       type: 'product' | 'service' | 'coupon' | 'custom';
@@ -4396,7 +4594,9 @@ declare class OrdersResource {
   update(id: string, data: {
     status?: OrderStatus;
     date?: string;
+    serviceDate?: string;
     type?: OrderType;
+    invoiceContactId?: string | null;
   }): Promise<IAppResponse<Order>>;
   convertToOrder(id: string): Promise<IAppResponse<Order>>;
   delete(id: string): Promise<IAppResponse<void>>;
@@ -4601,13 +4801,25 @@ declare class SitesResource {
   constructor(http: IHttpService);
   brands(): Promise<IAppResponse<SiteBrand[]>>;
   listMine(teamSlug: string): Promise<IAppResponse<Site[]>>;
+  create(teamSlug: string, slug: string, data?: {
+    contactId?: string | null;
+    metricsSource?: string | null;
+    metricsResource?: string | null;
+  }): Promise<IAppResponse<Site>>;
+  provision(teamSlug: string, brandSlug: string, data?: {
+    settings?: Record<string, unknown>;
+  }): Promise<IAppResponse<Site>>;
   resolve(teamSlug: string, brandSlug?: string): Promise<IAppResponse<Site>>;
   resolveByDomain(domain: string): Promise<IAppResponse<Site>>;
   update(siteId: number, data: {
     customDomain?: string | null;
     enabled?: boolean;
     modules?: string[];
-  }): Promise<IAppResponse<void>>;
+    contactId?: string | null;
+    metricsSource?: string | null;
+    metricsResource?: string | null;
+    monthlyReport?: boolean;
+  }): Promise<IAppResponse<Site>>;
 }
 //#endregion
 //#region src/resources/skills.d.ts
@@ -4832,18 +5044,55 @@ declare class CampaignsResource {
     archived?: boolean;
   }): Promise<IAppResponse<Campaign[]>>;
   get(id: string): Promise<IAppResponse<Campaign>>;
+  recipients(id: string, params?: {
+    status?: CampaignRecipientStatus;
+    page?: number;
+    perPage?: number;
+  }): Promise<IAppResponse<CampaignRecipient[]>>;
+  retry(id: string, payload?: {
+    contactIds?: string[];
+  }): Promise<IAppResponse<{
+    retried: number;
+  }>>;
   previewAudience(payload: CampaignAudiencePreviewPayload): Promise<IAppResponse<CampaignAudiencePreview>>;
   create(payload: CampaignCreatePayload): Promise<IAppResponse<Campaign>>;
   update(id: string, payload: CampaignUpdatePayload): Promise<IAppResponse<Campaign>>;
   submitForApproval(id: string): Promise<IAppResponse<Campaign>>;
   refreshApproval(id: string): Promise<IAppResponse<Campaign>>;
-  send(id: string): Promise<IAppResponse<Campaign>>;
+  send(id: string, payload?: {
+    scheduledAt?: string;
+  }): Promise<IAppResponse<Campaign>>;
+  sendTest(id: string, payload: {
+    contactId: string;
+  }): Promise<IAppResponse<void>>;
+  cancelSchedule(id: string): Promise<IAppResponse<Campaign>>;
   cancel(id: string): Promise<IAppResponse<Campaign>>;
   archive(id: string): Promise<IAppResponse<Campaign>>;
   unarchive(id: string): Promise<IAppResponse<Campaign>>;
   delete(id: string): Promise<IAppResponse<void>>;
 }
 //#endregion
+//#region src/resources/automations.d.ts
+declare class AutomationsResource {
+  private readonly http;
+  constructor(http: IHttpService);
+  list(): Promise<IAppResponse<Automation[]>>;
+  get(id: string): Promise<IAppResponse<Automation>>;
+  create(payload: AutomationCreatePayload): Promise<IAppResponse<Automation>>;
+  update(id: string, payload: AutomationUpdatePayload): Promise<IAppResponse<Automation>>;
+  setActions(id: string, actions: AutomationActionInput[]): Promise<IAppResponse<Automation>>;
+  delete(id: string): Promise<IAppResponse<void>>;
+  enrollments(id: string, params?: {
+    page?: number;
+    perPage?: number;
+  }): Promise<IAppResponse<AutomationEnrollment[]>>;
+  run(id: string, payload: {
+    contactId: string;
+  }): Promise<IAppResponse<AutomationEnrollment>>;
+  retryEnrollment(id: string, enrollmentId: string): Promise<IAppResponse<AutomationEnrollment>>;
+  previewAudience(id: string): Promise<IAppResponse<AutomationAudiencePreview>>;
+}
+//#endregion
 //#region src/resources/segments.d.ts
 declare class SegmentsResource {
   private readonly http;
@@ -4853,7 +5102,10 @@ declare class SegmentsResource {
   update(id: string, payload: SegmentCreatePayload): Promise<IAppResponse<Segment>>;
   delete(id: string): Promise<IAppResponse<void>>;
   count(payload: SegmentCountPayload): Promise<IAppResponse<SegmentCountResult>>;
-  contacts(id: string): Promise<IAppResponse<Contact[]>>;
+  contacts(id: string, params?: {
+    page?: number;
+    perPage?: number;
+  }): Promise<IAppResponse<Contact[]>>;
 }
 //#endregion
 //#region src/resources/updates.d.ts
@@ -4867,6 +5119,10 @@ declare class UpdatesResource {
     active?: boolean;
     tags?: string;
     with?: UpdateRelation[];
+    sort?: string;
+    limit?: number;
+    upcoming?: boolean;
+    past?: boolean;
   }): Promise<IAppResponse<Update[]>>;
   create(payload: UpdateCreatePayload): Promise<IAppResponse<Update>>;
   update(id: string, payload: UpdateUpdatePayload): Promise<IAppResponse<Update>>;
@@ -5143,6 +5399,7 @@ declare class JoAiClient {
   readonly loyalty: LoyaltyResource;
   readonly store: StoreResource;
   readonly media: MediaResource;
+  readonly metrics: MetricsResource;
   readonly meetings: MeetingsResource;
   readonly memories: MemoriesResource;
   readonly messages: MessagesResource;
@@ -5171,6 +5428,7 @@ declare class JoAiClient {
   readonly teams: TeamsResource;
   readonly artifacts: ArtifactsResource;
   readonly campaigns: CampaignsResource;
+  readonly automations: AutomationsResource;
   readonly segments: SegmentsResource;
   readonly updates: UpdatesResource;
   readonly upgrades: UpgradesResource;
@@ -5195,12 +5453,17 @@ declare class CachedHttpService implements IHttpService {
   private ttlMap;
   private defaultTtl;
   private cacheVersion;
-  onNetworkError: (error: Error) => void;
-  onUnauthorized: (response: IAppResponse<JsonValue>) => void;
-  onSuccessfulResponse: (response: IAppResponse<JsonValue>) => void;
-  onMaintenanceMode: (response: IAppResponse<JsonValue>) => void;
-  onTooManyRequests: (response: IAppResponse<JsonValue>) => void;
   constructor(inner: IHttpService, overrides?: TtlMap, defaultTtl?: number);
+  get onNetworkError(): (error: Error) => void;
+  set onNetworkError(fn: (error: Error) => void);
+  get onUnauthorized(): (response: IAppResponse<JsonValue>) => void;
+  set onUnauthorized(fn: (response: IAppResponse<JsonValue>) => void);
+  get onSuccessfulResponse(): (response: IAppResponse<JsonValue>) => void;
+  set onSuccessfulResponse(fn: (response: IAppResponse<JsonValue>) => void);
+  get onMaintenanceMode(): (response: IAppResponse<JsonValue>) => void;
+  set onMaintenanceMode(fn: (response: IAppResponse<JsonValue>) => void);
+  get onTooManyRequests(): (response: IAppResponse<JsonValue>) => void;
+  set onTooManyRequests(fn: (response: IAppResponse<JsonValue>) => void);
   clearCache(): void;
   get<T>(url: string, options?: IRequestOptions): Promise<IAppResponse<T>>;
   post<T>(url: string, data?: JsonValue | FormData, options?: IRequestOptions): Promise<IAppResponse<T>>;
@@ -5245,4 +5508,4 @@ declare class DistributionResource {
   private fetchDistribution;
 }
 //#endregion
-export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, type AttachedMedia, type AuthConfirmCodeRequest, type AuthConfirmCodeResponse, type AuthNativeSessionResponse, type AuthPortalSessionResponse, AuthResource, type AuthSendCodeRequest, type BackendWarp, type BackendWarpBrand, BillingResource, BlueprintsResource, type CacheConfig, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, CommerceResource, ContactsResource, ContentResource, ContractsResource, type CreateHookPayload, type CreateInboundHookPayload, type CreateInternalHookPayload, type CreateWarpLinkedHookPayload, type CreateWebHookPayload, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, type FulfillmentLocationInput, FulfillmentsResource, GoalsResource, type GuestBuyer, type GuestCheckoutDraft, type GuestCommerceStorageOptions, type GuestOrderAccess, type Hook, type HookSample, type HookTrigger, type HookTriggerCondition, type HookTriggerInput, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, type JoAiClientConfig, KvResource, LinksResource, LoyaltyResource, McpResource, type MediaUploadType, MeetingsResource, MemoriesResource, MessagesResource, MissionsResource, NotificationsResource, OfficeResource, type OpenPortalSessionOptions, type OpeningHoursEntry, type OpeningHoursFormatOptions, OrdersResource, PersonaResource, type PlaceCheckoutOrderRequest, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, type ShippingRateInput, ShippingResource, type ShippingZoneInput, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, type WebHookTriggerEvent, WorkspaceResource, completePortalSession, createClient, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, isAllowedRedirectUrl, isPortalCallbackUrl, openPortalSession, sanitizePortalCallbackUrl };
+export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, type AttachedMedia, type AuthConfirmCodeRequest, type AuthConfirmCodeResponse, type AuthNativeSessionResponse, type AuthPortalSessionResponse, AuthResource, type AuthSendCodeRequest, AutomationsResource, type BackendWarp, type BackendWarpBrand, BillingResource, BlueprintsResource, type CacheConfig, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, CommerceResource, ContactsResource, ContentResource, ContractsResource, type CreateHookPayload, type CreateInboundHookPayload, type CreateInternalHookPayload, type CreateWarpLinkedHookPayload, type CreateWebHookPayload, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, type FulfillmentLocationInput, FulfillmentsResource, GoalsResource, type GuestBuyer, type GuestCheckoutDraft, type GuestCommerceStorageOptions, type GuestOrderAccess, type Hook, type HookSample, type HookTrigger, type HookTriggerCondition, type HookTriggerInput, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, type JoAiClientConfig, KvResource, LinksResource, LoyaltyResource, McpResource, type MediaUploadType, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, type OpenPortalSessionOptions, type OpeningHoursEntry, type OpeningHoursFormatOptions, OrdersResource, PersonaResource, type PlaceCheckoutOrderRequest, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, type ShippingRateInput, ShippingResource, type ShippingZoneInput, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, type WebHookTriggerEvent, WorkspaceResource, completePortalSession, createClient, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, isAllowedRedirectUrl, isPortalCallbackUrl, openPortalSession, sanitizePortalCallbackUrl };

package/dist/index.mjs

@@ -1127,6 +1127,18 @@ var ContactsResource = class {
 			value
 		});
 	}
+	listRelations(id) {
+		return this.http.get(`contacts/${id}/relations`);
+	}
+	createRelation(id, data) {
+		return this.http.post(`contacts/${id}/relations`, data);
+	}
+	updateRelation(id, relationId, data) {
+		return this.http.put(`contacts/${id}/relations/${relationId}`, data);
+	}
+	deleteRelation(id, relationId) {
+		return this.http.delete(`contacts/${id}/relations/${relationId}`);
+	}
 };
 //#endregion
 //#region src/resources/contracts.ts
@@ -1722,6 +1734,17 @@ var MediaResource = class {
 	}
 };
 //#endregion
+//#region src/resources/metrics.ts
+var MetricsResource = class {
+	constructor(http) {
+		this.http = http;
+	}
+	query(params) {
+		const query = new URLSearchParams(params);
+		return this.http.get(`metrics?${query}`);
+	}
+};
+//#endregion
 //#region src/resources/meetings.ts
 var MeetingsResource = class {
 	constructor(http, config) {
@@ -2152,6 +2175,16 @@ var SitesResource = class {
 	listMine(teamSlug) {
 		return this.http.get(`sites/mine?team=${encodeURIComponent(teamSlug)}`);
 	}
+	create(teamSlug, slug, data) {
+		return this.http.post("sites", {
+			team: teamSlug,
+			slug,
+			...data
+		});
+	}
+	provision(teamSlug, brandSlug, data) {
+		return this.http.post(`sites/${encodeURIComponent(brandSlug)}/provision`, data ?? {}, { headers: { "X-Team": teamSlug } });
+	}
 	resolve(teamSlug, brandSlug) {
 		const query = brandSlug ? `team=${encodeURIComponent(teamSlug)}&brand=${encodeURIComponent(brandSlug)}` : `team=${encodeURIComponent(teamSlug)}`;
 		return this.http.get(`sites/resolve?${query}`);
@@ -2509,6 +2542,17 @@ var CampaignsResource = class {
 	get(id) {
 		return this.http.get(`campaigns/${id}`);
 	}
+	recipients(id, params) {
+		const search = new URLSearchParams();
+		if (params?.status) search.set("status", params.status);
+		if (params?.page) search.set("page", String(params.page));
+		if (params?.perPage) search.set("perPage", String(params.perPage));
+		const query = search.toString();
+		return this.http.get(`campaigns/${id}/recipients${query ? `?${query}` : ""}`);
+	}
+	retry(id, payload) {
+		return this.http.post(`campaigns/${id}/retry`, payload ?? {});
+	}
 	previewAudience(payload) {
 		return this.http.get(`campaigns/audience-preview${audiencePreviewQuery(payload)}`);
 	}
@@ -2524,8 +2568,14 @@ var CampaignsResource = class {
 	refreshApproval(id) {
 		return this.http.post(`campaigns/${id}/refresh`);
 	}
-	send(id) {
-		return this.http.post(`campaigns/${id}/send`);
+	send(id, payload) {
+		return this.http.post(`campaigns/${id}/send`, payload ?? {});
+	}
+	sendTest(id, payload) {
+		return this.http.post(`campaigns/${id}/send-test`, payload);
+	}
+	cancelSchedule(id) {
+		return this.http.post(`campaigns/${id}/cancel-schedule`);
 	}
 	cancel(id) {
 		return this.http.post(`campaigns/${id}/cancel`);
@@ -2553,6 +2603,47 @@ const audiencePreviewQuery = (payload) => {
 	return query ? `?${query}` : "";
 };
 //#endregion
+//#region src/resources/automations.ts
+var AutomationsResource = class {
+	constructor(http) {
+		this.http = http;
+	}
+	list() {
+		return this.http.get("automations");
+	}
+	get(id) {
+		return this.http.get(`automations/${id}`);
+	}
+	create(payload) {
+		return this.http.post("automations", payload);
+	}
+	update(id, payload) {
+		return this.http.put(`automations/${id}`, payload);
+	}
+	setActions(id, actions) {
+		return this.http.put(`automations/${id}/actions`, { actions });
+	}
+	delete(id) {
+		return this.http.delete(`automations/${id}`);
+	}
+	enrollments(id, params) {
+		const search = new URLSearchParams();
+		if (params?.page) search.set("page", String(params.page));
+		if (params?.perPage) search.set("perPage", String(params.perPage));
+		const query = search.toString();
+		return this.http.get(`automations/${id}/enrollments${query ? `?${query}` : ""}`);
+	}
+	run(id, payload) {
+		return this.http.post(`automations/${id}/run`, payload);
+	}
+	retryEnrollment(id, enrollmentId) {
+		return this.http.post(`automations/${id}/enrollments/${enrollmentId}/retry`);
+	}
+	previewAudience(id) {
+		return this.http.get(`automations/${id}/audience-preview`);
+	}
+};
+//#endregion
 //#region src/resources/segments.ts
 var SegmentsResource = class {
 	constructor(http) {
@@ -2573,8 +2664,12 @@ var SegmentsResource = class {
 	count(payload) {
 		return this.http.post("segments/count", payload);
 	}
-	contacts(id) {
-		return this.http.get(`segments/${id}/contacts`);
+	contacts(id, params) {
+		const search = new URLSearchParams();
+		if (params?.page != null) search.set("page", String(params.page));
+		if (params?.perPage != null) search.set("perPage", String(params.perPage));
+		const query = search.toString();
+		return this.http.get(`segments/${id}/contacts${query ? `?${query}` : ""}`);
 	}
 };
 //#endregion
@@ -2591,6 +2686,10 @@ var UpdatesResource = class {
 		if (params?.active != null) query.set("active", String(params.active));
 		if (params?.tags) query.set("tags", params.tags);
 		if (params?.with?.length) query.set("with", params.with.join(","));
+		if (params?.sort) query.set("sort", params.sort);
+		if (params?.limit != null) query.set("limit", String(params.limit));
+		if (params?.upcoming) query.set("filter[upcoming]", "1");
+		if (params?.past) query.set("filter[past]", "1");
 		const qs = query.toString();
 		return this.http.get(`updates${qs ? "?" + qs : ""}`);
 	}
@@ -2979,11 +3078,6 @@ var CachedHttpService = class {
 		this.inner = inner;
 		this.cache = new MemoryCache();
 		this.cacheVersion = 0;
-		this.onNetworkError = () => {};
-		this.onUnauthorized = () => {};
-		this.onSuccessfulResponse = () => {};
-		this.onMaintenanceMode = () => {};
-		this.onTooManyRequests = () => {};
 		this.baseUrl = inner.baseUrl;
 		this.authToken = inner.authToken;
 		this.ttlMap = {
@@ -2992,6 +3086,36 @@ var CachedHttpService = class {
 		};
 		this.defaultTtl = defaultTtl ?? DEFAULT_TTL;
 	}
+	get onNetworkError() {
+		return this.inner.onNetworkError;
+	}
+	set onNetworkError(fn) {
+		this.inner.onNetworkError = fn;
+	}
+	get onUnauthorized() {
+		return this.inner.onUnauthorized;
+	}
+	set onUnauthorized(fn) {
+		this.inner.onUnauthorized = fn;
+	}
+	get onSuccessfulResponse() {
+		return this.inner.onSuccessfulResponse;
+	}
+	set onSuccessfulResponse(fn) {
+		this.inner.onSuccessfulResponse = fn;
+	}
+	get onMaintenanceMode() {
+		return this.inner.onMaintenanceMode;
+	}
+	set onMaintenanceMode(fn) {
+		this.inner.onMaintenanceMode = fn;
+	}
+	get onTooManyRequests() {
+		return this.inner.onTooManyRequests;
+	}
+	set onTooManyRequests(fn) {
+		this.inner.onTooManyRequests = fn;
+	}
 	clearCache() {
 		this.cacheVersion++;
 		this.cache.clear();
@@ -3086,6 +3210,7 @@ var JoAiClient = class {
 		this.loyalty = new LoyaltyResource(this.http);
 		this.store = new StoreResource(this.http);
 		this.media = new MediaResource(this.http);
+		this.metrics = new MetricsResource(this.http);
 		this.meetings = new MeetingsResource(this.http, config);
 		this.memories = new MemoriesResource(this.http);
 		this.messages = new MessagesResource(this.http);
@@ -3114,6 +3239,7 @@ var JoAiClient = class {
 		this.teams = new TeamsResource(this.http);
 		this.artifacts = new ArtifactsResource(this.http);
 		this.campaigns = new CampaignsResource(this.http);
+		this.automations = new AutomationsResource(this.http);
 		this.segments = new SegmentsResource(this.http);
 		this.updates = new UpdatesResource(this.http);
 		this.upgrades = new UpgradesResource(this.http);
@@ -3229,4 +3355,4 @@ var DistributionResource = class {
 	}
 };
 //#endregion
-export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, AuthResource, BillingResource, BlueprintsResource, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, CommerceResource, ContactsResource, ContentResource, ContractsResource, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, FulfillmentsResource, GoalsResource, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, KvResource, LinksResource, LoyaltyResource, McpResource, MeetingsResource, MemoriesResource, MessagesResource, MissionsResource, NotificationsResource, OfficeResource, OrdersResource, PersonaResource, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, ShippingResource, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, WorkspaceResource, completePortalSession, createClient, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, isAllowedRedirectUrl, isPortalCallbackUrl, openPortalSession, sanitizePortalCallbackUrl };
+export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, AuthResource, AutomationsResource, BillingResource, BlueprintsResource, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, CommerceResource, ContactsResource, ContentResource, ContractsResource, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, FulfillmentsResource, GoalsResource, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, KvResource, LinksResource, LoyaltyResource, McpResource, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, OrdersResource, PersonaResource, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, ShippingResource, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, WorkspaceResource, completePortalSession, createClient, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, isAllowedRedirectUrl, isPortalCallbackUrl, openPortalSession, sanitizePortalCallbackUrl };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joai/sdk",
-  "version": "4.5.0",
+  "version": "4.7.0",
   "description": "JoAi public API SDK — build with your AI agents",
   "license": "MIT",
   "type": "module",
@@ -38,7 +38,7 @@
     "@joai/warps": "*"
   },
   "devDependencies": {
-    "@joai/core": "^4.10.0",
+    "@joai/core": "^4.12.0",
     "tsdown": "^0.21.0",
     "typescript": "^5.9.3"
   }