@orpc/experimental-lock 2.0.0-beta.44 → 2.0.0-beta.46
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/README.md +100 -62
- package/dist/adapters/base-redis.d.mts +4 -4
- package/dist/adapters/base-redis.d.ts +4 -4
- package/dist/adapters/base-redis.mjs +3 -3
- package/dist/adapters/memory.d.mts +2 -2
- package/dist/adapters/memory.d.ts +2 -2
- package/dist/adapters/redis.d.mts +8 -1
- package/dist/adapters/redis.d.ts +8 -1
- package/dist/adapters/redis.mjs +9 -0
- package/dist/adapters/upstash.d.mts +8 -1
- package/dist/adapters/upstash.d.ts +8 -1
- package/dist/adapters/upstash.mjs +9 -0
- package/dist/index.d.mts +5 -5
- package/dist/index.d.ts +5 -5
- package/dist/shared/{experimental-lock.D48ZxIcJ.d.mts → experimental-lock.D9u4cJfq.d.mts} +3 -3
- package/dist/shared/{experimental-lock.D48ZxIcJ.d.ts → experimental-lock.D9u4cJfq.d.ts} +3 -3
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -21,9 +21,40 @@
|
|
|
21
21
|
</a>
|
|
22
22
|
</div>
|
|
23
23
|
|
|
24
|
+
**oRPC** is a TypeScript framework for building end-to-end typesafe APIs. Write your API once as plain TypeScript functions, and oRPC gives you a fully typed client, a REST API with an OpenAPI document, and MCP tools for AI agents, with no code generation. It runs on Node.js, Bun, Deno, Cloudflare Workers, and more.
|
|
25
|
+
|
|
26
|
+
Define procedures on the server and serve them with an [RPC handler](https://orpc.dev/docs/rpc/handler):
|
|
27
|
+
|
|
28
|
+
```ts
|
|
29
|
+
import { os } from '@orpc/server'
|
|
30
|
+
import * as z from 'zod'
|
|
31
|
+
|
|
32
|
+
export const router = {
|
|
33
|
+
planet: {
|
|
34
|
+
find: os
|
|
35
|
+
.input(z.object({ id: z.number() }))
|
|
36
|
+
.handler(({ input }) => ({ id: input.id, name: 'Earth' })),
|
|
37
|
+
},
|
|
38
|
+
}
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Then call them from a client that knows every input and output, without generating anything:
|
|
42
|
+
|
|
43
|
+
```ts
|
|
44
|
+
import type { RouterClient } from '@orpc/server'
|
|
45
|
+
import type { router } from './router'
|
|
46
|
+
import { createORPCClient } from '@orpc/client'
|
|
47
|
+
import { RPCLink } from '@orpc/client/fetch'
|
|
48
|
+
|
|
49
|
+
const link = new RPCLink({ origin: 'http://localhost:3000', url: '/rpc' })
|
|
50
|
+
const client: RouterClient<typeof router> = createORPCClient(link)
|
|
51
|
+
|
|
52
|
+
const planet = await client.planet.find({ id: 1 }) // { id: number, name: string }
|
|
53
|
+
```
|
|
54
|
+
|
|
24
55
|
## Documentation
|
|
25
56
|
|
|
26
|
-
|
|
57
|
+
Read the full documentation at [orpc.dev](https://orpc.dev), starting with the [Getting Started guide](https://orpc.dev/docs/getting-started).
|
|
27
58
|
|
|
28
59
|
## Packages
|
|
29
60
|
|
|
@@ -56,20 +87,21 @@ You can read the documentation [here](https://orpc.dev).
|
|
|
56
87
|
|
|
57
88
|
**Framework & ecosystem integrations**
|
|
58
89
|
|
|
59
|
-
| Package
|
|
60
|
-
|
|
|
61
|
-
| [@orpc/next](https://www.npmjs.com/package/@orpc/next)
|
|
62
|
-
| [@orpc/ai-sdk](https://www.npmjs.com/package/@orpc/ai-sdk)
|
|
63
|
-
| [@orpc/
|
|
64
|
-
| [@orpc/
|
|
65
|
-
| [@orpc/
|
|
66
|
-
| [@orpc/
|
|
67
|
-
| [@orpc/
|
|
68
|
-
| [@orpc/
|
|
69
|
-
| [@orpc/
|
|
70
|
-
| [@orpc/
|
|
71
|
-
| [@orpc/
|
|
72
|
-
| [@orpc/
|
|
90
|
+
| Package | Purpose | Docs |
|
|
91
|
+
| -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
92
|
+
| [@orpc/next](https://www.npmjs.com/package/@orpc/next) | Integrate with [Next.js Server Functions](https://nextjs.org/docs/app/getting-started/mutating-data). | [Next.js](https://orpc.dev/docs/integrations/next) |
|
|
93
|
+
| [@orpc/ai-sdk](https://www.npmjs.com/package/@orpc/ai-sdk) | Turn contracts and procedures into [AI SDK](https://ai-sdk.dev/) tools. | [AI SDK](https://orpc.dev/docs/integrations/ai-sdk) |
|
|
94
|
+
| [@orpc/mcp](https://www.npmjs.com/package/@orpc/mcp) | Expose procedures as [MCP](https://modelcontextprotocol.io/) tools. | [MCP](https://orpc.dev/docs/integrations/mcp) |
|
|
95
|
+
| [@orpc/tanstack-query](https://www.npmjs.com/package/@orpc/tanstack-query) | Integrate with [TanStack Query](https://tanstack.com/query/latest). | [TanStack Query](https://orpc.dev/docs/integrations/tanstack-query) |
|
|
96
|
+
| [@orpc/pinia-colada](https://www.npmjs.com/package/@orpc/pinia-colada) | Integrate with [Pinia Colada](https://pinia-colada.esm.dev/). | [Pinia Colada](https://orpc.dev/docs/integrations/pinia-colada) |
|
|
97
|
+
| [@orpc/swr](https://www.npmjs.com/package/@orpc/swr) | Integrate with [SWR](https://swr.vercel.app/). | [SWR](https://orpc.dev/docs/integrations/swr) |
|
|
98
|
+
| [@orpc/msw](https://www.npmjs.com/package/@orpc/msw) | Mock procedures with [Mock Service Worker](https://mswjs.io/). | [MSW](https://orpc.dev/docs/integrations/msw) |
|
|
99
|
+
| [@orpc/effect](https://www.npmjs.com/package/@orpc/effect) | Integrate with [Effect](https://effect.website/). | [Effect](https://orpc.dev/docs/integrations/effect) |
|
|
100
|
+
| [@orpc/nest](https://www.npmjs.com/package/@orpc/nest) | Implement your contract with [NestJS](https://nestjs.com/). | [NestJS](https://orpc.dev/docs/integrations/nest) |
|
|
101
|
+
| [@orpc/node](https://www.npmjs.com/package/@orpc/node) | [Node.js](https://nodejs.org/) plugins for static file serving and large uploads. | [Static File](https://orpc.dev/docs/plugins/static-file), [Tmp File Upload](https://orpc.dev/docs/plugins/tmp-file-upload), [Batch Response Compression](https://orpc.dev/docs/plugins/batch-response-compression) |
|
|
102
|
+
| [@orpc/bun](https://www.npmjs.com/package/@orpc/bun) | Adapters for [Bun's Redis](https://bun.sh/). | [Publisher](https://orpc.dev/docs/helpers/publisher), [Rate Limit](https://orpc.dev/docs/helpers/ratelimit), [Lock](https://orpc.dev/docs/helpers/lock) |
|
|
103
|
+
| [@orpc/cloudflare](https://www.npmjs.com/package/@orpc/cloudflare) | Adapters for [Cloudflare Workers](https://developers.cloudflare.com/workers/). | [Publisher](https://orpc.dev/docs/helpers/publisher), [Rate Limit](https://orpc.dev/docs/helpers/ratelimit), [Lock](https://orpc.dev/docs/helpers/lock), [Traces](https://orpc.dev/docs/integrations/cloudflare-traces) |
|
|
104
|
+
| [@orpc/trpc](https://www.npmjs.com/package/@orpc/trpc) | Reuse existing [tRPC](https://trpc.io/) routers within oRPC. | [tRPC](https://orpc.dev/docs/integrations/trpc) |
|
|
73
105
|
|
|
74
106
|
**Observability**
|
|
75
107
|
|
|
@@ -95,19 +127,11 @@ Like what we build over at [middleapi](https://github.com/middleapi)? You can he
|
|
|
95
127
|
</tr>
|
|
96
128
|
</table>
|
|
97
129
|
|
|
98
|
-
### Premium Sponsors
|
|
99
|
-
|
|
100
|
-
<table>
|
|
101
|
-
<tr>
|
|
102
|
-
<td align="center"><a href="https://github.com/nexa-ca?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Nexa"><img src="https://avatars.githubusercontent.com/u/199146462?v=4" width="209" alt="Nexa"/><br />Nexa</a></td>
|
|
103
|
-
</tr>
|
|
104
|
-
</table>
|
|
105
|
-
|
|
106
130
|
### Organization Sponsors
|
|
107
131
|
|
|
108
132
|
<table>
|
|
109
133
|
<tr>
|
|
110
|
-
<td align="center"><a href="https://lnmarkets.com/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="LN Markets"><img src="https://avatars.githubusercontent.com/u/70597625?v=4" width="
|
|
134
|
+
<td align="center"><a href="https://lnmarkets.com/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="LN Markets"><img src="https://avatars.githubusercontent.com/u/70597625?v=4" width="209" alt="LN Markets"/><br />LN Markets</a></td>
|
|
111
135
|
</tr>
|
|
112
136
|
</table>
|
|
113
137
|
|
|
@@ -115,27 +139,29 @@ Like what we build over at [middleapi](https://github.com/middleapi)? You can he
|
|
|
115
139
|
|
|
116
140
|
<table>
|
|
117
141
|
<tr>
|
|
118
|
-
<td align="center"><a href="https://github.com/hrmcdonald?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Reece McDonald"><img src="https://avatars.githubusercontent.com/u/39349270?v=4" width="
|
|
119
|
-
<td align="center"><a href="https://soymilk.party/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="あわわわとーにゅ"><img src="https://avatars.githubusercontent.com/u/17376330?u=de3353804be889f009f7e0a1582daf04d0ab292d&v=4" width="
|
|
120
|
-
<td align="center"><a href="https://github.com/nicognaW?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="nk"><img src="https://avatars.githubusercontent.com/u/66731869?u=4699bda3a9092d3ec34fbd959450767bcc8b8b6d&v=4" width="
|
|
121
|
-
<td align="center"><a href="https://supastarter.dev/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="supastarter"><img src="https://avatars.githubusercontent.com/u/110960143?v=4" width="
|
|
122
|
-
<td align="center"><a href="https://github.com/herrfugbaum?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="herrfugbaum"><img src="https://avatars.githubusercontent.com/u/12859776?u=644dc1666d0220bc0468eb0de3c56b919f635b16&v=4" width="
|
|
123
|
-
|
|
142
|
+
<td align="center"><a href="https://github.com/hrmcdonald?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Reece McDonald"><img src="https://avatars.githubusercontent.com/u/39349270?v=4" width="167" alt="Reece McDonald"/><br />Reece McDonald</a></td>
|
|
143
|
+
<td align="center"><a href="https://soymilk.party/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="あわわわとーにゅ"><img src="https://avatars.githubusercontent.com/u/17376330?u=de3353804be889f009f7e0a1582daf04d0ab292d&v=4" width="167" alt="あわわわとーにゅ"/><br />あわわわとーにゅ</a></td>
|
|
144
|
+
<td align="center"><a href="https://github.com/nicognaW?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="nk"><img src="https://avatars.githubusercontent.com/u/66731869?u=4699bda3a9092d3ec34fbd959450767bcc8b8b6d&v=4" width="167" alt="nk"/><br />nk</a></td>
|
|
145
|
+
<td align="center"><a href="https://supastarter.dev/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="supastarter"><img src="https://avatars.githubusercontent.com/u/110960143?v=4" width="167" alt="supastarter"/><br />supastarter</a></td>
|
|
146
|
+
<td align="center"><a href="https://github.com/herrfugbaum?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="herrfugbaum"><img src="https://avatars.githubusercontent.com/u/12859776?u=644dc1666d0220bc0468eb0de3c56b919f635b16&v=4" width="167" alt="herrfugbaum"/><br />herrfugbaum</a></td>
|
|
147
|
+
</tr>
|
|
148
|
+
<tr>
|
|
149
|
+
<td align="center"><a href="https://laststance.io/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Ryota Murakami"><img src="https://avatars.githubusercontent.com/u/5501268?u=599389e03340734325726ca3f8f423c021d47d7f&v=4" width="167" alt="Ryota Murakami"/><br />Ryota Murakami</a></td>
|
|
150
|
+
<td align="center"><a href="https://cra.mr/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="David Cramer"><img src="https://avatars.githubusercontent.com/u/23610?v=4" width="167" alt="David Cramer"/><br />David Cramer</a></td>
|
|
151
|
+
<td align="center"><a href="https://valerii15298.github.io/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Valerii Petryniak"><img src="https://avatars.githubusercontent.com/u/44531564?u=88ac74d9bacd20401518441907acad21063cd397&v=4" width="167" alt="Valerii Petryniak"/><br />Valerii Petryniak</a></td>
|
|
152
|
+
<td align="center"><a href="https://letstri.dev/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Valerii Strilets"><img src="https://avatars.githubusercontent.com/u/13253748?u=c7b10399ccc8f8081e24db94ec32cd9858e86ac3&v=4" width="167" alt="Valerii Strilets"/><br />Valerii Strilets</a></td>
|
|
153
|
+
<td align="center"><a href="https://blacklight.sh/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Kyle Mistele"><img src="https://avatars.githubusercontent.com/u/18430555?u=3afebeb81de666e35aaac3ed46f14159d7603ffb&v=4" width="167" alt="Kyle Mistele"/><br />Kyle Mistele</a></td>
|
|
124
154
|
</tr>
|
|
125
155
|
<tr>
|
|
126
|
-
<td align="center"><a href="https://
|
|
127
|
-
<td align="center"><a href="https://
|
|
128
|
-
<td align="center"><a href="https://
|
|
129
|
-
<td align="center"><a href="https://
|
|
130
|
-
<td align="center"><a href="https://github.com/
|
|
131
|
-
<td align="center"><a href="https://github.com/Ryanjso?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Ryan Soderberg"><img src="https://avatars.githubusercontent.com/u/39172778?u=5ed913c31d57e7221b75784abcad48c7ebddde27&v=4" width="139" alt="Ryan Soderberg"/><br />Ryan Soderberg</a></td>
|
|
156
|
+
<td align="center"><a href="https://github.com/christ12938?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="christ12938"><img src="https://avatars.githubusercontent.com/u/25758598?v=4" width="167" alt="christ12938"/><br />christ12938</a></td>
|
|
157
|
+
<td align="center"><a href="https://github.com/Ryanjso?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Ryan Soderberg"><img src="https://avatars.githubusercontent.com/u/39172778?u=5ed913c31d57e7221b75784abcad48c7ebddde27&v=4" width="167" alt="Ryan Soderberg"/><br />Ryan Soderberg</a></td>
|
|
158
|
+
<td align="center"><a href="https://github.com/itigoore01?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="shota"><img src="https://avatars.githubusercontent.com/u/11831107?u=c976a6dc7e055eb026304c46c99100ed22b0c8e0&v=4" width="167" alt="shota"/><br />shota</a></td>
|
|
159
|
+
<td align="center"><a href="https://github.com/ellis-driscoll?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Ellis Driscoll"><img src="https://avatars.githubusercontent.com/u/70685966?u=c5f95bc33b5991d9744abe00052542e4a2ed3cb9&v=4" width="167" alt="Ellis Driscoll"/><br />Ellis Driscoll</a></td>
|
|
160
|
+
<td align="center"><a href="https://github.com/hoangbn?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Hoang Nguyen"><img src="https://avatars.githubusercontent.com/u/38968280?u=c90084c6de65c56facabab7ba13a72a49ddbc3e4&v=4" width="167" alt="Hoang Nguyen"/><br />Hoang Nguyen</a></td>
|
|
132
161
|
</tr>
|
|
133
162
|
<tr>
|
|
134
|
-
<td align="center"><a href="https://
|
|
135
|
-
<td align="center"><a href="https://
|
|
136
|
-
<td align="center"><a href="https://github.com/hoangbn?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Hoang Nguyen"><img src="https://avatars.githubusercontent.com/u/38968280?u=c90084c6de65c56facabab7ba13a72a49ddbc3e4&v=4" width="139" alt="Hoang Nguyen"/><br />Hoang Nguyen</a></td>
|
|
137
|
-
<td align="center"><a href="https://opencollective.com/guest-ac41de3b?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Orestis Ioannou"><img src="https://images.opencollective.com/guest-ac41de3b/avatar/460.png" width="139" alt="Orestis Ioannou"/><br />Orestis Ioannou</a></td>
|
|
138
|
-
<td align="center"><a href="https://automatio.ai/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Stefan Smiljkovic"><img src="https://avatars.githubusercontent.com/u/1984909?u=b7bf5bc40ed49df3c22f69d2da7b8d78709c49ed&v=4" width="139" alt="Stefan Smiljkovic"/><br />Stefan Smiljkovic</a></td>
|
|
163
|
+
<td align="center"><a href="https://opencollective.com/guest-ac41de3b?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Orestis Ioannou"><img src="https://images.opencollective.com/guest-ac41de3b/avatar/460.png" width="167" alt="Orestis Ioannou"/><br />Orestis Ioannou</a></td>
|
|
164
|
+
<td align="center"><a href="https://automatio.ai/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Stefan Smiljkovic"><img src="https://avatars.githubusercontent.com/u/1984909?u=b7bf5bc40ed49df3c22f69d2da7b8d78709c49ed&v=4" width="167" alt="Stefan Smiljkovic"/><br />Stefan Smiljkovic</a></td>
|
|
139
165
|
</tr>
|
|
140
166
|
</table>
|
|
141
167
|
|
|
@@ -143,34 +169,46 @@ Like what we build over at [middleapi](https://github.com/middleapi)? You can he
|
|
|
143
169
|
|
|
144
170
|
<table>
|
|
145
171
|
<tr>
|
|
146
|
-
<td align="center"><a href="https://github.com/rhinodavid?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="David Walsh"><img src="https://avatars.githubusercontent.com/u/5778036?u=b5521f07d2f88c3db2a0dae62b5f2f8357214af0&v=4" width="
|
|
147
|
-
<td align="center"><a href="https://github.com/IPv4Addr?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="IPv4Addr"><img src="https://avatars.githubusercontent.com/u/100147665?u=59996b72f69bb53063cb7e9ff8b8f898616cd94d&v=4" width="
|
|
148
|
-
<td align="center"><a href="https://robbevaes.be/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Robbe Vaes"><img src="https://avatars.githubusercontent.com/u/44748019?u=e0232402c045ad4eac7cbd217f1f47e083103b89&v=4" width="
|
|
149
|
-
<td align="center"><a href="https://github.com/aidansunbury?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Aidan Sunbury"><img src="https://avatars.githubusercontent.com/u/64103161?v=4" width="
|
|
150
|
-
<td align="center"><a href="https://github.com/soonoo?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="soonoo"><img src="https://avatars.githubusercontent.com/u/5436405?u=5d0b4aa955c87e30e6bda7f0cccae5402da99528&v=4" width="
|
|
151
|
-
<td align="center"><a href="https://kevinporten.dev/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Kevin Porten"><img src="https://avatars.githubusercontent.com/u/1839345?u=dc2263d5cfe0d927ce1a0be04a1d55dd6b55405c&v=4" width="
|
|
152
|
-
<td align="center"><a href="https://github.com/pumpkinlink?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Denis"><img src="https://avatars.githubusercontent.com/u/11864620?u=5f47bbe6c65d0f6f5cf011021490238e4b0593d0&v=4" width="119" alt="Denis"/><br />Denis</a></td>
|
|
172
|
+
<td align="center"><a href="https://github.com/rhinodavid?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="David Walsh"><img src="https://avatars.githubusercontent.com/u/5778036?u=b5521f07d2f88c3db2a0dae62b5f2f8357214af0&v=4" width="139" alt="David Walsh"/><br />David Walsh</a></td>
|
|
173
|
+
<td align="center"><a href="https://github.com/IPv4Addr?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="IPv4Addr"><img src="https://avatars.githubusercontent.com/u/100147665?u=59996b72f69bb53063cb7e9ff8b8f898616cd94d&v=4" width="139" alt="IPv4Addr"/><br />IPv4Addr</a></td>
|
|
174
|
+
<td align="center"><a href="https://robbevaes.be/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Robbe Vaes"><img src="https://avatars.githubusercontent.com/u/44748019?u=e0232402c045ad4eac7cbd217f1f47e083103b89&v=4" width="139" alt="Robbe Vaes"/><br />Robbe Vaes</a></td>
|
|
175
|
+
<td align="center"><a href="https://github.com/aidansunbury?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Aidan Sunbury"><img src="https://avatars.githubusercontent.com/u/64103161?v=4" width="139" alt="Aidan Sunbury"/><br />Aidan Sunbury</a></td>
|
|
176
|
+
<td align="center"><a href="https://github.com/soonoo?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="soonoo"><img src="https://avatars.githubusercontent.com/u/5436405?u=5d0b4aa955c87e30e6bda7f0cccae5402da99528&v=4" width="139" alt="soonoo"/><br />soonoo</a></td>
|
|
177
|
+
<td align="center"><a href="https://kevinporten.dev/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Kevin Porten"><img src="https://avatars.githubusercontent.com/u/1839345?u=dc2263d5cfe0d927ce1a0be04a1d55dd6b55405c&v=4" width="139" alt="Kevin Porten"/><br />Kevin Porten</a></td>
|
|
153
178
|
</tr>
|
|
154
179
|
<tr>
|
|
155
|
-
<td align="center"><a href="https://github.com/
|
|
156
|
-
<td align="center"><a href="
|
|
157
|
-
<td align="center"><a href="
|
|
158
|
-
<td align="center"><a href="https://
|
|
159
|
-
<td align="center"><a href="https://
|
|
160
|
-
<td align="center"><a href="https://
|
|
161
|
-
<td align="center"><a href="https://dubinets.io/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Lev Dubinets"><img src="https://avatars.githubusercontent.com/u/3114081?u=f547f5d5012cab54851f1b1ad72d10e537f78fc2&v=4" width="119" alt="Lev Dubinets"/><br />Lev Dubinets</a></td>
|
|
180
|
+
<td align="center"><a href="https://github.com/pumpkinlink?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Denis"><img src="https://avatars.githubusercontent.com/u/11864620?u=5f47bbe6c65d0f6f5cf011021490238e4b0593d0&v=4" width="139" alt="Denis"/><br />Denis</a></td>
|
|
181
|
+
<td align="center"><a href="https://github.com/christopher-kapic?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Christopher Kapic"><img src="https://avatars.githubusercontent.com/u/59740769?u=e7ad4b72b5bf6c9eb1644c26dbf3332a8f987377&v=4" width="139" alt="Christopher Kapic"/><br />Christopher Kapic</a></td>
|
|
182
|
+
<td align="center"><a href="http://ballingt.com/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Tom Ballinger"><img src="https://avatars.githubusercontent.com/u/458879?u=4b045ac75d721b6ac2b42a74d7d37f61f0414031&v=4" width="139" alt="Tom Ballinger"/><br />Tom Ballinger</a></td>
|
|
183
|
+
<td align="center"><a href="https://lee-sam.com/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Sam"><img src="https://avatars.githubusercontent.com/u/102863520?u=3c89611f549d5070be232eb4532f690c8f2e7a65&v=4" width="139" alt="Sam"/><br />Sam</a></td>
|
|
184
|
+
<td align="center"><a href="https://github.com/Titoine?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Titoine"><img src="https://avatars.githubusercontent.com/u/3514286?u=1bb1e86b0c99c8a1121372e56d51a177eea12191&v=4" width="139" alt="Titoine"/><br />Titoine</a></td>
|
|
185
|
+
<td align="center"><a href="https://rigtch.fm/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Igor Makowski"><img src="https://avatars.githubusercontent.com/u/56691628?u=ee8c879478f7c151b9156aef6c74243fa3e247a8&v=4" width="139" alt="Igor Makowski"/><br />Igor Makowski</a></td>
|
|
162
186
|
</tr>
|
|
163
187
|
<tr>
|
|
164
|
-
<td align="center"><a href="https://
|
|
165
|
-
<td align="center"><a href="https://
|
|
166
|
-
<td align="center"><a href="https://
|
|
167
|
-
<td align="center"><a href="https://
|
|
168
|
-
<td align="center"><a href="https://
|
|
169
|
-
<td align="center"><a href="https://
|
|
188
|
+
<td align="center"><a href="https://blog.cwang.io/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="hanayashiki"><img src="https://avatars.githubusercontent.com/u/26056783?u=06c3b9205a16fd41a871e82da1cc2a09306d53f5&v=4" width="139" alt="hanayashiki"/><br />hanayashiki</a></td>
|
|
189
|
+
<td align="center"><a href="https://dubinets.io/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Lev Dubinets"><img src="https://avatars.githubusercontent.com/u/3114081?u=f547f5d5012cab54851f1b1ad72d10e537f78fc2&v=4" width="139" alt="Lev Dubinets"/><br />Lev Dubinets</a></td>
|
|
190
|
+
<td align="center"><a href="https://kellychan.im/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Kelly Peilin Chan"><img src="https://avatars.githubusercontent.com/u/520852?u=6b0f7105f694e7b5cacf410a3f04c7044b469dc8&v=4" width="139" alt="Kelly Peilin Chan"/><br />Kelly Peilin Chan</a></td>
|
|
191
|
+
<td align="center"><a href="https://guyariely.com/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Guy Ariely"><img src="https://avatars.githubusercontent.com/u/42813496?u=edb6b7f563bf28e160a290832e7da57c0506f8ca&v=4" width="139" alt="Guy Ariely"/><br />Guy Ariely</a></td>
|
|
192
|
+
<td align="center"><a href="https://paulsenon.com/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="PaulSenon"><img src="https://avatars.githubusercontent.com/u/19531087?u=6385741eb91d200b8c513ec6045482e301767ca6&v=4" width="139" alt="PaulSenon"/><br />PaulSenon</a></td>
|
|
193
|
+
<td align="center"><a href="https://nakasyou.how/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Shotaro Nakamura"><img src="https://avatars.githubusercontent.com/u/79000684?u=f644df3f29f0e8677a90967115774564f1d9d6ab&v=4" width="139" alt="Shotaro Nakamura"/><br />Shotaro Nakamura</a></td>
|
|
194
|
+
</tr>
|
|
195
|
+
<tr>
|
|
196
|
+
<td align="center"><a href="https://piscis.dev/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Alex"><img src="https://avatars.githubusercontent.com/u/326163?u=b245f368bd940cf51d08c0b6bf55f8257f359437&v=4" width="139" alt="Alex"/><br />Alex</a></td>
|
|
197
|
+
<td align="center"><a href="https://opensource.gubanov.eu/?ref=middleapi&utm_source=middleapi&utm_medium=sponsor" target="_blank" rel="noopener sponsored" title="Andrey Gubanov"><img src="https://avatars.githubusercontent.com/u/1082083?u=c5f2daf7ebece498e85c83367bb37b4e10e2649d&v=4" width="139" alt="Andrey Gubanov"/><br />Andrey Gubanov</a></td>
|
|
170
198
|
</tr>
|
|
171
199
|
</table>
|
|
172
200
|
|
|
173
|
-
With thanks to [
|
|
201
|
+
With thanks to [40 past sponsors](https://orpc.dev/sponsors#past-sponsors) who helped get oRPC here.
|
|
202
|
+
|
|
203
|
+
## Open Source Programs
|
|
204
|
+
|
|
205
|
+
[middleapi](https://github.com/middleapi) is supported by these open source programs:
|
|
206
|
+
|
|
207
|
+
<table>
|
|
208
|
+
<tr>
|
|
209
|
+
<td align="center"><a href="https://claude.com/contact-sales/claude-for-oss" target="_blank" rel="noopener" title="Claude for Open Source"><img src="https://cdn.simpleicons.org/claude" width="64" alt="Claude"/><br />Claude for Open Source</a></td>
|
|
210
|
+
</tr>
|
|
211
|
+
</table>
|
|
174
212
|
|
|
175
213
|
## References
|
|
176
214
|
|
|
@@ -12,7 +12,7 @@ interface BaseRedisLockerOptions {
|
|
|
12
12
|
*
|
|
13
13
|
* @default ''
|
|
14
14
|
*/
|
|
15
|
-
prefix?: string;
|
|
15
|
+
prefix?: string | undefined;
|
|
16
16
|
/**
|
|
17
17
|
* How long a lock is held before it expires automatically, in milliseconds.
|
|
18
18
|
* Guards against holders that never release the lock, such as a crashed process.
|
|
@@ -25,14 +25,14 @@ interface BaseRedisLockerOptions {
|
|
|
25
25
|
*
|
|
26
26
|
* @default 10000
|
|
27
27
|
*/
|
|
28
|
-
timeout?: number;
|
|
28
|
+
timeout?: number | undefined;
|
|
29
29
|
/**
|
|
30
30
|
* How long to wait between acquisition attempts while the lock
|
|
31
31
|
* is held by someone else, in milliseconds.
|
|
32
32
|
*
|
|
33
33
|
* @default 100
|
|
34
34
|
*/
|
|
35
|
-
retryInterval?: number;
|
|
35
|
+
retryInterval?: number | undefined;
|
|
36
36
|
}
|
|
37
37
|
/**
|
|
38
38
|
* Base class for Redis-backed locker adapters. It owns the key naming, the lock
|
|
@@ -44,7 +44,7 @@ interface BaseRedisLockerOptions {
|
|
|
44
44
|
* @see {@link https://orpc.dev/docs/helpers/lock#adapters | Lock Helpers - Adapters}
|
|
45
45
|
*/
|
|
46
46
|
declare abstract class BaseRedisLocker implements Locker {
|
|
47
|
-
protected readonly
|
|
47
|
+
protected readonly keyPrefix: string;
|
|
48
48
|
protected readonly ttl: number;
|
|
49
49
|
protected readonly timeout: number;
|
|
50
50
|
protected readonly retryInterval: number;
|
|
@@ -12,7 +12,7 @@ interface BaseRedisLockerOptions {
|
|
|
12
12
|
*
|
|
13
13
|
* @default ''
|
|
14
14
|
*/
|
|
15
|
-
prefix?: string;
|
|
15
|
+
prefix?: string | undefined;
|
|
16
16
|
/**
|
|
17
17
|
* How long a lock is held before it expires automatically, in milliseconds.
|
|
18
18
|
* Guards against holders that never release the lock, such as a crashed process.
|
|
@@ -25,14 +25,14 @@ interface BaseRedisLockerOptions {
|
|
|
25
25
|
*
|
|
26
26
|
* @default 10000
|
|
27
27
|
*/
|
|
28
|
-
timeout?: number;
|
|
28
|
+
timeout?: number | undefined;
|
|
29
29
|
/**
|
|
30
30
|
* How long to wait between acquisition attempts while the lock
|
|
31
31
|
* is held by someone else, in milliseconds.
|
|
32
32
|
*
|
|
33
33
|
* @default 100
|
|
34
34
|
*/
|
|
35
|
-
retryInterval?: number;
|
|
35
|
+
retryInterval?: number | undefined;
|
|
36
36
|
}
|
|
37
37
|
/**
|
|
38
38
|
* Base class for Redis-backed locker adapters. It owns the key naming, the lock
|
|
@@ -44,7 +44,7 @@ interface BaseRedisLockerOptions {
|
|
|
44
44
|
* @see {@link https://orpc.dev/docs/helpers/lock#adapters | Lock Helpers - Adapters}
|
|
45
45
|
*/
|
|
46
46
|
declare abstract class BaseRedisLocker implements Locker {
|
|
47
|
-
protected readonly
|
|
47
|
+
protected readonly keyPrefix: string;
|
|
48
48
|
protected readonly ttl: number;
|
|
49
49
|
protected readonly timeout: number;
|
|
50
50
|
protected readonly retryInterval: number;
|
|
@@ -9,18 +9,18 @@ end
|
|
|
9
9
|
return 0
|
|
10
10
|
`;
|
|
11
11
|
class BaseRedisLocker {
|
|
12
|
-
|
|
12
|
+
keyPrefix;
|
|
13
13
|
ttl;
|
|
14
14
|
timeout;
|
|
15
15
|
retryInterval;
|
|
16
16
|
constructor(options) {
|
|
17
|
-
this.
|
|
17
|
+
this.keyPrefix = options.prefix ?? "";
|
|
18
18
|
this.ttl = options.ttl;
|
|
19
19
|
this.timeout = options.timeout ?? 1e4;
|
|
20
20
|
this.retryInterval = options.retryInterval ?? 100;
|
|
21
21
|
}
|
|
22
22
|
async lock(key, fn, options = {}) {
|
|
23
|
-
const prefixedKey = `${this.
|
|
23
|
+
const prefixedKey = `${this.keyPrefix}${key}`;
|
|
24
24
|
const ttl = options.ttl ?? this.ttl;
|
|
25
25
|
const deadline = Date.now() + (options.timeout ?? this.timeout);
|
|
26
26
|
const token = crypto.randomUUID();
|
|
@@ -9,14 +9,14 @@ interface MemoryLockerOptions {
|
|
|
9
9
|
*
|
|
10
10
|
* @default undefined (held until released)
|
|
11
11
|
*/
|
|
12
|
-
ttl?: number;
|
|
12
|
+
ttl?: number | undefined;
|
|
13
13
|
/**
|
|
14
14
|
* How long to wait for a lock to become available, in milliseconds.
|
|
15
15
|
* Can be overridden per call.
|
|
16
16
|
*
|
|
17
17
|
* @default 10000
|
|
18
18
|
*/
|
|
19
|
-
timeout?: number;
|
|
19
|
+
timeout?: number | undefined;
|
|
20
20
|
}
|
|
21
21
|
/**
|
|
22
22
|
* Locker adapter backed by in-memory storage, so locks are only shared within
|
|
@@ -9,14 +9,14 @@ interface MemoryLockerOptions {
|
|
|
9
9
|
*
|
|
10
10
|
* @default undefined (held until released)
|
|
11
11
|
*/
|
|
12
|
-
ttl?: number;
|
|
12
|
+
ttl?: number | undefined;
|
|
13
13
|
/**
|
|
14
14
|
* How long to wait for a lock to become available, in milliseconds.
|
|
15
15
|
* Can be overridden per call.
|
|
16
16
|
*
|
|
17
17
|
* @default 10000
|
|
18
18
|
*/
|
|
19
|
-
timeout?: number;
|
|
19
|
+
timeout?: number | undefined;
|
|
20
20
|
}
|
|
21
21
|
/**
|
|
22
22
|
* Locker adapter backed by in-memory storage, so locks are only shared within
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { RedisClientType } from 'redis';
|
|
2
2
|
import { BaseRedisLocker, BaseRedisLockerOptions } from './base-redis.mjs';
|
|
3
3
|
import '@orpc/shared';
|
|
4
|
-
import '../shared/experimental-lock.
|
|
4
|
+
import '../shared/experimental-lock.D9u4cJfq.mjs';
|
|
5
5
|
|
|
6
6
|
/**
|
|
7
7
|
* Locker adapter for Redis. Acquires locks with `SET NX PX` and releases them
|
|
@@ -12,7 +12,14 @@ import '../shared/experimental-lock.D48ZxIcJ.mjs';
|
|
|
12
12
|
*/
|
|
13
13
|
declare class RedisLocker extends BaseRedisLocker {
|
|
14
14
|
private readonly redis;
|
|
15
|
+
private readonly options;
|
|
15
16
|
constructor(redis: RedisClientType<any, any, any, any, any>, options: BaseRedisLockerOptions);
|
|
17
|
+
/**
|
|
18
|
+
* Creates a locker with `prefix` appended to this locker's prefix, sharing its Redis client.
|
|
19
|
+
*
|
|
20
|
+
* @see {@link https://orpc.dev/docs/helpers/lock#adapters | Lock Helpers - Adapters}
|
|
21
|
+
*/
|
|
22
|
+
prefix(prefix: string): RedisLocker;
|
|
16
23
|
protected acquire(key: string, token: string, ttl: number): Promise<boolean>;
|
|
17
24
|
protected evalScript(script: string, keys: string[], args: string[]): Promise<unknown>;
|
|
18
25
|
private connectIfNeeded;
|
package/dist/adapters/redis.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { RedisClientType } from 'redis';
|
|
2
2
|
import { BaseRedisLocker, BaseRedisLockerOptions } from './base-redis.js';
|
|
3
3
|
import '@orpc/shared';
|
|
4
|
-
import '../shared/experimental-lock.
|
|
4
|
+
import '../shared/experimental-lock.D9u4cJfq.js';
|
|
5
5
|
|
|
6
6
|
/**
|
|
7
7
|
* Locker adapter for Redis. Acquires locks with `SET NX PX` and releases them
|
|
@@ -12,7 +12,14 @@ import '../shared/experimental-lock.D48ZxIcJ.js';
|
|
|
12
12
|
*/
|
|
13
13
|
declare class RedisLocker extends BaseRedisLocker {
|
|
14
14
|
private readonly redis;
|
|
15
|
+
private readonly options;
|
|
15
16
|
constructor(redis: RedisClientType<any, any, any, any, any>, options: BaseRedisLockerOptions);
|
|
17
|
+
/**
|
|
18
|
+
* Creates a locker with `prefix` appended to this locker's prefix, sharing its Redis client.
|
|
19
|
+
*
|
|
20
|
+
* @see {@link https://orpc.dev/docs/helpers/lock#adapters | Lock Helpers - Adapters}
|
|
21
|
+
*/
|
|
22
|
+
prefix(prefix: string): RedisLocker;
|
|
16
23
|
protected acquire(key: string, token: string, ttl: number): Promise<boolean>;
|
|
17
24
|
protected evalScript(script: string, keys: string[], args: string[]): Promise<unknown>;
|
|
18
25
|
private connectIfNeeded;
|
package/dist/adapters/redis.mjs
CHANGED
|
@@ -6,6 +6,15 @@ class RedisLocker extends BaseRedisLocker {
|
|
|
6
6
|
constructor(redis, options) {
|
|
7
7
|
super(options);
|
|
8
8
|
this.redis = redis;
|
|
9
|
+
this.options = options;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Creates a locker with `prefix` appended to this locker's prefix, sharing its Redis client.
|
|
13
|
+
*
|
|
14
|
+
* @see {@link https://orpc.dev/docs/helpers/lock#adapters | Lock Helpers - Adapters}
|
|
15
|
+
*/
|
|
16
|
+
prefix(prefix) {
|
|
17
|
+
return new RedisLocker(this.redis, { ...this.options, prefix: `${this.keyPrefix}${prefix}` });
|
|
9
18
|
}
|
|
10
19
|
async acquire(key, token, ttl) {
|
|
11
20
|
await this.connectIfNeeded();
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { Redis } from '@upstash/redis';
|
|
2
2
|
import { BaseRedisLocker, BaseRedisLockerOptions } from './base-redis.mjs';
|
|
3
3
|
import '@orpc/shared';
|
|
4
|
-
import '../shared/experimental-lock.
|
|
4
|
+
import '../shared/experimental-lock.D9u4cJfq.mjs';
|
|
5
5
|
|
|
6
6
|
/**
|
|
7
7
|
* Locker adapter for Upstash Redis. Acquires locks with `SET NX PX` and releases
|
|
@@ -12,7 +12,14 @@ import '../shared/experimental-lock.D48ZxIcJ.mjs';
|
|
|
12
12
|
*/
|
|
13
13
|
declare class UpstashLocker extends BaseRedisLocker {
|
|
14
14
|
private readonly redis;
|
|
15
|
+
private readonly options;
|
|
15
16
|
constructor(redis: Redis, options: BaseRedisLockerOptions);
|
|
17
|
+
/**
|
|
18
|
+
* Creates a locker with `prefix` appended to this locker's prefix, sharing its Redis client.
|
|
19
|
+
*
|
|
20
|
+
* @see {@link https://orpc.dev/docs/helpers/lock#adapters | Lock Helpers - Adapters}
|
|
21
|
+
*/
|
|
22
|
+
prefix(prefix: string): UpstashLocker;
|
|
16
23
|
protected acquire(key: string, token: string, ttl: number): Promise<boolean>;
|
|
17
24
|
protected evalScript(script: string, keys: string[], args: string[]): Promise<unknown>;
|
|
18
25
|
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { Redis } from '@upstash/redis';
|
|
2
2
|
import { BaseRedisLocker, BaseRedisLockerOptions } from './base-redis.js';
|
|
3
3
|
import '@orpc/shared';
|
|
4
|
-
import '../shared/experimental-lock.
|
|
4
|
+
import '../shared/experimental-lock.D9u4cJfq.js';
|
|
5
5
|
|
|
6
6
|
/**
|
|
7
7
|
* Locker adapter for Upstash Redis. Acquires locks with `SET NX PX` and releases
|
|
@@ -12,7 +12,14 @@ import '../shared/experimental-lock.D48ZxIcJ.js';
|
|
|
12
12
|
*/
|
|
13
13
|
declare class UpstashLocker extends BaseRedisLocker {
|
|
14
14
|
private readonly redis;
|
|
15
|
+
private readonly options;
|
|
15
16
|
constructor(redis: Redis, options: BaseRedisLockerOptions);
|
|
17
|
+
/**
|
|
18
|
+
* Creates a locker with `prefix` appended to this locker's prefix, sharing its Redis client.
|
|
19
|
+
*
|
|
20
|
+
* @see {@link https://orpc.dev/docs/helpers/lock#adapters | Lock Helpers - Adapters}
|
|
21
|
+
*/
|
|
22
|
+
prefix(prefix: string): UpstashLocker;
|
|
16
23
|
protected acquire(key: string, token: string, ttl: number): Promise<boolean>;
|
|
17
24
|
protected evalScript(script: string, keys: string[], args: string[]): Promise<unknown>;
|
|
18
25
|
}
|
|
@@ -6,6 +6,15 @@ class UpstashLocker extends BaseRedisLocker {
|
|
|
6
6
|
constructor(redis, options) {
|
|
7
7
|
super(options);
|
|
8
8
|
this.redis = redis;
|
|
9
|
+
this.options = options;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Creates a locker with `prefix` appended to this locker's prefix, sharing its Redis client.
|
|
13
|
+
*
|
|
14
|
+
* @see {@link https://orpc.dev/docs/helpers/lock#adapters | Lock Helpers - Adapters}
|
|
15
|
+
*/
|
|
16
|
+
prefix(prefix) {
|
|
17
|
+
return new UpstashLocker(this.redis, { ...this.options, prefix: `${this.keyPrefix}${prefix}` });
|
|
9
18
|
}
|
|
10
19
|
async acquire(key, token, ttl) {
|
|
11
20
|
const result = await this.redis.set(key, token, { nx: true, px: ttl });
|
package/dist/index.d.mts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { Context, MiddlewareOptions, Middleware } from '@orpc/server';
|
|
2
2
|
import { Value, Promisable } from '@orpc/shared';
|
|
3
|
-
import { L as Locker } from './shared/experimental-lock.
|
|
4
|
-
export { a as LockCallbackOptions, b as LockOptions } from './shared/experimental-lock.
|
|
3
|
+
import { L as Locker } from './shared/experimental-lock.D9u4cJfq.mjs';
|
|
4
|
+
export { a as LockCallbackOptions, b as LockOptions } from './shared/experimental-lock.D9u4cJfq.mjs';
|
|
5
5
|
|
|
6
6
|
/**
|
|
7
7
|
* Thrown when a lock cannot be acquired before the timeout elapses.
|
|
@@ -50,13 +50,13 @@ interface LockMiddlewareOptions<TInContext extends Context, TInput> {
|
|
|
50
50
|
*
|
|
51
51
|
* @default the adapter default
|
|
52
52
|
*/
|
|
53
|
-
ttl?: Value<Promisable<number | undefined>, [options: MiddlewareOptions<TInContext, unknown, Record<never, never>>, input: TInput]
|
|
53
|
+
ttl?: Value<Promisable<number | undefined>, [options: MiddlewareOptions<TInContext, unknown, Record<never, never>>, input: TInput]> | undefined;
|
|
54
54
|
/**
|
|
55
55
|
* How long to wait for the lock to become available, in milliseconds.
|
|
56
56
|
*
|
|
57
57
|
* @default the adapter default
|
|
58
58
|
*/
|
|
59
|
-
timeout?: Value<Promisable<number | undefined>, [options: MiddlewareOptions<TInContext, unknown, Record<never, never>>, input: TInput]
|
|
59
|
+
timeout?: Value<Promisable<number | undefined>, [options: MiddlewareOptions<TInContext, unknown, Record<never, never>>, input: TInput]> | undefined;
|
|
60
60
|
/**
|
|
61
61
|
* If your lock middleware is used multiple times
|
|
62
62
|
* or you invoke a procedure inside another procedure (shared the same context) that also has
|
|
@@ -66,7 +66,7 @@ interface LockMiddlewareOptions<TInContext extends Context, TInput> {
|
|
|
66
66
|
*
|
|
67
67
|
* @default true
|
|
68
68
|
*/
|
|
69
|
-
dedupe?: boolean;
|
|
69
|
+
dedupe?: boolean | undefined;
|
|
70
70
|
}
|
|
71
71
|
/**
|
|
72
72
|
* Creates a middleware that runs oRPC procedures under a lock, so that calls
|
package/dist/index.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { Context, MiddlewareOptions, Middleware } from '@orpc/server';
|
|
2
2
|
import { Value, Promisable } from '@orpc/shared';
|
|
3
|
-
import { L as Locker } from './shared/experimental-lock.
|
|
4
|
-
export { a as LockCallbackOptions, b as LockOptions } from './shared/experimental-lock.
|
|
3
|
+
import { L as Locker } from './shared/experimental-lock.D9u4cJfq.js';
|
|
4
|
+
export { a as LockCallbackOptions, b as LockOptions } from './shared/experimental-lock.D9u4cJfq.js';
|
|
5
5
|
|
|
6
6
|
/**
|
|
7
7
|
* Thrown when a lock cannot be acquired before the timeout elapses.
|
|
@@ -50,13 +50,13 @@ interface LockMiddlewareOptions<TInContext extends Context, TInput> {
|
|
|
50
50
|
*
|
|
51
51
|
* @default the adapter default
|
|
52
52
|
*/
|
|
53
|
-
ttl?: Value<Promisable<number | undefined>, [options: MiddlewareOptions<TInContext, unknown, Record<never, never>>, input: TInput]
|
|
53
|
+
ttl?: Value<Promisable<number | undefined>, [options: MiddlewareOptions<TInContext, unknown, Record<never, never>>, input: TInput]> | undefined;
|
|
54
54
|
/**
|
|
55
55
|
* How long to wait for the lock to become available, in milliseconds.
|
|
56
56
|
*
|
|
57
57
|
* @default the adapter default
|
|
58
58
|
*/
|
|
59
|
-
timeout?: Value<Promisable<number | undefined>, [options: MiddlewareOptions<TInContext, unknown, Record<never, never>>, input: TInput]
|
|
59
|
+
timeout?: Value<Promisable<number | undefined>, [options: MiddlewareOptions<TInContext, unknown, Record<never, never>>, input: TInput]> | undefined;
|
|
60
60
|
/**
|
|
61
61
|
* If your lock middleware is used multiple times
|
|
62
62
|
* or you invoke a procedure inside another procedure (shared the same context) that also has
|
|
@@ -66,7 +66,7 @@ interface LockMiddlewareOptions<TInContext extends Context, TInput> {
|
|
|
66
66
|
*
|
|
67
67
|
* @default true
|
|
68
68
|
*/
|
|
69
|
-
dedupe?: boolean;
|
|
69
|
+
dedupe?: boolean | undefined;
|
|
70
70
|
}
|
|
71
71
|
/**
|
|
72
72
|
* Creates a middleware that runs oRPC procedures under a lock, so that calls
|
|
@@ -7,17 +7,17 @@ interface LockOptions {
|
|
|
7
7
|
*
|
|
8
8
|
* @default the adapter default
|
|
9
9
|
*/
|
|
10
|
-
ttl?: number;
|
|
10
|
+
ttl?: number | undefined;
|
|
11
11
|
/**
|
|
12
12
|
* How long to wait for the lock to become available, in milliseconds.
|
|
13
13
|
*
|
|
14
14
|
* @default the adapter default
|
|
15
15
|
*/
|
|
16
|
-
timeout?: number;
|
|
16
|
+
timeout?: number | undefined;
|
|
17
17
|
/**
|
|
18
18
|
* Aborts waiting for the lock. Has no effect once the lock is acquired.
|
|
19
19
|
*/
|
|
20
|
-
signal?: AbortSignal;
|
|
20
|
+
signal?: AbortSignal | undefined;
|
|
21
21
|
}
|
|
22
22
|
interface LockCallbackOptions {
|
|
23
23
|
/**
|
|
@@ -7,17 +7,17 @@ interface LockOptions {
|
|
|
7
7
|
*
|
|
8
8
|
* @default the adapter default
|
|
9
9
|
*/
|
|
10
|
-
ttl?: number;
|
|
10
|
+
ttl?: number | undefined;
|
|
11
11
|
/**
|
|
12
12
|
* How long to wait for the lock to become available, in milliseconds.
|
|
13
13
|
*
|
|
14
14
|
* @default the adapter default
|
|
15
15
|
*/
|
|
16
|
-
timeout?: number;
|
|
16
|
+
timeout?: number | undefined;
|
|
17
17
|
/**
|
|
18
18
|
* Aborts waiting for the lock. Has no effect once the lock is acquired.
|
|
19
19
|
*/
|
|
20
|
-
signal?: AbortSignal;
|
|
20
|
+
signal?: AbortSignal | undefined;
|
|
21
21
|
}
|
|
22
22
|
interface LockCallbackOptions {
|
|
23
23
|
/**
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@orpc/experimental-lock",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "2.0.0-beta.
|
|
4
|
+
"version": "2.0.0-beta.46",
|
|
5
5
|
"description": "Locking for oRPC procedures, with memory, Redis, and Upstash adapters",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"funding": [
|
|
@@ -70,8 +70,8 @@
|
|
|
70
70
|
}
|
|
71
71
|
},
|
|
72
72
|
"dependencies": {
|
|
73
|
-
"@orpc/server": "2.0.0-beta.
|
|
74
|
-
"@orpc/shared": "2.0.0-beta.
|
|
73
|
+
"@orpc/server": "2.0.0-beta.46",
|
|
74
|
+
"@orpc/shared": "2.0.0-beta.46"
|
|
75
75
|
},
|
|
76
76
|
"devDependencies": {
|
|
77
77
|
"@upstash/redis": "^1.39.0",
|