@seamapi/react 0.15.1 → 0.16.0

package/lib/SeamProvider.d.ts

@@ -1,20 +1,28 @@
 import { type PropsWithChildren } from 'react';
 import type { Seam, SeamClientOptions } from 'seamapi';
 declare global {
-    var seam: Omit<SeamProviderProps, 'children'> | undefined;
+    var seam: SeamProviderProps | undefined;
 }
 export interface SeamContext {
     client: Seam | null;
-    clientOptions?: SeamClientOptions | undefined;
+    clientOptions?: AllowedSeamClientOptions | undefined;
     publishableKey?: string | undefined;
     userIdentifierKey?: string | undefined;
+    clientSessionToken?: string | undefined;
 }
-export interface SeamProviderProps {
-    client?: Seam;
-    publishableKey?: string;
+type SeamProviderProps = SeamProviderPropsWithClient | (SeamProviderPropsWithPublishableKey & AllowedSeamClientOptions) | (SeamProviderPropsWithClientSessionToken & AllowedSeamClientOptions);
+interface SeamProviderPropsWithClient {
+    client: Seam;
+}
+interface SeamProviderPropsWithPublishableKey {
+    publishableKey: string;
     userIdentifierKey?: string;
-    endpoint?: string;
 }
+interface SeamProviderPropsWithClientSessionToken {
+    clientSessionToken: string;
+}
+type AllowedSeamClientOptions = Pick<SeamClientOptions, 'endpoint'>;
 export declare function SeamProvider({ children, ...props }: PropsWithChildren<SeamProviderProps>): JSX.Element;
 export declare const seamContext: import("react").Context<SeamContext>;
 export declare function useSeamContext(): SeamContext;
+export {};

package/lib/SeamProvider.js

@@ -17,8 +17,7 @@ export function SeamProvider({ children, ...props }) {
     return (_jsx("div", { className: 'seam-components', children: _jsx(QueryClientProvider, { client: queryClientRef.current, children: _jsx(Provider, { value: { ...contextRef.current }, children: children }) }) }));
 }
 const createDefaultSeamContextValue = () => {
-    if (globalThis.seam?.client == null &&
-        globalThis.seam?.publishableKey == null) {
+    if (globalThis.seam == null) {
         return { client: null };
     }
     try {
@@ -30,23 +29,28 @@ const createDefaultSeamContextValue = () => {
         return { client: null };
     }
 };
-const createSeamContextValue = ({ client, ...options }) => {
-    if (client == null && Object.keys(options).length === 0) {
-        return { client: null };
+const createSeamContextValue = (options) => {
+    if (isSeamProviderPropsWithClient(options)) {
+        return options;
     }
-    if (client != null && Object.values(options).some((v) => v == null)) {
-        throw new Error('Cannot provide both a Seam client along with other options.');
+    if (isSeamProviderPropsWithClientSessionToken(options)) {
+        const { clientSessionToken, ...clientOptions } = options;
+        return {
+            clientSessionToken,
+            clientOptions,
+            client: null,
+        };
     }
-    const { publishableKey, userIdentifierKey, ...clientOptions } = options;
-    if (client != null) {
-        return { client };
+    if (isSeamProviderPropsWithPublishableKey(options)) {
+        const { publishableKey, userIdentifierKey, ...clientOptions } = options;
+        return {
+            publishableKey,
+            userIdentifierKey,
+            clientOptions,
+            client: null,
+        };
     }
-    return {
-        client: null,
-        publishableKey,
-        userIdentifierKey,
-        clientOptions,
-    };
+    throw new Error('Invalid SeamProvider options');
 };
 const defaultSeamContextValue = createDefaultSeamContextValue();
 export const seamContext = createContext(defaultSeamContextValue);
@@ -57,4 +61,46 @@ export function useSeamContext() {
     }
     return context;
 }
+const isSeamProviderPropsWithClient = (props) => {
+    if (!('client' in props))
+        return false;
+    const { client } = props;
+    if (client == null)
+        return false;
+    if (Object.values(props).some((v) => v == null)) {
+        throw new Error('Cannot provide a Seam client along with other options.');
+    }
+    return true;
+};
+const isSeamProviderPropsWithPublishableKey = (props) => {
+    if (!('publishableKey' in props))
+        return false;
+    const { publishableKey } = props;
+    if (publishableKey == null)
+        return false;
+    if ('client' in props && props.client != null) {
+        throw new Error('Cannot provide a Seam client along with other options.');
+    }
+    if ('clientSessionToken' in props && props.clientSessionToken != null) {
+        throw new Error('Cannot provide both a publishableKey and a clientSessionToken.');
+    }
+    return true;
+};
+const isSeamProviderPropsWithClientSessionToken = (props) => {
+    if (!('clientSessionToken' in props))
+        return false;
+    const { clientSessionToken } = props;
+    if (clientSessionToken == null)
+        return false;
+    if ('client' in props && props.client != null) {
+        throw new Error('Cannot provide a Seam client along with other options.');
+    }
+    if ('publishableKey' in props && props.publishableKey != null) {
+        throw new Error('Cannot provide both a clientSessionToken and a publishableKey .');
+    }
+    if ('userIdentifierKey' in props && props.userIdentifierKey != null) {
+        throw new Error('Cannot use a userIdentifierKey with a clientSessionToken.');
+    }
+    return true;
+};
 //# sourceMappingURL=SeamProvider.js.map

package/lib/SeamProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"SeamProvider.js","sourceRoot":"","sources":["../src/lib/SeamProvider.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"SeamProvider.js","sourceRoot":"","sources":["../src/lib/SeamProvider.tsx"],"names":[],"mappings":"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"}

package/lib/seam/use-seam-client.js

@@ -3,15 +3,30 @@ import { Seam } from 'seamapi';
 import { v4 as uuidv4 } from 'uuid';
 import { useSeamContext } from '../../lib/SeamProvider.js';
 export function useSeamClient() {
-    const { client, clientOptions, publishableKey, ...context } = useSeamContext();
-    const userIdentifierKey = useUserIdentifierKeyOrFingerprint(context.userIdentifierKey);
+    const { client, clientOptions, publishableKey, clientSessionToken, ...context } = useSeamContext();
+    const userIdentifierKey = useUserIdentifierKeyOrFingerprint(clientSessionToken != null ? '' : context.userIdentifierKey);
     const { isLoading, isError, error, data } = useQuery({
-        queryKey: ['client', { client, userIdentifierKey }],
+        queryKey: [
+            'client',
+            {
+                client,
+                clientOptions,
+                publishableKey,
+                userIdentifierKey,
+                clientSessionToken,
+            },
+        ],
         queryFn: async () => {
             if (client != null)
                 return client;
+            if (clientSessionToken != null) {
+                return new Seam({
+                    ...clientOptions,
+                    clientSessionToken,
+                });
+            }
             if (publishableKey == null) {
-                throw new Error('Missing publishableKey');
+                throw new Error('Missing either a client, publishableKey, or clientSessionToken');
             }
             const res = await Seam.getClientSessionToken({
                 ...clientOptions,

package/lib/seam/use-seam-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-seam-client.js","sourceRoot":"","sources":["../../src/lib/seam/use-seam-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAC9B,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD,MAAM,UAAU,aAAa;IAM3B,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,OAAO,EAAE,GAAG,cAAc,EAAE,CAAA;IAC9E,MAAM,iBAAiB,GAAG,iCAAiC,CACzD,OAAO,CAAC,iBAAiB,CAC1B,CAAA;IAED,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAO;QACzD,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QACnD,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,MAAM,IAAI,IAAI;gBAAE,OAAO,MAAM,CAAA;YAEjC,IAAI,cAAc,IAAI,IAAI,EAAE;gBAC1B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;aAC1C;YAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC;gBAC3C,GAAG,aAAa;gBAChB,cAAc;gBACd,iBAAiB;aAClB,CAAC,CAAA;YAEF,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,cAAc,EAAE,KAAK,IAAI,IAAI,EAAE;gBAChD,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;aACrD;YAED,OAAO,IAAI,IAAI,CAAC;gBACd,GAAG,aAAa;gBAChB,kBAAkB,EAAE,GAAG,CAAC,cAAc,CAAC,KAAK;aAC7C,CAAC,CAAA;QACJ,CAAC;KACF,CAAC,CAAA;IAEF,OAAO,EAAE,MAAM,EAAE,IAAI,IAAI,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;AAC5D,CAAC;AAED;;;;;GAKG;AACH,SAAS,iCAAiC,CACxC,iBAAqC;IAErC,IAAI,iBAAiB,IAAI,IAAI,EAAE;QAC7B,OAAO,iBAAiB,CAAA;KACzB;IAED,MAAM,gBAAgB,GACpB,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,uBAAuB,CAAC;QAC1D,eAAe,MAAM,EAAE,EAAE,CAAA;IAE3B,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,uBAAuB,EAAE,gBAAgB,CAAC,CAAA;IAE5E,OAAO,gBAAgB,CAAA;AACzB,CAAC"}
+{"version":3,"file":"use-seam-client.js","sourceRoot":"","sources":["../../src/lib/seam/use-seam-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAC9B,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD,MAAM,UAAU,aAAa;IAM3B,MAAM,EACJ,MAAM,EACN,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,GAAG,OAAO,EACX,GAAG,cAAc,EAAE,CAAA;IACpB,MAAM,iBAAiB,GAAG,iCAAiC,CACzD,kBAAkB,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAC5D,CAAA;IAED,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAO;QACzD,QAAQ,EAAE;YACR,QAAQ;YACR;gBACE,MAAM;gBACN,aAAa;gBACb,cAAc;gBACd,iBAAiB;gBACjB,kBAAkB;aACnB;SACF;QACD,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,MAAM,IAAI,IAAI;gBAAE,OAAO,MAAM,CAAA;YAEjC,IAAI,kBAAkB,IAAI,IAAI,EAAE;gBAC9B,OAAO,IAAI,IAAI,CAAC;oBACd,GAAG,aAAa;oBAChB,kBAAkB;iBACnB,CAAC,CAAA;aACH;YAED,IAAI,cAAc,IAAI,IAAI,EAAE;gBAC1B,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAA;aACF;YAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC;gBAC3C,GAAG,aAAa;gBAChB,cAAc;gBACd,iBAAiB;aAClB,CAAC,CAAA;YAEF,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,cAAc,EAAE,KAAK,IAAI,IAAI,EAAE;gBAChD,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;aACrD;YAED,OAAO,IAAI,IAAI,CAAC;gBACd,GAAG,aAAa;gBAChB,kBAAkB,EAAE,GAAG,CAAC,cAAc,CAAC,KAAK;aAC7C,CAAC,CAAA;QACJ,CAAC;KACF,CAAC,CAAA;IAEF,OAAO,EAAE,MAAM,EAAE,IAAI,IAAI,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;AAC5D,CAAC;AAED;;;;;GAKG;AACH,SAAS,iCAAiC,CACxC,iBAAqC;IAErC,IAAI,iBAAiB,IAAI,IAAI,EAAE;QAC7B,OAAO,iBAAiB,CAAA;KACzB;IAED,MAAM,gBAAgB,GACpB,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,uBAAuB,CAAC;QAC1D,eAAe,MAAM,EAAE,EAAE,CAAA;IAE3B,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,uBAAuB,EAAE,gBAAgB,CAAC,CAAA;IAE5E,OAAO,gBAAgB,CAAA;AACzB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seamapi/react",
-  "version": "0.15.1",
+  "version": "0.16.0",
   "description": "Seam React component library.",
   "type": "module",
   "main": "index.js",
@@ -45,6 +45,7 @@
   ],
   "scripts": {
     "start": "concurrently --raw --kill-others npm:examples npm:storybook",
+    "dev": "npm run start",
     "build": "npm run build:js",
     "prebuild": "del 'index.*' lib",
     "postbuild": "node ./index.js",

package/src/lib/SeamProvider.tsx

@@ -11,23 +11,37 @@ import type { Seam, SeamClientOptions } from 'seamapi'
 
 declare global {
   // eslint-disable-next-line no-var
-  var seam: Omit<SeamProviderProps, 'children'> | undefined
+  var seam: SeamProviderProps | undefined
 }
 
 export interface SeamContext {
   client: Seam | null
-  clientOptions?: SeamClientOptions | undefined
+  clientOptions?: AllowedSeamClientOptions | undefined
   publishableKey?: string | undefined
   userIdentifierKey?: string | undefined
+  clientSessionToken?: string | undefined
 }
 
-export interface SeamProviderProps {
-  client?: Seam
-  publishableKey?: string
+type SeamProviderProps =
+  | SeamProviderPropsWithClient
+  | (SeamProviderPropsWithPublishableKey & AllowedSeamClientOptions)
+  | (SeamProviderPropsWithClientSessionToken & AllowedSeamClientOptions)
+
+interface SeamProviderPropsWithClient {
+  client: Seam
+}
+
+interface SeamProviderPropsWithPublishableKey {
+  publishableKey: string
   userIdentifierKey?: string
-  endpoint?: string
 }
 
+interface SeamProviderPropsWithClientSessionToken {
+  clientSessionToken: string
+}
+
+type AllowedSeamClientOptions = Pick<SeamClientOptions, 'endpoint'>
+
 export function SeamProvider({
   children,
   ...props
@@ -61,10 +75,7 @@ export function SeamProvider({
 }
 
 const createDefaultSeamContextValue = (): SeamContext => {
-  if (
-    globalThis.seam?.client == null &&
-    globalThis.seam?.publishableKey == null
-  ) {
+  if (globalThis.seam == null) {
     return { client: null }
   }
 
@@ -77,32 +88,31 @@ const createDefaultSeamContextValue = (): SeamContext => {
   }
 }
 
-const createSeamContextValue = ({
-  client,
-  ...options
-}: Omit<SeamProviderProps, 'children'>): SeamContext => {
-  if (client == null && Object.keys(options).length === 0) {
-    return { client: null }
+const createSeamContextValue = (options: SeamProviderProps): SeamContext => {
+  if (isSeamProviderPropsWithClient(options)) {
+    return options
   }
 
-  if (client != null && Object.values(options).some((v) => v == null)) {
-    throw new Error(
-      'Cannot provide both a Seam client along with other options.'
-    )
+  if (isSeamProviderPropsWithClientSessionToken(options)) {
+    const { clientSessionToken, ...clientOptions } = options
+    return {
+      clientSessionToken,
+      clientOptions,
+      client: null,
+    }
   }
 
-  const { publishableKey, userIdentifierKey, ...clientOptions } = options
-
-  if (client != null) {
-    return { client }
+  if (isSeamProviderPropsWithPublishableKey(options)) {
+    const { publishableKey, userIdentifierKey, ...clientOptions } = options
+    return {
+      publishableKey,
+      userIdentifierKey,
+      clientOptions,
+      client: null,
+    }
   }
 
-  return {
-    client: null,
-    publishableKey,
-    userIdentifierKey,
-    clientOptions,
-  }
+  throw new Error('Invalid SeamProvider options')
 }
 
 const defaultSeamContextValue = createDefaultSeamContextValue()
@@ -118,3 +128,65 @@ export function useSeamContext(): SeamContext {
 
   return context
 }
+
+const isSeamProviderPropsWithClient = (
+  props: SeamProviderProps
+): props is SeamProviderPropsWithClient => {
+  if (!('client' in props)) return false
+
+  const { client } = props
+  if (client == null) return false
+
+  if (Object.values(props).some((v) => v == null)) {
+    throw new Error('Cannot provide a Seam client along with other options.')
+  }
+
+  return true
+}
+
+const isSeamProviderPropsWithPublishableKey = (
+  props: SeamProviderProps
+): props is SeamProviderPropsWithPublishableKey & AllowedSeamClientOptions => {
+  if (!('publishableKey' in props)) return false
+
+  const { publishableKey } = props
+  if (publishableKey == null) return false
+
+  if ('client' in props && props.client != null) {
+    throw new Error('Cannot provide a Seam client along with other options.')
+  }
+
+  if ('clientSessionToken' in props && props.clientSessionToken != null) {
+    throw new Error(
+      'Cannot provide both a publishableKey and a clientSessionToken.'
+    )
+  }
+
+  return true
+}
+
+const isSeamProviderPropsWithClientSessionToken = (
+  props: SeamProviderProps
+): props is SeamProviderPropsWithClientSessionToken &
+  AllowedSeamClientOptions => {
+  if (!('clientSessionToken' in props)) return false
+
+  const { clientSessionToken } = props
+  if (clientSessionToken == null) return false
+
+  if ('client' in props && props.client != null) {
+    throw new Error('Cannot provide a Seam client along with other options.')
+  }
+
+  if ('publishableKey' in props && props.publishableKey != null) {
+    throw new Error(
+      'Cannot provide both a clientSessionToken and a publishableKey .'
+    )
+  }
+
+  if ('userIdentifierKey' in props && props.userIdentifierKey != null) {
+    throw new Error('Cannot use a userIdentifierKey with a clientSessionToken.')
+  }
+
+  return true
+}

package/src/lib/seam/use-seam-client.ts

@@ -10,18 +10,42 @@ export function useSeamClient(): {
   isError: boolean
   error: unknown
 } {
-  const { client, clientOptions, publishableKey, ...context } = useSeamContext()
+  const {
+    client,
+    clientOptions,
+    publishableKey,
+    clientSessionToken,
+    ...context
+  } = useSeamContext()
   const userIdentifierKey = useUserIdentifierKeyOrFingerprint(
-    context.userIdentifierKey
+    clientSessionToken != null ? '' : context.userIdentifierKey
   )
 
   const { isLoading, isError, error, data } = useQuery<Seam>({
-    queryKey: ['client', { client, userIdentifierKey }],
+    queryKey: [
+      'client',
+      {
+        client,
+        clientOptions,
+        publishableKey,
+        userIdentifierKey,
+        clientSessionToken,
+      },
+    ],
     queryFn: async () => {
       if (client != null) return client
 
+      if (clientSessionToken != null) {
+        return new Seam({
+          ...clientOptions,
+          clientSessionToken,
+        })
+      }
+
       if (publishableKey == null) {
-        throw new Error('Missing publishableKey')
+        throw new Error(
+          'Missing either a client, publishableKey, or clientSessionToken'
+        )
       }
 
       const res = await Seam.getClientSessionToken({