@joai/sdk 1.0.1 → 1.1.0

package/dist/index.d.mts

@@ -310,7 +310,7 @@ type TeamBrand = {
   fg?: string;
   label?: string;
   logo?: string;
-  bankName?: string;
+  bankAccountHolder?: string;
   bankIban?: string;
   bankBic?: string;
   invoiceAddress?: string;
@@ -422,6 +422,7 @@ 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 Contact = {
   id: string;
   name: string;
@@ -439,6 +440,8 @@ type Contact = {
   userId: string | null;
   locale?: string | null;
   props?: Record<string, string> | null;
+  lastActivityAt?: string | null;
+  health?: ContactHealth;
 };
 type ContactActivityType = 'note' | 'call' | 'meeting' | 'task' | 'update' | 'custom' | 'form' | 'loyalty';
 type ContactActivityAuthor = {
@@ -711,6 +714,7 @@ type Order = {
   invoiceDate: string;
   meta: Record<string, JsonValue> | null;
   contactId: string | null;
+  contact?: Contact | null;
   source: OrderSource | null;
   context: OrderContext | null;
   paymentMode: string | null;
@@ -747,9 +751,12 @@ type Cart = {
   couponDiscount: number;
 };
 type Coupon = {
+  id: string;
   code: string;
-  amount: number;
-  percent: number;
+  amount: number | null;
+  percent: number | null;
+  condition: number;
+  usesLeft: number | null;
   expiresAt: string | null;
 };
 type PurchaseResult = {
@@ -802,6 +809,7 @@ type Integration = {
   type: IntegrationType;
   name: string;
   active: boolean;
+  configured: boolean;
   createdAt: string;
   meta?: IntegrationMeta;
   details?: IntegrationDetails;
@@ -939,6 +947,64 @@ type AgentSettings = {
   'email_provider'?: EmailProvider | null;
 };
 //#endregion
+//#region src/link/types.d.ts
+type LinkScanHistory = {
+  daily: number[];
+  geography: Record<string, number>;
+  devices?: Record<string, number>;
+  operatingSystems?: Record<string, number>;
+  browsers?: Record<string, number>;
+};
+type Link = {
+  id: string;
+  url: string;
+  shortUrl: string;
+  status: 'active' | 'paused' | 'expired';
+  title: string | null;
+  scanCount: number;
+  scanHistory: LinkScanHistory;
+  lastScannedAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+};
+type LinkVariation = {
+  id: string;
+  linkId: string;
+  title: string | null;
+  values: Record<string, string>;
+  url: string;
+  shortUrl: string;
+  status: 'active' | 'paused' | 'expired';
+  scanCount: number;
+  lastScannedAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+};
+type LinkVariationCreatePayload = {
+  title?: string | null;
+  values: Record<string, string>;
+};
+type LinkVariationBatchCreatePayload = {
+  placeholder: string;
+  labelTemplate?: string | null;
+  from?: number | null;
+  to?: number | null;
+  values?: Array<{
+    value: string;
+    label?: string | null;
+  }>;
+};
+type LinkCreatePayload = {
+  url: string;
+  title: string;
+};
+type LinkUpdatePayload = Partial<LinkCreatePayload>;
+type LinkStats = {
+  totalLinks: number;
+  activeLinks: number;
+  totalScans: number;
+  scanHistory: LinkScanHistory;
+}; //#endregion
 //#region src/warp/types.d.ts
 type WarpExtrasFaq = {
   question: string;
@@ -968,17 +1034,31 @@ type WarpBackend = {
   active: boolean;
   category: WarpBackendCategory;
   featured: boolean;
+  form: boolean;
+  store: boolean;
+  executions: number;
   price?: number | null;
   primaryAddress: string | null;
   primaryFunc: string | null;
   locales: WarpLocale[];
   brand: BrandBackend | null;
+  team?: Team | null;
   definition?: Record<string, any> | null;
   extras?: WarpExtras | null;
   agent?: AgentSimple | null;
+  link?: Link | null;
+  executionHistory?: number[] | null;
 };
 type WarpBackendStatus = 'unverified' | 'verified' | 'blacklisted';
 type WarpBackendCategory = 'none';
+type WarpExecutionBackend = {
+  id: string;
+  room: string | null;
+  inputs: Record<string, unknown> | null;
+  status: string;
+  agent: AgentSimple | null;
+  createdAt: string;
+};
 type BrandSourceConfig = {
   type: string;
   chain?: string;
@@ -1124,6 +1204,9 @@ type StoreItem = {
 } | {
   type: 'skill';
   item: Skill;
+} | {
+  type: 'form';
+  item: WarpBackend;
 };
 type StoreData = {
   blueprints: Blueprint[];
@@ -1131,6 +1214,7 @@ type StoreData = {
   flows: Flow[];
   creators: BrandBackend[];
   agents: StoreAgent[];
+  forms: WarpBackend[];
   items: StoreItem[];
 };
 type StorePriceTier = {
@@ -2230,64 +2314,6 @@ type GamificationData = {
   recentExperiences: RecentExperience[];
   nextMilestones: Milestone[];
 }; //#endregion
-//#region src/link/types.d.ts
-type LinkScanHistory = {
-  daily: number[];
-  geography: Record<string, number>;
-  devices?: Record<string, number>;
-  operatingSystems?: Record<string, number>;
-  browsers?: Record<string, number>;
-};
-type Link = {
-  id: string;
-  url: string;
-  shortUrl: string;
-  status: 'active' | 'paused' | 'expired';
-  title: string | null;
-  scanCount: number;
-  scanHistory: LinkScanHistory;
-  lastScannedAt: string | null;
-  createdAt: string;
-  updatedAt: string;
-};
-type LinkVariation = {
-  id: string;
-  linkId: string;
-  title: string | null;
-  values: Record<string, string>;
-  url: string;
-  shortUrl: string;
-  status: 'active' | 'paused' | 'expired';
-  scanCount: number;
-  lastScannedAt: string | null;
-  createdAt: string;
-  updatedAt: string;
-};
-type LinkVariationCreatePayload = {
-  title?: string | null;
-  values: Record<string, string>;
-};
-type LinkVariationBatchCreatePayload = {
-  placeholder: string;
-  labelTemplate?: string | null;
-  from?: number | null;
-  to?: number | null;
-  values?: Array<{
-    value: string;
-    label?: string | null;
-  }>;
-};
-type LinkCreatePayload = {
-  url: string;
-  title: string;
-};
-type LinkUpdatePayload = Partial<LinkCreatePayload>;
-type LinkStats = {
-  totalLinks: number;
-  activeLinks: number;
-  totalScans: number;
-  scanHistory: LinkScanHistory;
-}; //#endregion
 //#region src/loyalty/types.d.ts
 type ProgramSettings = {
   point_name?: string;
@@ -2381,6 +2407,11 @@ type EarnResponse = {
   tierName?: string;
   multiplier?: number;
 };
+type StampResponse = {
+  contactName: string;
+  stamps: number;
+  rewardReady: boolean;
+};
 type RedeemResponse = {
   rewardName: string;
   rewardType: string;
@@ -2620,7 +2651,7 @@ declare class AgentsResource {
   updatePassword(uuid: string, password: string): Promise<IAppResponse<void>>;
   storePassword(uuid: string, password: string): Promise<IAppResponse<AgentPrivate>>;
   updateSetting<K extends keyof AgentSettings>(uuid: string, key: K, value: AgentSettings[K]): Promise<IAppResponse<AgentPrivate>>;
-  updateMeta(uuid: string, key: string, value: Record<string, unknown> | null): Promise<IAppResponse<AgentPrivate>>;
+  updateMeta(uuid: string, key: string, value: unknown): Promise<IAppResponse<AgentPrivate>>;
   publish(uuid: string): Promise<IAppResponse<AgentPrivate>>;
   unpublish(uuid: string): Promise<IAppResponse<AgentPrivate>>;
   moveToTeam(uuid: string, teamSlug: string): Promise<IAppResponse<AgentPrivate>>;
@@ -2981,6 +3012,26 @@ declare class CartsResource {
   applyCoupon(code: string): Promise<IAppResponse<void>>;
 }
 //#endregion
+//#region src/resources/coupons.d.ts
+type CouponPayload = {
+  code: string;
+  percent?: number | null;
+  amount?: number | null;
+  condition?: number;
+  usesLeft?: number | null;
+  expiresAt?: string | null;
+};
+declare class CouponsResource {
+  private readonly http;
+  constructor(http: IHttpService);
+  list(team: string): Promise<IAppResponse<Coupon[]>>;
+  create(team: string, data: CouponPayload): Promise<IAppResponse<Coupon>>;
+  update(id: string, data: Partial<CouponPayload> & {
+    clearExpiry?: boolean;
+  }): Promise<IAppResponse<Coupon>>;
+  delete(id: string): Promise<IAppResponse<void>>;
+}
+//#endregion
 //#region src/resources/changelog.d.ts
 declare class ChangelogResource {
   private readonly http;
@@ -2996,6 +3047,7 @@ declare class ContactsResource {
   list(params?: {
     search?: string;
     page?: number;
+    staleDays?: number;
   }): Promise<IAppResponse<Contact[]>>;
   get(id: string): Promise<IAppResponse<Contact>>;
   create(payload: ContactCreatePayload): Promise<IAppResponse<Contact>>;
@@ -3320,6 +3372,7 @@ declare class LoyaltyResource {
   deletePromotion(id: string): Promise<IAppResponse<void>>;
   enroll(contactId: string): Promise<IAppResponse<LoyaltyAccount>>;
   getAccount(contactId: string): Promise<IAppResponse<LoyaltyAccount>>;
+  stamp(contactId: string): Promise<IAppResponse<StampResponse>>;
   earn(contactId: string, context?: {
     spendCents?: number;
     items?: {
@@ -3508,6 +3561,9 @@ declare class OrdersResource {
   pay(id: string, provider: string): Promise<IAppResponse<{
     url: string;
   }>>;
+  notify(id: string, type?: string): Promise<IAppResponse<{
+    message: string;
+  }>>;
 }
 //#endregion
 //#region src/resources/persona.d.ts
@@ -3522,7 +3578,9 @@ declare class PersonaResource {
 declare class ProductsResource {
   private readonly http;
   constructor(http: IHttpService);
-  list(): Promise<IAppResponse<Product[]>>;
+  list(params?: {
+    includePrivate?: boolean;
+  }): Promise<IAppResponse<Product[]>>;
   get(id: string): Promise<IAppResponse<Product>>;
   create(data: {
     name: TranslatableValue;
@@ -3654,7 +3712,9 @@ declare class RoomsResource {
 declare class ServicesResource {
   private readonly http;
   constructor(http: IHttpService);
-  list(): Promise<IAppResponse<Service[]>>;
+  list(params?: {
+    includePrivate?: boolean;
+  }): Promise<IAppResponse<Service[]>>;
   get(slug: string): Promise<IAppResponse<Service>>;
   store(team: string, data: {
     name: TranslatableValue;
@@ -3837,6 +3897,8 @@ type TeamMutationPayload = {
   email?: string | null;
   address?: string | null;
   location?: string | null;
+  logoMediaId?: string | null;
+  coverMediaId?: string | null;
 };
 declare class TeamsResource {
   private readonly http;
@@ -3982,11 +4044,13 @@ type BackendWarpCreateResponse = Pick<BackendWarp, 'id' | 'url' | 'definition' |
 type BackendWarpUpdateResponse = Pick<BackendWarp, 'id'>;
 type BackendWarp = {
   id: string;
+  hash: string;
   title: string;
   url: string;
   definition: WarpDefinition;
   brand: BackendWarpBrand | null;
   agent?: AgentPrivate | null;
+  link?: Link | null;
 };
 declare class WarpsResource {
   private readonly http;
@@ -3996,23 +4060,41 @@ declare class WarpsResource {
     creator?: string;
     primaryAddress?: string;
     status?: WarpBackendStatus;
+    form?: boolean;
+    store?: boolean;
     page?: number;
     perPage?: number;
   }): Promise<IAppResponse<WarpBackend[]>>;
   show(identifier: string): Promise<IAppResponse<WarpBackend>>;
   create(data: {
-    brand: string;
+    brand?: string | null;
     definition: WarpDefinition;
+    title?: TranslatableValue;
+    description?: TranslatableValue | null;
+    extras?: Record<string, any> | null;
     public?: boolean;
+    form?: boolean;
+    store?: boolean;
     agent?: string | null;
   }): Promise<IAppResponse<BackendWarpCreateResponse>>;
   update(identifier: string, data: {
+    name?: string;
+    title?: TranslatableValue;
+    description?: TranslatableValue | null;
     definition?: WarpDefinition;
+    extras?: Record<string, any> | null;
+    form?: boolean;
+    store?: boolean;
     agent?: string | null;
     public?: boolean;
   }): Promise<IAppResponse<BackendWarpUpdateResponse>>;
   destroy(identifier: string): Promise<IAppResponse<void>>;
   execute(identifier: string, inputs: string[], room?: string): Promise<IAppResponse<JsonValue>>;
+  executions(identifier: string, page?: number, perPage?: number): Promise<IAppResponse<WarpExecutionBackend[]>>;
+  ensureLink(identifier: string): Promise<IAppResponse<Link>>;
+  install(identifier: string): Promise<IAppResponse<{
+    identifier: string;
+  }>>;
   sync(tx: string): Promise<IAppResponse<void>>;
   listBrands(locale: WarpLocale, options?: {
     chain?: string | string[];
@@ -4053,12 +4135,16 @@ declare class WarpsResource {
     definition: Record<string, any>;
     extras?: Record<string, any>;
     agent?: string | null;
+    form?: boolean;
+    store?: boolean;
   }): Promise<IAppResponse<WarpBackend>>;
   updateBrandWarp(teamSlug: string, brandSlug: string, warpHash: string, data: {
     name?: string;
     definition?: Record<string, any>;
     extras?: Record<string, any>;
     agent?: string | null;
+    form?: boolean;
+    store?: boolean;
   }): Promise<IAppResponse<WarpBackend>>;
   deleteBrandWarp(teamSlug: string, brandSlug: string, warpHash: string): Promise<IAppResponse<void>>;
   fetchSourceSchemaFromUrl(url: string): Promise<IAppResponse<any>>;
@@ -4153,6 +4239,7 @@ declare class JoAiClient {
   readonly notifications: NotificationsResource;
   readonly office: OfficeResource;
   readonly orders: OrdersResource;
+  readonly coupons: CouponsResource;
   readonly persona: PersonaResource;
   readonly privateWarps: WarpsResource;
   readonly products: ProductsResource;

package/dist/index.mjs

@@ -692,6 +692,25 @@ var CartsResource = class {
 	}
 };
 //#endregion
+//#region src/resources/coupons.ts
+var CouponsResource = class {
+	constructor(http) {
+		this.http = http;
+	}
+	list(team) {
+		return this.http.get("coupons", { headers: { "X-Team": team } });
+	}
+	create(team, data) {
+		return this.http.post("coupons", data, { headers: { "X-Team": team } });
+	}
+	update(id, data) {
+		return this.http.put(`coupons/${id}`, data);
+	}
+	delete(id) {
+		return this.http.delete(`coupons/${id}`);
+	}
+};
+//#endregion
 //#region src/resources/changelog.ts
 var ChangelogResource = class {
 	constructor(http) {
@@ -714,6 +733,7 @@ var ContactsResource = class {
 		const query = new URLSearchParams();
 		if (params?.search) query.set("filter[search]", params.search);
 		if (params?.page) query.set("page", String(params.page));
+		if (params?.staleDays) query.set("filter[stale_days]", String(params.staleDays));
 		const qs = query.toString();
 		return this.http.get(`contacts${qs ? "?" + qs : ""}`);
 	}
@@ -1163,6 +1183,9 @@ var LoyaltyResource = class {
 	getAccount(contactId) {
 		return this.http.get(`loyalty/accounts/${contactId}`);
 	}
+	stamp(contactId) {
+		return this.http.post("loyalty/stamp", { contactId });
+	}
 	earn(contactId, context) {
 		return this.http.post("loyalty/earn", {
 			contactId,
@@ -1209,15 +1232,17 @@ var StoreResource = class {
 			flows: [],
 			creators: [],
 			agents: [],
+			forms: [],
 			items: []
 		};
-		const { blueprints = [], skills = [], flows = [], creators = [], agents = [] } = res.data;
+		const { blueprints = [], skills = [], flows = [], creators = [], agents = [], forms = [] } = res.data;
 		return {
 			blueprints,
 			skills,
 			flows,
 			creators,
 			agents,
+			forms,
 			items: [
 				...agents.map((item) => ({
 					type: "agent",
@@ -1234,6 +1259,10 @@ var StoreResource = class {
 				...skills.map((item) => ({
 					type: "skill",
 					item
+				})),
+				...forms.map((item) => ({
+					type: "form",
+					item
 				}))
 			]
 		};
@@ -1492,6 +1521,9 @@ var OrdersResource = class {
 	pay(id, provider) {
 		return this.http.post(`orders/${id}/pay`, { provider });
 	}
+	notify(id, type = "confirmation") {
+		return this.http.post(`orders/${id}/notify`, { type });
+	}
 };
 //#endregion
 //#region src/resources/persona.ts
@@ -1515,8 +1547,10 @@ var ProductsResource = class {
 	constructor(http) {
 		this.http = http;
 	}
-	list() {
-		return this.http.get("products");
+	list(params) {
+		let url = "products";
+		if (params?.includePrivate) url += "?includePrivate=1";
+		return this.http.get(url);
 	}
 	get(id) {
 		return this.http.get(`products/${id}`);
@@ -1659,8 +1693,10 @@ var ServicesResource = class {
 	constructor(http) {
 		this.http = http;
 	}
-	list() {
-		return this.http.get("services");
+	list(params) {
+		let url = "services";
+		if (params?.includePrivate) url += "?includePrivate=1";
+		return this.http.get(url);
 	}
 	get(slug) {
 		return this.http.get(`services/${slug}`);
@@ -2218,6 +2254,8 @@ var WarpsResource = class {
 		if (options?.creator) params.set("creator", options.creator);
 		if (options?.primaryAddress) params.set("primaryAddress", options.primaryAddress);
 		if (options?.status) params.set("status", options.status);
+		if (options?.form !== void 0) params.set("form", options.form ? "1" : "0");
+		if (options?.store !== void 0) params.set("store", options.store ? "1" : "0");
 		if (options?.page) params.set("page", options.page.toString());
 		if (options?.perPage) params.set("perPage", options.perPage.toString());
 		const qs = params.toString();
@@ -2241,6 +2279,15 @@ var WarpsResource = class {
 			...room ? { room } : {}
 		});
 	}
+	executions(identifier, page = 1, perPage = 20) {
+		return this.http.get(`warps/${identifier}/executions?page=${page}&perPage=${perPage}`);
+	}
+	ensureLink(identifier) {
+		return this.http.post(`warps/${identifier}/link`, {});
+	}
+	install(identifier) {
+		return this.http.post(`warps/${identifier}/install`, {});
+	}
 	sync(tx) {
 		return this.http.post("warps/sync", { tx });
 	}
@@ -2511,6 +2558,7 @@ var JoAiClient = class {
 		this.notifications = new NotificationsResource(this.http);
 		this.office = new OfficeResource(this.http);
 		this.orders = new OrdersResource(this.http);
+		this.coupons = new CouponsResource(this.http);
 		this.persona = new PersonaResource(this.http);
 		this.privateWarps = new WarpsResource(this.http);
 		this.products = new ProductsResource(this.http);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joai/sdk",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "JoAi public API SDK — build with your AI agents",
   "license": "MIT",
   "type": "module",