@gadicc/loom 0.0.0-oidc-bootstrap.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 (342) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +6 -0
  3. package/README.md +448 -0
  4. package/THIRD_PARTY_NOTICES.md +25 -0
  5. package/db/drizzle-config.d.ts +20 -0
  6. package/db/drizzle-config.js +34 -0
  7. package/db/fixtures.d.ts +31 -0
  8. package/db/fixtures.js +52 -0
  9. package/db/neon.d.ts +3 -0
  10. package/db/neon.js +20 -0
  11. package/db/neonFull.d.ts +12 -0
  12. package/db/neonFull.js +33 -0
  13. package/db/package.json +3 -0
  14. package/db/testing.d.ts +26 -0
  15. package/db/testing.js +76 -0
  16. package/db/testing.test.ts +28 -0
  17. package/db/valibot.d.ts +23 -0
  18. package/db/valibot.js +8 -0
  19. package/esm/_dnt.polyfills.d.ts +149 -0
  20. package/esm/_dnt.polyfills.d.ts.map +1 -0
  21. package/esm/_dnt.polyfills.js +163 -0
  22. package/esm/_dnt.shims.d.ts +2 -0
  23. package/esm/_dnt.shims.d.ts.map +1 -0
  24. package/esm/_dnt.shims.js +57 -0
  25. package/esm/bin/loom.d.ts +2 -0
  26. package/esm/bin/loom.d.ts.map +1 -0
  27. package/esm/bin/loom.js +11 -0
  28. package/esm/mod.d.ts +9 -0
  29. package/esm/mod.d.ts.map +1 -0
  30. package/esm/mod.js +8 -0
  31. package/esm/package.json +3 -0
  32. package/esm/src/apiKeys/authorize.d.ts +4 -0
  33. package/esm/src/apiKeys/authorize.d.ts.map +1 -0
  34. package/esm/src/apiKeys/authorize.js +184 -0
  35. package/esm/src/apiKeys/country.d.ts +3 -0
  36. package/esm/src/apiKeys/country.d.ts.map +1 -0
  37. package/esm/src/apiKeys/country.js +7 -0
  38. package/esm/src/apiKeys/credentials.d.ts +4 -0
  39. package/esm/src/apiKeys/credentials.d.ts.map +1 -0
  40. package/esm/src/apiKeys/credentials.js +55 -0
  41. package/esm/src/apiKeys/fingerprint.d.ts +3 -0
  42. package/esm/src/apiKeys/fingerprint.d.ts.map +1 -0
  43. package/esm/src/apiKeys/fingerprint.js +5 -0
  44. package/esm/src/apiKeys/mod.d.ts +9 -0
  45. package/esm/src/apiKeys/mod.d.ts.map +1 -0
  46. package/esm/src/apiKeys/mod.js +8 -0
  47. package/esm/src/apiKeys/policy.d.ts +59 -0
  48. package/esm/src/apiKeys/policy.d.ts.map +1 -0
  49. package/esm/src/apiKeys/policy.js +88 -0
  50. package/esm/src/apiKeys/retention.d.ts +55 -0
  51. package/esm/src/apiKeys/retention.d.ts.map +1 -0
  52. package/esm/src/apiKeys/retention.js +65 -0
  53. package/esm/src/apiKeys/types.d.ts +175 -0
  54. package/esm/src/apiKeys/types.d.ts.map +1 -0
  55. package/esm/src/apiKeys/types.js +1 -0
  56. package/esm/src/cli/externalSkills.d.ts +39 -0
  57. package/esm/src/cli/externalSkills.d.ts.map +1 -0
  58. package/esm/src/cli/externalSkills.js +177 -0
  59. package/esm/src/cli/mod.d.ts +337 -0
  60. package/esm/src/cli/mod.d.ts.map +1 -0
  61. package/esm/src/cli/mod.js +9268 -0
  62. package/esm/src/cli/projectSkills.d.ts +102 -0
  63. package/esm/src/cli/projectSkills.d.ts.map +1 -0
  64. package/esm/src/cli/projectSkills.js +592 -0
  65. package/esm/src/files/client.d.ts +29 -0
  66. package/esm/src/files/client.d.ts.map +1 -0
  67. package/esm/src/files/client.js +41 -0
  68. package/esm/src/files/errors.d.ts +37 -0
  69. package/esm/src/files/errors.d.ts.map +1 -0
  70. package/esm/src/files/errors.js +66 -0
  71. package/esm/src/files/hash.d.ts +15 -0
  72. package/esm/src/files/hash.d.ts.map +1 -0
  73. package/esm/src/files/hash.js +82 -0
  74. package/esm/src/files/memory.d.ts +29 -0
  75. package/esm/src/files/memory.d.ts.map +1 -0
  76. package/esm/src/files/memory.js +109 -0
  77. package/esm/src/files/metadata.d.ts +10 -0
  78. package/esm/src/files/metadata.d.ts.map +1 -0
  79. package/esm/src/files/metadata.js +186 -0
  80. package/esm/src/files/mod.d.ts +10 -0
  81. package/esm/src/files/mod.d.ts.map +1 -0
  82. package/esm/src/files/mod.js +9 -0
  83. package/esm/src/files/s3.d.ts +29 -0
  84. package/esm/src/files/s3.d.ts.map +1 -0
  85. package/esm/src/files/s3.js +107 -0
  86. package/esm/src/files/service.d.ts +27 -0
  87. package/esm/src/files/service.d.ts.map +1 -0
  88. package/esm/src/files/service.js +136 -0
  89. package/esm/src/files/types.d.ts +134 -0
  90. package/esm/src/files/types.d.ts.map +1 -0
  91. package/esm/src/files/types.js +1 -0
  92. package/esm/src/jobs/catalog.d.ts +32 -0
  93. package/esm/src/jobs/catalog.d.ts.map +1 -0
  94. package/esm/src/jobs/catalog.js +208 -0
  95. package/esm/src/jobs/controller.d.ts +28 -0
  96. package/esm/src/jobs/controller.d.ts.map +1 -0
  97. package/esm/src/jobs/controller.js +95 -0
  98. package/esm/src/jobs/direct.d.ts +36 -0
  99. package/esm/src/jobs/direct.d.ts.map +1 -0
  100. package/esm/src/jobs/direct.js +122 -0
  101. package/esm/src/jobs/events.d.ts +15 -0
  102. package/esm/src/jobs/events.d.ts.map +1 -0
  103. package/esm/src/jobs/events.js +30 -0
  104. package/esm/src/jobs/format.d.ts +16 -0
  105. package/esm/src/jobs/format.d.ts.map +1 -0
  106. package/esm/src/jobs/format.js +183 -0
  107. package/esm/src/jobs/http.d.ts +22 -0
  108. package/esm/src/jobs/http.d.ts.map +1 -0
  109. package/esm/src/jobs/http.js +44 -0
  110. package/esm/src/jobs/log.d.ts +2 -0
  111. package/esm/src/jobs/log.d.ts.map +1 -0
  112. package/esm/src/jobs/log.js +10 -0
  113. package/esm/src/jobs/mod.d.ts +10 -0
  114. package/esm/src/jobs/mod.d.ts.map +1 -0
  115. package/esm/src/jobs/mod.js +9 -0
  116. package/esm/src/jobs/run.d.ts +20 -0
  117. package/esm/src/jobs/run.d.ts.map +1 -0
  118. package/esm/src/jobs/run.js +57 -0
  119. package/esm/src/jobs/types.d.ts +31 -0
  120. package/esm/src/jobs/types.d.ts.map +1 -0
  121. package/esm/src/jobs/types.js +1 -0
  122. package/esm/src/mui/apiKeys.d.ts +65 -0
  123. package/esm/src/mui/apiKeys.d.ts.map +1 -0
  124. package/esm/src/mui/apiKeys.js +301 -0
  125. package/esm/src/mui/apiKeysView.d.ts +48 -0
  126. package/esm/src/mui/apiKeysView.d.ts.map +1 -0
  127. package/esm/src/mui/apiKeysView.js +34 -0
  128. package/esm/src/mui/confirm.d.ts +12 -0
  129. package/esm/src/mui/confirm.d.ts.map +1 -0
  130. package/esm/src/mui/confirm.js +78 -0
  131. package/esm/src/mui/mod.d.ts +4 -0
  132. package/esm/src/mui/mod.d.ts.map +1 -0
  133. package/esm/src/mui/mod.js +2 -0
  134. package/esm/src/next/apiKeys/mod.d.ts +64 -0
  135. package/esm/src/next/apiKeys/mod.d.ts.map +1 -0
  136. package/esm/src/next/apiKeys/mod.js +217 -0
  137. package/esm/src/next/auth/config.d.ts +34 -0
  138. package/esm/src/next/auth/config.d.ts.map +1 -0
  139. package/esm/src/next/auth/config.js +103 -0
  140. package/esm/src/next/auth/mod.d.ts +3 -0
  141. package/esm/src/next/auth/mod.d.ts.map +1 -0
  142. package/esm/src/next/auth/mod.js +2 -0
  143. package/esm/src/next/auth/server.d.ts +28 -0
  144. package/esm/src/next/auth/server.d.ts.map +1 -0
  145. package/esm/src/next/auth/server.js +24 -0
  146. package/esm/src/next/files/mod.d.ts +3 -0
  147. package/esm/src/next/files/mod.d.ts.map +1 -0
  148. package/esm/src/next/files/mod.js +2 -0
  149. package/esm/src/next/files/route.d.ts +99 -0
  150. package/esm/src/next/files/route.d.ts.map +1 -0
  151. package/esm/src/next/files/route.js +349 -0
  152. package/esm/src/next/jobs/list.d.ts +25 -0
  153. package/esm/src/next/jobs/list.d.ts.map +1 -0
  154. package/esm/src/next/jobs/list.js +39 -0
  155. package/esm/src/next/jobs/mod.d.ts +6 -0
  156. package/esm/src/next/jobs/mod.d.ts.map +1 -0
  157. package/esm/src/next/jobs/mod.js +5 -0
  158. package/esm/src/next/jobs/paths.d.ts +14 -0
  159. package/esm/src/next/jobs/paths.d.ts.map +1 -0
  160. package/esm/src/next/jobs/paths.js +40 -0
  161. package/esm/src/next/jobs/route.d.ts +48 -0
  162. package/esm/src/next/jobs/route.d.ts.map +1 -0
  163. package/esm/src/next/jobs/route.js +101 -0
  164. package/esm/src/next/jobs/run.d.ts +51 -0
  165. package/esm/src/next/jobs/run.d.ts.map +1 -0
  166. package/esm/src/next/jobs/run.js +563 -0
  167. package/esm/src/next/jobs/stream.d.ts +3 -0
  168. package/esm/src/next/jobs/stream.d.ts.map +1 -0
  169. package/esm/src/next/jobs/stream.js +25 -0
  170. package/esm/src/next/pwa/mod.d.ts +104 -0
  171. package/esm/src/next/pwa/mod.d.ts.map +1 -0
  172. package/esm/src/next/pwa/mod.js +169 -0
  173. package/esm/src/next/pwa/worker.d.ts +27 -0
  174. package/esm/src/next/pwa/worker.d.ts.map +1 -0
  175. package/esm/src/next/pwa/worker.js +27 -0
  176. package/package.json +293 -0
  177. package/script/_dnt.polyfills.d.ts +149 -0
  178. package/script/_dnt.polyfills.d.ts.map +1 -0
  179. package/script/_dnt.polyfills.js +166 -0
  180. package/script/_dnt.shims.d.ts +2 -0
  181. package/script/_dnt.shims.d.ts.map +1 -0
  182. package/script/_dnt.shims.js +60 -0
  183. package/script/bin/loom.d.ts +2 -0
  184. package/script/bin/loom.d.ts.map +1 -0
  185. package/script/bin/loom.js +17 -0
  186. package/script/mod.d.ts +9 -0
  187. package/script/mod.d.ts.map +1 -0
  188. package/script/mod.js +24 -0
  189. package/script/package.json +3 -0
  190. package/script/src/apiKeys/authorize.d.ts +4 -0
  191. package/script/src/apiKeys/authorize.d.ts.map +1 -0
  192. package/script/src/apiKeys/authorize.js +187 -0
  193. package/script/src/apiKeys/country.d.ts +3 -0
  194. package/script/src/apiKeys/country.d.ts.map +1 -0
  195. package/script/src/apiKeys/country.js +10 -0
  196. package/script/src/apiKeys/credentials.d.ts +4 -0
  197. package/script/src/apiKeys/credentials.d.ts.map +1 -0
  198. package/script/src/apiKeys/credentials.js +58 -0
  199. package/script/src/apiKeys/fingerprint.d.ts +3 -0
  200. package/script/src/apiKeys/fingerprint.d.ts.map +1 -0
  201. package/script/src/apiKeys/fingerprint.js +8 -0
  202. package/script/src/apiKeys/mod.d.ts +9 -0
  203. package/script/src/apiKeys/mod.d.ts.map +1 -0
  204. package/script/src/apiKeys/mod.js +24 -0
  205. package/script/src/apiKeys/policy.d.ts +59 -0
  206. package/script/src/apiKeys/policy.d.ts.map +1 -0
  207. package/script/src/apiKeys/policy.js +92 -0
  208. package/script/src/apiKeys/retention.d.ts +55 -0
  209. package/script/src/apiKeys/retention.d.ts.map +1 -0
  210. package/script/src/apiKeys/retention.js +70 -0
  211. package/script/src/apiKeys/types.d.ts +175 -0
  212. package/script/src/apiKeys/types.d.ts.map +1 -0
  213. package/script/src/apiKeys/types.js +2 -0
  214. package/script/src/cli/externalSkills.d.ts +39 -0
  215. package/script/src/cli/externalSkills.d.ts.map +1 -0
  216. package/script/src/cli/externalSkills.js +181 -0
  217. package/script/src/cli/mod.d.ts +337 -0
  218. package/script/src/cli/mod.d.ts.map +1 -0
  219. package/script/src/cli/mod.js +9337 -0
  220. package/script/src/cli/projectSkills.d.ts +102 -0
  221. package/script/src/cli/projectSkills.d.ts.map +1 -0
  222. package/script/src/cli/projectSkills.js +606 -0
  223. package/script/src/files/client.d.ts +29 -0
  224. package/script/src/files/client.d.ts.map +1 -0
  225. package/script/src/files/client.js +45 -0
  226. package/script/src/files/errors.d.ts +37 -0
  227. package/script/src/files/errors.d.ts.map +1 -0
  228. package/script/src/files/errors.js +76 -0
  229. package/script/src/files/hash.d.ts +15 -0
  230. package/script/src/files/hash.d.ts.map +1 -0
  231. package/script/src/files/hash.js +89 -0
  232. package/script/src/files/memory.d.ts +29 -0
  233. package/script/src/files/memory.d.ts.map +1 -0
  234. package/script/src/files/memory.js +113 -0
  235. package/script/src/files/metadata.d.ts +10 -0
  236. package/script/src/files/metadata.d.ts.map +1 -0
  237. package/script/src/files/metadata.js +189 -0
  238. package/script/src/files/mod.d.ts +10 -0
  239. package/script/src/files/mod.d.ts.map +1 -0
  240. package/script/src/files/mod.js +25 -0
  241. package/script/src/files/s3.d.ts +29 -0
  242. package/script/src/files/s3.d.ts.map +1 -0
  243. package/script/src/files/s3.js +110 -0
  244. package/script/src/files/service.d.ts +27 -0
  245. package/script/src/files/service.d.ts.map +1 -0
  246. package/script/src/files/service.js +139 -0
  247. package/script/src/files/types.d.ts +134 -0
  248. package/script/src/files/types.d.ts.map +1 -0
  249. package/script/src/files/types.js +2 -0
  250. package/script/src/jobs/catalog.d.ts +32 -0
  251. package/script/src/jobs/catalog.d.ts.map +1 -0
  252. package/script/src/jobs/catalog.js +223 -0
  253. package/script/src/jobs/controller.d.ts +28 -0
  254. package/script/src/jobs/controller.d.ts.map +1 -0
  255. package/script/src/jobs/controller.js +100 -0
  256. package/script/src/jobs/direct.d.ts +36 -0
  257. package/script/src/jobs/direct.d.ts.map +1 -0
  258. package/script/src/jobs/direct.js +128 -0
  259. package/script/src/jobs/events.d.ts +15 -0
  260. package/script/src/jobs/events.d.ts.map +1 -0
  261. package/script/src/jobs/events.js +37 -0
  262. package/script/src/jobs/format.d.ts +16 -0
  263. package/script/src/jobs/format.d.ts.map +1 -0
  264. package/script/src/jobs/format.js +193 -0
  265. package/script/src/jobs/http.d.ts +22 -0
  266. package/script/src/jobs/http.d.ts.map +1 -0
  267. package/script/src/jobs/http.js +50 -0
  268. package/script/src/jobs/log.d.ts +2 -0
  269. package/script/src/jobs/log.d.ts.map +1 -0
  270. package/script/src/jobs/log.js +13 -0
  271. package/script/src/jobs/mod.d.ts +10 -0
  272. package/script/src/jobs/mod.d.ts.map +1 -0
  273. package/script/src/jobs/mod.js +25 -0
  274. package/script/src/jobs/run.d.ts +20 -0
  275. package/script/src/jobs/run.d.ts.map +1 -0
  276. package/script/src/jobs/run.js +61 -0
  277. package/script/src/jobs/types.d.ts +31 -0
  278. package/script/src/jobs/types.d.ts.map +1 -0
  279. package/script/src/jobs/types.js +2 -0
  280. package/script/src/mui/apiKeys.d.ts +65 -0
  281. package/script/src/mui/apiKeys.d.ts.map +1 -0
  282. package/script/src/mui/apiKeys.js +327 -0
  283. package/script/src/mui/apiKeysView.d.ts +48 -0
  284. package/script/src/mui/apiKeysView.d.ts.map +1 -0
  285. package/script/src/mui/apiKeysView.js +40 -0
  286. package/script/src/mui/confirm.d.ts +12 -0
  287. package/script/src/mui/confirm.d.ts.map +1 -0
  288. package/script/src/mui/confirm.js +85 -0
  289. package/script/src/mui/mod.d.ts +4 -0
  290. package/script/src/mui/mod.d.ts.map +1 -0
  291. package/script/src/mui/mod.js +19 -0
  292. package/script/src/next/apiKeys/mod.d.ts +64 -0
  293. package/script/src/next/apiKeys/mod.d.ts.map +1 -0
  294. package/script/src/next/apiKeys/mod.js +224 -0
  295. package/script/src/next/auth/config.d.ts +34 -0
  296. package/script/src/next/auth/config.d.ts.map +1 -0
  297. package/script/src/next/auth/config.js +142 -0
  298. package/script/src/next/auth/mod.d.ts +3 -0
  299. package/script/src/next/auth/mod.d.ts.map +1 -0
  300. package/script/src/next/auth/mod.js +18 -0
  301. package/script/src/next/auth/server.d.ts +28 -0
  302. package/script/src/next/auth/server.d.ts.map +1 -0
  303. package/script/src/next/auth/server.js +27 -0
  304. package/script/src/next/files/mod.d.ts +3 -0
  305. package/script/src/next/files/mod.d.ts.map +1 -0
  306. package/script/src/next/files/mod.js +18 -0
  307. package/script/src/next/files/route.d.ts +99 -0
  308. package/script/src/next/files/route.d.ts.map +1 -0
  309. package/script/src/next/files/route.js +353 -0
  310. package/script/src/next/jobs/list.d.ts +25 -0
  311. package/script/src/next/jobs/list.d.ts.map +1 -0
  312. package/script/src/next/jobs/list.js +48 -0
  313. package/script/src/next/jobs/mod.d.ts +6 -0
  314. package/script/src/next/jobs/mod.d.ts.map +1 -0
  315. package/script/src/next/jobs/mod.js +21 -0
  316. package/script/src/next/jobs/paths.d.ts +14 -0
  317. package/script/src/next/jobs/paths.d.ts.map +1 -0
  318. package/script/src/next/jobs/paths.js +47 -0
  319. package/script/src/next/jobs/route.d.ts +48 -0
  320. package/script/src/next/jobs/route.d.ts.map +1 -0
  321. package/script/src/next/jobs/route.js +105 -0
  322. package/script/src/next/jobs/run.d.ts +51 -0
  323. package/script/src/next/jobs/run.d.ts.map +1 -0
  324. package/script/src/next/jobs/run.js +570 -0
  325. package/script/src/next/jobs/stream.d.ts +3 -0
  326. package/script/src/next/jobs/stream.d.ts.map +1 -0
  327. package/script/src/next/jobs/stream.js +28 -0
  328. package/script/src/next/pwa/mod.d.ts +104 -0
  329. package/script/src/next/pwa/mod.d.ts.map +1 -0
  330. package/script/src/next/pwa/mod.js +192 -0
  331. package/script/src/next/pwa/worker.d.ts +27 -0
  332. package/script/src/next/pwa/worker.d.ts.map +1 -0
  333. package/script/src/next/pwa/worker.js +33 -0
  334. package/skills/loom/SKILL.md +200 -0
  335. package/skills/loom-api-keys/SKILL.md +123 -0
  336. package/skills/loom-auth/SKILL.md +70 -0
  337. package/skills/loom-db/SKILL.md +94 -0
  338. package/skills/loom-db/references/db-stack.md +39 -0
  339. package/skills/loom-files/SKILL.md +97 -0
  340. package/skills/loom-jobs/SKILL.md +148 -0
  341. package/skills/upgrade-deps/SKILL.md +165 -0
  342. package/skills/upgrade-deps/agents/openai.yaml +4 -0
@@ -0,0 +1,99 @@
1
+ import { type LoomFileRecord, type LoomFileRepository, type LoomFileService, type LoomFileStorageAdapter, type LoomFileVisibility } from "../../files/mod.js";
2
+ export interface NextFilesRequest extends Request {
3
+ nextUrl?: URL;
4
+ }
5
+ export interface NextFilesRouteContext {
6
+ params?: Promise<Record<string, string | undefined>> | Record<string, string | undefined>;
7
+ }
8
+ /** Framework-facing App Router context required by current Next.js releases. */
9
+ export interface NextFilesAppRouteContext {
10
+ params: Promise<Record<string, string | undefined>>;
11
+ }
12
+ /** Next-compatible GET handler that remains convenient to invoke in tests. */
13
+ export interface NextFilesGetHandler {
14
+ (request: NextFilesRequest): Promise<Response>;
15
+ (request: NextFilesRequest, context: NextFilesRouteContext): Promise<Response>;
16
+ (request: NextFilesRequest, context: NextFilesAppRouteContext): Promise<Response>;
17
+ }
18
+ export interface LoomFileRouteAccess {
19
+ meta?: Record<string, unknown>;
20
+ ownerId?: string | null;
21
+ ownerType?: string | null;
22
+ visibility?: LoomFileVisibility;
23
+ }
24
+ export type LoomFileRouteLookup = {
25
+ id: string;
26
+ kind: "id";
27
+ sha256: null;
28
+ } | {
29
+ id: null;
30
+ kind: "sha256";
31
+ sha256: string;
32
+ } | {
33
+ id: null;
34
+ kind: "none";
35
+ sha256: null;
36
+ };
37
+ export interface LoomFileDownloadCacheControlContext<TRecord extends LoomFileRecord = LoomFileRecord> {
38
+ /** The explicit route lookup that resolved this file. */
39
+ lookup: Exclude<LoomFileRouteLookup, {
40
+ kind: "none";
41
+ }>;
42
+ /** The file record after app-local read authorization has succeeded. */
43
+ record: TRecord;
44
+ /** The original download request. */
45
+ request: NextFilesRequest;
46
+ }
47
+ export type LoomFileDownloadCacheControl<TRecord extends LoomFileRecord = LoomFileRecord> = string | null | ((context: LoomFileDownloadCacheControlContext<TRecord>) => string | null | undefined);
48
+ export interface LoomFileObjectCacheEntry {
49
+ body: Uint8Array;
50
+ byteSize?: number;
51
+ contentType?: string | null;
52
+ etag?: string;
53
+ }
54
+ export interface LoomFileObjectCacheContext<TRecord extends LoomFileRecord = LoomFileRecord> {
55
+ cacheKey: string;
56
+ lookup: Exclude<LoomFileRouteLookup, {
57
+ kind: "none";
58
+ }>;
59
+ maxBytes: number;
60
+ record: TRecord;
61
+ request: NextFilesRequest;
62
+ ttlSeconds: number;
63
+ }
64
+ export interface LoomFileObjectCache<TRecord extends LoomFileRecord = LoomFileRecord> {
65
+ get(key: string, context: LoomFileObjectCacheContext<TRecord>): Promise<LoomFileObjectCacheEntry | null | undefined>;
66
+ set(key: string, entry: LoomFileObjectCacheEntry, context: LoomFileObjectCacheContext<TRecord>): Promise<void>;
67
+ }
68
+ export interface CreateFilesRouteHandlersOptions<TRecord extends LoomFileRecord = LoomFileRecord> {
69
+ authorizeRead?: (request: NextFilesRequest, record: TRecord) => Promise<LoomFileRouteAccess | Response | null | void> | LoomFileRouteAccess | Response | null | void;
70
+ authorizeUpload?: (request: NextFilesRequest) => Promise<LoomFileRouteAccess | Response | null | void> | LoomFileRouteAccess | Response | null | void;
71
+ defaultDownloadDisposition?: "attachment" | "inline";
72
+ /**
73
+ * Cache-Control for download responses. By default, SHA-256 lookups are
74
+ * treated as immutable content-addressed URLs while id lookups revalidate.
75
+ * Pass null to omit the header or a callback for app-specific policy.
76
+ */
77
+ downloadCacheControl?: LoomFileDownloadCacheControl<TRecord>;
78
+ duplicatePolicy?: "reject" | "reuse" | "store";
79
+ fileFieldName?: string;
80
+ maxBytes?: number;
81
+ objectKey?: (input: {
82
+ byteSize: number;
83
+ sha256: string;
84
+ }) => string;
85
+ privateObjectCache?: LoomFileObjectCache<TRecord>;
86
+ privateObjectCacheMaxBytes?: number;
87
+ privateObjectCacheTtlSeconds?: number;
88
+ repository: LoomFileRepository<TRecord>;
89
+ reuseExisting?: boolean;
90
+ service?: LoomFileService<TRecord>;
91
+ storage: LoomFileStorageAdapter;
92
+ }
93
+ export declare const DEFAULT_PRIVATE_OBJECT_CACHE_MAX_BYTES: number;
94
+ export declare const DEFAULT_PRIVATE_OBJECT_CACHE_TTL_SECONDS: number;
95
+ export declare function createFilesRouteHandlers<TRecord extends LoomFileRecord = LoomFileRecord>(options: CreateFilesRouteHandlersOptions<TRecord>): {
96
+ GET: NextFilesGetHandler;
97
+ POST(request: NextFilesRequest): Promise<any>;
98
+ };
99
+ //# sourceMappingURL=route.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../src/src/next/files/route.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,349 @@
1
+ import { createLoomFileService, LoomFileError, normalizeSha256Hex, } from "../../files/mod.js";
2
+ const CONTENT_ADDRESSED_DOWNLOAD_CACHE_CONTROL = "private, max-age=31536000, immutable";
3
+ const PUBLIC_CONTENT_ADDRESSED_DOWNLOAD_CACHE_CONTROL = "public, max-age=31536000, immutable";
4
+ const PUBLIC_CONTENT_ADDRESSED_CDN_CACHE_CONTROL = "public, max-age=31536000, immutable";
5
+ const ID_DOWNLOAD_CACHE_CONTROL = "private, max-age=0, must-revalidate";
6
+ export const DEFAULT_PRIVATE_OBJECT_CACHE_MAX_BYTES = 2 * 1024 * 1024;
7
+ export const DEFAULT_PRIVATE_OBJECT_CACHE_TTL_SECONDS = 60 * 60 * 24;
8
+ function jsonResponse(value, status = 200) {
9
+ return Response.json(value, {
10
+ status,
11
+ headers: {
12
+ "cache-control": "no-store",
13
+ },
14
+ });
15
+ }
16
+ function textResponse(message, status) {
17
+ return new Response(`${message}\n`, {
18
+ status,
19
+ headers: {
20
+ "content-type": "text/plain; charset=utf-8",
21
+ },
22
+ });
23
+ }
24
+ function errorResponse(error) {
25
+ if (error instanceof LoomFileError) {
26
+ return jsonResponse({
27
+ error: {
28
+ code: error.code,
29
+ message: error.message,
30
+ },
31
+ }, error.status);
32
+ }
33
+ return jsonResponse({
34
+ error: {
35
+ code: "internal_error",
36
+ message: "Internal server error.",
37
+ },
38
+ }, 500);
39
+ }
40
+ function getRequestUrl(request) {
41
+ return request.nextUrl instanceof URL
42
+ ? request.nextUrl
43
+ : new URL(request.url);
44
+ }
45
+ async function getParams(context) {
46
+ const params = context?.params;
47
+ return params instanceof Promise ? await params : params ?? {};
48
+ }
49
+ function getHeaderText(request, name) {
50
+ return request.headers.get(name)?.trim() || null;
51
+ }
52
+ function parseJsonObject(value) {
53
+ if (typeof value !== "string" || !value.trim()) {
54
+ return {};
55
+ }
56
+ let parsed;
57
+ try {
58
+ parsed = JSON.parse(value);
59
+ }
60
+ catch {
61
+ throw new LoomFileError("Multipart meta field must contain valid JSON.", {
62
+ code: "invalid_meta",
63
+ status: 400,
64
+ });
65
+ }
66
+ return parsed && typeof parsed === "object" && !Array.isArray(parsed)
67
+ ? parsed
68
+ : {};
69
+ }
70
+ async function parseUploadRequest(request, fieldName) {
71
+ const requestContentType = request.headers.get("content-type") ?? "";
72
+ if (requestContentType.toLowerCase().includes("multipart/form-data")) {
73
+ const formData = await request.formData();
74
+ const file = formData.get(fieldName);
75
+ if (!(file instanceof Blob)) {
76
+ throw new LoomFileError(`Missing multipart file field: ${fieldName}.`, {
77
+ code: "missing_file",
78
+ status: 400,
79
+ });
80
+ }
81
+ const filename = "name" in file && typeof file.name === "string"
82
+ ? file.name
83
+ : null;
84
+ const formContentType = file.type || null;
85
+ const sha256 = typeof formData.get("sha256") === "string"
86
+ ? String(formData.get("sha256"))
87
+ : null;
88
+ return {
89
+ body: file,
90
+ contentType: formContentType,
91
+ expectedSha256: sha256,
92
+ meta: parseJsonObject(formData.get("meta")),
93
+ originalFilename: filename,
94
+ };
95
+ }
96
+ if (!request.body) {
97
+ throw new LoomFileError("Missing request body.", {
98
+ code: "missing_body",
99
+ status: 400,
100
+ });
101
+ }
102
+ return {
103
+ body: request.body,
104
+ contentType: getHeaderText(request, "content-type"),
105
+ expectedSha256: getHeaderText(request, "x-loom-sha256"),
106
+ meta: {},
107
+ originalFilename: getHeaderText(request, "x-loom-filename"),
108
+ };
109
+ }
110
+ function mergeAccessMeta(access, uploadMeta) {
111
+ return {
112
+ ...(access?.meta ?? {}),
113
+ ...uploadMeta,
114
+ };
115
+ }
116
+ function shouldDownload(url) {
117
+ const mode = url.searchParams.get("mode");
118
+ if (mode === "download")
119
+ return true;
120
+ const download = url.searchParams.get("download");
121
+ return download !== null && download !== "0" && download !== "false";
122
+ }
123
+ function getContentDisposition(disposition, filename) {
124
+ if (!filename)
125
+ return disposition;
126
+ const fallback = filename.replaceAll(/["\r\n\\]/g, "_");
127
+ return `${disposition}; filename="${fallback}"; filename*=UTF-8''${encodeURIComponent(filename)}`;
128
+ }
129
+ function resolveLookup(url, params) {
130
+ const id = params.id ?? url.searchParams.get("id") ?? null;
131
+ const sha256 = params.sha256 ?? url.searchParams.get("sha256") ?? null;
132
+ if (id)
133
+ return { id, kind: "id", sha256: null };
134
+ if (sha256) {
135
+ return {
136
+ id: null,
137
+ kind: "sha256",
138
+ sha256: normalizeSha256Hex(sha256),
139
+ };
140
+ }
141
+ return { id: null, kind: "none", sha256: null };
142
+ }
143
+ function resolveDownloadCacheControl(option, context) {
144
+ if (typeof option === "function")
145
+ return option(context);
146
+ if (option !== undefined)
147
+ return option;
148
+ if (context.lookup.kind === "sha256" && context.record.visibility === "public") {
149
+ return PUBLIC_CONTENT_ADDRESSED_DOWNLOAD_CACHE_CONTROL;
150
+ }
151
+ return context.lookup.kind === "sha256"
152
+ ? CONTENT_ADDRESSED_DOWNLOAD_CACHE_CONTROL
153
+ : ID_DOWNLOAD_CACHE_CONTROL;
154
+ }
155
+ function applyDownloadCacheHeaders(headers, option, context) {
156
+ const cacheControl = resolveDownloadCacheControl(option, context);
157
+ if (cacheControl) {
158
+ headers.set("cache-control", cacheControl);
159
+ }
160
+ if (option === undefined && context.lookup.kind === "sha256" &&
161
+ context.record.visibility === "public") {
162
+ headers.set("vercel-cdn-cache-control", PUBLIC_CONTENT_ADDRESSED_CDN_CACHE_CONTROL);
163
+ headers.set("cdn-cache-control", PUBLIC_CONTENT_ADDRESSED_CDN_CACHE_CONTROL);
164
+ }
165
+ }
166
+ function isPublicFile(record) {
167
+ return record.visibility === "public";
168
+ }
169
+ function canUsePrivateObjectCache(options, request, record) {
170
+ const maxBytes = options.privateObjectCacheMaxBytes ??
171
+ DEFAULT_PRIVATE_OBJECT_CACHE_MAX_BYTES;
172
+ return Boolean(options.privateObjectCache) &&
173
+ !isPublicFile(record) &&
174
+ !request.headers.has("range") &&
175
+ record.byteSize <= maxBytes;
176
+ }
177
+ function privateObjectCacheKey(record) {
178
+ return [
179
+ "loom",
180
+ "file-object",
181
+ "v1",
182
+ record.storageProvider,
183
+ record.bucket ?? "",
184
+ record.objectKey,
185
+ record.sha256,
186
+ ].join(":");
187
+ }
188
+ async function bodyInitToBytes(body) {
189
+ if (ArrayBuffer.isView(body)) {
190
+ return new Uint8Array(body.buffer, body.byteOffset, body.byteLength)
191
+ .slice();
192
+ }
193
+ if (body instanceof ArrayBuffer)
194
+ return new Uint8Array(body).slice();
195
+ if (body instanceof Blob)
196
+ return new Uint8Array(await body.arrayBuffer());
197
+ if (body instanceof ReadableStream) {
198
+ return new Uint8Array(await new Response(body).arrayBuffer());
199
+ }
200
+ if (typeof body === "string")
201
+ return new TextEncoder().encode(body);
202
+ throw new TypeError("Unsupported Loom file download body for object cache.");
203
+ }
204
+ function bytesToBlob(bytes) {
205
+ const copy = new Uint8Array(bytes.byteLength);
206
+ copy.set(bytes);
207
+ return new Blob([copy.buffer]);
208
+ }
209
+ async function getDownloadObject(options, service, request, lookup, record) {
210
+ const maxBytes = options.privateObjectCacheMaxBytes ??
211
+ DEFAULT_PRIVATE_OBJECT_CACHE_MAX_BYTES;
212
+ const ttlSeconds = options.privateObjectCacheTtlSeconds ??
213
+ DEFAULT_PRIVATE_OBJECT_CACHE_TTL_SECONDS;
214
+ const cache = options.privateObjectCache;
215
+ const cacheKey = privateObjectCacheKey(record);
216
+ const cacheContext = {
217
+ cacheKey,
218
+ lookup,
219
+ maxBytes,
220
+ record,
221
+ request,
222
+ ttlSeconds,
223
+ };
224
+ if (canUsePrivateObjectCache(options, request, record) && cache) {
225
+ const cached = await cache.get(cacheKey, cacheContext);
226
+ if (cached) {
227
+ return {
228
+ body: bytesToBlob(cached.body),
229
+ byteSize: cached.byteSize ?? cached.body.byteLength,
230
+ contentType: cached.contentType,
231
+ etag: cached.etag,
232
+ };
233
+ }
234
+ }
235
+ const object = await service.getDownloadObject(record);
236
+ if (!canUsePrivateObjectCache(options, request, record) || !cache) {
237
+ return object;
238
+ }
239
+ const bytes = await bodyInitToBytes(object.body);
240
+ if (bytes.byteLength <= maxBytes) {
241
+ await cache.set(cacheKey, {
242
+ body: bytes,
243
+ byteSize: object.byteSize ?? bytes.byteLength,
244
+ contentType: object.contentType,
245
+ etag: object.etag,
246
+ }, cacheContext);
247
+ }
248
+ return {
249
+ ...object,
250
+ body: bytesToBlob(bytes),
251
+ byteSize: object.byteSize ?? bytes.byteLength,
252
+ };
253
+ }
254
+ function serializeFileRecord(record) {
255
+ return {
256
+ ...record,
257
+ createdAt: record.createdAt?.toISOString?.() ?? record.createdAt,
258
+ deletedAt: record.deletedAt?.toISOString?.() ?? record.deletedAt ?? null,
259
+ updatedAt: record.updatedAt?.toISOString?.() ?? record.updatedAt,
260
+ };
261
+ }
262
+ export function createFilesRouteHandlers(options) {
263
+ const service = options.service ?? createLoomFileService(options);
264
+ const fileFieldName = options.fileFieldName ?? "file";
265
+ const GET = async (request, context) => {
266
+ try {
267
+ const url = getRequestUrl(request);
268
+ const lookup = resolveLookup(url, await getParams(context));
269
+ if (lookup.kind === "none") {
270
+ return textResponse("Bad request: no file id or sha256 given", 400);
271
+ }
272
+ const record = lookup.kind === "id"
273
+ ? await service.getFileById(lookup.id)
274
+ : await service.getFileBySha256(lookup.sha256);
275
+ if (!record) {
276
+ return textResponse("File not found", 404);
277
+ }
278
+ if (!isPublicFile(record)) {
279
+ const access = await options.authorizeRead?.(request, record);
280
+ if (access instanceof Response) {
281
+ return access;
282
+ }
283
+ }
284
+ if (!shouldDownload(url)) {
285
+ return jsonResponse({ file: serializeFileRecord(record) });
286
+ }
287
+ const downloadLookup = lookup;
288
+ const object = await getDownloadObject(options, service, request, downloadLookup, record);
289
+ const headers = new Headers({
290
+ "content-disposition": getContentDisposition(options.defaultDownloadDisposition ?? "attachment", record.originalFilename),
291
+ "content-type": object.contentType ??
292
+ record.detectedContentType ??
293
+ record.contentType ??
294
+ "application/octet-stream",
295
+ });
296
+ applyDownloadCacheHeaders(headers, options.downloadCacheControl, {
297
+ lookup: downloadLookup,
298
+ record,
299
+ request,
300
+ });
301
+ if (object.byteSize !== undefined) {
302
+ headers.set("content-length", String(object.byteSize));
303
+ }
304
+ if (object.etag) {
305
+ headers.set("etag", object.etag);
306
+ }
307
+ return new Response(object.body, { headers });
308
+ }
309
+ catch (error) {
310
+ return errorResponse(error);
311
+ }
312
+ };
313
+ return {
314
+ GET,
315
+ async POST(request) {
316
+ try {
317
+ const access = await options.authorizeUpload?.(request);
318
+ if (access instanceof Response) {
319
+ return access;
320
+ }
321
+ const upload = await parseUploadRequest(request, fileFieldName);
322
+ const result = await service.saveFile({
323
+ body: upload.body,
324
+ contentType: upload.contentType,
325
+ expectedSha256: upload.expectedSha256,
326
+ maxBytes: options.maxBytes,
327
+ meta: mergeAccessMeta(access, upload.meta),
328
+ originalFilename: upload.originalFilename,
329
+ ownerId: access?.ownerId ?? null,
330
+ ownerType: access?.ownerType ?? null,
331
+ visibility: access?.visibility,
332
+ });
333
+ return jsonResponse({
334
+ byteSize: result.byteSize,
335
+ created: result.created,
336
+ detectedContentType: result.detectedContentType,
337
+ file: serializeFileRecord(result.record),
338
+ kind: result.kind,
339
+ reusedExisting: result.reusedExisting,
340
+ sha256: result.sha256,
341
+ stored: result.stored,
342
+ }, result.created ? 201 : 200);
343
+ }
344
+ catch (error) {
345
+ return errorResponse(error);
346
+ }
347
+ },
348
+ };
349
+ }
@@ -0,0 +1,25 @@
1
+ import React from "react";
2
+ import { type JobMeta } from "../../jobs/catalog.js";
3
+ export interface RenderJobsListProps {
4
+ getRunHref: (meta: JobMeta) => string;
5
+ metas: readonly JobMeta[];
6
+ }
7
+ export interface JobsListContentProps {
8
+ basePath?: string;
9
+ emptyMessage?: React.ReactNode;
10
+ metas: Record<string, unknown> | Iterable<unknown>;
11
+ renderList?: (props: RenderJobsListProps) => React.ReactNode;
12
+ }
13
+ export interface RenderJobsListPageProps {
14
+ content: React.ReactNode;
15
+ title: React.ReactNode;
16
+ }
17
+ export interface CreateJobsListPageOptions extends JobsListContentProps {
18
+ renderPage?: (props: RenderJobsListPageProps) => React.ReactNode;
19
+ title?: React.ReactNode;
20
+ }
21
+ export declare function DefaultJobsList(props: RenderJobsListProps): any;
22
+ export declare function DefaultJobsPageLayout(props: RenderJobsListPageProps): any;
23
+ export declare function JobsListContent(props: JobsListContentProps): any;
24
+ export declare function createJobsListPage(options: CreateJobsListPageOptions): () => any;
25
+ //# sourceMappingURL=list.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/src/next/jobs/list.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGtE,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC;IACtC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,KAAK,CAAC,SAAS,CAAC;CAC9D;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;CACxB;AAED,MAAM,WAAW,yBAA0B,SAAQ,oBAAoB;IACrE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,KAAK,CAAC,SAAS,CAAC;IACjE,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACzB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,mBAAmB,OAYzD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,uBAAuB,OAanE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,OAiB1D;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,aAcpE"}
@@ -0,0 +1,39 @@
1
+ import React from "react";
2
+ import { collectJobMetas } from "../../jobs/catalog.js";
3
+ import { getJobRunHref } from "./paths.js";
4
+ export function DefaultJobsList(props) {
5
+ return (React.createElement("ul", null, props.metas.map((meta) => (React.createElement("li", { key: meta.id },
6
+ React.createElement("a", { href: props.getRunHref(meta) }, meta.id),
7
+ " - ",
8
+ meta.desc)))));
9
+ }
10
+ export function DefaultJobsPageLayout(props) {
11
+ return (React.createElement("main", { style: {
12
+ margin: "2rem auto",
13
+ maxWidth: "72rem",
14
+ padding: "0 1rem",
15
+ } },
16
+ React.createElement("h1", { style: { fontSize: "1.5rem", fontWeight: 600 } }, props.title),
17
+ props.content));
18
+ }
19
+ export function JobsListContent(props) {
20
+ const metas = collectJobMetas(props.metas);
21
+ if (metas.length === 0) {
22
+ return React.createElement("p", null, props.emptyMessage ?? "No jobs available.");
23
+ }
24
+ const getRunPath = (meta) => getJobRunHref(meta, props.basePath);
25
+ return (React.createElement(React.Fragment, null, props.renderList?.({
26
+ getRunHref: getRunPath,
27
+ metas,
28
+ }) ?? React.createElement(DefaultJobsList, { getRunHref: getRunPath, metas: metas })));
29
+ }
30
+ export function createJobsListPage(options) {
31
+ return function JobsListPage() {
32
+ const content = React.createElement(JobsListContent, { ...options });
33
+ const title = options.title ?? "Jobs";
34
+ return (React.createElement(React.Fragment, null, options.renderPage?.({
35
+ content,
36
+ title,
37
+ }) ?? React.createElement(DefaultJobsPageLayout, { content: content, title: title })));
38
+ };
39
+ }
@@ -0,0 +1,6 @@
1
+ export * from "./list.js";
2
+ export * from "./paths.js";
3
+ export * from "./route.js";
4
+ export * from "./run.js";
5
+ export * from "./stream.js";
6
+ //# sourceMappingURL=mod.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/next/jobs/mod.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}
@@ -0,0 +1,5 @@
1
+ export * from "./list.js";
2
+ export * from "./paths.js";
3
+ export * from "./route.js";
4
+ export * from "./run.js";
5
+ export * from "./stream.js";
@@ -0,0 +1,14 @@
1
+ import type { JobMeta } from "../../jobs/types.js";
2
+ export type NextPageSearchParams = Record<string, string | string[] | undefined>;
3
+ export interface JobsAdminPaths {
4
+ basePath: string;
5
+ list: string;
6
+ job: (id: string) => string;
7
+ run: (id: string) => string;
8
+ }
9
+ export declare function normalizeJobsAdminBasePath(basePath?: string): string;
10
+ export declare function createJobsAdminPaths(basePath?: string): JobsAdminPaths;
11
+ export declare function getJobRunHref(meta: JobMeta, basePath?: string): string;
12
+ export declare function createUrlSearchParams(searchParams?: NextPageSearchParams, reservedKeys?: readonly string[]): any;
13
+ export declare function serializePageSearchParams(searchParams?: NextPageSearchParams, reservedKeys?: readonly string[]): any;
14
+ //# sourceMappingURL=paths.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../src/src/next/jobs/paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,MAAM,oBAAoB,GAAG,MAAM,CACvC,MAAM,EACN,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAC9B,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5B,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;CAC7B;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,SAAgB,UAOlE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,SAAgB,GAAG,cAAc,CAS7E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,SAAgB,UAEpE;AAED,wBAAgB,qBAAqB,CACnC,YAAY,GAAE,oBAAyB,EACvC,YAAY,GAAE,SAAS,MAAM,EAAO,OAsBrC;AAED,wBAAgB,yBAAyB,CACvC,YAAY,GAAE,oBAAyB,EACvC,YAAY,GAAE,SAAS,MAAM,EAAO,OAGrC"}
@@ -0,0 +1,40 @@
1
+ export function normalizeJobsAdminBasePath(basePath = "/admin/jobs") {
2
+ const trimmed = basePath.trim().replace(/\/+$/, "");
3
+ if (!trimmed || trimmed === "/") {
4
+ return "/admin/jobs";
5
+ }
6
+ return trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
7
+ }
8
+ export function createJobsAdminPaths(basePath = "/admin/jobs") {
9
+ const normalized = normalizeJobsAdminBasePath(basePath);
10
+ return {
11
+ basePath: normalized,
12
+ list: normalized,
13
+ job: (id) => `${normalized}/${encodeURIComponent(id)}`,
14
+ run: (id) => `${normalized}/run/${encodeURIComponent(id)}`,
15
+ };
16
+ }
17
+ export function getJobRunHref(meta, basePath = "/admin/jobs") {
18
+ return createJobsAdminPaths(basePath).run(meta.id);
19
+ }
20
+ export function createUrlSearchParams(searchParams = {}, reservedKeys = []) {
21
+ const params = new URLSearchParams();
22
+ for (const [key, value] of Object.entries(searchParams)) {
23
+ if (reservedKeys.includes(key)) {
24
+ continue;
25
+ }
26
+ if (Array.isArray(value)) {
27
+ for (const item of value) {
28
+ params.append(key, item);
29
+ }
30
+ continue;
31
+ }
32
+ if (typeof value === "string") {
33
+ params.set(key, value);
34
+ }
35
+ }
36
+ return params;
37
+ }
38
+ export function serializePageSearchParams(searchParams = {}, reservedKeys = []) {
39
+ return createUrlSearchParams(searchParams, reservedKeys).toString();
40
+ }
@@ -0,0 +1,48 @@
1
+ import { type CreateJobResponseOptions, type JobCatalog, type JobDefinition, type JobOutputFormat } from "../../jobs/mod.js";
2
+ export interface NextJobRequest extends Request {
3
+ nextUrl?: URL;
4
+ }
5
+ export interface NextJobRouteContext {
6
+ params: Promise<{
7
+ id?: string;
8
+ }>;
9
+ }
10
+ export type NextAfterCallback = (callback: () => void | Promise<void>) => void;
11
+ export interface JobsRouteAuthorizationRequest {
12
+ context: {
13
+ method: string;
14
+ operation: "jobs.execute";
15
+ routeTemplate: string;
16
+ };
17
+ jobId: string;
18
+ request: NextJobRequest;
19
+ }
20
+ export interface JobsRouteAuthorizedResponse<TAuthorization> {
21
+ authorization: TAuthorization;
22
+ jobId: string;
23
+ request: NextJobRequest;
24
+ response: Response;
25
+ }
26
+ export interface CreateJobsRouteHandlerOptions<TJob extends JobDefinition, TAuthorization = unknown> extends Omit<CreateJobResponseOptions, "output" | "runDeferredTasks"> {
27
+ after?: NextAfterCallback;
28
+ authorize?: (input: JobsRouteAuthorizationRequest) => Promise<Response | TAuthorization> | Response | TAuthorization;
29
+ catalog: JobCatalog<TJob> | Iterable<TJob> | Record<string, TJob>;
30
+ defaultOutput?: JobOutputFormat;
31
+ deferredTasks?: "after" | "inline" | "skip";
32
+ onAuthorizedResponse?: (input: JobsRouteAuthorizedResponse<TAuthorization>) => Promise<Response | void> | Response | void;
33
+ reservedSearchParams?: readonly string[];
34
+ routeTemplate?: string;
35
+ }
36
+ export interface CreateJobRouteHandlerOptions<TJob extends JobDefinition, TAuthorization = unknown> extends Omit<CreateJobsRouteHandlerOptions<TJob, TAuthorization>, "catalog"> {
37
+ /** The one app-local job mounted at this static route. */
38
+ job: TJob;
39
+ }
40
+ export declare function createJobsRouteHandler<TJob extends JobDefinition, TAuthorization = unknown>(options: CreateJobsRouteHandlerOptions<TJob, TAuthorization>): (request: NextJobRequest, context: NextJobRouteContext) => Promise<any>;
41
+ /**
42
+ * Create a route handler for one statically mounted job.
43
+ *
44
+ * Static per-job route files let Next.js trace each job independently, which
45
+ * is useful when jobs have large, optional, or worker-only dependencies.
46
+ */
47
+ export declare function createJobRouteHandler<TJob extends JobDefinition, TAuthorization = unknown>(options: CreateJobRouteHandlerOptions<TJob, TAuthorization>): (request: NextJobRequest) => Promise<any>;
48
+ //# sourceMappingURL=route.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../src/src/next/jobs/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAG7B,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,eAAe,EAErB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,cAAe,SAAQ,OAAO;IAC7C,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;CACJ;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;AAE/E,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,cAAc,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,WAAW,2BAA2B,CAAC,cAAc;IACzD,aAAa,EAAE,cAAc,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B,CAC5C,IAAI,SAAS,aAAa,EAC1B,cAAc,GAAG,OAAO,CACxB,SAAQ,IAAI,CAAC,wBAAwB,EAAE,QAAQ,GAAG,kBAAkB,CAAC;IACrE,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,SAAS,CAAC,EAAE,CACV,KAAK,EAAE,6BAA6B,KACjC,OAAO,CAAC,QAAQ,GAAG,cAAc,CAAC,GAAG,QAAQ,GAAG,cAAc,CAAC;IACpE,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAClE,aAAa,CAAC,EAAE,eAAe,CAAC;IAChC,aAAa,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5C,oBAAoB,CAAC,EAAE,CACrB,KAAK,EAAE,2BAA2B,CAAC,cAAc,CAAC,KAC/C,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC;IAChD,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,4BAA4B,CAC3C,IAAI,SAAS,aAAa,EAC1B,cAAc,GAAG,OAAO,CACxB,SACA,IAAI,CACF,6BAA6B,CAAC,IAAI,EAAE,cAAc,CAAC,EACnD,SAAS,CACV;IACD,0DAA0D;IAC1D,GAAG,EAAE,IAAI,CAAC;CACX;AAmBD,wBAAgB,sBAAsB,CACpC,IAAI,SAAS,aAAa,EAC1B,cAAc,GAAG,OAAO,EAExB,OAAO,EAAE,6BAA6B,CAAC,IAAI,EAAE,cAAc,CAAC,IAU1D,SAAS,cAAc,EACvB,SAAS,mBAAmB,kBAuF/B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,SAAS,aAAa,EAC1B,cAAc,GAAG,OAAO,EAExB,OAAO,EAAE,4BAA4B,CAAC,IAAI,EAAE,cAAc,CAAC,IAQnD,SAAS,cAAc,kBAIhC"}