@directive-run/core 1.3.0 → 1.5.0

package/dist/worker.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/adapters/worker.ts"],"names":["createWorkerClient","options","worker","onFactChange","onDerivationChange","onRequirementCreated","onRequirementMet","onError","pendingRequests","requestIdCounter","initResolve","startResolve","stopResolve","destroyResolve","resolveLifecycle","resolve","resolvePendingRequest","requestId","value","pending","handleReady","handleStarted","handleStopped","handleDestroyed","handleFactChanged","message","handleDerivationChanged","handleRequirementCreated","handleRequirementMet","handleError","handleSnapshotResult","handleInspectResult","handleSettleResult","event","send","request","reject","config","key","facts","timeout","workerModuleRegistry","getWorkerModuleRegistry","registerWorkerModule","name","module","handleWorkerMessages","system","handleInit","created","createWorkerSystem","handleStart","sys","handleStop","handleDestroy","handleGetSnapshot","snapshot","handleInspect","inspection","handleSettle","error","dispatchMessage","createSystem","registry","modules","prev","id","req","resolverId","factsProxy"],"mappings":"AAwJO,SAASA,CAAAA,CAAmBC,CAAAA,CAA4C,CAC7E,GAAM,CACJ,MAAA,CAAAC,CAAAA,CACA,YAAA,CAAAC,CAAAA,CACA,kBAAA,CAAAC,CAAAA,CACA,oBAAA,CAAAC,CAAAA,CACA,gBAAA,CAAAC,CAAAA,CACA,OAAA,CAAAC,CACF,CAAA,CAAIN,CAAAA,CAGEO,CAAAA,CAAkB,IAAI,GAAA,CAIxBC,CAAAA,CAAmB,CAAA,CAGnBC,CAAAA,CAAmC,IAAA,CACnCC,CAAAA,CAAoC,IAAA,CACpCC,EAAmC,IAAA,CACnCC,CAAAA,CAAsC,IAAA,CAI1C,SAASC,CAAAA,CACPC,CAAAA,CACqB,CACrB,OAAAA,CAAAA,IAAU,CAEH,IACT,CAEA,SAASC,CAAAA,CAAsBC,CAAAA,CAAmBC,CAAAA,CAAsB,CACtE,IAAMC,CAAAA,CAAUX,CAAAA,CAAgB,GAAA,CAAIS,CAAS,CAAA,CACzCE,CAAAA,GACFA,CAAAA,CAAQ,OAAA,CAAQD,CAAK,CAAA,CACrBV,CAAAA,CAAgB,MAAA,CAAOS,CAAS,CAAA,EAEpC,CAEA,SAASG,CAAAA,EAAoB,CAC3BV,CAAAA,CAAcI,CAAAA,CAAiBJ,CAAW,EAC5C,CAEA,SAASW,CAAAA,EAAsB,CAC7BV,CAAAA,CAAeG,CAAAA,CAAiBH,CAAY,EAC9C,CAEA,SAASW,CAAAA,EAAsB,CAC7BV,CAAAA,CAAcE,CAAAA,CAAiBF,CAAW,EAC5C,CAEA,SAASW,CAAAA,EAAwB,CAC/BV,CAAAA,CAAiBC,CAAAA,CAAiBD,CAAc,EAClD,CAEA,SAASW,CAAAA,CAAkBC,CAAAA,CAAyE,CAClGtB,CAAAA,GAAesB,CAAAA,CAAQ,GAAA,CAAKA,CAAAA,CAAQ,KAAA,CAAOA,CAAAA,CAAQ,IAAI,EACzD,CAEA,SAASC,CAAAA,CAAwBD,CAAAA,CAA+E,CAC9GrB,IAAqBqB,CAAAA,CAAQ,GAAA,CAAKA,CAAAA,CAAQ,KAAK,EACjD,CAEA,SAASE,CAAAA,CAAyBF,CAAAA,CAAgF,CAChHpB,CAAAA,GAAuBoB,CAAAA,CAAQ,WAAW,EAC5C,CAEA,SAASG,EAAqBH,CAAAA,CAA4E,CACxGnB,CAAAA,GAAmBmB,CAAAA,CAAQ,aAAA,CAAeA,CAAAA,CAAQ,UAAU,EAC9D,CAEA,SAASI,CAAAA,CAAYJ,CAAAA,CAAkE,CACrFlB,CAAAA,GAAUkB,CAAAA,CAAQ,KAAA,CAAOA,CAAAA,CAAQ,MAAM,EACzC,CAEA,SAASK,CAAAA,CAAqBL,CAAAA,CAA4E,CACxGT,CAAAA,CAAsBS,CAAAA,CAAQ,SAAA,CAAWA,CAAAA,CAAQ,QAAQ,EAC3D,CAEA,SAASM,EAAoBN,CAAAA,CAA2E,CACtGT,CAAAA,CAAsBS,CAAAA,CAAQ,SAAA,CAAWA,CAAAA,CAAQ,UAAU,EAC7D,CAEA,SAASO,CAAAA,CAAmBP,CAAAA,CAA0E,CACpG,IAAMN,CAAAA,CAAUX,CAAAA,CAAgB,IAAIiB,CAAAA,CAAQ,SAAS,CAAA,CACjDN,CAAAA,GACEM,CAAAA,CAAQ,OAAA,CACVN,CAAAA,CAAQ,OAAA,CAAQ,MAAS,CAAA,CAEzBA,CAAAA,CAAQ,MAAA,CAAO,IAAI,KAAA,CAAMM,CAAAA,CAAQ,KAAA,EAAS,eAAe,CAAC,CAAA,CAE5DjB,CAAAA,CAAgB,MAAA,CAAOiB,CAAAA,CAAQ,SAAS,CAAA,EAE5C,CAGAvB,CAAAA,CAAO,SAAA,CAAa+B,CAAAA,EAA+C,CACjE,IAAMR,CAAAA,CAAUQ,CAAAA,CAAM,IAAA,CAEtB,OAAQR,CAAAA,CAAQ,IAAA,EACd,KAAK,OAAA,CAAS,OAAOL,CAAAA,EAAY,CACjC,KAAK,SAAA,CAAW,OAAOC,CAAAA,EAAc,CACrC,KAAK,SAAA,CAAW,OAAOC,CAAAA,EAAc,CACrC,KAAK,WAAA,CAAa,OAAOC,CAAAA,EAAgB,CACzC,KAAK,cAAA,CAAgB,OAAOC,CAAAA,CAAkBC,CAAO,CAAA,CACrD,KAAK,oBAAA,CAAsB,OAAOC,EAAwBD,CAAO,CAAA,CACjE,KAAK,qBAAA,CAAuB,OAAOE,CAAAA,CAAyBF,CAAO,CAAA,CACnE,KAAK,iBAAA,CAAmB,OAAOG,CAAAA,CAAqBH,CAAO,CAAA,CAC3D,KAAK,OAAA,CAAS,OAAOI,CAAAA,CAAYJ,CAAO,CAAA,CACxC,KAAK,iBAAA,CAAmB,OAAOK,CAAAA,CAAqBL,CAAO,CAAA,CAC3D,KAAK,gBAAA,CAAkB,OAAOM,CAAAA,CAAoBN,CAAO,CAAA,CACzD,KAAK,eAAA,CAAiB,OAAOO,CAAAA,CAAmBP,CAAO,CACzD,CACF,CAAA,CAEAvB,CAAAA,CAAO,OAAA,CAAW+B,CAAAA,EAAU,CAC1B1B,CAAAA,GAAU0B,CAAAA,CAAM,OAAA,CAAS,QAAQ,EACnC,EAEA,SAASC,CAAAA,CAAKT,CAAAA,CAAqC,CACjDvB,CAAAA,CAAO,WAAA,CAAYuB,CAAO,EAC5B,CAEA,SAASU,CAAAA,CACPV,CAAAA,CACY,CACZ,OAAO,IAAI,OAAA,CAAQ,CAACV,CAAAA,CAASqB,CAAAA,GAAW,CACtC5B,CAAAA,CAAgB,GAAA,CAAIiB,CAAAA,CAAQ,SAAA,CAAW,CACrC,OAAA,CAASV,CAAAA,CACT,MAAA,CAAAqB,CACF,CAAC,CAAA,CACDF,CAAAA,CAAKT,CAAO,EACd,CAAC,CACH,CAEA,OAAO,CACL,IAAA,CAAKY,CAAAA,CAA2C,CAC9C,OAAO,IAAI,OAAA,CAAStB,CAAAA,EAAY,CAC9BL,CAAAA,CAAcK,CAAAA,CACdmB,CAAAA,CAAK,CAAE,IAAA,CAAM,MAAA,CAAQ,MAAA,CAAAG,CAAO,CAAC,EAC/B,CAAC,CACH,CAAA,CAEA,KAAA,EAAuB,CACrB,OAAO,IAAI,OAAA,CAAStB,GAAY,CAC9BJ,CAAAA,CAAeI,CAAAA,CACfmB,CAAAA,CAAK,CAAE,IAAA,CAAM,OAAQ,CAAC,EACxB,CAAC,CACH,CAAA,CAEA,IAAA,EAAsB,CACpB,OAAO,IAAI,QAASnB,CAAAA,EAAY,CAC9BH,CAAAA,CAAcG,CAAAA,CACdmB,CAAAA,CAAK,CAAE,IAAA,CAAM,MAAO,CAAC,EACvB,CAAC,CACH,CAAA,CAEA,OAAA,EAAyB,CACvB,OAAO,IAAI,OAAA,CAASnB,CAAAA,EAAY,CAC9BF,CAAAA,CAAiBE,CAAAA,CACjBmB,CAAAA,CAAK,CAAE,IAAA,CAAM,SAAU,CAAC,EAC1B,CAAC,CACH,CAAA,CAEA,OAAA,CAAQI,CAAAA,CAAapB,CAAAA,CAAsB,CACzCgB,CAAAA,CAAK,CAAE,IAAA,CAAM,UAAA,CAAY,GAAA,CAAAI,CAAAA,CAAK,KAAA,CAAApB,CAAM,CAAC,EACvC,CAAA,CAEA,QAAA,CAASqB,CAAAA,CAAsC,CAC7CL,EAAK,CAAE,IAAA,CAAM,WAAA,CAAa,KAAA,CAAAK,CAAM,CAAC,EACnC,CAAA,CAEA,QAAA,CAASN,CAAAA,CAAuD,CAC9DC,CAAAA,CAAK,CAAE,IAAA,CAAM,UAAA,CAAY,KAAA,CAAAD,CAAM,CAAC,EAClC,CAAA,CAEA,WAAA,CACEhC,CAAAA,CACgC,CAChC,IAAMgB,CAAAA,CAAY,CAAA,SAAA,EAAY,EAAER,CAAgB,CAAA,CAAA,CAChD,OAAO0B,CAAAA,CAAQ,CAAE,IAAA,CAAM,eAAgB,OAAA,CAAAlC,CAAAA,CAAS,SAAA,CAAAgB,CAAU,CAAC,CAC7D,CAAA,CAEA,OAAA,EAAqC,CACnC,IAAMA,CAAAA,CAAY,CAAA,QAAA,EAAW,EAAER,CAAgB,CAAA,CAAA,CAC/C,OAAO0B,CAAAA,CAAQ,CAAE,IAAA,CAAM,SAAA,CAAW,SAAA,CAAAlB,CAAU,CAAC,CAC/C,CAAA,CAEA,MAAA,CAAOuB,CAAAA,CAAiC,CACtC,IAAMvB,CAAAA,CAAY,CAAA,OAAA,EAAU,EAAER,CAAgB,CAAA,CAAA,CAC9C,OAAO0B,CAAAA,CAAQ,CAAE,IAAA,CAAM,QAAA,CAAU,OAAA,CAAAK,CAAAA,CAAS,SAAA,CAAAvB,CAAU,CAAC,CACvD,CAAA,CAEA,SAAA,EAAkB,CAChBf,CAAAA,CAAO,YACT,CACF,CACF,CAaA,IAAIuC,CAAAA,CAA8C,IAAA,CAK3C,SAASC,CAAAA,EAA0C,CACxD,OAAKD,CAAAA,GACHA,CAAAA,CAAuB,IAAI,GAAA,CAAA,CAEtBA,CACT,CAiBO,SAASE,CAAAA,CAAqBC,CAAAA,CAAcC,CAAAA,CAAmB,CACpEH,CAAAA,EAAwB,CAAE,GAAA,CAAIE,CAAAA,CAAMC,CAAM,EAC5C,CAeO,SAASC,CAAAA,EAA6B,CAI3C,IAAIC,CAAAA,CAA8B,IAAA,CAIlC,eAAeC,CAAAA,CACbvB,CAAAA,CACuB,CACvB,IAAMwB,CAAAA,CAAU,MAAMC,CAAAA,CAAmBzB,CAAAA,CAAQ,MAAM,CAAA,CACvD,OAAA,WAAA,CAAY,CAAE,IAAA,CAAM,OAAQ,CAAiC,CAAA,CAEtDwB,CACT,CAEA,SAASE,CAAAA,CAAYC,CAAAA,CAAyB,CAC5CA,CAAAA,CAAI,KAAA,EAAM,CACV,WAAA,CAAY,CAAE,IAAA,CAAM,SAAU,CAAiC,EACjE,CAEA,SAASC,CAAAA,CAAWD,CAAAA,CAAyB,CAC3CA,CAAAA,CAAI,IAAA,EAAK,CACT,WAAA,CAAY,CAAE,IAAA,CAAM,SAAU,CAAiC,EACjE,CAEA,SAASE,CAAAA,CAAcF,CAAAA,CAAyB,CAC9CA,CAAAA,CAAI,OAAA,EAAQ,CACZ,WAAA,CAAY,CAAE,IAAA,CAAM,WAAY,CAAiC,EACnE,CAEA,SAASG,CAAAA,CACPH,CAAAA,CACA3B,CAAAA,CACM,CACN,IAAM+B,CAAAA,CAAWJ,CAAAA,CAAI,WAAA,CAAY3B,CAAAA,CAAQ,OAAO,CAAA,CAChD,WAAA,CAAY,CACV,IAAA,CAAM,iBAAA,CACN,SAAA,CAAWA,CAAAA,CAAQ,SAAA,CACnB,SAAA+B,CACF,CAAiC,EACnC,CAEA,SAASC,CAAAA,CACPL,CAAAA,CACA3B,CAAAA,CACM,CACN,IAAMiC,CAAAA,CAAaN,CAAAA,CAAI,OAAA,EAAQ,CAC/B,WAAA,CAAY,CACV,KAAM,gBAAA,CACN,SAAA,CAAW3B,CAAAA,CAAQ,SAAA,CACnB,UAAA,CAAAiC,CACF,CAAiC,EACnC,CAEA,eAAeC,CAAAA,CACbP,CAAAA,CACA3B,CAAAA,CACe,CACf,GAAI,CACF,MAAM2B,CAAAA,CAAI,MAAA,CAAO3B,CAAAA,CAAQ,OAAO,CAAA,CAChC,WAAA,CAAY,CACV,IAAA,CAAM,eAAA,CACN,SAAA,CAAWA,CAAAA,CAAQ,SAAA,CACnB,OAAA,CAAS,CAAA,CACX,CAAiC,EACnC,CAAA,MAASmC,CAAAA,CAAO,CACd,WAAA,CAAY,CACV,IAAA,CAAM,eAAA,CACN,SAAA,CAAWnC,CAAAA,CAAQ,SAAA,CACnB,OAAA,CAAS,KAAA,CACT,KAAA,CAAOmC,CAAAA,YAAiB,KAAA,CAAQA,CAAAA,CAAM,QAAU,MAAA,CAAOA,CAAK,CAC9D,CAAiC,EACnC,CACF,CAIA,eAAeC,CAAAA,CACbpC,CAAAA,CACe,CACf,GAAIA,CAAAA,CAAQ,IAAA,GAAS,MAAA,CAAQ,CAC3BsB,EAAS,MAAMC,CAAAA,CAAWvB,CAAO,CAAA,CAEjC,MACF,CAEA,GAAKsB,CAAAA,CAIL,OAAQtB,CAAAA,CAAQ,IAAA,EACd,KAAK,OAAA,CACH0B,CAAAA,CAAYJ,CAAM,EAClB,MACF,KAAK,MAAA,CACHM,CAAAA,CAAWN,CAAM,CAAA,CACjB,MACF,KAAK,SAAA,CACHO,CAAAA,CAAcP,CAAM,CAAA,CACpBA,CAAAA,CAAS,IAAA,CACT,MACF,KAAK,UAAA,CACHA,CAAAA,CAAO,OAAA,CAAQtB,CAAAA,CAAQ,GAAA,CAAKA,CAAAA,CAAQ,KAAK,CAAA,CACzC,MACF,KAAK,WAAA,CACHsB,CAAAA,CAAO,QAAA,CAAStB,CAAAA,CAAQ,KAAK,CAAA,CAC7B,MACF,KAAK,UAAA,CACHsB,CAAAA,CAAO,QAAA,CAAStB,CAAAA,CAAQ,KAAK,CAAA,CAC7B,MACF,KAAK,cAAA,CACH8B,CAAAA,CAAkBR,CAAAA,CAAQtB,CAAO,CAAA,CACjC,MACF,KAAK,UACHgC,CAAAA,CAAcV,CAAAA,CAAQtB,CAAO,CAAA,CAC7B,MACF,KAAK,QAAA,CACH,MAAMkC,CAAAA,CAAaZ,CAAAA,CAAQtB,CAAO,CAAA,CAClC,KACJ,CACF,CAEA,IAAA,CAAK,UAAY,MAAOQ,CAAAA,EAA8C,CACpE,GAAI,CACF,MAAM4B,CAAAA,CAAgB5B,CAAAA,CAAM,IAAI,EAClC,CAAA,MAAS2B,CAAAA,CAAO,CACd,WAAA,CAAY,CACV,IAAA,CAAM,OAAA,CACN,KAAA,CAAOA,CAAAA,YAAiB,KAAA,CAAQA,CAAAA,CAAM,OAAA,CAAU,MAAA,CAAOA,CAAK,CAAA,CAC5D,MAAA,CAAQ3B,CAAAA,CAAM,IAAA,CAAK,IACrB,CAAiC,EACnC,CACF,EACF,CAKA,eAAeiB,CAAAA,CAAmBb,CAAAA,CAA4B,CAE5D,GAAM,CAAE,YAAA,CAAAyB,CAAa,CAAA,CAAI,MAAM,OAAO,sBAAmB,CAAA,CAEnDC,CAAAA,CAAWrB,CAAAA,GACXsB,CAAAA,CAAmC,EAAC,CAE1C,IAAA,IAAWpB,CAAAA,IAAQP,CAAAA,CAAO,WAAA,CAAa,CACrC,IAAMQ,CAAAA,CAASkB,CAAAA,CAAS,GAAA,CAAInB,CAAI,CAAA,CAChC,GAAI,CAACC,EACH,MAAM,IAAI,KAAA,CACR,CAAA,2BAAA,EAA8BD,CAAI,CAAA,6CAAA,EACFA,CAAI,CAAA,oCAAA,CACtC,CAAA,CAEFoB,CAAAA,CAAQpB,CAAI,CAAA,CAAIC,EAClB,CAmCA,IAAME,CAAAA,CAASe,CAAAA,CAAa,CAE1B,OAAA,CAASE,CAAAA,CACT,OAAA,CAAS,CAnCY,CACrB,IAAA,CAAM,qBAAA,CACN,SAAA,CAAW,CAAC1B,CAAAA,CAAapB,CAAAA,CAAgB+C,CAAAA,GAAkB,CACzD,WAAA,CAAY,CACV,IAAA,CAAM,cAAA,CACN,GAAA,CAAA3B,CAAAA,CACA,KAAA,CAAApB,CAAAA,CACA,IAAA,CAAA+C,CACF,CAAiC,EACnC,CAAA,CACA,mBAAA,CAAqB,CAACC,CAAAA,CAAYhD,CAAAA,GAAmB,CACnD,YAAY,CACV,IAAA,CAAM,oBAAA,CACN,GAAA,CAAKgD,CAAAA,CACL,KAAA,CAAAhD,CACF,CAAiC,EACnC,CAAA,CACA,oBAAA,CAAuBiD,CAAAA,EAAkD,CACvE,WAAA,CAAY,CACV,IAAA,CAAM,sBACN,WAAA,CAAa,CAAE,GAAGA,CAAAA,CAAI,WAAA,CAAa,EAAA,CAAIA,CAAAA,CAAI,EAAG,CAChD,CAAiC,EACnC,CAAA,CACA,gBAAA,CAAkB,CAACA,CAAAA,CAAqBC,CAAAA,GAAuB,CAC7D,WAAA,CAAY,CACV,IAAA,CAAM,iBAAA,CACN,aAAA,CAAeD,CAAAA,CAAI,EAAA,CACnB,UAAA,CAAAC,CACF,CAAiC,EACnC,CACF,CAK0B,CAAA,CACxB,OAAA,CAAS/B,EAAO,OAClB,CAAC,CAAA,CAED,OAAO,CACL,KAAA,CAAO,IAAMU,CAAAA,CAAO,KAAA,EAAM,CAC1B,IAAA,CAAM,IAAMA,CAAAA,CAAO,IAAA,EAAK,CACxB,OAAA,CAAS,IAAMA,CAAAA,CAAO,OAAA,EAAQ,CAC9B,OAAA,CAAS,CAACT,CAAAA,CAAapB,CAAAA,GAAmB,CAEvC6B,CAAAA,CAAO,KAAA,CAAcT,CAAG,CAAA,CAAIpB,EAC/B,CAAA,CACA,QAAA,CAAWqB,CAAAA,EAAmC,CAE5C,IAAM8B,CAAAA,CAAatB,CAAAA,CAAO,KAAA,CAC1B,GAAIsB,CAAAA,CAAW,MAAA,EAAQ,KAAA,CACrBA,CAAAA,CAAW,MAAA,CAAO,KAAA,CAAM,IAAM,CAC5B,IAAA,GAAW,CAAC/B,CAAAA,CAAKpB,CAAK,CAAA,GAAK,MAAA,CAAO,OAAA,CAAQqB,CAAK,CAAA,CAC7C8B,CAAAA,CAAW/B,CAAG,CAAA,CAAIpB,EAEtB,CAAC,CAAA,CAAA,KAGD,IAAA,GAAW,CAACoB,CAAAA,CAAKpB,CAAK,IAAK,MAAA,CAAO,OAAA,CAAQqB,CAAK,CAAA,CAC7C8B,CAAAA,CAAW/B,CAAG,CAAA,CAAIpB,EAGxB,CAAA,CACA,QAAA,CAAWe,CAAAA,EAA4B,CAEpCc,CAAAA,CAAe,QAAA,CAASd,CAAK,EAChC,EACA,WAAA,CAAchC,CAAAA,EACL8C,CAAAA,CAAO,wBAAA,CAAyB9C,CAAO,CAAA,CAEhD,OAAA,CAAS,IAAM8C,CAAAA,CAAO,OAAA,EAAQ,CAC9B,MAAA,CAASP,CAAAA,EAAqBO,CAAAA,CAAO,MAAA,CAAOP,CAAO,CACrD,CACF","file":"worker.js","sourcesContent":["/**\n * Web Worker Adapter - Run Directive engine off the main thread\n *\n * Features:\n * - Run computations in a dedicated worker\n * - Synchronized state between main thread and worker\n * - Automatic serialization of facts and derivations\n * - Event-based communication\n */\n\nimport type {\n  DistributableSnapshot,\n  DistributableSnapshotOptions,\n  ModuleSchema,\n  Requirement,\n  SystemInspection,\n} from \"../core/types.js\";\n\n// ============================================================================\n// Message Types\n// ============================================================================\n\n/** Messages sent from main thread to worker */\nexport type WorkerInboundMessage =\n  | { type: \"INIT\"; config: WorkerSystemConfig }\n  | { type: \"START\" }\n  | { type: \"STOP\" }\n  | { type: \"DESTROY\" }\n  | { type: \"SET_FACT\"; key: string; value: unknown }\n  | { type: \"SET_FACTS\"; facts: Record<string, unknown> }\n  | { type: \"DISPATCH\"; event: { type: string; [key: string]: unknown } }\n  | {\n      type: \"GET_SNAPSHOT\";\n      options?: DistributableSnapshotOptions;\n      requestId: string;\n    }\n  | { type: \"INSPECT\"; requestId: string }\n  | { type: \"SETTLE\"; timeout?: number; requestId: string };\n\n/** Messages sent from worker to main thread */\nexport type WorkerOutboundMessage =\n  | { type: \"READY\" }\n  | { type: \"STARTED\" }\n  | { type: \"STOPPED\" }\n  | { type: \"DESTROYED\" }\n  | { type: \"FACT_CHANGED\"; key: string; value: unknown; prev: unknown }\n  | { type: \"DERIVATION_CHANGED\"; key: string; value: unknown }\n  | { type: \"REQUIREMENT_CREATED\"; requirement: Requirement & { id: string } }\n  | { type: \"REQUIREMENT_MET\"; requirementId: string; resolverId: string }\n  | { type: \"ERROR\"; error: string; source?: string }\n  | {\n      type: \"SNAPSHOT_RESULT\";\n      requestId: string;\n      snapshot: DistributableSnapshot;\n    }\n  | { type: \"INSPECT_RESULT\"; requestId: string; inspection: SystemInspection }\n  | {\n      type: \"SETTLE_RESULT\";\n      requestId: string;\n      success: boolean;\n      error?: string;\n    };\n\n// ============================================================================\n// Worker System Config\n// ============================================================================\n\n/**\n * Configuration for creating a system inside a worker.\n * Note: Functions cannot be serialized, so modules must be defined\n * in the worker script itself using createWorkerModule.\n */\nexport interface WorkerSystemConfig {\n  /** Module names to initialize (modules must be registered in worker) */\n  moduleNames: string[];\n  /** History configuration for snapshot-based state history */\n  history?:\n    | boolean\n    | {\n        maxSnapshots?: number;\n      };\n}\n\n// ============================================================================\n// Main Thread API\n// ============================================================================\n\n/**\n * Options for creating a worker client.\n */\nexport interface WorkerClientOptions {\n  /** The web worker instance */\n  worker: Worker;\n  /** Callback when a fact changes in the worker */\n  onFactChange?: (key: string, value: unknown, prev: unknown) => void;\n  /** Callback when a derivation changes in the worker */\n  onDerivationChange?: (key: string, value: unknown) => void;\n  /** Callback when a requirement is created */\n  onRequirementCreated?: (requirement: Requirement & { id: string }) => void;\n  /** Callback when a requirement is met */\n  onRequirementMet?: (requirementId: string, resolverId: string) => void;\n  /** Callback when an error occurs */\n  onError?: (error: string, source?: string) => void;\n}\n\n/**\n * Client for interacting with a Directive system running in a Web Worker.\n */\nexport interface WorkerClient {\n  /** Initialize the worker system */\n  init(config: WorkerSystemConfig): Promise<void>;\n  /** Start the worker system */\n  start(): Promise<void>;\n  /** Stop the worker system */\n  stop(): Promise<void>;\n  /** Destroy the worker system and terminate the worker */\n  destroy(): Promise<void>;\n  /** Set a single fact */\n  setFact(key: string, value: unknown): void;\n  /** Set multiple facts at once */\n  setFacts(facts: Record<string, unknown>): void;\n  /** Dispatch an event */\n  dispatch(event: { type: string; [key: string]: unknown }): void;\n  /** Get a distributable snapshot */\n  getSnapshot(\n    options?: DistributableSnapshotOptions,\n  ): Promise<DistributableSnapshot>;\n  /** Inspect the system state */\n  inspect(): Promise<SystemInspection>;\n  /** Wait for the system to settle */\n  settle(timeout?: number): Promise<void>;\n  /** Terminate the worker */\n  terminate(): void;\n}\n\n/**\n * Create a client for communicating with a Directive worker.\n *\n * @example\n * ```typescript\n * // main.ts\n * const worker = new Worker(new URL('./directive.worker.ts', import.meta.url));\n * const client = createWorkerClient({\n *   worker,\n *   onFactChange: (key, value) => console.log(`Fact ${key} = ${value}`),\n * });\n *\n * await client.init({ moduleNames: ['myModule'] });\n * await client.start();\n * client.setFact('userId', '123');\n * ```\n */\nexport function createWorkerClient(options: WorkerClientOptions): WorkerClient {\n  const {\n    worker,\n    onFactChange,\n    onDerivationChange,\n    onRequirementCreated,\n    onRequirementMet,\n    onError,\n  } = options;\n\n  // Pending request callbacks\n  const pendingRequests = new Map<\n    string,\n    { resolve: (value: unknown) => void; reject: (error: Error) => void }\n  >();\n  let requestIdCounter = 0;\n\n  // Promise resolvers for lifecycle events\n  let initResolve: (() => void) | null = null;\n  let startResolve: (() => void) | null = null;\n  let stopResolve: (() => void) | null = null;\n  let destroyResolve: (() => void) | null = null;\n\n  // ---- Outbound message handlers ----\n\n  function resolveLifecycle(\n    resolve: (() => void) | null,\n  ): (() => void) | null {\n    resolve?.();\n\n    return null;\n  }\n\n  function resolvePendingRequest(requestId: string, value: unknown): void {\n    const pending = pendingRequests.get(requestId);\n    if (pending) {\n      pending.resolve(value);\n      pendingRequests.delete(requestId);\n    }\n  }\n\n  function handleReady(): void {\n    initResolve = resolveLifecycle(initResolve);\n  }\n\n  function handleStarted(): void {\n    startResolve = resolveLifecycle(startResolve);\n  }\n\n  function handleStopped(): void {\n    stopResolve = resolveLifecycle(stopResolve);\n  }\n\n  function handleDestroyed(): void {\n    destroyResolve = resolveLifecycle(destroyResolve);\n  }\n\n  function handleFactChanged(message: Extract<WorkerOutboundMessage, { type: \"FACT_CHANGED\" }>): void {\n    onFactChange?.(message.key, message.value, message.prev);\n  }\n\n  function handleDerivationChanged(message: Extract<WorkerOutboundMessage, { type: \"DERIVATION_CHANGED\" }>): void {\n    onDerivationChange?.(message.key, message.value);\n  }\n\n  function handleRequirementCreated(message: Extract<WorkerOutboundMessage, { type: \"REQUIREMENT_CREATED\" }>): void {\n    onRequirementCreated?.(message.requirement);\n  }\n\n  function handleRequirementMet(message: Extract<WorkerOutboundMessage, { type: \"REQUIREMENT_MET\" }>): void {\n    onRequirementMet?.(message.requirementId, message.resolverId);\n  }\n\n  function handleError(message: Extract<WorkerOutboundMessage, { type: \"ERROR\" }>): void {\n    onError?.(message.error, message.source);\n  }\n\n  function handleSnapshotResult(message: Extract<WorkerOutboundMessage, { type: \"SNAPSHOT_RESULT\" }>): void {\n    resolvePendingRequest(message.requestId, message.snapshot);\n  }\n\n  function handleInspectResult(message: Extract<WorkerOutboundMessage, { type: \"INSPECT_RESULT\" }>): void {\n    resolvePendingRequest(message.requestId, message.inspection);\n  }\n\n  function handleSettleResult(message: Extract<WorkerOutboundMessage, { type: \"SETTLE_RESULT\" }>): void {\n    const pending = pendingRequests.get(message.requestId);\n    if (pending) {\n      if (message.success) {\n        pending.resolve(undefined);\n      } else {\n        pending.reject(new Error(message.error || \"Settle failed\"));\n      }\n      pendingRequests.delete(message.requestId);\n    }\n  }\n\n  // Handle messages from worker\n  worker.onmessage = (event: MessageEvent<WorkerOutboundMessage>) => {\n    const message = event.data;\n\n    switch (message.type) {\n      case \"READY\": return handleReady();\n      case \"STARTED\": return handleStarted();\n      case \"STOPPED\": return handleStopped();\n      case \"DESTROYED\": return handleDestroyed();\n      case \"FACT_CHANGED\": return handleFactChanged(message);\n      case \"DERIVATION_CHANGED\": return handleDerivationChanged(message);\n      case \"REQUIREMENT_CREATED\": return handleRequirementCreated(message);\n      case \"REQUIREMENT_MET\": return handleRequirementMet(message);\n      case \"ERROR\": return handleError(message);\n      case \"SNAPSHOT_RESULT\": return handleSnapshotResult(message);\n      case \"INSPECT_RESULT\": return handleInspectResult(message);\n      case \"SETTLE_RESULT\": return handleSettleResult(message);\n    }\n  };\n\n  worker.onerror = (event) => {\n    onError?.(event.message, \"worker\");\n  };\n\n  function send(message: WorkerInboundMessage): void {\n    worker.postMessage(message);\n  }\n\n  function request<T>(\n    message: WorkerInboundMessage & { requestId: string },\n  ): Promise<T> {\n    return new Promise((resolve, reject) => {\n      pendingRequests.set(message.requestId, {\n        resolve: resolve as (value: unknown) => void,\n        reject,\n      });\n      send(message);\n    });\n  }\n\n  return {\n    init(config: WorkerSystemConfig): Promise<void> {\n      return new Promise((resolve) => {\n        initResolve = resolve;\n        send({ type: \"INIT\", config });\n      });\n    },\n\n    start(): Promise<void> {\n      return new Promise((resolve) => {\n        startResolve = resolve;\n        send({ type: \"START\" });\n      });\n    },\n\n    stop(): Promise<void> {\n      return new Promise((resolve) => {\n        stopResolve = resolve;\n        send({ type: \"STOP\" });\n      });\n    },\n\n    destroy(): Promise<void> {\n      return new Promise((resolve) => {\n        destroyResolve = resolve;\n        send({ type: \"DESTROY\" });\n      });\n    },\n\n    setFact(key: string, value: unknown): void {\n      send({ type: \"SET_FACT\", key, value });\n    },\n\n    setFacts(facts: Record<string, unknown>): void {\n      send({ type: \"SET_FACTS\", facts });\n    },\n\n    dispatch(event: { type: string; [key: string]: unknown }): void {\n      send({ type: \"DISPATCH\", event });\n    },\n\n    getSnapshot(\n      options?: DistributableSnapshotOptions,\n    ): Promise<DistributableSnapshot> {\n      const requestId = `snapshot-${++requestIdCounter}`;\n      return request({ type: \"GET_SNAPSHOT\", options, requestId });\n    },\n\n    inspect(): Promise<SystemInspection> {\n      const requestId = `inspect-${++requestIdCounter}`;\n      return request({ type: \"INSPECT\", requestId });\n    },\n\n    settle(timeout?: number): Promise<void> {\n      const requestId = `settle-${++requestIdCounter}`;\n      return request({ type: \"SETTLE\", timeout, requestId });\n    },\n\n    terminate(): void {\n      worker.terminate();\n    },\n  };\n}\n\n// ============================================================================\n// Worker-Side API\n// ============================================================================\n\n/**\n * Module registration for worker-side systems.\n * Since functions can't be serialized, modules must be registered in the worker.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Module types vary\ntype ModuleRegistry = Map<string, any>;\n\nlet workerModuleRegistry: ModuleRegistry | null = null;\n\n/**\n * Get or create the module registry for worker-side modules.\n */\nexport function getWorkerModuleRegistry(): ModuleRegistry {\n  if (!workerModuleRegistry) {\n    workerModuleRegistry = new Map();\n  }\n  return workerModuleRegistry;\n}\n\n/**\n * Register a module for use in workers.\n * Call this in your worker script before handling INIT messages.\n *\n * @example\n * ```typescript\n * // directive.worker.ts\n * import { registerWorkerModule, handleWorkerMessages } from '@directive-run/core/worker';\n * import { myModule } from './modules/my-module';\n *\n * registerWorkerModule('myModule', myModule);\n * handleWorkerMessages();\n * ```\n */\n// biome-ignore lint/suspicious/noExplicitAny: Module type varies\nexport function registerWorkerModule(name: string, module: any): void {\n  getWorkerModuleRegistry().set(name, module);\n}\n\n/**\n * Handler for worker-side message processing.\n * Sets up the message listener and creates/manages the Directive system.\n *\n * @example\n * ```typescript\n * // directive.worker.ts\n * import { registerWorkerModule, handleWorkerMessages } from '@directive-run/core/worker';\n *\n * registerWorkerModule('myModule', myModule);\n * handleWorkerMessages();\n * ```\n */\nexport function handleWorkerMessages(): void {\n  // Dynamic import to avoid issues in non-worker contexts\n  // The actual system creation happens when messages are received\n  type WorkerSystem = Awaited<ReturnType<typeof createWorkerSystem>>;\n  let system: WorkerSystem | null = null;\n\n  // ---- Inbound message handlers ----\n\n  async function handleInit(\n    message: Extract<WorkerInboundMessage, { type: \"INIT\" }>,\n  ): Promise<WorkerSystem> {\n    const created = await createWorkerSystem(message.config);\n    postMessage({ type: \"READY\" } satisfies WorkerOutboundMessage);\n\n    return created;\n  }\n\n  function handleStart(sys: WorkerSystem): void {\n    sys.start();\n    postMessage({ type: \"STARTED\" } satisfies WorkerOutboundMessage);\n  }\n\n  function handleStop(sys: WorkerSystem): void {\n    sys.stop();\n    postMessage({ type: \"STOPPED\" } satisfies WorkerOutboundMessage);\n  }\n\n  function handleDestroy(sys: WorkerSystem): void {\n    sys.destroy();\n    postMessage({ type: \"DESTROYED\" } satisfies WorkerOutboundMessage);\n  }\n\n  function handleGetSnapshot(\n    sys: WorkerSystem,\n    message: Extract<WorkerInboundMessage, { type: \"GET_SNAPSHOT\" }>,\n  ): void {\n    const snapshot = sys.getSnapshot(message.options);\n    postMessage({\n      type: \"SNAPSHOT_RESULT\",\n      requestId: message.requestId,\n      snapshot,\n    } satisfies WorkerOutboundMessage);\n  }\n\n  function handleInspect(\n    sys: WorkerSystem,\n    message: Extract<WorkerInboundMessage, { type: \"INSPECT\" }>,\n  ): void {\n    const inspection = sys.inspect();\n    postMessage({\n      type: \"INSPECT_RESULT\",\n      requestId: message.requestId,\n      inspection,\n    } satisfies WorkerOutboundMessage);\n  }\n\n  async function handleSettle(\n    sys: WorkerSystem,\n    message: Extract<WorkerInboundMessage, { type: \"SETTLE\" }>,\n  ): Promise<void> {\n    try {\n      await sys.settle(message.timeout);\n      postMessage({\n        type: \"SETTLE_RESULT\",\n        requestId: message.requestId,\n        success: true,\n      } satisfies WorkerOutboundMessage);\n    } catch (error) {\n      postMessage({\n        type: \"SETTLE_RESULT\",\n        requestId: message.requestId,\n        success: false,\n        error: error instanceof Error ? error.message : String(error),\n      } satisfies WorkerOutboundMessage);\n    }\n  }\n\n  // ---- Message dispatch ----\n\n  async function dispatchMessage(\n    message: WorkerInboundMessage,\n  ): Promise<void> {\n    if (message.type === \"INIT\") {\n      system = await handleInit(message);\n\n      return;\n    }\n\n    if (!system) {\n      return;\n    }\n\n    switch (message.type) {\n      case \"START\":\n        handleStart(system);\n        break;\n      case \"STOP\":\n        handleStop(system);\n        break;\n      case \"DESTROY\":\n        handleDestroy(system);\n        system = null;\n        break;\n      case \"SET_FACT\":\n        system.setFact(message.key, message.value);\n        break;\n      case \"SET_FACTS\":\n        system.setFacts(message.facts);\n        break;\n      case \"DISPATCH\":\n        system.dispatch(message.event);\n        break;\n      case \"GET_SNAPSHOT\":\n        handleGetSnapshot(system, message);\n        break;\n      case \"INSPECT\":\n        handleInspect(system, message);\n        break;\n      case \"SETTLE\":\n        await handleSettle(system, message);\n        break;\n    }\n  }\n\n  self.onmessage = async (event: MessageEvent<WorkerInboundMessage>) => {\n    try {\n      await dispatchMessage(event.data);\n    } catch (error) {\n      postMessage({\n        type: \"ERROR\",\n        error: error instanceof Error ? error.message : String(error),\n        source: event.data.type,\n      } satisfies WorkerOutboundMessage);\n    }\n  };\n}\n\n/**\n * Internal: Create a system inside the worker.\n */\nasync function createWorkerSystem(config: WorkerSystemConfig) {\n  // Dynamically import createSystem to avoid circular dependencies\n  const { createSystem } = await import(\"../core/system.js\");\n\n  const registry = getWorkerModuleRegistry();\n  const modules: Record<string, unknown> = {};\n\n  for (const name of config.moduleNames) {\n    const module = registry.get(name);\n    if (!module) {\n      throw new Error(\n        `[Directive Worker] Module \"${name}\" not registered. ` +\n          `Call registerWorkerModule('${name}', module) before handling messages.`,\n      );\n    }\n    modules[name] = module;\n  }\n\n  // Create tracking plugin to notify main thread\n  const trackingPlugin = {\n    name: \"__worker-tracking__\",\n    onFactSet: (key: string, value: unknown, prev: unknown) => {\n      postMessage({\n        type: \"FACT_CHANGED\",\n        key,\n        value,\n        prev,\n      } satisfies WorkerOutboundMessage);\n    },\n    onDerivationCompute: (id: string, value: unknown) => {\n      postMessage({\n        type: \"DERIVATION_CHANGED\",\n        key: id,\n        value,\n      } satisfies WorkerOutboundMessage);\n    },\n    onRequirementCreated: (req: { id: string; requirement: Requirement }) => {\n      postMessage({\n        type: \"REQUIREMENT_CREATED\",\n        requirement: { ...req.requirement, id: req.id },\n      } satisfies WorkerOutboundMessage);\n    },\n    onRequirementMet: (req: { id: string }, resolverId: string) => {\n      postMessage({\n        type: \"REQUIREMENT_MET\",\n        requirementId: req.id,\n        resolverId,\n      } satisfies WorkerOutboundMessage);\n    },\n  };\n\n  const system = createSystem({\n    // biome-ignore lint/suspicious/noExplicitAny: Dynamic module types\n    modules: modules as any,\n    plugins: [trackingPlugin],\n    history: config.history,\n  });\n\n  return {\n    start: () => system.start(),\n    stop: () => system.stop(),\n    destroy: () => system.destroy(),\n    setFact: (key: string, value: unknown) => {\n      // biome-ignore lint/suspicious/noExplicitAny: Dynamic facts access\n      (system.facts as any)[key] = value;\n    },\n    setFacts: (facts: Record<string, unknown>) => {\n      // biome-ignore lint/suspicious/noExplicitAny: Dynamic facts access\n      const factsProxy = system.facts as any;\n      if (factsProxy.$store?.batch) {\n        factsProxy.$store.batch(() => {\n          for (const [key, value] of Object.entries(facts)) {\n            factsProxy[key] = value;\n          }\n        });\n      } else {\n        // Fallback: set facts one by one\n        for (const [key, value] of Object.entries(facts)) {\n          factsProxy[key] = value;\n        }\n      }\n    },\n    dispatch: (event: { type: string }) => {\n      // biome-ignore lint/suspicious/noExplicitAny: Dynamic dispatch\n      (system as any).dispatch(event);\n    },\n    getSnapshot: (options?: DistributableSnapshotOptions) => {\n      return system.getDistributableSnapshot(options);\n    },\n    inspect: () => system.inspect(),\n    settle: (timeout?: number) => system.settle(timeout),\n  };\n}\n\n// ============================================================================\n// Type Helpers\n// ============================================================================\n\n/**\n * Type helper for creating type-safe worker clients.\n * Use this to get proper typing for facts and events.\n *\n * @example\n * ```typescript\n * type MyWorkerClient = TypedWorkerClient<typeof myModuleSchema>;\n * const client = createWorkerClient(options) as MyWorkerClient;\n * client.setFact('userId', '123'); // Type-checked!\n * ```\n */\nexport type TypedWorkerClient<M extends ModuleSchema> = Omit<\n  WorkerClient,\n  \"setFact\" | \"setFacts\" | \"dispatch\"\n> & {\n  setFact<K extends keyof M[\"facts\"]>(\n    key: K,\n    value: M[\"facts\"][K] extends { _type: infer T } ? T : M[\"facts\"][K],\n  ): void;\n  setFacts(\n    facts: Partial<{\n      [K in keyof M[\"facts\"]]: M[\"facts\"][K] extends { _type: infer T }\n        ? T\n        : M[\"facts\"][K];\n    }>,\n  ): void;\n  dispatch(\n    event: M[\"events\"] extends Record<string, unknown>\n      ? {\n          [K in keyof M[\"events\"]]: { type: K } & M[\"events\"][K];\n        }[keyof M[\"events\"]]\n      : { type: string },\n  ): void;\n};\n"]}
+{"version":3,"sources":["../src/adapters/worker.ts"],"names":["createWorkerClient","options","worker","onFactChange","onDerivationChange","onRequirementCreated","onRequirementMet","onError","pendingRequests","requestIdCounter","initResolve","startResolve","stopResolve","destroyResolve","resolveLifecycle","resolve","resolvePendingRequest","requestId","value","pending","handleReady","handleStarted","handleStopped","handleDestroyed","handleFactChanged","message","handleDerivationChanged","handleRequirementCreated","handleRequirementMet","handleError","handleSnapshotResult","handleInspectResult","handleSettleResult","event","send","request","reject","config","key","facts","timeout","workerModuleRegistry","getWorkerModuleRegistry","registerWorkerModule","name","module","handleWorkerMessages","system","handleInit","created","createWorkerSystem","handleStart","sys","handleStop","handleDestroy","handleGetSnapshot","snapshot","handleInspect","inspection","handleSettle","error","dispatchMessage","createSystem","registry","modules","prev","id","req","resolverId","factsProxy"],"mappings":"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","file":"worker.js","sourcesContent":["/**\n * Web Worker Adapter - Run Directive engine off the main thread\n *\n * Features:\n * - Run computations in a dedicated worker\n * - Synchronized state between main thread and worker\n * - Automatic serialization of facts and derivations\n * - Event-based communication\n */\n\nimport type {\n  DistributableSnapshot,\n  DistributableSnapshotOptions,\n  ModuleSchema,\n  Requirement,\n  SystemInspection,\n} from \"../core/types.js\";\n\n// ============================================================================\n// Message Types\n// ============================================================================\n\n/** Messages sent from main thread to worker */\nexport type WorkerInboundMessage =\n  | { type: \"INIT\"; config: WorkerSystemConfig }\n  | { type: \"START\" }\n  | { type: \"STOP\" }\n  | { type: \"DESTROY\" }\n  | { type: \"SET_FACT\"; key: string; value: unknown }\n  | { type: \"SET_FACTS\"; facts: Record<string, unknown> }\n  | { type: \"DISPATCH\"; event: { type: string; [key: string]: unknown } }\n  | {\n      type: \"GET_SNAPSHOT\";\n      options?: DistributableSnapshotOptions;\n      requestId: string;\n    }\n  | { type: \"INSPECT\"; requestId: string }\n  | { type: \"SETTLE\"; timeout?: number; requestId: string };\n\n/** Messages sent from worker to main thread */\nexport type WorkerOutboundMessage =\n  | { type: \"READY\" }\n  | { type: \"STARTED\" }\n  | { type: \"STOPPED\" }\n  | { type: \"DESTROYED\" }\n  | { type: \"FACT_CHANGED\"; key: string; value: unknown; prev: unknown }\n  | { type: \"DERIVATION_CHANGED\"; key: string; value: unknown }\n  | { type: \"REQUIREMENT_CREATED\"; requirement: Requirement & { id: string } }\n  | { type: \"REQUIREMENT_MET\"; requirementId: string; resolverId: string }\n  | { type: \"ERROR\"; error: string; source?: string }\n  | {\n      type: \"SNAPSHOT_RESULT\";\n      requestId: string;\n      snapshot: DistributableSnapshot;\n    }\n  | { type: \"INSPECT_RESULT\"; requestId: string; inspection: SystemInspection }\n  | {\n      type: \"SETTLE_RESULT\";\n      requestId: string;\n      success: boolean;\n      error?: string;\n    };\n\n// ============================================================================\n// Worker System Config\n// ============================================================================\n\n/**\n * Configuration for creating a system inside a worker.\n * Note: Functions cannot be serialized, so modules must be defined\n * in the worker script itself using createWorkerModule.\n */\nexport interface WorkerSystemConfig {\n  /** Module names to initialize (modules must be registered in worker) */\n  moduleNames: string[];\n  /** History configuration for snapshot-based state history */\n  history?:\n    | boolean\n    | {\n        maxSnapshots?: number;\n      };\n}\n\n// ============================================================================\n// Main Thread API\n// ============================================================================\n\n/**\n * Options for creating a worker client.\n */\nexport interface WorkerClientOptions {\n  /** The web worker instance */\n  worker: Worker;\n  /** Callback when a fact changes in the worker */\n  onFactChange?: (key: string, value: unknown, prev: unknown) => void;\n  /** Callback when a derivation changes in the worker */\n  onDerivationChange?: (key: string, value: unknown) => void;\n  /** Callback when a requirement is created */\n  onRequirementCreated?: (requirement: Requirement & { id: string }) => void;\n  /** Callback when a requirement is met */\n  onRequirementMet?: (requirementId: string, resolverId: string) => void;\n  /** Callback when an error occurs */\n  onError?: (error: string, source?: string) => void;\n}\n\n/**\n * Client for interacting with a Directive system running in a Web Worker.\n */\nexport interface WorkerClient {\n  /** Initialize the worker system */\n  init(config: WorkerSystemConfig): Promise<void>;\n  /** Start the worker system */\n  start(): Promise<void>;\n  /** Stop the worker system */\n  stop(): Promise<void>;\n  /** Destroy the worker system and terminate the worker */\n  destroy(): Promise<void>;\n  /** Set a single fact */\n  setFact(key: string, value: unknown): void;\n  /** Set multiple facts at once */\n  setFacts(facts: Record<string, unknown>): void;\n  /** Dispatch an event */\n  dispatch(event: { type: string; [key: string]: unknown }): void;\n  /** Get a distributable snapshot */\n  getSnapshot(\n    options?: DistributableSnapshotOptions,\n  ): Promise<DistributableSnapshot>;\n  /** Inspect the system state */\n  inspect(): Promise<SystemInspection>;\n  /** Wait for the system to settle */\n  settle(timeout?: number): Promise<void>;\n  /** Terminate the worker */\n  terminate(): void;\n}\n\n/**\n * Create a client for communicating with a Directive worker.\n *\n * @example\n * ```typescript\n * // main.ts\n * const worker = new Worker(new URL('./directive.worker.ts', import.meta.url));\n * const client = createWorkerClient({\n *   worker,\n *   onFactChange: (key, value) => console.log(`Fact ${key} = ${value}`),\n * });\n *\n * await client.init({ moduleNames: ['myModule'] });\n * await client.start();\n * client.setFact('userId', '123');\n * ```\n */\nexport function createWorkerClient(options: WorkerClientOptions): WorkerClient {\n  const {\n    worker,\n    onFactChange,\n    onDerivationChange,\n    onRequirementCreated,\n    onRequirementMet,\n    onError,\n  } = options;\n\n  // Pending request callbacks\n  const pendingRequests = new Map<\n    string,\n    { resolve: (value: unknown) => void; reject: (error: Error) => void }\n  >();\n  let requestIdCounter = 0;\n\n  // Promise resolvers for lifecycle events\n  let initResolve: (() => void) | null = null;\n  let startResolve: (() => void) | null = null;\n  let stopResolve: (() => void) | null = null;\n  let destroyResolve: (() => void) | null = null;\n\n  // ---- Outbound message handlers ----\n\n  function resolveLifecycle(resolve: (() => void) | null): (() => void) | null {\n    resolve?.();\n\n    return null;\n  }\n\n  function resolvePendingRequest(requestId: string, value: unknown): void {\n    const pending = pendingRequests.get(requestId);\n    if (pending) {\n      pending.resolve(value);\n      pendingRequests.delete(requestId);\n    }\n  }\n\n  function handleReady(): void {\n    initResolve = resolveLifecycle(initResolve);\n  }\n\n  function handleStarted(): void {\n    startResolve = resolveLifecycle(startResolve);\n  }\n\n  function handleStopped(): void {\n    stopResolve = resolveLifecycle(stopResolve);\n  }\n\n  function handleDestroyed(): void {\n    destroyResolve = resolveLifecycle(destroyResolve);\n  }\n\n  function handleFactChanged(\n    message: Extract<WorkerOutboundMessage, { type: \"FACT_CHANGED\" }>,\n  ): void {\n    onFactChange?.(message.key, message.value, message.prev);\n  }\n\n  function handleDerivationChanged(\n    message: Extract<WorkerOutboundMessage, { type: \"DERIVATION_CHANGED\" }>,\n  ): void {\n    onDerivationChange?.(message.key, message.value);\n  }\n\n  function handleRequirementCreated(\n    message: Extract<WorkerOutboundMessage, { type: \"REQUIREMENT_CREATED\" }>,\n  ): void {\n    onRequirementCreated?.(message.requirement);\n  }\n\n  function handleRequirementMet(\n    message: Extract<WorkerOutboundMessage, { type: \"REQUIREMENT_MET\" }>,\n  ): void {\n    onRequirementMet?.(message.requirementId, message.resolverId);\n  }\n\n  function handleError(\n    message: Extract<WorkerOutboundMessage, { type: \"ERROR\" }>,\n  ): void {\n    onError?.(message.error, message.source);\n  }\n\n  function handleSnapshotResult(\n    message: Extract<WorkerOutboundMessage, { type: \"SNAPSHOT_RESULT\" }>,\n  ): void {\n    resolvePendingRequest(message.requestId, message.snapshot);\n  }\n\n  function handleInspectResult(\n    message: Extract<WorkerOutboundMessage, { type: \"INSPECT_RESULT\" }>,\n  ): void {\n    resolvePendingRequest(message.requestId, message.inspection);\n  }\n\n  function handleSettleResult(\n    message: Extract<WorkerOutboundMessage, { type: \"SETTLE_RESULT\" }>,\n  ): void {\n    const pending = pendingRequests.get(message.requestId);\n    if (pending) {\n      if (message.success) {\n        pending.resolve(undefined);\n      } else {\n        pending.reject(new Error(message.error || \"Settle failed\"));\n      }\n      pendingRequests.delete(message.requestId);\n    }\n  }\n\n  // Handle messages from worker\n  worker.onmessage = (event: MessageEvent<WorkerOutboundMessage>) => {\n    const message = event.data;\n\n    switch (message.type) {\n      case \"READY\":\n        return handleReady();\n      case \"STARTED\":\n        return handleStarted();\n      case \"STOPPED\":\n        return handleStopped();\n      case \"DESTROYED\":\n        return handleDestroyed();\n      case \"FACT_CHANGED\":\n        return handleFactChanged(message);\n      case \"DERIVATION_CHANGED\":\n        return handleDerivationChanged(message);\n      case \"REQUIREMENT_CREATED\":\n        return handleRequirementCreated(message);\n      case \"REQUIREMENT_MET\":\n        return handleRequirementMet(message);\n      case \"ERROR\":\n        return handleError(message);\n      case \"SNAPSHOT_RESULT\":\n        return handleSnapshotResult(message);\n      case \"INSPECT_RESULT\":\n        return handleInspectResult(message);\n      case \"SETTLE_RESULT\":\n        return handleSettleResult(message);\n    }\n  };\n\n  worker.onerror = (event) => {\n    onError?.(event.message, \"worker\");\n  };\n\n  function send(message: WorkerInboundMessage): void {\n    worker.postMessage(message);\n  }\n\n  function request<T>(\n    message: WorkerInboundMessage & { requestId: string },\n  ): Promise<T> {\n    return new Promise((resolve, reject) => {\n      pendingRequests.set(message.requestId, {\n        resolve: resolve as (value: unknown) => void,\n        reject,\n      });\n      send(message);\n    });\n  }\n\n  return {\n    init(config: WorkerSystemConfig): Promise<void> {\n      return new Promise((resolve) => {\n        initResolve = resolve;\n        send({ type: \"INIT\", config });\n      });\n    },\n\n    start(): Promise<void> {\n      return new Promise((resolve) => {\n        startResolve = resolve;\n        send({ type: \"START\" });\n      });\n    },\n\n    stop(): Promise<void> {\n      return new Promise((resolve) => {\n        stopResolve = resolve;\n        send({ type: \"STOP\" });\n      });\n    },\n\n    destroy(): Promise<void> {\n      return new Promise((resolve) => {\n        destroyResolve = resolve;\n        send({ type: \"DESTROY\" });\n      });\n    },\n\n    setFact(key: string, value: unknown): void {\n      send({ type: \"SET_FACT\", key, value });\n    },\n\n    setFacts(facts: Record<string, unknown>): void {\n      send({ type: \"SET_FACTS\", facts });\n    },\n\n    dispatch(event: { type: string; [key: string]: unknown }): void {\n      send({ type: \"DISPATCH\", event });\n    },\n\n    getSnapshot(\n      options?: DistributableSnapshotOptions,\n    ): Promise<DistributableSnapshot> {\n      const requestId = `snapshot-${++requestIdCounter}`;\n      return request({ type: \"GET_SNAPSHOT\", options, requestId });\n    },\n\n    inspect(): Promise<SystemInspection> {\n      const requestId = `inspect-${++requestIdCounter}`;\n      return request({ type: \"INSPECT\", requestId });\n    },\n\n    settle(timeout?: number): Promise<void> {\n      const requestId = `settle-${++requestIdCounter}`;\n      return request({ type: \"SETTLE\", timeout, requestId });\n    },\n\n    terminate(): void {\n      worker.terminate();\n    },\n  };\n}\n\n// ============================================================================\n// Worker-Side API\n// ============================================================================\n\n/**\n * Module registration for worker-side systems.\n * Since functions can't be serialized, modules must be registered in the worker.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Module types vary\ntype ModuleRegistry = Map<string, any>;\n\nlet workerModuleRegistry: ModuleRegistry | null = null;\n\n/**\n * Get or create the module registry for worker-side modules.\n */\nexport function getWorkerModuleRegistry(): ModuleRegistry {\n  if (!workerModuleRegistry) {\n    workerModuleRegistry = new Map();\n  }\n  return workerModuleRegistry;\n}\n\n/**\n * Register a module for use in workers.\n * Call this in your worker script before handling INIT messages.\n *\n * @example\n * ```typescript\n * // directive.worker.ts\n * import { registerWorkerModule, handleWorkerMessages } from '@directive-run/core/worker';\n * import { myModule } from './modules/my-module';\n *\n * registerWorkerModule('myModule', myModule);\n * handleWorkerMessages();\n * ```\n */\n// biome-ignore lint/suspicious/noExplicitAny: Module type varies\nexport function registerWorkerModule(name: string, module: any): void {\n  getWorkerModuleRegistry().set(name, module);\n}\n\n/**\n * Handler for worker-side message processing.\n * Sets up the message listener and creates/manages the Directive system.\n *\n * @example\n * ```typescript\n * // directive.worker.ts\n * import { registerWorkerModule, handleWorkerMessages } from '@directive-run/core/worker';\n *\n * registerWorkerModule('myModule', myModule);\n * handleWorkerMessages();\n * ```\n */\nexport function handleWorkerMessages(): void {\n  // Dynamic import to avoid issues in non-worker contexts\n  // The actual system creation happens when messages are received\n  type WorkerSystem = Awaited<ReturnType<typeof createWorkerSystem>>;\n  let system: WorkerSystem | null = null;\n\n  // ---- Inbound message handlers ----\n\n  async function handleInit(\n    message: Extract<WorkerInboundMessage, { type: \"INIT\" }>,\n  ): Promise<WorkerSystem> {\n    const created = await createWorkerSystem(message.config);\n    postMessage({ type: \"READY\" } satisfies WorkerOutboundMessage);\n\n    return created;\n  }\n\n  function handleStart(sys: WorkerSystem): void {\n    sys.start();\n    postMessage({ type: \"STARTED\" } satisfies WorkerOutboundMessage);\n  }\n\n  function handleStop(sys: WorkerSystem): void {\n    sys.stop();\n    postMessage({ type: \"STOPPED\" } satisfies WorkerOutboundMessage);\n  }\n\n  function handleDestroy(sys: WorkerSystem): void {\n    sys.destroy();\n    postMessage({ type: \"DESTROYED\" } satisfies WorkerOutboundMessage);\n  }\n\n  function handleGetSnapshot(\n    sys: WorkerSystem,\n    message: Extract<WorkerInboundMessage, { type: \"GET_SNAPSHOT\" }>,\n  ): void {\n    const snapshot = sys.getSnapshot(message.options);\n    postMessage({\n      type: \"SNAPSHOT_RESULT\",\n      requestId: message.requestId,\n      snapshot,\n    } satisfies WorkerOutboundMessage);\n  }\n\n  function handleInspect(\n    sys: WorkerSystem,\n    message: Extract<WorkerInboundMessage, { type: \"INSPECT\" }>,\n  ): void {\n    const inspection = sys.inspect();\n    postMessage({\n      type: \"INSPECT_RESULT\",\n      requestId: message.requestId,\n      inspection,\n    } satisfies WorkerOutboundMessage);\n  }\n\n  async function handleSettle(\n    sys: WorkerSystem,\n    message: Extract<WorkerInboundMessage, { type: \"SETTLE\" }>,\n  ): Promise<void> {\n    try {\n      await sys.settle(message.timeout);\n      postMessage({\n        type: \"SETTLE_RESULT\",\n        requestId: message.requestId,\n        success: true,\n      } satisfies WorkerOutboundMessage);\n    } catch (error) {\n      postMessage({\n        type: \"SETTLE_RESULT\",\n        requestId: message.requestId,\n        success: false,\n        error: error instanceof Error ? error.message : String(error),\n      } satisfies WorkerOutboundMessage);\n    }\n  }\n\n  // ---- Message dispatch ----\n\n  async function dispatchMessage(message: WorkerInboundMessage): Promise<void> {\n    if (message.type === \"INIT\") {\n      system = await handleInit(message);\n\n      return;\n    }\n\n    if (!system) {\n      return;\n    }\n\n    switch (message.type) {\n      case \"START\":\n        handleStart(system);\n        break;\n      case \"STOP\":\n        handleStop(system);\n        break;\n      case \"DESTROY\":\n        handleDestroy(system);\n        system = null;\n        break;\n      case \"SET_FACT\":\n        system.setFact(message.key, message.value);\n        break;\n      case \"SET_FACTS\":\n        system.setFacts(message.facts);\n        break;\n      case \"DISPATCH\":\n        system.dispatch(message.event);\n        break;\n      case \"GET_SNAPSHOT\":\n        handleGetSnapshot(system, message);\n        break;\n      case \"INSPECT\":\n        handleInspect(system, message);\n        break;\n      case \"SETTLE\":\n        await handleSettle(system, message);\n        break;\n    }\n  }\n\n  self.onmessage = async (event: MessageEvent<WorkerInboundMessage>) => {\n    try {\n      await dispatchMessage(event.data);\n    } catch (error) {\n      postMessage({\n        type: \"ERROR\",\n        error: error instanceof Error ? error.message : String(error),\n        source: event.data.type,\n      } satisfies WorkerOutboundMessage);\n    }\n  };\n}\n\n/**\n * Internal: Create a system inside the worker.\n */\nasync function createWorkerSystem(config: WorkerSystemConfig) {\n  // Dynamically import createSystem to avoid circular dependencies\n  const { createSystem } = await import(\"../core/system.js\");\n\n  const registry = getWorkerModuleRegistry();\n  const modules: Record<string, unknown> = {};\n\n  for (const name of config.moduleNames) {\n    const module = registry.get(name);\n    if (!module) {\n      throw new Error(\n        `[Directive Worker] Module \"${name}\" not registered. ` +\n          `Call registerWorkerModule('${name}', module) before handling messages.`,\n      );\n    }\n    modules[name] = module;\n  }\n\n  // Create tracking plugin to notify main thread\n  const trackingPlugin = {\n    name: \"__worker-tracking__\",\n    onFactSet: (key: string, value: unknown, prev: unknown) => {\n      postMessage({\n        type: \"FACT_CHANGED\",\n        key,\n        value,\n        prev,\n      } satisfies WorkerOutboundMessage);\n    },\n    onDerivationCompute: (id: string, value: unknown) => {\n      postMessage({\n        type: \"DERIVATION_CHANGED\",\n        key: id,\n        value,\n      } satisfies WorkerOutboundMessage);\n    },\n    onRequirementCreated: (req: { id: string; requirement: Requirement }) => {\n      postMessage({\n        type: \"REQUIREMENT_CREATED\",\n        requirement: { ...req.requirement, id: req.id },\n      } satisfies WorkerOutboundMessage);\n    },\n    onRequirementMet: (req: { id: string }, resolverId: string) => {\n      postMessage({\n        type: \"REQUIREMENT_MET\",\n        requirementId: req.id,\n        resolverId,\n      } satisfies WorkerOutboundMessage);\n    },\n  };\n\n  const system = createSystem({\n    // biome-ignore lint/suspicious/noExplicitAny: Dynamic module types\n    modules: modules as any,\n    plugins: [trackingPlugin],\n    history: config.history,\n  });\n\n  return {\n    start: () => system.start(),\n    stop: () => system.stop(),\n    destroy: () => system.destroy(),\n    setFact: (key: string, value: unknown) => {\n      // biome-ignore lint/suspicious/noExplicitAny: Dynamic facts access\n      (system.facts as any)[key] = value;\n    },\n    setFacts: (facts: Record<string, unknown>) => {\n      // biome-ignore lint/suspicious/noExplicitAny: Dynamic facts access\n      const factsProxy = system.facts as any;\n      if (factsProxy.$store?.batch) {\n        factsProxy.$store.batch(() => {\n          for (const [key, value] of Object.entries(facts)) {\n            factsProxy[key] = value;\n          }\n        });\n      } else {\n        // Fallback: set facts one by one\n        for (const [key, value] of Object.entries(facts)) {\n          factsProxy[key] = value;\n        }\n      }\n    },\n    dispatch: (event: { type: string }) => {\n      // biome-ignore lint/suspicious/noExplicitAny: Dynamic dispatch\n      (system as any).dispatch(event);\n    },\n    getSnapshot: (options?: DistributableSnapshotOptions) => {\n      return system.getDistributableSnapshot(options);\n    },\n    inspect: () => system.inspect(),\n    settle: (timeout?: number) => system.settle(timeout),\n  };\n}\n\n// ============================================================================\n// Type Helpers\n// ============================================================================\n\n/**\n * Type helper for creating type-safe worker clients.\n * Use this to get proper typing for facts and events.\n *\n * @example\n * ```typescript\n * type MyWorkerClient = TypedWorkerClient<typeof myModuleSchema>;\n * const client = createWorkerClient(options) as MyWorkerClient;\n * client.setFact('userId', '123'); // Type-checked!\n * ```\n */\nexport type TypedWorkerClient<M extends ModuleSchema> = Omit<\n  WorkerClient,\n  \"setFact\" | \"setFacts\" | \"dispatch\"\n> & {\n  setFact<K extends keyof M[\"facts\"]>(\n    key: K,\n    value: M[\"facts\"][K] extends { _type: infer T } ? T : M[\"facts\"][K],\n  ): void;\n  setFacts(\n    facts: Partial<{\n      [K in keyof M[\"facts\"]]: M[\"facts\"][K] extends { _type: infer T }\n        ? T\n        : M[\"facts\"][K];\n    }>,\n  ): void;\n  dispatch(\n    event: M[\"events\"] extends Record<string, unknown>\n      ? {\n          [K in keyof M[\"events\"]]: { type: K } & M[\"events\"][K];\n        }[keyof M[\"events\"]]\n      : { type: string },\n  ): void;\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@directive-run/core",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "imports": {
     "#is-development": {
       "production": "./src/dev-false.ts",

package/dist/chunk-4CMO5OVZ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils/utils.ts"],"names":["withTimeout","promise","ms","errorMessage","timeoutId","timeoutPromise","_","reject","stableStringify","value","maxDepth","seen","stringifyPrimitive","val","type","withCircularGuard","obj","fn","result","stringifyArray","depth","v","stringify","stringifyObject","k","primitive","isPrototypeSafe","dangerousKeys","objVal","checkArray","arr","item","check","checkObject","key","shallowEqual","a","b","keysA","keysB","hashObject","str","hash","i","isSnapshotExpired","snapshot","now","validateSnapshot","expiredAt","diffSnapshots","oldSnapshot","newSnapshot","changes","pushChange","path","oldValue","newValue","compareNullish","oldObj","newObj","compareArrays","oldArr","newArr","compare","compareObjects","oldRecord","newRecord","allKeys","childPath","versionChanged","isSignedSnapshot","signSnapshot","secret","payload","signature","hmacSha256","verifySnapshotSignature","signedSnapshot","expectedSignature","timingSafeEqual","message","secretBytes","algorithm","messageBytes","safeStringify","data","maxLen","_key"],"mappings":"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","file":"chunk-4CMO5OVZ.js","sourcesContent":["/**\n * Shared utilities for Directive\n */\n\n/**\n * Execute a promise with a timeout, properly cleaning up the timer.\n * Used by both constraints and resolvers for timeout handling.\n *\n * @param promise - The promise to wrap with a timeout\n * @param ms - Timeout duration in milliseconds\n * @param errorMessage - Error message if timeout occurs\n * @returns The promise result\n * @throws Error if timeout is exceeded\n */\nexport async function withTimeout<T>(\n  promise: Promise<T>,\n  ms: number,\n  errorMessage: string,\n): Promise<T> {\n  let timeoutId: ReturnType<typeof setTimeout>;\n\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    timeoutId = setTimeout(() => reject(new Error(errorMessage)), ms);\n  });\n\n  try {\n    return await Promise.race([promise, timeoutPromise]);\n  } finally {\n    clearTimeout(timeoutId!);\n  }\n}\n\n/**\n * Normalize an error to an Error instance.\n * Ensures consistent error handling throughout the library.\n *\n * @param error - The error to normalize (can be anything)\n * @returns An Error instance\n */\nexport function normalizeError(error: unknown): Error {\n  if (error instanceof Error) {\n    return error;\n  }\n  return new Error(String(error));\n}\n\n/**\n * Create a stable JSON string with sorted keys.\n * Handles circular references and deeply nested objects safely.\n *\n * @param value - The value to stringify\n * @param maxDepth - Maximum nesting depth (default: 50)\n * @returns A stable JSON string\n */\nexport function stableStringify(value: unknown, maxDepth = 50): string {\n  const seen = new WeakSet();\n\n  /** Stringify a primitive value (null, undefined, string, number, boolean, function, symbol). */\n  function stringifyPrimitive(val: unknown): string | undefined {\n    if (val === null) return \"null\";\n    if (val === undefined) return \"undefined\";\n\n    const type = typeof val;\n    if (type === \"string\") return JSON.stringify(val);\n    if (type === \"number\" || type === \"boolean\") return String(val);\n    if (type === \"function\") return '\"[function]\"';\n    if (type === \"symbol\") return '\"[symbol]\"';\n\n    return undefined;\n  }\n\n  /** Guard against circular references using a seen-set, then delegate to fn. */\n  function withCircularGuard(\n    obj: object,\n    fn: () => string,\n  ): string {\n    if (seen.has(obj)) {\n      return '\"[circular]\"';\n    }\n    seen.add(obj);\n    const result = fn();\n    seen.delete(obj);\n\n    return result;\n  }\n\n  /** Stringify an array with circular reference protection. */\n  function stringifyArray(val: unknown[], depth: number): string {\n    return withCircularGuard(val, () =>\n      `[${val.map((v) => stringify(v, depth + 1)).join(\",\")}]`,\n    );\n  }\n\n  /** Stringify an object with sorted keys and circular reference protection. */\n  function stringifyObject(obj: Record<string, unknown>, depth: number): string {\n    return withCircularGuard(obj, () => {\n      const keys = Object.keys(obj).sort();\n      const pairs = keys.map(\n        (k) => `${JSON.stringify(k)}:${stringify(obj[k], depth + 1)}`,\n      );\n\n      return `{${pairs.join(\",\")}}`;\n    });\n  }\n\n  /** Recursively stringify a value with depth limit and circular detection. */\n  function stringify(val: unknown, depth: number): string {\n    if (depth > maxDepth) {\n      return '\"[max depth exceeded]\"';\n    }\n\n    const primitive = stringifyPrimitive(val);\n    if (primitive !== undefined) {\n      return primitive;\n    }\n\n    if (Array.isArray(val)) {\n      return stringifyArray(val, depth);\n    }\n\n    if (typeof val === \"object\") {\n      return stringifyObject(val as Record<string, unknown>, depth);\n    }\n\n    return '\"[unknown]\"';\n  }\n\n  return stringify(value, 0);\n}\n\n/**\n * Check for prototype pollution in an object, including nested objects.\n * Returns true if the object is safe, false if dangerous keys are found.\n *\n * @param obj - The object to check\n * @param maxDepth - Maximum nesting depth to check (default: 50)\n * @returns True if safe, false if dangerous keys found\n */\nexport function isPrototypeSafe(obj: unknown, maxDepth = 50): boolean {\n  const dangerousKeys = new Set([\"__proto__\", \"constructor\", \"prototype\"]);\n  const seen = new WeakSet();\n\n  /** Guard against circular references using a seen-set, then delegate to fn. */\n  function withCircularGuard(\n    objVal: object,\n    fn: () => boolean,\n  ): boolean {\n    if (seen.has(objVal)) return true;\n    seen.add(objVal);\n    const result = fn();\n    seen.delete(objVal);\n\n    return result;\n  }\n\n  /** Check array elements for prototype pollution keys. */\n  function checkArray(arr: unknown[], depth: number): boolean {\n    for (const item of arr) {\n      if (!check(item, depth + 1)) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  /** Check object keys and values for prototype pollution. */\n  function checkObject(objVal: Record<string, unknown>, depth: number): boolean {\n    for (const key of Object.keys(objVal)) {\n      if (dangerousKeys.has(key)) {\n        return false;\n      }\n      if (!check(objVal[key], depth + 1)) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  /** Recursively check a value tree for dangerous prototype keys. */\n  function check(val: unknown, depth: number): boolean {\n    if (depth > maxDepth) return false; // Fail safe at max depth - don't assume safety\n    if (val === null || val === undefined) return true;\n    if (typeof val !== \"object\") return true;\n\n    const objVal = val as Record<string, unknown>;\n\n    if (Array.isArray(objVal)) {\n      return withCircularGuard(objVal, () => checkArray(objVal, depth));\n    }\n\n    return withCircularGuard(objVal, () => checkObject(objVal, depth));\n  }\n\n  return check(obj, 0);\n}\n\n/**\n * Shallow equality comparison for objects.\n * Used by React hooks to avoid unnecessary re-renders.\n *\n * @param a - First object\n * @param b - Second object\n * @returns True if objects are shallowly equal\n */\nexport function shallowEqual<T extends Record<string, unknown>>(\n  a: T,\n  b: T,\n): boolean {\n  if (a === b) return true;\n  if (!a || !b) return false;\n\n  const keysA = Object.keys(a);\n  const keysB = Object.keys(b);\n\n  if (keysA.length !== keysB.length) return false;\n\n  for (const key of keysA) {\n    if (a[key] !== b[key]) return false;\n  }\n\n  return true;\n}\n\n/**\n * Generate a simple hash string from an object.\n * Uses djb2 algorithm on the stable stringified value.\n *\n * **Limitations:**\n * - 32-bit hash output means collision probability increases with data set size\n *   (birthday paradox: ~50% collision chance at ~77,000 distinct values)\n * - Suitable for: cache invalidation, change detection, deduplication of small sets\n * - NOT suitable for: cryptographic use, security-sensitive operations, large-scale deduplication\n *\n * For security-sensitive use cases requiring stronger collision resistance,\n * consider using a cryptographic hash like SHA-256.\n *\n * @param value - The value to hash\n * @returns A hex hash string (8 characters, 32 bits)\n */\nexport function hashObject(value: unknown): string {\n  const str = stableStringify(value);\n  let hash = 5381;\n  for (let i = 0; i < str.length; i++) {\n    hash = ((hash << 5) + hash) ^ str.charCodeAt(i);\n  }\n  // Convert to unsigned 32-bit and then to hex\n  return (hash >>> 0).toString(16);\n}\n\n// ============================================================================\n// Distributable Snapshot Utilities\n// ============================================================================\n\n/**\n * Distributable snapshot type for type-safe helper functions.\n */\nexport interface DistributableSnapshotLike<T = Record<string, unknown>> {\n  data: T;\n  createdAt: number;\n  expiresAt?: number;\n  version?: string;\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Check if a distributable snapshot has expired.\n * Returns false if the snapshot has no expiresAt field.\n *\n * @example\n * ```typescript\n * const snapshot = system.getDistributableSnapshot({ ttlSeconds: 3600 });\n * // ... later ...\n * if (isSnapshotExpired(snapshot)) {\n *   // Refresh the snapshot\n * }\n * ```\n *\n * @param snapshot - The snapshot to check\n * @param now - Optional current timestamp (defaults to Date.now())\n * @returns True if the snapshot has expired, false otherwise\n */\nexport function isSnapshotExpired<T>(\n  snapshot: DistributableSnapshotLike<T>,\n  now: number = Date.now(),\n): boolean {\n  return snapshot.expiresAt !== undefined && now > snapshot.expiresAt;\n}\n\n/**\n * Validate a distributable snapshot and return its data.\n * Throws if the snapshot is malformed or has expired.\n *\n * @example\n * ```typescript\n * const cached = JSON.parse(await redis.get(`entitlements:${userId}`));\n * try {\n *   const data = validateSnapshot(cached);\n *   // Use data.canUseFeature, etc.\n * } catch (e) {\n *   // Snapshot invalid or expired, refresh it\n * }\n * ```\n *\n * @example Using custom timestamp for testing\n * ```typescript\n * const snapshot = { data: { test: true }, createdAt: 1000, expiresAt: 2000 };\n * validateSnapshot(snapshot, 1500); // Returns { test: true }\n * validateSnapshot(snapshot, 2500); // Throws: Snapshot expired\n * ```\n *\n * @param snapshot - The snapshot to validate\n * @param now - Optional current timestamp (defaults to Date.now())\n * @returns The snapshot data if valid\n * @throws Error if the snapshot is malformed or has expired\n */\nexport function validateSnapshot<T>(\n  snapshot: DistributableSnapshotLike<T>,\n  now: number = Date.now(),\n): T {\n  // Structural validation\n  if (!snapshot || typeof snapshot !== \"object\") {\n    throw new Error(\n      \"[Directive] Invalid snapshot: expected an object with 'data' and 'createdAt' properties.\",\n    );\n  }\n  if (!(\"data\" in snapshot)) {\n    throw new Error(\n      \"[Directive] Invalid snapshot: missing required 'data' property.\",\n    );\n  }\n  if (!(\"createdAt\" in snapshot) || typeof snapshot.createdAt !== \"number\") {\n    throw new Error(\n      \"[Directive] Invalid snapshot: missing or invalid 'createdAt' property (expected number).\",\n    );\n  }\n\n  // Expiration validation\n  if (isSnapshotExpired(snapshot, now)) {\n    const expiredAt = new Date(snapshot.expiresAt!).toISOString();\n    throw new Error(\n      `[Directive] Snapshot expired at ${expiredAt}. Obtain a fresh snapshot from the source.`,\n    );\n  }\n  return snapshot.data;\n}\n\n/**\n * Diff result for a single changed value.\n */\nexport interface SnapshotDiffEntry {\n  /** The key path that changed (e.g., \"canUseApi\" or \"limits.apiCalls\") */\n  path: string;\n  /** The value in the old snapshot */\n  oldValue: unknown;\n  /** The value in the new snapshot */\n  newValue: unknown;\n  /** Type of change: \"added\", \"removed\", or \"changed\" */\n  type: \"added\" | \"removed\" | \"changed\";\n}\n\n/**\n * Result of diffing two snapshots.\n */\nexport interface SnapshotDiff {\n  /** Whether the snapshots are identical */\n  identical: boolean;\n  /** List of changes between snapshots */\n  changes: SnapshotDiffEntry[];\n  /** Whether the version changed (if both have versions) */\n  versionChanged: boolean;\n  /** Old version (if available) */\n  oldVersion?: string;\n  /** New version (if available) */\n  newVersion?: string;\n}\n\n/**\n * Compare two distributable snapshots and return the differences.\n * Useful for debugging, audit logs, and webhook payloads.\n *\n * @example\n * ```typescript\n * const oldSnapshot = system.getDistributableSnapshot({ includeVersion: true });\n * system.dispatch({ type: \"upgradePlan\", plan: \"pro\" });\n * const newSnapshot = system.getDistributableSnapshot({ includeVersion: true });\n *\n * const diff = diffSnapshots(oldSnapshot, newSnapshot);\n * if (!diff.identical) {\n *   console.log(\"Changes:\", diff.changes);\n *   // [{ path: \"canUseApi\", oldValue: false, newValue: true, type: \"changed\" }]\n * }\n * ```\n *\n * @param oldSnapshot - The previous snapshot\n * @param newSnapshot - The new snapshot\n * @returns A diff result with all changes\n */\nexport function diffSnapshots<T = Record<string, unknown>>(\n  oldSnapshot: DistributableSnapshotLike<T>,\n  newSnapshot: DistributableSnapshotLike<T>,\n): SnapshotDiff {\n  const changes: SnapshotDiffEntry[] = [];\n\n  /** Push a change entry to the diff results. */\n  function pushChange(\n    path: string,\n    oldValue: unknown,\n    newValue: unknown,\n    type: SnapshotDiffEntry[\"type\"],\n  ): void {\n    changes.push({ path, oldValue, newValue, type });\n  }\n\n  /** Handle null/undefined comparison cases. Returns true if fully handled. */\n  function compareNullish(\n    oldObj: unknown,\n    newObj: unknown,\n    path: string,\n  ): boolean {\n    if (oldObj === null || oldObj === undefined) {\n      if (newObj !== null && newObj !== undefined) {\n        pushChange(path, oldObj, newObj, \"added\");\n      }\n\n      return true;\n    }\n    if (newObj === null || newObj === undefined) {\n      pushChange(path, oldObj, newObj, \"removed\");\n\n      return true;\n    }\n\n    return false;\n  }\n\n  /** Compare two arrays element by element, recursing into each. */\n  function compareArrays(\n    oldArr: unknown[],\n    newArr: unknown[],\n    path: string,\n  ): void {\n    if (oldArr.length !== newArr.length) {\n      pushChange(path, oldArr, newArr, \"changed\");\n\n      return;\n    }\n    for (let i = 0; i < oldArr.length; i++) {\n      compare(oldArr[i], newArr[i], `${path}[${i}]`);\n    }\n  }\n\n  /** Compare two objects by key union, detecting added/removed/changed. */\n  function compareObjects(\n    oldRecord: Record<string, unknown>,\n    newRecord: Record<string, unknown>,\n    path: string,\n  ): void {\n    const allKeys = new Set([\n      ...Object.keys(oldRecord),\n      ...Object.keys(newRecord),\n    ]);\n\n    for (const key of allKeys) {\n      const childPath = path ? `${path}.${key}` : key;\n      if (!(key in oldRecord)) {\n        pushChange(childPath, undefined, newRecord[key], \"added\");\n      } else if (!(key in newRecord)) {\n        pushChange(childPath, oldRecord[key], undefined, \"removed\");\n      } else {\n        compare(oldRecord[key], newRecord[key], childPath);\n      }\n    }\n  }\n\n  /** Recursively compare two values and record differences. */\n  function compare(oldObj: unknown, newObj: unknown, path: string): void {\n    if (compareNullish(oldObj, newObj, path)) {\n      return;\n    }\n\n    // Handle primitives\n    if (typeof oldObj !== \"object\" || typeof newObj !== \"object\") {\n      if (!Object.is(oldObj, newObj)) {\n        pushChange(path, oldObj, newObj, \"changed\");\n      }\n\n      return;\n    }\n\n    // Handle arrays\n    if (Array.isArray(oldObj) && Array.isArray(newObj)) {\n      compareArrays(oldObj, newObj, path);\n\n      return;\n    }\n\n    // Handle objects\n    compareObjects(\n      oldObj as Record<string, unknown>,\n      newObj as Record<string, unknown>,\n      path,\n    );\n  }\n\n  // Compare data\n  compare(oldSnapshot.data, newSnapshot.data, \"\");\n\n  // Check version change\n  const versionChanged =\n    oldSnapshot.version !== newSnapshot.version &&\n    (oldSnapshot.version !== undefined || newSnapshot.version !== undefined);\n\n  return {\n    identical: changes.length === 0,\n    changes,\n    versionChanged,\n    oldVersion: oldSnapshot.version,\n    newVersion: newSnapshot.version,\n  };\n}\n\n// ============================================================================\n// Snapshot Signing (HMAC)\n// ============================================================================\n\n/**\n * A signed distributable snapshot.\n * Contains the original snapshot plus a cryptographic signature.\n */\nexport interface SignedSnapshot<T = Record<string, unknown>>\n  extends DistributableSnapshotLike<T> {\n  /** HMAC-SHA256 signature in hex format */\n  signature: string;\n  /** Signing algorithm used */\n  algorithm: \"hmac-sha256\";\n}\n\n/**\n * Check if a snapshot is signed.\n *\n * @param snapshot - The snapshot to check\n * @returns True if the snapshot has a signature\n */\nexport function isSignedSnapshot<T>(\n  snapshot: DistributableSnapshotLike<T> | SignedSnapshot<T>,\n): snapshot is SignedSnapshot<T> {\n  return \"signature\" in snapshot && typeof snapshot.signature === \"string\";\n}\n\n/**\n * Sign a distributable snapshot using HMAC-SHA256.\n * Creates a tamper-proof signature that can be verified later.\n *\n * **Security Notes:**\n * - Use a cryptographically random secret of at least 32 bytes\n * - Store the secret securely (environment variable, secrets manager)\n * - Never expose the secret to clients\n * - The signature covers all snapshot fields for integrity\n *\n * @example\n * ```typescript\n * const snapshot = system.getDistributableSnapshot({\n *   includeDerivations: ['canUseFeature', 'limits'],\n *   ttlSeconds: 3600,\n * });\n *\n * // Sign the snapshot (server-side only)\n * const signed = await signSnapshot(snapshot, process.env.SNAPSHOT_SECRET);\n *\n * // Store in JWT, Redis, or send to client\n * const jwt = createJWT({ snapshot: signed });\n *\n * // Later, verify the signature\n * const isValid = await verifySnapshotSignature(signed, process.env.SNAPSHOT_SECRET);\n * if (!isValid) {\n *   throw new Error('Snapshot has been tampered with');\n * }\n * ```\n *\n * @param snapshot - The snapshot to sign\n * @param secret - The HMAC secret (string or Uint8Array)\n * @returns A signed snapshot with the signature attached\n */\nexport async function signSnapshot<T>(\n  snapshot: DistributableSnapshotLike<T>,\n  secret: string | Uint8Array,\n): Promise<SignedSnapshot<T>> {\n  // Create a canonical representation for signing\n  const payload = stableStringify({\n    data: snapshot.data,\n    createdAt: snapshot.createdAt,\n    expiresAt: snapshot.expiresAt,\n    version: snapshot.version,\n    metadata: snapshot.metadata,\n  });\n\n  const signature = await hmacSha256(payload, secret);\n\n  return {\n    ...snapshot,\n    signature,\n    algorithm: \"hmac-sha256\",\n  };\n}\n\n/**\n * Verify the signature of a signed snapshot.\n * Returns true if the signature is valid, false otherwise.\n *\n * **Important:** Always verify signatures before trusting snapshot data,\n * especially if the snapshot was received from an untrusted source (client, cache).\n *\n * @example\n * ```typescript\n * // Receive signed snapshot from client or cache\n * const snapshot = JSON.parse(cachedData);\n *\n * // Verify before using\n * const isValid = await verifySnapshotSignature(snapshot, process.env.SNAPSHOT_SECRET);\n * if (!isValid) {\n *   throw new Error('Invalid snapshot signature - possible tampering');\n * }\n *\n * // Now safe to use snapshot.data\n * if (snapshot.data.canUseFeature.api) {\n *   // Grant access\n * }\n * ```\n *\n * @param signedSnapshot - The signed snapshot to verify\n * @param secret - The HMAC secret (must match the signing secret)\n * @returns True if signature is valid, false otherwise\n */\nexport async function verifySnapshotSignature<T>(\n  signedSnapshot: SignedSnapshot<T>,\n  secret: string | Uint8Array,\n): Promise<boolean> {\n  if (!signedSnapshot.signature || signedSnapshot.algorithm !== \"hmac-sha256\") {\n    return false;\n  }\n\n  // Recreate the canonical payload (same as signing)\n  const payload = stableStringify({\n    data: signedSnapshot.data,\n    createdAt: signedSnapshot.createdAt,\n    expiresAt: signedSnapshot.expiresAt,\n    version: signedSnapshot.version,\n    metadata: signedSnapshot.metadata,\n  });\n\n  const expectedSignature = await hmacSha256(payload, secret);\n\n  // Use timing-safe comparison\n  return timingSafeEqual(signedSnapshot.signature, expectedSignature);\n}\n\n/**\n * Create HMAC-SHA256 signature of a message.\n * Uses Web Crypto API for cross-platform support (Node.js, browsers, Deno, Bun).\n */\nasync function hmacSha256(\n  message: string,\n  secret: string | Uint8Array,\n): Promise<string> {\n  // Convert secret to Uint8Array if string\n  const secretBytes: Uint8Array =\n    typeof secret === \"string\" ? new TextEncoder().encode(secret) : secret;\n\n  // Import key for HMAC\n  const algorithm: HmacImportParams = {\n    name: \"HMAC\",\n    hash: { name: \"SHA-256\" },\n  };\n  const key = await crypto.subtle.importKey(\n    \"raw\",\n    secretBytes as unknown as ArrayBuffer,\n    algorithm,\n    false,\n    [\"sign\"],\n  );\n\n  // Sign the message\n  const messageBytes = new TextEncoder().encode(message);\n  const signature = await crypto.subtle.sign(\"HMAC\", key, messageBytes);\n\n  // Convert to hex string\n  return Array.from(new Uint8Array(signature))\n    .map((b) => b.toString(16).padStart(2, \"0\"))\n    .join(\"\");\n}\n\n/**\n * Timing-safe string comparison to prevent timing attacks.\n * Both strings should be the same length (hex signatures from same algorithm).\n */\nfunction timingSafeEqual(a: string, b: string): boolean {\n  if (a.length !== b.length) {\n    return false;\n  }\n\n  let result = 0;\n  for (let i = 0; i < a.length; i++) {\n    result |= a.charCodeAt(i) ^ b.charCodeAt(i);\n  }\n  return result === 0;\n}\n\n/**\n * Safely stringify any value for display. Handles circular references,\n * BigInt, throwing toJSON, and optional truncation.\n *\n * This is the canonical implementation – all packages should import this\n * instead of maintaining local copies.\n */\nexport function safeStringify(\n  data: unknown,\n  maxLen = 500,\n): string {\n  try {\n    const str = JSON.stringify(\n      data,\n      (_key, value) => {\n        if (typeof value === \"bigint\") {\n          return `${value}n`;\n        }\n\n        return value;\n      },\n      2,\n    );\n    if (!str) {\n      return \"[undefined]\";\n    }\n    if (str.length <= maxLen) {\n      return str;\n    }\n\n    return `${str.slice(0, maxLen)}\\n... (truncated, ${str.length} chars total)`;\n  } catch {\n    return \"[unserializable]\";\n  }\n}\n"]}

package/dist/chunk-BEJ6ICA7.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils/utils.ts"],"names":["withTimeout","promise","ms","errorMessage","timeoutId","timeoutPromise","_","reject","stableStringify","value","maxDepth","seen","stringifyPrimitive","val","type","withCircularGuard","obj","fn","result","stringifyArray","depth","v","stringify","stringifyObject","k","primitive","isPrototypeSafe","dangerousKeys","objVal","checkArray","arr","item","check","checkObject","key","shallowEqual","a","b","keysA","keysB","hashObject","str","hash","i","isSnapshotExpired","snapshot","now","validateSnapshot","expiredAt","diffSnapshots","oldSnapshot","newSnapshot","changes","pushChange","path","oldValue","newValue","compareNullish","oldObj","newObj","compareArrays","oldArr","newArr","compare","compareObjects","oldRecord","newRecord","allKeys","childPath","versionChanged","isSignedSnapshot","signSnapshot","secret","payload","signature","hmacSha256","verifySnapshotSignature","signedSnapshot","expectedSignature","timingSafeEqual","message","secretBytes","algorithm","messageBytes","safeStringify","data","maxLen","_key"],"mappings":"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","file":"chunk-BEJ6ICA7.cjs","sourcesContent":["/**\n * Shared utilities for Directive\n */\n\n/**\n * Execute a promise with a timeout, properly cleaning up the timer.\n * Used by both constraints and resolvers for timeout handling.\n *\n * @param promise - The promise to wrap with a timeout\n * @param ms - Timeout duration in milliseconds\n * @param errorMessage - Error message if timeout occurs\n * @returns The promise result\n * @throws Error if timeout is exceeded\n */\nexport async function withTimeout<T>(\n  promise: Promise<T>,\n  ms: number,\n  errorMessage: string,\n): Promise<T> {\n  let timeoutId: ReturnType<typeof setTimeout>;\n\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    timeoutId = setTimeout(() => reject(new Error(errorMessage)), ms);\n  });\n\n  try {\n    return await Promise.race([promise, timeoutPromise]);\n  } finally {\n    clearTimeout(timeoutId!);\n  }\n}\n\n/**\n * Normalize an error to an Error instance.\n * Ensures consistent error handling throughout the library.\n *\n * @param error - The error to normalize (can be anything)\n * @returns An Error instance\n */\nexport function normalizeError(error: unknown): Error {\n  if (error instanceof Error) {\n    return error;\n  }\n  return new Error(String(error));\n}\n\n/**\n * Create a stable JSON string with sorted keys.\n * Handles circular references and deeply nested objects safely.\n *\n * @param value - The value to stringify\n * @param maxDepth - Maximum nesting depth (default: 50)\n * @returns A stable JSON string\n */\nexport function stableStringify(value: unknown, maxDepth = 50): string {\n  const seen = new WeakSet();\n\n  /** Stringify a primitive value (null, undefined, string, number, boolean, function, symbol). */\n  function stringifyPrimitive(val: unknown): string | undefined {\n    if (val === null) return \"null\";\n    if (val === undefined) return \"undefined\";\n\n    const type = typeof val;\n    if (type === \"string\") return JSON.stringify(val);\n    if (type === \"number\" || type === \"boolean\") return String(val);\n    if (type === \"function\") return '\"[function]\"';\n    if (type === \"symbol\") return '\"[symbol]\"';\n\n    return undefined;\n  }\n\n  /** Guard against circular references using a seen-set, then delegate to fn. */\n  function withCircularGuard(\n    obj: object,\n    fn: () => string,\n  ): string {\n    if (seen.has(obj)) {\n      return '\"[circular]\"';\n    }\n    seen.add(obj);\n    const result = fn();\n    seen.delete(obj);\n\n    return result;\n  }\n\n  /** Stringify an array with circular reference protection. */\n  function stringifyArray(val: unknown[], depth: number): string {\n    return withCircularGuard(val, () =>\n      `[${val.map((v) => stringify(v, depth + 1)).join(\",\")}]`,\n    );\n  }\n\n  /** Stringify an object with sorted keys and circular reference protection. */\n  function stringifyObject(obj: Record<string, unknown>, depth: number): string {\n    return withCircularGuard(obj, () => {\n      const keys = Object.keys(obj).sort();\n      const pairs = keys.map(\n        (k) => `${JSON.stringify(k)}:${stringify(obj[k], depth + 1)}`,\n      );\n\n      return `{${pairs.join(\",\")}}`;\n    });\n  }\n\n  /** Recursively stringify a value with depth limit and circular detection. */\n  function stringify(val: unknown, depth: number): string {\n    if (depth > maxDepth) {\n      return '\"[max depth exceeded]\"';\n    }\n\n    const primitive = stringifyPrimitive(val);\n    if (primitive !== undefined) {\n      return primitive;\n    }\n\n    if (Array.isArray(val)) {\n      return stringifyArray(val, depth);\n    }\n\n    if (typeof val === \"object\") {\n      return stringifyObject(val as Record<string, unknown>, depth);\n    }\n\n    return '\"[unknown]\"';\n  }\n\n  return stringify(value, 0);\n}\n\n/**\n * Check for prototype pollution in an object, including nested objects.\n * Returns true if the object is safe, false if dangerous keys are found.\n *\n * @param obj - The object to check\n * @param maxDepth - Maximum nesting depth to check (default: 50)\n * @returns True if safe, false if dangerous keys found\n */\nexport function isPrototypeSafe(obj: unknown, maxDepth = 50): boolean {\n  const dangerousKeys = new Set([\"__proto__\", \"constructor\", \"prototype\"]);\n  const seen = new WeakSet();\n\n  /** Guard against circular references using a seen-set, then delegate to fn. */\n  function withCircularGuard(\n    objVal: object,\n    fn: () => boolean,\n  ): boolean {\n    if (seen.has(objVal)) return true;\n    seen.add(objVal);\n    const result = fn();\n    seen.delete(objVal);\n\n    return result;\n  }\n\n  /** Check array elements for prototype pollution keys. */\n  function checkArray(arr: unknown[], depth: number): boolean {\n    for (const item of arr) {\n      if (!check(item, depth + 1)) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  /** Check object keys and values for prototype pollution. */\n  function checkObject(objVal: Record<string, unknown>, depth: number): boolean {\n    for (const key of Object.keys(objVal)) {\n      if (dangerousKeys.has(key)) {\n        return false;\n      }\n      if (!check(objVal[key], depth + 1)) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  /** Recursively check a value tree for dangerous prototype keys. */\n  function check(val: unknown, depth: number): boolean {\n    if (depth > maxDepth) return false; // Fail safe at max depth - don't assume safety\n    if (val === null || val === undefined) return true;\n    if (typeof val !== \"object\") return true;\n\n    const objVal = val as Record<string, unknown>;\n\n    if (Array.isArray(objVal)) {\n      return withCircularGuard(objVal, () => checkArray(objVal, depth));\n    }\n\n    return withCircularGuard(objVal, () => checkObject(objVal, depth));\n  }\n\n  return check(obj, 0);\n}\n\n/**\n * Shallow equality comparison for objects.\n * Used by React hooks to avoid unnecessary re-renders.\n *\n * @param a - First object\n * @param b - Second object\n * @returns True if objects are shallowly equal\n */\nexport function shallowEqual<T extends Record<string, unknown>>(\n  a: T,\n  b: T,\n): boolean {\n  if (a === b) return true;\n  if (!a || !b) return false;\n\n  const keysA = Object.keys(a);\n  const keysB = Object.keys(b);\n\n  if (keysA.length !== keysB.length) return false;\n\n  for (const key of keysA) {\n    if (a[key] !== b[key]) return false;\n  }\n\n  return true;\n}\n\n/**\n * Generate a simple hash string from an object.\n * Uses djb2 algorithm on the stable stringified value.\n *\n * **Limitations:**\n * - 32-bit hash output means collision probability increases with data set size\n *   (birthday paradox: ~50% collision chance at ~77,000 distinct values)\n * - Suitable for: cache invalidation, change detection, deduplication of small sets\n * - NOT suitable for: cryptographic use, security-sensitive operations, large-scale deduplication\n *\n * For security-sensitive use cases requiring stronger collision resistance,\n * consider using a cryptographic hash like SHA-256.\n *\n * @param value - The value to hash\n * @returns A hex hash string (8 characters, 32 bits)\n */\nexport function hashObject(value: unknown): string {\n  const str = stableStringify(value);\n  let hash = 5381;\n  for (let i = 0; i < str.length; i++) {\n    hash = ((hash << 5) + hash) ^ str.charCodeAt(i);\n  }\n  // Convert to unsigned 32-bit and then to hex\n  return (hash >>> 0).toString(16);\n}\n\n// ============================================================================\n// Distributable Snapshot Utilities\n// ============================================================================\n\n/**\n * Distributable snapshot type for type-safe helper functions.\n */\nexport interface DistributableSnapshotLike<T = Record<string, unknown>> {\n  data: T;\n  createdAt: number;\n  expiresAt?: number;\n  version?: string;\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Check if a distributable snapshot has expired.\n * Returns false if the snapshot has no expiresAt field.\n *\n * @example\n * ```typescript\n * const snapshot = system.getDistributableSnapshot({ ttlSeconds: 3600 });\n * // ... later ...\n * if (isSnapshotExpired(snapshot)) {\n *   // Refresh the snapshot\n * }\n * ```\n *\n * @param snapshot - The snapshot to check\n * @param now - Optional current timestamp (defaults to Date.now())\n * @returns True if the snapshot has expired, false otherwise\n */\nexport function isSnapshotExpired<T>(\n  snapshot: DistributableSnapshotLike<T>,\n  now: number = Date.now(),\n): boolean {\n  return snapshot.expiresAt !== undefined && now > snapshot.expiresAt;\n}\n\n/**\n * Validate a distributable snapshot and return its data.\n * Throws if the snapshot is malformed or has expired.\n *\n * @example\n * ```typescript\n * const cached = JSON.parse(await redis.get(`entitlements:${userId}`));\n * try {\n *   const data = validateSnapshot(cached);\n *   // Use data.canUseFeature, etc.\n * } catch (e) {\n *   // Snapshot invalid or expired, refresh it\n * }\n * ```\n *\n * @example Using custom timestamp for testing\n * ```typescript\n * const snapshot = { data: { test: true }, createdAt: 1000, expiresAt: 2000 };\n * validateSnapshot(snapshot, 1500); // Returns { test: true }\n * validateSnapshot(snapshot, 2500); // Throws: Snapshot expired\n * ```\n *\n * @param snapshot - The snapshot to validate\n * @param now - Optional current timestamp (defaults to Date.now())\n * @returns The snapshot data if valid\n * @throws Error if the snapshot is malformed or has expired\n */\nexport function validateSnapshot<T>(\n  snapshot: DistributableSnapshotLike<T>,\n  now: number = Date.now(),\n): T {\n  // Structural validation\n  if (!snapshot || typeof snapshot !== \"object\") {\n    throw new Error(\n      \"[Directive] Invalid snapshot: expected an object with 'data' and 'createdAt' properties.\",\n    );\n  }\n  if (!(\"data\" in snapshot)) {\n    throw new Error(\n      \"[Directive] Invalid snapshot: missing required 'data' property.\",\n    );\n  }\n  if (!(\"createdAt\" in snapshot) || typeof snapshot.createdAt !== \"number\") {\n    throw new Error(\n      \"[Directive] Invalid snapshot: missing or invalid 'createdAt' property (expected number).\",\n    );\n  }\n\n  // Expiration validation\n  if (isSnapshotExpired(snapshot, now)) {\n    const expiredAt = new Date(snapshot.expiresAt!).toISOString();\n    throw new Error(\n      `[Directive] Snapshot expired at ${expiredAt}. Obtain a fresh snapshot from the source.`,\n    );\n  }\n  return snapshot.data;\n}\n\n/**\n * Diff result for a single changed value.\n */\nexport interface SnapshotDiffEntry {\n  /** The key path that changed (e.g., \"canUseApi\" or \"limits.apiCalls\") */\n  path: string;\n  /** The value in the old snapshot */\n  oldValue: unknown;\n  /** The value in the new snapshot */\n  newValue: unknown;\n  /** Type of change: \"added\", \"removed\", or \"changed\" */\n  type: \"added\" | \"removed\" | \"changed\";\n}\n\n/**\n * Result of diffing two snapshots.\n */\nexport interface SnapshotDiff {\n  /** Whether the snapshots are identical */\n  identical: boolean;\n  /** List of changes between snapshots */\n  changes: SnapshotDiffEntry[];\n  /** Whether the version changed (if both have versions) */\n  versionChanged: boolean;\n  /** Old version (if available) */\n  oldVersion?: string;\n  /** New version (if available) */\n  newVersion?: string;\n}\n\n/**\n * Compare two distributable snapshots and return the differences.\n * Useful for debugging, audit logs, and webhook payloads.\n *\n * @example\n * ```typescript\n * const oldSnapshot = system.getDistributableSnapshot({ includeVersion: true });\n * system.dispatch({ type: \"upgradePlan\", plan: \"pro\" });\n * const newSnapshot = system.getDistributableSnapshot({ includeVersion: true });\n *\n * const diff = diffSnapshots(oldSnapshot, newSnapshot);\n * if (!diff.identical) {\n *   console.log(\"Changes:\", diff.changes);\n *   // [{ path: \"canUseApi\", oldValue: false, newValue: true, type: \"changed\" }]\n * }\n * ```\n *\n * @param oldSnapshot - The previous snapshot\n * @param newSnapshot - The new snapshot\n * @returns A diff result with all changes\n */\nexport function diffSnapshots<T = Record<string, unknown>>(\n  oldSnapshot: DistributableSnapshotLike<T>,\n  newSnapshot: DistributableSnapshotLike<T>,\n): SnapshotDiff {\n  const changes: SnapshotDiffEntry[] = [];\n\n  /** Push a change entry to the diff results. */\n  function pushChange(\n    path: string,\n    oldValue: unknown,\n    newValue: unknown,\n    type: SnapshotDiffEntry[\"type\"],\n  ): void {\n    changes.push({ path, oldValue, newValue, type });\n  }\n\n  /** Handle null/undefined comparison cases. Returns true if fully handled. */\n  function compareNullish(\n    oldObj: unknown,\n    newObj: unknown,\n    path: string,\n  ): boolean {\n    if (oldObj === null || oldObj === undefined) {\n      if (newObj !== null && newObj !== undefined) {\n        pushChange(path, oldObj, newObj, \"added\");\n      }\n\n      return true;\n    }\n    if (newObj === null || newObj === undefined) {\n      pushChange(path, oldObj, newObj, \"removed\");\n\n      return true;\n    }\n\n    return false;\n  }\n\n  /** Compare two arrays element by element, recursing into each. */\n  function compareArrays(\n    oldArr: unknown[],\n    newArr: unknown[],\n    path: string,\n  ): void {\n    if (oldArr.length !== newArr.length) {\n      pushChange(path, oldArr, newArr, \"changed\");\n\n      return;\n    }\n    for (let i = 0; i < oldArr.length; i++) {\n      compare(oldArr[i], newArr[i], `${path}[${i}]`);\n    }\n  }\n\n  /** Compare two objects by key union, detecting added/removed/changed. */\n  function compareObjects(\n    oldRecord: Record<string, unknown>,\n    newRecord: Record<string, unknown>,\n    path: string,\n  ): void {\n    const allKeys = new Set([\n      ...Object.keys(oldRecord),\n      ...Object.keys(newRecord),\n    ]);\n\n    for (const key of allKeys) {\n      const childPath = path ? `${path}.${key}` : key;\n      if (!(key in oldRecord)) {\n        pushChange(childPath, undefined, newRecord[key], \"added\");\n      } else if (!(key in newRecord)) {\n        pushChange(childPath, oldRecord[key], undefined, \"removed\");\n      } else {\n        compare(oldRecord[key], newRecord[key], childPath);\n      }\n    }\n  }\n\n  /** Recursively compare two values and record differences. */\n  function compare(oldObj: unknown, newObj: unknown, path: string): void {\n    if (compareNullish(oldObj, newObj, path)) {\n      return;\n    }\n\n    // Handle primitives\n    if (typeof oldObj !== \"object\" || typeof newObj !== \"object\") {\n      if (!Object.is(oldObj, newObj)) {\n        pushChange(path, oldObj, newObj, \"changed\");\n      }\n\n      return;\n    }\n\n    // Handle arrays\n    if (Array.isArray(oldObj) && Array.isArray(newObj)) {\n      compareArrays(oldObj, newObj, path);\n\n      return;\n    }\n\n    // Handle objects\n    compareObjects(\n      oldObj as Record<string, unknown>,\n      newObj as Record<string, unknown>,\n      path,\n    );\n  }\n\n  // Compare data\n  compare(oldSnapshot.data, newSnapshot.data, \"\");\n\n  // Check version change\n  const versionChanged =\n    oldSnapshot.version !== newSnapshot.version &&\n    (oldSnapshot.version !== undefined || newSnapshot.version !== undefined);\n\n  return {\n    identical: changes.length === 0,\n    changes,\n    versionChanged,\n    oldVersion: oldSnapshot.version,\n    newVersion: newSnapshot.version,\n  };\n}\n\n// ============================================================================\n// Snapshot Signing (HMAC)\n// ============================================================================\n\n/**\n * A signed distributable snapshot.\n * Contains the original snapshot plus a cryptographic signature.\n */\nexport interface SignedSnapshot<T = Record<string, unknown>>\n  extends DistributableSnapshotLike<T> {\n  /** HMAC-SHA256 signature in hex format */\n  signature: string;\n  /** Signing algorithm used */\n  algorithm: \"hmac-sha256\";\n}\n\n/**\n * Check if a snapshot is signed.\n *\n * @param snapshot - The snapshot to check\n * @returns True if the snapshot has a signature\n */\nexport function isSignedSnapshot<T>(\n  snapshot: DistributableSnapshotLike<T> | SignedSnapshot<T>,\n): snapshot is SignedSnapshot<T> {\n  return \"signature\" in snapshot && typeof snapshot.signature === \"string\";\n}\n\n/**\n * Sign a distributable snapshot using HMAC-SHA256.\n * Creates a tamper-proof signature that can be verified later.\n *\n * **Security Notes:**\n * - Use a cryptographically random secret of at least 32 bytes\n * - Store the secret securely (environment variable, secrets manager)\n * - Never expose the secret to clients\n * - The signature covers all snapshot fields for integrity\n *\n * @example\n * ```typescript\n * const snapshot = system.getDistributableSnapshot({\n *   includeDerivations: ['canUseFeature', 'limits'],\n *   ttlSeconds: 3600,\n * });\n *\n * // Sign the snapshot (server-side only)\n * const signed = await signSnapshot(snapshot, process.env.SNAPSHOT_SECRET);\n *\n * // Store in JWT, Redis, or send to client\n * const jwt = createJWT({ snapshot: signed });\n *\n * // Later, verify the signature\n * const isValid = await verifySnapshotSignature(signed, process.env.SNAPSHOT_SECRET);\n * if (!isValid) {\n *   throw new Error('Snapshot has been tampered with');\n * }\n * ```\n *\n * @param snapshot - The snapshot to sign\n * @param secret - The HMAC secret (string or Uint8Array)\n * @returns A signed snapshot with the signature attached\n */\nexport async function signSnapshot<T>(\n  snapshot: DistributableSnapshotLike<T>,\n  secret: string | Uint8Array,\n): Promise<SignedSnapshot<T>> {\n  // Create a canonical representation for signing\n  const payload = stableStringify({\n    data: snapshot.data,\n    createdAt: snapshot.createdAt,\n    expiresAt: snapshot.expiresAt,\n    version: snapshot.version,\n    metadata: snapshot.metadata,\n  });\n\n  const signature = await hmacSha256(payload, secret);\n\n  return {\n    ...snapshot,\n    signature,\n    algorithm: \"hmac-sha256\",\n  };\n}\n\n/**\n * Verify the signature of a signed snapshot.\n * Returns true if the signature is valid, false otherwise.\n *\n * **Important:** Always verify signatures before trusting snapshot data,\n * especially if the snapshot was received from an untrusted source (client, cache).\n *\n * @example\n * ```typescript\n * // Receive signed snapshot from client or cache\n * const snapshot = JSON.parse(cachedData);\n *\n * // Verify before using\n * const isValid = await verifySnapshotSignature(snapshot, process.env.SNAPSHOT_SECRET);\n * if (!isValid) {\n *   throw new Error('Invalid snapshot signature - possible tampering');\n * }\n *\n * // Now safe to use snapshot.data\n * if (snapshot.data.canUseFeature.api) {\n *   // Grant access\n * }\n * ```\n *\n * @param signedSnapshot - The signed snapshot to verify\n * @param secret - The HMAC secret (must match the signing secret)\n * @returns True if signature is valid, false otherwise\n */\nexport async function verifySnapshotSignature<T>(\n  signedSnapshot: SignedSnapshot<T>,\n  secret: string | Uint8Array,\n): Promise<boolean> {\n  if (!signedSnapshot.signature || signedSnapshot.algorithm !== \"hmac-sha256\") {\n    return false;\n  }\n\n  // Recreate the canonical payload (same as signing)\n  const payload = stableStringify({\n    data: signedSnapshot.data,\n    createdAt: signedSnapshot.createdAt,\n    expiresAt: signedSnapshot.expiresAt,\n    version: signedSnapshot.version,\n    metadata: signedSnapshot.metadata,\n  });\n\n  const expectedSignature = await hmacSha256(payload, secret);\n\n  // Use timing-safe comparison\n  return timingSafeEqual(signedSnapshot.signature, expectedSignature);\n}\n\n/**\n * Create HMAC-SHA256 signature of a message.\n * Uses Web Crypto API for cross-platform support (Node.js, browsers, Deno, Bun).\n */\nasync function hmacSha256(\n  message: string,\n  secret: string | Uint8Array,\n): Promise<string> {\n  // Convert secret to Uint8Array if string\n  const secretBytes: Uint8Array =\n    typeof secret === \"string\" ? new TextEncoder().encode(secret) : secret;\n\n  // Import key for HMAC\n  const algorithm: HmacImportParams = {\n    name: \"HMAC\",\n    hash: { name: \"SHA-256\" },\n  };\n  const key = await crypto.subtle.importKey(\n    \"raw\",\n    secretBytes as unknown as ArrayBuffer,\n    algorithm,\n    false,\n    [\"sign\"],\n  );\n\n  // Sign the message\n  const messageBytes = new TextEncoder().encode(message);\n  const signature = await crypto.subtle.sign(\"HMAC\", key, messageBytes);\n\n  // Convert to hex string\n  return Array.from(new Uint8Array(signature))\n    .map((b) => b.toString(16).padStart(2, \"0\"))\n    .join(\"\");\n}\n\n/**\n * Timing-safe string comparison to prevent timing attacks.\n * Both strings should be the same length (hex signatures from same algorithm).\n */\nfunction timingSafeEqual(a: string, b: string): boolean {\n  if (a.length !== b.length) {\n    return false;\n  }\n\n  let result = 0;\n  for (let i = 0; i < a.length; i++) {\n    result |= a.charCodeAt(i) ^ b.charCodeAt(i);\n  }\n  return result === 0;\n}\n\n/**\n * Safely stringify any value for display. Handles circular references,\n * BigInt, throwing toJSON, and optional truncation.\n *\n * This is the canonical implementation – all packages should import this\n * instead of maintaining local copies.\n */\nexport function safeStringify(\n  data: unknown,\n  maxLen = 500,\n): string {\n  try {\n    const str = JSON.stringify(\n      data,\n      (_key, value) => {\n        if (typeof value === \"bigint\") {\n          return `${value}n`;\n        }\n\n        return value;\n      },\n      2,\n    );\n    if (!str) {\n      return \"[undefined]\";\n    }\n    if (str.length <= maxLen) {\n      return str;\n    }\n\n    return `${str.slice(0, maxLen)}\\n... (truncated, ${str.length} chars total)`;\n  } catch {\n    return \"[unserializable]\";\n  }\n}\n"]}

package/dist/chunk-DDUARSUH.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/types/adapter-utils.ts","../src/dev-true.ts","../src/core/tracking.ts"],"names":["setBridgeFact","facts","key","value","getBridgeFact","createCallbackPlugin","name","callbacks","req","requirementGuard","type","requirementGuardMultiple","types","typeSet","dev_true_default","depStack","getCurrentDeps","len","isTracking","withTracking","fn","deps","withoutTracking","saved","ctx","trackAccess","BLOCKED_PROPS","detectNonJsonValueType","proto","nonJsonWarningCache","nonJsonHints","warnNonJsonFactAssignment","factPath","valueType","cacheKey","hint"],"mappings":"aA8FO,SAASA,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACAC,CAAAA,CACM,CACLF,CAAAA,CAAkCC,CAAG,CAAA,CAAIC,EAC5C,CAWO,SAASC,CAAAA,CAAiBH,CAAAA,CAAsBC,CAAAA,CAAgB,CACrE,OAAQD,CAAAA,CAAkCC,CAAG,CAC/C,CAyJO,SAASG,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACa,CACb,OAAO,CACL,IAAA,CAAAD,CAAAA,CACA,qBAAsBC,CAAAA,CAAU,oBAAA,CAC3BC,CAAAA,EAAQD,CAAAA,CAAU,qBAAsBC,CAAAA,CAAI,WAAW,CAAA,CACxD,MAAA,CACJ,gBAAA,CAAkBD,CAAAA,CAAU,qBAAA,CACvBC,CAAAA,EAAQD,EAAU,qBAAA,CAAuBC,CAAAA,CAAI,WAAW,CAAA,CACzD,OACJ,OAAA,CAASD,CAAAA,CAAU,OACrB,CACF,CAyCO,SAASE,CAAAA,CACdC,CAAAA,CACgC,CAChC,OAAQF,CAAAA,EAAkBA,CAAAA,CAAI,IAAA,GAASE,CACzC,CAUO,SAASC,CAAAA,CACdC,CAAAA,CACgC,CAChC,IAAMC,CAAAA,CAAU,IAAI,GAAA,CAAID,CAAK,EAC7B,OAAQJ,CAAAA,EAAkBK,CAAAA,CAAQ,GAAA,CAAIL,CAAAA,CAAI,IAAI,CAChD,KCpVOM,CAAAA,CAAQ,KCQf,IAAMC,CAAAA,CAA0B,EAAC,CAS1B,SAASC,CAAAA,EAAqC,CACnD,IAAMC,CAAAA,CAAMF,CAAAA,CAAS,MAAA,CACrB,OAAOE,IAAQ,CAAA,CAAI,IAAA,CAAOF,CAAAA,CAASE,CAAAA,CAAM,CAAC,CAC5C,CASO,SAASC,CAAAA,EAAsB,CACpC,OAAOH,CAAAA,CAAS,MAAA,CAAS,CAC3B,CAgBO,SAASI,CAAAA,CAAgBC,CAAAA,CAA8C,CAC5E,IAAMC,CAAAA,CAAO,IAAI,GAAA,CACjBN,EAAS,IAAA,CAAKM,CAAI,CAAA,CAElB,GAAI,CAEF,OAAO,CAAE,KAAA,CADKD,CAAAA,GACE,IAAA,CAAAC,CAAK,CACvB,CAAA,OAAE,CACAN,CAAAA,CAAS,GAAA,GACX,CACF,CAgBO,SAASO,CAAAA,CAAmBF,CAAAA,CAAgB,CACjD,IAAMG,CAAAA,CAAQR,CAAAA,CAAS,MAAA,CAAO,CAAA,CAAGA,EAAS,MAAM,CAAA,CAEhD,GAAI,CACF,OAAOK,CAAAA,EACT,CAAA,OAAE,CACA,IAAA,IAAWI,CAAAA,IAAOD,CAAAA,CAChBR,CAAAA,CAAS,KAAKS,CAAG,EAErB,CACF,CAYO,SAASC,CAAAA,CAAYvB,CAAAA,CAAmB,CAC7C,IAAMe,EAAMF,CAAAA,CAAS,MAAA,CACjBE,CAAAA,GAAQ,CAAA,EAGZF,EAASE,CAAAA,CAAM,CAAC,CAAA,CAAG,GAAA,CAAIf,CAAG,EAC5B,CAYO,IAAMwB,CAAAA,CAAqC,OAAO,MAAA,CACvD,IAAI,GAAA,CAAI,CAAC,WAAA,CAAa,aAAA,CAAe,WAAW,CAAC,CACnD,EAuBO,SAASC,CAAAA,CAAuBxB,CAAAA,CAA+B,CACpE,GAAIA,CAAAA,GAAU,IAAA,EAAQ,OAAOA,GAAU,QAAA,CACrC,OAAO,IAAA,CAET,GAAIA,aAAiB,IAAA,CACnB,OAAO,MAAA,CAET,GAAIA,aAAiB,GAAA,CACnB,OAAO,KAAA,CAET,GAAIA,aAAiB,GAAA,CACnB,OAAO,KAAA,CAET,GAAI,OAAO,IAAA,CAAS,GAAA,EAAeA,CAAAA,YAAiB,IAAA,CAClD,OAAO,MAAA,CAGT,GAAI,KAAA,CAAM,QAAQA,CAAK,CAAA,CACrB,OAAO,IAAA,CAMT,IAAMyB,CAAAA,CAAQ,MAAA,CAAO,cAAA,CAAezB,CAAK,EACzC,OAAIyB,CAAAA,GAAU,IAAA,EAAQA,CAAAA,GAAU,OAAO,SAAA,CAC9B,eAAA,CAGF,IACT,CASA,IAAMC,CAAAA,CAAsB,IAAI,GAAA,CAE1BC,CAAAA,CAAuC,CAC3C,IAAA,CAAM,2BAAA,CACN,GAAA,CAAK,qBAAA,CACL,IAAK,2CAAA,CACL,IAAA,CAAM,iDAAA,CACN,aAAA,CAAe,yBACjB,CAAA,CAeO,SAASC,CAAAA,CACdC,EACAC,CAAAA,CACM,CACN,IAAMC,CAAAA,CAAW,GAAGF,CAAQ,CAAA,CAAA,EAAIC,CAAS,CAAA,CAAA,CACzC,GAAIJ,CAAAA,CAAoB,GAAA,CAAIK,CAAQ,CAAA,CAClC,OAEFL,CAAAA,CAAoB,GAAA,CAAIK,CAAQ,CAAA,CAEhC,IAAMC,CAAAA,CAAOL,CAAAA,CAAaG,CAAS,CAAA,EAAK,8BACxC,OAAA,CAAQ,IAAA,CACN,CAAA,kBAAA,EAAqBD,CAAQ,gBAAgBC,CAAS,CAAA;AAAA;AAAA,EAEjDA,CAAS,CAAA;AAAA,IAAA,EACLE,CAAI,CAAA;AAAA,+CAAA,CAEf,EACF","file":"chunk-DDUARSUH.cjs","sourcesContent":["/**\n * Adapter Type Utilities - Shared types and helpers for framework adapters\n *\n * These utilities reduce type assertions in adapters by providing:\n * - Schema composition types\n * - Constraint/resolver converters\n * - Plugin factory helpers\n */\n\nimport type { Facts } from \"./facts.js\";\nimport type { Plugin } from \"./plugins.js\";\nimport type { ConstraintDef, Requirement } from \"./requirements.js\";\nimport type { ResolverContext, ResolverDef } from \"./resolvers.js\";\nimport type { InferSchema, Schema } from \"./schema.js\";\n\n// ============================================================================\n// Schema Composition Types\n// ============================================================================\n\n/**\n * Merge two schemas into one.\n * Useful for adapters that add bridge-specific facts to user schemas.\n *\n * @example\n * ```typescript\n * type BridgeFields = { __state: SchemaType<Record<string, unknown>> };\n * type Combined = MergedSchema<UserSchema, BridgeFields>;\n * ```\n */\nexport type MergedSchema<Base extends Schema, Extra extends Schema> = Base &\n  Extra;\n\n/**\n * Create a schema type from a fields definition.\n * Helper for defining adapter bridge schemas.\n *\n * @example\n * ```typescript\n * type AdapterBridgeSchema = BridgeSchema<{\n *   __adapterState: SchemaType<Record<string, unknown>>;\n * }>;\n * ```\n */\nexport type BridgeSchema<Fields extends Schema> = Fields;\n\n// ============================================================================\n// Bridge Schema Helper\n// ============================================================================\n\n/**\n * Create a bridge schema definition for adapters.\n * Returns a schema object compatible with createModule().\n *\n * @example\n * ```typescript\n * const bridgeSchema = createBridgeSchema({\n *   __state: t.object<Record<string, unknown>>(),\n * });\n * ```\n */\nexport function createBridgeSchema<S extends Schema>(schema: S): S {\n  return schema;\n}\n\n// ============================================================================\n// Type-Safe Fact Mutation\n// ============================================================================\n\n/**\n * Type-safe fact setter for known schema keys.\n * Use when you have a typed schema and want to set a specific fact.\n *\n * @example\n * ```typescript\n * setFact(facts, \"count\", 10); // Type-checked\n * ```\n */\nexport function setFact<S extends Schema, K extends keyof InferSchema<S>>(\n  facts: Facts<S>,\n  key: K,\n  value: InferSchema<S>[K],\n): void {\n  (facts as Record<string, unknown>)[key as string] = value;\n}\n\n/**\n * Set a bridge fact without strict typing.\n * Use for adapter-internal bridge fields like `__adapterState`.\n *\n * @example\n * ```typescript\n * setBridgeFact(facts, \"__adapterState\", currentState);\n * ```\n */\nexport function setBridgeFact<V>(\n  facts: Facts<Schema>,\n  key: string,\n  value: V,\n): void {\n  (facts as Record<string, unknown>)[key] = value;\n}\n\n/**\n * Get a bridge fact without strict typing.\n * Use for adapter-internal bridge fields.\n *\n * @example\n * ```typescript\n * const state = getBridgeFact<MyState>(facts, \"__adapterState\");\n * ```\n */\nexport function getBridgeFact<V>(facts: Facts<Schema>, key: string): V {\n  return (facts as Record<string, unknown>)[key] as V;\n}\n\n// ============================================================================\n// Constraint Converters\n// ============================================================================\n\n/**\n * Adapter constraint definition (generic form used by adapters).\n */\nexport interface AdapterConstraint<TState> {\n  when: (state: TState) => boolean | Promise<boolean>;\n  require: Requirement | ((state: TState) => Requirement | null);\n  priority?: number;\n}\n\n/**\n * Convert adapter-style constraints to Directive format.\n * Maps adapter constraints that work with external state (TState) to\n * Directive constraints that work with Facts<Schema>.\n *\n * @param constraints - Adapter constraints keyed by name\n * @param extractState - Function to extract adapter state from facts\n *\n * @example\n * ```typescript\n * const directiveConstraints = convertConstraints<MyState, BridgeSchema>(\n *   adapterConstraints,\n *   (facts) => getBridgeFact<MyState>(facts, \"__state\"),\n * );\n * ```\n */\nexport function convertConstraints<TState, S extends Schema>(\n  constraints: Record<string, AdapterConstraint<TState>>,\n  extractState: (facts: Facts<S>) => TState,\n): Record<string, ConstraintDef<S, Requirement>> {\n  const result: Record<string, ConstraintDef<S, Requirement>> = {};\n\n  for (const [id, constraint] of Object.entries(constraints)) {\n    result[id] = {\n      priority: constraint.priority ?? 0,\n      when: (facts) => constraint.when(extractState(facts)),\n      require: (facts) => {\n        const req =\n          typeof constraint.require === \"function\"\n            ? constraint.require(extractState(facts))\n            : constraint.require;\n        return req;\n      },\n    };\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Resolver Converters\n// ============================================================================\n\n/**\n * Adapter resolver context (generic form used by adapters).\n */\nexport interface AdapterResolverContext<TContext> {\n  context: TContext;\n  signal: AbortSignal;\n}\n\n/**\n * Adapter resolver definition (generic form used by adapters).\n */\nexport interface AdapterResolver<\n  TContext,\n  R extends Requirement = Requirement,\n> {\n  requirement: (req: Requirement) => req is R;\n  key?: (req: R) => string;\n  resolve: (\n    req: R,\n    ctx: AdapterResolverContext<TContext>,\n  ) => void | Promise<void>;\n}\n\n/**\n * Convert adapter-style resolvers to Directive format.\n * Maps adapter resolvers that work with external context (TContext) to\n * Directive resolvers that work with ResolverContext<Schema>.\n *\n * @param resolvers - Adapter resolvers keyed by name\n * @param createContext - Function to create adapter context from Directive context\n *\n * @example\n * ```typescript\n * const directiveResolvers = convertResolvers<MyContext, BridgeSchema>(\n *   adapterResolvers,\n *   (ctx) => ({\n *     getState: () => getBridgeFact<MyState>(ctx.facts, \"__state\"),\n *     setState: (update) => setBridgeFact(ctx.facts, \"__state\", update),\n *     signal: ctx.signal,\n *   }),\n * );\n * ```\n */\nexport function convertResolvers<TContext, S extends Schema>(\n  resolvers: Record<string, AdapterResolver<TContext, Requirement>>,\n  createContext: (ctx: ResolverContext<S>) => TContext,\n): Record<string, ResolverDef<S, Requirement>> {\n  const result: Record<string, ResolverDef<S, Requirement>> = {};\n\n  for (const [id, resolver] of Object.entries(resolvers)) {\n    result[id] = {\n      requirement: resolver.requirement,\n      key: resolver.key,\n      resolve: async (req, ctx) => {\n        const adapterCtx = createContext(ctx);\n        await resolver.resolve(req, {\n          context: adapterCtx,\n          signal: ctx.signal,\n        });\n      },\n    };\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Plugin Factory\n// ============================================================================\n\n/**\n * Callback definitions for adapter plugins.\n */\nexport interface AdapterCallbacks {\n  onRequirementCreated?: (req: Requirement) => void;\n  onRequirementResolved?: (req: Requirement) => void;\n  onError?: (error: Error) => void;\n}\n\n/**\n * Create a callback plugin for adapter events.\n * Wraps adapter callbacks in a Directive plugin.\n *\n * @param name - Plugin name (for debugging)\n * @param callbacks - Callback functions to invoke\n *\n * @example\n * ```typescript\n * const callbackPlugin = createCallbackPlugin(\"adapter-callbacks\", {\n *   onRequirementCreated: (req) => console.log(\"Created:\", req),\n *   onRequirementResolved: (req) => console.log(\"Resolved:\", req),\n * });\n * ```\n */\n// biome-ignore lint/suspicious/noExplicitAny: Plugins work with any schema type\nexport function createCallbackPlugin(\n  name: string,\n  callbacks: AdapterCallbacks,\n): Plugin<any> {\n  return {\n    name,\n    onRequirementCreated: callbacks.onRequirementCreated\n      ? (req) => callbacks.onRequirementCreated!(req.requirement)\n      : undefined,\n    onRequirementMet: callbacks.onRequirementResolved\n      ? (req) => callbacks.onRequirementResolved!(req.requirement)\n      : undefined,\n    onError: callbacks.onError,\n  };\n}\n\n// ============================================================================\n// Module Config Helpers\n// ============================================================================\n\n/**\n * Cast constraints to the correct type for createModule.\n * Use this when TypeScript can't infer the constraint types correctly.\n */\nexport function asConstraints<S extends Schema>(\n  constraints: Record<string, ConstraintDef<S, Requirement>>,\n): Record<string, ConstraintDef<S, Requirement>> {\n  return constraints;\n}\n\n/**\n * Cast resolvers to the correct type for createModule.\n * Use this when TypeScript can't infer the resolver types correctly.\n */\nexport function asResolvers<S extends Schema>(\n  resolvers: Record<string, ResolverDef<S, Requirement>>,\n): Record<string, ResolverDef<S, Requirement>> {\n  return resolvers;\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/**\n * Create a type guard for a specific requirement type.\n * Simplifies the common pattern of checking req.type.\n *\n * @example\n * ```typescript\n * const isResetReq = requirementGuard<ResetReq>(\"RESET\");\n * // Use in resolver:\n * { requirement: isResetReq, resolve: ... }\n * ```\n */\nexport function requirementGuard<R extends Requirement>(\n  type: R[\"type\"],\n): (req: Requirement) => req is R {\n  return (req): req is R => req.type === type;\n}\n\n/**\n * Create a type guard that matches multiple requirement types.\n *\n * @example\n * ```typescript\n * const isDataReq = requirementGuardMultiple<FetchReq | RefreshReq>([\"FETCH\", \"REFRESH\"]);\n * ```\n */\nexport function requirementGuardMultiple<R extends Requirement>(\n  types: Array<R[\"type\"]>,\n): (req: Requirement) => req is R {\n  const typeSet = new Set(types);\n  return (req): req is R => typeSet.has(req.type);\n}\n","export default true;\n","/**\n * Dependency tracking context for auto-tracking derivations\n *\n * Uses a stack-based approach to handle nested derivation computations.\n * When a derivation accesses a fact, the tracking context records it.\n */\n\n/** Stack of active dependency sets (bare Sets for zero-allocation hot path) */\nconst depStack: Set<string>[] = [];\n\n/**\n * Get the current dependency set, or null if not tracking.\n *\n * @returns The active dependency Set, or `null` if no tracking is active.\n *\n * @internal\n */\nexport function getCurrentDeps(): Set<string> | null {\n  const len = depStack.length;\n  return len === 0 ? null : depStack[len - 1]!;\n}\n\n/**\n * Check if dependency tracking is currently active.\n *\n * @returns `true` if inside a {@link withTracking} call, `false` otherwise.\n *\n * @internal\n */\nexport function isTracking(): boolean {\n  return depStack.length > 0;\n}\n\n/**\n * Run a function with dependency tracking.\n *\n * @remarks\n * Pushes a fresh Set onto the stack, executes `fn`, then pops it.\n * Any fact reads inside `fn` are recorded as dependencies.\n * Nesting is supported — inner calls get their own independent Set.\n *\n * @param fn - The function to execute under tracking.\n * @returns An object with the computed `value` and a `deps` Set of accessed\n *   fact keys.\n *\n * @internal\n */\nexport function withTracking<T>(fn: () => T): { value: T; deps: Set<string> } {\n  const deps = new Set<string>();\n  depStack.push(deps);\n\n  try {\n    const value = fn();\n    return { value, deps };\n  } finally {\n    depStack.pop();\n  }\n}\n\n/**\n * Run a function without tracking.\n *\n * @remarks\n * Temporarily clears the tracking stack so that fact reads inside `fn` do\n * not register as dependencies. The stack is restored after `fn` returns\n * (even on error). Useful for side-effect reads that should not trigger\n * derivation invalidation.\n *\n * @param fn - The function to execute without tracking.\n * @returns The return value of `fn`.\n *\n * @internal\n */\nexport function withoutTracking<T>(fn: () => T): T {\n  const saved = depStack.splice(0, depStack.length);\n\n  try {\n    return fn();\n  } finally {\n    for (const ctx of saved) {\n      depStack.push(ctx);\n    }\n  }\n}\n\n/**\n * Track a specific key in the current context.\n *\n * @remarks\n * No-op if no tracking context is active.\n *\n * @param key - The fact key to record as a dependency.\n *\n * @internal\n */\nexport function trackAccess(key: string): void {\n  const len = depStack.length;\n  if (len === 0) {\n    return;\n  }\n  depStack[len - 1]!.add(key);\n}\n\n/**\n * Prototype pollution guard — shared across all proxy handlers.\n *\n * @remarks\n * Contains `__proto__`, `constructor`, and `prototype`. Every proxy `get`\n * and `has` trap checks this set and returns `undefined` / `false` for\n * matching keys, preventing prototype pollution via proxy-based objects.\n *\n * @internal\n */\nexport const BLOCKED_PROPS: ReadonlySet<string> = Object.freeze(\n  new Set([\"__proto__\", \"constructor\", \"prototype\"]),\n);\n\n// ============================================================================\n// Non-JSON value-type detection (MIGRATION_FEEDBACK item 20)\n// ============================================================================\n\n/**\n * Detect whether `value` is a non-JSON-roundtrippable type whose mutations\n * the facts proxy cannot track for reactivity.\n *\n * Returns the kind label (`\"Date\"`, `\"Set\"`, `\"Map\"`, `\"File\"`, or\n * `\"ClassInstance\"`) when one is detected, or `null` for plain objects,\n * arrays, primitives, and `null`/`undefined`.\n *\n * The `File` check is SSR-safe: if the runtime has no `File` global the\n * branch is skipped without throwing.\n *\n * The `ClassInstance` check fires for any object whose prototype is not\n * `Object.prototype` and which is not an array — e.g. instances of user\n * classes whose mutations bypass reactivity.\n *\n * @internal\n */\nexport function detectNonJsonValueType(value: unknown): string | null {\n  if (value === null || typeof value !== \"object\") {\n    return null;\n  }\n  if (value instanceof Date) {\n    return \"Date\";\n  }\n  if (value instanceof Set) {\n    return \"Set\";\n  }\n  if (value instanceof Map) {\n    return \"Map\";\n  }\n  if (typeof File !== \"undefined\" && value instanceof File) {\n    return \"File\";\n  }\n  // Plain objects and arrays are JSON-friendly.\n  if (Array.isArray(value)) {\n    return null;\n  }\n  // Class instances: prototype is not Object.prototype.\n  // Plain `{}` literals have prototype `Object.prototype`; objects created\n  // via `Object.create(null)` have a `null` prototype which we treat as\n  // \"plain\" (it's still JSON-roundtrippable).\n  const proto = Object.getPrototypeOf(value);\n  if (proto !== null && proto !== Object.prototype) {\n    return \"ClassInstance\";\n  }\n\n  return null;\n}\n\n/**\n * Per-(path, valueType) dedupe cache — once a warning fires for a given\n * combo we never re-emit. Keeps the dev console quiet under loops that\n * assign the same Date 100 times in a row.\n *\n * @internal\n */\nconst nonJsonWarningCache = new Set<string>();\n\nconst nonJsonHints: Record<string, string> = {\n  Date: \".getTime() for timestamps\",\n  Set: \"[...set] for arrays\",\n  Map: \"Object.fromEntries(map) for plain objects\",\n  File: \"{ name, size, type, lastModified } for metadata\",\n  ClassInstance: \"a plain-object snapshot\",\n};\n\n/**\n * Emit a one-time dev-mode warning when a non-JSON value is assigned to a\n * fact. Called from the proxy `set` traps in both `createFactsProxy`\n * (single-module / standalone facts) and `createModuleFactsProxy`\n * (system-namespaced facts). No-ops in production builds — the call sites\n * are gated on `isDevelopment` so this entire helper is tree-shakable.\n *\n * @param factPath - Display path for the warning (e.g. `auth.token` or\n *   bare `token` for non-namespaced stores).\n * @param valueType - The label returned from {@link detectNonJsonValueType}.\n *\n * @internal\n */\nexport function warnNonJsonFactAssignment(\n  factPath: string,\n  valueType: string,\n): void {\n  const cacheKey = `${factPath}|${valueType}`;\n  if (nonJsonWarningCache.has(cacheKey)) {\n    return;\n  }\n  nonJsonWarningCache.add(cacheKey);\n\n  const hint = nonJsonHints[valueType] ?? \"a JSON-roundtrippable value\";\n  console.warn(\n    `[Directive] Fact \"${factPath}\" assigned a ${valueType} instance.\\n` +\n      `Facts must be JSON-roundtrippable for reactivity to work correctly.\\n` +\n      `${valueType} mutations are not tracked.\\n` +\n      `Use ${hint} instead.\\n` +\n      `See: https://directive.run/docs/facts#json-rule`,\n  );\n}\n\n/**\n * Reset the warning dedupe cache. Test-only — exported via internals for\n * vitest spec setup. Not part of the public API.\n *\n * @internal\n */\nexport function _resetNonJsonWarningCache(): void {\n  nonJsonWarningCache.clear();\n}\n"]}

package/dist/chunk-FK7BD7XT.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/types/adapter-utils.ts","../src/dev-true.ts","../src/core/tracking.ts"],"names":["setBridgeFact","facts","key","value","getBridgeFact","createCallbackPlugin","name","callbacks","req","requirementGuard","type","requirementGuardMultiple","types","typeSet","dev_true_default","depStack","getCurrentDeps","len","isTracking","withTracking","fn","deps","withoutTracking","saved","ctx","trackAccess","BLOCKED_PROPS","detectNonJsonValueType","proto","nonJsonWarningCache","nonJsonHints","warnNonJsonFactAssignment","factPath","valueType","cacheKey","hint"],"mappings":"AA8FO,SAASA,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACAC,CAAAA,CACM,CACLF,CAAAA,CAAkCC,CAAG,CAAA,CAAIC,EAC5C,CAWO,SAASC,CAAAA,CAAiBH,CAAAA,CAAsBC,CAAAA,CAAgB,CACrE,OAAQD,CAAAA,CAAkCC,CAAG,CAC/C,CAyJO,SAASG,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACa,CACb,OAAO,CACL,IAAA,CAAAD,CAAAA,CACA,qBAAsBC,CAAAA,CAAU,oBAAA,CAC3BC,CAAAA,EAAQD,CAAAA,CAAU,qBAAsBC,CAAAA,CAAI,WAAW,CAAA,CACxD,MAAA,CACJ,gBAAA,CAAkBD,CAAAA,CAAU,qBAAA,CACvBC,CAAAA,EAAQD,EAAU,qBAAA,CAAuBC,CAAAA,CAAI,WAAW,CAAA,CACzD,OACJ,OAAA,CAASD,CAAAA,CAAU,OACrB,CACF,CAyCO,SAASE,CAAAA,CACdC,CAAAA,CACgC,CAChC,OAAQF,CAAAA,EAAkBA,CAAAA,CAAI,IAAA,GAASE,CACzC,CAUO,SAASC,CAAAA,CACdC,CAAAA,CACgC,CAChC,IAAMC,CAAAA,CAAU,IAAI,GAAA,CAAID,CAAK,EAC7B,OAAQJ,CAAAA,EAAkBK,CAAAA,CAAQ,GAAA,CAAIL,CAAAA,CAAI,IAAI,CAChD,KCpVOM,CAAAA,CAAQ,KCQf,IAAMC,CAAAA,CAA0B,EAAC,CAS1B,SAASC,CAAAA,EAAqC,CACnD,IAAMC,CAAAA,CAAMF,CAAAA,CAAS,MAAA,CACrB,OAAOE,IAAQ,CAAA,CAAI,IAAA,CAAOF,CAAAA,CAASE,CAAAA,CAAM,CAAC,CAC5C,CASO,SAASC,CAAAA,EAAsB,CACpC,OAAOH,CAAAA,CAAS,MAAA,CAAS,CAC3B,CAgBO,SAASI,CAAAA,CAAgBC,CAAAA,CAA8C,CAC5E,IAAMC,CAAAA,CAAO,IAAI,GAAA,CACjBN,EAAS,IAAA,CAAKM,CAAI,CAAA,CAElB,GAAI,CAEF,OAAO,CAAE,KAAA,CADKD,CAAAA,GACE,IAAA,CAAAC,CAAK,CACvB,CAAA,OAAE,CACAN,CAAAA,CAAS,GAAA,GACX,CACF,CAgBO,SAASO,CAAAA,CAAmBF,CAAAA,CAAgB,CACjD,IAAMG,CAAAA,CAAQR,CAAAA,CAAS,MAAA,CAAO,CAAA,CAAGA,EAAS,MAAM,CAAA,CAEhD,GAAI,CACF,OAAOK,CAAAA,EACT,CAAA,OAAE,CACA,IAAA,IAAWI,CAAAA,IAAOD,CAAAA,CAChBR,CAAAA,CAAS,KAAKS,CAAG,EAErB,CACF,CAYO,SAASC,CAAAA,CAAYvB,CAAAA,CAAmB,CAC7C,IAAMe,EAAMF,CAAAA,CAAS,MAAA,CACjBE,CAAAA,GAAQ,CAAA,EAGZF,EAASE,CAAAA,CAAM,CAAC,CAAA,CAAG,GAAA,CAAIf,CAAG,EAC5B,CAYO,IAAMwB,CAAAA,CAAqC,OAAO,MAAA,CACvD,IAAI,GAAA,CAAI,CAAC,WAAA,CAAa,aAAA,CAAe,WAAW,CAAC,CACnD,EAuBO,SAASC,CAAAA,CAAuBxB,CAAAA,CAA+B,CACpE,GAAIA,CAAAA,GAAU,IAAA,EAAQ,OAAOA,GAAU,QAAA,CACrC,OAAO,IAAA,CAET,GAAIA,aAAiB,IAAA,CACnB,OAAO,MAAA,CAET,GAAIA,aAAiB,GAAA,CACnB,OAAO,KAAA,CAET,GAAIA,aAAiB,GAAA,CACnB,OAAO,KAAA,CAET,GAAI,OAAO,IAAA,CAAS,GAAA,EAAeA,CAAAA,YAAiB,IAAA,CAClD,OAAO,MAAA,CAGT,GAAI,KAAA,CAAM,QAAQA,CAAK,CAAA,CACrB,OAAO,IAAA,CAMT,IAAMyB,CAAAA,CAAQ,MAAA,CAAO,cAAA,CAAezB,CAAK,EACzC,OAAIyB,CAAAA,GAAU,IAAA,EAAQA,CAAAA,GAAU,OAAO,SAAA,CAC9B,eAAA,CAGF,IACT,CASA,IAAMC,CAAAA,CAAsB,IAAI,GAAA,CAE1BC,CAAAA,CAAuC,CAC3C,IAAA,CAAM,2BAAA,CACN,GAAA,CAAK,qBAAA,CACL,IAAK,2CAAA,CACL,IAAA,CAAM,iDAAA,CACN,aAAA,CAAe,yBACjB,CAAA,CAeO,SAASC,CAAAA,CACdC,EACAC,CAAAA,CACM,CACN,IAAMC,CAAAA,CAAW,GAAGF,CAAQ,CAAA,CAAA,EAAIC,CAAS,CAAA,CAAA,CACzC,GAAIJ,CAAAA,CAAoB,GAAA,CAAIK,CAAQ,CAAA,CAClC,OAEFL,CAAAA,CAAoB,GAAA,CAAIK,CAAQ,CAAA,CAEhC,IAAMC,CAAAA,CAAOL,CAAAA,CAAaG,CAAS,CAAA,EAAK,8BACxC,OAAA,CAAQ,IAAA,CACN,CAAA,kBAAA,EAAqBD,CAAQ,gBAAgBC,CAAS,CAAA;AAAA;AAAA,EAEjDA,CAAS,CAAA;AAAA,IAAA,EACLE,CAAI,CAAA;AAAA,+CAAA,CAEf,EACF","file":"chunk-FK7BD7XT.js","sourcesContent":["/**\n * Adapter Type Utilities - Shared types and helpers for framework adapters\n *\n * These utilities reduce type assertions in adapters by providing:\n * - Schema composition types\n * - Constraint/resolver converters\n * - Plugin factory helpers\n */\n\nimport type { Facts } from \"./facts.js\";\nimport type { Plugin } from \"./plugins.js\";\nimport type { ConstraintDef, Requirement } from \"./requirements.js\";\nimport type { ResolverContext, ResolverDef } from \"./resolvers.js\";\nimport type { InferSchema, Schema } from \"./schema.js\";\n\n// ============================================================================\n// Schema Composition Types\n// ============================================================================\n\n/**\n * Merge two schemas into one.\n * Useful for adapters that add bridge-specific facts to user schemas.\n *\n * @example\n * ```typescript\n * type BridgeFields = { __state: SchemaType<Record<string, unknown>> };\n * type Combined = MergedSchema<UserSchema, BridgeFields>;\n * ```\n */\nexport type MergedSchema<Base extends Schema, Extra extends Schema> = Base &\n  Extra;\n\n/**\n * Create a schema type from a fields definition.\n * Helper for defining adapter bridge schemas.\n *\n * @example\n * ```typescript\n * type AdapterBridgeSchema = BridgeSchema<{\n *   __adapterState: SchemaType<Record<string, unknown>>;\n * }>;\n * ```\n */\nexport type BridgeSchema<Fields extends Schema> = Fields;\n\n// ============================================================================\n// Bridge Schema Helper\n// ============================================================================\n\n/**\n * Create a bridge schema definition for adapters.\n * Returns a schema object compatible with createModule().\n *\n * @example\n * ```typescript\n * const bridgeSchema = createBridgeSchema({\n *   __state: t.object<Record<string, unknown>>(),\n * });\n * ```\n */\nexport function createBridgeSchema<S extends Schema>(schema: S): S {\n  return schema;\n}\n\n// ============================================================================\n// Type-Safe Fact Mutation\n// ============================================================================\n\n/**\n * Type-safe fact setter for known schema keys.\n * Use when you have a typed schema and want to set a specific fact.\n *\n * @example\n * ```typescript\n * setFact(facts, \"count\", 10); // Type-checked\n * ```\n */\nexport function setFact<S extends Schema, K extends keyof InferSchema<S>>(\n  facts: Facts<S>,\n  key: K,\n  value: InferSchema<S>[K],\n): void {\n  (facts as Record<string, unknown>)[key as string] = value;\n}\n\n/**\n * Set a bridge fact without strict typing.\n * Use for adapter-internal bridge fields like `__adapterState`.\n *\n * @example\n * ```typescript\n * setBridgeFact(facts, \"__adapterState\", currentState);\n * ```\n */\nexport function setBridgeFact<V>(\n  facts: Facts<Schema>,\n  key: string,\n  value: V,\n): void {\n  (facts as Record<string, unknown>)[key] = value;\n}\n\n/**\n * Get a bridge fact without strict typing.\n * Use for adapter-internal bridge fields.\n *\n * @example\n * ```typescript\n * const state = getBridgeFact<MyState>(facts, \"__adapterState\");\n * ```\n */\nexport function getBridgeFact<V>(facts: Facts<Schema>, key: string): V {\n  return (facts as Record<string, unknown>)[key] as V;\n}\n\n// ============================================================================\n// Constraint Converters\n// ============================================================================\n\n/**\n * Adapter constraint definition (generic form used by adapters).\n */\nexport interface AdapterConstraint<TState> {\n  when: (state: TState) => boolean | Promise<boolean>;\n  require: Requirement | ((state: TState) => Requirement | null);\n  priority?: number;\n}\n\n/**\n * Convert adapter-style constraints to Directive format.\n * Maps adapter constraints that work with external state (TState) to\n * Directive constraints that work with Facts<Schema>.\n *\n * @param constraints - Adapter constraints keyed by name\n * @param extractState - Function to extract adapter state from facts\n *\n * @example\n * ```typescript\n * const directiveConstraints = convertConstraints<MyState, BridgeSchema>(\n *   adapterConstraints,\n *   (facts) => getBridgeFact<MyState>(facts, \"__state\"),\n * );\n * ```\n */\nexport function convertConstraints<TState, S extends Schema>(\n  constraints: Record<string, AdapterConstraint<TState>>,\n  extractState: (facts: Facts<S>) => TState,\n): Record<string, ConstraintDef<S, Requirement>> {\n  const result: Record<string, ConstraintDef<S, Requirement>> = {};\n\n  for (const [id, constraint] of Object.entries(constraints)) {\n    result[id] = {\n      priority: constraint.priority ?? 0,\n      when: (facts) => constraint.when(extractState(facts)),\n      require: (facts) => {\n        const req =\n          typeof constraint.require === \"function\"\n            ? constraint.require(extractState(facts))\n            : constraint.require;\n        return req;\n      },\n    };\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Resolver Converters\n// ============================================================================\n\n/**\n * Adapter resolver context (generic form used by adapters).\n */\nexport interface AdapterResolverContext<TContext> {\n  context: TContext;\n  signal: AbortSignal;\n}\n\n/**\n * Adapter resolver definition (generic form used by adapters).\n */\nexport interface AdapterResolver<\n  TContext,\n  R extends Requirement = Requirement,\n> {\n  requirement: (req: Requirement) => req is R;\n  key?: (req: R) => string;\n  resolve: (\n    req: R,\n    ctx: AdapterResolverContext<TContext>,\n  ) => void | Promise<void>;\n}\n\n/**\n * Convert adapter-style resolvers to Directive format.\n * Maps adapter resolvers that work with external context (TContext) to\n * Directive resolvers that work with ResolverContext<Schema>.\n *\n * @param resolvers - Adapter resolvers keyed by name\n * @param createContext - Function to create adapter context from Directive context\n *\n * @example\n * ```typescript\n * const directiveResolvers = convertResolvers<MyContext, BridgeSchema>(\n *   adapterResolvers,\n *   (ctx) => ({\n *     getState: () => getBridgeFact<MyState>(ctx.facts, \"__state\"),\n *     setState: (update) => setBridgeFact(ctx.facts, \"__state\", update),\n *     signal: ctx.signal,\n *   }),\n * );\n * ```\n */\nexport function convertResolvers<TContext, S extends Schema>(\n  resolvers: Record<string, AdapterResolver<TContext, Requirement>>,\n  createContext: (ctx: ResolverContext<S>) => TContext,\n): Record<string, ResolverDef<S, Requirement>> {\n  const result: Record<string, ResolverDef<S, Requirement>> = {};\n\n  for (const [id, resolver] of Object.entries(resolvers)) {\n    result[id] = {\n      requirement: resolver.requirement,\n      key: resolver.key,\n      resolve: async (req, ctx) => {\n        const adapterCtx = createContext(ctx);\n        await resolver.resolve(req, {\n          context: adapterCtx,\n          signal: ctx.signal,\n        });\n      },\n    };\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Plugin Factory\n// ============================================================================\n\n/**\n * Callback definitions for adapter plugins.\n */\nexport interface AdapterCallbacks {\n  onRequirementCreated?: (req: Requirement) => void;\n  onRequirementResolved?: (req: Requirement) => void;\n  onError?: (error: Error) => void;\n}\n\n/**\n * Create a callback plugin for adapter events.\n * Wraps adapter callbacks in a Directive plugin.\n *\n * @param name - Plugin name (for debugging)\n * @param callbacks - Callback functions to invoke\n *\n * @example\n * ```typescript\n * const callbackPlugin = createCallbackPlugin(\"adapter-callbacks\", {\n *   onRequirementCreated: (req) => console.log(\"Created:\", req),\n *   onRequirementResolved: (req) => console.log(\"Resolved:\", req),\n * });\n * ```\n */\n// biome-ignore lint/suspicious/noExplicitAny: Plugins work with any schema type\nexport function createCallbackPlugin(\n  name: string,\n  callbacks: AdapterCallbacks,\n): Plugin<any> {\n  return {\n    name,\n    onRequirementCreated: callbacks.onRequirementCreated\n      ? (req) => callbacks.onRequirementCreated!(req.requirement)\n      : undefined,\n    onRequirementMet: callbacks.onRequirementResolved\n      ? (req) => callbacks.onRequirementResolved!(req.requirement)\n      : undefined,\n    onError: callbacks.onError,\n  };\n}\n\n// ============================================================================\n// Module Config Helpers\n// ============================================================================\n\n/**\n * Cast constraints to the correct type for createModule.\n * Use this when TypeScript can't infer the constraint types correctly.\n */\nexport function asConstraints<S extends Schema>(\n  constraints: Record<string, ConstraintDef<S, Requirement>>,\n): Record<string, ConstraintDef<S, Requirement>> {\n  return constraints;\n}\n\n/**\n * Cast resolvers to the correct type for createModule.\n * Use this when TypeScript can't infer the resolver types correctly.\n */\nexport function asResolvers<S extends Schema>(\n  resolvers: Record<string, ResolverDef<S, Requirement>>,\n): Record<string, ResolverDef<S, Requirement>> {\n  return resolvers;\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/**\n * Create a type guard for a specific requirement type.\n * Simplifies the common pattern of checking req.type.\n *\n * @example\n * ```typescript\n * const isResetReq = requirementGuard<ResetReq>(\"RESET\");\n * // Use in resolver:\n * { requirement: isResetReq, resolve: ... }\n * ```\n */\nexport function requirementGuard<R extends Requirement>(\n  type: R[\"type\"],\n): (req: Requirement) => req is R {\n  return (req): req is R => req.type === type;\n}\n\n/**\n * Create a type guard that matches multiple requirement types.\n *\n * @example\n * ```typescript\n * const isDataReq = requirementGuardMultiple<FetchReq | RefreshReq>([\"FETCH\", \"REFRESH\"]);\n * ```\n */\nexport function requirementGuardMultiple<R extends Requirement>(\n  types: Array<R[\"type\"]>,\n): (req: Requirement) => req is R {\n  const typeSet = new Set(types);\n  return (req): req is R => typeSet.has(req.type);\n}\n","export default true;\n","/**\n * Dependency tracking context for auto-tracking derivations\n *\n * Uses a stack-based approach to handle nested derivation computations.\n * When a derivation accesses a fact, the tracking context records it.\n */\n\n/** Stack of active dependency sets (bare Sets for zero-allocation hot path) */\nconst depStack: Set<string>[] = [];\n\n/**\n * Get the current dependency set, or null if not tracking.\n *\n * @returns The active dependency Set, or `null` if no tracking is active.\n *\n * @internal\n */\nexport function getCurrentDeps(): Set<string> | null {\n  const len = depStack.length;\n  return len === 0 ? null : depStack[len - 1]!;\n}\n\n/**\n * Check if dependency tracking is currently active.\n *\n * @returns `true` if inside a {@link withTracking} call, `false` otherwise.\n *\n * @internal\n */\nexport function isTracking(): boolean {\n  return depStack.length > 0;\n}\n\n/**\n * Run a function with dependency tracking.\n *\n * @remarks\n * Pushes a fresh Set onto the stack, executes `fn`, then pops it.\n * Any fact reads inside `fn` are recorded as dependencies.\n * Nesting is supported — inner calls get their own independent Set.\n *\n * @param fn - The function to execute under tracking.\n * @returns An object with the computed `value` and a `deps` Set of accessed\n *   fact keys.\n *\n * @internal\n */\nexport function withTracking<T>(fn: () => T): { value: T; deps: Set<string> } {\n  const deps = new Set<string>();\n  depStack.push(deps);\n\n  try {\n    const value = fn();\n    return { value, deps };\n  } finally {\n    depStack.pop();\n  }\n}\n\n/**\n * Run a function without tracking.\n *\n * @remarks\n * Temporarily clears the tracking stack so that fact reads inside `fn` do\n * not register as dependencies. The stack is restored after `fn` returns\n * (even on error). Useful for side-effect reads that should not trigger\n * derivation invalidation.\n *\n * @param fn - The function to execute without tracking.\n * @returns The return value of `fn`.\n *\n * @internal\n */\nexport function withoutTracking<T>(fn: () => T): T {\n  const saved = depStack.splice(0, depStack.length);\n\n  try {\n    return fn();\n  } finally {\n    for (const ctx of saved) {\n      depStack.push(ctx);\n    }\n  }\n}\n\n/**\n * Track a specific key in the current context.\n *\n * @remarks\n * No-op if no tracking context is active.\n *\n * @param key - The fact key to record as a dependency.\n *\n * @internal\n */\nexport function trackAccess(key: string): void {\n  const len = depStack.length;\n  if (len === 0) {\n    return;\n  }\n  depStack[len - 1]!.add(key);\n}\n\n/**\n * Prototype pollution guard — shared across all proxy handlers.\n *\n * @remarks\n * Contains `__proto__`, `constructor`, and `prototype`. Every proxy `get`\n * and `has` trap checks this set and returns `undefined` / `false` for\n * matching keys, preventing prototype pollution via proxy-based objects.\n *\n * @internal\n */\nexport const BLOCKED_PROPS: ReadonlySet<string> = Object.freeze(\n  new Set([\"__proto__\", \"constructor\", \"prototype\"]),\n);\n\n// ============================================================================\n// Non-JSON value-type detection (MIGRATION_FEEDBACK item 20)\n// ============================================================================\n\n/**\n * Detect whether `value` is a non-JSON-roundtrippable type whose mutations\n * the facts proxy cannot track for reactivity.\n *\n * Returns the kind label (`\"Date\"`, `\"Set\"`, `\"Map\"`, `\"File\"`, or\n * `\"ClassInstance\"`) when one is detected, or `null` for plain objects,\n * arrays, primitives, and `null`/`undefined`.\n *\n * The `File` check is SSR-safe: if the runtime has no `File` global the\n * branch is skipped without throwing.\n *\n * The `ClassInstance` check fires for any object whose prototype is not\n * `Object.prototype` and which is not an array — e.g. instances of user\n * classes whose mutations bypass reactivity.\n *\n * @internal\n */\nexport function detectNonJsonValueType(value: unknown): string | null {\n  if (value === null || typeof value !== \"object\") {\n    return null;\n  }\n  if (value instanceof Date) {\n    return \"Date\";\n  }\n  if (value instanceof Set) {\n    return \"Set\";\n  }\n  if (value instanceof Map) {\n    return \"Map\";\n  }\n  if (typeof File !== \"undefined\" && value instanceof File) {\n    return \"File\";\n  }\n  // Plain objects and arrays are JSON-friendly.\n  if (Array.isArray(value)) {\n    return null;\n  }\n  // Class instances: prototype is not Object.prototype.\n  // Plain `{}` literals have prototype `Object.prototype`; objects created\n  // via `Object.create(null)` have a `null` prototype which we treat as\n  // \"plain\" (it's still JSON-roundtrippable).\n  const proto = Object.getPrototypeOf(value);\n  if (proto !== null && proto !== Object.prototype) {\n    return \"ClassInstance\";\n  }\n\n  return null;\n}\n\n/**\n * Per-(path, valueType) dedupe cache — once a warning fires for a given\n * combo we never re-emit. Keeps the dev console quiet under loops that\n * assign the same Date 100 times in a row.\n *\n * @internal\n */\nconst nonJsonWarningCache = new Set<string>();\n\nconst nonJsonHints: Record<string, string> = {\n  Date: \".getTime() for timestamps\",\n  Set: \"[...set] for arrays\",\n  Map: \"Object.fromEntries(map) for plain objects\",\n  File: \"{ name, size, type, lastModified } for metadata\",\n  ClassInstance: \"a plain-object snapshot\",\n};\n\n/**\n * Emit a one-time dev-mode warning when a non-JSON value is assigned to a\n * fact. Called from the proxy `set` traps in both `createFactsProxy`\n * (single-module / standalone facts) and `createModuleFactsProxy`\n * (system-namespaced facts). No-ops in production builds — the call sites\n * are gated on `isDevelopment` so this entire helper is tree-shakable.\n *\n * @param factPath - Display path for the warning (e.g. `auth.token` or\n *   bare `token` for non-namespaced stores).\n * @param valueType - The label returned from {@link detectNonJsonValueType}.\n *\n * @internal\n */\nexport function warnNonJsonFactAssignment(\n  factPath: string,\n  valueType: string,\n): void {\n  const cacheKey = `${factPath}|${valueType}`;\n  if (nonJsonWarningCache.has(cacheKey)) {\n    return;\n  }\n  nonJsonWarningCache.add(cacheKey);\n\n  const hint = nonJsonHints[valueType] ?? \"a JSON-roundtrippable value\";\n  console.warn(\n    `[Directive] Fact \"${factPath}\" assigned a ${valueType} instance.\\n` +\n      `Facts must be JSON-roundtrippable for reactivity to work correctly.\\n` +\n      `${valueType} mutations are not tracked.\\n` +\n      `Use ${hint} instead.\\n` +\n      `See: https://directive.run/docs/facts#json-rule`,\n  );\n}\n\n/**\n * Reset the warning dedupe cache. Test-only — exported via internals for\n * vitest spec setup. Not part of the public API.\n *\n * @internal\n */\nexport function _resetNonJsonWarningCache(): void {\n  nonJsonWarningCache.clear();\n}\n"]}