@geekmidas/constructs 10.0.0-alpha.98 → 10.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.
- package/CHANGELOG.md +437 -0
- package/README.md +193 -285
- package/dist/AWSScheduledFunction-BzGCUbkk.d.mts +117 -0
- package/dist/AWSScheduledFunction-BzGCUbkk.d.mts.map +1 -0
- package/dist/AWSScheduledFunction-C42adp8A.cjs +266 -0
- package/dist/AWSScheduledFunction-C42adp8A.cjs.map +1 -0
- package/dist/AWSScheduledFunction-CsNJhXQj.d.cts +117 -0
- package/dist/AWSScheduledFunction-CsNJhXQj.d.cts.map +1 -0
- package/dist/AWSScheduledFunction-KP6lqbsW.mjs +254 -0
- package/dist/AWSScheduledFunction-KP6lqbsW.mjs.map +1 -0
- package/dist/{Construct-B1vGBPme.mjs → Construct-BWF5HxaM.mjs} +37 -47
- package/dist/Construct-BWF5HxaM.mjs.map +1 -0
- package/dist/Construct-JlyQkBkv.d.cts +117 -0
- package/dist/Construct-JlyQkBkv.d.cts.map +1 -0
- package/dist/{Construct-DUSXuTHP.cjs → Construct-TGIM_E4o.cjs} +88 -67
- package/dist/Construct-TGIM_E4o.cjs.map +1 -0
- package/dist/Construct-pxwC6fDD.d.mts +117 -0
- package/dist/Construct-pxwC6fDD.d.mts.map +1 -0
- package/dist/{Endpoint-Du-NwPX2.d.mts → Endpoint-B0P_pEMr.d.mts} +85 -126
- package/dist/Endpoint-B0P_pEMr.d.mts.map +1 -0
- package/dist/{Endpoint-aCvBMPoH.d.cts → Endpoint-BLZ7r67m.d.cts} +84 -125
- package/dist/Endpoint-BLZ7r67m.d.cts.map +1 -0
- package/dist/{HonoEndpointAdaptor-PtPlbeKY.mjs → HonoEndpointAdaptor-BMVwx2cz.mjs} +69 -81
- package/dist/HonoEndpointAdaptor-BMVwx2cz.mjs.map +1 -0
- package/dist/{HonoEndpointAdaptor-zVzVLJEO.cjs → HonoEndpointAdaptor-DPDsDi-D.cjs} +77 -92
- package/dist/HonoEndpointAdaptor-DPDsDi-D.cjs.map +1 -0
- package/dist/Queue-BL68oDJ-.d.mts +66 -0
- package/dist/Queue-BL68oDJ-.d.mts.map +1 -0
- package/dist/Queue-DxJ6btRE.d.cts +66 -0
- package/dist/Queue-DxJ6btRE.d.cts.map +1 -0
- package/dist/Subscriber-BpVhcGhX.d.cts +47 -0
- package/dist/Subscriber-BpVhcGhX.d.cts.map +1 -0
- package/dist/Subscriber-DF6xsBAJ.d.mts +47 -0
- package/dist/Subscriber-DF6xsBAJ.d.mts.map +1 -0
- package/dist/Topic-DJXoDeMP.d.cts +60 -0
- package/dist/Topic-DJXoDeMP.d.cts.map +1 -0
- package/dist/Topic-DxWQBgMN.d.mts +60 -0
- package/dist/Topic-DxWQBgMN.d.mts.map +1 -0
- package/dist/adaptors/aws.cjs +205 -355
- package/dist/adaptors/aws.cjs.map +1 -1
- package/dist/adaptors/aws.d.cts +48 -126
- package/dist/adaptors/aws.d.cts.map +1 -1
- package/dist/adaptors/aws.d.mts +49 -127
- package/dist/adaptors/aws.d.mts.map +1 -1
- package/dist/adaptors/aws.mjs +178 -325
- package/dist/adaptors/aws.mjs.map +1 -1
- package/dist/adaptors/hono.cjs +9 -3
- package/dist/adaptors/hono.d.cts +15 -7
- package/dist/adaptors/hono.d.cts.map +1 -1
- package/dist/adaptors/hono.d.mts +17 -9
- package/dist/adaptors/hono.d.mts.map +1 -1
- package/dist/adaptors/hono.mjs +9 -2
- package/dist/adaptors/testing.cjs +209 -831
- package/dist/adaptors/testing.cjs.map +1 -1
- package/dist/adaptors/testing.d.cts +55 -351
- package/dist/adaptors/testing.d.cts.map +1 -1
- package/dist/adaptors/testing.d.mts +53 -349
- package/dist/adaptors/testing.d.mts.map +1 -1
- package/dist/adaptors/testing.mjs +195 -798
- package/dist/adaptors/testing.mjs.map +1 -1
- package/dist/{clone-UGJpvQnL.cjs → clone-I_WIpiFf.cjs} +8 -7
- package/dist/clone-I_WIpiFf.cjs.map +1 -0
- package/dist/{clone-EKNovYHu.mjs → clone-pdXxc0t3.mjs} +3 -3
- package/dist/clone-pdXxc0t3.mjs.map +1 -0
- package/dist/crons/index.cjs +66 -190
- package/dist/crons/index.cjs.map +1 -1
- package/dist/crons/index.d.cts +35 -70
- package/dist/crons/index.d.cts.map +1 -1
- package/dist/crons/index.d.mts +32 -70
- package/dist/crons/index.d.mts.map +1 -1
- package/dist/crons/index.mjs +63 -184
- package/dist/crons/index.mjs.map +1 -1
- package/dist/endpoints/index.cjs +761 -19
- package/dist/endpoints/index.cjs.map +1 -0
- package/dist/endpoints/index.d.cts +322 -22
- package/dist/endpoints/index.d.cts.map +1 -1
- package/dist/endpoints/index.d.mts +321 -22
- package/dist/endpoints/index.d.mts.map +1 -1
- package/dist/endpoints/index.mjs +751 -6
- package/dist/endpoints/index.mjs.map +1 -0
- package/dist/functions/index.cjs +5 -2
- package/dist/functions/index.d.cts +3 -3
- package/dist/functions/index.d.mts +3 -3
- package/dist/functions/index.mjs +5 -2
- package/dist/{functions-BFizikJU.mjs → functions-EqTloHjo.mjs} +331 -425
- package/dist/functions-EqTloHjo.mjs.map +1 -0
- package/dist/{functions-CfzJG9hK.cjs → functions-SqtCDc9c.cjs} +370 -459
- package/dist/functions-SqtCDc9c.cjs.map +1 -0
- package/dist/index-C7iynzLI.d.mts +139 -0
- package/dist/index-C7iynzLI.d.mts.map +1 -0
- package/dist/index-D4dM_WDY.d.cts +142 -0
- package/dist/index-D4dM_WDY.d.cts.map +1 -0
- package/dist/index.cjs +3 -6
- package/dist/index.d.cts +4 -27
- package/dist/index.d.mts +4 -27
- package/dist/index.mjs +3 -3
- package/dist/{Endpoint-BG4UJ9oA.mjs → lazyAccessors-CCTK19xj.mjs} +1040 -914
- package/dist/lazyAccessors-CCTK19xj.mjs.map +1 -0
- package/dist/{Endpoint-BoUg8ocM.cjs → lazyAccessors-D04oftGw.cjs} +1127 -960
- package/dist/lazyAccessors-D04oftGw.cjs.map +1 -0
- package/dist/monitors/index.cjs +49 -0
- package/dist/monitors/index.cjs.map +1 -0
- package/dist/monitors/index.d.cts +45 -0
- package/dist/monitors/index.d.cts.map +1 -0
- package/dist/monitors/index.d.mts +45 -0
- package/dist/monitors/index.d.mts.map +1 -0
- package/dist/monitors/index.mjs +48 -0
- package/dist/monitors/index.mjs.map +1 -0
- package/dist/processAudits-BJZT5gmy.cjs +92 -0
- package/dist/processAudits-BJZT5gmy.cjs.map +1 -0
- package/dist/processAudits-CwyaaSQc.mjs +80 -0
- package/dist/processAudits-CwyaaSQc.mjs.map +1 -0
- package/dist/publisher-BZgcrVPy.cjs +53 -0
- package/dist/publisher-BZgcrVPy.cjs.map +1 -0
- package/dist/publisher-CnpeMv-r.mjs +41 -0
- package/dist/publisher-CnpeMv-r.mjs.map +1 -0
- package/dist/queue/index.cjs +114 -6
- package/dist/queue/index.cjs.map +1 -0
- package/dist/queue/index.d.cts +45 -3
- package/dist/queue/index.d.cts.map +1 -0
- package/dist/queue/index.d.mts +44 -3
- package/dist/queue/index.d.mts.map +1 -0
- package/dist/queue/index.mjs +112 -3
- package/dist/queue/index.mjs.map +1 -0
- package/dist/subscribers/index.cjs +80 -111
- package/dist/subscribers/index.cjs.map +1 -1
- package/dist/subscribers/index.d.cts +43 -46
- package/dist/subscribers/index.d.cts.map +1 -1
- package/dist/subscribers/index.d.mts +42 -46
- package/dist/subscribers/index.d.mts.map +1 -1
- package/dist/subscribers/index.mjs +78 -108
- package/dist/subscribers/index.mjs.map +1 -1
- package/dist/{lambdaTelemetry-8vnmVZQ5.d.cts → telemetry-C--EgYVr.d.mts} +7 -4
- package/dist/telemetry-C--EgYVr.d.mts.map +1 -0
- package/dist/{lambdaTelemetry-8vnmVZQ5.d.mts → telemetry-Dqx-D3F7.d.cts} +7 -4
- package/dist/telemetry-Dqx-D3F7.d.cts.map +1 -0
- package/dist/topic/index.cjs +91 -3
- package/dist/topic/index.cjs.map +1 -0
- package/dist/topic/index.d.cts +32 -2
- package/dist/topic/index.d.cts.map +1 -0
- package/dist/topic/index.d.mts +32 -2
- package/dist/topic/index.d.mts.map +1 -0
- package/dist/topic/index.mjs +89 -2
- package/dist/topic/index.mjs.map +1 -0
- package/dist/{types-DMuSQeLL.d.cts → types-BdAaYDvd.d.cts} +5 -3
- package/dist/types-BdAaYDvd.d.cts.map +1 -0
- package/dist/{types-DMuSQeLL.d.mts → types-DNngH0fX.d.mts} +5 -3
- package/dist/types-DNngH0fX.d.mts.map +1 -0
- package/dist/types.d.cts +1 -1
- package/dist/types.d.mts +1 -1
- package/dist/types.mjs +0 -1
- package/package.json +55 -223
- package/src/Construct.ts +209 -0
- package/src/__benchmarks__/build-time-optimization.bench.ts +274 -0
- package/src/__benchmarks__/endpoint.bench.ts +494 -0
- package/src/__benchmarks__/fixtures.ts +241 -0
- package/src/__benchmarks__/hono-adaptor.bench.ts +533 -0
- package/src/__benchmarks__/hono-server.bench.ts +249 -0
- package/src/__benchmarks__/response-builder.bench.ts +428 -0
- package/src/__benchmarks__/strategies/strategy-a-lazy-services.ts +319 -0
- package/src/__benchmarks__/strategies/strategy-c-middleware.ts +530 -0
- package/src/__benchmarks__/strategies/strategy-d-opt-in-events.ts +567 -0
- package/src/__tests__/Construct.environment.spec.ts +704 -0
- package/src/__tests__/builder-reuse.spec.ts +587 -0
- package/src/__tests__/monitor.spec.ts +636 -0
- package/src/__tests__/publisher.setting.spec.ts +508 -0
- package/src/__tests__/publisher.spec.ts +452 -0
- package/src/adaptors/aws.ts +6 -0
- package/src/adaptors/hono.ts +1 -0
- package/src/adaptors/testing.ts +11 -0
- package/src/clone.ts +38 -0
- package/src/crons/AWSScheduledFunction.ts +73 -0
- package/src/crons/Cron.ts +149 -0
- package/src/crons/CronBuilder.ts +261 -0
- package/src/crons/__tests__/AWSScheduledFunction.spec.ts +152 -0
- package/src/crons/__tests__/Cron.spec.ts +472 -0
- package/src/crons/__tests__/CronBuilder.state-isolation.spec.ts +273 -0
- package/src/crons/index.ts +12 -0
- package/src/endpoints/AmazonApiGatewayEndpointAdaptor.ts +698 -0
- package/src/endpoints/AmazonApiGatewayV1EndpointAdaptor.ts +105 -0
- package/src/endpoints/AmazonApiGatewayV2EndpointAdaptor.ts +97 -0
- package/src/endpoints/Authorizer.ts +152 -0
- package/src/endpoints/Endpoint.ts +1287 -0
- package/src/endpoints/EndpointBuilder.ts +749 -0
- package/src/endpoints/EndpointFactory.ts +1179 -0
- package/src/endpoints/HonoEndpointAdaptor.ts +692 -0
- package/src/endpoints/MswEndpointAdaptor.ts +226 -0
- package/src/endpoints/TestEndpointAdaptor.ts +466 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.audits.spec.ts +499 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.events.spec.ts +560 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.spec.ts +1304 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.audits.spec.ts +626 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.events.spec.ts +732 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.factory-publisher.spec.ts +296 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.kysely-audit.integration.spec.ts +951 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.responseType.spec.ts +111 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.rls.spec.ts +307 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.spec.ts +629 -0
- package/src/endpoints/__tests__/Authorizer.spec.ts +286 -0
- package/src/endpoints/__tests__/Endpoint.cookies.spec.ts +207 -0
- package/src/endpoints/__tests__/Endpoint.headers.spec.ts +187 -0
- package/src/endpoints/__tests__/Endpoint.manifest.spec.ts +175 -0
- package/src/endpoints/__tests__/Endpoint.spec.ts +857 -0
- package/src/endpoints/__tests__/EndpointBuilder.audit.spec.ts +451 -0
- package/src/endpoints/__tests__/EndpointBuilder.responseType.spec.ts +50 -0
- package/src/endpoints/__tests__/EndpointBuilder.spec.ts +531 -0
- package/src/endpoints/__tests__/EndpointFactory.authorizers.spec.ts +492 -0
- package/src/endpoints/__tests__/EndpointFactory.database-auditor.spec.ts +509 -0
- package/src/endpoints/__tests__/EndpointFactory.reference-audit.spec.ts +190 -0
- package/src/endpoints/__tests__/EndpointFactory.spec.ts +479 -0
- package/src/endpoints/__tests__/EndpointFactory.state-isolation.spec.ts +155 -0
- package/src/endpoints/__tests__/HonoEndpointAdaptor.audit-transactions.spec.ts +703 -0
- package/src/endpoints/__tests__/HonoEndpointAdaptor.audits.spec.ts +632 -0
- package/src/endpoints/__tests__/HonoEndpointAdaptor.events.spec.ts +577 -0
- package/src/endpoints/__tests__/HonoEndpointAdaptor.kysely-audit.integration.spec.ts +1067 -0
- package/src/endpoints/__tests__/HonoEndpointAdaptor.openapi.spec.ts +317 -0
- package/src/endpoints/__tests__/HonoEndpointAdaptor.pgboss-publisher.spec.ts +289 -0
- package/src/endpoints/__tests__/HonoEndpointAdaptor.responseType.spec.ts +128 -0
- package/src/endpoints/__tests__/HonoEndpointAdaptor.spec.ts +1207 -0
- package/src/endpoints/__tests__/MswEndpointAdaptor.spec.ts +211 -0
- package/src/endpoints/__tests__/ResponseBuilder.spec.ts +235 -0
- package/src/endpoints/__tests__/TestEndpointAdaptor.audits.spec.ts +602 -0
- package/src/endpoints/__tests__/TestEndpointAdaptor.spec.ts +1044 -0
- package/src/endpoints/__tests__/__snapshots__/HonoEndpointAdaptor.spec.ts.snap +54 -0
- package/src/endpoints/__tests__/endpoint-types.test.ts +88 -0
- package/src/endpoints/__tests__/helpers.spec.ts +37 -0
- package/src/endpoints/__tests__/lazyAccessors.spec.ts +330 -0
- package/src/endpoints/__tests__/processAudits.spec.ts +631 -0
- package/src/endpoints/audit.ts +87 -0
- package/src/endpoints/helpers.ts +98 -0
- package/src/endpoints/index.ts +42 -0
- package/src/endpoints/lazyAccessors.ts +241 -0
- package/src/endpoints/parseHonoQuery.ts +16 -0
- package/src/endpoints/parseQueryParams.ts +32 -0
- package/src/endpoints/processAudits.ts +371 -0
- package/src/endpoints/rls.ts +67 -0
- package/src/functions/AWSLambdaFunction.ts +374 -0
- package/src/functions/BaseFunctionBuilder.ts +212 -0
- package/src/functions/Function.ts +238 -0
- package/src/functions/FunctionBuilder.ts +381 -0
- package/src/functions/FunctionExecutionWrapper.ts +216 -0
- package/src/functions/TestFunctionAdaptor.ts +252 -0
- package/src/functions/__tests__/AWSLambdaFunctionAdaptor.spec.ts +513 -0
- package/src/functions/__tests__/Function.audits.spec.ts +393 -0
- package/src/functions/__tests__/Function.spec.ts +477 -0
- package/src/functions/__tests__/FunctionBuilder.state-isolation.spec.ts +250 -0
- package/src/functions/__tests__/TestFunctionAdaptor.spec.ts +480 -0
- package/src/functions/index.ts +12 -0
- package/src/index.ts +29 -0
- package/src/monitor.ts +145 -0
- package/src/monitors/heartbeat.ts +86 -0
- package/src/monitors/index.ts +6 -0
- package/src/publisher.ts +93 -0
- package/src/queue/AWSLambdaQueueAdaptor.ts +162 -0
- package/src/queue/Queue.ts +128 -0
- package/src/queue/QueueBuilder.ts +115 -0
- package/src/queue/TestQueueAdaptor.ts +63 -0
- package/src/queue/__tests__/QueueBuilder.spec.ts +137 -0
- package/src/queue/index.ts +12 -0
- package/src/subscribers/AWSLambdaSubscriberAdaptor.ts +342 -0
- package/src/subscribers/Subscriber.ts +117 -0
- package/src/subscribers/SubscriberBuilder.ts +183 -0
- package/src/subscribers/TestSubscriberAdaptor.ts +133 -0
- package/src/subscribers/__tests__/AWSLambdaSubscriberAdaptor.spec.ts +1018 -0
- package/src/subscribers/__tests__/Subscriber.spec.ts +430 -0
- package/src/subscribers/__tests__/TestSubscriberAdaptor.spec.ts +652 -0
- package/src/subscribers/index.ts +6 -0
- package/src/telemetry.ts +103 -0
- package/src/topic/Topic.ts +103 -0
- package/src/topic/TopicBuilder.ts +53 -0
- package/src/topic/__tests__/TopicBuilder.spec.ts +82 -0
- package/src/topic/index.ts +11 -0
- package/src/types.ts +13 -0
- package/test.ts +91 -0
- package/tsconfig.json +9 -0
- package/tsdown.config.ts +35 -0
- package/dist/Construct-B1vGBPme.mjs.map +0 -1
- package/dist/Construct-BQALFCh2.d.cts +0 -230
- package/dist/Construct-BQALFCh2.d.cts.map +0 -1
- package/dist/Construct-DUSXuTHP.cjs.map +0 -1
- package/dist/Construct-QXnl3VqT.d.mts +0 -230
- package/dist/Construct-QXnl3VqT.d.mts.map +0 -1
- package/dist/Cron-DI3nKoic.d.cts +0 -45
- package/dist/Cron-DI3nKoic.d.cts.map +0 -1
- package/dist/Cron-uYAHPnp7.d.mts +0 -45
- package/dist/Cron-uYAHPnp7.d.mts.map +0 -1
- package/dist/CronBuilder-C0Ek1-RA.cjs +0 -121
- package/dist/CronBuilder-C0Ek1-RA.cjs.map +0 -1
- package/dist/CronBuilder-DaSUm2Na.d.mts +0 -47
- package/dist/CronBuilder-DaSUm2Na.d.mts.map +0 -1
- package/dist/CronBuilder-Dmix_Pen.mjs +0 -109
- package/dist/CronBuilder-Dmix_Pen.mjs.map +0 -1
- package/dist/CronBuilder-g1lZLWyG.d.cts +0 -47
- package/dist/CronBuilder-g1lZLWyG.d.cts.map +0 -1
- package/dist/Endpoint-BG4UJ9oA.mjs.map +0 -1
- package/dist/Endpoint-BoUg8ocM.cjs.map +0 -1
- package/dist/Endpoint-Du-NwPX2.d.mts.map +0 -1
- package/dist/Endpoint-aCvBMPoH.d.cts.map +0 -1
- package/dist/EndpointFactory-BDtsrEvJ.mjs +0 -791
- package/dist/EndpointFactory-BDtsrEvJ.mjs.map +0 -1
- package/dist/EndpointFactory-DJ7gXLpR.cjs +0 -833
- package/dist/EndpointFactory-DJ7gXLpR.cjs.map +0 -1
- package/dist/EndpointFactory-DMYdJCOj.d.mts +0 -363
- package/dist/EndpointFactory-DMYdJCOj.d.mts.map +0 -1
- package/dist/EndpointFactory-I7s1co3Y.d.cts +0 -363
- package/dist/EndpointFactory-I7s1co3Y.d.cts.map +0 -1
- package/dist/Function-DuqGcbOI.d.mts +0 -76
- package/dist/Function-DuqGcbOI.d.mts.map +0 -1
- package/dist/Function-Pu-1kKZz.d.cts +0 -76
- package/dist/Function-Pu-1kKZz.d.cts.map +0 -1
- package/dist/HonoEndpointAdaptor-PtPlbeKY.mjs.map +0 -1
- package/dist/HonoEndpointAdaptor-zVzVLJEO.cjs.map +0 -1
- package/dist/Queue-A3wfD0it.cjs +0 -109
- package/dist/Queue-A3wfD0it.cjs.map +0 -1
- package/dist/Queue-D6USGS4q.mjs +0 -104
- package/dist/Queue-D6USGS4q.mjs.map +0 -1
- package/dist/Queue-DlsHRzUp.d.mts +0 -105
- package/dist/Queue-DlsHRzUp.d.mts.map +0 -1
- package/dist/Queue-HPyi0e1i.d.cts +0 -105
- package/dist/Queue-HPyi0e1i.d.cts.map +0 -1
- package/dist/QueueBuilder-BjuF0UBl.cjs +0 -135
- package/dist/QueueBuilder-BjuF0UBl.cjs.map +0 -1
- package/dist/QueueBuilder-Cue73M4t.mjs +0 -118
- package/dist/QueueBuilder-Cue73M4t.mjs.map +0 -1
- package/dist/QueueBuilder-OSi6LkV9.d.cts +0 -75
- package/dist/QueueBuilder-OSi6LkV9.d.cts.map +0 -1
- package/dist/QueueBuilder-QHsnVt1P.d.mts +0 -75
- package/dist/QueueBuilder-QHsnVt1P.d.mts.map +0 -1
- package/dist/Subscriber-Bpp02cGr.d.cts +0 -61
- package/dist/Subscriber-Bpp02cGr.d.cts.map +0 -1
- package/dist/Subscriber-CtN9R48-.d.mts +0 -61
- package/dist/Subscriber-CtN9R48-.d.mts.map +0 -1
- package/dist/SubscriberBuilder-CDy4nHCz.mjs +0 -134
- package/dist/SubscriberBuilder-CDy4nHCz.mjs.map +0 -1
- package/dist/SubscriberBuilder-CuCMFpYW.d.mts +0 -67
- package/dist/SubscriberBuilder-CuCMFpYW.d.mts.map +0 -1
- package/dist/SubscriberBuilder-D_owVoHo.cjs +0 -145
- package/dist/SubscriberBuilder-D_owVoHo.cjs.map +0 -1
- package/dist/SubscriberBuilder-g3fAVWgs.d.cts +0 -67
- package/dist/SubscriberBuilder-g3fAVWgs.d.cts.map +0 -1
- package/dist/Topic-D74b5cgs.mjs +0 -99
- package/dist/Topic-D74b5cgs.mjs.map +0 -1
- package/dist/Topic-GHxcU8AG.cjs +0 -104
- package/dist/Topic-GHxcU8AG.cjs.map +0 -1
- package/dist/auth-BMCJN30Y.d.cts +0 -268
- package/dist/auth-BMCJN30Y.d.cts.map +0 -1
- package/dist/auth-CcuceLYo.d.mts +0 -268
- package/dist/auth-CcuceLYo.d.mts.map +0 -1
- package/dist/auth.cjs +0 -433
- package/dist/auth.cjs.map +0 -1
- package/dist/auth.d.cts +0 -2
- package/dist/auth.d.mts +0 -2
- package/dist/auth.mjs +0 -426
- package/dist/auth.mjs.map +0 -1
- package/dist/cache-CXh6GIgb.d.mts +0 -44
- package/dist/cache-CXh6GIgb.d.mts.map +0 -1
- package/dist/cache-DnGDGly3.d.cts +0 -44
- package/dist/cache-DnGDGly3.d.cts.map +0 -1
- package/dist/cache.cjs +0 -69
- package/dist/cache.cjs.map +0 -1
- package/dist/cache.d.cts +0 -2
- package/dist/cache.d.mts +0 -2
- package/dist/cache.mjs +0 -68
- package/dist/cache.mjs.map +0 -1
- package/dist/cipher-C1lEFX63.mjs +0 -225
- package/dist/cipher-C1lEFX63.mjs.map +0 -1
- package/dist/cipher-CVxfwLjk.cjs +0 -332
- package/dist/cipher-CVxfwLjk.cjs.map +0 -1
- package/dist/clone-EKNovYHu.mjs.map +0 -1
- package/dist/clone-UGJpvQnL.cjs.map +0 -1
- package/dist/construct-interface-B1AfqRl4.d.cts +0 -162
- package/dist/construct-interface-B1AfqRl4.d.cts.map +0 -1
- package/dist/construct-interface-DluK3_da.d.mts +0 -162
- package/dist/construct-interface-DluK3_da.d.mts.map +0 -1
- package/dist/construct-interface.cjs +0 -114
- package/dist/construct-interface.cjs.map +0 -1
- package/dist/construct-interface.d.cts +0 -2
- package/dist/construct-interface.d.mts +0 -2
- package/dist/construct-interface.mjs +0 -107
- package/dist/construct-interface.mjs.map +0 -1
- package/dist/credential.cjs +0 -156
- package/dist/credential.cjs.map +0 -1
- package/dist/credential.d.cts +0 -86
- package/dist/credential.d.cts.map +0 -1
- package/dist/credential.d.mts +0 -86
- package/dist/credential.d.mts.map +0 -1
- package/dist/credential.mjs +0 -152
- package/dist/credential.mjs.map +0 -1
- package/dist/database/kysely.cjs +0 -4
- package/dist/database/kysely.d.cts +0 -2
- package/dist/database/kysely.d.mts +0 -2
- package/dist/database/kysely.mjs +0 -2
- package/dist/email.cjs +0 -72
- package/dist/email.cjs.map +0 -1
- package/dist/email.d.cts +0 -46
- package/dist/email.d.cts.map +0 -1
- package/dist/email.d.mts +0 -46
- package/dist/email.d.mts.map +0 -1
- package/dist/email.mjs +0 -71
- package/dist/email.mjs.map +0 -1
- package/dist/encryption.cjs +0 -96
- package/dist/encryption.cjs.map +0 -1
- package/dist/encryption.d.cts +0 -117
- package/dist/encryption.d.cts.map +0 -1
- package/dist/encryption.d.mts +0 -117
- package/dist/encryption.d.mts.map +0 -1
- package/dist/encryption.mjs +0 -83
- package/dist/encryption.mjs.map +0 -1
- package/dist/external-api-MJ8id87V.d.mts +0 -105
- package/dist/external-api-MJ8id87V.d.mts.map +0 -1
- package/dist/external-api-O107yzZJ.d.cts +0 -105
- package/dist/external-api-O107yzZJ.d.cts.map +0 -1
- package/dist/external-api.cjs +0 -142
- package/dist/external-api.cjs.map +0 -1
- package/dist/external-api.d.cts +0 -2
- package/dist/external-api.d.mts +0 -2
- package/dist/external-api.mjs +0 -139
- package/dist/external-api.mjs.map +0 -1
- package/dist/file-server.cjs +0 -186
- package/dist/file-server.cjs.map +0 -1
- package/dist/file-server.d.cts +0 -152
- package/dist/file-server.d.cts.map +0 -1
- package/dist/file-server.d.mts +0 -152
- package/dist/file-server.d.mts.map +0 -1
- package/dist/file-server.mjs +0 -184
- package/dist/file-server.mjs.map +0 -1
- package/dist/functions-BFizikJU.mjs.map +0 -1
- package/dist/functions-CfzJG9hK.cjs.map +0 -1
- package/dist/index-BuzRvKOQ.d.cts +0 -115
- package/dist/index-BuzRvKOQ.d.cts.map +0 -1
- package/dist/index-CTkKOer4.d.mts +0 -115
- package/dist/index-CTkKOer4.d.mts.map +0 -1
- package/dist/index-CeEtxDmK.d.cts +0 -79
- package/dist/index-CeEtxDmK.d.cts.map +0 -1
- package/dist/index-CeEtxDmK.d.mts +0 -79
- package/dist/index-CeEtxDmK.d.mts.map +0 -1
- package/dist/index.d.cts.map +0 -1
- package/dist/index.d.mts.map +0 -1
- package/dist/kms-B-Hm3d5r.cjs +0 -85
- package/dist/kms-B-Hm3d5r.cjs.map +0 -1
- package/dist/kms-BdUlMJEZ.mjs +0 -85
- package/dist/kms-BdUlMJEZ.mjs.map +0 -1
- package/dist/kysely-Bii4l6eP.mjs +0 -370
- package/dist/kysely-Bii4l6eP.mjs.map +0 -1
- package/dist/kysely-CO_Dk43W.cjs +0 -383
- package/dist/kysely-CO_Dk43W.cjs.map +0 -1
- package/dist/kysely-D0bpzgPs.d.cts +0 -175
- package/dist/kysely-D0bpzgPs.d.cts.map +0 -1
- package/dist/kysely-DUqC3Ie0.d.mts +0 -175
- package/dist/kysely-DUqC3Ie0.d.mts.map +0 -1
- package/dist/lambdaTelemetry-8vnmVZQ5.d.cts.map +0 -1
- package/dist/lambdaTelemetry-8vnmVZQ5.d.mts.map +0 -1
- package/dist/lazyAccessors-CFanua0O.mjs +0 -174
- package/dist/lazyAccessors-CFanua0O.mjs.map +0 -1
- package/dist/lazyAccessors-hJKGv8Ay.cjs +0 -221
- package/dist/lazyAccessors-hJKGv8Ay.cjs.map +0 -1
- package/dist/mobile-app.cjs +0 -73
- package/dist/mobile-app.cjs.map +0 -1
- package/dist/mobile-app.d.cts +0 -61
- package/dist/mobile-app.d.cts.map +0 -1
- package/dist/mobile-app.d.mts +0 -61
- package/dist/mobile-app.d.mts.map +0 -1
- package/dist/mobile-app.mjs +0 -72
- package/dist/mobile-app.mjs.map +0 -1
- package/dist/object-storage.cjs +0 -56
- package/dist/object-storage.cjs.map +0 -1
- package/dist/object-storage.d.cts +0 -32
- package/dist/object-storage.d.cts.map +0 -1
- package/dist/object-storage.d.mts +0 -32
- package/dist/object-storage.d.mts.map +0 -1
- package/dist/object-storage.mjs +0 -55
- package/dist/object-storage.mjs.map +0 -1
- package/dist/processAudits-BRRVVHUB.mjs +0 -131
- package/dist/processAudits-BRRVVHUB.mjs.map +0 -1
- package/dist/processAudits-DasOZjPl.cjs +0 -154
- package/dist/processAudits-DasOZjPl.cjs.map +0 -1
- package/dist/rest-api.cjs +0 -216
- package/dist/rest-api.cjs.map +0 -1
- package/dist/rest-api.d.cts +0 -241
- package/dist/rest-api.d.cts.map +0 -1
- package/dist/rest-api.d.mts +0 -241
- package/dist/rest-api.d.mts.map +0 -1
- package/dist/rest-api.mjs +0 -215
- package/dist/rest-api.mjs.map +0 -1
- package/dist/rolldown-runtime-y5ARvAq5.cjs +0 -35
- package/dist/runSubscriber-BHvJ8POr.mjs +0 -109
- package/dist/runSubscriber-BHvJ8POr.mjs.map +0 -1
- package/dist/runSubscriber-D8nLXIv1.cjs +0 -126
- package/dist/runSubscriber-D8nLXIv1.cjs.map +0 -1
- package/dist/shutdown-BMJmAhSt.cjs +0 -38
- package/dist/shutdown-BMJmAhSt.cjs.map +0 -1
- package/dist/shutdown-C7xa8x9S.mjs +0 -27
- package/dist/shutdown-C7xa8x9S.mjs.map +0 -1
- package/dist/site.cjs +0 -74
- package/dist/site.cjs.map +0 -1
- package/dist/site.d.cts +0 -104
- package/dist/site.d.cts.map +0 -1
- package/dist/site.d.mts +0 -104
- package/dist/site.d.mts.map +0 -1
- package/dist/site.mjs +0 -73
- package/dist/site.mjs.map +0 -1
- package/dist/stages-BSCF19o2.d.cts +0 -56
- package/dist/stages-BSCF19o2.d.cts.map +0 -1
- package/dist/stages-BSCF19o2.d.mts +0 -56
- package/dist/stages-BSCF19o2.d.mts.map +0 -1
- package/dist/surfaceEnv-CNimK76p.cjs +0 -56
- package/dist/surfaceEnv-CNimK76p.cjs.map +0 -1
- package/dist/surfaceEnv-wMT5QzgZ.mjs +0 -45
- package/dist/surfaceEnv-wMT5QzgZ.mjs.map +0 -1
- package/dist/telemetry-B48RLjyk.d.cts +0 -40
- package/dist/telemetry-B48RLjyk.d.cts.map +0 -1
- package/dist/telemetry-DRtT1_0A.d.mts +0 -40
- package/dist/telemetry-DRtT1_0A.d.mts.map +0 -1
- package/dist/telemetry.cjs +0 -56
- package/dist/telemetry.cjs.map +0 -1
- package/dist/telemetry.d.cts +0 -2
- package/dist/telemetry.d.mts +0 -2
- package/dist/telemetry.mjs +0 -55
- package/dist/telemetry.mjs.map +0 -1
- package/dist/tracing-CxaZ98IB.mjs +0 -110
- package/dist/tracing-CxaZ98IB.mjs.map +0 -1
- package/dist/tracing-DPMidF_r.cjs +0 -127
- package/dist/tracing-DPMidF_r.cjs.map +0 -1
- package/dist/types-DMuSQeLL.d.cts.map +0 -1
- package/dist/types-DMuSQeLL.d.mts.map +0 -1
- package/dist/worker.cjs +0 -191
- package/dist/worker.cjs.map +0 -1
- package/dist/worker.d.cts +0 -171
- package/dist/worker.d.cts.map +0 -1
- package/dist/worker.d.mts +0 -171
- package/dist/worker.d.mts.map +0 -1
- package/dist/worker.mjs +0 -190
- package/dist/worker.mjs.map +0 -1
package/dist/Topic-D74b5cgs.mjs
DELETED
|
@@ -1,99 +0,0 @@
|
|
|
1
|
-
import { t as Construct } from "./Construct-B1vGBPme.mjs";
|
|
2
|
-
import { canonicalId, provideKey, serviceKey } from "@geekmidas/manifest";
|
|
3
|
-
import { Publisher } from "@geekmidas/events";
|
|
4
|
-
import { DEFAULT_LOGGER } from "@geekmidas/logger/console";
|
|
5
|
-
//#region src/topic/Topic.ts
|
|
6
|
-
/**
|
|
7
|
-
* A topic — pub/sub fan-out. Unlike a `Queue` (point-to-point, one consumer), a
|
|
8
|
-
* topic is a *resource* owned by no single handler: it declares the event
|
|
9
|
-
* contract, and any number of subscribers (`worker.topic(topic)`) bind to it.
|
|
10
|
-
* `gkm build` discovers it into the manifest's `topics` field; infra provisions
|
|
11
|
-
* an SNS topic.
|
|
12
|
-
*
|
|
13
|
-
* A construct publishes with `.event(topic, { type, payload })`, repeatable
|
|
14
|
-
* across topics, each event going through its own topic's publisher. That also
|
|
15
|
-
* puts `services.<topic>` in the handler, as `.dependsOn([topic])` does, for an
|
|
16
|
-
* event the handler decides on itself.
|
|
17
|
-
*
|
|
18
|
-
* ```ts
|
|
19
|
-
* export const users = new Topic('Users', {
|
|
20
|
-
* events: { 'user.created': z.object({ userId: z.string() }) },
|
|
21
|
-
* });
|
|
22
|
-
* ```
|
|
23
|
-
*/
|
|
24
|
-
var Topic = class extends Construct {
|
|
25
|
-
__IS_TOPIC__ = true;
|
|
26
|
-
static isTopic(obj) {
|
|
27
|
-
return Boolean(obj && obj.__IS_TOPIC__ === true && obj.type === "dev.geekmidas.resource.topic");
|
|
28
|
-
}
|
|
29
|
-
/**
|
|
30
|
-
* The canonical id this topic is declared under.
|
|
31
|
-
*
|
|
32
|
-
* Derived from the name, so `users` and `Users` are one topic. The name is
|
|
33
|
-
* left alone: subscribers bind to it and it is what the broker routes on.
|
|
34
|
-
*/
|
|
35
|
-
id;
|
|
36
|
-
/** The name it was declared with — what the broker routes on. */
|
|
37
|
-
name;
|
|
38
|
-
/**
|
|
39
|
-
* The event contract — a map of event type → payload schema. Named
|
|
40
|
-
* `eventSchemas` (not `events`) to avoid clashing with `Construct.events`,
|
|
41
|
-
* which is the array of `MappedEvent`s a construct *publishes*.
|
|
42
|
-
*/
|
|
43
|
-
eventSchemas;
|
|
44
|
-
/**
|
|
45
|
-
* The topic as a dependency — what `.dependsOn([users])` and
|
|
46
|
-
* `.event(users, …)` dissolve into, reachable as `services.users`.
|
|
47
|
-
*
|
|
48
|
-
* The producer, because publishing is the only thing depending on a topic
|
|
49
|
-
* can mean: a subscriber binds to the topic instead, and is never handed
|
|
50
|
-
* this. It reads `<NAME>_PUBLISHER_CONNECTION_STRING` and picks the
|
|
51
|
-
* transport from its protocol — `pgboss://` locally, `sns://` deployed.
|
|
52
|
-
*
|
|
53
|
-
* A field assigned once, not a getter: services are cached by object
|
|
54
|
-
* identity, and a fresh literal on every access never hit that cache.
|
|
55
|
-
*/
|
|
56
|
-
service;
|
|
57
|
-
/** The producer's env key, read by both {@link declare} and the service. */
|
|
58
|
-
connectionKey;
|
|
59
|
-
constructor(name, options) {
|
|
60
|
-
super("dev.geekmidas.resource.topic", DEFAULT_LOGGER, [], []);
|
|
61
|
-
this.name = name;
|
|
62
|
-
this.id = canonicalId(name);
|
|
63
|
-
this.eventSchemas = options.events;
|
|
64
|
-
this.connectionKey = provideKey(this.id, "publisherConnectionString");
|
|
65
|
-
const envVar = this.connectionKey;
|
|
66
|
-
const topic = this.name;
|
|
67
|
-
this.service = {
|
|
68
|
-
serviceName: serviceKey(this.id),
|
|
69
|
-
async register({ envParser }) {
|
|
70
|
-
const { connectionString } = envParser.create((get) => ({ connectionString: get(envVar).string() })).parse();
|
|
71
|
-
return Publisher.fromConnectionString(connectionString, { topic });
|
|
72
|
-
}
|
|
73
|
-
};
|
|
74
|
-
}
|
|
75
|
-
/**
|
|
76
|
-
* What this topic is in the manifest.
|
|
77
|
-
*
|
|
78
|
-
* Only the producer's key: a subscriber is *bound* to a topic rather than
|
|
79
|
-
* depending on it, so the binding is an edge the deploy target reads and not
|
|
80
|
-
* an env key anyone can hold. Locally both sides meet on the same broker.
|
|
81
|
-
*/
|
|
82
|
-
declare() {
|
|
83
|
-
return [{
|
|
84
|
-
kind: "topic",
|
|
85
|
-
id: this.id,
|
|
86
|
-
provides: [this.connectionKey],
|
|
87
|
-
events: this.eventTypes,
|
|
88
|
-
subscribers: []
|
|
89
|
-
}];
|
|
90
|
-
}
|
|
91
|
-
/** The event type names this topic carries. */
|
|
92
|
-
get eventTypes() {
|
|
93
|
-
return Object.keys(this.eventSchemas);
|
|
94
|
-
}
|
|
95
|
-
};
|
|
96
|
-
//#endregion
|
|
97
|
-
export { Topic as t };
|
|
98
|
-
|
|
99
|
-
//# sourceMappingURL=Topic-D74b5cgs.mjs.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"Topic-D74b5cgs.mjs","names":[],"sources":["../src/topic/Topic.ts"],"sourcesContent":["import {\n\ttype EventPublisher,\n\ttype EventPublisherConnectionString,\n\ttype PublishableMessage,\n\tPublisher,\n} from '@geekmidas/events';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport {\n\ttype ConstructName,\n\tcanonicalId,\n\ttype Declaration,\n\tprovideKey,\n\tserviceKey,\n} from '@geekmidas/manifest';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { Construct, ConstructType } from '../Construct';\n\n/** A topic's event contract — a map of event type → payload schema. */\nexport type TopicEvents = Record<string, StandardSchemaV1>;\n\n/**\n * The union of wire messages a topic carries, derived from its event map:\n * `{ type: 'user.created'; payload: … } | { type: 'user.updated'; payload: … }`.\n */\nexport type TopicMessage<TEvents extends TopicEvents> = {\n\t[K in keyof TEvents & string]: PublishableMessage<\n\t\tK,\n\t\tInferStandardSchema<TEvents[K]>\n\t>;\n}[keyof TEvents & string];\n\n/**\n * A topic — pub/sub fan-out. Unlike a `Queue` (point-to-point, one consumer), a\n * topic is a *resource* owned by no single handler: it declares the event\n * contract, and any number of subscribers (`worker.topic(topic)`) bind to it.\n * `gkm build` discovers it into the manifest's `topics` field; infra provisions\n * an SNS topic.\n *\n * A construct publishes with `.event(topic, { type, payload })`, repeatable\n * across topics, each event going through its own topic's publisher. That also\n * puts `services.<topic>` in the handler, as `.dependsOn([topic])` does, for an\n * event the handler decides on itself.\n *\n * ```ts\n * export const users = new Topic('Users', {\n * events: { 'user.created': z.object({ userId: z.string() }) },\n * });\n * ```\n */\nexport class Topic<\n\tTName extends string = string,\n\tTEvents extends TopicEvents = TopicEvents,\n> extends Construct {\n\t__IS_TOPIC__ = true;\n\n\tstatic isTopic(obj: unknown): obj is Topic<string, TopicEvents> {\n\t\treturn Boolean(\n\t\t\tobj &&\n\t\t\t\t(obj as { __IS_TOPIC__?: boolean }).__IS_TOPIC__ === true &&\n\t\t\t\t(obj as Construct).type === ConstructType.Topic,\n\t\t);\n\t}\n\n\t/**\n\t * The canonical id this topic is declared under.\n\t *\n\t * Derived from the name, so `users` and `Users` are one topic. The name is\n\t * left alone: subscribers bind to it and it is what the broker routes on.\n\t */\n\treadonly id: string;\n\n\t/** The name it was declared with — what the broker routes on. */\n\treadonly name: TName;\n\n\t/**\n\t * The event contract — a map of event type → payload schema. Named\n\t * `eventSchemas` (not `events`) to avoid clashing with `Construct.events`,\n\t * which is the array of `MappedEvent`s a construct *publishes*.\n\t */\n\treadonly eventSchemas: TEvents;\n\n\t/**\n\t * The topic as a dependency — what `.dependsOn([users])` and\n\t * `.event(users, …)` dissolve into, reachable as `services.users`.\n\t *\n\t * The producer, because publishing is the only thing depending on a topic\n\t * can mean: a subscriber binds to the topic instead, and is never handed\n\t * this. It reads `<NAME>_PUBLISHER_CONNECTION_STRING` and picks the\n\t * transport from its protocol — `pgboss://` locally, `sns://` deployed.\n\t *\n\t * A field assigned once, not a getter: services are cached by object\n\t * identity, and a fresh literal on every access never hit that cache.\n\t */\n\treadonly service: Service<\n\t\tUncapitalize<TName>,\n\t\tEventPublisher<TopicMessage<TEvents>>\n\t>;\n\n\t/** The producer's env key, read by both {@link declare} and the service. */\n\tprivate readonly connectionKey: string;\n\n\tconstructor(name: ConstructName<TName>, options: TopicOptions<TEvents>) {\n\t\tsuper(ConstructType.Topic, DEFAULT_LOGGER, [], []);\n\n\t\tthis.name = name as TName;\n\t\tthis.id = canonicalId(name as string);\n\t\tthis.eventSchemas = options.events;\n\t\tthis.connectionKey = provideKey(this.id, 'publisherConnectionString');\n\n\t\tconst envVar = this.connectionKey;\n\t\tconst topic = this.name as string;\n\t\tthis.service = {\n\t\t\tserviceName: serviceKey(this.id) as Uncapitalize<TName>,\n\t\t\tasync register({ envParser }) {\n\t\t\t\tconst { connectionString } = envParser\n\t\t\t\t\t.create((get) => ({ connectionString: get(envVar).string() }))\n\t\t\t\t\t.parse();\n\n\t\t\t\t// Named as a topic, so a broker with one address for everything\n\t\t\t\t// (pg-boss) fans each message out to every subscriber.\n\t\t\t\treturn Publisher.fromConnectionString<TopicMessage<TEvents>>(\n\t\t\t\t\tconnectionString as EventPublisherConnectionString,\n\t\t\t\t\t{ topic },\n\t\t\t\t);\n\t\t\t},\n\t\t};\n\t}\n\n\t/**\n\t * What this topic is in the manifest.\n\t *\n\t * Only the producer's key: a subscriber is *bound* to a topic rather than\n\t * depending on it, so the binding is an edge the deploy target reads and not\n\t * an env key anyone can hold. Locally both sides meet on the same broker.\n\t */\n\tdeclare(): Declaration[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'topic',\n\t\t\t\tid: this.id,\n\t\t\t\tprovides: [this.connectionKey],\n\t\t\t\t// The contract this topic carries. Structural: which events exist\n\t\t\t\t// is a fact about the application, and a subscriber binding to one\n\t\t\t\t// that does not is a mistake worth catching at build.\n\t\t\t\tevents: this.eventTypes,\n\t\t\t\t// Bound rather than declared here — a subscriber names the topic,\n\t\t\t\t// not the other way round — so the build fills these from what it\n\t\t\t\t// found. Nested when it does, because position is the trigger.\n\t\t\t\tsubscribers: [],\n\t\t\t},\n\t\t];\n\t}\n\n\t/** The event type names this topic carries. */\n\tget eventTypes(): (keyof TEvents & string)[] {\n\t\treturn Object.keys(this.eventSchemas) as (keyof TEvents & string)[];\n\t}\n}\n\nexport interface TopicOptions<TEvents extends TopicEvents> {\n\t/** Each event this topic carries — its type, and its payload's schema. */\n\tevents: TEvents;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAmDA,IAAa,QAAb,cAGU,UAAU;CACnB,eAAe;CAEf,OAAO,QAAQ,KAAiD;EAC/D,OAAO,QACN,OACE,IAAmC,iBAAiB,QACpD,IAAkB,SAAA,8BACrB;CACD;;;;;;;CAQA;;CAGA;;;;;;CAOA;;;;;;;;;;;;;CAcA;;CAMA;CAEA,YAAY,MAA4B,SAAgC;EACvE,MAAA,gCAA2B,gBAAgB,CAAC,GAAG,CAAC,CAAC;EAEjD,KAAK,OAAO;EACZ,KAAK,KAAK,YAAY,IAAc;EACpC,KAAK,eAAe,QAAQ;EAC5B,KAAK,gBAAgB,WAAW,KAAK,IAAI,2BAA2B;EAEpE,MAAM,SAAS,KAAK;EACpB,MAAM,QAAQ,KAAK;EACnB,KAAK,UAAU;GACd,aAAa,WAAW,KAAK,EAAE;GAC/B,MAAM,SAAS,EAAE,aAAa;IAC7B,MAAM,EAAE,qBAAqB,UAC3B,QAAQ,SAAS,EAAE,kBAAkB,IAAI,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAC7D,MAAM;IAIR,OAAO,UAAU,qBAChB,kBACA,EAAE,MAAM,CACT;GACD;EACD;CACD;;;;;;;;CASA,UAAyB;EACxB,OAAO,CACN;GACC,MAAM;GACN,IAAI,KAAK;GACT,UAAU,CAAC,KAAK,aAAa;GAI7B,QAAQ,KAAK;GAIb,aAAa,CAAC;EACf,CACD;CACD;;CAGA,IAAI,aAAyC;EAC5C,OAAO,OAAO,KAAK,KAAK,YAAY;CACrC;AACD"}
|
package/dist/Topic-GHxcU8AG.cjs
DELETED
|
@@ -1,104 +0,0 @@
|
|
|
1
|
-
const require_Construct = require("./Construct-DUSXuTHP.cjs");
|
|
2
|
-
let _geekmidas_manifest = require("@geekmidas/manifest");
|
|
3
|
-
let _geekmidas_events = require("@geekmidas/events");
|
|
4
|
-
let _geekmidas_logger_console = require("@geekmidas/logger/console");
|
|
5
|
-
//#region src/topic/Topic.ts
|
|
6
|
-
/**
|
|
7
|
-
* A topic — pub/sub fan-out. Unlike a `Queue` (point-to-point, one consumer), a
|
|
8
|
-
* topic is a *resource* owned by no single handler: it declares the event
|
|
9
|
-
* contract, and any number of subscribers (`worker.topic(topic)`) bind to it.
|
|
10
|
-
* `gkm build` discovers it into the manifest's `topics` field; infra provisions
|
|
11
|
-
* an SNS topic.
|
|
12
|
-
*
|
|
13
|
-
* A construct publishes with `.event(topic, { type, payload })`, repeatable
|
|
14
|
-
* across topics, each event going through its own topic's publisher. That also
|
|
15
|
-
* puts `services.<topic>` in the handler, as `.dependsOn([topic])` does, for an
|
|
16
|
-
* event the handler decides on itself.
|
|
17
|
-
*
|
|
18
|
-
* ```ts
|
|
19
|
-
* export const users = new Topic('Users', {
|
|
20
|
-
* events: { 'user.created': z.object({ userId: z.string() }) },
|
|
21
|
-
* });
|
|
22
|
-
* ```
|
|
23
|
-
*/
|
|
24
|
-
var Topic = class extends require_Construct.Construct {
|
|
25
|
-
__IS_TOPIC__ = true;
|
|
26
|
-
static isTopic(obj) {
|
|
27
|
-
return Boolean(obj && obj.__IS_TOPIC__ === true && obj.type === "dev.geekmidas.resource.topic");
|
|
28
|
-
}
|
|
29
|
-
/**
|
|
30
|
-
* The canonical id this topic is declared under.
|
|
31
|
-
*
|
|
32
|
-
* Derived from the name, so `users` and `Users` are one topic. The name is
|
|
33
|
-
* left alone: subscribers bind to it and it is what the broker routes on.
|
|
34
|
-
*/
|
|
35
|
-
id;
|
|
36
|
-
/** The name it was declared with — what the broker routes on. */
|
|
37
|
-
name;
|
|
38
|
-
/**
|
|
39
|
-
* The event contract — a map of event type → payload schema. Named
|
|
40
|
-
* `eventSchemas` (not `events`) to avoid clashing with `Construct.events`,
|
|
41
|
-
* which is the array of `MappedEvent`s a construct *publishes*.
|
|
42
|
-
*/
|
|
43
|
-
eventSchemas;
|
|
44
|
-
/**
|
|
45
|
-
* The topic as a dependency — what `.dependsOn([users])` and
|
|
46
|
-
* `.event(users, …)` dissolve into, reachable as `services.users`.
|
|
47
|
-
*
|
|
48
|
-
* The producer, because publishing is the only thing depending on a topic
|
|
49
|
-
* can mean: a subscriber binds to the topic instead, and is never handed
|
|
50
|
-
* this. It reads `<NAME>_PUBLISHER_CONNECTION_STRING` and picks the
|
|
51
|
-
* transport from its protocol — `pgboss://` locally, `sns://` deployed.
|
|
52
|
-
*
|
|
53
|
-
* A field assigned once, not a getter: services are cached by object
|
|
54
|
-
* identity, and a fresh literal on every access never hit that cache.
|
|
55
|
-
*/
|
|
56
|
-
service;
|
|
57
|
-
/** The producer's env key, read by both {@link declare} and the service. */
|
|
58
|
-
connectionKey;
|
|
59
|
-
constructor(name, options) {
|
|
60
|
-
super("dev.geekmidas.resource.topic", _geekmidas_logger_console.DEFAULT_LOGGER, [], []);
|
|
61
|
-
this.name = name;
|
|
62
|
-
this.id = (0, _geekmidas_manifest.canonicalId)(name);
|
|
63
|
-
this.eventSchemas = options.events;
|
|
64
|
-
this.connectionKey = (0, _geekmidas_manifest.provideKey)(this.id, "publisherConnectionString");
|
|
65
|
-
const envVar = this.connectionKey;
|
|
66
|
-
const topic = this.name;
|
|
67
|
-
this.service = {
|
|
68
|
-
serviceName: (0, _geekmidas_manifest.serviceKey)(this.id),
|
|
69
|
-
async register({ envParser }) {
|
|
70
|
-
const { connectionString } = envParser.create((get) => ({ connectionString: get(envVar).string() })).parse();
|
|
71
|
-
return _geekmidas_events.Publisher.fromConnectionString(connectionString, { topic });
|
|
72
|
-
}
|
|
73
|
-
};
|
|
74
|
-
}
|
|
75
|
-
/**
|
|
76
|
-
* What this topic is in the manifest.
|
|
77
|
-
*
|
|
78
|
-
* Only the producer's key: a subscriber is *bound* to a topic rather than
|
|
79
|
-
* depending on it, so the binding is an edge the deploy target reads and not
|
|
80
|
-
* an env key anyone can hold. Locally both sides meet on the same broker.
|
|
81
|
-
*/
|
|
82
|
-
declare() {
|
|
83
|
-
return [{
|
|
84
|
-
kind: "topic",
|
|
85
|
-
id: this.id,
|
|
86
|
-
provides: [this.connectionKey],
|
|
87
|
-
events: this.eventTypes,
|
|
88
|
-
subscribers: []
|
|
89
|
-
}];
|
|
90
|
-
}
|
|
91
|
-
/** The event type names this topic carries. */
|
|
92
|
-
get eventTypes() {
|
|
93
|
-
return Object.keys(this.eventSchemas);
|
|
94
|
-
}
|
|
95
|
-
};
|
|
96
|
-
//#endregion
|
|
97
|
-
Object.defineProperty(exports, "Topic", {
|
|
98
|
-
enumerable: true,
|
|
99
|
-
get: function() {
|
|
100
|
-
return Topic;
|
|
101
|
-
}
|
|
102
|
-
});
|
|
103
|
-
|
|
104
|
-
//# sourceMappingURL=Topic-GHxcU8AG.cjs.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"Topic-GHxcU8AG.cjs","names":["Construct","DEFAULT_LOGGER","canonicalId","provideKey","serviceKey","Publisher"],"sources":["../src/topic/Topic.ts"],"sourcesContent":["import {\n\ttype EventPublisher,\n\ttype EventPublisherConnectionString,\n\ttype PublishableMessage,\n\tPublisher,\n} from '@geekmidas/events';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport {\n\ttype ConstructName,\n\tcanonicalId,\n\ttype Declaration,\n\tprovideKey,\n\tserviceKey,\n} from '@geekmidas/manifest';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { Construct, ConstructType } from '../Construct';\n\n/** A topic's event contract — a map of event type → payload schema. */\nexport type TopicEvents = Record<string, StandardSchemaV1>;\n\n/**\n * The union of wire messages a topic carries, derived from its event map:\n * `{ type: 'user.created'; payload: … } | { type: 'user.updated'; payload: … }`.\n */\nexport type TopicMessage<TEvents extends TopicEvents> = {\n\t[K in keyof TEvents & string]: PublishableMessage<\n\t\tK,\n\t\tInferStandardSchema<TEvents[K]>\n\t>;\n}[keyof TEvents & string];\n\n/**\n * A topic — pub/sub fan-out. Unlike a `Queue` (point-to-point, one consumer), a\n * topic is a *resource* owned by no single handler: it declares the event\n * contract, and any number of subscribers (`worker.topic(topic)`) bind to it.\n * `gkm build` discovers it into the manifest's `topics` field; infra provisions\n * an SNS topic.\n *\n * A construct publishes with `.event(topic, { type, payload })`, repeatable\n * across topics, each event going through its own topic's publisher. That also\n * puts `services.<topic>` in the handler, as `.dependsOn([topic])` does, for an\n * event the handler decides on itself.\n *\n * ```ts\n * export const users = new Topic('Users', {\n * events: { 'user.created': z.object({ userId: z.string() }) },\n * });\n * ```\n */\nexport class Topic<\n\tTName extends string = string,\n\tTEvents extends TopicEvents = TopicEvents,\n> extends Construct {\n\t__IS_TOPIC__ = true;\n\n\tstatic isTopic(obj: unknown): obj is Topic<string, TopicEvents> {\n\t\treturn Boolean(\n\t\t\tobj &&\n\t\t\t\t(obj as { __IS_TOPIC__?: boolean }).__IS_TOPIC__ === true &&\n\t\t\t\t(obj as Construct).type === ConstructType.Topic,\n\t\t);\n\t}\n\n\t/**\n\t * The canonical id this topic is declared under.\n\t *\n\t * Derived from the name, so `users` and `Users` are one topic. The name is\n\t * left alone: subscribers bind to it and it is what the broker routes on.\n\t */\n\treadonly id: string;\n\n\t/** The name it was declared with — what the broker routes on. */\n\treadonly name: TName;\n\n\t/**\n\t * The event contract — a map of event type → payload schema. Named\n\t * `eventSchemas` (not `events`) to avoid clashing with `Construct.events`,\n\t * which is the array of `MappedEvent`s a construct *publishes*.\n\t */\n\treadonly eventSchemas: TEvents;\n\n\t/**\n\t * The topic as a dependency — what `.dependsOn([users])` and\n\t * `.event(users, …)` dissolve into, reachable as `services.users`.\n\t *\n\t * The producer, because publishing is the only thing depending on a topic\n\t * can mean: a subscriber binds to the topic instead, and is never handed\n\t * this. It reads `<NAME>_PUBLISHER_CONNECTION_STRING` and picks the\n\t * transport from its protocol — `pgboss://` locally, `sns://` deployed.\n\t *\n\t * A field assigned once, not a getter: services are cached by object\n\t * identity, and a fresh literal on every access never hit that cache.\n\t */\n\treadonly service: Service<\n\t\tUncapitalize<TName>,\n\t\tEventPublisher<TopicMessage<TEvents>>\n\t>;\n\n\t/** The producer's env key, read by both {@link declare} and the service. */\n\tprivate readonly connectionKey: string;\n\n\tconstructor(name: ConstructName<TName>, options: TopicOptions<TEvents>) {\n\t\tsuper(ConstructType.Topic, DEFAULT_LOGGER, [], []);\n\n\t\tthis.name = name as TName;\n\t\tthis.id = canonicalId(name as string);\n\t\tthis.eventSchemas = options.events;\n\t\tthis.connectionKey = provideKey(this.id, 'publisherConnectionString');\n\n\t\tconst envVar = this.connectionKey;\n\t\tconst topic = this.name as string;\n\t\tthis.service = {\n\t\t\tserviceName: serviceKey(this.id) as Uncapitalize<TName>,\n\t\t\tasync register({ envParser }) {\n\t\t\t\tconst { connectionString } = envParser\n\t\t\t\t\t.create((get) => ({ connectionString: get(envVar).string() }))\n\t\t\t\t\t.parse();\n\n\t\t\t\t// Named as a topic, so a broker with one address for everything\n\t\t\t\t// (pg-boss) fans each message out to every subscriber.\n\t\t\t\treturn Publisher.fromConnectionString<TopicMessage<TEvents>>(\n\t\t\t\t\tconnectionString as EventPublisherConnectionString,\n\t\t\t\t\t{ topic },\n\t\t\t\t);\n\t\t\t},\n\t\t};\n\t}\n\n\t/**\n\t * What this topic is in the manifest.\n\t *\n\t * Only the producer's key: a subscriber is *bound* to a topic rather than\n\t * depending on it, so the binding is an edge the deploy target reads and not\n\t * an env key anyone can hold. Locally both sides meet on the same broker.\n\t */\n\tdeclare(): Declaration[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'topic',\n\t\t\t\tid: this.id,\n\t\t\t\tprovides: [this.connectionKey],\n\t\t\t\t// The contract this topic carries. Structural: which events exist\n\t\t\t\t// is a fact about the application, and a subscriber binding to one\n\t\t\t\t// that does not is a mistake worth catching at build.\n\t\t\t\tevents: this.eventTypes,\n\t\t\t\t// Bound rather than declared here — a subscriber names the topic,\n\t\t\t\t// not the other way round — so the build fills these from what it\n\t\t\t\t// found. Nested when it does, because position is the trigger.\n\t\t\t\tsubscribers: [],\n\t\t\t},\n\t\t];\n\t}\n\n\t/** The event type names this topic carries. */\n\tget eventTypes(): (keyof TEvents & string)[] {\n\t\treturn Object.keys(this.eventSchemas) as (keyof TEvents & string)[];\n\t}\n}\n\nexport interface TopicOptions<TEvents extends TopicEvents> {\n\t/** Each event this topic carries — its type, and its payload's schema. */\n\tevents: TEvents;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAmDA,IAAa,QAAb,cAGUA,kBAAAA,UAAU;CACnB,eAAe;CAEf,OAAO,QAAQ,KAAiD;EAC/D,OAAO,QACN,OACE,IAAmC,iBAAiB,QACpD,IAAkB,SAAA,8BACrB;CACD;;;;;;;CAQA;;CAGA;;;;;;CAOA;;;;;;;;;;;;;CAcA;;CAMA;CAEA,YAAY,MAA4B,SAAgC;EACvE,MAAA,gCAA2BC,0BAAAA,gBAAgB,CAAC,GAAG,CAAC,CAAC;EAEjD,KAAK,OAAO;EACZ,KAAK,MAAA,GAAKC,oBAAAA,YAAAA,CAAY,IAAc;EACpC,KAAK,eAAe,QAAQ;EAC5B,KAAK,iBAAA,GAAgBC,oBAAAA,WAAAA,CAAW,KAAK,IAAI,2BAA2B;EAEpE,MAAM,SAAS,KAAK;EACpB,MAAM,QAAQ,KAAK;EACnB,KAAK,UAAU;GACd,cAAA,GAAaC,oBAAAA,WAAAA,CAAW,KAAK,EAAE;GAC/B,MAAM,SAAS,EAAE,aAAa;IAC7B,MAAM,EAAE,qBAAqB,UAC3B,QAAQ,SAAS,EAAE,kBAAkB,IAAI,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAC7D,MAAM;IAIR,OAAOC,kBAAAA,UAAU,qBAChB,kBACA,EAAE,MAAM,CACT;GACD;EACD;CACD;;;;;;;;CASA,UAAyB;EACxB,OAAO,CACN;GACC,MAAM;GACN,IAAI,KAAK;GACT,UAAU,CAAC,KAAK,aAAa;GAI7B,QAAQ,KAAK;GAIb,aAAa,CAAC;EACf,CACD;CACD;;CAGA,IAAI,aAAyC;EAC5C,OAAO,OAAO,KAAK,KAAK,YAAY;CACrC;AACD"}
|
package/dist/auth-BMCJN30Y.d.cts
DELETED
|
@@ -1,268 +0,0 @@
|
|
|
1
|
-
import { c as ServicesOf, n as Construct, r as Consumable, t as Authenticator } from "./construct-interface-B1AfqRl4.cjs";
|
|
2
|
-
import { n as Telemetry } from "./telemetry-B48RLjyk.cjs";
|
|
3
|
-
import { EnvironmentParser } from "@geekmidas/envkit";
|
|
4
|
-
import { Service, ServiceRecord, ServiceRegisterOptions } from "@geekmidas/services";
|
|
5
|
-
import { ConstructName, Declaration } from "@geekmidas/manifest";
|
|
6
|
-
import { betterAuth } from "better-auth";
|
|
7
|
-
import { Hono } from "hono";
|
|
8
|
-
//#region src/auth.d.ts
|
|
9
|
-
/** The server better-auth hands back. */
|
|
10
|
-
type AuthServer = ReturnType<typeof betterAuth>;
|
|
11
|
-
/** A signed-in session as better-auth hands it back: `{ user, session }`. */
|
|
12
|
-
type AuthSession = AuthServer['$Infer']['Session'];
|
|
13
|
-
/**
|
|
14
|
-
* What `.dependsOn([auth])` hands a handler: the auth server, over HTTP.
|
|
15
|
-
*
|
|
16
|
-
* The server itself — its secret, its tenant's connection, its mailer — lives
|
|
17
|
-
* in the auth app's own process and nowhere else. Every other process is a
|
|
18
|
-
* caller of it, so what it is given is an address and this, with the one
|
|
19
|
-
* call handlers make kept in Better Auth's shape: `api.getSession({ headers })`
|
|
20
|
-
* answers `{ user, session }` or `null`, as the server's own `api` does.
|
|
21
|
-
*/
|
|
22
|
-
interface AuthClient {
|
|
23
|
-
readonly api: {
|
|
24
|
-
/**
|
|
25
|
-
* The session the request's cookie or bearer token belongs to, or `null`
|
|
26
|
-
* when there is none — asked of `<basePath>/get-session` at the auth
|
|
27
|
-
* server's URL. Only `cookie` and `authorization` are forwarded, with
|
|
28
|
-
* the client's address as `x-gkm-client-ip` (read from the request's
|
|
29
|
-
* `x-forwarded-for`) and the active trace context.
|
|
30
|
-
*
|
|
31
|
-
* @throws {AuthServerUnreachable} when the request does not get there.
|
|
32
|
-
* @throws {SessionCheckFailed} when the server answers with a failure.
|
|
33
|
-
*/
|
|
34
|
-
getSession(input: {
|
|
35
|
-
headers: ConstructorParameters<typeof Headers>[0];
|
|
36
|
-
}): Promise<AuthSession | null>;
|
|
37
|
-
};
|
|
38
|
-
}
|
|
39
|
-
/** Everything better-auth takes, minus what the construct owns. */
|
|
40
|
-
type BetterAuthOptions = Omit<Parameters<typeof betterAuth>[0], 'database' | 'secret' | 'basePath' | 'baseURL'>;
|
|
41
|
-
/**
|
|
42
|
-
* What an `options` callback is handed: the options this construct was
|
|
43
|
-
* registered with, and a client for each construct its `dependsOn` names —
|
|
44
|
-
* keyed by service name, exactly as an endpoint's handler receives them.
|
|
45
|
-
*/
|
|
46
|
-
type BetterAuthOptionsContext<TUses extends readonly Consumable[]> = ServiceRegisterOptions & {
|
|
47
|
-
services: ServiceRecord<[...ServicesOf<TUses>]>;
|
|
48
|
-
};
|
|
49
|
-
interface BetterAuthConfig<TDatabase extends Consumable, TUses extends readonly Consumable[] = readonly []> {
|
|
50
|
-
/**
|
|
51
|
-
* The schema tenant its tables live in.
|
|
52
|
-
*
|
|
53
|
-
* A construct rather than a URL: the tenant already declares its schema and
|
|
54
|
-
* its role, and taking the declaration is what puts the edge in the graph
|
|
55
|
-
* instead of a connection string in two places.
|
|
56
|
-
*/
|
|
57
|
-
database: TDatabase;
|
|
58
|
-
/**
|
|
59
|
-
* The app that serves this auth server, relative to the workspace root —
|
|
60
|
-
* `'apps/auth'`.
|
|
61
|
-
*
|
|
62
|
-
* Required, for the reason `RestApi.path` is. Not to be confused with
|
|
63
|
-
* `basePath`, which is where its routes are mounted in a URL.
|
|
64
|
-
*/
|
|
65
|
-
path: string;
|
|
66
|
-
/**
|
|
67
|
-
* The label it answers on under a stage's domain — `api` for
|
|
68
|
-
* `api.myapp.com`, from `domains` — and under the project locally,
|
|
69
|
-
* `api.myapp.localhost`. Absent, its id kebab-cased.
|
|
70
|
-
*/
|
|
71
|
-
subdomain?: string;
|
|
72
|
-
/**
|
|
73
|
-
* Where the auth routes are mounted, e.g. `/api/auth`.
|
|
74
|
-
*
|
|
75
|
-
* Structural — it is part of the URL every client calls, so it cannot differ
|
|
76
|
-
* between stages the way the host can.
|
|
77
|
-
*/
|
|
78
|
-
basePath?: string;
|
|
79
|
-
/**
|
|
80
|
-
* The constructs `options` uses — the mailer a magic link goes through,
|
|
81
|
-
* most often.
|
|
82
|
-
*
|
|
83
|
-
* One list, two jobs, the way an endpoint's `.dependsOn()` has: each is an
|
|
84
|
-
* edge on the server's handler, so whatever is composed from the edges (a
|
|
85
|
-
* container's environment, a deploy's grants) includes it; and each is
|
|
86
|
-
* handed to `options` as a client in `services`, so there is no other way
|
|
87
|
-
* for `options` to reach it — nothing to import and register by hand, and
|
|
88
|
-
* so nothing that can be used without being declared.
|
|
89
|
-
*/
|
|
90
|
-
dependsOn?: TUses;
|
|
91
|
-
/**
|
|
92
|
-
* What the auth server's process emits — the `Telemetry` construct, passed
|
|
93
|
-
* like a `RestApi`'s. An edge to the node: the deploy hands the process the
|
|
94
|
-
* `OTEL_*` keys its stage resolves.
|
|
95
|
-
*/
|
|
96
|
-
telemetry?: Telemetry;
|
|
97
|
-
/**
|
|
98
|
-
* The rest of better-auth's options: providers, plugins, email settings.
|
|
99
|
-
*
|
|
100
|
-
* A function when they need another construct — a magic-link plugin has to
|
|
101
|
-
* *send* the link. It is handed the options this construct was registered
|
|
102
|
-
* with, and `services`: a client for each construct in `dependsOn`.
|
|
103
|
-
*/
|
|
104
|
-
options?: BetterAuthOptions | ((context: BetterAuthOptionsContext<TUses>) => BetterAuthOptions | Promise<BetterAuthOptions>);
|
|
105
|
-
}
|
|
106
|
-
declare class BetterAuth<TName extends string = string, TDatabase extends Consumable = Consumable, const TUses extends readonly Consumable[] = readonly []> implements Construct<TName, AuthClient>, Authenticator<AuthSession> {
|
|
107
|
-
private readonly config;
|
|
108
|
-
readonly id: TName;
|
|
109
|
-
/**
|
|
110
|
-
* What `.dependsOn([auth])` injects: an {@link AuthClient}, never the server.
|
|
111
|
-
*
|
|
112
|
-
* Which of the two a process holds is decided by how it reaches the
|
|
113
|
-
* construct, not by asking where it is running. The auth app's process is
|
|
114
|
-
* its generated entry, which calls {@link server} and nothing else — a
|
|
115
|
-
* self-serving surface has no endpoints of its own for a `dependsOn` to sit
|
|
116
|
-
* on. Every other process reaches it through this. So the API, a worker, a
|
|
117
|
-
* test's in-process endpoints all get the client, and none of them needs
|
|
118
|
-
* the signing secret, the auth tenant's URL or the mailer to start.
|
|
119
|
-
*/
|
|
120
|
-
readonly service: Service<Uncapitalize<TName>, AuthClient>;
|
|
121
|
-
readonly basePath: string;
|
|
122
|
-
/**
|
|
123
|
-
* Declared once and read by both `declare()` and `connect()`, so the keys the
|
|
124
|
-
* target publishes and the keys the server reads cannot drift.
|
|
125
|
-
*/
|
|
126
|
-
private readonly keys;
|
|
127
|
-
constructor(id: ConstructName<TName>, config: BetterAuthConfig<TDatabase, TUses>);
|
|
128
|
-
/**
|
|
129
|
-
* A signing secret and a surface.
|
|
130
|
-
*
|
|
131
|
-
* The database is *not* declared here — the tenant that was passed in
|
|
132
|
-
* declares it, and declaring it twice is the duplication the whole model
|
|
133
|
-
* removes. What is declared is what this construct owns: the key it signs
|
|
134
|
-
* with, and the routes it answers on.
|
|
135
|
-
*
|
|
136
|
-
* One endpoint, wildcarded. Better Auth routes internally and the set of
|
|
137
|
-
* paths depends on which capabilities are enabled, so enumerating them here
|
|
138
|
-
* would be a copy of its router that goes stale on its next release. The
|
|
139
|
-
* surface's job is to send everything under `basePath` to one handler, which
|
|
140
|
-
* is exactly what the declaration says.
|
|
141
|
-
*/
|
|
142
|
-
declare(): Declaration[];
|
|
143
|
-
/**
|
|
144
|
-
* Whose request this is: the session for these headers, or `null`.
|
|
145
|
-
*
|
|
146
|
-
* Asked of the auth server over HTTP, at the URL the `.auth()` edge injects —
|
|
147
|
-
* so it is the same call whether the server runs in this process, beside
|
|
148
|
-
* it, or behind MSW in a test. The same call {@link AuthClient} makes.
|
|
149
|
-
*/
|
|
150
|
-
verify(headers: Headers, envParser: EnvironmentParser<{}>): Promise<AuthSession | null>;
|
|
151
|
-
/**
|
|
152
|
-
* The client a caller of this server holds: its URL and nothing else.
|
|
153
|
-
*
|
|
154
|
-
* `<ID>_URL` is the one key a consumer is given for an edge to a surface —
|
|
155
|
-
* the compose network's address between containers, the public one where
|
|
156
|
-
* that is all there is — so this is everything it can know.
|
|
157
|
-
*/
|
|
158
|
-
client(envParser: EnvironmentParser<{}>): AuthClient;
|
|
159
|
-
/**
|
|
160
|
-
* The tenant this server keeps its tables in — whose migrations folder,
|
|
161
|
-
* `db/<tenant>/`, Better Auth's schema is written into.
|
|
162
|
-
*/
|
|
163
|
-
get databaseId(): string;
|
|
164
|
-
/**
|
|
165
|
-
* The SQL that brings the tenant up to Better Auth's schema, or `undefined`
|
|
166
|
-
* when it already matches.
|
|
167
|
-
*
|
|
168
|
-
* What `gkm migration` writes as the tenant's next migration, so Better
|
|
169
|
-
* Auth's tables are committed, reviewed and applied like any other — rather
|
|
170
|
-
* than diffed against the database at runtime, where a change nobody wrote
|
|
171
|
-
* down happens on whichever machine migrates first.
|
|
172
|
-
*
|
|
173
|
-
* Compared as the owner, against the tenant `gkm migrate` has already brought
|
|
174
|
-
* up to date: what comes back is only what the committed files are missing.
|
|
175
|
-
*/
|
|
176
|
-
pendingMigration(options: ServiceRegisterOptions): Promise<string | undefined>;
|
|
177
|
-
/**
|
|
178
|
-
* The server this surface runs as, built from its own declaration.
|
|
179
|
-
*
|
|
180
|
-
* A surface is a deploy unit, so something has to serve it, and the thing
|
|
181
|
-
* that knows how is the construct — not a generator writing a mount into
|
|
182
|
-
* somebody else's entry point. That is how the auth server came to be
|
|
183
|
-
* mounted by a hook in the application it was supposed to be separate from,
|
|
184
|
-
* and then to be served by nothing at all when the hook was deleted.
|
|
185
|
-
*
|
|
186
|
-
* The routes come from {@link declare}: one wildcard under `basePath`, read
|
|
187
|
-
* off the same declaration the manifest carries, so the surface the graph
|
|
188
|
-
* describes and the surface that answers requests cannot disagree.
|
|
189
|
-
*
|
|
190
|
-
* ```ts
|
|
191
|
-
* // .gkm/server/app.ts — the whole generated entry
|
|
192
|
-
* import { auth } from '@acme/constructs/auth.js';
|
|
193
|
-
* export const { app } = await auth.server({ envParser });
|
|
194
|
-
* ```
|
|
195
|
-
*
|
|
196
|
-
* The only way to the server: it is what reads the signing secret, opens
|
|
197
|
-
* the tenant and builds the mailer, so it is built here, in the auth app's
|
|
198
|
-
* own process, and `.dependsOn([auth])` everywhere else gets
|
|
199
|
-
* {@link AuthClient}. `auth` is the better-auth instance behind the app.
|
|
200
|
-
*/
|
|
201
|
-
server(options: ServiceRegisterOptions): Promise<{
|
|
202
|
-
app: Hono;
|
|
203
|
-
auth: AuthServer;
|
|
204
|
-
}>;
|
|
205
|
-
/**
|
|
206
|
-
* The ids of the better-auth plugins this server runs — what a client has
|
|
207
|
-
* to pair its own plugins with (`magic-link` with `magicLinkClient`).
|
|
208
|
-
* Resolved the way the server resolves them, options callback included.
|
|
209
|
-
*/
|
|
210
|
-
pluginIds(options: ServiceRegisterOptions): Promise<string[]>;
|
|
211
|
-
/** Better-auth's options as given — a value, or a callback of the environment. */
|
|
212
|
-
private configured;
|
|
213
|
-
private connect;
|
|
214
|
-
/**
|
|
215
|
-
* Everything better-auth is given: the app's options, and what the construct
|
|
216
|
-
* owns — its secret, its URL, its tenant's connection, the origins and cookie
|
|
217
|
-
* domain its graph derives. One place, so the server and its migrations are
|
|
218
|
-
* built from the same options.
|
|
219
|
-
*/
|
|
220
|
-
private optionsFor;
|
|
221
|
-
}
|
|
222
|
-
/** A magic link moved to the device address when an app is its destination. */
|
|
223
|
-
declare function deviceLink(url: string, deviceUrl: string): string;
|
|
224
|
-
/** A mobile app depends on this auth server, which has no Expo plugin. */
|
|
225
|
-
declare class ExpoPluginRequired extends Error {
|
|
226
|
-
readonly server: string;
|
|
227
|
-
/** The schemes the graph says call it — what made the plugin necessary. */
|
|
228
|
-
readonly origins: readonly string[];
|
|
229
|
-
constructor(server: string,
|
|
230
|
-
/** The schemes the graph says call it — what made the plugin necessary. */
|
|
231
|
-
origins: readonly string[]);
|
|
232
|
-
}
|
|
233
|
-
/** The auth server answered a session check with a failure. */
|
|
234
|
-
declare class SessionCheckFailed extends Error {
|
|
235
|
-
readonly authenticator: string;
|
|
236
|
-
readonly status: number;
|
|
237
|
-
constructor(authenticator: string, status: number);
|
|
238
|
-
}
|
|
239
|
-
/** A session check never reached the auth server. */
|
|
240
|
-
declare class AuthServerUnreachable extends Error {
|
|
241
|
-
readonly authenticator: string;
|
|
242
|
-
readonly url: string;
|
|
243
|
-
constructor(authenticator: string, url: string, cause: unknown);
|
|
244
|
-
}
|
|
245
|
-
/**
|
|
246
|
-
* Better Auth's DDL, safe to run where its tables already exist.
|
|
247
|
-
*
|
|
248
|
-
* Its SQL is Kysely's, so its shape is known: `create table "…"`, `create index
|
|
249
|
-
* "…"`, `alter table "…" add column "…"`. A database that has been running
|
|
250
|
-
* already has those — Better Auth used to create them at runtime — and the
|
|
251
|
-
* first committed migration would fail on them rather than recording that they
|
|
252
|
-
* are there.
|
|
253
|
-
*/
|
|
254
|
-
declare function idempotent(statements: string): string;
|
|
255
|
-
/**
|
|
256
|
-
* `request`, without {@link CLIENT_IP_HEADER} unless an internal caller sent
|
|
257
|
-
* it — no `Origin`, no forwarding header, a loopback or private peer: the
|
|
258
|
-
* rule a request's span continues a trace by (`@geekmidas/telescope`'s
|
|
259
|
-
* `isInternalCaller`).
|
|
260
|
-
*
|
|
261
|
-
* The stack's own edges strip the header already. This holds wherever one
|
|
262
|
-
* does not — a platform's proxy, a port published straight to the internet —
|
|
263
|
-
* so a stranger cannot pick the address Better Auth rate-limits them by.
|
|
264
|
-
*/
|
|
265
|
-
declare function withTrustedClientIp(request: Request, remoteAddress: string | undefined): Request;
|
|
266
|
-
//#endregion
|
|
267
|
-
export { BetterAuth as a, BetterAuthOptionsContext as c, deviceLink as d, idempotent as f, AuthSession as i, ExpoPluginRequired as l, AuthServer as n, BetterAuthConfig as o, withTrustedClientIp as p, AuthServerUnreachable as r, BetterAuthOptions as s, AuthClient as t, SessionCheckFailed as u };
|
|
268
|
-
//# sourceMappingURL=auth-BMCJN30Y.d.cts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"auth-BMCJN30Y.d.cts","names":[],"sources":["../src/auth.ts"],"mappings":";;;;;;;;;KA2DY,aAAa,kBAAkB;;KAG/B,cAAc;;;;;;;;;;UAWT;WACP;;;;;;;;;;;IAWR,WAAW;MACV,SAAS,6BAA6B;QACnC,QAAQ;;;;KAKF,oBAAoB,KAC/B,kBAAkB;;;;;;KASP,yBAAyB,uBAAuB,gBAC3D;EACC,UAAU,kBAAkB,WAAW;;UAGxB,iBAChB,kBAAkB,YAClB,uBAAuB;;;;;;;;EASvB,UAAU;;;;;;;;EAQV;;;;;;EAMA;;;;;;;EAOA;;;;;;;;;;;;EAYA,YAAY;;;;;;EAMZ,YAAY;;;;;;;;EAQZ,UACG,sBAEA,SAAS,yBAAyB,WAC7B,oBAAoB,QAAQ;;cAKxB,WACZ,+BACA,kBAAkB,aAAa,kBACzB,uBAAuB,uCACjB,UAAU,OAAO,aAAa,cAAc;mBA+BtC;WA7BT,IAAI;;;;;;;;;;;;WAYJ,SAAS,QAAQ,aAAa,QAAQ;WACtC;;;;;mBAMQ;EAQjB,YACC,IAAI,cAAc,QACD,QAAQ,iBAAiB,WAAW;;;;;;;;;;;;;;;EAuCtD,WAAW;;;;;;;;EAgDL,OACL,SAAS,SACT,WAAW,wBACT,QAAQ;;;;;;;;EAWX,OAAO,WAAW,wBAAwB;;;;;MAkBtC;;;;;;;;;;;;;EAgBE,iBACL,SAAS,yBACP;;;;;;;;;;;;;;;;;;;;;;;;;EAsDG,OACL,SAAS,yBACP;IAAU,KAAK;IAAM,MAAM;;;;;;;EAsDxB,UAAU,SAAS,yBAAyB;;UAMpC;UAuBA;;;;;;;UAmBA;;;iBA8JC,WAAW,aAAa;;cAY3B,2BAA2B;WAE7B;;WAEA;EAHV,YACU,gBAEA;;EAAA;;;cAiEE,2BAA2B;WAE7B;WACA;EAFV,YACU,uBACA;;;cAYE,8BAA8B;WAEhC;WACA;EAFV,YACU,uBACA,aACT;;;;;;;;;;;iBAqBc,WAAW;;;;;;;;;;;iBAgCX,oBACf,SAAS,SACT,oCACE"}
|