umami-api-js 1.1.0 → 1.2.0

package/README.md

@@ -4,11 +4,11 @@
 [![automated testing](https://codeberg.org/Taevas/umami-api-js/badges/workflows/test.yml/badge.svg)](https://codeberg.org/Taevas/umami-api-js/actions?workflow=test.yml)
 [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/V7V4J78L0)
 
-A package to interact with [the API of **self-hosted instances** of Umami](https://umami.is/docs/api).
+A package to interact with [the API of **self-hosted instances** of Umami](https://docs.umami.is/docs/api).
 
 The documentation for the latest version of this package can be found at any time on [umami-api-js.taevas.xyz](https://umami-api-js.taevas.xyz)!
 
-Please note: It has not been made to work on [Umami Cloud](https://umami.is/docs/cloud) (the instance of Umami hosted by its creators) and is therefore not expected to work there.
+Please note: It has NOT been made to work on [Umami Cloud](https://docs.umami.is/docs/cloud) (the instance of Umami hosted by its creators) and is therefore not expected to work there.
 
 ## How to install and get started
 

package/dist/index.d.ts

@@ -307,6 +307,8 @@ export declare class API {
     readonly getWebsiteEventsDataValues: typeof Events.get_WEBSITEID_EventdataValues;
     /** @group Events endpoints */
     readonly getWebsiteEventsDataStats: typeof Events.get_WEBSITEID_EventdataStats;
+    /** @group Events endpoints */
+    readonly getWebsiteEventsDataPivoted: typeof Events.get_WEBSITEID_EventdataPivot;
     /** @group Links endpoints */
     readonly getLinks: typeof Links.get;
     /** @group Links endpoints */
@@ -345,9 +347,13 @@ export declare class API {
     readonly deleteWebsite: typeof Websites.delete_WEBSITEID;
     /** @group Websites endpoints */
     readonly resetWebsite: typeof Websites.post_WEBSITEID_Reset;
+    /** @group Websites endpoints */
+    readonly getWebsiteRecorder: typeof Websites.getRecorder;
     /** @group Website stats endpoints */
     readonly getWebsiteActiveVisitors: typeof WebsiteStats.get_WEBSITEID_Active;
     /** @group Website stats endpoints */
+    readonly getWebsiteDateRange: typeof WebsiteStats.get_WEBSITEID_DateRange;
+    /** @group Website stats endpoints */
     readonly getWebsiteEventsStats: typeof WebsiteStats.get_WEBSITEID_EventsSeries;
     /** @group Website stats endpoints */
     readonly getWebsiteMetrics: typeof WebsiteStats.get_WEBSITEID_Metrics;
@@ -384,6 +390,14 @@ export declare class API {
     /** @group Reports endpoints */
     readonly getReportsRevenue: typeof Reports.postRevenue;
     /** @group Reports endpoints */
+    readonly getReportsRevenueChart: typeof Reports.getRevenueChart;
+    /** @group Reports endpoints */
+    readonly getReportsRevenueStats: typeof Reports.getRevenueStats;
+    /** @group Reports endpoints */
+    readonly getReportsRevenueMetrics: typeof Reports.getRevenueMetrics;
+    /** @group Reports endpoints */
+    readonly getReportsRevenueSessions: typeof Reports.getRevenueSessions;
+    /** @group Reports endpoints */
     readonly getReportsUTM: typeof Reports.postUTM;
     /** @group Sessions endpoints */
     readonly getWebsiteSessions: typeof Sessions.get_WEBSITEID_Sessions;
@@ -401,6 +415,10 @@ export declare class API {
     readonly getWebsiteSessionDataProperties: typeof Sessions.get_WEBSITEID_SessiondataProperties;
     /** @group Sessions endpoints */
     readonly getWebsiteSessionDataValues: typeof Sessions.get_WEBSITEID_SessiondataValues;
+    /** @group Sessions endpoints */
+    readonly getWebsiteSessionDataPivoted: typeof Sessions.get_WEBSITEID_SessiondataPivot;
+    /** @group Sessions endpoints */
+    readonly getWebsiteSessionDataStats: typeof Sessions.get_WEBSITEID_SessiondataStats;
     /** @group Share endpoints */
     readonly createShare: typeof Share.post;
     /** @group Share endpoints */
@@ -446,7 +464,7 @@ export declare class API {
     /** @group Users endpoints */
     readonly deleteUser: typeof Users.delete_USERID;
     /** @group Users endpoints */
-    readonly getUserTeams: typeof Users.get_USERID_Teams;
-    /** @group Users endpoints */
     readonly getUserWebsites: typeof Users.get_USERID_Websites;
+    /** @group Users endpoints */
+    readonly getUserTeams: typeof Users.get_USERID_Teams;
 }

package/dist/index.js

@@ -489,7 +489,7 @@ export class API {
             this.log(true, `Will request again in ${this.retry_delay} seconds...`, `(retry #${info.number_try}/${this.retry_maximum_amount})`, request_id);
             await new Promise((res) => setTimeout(res, this.retry_delay * 1000));
             if (response) {
-                void response.text(); // Consume the response to avoid connection pool exhaustion
+                await response.text(); // Consume the response to avoid connection pool exhaustion, needs to be awaited
             }
             return await this.fetch(is_token_related, method, endpoint, parameters, {
                 number_try: info.number_try + 1,
@@ -570,6 +570,8 @@ export class API {
     getWebsiteEventsDataValues = Events.get_WEBSITEID_EventdataValues;
     /** @group Events endpoints */
     getWebsiteEventsDataStats = Events.get_WEBSITEID_EventdataStats;
+    /** @group Events endpoints */
+    getWebsiteEventsDataPivoted = Events.get_WEBSITEID_EventdataPivot;
     // LINKS
     /** @group Links endpoints */
     getLinks = Links.get;
@@ -612,10 +614,14 @@ export class API {
     deleteWebsite = Websites.delete_WEBSITEID;
     /** @group Websites endpoints */
     resetWebsite = Websites.post_WEBSITEID_Reset;
+    /** @group Websites endpoints */
+    getWebsiteRecorder = Websites.getRecorder;
     // WEBSITE STATS
     /** @group Website stats endpoints */
     getWebsiteActiveVisitors = WebsiteStats.get_WEBSITEID_Active;
     /** @group Website stats endpoints */
+    getWebsiteDateRange = WebsiteStats.get_WEBSITEID_DateRange;
+    /** @group Website stats endpoints */
     getWebsiteEventsStats = WebsiteStats.get_WEBSITEID_EventsSeries;
     /** @group Website stats endpoints */
     getWebsiteMetrics = WebsiteStats.get_WEBSITEID_Metrics;
@@ -654,6 +660,14 @@ export class API {
     /** @group Reports endpoints */
     getReportsRevenue = Reports.postRevenue;
     /** @group Reports endpoints */
+    getReportsRevenueChart = Reports.getRevenueChart;
+    /** @group Reports endpoints */
+    getReportsRevenueStats = Reports.getRevenueStats;
+    /** @group Reports endpoints */
+    getReportsRevenueMetrics = Reports.getRevenueMetrics;
+    /** @group Reports endpoints */
+    getReportsRevenueSessions = Reports.getRevenueSessions;
+    /** @group Reports endpoints */
     getReportsUTM = Reports.postUTM;
     // SESSIONS
     /** @group Sessions endpoints */
@@ -672,6 +686,10 @@ export class API {
     getWebsiteSessionDataProperties = Sessions.get_WEBSITEID_SessiondataProperties;
     /** @group Sessions endpoints */
     getWebsiteSessionDataValues = Sessions.get_WEBSITEID_SessiondataValues;
+    /** @group Sessions endpoints */
+    getWebsiteSessionDataPivoted = Sessions.get_WEBSITEID_SessiondataPivot;
+    /** @group Sessions endpoints */
+    getWebsiteSessionDataStats = Sessions.get_WEBSITEID_SessiondataStats;
     // SHARE
     /** @group Share endpoints */
     createShare = Share.post;
@@ -720,7 +738,7 @@ export class API {
     /** @group Users endpoints */
     deleteUser = Users.delete_USERID;
     /** @group Users endpoints */
-    getUserTeams = Users.get_USERID_Teams;
-    /** @group Users endpoints */
     getUserWebsites = Users.get_USERID_Websites;
+    /** @group Users endpoints */
+    getUserTeams = Users.get_USERID_Teams;
 }

package/dist/namespaces/Events.d.ts

@@ -43,7 +43,6 @@ export declare namespace Events {
     /** Gets event-data for a individual event: https://umami.is/docs/api/events#get-apiwebsiteswebsiteidevent-dataeventid */
     function get_WEBSITEID_Eventdata_EVENTID(this: API, websiteId: Websites.Website["id"], eventId: Event["id"]): Promise<Data[]>;
     interface DataMultiple {
-        eventName: Event["eventName"];
         propertyName: string;
         dataType: number;
         propertyValue: string | number;
@@ -63,7 +62,8 @@ export declare namespace Events {
     interface DataFields {
         propertyName: string;
         dataType: number;
-        value: string;
+        /** @remarks Seems to have become optional or deleted since Umami v3.2.0 */
+        value?: string;
         total: number;
     }
     /** Gets event data property and value counts within a given time range: https://umami.is/docs/api/events#get-apiwebsiteswebsiteidevent-datafields */
@@ -104,4 +104,20 @@ export declare namespace Events {
         /** Can accept filter parameters */
         filters?: Filters;
     }): Promise<DataStats>;
+    interface DataPivot {
+        eventId: Event["id"];
+        sessionId: Sessions.Session["id"];
+        eventName: Event["eventName"];
+        urlPath: string;
+        createdAt: Date;
+        propertyKeys: string[];
+        propertyValues: (string | number)[];
+    }
+    /** Gets event data for a website in a pivoted format, with each row representing an event and its properties as parallel arrays: https://docs.umami.is/docs/api/events#get-apiwebsiteswebsiteidevent-data-pivot */
+    function get_WEBSITEID_EventdataPivot(this: API, websiteId: Websites.Website["id"], parameters: Timestamps & Exclude<GenericRequestParameters, "search"> & {
+        /** Event name to pivot on */
+        eventName: Event["eventName"];
+        /** Can accept filter parameters */
+        filters?: Filters;
+    }): Promise<DataPivot[]>;
 }

package/dist/namespaces/Events.js

@@ -46,4 +46,10 @@ export var Events;
         return await this.request("get", ["websites", websiteId, "event-data", "stats"], parameters);
     }
     Events.get_WEBSITEID_EventdataStats = get_WEBSITEID_EventdataStats;
+    /** Gets event data for a website in a pivoted format, with each row representing an event and its properties as parallel arrays: https://docs.umami.is/docs/api/events#get-apiwebsiteswebsiteidevent-data-pivot */
+    async function get_WEBSITEID_EventdataPivot(websiteId, parameters) {
+        const response = await this.request("get", ["websites", websiteId, "event-data-pivot"], parameters);
+        return response.data;
+    }
+    Events.get_WEBSITEID_EventdataPivot = get_WEBSITEID_EventdataPivot;
 })(Events || (Events = {}));

package/dist/namespaces/Reports.d.ts

@@ -1,5 +1,5 @@
-import { API, DeletionResult, Filters, GenericRequestParameters, NameValue, Users, Websites, XTY } from "../index.js";
-/** Using reports throught [sic] the api: https://umami.is/docs/api/reports */
+import { API, DeletionResult, Filters, GenericRequestParameters, NameValue, Sessions, Timestamps, Users, Websites, XTY } from "../index.js";
+/** Using reports through the api: https://docs.umami.is/docs/api/reports */
 export declare namespace Reports {
     interface Report {
         id: string;
@@ -15,8 +15,8 @@ export declare namespace Reports {
         createdAt: Date;
         updatedAt: Date;
     }
-    /** The Reports endpoints use `startDate` instead of `startAt`, and `endDate` instead of `endAt` */
-    interface Timestamps {
+    /** Many of the Reports endpoints use `startDate` instead of `startAt`, and `endDate` instead of `endAt` */
+    interface DateTimestamps {
         /** Timestamp of starting date */
         startDate: Date | number;
         /** Timestamp of end date */
@@ -70,7 +70,7 @@ export declare namespace Reports {
         };
     }
     /** See how users engage with your marketing and what drives conversions: https://umami.is/docs/api/reports#post-apireportsattribution */
-    function postAttribution(this: API, websiteId: Websites.Website["id"], parameters: Timestamps & {
+    function postAttribution(this: API, websiteId: Websites.Website["id"], parameters: DateTimestamps & {
         /** Can accept filter parameters */
         filters?: Filters;
         /** Attribution model */
@@ -90,7 +90,7 @@ export declare namespace Reports {
         country: string;
     }
     /** Dive deeper into your data by using segments and filters: https://umami.is/docs/api/reports#post-apireportsbreakdown */
-    function postBreakdown(this: API, websiteId: Websites.Website["id"], parameters: Timestamps & {
+    function postBreakdown(this: API, websiteId: Websites.Website["id"], parameters: DateTimestamps & {
         /** Can accept filter parameters */
         filters?: Filters;
         /** List of column fields */
@@ -106,7 +106,7 @@ export declare namespace Reports {
         remaining: number | null;
     }
     /** Understand the conversion and drop-off rate of users: https://umami.is/docs/api/reports#post-apireportsfunnel */
-    function postFunnel(this: API, websiteId: Websites.Website["id"], parameters: Timestamps & {
+    function postFunnel(this: API, websiteId: Websites.Website["id"], parameters: DateTimestamps & {
         /** Can accept filter parameters */
         filters?: Filters;
         /** Type of event and conversion step */
@@ -125,7 +125,7 @@ export declare namespace Reports {
      * Track your goals for pageviews and events: https://umami.is/docs/api/reports#post-apireportsgoals
      * @remarks Here be dragons: I have no idea how to use this endpoint without it returning a client/server error, my apologies - The package developer
      */
-    function postGoals(this: API, websiteId: Websites.Website["id"], parameters: Timestamps & {
+    function postGoals(this: API, websiteId: Websites.Website["id"], parameters: DateTimestamps & {
         /** Can accept filter parameters */
         filters?: Filters;
         /** Conversion type */
@@ -143,8 +143,8 @@ export declare namespace Reports {
         items: (string | null)[];
         count: number;
     }
-    /** Understand how users nagivate [sic] through your website: https://umami.is/docs/api/reports#post-apireportsjourney */
-    function postJourney(this: API, websiteId: Websites.Website["id"], parameters: Timestamps & {
+    /** Understand how users navigate through your website: https://docs.umami.is/docs/api/reports#post-apireportsjourney */
+    function postJourney(this: API, websiteId: Websites.Website["id"], parameters: DateTimestamps & {
         /** Can accept filter parameters */
         filters?: Filters;
         /** Number of steps from 3 to 7 */
@@ -162,24 +162,38 @@ export declare namespace Reports {
         percentage: number;
     }
     /** Measure your website stickiness by tracking how often users return: https://umami.is/docs/api/reports#post-apireportsretention */
-    function postRetention(this: API, websiteId: Websites.Website["id"], parameters: Timestamps & {
+    function postRetention(this: API, websiteId: Websites.Website["id"], parameters: DateTimestamps & {
         /** Can accept filter parameters */
         filters?: Filters;
         /** Timezone (ex. America/Los_Angeles) */
         timezone: string;
     }): Promise<Retention[]>;
+    interface RevenueChart extends XTY {
+        count: number;
+    }
+    interface RevenueStats {
+        sum: number | null;
+        count: number;
+        unique_count: number;
+        total_sessions: number;
+        average: number;
+        arpu: number;
+    }
+    interface RevenueStatsWithComparison extends RevenueStats {
+        comparison: RevenueStats;
+    }
     interface Revenue {
-        chart: XTY[];
+        chart: RevenueChart[];
+        total: RevenueStatsWithComparison;
         country: NameValue[];
-        total: {
-            sum: number | null;
-            count: number;
-            unique_count: number;
-            average: number;
-        };
+        region: (NameValue & {
+            country: string;
+        })[];
+        referrer: NameValue[];
+        channel: NameValue[];
     }
     /** Get currency for given range. Needed for Revenue and optional in Attribution reports: https://umami.is/docs/api/reports#post-apireportsrevenue */
-    function postRevenue(this: API, websiteId: Websites.Website["id"], parameters: Timestamps & {
+    function postRevenue(this: API, websiteId: Websites.Website["id"], parameters: DateTimestamps & {
         /** Can accept filter parameters */
         filters?: Filters;
         /** Timezone (ex. America/Los_Angeles) */
@@ -187,6 +201,43 @@ export declare namespace Reports {
         /** Currency code (ISO 4217) */
         currency: string;
     }): Promise<Revenue>;
+    /** Returns revenue chart data for a given date range and currency: https://docs.umami.is/docs/api/reports#get-apiwebsiteswebsiteidrevenuechart */
+    function getRevenueChart(this: API, websiteId: Websites.Website["id"], parameters: Timestamps & {
+        /** Timezone (ex. America/Los_Angeles) */
+        timezone: string;
+        /** Currency code (ISO 4217) */
+        currency: string;
+        /** Comparison period */
+        compare?: "prev" | "yoy";
+    }): Promise<RevenueChart[]>;
+    /** Returns revenue statistics for a given date range with optional comparison period: https://docs.umami.is/docs/api/reports#get-apiwebsiteswebsiteidrevenuestats */
+    function getRevenueStats(this: API, websiteId: Websites.Website["id"], parameters: Timestamps & {
+        /** Timezone (ex. America/Los_Angeles) */
+        timezone: string;
+        /** Currency code (ISO 4217) */
+        currency: string;
+        /** Comparison period */
+        compare?: "prev" | "yoy";
+    }): Promise<RevenueStatsWithComparison>;
+    /** Returns revenue broken down by a specified dimension: https://docs.umami.is/docs/api/reports#get-apiwebsiteswebsiteidrevenuemetrics */
+    function getRevenueMetrics(this: API, websiteId: Websites.Website["id"], parameters: Timestamps & {
+        /** Timezone (ex. America/Los_Angeles) */
+        timezone: string;
+        /** Breakdown type */
+        type: "country" | "region" | "referrer" | "channel";
+        /** Currency code (ISO 4217) */
+        currency: string;
+    }): Promise<any> /** TODO screw this lol */;
+    interface RevenueSession extends Sessions.SessionWithHostnameCreatedate {
+        events: number;
+    }
+    /** Returns a paginated list of sessions with revenue data: https://docs.umami.is/docs/api/reports#get-apiwebsiteswebsiteidrevenuesessions */
+    function getRevenueSessions(this: API, websiteId: Websites.Website["id"], parameters: Timestamps & GenericRequestParameters & {
+        /** Timezone (ex. America/Los_Angeles) */
+        timezone: string;
+        /** Currency code (ISO 4217) */
+        currency: string;
+    }): Promise<RevenueSession[]>;
     interface UTMProperty {
         utm: string;
         views: number;
@@ -199,7 +250,7 @@ export declare namespace Reports {
         utm_content: UTMProperty[];
     }
     /** Track your campaigns through UTM parameters: https://umami.is/docs/api/reports#post-apireportsutm */
-    function postUTM(this: API, websiteId: Websites.Website["id"], parameters: Timestamps & {
+    function postUTM(this: API, websiteId: Websites.Website["id"], parameters: DateTimestamps & {
         /** Can accept filter parameters */
         filters?: Filters;
     }): Promise<UTM>;

package/dist/namespaces/Reports.js

@@ -1,4 +1,4 @@
-/** Using reports throught [sic] the api: https://umami.is/docs/api/reports */
+/** Using reports through the api: https://docs.umami.is/docs/api/reports */
 export var Reports;
 (function (Reports) {
     /** Get all reports by website ID: https://umami.is/docs/api/reports#get-apireports */
@@ -87,7 +87,7 @@ export var Reports;
         }, parameters.name);
     }
     Reports.postGoals = postGoals;
-    /** Understand how users nagivate [sic] through your website: https://umami.is/docs/api/reports#post-apireportsjourney */
+    /** Understand how users navigate through your website: https://docs.umami.is/docs/api/reports#post-apireportsjourney */
     async function postJourney(websiteId, parameters) {
         return await postNonReports(this, "journey", websiteId, parameters.filters, {
             startDate: parameters.startDate,
@@ -117,6 +117,28 @@ export var Reports;
         });
     }
     Reports.postRevenue = postRevenue;
+    /** Returns revenue chart data for a given date range and currency: https://docs.umami.is/docs/api/reports#get-apiwebsiteswebsiteidrevenuechart */
+    async function getRevenueChart(websiteId, parameters) {
+        const response = await this.request("get", ["websites", websiteId, "revenue", "chart"], parameters);
+        return response.chart;
+    }
+    Reports.getRevenueChart = getRevenueChart;
+    /** Returns revenue statistics for a given date range with optional comparison period: https://docs.umami.is/docs/api/reports#get-apiwebsiteswebsiteidrevenuestats */
+    async function getRevenueStats(websiteId, parameters) {
+        return await this.request("get", ["websites", websiteId, "revenue", "stats"], parameters);
+    }
+    Reports.getRevenueStats = getRevenueStats;
+    /** Returns revenue broken down by a specified dimension: https://docs.umami.is/docs/api/reports#get-apiwebsiteswebsiteidrevenuemetrics */
+    async function getRevenueMetrics(websiteId, parameters) {
+        return await this.request("get", ["websites", websiteId, "revenue", "metrics"], parameters);
+    }
+    Reports.getRevenueMetrics = getRevenueMetrics;
+    /** Returns a paginated list of sessions with revenue data: https://docs.umami.is/docs/api/reports#get-apiwebsiteswebsiteidrevenuesessions */
+    async function getRevenueSessions(websiteId, parameters) {
+        const response = await this.request("get", ["websites", websiteId, "revenue", "sessions"], parameters);
+        return response.data;
+    }
+    Reports.getRevenueSessions = getRevenueSessions;
     /** Track your campaigns through UTM parameters: https://umami.is/docs/api/reports#post-apireportsutm */
     async function postUTM(websiteId, parameters) {
         return await postNonReports(this, "utm", websiteId, parameters.filters, {

package/dist/namespaces/Sessions.d.ts

@@ -120,4 +120,33 @@ export declare namespace Sessions {
         /** Can accept filter parameters */
         filters?: Filters;
     }): Promise<DataValues[]>;
+    interface DataPivot {
+        sessionId: Session["id"];
+        distinctId: string | null;
+        createdAt: Date;
+        propertyKeys: string[];
+        propertyValues: (string | number)[];
+    }
+    /** Gets session data in a pivoted format, with each row representing a session and its properties as parallel arrays: https://docs.umami.is/docs/api/sessions#get-apiwebsiteswebsiteidsession-data-pivot */
+    function get_WEBSITEID_SessiondataPivot(this: API, websiteId: Websites.Website["id"], parameters: Timestamps & Exclude<GenericRequestParameters, "search"> & {
+        /** Session property name to pivot on */
+        propertyName: string;
+        /** Can accept filter parameters */
+        filters?: Filters;
+    }): Promise<DataPivot[]>;
+    interface DataStats {
+        label: string;
+        activity: number;
+        sessions: number;
+        visits: number;
+        views: number;
+        events: number;
+    }
+    /** Gets aggregated activity statistics for sessions grouped by a given property value: https://docs.umami.is/docs/api/sessions#get-apiwebsiteswebsiteidsession-datastats */
+    function get_WEBSITEID_SessiondataStats(this: API, websiteId: Websites.Website["id"], parameters: Timestamps & {
+        /** Property name to group by */
+        propertyName: string;
+        /** Can accept filter parameters */
+        filters?: Filters;
+    }): Promise<DataStats[]>;
 }

package/dist/namespaces/Sessions.js

@@ -57,4 +57,15 @@ export var Sessions;
         return await this.request("get", ["websites", websiteId, "session-data", "values"], parameters);
     }
     Sessions.get_WEBSITEID_SessiondataValues = get_WEBSITEID_SessiondataValues;
+    /** Gets session data in a pivoted format, with each row representing a session and its properties as parallel arrays: https://docs.umami.is/docs/api/sessions#get-apiwebsiteswebsiteidsession-data-pivot */
+    async function get_WEBSITEID_SessiondataPivot(websiteId, parameters) {
+        const response = await this.request("get", ["websites", websiteId, "session-data-pivot"], parameters);
+        return response.data;
+    }
+    Sessions.get_WEBSITEID_SessiondataPivot = get_WEBSITEID_SessiondataPivot;
+    /** Gets aggregated activity statistics for sessions grouped by a given property value: https://docs.umami.is/docs/api/sessions#get-apiwebsiteswebsiteidsession-datastats */
+    async function get_WEBSITEID_SessiondataStats(websiteId, parameters) {
+        return await this.request("get", ["websites", websiteId, "session-data", "stats"], parameters);
+    }
+    Sessions.get_WEBSITEID_SessiondataStats = get_WEBSITEID_SessiondataStats;
 })(Sessions || (Sessions = {}));

package/dist/namespaces/WebsiteStats.d.ts

@@ -36,6 +36,13 @@ export declare namespace WebsiteStats {
     }
     /** Gets the number of active users on a website: https://umami.is/docs/api/website-stats#get-apiwebsiteswebsiteidactive */
     function get_WEBSITEID_Active(this: API, websiteId: Websites.Website["id"]): Promise<Active>;
+    /** @remarks Don't confuse with {@link Timestamps}, where the word "At" is used over "Date"! */
+    interface DateRange {
+        startDate: Date;
+        endDate: Date;
+    }
+    /** Gets the date range of available data for a website: https://docs.umami.is/docs/api/website-stats#get-apiwebsiteswebsiteiddaterange */
+    function get_WEBSITEID_DateRange(this: API, websiteId: Websites.Website["id"]): Promise<DateRange>;
     /** Gets events within a given time range: https://umami.is/docs/api/website-stats#get-apiwebsiteswebsiteideventsseries */
     function get_WEBSITEID_EventsSeries(this: API, websiteId: Websites.Website["id"], parameters: Timestamps & Units & {
         /** Can accept filter parameters */
@@ -86,8 +93,8 @@ export declare namespace WebsiteStats {
     function get_WEBSITEID_Pageviews(this: API, websiteId: Websites.Website["id"], parameters: Timestamps & Units & {
         /** Timezone (ex. America/Los_Angeles) */
         timezone: string;
-        /** Comparison value `prev` | `yoy` */
-        compare?: string;
+        /** Comparison period */
+        compare?: "prev" | "yoy";
         /** Can accept filter parameters */
         filters?: Filters;
     }): Promise<Pageviews>;

package/dist/namespaces/WebsiteStats.js

@@ -6,6 +6,11 @@ export var WebsiteStats;
         return await this.request("get", ["websites", websiteId, "active"]);
     }
     WebsiteStats.get_WEBSITEID_Active = get_WEBSITEID_Active;
+    /** Gets the date range of available data for a website: https://docs.umami.is/docs/api/website-stats#get-apiwebsiteswebsiteiddaterange */
+    async function get_WEBSITEID_DateRange(websiteId) {
+        return await this.request("get", ["websites", websiteId, "daterange"]);
+    }
+    WebsiteStats.get_WEBSITEID_DateRange = get_WEBSITEID_DateRange;
     /** Gets events within a given time range: https://umami.is/docs/api/website-stats#get-apiwebsiteswebsiteideventsseries */
     async function get_WEBSITEID_EventsSeries(websiteId, parameters) {
         return await this.request("get", ["websites", websiteId, "events", "series"], parameters);

package/dist/namespaces/Websites.d.ts

@@ -59,4 +59,18 @@ export declare namespace Websites {
     function delete_WEBSITEID(this: API, websiteId: Website["id"]): Promise<DeletionResult>;
     /** Resets a website by removing all data related to the website: https://umami.is/docs/api/websites#post-apiwebsiteswebsiteidreset */
     function post_WEBSITEID_Reset(this: API, websiteId: Website["id"]): Promise<DeletionResult>;
+    type Recorder = {
+        enabled: false;
+    } | {
+        enabled: true;
+        replayEnabled: boolean;
+        heatmapEnabled: boolean;
+        sampleRate: number;
+        heatmapSampleRate: number;
+        maskLevel: "strict" | "moderate";
+        maxDuration: number;
+        blockSelector: string;
+    };
+    /** Returns the recorder configuration for a website: https://docs.umami.is/docs/api/websites#get-apiwebsiteswebsiteidrecorder */
+    function getRecorder(this: API, websiteId: Website["id"]): Promise<Recorder>;
 }

package/dist/namespaces/Websites.js

@@ -32,4 +32,9 @@ export var Websites;
         return await this.request("post", ["websites", websiteId, "reset"]);
     }
     Websites.post_WEBSITEID_Reset = post_WEBSITEID_Reset;
+    /** Returns the recorder configuration for a website: https://docs.umami.is/docs/api/websites#get-apiwebsiteswebsiteidrecorder */
+    async function getRecorder(websiteId) {
+        return await this.request("get", ["websites", websiteId, "recorder"]);
+    }
+    Websites.getRecorder = getRecorder;
 })(Websites || (Websites = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "umami-api-js",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Package to easily access the Umami api!",
   "type": "module",
   "main": "dist/index.js",
@@ -31,11 +31,11 @@
   "license": "Unlicense",
   "devDependencies": {
     "@types/chai": "^5.2.3",
-    "@types/node": "^25.6.0",
+    "@types/node": "^26.0.1",
     "ajv": "^8.20.0",
     "chai": "^6.2.2",
     "dotenv": "^17.4.2",
-    "prettier": "3.8.3",
+    "prettier": "3.9.1",
     "ts-json-schema-generator": "^2.9.0",
     "typedoc": "^0.28.19",
     "typescript": "^6.0.3"