wp-content-exporter 0.1.0

package/dist/cli.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+import { program } from "commander";
+import { resolve } from "path";
+import { exportToCSV } from "./index.js";
+const version = "0.1.0";
+program
+    .name("wp-content-exporter")
+    .description("Export WordPress content to CSV from the command line")
+    .version(version);
+program
+    .command("export")
+    .description("Export WordPress content to CSV")
+    .option("-e, --endpoint <url>", "WordPress endpoint URL (required)")
+    .option("-t, --post-type <type>", "Post type to export (default: posts)", "posts")
+    .option("-f, --fields <fields>", "Fields to export (comma-separated, required)")
+    .option("-o, --output <file>", "Output file path (required)")
+    .option("-u, --username <username>", "Basic auth username")
+    .option("-p, --password <password>", "Basic auth password")
+    .option("-b, --bearer <token>", "Bearer token for JWT auth")
+    .option("--per-page <number>", "Items per page (default: 100)", "100")
+    .action(async (options) => {
+    try {
+        // Validate required options
+        if (!options.endpoint) {
+            console.error("❌ Error: --endpoint is required");
+            console.log("Usage: wp-content-exporter export --endpoint <url> --fields <fields> --output <file>");
+            process.exit(1);
+        }
+        if (!options.fields) {
+            console.error("❌ Error: --fields is required");
+            console.log("Example: --fields title.rendered,slug,date");
+            process.exit(1);
+        }
+        if (!options.output) {
+            console.error("❌ Error: --output is required");
+            console.log("Example: --output posts.csv");
+            process.exit(1);
+        }
+        // Parse fields
+        const fields = options.fields
+            .split(",")
+            .map((f) => f.trim())
+            .filter((f) => f.length > 0);
+        if (fields.length === 0) {
+            console.error("❌ Error: No valid fields provided");
+            process.exit(1);
+        }
+        // Build auth config
+        let auth = undefined;
+        if (options.username && options.password) {
+            auth = {
+                type: "basic",
+                username: options.username,
+                password: options.password
+            };
+        }
+        else if (options.bearer) {
+            auth = {
+                type: "bearer",
+                token: options.bearer
+            };
+        }
+        // Show progress
+        console.log("📦 Exporting WordPress content...");
+        console.log(`   Endpoint: ${options.endpoint}`);
+        console.log(`   Post type: ${options.postType}`);
+        console.log(`   Fields: ${fields.join(", ")}`);
+        console.log(`   Output: ${options.output}`);
+        if (auth) {
+            console.log(`   Auth: ${auth.type}`);
+        }
+        console.log("");
+        // Export
+        const csv = await exportToCSV({
+            endpoint: options.endpoint,
+            postType: options.postType,
+            fields,
+            auth,
+            perPage: parseInt(options.perPage),
+            outputFile: resolve(options.output)
+        });
+        // Count rows
+        const rowCount = csv.split("\n").length - 1;
+        console.log(`✅ Export complete!`);
+        console.log(`   Rows: ${rowCount}`);
+        console.log(`   File: ${resolve(options.output)}`);
+    }
+    catch (error) {
+        console.error("❌ Export failed:");
+        console.error(error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+// Help for export command
+program
+    .command("example")
+    .description("Show example usage")
+    .action(() => {
+    console.log(`
+📝 EXAMPLES:
+
+1. Export public posts:
+   wp-content-exporter export \\
+     --endpoint https://example.com \\
+     --fields title.rendered,slug \\
+     --output posts.csv
+
+2. Export with basic authentication:
+   wp-content-exporter export \\
+     --endpoint https://example.com \\
+     --post-type posts \\
+     --fields title.rendered,content.rendered \\
+     --username admin \\
+     --password app-password \\
+     --output posts.csv
+
+3. Export with bearer token:
+   wp-content-exporter export \\
+     --endpoint https://example.com \\
+     --bearer your-jwt-token \\
+     --fields title.rendered,slug \\
+     --output posts.csv
+
+4. Export with nested fields (ACF):
+   wp-content-exporter export \\
+     --endpoint https://example.com \\
+     --fields title.rendered,acf.price,acf.product.name \\
+     --output products.csv
+
+5. Use with npx (no installation):
+   npx wp-content-exporter export \\
+     --endpoint https://example.com \\
+     --fields title.rendered,slug \\
+     --output posts.csv
+    `);
+});
+program.parse(process.argv);
+// Show help if no command provided
+if (process.argv.length < 3) {
+    program.help();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/csv.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Converts an array of objects to CSV format using specified fields
+ * Supports nested fields using dot notation
+ *
+ * @param {any[]} items - Array of objects to convert
+ * @param {string[]} fields - Field names to include in CSV (supports dot notation for nested fields)
+ * @returns {string} CSV string
+ *
+ * @throws {Error} If json2csv parsing fails
+ *
+ * @example
+ * const posts = [
+ *   { title: { rendered: "Post 1" }, slug: "post-1" },
+ *   { title: { rendered: "Post 2" }, slug: "post-2" }
+ * ]
+ *
+ * const csv = toCSV(posts, ["title.rendered", "slug"])
+ * // Returns CSV with headers: title.rendered,slug
+ */
+export declare function toCSV(items: any[], fields: string[]): string;
+//# sourceMappingURL=csv.d.ts.map

package/dist/csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../src/csv.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAsB5D"}

package/dist/csv.js

@@ -0,0 +1,57 @@
+import { Parser } from "json2csv";
+/**
+ * Gets a nested value from an object using dot notation
+ *
+ * @param {any} obj - Object to retrieve value from
+ * @param {string} path - Dot-separated path (e.g., "title.rendered", "acf.price")
+ * @returns {any} The value at the path, or undefined if not found
+ *
+ * @example
+ * const post = { title: { rendered: "Hello World" } }
+ * getValue(post, "title.rendered") // => "Hello World"
+ */
+function getValue(obj, path) {
+    return path.split(".").reduce((o, k) => o?.[k], obj);
+}
+/**
+ * Converts an array of objects to CSV format using specified fields
+ * Supports nested fields using dot notation
+ *
+ * @param {any[]} items - Array of objects to convert
+ * @param {string[]} fields - Field names to include in CSV (supports dot notation for nested fields)
+ * @returns {string} CSV string
+ *
+ * @throws {Error} If json2csv parsing fails
+ *
+ * @example
+ * const posts = [
+ *   { title: { rendered: "Post 1" }, slug: "post-1" },
+ *   { title: { rendered: "Post 2" }, slug: "post-2" }
+ * ]
+ *
+ * const csv = toCSV(posts, ["title.rendered", "slug"])
+ * // Returns CSV with headers: title.rendered,slug
+ */
+export function toCSV(items, fields) {
+    if (!items || items.length === 0) {
+        return "";
+    }
+    const rows = items.map(item => {
+        const row = {};
+        for (const field of fields) {
+            row[field] = getValue(item, field);
+        }
+        return row;
+    });
+    try {
+        const parser = new Parser({ fields });
+        return parser.parse(rows);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`CSV parsing failed: ${error.message}`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=csv.js.map

package/dist/csv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.js","sourceRoot":"","sources":["../src/csv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC;;;;;;;;;;GAUG;AACH,SAAS,QAAQ,CAAC,GAAQ,EAAE,IAAY;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AACtD,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,KAAK,CAAC,KAAY,EAAE,MAAgB;IAClD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QAC5B,MAAM,GAAG,GAAwB,EAAE,CAAA;QACnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,GAAG,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACpC,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACrC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QACzD,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/fetch.d.ts

@@ -0,0 +1,21 @@
+import { AuthConfig } from "./auth.js";
+/**
+ * Fetches all posts/pages/custom post types from WordPress REST API with automatic pagination
+ *
+ * @param {string} endpoint - WordPress site URL (e.g., "https://example.com")
+ * @param {string} postType - Post type to fetch (e.g., "posts", "pages", "custom-type")
+ * @param {AuthConfig} [auth] - Optional authentication configuration
+ * @param {number} [perPage=100] - Number of items per page (max 100)
+ * @returns {Promise<any[]>} Array of all posts across all pages
+ *
+ * @throws {Error} If the fetch request fails or returns non-ok status
+ *
+ * @example
+ * const posts = await fetchAllPosts(
+ *   "https://example.com",
+ *   "posts",
+ *   { type: "basic", username: "admin", password: "xxx" }
+ * )
+ */
+export declare function fetchAllPosts(endpoint: string, postType: string, auth?: AuthConfig, perPage?: number): Promise<any[]>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,UAAU,EAAE,MAAM,WAAW,CAAA;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,UAAU,EACjB,OAAO,SAAM,GACZ,OAAO,CAAC,GAAG,EAAE,CAAC,CA6BhB"}

package/dist/fetch.js

@@ -0,0 +1,45 @@
+import { buildHeaders } from "./auth.js";
+/**
+ * Fetches all posts/pages/custom post types from WordPress REST API with automatic pagination
+ *
+ * @param {string} endpoint - WordPress site URL (e.g., "https://example.com")
+ * @param {string} postType - Post type to fetch (e.g., "posts", "pages", "custom-type")
+ * @param {AuthConfig} [auth] - Optional authentication configuration
+ * @param {number} [perPage=100] - Number of items per page (max 100)
+ * @returns {Promise<any[]>} Array of all posts across all pages
+ *
+ * @throws {Error} If the fetch request fails or returns non-ok status
+ *
+ * @example
+ * const posts = await fetchAllPosts(
+ *   "https://example.com",
+ *   "posts",
+ *   { type: "basic", username: "admin", password: "xxx" }
+ * )
+ */
+export async function fetchAllPosts(endpoint, postType, auth, perPage = 100) {
+    let page = 1;
+    let results = [];
+    while (true) {
+        const url = `${endpoint}/wp-json/wp/v2/${postType}?per_page=${perPage}&page=${page}`;
+        try {
+            const res = await fetch(url, { headers: buildHeaders(auth) });
+            if (!res.ok) {
+                throw new Error(`WordPress REST API error: ${res.status} ${res.statusText}`);
+            }
+            const data = await res.json();
+            if (!Array.isArray(data) || data.length === 0)
+                break;
+            results = results.concat(data);
+            page++;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to fetch from ${url}: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=fetch.js.map

package/dist/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAc,MAAM,WAAW,CAAA;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,QAAgB,EAChB,IAAiB,EACjB,OAAO,GAAG,GAAG;IAEb,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,IAAI,OAAO,GAAU,EAAE,CAAA;IAEvB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,GAAG,QAAQ,kBAAkB,QAAQ,aAAa,OAAO,SAAS,IAAI,EAAE,CAAA;QAEpF,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAE7D,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAA;YAC9E,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAW,CAAA;YAEtC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAK;YAEpD,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YAC9B,IAAI,EAAE,CAAA;QACR,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;YAClE,CAAC;YACD,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+import { AuthConfig } from "./auth.js";
+/**
+ * Options for exporting WordPress content to CSV
+ *
+ * @typedef {Object} ExportOptions
+ * @property {string} endpoint - WordPress site URL
+ * @property {string} postType - Post type (posts, pages, custom types)
+ * @property {string[]} fields - Fields to export (supports dot notation)
+ * @property {AuthConfig} [auth] - Optional authentication config
+ * @property {number} [perPage=100] - Items per API request
+ * @property {string} [outputFile] - Optional file path to save CSV (if not provided, returns string)
+ */
+export type ExportOptions = {
+    endpoint: string;
+    postType: string;
+    fields: string[];
+    auth?: AuthConfig;
+    perPage?: number;
+    outputFile?: string;
+};
+/**
+ * Main function to export WordPress content to CSV
+ *
+ * Fetches posts/pages/custom post types from WordPress REST API and converts to CSV format
+ * Automatically handles pagination and flattens nested fields
+ *
+ * @param {ExportOptions} options - Export configuration
+ * @returns {Promise<string>} CSV string with headers and data rows
+ *
+ * @throws {Error} If fetch fails, auth is invalid, or CSV generation fails
+ *
+ * @example
+ * // Return CSV as string
+ * const csv = await exportToCSV({
+ *   endpoint: "https://example.com",
+ *   postType: "posts",
+ *   fields: ["title.rendered", "slug", "date"]
+ * })
+ * console.log(csv)
+ *
+ * @example
+ * // Save to file
+ * await exportToCSV({
+ *   endpoint: "https://example.com",
+ *   postType: "posts",
+ *   fields: ["title.rendered", "slug"],
+ *   outputFile: "./posts.csv"
+ * })
+ * console.log("Saved to posts.csv")
+ */
+export declare function exportToCSV(options: ExportOptions): Promise<string>;
+export type { AuthConfig } from "./auth.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA+CzE;AAGD,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -0,0 +1,64 @@
+import { fetchAllPosts } from "./fetch.js";
+import { toCSV } from "./csv.js";
+/**
+ * Main function to export WordPress content to CSV
+ *
+ * Fetches posts/pages/custom post types from WordPress REST API and converts to CSV format
+ * Automatically handles pagination and flattens nested fields
+ *
+ * @param {ExportOptions} options - Export configuration
+ * @returns {Promise<string>} CSV string with headers and data rows
+ *
+ * @throws {Error} If fetch fails, auth is invalid, or CSV generation fails
+ *
+ * @example
+ * // Return CSV as string
+ * const csv = await exportToCSV({
+ *   endpoint: "https://example.com",
+ *   postType: "posts",
+ *   fields: ["title.rendered", "slug", "date"]
+ * })
+ * console.log(csv)
+ *
+ * @example
+ * // Save to file
+ * await exportToCSV({
+ *   endpoint: "https://example.com",
+ *   postType: "posts",
+ *   fields: ["title.rendered", "slug"],
+ *   outputFile: "./posts.csv"
+ * })
+ * console.log("Saved to posts.csv")
+ */
+export async function exportToCSV(options) {
+    const { endpoint, postType, fields, auth, perPage, outputFile } = options;
+    if (!endpoint) {
+        throw new Error("Endpoint is required");
+    }
+    if (!postType) {
+        throw new Error("Post type is required");
+    }
+    if (!fields || fields.length === 0) {
+        throw new Error("At least one field is required");
+    }
+    const items = await fetchAllPosts(endpoint, postType, auth, perPage);
+    if (items.length === 0) {
+        console.warn("No items found for export");
+    }
+    const csv = toCSV(items, fields);
+    // Save to file if outputFile is specified
+    if (outputFile) {
+        try {
+            const fs = await import("fs/promises");
+            await fs.writeFile(outputFile, csv, "utf-8");
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to write to file ${outputFile}: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    return csv;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAuBhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAsB;IACtD,MAAM,EACJ,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,OAAO,EACP,UAAU,EACX,GAAG,OAAO,CAAA;IAEX,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;IACzC,CAAC;IACD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAC1C,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;IACnD,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,aAAa,CAC/B,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,OAAO,CACR,CAAA;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAEhC,0CAA0C;IAC1C,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAA;YACtC,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,2BAA2B,UAAU,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;YAC5E,CAAC;YACD,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/src/auth.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Authentication configuration options for WordPress REST API
+ *
+ * @typedef {Object} AuthConfig
+ * @property {string} type - Authentication type: "none", "basic", "bearer", or "headers"
+ */
+export type AuthConfig = {
+    type: "none";
+} | {
+    type: "basic";
+    username: string;
+    password: string;
+} | {
+    type: "bearer";
+    token: string;
+} | {
+    type: "headers";
+    headers: Record<string, string>;
+};
+/**
+ * Builds HTTP headers including authentication if provided
+ *
+ * @param {AuthConfig} [auth] - Optional authentication configuration
+ * @returns {HeadersInit} Headers object with authentication applied
+ *
+ * @example
+ * // Basic auth
+ * const headers = buildHeaders({
+ *   type: "basic",
+ *   username: "admin",
+ *   password: "password"
+ * })
+ *
+ * @example
+ * // Bearer token
+ * const headers = buildHeaders({
+ *   type: "bearer",
+ *   token: "eyJhbGc..."
+ * })
+ */
+export declare function buildHeaders(auth?: AuthConfig): HeadersInit;
+//# sourceMappingURL=auth.d.ts.map

package/dist/src/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAA;AAExD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,WAAW,CAuB3D"}

package/dist/src/auth.js

@@ -0,0 +1,42 @@
+/**
+ * Builds HTTP headers including authentication if provided
+ *
+ * @param {AuthConfig} [auth] - Optional authentication configuration
+ * @returns {HeadersInit} Headers object with authentication applied
+ *
+ * @example
+ * // Basic auth
+ * const headers = buildHeaders({
+ *   type: "basic",
+ *   username: "admin",
+ *   password: "password"
+ * })
+ *
+ * @example
+ * // Bearer token
+ * const headers = buildHeaders({
+ *   type: "bearer",
+ *   token: "eyJhbGc..."
+ * })
+ */
+export function buildHeaders(auth) {
+    const headers = {
+        "Content-Type": "application/json"
+    };
+    if (!auth || auth.type === "none")
+        return headers;
+    if (auth.type === "basic") {
+        const token = Buffer
+            .from(`${auth.username}:${auth.password}`)
+            .toString("base64");
+        headers.Authorization = `Basic ${token}`;
+    }
+    if (auth.type === "bearer") {
+        headers.Authorization = `Bearer ${auth.token}`;
+    }
+    if (auth.type === "headers") {
+        Object.assign(headers, auth.headers);
+    }
+    return headers;
+}
+//# sourceMappingURL=auth.js.map

package/dist/src/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/auth.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,YAAY,CAAC,IAAiB;IAC5C,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;KACnC,CAAA;IAED,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,OAAO,CAAA;IAEjD,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM;aACjB,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;aACzC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACrB,OAAO,CAAC,aAAa,GAAG,SAAS,KAAK,EAAE,CAAA;IAC1C,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,CAAC,aAAa,GAAG,UAAU,IAAI,CAAC,KAAK,EAAE,CAAA;IAChD,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;IACtC,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/src/csv.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Converts an array of objects to CSV format using specified fields
+ * Supports nested fields using dot notation
+ *
+ * @param {any[]} items - Array of objects to convert
+ * @param {string[]} fields - Field names to include in CSV (supports dot notation for nested fields)
+ * @returns {string} CSV string
+ *
+ * @throws {Error} If json2csv parsing fails
+ *
+ * @example
+ * const posts = [
+ *   { title: { rendered: "Post 1" }, slug: "post-1" },
+ *   { title: { rendered: "Post 2" }, slug: "post-2" }
+ * ]
+ *
+ * const csv = toCSV(posts, ["title.rendered", "slug"])
+ * // Returns CSV with headers: title.rendered,slug
+ */
+export declare function toCSV(items: any[], fields: string[]): string;
+//# sourceMappingURL=csv.d.ts.map

package/dist/src/csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../src/csv.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAsB5D"}

package/dist/src/csv.js

@@ -0,0 +1,57 @@
+import { Parser } from "json2csv";
+/**
+ * Gets a nested value from an object using dot notation
+ *
+ * @param {any} obj - Object to retrieve value from
+ * @param {string} path - Dot-separated path (e.g., "title.rendered", "acf.price")
+ * @returns {any} The value at the path, or undefined if not found
+ *
+ * @example
+ * const post = { title: { rendered: "Hello World" } }
+ * getValue(post, "title.rendered") // => "Hello World"
+ */
+function getValue(obj, path) {
+    return path.split(".").reduce((o, k) => o?.[k], obj);
+}
+/**
+ * Converts an array of objects to CSV format using specified fields
+ * Supports nested fields using dot notation
+ *
+ * @param {any[]} items - Array of objects to convert
+ * @param {string[]} fields - Field names to include in CSV (supports dot notation for nested fields)
+ * @returns {string} CSV string
+ *
+ * @throws {Error} If json2csv parsing fails
+ *
+ * @example
+ * const posts = [
+ *   { title: { rendered: "Post 1" }, slug: "post-1" },
+ *   { title: { rendered: "Post 2" }, slug: "post-2" }
+ * ]
+ *
+ * const csv = toCSV(posts, ["title.rendered", "slug"])
+ * // Returns CSV with headers: title.rendered,slug
+ */
+export function toCSV(items, fields) {
+    if (!items || items.length === 0) {
+        return "";
+    }
+    const rows = items.map(item => {
+        const row = {};
+        for (const field of fields) {
+            row[field] = getValue(item, field);
+        }
+        return row;
+    });
+    try {
+        const parser = new Parser({ fields });
+        return parser.parse(rows);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`CSV parsing failed: ${error.message}`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=csv.js.map

package/dist/src/csv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../src/csv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC;;;;;;;;;;GAUG;AACH,SAAS,QAAQ,CAAC,GAAQ,EAAE,IAAY;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AACtD,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,KAAK,CAAC,KAAY,EAAE,MAAgB;IAClD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QAC5B,MAAM,GAAG,GAAwB,EAAE,CAAA;QACnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,GAAG,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACpC,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACrC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QACzD,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/src/fetch.d.ts

@@ -0,0 +1,21 @@
+import { AuthConfig } from "./auth.js";
+/**
+ * Fetches all posts/pages/custom post types from WordPress REST API with automatic pagination
+ *
+ * @param {string} endpoint - WordPress site URL (e.g., "https://example.com")
+ * @param {string} postType - Post type to fetch (e.g., "posts", "pages", "custom-type")
+ * @param {AuthConfig} [auth] - Optional authentication configuration
+ * @param {number} [perPage=100] - Number of items per page (max 100)
+ * @returns {Promise<any[]>} Array of all posts across all pages
+ *
+ * @throws {Error} If the fetch request fails or returns non-ok status
+ *
+ * @example
+ * const posts = await fetchAllPosts(
+ *   "https://example.com",
+ *   "posts",
+ *   { type: "basic", username: "admin", password: "xxx" }
+ * )
+ */
+export declare function fetchAllPosts(endpoint: string, postType: string, auth?: AuthConfig, perPage?: number): Promise<any[]>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/src/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,UAAU,EAAE,MAAM,WAAW,CAAA;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,UAAU,EACjB,OAAO,SAAM,GACZ,OAAO,CAAC,GAAG,EAAE,CAAC,CA6BhB"}