@agravity/private 10.3.0 → 10.3.2

package/README.md

@@ -1,8 +1,8 @@
-# @agravity/private@10.3.0
+# @agravity/private@10.3.2
 
   <p>Agravity is a powerful, enterprise-grade Headless Digital Asset Management (DAM) system designed for organizations that need complete control over how they manage, organize, and distribute their digital assets.</p>    <h2>Key Features</h2>  <ul>  <li>Asset Management - Upload, organize, and manage all types of digital assets (images, videos, documents, etc.)</li>  <li>Collections &amp; Hierarchies - Create flexible folder structures and collection types with customizable metadata</li>  <li>Advanced Search - Powered by Azure Cognitive Search with AI-enhanced capabilities for intelligent discovery</li>  <li>AI Integration - Leverage AI to automatically generate metadata, tags, and descriptions for your assets</li>  <li>Versioning - Track and restore previous versions of your assets with complete version history</li>  <li>Publishing &amp; Distribution - Publish assets to various channels including Vimeo, CDN, and custom portals</li>  <li>Portal System - Create public-facing portals with granular permission controls and custom branding</li>  <li>Download Formats - Define custom download formats with image transformations and optimizations</li>  <li>Collaboration Features - Share collections, create quick shares, and manage team access with role-based permissions</li>  <li>Multi-Language Support - Full translation capabilities for all metadata and UI elements</li>  <li>API-First Architecture - Complete REST API for seamless integration with your applications</li>  </ul>    <h2>Headless DAM Benefits</h2>  <p>As a headless DAM solution, Agravity separates content management from presentation. This means:</p>  <ul>  <li>Flexibility - Use the same assets across multiple channels and applications without duplication</li>  <li>API-Driven - Access all functionality through powerful REST APIs for custom integrations</li>  <li>Framework Agnostic - Integrate with any frontend framework or technology stack</li>  <li>Scalability - Built on cloud-native architecture with Azure infrastructure for unlimited growth</li>  <li>Multi-Channel Distribution - Publish to web, mobile, social media, and custom portals from a single source</li>  </ul>    <h2>Core Entities</h2>  <p><strong>Assets</strong> - Your digital content (images, videos, documents). Each asset can have multiple versions, metadata, and be published to various targets.</p>  <p><strong>Collections</strong> - Logical groupings of assets organized hierarchically. Support custom metadata through collection types.</p>  <p><strong>Collection Types</strong> - Define the structure and metadata fields for collections, similar to database schemas.</p>  <p><strong>Workspaces</strong> - Organize collection types into workspaces for multi-project management.</p>  <p><strong>Download Formats</strong> - Define transformations and optimizations for assets when downloaded.</p>  <p><strong>Portals</strong> - Public-facing interfaces for sharing collections with external stakeholders.</p>    <h2>API Endpoints Overview</h2>  <p><strong>Asset Management</strong> - Create, read, update, delete, and search assets with full metadata support</p>  <p><strong>Collection Management</strong> - Organize assets into collections with hierarchical structures</p>  <p><strong>AI Operations</strong> - Automatically generate asset metadata using AI-powered field generation</p>  <p><strong>Publishing</strong> - Publish assets to Vimeo, CDN, or custom publishing targets</p>  <p><strong>Search &amp; Discovery</strong> - Full-text search with advanced filtering and AI-enhanced similarity search</p>  <p><strong>User &amp; Portal Management</strong> - Control access through roles, profiles, and custom portals</p>  <p><strong>Content Distribution</strong> - Share collections, create download packages, and generate secure links</p>    <h2>Security &amp; Permissions</h2>  <ul>  <li>OAuth 2.0 authentication with Azure AD integration</li>  <li>Role-based access control (RBAC) with custom profiles</li>  <li>Entity-level permissions for granular control</li>  <li>API key authentication for service-to-service communication</li>  <li>Secure sharing with password-protected links and expiration dates</li>  </ul>    <h2>Use Cases</h2>  <ul>  <li>E-commerce product image management and distribution</li>  <li>Marketing asset management across multiple channels</li>  <li>Brand asset library and governance</li>  <li>Video content management and publishing</li>  <li>Enterprise document management with searchability</li>  <li>Multi-tenant content management for agencies</li>  <li>AI-powered metadata generation at scale</li>  </ul>    <h2>Support</h2>  <p>For questions or support, contact <a href=\"mailto:support@agravity.io\">support@agravity.io</a> or visit <a href=\"https://agravity.io\">https://agravity.io</a>.</p>    < p>Agravity © 2026 - Enterprise Headless Digital Asset Management</p>      
 
-The version of the OpenAPI document: 10.3.0
+The version of the OpenAPI document: 10.3.2
 
 ## Building
 
@@ -24,7 +24,7 @@ Navigate to the folder of your consuming project and run one of next commands.
 _published:_
 
 ```console
-npm install @agravity/private@10.3.0 --save
+npm install @agravity/private@10.3.2 --save
 ```
 
 _without publishing (not recommended):_

package/api/assetOperations.agravity.ts

@@ -54,7 +54,7 @@ export interface HttpAssetBulkCheckoutToggleRequestParams {
 	/** The list of asset IDs to checkout or checkin. */
 	assetBulkCheckoutBody: AssetBulkCheckoutBody;
 	/** Optional action for synced assets when FileShare MD5 metadata is missing. Allowed: keep, overwrite. If the synced FileShare file is missing, only overwrite is allowed. */
-	fsMissingMd5Action?: string;
+	fsMissingETagAction?: string;
 }
 
 export interface HttpAssetCheckoutToggleRequestParams {
@@ -63,7 +63,7 @@ export interface HttpAssetCheckoutToggleRequestParams {
 	/** Set to \'true\' to checkout the asset, \'false\' to checkin the asset. */
 	checkout: boolean;
 	/** Optional action for synced assets when FileShare MD5 metadata is missing. Allowed: keep, overwrite. If the synced FileShare file is missing, only overwrite is allowed. */
-	fsMissingMd5Action?: string;
+	fsMissingETagAction?: string;
 }
 
 export interface HttpAssetImageEditRequestParams {
@@ -190,6 +190,19 @@ export interface HttpGetAssetTextContentByIdRequestParams {
 	id: string;
 }
 
+export interface HttpGetAssetViewRequestParams {
+	/** The ID of the asset. */
+	id: string;
+	/** (optional) provide the id of any valid download format. Otherwise the original is returned. */
+	format?: string;
+	/** If the request comes from portal this is the indicator. It will be checked if the requested blob is valid for the portal. */
+	portalId?: string;
+	/** Returns assets on permissions which are locked and accessable (User needs editor permissions). Default: true */
+	locked?: boolean;
+	/** Returns assets which are not in state ACTIVE (User needs editor permissions). Default: true */
+	uncompleted?: boolean;
+}
+
 export interface HttpImageDynamicEditRequestParams {
 	/** The ID of the asset. */
 	id: string;
@@ -299,11 +312,11 @@ export class AssetOperationsService extends BaseService {
 		if (assetBulkCheckoutBody === null || assetBulkCheckoutBody === undefined) {
 			throw new Error('Required parameter assetBulkCheckoutBody was null or undefined when calling httpAssetBulkCheckoutToggle.');
 		}
-		const fsMissingMd5Action = requestParameters?.fsMissingMd5Action;
+		const fsMissingETagAction = requestParameters?.fsMissingETagAction;
 
 		let localVarQueryParameters = new HttpParams({ encoder: this.encoder });
 		localVarQueryParameters = this.addToHttpParams(localVarQueryParameters, <any>checkout, 'checkout');
-		localVarQueryParameters = this.addToHttpParams(localVarQueryParameters, <any>fsMissingMd5Action, 'fsMissingMd5Action');
+		localVarQueryParameters = this.addToHttpParams(localVarQueryParameters, <any>fsMissingETagAction, 'fsMissingETagAction');
 
 		let localVarHeaders = this.defaultHeaders;
 
@@ -390,11 +403,11 @@ export class AssetOperationsService extends BaseService {
 		if (checkout === null || checkout === undefined) {
 			throw new Error('Required parameter checkout was null or undefined when calling httpAssetCheckoutToggle.');
 		}
-		const fsMissingMd5Action = requestParameters?.fsMissingMd5Action;
+		const fsMissingETagAction = requestParameters?.fsMissingETagAction;
 
 		let localVarQueryParameters = new HttpParams({ encoder: this.encoder });
 		localVarQueryParameters = this.addToHttpParams(localVarQueryParameters, <any>checkout, 'checkout');
-		localVarQueryParameters = this.addToHttpParams(localVarQueryParameters, <any>fsMissingMd5Action, 'fsMissingMd5Action');
+		localVarQueryParameters = this.addToHttpParams(localVarQueryParameters, <any>fsMissingETagAction, 'fsMissingETagAction');
 
 		let localVarHeaders = this.defaultHeaders;
 
@@ -1532,6 +1545,90 @@ export class AssetOperationsService extends BaseService {
 		});
 	}
 
+	/**
+	 * This endpoint returns the binary directly to the endpoint
+	 * @param requestParameters
+	 * @param observe set whether or not to return the data Observable as the body, response or events. defaults to returning the body.
+	 * @param reportProgress flag to report request and response progress.
+	 */
+	public httpGetAssetView(
+		requestParameters: HttpGetAssetViewRequestParams,
+		observe?: 'body',
+		reportProgress?: boolean,
+		options?: { httpHeaderAccept?: 'application/json'; context?: HttpContext; transferCache?: boolean }
+	): Observable<AssetBlob>;
+	public httpGetAssetView(
+		requestParameters: HttpGetAssetViewRequestParams,
+		observe?: 'response',
+		reportProgress?: boolean,
+		options?: { httpHeaderAccept?: 'application/json'; context?: HttpContext; transferCache?: boolean }
+	): Observable<HttpResponse<AssetBlob>>;
+	public httpGetAssetView(
+		requestParameters: HttpGetAssetViewRequestParams,
+		observe?: 'events',
+		reportProgress?: boolean,
+		options?: { httpHeaderAccept?: 'application/json'; context?: HttpContext; transferCache?: boolean }
+	): Observable<HttpEvent<AssetBlob>>;
+	public httpGetAssetView(
+		requestParameters: HttpGetAssetViewRequestParams,
+		observe: any = 'body',
+		reportProgress: boolean = false,
+		options?: { httpHeaderAccept?: 'application/json'; context?: HttpContext; transferCache?: boolean }
+	): Observable<any> {
+		const id = requestParameters?.id;
+		if (id === null || id === undefined) {
+			throw new Error('Required parameter id was null or undefined when calling httpGetAssetView.');
+		}
+		const format = requestParameters?.format;
+		const portalId = requestParameters?.portalId;
+		const locked = requestParameters?.locked;
+		const uncompleted = requestParameters?.uncompleted;
+
+		let localVarQueryParameters = new HttpParams({ encoder: this.encoder });
+		localVarQueryParameters = this.addToHttpParams(localVarQueryParameters, <any>format, 'format');
+		localVarQueryParameters = this.addToHttpParams(localVarQueryParameters, <any>portalId, 'portal_id');
+		localVarQueryParameters = this.addToHttpParams(localVarQueryParameters, <any>locked, 'locked');
+		localVarQueryParameters = this.addToHttpParams(localVarQueryParameters, <any>uncompleted, 'uncompleted');
+
+		let localVarHeaders = this.defaultHeaders;
+
+		// authentication (msal_auth) required
+		localVarHeaders = this.configuration.addCredentialToHeaders('msal_auth', 'Authorization', localVarHeaders, 'Bearer ');
+
+		const localVarHttpHeaderAcceptSelected: string | undefined = options?.httpHeaderAccept ?? this.configuration.selectHeaderAccept(['application/json']);
+		if (localVarHttpHeaderAcceptSelected !== undefined) {
+			localVarHeaders = localVarHeaders.set('Accept', localVarHttpHeaderAcceptSelected);
+		}
+
+		const localVarHttpContext: HttpContext = options?.context ?? new HttpContext();
+
+		const localVarTransferCache: boolean = options?.transferCache ?? true;
+
+		let responseType_: 'text' | 'json' | 'blob' = 'json';
+		if (localVarHttpHeaderAcceptSelected) {
+			if (localVarHttpHeaderAcceptSelected.startsWith('text')) {
+				responseType_ = 'text';
+			} else if (this.configuration.isJsonMime(localVarHttpHeaderAcceptSelected)) {
+				responseType_ = 'json';
+			} else {
+				responseType_ = 'blob';
+			}
+		}
+
+		let localVarPath = `/assets/${this.configuration.encodeParam({ name: 'id', value: id, in: 'path', style: 'simple', explode: false, dataType: 'string', dataFormat: undefined })}/view`;
+		const { basePath, withCredentials } = this.configuration;
+		return this.httpClient.request<AssetBlob>('get', `${basePath}${localVarPath}`, {
+			context: localVarHttpContext,
+			params: localVarQueryParameters,
+			responseType: <any>responseType_,
+			...(withCredentials ? { withCredentials } : {}),
+			headers: localVarHeaders,
+			observe: observe,
+			transferCache: localVarTransferCache,
+			reportProgress: reportProgress
+		});
+	}
+
 	/**
 	 * This endpoint lets you use the entire api of Imagemagick to edit the image.
 	 * @param requestParameters

package/model/asset.agravity.ts

@@ -28,7 +28,7 @@ export interface Asset {
 	available_from?: string | null;
 	available_to?: string | null;
 	checkout?: AssetCheckout | null;
-	fs_synced?: boolean | null;
+	fs_synced?: string | null;
 	custom?: any | null;
 	items?: Array<CollTypeItem> | null;
 	translations?: { [key: string]: { [key: string]: any } } | null;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agravity/private",
-	"version": "10.3.0",
+	"version": "10.3.2",
 	"description": "The Agravity GlobalDAM API which allowes authenticated user to access the Agravity GlobalDAM Backend",
 	"author": "Philipp Losbichler",
 	"repository": {