@nativemind108/core 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (181) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/LICENSE +289 -0
  3. package/NOTICE +8 -0
  4. package/README.md +67 -2
  5. package/dist/cjs/auth/apiKeys.d.ts +19 -0
  6. package/dist/cjs/auth/apiKeys.js +43 -0
  7. package/dist/cjs/auth/apiKeys.js.map +1 -0
  8. package/dist/cjs/auth/authService.d.ts +24 -0
  9. package/dist/cjs/auth/authService.js +46 -0
  10. package/dist/cjs/auth/authService.js.map +1 -0
  11. package/dist/cjs/auth/jwt.d.ts +42 -0
  12. package/dist/cjs/auth/jwt.js +82 -0
  13. package/dist/cjs/auth/jwt.js.map +1 -0
  14. package/dist/cjs/auth/principal.d.ts +11 -0
  15. package/dist/cjs/auth/principal.js +3 -0
  16. package/dist/cjs/auth/principal.js.map +1 -0
  17. package/dist/cjs/auth/routes.d.ts +4 -0
  18. package/dist/cjs/auth/routes.js +12 -0
  19. package/dist/cjs/auth/routes.js.map +1 -0
  20. package/dist/cjs/auth/types.d.ts +4 -0
  21. package/dist/cjs/auth/types.js +3 -0
  22. package/dist/cjs/auth/types.js.map +1 -0
  23. package/dist/cjs/config/env.d.ts +18 -0
  24. package/dist/cjs/config/env.js +82 -0
  25. package/dist/cjs/config/env.js.map +1 -0
  26. package/dist/cjs/config/errors.d.ts +4 -0
  27. package/dist/cjs/config/errors.js +13 -0
  28. package/dist/cjs/config/errors.js.map +1 -0
  29. package/dist/cjs/errors/apiError.d.ts +56 -0
  30. package/dist/cjs/errors/apiError.js +67 -0
  31. package/dist/cjs/errors/apiError.js.map +1 -0
  32. package/dist/cjs/http/cors.d.ts +14 -0
  33. package/dist/cjs/http/cors.js +42 -0
  34. package/dist/cjs/http/cors.js.map +1 -0
  35. package/dist/cjs/http/createApp.d.ts +42 -0
  36. package/dist/cjs/http/createApp.js +98 -0
  37. package/dist/cjs/http/createApp.js.map +1 -0
  38. package/dist/cjs/http/httpServer.d.ts +31 -0
  39. package/dist/cjs/http/httpServer.js +41 -0
  40. package/dist/cjs/http/httpServer.js.map +1 -0
  41. package/dist/cjs/http/shutdown.d.ts +5 -0
  42. package/dist/cjs/http/shutdown.js +43 -0
  43. package/dist/cjs/http/shutdown.js.map +1 -0
  44. package/dist/cjs/http/userAgent.d.ts +10 -0
  45. package/dist/cjs/http/userAgent.js +27 -0
  46. package/dist/cjs/http/userAgent.js.map +1 -0
  47. package/dist/cjs/index.d.ts +24 -0
  48. package/dist/cjs/index.js +42 -0
  49. package/dist/cjs/index.js.map +1 -0
  50. package/dist/cjs/log/logError.d.ts +1 -0
  51. package/dist/cjs/log/logError.js +12 -0
  52. package/dist/cjs/log/logError.js.map +1 -0
  53. package/dist/cjs/log/logger.d.ts +18 -0
  54. package/dist/cjs/log/logger.js +35 -0
  55. package/dist/cjs/log/logger.js.map +1 -0
  56. package/dist/cjs/log/redact.d.ts +6 -0
  57. package/dist/cjs/log/redact.js +37 -0
  58. package/dist/cjs/log/redact.js.map +1 -0
  59. package/dist/cjs/package.json +3 -0
  60. package/dist/cjs/util/fileUtils.d.ts +8 -0
  61. package/dist/cjs/util/fileUtils.js +49 -0
  62. package/dist/cjs/util/fileUtils.js.map +1 -0
  63. package/dist/cjs/util/misc.d.ts +7 -0
  64. package/dist/cjs/util/misc.js +36 -0
  65. package/dist/cjs/util/misc.js.map +1 -0
  66. package/dist/cjs/util/objUtils.d.ts +1 -0
  67. package/dist/cjs/util/objUtils.js +19 -0
  68. package/dist/cjs/util/objUtils.js.map +1 -0
  69. package/dist/cjs/ws/heartbeat.d.ts +12 -0
  70. package/dist/cjs/ws/heartbeat.js +40 -0
  71. package/dist/cjs/ws/heartbeat.js.map +1 -0
  72. package/dist/cjs/ws/sendToAll.d.ts +2 -0
  73. package/dist/cjs/ws/sendToAll.js +18 -0
  74. package/dist/cjs/ws/sendToAll.js.map +1 -0
  75. package/dist/cjs/ws/transaction.d.ts +4 -0
  76. package/dist/cjs/ws/transaction.js +20 -0
  77. package/dist/cjs/ws/transaction.js.map +1 -0
  78. package/dist/cjs/ws/wsServer.d.ts +18 -0
  79. package/dist/cjs/ws/wsServer.js +43 -0
  80. package/dist/cjs/ws/wsServer.js.map +1 -0
  81. package/dist/esm/auth/apiKeys.d.ts +20 -0
  82. package/dist/esm/auth/apiKeys.d.ts.map +1 -0
  83. package/dist/esm/auth/apiKeys.js +36 -0
  84. package/dist/esm/auth/apiKeys.js.map +1 -0
  85. package/dist/esm/auth/authService.d.ts +25 -0
  86. package/dist/esm/auth/authService.d.ts.map +1 -0
  87. package/dist/esm/auth/authService.js +42 -0
  88. package/dist/esm/auth/authService.js.map +1 -0
  89. package/dist/esm/auth/jwt.d.ts +43 -0
  90. package/dist/esm/auth/jwt.d.ts.map +1 -0
  91. package/dist/esm/auth/jwt.js +75 -0
  92. package/dist/esm/auth/jwt.js.map +1 -0
  93. package/dist/esm/auth/principal.d.ts +12 -0
  94. package/dist/esm/auth/principal.d.ts.map +1 -0
  95. package/dist/esm/auth/principal.js +2 -0
  96. package/dist/esm/auth/principal.js.map +1 -0
  97. package/dist/esm/auth/routes.d.ts +5 -0
  98. package/dist/esm/auth/routes.d.ts.map +1 -0
  99. package/dist/esm/auth/routes.js +9 -0
  100. package/dist/esm/auth/routes.js.map +1 -0
  101. package/dist/esm/auth/types.d.ts +5 -0
  102. package/dist/esm/auth/types.d.ts.map +1 -0
  103. package/dist/esm/auth/types.js +2 -0
  104. package/dist/esm/auth/types.js.map +1 -0
  105. package/dist/esm/config/env.d.ts +19 -0
  106. package/dist/esm/config/env.d.ts.map +1 -0
  107. package/dist/esm/config/env.js +79 -0
  108. package/dist/esm/config/env.js.map +1 -0
  109. package/dist/esm/config/errors.d.ts +5 -0
  110. package/dist/esm/config/errors.d.ts.map +1 -0
  111. package/dist/esm/config/errors.js +9 -0
  112. package/dist/esm/config/errors.js.map +1 -0
  113. package/dist/esm/errors/apiError.d.ts +57 -0
  114. package/dist/esm/errors/apiError.d.ts.map +1 -0
  115. package/dist/esm/errors/apiError.js +62 -0
  116. package/dist/esm/errors/apiError.js.map +1 -0
  117. package/dist/esm/http/cors.d.ts +15 -0
  118. package/dist/esm/http/cors.d.ts.map +1 -0
  119. package/dist/esm/http/cors.js +37 -0
  120. package/dist/esm/http/cors.js.map +1 -0
  121. package/dist/esm/http/createApp.d.ts +43 -0
  122. package/dist/esm/http/createApp.d.ts.map +1 -0
  123. package/dist/esm/http/createApp.js +90 -0
  124. package/dist/esm/http/createApp.js.map +1 -0
  125. package/dist/esm/http/httpServer.d.ts +32 -0
  126. package/dist/esm/http/httpServer.d.ts.map +1 -0
  127. package/dist/esm/http/httpServer.js +35 -0
  128. package/dist/esm/http/httpServer.js.map +1 -0
  129. package/dist/esm/http/shutdown.d.ts +6 -0
  130. package/dist/esm/http/shutdown.d.ts.map +1 -0
  131. package/dist/esm/http/shutdown.js +40 -0
  132. package/dist/esm/http/shutdown.js.map +1 -0
  133. package/dist/esm/http/userAgent.d.ts +11 -0
  134. package/dist/esm/http/userAgent.d.ts.map +1 -0
  135. package/dist/esm/http/userAgent.js +23 -0
  136. package/dist/esm/http/userAgent.js.map +1 -0
  137. package/dist/esm/index.d.ts +25 -0
  138. package/dist/esm/index.d.ts.map +1 -0
  139. package/dist/esm/index.js +26 -0
  140. package/dist/esm/index.js.map +1 -0
  141. package/dist/esm/log/logError.d.ts +2 -0
  142. package/dist/esm/log/logError.d.ts.map +1 -0
  143. package/dist/esm/log/logError.js +8 -0
  144. package/dist/esm/log/logError.js.map +1 -0
  145. package/dist/esm/log/logger.d.ts +19 -0
  146. package/dist/esm/log/logger.d.ts.map +1 -0
  147. package/dist/esm/log/logger.js +29 -0
  148. package/dist/esm/log/logger.js.map +1 -0
  149. package/dist/esm/log/redact.d.ts +7 -0
  150. package/dist/esm/log/redact.d.ts.map +1 -0
  151. package/dist/esm/log/redact.js +33 -0
  152. package/dist/esm/log/redact.js.map +1 -0
  153. package/dist/esm/util/fileUtils.d.ts +9 -0
  154. package/dist/esm/util/fileUtils.d.ts.map +1 -0
  155. package/dist/esm/util/fileUtils.js +45 -0
  156. package/dist/esm/util/fileUtils.js.map +1 -0
  157. package/dist/esm/util/misc.d.ts +8 -0
  158. package/dist/esm/util/misc.d.ts.map +1 -0
  159. package/dist/esm/util/misc.js +27 -0
  160. package/dist/esm/util/misc.js.map +1 -0
  161. package/dist/esm/util/objUtils.d.ts +2 -0
  162. package/dist/esm/util/objUtils.d.ts.map +1 -0
  163. package/dist/esm/util/objUtils.js +15 -0
  164. package/dist/esm/util/objUtils.js.map +1 -0
  165. package/dist/esm/ws/heartbeat.d.ts +13 -0
  166. package/dist/esm/ws/heartbeat.d.ts.map +1 -0
  167. package/dist/esm/ws/heartbeat.js +35 -0
  168. package/dist/esm/ws/heartbeat.js.map +1 -0
  169. package/dist/esm/ws/sendToAll.d.ts +3 -0
  170. package/dist/esm/ws/sendToAll.d.ts.map +1 -0
  171. package/dist/esm/ws/sendToAll.js +11 -0
  172. package/dist/esm/ws/sendToAll.js.map +1 -0
  173. package/dist/esm/ws/transaction.d.ts +5 -0
  174. package/dist/esm/ws/transaction.d.ts.map +1 -0
  175. package/dist/esm/ws/transaction.js +16 -0
  176. package/dist/esm/ws/transaction.js.map +1 -0
  177. package/dist/esm/ws/wsServer.d.ts +19 -0
  178. package/dist/esm/ws/wsServer.d.ts.map +1 -0
  179. package/dist/esm/ws/wsServer.js +39 -0
  180. package/dist/esm/ws/wsServer.js.map +1 -0
  181. package/package.json +63 -4
package/CHANGELOG.md ADDED
@@ -0,0 +1,8 @@
1
+ # Changelog
2
+
3
+ ## 1.0.0 — unreleased
4
+
5
+ - First release of `@nativemind108/core` (SDD `sdd-nativemind-backend-handmade`, 2026-11-14).
6
+ - Hand-written code of Andrey Bekhtold and Anton Dodonov (dilap-server, 2025) carried over with marked changes:
7
+ `httpServer` on fastify, secrets / `test/test` removed from `AuthService`, path traversal fixed in `getFileContent`,
8
+ JWT payload no longer logged by `createWebSocketServer`.
package/LICENSE ADDED
@@ -0,0 +1,289 @@
1
+ # ข้อตกลงสิทธิการใช้งาน NativeMindNONC (ประเทศไทย)
2
+
3
+ ### 1. ข้อกำหนดทั่วไป
4
+
5
+ ข้อตกลงนี้อยู่ภายใต้บังคับของพระราชบัญญัติลิขสิทธิ์ พ.ศ. 2537 และแก้ไขเพิ่มเติม รวมถึงประมวลกฎหมายแพ่งและพาณิชย์แห่งราชอาณาจักรไทย
6
+
7
+ ผู้ถือลิขสิทธิ์: บริษัทผู้พัฒนาซอฟต์แวร์
8
+
9
+ เครื่องหมายการค้าของผลิตภัณฑ์ได้รับการจดทะเบียนและถือครองโดยผู้ถือลิขสิทธิ์
10
+
11
+ ลิขสิทธิ์ © 2010-2025 ผู้ถือลิขสิทธิ์ สงวนลิขสิทธิ์
12
+
13
+ ### 2. เงื่อนไขการใช้งาน
14
+
15
+ การใช้งานโปรแกรมซอฟต์แวร์ ("ผลิตภัณฑ์") ถือว่าท่านยอมรับข้อกำหนดและเงื่อนไขตามข้อตกลงฉบับนี้ หากท่านไม่ยอมรับ โปรดหยุดใช้งานผลิตภัณฑ์โดยทันที
16
+
17
+ #### 2.1. การเผยแพร่ซอร์สโค้ด
18
+
19
+ เมื่อท่านใช้งานซอร์สโค้ดของผลิตภัณฑ์ ท่านมีหน้าที่:
20
+
21
+ - เผยแพร่ซอร์สโค้ดของท่านผ่าน GitHub โดยทำเป็น Fork ของ Repository อย่างเป็นทางการ
22
+ - ปรับปรุงให้เป็นปัจจุบันอยู่เสมอเพื่อสะท้อนการเปลี่ยนแปลงจากต้นฉบับ
23
+ - ระบุให้ชัดเจนว่าซอร์สโค้ดของท่านเป็น Fork ของ Repository ดั้งเดิม
24
+
25
+ #### 2.2. การเผยแพร่อัตโนมัติ
26
+
27
+ การเผยแพร่ทุกครั้งต้องดำเนินการผ่าน GitHub Actions เท่านั้น
28
+
29
+ #### 2.3. การให้เครดิต (Attribution)
30
+
31
+ เมื่อเผยแพร่ผลิตภัณฑ์ที่ดัดแปลงจากผลิตภัณฑ์ต้นฉบับ ท่านต้อง:
32
+
33
+ - ระบุเครดิตของผู้ถือลิขสิทธิ์พร้อมลิงก์ไปที่ Repository ดั้งเดิม
34
+ - แสดงลิงก์ไปยังข้อตกลงสิทธิ์ดั้งเดิม
35
+ - บันทึกการเปลี่ยนแปลงใน README ของ Repository ของท่าน
36
+
37
+ #### 2.4. ห้ามการใส่มัลแวร์
38
+
39
+ ห้ามอย่างเด็ดขาดที่จะเพิ่มมัลแวร์หรือรหัสอันตรายใด ๆ ลงในผลิตภัณฑ์
40
+
41
+ #### 2.5. ข้อจำกัดการใช้ชื่อและอินเทอร์เฟซ
42
+
43
+ ห้ามเผยแพร่แอปพลิเคชันในร้านค้าแอปใดๆ เช่น Google Play, App Store, F-Droid, Microsoft Store, Huawei AppGallery หรือแพลตฟอร์มอื่นใดด้วยชื่อหรือหน้าตาที่คล้ายกับผลิตภัณฑ์ต้นฉบับจนอาจทำให้เกิดความเข้าใจผิด
44
+
45
+ #### 2.6. การใช้งานเชิงพาณิชย์
46
+
47
+ **ฟรีสำหรับการใช้งานที่ไม่ใช่เชิงพาณิชย์**: ผลิตภัณฑ์นี้ฟรีสำหรับการใช้งานที่ไม่ใช่เชิงพาณิชย์ รวมถึง:
48
+ - สถาบันการศึกษา (โรงเรียน มหาวิทยาลัย วิทยาลัย)
49
+ - วัตถุประสงค์ทางการศึกษาและการฝึกอบรม
50
+ - การวิจัยและพัฒนาสำหรับโครงการที่ไม่ใช่เชิงพาณิชย์
51
+ - การเรียนรู้และการพัฒนาส่วนบุคคล
52
+
53
+ **การใช้งานเชิงพาณิชย์ต้องมีใบอนุญาต**: การใช้งานเชิงพาณิชย์ของผลิตภัณฑ์นี้ต้องได้รับอนุญาตเป็นลายลักษณ์อักษรจากผู้ถือลิขสิทธิ์ก่อนดำเนินการเชิงพาณิชย์ใดๆ รวมถึง:
54
+ - การขายหรือจำหน่ายเพื่อหากำไร
55
+ - การใช้งานในผลิตภัณฑ์หรือบริการเชิงพาณิชย์
56
+ - แอปพลิเคชันทางธุรกิจ
57
+ - กิจกรรมใดๆ ที่สร้างรายได้
58
+
59
+ #### 2.7. สิทธิของนักพัฒนาและโครงสร้างบริษัท
60
+
61
+ สิทธิทั้งหมดเป็นของนักพัฒนาที่เฉพาะเจาะจงซึ่งเป็นส่วนหนึ่งของบริษัทที่พัฒนาซอฟต์แวร์นี้ นักพัฒนาอาจ:
62
+ - นำเสนอโค้ดและผลงานในงานแสดงสินค้าและงานประชุม
63
+ - แสดงความสำเร็จทางเทคนิคของตนต่อสาธารณะ
64
+ - ใช้ผลงานของตนเพื่อพอร์ตโฟลิโอทางวิชาชีพและการพัฒนาอาชีพ
65
+
66
+ อย่างไรก็ตาม นักพัฒนาไม่สามารถ:
67
+ - ใช้โค้ดหรือผลงานเพื่อวัตถุประสงค์เชิงพาณิชย์ส่วนตัว
68
+ - อนุญาตให้ใช้ซอฟต์แวร์อย่างอิสระนอกเหนือจากโครงสร้างบริษัท
69
+ - โอนสิทธิเชิงพาณิชย์โดยไม่ได้รับอนุญาตจากบริษัท
70
+
71
+ การอนุญาตเชิงพาณิชย์ทั้งหมดต้องดำเนินการผ่านบริษัทที่จ้างนักพัฒนาเหล่านี้
72
+
73
+ #### 2.8. การเผยแพร่ภายใต้เงื่อนไขเดียวกัน (ShareAlike)
74
+
75
+ ผลงานที่สร้างจากผลิตภัณฑ์นี้ต้องถูกเผยแพร่ภายใต้ข้อตกลงสิทธิ์เดียวกันและในรูปแบบ Open Source ผ่านการ Fork จาก Repository ดั้งเดิม
76
+
77
+ ### 3. การใช้งานส่วนประกอบ Open Source
78
+
79
+ ผลิตภัณฑ์ประกอบด้วยส่วนประกอบ Open Source ที่ได้รับอนุญาตตามเงื่อนไขอื่นๆ การใช้งานผลิตภัณฑ์หมายถึงท่านยอมรับเงื่อนไขของแต่ละส่วนประกอบด้วย รายละเอียดระบุไว้ในไฟล์ LICENSE.md ที่แนบมาพร้อมผลิตภัณฑ์
80
+
81
+ ### 4. การปฏิเสธความรับผิด
82
+
83
+ ผลิตภัณฑ์นี้ให้บริการ "ตามสภาพ" โดยไม่มีการรับประกันใดๆ ทั้งสิ้น ไม่ว่าจะแจ้งชัดหรือโดยนัย รวมถึงการรับประกันด้านความเหมาะสมกับวัตถุประสงค์เฉพาะใดๆ และผู้ถือลิขสิทธิ์จะไม่รับผิดชอบต่อความเสียหายใดๆ อันเกิดจากการใช้งานผลิตภัณฑ์นี้
84
+
85
+ ### 5. การละเมิดข้อตกลง
86
+
87
+ ในกรณีที่มีการละเมิดข้อตกลงนี้ ผู้ถือลิขสิทธิ์มีสิทธิ์ขอให้หยุดเผยแพร่ผลิตภัณฑ์ และอาจดำเนินการทางกฎหมายหรือแจ้งไปยังร้านค้าแอปพลิเคชันเพื่อให้มีการลบหรือระงับการเผยแพร่ผลิตภัณฑ์ที่ละเมิด
88
+
89
+ ข้อพิพาทใดๆ จะต้องได้รับการตัดสินตามกฎหมายแห่งราชอาณาจักรไทย
90
+
91
+ ---
92
+
93
+ การใช้งานผลิตภัณฑ์หมายถึงท่านได้อ่าน เข้าใจ และยอมรับข้อกำหนดและเงื่อนไขทั้งหมดตามข้อตกลงนี้แล้ว
94
+
95
+ ---
96
+
97
+ ## Лицензионное соглашение (Российская Федерация)
98
+
99
+ ### 1. Общие положения
100
+
101
+ Настоящая лицензия регулируется нормами Гражданского кодекса Российской Федерации (часть IV, статьи 1225-1301) и иных применимых законодательных актов РФ.
102
+
103
+ Правообладатель: Компания-разработчик программного обеспечения
104
+
105
+ Товарный знак продукта зарегистрирован и принадлежит правообладателю.
106
+
107
+ © 2010-2025 Правообладатель. Все права защищены.
108
+
109
+ ### 2. Условия использования
110
+
111
+ Используя программный продукт ("Продукт"), вы подтверждаете согласие с условиями настоящей лицензии. В случае несогласия вы обязаны немедленно прекратить использование и распространение Продукта.
112
+
113
+ #### 2.1. Доступность исходного кода
114
+
115
+ При использовании исходного кода Продукта вы обязаны:
116
+
117
+ - Опубликовать производный код исключительно в виде публичного репозитория на платформе GitHub в виде форка официального репозитория
118
+ - Своевременно обновлять свой репозиторий, отражая изменения в официальных релизах
119
+ - Указывать в репозитории, что он является форком официального репозитория
120
+
121
+ #### 2.2. Автоматизация релизов
122
+
123
+ Все релизы Продукта должны осуществляться исключительно через GitHub Actions.
124
+
125
+ #### 2.3. Обязательная атрибуция
126
+
127
+ При распространении производного Продукта вы обязаны:
128
+
129
+ - Указывать автора и давать соответствующую ссылку на официальный репозиторий
130
+ - Размещать ссылку на оригинальную лицензию
131
+ - Документировать изменения, сделанные вами в README вашего репозитория
132
+
133
+ #### 2.4. Запрет вредоносного ПО
134
+
135
+ Категорически запрещается встраивать любое вредоносное программное обеспечение (вирусы, трояны и т.п.).
136
+
137
+ #### 2.5. Ограничения на использование имени и интерфейса
138
+
139
+ Запрещается публикация производных продуктов под названием или с пользовательским интерфейсом, сходным до степени смешения с оригинальным продуктом, на любых площадках распространения программного обеспечения (например, Google Play, App Store, RuStore, NashStore, AppGallery, VK Play и других площадках).
140
+
141
+ #### 2.6. Некоммерческое использование
142
+
143
+ **Бесплатно для некоммерческого использования**: Данный продукт бесплатен для некоммерческого использования, включая:
144
+ - Образовательные учреждения (школы, университеты, колледжи)
145
+ - Образовательные и обучающие цели
146
+ - Исследования и разработки для некоммерческих проектов
147
+ - Личное обучение и развитие
148
+
149
+ **Коммерческое использование требует лицензии**: Использование Продукта в коммерческих целях (продажа, реклама, иные коммерческие операции) допускается исключительно после письменного согласия правообладателя.
150
+
151
+ #### 2.7. Права разработчиков и структура компании
152
+
153
+ Все права принадлежат конкретным разработчикам, которые входят в состав компании, разрабатывающей данное программное обеспечение. Разработчики могут:
154
+ - Представлять код и результаты работы на выставках и конференциях
155
+ - Демонстрировать свои технические достижения публично
156
+ - Использовать свою работу для профессионального портфолио и развития карьеры
157
+
158
+ Однако разработчики не могут:
159
+ - Использовать код или результаты работы для личных коммерческих целей
160
+ - Лицензировать программное обеспечение независимо вне структуры компании
161
+ - Передавать коммерческие права без разрешения компании
162
+
163
+ Все коммерческое лицензирование должно проводиться через компанию, которая нанимает этих разработчиков.
164
+
165
+ #### 2.8. Условие аналогичного распространения (ShareAlike)
166
+
167
+ Любое изменение, адаптация или создание производных работ на основе Продукта должно распространяться исключительно на условиях настоящей лицензии и с открытым исходным кодом через форк официального репозитория.
168
+
169
+ ### 3. Использование компонентов с открытым исходным кодом
170
+
171
+ Продукт содержит компоненты с открытым исходным кодом, лицензируемые отдельно. Пользуясь Продуктом, вы принимаете условия лицензий каждого компонента. Подробности указаны в файле LICENSE.md, входящем в комплект поставки.
172
+
173
+ ### 4. Ответственность сторон
174
+
175
+ Продукт предоставляется «как есть», без каких-либо гарантий, явных или подразумеваемых, в том числе гарантий пригодности для определённых целей и отсутствия нарушений прав третьих лиц. Правообладатель не несёт ответственности за убытки, возникающие вследствие использования или невозможности использования Продукта.
176
+
177
+ ### 5. Нарушение условий лицензии
178
+
179
+ При нарушении условий настоящей лицензии правообладатель вправе требовать прекращения распространения Продукта, а также обратиться в суд или обратиться с жалобой в соответствующие площадки распространения программного обеспечения для удаления или ограничения доступа к нарушающим продуктам.
180
+
181
+ Споры разрешаются в порядке, установленном законодательством Российской Федерации.
182
+
183
+ ---
184
+
185
+ Используя Продукт, вы подтверждаете, что прочитали, поняли и полностью принимаете условия настоящей лицензии.
186
+
187
+ ---
188
+
189
+ ## License Agreement (English)
190
+
191
+ ### 1. General Provisions
192
+
193
+ This agreement is governed by copyright laws and intellectual property regulations of the jurisdiction where the software is used.
194
+
195
+ Copyright Holder: Software Development Company
196
+
197
+ The product trademark is registered and owned by the copyright holder.
198
+
199
+ Copyright © 2010-2025 Copyright Holder. All rights reserved.
200
+
201
+ ### 2. Usage Terms
202
+
203
+ By using the software product ("Product"), you agree to accept the terms and conditions of this agreement. If you do not agree, please stop using the product immediately.
204
+
205
+ #### 2.1. Source Code Publication
206
+
207
+ When using the source code of the Product, you are obligated to:
208
+
209
+ - Publish your source code through GitHub by creating a Fork of the official Repository
210
+ - Keep it updated to reflect changes from the original
211
+ - Clearly indicate that your source code is a Fork of the original Repository
212
+
213
+ #### 2.2. Automatic Publication
214
+
215
+ All publications must be conducted through GitHub Actions only.
216
+
217
+ #### 2.3. Attribution
218
+
219
+ When publishing products derived from the original Product, you must:
220
+
221
+ - Credit the copyright holder with a link to the original Repository
222
+ - Display a link to the original license agreement
223
+ - Record changes in the README of your Repository
224
+
225
+ #### 2.4. Malware Prohibition
226
+
227
+ It is strictly prohibited to add malware or any dangerous code to the product.
228
+
229
+ #### 2.5. Name and Interface Usage Restrictions
230
+
231
+ It is prohibited to publish applications in any app store (Google Play, App Store, F-Droid, Microsoft Store, Huawei AppGallery, or other platforms) with names or interfaces similar to the original product that may cause confusion.
232
+
233
+ #### 2.6. Commercial Use
234
+
235
+ **Free for Non-Commercial Use**: This product is free for non-commercial use including:
236
+ - Educational institutions (schools, universities, colleges)
237
+ - Educational and training purposes
238
+ - Research and development for non-commercial projects
239
+ - Personal learning and development
240
+
241
+ **Commercial Use Requires License**: Commercial use of this product requires a written license agreement from the copyright holder before any commercial activities including:
242
+ - Selling or distributing for profit
243
+ - Using in commercial products or services
244
+ - Business applications
245
+ - Any revenue-generating activities
246
+
247
+ #### 2.7. Developer Rights and Company Structure
248
+
249
+ All rights belong to specific developers who are part of the company that develops this software. Developers may:
250
+ - Present code and work results at exhibitions and conferences
251
+ - Showcase their technical achievements publicly
252
+ - Use their work for professional portfolio and career development
253
+
254
+ However, developers cannot:
255
+ - Use the code or work results for personal commercial purposes
256
+ - License the software independently outside the company structure
257
+ - Transfer commercial rights without company authorization
258
+
259
+ All commercial licensing must be conducted through the company that employs these developers.
260
+
261
+ #### 2.8. License Standardization
262
+
263
+ This license may become a standard and other companies may copy the license text for their own use, similar to MIT, Apache, or GPL licenses.
264
+
265
+ #### 2.9. ShareAlike Requirement
266
+
267
+ Any work created from this product must be published under the same license terms and in open source format through a Fork from the original Repository.
268
+
269
+ ### 3. Open Source Components
270
+
271
+ The Product includes Open Source components licensed under different terms. Using the Product means you accept the terms of each component as well. Details are specified in the LICENSE.md file included with the product.
272
+
273
+ ### 4. Disclaimer
274
+
275
+ This product is provided "as is" without any warranties, whether express or implied, including warranties of merchantability, fitness for a particular purpose, and non-infringement. The copyright holder shall not be liable for any damages arising from the use of this product.
276
+
277
+ ### 5. License Violations
278
+
279
+ In case of violation of this agreement, the copyright holder has the right to request cessation of product distribution and may take legal action or notify app stores to remove or suspend distribution of violating products.
280
+
281
+ Any disputes shall be resolved according to the laws of the jurisdiction where the copyright holder is incorporated.
282
+
283
+ ---
284
+
285
+ Using the Product means you have read, understood, and accepted all terms and conditions of this agreement.
286
+
287
+ ---
288
+
289
+ # NativeMindNONC License Agreement
package/NOTICE ADDED
@@ -0,0 +1,8 @@
1
+ @nativemind108/core
2
+ Copyright (c) NativeMind. Licensed under the NativeMindNONC License (see LICENSE).
3
+
4
+ Hand-written code by people is marked in the source with "written by <Author> (without AI), <date>".
5
+ Code written with AI tools is marked "generated by <tool> (<model>), <date>".
6
+
7
+ Contains code by Andrey Bekhtold (dilap-server, 2025-03 … 2025-05, without AI) and
8
+ Anton Dodonov (dilap-server, 2025-04, without AI).
package/README.md CHANGED
@@ -1,3 +1,68 @@
1
- # Temporary Holding Version
1
+ # @nativemind108/core
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Backend core of NativeMind services (Node ≥ 22.12, ESM and CommonJS): configuration from env, structured logging with
4
+ secret redaction, the `{error:{code,message,details,requestId}}` envelope, a fastify HTTP server, a WebSocket server
5
+ with JWT handshake and heartbeat, JWT/JWKS and API keys.
6
+
7
+ Not to be confused with the Dart package `nativemind_core` (Flutter UI, pub.dev).
8
+
9
+ ## Hand-written code
10
+
11
+ The heart of the package is hand-written code of the DealApp backend (dilap-server, 2025), carried over with minimal,
12
+ marked changes:
13
+
14
+ | Export | Author |
15
+ |---|---|
16
+ | `httpServer.start` | Anton Dodonov (without AI), 2025-04-28 — moved from express + tsoa to fastify |
17
+ | `createWebSocketServer`, `startHeartbeat`, `HEARTBEAT_INTERVAL`, `transactionDeduper`, `isPingMessage`, `sendToAll` | Andrey Bekhtold (without AI), 2025-03 … 04 |
18
+ | `parseAgent` (`App/1.0 (build: 1) Device (Platform OS)`) | Andrey Bekhtold (without AI), 2025-03-30 |
19
+ | `AuthService` (login / refresh) | Anton Dodonov (without AI), 2025-04-28 — hard-coded secrets and `test/test` removed |
20
+ | `getPropertiesFrom`, `getFileContent`, `logError`, `JwtPayload` | Andrey Bekhtold (without AI), 2025 — path traversal in `getFileContent` fixed |
21
+
22
+ Every declaration carries its authorship line in the source (`written by …` / `generated by …`).
23
+
24
+ ## API service in a few lines
25
+
26
+ ```ts
27
+ import { createApp, httpServer, onShutdown, readEnv } from '@nativemind108/core';
28
+
29
+ const env = readEnv();
30
+ const app = await createApp({ name: 'demo-api', cors: { origins: env.list('CORS_ORIGINS') }, rawBody: true });
31
+ await httpServer.start(app, {
32
+ port: env.int('PORT', 3000),
33
+ swagger: { info: { title: 'Demo API', version: '1.0.0' } }, // Swagger UI at /docs
34
+ routes: (a) => { a.get('/v1/hello', async () => ({ data: 'hi' })); },
35
+ });
36
+ onShutdown(() => app.close());
37
+ ```
38
+
39
+ ## WebSocket with Andrey's heartbeat
40
+
41
+ ```ts
42
+ import { createWebSocketServer, startHeartbeat, transactionDeduper, isPingMessage } from '@nativemind108/core';
43
+
44
+ createWebSocketServer(app.server, {
45
+ jwtSecret: env.required('JWT_KEY'), // HS256 device JWT in `Authorization: Bearer …`
46
+ onConnection: (ws, req, wss, payload) => {
47
+ startHeartbeat(ws); // ping every 7 s, terminate when no pong / message
48
+ const fresh = transactionDeduper();
49
+ ws.on('message', (m) => {
50
+ const text = m.toString();
51
+ if (isPingMessage(text)) return;
52
+ const request = JSON.parse(text);
53
+ if (!fresh(request.transaction)) return; // duplicate request (Android client)
54
+ // …
55
+ });
56
+ },
57
+ });
58
+ ```
59
+
60
+ ## Modules
61
+
62
+ - `readEnv()` — `str/int/bool/list/url/oneOf/required`, `<NAME>_FILE` secrets, alias names.
63
+ - `createLogger()`, `getLogger()`, `redact()`.
64
+ - `ApiError`, `Errors`, `errorBody()`.
65
+ - `createApp()` — request id, CORS allowlist, error and 404 envelopes, raw body, `/health`; `httpServer.start()`; `onShutdown()`.
66
+ - `createJwtIssuer()` (ES256 / EdDSA / HS256), `jwksRoute()`, `jwksVerifier()`, `apiKeyFormat()`, `bearerOf()`, `Principal`.
67
+
68
+ License: NativeMindNONC (see LICENSE).
@@ -0,0 +1,19 @@
1
+ export interface ApiKeyFormat {
2
+ /** New key: the secret is shown once; store `id` + `hash` only. */
3
+ generate(env?: string): {
4
+ key: string;
5
+ id: string;
6
+ hash: string;
7
+ };
8
+ /** `{ env, id }` of a well-formed key, else null. */
9
+ parse(key: string): {
10
+ env: string;
11
+ id: string;
12
+ } | null;
13
+ hash(key: string): string;
14
+ readonly pattern: RegExp;
15
+ }
16
+ /** Keys `<prefix>_<env>_<id:8>_<secret:32>` (env e.g. live | mock | test), stored as sha256. */
17
+ export declare function apiKeyFormat(prefix: string, envs?: readonly string[]): ApiKeyFormat;
18
+ /** `Authorization: Bearer <token>` → token (or null). */
19
+ export declare function bearerOf(header: string | string[] | undefined): string | null;
@@ -0,0 +1,43 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.apiKeyFormat = apiKeyFormat;
7
+ exports.bearerOf = bearerOf;
8
+ const node_crypto_1 = __importDefault(require("node:crypto"));
9
+ const misc_js_1 = require("../util/misc.js");
10
+ const ALNUM = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
11
+ function alnum(n) {
12
+ const bytes = node_crypto_1.default.randomBytes(n);
13
+ let s = '';
14
+ for (let i = 0; i < n; i++)
15
+ s += ALNUM[bytes[i] % ALNUM.length];
16
+ return s;
17
+ }
18
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
19
+ /** Keys `<prefix>_<env>_<id:8>_<secret:32>` (env e.g. live | mock | test), stored as sha256. */
20
+ function apiKeyFormat(prefix, envs = ['live', 'mock']) {
21
+ const pattern = new RegExp(`^${prefix}_(${envs.join('|')})_([A-Za-z0-9]{8})_([A-Za-z0-9]{32})$`);
22
+ return {
23
+ pattern,
24
+ generate(env = envs[0]) {
25
+ const id = alnum(8);
26
+ const key = `${prefix}_${env}_${id}_${alnum(32)}`;
27
+ return { key, id, hash: (0, misc_js_1.sha256)(key) };
28
+ },
29
+ parse(key) {
30
+ const m = pattern.exec(key);
31
+ return m ? { env: m[1], id: m[2] } : null;
32
+ },
33
+ hash: (key) => (0, misc_js_1.sha256)(key),
34
+ };
35
+ }
36
+ // generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
37
+ /** `Authorization: Bearer <token>` → token (or null). */
38
+ function bearerOf(header) {
39
+ const h = Array.isArray(header) ? header[0] : header;
40
+ const m = h ? /^Bearer\s+(\S+)$/i.exec(h.trim()) : null;
41
+ return m ? m[1] : null;
42
+ }
43
+ //# sourceMappingURL=apiKeys.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"apiKeys.js","sourceRoot":"","sources":["../../../src/auth/apiKeys.ts"],"names":[],"mappings":";;;;;AAuBA,oCAeC;AAID,4BAIC;AA9CD,8DAAiC;AACjC,6CAAyC;AAYzC,MAAM,KAAK,GAAG,gEAAgE,CAAC;AAC/E,SAAS,KAAK,CAAC,CAAS;IACtB,MAAM,KAAK,GAAG,qBAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACjE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,kFAAkF;AAClF,gGAAgG;AAChG,SAAgB,YAAY,CAAC,MAAc,EAAE,OAA0B,CAAC,MAAM,EAAE,MAAM,CAAC;IACrF,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,IAAI,MAAM,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;IACjG,OAAO;QACL,OAAO;QACP,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,CAAE;YACrB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACpB,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAClD,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,IAAA,gBAAM,EAAC,GAAG,CAAC,EAAE,CAAC;QACxC,CAAC;QACD,KAAK,CAAC,GAAG;YACP,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC5B,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9C,CAAC;QACD,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,gBAAM,EAAC,GAAG,CAAC;KAC3B,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,yDAAyD;AACzD,SAAgB,QAAQ,CAAC,MAAqC;IAC5D,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACrD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1B,CAAC"}
@@ -0,0 +1,24 @@
1
+ export interface AuthResponse {
2
+ access_token: string;
3
+ refresh_token?: string;
4
+ }
5
+ export interface AuthServiceOptions {
6
+ /** Секрет access-токена (было зашито 'your-secret-key'). */
7
+ secret: string;
8
+ /** Секрет refresh-токена (было зашито 'your-refresh-secret-key'). */
9
+ refreshSecret: string;
10
+ /** Проверка логина и пароля (было: username === 'test' && password === 'test'). */
11
+ verifyCredentials: (username: string, password: string) => Promise<boolean> | boolean;
12
+ /** Время жизни access, по умолчанию '1h' (как было). */
13
+ accessTtl?: string;
14
+ /** Время жизни refresh, по умолчанию '7d' (как было). */
15
+ refreshTtl?: string;
16
+ }
17
+ export declare class AuthService {
18
+ private readonly opts;
19
+ private readonly jwtSecret;
20
+ private readonly jwtRefreshSecret;
21
+ constructor(opts: AuthServiceOptions);
22
+ login(username: string, password: string): Promise<AuthResponse>;
23
+ refresh(refreshToken: string): Promise<AuthResponse>;
24
+ }
@@ -0,0 +1,46 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.AuthService = void 0;
4
+ const jose_1 = require("jose");
5
+ const errors_js_1 = require("../config/errors.js");
6
+ const apiError_js_1 = require("../errors/apiError.js");
7
+ const enc = (s) => new TextEncoder().encode(s);
8
+ // written by Anton Dodonov (without AI), 2025-04-28
9
+ // changed by Claude (Opus 5.5), 2026-11-14: СЕКРЕТЫ 'your-secret-key' / 'your-refresh-secret-key' и логин test/test убраны —
10
+ // секреты и проверка учётных данных передаются в конструктор; TTL — параметры с прежними умолчаниями (1h / 7d);
11
+ // jsonwebtoken → jose (HS256); ошибки — ApiError(401) вместо Error; SDD sdd-nativemind-backend-handmade
12
+ class AuthService {
13
+ opts;
14
+ jwtSecret;
15
+ jwtRefreshSecret;
16
+ constructor(opts) {
17
+ this.opts = opts;
18
+ if (!opts.secret || !opts.refreshSecret)
19
+ throw new errors_js_1.ConfigError('AuthService: secret and refreshSecret are required.');
20
+ this.jwtSecret = enc(opts.secret);
21
+ this.jwtRefreshSecret = enc(opts.refreshSecret);
22
+ }
23
+ async login(username, password) {
24
+ if (await this.opts.verifyCredentials(username, password)) {
25
+ const accessToken = await new jose_1.SignJWT({ username }).setProtectedHeader({ alg: 'HS256' }).setIssuedAt().setExpirationTime(this.opts.accessTtl ?? '1h').sign(this.jwtSecret);
26
+ const refreshToken = await new jose_1.SignJWT({ username }).setProtectedHeader({ alg: 'HS256' }).setIssuedAt().setExpirationTime(this.opts.refreshTtl ?? '7d').sign(this.jwtRefreshSecret);
27
+ return { access_token: accessToken, refresh_token: refreshToken };
28
+ }
29
+ else {
30
+ throw new apiError_js_1.ApiError(401, 'INVALID_CREDENTIALS', 'Invalid credentials');
31
+ }
32
+ }
33
+ async refresh(refreshToken) {
34
+ try {
35
+ const { payload } = await (0, jose_1.jwtVerify)(refreshToken, this.jwtRefreshSecret);
36
+ const decoded = payload;
37
+ const accessToken = await new jose_1.SignJWT({ username: decoded.username }).setProtectedHeader({ alg: 'HS256' }).setIssuedAt().setExpirationTime(this.opts.accessTtl ?? '1h').sign(this.jwtSecret);
38
+ return { access_token: accessToken };
39
+ }
40
+ catch (err) {
41
+ throw new apiError_js_1.ApiError(401, 'INVALID_REFRESH_TOKEN', 'Invalid refresh token');
42
+ }
43
+ }
44
+ }
45
+ exports.AuthService = AuthService;
46
+ //# sourceMappingURL=authService.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"authService.js","sourceRoot":"","sources":["../../../src/auth/authService.ts"],"names":[],"mappings":";;;AAAA,+BAA0C;AAC1C,mDAAkD;AAClD,uDAAiD;AAsBjD,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAEvD,oDAAoD;AACpD,6HAA6H;AAC7H,kHAAkH;AAClH,0GAA0G;AAC1G,MAAa,WAAW;IAIO;IAHZ,SAAS,CAAa;IACtB,gBAAgB,CAAa;IAE9C,YAA6B,IAAwB;QAAxB,SAAI,GAAJ,IAAI,CAAoB;QACnD,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,MAAM,IAAI,uBAAW,CAAC,qDAAqD,CAAC,CAAC;QACtH,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,gBAAgB,GAAG,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAClD,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,QAAgB;QACnD,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC1D,MAAM,WAAW,GAAG,MAAM,IAAI,cAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,kBAAkB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3K,MAAM,YAAY,GAAG,MAAM,IAAI,cAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,kBAAkB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACpL,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,sBAAQ,CAAC,GAAG,EAAE,qBAAqB,EAAE,qBAAqB,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,YAAoB;QACvC,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAA,gBAAS,EAAC,YAAY,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACzE,MAAM,OAAO,GAAG,OAA+B,CAAC;YAChD,MAAM,WAAW,GAAG,MAAM,IAAI,cAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,kBAAkB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7L,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;QACvC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,sBAAQ,CAAC,GAAG,EAAE,uBAAuB,EAAE,uBAAuB,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;CACF;AA9BD,kCA8BC"}
@@ -0,0 +1,42 @@
1
+ import { type JWK, type JWTPayload } from 'jose';
2
+ export type JwtAlg = 'ES256' | 'EdDSA' | 'HS256';
3
+ export interface JwtIssuerOptions {
4
+ alg: JwtAlg;
5
+ /** PEM PKCS#8 private key (ES256 / EdDSA). */
6
+ privateKey?: string;
7
+ /** PEM SPKI public key; derived from the private key when omitted. */
8
+ publicKey?: string;
9
+ /** HS256 secret. */
10
+ secret?: string;
11
+ issuer?: string;
12
+ audience?: string | string[];
13
+ /** Default lifetime, seconds or a jose time span ('15m'). */
14
+ ttl?: number | string;
15
+ /** `kid` in the header and the JWKS (default: SHA-256 thumbprint prefix of the public key). */
16
+ kid?: string;
17
+ }
18
+ export interface JwtIssuer {
19
+ readonly alg: JwtAlg;
20
+ sign(claims: JWTPayload, opts?: {
21
+ subject?: string;
22
+ ttl?: number | string;
23
+ audience?: string | string[];
24
+ }): Promise<string>;
25
+ /** Verifies signature, issuer, audience, expiry; ApiError(401 TOKEN_EXPIRED | UNAUTHENTICATED) on failure. */
26
+ verify<T extends JWTPayload = JWTPayload>(token: string, opts?: {
27
+ audience?: string | string[];
28
+ }): Promise<T>;
29
+ /** Public JWKS (empty for HS256). */
30
+ jwks(): Promise<{
31
+ keys: JWK[];
32
+ }>;
33
+ }
34
+ export declare function createJwtIssuer(opts: JwtIssuerOptions): Promise<JwtIssuer>;
35
+ /** Verifier against a JWKS (remote URL, e.g. the API's `/.well-known/jwks.json`, or a local set). MCP pre-verifies OAuth JWTs with it. */
36
+ export declare function jwksVerifier(source: string | {
37
+ keys: JWK[];
38
+ }, opts?: {
39
+ issuer?: string;
40
+ audience?: string | string[];
41
+ algorithms?: JwtAlg[];
42
+ }): <T extends JWTPayload = JWTPayload>(token: string) => Promise<T>;