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

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

@@ -1,11 +1,13 @@
 import CortexElement from '../base/element';
-import { GetAssetLinksRequest, GetAvailableExtensionsResponse } from '../api/asset/asset.types';
+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 { GetFolderRequest } from '../types/folder';
 import type { ReactiveController } from 'lit';
 type FetchAndMergeAssetsControllerOptions = {
+    /** Cortex fields the table-view columns read, requested on every search alongside the fixed set. */
+    additionalFields?: string[];
     availableDocTypes: string[];
     baseUrl: string;
     bearerToken: string;
@@ -30,6 +32,8 @@ export declare class FetchAndMergeAssetsController implements ReactiveController
     private facets;
     private items;
     private totalCount;
+    /** The requested fields, spelled as Cortex sent them, that the user cannot read on the rows in `items`. */
+    private unreadableFields;
     private lastRequest;
     /** The resolved request of the last search that got an error. A retry sends it again. */
     private failedRequest;
@@ -48,6 +52,7 @@ export declare class FetchAndMergeAssetsController implements ReactiveController
     private resolvePendingTokenRefresh;
     private readonly tokenRefreshTimeoutMs;
     private readonly availableDocTypes;
+    private additionalFields;
     private readonly defaultSearchText;
     private readonly defaultSelectedFacets;
     private readonly defaultSortOrderName;
@@ -56,7 +61,7 @@ export declare class FetchAndMergeAssetsController implements ReactiveController
     private readonly defaultIsSeeThrough;
     private requestInterceptorId;
     private responseInterceptorId;
-    constructor(host: CortexElement, { 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, token, useSession, useSiteSession, }: FetchAndMergeAssetsControllerOptions);
     private waitForNewToken;
     /**
      * Site-session mode decides the transport (cookies on the Cortex origin vs. Token/UseSession
@@ -68,13 +73,19 @@ export declare class FetchAndMergeAssetsController implements ReactiveController
      * step with the UI instead of serving requests through the mode the controller was built with.
      */
     updateSiteSession(useSiteSession: boolean, baseUrl: string, token: string, useSession: string, bearerToken: string): void;
+    /**
+     * Table columns are host configuration and can be reconfigured after mount, unlike the rest of
+     * these options — every later fetch must ask for the current field list, not the one that
+     * happened to be set when the controller was constructed.
+     */
+    updateAdditionalFields(additionalFields: string[]): void;
     updateAuth(token: string, useSession: string, bearerToken: string): void;
     private fetchInitialData;
     private _debounceTimeout;
     private _debouncePromise;
     private _debounceResolve;
     private mapAvailableExtensions;
-    fetchAssets(request: GetAssetsRequest): Promise<import("../api/asset/asset.types").GetAssetsResponse>;
+    fetchAssets(request: GetAssetsRequest): Promise<GetAssetsResponse>;
     fetchFolders(request: GetFolderRequest): Promise<import("../types/folder").GetFolderResponse>;
     /** Sends the last search that got an error again, with the same page and controls. */
     retrySearch(): Promise<void>;
@@ -150,6 +161,7 @@ export declare class FetchAndMergeAssetsController implements ReactiveController
         searchError: boolean;
         sortOrders: Record<string, SortOrder[]>;
         totalCount: number;
+        unreadableFields: string[];
         userInfo: UserInfo | null;
     };
     hostConnected(): void;

package/build/types/asset.d.ts

@@ -80,6 +80,11 @@ export type GetAssetLinksRequest = {
     useRepresentative?: boolean;
 };
 export type GetAssetsRequest = {
+    /**
+     * Extra Cortex fields to request alongside the fixed set, returned on each item under the field
+     * name as sent. Used by the table view to resolve host-configured columns.
+     */
+    fields?: string[];
     folderId?: string;
     isSeeThrough?: boolean;
     limitedToDocTypes?: string[];

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

@@ -39,6 +39,37 @@ export declare enum GridView {
     Medium = "medium",
     Small = "small"
 }
+/**
+ * The table layout. `GridView` members are the grid's pixel-width presets, so a layout that is not
+ * a grid at all cannot be one of them.
+ */
+export declare const TABLE_VIEW = "table";
+/** What the content browser is currently rendering: one of the grid size presets, or the table. */
+export type ContentBrowserView = GridView | typeof TABLE_VIEW;
+export type TableColumnAlign = 'center' | 'left' | 'right';
+/**
+ * One column of the table view. The host owns the column set: the SDK ships the mechanism and no
+ * default column list, so nothing here is guessed from the asset's doc type.
+ */
+export type TableColumn = {
+    /** @deprecated Ignored. The table fits each column to its content, and the user resizes it. */
+    align?: TableColumnAlign;
+    /**
+     * Cortex field the column reads, e.g. `CoreField.Identifier` or `Dell.Snippet`. It is appended to
+     * the field list of the same search call the grid uses, so what a given caller gets back is decided
+     * server-side — the SDK neither filters nor resolves fields of its own. Surrounding whitespace
+     * is trimmed, and the trimmed name is what the duplicate-column check compares. When Cortex flags
+     * the field as one the user cannot read, the table does not show the column, as the DAM does. The
+     * field stays in the request, so that the next response can flag it again.
+     */
+    field: string;
+    /** @deprecated Ignored. The table fits each column to its content, and the user resizes it. */
+    lines?: number;
+    /** Column header text. */
+    title: string;
+    /** @deprecated Ignored. The table fits each column to its content, and the user resizes it. */
+    width?: string;
+};
 export declare const ASSET_SIZE: {
     small: {
         maxWidth: number;
@@ -113,8 +144,46 @@ export type FocusMode = {
     value: string;
 };
 export type DefaultFocusMode = 'manual' | 'center';
+/**
+ * Import behaviour when the host would rather not show the format picker.
+ *
+ * - `false` — the format dialog opens as usual.
+ * - `true` — insert with the first available format, without showing the dialog.
+ * - a format name — insert with that format, matched case-insensitively against a proxy's
+ *   `proxyName` or `proxyLabel`. A name matching nothing opens the dialog as usual.
+ */
+export type AutoSelectFormat = boolean | string;
+/**
+ * Serves markup hosts: `<cx-content-browser auto-select-format="WEB">`. The union has to survive a
+ * round trip through a string, so `"true"`/`"false"` are the booleans and anything else is a format
+ * name; a bare attribute means `true`, matching how a boolean attribute normally reads.
+ *
+ * React hosts bypass this entirely — `CortexElement.createProperty` aliases the attribute name onto
+ * the prototype, so react-dom finds `'auto-select-format' in element` and assigns the property with
+ * its real type rather than setting an attribute.
+ */
+export declare const autoSelectFormatConverter: {
+    fromAttribute: (value: string | null) => AutoSelectFormat;
+    toAttribute: (value: AutoSelectFormat) => string | null;
+};
+/**
+ * Whether `autoSelectFormat` is switched on at all — a blank string is off, not a format named " ".
+ *
+ * Config-level, not per-asset: it says the host has asked to skip the picker, not that this
+ * particular asset will skip it. A named format that no proxy matches still opens the dialog.
+ */
+export declare function isAutoSelectFormatActive(value: AutoSelectFormat): boolean;
 export type CtaTextTransform = 'none' | 'uppercase' | 'lowercase' | 'capitalize';
+/**
+ * Where the table shows the row action: at the right edge of the host (`host-edge`), or at the end
+ * of the last data column (`row-end`).
+ */
+export type TableRowActionPosition = 'host-edge' | 'row-end';
+/** 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 {
     Dialog = "dialog",
     Drawer = "drawer"
 }
+/** Two Cortex field names name one field when these keys are equal: the table trims and ignores case. */
+export declare function toFieldKey(field: string): string;

package/build/utils/table-column-widths.d.ts

@@ -0,0 +1,5 @@
+export type TableColumnWidths = Record<string, number>;
+/** A site URL with and without a trailing slash gives the same key. */
+export declare function tableColumnWidthsKey(siteUrl: string): string;
+export declare function readTableColumnWidths(siteUrl: string): Promise<TableColumnWidths>;
+export declare function writeTableColumnWidth(siteUrl: string, field: string, width: number | undefined): Promise<TableColumnWidths>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orangelogic/orange-dam-content-browser-sdk",
-  "version": "2.4.8",
+  "version": "2.4.9",
   "description": "OrangeDAM Content Browser SDK source code",
   "main": "./build/OrangeDAMContentBrowserSDK.min.js",
   "module": "./build/index.mjs",
@@ -93,7 +93,7 @@
   "dependencies": {
     "@lit-labs/virtualizer": "^2.1.1",
     "@open-wc/testing": "^4.0.0",
-    "@orangelogic/design-system": "3.40.0",
+    "@orangelogic/design-system": "3.56.0",
     "@reduxjs/toolkit": "^2.11.2",
     "@types/node": "^20.4.8",
     "@types/react": "^19.0.8",