Skip to content

Commit 0c768b4

Browse files
author
Brandon Scott
committed
0.2.3
1 parent ca11227 commit 0c768b4

28 files changed

Lines changed: 531 additions & 448 deletions

docs/README.md

Lines changed: 332 additions & 323 deletions
Large diffs are not rendered by default.

docs/classes/do.md

Lines changed: 45 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -32,15 +32,20 @@ the Do.catch method takes a callback where the parameters are:
3232
* [catch](do.md#catch)
3333
* [finally](do.md#finally)
3434
* [getAwaiter](do.md#getawaiter)
35+
* [configure](do.md#static-configure)
3536
* [try](do.md#static-try)
3637

38+
### Object literals
39+
40+
* [config](do.md#static-private-config)
41+
3742
## Constructors
3843

3944
### `Private` constructor
4045

4146
\+ **new Do**(`workload`: [AsyncWorkload](../README.md#asyncworkload)‹TReturnVal›): *[Do](do.md)*
4247

43-
*Defined in [src/utilities/do-try.ts:20](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/utilities/do-try.ts#L20)*
48+
*Defined in [src/utilities/do-try.ts:23](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L23)*
4449

4550
**Parameters:**
4651

@@ -56,15 +61,15 @@ Name | Type |
5661

5762
**promise**: *Promise‹TReturnVal›*
5863

59-
*Defined in [src/utilities/do-try.ts:20](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/utilities/do-try.ts#L20)*
64+
*Defined in [src/utilities/do-try.ts:19](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L19)*
6065

6166
## Methods
6267

6368
### catch
6469

65-
**catch**(`errorHandler`: [CatchHandler](../README.md#catchhandler)‹TResourceType›): *[Do](do.md)‹TResourceType, TReturnVal›*
70+
**catch**(`errorHandler`: [CatchResultHandler](../README.md#catchresulthandler)‹TResourceType›): *[Do](do.md)‹TResourceType, TReturnVal›*
6671

67-
*Defined in [src/utilities/do-try.ts:35](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/utilities/do-try.ts#L35)*
72+
*Defined in [src/utilities/do-try.ts:46](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L46)*
6873

6974
Handle errors from the workload.
7075
If errors are in the shape of a {ResultRecord},
@@ -76,7 +81,7 @@ you'll get an {any} as the second parameter.
7681

7782
Name | Type | Description |
7883
------ | ------ | ------ |
79-
`errorHandler` | [CatchHandler](../README.md#catchhandler)‹TResourceType› | handle errors, either as a {ResultRecord} or {any} |
84+
`errorHandler` | [CatchResultHandler](../README.md#catchresulthandler)‹TResourceType› | handle errors, either as a {ResultRecord} or {any} |
8085

8186
**Returns:** *[Do](do.md)‹TResourceType, TReturnVal›*
8287

@@ -88,7 +93,7 @@ ___
8893

8994
**finally**(`finallyHandler`: [FinallyHandler](../README.md#finallyhandler)): *[Do](do.md)‹TResourceType, TReturnVal›*
9095

91-
*Defined in [src/utilities/do-try.ts:56](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/utilities/do-try.ts#L56)*
96+
*Defined in [src/utilities/do-try.ts:75](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L75)*
9297

9398
Run some handler when the function completes, whether the
9499
catch() was hit or not.
@@ -109,7 +114,7 @@ ___
109114

110115
**getAwaiter**(): *Promise‹TReturnVal›*
111116

112-
*Defined in [src/utilities/do-try.ts:70](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/utilities/do-try.ts#L70)*
117+
*Defined in [src/utilities/do-try.ts:89](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L89)*
113118

114119
Awaits the internal promise being tracked by the Do instance,
115120
and returns the result. This way, you can await a Do.try
@@ -122,11 +127,29 @@ the result of the promise.
122127

123128
___
124129

130+
### `Static` configure
131+
132+
**configure**(`config`: [DoTryConfig](../interfaces/dotryconfig.md)): *void*
133+
134+
*Defined in [src/utilities/do-try.ts:65](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L65)*
135+
136+
Sets the global configuration object for class {Do}
137+
138+
**Parameters:**
139+
140+
Name | Type | Description |
141+
------ | ------ | ------ |
142+
`config` | [DoTryConfig](../interfaces/dotryconfig.md) | the {DoTryConfig} object to set |
143+
144+
**Returns:** *void*
145+
146+
___
147+
125148
### `Static` try
126149

127150
**try**<**TResourceType**, **TReturnVal**>(`workload`: [AsyncWorkload](../README.md#asyncworkload)‹TReturnVal›): *[Do](do.md)‹TResourceType, TReturnVal›*
128151

129-
*Defined in [src/utilities/do-try.ts:81](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/utilities/do-try.ts#L81)*
152+
*Defined in [src/utilities/do-try.ts:100](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L100)*
130153

131154
Static factory method for Do class.
132155
Start a workload (sync or async) that you can then
@@ -147,3 +170,17 @@ Name | Type | Description |
147170
**Returns:** *[Do](do.md)‹TResourceType, TReturnVal›*
148171

149172
a new instance of Do
173+
174+
## Object literals
175+
176+
### `Static` `Private` config
177+
178+
### **config**: *object*
179+
180+
*Defined in [src/utilities/do-try.ts:21](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L21)*
181+
182+
### defaultErrorHandler
183+
184+
**defaultErrorHandler**: *undefined* = undefined
185+
186+
*Defined in [src/utilities/do-try.ts:22](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L22)*

docs/classes/dosync.md

Lines changed: 47 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -29,15 +29,20 @@
2929
* [catch](dosync.md#catch)
3030
* [execute](dosync.md#execute)
3131
* [finally](dosync.md#finally)
32+
* [configure](dosync.md#static-configure)
3233
* [try](dosync.md#static-try)
3334

35+
### Object literals
36+
37+
* [config](dosync.md#static-private-config)
38+
3439
## Constructors
3540

3641
### `Private` constructor
3742

3843
\+ **new DoSync**(`workload`: [SyncWorkload](../README.md#syncworkload)‹TReturnVal›): *[DoSync](dosync.md)*
3944

40-
*Defined in [src/utilities/do-try.ts:97](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/utilities/do-try.ts#L97)*
45+
*Defined in [src/utilities/do-try.ts:120](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L120)*
4146

4247
**Parameters:**
4348

@@ -53,31 +58,31 @@ Name | Type |
5358

5459
**catchHandler**? : *undefined | function*
5560

56-
*Defined in [src/utilities/do-try.ts:96](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/utilities/do-try.ts#L96)*
61+
*Defined in [src/utilities/do-try.ts:115](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L115)*
5762

5863
___
5964

6065
### `Private` `Optional` finallyHandler
6166

6267
**finallyHandler**? : *[FinallyHandler](../README.md#finallyhandler)*
6368

64-
*Defined in [src/utilities/do-try.ts:97](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/utilities/do-try.ts#L97)*
69+
*Defined in [src/utilities/do-try.ts:116](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L116)*
6570

6671
___
6772

6873
### `Private` `Readonly` workload
6974

7075
**workload**: *[SyncWorkload](../README.md#syncworkload)‹TReturnVal›*
7176

72-
*Defined in [src/utilities/do-try.ts:95](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/utilities/do-try.ts#L95)*
77+
*Defined in [src/utilities/do-try.ts:114](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L114)*
7378

7479
## Methods
7580

7681
### catch
7782

78-
**catch**(`errorHandler`: [CatchHandler](../README.md#catchhandler)‹TResourceType›): *[DoSync](dosync.md)‹TResourceType, TReturnVal›*
83+
**catch**(`errorHandler`: [CatchResultHandler](../README.md#catchresulthandler)‹TResourceType›): *[DoSync](dosync.md)‹TResourceType, TReturnVal›*
7984

80-
*Defined in [src/utilities/do-try.ts:111](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/utilities/do-try.ts#L111)*
85+
*Defined in [src/utilities/do-try.ts:134](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L134)*
8186

8287
Add a catch handler to the DoSync call chain.
8388
If errors are in the shape of a {ResultRecord},
@@ -89,7 +94,7 @@ you'll get an {any} as the second parameter.
8994

9095
Name | Type | Description |
9196
------ | ------ | ------ |
92-
`errorHandler` | [CatchHandler](../README.md#catchhandler)‹TResourceType› | handle errors, either as a {ResultRecord} or {any} |
97+
`errorHandler` | [CatchResultHandler](../README.md#catchresulthandler)‹TResourceType› | handle errors, either as a {ResultRecord} or {any} |
9398

9499
**Returns:** *[DoSync](dosync.md)‹TResourceType, TReturnVal›*
95100

@@ -99,7 +104,7 @@ ___
99104

100105
**execute**(): *TReturnVal | undefined*
101106

102-
*Defined in [src/utilities/do-try.ts:131](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/utilities/do-try.ts#L131)*
107+
*Defined in [src/utilities/do-try.ts:162](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L162)*
103108

104109
Execute the entire DoSync call chain. For the synchronous version, i.e. DoSync,
105110
you must manually call .execute() for the call chain to be executed.
@@ -114,7 +119,7 @@ ___
114119

115120
**finally**(`finallyHandler`: [FinallyHandler](../README.md#finallyhandler)): *[DoSync](dosync.md)‹TResourceType, TReturnVal›*
116121

117-
*Defined in [src/utilities/do-try.ts:147](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/utilities/do-try.ts#L147)*
122+
*Defined in [src/utilities/do-try.ts:185](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L185)*
118123

119124
Run some handler when the function completes, whether the
120125
catch() was hit or not.
@@ -131,11 +136,29 @@ this
131136

132137
___
133138

139+
### `Static` configure
140+
141+
**configure**(`config`: [DoTryConfig](../interfaces/dotryconfig.md)): *void*
142+
143+
*Defined in [src/utilities/do-try.ts:153](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L153)*
144+
145+
Sets the global configuration for class {DySync}.
146+
147+
**Parameters:**
148+
149+
Name | Type | Description |
150+
------ | ------ | ------ |
151+
`config` | [DoTryConfig](../interfaces/dotryconfig.md) | the {DoTryConfig} object to set |
152+
153+
**Returns:** *void*
154+
155+
___
156+
134157
### `Static` try
135158

136159
**try**<**TResourceType**, **TReturnVal**>(`workload`: [SyncWorkload](../README.md#syncworkload)‹TReturnVal›): *[DoSync](dosync.md)‹TResourceType, TReturnVal›*
137160

138-
*Defined in [src/utilities/do-try.ts:159](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/utilities/do-try.ts#L159)*
161+
*Defined in [src/utilities/do-try.ts:197](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L197)*
139162

140163
Static factory method for DoSync. Creates a new DoSync
141164
with the given workload.
@@ -153,3 +176,17 @@ Name | Type | Description |
153176
`workload` | [SyncWorkload](../README.md#syncworkload)‹TReturnVal› | |
154177

155178
**Returns:** *[DoSync](dosync.md)‹TResourceType, TReturnVal›*
179+
180+
## Object literals
181+
182+
### `Static` `Private` config
183+
184+
### **config**: *object*
185+
186+
*Defined in [src/utilities/do-try.ts:118](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L118)*
187+
188+
### defaultErrorHandler
189+
190+
**defaultErrorHandler**: *undefined* = undefined
191+
192+
*Defined in [src/utilities/do-try.ts:119](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/utilities/do-try.ts#L119)*

docs/classes/resulterrorrecord.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -157,7 +157,7 @@ The name provided to `Record(values, name)` can be accessed with
157157

158158
\+ **new ResultErrorRecord**(`params?`: [ResultError](../interfaces/resulterror.md)): *[ResultErrorRecord](resulterrorrecord.md)*
159159

160-
*Defined in [src/view-models/result-error-record.ts:11](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/view-models/result-error-record.ts#L11)*
160+
*Defined in [src/view-models/result-error-record.ts:11](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/view-models/result-error-record.ts#L11)*
161161

162162
**Parameters:**
163163

@@ -293,7 +293,7 @@ ___
293293

294294
**fullError**(): *string*
295295

296-
*Defined in [src/view-models/result-error-record.ts:40](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/view-models/result-error-record.ts#L40)*
296+
*Defined in [src/view-models/result-error-record.ts:40](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/view-models/result-error-record.ts#L40)*
297297

298298
Display error key and message
299299

@@ -759,7 +759,7 @@ ___
759759

760760
**with**(`values`: Partial‹[ResultError](../interfaces/resulterror.md)›): *[ResultErrorRecord](resulterrorrecord.md)*
761761

762-
*Defined in [src/view-models/result-error-record.ts:51](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/view-models/result-error-record.ts#L51)*
762+
*Defined in [src/view-models/result-error-record.ts:51](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/view-models/result-error-record.ts#L51)*
763763

764764
Merges new values into the record and returns a new instance.
765765

docs/classes/resultrecord.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -168,7 +168,7 @@ The name provided to `Record(values, name)` can be accessed with
168168

169169
\+ **new ResultRecord**(`params?`: [Result](../interfaces/result.md)‹T›): *[ResultRecord](resultrecord.md)*
170170

171-
*Defined in [src/view-models/result-record.ts:13](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/view-models/result-record.ts#L13)*
171+
*Defined in [src/view-models/result-record.ts:13](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/view-models/result-record.ts#L13)*
172172

173173
**Parameters:**
174174

@@ -196,7 +196,7 @@ ___
196196

197197
**_addErrorByType**(`key`: string, `message`: string, `errorType`: [ErrorType](../enums/errortype.md)): *[ResultRecord](resultrecord.md)‹T›*
198198

199-
*Defined in [src/view-models/result-record.ts:151](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/view-models/result-record.ts#L151)*
199+
*Defined in [src/view-models/result-record.ts:151](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/view-models/result-record.ts#L151)*
200200

201201
**Parameters:**
202202

@@ -214,7 +214,7 @@ ___
214214

215215
**addError**(`key`: string, `message`: string): *[ResultRecord](resultrecord.md)‹T›*
216216

217-
*Defined in [src/view-models/result-record.ts:48](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/view-models/result-record.ts#L48)*
217+
*Defined in [src/view-models/result-record.ts:48](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/view-models/result-record.ts#L48)*
218218

219219
Adds a new error with the supplied details and returns a new ResultRecord
220220

@@ -233,7 +233,7 @@ ___
233233

234234
**addValidationError**(`key`: string, `message`: string): *[ResultRecord](resultrecord.md)‹T›*
235235

236-
*Defined in [src/view-models/result-record.ts:58](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/view-models/result-record.ts#L58)*
236+
*Defined in [src/view-models/result-record.ts:58](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/view-models/result-record.ts#L58)*
237237

238238
Adds a new validation error with the supplied details and returns a new ResultRecord
239239

@@ -342,7 +342,7 @@ ___
342342

343343
**doesNotHaveErrors**(): *boolean*
344344

345-
*Defined in [src/view-models/result-record.ts:65](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/view-models/result-record.ts#L65)*
345+
*Defined in [src/view-models/result-record.ts:65](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/view-models/result-record.ts#L65)*
346346

347347
Evaluates whether there are any errors on the result
348348

@@ -372,7 +372,7 @@ ___
372372

373373
**errorCount**(): *number*
374374

375-
*Defined in [src/view-models/result-record.ts:72](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/view-models/result-record.ts#L72)*
375+
*Defined in [src/view-models/result-record.ts:72](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/view-models/result-record.ts#L72)*
376376

377377
Returns total number of errors
378378

@@ -433,7 +433,7 @@ ___
433433

434434
**getErrorMessageFor**(`key`: string): *string | undefined*
435435

436-
*Defined in [src/view-models/result-record.ts:84](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/view-models/result-record.ts#L84)*
436+
*Defined in [src/view-models/result-record.ts:84](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/view-models/result-record.ts#L84)*
437437

438438
Returns an error message for a given key
439439

@@ -487,7 +487,7 @@ ___
487487

488488
**hasErrorFor**(...`keys`: string[]): *boolean*
489489

490-
*Defined in [src/view-models/result-record.ts:92](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/view-models/result-record.ts#L92)*
490+
*Defined in [src/view-models/result-record.ts:92](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/view-models/result-record.ts#L92)*
491491

492492
Determines if the result contains an error for the supplied key(s)
493493

@@ -505,7 +505,7 @@ ___
505505

506506
**hasErrors**(): *boolean*
507507

508-
*Defined in [src/view-models/result-record.ts:105](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/view-models/result-record.ts#L105)*
508+
*Defined in [src/view-models/result-record.ts:105](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/view-models/result-record.ts#L105)*
509509

510510
Evaluates whether there are any errors on the result
511511

@@ -547,7 +547,7 @@ ___
547547

548548
**listErrorMessages**(): *string[]*
549549

550-
*Defined in [src/view-models/result-record.ts:123](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/view-models/result-record.ts#L123)*
550+
*Defined in [src/view-models/result-record.ts:123](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/view-models/result-record.ts#L123)*
551551

552552
Map all error messages into a simple string array.
553553

@@ -559,7 +559,7 @@ ___
559559

560560
**listErrors**(): *string[]*
561561

562-
*Defined in [src/view-models/result-record.ts:112](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/view-models/result-record.ts#L112)*
562+
*Defined in [src/view-models/result-record.ts:112](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/view-models/result-record.ts#L112)*
563563

564564
Map all errors into simple string array
565565

@@ -910,7 +910,7 @@ ___
910910

911911
**with**(`values`: Partial‹[Result](../interfaces/result.md)‹T››): *[ResultRecord](resultrecord.md)‹T›*
912912

913-
*Defined in [src/view-models/result-record.ts:141](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/0b0f3de/src/view-models/result-record.ts#L141)*
913+
*Defined in [src/view-models/result-record.ts:141](https://github.com/AndcultureCode/AndcultureCode.JavaScript.Core/blob/ca11227/src/view-models/result-record.ts#L141)*
914914

915915
Merges new values into the record and returns a new instance.
916916

0 commit comments

Comments
 (0)