@guren/server 2.21.0 → 2.23.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 (115) hide show
  1. package/dist/Job-BxioDEcS.js +165 -0
  2. package/dist/{Logger-DFifRAtc.js → Logger-DWXdtLSJ.js} +62 -2
  3. package/dist/agent/approval-status.d.ts +1 -1
  4. package/dist/agent/approval.d.ts +2 -2
  5. package/dist/agent/audit-emitter.d.ts +11 -1
  6. package/dist/agent/gate.d.ts +10 -8
  7. package/dist/agent/meta-tools.d.ts +13 -5
  8. package/dist/agent/pipeline.d.ts +10 -9
  9. package/dist/auth/AuthManager.d.ts +29 -0
  10. package/dist/auth/AuthenticatableModel.d.ts +15 -0
  11. package/dist/auth/RequestAuthContext.d.ts +10 -1
  12. package/dist/auth/SessionGuard.d.ts +2 -0
  13. package/dist/auth/api-token.d.ts +6 -0
  14. package/dist/auth/context.d.ts +32 -0
  15. package/dist/auth/index.d.ts +7 -0
  16. package/dist/auth/index.js +2 -2
  17. package/dist/auth/model-capability.d.ts +8 -0
  18. package/dist/auth/oauth/index.d.ts +5 -0
  19. package/dist/auth/password/DefaultHasher.d.ts +17 -6
  20. package/dist/auth/password/configured-hasher.d.ts +23 -0
  21. package/dist/auth/providers/ModelUserProvider.d.ts +3 -0
  22. package/dist/auth/providers/unconfigured-user-provider.d.ts +12 -0
  23. package/dist/auth/types.d.ts +9 -0
  24. package/dist/{auth-CjE2oO50.js → auth-D_W1cJp3.js} +279 -84
  25. package/dist/authorization/Gate.d.ts +12 -0
  26. package/dist/authorization/index.js +1 -1
  27. package/dist/{authorization-CdEWZZw3.js → authorization-0mCGUFoI.js} +58 -12
  28. package/dist/broadcasting/BroadcastManager.d.ts +10 -0
  29. package/dist/broadcasting/index.js +1 -1
  30. package/dist/{broadcasting-B5RzB0A2.js → broadcasting-BdJnaq1O.js} +17 -3
  31. package/dist/cache/index.js +1 -1
  32. package/dist/{cache-thXRnaju.js → cache-DikxP7Bk.js} +1 -1
  33. package/dist/container/Container.d.ts +18 -1
  34. package/dist/container/bindings.d.ts +9 -4
  35. package/dist/container/index.d.ts +4 -2
  36. package/dist/container/resolve-optional.d.ts +10 -0
  37. package/dist/context-af2n5abO.js +91 -0
  38. package/dist/{Job-CvDwk2Gj.js → default-application-Chbrul_m.js} +126 -82
  39. package/dist/encryption/Encrypter.d.ts +10 -0
  40. package/dist/encryption/index.js +1 -1
  41. package/dist/{encryption-uwP3Di4D.js → encryption-BRjZnshr.js} +23 -5
  42. package/dist/errors/ExceptionHandler.d.ts +10 -0
  43. package/dist/events/Event.d.ts +18 -0
  44. package/dist/events/EventManager.d.ts +56 -4
  45. package/dist/events/index.d.ts +2 -1
  46. package/dist/events/index.js +2 -2
  47. package/dist/events/queued.d.ts +8 -0
  48. package/dist/events/serialize.d.ts +8 -0
  49. package/dist/events/types.d.ts +19 -2
  50. package/dist/events-C86rS63h.js +428 -0
  51. package/dist/health/checks/CacheCheck.d.ts +3 -5
  52. package/dist/health/checks/StorageCheck.d.ts +3 -5
  53. package/dist/health/index.js +1 -1
  54. package/dist/{health-DQSvUplL.js → health-CB0oS_UE.js} +2 -2
  55. package/dist/http/Application.d.ts +28 -0
  56. package/dist/http/default-application.d.ts +33 -0
  57. package/dist/http/middleware/detect-locale.d.ts +2 -1
  58. package/dist/http/request-container.d.ts +25 -0
  59. package/dist/i18n/I18nManager.d.ts +16 -3
  60. package/dist/i18n/index.d.ts +1 -1
  61. package/dist/i18n/index.js +2 -2
  62. package/dist/{i18n-BZ2VrSud.js → i18n-DRo1g0AN.js} +34 -10
  63. package/dist/index.d.ts +16 -11
  64. package/dist/index.js +248 -129
  65. package/dist/lambda/index.js +1 -1
  66. package/dist/logging/LogManager.d.ts +9 -0
  67. package/dist/logging/index.js +2 -2
  68. package/dist/{logging-DXmqqUl4.js → logging-CXotojgW.js} +17 -4
  69. package/dist/mail/Mail.d.ts +14 -1
  70. package/dist/mail/MailManager.d.ts +10 -2
  71. package/dist/mail/index.js +1 -1
  72. package/dist/{mail-9CrvJyBZ.js → mail-CmxO2Ttx.js} +42 -11
  73. package/dist/mvc/Controller.d.ts +1 -1
  74. package/dist/mvc/Router.d.ts +16 -5
  75. package/dist/mvc/inertia/InertiaEngine.d.ts +24 -3
  76. package/dist/mvc/inertia/shared.d.ts +7 -0
  77. package/dist/notifications/NotificationManager.d.ts +15 -0
  78. package/dist/notifications/index.js +1 -1
  79. package/dist/{notifications-D0VXkFLF.js → notifications-CE3U7uyg.js} +24 -5
  80. package/dist/providers/AuthServiceProvider.d.ts +5 -4
  81. package/dist/providers/AuthorizationServiceProvider.d.ts +2 -2
  82. package/dist/providers/BroadcastServiceProvider.d.ts +4 -1
  83. package/dist/providers/EncryptionServiceProvider.d.ts +7 -1
  84. package/dist/providers/EventServiceProvider.d.ts +1 -0
  85. package/dist/providers/LogServiceProvider.d.ts +6 -1
  86. package/dist/providers/MailServiceProvider.d.ts +7 -1
  87. package/dist/providers/NotificationServiceProvider.d.ts +4 -1
  88. package/dist/queue/Job.d.ts +39 -0
  89. package/dist/queue/QueueManager.d.ts +14 -5
  90. package/dist/queue/Worker.d.ts +2 -1
  91. package/dist/queue/index.d.ts +1 -1
  92. package/dist/queue/index.js +3 -3
  93. package/dist/queue/types.d.ts +7 -0
  94. package/dist/{queue-zPPYZdif.js → queue-B3x_RKnB.js} +24 -10
  95. package/dist/redis/RedisSchedulerLock.d.ts +17 -0
  96. package/dist/redis/index.d.ts +2 -0
  97. package/dist/redis/index.js +21 -1
  98. package/dist/runtime/index.js +1 -1
  99. package/dist/scheduling/MemorySchedulerLock.d.ts +16 -0
  100. package/dist/scheduling/ScheduledTask.d.ts +19 -2
  101. package/dist/scheduling/Scheduler.d.ts +25 -0
  102. package/dist/scheduling/index.d.ts +2 -1
  103. package/dist/scheduling/index.js +2 -2
  104. package/dist/scheduling/types.d.ts +26 -2
  105. package/dist/{scheduling-C6tcOtUl.js → scheduling-DudNXGnh.js} +178 -20
  106. package/dist/storage/index.js +1 -1
  107. package/dist/{storage-D_yNe54O.js → storage-6HLaUf9j.js} +2 -13
  108. package/dist/support/deprecate.d.ts +16 -0
  109. package/dist/support/keep-alive.d.ts +26 -0
  110. package/dist/support/request-deferrer.d.ts +10 -0
  111. package/dist/{vite-manifest-CdfPfQdj.js → vite-manifest-B8720V7w.js} +1 -1
  112. package/dist/warn-once-p-IlMjra.js +13 -0
  113. package/package.json +3 -2
  114. package/dist/context-CXk_umpT.js +0 -21
  115. package/dist/events-DOmAHDeP.js +0 -230
@@ -1,20 +1,9 @@
1
1
  import { t as trimSlashes } from "./trim-slashes-BLY9hKAa.js";
2
+ import { t as warnOnce } from "./warn-once-p-IlMjra.js";
2
3
  import { dirname, join, resolve, sep } from "node:path";
3
4
  import { copyFile, mkdir, open, readFile, readdir, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
4
5
  import { existsSync } from "node:fs";
5
6
  import { Readable } from "node:stream";
6
- //#region src/support/warn-once.ts
7
- const warned = /* @__PURE__ */ new Set();
8
- /**
9
- * Warn the first time a key is seen in this process: loud enough to be read
10
- * once, quiet enough not to drown a request log.
11
- */
12
- function warnOnce(key, message) {
13
- if (warned.has(key)) return;
14
- warned.add(key);
15
- console.warn(message);
16
- }
17
- //#endregion
18
7
  //#region src/storage/drivers/LocalDriver.ts
19
8
  var LocalDriver = class {
20
9
  root;
@@ -775,4 +764,4 @@ function createStorageManager(config) {
775
764
  return new StorageManager(config);
776
765
  }
777
766
  //#endregion
778
- export { LocalDriver as a, S3Driver as i, createStorageManager as n, warnOnce as o, MemoryDriver as r, StorageManager as t };
767
+ export { LocalDriver as a, S3Driver as i, createStorageManager as n, MemoryDriver as r, StorageManager as t };
@@ -0,0 +1,16 @@
1
+ /** RFC 0023 §5: the module-level service slots, split by direction. */
2
+ export declare const GLOBAL_SERVICE_SETTERS = "global-service-setters";
3
+ export declare const GLOBAL_SERVICE_GETTERS = "global-service-getters";
4
+ /**
5
+ * @internal The deprecation policy's warning format
6
+ * (`contributing/deprecation-policy.md`), keyed per symbol so one deprecated
7
+ * call does not silence its siblings.
8
+ */
9
+ export declare function warnDeprecated(id: string, symbol: string, replacement: string, versions?: {
10
+ since: string;
11
+ removedIn: string;
12
+ }): void;
13
+ /** @internal */
14
+ export declare function warnDeprecatedSetter(symbol: string): void;
15
+ /** @internal */
16
+ export declare function warnDeprecatedGetter(symbol: string): void;
@@ -0,0 +1,26 @@
1
+ /**
2
+ * How a best-effort side channel (an audit sink, an approval notification, an
3
+ * async log channel) is invoked so that it can neither fail the call it was
4
+ * only recording nor be lost by the runtime. Three orderings have to hold
5
+ * together, and each is wrong in a way tests off Workers cannot see: a
6
+ * synchronous throw and a rejection both reach `onFailure`; the `.catch` is
7
+ * attached *before* deferring, since `waitUntil` on a rejecting promise raises
8
+ * an unhandled rejection in workerd; and `defer` itself throws there once the
9
+ * response has settled.
10
+ */
11
+ import { type Deferrer } from './request-deferrer.js';
12
+ export type { Deferrer };
13
+ /** One best-effort side channel, as {@link keepAlive} invokes it. */
14
+ export interface BestEffortChannel {
15
+ run: () => void | PromiseLike<unknown>;
16
+ onFailure: (error: unknown) => void;
17
+ /** Completes "<label> could not be deferred", so pass a noun phrase. */
18
+ label: string;
19
+ }
20
+ /**
21
+ * `defer` defaults to the deferrer of the Workers request being served, where
22
+ * an undeferred channel is abandoned with the request context; `waitUntil`
23
+ * keeps it alive past the response. Outside a request, and on every other
24
+ * runtime, there is none and the channel is fire-and-forget.
25
+ */
26
+ export declare function keepAlive(channel: BestEffortChannel, defer?: Deferrer | undefined): void;
@@ -0,0 +1,10 @@
1
+ /** `ExecutionContext.waitUntil`, bound to its context. */
2
+ export type Deferrer = (work: Promise<unknown>) => void;
3
+ /**
4
+ * `ctx` is typed `unknown` because `app.fetch`'s third argument is a cast
5
+ * wherever it arrives from. One without a callable `waitUntil` (every runtime
6
+ * but Workers) enters no scope, so a nested call keeps the outer request's.
7
+ */
8
+ export declare function runInRequestScope<T>(ctx: unknown, fn: () => T): T;
9
+ /** The deferrer of the request this code runs for, when one was entered. */
10
+ export declare function requestDeferrer(): Deferrer | undefined;
@@ -34,7 +34,7 @@ function parseImportMap(value, options = {}) {
34
34
  const DEFAULT_DEV_STYLES_ENTRY = "/resources/css/app.css";
35
35
  //#endregion
36
36
  //#region package.json
37
- var version = "2.21.0";
37
+ var version = "2.23.0";
38
38
  //#endregion
39
39
  //#region src/http/dev-banner.ts
40
40
  figlet.parseFont("Standard", standard);
@@ -0,0 +1,13 @@
1
+ //#region src/support/warn-once.ts
2
+ const warned = /* @__PURE__ */ new Set();
3
+ /**
4
+ * Warn the first time a key is seen in this process: loud enough to be read
5
+ * once, quiet enough not to drown a request log.
6
+ */
7
+ function warnOnce(key, message) {
8
+ if (warned.has(key)) return;
9
+ warned.add(key);
10
+ console.warn(message);
11
+ }
12
+ //#endregion
13
+ export { warnOnce as t };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@guren/server",
3
- "version": "2.21.0",
3
+ "version": "2.23.0",
4
4
  "type": "module",
5
5
  "sideEffects": false,
6
6
  "license": "MIT",
@@ -142,7 +142,7 @@
142
142
  "test": "bun test"
143
143
  },
144
144
  "dependencies": {
145
- "@guren/orm": "^2.7.1",
145
+ "@guren/orm": "^2.9.0",
146
146
  "@modelcontextprotocol/sdk": "^1.30.0",
147
147
  "chalk": "^5.3.0",
148
148
  "consola": "^3.4.2",
@@ -176,6 +176,7 @@
176
176
  "@types/ioredis": "^5.0.0",
177
177
  "@types/node": "^20.14.10",
178
178
  "@types/nodemailer": "^8.0.1",
179
+ "miniflare": "5.20260801.1-alpha",
179
180
  "tsdown": "^0.22.14",
180
181
  "typescript": "^7.0.2",
181
182
  "vite": "^8.0.0"
@@ -1,21 +0,0 @@
1
- //#region src/auth/context.ts
2
- /**
3
- * Context key the framework auth context is stored under.
4
- *
5
- * Lives here rather than in `http/middleware/auth` so that `auth/` modules can
6
- * import it without reaching back into the middleware layer. The middleware
7
- * re-exports it, and it stays a public root export.
8
- */
9
- const AUTH_CONTEXT_KEY = "guren:auth";
10
- /**
11
- * Read the framework auth context off a request context. `ctx.get` returns
12
- * arbitrary values for unknown keys, so the cast is a claim, not a check. A
13
- * caller whose behavior turns on a real auth context probes the member it is
14
- * about to call, as `Gate.resolveUser` does before its legacy `ctx.get('user')`
15
- * fallback; probing here would reject contexts `requireAuthenticated` can use.
16
- */
17
- function getAuthContext(ctx) {
18
- return ctx.get(AUTH_CONTEXT_KEY);
19
- }
20
- //#endregion
21
- export { getAuthContext as n, AUTH_CONTEXT_KEY as t };
@@ -1,230 +0,0 @@
1
- //#region src/events/Event.ts
2
- /** Base class for all application events. */
3
- var Event = class {
4
- timestamp = /* @__PURE__ */ new Date();
5
- static get eventName() {
6
- return this.name;
7
- }
8
- get eventName() {
9
- return this.constructor.eventName;
10
- }
11
- };
12
- //#endregion
13
- //#region src/events/EventManager.ts
14
- /** Registers listeners and emits events. */
15
- var EventManager = class {
16
- listeners = /* @__PURE__ */ new Map();
17
- queueDispatcher;
18
- on(event, listener, options = {}) {
19
- const eventName = typeof event === "string" ? event : event.eventName;
20
- const registeredListeners = this.listeners.get(eventName) ?? [];
21
- const registered = {
22
- listener,
23
- options: {
24
- once: false,
25
- priority: 0,
26
- ...options
27
- }
28
- };
29
- registeredListeners.push(registered);
30
- registeredListeners.sort((a, b) => (b.options.priority ?? 0) - (a.options.priority ?? 0));
31
- this.listeners.set(eventName, registeredListeners);
32
- return { unsubscribe: () => this.off(event, listener) };
33
- }
34
- once(event, listener, options = {}) {
35
- return this.on(event, listener, {
36
- ...options,
37
- once: true
38
- });
39
- }
40
- /** Omitting `listener` removes every listener for the event. */
41
- off(event, listener) {
42
- const eventName = typeof event === "string" ? event : event.eventName;
43
- const registeredListeners = this.listeners.get(eventName);
44
- if (!registeredListeners) return;
45
- if (!listener) {
46
- this.listeners.delete(eventName);
47
- return;
48
- }
49
- const index = registeredListeners.findIndex((r) => r.listener === listener);
50
- if (index !== -1) {
51
- registeredListeners.splice(index, 1);
52
- if (registeredListeners.length === 0) this.listeners.delete(eventName);
53
- }
54
- }
55
- /** Highest priority first, awaited one at a time. */
56
- async emit(event) {
57
- const eventName = event.eventName;
58
- const registeredListeners = this.listeners.get(eventName);
59
- if (!registeredListeners || registeredListeners.length === 0) return;
60
- const listenersToCall = [...registeredListeners];
61
- const toRemove = [];
62
- for (const registered of listenersToCall) {
63
- if (registered.options.queue && this.queueDispatcher) await this.queueDispatcher(registered.options.queue, eventName, event);
64
- else await registered.listener(event);
65
- if (registered.options.once) toRemove.push(registered);
66
- }
67
- for (const registered of toRemove) {
68
- const index = registeredListeners.indexOf(registered);
69
- if (index !== -1) registeredListeners.splice(index, 1);
70
- }
71
- if (registeredListeners.length === 0) this.listeners.delete(eventName);
72
- }
73
- /** {@link emit} without the ordering guarantee. */
74
- async emitParallel(event) {
75
- const eventName = event.eventName;
76
- const registeredListeners = this.listeners.get(eventName);
77
- if (!registeredListeners || registeredListeners.length === 0) return;
78
- const listenersToCall = [...registeredListeners];
79
- const toRemove = [];
80
- await Promise.all(listenersToCall.map(async (registered) => {
81
- if (registered.options.queue && this.queueDispatcher) await this.queueDispatcher(registered.options.queue, eventName, event);
82
- else await registered.listener(event);
83
- if (registered.options.once) toRemove.push(registered);
84
- }));
85
- for (const registered of toRemove) {
86
- const index = registeredListeners.indexOf(registered);
87
- if (index !== -1) registeredListeners.splice(index, 1);
88
- }
89
- if (registeredListeners.length === 0) this.listeners.delete(eventName);
90
- }
91
- hasListeners(event) {
92
- const eventName = typeof event === "string" ? event : event.eventName;
93
- const listeners = this.listeners.get(eventName);
94
- return listeners !== void 0 && listeners.length > 0;
95
- }
96
- getListeners(event) {
97
- const eventName = typeof event === "string" ? event : event.eventName;
98
- const registeredListeners = this.listeners.get(eventName);
99
- if (!registeredListeners) return [];
100
- return registeredListeners.map((r) => r.listener);
101
- }
102
- listenerCount(event) {
103
- const eventName = typeof event === "string" ? event : event.eventName;
104
- return this.listeners.get(eventName)?.length ?? 0;
105
- }
106
- eventNames() {
107
- return Array.from(this.listeners.keys());
108
- }
109
- removeAllListeners() {
110
- this.listeners.clear();
111
- }
112
- /** Called by the Queue system when it is integrated. */
113
- setQueueDispatcher(dispatcher) {
114
- this.queueDispatcher = dispatcher;
115
- }
116
- };
117
- function createEventManager() {
118
- return new EventManager();
119
- }
120
- //#endregion
121
- //#region src/events/Listener.ts
122
- /** Base class for reusable, class-based event listeners. */
123
- var Listener = class {
124
- /** Must be set by subclasses. */
125
- static event;
126
- /** @default false */
127
- static shouldQueue = false;
128
- /**
129
- * Used when `shouldQueue`.
130
- * @default 'default'
131
- */
132
- static queue = "default";
133
- /**
134
- * Higher runs first.
135
- * @default 0
136
- */
137
- static priority = 0;
138
- };
139
- //#endregion
140
- //#region src/events/builtin.ts
141
- var RequestReceived = class extends Event {
142
- method;
143
- path;
144
- requestId;
145
- constructor(method, path, requestId) {
146
- super();
147
- this.method = method;
148
- this.path = path;
149
- this.requestId = requestId;
150
- }
151
- };
152
- var RequestFinished = class extends Event {
153
- method;
154
- path;
155
- status;
156
- durationMs;
157
- requestId;
158
- constructor(method, path, status, durationMs, requestId) {
159
- super();
160
- this.method = method;
161
- this.path = path;
162
- this.status = status;
163
- this.durationMs = durationMs;
164
- this.requestId = requestId;
165
- }
166
- };
167
- var UserAuthenticated = class extends Event {
168
- userId;
169
- guard;
170
- constructor(userId, guard = "default") {
171
- super();
172
- this.userId = userId;
173
- this.guard = guard;
174
- }
175
- };
176
- var UserLoggedOut = class extends Event {
177
- userId;
178
- guard;
179
- constructor(userId, guard = "default") {
180
- super();
181
- this.userId = userId;
182
- this.guard = guard;
183
- }
184
- };
185
- var JobProcessed = class extends Event {
186
- jobId;
187
- jobName;
188
- queue;
189
- durationMs;
190
- constructor(jobId, jobName, queue, durationMs) {
191
- super();
192
- this.jobId = jobId;
193
- this.jobName = jobName;
194
- this.queue = queue;
195
- this.durationMs = durationMs;
196
- }
197
- };
198
- var JobFailed = class extends Event {
199
- jobId;
200
- jobName;
201
- queue;
202
- error;
203
- attempts;
204
- constructor(jobId, jobName, queue, error, attempts) {
205
- super();
206
- this.jobId = jobId;
207
- this.jobName = jobName;
208
- this.queue = queue;
209
- this.error = error;
210
- this.attempts = attempts;
211
- }
212
- };
213
- var ApplicationStarted = class extends Event {
214
- port;
215
- host;
216
- constructor(port, host) {
217
- super();
218
- this.port = port;
219
- this.host = host;
220
- }
221
- };
222
- var ApplicationShutdown = class extends Event {
223
- reason;
224
- constructor(reason) {
225
- super();
226
- this.reason = reason;
227
- }
228
- };
229
- //#endregion
230
- export { RequestFinished as a, UserLoggedOut as c, createEventManager as d, Event as f, JobProcessed as i, Listener as l, ApplicationStarted as n, RequestReceived as o, JobFailed as r, UserAuthenticated as s, ApplicationShutdown as t, EventManager as u };