akanjs 0.0.1 → 2.0.0-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (682) hide show
  1. package/CODE_OF_CONDUCT.md +54 -0
  2. package/CONTRIBUTING.md +83 -0
  3. package/LICENSE +21 -0
  4. package/README.ko.md +244 -0
  5. package/README.md +237 -6
  6. package/base/base.ts +194 -0
  7. package/base/baseEnv.ts +162 -0
  8. package/base/index.ts +6 -0
  9. package/base/primitiveRegistry.ts +342 -0
  10. package/base/symbols.ts +11 -0
  11. package/base/types.ts +137 -0
  12. package/base/utils.ts +30 -0
  13. package/cli/application/application.command.ts +213 -0
  14. package/cli/application/application.interface.tsx +225 -0
  15. package/cli/application/application.runner.ts +359 -0
  16. package/cli/application/application.script.ts +244 -0
  17. package/cli/build.ts +25 -0
  18. package/cli/cloud/cloud.command.ts +48 -0
  19. package/cli/cloud/cloud.runner.ts +158 -0
  20. package/cli/cloud/cloud.script.ts +40 -0
  21. package/cli/guideline/guideline.command.ts +31 -0
  22. package/cli/guideline/guideline.prompt.ts +212 -0
  23. package/cli/guideline/guideline.runner.ts +53 -0
  24. package/cli/guideline/guideline.script.ts +33 -0
  25. package/cli/guidelines/___library/sharedUiStructureDescription.en.md +767 -0
  26. package/cli/guidelines/___library/utilUiStructureDescription.en.md +395 -0
  27. package/cli/guidelines/___lint/lintRuleDescription.en.md +64 -0
  28. package/cli/guidelines/___module/moduleStructureDescription.en.md +80 -0
  29. package/cli/guidelines/componentRule/componentRule.generate.json +131 -0
  30. package/cli/guidelines/componentRule/componentRule.instruction.md +637 -0
  31. package/cli/guidelines/cssRule/cssRule.generate.json +93 -0
  32. package/cli/guidelines/cssRule/cssRule.instruction.md +435 -0
  33. package/cli/guidelines/databaseModule/databaseModule.generate.json +51 -0
  34. package/cli/guidelines/databaseModule/databaseModule.instruction.md +612 -0
  35. package/cli/guidelines/docPageRule/docPageRule.generate.json +72 -0
  36. package/cli/guidelines/docPageRule/docPageRule.instruction.md +389 -0
  37. package/cli/guidelines/enumConstant/enumConstant.generate.json +24 -0
  38. package/cli/guidelines/enumConstant/enumConstant.instruction.md +232 -0
  39. package/cli/guidelines/framework/framework.generate.json +119 -0
  40. package/cli/guidelines/framework/framework.instruction.md +1110 -0
  41. package/cli/guidelines/howToUseStore/howToUseStore.generate.json +0 -0
  42. package/cli/guidelines/modelConstant/modelConstant.generate.json +128 -0
  43. package/cli/guidelines/modelConstant/modelConstant.instruction.md +506 -0
  44. package/cli/guidelines/modelDictionary/modelDictionary.generate.json +108 -0
  45. package/cli/guidelines/modelDictionary/modelDictionary.instruction.md +547 -0
  46. package/cli/guidelines/modelDocument/modelDocument.generate.json +129 -0
  47. package/cli/guidelines/modelDocument/modelDocument.instruction.md +536 -0
  48. package/cli/guidelines/modelService/modelService.generate.json +135 -0
  49. package/cli/guidelines/modelService/modelService.instruction.md +708 -0
  50. package/cli/guidelines/modelSignal/modelSignal.generate.json +201 -0
  51. package/cli/guidelines/modelSignal/modelSignal.instruction.md +552 -0
  52. package/cli/guidelines/modelStore/modelStore.generate.json +130 -0
  53. package/cli/guidelines/modelStore/modelStore.instruction.md +585 -0
  54. package/cli/guidelines/modelTemplate/modelTemplate.generate.json +104 -0
  55. package/cli/guidelines/modelTemplate/modelTemplate.instruction.md +604 -0
  56. package/cli/guidelines/modelUnit/modelUnit.generate.json +92 -0
  57. package/cli/guidelines/modelUnit/modelUnit.instruction.md +541 -0
  58. package/cli/guidelines/modelUtil/modelUtil.generate.json +93 -0
  59. package/cli/guidelines/modelUtil/modelUtil.instruction.md +752 -0
  60. package/cli/guidelines/modelView/modelView.generate.json +80 -0
  61. package/cli/guidelines/modelView/modelView.instruction.md +1005 -0
  62. package/cli/guidelines/modelZone/modelZone.generate.json +126 -0
  63. package/cli/guidelines/modelZone/modelZone.instruction.md +528 -0
  64. package/cli/guidelines/scalarConstant/scalarConstant.generate.json +106 -0
  65. package/cli/guidelines/scalarConstant/scalarConstant.instruction.md +442 -0
  66. package/cli/guidelines/scalarDictionary/scalarDictionary.generate.json +83 -0
  67. package/cli/guidelines/scalarDictionary/scalarDictionary.instruction.md +273 -0
  68. package/cli/guidelines/scalarModule/scalarModule.generate.json +35 -0
  69. package/cli/guidelines/scalarModule/scalarModule.instruction.md +81 -0
  70. package/cli/guidelines/sharedUiUsage/sharedUiUsage.generate.json +108 -0
  71. package/cli/guidelines/sharedUiUsage/sharedUiUsage.instruction.md +310 -0
  72. package/cli/guidelines/utilUiUsage/utilUiUsage.generate.json +140 -0
  73. package/cli/guidelines/utilUiUsage/utilUiUsage.instruction.md +339 -0
  74. package/cli/index.js +11401 -0
  75. package/cli/index.ts +24 -0
  76. package/cli/library/library.command.ts +28 -0
  77. package/cli/library/library.runner.ts +69 -0
  78. package/cli/library/library.script.ts +39 -0
  79. package/cli/module/module.command.ts +35 -0
  80. package/cli/module/module.prompt.ts +18 -0
  81. package/cli/module/module.request.ts +319 -0
  82. package/cli/module/module.runner.ts +76 -0
  83. package/cli/module/module.script.ts +161 -0
  84. package/cli/package/package.command.ts +32 -0
  85. package/cli/package/package.runner.ts +64 -0
  86. package/cli/package/package.script.ts +35 -0
  87. package/cli/page/page.command.ts +14 -0
  88. package/cli/page/page.runner.ts +14 -0
  89. package/cli/page/page.script.ts +12 -0
  90. package/cli/scalar/scalar.command.ts +21 -0
  91. package/cli/scalar/scalar.prompt.ts +131 -0
  92. package/cli/scalar/scalar.runner.ts +38 -0
  93. package/cli/scalar/scalar.script.ts +16 -0
  94. package/cli/templates/__scalar/__model__/__model__.constant.ts +15 -0
  95. package/cli/templates/__scalar/__model__/__model__.dictionary.ts +19 -0
  96. package/cli/templates/__scalar/__model__/__model__.document.ts +15 -0
  97. package/cli/templates/app/akan.config.ts +14 -0
  98. package/cli/templates/app/capacitor.config.ts.template +8 -0
  99. package/cli/templates/app/common/commonLogic.ts +12 -0
  100. package/cli/templates/app/common/index.ts +10 -0
  101. package/cli/templates/app/env/env.client.debug.ts.template +7 -0
  102. package/cli/templates/app/env/env.client.develop.ts.template +7 -0
  103. package/cli/templates/app/env/env.client.local.ts.template +7 -0
  104. package/cli/templates/app/env/env.client.main.ts.template +7 -0
  105. package/cli/templates/app/env/env.client.testing.ts.template +7 -0
  106. package/cli/templates/app/env/env.client.ts +21 -0
  107. package/cli/templates/app/env/env.client.type.ts +16 -0
  108. package/cli/templates/app/env/env.server.debug.ts.template +7 -0
  109. package/cli/templates/app/env/env.server.develop.ts.template +9 -0
  110. package/cli/templates/app/env/env.server.local.ts.template +14 -0
  111. package/cli/templates/app/env/env.server.main.ts.template +9 -0
  112. package/cli/templates/app/env/env.server.testing.ts.template +6 -0
  113. package/cli/templates/app/env/env.server.ts +20 -0
  114. package/cli/templates/app/lib/___appName__/__appName__.dictionary.ts +17 -0
  115. package/cli/templates/app/lib/___appName__/__appName__.service.ts +13 -0
  116. package/cli/templates/app/lib/___appName__/__appName__.signal.ts +17 -0
  117. package/cli/templates/app/lib/___appName__/__appName__.store.ts +15 -0
  118. package/cli/templates/app/lib/option.ts +17 -0
  119. package/cli/templates/app/main.ts +16 -0
  120. package/cli/templates/app/package.json.template +5 -0
  121. package/cli/templates/app/page/_index.tsx +172 -0
  122. package/cli/templates/app/page/_layout.tsx +32 -0
  123. package/cli/templates/app/page/styles.css.template +53 -0
  124. package/cli/templates/app/public/favicon.ico +0 -0
  125. package/cli/templates/app/public/logo.png +0 -0
  126. package/cli/templates/app/srvkit/backendLogic.ts +12 -0
  127. package/cli/templates/app/srvkit/index.ts +10 -0
  128. package/cli/templates/app/tsconfig.json.template +21 -0
  129. package/cli/templates/app/ui/UiComponent.ts +16 -0
  130. package/cli/templates/app/ui/index.ts +10 -0
  131. package/cli/templates/app/webkit/frontendLogic.ts +12 -0
  132. package/cli/templates/app/webkit/index.ts +10 -0
  133. package/cli/templates/client.ts +46 -0
  134. package/cli/templates/crudPages/[__model__Id]/edit/page.tsx +47 -0
  135. package/cli/templates/crudPages/[__model__Id]/page.tsx +52 -0
  136. package/cli/templates/crudPages/new/page.tsx +42 -0
  137. package/cli/templates/crudPages/page.tsx +43 -0
  138. package/cli/templates/crudSinglePage/page.tsx +37 -0
  139. package/cli/templates/env/_env.server.type.ts +16 -0
  140. package/cli/templates/facetIndex/index.ts +32 -0
  141. package/cli/templates/index.ts +10 -0
  142. package/cli/templates/lib/__lib/lib.constant.ts +38 -0
  143. package/cli/templates/lib/__lib/lib.dictionary.ts +33 -0
  144. package/cli/templates/lib/__lib/lib.document.ts +35 -0
  145. package/cli/templates/lib/__lib/lib.service.ts +33 -0
  146. package/cli/templates/lib/__lib/lib.signal.ts +34 -0
  147. package/cli/templates/lib/__lib/lib.store.ts +33 -0
  148. package/cli/templates/lib/cnst.ts +29 -0
  149. package/cli/templates/lib/db.ts +32 -0
  150. package/cli/templates/lib/dict.ts +49 -0
  151. package/cli/templates/lib/sig.ts +60 -0
  152. package/cli/templates/lib/srv.ts +34 -0
  153. package/cli/templates/lib/st.ts +31 -0
  154. package/cli/templates/lib/useClient.ts +19 -0
  155. package/cli/templates/lib/useServer.ts +7 -0
  156. package/cli/templates/libRoot/.gitignore.template +16 -0
  157. package/cli/templates/libRoot/akan.config.ts +12 -0
  158. package/cli/templates/libRoot/base/baseLogic.ts +10 -0
  159. package/cli/templates/libRoot/base/index.ts +8 -0
  160. package/cli/templates/libRoot/common/commonLogic.ts +10 -0
  161. package/cli/templates/libRoot/common/index.ts +8 -0
  162. package/cli/templates/libRoot/env/env.server.example.ts.template +6 -0
  163. package/cli/templates/libRoot/env/env.server.testing.ts.template +6 -0
  164. package/cli/templates/libRoot/lib/___libName__/__libName__.dictionary.ts +15 -0
  165. package/cli/templates/libRoot/lib/___libName__/__libName__.service.ts +11 -0
  166. package/cli/templates/libRoot/lib/___libName__/__libName__.store.ts +13 -0
  167. package/cli/templates/libRoot/lib/option.ts +17 -0
  168. package/cli/templates/libRoot/package.json.template +5 -0
  169. package/cli/templates/libRoot/srvkit/backendLogic.ts +10 -0
  170. package/cli/templates/libRoot/srvkit/index.ts +8 -0
  171. package/cli/templates/libRoot/tsconfig.json.template +11 -0
  172. package/cli/templates/libRoot/ui/index.ts +7 -0
  173. package/cli/templates/libRoot/webkit/frontendLogic.ts +10 -0
  174. package/cli/templates/libRoot/webkit/index.ts +8 -0
  175. package/cli/templates/localDev/docker-compose.yaml.template +37 -0
  176. package/cli/templates/module/__Model__.Template.tsx +36 -0
  177. package/cli/templates/module/__Model__.Unit.tsx +26 -0
  178. package/cli/templates/module/__Model__.Util.tsx +30 -0
  179. package/cli/templates/module/__Model__.View.tsx +29 -0
  180. package/cli/templates/module/__Model__.Zone.tsx +43 -0
  181. package/cli/templates/module/__model__.constant.ts +24 -0
  182. package/cli/templates/module/__model__.dictionary.ts +30 -0
  183. package/cli/templates/module/__model__.document.ts +23 -0
  184. package/cli/templates/module/__model__.service.ts +16 -0
  185. package/cli/templates/module/__model__.signal.ts +27 -0
  186. package/cli/templates/module/__model__.store.ts +19 -0
  187. package/cli/templates/module/index.tsx +44 -0
  188. package/cli/templates/moduleRoot/index.tsx +31 -0
  189. package/cli/templates/pkgRoot/tsconfig.json.template +10 -0
  190. package/cli/templates/server.ts +45 -0
  191. package/cli/templates/workspaceRoot/.env.template +14 -0
  192. package/cli/templates/workspaceRoot/.gitignore.template +130 -0
  193. package/cli/templates/workspaceRoot/.vscode/settings.json.template +23 -0
  194. package/cli/templates/workspaceRoot/biome.json.template +175 -0
  195. package/cli/templates/workspaceRoot/bunfig.toml +4 -0
  196. package/cli/templates/workspaceRoot/infra/app/Chart.yaml.template +6 -0
  197. package/cli/templates/workspaceRoot/infra/app/templates/frontend.yaml.template +182 -0
  198. package/cli/templates/workspaceRoot/infra/app/values/_common-values.yaml.template +183 -0
  199. package/cli/templates/workspaceRoot/package.json.template +7 -0
  200. package/cli/templates/workspaceRoot/tsconfig.json.template +26 -0
  201. package/cli/testHelpers.ts +171 -0
  202. package/cli/workspace/workspace.command.ts +60 -0
  203. package/cli/workspace/workspace.runner.ts +57 -0
  204. package/cli/workspace/workspace.script.ts +68 -0
  205. package/client/capacitor.ts +68 -0
  206. package/client/clientRuntime.ts +141 -0
  207. package/client/cookie.ts +121 -0
  208. package/client/createFont.ts +8 -0
  209. package/client/csrTypes.ts +259 -0
  210. package/client/decorators.ts +25 -0
  211. package/client/device.ts +147 -0
  212. package/client/fetch.ts +1 -0
  213. package/client/index.ts +15 -0
  214. package/client/locale.ts +4 -0
  215. package/client/makePageProto.tsx +178 -0
  216. package/client/router.ts +286 -0
  217. package/client/rscNavigation.ts +19 -0
  218. package/client/storage.ts +33 -0
  219. package/client/translator.ts +43 -0
  220. package/client/types.ts +228 -0
  221. package/client/useClient.ts +1 -0
  222. package/common/Logger.ts +177 -0
  223. package/common/applyMixins.ts +14 -0
  224. package/common/capitalize.ts +4 -0
  225. package/common/deepObjectify.ts +27 -0
  226. package/common/formatNumber.ts +14 -0
  227. package/common/formatPhone.ts +7 -0
  228. package/common/getAllPropertyDescriptors.ts +13 -0
  229. package/common/hmrPhase.ts +17 -0
  230. package/common/httpClient.ts +101 -0
  231. package/common/index.ts +50 -0
  232. package/common/isDayjs.ts +3 -0
  233. package/common/isEmail.ts +2 -0
  234. package/common/isPhoneNumber.ts +8 -0
  235. package/common/isQueryEqual.ts +23 -0
  236. package/common/isValidDate.ts +14 -0
  237. package/common/localeConfig.ts +41 -0
  238. package/common/lowerlize.ts +4 -0
  239. package/common/mergeVersion.ts +10 -0
  240. package/common/objectify.ts +7 -0
  241. package/common/pathGet.ts +13 -0
  242. package/common/pathSet.ts +16 -0
  243. package/common/randomPick.ts +1 -0
  244. package/common/randomPicks.ts +12 -0
  245. package/common/routeConvention.ts +203 -0
  246. package/common/sleep.ts +8 -0
  247. package/common/splitVersion.ts +11 -0
  248. package/common/subRoute.ts +34 -0
  249. package/common/types.ts +15 -0
  250. package/constant/constantRegistry.ts +334 -0
  251. package/constant/crystalize.ts +45 -0
  252. package/constant/deserialize.ts +70 -0
  253. package/constant/fieldInfo.ts +415 -0
  254. package/constant/getDefault.ts +18 -0
  255. package/constant/immerify.ts +16 -0
  256. package/constant/index.ts +10 -0
  257. package/constant/purify.ts +118 -0
  258. package/constant/serialize.ts +87 -0
  259. package/constant/types.ts +105 -0
  260. package/constant/via.ts +360 -0
  261. package/devkit/aiEditor.ts +299 -0
  262. package/devkit/akanApp/akanApp.host.ts +356 -0
  263. package/devkit/akanApp/index.ts +1 -0
  264. package/devkit/akanConfig/akanConfig.ts +332 -0
  265. package/devkit/akanConfig/index.ts +2 -0
  266. package/devkit/akanConfig/types.ts +187 -0
  267. package/devkit/applicationBuildReporter.ts +69 -0
  268. package/devkit/applicationBuildRunner.ts +302 -0
  269. package/devkit/applicationReleasePackager.ts +205 -0
  270. package/devkit/artifact/implicitRootLayout.ts +155 -0
  271. package/devkit/artifact/index.ts +1 -0
  272. package/devkit/artifact/routeSeedIndex.ts +128 -0
  273. package/devkit/auth.ts +41 -0
  274. package/devkit/builder.ts +164 -0
  275. package/devkit/capacitor.base.config.ts +74 -0
  276. package/devkit/capacitorApp.ts +385 -0
  277. package/devkit/commandDecorators/argMeta.ts +88 -0
  278. package/devkit/commandDecorators/command.ts +314 -0
  279. package/devkit/commandDecorators/commandBuilder.ts +188 -0
  280. package/devkit/commandDecorators/commandMeta.ts +6 -0
  281. package/devkit/commandDecorators/dependencyBuilder.ts +100 -0
  282. package/devkit/commandDecorators/helpFormatter.ts +217 -0
  283. package/devkit/commandDecorators/index.ts +8 -0
  284. package/devkit/commandDecorators/targetMeta.ts +31 -0
  285. package/devkit/commandDecorators/types.ts +10 -0
  286. package/devkit/constants.ts +25 -0
  287. package/devkit/createTunnel.ts +36 -0
  288. package/devkit/dependencyScanner.ts +339 -0
  289. package/devkit/executors.ts +1326 -0
  290. package/devkit/extractDeps.ts +85 -0
  291. package/devkit/fileEditor.ts +106 -0
  292. package/devkit/fileSys.ts +39 -0
  293. package/devkit/frontendBuild/allRoutesBuilder.ts +103 -0
  294. package/devkit/frontendBuild/clientBuildTypes.ts +114 -0
  295. package/devkit/frontendBuild/clientEntriesBundler.ts +300 -0
  296. package/devkit/frontendBuild/clientEntryDiscovery.ts +196 -0
  297. package/devkit/frontendBuild/csrArtifactBuilder.ts +237 -0
  298. package/devkit/frontendBuild/cssCompiler.ts +279 -0
  299. package/devkit/frontendBuild/cssImportResolver.ts +116 -0
  300. package/devkit/frontendBuild/fontOptimizer.ts +427 -0
  301. package/devkit/frontendBuild/hmrChangeClassifier.ts +28 -0
  302. package/devkit/frontendBuild/hmrWatcher.ts +101 -0
  303. package/devkit/frontendBuild/index.ts +18 -0
  304. package/devkit/frontendBuild/pagesBundleBuilder.ts +137 -0
  305. package/devkit/frontendBuild/pagesEntrySourceGenerator.ts +37 -0
  306. package/devkit/frontendBuild/precompressArtifacts.ts +59 -0
  307. package/devkit/frontendBuild/routeClientBuilder.ts +290 -0
  308. package/devkit/frontendBuild/routesManifestArtifactSerializer.ts +62 -0
  309. package/devkit/frontendBuild/ssrBaseArtifactBuilder.ts +139 -0
  310. package/devkit/frontendBuild/vendorSpecifiers.ts +16 -0
  311. package/devkit/frontendBuild/watchRootResolver.ts +28 -0
  312. package/devkit/getCredentials.ts +19 -0
  313. package/devkit/getDirname.ts +3 -0
  314. package/devkit/getModelFileData.ts +59 -0
  315. package/devkit/getRelatedCnsts.ts +300 -0
  316. package/devkit/guideline.ts +19 -0
  317. package/devkit/incrementalBuilder/incrementalBuilder.host.ts +78 -0
  318. package/devkit/incrementalBuilder/incrementalBuilder.proc.ts +330 -0
  319. package/devkit/incrementalBuilder/index.ts +1 -0
  320. package/devkit/index.ts +36 -0
  321. package/devkit/lint/no-import-client-functions.grit +32 -0
  322. package/devkit/lint/no-import-external-library.grit +21 -0
  323. package/devkit/lint/no-js-private-class-method.grit +42 -0
  324. package/devkit/lint/no-use-client-in-server.grit +7 -0
  325. package/devkit/lint/non-scalar-props-restricted.grit +13 -0
  326. package/devkit/linter.ts +248 -0
  327. package/devkit/mobile/index.ts +1 -0
  328. package/devkit/mobile/mobileTarget.ts +47 -0
  329. package/devkit/prompter.ts +71 -0
  330. package/devkit/scanInfo.ts +605 -0
  331. package/devkit/selectModel.ts +11 -0
  332. package/devkit/spinner.ts +54 -0
  333. package/devkit/sshTunnel.ts +151 -0
  334. package/devkit/streamAi.ts +45 -0
  335. package/devkit/transforms/barrelAnalyzer.ts +249 -0
  336. package/devkit/transforms/barrelImportsPlugin.ts +451 -0
  337. package/devkit/transforms/externalizeFrameworkPlugin.ts +159 -0
  338. package/devkit/transforms/index.ts +5 -0
  339. package/devkit/transforms/rscUseClientTransform.ts +52 -0
  340. package/devkit/transforms/useClientBundlePlugin.ts +47 -0
  341. package/devkit/typeChecker.ts +260 -0
  342. package/devkit/types.ts +42 -0
  343. package/devkit/ui/MultiScrollList.tsx +228 -0
  344. package/devkit/ui/ScrollList.tsx +106 -0
  345. package/devkit/ui/index.ts +2 -0
  346. package/devkit/uploadRelease.ts +95 -0
  347. package/devkit/useStdoutDimensions.ts +20 -0
  348. package/dictionary/base.dictionary.ts +91 -0
  349. package/dictionary/dictInfo.ts +1079 -0
  350. package/dictionary/dictionary.ts +10 -0
  351. package/dictionary/index.ts +12 -0
  352. package/dictionary/locale.ts +230 -0
  353. package/dictionary/trans.ts +196 -0
  354. package/document/by.ts +39 -0
  355. package/document/dataLoader.ts +91 -0
  356. package/document/database.ts +168 -0
  357. package/document/databaseRegistry.ts +113 -0
  358. package/document/documentQuery.ts +143 -0
  359. package/document/documentSchema.ts +91 -0
  360. package/document/filterMeta.ts +210 -0
  361. package/document/index.ts +11 -0
  362. package/document/into.ts +169 -0
  363. package/document/loaderInfo.ts +50 -0
  364. package/document/schema.ts +24 -0
  365. package/document/types.ts +41 -0
  366. package/fetch/client/fetchClient.ts +600 -0
  367. package/fetch/client/httpClient.ts +157 -0
  368. package/fetch/client/index.ts +3 -0
  369. package/fetch/client/wsClient.ts +246 -0
  370. package/fetch/fetchType/appliedReturn.type.ts +108 -0
  371. package/fetch/fetchType/buildFetch.type.ts +24 -0
  372. package/fetch/fetchType/clientSignal.type.ts +22 -0
  373. package/fetch/fetchType/endpointFetch.type.ts +56 -0
  374. package/fetch/fetchType/index.ts +5 -0
  375. package/fetch/fetchType/sliceFetch.type.ts +173 -0
  376. package/fetch/index.ts +4 -0
  377. package/fetch/requestStorage.ts +127 -0
  378. package/fetch/serializer/fetch.serializer.ts +131 -0
  379. package/fetch/serializer/index.ts +1 -0
  380. package/fetch/types.ts +28 -0
  381. package/package.json +202 -5
  382. package/server/SSR_MEMORY_DIAGNOSIS.md +107 -0
  383. package/server/akanApp.ts +855 -0
  384. package/server/akanLib.ts +43 -0
  385. package/server/akanOption.ts +42 -0
  386. package/server/akanServer.ts +369 -0
  387. package/server/artifact/builderRpc.ts +124 -0
  388. package/server/artifact/index.ts +6 -0
  389. package/server/artifact/ipcTypes.ts +46 -0
  390. package/server/artifact/manifestTypes.ts +19 -0
  391. package/server/artifact/routeClientCache.ts +224 -0
  392. package/server/artifact/routeSeedIndexStore.ts +89 -0
  393. package/server/artifact/routesManifestStore.ts +120 -0
  394. package/server/decorators.ts +95 -0
  395. package/server/di/diLifecycle.ts +520 -0
  396. package/server/di/index.ts +4 -0
  397. package/server/di/predefinedAdaptor.ts +77 -0
  398. package/server/di/resolveAdaptorHierarchy.ts +82 -0
  399. package/server/di/resolveHierarchy.ts +89 -0
  400. package/server/di/resolveServiceHierarchy.ts +47 -0
  401. package/server/di/utils.ts +40 -0
  402. package/server/hmr/changeBatch.ts +14 -0
  403. package/server/hmr/clientScript.ts +310 -0
  404. package/server/hmr/devHmrController.ts +395 -0
  405. package/server/hmr/index.ts +4 -0
  406. package/server/hmr/wsHub.ts +56 -0
  407. package/server/imageOptimizer.ts +427 -0
  408. package/server/imageOptimizerError.ts +8 -0
  409. package/server/index.ts +14 -0
  410. package/server/lifecycle/shutdownManager.ts +52 -0
  411. package/server/logging/rotatingLogWriter.ts +190 -0
  412. package/server/processMetricsCollector.ts +78 -0
  413. package/server/proxy/akanResponse.ts +16 -0
  414. package/server/proxy/bunRequestFields.ts +12 -0
  415. package/server/proxy/hostBasePathWebProxy.ts +112 -0
  416. package/server/proxy/index.ts +15 -0
  417. package/server/proxy/localeWebProxy.ts +71 -0
  418. package/server/proxy/types.ts +41 -0
  419. package/server/proxy/webProxyRunner.ts +90 -0
  420. package/server/resolver/database.resolver.ts +340 -0
  421. package/server/resolver/index.ts +3 -0
  422. package/server/resolver/resolver.contract.fixture.ts +222 -0
  423. package/server/resolver/service.resolver.ts +176 -0
  424. package/server/resolver/signal.resolver.ts +386 -0
  425. package/server/robots.ts +32 -0
  426. package/server/routeElementComposer.tsx +91 -0
  427. package/server/routeTreeBuilder.ts +279 -0
  428. package/server/routing/apiRouter.ts +226 -0
  429. package/server/rscClient.tsx +140 -0
  430. package/server/rscWorker.tsx +625 -0
  431. package/server/rscWorkerHost.ts +616 -0
  432. package/server/sitemap.ts +90 -0
  433. package/server/ssrFromRscRenderer.tsx +285 -0
  434. package/server/ssrTypes.ts +48 -0
  435. package/server/types/react-server-dom-webpack.d.ts +91 -0
  436. package/server/types.tsx +109 -0
  437. package/server/vendor/akanjs-base.ts +1 -0
  438. package/server/vendor/akanjs-common.ts +1 -0
  439. package/server/vendor/akanjs-constant.ts +1 -0
  440. package/server/vendor/akanjs-store.ts +1 -0
  441. package/server/vendor/react-dom-client.ts +5 -0
  442. package/server/vendor/react-dom.ts +21 -0
  443. package/server/vendor/react-jsx-dev-runtime.ts +5 -0
  444. package/server/vendor/react-jsx-runtime.ts +5 -0
  445. package/server/vendor/react-refresh-runtime.ts +6 -0
  446. package/server/vendor/react-server-dom-webpack-client-browser.ts +12 -0
  447. package/server/vendor/react.ts +51 -0
  448. package/server/vendor/scheduler.ts +23 -0
  449. package/server/webRouter.ts +712 -0
  450. package/service/adapt.ts +47 -0
  451. package/service/base.service.ts +18 -0
  452. package/service/index.ts +10 -0
  453. package/service/injectInfo.ts +393 -0
  454. package/service/ipcTypes.ts +127 -0
  455. package/service/predefinedAdaptor/cache.adaptor.ts +105 -0
  456. package/service/predefinedAdaptor/compress.adaptor.ts +357 -0
  457. package/service/predefinedAdaptor/database.adaptor.ts +1310 -0
  458. package/service/predefinedAdaptor/index.ts +13 -0
  459. package/service/predefinedAdaptor/logging.adaptor.ts +36 -0
  460. package/service/predefinedAdaptor/queue.adaptor.ts +42 -0
  461. package/service/predefinedAdaptor/role.adaptor.ts +18 -0
  462. package/service/predefinedAdaptor/schedule.adaptor.ts +188 -0
  463. package/service/predefinedAdaptor/solidCache.adaptor.ts +143 -0
  464. package/service/predefinedAdaptor/solidPubsub.adaptor.ts +98 -0
  465. package/service/predefinedAdaptor/solidQueue.adaptor.ts +203 -0
  466. package/service/predefinedAdaptor/solidSqlite.ts +85 -0
  467. package/service/predefinedAdaptor/sqlitePath.ts +20 -0
  468. package/service/predefinedAdaptor/storage.adaptor.ts +121 -0
  469. package/service/predefinedAdaptor/websocket.adaptor.ts +313 -0
  470. package/service/serve.ts +223 -0
  471. package/service/serviceModule.ts +221 -0
  472. package/service/serviceRegistry.ts +26 -0
  473. package/service/types.ts +113 -0
  474. package/signal/base.signal.ts +46 -0
  475. package/signal/endpoint.ts +122 -0
  476. package/signal/endpointInfo.ts +374 -0
  477. package/signal/exception.ts +50 -0
  478. package/signal/guard.ts +18 -0
  479. package/signal/guards.ts +16 -0
  480. package/signal/index.ts +18 -0
  481. package/signal/intercept.ts +39 -0
  482. package/signal/internal.ts +56 -0
  483. package/signal/internalArg.ts +38 -0
  484. package/signal/internalInfo.ts +208 -0
  485. package/signal/middleware.ts +108 -0
  486. package/signal/serializer/fetch.serializer.ts +128 -0
  487. package/signal/serializer/index.ts +1 -0
  488. package/signal/serverSignal.ts +114 -0
  489. package/signal/signalContext.ts +446 -0
  490. package/signal/signalRegistry.ts +82 -0
  491. package/signal/slice.ts +158 -0
  492. package/signal/sliceInfo.ts +254 -0
  493. package/signal/types.ts +131 -0
  494. package/store/action.ts +1067 -0
  495. package/store/baseSt.ts +81 -0
  496. package/store/hooks.ts +2 -0
  497. package/store/index.ts +8 -0
  498. package/store/rootStore.ts +26 -0
  499. package/store/state.ts +226 -0
  500. package/store/stateBuilder.ts +429 -0
  501. package/store/stateInfo.ts +66 -0
  502. package/store/store.ts +194 -0
  503. package/store/storeInstance.ts +382 -0
  504. package/store/storeRegistry.ts +84 -0
  505. package/store/types.ts +69 -0
  506. package/store/withSelector.ts +62 -0
  507. package/test/index.ts +16 -0
  508. package/test/playwright.config.base.ts +48 -0
  509. package/test/playwright.pageAgent.ts +41 -0
  510. package/test/sample.ts +19 -0
  511. package/test/sampleOf.ts +70 -0
  512. package/test/signalTest.preload.ts +10 -0
  513. package/test/signalTestRuntime.ts +126 -0
  514. package/test/testServer.ts +187 -0
  515. package/ui/BottomSheet.tsx +103 -0
  516. package/ui/Button.tsx +70 -0
  517. package/ui/ClientSide.tsx +11 -0
  518. package/ui/Clipboard.tsx +49 -0
  519. package/ui/Constant/Doc.tsx +696 -0
  520. package/ui/Constant/Mermaid.tsx +149 -0
  521. package/ui/Constant/index.ts +6 -0
  522. package/ui/Constant/schemaDoc.ts +324 -0
  523. package/ui/Copy.tsx +27 -0
  524. package/ui/CsrImage.tsx +38 -0
  525. package/ui/Data/CardList.tsx +141 -0
  526. package/ui/Data/Dashboard.tsx +72 -0
  527. package/ui/Data/Insight.tsx +35 -0
  528. package/ui/Data/Item.tsx +285 -0
  529. package/ui/Data/ListContainer.tsx +320 -0
  530. package/ui/Data/Pagination.tsx +54 -0
  531. package/ui/Data/QueryMaker.tsx +21 -0
  532. package/ui/Data/TableList.tsx +161 -0
  533. package/ui/Data/index.ts +11 -0
  534. package/ui/Data/index_.tsx +11 -0
  535. package/ui/DatePicker.tsx +184 -0
  536. package/ui/Dialog/Action.tsx +15 -0
  537. package/ui/Dialog/Close.tsx +22 -0
  538. package/ui/Dialog/Content.tsx +11 -0
  539. package/ui/Dialog/Modal.tsx +137 -0
  540. package/ui/Dialog/Provider.tsx +33 -0
  541. package/ui/Dialog/Title.tsx +15 -0
  542. package/ui/Dialog/Trigger.tsx +22 -0
  543. package/ui/Dialog/context.ts +20 -0
  544. package/ui/Dialog/index.tsx +15 -0
  545. package/ui/DragAction.tsx +129 -0
  546. package/ui/DraggableList.tsx +230 -0
  547. package/ui/Dropdown.tsx +51 -0
  548. package/ui/Empty.tsx +32 -0
  549. package/ui/Field.tsx +1556 -0
  550. package/ui/FontFace.tsx +26 -0
  551. package/ui/Image.tsx +185 -0
  552. package/ui/InfiniteScroll.tsx +67 -0
  553. package/ui/Input.tsx +636 -0
  554. package/ui/KeyboardAvoiding.tsx +62 -0
  555. package/ui/Layout/BottomAction.tsx +15 -0
  556. package/ui/Layout/BottomInset.tsx +42 -0
  557. package/ui/Layout/BottomTab.tsx +71 -0
  558. package/ui/Layout/Header.tsx +38 -0
  559. package/ui/Layout/LeftSider.tsx +34 -0
  560. package/ui/Layout/Navbar.tsx +46 -0
  561. package/ui/Layout/RightSider.tsx +41 -0
  562. package/ui/Layout/Sider.tsx +69 -0
  563. package/ui/Layout/Template.tsx +11 -0
  564. package/ui/Layout/TopLeftAction.tsx +28 -0
  565. package/ui/Layout/Unit.tsx +19 -0
  566. package/ui/Layout/View.tsx +12 -0
  567. package/ui/Layout/Zone.tsx +10 -0
  568. package/ui/Layout/index.ts +27 -0
  569. package/ui/Link/Back.tsx +15 -0
  570. package/ui/Link/Close.tsx +20 -0
  571. package/ui/Link/CsrLink.tsx +41 -0
  572. package/ui/Link/Lang.tsx +16 -0
  573. package/ui/Link/SsrLink.tsx +68 -0
  574. package/ui/Link/index.tsx +32 -0
  575. package/ui/Link/types.ts +47 -0
  576. package/ui/Load/Edit.tsx +19 -0
  577. package/ui/Load/Edit_Client.tsx +120 -0
  578. package/ui/Load/Page.tsx +40 -0
  579. package/ui/Load/PageCSR.tsx +39 -0
  580. package/ui/Load/Pagination.tsx +89 -0
  581. package/ui/Load/Units.tsx +330 -0
  582. package/ui/Load/View.tsx +115 -0
  583. package/ui/Load/index.ts +11 -0
  584. package/ui/Load/index_.tsx +6 -0
  585. package/ui/Loading/Area.tsx +10 -0
  586. package/ui/Loading/Button.tsx +17 -0
  587. package/ui/Loading/Input.tsx +17 -0
  588. package/ui/Loading/ProgressBar.tsx +14 -0
  589. package/ui/Loading/Skeleton.tsx +22 -0
  590. package/ui/Loading/Spin.tsx +22 -0
  591. package/ui/Loading/index.tsx +8 -0
  592. package/ui/Menu.tsx +273 -0
  593. package/ui/Modal.tsx +87 -0
  594. package/ui/Model/AdminPanel.tsx +51 -0
  595. package/ui/Model/Edit.tsx +46 -0
  596. package/ui/Model/EditModal.tsx +301 -0
  597. package/ui/Model/EditWrapper.tsx +48 -0
  598. package/ui/Model/LoadInit.tsx +11 -0
  599. package/ui/Model/New.tsx +46 -0
  600. package/ui/Model/NewWrapper.tsx +20 -0
  601. package/ui/Model/NewWrapper_Client.tsx +57 -0
  602. package/ui/Model/Remove.tsx +75 -0
  603. package/ui/Model/RemoveWrapper.tsx +38 -0
  604. package/ui/Model/SureToRemove.tsx +108 -0
  605. package/ui/Model/View.tsx +65 -0
  606. package/ui/Model/ViewEditModal.tsx +125 -0
  607. package/ui/Model/ViewModal.tsx +71 -0
  608. package/ui/Model/ViewWrapper.tsx +38 -0
  609. package/ui/Model/index.ts +33 -0
  610. package/ui/Model/index_.tsx +16 -0
  611. package/ui/More.tsx +56 -0
  612. package/ui/ObjectId.tsx +29 -0
  613. package/ui/Pagination.tsx +120 -0
  614. package/ui/Popconfirm.tsx +135 -0
  615. package/ui/Portal.tsx +10 -0
  616. package/ui/Radio.tsx +53 -0
  617. package/ui/RecentTime.tsx +123 -0
  618. package/ui/Refresh.tsx +24 -0
  619. package/ui/ScreenNavigator.tsx +129 -0
  620. package/ui/Select.tsx +322 -0
  621. package/ui/Signal/Arg.tsx +352 -0
  622. package/ui/Signal/Doc.tsx +231 -0
  623. package/ui/Signal/Listener.tsx +74 -0
  624. package/ui/Signal/Message.tsx +267 -0
  625. package/ui/Signal/Object.tsx +131 -0
  626. package/ui/Signal/PubSub.tsx +247 -0
  627. package/ui/Signal/Request.tsx +30 -0
  628. package/ui/Signal/Response.tsx +76 -0
  629. package/ui/Signal/RestApi.tsx +390 -0
  630. package/ui/Signal/WebSocket.tsx +47 -0
  631. package/ui/Signal/index.ts +10 -0
  632. package/ui/Signal/makeExample.ts +75 -0
  633. package/ui/System/CSR.tsx +420 -0
  634. package/ui/System/Client.tsx +296 -0
  635. package/ui/System/Common.tsx +83 -0
  636. package/ui/System/DevModeToggle.tsx +21 -0
  637. package/ui/System/Gtag.tsx +69 -0
  638. package/ui/System/Messages.tsx +175 -0
  639. package/ui/System/Reconnect.tsx +156 -0
  640. package/ui/System/Root.tsx +10 -0
  641. package/ui/System/SSR.tsx +163 -0
  642. package/ui/System/SelectLanguage.tsx +47 -0
  643. package/ui/System/ThemeToggle.tsx +98 -0
  644. package/ui/System/index.tsx +23 -0
  645. package/ui/Tab/Menu.tsx +56 -0
  646. package/ui/Tab/Menus.tsx +10 -0
  647. package/ui/Tab/Panel.tsx +25 -0
  648. package/ui/Tab/Provider.tsx +25 -0
  649. package/ui/Tab/context.ts +16 -0
  650. package/ui/Tab/index.tsx +11 -0
  651. package/ui/Table.tsx +131 -0
  652. package/ui/ToggleSelect.tsx +144 -0
  653. package/ui/Unauthorized.tsx +29 -0
  654. package/ui/animated.tsx +8 -0
  655. package/ui/fontCss.ts +86 -0
  656. package/ui/index.ts +44 -0
  657. package/ui/styles.css +617 -0
  658. package/webkit/bootCsr.tsx +275 -0
  659. package/webkit/createRobotPage.ts +15 -0
  660. package/webkit/createSitemapPage.ts +4 -0
  661. package/webkit/index.ts +19 -0
  662. package/webkit/lazy.tsx +37 -0
  663. package/webkit/types.ts +7 -0
  664. package/webkit/useCamera.tsx +99 -0
  665. package/webkit/useCodepush.tsx +99 -0
  666. package/webkit/useContact.tsx +48 -0
  667. package/webkit/useCsrValues.ts +661 -0
  668. package/webkit/useDebounce.ts +24 -0
  669. package/webkit/useFetch.ts +48 -0
  670. package/webkit/useGeoLocation.tsx +24 -0
  671. package/webkit/useHistory.ts +76 -0
  672. package/webkit/useInterval.ts +21 -0
  673. package/webkit/useLocation.ts +69 -0
  674. package/webkit/usePurchase.tsx +156 -0
  675. package/webkit/usePushNoti.tsx +48 -0
  676. package/webkit/useThrottle.ts +22 -0
  677. package/src/index.js +0 -2
  678. package/src/index.js.map +0 -1
  679. package/src/lib/akan2.js +0 -4
  680. package/src/lib/akan2.js.map +0 -1
  681. package/src/run.js +0 -4
  682. package/src/run.js.map +0 -1
@@ -0,0 +1,446 @@
1
+ import {
2
+ type BaseEnv,
3
+ type Cls,
4
+ FIELD_META,
5
+ INTERNAL_META,
6
+ PrimitiveRegistry,
7
+ type PromiseOrObject,
8
+ Upload,
9
+ } from "akanjs/base";
10
+ import {
11
+ type ConstantCls,
12
+ type ConstantFieldTypeInput,
13
+ ConstantRegistry,
14
+ deserialize,
15
+ serialize,
16
+ } from "akanjs/constant";
17
+ import type { Adaptor, AdaptorCls, DatabaseService, InjectRegistry, LiveRegistry } from "akanjs/service";
18
+ import type { Internal, InternalCls, InternalInfo, MiddlewareCls } from ".";
19
+ import type { EndpointInfo } from "./endpointInfo";
20
+ import { Exception } from "./exception";
21
+
22
+ export type SignalTransportType = "http" | "websocket";
23
+
24
+ interface WebSocketRequest {
25
+ ws: Bun.ServerWebSocket<unknown>;
26
+ data: unknown[];
27
+ eventType: WebSocketEventType;
28
+ }
29
+ type RuntimeRecord = Record<string, unknown>;
30
+
31
+ interface ExceptionLike {
32
+ statusCode: number;
33
+ toJSON(): object;
34
+ }
35
+
36
+ const isExceptionLike = (error: unknown): error is ExceptionLike => {
37
+ return (
38
+ error instanceof Exception ||
39
+ (error instanceof Error &&
40
+ "statusCode" in error &&
41
+ typeof (error as { statusCode?: unknown }).statusCode === "number" &&
42
+ typeof (error as { toJSON?: unknown }).toJSON === "function")
43
+ );
44
+ };
45
+
46
+ export class SignalContext<
47
+ Ctx extends HttpExecutionContext | WebSocketExecutionContext = HttpExecutionContext | WebSocketExecutionContext,
48
+ Env extends BaseEnv = BaseEnv,
49
+ > {
50
+ key: string;
51
+ transport: SignalTransportType;
52
+ ctx: Ctx;
53
+ endpointInfo: EndpointInfo;
54
+ adaptor: Adaptor;
55
+ args: unknown[] = [];
56
+ internalArgs: unknown[] = [];
57
+ #registry: InjectRegistry;
58
+ #env: Env;
59
+ #live: LiveRegistry;
60
+ #middleware: Map<string, MiddlewareCls>;
61
+ constructor(
62
+ key: string,
63
+ reqOrWsReq: Bun.BunRequest | WebSocketRequest,
64
+ {
65
+ endpointInfo,
66
+ adaptor,
67
+ registry,
68
+ env,
69
+ live,
70
+ middleware,
71
+ }: {
72
+ endpointInfo: EndpointInfo;
73
+ adaptor: Adaptor;
74
+ registry: InjectRegistry;
75
+ env: Env;
76
+ live: LiveRegistry;
77
+ middleware: Map<string, MiddlewareCls>;
78
+ },
79
+ ) {
80
+ this.key = key;
81
+ this.transport = endpointInfo.type === "query" || endpointInfo.type === "mutation" ? "http" : "websocket";
82
+ this.endpointInfo = endpointInfo;
83
+ if (this.transport === "http") this.ctx = new HttpExecutionContext(reqOrWsReq as Bun.BunRequest) as Ctx;
84
+ else this.ctx = new WebSocketExecutionContext(reqOrWsReq as WebSocketRequest) as Ctx;
85
+ this.adaptor = adaptor;
86
+ this.#registry = registry;
87
+ this.#env = env;
88
+ this.#live = live;
89
+ this.#middleware = middleware;
90
+ }
91
+
92
+ getAdaptor<T extends Adaptor>(adaptorCls: AdaptorCls<T>): T {
93
+ const instance = this.#registry.adaptor.get(adaptorCls);
94
+ if (!instance) {
95
+ throw new Exception.Error(`Adaptor "${adaptorCls.refName}" not found in registry`);
96
+ }
97
+ return instance as T;
98
+ }
99
+ async init() {
100
+ this.args = await this.ctx.getArgs(this.endpointInfo);
101
+ return this;
102
+ }
103
+ async #checkGuards() {
104
+ const guards = this.endpointInfo.signalOption.guards ?? [];
105
+ for (const GuardCls of guards) {
106
+ const guard = new GuardCls();
107
+ const canPass = guard.canPass(this);
108
+ if (!canPass) throw new Exception.Forbidden(`Access denied by guard: ${GuardCls.name}`);
109
+ }
110
+ }
111
+ async exec() {
112
+ if (!this.endpointInfo.execFn) throw new Exception.Error("Exec function is not set");
113
+ const middlewares = [...this.#middleware.values(), ...(this.endpointInfo.signalOption.middlewares ?? [])];
114
+ const coreExec = async () => {
115
+ if (!this.endpointInfo.execFn) throw new Exception.Error("Exec function is not set");
116
+ await this.#checkGuards();
117
+ this.internalArgs = await Promise.all(
118
+ this.endpointInfo.internalArgs.map((arg) => {
119
+ const argValue = new arg.argRef().getArg(this) ?? null;
120
+ if (argValue === null && !arg.option?.nullable)
121
+ throw new Exception.Unauthorized(`Internal Argument ${arg.argRef.name} is required`);
122
+ return argValue;
123
+ }),
124
+ );
125
+ const result = await this.endpointInfo.execFn.call(this.adaptor, ...this.args, ...this.internalArgs);
126
+ return result;
127
+ };
128
+ let next = coreExec;
129
+ for (let i = middlewares.length - 1; i >= 0; i--) {
130
+ const MiddlewareCls = middlewares[i];
131
+ if (!MiddlewareCls) continue;
132
+ const middleware = new MiddlewareCls();
133
+ const currentNext = next;
134
+ next = async () => await (await middleware.use(this.getEnv()))(this, currentNext);
135
+ }
136
+ const result = await next();
137
+ if (this.endpointInfo.type === "pubsub") return;
138
+ if (result instanceof Response) return result;
139
+ const resolved = await SignalContext.resolveReturn(result, {
140
+ signalContext: this,
141
+ returnRef: this.endpointInfo.returns.returnRef,
142
+ arrDepth: this.endpointInfo.returns.arrDepth,
143
+ registry: this.#registry,
144
+ live: this.#live,
145
+ });
146
+ return this.ctx.makeResponse(resolved, this.endpointInfo);
147
+ }
148
+ static async try(
149
+ endpoint: Adaptor,
150
+ endpointInfo: EndpointInfo,
151
+ key: string,
152
+ fn: () => Promise<Response | undefined>,
153
+ ): Promise<Response | undefined> {
154
+ try {
155
+ return await fn();
156
+ } catch (error) {
157
+ if (endpointInfo.type === "message" || endpointInfo.type === "pubsub") throw error;
158
+ if (isExceptionLike(error)) {
159
+ return new Response(
160
+ JSON.stringify({
161
+ ...error.toJSON(),
162
+ path: endpointInfo.getPath(key),
163
+ timestamp: new Date().toISOString(),
164
+ }),
165
+ { status: error.statusCode, headers: { "Content-Type": "application/json" } },
166
+ );
167
+ }
168
+ const message = error instanceof Error ? error.message : String(error);
169
+ const stack = error instanceof Error ? error.stack : undefined;
170
+ endpoint.logger.error(`Error ${endpointInfo.type}-${key}:\n${stack ?? message}`);
171
+ return new Response(
172
+ JSON.stringify({
173
+ error: message,
174
+ statusCode: 500,
175
+ path: endpointInfo.getPath(key),
176
+ timestamp: new Date().toISOString(),
177
+ stack: error instanceof Error ? error.stack : undefined,
178
+ }),
179
+ { status: 500, headers: { "Content-Type": "application/json" } },
180
+ );
181
+ }
182
+ }
183
+ static async resolveReturn(
184
+ value: unknown,
185
+ {
186
+ signalContext,
187
+ returnRef,
188
+ arrDepth,
189
+ registry,
190
+ live,
191
+ }: {
192
+ signalContext: SignalContext | null;
193
+ returnRef: ConstantFieldTypeInput;
194
+ arrDepth: number;
195
+ registry: InjectRegistry;
196
+ live: LiveRegistry;
197
+ },
198
+ ): Promise<unknown> {
199
+ if (value === null || value === undefined) return value;
200
+ if (PrimitiveRegistry.has(returnRef as Cls)) return value;
201
+ else if (arrDepth)
202
+ return await Promise.all(
203
+ (value as unknown[]).map((v) =>
204
+ SignalContext.resolveReturn(v, { signalContext, returnRef, arrDepth: arrDepth - 1, registry, live }),
205
+ ),
206
+ );
207
+ const valueRecord = value as RuntimeRecord;
208
+ const resolvedValue = {} as RuntimeRecord;
209
+ await Promise.all(
210
+ Object.entries((returnRef as ConstantCls)[FIELD_META]).map(async ([key, field]) => {
211
+ if (field.fieldType === "hidden") return;
212
+ else if (field.fieldType === "resolve") {
213
+ const refName = ConstantRegistry.getRefName(returnRef as ConstantCls);
214
+ const internal = live.internal.get(`${refName}Internal`);
215
+ if (!internal) throw new Error(`Internal ${refName} is not registered`);
216
+ const internalCls = internal.constructor as InternalCls;
217
+ const internalInfo = internalCls[INTERNAL_META][key] as InternalInfo<"resolveField"> | undefined;
218
+ if (!internalInfo) throw new Error(`Internal info ${key} is not found`);
219
+ const resolveFieldContext = new ResolveFieldContext(valueRecord, { signalContext, internalInfo, internal });
220
+ const resolved = await resolveFieldContext.exec();
221
+ resolvedValue[key] = await SignalContext.resolveReturn(resolved, {
222
+ signalContext,
223
+ returnRef: field.modelRef,
224
+ arrDepth: field.arrDepth,
225
+ registry,
226
+ live,
227
+ });
228
+ } else if (!field.isClass) resolvedValue[key] = valueRecord[key];
229
+ else if (field.isScalar) {
230
+ resolvedValue[key] = await SignalContext.resolveReturn(valueRecord[key], {
231
+ signalContext,
232
+ returnRef: field.modelRef,
233
+ arrDepth: field.arrDepth,
234
+ registry,
235
+ live,
236
+ });
237
+ } else {
238
+ const refName = ConstantRegistry.getRefName(field.modelRef);
239
+ const service = live.service.get(refName) as unknown as DatabaseService;
240
+ if (!service) throw new Error(`Service ${refName} is not registered`);
241
+ const loaded = await SignalContext.loadNested(valueRecord[key], service, field);
242
+ const resolved = await SignalContext.resolveReturn(loaded, {
243
+ signalContext,
244
+ returnRef: field.modelRef,
245
+ arrDepth: field.arrDepth,
246
+ registry,
247
+ live,
248
+ });
249
+ resolvedValue[key] = resolved;
250
+ }
251
+ }),
252
+ );
253
+ return resolvedValue;
254
+ }
255
+ static async loadNested(
256
+ value: unknown,
257
+ service: DatabaseService,
258
+ { arrDepth, nullable }: { arrDepth: number; nullable: boolean },
259
+ ): Promise<unknown> {
260
+ if (arrDepth === 0)
261
+ return await service.__load(String(value)).then((doc) => {
262
+ if (doc === null) {
263
+ if (nullable) return null;
264
+ else throw new Error(`Document ${value} is not found`);
265
+ } else return doc.toJSON();
266
+ });
267
+ if (arrDepth === 1)
268
+ return await service.__loadMany(value as string[]).then((docs) =>
269
+ docs.map((doc) => {
270
+ if (doc === null) {
271
+ if (nullable) return null;
272
+ else throw new Error(`Document ${value} is not found`);
273
+ } else return doc.toJSON();
274
+ }),
275
+ );
276
+ return await Promise.all(
277
+ (value as unknown[]).map(
278
+ async (v) => await SignalContext.loadNested(v, service, { arrDepth: arrDepth - 1, nullable }),
279
+ ),
280
+ );
281
+ }
282
+ getHttpContext<Appended = unknown>() {
283
+ if (this.transport !== "http") throw new Error("Transport is not http");
284
+ return this.ctx as HttpExecutionContext<Appended>;
285
+ }
286
+ getWebSocketContext<Appended = unknown>() {
287
+ if (this.transport !== "websocket") throw new Error("Transport is not websocket");
288
+ return this.ctx as WebSocketExecutionContext<Appended>;
289
+ }
290
+ getRoomId(key: string) {
291
+ if (this.transport !== "websocket") throw new Error("Transport is not websocket");
292
+ else if (this.endpointInfo.type !== "pubsub") throw new Error("Endpoint is not pubsub");
293
+ return `${key}${this.args.length ? "-" : ""}${this.args.join("-")}`;
294
+ }
295
+ getEnv() {
296
+ return this.#env;
297
+ }
298
+ }
299
+
300
+ export class HttpExecutionContext<Appended = unknown> {
301
+ req: Bun.BunRequest & Appended;
302
+ res = Response;
303
+ url: URL;
304
+ params: RuntimeRecord = {};
305
+ searchParams: RuntimeRecord = {};
306
+ body: RuntimeRecord = {};
307
+ constructor(req: Bun.BunRequest) {
308
+ this.req = req as Bun.BunRequest & Appended;
309
+ this.url = new URL(req.url);
310
+ }
311
+ async getArgs(endpointInfo: EndpointInfo): Promise<unknown[]> {
312
+ this.params = this.req.params;
313
+
314
+ const hasUploadArgs = endpointInfo.args.some((arg) => arg.type === "body" && arg.argRef === Upload);
315
+ if (endpointInfo.type === "mutation" && this.req.body) {
316
+ if (hasUploadArgs) {
317
+ const formData = await this.req.formData();
318
+ this.body = {};
319
+ for (const [key, value] of formData.entries()) {
320
+ const argInfo = endpointInfo.args.find((arg) => arg.name === key && arg.type === "body");
321
+ if (argInfo && argInfo.argRef === Upload) {
322
+ if (argInfo.arrDepth > 0) {
323
+ const values = Array.isArray(this.body[key]) ? this.body[key] : [];
324
+ values.push(value);
325
+ this.body[key] = values;
326
+ } else this.body[key] = value;
327
+ } else {
328
+ this.body[key] = value as string;
329
+ }
330
+ }
331
+ } else this.body = (await this.req.json()) as RuntimeRecord;
332
+ }
333
+
334
+ const args = endpointInfo.args.map((arg) => {
335
+ switch (arg.type) {
336
+ case "param":
337
+ return deserialize(arg.argRef, arg.arrDepth, this.params[arg.name], {
338
+ key: arg.name,
339
+ nullable: arg.option?.nullable,
340
+ });
341
+ case "body":
342
+ if (arg.argRef === Upload) return this.body[arg.name];
343
+ return deserialize(arg.argRef, arg.arrDepth, this.body[arg.name], {
344
+ key: arg.name,
345
+ nullable: arg.option?.nullable,
346
+ });
347
+ case "search": {
348
+ const value = arg.arrDepth ? this.url.searchParams.getAll(arg.name) : this.url.searchParams.get(arg.name);
349
+ const result = deserialize(arg.argRef, arg.arrDepth, value, {
350
+ key: arg.name,
351
+ nullable: arg.option?.nullable,
352
+ });
353
+ this.searchParams[arg.name] = result;
354
+ return result;
355
+ }
356
+ default:
357
+ return undefined;
358
+ }
359
+ });
360
+ return args;
361
+ }
362
+ makeResponse(result: unknown, endpointInfo: EndpointInfo) {
363
+ if (result instanceof Response) return result;
364
+ const value = serialize(endpointInfo.returns.returnRef, endpointInfo.returns.arrDepth, result, "object", {
365
+ nullable: endpointInfo.returns.nullable,
366
+ });
367
+ return this.res.json(value);
368
+ }
369
+ }
370
+
371
+ export type WebSocketEventType = "open" | "subscribe" | "unsubscribe" | "message" | "close";
372
+ export class WebSocketExecutionContext<Appended = unknown> {
373
+ ws: Bun.ServerWebSocket<Appended>;
374
+ data: unknown[];
375
+ roomId: string = "";
376
+ eventType: WebSocketEventType;
377
+ onDisconnect: Set<() => PromiseOrObject<void>> = new Set();
378
+ onUnsubscribe: Set<() => PromiseOrObject<void>> = new Set();
379
+ constructor(wsReq: WebSocketRequest) {
380
+ this.ws = wsReq.ws as Bun.ServerWebSocket<Appended>;
381
+ this.data = wsReq.data;
382
+ this.eventType = wsReq.eventType;
383
+ }
384
+ async getArgs(endpointInfo: EndpointInfo): Promise<unknown[]> {
385
+ const args = endpointInfo.args.map((arg, idx) => {
386
+ switch (arg.type) {
387
+ case "msg":
388
+ return deserialize(arg.argRef, arg.arrDepth, this.data[idx], {
389
+ key: arg.name,
390
+ nullable: arg.option?.nullable,
391
+ });
392
+ case "room":
393
+ return deserialize(arg.argRef, arg.arrDepth, this.data[idx], {
394
+ key: arg.name,
395
+ nullable: arg.option?.nullable,
396
+ });
397
+ default:
398
+ return undefined;
399
+ }
400
+ });
401
+ return args;
402
+ }
403
+ makeResponse(result: unknown, endpointInfo: EndpointInfo) {
404
+ return serialize(endpointInfo.returns.returnRef, endpointInfo.returns.arrDepth, result, "object", {
405
+ nullable: endpointInfo.returns.nullable,
406
+ }) as unknown as Response;
407
+ }
408
+ on(event: "disconnect" | "unsubscribe", handler: () => void) {
409
+ if (event === "disconnect") this.onDisconnect.add(handler);
410
+ else this.onUnsubscribe.add(handler);
411
+ }
412
+ off(event: "disconnect" | "unsubscribe", handler: () => void) {
413
+ if (event === "disconnect") this.onDisconnect.delete(handler);
414
+ else this.onUnsubscribe.delete(handler);
415
+ }
416
+ }
417
+
418
+ export class ResolveFieldContext {
419
+ signalContext: SignalContext | null;
420
+ internalInfo: InternalInfo<"resolveField">;
421
+ internal: Internal;
422
+ parent: unknown;
423
+ constructor(
424
+ parent: unknown,
425
+ {
426
+ signalContext,
427
+ internalInfo,
428
+ internal,
429
+ }: { signalContext: SignalContext | null; internalInfo: InternalInfo<"resolveField">; internal: Internal },
430
+ ) {
431
+ this.signalContext = signalContext;
432
+ this.internalInfo = internalInfo;
433
+ this.internal = internal;
434
+ this.parent = parent;
435
+ }
436
+ async exec() {
437
+ if (!this.internalInfo.execFn) throw new Error("Exec function is not set");
438
+ const internalArgs = await Promise.all(
439
+ this.internalInfo.internalArgs.map((arg) =>
440
+ this.signalContext ? (new arg.argRef().getArg(this.signalContext) ?? null) : null,
441
+ ),
442
+ );
443
+ const result = await this.internalInfo.execFn.call(this.internal, this.parent, ...internalArgs);
444
+ return result;
445
+ }
446
+ }
@@ -0,0 +1,82 @@
1
+ import type { EndpointCls } from "./endpoint";
2
+ import type { InternalCls } from "./internal";
3
+ import { FetchSerializer } from "./serializer";
4
+ import type { ServerSignalCls } from "./serverSignal";
5
+ import type { SliceCls } from "./slice";
6
+ import type { SerializedSignal } from "./types";
7
+
8
+ export class DatabaseSignal<
9
+ IntlCls extends InternalCls = InternalCls,
10
+ EndpCls extends EndpointCls = EndpointCls,
11
+ SlceCls extends SliceCls = SliceCls,
12
+ SrvrCls extends ServerSignalCls = ServerSignalCls,
13
+ > {
14
+ internal: IntlCls;
15
+ endpoint: EndpCls;
16
+ slice: SlceCls;
17
+ server: SrvrCls;
18
+ serializedSignal: SerializedSignal;
19
+
20
+ constructor(internal: IntlCls, endpoint: EndpCls, slice: SlceCls, server: SrvrCls) {
21
+ this.internal = internal;
22
+ this.endpoint = endpoint;
23
+ this.slice = slice;
24
+ this.server = server;
25
+ this.serializedSignal = FetchSerializer.serializeDatabaseSignal(slice, endpoint);
26
+ }
27
+ }
28
+
29
+ export class ServiceSignal<
30
+ IntlCls extends InternalCls = InternalCls,
31
+ EndpCls extends EndpointCls = EndpointCls,
32
+ SrvrCls extends ServerSignalCls = ServerSignalCls,
33
+ > {
34
+ internal: IntlCls;
35
+ endpoint: EndpCls;
36
+ server: SrvrCls;
37
+ serializedSignal: SerializedSignal;
38
+
39
+ constructor(internal: IntlCls, endpoint: EndpCls, server: SrvrCls) {
40
+ this.internal = internal;
41
+ this.endpoint = endpoint;
42
+ this.server = server;
43
+ this.serializedSignal = FetchSerializer.serializeServiceSignal(endpoint);
44
+ }
45
+ }
46
+
47
+ /** Registry for database and service signals used by routing and fetch serialization. */
48
+ export class SignalRegistry {
49
+ static readonly #database = new Map<string, DatabaseSignal<any, any, any, any>>();
50
+ static readonly #service = new Map<string, ServiceSignal<any, any, any>>();
51
+
52
+ static registerDatabase<
53
+ IntlCls extends InternalCls,
54
+ EndpCls extends EndpointCls,
55
+ SlceCls extends SliceCls,
56
+ SrvrCls extends ServerSignalCls,
57
+ >(
58
+ internal: IntlCls,
59
+ endpoint: EndpCls,
60
+ slice: SlceCls,
61
+ server: SrvrCls,
62
+ ): DatabaseSignal<IntlCls, EndpCls, SlceCls, SrvrCls> {
63
+ const databaseSignal = new DatabaseSignal(internal, endpoint, slice, server);
64
+ SignalRegistry.#database.set(internal.refName, databaseSignal);
65
+ return databaseSignal;
66
+ }
67
+ static getDatabase(refName: string) {
68
+ return SignalRegistry.#database.get(refName);
69
+ }
70
+ static registerService<IntlCls extends InternalCls, EndpCls extends EndpointCls, SrvrCls extends ServerSignalCls>(
71
+ internal: IntlCls,
72
+ endpoint: EndpCls,
73
+ server: SrvrCls,
74
+ ): ServiceSignal<IntlCls, EndpCls, SrvrCls> {
75
+ const serviceSignal = new ServiceSignal(internal, endpoint, server);
76
+ SignalRegistry.#service.set(internal.refName, serviceSignal);
77
+ return serviceSignal;
78
+ }
79
+ static getService(refName: string) {
80
+ return SignalRegistry.#service.get(refName);
81
+ }
82
+ }
@@ -0,0 +1,158 @@
1
+ import { Any, type Assign, type Cls, type MergeAllKeyOfObjects, SLICE_META } from "akanjs/base";
2
+ import { applyMixins } from "akanjs/common";
3
+ import type { DocumentModel, QueryOf } from "akanjs/constant";
4
+ import type { FilterInstance } from "akanjs/document";
5
+ import { type Adaptor, type AdaptorCls, dangerouslyAdapt, type ServiceModel } from "akanjs/service";
6
+ import type { Guard, GuardCls } from "./guard";
7
+ import { buildSlice, type SliceBuilder, type SliceInfo } from "./sliceInfo";
8
+
9
+ export interface Slice extends Adaptor {}
10
+
11
+ export type SliceCls<
12
+ SrvModule extends ServiceModel = ServiceModel,
13
+ SliceInfoObj extends { [key: string]: SliceInfo } = { [key: string]: SliceInfo },
14
+ > = AdaptorCls & {
15
+ baseName: SrvModule["srv"]["refName"];
16
+ srv: SrvModule;
17
+ [SLICE_META]: SliceInfoObj;
18
+ getGuards: GuardCls[];
19
+ cruGuards: GuardCls[];
20
+ };
21
+
22
+ interface RootSliceOption {
23
+ guards?: {
24
+ root?: Cls<Guard> | Cls<Guard>[];
25
+ get?: Cls<Guard> | Cls<Guard>[];
26
+ cru?: Cls<Guard> | Cls<Guard>[];
27
+ };
28
+ prefix?: string;
29
+ }
30
+
31
+ type ExtendSliceInfoObj<
32
+ SrvModule extends ServiceModel,
33
+ LibSlices extends SliceCls[],
34
+ _Input = NonNullable<SrvModule["cnst"]>["_Input"],
35
+ _Full = NonNullable<SrvModule["cnst"]>["_Full"],
36
+ _Light = NonNullable<SrvModule["cnst"]>["_Light"],
37
+ _Insight = NonNullable<SrvModule["cnst"]>["_Insight"],
38
+ _Filter extends FilterInstance = any,
39
+ _Merged = MergeAllKeyOfObjects<LibSlices, typeof SLICE_META>,
40
+ > = {
41
+ [K in keyof _Merged]: _Merged[K] extends SliceInfo<
42
+ any,
43
+ any,
44
+ any,
45
+ any,
46
+ any,
47
+ any,
48
+ infer Srvs,
49
+ infer ArgNames,
50
+ infer Args,
51
+ infer InternalArgs,
52
+ infer ServerArgs
53
+ >
54
+ ? SliceInfo<
55
+ SrvModule["srv"]["refName"],
56
+ _Input,
57
+ _Full,
58
+ _Light,
59
+ _Insight,
60
+ _Filter,
61
+ Srvs,
62
+ ArgNames,
63
+ Args,
64
+ InternalArgs,
65
+ ServerArgs
66
+ >
67
+ : never;
68
+ };
69
+
70
+ /** Builds database-backed slice APIs for list, insight, init, view, edit, create, update, and remove flows. */
71
+ export function slice<
72
+ SrvModule extends ServiceModel,
73
+ BuildSlice extends SliceBuilder<SrvModule>,
74
+ LibSlices extends SliceCls[],
75
+ _Input = NonNullable<SrvModule["cnst"]>["_Input"],
76
+ _Full = NonNullable<SrvModule["cnst"]>["_Full"],
77
+ _Light = NonNullable<SrvModule["cnst"]>["_Light"],
78
+ _Insight = NonNullable<SrvModule["cnst"]>["_Insight"],
79
+ _Filter extends FilterInstance = NonNullable<SrvModule["db"]>["_Filter"],
80
+ _Query = QueryOf<DocumentModel<_Full>>,
81
+ >(
82
+ srv: SrvModule,
83
+ option: RootSliceOption,
84
+ sliceBuilder: BuildSlice,
85
+ ...libSlices: LibSlices
86
+ ): SliceCls<
87
+ SrvModule,
88
+ Assign<
89
+ ReturnType<BuildSlice>,
90
+ LibSlices extends []
91
+ ? {
92
+ [""]: SliceInfo<
93
+ SrvModule["srv"]["refName"],
94
+ _Input,
95
+ _Full,
96
+ _Light,
97
+ _Insight,
98
+ _Filter,
99
+ SrvModule["srvMap"],
100
+ ["query"],
101
+ [_Query],
102
+ [],
103
+ [_Query]
104
+ >;
105
+ }
106
+ : ExtendSliceInfoObj<SrvModule, LibSlices>
107
+ >
108
+ > {
109
+ if (!srv.cnst || !srv.db) throw new Error("cnst and db are required");
110
+ const init = buildSlice(
111
+ srv.srv.refName,
112
+ srv.cnst.input,
113
+ srv.cnst.full,
114
+ srv.cnst.light,
115
+ srv.cnst.insight,
116
+ srv.db.filter,
117
+ );
118
+ const rootGuards = option.guards?.root
119
+ ? Array.isArray(option.guards.root)
120
+ ? option.guards.root
121
+ : [option.guards.root]
122
+ : [];
123
+ const getGuards = option.guards?.get
124
+ ? Array.isArray(option.guards.get)
125
+ ? option.guards.get
126
+ : [option.guards.get]
127
+ : [];
128
+ const cruGuards = option.guards?.cru
129
+ ? Array.isArray(option.guards.cru)
130
+ ? option.guards.cru
131
+ : [option.guards.cru]
132
+ : [];
133
+ const srvKeys = [
134
+ ...new Set([...Object.keys(srv.srvMap), ...libSlices.flatMap((libSlice) => Object.keys(libSlice.srv.srvMap))]),
135
+ ];
136
+ const sliceCls = class Slice extends dangerouslyAdapt(`${srv.srv.refName}Slice`, ({ service }) => ({
137
+ ...Object.fromEntries(srvKeys.map((srvRefName) => [srvRefName, service()])),
138
+ })) {
139
+ static baseName = srv.srv.refName;
140
+ static srv = srv;
141
+ static getGuards = getGuards;
142
+ static cruGuards = cruGuards;
143
+ static [SLICE_META] = Object.assign(
144
+ {
145
+ [""]: init({ guards: rootGuards })
146
+ .search<"query", object>("query", Any)
147
+ .exec((query) => query ?? {}),
148
+ },
149
+ sliceBuilder(init),
150
+ );
151
+ };
152
+ libSlices.forEach((libSlice) => {
153
+ Object.assign(sliceCls[SLICE_META], libSlice[SLICE_META]);
154
+ Object.assign(sliceCls.srv.srvMap, libSlice.srv.srvMap);
155
+ });
156
+ applyMixins(sliceCls, libSlices);
157
+ return sliceCls as any;
158
+ }