@storyblok/management-api-client 1.0.0-alpha.1 → 1.0.0-alpha.2

package/dist/resources/assets.cjs

@@ -1,6 +1,6 @@
 const require_error = require('../error.cjs');
+const require_sdk_gen = require('../generated/mapi/sdk.gen.cjs');
 const require_shared = require('./shared.cjs');
-const require_sdk_gen = require('../generated/assets/sdk.gen.cjs');
 
 //#region src/resources/assets.ts
 /** Uploads the file to S3 using the signed fields from step 1. */
@@ -25,6 +25,7 @@ async function uploadToS3(signedResponse, file, filename) {
 		data: void 0
 	});
 }
+const hasDefinedFields = (value) => Object.values(value ?? {}).some((v) => v !== void 0 && v !== null);
 function createAssetsResource(deps) {
 	const { client, spaceId, wrapRequest } = deps;
 	const getSpaceId = (path) => require_shared.resolveSpaceId(spaceId, path);
@@ -32,7 +33,7 @@ function createAssetsResource(deps) {
 		list(options = {}) {
 			const { query, signal, path, throwOnError, fetchOptions } = options;
 			const resolvedSpaceId = getSpaceId(path);
-			return wrapRequest(() => require_sdk_gen.list({
+			return wrapRequest(() => require_sdk_gen.listAssets({
 				client,
 				path: { space_id: resolvedSpaceId },
 				query,
@@ -45,12 +46,12 @@ function createAssetsResource(deps) {
 			}), throwOnError);
 		},
 		signResponseObject(options) {
-			const { body, signal, path, throwOnError, fetchOptions } = options;
+			const { query, signal, path, throwOnError, fetchOptions } = options;
 			const resolvedSpaceId = getSpaceId(path);
-			return wrapRequest(() => require_sdk_gen.signResponseObject({
+			return wrapRequest(() => require_sdk_gen.createAsset({
 				client,
 				path: { space_id: resolvedSpaceId },
-				body,
+				query,
 				signal,
 				...throwOnError === void 0 ? {} : { throwOnError },
 				...fetchOptions ? { kyOptions: {
@@ -62,40 +63,39 @@ function createAssetsResource(deps) {
 		async upload(options) {
 			const { body, file, signal, path, fetchOptions } = options;
 			const { short_filename, ...rest } = body;
-			const signBody = {
-				filename: short_filename,
-				...rest
-			};
 			const resolvedSpaceId = getSpaceId(path);
 			const kyOpts = fetchOptions ? { kyOptions: {
 				...client.getConfig().kyOptions,
 				...fetchOptions
 			} } : {};
-			const signResult = await wrapRequest(() => require_sdk_gen.signResponseObject({
+			const signResult = await wrapRequest(() => require_sdk_gen.createAsset({
 				client,
 				path: { space_id: resolvedSpaceId },
-				body: signBody,
+				query: {
+					filename: short_filename,
+					...rest
+				},
 				signal,
 				throwOnError: true,
 				...kyOpts
 			}), true);
 			if (!signResult.data.id) throw new Error("Invalid signed response: missing id");
 			await uploadToS3(signResult.data, file, short_filename);
-			await wrapRequest(() => require_sdk_gen.finalize({
+			await wrapRequest(() => require_sdk_gen.finishAssetUpload({
 				client,
 				path: {
 					space_id: resolvedSpaceId,
-					signed_response_object_id: String(signResult.data.id)
+					id: Number(signResult.data.id)
 				},
 				signal,
 				throwOnError: true,
 				...kyOpts
 			}), true);
-			return (await wrapRequest(() => require_sdk_gen.get({
+			return (await wrapRequest(() => require_sdk_gen.getAsset({
 				client,
 				path: {
 					space_id: resolvedSpaceId,
-					asset_id: Number(signResult.data.id)
+					id: Number(signResult.data.id)
 				},
 				signal,
 				throwOnError: true,
@@ -109,35 +109,38 @@ function createAssetsResource(deps) {
 				...client.getConfig().kyOptions,
 				...fetchOptions
 			} } : {};
+			const { short_filename, asset_folder_id, is_private, size, validate_upload, ext_id, ...metadataOnly } = body;
 			const asset = await this.upload({
 				body: {
-					short_filename: body.short_filename,
-					asset_folder_id: body.asset_folder_id,
-					is_private: body.is_private
+					short_filename,
+					asset_folder_id,
+					is_private,
+					size,
+					validate_upload,
+					ext_id
 				},
 				file,
 				signal,
 				path: { space_id: resolvedSpaceId },
 				fetchOptions
 			});
-			const { short_filename, asset_folder_id, is_private, size, validate_upload, ...metadata } = body;
-			if (Object.values(metadata).some((v) => v !== void 0 && v !== null)) {
-				await wrapRequest(() => require_sdk_gen.update({
+			if (Object.values(metadataOnly).some((v) => v !== void 0 && v !== null)) {
+				await wrapRequest(() => require_sdk_gen.updateAsset({
 					client,
 					path: {
 						space_id: resolvedSpaceId,
-						asset_id: asset.id
+						id: asset.id
 					},
-					body: { asset: metadata },
+					body: { asset: metadataOnly },
 					signal,
 					throwOnError: true,
 					...kyOpts
 				}), true);
-				return (await wrapRequest(() => require_sdk_gen.get({
+				return (await wrapRequest(() => require_sdk_gen.getAsset({
 					client,
 					path: {
 						space_id: resolvedSpaceId,
-						asset_id: asset.id
+						id: asset.id
 					},
 					signal,
 					throwOnError: true,
@@ -149,11 +152,11 @@ function createAssetsResource(deps) {
 		get(assetId, options = {}) {
 			const { signal, path, throwOnError, fetchOptions } = options;
 			const resolvedSpaceId = getSpaceId(path);
-			return wrapRequest(() => require_sdk_gen.get({
+			return wrapRequest(() => require_sdk_gen.getAsset({
 				client,
 				path: {
 					space_id: resolvedSpaceId,
-					asset_id: assetId
+					id: assetId
 				},
 				signal,
 				...throwOnError === void 0 ? {} : { throwOnError },
@@ -172,45 +175,42 @@ function createAssetsResource(deps) {
 			} } : {};
 			if (file !== void 0) {
 				const { short_filename, ...assetBody } = body;
-				const signResult = await wrapRequest(() => require_sdk_gen.signResponseObject({
+				const signResult = await wrapRequest(() => require_sdk_gen.createAsset({
 					client,
 					path: { space_id: resolvedSpaceId },
-					body: {
-						filename: short_filename,
-						id: Number(assetId)
-					},
+					query: { filename: short_filename },
 					signal,
 					throwOnError: true,
 					...kyOpts
 				}), true);
 				if (!signResult.data.id) throw new Error("Invalid signed response: missing id");
 				await uploadToS3(signResult.data, file, short_filename);
-				await wrapRequest(() => require_sdk_gen.finalize({
+				await wrapRequest(() => require_sdk_gen.finishAssetUpload({
 					client,
 					path: {
 						space_id: resolvedSpaceId,
-						signed_response_object_id: String(signResult.data.id)
+						id: Number(signResult.data.id)
 					},
 					signal,
 					throwOnError: true,
 					...kyOpts
 				}), true);
-				if (assetBody.asset && Object.keys(assetBody.asset).length > 0) await wrapRequest(() => require_sdk_gen.update({
+				if (hasDefinedFields(assetBody.asset)) await wrapRequest(() => require_sdk_gen.updateAsset({
 					client,
 					path: {
 						space_id: resolvedSpaceId,
-						asset_id: assetId
+						id: assetId
 					},
 					body: assetBody,
 					signal,
 					throwOnError: true,
 					...kyOpts
 				}), true);
-			} else await wrapRequest(() => require_sdk_gen.update({
+			} else await wrapRequest(() => require_sdk_gen.updateAsset({
 				client,
 				path: {
 					space_id: resolvedSpaceId,
-					asset_id: assetId
+					id: assetId
 				},
 				body,
 				signal,
@@ -221,11 +221,11 @@ function createAssetsResource(deps) {
 		delete(assetId, options = {}) {
 			const { signal, path, throwOnError, fetchOptions } = options;
 			const resolvedSpaceId = getSpaceId(path);
-			return wrapRequest(() => require_sdk_gen.delete_({
+			return wrapRequest(() => require_sdk_gen.deleteAsset({
 				client,
 				path: {
 					space_id: resolvedSpaceId,
-					asset_id: assetId
+					id: assetId
 				},
 				signal,
 				...throwOnError === void 0 ? {} : { throwOnError },
@@ -235,14 +235,14 @@ function createAssetsResource(deps) {
 				} } : {}
 			}), throwOnError);
 		},
-		finalize(signedResponseObjectId, options = {}) {
+		finalize(assetId, options = {}) {
 			const { signal, path, throwOnError, fetchOptions } = options;
 			const resolvedSpaceId = getSpaceId(path);
-			return wrapRequest(() => require_sdk_gen.finalize({
+			return wrapRequest(() => require_sdk_gen.finishAssetUpload({
 				client,
 				path: {
 					space_id: resolvedSpaceId,
-					signed_response_object_id: signedResponseObjectId
+					id: assetId
 				},
 				signal,
 				...throwOnError === void 0 ? {} : { throwOnError },
@@ -255,7 +255,7 @@ function createAssetsResource(deps) {
 		deleteMany(options) {
 			const { body, signal, path, throwOnError, fetchOptions } = options;
 			const resolvedSpaceId = getSpaceId(path);
-			return wrapRequest(() => require_sdk_gen.deleteMany({
+			return wrapRequest(() => require_sdk_gen.bulkDestroyAssets({
 				client,
 				path: { space_id: resolvedSpaceId },
 				body,
@@ -270,7 +270,7 @@ function createAssetsResource(deps) {
 		bulkMove(options) {
 			const { body, signal, path, throwOnError, fetchOptions } = options;
 			const resolvedSpaceId = getSpaceId(path);
-			return wrapRequest(() => require_sdk_gen.bulkMove({
+			return wrapRequest(() => require_sdk_gen.bulkUpdateAssets({
 				client,
 				path: { space_id: resolvedSpaceId },
 				body,
@@ -285,7 +285,7 @@ function createAssetsResource(deps) {
 		bulkRestore(options) {
 			const { body, signal, path, throwOnError, fetchOptions } = options;
 			const resolvedSpaceId = getSpaceId(path);
-			return wrapRequest(() => require_sdk_gen.bulkRestore({
+			return wrapRequest(() => require_sdk_gen.bulkRestoreAssets({
 				client,
 				path: { space_id: resolvedSpaceId },
 				body,
@@ -296,6 +296,24 @@ function createAssetsResource(deps) {
 					...fetchOptions
 				} } : {}
 			}), throwOnError);
+		},
+		convertToShared(assetId, options) {
+			const { query, signal, path, throwOnError, fetchOptions } = options;
+			const resolvedSpaceId = getSpaceId(path);
+			return wrapRequest(() => client.post({
+				url: "/v1/spaces/{space_id}/assets/{asset_id}/convert",
+				path: {
+					space_id: resolvedSpaceId,
+					asset_id: assetId
+				},
+				query,
+				signal,
+				...throwOnError === void 0 ? {} : { throwOnError },
+				...fetchOptions ? { kyOptions: {
+					...client.getConfig().kyOptions,
+					...fetchOptions
+				} } : {}
+			}), throwOnError);
 		}
 	};
 }

package/dist/resources/assets.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"assets.cjs","names":["ClientError","resolveSpaceId"],"sources":["../../src/resources/assets.ts"],"sourcesContent":["import * as assetsApi from '../generated/assets/sdk.gen';\nimport type {\n  Asset,\n  AssetSignRequest,\n  AssetUpdate,\n  BulkMoveData,\n  BulkMoveResponses,\n  BulkRestoreData,\n  BulkRestoreResponses,\n  DeleteManyData,\n  DeleteManyResponses,\n  DeleteResponses,\n  FinalizeResponses,\n  GetResponses,\n  ListData,\n  ListResponses,\n  SignResponseObjectData,\n  SignResponseObjectResponses,\n  UpdateData,\n  UpdateResponses,\n} from '../generated/assets/types.gen';\nimport type { ApiResponse, FetchOptions, MapiResourceDeps } from '../client';\nimport { ClientError } from '../error';\nimport { resolveSpaceId, type SpaceIdPathOverride } from './shared';\n\nexport type AssetListQuery = NonNullable<ListData['query']>;\n\n/**\n * Fields for initiating an asset upload. Pass this to `upload()`, `create()`,\n * or `update()` alongside a file buffer.\n *\n * Uses `short_filename` (e.g. `\"hero.png\"`) to clearly distinguish it from\n * `Asset.filename`, which is the full CDN URL assigned by Storyblok after upload.\n *\n * If you need to call the raw sign endpoint directly, use\n * `signResponseObject()` with `AssetSignRequest` instead.\n */\nexport interface AssetUploadRequest {\n  /** The desired filename for the asset (e.g. `\"hero.png\"`). Corresponds to `Asset.short_filename`. */\n  short_filename: string;\n  /** When set, the upload replaces the file of an existing asset with this ID. */\n  id?: AssetSignRequest['id'];\n  /** Place the asset in this folder. */\n  asset_folder_id?: AssetSignRequest['asset_folder_id'];\n  /** Mark the asset as private (inaccessible without a signed URL). */\n  is_private?: AssetSignRequest['is_private'];\n  /** Image dimensions in `\"<width>x<height>\"` format (e.g. `\"400x500\"`). */\n  size?: AssetSignRequest['size'];\n  /** Set to `1` to enable server-side upload validation. */\n  validate_upload?: AssetSignRequest['validate_upload'];\n}\n\n/**\n * Input for `create()`. Combines upload fields (`short_filename`,\n * `asset_folder_id`, etc.) with writable metadata (`alt`, `title`,\n * `copyright`, etc.). The file buffer is passed separately.\n */\nexport type AssetCreate = AssetUpdate & AssetUploadRequest;\n\n/** Uploads the file to S3 using the signed fields from step 1. */\nasync function uploadToS3(\n  signedResponse: SignResponseObjectResponses[200],\n  file: Blob | ArrayBuffer,\n  filename: string,\n): Promise<void> {\n  if (!signedResponse.post_url || !signedResponse.fields) {\n    throw new ClientError('Invalid signed response: missing post_url or fields', {\n      status: 0,\n      statusText: 'Invalid signed response',\n      data: signedResponse,\n    });\n  }\n  const formData = new FormData();\n  for (const [key, value] of Object.entries(signedResponse.fields)) {\n    formData.append(key, value as string);\n  }\n  const contentType = (signedResponse.fields['Content-Type'] as string | undefined) ?? 'application/octet-stream';\n  const blob = file instanceof Blob ? file : new Blob([file], { type: contentType });\n  formData.append('file', new File([blob], filename, { type: contentType }));\n  const response = await fetch(signedResponse.post_url, { method: 'POST', body: formData });\n  if (!response.ok) {\n    throw new ClientError(`Failed to upload asset to S3: ${response.statusText}`, {\n      status: response.status,\n      statusText: response.statusText,\n      data: undefined,\n    });\n  }\n}\n\nexport function createAssetsResource<DefaultThrowOnError extends boolean = false>(deps: MapiResourceDeps<DefaultThrowOnError>) {\n  const { client, spaceId, wrapRequest } = deps;\n  const getSpaceId = (path?: SpaceIdPathOverride['path']) => resolveSpaceId(spaceId, path);\n\n  return {\n    list<ThrowOnError extends boolean = DefaultThrowOnError>(options: { query?: ListData['query']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<ListResponses[200], ThrowOnError>> {\n      const { query, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<ListResponses[200], ThrowOnError>(() =>\n        assetsApi.list({ client, path: { space_id: resolvedSpaceId }, query, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Requests a signed response object (step 1 of the upload flow).\n     * Returns the S3 `post_url` and form `fields` needed for the actual upload.\n     *\n     * In most cases, prefer `upload()` or `create()` which handle all three\n     * steps automatically.\n     */\n    signResponseObject<ThrowOnError extends boolean = DefaultThrowOnError>(options: { body: SignResponseObjectData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<SignResponseObjectResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<SignResponseObjectResponses[200], ThrowOnError>(() =>\n        assetsApi.signResponseObject({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Uploads a file to Storyblok (sign → S3 upload → finalize) and returns\n     * the resulting `Asset`.\n     *\n     * To also set metadata (alt, title, etc.) in one call, use `create()`.\n     */\n    async upload(options: { body: AssetUploadRequest; file: Blob | ArrayBuffer; signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<Asset> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const { short_filename, ...rest } = body;\n      const signBody: AssetSignRequest = { filename: short_filename, ...rest };\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      const signResult = await wrapRequest<SignResponseObjectResponses[200], true>(() =>\n        assetsApi.signResponseObject({ client, path: { space_id: resolvedSpaceId }, body: signBody, signal, throwOnError: true, ...kyOpts }), true);\n\n      if (!signResult.data.id) {\n        throw new Error('Invalid signed response: missing id');\n      }\n\n      await uploadToS3(signResult.data, file, short_filename);\n\n      await wrapRequest<FinalizeResponses[200], true>(() =>\n        assetsApi.finalize({\n          client,\n          path: { space_id: resolvedSpaceId, signed_response_object_id: String(signResult.data.id) },\n          signal,\n          throwOnError: true,\n          ...kyOpts,\n        }), true);\n\n      const getResult = await wrapRequest<GetResponses[200], true>(() =>\n        assetsApi.get({ client, path: { space_id: resolvedSpaceId, asset_id: Number(signResult.data.id) }, signal, throwOnError: true, ...kyOpts }), true);\n\n      return getResult.data;\n    },\n    /**\n     * Creates a new asset with metadata. Performs the full upload flow, then\n     * applies any provided metadata (alt, title, copyright, etc.) in a\n     * follow-up update call. Returns the resulting `Asset`.\n     */\n    async create(options: { body: AssetCreate; file: Blob | ArrayBuffer; signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<Asset> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      const asset = await this.upload({\n        body: {\n          short_filename: body.short_filename,\n          asset_folder_id: body.asset_folder_id,\n          is_private: body.is_private,\n        },\n        file,\n        signal,\n        path: { space_id: resolvedSpaceId },\n        fetchOptions,\n      });\n\n      const { short_filename, asset_folder_id, is_private, size, validate_upload, ...metadata } = body;\n      const hasMetadata = Object.values(metadata).some(v => v !== undefined && v !== null);\n      if (hasMetadata) {\n        await wrapRequest<UpdateResponses[204], true>(() =>\n          assetsApi.update({\n            client,\n            path: { space_id: resolvedSpaceId, asset_id: asset.id },\n            body: { asset: metadata },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n        const updatedResult = await wrapRequest<GetResponses[200], true>(() =>\n          assetsApi.get({ client, path: { space_id: resolvedSpaceId, asset_id: asset.id }, signal, throwOnError: true, ...kyOpts }), true);\n        return updatedResult.data;\n      }\n\n      return asset;\n    },\n    get<ThrowOnError extends boolean = DefaultThrowOnError>(assetId: number | string, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<GetResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<GetResponses[200], ThrowOnError>(() =>\n        assetsApi.get({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Updates an asset's metadata. When `file` and `short_filename` are\n     * provided, the file is replaced first (sign → S3 → finalize), then\n     * metadata is updated.\n     */\n    async update(\n      assetId: number | string,\n      options: (\n        | { body: UpdateData['body']; file?: undefined }\n        | { body: UpdateData['body'] & { short_filename: string }; file: Blob | ArrayBuffer }\n      ) & { signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride,\n    ): Promise<void> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      if (file !== undefined) {\n        const { short_filename, ...assetBody } = body;\n        const signResult = await wrapRequest<SignResponseObjectResponses[200], true>(() =>\n          assetsApi.signResponseObject({\n            client,\n            path: { space_id: resolvedSpaceId },\n            body: { filename: short_filename, id: Number(assetId) },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n\n        if (!signResult.data.id) {\n          throw new Error('Invalid signed response: missing id');\n        }\n\n        await uploadToS3(signResult.data, file, short_filename);\n\n        await wrapRequest<FinalizeResponses[200], true>(() =>\n          assetsApi.finalize({\n            client,\n            path: { space_id: resolvedSpaceId, signed_response_object_id: String(signResult.data.id) },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n\n        if (assetBody.asset && Object.keys(assetBody.asset).length > 0) {\n          await wrapRequest<UpdateResponses[204], true>(() =>\n            assetsApi.update({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, body: assetBody, signal, throwOnError: true, ...kyOpts }), true);\n        }\n      }\n      else {\n        await wrapRequest<UpdateResponses[204], true>(() =>\n          assetsApi.update({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, body, signal, throwOnError: true, ...kyOpts }), true);\n      }\n    },\n    delete<ThrowOnError extends boolean = DefaultThrowOnError>(assetId: number | string, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<DeleteResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<DeleteResponses[200], ThrowOnError>(() =>\n        assetsApi.delete_({ client, path: { space_id: resolvedSpaceId, asset_id: assetId }, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    finalize<ThrowOnError extends boolean = DefaultThrowOnError>(signedResponseObjectId: string, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<FinalizeResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<FinalizeResponses[200], ThrowOnError>(() =>\n        assetsApi.finalize({\n          client,\n          path: { space_id: resolvedSpaceId, signed_response_object_id: signedResponseObjectId },\n          signal,\n          ...(throwOnError === undefined ? {} : { throwOnError }),\n          ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}),\n        }), throwOnError);\n    },\n    deleteMany<ThrowOnError extends boolean = DefaultThrowOnError>(options: { body: DeleteManyData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<DeleteManyResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<DeleteManyResponses[200], ThrowOnError>(() =>\n        assetsApi.deleteMany({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    bulkMove<ThrowOnError extends boolean = DefaultThrowOnError>(options: { body: BulkMoveData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<BulkMoveResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<BulkMoveResponses[200], ThrowOnError>(() =>\n        assetsApi.bulkMove({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    bulkRestore<ThrowOnError extends boolean = DefaultThrowOnError>(options: { body: BulkRestoreData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<BulkRestoreResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<BulkRestoreResponses[200], ThrowOnError>(() =>\n        assetsApi.bulkRestore({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"assets.cjs","names":["ClientError","resolveSpaceId"],"sources":["../../src/resources/assets.ts"],"sourcesContent":["import * as mapi from '../generated/mapi/sdk.gen';\nimport type {\n  BulkDestroyAssetsData,\n  BulkDestroyAssetsResponses,\n  BulkRestoreAssetsData,\n  BulkRestoreAssetsResponses,\n  BulkUpdateAssetsData,\n  BulkUpdateAssetsResponses,\n  CreateAssetData,\n  CreateAssetResponses,\n  DeleteAssetResponses,\n  FinishAssetUploadResponses,\n  GetAssetResponses,\n  ListAssetsData,\n  ListAssetsResponses,\n  CreateAsset as SignedResponseObject,\n  UpdateAssetData,\n  UpdateAssetResponses,\n} from '../generated/mapi/types.gen';\nimport type { Asset } from '../generated/mapi/types-aliased.gen';\nimport type { ApiResponse, FetchOptions, MapiResourceDeps } from '../client';\nimport { ClientError } from '../error';\nimport { resolveSpaceId, type SpaceIdPathOverride } from './shared';\n\nexport type AssetListQuery = NonNullable<ListAssetsData['query']>;\n\n/**\n * Return shape of `list()`.\n *\n * The list endpoint serializes rows with MAPI's `IndexAsset` serializer, which\n * is NOT identical to the `ShowAsset` (= `Asset`) shape returned by `get()`:\n * `IndexAsset` omits `file` and `permanently_deleted`. We deliberately surface\n * list rows as `Asset` so consumers work against a single asset type. The lie:\n * `file`/`permanently_deleted` are absent on list rows at runtime — consumers\n * needing those must re-fetch via `get()`.\n */\nexport type ListAssetsResult = Omit<ListAssetsResponses[200], 'assets'> & { assets: Array<Asset> };\n\n/**\n * Fields for initiating an asset upload. Pass this to `upload()` or `create()`\n * alongside a file buffer.\n */\nexport type AssetUploadRequest = {\n  /** The desired filename for the asset (e.g. `\"hero.png\"`). */\n  short_filename: string;\n} & Partial<Omit<NonNullable<CreateAssetData['query']>, 'filename'>>;\n\n/**\n * Input for `create()`. Combines upload fields with writable metadata.\n */\nexport type AssetCreate = AssetUploadRequest & NonNullable<UpdateAssetData['body']['asset']>;\n\n/** Uploads the file to S3 using the signed fields from step 1. */\nasync function uploadToS3(\n  signedResponse: SignedResponseObject,\n  file: Blob | ArrayBuffer,\n  filename: string,\n): Promise<void> {\n  if (!signedResponse.post_url || !signedResponse.fields) {\n    throw new ClientError('Invalid signed response: missing post_url or fields', {\n      status: 0,\n      statusText: 'Invalid signed response',\n      data: signedResponse,\n    });\n  }\n  const formData = new FormData();\n  for (const [key, value] of Object.entries(signedResponse.fields)) {\n    formData.append(key, value as string);\n  }\n  const contentType = (signedResponse.fields['Content-Type'] as string | undefined) ?? 'application/octet-stream';\n  const blob = file instanceof Blob ? file : new Blob([file], { type: contentType });\n  formData.append('file', new File([blob], filename, { type: contentType }));\n  const response = await fetch(signedResponse.post_url, { method: 'POST', body: formData });\n  if (!response.ok) {\n    throw new ClientError(`Failed to upload asset to S3: ${response.statusText}`, {\n      status: response.status,\n      statusText: response.statusText,\n      data: undefined,\n    });\n  }\n}\n\nconst hasDefinedFields = (value: Record<string, unknown> | undefined): boolean =>\n  Object.values(value ?? {}).some(v => v !== undefined && v !== null);\n\nexport function createAssetsResource<DefaultThrowOnError extends boolean = false>(deps: MapiResourceDeps<DefaultThrowOnError>) {\n  const { client, spaceId, wrapRequest } = deps;\n  const getSpaceId = (path?: SpaceIdPathOverride['path']) => resolveSpaceId(spaceId, path);\n\n  return {\n    list<ThrowOnError extends boolean = DefaultThrowOnError>(options: { query?: ListAssetsData['query']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<ListAssetsResult, ThrowOnError>> {\n      const { query, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      // `listAssets` returns `IndexAsset` rows; we present them as `Asset` (see `ListAssetsResult`).\n      return wrapRequest<ListAssetsResult, ThrowOnError>(() =>\n        mapi.listAssets({ client, path: { space_id: resolvedSpaceId }, query, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Step 1 of the upload flow: requests a signed S3 upload object from MAPI.\n     * Returns the S3 `post_url` and form `fields` needed for the actual upload.\n     *\n     * In most cases, prefer `upload()` or `create()` which handle all three\n     * steps automatically.\n     */\n    signResponseObject<ThrowOnError extends boolean = DefaultThrowOnError>(options: { query: CreateAssetData['query']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<CreateAssetResponses[200], ThrowOnError>> {\n      const { query, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<CreateAssetResponses[200], ThrowOnError>(() =>\n        mapi.createAsset({ client, path: { space_id: resolvedSpaceId }, query, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Uploads a file to Storyblok (sign → S3 upload → finish) and returns the\n     * resulting `Asset`.\n     */\n    async upload(options: { body: AssetUploadRequest; file: Blob | ArrayBuffer; signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<Asset> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const { short_filename, ...rest } = body;\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      const signResult = await wrapRequest<CreateAssetResponses[200], true>(() =>\n        mapi.createAsset({ client, path: { space_id: resolvedSpaceId }, query: { filename: short_filename, ...rest }, signal, throwOnError: true, ...kyOpts }), true);\n\n      if (!signResult.data.id) {\n        throw new Error('Invalid signed response: missing id');\n      }\n\n      await uploadToS3(signResult.data, file, short_filename);\n\n      await wrapRequest<FinishAssetUploadResponses[200], true>(() =>\n        mapi.finishAssetUpload({\n          client,\n          path: { space_id: resolvedSpaceId, id: Number(signResult.data.id) },\n          signal,\n          throwOnError: true,\n          ...kyOpts,\n        }), true);\n\n      const getResult = await wrapRequest<GetAssetResponses[200], true>(() =>\n        mapi.getAsset({ client, path: { space_id: resolvedSpaceId, id: Number(signResult.data.id) }, signal, throwOnError: true, ...kyOpts }), true);\n\n      return getResult.data;\n    },\n    /**\n     * Creates a new asset with metadata. Performs the full upload flow then\n     * applies any provided metadata in a follow-up update call.\n     */\n    async create(options: { body: AssetCreate; file: Blob | ArrayBuffer; signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<Asset> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      const { short_filename, asset_folder_id, is_private, size, validate_upload, ext_id, ...metadataOnly } = body;\n      const asset = await this.upload({\n        body: { short_filename, asset_folder_id, is_private, size, validate_upload, ext_id },\n        file,\n        signal,\n        path: { space_id: resolvedSpaceId },\n        fetchOptions,\n      });\n\n      const hasMetadata = Object.values(metadataOnly).some(v => v !== undefined && v !== null);\n      if (hasMetadata) {\n        await wrapRequest<UpdateAssetResponses[204], true>(() =>\n          mapi.updateAsset({\n            client,\n            path: { space_id: resolvedSpaceId, id: asset.id! },\n            body: { asset: metadataOnly },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n        const updatedResult = await wrapRequest<GetAssetResponses[200], true>(() =>\n          mapi.getAsset({ client, path: { space_id: resolvedSpaceId, id: asset.id! }, signal, throwOnError: true, ...kyOpts }), true);\n        return updatedResult.data;\n      }\n\n      return asset;\n    },\n    get<ThrowOnError extends boolean = DefaultThrowOnError>(assetId: number, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<GetAssetResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<GetAssetResponses[200], ThrowOnError>(() =>\n        mapi.getAsset({ client, path: { space_id: resolvedSpaceId, id: assetId }, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Updates an asset's metadata. When `file` and `body.short_filename` are\n     * provided, the file is replaced first (sign → S3 → finish), then metadata\n     * is updated.\n     */\n    async update(\n      assetId: number,\n      options: (\n        | { body: UpdateAssetData['body']; file?: undefined }\n        | { body: UpdateAssetData['body'] & { short_filename: string }; file: Blob | ArrayBuffer }\n      ) & { signal?: AbortSignal; fetchOptions?: FetchOptions } & SpaceIdPathOverride,\n    ): Promise<void> {\n      const { body, file, signal, path, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      const kyOpts = fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {};\n\n      if (file !== undefined) {\n        const { short_filename, ...assetBody } = body;\n        const signResult = await wrapRequest<CreateAssetResponses[200], true>(() =>\n          mapi.createAsset({\n            client,\n            path: { space_id: resolvedSpaceId },\n            query: { filename: short_filename },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n\n        if (!signResult.data.id) {\n          throw new Error('Invalid signed response: missing id');\n        }\n\n        await uploadToS3(signResult.data, file, short_filename);\n\n        await wrapRequest<FinishAssetUploadResponses[200], true>(() =>\n          mapi.finishAssetUpload({\n            client,\n            path: { space_id: resolvedSpaceId, id: Number(signResult.data.id) },\n            signal,\n            throwOnError: true,\n            ...kyOpts,\n          }), true);\n\n        if (hasDefinedFields(assetBody.asset)) {\n          await wrapRequest<UpdateAssetResponses[204], true>(() =>\n            mapi.updateAsset({ client, path: { space_id: resolvedSpaceId, id: assetId }, body: assetBody, signal, throwOnError: true, ...kyOpts }), true);\n        }\n      }\n      else {\n        await wrapRequest<UpdateAssetResponses[204], true>(() =>\n          mapi.updateAsset({ client, path: { space_id: resolvedSpaceId, id: assetId }, body, signal, throwOnError: true, ...kyOpts }), true);\n      }\n    },\n    delete<ThrowOnError extends boolean = DefaultThrowOnError>(assetId: number, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<DeleteAssetResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<DeleteAssetResponses[200], ThrowOnError>(() =>\n        mapi.deleteAsset({ client, path: { space_id: resolvedSpaceId, id: assetId }, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    finalize<ThrowOnError extends boolean = DefaultThrowOnError>(assetId: number, options: { signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride = {}): Promise<ApiResponse<FinishAssetUploadResponses[200], ThrowOnError>> {\n      const { signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<FinishAssetUploadResponses[200], ThrowOnError>(() =>\n        mapi.finishAssetUpload({\n          client,\n          path: { space_id: resolvedSpaceId, id: assetId },\n          signal,\n          ...(throwOnError === undefined ? {} : { throwOnError }),\n          ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}),\n        }), throwOnError);\n    },\n    /** POST /assets/bulk_destroy: hard-delete many assets in one call. */\n    deleteMany<ThrowOnError extends boolean = DefaultThrowOnError>(options: { body: BulkDestroyAssetsData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<BulkDestroyAssetsResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<BulkDestroyAssetsResponses[200], ThrowOnError>(() =>\n        mapi.bulkDestroyAssets({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /** POST /assets/bulk_update: move many assets between folders in one call. */\n    bulkMove<ThrowOnError extends boolean = DefaultThrowOnError>(options: { body: BulkUpdateAssetsData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<BulkUpdateAssetsResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<BulkUpdateAssetsResponses[200], ThrowOnError>(() =>\n        mapi.bulkUpdateAssets({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    bulkRestore<ThrowOnError extends boolean = DefaultThrowOnError>(options: { body: BulkRestoreAssetsData['body']; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride): Promise<ApiResponse<BulkRestoreAssetsResponses[200], ThrowOnError>> {\n      const { body, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<BulkRestoreAssetsResponses[200], ThrowOnError>(() =>\n        mapi.bulkRestoreAssets({ client, path: { space_id: resolvedSpaceId }, body, signal, ...(throwOnError === undefined ? {} : { throwOnError }), ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}) }), throwOnError);\n    },\n    /**\n     * Converts a space-local asset into a shared (org-level) asset.\n     *\n     * Wraps `POST /v1/spaces/{space_id}/assets/{asset_id}/convert`, which takes\n     * the destination folder as the required `target_asset_folder_id` query\n     * param and no request body. One-way only (space to org).\n     *\n     * Not part of the generated SDK, so this issues a raw `client.post`.\n     * The response is assumed to match `Asset`.\n     */\n    convertToShared<ThrowOnError extends boolean = false>(\n      assetId: number | string,\n      options: { query: { target_asset_folder_id: number }; signal?: AbortSignal; throwOnError?: ThrowOnError; fetchOptions?: FetchOptions } & SpaceIdPathOverride,\n    ): Promise<ApiResponse<Asset, ThrowOnError>> {\n      const { query, signal, path, throwOnError, fetchOptions } = options;\n      const resolvedSpaceId = getSpaceId(path);\n      return wrapRequest<Asset, ThrowOnError>(() =>\n        client.post({\n          url: '/v1/spaces/{space_id}/assets/{asset_id}/convert',\n          path: { space_id: resolvedSpaceId, asset_id: assetId },\n          query,\n          signal,\n          ...(throwOnError === undefined ? {} : { throwOnError }),\n          ...(fetchOptions ? { kyOptions: { ...client.getConfig().kyOptions, ...fetchOptions } } : {}),\n        }), throwOnError);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/resources/assets.d.cts

@@ -1,37 +1,32 @@
-import { AssetSignRequest, AssetUpdate, ListData } from "../generated/assets/types.gen.cjs";
+import { CreateAssetData, ListAssetsData, ListAssetsResponses, UpdateAssetData } from "../generated/mapi/types.gen.cjs";
+import { Asset } from "../generated/mapi/types-aliased.gen.cjs";
 
 //#region src/resources/assets.d.ts
-type AssetListQuery = NonNullable<ListData['query']>;
+type AssetListQuery = NonNullable<ListAssetsData['query']>;
 /**
- * Fields for initiating an asset upload. Pass this to `upload()`, `create()`,
- * or `update()` alongside a file buffer.
+ * Return shape of `list()`.
  *
- * Uses `short_filename` (e.g. `"hero.png"`) to clearly distinguish it from
- * `Asset.filename`, which is the full CDN URL assigned by Storyblok after upload.
- *
- * If you need to call the raw sign endpoint directly, use
- * `signResponseObject()` with `AssetSignRequest` instead.
+ * The list endpoint serializes rows with MAPI's `IndexAsset` serializer, which
+ * is NOT identical to the `ShowAsset` (= `Asset`) shape returned by `get()`:
+ * `IndexAsset` omits `file` and `permanently_deleted`. We deliberately surface
+ * list rows as `Asset` so consumers work against a single asset type. The lie:
+ * `file`/`permanently_deleted` are absent on list rows at runtime — consumers
+ * needing those must re-fetch via `get()`.
+ */
+type ListAssetsResult = Omit<ListAssetsResponses[200], 'assets'> & {
+  assets: Array<Asset>;
+};
+/**
+ * Fields for initiating an asset upload. Pass this to `upload()` or `create()`
+ * alongside a file buffer.
  */
-interface AssetUploadRequest {
-  /** The desired filename for the asset (e.g. `"hero.png"`). Corresponds to `Asset.short_filename`. */
-  short_filename: string;
-  /** When set, the upload replaces the file of an existing asset with this ID. */
-  id?: AssetSignRequest['id'];
-  /** Place the asset in this folder. */
-  asset_folder_id?: AssetSignRequest['asset_folder_id'];
-  /** Mark the asset as private (inaccessible without a signed URL). */
-  is_private?: AssetSignRequest['is_private'];
-  /** Image dimensions in `"<width>x<height>"` format (e.g. `"400x500"`). */
-  size?: AssetSignRequest['size'];
-  /** Set to `1` to enable server-side upload validation. */
-  validate_upload?: AssetSignRequest['validate_upload'];
-}
+type AssetUploadRequest = {
+  /** The desired filename for the asset (e.g. `"hero.png"`). */short_filename: string;
+} & Partial<Omit<NonNullable<CreateAssetData['query']>, 'filename'>>;
 /**
- * Input for `create()`. Combines upload fields (`short_filename`,
- * `asset_folder_id`, etc.) with writable metadata (`alt`, `title`,
- * `copyright`, etc.). The file buffer is passed separately.
+ * Input for `create()`. Combines upload fields with writable metadata.
  */
-type AssetCreate = AssetUpdate & AssetUploadRequest;
+type AssetCreate = AssetUploadRequest & NonNullable<UpdateAssetData['body']['asset']>;
 //#endregion
-export { AssetCreate, AssetListQuery, AssetUploadRequest };
+export { AssetCreate, AssetListQuery, AssetUploadRequest, ListAssetsResult };
 //# sourceMappingURL=assets.d.cts.map

package/dist/resources/assets.d.mts

@@ -1,36 +1,31 @@
-import { AssetSignRequest, AssetUpdate, ListData } from "../generated/assets/types.gen.mjs";
+import { CreateAssetData, ListAssetsData, ListAssetsResponses, UpdateAssetData } from "../generated/mapi/types.gen.mjs";
+import { Asset } from "../generated/mapi/types-aliased.gen.mjs";
 //#region src/resources/assets.d.ts
-type AssetListQuery = NonNullable<ListData['query']>;
+type AssetListQuery = NonNullable<ListAssetsData['query']>;
 /**
- * Fields for initiating an asset upload. Pass this to `upload()`, `create()`,
- * or `update()` alongside a file buffer.
+ * Return shape of `list()`.
  *
- * Uses `short_filename` (e.g. `"hero.png"`) to clearly distinguish it from
- * `Asset.filename`, which is the full CDN URL assigned by Storyblok after upload.
- *
- * If you need to call the raw sign endpoint directly, use
- * `signResponseObject()` with `AssetSignRequest` instead.
+ * The list endpoint serializes rows with MAPI's `IndexAsset` serializer, which
+ * is NOT identical to the `ShowAsset` (= `Asset`) shape returned by `get()`:
+ * `IndexAsset` omits `file` and `permanently_deleted`. We deliberately surface
+ * list rows as `Asset` so consumers work against a single asset type. The lie:
+ * `file`/`permanently_deleted` are absent on list rows at runtime — consumers
+ * needing those must re-fetch via `get()`.
+ */
+type ListAssetsResult = Omit<ListAssetsResponses[200], 'assets'> & {
+  assets: Array<Asset>;
+};
+/**
+ * Fields for initiating an asset upload. Pass this to `upload()` or `create()`
+ * alongside a file buffer.
  */
-interface AssetUploadRequest {
-  /** The desired filename for the asset (e.g. `"hero.png"`). Corresponds to `Asset.short_filename`. */
-  short_filename: string;
-  /** When set, the upload replaces the file of an existing asset with this ID. */
-  id?: AssetSignRequest['id'];
-  /** Place the asset in this folder. */
-  asset_folder_id?: AssetSignRequest['asset_folder_id'];
-  /** Mark the asset as private (inaccessible without a signed URL). */
-  is_private?: AssetSignRequest['is_private'];
-  /** Image dimensions in `"<width>x<height>"` format (e.g. `"400x500"`). */
-  size?: AssetSignRequest['size'];
-  /** Set to `1` to enable server-side upload validation. */
-  validate_upload?: AssetSignRequest['validate_upload'];
-}
+type AssetUploadRequest = {
+  /** The desired filename for the asset (e.g. `"hero.png"`). */short_filename: string;
+} & Partial<Omit<NonNullable<CreateAssetData['query']>, 'filename'>>;
 /**
- * Input for `create()`. Combines upload fields (`short_filename`,
- * `asset_folder_id`, etc.) with writable metadata (`alt`, `title`,
- * `copyright`, etc.). The file buffer is passed separately.
+ * Input for `create()`. Combines upload fields with writable metadata.
  */
-type AssetCreate = AssetUpdate & AssetUploadRequest;
+type AssetCreate = AssetUploadRequest & NonNullable<UpdateAssetData['body']['asset']>;
 //#endregion
-export { AssetCreate, AssetListQuery, AssetUploadRequest };
+export { AssetCreate, AssetListQuery, AssetUploadRequest, ListAssetsResult };
 //# sourceMappingURL=assets.d.mts.map