@cbnventures/nova 0.28.0 → 0.30.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 (440) hide show
  1. package/build/package.json +23 -9
  2. package/build/src/cli/generate/docker-image/index.d.ts +9 -0
  3. package/build/src/cli/generate/docker-image/index.d.ts.map +1 -0
  4. package/build/src/cli/generate/docker-image/index.js +189 -0
  5. package/build/src/cli/generate/docker-image/index.js.map +1 -0
  6. package/build/src/cli/generate/github/issue-template.d.ts +1 -0
  7. package/build/src/cli/generate/github/issue-template.d.ts.map +1 -1
  8. package/build/src/cli/generate/github/issue-template.js +35 -18
  9. package/build/src/cli/generate/github/issue-template.js.map +1 -1
  10. package/build/src/cli/generate/github/workflows-blueprint.d.ts.map +1 -1
  11. package/build/src/cli/generate/github/workflows-blueprint.js +11 -2
  12. package/build/src/cli/generate/github/workflows-blueprint.js.map +1 -1
  13. package/build/src/cli/generate/must-haves/read-me.d.ts.map +1 -1
  14. package/build/src/cli/generate/must-haves/read-me.js +55 -22
  15. package/build/src/cli/generate/must-haves/read-me.js.map +1 -1
  16. package/build/src/cli/index.js +183 -19
  17. package/build/src/cli/index.js.map +1 -1
  18. package/build/src/cli/recipe/package-json/normalize-modules.d.ts.map +1 -1
  19. package/build/src/cli/recipe/package-json/normalize-modules.js +1 -0
  20. package/build/src/cli/recipe/package-json/normalize-modules.js.map +1 -1
  21. package/build/src/cli/recipe/read-me/update-badges.d.ts.map +1 -1
  22. package/build/src/cli/recipe/read-me/update-badges.js +0 -4
  23. package/build/src/cli/recipe/read-me/update-badges.js.map +1 -1
  24. package/build/src/cli/scaffold/app/android.d.ts +6 -0
  25. package/build/src/cli/scaffold/app/android.d.ts.map +1 -0
  26. package/build/src/cli/scaffold/app/android.js +60 -0
  27. package/build/src/cli/scaffold/app/android.js.map +1 -0
  28. package/build/src/cli/scaffold/app/apple.d.ts +5 -0
  29. package/build/src/cli/scaffold/app/apple.d.ts.map +1 -0
  30. package/build/src/cli/scaffold/app/apple.js +13 -0
  31. package/build/src/cli/scaffold/app/apple.js.map +1 -0
  32. package/build/src/cli/scaffold/app/astro.d.ts +6 -0
  33. package/build/src/cli/scaffold/app/astro.d.ts.map +1 -0
  34. package/build/src/cli/scaffold/app/astro.js +127 -0
  35. package/build/src/cli/scaffold/app/astro.js.map +1 -0
  36. package/build/src/cli/scaffold/app/cloudflare-workers.d.ts +5 -0
  37. package/build/src/cli/scaffold/app/cloudflare-workers.d.ts.map +1 -0
  38. package/build/src/cli/scaffold/app/cloudflare-workers.js +13 -0
  39. package/build/src/cli/scaffold/app/cloudflare-workers.js.map +1 -0
  40. package/build/src/cli/scaffold/app/discord-bot.d.ts +5 -0
  41. package/build/src/cli/scaffold/app/discord-bot.d.ts.map +1 -0
  42. package/build/src/cli/scaffold/app/discord-bot.js +31 -0
  43. package/build/src/cli/scaffold/app/discord-bot.js.map +1 -0
  44. package/build/src/cli/scaffold/app/docker-image.d.ts +6 -0
  45. package/build/src/cli/scaffold/app/docker-image.d.ts.map +1 -0
  46. package/build/src/cli/scaffold/app/docker-image.js +91 -0
  47. package/build/src/cli/scaffold/app/docker-image.js.map +1 -0
  48. package/build/src/cli/scaffold/app/expressjs.d.ts.map +1 -1
  49. package/build/src/cli/scaffold/app/expressjs.js +24 -1
  50. package/build/src/cli/scaffold/app/expressjs.js.map +1 -1
  51. package/build/src/cli/scaffold/app/nextjs.d.ts +2 -1
  52. package/build/src/cli/scaffold/app/nextjs.d.ts.map +1 -1
  53. package/build/src/cli/scaffold/app/nextjs.js +42 -1
  54. package/build/src/cli/scaffold/app/nextjs.js.map +1 -1
  55. package/build/src/cli/scaffold/app/vite.d.ts +2 -1
  56. package/build/src/cli/scaffold/app/vite.d.ts.map +1 -1
  57. package/build/src/cli/scaffold/app/vite.js +129 -2
  58. package/build/src/cli/scaffold/app/vite.js.map +1 -1
  59. package/build/src/cli/scaffold/docs/docusaurus.d.ts.map +1 -1
  60. package/build/src/cli/scaffold/docs/docusaurus.js +94 -4
  61. package/build/src/cli/scaffold/docs/docusaurus.js.map +1 -1
  62. package/build/src/cli/scaffold/package/github-action.d.ts +5 -0
  63. package/build/src/cli/scaffold/package/github-action.d.ts.map +1 -0
  64. package/build/src/cli/scaffold/package/github-action.js +14 -0
  65. package/build/src/cli/scaffold/package/github-action.js.map +1 -0
  66. package/build/src/cli/scaffold/package/homebridge.d.ts +6 -0
  67. package/build/src/cli/scaffold/package/homebridge.d.ts.map +1 -0
  68. package/build/src/cli/scaffold/package/homebridge.js +56 -0
  69. package/build/src/cli/scaffold/package/homebridge.js.map +1 -0
  70. package/build/src/cli/scaffold/package/node-cli.d.ts +5 -0
  71. package/build/src/cli/scaffold/package/node-cli.d.ts.map +1 -0
  72. package/build/src/cli/scaffold/package/node-cli.js +13 -0
  73. package/build/src/cli/scaffold/package/node-cli.js.map +1 -0
  74. package/build/src/cli/scaffold/package/pfsense.d.ts +5 -0
  75. package/build/src/cli/scaffold/package/pfsense.d.ts.map +1 -0
  76. package/build/src/cli/scaffold/package/pfsense.js +15 -0
  77. package/build/src/cli/scaffold/package/pfsense.js.map +1 -0
  78. package/build/src/cli/scaffold/starter/base.d.ts.map +1 -1
  79. package/build/src/cli/scaffold/starter/base.js +4 -8
  80. package/build/src/cli/scaffold/starter/base.js.map +1 -1
  81. package/build/src/cli/utility/changelog.d.ts.map +1 -1
  82. package/build/src/cli/utility/changelog.js +30 -8
  83. package/build/src/cli/utility/changelog.js.map +1 -1
  84. package/build/src/cli/utility/{initialize.d.ts → configure.d.ts} +5 -4
  85. package/build/src/cli/utility/configure.d.ts.map +1 -0
  86. package/build/src/cli/utility/{initialize.js → configure.js} +202 -27
  87. package/build/src/cli/utility/configure.js.map +1 -0
  88. package/build/src/cli/utility/transpile.d.ts +2 -4
  89. package/build/src/cli/utility/transpile.d.ts.map +1 -1
  90. package/build/src/cli/utility/transpile.js +14 -72
  91. package/build/src/cli/utility/transpile.js.map +1 -1
  92. package/build/src/lib/nova-config.d.ts +1 -0
  93. package/build/src/lib/nova-config.d.ts.map +1 -1
  94. package/build/src/lib/nova-config.js +121 -4
  95. package/build/src/lib/nova-config.js.map +1 -1
  96. package/build/src/lib/regex.d.ts +16 -0
  97. package/build/src/lib/regex.d.ts.map +1 -1
  98. package/build/src/lib/regex.js +19 -3
  99. package/build/src/lib/regex.js.map +1 -1
  100. package/build/src/lib/scaffold.d.ts +5 -3
  101. package/build/src/lib/scaffold.d.ts.map +1 -1
  102. package/build/src/lib/scaffold.js +276 -60
  103. package/build/src/lib/scaffold.js.map +1 -1
  104. package/build/src/lib/transpile.d.ts +3 -0
  105. package/build/src/lib/transpile.d.ts.map +1 -0
  106. package/build/src/lib/transpile.js +117 -0
  107. package/build/src/lib/transpile.js.map +1 -0
  108. package/build/src/presets/eslint/fw-astro.d.ts.map +1 -1
  109. package/build/src/presets/eslint/fw-astro.js +33 -3
  110. package/build/src/presets/eslint/fw-astro.js.map +1 -1
  111. package/build/src/presets/eslint/fw-docusaurus.d.ts.map +1 -1
  112. package/build/src/presets/eslint/fw-docusaurus.js +55 -3
  113. package/build/src/presets/eslint/fw-docusaurus.js.map +1 -1
  114. package/build/src/presets/eslint/fw-expressjs.d.ts.map +1 -1
  115. package/build/src/presets/eslint/fw-expressjs.js +1 -2
  116. package/build/src/presets/eslint/fw-expressjs.js.map +1 -1
  117. package/build/src/presets/eslint/fw-nextjs.d.ts.map +1 -1
  118. package/build/src/presets/eslint/fw-nextjs.js +64 -3
  119. package/build/src/presets/eslint/fw-nextjs.js.map +1 -1
  120. package/build/src/presets/eslint/fw-react.d.ts +4 -0
  121. package/build/src/presets/eslint/fw-react.d.ts.map +1 -0
  122. package/build/src/presets/eslint/fw-react.js +40 -0
  123. package/build/src/presets/eslint/fw-react.js.map +1 -0
  124. package/build/src/presets/eslint/fw-svelte.d.ts +4 -0
  125. package/build/src/presets/eslint/fw-svelte.d.ts.map +1 -0
  126. package/build/src/presets/eslint/fw-svelte.js +21 -0
  127. package/build/src/presets/eslint/fw-svelte.js.map +1 -0
  128. package/build/src/presets/eslint/fw-vue.d.ts +4 -0
  129. package/build/src/presets/eslint/fw-vue.d.ts.map +1 -0
  130. package/build/src/presets/eslint/fw-vue.js +17 -0
  131. package/build/src/presets/eslint/fw-vue.js.map +1 -0
  132. package/build/src/presets/eslint/index.d.ts +3 -0
  133. package/build/src/presets/eslint/index.d.ts.map +1 -1
  134. package/build/src/presets/eslint/index.js +3 -0
  135. package/build/src/presets/eslint/index.js.map +1 -1
  136. package/build/src/presets/eslint/lang-javascript.js +1 -1
  137. package/build/src/presets/eslint/lang-javascript.js.map +1 -1
  138. package/build/src/presets/eslint/runtime-browser.d.ts.map +1 -1
  139. package/build/src/presets/eslint/runtime-browser.js +15 -1
  140. package/build/src/presets/eslint/runtime-browser.js.map +1 -1
  141. package/build/src/presets/eslint/runtime-cloudflare-workers.d.ts.map +1 -1
  142. package/build/src/presets/eslint/runtime-cloudflare-workers.js +11 -2
  143. package/build/src/presets/eslint/runtime-cloudflare-workers.js.map +1 -1
  144. package/build/src/presets/eslint/runtime-edge.d.ts.map +1 -1
  145. package/build/src/presets/eslint/runtime-edge.js +13 -1
  146. package/build/src/presets/eslint/runtime-edge.js.map +1 -1
  147. package/build/src/presets/eslint/runtime-node.d.ts.map +1 -1
  148. package/build/src/presets/eslint/runtime-node.js +5 -0
  149. package/build/src/presets/eslint/runtime-node.js.map +1 -1
  150. package/build/src/presets/eslint/runtime-service-worker.d.ts.map +1 -1
  151. package/build/src/presets/eslint/runtime-service-worker.js +13 -1
  152. package/build/src/presets/eslint/runtime-service-worker.js.map +1 -1
  153. package/build/src/presets/eslint/runtime-web-worker.d.ts.map +1 -1
  154. package/build/src/presets/eslint/runtime-web-worker.js +13 -1
  155. package/build/src/presets/eslint/runtime-web-worker.js.map +1 -1
  156. package/build/src/presets/eslint/tool-vite.d.ts.map +1 -1
  157. package/build/src/presets/eslint/tool-vite.js +15 -2
  158. package/build/src/presets/eslint/tool-vite.js.map +1 -1
  159. package/build/src/presets/tsconfig/dx-essentials.json +0 -2
  160. package/build/src/presets/tsconfig/fw-astro.json +2 -2
  161. package/build/src/presets/tsconfig/fw-docusaurus.json +1 -2
  162. package/build/src/presets/tsconfig/fw-expressjs.json +2 -7
  163. package/build/src/presets/tsconfig/fw-nextjs.json +6 -1
  164. package/build/src/presets/tsconfig/fw-react.json +14 -0
  165. package/build/src/presets/tsconfig/fw-svelte.json +15 -0
  166. package/build/src/presets/tsconfig/fw-vue.json +14 -0
  167. package/build/src/presets/tsconfig/role-app.json +9 -0
  168. package/build/src/presets/tsconfig/role-config.json +9 -0
  169. package/build/src/presets/tsconfig/role-scripts.json +11 -0
  170. package/build/src/presets/tsconfig/role-source.json +9 -0
  171. package/build/src/presets/tsconfig/role-tests.json +9 -0
  172. package/build/src/presets/tsconfig/runtime-cloudflare-workers.json +1 -2
  173. package/build/src/presets/tsconfig/tool-vite.json +2 -2
  174. package/build/src/rules/eslint/index.d.ts +1 -0
  175. package/build/src/rules/eslint/index.d.ts.map +1 -1
  176. package/build/src/rules/eslint/index.js +1 -0
  177. package/build/src/rules/eslint/index.js.map +1 -1
  178. package/build/src/rules/eslint/jsdoc/require-jsdoc-hierarchy.js +1 -1
  179. package/build/src/rules/eslint/jsdoc/require-jsdoc-hierarchy.js.map +1 -1
  180. package/build/src/rules/eslint/jsdoc/require-jsdoc-param-name.d.ts.map +1 -1
  181. package/build/src/rules/eslint/jsdoc/require-jsdoc-param-name.js +12 -1
  182. package/build/src/rules/eslint/jsdoc/require-jsdoc-param-name.js.map +1 -1
  183. package/build/src/rules/eslint/nova-rules.d.ts +4 -0
  184. package/build/src/rules/eslint/nova-rules.d.ts.map +1 -0
  185. package/build/src/rules/eslint/nova-rules.js +487 -0
  186. package/build/src/rules/eslint/nova-rules.js.map +1 -0
  187. package/build/src/types/cli/generate/docker-image/index.d.ts +102 -0
  188. package/build/src/types/cli/generate/github/issue-template.d.ts +36 -9
  189. package/build/src/types/cli/generate/must-haves/read-me.d.ts +10 -8
  190. package/build/src/types/cli/index.d.ts +2 -0
  191. package/build/src/types/cli/recipe/read-me/update-badges.d.ts +1 -1
  192. package/build/src/types/cli/scaffold/app/android.d.ts +40 -0
  193. package/build/src/types/cli/scaffold/app/apple.d.ts +19 -0
  194. package/build/src/types/cli/scaffold/app/astro.d.ts +46 -0
  195. package/build/src/types/cli/scaffold/app/cloudflare-workers.d.ts +24 -0
  196. package/build/src/types/cli/scaffold/app/discord-bot.d.ts +21 -0
  197. package/build/src/types/cli/scaffold/app/docker-image.d.ts +44 -0
  198. package/build/src/types/cli/scaffold/app/expressjs.d.ts +3 -0
  199. package/build/src/types/cli/scaffold/app/nextjs.d.ts +12 -0
  200. package/build/src/types/cli/scaffold/app/vite.d.ts +34 -0
  201. package/build/src/types/cli/scaffold/docs/docusaurus.d.ts +21 -1
  202. package/build/src/types/cli/scaffold/package/github-action.d.ts +19 -0
  203. package/build/src/types/cli/scaffold/package/homebridge.d.ts +41 -0
  204. package/build/src/types/cli/scaffold/package/node-cli.d.ts +19 -0
  205. package/build/src/types/cli/scaffold/package/pfsense.d.ts +19 -0
  206. package/build/src/types/cli/utility/changelog.d.ts +6 -0
  207. package/build/src/types/cli/utility/configure.d.ts +2631 -0
  208. package/build/src/types/cli/utility/transpile.d.ts +13 -79
  209. package/build/src/types/lib/nova-config.d.ts +51 -2
  210. package/build/src/types/lib/regex.d.ts +57 -0
  211. package/build/src/types/lib/scaffold.d.ts +199 -13
  212. package/build/src/types/lib/transpile.d.ts +167 -0
  213. package/build/src/types/presets/eslint/fw-docusaurus.d.ts +23 -2
  214. package/build/src/types/presets/eslint/fw-nextjs.d.ts +37 -2
  215. package/build/src/types/presets/eslint/fw-react.d.ts +9 -0
  216. package/build/src/types/presets/eslint/fw-svelte.d.ts +5 -0
  217. package/build/src/types/presets/eslint/fw-vue.d.ts +5 -0
  218. package/build/src/types/rules/eslint/jsdoc/require-jsdoc-hierarchy.d.ts +3 -3
  219. package/build/src/types/rules/eslint/jsdoc/require-jsdoc-param-name.d.ts +2 -0
  220. package/build/src/types/rules/eslint/nova-rules.d.ts +10 -0
  221. package/build/src/types/shared.d.ts +119 -3
  222. package/build/src/types/tests/cli/generate/docker-image.test.d.ts +43 -0
  223. package/build/src/types/tests/cli/generate/github/issue-template.test.d.ts +6 -6
  224. package/build/src/types/tests/cli/generate/github/workflows-blueprint-publish-parity.test.d.ts +22 -0
  225. package/build/src/types/tests/cli/generate/must-haves/read-me.test.d.ts +16 -0
  226. package/build/src/types/tests/cli/index.test.d.ts +72 -22
  227. package/build/src/types/tests/cli/recipe/package-json/normalize-modules.test.d.ts +19 -0
  228. package/build/src/types/tests/cli/scaffold/app/cloudflare-workers.test.d.ts +85 -0
  229. package/build/src/types/tests/cli/scaffold/app/expressjs.test.d.ts +21 -0
  230. package/build/src/types/tests/cli/utility/changelog.test.d.ts +8 -0
  231. package/build/src/types/tests/cli/utility/configure.test.d.ts +346 -0
  232. package/build/src/types/tests/cli/utility/transpile.test.d.ts +23 -0
  233. package/build/src/types/tests/lib/nova-config.test.d.ts +54 -7
  234. package/build/src/types/tests/lib/scaffold.test.d.ts +28 -4
  235. package/build/src/types/tests/rules/eslint/nova-rules.test.d.ts +45 -0
  236. package/build/src/types/tests/scaffold-output-contract.test.d.ts +48 -0
  237. package/build/src/types/tests/scaffold-template-source.test.d.ts +25 -0
  238. package/build/src/types/tests/scaffold-version-drift.test.d.ts +18 -6
  239. package/build/templates/generators/docker-image/astro-node/Dockerfile +27 -0
  240. package/build/templates/generators/docker-image/astro-node/compose.yml +12 -0
  241. package/build/templates/generators/docker-image/background-service/compose.yml +10 -0
  242. package/build/templates/generators/docker-image/container-native/Dockerfile +10 -0
  243. package/build/templates/generators/docker-image/container-native/compose.yml +8 -0
  244. package/build/templates/generators/docker-image/http-service/compose.yml +11 -0
  245. package/build/templates/generators/docker-image/nextjs-standalone/Dockerfile +26 -0
  246. package/build/templates/generators/docker-image/nextjs-standalone/compose.yml +12 -0
  247. package/build/templates/generators/docker-image/node/Dockerfile +24 -0
  248. package/build/templates/generators/docker-image/static-site/Dockerfile +18 -0
  249. package/build/templates/generators/docker-image/static-site/compose.yml +8 -0
  250. package/build/templates/generators/github/workflows/publish/targets/cloudflare-pages-docusaurus.yml +5 -2
  251. package/build/templates/generators/github/workflows/publish/targets/github-action.yml +2 -1
  252. package/build/templates/generators/must-haves/agent-conventions/conventions/typescript.md +1 -1
  253. package/build/templates/scaffold/app/android/eslint.config.mts +41 -0
  254. package/build/templates/scaffold/app/android/package.json +33 -0
  255. package/build/templates/scaffold/app/android/scripts/run-gradle.mjs +48 -0
  256. package/build/templates/scaffold/app/android/tests/project.test.ts +24 -0
  257. package/build/templates/scaffold/app/android/tsconfig.scripts.json +17 -0
  258. package/build/templates/scaffold/app/android/tsconfig.tests.json +18 -0
  259. package/build/templates/scaffold/app/android/vitest.config.mts +15 -0
  260. package/build/templates/scaffold/app/apple/Sources/App.swift +10 -0
  261. package/build/templates/scaffold/app/apple/Sources/ContentView.swift +20 -0
  262. package/build/templates/scaffold/app/apple/Tests/AppTests.swift +10 -0
  263. package/build/templates/scaffold/app/apple/package.json +26 -0
  264. package/build/templates/scaffold/app/apple/project.yml +47 -0
  265. package/build/templates/scaffold/app/astro/eslint.config.mts +69 -0
  266. package/build/templates/scaffold/app/astro/package.json +38 -0
  267. package/build/templates/scaffold/app/astro/src/pages/index.astro +18 -0
  268. package/build/templates/scaffold/app/astro/tests/project.test.ts +24 -0
  269. package/build/templates/scaffold/app/astro/tsconfig.astro.json +18 -0
  270. package/build/templates/scaffold/app/astro/tsconfig.config.json +20 -0
  271. package/build/templates/scaffold/app/astro/tsconfig.tests.json +17 -0
  272. package/build/templates/scaffold/app/astro/vitest.config.mts +18 -0
  273. package/build/templates/scaffold/app/cloudflare-workers/eslint.config.mts +42 -0
  274. package/build/templates/scaffold/app/{workers → cloudflare-workers}/package.json +12 -2
  275. package/build/templates/scaffold/app/cloudflare-workers/src/index.ts +30 -0
  276. package/build/templates/scaffold/app/cloudflare-workers/src/types/index.d.ts +19 -0
  277. package/build/templates/scaffold/app/cloudflare-workers/tests/project.test.ts +24 -0
  278. package/build/templates/scaffold/app/cloudflare-workers/tsconfig.config.json +17 -0
  279. package/build/templates/scaffold/app/cloudflare-workers/tsconfig.tests.json +20 -0
  280. package/build/templates/scaffold/app/cloudflare-workers/tsconfig.worker.json +16 -0
  281. package/build/templates/scaffold/app/cloudflare-workers/vitest.config.mts +18 -0
  282. package/build/templates/scaffold/app/discord-bot/eslint.config.mts +42 -0
  283. package/build/templates/scaffold/app/discord-bot/package.json +38 -0
  284. package/build/templates/scaffold/app/discord-bot/src/index.ts +39 -0
  285. package/build/templates/scaffold/app/discord-bot/tests/project.test.ts +24 -0
  286. package/build/templates/scaffold/app/discord-bot/tsconfig.config.json +17 -0
  287. package/build/templates/scaffold/app/discord-bot/tsconfig.source.json +22 -0
  288. package/build/templates/scaffold/app/discord-bot/tsconfig.tests.json +18 -0
  289. package/build/templates/scaffold/app/discord-bot/vitest.config.mts +18 -0
  290. package/build/templates/scaffold/app/docker-image/eslint.config.mts +41 -0
  291. package/build/templates/scaffold/app/docker-image/package.json +33 -0
  292. package/build/templates/scaffold/app/docker-image/tests/project.test.ts +24 -0
  293. package/build/templates/scaffold/app/docker-image/tsconfig.config.json +17 -0
  294. package/build/templates/scaffold/app/docker-image/tsconfig.tests.json +17 -0
  295. package/build/templates/scaffold/app/docker-image/vitest.config.mts +15 -0
  296. package/build/templates/scaffold/app/express/eslint.config.mts +44 -0
  297. package/build/templates/scaffold/app/express/package.json +11 -3
  298. package/build/templates/scaffold/app/express/src/index.ts +22 -1
  299. package/build/templates/scaffold/app/express/tests/project.test.ts +24 -0
  300. package/build/templates/scaffold/app/express/tsconfig.config.json +17 -0
  301. package/build/templates/scaffold/app/express/tsconfig.source.json +23 -0
  302. package/build/templates/scaffold/app/express/tsconfig.tests.json +18 -0
  303. package/build/templates/scaffold/app/express/vitest.config.mts +18 -0
  304. package/build/templates/scaffold/app/nextjs/eslint.config.mts +68 -0
  305. package/build/templates/scaffold/app/nextjs/next.config.mjs +11 -1
  306. package/build/templates/scaffold/app/nextjs/package.json +10 -2
  307. package/build/templates/scaffold/app/nextjs/src/app/layout.tsx +31 -7
  308. package/build/templates/scaffold/app/nextjs/src/app/page.tsx +15 -1
  309. package/build/templates/scaffold/app/nextjs/src/types/app/layout.d.ts +25 -0
  310. package/build/templates/scaffold/app/nextjs/src/types/app/page.d.ts +8 -0
  311. package/build/templates/scaffold/app/nextjs/tests/project.test.ts +24 -0
  312. package/build/templates/scaffold/app/nextjs/tsconfig.config.json +20 -0
  313. package/build/templates/scaffold/app/nextjs/tsconfig.json +24 -22
  314. package/build/templates/scaffold/app/nextjs/tsconfig.tests.json +17 -0
  315. package/build/templates/scaffold/app/nextjs/vitest.config.mts +18 -0
  316. package/build/templates/scaffold/app/vite/eslint.config.mts +70 -0
  317. package/build/templates/scaffold/app/vite/package.json +9 -3
  318. package/build/templates/scaffold/app/vite/tests/project.test.ts +24 -0
  319. package/build/templates/scaffold/app/vite/vite.config.mts +9 -1
  320. package/build/templates/scaffold/app/vite/vitest.config.mts +18 -0
  321. package/build/templates/scaffold/docs/docusaurus/docusaurus.config.ts +23 -5
  322. package/build/templates/scaffold/docs/docusaurus/eslint.config.mts +69 -0
  323. package/build/templates/scaffold/docs/docusaurus/package.json +4 -2
  324. package/build/templates/scaffold/docs/docusaurus/sidebars.ts +9 -3
  325. package/build/templates/scaffold/docs/docusaurus/src/tests/frontmatter.test.ts +1 -1
  326. package/build/templates/scaffold/docs/docusaurus/src/tests/link.test.ts +1 -1
  327. package/build/templates/scaffold/docs/docusaurus/src/tests/markdown-table.test.ts +1 -1
  328. package/build/templates/scaffold/docs/docusaurus/src/tests/terminology.test.ts +1 -1
  329. package/build/templates/scaffold/docs/docusaurus/src/tests/type-declarations.test.ts +1 -1
  330. package/build/templates/scaffold/docs/docusaurus/tsconfig.json +7 -1
  331. package/build/templates/scaffold/docs/docusaurus/vitest.config.mts +10 -1
  332. package/build/templates/scaffold/docs/docusaurus/vitest.setup.ts +1 -1
  333. package/build/templates/scaffold/package/github-action/eslint.config.mts +42 -0
  334. package/build/templates/scaffold/package/github-action/package.json +41 -0
  335. package/build/templates/scaffold/package/github-action/src/index.ts +9 -0
  336. package/build/templates/scaffold/package/github-action/src/run.test.ts +15 -0
  337. package/build/templates/scaffold/package/github-action/src/run.ts +45 -0
  338. package/build/templates/scaffold/package/github-action/src/types/run.d.ts +17 -0
  339. package/build/templates/scaffold/package/github-action/tsconfig.config.json +17 -0
  340. package/build/templates/scaffold/package/github-action/tsconfig.json +22 -0
  341. package/build/templates/scaffold/package/github-action/tsconfig.tests.json +18 -0
  342. package/build/templates/scaffold/package/github-action/vitest.config.mts +18 -0
  343. package/build/templates/scaffold/package/github-action-root/action.yml +15 -0
  344. package/build/templates/scaffold/package/homebridge/config.schema.json +18 -0
  345. package/build/templates/scaffold/package/homebridge/eslint.config.mts +48 -0
  346. package/build/templates/scaffold/package/homebridge/package.json +47 -0
  347. package/build/templates/scaffold/package/homebridge/src/index.ts +26 -0
  348. package/build/templates/scaffold/package/homebridge/src/platform.ts +88 -0
  349. package/build/templates/scaffold/package/homebridge/src/types/index.d.ts +10 -0
  350. package/build/templates/scaffold/package/homebridge/src/types/platform.d.ts +38 -0
  351. package/build/templates/scaffold/package/homebridge/tests/project.test.ts +24 -0
  352. package/build/templates/scaffold/package/homebridge/tsconfig.config.json +17 -0
  353. package/build/templates/scaffold/package/homebridge/tsconfig.source.json +25 -0
  354. package/build/templates/scaffold/package/homebridge/tsconfig.tests.json +18 -0
  355. package/build/templates/scaffold/package/homebridge/vitest.config.mts +18 -0
  356. package/build/templates/scaffold/package/node-cli/eslint.config.mts +49 -0
  357. package/build/templates/scaffold/package/node-cli/package.json +44 -0
  358. package/build/templates/scaffold/package/node-cli/src/index.test.ts +15 -0
  359. package/build/templates/scaffold/package/node-cli/src/index.ts +5 -0
  360. package/build/templates/scaffold/package/node-cli/src/program.ts +30 -0
  361. package/build/templates/scaffold/package/node-cli/tsconfig.config.json +17 -0
  362. package/build/templates/scaffold/package/node-cli/tsconfig.source.json +22 -0
  363. package/build/templates/scaffold/package/node-cli/tsconfig.tests.json +18 -0
  364. package/build/templates/scaffold/package/node-cli/vitest.config.mts +18 -0
  365. package/build/templates/scaffold/package/pfsense/eslint.config.mts +53 -0
  366. package/build/templates/scaffold/package/pfsense/package.json +41 -0
  367. package/build/templates/scaffold/package/pfsense/port/Makefile.template +39 -0
  368. package/build/templates/scaffold/package/pfsense/port/files/pkg-deinstall.in +3 -0
  369. package/build/templates/scaffold/package/pfsense/port/files/pkg-install.in +7 -0
  370. package/build/templates/scaffold/package/pfsense/port/files/usr/local/pkg/[__WORKSPACE_NAME__].inc +78 -0
  371. package/build/templates/scaffold/package/pfsense/port/files/usr/local/pkg/[__WORKSPACE_NAME__].xml +68 -0
  372. package/build/templates/scaffold/package/pfsense/port/files/usr/local/sbin/[__WORKSPACE_NAME__] +21 -0
  373. package/build/templates/scaffold/package/pfsense/port/files/usr/local/share/pfSense-pkg-[__WORKSPACE_IDENTIFIER__]/info.xml +9 -0
  374. package/build/templates/scaffold/package/pfsense/port/pkg-descr +3 -0
  375. package/build/templates/scaffold/package/pfsense/port/pkg-plist +4 -0
  376. package/build/templates/scaffold/package/pfsense/scripts/build-package.sh +72 -0
  377. package/build/templates/scaffold/package/pfsense/scripts/check-package.mjs +92 -0
  378. package/build/templates/scaffold/package/pfsense/scripts/regex.mjs +9 -0
  379. package/build/templates/scaffold/package/pfsense/scripts/stage-package.mjs +135 -0
  380. package/build/templates/scaffold/package/pfsense/tests/project.test.ts +24 -0
  381. package/build/templates/scaffold/package/pfsense/tsconfig.scripts.json +17 -0
  382. package/build/templates/scaffold/package/pfsense/tsconfig.tests.json +18 -0
  383. package/build/templates/scaffold/package/pfsense/vitest.config.mts +15 -0
  384. package/build/templates/scaffold/starter/base/eslint.config.mts +68 -0
  385. package/build/templates/scaffold/starter/base/tests/dotenv.test.ts +12 -0
  386. package/build/templates/scaffold/starter/base/tests/project.test.ts +24 -0
  387. package/build/templates/scaffold/starter/base/tests/setup.ts +16 -0
  388. package/build/templates/scaffold/starter/base/tsconfig.config.json +17 -0
  389. package/build/templates/scaffold/starter/base/tsconfig.tests.json +17 -0
  390. package/build/templates/scaffold/starter/base/vitest.config.mts +21 -0
  391. package/build/templates/scaffold-options/app/astro/cloudflare/astro.config.mjs +18 -0
  392. package/build/templates/scaffold-options/app/astro/node/astro.config.mjs +20 -0
  393. package/build/templates/scaffold-options/app/astro/static/astro.config.mjs +16 -0
  394. package/build/templates/scaffold-options/app/vite/framework/react/config/eslint-framework.mts +3 -0
  395. package/build/templates/scaffold-options/app/vite/framework/react/config/framework-plugins.ts +3 -0
  396. package/build/templates/scaffold-options/app/vite/framework/react/src/app.tsx +13 -0
  397. package/build/templates/scaffold-options/app/vite/framework/react/src/main.ts +18 -0
  398. package/build/templates/scaffold-options/app/vite/framework/react/tsconfig.json +26 -0
  399. package/build/templates/scaffold-options/app/vite/framework/svelte/config/eslint-framework.mts +3 -0
  400. package/build/templates/scaffold-options/app/vite/framework/svelte/config/framework-plugins.ts +3 -0
  401. package/build/templates/scaffold-options/app/vite/framework/svelte/src/app.svelte +5 -0
  402. package/build/templates/scaffold-options/app/vite/framework/svelte/src/main.ts +19 -0
  403. package/build/templates/scaffold-options/app/vite/framework/svelte/src/vite-env.d.ts +3 -0
  404. package/build/templates/scaffold-options/app/vite/framework/svelte/svelte.config.js +1 -0
  405. package/build/templates/scaffold-options/app/vite/framework/svelte/tsconfig.json +25 -0
  406. package/build/templates/scaffold-options/app/vite/framework/vanilla/config/eslint-framework.mts +1 -0
  407. package/build/templates/scaffold-options/app/vite/framework/vanilla/config/framework-plugins.ts +1 -0
  408. package/build/templates/scaffold-options/app/vite/framework/vanilla/src/main.ts +13 -0
  409. package/build/templates/scaffold-options/app/vite/framework/vanilla/tsconfig.json +23 -0
  410. package/build/templates/scaffold-options/app/vite/framework/vue/config/eslint-framework.mts +3 -0
  411. package/build/templates/scaffold-options/app/vite/framework/vue/config/framework-plugins.ts +3 -0
  412. package/build/templates/scaffold-options/app/vite/framework/vue/src/app.vue +7 -0
  413. package/build/templates/scaffold-options/app/vite/framework/vue/src/main.ts +5 -0
  414. package/build/templates/scaffold-options/app/vite/framework/vue/src/vite-env.d.ts +9 -0
  415. package/build/templates/scaffold-options/app/vite/framework/vue/tsconfig.json +25 -0
  416. package/build/templates/scaffold-options/app/vite/pwa/disabled/config/pwa-plugins.ts +1 -0
  417. package/build/templates/scaffold-options/app/vite/pwa/enabled/config/pwa-plugins.ts +5 -0
  418. package/build/templates/scaffold-options/docs/docusaurus/blog/blog/2026-01-01-welcome.mdx +14 -0
  419. package/build/templates/scaffold-options/docs/docusaurus/blog/blog/authors.yml +2 -0
  420. package/build/templates/scaffold-options/package/homebridge/custom-ui/homebridge-ui/public/index.html +16 -0
  421. package/build/templates/scaffold-options/package/homebridge/custom-ui/homebridge-ui/public/index.js +5 -0
  422. package/build/templates/scaffold-options/package/homebridge/custom-ui/homebridge-ui/public/styles.css +12 -0
  423. package/build/templates/scaffold-options/package/homebridge/custom-ui/src/config-ui/server.ts +29 -0
  424. package/package.json +23 -9
  425. package/build/src/cli/scaffold/app/workers.d.ts +0 -5
  426. package/build/src/cli/scaffold/app/workers.d.ts.map +0 -1
  427. package/build/src/cli/scaffold/app/workers.js +0 -8
  428. package/build/src/cli/scaffold/app/workers.js.map +0 -1
  429. package/build/src/cli/utility/initialize.d.ts.map +0 -1
  430. package/build/src/cli/utility/initialize.js.map +0 -1
  431. package/build/src/types/cli/scaffold/app/workers.d.ts +0 -24
  432. package/build/src/types/cli/utility/initialize.d.ts +0 -2562
  433. package/build/src/types/tests/cli/scaffold/app/workers.test.d.ts +0 -85
  434. package/build/src/types/tests/cli/utility/initialize.test.d.ts +0 -346
  435. package/build/templates/scaffold/app/express/tsconfig.json +0 -16
  436. package/build/templates/scaffold/app/vite/src/main.ts +0 -5
  437. package/build/templates/scaffold/app/vite/tsconfig.json +0 -16
  438. package/build/templates/scaffold/app/workers/src/index.ts +0 -13
  439. package/build/templates/scaffold/app/workers/tsconfig.json +0 -17
  440. /package/build/templates/scaffold/app/{workers → cloudflare-workers}/wrangler.toml +0 -0
@@ -0,0 +1,30 @@
1
+ import { CLIHeader } from '@cbnventures/nova/toolkit';
2
+ import { Command } from 'commander';
3
+
4
+ /**
5
+ * Program - Create Program.
6
+ *
7
+ * Creates the generated command-line program and its starter action.
8
+ * Consumers can add commands and options to the returned Commander instance.
9
+ *
10
+ * @returns {Command}
11
+ *
12
+ * @since 0.0.0
13
+ */
14
+ export function createProgram(): Command {
15
+ return new Command()
16
+ .name('[__WORKSPACE_NAME__]')
17
+ .description('[__WORKSPACE_TITLE__] command-line interface')
18
+ .version('0.0.0')
19
+ .action(() => {
20
+ process.stdout.write(`${CLIHeader.render([
21
+ '[__WORKSPACE_TITLE__]',
22
+ 'Ready',
23
+ ], {
24
+ marginBottom: 1,
25
+ width: 64,
26
+ })}\n`);
27
+
28
+ return;
29
+ });
30
+ }
@@ -0,0 +1,17 @@
1
+ {
2
+ "extends": [
3
+ "@cbnventures/nova/presets/tsconfig/dx-essentials.json",
4
+ "@cbnventures/nova/presets/tsconfig/dx-strict.json",
5
+ "@cbnventures/nova/presets/tsconfig/role-config.json",
6
+ "@cbnventures/nova/presets/tsconfig/runtime-node.json"
7
+ ],
8
+ "compilerOptions": {
9
+ "types": [
10
+ "node"
11
+ ]
12
+ },
13
+ "include": [
14
+ "./eslint.config.mts",
15
+ "./vitest.config.mts"
16
+ ]
17
+ }
@@ -0,0 +1,22 @@
1
+ {
2
+ "extends": [
3
+ "@cbnventures/nova/presets/tsconfig/dx-essentials.json",
4
+ "@cbnventures/nova/presets/tsconfig/dx-strict.json",
5
+ "@cbnventures/nova/presets/tsconfig/role-source.json",
6
+ "@cbnventures/nova/presets/tsconfig/runtime-node.json"
7
+ ],
8
+ "compilerOptions": {
9
+ "rootDir": "./src",
10
+ "types": [
11
+ "node"
12
+ ],
13
+ "noEmitOnError": false,
14
+ "outDir": "./build"
15
+ },
16
+ "include": [
17
+ "./src/**/*.ts"
18
+ ],
19
+ "exclude": [
20
+ "./src/**/*.test.ts"
21
+ ]
22
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "extends": [
3
+ "@cbnventures/nova/presets/tsconfig/dx-essentials.json",
4
+ "@cbnventures/nova/presets/tsconfig/dx-strict.json",
5
+ "@cbnventures/nova/presets/tsconfig/role-tests.json",
6
+ "@cbnventures/nova/presets/tsconfig/runtime-node.json"
7
+ ],
8
+ "compilerOptions": {
9
+ "types": [
10
+ "node",
11
+ "vitest/globals"
12
+ ]
13
+ },
14
+ "include": [
15
+ "./src/**/*.test.ts",
16
+ "./tests/**/*.test.ts"
17
+ ]
18
+ }
@@ -0,0 +1,18 @@
1
+ import { defineConfig } from 'vitest/config';
2
+
3
+ /**
4
+ * Vitest Configuration.
5
+ *
6
+ * Discovers source-level and workspace-level unit tests.
7
+ * Keeps command-line checks isolated from neighboring monorepo workspaces.
8
+ *
9
+ * @since 0.0.0
10
+ */
11
+ export default defineConfig({
12
+ test: {
13
+ include: [
14
+ 'src/**/*.test.ts',
15
+ 'tests/**/*.test.ts',
16
+ ],
17
+ },
18
+ });
@@ -0,0 +1,53 @@
1
+ import {
2
+ dxCodeStyle,
3
+ dxIgnore,
4
+ langJavascript,
5
+ langTypescript,
6
+ runtimeNode,
7
+ } from '@cbnventures/nova/presets/eslint';
8
+ import { novaRules } from '@cbnventures/nova/rules/eslint';
9
+
10
+ /**
11
+ * ESLint Configuration.
12
+ *
13
+ * Lints only the Node.js packaging helpers; pfSense product sources remain native.
14
+ *
15
+ * @since 0.0.0
16
+ */
17
+ export default [
18
+ ...dxIgnore,
19
+ ...dxCodeStyle,
20
+ ...langJavascript,
21
+ ...langTypescript,
22
+ ...runtimeNode,
23
+ {
24
+ name: 'custom-tsconfig',
25
+ files: [
26
+ '**/*.cts',
27
+ '**/*.mts',
28
+ '**/*.ts',
29
+ '**/*.tsx',
30
+ ],
31
+ languageOptions: {
32
+ parserOptions: {
33
+ project: [
34
+ './tsconfig.scripts.json',
35
+ './tsconfig.tests.json',
36
+ ],
37
+ },
38
+ },
39
+ },
40
+ ...novaRules,
41
+ {
42
+ name: 'custom-nova-rules',
43
+ rules: {
44
+ '@cbnventures/nova/no-regex-literals': [
45
+ 'error',
46
+ {
47
+ ignoreFiles: [],
48
+ regexFile: './scripts/regex.mjs',
49
+ },
50
+ ],
51
+ },
52
+ },
53
+ ];
@@ -0,0 +1,41 @@
1
+ {
2
+ "name": "[__WORKSPACE_PACKAGE_NAME__]",
3
+ "version": "0.0.0",
4
+ "type": "module",
5
+ "files": [
6
+ "build"
7
+ ],
8
+ "scripts": {
9
+ "check": "nova utility run-scripts --sequential 'check:*'",
10
+ "check:lint-scripts": "eslint ./ --max-warnings=0",
11
+ "check:types-scripts": "nova utility type-check --project tsconfig.scripts.json",
12
+ "check:types-tests": "nova utility type-check --project tsconfig.tests.json",
13
+ "check:test-scripts": "vitest run",
14
+ "check:package": "node ./scripts/check-package.mjs",
15
+ "build": "nova utility run-scripts --sequential --node-env production 'build:*'",
16
+ "build:reset": "shx rm -rf ./build",
17
+ "build:stage": "node ./scripts/stage-package.mjs",
18
+ "deploy": "nova utility run-scripts --sequential --node-env production 'deploy:*'",
19
+ "deploy:package": "sh ./scripts/build-package.sh",
20
+ "clean": "nova utility run-scripts --parallel 'clean:*'",
21
+ "clean:build": "shx rm -rf ./build"
22
+ },
23
+ "dependencies": {
24
+ "@cbnventures/nova": "0.30.0"
25
+ },
26
+ "devDependencies": {
27
+ "@types/node": "24.9.1",
28
+ "eslint": "9.39.5",
29
+ "shx": "0.4.0",
30
+ "typescript": "6.0.3",
31
+ "vitest": "4.1.11"
32
+ },
33
+ "engines": {
34
+ "node": ">=22.3 <23 || ^24"
35
+ },
36
+ "keywords": [
37
+ "freebsd",
38
+ "pfsense",
39
+ "pfsense-package"
40
+ ]
41
+ }
@@ -0,0 +1,39 @@
1
+ PORTNAME= pfSense-pkg-[__WORKSPACE_IDENTIFIER__]
2
+ DISTVERSION= %%NOVA_PORTVERSION%%
3
+ CATEGORIES= sysutils
4
+ MASTER_SITES= # empty
5
+ DISTFILES= # empty
6
+ EXTRACT_ONLY= # empty
7
+
8
+ MAINTAINER?= maintainer@example.invalid
9
+ COMMENT= [__WORKSPACE_TITLE__] package for pfSense
10
+
11
+ LICENSE= MIT
12
+
13
+ NO_ARCH= yes
14
+ NO_BUILD= yes
15
+ NO_MTREE= yes
16
+
17
+ SUB_FILES= pkg-install pkg-deinstall
18
+ SUB_LIST= PORTNAME=${PORTNAME}
19
+
20
+ do-extract:
21
+ ${MKDIR} ${WRKSRC}
22
+
23
+ do-install:
24
+ ${MKDIR} ${STAGEDIR}${PREFIX}/pkg
25
+ ${MKDIR} ${STAGEDIR}${PREFIX}/sbin
26
+ ${MKDIR} ${STAGEDIR}${DATADIR}
27
+ ${INSTALL_DATA} ${FILESDIR}${PREFIX}/pkg/[__WORKSPACE_NAME__].inc \
28
+ ${STAGEDIR}${PREFIX}/pkg
29
+ ${INSTALL_DATA} ${FILESDIR}${PREFIX}/pkg/[__WORKSPACE_NAME__].xml \
30
+ ${STAGEDIR}${PREFIX}/pkg
31
+ ${INSTALL_SCRIPT} ${FILESDIR}${PREFIX}/sbin/[__WORKSPACE_NAME__] \
32
+ ${STAGEDIR}${PREFIX}/sbin
33
+ ${INSTALL_DATA} ${FILESDIR}${DATADIR}/info.xml \
34
+ ${STAGEDIR}${DATADIR}
35
+ @${REINPLACE_CMD} -i '' -e "s|%%PKGVERSION%%|${PKGVERSION}|" \
36
+ ${STAGEDIR}${PREFIX}/pkg/[__WORKSPACE_NAME__].xml \
37
+ ${STAGEDIR}${DATADIR}/info.xml
38
+
39
+ .include <bsd.port.mk>
@@ -0,0 +1,3 @@
1
+ #!/bin/sh
2
+
3
+ /usr/local/bin/php -f /etc/rc.packages %%PORTNAME%% ${2}
@@ -0,0 +1,7 @@
1
+ #!/bin/sh
2
+
3
+ if [ "${2}" != "POST-INSTALL" ]; then
4
+ exit 0
5
+ fi
6
+
7
+ ${PKG_ROOTDIR}/usr/local/bin/php -f ${PKG_ROOTDIR}/etc/rc.packages %%PORTNAME%% ${2}
@@ -0,0 +1,78 @@
1
+ <?php
2
+
3
+ declare(strict_types=1);
4
+
5
+ require_once('config.inc');
6
+ require_once('pfsense-utils.inc');
7
+ require_once('services.inc');
8
+
9
+ /**
10
+ * Returns the saved package settings.
11
+ *
12
+ * @return array<string, mixed> Package settings.
13
+ */
14
+ function pfsensePackage[__WORKSPACE_IDENTIFIER__]GetSettings(): array
15
+ {
16
+ $settings = config_get_path('installedpackages/[__WORKSPACE_NAME__]/config/0', []);
17
+
18
+ return is_array($settings) ? $settings : [];
19
+ }
20
+
21
+ /**
22
+ * Maps the WebGUI schedule value to cron fields.
23
+ *
24
+ * @param string $schedule Selected schedule.
25
+ *
26
+ * @return array{string, string, string, string, string} Cron fields.
27
+ */
28
+ function pfsensePackage[__WORKSPACE_IDENTIFIER__]GetSchedule(string $schedule): array
29
+ {
30
+ return match ($schedule) {
31
+ 'daily' => ['0', '0', '*', '*', '*'],
32
+ 'weekly' => ['0', '0', '*', '*', '0'],
33
+ default => ['0', '*', '*', '*', '*'],
34
+ };
35
+ }
36
+
37
+ /**
38
+ * Synchronizes the package cron job with the saved WebGUI settings.
39
+ */
40
+ function pfsensePackage[__WORKSPACE_IDENTIFIER__]Sync(): void
41
+ {
42
+ $command = '/usr/local/sbin/[__WORKSPACE_NAME__]';
43
+
44
+ install_cron_job($command, false);
45
+
46
+ $settings = pfsensePackage[__WORKSPACE_IDENTIFIER__]GetSettings();
47
+
48
+ if (($settings['enabled'] ?? '') !== 'on') {
49
+ return;
50
+ }
51
+
52
+ [$minute, $hour, $dayOfMonth, $month, $dayOfWeek] = pfsensePackage[__WORKSPACE_IDENTIFIER__]GetSchedule((string) ($settings['schedule'] ?? 'hourly'));
53
+
54
+ install_cron_job($command, true, $minute, $hour, $dayOfMonth, $month, $dayOfWeek, 'root');
55
+ }
56
+
57
+ /**
58
+ * Removes the package cron job.
59
+ */
60
+ function pfsensePackage[__WORKSPACE_IDENTIFIER__]Remove(): void
61
+ {
62
+ install_cron_job('/usr/local/sbin/[__WORKSPACE_NAME__]', false);
63
+ }
64
+
65
+ /**
66
+ * Validates values submitted by the package WebGUI.
67
+ *
68
+ * @param array<string, mixed> $post Submitted values.
69
+ * @param string[] $inputErrors Validation errors.
70
+ */
71
+ function pfsensePackage[__WORKSPACE_IDENTIFIER__]Validate(array $post, array &$inputErrors): void
72
+ {
73
+ $message = trim((string) ($post['message'] ?? ''));
74
+
75
+ if ($message === '') {
76
+ $inputErrors[] = 'The task message cannot be empty.';
77
+ }
78
+ }
@@ -0,0 +1,68 @@
1
+ <?xml version="1.0" encoding="utf-8" ?>
2
+ <!DOCTYPE packagegui SYSTEM "../schema/packages.dtd">
3
+ <?xml-stylesheet type="text/xsl" href="../xsl/package.xsl"?>
4
+ <packagegui>
5
+ <copyright>
6
+ <![CDATA[
7
+ /*
8
+ * Generated by Nova for [__PROJECT_SLUG__].
9
+ * SPDX-License-Identifier: MIT
10
+ */
11
+ ]]>
12
+ </copyright>
13
+ <name>[__WORKSPACE_NAME__]</name>
14
+ <version>%%PKGVERSION%%</version>
15
+ <title>Services: [__WORKSPACE_TITLE__]</title>
16
+ <include_file>/usr/local/pkg/[__WORKSPACE_NAME__].inc</include_file>
17
+ <aftersaveredirect>/pkg.php?xml=[__WORKSPACE_NAME__].xml</aftersaveredirect>
18
+ <menu>
19
+ <name>[__WORKSPACE_TITLE__]</name>
20
+ <section>Services</section>
21
+ <configfile>[__WORKSPACE_NAME__].xml</configfile>
22
+ <url>/pkg.php?xml=[__WORKSPACE_NAME__].xml</url>
23
+ </menu>
24
+ <fields>
25
+ <field>
26
+ <type>listtopic</type>
27
+ <name>[__WORKSPACE_TITLE__] Settings</name>
28
+ </field>
29
+ <field>
30
+ <fielddescr>Enable Scheduled Task</fielddescr>
31
+ <fieldname>enabled</fieldname>
32
+ <type>checkbox</type>
33
+ <description>Run the package's background task on the selected schedule.</description>
34
+ </field>
35
+ <field>
36
+ <fielddescr>Schedule</fielddescr>
37
+ <fieldname>schedule</fieldname>
38
+ <type>select</type>
39
+ <options>
40
+ <option><name>Hourly</name><value>hourly</value></option>
41
+ <option><name>Daily at midnight</name><value>daily</value></option>
42
+ <option><name>Weekly on Sunday</name><value>weekly</value></option>
43
+ </options>
44
+ <description>Choose how often pfSense runs the background task.</description>
45
+ </field>
46
+ <field>
47
+ <fielddescr>Task Message</fielddescr>
48
+ <fieldname>message</fieldname>
49
+ <type>input</type>
50
+ <size>60</size>
51
+ <default_value>Scheduled [__WORKSPACE_TITLE__] task completed.</default_value>
52
+ <description>Starter value written to the pfSense system log by the generated task.</description>
53
+ <required/>
54
+ </field>
55
+ </fields>
56
+ <custom_php_install_command>
57
+ pfsensePackage[__WORKSPACE_IDENTIFIER__]Sync();
58
+ </custom_php_install_command>
59
+ <custom_php_resync_config_command>
60
+ pfsensePackage[__WORKSPACE_IDENTIFIER__]Sync();
61
+ </custom_php_resync_config_command>
62
+ <custom_delete_php_command>
63
+ pfsensePackage[__WORKSPACE_IDENTIFIER__]Remove();
64
+ </custom_delete_php_command>
65
+ <custom_php_validation_command>
66
+ pfsensePackage[__WORKSPACE_IDENTIFIER__]Validate($_POST, $input_errors);
67
+ </custom_php_validation_command>
68
+ </packagegui>
@@ -0,0 +1,21 @@
1
+ #!/usr/local/bin/php -f
2
+ <?php
3
+
4
+ declare(strict_types=1);
5
+
6
+ require_once('/etc/inc/config.inc');
7
+ require_once('/etc/inc/util.inc');
8
+
9
+ $settings = config_get_path('installedpackages/[__WORKSPACE_NAME__]/config/0', []);
10
+
11
+ if (!is_array($settings) || ($settings['enabled'] ?? '') !== 'on') {
12
+ exit(0);
13
+ }
14
+
15
+ $message = trim((string) ($settings['message'] ?? ''));
16
+
17
+ if ($message === '') {
18
+ $message = 'Scheduled [__WORKSPACE_TITLE__] task completed.';
19
+ }
20
+
21
+ log_error(sprintf('[__WORKSPACE_TITLE__]: %s', $message));
@@ -0,0 +1,9 @@
1
+ <?xml version="1.0"?>
2
+ <pfsensepkgs>
3
+ <package>
4
+ <name>[__WORKSPACE_TITLE__]</name>
5
+ <descr><![CDATA[[__WORKSPACE_TITLE__] adds a WebGUI-managed scheduled task to pfSense.]]></descr>
6
+ <version>%%PKGVERSION%%</version>
7
+ <configurationfile>[__WORKSPACE_NAME__].xml</configurationfile>
8
+ </package>
9
+ </pfsensepkgs>
@@ -0,0 +1,3 @@
1
+ [__WORKSPACE_TITLE__] adds a WebGUI settings page and a scheduled background
2
+ task to pfSense. The task is configured from Services > [__WORKSPACE_TITLE__]
3
+ and runs without an interactive command-line interface.
@@ -0,0 +1,4 @@
1
+ pkg/[__WORKSPACE_NAME__].inc
2
+ pkg/[__WORKSPACE_NAME__].xml
3
+ sbin/[__WORKSPACE_NAME__]
4
+ %%DATADIR%%/info.xml
@@ -0,0 +1,72 @@
1
+ #!/bin/sh
2
+
3
+ set -eu
4
+
5
+ SCRIPT_DIR="$(CDPATH='' cd -- "$(dirname -- "$0")" && pwd)"
6
+ WORKSPACE_DIR="$(CDPATH='' cd -- "${SCRIPT_DIR}/.." && pwd)"
7
+ STAGED_PORT_DIR="${WORKSPACE_DIR}/build/port"
8
+ PORTS_DIR="${PFSENSE_PORTS_DIR:-}"
9
+ PORT_DESTINATION="${PORTS_DIR}/sysutils/pfSense-pkg-[__WORKSPACE_IDENTIFIER__]"
10
+ RELEASE_DIR="${WORKSPACE_DIR}/build/release"
11
+ CREATED_PORT_DESTINATION='false'
12
+
13
+ cleanup() {
14
+ if [ "${CREATED_PORT_DESTINATION}" = 'true' ] && [ -d "${PORT_DESTINATION}" ]; then
15
+ rm -rf -- "${PORT_DESTINATION}"
16
+ fi
17
+ }
18
+
19
+ main() {
20
+ if [ "$(uname -s)" != 'FreeBSD' ]; then
21
+ echo 'The final pfSense package must be built on FreeBSD.' >&2
22
+ exit 1
23
+ fi
24
+
25
+ if [ -z "${PORTS_DIR}" ] || [ ! -f "${PORTS_DIR}/Mk/bsd.port.mk" ]; then
26
+ echo 'Set PFSENSE_PORTS_DIR to a pfSense FreeBSD-ports checkout.' >&2
27
+ exit 1
28
+ fi
29
+
30
+ if [ ! -f "${STAGED_PORT_DIR}/Makefile" ]; then
31
+ echo 'Run npm run build before packaging so build/port is staged.' >&2
32
+ exit 1
33
+ fi
34
+
35
+ if [ -e "${PORT_DESTINATION}" ]; then
36
+ echo "The temporary port destination already exists: ${PORT_DESTINATION}" >&2
37
+ exit 1
38
+ fi
39
+
40
+ trap cleanup EXIT HUP INT TERM
41
+
42
+ mkdir -p -- "$(dirname -- "${PORT_DESTINATION}")"
43
+ cp -R -- "${STAGED_PORT_DIR}" "${PORT_DESTINATION}"
44
+ CREATED_PORT_DESTINATION='true'
45
+
46
+ make -C "${PORT_DESTINATION}" package BATCH=yes DISABLE_VULNERABILITIES=yes
47
+
48
+ artifact=''
49
+
50
+ for candidate in "${PORT_DESTINATION}"/work/pkg/pfSense-pkg-[__WORKSPACE_IDENTIFIER__]-*.pkg "${PORT_DESTINATION}"/work/pkg/pfSense-pkg-[__WORKSPACE_IDENTIFIER__]-*.txz; do
51
+ if [ -f "${candidate}" ]; then
52
+ artifact="${candidate}"
53
+ break
54
+ fi
55
+ done
56
+
57
+ if [ -z "${artifact}" ]; then
58
+ echo 'The FreeBSD ports build completed without a pfSense package artifact.' >&2
59
+ exit 1
60
+ fi
61
+
62
+ mkdir -p -- "${RELEASE_DIR}"
63
+ cp -- "${artifact}" "${RELEASE_DIR}/"
64
+
65
+ artifact_name="$(basename -- "${artifact}")"
66
+
67
+ sha256 -q "${RELEASE_DIR}/${artifact_name}" > "${RELEASE_DIR}/${artifact_name}.sha256"
68
+
69
+ echo "Created ${RELEASE_DIR}/${artifact_name} and its SHA-256 checksum."
70
+ }
71
+
72
+ main "$@"
@@ -0,0 +1,92 @@
1
+ import { access, readFile } from 'node:fs/promises';
2
+ import { dirname, join, resolve } from 'node:path';
3
+ import { fileURLToPath } from 'node:url';
4
+
5
+ import { semanticVersionPattern } from './regex.mjs';
6
+
7
+ /**
8
+ * Check Package - Workspace Directory.
9
+ *
10
+ * Resolves the generated pfSense package workspace from this script file.
11
+ * Every structural check uses this stable absolute directory as its base.
12
+ *
13
+ * @since 0.0.0
14
+ */
15
+ const workspaceDirectory = resolve(dirname(fileURLToPath(import.meta.url)), '..');
16
+
17
+ /**
18
+ * Check Package - Required Files.
19
+ *
20
+ * Lists every source artifact needed to stage and publish the pfSense package.
21
+ * A missing entry fails validation before a release archive is attempted.
22
+ *
23
+ * @since 0.0.0
24
+ */
25
+ const requiredFiles = [
26
+ 'package.json',
27
+ 'port/Makefile.template',
28
+ 'port/pkg-descr',
29
+ 'port/pkg-plist',
30
+ 'port/files/pkg-deinstall.in',
31
+ 'port/files/pkg-install.in',
32
+ 'port/files/usr/local/pkg/[__WORKSPACE_NAME__].inc',
33
+ 'port/files/usr/local/pkg/[__WORKSPACE_NAME__].xml',
34
+ 'port/files/usr/local/sbin/[__WORKSPACE_NAME__]',
35
+ 'port/files/usr/local/share/pfSense-pkg-[__WORKSPACE_IDENTIFIER__]/info.xml',
36
+ ];
37
+
38
+ await Promise.all(requiredFiles.map(async (requiredFile) => {
39
+ await access(join(workspaceDirectory, requiredFile));
40
+
41
+ return;
42
+ }));
43
+
44
+ /**
45
+ * Check Package - package.json Raw.
46
+ *
47
+ * Reads the workspace manifest before its release version is validated.
48
+ * The raw value remains separate from the parsed object for clear diagnostics.
49
+ *
50
+ * @since 0.0.0
51
+ */
52
+ const packageJsonRaw = await readFile(join(workspaceDirectory, 'package.json'), 'utf-8');
53
+
54
+ /**
55
+ * Check Package - package.json.
56
+ *
57
+ * Parses the workspace manifest used to stage the FreeBSD port version.
58
+ * Validation below rejects missing and malformed release values.
59
+ *
60
+ * @since 0.0.0
61
+ */
62
+ const packageJson = JSON.parse(packageJsonRaw);
63
+
64
+ /**
65
+ * Check Package - Version.
66
+ *
67
+ * Selects the manifest version embedded into the staged FreeBSD port.
68
+ * Semantic-version validation keeps generated release metadata predictable.
69
+ *
70
+ * @since 0.0.0
71
+ */
72
+ const version = packageJson['version'];
73
+
74
+ if (typeof version !== 'string' || semanticVersionPattern.test(version) === false) {
75
+ throw new Error('package.json must contain a semantic version that can be staged as a FreeBSD port version.');
76
+ }
77
+
78
+ /**
79
+ * Check Package - Makefile Template.
80
+ *
81
+ * Reads the port Makefile template so its Nova version token can be checked.
82
+ * The staging command replaces this token with the validated package version.
83
+ *
84
+ * @since 0.0.0
85
+ */
86
+ const makefileTemplate = await readFile(join(workspaceDirectory, 'port', 'Makefile.template'), 'utf-8');
87
+
88
+ if (makefileTemplate.includes('%%NOVA_PORTVERSION%%') === false) {
89
+ throw new Error('port/Makefile.template must retain the %%NOVA_PORTVERSION%% build placeholder.');
90
+ }
91
+
92
+ process.stdout.write('pfSense package sources are structurally valid.\n');
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Regex - Semantic Version Pattern.
3
+ *
4
+ * Matches the release versions supported by the generated pfSense package.
5
+ * Keeping the pattern shared prevents validation logic from mixing with I/O.
6
+ *
7
+ * @since 0.0.0
8
+ */
9
+ export const semanticVersionPattern = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;