183 lines
3.9 KiB
Markdown
183 lines
3.9 KiB
Markdown
# Class: IdempotencyKeyService
|
|
|
|
## Hierarchy
|
|
|
|
- `"medusa-interfaces"`
|
|
|
|
↳ **`IdempotencyKeyService`**
|
|
|
|
## Constructors
|
|
|
|
### constructor
|
|
|
|
• **new IdempotencyKeyService**(`__namedParameters`)
|
|
|
|
#### Parameters
|
|
|
|
| Name | Type |
|
|
| :------ | :------ |
|
|
| `__namedParameters` | `Object` |
|
|
|
|
#### Overrides
|
|
|
|
BaseService.constructor
|
|
|
|
#### Defined in
|
|
|
|
[services/idempotency-key.js:8](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/idempotency-key.js#L8)
|
|
|
|
## Methods
|
|
|
|
### create
|
|
|
|
▸ **create**(`payload`): `Promise`<`IdempotencyKeyModel`\>
|
|
|
|
Creates an idempotency key for a request.
|
|
If no idempotency key is provided in request, we will create a unique
|
|
identifier.
|
|
|
|
#### Parameters
|
|
|
|
| Name | Type | Description |
|
|
| :------ | :------ | :------ |
|
|
| `payload` | `any` | payload of request to create idempotency key for |
|
|
|
|
#### Returns
|
|
|
|
`Promise`<`IdempotencyKeyModel`\>
|
|
|
|
the created idempotency key
|
|
|
|
#### Defined in
|
|
|
|
[services/idempotency-key.js:55](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/idempotency-key.js#L55)
|
|
|
|
___
|
|
|
|
### initializeRequest
|
|
|
|
▸ **initializeRequest**(`headerKey`, `reqMethod`, `reqParams`, `reqPath`): `Promise`<`IdempotencyKeyModel`\>
|
|
|
|
Execute the initial steps in a idempotent request.
|
|
|
|
#### Parameters
|
|
|
|
| Name | Type | Description |
|
|
| :------ | :------ | :------ |
|
|
| `headerKey` | `string` | potential idempotency key from header |
|
|
| `reqMethod` | `string` | method of request |
|
|
| `reqParams` | `string` | params of request |
|
|
| `reqPath` | `string` | path of request |
|
|
|
|
#### Returns
|
|
|
|
`Promise`<`IdempotencyKeyModel`\>
|
|
|
|
the existing or created idempotency key
|
|
|
|
#### Defined in
|
|
|
|
[services/idempotency-key.js:29](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/idempotency-key.js#L29)
|
|
|
|
___
|
|
|
|
### lock
|
|
|
|
▸ **lock**(`idempotencyKey`): `Promise`<`any`\>
|
|
|
|
Locks an idempotency.
|
|
|
|
#### Parameters
|
|
|
|
| Name | Type | Description |
|
|
| :------ | :------ | :------ |
|
|
| `idempotencyKey` | `string` | key to lock |
|
|
|
|
#### Returns
|
|
|
|
`Promise`<`any`\>
|
|
|
|
result of the update operation
|
|
|
|
#### Defined in
|
|
|
|
[services/idempotency-key.js:94](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/idempotency-key.js#L94)
|
|
|
|
___
|
|
|
|
### retrieve
|
|
|
|
▸ **retrieve**(`idempotencyKey`): `Promise`<`IdempotencyKeyModel`\>
|
|
|
|
Retrieves an idempotency key
|
|
|
|
#### Parameters
|
|
|
|
| Name | Type | Description |
|
|
| :------ | :------ | :------ |
|
|
| `idempotencyKey` | `string` | key to retrieve |
|
|
|
|
#### Returns
|
|
|
|
`Promise`<`IdempotencyKeyModel`\>
|
|
|
|
idempotency key
|
|
|
|
#### Defined in
|
|
|
|
[services/idempotency-key.js:76](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/idempotency-key.js#L76)
|
|
|
|
___
|
|
|
|
### update
|
|
|
|
▸ **update**(`idempotencyKey`, `update`): `Promise`<`any`\>
|
|
|
|
Locks an idempotency.
|
|
|
|
#### Parameters
|
|
|
|
| Name | Type | Description |
|
|
| :------ | :------ | :------ |
|
|
| `idempotencyKey` | `string` | key to update |
|
|
| `update` | `any` | update object |
|
|
|
|
#### Returns
|
|
|
|
`Promise`<`any`\>
|
|
|
|
result of the update operation
|
|
|
|
#### Defined in
|
|
|
|
[services/idempotency-key.js:121](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/idempotency-key.js#L121)
|
|
|
|
___
|
|
|
|
### workStage
|
|
|
|
▸ **workStage**(`idempotencyKey`, `func`): `IdempotencyKeyModel`
|
|
|
|
Performs an atomic work stage.
|
|
An atomic work stage contains some related functionality, that needs to be
|
|
transactionally executed in isolation. An idempotent request will
|
|
always consist of 2 or more of these phases. The required phases are
|
|
"started" and "finished".
|
|
|
|
#### Parameters
|
|
|
|
| Name | Type | Description |
|
|
| :------ | :------ | :------ |
|
|
| `idempotencyKey` | `string` | current idempotency key |
|
|
| `func` | `Function` | functionality to execute within the phase |
|
|
|
|
#### Returns
|
|
|
|
`IdempotencyKeyModel`
|
|
|
|
new updated idempotency key
|
|
|
|
#### Defined in
|
|
|
|
[services/idempotency-key.js:148](https://github.com/medusajs/medusa/blob/2d3e404f/packages/medusa/src/services/idempotency-key.js#L148)
|