@omni-co/embed 0.9.0 → 0.11.0

package/README.md

@@ -62,6 +62,38 @@ const iframeUrl = await embedSsoContentDiscovery({
 });
 ```
 
+## 2-step Example
+
+```ts
+// Step 1
+const { success, sessionToken } = await createSessionToken({
+  apiKey: "<YOUR API KEY>",
+  connectionRoles: {
+  "abcd1234-abcd-efgh-ijkl-abcdef123456":
+    EmbedConnectionRoles.RESTRICTED_QUERIER,
+  },
+  contentPath: "/dashboards/abcd1234",
+  externalId: "dodgers-17",
+  host: "myorg.embed-omniapp.co",
+  mode: EmbedSessionMode.Application,
+  name: "Shohei Ohtani",
+});
+if (!success) throw new Error("Failed to generate session");
+
+// Step 2
+const redeemSessionUrl = await redeemSessionToken({
+  host: "myorg.embed-omniapp.co",
+  prefersDark: "false",
+  theme: "vibes",
+  secret: "<YOUR EMBED SECRET>",
+  sessionToken,
+});
+
+...
+
+<iframe src={redeemSessionUrl} />
+```
+
 ## Using Vanity Domains
 
 ```ts
@@ -186,6 +218,9 @@ type EmbedSsoDashboardProps = {
   // Optional theme setting. Can be one of "dawn", "vibes", "breeze" or "blank".
   theme?: string;
 
+  // Optional UI settings object to control appearance of embed experience.
+  uiSettings?: Record<EmbedUiSettings, boolean>;
+
   /**
    * Optional user attributes to be passed to user associated with the
    * externalId. User attributes must be created in Omni before being
@@ -304,6 +339,9 @@ type EmbedSsoWorkbookProps = {
   // Optional theme setting. Can be one of "dawn", "vibes", "breeze" or "blank".
   theme?: string;
 
+  // Optional UI settings object to control appearance of embed experience.
+  uiSettings?: Record<EmbedUiSettings, boolean>;
+
   /**
    * Optional user attributes to be passed to user associated with the
    * externalId. User attributes must be created in Omni before being
@@ -424,6 +462,9 @@ type EmbedSsoContentDiscoveryProps = {
   // Optional theme setting. Can be one of "dawn", "vibes", "breeze" or "blank".
   theme?: string;
 
+  // Optional UI settings object to control appearance of embed experience.
+  uiSettings?: Record<EmbedUiSettings, boolean>;
+
   /**
    * Optional user attributes to be passed to user associated with the
    * externalId. User attributes must be created in Omni before being
@@ -442,3 +483,182 @@ type EmbedSsoContentDiscoveryProps = {
   domain?: string;
 };
 ```
+
+## createSessionToken
+
+This is the type signature for the `createSessionToken` function:
+
+```ts
+type CreateSessionTokenProps = {
+  // Optional boolean property that toggles the dashboard's Access Boost setting.
+  accessBoost?: boolean;
+
+  // An Omni API key used for authentication purposes. Can be generated in your Omni application in the Admin > API Keys section.
+  apiKey: string;
+
+  // Optional object that determines the connection permissions for the embed user.
+  connectionRoles?: Record<string, EmbedConnectionRoles>;
+
+  // Short GUID of the dashboard. Can be obtained via the dashboard's url.
+  contentId: string;
+
+  // Optional custom theme object that styles the embedded dashboard.
+  customTheme?: CustomThemeProperties;
+
+  /**
+   * Optional custom theme ID setting that styles the embedded dashboard.
+   * This ID should be from a theme created within the Omni application.
+   */
+  customThemeId?: string;
+
+  // Optional email parameter that sets the default scheduling email for the embed user.
+  email?: string;
+
+  /**
+   * Optional identifier to associate the user with an external organization or system.
+   * Note that each distinct entity will generate its own folder and group. These can be used by
+   * an embed user to share content with other members in the same entity.
+   */
+  entity?: string;
+
+  /**
+   * Optional content role setting for the entity folder. Can be one of "MANAGER", "EDITOR", or "VIEWER".
+   *
+   * MANAGER: the user will have the ability to manage content and content permissions of the entity folder.
+   * EDITOR: the user will have the ability to manage content in the entity folder.
+   * VIEWER: the user will only be able to view content in the entity folder.
+   */
+  entityFolderContentRole?: EmbedEntityFolderContentRoles;
+
+  // Required identifier to associate the external user with an automatically generated internal Omni user.
+  externalId: string;
+
+  /**
+   * Optional url filter search parameter. Should be the same as the filter search parameters on a dashboard url.
+   * Example: f--inventory_items.cost=%7B"kind"%3A"EQUALS"%2C"type"%3A"number"%2C"values"%3A%5B%5D%2C"is_negative"%3Afalse%2C"is_inclusive"%3Afalse%7D&f--users.state=%7B"kind"%3A"EQUALS"%2C"type"%3A"string"%2C"values"%3A%5B"Aberdeen"%2C"Alabama"%5D%2C"is_negative"%3Afalse%7D&f--users.country=%7B"kind"%3A"EQUALS"%2C"type"%3A"string"%2C"values"%3A%5B"UK"%5D%2C"is_negative"%3Afalse%7D
+   *
+   */
+  filterSearchParam?: string;
+
+  /*
+   * Optional groups array property. The array should be a list of group names from the Omni application, which the embed user will be added to.
+   */
+  groups?: string[];
+
+  /**
+   * Used to set the host of signed embed URL, required when using vanity domains.
+   * Protocol is not required, as https is assumed.
+   * Port is not accepted. If required, use the `port` prop.
+   *
+   * @throws Error if `domain` or `organizationName` are provided.
+   * @example "omni.example.com"
+   * @example "omni.another-example.app"
+   */
+  host?: string;
+
+  /**
+   * Optional link access setting to control which Omni dashboard links are shown. Note that regardless of the linkAccess value,
+   * all non-Omni dashboard links will be shown and allowed in drill menus. Acceptable values include:
+   *
+   * "__omni_link_access_open": Special string keyword that permisses and shows all Omni dashboard links on the embedded dashboard.
+   * "abcd1234,efgh5678,ijkl9999": An allowlist of dashboard IDs that permisses and shows links to the specified dashboards.
+   * undefined: If left undefined, the default behavior is to hide and disallow all links to other Omni dashboards on the embedded dashboard.
+   */
+  linkAccess?: string;
+
+  /**
+   * Optional mode setting that determines whether the entire application should be embedded or a single piece of content.
+   *
+   * APPLICATION: the entire application will be embedded, meaning in-app navigation and document header options will be available.
+   * SINGLE_CONTENT: only the content specified in the contentId will be embedded and application mode features will be hidden.
+   */
+  mode?: EmbedSessionMode;
+
+  // Required name of the external user.
+  name: string;
+
+  /**
+   * Name of the organization the content belongs to. If provided, generates a default embed host
+   * URL in the form of `https://<organizationName>.embed-omniapp.co`.
+   *
+   * @throws Error if `host` is provided.
+   */
+  organizationName?: string;
+
+  // Port of host.
+  port?: number;
+
+  // Optional UI settings object to control appearance of embed experience.
+  uiSettings?: Record<EmbedUiSettings, boolean>;
+
+  /**
+   * Optional user attributes to be passed to user associated with the
+   * externalId. User attributes must be created in Omni before being
+   * defined and given a value here.
+   */
+  userAttributes?: Record<string, string | string[] | number | number[]>;
+
+  // DEPRECATED
+
+  /**
+   * @deprecated Introduced for internal testing only. For vanity domains, use the `host`
+   * prop instead. Will be dropped in a v1.0.0 release.
+   *
+   * @throws Error if `host` is provided.
+   */
+  domain?: string;
+};
+```
+
+## redeemSessionToken
+
+This is the type signature for the `redeemSessionToken` function:
+
+```ts
+type RedeemSessionTokenProps = {
+  /**
+   * Used to set the host of signed embed URL, required when using vanity domains.
+   * Protocol is not required, as https is assumed.
+   * Port is not accepted. If required, use the `port` prop.
+   *
+   * @throws Error if `domain` or `organizationName` are provided.
+   * @example "omni.example.com"
+   * @example "omni.another-example.app"
+   */
+  host?: string;
+
+  /**
+   * Name of the organization the content belongs to. If provided, generates a default embed host
+   * URL in the form of `https://<organizationName>.embed-omniapp.co`.
+   *
+   * @throws Error if `host` is provided.
+   */
+  organizationName?: string;
+
+  // Port of host.
+  port?: number;
+
+  // Optional dark mode setting. Can be one of "true", "false", or "system".
+  prefersDark?: string;
+
+  // Signing secret available to Omni admins.
+  secret: string;
+
+  // Session token string. The `createSessionToken` sdk function returns a session token that
+  // can be used as the `sessionToken` parameter here in `redeemSessionToken`.
+  sessionToken: string;
+
+  // Optional theme setting. Can be one of "dawn", "vibes", "breeze" or "blank".
+  theme?: string;
+
+  // DEPRECATED
+
+  /**
+   * @deprecated Introduced for internal testing only. For vanity domains, use the `host`
+   * prop instead. Will be dropped in a v1.0.0 release.
+   *
+   * @throws Error if `host` is provided.
+   */
+  domain?: string;
+};
+```

package/lib/cjs/embed.d.ts

@@ -1,4 +1,4 @@
-import { EmbedSsoContentDiscoveryProps, EmbedSsoDashboardProps, EmbedSsoWorkbookProps, GenerateEmbedSsoSessionProps, RedeemEmbedSsoSessionProps } from "./types";
+import { EmbedSsoContentDiscoveryProps, EmbedSsoDashboardProps, EmbedSsoWorkbookProps, CreateSessionTokenProps, RedeemSessionTokenProps } from "./types";
 export declare const embedSsoDashboard: (props: EmbedSsoDashboardProps) => Promise<string>;
 export declare const embedSsoWorkbook: (props: EmbedSsoWorkbookProps) => Promise<string>;
 /**
@@ -15,7 +15,7 @@ export declare const embedSsoContentDiscovery: (props: EmbedSsoContentDiscoveryP
  * To elaborate, this function upserts an SSO embed user and session to the specified Omni
  * organization / host. The returned session token corresponds to the generated session.
  */
-export declare const createSessionToken: ({ apiKey, domain, host, organizationName, port, ...restProps }: GenerateEmbedSsoSessionProps) => Promise<{
+export declare const createSessionToken: ({ apiKey, domain, host, organizationName, port, ...restProps }: CreateSessionTokenProps) => Promise<{
     success: true;
     sessionToken: string;
     error?: never;
@@ -29,4 +29,4 @@ export declare const createSessionToken: ({ apiKey, domain, host, organizationNa
  * to output an session redemption URL that can be used to display embedded content.
  * The returned URL should be passed into an `iframe`'s src attribute.
  */
-export declare const redeemSessionToken: ({ domain, host, organizationName, port, nonce: propsNonce, secret, prefersDark, sessionToken: sessionId, theme, }: RedeemEmbedSsoSessionProps) => Promise<string>;
+export declare const redeemSessionToken: ({ domain, host, organizationName, port, nonce: propsNonce, secret, prefersDark, sessionToken: sessionId, theme, }: RedeemSessionTokenProps) => Promise<string>;

package/lib/cjs/embed.js

@@ -54,7 +54,7 @@ const validateProps = (props) => {
 };
 const embedSsoContent = async (props) => {
     validateProps(props);
-    let { accessBoost, connectionRoles: rawConnectionRoles, contentPath, customTheme: rawCustomTheme, customThemeId, domain, email, externalId, filterSearchParam, host, linkAccess, mode, name, nonce, organizationName, port, secret, uiSettings: rawUiSettings, userAttributes: rawUserAttributes, entity, prefersDark, theme, entityFolderContentRole, groups: rawGroups, } = props;
+    let { accessBoost, connectionRoles: rawConnectionRoles, contentPath, customTheme: rawCustomTheme, customThemeId, domain, email, entity, entityFolderContentRole, entityFolderLabel, entityGroupLabel, externalId, filterSearchParam, groups: rawGroups, host, linkAccess, mode, name, nonce, organizationName, prefersDark, port, secret, theme, uiSettings: rawUiSettings, userAttributes: rawUserAttributes, } = props;
     // Handle defaults
     nonce = nonce !== null && nonce !== void 0 ? nonce : (await (0, random_str_1.random32ByteString)());
     const uiSettings = rawUiSettings && JSON.stringify(rawUiSettings);
@@ -86,6 +86,8 @@ const embedSsoContent = async (props) => {
         email,
         entity,
         entityFolderContentRole,
+        entityFolderLabel,
+        entityGroupLabel,
         filterSearchParam,
         groups,
         linkAccess,
@@ -120,6 +122,10 @@ const embedSsoContent = async (props) => {
     groups && url.searchParams.append("groups", groups);
     email && url.searchParams.append("email", email);
     uiSettings && url.searchParams.append("uiSettings", uiSettings);
+    entityGroupLabel &&
+        url.searchParams.append("entityGroupLabel", entityGroupLabel);
+    entityFolderLabel &&
+        url.searchParams.append("entityFolderLabel", entityFolderLabel);
     return url.toString();
 };
 const buildContentPath = (contentType, contentId) => `/${contentType}/${contentId}`;

package/lib/cjs/signature.d.ts

@@ -58,6 +58,14 @@ type SignatureProps = {
      * The content role for the embed user on the entity folder.
      */
     entityFolderContentRole?: string;
+    /**
+     * The label for the generated entity folder.
+     */
+    entityFolderLabel?: string;
+    /**
+     * The label for the generated entity group.
+     */
+    entityGroupLabel?: string;
     /**
      * Filter search parameter.
      */
@@ -113,6 +121,6 @@ type SignSessionRedemptionProps = Pick<SignatureProps, "nonce" | "prefersDark" |
  */
 export declare const signSessionRedemption: ({ requestUrl, nonce, sessionId, secret, prefersDark, theme, }: SignSessionRedemptionProps) => string;
 export declare const TEST_ONLY: {
-    generateStringForSignature: ({ loginUrl, contentPath, externalId, name, nonce, accessBoost, connectionRoles, customTheme, customThemeId, email, entity, entityFolderContentRole, filterSearchParam, groups, linkAccess, mode, prefersDark, theme, uiSettings, userAttributes, }: Omit<SignatureProps, "secret">) => string;
+    generateStringForSignature: ({ loginUrl, contentPath, externalId, name, nonce, accessBoost, connectionRoles, customTheme, customThemeId, email, entity, entityFolderContentRole, entityFolderLabel, entityGroupLabel, filterSearchParam, groups, linkAccess, mode, prefersDark, theme, uiSettings, userAttributes, }: Omit<SignatureProps, "secret">) => string;
 };
 export {};

package/lib/cjs/signature.js

@@ -17,7 +17,7 @@ const generateStringForSignature = ({
 // Required parameters
 loginUrl, contentPath, externalId, name, nonce, 
 // Optional parameters
-accessBoost, connectionRoles, customTheme, customThemeId, email, entity, entityFolderContentRole, filterSearchParam, groups, linkAccess, mode, prefersDark, theme, uiSettings, userAttributes, }) => {
+accessBoost, connectionRoles, customTheme, customThemeId, email, entity, entityFolderContentRole, entityFolderLabel, entityGroupLabel, filterSearchParam, groups, linkAccess, mode, prefersDark, theme, uiSettings, userAttributes, }) => {
     // We create a map of optional params and convert it to an array
     // to ensure that the order of the optional params is alphabetical and consistent.
     const optionalParamsMap = {
@@ -28,6 +28,8 @@ accessBoost, connectionRoles, customTheme, customThemeId, email, entity, entityF
         ...(email && { email }),
         ...(entity && { entity }),
         ...(entityFolderContentRole && { entityFolderContentRole }),
+        ...(entityFolderLabel && { entityFolderLabel }),
+        ...(entityGroupLabel && { entityGroupLabel }),
         ...(filterSearchParam && { filterSearchParam }),
         ...(groups && { groups }),
         ...(linkAccess && { linkAccess }),

package/lib/cjs/types.d.ts

@@ -58,10 +58,22 @@ type EmbedSsoBaseProps = {
      * Optional content role setting. Can be one of "MANAGER", "EDITOR", or "VIEWER".
      *
      * MANAGER: the user will have the ability to manage content and content permissions of the entity folder.
+     *
      * EDITOR: the user will have the ability to manage content in the entity folder.
+     *
      * VIEWER: the user will only be able to view content in the entity folder.
      */
     entityFolderContentRole?: EmbedEntityFolderContentRoles;
+    /**
+     * Optional setting that customizes the generated entity folder label. This only affects the entity folder
+     * corresponding to the `entity` parameter value in the relevant generated SSO embed URL.
+     */
+    entityFolderLabel?: string;
+    /**
+     * Optional setting that customizes the generated entity group label. This only affects the entity group
+     * corresponding to the `entity` parameter value in the relevant generated SSO embed URL.
+     */
+    entityGroupLabel?: string;
     /**
      * Optional groups setting. An array of group names that the user will be added to.
      */
@@ -230,10 +242,10 @@ export type EmbedSsoContentDiscoveryProps = EmbedSsoBaseProps & {
      */
     path: string;
 };
-export type GenerateEmbedSsoSessionProps = Omit<EmbedSsoContentProps, "prefersDark" | "theme" | "secret" | "nonce"> & {
+export type CreateSessionTokenProps = Omit<EmbedSsoContentProps, "prefersDark" | "theme" | "secret" | "nonce"> & {
     apiKey: string;
 } & HostProps;
-export type RedeemEmbedSsoSessionProps = Pick<EmbedSsoContentProps, "nonce" | "prefersDark" | "secret" | "theme" | "port"> & {
+export type RedeemSessionTokenProps = Pick<EmbedSsoContentProps, "nonce" | "prefersDark" | "secret" | "theme" | "port"> & {
     sessionToken: string;
 } & HostProps;
 export {};

package/lib/esm/embed.d.ts

@@ -1,4 +1,4 @@
-import { EmbedSsoContentDiscoveryProps, EmbedSsoDashboardProps, EmbedSsoWorkbookProps, GenerateEmbedSsoSessionProps, RedeemEmbedSsoSessionProps } from "./types";
+import { EmbedSsoContentDiscoveryProps, EmbedSsoDashboardProps, EmbedSsoWorkbookProps, CreateSessionTokenProps, RedeemSessionTokenProps } from "./types";
 export declare const embedSsoDashboard: (props: EmbedSsoDashboardProps) => Promise<string>;
 export declare const embedSsoWorkbook: (props: EmbedSsoWorkbookProps) => Promise<string>;
 /**
@@ -15,7 +15,7 @@ export declare const embedSsoContentDiscovery: (props: EmbedSsoContentDiscoveryP
  * To elaborate, this function upserts an SSO embed user and session to the specified Omni
  * organization / host. The returned session token corresponds to the generated session.
  */
-export declare const createSessionToken: ({ apiKey, domain, host, organizationName, port, ...restProps }: GenerateEmbedSsoSessionProps) => Promise<{
+export declare const createSessionToken: ({ apiKey, domain, host, organizationName, port, ...restProps }: CreateSessionTokenProps) => Promise<{
     success: true;
     sessionToken: string;
     error?: never;
@@ -29,4 +29,4 @@ export declare const createSessionToken: ({ apiKey, domain, host, organizationNa
  * to output an session redemption URL that can be used to display embedded content.
  * The returned URL should be passed into an `iframe`'s src attribute.
  */
-export declare const redeemSessionToken: ({ domain, host, organizationName, port, nonce: propsNonce, secret, prefersDark, sessionToken: sessionId, theme, }: RedeemEmbedSsoSessionProps) => Promise<string>;
+export declare const redeemSessionToken: ({ domain, host, organizationName, port, nonce: propsNonce, secret, prefersDark, sessionToken: sessionId, theme, }: RedeemSessionTokenProps) => Promise<string>;

package/lib/esm/embed.js

@@ -51,7 +51,7 @@ const validateProps = (props) => {
 };
 const embedSsoContent = async (props) => {
     validateProps(props);
-    let { accessBoost, connectionRoles: rawConnectionRoles, contentPath, customTheme: rawCustomTheme, customThemeId, domain, email, externalId, filterSearchParam, host, linkAccess, mode, name, nonce, organizationName, port, secret, uiSettings: rawUiSettings, userAttributes: rawUserAttributes, entity, prefersDark, theme, entityFolderContentRole, groups: rawGroups, } = props;
+    let { accessBoost, connectionRoles: rawConnectionRoles, contentPath, customTheme: rawCustomTheme, customThemeId, domain, email, entity, entityFolderContentRole, entityFolderLabel, entityGroupLabel, externalId, filterSearchParam, groups: rawGroups, host, linkAccess, mode, name, nonce, organizationName, prefersDark, port, secret, theme, uiSettings: rawUiSettings, userAttributes: rawUserAttributes, } = props;
     // Handle defaults
     nonce = nonce !== null && nonce !== void 0 ? nonce : (await random32ByteString());
     const uiSettings = rawUiSettings && JSON.stringify(rawUiSettings);
@@ -83,6 +83,8 @@ const embedSsoContent = async (props) => {
         email,
         entity,
         entityFolderContentRole,
+        entityFolderLabel,
+        entityGroupLabel,
         filterSearchParam,
         groups,
         linkAccess,
@@ -117,6 +119,10 @@ const embedSsoContent = async (props) => {
     groups && url.searchParams.append("groups", groups);
     email && url.searchParams.append("email", email);
     uiSettings && url.searchParams.append("uiSettings", uiSettings);
+    entityGroupLabel &&
+        url.searchParams.append("entityGroupLabel", entityGroupLabel);
+    entityFolderLabel &&
+        url.searchParams.append("entityFolderLabel", entityFolderLabel);
     return url.toString();
 };
 const buildContentPath = (contentType, contentId) => `/${contentType}/${contentId}`;

package/lib/esm/signature.d.ts

@@ -58,6 +58,14 @@ type SignatureProps = {
      * The content role for the embed user on the entity folder.
      */
     entityFolderContentRole?: string;
+    /**
+     * The label for the generated entity folder.
+     */
+    entityFolderLabel?: string;
+    /**
+     * The label for the generated entity group.
+     */
+    entityGroupLabel?: string;
     /**
      * Filter search parameter.
      */
@@ -113,6 +121,6 @@ type SignSessionRedemptionProps = Pick<SignatureProps, "nonce" | "prefersDark" |
  */
 export declare const signSessionRedemption: ({ requestUrl, nonce, sessionId, secret, prefersDark, theme, }: SignSessionRedemptionProps) => string;
 export declare const TEST_ONLY: {
-    generateStringForSignature: ({ loginUrl, contentPath, externalId, name, nonce, accessBoost, connectionRoles, customTheme, customThemeId, email, entity, entityFolderContentRole, filterSearchParam, groups, linkAccess, mode, prefersDark, theme, uiSettings, userAttributes, }: Omit<SignatureProps, "secret">) => string;
+    generateStringForSignature: ({ loginUrl, contentPath, externalId, name, nonce, accessBoost, connectionRoles, customTheme, customThemeId, email, entity, entityFolderContentRole, entityFolderLabel, entityGroupLabel, filterSearchParam, groups, linkAccess, mode, prefersDark, theme, uiSettings, userAttributes, }: Omit<SignatureProps, "secret">) => string;
 };
 export {};

package/lib/esm/signature.js

@@ -10,7 +10,7 @@ const generateStringForSignature = ({
 // Required parameters
 loginUrl, contentPath, externalId, name, nonce, 
 // Optional parameters
-accessBoost, connectionRoles, customTheme, customThemeId, email, entity, entityFolderContentRole, filterSearchParam, groups, linkAccess, mode, prefersDark, theme, uiSettings, userAttributes, }) => {
+accessBoost, connectionRoles, customTheme, customThemeId, email, entity, entityFolderContentRole, entityFolderLabel, entityGroupLabel, filterSearchParam, groups, linkAccess, mode, prefersDark, theme, uiSettings, userAttributes, }) => {
     // We create a map of optional params and convert it to an array
     // to ensure that the order of the optional params is alphabetical and consistent.
     const optionalParamsMap = {
@@ -21,6 +21,8 @@ accessBoost, connectionRoles, customTheme, customThemeId, email, entity, entityF
         ...(email && { email }),
         ...(entity && { entity }),
         ...(entityFolderContentRole && { entityFolderContentRole }),
+        ...(entityFolderLabel && { entityFolderLabel }),
+        ...(entityGroupLabel && { entityGroupLabel }),
         ...(filterSearchParam && { filterSearchParam }),
         ...(groups && { groups }),
         ...(linkAccess && { linkAccess }),

package/lib/esm/types.d.ts

@@ -58,10 +58,22 @@ type EmbedSsoBaseProps = {
      * Optional content role setting. Can be one of "MANAGER", "EDITOR", or "VIEWER".
      *
      * MANAGER: the user will have the ability to manage content and content permissions of the entity folder.
+     *
      * EDITOR: the user will have the ability to manage content in the entity folder.
+     *
      * VIEWER: the user will only be able to view content in the entity folder.
      */
     entityFolderContentRole?: EmbedEntityFolderContentRoles;
+    /**
+     * Optional setting that customizes the generated entity folder label. This only affects the entity folder
+     * corresponding to the `entity` parameter value in the relevant generated SSO embed URL.
+     */
+    entityFolderLabel?: string;
+    /**
+     * Optional setting that customizes the generated entity group label. This only affects the entity group
+     * corresponding to the `entity` parameter value in the relevant generated SSO embed URL.
+     */
+    entityGroupLabel?: string;
     /**
      * Optional groups setting. An array of group names that the user will be added to.
      */
@@ -230,10 +242,10 @@ export type EmbedSsoContentDiscoveryProps = EmbedSsoBaseProps & {
      */
     path: string;
 };
-export type GenerateEmbedSsoSessionProps = Omit<EmbedSsoContentProps, "prefersDark" | "theme" | "secret" | "nonce"> & {
+export type CreateSessionTokenProps = Omit<EmbedSsoContentProps, "prefersDark" | "theme" | "secret" | "nonce"> & {
     apiKey: string;
 } & HostProps;
-export type RedeemEmbedSsoSessionProps = Pick<EmbedSsoContentProps, "nonce" | "prefersDark" | "secret" | "theme" | "port"> & {
+export type RedeemSessionTokenProps = Pick<EmbedSsoContentProps, "nonce" | "prefersDark" | "secret" | "theme" | "port"> & {
     sessionToken: string;
 } & HostProps;
 export {};

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.9.0",
+  "version": "0.11.0",
   "license": "MIT",
   "name": "@omni-co/embed",
   "author": "Nate Agrin <nate@exploreomni.com>",