feat!: add improved logs command

docs/commands/logs.md

@@ -65,21 +65,29 @@
 
 **Arguments**
 
-- functionName - Name of the function to stream logs for
+- functionNames - Names of the functions to stream logs for
 
 **Flags**
 
 - `filter` (*string*) - For monorepos, specify the name of the application to run the command in
 - `level` (*string*) - Log levels to stream. Choices are: trace, debug, info, warn, error, fatal
+- `since` (*string*) - Start of the historical log window. Accepts a duration (e.g. 10m, 1h, 24h, 2d) or an ISO 8601 timestamp
+- `url` (*string*) - Show logs for the deploy behind the given URL. Supports deploy permalinks and branch subdomains
 - `debug` (*boolean*) - Print debugging information
 - `auth` (*string*) - Netlify auth token - can be used to run this command without logging in
+- `until` (*string*) - End of the historical log window. Accepts a duration or an ISO 8601 timestamp (defaults to now)
 
 **Examples**
 
 ```bash
 netlify logs:function
 netlify logs:function my-function
+netlify logs:function my-function other-function
 netlify logs:function my-function -l info warn
+netlify logs:function my-function --since 1h
+netlify logs:function my-function --since 24h
+netlify logs:function my-function --since 2026-04-14T00:00:00Z --until 2026-04-15T00:00:00Z
+netlify logs:function --url https://my-branch--my-site.netlify.app --since 30m
 ```
 
 ---

package.json

@@ -138,6 +138,7 @@
     "p-map": "7.0.3",
     "p-wait-for": "6.0.0",
     "parallel-transform": "1.2.0",
+    "parse-duration": "^2.1.6",
     "parse-github-url": "1.0.3",
     "pg": "8.20.0",
     "prettyjson": "1.2.5",