@joai/sdk 0.15.1 → 0.16.0

package/dist/index.d.mts

@@ -288,6 +288,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 +313,7 @@ type Team = {
   slug: string;
   name: string;
   personal: boolean;
+  category?: TeamCategory;
   description: TranslatableValue | null;
   locale: WarpLocale;
   timezone: string;
@@ -1043,6 +1047,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 +1061,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 = {
@@ -1120,6 +1162,7 @@ type Update = {
   linkUrl: string | null;
   startsAt: string | null;
   endsAt: string | null;
+  team?: Team;
   createdAt: string;
   updatedAt: string;
 };
@@ -1149,6 +1192,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;
@@ -1425,11 +1489,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
@@ -1634,6 +1704,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 +1852,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;
@@ -467,11 +544,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 } });
 	}
 };
@@ -735,6 +821,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 +1080,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.16.0",
   "description": "JoAi public API SDK — build with your AI agents",
   "license": "MIT",
   "type": "module",