trusted-set-cookie.js

import {
    hit,
    logMessage,
    nativeIsNaN,
    isCookieSetWithValue,
    serializeCookie,
    isValidCookiePath,
    parseKeywordValue,
    getTrustedCookieOffsetMs,
    getCookiePath,
} from '../helpers';

/* eslint-disable max-len */
/**
 * @trustedScriptlet trusted-set-cookie
 *
 * @description
 * Sets a cookie with arbitrary name and value,
 * and with optional ability to offset cookie attribute 'expires', set path
 * and set domain.
 *
 * ### Syntax
 *
 * ```text
 * example.org#%#//scriptlet('trusted-set-cookie', name, value[, offsetExpiresSec[, path[, domain]]])
 * ```
 *
 * - `name` — required, cookie name to be set
 * - `value` — required, cookie value. Possible values:
 *     - arbitrary value
 *     - empty string for no value
 *     - `$now$` keyword for setting current time in ms, e.g 1667915146503
 *     - `$currentDate$` keyword for setting current time as string, e.g 'Tue Nov 08 2022 13:53:19 GMT+0300'
 *     - `$currentISODate$` keyword for setting current date in the date time string format,
 *       e.g '2022-11-08T13:53:19.650Z'
 * - `offsetExpiresSec` — optional, offset from current time in seconds, after which cookie should expire;
 *   defaults to no offset. Possible values:
 *     - positive integer in seconds
 *     - `1year` keyword for setting expiration date to one year
 *     - `1day` keyword for setting expiration date to one day
 * - `path` — optional, argument for setting cookie path, defaults to `/`; possible values:
 *     - `/` — root path
 *     - `none` — to set no path at all
 * - `domain` — optional, cookie domain, if not set origin will be set as domain,
 *              if the domain does not match the origin, the cookie will not be set
 *
 * > Note that the scriptlet does not encode cookie names and values.
 * > As a result, if a cookie's name or value includes `;`,
 * > the scriptlet will not set the cookie since this may cause the cookie to break.
 *
 * ### Examples
 *
 * 1. Set cookie
 *
 *     ```adblock
 *     example.org#%#//scriptlet('trusted-set-cookie', 'cmpconsent', 'accept')
 *     example.org#%#//scriptlet('trusted-set-cookie', 'cmpconsent', '1-accept_1')
 *     ```
 *
 * 1. Set cookie with `new Date().getTime()` value
 *
 *     ```adblock
 *     example.org#%#//scriptlet('trusted-set-cookie', 'cmpconsent', '$now$')
 *     ```
 *
 * 1. Set cookie which will expire in 3 days
 *
 *     ```adblock
 *     example.org#%#//scriptlet('trusted-set-cookie', 'cmpconsent', 'accept', '259200')
 *     ```
 *
 * 1. Set cookie which will expire in one year
 *
 *     ```adblock
 *     example.org#%#//scriptlet('trusted-set-cookie', 'cmpconsent', 'accept', '1year')
 *     ```
 *
 * 1. Set cookie with no path
 *
 *     ```adblock
 *     example.org#%#//scriptlet('trusted-set-cookie', 'cmpconsent', 'decline', '', 'none')
 *
 * 1. Set cookie with domain
 *
 *     ```adblock
 *     example.org#%#//scriptlet('trusted-set-cookie', 'cmpconsent', 'decline', '', 'none', 'example.org')
 *     ```
 *
 * @added v1.7.3.
 */
/* eslint-enable max-len */

export function trustedSetCookie(source, name, value, offsetExpiresSec = '', path = '/', domain = '') {
    if (typeof name === 'undefined') {
        logMessage(source, 'Cookie name should be specified');
        return;
    }
    if (typeof value === 'undefined') {
        logMessage(source, 'Cookie value should be specified');
        return;
    }

    const parsedValue = parseKeywordValue(value);

    if (!isValidCookiePath(path)) {
        logMessage(source, `Invalid cookie path: '${path}'`);
        return;
    }

    if (!document.location.origin.includes(domain)) {
        logMessage(source, `Cookie domain not matched by origin: '${domain}'`);
        return;
    }

    let cookieToSet = serializeCookie(name, parsedValue, path, domain, false);
    if (!cookieToSet) {
        logMessage(source, 'Invalid cookie name or value');
        return;
    }

    // TODO: Move this concat to serializeCookie
    if (offsetExpiresSec) {
        const parsedOffsetMs = getTrustedCookieOffsetMs(offsetExpiresSec);

        if (!parsedOffsetMs) {
            logMessage(source, `Invalid offsetExpiresSec value: ${offsetExpiresSec}`);
            return;
        }

        const expires = Date.now() + parsedOffsetMs;
        cookieToSet += `; expires=${new Date(expires).toUTCString()}`;
    }

    document.cookie = cookieToSet;
    hit(source);
}

export const trustedSetCookieNames = [
    'trusted-set-cookie',
    // trusted scriptlets support no aliases
];

// eslint-disable-next-line prefer-destructuring
trustedSetCookie.primaryName = trustedSetCookieNames[0];

trustedSetCookie.injections = [
    hit,
    logMessage,
    nativeIsNaN,
    isCookieSetWithValue,
    serializeCookie,
    isValidCookiePath,
    getTrustedCookieOffsetMs,
    parseKeywordValue,
    getCookiePath,
];