kizlo 0.1.0

package/dist/wordpress/menu/items/types.d.ts

@@ -0,0 +1,214 @@
+import { WP_Context, WP_Link, WP_ListOrder } from "../../types.js";
+
+//#region src/wordpress/menu/items/types.d.ts
+/** The family of objects originally represented, such as 'post_type' or 'taxonomy'. */
+type WP_MenuItemType = "taxonomy" | "post_type" | "post_type_archive" | "custom";
+/** A named status for the object. Used in responses and as the input on create/update. */
+type WP_MenuItemStatus = "publish" | "future" | "draft" | "pending" | "private" | "trash";
+/** Status filter values accepted by `GET /wp/v2/menu-items`. Inherits the posts controller's filter enum, widening `WP_MenuItemStatus` with internal statuses and the `any` alias. */
+type WP_MenuItemStatusFilter = WP_MenuItemStatus | "auto-draft" | "inherit" | "any";
+/** The target attribute of the link element for this menu item. */
+type WP_MenuItemTarget = "_blank" | "";
+/** Sort collection by object attribute. */
+type WP_MenuItemOrderBy = "author" | "date" | "id" | "include" | "modified" | "parent" | "relevance" | "slug" | "include_slugs" | "title" | "menu_order";
+/** Limit result set based on relationship between multiple taxonomies. */
+type WP_MenuItemTaxRelation = "AND" | "OR";
+/** The title for the menu item. */
+interface WP_MenuItemTitle {
+  /** HTML title for the object, transformed for display. */
+  rendered: string;
+  /** Title for the object, as it exists in the database. */
+  raw: string;
+}
+/** Title input for create/update — WP accepts a plain string or `{ raw }`. */
+type WP_MenuItemTitleInput = string | {
+  raw: string;
+};
+/** Hypermedia links for the menu item resource. */
+interface WP_MenuItemLinks {
+  self?: WP_Link[];
+  collection?: WP_Link[];
+  about?: WP_Link[];
+  "version-history"?: WP_Link[];
+  "predecessor-version"?: WP_Link[];
+  "wp:attachment"?: WP_Link[];
+  "wp:term"?: WP_Link[];
+  "wp:object"?: WP_Link[];
+  curies?: WP_Link[];
+  [rel: string]: WP_Link[] | undefined;
+}
+interface WP_MenuItem {
+  /** The title for the object. */
+  title: WP_MenuItemTitle;
+  /** Unique identifier for the object. */
+  id: number;
+  /** The singular label used to describe this type of menu item. */
+  type_label: string;
+  /** The family of objects originally represented, such as 'post_type' or 'taxonomy'. */
+  type: WP_MenuItemType;
+  /** A named status for the object. */
+  status: WP_MenuItemStatus;
+  /** The ID for the parent of the object. */
+  parent: number;
+  /** Text for the title attribute of the link element for this menu item. */
+  attr_title: string;
+  /** Class names for the link element of this menu item. */
+  classes: string[];
+  /** The description of this menu item. */
+  description: string;
+  /** The DB ID of the nav_menu_item that is this item's menu parent, if any, otherwise 0. */
+  menu_order: number;
+  /** The type of object originally represented, such as 'category', 'post', or 'attachment'. */
+  object: string;
+  /** The database ID of the original object this menu item represents, for example the ID for posts or the term_id for categories. */
+  object_id: number;
+  /** The target attribute of the link element for this menu item. */
+  target: WP_MenuItemTarget;
+  /** The URL to which this menu item points. */
+  url: string;
+  /** The XFN relationship expressed in the link of this menu item. */
+  xfn: string[];
+  /** Whether the menu item represents an object that no longer exists. */
+  invalid: boolean;
+  /** The terms assigned to the object in the nav_menu taxonomy. */
+  menus: number;
+  /** Meta fields. */
+  meta: Record<string, unknown>;
+  /** Hypermedia links. */
+  _links?: WP_MenuItemLinks;
+}
+interface WP_MenuItemListInput {
+  /** Scope under which the request is made; determines fields present in response. */
+  context?: WP_Context;
+  /** Current page of the collection. */
+  page?: number;
+  /** Maximum number of items to be returned in result set. */
+  per_page?: number;
+  /** Limit results to those matching a string. */
+  search?: string;
+  /** Limit response to posts published after a given ISO8601 compliant date. */
+  after?: string;
+  /** Limit response to posts modified after a given ISO8601 compliant date. */
+  modified_after?: string;
+  /** Limit response to posts published before a given ISO8601 compliant date. */
+  before?: string;
+  /** Limit response to posts modified before a given ISO8601 compliant date. */
+  modified_before?: string;
+  /** Ensure result set excludes specific IDs. */
+  exclude?: number | number[];
+  /** Limit result set to specific IDs. */
+  include?: number | number[];
+  /** Offset the result set by a specific number of items. */
+  offset?: number;
+  /** Order sort attribute ascending or descending. */
+  order?: WP_ListOrder;
+  /** Sort collection by object attribute. */
+  orderby?: WP_MenuItemOrderBy;
+  /** Array of column names to be searched. */
+  search_columns?: string[];
+  /** Limit result set to posts with one or more specific slugs. */
+  slug?: string | string[];
+  /** Limit result set to posts assigned one or more statuses. */
+  status?: WP_MenuItemStatusFilter | WP_MenuItemStatusFilter[];
+  /** Limit result set based on relationship between multiple taxonomies. */
+  tax_relation?: WP_MenuItemTaxRelation;
+  /** Limit result set to items with specific terms assigned in the menus taxonomy. */
+  menus?: number | number[];
+  /** Limit result set to items except those with specific terms assigned in the menus taxonomy. */
+  menus_exclude?: number | number[];
+  /** Limit result set to posts with a specific menu_order value. */
+  menu_order?: number;
+}
+type WP_MenuItemListErrorCode = "rest_no_search_term_defined" | "rest_orderby_include_missing_include" | "rest_post_invalid_page_number" | "rest_cannot_view" | "rest_forbidden_context";
+interface WP_MenuItemCreateInput {
+  /** The title for the object. */
+  title?: WP_MenuItemTitleInput;
+  /** The family of objects originally represented, such as 'post_type' or 'taxonomy'. */
+  type?: WP_MenuItemType;
+  /** A named status for the object. */
+  status?: WP_MenuItemStatus;
+  /** The ID for the parent of the object. */
+  parent?: number;
+  /** Text for the title attribute of the link element for this menu item. */
+  attr_title?: string;
+  /** Class names for the link element of this menu item. */
+  classes?: string[];
+  /** The description of this menu item. */
+  description?: string;
+  /** The DB ID of the nav_menu_item that is this item's menu parent, if any, otherwise 0. */
+  menu_order?: number;
+  /** The type of object originally represented, such as 'category', 'post', or 'attachment'. */
+  object?: string;
+  /** The database ID of the original object this menu item represents, for example the ID for posts or the term_id for categories. */
+  object_id?: number;
+  /** The target attribute of the link element for this menu item. */
+  target?: WP_MenuItemTarget;
+  /** The URL to which this menu item points. */
+  url?: string;
+  /** The XFN relationship expressed in the link of this menu item. */
+  xfn?: string[];
+  /** The terms assigned to the object in the nav_menu taxonomy. */
+  menus?: number;
+  /** Meta fields. */
+  meta?: Record<string, unknown>;
+}
+type WP_MenuItemCreateErrorCode = "rest_invalid_author" | "rest_invalid_field" | "rest_post_exists" | "rest_post_invalid_id" | "rest_post_invalid_type" | "rest_term_invalid_id" | "rest_title_required" | "rest_url_required" | "rest_cannot_assign_sticky" | "rest_cannot_assign_term" | "rest_cannot_create" | "rest_cannot_edit_others" | "rest_cannot_publish" | "rest_forbidden_status" | "db_insert_error";
+interface WP_MenuItemRetrieveInput {
+  /** Unique identifier for the post. */
+  id: number;
+  /** Scope under which the request is made; determines fields present in response. */
+  context?: WP_Context;
+}
+type WP_MenuItemRetrieveErrorCode = "rest_cannot_view" | "rest_forbidden_context" | "rest_post_incorrect_password" | "rest_post_invalid_id";
+interface WP_MenuItemUpdateInput {
+  /** Unique identifier for the post. */
+  id: number;
+  /** The title for the object. */
+  title?: WP_MenuItemTitleInput;
+  /** The family of objects originally represented, such as 'post_type' or 'taxonomy'. */
+  type?: WP_MenuItemType;
+  /** A named status for the object. */
+  status?: WP_MenuItemStatus;
+  /** The ID for the parent of the object. */
+  parent?: number;
+  /** Text for the title attribute of the link element for this menu item. */
+  attr_title?: string;
+  /** Class names for the link element of this menu item. */
+  classes?: string[];
+  /** The description of this menu item. */
+  description?: string;
+  /** The DB ID of the nav_menu_item that is this item's menu parent, if any, otherwise 0. */
+  menu_order?: number;
+  /** The type of object originally represented, such as 'category', 'post', or 'attachment'. */
+  object?: string;
+  /** The database ID of the original object this menu item represents, for example the ID for posts or the term_id for categories. */
+  object_id?: number;
+  /** The target attribute of the link element for this menu item. */
+  target?: WP_MenuItemTarget;
+  /** The URL to which this menu item points. */
+  url?: string;
+  /** The XFN relationship expressed in the link of this menu item. */
+  xfn?: string[];
+  /** The terms assigned to the object in the nav_menu taxonomy. */
+  menus?: number;
+  /** Meta fields. */
+  meta?: Record<string, unknown>;
+}
+type WP_MenuItemUpdateErrorCode = "rest_invalid_author" | "rest_invalid_field" | "rest_post_invalid_id" | "rest_post_invalid_type" | "rest_term_invalid_id" | "rest_title_required" | "rest_url_required" | "rest_cannot_assign_sticky" | "rest_cannot_assign_term" | "rest_cannot_edit" | "rest_cannot_edit_others" | "rest_cannot_publish" | "rest_forbidden_status" | "db_update_error";
+interface WP_MenuItemDeleteInput {
+  /** Unique identifier for the post. */
+  id: number;
+  /** Whether to bypass Trash and force deletion. */
+  force?: boolean;
+}
+/**
+ * Response from `DELETE /wp/v2/menu-items/<id>`.
+ * Menu items do not support trashing — `force=true` is required, so the response is always `{ deleted: true, previous: WP_MenuItem }`.
+ */
+type WP_MenuItemDeleteResponse = {
+  deleted: true;
+  previous: WP_MenuItem;
+};
+type WP_MenuItemDeleteErrorCode = "rest_cannot_delete" | "rest_user_cannot_delete_post" | "rest_post_invalid_id" | "rest_already_trashed" | "rest_trash_not_supported";
+//#endregion
+export { WP_MenuItem, WP_MenuItemCreateErrorCode, WP_MenuItemCreateInput, WP_MenuItemDeleteErrorCode, WP_MenuItemDeleteInput, WP_MenuItemDeleteResponse, WP_MenuItemLinks, WP_MenuItemListErrorCode, WP_MenuItemListInput, WP_MenuItemOrderBy, WP_MenuItemRetrieveErrorCode, WP_MenuItemRetrieveInput, WP_MenuItemStatus, WP_MenuItemStatusFilter, WP_MenuItemTarget, WP_MenuItemTaxRelation, WP_MenuItemTitle, WP_MenuItemTitleInput, WP_MenuItemType, WP_MenuItemUpdateErrorCode, WP_MenuItemUpdateInput };

package/dist/wordpress/menu/service.d.ts

@@ -0,0 +1,30 @@
+import { WP_Error } from "../error.js";
+import { WP_List, WP_Result } from "../types.js";
+import { MenuItemService } from "./items/service.js";
+import { WP_Menu, WP_MenuCreateErrorCode, WP_MenuCreateInput, WP_MenuDeleteErrorCode, WP_MenuDeleteInput, WP_MenuDeleteResponse, WP_MenuListErrorCode, WP_MenuListInput, WP_MenuRetrieveErrorCode, WP_MenuRetrieveInput, WP_MenuUpdateErrorCode, WP_MenuUpdateInput } from "./types.js";
+import { WordPressService } from "../service.js";
+import "../index.js";
+
+//#region src/wordpress/menu/service.d.ts
+declare class MenuService {
+  readonly items: MenuItemService;
+  private readonly wordpress;
+  constructor(wordpress: WordPressService);
+  list(input: WP_MenuListInput): Promise<{
+    data: null;
+    status: number;
+    headers: Headers;
+    error: WP_Error<WP_MenuListErrorCode>;
+  } | {
+    data: WP_List<WP_Menu>;
+    status: number;
+    headers: Headers;
+    error: null;
+  }>;
+  create(input: WP_MenuCreateInput): Promise<WP_Result<WP_Menu, WP_MenuCreateErrorCode>>;
+  get(input: WP_MenuRetrieveInput): Promise<WP_Result<WP_Menu, WP_MenuRetrieveErrorCode>>;
+  update(input: WP_MenuUpdateInput): Promise<WP_Result<WP_Menu, WP_MenuUpdateErrorCode>>;
+  delete(input: WP_MenuDeleteInput): Promise<WP_Result<WP_MenuDeleteResponse, WP_MenuDeleteErrorCode>>;
+}
+//#endregion
+export { MenuService };

package/dist/wordpress/menu/service.js

@@ -0,0 +1,58 @@
+import { WP_CORE_BASE } from "../constants.js";
+import { MenuItemService } from "./items/service.js";
+
+//#region src/wordpress/menu/service.ts
+var MenuService = class {
+	items;
+	wordpress;
+	constructor(wordpress) {
+		this.wordpress = wordpress;
+		this.items = new MenuItemService(wordpress);
+	}
+	async list(input) {
+		const { ...searchParams } = input;
+		const result = await this.wordpress.get("/menus", {
+			base: WP_CORE_BASE,
+			searchParams
+		});
+		if (result.error) return result;
+		return {
+			...result,
+			data: this.wordpress.resolveList({
+				data: result.data,
+				headers: result.headers,
+				searchParams
+			})
+		};
+	}
+	async create(input) {
+		return this.wordpress.post("/menus", {
+			base: WP_CORE_BASE,
+			body: input
+		});
+	}
+	async get(input) {
+		const { id,...searchParams } = input;
+		return this.wordpress.get(`/menus/${id}`, {
+			base: WP_CORE_BASE,
+			searchParams
+		});
+	}
+	async update(input) {
+		const { id,...body } = input;
+		return this.wordpress.post(`/menus/${id}`, {
+			base: WP_CORE_BASE,
+			body
+		});
+	}
+	async delete(input) {
+		const { id,...searchParams } = input;
+		return this.wordpress.delete(`/menus/${id}`, {
+			base: WP_CORE_BASE,
+			searchParams
+		});
+	}
+};
+
+//#endregion
+export { MenuService };

package/dist/wordpress/menu/types.d.ts

@@ -0,0 +1,115 @@
+import { WP_Context, WP_Link, WP_ListOrder } from "../types.js";
+
+//#region src/wordpress/menu/types.d.ts
+/** Sort collection by term attribute. */
+type WP_MenuOrderBy = "id" | "include" | "name" | "slug" | "include_slugs" | "term_group" | "description" | "count";
+/** Hypermedia links for the menu resource. */
+interface WP_MenuLinks {
+  self?: WP_Link[];
+  collection?: WP_Link[];
+  about?: WP_Link[];
+  "wp:post_type"?: WP_Link[];
+  curies?: WP_Link[];
+  [rel: string]: WP_Link[] | undefined;
+}
+interface WP_Menu {
+  /** Unique identifier for the term. */
+  id: number;
+  /** HTML description of the term. */
+  description: string;
+  /** HTML title for the term. */
+  name: string;
+  /** An alphanumeric identifier for the term unique to its type. */
+  slug: string;
+  /** Meta fields. */
+  meta: Record<string, unknown>;
+  /** The locations assigned to the menu. */
+  locations: string[];
+  /** Whether to automatically add top level pages to this menu. */
+  auto_add: boolean;
+  /** Hypermedia links. */
+  _links?: WP_MenuLinks;
+}
+interface WP_MenuListInput {
+  /** Scope under which the request is made; determines fields present in response. */
+  context?: WP_Context;
+  /** Current page of the collection. */
+  page?: number;
+  /** Maximum number of items to be returned in result set. */
+  per_page?: number;
+  /** Limit results to those matching a string. */
+  search?: string;
+  /** Ensure result set excludes specific IDs. */
+  exclude?: number | number[];
+  /** Limit result set to specific IDs. */
+  include?: number | number[];
+  /** Offset the result set by a specific number of items. */
+  offset?: number;
+  /** Order sort attribute ascending or descending. */
+  order?: WP_ListOrder;
+  /** Sort collection by term attribute. */
+  orderby?: WP_MenuOrderBy;
+  /** Whether to hide terms not assigned to any posts. */
+  hide_empty?: boolean;
+  /** Limit result set to terms assigned to a specific post. */
+  post?: number;
+  /** Limit result set to terms with one or more specific slugs. */
+  slug?: string | string[];
+}
+type WP_MenuListErrorCode = "rest_post_invalid_id" | "rest_cannot_view" | "rest_forbidden_context";
+interface WP_MenuCreateInput {
+  /** HTML title for the term. */
+  name?: string;
+  /** HTML description of the term. */
+  description?: string;
+  /** An alphanumeric identifier for the term unique to its type. */
+  slug?: string;
+  /** Meta fields. */
+  meta?: Record<string, unknown>;
+  /** The locations assigned to the menu. */
+  locations?: string[];
+  /** Whether to automatically add top level pages to this menu. */
+  auto_add?: boolean;
+}
+type WP_MenuCreateErrorCode = "rest_invalid_menu_location" | "rest_taxonomy_not_hierarchical" | "rest_term_invalid" | "rest_cannot_create";
+interface WP_MenuRetrieveInput {
+  /** Unique identifier for the term. */
+  id: number;
+  /** Scope under which the request is made; determines fields present in response. */
+  context?: WP_Context;
+}
+type WP_MenuRetrieveErrorCode = "rest_cannot_view" | "rest_forbidden_context" | "rest_term_invalid";
+interface WP_MenuUpdateInput {
+  /** Unique identifier for the term. */
+  id: number;
+  /** HTML description of the term. */
+  description?: string;
+  /** HTML title for the term. */
+  name?: string;
+  /** An alphanumeric identifier for the term unique to its type. */
+  slug?: string;
+  /** Meta fields. */
+  meta?: Record<string, unknown>;
+  /** The locations assigned to the menu. */
+  locations?: string[];
+  /** Whether to automatically add top level pages to this menu. */
+  auto_add?: boolean;
+}
+type WP_MenuUpdateErrorCode = "rest_invalid_menu_location" | "rest_taxonomy_not_hierarchical" | "rest_term_invalid" | "rest_cannot_update";
+interface WP_MenuDeleteInput {
+  /** Unique identifier for the term. */
+  id: number;
+  /** Required to be true, as terms do not support trashing. */
+  force?: boolean;
+}
+/**
+ * Response from `DELETE /wp/v2/menus/<id>`.
+ * Menus do not support trashing — `force=true` is required, so the response is always `{ deleted: true, previous: WP_Menu }`.
+ */
+type WP_MenuDeleteResponse = {
+  deleted: true;
+  previous: WP_Menu;
+};
+type WP_MenuDeleteErrorCode = "rest_cannot_delete" | "rest_term_invalid" | "rest_trash_not_supported";
+//#endregion
+export { WP_Menu, WP_MenuCreateErrorCode, WP_MenuCreateInput, WP_MenuDeleteErrorCode, WP_MenuDeleteInput, WP_MenuDeleteResponse, WP_MenuLinks, WP_MenuListErrorCode, WP_MenuListInput, WP_MenuOrderBy, WP_MenuRetrieveErrorCode, WP_MenuRetrieveInput, WP_MenuUpdateErrorCode, WP_MenuUpdateInput };

package/dist/wordpress/post/service.d.ts

@@ -0,0 +1,28 @@
+import { WP_Error } from "../error.js";
+import { WP_List, WP_Result } from "../types.js";
+import { WP_Post, WP_PostCreateErrorCode, WP_PostCreateInput, WP_PostDeleteErrorCode, WP_PostDeleteInput, WP_PostDeleteResponse, WP_PostListErrorCode, WP_PostListInput, WP_PostRetrieveErrorCode, WP_PostRetrieveInput, WP_PostUpdateErrorCode, WP_PostUpdateInput } from "./types.js";
+import { WordPressService } from "../service.js";
+import "../index.js";
+
+//#region src/wordpress/post/service.d.ts
+declare class PostService {
+  private readonly wordpress;
+  constructor(wordpress: WordPressService);
+  list(input: WP_PostListInput): Promise<{
+    data: null;
+    status: number;
+    headers: Headers;
+    error: WP_Error<WP_PostListErrorCode>;
+  } | {
+    data: WP_List<WP_Post>;
+    status: number;
+    headers: Headers;
+    error: null;
+  }>;
+  create(input: WP_PostCreateInput): Promise<WP_Result<WP_Post, WP_PostCreateErrorCode>>;
+  get(input: WP_PostRetrieveInput): Promise<WP_Result<WP_Post, WP_PostRetrieveErrorCode>>;
+  update(input: WP_PostUpdateInput): Promise<WP_Result<WP_Post, WP_PostUpdateErrorCode>>;
+  delete(input: WP_PostDeleteInput): Promise<WP_Result<WP_PostDeleteResponse, WP_PostDeleteErrorCode>>;
+}
+//#endregion
+export { PostService };

package/dist/wordpress/post/service.js

@@ -0,0 +1,55 @@
+import { WP_CORE_BASE } from "../constants.js";
+
+//#region src/wordpress/post/service.ts
+var PostService = class {
+	wordpress;
+	constructor(wordpress) {
+		this.wordpress = wordpress;
+	}
+	async list(input) {
+		const { ...searchParams } = input;
+		const result = await this.wordpress.get("/posts", {
+			base: WP_CORE_BASE,
+			searchParams
+		});
+		if (result.error) return result;
+		return {
+			...result,
+			data: this.wordpress.resolveList({
+				data: result.data,
+				headers: result.headers,
+				searchParams
+			})
+		};
+	}
+	async create(input) {
+		return this.wordpress.post("/posts", {
+			base: WP_CORE_BASE,
+			body: input
+		});
+	}
+	async get(input) {
+		const { id,...searchParams } = input;
+		return this.wordpress.get(`/posts/${id}`, {
+			base: WP_CORE_BASE,
+			searchParams
+		});
+	}
+	async update(input) {
+		const { id,...body } = input;
+		return this.wordpress.post(`/posts/${id}`, {
+			base: WP_CORE_BASE,
+			body
+		});
+	}
+	async delete(input) {
+		const { id,...searchParams } = input;
+		return this.wordpress.delete(`/posts/${id}`, {
+			base: WP_CORE_BASE,
+			searchParams
+		});
+	}
+};
+
+//#endregion
+export { PostService };