Breaking changes:

• The .close() method in the Interval class has been renamed to .immediatelyClose() for clarity.
• The interval.actions.enqueue() and interval.actions.dequeue() methods have been moved to simply interval.enqueue() and interval.dequeue() respectively.
• The title property in ctx.loading.start and ctx.loading.update has been renamed to label for consistency.
• The title property in the return type of io.display.grid renderItem function has been renamed to label for consistency.

New:

• Added support for a preview UI that preserves action context across IO method calls and removes the need to "Continue" for display-only informational renders. Please let us know if you would like to test this feature before general availability!
• Added the .safelyClose() method to Interval to safely shut down a deployment without losing work or interrupting users.
• The defaultValue property for all supported IO methods now also accept null in addition to undefined.
• Added copy and download buttons to io.display.code, io.display.object, and code blocks in io.display.markdown.
• Added inline IDE documentation to IO methods.

Fixed:

• Fixed an issue with some userland errors not being surfaced in Pages.
• Many small fixes and UI improvements!

New:

• Added the .multiple() chained method to io.search and io.input.file, which allows accepting multiple values in a single input.
• Added optional defaultValue property to io.search.

Fixed:

• Fixed a phantom import which caused issues in some non-hoisting package managers like pnpm.

New:

• Added io.display.grid method for visually focused collections of data, usually with an emphasis on images.
• Added isFilterable and isSortable props to io.display.table and io.select.table for disabling filtering and sorting if desired — this can be useful for tables with asynchronous data.
• Added quiet logging level to the Interval client to reduce terminal console logging, enable by adding logLevel: "quiet" property to the Interval constructor.
• The string shorthand for columns and accessorKey values in io.display.table and io.select.table are now type checked against your input data. Rest assured knowing that your columns are defined in your data!

Fixed:

• Errors in asynchronous method state change handlers like io.display.table's getData function are now properly displayed in both the host terminal console and the web dashboard (#19).

New:

• Pages, a lightweight way to display data to complement actions, are now in public beta!
• Introducing Interval Direct Connect! In all previous Interval versions connections between your app and your users' browsers are relayed through Interval. We're removing this relay step, allowing for a direct connection under the hood between your app and your users. We're still finalizing benchmarks, but the early results from our internal testing indicate that this will be the single biggest upgrade to the performance of Interval apps so far. This new functionality is currently in private beta. If you'd like to try the Direct Connect beta, let us know and we'll enable it for your account.

Breaking changes:

• When you update your SDK version, you'll no longer be able to set permissions for your actions through the dashboard. Instead, you can now define them directly in your code. Any permissions you previously set through the dashboard will continue to function normally.

New:

• Permissions for actions can now be defined in code.

Breaking changes:

• The io.experimental.input.file method has been promoted to io.input.file.

New:

• Added optional image property support to io.select.single's options and io.search's renderResult output, which allows customizing the image's size and alt tag (replaces the now-deprecated imageUrl property).

Fixed:

• Fixed an issue with io.search methods inside of an io.group sometimes throwing an error.

New:

• Added new io.display.metadata method for displaying a series of label/value data pairs in several available layouts.
• Added new level, description and menuItems properties to io.display.heading.

New:

• The columns object in io.display.table and io.select.table now accept an accessorKey property, allowing renaming column names with shorthand key-based access instead of needing to specify a renderCell callback.
• The io.display.table method now accepts an optional getData property for fetching table data asynchronously in advanced use cases.

New:

• The io.group method now accepts objects with string keys as its first argument, allowing return value retrieval by key instead of index.
• Adds io.confirmIdentity method to request re-authentication before performing sensitive work within actions.

New:

• Adds new io.display.code method to render source code with syntax highlighting.
• Cells in io.select.table and io.display.table can now contain inline images by returning an object containing an image property from the renderCell method.

New:

• Adds new io.display.video method to display videos.
• Improves data transmission, sorting, and searching in io.display.table and io.select.table.

New:

• Adds new io.display.image method as a first-class way to display images. No more needing to fall back to markdown!
• Adds optional secondary argument to io.group to customize the continue button label and theme.

New:

• Adds defaultPageSize property to io.display.table and io.select.table to customize the default number of items per page.
• Adds ctx.redirect() method to redirect the user to another action or external URL in their current window.

Breaking changes:

• The experimental .use() method for adding action groups has been renamed to .addGroup().

New:

• Added a method for dynamically adding actions.
• Added a method for dynamically removing actions.
• Menus containing links to other actions or external URLs can now be added to rows in io.select.table and io.display.table with the new rowMenuItems prop.

Breaking changes:

• io.experimental.date is now io.input.date.
• io.experimental.time is now io.input.time.
• io.experimental.datetime is now io.input.datetime.

New:

• io.input.url is a new method that prompts the user for a URL and returns a JavaScript URL object.
• All input and select I/O methods now accept an optional disabled prop, which disables the input in the UI.
• io.experimental.input.file now accepts an optional generatePresignedUrls() function that can be used to upload files directly to your own S3-compatible cloud storage (example).

Breaking changes:

• The href properties in io.display.link, io.display.table and io.select.table have been renamed to url.

New:

• ctx.action now contains a url property containing the absolute URL to the currently running action.
• io.select.single and io.select.multiple now support numbers, booleans, or Date objects as option labels and values.
• io.search now supports numbers, booleans, or Date objects as result labels.

Fixed:

• Clicking an io.display.link which links to the currently running action will now create a new transaction (including any URL params, if specified).

New:

• I/O methods and groups now support custom validation through the .validate() API.

Fixed:

• The SDK now detects and warns if calls to io.select.single or io.select.multiple include a defaultValue that is not also included within the provided options array.

Breaking changes:

• The undocumented io.experimental.findAndSelectUser IO method has been removed in favor of the more powerful io.search.

New:

• IO methods can now be conditionally marked as optional by providing a boolean value to optional().
• Action names and descriptions can now be defined in code.
• Strings can be used as options directly in io.select.single and io.select.multiple.
• Table columns definitions can now be arrays of string property names, allowing a subset of columns to be displayed without needing to use the more verbose column definitions syntax in io.display.table and io.select.table.

Fixed:

• TypeScript will now properly indicate when an IO method call requires a properties argument (for example io.display.table). Thanks to Petr for reporting this bug!

Breaking changes:

• The io.experimental.upload.toUrl IO method has been replaced with io.experimental.input.file.

New:

• Adds an experimental io.experimental.input.file method. This method replaces our previous toUrl method. This new API returns an object with methods that allow you to get a URL that points to the uploaded file or the contents of the file as an object, a buffer, or a string.
• BigInt objects can now be used within io.display.object and in action return values.

Especially while APIs are under an experimental flag, we encourage you to leave feedback to help shape Interval's future.

This release adds a new experimental API for uploading files within actions. At the moment, these files are uploaded to Interval's S3 bucket. In a future release, we intend to allow you to upload directly to an S3 bucket that you control.

New:

• Adds an experimental io.experimental.upload.toUrl method (replaced with io.experimental.input.file in v0.20.0).

Especially while APIs are under an experimental flag, we encourage you to leave feedback to help shape Interval's future.