@geekmidas/constructs 3.1.0 → 4.0.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 (123) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/dist/{AWSScheduledFunction-BnYDnzsF.d.mts → AWSScheduledFunction-COv8bB1v.d.mts} +2 -2
  3. package/dist/{AWSScheduledFunction-BnYDnzsF.d.mts.map → AWSScheduledFunction-COv8bB1v.d.mts.map} +1 -1
  4. package/dist/{AWSScheduledFunction-BRGjgD-i.mjs → AWSScheduledFunction-D-55GfwL.mjs} +3 -3
  5. package/dist/{AWSScheduledFunction-BRGjgD-i.mjs.map → AWSScheduledFunction-D-55GfwL.mjs.map} +1 -1
  6. package/dist/{AWSScheduledFunction-vjanLO3-.d.cts → AWSScheduledFunction-D9uCAd76.d.cts} +2 -2
  7. package/dist/{AWSScheduledFunction-vjanLO3-.d.cts.map → AWSScheduledFunction-D9uCAd76.d.cts.map} +1 -1
  8. package/dist/{AWSScheduledFunction-B3cHQSdp.cjs → AWSScheduledFunction-sWwZC9hg.cjs} +9 -9
  9. package/dist/{AWSScheduledFunction-B3cHQSdp.cjs.map → AWSScheduledFunction-sWwZC9hg.cjs.map} +1 -1
  10. package/dist/{Construct-DXfLPGwg.cjs → Construct-B14miJ6P.cjs} +42 -5
  11. package/dist/{Construct-DXfLPGwg.cjs.map → Construct-B14miJ6P.cjs.map} +1 -1
  12. package/dist/{Construct-CLIPPqUP.mjs → Construct-CdJY2DJS.mjs} +28 -3
  13. package/dist/{Construct-CLIPPqUP.mjs.map → Construct-CdJY2DJS.mjs.map} +1 -1
  14. package/dist/{Construct-BY0NBQLj.d.mts → Construct-D0n7QTaI.d.mts} +1 -1
  15. package/dist/{Construct-BY0NBQLj.d.mts.map → Construct-D0n7QTaI.d.mts.map} +1 -1
  16. package/dist/{Endpoint-4gVYt12g.d.mts → Endpoint-C_qxza6z.d.mts} +3 -3
  17. package/dist/{Endpoint-4gVYt12g.d.mts.map → Endpoint-C_qxza6z.d.mts.map} +1 -1
  18. package/dist/{Endpoint-BlMZIwBY.d.cts → Endpoint-D5SChIsU.d.cts} +2 -2
  19. package/dist/{Endpoint-BlMZIwBY.d.cts.map → Endpoint-D5SChIsU.d.cts.map} +1 -1
  20. package/dist/{HonoEndpointAdaptor-6k-rI44C.mjs → HonoEndpointAdaptor-CWYBGVFQ.mjs} +4 -4
  21. package/dist/{HonoEndpointAdaptor-6k-rI44C.mjs.map → HonoEndpointAdaptor-CWYBGVFQ.mjs.map} +1 -1
  22. package/dist/{HonoEndpointAdaptor-CNIsjEw-.cjs → HonoEndpointAdaptor-C_2jaZ4k.cjs} +17 -17
  23. package/dist/{HonoEndpointAdaptor-CNIsjEw-.cjs.map → HonoEndpointAdaptor-C_2jaZ4k.cjs.map} +1 -1
  24. package/dist/{Subscriber-CjOHxO0l.d.mts → Subscriber-C0v9iOrI.d.mts} +2 -2
  25. package/dist/{Subscriber-CjOHxO0l.d.mts.map → Subscriber-C0v9iOrI.d.mts.map} +1 -1
  26. package/dist/adaptors/aws.cjs +12 -14
  27. package/dist/adaptors/aws.cjs.map +1 -1
  28. package/dist/adaptors/aws.d.cts +3 -3
  29. package/dist/adaptors/aws.d.mts +7 -7
  30. package/dist/adaptors/aws.mjs +6 -8
  31. package/dist/adaptors/aws.mjs.map +1 -1
  32. package/dist/adaptors/hono.cjs +6 -7
  33. package/dist/adaptors/hono.d.cts +2 -2
  34. package/dist/adaptors/hono.d.cts.map +1 -1
  35. package/dist/adaptors/hono.d.mts +4 -4
  36. package/dist/adaptors/hono.d.mts.map +1 -1
  37. package/dist/adaptors/hono.mjs +6 -7
  38. package/dist/adaptors/testing.cjs +12 -14
  39. package/dist/adaptors/testing.cjs.map +1 -1
  40. package/dist/adaptors/testing.d.cts +2 -2
  41. package/dist/adaptors/testing.d.mts +5 -5
  42. package/dist/adaptors/testing.mjs +6 -7
  43. package/dist/adaptors/testing.mjs.map +1 -1
  44. package/dist/crons/index.cjs +6 -7
  45. package/dist/crons/index.cjs.map +1 -1
  46. package/dist/crons/index.d.cts +2 -2
  47. package/dist/crons/index.d.mts +3 -3
  48. package/dist/crons/index.mjs +4 -5
  49. package/dist/crons/index.mjs.map +1 -1
  50. package/dist/endpoints/index.cjs +7 -9
  51. package/dist/endpoints/index.cjs.map +1 -1
  52. package/dist/endpoints/index.d.cts +4 -4
  53. package/dist/endpoints/index.d.mts +4 -4
  54. package/dist/endpoints/index.mjs +4 -6
  55. package/dist/endpoints/index.mjs.map +1 -1
  56. package/dist/functions/index.cjs +2 -2
  57. package/dist/functions/index.d.cts +1 -1
  58. package/dist/functions/index.d.mts +2 -2
  59. package/dist/functions/index.mjs +2 -2
  60. package/dist/{functions-BMR-1CIQ.mjs → functions-C9QhxXoP.mjs} +2 -3
  61. package/dist/{functions-BMR-1CIQ.mjs.map → functions-C9QhxXoP.mjs.map} +1 -1
  62. package/dist/{functions-_OAiwGYh.cjs → functions-cL1XwEHW.cjs} +10 -11
  63. package/dist/{functions-_OAiwGYh.cjs.map → functions-cL1XwEHW.cjs.map} +1 -1
  64. package/dist/{index-DoiHTgUQ.d.mts → index-C0XoazSK.d.mts} +2 -2
  65. package/dist/{index-DoiHTgUQ.d.mts.map → index-C0XoazSK.d.mts.map} +1 -1
  66. package/dist/{index-Dj3uvqCO.d.cts → index-Cg0m0uBN.d.cts} +5 -5
  67. package/dist/{index-Dj3uvqCO.d.cts.map → index-Cg0m0uBN.d.cts.map} +1 -1
  68. package/dist/index.cjs +1 -1
  69. package/dist/index.d.mts +3 -3
  70. package/dist/index.mjs +1 -1
  71. package/dist/{lazyAccessors-D-UHg0YJ.mjs → lazyAccessors-Bnq67EHR.mjs} +834 -9
  72. package/dist/lazyAccessors-Bnq67EHR.mjs.map +1 -0
  73. package/dist/{lazyAccessors-B4rtX68K.cjs → lazyAccessors-DGqzwC-j.cjs} +842 -11
  74. package/dist/lazyAccessors-DGqzwC-j.cjs.map +1 -0
  75. package/dist/{processAudits-CPcACKCA.cjs → processAudits-BmjKsnF7.cjs} +3 -3
  76. package/dist/{processAudits-CPcACKCA.cjs.map → processAudits-BmjKsnF7.cjs.map} +1 -1
  77. package/dist/{processAudits-BEiSkgH3.mjs → processAudits-ySnizdMG.mjs} +1 -1
  78. package/dist/{processAudits-BEiSkgH3.mjs.map → processAudits-ySnizdMG.mjs.map} +1 -1
  79. package/dist/{publisher-CnpeMv-r.mjs → publisher-BrFOF847.mjs} +1 -1
  80. package/dist/{publisher-CnpeMv-r.mjs.map → publisher-BrFOF847.mjs.map} +1 -1
  81. package/dist/{publisher-BZgcrVPy.cjs → publisher-lFQleddL.cjs} +1 -1
  82. package/dist/{publisher-BZgcrVPy.cjs.map → publisher-lFQleddL.cjs.map} +1 -1
  83. package/dist/subscribers/index.cjs +2 -3
  84. package/dist/subscribers/index.cjs.map +1 -1
  85. package/dist/subscribers/index.d.mts +2 -2
  86. package/dist/subscribers/index.mjs +1 -1
  87. package/dist/{telemetry-Bp4DLvdQ.d.mts → telemetry-3vdxGn4q.d.mts} +1 -1
  88. package/dist/{telemetry-Bp4DLvdQ.d.mts.map → telemetry-3vdxGn4q.d.mts.map} +1 -1
  89. package/dist/{types-j0ti0JTY.d.mts → types-BDNGr7pv.d.mts} +1 -1
  90. package/dist/{types-j0ti0JTY.d.mts.map → types-BDNGr7pv.d.mts.map} +1 -1
  91. package/dist/types.d.mts +1 -1
  92. package/package.json +11 -36
  93. package/src/crons/AWSScheduledFunction.ts +1 -0
  94. package/src/endpoints/HonoEndpointAdaptor.ts +0 -1
  95. package/tsdown.config.ts +0 -2
  96. package/dist/adaptors/middy.cjs +0 -120
  97. package/dist/adaptors/middy.cjs.map +0 -1
  98. package/dist/adaptors/middy.d.cts +0 -139
  99. package/dist/adaptors/middy.d.cts.map +0 -1
  100. package/dist/adaptors/middy.d.mts +0 -139
  101. package/dist/adaptors/middy.d.mts.map +0 -1
  102. package/dist/adaptors/middy.mjs +0 -118
  103. package/dist/adaptors/middy.mjs.map +0 -1
  104. package/dist/adaptors/trpc.cjs +0 -65
  105. package/dist/adaptors/trpc.cjs.map +0 -1
  106. package/dist/adaptors/trpc.d.cts +0 -85
  107. package/dist/adaptors/trpc.d.cts.map +0 -1
  108. package/dist/adaptors/trpc.d.mts +0 -85
  109. package/dist/adaptors/trpc.d.mts.map +0 -1
  110. package/dist/adaptors/trpc.mjs +0 -63
  111. package/dist/adaptors/trpc.mjs.map +0 -1
  112. package/dist/chunk-B4qE4VCv.mjs +0 -27
  113. package/dist/chunk-DWy1uDak.cjs +0 -39
  114. package/dist/lazyAccessors-B4rtX68K.cjs.map +0 -1
  115. package/dist/lazyAccessors-D-UHg0YJ.mjs.map +0 -1
  116. package/dist/lodash-CM4k4sZD.cjs +0 -836
  117. package/dist/lodash-CM4k4sZD.cjs.map +0 -1
  118. package/dist/lodash-DiUeLbQy.mjs +0 -831
  119. package/dist/lodash-DiUeLbQy.mjs.map +0 -1
  120. package/src/adaptors/__tests__/middy.spec.ts +0 -212
  121. package/src/adaptors/__tests__/trpc.spec.ts +0 -220
  122. package/src/adaptors/middy.ts +0 -225
  123. package/src/adaptors/trpc.ts +0 -192
@@ -1,118 +0,0 @@
1
- import { __toESM } from "../chunk-B4qE4VCv.mjs";
2
- import { require_lodash } from "../lodash-DiUeLbQy.mjs";
3
- import { ServiceDiscovery, enterRequestContext, exitRequestContext } from "@geekmidas/services";
4
- import { ConsoleLogger } from "@geekmidas/logger/console";
5
- import { EnvironmentParser } from "@geekmidas/envkit";
6
-
7
- //#region src/adaptors/middy.ts
8
- var import_lodash = __toESM(require_lodash(), 1);
9
- function deriveRequestId(options, event, context) {
10
- return options.getRequestId?.(event, context) ?? context?.awsRequestId ?? crypto.randomUUID();
11
- }
12
- function buildLogger(baseLogger, options, requestId, event, context) {
13
- return baseLogger.child({
14
- requestId,
15
- ...options.bindings?.(event, context) ?? {}
16
- });
17
- }
18
- /**
19
- * Middy middleware that establishes a request context for the handler so any
20
- * code it reaches — including `@geekmidas/services` service methods — can call
21
- * `serviceContext.getLogger()` / `getRequestId()` / `getRequestStartTime()`.
22
- *
23
- * Use this on standalone functions that need request-scoped logging. To also
24
- * resolve services, pair it with {@link addServices}, or use
25
- * {@link withServices} which bundles both.
26
- *
27
- * @example
28
- * ```ts
29
- * import middy from '@middy/core';
30
- * import { serviceContext } from '@geekmidas/services';
31
- * import { requestContext } from '@geekmidas/constructs/middy';
32
- *
33
- * export const handler = middy(async () => {
34
- * serviceContext.getLogger().info('tick');
35
- * }).use(requestContext());
36
- * ```
37
- */
38
- function requestContext(options = {}) {
39
- const baseLogger = options.logger ?? new ConsoleLogger();
40
- return {
41
- before: (request) => {
42
- const { event, context } = request;
43
- const requestId = deriveRequestId(options, event, context);
44
- const logger = buildLogger(baseLogger, options, requestId, event, context);
45
- enterRequestContext({
46
- logger,
47
- requestId,
48
- startTime: Date.now()
49
- });
50
- },
51
- after: () => {
52
- exitRequestContext();
53
- },
54
- onError: () => {
55
- exitRequestContext();
56
- }
57
- };
58
- }
59
- function resolveDiscovery(options) {
60
- return options.serviceDiscovery ?? ServiceDiscovery.getInstance(options.envParser ?? new EnvironmentParser({ ...process.env }));
61
- }
62
- /**
63
- * Middy middleware that resolves an array of {@link Service}s via
64
- * {@link ServiceDiscovery} and attaches the resolved record to `event.services`
65
- * (keyed by each service's `serviceName`), matching how the `Function`/`Cron`
66
- * constructs expose services on the event.
67
- *
68
- * This middleware only resolves services; it does **not** establish a request
69
- * context. If your services read `serviceContext` (e.g. `getLogger()`), pair it
70
- * with {@link requestContext}, or use {@link withServices} which bundles both.
71
- *
72
- * Chainable — `.use(addServices([a])).use(addServices([b]))` accumulates onto
73
- * `event.services`.
74
- *
75
- * @example
76
- * ```ts
77
- * import middy from '@middy/core';
78
- * import { addServices, requestContext } from '@geekmidas/constructs/middy';
79
- *
80
- * export const handler = middy(async (event) => {
81
- * await event.services.database.users.deletePast();
82
- * event.services.cache.clear();
83
- * })
84
- * .use(requestContext())
85
- * .use(addServices([databaseService, cacheService], { envParser }));
86
- * ```
87
- */
88
- function addServices(services, options = {}) {
89
- const discovery = resolveDiscovery(options);
90
- return { before: async (request) => {
91
- const resolved = await discovery.register(services);
92
- (0, import_lodash.default)(request, "event.services", resolved);
93
- } };
94
- }
95
- /**
96
- * Batteries-included Middy setup for service-backed handlers: returns a pair of
97
- * middlewares — {@link requestContext} followed by {@link addServices} — so a
98
- * single `.use(withServices([...]))` gives the handler both a request context
99
- * and the resolved services on `event.services`.
100
- *
101
- * @example
102
- * ```ts
103
- * import middy from '@middy/core';
104
- * import { withServices } from '@geekmidas/constructs/middy';
105
- *
106
- * export const handler = middy(async (event) => {
107
- * await event.services.database.users.deletePast();
108
- * event.services.cache.clear();
109
- * }).use(withServices([databaseService, cacheService], { envParser }));
110
- * ```
111
- */
112
- function withServices(services, options = {}) {
113
- return [requestContext(options), addServices(services, options)];
114
- }
115
-
116
- //#endregion
117
- export { addServices, requestContext, withServices };
118
- //# sourceMappingURL=middy.mjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"middy.mjs","names":["options: RequestContextOptions","event: unknown","context: Context | undefined","baseLogger: Logger","requestId: string","options: ServiceMiddlewareOptions","services: [...T]"],"sources":["../../src/adaptors/middy.ts"],"sourcesContent":["import { EnvironmentParser } from '@geekmidas/envkit';\nimport type { Logger } from '@geekmidas/logger';\nimport { ConsoleLogger } from '@geekmidas/logger/console';\nimport {\n\tenterRequestContext,\n\texitRequestContext,\n\ttype Service,\n\tServiceDiscovery,\n\ttype ServiceRecord,\n} from '@geekmidas/services';\nimport type { MiddlewareObj } from '@middy/core';\nimport type { Context } from 'aws-lambda';\nimport set from 'lodash.set';\n\n/**\n * Middy middleware helpers that bring `@geekmidas/services` request context and\n * service discovery to **standalone** Middy Lambda handlers — i.e. functions\n * that aren't built with the `@geekmidas/constructs` Function/Cron constructs\n * but still want `serviceContext.getLogger()` and resolved services.\n *\n * Why middleware (and not `runWithRequestContext`)? Middy runs `before → handler\n * → after` as sequential awaits in a single async context, so establishing the\n * context with `AsyncLocalStorage.enterWith` (via `enterRequestContext`) in a\n * `before` hook propagates to the handler. `after`/`onError` reset it.\n *\n * Teardown is best-effort: like `enterRequestContext`, the reset is observable\n * to code the handler reaches but not necessarily to the frame that invoked the\n * Middy handler. This is fine for Lambda, where each invocation runs in its own\n * fresh async context — `requestContext` always establishes a brand-new context\n * per invocation, so requests never inherit a previous invocation's logger.\n *\n * @module\n */\n\n/**\n * Options shared by the request-context-aware middlewares.\n */\nexport interface RequestContextOptions {\n\t/**\n\t * Base logger to derive the per-request child logger from.\n\t * Defaults to a new {@link ConsoleLogger}.\n\t */\n\tlogger?: Logger;\n\t/**\n\t * Derive the request id from the event/context.\n\t * Defaults to `context.awsRequestId`, falling back to `crypto.randomUUID()`.\n\t */\n\tgetRequestId?: (event: unknown, context: Context) => string;\n\t/**\n\t * Extra bindings to attach to the per-request child logger.\n\t */\n\tbindings?: (event: unknown, context: Context) => Record<string, unknown>;\n}\n\n/**\n * Options for the service-resolving middlewares.\n */\nexport interface ServiceMiddlewareOptions extends RequestContextOptions {\n\t/**\n\t * Environment parser used to build the default {@link ServiceDiscovery}.\n\t * Defaults to `new EnvironmentParser({ ...process.env })`.\n\t */\n\tenvParser?: EnvironmentParser<{}>;\n\t/**\n\t * Explicit {@link ServiceDiscovery} to resolve services from. Takes\n\t * precedence over `envParser`.\n\t */\n\tserviceDiscovery?: ServiceDiscovery;\n}\n\nfunction deriveRequestId(\n\toptions: RequestContextOptions,\n\tevent: unknown,\n\tcontext: Context | undefined,\n): string {\n\treturn (\n\t\toptions.getRequestId?.(event, context as Context) ??\n\t\tcontext?.awsRequestId ??\n\t\tcrypto.randomUUID()\n\t);\n}\n\nfunction buildLogger(\n\tbaseLogger: Logger,\n\toptions: RequestContextOptions,\n\trequestId: string,\n\tevent: unknown,\n\tcontext: Context | undefined,\n): Logger {\n\treturn baseLogger.child({\n\t\trequestId,\n\t\t...(options.bindings?.(event, context as Context) ?? {}),\n\t});\n}\n\n/**\n * Middy middleware that establishes a request context for the handler so any\n * code it reaches — including `@geekmidas/services` service methods — can call\n * `serviceContext.getLogger()` / `getRequestId()` / `getRequestStartTime()`.\n *\n * Use this on standalone functions that need request-scoped logging. To also\n * resolve services, pair it with {@link addServices}, or use\n * {@link withServices} which bundles both.\n *\n * @example\n * ```ts\n * import middy from '@middy/core';\n * import { serviceContext } from '@geekmidas/services';\n * import { requestContext } from '@geekmidas/constructs/middy';\n *\n * export const handler = middy(async () => {\n * serviceContext.getLogger().info('tick');\n * }).use(requestContext());\n * ```\n */\nexport function requestContext(\n\toptions: RequestContextOptions = {},\n): MiddlewareObj<unknown, unknown, Error, Context> {\n\tconst baseLogger = options.logger ?? new ConsoleLogger();\n\treturn {\n\t\tbefore: (request) => {\n\t\t\tconst { event, context } = request;\n\t\t\tconst requestId = deriveRequestId(options, event, context);\n\t\t\tconst logger = buildLogger(\n\t\t\t\tbaseLogger,\n\t\t\t\toptions,\n\t\t\t\trequestId,\n\t\t\t\tevent,\n\t\t\t\tcontext,\n\t\t\t);\n\t\t\tenterRequestContext({ logger, requestId, startTime: Date.now() });\n\t\t},\n\t\tafter: () => {\n\t\t\texitRequestContext();\n\t\t},\n\t\tonError: () => {\n\t\t\texitRequestContext();\n\t\t},\n\t};\n}\n\nfunction resolveDiscovery(options: ServiceMiddlewareOptions): ServiceDiscovery {\n\treturn (\n\t\toptions.serviceDiscovery ??\n\t\tServiceDiscovery.getInstance(\n\t\t\toptions.envParser ?? new EnvironmentParser({ ...process.env }),\n\t\t)\n\t);\n}\n\n/**\n * Event augmentation applied by {@link addServices} / {@link withServices}:\n * resolved services keyed by `serviceName`. Intersect it with your own event\n * type to type the handler, e.g. `(event: EventServices<T> & APIGatewayEvent)`.\n */\nexport type EventServices<T extends Service[]> = {\n\tservices: ServiceRecord<T>;\n};\n\n/**\n * Middy middleware that resolves an array of {@link Service}s via\n * {@link ServiceDiscovery} and attaches the resolved record to `event.services`\n * (keyed by each service's `serviceName`), matching how the `Function`/`Cron`\n * constructs expose services on the event.\n *\n * This middleware only resolves services; it does **not** establish a request\n * context. If your services read `serviceContext` (e.g. `getLogger()`), pair it\n * with {@link requestContext}, or use {@link withServices} which bundles both.\n *\n * Chainable — `.use(addServices([a])).use(addServices([b]))` accumulates onto\n * `event.services`.\n *\n * @example\n * ```ts\n * import middy from '@middy/core';\n * import { addServices, requestContext } from '@geekmidas/constructs/middy';\n *\n * export const handler = middy(async (event) => {\n * await event.services.database.users.deletePast();\n * event.services.cache.clear();\n * })\n * .use(requestContext())\n * .use(addServices([databaseService, cacheService], { envParser }));\n * ```\n */\nexport function addServices<const T extends Service[]>(\n\tservices: [...T],\n\toptions: ServiceMiddlewareOptions = {},\n): MiddlewareObj<EventServices<T>, unknown, Error, Context> {\n\tconst discovery = resolveDiscovery(options);\n\n\treturn {\n\t\tbefore: async (request) => {\n\t\t\tconst resolved = await discovery.register(services);\n\t\t\tset(request, 'event.services', resolved);\n\t\t},\n\t};\n}\n\n/**\n * Batteries-included Middy setup for service-backed handlers: returns a pair of\n * middlewares — {@link requestContext} followed by {@link addServices} — so a\n * single `.use(withServices([...]))` gives the handler both a request context\n * and the resolved services on `event.services`.\n *\n * @example\n * ```ts\n * import middy from '@middy/core';\n * import { withServices } from '@geekmidas/constructs/middy';\n *\n * export const handler = middy(async (event) => {\n * await event.services.database.users.deletePast();\n * event.services.cache.clear();\n * }).use(withServices([databaseService, cacheService], { envParser }));\n * ```\n */\nexport function withServices<const T extends Service[]>(\n\tservices: [...T],\n\toptions: ServiceMiddlewareOptions = {},\n): [\n\tMiddlewareObj<unknown, unknown, Error, Context>,\n\tMiddlewareObj<EventServices<T>, unknown, Error, Context>,\n] {\n\treturn [requestContext(options), addServices(services, options)];\n}\n"],"mappings":";;;;;;;;AAsEA,SAAS,gBACRA,SACAC,OACAC,SACS;AACT,QACC,QAAQ,eAAe,OAAO,QAAmB,IACjD,SAAS,gBACT,OAAO,YAAY;AAEpB;AAED,SAAS,YACRC,YACAH,SACAI,WACAH,OACAC,SACS;AACT,QAAO,WAAW,MAAM;EACvB;EACA,GAAI,QAAQ,WAAW,OAAO,QAAmB,IAAI,CAAE;CACvD,EAAC;AACF;;;;;;;;;;;;;;;;;;;;;AAsBD,SAAgB,eACfF,UAAiC,CAAE,GACe;CAClD,MAAM,aAAa,QAAQ,UAAU,IAAI;AACzC,QAAO;EACN,QAAQ,CAAC,YAAY;GACpB,MAAM,EAAE,OAAO,SAAS,GAAG;GAC3B,MAAM,YAAY,gBAAgB,SAAS,OAAO,QAAQ;GAC1D,MAAM,SAAS,YACd,YACA,SACA,WACA,OACA,QACA;AACD,uBAAoB;IAAE;IAAQ;IAAW,WAAW,KAAK,KAAK;GAAE,EAAC;EACjE;EACD,OAAO,MAAM;AACZ,uBAAoB;EACpB;EACD,SAAS,MAAM;AACd,uBAAoB;EACpB;CACD;AACD;AAED,SAAS,iBAAiBK,SAAqD;AAC9E,QACC,QAAQ,oBACR,iBAAiB,YAChB,QAAQ,aAAa,IAAI,kBAAkB,EAAE,GAAG,QAAQ,IAAK,GAC7D;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCD,SAAgB,YACfC,UACAD,UAAoC,CAAE,GACqB;CAC3D,MAAM,YAAY,iBAAiB,QAAQ;AAE3C,QAAO,EACN,QAAQ,OAAO,YAAY;EAC1B,MAAM,WAAW,MAAM,UAAU,SAAS,SAAS;AACnD,6BAAI,SAAS,kBAAkB,SAAS;CACxC,EACD;AACD;;;;;;;;;;;;;;;;;;AAmBD,SAAgB,aACfC,UACAD,UAAoC,CAAE,GAIrC;AACD,QAAO,CAAC,eAAe,QAAQ,EAAE,YAAY,UAAU,QAAQ,AAAC;AAChE"}
@@ -1,65 +0,0 @@
1
- const require_chunk = require('../chunk-DWy1uDak.cjs');
2
- const __geekmidas_services = require_chunk.__toESM(require("@geekmidas/services"));
3
-
4
- //#region src/adaptors/trpc.ts
5
- function createServicesMiddleware(mw, envParser) {
6
- return (services) => {
7
- const builder = mw(async (opts) => {
8
- const ctx = opts.ctx;
9
- const discovery = ctx.serviceDiscovery ?? __geekmidas_services.ServiceDiscovery.getInstance(envParser ?? (() => {
10
- throw new Error("createServicesMiddleware: no `envParser` provided and `ctx.serviceDiscovery` is missing. Pass an EnvironmentParser to createServicesMiddleware(), or attach a ServiceDiscovery instance to the tRPC context.");
11
- })());
12
- const requestId = ctx.requestId ?? crypto.randomUUID();
13
- const startTime = ctx.startTime ?? Date.now();
14
- return (0, __geekmidas_services.runWithRequestContext)({
15
- logger: ctx.logger,
16
- requestId,
17
- startTime
18
- }, async () => {
19
- const resolved = await discovery.register(services);
20
- return opts.next({ ctx: {
21
- ...opts.ctx,
22
- ...resolved
23
- } });
24
- });
25
- });
26
- const middlewares = builder._middlewares;
27
- if (middlewares?.length) {
28
- const last = middlewares[middlewares.length - 1];
29
- if (last) last._services = services;
30
- }
31
- return builder;
32
- };
33
- }
34
- /**
35
- * Create a tRPC middleware that establishes a request context for downstream
36
- * code without resolving any services. Useful when services aren't needed on
37
- * a procedure but the handler (or libraries it calls) still wants to read
38
- * `serviceContext.getLogger()` / `getRequestId()` / `getRequestStartTime()`.
39
- *
40
- * `requestId` and `startTime` are pulled from the tRPC context when present,
41
- * otherwise generated (`crypto.randomUUID()` and `Date.now()`).
42
- *
43
- * @example
44
- * ```ts
45
- * const withRequestContext = createRequestContextMiddleware(t.middleware);
46
- * export const baseProcedure = t.procedure.use(withRequestContext);
47
- * ```
48
- */
49
- function createRequestContextMiddleware(mw) {
50
- return mw(async (opts) => {
51
- const ctx = opts.ctx;
52
- const requestId = ctx.requestId ?? crypto.randomUUID();
53
- const startTime = ctx.startTime ?? Date.now();
54
- return (0, __geekmidas_services.runWithRequestContext)({
55
- logger: ctx.logger,
56
- requestId,
57
- startTime
58
- }, () => opts.next());
59
- });
60
- }
61
-
62
- //#endregion
63
- exports.createRequestContextMiddleware = createRequestContextMiddleware;
64
- exports.createServicesMiddleware = createServicesMiddleware;
65
- //# sourceMappingURL=trpc.cjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"trpc.cjs","names":["mw: CreateMiddleware<TContext, TMeta>","envParser?: EnvironmentParser<{}>","services: [...T]"],"sources":["../../src/adaptors/trpc.ts"],"sourcesContent":["import type { EnvironmentParser } from '@geekmidas/envkit';\nimport type { Logger } from '@geekmidas/logger';\nimport {\n\trunWithRequestContext,\n\ttype Service,\n\tServiceDiscovery,\n\ttype ServiceRecord,\n} from '@geekmidas/services';\nimport type {\n\tTRPCMiddlewareBuilder,\n\tTRPCMiddlewareFunction,\n} from '@trpc/server';\n\n/**\n * Shape of `t.middleware` from `@trpc/server`. We accept this rather than the\n * initialized `t` object so callers retain ownership of their tRPC instance\n * (no double-initialization, no opinion on context/meta shape).\n */\ntype CreateMiddleware<TContext, TMeta> = <$ContextOverrides>(\n\tfn: TRPCMiddlewareFunction<\n\t\tTContext,\n\t\tTMeta,\n\t\tobject,\n\t\t$ContextOverrides,\n\t\tunknown\n\t>,\n) => TRPCMiddlewareBuilder<TContext, TMeta, $ContextOverrides, unknown>;\n\n/**\n * Result of `createServicesMiddleware`: a function that accepts a service\n * tuple and returns a tRPC middleware that merges resolved services onto the\n * context.\n */\nexport type ServicesMiddleware<\n\tTContext extends object,\n\tTMeta extends object,\n> = <const T extends Service[]>(\n\tservices: [...T],\n) => TRPCMiddlewareBuilder<TContext, TMeta, ServiceRecord<T>, unknown>;\n\n/**\n * Context shape required by `createServicesMiddleware` overload 2.\n * Procedures that pull services via context-stored discovery must expose it\n * under `serviceDiscovery`.\n */\nexport interface ContextWithServiceDiscovery {\n\tserviceDiscovery: ServiceDiscovery;\n}\n\n/**\n * Minimum context required for request-context propagation. `logger` must be\n * present so services can call `serviceContext.getLogger()`. `requestId` and\n * `startTime` are auto-generated if missing.\n */\nexport interface ContextWithLogger {\n\tlogger: Logger;\n\trequestId?: string;\n\tstartTime?: number;\n}\n\n/**\n * Create a tRPC middleware that:\n *\n * 1. Resolves the requested services via `ServiceDiscovery`.\n * 2. Wraps the downstream call in `runWithRequestContext` so any code reached\n * by the procedure (including service method implementations) can read the\n * current logger/request id via `serviceContext`.\n * 3. Merges the resolved services onto the tRPC context so handlers can access\n * them by service name (`ctx.database`, `ctx.cache`, ...).\n *\n * Two overloads:\n * - Pass an `envParser` to create a per-request `ServiceDiscovery` instance.\n * - Omit `envParser` to read `ctx.serviceDiscovery` from the tRPC context.\n *\n * @example\n * ```ts\n * import { initTRPC } from '@trpc/server';\n * import { createServicesMiddleware } from '@geekmidas/constructs/trpc';\n *\n * const t = initTRPC.context<Context>().create();\n * const withServices = createServicesMiddleware(t.middleware, envParser);\n *\n * export const authedProcedure = t.procedure.use(\n * withServices([databaseService, cacheService]),\n * );\n * ```\n */\nexport function createServicesMiddleware<\n\tTContext extends ContextWithLogger & object,\n\tTMeta extends object,\n>(\n\tmw: CreateMiddleware<TContext, TMeta>,\n\tenvParser: EnvironmentParser<{}>,\n): ServicesMiddleware<TContext, TMeta>;\nexport function createServicesMiddleware<\n\tTContext extends ContextWithLogger & ContextWithServiceDiscovery & object,\n\tTMeta extends object,\n>(mw: CreateMiddleware<TContext, TMeta>): ServicesMiddleware<TContext, TMeta>;\nexport function createServicesMiddleware<\n\tTContext extends ContextWithLogger & object,\n\tTMeta extends object,\n>(\n\tmw: CreateMiddleware<TContext, TMeta>,\n\tenvParser?: EnvironmentParser<{}>,\n): ServicesMiddleware<TContext, TMeta> {\n\treturn (<const T extends Service[]>(services: [...T]) => {\n\t\tconst builder = mw(async (opts) => {\n\t\t\tconst ctx = opts.ctx as TContext & Partial<ContextWithServiceDiscovery>;\n\n\t\t\tconst discovery =\n\t\t\t\tctx.serviceDiscovery ??\n\t\t\t\tServiceDiscovery.getInstance(\n\t\t\t\t\tenvParser ??\n\t\t\t\t\t\t(() => {\n\t\t\t\t\t\t\t// Hit only if overload 2 was selected but ctx.serviceDiscovery is\n\t\t\t\t\t\t\t// missing at runtime — surface the mistake immediately rather\n\t\t\t\t\t\t\t// than letting an undefined env parser fail deep inside register.\n\t\t\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t\t\t'createServicesMiddleware: no `envParser` provided and ' +\n\t\t\t\t\t\t\t\t\t'`ctx.serviceDiscovery` is missing. Pass an EnvironmentParser ' +\n\t\t\t\t\t\t\t\t\t'to createServicesMiddleware(), or attach a ServiceDiscovery ' +\n\t\t\t\t\t\t\t\t\t'instance to the tRPC context.',\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t})(),\n\t\t\t\t);\n\n\t\t\tconst requestId = ctx.requestId ?? crypto.randomUUID();\n\t\t\tconst startTime = ctx.startTime ?? Date.now();\n\n\t\t\treturn runWithRequestContext(\n\t\t\t\t{ logger: ctx.logger, requestId, startTime },\n\t\t\t\tasync () => {\n\t\t\t\t\tconst resolved = await discovery.register(services);\n\t\t\t\t\treturn opts.next({\n\t\t\t\t\t\tctx: { ...opts.ctx, ...resolved } as typeof opts.ctx &\n\t\t\t\t\t\t\tServiceRecord<T>,\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t);\n\t\t});\n\n\t\t// Tag the inner middleware function with the requested services so external\n\t\t// tooling (e.g. detect-procedures route generators) can introspect a\n\t\t// procedure's service dependencies without re-executing middleware.\n\t\tconst middlewares = (\n\t\t\tbuilder as unknown as { _middlewares?: Array<{ _services?: Service[] }> }\n\t\t)._middlewares;\n\t\tif (middlewares?.length) {\n\t\t\tconst last = middlewares[middlewares.length - 1];\n\t\t\tif (last) last._services = services as unknown as Service[];\n\t\t}\n\n\t\treturn builder as TRPCMiddlewareBuilder<\n\t\t\tTContext,\n\t\t\tTMeta,\n\t\t\tServiceRecord<T>,\n\t\t\tunknown\n\t\t>;\n\t}) as ServicesMiddleware<TContext, TMeta>;\n}\n\n/**\n * Create a tRPC middleware that establishes a request context for downstream\n * code without resolving any services. Useful when services aren't needed on\n * a procedure but the handler (or libraries it calls) still wants to read\n * `serviceContext.getLogger()` / `getRequestId()` / `getRequestStartTime()`.\n *\n * `requestId` and `startTime` are pulled from the tRPC context when present,\n * otherwise generated (`crypto.randomUUID()` and `Date.now()`).\n *\n * @example\n * ```ts\n * const withRequestContext = createRequestContextMiddleware(t.middleware);\n * export const baseProcedure = t.procedure.use(withRequestContext);\n * ```\n */\nexport function createRequestContextMiddleware<\n\tTContext extends ContextWithLogger & object,\n\tTMeta extends object,\n>(\n\tmw: CreateMiddleware<TContext, TMeta>,\n): TRPCMiddlewareBuilder<TContext, TMeta, object, unknown> {\n\treturn mw(async (opts) => {\n\t\tconst ctx = opts.ctx as TContext;\n\t\tconst requestId = ctx.requestId ?? crypto.randomUUID();\n\t\tconst startTime = ctx.startTime ?? Date.now();\n\t\treturn runWithRequestContext(\n\t\t\t{ logger: ctx.logger, requestId, startTime },\n\t\t\t() => opts.next(),\n\t\t);\n\t});\n}\n"],"mappings":";;;;AAkGA,SAAgB,yBAIfA,IACAC,WACsC;AACtC,QAAQ,CAA4BC,aAAqB;EACxD,MAAM,UAAU,GAAG,OAAO,SAAS;GAClC,MAAM,MAAM,KAAK;GAEjB,MAAM,YACL,IAAI,oBACJ,sCAAiB,YAChB,aACC,CAAC,MAAM;AAIN,UAAM,IAAI,MACT;GAKD,IAAG,CACL;GAEF,MAAM,YAAY,IAAI,aAAa,OAAO,YAAY;GACtD,MAAM,YAAY,IAAI,aAAa,KAAK,KAAK;AAE7C,UAAO,gDACN;IAAE,QAAQ,IAAI;IAAQ;IAAW;GAAW,GAC5C,YAAY;IACX,MAAM,WAAW,MAAM,UAAU,SAAS,SAAS;AACnD,WAAO,KAAK,KAAK,EAChB,KAAK;KAAE,GAAG,KAAK;KAAK,GAAG;IAAU,EAEjC,EAAC;GACF,EACD;EACD,EAAC;EAKF,MAAM,cACL,QACC;AACF,MAAI,aAAa,QAAQ;GACxB,MAAM,OAAO,YAAY,YAAY,SAAS;AAC9C,OAAI,KAAM,MAAK,YAAY;EAC3B;AAED,SAAO;CAMP;AACD;;;;;;;;;;;;;;;;AAiBD,SAAgB,+BAIfF,IAC0D;AAC1D,QAAO,GAAG,OAAO,SAAS;EACzB,MAAM,MAAM,KAAK;EACjB,MAAM,YAAY,IAAI,aAAa,OAAO,YAAY;EACtD,MAAM,YAAY,IAAI,aAAa,KAAK,KAAK;AAC7C,SAAO,gDACN;GAAE,QAAQ,IAAI;GAAQ;GAAW;EAAW,GAC5C,MAAM,KAAK,MAAM,CACjB;CACD,EAAC;AACF"}
@@ -1,85 +0,0 @@
1
- import { EnvironmentParser } from "@geekmidas/envkit";
2
- import { Logger } from "@geekmidas/logger";
3
- import { Service, ServiceDiscovery, ServiceRecord } from "@geekmidas/services";
4
- import { TRPCMiddlewareBuilder, TRPCMiddlewareFunction } from "@trpc/server";
5
-
6
- //#region src/adaptors/trpc.d.ts
7
-
8
- /**
9
- * Shape of `t.middleware` from `@trpc/server`. We accept this rather than the
10
- * initialized `t` object so callers retain ownership of their tRPC instance
11
- * (no double-initialization, no opinion on context/meta shape).
12
- */
13
- type CreateMiddleware<TContext, TMeta> = <$ContextOverrides>(fn: TRPCMiddlewareFunction<TContext, TMeta, object, $ContextOverrides, unknown>) => TRPCMiddlewareBuilder<TContext, TMeta, $ContextOverrides, unknown>;
14
- /**
15
- * Result of `createServicesMiddleware`: a function that accepts a service
16
- * tuple and returns a tRPC middleware that merges resolved services onto the
17
- * context.
18
- */
19
- type ServicesMiddleware<TContext extends object, TMeta extends object> = <const T extends Service[]>(services: [...T]) => TRPCMiddlewareBuilder<TContext, TMeta, ServiceRecord<T>, unknown>;
20
- /**
21
- * Context shape required by `createServicesMiddleware` overload 2.
22
- * Procedures that pull services via context-stored discovery must expose it
23
- * under `serviceDiscovery`.
24
- */
25
- interface ContextWithServiceDiscovery {
26
- serviceDiscovery: ServiceDiscovery;
27
- }
28
- /**
29
- * Minimum context required for request-context propagation. `logger` must be
30
- * present so services can call `serviceContext.getLogger()`. `requestId` and
31
- * `startTime` are auto-generated if missing.
32
- */
33
- interface ContextWithLogger {
34
- logger: Logger;
35
- requestId?: string;
36
- startTime?: number;
37
- }
38
- /**
39
- * Create a tRPC middleware that:
40
- *
41
- * 1. Resolves the requested services via `ServiceDiscovery`.
42
- * 2. Wraps the downstream call in `runWithRequestContext` so any code reached
43
- * by the procedure (including service method implementations) can read the
44
- * current logger/request id via `serviceContext`.
45
- * 3. Merges the resolved services onto the tRPC context so handlers can access
46
- * them by service name (`ctx.database`, `ctx.cache`, ...).
47
- *
48
- * Two overloads:
49
- * - Pass an `envParser` to create a per-request `ServiceDiscovery` instance.
50
- * - Omit `envParser` to read `ctx.serviceDiscovery` from the tRPC context.
51
- *
52
- * @example
53
- * ```ts
54
- * import { initTRPC } from '@trpc/server';
55
- * import { createServicesMiddleware } from '@geekmidas/constructs/trpc';
56
- *
57
- * const t = initTRPC.context<Context>().create();
58
- * const withServices = createServicesMiddleware(t.middleware, envParser);
59
- *
60
- * export const authedProcedure = t.procedure.use(
61
- * withServices([databaseService, cacheService]),
62
- * );
63
- * ```
64
- */
65
- declare function createServicesMiddleware<TContext extends ContextWithLogger & object, TMeta extends object>(mw: CreateMiddleware<TContext, TMeta>, envParser: EnvironmentParser<{}>): ServicesMiddleware<TContext, TMeta>;
66
- declare function createServicesMiddleware<TContext extends ContextWithLogger & ContextWithServiceDiscovery & object, TMeta extends object>(mw: CreateMiddleware<TContext, TMeta>): ServicesMiddleware<TContext, TMeta>;
67
- /**
68
- * Create a tRPC middleware that establishes a request context for downstream
69
- * code without resolving any services. Useful when services aren't needed on
70
- * a procedure but the handler (or libraries it calls) still wants to read
71
- * `serviceContext.getLogger()` / `getRequestId()` / `getRequestStartTime()`.
72
- *
73
- * `requestId` and `startTime` are pulled from the tRPC context when present,
74
- * otherwise generated (`crypto.randomUUID()` and `Date.now()`).
75
- *
76
- * @example
77
- * ```ts
78
- * const withRequestContext = createRequestContextMiddleware(t.middleware);
79
- * export const baseProcedure = t.procedure.use(withRequestContext);
80
- * ```
81
- */
82
- declare function createRequestContextMiddleware<TContext extends ContextWithLogger & object, TMeta extends object>(mw: CreateMiddleware<TContext, TMeta>): TRPCMiddlewareBuilder<TContext, TMeta, object, unknown>;
83
- //#endregion
84
- export { ContextWithLogger, ContextWithServiceDiscovery, ServicesMiddleware, createRequestContextMiddleware, createServicesMiddleware };
85
- //# sourceMappingURL=trpc.d.cts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"trpc.d.cts","names":[],"sources":["../../src/adaptors/trpc.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAWsB;;;KAOjB,gBAGH,CAAA,QAAA,EAAA,KAAA,CAAA,GAAA,CAAA,iBAAA,CAAA,CAAA,EAAA,EAFG,sBAEH,CADA,QACA,EAAA,KAAA,EAAA,MAAA,EAEA,iBAFA,EAAA,OAAA,CAAA,EAAA,GAKG,qBALH,CAKyB,QALzB,EAKmC,KALnC,EAK0C,iBAL1C,EAAA,OAAA,CAAA;;;;;;AAKG,KAOO,kBAPP,CAAA,iBAAA,MAAA,EAAA,cAAA,MAAA,CAAA,GAAA,CAAA,gBAUgB,OAVhB,EAAA,CAAA,CAAA,QAAA,EAAA,CAAA,GAWU,CAXV,CAAA,EAAA,GAYA,qBAZA,CAYsB,QAZtB,EAYgC,KAZhC,EAYuC,aAZvC,CAYqD,CAZrD,CAAA,EAAA,OAAA,CAAA;AAAqB;AAO1B;;;;AAK2B,UAOV,2BAAA,CAPU;EAAQ,gBAAE,EAQlB,gBARkB;;;;AAAX;AAO1B;AASA;AAiCgB,UAjCC,iBAAA,CAiCuB;EAAA,MAAA,EAhC/B,MAgC+B;EAAA,SACtB,CAAA,EAAA,MAAA;EAAiB,SAGb,CAAA,EAAA,MAAA;;;;;;;AAED;AACrB;;;;;;;;;;AAG4D;AA+E5D;;;;;;;;;AAKwB;iBA9FR,0CACE,sDAGb,iBAAiB,UAAU,mBACpB,wBACT,mBAAmB,UAAU;iBAChB,0CACE,oBAAoB,gEAEhC,iBAAiB,UAAU,SAAS,mBAAmB,UAAU;;;;;;;;;;;;;;;;iBA+EvD,gDACE,sDAGb,iBAAiB,UAAU,SAC7B,sBAAsB,UAAU"}
@@ -1,85 +0,0 @@
1
- import { Service, ServiceDiscovery, ServiceRecord } from "@geekmidas/services";
2
- import { EnvironmentParser } from "@geekmidas/envkit";
3
- import { Logger } from "@geekmidas/logger";
4
- import { TRPCMiddlewareBuilder, TRPCMiddlewareFunction } from "@trpc/server";
5
-
6
- //#region src/adaptors/trpc.d.ts
7
-
8
- /**
9
- * Shape of `t.middleware` from `@trpc/server`. We accept this rather than the
10
- * initialized `t` object so callers retain ownership of their tRPC instance
11
- * (no double-initialization, no opinion on context/meta shape).
12
- */
13
- type CreateMiddleware<TContext, TMeta> = <$ContextOverrides>(fn: TRPCMiddlewareFunction<TContext, TMeta, object, $ContextOverrides, unknown>) => TRPCMiddlewareBuilder<TContext, TMeta, $ContextOverrides, unknown>;
14
- /**
15
- * Result of `createServicesMiddleware`: a function that accepts a service
16
- * tuple and returns a tRPC middleware that merges resolved services onto the
17
- * context.
18
- */
19
- type ServicesMiddleware<TContext extends object, TMeta extends object> = <const T extends Service[]>(services: [...T]) => TRPCMiddlewareBuilder<TContext, TMeta, ServiceRecord<T>, unknown>;
20
- /**
21
- * Context shape required by `createServicesMiddleware` overload 2.
22
- * Procedures that pull services via context-stored discovery must expose it
23
- * under `serviceDiscovery`.
24
- */
25
- interface ContextWithServiceDiscovery {
26
- serviceDiscovery: ServiceDiscovery;
27
- }
28
- /**
29
- * Minimum context required for request-context propagation. `logger` must be
30
- * present so services can call `serviceContext.getLogger()`. `requestId` and
31
- * `startTime` are auto-generated if missing.
32
- */
33
- interface ContextWithLogger {
34
- logger: Logger;
35
- requestId?: string;
36
- startTime?: number;
37
- }
38
- /**
39
- * Create a tRPC middleware that:
40
- *
41
- * 1. Resolves the requested services via `ServiceDiscovery`.
42
- * 2. Wraps the downstream call in `runWithRequestContext` so any code reached
43
- * by the procedure (including service method implementations) can read the
44
- * current logger/request id via `serviceContext`.
45
- * 3. Merges the resolved services onto the tRPC context so handlers can access
46
- * them by service name (`ctx.database`, `ctx.cache`, ...).
47
- *
48
- * Two overloads:
49
- * - Pass an `envParser` to create a per-request `ServiceDiscovery` instance.
50
- * - Omit `envParser` to read `ctx.serviceDiscovery` from the tRPC context.
51
- *
52
- * @example
53
- * ```ts
54
- * import { initTRPC } from '@trpc/server';
55
- * import { createServicesMiddleware } from '@geekmidas/constructs/trpc';
56
- *
57
- * const t = initTRPC.context<Context>().create();
58
- * const withServices = createServicesMiddleware(t.middleware, envParser);
59
- *
60
- * export const authedProcedure = t.procedure.use(
61
- * withServices([databaseService, cacheService]),
62
- * );
63
- * ```
64
- */
65
- declare function createServicesMiddleware<TContext extends ContextWithLogger & object, TMeta extends object>(mw: CreateMiddleware<TContext, TMeta>, envParser: EnvironmentParser<{}>): ServicesMiddleware<TContext, TMeta>;
66
- declare function createServicesMiddleware<TContext extends ContextWithLogger & ContextWithServiceDiscovery & object, TMeta extends object>(mw: CreateMiddleware<TContext, TMeta>): ServicesMiddleware<TContext, TMeta>;
67
- /**
68
- * Create a tRPC middleware that establishes a request context for downstream
69
- * code without resolving any services. Useful when services aren't needed on
70
- * a procedure but the handler (or libraries it calls) still wants to read
71
- * `serviceContext.getLogger()` / `getRequestId()` / `getRequestStartTime()`.
72
- *
73
- * `requestId` and `startTime` are pulled from the tRPC context when present,
74
- * otherwise generated (`crypto.randomUUID()` and `Date.now()`).
75
- *
76
- * @example
77
- * ```ts
78
- * const withRequestContext = createRequestContextMiddleware(t.middleware);
79
- * export const baseProcedure = t.procedure.use(withRequestContext);
80
- * ```
81
- */
82
- declare function createRequestContextMiddleware<TContext extends ContextWithLogger & object, TMeta extends object>(mw: CreateMiddleware<TContext, TMeta>): TRPCMiddlewareBuilder<TContext, TMeta, object, unknown>;
83
- //#endregion
84
- export { ContextWithLogger, ContextWithServiceDiscovery, ServicesMiddleware, createRequestContextMiddleware, createServicesMiddleware };
85
- //# sourceMappingURL=trpc.d.mts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"trpc.d.mts","names":[],"sources":["../../src/adaptors/trpc.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAWsB;;;KAOjB,gBAGH,CAAA,QAAA,EAAA,KAAA,CAAA,GAAA,CAAA,iBAAA,CAAA,CAAA,EAAA,EAFG,sBAEH,CADA,QACA,EAAA,KAAA,EAAA,MAAA,EAEA,iBAFA,EAAA,OAAA,CAAA,EAAA,GAKG,qBALH,CAKyB,QALzB,EAKmC,KALnC,EAK0C,iBAL1C,EAAA,OAAA,CAAA;;;;;;AAKG,KAOO,kBAPP,CAAA,iBAAA,MAAA,EAAA,cAAA,MAAA,CAAA,GAAA,CAAA,gBAUgB,OAVhB,EAAA,CAAA,CAAA,QAAA,EAAA,CAAA,GAWU,CAXV,CAAA,EAAA,GAYA,qBAZA,CAYsB,QAZtB,EAYgC,KAZhC,EAYuC,aAZvC,CAYqD,CAZrD,CAAA,EAAA,OAAA,CAAA;AAAqB;AAO1B;;;;AAK2B,UAOV,2BAAA,CAPU;EAAQ,gBAAE,EAQlB,gBARkB;;;;AAAX;AAO1B;AASA;AAiCgB,UAjCC,iBAAA,CAiCuB;EAAA,MAAA,EAhC/B,MAgC+B;EAAA,SACtB,CAAA,EAAA,MAAA;EAAiB,SAGb,CAAA,EAAA,MAAA;;;;;;;AAED;AACrB;;;;;;;;;;AAG4D;AA+E5D;;;;;;;;;AAKwB;iBA9FR,0CACE,sDAGb,iBAAiB,UAAU,mBACpB,wBACT,mBAAmB,UAAU;iBAChB,0CACE,oBAAoB,gEAEhC,iBAAiB,UAAU,SAAS,mBAAmB,UAAU;;;;;;;;;;;;;;;;iBA+EvD,gDACE,sDAGb,iBAAiB,UAAU,SAC7B,sBAAsB,UAAU"}
@@ -1,63 +0,0 @@
1
- import { ServiceDiscovery, runWithRequestContext } from "@geekmidas/services";
2
-
3
- //#region src/adaptors/trpc.ts
4
- function createServicesMiddleware(mw, envParser) {
5
- return (services) => {
6
- const builder = mw(async (opts) => {
7
- const ctx = opts.ctx;
8
- const discovery = ctx.serviceDiscovery ?? ServiceDiscovery.getInstance(envParser ?? (() => {
9
- throw new Error("createServicesMiddleware: no `envParser` provided and `ctx.serviceDiscovery` is missing. Pass an EnvironmentParser to createServicesMiddleware(), or attach a ServiceDiscovery instance to the tRPC context.");
10
- })());
11
- const requestId = ctx.requestId ?? crypto.randomUUID();
12
- const startTime = ctx.startTime ?? Date.now();
13
- return runWithRequestContext({
14
- logger: ctx.logger,
15
- requestId,
16
- startTime
17
- }, async () => {
18
- const resolved = await discovery.register(services);
19
- return opts.next({ ctx: {
20
- ...opts.ctx,
21
- ...resolved
22
- } });
23
- });
24
- });
25
- const middlewares = builder._middlewares;
26
- if (middlewares?.length) {
27
- const last = middlewares[middlewares.length - 1];
28
- if (last) last._services = services;
29
- }
30
- return builder;
31
- };
32
- }
33
- /**
34
- * Create a tRPC middleware that establishes a request context for downstream
35
- * code without resolving any services. Useful when services aren't needed on
36
- * a procedure but the handler (or libraries it calls) still wants to read
37
- * `serviceContext.getLogger()` / `getRequestId()` / `getRequestStartTime()`.
38
- *
39
- * `requestId` and `startTime` are pulled from the tRPC context when present,
40
- * otherwise generated (`crypto.randomUUID()` and `Date.now()`).
41
- *
42
- * @example
43
- * ```ts
44
- * const withRequestContext = createRequestContextMiddleware(t.middleware);
45
- * export const baseProcedure = t.procedure.use(withRequestContext);
46
- * ```
47
- */
48
- function createRequestContextMiddleware(mw) {
49
- return mw(async (opts) => {
50
- const ctx = opts.ctx;
51
- const requestId = ctx.requestId ?? crypto.randomUUID();
52
- const startTime = ctx.startTime ?? Date.now();
53
- return runWithRequestContext({
54
- logger: ctx.logger,
55
- requestId,
56
- startTime
57
- }, () => opts.next());
58
- });
59
- }
60
-
61
- //#endregion
62
- export { createRequestContextMiddleware, createServicesMiddleware };
63
- //# sourceMappingURL=trpc.mjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"trpc.mjs","names":["mw: CreateMiddleware<TContext, TMeta>","envParser?: EnvironmentParser<{}>","services: [...T]"],"sources":["../../src/adaptors/trpc.ts"],"sourcesContent":["import type { EnvironmentParser } from '@geekmidas/envkit';\nimport type { Logger } from '@geekmidas/logger';\nimport {\n\trunWithRequestContext,\n\ttype Service,\n\tServiceDiscovery,\n\ttype ServiceRecord,\n} from '@geekmidas/services';\nimport type {\n\tTRPCMiddlewareBuilder,\n\tTRPCMiddlewareFunction,\n} from '@trpc/server';\n\n/**\n * Shape of `t.middleware` from `@trpc/server`. We accept this rather than the\n * initialized `t` object so callers retain ownership of their tRPC instance\n * (no double-initialization, no opinion on context/meta shape).\n */\ntype CreateMiddleware<TContext, TMeta> = <$ContextOverrides>(\n\tfn: TRPCMiddlewareFunction<\n\t\tTContext,\n\t\tTMeta,\n\t\tobject,\n\t\t$ContextOverrides,\n\t\tunknown\n\t>,\n) => TRPCMiddlewareBuilder<TContext, TMeta, $ContextOverrides, unknown>;\n\n/**\n * Result of `createServicesMiddleware`: a function that accepts a service\n * tuple and returns a tRPC middleware that merges resolved services onto the\n * context.\n */\nexport type ServicesMiddleware<\n\tTContext extends object,\n\tTMeta extends object,\n> = <const T extends Service[]>(\n\tservices: [...T],\n) => TRPCMiddlewareBuilder<TContext, TMeta, ServiceRecord<T>, unknown>;\n\n/**\n * Context shape required by `createServicesMiddleware` overload 2.\n * Procedures that pull services via context-stored discovery must expose it\n * under `serviceDiscovery`.\n */\nexport interface ContextWithServiceDiscovery {\n\tserviceDiscovery: ServiceDiscovery;\n}\n\n/**\n * Minimum context required for request-context propagation. `logger` must be\n * present so services can call `serviceContext.getLogger()`. `requestId` and\n * `startTime` are auto-generated if missing.\n */\nexport interface ContextWithLogger {\n\tlogger: Logger;\n\trequestId?: string;\n\tstartTime?: number;\n}\n\n/**\n * Create a tRPC middleware that:\n *\n * 1. Resolves the requested services via `ServiceDiscovery`.\n * 2. Wraps the downstream call in `runWithRequestContext` so any code reached\n * by the procedure (including service method implementations) can read the\n * current logger/request id via `serviceContext`.\n * 3. Merges the resolved services onto the tRPC context so handlers can access\n * them by service name (`ctx.database`, `ctx.cache`, ...).\n *\n * Two overloads:\n * - Pass an `envParser` to create a per-request `ServiceDiscovery` instance.\n * - Omit `envParser` to read `ctx.serviceDiscovery` from the tRPC context.\n *\n * @example\n * ```ts\n * import { initTRPC } from '@trpc/server';\n * import { createServicesMiddleware } from '@geekmidas/constructs/trpc';\n *\n * const t = initTRPC.context<Context>().create();\n * const withServices = createServicesMiddleware(t.middleware, envParser);\n *\n * export const authedProcedure = t.procedure.use(\n * withServices([databaseService, cacheService]),\n * );\n * ```\n */\nexport function createServicesMiddleware<\n\tTContext extends ContextWithLogger & object,\n\tTMeta extends object,\n>(\n\tmw: CreateMiddleware<TContext, TMeta>,\n\tenvParser: EnvironmentParser<{}>,\n): ServicesMiddleware<TContext, TMeta>;\nexport function createServicesMiddleware<\n\tTContext extends ContextWithLogger & ContextWithServiceDiscovery & object,\n\tTMeta extends object,\n>(mw: CreateMiddleware<TContext, TMeta>): ServicesMiddleware<TContext, TMeta>;\nexport function createServicesMiddleware<\n\tTContext extends ContextWithLogger & object,\n\tTMeta extends object,\n>(\n\tmw: CreateMiddleware<TContext, TMeta>,\n\tenvParser?: EnvironmentParser<{}>,\n): ServicesMiddleware<TContext, TMeta> {\n\treturn (<const T extends Service[]>(services: [...T]) => {\n\t\tconst builder = mw(async (opts) => {\n\t\t\tconst ctx = opts.ctx as TContext & Partial<ContextWithServiceDiscovery>;\n\n\t\t\tconst discovery =\n\t\t\t\tctx.serviceDiscovery ??\n\t\t\t\tServiceDiscovery.getInstance(\n\t\t\t\t\tenvParser ??\n\t\t\t\t\t\t(() => {\n\t\t\t\t\t\t\t// Hit only if overload 2 was selected but ctx.serviceDiscovery is\n\t\t\t\t\t\t\t// missing at runtime — surface the mistake immediately rather\n\t\t\t\t\t\t\t// than letting an undefined env parser fail deep inside register.\n\t\t\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t\t\t'createServicesMiddleware: no `envParser` provided and ' +\n\t\t\t\t\t\t\t\t\t'`ctx.serviceDiscovery` is missing. Pass an EnvironmentParser ' +\n\t\t\t\t\t\t\t\t\t'to createServicesMiddleware(), or attach a ServiceDiscovery ' +\n\t\t\t\t\t\t\t\t\t'instance to the tRPC context.',\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t})(),\n\t\t\t\t);\n\n\t\t\tconst requestId = ctx.requestId ?? crypto.randomUUID();\n\t\t\tconst startTime = ctx.startTime ?? Date.now();\n\n\t\t\treturn runWithRequestContext(\n\t\t\t\t{ logger: ctx.logger, requestId, startTime },\n\t\t\t\tasync () => {\n\t\t\t\t\tconst resolved = await discovery.register(services);\n\t\t\t\t\treturn opts.next({\n\t\t\t\t\t\tctx: { ...opts.ctx, ...resolved } as typeof opts.ctx &\n\t\t\t\t\t\t\tServiceRecord<T>,\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t);\n\t\t});\n\n\t\t// Tag the inner middleware function with the requested services so external\n\t\t// tooling (e.g. detect-procedures route generators) can introspect a\n\t\t// procedure's service dependencies without re-executing middleware.\n\t\tconst middlewares = (\n\t\t\tbuilder as unknown as { _middlewares?: Array<{ _services?: Service[] }> }\n\t\t)._middlewares;\n\t\tif (middlewares?.length) {\n\t\t\tconst last = middlewares[middlewares.length - 1];\n\t\t\tif (last) last._services = services as unknown as Service[];\n\t\t}\n\n\t\treturn builder as TRPCMiddlewareBuilder<\n\t\t\tTContext,\n\t\t\tTMeta,\n\t\t\tServiceRecord<T>,\n\t\t\tunknown\n\t\t>;\n\t}) as ServicesMiddleware<TContext, TMeta>;\n}\n\n/**\n * Create a tRPC middleware that establishes a request context for downstream\n * code without resolving any services. Useful when services aren't needed on\n * a procedure but the handler (or libraries it calls) still wants to read\n * `serviceContext.getLogger()` / `getRequestId()` / `getRequestStartTime()`.\n *\n * `requestId` and `startTime` are pulled from the tRPC context when present,\n * otherwise generated (`crypto.randomUUID()` and `Date.now()`).\n *\n * @example\n * ```ts\n * const withRequestContext = createRequestContextMiddleware(t.middleware);\n * export const baseProcedure = t.procedure.use(withRequestContext);\n * ```\n */\nexport function createRequestContextMiddleware<\n\tTContext extends ContextWithLogger & object,\n\tTMeta extends object,\n>(\n\tmw: CreateMiddleware<TContext, TMeta>,\n): TRPCMiddlewareBuilder<TContext, TMeta, object, unknown> {\n\treturn mw(async (opts) => {\n\t\tconst ctx = opts.ctx as TContext;\n\t\tconst requestId = ctx.requestId ?? crypto.randomUUID();\n\t\tconst startTime = ctx.startTime ?? Date.now();\n\t\treturn runWithRequestContext(\n\t\t\t{ logger: ctx.logger, requestId, startTime },\n\t\t\t() => opts.next(),\n\t\t);\n\t});\n}\n"],"mappings":";;;AAkGA,SAAgB,yBAIfA,IACAC,WACsC;AACtC,QAAQ,CAA4BC,aAAqB;EACxD,MAAM,UAAU,GAAG,OAAO,SAAS;GAClC,MAAM,MAAM,KAAK;GAEjB,MAAM,YACL,IAAI,oBACJ,iBAAiB,YAChB,aACC,CAAC,MAAM;AAIN,UAAM,IAAI,MACT;GAKD,IAAG,CACL;GAEF,MAAM,YAAY,IAAI,aAAa,OAAO,YAAY;GACtD,MAAM,YAAY,IAAI,aAAa,KAAK,KAAK;AAE7C,UAAO,sBACN;IAAE,QAAQ,IAAI;IAAQ;IAAW;GAAW,GAC5C,YAAY;IACX,MAAM,WAAW,MAAM,UAAU,SAAS,SAAS;AACnD,WAAO,KAAK,KAAK,EAChB,KAAK;KAAE,GAAG,KAAK;KAAK,GAAG;IAAU,EAEjC,EAAC;GACF,EACD;EACD,EAAC;EAKF,MAAM,cACL,QACC;AACF,MAAI,aAAa,QAAQ;GACxB,MAAM,OAAO,YAAY,YAAY,SAAS;AAC9C,OAAI,KAAM,MAAK,YAAY;EAC3B;AAED,SAAO;CAMP;AACD;;;;;;;;;;;;;;;;AAiBD,SAAgB,+BAIfF,IAC0D;AAC1D,QAAO,GAAG,OAAO,SAAS;EACzB,MAAM,MAAM,KAAK;EACjB,MAAM,YAAY,IAAI,aAAa,OAAO,YAAY;EACtD,MAAM,YAAY,IAAI,aAAa,KAAK,KAAK;AAC7C,SAAO,sBACN;GAAE,QAAQ,IAAI;GAAQ;GAAW;EAAW,GAC5C,MAAM,KAAK,MAAM,CACjB;CACD,EAAC;AACF"}
@@ -1,27 +0,0 @@
1
- //#region rolldown:runtime
2
- var __create = Object.create;
3
- var __defProp = Object.defineProperty;
4
- var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
5
- var __getOwnPropNames = Object.getOwnPropertyNames;
6
- var __getProtoOf = Object.getPrototypeOf;
7
- var __hasOwnProp = Object.prototype.hasOwnProperty;
8
- var __commonJS = (cb, mod) => function() {
9
- return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
10
- };
11
- var __copyProps = (to, from, except, desc) => {
12
- if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
13
- key = keys[i];
14
- if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
15
- get: ((k) => from[k]).bind(null, key),
16
- enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
17
- });
18
- }
19
- return to;
20
- };
21
- var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
22
- value: mod,
23
- enumerable: true
24
- }) : target, mod));
25
-
26
- //#endregion
27
- export { __commonJS, __toESM };
@@ -1,39 +0,0 @@
1
- //#region rolldown:runtime
2
- var __create = Object.create;
3
- var __defProp = Object.defineProperty;
4
- var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
5
- var __getOwnPropNames = Object.getOwnPropertyNames;
6
- var __getProtoOf = Object.getPrototypeOf;
7
- var __hasOwnProp = Object.prototype.hasOwnProperty;
8
- var __commonJS = (cb, mod) => function() {
9
- return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
10
- };
11
- var __copyProps = (to, from, except, desc) => {
12
- if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
13
- key = keys[i];
14
- if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
15
- get: ((k) => from[k]).bind(null, key),
16
- enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
17
- });
18
- }
19
- return to;
20
- };
21
- var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
22
- value: mod,
23
- enumerable: true
24
- }) : target, mod));
25
-
26
- //#endregion
27
-
28
- Object.defineProperty(exports, '__commonJS', {
29
- enumerable: true,
30
- get: function () {
31
- return __commonJS;
32
- }
33
- });
34
- Object.defineProperty(exports, '__toESM', {
35
- enumerable: true,
36
- get: function () {
37
- return __toESM;
38
- }
39
- });