@wordpress/e2e-test-utils-playwright 1.48.0 → 1.48.1

package/build/request-utils/rest.js

@@ -0,0 +1,181 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupRest = setupRest;
+exports.rest = rest;
+exports.getMaxBatchSize = getMaxBatchSize;
+exports.batchRest = batchRest;
+/**
+ * External dependencies
+ */
+const fs = __importStar(require("fs/promises"));
+const path_1 = require("path");
+const test_1 = require("@playwright/test");
+/**
+ * Internal dependencies
+ */
+const config_1 = require("../config");
+function splitRequestsToChunks(requests, chunkSize) {
+    const arr = [...requests];
+    const cache = [];
+    while (arr.length) {
+        cache.push(arr.splice(0, chunkSize));
+    }
+    return cache;
+}
+async function getAPIRootURL(request) {
+    // Discover the API root url using link header.
+    // See https://developer.wordpress.org/rest-api/using-the-rest-api/discovery/#link-header
+    const response = await request.head(config_1.WP_BASE_URL);
+    const links = response.headers().link;
+    const restLink = links?.match(/<([^>]+)>; rel="https:\/\/api\.w\.org\/"/);
+    if (!restLink) {
+        throw new Error(`Failed to discover REST API endpoint.
+ Link header: ${links}`);
+    }
+    const [, rootURL] = restLink;
+    return rootURL;
+}
+async function setupRest() {
+    let nonce = '';
+    let rootURL = '';
+    // Poll until the REST API is discovered.
+    // See https://github.com/WordPress/gutenberg/issues/61627
+    await test_1.expect
+        .poll(async () => {
+        try {
+            [nonce, rootURL] = await Promise.all([
+                this.login(),
+                getAPIRootURL(this.request),
+            ]);
+        }
+        catch (error) {
+            // Prints the error if the timeout is reached.
+            return error;
+        }
+        return !!(nonce && rootURL);
+    }, {
+        message: 'Failed to setup REST API.',
+        timeout: 60_000, // 1 minute.
+    })
+        .toBe(true);
+    const { cookies } = await this.request.storageState();
+    const storageState = {
+        cookies,
+        nonce,
+        rootURL,
+    };
+    if (this.storageStatePath) {
+        await fs.mkdir((0, path_1.dirname)(this.storageStatePath), { recursive: true });
+        await fs.writeFile(this.storageStatePath, JSON.stringify(storageState), 'utf-8');
+    }
+    this.storageState = storageState;
+    return storageState;
+}
+async function rest(options) {
+    const { path, ...fetchOptions } = options;
+    if (!path) {
+        throw new Error('"path" is required to make a REST call');
+    }
+    if (!this.storageState?.nonce || !this.storageState?.rootURL) {
+        await this.setupRest();
+    }
+    const relativePath = path.startsWith('/') ? path.slice(1) : path;
+    const url = this.storageState.rootURL + relativePath;
+    try {
+        const response = await this.request.fetch(url, {
+            ...fetchOptions,
+            failOnStatusCode: false,
+            headers: {
+                'X-WP-Nonce': this.storageState.nonce,
+                ...(fetchOptions.headers || {}),
+            },
+        });
+        const json = await response.json();
+        if (!response.ok()) {
+            throw json;
+        }
+        return json;
+    }
+    catch (error) {
+        // Nonce in invalid, retry again with a renewed nonce.
+        if (typeof error === 'object' &&
+            error !== null &&
+            Object.prototype.hasOwnProperty.call(error, 'code') &&
+            error.code === 'rest_cookie_invalid_nonce') {
+            await this.setupRest();
+            return this.rest(options);
+        }
+        throw error;
+    }
+}
+/**
+ * Get the maximum batch size for the REST API.
+ *
+ * @param this
+ * @param forceRefetch Force revalidate the cached max batch size.
+ */
+async function getMaxBatchSize(forceRefetch = false) {
+    if (!forceRefetch && this.maxBatchSize) {
+        return this.maxBatchSize;
+    }
+    const response = await this.rest({
+        method: 'OPTIONS',
+        path: '/batch/v1',
+    });
+    this.maxBatchSize = response.endpoints[0].args.requests.maxItems;
+    return this.maxBatchSize;
+}
+async function batchRest(requests) {
+    const maxBatchSize = await this.getMaxBatchSize();
+    if (requests.length > maxBatchSize) {
+        const chunks = splitRequestsToChunks(requests, maxBatchSize);
+        const chunkResponses = await Promise.all(chunks.map((chunkRequests) => this.batchRest(chunkRequests)));
+        return chunkResponses.flat();
+    }
+    const batchResponses = await this.rest({
+        method: 'POST',
+        path: '/batch/v1',
+        data: {
+            requests,
+            validation: 'require-all-validate',
+        },
+    });
+    if (batchResponses.failed) {
+        throw batchResponses;
+    }
+    return batchResponses.responses;
+}
+//# sourceMappingURL=rest.js.map

package/build/request-utils/rest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.js","sourceRoot":"","sources":["../../src/request-utils/rest.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6NS,8BAAS;AAAE,oBAAI;AAAE,0CAAe;AAAE,8BAAS;AA7NpD;;GAEG;AACH,gDAAkC;AAClC,+BAA+B;AAC/B,2CAA0C;AAG1C;;GAEG;AACH,sCAAwC;AAGxC,SAAS,qBAAqB,CAAE,QAAwB,EAAE,SAAiB;IAC1E,MAAM,GAAG,GAAG,CAAE,GAAG,QAAQ,CAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,EAAE,CAAC;IACjB,OAAQ,GAAG,CAAC,MAAM,EAAG,CAAC;QACrB,KAAK,CAAC,IAAI,CAAE,GAAG,CAAC,MAAM,CAAE,CAAC,EAAE,SAAS,CAAE,CAAE,CAAC;IAC1C,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AAED,KAAK,UAAU,aAAa,CAAE,OAA0B;IACvD,+CAA+C;IAC/C,yFAAyF;IACzF,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAE,oBAAW,CAAE,CAAC;IACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC;IACtC,MAAM,QAAQ,GAAG,KAAK,EAAE,KAAK,CAAE,0CAA0C,CAAE,CAAC;IAE5E,IAAK,CAAE,QAAQ,EAAG,CAAC;QAClB,MAAM,IAAI,KAAK,CAAE;gBACF,KAAM,EAAE,CAAE,CAAC;IAC3B,CAAC;IAED,MAAM,CAAE,AAAD,EAAG,OAAO,CAAE,GAAG,QAAQ,CAAC;IAE/B,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,SAAS;IACvB,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,yCAAyC;IACzC,0DAA0D;IAC1D,MAAM,aAAM;SACV,IAAI,CACJ,KAAK,IAAI,EAAE;QACV,IAAI,CAAC;YACJ,CAAE,KAAK,EAAE,OAAO,CAAE,GAAG,MAAM,OAAO,CAAC,GAAG,CAAE;gBACvC,IAAI,CAAC,KAAK,EAAE;gBACZ,aAAa,CAAE,IAAI,CAAC,OAAO,CAAE;aAC7B,CAAE,CAAC;QACL,CAAC;QAAC,OAAQ,KAAK,EAAG,CAAC;YAClB,8CAA8C;YAC9C,OAAO,KAAK,CAAC;QACd,CAAC;QAED,OAAO,CAAC,CAAE,CAAE,KAAK,IAAI,OAAO,CAAE,CAAC;IAChC,CAAC,EACD;QACC,OAAO,EAAE,2BAA2B;QACpC,OAAO,EAAE,MAAM,EAAE,YAAY;KAC7B,CACD;SACA,IAAI,CAAE,IAAI,CAAE,CAAC;IAEf,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;IAEtD,MAAM,YAAY,GAAiB;QAClC,OAAO;QACP,KAAK;QACL,OAAO;KACP,CAAC;IAEF,IAAK,IAAI,CAAC,gBAAgB,EAAG,CAAC;QAC7B,MAAM,EAAE,CAAC,KAAK,CAAE,IAAA,cAAO,EAAE,IAAI,CAAC,gBAAgB,CAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAE,CAAC;QACxE,MAAM,EAAE,CAAC,SAAS,CACjB,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,SAAS,CAAE,YAAY,CAAE,EAC9B,OAAO,CACP,CAAC;IACH,CAAC;IAED,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IAEjC,OAAO,YAAY,CAAC;AACrB,CAAC;AAUD,KAAK,UAAU,IAAI,CAElB,OAAoB;IAEpB,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IAE1C,IAAK,CAAE,IAAI,EAAG,CAAC;QACd,MAAM,IAAI,KAAK,CAAE,wCAAwC,CAAE,CAAC;IAC7D,CAAC;IAED,IAAK,CAAE,IAAI,CAAC,YAAY,EAAE,KAAK,IAAI,CAAE,IAAI,CAAC,YAAY,EAAE,OAAO,EAAG,CAAC;QAClE,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;IACxB,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAE,GAAG,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAE,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAErE,MAAM,GAAG,GAAG,IAAI,CAAC,YAAa,CAAC,OAAO,GAAG,YAAY,CAAC;IAEtD,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAE,GAAG,EAAE;YAC/C,GAAG,YAAY;YACf,gBAAgB,EAAE,KAAK;YACvB,OAAO,EAAE;gBACR,YAAY,EAAE,IAAI,CAAC,YAAa,CAAC,KAAK;gBACtC,GAAG,CAAE,YAAY,CAAC,OAAO,IAAI,EAAE,CAAE;aACjC;SACD,CAAE,CAAC;QACJ,MAAM,IAAI,GAAiB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEjD,IAAK,CAAE,QAAQ,CAAC,EAAE,EAAE,EAAG,CAAC;YACvB,MAAM,IAAI,CAAC;QACZ,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,OAAQ,KAAK,EAAG,CAAC;QAClB,sDAAsD;QACtD,IACC,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAE,KAAK,EAAE,MAAM,CAAE;YACnD,KAA2B,CAAC,IAAI,KAAK,2BAA2B,EACjE,CAAC;YACF,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YAEvB,OAAO,IAAI,CAAC,IAAI,CAAE,OAAO,CAAE,CAAC;QAC7B,CAAC;QAED,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,eAAe,CAAsB,YAAY,GAAG,KAAK;IACvE,IAAK,CAAE,YAAY,IAAI,IAAI,CAAC,YAAY,EAAG,CAAC;QAC3C,OAAO,IAAI,CAAC,YAAY,CAAC;IAC1B,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAQ3B;QACJ,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,WAAW;KACjB,CAAE,CAAC;IACJ,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,SAAS,CAAE,CAAC,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACnE,OAAO,IAAI,CAAC,YAAY,CAAC;AAC1B,CAAC;AASD,KAAK,UAAU,SAAS,CAEvB,QAAwB;IAExB,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;IAElD,IAAK,QAAQ,CAAC,MAAM,GAAG,YAAY,EAAG,CAAC;QACtC,MAAM,MAAM,GAAG,qBAAqB,CAAE,QAAQ,EAAE,YAAY,CAAE,CAAC;QAE/D,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,GAAG,CACvC,MAAM,CAAC,GAAG,CAAE,CAAE,aAAa,EAAG,EAAE,CAC/B,IAAI,CAAC,SAAS,CAAmB,aAAa,CAAE,CAChD,CACD,CAAC;QAEF,OAAO,cAAc,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,IAAI,CAGjC;QACJ,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE;YACL,QAAQ;YACR,UAAU,EAAE,sBAAsB;SAClC;KACD,CAAE,CAAC;IAEJ,IAAK,cAAc,CAAC,MAAM,EAAG,CAAC;QAC7B,MAAM,cAAc,CAAC;IACtB,CAAC;IAED,OAAO,cAAc,CAAC,SAAS,CAAC;AACjC,CAAC"}

package/build/request-utils/site-settings.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSiteSettings = getSiteSettings;
+exports.updateSiteSettings = updateSiteSettings;
+/**
+ * Get the site settings.
+ *
+ * @see https://developer.wordpress.org/rest-api/reference/settings/#retrieve-a-site-setting
+ *
+ * @param this RequestUtils.
+ */
+async function getSiteSettings() {
+    return await this.rest({
+        path: '/wp/v2/settings',
+        method: 'GET',
+    });
+}
+/**
+ * Update the site settings.
+ *
+ * @see https://developer.wordpress.org/rest-api/reference/settings/#update-a-site-setting
+ *
+ * @param this         RequestUtils.
+ * @param siteSettings The partial settings payload to update.
+ */
+async function updateSiteSettings(siteSettings) {
+    return await this.rest({
+        path: '/wp/v2/settings',
+        method: 'POST',
+        data: siteSettings,
+    });
+}
+//# sourceMappingURL=site-settings.js.map

package/build/request-utils/site-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-settings.js","sourceRoot":"","sources":["../../src/request-utils/site-settings.ts"],"names":[],"mappings":";;AAiCA,0CAKC;AAUD,gDASC;AA/BD;;;;;;GAMG;AACI,KAAK,UAAU,eAAe;IACpC,OAAO,MAAM,IAAI,CAAC,IAAI,CAAkB;QACvC,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,KAAK;KACb,CAAE,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,kBAAkB,CAEvC,YAAqC;IAErC,OAAO,MAAM,IAAI,CAAC,IAAI,CAAkB;QACvC,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,YAAY;KAClB,CAAE,CAAC;AACL,CAAC"}

package/build/request-utils/templates.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteAllTemplates = deleteAllTemplates;
+exports.createTemplate = createTemplate;
+const PATH_MAPPING = {
+    wp_template: '/wp/v2/templates',
+    wp_template_part: '/wp/v2/template-parts',
+};
+/**
+ * Delete all the templates of given type.
+ *
+ * @param this
+ * @param type - Template type to delete.
+ */
+async function deleteAllTemplates(type) {
+    const path = PATH_MAPPING[type];
+    if (!path) {
+        throw new Error(`Unsupported template type: ${type}.`);
+    }
+    const templates = await this.rest({ path });
+    for (const template of templates) {
+        if (!template?.id || !template?.wp_id) {
+            continue;
+        }
+        try {
+            await this.rest({
+                method: 'DELETE',
+                path: `${path}/${template.id}`,
+                params: { force: true },
+            });
+        }
+        catch (responseError) {
+            // Disable reason - the error provides valuable feedback about issues with tests.
+            // eslint-disable-next-line no-console
+            console.warn(`deleteAllTemplates failed to delete template (id: ${template.wp_id}) with the following error`, responseError);
+        }
+    }
+}
+/**
+ * Creates a new template using the REST API.
+ *
+ * @param this
+ * @param type    Template type to delete.
+ * @param payload Template attributes.
+ */
+async function createTemplate(type, payload) {
+    const template = await this.rest({
+        method: 'POST',
+        path: PATH_MAPPING[type],
+        params: { ...payload, type, status: 'publish', is_wp_suggestion: true },
+    });
+    return template;
+}
+//# sourceMappingURL=templates.js.map

package/build/request-utils/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/request-utils/templates.ts"],"names":[],"mappings":";;AAkFS,gDAAkB;AAAE,wCAAc;AA/D3C,MAAM,YAAY,GAAG;IACpB,WAAW,EAAE,kBAAkB;IAC/B,gBAAgB,EAAE,uBAAuB;CACzC,CAAC;AAEF;;;;;GAKG;AACH,KAAK,UAAU,kBAAkB,CAAsB,IAAkB;IACxE,MAAM,IAAI,GAAG,YAAY,CAAE,IAAI,CAAE,CAAC;IAElC,IAAK,CAAE,IAAI,EAAG,CAAC;QACd,MAAM,IAAI,KAAK,CAAE,8BAA+B,IAAK,GAAG,CAAE,CAAC;IAC5D,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,CAAgB,EAAE,IAAI,EAAE,CAAE,CAAC;IAE5D,KAAM,MAAM,QAAQ,IAAI,SAAS,EAAG,CAAC;QACpC,IAAK,CAAE,QAAQ,EAAE,EAAE,IAAI,CAAE,QAAQ,EAAE,KAAK,EAAG,CAAC;YAC3C,SAAS;QACV,CAAC;QAED,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC,IAAI,CAAE;gBAChB,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,GAAI,IAAK,IAAK,QAAQ,CAAC,EAAG,EAAE;gBAClC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;aACvB,CAAE,CAAC;QACL,CAAC;QAAC,OAAQ,aAAa,EAAG,CAAC;YAC1B,iFAAiF;YACjF,sCAAsC;YACtC,OAAO,CAAC,IAAI,CACX,qDAAsD,QAAQ,CAAC,KAAM,4BAA4B,EACjG,aAAa,CACb,CAAC;QACH,CAAC;IACF,CAAC;AACF,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,cAAc,CAE5B,IAAkB,EAClB,OAA8B;IAE9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAc;QAC7C,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,YAAY,CAAE,IAAI,CAAE;QAC1B,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE;KACvE,CAAE,CAAC;IAEJ,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/build/request-utils/themes.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.activateTheme = activateTheme;
+exports.getCurrentThemeGlobalStylesPostId = getCurrentThemeGlobalStylesPostId;
+exports.getThemeGlobalStylesRevisions = getThemeGlobalStylesRevisions;
+const config_1 = require("../config");
+const THEMES_URL = new URL('wp-admin/themes.php', config_1.WP_BASE_URL).href;
+async function activateTheme(themeSlug) {
+    let response = await this.request.get(THEMES_URL);
+    const html = await response.text();
+    const optionalFolder = '([a-z0-9-]+%2F)?';
+    // The `optionalFolder` regex part matches paths with a folder,
+    // so it will return the first match, which might contain a folder.
+    // First try to honor the included theme slug, that is, without a folder.
+    let matchGroup = html.match(`action=activate&stylesheet=${encodeURIComponent(themeSlug)}&_wpnonce=[a-z0-9]+`);
+    // If the theme is not found, try to match the theme slug with a folder.
+    if (!matchGroup) {
+        matchGroup = html.match(`action=activate&stylesheet=${optionalFolder}${encodeURIComponent(themeSlug)}&_wpnonce=[a-z0-9]+`);
+    }
+    if (!matchGroup) {
+        if (html.includes(`data-slug="${themeSlug}"`)) {
+            // The theme is already activated.
+            return;
+        }
+        throw new Error(`The theme "${themeSlug}" is not installed`);
+    }
+    const [activateQuery] = matchGroup;
+    const activateLink = THEMES_URL + `?${activateQuery}`.replace(/&/g, '&');
+    response = await this.request.get(activateLink);
+    await response.dispose();
+}
+// https://developer.wordpress.org/rest-api/reference/themes/#definition
+async function getCurrentThemeGlobalStylesPostId() {
+    const themes = await this.rest({
+        path: '/wp/v2/themes',
+    });
+    let themeGlobalStylesId = '';
+    if (themes && themes.length) {
+        const currentTheme = themes.find(({ status }) => status === 'active');
+        const globalStylesURL = currentTheme?._links?.['wp:user-global-styles']?.[0]?.href;
+        if (globalStylesURL) {
+            // Extract the ID from the URL. The URL format depends on
+            // the permalink structure:
+            // - Plain: ?rest_route=/wp/v2/global-styles/123
+            // - Pretty: /wp-json/wp/v2/global-styles/123
+            const idMatch = globalStylesURL.match(/\/wp\/v2\/global-styles\/(\d+)/);
+            if (idMatch) {
+                themeGlobalStylesId = idMatch[1];
+            }
+        }
+    }
+    return themeGlobalStylesId;
+}
+/**
+ * Deletes all post revisions using the REST API.
+ *
+ * @param {}              this     RequestUtils.
+ * @param {string|number} parentId Post attributes.
+ */
+async function getThemeGlobalStylesRevisions(parentId) {
+    // Lists all global styles revisions.
+    return await this.rest({
+        path: `/wp/v2/global-styles/${parentId}/revisions`,
+        params: {
+            per_page: 100,
+        },
+    });
+}
+//# sourceMappingURL=themes.js.map

package/build/request-utils/themes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"themes.js","sourceRoot":"","sources":["../../src/request-utils/themes.ts"],"names":[],"mappings":";;AA0GC,sCAAa;AACb,8EAAiC;AACjC,sEAA6B;AAxG9B,sCAAwC;AAExC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAE,qBAAqB,EAAE,oBAAW,CAAE,CAAC,IAAI,CAAC;AAEtE,KAAK,UAAU,aAAa,CAE3B,SAAiB;IAEjB,IAAI,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAE,UAAU,CAAE,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,cAAc,GAAG,kBAAkB,CAAC;IAE1C,+DAA+D;IAC/D,mEAAmE;IACnE,yEAAyE;IACzE,IAAI,UAAU,GAAG,IAAI,CAAC,KAAK,CAC1B,kCAAmC,kBAAkB,CACpD,SAAS,CACR,yBAAyB,CAC3B,CAAC;IAEF,wEAAwE;IACxE,IAAK,CAAE,UAAU,EAAG,CAAC;QACpB,UAAU,GAAG,IAAI,CAAC,KAAK,CACtB,kCAAmC,cAAe,GAAI,kBAAkB,CACvE,SAAS,CACR,yBAAyB,CAC3B,CAAC;IACH,CAAC;IAED,IAAK,CAAE,UAAU,EAAG,CAAC;QACpB,IAAK,IAAI,CAAC,QAAQ,CAAE,cAAe,SAAU,GAAG,CAAE,EAAG,CAAC;YACrD,kCAAkC;YAClC,OAAO;QACR,CAAC;QAED,MAAM,IAAI,KAAK,CAAE,cAAe,SAAU,oBAAoB,CAAE,CAAC;IAClE,CAAC;IAED,MAAM,CAAE,aAAa,CAAE,GAAG,UAAU,CAAC;IACrC,MAAM,YAAY,GACjB,UAAU,GAAG,IAAK,aAAc,EAAE,CAAC,OAAO,CAAE,QAAQ,EAAE,GAAG,CAAE,CAAC;IAE7D,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAE,YAAY,CAAE,CAAC;IAElD,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;AAC1B,CAAC;AAED,wEAAwE;AACxE,KAAK,UAAU,iCAAiC;IAM/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAiB;QAC9C,IAAI,EAAE,eAAe;KACrB,CAAE,CAAC;IACJ,IAAI,mBAAmB,GAAW,EAAE,CAAC;IACrC,IAAK,MAAM,IAAI,MAAM,CAAC,MAAM,EAAG,CAAC;QAC/B,MAAM,YAAY,GAA0B,MAAM,CAAC,IAAI,CACtD,CAAE,EAAE,MAAM,EAAE,EAAG,EAAE,CAAC,MAAM,KAAK,QAAQ,CACrC,CAAC;QAEF,MAAM,eAAe,GACpB,YAAY,EAAE,MAAM,EAAE,CAAE,uBAAuB,CAAE,EAAE,CAAE,CAAC,CAAE,EAAE,IAAI,CAAC;QAChE,IAAK,eAAe,EAAG,CAAC;YACvB,yDAAyD;YACzD,2BAA2B;YAC3B,gDAAgD;YAChD,6CAA6C;YAC7C,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CACpC,gCAAgC,CAChC,CAAC;YACF,IAAK,OAAO,EAAG,CAAC;gBACf,mBAAmB,GAAG,OAAO,CAAE,CAAC,CAAE,CAAC;YACpC,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,mBAAmB,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,6BAA6B,CAE3C,QAAyB;IAEzB,qCAAqC;IACrC,OAAO,MAAM,IAAI,CAAC,IAAI,CAAgC;QACrD,IAAI,EAAE,wBAAyB,QAAS,YAAY;QACpD,MAAM,EAAE;YACP,QAAQ,EAAE,GAAG;SACb;KACD,CAAE,CAAC;AACL,CAAC"}

package/build/request-utils/users.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUser = createUser;
+exports.deleteAllUsers = deleteAllUsers;
+/**
+ * List all users.
+ *
+ * @see https://developer.wordpress.org/rest-api/reference/users/#list-users
+ * @param this
+ */
+async function listUsers() {
+    const response = await this.rest({
+        method: 'GET',
+        path: '/wp/v2/users',
+        params: {
+            per_page: 100,
+        },
+    });
+    return response;
+}
+/**
+ * Add a test user.
+ *
+ * @see https://developer.wordpress.org/rest-api/reference/users/#create-a-user
+ * @param this
+ * @param user User data to create.
+ */
+async function createUser(user) {
+    const userData = {
+        username: user.username,
+        email: user.email,
+    };
+    if (user.firstName) {
+        userData.first_name = user.firstName;
+    }
+    if (user.lastName) {
+        userData.last_name = user.lastName;
+    }
+    if (user.password) {
+        userData.password = user.password;
+    }
+    if (user.roles) {
+        userData.roles = user.roles;
+    }
+    const response = await this.rest({
+        method: 'POST',
+        path: '/wp/v2/users',
+        data: userData,
+    });
+    return response;
+}
+/**
+ * Delete a user.
+ *
+ * @see https://developer.wordpress.org/rest-api/reference/users/#delete-a-user
+ * @param this
+ * @param userId The ID of the user.
+ */
+async function deleteUser(userId) {
+    const response = await this.rest({
+        method: 'DELETE',
+        path: `/wp/v2/users/${userId}`,
+        params: { force: true, reassign: 1 },
+    });
+    return response;
+}
+/**
+ * Delete all users except main root user.
+ *
+ * @param this
+ */
+async function deleteAllUsers() {
+    const users = await listUsers.bind(this)();
+    // The users endpoint doesn't support batch request yet.
+    const responses = await Promise.all(users
+        // Do not delete neither root user nor the current user.
+        .filter((user) => user.id !== 1 && user.name !== this.user.username)
+        .map((user) => deleteUser.bind(this)(user.id)));
+    return responses;
+}
+//# sourceMappingURL=users.js.map

package/build/request-utils/users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/request-utils/users.ts"],"names":[],"mappings":";;AA4HS,gCAAU;AAAE,wCAAc;AA/FnC;;;;;GAKG;AACH,KAAK,UAAU,SAAS;IACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAY;QAC3C,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE;YACP,QAAQ,EAAE,GAAG;SACb;KACD,CAAE,CAAC;IAEJ,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,UAAU,CAAsB,IAAc;IAC5D,MAAM,QAAQ,GAAoB;QACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;KACjB,CAAC;IAEF,IAAK,IAAI,CAAC,SAAS,EAAG,CAAC;QACtB,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;IACtC,CAAC;IAED,IAAK,IAAI,CAAC,QAAQ,EAAG,CAAC;QACrB,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;IACpC,CAAC;IAED,IAAK,IAAI,CAAC,QAAQ,EAAG,CAAC;QACrB,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,IAAK,IAAI,CAAC,KAAK,EAAG,CAAC;QAClB,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAU;QACzC,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,QAAQ;KACd,CAAE,CAAC;IAEJ,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,UAAU,CAAsB,MAAc;IAC5D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAE;QACjC,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,gBAAiB,MAAO,EAAE;QAChC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE;KACpC,CAAE,CAAC;IAEJ,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,cAAc;IAC5B,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,CAAE,IAAI,CAAE,EAAE,CAAC;IAE7C,wDAAwD;IACxD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAClC,KAAK;QACJ,wDAAwD;SACvD,MAAM,CACN,CAAE,IAAU,EAAG,EAAE,CAChB,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,QAAQ,CAClD;SACA,GAAG,CAAE,CAAE,IAAU,EAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAE,IAAI,CAAE,CAAE,IAAI,CAAC,EAAE,CAAE,CAAE,CAC7D,CAAC;IAEF,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/build/request-utils/widgets.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteAllWidgets = deleteAllWidgets;
+exports.addWidgetBlock = addWidgetBlock;
+/**
+ * Delete all the widgets in the widgets screen.
+ *
+ * @this {import('./index').RequestUtils}
+ */
+async function deleteAllWidgets() {
+    const [widgets, sidebars] = await Promise.all([
+        this.rest({ path: '/wp/v2/widgets' }),
+        this.rest({ path: '/wp/v2/sidebars' }),
+    ]);
+    await this.batchRest(widgets.map((widget) => ({
+        method: 'DELETE',
+        path: `/wp/v2/widgets/${widget.id}?force=true`,
+    })));
+    // The endpoint doesn't support batch requests yet.
+    await Promise.all(sidebars.map((sidebar) => this.rest({
+        method: 'POST',
+        path: `/wp/v2/sidebars/${sidebar.id}`,
+        data: { id: sidebar.id, widgets: [] },
+    })));
+}
+/**
+ * Add a widget block to the widget area.
+ *
+ * @this {import('./index').RequestUtils}
+ * @param {string} serializedBlock The serialized content of the inserted block HTML.
+ * @param {string} widgetAreaId    The ID of the widget area.
+ */
+async function addWidgetBlock(serializedBlock, widgetAreaId) {
+    const { id: blockId } = await this.rest({
+        method: 'POST',
+        path: '/wp/v2/widgets',
+        data: {
+            id_base: 'block',
+            sidebar: widgetAreaId,
+            instance: {
+                raw: { content: serializedBlock },
+            },
+        },
+    });
+    const { widgets } = await this.rest({
+        path: `/wp/v2/sidebars/${widgetAreaId}`,
+    });
+    const updatedWidgets = new Set(widgets);
+    // Remove duplicate.
+    updatedWidgets.delete(blockId);
+    // Add to last block.
+    updatedWidgets.add(blockId);
+    await this.rest({
+        method: 'PUT',
+        path: `/wp/v2/sidebars/${widgetAreaId}`,
+        data: {
+            widgets: [...updatedWidgets],
+        },
+    });
+}
+//# sourceMappingURL=widgets.js.map

package/build/request-utils/widgets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgets.js","sourceRoot":"","sources":["../../src/request-utils/widgets.js"],"names":[],"mappings":";;AAKA,4CAuBC;AASD,wCA8BC;AAnED;;;;GAIG;AACI,KAAK,UAAU,gBAAgB;IACrC,MAAM,CAAE,OAAO,EAAE,QAAQ,CAAE,GAAG,MAAM,OAAO,CAAC,GAAG,CAAE;QAChD,IAAI,CAAC,IAAI,CAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAE;QACvC,IAAI,CAAC,IAAI,CAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAE;KACxC,CAAE,CAAC;IAEJ,MAAM,IAAI,CAAC,SAAS,CACnB,OAAO,CAAC,GAAG,CAAE,CAAE,MAAM,EAAG,EAAE,CAAC,CAAE;QAC5B,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,kBAAmB,MAAM,CAAC,EAAG,aAAa;KAChD,CAAE,CAAE,CACL,CAAC;IAEF,mDAAmD;IACnD,MAAM,OAAO,CAAC,GAAG,CAChB,QAAQ,CAAC,GAAG,CAAE,CAAE,OAAO,EAAG,EAAE,CAC3B,IAAI,CAAC,IAAI,CAAE;QACV,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,mBAAoB,OAAO,CAAC,EAAG,EAAE;QACvC,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;KACrC,CAAE,CACH,CACD,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,cAAc,CAAE,eAAe,EAAE,YAAY;IAClE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAE;QACxC,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE;YACL,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,YAAY;YACrB,QAAQ,EAAE;gBACT,GAAG,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE;aACjC;SACD;KACD,CAAE,CAAC;IAEJ,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAE;QACpC,IAAI,EAAE,mBAAoB,YAAa,EAAE;KACzC,CAAE,CAAC;IAEJ,MAAM,cAAc,GAAG,IAAI,GAAG,CAAE,OAAO,CAAE,CAAC;IAC1C,oBAAoB;IACpB,cAAc,CAAC,MAAM,CAAE,OAAO,CAAE,CAAC;IACjC,qBAAqB;IACrB,cAAc,CAAC,GAAG,CAAE,OAAO,CAAE,CAAC;IAE9B,MAAM,IAAI,CAAC,IAAI,CAAE;QAChB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,mBAAoB,YAAa,EAAE;QACzC,IAAI,EAAE;YACL,OAAO,EAAE,CAAE,GAAG,cAAc,CAAE;SAC9B;KACD,CAAE,CAAC;AACL,CAAC"}