@stytch/nextjs 0.0.0-next-20240815193523

package/CHANGELOG.md

@@ -0,0 +1,392 @@
+# @stytch/nextjs
+
+## 0.0.0-next-20240815193523
+
+### Patch Changes
+
+- Updated dependencies [c23db6cd]
+  - @stytch/vanilla-js@0.0.0-next-20240815193523
+
+## 20.3.3
+
+### Patch Changes
+
+- 6d06cce0: Load Admin Portal components from vanilla-js directly
+
+## 20.3.2
+
+### Patch Changes
+
+- 7d2c2878: Fix admin portal component props
+
+## 20.3.1
+
+### Patch Changes
+
+- 089c986a: Guard references to localStorage and sessionStorage
+
+## 20.3.0
+
+### Minor Changes
+
+- 3183b459: Add `AdminPortalMemberManagement` component to `@stytch/nextjs/b2b/adminPortal`
+
+## 20.2.0
+
+### Minor Changes
+
+- 1ade8d93: Add `AdminPortalOrgSettings` component to `@stytch/nextjs/b2b/adminPortal`
+
+## 20.1.0
+
+### Minor Changes
+
+- a99f21b8: Add `AdminPortalSSO` component to `@stytch/nextjs/b2b/adminPortal`
+
+### Patch Changes
+
+- Updated dependencies [0f448e7e]
+- Updated dependencies [a99f21b8]
+  - @stytch/vanilla-js@4.13.0
+
+## 20.0.0
+
+### Patch Changes
+
+- Updated dependencies [cbab0c30]
+  - @stytch/vanilla-js@4.12.0
+
+## 19.0.0
+
+### Major Changes
+
+- a0fbe9f: Update minimum peer dependency on `@stytch/vanilla-js` to `^4.9.0`
+
+### Patch Changes
+
+- Updated dependencies [a0fbe9f]
+- Updated dependencies [a0fbe9f]
+  - @stytch/vanilla-js@4.9.0
+
+## 18.0.0
+
+### Patch Changes
+
+- Updated dependencies [f604dcb]
+  - @stytch/vanilla-js@4.7.0
+
+## 17.0.1
+
+### Patch Changes
+
+- 50de202: Fix B2B headless entrypoint to import `@stytch/vanilla-js` rather than bundle it
+  - @stytch/vanilla-js@4.4.3
+
+## 17.0.0
+
+### Minor Changes
+
+- 223e30e: Add `useStytchOrganization` hook for B2B
+
+### Patch Changes
+
+- Updated dependencies [223e30e]
+  - @stytch/vanilla-js@4.2.0
+
+## 16.0.1
+
+### Patch Changes
+
+- e6832cb: Fix an issue where `fromCache` would not update to `false` after cached data was refreshed
+- Updated dependencies [e6832cb]
+  - @stytch/vanilla-js@4.1.1
+
+## 16.0.0
+
+### Patch Changes
+
+- Updated dependencies [2379b29]
+  - @stytch/vanilla-js@4.1.0
+
+## 15.0.0
+
+### Minor Changes
+
+- 6890694: Mark stytch.member as deprecated in favor of stytch.self
+  Adds RBAC functionality
+
+### Patch Changes
+
+- Updated dependencies [9ee61b3]
+- Updated dependencies [b34293a]
+- Updated dependencies [c3c108b]
+- Updated dependencies [6890694]
+  - @stytch/vanilla-js@4.0.0
+
+## 14.0.0
+
+### Patch Changes
+
+- Updated dependencies [ec1962c]
+  - @stytch/vanilla-js@3.2.0
+
+## 13.0.0
+
+### Minor Changes
+
+- 8cff174: B2C Passkeys Headless Support & UI components
+
+### Patch Changes
+
+- Updated dependencies [8cff174]
+  - @stytch/vanilla-js@3.1.0
+
+## 12.0.0
+
+### Major Changes
+
+- 5dd9d24: Change export of B2B Headless Client to seperate subpackage to improve tree-shaking performance
+
+  Two public export locations have changed:
+
+  ```javascript
+  import { createStytchB2BHeadlessClient } from '@stytch/nextjs/b2b';
+  ```
+
+  Is now updated to
+
+  ```javascript
+  import { createStytchB2BHeadlessClient } from '@stytch/vanilla-js/b2b/headless';
+  ```
+
+  ```javascript
+  import { createStytchB2BUIClient } from '@stytch/nextjs/b2b';
+  ```
+
+  Is now updated to
+
+  ```javascript
+  import { createStytchB2BUIClient } from '@stytch/vanilla-js/b2b/ui';
+  ```
+
+### Patch Changes
+
+- Updated dependencies [5dd9d24]
+  - @stytch/vanilla-js@3.0.0
+
+## 11.0.0
+
+### Patch Changes
+
+- 47eb388: Add Device Fingerprinting to the React Native SDK
+- Updated dependencies [47eb388]
+- Updated dependencies [d008ef5]
+- Updated dependencies [47eb388]
+- Updated dependencies [7c1940e]
+  - @stytch/vanilla-js@2.2.0
+
+## 10.0.0
+
+### Patch Changes
+
+- Updated dependencies [67d42f0]
+  - @stytch/vanilla-js@2.1.0
+
+## 9.0.1
+
+### Patch Changes
+
+- 0a18c34: Add docs for new verified fields on Member objects, and fix some docs links
+- Updated dependencies [9fd5d96]
+- Updated dependencies [0a18c34]
+  - @stytch/vanilla-js@2.0.1
+
+## 9.0.0
+
+### Major Changes
+
+- a4083c7: Breaking Changes: The intermediate session token (IST) will no longer be accepted as an argument for the discovery list organizations, intermediate sessions exchange, and create organization via discovery endpoints. The IST will be passed in automatically. ISTs are stored as browser cookies or persisted on device when they are generated after calls to discovery authenticate endpoints, such as email magic link discovery authenticate, or primary authenticate endpoints in the case where MFA is required, such as email magic link authenticate or SSO authenticate.
+
+  New Features: Our B2B product now supports multi-factor authentication (MFA) with one-time passcodes (OTPs) via SMS. MFA policies can be set on the Organization level or on the Member level. See the Stytch docs for more information.
+
+### Patch Changes
+
+- Updated dependencies [a4083c7]
+  - @stytch/vanilla-js@2.0.0
+
+## 8.0.0
+
+### Patch Changes
+
+- Updated dependencies [e7302d7]
+  - @stytch/vanilla-js@1.1.0
+
+## 7.0.0
+
+### Patch Changes
+
+- Updated dependencies [f9c36c9]
+  - @stytch/vanilla-js@1.0.0
+
+## 6.0.1
+
+### Patch Changes
+
+- 3623a8a: Exclude @stytch/vanilla-js/b2b in rollup
+
+## 6.0.0
+
+### Minor Changes
+
+- c8e2d0b: B2B Passwords UI components
+
+### Patch Changes
+
+- Updated dependencies [c8e2d0b]
+  - @stytch/vanilla-js@0.14.0
+
+## 5.0.2
+
+### Patch Changes
+
+- 0d80d2e: Fix for the onEvent callback while creating a new organization in the B2B SDK UI. Missing export for the nextjs B2B package
+- Updated dependencies [0d80d2e]
+  - @stytch/vanilla-js@0.13.4
+
+## 5.0.1
+
+### Patch Changes
+
+- 8c54ee1: Missing export in the nextjs SDK for the UI component
+
+## 5.0.0
+
+### Minor Changes
+
+- 15dbe7d: Releasing UI components for our B2B SDKs.
+
+### Patch Changes
+
+- Updated dependencies [15dbe7d]
+  - @stytch/vanilla-js@0.13.0
+
+## 4.0.0
+
+### Patch Changes
+
+- 6a27584: Make organization name and slug optional for discovery organization create
+- Updated dependencies [dde1f2a]
+- Updated dependencies [6a27584]
+  - @stytch/vanilla-js@0.12.0
+
+## 3.0.2
+
+### Patch Changes
+
+- 79ca7ba: Add locale argument to B2B email magic link methods
+- Updated dependencies [79ca7ba]
+  - @stytch/vanilla-js@0.11.3
+
+## 3.0.1
+
+### Patch Changes
+
+- c924765: Include the b2b directory in package.json for the B2B SDK entrypoint
+- Updated dependencies [c924765]
+  - @stytch/vanilla-js@0.11.2
+
+## 3.0.0
+
+### Minor Changes
+
+- c0e42bc: Add B2B Discovery headless client and session exchange method
+
+### Patch Changes
+
+- Updated dependencies [c0e42bc]
+  - @stytch/vanilla-js@0.11.0
+
+## 2.0.3
+
+### Patch Changes
+
+- 1652706: Fix session/user persisting after logging out
+- Updated dependencies [1652706]
+  - @stytch/vanilla-js@0.10.7
+
+## 2.0.2
+
+### Patch Changes
+
+- ca5a31d: SDK-877 Fix session/user persisting after logging out
+- Updated dependencies [ca5a31d]
+  - @stytch/vanilla-js@0.10.6
+
+## 2.0.1
+
+### Patch Changes
+
+- f1810c4: Add React Native OAuth callback, PKCE fix
+- Updated dependencies [f1810c4]
+  - @stytch/vanilla-js@0.10.2
+
+## 2.0.0
+
+### Minor Changes
+
+- Launching B2B SDKs
+
+### Patch Changes
+
+- Updated dependencies
+  - @stytch/vanilla-js@0.10.0
+
+## 1.2.0
+
+### Patch Changes
+
+- Updated dependencies
+  - @stytch/vanilla-js@0.9.0
+
+## 0.6.0
+
+### Minor Changes
+
+- Add support for template ID parameters to Magic link Login or create and Send methods, Email OTP Login or create and Send methods, and Reset Password Start
+
+### Patch Changes
+
+- Updated dependencies
+- Updated dependencies [ac0cf89]
+  - @stytch/vanilla-js@0.6.0
+
+## 0.5.0
+
+### Patch Changes
+
+- 422c698: Add type definitions for User Metadata fields
+- Updated dependencies [422c698]
+- Updated dependencies
+  - @stytch/vanilla-js@0.5.0
+
+## 0.4.6
+
+### Patch Changes
+
+- Add support for custom email domains in magic link confirmation screen
+- Updated dependencies
+  - @stytch/vanilla-js@0.4.6
+
+## 0.4.5
+
+### Patch Changes
+
+- Reset Password component
+
+## 0.4.4
+
+### Patch Changes
+
+- Send methods in the SDK
+- Updated dependencies
+  - @stytch/vanilla-js@0.4.4

package/LICENSE

@@ -0,0 +1,17 @@
+MIT License
+Copyright (c) 2021 stytchauth
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,177 @@
+# @stytch/nextjs
+
+Stytch's Next.js Library
+
+## Install
+
+With `npm`
+`npm install @stytch/nextjs @stytch/vanilla-js --save`
+
+## Documentation
+
+This package contains several entrypoints, depending on if you are using the B2B or B2C stytch product.
+
+```javascript
+// Stytch B2C Product
+import { StytchProvider } from '@stytch/nextjs';
+import { createStytchUIClient } from '@stytch/nextjs/ui';
+// The headless client does not bundle UI elements, and is a much smaller package
+import { createStytchHeadlessClient } from '@stytch/nextjs/headless';
+
+// Stytch B2B Product
+import { StytchB2B } from '@stytch/nextjs/b2b';
+import { createStytchB2BUIClient } from '@stytch/nextjs/b2b/ui';
+// The headless client does not bundle UI elements, and is a much smaller package
+import { createStytchB2BHeadlessClient } from '@stytch/nextjs/b2b/headless';
+```
+
+For full documentation please refer to Stytch's javascript SDK documentation on https://stytch.com/docs/sdks/javascript-sdk.
+
+## Example Usage
+
+```javascript
+import { StytchProvider } from '@stytch/nextjs';
+import { createStytchUIClient } from '@stytch/nextjs/ui';
+
+const stytch = createStytchUIClient('public-token-<find yours in the stytch dashboard>');
+
+// Wrap your App in the StytchProvider
+ReactDOM.render(
+  <StytchProvider stytch={stytch}>
+    <App />
+  </StytchProvider>,
+  document.getElementById('root'),
+);
+
+// Now use Stytch in your components
+const App = () => {
+  const stytchProps = {
+    config: {
+      products: ['emailMagicLinks'],
+      emailMagicLinksOptions: {
+        loginRedirectURL: 'https://example.com/authenticate',
+        loginExpirationMinutes: 30,
+        signupRedirectURL: 'https://example.com/authenticate',
+        signupExpirationMinutes: 30,
+        createUserAsPending: true,
+      },
+    },
+    styles: {
+      container: { width: '321px' },
+      colors: { primary: '#0577CA' },
+      fontFamily: '"Helvetica New", Helvetica, sans-serif',
+    },
+    callbacks: {
+      onEvent: (message) => console.log(message),
+      onSuccess: (message) => console.log(message),
+      onError: (message) => console.log(message),
+    },
+  };
+
+  return (
+    <div id="login">
+      <StytchLogin config={stytchProps.config} styles={stytchProps.styles} callbacks={stytchProps.callbacks} />
+    </div>
+  );
+};
+```
+
+## Typescript Support
+
+There are built in typescript definitions in the npm package.
+
+## Migrating from @stytch/stytch-react
+
+If you are migrating from [@stytch/stytch-react](https://www.npmjs.com/package/@stytch/stytch-react), follow the steps below:
+
+### Step 1: Install the new libraries
+
+- The core SDK is now bundled in its own module - [@stytch/vanilla-js](https://www.npmjs.com/package/@stytch/vanilla-js)
+- We now have a library specifically for NextJS bindings - [@stytch/nextjs](https://www.npmjs.com/package/@stytch/nextjs)
+
+```shell
+# NPM
+npm install @stytch/vanilla-js @stytch/nextjs
+# Yarn
+yarn add @stytch/vanilla-js @stytch/nextjs
+```
+
+### Step 2: Remove the old SDK
+
+- Remove the `@stytch/stytch-react` package
+- If you are explicitly loading the `stytch.js` script via a blocking `beforeInteractive` tag in the document header, remove it. It isn't needed anymore.
+
+```shell
+# NPM
+npm rm @stytch/stytch-react
+# Yarn
+yarn remove @stytch/stytch-react
+```
+
+### Step 3: Initialize the Stytch client in `_app.js`
+
+- Determine if you need the Headless or UI client. If you plan to use the `<StytchLogin />` component in your application then you should use the the UI client. Otherwise use the Headless client to minimize application bundle size.
+- To create the Stytch Headless client, use `createStytchHeadlessClient` from `@stytch/nextjs/headless`
+- To create the Stytch UI client, use `createStytchUIClient` from `@stytch/nextjs/ui`
+- Pass it into `<StytchProvider />` component from `@stytch/nextjs`
+
+```jsx
+import React from 'react';
+import { StytchProvider } from '@stytch/nextjs';
+import { createStytchHeadlessClient } from '@stytch/nextjs/headless';
+// Or alternately
+// import { createStytchUIClient } from '@stytch/nextjs/ui';
+
+const stytch = createStytchHeadlessClient(process.env.NEXT_PUBLIC_STYTCH_PUBLIC_TOKEN);
+
+function MyApp({ Component, pageProps }) {
+  return (
+    <StytchProvider stytch={stytch}>
+      <Component {...pageProps} />
+    </StytchProvider>
+  );
+}
+
+export default MyApp;
+```
+
+### Step 4: Update calls to `useStytchUser` , `useStytchSession`, and `useStytchLazy`
+
+- `useStytchUser` and `useStytchSession` hooks now return envelope objects - `{ user, isInitialized, isCached }` and `{ session, isInitialized, isCached }` respectively.
+  - In SSR/SSG contexts, as well as the first clientside render, `user`/`session` will be null and `isInitialized` will be false
+  - The SDK will read `user`/`session` out of persistent storage, and rerender with `isCached: true` - at this point you’re reading the [stale-while-revalidating](https://swr.vercel.app/) value
+  - The SDK will make network requests to pull the most up-to-date user and session objects, and serve them with `isCached: false`
+- `useStytchLazy` is no longer required - you may always call `useStytch` now
+
+```jsx
+import React, { useEffect } from 'react';
+import { useRouter } from 'next/router';
+import { useStytchUser } from '@stytch/nextjs';
+
+export default function Profile() {
+  const router = useRouter();
+  const { user, isInitialized } = useStytchUser();
+
+  useEffect(() => {
+    if (isInitialized && user === null) {
+      router.push('/login');
+    }
+  }, [user, isInitialized]);
+
+  return (
+    <Layout>
+      <h1>Your Profile</h1>
+      <pre>{JSON.stringify(user, null, 2)}</pre>
+    </Layout>
+  );
+}
+```
+
+### Step 5: UI Naming Changes
+
+We've made a number of small changes to our naming conventions to make the API cleaner and easier to understand.
+
+- The `<Stytch />` login component is now called `<StytchLogin />`
+- The `OAuthProvidersTypes` enum is now called `OAuthProviders`
+- The `SDKProductTypes` enum is now called `Products`
+- There are some additional changes to the `styles` config documented [here](https://stytch.com/docs/sdks/javascript-sdk#resources_migration-guide_v-zero-five)

package/b2b/adminPortal/package.json

@@ -0,0 +1,6 @@
+{
+  "internal": true,
+  "main": "../../dist/adminPortal/index.js",
+  "module": "../../dist/adminPortal/index.esm.js",
+  "types": "../../dist/adminPortal/index.d.ts"
+}

package/b2b/headless/package.json

@@ -0,0 +1,6 @@
+{
+  "internal": true,
+  "main": "../../dist/b2b/index.headless.js",
+  "module": "../../dist/b2b/index.headless.esm.js",
+  "types": "../../dist/b2b/index.headless.d.ts"
+}

package/b2b/package.json

@@ -0,0 +1,6 @@
+{
+  "internal": true,
+  "main": "../dist/b2b/index.js",
+  "module": "../dist/b2b/index.esm.js",
+  "types": "../dist/b2b/index.d.ts"
+}

package/b2b/ui/package.json

@@ -0,0 +1,6 @@
+{
+  "internal": true,
+  "main": "../../dist/b2b/index.ui.js",
+  "module": "../../dist/b2b/index.ui.esm.js",
+  "types": "../../dist/b2b/index.ui.d.ts"
+}