@joai/sdk 4.3.0 → 4.5.0

package/dist/index.d.mts

@@ -1,6 +1,13 @@
 import { WarpBrandUrls, WarpChainInfo, WarpChainName, WarpClient, WarpI18nText, WarpLocale, WarpNativeValue, WarpText, WarpWalletProvider } from "@joai/warps";
 
-//#region ../core/dist/types-BbqlPvhU.d.mts
+//#region ../core/dist/index.d.mts
+//#region src/auth/types.d.ts
+type SocialAuthProvider = 'github' | 'apple' | 'google' | 'x' | 'telegram' | 'slack'; //#endregion
+//#region src/config/types.d.ts
+type AppEnv = 'mainnet' | 'testnet' | 'devnet' | 'local'; //#endregion
+//#region src/auth/token.d.ts
+/** One-time native/deep-link handoff fragment key (exchanged for a Bearer via POST). */
+//#endregion
 //#region src/http/types.d.ts
 interface IHttpService {
   readonly baseUrl: string;
@@ -31,102 +38,7 @@ interface IRequestOptions {
     [name: string]: string;
   };
 } //#endregion
-//#region src/json/types.d.ts
-type JsonValue = string | number | boolean | null | JsonValue[] | {
-  [key: string]: JsonValue;
-}; //#endregion
-//#region src/media/types.d.ts
-type MediaLibraryAttributes = {
-  uuid: string;
-  order: number;
-  name: string;
-  custom_properties: {
-    [key: string]: JsonValue;
-  };
-  preview_url: null | string;
-  original_url: null | string;
-  extension?: string;
-  size?: number;
-};
-type MediaMime = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp' | 'video/mp4' | 'video/webm' | 'video/quicktime' | 'video/x-msvideo' | 'audio/mpeg' | 'audio/mp3' | 'audio/ogg' | 'audio/wav' | 'audio/webm' | 'audio/aac' | 'audio/m4a' | 'audio/m4b' | 'audio/m4p' | 'audio/m4v' | 'application/pdf' | 'application/json';
-type MediaAspectRatio = 'free' | '1:1' | '16:9' | '9:16' | '4:3' | '3:4';
-type Media = {
-  id: string;
-  name: string;
-  mime: MediaMime;
-  url: string;
-  library: MediaLibraryAttributes;
-  tags?: string[];
-  copyright?: string | null;
-  aiGenerated?: boolean;
-}; //#endregion
-//#region src/content/types.d.ts
-type ContentStatus = 'draft' | 'published' | 'archived';
-type ContentFieldType = 'text' | 'richText' | 'number' | 'boolean' | 'url' | 'image' | 'media' | 'list' | 'object' | 'reference';
-type ContentField = {
-  key: string;
-  type: ContentFieldType;
-  label?: string;
-  required?: boolean;
-};
-type ContentDefinition = {
-  fields: ContentField[];
-};
-type ContentValue = string | number | boolean | null | ContentValue[] | {
-  [key: string]: ContentValue;
-};
-type ContentEntry = {
-  key: string;
-  value: ContentValue;
-  updatedAt: string;
-};
-type ContentVersion = {
-  id: string;
-  number: number;
-  status: ContentStatus;
-  entries: ContentEntry[];
-  snapshotHash: string;
-  origin: string;
-  createdAt: string;
-  updatedAt: string;
-  publishedAt: string | null;
-};
-type Content = {
-  id: string;
-  name: string;
-  slug: string;
-  schema: string | null;
-  definition: ContentDefinition;
-  metadata: Record<string, ContentValue>;
-  version: ContentVersion | null;
-  createdAt: string;
-  updatedAt: string;
-};
-type ContentPatch = {
-  key: string;
-  value: ContentValue;
-};
-type CreateContentInput = {
-  team: string;
-  name: string;
-  slug: string;
-  schema?: string | null;
-  definition: ContentDefinition;
-  metadata?: Record<string, ContentValue>;
-};
-type PatchContentInput = {
-  expectedVersion: number;
-  patches: ContentPatch[];
-  origin?: 'api' | 'inlineEditor' | 'joai' | 'mcp';
-}; //#endregion
-//#endregion
-//#region ../core/dist/index.d.mts
-//#region src/auth/types.d.ts
-type SocialAuthProvider = 'github' | 'apple' | 'google' | 'x' | 'telegram' | 'slack'; //#endregion
-//#region src/config/types.d.ts
-type AppEnv = 'mainnet' | 'testnet' | 'devnet' | 'local'; //#endregion
-//#region src/auth/token.d.ts
-/** One-time native/deep-link handoff fragment key (exchanged for a Bearer via POST). */
+//#region src/http/service.d.ts
 //#endregion
 //#region src/ingestion/types.d.ts
 type IngestionSourceType = 'note' | 'meeting' | 'article' | 'email' | 'chat' | 'post' | 'webhook';
@@ -392,6 +304,10 @@ type WalletList = Partial<Record<WarpChainName, {
   provider: WarpWalletProvider;
   address?: string;
 }>>; //#endregion
+//#region src/json/types.d.ts
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+  [key: string]: JsonValue;
+}; //#endregion
 //#region src/contact/types.d.ts
 type ContactHealth = 'active' | 'lukewarm' | 'cold' | 'stale' | 'unknown';
 type ContactConsentStatus = 'pending' | 'confirmed' | 'superseded' | 'unsubscribed';
@@ -424,6 +340,7 @@ type Contact = {
   birthday: string | null;
   website: string | null;
   location: string | null;
+  avatar: string | null;
   socials: Record<string, string> | null;
   notes: string | null;
   tags: string[] | null;
@@ -472,11 +389,37 @@ type ContactFormData = {
   };
   nextFollowUpAt?: string | null;
   followUpNote?: string | null;
+  avatar?: string[];
 };
 type ContactCreatePayload = ContactFormData & {
   name: string;
   wallets?: WalletList;
 }; //#endregion
+//#region src/media/types.d.ts
+type MediaLibraryAttributes = {
+  uuid: string;
+  order: number;
+  name: string;
+  custom_properties: {
+    [key: string]: JsonValue;
+  };
+  preview_url: null | string;
+  original_url: null | string;
+  extension?: string;
+  size?: number;
+};
+type MediaMime = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp' | 'video/mp4' | 'video/webm' | 'video/quicktime' | 'video/x-msvideo' | 'audio/mpeg' | 'audio/mp3' | 'audio/ogg' | 'audio/wav' | 'audio/webm' | 'audio/aac' | 'audio/m4a' | 'audio/m4b' | 'audio/m4p' | 'audio/m4v' | 'application/pdf' | 'application/json';
+type MediaAspectRatio = 'free' | '1:1' | '16:9' | '9:16' | '4:3' | '3:4';
+type Media = {
+  id: string;
+  name: string;
+  mime: MediaMime;
+  url: string;
+  library: MediaLibraryAttributes;
+  tags?: string[];
+  copyright?: string | null;
+  aiGenerated?: boolean;
+}; //#endregion
 //#region src/flow/types.d.ts
 type FlowCategory = 'none' | 'defi' | 'nft' | 'social' | 'devtools' | 'productivity' | 'trading' | 'portfolio';
 type FlowStatus = 'draft' | 'published';
@@ -642,6 +585,7 @@ declare const NativeApps: {
   readonly News: "news";
   readonly Sites: "sites";
   readonly Contracts: "contracts";
+  readonly Artifacts: "artifacts";
 };
 type NativeApp = (typeof NativeApps)[keyof typeof NativeApps];
 //#endregion
@@ -1024,11 +968,11 @@ type Product = {
   media?: Media[];
 };
 type OrderItem = {
-  id: string;
+  id: string | null;
   name: string;
   quantity: number;
   unitPrice: number;
-  type: 'product-variation' | 'service' | 'coupon';
+  type: 'product-variation' | 'service' | 'coupon' | 'custom';
   digital?: boolean | null;
   sellerTeamId?: string | null;
 };
@@ -1299,6 +1243,7 @@ type AgentSimple = {
   team?: {
     slug: string;
   } | null;
+  settings?: Pick<AgentSettings, 'auto'>;
 };
 type AgentEngine = 'cortex' | 'openclaw';
 type AgentGender = 'male' | 'female' | 'neutral';
@@ -1681,6 +1626,69 @@ type PaginatedResponse<T> = {
   total: number;
   last_page: number;
 }; //#endregion
+//#region src/artifact/types.d.ts
+type ArtifactType = 'agreement' | 'offer' | 'concept' | 'update' | 'demo' | 'file' | 'other';
+type ArtifactStatus = 'draft' | 'ready' | 'sent' | 'archived';
+type ArtifactDeliverIntegration = 'email' | 'sms' | 'whatsapp';
+type ArtifactLink = {
+  url: string;
+  label?: string | null;
+};
+type ArtifactContactSummary = {
+  id: string;
+  name: string | null;
+  email: string | null;
+  phone: string | null;
+};
+type Artifact = {
+  id: string;
+  type: ArtifactType;
+  status: ArtifactStatus;
+  title: string;
+  summary: string | null;
+  url: string | null;
+  password: string | null;
+  links: ArtifactLink[];
+  meta: Record<string, unknown> | null;
+  contactId: string | null;
+  orderId: string | null;
+  contact?: ArtifactContactSummary;
+  deliveredAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+};
+type ArtifactCreatePayload = {
+  title: string;
+  type: ArtifactType;
+  status?: ArtifactStatus;
+  summary?: string;
+  url?: string;
+  password?: string;
+  links?: ArtifactLink[];
+  extraLinkUrl?: string;
+  extraLinkLabel?: string;
+  meta?: Record<string, unknown>;
+  contactId?: string;
+  orderId?: string;
+};
+type ArtifactUpdatePayload = Partial<ArtifactCreatePayload>;
+type ArtifactDeliverPayload = {
+  artifactIds: string[];
+  message: string;
+  integration: ArtifactDeliverIntegration;
+  subject?: string;
+  contactIds?: string[];
+};
+type ArtifactDelivery = {
+  id: string;
+  contactId: string;
+  integration: ArtifactDeliverIntegration;
+  subject: string | null;
+  message: string;
+  artifactIds?: string[];
+  deliveredAt: string;
+  createdAt: string;
+}; //#endregion
 //#region src/service/types.d.ts
 type Service = {
   id: string;
@@ -1841,6 +1849,65 @@ type AppointmentRequest = {
   configuration?: Configuration;
   createdAt: 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';
+type ContentField = {
+  key: string;
+  type: ContentFieldType;
+  label?: string;
+  required?: boolean;
+};
+type ContentDefinition = {
+  fields: ContentField[];
+};
+type ContentValue = string | number | boolean | null | ContentValue[] | {
+  [key: string]: ContentValue;
+};
+type ContentEntry = {
+  key: string;
+  value: ContentValue;
+  updatedAt: string;
+};
+type ContentVersion = {
+  id: string;
+  number: number;
+  status: ContentStatus;
+  entries: ContentEntry[];
+  snapshotHash: string;
+  origin: string;
+  createdAt: string;
+  updatedAt: string;
+  publishedAt: string | null;
+};
+type Content = {
+  id: string;
+  name: string;
+  slug: string;
+  schema: string | null;
+  definition: ContentDefinition;
+  metadata: Record<string, ContentValue>;
+  version: ContentVersion | null;
+  createdAt: string;
+  updatedAt: string;
+};
+type ContentPatch = {
+  key: string;
+  value: ContentValue;
+};
+type CreateContentInput = {
+  team: string;
+  name: string;
+  slug: string;
+  schema?: string | null;
+  definition: ContentDefinition;
+  metadata?: Record<string, ContentValue>;
+};
+type PatchContentInput = {
+  expectedVersion: number;
+  patches: ContentPatch[];
+  origin?: 'api' | 'inlineEditor' | 'joai' | 'mcp';
+}; //#endregion
 //#region src/commerce/helpers.d.ts
 //#endregion
 //#region src/card/types.d.ts
@@ -2865,7 +2932,7 @@ type SegmentGroup = {
 type Segment = {
   id: string;
   name: string;
-  conditions: SegmentGroup[];
+  conditions: SegmentGroup[] | SegmentCondition[];
   count: number;
   campaignsCount: number;
   createdAt: string;
@@ -2887,11 +2954,20 @@ type SegmentCountResult = {
 type CampaignChannel = 'email' | 'whatsapp' | 'sms' | 'push';
 type CampaignStatus = 'draft' | 'pending' | 'approved' | 'rejected' | 'sending' | 'completed' | 'failed';
 type CampaignCategory = 'MARKETING' | 'UTILITY' | 'AUTHENTICATION';
+type CampaignSkipReason = 'pending_consent' | 'opted_out' | 'missing_channel' | 'approval_skipped';
+type CampaignSkipReasons = Record<CampaignSkipReason, number>;
+type CampaignAudiencePreview = {
+  total: number;
+  sendable: number;
+  willSkip: number;
+  reasons: CampaignSkipReasons;
+};
 type CampaignApproval = {
   language: string | null;
   category: CampaignCategory | null;
   placeholders: string[];
   templateParams: Record<string, string>;
+  aiParams: Record<string, string>;
   externalStatus: string | null;
   rejectionReason: string | null;
 };
@@ -2902,6 +2978,7 @@ type Campaign = {
   subject: string | null;
   content: string;
   approval: CampaignApproval;
+  agent: AgentSimple | null;
   tags: string[];
   status: CampaignStatus;
   totalCount: number;
@@ -2909,6 +2986,8 @@ type Campaign = {
   sentCount: number;
   failedCount: number;
   skippedCount: number;
+  skipReasons?: CampaignSkipReasons;
+  archivedAt?: string | null;
   createdAt: string;
   updatedAt: string;
 };
@@ -2920,6 +2999,8 @@ type CampaignCreatePayload = {
   language?: string;
   category?: CampaignCategory;
   templateParams?: Record<string, string>;
+  aiParams?: Record<string, string>;
+  agentId?: string;
   tags?: string[];
   contactIds?: string[];
   segmentId?: string;
@@ -2931,6 +3012,16 @@ type CampaignUpdatePayload = {
   language?: string;
   category?: CampaignCategory;
   templateParams?: Record<string, string>;
+  aiParams?: Record<string, string>;
+  agentId?: string;
+};
+type CampaignAudiencePreviewPayload = {
+  campaignId: string;
+} | {
+  channel: CampaignChannel;
+  tags?: string[];
+  contactIds?: string[];
+  segmentId?: string;
 };
 type CampaignStats = {
   totalCampaigns: number;
@@ -3639,6 +3730,9 @@ declare class BillingResource {
   deleteOrder(id: string): Promise<IAppResponse<void>>;
   paymentAccount(team: string, provider: PaymentProvider): Promise<IAppResponse<PaymentAccount>>;
   createPaymentAccountOnboarding(team: string, provider: PaymentProvider): Promise<IAppResponse<PaymentAccountOnboarding>>;
+  disconnectPaymentAccount(team: string, provider: PaymentProvider): Promise<IAppResponse<{
+    disconnected: boolean;
+  }>>;
   updatePaymentAccount(team: string, provider: PaymentProvider, input: {
     providerAccountId: string;
     chargesEnabled?: boolean;
@@ -4277,9 +4371,11 @@ declare class OrdersResource {
     type?: OrderType;
     sendConfirmation?: boolean;
     items?: {
-      id: string;
-      type: 'product' | 'service' | 'coupon';
+      id?: string;
+      type: 'product' | 'service' | 'coupon' | 'custom';
       quantity: number;
+      name?: string;
+      unitPrice?: number;
       configuration?: Configuration;
     }[];
     fulfillmentMethod?: FulfillmentMethod;
@@ -4706,18 +4802,45 @@ declare class TeamsResource {
   topupFinalize(tx: string): Promise<IAppResponse<void>>;
 }
 //#endregion
+//#region src/resources/artifacts.d.ts
+type ArtifactListParams = {
+  type?: ArtifactType;
+  status?: ArtifactStatus;
+  contactId?: string;
+  orderId?: string;
+  ids?: string[] | string;
+  page?: number;
+  perPage?: number;
+};
+declare class ArtifactsResource {
+  private readonly http;
+  constructor(http: IHttpService);
+  list(params?: ArtifactListParams): Promise<IAppResponse<Artifact[]>>;
+  get(id: string): Promise<IAppResponse<Artifact>>;
+  create(payload: ArtifactCreatePayload): Promise<IAppResponse<Artifact>>;
+  update(id: string, payload: ArtifactUpdatePayload): Promise<IAppResponse<Artifact>>;
+  delete(id: string): Promise<IAppResponse<void>>;
+  deliver(payload: ArtifactDeliverPayload): Promise<IAppResponse<ArtifactDelivery[]>>;
+}
+//#endregion
 //#region src/resources/campaigns.d.ts
 declare class CampaignsResource {
   private readonly http;
   constructor(http: IHttpService);
   stats(): Promise<IAppResponse<CampaignStats>>;
-  list(): Promise<IAppResponse<Campaign[]>>;
+  list(params?: {
+    archived?: boolean;
+  }): Promise<IAppResponse<Campaign[]>>;
   get(id: string): Promise<IAppResponse<Campaign>>;
+  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>>;
+  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
@@ -4730,6 +4853,7 @@ 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[]>>;
 }
 //#endregion
 //#region src/resources/updates.d.ts
@@ -5045,6 +5169,7 @@ declare class JoAiClient {
   readonly tasks: TasksResource;
   readonly tags: TagsResource;
   readonly teams: TeamsResource;
+  readonly artifacts: ArtifactsResource;
   readonly campaigns: CampaignsResource;
   readonly segments: SegmentsResource;
   readonly updates: UpdatesResource;

package/dist/index.mjs

@@ -153,7 +153,8 @@ Object.values({
 	Campaigns: "campaigns",
 	News: "news",
 	Sites: "sites",
-	Contracts: "contracts"
+	Contracts: "contracts",
+	Artifacts: "artifacts"
 });
 /** Permission string values — must match joai--api `UserPermission::value`. */
 const UserPermissions = {
@@ -896,6 +897,9 @@ var BillingResource = class {
 	createPaymentAccountOnboarding(team, provider) {
 		return this.http.post(`payment-accounts/${provider}/onboarding`, void 0, { headers: { "X-Team": team } });
 	}
+	disconnectPaymentAccount(team, provider) {
+		return this.http.delete(`payment-accounts/${provider}`, { headers: { "X-Team": team } });
+	}
 	updatePaymentAccount(team, provider, input) {
 		return this.http.put(`payment-accounts/${provider}`, input, { headers: { "X-Team": team } });
 	}
@@ -2453,6 +2457,43 @@ var TeamsResource = class {
 	}
 };
 //#endregion
+//#region src/resources/artifacts.ts
+var ArtifactsResource = class {
+	constructor(http) {
+		this.http = http;
+	}
+	list(params) {
+		const query = new URLSearchParams();
+		if (params?.type) query.set("type", params.type);
+		if (params?.status) query.set("status", params.status);
+		if (params?.contactId) query.set("contactId", params.contactId);
+		if (params?.orderId) query.set("orderId", params.orderId);
+		if (params?.ids) {
+			const ids = Array.isArray(params.ids) ? params.ids.join(",") : params.ids;
+			if (ids) query.set("ids", ids);
+		}
+		if (params?.page != null) query.set("page", String(params.page));
+		if (params?.perPage != null) query.set("perPage", String(params.perPage));
+		const qs = query.toString();
+		return this.http.get(`artifacts${qs ? `?${qs}` : ""}`);
+	}
+	get(id) {
+		return this.http.get(`artifacts/${id}`);
+	}
+	create(payload) {
+		return this.http.post("artifacts", payload);
+	}
+	update(id, payload) {
+		return this.http.patch(`artifacts/${id}`, payload);
+	}
+	delete(id) {
+		return this.http.delete(`artifacts/${id}`);
+	}
+	deliver(payload) {
+		return this.http.post("artifacts/deliver", payload);
+	}
+};
+//#endregion
 //#region src/resources/campaigns.ts
 var CampaignsResource = class {
 	constructor(http) {
@@ -2461,12 +2502,16 @@ var CampaignsResource = class {
 	stats() {
 		return this.http.get("campaigns/stats");
 	}
-	list() {
-		return this.http.get("campaigns");
+	list(params) {
+		const query = params?.archived ? "?archived=1" : "";
+		return this.http.get(`campaigns${query}`);
 	}
 	get(id) {
 		return this.http.get(`campaigns/${id}`);
 	}
+	previewAudience(payload) {
+		return this.http.get(`campaigns/audience-preview${audiencePreviewQuery(payload)}`);
+	}
 	create(payload) {
 		return this.http.post("campaigns", payload);
 	}
@@ -2482,10 +2527,31 @@ var CampaignsResource = class {
 	send(id) {
 		return this.http.post(`campaigns/${id}/send`);
 	}
+	cancel(id) {
+		return this.http.post(`campaigns/${id}/cancel`);
+	}
+	archive(id) {
+		return this.http.post(`campaigns/${id}/archive`);
+	}
+	unarchive(id) {
+		return this.http.post(`campaigns/${id}/unarchive`);
+	}
 	delete(id) {
 		return this.http.delete(`campaigns/${id}`);
 	}
 };
+const audiencePreviewQuery = (payload) => {
+	const search = new URLSearchParams();
+	if ("campaignId" in payload) search.set("campaignId", payload.campaignId);
+	else {
+		search.set("channel", payload.channel);
+		if (payload.segmentId) search.set("segmentId", payload.segmentId);
+		if (payload.tags?.length) search.set("tags", payload.tags.join(","));
+		if (payload.contactIds?.length) search.set("contactIds", payload.contactIds.join(","));
+	}
+	const query = search.toString();
+	return query ? `?${query}` : "";
+};
 //#endregion
 //#region src/resources/segments.ts
 var SegmentsResource = class {
@@ -2507,6 +2573,9 @@ var SegmentsResource = class {
 	count(payload) {
 		return this.http.post("segments/count", payload);
 	}
+	contacts(id) {
+		return this.http.get(`segments/${id}/contacts`);
+	}
 };
 //#endregion
 //#region src/resources/updates.ts
@@ -3043,6 +3112,7 @@ var JoAiClient = class {
 		this.tasks = new TasksResource(this.http);
 		this.tags = new TagsResource(this.http);
 		this.teams = new TeamsResource(this.http);
+		this.artifacts = new ArtifactsResource(this.http);
 		this.campaigns = new CampaignsResource(this.http);
 		this.segments = new SegmentsResource(this.http);
 		this.updates = new UpdatesResource(this.http);

package/package.json

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