@joai/sdk 2.3.0 → 3.0.0

package/dist/index.d.mts

@@ -37,7 +37,8 @@ interface IRequestOptions {
 type SocialAuthProvider = 'github' | 'apple' | 'google' | 'x' | 'telegram' | 'slack'; //#endregion
 //#region src/config/types.d.ts
 type AppEnv = 'mainnet' | 'testnet' | 'devnet' | 'local'; //#endregion
-//#region src/config/urls.d.ts
+//#region src/auth/token.d.ts
+/** One-time native/deep-link handoff param (exchanged for a Bearer via API). */
 //#endregion
 //#region src/ingestion/types.d.ts
 type IngestionSourceType = 'note' | 'meeting' | 'article' | 'email' | 'chat' | 'post' | 'webhook';
@@ -724,7 +725,7 @@ type OrderItem = {
   name: string;
   quantity: number;
   unitPrice: number;
-  type: 'product-variation' | 'service';
+  type: 'product-variation' | 'service' | 'coupon';
   digital?: boolean | null;
   sellerTeamId?: string | null;
 };
@@ -758,6 +759,7 @@ type Order = {
   notes: string | null;
   configuration?: OrderConfigurationItem[];
   items: OrderItem[];
+  coupon?: Coupon | null;
   plan: Plan | null;
   user: UserPrivate | null;
   team: TeamPrivate | null;
@@ -799,6 +801,7 @@ type Coupon = {
   amount: number | null;
   percent: number | null;
   price: number | null;
+  discount?: number;
   condition: CouponCondition;
   restrictedItems: CouponRestrictedItem[];
   usesLeft: number | null;
@@ -837,7 +840,7 @@ type Skill = {
   screenshots: string[];
 }; //#endregion
 //#region src/integration/types.d.ts
-type IntegrationType = 'none' | 'webhook' | 'api-token' | 'telegram' | 'slack' | 'whatsapp' | 'twilio' | 'sms' | 'n8n' | 'apple-health' | 'mcp' | 'x' | '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' | 'email' | 'calendar' | 'embed' | 'discord' | 'github' | 'push' | 'sentry' | 'readwise';
 type IntegrationDetails = {
   type: IntegrationType;
   name: string;
@@ -851,8 +854,16 @@ type IntegrationDetails = {
 type IntegrationMeta = {
   handle?: string;
   provider?: EmailProvider | null;
+  hookSource?: string;
   [key: string]: unknown;
 };
+type IntegrationConnectionDetails = IntegrationDetails & {
+  phoneNumberId?: string;
+  phoneNumber?: string;
+  webhookUrl?: string;
+  webhookSecret?: string;
+  webhookSecretKey?: string;
+};
 type Integration = {
   id: string;
   type: IntegrationType;
@@ -861,9 +872,9 @@ type Integration = {
   configured: boolean;
   createdAt: string;
   meta?: IntegrationMeta;
-  details?: IntegrationDetails;
+  details?: IntegrationConnectionDetails;
 };
-type SocialPlatform = 'telegram' | 'slack' | 'whatsapp' | 'sms' | 'discord' | 'github';
+type SocialPlatform = 'telegram' | 'slack' | 'whatsapp' | 'sms' | 'discord' | 'github' | 'xchat' | 'instagram';
 type SocialBot = {
   name: string;
   createdAt: string;
@@ -1167,51 +1178,6 @@ type BrandBackend = {
     integrations?: Partial<Record<BrandIntegrationProvider, BrandIntegration>>;
   };
 };
-//#endregion
-//#region src/store/types.d.ts
-type StoreVisibility = 'private' | 'team' | 'public';
-type StoreEntry = {
-  value: number | string | boolean;
-  label?: string;
-  at: string;
-};
-type Store = {
-  name: string;
-  description: string;
-  valueType: 'scalar' | 'series';
-  unit?: string;
-  visibility: StoreVisibility;
-  entryCount: number;
-  lastValue?: number | string | boolean;
-  lastAt?: string;
-};
-type StoreWithEntries = {
-  name: string;
-  description: string;
-  unit?: string;
-  entries: StoreEntry[];
-};
-type StoreCreatePayload = {
-  name: string;
-  description?: string;
-  valueType?: 'scalar' | 'series';
-  unit?: string;
-  visibility?: StoreVisibility;
-};
-type StoreEntryPayload = {
-  storeName?: string;
-  value: number | string | boolean;
-  label?: string;
-};
-type StoreEntryResult = {
-  name: string;
-  entryCount: number;
-};
-type StoreToggleResult = {
-  name: string;
-  value: number | string | boolean;
-  previous: number | string | boolean;
-};
 type StorePricing = {
   model: PricingModel;
   amount: string;
@@ -1518,6 +1484,7 @@ type AppointmentPolicy = {
   serviceSelectionEnabled?: boolean | null;
   paymentEnabled?: boolean | null;
   bookingCapacity?: number | null;
+  bookingCapacityUnit?: 'booking' | 'person' | null;
   requireApproval?: boolean | null;
   sync?: AppointmentPolicySync | null;
   agent?: Agent | null;
@@ -1793,6 +1760,7 @@ type Item = {
 };
 type ItemCreatePayload = {
   title: string;
+  source?: 'user' | 'api';
   description?: string;
   priority?: ItemPriority;
   tags?: string[];
@@ -1815,6 +1783,49 @@ type ItemUpdatePayload = {
   contactIds?: string[];
   assignedToIds?: string[];
 }; //#endregion
+//#region src/kv/types.d.ts
+type KvValue = number | string | boolean;
+type KvEntry = {
+  value: KvValue;
+  label?: string | null;
+  at: string;
+};
+type KvField = {
+  name: string;
+  description: string | null;
+  valueType: 'scalar' | 'series';
+  unit: string | null;
+  entryCount: number;
+  lastValue?: KvValue | null;
+  lastAt?: string | null;
+};
+type KvFieldWithEntries = Pick<KvField, 'name' | 'description' | 'unit'> & {
+  entries: KvEntry[];
+  nextCursor: string | null;
+};
+type CreateKvFieldPayload = {
+  name: string;
+  description?: string;
+  valueType?: 'scalar' | 'series';
+  unit?: string;
+};
+type KvEntryPayload = {
+  field?: string;
+  value: KvValue;
+  label?: string;
+};
+type SetKvEntryResult = KvEntry & {
+  name: string;
+};
+type AppendKvEntryResult = {
+  name: string;
+  entryCount: number;
+};
+type ToggleKvFieldResult = {
+  name: string;
+  value: KvValue;
+  previous: KvValue | null;
+}; //#endregion
 //#region src/marketing/types.d.ts
 //#endregion
 //#region src/mcp/types.d.ts
@@ -2781,7 +2792,17 @@ type CreateWebHookPayload = {
 type CreateWarpLinkedHookPayload = {
   warpIdentifier: string;
 };
-type CreateHookPayload = CreateInternalHookPayload | CreateWebHookPayload | CreateWarpLinkedHookPayload; //#endregion
+type CreateInboundHookPayload = {
+  source: string;
+  warpIdentifier: string;
+  trigger?: HookTrigger;
+};
+type CreateHookPayload = CreateInternalHookPayload | CreateWebHookPayload | CreateWarpLinkedHookPayload | CreateInboundHookPayload;
+type HookSample = {
+  source: string;
+  payload: Record<string, unknown> | null;
+  recordedAt: string | null;
+}; //#endregion
 //#region src/workspace/types.d.ts
 type WorkspaceInfo = {
   id?: string;
@@ -3064,6 +3085,7 @@ type AuthSendCodeRequest = {
   table?: string;
 };
 type AuthVerifyResponse = {
+  token: string;
   user: AuthUser;
   team: {
     slug: string;
@@ -4021,18 +4043,19 @@ declare class StatsResource {
 declare class KvResource {
   private readonly http;
   constructor(http: IHttpService);
-  list(): Promise<IAppResponse<Store[]>>;
-  create(payload: StoreCreatePayload): Promise<IAppResponse<Store>>;
+  list(): Promise<IAppResponse<KvField[]>>;
+  create(payload: CreateKvFieldPayload): Promise<IAppResponse<KvField>>;
   entries(params?: {
-    storeName?: string;
+    field?: string;
     since?: string;
     until?: string;
     last?: number;
-  }): Promise<IAppResponse<StoreWithEntries>>;
-  setEntry(payload: StoreEntryPayload): Promise<IAppResponse<StoreEntryResult>>;
-  appendEntry(payload: StoreEntryPayload): Promise<IAppResponse<StoreEntryResult>>;
-  toggle(storeName?: string): Promise<IAppResponse<StoreToggleResult>>;
-  delete(storeName: string): Promise<IAppResponse<void>>;
+    cursor?: string;
+  }): Promise<IAppResponse<KvFieldWithEntries>>;
+  setEntry(payload: KvEntryPayload): Promise<IAppResponse<SetKvEntryResult>>;
+  appendEntry(payload: KvEntryPayload): Promise<IAppResponse<AppendKvEntryResult>>;
+  toggle(field?: string): Promise<IAppResponse<ToggleKvFieldResult>>;
+  delete(field: string): Promise<IAppResponse<void>>;
 }
 //#endregion
 //#region src/resources/subscriptions.d.ts
@@ -4402,6 +4425,7 @@ declare class HooksResource {
   constructor(http: IHttpService);
   list(agentId: string): Promise<IAppResponse<Hook[]>>;
   create(agentId: string, payload: CreateHookPayload): Promise<IAppResponse<Hook>>;
+  sample(agentId: string, source: string): Promise<IAppResponse<HookSample>>;
   toggle(agentId: string, hookId: string): Promise<IAppResponse<Hook>>;
   removeByHook(agentId: string, hookId: string): Promise<IAppResponse<void>>;
   removeByWarp(agentId: string, warpIdentifier: string): Promise<IAppResponse<void>>;
@@ -4532,4 +4556,4 @@ declare class DistributionResource {
   private fetchDistribution;
 }
 //#endregion
-export { AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, type AttachedMedia, AuthResource, type AuthSendCodeRequest, type AuthVerifyResponse, type BackendWarp, type BackendWarpBrand, BillingAddressesResource, BillingResource, BlueprintsResource, type CacheConfig, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, ContactsResource, ContractsResource, type CreateHookPayload, type CreateInternalHookPayload, type CreateWarpLinkedHookPayload, type CreateWebHookPayload, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, GoalsResource, type Hook, 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 OpeningHoursEntry, type OpeningHoursFormatOptions, OrdersResource, PersonaResource, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, SegmentsResource, ServicesResource, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, type WebHookTriggerEvent, WorkspaceResource, createClient, formatOpeningHours };
+export { AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, type AttachedMedia, AuthResource, type AuthSendCodeRequest, type AuthVerifyResponse, type BackendWarp, type BackendWarpBrand, BillingAddressesResource, BillingResource, BlueprintsResource, type CacheConfig, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, ContactsResource, ContractsResource, type CreateHookPayload, type CreateInboundHookPayload, type CreateInternalHookPayload, type CreateWarpLinkedHookPayload, type CreateWebHookPayload, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, GoalsResource, 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 OpeningHoursEntry, type OpeningHoursFormatOptions, OrdersResource, PersonaResource, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, SegmentsResource, ServicesResource, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, type WebHookTriggerEvent, WorkspaceResource, createClient, formatOpeningHours };

package/dist/index.mjs

@@ -1874,10 +1874,11 @@ var KvResource = class {
 	}
 	entries(params) {
 		const query = new URLSearchParams();
-		if (params?.storeName) query.set("storeName", params.storeName);
+		if (params?.field) query.set("field", params.field);
 		if (params?.since) query.set("since", params.since);
 		if (params?.until) query.set("until", params.until);
 		if (params?.last != null) query.set("last", String(params.last));
+		if (params?.cursor) query.set("cursor", params.cursor);
 		const qs = query.toString();
 		return this.http.get(`kv/entries${qs ? "?" + qs : ""}`);
 	}
@@ -1887,11 +1888,11 @@ var KvResource = class {
 	appendEntry(payload) {
 		return this.http.post("kv/entries/append", payload);
 	}
-	toggle(storeName) {
-		return this.http.post("kv/toggle", { storeName });
+	toggle(field) {
+		return this.http.post("kv/toggle", { field });
 	}
-	delete(storeName) {
-		return this.http.delete(`kv/${storeName}`);
+	delete(field) {
+		return this.http.delete(`kv/${encodeURIComponent(field)}`);
 	}
 };
 //#endregion
@@ -2472,6 +2473,9 @@ var HooksResource = class {
 	create(agentId, payload) {
 		return this.http.post(`hooks?agent=${agentId}`, payload);
 	}
+	sample(agentId, source) {
+		return this.http.get(`hooks/sample?agent=${agentId}&source=${encodeURIComponent(source)}`);
+	}
 	toggle(agentId, hookId) {
 		return this.http.post(`hooks/${hookId}/toggle?agent=${agentId}`);
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joai/sdk",
-  "version": "2.3.0",
+  "version": "3.0.0",
   "description": "JoAi public API SDK — build with your AI agents",
   "license": "MIT",
   "type": "module",
@@ -31,7 +31,8 @@
   },
   "scripts": {
     "build": "tsdown",
-    "dev": "tsdown --watch"
+    "dev": "tsdown --watch",
+    "test": "jest --config jest.config.js"
   },
   "dependencies": {
     "@joai/warps": "*"