@joai/sdk 0.15.1 → 0.17.0

package/dist/index.d.mts

@@ -138,6 +138,15 @@ type Wallet = {
   privateKey?: string;
   mnemonic?: string;
 };
+type User = {
+  id: string;
+  name: string;
+  address: string;
+  balance: number | null;
+  hasProfileImage: boolean;
+  profileImageUrl: string;
+  swarmRole: string | null;
+};
 //#endregion
 //#region src/billing/types.d.ts
 type TranslatableValue = Partial<Record<WarpLocale, string>>;
@@ -157,6 +166,39 @@ type AppSubscription = {
   createdAt: string;
   updatedAt: string;
 };
+type PaymentProvider = 'xmoney' | 'lemonsqueezy' | 'stripe' | 'apple' | 'google' | 'blockchain' | 'offline';
+type PlanFeature = 'general' | 'messages' | 'team-members' | 'teams' | 'support' | 'agent' | 'auto-mode' | 'cloud-sync' | 'wallet-cloud' | 'wallet-cloud-premium' | 'wallet-multi' | 'cards' | 'alerts' | 'advanced-commands' | 'tasks' | 'integrations' | 'message-history' | 'memory' | 'documents' | 'voice-input' | 'voice-live' | 'image-gen' | 'video-gen' | 'openclaw' | 'skills' | 'items' | 'context-length' | 'workspace-storage' | 'ingestions' | 'agent-email' | 'streak-freezes' | 'byok' | 'mcp' | 'phone-call' | 'phone-number' | 'custom-domain' | 'contacts' | 'links' | 'store-fee-rate' | 'store-fee-rate-physical';
+type PlanBenefit = {
+  label: Partial<Record<WarpLocale, string>>;
+  tip?: Partial<Record<WarpLocale, string>>;
+  secondary?: boolean;
+};
+type PlanExtra = {
+  amount: number;
+  price: number;
+  unitName: string;
+};
+type PlanInterval = 'weekly' | 'monthly' | 'yearly' | 'lifetime';
+type Plan = {
+  resource: 'plan';
+  sku: string;
+  name: TranslatableValue;
+  description: Partial<Record<WarpLocale, string>>;
+  price: number;
+  priceDisplay: string;
+  interval: PlanInterval;
+  intervalDisplay: PlanInterval;
+  features: PlanFeature[];
+  benefits: Record<PlanFeature, PlanBenefit>;
+  limits: Record<PlanFeature, string>;
+  extras: Record<PlanFeature, PlanExtra>;
+  meta: {
+    appleProductId: string | null;
+    googleProductId: string | null;
+    trialPeriodDays: number;
+    isLifetime: boolean;
+  };
+};
 type ProductRating = {
   average: number;
   count: number;
@@ -288,6 +330,9 @@ type Coupon = {
   percent: number;
   expiresAt: string | null;
 };
+//#endregion
+//#region src/team/types.d.ts
+type TeamCategory = 'general' | 'appointment' | 'restaurant' | 'service' | 'fitness' | 'beauty' | 'consultation';
 type TeamFeature = 'shop' | 'appointments';
 type TeamMeta = {
   'extra.messages'?: number;
@@ -310,6 +355,7 @@ type Team = {
   slug: string;
   name: string;
   personal: boolean;
+  category?: TeamCategory;
   description: TranslatableValue | null;
   locale: WarpLocale;
   timezone: string;
@@ -337,6 +383,38 @@ type TeamBrand = {
   invoiceZip?: string;
   invoiceCountry?: string;
 };
+type TeamPrivate = {
+  slug: string;
+  name: string;
+  personal: boolean;
+  description: TranslatableValue | null;
+  tagline: TranslatableValue | null;
+  balance: number;
+  locale: WarpLocale;
+  timezone: string;
+  logo: string | null;
+  cover: string | null;
+  subscription: {
+    premium: boolean;
+    lifetime: boolean;
+    plan: Plan;
+    provider: PaymentProvider | null;
+    payer: User | null;
+    gracePeriod: boolean;
+    autoRenew: boolean;
+    uncapped: boolean;
+    cycleEndsAt: string | null;
+    resetsAt: string | null;
+    startedAt: string | null;
+    renewedAt: string | null;
+    expiresAt: string | null;
+  };
+  meta: TeamMeta;
+  branding: TeamBrand;
+  category?: TeamCategory;
+  createdAt: string;
+  justCreated: boolean;
+};
 type ByokProviderConfig = {
   apiKey?: string;
   accessKey?: string;
@@ -867,13 +945,14 @@ type Contact = {
   locale?: string | null;
   props?: Record<string, string> | null;
 };
+type ContactActivityType = 'note' | 'call' | 'meeting' | 'task' | 'update' | 'custom' | 'form';
 type ContactActivityAuthor = {
   name: string;
   imageUrl: string | null;
 };
 type ContactActivity = {
   id: string;
-  type: 'note' | 'call' | 'meeting' | 'email' | 'task' | 'update' | 'custom';
+  type: ContactActivityType;
   description: string | null;
   meta: Record<string, any> | null;
   agentName: string | null;
@@ -1043,6 +1122,13 @@ type BrandSiteConfig = {
 };
 //#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;
@@ -1050,18 +1136,49 @@ type Link = {
   status: 'active' | 'paused' | 'expired';
   title: string | null;
   scanCount: number;
-  scanHistory: number[];
-  scanGeography: Record<string, 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>;
-//#endregion
+type LinkStats = {
+  totalLinks: number;
+  activeLinks: number;
+  totalScans: number;
+  scanHistory: LinkScanHistory;
+}; //#endregion
 //#region src/store/types.d.ts
 type StoreVisibility = 'private' | 'team' | 'public';
 type StoreEntry = {
@@ -1109,6 +1226,7 @@ type StoreToggleResult = {
 //#region src/update/types.d.ts
 type UpdateType = 'deal' | 'event' | 'update';
 type UpdateStatus = 'draft' | 'published' | 'archived';
+type UpdateRelation = 'team';
 type Update = {
   id: string;
   type: UpdateType;
@@ -1120,6 +1238,7 @@ type Update = {
   linkUrl: string | null;
   startsAt: string | null;
   endsAt: string | null;
+  team?: Team;
   createdAt: string;
   updatedAt: string;
 };
@@ -1149,6 +1268,27 @@ type UpdateStats = {
 //#region src/swarm/types.d.ts
 //#endregion
 //#region src/resources/appointments.d.ts
+declare const WEEKDAYS: readonly ["monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"];
+type Weekday = typeof WEEKDAYS[number];
+type OpeningHoursRange = string | {
+  start: string;
+  end: string;
+};
+type OpeningHoursAvailability = Partial<Record<Weekday | string, OpeningHoursRange[] | null | undefined>> | null | undefined;
+type OpeningHoursEntry = {
+  days: string;
+  time: string;
+};
+type OpeningHoursFormatOptions = {
+  locale?: string;
+  dayFormat?: 'narrow' | 'short' | 'long';
+  dayLabels?: Partial<Record<Weekday, string>>;
+  dayRangeSeparator?: string;
+  dayListSeparator?: string;
+  lastDayListSeparator?: string;
+  timeRangeSeparator?: string;
+};
+declare const formatOpeningHours: (availability: OpeningHoursAvailability, options?: OpeningHoursFormatOptions) => OpeningHoursEntry[];
 declare class AppointmentsResource {
   private readonly http;
   private readonly config;
@@ -1345,6 +1485,7 @@ declare class ContactsResource {
   constructor(http: IHttpService);
   list(params?: {
     search?: string;
+    page?: number;
   }): Promise<IAppResponse<{
     data: Contact[];
   }>>;
@@ -1425,11 +1566,17 @@ type MediaUploadType = 'brand' | 'reference' | 'template' | 'output';
 declare class MediaResource {
   private readonly http;
   constructor(http: IHttpService);
+  listPublic(params?: {
+    tags?: string;
+    team?: string;
+    mime?: string;
+  }): Promise<IAppResponse<Media[]>>;
   upload(data: {
     team: string;
     file: File;
     type: MediaUploadType;
     label?: string;
+    tags?: string[];
   }): Promise<IAppResponse<Media>>;
 }
 //#endregion
@@ -1465,12 +1612,18 @@ declare class MemoriesResource {
   constructor(http: IHttpService);
   list(params?: {
     search?: string;
+    contactId?: string;
   }): Promise<IAppResponse<{
     data: Memory[];
   }>>;
   add(payload: {
     agentId: string;
     content: string;
+    contactId?: string;
+  }): Promise<IAppResponse<Memory>>;
+  update(id: string, data: {
+    name: string;
+    content: string;
   }): Promise<IAppResponse<Memory>>;
   delete(id: string): Promise<IAppResponse<unknown>>;
 }
@@ -1577,6 +1730,8 @@ declare class TeamsResource {
     email: string;
     role: 'owner' | 'admin' | 'member';
   }): Promise<IAppResponse<unknown>>;
+  updateLogo(teamSlug: string, logo: MediaLibraryItems): Promise<IAppResponse<TeamPrivate>>;
+  updateCover(teamSlug: string, cover: MediaLibraryItems): Promise<IAppResponse<TeamPrivate>>;
 }
 //#endregion
 //#region src/resources/stores.d.ts
@@ -1606,12 +1761,14 @@ declare class UpdatesResource {
   listPublic(params?: {
     type?: string;
     tags?: string;
+    with?: UpdateRelation[];
   }): Promise<IAppResponse<{
     data: Update[];
   }>>;
   list(params?: {
     type?: UpdateType;
     active?: boolean;
+    with?: UpdateRelation[];
   }): Promise<IAppResponse<{
     data: Update[];
   }>>;
@@ -1634,6 +1791,15 @@ declare class LinksResource {
   create(payload: LinkCreatePayload): Promise<IAppResponse<Link>>;
   update(id: string, payload: LinkUpdatePayload): Promise<IAppResponse<Link>>;
   delete(id: string): Promise<IAppResponse<unknown>>;
+  stats(): Promise<IAppResponse<LinkStats>>;
+  variations(linkId: string): Promise<IAppResponse<{
+    data: LinkVariation[];
+  }>>;
+  createVariation(linkId: string, payload: LinkVariationCreatePayload): Promise<IAppResponse<LinkVariation>>;
+  createVariationBatch(linkId: string, payload: LinkVariationBatchCreatePayload): Promise<IAppResponse<{
+    data: LinkVariation[];
+  }>>;
+  deleteVariation(linkId: string, variationId: string): Promise<IAppResponse<unknown>>;
 }
 //#endregion
 //#region src/resources/warps.d.ts
@@ -1773,4 +1939,4 @@ declare class DistributionResource {
   private fetchDistribution;
 }
 //#endregion
-export { AppointmentsResource, AuthResource, type AuthSendCodeRequest, type AuthVerifyResponse, type BackendWarp, type BackendWarpBrand, BlueprintsResource, type CacheConfig, CachedHttpService, CartsResource, ContactsResource, DistributionResource, FlowsResource, IngestionsResource, JoAiClient, type JoAiClientConfig, MarketplaceResource, MeetingsResource, type Order, OrdersResource, type Product, type ProductVariation, ProductsResource, ServicesResource, SitesResource, SkillsResource, StoresResource, SubscriptionsResource, WarpsResource, createClient };
+export { AppointmentsResource, AuthResource, type AuthSendCodeRequest, type AuthVerifyResponse, type BackendWarp, type BackendWarpBrand, BlueprintsResource, type CacheConfig, CachedHttpService, CartsResource, ContactsResource, DistributionResource, FlowsResource, IngestionsResource, JoAiClient, type JoAiClientConfig, LinksResource, MarketplaceResource, MeetingsResource, type OpeningHoursEntry, type OpeningHoursFormatOptions, type Order, OrdersResource, type Product, type ProductVariation, ProductsResource, ServicesResource, SitesResource, SkillsResource, StoresResource, SubscriptionsResource, WarpsResource, createClient, formatOpeningHours };

package/dist/index.mjs

@@ -111,6 +111,83 @@ var HttpService = class {
 };
 //#endregion
 //#region src/resources/appointments.ts
+const WEEKDAYS = [
+	"monday",
+	"tuesday",
+	"wednesday",
+	"thursday",
+	"friday",
+	"saturday",
+	"sunday"
+];
+const WEEKDAY_DATES = [
+	"2024-01-01",
+	"2024-01-02",
+	"2024-01-03",
+	"2024-01-04",
+	"2024-01-05",
+	"2024-01-06",
+	"2024-01-07"
+];
+const formatTimeRange = (range, separator) => {
+	if (typeof range === "string") return range.replace(/\s*-\s*/, ` ${separator} `);
+	return `${range.start} ${separator} ${range.end}`;
+};
+const labelForDay = (day, options) => {
+	if (options.dayLabels?.[day]) return options.dayLabels[day];
+	const date = /* @__PURE__ */ new Date(`${WEEKDAY_DATES[WEEKDAYS.indexOf(day)]}T12:00:00Z`);
+	return new Intl.DateTimeFormat(options.locale, {
+		weekday: options.dayFormat,
+		timeZone: "UTC"
+	}).format(date).replace(/\.$/, "");
+};
+const formatDayIndexes = (indexes, options) => {
+	const ranges = [];
+	let start = indexes[0];
+	let previous = indexes[0];
+	for (const index of indexes.slice(1)) {
+		if (index === previous + 1) {
+			previous = index;
+			continue;
+		}
+		ranges.push(start === previous ? labelForDay(WEEKDAYS[start], options) : `${labelForDay(WEEKDAYS[start], options)} ${options.dayRangeSeparator} ${labelForDay(WEEKDAYS[previous], options)}`);
+		start = index;
+		previous = index;
+	}
+	ranges.push(start === previous ? labelForDay(WEEKDAYS[start], options) : `${labelForDay(WEEKDAYS[start], options)} ${options.dayRangeSeparator} ${labelForDay(WEEKDAYS[previous], options)}`);
+	if (ranges.length <= 1) return ranges[0] ?? "";
+	return `${ranges.slice(0, -1).join(options.dayListSeparator)}${options.lastDayListSeparator}${ranges.at(-1)}`;
+};
+const formatOpeningHours = (availability, options = {}) => {
+	if (!availability) return [];
+	const resolvedOptions = {
+		locale: options.locale ?? "en",
+		dayFormat: options.dayFormat ?? "short",
+		dayLabels: options.dayLabels ?? {},
+		dayRangeSeparator: options.dayRangeSeparator ?? "–",
+		dayListSeparator: options.dayListSeparator ?? ", ",
+		lastDayListSeparator: options.lastDayListSeparator ?? " & ",
+		timeRangeSeparator: options.timeRangeSeparator ?? "–"
+	};
+	const lines = [];
+	for (const [dayIndex, day] of WEEKDAYS.entries()) {
+		const ranges = availability[day];
+		if (!ranges?.length) continue;
+		for (const range of ranges) {
+			const time = formatTimeRange(range, resolvedOptions.timeRangeSeparator);
+			const existing = lines.find((line) => line.time === time);
+			if (existing) existing.dayIndexes.push(dayIndex);
+			else lines.push({
+				dayIndexes: [dayIndex],
+				time
+			});
+		}
+	}
+	return lines.map((line) => ({
+		days: formatDayIndexes(line.dayIndexes, resolvedOptions),
+		time: line.time
+	}));
+};
 var AppointmentsResource = class {
 	constructor(http, config) {
 		this.http = http;
@@ -354,6 +431,7 @@ var ContactsResource = class {
 	list(params) {
 		const query = new URLSearchParams();
 		if (params?.search) query.set("search", params.search);
+		if (params?.page) query.set("page", String(params.page));
 		const qs = query.toString();
 		return this.http.get(`contacts${qs ? "?" + qs : ""}`);
 	}
@@ -467,11 +545,20 @@ var MediaResource = class {
 	constructor(http) {
 		this.http = http;
 	}
+	listPublic(params) {
+		const query = new URLSearchParams();
+		if (params?.tags) query.set("tags", params.tags);
+		if (params?.team) query.set("team", params.team);
+		if (params?.mime) query.set("mime", params.mime);
+		const qs = query.toString();
+		return this.http.get(`media/public${qs ? "?" + qs : ""}`);
+	}
 	upload(data) {
 		const formData = new FormData();
 		formData.append("file", data.file, data.file.name);
 		formData.append("type", data.type);
 		if (data.label) formData.append("label", data.label);
+		if (data.tags) data.tags.forEach((t) => formData.append("tags[]", t));
 		return this.http.post("media", formData, { headers: { "X-Team": data.team } });
 	}
 };
@@ -525,12 +612,16 @@ var MemoriesResource = class {
 	list(params) {
 		const query = new URLSearchParams();
 		if (params?.search) query.set("search", params.search);
+		if (params?.contactId) query.set("contactId", params.contactId);
 		const qs = query.toString();
 		return this.http.get(`memories${qs ? "?" + qs : ""}`);
 	}
 	add(payload) {
 		return this.http.post("memories", payload);
 	}
+	update(id, data) {
+		return this.http.put(`memories/${id}`, data);
+	}
 	delete(id) {
 		return this.http.delete(`memories/${id}`);
 	}
@@ -645,6 +736,12 @@ var TeamsResource = class {
 	invite(teamSlug, payload) {
 		return this.http.post(`teams/${teamSlug}/invitations`, payload);
 	}
+	updateLogo(teamSlug, logo) {
+		return this.http.post(`teams/${teamSlug}/logo`, { logo });
+	}
+	updateCover(teamSlug, cover) {
+		return this.http.post(`teams/${teamSlug}/cover`, { cover });
+	}
 };
 //#endregion
 //#region src/resources/stores.ts
@@ -690,6 +787,7 @@ var UpdatesResource = class {
 		const query = new URLSearchParams();
 		if (params?.type) query.set("type", params.type);
 		if (params?.tags) query.set("tags", params.tags);
+		if (params?.with?.length) query.set("with", params.with.join(","));
 		const qs = query.toString();
 		return this.http.get(`updates/public${qs ? "?" + qs : ""}`);
 	}
@@ -697,6 +795,7 @@ var UpdatesResource = class {
 		const query = new URLSearchParams();
 		if (params?.type) query.set("type", params.type);
 		if (params?.active != null) query.set("active", String(params.active));
+		if (params?.with?.length) query.set("with", params.with.join(","));
 		const qs = query.toString();
 		return this.http.get(`updates${qs ? "?" + qs : ""}`);
 	}
@@ -735,6 +834,21 @@ var LinksResource = class {
 	delete(id) {
 		return this.http.delete(`links/${id}`);
 	}
+	stats() {
+		return this.http.get("links/stats");
+	}
+	variations(linkId) {
+		return this.http.get(`links/${linkId}/variations`);
+	}
+	createVariation(linkId, payload) {
+		return this.http.post(`links/${linkId}/variations`, payload);
+	}
+	createVariationBatch(linkId, payload) {
+		return this.http.post(`links/${linkId}/variations/batch`, payload);
+	}
+	deleteVariation(linkId, variationId) {
+		return this.http.delete(`links/${linkId}/variations/${variationId}`);
+	}
 };
 //#endregion
 //#region src/resources/warps.ts
@@ -979,4 +1093,4 @@ var DistributionResource = class {
 	}
 };
 //#endregion
-export { AppointmentsResource, AuthResource, BlueprintsResource, CachedHttpService, CartsResource, ContactsResource, DistributionResource, FlowsResource, IngestionsResource, JoAiClient, MarketplaceResource, MeetingsResource, OrdersResource, ProductsResource, ServicesResource, SitesResource, SkillsResource, StoresResource, SubscriptionsResource, WarpsResource, createClient };
+export { AppointmentsResource, AuthResource, BlueprintsResource, CachedHttpService, CartsResource, ContactsResource, DistributionResource, FlowsResource, IngestionsResource, JoAiClient, LinksResource, MarketplaceResource, MeetingsResource, OrdersResource, ProductsResource, ServicesResource, SitesResource, SkillsResource, StoresResource, SubscriptionsResource, WarpsResource, createClient, formatOpeningHours };

package/package.json

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