@orangelogic/orange-dam-content-browser-sdk 2.4.9 → 2.4.11

package/build/api/asset/asset.d.ts

@@ -1,4 +1,5 @@
 import { GetAssetsRequest } from '../../types/asset';
+import { type TitleFallback } from '../../types/content-browser';
 import { GetAssetLinksRequest, GetAssetLinksResponse, GetAssetsByIDsRequest, GetAssetsByIDsResponse, GetAssetsResponse, GetAssetVersionHistoryResponse, GetAvailableExtensionsResponse, GetAvailableProxiesResponse } from './asset.types';
 export declare const DEFAULT_VIEW_SIZE = "CoreField.LargeSizePreview";
 export declare const FIELD_ALLOW_ATS_LINK = "AllowATSLink";
@@ -24,12 +25,14 @@ export declare const FIELD_UPDATED_FILE_NAME = "CoreField.UpdatedFileName";
 export declare const LIBRARY_NAME = "Library";
 export declare const MESSAGE_NEW_LINE = "\n";
 export declare const ORIGINAL_VIEW_SIZE = "CoreField.OriginalPreview";
+/** The field the caption shows when the title is blank. */
+export declare function resolveTitleFallbackField(titleFallback?: TitleFallback): "CoreField.Identifier" | "CoreField.OriginalFileName";
 /**
- * The caption shown under an asset. Falls back to the identifier rather than the original file name:
- * file names can carry private information (model names, shoot details) that must never reach a host
- * application, and there is no way for a customer to turn the caption off. See L-42B0OO.
+ * The caption shown under an asset. By default it falls back to the identifier rather than the original
+ * file name: file names can carry private information (model names, shoot details), and the host decides
+ * whether its users may see them. See L-42B0OO and L-42D2A9.
  */
-export declare function resolveAssetCaption(fields: Record<string, string>): string;
+export declare function resolveAssetCaption(fields: Record<string, string>, titleFallback?: TitleFallback): string;
 export declare function resolveAssetExtraFilters(selectedFacets?: Record<string, string[]>): {
     SubtypeCriteria?: string[];
     FacetFilters?: Record<string, string[]>;
@@ -37,7 +40,7 @@ export declare function resolveAssetExtraFilters(selectedFacets?: Record<string,
 export declare function apiGetAssetLinks({ assets, extension, extraFields, parameters, permanentLink, proxyPreference, transformations, useSession, }: GetAssetLinksRequest): Promise<GetAssetLinksResponse>;
 export declare function apiGetAssetsByIDs({ extraFields, recordIds, }: GetAssetsByIDsRequest): Promise<GetAssetsByIDsResponse>;
 export declare const ASSET_LIST_FIELDS: string[];
-export declare function apiGetAssets({ fields, folderId, isSeeThrough, limitedToDocTypes, pageSize, searchText, selectedFacets, sortOrder, start, useSession, }: GetAssetsRequest): Promise<GetAssetsResponse>;
+export declare function apiGetAssets({ fields, folderId, isSeeThrough, limitedToDocTypes, pageSize, searchText, selectedFacets, sortOrder, start, titleFallback, useSession, }: GetAssetsRequest): Promise<GetAssetsResponse>;
 export declare function apiGetAvailableProxies({ assetRecordId, siteUrl, }: {
     assetRecordId: string;
     siteUrl?: string;

package/build/components/content-browser/content-browser.d.ts

@@ -7,7 +7,7 @@ import CxContentBrowserGrid from '../../components/content-browser-grid/content-
 import CxContentBrowserHeader from '../../components/content-browser-header/content-browser-header';
 import CxContentBrowserNoResult from '../../components/content-browser-no-result/content-browser-no-result';
 import CxContentBrowserTable from '../../components/content-browser-table/content-browser-table';
-import { type AutoSelectFormat, type ContentBrowserView, type CtaTextTransform, type TableColumn, type TableRowActionPosition } from '../../types/content-browser';
+import { type AutoSelectFormat, type ContentBrowserView, type CtaTextTransform, type TableColumn, type TableRowActionPosition, type TitleFallback } from '../../types/content-browser';
 import { GetFolderRequest } from '../../types/folder';
 import CxIcon from '@orangelogic/design-system/components/icon';
 import CxIconButton from '@orangelogic/design-system/components/icon-button';
@@ -92,6 +92,11 @@ export default class CxContentBrowser extends CortexElement {
      * the end of the last data column (`row-end`). Any other value gives `host-edge`.
      */
     tableRowActionPosition: TableRowActionPosition;
+    /**
+     * What the asset caption shows when the asset has no title: `uniqueIdentifier` (default) or
+     * `originalFileName`. Any other value gives `uniqueIdentifier`.
+     */
+    titleFallback: TitleFallback;
     /** The widths the user saved for the table columns of this site, in pixels, keyed by field. */
     private tableColumnWidths;
     /**

package/build/content-browser.mjs

@@ -6374,6 +6374,9 @@ const autoSelectFormatConverter = {
 function isAutoSelectFormatActive(value) {
   return value === true || typeof value === "string" && value.trim() !== "";
 }
+function toTitleFallback(value) {
+  return value === "originalFileName" ? "originalFileName" : "uniqueIdentifier";
+}
 function toTableRowActionPosition(value) {
   return value === "row-end" ? "row-end" : "host-edge";
 }
@@ -14459,8 +14462,11 @@ const FIELD_SUBTYPE = "CoreField.DocSubType";
 const FIELD_TITLE_WITH_FALLBACK = "CoreField.TitleWithFallback";
 const FIELD_UPDATED_FILE_NAME = "CoreField.UpdatedFileName";
 const ORIGINAL_VIEW_SIZE = "CoreField.OriginalPreview";
-function resolveAssetCaption(fields) {
-  return fields[FIELD_DOC_TITLE] || fields[FIELD_IDENTIFIER] || "";
+function resolveTitleFallbackField(titleFallback) {
+  return titleFallback === "originalFileName" ? FIELD_ORIGINAL_FILE_NAME : FIELD_IDENTIFIER;
+}
+function resolveAssetCaption(fields, titleFallback) {
+  return fields[FIELD_DOC_TITLE] || fields[resolveTitleFallbackField(titleFallback)] || fields[FIELD_IDENTIFIER] || "";
 }
 function resolveAssetExtraFilters(selectedFacets) {
   if (!selectedFacets || Object.keys(selectedFacets).length === 0) {
@@ -14852,20 +14858,22 @@ function apiGetAssets(_0) {
     selectedFacets,
     sortOrder,
     start,
+    titleFallback,
     useSession
   }) {
     var _a2;
     const validatedFields = (_a2 = fields == null ? void 0 : fields.filter((field) => field && typeof field === "string")) != null ? _a2 : [];
+    const requestedFields = [
+      ...ASSET_LIST_FIELDS,
+      resolveTitleFallbackField(titleFallback),
+      ...validatedFields
+    ].filter(
+      (field, index, all3) => all3.findIndex((item) => item.toLowerCase() === field.toLowerCase()) === index
+    );
     try {
       const response = yield http.request({
         data: __spreadValues({
-          Fields: [
-            ...ASSET_LIST_FIELDS,
-            ...validatedFields.filter((field, index) => {
-              const seen = [...ASSET_LIST_FIELDS, ...validatedFields.slice(0, index)];
-              return !seen.some((item) => item.toLowerCase() === field.toLowerCase());
-            })
-          ],
+          Fields: requestedFields,
           Limit: pageSize || void 0,
           LimitedToDocTypes: limitedToDocTypes,
           ObjectRecordID: folderId || void 0,
@@ -14893,14 +14901,14 @@ function apiGetAssets(_0) {
             const mappedItems = (_b2 = (_a3 = rawResponse.contentItems) == null ? void 0 : _a3.map((item) => {
               var _a4, _b3, _c2, _d2, _e2, _f2, _g, _h, _i, _j, _k, _l;
               let extension = (_a4 = item.fields[FIELD_EXTENSION]) != null ? _a4 : "";
-              const name = resolveAssetCaption(item.fields);
+              const name = resolveAssetCaption(item.fields, titleFallback);
               if (extension && !extension.startsWith(".")) {
                 extension = "." + extension;
               }
               return __spreadProps(__spreadValues({}, validatedFields.reduce((acc, field) => {
                 var _a5, _b4;
-                const sourceField = (_a5 = ASSET_LIST_FIELDS.find(
-                  (defaultField) => defaultField.toLowerCase() === field.toLowerCase()
+                const sourceField = (_a5 = requestedFields.find(
+                  (requestedField) => requestedField.toLowerCase() === field.toLowerCase()
                 )) != null ? _a5 : field;
                 acc[field] = (_b4 = item.fields[sourceField]) != null ? _b4 : "";
                 return acc;
@@ -15427,6 +15435,7 @@ class FetchAndMergeAssetsController {
     defaultSelectedFacets,
     defaultSortDirection,
     defaultSortOrderName,
+    titleFallback = "uniqueIdentifier",
     token,
     useSession,
     useSiteSession = false
@@ -15471,6 +15480,7 @@ class FetchAndMergeAssetsController {
     this.host = host;
     this.availableDocTypes = availableDocTypes;
     this.additionalFields = additionalFields != null ? additionalFields : [];
+    this.titleFallback = titleFallback;
     this.defaultFolderId = defaultFolderId;
     this.defaultIsSeeThrough = defaultIsSeeThrough;
     this.defaultSearchText = defaultSearchText;
@@ -15673,7 +15683,7 @@ class FetchAndMergeAssetsController {
   }
   fetchAssets(request) {
     return __async(this, null, function* () {
-      return yield apiGetAssets(request);
+      return yield apiGetAssets(__spreadValues({ titleFallback: this.titleFallback }, request));
     });
   }
   fetchFolders(request) {
@@ -15786,7 +15796,8 @@ class FetchAndMergeAssetsController {
           });
           this.lastRequest = request;
           const assets = yield apiGetAssets(__spreadProps(__spreadValues({}, request), {
-            sortOrder
+            sortOrder,
+            titleFallback: this.titleFallback
           }));
           if (generation !== __privateGet(this, _generation)) {
             return;
@@ -15881,7 +15892,8 @@ class FetchAndMergeAssetsController {
             FIELD_RECORD_ID,
             FIELD_SUBTYPE,
             FIELD_TITLE_WITH_FALLBACK,
-            ORIGINAL_VIEW_SIZE
+            ORIGINAL_VIEW_SIZE,
+            ...this.titleFallback === "originalFileName" ? [resolveTitleFallbackField(this.titleFallback)] : []
           ],
           recordIds: [id]
         }),
@@ -15916,7 +15928,7 @@ class FetchAndMergeAssetsController {
           identifier: (_d2 = item[FIELD_IDENTIFIER]) != null ? _d2 : "",
           imageUrl: (_e2 = item[DEFAULT_VIEW_SIZE]) != null ? _e2 : "",
           inColdStorage: Boolean(item.inColdStorage),
-          name: resolveAssetCaption(item),
+          name: resolveAssetCaption(item, this.titleFallback),
           originalUrl: (_f2 = item[ORIGINAL_VIEW_SIZE]) != null ? _f2 : "",
           previewUrl: (_h = (_g = proxyData == null ? void 0 : proxyData.previewUrl) != null ? _g : item[DEFAULT_VIEW_SIZE]) != null ? _h : "",
           recordId: (_i = item[FIELD_RECORD_ID]) != null ? _i : "",
@@ -16419,6 +16431,7 @@ let CxContentBrowser = class extends CortexElement {
     this.defaultGridView = GridView.Medium;
     this.tableColumns = [];
     this.tableRowActionPosition = "host-edge";
+    this.titleFallback = "uniqueIdentifier";
     this.tableColumnWidths = {};
     this.tableWidthQueue = Promise.resolve();
     this.tableWidthTasks = 0;
@@ -16579,6 +16592,7 @@ let CxContentBrowser = class extends CortexElement {
         defaultSelectedFacets: this.defaultSelectedFacets,
         defaultSortDirection: this.defaultSortDirection,
         defaultSortOrderName: this.defaultSortOrderName,
+        titleFallback: toTitleFallback(this.titleFallback),
         token: this.token,
         useSession: this.useSession,
         useSiteSession: this.useSiteSession
@@ -17377,6 +17391,9 @@ __decorateClass([
 __decorateClass([
   n$6({ attribute: "table-row-action-position", type: String })
 ], CxContentBrowser.prototype, "tableRowActionPosition", 2);
+__decorateClass([
+  n$6({ attribute: "title-fallback", type: String })
+], CxContentBrowser.prototype, "titleFallback", 2);
 __decorateClass([
   r$6()
 ], CxContentBrowser.prototype, "tableColumnWidths", 2);

package/build/index.d.ts

@@ -2,7 +2,7 @@ import './styles.css';
 export { default as CxContentBrowser } from './components/content-browser/content-browser';
 import { AppContextType } from './AppContext';
 import { CtaTextTransform, ImageCardDisplayInfo } from './GlobalConfigContext';
-import { type AutoSelectFormat, TableColumn, type TableRowActionPosition } from './types/content-browser';
+import { type AutoSelectFormat, TableColumn, type TableRowActionPosition, type TitleFallback } from './types/content-browser';
 import { Folder, GetContentRequest, GetContentResponse, GetFoldersRequest } from './types/search';
 type OrangeDAMContentBrowser = {
     help: () => void;
@@ -235,6 +235,17 @@ type OrangeDAMContentBrowser = {
          * Default `host-edge`.
          */
         tableRowActionPosition?: TableRowActionPosition;
+        /**
+         * What the asset caption shows when the asset has no title. The title always shows when it is set.
+         *
+         * - `uniqueIdentifier` (default) - the unique identifier of the asset.
+         * - `originalFileName` - the original file name of the asset.
+         *
+         * A file name can hold private information, for example model names or shoot details. Set
+         * `originalFileName` only when every user of the host can see the file names. Any other value gives
+         * `uniqueIdentifier`.
+         */
+        titleFallback?: TitleFallback;
         /**
          * Import behaviour when picking an asset, for a host that would rather not show the format
          * picker.

package/build/index.mjs

@@ -6440,6 +6440,9 @@ const autoSelectFormatConverter = {
 function isAutoSelectFormatActive(value) {
   return value === true || typeof value === "string" && value.trim() !== "";
 }
+function toTitleFallback(value) {
+  return value === "originalFileName" ? "originalFileName" : "uniqueIdentifier";
+}
 function toTableRowActionPosition(value) {
   return value === "row-end" ? "row-end" : "host-edge";
 }
@@ -14525,8 +14528,11 @@ const FIELD_SUBTYPE = "CoreField.DocSubType";
 const FIELD_TITLE_WITH_FALLBACK = "CoreField.TitleWithFallback";
 const FIELD_UPDATED_FILE_NAME = "CoreField.UpdatedFileName";
 const ORIGINAL_VIEW_SIZE = "CoreField.OriginalPreview";
-function resolveAssetCaption(fields) {
-  return fields[FIELD_DOC_TITLE] || fields[FIELD_IDENTIFIER] || "";
+function resolveTitleFallbackField(titleFallback) {
+  return titleFallback === "originalFileName" ? FIELD_ORIGINAL_FILE_NAME : FIELD_IDENTIFIER;
+}
+function resolveAssetCaption(fields, titleFallback) {
+  return fields[FIELD_DOC_TITLE] || fields[resolveTitleFallbackField(titleFallback)] || fields[FIELD_IDENTIFIER] || "";
 }
 function resolveAssetExtraFilters(selectedFacets) {
   if (!selectedFacets || Object.keys(selectedFacets).length === 0) {
@@ -14918,20 +14924,22 @@ function apiGetAssets(_0) {
     selectedFacets,
     sortOrder,
     start,
+    titleFallback,
     useSession
   }) {
     var _a2;
     const validatedFields = (_a2 = fields == null ? void 0 : fields.filter((field) => field && typeof field === "string")) != null ? _a2 : [];
+    const requestedFields = [
+      ...ASSET_LIST_FIELDS,
+      resolveTitleFallbackField(titleFallback),
+      ...validatedFields
+    ].filter(
+      (field, index, all3) => all3.findIndex((item) => item.toLowerCase() === field.toLowerCase()) === index
+    );
     try {
       const response = yield http.request({
         data: __spreadValues({
-          Fields: [
-            ...ASSET_LIST_FIELDS,
-            ...validatedFields.filter((field, index) => {
-              const seen = [...ASSET_LIST_FIELDS, ...validatedFields.slice(0, index)];
-              return !seen.some((item) => item.toLowerCase() === field.toLowerCase());
-            })
-          ],
+          Fields: requestedFields,
           Limit: pageSize || void 0,
           LimitedToDocTypes: limitedToDocTypes,
           ObjectRecordID: folderId || void 0,
@@ -14959,14 +14967,14 @@ function apiGetAssets(_0) {
             const mappedItems = (_b2 = (_a3 = rawResponse.contentItems) == null ? void 0 : _a3.map((item) => {
               var _a4, _b3, _c2, _d2, _e3, _f2, _g, _h, _i, _j, _k, _l;
               let extension = (_a4 = item.fields[FIELD_EXTENSION]) != null ? _a4 : "";
-              const name = resolveAssetCaption(item.fields);
+              const name = resolveAssetCaption(item.fields, titleFallback);
               if (extension && !extension.startsWith(".")) {
                 extension = "." + extension;
               }
               return __spreadProps(__spreadValues({}, validatedFields.reduce((acc, field) => {
                 var _a5, _b4;
-                const sourceField = (_a5 = ASSET_LIST_FIELDS.find(
-                  (defaultField) => defaultField.toLowerCase() === field.toLowerCase()
+                const sourceField = (_a5 = requestedFields.find(
+                  (requestedField) => requestedField.toLowerCase() === field.toLowerCase()
                 )) != null ? _a5 : field;
                 acc[field] = (_b4 = item.fields[sourceField]) != null ? _b4 : "";
                 return acc;
@@ -15493,6 +15501,7 @@ class FetchAndMergeAssetsController {
     defaultSelectedFacets,
     defaultSortDirection,
     defaultSortOrderName,
+    titleFallback = "uniqueIdentifier",
     token: token2,
     useSession,
     useSiteSession = false
@@ -15537,6 +15546,7 @@ class FetchAndMergeAssetsController {
     this.host = host;
     this.availableDocTypes = availableDocTypes;
     this.additionalFields = additionalFields != null ? additionalFields : [];
+    this.titleFallback = titleFallback;
     this.defaultFolderId = defaultFolderId;
     this.defaultIsSeeThrough = defaultIsSeeThrough;
     this.defaultSearchText = defaultSearchText;
@@ -15739,7 +15749,7 @@ class FetchAndMergeAssetsController {
   }
   fetchAssets(request) {
     return __async(this, null, function* () {
-      return yield apiGetAssets(request);
+      return yield apiGetAssets(__spreadValues({ titleFallback: this.titleFallback }, request));
     });
   }
   fetchFolders(request) {
@@ -15852,7 +15862,8 @@ class FetchAndMergeAssetsController {
           });
           this.lastRequest = request;
           const assets = yield apiGetAssets(__spreadProps(__spreadValues({}, request), {
-            sortOrder
+            sortOrder,
+            titleFallback: this.titleFallback
           }));
           if (generation !== __privateGet(this, _generation)) {
             return;
@@ -15947,7 +15958,8 @@ class FetchAndMergeAssetsController {
             FIELD_RECORD_ID,
             FIELD_SUBTYPE,
             FIELD_TITLE_WITH_FALLBACK,
-            ORIGINAL_VIEW_SIZE
+            ORIGINAL_VIEW_SIZE,
+            ...this.titleFallback === "originalFileName" ? [resolveTitleFallbackField(this.titleFallback)] : []
           ],
           recordIds: [id]
         }),
@@ -15982,7 +15994,7 @@ class FetchAndMergeAssetsController {
           identifier: (_d2 = item[FIELD_IDENTIFIER]) != null ? _d2 : "",
           imageUrl: (_e3 = item[DEFAULT_VIEW_SIZE]) != null ? _e3 : "",
           inColdStorage: Boolean(item.inColdStorage),
-          name: resolveAssetCaption(item),
+          name: resolveAssetCaption(item, this.titleFallback),
           originalUrl: (_f2 = item[ORIGINAL_VIEW_SIZE]) != null ? _f2 : "",
           previewUrl: (_h = (_g = proxyData == null ? void 0 : proxyData.previewUrl) != null ? _g : item[DEFAULT_VIEW_SIZE]) != null ? _h : "",
           recordId: (_i = item[FIELD_RECORD_ID]) != null ? _i : "",
@@ -16495,6 +16507,7 @@ let CxContentBrowser = class extends CortexElement {
     this.defaultGridView = GridView$1.Medium;
     this.tableColumns = [];
     this.tableRowActionPosition = "host-edge";
+    this.titleFallback = "uniqueIdentifier";
     this.tableColumnWidths = {};
     this.tableWidthQueue = Promise.resolve();
     this.tableWidthTasks = 0;
@@ -16655,6 +16668,7 @@ let CxContentBrowser = class extends CortexElement {
         defaultSelectedFacets: this.defaultSelectedFacets,
         defaultSortDirection: this.defaultSortDirection,
         defaultSortOrderName: this.defaultSortOrderName,
+        titleFallback: toTitleFallback(this.titleFallback),
         token: this.token,
         useSession: this.useSession,
         useSiteSession: this.useSiteSession
@@ -17453,6 +17467,9 @@ __decorateClass([
 __decorateClass([
   n$6({ attribute: "table-row-action-position", type: String })
 ], CxContentBrowser.prototype, "tableRowActionPosition", 2);
+__decorateClass([
+  n$6({ attribute: "title-fallback", type: String })
+], CxContentBrowser.prototype, "titleFallback", 2);
 __decorateClass([
   r$6()
 ], CxContentBrowser.prototype, "tableColumnWidths", 2);
@@ -31718,7 +31735,8 @@ const GlobalConfigContext = reactExports.createContext({
   defaultGridView: "",
   autoSelectFormat: false,
   tableColumns: [],
-  tableRowActionPosition: "host-edge"
+  tableRowActionPosition: "host-edge",
+  titleFallback: "uniqueIdentifier"
 });
 function formatProdErrorMessage$1(code) {
   return `Minified Redux error #${code}; visit https://redux.js.org/Errors?code=${code} for the full message or use the non-minified dev environment for full errors. `;
@@ -34505,6 +34523,7 @@ const AssetsPicker = reactExports.forwardRef(function AssetsPicker2({ accessToke
     showVersions,
     tableColumns,
     tableRowActionPosition,
+    titleFallback,
     autoSelectFormat
   } = reactExports.useContext(GlobalConfigContext);
   const {
@@ -34744,6 +34763,7 @@ const AssetsPicker = reactExports.forwardRef(function AssetsPicker2({ accessToke
       "default-grid-view": defaultSettings.view,
       "table-columns": tableColumns != null ? tableColumns : [],
       "table-row-action-position": tableRowActionPosition != null ? tableRowActionPosition : "host-edge",
+      "title-fallback": titleFallback != null ? titleFallback : "uniqueIdentifier",
       "auto-select-format": autoSelectFormat != null ? autoSelectFormat : false,
       "default-sort-order-name": defaultSettings.sortOrder,
       "default-sort-direction": defaultSettings.sortDirection,
@@ -35440,6 +35460,7 @@ const ContentBrowser = {
           { title: "Description", field: "Document.CaptionLong" },
         ],
         tableRowActionPosition: "host-edge", // Where the table row action shows: host-edge or row-end
+        titleFallback: "uniqueIdentifier", // Caption when the title is blank: uniqueIdentifier or originalFileName
       });`);
   },
   open: (_0) => __async(null, [_0], function* ({
@@ -35493,6 +35514,7 @@ const ContentBrowser = {
     defaultGridView,
     tableColumns,
     tableRowActionPosition,
+    titleFallback,
     autoSelectFormat
   }) {
     var _a2;
@@ -35604,7 +35626,8 @@ const ContentBrowser = {
             defaultGridView: defaultGridView != null ? defaultGridView : "",
             autoSelectFormat: autoSelectFormat != null ? autoSelectFormat : false,
             tableColumns: tableColumns != null ? tableColumns : [],
-            tableRowActionPosition: tableRowActionPosition != null ? tableRowActionPosition : "host-edge"
+            tableRowActionPosition: tableRowActionPosition != null ? tableRowActionPosition : "host-edge",
+            titleFallback: toTitleFallback(titleFallback)
           },
           children: /* @__PURE__ */ jsxRuntimeExports.jsx(
             App,

package/build/tools/fetch-and-merge-assets.d.ts

@@ -2,7 +2,7 @@ import CortexElement from '../base/element';
 import { GetAssetLinksRequest, GetAssetsResponse, GetAvailableExtensionsResponse } from '../api/asset/asset.types';
 import { Asset, GetAssetsRequest, MediaType } from '../types/asset';
 import { UserInfo } from '../types/auth';
-import { Facet, SortOrder } from '../types/content-browser';
+import { Facet, SortOrder, type TitleFallback } from '../types/content-browser';
 import { GetFolderRequest } from '../types/folder';
 import type { ReactiveController } from 'lit';
 type FetchAndMergeAssetsControllerOptions = {
@@ -17,6 +17,8 @@ type FetchAndMergeAssetsControllerOptions = {
     defaultSelectedFacets: Record<string, string[]>;
     defaultSortDirection: 'ascending' | 'descending';
     defaultSortOrderName: string;
+    /** What the asset caption shows when the asset has no title. Default `uniqueIdentifier`. */
+    titleFallback?: TitleFallback;
     token: string;
     useSession: string;
     useSiteSession?: boolean;
@@ -53,6 +55,7 @@ export declare class FetchAndMergeAssetsController implements ReactiveController
     private readonly tokenRefreshTimeoutMs;
     private readonly availableDocTypes;
     private additionalFields;
+    private titleFallback;
     private readonly defaultSearchText;
     private readonly defaultSelectedFacets;
     private readonly defaultSortOrderName;
@@ -61,7 +64,7 @@ export declare class FetchAndMergeAssetsController implements ReactiveController
     private readonly defaultIsSeeThrough;
     private requestInterceptorId;
     private responseInterceptorId;
-    constructor(host: CortexElement, { additionalFields, availableDocTypes, baseUrl, bearerToken, defaultFolderId, defaultIsSeeThrough, defaultSearchText, defaultSelectedFacets, defaultSortDirection, defaultSortOrderName, token, useSession, useSiteSession, }: FetchAndMergeAssetsControllerOptions);
+    constructor(host: CortexElement, { additionalFields, availableDocTypes, baseUrl, bearerToken, defaultFolderId, defaultIsSeeThrough, defaultSearchText, defaultSelectedFacets, defaultSortDirection, defaultSortOrderName, titleFallback, token, useSession, useSiteSession, }: FetchAndMergeAssetsControllerOptions);
     private waitForNewToken;
     /**
      * Site-session mode decides the transport (cookies on the Cortex origin vs. Token/UseSession

package/build/types/asset.d.ts

@@ -1,3 +1,4 @@
+import type { TitleFallback } from '../types/content-browser';
 export type AssetVersion = {
     createByEmail: string;
     fileImportDate: string;
@@ -95,5 +96,7 @@ export type GetAssetsRequest = {
     sortOrder?: string;
     sortOrderName?: string;
     start?: number;
+    /** What the caption shows when the asset has no title. Default `uniqueIdentifier`. */
+    titleFallback?: TitleFallback;
     useSession?: string;
 };

package/build/types/content-browser.d.ts

@@ -179,6 +179,13 @@ export type CtaTextTransform = 'none' | 'uppercase' | 'lowercase' | 'capitalize'
  * of the last data column (`row-end`).
  */
 export type TableRowActionPosition = 'host-edge' | 'row-end';
+/**
+ * What the asset caption shows when the asset has no title: the unique identifier (`uniqueIdentifier`), or
+ * the original file name (`originalFileName`). A file name can hold private information, so a host must opt in.
+ */
+export type TitleFallback = 'uniqueIdentifier' | 'originalFileName';
+/** Reads a title fallback. Any value other than `originalFileName` gives `uniqueIdentifier`. */
+export declare function toTitleFallback(value: unknown): TitleFallback;
 /** Reads a row action position. Any value other than `row-end` gives `host-edge`. */
 export declare function toTableRowActionPosition(value: unknown): TableRowActionPosition;
 export declare enum ContentBrowserFormatDialogVariant {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orangelogic/orange-dam-content-browser-sdk",
-  "version": "2.4.9",
+  "version": "2.4.11",
   "description": "OrangeDAM Content Browser SDK source code",
   "main": "./build/OrangeDAMContentBrowserSDK.min.js",
   "module": "./build/index.mjs",