@atomic-solutions/wordpress-api-client 0.1.0

package/dist/utils/index.cjs

@@ -0,0 +1,47 @@
+'use strict';
+
+// src/utils/calculatePagination.ts
+var calculatePagination = (input) => {
+  const { page, perPage, total, totalPages } = input;
+  const hasNextPage = page < totalPages;
+  const hasPrevPage = page > 1;
+  return {
+    page,
+    perPage,
+    total,
+    totalPages,
+    hasNextPage,
+    hasPrevPage,
+    nextPage: hasNextPage ? page + 1 : null,
+    prevPage: hasPrevPage ? page - 1 : null
+  };
+};
+
+// src/utils/getPaginationMeta.ts
+var getPaginationMeta = (headers) => {
+  if (!headers) {
+    return {
+      total: 0,
+      totalPages: 0
+    };
+  }
+  const wpTotal = headers["x-wp-total"];
+  const wpTotalPages = headers["x-wp-totalpages"];
+  if (!wpTotal || !wpTotalPages) {
+    return {
+      total: 0,
+      totalPages: 0
+    };
+  }
+  const total = parseInt(wpTotal, 10);
+  const totalPages = parseInt(wpTotalPages, 10);
+  return {
+    total,
+    totalPages
+  };
+};
+
+exports.calculatePagination = calculatePagination;
+exports.getPaginationMeta = getPaginationMeta;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/utils/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/calculatePagination.ts","../../src/utils/getPaginationMeta.ts"],"names":[],"mappings":";;;AA4BO,IAAM,mBAAA,GAAsB,CAAC,KAAA,KAAgD;AAClF,EAAA,MAAM,EAAE,IAAA,EAAM,OAAA,EAAS,KAAA,EAAO,YAAW,GAAI,KAAA;AAE7C,EAAA,MAAM,cAAc,IAAA,GAAO,UAAA;AAC3B,EAAA,MAAM,cAAc,IAAA,GAAO,CAAA;AAE3B,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,OAAA;AAAA,IACA,KAAA;AAAA,IACA,UAAA;AAAA,IACA,WAAA;AAAA,IACA,WAAA;AAAA,IACA,QAAA,EAAU,WAAA,GAAc,IAAA,GAAO,CAAA,GAAI,IAAA;AAAA,IACnC,QAAA,EAAU,WAAA,GAAc,IAAA,GAAO,CAAA,GAAI;AAAA,GACrC;AACF;;;ACzBO,IAAM,iBAAA,GAAoB,CAAC,OAAA,KAAsD;AAEtF,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,OAAO;AAAA,MACL,KAAA,EAAO,CAAA;AAAA,MACP,UAAA,EAAY;AAAA,KACd;AAAA,EACF;AAEA,EAAA,MAAM,OAAA,GAAU,QAAQ,YAAY,CAAA;AACpC,EAAA,MAAM,YAAA,GAAe,QAAQ,iBAAiB,CAAA;AAE9C,EAAA,IAAI,CAAC,OAAA,IAAW,CAAC,YAAA,EAAc;AAC7B,IAAA,OAAO;AAAA,MACL,KAAA,EAAO,CAAA;AAAA,MACP,UAAA,EAAY;AAAA,KACd;AAAA,EACF;AAEA,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,OAAA,EAAS,EAAE,CAAA;AAClC,EAAA,MAAM,UAAA,GAAa,QAAA,CAAS,YAAA,EAAc,EAAE,CAAA;AAE5C,EAAA,OAAO;AAAA,IACL,KAAA;AAAA,IACA;AAAA,GACF;AACF","file":"index.cjs","sourcesContent":["/**\n * Calculate pagination navigation\n */\n\nexport interface Pagination {\n  page: number;\n  perPage: number;\n  total: number;\n  totalPages: number;\n  hasNextPage: boolean;\n  hasPrevPage: boolean;\n  nextPage: number | null;\n  prevPage: number | null;\n}\n\nexport interface CalculatePaginationInput {\n  page: number;\n  perPage: number;\n  total: number;\n  totalPages: number;\n}\n\n/**\n * Calculate pagination navigation from WordPress pagination metadata\n *\n * @param input - Current pagination state\n * @returns Full pagination object with navigation helpers\n */\nexport const calculatePagination = (input: CalculatePaginationInput): Pagination => {\n  const { page, perPage, total, totalPages } = input;\n\n  const hasNextPage = page < totalPages;\n  const hasPrevPage = page > 1;\n\n  return {\n    page,\n    perPage,\n    total,\n    totalPages,\n    hasNextPage,\n    hasPrevPage,\n    nextPage: hasNextPage ? page + 1 : null,\n    prevPage: hasPrevPage ? page - 1 : null,\n  };\n};\n","/**\n * Extract pagination metadata from WordPress response headers\n */\n\nimport type { AxiosResponse } from 'axios';\n\nexport interface PaginationMeta {\n  total: number;\n  totalPages: number;\n}\n\n/**\n * Extract pagination metadata from WordPress REST API headers\n *\n * WordPress uses x-wp-total and x-wp-totalpages headers for pagination\n *\n * @param headers - Axios response headers\n * @returns Pagination metadata object\n */\nexport const getPaginationMeta = (headers: AxiosResponse['headers']): PaginationMeta => {\n  // Handle undefined/null headers\n  if (!headers) {\n    return {\n      total: 0,\n      totalPages: 0,\n    };\n  }\n\n  const wpTotal = headers['x-wp-total'];\n  const wpTotalPages = headers['x-wp-totalpages'];\n\n  if (!wpTotal || !wpTotalPages) {\n    return {\n      total: 0,\n      totalPages: 0,\n    };\n  }\n\n  const total = parseInt(wpTotal, 10);\n  const totalPages = parseInt(wpTotalPages, 10);\n\n  return {\n    total,\n    totalPages,\n  };\n};\n"]}

package/dist/utils/index.d.cts

@@ -0,0 +1,10 @@
+export { P as Pagination, c as calculatePagination } from '../calculatePagination-WUlN3OdM.cjs';
+import { AxiosResponse } from 'axios';
+
+interface PaginationMeta {
+    total: number;
+    totalPages: number;
+}
+declare const getPaginationMeta: (headers: AxiosResponse["headers"]) => PaginationMeta;
+
+export { type PaginationMeta, getPaginationMeta };

package/dist/utils/index.d.ts

@@ -0,0 +1,10 @@
+export { P as Pagination, c as calculatePagination } from '../calculatePagination-WUlN3OdM.js';
+import { AxiosResponse } from 'axios';
+
+interface PaginationMeta {
+    total: number;
+    totalPages: number;
+}
+declare const getPaginationMeta: (headers: AxiosResponse["headers"]) => PaginationMeta;
+
+export { type PaginationMeta, getPaginationMeta };

package/dist/utils/index.js

@@ -0,0 +1,44 @@
+// src/utils/calculatePagination.ts
+var calculatePagination = (input) => {
+  const { page, perPage, total, totalPages } = input;
+  const hasNextPage = page < totalPages;
+  const hasPrevPage = page > 1;
+  return {
+    page,
+    perPage,
+    total,
+    totalPages,
+    hasNextPage,
+    hasPrevPage,
+    nextPage: hasNextPage ? page + 1 : null,
+    prevPage: hasPrevPage ? page - 1 : null
+  };
+};
+
+// src/utils/getPaginationMeta.ts
+var getPaginationMeta = (headers) => {
+  if (!headers) {
+    return {
+      total: 0,
+      totalPages: 0
+    };
+  }
+  const wpTotal = headers["x-wp-total"];
+  const wpTotalPages = headers["x-wp-totalpages"];
+  if (!wpTotal || !wpTotalPages) {
+    return {
+      total: 0,
+      totalPages: 0
+    };
+  }
+  const total = parseInt(wpTotal, 10);
+  const totalPages = parseInt(wpTotalPages, 10);
+  return {
+    total,
+    totalPages
+  };
+};
+
+export { calculatePagination, getPaginationMeta };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/calculatePagination.ts","../../src/utils/getPaginationMeta.ts"],"names":[],"mappings":";AA4BO,IAAM,mBAAA,GAAsB,CAAC,KAAA,KAAgD;AAClF,EAAA,MAAM,EAAE,IAAA,EAAM,OAAA,EAAS,KAAA,EAAO,YAAW,GAAI,KAAA;AAE7C,EAAA,MAAM,cAAc,IAAA,GAAO,UAAA;AAC3B,EAAA,MAAM,cAAc,IAAA,GAAO,CAAA;AAE3B,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,OAAA;AAAA,IACA,KAAA;AAAA,IACA,UAAA;AAAA,IACA,WAAA;AAAA,IACA,WAAA;AAAA,IACA,QAAA,EAAU,WAAA,GAAc,IAAA,GAAO,CAAA,GAAI,IAAA;AAAA,IACnC,QAAA,EAAU,WAAA,GAAc,IAAA,GAAO,CAAA,GAAI;AAAA,GACrC;AACF;;;ACzBO,IAAM,iBAAA,GAAoB,CAAC,OAAA,KAAsD;AAEtF,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,OAAO;AAAA,MACL,KAAA,EAAO,CAAA;AAAA,MACP,UAAA,EAAY;AAAA,KACd;AAAA,EACF;AAEA,EAAA,MAAM,OAAA,GAAU,QAAQ,YAAY,CAAA;AACpC,EAAA,MAAM,YAAA,GAAe,QAAQ,iBAAiB,CAAA;AAE9C,EAAA,IAAI,CAAC,OAAA,IAAW,CAAC,YAAA,EAAc;AAC7B,IAAA,OAAO;AAAA,MACL,KAAA,EAAO,CAAA;AAAA,MACP,UAAA,EAAY;AAAA,KACd;AAAA,EACF;AAEA,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,OAAA,EAAS,EAAE,CAAA;AAClC,EAAA,MAAM,UAAA,GAAa,QAAA,CAAS,YAAA,EAAc,EAAE,CAAA;AAE5C,EAAA,OAAO;AAAA,IACL,KAAA;AAAA,IACA;AAAA,GACF;AACF","file":"index.js","sourcesContent":["/**\n * Calculate pagination navigation\n */\n\nexport interface Pagination {\n  page: number;\n  perPage: number;\n  total: number;\n  totalPages: number;\n  hasNextPage: boolean;\n  hasPrevPage: boolean;\n  nextPage: number | null;\n  prevPage: number | null;\n}\n\nexport interface CalculatePaginationInput {\n  page: number;\n  perPage: number;\n  total: number;\n  totalPages: number;\n}\n\n/**\n * Calculate pagination navigation from WordPress pagination metadata\n *\n * @param input - Current pagination state\n * @returns Full pagination object with navigation helpers\n */\nexport const calculatePagination = (input: CalculatePaginationInput): Pagination => {\n  const { page, perPage, total, totalPages } = input;\n\n  const hasNextPage = page < totalPages;\n  const hasPrevPage = page > 1;\n\n  return {\n    page,\n    perPage,\n    total,\n    totalPages,\n    hasNextPage,\n    hasPrevPage,\n    nextPage: hasNextPage ? page + 1 : null,\n    prevPage: hasPrevPage ? page - 1 : null,\n  };\n};\n","/**\n * Extract pagination metadata from WordPress response headers\n */\n\nimport type { AxiosResponse } from 'axios';\n\nexport interface PaginationMeta {\n  total: number;\n  totalPages: number;\n}\n\n/**\n * Extract pagination metadata from WordPress REST API headers\n *\n * WordPress uses x-wp-total and x-wp-totalpages headers for pagination\n *\n * @param headers - Axios response headers\n * @returns Pagination metadata object\n */\nexport const getPaginationMeta = (headers: AxiosResponse['headers']): PaginationMeta => {\n  // Handle undefined/null headers\n  if (!headers) {\n    return {\n      total: 0,\n      totalPages: 0,\n    };\n  }\n\n  const wpTotal = headers['x-wp-total'];\n  const wpTotalPages = headers['x-wp-totalpages'];\n\n  if (!wpTotal || !wpTotalPages) {\n    return {\n      total: 0,\n      totalPages: 0,\n    };\n  }\n\n  const total = parseInt(wpTotal, 10);\n  const totalPages = parseInt(wpTotalPages, 10);\n\n  return {\n    total,\n    totalPages,\n  };\n};\n"]}

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "@atomic-solutions/wordpress-api-client",
+  "version": "0.1.0",
+  "description": "Type-safe WordPress REST API client (platform-agnostic)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js",
+      "require": "./dist/client/index.cjs"
+    },
+    "./schemas": {
+      "types": "./dist/schemas/index.d.ts",
+      "import": "./dist/schemas/index.js",
+      "require": "./dist/schemas/index.cjs"
+    },
+    "./http": {
+      "types": "./dist/http/index.d.ts",
+      "import": "./dist/http/index.js",
+      "require": "./dist/http/index.cjs"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.js",
+      "require": "./dist/utils/index.cjs"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js",
+      "require": "./dist/testing/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "README.md",
+    "dist",
+    "LICENSE"
+  ],
+  "keywords": [
+    "wordpress",
+    "rest-api",
+    "wp-json",
+    "typescript",
+    "platform-agnostic",
+    "client",
+    "api-client"
+  ],
+  "author": "Atomic Solutions",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/atomic-solutions/wordpress-woocommerce-monorepo",
+    "directory": "packages/wordpress-utils"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "axios": ">=1.7.0",
+    "zod": ">=3.0.0"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@types/node": "^24.10.1",
+    "@typescript-eslint/eslint-plugin": "^8.48.0",
+    "@vitest/coverage-v8": "^2.0.0",
+    "axios": "^1.7.7",
+    "axios-mock-adapter": "^2.1.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "prettier": "^3.0.0",
+    "release-it": "^19.0.6",
+    "tsup": "^8.0.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.0",
+    "vitest": "^2.0.0",
+    "zod": "^3.23.0"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "test": "vitest run --exclude '**/wordpress-api.integration.test.ts' --passWithNoTests",
+    "test:integration": "vitest run tests/integration/wordpress-api.integration.test.ts",
+    "test:all": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage --exclude '**/wordpress-api.integration.test.ts'",
+    "clean": "rm -rf dist"
+  }
+}