@pikku/core 0.12.2 → 0.12.4

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 (282) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/dist/crypto-utils.d.ts +10 -0
  3. package/dist/crypto-utils.js +62 -0
  4. package/dist/function/function-runner.js +4 -4
  5. package/dist/function/functions.types.d.ts +26 -1
  6. package/dist/function/functions.types.js +16 -0
  7. package/dist/handle-error.d.ts +1 -1
  8. package/dist/handle-error.js +7 -3
  9. package/dist/index.d.ts +14 -2
  10. package/dist/index.js +1 -1
  11. package/dist/pikku-state.js +3 -1
  12. package/dist/schema.js +1 -1
  13. package/dist/services/in-memory-workflow-service.d.ts +22 -3
  14. package/dist/services/in-memory-workflow-service.js +77 -1
  15. package/dist/services/workflow-service.d.ts +8 -2
  16. package/dist/testing/index.d.ts +2 -0
  17. package/dist/testing/index.js +1 -0
  18. package/dist/testing/service-tests.d.ts +31 -0
  19. package/dist/testing/service-tests.js +598 -0
  20. package/dist/types/core.types.d.ts +9 -1
  21. package/dist/types/state.types.d.ts +4 -2
  22. package/dist/utils/hash.d.ts +2 -0
  23. package/dist/utils/hash.js +23 -0
  24. package/dist/wirings/ai-agent/agent-dynamic-workflow.d.ts +6 -0
  25. package/dist/wirings/ai-agent/agent-dynamic-workflow.js +348 -0
  26. package/dist/wirings/ai-agent/ai-agent-memory.d.ts +1 -1
  27. package/dist/wirings/ai-agent/ai-agent-memory.js +6 -5
  28. package/dist/wirings/ai-agent/ai-agent-prepare.d.ts +10 -7
  29. package/dist/wirings/ai-agent/ai-agent-prepare.js +127 -47
  30. package/dist/wirings/ai-agent/ai-agent-runner.d.ts +4 -0
  31. package/dist/wirings/ai-agent/ai-agent-runner.js +381 -27
  32. package/dist/wirings/ai-agent/ai-agent-stream.d.ts +7 -2
  33. package/dist/wirings/ai-agent/ai-agent-stream.js +109 -46
  34. package/dist/wirings/ai-agent/ai-agent.types.d.ts +22 -1
  35. package/dist/wirings/ai-agent/index.d.ts +1 -2
  36. package/dist/wirings/ai-agent/index.js +1 -2
  37. package/dist/wirings/channel/channel-handler.js +5 -1
  38. package/dist/wirings/channel/channel.types.d.ts +1 -7
  39. package/dist/wirings/channel/local/local-channel-handler.d.ts +1 -1
  40. package/dist/wirings/channel/local/local-channel-handler.js +5 -3
  41. package/dist/wirings/channel/local/local-channel-runner.js +14 -4
  42. package/dist/wirings/channel/serverless/serverless-channel-runner.js +4 -1
  43. package/dist/wirings/cli/cli-runner.js +10 -2
  44. package/dist/wirings/cli/cli.types.d.ts +1 -0
  45. package/dist/wirings/http/http-routes.js +0 -1
  46. package/dist/wirings/http/http-runner.d.ts +1 -1
  47. package/dist/wirings/http/http-runner.js +25 -3
  48. package/dist/wirings/http/http.types.d.ts +3 -11
  49. package/dist/wirings/http/index.d.ts +2 -1
  50. package/dist/wirings/http/index.js +1 -0
  51. package/dist/wirings/http/pikku-fetch-http-request.d.ts +1 -0
  52. package/dist/wirings/http/pikku-fetch-http-request.js +3 -0
  53. package/dist/wirings/http/pikku-fetch-http-response.d.ts +1 -0
  54. package/dist/wirings/http/pikku-fetch-http-response.js +4 -4
  55. package/dist/wirings/http/web-request.d.ts +12 -0
  56. package/dist/wirings/http/web-request.js +85 -0
  57. package/dist/wirings/mcp/mcp-endpoint-registry.js +1 -1
  58. package/dist/wirings/mcp/mcp-runner.js +13 -1
  59. package/dist/wirings/rpc/rpc-runner.d.ts +30 -6
  60. package/dist/wirings/rpc/rpc-runner.js +36 -14
  61. package/dist/wirings/rpc/rpc-types.d.ts +6 -1
  62. package/dist/wirings/rpc/wire-addon.d.ts +1 -0
  63. package/dist/wirings/rpc/wire-addon.js +1 -1
  64. package/dist/wirings/scheduler/scheduler-runner.js +1 -0
  65. package/dist/wirings/workflow/graph/graph-validation.d.ts +3 -0
  66. package/dist/wirings/workflow/graph/graph-validation.js +175 -0
  67. package/dist/wirings/workflow/graph/index.d.ts +1 -0
  68. package/dist/wirings/workflow/graph/index.js +1 -0
  69. package/dist/wirings/workflow/index.d.ts +1 -1
  70. package/dist/wirings/workflow/pikku-workflow-service.d.ts +8 -2
  71. package/dist/wirings/workflow/pikku-workflow-service.js +1 -2
  72. package/dist/wirings/workflow/workflow.types.d.ts +10 -1
  73. package/lcov.info +18891 -0
  74. package/package.json +4 -2
  75. package/dist/wirings/ai-agent/ai-agent-assistant-ui.d.ts +0 -5
  76. package/dist/wirings/ai-agent/ai-agent-assistant-ui.js +0 -168
  77. package/src/crypto-utils.test.ts +0 -116
  78. package/src/crypto-utils.ts +0 -99
  79. package/src/errors/error-handler.ts +0 -62
  80. package/src/errors/error.test.ts +0 -195
  81. package/src/errors/errors.ts +0 -374
  82. package/src/errors/index.ts +0 -2
  83. package/src/factory-functions.test.ts +0 -109
  84. package/src/function/function-runner.test.ts +0 -536
  85. package/src/function/function-runner.ts +0 -365
  86. package/src/function/functions.types.ts +0 -267
  87. package/src/function/index.ts +0 -5
  88. package/src/handle-error.test.ts +0 -361
  89. package/src/handle-error.ts +0 -65
  90. package/src/index.ts +0 -104
  91. package/src/internal.ts +0 -6
  92. package/src/middleware/auth-apikey.test.ts +0 -363
  93. package/src/middleware/auth-apikey.ts +0 -47
  94. package/src/middleware/auth-bearer.test.ts +0 -450
  95. package/src/middleware/auth-bearer.ts +0 -72
  96. package/src/middleware/auth-cookie.test.ts +0 -528
  97. package/src/middleware/auth-cookie.ts +0 -80
  98. package/src/middleware/cors.test.ts +0 -424
  99. package/src/middleware/cors.ts +0 -104
  100. package/src/middleware/index.ts +0 -5
  101. package/src/middleware/remote-auth.test.ts +0 -488
  102. package/src/middleware/remote-auth.ts +0 -68
  103. package/src/middleware/timeout.ts +0 -15
  104. package/src/middleware-runner.test.ts +0 -418
  105. package/src/middleware-runner.ts +0 -234
  106. package/src/permissions.test.ts +0 -434
  107. package/src/permissions.ts +0 -319
  108. package/src/pikku-request.ts +0 -23
  109. package/src/pikku-response.ts +0 -5
  110. package/src/pikku-state.test.ts +0 -224
  111. package/src/pikku-state.ts +0 -214
  112. package/src/run-tests-script.test.ts +0 -49
  113. package/src/schema.test.ts +0 -249
  114. package/src/schema.ts +0 -151
  115. package/src/services/ai-agent-runner-service.ts +0 -41
  116. package/src/services/ai-run-state-service.ts +0 -20
  117. package/src/services/ai-storage-service.ts +0 -39
  118. package/src/services/content-service.ts +0 -76
  119. package/src/services/deployment-service.ts +0 -22
  120. package/src/services/gateway-service.ts +0 -20
  121. package/src/services/gopass-secrets.ts +0 -98
  122. package/src/services/in-memory-ai-run-state-service.ts +0 -73
  123. package/src/services/in-memory-trigger-service.ts +0 -64
  124. package/src/services/in-memory-workflow-service.test.ts +0 -351
  125. package/src/services/in-memory-workflow-service.ts +0 -395
  126. package/src/services/index.ts +0 -56
  127. package/src/services/jwt-service.ts +0 -30
  128. package/src/services/local-content.ts +0 -120
  129. package/src/services/local-gateway-service.ts +0 -62
  130. package/src/services/local-secrets.test.ts +0 -80
  131. package/src/services/local-secrets.ts +0 -94
  132. package/src/services/local-variables.test.ts +0 -61
  133. package/src/services/local-variables.ts +0 -39
  134. package/src/services/logger-console.test.ts +0 -118
  135. package/src/services/logger-console.ts +0 -98
  136. package/src/services/logger.ts +0 -57
  137. package/src/services/scheduler-service.ts +0 -86
  138. package/src/services/schema-service.ts +0 -33
  139. package/src/services/scoped-secret-service.test.ts +0 -74
  140. package/src/services/scoped-secret-service.ts +0 -41
  141. package/src/services/secret-service.ts +0 -38
  142. package/src/services/trigger-service.ts +0 -17
  143. package/src/services/typed-secret-service.test.ts +0 -93
  144. package/src/services/typed-secret-service.ts +0 -70
  145. package/src/services/typed-variables-service.test.ts +0 -73
  146. package/src/services/typed-variables-service.ts +0 -81
  147. package/src/services/user-session-service.test.ts +0 -113
  148. package/src/services/user-session-service.ts +0 -86
  149. package/src/services/variables-service.ts +0 -11
  150. package/src/services/workflow-service.ts +0 -84
  151. package/src/time-utils.test.ts +0 -56
  152. package/src/time-utils.ts +0 -107
  153. package/src/types/core.types.ts +0 -470
  154. package/src/types/state.types.ts +0 -186
  155. package/src/utils.test.ts +0 -350
  156. package/src/utils.ts +0 -129
  157. package/src/version.test.ts +0 -80
  158. package/src/version.ts +0 -25
  159. package/src/wirings/ai-agent/ai-agent-assistant-ui.test.ts +0 -363
  160. package/src/wirings/ai-agent/ai-agent-assistant-ui.ts +0 -238
  161. package/src/wirings/ai-agent/ai-agent-helpers.test.ts +0 -152
  162. package/src/wirings/ai-agent/ai-agent-helpers.ts +0 -76
  163. package/src/wirings/ai-agent/ai-agent-memory.ts +0 -309
  164. package/src/wirings/ai-agent/ai-agent-model-config.test.ts +0 -115
  165. package/src/wirings/ai-agent/ai-agent-model-config.ts +0 -43
  166. package/src/wirings/ai-agent/ai-agent-prepare.ts +0 -522
  167. package/src/wirings/ai-agent/ai-agent-registry.test.ts +0 -37
  168. package/src/wirings/ai-agent/ai-agent-registry.ts +0 -82
  169. package/src/wirings/ai-agent/ai-agent-runner.test.ts +0 -317
  170. package/src/wirings/ai-agent/ai-agent-runner.ts +0 -251
  171. package/src/wirings/ai-agent/ai-agent-stream.test.ts +0 -652
  172. package/src/wirings/ai-agent/ai-agent-stream.ts +0 -1060
  173. package/src/wirings/ai-agent/ai-agent.types.ts +0 -360
  174. package/src/wirings/ai-agent/index.ts +0 -41
  175. package/src/wirings/channel/channel-common.ts +0 -90
  176. package/src/wirings/channel/channel-handler.ts +0 -241
  177. package/src/wirings/channel/channel-middleware-runner.ts +0 -120
  178. package/src/wirings/channel/channel-runner.ts +0 -166
  179. package/src/wirings/channel/channel-store.ts +0 -29
  180. package/src/wirings/channel/channel.types.ts +0 -178
  181. package/src/wirings/channel/define-channel-routes.ts +0 -25
  182. package/src/wirings/channel/eventhub-service.ts +0 -34
  183. package/src/wirings/channel/eventhub-store.ts +0 -13
  184. package/src/wirings/channel/index.ts +0 -24
  185. package/src/wirings/channel/local/index.ts +0 -3
  186. package/src/wirings/channel/local/local-channel-handler.ts +0 -79
  187. package/src/wirings/channel/local/local-channel-runner.test.ts +0 -215
  188. package/src/wirings/channel/local/local-channel-runner.ts +0 -200
  189. package/src/wirings/channel/local/local-eventhub-service.test.ts +0 -95
  190. package/src/wirings/channel/local/local-eventhub-service.ts +0 -101
  191. package/src/wirings/channel/log-channels.ts +0 -20
  192. package/src/wirings/channel/pikku-abstract-channel-handler.test.ts +0 -54
  193. package/src/wirings/channel/pikku-abstract-channel-handler.ts +0 -45
  194. package/src/wirings/channel/serverless/index.ts +0 -5
  195. package/src/wirings/channel/serverless/serverless-channel-runner.ts +0 -286
  196. package/src/wirings/cli/channel/cli-channel-runner.ts +0 -136
  197. package/src/wirings/cli/channel/index.ts +0 -1
  198. package/src/wirings/cli/cli-runner.test.ts +0 -403
  199. package/src/wirings/cli/cli-runner.ts +0 -519
  200. package/src/wirings/cli/cli.types.ts +0 -357
  201. package/src/wirings/cli/command-parser.test.ts +0 -445
  202. package/src/wirings/cli/command-parser.ts +0 -504
  203. package/src/wirings/cli/define-cli-commands.ts +0 -24
  204. package/src/wirings/cli/index.ts +0 -19
  205. package/src/wirings/gateway/gateway-runner.test.ts +0 -474
  206. package/src/wirings/gateway/gateway-runner.ts +0 -411
  207. package/src/wirings/gateway/gateway.types.ts +0 -149
  208. package/src/wirings/gateway/index.ts +0 -13
  209. package/src/wirings/http/http-routes.test.ts +0 -322
  210. package/src/wirings/http/http-routes.ts +0 -198
  211. package/src/wirings/http/http-runner.test.ts +0 -144
  212. package/src/wirings/http/http-runner.ts +0 -563
  213. package/src/wirings/http/http.types.ts +0 -378
  214. package/src/wirings/http/index.ts +0 -25
  215. package/src/wirings/http/log-http-routes.ts +0 -22
  216. package/src/wirings/http/pikku-fetch-http-request.test.ts +0 -237
  217. package/src/wirings/http/pikku-fetch-http-request.ts +0 -166
  218. package/src/wirings/http/pikku-fetch-http-response.test.ts +0 -82
  219. package/src/wirings/http/pikku-fetch-http-response.ts +0 -147
  220. package/src/wirings/http/routers/http-router.ts +0 -13
  221. package/src/wirings/http/routers/path-to-regex.test.ts +0 -319
  222. package/src/wirings/http/routers/path-to-regex.ts +0 -126
  223. package/src/wirings/mcp/index.ts +0 -27
  224. package/src/wirings/mcp/mcp-endpoint-registry.test.ts +0 -389
  225. package/src/wirings/mcp/mcp-endpoint-registry.ts +0 -159
  226. package/src/wirings/mcp/mcp-runner.ts +0 -305
  227. package/src/wirings/mcp/mcp.types.ts +0 -216
  228. package/src/wirings/node/index.ts +0 -2
  229. package/src/wirings/node/node.types.ts +0 -23
  230. package/src/wirings/oauth2/index.ts +0 -3
  231. package/src/wirings/oauth2/oauth2-client.test.ts +0 -929
  232. package/src/wirings/oauth2/oauth2-client.ts +0 -335
  233. package/src/wirings/oauth2/oauth2.types.ts +0 -69
  234. package/src/wirings/oauth2/wire-oauth2-credential.ts +0 -23
  235. package/src/wirings/queue/index.ts +0 -31
  236. package/src/wirings/queue/queue-runner.test.ts +0 -710
  237. package/src/wirings/queue/queue-runner.ts +0 -192
  238. package/src/wirings/queue/queue.types.ts +0 -189
  239. package/src/wirings/queue/register-queue-helper.ts +0 -60
  240. package/src/wirings/queue/validate-worker-config.test.ts +0 -108
  241. package/src/wirings/queue/validate-worker-config.ts +0 -116
  242. package/src/wirings/rpc/index.ts +0 -4
  243. package/src/wirings/rpc/rpc-runner.ts +0 -439
  244. package/src/wirings/rpc/rpc-types.ts +0 -51
  245. package/src/wirings/rpc/wire-addon.ts +0 -20
  246. package/src/wirings/scheduler/index.ts +0 -11
  247. package/src/wirings/scheduler/log-schedulers.ts +0 -20
  248. package/src/wirings/scheduler/scheduler-runner.test.ts +0 -660
  249. package/src/wirings/scheduler/scheduler-runner.ts +0 -132
  250. package/src/wirings/scheduler/scheduler.types.ts +0 -53
  251. package/src/wirings/secret/index.ts +0 -9
  252. package/src/wirings/secret/secret.types.ts +0 -32
  253. package/src/wirings/secret/validate-secret-definitions.test.ts +0 -140
  254. package/src/wirings/secret/validate-secret-definitions.ts +0 -82
  255. package/src/wirings/trigger/index.ts +0 -10
  256. package/src/wirings/trigger/pikku-trigger-service.ts +0 -112
  257. package/src/wirings/trigger/trigger-runner.test.ts +0 -79
  258. package/src/wirings/trigger/trigger-runner.ts +0 -135
  259. package/src/wirings/trigger/trigger.types.ts +0 -178
  260. package/src/wirings/variable/index.ts +0 -8
  261. package/src/wirings/variable/validate-variable-definitions.test.ts +0 -91
  262. package/src/wirings/variable/validate-variable-definitions.ts +0 -69
  263. package/src/wirings/variable/variable.types.ts +0 -22
  264. package/src/wirings/workflow/dsl/index.ts +0 -31
  265. package/src/wirings/workflow/dsl/workflow-dsl.types.ts +0 -320
  266. package/src/wirings/workflow/dsl/workflow-runner.ts +0 -28
  267. package/src/wirings/workflow/graph/graph-node.ts +0 -222
  268. package/src/wirings/workflow/graph/graph-runner.test.ts +0 -487
  269. package/src/wirings/workflow/graph/graph-runner.ts +0 -816
  270. package/src/wirings/workflow/graph/index.ts +0 -14
  271. package/src/wirings/workflow/graph/template.test.ts +0 -49
  272. package/src/wirings/workflow/graph/template.ts +0 -42
  273. package/src/wirings/workflow/graph/wire-workflow-graph.ts +0 -29
  274. package/src/wirings/workflow/graph/workflow-graph.types.ts +0 -104
  275. package/src/wirings/workflow/index.ts +0 -81
  276. package/src/wirings/workflow/pikku-workflow-service.test.ts +0 -200
  277. package/src/wirings/workflow/pikku-workflow-service.ts +0 -1165
  278. package/src/wirings/workflow/workflow-helpers.test.ts +0 -129
  279. package/src/wirings/workflow/workflow-helpers.ts +0 -79
  280. package/src/wirings/workflow/workflow.types.ts +0 -266
  281. package/tsconfig.json +0 -14
  282. package/tsconfig.tsbuildinfo +0 -1
@@ -1,11 +0,0 @@
1
- export interface VariablesService {
2
- get: (name: string) => Promise<string | undefined> | string | undefined
3
- getJSON: <T = unknown>(name: string) => Promise<T | undefined> | T | undefined
4
- getAll: () =>
5
- | Promise<Record<string, string | undefined>>
6
- | Record<string, string | undefined>
7
- set: (name: string, value: string) => Promise<void> | void
8
- setJSON: (name: string, value: unknown) => Promise<void> | void
9
- has: (name: string) => Promise<boolean> | boolean
10
- delete: (name: string) => Promise<void> | void
11
- }
@@ -1,84 +0,0 @@
1
- import type { SerializedError } from '../types/core.types.js'
2
- import type {
3
- WorkflowRun,
4
- WorkflowRunWire,
5
- StepState,
6
- WorkflowStatus,
7
- } from '../wirings/workflow/workflow.types.js'
8
-
9
- /**
10
- * Interface for workflow orchestration
11
- * Handles workflow execution, replay, orchestration logic, and run-level state
12
- */
13
- export interface WorkflowService {
14
- // Run-level state operations
15
- createRun(
16
- workflowName: string,
17
- input: any,
18
- inline: boolean,
19
- graphHash: string,
20
- wire: WorkflowRunWire
21
- ): Promise<string>
22
- getRun(id: string): Promise<WorkflowRun | null>
23
- getRunHistory(runId: string): Promise<Array<StepState & { stepName: string }>>
24
- updateRunStatus(
25
- id: string,
26
- status: WorkflowStatus,
27
- output?: any,
28
- error?: SerializedError
29
- ): Promise<void>
30
- withRunLock<T>(id: string, fn: () => Promise<T>): Promise<T>
31
- close(): Promise<void>
32
-
33
- // Orchestration operations
34
- resumeWorkflow(runId: string): Promise<void>
35
- startWorkflow<I>(
36
- name: string,
37
- input: I,
38
- wire: WorkflowRunWire,
39
- rpcService: any,
40
- options?: { inline?: boolean; startNode?: string }
41
- ): Promise<{ runId: string }>
42
- runWorkflowJob(runId: string, rpcService: any): Promise<void>
43
- orchestrateWorkflow(runId: string, rpcService: any): Promise<void>
44
- executeWorkflowSleepCompleted(runId: string, stepId: string): Promise<void>
45
-
46
- // Step-level state operations
47
- insertStepState(
48
- runId: string,
49
- stepName: string,
50
- rpcName: string,
51
- data: any,
52
- stepOptions?: { retries?: number; retryDelay?: string | number }
53
- ): Promise<StepState>
54
- getStepState(runId: string, stepName: string): Promise<StepState>
55
- setStepRunning(stepId: string): Promise<void>
56
- setStepScheduled(stepId: string): Promise<void>
57
- setStepResult(stepId: string, result: any): Promise<void>
58
- setStepError(stepId: string, error: Error): Promise<void>
59
- createRetryAttempt(
60
- stepId: string,
61
- status: 'pending' | 'running'
62
- ): Promise<StepState>
63
-
64
- // Step execution
65
- executeWorkflowStep(
66
- runId: string,
67
- stepName: string,
68
- rpcName: string | null,
69
- data: any,
70
- rpcService: any
71
- ): Promise<void>
72
-
73
- // Version operations
74
- upsertWorkflowVersion(
75
- name: string,
76
- graphHash: string,
77
- graph: any,
78
- source: string
79
- ): Promise<void>
80
- getWorkflowVersion(
81
- name: string,
82
- graphHash: string
83
- ): Promise<{ graph: any; source: string } | null>
84
- }
@@ -1,56 +0,0 @@
1
- import { describe, test } from 'node:test'
2
- import assert from 'node:assert/strict'
3
-
4
- import type { RelativeTimeInput } from './time-utils'
5
- import {
6
- getRelativeTimeOffset,
7
- getRelativeTimeOffsetFromNow,
8
- } from './time-utils'
9
-
10
- const approxEqual = (a: number, b: number, delta: number = 10): boolean =>
11
- Math.abs(a - b) <= delta
12
-
13
- describe('Time Utils', () => {
14
- const offsetCases: Array<{ input: RelativeTimeInput; expected: number }> = [
15
- { input: { value: 1, unit: 'second' }, expected: 1000 },
16
- { input: { value: 2, unit: 'minute' }, expected: 120000 },
17
- { input: { value: 1.5, unit: 'hour' }, expected: 5400000 },
18
- { input: { value: -1, unit: 'day' }, expected: -86400000 },
19
- { input: { value: 1, unit: 'week' }, expected: 604800000 },
20
- {
21
- input: { value: 2, unit: 'year' },
22
- expected: Math.round(2 * 365.25 * 86400 * 1000),
23
- },
24
- ]
25
-
26
- describe('getRelativeTimeOffset', () => {
27
- for (const { input, expected } of offsetCases) {
28
- test(`returns ${expected} ms for ${input.value} ${input.unit}`, () => {
29
- const actual = getRelativeTimeOffset(input)
30
- assert.strictEqual(actual, expected)
31
- })
32
- }
33
- })
34
-
35
- describe('getRelativeTimeOffsetFromNow', () => {
36
- test('returns a Date ~1 minute in the future', () => {
37
- const now = Date.now()
38
- const result = getRelativeTimeOffsetFromNow({ value: 1, unit: 'minute' })
39
- const delta = result.getTime() - now
40
- assert.ok(
41
- approxEqual(delta, 60000),
42
- `Expected ~60000ms ahead, got ${delta}ms`
43
- )
44
- })
45
-
46
- test('returns a Date ~2 hours in the past', () => {
47
- const now = Date.now()
48
- const result = getRelativeTimeOffsetFromNow({ value: -2, unit: 'hour' })
49
- const delta = now - result.getTime()
50
- assert.ok(
51
- approxEqual(delta, 7200000),
52
- `Expected ~7200000ms ago, got ${delta}ms`
53
- )
54
- })
55
- })
56
- })
package/src/time-utils.ts DELETED
@@ -1,107 +0,0 @@
1
- type TimeUnit = 'second' | 'minute' | 'hour' | 'day' | 'week' | 'year'
2
-
3
- export interface RelativeTimeInput {
4
- value: number // negative = in the past
5
- unit: TimeUnit
6
- }
7
-
8
- const multipliers: Record<TimeUnit, number> = {
9
- second: 1,
10
- minute: 60,
11
- hour: 60 * 60,
12
- day: 60 * 60 * 24,
13
- week: 60 * 60 * 24 * 7,
14
- year: Math.round(365.25 * 60 * 60 * 24),
15
- }
16
-
17
- export const getRelativeTimeOffset = ({
18
- value,
19
- unit,
20
- }: RelativeTimeInput): number => {
21
- return Math.round(value * multipliers[unit]) * 1000 // convert to milliseconds
22
- }
23
-
24
- /**
25
- * Returns a Unix timestamp (in seconds) offset from now by the given duration.
26
- * e.g. value = -1 and unit = 'day' => 1 day ago => now - 86400 seconds
27
- */
28
- export const getRelativeTimeOffsetFromNow = (
29
- relativeTime: RelativeTimeInput
30
- ): Date => {
31
- return new Date(Date.now() + getRelativeTimeOffset(relativeTime))
32
- }
33
-
34
- /**
35
- * Get duration in milliseconds from a string or number
36
- * @param duration
37
- * @returns
38
- */
39
- export const getDurationInMilliseconds = (
40
- duration: string | number
41
- ): number => {
42
- if (typeof duration === 'number') {
43
- return duration
44
- }
45
- return parseDurationString(duration)
46
- }
47
-
48
- /**
49
- * Parse a duration string to milliseconds
50
- * Supports formats like: '2s', '5s', '5sec', '5seconds', '5m', '5min', '5minutes', '1h', '1hour', '2d', '2day', '1w', '1week'
51
- *
52
- * @param duration - Duration string (e.g., '2s', '5min', '2hours', '1day')
53
- * @returns Duration in milliseconds
54
- */
55
- export const parseDurationString = (duration: string): number => {
56
- const match = duration.match(
57
- /^(\d+)(ms|milliseconds?|s|sec|seconds?|m|min|minutes?|h|hour|hours?|d|day|days?|w|week|weeks?|y|year|years?)$/
58
- )
59
-
60
- if (!match) {
61
- throw new Error(
62
- `Invalid duration format: ${duration}. Use formats like '2s', '5s', '5min', '1hour', '2days', '1week'`
63
- )
64
- }
65
-
66
- const value = parseInt(match[1], 10)
67
- const unitStr = match[2]
68
-
69
- // Handle milliseconds specially
70
- if (
71
- unitStr === 'ms' ||
72
- unitStr === 'millisecond' ||
73
- unitStr === 'milliseconds'
74
- ) {
75
- return value
76
- }
77
-
78
- // Map string variations to TimeUnit
79
- let unit: TimeUnit
80
- if (
81
- unitStr === 's' ||
82
- unitStr === 'sec' ||
83
- unitStr === 'second' ||
84
- unitStr === 'seconds'
85
- ) {
86
- unit = 'second'
87
- } else if (
88
- unitStr === 'm' ||
89
- unitStr === 'min' ||
90
- unitStr === 'minute' ||
91
- unitStr === 'minutes'
92
- ) {
93
- unit = 'minute'
94
- } else if (unitStr === 'h' || unitStr === 'hour' || unitStr === 'hours') {
95
- unit = 'hour'
96
- } else if (unitStr === 'd' || unitStr === 'day' || unitStr === 'days') {
97
- unit = 'day'
98
- } else if (unitStr === 'w' || unitStr === 'week' || unitStr === 'weeks') {
99
- unit = 'week'
100
- } else if (unitStr === 'y' || unitStr === 'year' || unitStr === 'years') {
101
- unit = 'year'
102
- } else {
103
- throw new Error(`Unknown time unit: ${unitStr}`)
104
- }
105
-
106
- return getRelativeTimeOffset({ value, unit })
107
- }