@visulima/pagination 2.0.4 → 2.0.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +15 -0
- package/dist/index.d.mts +79 -0
- package/dist/index.d.ts +40 -42
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +1 -1
- package/dist/index.mjs.map +1 -1
- package/package.json +30 -35
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,18 @@
|
|
|
1
|
+
## @visulima/pagination [2.0.6](https://github.com/visulima/visulima/compare/@visulima/pagination@2.0.5...@visulima/pagination@2.0.6) (2023-07-28)
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
### Bug Fixes
|
|
5
|
+
|
|
6
|
+
* Update eslint rules and dependencies ([01a4bef](https://github.com/visulima/visulima/commit/01a4beff467091ac2d2fc6f342d274d282391842))
|
|
7
|
+
|
|
8
|
+
## @visulima/pagination [2.0.5](https://github.com/visulima/visulima/compare/@visulima/pagination@2.0.4...@visulima/pagination@2.0.5) (2023-07-26)
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
### Bug Fixes
|
|
12
|
+
|
|
13
|
+
* Update eslint-config version to 10.0.6 across multiple packages ([391238a](https://github.com/visulima/visulima/commit/391238ab4d00335e4ad47d7b705960d0af9a5412))
|
|
14
|
+
* Update paginator and eslint configuration file ([d7528a3](https://github.com/visulima/visulima/commit/d7528a3dcd73aa241de2f92d8871e1995da84a08))
|
|
15
|
+
|
|
1
16
|
## @visulima/pagination [2.0.4](https://github.com/visulima/visulima/compare/@visulima/pagination@2.0.3...@visulima/pagination@2.0.4) (2023-06-06)
|
|
2
17
|
|
|
3
18
|
|
package/dist/index.d.mts
ADDED
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
import { OpenAPIV3 } from 'openapi-types';
|
|
2
|
+
|
|
3
|
+
interface PaginationMeta {
|
|
4
|
+
firstPage: number;
|
|
5
|
+
firstPageUrl: string | null;
|
|
6
|
+
lastPage: number;
|
|
7
|
+
lastPageUrl: string | null;
|
|
8
|
+
nextPageUrl: string | null;
|
|
9
|
+
page: number;
|
|
10
|
+
perPage: number;
|
|
11
|
+
previousPageUrl: string | null;
|
|
12
|
+
total: number;
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
interface PaginationResult<Result> {
|
|
16
|
+
data: Result[];
|
|
17
|
+
meta: PaginationMeta;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
interface Paginator$1<Result> extends Array<Result> {
|
|
21
|
+
all: () => Result[];
|
|
22
|
+
|
|
23
|
+
baseUrl: (url: string) => this;
|
|
24
|
+
readonly currentPage: number;
|
|
25
|
+
readonly firstPage: number;
|
|
26
|
+
getMeta: () => PaginationMeta;
|
|
27
|
+
getNextPageUrl: () => string | null;
|
|
28
|
+
getPreviousPageUrl: () => string | null;
|
|
29
|
+
getUrl: (page: number) => string;
|
|
30
|
+
getUrlsForRange: (start: number, end: number) => { isActive: boolean; page: number; url: string }[];
|
|
31
|
+
readonly hasMorePages: boolean;
|
|
32
|
+
|
|
33
|
+
readonly hasPages: boolean;
|
|
34
|
+
readonly hasTotal: boolean;
|
|
35
|
+
readonly isEmpty: boolean;
|
|
36
|
+
readonly lastPage: number;
|
|
37
|
+
readonly perPage: number;
|
|
38
|
+
queryString: (values: Record<string, unknown>) => this;
|
|
39
|
+
toJSON: () => PaginationResult<Result>;
|
|
40
|
+
readonly total: number;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
type UrlsForRange = {
|
|
44
|
+
isActive: boolean;
|
|
45
|
+
page: number;
|
|
46
|
+
url: string;
|
|
47
|
+
}[];
|
|
48
|
+
declare class Paginator<T = unknown> extends Array<T> implements Paginator$1<T> {
|
|
49
|
+
private readonly totalNumber;
|
|
50
|
+
readonly perPage: number;
|
|
51
|
+
currentPage: number;
|
|
52
|
+
private qs;
|
|
53
|
+
private readonly rows;
|
|
54
|
+
private url;
|
|
55
|
+
readonly firstPage: number;
|
|
56
|
+
readonly isEmpty: boolean;
|
|
57
|
+
constructor(totalNumber: number, perPage: number, currentPage: number, ...rows: T[]);
|
|
58
|
+
all(): T[];
|
|
59
|
+
baseUrl(url: string): this;
|
|
60
|
+
getMeta(): PaginationMeta;
|
|
61
|
+
getNextPageUrl(): string | null;
|
|
62
|
+
getPreviousPageUrl(): string | null;
|
|
63
|
+
getUrl(page: number): string;
|
|
64
|
+
getUrlsForRange(start: number, end: number): UrlsForRange;
|
|
65
|
+
get hasMorePages(): boolean;
|
|
66
|
+
get hasPages(): boolean;
|
|
67
|
+
get hasTotal(): boolean;
|
|
68
|
+
get lastPage(): number;
|
|
69
|
+
queryString(values: Record<string, unknown>): this;
|
|
70
|
+
toJSON(): PaginationResult<T>;
|
|
71
|
+
get total(): number;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
declare const createPaginationMetaSchemaObject: (name?: string) => Record<string, OpenAPIV3.SchemaObject>;
|
|
75
|
+
declare const createPaginationSchemaObject: (name: string, items: OpenAPIV3.ReferenceObject | OpenAPIV3.SchemaObject, metaReference?: string) => Record<string, OpenAPIV3.SchemaObject>;
|
|
76
|
+
|
|
77
|
+
declare const paginate: <Result>(page: number, perPage: number, total: number, rows: Result[]) => Paginator$1<Result>;
|
|
78
|
+
|
|
79
|
+
export { PaginationMeta, PaginationResult, Paginator, Paginator$1 as PaginatorInterface, createPaginationMetaSchemaObject, createPaginationSchemaObject, paginate };
|
package/dist/index.d.ts
CHANGED
|
@@ -1,80 +1,78 @@
|
|
|
1
1
|
import { OpenAPIV3 } from 'openapi-types';
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
type PaginationMeta = {
|
|
5
|
-
total: number;
|
|
6
|
-
perPage: number;
|
|
7
|
-
page: number;
|
|
8
|
-
lastPage: number;
|
|
3
|
+
interface PaginationMeta {
|
|
9
4
|
firstPage: number;
|
|
10
5
|
firstPageUrl: string | null;
|
|
6
|
+
lastPage: number;
|
|
11
7
|
lastPageUrl: string | null;
|
|
12
8
|
nextPageUrl: string | null;
|
|
9
|
+
page: number;
|
|
10
|
+
perPage: number;
|
|
13
11
|
previousPageUrl: string | null;
|
|
14
|
-
|
|
12
|
+
total: number;
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
interface PaginationResult<Result> {
|
|
16
|
+
data: Result[];
|
|
17
|
+
meta: PaginationMeta;
|
|
18
|
+
}
|
|
15
19
|
|
|
16
20
|
interface Paginator$1<Result> extends Array<Result> {
|
|
17
21
|
all: () => Result[];
|
|
18
22
|
|
|
19
|
-
readonly firstPage: number;
|
|
20
|
-
readonly perPage: number;
|
|
21
|
-
readonly currentPage: number;
|
|
22
|
-
readonly lastPage: number;
|
|
23
|
-
readonly hasPages: boolean;
|
|
24
|
-
readonly hasMorePages: boolean;
|
|
25
|
-
readonly isEmpty: boolean;
|
|
26
|
-
readonly total: number;
|
|
27
|
-
readonly hasTotal: boolean;
|
|
28
|
-
|
|
29
23
|
baseUrl: (url: string) => this;
|
|
30
|
-
|
|
31
|
-
|
|
24
|
+
readonly currentPage: number;
|
|
25
|
+
readonly firstPage: number;
|
|
32
26
|
getMeta: () => PaginationMeta;
|
|
33
27
|
getNextPageUrl: () => string | null;
|
|
34
28
|
getPreviousPageUrl: () => string | null;
|
|
35
|
-
|
|
29
|
+
getUrl: (page: number) => string;
|
|
30
|
+
getUrlsForRange: (start: number, end: number) => { isActive: boolean; page: number; url: string }[];
|
|
31
|
+
readonly hasMorePages: boolean;
|
|
32
|
+
|
|
33
|
+
readonly hasPages: boolean;
|
|
34
|
+
readonly hasTotal: boolean;
|
|
35
|
+
readonly isEmpty: boolean;
|
|
36
|
+
readonly lastPage: number;
|
|
37
|
+
readonly perPage: number;
|
|
38
|
+
queryString: (values: Record<string, unknown>) => this;
|
|
36
39
|
toJSON: () => PaginationResult<Result>;
|
|
40
|
+
readonly total: number;
|
|
37
41
|
}
|
|
38
42
|
|
|
39
43
|
type UrlsForRange = {
|
|
40
|
-
url: string;
|
|
41
|
-
page: number;
|
|
42
44
|
isActive: boolean;
|
|
45
|
+
page: number;
|
|
46
|
+
url: string;
|
|
43
47
|
}[];
|
|
44
|
-
declare class Paginator<T =
|
|
48
|
+
declare class Paginator<T = unknown> extends Array<T> implements Paginator$1<T> {
|
|
45
49
|
private readonly totalNumber;
|
|
46
50
|
readonly perPage: number;
|
|
47
51
|
currentPage: number;
|
|
48
52
|
private qs;
|
|
49
|
-
private url;
|
|
50
53
|
private readonly rows;
|
|
54
|
+
private url;
|
|
51
55
|
readonly firstPage: number;
|
|
52
56
|
readonly isEmpty: boolean;
|
|
53
|
-
constructor(totalNumber: number, perPage: number, currentPage: number, ...rows:
|
|
54
|
-
get hasTotal(): boolean;
|
|
55
|
-
get hasMorePages(): boolean;
|
|
56
|
-
get hasPages(): boolean;
|
|
57
|
-
get lastPage(): number;
|
|
58
|
-
get total(): number;
|
|
57
|
+
constructor(totalNumber: number, perPage: number, currentPage: number, ...rows: T[]);
|
|
59
58
|
all(): T[];
|
|
60
|
-
getMeta(): PaginationMeta;
|
|
61
|
-
toJSON(): PaginationResult<T>;
|
|
62
|
-
queryString(values: {
|
|
63
|
-
[key: string]: any;
|
|
64
|
-
}): this;
|
|
65
59
|
baseUrl(url: string): this;
|
|
66
|
-
|
|
60
|
+
getMeta(): PaginationMeta;
|
|
67
61
|
getNextPageUrl(): string | null;
|
|
68
62
|
getPreviousPageUrl(): string | null;
|
|
63
|
+
getUrl(page: number): string;
|
|
69
64
|
getUrlsForRange(start: number, end: number): UrlsForRange;
|
|
65
|
+
get hasMorePages(): boolean;
|
|
66
|
+
get hasPages(): boolean;
|
|
67
|
+
get hasTotal(): boolean;
|
|
68
|
+
get lastPage(): number;
|
|
69
|
+
queryString(values: Record<string, unknown>): this;
|
|
70
|
+
toJSON(): PaginationResult<T>;
|
|
71
|
+
get total(): number;
|
|
70
72
|
}
|
|
71
73
|
|
|
72
|
-
declare const createPaginationMetaSchemaObject: (name?: string) =>
|
|
73
|
-
|
|
74
|
-
};
|
|
75
|
-
declare const createPaginationSchemaObject: (name: string, items: OpenAPIV3.ReferenceObject | OpenAPIV3.SchemaObject, metaReference?: string) => {
|
|
76
|
-
[key: string]: OpenAPIV3.SchemaObject;
|
|
77
|
-
};
|
|
74
|
+
declare const createPaginationMetaSchemaObject: (name?: string) => Record<string, OpenAPIV3.SchemaObject>;
|
|
75
|
+
declare const createPaginationSchemaObject: (name: string, items: OpenAPIV3.ReferenceObject | OpenAPIV3.SchemaObject, metaReference?: string) => Record<string, OpenAPIV3.SchemaObject>;
|
|
78
76
|
|
|
79
77
|
declare const paginate: <Result>(page: number, perPage: number, total: number, rows: Result[]) => Paginator$1<Result>;
|
|
80
78
|
|
package/dist/index.js
CHANGED
|
@@ -6,7 +6,7 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
|
|
|
6
6
|
|
|
7
7
|
var o__default = /*#__PURE__*/_interopDefault(o);
|
|
8
8
|
|
|
9
|
-
var i=class extends Array{constructor(e,a,s,...r){super(...r);this.totalNumber=e;this.perPage=a;this.currentPage=s;this.qs={};this.url="/";this.firstPage=1;this.totalNumber=Number(e),this.rows=r,this.isEmpty=this.rows.length===0;}
|
|
9
|
+
var i=class extends Array{constructor(e,a,s,...r){super(...r);this.totalNumber=e;this.perPage=a;this.currentPage=s;this.qs={};this.url="/";this.firstPage=1;this.totalNumber=Number(e),this.rows=r,this.isEmpty=this.rows.length===0;}all(){return this.rows}baseUrl(e){return this.url=e,this}getMeta(){return {firstPage:this.firstPage,firstPageUrl:this.getUrl(1),lastPage:this.lastPage,lastPageUrl:this.getUrl(this.lastPage),nextPageUrl:this.getNextPageUrl(),page:this.currentPage,perPage:this.perPage,previousPageUrl:this.getPreviousPageUrl(),total:this.total}}getNextPageUrl(){return this.hasMorePages?this.getUrl(this.currentPage+1):null}getPreviousPageUrl(){return this.currentPage>1?this.getUrl(this.currentPage-1):null}getUrl(e){let a=o__default.default.stringify({...this.qs,page:e<1?1:e});return `${this.url}?${a}`}getUrlsForRange(e,a){let s=[];for(let r=e;r<=a;r++)s.push({isActive:r===this.currentPage,page:r,url:this.getUrl(r)});return s}get hasMorePages(){return this.lastPage>this.currentPage}get hasPages(){return this.lastPage!==1}get hasTotal(){return this.total>0}get lastPage(){return Math.max(Math.ceil(this.total/this.perPage),1)}queryString(e){return this.qs=e,this}toJSON(){return {data:this.all(),meta:this.getMeta()}}get total(){return Number(this.totalNumber)}};var g=(t="PaginationData")=>({[t]:{properties:{firstPage:{description:"Returns the number for the first page. It is always 1",minimum:0,type:"integer"},firstPageUrl:{description:"The URL for the first page",type:"string"},lastPage:{description:"Returns the value for the last page by taking the total of rows into account",minimum:0,type:"integer"},lastPageUrl:{description:"The URL for the last page",type:"string"},nextPageUrl:{description:"The URL for the next page",type:"string"},page:{description:"Current page number",minimum:1,type:"integer"},perPage:{description:"Returns the value for the limit passed to the paginate method",minimum:0,type:"integer"},previousPageUrl:{description:"The URL for the previous page",type:"string"},total:{description:"Holds the value for the total number of rows in the database",minimum:0,type:"integer"}},type:"object",xml:{name:t}}}),l=(t,n,e="#/components/schemas/PaginationData")=>({[t]:{properties:{data:{items:n,type:"array",xml:{name:"data",wrapped:!0}},meta:{$ref:e}},type:"object",xml:{name:t}}});var m=(t,n,e,a)=>new i(e,Number(n),Number(t),...a);
|
|
10
10
|
|
|
11
11
|
exports.Paginator = i;
|
|
12
12
|
exports.createPaginationMetaSchemaObject = g;
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/paginator.ts","../src/swagger.ts","../src/index.ts"],"names":["qs","Paginator","totalNumber","perPage","currentPage","rows","values","url","page","qstring","start","end","urls","index","createPaginationMetaSchemaObject","name","createPaginationSchemaObject","items","metaReference","paginate","total"],"mappings":"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","sourcesContent":["import qs from \"qs\";\n\nimport type { PaginationMeta, PaginationResult, Paginator as IPaginator } from \"./types\";\n\ntype UrlsForRange = { url: string; page: number; isActive: boolean }[];\n\n/**\n * Simple paginator works with the data set provided by the standard\n * `offset` and `limit` based pagination.\n */\nexport default class Paginator<T = any> extends Array implements IPaginator<T> {\n private qs: { [key: string]: any } = {};\n\n private url: string = \"/\";\n\n private readonly rows: T[];\n\n /**\n * The first page is always 1\n */\n public readonly firstPage: number = 1;\n\n /**\n * Find if results set is empty or not\n */\n public readonly isEmpty: boolean;\n\n public constructor(private readonly totalNumber: number, public readonly perPage: number, public currentPage: number, ...rows: any[]) {\n super(...rows);\n\n this.totalNumber = Number(totalNumber);\n\n this.rows = rows;\n this.isEmpty = this.rows.length === 0;\n }\n\n /**\n * Find if there are total records or not. This is not same as\n * `isEmpty`.\n *\n * The `isEmpty` reports about the current set of results. However, `hasTotal`\n * reports about the total number of records, regardless of the current.\n */\n public get hasTotal(): boolean {\n return this.total > 0;\n }\n\n /**\n * Find if there are more pages to come\n */\n public get hasMorePages(): boolean {\n return this.lastPage > this.currentPage;\n }\n\n /**\n * Find if there are enough results to be paginated or not\n */\n public get hasPages(): boolean {\n return this.lastPage !== 1;\n }\n\n /**\n * The Last page number\n */\n public get lastPage(): number {\n return Math.max(Math.ceil(this.total / this.perPage), 1);\n }\n\n /**\n * Casting `total` to a number. Later, we can think of situations\n * to cast it to a bigint\n */\n public get total(): number {\n return Number(this.totalNumber);\n }\n\n /**\n * A reference to the result rows\n */\n public all(): T[] {\n return this.rows;\n }\n\n /**\n * Returns JSON meta data\n */\n public getMeta(): PaginationMeta {\n return {\n total: this.total,\n perPage: this.perPage,\n page: this.currentPage,\n lastPage: this.lastPage,\n firstPage: this.firstPage,\n firstPageUrl: this.getUrl(1),\n lastPageUrl: this.getUrl(this.lastPage),\n nextPageUrl: this.getNextPageUrl(),\n previousPageUrl: this.getPreviousPageUrl(),\n };\n }\n\n /**\n * Returns JSON representation of the paginated\n * data\n */\n public toJSON(): PaginationResult<T> {\n return {\n meta: this.getMeta(),\n data: this.all(),\n };\n }\n\n /**\n * Define query string to be appended to the pagination links\n */\n public queryString(values: { [key: string]: any }): this {\n this.qs = values;\n\n return this;\n }\n\n /**\n * Define base url for making the pagination links\n */\n public baseUrl(url: string): this {\n this.url = url;\n\n return this;\n }\n\n /**\n * Returns url for a given page. Doesn't validate the integrity of the\n * page\n */\n public getUrl(page: number): string {\n const qstring = qs.stringify({ ...this.qs, page: page < 1 ? 1 : page });\n\n return `${this.url}?${qstring}`;\n }\n\n /**\n * Returns url for the next page\n */\n public getNextPageUrl(): string | null {\n if (this.hasMorePages) {\n return this.getUrl(this.currentPage + 1);\n }\n\n return null;\n }\n\n /**\n * Returns URL for the previous page\n */\n public getPreviousPageUrl(): string | null {\n if (this.currentPage > 1) {\n return this.getUrl(this.currentPage - 1);\n }\n\n return null;\n }\n\n /**\n * Returns an array of urls under a given range\n */\n public getUrlsForRange(start: number, end: number): UrlsForRange {\n const urls: UrlsForRange = [];\n\n // eslint-disable-next-line no-plusplus\n for (let index = start; index <= end; index++) {\n urls.push({ url: this.getUrl(index), page: index, isActive: index === this.currentPage });\n }\n\n return urls;\n }\n}\n","import type { OpenAPIV3 } from \"openapi-types\";\n\nexport const createPaginationMetaSchemaObject = (name: string = \"PaginationData\"): { [key: string]: OpenAPIV3.SchemaObject } => {\n return {\n [name]: {\n type: \"object\",\n xml: {\n name,\n },\n properties: {\n total: {\n type: \"integer\",\n minimum: 0,\n description: \"Holds the value for the total number of rows in the database\",\n },\n perPage: {\n type: \"integer\",\n minimum: 0,\n description: \"Returns the value for the limit passed to the paginate method\",\n },\n page: {\n type: \"integer\",\n minimum: 1,\n description: \"Current page number\",\n },\n lastPage: {\n type: \"integer\",\n minimum: 0,\n description: \"Returns the value for the last page by taking the total of rows into account\",\n },\n firstPage: {\n type: \"integer\",\n minimum: 0,\n description: \"Returns the number for the first page. It is always 1\",\n },\n firstPageUrl: {\n type: \"string\",\n description: \"The URL for the first page\",\n },\n lastPageUrl: {\n type: \"string\",\n description: \"The URL for the last page\",\n },\n nextPageUrl: {\n type: \"string\",\n description: \"The URL for the next page\",\n },\n previousPageUrl: {\n type: \"string\",\n description: \"The URL for the previous page\",\n },\n },\n },\n };\n};\n\nexport const createPaginationSchemaObject = (\n name: string,\n items: OpenAPIV3.ReferenceObject | OpenAPIV3.SchemaObject,\n metaReference: string = \"#/components/schemas/PaginationData\",\n): { [key: string]: OpenAPIV3.SchemaObject } => {\n return {\n [name]: {\n type: \"object\",\n xml: {\n name,\n },\n properties: {\n data: {\n type: \"array\",\n xml: {\n name: \"data\",\n wrapped: true,\n },\n items,\n },\n meta: {\n $ref: metaReference,\n },\n },\n },\n };\n};\n","import Paginator from \"./paginator\";\nimport type { Paginator as PaginatorInterface } from \"./types\";\n\nexport type { Paginator as PaginatorInterface, PaginationResult, PaginationMeta } from \"./types.d\";\nexport { default as Paginator } from \"./paginator\";\n\n// eslint-disable-next-line max-len\nexport const paginate = <Result>(page: number, perPage: number, total: number, rows: Result[]): PaginatorInterface<Result> => new Paginator(total, Number(perPage), Number(page), ...rows);\n\nexport { createPaginationSchemaObject, createPaginationMetaSchemaObject } from \"./swagger\";\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/paginator.ts","../src/swagger.ts","../src/index.ts"],"names":["qs","Paginator","totalNumber","perPage","currentPage","rows","url","page","qstring","start","end","urls","index","values","createPaginationMetaSchemaObject","name","createPaginationSchemaObject","items","metaReference","paginate","total"],"mappings":"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","sourcesContent":["import qs from \"qs\";\n\nimport type { Paginator as IPaginator, PaginationMeta, PaginationResult } from \"./types\";\n\ntype UrlsForRange = { isActive: boolean; page: number; url: string }[];\n\n/**\n * Simple paginator works with the data set provided by the standard\n * `offset` and `limit` based pagination.\n */\nexport default class Paginator<T = unknown> extends Array<T> implements IPaginator<T> {\n private qs: Record<string, unknown> = {};\n\n private readonly rows: T[];\n\n private url = \"/\";\n\n /**\n * The first page is always 1\n */\n public readonly firstPage: number = 1;\n\n /**\n * Find if results set is empty or not\n */\n public readonly isEmpty: boolean;\n\n public constructor(\n private readonly totalNumber: number,\n public readonly perPage: number,\n public currentPage: number,\n ...rows: T[]\n ) {\n super(...rows);\n\n this.totalNumber = Number(totalNumber);\n\n this.rows = rows;\n this.isEmpty = this.rows.length === 0;\n }\n\n /**\n * A reference to the result rows\n */\n public all(): T[] {\n return this.rows;\n }\n\n /**\n * Define base url for making the pagination links\n */\n public baseUrl(url: string): this {\n this.url = url;\n\n return this;\n }\n\n /**\n * Returns JSON meta data\n */\n public getMeta(): PaginationMeta {\n return {\n firstPage: this.firstPage,\n firstPageUrl: this.getUrl(1),\n lastPage: this.lastPage,\n lastPageUrl: this.getUrl(this.lastPage),\n nextPageUrl: this.getNextPageUrl(),\n page: this.currentPage,\n perPage: this.perPage,\n previousPageUrl: this.getPreviousPageUrl(),\n total: this.total,\n };\n }\n\n /**\n * Returns url for the next page\n */\n public getNextPageUrl(): string | null {\n if (this.hasMorePages) {\n return this.getUrl(this.currentPage + 1);\n }\n\n return null;\n }\n\n /**\n * Returns URL for the previous page\n */\n public getPreviousPageUrl(): string | null {\n if (this.currentPage > 1) {\n return this.getUrl(this.currentPage - 1);\n }\n\n return null;\n }\n\n /**\n * Returns url for a given page. Doesn't validate the integrity of the\n * page\n */\n public getUrl(page: number): string {\n const qstring = qs.stringify({ ...this.qs, page: page < 1 ? 1 : page });\n\n return `${this.url}?${qstring}`;\n }\n\n /**\n * Returns an array of urls under a given range\n */\n public getUrlsForRange(start: number, end: number): UrlsForRange {\n const urls: UrlsForRange = [];\n\n // eslint-disable-next-line no-plusplus\n for (let index = start; index <= end; index++) {\n urls.push({ isActive: index === this.currentPage, page: index, url: this.getUrl(index) });\n }\n\n return urls;\n }\n\n /**\n * Find if there are more pages to come\n */\n public get hasMorePages(): boolean {\n return this.lastPage > this.currentPage;\n }\n\n /**\n * Find if there are enough results to be paginated or not\n */\n public get hasPages(): boolean {\n return this.lastPage !== 1;\n }\n\n /**\n * Find if there are total records or not. This is not same as\n * `isEmpty`.\n *\n * The `isEmpty` reports about the current set of results. However, `hasTotal`\n * reports about the total number of records, regardless of the current.\n */\n public get hasTotal(): boolean {\n return this.total > 0;\n }\n\n /**\n * The Last page number\n */\n public get lastPage(): number {\n return Math.max(Math.ceil(this.total / this.perPage), 1);\n }\n\n /**\n * Define query string to be appended to the pagination links\n */\n public queryString(values: Record<string, unknown>): this {\n this.qs = values;\n\n return this;\n }\n\n /**\n * Returns JSON representation of the paginated\n * data\n */\n public toJSON(): PaginationResult<T> {\n return {\n data: this.all(),\n meta: this.getMeta(),\n };\n }\n\n /**\n * Casting `total` to a number. Later, we can think of situations\n * to cast it to a bigint\n */\n public get total(): number {\n return Number(this.totalNumber);\n }\n}\n","import type { OpenAPIV3 } from \"openapi-types\";\n\nexport const createPaginationMetaSchemaObject = (name = \"PaginationData\"): Record<string, OpenAPIV3.SchemaObject> => {\n return {\n [name]: {\n properties: {\n firstPage: {\n description: \"Returns the number for the first page. It is always 1\",\n minimum: 0,\n type: \"integer\",\n },\n firstPageUrl: {\n description: \"The URL for the first page\",\n type: \"string\",\n },\n lastPage: {\n description: \"Returns the value for the last page by taking the total of rows into account\",\n minimum: 0,\n type: \"integer\",\n },\n lastPageUrl: {\n description: \"The URL for the last page\",\n type: \"string\",\n },\n nextPageUrl: {\n description: \"The URL for the next page\",\n type: \"string\",\n },\n page: {\n description: \"Current page number\",\n minimum: 1,\n type: \"integer\",\n },\n perPage: {\n description: \"Returns the value for the limit passed to the paginate method\",\n minimum: 0,\n type: \"integer\",\n },\n previousPageUrl: {\n description: \"The URL for the previous page\",\n type: \"string\",\n },\n total: {\n description: \"Holds the value for the total number of rows in the database\",\n minimum: 0,\n type: \"integer\",\n },\n },\n type: \"object\",\n xml: {\n name,\n },\n },\n };\n};\n\nexport const createPaginationSchemaObject = (\n name: string,\n items: OpenAPIV3.ReferenceObject | OpenAPIV3.SchemaObject,\n metaReference = \"#/components/schemas/PaginationData\",\n): Record<string, OpenAPIV3.SchemaObject> => {\n return {\n [name]: {\n properties: {\n data: {\n items,\n type: \"array\",\n xml: {\n name: \"data\",\n wrapped: true,\n },\n },\n meta: {\n $ref: metaReference,\n },\n },\n type: \"object\",\n xml: {\n name,\n },\n },\n };\n};\n","import Paginator from \"./paginator\";\nimport type { Paginator as PaginatorInterface } from \"./types\";\n\nexport { default as Paginator } from \"./paginator\";\nexport { createPaginationMetaSchemaObject, createPaginationSchemaObject } from \"./swagger\";\n\nexport const paginate = <Result>(page: number, perPage: number, total: number, rows: Result[]): PaginatorInterface<Result> =>\n new Paginator(total, Number(perPage), Number(page), ...rows);\n\nexport type { PaginationMeta, PaginationResult, Paginator as PaginatorInterface } from \"./types.d\";\n"]}
|
package/dist/index.mjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import o from 'qs';
|
|
2
2
|
|
|
3
|
-
var i=class extends Array{constructor(e,a,s,...r){super(...r);this.totalNumber=e;this.perPage=a;this.currentPage=s;this.qs={};this.url="/";this.firstPage=1;this.totalNumber=Number(e),this.rows=r,this.isEmpty=this.rows.length===0;}
|
|
3
|
+
var i=class extends Array{constructor(e,a,s,...r){super(...r);this.totalNumber=e;this.perPage=a;this.currentPage=s;this.qs={};this.url="/";this.firstPage=1;this.totalNumber=Number(e),this.rows=r,this.isEmpty=this.rows.length===0;}all(){return this.rows}baseUrl(e){return this.url=e,this}getMeta(){return {firstPage:this.firstPage,firstPageUrl:this.getUrl(1),lastPage:this.lastPage,lastPageUrl:this.getUrl(this.lastPage),nextPageUrl:this.getNextPageUrl(),page:this.currentPage,perPage:this.perPage,previousPageUrl:this.getPreviousPageUrl(),total:this.total}}getNextPageUrl(){return this.hasMorePages?this.getUrl(this.currentPage+1):null}getPreviousPageUrl(){return this.currentPage>1?this.getUrl(this.currentPage-1):null}getUrl(e){let a=o.stringify({...this.qs,page:e<1?1:e});return `${this.url}?${a}`}getUrlsForRange(e,a){let s=[];for(let r=e;r<=a;r++)s.push({isActive:r===this.currentPage,page:r,url:this.getUrl(r)});return s}get hasMorePages(){return this.lastPage>this.currentPage}get hasPages(){return this.lastPage!==1}get hasTotal(){return this.total>0}get lastPage(){return Math.max(Math.ceil(this.total/this.perPage),1)}queryString(e){return this.qs=e,this}toJSON(){return {data:this.all(),meta:this.getMeta()}}get total(){return Number(this.totalNumber)}};var g=(t="PaginationData")=>({[t]:{properties:{firstPage:{description:"Returns the number for the first page. It is always 1",minimum:0,type:"integer"},firstPageUrl:{description:"The URL for the first page",type:"string"},lastPage:{description:"Returns the value for the last page by taking the total of rows into account",minimum:0,type:"integer"},lastPageUrl:{description:"The URL for the last page",type:"string"},nextPageUrl:{description:"The URL for the next page",type:"string"},page:{description:"Current page number",minimum:1,type:"integer"},perPage:{description:"Returns the value for the limit passed to the paginate method",minimum:0,type:"integer"},previousPageUrl:{description:"The URL for the previous page",type:"string"},total:{description:"Holds the value for the total number of rows in the database",minimum:0,type:"integer"}},type:"object",xml:{name:t}}}),l=(t,n,e="#/components/schemas/PaginationData")=>({[t]:{properties:{data:{items:n,type:"array",xml:{name:"data",wrapped:!0}},meta:{$ref:e}},type:"object",xml:{name:t}}});var m=(t,n,e,a)=>new i(e,Number(n),Number(t),...a);
|
|
4
4
|
|
|
5
5
|
export { i as Paginator, g as createPaginationMetaSchemaObject, l as createPaginationSchemaObject, m as paginate };
|
|
6
6
|
//# sourceMappingURL=out.js.map
|
package/dist/index.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/paginator.ts","../src/swagger.ts","../src/index.ts"],"names":["qs","Paginator","totalNumber","perPage","currentPage","rows","values","url","page","qstring","start","end","urls","index","createPaginationMetaSchemaObject","name","createPaginationSchemaObject","items","metaReference","paginate","total"],"mappings":"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","sourcesContent":["import qs from \"qs\";\n\nimport type { PaginationMeta, PaginationResult, Paginator as IPaginator } from \"./types\";\n\ntype UrlsForRange = { url: string; page: number; isActive: boolean }[];\n\n/**\n * Simple paginator works with the data set provided by the standard\n * `offset` and `limit` based pagination.\n */\nexport default class Paginator<T = any> extends Array implements IPaginator<T> {\n private qs: { [key: string]: any } = {};\n\n private url: string = \"/\";\n\n private readonly rows: T[];\n\n /**\n * The first page is always 1\n */\n public readonly firstPage: number = 1;\n\n /**\n * Find if results set is empty or not\n */\n public readonly isEmpty: boolean;\n\n public constructor(private readonly totalNumber: number, public readonly perPage: number, public currentPage: number, ...rows: any[]) {\n super(...rows);\n\n this.totalNumber = Number(totalNumber);\n\n this.rows = rows;\n this.isEmpty = this.rows.length === 0;\n }\n\n /**\n * Find if there are total records or not. This is not same as\n * `isEmpty`.\n *\n * The `isEmpty` reports about the current set of results. However, `hasTotal`\n * reports about the total number of records, regardless of the current.\n */\n public get hasTotal(): boolean {\n return this.total > 0;\n }\n\n /**\n * Find if there are more pages to come\n */\n public get hasMorePages(): boolean {\n return this.lastPage > this.currentPage;\n }\n\n /**\n * Find if there are enough results to be paginated or not\n */\n public get hasPages(): boolean {\n return this.lastPage !== 1;\n }\n\n /**\n * The Last page number\n */\n public get lastPage(): number {\n return Math.max(Math.ceil(this.total / this.perPage), 1);\n }\n\n /**\n * Casting `total` to a number. Later, we can think of situations\n * to cast it to a bigint\n */\n public get total(): number {\n return Number(this.totalNumber);\n }\n\n /**\n * A reference to the result rows\n */\n public all(): T[] {\n return this.rows;\n }\n\n /**\n * Returns JSON meta data\n */\n public getMeta(): PaginationMeta {\n return {\n total: this.total,\n perPage: this.perPage,\n page: this.currentPage,\n lastPage: this.lastPage,\n firstPage: this.firstPage,\n firstPageUrl: this.getUrl(1),\n lastPageUrl: this.getUrl(this.lastPage),\n nextPageUrl: this.getNextPageUrl(),\n previousPageUrl: this.getPreviousPageUrl(),\n };\n }\n\n /**\n * Returns JSON representation of the paginated\n * data\n */\n public toJSON(): PaginationResult<T> {\n return {\n meta: this.getMeta(),\n data: this.all(),\n };\n }\n\n /**\n * Define query string to be appended to the pagination links\n */\n public queryString(values: { [key: string]: any }): this {\n this.qs = values;\n\n return this;\n }\n\n /**\n * Define base url for making the pagination links\n */\n public baseUrl(url: string): this {\n this.url = url;\n\n return this;\n }\n\n /**\n * Returns url for a given page. Doesn't validate the integrity of the\n * page\n */\n public getUrl(page: number): string {\n const qstring = qs.stringify({ ...this.qs, page: page < 1 ? 1 : page });\n\n return `${this.url}?${qstring}`;\n }\n\n /**\n * Returns url for the next page\n */\n public getNextPageUrl(): string | null {\n if (this.hasMorePages) {\n return this.getUrl(this.currentPage + 1);\n }\n\n return null;\n }\n\n /**\n * Returns URL for the previous page\n */\n public getPreviousPageUrl(): string | null {\n if (this.currentPage > 1) {\n return this.getUrl(this.currentPage - 1);\n }\n\n return null;\n }\n\n /**\n * Returns an array of urls under a given range\n */\n public getUrlsForRange(start: number, end: number): UrlsForRange {\n const urls: UrlsForRange = [];\n\n // eslint-disable-next-line no-plusplus\n for (let index = start; index <= end; index++) {\n urls.push({ url: this.getUrl(index), page: index, isActive: index === this.currentPage });\n }\n\n return urls;\n }\n}\n","import type { OpenAPIV3 } from \"openapi-types\";\n\nexport const createPaginationMetaSchemaObject = (name: string = \"PaginationData\"): { [key: string]: OpenAPIV3.SchemaObject } => {\n return {\n [name]: {\n type: \"object\",\n xml: {\n name,\n },\n properties: {\n total: {\n type: \"integer\",\n minimum: 0,\n description: \"Holds the value for the total number of rows in the database\",\n },\n perPage: {\n type: \"integer\",\n minimum: 0,\n description: \"Returns the value for the limit passed to the paginate method\",\n },\n page: {\n type: \"integer\",\n minimum: 1,\n description: \"Current page number\",\n },\n lastPage: {\n type: \"integer\",\n minimum: 0,\n description: \"Returns the value for the last page by taking the total of rows into account\",\n },\n firstPage: {\n type: \"integer\",\n minimum: 0,\n description: \"Returns the number for the first page. It is always 1\",\n },\n firstPageUrl: {\n type: \"string\",\n description: \"The URL for the first page\",\n },\n lastPageUrl: {\n type: \"string\",\n description: \"The URL for the last page\",\n },\n nextPageUrl: {\n type: \"string\",\n description: \"The URL for the next page\",\n },\n previousPageUrl: {\n type: \"string\",\n description: \"The URL for the previous page\",\n },\n },\n },\n };\n};\n\nexport const createPaginationSchemaObject = (\n name: string,\n items: OpenAPIV3.ReferenceObject | OpenAPIV3.SchemaObject,\n metaReference: string = \"#/components/schemas/PaginationData\",\n): { [key: string]: OpenAPIV3.SchemaObject } => {\n return {\n [name]: {\n type: \"object\",\n xml: {\n name,\n },\n properties: {\n data: {\n type: \"array\",\n xml: {\n name: \"data\",\n wrapped: true,\n },\n items,\n },\n meta: {\n $ref: metaReference,\n },\n },\n },\n };\n};\n","import Paginator from \"./paginator\";\nimport type { Paginator as PaginatorInterface } from \"./types\";\n\nexport type { Paginator as PaginatorInterface, PaginationResult, PaginationMeta } from \"./types.d\";\nexport { default as Paginator } from \"./paginator\";\n\n// eslint-disable-next-line max-len\nexport const paginate = <Result>(page: number, perPage: number, total: number, rows: Result[]): PaginatorInterface<Result> => new Paginator(total, Number(perPage), Number(page), ...rows);\n\nexport { createPaginationSchemaObject, createPaginationMetaSchemaObject } from \"./swagger\";\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/paginator.ts","../src/swagger.ts","../src/index.ts"],"names":["qs","Paginator","totalNumber","perPage","currentPage","rows","url","page","qstring","start","end","urls","index","values","createPaginationMetaSchemaObject","name","createPaginationSchemaObject","items","metaReference","paginate","total"],"mappings":"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","sourcesContent":["import qs from \"qs\";\n\nimport type { Paginator as IPaginator, PaginationMeta, PaginationResult } from \"./types\";\n\ntype UrlsForRange = { isActive: boolean; page: number; url: string }[];\n\n/**\n * Simple paginator works with the data set provided by the standard\n * `offset` and `limit` based pagination.\n */\nexport default class Paginator<T = unknown> extends Array<T> implements IPaginator<T> {\n private qs: Record<string, unknown> = {};\n\n private readonly rows: T[];\n\n private url = \"/\";\n\n /**\n * The first page is always 1\n */\n public readonly firstPage: number = 1;\n\n /**\n * Find if results set is empty or not\n */\n public readonly isEmpty: boolean;\n\n public constructor(\n private readonly totalNumber: number,\n public readonly perPage: number,\n public currentPage: number,\n ...rows: T[]\n ) {\n super(...rows);\n\n this.totalNumber = Number(totalNumber);\n\n this.rows = rows;\n this.isEmpty = this.rows.length === 0;\n }\n\n /**\n * A reference to the result rows\n */\n public all(): T[] {\n return this.rows;\n }\n\n /**\n * Define base url for making the pagination links\n */\n public baseUrl(url: string): this {\n this.url = url;\n\n return this;\n }\n\n /**\n * Returns JSON meta data\n */\n public getMeta(): PaginationMeta {\n return {\n firstPage: this.firstPage,\n firstPageUrl: this.getUrl(1),\n lastPage: this.lastPage,\n lastPageUrl: this.getUrl(this.lastPage),\n nextPageUrl: this.getNextPageUrl(),\n page: this.currentPage,\n perPage: this.perPage,\n previousPageUrl: this.getPreviousPageUrl(),\n total: this.total,\n };\n }\n\n /**\n * Returns url for the next page\n */\n public getNextPageUrl(): string | null {\n if (this.hasMorePages) {\n return this.getUrl(this.currentPage + 1);\n }\n\n return null;\n }\n\n /**\n * Returns URL for the previous page\n */\n public getPreviousPageUrl(): string | null {\n if (this.currentPage > 1) {\n return this.getUrl(this.currentPage - 1);\n }\n\n return null;\n }\n\n /**\n * Returns url for a given page. Doesn't validate the integrity of the\n * page\n */\n public getUrl(page: number): string {\n const qstring = qs.stringify({ ...this.qs, page: page < 1 ? 1 : page });\n\n return `${this.url}?${qstring}`;\n }\n\n /**\n * Returns an array of urls under a given range\n */\n public getUrlsForRange(start: number, end: number): UrlsForRange {\n const urls: UrlsForRange = [];\n\n // eslint-disable-next-line no-plusplus\n for (let index = start; index <= end; index++) {\n urls.push({ isActive: index === this.currentPage, page: index, url: this.getUrl(index) });\n }\n\n return urls;\n }\n\n /**\n * Find if there are more pages to come\n */\n public get hasMorePages(): boolean {\n return this.lastPage > this.currentPage;\n }\n\n /**\n * Find if there are enough results to be paginated or not\n */\n public get hasPages(): boolean {\n return this.lastPage !== 1;\n }\n\n /**\n * Find if there are total records or not. This is not same as\n * `isEmpty`.\n *\n * The `isEmpty` reports about the current set of results. However, `hasTotal`\n * reports about the total number of records, regardless of the current.\n */\n public get hasTotal(): boolean {\n return this.total > 0;\n }\n\n /**\n * The Last page number\n */\n public get lastPage(): number {\n return Math.max(Math.ceil(this.total / this.perPage), 1);\n }\n\n /**\n * Define query string to be appended to the pagination links\n */\n public queryString(values: Record<string, unknown>): this {\n this.qs = values;\n\n return this;\n }\n\n /**\n * Returns JSON representation of the paginated\n * data\n */\n public toJSON(): PaginationResult<T> {\n return {\n data: this.all(),\n meta: this.getMeta(),\n };\n }\n\n /**\n * Casting `total` to a number. Later, we can think of situations\n * to cast it to a bigint\n */\n public get total(): number {\n return Number(this.totalNumber);\n }\n}\n","import type { OpenAPIV3 } from \"openapi-types\";\n\nexport const createPaginationMetaSchemaObject = (name = \"PaginationData\"): Record<string, OpenAPIV3.SchemaObject> => {\n return {\n [name]: {\n properties: {\n firstPage: {\n description: \"Returns the number for the first page. It is always 1\",\n minimum: 0,\n type: \"integer\",\n },\n firstPageUrl: {\n description: \"The URL for the first page\",\n type: \"string\",\n },\n lastPage: {\n description: \"Returns the value for the last page by taking the total of rows into account\",\n minimum: 0,\n type: \"integer\",\n },\n lastPageUrl: {\n description: \"The URL for the last page\",\n type: \"string\",\n },\n nextPageUrl: {\n description: \"The URL for the next page\",\n type: \"string\",\n },\n page: {\n description: \"Current page number\",\n minimum: 1,\n type: \"integer\",\n },\n perPage: {\n description: \"Returns the value for the limit passed to the paginate method\",\n minimum: 0,\n type: \"integer\",\n },\n previousPageUrl: {\n description: \"The URL for the previous page\",\n type: \"string\",\n },\n total: {\n description: \"Holds the value for the total number of rows in the database\",\n minimum: 0,\n type: \"integer\",\n },\n },\n type: \"object\",\n xml: {\n name,\n },\n },\n };\n};\n\nexport const createPaginationSchemaObject = (\n name: string,\n items: OpenAPIV3.ReferenceObject | OpenAPIV3.SchemaObject,\n metaReference = \"#/components/schemas/PaginationData\",\n): Record<string, OpenAPIV3.SchemaObject> => {\n return {\n [name]: {\n properties: {\n data: {\n items,\n type: \"array\",\n xml: {\n name: \"data\",\n wrapped: true,\n },\n },\n meta: {\n $ref: metaReference,\n },\n },\n type: \"object\",\n xml: {\n name,\n },\n },\n };\n};\n","import Paginator from \"./paginator\";\nimport type { Paginator as PaginatorInterface } from \"./types\";\n\nexport { default as Paginator } from \"./paginator\";\nexport { createPaginationMetaSchemaObject, createPaginationSchemaObject } from \"./swagger\";\n\nexport const paginate = <Result>(page: number, perPage: number, total: number, rows: Result[]): PaginatorInterface<Result> =>\n new Paginator(total, Number(perPage), Number(page), ...rows);\n\nexport type { PaginationMeta, PaginationResult, Paginator as PaginatorInterface } from \"./types.d\";\n"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@visulima/pagination",
|
|
3
|
-
"version": "2.0.
|
|
3
|
+
"version": "2.0.6",
|
|
4
4
|
"description": "Simple Pagination for Node.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"anolilab",
|
|
@@ -54,8 +54,11 @@
|
|
|
54
54
|
"clean": "rimraf node_modules dist .eslintcache",
|
|
55
55
|
"coverage": "vitest run --coverage",
|
|
56
56
|
"dev": "pnpm run build --watch",
|
|
57
|
-
"lint:eslint": "
|
|
57
|
+
"lint:eslint": "eslint . --ext js,jsx,ts,tsx --max-warnings=0 --config .eslintrc.js --cache --cache-strategy content .",
|
|
58
58
|
"lint:eslint:fix": "pnpm run lint:eslint --fix",
|
|
59
|
+
"lint:prettier": "prettier --config=.prettierrc.js --check .",
|
|
60
|
+
"lint:prettier:fix": "prettier --config=.prettierrc.js --write .",
|
|
61
|
+
"lint:types": "tsc --noEmit",
|
|
59
62
|
"test": "vitest run",
|
|
60
63
|
"test:watch": "vitest"
|
|
61
64
|
},
|
|
@@ -63,45 +66,26 @@
|
|
|
63
66
|
"qs": "^6.11.2"
|
|
64
67
|
},
|
|
65
68
|
"devDependencies": {
|
|
66
|
-
"@anolilab/eslint-config": "^
|
|
67
|
-
"@anolilab/
|
|
69
|
+
"@anolilab/eslint-config": "^11.0.2",
|
|
70
|
+
"@anolilab/prettier-config": "^5.0.1",
|
|
71
|
+
"@anolilab/semantic-release-preset": "^6.0.2",
|
|
68
72
|
"@rushstack/eslint-plugin-security": "^0.6.0",
|
|
69
73
|
"@types/micromatch": "^4.0.2",
|
|
70
|
-
"@types/node": "18.16.
|
|
74
|
+
"@types/node": "18.16.18",
|
|
71
75
|
"@types/qs": "^6.9.7",
|
|
72
|
-
"@
|
|
73
|
-
"@typescript-eslint/parser": "^5.59.8",
|
|
74
|
-
"@vitest/coverage-c8": "^0.31.1",
|
|
76
|
+
"@vitest/coverage-v8": "^0.33.0",
|
|
75
77
|
"cross-env": "^7.0.3",
|
|
76
|
-
"eslint": "^8.
|
|
77
|
-
"eslint-plugin-
|
|
78
|
-
"eslint-plugin-
|
|
79
|
-
"eslint-plugin-
|
|
80
|
-
"eslint-plugin-json": "^3.1.0",
|
|
81
|
-
"eslint-plugin-jsonc": "^2.8.0",
|
|
82
|
-
"eslint-plugin-jsx-a11y": "^6.7.1",
|
|
83
|
-
"eslint-plugin-markdown": "^3.0.0",
|
|
84
|
-
"eslint-plugin-material-ui": "^1.0.1",
|
|
85
|
-
"eslint-plugin-no-loops": "^0.3.0",
|
|
86
|
-
"eslint-plugin-no-secrets": "^0.8.9",
|
|
87
|
-
"eslint-plugin-node": "^11.1.0",
|
|
88
|
-
"eslint-plugin-optimize-regex": "^1.2.1",
|
|
89
|
-
"eslint-plugin-promise": "^6.1.1",
|
|
90
|
-
"eslint-plugin-react": "7.32.2",
|
|
91
|
-
"eslint-plugin-react-hooks": "4.6.0",
|
|
92
|
-
"eslint-plugin-simple-import-sort": "^10.0.0",
|
|
93
|
-
"eslint-plugin-sort-keys-fix": "^1.1.2",
|
|
94
|
-
"eslint-plugin-testing-library": "^5.11.0",
|
|
95
|
-
"eslint-plugin-unicorn": "^47.0.0",
|
|
96
|
-
"eslint-plugin-you-dont-need-lodash-underscore": "^6.12.0",
|
|
97
|
-
"eslint-plugin-you-dont-need-momentjs": "^1.6.0",
|
|
78
|
+
"eslint": "^8.46.0",
|
|
79
|
+
"eslint-plugin-etc": "^2.0.3",
|
|
80
|
+
"eslint-plugin-mdx": "^2.1.0",
|
|
81
|
+
"eslint-plugin-vitest": "^0.2.8",
|
|
98
82
|
"openapi-types": "^12.1.3",
|
|
99
|
-
"prettier": "^
|
|
83
|
+
"prettier": "^3.0.0",
|
|
100
84
|
"rimraf": "^5.0.1",
|
|
101
|
-
"semantic-release": "^21.0.
|
|
102
|
-
"tsup": "^
|
|
103
|
-
"typescript": "^5.
|
|
104
|
-
"vitest": "^0.
|
|
85
|
+
"semantic-release": "^21.0.7",
|
|
86
|
+
"tsup": "^7.1.0",
|
|
87
|
+
"typescript": "^5.1.6",
|
|
88
|
+
"vitest": "^0.33.0"
|
|
105
89
|
},
|
|
106
90
|
"engines": {
|
|
107
91
|
"node": ">=16.18.0 <=20.*"
|
|
@@ -109,5 +93,16 @@
|
|
|
109
93
|
"publishConfig": {
|
|
110
94
|
"access": "public",
|
|
111
95
|
"provenance": true
|
|
96
|
+
},
|
|
97
|
+
"anolilab": {
|
|
98
|
+
"eslint-config": {
|
|
99
|
+
"plugin": {
|
|
100
|
+
"tsdoc": false
|
|
101
|
+
},
|
|
102
|
+
"warn_on_unsupported_typescript_version": false,
|
|
103
|
+
"info_on_disabling_jsx_react_rule": false,
|
|
104
|
+
"info_on_disabling_prettier_conflict_rule": false,
|
|
105
|
+
"info_on_disabling_jsonc_sort_keys_rule": false
|
|
106
|
+
}
|
|
112
107
|
}
|
|
113
108
|
}
|