umami-api-js 1.0.1 → 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

@@ -6,11 +6,12 @@ import { Pixels } from "./namespaces/Pixels.js";
 import { Realtime } from "./namespaces/Realtime.js";
 import { Reports } from "./namespaces/Reports.js";
 import { Sessions } from "./namespaces/Sessions.js";
+import { Share } from "./namespaces/Share.js";
 import { Teams } from "./namespaces/Teams.js";
 import { Users } from "./namespaces/Users.js";
 import { Websites } from "./namespaces/Websites.js";
 import { WebsiteStats } from "./namespaces/WebsiteStats.js";
-export { Admin, Events, Links, Me, Pixels, Websites, WebsiteStats, Realtime, Reports, Sessions, Teams, Users, };
+export { Admin, Events, Links, Me, Pixels, Websites, WebsiteStats, Realtime, Reports, Sessions, Share, Teams, Users, };
 export interface DeletionResult {
     ok: boolean;
 }
@@ -157,8 +158,8 @@ export declare class API {
     });
     private _user;
     /** Information about the account that has been used to log in */
-    get user(): Users.User;
-    set user(user: Users.User);
+    get user(): Users.UserWithTeams;
+    set user(user: Users.UserWithTeams);
     private number_of_requests;
     /** Has {@link API.setNewToken} been called and not yet returned anything? */
     private is_setting_token;
@@ -192,8 +193,8 @@ export declare class API {
     private updateTokenTimer;
     private _verbose?;
     /** Which events should be logged (defaults to **none**) */
-    get verbose(): "none" | "errors" | "all" | undefined;
-    set verbose(verbose: "none" | "errors" | "all" | undefined);
+    get verbose(): "all" | "none" | "errors" | undefined;
+    set verbose(verbose: "all" | "none" | "errors" | undefined);
     private _timeout;
     /**
      * The maximum **amount of seconds** requests should take before returning an answer (defaults to **20**)
@@ -306,9 +307,13 @@ 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 */
+    readonly createLink: typeof Links.post;
+    /** @group Links endpoints */
     readonly getLink: typeof Links.get_LINKID;
     /** @group Links endpoints */
     readonly updateLink: typeof Links.post_LINKID;
@@ -320,13 +325,15 @@ export declare class API {
     readonly getMyTeams: typeof Me.getTeams;
     /** @group Me endpoints */
     readonly getMyWebsites: typeof Me.getWebsites;
-    /** @group Links endpoints */
+    /** @group Pixels endpoints */
     readonly getPixels: typeof Pixels.get;
-    /** @group Links endpoints */
+    /** @group Pixels endpoints */
+    readonly createPixel: typeof Pixels.post;
+    /** @group Pixels endpoints */
     readonly getPixel: typeof Pixels.get_PIXELID;
-    /** @group Links endpoints */
+    /** @group Pixels endpoints */
     readonly updatePixel: typeof Pixels.post_PIXELID;
-    /** @group Links endpoints */
+    /** @group Pixels endpoints */
     readonly deletePixel: typeof Pixels.delete_PIXELID;
     /** @group Websites endpoints */
     readonly getWebsites: typeof Websites.get;
@@ -340,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;
@@ -379,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;
@@ -396,6 +415,22 @@ 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 */
+    readonly getShare: typeof Share.get_SHAREID;
+    /** @group Share endpoints */
+    readonly updateShare: typeof Share.post_SHAREID;
+    /** @group Share endpoints */
+    readonly deleteShare: typeof Share.delete_SHAREID;
+    /** @group Share endpoints */
+    readonly getWebsiteShares: typeof Share.get_WEBSITEID_Shares;
+    /** @group Share endpoints */
+    readonly createWebsiteShare: typeof Share.post_WEBSITEID_Shares;
     /** @group Teams endpoints */
     readonly getTeams: typeof Teams.get;
     /** @group Teams endpoints */
@@ -429,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

@@ -6,12 +6,13 @@ import { Pixels } from "./namespaces/Pixels.js";
 import { Realtime } from "./namespaces/Realtime.js";
 import { Reports } from "./namespaces/Reports.js";
 import { Sessions } from "./namespaces/Sessions.js";
+import { Share } from "./namespaces/Share.js";
 import { Teams } from "./namespaces/Teams.js";
 import { Users } from "./namespaces/Users.js";
 import { Websites } from "./namespaces/Websites.js";
 import { WebsiteStats } from "./namespaces/WebsiteStats.js";
 import { adaptParametersForGETRequests, correctType } from "./utilities.js";
-export { Admin, Events, Links, Me, Pixels, Websites, WebsiteStats, Realtime, Reports, Sessions, Teams, Users, };
+export { Admin, Events, Links, Me, Pixels, Websites, WebsiteStats, Realtime, Reports, Sessions, Share, Teams, Users, };
 /** If the {@link API} throws an error, it should always be an {@link APIError}! */
 export class APIError extends Error {
     message;
@@ -173,12 +174,14 @@ export class API {
         role: "view-only",
         createdAt: new Date(),
         isAdmin: false,
+        teams: [],
     };
     /** Information about the account that has been used to log in */
     get user() {
         return this._user;
     }
     set user(user) {
+        user.createdAt = new Date(user.createdAt);
         this._user = user;
     }
     number_of_requests = 0;
@@ -428,6 +431,10 @@ export class API {
                     })
                         .join("&");
         }
+        const headers = new Headers(this.headers);
+        if (!is_token_related) {
+            headers.append("Authorization", `${this.token_type} ${this.token}`);
+        }
         const signals = [];
         if (this.timeout > 0)
             signals.push(AbortSignal.timeout(this.timeout * 1000));
@@ -435,12 +442,7 @@ export class API {
             signals.push(this.signal);
         const response = await fetch(url, {
             method,
-            headers: {
-                Authorization: is_token_related
-                    ? undefined
-                    : `${this.token_type} ${this.token}`,
-                ...this.headers,
-            },
+            headers,
             body: method !== "get" ? JSON.stringify(parameters) : undefined, // parameters are here if method is NOT GET
             signal: AbortSignal.any(signals),
         })
@@ -486,6 +488,9 @@ export class API {
         if (to_retry === true && info.number_try <= this.retry_maximum_amount) {
             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) {
+                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,
                 has_new_token: info.has_new_token,
@@ -512,9 +517,7 @@ export class API {
     async request(method, endpoint, parameters = {}) {
         try {
             const response = await this.fetch(false, method, endpoint, parameters);
-            if (response.status === 204)
-                return undefined; // 204 means the request worked as intended and did not give us anything, so just return nothing
-            const arrBuff = await response.arrayBuffer();
+            const arrBuff = await response.arrayBuffer(); // note: immediately consume the response to prevent connection pool leaks
             const buff = Buffer.from(arrBuff);
             try {
                 // Assume the response is in JSON format as it often is, it'll fail into the catch block if it isn't anyway
@@ -567,10 +570,14 @@ 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;
     /** @group Links endpoints */
+    createLink = Links.post;
+    /** @group Links endpoints */
     getLink = Links.get_LINKID;
     /** @group Links endpoints */
     updateLink = Links.post_LINKID;
@@ -584,13 +591,15 @@ export class API {
     /** @group Me endpoints */
     getMyWebsites = Me.getWebsites;
     // PIXELS
-    /** @group Links endpoints */
+    /** @group Pixels endpoints */
     getPixels = Pixels.get;
-    /** @group Links endpoints */
+    /** @group Pixels endpoints */
+    createPixel = Pixels.post;
+    /** @group Pixels endpoints */
     getPixel = Pixels.get_PIXELID;
-    /** @group Links endpoints */
+    /** @group Pixels endpoints */
     updatePixel = Pixels.post_PIXELID;
-    /** @group Links endpoints */
+    /** @group Pixels endpoints */
     deletePixel = Pixels.delete_PIXELID;
     // WEBSITES
     /** @group Websites endpoints */
@@ -605,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;
@@ -647,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 */
@@ -665,6 +686,23 @@ 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;
+    /** @group Share endpoints */
+    getShare = Share.get_SHAREID;
+    /** @group Share endpoints */
+    updateShare = Share.post_SHAREID;
+    /** @group Share endpoints */
+    deleteShare = Share.delete_SHAREID;
+    /** @group Share endpoints */
+    getWebsiteShares = Share.get_WEBSITEID_Shares;
+    /** @group Share endpoints */
+    createWebsiteShare = Share.post_WEBSITEID_Shares;
     // TEAMS
     /** @group Teams endpoints */
     getTeams = Teams.get;
@@ -700,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/Links.d.ts

@@ -1,4 +1,4 @@
-import { API, DeletionResult, GenericRequestParameters, Users } from "../index.js";
+import { API, DeletionResult, GenericRequestParameters, Teams, Users } from "../index.js";
 /** Operations around Links management: https://umami.is/docs/api/links */
 export declare namespace Links {
     interface Link {
@@ -14,6 +14,17 @@ export declare namespace Links {
     }
     /** Returns all user links: https://umami.is/docs/api/links#get-apilinks */
     function get(this: API, parameters?: GenericRequestParameters): Promise<Link[]>;
+    /** Creates a link: https://docs.umami.is/docs/api/links#post-apilinks */
+    function post(this: API, parameters: {
+        /** The link's name */
+        name: Link["name"];
+        /** The link's destination URL */
+        url: Link["url"];
+        /** The link's URL slug, **with a minimum of 8 characters** */
+        slug: Link["slug"];
+        /** The ID of the team the link will be created under */
+        teamId?: Teams.Team["id"];
+    }): Promise<Link>;
     /** Gets a link by ID: https://umami.is/docs/api/links#get-apilinkslinkid */
     function get_LINKID(this: API, linkId: Link["id"]): Promise<Link>;
     /** Updates a link: https://umami.is/docs/api/links#post-apilinkslinkid */

package/dist/namespaces/Links.js

@@ -7,6 +7,11 @@ export var Links;
         return response.data;
     }
     Links.get = get;
+    /** Creates a link: https://docs.umami.is/docs/api/links#post-apilinks */
+    async function post(parameters) {
+        return await this.request("post", ["links"], parameters);
+    }
+    Links.post = post;
     /** Gets a link by ID: https://umami.is/docs/api/links#get-apilinkslinkid */
     async function get_LINKID(linkId) {
         return await this.request("get", ["links", linkId]);

package/dist/namespaces/Pixels.d.ts

@@ -1,4 +1,4 @@
-import { API, DeletionResult, GenericRequestParameters, Users } from "../index.js";
+import { API, DeletionResult, GenericRequestParameters, Teams, Users } from "../index.js";
 /** Operations around Pixels management: https://umami.is/docs/api/pixels */
 export declare namespace Pixels {
     interface Pixel {
@@ -13,6 +13,15 @@ export declare namespace Pixels {
     }
     /** Returns all user pixels: https://umami.is/docs/api/pixels#get-apipixels */
     function get(this: API, parameters?: GenericRequestParameters): Promise<Pixel[]>;
+    /** Creates a pixel: https://docs.umami.is/docs/api/pixels#post-apipixels */
+    function post(this: API, parameters: {
+        /** The pixel's name */
+        name: Pixel["name"];
+        /** The pixel's URL slug, **with a minimum of 8 characters** */
+        slug: Pixel["slug"];
+        /** The ID of the team the pixel will be created under */
+        teamId?: Teams.Team["id"];
+    }): Promise<Pixel>;
     /** Gets a pixel by ID: https://umami.is/docs/api/pixels#get-apipixelspixelid */
     function get_PIXELID(this: API, pixelId: Pixel["id"]): Promise<Pixel>;
     /** Updates a pixel: https://umami.is/docs/api/pixels#post-apipixelspixelid */

package/dist/namespaces/Pixels.js

@@ -7,6 +7,11 @@ export var Pixels;
         return response.data;
     }
     Pixels.get = get;
+    /** Creates a pixel: https://docs.umami.is/docs/api/pixels#post-apipixels */
+    async function post(parameters) {
+        return await this.request("post", ["pixels"], parameters);
+    }
+    Pixels.post = post;
     /** Gets a pixel by ID: https://umami.is/docs/api/pixels#get-apipixelspixelid */
     async function get_PIXELID(pixelId) {
         return await this.request("get", ["pixels", pixelId]);

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/Share.d.ts

@@ -0,0 +1,70 @@
+import { API, DeletionResult, Websites } from "../index.js";
+/** Operations around Share page management: https://docs.umami.is/docs/api/share */
+export declare namespace Share {
+    enum ShareType {
+        website = 1,
+        link = 2,
+        pixel = 3,
+        board = 4
+    }
+    interface Share {
+        id: string;
+        entityId: string;
+        name: string;
+        shareType: ShareType;
+        slug: string;
+        parameters: Parameters;
+        createdAt: Date;
+        updatedAt: Date;
+    }
+    interface Parameters {
+        overview?: boolean;
+        events?: boolean;
+        sessions?: boolean;
+        realtime?: boolean;
+        performance?: boolean;
+        compare?: boolean;
+        breakdown?: boolean;
+        goals?: boolean;
+        funnels?: boolean;
+        journeys?: boolean;
+        retention?: boolean;
+        utm?: boolean;
+        revenue?: boolean;
+        attribution?: boolean;
+    }
+    /** Creates a share page: https://docs.umami.is/docs/api/share#post-apishare */
+    function post(this: API, parameters: {
+        /** ID of entity to be added (websiteId, pixelId, linkId, etc.) */
+        entityId: Share["entityId"];
+        shareType: ShareType;
+        /** Name of the share page */
+        name: Share["name"];
+        /** Slug of the share page */
+        slug: Share["slug"];
+        /** Parameters for share page */
+        parameters: Parameters;
+    }): Promise<Share>;
+    /** Gets a share page by ID: https://docs.umami.is/docs/api/share#get-apishareidshareid */
+    function get_SHAREID(this: API, share_id: Share["id"]): Promise<Share>;
+    /** Updates a share page: https://docs.umami.is/docs/api/share#post-apishareidshareid */
+    function post_SHAREID(this: API, share_id: Share["id"], parameters: {
+        /** Name of the share page */
+        name: Share["name"];
+        /** Slug of the share page */
+        slug: Share["slug"];
+        /** Parameters for share page */
+        parameters: Parameters;
+    }): Promise<Share>;
+    /** Deletes a share page: https://docs.umami.is/docs/api/share#delete-apishareidshareid */
+    function delete_SHAREID(this: API, share_id: Share["id"]): Promise<DeletionResult>;
+    /** Gets all share pages that belong to a website: https://docs.umami.is/docs/api/share#get-apiwebsiteswebsiteidshares */
+    function get_WEBSITEID_Shares(this: API, website_id: Websites.Website["id"]): Promise<Share[]>;
+    /** Creates a share page belonging to a website: https://docs.umami.is/docs/api/share#post-apiwebsiteswebsiteidshares */
+    function post_WEBSITEID_Shares(this: API, website_id: Websites.Website["id"], parameters: {
+        /** Name of the share page */
+        name: Share["name"];
+        /** Parameters for share page */
+        parameters: Parameters;
+    }): Promise<Share>;
+}

package/dist/namespaces/Share.js

@@ -0,0 +1,46 @@
+/** Operations around Share page management: https://docs.umami.is/docs/api/share */
+export var Share;
+(function (Share) {
+    let ShareType;
+    (function (ShareType) {
+        ShareType[ShareType["website"] = 1] = "website";
+        ShareType[ShareType["link"] = 2] = "link";
+        ShareType[ShareType["pixel"] = 3] = "pixel";
+        ShareType[ShareType["board"] = 4] = "board";
+    })(ShareType = Share.ShareType || (Share.ShareType = {}));
+    /** Creates a share page: https://docs.umami.is/docs/api/share#post-apishare */
+    async function post(parameters) {
+        return await this.request("post", ["share"], parameters);
+    }
+    Share.post = post;
+    /** Gets a share page by ID: https://docs.umami.is/docs/api/share#get-apishareidshareid */
+    async function get_SHAREID(share_id) {
+        return await this.request("get", ["share", "id", share_id]);
+    }
+    Share.get_SHAREID = get_SHAREID;
+    /** Updates a share page: https://docs.umami.is/docs/api/share#post-apishareidshareid */
+    async function post_SHAREID(share_id, parameters) {
+        return await this.request("post", ["share", "id", share_id], parameters);
+    }
+    Share.post_SHAREID = post_SHAREID;
+    /** Deletes a share page: https://docs.umami.is/docs/api/share#delete-apishareidshareid */
+    async function delete_SHAREID(share_id) {
+        return await this.request("delete", ["share", "id", share_id]);
+    }
+    Share.delete_SHAREID = delete_SHAREID;
+    /** Gets all share pages that belong to a website: https://docs.umami.is/docs/api/share#get-apiwebsiteswebsiteidshares */
+    async function get_WEBSITEID_Shares(website_id) {
+        const response = await this.request("get", [
+            "websites",
+            website_id,
+            "shares",
+        ]);
+        return response.data;
+    }
+    Share.get_WEBSITEID_Shares = get_WEBSITEID_Shares;
+    /** Creates a share page belonging to a website: https://docs.umami.is/docs/api/share#post-apiwebsiteswebsiteidshares */
+    async function post_WEBSITEID_Shares(website_id, parameters) {
+        return await this.request("post", ["websites", website_id, "shares"], parameters);
+    }
+    Share.post_WEBSITEID_Shares = post_WEBSITEID_Shares;
+})(Share || (Share = {}));

package/dist/namespaces/Teams.d.ts

@@ -1,11 +1,13 @@
 import { API, DeletionResult, GenericRequestParameters, Users, Websites } from "../index.js";
 /** Operations around Team management: https://umami.is/docs/api/teams */
 export declare namespace Teams {
-    interface Team {
+    interface MinimalTeam {
         id: string;
         name: string;
-        accessCode: string;
         logoUrl: string | null;
+    }
+    interface Team extends MinimalTeam {
+        accessCode: string;
         createdAt: Date;
         updatedAt: Date;
         deletedAt: Date | null;

package/dist/namespaces/Users.d.ts

@@ -9,15 +9,16 @@ export declare namespace Users {
     interface MinimalUserWithRole extends MinimalUser {
         role: Role;
     }
-    interface MinimalUserWithCreatedAt extends MinimalUserWithRole {
+    interface MinimalUserWithRoleCreatedAt extends MinimalUserWithRole {
         createdAt: Date;
     }
-    interface MinimalUserWithRoleCreatedAt extends MinimalUserWithRole, MinimalUserWithCreatedAt {
-    }
     interface User extends MinimalUserWithRoleCreatedAt {
         isAdmin: boolean;
     }
-    interface DetailedUser extends MinimalUserWithRole, MinimalUserWithCreatedAt {
+    interface UserWithTeams extends User {
+        teams: Teams.MinimalTeam[];
+    }
+    interface DetailedUser extends MinimalUserWithRoleCreatedAt {
         logoUrl: string | null;
         displayName: string | null;
         updatedAt: Date;

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

@@ -1,11 +1,11 @@
-import { API, DeletionResult, GenericRequestParameters, Teams, Users } from "../index.js";
+import { API, DeletionResult, GenericRequestParameters, Share, Teams, Users } from "../index.js";
 /** Operations around Website management and statistics: https://umami.is/docs/api/websites */
 export declare namespace Websites {
     interface Website {
         id: string;
         name: string;
         domain: string;
-        shareId: string | null;
+        shareId: Share.Share["id"] | null;
         resetAt: Date | null;
         /** @remarks Is null if the website is under a team (has a `teamId`) */
         userId: Users.User["id"] | null;
@@ -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.0.1",
+  "version": "1.2.0",
   "description": "Package to easily access the Umami api!",
   "type": "module",
   "main": "dist/index.js",
@@ -31,13 +31,13 @@
   "license": "Unlicense",
   "devDependencies": {
     "@types/chai": "^5.2.3",
-    "@types/node": "^24.9.2",
-    "ajv": "^8.18.0",
+    "@types/node": "^26.0.1",
+    "ajv": "^8.20.0",
     "chai": "^6.2.2",
-    "dotenv": "^17.2.3",
-    "prettier": "3.8.1",
-    "ts-json-schema-generator": "^2.4.0",
-    "typedoc": "^0.28.17",
-    "typescript": "^5.9.3"
+    "dotenv": "^17.4.2",
+    "prettier": "3.9.1",
+    "ts-json-schema-generator": "^2.9.0",
+    "typedoc": "^0.28.19",
+    "typescript": "^6.0.3"
   }
 }