arky-sdk 0.7.65 → 0.7.67

package/dist/index.d.cts

@@ -12,14 +12,52 @@ interface HttpClientConfig {
     baseUrl: string;
     businessId: string;
     refreshPath?: string;
-    getToken: () => Promise<AuthTokens> | AuthTokens;
-    setToken: (tokens: AuthTokens) => void;
-    logout: () => void;
+    getToken?: () => Promise<AuthTokens> | AuthTokens;
+    setToken?: (tokens: AuthTokens) => void;
+    logout?: () => void;
     navigate?: (path: string) => void;
     loginFallbackPath?: string;
     isAuthenticated?: () => boolean;
 }
 
+interface AnalyticsSummary {
+    revenue: number;
+    revenueChange: number;
+    orders: number;
+    ordersChange: number;
+    bookings: number;
+    bookingsChange: number;
+    newCustomers: number;
+    newCustomersChange: number;
+    formSubmissions: number;
+    formSubmissionsChange: number;
+    activeProducts: number;
+    activeServices: number;
+    activeProviders: number;
+}
+interface TimeSeriesPoint {
+    date: string;
+    value: number;
+}
+interface TimeSeriesResponse {
+    period: {
+        start: string;
+        end: string;
+    };
+    interval: string;
+    series: Record<string, TimeSeriesPoint[]>;
+}
+interface TopEntity {
+    entityId: string;
+    label: string;
+    count: number;
+    revenue: number;
+}
+interface StatusBreakdown {
+    status: string;
+    count: number;
+}
+
 type ReactionTargetType = "product" | "service" | "provider" | "booking" | "node";
 type ReactionStatus = "pending" | "published" | "hidden" | "removed";
 interface ReactionTarget {
@@ -148,7 +186,7 @@ declare global {
 }
 declare function track(eventName: string, params?: Record<string, any>): void;
 
-declare const SDK_VERSION = "0.7.65";
+declare const SDK_VERSION = "0.7.67";
 declare const SUPPORTED_FRAMEWORKS: readonly ["astro", "react", "vue", "svelte", "vanilla"];
 interface ApiConfig {
     httpClient: any;
@@ -426,6 +464,23 @@ declare function createAdmin(config: HttpClientConfig & {
     };
     analytics: {
         track: typeof track;
+        getSummary: (params?: {
+            period?: string;
+        }, options?: RequestOptions) => Promise<AnalyticsSummary>;
+        getSeries: (params: {
+            metrics: string[];
+            period?: string;
+            interval?: string;
+        }, options?: RequestOptions) => Promise<TimeSeriesResponse>;
+        getTopEntities: (params: {
+            entity: string;
+            period?: string;
+            limit?: number;
+        }, options?: RequestOptions) => Promise<TopEntity[]>;
+        getStatusBreakdown: (params: {
+            entity: string;
+            period?: string;
+        }, options?: RequestOptions) => Promise<StatusBreakdown[]>;
     };
     setBusinessId: (businessId: string) => void;
     getBusinessId: () => string;
@@ -692,4 +747,4 @@ declare function createStorefront(config: HttpClientConfig & {
     };
 }>;
 
-export { type ApiConfig, AvailabilityResponse, Block, CreateAgentParams, CreateLocationParams, type CreateReactionParams, DEFAULT_REACTION_KINDS, DeleteLocationParams, type EngagementSummary, type EngagementSummaryParams, type FindReactionsParams, GetAgentParams, GetAgentsParams, GetAvailabilityParams, type GetCountriesResponse, type GetReactionParams, GetShippingRatesParams, type HttpClientConfig, Location, type LocationCountry, type LocationState, Market, type ModerateReactionParams, REACTION_KIND_REGEX, type Reaction, type ReactionStatus, type ReactionTarget, type ReactionTargetType, SDK_VERSION, SUPPORTED_FRAMEWORKS, ShipParams, ShipResult, ShippingRate, Slot, UpdateAgentParams, UpdateLocationParams, type UpdateReactionParams, computeAverageStars, createAdmin, createStorefront, isValidReactionKind };
+export { type AnalyticsSummary, type ApiConfig, AvailabilityResponse, Block, CreateAgentParams, CreateLocationParams, type CreateReactionParams, DEFAULT_REACTION_KINDS, DeleteLocationParams, type EngagementSummary, type EngagementSummaryParams, type FindReactionsParams, GetAgentParams, GetAgentsParams, GetAvailabilityParams, type GetCountriesResponse, type GetReactionParams, GetShippingRatesParams, type HttpClientConfig, Location, type LocationCountry, type LocationState, Market, type ModerateReactionParams, REACTION_KIND_REGEX, type Reaction, type ReactionStatus, type ReactionTarget, type ReactionTargetType, SDK_VERSION, SUPPORTED_FRAMEWORKS, ShipParams, ShipResult, ShippingRate, Slot, type StatusBreakdown, type TimeSeriesPoint, type TimeSeriesResponse, type TopEntity, UpdateAgentParams, UpdateLocationParams, type UpdateReactionParams, computeAverageStars, createAdmin, createStorefront, isValidReactionKind };

package/dist/index.d.ts

@@ -12,14 +12,52 @@ interface HttpClientConfig {
     baseUrl: string;
     businessId: string;
     refreshPath?: string;
-    getToken: () => Promise<AuthTokens> | AuthTokens;
-    setToken: (tokens: AuthTokens) => void;
-    logout: () => void;
+    getToken?: () => Promise<AuthTokens> | AuthTokens;
+    setToken?: (tokens: AuthTokens) => void;
+    logout?: () => void;
     navigate?: (path: string) => void;
     loginFallbackPath?: string;
     isAuthenticated?: () => boolean;
 }
 
+interface AnalyticsSummary {
+    revenue: number;
+    revenueChange: number;
+    orders: number;
+    ordersChange: number;
+    bookings: number;
+    bookingsChange: number;
+    newCustomers: number;
+    newCustomersChange: number;
+    formSubmissions: number;
+    formSubmissionsChange: number;
+    activeProducts: number;
+    activeServices: number;
+    activeProviders: number;
+}
+interface TimeSeriesPoint {
+    date: string;
+    value: number;
+}
+interface TimeSeriesResponse {
+    period: {
+        start: string;
+        end: string;
+    };
+    interval: string;
+    series: Record<string, TimeSeriesPoint[]>;
+}
+interface TopEntity {
+    entityId: string;
+    label: string;
+    count: number;
+    revenue: number;
+}
+interface StatusBreakdown {
+    status: string;
+    count: number;
+}
+
 type ReactionTargetType = "product" | "service" | "provider" | "booking" | "node";
 type ReactionStatus = "pending" | "published" | "hidden" | "removed";
 interface ReactionTarget {
@@ -148,7 +186,7 @@ declare global {
 }
 declare function track(eventName: string, params?: Record<string, any>): void;
 
-declare const SDK_VERSION = "0.7.65";
+declare const SDK_VERSION = "0.7.67";
 declare const SUPPORTED_FRAMEWORKS: readonly ["astro", "react", "vue", "svelte", "vanilla"];
 interface ApiConfig {
     httpClient: any;
@@ -426,6 +464,23 @@ declare function createAdmin(config: HttpClientConfig & {
     };
     analytics: {
         track: typeof track;
+        getSummary: (params?: {
+            period?: string;
+        }, options?: RequestOptions) => Promise<AnalyticsSummary>;
+        getSeries: (params: {
+            metrics: string[];
+            period?: string;
+            interval?: string;
+        }, options?: RequestOptions) => Promise<TimeSeriesResponse>;
+        getTopEntities: (params: {
+            entity: string;
+            period?: string;
+            limit?: number;
+        }, options?: RequestOptions) => Promise<TopEntity[]>;
+        getStatusBreakdown: (params: {
+            entity: string;
+            period?: string;
+        }, options?: RequestOptions) => Promise<StatusBreakdown[]>;
     };
     setBusinessId: (businessId: string) => void;
     getBusinessId: () => string;
@@ -692,4 +747,4 @@ declare function createStorefront(config: HttpClientConfig & {
     };
 }>;
 
-export { type ApiConfig, AvailabilityResponse, Block, CreateAgentParams, CreateLocationParams, type CreateReactionParams, DEFAULT_REACTION_KINDS, DeleteLocationParams, type EngagementSummary, type EngagementSummaryParams, type FindReactionsParams, GetAgentParams, GetAgentsParams, GetAvailabilityParams, type GetCountriesResponse, type GetReactionParams, GetShippingRatesParams, type HttpClientConfig, Location, type LocationCountry, type LocationState, Market, type ModerateReactionParams, REACTION_KIND_REGEX, type Reaction, type ReactionStatus, type ReactionTarget, type ReactionTargetType, SDK_VERSION, SUPPORTED_FRAMEWORKS, ShipParams, ShipResult, ShippingRate, Slot, UpdateAgentParams, UpdateLocationParams, type UpdateReactionParams, computeAverageStars, createAdmin, createStorefront, isValidReactionKind };
+export { type AnalyticsSummary, type ApiConfig, AvailabilityResponse, Block, CreateAgentParams, CreateLocationParams, type CreateReactionParams, DEFAULT_REACTION_KINDS, DeleteLocationParams, type EngagementSummary, type EngagementSummaryParams, type FindReactionsParams, GetAgentParams, GetAgentsParams, GetAvailabilityParams, type GetCountriesResponse, type GetReactionParams, GetShippingRatesParams, type HttpClientConfig, Location, type LocationCountry, type LocationState, Market, type ModerateReactionParams, REACTION_KIND_REGEX, type Reaction, type ReactionStatus, type ReactionTarget, type ReactionTargetType, SDK_VERSION, SUPPORTED_FRAMEWORKS, ShipParams, ShipResult, ShippingRate, Slot, type StatusBreakdown, type TimeSeriesPoint, type TimeSeriesResponse, type TopEntity, UpdateAgentParams, UpdateLocationParams, type UpdateReactionParams, computeAverageStars, createAdmin, createStorefront, isValidReactionKind };

package/dist/index.js

@@ -43,7 +43,42 @@ function buildQueryString(params) {
 }
 
 // src/services/createHttpClient.ts
+var STORAGE_KEYS = {
+  accessToken: "arky_token",
+  refreshToken: "arky_refresh",
+  accessExpiresAt: "arky_expires_at"
+};
+function defaultGetToken() {
+  if (typeof window === "undefined") return { accessToken: "" };
+  return {
+    accessToken: localStorage.getItem(STORAGE_KEYS.accessToken) || "",
+    refreshToken: localStorage.getItem(STORAGE_KEYS.refreshToken) || "",
+    accessExpiresAt: parseInt(localStorage.getItem(STORAGE_KEYS.accessExpiresAt) || "0", 10)
+  };
+}
+function defaultSetToken(tokens) {
+  if (typeof window === "undefined") return;
+  if (tokens.accessToken) {
+    localStorage.setItem(STORAGE_KEYS.accessToken, tokens.accessToken);
+    localStorage.setItem(STORAGE_KEYS.refreshToken, tokens.refreshToken || "");
+    localStorage.setItem(STORAGE_KEYS.accessExpiresAt, (tokens.accessExpiresAt || 0).toString());
+  } else {
+    Object.values(STORAGE_KEYS).forEach((key) => localStorage.removeItem(key));
+  }
+}
+function defaultLogout() {
+  if (typeof window === "undefined") return;
+  Object.values(STORAGE_KEYS).forEach((key) => localStorage.removeItem(key));
+}
+function defaultIsAuthenticated() {
+  if (typeof window === "undefined") return false;
+  const token = localStorage.getItem(STORAGE_KEYS.accessToken) || "";
+  return token.startsWith("customer_") || token.startsWith("account_");
+}
 function createHttpClient(cfg) {
+  const getToken = cfg.getToken || defaultGetToken;
+  const setToken = cfg.setToken || defaultSetToken;
+  const logout = cfg.logout || defaultLogout;
   const refreshEndpoint = `${cfg.baseUrl}${cfg.refreshPath || "/v1/auth/refresh"}`;
   let refreshPromise = null;
   async function ensureFreshToken() {
@@ -51,9 +86,9 @@ function createHttpClient(cfg) {
       return refreshPromise;
     }
     refreshPromise = (async () => {
-      const { refreshToken } = await cfg.getToken();
+      const { refreshToken } = await getToken();
       if (!refreshToken) {
-        cfg.logout();
+        logout();
         const err = new Error("No refresh token available");
         err.name = "ApiError";
         err.statusCode = 401;
@@ -65,14 +100,14 @@ function createHttpClient(cfg) {
         body: JSON.stringify({ refreshToken })
       });
       if (!refRes.ok) {
-        cfg.logout();
+        logout();
         const err = new Error("Token refresh failed");
         err.name = "ApiError";
         err.statusCode = 401;
         throw err;
       }
       const data = await refRes.json();
-      cfg.setToken(data);
+      setToken(data);
     })().finally(() => {
       refreshPromise = null;
     });
@@ -87,11 +122,11 @@ function createHttpClient(cfg) {
       "Content-Type": "application/json",
       ...options?.headers || {}
     };
-    let { accessToken, accessExpiresAt } = await cfg.getToken();
+    let { accessToken, accessExpiresAt } = await getToken();
     const nowSec = Date.now() / 1e3;
     if (accessExpiresAt && nowSec > accessExpiresAt) {
       await ensureFreshToken();
-      const tokens = await cfg.getToken();
+      const tokens = await getToken();
       accessToken = tokens.accessToken;
     }
     if (accessToken) {
@@ -124,7 +159,7 @@ function createHttpClient(cfg) {
     if (res.status === 401 && !options?.["_retried"]) {
       try {
         await ensureFreshToken();
-        const tokens = await cfg.getToken();
+        const tokens = await getToken();
         headers["Authorization"] = `Bearer ${tokens.accessToken}`;
         fetchOpts.headers = headers;
         return request(method, path, body, { ...options, _retried: true });
@@ -1866,6 +1901,49 @@ var createTaxonomyApi = (apiConfig) => {
   };
 };
 
+// src/api/analytics.ts
+var createAnalyticsApi = (apiConfig) => {
+  return {
+    async getSummary(params, options) {
+      return apiConfig.httpClient.get(
+        `/v1/businesses/${apiConfig.businessId}/analytics/summary`,
+        {
+          ...options,
+          params: params || {}
+        }
+      );
+    },
+    async getSeries(params, options) {
+      const { metrics, ...rest } = params;
+      return apiConfig.httpClient.get(
+        `/v1/businesses/${apiConfig.businessId}/analytics/series`,
+        {
+          ...options,
+          params: { ...rest, metrics: metrics.join(",") }
+        }
+      );
+    },
+    async getTopEntities(params, options) {
+      return apiConfig.httpClient.get(
+        `/v1/businesses/${apiConfig.businessId}/analytics/top`,
+        {
+          ...options,
+          params
+        }
+      );
+    },
+    async getStatusBreakdown(params, options) {
+      return apiConfig.httpClient.get(
+        `/v1/businesses/${apiConfig.businessId}/analytics/status`,
+        {
+          ...options,
+          params
+        }
+      );
+    }
+  };
+};
+
 // src/api/storefront.ts
 function groupCartToItems(cart) {
   const groups = /* @__PURE__ */ new Map();
@@ -2712,7 +2790,7 @@ function getFirstAvailableFCId(variant, quantity = 1) {
 }
 
 // src/index.ts
-var SDK_VERSION = "0.7.65";
+var SDK_VERSION = "0.7.67";
 var SUPPORTED_FRAMEWORKS = [
   "astro",
   "react",
@@ -2762,15 +2840,19 @@ function createUtilitySurface(apiConfig) {
 }
 async function createAdmin(config) {
   const locale = config.locale || "en";
-  const httpClient = createHttpClient(config);
+  const getToken = config.getToken || defaultGetToken;
+  const setToken = config.setToken || defaultSetToken;
+  const logout = config.logout || defaultLogout;
+  const isAuthenticated = config.isAuthenticated || defaultIsAuthenticated;
+  const httpClient = createHttpClient({ ...config, getToken, setToken, logout });
   const apiConfig = {
     httpClient,
     businessId: config.businessId,
     baseUrl: config.baseUrl,
     market: config.market,
     locale,
-    setToken: config.setToken,
-    getToken: config.getToken
+    setToken,
+    getToken
   };
   const accountApi = createAccountApi(apiConfig);
   const authApi = createAuthApi(apiConfig);
@@ -2799,6 +2881,7 @@ async function createAdmin(config) {
   const formApi = createFormApi(apiConfig);
   const taxonomyApi = createTaxonomyApi(apiConfig);
   const emailTemplateApi = createEmailTemplateApi(apiConfig);
+  const analyticsApi = createAnalyticsApi(apiConfig);
   const sdk = {
     auth: authApi,
     account: accountApi,
@@ -2945,7 +3028,11 @@ async function createAdmin(config) {
       }
     },
     analytics: {
-      track
+      track,
+      getSummary: analyticsApi.getSummary,
+      getSeries: analyticsApi.getSeries,
+      getTopEntities: analyticsApi.getTopEntities,
+      getStatusBreakdown: analyticsApi.getStatusBreakdown
     },
     setBusinessId: (businessId) => {
       apiConfig.businessId = businessId;
@@ -2959,9 +3046,9 @@ async function createAdmin(config) {
       apiConfig.locale = locale2;
     },
     getLocale: () => apiConfig.locale,
-    isAuthenticated: config.isAuthenticated || (() => false),
-    logout: config.logout,
-    setToken: config.setToken,
+    isAuthenticated,
+    logout,
+    setToken,
     extractBlockValues,
     utils: createUtilitySurface(apiConfig)
   };
@@ -2969,8 +3056,15 @@ async function createAdmin(config) {
 }
 async function createStorefront(config) {
   const locale = config.locale || "en";
+  const getToken = config.getToken || defaultGetToken;
+  const setToken = config.setToken || defaultSetToken;
+  const logout = config.logout || defaultLogout;
+  const isAuthenticated = config.isAuthenticated || defaultIsAuthenticated;
   const httpClient = createHttpClient({
     ...config,
+    getToken,
+    setToken,
+    logout,
     refreshPath: `/v1/storefront/${config.businessId}/customers/auth/refresh`
   });
   const apiConfig = {
@@ -2979,8 +3073,8 @@ async function createStorefront(config) {
     baseUrl: config.baseUrl,
     market: config.market,
     locale,
-    setToken: config.setToken,
-    getToken: config.getToken
+    setToken,
+    getToken
   };
   const storefrontApi = createStorefrontApi(apiConfig);
   let sessionPromise = null;
@@ -3036,9 +3130,9 @@ async function createStorefront(config) {
       apiConfig.locale = locale2;
     },
     getLocale: () => apiConfig.locale,
-    isAuthenticated: config.isAuthenticated || (() => false),
-    logout: config.logout,
-    setToken: config.setToken,
+    isAuthenticated,
+    logout,
+    setToken,
     extractBlockValues,
     utils: createUtilitySurface(apiConfig)
   };