@waline/client 2.0.0-alpha.4 → 2.0.2

package/dist/pageview.cjs.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});const e=e=>{"AbortError"!==e.name&&console.error(e.message)},t=(e,t="")=>{if("object"==typeof e&&e.errno)throw new TypeError(`Fetch ${t} failed with ${e.errno}: ${e.errmsg}`);return e},r=({serverURL:e,paths:r,signal:n})=>fetch(`${e}/article?path=${encodeURIComponent(r.join(","))}`,{signal:n}).then((e=>e.json())).then((e=>t(e,"visit count"))).then((e=>Array.isArray(e)?e:[e])),n=({serverURL:e,path:r})=>fetch(`${e}/article`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({path:r})}).then((e=>e.json())).then((e=>t(e,"visit count"))),o=e=>e.dataset.path||e.getAttribute("id"),a=(e,t)=>{t.forEach(((t,r)=>{t.innerText=e[r].toString()}))};exports.pageviewCount=({serverURL:t,path:s=window.location.pathname,selector:i=".waline-pageview-count",update:l=!0})=>{const h=new AbortController,c=Array.from(document.querySelectorAll(i)),p=e=>{const t=o(e);return null!==t&&s!==t},u=n=>r({serverURL:t,paths:n.map((e=>o(e)||s)),signal:h.signal}).then((e=>a(e,n))).catch(e);if(l){const e=c.filter((e=>!p(e))),r=c.filter(p);n({serverURL:t,path:s}).then((t=>a(new Array(e.length).fill(t),e))),r.length&&u(r)}else u(c);return h.abort.bind(h)},exports.version="2.0.0-alpha.4";
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});const e=e=>{"AbortError"!==e.name&&console.error(e.message)},t=(e,t="")=>{if("object"==typeof e&&e.errno)throw new TypeError(`Fetch ${t} failed with ${e.errno}: ${e.errmsg}`);return e},r=({serverURL:e,paths:r,signal:n})=>fetch(`${e}/article?path=${encodeURIComponent(r.join(","))}`,{signal:n}).then((e=>e.json())).then((e=>t(e,"visit count"))).then((e=>Array.isArray(e)?e:[e])),n=({serverURL:e,path:r})=>fetch(`${e}/article`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({path:r})}).then((e=>e.json())).then((e=>t(e,"visit count"))),o=e=>e.dataset.path||e.getAttribute("id"),a=(e,t)=>{t.forEach(((t,r)=>{t.innerText=e[r].toString()}))};exports.pageviewCount=({serverURL:t,path:s=window.location.pathname,selector:i=".waline-pageview-count",update:l=!0})=>{const h=new AbortController,c=Array.from(document.querySelectorAll(i)),p=e=>{const t=o(e);return null!==t&&s!==t},u=n=>r({serverURL:t,paths:n.map((e=>o(e)||s)),signal:h.signal}).then((e=>a(e,n))).catch(e);if(l){const e=c.filter((e=>!p(e))),r=c.filter(p);n({serverURL:t,path:s}).then((t=>a(new Array(e.length).fill(t),e))),r.length&&u(r)}else u(c);return h.abort.bind(h)},exports.version="2.0.2";
 //# sourceMappingURL=pageview.cjs.js.map

package/dist/pageview.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"pageview.cjs.js","sources":["../src/version.ts","../src/utils/error.ts","../src/utils/fetch.ts","../src/utils/query.ts","../src/pageview.ts"],"sourcesContent":["declare const VERSION: string;\n\nexport const version = VERSION;\n","export const errorHandler = (err: Error): void => {\n  if (err.name !== 'AbortError') console.error(err.message);\n};\n","import type { WalineComment, WalineCommentData } from '../typings';\n\nexport interface FetchErrorData {\n  errno: number;\n  errmsg: string;\n}\n\nconst errorCheck = <T = unknown>(data: T | FetchErrorData, name = ''): T => {\n  if (typeof data === 'object' && (data as FetchErrorData).errno)\n    throw new TypeError(\n      `Fetch ${name} failed with ${(data as FetchErrorData).errno}: ${\n        (data as FetchErrorData).errmsg\n      }`\n    );\n\n  return data as T;\n};\n\nexport interface FetchCountOptions {\n  serverURL: string;\n  paths: string[];\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport const fetchCommentCount = ({\n  serverURL,\n  paths,\n  signal,\n  token,\n}: FetchCountOptions): Promise<number[]> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return (\n    fetch(\n      `${serverURL}/comment?type=count&url=${encodeURIComponent(\n        paths.join(',')\n      )}`,\n      { signal, headers }\n    )\n      .then((resp) => resp.json() as Promise<number | number[]>)\n      .then((data) => errorCheck(data, 'comment count'))\n      // TODO: Improve this API\n      .then((counts) => (Array.isArray(counts) ? counts : [counts]))\n  );\n};\nexport interface FetchRecentOptions {\n  serverURL: string;\n  count: number;\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport const fetchRecentComment = ({\n  serverURL,\n  count,\n  signal,\n  token,\n}: FetchRecentOptions): Promise<WalineComment[]> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(`${serverURL}/comment?type=recent&count=${count}`, {\n    signal,\n    headers,\n  })\n    .then((resp) => resp.json() as Promise<WalineComment[]>)\n    .then((data) => errorCheck(data, 'recent comment'));\n};\n\nexport interface FetchListOptions {\n  serverURL: string;\n  path: string;\n  page: number;\n  pageSize: number;\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport interface FetchListResult {\n  count: number;\n  data: WalineComment[];\n  totalPages: number;\n}\n\nexport const fetchCommentList = ({\n  serverURL,\n  path,\n  page,\n  pageSize,\n  signal,\n  token,\n}: FetchListOptions): Promise<FetchListResult> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(\n    `${serverURL}/comment?path=${encodeURIComponent(\n      path\n    )}&pageSize=${pageSize}&page=${page}`,\n    { signal, headers }\n  )\n    .then((resp) => resp.json() as Promise<FetchListResult>)\n    .then((data) => errorCheck(data, 'comment list'));\n};\n\nexport interface PostCommentOptions {\n  serverURL: string;\n  lang: string;\n  token?: string;\n  comment: WalineCommentData;\n}\n\nexport interface PostCommentResponse {\n  data?: WalineComment;\n  errmsg?: string;\n}\n\nexport const postComment = ({\n  serverURL,\n  lang,\n  token,\n  comment,\n}: PostCommentOptions): Promise<PostCommentResponse> => {\n  const headers: Record<string, string> = {\n    // eslint-disable-next-line @typescript-eslint/naming-convention\n    'Content-Type': 'application/json',\n  };\n\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(`${serverURL}/comment?lang=${lang}`, {\n    method: 'POST',\n    headers,\n    body: JSON.stringify(comment),\n  }).then((resp) => resp.json() as Promise<PostCommentResponse>);\n};\n\nexport interface FetchPageviewsOptions {\n  serverURL: string;\n  paths: string[];\n  signal: AbortSignal;\n}\n\nexport const fetchPageviews = ({\n  serverURL,\n  paths,\n  signal,\n}: FetchPageviewsOptions): Promise<number[]> =>\n  fetch(`${serverURL}/article?path=${encodeURIComponent(paths.join(','))}`, {\n    signal,\n  })\n    .then((resp) => resp.json() as Promise<number[] | number>)\n    .then((data) => errorCheck(data, 'visit count'))\n    // TODO: Improve this API\n    .then((counts) => (Array.isArray(counts) ? counts : [counts]));\n\nexport interface UpdatePageviewsOptions {\n  serverURL: string;\n  path: string;\n}\n\nexport const updatePageviews = ({\n  serverURL,\n  path,\n}: UpdatePageviewsOptions): Promise<number> =>\n  fetch(`${serverURL}/article`, {\n    method: 'POST',\n    headers: {\n      // eslint-disable-next-line @typescript-eslint/naming-convention\n      'Content-Type': 'application/json',\n    },\n    body: JSON.stringify({ path }),\n  })\n    .then((resp) => resp.json() as Promise<number>)\n    .then((data) => errorCheck(data, 'visit count'));\n","export const getQuery = (element: HTMLElement): string | null =>\n  element.dataset.path || element.getAttribute('id');\n","import {\n  errorHandler,\n  fetchPageviews,\n  getQuery,\n  updatePageviews,\n} from './utils';\n\nconst renderVisitorCount = (\n  counts: number[],\n  countElements: HTMLElement[]\n): void => {\n  countElements.forEach((element, index) => {\n    element.innerText = counts[index].toString();\n  });\n};\n\nexport interface VisitorCountOptions {\n  /**\n   * Waline server url\n   *\n   * Waline 服务端地址\n   */\n  serverURL: string;\n\n  /**\n   * Path to be fetched and updated\n   *\n   * 需要更新和获取的路径\n   *\n   * @default window.location.pathname\n   */\n  path?: string;\n\n  /**\n   * @default '.waline-pageview-count'\n   */\n  selector?: string;\n\n  /**\n   * Whether update pageviews when fetching path result\n   *\n   * 是否在查询时更新 path 的浏览量\n   *\n   * @default true\n   */\n  update?: boolean;\n}\n\nexport const pageviewCount = ({\n  serverURL,\n  path = window.location.pathname,\n  selector = '.waline-pageview-count',\n  update = true,\n}: VisitorCountOptions): ((reason?: unknown) => void) => {\n  const controller = new AbortController();\n\n  const elements = Array.from(\n    // visitor selectors\n    document.querySelectorAll<HTMLElement>(selector)\n  );\n\n  const filter = (element: HTMLElement): boolean => {\n    const query = getQuery(element);\n\n    return query !== null && path !== query;\n  };\n\n  const fetch = (elements: HTMLElement[]): Promise<void> =>\n    fetchPageviews({\n      serverURL,\n      paths: elements.map((element) => getQuery(element) || path),\n      signal: controller.signal,\n    })\n      .then((counts) => renderVisitorCount(counts, elements))\n      .catch(errorHandler);\n\n  // we should update pageviews\n  if (update) {\n    const normalElements = elements.filter((element) => !filter(element));\n    const elementsNeedstoBeFetched = elements.filter(filter);\n\n    void updatePageviews({ serverURL, path }).then((count) =>\n      renderVisitorCount(\n        new Array<number>(normalElements.length).fill(count),\n        normalElements\n      )\n    );\n\n    // if we should fetch count of other pages\n    if (elementsNeedstoBeFetched.length) {\n      void fetch(elementsNeedstoBeFetched);\n    }\n  }\n  // we should not update pageviews\n  else {\n    void fetch(elements);\n  }\n\n  return controller.abort.bind(controller);\n};\n"],"names":["errorHandler","err","name","console","error","message","errorCheck","data","errno","TypeError","errmsg","fetchPageviews","serverURL","paths","signal","fetch","encodeURIComponent","join","then","resp","json","counts","Array","isArray","updatePageviews","path","method","headers","body","JSON","stringify","getQuery","element","dataset","getAttribute","renderVisitorCount","countElements","forEach","index","innerText","toString","window","location","pathname","selector","update","controller","AbortController","elements","from","document","querySelectorAll","filter","query","map","catch","normalElements","elementsNeedstoBeFetched","count","length","fill","abort","bind"],"mappings":"oEAEO,MCFMA,EAAgBC,IACV,eAAbA,EAAIC,MAAuBC,QAAQC,MAAMH,EAAII,UCM7CC,EAAa,CAAcC,EAA0BL,EAAO,MAChE,GAAoB,iBAATK,GAAsBA,EAAwBC,MACvD,MAAM,IAAIC,UACR,SAASP,iBAAqBK,EAAwBC,UACnDD,EAAwBG,UAI/B,OAAOH,GAkIII,EAAiB,EAC5BC,UAAAA,EACAC,MAAAA,EACAC,OAAAA,KAEAC,MAAM,GAAGH,kBAA0BI,mBAAmBH,EAAMI,KAAK,QAAS,CACxEH,OAAAA,IAECI,MAAMC,GAASA,EAAKC,SACpBF,MAAMX,GAASD,EAAWC,EAAM,iBAEhCW,MAAMG,GAAYC,MAAMC,QAAQF,GAAUA,EAAS,CAACA,KAO5CG,EAAkB,EAC7BZ,UAAAA,EACAa,KAAAA,KAEAV,MAAM,GAAGH,YAAqB,CAC5Bc,OAAQ,OACRC,QAAS,CAEP,eAAgB,oBAElBC,KAAMC,KAAKC,UAAU,CAAEL,KAAAA,MAEtBP,MAAMC,GAASA,EAAKC,SACpBF,MAAMX,GAASD,EAAWC,EAAM,iBChLxBwB,EAAYC,GACvBA,EAAQC,QAAQR,MAAQO,EAAQE,aAAa,MCMzCC,EAAqB,CACzBd,EACAe,KAEAA,EAAcC,SAAQ,CAACL,EAASM,KAC9BN,EAAQO,UAAYlB,EAAOiB,GAAOE,qCAoCT,EAC3B5B,UAAAA,EACAa,KAAAA,EAAOgB,OAAOC,SAASC,SACvBC,SAAAA,EAAW,yBACXC,OAAAA,GAAS,MAET,MAAMC,EAAa,IAAIC,gBAEjBC,EAAW1B,MAAM2B,KAErBC,SAASC,iBAA8BP,IAGnCQ,EAAUpB,IACd,MAAMqB,EAAQtB,EAASC,GAEvB,OAAiB,OAAVqB,GAAkB5B,IAAS4B,GAG9BtC,EAASiC,GACbrC,EAAe,CACbC,UAAAA,EACAC,MAAOmC,EAASM,KAAKtB,GAAYD,EAASC,IAAYP,IACtDX,OAAQgC,EAAWhC,SAElBI,MAAMG,GAAWc,EAAmBd,EAAQ2B,KAC5CO,MAAMvD,GAGX,GAAI6C,EAAQ,CACV,MAAMW,EAAiBR,EAASI,QAAQpB,IAAaoB,EAAOpB,KACtDyB,EAA2BT,EAASI,OAAOA,GAE5C5B,EAAgB,CAAEZ,UAAAA,EAAWa,KAAAA,IAAQP,MAAMwC,GAC9CvB,EACE,IAAIb,MAAckC,EAAeG,QAAQC,KAAKF,GAC9CF,KAKAC,EAAyBE,QACtB5C,EAAM0C,QAKR1C,EAAMiC,GAGb,OAAOF,EAAWe,MAAMC,KAAKhB,oBJhGR"}
+{"version":3,"file":"pageview.cjs.js","sources":["../src/version.ts","../src/utils/error.ts","../src/utils/fetch.ts","../src/utils/query.ts","../src/pageview.ts"],"sourcesContent":["declare const VERSION: string;\n\nexport const version = VERSION;\n","export const errorHandler = (err: Error): void => {\n  if (err.name !== 'AbortError') console.error(err.message);\n};\n","import type { WalineComment, WalineCommentData } from '../typings';\n\nexport interface FetchErrorData {\n  errno: number;\n  errmsg: string;\n}\n\nconst errorCheck = <T = unknown>(data: T | FetchErrorData, name = ''): T => {\n  if (typeof data === 'object' && (data as FetchErrorData).errno)\n    throw new TypeError(\n      `Fetch ${name} failed with ${(data as FetchErrorData).errno}: ${\n        (data as FetchErrorData).errmsg\n      }`\n    );\n\n  return data as T;\n};\n\nexport interface FetchCountOptions {\n  serverURL: string;\n  paths: string[];\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport const fetchCommentCount = ({\n  serverURL,\n  paths,\n  signal,\n  token,\n}: FetchCountOptions): Promise<number[]> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return (\n    fetch(\n      `${serverURL}/comment?type=count&url=${encodeURIComponent(\n        paths.join(',')\n      )}`,\n      { signal, headers }\n    )\n      .then((resp) => resp.json() as Promise<number | number[]>)\n      .then((data) => errorCheck(data, 'comment count'))\n      // TODO: Improve this API\n      .then((counts) => (Array.isArray(counts) ? counts : [counts]))\n  );\n};\nexport interface FetchRecentOptions {\n  serverURL: string;\n  count: number;\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport const fetchRecentComment = ({\n  serverURL,\n  count,\n  signal,\n  token,\n}: FetchRecentOptions): Promise<WalineComment[]> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(`${serverURL}/comment?type=recent&count=${count}`, {\n    signal,\n    headers,\n  })\n    .then((resp) => resp.json() as Promise<WalineComment[]>)\n    .then((data) => errorCheck(data, 'recent comment'));\n};\n\nexport interface FetchListOptions {\n  serverURL: string;\n  path: string;\n  page: number;\n  pageSize: number;\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport interface FetchListResult {\n  count: number;\n  data: WalineComment[];\n  totalPages: number;\n}\n\nexport const fetchCommentList = ({\n  serverURL,\n  path,\n  page,\n  pageSize,\n  signal,\n  token,\n}: FetchListOptions): Promise<FetchListResult> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(\n    `${serverURL}/comment?path=${encodeURIComponent(\n      path\n    )}&pageSize=${pageSize}&page=${page}`,\n    { signal, headers }\n  )\n    .then((resp) => resp.json() as Promise<FetchListResult>)\n    .then((data) => errorCheck(data, 'comment list'));\n};\n\nexport interface PostCommentOptions {\n  serverURL: string;\n  lang: string;\n  token?: string;\n  comment: WalineCommentData;\n}\n\nexport interface PostCommentResponse {\n  data?: WalineComment;\n  errmsg?: string;\n}\n\nexport const postComment = ({\n  serverURL,\n  lang,\n  token,\n  comment,\n}: PostCommentOptions): Promise<PostCommentResponse> => {\n  const headers: Record<string, string> = {\n    // eslint-disable-next-line @typescript-eslint/naming-convention\n    'Content-Type': 'application/json',\n  };\n\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(`${serverURL}/comment?lang=${lang}`, {\n    method: 'POST',\n    headers,\n    body: JSON.stringify(comment),\n  }).then((resp) => resp.json() as Promise<PostCommentResponse>);\n};\n\nexport interface FetchPageviewsOptions {\n  serverURL: string;\n  paths: string[];\n  signal: AbortSignal;\n}\n\nexport const fetchPageviews = ({\n  serverURL,\n  paths,\n  signal,\n}: FetchPageviewsOptions): Promise<number[]> =>\n  fetch(`${serverURL}/article?path=${encodeURIComponent(paths.join(','))}`, {\n    signal,\n  })\n    .then((resp) => resp.json() as Promise<number[] | number>)\n    .then((data) => errorCheck(data, 'visit count'))\n    // TODO: Improve this API\n    .then((counts) => (Array.isArray(counts) ? counts : [counts]));\n\nexport interface UpdatePageviewsOptions {\n  serverURL: string;\n  path: string;\n}\n\nexport const updatePageviews = ({\n  serverURL,\n  path,\n}: UpdatePageviewsOptions): Promise<number> =>\n  fetch(`${serverURL}/article`, {\n    method: 'POST',\n    headers: {\n      // eslint-disable-next-line @typescript-eslint/naming-convention\n      'Content-Type': 'application/json',\n    },\n    body: JSON.stringify({ path }),\n  })\n    .then((resp) => resp.json() as Promise<number>)\n    .then((data) => errorCheck(data, 'visit count'));\n","export const getQuery = (element: HTMLElement): string | null =>\n  element.dataset.path || element.getAttribute('id');\n","import {\n  errorHandler,\n  fetchPageviews,\n  getQuery,\n  updatePageviews,\n} from './utils';\n\nimport type { WalineAbort } from './typings';\n\nexport interface WalinePageviewCountOptions {\n  /**\n   * Waline 服务端地址\n   *\n   * Waline server url\n   */\n  serverURL: string;\n\n  /**\n   * 浏览量 CSS 选择器\n   *\n   * Pageview CSS selector\n   *\n   * @default '.waline-pageview-count'\n   */\n  selector?: string;\n\n  /**\n   * 需要更新和获取的路径\n   *\n   * Path to be fetched and updated\n   *\n   * @default window.location.pathname\n   */\n  path?: string;\n\n  /**\n   * 是否在查询时更新 path 的浏览量\n   *\n   * Whether update pageviews when fetching path result\n   *\n   * @default true\n   */\n  update?: boolean;\n}\n\nconst renderVisitorCount = (\n  counts: number[],\n  countElements: HTMLElement[]\n): void => {\n  countElements.forEach((element, index) => {\n    element.innerText = counts[index].toString();\n  });\n};\n\nexport const pageviewCount = ({\n  serverURL,\n  path = window.location.pathname,\n  selector = '.waline-pageview-count',\n  update = true,\n}: WalinePageviewCountOptions): WalineAbort => {\n  const controller = new AbortController();\n\n  const elements = Array.from(\n    // visitor selectors\n    document.querySelectorAll<HTMLElement>(selector)\n  );\n\n  const filter = (element: HTMLElement): boolean => {\n    const query = getQuery(element);\n\n    return query !== null && path !== query;\n  };\n\n  const fetch = (elements: HTMLElement[]): Promise<void> =>\n    fetchPageviews({\n      serverURL,\n      paths: elements.map((element) => getQuery(element) || path),\n      signal: controller.signal,\n    })\n      .then((counts) => renderVisitorCount(counts, elements))\n      .catch(errorHandler);\n\n  // we should update pageviews\n  if (update) {\n    const normalElements = elements.filter((element) => !filter(element));\n    const elementsNeedstoBeFetched = elements.filter(filter);\n\n    void updatePageviews({ serverURL, path }).then((count) =>\n      renderVisitorCount(\n        new Array<number>(normalElements.length).fill(count),\n        normalElements\n      )\n    );\n\n    // if we should fetch count of other pages\n    if (elementsNeedstoBeFetched.length) {\n      void fetch(elementsNeedstoBeFetched);\n    }\n  }\n  // we should not update pageviews\n  else {\n    void fetch(elements);\n  }\n\n  return controller.abort.bind(controller);\n};\n"],"names":["errorHandler","err","name","console","error","message","errorCheck","data","errno","TypeError","errmsg","fetchPageviews","serverURL","paths","signal","fetch","encodeURIComponent","join","then","resp","json","counts","Array","isArray","updatePageviews","path","method","headers","body","JSON","stringify","getQuery","element","dataset","getAttribute","renderVisitorCount","countElements","forEach","index","innerText","toString","window","location","pathname","selector","update","controller","AbortController","elements","from","document","querySelectorAll","filter","query","map","catch","normalElements","elementsNeedstoBeFetched","count","length","fill","abort","bind"],"mappings":"oEAEO,MCFMA,EAAgBC,IACV,eAAbA,EAAIC,MAAuBC,QAAQC,MAAMH,EAAII,UCM7CC,EAAa,CAAcC,EAA0BL,EAAO,MAChE,GAAoB,iBAATK,GAAsBA,EAAwBC,MACvD,MAAM,IAAIC,UACR,SAASP,iBAAqBK,EAAwBC,UACnDD,EAAwBG,UAI/B,OAAOH,GAkIII,EAAiB,EAC5BC,UAAAA,EACAC,MAAAA,EACAC,OAAAA,KAEAC,MAAM,GAAGH,kBAA0BI,mBAAmBH,EAAMI,KAAK,QAAS,CACxEH,OAAAA,IAECI,MAAMC,GAASA,EAAKC,SACpBF,MAAMX,GAASD,EAAWC,EAAM,iBAEhCW,MAAMG,GAAYC,MAAMC,QAAQF,GAAUA,EAAS,CAACA,KAO5CG,EAAkB,EAC7BZ,UAAAA,EACAa,KAAAA,KAEAV,MAAM,GAAGH,YAAqB,CAC5Bc,OAAQ,OACRC,QAAS,CAEP,eAAgB,oBAElBC,KAAMC,KAAKC,UAAU,CAAEL,KAAAA,MAEtBP,MAAMC,GAASA,EAAKC,SACpBF,MAAMX,GAASD,EAAWC,EAAM,iBChLxBwB,EAAYC,GACvBA,EAAQC,QAAQR,MAAQO,EAAQE,aAAa,MC4CzCC,EAAqB,CACzBd,EACAe,KAEAA,EAAcC,SAAQ,CAACL,EAASM,KAC9BN,EAAQO,UAAYlB,EAAOiB,GAAOE,qCAIT,EAC3B5B,UAAAA,EACAa,KAAAA,EAAOgB,OAAOC,SAASC,SACvBC,SAAAA,EAAW,yBACXC,OAAAA,GAAS,MAET,MAAMC,EAAa,IAAIC,gBAEjBC,EAAW1B,MAAM2B,KAErBC,SAASC,iBAA8BP,IAGnCQ,EAAUpB,IACd,MAAMqB,EAAQtB,EAASC,GAEvB,OAAiB,OAAVqB,GAAkB5B,IAAS4B,GAG9BtC,EAASiC,GACbrC,EAAe,CACbC,UAAAA,EACAC,MAAOmC,EAASM,KAAKtB,GAAYD,EAASC,IAAYP,IACtDX,OAAQgC,EAAWhC,SAElBI,MAAMG,GAAWc,EAAmBd,EAAQ2B,KAC5CO,MAAMvD,GAGX,GAAI6C,EAAQ,CACV,MAAMW,EAAiBR,EAASI,QAAQpB,IAAaoB,EAAOpB,KACtDyB,EAA2BT,EAASI,OAAOA,GAE5C5B,EAAgB,CAAEZ,UAAAA,EAAWa,KAAAA,IAAQP,MAAMwC,GAC9CvB,EACE,IAAIb,MAAckC,EAAeG,QAAQC,KAAKF,GAC9CF,KAKAC,EAAyBE,QACtB5C,EAAM0C,QAKR1C,EAAMiC,GAGb,OAAOF,EAAWe,MAAMC,KAAKhB,oBJtGR"}

package/dist/pageview.d.ts

@@ -1,33 +1,39 @@
 declare const version: string;
 
-interface VisitorCountOptions {
+declare type WalineAbort = (reason?: any) => void;
+
+interface WalinePageviewCountOptions {
     /**
-     * Waline server url
-     *
      * Waline 服务端地址
+     *
+     * Waline server url
      */
     serverURL: string;
     /**
-     * Path to be fetched and updated
+     * 浏览量 CSS 选择器
      *
-     * 需要更新和获取的路径
+     * Pageview CSS selector
      *
-     * @default window.location.pathname
-     */
-    path?: string;
-    /**
      * @default '.waline-pageview-count'
      */
     selector?: string;
     /**
-     * Whether update pageviews when fetching path result
+     * 需要更新和获取的路径
      *
+     * Path to be fetched and updated
+     *
+     * @default window.location.pathname
+     */
+    path?: string;
+    /**
      * 是否在查询时更新 path 的浏览量
      *
+     * Whether update pageviews when fetching path result
+     *
      * @default true
      */
     update?: boolean;
 }
-declare const pageviewCount: ({ serverURL, path, selector, update, }: VisitorCountOptions) => (reason?: unknown) => void;
+declare const pageviewCount: ({ serverURL, path, selector, update, }: WalinePageviewCountOptions) => WalineAbort;
 
-export { VisitorCountOptions, pageviewCount, version };
+export { WalinePageviewCountOptions, pageviewCount, version };

package/dist/pageview.esm.js

@@ -1,2 +1,2 @@
-const e="2.0.0-alpha.4",t=e=>{"AbortError"!==e.name&&console.error(e.message)},r=(e,t="")=>{if("object"==typeof e&&e.errno)throw new TypeError(`Fetch ${t} failed with ${e.errno}: ${e.errmsg}`);return e},n=({serverURL:e,paths:t,signal:n})=>fetch(`${e}/article?path=${encodeURIComponent(t.join(","))}`,{signal:n}).then((e=>e.json())).then((e=>r(e,"visit count"))).then((e=>Array.isArray(e)?e:[e])),o=({serverURL:e,path:t})=>fetch(`${e}/article`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({path:t})}).then((e=>e.json())).then((e=>r(e,"visit count"))),a=e=>e.dataset.path||e.getAttribute("id"),i=(e,t)=>{t.forEach(((t,r)=>{t.innerText=e[r].toString()}))},s=({serverURL:e,path:r=window.location.pathname,selector:s=".waline-pageview-count",update:h=!0})=>{const l=new AbortController,c=Array.from(document.querySelectorAll(s)),p=e=>{const t=a(e);return null!==t&&r!==t},f=o=>n({serverURL:e,paths:o.map((e=>a(e)||r)),signal:l.signal}).then((e=>i(e,o))).catch(t);if(h){const t=c.filter((e=>!p(e))),n=c.filter(p);o({serverURL:e,path:r}).then((e=>i(new Array(t.length).fill(e),t))),n.length&&f(n)}else f(c);return l.abort.bind(l)};export{s as pageviewCount,e as version};
+const e="2.0.2",t=e=>{"AbortError"!==e.name&&console.error(e.message)},r=(e,t="")=>{if("object"==typeof e&&e.errno)throw new TypeError(`Fetch ${t} failed with ${e.errno}: ${e.errmsg}`);return e},n=({serverURL:e,paths:t,signal:n})=>fetch(`${e}/article?path=${encodeURIComponent(t.join(","))}`,{signal:n}).then((e=>e.json())).then((e=>r(e,"visit count"))).then((e=>Array.isArray(e)?e:[e])),o=({serverURL:e,path:t})=>fetch(`${e}/article`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({path:t})}).then((e=>e.json())).then((e=>r(e,"visit count"))),a=e=>e.dataset.path||e.getAttribute("id"),i=(e,t)=>{t.forEach(((t,r)=>{t.innerText=e[r].toString()}))},s=({serverURL:e,path:r=window.location.pathname,selector:s=".waline-pageview-count",update:h=!0})=>{const l=new AbortController,c=Array.from(document.querySelectorAll(s)),p=e=>{const t=a(e);return null!==t&&r!==t},f=o=>n({serverURL:e,paths:o.map((e=>a(e)||r)),signal:l.signal}).then((e=>i(e,o))).catch(t);if(h){const t=c.filter((e=>!p(e))),n=c.filter(p);o({serverURL:e,path:r}).then((e=>i(new Array(t.length).fill(e),t))),n.length&&f(n)}else f(c);return l.abort.bind(l)};export{s as pageviewCount,e as version};
 //# sourceMappingURL=pageview.esm.js.map

package/dist/pageview.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"pageview.esm.js","sources":["../src/version.ts","../src/utils/error.ts","../src/utils/fetch.ts","../src/utils/query.ts","../src/pageview.ts"],"sourcesContent":["declare const VERSION: string;\n\nexport const version = VERSION;\n","export const errorHandler = (err: Error): void => {\n  if (err.name !== 'AbortError') console.error(err.message);\n};\n","import type { WalineComment, WalineCommentData } from '../typings';\n\nexport interface FetchErrorData {\n  errno: number;\n  errmsg: string;\n}\n\nconst errorCheck = <T = unknown>(data: T | FetchErrorData, name = ''): T => {\n  if (typeof data === 'object' && (data as FetchErrorData).errno)\n    throw new TypeError(\n      `Fetch ${name} failed with ${(data as FetchErrorData).errno}: ${\n        (data as FetchErrorData).errmsg\n      }`\n    );\n\n  return data as T;\n};\n\nexport interface FetchCountOptions {\n  serverURL: string;\n  paths: string[];\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport const fetchCommentCount = ({\n  serverURL,\n  paths,\n  signal,\n  token,\n}: FetchCountOptions): Promise<number[]> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return (\n    fetch(\n      `${serverURL}/comment?type=count&url=${encodeURIComponent(\n        paths.join(',')\n      )}`,\n      { signal, headers }\n    )\n      .then((resp) => resp.json() as Promise<number | number[]>)\n      .then((data) => errorCheck(data, 'comment count'))\n      // TODO: Improve this API\n      .then((counts) => (Array.isArray(counts) ? counts : [counts]))\n  );\n};\nexport interface FetchRecentOptions {\n  serverURL: string;\n  count: number;\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport const fetchRecentComment = ({\n  serverURL,\n  count,\n  signal,\n  token,\n}: FetchRecentOptions): Promise<WalineComment[]> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(`${serverURL}/comment?type=recent&count=${count}`, {\n    signal,\n    headers,\n  })\n    .then((resp) => resp.json() as Promise<WalineComment[]>)\n    .then((data) => errorCheck(data, 'recent comment'));\n};\n\nexport interface FetchListOptions {\n  serverURL: string;\n  path: string;\n  page: number;\n  pageSize: number;\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport interface FetchListResult {\n  count: number;\n  data: WalineComment[];\n  totalPages: number;\n}\n\nexport const fetchCommentList = ({\n  serverURL,\n  path,\n  page,\n  pageSize,\n  signal,\n  token,\n}: FetchListOptions): Promise<FetchListResult> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(\n    `${serverURL}/comment?path=${encodeURIComponent(\n      path\n    )}&pageSize=${pageSize}&page=${page}`,\n    { signal, headers }\n  )\n    .then((resp) => resp.json() as Promise<FetchListResult>)\n    .then((data) => errorCheck(data, 'comment list'));\n};\n\nexport interface PostCommentOptions {\n  serverURL: string;\n  lang: string;\n  token?: string;\n  comment: WalineCommentData;\n}\n\nexport interface PostCommentResponse {\n  data?: WalineComment;\n  errmsg?: string;\n}\n\nexport const postComment = ({\n  serverURL,\n  lang,\n  token,\n  comment,\n}: PostCommentOptions): Promise<PostCommentResponse> => {\n  const headers: Record<string, string> = {\n    // eslint-disable-next-line @typescript-eslint/naming-convention\n    'Content-Type': 'application/json',\n  };\n\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(`${serverURL}/comment?lang=${lang}`, {\n    method: 'POST',\n    headers,\n    body: JSON.stringify(comment),\n  }).then((resp) => resp.json() as Promise<PostCommentResponse>);\n};\n\nexport interface FetchPageviewsOptions {\n  serverURL: string;\n  paths: string[];\n  signal: AbortSignal;\n}\n\nexport const fetchPageviews = ({\n  serverURL,\n  paths,\n  signal,\n}: FetchPageviewsOptions): Promise<number[]> =>\n  fetch(`${serverURL}/article?path=${encodeURIComponent(paths.join(','))}`, {\n    signal,\n  })\n    .then((resp) => resp.json() as Promise<number[] | number>)\n    .then((data) => errorCheck(data, 'visit count'))\n    // TODO: Improve this API\n    .then((counts) => (Array.isArray(counts) ? counts : [counts]));\n\nexport interface UpdatePageviewsOptions {\n  serverURL: string;\n  path: string;\n}\n\nexport const updatePageviews = ({\n  serverURL,\n  path,\n}: UpdatePageviewsOptions): Promise<number> =>\n  fetch(`${serverURL}/article`, {\n    method: 'POST',\n    headers: {\n      // eslint-disable-next-line @typescript-eslint/naming-convention\n      'Content-Type': 'application/json',\n    },\n    body: JSON.stringify({ path }),\n  })\n    .then((resp) => resp.json() as Promise<number>)\n    .then((data) => errorCheck(data, 'visit count'));\n","export const getQuery = (element: HTMLElement): string | null =>\n  element.dataset.path || element.getAttribute('id');\n","import {\n  errorHandler,\n  fetchPageviews,\n  getQuery,\n  updatePageviews,\n} from './utils';\n\nconst renderVisitorCount = (\n  counts: number[],\n  countElements: HTMLElement[]\n): void => {\n  countElements.forEach((element, index) => {\n    element.innerText = counts[index].toString();\n  });\n};\n\nexport interface VisitorCountOptions {\n  /**\n   * Waline server url\n   *\n   * Waline 服务端地址\n   */\n  serverURL: string;\n\n  /**\n   * Path to be fetched and updated\n   *\n   * 需要更新和获取的路径\n   *\n   * @default window.location.pathname\n   */\n  path?: string;\n\n  /**\n   * @default '.waline-pageview-count'\n   */\n  selector?: string;\n\n  /**\n   * Whether update pageviews when fetching path result\n   *\n   * 是否在查询时更新 path 的浏览量\n   *\n   * @default true\n   */\n  update?: boolean;\n}\n\nexport const pageviewCount = ({\n  serverURL,\n  path = window.location.pathname,\n  selector = '.waline-pageview-count',\n  update = true,\n}: VisitorCountOptions): ((reason?: unknown) => void) => {\n  const controller = new AbortController();\n\n  const elements = Array.from(\n    // visitor selectors\n    document.querySelectorAll<HTMLElement>(selector)\n  );\n\n  const filter = (element: HTMLElement): boolean => {\n    const query = getQuery(element);\n\n    return query !== null && path !== query;\n  };\n\n  const fetch = (elements: HTMLElement[]): Promise<void> =>\n    fetchPageviews({\n      serverURL,\n      paths: elements.map((element) => getQuery(element) || path),\n      signal: controller.signal,\n    })\n      .then((counts) => renderVisitorCount(counts, elements))\n      .catch(errorHandler);\n\n  // we should update pageviews\n  if (update) {\n    const normalElements = elements.filter((element) => !filter(element));\n    const elementsNeedstoBeFetched = elements.filter(filter);\n\n    void updatePageviews({ serverURL, path }).then((count) =>\n      renderVisitorCount(\n        new Array<number>(normalElements.length).fill(count),\n        normalElements\n      )\n    );\n\n    // if we should fetch count of other pages\n    if (elementsNeedstoBeFetched.length) {\n      void fetch(elementsNeedstoBeFetched);\n    }\n  }\n  // we should not update pageviews\n  else {\n    void fetch(elements);\n  }\n\n  return controller.abort.bind(controller);\n};\n"],"names":["version","errorHandler","err","name","console","error","message","errorCheck","data","errno","TypeError","errmsg","fetchPageviews","serverURL","paths","signal","fetch","encodeURIComponent","join","then","resp","json","counts","Array","isArray","updatePageviews","path","method","headers","body","JSON","stringify","getQuery","element","dataset","getAttribute","renderVisitorCount","countElements","forEach","index","innerText","toString","pageviewCount","window","location","pathname","selector","update","controller","AbortController","elements","from","document","querySelectorAll","filter","query","map","catch","normalElements","elementsNeedstoBeFetched","count","length","fill","abort","bind"],"mappings":"AAEO,MAAMA,EAAU,gBCFVC,EAAgBC,IACV,eAAbA,EAAIC,MAAuBC,QAAQC,MAAMH,EAAII,UCM7CC,EAAa,CAAcC,EAA0BL,EAAO,MAChE,GAAoB,iBAATK,GAAsBA,EAAwBC,MACvD,MAAM,IAAIC,UACR,SAASP,iBAAqBK,EAAwBC,UACnDD,EAAwBG,UAI/B,OAAOH,GAkIII,EAAiB,EAC5BC,UAAAA,EACAC,MAAAA,EACAC,OAAAA,KAEAC,MAAM,GAAGH,kBAA0BI,mBAAmBH,EAAMI,KAAK,QAAS,CACxEH,OAAAA,IAECI,MAAMC,GAASA,EAAKC,SACpBF,MAAMX,GAASD,EAAWC,EAAM,iBAEhCW,MAAMG,GAAYC,MAAMC,QAAQF,GAAUA,EAAS,CAACA,KAO5CG,EAAkB,EAC7BZ,UAAAA,EACAa,KAAAA,KAEAV,MAAM,GAAGH,YAAqB,CAC5Bc,OAAQ,OACRC,QAAS,CAEP,eAAgB,oBAElBC,KAAMC,KAAKC,UAAU,CAAEL,KAAAA,MAEtBP,MAAMC,GAASA,EAAKC,SACpBF,MAAMX,GAASD,EAAWC,EAAM,iBChLxBwB,EAAYC,GACvBA,EAAQC,QAAQR,MAAQO,EAAQE,aAAa,MCMzCC,EAAqB,CACzBd,EACAe,KAEAA,EAAcC,SAAQ,CAACL,EAASM,KAC9BN,EAAQO,UAAYlB,EAAOiB,GAAOE,eAoCzBC,EAAgB,EAC3B7B,UAAAA,EACAa,KAAAA,EAAOiB,OAAOC,SAASC,SACvBC,SAAAA,EAAW,yBACXC,OAAAA,GAAS,MAET,MAAMC,EAAa,IAAIC,gBAEjBC,EAAW3B,MAAM4B,KAErBC,SAASC,iBAA8BP,IAGnCQ,EAAUrB,IACd,MAAMsB,EAAQvB,EAASC,GAEvB,OAAiB,OAAVsB,GAAkB7B,IAAS6B,GAG9BvC,EAASkC,GACbtC,EAAe,CACbC,UAAAA,EACAC,MAAOoC,EAASM,KAAKvB,GAAYD,EAASC,IAAYP,IACtDX,OAAQiC,EAAWjC,SAElBI,MAAMG,GAAWc,EAAmBd,EAAQ4B,KAC5CO,MAAMxD,GAGX,GAAI8C,EAAQ,CACV,MAAMW,EAAiBR,EAASI,QAAQrB,IAAaqB,EAAOrB,KACtD0B,EAA2BT,EAASI,OAAOA,GAE5C7B,EAAgB,CAAEZ,UAAAA,EAAWa,KAAAA,IAAQP,MAAMyC,GAC9CxB,EACE,IAAIb,MAAcmC,EAAeG,QAAQC,KAAKF,GAC9CF,KAKAC,EAAyBE,QACtB7C,EAAM2C,QAKR3C,EAAMkC,GAGb,OAAOF,EAAWe,MAAMC,KAAKhB"}
+{"version":3,"file":"pageview.esm.js","sources":["../src/version.ts","../src/utils/error.ts","../src/utils/fetch.ts","../src/utils/query.ts","../src/pageview.ts"],"sourcesContent":["declare const VERSION: string;\n\nexport const version = VERSION;\n","export const errorHandler = (err: Error): void => {\n  if (err.name !== 'AbortError') console.error(err.message);\n};\n","import type { WalineComment, WalineCommentData } from '../typings';\n\nexport interface FetchErrorData {\n  errno: number;\n  errmsg: string;\n}\n\nconst errorCheck = <T = unknown>(data: T | FetchErrorData, name = ''): T => {\n  if (typeof data === 'object' && (data as FetchErrorData).errno)\n    throw new TypeError(\n      `Fetch ${name} failed with ${(data as FetchErrorData).errno}: ${\n        (data as FetchErrorData).errmsg\n      }`\n    );\n\n  return data as T;\n};\n\nexport interface FetchCountOptions {\n  serverURL: string;\n  paths: string[];\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport const fetchCommentCount = ({\n  serverURL,\n  paths,\n  signal,\n  token,\n}: FetchCountOptions): Promise<number[]> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return (\n    fetch(\n      `${serverURL}/comment?type=count&url=${encodeURIComponent(\n        paths.join(',')\n      )}`,\n      { signal, headers }\n    )\n      .then((resp) => resp.json() as Promise<number | number[]>)\n      .then((data) => errorCheck(data, 'comment count'))\n      // TODO: Improve this API\n      .then((counts) => (Array.isArray(counts) ? counts : [counts]))\n  );\n};\nexport interface FetchRecentOptions {\n  serverURL: string;\n  count: number;\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport const fetchRecentComment = ({\n  serverURL,\n  count,\n  signal,\n  token,\n}: FetchRecentOptions): Promise<WalineComment[]> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(`${serverURL}/comment?type=recent&count=${count}`, {\n    signal,\n    headers,\n  })\n    .then((resp) => resp.json() as Promise<WalineComment[]>)\n    .then((data) => errorCheck(data, 'recent comment'));\n};\n\nexport interface FetchListOptions {\n  serverURL: string;\n  path: string;\n  page: number;\n  pageSize: number;\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport interface FetchListResult {\n  count: number;\n  data: WalineComment[];\n  totalPages: number;\n}\n\nexport const fetchCommentList = ({\n  serverURL,\n  path,\n  page,\n  pageSize,\n  signal,\n  token,\n}: FetchListOptions): Promise<FetchListResult> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(\n    `${serverURL}/comment?path=${encodeURIComponent(\n      path\n    )}&pageSize=${pageSize}&page=${page}`,\n    { signal, headers }\n  )\n    .then((resp) => resp.json() as Promise<FetchListResult>)\n    .then((data) => errorCheck(data, 'comment list'));\n};\n\nexport interface PostCommentOptions {\n  serverURL: string;\n  lang: string;\n  token?: string;\n  comment: WalineCommentData;\n}\n\nexport interface PostCommentResponse {\n  data?: WalineComment;\n  errmsg?: string;\n}\n\nexport const postComment = ({\n  serverURL,\n  lang,\n  token,\n  comment,\n}: PostCommentOptions): Promise<PostCommentResponse> => {\n  const headers: Record<string, string> = {\n    // eslint-disable-next-line @typescript-eslint/naming-convention\n    'Content-Type': 'application/json',\n  };\n\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(`${serverURL}/comment?lang=${lang}`, {\n    method: 'POST',\n    headers,\n    body: JSON.stringify(comment),\n  }).then((resp) => resp.json() as Promise<PostCommentResponse>);\n};\n\nexport interface FetchPageviewsOptions {\n  serverURL: string;\n  paths: string[];\n  signal: AbortSignal;\n}\n\nexport const fetchPageviews = ({\n  serverURL,\n  paths,\n  signal,\n}: FetchPageviewsOptions): Promise<number[]> =>\n  fetch(`${serverURL}/article?path=${encodeURIComponent(paths.join(','))}`, {\n    signal,\n  })\n    .then((resp) => resp.json() as Promise<number[] | number>)\n    .then((data) => errorCheck(data, 'visit count'))\n    // TODO: Improve this API\n    .then((counts) => (Array.isArray(counts) ? counts : [counts]));\n\nexport interface UpdatePageviewsOptions {\n  serverURL: string;\n  path: string;\n}\n\nexport const updatePageviews = ({\n  serverURL,\n  path,\n}: UpdatePageviewsOptions): Promise<number> =>\n  fetch(`${serverURL}/article`, {\n    method: 'POST',\n    headers: {\n      // eslint-disable-next-line @typescript-eslint/naming-convention\n      'Content-Type': 'application/json',\n    },\n    body: JSON.stringify({ path }),\n  })\n    .then((resp) => resp.json() as Promise<number>)\n    .then((data) => errorCheck(data, 'visit count'));\n","export const getQuery = (element: HTMLElement): string | null =>\n  element.dataset.path || element.getAttribute('id');\n","import {\n  errorHandler,\n  fetchPageviews,\n  getQuery,\n  updatePageviews,\n} from './utils';\n\nimport type { WalineAbort } from './typings';\n\nexport interface WalinePageviewCountOptions {\n  /**\n   * Waline 服务端地址\n   *\n   * Waline server url\n   */\n  serverURL: string;\n\n  /**\n   * 浏览量 CSS 选择器\n   *\n   * Pageview CSS selector\n   *\n   * @default '.waline-pageview-count'\n   */\n  selector?: string;\n\n  /**\n   * 需要更新和获取的路径\n   *\n   * Path to be fetched and updated\n   *\n   * @default window.location.pathname\n   */\n  path?: string;\n\n  /**\n   * 是否在查询时更新 path 的浏览量\n   *\n   * Whether update pageviews when fetching path result\n   *\n   * @default true\n   */\n  update?: boolean;\n}\n\nconst renderVisitorCount = (\n  counts: number[],\n  countElements: HTMLElement[]\n): void => {\n  countElements.forEach((element, index) => {\n    element.innerText = counts[index].toString();\n  });\n};\n\nexport const pageviewCount = ({\n  serverURL,\n  path = window.location.pathname,\n  selector = '.waline-pageview-count',\n  update = true,\n}: WalinePageviewCountOptions): WalineAbort => {\n  const controller = new AbortController();\n\n  const elements = Array.from(\n    // visitor selectors\n    document.querySelectorAll<HTMLElement>(selector)\n  );\n\n  const filter = (element: HTMLElement): boolean => {\n    const query = getQuery(element);\n\n    return query !== null && path !== query;\n  };\n\n  const fetch = (elements: HTMLElement[]): Promise<void> =>\n    fetchPageviews({\n      serverURL,\n      paths: elements.map((element) => getQuery(element) || path),\n      signal: controller.signal,\n    })\n      .then((counts) => renderVisitorCount(counts, elements))\n      .catch(errorHandler);\n\n  // we should update pageviews\n  if (update) {\n    const normalElements = elements.filter((element) => !filter(element));\n    const elementsNeedstoBeFetched = elements.filter(filter);\n\n    void updatePageviews({ serverURL, path }).then((count) =>\n      renderVisitorCount(\n        new Array<number>(normalElements.length).fill(count),\n        normalElements\n      )\n    );\n\n    // if we should fetch count of other pages\n    if (elementsNeedstoBeFetched.length) {\n      void fetch(elementsNeedstoBeFetched);\n    }\n  }\n  // we should not update pageviews\n  else {\n    void fetch(elements);\n  }\n\n  return controller.abort.bind(controller);\n};\n"],"names":["version","errorHandler","err","name","console","error","message","errorCheck","data","errno","TypeError","errmsg","fetchPageviews","serverURL","paths","signal","fetch","encodeURIComponent","join","then","resp","json","counts","Array","isArray","updatePageviews","path","method","headers","body","JSON","stringify","getQuery","element","dataset","getAttribute","renderVisitorCount","countElements","forEach","index","innerText","toString","pageviewCount","window","location","pathname","selector","update","controller","AbortController","elements","from","document","querySelectorAll","filter","query","map","catch","normalElements","elementsNeedstoBeFetched","count","length","fill","abort","bind"],"mappings":"AAEO,MAAMA,EAAU,QCFVC,EAAgBC,IACV,eAAbA,EAAIC,MAAuBC,QAAQC,MAAMH,EAAII,UCM7CC,EAAa,CAAcC,EAA0BL,EAAO,MAChE,GAAoB,iBAATK,GAAsBA,EAAwBC,MACvD,MAAM,IAAIC,UACR,SAASP,iBAAqBK,EAAwBC,UACnDD,EAAwBG,UAI/B,OAAOH,GAkIII,EAAiB,EAC5BC,UAAAA,EACAC,MAAAA,EACAC,OAAAA,KAEAC,MAAM,GAAGH,kBAA0BI,mBAAmBH,EAAMI,KAAK,QAAS,CACxEH,OAAAA,IAECI,MAAMC,GAASA,EAAKC,SACpBF,MAAMX,GAASD,EAAWC,EAAM,iBAEhCW,MAAMG,GAAYC,MAAMC,QAAQF,GAAUA,EAAS,CAACA,KAO5CG,EAAkB,EAC7BZ,UAAAA,EACAa,KAAAA,KAEAV,MAAM,GAAGH,YAAqB,CAC5Bc,OAAQ,OACRC,QAAS,CAEP,eAAgB,oBAElBC,KAAMC,KAAKC,UAAU,CAAEL,KAAAA,MAEtBP,MAAMC,GAASA,EAAKC,SACpBF,MAAMX,GAASD,EAAWC,EAAM,iBChLxBwB,EAAYC,GACvBA,EAAQC,QAAQR,MAAQO,EAAQE,aAAa,MC4CzCC,EAAqB,CACzBd,EACAe,KAEAA,EAAcC,SAAQ,CAACL,EAASM,KAC9BN,EAAQO,UAAYlB,EAAOiB,GAAOE,eAIzBC,EAAgB,EAC3B7B,UAAAA,EACAa,KAAAA,EAAOiB,OAAOC,SAASC,SACvBC,SAAAA,EAAW,yBACXC,OAAAA,GAAS,MAET,MAAMC,EAAa,IAAIC,gBAEjBC,EAAW3B,MAAM4B,KAErBC,SAASC,iBAA8BP,IAGnCQ,EAAUrB,IACd,MAAMsB,EAAQvB,EAASC,GAEvB,OAAiB,OAAVsB,GAAkB7B,IAAS6B,GAG9BvC,EAASkC,GACbtC,EAAe,CACbC,UAAAA,EACAC,MAAOoC,EAASM,KAAKvB,GAAYD,EAASC,IAAYP,IACtDX,OAAQiC,EAAWjC,SAElBI,MAAMG,GAAWc,EAAmBd,EAAQ4B,KAC5CO,MAAMxD,GAGX,GAAI8C,EAAQ,CACV,MAAMW,EAAiBR,EAASI,QAAQrB,IAAaqB,EAAOrB,KACtD0B,EAA2BT,EAASI,OAAOA,GAE5C7B,EAAgB,CAAEZ,UAAAA,EAAWa,KAAAA,IAAQP,MAAMyC,GAC9CxB,EACE,IAAIb,MAAcmC,EAAeG,QAAQC,KAAKF,GAC9CF,KAKAC,EAAyBE,QACtB7C,EAAM2C,QAKR3C,EAAMkC,GAGb,OAAOF,EAAWe,MAAMC,KAAKhB"}

package/dist/pageview.js

@@ -1,2 +1,2 @@
-!function(e,t){if("function"==typeof define&&define.amd)define("Waline",["exports"],t);else if("undefined"!=typeof exports)t(exports);else{var n={exports:{}};t(n.exports),e.Waline=n.exports}}("undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:this,(function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.version=e.pageviewCount=void 0;e.version="2.0.0-alpha.4";const t=e=>{"AbortError"!==e.name&&console.error(e.message)},n=function(e){let t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:"";if("object"==typeof e&&e.errno)throw new TypeError("Fetch ".concat(t," failed with ").concat(e.errno,": ").concat(e.errmsg));return e},r=e=>{let{serverURL:t,paths:r,signal:o}=e;return fetch("".concat(t,"/article?path=").concat(encodeURIComponent(r.join(","))),{signal:o}).then((e=>e.json())).then((e=>n(e,"visit count"))).then((e=>Array.isArray(e)?e:[e]))},o=e=>{let{serverURL:t,path:r}=e;return fetch("".concat(t,"/article"),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({path:r})}).then((e=>e.json())).then((e=>n(e,"visit count")))},i=e=>e.dataset.path||e.getAttribute("id"),a=(e,t)=>{t.forEach(((t,n)=>{t.innerText=e[n].toString()}))};e.pageviewCount=e=>{let{serverURL:n,path:s=window.location.pathname,selector:l=".waline-pageview-count",update:c=!0}=e;const h=new AbortController,p=Array.from(document.querySelectorAll(l)),f=e=>{const t=i(e);return null!==t&&s!==t},d=e=>r({serverURL:n,paths:e.map((e=>i(e)||s)),signal:h.signal}).then((t=>a(t,e))).catch(t);if(c){const e=p.filter((e=>!f(e))),t=p.filter(f);o({serverURL:n,path:s}).then((t=>a(new Array(e.length).fill(t),e))),t.length&&d(t)}else d(p);return h.abort.bind(h)}}));
+!function(e,t){if("function"==typeof define&&define.amd)define("Waline",["exports"],t);else if("undefined"!=typeof exports)t(exports);else{var n={exports:{}};t(n.exports),e.Waline=n.exports}}("undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:this,(function(e){Object.defineProperty(e,"__esModule",{value:!0}),e.version=e.pageviewCount=void 0;e.version="2.0.2";const t=e=>{"AbortError"!==e.name&&console.error(e.message)},n=function(e){let t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:"";if("object"==typeof e&&e.errno)throw new TypeError("Fetch ".concat(t," failed with ").concat(e.errno,": ").concat(e.errmsg));return e},r=e=>{let{serverURL:t,paths:r,signal:o}=e;return fetch("".concat(t,"/article?path=").concat(encodeURIComponent(r.join(","))),{signal:o}).then((e=>e.json())).then((e=>n(e,"visit count"))).then((e=>Array.isArray(e)?e:[e]))},o=e=>{let{serverURL:t,path:r}=e;return fetch("".concat(t,"/article"),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({path:r})}).then((e=>e.json())).then((e=>n(e,"visit count")))},i=e=>e.dataset.path||e.getAttribute("id"),a=(e,t)=>{t.forEach(((t,n)=>{t.innerText=e[n].toString()}))};e.pageviewCount=e=>{let{serverURL:n,path:s=window.location.pathname,selector:l=".waline-pageview-count",update:c=!0}=e;const f=new AbortController,h=Array.from(document.querySelectorAll(l)),p=e=>{const t=i(e);return null!==t&&s!==t},d=e=>r({serverURL:n,paths:e.map((e=>i(e)||s)),signal:f.signal}).then((t=>a(t,e))).catch(t);if(c){const e=h.filter((e=>!p(e))),t=h.filter(p);o({serverURL:n,path:s}).then((t=>a(new Array(e.length).fill(t),e))),t.length&&d(t)}else d(h);return f.abort.bind(f)}}));
 //# sourceMappingURL=pageview.js.map

package/dist/pageview.js.map

@@ -1 +1 @@
-{"version":3,"file":"pageview.js","sources":["../src/version.ts","../src/utils/error.ts","../src/utils/fetch.ts","../src/utils/query.ts","../src/pageview.ts"],"sourcesContent":["declare const VERSION: string;\n\nexport const version = VERSION;\n","export const errorHandler = (err: Error): void => {\n  if (err.name !== 'AbortError') console.error(err.message);\n};\n","import type { WalineComment, WalineCommentData } from '../typings';\n\nexport interface FetchErrorData {\n  errno: number;\n  errmsg: string;\n}\n\nconst errorCheck = <T = unknown>(data: T | FetchErrorData, name = ''): T => {\n  if (typeof data === 'object' && (data as FetchErrorData).errno)\n    throw new TypeError(\n      `Fetch ${name} failed with ${(data as FetchErrorData).errno}: ${\n        (data as FetchErrorData).errmsg\n      }`\n    );\n\n  return data as T;\n};\n\nexport interface FetchCountOptions {\n  serverURL: string;\n  paths: string[];\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport const fetchCommentCount = ({\n  serverURL,\n  paths,\n  signal,\n  token,\n}: FetchCountOptions): Promise<number[]> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return (\n    fetch(\n      `${serverURL}/comment?type=count&url=${encodeURIComponent(\n        paths.join(',')\n      )}`,\n      { signal, headers }\n    )\n      .then((resp) => resp.json() as Promise<number | number[]>)\n      .then((data) => errorCheck(data, 'comment count'))\n      // TODO: Improve this API\n      .then((counts) => (Array.isArray(counts) ? counts : [counts]))\n  );\n};\nexport interface FetchRecentOptions {\n  serverURL: string;\n  count: number;\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport const fetchRecentComment = ({\n  serverURL,\n  count,\n  signal,\n  token,\n}: FetchRecentOptions): Promise<WalineComment[]> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(`${serverURL}/comment?type=recent&count=${count}`, {\n    signal,\n    headers,\n  })\n    .then((resp) => resp.json() as Promise<WalineComment[]>)\n    .then((data) => errorCheck(data, 'recent comment'));\n};\n\nexport interface FetchListOptions {\n  serverURL: string;\n  path: string;\n  page: number;\n  pageSize: number;\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport interface FetchListResult {\n  count: number;\n  data: WalineComment[];\n  totalPages: number;\n}\n\nexport const fetchCommentList = ({\n  serverURL,\n  path,\n  page,\n  pageSize,\n  signal,\n  token,\n}: FetchListOptions): Promise<FetchListResult> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(\n    `${serverURL}/comment?path=${encodeURIComponent(\n      path\n    )}&pageSize=${pageSize}&page=${page}`,\n    { signal, headers }\n  )\n    .then((resp) => resp.json() as Promise<FetchListResult>)\n    .then((data) => errorCheck(data, 'comment list'));\n};\n\nexport interface PostCommentOptions {\n  serverURL: string;\n  lang: string;\n  token?: string;\n  comment: WalineCommentData;\n}\n\nexport interface PostCommentResponse {\n  data?: WalineComment;\n  errmsg?: string;\n}\n\nexport const postComment = ({\n  serverURL,\n  lang,\n  token,\n  comment,\n}: PostCommentOptions): Promise<PostCommentResponse> => {\n  const headers: Record<string, string> = {\n    // eslint-disable-next-line @typescript-eslint/naming-convention\n    'Content-Type': 'application/json',\n  };\n\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(`${serverURL}/comment?lang=${lang}`, {\n    method: 'POST',\n    headers,\n    body: JSON.stringify(comment),\n  }).then((resp) => resp.json() as Promise<PostCommentResponse>);\n};\n\nexport interface FetchPageviewsOptions {\n  serverURL: string;\n  paths: string[];\n  signal: AbortSignal;\n}\n\nexport const fetchPageviews = ({\n  serverURL,\n  paths,\n  signal,\n}: FetchPageviewsOptions): Promise<number[]> =>\n  fetch(`${serverURL}/article?path=${encodeURIComponent(paths.join(','))}`, {\n    signal,\n  })\n    .then((resp) => resp.json() as Promise<number[] | number>)\n    .then((data) => errorCheck(data, 'visit count'))\n    // TODO: Improve this API\n    .then((counts) => (Array.isArray(counts) ? counts : [counts]));\n\nexport interface UpdatePageviewsOptions {\n  serverURL: string;\n  path: string;\n}\n\nexport const updatePageviews = ({\n  serverURL,\n  path,\n}: UpdatePageviewsOptions): Promise<number> =>\n  fetch(`${serverURL}/article`, {\n    method: 'POST',\n    headers: {\n      // eslint-disable-next-line @typescript-eslint/naming-convention\n      'Content-Type': 'application/json',\n    },\n    body: JSON.stringify({ path }),\n  })\n    .then((resp) => resp.json() as Promise<number>)\n    .then((data) => errorCheck(data, 'visit count'));\n","export const getQuery = (element: HTMLElement): string | null =>\n  element.dataset.path || element.getAttribute('id');\n","import {\n  errorHandler,\n  fetchPageviews,\n  getQuery,\n  updatePageviews,\n} from './utils';\n\nconst renderVisitorCount = (\n  counts: number[],\n  countElements: HTMLElement[]\n): void => {\n  countElements.forEach((element, index) => {\n    element.innerText = counts[index].toString();\n  });\n};\n\nexport interface VisitorCountOptions {\n  /**\n   * Waline server url\n   *\n   * Waline 服务端地址\n   */\n  serverURL: string;\n\n  /**\n   * Path to be fetched and updated\n   *\n   * 需要更新和获取的路径\n   *\n   * @default window.location.pathname\n   */\n  path?: string;\n\n  /**\n   * @default '.waline-pageview-count'\n   */\n  selector?: string;\n\n  /**\n   * Whether update pageviews when fetching path result\n   *\n   * 是否在查询时更新 path 的浏览量\n   *\n   * @default true\n   */\n  update?: boolean;\n}\n\nexport const pageviewCount = ({\n  serverURL,\n  path = window.location.pathname,\n  selector = '.waline-pageview-count',\n  update = true,\n}: VisitorCountOptions): ((reason?: unknown) => void) => {\n  const controller = new AbortController();\n\n  const elements = Array.from(\n    // visitor selectors\n    document.querySelectorAll<HTMLElement>(selector)\n  );\n\n  const filter = (element: HTMLElement): boolean => {\n    const query = getQuery(element);\n\n    return query !== null && path !== query;\n  };\n\n  const fetch = (elements: HTMLElement[]): Promise<void> =>\n    fetchPageviews({\n      serverURL,\n      paths: elements.map((element) => getQuery(element) || path),\n      signal: controller.signal,\n    })\n      .then((counts) => renderVisitorCount(counts, elements))\n      .catch(errorHandler);\n\n  // we should update pageviews\n  if (update) {\n    const normalElements = elements.filter((element) => !filter(element));\n    const elementsNeedstoBeFetched = elements.filter(filter);\n\n    void updatePageviews({ serverURL, path }).then((count) =>\n      renderVisitorCount(\n        new Array<number>(normalElements.length).fill(count),\n        normalElements\n      )\n    );\n\n    // if we should fetch count of other pages\n    if (elementsNeedstoBeFetched.length) {\n      void fetch(elementsNeedstoBeFetched);\n    }\n  }\n  // we should not update pageviews\n  else {\n    void fetch(elements);\n  }\n\n  return controller.abort.bind(controller);\n};\n"],"names":["errorHandler","err","name","console","error","message","errorCheck","data","errno","TypeError","errmsg","fetchPageviews","_ref","serverURL","paths","signal","fetch","concat","encodeURIComponent","join","then","resp","json","counts","Array","isArray","updatePageviews","_ref2","path","method","headers","body","JSON","stringify","getQuery","element","dataset","getAttribute","renderVisitorCount","countElements","forEach","index","innerText","toString","_ref3","window","location","pathname","selector","update","controller","AbortController","elements","from","document","querySelectorAll","filter","query","map","catch","normalElements","elementsNeedstoBeFetched","count","length","fill","abort","bind"],"mappings":"sXAEuB,gBCFVA,MAAAA,EAAgBC,IACV,eAAbA,EAAIC,MAAuBC,QAAQC,MAAMH,EAAII,UCM7CC,EAAa,SAAcC,GAA0BL,IAAAA,yDAAO,GAC5D,GAAgB,iBAATK,GAAsBA,EAAwBC,MACvD,MAAM,IAAIC,UACCP,SAAAA,OAAAA,0BAAqBK,EAAwBC,MACnDD,MAAAA,OAAAA,EAAwBG,SAI/B,OAAOH,GAkIII,EAAiBC,IAAC,IAAAC,UAC7BA,EAD6BC,MAE7BA,EAF6BC,OAG7BA,GAH4BH,EAAA,OAK5BI,MAAK,GAAAC,OAAIJ,EAAJ,kBAAAI,OAA8BC,mBAAmBJ,EAAMK,KAAK,OAAS,CACxEJ,OAAAA,IAECK,MAAMC,GAASA,EAAKC,SACpBF,MAAMb,GAASD,EAAWC,EAAM,iBAEhCa,MAAMG,GAAYC,MAAMC,QAAQF,GAAUA,EAAS,CAACA,MAO5CG,EAAkBC,IAAC,IAAAd,UAC9BA,EAD8Be,KAE9BA,GAF6BD,EAI7BX,OAAAA,MAASH,GAAAA,OAAAA,EAAqB,YAAA,CAC5BgB,OAAQ,OACRC,QAAS,CAES,eAAA,oBAElBC,KAAMC,KAAKC,UAAU,CAAEL,KAAAA,MAEtBR,MAAMC,GAASA,EAAKC,SACpBF,MAAMb,GAASD,EAAWC,EAAM,kBChLxB2B,EAAYC,GACvBA,EAAQC,QAAQR,MAAQO,EAAQE,aAAa,MCMzCC,EAAqB,CACzBf,EACAgB,KAEAA,EAAcC,SAAQ,CAACL,EAASM,KAC9BN,EAAQO,UAAYnB,EAAOkB,GAAOE,+BAoCTC,IAAC,IAAA/B,UAC5BA,EAD4Be,KAE5BA,EAAOiB,OAAOC,SAASC,SAFKC,SAG5BA,EAAW,yBAHiBC,OAI5BA,GAAS,GAC6CL,EACtD,MAAMM,EAAa,IAAIC,gBAEjBC,EAAW5B,MAAM6B,KAErBC,SAASC,iBAA8BP,IAGnCQ,EAAUrB,IACd,MAAMsB,EAAQvB,EAASC,GAEvB,OAAiB,OAAVsB,GAAkB7B,IAAS6B,GAG9BzC,EAASoC,GACbzC,EAAe,CACbE,UAAAA,EACAC,MAAOsC,EAASM,KAAKvB,GAAYD,EAASC,IAAYP,IACtDb,OAAQmC,EAAWnC,SAElBK,MAAMG,GAAWe,EAAmBf,EAAQ6B,KAC5CO,MAAM3D,GAGX,GAAIiD,EAAQ,CACV,MAAMW,EAAiBR,EAASI,QAAQrB,IAAaqB,EAAOrB,KACtD0B,EAA2BT,EAASI,OAAOA,GAE5C9B,EAAgB,CAAEb,UAAAA,EAAWe,KAAAA,IAAQR,MAAM0C,GAC9CxB,EACE,IAAId,MAAcoC,EAAeG,QAAQC,KAAKF,GAC9CF,KAKAC,EAAyBE,QACtB/C,EAAM6C,QAKR7C,EAAMoC,GAGb,OAAOF,EAAWe,MAAMC,KAAKhB"}
+{"version":3,"file":"pageview.js","sources":["../src/version.ts","../src/utils/error.ts","../src/utils/fetch.ts","../src/utils/query.ts","../src/pageview.ts"],"sourcesContent":["declare const VERSION: string;\n\nexport const version = VERSION;\n","export const errorHandler = (err: Error): void => {\n  if (err.name !== 'AbortError') console.error(err.message);\n};\n","import type { WalineComment, WalineCommentData } from '../typings';\n\nexport interface FetchErrorData {\n  errno: number;\n  errmsg: string;\n}\n\nconst errorCheck = <T = unknown>(data: T | FetchErrorData, name = ''): T => {\n  if (typeof data === 'object' && (data as FetchErrorData).errno)\n    throw new TypeError(\n      `Fetch ${name} failed with ${(data as FetchErrorData).errno}: ${\n        (data as FetchErrorData).errmsg\n      }`\n    );\n\n  return data as T;\n};\n\nexport interface FetchCountOptions {\n  serverURL: string;\n  paths: string[];\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport const fetchCommentCount = ({\n  serverURL,\n  paths,\n  signal,\n  token,\n}: FetchCountOptions): Promise<number[]> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return (\n    fetch(\n      `${serverURL}/comment?type=count&url=${encodeURIComponent(\n        paths.join(',')\n      )}`,\n      { signal, headers }\n    )\n      .then((resp) => resp.json() as Promise<number | number[]>)\n      .then((data) => errorCheck(data, 'comment count'))\n      // TODO: Improve this API\n      .then((counts) => (Array.isArray(counts) ? counts : [counts]))\n  );\n};\nexport interface FetchRecentOptions {\n  serverURL: string;\n  count: number;\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport const fetchRecentComment = ({\n  serverURL,\n  count,\n  signal,\n  token,\n}: FetchRecentOptions): Promise<WalineComment[]> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(`${serverURL}/comment?type=recent&count=${count}`, {\n    signal,\n    headers,\n  })\n    .then((resp) => resp.json() as Promise<WalineComment[]>)\n    .then((data) => errorCheck(data, 'recent comment'));\n};\n\nexport interface FetchListOptions {\n  serverURL: string;\n  path: string;\n  page: number;\n  pageSize: number;\n  signal: AbortSignal;\n  token?: string;\n}\n\nexport interface FetchListResult {\n  count: number;\n  data: WalineComment[];\n  totalPages: number;\n}\n\nexport const fetchCommentList = ({\n  serverURL,\n  path,\n  page,\n  pageSize,\n  signal,\n  token,\n}: FetchListOptions): Promise<FetchListResult> => {\n  const headers: Record<string, string> = {};\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(\n    `${serverURL}/comment?path=${encodeURIComponent(\n      path\n    )}&pageSize=${pageSize}&page=${page}`,\n    { signal, headers }\n  )\n    .then((resp) => resp.json() as Promise<FetchListResult>)\n    .then((data) => errorCheck(data, 'comment list'));\n};\n\nexport interface PostCommentOptions {\n  serverURL: string;\n  lang: string;\n  token?: string;\n  comment: WalineCommentData;\n}\n\nexport interface PostCommentResponse {\n  data?: WalineComment;\n  errmsg?: string;\n}\n\nexport const postComment = ({\n  serverURL,\n  lang,\n  token,\n  comment,\n}: PostCommentOptions): Promise<PostCommentResponse> => {\n  const headers: Record<string, string> = {\n    // eslint-disable-next-line @typescript-eslint/naming-convention\n    'Content-Type': 'application/json',\n  };\n\n  if (token) headers.Authorization = `Bearer ${token}`;\n\n  return fetch(`${serverURL}/comment?lang=${lang}`, {\n    method: 'POST',\n    headers,\n    body: JSON.stringify(comment),\n  }).then((resp) => resp.json() as Promise<PostCommentResponse>);\n};\n\nexport interface FetchPageviewsOptions {\n  serverURL: string;\n  paths: string[];\n  signal: AbortSignal;\n}\n\nexport const fetchPageviews = ({\n  serverURL,\n  paths,\n  signal,\n}: FetchPageviewsOptions): Promise<number[]> =>\n  fetch(`${serverURL}/article?path=${encodeURIComponent(paths.join(','))}`, {\n    signal,\n  })\n    .then((resp) => resp.json() as Promise<number[] | number>)\n    .then((data) => errorCheck(data, 'visit count'))\n    // TODO: Improve this API\n    .then((counts) => (Array.isArray(counts) ? counts : [counts]));\n\nexport interface UpdatePageviewsOptions {\n  serverURL: string;\n  path: string;\n}\n\nexport const updatePageviews = ({\n  serverURL,\n  path,\n}: UpdatePageviewsOptions): Promise<number> =>\n  fetch(`${serverURL}/article`, {\n    method: 'POST',\n    headers: {\n      // eslint-disable-next-line @typescript-eslint/naming-convention\n      'Content-Type': 'application/json',\n    },\n    body: JSON.stringify({ path }),\n  })\n    .then((resp) => resp.json() as Promise<number>)\n    .then((data) => errorCheck(data, 'visit count'));\n","export const getQuery = (element: HTMLElement): string | null =>\n  element.dataset.path || element.getAttribute('id');\n","import {\n  errorHandler,\n  fetchPageviews,\n  getQuery,\n  updatePageviews,\n} from './utils';\n\nimport type { WalineAbort } from './typings';\n\nexport interface WalinePageviewCountOptions {\n  /**\n   * Waline 服务端地址\n   *\n   * Waline server url\n   */\n  serverURL: string;\n\n  /**\n   * 浏览量 CSS 选择器\n   *\n   * Pageview CSS selector\n   *\n   * @default '.waline-pageview-count'\n   */\n  selector?: string;\n\n  /**\n   * 需要更新和获取的路径\n   *\n   * Path to be fetched and updated\n   *\n   * @default window.location.pathname\n   */\n  path?: string;\n\n  /**\n   * 是否在查询时更新 path 的浏览量\n   *\n   * Whether update pageviews when fetching path result\n   *\n   * @default true\n   */\n  update?: boolean;\n}\n\nconst renderVisitorCount = (\n  counts: number[],\n  countElements: HTMLElement[]\n): void => {\n  countElements.forEach((element, index) => {\n    element.innerText = counts[index].toString();\n  });\n};\n\nexport const pageviewCount = ({\n  serverURL,\n  path = window.location.pathname,\n  selector = '.waline-pageview-count',\n  update = true,\n}: WalinePageviewCountOptions): WalineAbort => {\n  const controller = new AbortController();\n\n  const elements = Array.from(\n    // visitor selectors\n    document.querySelectorAll<HTMLElement>(selector)\n  );\n\n  const filter = (element: HTMLElement): boolean => {\n    const query = getQuery(element);\n\n    return query !== null && path !== query;\n  };\n\n  const fetch = (elements: HTMLElement[]): Promise<void> =>\n    fetchPageviews({\n      serverURL,\n      paths: elements.map((element) => getQuery(element) || path),\n      signal: controller.signal,\n    })\n      .then((counts) => renderVisitorCount(counts, elements))\n      .catch(errorHandler);\n\n  // we should update pageviews\n  if (update) {\n    const normalElements = elements.filter((element) => !filter(element));\n    const elementsNeedstoBeFetched = elements.filter(filter);\n\n    void updatePageviews({ serverURL, path }).then((count) =>\n      renderVisitorCount(\n        new Array<number>(normalElements.length).fill(count),\n        normalElements\n      )\n    );\n\n    // if we should fetch count of other pages\n    if (elementsNeedstoBeFetched.length) {\n      void fetch(elementsNeedstoBeFetched);\n    }\n  }\n  // we should not update pageviews\n  else {\n    void fetch(elements);\n  }\n\n  return controller.abort.bind(controller);\n};\n"],"names":["errorHandler","err","name","console","error","message","errorCheck","data","errno","TypeError","errmsg","fetchPageviews","_ref","serverURL","paths","signal","fetch","concat","encodeURIComponent","join","then","resp","json","counts","Array","isArray","updatePageviews","_ref2","path","method","headers","body","JSON","stringify","getQuery","element","dataset","getAttribute","renderVisitorCount","countElements","forEach","index","innerText","toString","_ref3","window","location","pathname","selector","update","controller","AbortController","elements","from","document","querySelectorAll","filter","query","map","catch","normalElements","elementsNeedstoBeFetched","count","length","fill","abort","bind"],"mappings":"sXAEuB,QCFVA,MAAAA,EAAgBC,IACV,eAAbA,EAAIC,MAAuBC,QAAQC,MAAMH,EAAII,UCM7CC,EAAa,SAAcC,GAA0BL,IAAAA,yDAAO,GAC5D,GAAgB,iBAATK,GAAsBA,EAAwBC,MACvD,MAAM,IAAIC,UACCP,SAAAA,OAAAA,0BAAqBK,EAAwBC,MACnDD,MAAAA,OAAAA,EAAwBG,SAI/B,OAAOH,GAkIII,EAAiBC,IAAC,IAAAC,UAC7BA,EAD6BC,MAE7BA,EAF6BC,OAG7BA,GAH4BH,EAAA,OAK5BI,MAAK,GAAAC,OAAIJ,EAAJ,kBAAAI,OAA8BC,mBAAmBJ,EAAMK,KAAK,OAAS,CACxEJ,OAAAA,IAECK,MAAMC,GAASA,EAAKC,SACpBF,MAAMb,GAASD,EAAWC,EAAM,iBAEhCa,MAAMG,GAAYC,MAAMC,QAAQF,GAAUA,EAAS,CAACA,MAO5CG,EAAkBC,IAAC,IAAAd,UAC9BA,EAD8Be,KAE9BA,GAF6BD,EAI7BX,OAAAA,MAASH,GAAAA,OAAAA,EAAqB,YAAA,CAC5BgB,OAAQ,OACRC,QAAS,CAES,eAAA,oBAElBC,KAAMC,KAAKC,UAAU,CAAEL,KAAAA,MAEtBR,MAAMC,GAASA,EAAKC,SACpBF,MAAMb,GAASD,EAAWC,EAAM,kBChLxB2B,EAAYC,GACvBA,EAAQC,QAAQR,MAAQO,EAAQE,aAAa,MC4CzCC,EAAqB,CACzBf,EACAgB,KAEAA,EAAcC,SAAQ,CAACL,EAASM,KAC9BN,EAAQO,UAAYnB,EAAOkB,GAAOE,+BAITC,IAAC,IAAA/B,UAC5BA,EAD4Be,KAE5BA,EAAOiB,OAAOC,SAASC,SAFKC,SAG5BA,EAAW,yBAHiBC,OAI5BA,GAAS,GACmCL,EAC5C,MAAMM,EAAa,IAAIC,gBAEjBC,EAAW5B,MAAM6B,KAErBC,SAASC,iBAA8BP,IAGnCQ,EAAUrB,IACd,MAAMsB,EAAQvB,EAASC,GAEvB,OAAiB,OAAVsB,GAAkB7B,IAAS6B,GAG9BzC,EAASoC,GACbzC,EAAe,CACbE,UAAAA,EACAC,MAAOsC,EAASM,KAAKvB,GAAYD,EAASC,IAAYP,IACtDb,OAAQmC,EAAWnC,SAElBK,MAAMG,GAAWe,EAAmBf,EAAQ6B,KAC5CO,MAAM3D,GAGX,GAAIiD,EAAQ,CACV,MAAMW,EAAiBR,EAASI,QAAQrB,IAAaqB,EAAOrB,KACtD0B,EAA2BT,EAASI,OAAOA,GAE5C9B,EAAgB,CAAEb,UAAAA,EAAWe,KAAAA,IAAQR,MAAM0C,GAC9CxB,EACE,IAAId,MAAcoC,EAAeG,QAAQC,KAAKF,GAC9CF,KAKAC,EAAyBE,QACtB/C,EAAM6C,QAKR7C,EAAMoC,GAGb,OAAOF,EAAWe,MAAMC,KAAKhB"}

package/dist/shim.d.ts

@@ -319,6 +319,7 @@ interface WalineInitOptions extends Omit<WalineProps, 'path'> {
      */
     path?: string;
 }
+declare type WalineAbort = (reason?: any) => void;
 
 declare const getMeta: (meta: WalineMeta[]) => WalineMeta[];
 declare const defaultLang = "zh-CN";
@@ -328,61 +329,132 @@ declare const defaultTexRenderer: (blockMode: boolean) => string;
 declare type Locales = Record<string, WalineLocale>;
 declare const locales: Locales;
 
-interface CommentCountOptions {
+interface WalineCommentCountOptions {
+    /**
+     * Waline 服务端地址
+     *
+     * Waline server url
+     */
     serverURL: string;
+    /**
+     * 评论数 CSS 选择器
+     *
+     * Commment count CSS selector
+     *
+     * @default '.waline-comment-count'
+     */
     selector?: string;
+    /**
+     * 需要获取的默认路径
+     *
+     * Path to be fetched by default
+     *
+     * @default window.location.pathname
+     */
     path?: string;
 }
-declare const commentCount: ({ serverURL, path, selector, }: CommentCountOptions) => (reason?: unknown) => void;
+declare const commentCount: ({ serverURL, path, selector, }: WalineCommentCountOptions) => WalineAbort;
 
 interface WalineInstance {
+    /**
+     * Waline 被挂载到的元素
+     *
+     * @description 当通过 `el: null` 初始化，值为 `null`
+     *
+     * Element where Waline is mounted
+     *
+     * @description when initialized with `el: null`, it will be `null`
+     */
     el: HTMLElement | null;
-    update: (newOptions: Partial<WalineProps>) => void;
+    /**
+     * 更新 Waline 实例
+     *
+     * @description 只要不设置`path` 选项，更新时它就会被重置为 `windows.location.pathname`
+     *
+     * Update Waline instance
+     *
+     * @description when not setting `path` option, it will be reset to `window.location.pathname`
+     */
+    update: (newOptions: Partial<Omit<WalineInitOptions, 'el'>>) => void;
+    /**
+     * 取消挂载并摧毁 Waline 实例
+     *
+     * Unmount and destroy Waline instance
+     */
     destroy: () => void;
 }
 declare const init: ({ el, path, comment, pageview, ...initProps }: WalineInitOptions) => WalineInstance | null;
 
-interface VisitorCountOptions {
+interface WalinePageviewCountOptions {
     /**
-     * Waline server url
-     *
      * Waline 服务端地址
+     *
+     * Waline server url
      */
     serverURL: string;
     /**
-     * Path to be fetched and updated
+     * 浏览量 CSS 选择器
      *
-     * 需要更新和获取的路径
+     * Pageview CSS selector
      *
-     * @default window.location.pathname
-     */
-    path?: string;
-    /**
      * @default '.waline-pageview-count'
      */
     selector?: string;
     /**
-     * Whether update pageviews when fetching path result
+     * 需要更新和获取的路径
+     *
+     * Path to be fetched and updated
      *
+     * @default window.location.pathname
+     */
+    path?: string;
+    /**
      * 是否在查询时更新 path 的浏览量
      *
+     * Whether update pageviews when fetching path result
+     *
      * @default true
      */
     update?: boolean;
 }
-declare const pageviewCount: ({ serverURL, path, selector, update, }: VisitorCountOptions) => (reason?: unknown) => void;
+declare const pageviewCount: ({ serverURL, path, selector, update, }: WalinePageviewCountOptions) => WalineAbort;
 
 declare const version: string;
 
-interface RecentCommentsOptions {
+interface WalineRecentCommentsOptions {
+    /**
+     * Waline 服务端地址
+     *
+     * Waline serverURL
+     */
     serverURL: string;
+    /**
+     * 获取最新评论的数量
+     *
+     * fetch number of latest comments
+     */
     count: number;
+    /**
+     * 需要挂载的元素
+     *
+     * Element to be mounted
+     */
     el?: string | HTMLElement;
 }
-interface RecentCommentsResult {
+interface WalineRecentCommentsResult {
+    /**
+     * 评论数据
+     *
+     * Comment Data
+     */
     comments: WalineComment[];
+    /**
+     * 取消挂载挂件
+     *
+     * Umount widget
+     */
     destroy: () => void;
 }
-declare const RecentComments: ({ el, serverURL, count, }: RecentCommentsOptions) => Promise<RecentCommentsResult>;
+declare const RecentComments: ({ el, serverURL, count, }: WalineRecentCommentsOptions) => Promise<WalineRecentCommentsResult>;
 
-export { CommentCountOptions, Locales, RecentComments, RecentCommentsOptions, RecentCommentsResult, VisitorCountOptions, WalineComment, WalineCommentData, WalineEmojiInfo, WalineEmojiMaps, WalineHighlighter, WalineImageUploader, WalineInitOptions, WalineInstance, WalineLocale, WalineMeta, WalineProps, WalineTexRenderer, commentCount, defaultLang, defaultTexRenderer, defaultUploadImage, getMeta, init, locales, pageviewCount, version };
+export { Locales, RecentComments, WalineAbort, WalineComment, WalineCommentCountOptions, WalineCommentData, WalineEmojiInfo, WalineEmojiMaps, WalineHighlighter, WalineImageUploader, WalineInitOptions, WalineInstance, WalineLocale, WalineMeta, WalinePageviewCountOptions, WalineProps, WalineRecentCommentsOptions, WalineRecentCommentsResult, WalineTexRenderer, commentCount, defaultLang, defaultTexRenderer, defaultUploadImage, getMeta, init, locales, pageviewCount, version };

package/dist/shim.esm.d.ts

@@ -319,6 +319,7 @@ interface WalineInitOptions extends Omit<WalineProps, 'path'> {
      */
     path?: string;
 }
+declare type WalineAbort = (reason?: any) => void;
 
 declare const getMeta: (meta: WalineMeta[]) => WalineMeta[];
 declare const defaultLang = "zh-CN";
@@ -328,61 +329,132 @@ declare const defaultTexRenderer: (blockMode: boolean) => string;
 declare type Locales = Record<string, WalineLocale>;
 declare const locales: Locales;
 
-interface CommentCountOptions {
+interface WalineCommentCountOptions {
+    /**
+     * Waline 服务端地址
+     *
+     * Waline server url
+     */
     serverURL: string;
+    /**
+     * 评论数 CSS 选择器
+     *
+     * Commment count CSS selector
+     *
+     * @default '.waline-comment-count'
+     */
     selector?: string;
+    /**
+     * 需要获取的默认路径
+     *
+     * Path to be fetched by default
+     *
+     * @default window.location.pathname
+     */
     path?: string;
 }
-declare const commentCount: ({ serverURL, path, selector, }: CommentCountOptions) => (reason?: unknown) => void;
+declare const commentCount: ({ serverURL, path, selector, }: WalineCommentCountOptions) => WalineAbort;
 
 interface WalineInstance {
+    /**
+     * Waline 被挂载到的元素
+     *
+     * @description 当通过 `el: null` 初始化，值为 `null`
+     *
+     * Element where Waline is mounted
+     *
+     * @description when initialized with `el: null`, it will be `null`
+     */
     el: HTMLElement | null;
-    update: (newOptions: Partial<WalineProps>) => void;
+    /**
+     * 更新 Waline 实例
+     *
+     * @description 只要不设置`path` 选项，更新时它就会被重置为 `windows.location.pathname`
+     *
+     * Update Waline instance
+     *
+     * @description when not setting `path` option, it will be reset to `window.location.pathname`
+     */
+    update: (newOptions: Partial<Omit<WalineInitOptions, 'el'>>) => void;
+    /**
+     * 取消挂载并摧毁 Waline 实例
+     *
+     * Unmount and destroy Waline instance
+     */
     destroy: () => void;
 }
 declare const init: ({ el, path, comment, pageview, ...initProps }: WalineInitOptions) => WalineInstance | null;
 
-interface VisitorCountOptions {
+interface WalinePageviewCountOptions {
     /**
-     * Waline server url
-     *
      * Waline 服务端地址
+     *
+     * Waline server url
      */
     serverURL: string;
     /**
-     * Path to be fetched and updated
+     * 浏览量 CSS 选择器
      *
-     * 需要更新和获取的路径
+     * Pageview CSS selector
      *
-     * @default window.location.pathname
-     */
-    path?: string;
-    /**
      * @default '.waline-pageview-count'
      */
     selector?: string;
     /**
-     * Whether update pageviews when fetching path result
+     * 需要更新和获取的路径
+     *
+     * Path to be fetched and updated
      *
+     * @default window.location.pathname
+     */
+    path?: string;
+    /**
      * 是否在查询时更新 path 的浏览量
      *
+     * Whether update pageviews when fetching path result
+     *
      * @default true
      */
     update?: boolean;
 }
-declare const pageviewCount: ({ serverURL, path, selector, update, }: VisitorCountOptions) => (reason?: unknown) => void;
+declare const pageviewCount: ({ serverURL, path, selector, update, }: WalinePageviewCountOptions) => WalineAbort;
 
 declare const version: string;
 
-interface RecentCommentsOptions {
+interface WalineRecentCommentsOptions {
+    /**
+     * Waline 服务端地址
+     *
+     * Waline serverURL
+     */
     serverURL: string;
+    /**
+     * 获取最新评论的数量
+     *
+     * fetch number of latest comments
+     */
     count: number;
+    /**
+     * 需要挂载的元素
+     *
+     * Element to be mounted
+     */
     el?: string | HTMLElement;
 }
-interface RecentCommentsResult {
+interface WalineRecentCommentsResult {
+    /**
+     * 评论数据
+     *
+     * Comment Data
+     */
     comments: WalineComment[];
+    /**
+     * 取消挂载挂件
+     *
+     * Umount widget
+     */
     destroy: () => void;
 }
-declare const RecentComments: ({ el, serverURL, count, }: RecentCommentsOptions) => Promise<RecentCommentsResult>;
+declare const RecentComments: ({ el, serverURL, count, }: WalineRecentCommentsOptions) => Promise<WalineRecentCommentsResult>;
 
-export { CommentCountOptions, Locales, RecentComments, RecentCommentsOptions, RecentCommentsResult, VisitorCountOptions, WalineComment, WalineCommentData, WalineEmojiInfo, WalineEmojiMaps, WalineHighlighter, WalineImageUploader, WalineInitOptions, WalineInstance, WalineLocale, WalineMeta, WalineProps, WalineTexRenderer, commentCount, defaultLang, defaultTexRenderer, defaultUploadImage, getMeta, init, locales, pageviewCount, version };
+export { Locales, RecentComments, WalineAbort, WalineComment, WalineCommentCountOptions, WalineCommentData, WalineEmojiInfo, WalineEmojiMaps, WalineHighlighter, WalineImageUploader, WalineInitOptions, WalineInstance, WalineLocale, WalineMeta, WalinePageviewCountOptions, WalineProps, WalineRecentCommentsOptions, WalineRecentCommentsResult, WalineTexRenderer, commentCount, defaultLang, defaultTexRenderer, defaultUploadImage, getMeta, init, locales, pageviewCount, version };