@genesislcap/foundation-comms 14.323.0 → 14.324.1-alpha-1049010.0

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.
Files changed (37) hide show
  1. package/dist/dts/connect/message.d.ts +3 -1
  2. package/dist/dts/connect/message.d.ts.map +1 -1
  3. package/dist/dts/datasource/datasource.config.d.ts +1 -0
  4. package/dist/dts/datasource/datasource.config.d.ts.map +1 -1
  5. package/dist/dts/datasource/datasource.d.ts +31 -1
  6. package/dist/dts/datasource/datasource.d.ts.map +1 -1
  7. package/dist/dts/datasource/datasource.types.d.ts +21 -16
  8. package/dist/dts/datasource/datasource.types.d.ts.map +1 -1
  9. package/dist/dts/metadata/metadata.types.d.ts +4 -2
  10. package/dist/dts/metadata/metadata.types.d.ts.map +1 -1
  11. package/dist/dts/testing/mocks/datasource/datasource.d.ts +5 -1
  12. package/dist/dts/testing/mocks/datasource/datasource.d.ts.map +1 -1
  13. package/dist/esm/datasource/datasource.config.js +1 -0
  14. package/dist/esm/datasource/datasource.js +56 -15
  15. package/dist/esm/testing/mocks/datasource/datasource.js +11 -0
  16. package/dist/foundation-comms.api.json +255 -6
  17. package/dist/foundation-comms.d.ts +64 -20
  18. package/docs/api/foundation-comms.datasource.dataserveronlyparams.md +13 -0
  19. package/docs/api/foundation-comms.datasource.md +49 -0
  20. package/docs/api/foundation-comms.datasource.requestonlyparams.md +13 -0
  21. package/docs/api/foundation-comms.datasource.updateloadmorecount.md +54 -0
  22. package/docs/api/foundation-comms.datasourcedefaults.default_req_rep_offset.md +11 -0
  23. package/docs/api/foundation-comms.datasourcedefaults.md +21 -0
  24. package/docs/api/foundation-comms.datasourcemetadata.criteriaonlyrequest.md +11 -0
  25. package/docs/api/foundation-comms.datasourcemetadata.md +21 -0
  26. package/docs/api/foundation-comms.datasourcemetadata.startstreamrequired.md +1 -1
  27. package/docs/api/foundation-comms.datasourceoptions.md +19 -0
  28. package/docs/api/foundation-comms.datasourceoptions.offset.md +18 -0
  29. package/docs/api/foundation-comms.datasourceoptions.orderby.md +0 -5
  30. package/docs/api/foundation-comms.defaultdatasource.criteriaonlyrequest.md +12 -0
  31. package/docs/api/foundation-comms.defaultdatasource.loadmorecount.md +13 -0
  32. package/docs/api/foundation-comms.defaultdatasource.md +37 -0
  33. package/docs/api/foundation-comms.metadata.md +1 -0
  34. package/docs/api/foundation-comms.requestdetailsparam.md +3 -1
  35. package/docs/api/foundation-comms.requestserverresult.md +3 -2
  36. package/docs/api-report.md.api.md +29 -4
  37. package/package.json +13 -13
@@ -0,0 +1,54 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@genesislcap/foundation-comms](./foundation-comms.md) &gt; [Datasource](./foundation-comms.datasource.md) &gt; [updateLoadMoreCount](./foundation-comms.datasource.updateloadmorecount.md)
4
+
5
+ ## Datasource.updateLoadMoreCount() method
6
+
7
+ Updates the load more (how many times user manually requested more data) count for the datasource.
8
+
9
+ **Signature:**
10
+
11
+ ```typescript
12
+ updateLoadMoreCount(count: number): void;
13
+ ```
14
+
15
+ ## Parameters
16
+
17
+ <table><thead><tr><th>
18
+
19
+ Parameter
20
+
21
+
22
+ </th><th>
23
+
24
+ Type
25
+
26
+
27
+ </th><th>
28
+
29
+ Description
30
+
31
+
32
+ </th></tr></thead>
33
+ <tbody><tr><td>
34
+
35
+ count
36
+
37
+
38
+ </td><td>
39
+
40
+ number
41
+
42
+
43
+ </td><td>
44
+
45
+ The new load more count.
46
+
47
+
48
+ </td></tr>
49
+ </tbody></table>
50
+
51
+ **Returns:**
52
+
53
+ void
54
+
@@ -0,0 +1,11 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@genesislcap/foundation-comms](./foundation-comms.md) &gt; [DatasourceDefaults](./foundation-comms.datasourcedefaults.md) &gt; [DEFAULT\_REQ\_REP\_OFFSET](./foundation-comms.datasourcedefaults.default_req_rep_offset.md)
4
+
5
+ ## DatasourceDefaults.DEFAULT\_REQ\_REP\_OFFSET property
6
+
7
+ **Signature:**
8
+
9
+ ```typescript
10
+ static readonly DEFAULT_REQ_REP_OFFSET = 0;
11
+ ```
@@ -76,6 +76,27 @@ Description
76
76
  </td><td>
77
77
 
78
78
 
79
+ </td></tr>
80
+ <tr><td>
81
+
82
+ [DEFAULT\_REQ\_REP\_OFFSET](./foundation-comms.datasourcedefaults.default_req_rep_offset.md)
83
+
84
+
85
+ </td><td>
86
+
87
+ `static`
88
+
89
+ `readonly`
90
+
91
+
92
+ </td><td>
93
+
94
+ (not declared)
95
+
96
+
97
+ </td><td>
98
+
99
+
79
100
  </td></tr>
80
101
  <tr><td>
81
102
 
@@ -0,0 +1,11 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@genesislcap/foundation-comms](./foundation-comms.md) &gt; [DatasourceMetadata](./foundation-comms.datasourcemetadata.md) &gt; [criteriaOnlyRequest](./foundation-comms.datasourcemetadata.criteriaonlyrequest.md)
4
+
5
+ ## DatasourceMetadata.criteriaOnlyRequest property
6
+
7
+ **Signature:**
8
+
9
+ ```typescript
10
+ readonly criteriaOnlyRequest: boolean;
11
+ ```
@@ -53,6 +53,25 @@ Description
53
53
  </td><td>
54
54
 
55
55
 
56
+ </td></tr>
57
+ <tr><td>
58
+
59
+ [criteriaOnlyRequest](./foundation-comms.datasourcemetadata.criteriaonlyrequest.md)
60
+
61
+
62
+ </td><td>
63
+
64
+ `readonly`
65
+
66
+
67
+ </td><td>
68
+
69
+ boolean
70
+
71
+
72
+ </td><td>
73
+
74
+
56
75
  </td></tr>
57
76
  <tr><td>
58
77
 
@@ -154,6 +173,8 @@ boolean
154
173
 
155
174
  </td><td>
156
175
 
176
+ `readonly`
177
+
157
178
 
158
179
  </td><td>
159
180
 
@@ -7,5 +7,5 @@
7
7
  **Signature:**
8
8
 
9
9
  ```typescript
10
- startStreamRequired: boolean;
10
+ readonly startStreamRequired: boolean;
11
11
  ```
@@ -167,6 +167,25 @@ boolean
167
167
  _(Optional)_ Defines the behaviour of the client view when new rows are received in real time.
168
168
 
169
169
 
170
+ </td></tr>
171
+ <tr><td>
172
+
173
+ [offset?](./foundation-comms.datasourceoptions.offset.md)
174
+
175
+
176
+ </td><td>
177
+
178
+
179
+ </td><td>
180
+
181
+ number
182
+
183
+
184
+ </td><td>
185
+
186
+ _(Optional)_ The offset to use when fetching data.
187
+
188
+
170
189
  </td></tr>
171
190
  <tr><td>
172
191
 
@@ -0,0 +1,18 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@genesislcap/foundation-comms](./foundation-comms.md) &gt; [DatasourceOptions](./foundation-comms.datasourceoptions.md) &gt; [offset](./foundation-comms.datasourceoptions.offset.md)
4
+
5
+ ## DatasourceOptions.offset property
6
+
7
+ The offset to use when fetching data.
8
+
9
+ **Signature:**
10
+
11
+ ```typescript
12
+ offset?: number;
13
+ ```
14
+
15
+ ## Remarks
16
+
17
+ relates to MAX\_ROWS.
18
+
@@ -11,8 +11,3 @@ The field to use for sorting the data.
11
11
  ```typescript
12
12
  orderBy?: string;
13
13
  ```
14
-
15
- ## Remarks
16
-
17
- Only works with DATASERVER.
18
-
@@ -0,0 +1,12 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@genesislcap/foundation-comms](./foundation-comms.md) &gt; [DefaultDatasource](./foundation-comms.defaultdatasource.md) &gt; [criteriaOnlyRequest](./foundation-comms.defaultdatasource.criteriaonlyrequest.md)
4
+
5
+ ## DefaultDatasource.criteriaOnlyRequest property
6
+
7
+
8
+ **Signature:**
9
+
10
+ ```typescript
11
+ criteriaOnlyRequest: boolean;
12
+ ```
@@ -0,0 +1,13 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@genesislcap/foundation-comms](./foundation-comms.md) &gt; [DefaultDatasource](./foundation-comms.defaultdatasource.md) &gt; [loadMoreCount](./foundation-comms.defaultdatasource.loadmorecount.md)
4
+
5
+ ## DefaultDatasource.loadMoreCount property
6
+
7
+ Track load more count for RequestServer temporary MAX\_ROWS calculation
8
+
9
+ **Signature:**
10
+
11
+ ```typescript
12
+ loadMoreCount: number;
13
+ ```
@@ -163,6 +163,24 @@ Description
163
163
  </td><td>
164
164
 
165
165
 
166
+ </td></tr>
167
+ <tr><td>
168
+
169
+ [criteriaOnlyRequest](./foundation-comms.defaultdatasource.criteriaonlyrequest.md)
170
+
171
+
172
+ </td><td>
173
+
174
+
175
+ </td><td>
176
+
177
+ boolean
178
+
179
+
180
+ </td><td>
181
+
182
+
183
+
166
184
  </td></tr>
167
185
  <tr><td>
168
186
 
@@ -238,6 +256,25 @@ boolean
238
256
  Indicates whether the datasource has been initialized.
239
257
 
240
258
 
259
+ </td></tr>
260
+ <tr><td>
261
+
262
+ [loadMoreCount](./foundation-comms.defaultdatasource.loadmorecount.md)
263
+
264
+
265
+ </td><td>
266
+
267
+
268
+ </td><td>
269
+
270
+ number
271
+
272
+
273
+ </td><td>
274
+
275
+ Track load more count for RequestServer temporary MAX\_ROWS calculation
276
+
277
+
241
278
  </td></tr>
242
279
  <tr><td>
243
280
 
@@ -20,6 +20,7 @@ export type Metadata = {
20
20
  TYPE?: string;
21
21
  INDEXES?: IndexDetail[];
22
22
  ERROR?: string;
23
+ CRITERIA_ONLY_REQUEST?: boolean;
23
24
  };
24
25
  ```
25
26
  **References:** [MetadataDetail](./foundation-comms.metadatadetail.md)<!-- -->, [ReplyDetail](./foundation-comms.replydetail.md)<!-- -->, [IndexDetail](./foundation-comms.indexdetail.md)
@@ -9,8 +9,10 @@
9
9
 
10
10
  ```typescript
11
11
  export type RequestDetailsParam = {
12
- MAX_ROWS?: number;
13
12
  CRITERIA_MATCH?: string;
13
+ MAX_ROWS?: number;
14
+ OFFSET?: number;
15
+ ORDER_BY?: string;
14
16
  VIEW_NUMBER?: number;
15
17
  };
16
18
  ```
@@ -10,12 +10,13 @@ Raw result from a REQUEST\_SERVER data fetch.
10
10
 
11
11
  ```typescript
12
12
  export type RequestServerResult = {
13
- SOURCE_REF?: string;
14
- REPLY: any[];
15
13
  MESSAGE_TYPE?: string;
16
14
  MORE_ROWS?: boolean;
15
+ NEXT_OFFSET?: number;
17
16
  NEXT_VIEW?: number;
18
17
  PARAMETRIC_TYPE?: string;
18
+ REPLY: any[];
19
+ SOURCE_REF?: string;
19
20
  ROWS_COUNT?: number;
20
21
  SEQUENCE_ID?: number;
21
22
  };
@@ -468,6 +468,7 @@ export interface Datasource extends DatasourceMetadata {
468
468
  clearFilter?(name: string): Promise<void>;
469
469
  createItem?(data: any): Promise<string>;
470
470
  dataHandler?(data: Array<any>): Array<any>;
471
+ dataserverOnlyParams: DataserverParams;
471
472
  deleteItem?(itemId: string): Promise<void>;
472
473
  destroy(): void;
473
474
  dropView?(view: Dataview): void;
@@ -475,6 +476,7 @@ export interface Datasource extends DatasourceMetadata {
475
476
  init(options: DatasourceOptions, fetchMeta?: boolean, startStream?: boolean): Promise<boolean>;
476
477
  initialized: boolean;
477
478
  readOnly: boolean;
479
+ requestOnlyParams: RequestParams;
478
480
  resourceType: ResourceType;
479
481
  setFilter?(name: string, value: any, type?: string): Promise<void>;
480
482
  snapshot(overrideParams?: any): Promise<Message>;
@@ -485,6 +487,7 @@ export interface Datasource extends DatasourceMetadata {
485
487
  stream: SocketObservable<FilteredDataServerResult | RequestServerResult>;
486
488
  updateData?(data: Array<any>): Promise<void>;
487
489
  updateItem?(itemId: string, data: any): Promise<void>;
490
+ updateLoadMoreCount(count: number): void;
488
491
  // @deprecated
489
492
  validResourceName(resourceName: string): boolean;
490
493
  }
@@ -515,6 +518,8 @@ export class DatasourceDefaults {
515
518
  // (undocumented)
516
519
  static readonly DEFAULT_PAGINATION_PAGE_SIZE = 25;
517
520
  // (undocumented)
521
+ static readonly DEFAULT_REQ_REP_OFFSET = 0;
522
+ // (undocumented)
518
523
  static readonly MAX_ROWS_250 = 250;
519
524
  // (undocumented)
520
525
  static readonly MAX_VIEW_1000 = 1000;
@@ -893,6 +898,8 @@ export interface DatasourceMetadata {
893
898
  // (undocumented)
894
899
  readonly availableIndexes: IndexDetail[];
895
900
  // (undocumented)
901
+ readonly criteriaOnlyRequest: boolean;
902
+ // (undocumented)
896
903
  readonly customRequestFields: MetadataDetail[];
897
904
  // (undocumented)
898
905
  fetchMetadataRequired: boolean;
@@ -903,7 +910,7 @@ export interface DatasourceMetadata {
903
910
  // (undocumented)
904
911
  readonly requestFields: MetadataDetail[];
905
912
  // (undocumented)
906
- startStreamRequired: boolean;
913
+ readonly startStreamRequired: boolean;
907
914
  }
908
915
 
909
916
  // Warning: (ae-internal-missing-underscore) The name "DatasourceMock" should be prefixed with an underscore because the declaration is marked as @internal
@@ -919,10 +926,14 @@ export class DatasourceMock implements Datasource {
919
926
  // (undocumented)
920
927
  createItem?(data: any): Promise<string>;
921
928
  // (undocumented)
929
+ criteriaOnlyRequest: boolean;
930
+ // (undocumented)
922
931
  customRequestFields: MetadataDetail[];
923
932
  // (undocumented)
924
933
  dataHandler?(data: any[]): any[];
925
934
  // (undocumented)
935
+ get dataserverOnlyParams(): DataserverParams;
936
+ // (undocumented)
926
937
  deinit(): void;
927
938
  // (undocumented)
928
939
  deleteItem?(itemId: string): Promise<void>;
@@ -949,6 +960,8 @@ export class DatasourceMock implements Datasource {
949
960
  // (undocumented)
950
961
  requestFields: MetadataDetail[];
951
962
  // (undocumented)
963
+ get requestOnlyParams(): RequestParams;
964
+ // (undocumented)
952
965
  resourceType: ResourceType;
953
966
  // (undocumented)
954
967
  setFilter?(name: string, value: any, type?: string): Promise<void>;
@@ -975,6 +988,8 @@ export class DatasourceMock implements Datasource {
975
988
  // (undocumented)
976
989
  updateItem?(itemId: string, data: any): Promise<void>;
977
990
  // (undocumented)
991
+ updateLoadMoreCount(count: number): void;
992
+ // (undocumented)
978
993
  validResourceName(resourceName: string): boolean;
979
994
  }
980
995
 
@@ -987,6 +1002,7 @@ export interface DatasourceOptions {
987
1002
  maxRows?: number;
988
1003
  maxView?: number;
989
1004
  movingView?: boolean;
1005
+ offset?: number;
990
1006
  orderBy?: string;
991
1007
  pollingInterval?: number;
992
1008
  pollTriggerEvents?: string[];
@@ -1238,6 +1254,8 @@ export class DefaultDatasource implements Datasource {
1238
1254
  // (undocumented)
1239
1255
  protected connectEvents: ConnectEvents;
1240
1256
  // (undocumented)
1257
+ criteriaOnlyRequest: boolean;
1258
+ // (undocumented)
1241
1259
  customRequestFields: MetadataDetail[];
1242
1260
  // @internal (undocumented)
1243
1261
  get dataserverOnlyParams(): DataserverParams;
@@ -1257,6 +1275,7 @@ export class DefaultDatasource implements Datasource {
1257
1275
  //
1258
1276
  // (undocumented)
1259
1277
  get initialized(): boolean;
1278
+ loadMoreCount: number;
1260
1279
  // @internal (undocumented)
1261
1280
  protected normaliseStatus(status: Partial<DatasourceStatus>): DatasourceStatus;
1262
1281
  // (undocumented)
@@ -1289,6 +1308,8 @@ export class DefaultDatasource implements Datasource {
1289
1308
  status: DatasourceStatus;
1290
1309
  // (undocumented)
1291
1310
  stream: SocketObservable<FilteredDataServerResult | RequestServerResult>;
1311
+ // @internal
1312
+ updateLoadMoreCount(count: number): void;
1292
1313
  // @deprecated (undocumented)
1293
1314
  validResourceName(resourceName: string): boolean;
1294
1315
  }
@@ -2296,6 +2317,7 @@ export type Metadata = {
2296
2317
  TYPE?: string;
2297
2318
  INDEXES?: IndexDetail[];
2298
2319
  ERROR?: string;
2320
+ CRITERIA_ONLY_REQUEST?: boolean;
2299
2321
  };
2300
2322
 
2301
2323
  // @public
@@ -2455,8 +2477,10 @@ export type ReplyDetail = {
2455
2477
 
2456
2478
  // @public (undocumented)
2457
2479
  export type RequestDetailsParam = {
2458
- MAX_ROWS?: number;
2459
2480
  CRITERIA_MATCH?: string;
2481
+ MAX_ROWS?: number;
2482
+ OFFSET?: number;
2483
+ ORDER_BY?: string;
2460
2484
  VIEW_NUMBER?: number;
2461
2485
  };
2462
2486
 
@@ -2469,12 +2493,13 @@ export type RequestParams = {
2469
2493
 
2470
2494
  // @public
2471
2495
  export type RequestServerResult = {
2472
- SOURCE_REF?: string;
2473
- REPLY: any[];
2474
2496
  MESSAGE_TYPE?: string;
2475
2497
  MORE_ROWS?: boolean;
2498
+ NEXT_OFFSET?: number;
2476
2499
  NEXT_VIEW?: number;
2477
2500
  PARAMETRIC_TYPE?: string;
2501
+ REPLY: any[];
2502
+ SOURCE_REF?: string;
2478
2503
  ROWS_COUNT?: number;
2479
2504
  SEQUENCE_ID?: number;
2480
2505
  };
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@genesislcap/foundation-comms",
3
3
  "description": "Genesis Foundation UI Comms",
4
- "version": "14.323.0",
4
+ "version": "14.324.1-alpha-1049010.0",
5
5
  "sideEffects": false,
6
6
  "license": "SEE LICENSE IN license.txt",
7
7
  "main": "dist/esm/index.js",
@@ -75,23 +75,23 @@
75
75
  }
76
76
  },
77
77
  "devDependencies": {
78
- "@genesislcap/foundation-testing": "14.323.0",
79
- "@genesislcap/genx": "14.323.0",
80
- "@genesislcap/rollup-builder": "14.323.0",
81
- "@genesislcap/ts-builder": "14.323.0",
82
- "@genesislcap/uvu-playwright-builder": "14.323.0",
83
- "@genesislcap/vite-builder": "14.323.0",
84
- "@genesislcap/webpack-builder": "14.323.0",
78
+ "@genesislcap/foundation-testing": "14.324.1-alpha-1049010.0",
79
+ "@genesislcap/genx": "14.324.1-alpha-1049010.0",
80
+ "@genesislcap/rollup-builder": "14.324.1-alpha-1049010.0",
81
+ "@genesislcap/ts-builder": "14.324.1-alpha-1049010.0",
82
+ "@genesislcap/uvu-playwright-builder": "14.324.1-alpha-1049010.0",
83
+ "@genesislcap/vite-builder": "14.324.1-alpha-1049010.0",
84
+ "@genesislcap/webpack-builder": "14.324.1-alpha-1049010.0",
85
85
  "@types/js-cookie": "^3.0.2",
86
86
  "@types/json-schema": "^7.0.11",
87
87
  "@types/webappsec-credential-management": "^0.6.2",
88
88
  "sinon": "^17.0.1"
89
89
  },
90
90
  "dependencies": {
91
- "@genesislcap/foundation-broadcast-channel": "14.323.0",
92
- "@genesislcap/foundation-logger": "14.323.0",
93
- "@genesislcap/foundation-user": "14.323.0",
94
- "@genesislcap/foundation-utils": "14.323.0",
91
+ "@genesislcap/foundation-broadcast-channel": "14.324.1-alpha-1049010.0",
92
+ "@genesislcap/foundation-logger": "14.324.1-alpha-1049010.0",
93
+ "@genesislcap/foundation-user": "14.324.1-alpha-1049010.0",
94
+ "@genesislcap/foundation-utils": "14.324.1-alpha-1049010.0",
95
95
  "@microsoft/fast-element": "1.14.0",
96
96
  "@microsoft/fast-foundation": "2.49.6",
97
97
  "analytics": "0.8.16",
@@ -110,5 +110,5 @@
110
110
  "publishConfig": {
111
111
  "access": "public"
112
112
  },
113
- "gitHead": "08b2db7efcbbcc6498844c18a39c03187afa7cca"
113
+ "gitHead": "240ba3390b0cb59275850cc25e2a3604a852da5e"
114
114
  }