@stripe/ui-extension-sdk

Stripe UI Extension SDK

For details on creating a Stripe App using this SDK, please refer to the Stripe App documentation.

Changelog

8.9.1

• Use fixed dependency versions.
• Fix test wrapper find methods.

8.9.0

• Add value prop to DateField component.
• Add deprecation notice to the background property on Box and Inline components' css prop. Use the backgroundColor property instead.
• Add deprecation notice to the className prop on Button and Link components.
• Add deprecation notice to the invalid prop on FormFieldGroup component.
• Add deprecation notice to the layout property on Box and Inline components' css prop. Use the stack property instead.
• Add deprecation notice to the tabKey prop on Tab and TabPanel components.
• Add deprecation notice to the border color properties (borderColor, borderTopColor, borderRightColor, borderBottomColor, borderLeftColor) on Box and Inline components' css prop. Use the keyline property for border styling instead.
• Remove deprecation notice from value and checked props.

8.8.0

• Add StripeFileUploader component
• Add platform prop to environment context
• Add appContext to the ExtensionContextValue type
• Add types for AuthorizedPermission and AuthorizedContentSecurityPolicy
• Add some utility functions for interacting with appContext
  • getUserAuthorizedPermissions: Gets the intersection of the app's authorized permissions and those of the current Dashboard user.
  • isPermissionAuthorized: Indicates if a permission is in the app's authorized permissions.
  • isSourceInAuthorizedCSP: Indicates if a URL is in the app's authorized connect or image sources.

8.7.0

• Add roles to the account passed to extensions in the userContext property

8.6.0

• Add secondaryAction prop to SignInView
• Add target to SignInView action props
• Allow both href and onPress on SignInView action props

8.5.0

• Add constants prop to environment context

8.4.1

• Add SignInView component

8.3.0

• Remove unsupported contentUses property from TableCell and TableHeaderCell typing
• Updated useToast to return show and dismiss utility methods

8.2.0

• StripeAppsHttpResponse.prototype.toJSON() now returns a rejected promise if the HTTP response body was empty
• Add support for calling fetchStripeSignature with nested JSON
• Fix debug to filter props according to all option
• Add tabKey to Tab and TabPanel
• Upgrade stripe package dependency to ^9.11.0
• Add external to Link
• Add setShown prop to FocusView
• Add showToast utility function for rendering toast notifications at the bottom of an app's view

8.1.0

• Fix ExtensionContextValue typing to mark name and objectContext values as possibly null
• Add textAlign to Box css
• Make onSave prop optional for SettingsView components
• Upgrade to @remote-ui/react 4.5.2
• Add Sparkline component

8.0.0

• Add deprecation notice to the value prop on TextArea, TextField, and Select components
• Add deprecation notice to the checked prop on Checkbox, Radio, and Switch components
• Remove unsupported outerRef props from inputs

7.1.0

• Add brandIcon and brandColor to ContextView

7.0.0

• Deprecate Notice component - use Banner
• Add overflowX and overflowY to Box css

6.3.1

• Internal update, no user-facing changes

6.3.0

• Add Banner component
• Add deprecation warning for Notice component
• Add locale to ExtensionContextValue['oauthContext']
• Add overflowWrap and wordBreak to Box css properties
• Add textTransform to Box and Inline css properties
• Add primaryAction, secondaryAction, and footerContent properties to ContextView.
• Add whiteSpace to Box css properties

6.2.0

• BarChart and LineChart improvements:
  • Configurable axis formatting
  • Configurable value formatting
  • Configurable channel domains
  • Configurable channel ranges
  • Show/hide axis labels and ticks in charts
  • Show/hide grid lines in charts
  • Show/hide tooltips in chart presets
  • Show/hide legends in chart presets

6.1.0

• Add a confirmation dialog to FocusView
• Add Chip and ChipList components
• Update the getDashboardUserEmail utility to return the email directly and reject the promise if there's an error
• Fix React components not being accepted in the label prop of form elements
• Expose text-overflow: ellipsis and word-wrap: normal | break-word on Box css
• Add country to the account passed to extensions in the userContext property
• Add data: URL support for the Img component - docs

6.0.0

• Deprecate email in view context
• Consolidated utilites in /utils path
• Fixed react-reconciler dependency issue affecting unit tests

5.0.1

• Fix prop types for Switch, Checkbox and Radio

5.0.0

• Adds the Accordion, Icon, Spinner, and Tooltip components
• Adds tooltips to BarChart and LineChart
• Fix prop typing for BarChart and LineChart
• Deprecates legacy view context parameters
• Enables setting width via css={{ width: ... }} on Select, TextArea, TextField, Button, and Link
• Enables setting internal horizontal alignment via css={{ alignX: ... }} on Button and Link
• Adds the clipboardWriteText function
• Adds the getDashboardUserEmail function

4.0.0

• Deprecates the slot property

3.2.0

• Adds the createOAuthState function
• Adds oauthContext to the ExtensionContextValue type

3.1.0

• Adds the Img component

3.0.0

• Adds support for the Notice, Charts, and Tabs components
• Breaking changes:
  • ListItem: Previously, content passed as children would be the primary content rendered in the component. Now, main content is passed to the title prop. The description slot has also been reassigned to a secondaryTitle prop.
  • MenuTrigger: This component has been deprecated in favor of a trigger prop on the Menu component. Slot API usage has also been removed.
• Removed permissions from being passed into the user context.

2.2.1

• Expose docs.json files in dist

2.2.0

• Add actions prop to ContextView.

2.1.0

• Introduces ButtonGroup component.
• Removes margin-bottom from form controls.
• Gives Button white-space: nowrap and alignY: center by default.
• Button themes now set a min-height on all size variants.
• Makes Link and Button shrink to fit their content.
• Exposes defaultValue attribute on TextField and TextArea.
• Allows error and description to be hidden on form controls via the hiddenElements prop.
• Exposes invalid and size props on Select and TextArea.
• Exposes defaultChecked attribute on Radio.
• Exposes resizeable and rows props on TextArea.
• Fixes invalid state on control components.
• Fixes Chip onDropdown firing twice.
• Fixes Divider rendering.

2.0.3

• Returns a promise from useRefreshDashboardData that resolves after dashboard data is refreshed.
• Adds fetchStripeSignature method that optionally accepts additional request payload. Signature can be used to make authenticated request to your app's backend. See the docs for details.
• Fixes an issue where the test element check method .is would sometimes fail to identify a component.

2.0.2

• Fixes an issue with the testing package in which comopnents with fragment props were not findable using wrapper.find()

2.0.1

• Pulls in updated dependency that fixes #55 and #161

2.0.0

• Fixes a render error with SettingsView
• Updates SettingsView types to match the available component props
• Adds a getMockContextProps helper for testing. See the docs for details.
• List component now accepts React.ReactNode as a valid type to the value prop, rather than just a string.
• Adds hover state to ListItem components
• Updates ListItem component such that hover state is only visible when there is an action associated
• Fix Select rendering when multiple is true
• Fix Checkbox onChange firing twice

1.1.7

• Adds a "testing" module, which includes helpers for writing Jest tests for apps. See the docs for details.
• Fixes some components that take React nodes as props
  • MenuGroup now supports the title prop
  • FocusView now supports the footerContent prop
  • SettingsView now supports the headerActions prop
• Some type fixes and grammar updates.

1.1.6

• Added types for FocusView, SettingsView, and ContextView
• Exporting a new constant STRIPE_API_KEY from http_client to be used when initializing the Stripe API client.