@classytic/arc 2.45.2 → 2.47.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/README.md +1 -1
- package/dist/{EventTransport-DHb1tpu-.mjs → EventTransport-BHKy4_Bi.mjs} +5 -6
- package/dist/{EventTransport-CiicKz2Z.d.mts → EventTransport-CYEoCJGe.d.mts} +0 -2
- package/dist/{HookSystem-C1u0EUnt.mjs → HookSystem-CAIDVoKC.mjs} +3 -4
- package/dist/{QueryCache--5uAuYPW.d.mts → QueryCache-DdvrGG8Q.d.mts} +1 -3
- package/dist/{ResourceRegistry-D2jXWVN_.mjs → ResourceRegistry-23Ml6FNe.mjs} +15 -4
- package/dist/{acquire-DTkA8Lme.mjs → acquire-DoFX06fm.mjs} +2 -3
- package/dist/{actionPermissions-DRVk6m7x.mjs → actionPermissions-DXrlWHHK.mjs} +37 -42
- package/dist/audit/index.d.mts +2 -10
- package/dist/audit/index.mjs +8 -12
- package/dist/auth/audit.d.mts +0 -2
- package/dist/auth/audit.mjs +2 -3
- package/dist/auth/index.d.mts +9 -17
- package/dist/auth/index.mjs +26 -29
- package/dist/auth/redis-session.d.mts +2 -4
- package/dist/auth/redis-session.mjs +2 -3
- package/dist/{authorizationDecision-D48fUJv1.mjs → authorizationDecision-DYiubkYw.mjs} +5 -6
- package/dist/{base-CZyixEQR.d.mts → base-HXNgPQww.d.mts} +1 -7
- package/dist/{boundedMap-DkKiPifd.mjs → boundedMap-CtdzpJ3X.mjs} +2 -3
- package/dist/{buildHandler-BiZ4VATS.mjs → buildHandler-CARdmPNo.mjs} +5 -6
- package/dist/cache/index.d.mts +4 -10
- package/dist/cache/index.mjs +5 -6
- package/dist/{caching-Cj0as-P1.mjs → caching-QRiryDLs.mjs} +3 -4
- package/dist/{claimed-ChI13rUR.mjs → claimed-BLecr1j3.mjs} +2 -3
- package/dist/cleanup/index.d.mts +4 -18
- package/dist/cleanup/index.mjs +12 -20
- package/dist/cli/commands/describe.d.mts +1 -3
- package/dist/cli/commands/describe.mjs +4 -5
- package/dist/cli/commands/docs.d.mts +1 -3
- package/dist/cli/commands/docs.mjs +4 -5
- package/dist/cli/commands/doctor.d.mts +1 -3
- package/dist/cli/commands/doctor.mjs +2 -3
- package/dist/cli/commands/generate.d.mts +1 -1
- package/dist/cli/commands/generate.mjs +2 -2
- package/dist/cli/commands/init.d.mts +1 -1
- package/dist/cli/commands/init.mjs +2 -2
- package/dist/cli/commands/introspect.d.mts +1 -3
- package/dist/cli/commands/introspect.mjs +3 -4
- package/dist/cli/index.d.mts +2 -2
- package/dist/cli/index.mjs +3 -3
- package/dist/{constants-D_aiew34.mjs → constants-Cx7BcnHT.mjs} +2 -3
- package/dist/context/index.d.mts +0 -8
- package/dist/context/index.mjs +6 -7
- package/dist/core/index.d.mts +3 -3
- package/dist/core/index.mjs +8 -8
- package/dist/{core-QIZ2560Y.mjs → core-0WyMuo0f.mjs} +9 -12
- package/dist/{createActionRouter-CvH84dyx.mjs → createActionRouter-mLAGbpDV.mjs} +7 -8
- package/dist/{createAggregationRouter-DGyK2Hp6.mjs → createAggregationRouter-BEAjn3dA.mjs} +9 -10
- package/dist/{createApp-CKjZpmq9.mjs → createApp-QDP4vYWH.mjs} +49 -62
- package/dist/{createMcpServer-DSztofa9.d.mts → createMcpServer-DzXHX0SO.d.mts} +1 -3
- package/dist/{defineAggregation-BLza7Ca4.mjs → defineAggregation-CFNfvz-C.mjs} +2 -3
- package/dist/{defineResource-CEo0gDCb.mjs → defineResource-BROJmhzJ.mjs} +80 -29
- package/dist/discovery/index.d.mts +1 -3
- package/dist/discovery/index.mjs +2 -3
- package/dist/docs/index.d.mts +8 -8
- package/dist/docs/index.mjs +4 -5
- package/dist/{elevation-BW2J3tNj.d.mts → elevation-DPD0hcU-.d.mts} +0 -2
- package/dist/{elevation-BJTsSnke.mjs → elevation-DrXeEWWk.mjs} +9 -10
- package/dist/encryption/index.d.mts +1 -7
- package/dist/encryption/index.mjs +8 -13
- package/dist/{errorHandler--4rSMMvq.d.mts → errorHandler-B9r88jZV.d.mts} +8 -3
- package/dist/{errorHandler-2p4SL5zm.mjs → errorHandler-BiBXtxj4.mjs} +16 -6
- package/dist/{errors-JYc9vwqE.d.mts → errors-DTo0me1o.d.mts} +0 -2
- package/dist/{errors-grZkIA8N.mjs → errors-DnrUChAy.mjs} +2 -3
- package/dist/{eventPlugin-BtmA4-3P.d.mts → eventPlugin-BY38F6yK.d.mts} +1 -7
- package/dist/{eventPlugin-ItcYBGUs.mjs → eventPlugin-BhKLUe7H.mjs} +10 -12
- package/dist/{eventTypes-Ck6fD3ne.mjs → eventTypes-CCIRGakw.mjs} +5 -8
- package/dist/events/index.d.mts +5 -17
- package/dist/events/index.mjs +9 -9
- package/dist/events/transports/redis-stream-entry.d.mts +1 -1
- package/dist/events/transports/redis-stream-entry.mjs +5 -6
- package/dist/events/transports/redis.d.mts +2 -4
- package/dist/events/transports/redis.mjs +3 -4
- package/dist/{externalPaths-CmGOxOtD.d.mts → externalPaths-BOqdq5wr.d.mts} +0 -2
- package/dist/factory/index.d.mts +4 -14
- package/dist/factory/index.mjs +12 -18
- package/dist/{fastify-augmentation-DRlCIWE9.d.mts → fastify-augmentation-bzkWPt1f.d.mts} +4 -10
- package/dist/{fields-BRX0Krcj.mjs → fields-CYdpcV73.mjs} +2 -3
- package/dist/{fields-BBSpf8pS.d.mts → fields-JTkrtO-r.d.mts} +0 -2
- package/dist/{filter-merge-CDc7YMwX.mjs → filter-merge-6kasezRH.mjs} +2 -3
- package/dist/{generate-DCGuEbqI.d.mts → generate-C-g_KOkV.d.mts} +0 -4
- package/dist/{generate-hvg7V2g1.mjs → generate-DUkcbc4r.mjs} +7 -12
- package/dist/{headers-Cqkg4LzI.mjs → headers-KxhrKevA.mjs} +3 -4
- package/dist/{health-PVt0VjOx.mjs → health-CRJg3IIq.mjs} +2 -3
- package/dist/{health-DyeP3mTW.mjs → health-jkYNdobJ.mjs} +4 -7
- package/dist/hooks/index.d.mts +1 -1
- package/dist/hooks/index.mjs +2 -2
- package/dist/http-cache/index.d.mts +211 -0
- package/dist/http-cache/index.mjs +605 -0
- package/dist/http-cache/purgers/cloudflare.d.mts +13 -0
- package/dist/http-cache/purgers/cloudflare.mjs +46 -0
- package/dist/http-cache/purgers/fastly.d.mts +12 -0
- package/dist/http-cache/purgers/fastly.mjs +47 -0
- package/dist/http-cache/testing/index.d.mts +68 -0
- package/dist/http-cache/testing/index.mjs +168 -0
- package/dist/idempotency/index.d.mts +3 -9
- package/dist/idempotency/index.mjs +11 -14
- package/dist/idempotency/redis.d.mts +1 -1
- package/dist/idempotency/redis.mjs +3 -4
- package/dist/{index-Bxriq3so.d.mts → index-B5i9-vuP.d.mts} +4 -26
- package/dist/{index-Chgz3d0i.d.mts → index-BAXDo5eE.d.mts} +1 -7
- package/dist/{index-Beg3aNnK.d.mts → index-BxZS-8So.d.mts} +67 -25
- package/dist/{index-WH7xgvxS.d.mts → index-Cy2-QffW.d.mts} +40 -92
- package/dist/{index-uhkUA5-U.d.mts → index-D1X_C_qz.d.mts} +13 -23
- package/dist/{index-CUJvoyw3.d.mts → index-DFCCQ9AE.d.mts} +2 -24
- package/dist/index.d.mts +7 -9
- package/dist/index.mjs +12 -13
- package/dist/{init-jC3rMPzb.mjs → init-CACwpktI.mjs} +18 -35
- package/dist/{init-Cscs4lab.d.mts → init-CV2_Fw3H.d.mts} +0 -4
- package/dist/integrations/event-gateway.d.mts +3 -5
- package/dist/integrations/event-gateway.mjs +3 -4
- package/dist/integrations/index.d.mts +3 -3
- package/dist/integrations/index.mjs +1 -1
- package/dist/integrations/jobs/index.d.mts +1 -1
- package/dist/integrations/jobs/index.mjs +7 -11
- package/dist/integrations/mcp/index.d.mts +7 -39
- package/dist/integrations/mcp/index.mjs +8 -14
- package/dist/integrations/mcp/testing.d.mts +3 -5
- package/dist/integrations/mcp/testing.mjs +3 -4
- package/dist/integrations/streamline.d.mts +1 -3
- package/dist/integrations/streamline.mjs +4 -5
- package/dist/integrations/webhooks.d.mts +2 -4
- package/dist/integrations/webhooks.mjs +5 -5
- package/dist/integrations/websocket-pushref-redis.d.mts +2 -4
- package/dist/integrations/websocket-pushref-redis.mjs +2 -3
- package/dist/integrations/websocket-redis.d.mts +2 -4
- package/dist/integrations/websocket-redis.mjs +2 -3
- package/dist/integrations/websocket.d.mts +2 -2
- package/dist/integrations/websocket.mjs +13 -24
- package/dist/{interface-JJzwH4Ro.d.mts → interface-BmExzQRD.d.mts} +0 -2
- package/dist/{interface-BOk3YnTz.d.mts → interface-WR1U0K7t.d.mts} +0 -2
- package/dist/{jsonBody-ptwyzZQ-.mjs → jsonBody-CzDBkCme.mjs} +3 -4
- package/dist/{keys-C1vFuSbv.mjs → keys-Cbwf6r1B.mjs} +2 -3
- package/dist/{loadResources-CHPDyIPn.mjs → loadResources-Kr6vuljv.mjs} +4 -5
- package/dist/{loadResourcesFromEntry-BkHHTu_B.mjs → loadResourcesFromEntry-D2e0qoDR.mjs} +3 -4
- package/dist/logger/index.d.mts +1 -3
- package/dist/logger/index.mjs +2 -2
- package/dist/{logger-C5bvCiAK.mjs → logger-C110X5Yz.mjs} +3 -5
- package/dist/{mcpPlugin-C9qohJCF.mjs → mcpPlugin-4lIPr9OJ.mjs} +41 -60
- package/dist/{memory-CxiTwT0j.mjs → memory-D9qkhXiB.mjs} +4 -5
- package/dist/{metrics-Ckp2zRy-.mjs → metrics-B-qrrWfI.mjs} +4 -5
- package/dist/middleware/index.d.mts +1 -5
- package/dist/middleware/index.mjs +4 -5
- package/dist/migrations/index.d.mts +0 -2
- package/dist/migrations/index.mjs +3 -4
- package/dist/{module-CfnKuIuH.mjs → module-BD8xHgrz.mjs} +2 -3
- package/dist/{multiTenant-CAtYlW6H.d.mts → multiTenant-KZj8j1uJ.d.mts} +1 -5
- package/dist/{multipartBody-BFasGtP9.mjs → multipartBody-qU7KCn1l.mjs} +2 -3
- package/dist/observeSend-BnPtTotW.mjs +20 -0
- package/dist/{openapi-DAPxjYHX.mjs → openapi-DoVa5SVP.mjs} +18 -28
- package/dist/outbox-admin/index.d.mts +2 -4
- package/dist/outbox-admin/index.mjs +6 -7
- package/dist/{outbox-module-gZCHoE4H.d.mts → outbox-module-5Mnwcycy.d.mts} +3 -9
- package/dist/outbox-module-DyITEIop.mjs +297 -0
- package/dist/permissions/index.d.mts +4 -4
- package/dist/permissions/index.mjs +7 -7
- package/dist/{permissions-B14c3OMp.mjs → permissions-BBy4bOGi.mjs} +19 -29
- package/dist/{pipe-CQv7PsAK.mjs → pipe-BOm2o4UA.mjs} +3 -4
- package/dist/pipeline/index.d.mts +1 -9
- package/dist/pipeline/index.mjs +5 -8
- package/dist/{plan-CpnTykjb.mjs → plan-DDIGwuxr.mjs} +5 -9
- package/dist/{plugin-DXTjVg_Q.mjs → plugin-Bn4D_0XK.mjs} +156 -64
- package/dist/plugins/index.d.mts +8 -16
- package/dist/plugins/index.mjs +22 -26
- package/dist/plugins/response-cache.d.mts +2 -4
- package/dist/plugins/response-cache.mjs +10 -10
- package/dist/plugins/tracing-entry.d.mts +1 -1
- package/dist/plugins/tracing-entry.mjs +3 -4
- package/dist/{pluralize-C3VJKRGp.mjs → pluralize-ClEjcKlG.mjs} +2 -3
- package/dist/policy.types-DPqToKG1.d.mts +50 -0
- package/dist/presets/filesUpload.d.mts +4 -6
- package/dist/presets/filesUpload.mjs +6 -7
- package/dist/presets/index.d.mts +3 -19
- package/dist/presets/index.mjs +2 -2
- package/dist/presets/multiTenant.d.mts +1 -1
- package/dist/presets/multiTenant.mjs +7 -7
- package/dist/presets/search.d.mts +3 -5
- package/dist/presets/search.mjs +3 -4
- package/dist/{presets-CquqYJPy.mjs → presets-DK2jh5YR.mjs} +11 -18
- package/dist/{projection-CgfSLOSM.mjs → projection-BHH-sXyS.mjs} +3 -4
- package/dist/purger.types-2wNJK_89.mjs +24 -0
- package/dist/purger.types-DvPp4-yd.d.mts +26 -0
- package/dist/{pushref-registry-UxCkoA4C.d.mts → pushref-registry-d86QUaSq.d.mts} +0 -6
- package/dist/{queryCachePlugin-D0HUISHJ.mjs → queryCachePlugin-Ckqe98AM.mjs} +8 -10
- package/dist/{queryCachePlugin-C2lZjTxk.d.mts → queryCachePlugin-DYQUyeJ9.d.mts} +2 -4
- package/dist/{rateLimitKey-AvkBOMkl.mjs → rateLimitKey-CWAjlqcN.mjs} +2 -3
- package/dist/{realtime-CbWtVbqK.mjs → realtime-BIJi9USY.mjs} +17 -19
- package/dist/{redis-BDgv9Glw.d.mts → redis-RpDMemdm.d.mts} +2 -4
- package/dist/{redis-stream-BMk-bpQS.d.mts → redis-stream-CS1N9dwM.d.mts} +1 -3
- package/dist/{redisShapes-CQksY67q.d.mts → redisShapes-CqBXTn_s.d.mts} +0 -2
- package/dist/registry/index.d.mts +2 -12
- package/dist/registry/index.mjs +3 -3
- package/dist/{registry-BVwpAuFI.mjs → registry-y9ZA-R_J.mjs} +7 -12
- package/dist/{outbox-module-B4FAkx3A.mjs → relay-BNrC1CEP.mjs} +8 -306
- package/dist/{renewingLease-CykpeNcQ.mjs → renewingLease-CS43br5E.mjs} +2 -3
- package/dist/{replyHelpers-DA51IZio.mjs → replyHelpers-oZDzakGb.mjs} +3 -4
- package/dist/{requestContext-DIWHKDtQ.mjs → requestContext-fWb_YaV2.mjs} +2 -3
- package/dist/{requirement-Cp_fsMDL.mjs → requirement--2hWyyHi.mjs} +2 -3
- package/dist/{requirement-CbiLdQ1n.d.mts → requirement-CTRQjjQx.d.mts} +0 -2
- package/dist/{resourceRateLimit-BFuluodF.mjs → resourceRateLimit-1WbcyMZY.mjs} +3 -4
- package/dist/{resourceRateLimit-Wf6d6FL9.d.mts → resourceRateLimit-DCWglD7V.d.mts} +1 -3
- package/dist/{rolldown-runtime-D_lMdYOd.mjs → rolldown-runtime-yH2lHMo_.mjs} +2 -3
- package/dist/{routeValidator-DuLonYwr.mjs → routeValidator-BSlRIA5c.mjs} +2 -3
- package/dist/{runtimeCapabilities-CydRfm0i.mjs → runtimeCapabilities-CYCEtU1W.mjs} +2 -3
- package/dist/{schedules-B693KXxa.mjs → schedules-B5WGlYIT.mjs} +132 -9
- package/dist/{schemaConverter-DNvZWTV6.mjs → schemaConverter-DtNvts-6.mjs} +3 -4
- package/dist/{schemaIR-REV2y7Wd.mjs → schemaIR-uS_RHqa3.mjs} +3 -4
- package/dist/schemas/index.d.mts +0 -2
- package/dist/schemas/index.mjs +2 -3
- package/dist/scim/index.d.mts +0 -12
- package/dist/scim/index.mjs +10 -18
- package/dist/scope/index.d.mts +2 -6
- package/dist/scope/index.mjs +5 -5
- package/dist/{scope-Bevxy_ST.mjs → scope-BwVLSyNG.mjs} +5 -6
- package/dist/{sessionManager-qimlKV0P.d.mts → sessionManager-CdvDF04x.d.mts} +2 -4
- package/dist/{shutdown-CfrqPR7A.mjs → shutdown-BJiJN7FT.mjs} +2 -3
- package/dist/{simpleEqualityMatcher-BJwfuRKP.mjs → simpleEqualityMatcher-DGRLq-1k.mjs} +2 -3
- package/dist/{sse-CuNNWr2z.mjs → sse-B_50llZu.mjs} +8 -9
- package/dist/{sseStream-C_2ujAVY.mjs → sseStream-BjSo9Ult.mjs} +3 -4
- package/dist/{storage-Cx9Sz3Ou.d.mts → storage-odC5MNKN.d.mts} +0 -2
- package/dist/{store-helpers-C8uBGCbb.mjs → store-helpers-D-n5cwy5.mjs} +2 -3
- package/dist/{streaming-Bdq_M4d5.mjs → streaming-Dcgqa-hH.mjs} +2 -3
- package/dist/{subscriberIdentity-B-KpZkdl.mjs → subscriberIdentity-C9KhIXTF.mjs} +2 -3
- package/dist/{tenancy-C5PCvm1h.mjs → tenancy-COrhjPRZ.mjs} +3 -4
- package/dist/{tenantPreparation-dYvWrgNa.mjs → tenantPreparation-BElWHytd.mjs} +5 -6
- package/dist/testing/cleanupStoreContract.d.mts +2 -4
- package/dist/testing/cleanupStoreContract.mjs +2 -3
- package/dist/testing/index.d.mts +6 -32
- package/dist/testing/index.mjs +24 -37
- package/dist/testing/outboxStoreContract.d.mts +1 -3
- package/dist/testing/outboxStoreContract.mjs +3 -4
- package/dist/testing/requiredPorts.d.mts +2 -4
- package/dist/testing/requiredPorts.mjs +3 -4
- package/dist/testing/storageContract.d.mts +2 -4
- package/dist/testing/storageContract.mjs +2 -3
- package/dist/{timing-DCqsezX8.mjs → timing-CaxKbRk_.mjs} +3 -5
- package/dist/{tracing-Dro5eH6j.d.mts → tracing-JSFiBl5r.d.mts} +0 -2
- package/dist/{transactionContext-DrcNyjpv.mjs → transactionContext-8qKON0Nk.mjs} +2 -3
- package/dist/{typeGuards-CEl10KPy.mjs → typeGuards-DVjVSsXO.mjs} +2 -3
- package/dist/types/index.d.mts +4 -4
- package/dist/types/index.mjs +1 -1
- package/dist/types/storage.d.mts +1 -1
- package/dist/types/storage.mjs +1 -1
- package/dist/{types-ByHn9rEO.d.mts → types-0Dqlbgn8.d.mts} +0 -2
- package/dist/{types-BJ-2XqVF.d.mts → types-BeEJm-DV.d.mts} +114 -14
- package/dist/{types-DVLddu2q.d.mts → types-C0YJAiL0.d.mts} +0 -2
- package/dist/{types-D9NWjpYc.mjs → types-DZHqOuJE.mjs} +5 -6
- package/dist/{types-D3Ixsh00.d.mts → types-DeLiuaNv.d.mts} +2 -4
- package/dist/{types-Ddl9OjmE.d.mts → types-DnkIALZ8.d.mts} +0 -4
- package/dist/usage/index.d.mts +2 -10
- package/dist/usage/index.mjs +8 -12
- package/dist/{userHelpers-BHig1kHq.mjs → userHelpers-_eGj6kf0.mjs} +2 -3
- package/dist/utils/index.d.mts +5 -39
- package/dist/utils/index.mjs +12 -12
- package/dist/{utils-BG5P7_Vb.mjs → utils-Dd6MWpye.mjs} +20 -30
- package/dist/{validate-D_mdOCir.mjs → validate-BaF5wd0x.mjs} +5 -7
- package/dist/{versioning-DBGHjPh7.mjs → versioning-DyV7mwtK.mjs} +4 -5
- package/dist/{versioning-Bqm_57Qt.d.mts → versioning-S18y2-0C.d.mts} +1 -15
- package/dist/{websocket-Cs4awVyD.d.mts → websocket-BGuc-WVZ.d.mts} +1 -15
- package/dist/{workScope-DPPfM4m6.mjs → workScope-CmCBUmPR.mjs} +3 -4
- package/llms.txt +37 -30
- package/package.json +51 -22
- package/skills/arc/SKILL.md +65 -844
- package/skills/arc/references/agent-auth.md +82 -193
- package/skills/arc/references/api-reference.md +41 -245
- package/skills/arc/references/auth-api-keys.md +99 -0
- package/skills/arc/references/auth-better-auth-overlay.md +87 -0
- package/skills/arc/references/auth-better-auth.md +78 -0
- package/skills/arc/references/auth-permissions.md +100 -0
- package/skills/arc/references/auth-strategies.md +122 -0
- package/skills/arc/references/boot.md +80 -0
- package/skills/arc/references/enterprise-auth.md +65 -81
- package/skills/arc/references/events-outbox.md +90 -0
- package/skills/arc/references/events.md +75 -440
- package/skills/arc/references/integrations-jobs.md +74 -0
- package/skills/arc/references/integrations-realtime.md +84 -0
- package/skills/arc/references/integrations-webhooks.md +71 -0
- package/skills/arc/references/integrations-workflows.md +47 -0
- package/skills/arc/references/mcp-auth.md +83 -0
- package/skills/arc/references/mcp-custom-tools.md +125 -0
- package/skills/arc/references/mcp-setup.md +115 -0
- package/skills/arc/references/mcp-testing.md +63 -0
- package/skills/arc/references/multi-tenancy.md +56 -230
- package/skills/arc/references/permissions-scope.md +81 -0
- package/skills/arc/references/production-api.md +119 -0
- package/skills/arc/references/production-audit.md +101 -0
- package/skills/arc/references/production-boot.md +91 -0
- package/skills/arc/references/production-caching.md +63 -0
- package/skills/arc/references/production-distributed.md +75 -0
- package/skills/arc/references/production-idempotency.md +83 -0
- package/skills/arc/references/production-observability.md +83 -0
- package/skills/arc/references/production-realtime.md +70 -0
- package/skills/arc/references/production-reliability.md +100 -0
- package/skills/arc/references/production-shutdown.md +43 -0
- package/skills/arc/references/querying.md +76 -0
- package/skills/arc/references/resources.md +97 -0
- package/skills/arc/references/schedules.md +79 -0
- package/skills/arc/references/scim.md +61 -208
- package/skills/arc/references/tenancy-scope-install.md +82 -0
- package/skills/arc/references/testing.md +101 -144
- package/skills/arc/references/usage-cleanup-capabilities.md +45 -0
- package/skills/arc/references/validation.md +91 -0
- package/skills/arc/references/writes-hooks-errors.md +80 -0
- package/skills/arc-code-review/SKILL.md +67 -114
- package/skills/arc-code-review/references/arc-cheatsheet.md +68 -167
- package/skills/arc-code-review/references/mongokit-repositories.md +104 -0
- package/skills/arc-code-review/references/recipe-events-cache-jobs.md +112 -0
- package/skills/arc-code-review/references/recipe-resource.md +100 -0
- package/skills/arc-code-review/references/recipe-schemas-fields.md +93 -0
- package/skills/arc-code-review/references/recipe-scope-permissions.md +82 -0
- package/skills/arc-code-review/references/scaffolding.md +61 -198
- package/skills/arc-code-review/references/severity.md +49 -102
- package/skills/arc-code-review/references/smells-auth-scope.md +80 -0
- package/skills/arc-code-review/references/smells-data-events.md +66 -0
- package/skills/arc-code-review/references/smells-imports-style.md +59 -0
- package/skills/arc-code-review/references/smells-platform.md +89 -0
- package/skills/arc-code-review/references/smells-routes-schemas.md +66 -0
- package/skills/arc-module-publishing/SKILL.md +82 -208
- package/skills/arc-module-publishing/references/action-presets-and-plugins.md +87 -0
- package/skills/arc-module-publishing/references/build-and-types.md +73 -0
- package/skills/arc-module-publishing/references/module-lifecycle.md +101 -0
- package/skills/arc-module-publishing/references/package-manifest.md +34 -122
- package/skills/arc-module-publishing/references/publishing-workflow.md +44 -140
- package/skills/arc-module-publishing/references/resource-assembly.md +102 -0
- package/skills/arc-module-publishing/references/testing-packages.md +82 -0
- package/skills/arc/references/auth.md +0 -729
- package/skills/arc/references/integrations.md +0 -452
- package/skills/arc/references/mcp.md +0 -691
- package/skills/arc/references/production.md +0 -835
- package/skills/arc-code-review/references/anti-patterns.md +0 -1008
- package/skills/arc-code-review/references/migration-recipes.md +0 -649
- package/skills/arc-code-review/references/mongokit-migration.md +0 -360
- package/skills/arc-module-publishing/references/authoring-modules.md +0 -327
|
@@ -1,11 +1,10 @@
|
|
|
1
1
|
|
|
2
|
-
import { a as EventTransport, n as DomainEvent, t as DeadLetteredEvent } from "./EventTransport-
|
|
3
|
-
import { n as ArcModule } from "./types-
|
|
2
|
+
import { a as EventTransport, n as DomainEvent, t as DeadLetteredEvent } from "./EventTransport-CYEoCJGe.mjs";
|
|
3
|
+
import { n as ArcModule } from "./types-BeEJm-DV.mjs";
|
|
4
4
|
import { FastifyInstance } from "fastify";
|
|
5
|
-
import { MemoryOutboxStore } from "@classytic/primitives/memory-outbox";
|
|
6
5
|
import { OutboxFailurePolicy, OutboxStore, OutboxWriteOptions } from "@classytic/primitives/outbox";
|
|
6
|
+
import { MemoryOutboxStore } from "@classytic/primitives/memory-outbox";
|
|
7
7
|
import { RepositoryLike } from "@classytic/repo-core/adapter";
|
|
8
|
-
//#region src/events/outbox/health.d.ts
|
|
9
8
|
/** Pending age past which the relay counts as stalled. */
|
|
10
9
|
declare const DEFAULT_RELAY_LAG_UNHEALTHY_MS: number;
|
|
11
10
|
interface OutboxHealth {
|
|
@@ -18,8 +17,6 @@ interface OutboxHealth {
|
|
|
18
17
|
/** A store that can report its own depth — both reads are optional on the contract. */
|
|
19
18
|
type OutboxHealthStore = OutboxStore & Required<Pick<OutboxStore, "countByStatus" | "oldestPendingAgeMs">>;
|
|
20
19
|
declare function readOutboxHealth(store: OutboxHealthStore, relayLagUnhealthyMs?: number): Promise<OutboxHealth>;
|
|
21
|
-
//#endregion
|
|
22
|
-
//#region src/events/outbox/relay.d.ts
|
|
23
20
|
/** Reason codes passed to {@link EventOutboxOptions.onError}. */
|
|
24
21
|
type OutboxRelayErrorKind = "publish_failed" | "acknowledge_failed" | "fail_failed" | "ownership_mismatch" | "malformed_event";
|
|
25
22
|
/**
|
|
@@ -276,8 +273,6 @@ declare class EventOutbox {
|
|
|
276
273
|
*/
|
|
277
274
|
purge(olderThanMs?: number): Promise<number>;
|
|
278
275
|
}
|
|
279
|
-
//#endregion
|
|
280
|
-
//#region src/events/outbox-module.d.ts
|
|
281
276
|
interface OutboxModuleOptions {
|
|
282
277
|
/**
|
|
283
278
|
* The durable store. Supply it directly, or as a factory when it needs the booted app
|
|
@@ -487,5 +482,4 @@ interface OutboxModuleExports {
|
|
|
487
482
|
* boot error naming the module that needed it.
|
|
488
483
|
*/
|
|
489
484
|
declare function createOutboxModule(options: OutboxModuleOptions): ArcModule<OutboxModuleExports>;
|
|
490
|
-
//#endregion
|
|
491
485
|
export { MemoryOutboxStore as a, OutboxRelayErrorHandler as c, DEFAULT_RELAY_LAG_UNHEALTHY_MS as d, OutboxHealth as f, createOutboxModule as i, OutboxRelayErrorKind as l, readOutboxHealth as m, OutboxModuleExports as n, EventOutbox as o, OutboxHealthStore as p, OutboxModuleOptions as r, EventOutboxOptions as s, OutboxDrainResult as t, RelayResult as u };
|
|
@@ -0,0 +1,297 @@
|
|
|
1
|
+
/*! @classytic/arc v2.47.0 | MIT | https://classytic.com */
|
|
2
|
+
import { t as transactionContext } from "./transactionContext-8qKON0Nk.mjs";
|
|
3
|
+
import { n as requestContext } from "./requestContext-fWb_YaV2.mjs";
|
|
4
|
+
import { i as resolveEventTransport } from "./EventTransport-BHKy4_Bi.mjs";
|
|
5
|
+
import { t as EventOutbox } from "./relay-BNrC1CEP.mjs";
|
|
6
|
+
import { t as emitObserved } from "./eventPlugin-BhKLUe7H.mjs";
|
|
7
|
+
import { n as canReportHealth, r as readOutboxHealth } from "./health-CRJg3IIq.mjs";
|
|
8
|
+
import { randomBytes } from "node:crypto";
|
|
9
|
+
import { hostname } from "node:os";
|
|
10
|
+
// src/events/outbox-module.ts
|
|
11
|
+
/**
|
|
12
|
+
* The OUTBOX as a module — so the store is a SLOT other modules depend on, not a value the host
|
|
13
|
+
* threads by hand.
|
|
14
|
+
*
|
|
15
|
+
* ## The failure this exists to make impossible
|
|
16
|
+
*
|
|
17
|
+
* A durable store passed as a constructor argument to N consumers will eventually miss one, and
|
|
18
|
+
* the miss is silent. Observed in two independent ERP hosts on the same fleet:
|
|
19
|
+
*
|
|
20
|
+
* - one passed an outbox to its revenue-attach seam and **not** to `createOrder`, so
|
|
21
|
+
* `order:created` published fire-and-forget — a failed publish discarded the revenue trigger
|
|
22
|
+
* entirely: no attach, no dead-letter, no log. Cash collected, nothing recorded.
|
|
23
|
+
* - the other had the identical gap, written independently.
|
|
24
|
+
*
|
|
25
|
+
* Six consumers had to be wired by hand in each host (order kernel, revenue kernel, access
|
|
26
|
+
* kernel, revenue-attach durability, line-activation dead letters, promo-commit dead letters).
|
|
27
|
+
* That is not a discipline problem; it is a design problem.
|
|
28
|
+
*
|
|
29
|
+
* As a module the store is registered ONCE and read from the registry. A consumer declares
|
|
30
|
+
* `dependsOn: ['outbox']` and arc refuses to boot without it — the omission becomes a startup
|
|
31
|
+
* failure instead of a quiet data-loss window.
|
|
32
|
+
*
|
|
33
|
+
* ## What this module does NOT do
|
|
34
|
+
*
|
|
35
|
+
* It does not build a store. Store construction is store-specific (a mongo model, a SQL table),
|
|
36
|
+
* and arc is deliberately storage-agnostic — `repositoryAsOutboxStore` already adapts any
|
|
37
|
+
* repository, and kits own their own schema (e.g. `@classytic/mongokit/outbox`). This module owns
|
|
38
|
+
* the three things that are genuinely arc's: the module SLOT, the relay SCHEDULE, and shutdown.
|
|
39
|
+
*/
|
|
40
|
+
/**
|
|
41
|
+
* The store contract is `@classytic/primitives/outbox`'s, not arc's — arc adapts to it rather
|
|
42
|
+
* than owning it, which is why a kit (mongokit) can supply a store with no arc dependency.
|
|
43
|
+
*/
|
|
44
|
+
/** Default relay cadence. Frequent enough that a retry is not a user-visible delay. */
|
|
45
|
+
const DEFAULT_RELAY_EVERY_MS = 5e3;
|
|
46
|
+
/** How long the readiness check reuses a relay-health reading. See `health.probeCacheMs`. */
|
|
47
|
+
const DEFAULT_PROBE_CACHE_MS = 5e3;
|
|
48
|
+
/** How often an unhealthy outbox is logged. See `health.alertEveryMs`. */
|
|
49
|
+
const DEFAULT_HEALTH_ALERT_EVERY_MS = 3e5;
|
|
50
|
+
/**
|
|
51
|
+
* One relay identity per RELAY INSTANCE — `<name>:<hostname>:<pid>:<random>`.
|
|
52
|
+
*
|
|
53
|
+
* A lease identifies an independently executing CLAIMANT, not a crash domain.
|
|
54
|
+
* Arc lets two outbox modules coexist (`name` is the `dependsOn` key), each
|
|
55
|
+
* with its own schedule arm, and nothing stops two of them pointing at the
|
|
56
|
+
* same store: they tick independently, so they are two claimants and must be
|
|
57
|
+
* two identities. Scoping this per-process instead would have made the module
|
|
58
|
+
* WEAKER than the primitive it wraps — `EventOutbox`'s own fallback is already
|
|
59
|
+
* per-instance — and would leave the store unable to tell the two apart after
|
|
60
|
+
* a lease expiry, which is exactly the stale-owner hole this replaced.
|
|
61
|
+
*
|
|
62
|
+
* Every component earns its place: `name` distinguishes co-resident modules,
|
|
63
|
+
* `hostname:pid` makes a lease row legible in ops tooling, and the random
|
|
64
|
+
* suffix breaks the tie a container restart creates — same hostname, often the
|
|
65
|
+
* same pid, and the restarted process must not inherit a predecessor's
|
|
66
|
+
* identity while that predecessor's lease is still live.
|
|
67
|
+
*
|
|
68
|
+
* Called once per `bootstrap()`, so the id is stable across every tick of the
|
|
69
|
+
* relay it belongs to — which the lease depends on.
|
|
70
|
+
*/
|
|
71
|
+
function mintConsumerId(name) {
|
|
72
|
+
return `${name}:${hostname()}:${process.pid}:${randomBytes(4).toString("hex")}`;
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* Compose the outbox as a module.
|
|
76
|
+
*
|
|
77
|
+
* ```ts
|
|
78
|
+
* // host
|
|
79
|
+
* const model = createOutboxModel(connection, { visibleAtField: 'nextVisibleAt' });
|
|
80
|
+
* createApp({ modules: [
|
|
81
|
+
* createOutboxModule({
|
|
82
|
+
* store: repositoryAsOutboxStore(new Repository(model), { visibleAtField: 'nextVisibleAt' }),
|
|
83
|
+
* onError: (err, ctx) => app.log.error({ err, ...ctx }, 'outbox relay'),
|
|
84
|
+
* }),
|
|
85
|
+
* …
|
|
86
|
+
* ]});
|
|
87
|
+
*
|
|
88
|
+
* // consumer module
|
|
89
|
+
* defineModule({
|
|
90
|
+
* name: 'order',
|
|
91
|
+
* dependsOn: ['outbox'],
|
|
92
|
+
* bootstrap: (f) => createOrder({
|
|
93
|
+
* outbox: getModuleExports<OutboxModuleExports>(f, 'outbox').store,
|
|
94
|
+
* }),
|
|
95
|
+
* });
|
|
96
|
+
* ```
|
|
97
|
+
*
|
|
98
|
+
* `dependsOn` is doing real work there: it both orders the bootstraps and makes a missing outbox a
|
|
99
|
+
* boot error naming the module that needed it.
|
|
100
|
+
*/
|
|
101
|
+
function createOutboxModule(options) {
|
|
102
|
+
const name = options.name ?? "outbox";
|
|
103
|
+
const relayEveryMs = options.relayEveryMs ?? DEFAULT_RELAY_EVERY_MS;
|
|
104
|
+
const lagUnhealthyMs = (options.health === false ? void 0 : options.health?.relayLagUnhealthyMs) ?? 3e5;
|
|
105
|
+
const probeCacheMs = (options.health === false ? void 0 : options.health?.probeCacheMs) ?? DEFAULT_PROBE_CACHE_MS;
|
|
106
|
+
if (!Number.isFinite(probeCacheMs) || probeCacheMs < 0) throw new Error(`Outbox module "${name}": health.probeCacheMs must be a non-negative number, got ${String(probeCacheMs)}.`);
|
|
107
|
+
const alertEveryMs = options.health === false ? 0 : options.health?.alertEveryMs ?? DEFAULT_HEALTH_ALERT_EVERY_MS;
|
|
108
|
+
if (!Number.isFinite(alertEveryMs) || alertEveryMs < 0) throw new Error(`Outbox module "${name}": health.alertEveryMs must be a non-negative number, got ${String(alertEveryMs)}.`);
|
|
109
|
+
let log;
|
|
110
|
+
/** The unmeasurable-store warning is said once, not every alert tick. */
|
|
111
|
+
let warnedUnmeasurable = false;
|
|
112
|
+
/**
|
|
113
|
+
* The readiness probe's reading, reused for `probeCacheMs` and shared by
|
|
114
|
+
* concurrent probes (single-flight). A failed or unmeasurable reading is
|
|
115
|
+
* cached as unhealthy for the same window — retrying a failing store on
|
|
116
|
+
* every probe is load on the thing that is already failing.
|
|
117
|
+
*/
|
|
118
|
+
let probeReading;
|
|
119
|
+
let probeInFlight;
|
|
120
|
+
const probeHealthy = (read) => {
|
|
121
|
+
if (probeReading && Date.now() - probeReading.at < probeCacheMs) return Promise.resolve(probeReading.healthy);
|
|
122
|
+
probeInFlight ??= read().then((h) => h.healthy, () => false).then((healthy) => {
|
|
123
|
+
probeReading = {
|
|
124
|
+
at: Date.now(),
|
|
125
|
+
healthy
|
|
126
|
+
};
|
|
127
|
+
return healthy;
|
|
128
|
+
}).finally(() => {
|
|
129
|
+
probeInFlight = void 0;
|
|
130
|
+
});
|
|
131
|
+
return probeInFlight;
|
|
132
|
+
};
|
|
133
|
+
/**
|
|
134
|
+
* Built at bootstrap and reused by the schedule.
|
|
135
|
+
*
|
|
136
|
+
* Not rebuilt per tick: `EventOutbox` carries the consumer id the lease is keyed on, and a fresh
|
|
137
|
+
* instance per tick would be a fresh claimant every few seconds — which defeats the lease it
|
|
138
|
+
* depends on for exactly-once publishing.
|
|
139
|
+
*/
|
|
140
|
+
let exports;
|
|
141
|
+
/** Passes THIS module started (nudge, schedule) that have not settled — `drain()` waits on them. */
|
|
142
|
+
const inFlightPasses = /* @__PURE__ */ new Set();
|
|
143
|
+
const trackPass = (pass) => {
|
|
144
|
+
inFlightPasses.add(pass);
|
|
145
|
+
const untrack = () => {
|
|
146
|
+
inFlightPasses.delete(pass);
|
|
147
|
+
};
|
|
148
|
+
pass.then(untrack, untrack);
|
|
149
|
+
return pass;
|
|
150
|
+
};
|
|
151
|
+
return {
|
|
152
|
+
name,
|
|
153
|
+
bootstrap: (fastify) => {
|
|
154
|
+
log = fastify.log;
|
|
155
|
+
const store = typeof options.store === "function" ? options.store(fastify) : options.store;
|
|
156
|
+
/**
|
|
157
|
+
* The RAW transport, never `fastify.events`.
|
|
158
|
+
*
|
|
159
|
+
* This read used to be `(fastify as { events?: EventTransport }).events` — a cast across
|
|
160
|
+
* two INCOMPATIBLE shapes. The facade's `publish(type, payload, meta?)` took the relayed
|
|
161
|
+
* `DomainEvent` as its `type` argument and failed the non-empty-string guard, so the
|
|
162
|
+
* documented default path published NOTHING: subscribers saw nothing and every tick
|
|
163
|
+
* reported `publishFailed: 1` until the row dead-lettered. The cast is what let two
|
|
164
|
+
* mismatched signatures typecheck.
|
|
165
|
+
*/
|
|
166
|
+
const transport = options.transport === void 0 ? resolveEventTransport(fastify) : typeof options.transport === "function" ? options.transport(fastify) : options.transport;
|
|
167
|
+
/**
|
|
168
|
+
* No transport is BOOT-FATAL, because the alternative is invisible:
|
|
169
|
+
* `EventOutbox.relayBatch()` returns an empty result when it has none, so the
|
|
170
|
+
* module's schedule would tick forever, publish nothing, and let the store grow —
|
|
171
|
+
* a durable backlog nobody is draining, reported as healthy. The failure this
|
|
172
|
+
* module exists to prevent, arrived at from the other side.
|
|
173
|
+
*/
|
|
174
|
+
if (transport === void 0) throw new Error(`Outbox module "${name}" could not resolve an event transport, so its relay would tick forever without publishing while the store grows. Register arc's events plugin (it is on by default — check \`arcPlugins.events !== false\`), or pass an explicit \`transport\` to \`createOutboxModule\`. Note the outbox needs the RAW EventTransport, not the \`fastify.events\` facade: the facade takes \`(type, payload, meta?)\` and fails open, which would acknowledge rows whose publish actually failed.`);
|
|
175
|
+
const relay = new EventOutbox({
|
|
176
|
+
store,
|
|
177
|
+
transport,
|
|
178
|
+
onPublished: (event) => emitObserved(fastify.events, event),
|
|
179
|
+
...options.batchSize !== void 0 ? { batchSize: options.batchSize } : {},
|
|
180
|
+
...options.leaseMs !== void 0 ? { leaseMs: options.leaseMs } : {},
|
|
181
|
+
consumerId: options.consumerId ?? mintConsumerId(name),
|
|
182
|
+
onError: options.onError ?? ((info) => {
|
|
183
|
+
fastify.log.error({
|
|
184
|
+
err: info.error,
|
|
185
|
+
kind: info.kind,
|
|
186
|
+
...info.event?.meta.id !== void 0 ? { eventId: info.event.meta.id } : {},
|
|
187
|
+
...info.event?.type !== void 0 ? { eventType: info.event.type } : {}
|
|
188
|
+
}, `outbox relay "${name}" failed`);
|
|
189
|
+
}),
|
|
190
|
+
...options.failurePolicy !== void 0 ? { failurePolicy: options.failurePolicy } : {},
|
|
191
|
+
...options.sessionProvider === false ? {} : { sessionProvider: options.sessionProvider ?? (() => transactionContext.get()) }
|
|
192
|
+
});
|
|
193
|
+
/**
|
|
194
|
+
* One pass per burst of requests. `drainQueued` stays true from the
|
|
195
|
+
* first request until the pass STARTS, so a request landing mid-pass
|
|
196
|
+
* schedules the next one — a row written during a pass is never left
|
|
197
|
+
* waiting for the interval.
|
|
198
|
+
*/
|
|
199
|
+
let drainQueued = false;
|
|
200
|
+
const requestDrain = () => {
|
|
201
|
+
if (drainQueued) return;
|
|
202
|
+
drainQueued = true;
|
|
203
|
+
let passDone = () => {};
|
|
204
|
+
trackPass(new Promise((resolve) => passDone = resolve));
|
|
205
|
+
setImmediate(() => {
|
|
206
|
+
drainQueued = false;
|
|
207
|
+
requestContext.storage.exit(() => {
|
|
208
|
+
relay.relayBatch().catch((err) => {
|
|
209
|
+
fastify.log.error({ err }, `outbox relay "${name}" requested drain failed`);
|
|
210
|
+
}).finally(passDone);
|
|
211
|
+
});
|
|
212
|
+
});
|
|
213
|
+
};
|
|
214
|
+
const drain = ({ maxPasses = 100 } = {}) => requestContext.storage.exit(async () => {
|
|
215
|
+
const total = {
|
|
216
|
+
passes: 0,
|
|
217
|
+
relayed: 0,
|
|
218
|
+
publishFailed: 0,
|
|
219
|
+
deadLettered: 0,
|
|
220
|
+
drained: false
|
|
221
|
+
};
|
|
222
|
+
while (total.passes < maxPasses) {
|
|
223
|
+
if (inFlightPasses.size > 0) await Promise.allSettled([...inFlightPasses]);
|
|
224
|
+
const r = await relay.relayBatch();
|
|
225
|
+
total.passes++;
|
|
226
|
+
total.relayed += r.relayed;
|
|
227
|
+
total.publishFailed += r.publishFailed;
|
|
228
|
+
total.deadLettered += r.deadLettered;
|
|
229
|
+
if (r.attempted === 0 && inFlightPasses.size === 0) {
|
|
230
|
+
total.drained = true;
|
|
231
|
+
break;
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
return total;
|
|
235
|
+
});
|
|
236
|
+
const health = async () => {
|
|
237
|
+
if (!canReportHealth(store)) throw new Error(`Outbox module "${name}": relay health needs BOTH countByStatus and oldestPendingAgeMs on the store, and it is missing at least one.`);
|
|
238
|
+
return readOutboxHealth(store, lagUnhealthyMs);
|
|
239
|
+
};
|
|
240
|
+
exports = {
|
|
241
|
+
store,
|
|
242
|
+
relay,
|
|
243
|
+
requestDrain,
|
|
244
|
+
drain,
|
|
245
|
+
health
|
|
246
|
+
};
|
|
247
|
+
return exports;
|
|
248
|
+
},
|
|
249
|
+
...options.health === false ? {} : { healthChecks: [{
|
|
250
|
+
name: `${name}.relay`,
|
|
251
|
+
critical: false,
|
|
252
|
+
check: () => exports ? probeHealthy(exports.health) : Promise.resolve(false)
|
|
253
|
+
}] },
|
|
254
|
+
/**
|
|
255
|
+
* The relay runs on the module's OWN schedule arm, so the host stops owning the tick — and
|
|
256
|
+
* a host that forgets to start one cannot exist.
|
|
257
|
+
*/
|
|
258
|
+
scheduledJobs: () => [{
|
|
259
|
+
name: `${name}.relay`,
|
|
260
|
+
kind: "relay",
|
|
261
|
+
every: relayEveryMs,
|
|
262
|
+
runOnStart: options.runOnStart ?? true,
|
|
263
|
+
handler: async () => {
|
|
264
|
+
if (exports) await trackPass(exports.relay.relay());
|
|
265
|
+
}
|
|
266
|
+
}, ...alertEveryMs > 0 ? [{
|
|
267
|
+
name: `${name}.health`,
|
|
268
|
+
kind: "relay",
|
|
269
|
+
every: alertEveryMs,
|
|
270
|
+
handler: async () => {
|
|
271
|
+
if (!exports || !log) return;
|
|
272
|
+
if (!canReportHealth(exports.store)) {
|
|
273
|
+
if (!warnedUnmeasurable) {
|
|
274
|
+
warnedUnmeasurable = true;
|
|
275
|
+
log.warn({
|
|
276
|
+
marker: "OUTBOX_HEALTH_UNMEASURABLE",
|
|
277
|
+
outbox: name
|
|
278
|
+
}, `outbox "${name}" store lacks countByStatus or oldestPendingAgeMs — relay stalls cannot be alerted on`);
|
|
279
|
+
}
|
|
280
|
+
return;
|
|
281
|
+
}
|
|
282
|
+
const h = await exports.health();
|
|
283
|
+
if (h.deadLetter > 0) log.warn({
|
|
284
|
+
marker: "OUTBOX_DEAD_LETTER",
|
|
285
|
+
outbox: name,
|
|
286
|
+
...h
|
|
287
|
+
}, `outbox "${name}" has dead-lettered events — inspect and replay them`);
|
|
288
|
+
if (h.relayLagMs !== null && h.relayLagMs >= lagUnhealthyMs) log.error({
|
|
289
|
+
marker: "OUTBOX_RELAY_LAG",
|
|
290
|
+
outbox: name,
|
|
291
|
+
...h
|
|
292
|
+
}, `outbox "${name}" relay is behind — events are committed but not delivered`);
|
|
293
|
+
}
|
|
294
|
+
}] : []]
|
|
295
|
+
};
|
|
296
|
+
}
|
|
297
|
+
export { createOutboxModule as t };
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
|
|
2
|
-
import { c as DataPolicy, d as UserBase, l as PermissionCheck, m as normalizeRoles, p as getUserRoles, s as AuthorizationDecision, u as PermissionContext } from "../base-
|
|
3
|
-
import { a as applyFieldReadPermissions, c as resolveEffectiveRoles, i as FieldWritePermissionResult, n as FieldPermissionMap, o as applyFieldWritePermissions, r as FieldPermissionType, s as fields, t as FieldPermission } from "../fields-
|
|
4
|
-
import { $ as deny, A as GrantResolution, B as explainAccess, C as requireScopeContext, D as createRoleHierarchy, E as RoleHierarchy, F as AccessExplanation, G as createDynamicPermissionMatrix, H as DynamicPermissionMatrix, I as PermissionRequirement, J as PublicPolicy, K as createOrgPermissions, L as collectPublicSurface, M as modeSatisfies, N as requireGrant, O as GRANT_MODES, P as conjoinPolicyFilters, Q as anyOf, R as describePermission, S as requireOrgRole, T as requireTeamMembership, U as DynamicPermissionMatrixConfig, V as ConnectEventsOptions, W as PermissionEventBus, X as allow, Y as allOf, Z as allowPublic, _ as publicRead, _t as requireMandate, a as PermissionMatrixRegistry, at as requireRoles, b as requireOrgInScope, c as introspectModule, ct as scopeOf, d as adminOnly, dt as evaluatePermissionDecision, et as denyAll, f as authenticated, ft as normalizeToDecision, g as presets_d_exports, gt as requireDPoP, h as permissionMatrix, ht as requireAgentScope, i as PermissionMatrixOptions, it as requirePlatformRole, j as RequireGrantOptions, k as GrantMode, l as introspectRegistry, lt as PermissionCheckReturn, m as ownerWithAdminBypass, mt as RequireMandateOptions, n as PermissionEntryType, nt as requireAuth, o as buildPermissionMatrix, ot as roles, p as fullPublic, pt as RequireAgentScopeOptions, q as AllowPublicOptions, r as PermissionMatrix, rt as requireOwnership, s as introspectCheck, st as when, t as PermissionEntry, tt as not, u as PermissionOverrides, ut as applyAuthorizationDecision, v as publicReadAdminWrite, w as requireServiceScope, x as requireOrgMembership, y as readOnly, z as describePermissionMap } from "../index-
|
|
5
|
-
import { a as createMemoryResourceRateLimiter, i as ResourceRateLimiter, n as ResourceRateLimitDecision, o as resolveResourceRateLimiter, r as ResourceRateLimitPolicy, t as ResourceRateLimitContext } from "../resourceRateLimit-
|
|
2
|
+
import { c as DataPolicy, d as UserBase, l as PermissionCheck, m as normalizeRoles, p as getUserRoles, s as AuthorizationDecision, u as PermissionContext } from "../base-HXNgPQww.mjs";
|
|
3
|
+
import { a as applyFieldReadPermissions, c as resolveEffectiveRoles, i as FieldWritePermissionResult, n as FieldPermissionMap, o as applyFieldWritePermissions, r as FieldPermissionType, s as fields, t as FieldPermission } from "../fields-JTkrtO-r.mjs";
|
|
4
|
+
import { $ as deny, A as GrantResolution, B as explainAccess, C as requireScopeContext, D as createRoleHierarchy, E as RoleHierarchy, F as AccessExplanation, G as createDynamicPermissionMatrix, H as DynamicPermissionMatrix, I as PermissionRequirement, J as PublicPolicy, K as createOrgPermissions, L as collectPublicSurface, M as modeSatisfies, N as requireGrant, O as GRANT_MODES, P as conjoinPolicyFilters, Q as anyOf, R as describePermission, S as requireOrgRole, T as requireTeamMembership, U as DynamicPermissionMatrixConfig, V as ConnectEventsOptions, W as PermissionEventBus, X as allow, Y as allOf, Z as allowPublic, _ as publicRead, _t as requireMandate, a as PermissionMatrixRegistry, at as requireRoles, b as requireOrgInScope, c as introspectModule, ct as scopeOf, d as adminOnly, dt as evaluatePermissionDecision, et as denyAll, f as authenticated, ft as normalizeToDecision, g as presets_d_exports, gt as requireDPoP, h as permissionMatrix, ht as requireAgentScope, i as PermissionMatrixOptions, it as requirePlatformRole, j as RequireGrantOptions, k as GrantMode, l as introspectRegistry, lt as PermissionCheckReturn, m as ownerWithAdminBypass, mt as RequireMandateOptions, n as PermissionEntryType, nt as requireAuth, o as buildPermissionMatrix, ot as roles, p as fullPublic, pt as RequireAgentScopeOptions, q as AllowPublicOptions, r as PermissionMatrix, rt as requireOwnership, s as introspectCheck, st as when, t as PermissionEntry, tt as not, u as PermissionOverrides, ut as applyAuthorizationDecision, v as publicReadAdminWrite, w as requireServiceScope, x as requireOrgMembership, y as readOnly, z as describePermissionMap } from "../index-B5i9-vuP.mjs";
|
|
5
|
+
import { a as createMemoryResourceRateLimiter, i as ResourceRateLimiter, n as ResourceRateLimitDecision, o as resolveResourceRateLimiter, r as ResourceRateLimitPolicy, t as ResourceRateLimitContext } from "../resourceRateLimit-DCWglD7V.mjs";
|
|
6
6
|
export { type AccessExplanation, type AllowPublicOptions, type AuthorizationDecision, type ConnectEventsOptions, type DataPolicy, type DynamicPermissionMatrix, type DynamicPermissionMatrixConfig, type FieldPermission, type FieldPermissionMap, type FieldPermissionType, type FieldWritePermissionResult, GRANT_MODES, type GrantMode, type GrantResolution, type PermissionCheck, type PermissionCheckReturn, type PermissionContext, type PermissionEntry, type PermissionEntryType, type PermissionEventBus, type PermissionMatrix, type PermissionMatrixOptions, type PermissionMatrixRegistry, type PermissionOverrides, type PermissionRequirement, type PublicPolicy, type RequireAgentScopeOptions, type RequireGrantOptions, type RequireMandateOptions, type ResourceRateLimitContext, type ResourceRateLimitDecision, type ResourceRateLimitPolicy, type ResourceRateLimiter, type RoleHierarchy, type UserBase, adminOnly, allOf, allow, allowPublic, anyOf, applyAuthorizationDecision, applyFieldReadPermissions, applyFieldWritePermissions, authenticated, buildPermissionMatrix, collectPublicSurface, conjoinPolicyFilters, createDynamicPermissionMatrix, createMemoryResourceRateLimiter, createOrgPermissions, createRoleHierarchy, deny, denyAll, describePermission, describePermissionMap, evaluatePermissionDecision, explainAccess, fields, fullPublic, getUserRoles, introspectCheck, introspectModule, introspectRegistry, modeSatisfies, normalizeRoles, normalizeToDecision, not, ownerWithAdminBypass, permissionMatrix, presets_d_exports as permissions, publicRead, publicReadAdminWrite, readOnly, requireAgentScope, requireAuth, requireDPoP, requireGrant, requireMandate, requireOrgInScope, requireOrgMembership, requireOrgRole, requireOwnership, requirePlatformRole, requireRoles, requireScopeContext, requireServiceScope, requireTeamMembership, resolveEffectiveRoles, resolveResourceRateLimiter, roles, scopeOf, when };
|
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
/*! @classytic/arc v2.
|
|
2
|
-
import { t as conjoinPolicyFilters } from "../filter-merge-
|
|
3
|
-
import { n as getUserRoles, r as normalizeRoles } from "../userHelpers-
|
|
4
|
-
import { a as resolveEffectiveRoles, i as fields, n as applyFieldWritePermissions, t as applyFieldReadPermissions } from "../fields-
|
|
5
|
-
import { i as normalizeToDecision, r as evaluatePermissionDecision, t as applyAuthorizationDecision } from "../authorizationDecision-
|
|
6
|
-
import { i as resolveResourceRateLimiter, t as createMemoryResourceRateLimiter } from "../resourceRateLimit-
|
|
7
|
-
import { A as requireAgentScope, B as requireAuth, C as createOrgPermissions, D as requireScopeContext, E as requireOrgRole, F as allowPublic, G as when, H as requirePlatformRole, I as anyOf, K as scopeOf, L as deny, M as requireMandate, N as allOf, O as requireServiceScope, P as allow, R as denyAll, S as createDynamicPermissionMatrix, T as requireOrgMembership, U as requireRoles, V as requireOwnership, W as roles, _ as requireGrant, a as adminOnly, b as describePermissionMap, c as ownerWithAdminBypass, d as publicRead, f as publicReadAdminWrite, g as modeSatisfies, h as GRANT_MODES, i as introspectRegistry, j as requireDPoP, k as requireTeamMembership, l as permissionMatrix, m as createRoleHierarchy, n as introspectCheck, o as authenticated, p as readOnly, r as introspectModule, s as fullPublic, t as buildPermissionMatrix, u as presets_exports, v as collectPublicSurface, w as requireOrgInScope, x as explainAccess, y as describePermission, z as not } from "../permissions-
|
|
1
|
+
/*! @classytic/arc v2.47.0 | MIT | https://classytic.com */
|
|
2
|
+
import { t as conjoinPolicyFilters } from "../filter-merge-6kasezRH.mjs";
|
|
3
|
+
import { n as getUserRoles, r as normalizeRoles } from "../userHelpers-_eGj6kf0.mjs";
|
|
4
|
+
import { a as resolveEffectiveRoles, i as fields, n as applyFieldWritePermissions, t as applyFieldReadPermissions } from "../fields-CYdpcV73.mjs";
|
|
5
|
+
import { i as normalizeToDecision, r as evaluatePermissionDecision, t as applyAuthorizationDecision } from "../authorizationDecision-DYiubkYw.mjs";
|
|
6
|
+
import { i as resolveResourceRateLimiter, t as createMemoryResourceRateLimiter } from "../resourceRateLimit-1WbcyMZY.mjs";
|
|
7
|
+
import { A as requireAgentScope, B as requireAuth, C as createOrgPermissions, D as requireScopeContext, E as requireOrgRole, F as allowPublic, G as when, H as requirePlatformRole, I as anyOf, K as scopeOf, L as deny, M as requireMandate, N as allOf, O as requireServiceScope, P as allow, R as denyAll, S as createDynamicPermissionMatrix, T as requireOrgMembership, U as requireRoles, V as requireOwnership, W as roles, _ as requireGrant, a as adminOnly, b as describePermissionMap, c as ownerWithAdminBypass, d as publicRead, f as publicReadAdminWrite, g as modeSatisfies, h as GRANT_MODES, i as introspectRegistry, j as requireDPoP, k as requireTeamMembership, l as permissionMatrix, m as createRoleHierarchy, n as introspectCheck, o as authenticated, p as readOnly, r as introspectModule, s as fullPublic, t as buildPermissionMatrix, u as presets_exports, v as collectPublicSurface, w as requireOrgInScope, x as explainAccess, y as describePermission, z as not } from "../permissions-BBy4bOGi.mjs";
|
|
8
8
|
export { GRANT_MODES, adminOnly, allOf, allow, allowPublic, anyOf, applyAuthorizationDecision, applyFieldReadPermissions, applyFieldWritePermissions, authenticated, buildPermissionMatrix, collectPublicSurface, conjoinPolicyFilters, createDynamicPermissionMatrix, createMemoryResourceRateLimiter, createOrgPermissions, createRoleHierarchy, deny, denyAll, describePermission, describePermissionMap, evaluatePermissionDecision, explainAccess, fields, fullPublic, getUserRoles, introspectCheck, introspectModule, introspectRegistry, modeSatisfies, normalizeRoles, normalizeToDecision, not, ownerWithAdminBypass, permissionMatrix, presets_exports as permissions, publicRead, publicReadAdminWrite, readOnly, requireAgentScope, requireAuth, requireDPoP, requireGrant, requireMandate, requireOrgInScope, requireOrgMembership, requireOrgRole, requireOwnership, requirePlatformRole, requireRoles, requireScopeContext, requireServiceScope, requireTeamMembership, resolveEffectiveRoles, resolveResourceRateLimiter, roles, scopeOf, when };
|
|
@@ -1,14 +1,14 @@
|
|
|
1
|
-
/*! @classytic/arc v2.
|
|
2
|
-
import { t as __exportAll } from "./rolldown-runtime-
|
|
3
|
-
import { t as arcLog } from "./logger-
|
|
4
|
-
import { t as conjoinPolicyFilters } from "./filter-merge-
|
|
5
|
-
import { n as getUserRoles } from "./userHelpers-
|
|
6
|
-
import { C as isService, S as isOrgInScope, a as getDPoPJkt, b as isElevated, d as getScopeContext, f as getScopeContextMap, g as getUserId, m as getTeamId, n as PUBLIC_SCOPE, o as getMandate, p as getServiceScopes, u as getRequestScope, v as hasOrgAccess, x as isMember } from "./types-
|
|
7
|
-
import { i as normalizeToDecision } from "./authorizationDecision-
|
|
8
|
-
import { n as declareRuntimeCapability } from "./runtimeCapabilities-
|
|
9
|
-
import { t as MemoryCacheStore } from "./memory-
|
|
1
|
+
/*! @classytic/arc v2.47.0 | MIT | https://classytic.com */
|
|
2
|
+
import { t as __exportAll } from "./rolldown-runtime-yH2lHMo_.mjs";
|
|
3
|
+
import { t as arcLog } from "./logger-C110X5Yz.mjs";
|
|
4
|
+
import { t as conjoinPolicyFilters } from "./filter-merge-6kasezRH.mjs";
|
|
5
|
+
import { n as getUserRoles } from "./userHelpers-_eGj6kf0.mjs";
|
|
6
|
+
import { C as isService, S as isOrgInScope, a as getDPoPJkt, b as isElevated, d as getScopeContext, f as getScopeContextMap, g as getUserId, m as getTeamId, n as PUBLIC_SCOPE, o as getMandate, p as getServiceScopes, u as getRequestScope, v as hasOrgAccess, x as isMember } from "./types-DZHqOuJE.mjs";
|
|
7
|
+
import { i as normalizeToDecision } from "./authorizationDecision-DYiubkYw.mjs";
|
|
8
|
+
import { n as declareRuntimeCapability } from "./runtimeCapabilities-CYCEtU1W.mjs";
|
|
9
|
+
import { t as MemoryCacheStore } from "./memory-D9qkhXiB.mjs";
|
|
10
10
|
import { randomUUID } from "node:crypto";
|
|
11
|
-
|
|
11
|
+
// src/permissions/context.ts
|
|
12
12
|
/**
|
|
13
13
|
* PermissionContext accessors (arc 2.30 — transport-neutral evaluation).
|
|
14
14
|
*
|
|
@@ -38,8 +38,7 @@ function scopeOf(ctx) {
|
|
|
38
38
|
if (ctx.scope) return ctx.scope;
|
|
39
39
|
return ctx.request ? getRequestScope(ctx.request) : PUBLIC_SCOPE;
|
|
40
40
|
}
|
|
41
|
-
|
|
42
|
-
//#region src/permissions/core.ts
|
|
41
|
+
// src/permissions/core.ts
|
|
43
42
|
/**
|
|
44
43
|
* Build an `allow` {@link AuthorizationDecision}, optionally attaching a row-level
|
|
45
44
|
* `policy` and/or a `scope` to install. The idiomatic "grant" return for arc
|
|
@@ -457,8 +456,7 @@ function when(condition) {
|
|
|
457
456
|
return await condition(ctx) ? allow() : deny("Condition not met");
|
|
458
457
|
};
|
|
459
458
|
}
|
|
460
|
-
|
|
461
|
-
//#region src/permissions/agent.ts
|
|
459
|
+
// src/permissions/agent.ts
|
|
462
460
|
/**
|
|
463
461
|
* Agent-Auth Permission Helpers — DPoP + capability mandates for AI-agent flows
|
|
464
462
|
*
|
|
@@ -646,8 +644,7 @@ function requireAgentScope(opts) {
|
|
|
646
644
|
};
|
|
647
645
|
return check;
|
|
648
646
|
}
|
|
649
|
-
|
|
650
|
-
//#region src/permissions/scope.ts
|
|
647
|
+
// src/permissions/scope.ts
|
|
651
648
|
/**
|
|
652
649
|
* Permission Scope — checks bound to RequestScope.
|
|
653
650
|
*
|
|
@@ -864,8 +861,7 @@ function requireTeamMembership() {
|
|
|
864
861
|
check._teamPermission = "membership";
|
|
865
862
|
return check;
|
|
866
863
|
}
|
|
867
|
-
|
|
868
|
-
//#region src/permissions/dynamic.ts
|
|
864
|
+
// src/permissions/dynamic.ts
|
|
869
865
|
/**
|
|
870
866
|
* Permission Matrices — role × resource × action mapping.
|
|
871
867
|
*
|
|
@@ -1159,8 +1155,7 @@ function createDynamicPermissionMatrix(config) {
|
|
|
1159
1155
|
}
|
|
1160
1156
|
};
|
|
1161
1157
|
}
|
|
1162
|
-
|
|
1163
|
-
//#region src/permissions/explain.ts
|
|
1158
|
+
// src/permissions/explain.ts
|
|
1164
1159
|
/**
|
|
1165
1160
|
* Extract a check's static requirement from its `PermissionCheckMeta`. Public
|
|
1166
1161
|
* wins; then a scope-context gate (optionally with roles); then the union of
|
|
@@ -1333,8 +1328,7 @@ function describePermissionMap(permissions) {
|
|
|
1333
1328
|
function collectPublicSurface(permissions) {
|
|
1334
1329
|
return Object.entries(describePermissionMap(permissions)).filter(([, req]) => req.kind === "public").map(([action]) => action);
|
|
1335
1330
|
}
|
|
1336
|
-
|
|
1337
|
-
//#region src/permissions/grants.ts
|
|
1331
|
+
// src/permissions/grants.ts
|
|
1338
1332
|
/**
|
|
1339
1333
|
* Per-record grants — the `requireGrant` combinator + mode lattice.
|
|
1340
1334
|
*
|
|
@@ -1442,8 +1436,7 @@ function requireGrant(options) {
|
|
|
1442
1436
|
return deny(reason);
|
|
1443
1437
|
};
|
|
1444
1438
|
}
|
|
1445
|
-
|
|
1446
|
-
//#region src/permissions/roleHierarchy.ts
|
|
1439
|
+
// src/permissions/roleHierarchy.ts
|
|
1447
1440
|
/**
|
|
1448
1441
|
* Create a role hierarchy from a parent → children map.
|
|
1449
1442
|
*
|
|
@@ -1514,8 +1507,7 @@ function createRoleHierarchy(map) {
|
|
|
1514
1507
|
}
|
|
1515
1508
|
};
|
|
1516
1509
|
}
|
|
1517
|
-
|
|
1518
|
-
//#region src/permissions/presets.ts
|
|
1510
|
+
// src/permissions/presets.ts
|
|
1519
1511
|
/**
|
|
1520
1512
|
* Permission Presets — Common permission patterns in one call.
|
|
1521
1513
|
*
|
|
@@ -1689,8 +1681,7 @@ function readOnly(overrides) {
|
|
|
1689
1681
|
delete: denyAll("Write operations are disabled on this read-only resource")
|
|
1690
1682
|
}, overrides);
|
|
1691
1683
|
}
|
|
1692
|
-
|
|
1693
|
-
//#region src/permissions/matrix.ts
|
|
1684
|
+
// src/permissions/matrix.ts
|
|
1694
1685
|
/**
|
|
1695
1686
|
* Permission MATRIX — what the caller may do, answered from the live registry.
|
|
1696
1687
|
*
|
|
@@ -1805,5 +1796,4 @@ function buildPermissionMatrix(options = {}) {
|
|
|
1805
1796
|
modules
|
|
1806
1797
|
};
|
|
1807
1798
|
}
|
|
1808
|
-
//#endregion
|
|
1809
1799
|
export { requireAgentScope as A, requireAuth as B, createOrgPermissions as C, requireScopeContext as D, requireOrgRole as E, allowPublic as F, when as G, requirePlatformRole as H, anyOf as I, scopeOf as K, deny as L, requireMandate as M, allOf as N, requireServiceScope as O, allow as P, denyAll as R, createDynamicPermissionMatrix as S, requireOrgMembership as T, requireRoles as U, requireOwnership as V, roles as W, requireGrant as _, adminOnly as a, describePermissionMap as b, ownerWithAdminBypass as c, publicRead as d, publicReadAdminWrite as f, modeSatisfies as g, GRANT_MODES as h, introspectRegistry as i, requireDPoP as j, requireTeamMembership as k, permissionMatrix as l, createRoleHierarchy as m, introspectCheck as n, authenticated as o, readOnly as p, introspectModule as r, fullPublic as s, buildPermissionMatrix as t, presets_exports as u, collectPublicSurface as v, requireOrgInScope as w, explainAccess as x, describePermission as y, not as z };
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
/*! @classytic/arc v2.
|
|
2
|
-
import { r as ForbiddenError } from "./errors-
|
|
3
|
-
|
|
1
|
+
/*! @classytic/arc v2.47.0 | MIT | https://classytic.com */
|
|
2
|
+
import { r as ForbiddenError } from "./errors-DnrUChAy.mjs";
|
|
3
|
+
// src/pipeline/pipe.ts
|
|
4
4
|
/**
|
|
5
5
|
* Compose pipeline steps into an ordered array.
|
|
6
6
|
* Accepts guards, transforms, and interceptors in any order.
|
|
@@ -58,5 +58,4 @@ async function executePipeline(steps, ctx, handler, operation) {
|
|
|
58
58
|
}
|
|
59
59
|
return chain();
|
|
60
60
|
}
|
|
61
|
-
//#endregion
|
|
62
61
|
export { pipe as n, executePipeline as t };
|
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
|
|
2
|
-
import { Vn as IControllerResponse, _t as PipelineConfig, bt as Transform, gt as OperationFilter, ht as NextFunction, mt as Interceptor, pt as Guard, vt as PipelineContext, yt as PipelineStep } from "../index-
|
|
3
|
-
//#region src/pipeline/guard.d.ts
|
|
2
|
+
import { Vn as IControllerResponse, _t as PipelineConfig, bt as Transform, gt as OperationFilter, ht as NextFunction, mt as Interceptor, pt as Guard, vt as PipelineContext, yt as PipelineStep } from "../index-Cy2-QffW.mjs";
|
|
4
3
|
interface GuardOptions {
|
|
5
4
|
operations?: OperationFilter;
|
|
6
5
|
handler: (ctx: PipelineContext) => boolean | Promise<boolean>;
|
|
@@ -12,8 +11,6 @@ interface GuardOptions {
|
|
|
12
11
|
* @param handlerOrOptions - Handler function or options object
|
|
13
12
|
*/
|
|
14
13
|
export declare function guard(name: string, handlerOrOptions: ((ctx: PipelineContext) => boolean | Promise<boolean>) | GuardOptions): Guard;
|
|
15
|
-
//#endregion
|
|
16
|
-
//#region src/pipeline/intercept.d.ts
|
|
17
14
|
interface InterceptOptions {
|
|
18
15
|
operations?: OperationFilter;
|
|
19
16
|
handler: (ctx: PipelineContext, next: NextFunction) => Promise<IControllerResponse<unknown>>;
|
|
@@ -25,8 +22,6 @@ interface InterceptOptions {
|
|
|
25
22
|
* @param handlerOrOptions - Handler function or options object
|
|
26
23
|
*/
|
|
27
24
|
export declare function intercept(name: string, handlerOrOptions: ((ctx: PipelineContext, next: NextFunction) => Promise<IControllerResponse<unknown>>) | InterceptOptions): Interceptor;
|
|
28
|
-
//#endregion
|
|
29
|
-
//#region src/pipeline/pipe.d.ts
|
|
30
25
|
/**
|
|
31
26
|
* Compose pipeline steps into an ordered array.
|
|
32
27
|
* Accepts guards, transforms, and interceptors in any order.
|
|
@@ -45,8 +40,6 @@ export declare function pipe(...steps: PipelineStep[]): PipelineStep[];
|
|
|
45
40
|
* @returns The controller response (possibly modified by interceptors)
|
|
46
41
|
*/
|
|
47
42
|
export declare function executePipeline(steps: PipelineStep[], ctx: PipelineContext, handler: (ctx: PipelineContext) => Promise<IControllerResponse<unknown>>, operation: string): Promise<IControllerResponse<unknown>>;
|
|
48
|
-
//#endregion
|
|
49
|
-
//#region src/pipeline/transform.d.ts
|
|
50
43
|
interface TransformOptions {
|
|
51
44
|
operations?: OperationFilter;
|
|
52
45
|
handler: (ctx: PipelineContext) => PipelineContext | undefined | Promise<PipelineContext | undefined>;
|
|
@@ -58,5 +51,4 @@ interface TransformOptions {
|
|
|
58
51
|
* @param handlerOrOptions - Handler function or options object
|
|
59
52
|
*/
|
|
60
53
|
export declare function transform(name: string, handlerOrOptions: ((ctx: PipelineContext) => PipelineContext | undefined | Promise<PipelineContext | undefined>) | TransformOptions): Transform;
|
|
61
|
-
//#endregion
|
|
62
54
|
export type { Guard, GuardOptions, InterceptOptions, Interceptor, NextFunction, OperationFilter, PipelineConfig, PipelineContext, PipelineStep, Transform, TransformOptions };
|
package/dist/pipeline/index.mjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
/*! @classytic/arc v2.
|
|
2
|
-
import { n as pipe, t as executePipeline } from "../pipe-
|
|
3
|
-
|
|
1
|
+
/*! @classytic/arc v2.47.0 | MIT | https://classytic.com */
|
|
2
|
+
import { n as pipe, t as executePipeline } from "../pipe-BOm2o4UA.mjs";
|
|
3
|
+
// src/pipeline/guard.ts
|
|
4
4
|
/**
|
|
5
5
|
* Create a named guard.
|
|
6
6
|
*
|
|
@@ -16,8 +16,7 @@ function guard(name, handlerOrOptions) {
|
|
|
16
16
|
handler: opts.handler
|
|
17
17
|
};
|
|
18
18
|
}
|
|
19
|
-
|
|
20
|
-
//#region src/pipeline/intercept.ts
|
|
19
|
+
// src/pipeline/intercept.ts
|
|
21
20
|
/**
|
|
22
21
|
* Create a named interceptor.
|
|
23
22
|
*
|
|
@@ -33,8 +32,7 @@ function intercept(name, handlerOrOptions) {
|
|
|
33
32
|
handler: opts.handler
|
|
34
33
|
};
|
|
35
34
|
}
|
|
36
|
-
|
|
37
|
-
//#region src/pipeline/transform.ts
|
|
35
|
+
// src/pipeline/transform.ts
|
|
38
36
|
/**
|
|
39
37
|
* Create a named transform.
|
|
40
38
|
*
|
|
@@ -50,5 +48,4 @@ function transform(name, handlerOrOptions) {
|
|
|
50
48
|
handler: opts.handler
|
|
51
49
|
};
|
|
52
50
|
}
|
|
53
|
-
//#endregion
|
|
54
51
|
export { executePipeline, guard, intercept, pipe, transform };
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
/*! @classytic/arc v2.
|
|
1
|
+
/*! @classytic/arc v2.47.0 | MIT | https://classytic.com */
|
|
2
2
|
import { createEventRouter, matchEventPattern } from "@classytic/primitives/events";
|
|
3
|
-
|
|
3
|
+
// src/factory/module/graph.ts
|
|
4
4
|
/**
|
|
5
5
|
* The module graph — which modules are active, which events each OWNS, which it consumes — and
|
|
6
6
|
* the boot-time checks that keep it honest.
|
|
@@ -288,8 +288,7 @@ function eventTopology(graph, analysis = analyzeModuleGraph(graph)) {
|
|
|
288
288
|
layers: layers.filter(Boolean).map((layer) => layer.sort())
|
|
289
289
|
};
|
|
290
290
|
}
|
|
291
|
-
|
|
292
|
-
//#region src/factory/module/resolve.ts
|
|
291
|
+
// src/factory/module/resolve.ts
|
|
293
292
|
function isLazyBridge(input) {
|
|
294
293
|
return typeof input === "object" && input !== null && !(input instanceof Promise) && typeof input.load === "function";
|
|
295
294
|
}
|
|
@@ -369,8 +368,7 @@ async function resolveModuleArm(module, arm, contribution, fastify) {
|
|
|
369
368
|
if (!Array.isArray(resolved)) throw new TypeError(`[arc] module "${module.name}" ${arm} factory must return an array — received ${resolved === null ? "null" : typeof resolved}.`);
|
|
370
369
|
return resolved;
|
|
371
370
|
}
|
|
372
|
-
|
|
373
|
-
//#region src/factory/module/order.ts
|
|
371
|
+
// src/factory/module/order.ts
|
|
374
372
|
/**
|
|
375
373
|
* Order modules for composition — a STABLE topological sort. Every later phase
|
|
376
374
|
* (bootstrap, resources, afterResources, reverse-order onClose) iterates the
|
|
@@ -462,8 +460,7 @@ function describeModuleCycle(remaining, edges) {
|
|
|
462
460
|
}
|
|
463
461
|
return `[arc] module dependency cycle: ${cycle ? cycle.join(" → ") : [...remaining].join(", ")}. Modules cannot dependsOn each other circularly — break it with a shared module both point at, declare the softer direction as \`requires.modules\` (presence only, no ordering edge), or wire it through an event/port. A module that dependsOn a \`kind: 'aggregator'\` module is always a cycle.`;
|
|
464
462
|
}
|
|
465
|
-
|
|
466
|
-
//#region src/factory/module/plan.ts
|
|
463
|
+
// src/factory/module/plan.ts
|
|
467
464
|
/** A port counts as supplied when it is an own key whose value is neither `undefined` nor `null`. */
|
|
468
465
|
function isSupplied(ports, name) {
|
|
469
466
|
return Object.hasOwn(ports, name) && ports[name] !== void 0 && ports[name] !== null;
|
|
@@ -561,5 +558,4 @@ function resolveModuleClosure(modules, roots) {
|
|
|
561
558
|
for (const m of modules) if (m.kind === "platform") visit(m.name, void 0);
|
|
562
559
|
return modules.filter((m) => included.has(m.name));
|
|
563
560
|
}
|
|
564
|
-
//#endregion
|
|
565
561
|
export { dependentsOf as _, portsForModule as a, verifyEventDurability as b, declareModules as c, resolveModule as d, resolveModuleArm as f, crudEventsOf as g, buildModuleGraph as h, planModules as i, isLazyBridge as l, analyzeModuleGraph as m, composeModules as n, resolveModuleClosure as o, activateBridges as p, compositionProblems as r, orderModules as s, assertComposable as t, resolveContribution as u, eventTopology as v, verifyModuleGraph as x, renderModuleGraph as y };
|