@studiocms/devapps 0.1.0-beta.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 StudioCMS - Adam Matthiesen, Jacob Jenkins, Paul Valladares
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,92 @@
+# StudioCMS - Development Apps
+
+Collection* of useful tools available during dev mode in Astro
+
+## Installation
+
+Install the integration **automatically** using the Astro CLI:
+
+```bash
+pnpm astro add @studiocms/devapps
+```
+
+```bash
+npx astro add @studiocms/devapps
+```
+
+```bash
+yarn astro add @studiocms/devapps
+```
+
+Or install it **manually**:
+
+1. Install the required dependencies
+
+```bash
+pnpm add @studiocms/devapps
+```
+
+```bash
+npm install @studiocms/devapps
+```
+
+```bash
+yarn add @studiocms/devapps
+```
+
+2. Add the integration to your astro config
+
+```diff
++import devApps from "@studiocms/devapps";
+
+export default defineConfig({
+  integrations: [
++    devApps(),
+  ],
+});
+```
+
+## Usage
+
+All tools will only be available during `astro dev` and will not be available during production deployments!
+
+### libSQL Viewer
+
+#### Requires
+
+The following env variables set (`@astrojs/db`):
+- **`ASTRO_DB_REMOTE_URL`**
+- **`ASTRO_DB_APP_TOKEN`**
+
+#### Preview
+
+- Toolbar app
+
+![toolbar](./assets/preview-toolbar.png)
+
+- Toolbar app Embedded
+
+![toolbar-embedded](./assets/preview-embeddedapp.png)
+
+- Full page View
+
+![pageview](./assets/preview-page.png)
+
+### WordPress Importer
+
+#### Requires
+
+- StudioCMS Integration
+- A current WP Install
+- `@studiocms/blog` (Optional for importing Posts under a blog)
+
+#### Preview
+
+- Toolbar app
+
+![WP-importer](./assets/wp-importer.png)
+
+## Licensing
+
+[MIT Licensed](https://github.com/astrolicious/studiocms/blob/main/LICENSE).
+

package/dist/apps/libsql-viewer.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Generates the source URL for an iframe based on the provided database URL.
+ *
+ * @param dbUrl - The URL of the database.
+ * @returns The source URL for the iframe. If the database URL contains 'turso.io',
+ *          it returns `tursoURL`. Otherwise, it returns `sqlLiteUrl`.
+ */
+export declare function getIFrameSrc(dbUrl: string): "https://studio.outerbase.com/embed/sqlite?theme=dark" | "https://studio.outerbase.com/embed/turso?theme=dark";
+/**
+ * Defines a toolbar application for viewing and interacting with a libSQL database.
+ *
+ * @param {HTMLCanvasElement} canvas - The canvas element where the app will be initialized.
+ * @param {EventTarget} eventTarget - The event target for handling outside click events.
+ *
+ * @returns {void}
+ *
+ * @example
+ * ```typescript
+ * import libsqlViewer from './libsql-viewer';
+ *
+ * const canvas = document.getElementById('appCanvas') as HTMLCanvasElement;
+ * const eventTarget = new EventTarget();
+ *
+ * libsqlViewer.init(canvas, eventTarget);
+ * ```
+ *
+ * @remarks
+ * This function creates an iframe to display the libSQL database viewer and sets up
+ * event listeners to handle SQL query and transaction requests via postMessage.
+ *
+ * The iframe's source URL and authentication token are retrieved from the `dbEnv` object.
+ *
+ * The `createClient` function is used to create a client for executing SQL queries and transactions.
+ *
+ * The `closeOnOutsideClick` function is used to close the app window when a click is detected outside of it.
+ *
+ * The `transformTursoResult` function is used to transform the results of SQL queries and transactions.
+ *
+ * The `biome-ignore` comments are used to suppress linting warnings for non-null assertions.
+ *
+ * @see {@link createClient}
+ * @see {@link closeOnOutsideClick}
+ * @see {@link transformTursoResult}
+ */
+declare const _default: import("astro").DevToolbarApp;
+export default _default;

package/dist/apps/libsql-viewer.js

@@ -0,0 +1,95 @@
+import { dbEnv } from "virtual:studiocms-devapps/config";
+import { createClient } from "@libsql/client/web";
+import { transformTursoResult } from "@outerbase/sdk-transform";
+import { defineToolbarApp } from "astro/toolbar";
+import { closeOnOutsideClick } from "../utils/app-utils.js";
+const sqlLiteUrl = "https://studio.outerbase.com/embed/sqlite?theme=dark";
+const tursoURL = "https://studio.outerbase.com/embed/turso?theme=dark";
+function getIFrameSrc(dbUrl) {
+  if (dbUrl.includes("turso.io")) {
+    return tursoURL;
+  }
+  return sqlLiteUrl;
+}
+var libsql_viewer_default = defineToolbarApp({
+  init(canvas, eventTarget) {
+    const appWindow = document.createElement("astro-dev-toolbar-window");
+    appWindow.style.width = "95%";
+    appWindow.style.height = "95%";
+    closeOnOutsideClick(eventTarget);
+    const viewerIframe = document.createElement("iframe");
+    viewerIframe.src = getIFrameSrc(dbEnv.remoteUrl);
+    viewerIframe.id = "sqlIframe";
+    viewerIframe.title = "libSQL Database Viewer";
+    Object.assign(viewerIframe.dataset, {
+      url: dbEnv.remoteUrl,
+      authtoken: dbEnv.token
+    });
+    Object.assign(viewerIframe.style, {
+      height: "100%",
+      width: "100%",
+      border: "1px solid rgba(27, 30, 36, 1)"
+    });
+    appWindow.appendChild(viewerIframe);
+    const client = createClient({
+      // biome-ignore lint/style/noNonNullAssertion: <explanation>
+      url: viewerIframe.dataset.url,
+      // biome-ignore lint/style/noNonNullAssertion: <explanation>
+      authToken: viewerIframe.dataset.authtoken
+    });
+    window.addEventListener("message", async (e) => {
+      const contentWindow = viewerIframe.contentWindow;
+      if (contentWindow && e.data) {
+        const { type, id, statement, statements } = e.data;
+        if (type === "query" && statement) {
+          try {
+            const result = await client.execute(statement);
+            contentWindow.postMessage(
+              {
+                type,
+                id,
+                data: transformTursoResult(result)
+              },
+              "*"
+            );
+          } catch (err) {
+            contentWindow.postMessage(
+              {
+                type,
+                id,
+                error: err.message
+              },
+              "*"
+            );
+          }
+        } else if (type === "transaction" && statements) {
+          try {
+            const result = await client.batch(statements, "write");
+            contentWindow.postMessage(
+              {
+                type,
+                id,
+                data: result.map(transformTursoResult)
+              },
+              "*"
+            );
+          } catch (err) {
+            contentWindow.postMessage(
+              {
+                type,
+                id,
+                error: err.message
+              },
+              "*"
+            );
+          }
+        }
+      }
+    });
+    canvas.appendChild(appWindow);
+  }
+});
+export {
+  libsql_viewer_default as default,
+  getIFrameSrc
+};

package/dist/apps/wp-importer.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Defines a toolbar application for importing content from a WordPress site into StudioCMS.
+ *
+ * @param {Object} canvas - The canvas element where the application will be rendered.
+ * @param {Object} eventTarget - The target element for event listeners.
+ *
+ * @returns {Object} - The toolbar application definition.
+ *
+ * @function init
+ * Initializes the toolbar application by creating the canvas and setting up event listeners.
+ *
+ * @function createCanvas
+ * Creates and appends the main window component to the canvas. Sets up the form and its event listeners.
+ *
+ * @function closeOnOutsideClick
+ * Closes the window component when a click is detected outside of the specified event target.
+ *
+ * @event 'astro:after-swap'
+ * Recreates the canvas when the 'astro:after-swap' event is triggered.
+ *
+ * @event 'submit'
+ * Handles the form submission, including validation, showing a loading spinner, and making a POST request to the WordPress API endpoint.
+ *
+ * @constant {string} wpAPIEndpoint - The endpoint URL for the WordPress API.
+ *
+ * @typedef {Object} FormData
+ * Represents the form data to be sent in the POST request.
+ *
+ * @typedef {Object} Response
+ * Represents the response from the WordPress API.
+ *
+ * @typedef {Object} HTMLFormElement
+ * Represents the form element in the DOM.
+ *
+ * @typedef {Object} HTMLInputElement
+ * Represents the input element in the DOM.
+ *
+ * @typedef {Object} HTMLSelectElement
+ * Represents the select element in the DOM.
+ */
+declare const _default: import("astro").DevToolbarApp;
+export default _default;

package/dist/apps/wp-importer.js

@@ -0,0 +1,214 @@
+import { wpAPIEndpoint } from "virtual:studiocms-devapps/endpoints";
+import { defineToolbarApp } from "astro/toolbar";
+import { closeOnOutsideClick, createWindowElement } from "../utils/app-utils.js";
+var wp_importer_default = defineToolbarApp({
+  init(canvas, eventTarget) {
+    createCanvas();
+    document.addEventListener("astro:after-swap", createCanvas);
+    closeOnOutsideClick(eventTarget);
+    function createCanvas() {
+      const windowComponent = createWindowElement(
+        `<style>
+				#main-container {
+					display: flex;
+					flex-direction: column;
+					height: 100%;
+					gap: 24px;
+				}
+
+				p {
+					margin-top: 0;
+				}
+
+				header {
+					display: flex;
+					justify-content: space-between;
+					align-items: center;
+				}
+
+				header section {
+					display: flex;
+					gap: 0.8em;
+				}
+
+				header h2 {
+					align-items: center;
+					font-size: 28px;	
+				}
+
+				h2 {
+					color: white;
+					margin: 0;
+					font-size: 18px;
+					align-items: center;
+				}
+
+				.form-container {
+					max-width: 600px;
+					margin: 0 auto;
+					padding: 16px;
+					border: 1px solid #ccc;
+					border-radius: 8px;
+				}
+
+				.form-group {
+					margin-bottom: 12px;
+				}
+
+				label {
+					display: block;
+					margin-bottom: 5px;
+					font-weight: bold;
+				}
+
+				input[type="text"], select {
+					width: 100%;
+					padding: 10px;
+					border: 1px solid #ccc;
+					border-radius: 4px;
+					box-sizing: border-box;
+				}
+
+				.required {
+					color: red;
+				}
+
+				.checkbox-group {
+					display: flex;
+					flex-direction: column;
+				}
+
+				.checkbox-item {
+					margin-bottom: 10px;
+					display: flex;
+					align-items: center;
+				}
+
+				.submit-btn {
+					padding: 10px 20px;
+					background-color: #007bff;
+					color: white;
+					border: none;
+					border-radius: 4px;
+					cursor: pointer;
+				}
+
+				.submit-btn:hover {
+					background-color: #0056b3;
+				}
+
+				.loading-spinner {
+					display: none; /* Hidden by default */
+					margin: 0 1rem;
+				}
+
+				.loading-active .loading-spinner {
+					display: block;
+				}
+
+				.form-submit {
+					display: flex;
+					align-items: center;
+				}
+
+			</style>
+
+			<header>
+				<section>
+					<h2><svg xmlns="http://www.w3.org/2000/svg" width="28" height="28" viewBox="0 0 24 24"><path fill="currentColor" d="M12 2C6.49 2 2 6.49 2 12s4.49 10 10 10s10-4.49 10-10S17.51 2 12 2M3.01 12c0-1.3.28-2.54.78-3.66l4.29 11.75c-3-1.46-5.07-4.53-5.07-8.09M12 20.99c-.88 0-1.73-.13-2.54-.37l2.7-7.84l2.76 7.57c.02.04.04.09.06.12c-.93.34-1.93.52-2.98.52m1.24-13.21c.54-.03 1.03-.09 1.03-.09c.48-.06.43-.77-.06-.74c0 0-1.46.11-2.4.11c-.88 0-2.37-.11-2.37-.11c-.48-.02-.54.72-.05.75c0 0 .46.06.94.09l1.4 3.84l-1.97 5.9l-3.27-9.75c.54-.02 1.03-.08 1.03-.08c.48-.06.43-.77-.06-.74c0 0-1.46.11-2.4.11c-.17 0-.37 0-.58-.01C6.1 4.62 8.86 3.01 12 3.01c2.34 0 4.47.89 6.07 2.36c-.04 0-.08-.01-.12-.01c-.88 0-1.51.77-1.51 1.6c0 .74.43 1.37.88 2.11c.34.6.74 1.37.74 2.48c0 .77-.3 1.66-.68 2.91l-.9 3zm6.65-.09a8.99 8.99 0 0 1-3.37 12.08l2.75-7.94c.51-1.28.68-2.31.68-3.22c0-.33-.02-.64-.06-.92"/></svg> Wordpress Importer</h2>
+				</section>
+			</header>
+			<hr />
+
+			<div id="main-container">
+					<div class="importer">
+						<p class="importer-description">Import posts and pages into StudioCMS from a WordPress site. <br />(Requires StudioCMS)</p>
+						<section id="importer-body">
+							<form id="importer-form">
+								<div class="form-container">
+								<div class="form-group">
+									<label for="importer-url">WordPress URL<span class="required">*</span></label>
+									<input type="text" id="importer-url" name="importer-url" placeholder="https://your-domain.com" required>
+								</div>
+								
+								<div class="form-group">
+									<label for="importer-type">Import Type<span class="required">*</span></label>
+									<select id="importer-type" name="importer-type" required>
+									<option value="pages" selected>Pages</option>
+									<option value="posts">Posts</option>
+									<option value="settings">Site Settings (This option will override your StudioCMS Site Config)</option>
+									</select>
+								</div>
+
+								<div class="form-group">
+									<label for="importer-plugins">Use Plugins</label>
+									<div class="checkbox-group">
+									<div class="checkbox-item">
+										<input type="checkbox" id="importer-plugins-0" name="importer-plugins[]" value="blog-plugin">
+										<label for="importer-plugins-0">@studiocms/blog (Available for the Posts type)</label>
+									</div>
+									</div>
+								</div>
+								
+								<div class="form-group form-submit">
+									<button type="submit" class="submit-btn">Submit</button>
+									<div class="loading-spinner">
+										<!-- SVG for loading -->
+										<svg xmlns="http://www.w3.org/2000/svg" style="margin:auto; background:none; display:block;" width="50px" height="50px" viewBox="0 0 100 100" preserveAspectRatio="xMidYMid">
+										<circle cx="50" cy="50" fill="none" stroke="#007bff" stroke-width="8" r="35" stroke-dasharray="164.93361431346415 56.97787143782138">
+											<animateTransform attributeName="transform" type="rotate" repeatCount="indefinite" dur="1s" values="0 50 50;360 50 50" keyTimes="0;1"></animateTransform>
+										</circle>
+										</svg>
+									</div>
+								</div>
+								</div>
+							</form>
+						</section>
+					</div>
+				</div>
+		`
+      );
+      const form = windowComponent.querySelector("#importer-form");
+      form?.addEventListener("submit", async (event) => {
+        event.preventDefault();
+        form.classList.add("loading-active");
+        const url = form.querySelector("#importer-url")?.value;
+        const type = form.querySelector("#importer-type")?.value;
+        const plugins = form.querySelectorAll(
+          'input[name="importer-plugins[]"]:checked'
+        );
+        const useBlogPlugin = Array.from(plugins).some(
+          (checkbox) => checkbox.value === "blog-plugin"
+        );
+        if (!url || !type) {
+          alert("Please fill in the required fields");
+          form.classList.remove("loading-active");
+          return;
+        }
+        const formData = new FormData();
+        formData.append("url", url);
+        formData.append("type", type);
+        formData.append("useBlogPlugin", useBlogPlugin ? "true" : "false");
+        console.log("formData", formData);
+        const response = await fetch(wpAPIEndpoint, {
+          method: "POST",
+          body: formData
+        });
+        const responseStatus = response.status;
+        const responseText = response.statusText;
+        form.classList.remove("loading-active");
+        if (responseStatus === 200) {
+          alert(
+            "Imported successfully! You can now view/edit the imported content in your StudioCMS dashboard."
+          );
+        } else {
+          alert(`Failed to import: ${responseText}`);
+        }
+      });
+      canvas.append(windowComponent);
+    }
+  }
+});
+export {
+  wp_importer_default as default
+};

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+import type { AstroIntegration } from 'astro';
+import { type StudioCMSDevAppsOptions } from './schema/index.js';
+/**
+ * Integrates StudioCMS development applications with Astro.
+ *
+ * @param {StudioCMSDevAppsOptions} [opts] - Optional configuration options for StudioCMS DevApps.
+ * @returns {AstroIntegration} The Astro integration object for StudioCMS DevApps.
+ *
+ * @remarks
+ * This function sets up the StudioCMS development applications for use in an Astro project.
+ * It parses the provided options, sets up virtual imports, and adds development toolbar apps
+ * based on the configuration.
+ *
+ * The integration is enforced to run only in development mode.
+ *
+ * @example
+ * ```typescript
+ * import { studioCMSDevApps } from '@studiocms/devapps';
+ *
+ * export default {
+ *   integrations: [
+ *     studioCMSDevApps({
+ *       endpoint: '/api',
+ *       appsConfig: {
+ *         wpImporter: {
+ *           enabled: true,
+ *           endpoint: '/wp-import',
+ *         },
+ *         libSQLViewer: {
+ *           enabled: true,
+ *         },
+ *       },
+ *       verbose: true,
+ *     }),
+ *   ],
+ * };
+ * ```
+ */
+export declare function studioCMSDevApps(opts?: StudioCMSDevAppsOptions): AstroIntegration;
+export default studioCMSDevApps;

package/dist/index.js

@@ -0,0 +1,66 @@
+import { addVirtualImports, createResolver, injectDevRoute } from "astro-integration-kit";
+import { loadEnv } from "vite";
+import { StudioCMSDevAppsSchema } from "./schema/index.js";
+import { pathGenerator } from "./utils/pathGenerator.js";
+function studioCMSDevApps(opts) {
+  const options = StudioCMSDevAppsSchema.parse(opts);
+  const { resolve } = createResolver(import.meta.url);
+  let makeEndpointPath;
+  const astroDbEnv = loadEnv("all", process.cwd(), "ASTRO_DB");
+  return {
+    name: "@studiocms/devapps",
+    hooks: {
+      "astro:config:setup": (params) => {
+        const { config, logger, addDevToolbarApp, command } = params;
+        makeEndpointPath = pathGenerator(options.endpoint, config.base);
+        options.verbose && logger.info("Setting up StudioCMS DevApps");
+        if (command === "dev") {
+          const wpAPIPath = makeEndpointPath(options.appsConfig.wpImporter.endpoint);
+          addVirtualImports(params, {
+            name: "@studiocms/devapps",
+            imports: {
+              "virtual:studiocms-devapps/endpoints": `
+								export const wpAPIEndpoint = "${wpAPIPath}";
+							`,
+              "virtual:studiocms-devapps/config": `
+								export const userProjectRoot = "${config.root.pathname}";
+
+								export const dbEnv = {
+									remoteUrl: "${astroDbEnv.ASTRO_DB_REMOTE_URL}",
+									token: "${astroDbEnv.ASTRO_DB_APP_TOKEN}",
+								};
+							`
+            }
+          });
+          if (options.appsConfig.libSQLViewer.enabled) {
+            options.verbose && logger.info("Adding Dev Toolbar App: LibSQL Viewer");
+            addDevToolbarApp({
+              name: "LibSQL Viewer",
+              id: "studiocms-devapps-libsql-viewer",
+              entrypoint: resolve("./apps/libsql-viewer.js"),
+              icon: '<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" class="size-6"><path stroke-linecap="round" stroke-linejoin="round" d="M20.25 6.375c0 2.278-3.694 4.125-8.25 4.125S3.75 8.653 3.75 6.375m16.5 0c0-2.278-3.694-4.125-8.25-4.125S3.75 4.097 3.75 6.375m16.5 0v11.25c0 2.278-3.694 4.125-8.25 4.125s-8.25-1.847-8.25-4.125V6.375m16.5 0v3.75m-16.5-3.75v3.75m16.5 0v3.75C20.25 16.153 16.556 18 12 18s-8.25-1.847-8.25-4.125v-3.75m16.5 0c0 2.278-3.694 4.125-8.25 4.125s-8.25-1.847-8.25-4.125" /></svg>'
+            });
+          }
+          if (options.appsConfig.wpImporter.enabled) {
+            options.verbose && logger.info("Adding Dev Toolbar App: WP API Importer");
+            injectDevRoute(params, {
+              entrypoint: resolve("./routes/wp-importer.js"),
+              pattern: wpAPIPath
+            });
+            addDevToolbarApp({
+              name: "Wordpress API Importer",
+              id: "studiocms-devapps-wp-api-importer",
+              entrypoint: resolve("./apps/wp-importer.js"),
+              icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="currentColor" d="M12 2C6.49 2 2 6.49 2 12s4.49 10 10 10s10-4.49 10-10S17.51 2 12 2M3.01 12c0-1.3.28-2.54.78-3.66l4.29 11.75c-3-1.46-5.07-4.53-5.07-8.09M12 20.99c-.88 0-1.73-.13-2.54-.37l2.7-7.84l2.76 7.57c.02.04.04.09.06.12c-.93.34-1.93.52-2.98.52m1.24-13.21c.54-.03 1.03-.09 1.03-.09c.48-.06.43-.77-.06-.74c0 0-1.46.11-2.4.11c-.88 0-2.37-.11-2.37-.11c-.48-.02-.54.72-.05.75c0 0 .46.06.94.09l1.4 3.84l-1.97 5.9l-3.27-9.75c.54-.02 1.03-.08 1.03-.08c.48-.06.43-.77-.06-.74c0 0-1.46.11-2.4.11c-.17 0-.37 0-.58-.01C6.1 4.62 8.86 3.01 12 3.01c2.34 0 4.47.89 6.07 2.36c-.04 0-.08-.01-.12-.01c-.88 0-1.51.77-1.51 1.6c0 .74.43 1.37.88 2.11c.34.6.74 1.37.74 2.48c0 .77-.3 1.66-.68 2.91l-.9 3zm6.65-.09a8.99 8.99 0 0 1-3.37 12.08l2.75-7.94c.51-1.28.68-2.31.68-3.22c0-.33-.02-.64-.06-.92"/></svg>'
+            });
+          }
+        }
+      }
+    }
+  };
+}
+var index_default = studioCMSDevApps;
+export {
+  index_default as default,
+  studioCMSDevApps
+};

package/dist/routes/wp-importer.d.ts

@@ -0,0 +1,27 @@
+import type { APIRoute } from 'astro';
+/**
+ * Handles the POST request for importing data from a WordPress site.
+ *
+ * @param {APIContext} context - The context of the API request.
+ * @param {Request} context.request - The incoming request object.
+ *
+ * @returns {Promise<Response>} The response object indicating the result of the import operation.
+ *
+ * The function expects the request to contain form data with the following fields:
+ * - `url`: The URL of the WordPress site to import data from.
+ * - `type`: The type of data to import (e.g., 'pages', 'posts', 'settings').
+ * - `useBlogPlugin` (optional): A boolean value indicating whether to use the blog plugin for importing posts.
+ *
+ * The function performs the following steps:
+ * 1. Extracts the form data from the request.
+ * 2. Validates the presence and types of the `url` and `type` fields.
+ * 3. Logs the import operation details.
+ * 4. Based on the `type` field, calls the appropriate import function:
+ *    - `importPagesFromWPAPI` for importing pages.
+ *    - `importPostsFromWPAPI` for importing posts, optionally using the blog plugin.
+ *    - `importSettingsFromWPAPI` for importing settings.
+ * 5. Returns a response indicating success or failure.
+ *
+ * @throws {Error} If the `type` field contains an invalid value.
+ */
+export declare const POST: APIRoute;