@html-css-to-image/client 0.3.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -67,6 +67,23 @@ if (result.success) {
67
67
  }
68
68
  ```
69
69
 
70
+ ### Delete Images
71
+
72
+ Delete one or more existing images from HCTI and clear them from the CDN using their image IDs.
73
+
74
+ ```typescript
75
+ const result = await client.deleteImage('your_image_id');
76
+
77
+ if (!result.success) {
78
+ console.error('Error:', result.error);
79
+ }
80
+
81
+ const batchResult = await client.deleteImageBatch([
82
+ 'first_image_id',
83
+ 'second_image_id'
84
+ ]);
85
+ ```
86
+
70
87
  ## Creating Image URLs
71
88
 
72
89
  For use cases where you want to generate a URL on the server and use it safely on the client (without exposing your API key), you can generate a signed URL.
@@ -1,7 +1,7 @@
1
1
  import type { IHtmlCssToImageClient } from "./IHtmlCssToImageClient.js";
2
2
  import { CreateTemplatedImageRequest } from "./types/request.js";
3
3
  import type { CreateHtmlCssImageRequest, CreateUrlImageRequest } from "./types/request.js";
4
- import type { CreateImageBatchResponse, CreateImageResponse } from "./types/response.js";
4
+ import type { CreateImageBatchResponse, CreateImageResponse, DeleteImageResponse } from "./types/response.js";
5
5
  export type FetchFunction = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
6
6
  export declare class HtmlCssToImageClient implements IHtmlCssToImageClient {
7
7
  private readonly apiId;
@@ -12,11 +12,14 @@ export declare class HtmlCssToImageClient implements IHtmlCssToImageClient {
12
12
  constructor(apiId: string, apiKey: string, customFetch?: FetchFunction);
13
13
  static fromEnv(): HtmlCssToImageClient;
14
14
  createImage(request: CreateHtmlCssImageRequest | CreateUrlImageRequest | CreateTemplatedImageRequest): Promise<CreateImageResponse>;
15
+ deleteImage(imageId: string): Promise<DeleteImageResponse>;
16
+ deleteImageBatch(imageIds: readonly string[]): Promise<DeleteImageResponse>;
15
17
  private mapToInternal;
16
18
  createImageBatch<T extends CreateHtmlCssImageRequest | CreateUrlImageRequest>(variations: T[], default_options?: T): Promise<CreateImageBatchResponse>;
17
19
  generateTemplatedImageUrl<T extends Record<string, any>>(templateIdOrRequest: string | CreateTemplatedImageRequest<T>, templateValues?: T, templateVersion?: number): string;
18
20
  generateCreateAndRenderUrl(request: CreateUrlImageRequest): string;
19
21
  private responseToType;
22
+ private responseToDeleteImageResponse;
20
23
  private mapHtmlCssToInternalRequest;
21
24
  private mapUrlToInternalRequest;
22
25
  private mapPDFOptionsToInternal;
@@ -38,6 +38,26 @@ export class HtmlCssToImageClient {
38
38
  });
39
39
  return await this.responseToType(response);
40
40
  }
41
+ async deleteImage(imageId) {
42
+ const response = await this.fetch(`${this.baseUrl}/v1/image/${encodeURIComponent(imageId)}`, {
43
+ method: 'DELETE',
44
+ headers: {
45
+ 'Authorization': this.authHeader,
46
+ },
47
+ });
48
+ return await this.responseToDeleteImageResponse(response);
49
+ }
50
+ async deleteImageBatch(imageIds) {
51
+ const response = await this.fetch(`${this.baseUrl}/v1/image/batch`, {
52
+ method: 'DELETE',
53
+ headers: {
54
+ 'Authorization': this.authHeader,
55
+ 'Content-Type': 'application/json',
56
+ },
57
+ body: JSON.stringify({ ids: imageIds }),
58
+ });
59
+ return await this.responseToDeleteImageResponse(response);
60
+ }
41
61
  mapToInternal(request, in_batch) {
42
62
  switch (request.__type) {
43
63
  case 'html_css':
@@ -114,7 +134,7 @@ export class HtmlCssToImageClient {
114
134
  .filter(([key, _]) => key !== 'url' && key != 'pdf_options' && key !== '__type')
115
135
  .sort((a, b) => a[0].localeCompare(b[0]))
116
136
  .forEach(([key, value]) => {
117
- if (value !== undefined && value !== null && value !== false) {
137
+ if (value !== undefined && value !== null && (value !== false || key === 'transparent_background')) {
118
138
  params.append(key, value.toString());
119
139
  }
120
140
  });
@@ -141,6 +161,12 @@ export class HtmlCssToImageClient {
141
161
  return { success: false, ...response_json };
142
162
  }
143
163
  }
164
+ async responseToDeleteImageResponse(response) {
165
+ if (response.ok) {
166
+ return { success: true };
167
+ }
168
+ return await this.responseToType(response);
169
+ }
144
170
  mapHtmlCssToInternalRequest(request, in_batch) {
145
171
  const { pdf_options, google_fonts, __type, ...shared_request } = request;
146
172
  let new_request;
@@ -1,8 +1,10 @@
1
1
  import type { CreateHtmlCssImageRequest, CreateTemplatedImageRequest, CreateUrlImageRequest } from "./types/request.js";
2
- import type { CreateImageBatchResponse, CreateImageResponse } from "./types/response.js";
2
+ import type { CreateImageBatchResponse, CreateImageResponse, DeleteImageResponse } from "./types/response.js";
3
3
  export interface IHtmlCssToImageClient {
4
4
  createImage(request: CreateHtmlCssImageRequest | CreateUrlImageRequest | CreateTemplatedImageRequest): Promise<CreateImageResponse>;
5
5
  createImageBatch<T extends CreateHtmlCssImageRequest | CreateUrlImageRequest>(variations: T[], default_options?: T): Promise<CreateImageBatchResponse>;
6
+ deleteImage(imageId: string): Promise<DeleteImageResponse>;
7
+ deleteImageBatch(imageIds: readonly string[]): Promise<DeleteImageResponse>;
6
8
  generateCreateAndRenderUrl(request: CreateUrlImageRequest): string;
7
9
  generateTemplatedImageUrl<T extends Record<string, any>>(template_id: string, template_values: T, template_version?: number): string;
8
10
  generateTemplatedImageUrl(request: CreateTemplatedImageRequest): string;
package/dist/index.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  export { BaseCreateImageRequest, CreateHtmlCssImageRequest, CreateTemplatedImageRequest, CreateUrlImageRequest, PDFOptions } from './types/request.js';
2
2
  export type { ColorSchemeType, MediaType, PdfMargins, PdfValueInput, PdfValueWithUnits, PdfUnit } from './types/request.js';
3
- export type { CreateImageBatchResponse, CreateImageBatchSuccessResponse, CreateImageErrorResponse, CreateImageResponse, CreateImageSuccessResponse, ValidationError } from './types/response.js';
3
+ export type { CreateImageBatchResponse, CreateImageBatchSuccessResponse, CreateImageErrorResponse, CreateImageResponse, CreateImageSuccessResponse, DeleteImageResponse, DeleteImageSuccessResponse, ValidationError } from './types/response.js';
4
4
  export { HtmlCssToImageClient } from './HtmlCssToImageClient.js';
5
5
  export type { FetchFunction } from './HtmlCssToImageClient.js';
6
6
  export type { IHtmlCssToImageClient } from './IHtmlCssToImageClient.js';
@@ -118,6 +118,10 @@ export declare abstract class BaseCreateImageRequest {
118
118
  * Set the maximum height in jumbo mode. jumbo_max_width must also be defined.
119
119
  */
120
120
  jumbo_max_height?: number;
121
+ /**
122
+ * Render the image with a transparent background.
123
+ */
124
+ transparent_background?: boolean;
121
125
  /**
122
126
  * Options for generating a PDF from the HTML/CSS or Url.
123
127
  */
@@ -99,6 +99,10 @@ export class BaseCreateImageRequest {
99
99
  * Set the maximum height in jumbo mode. jumbo_max_width must also be defined.
100
100
  */
101
101
  jumbo_max_height;
102
+ /**
103
+ * Render the image with a transparent background.
104
+ */
105
+ transparent_background;
102
106
  /**
103
107
  * Options for generating a PDF from the HTML/CSS or Url.
104
108
  */
@@ -17,5 +17,9 @@ export interface CreateImageBatchSuccessResponse {
17
17
  success: true;
18
18
  images: CreateImageSuccessResponse[];
19
19
  }
20
+ export interface DeleteImageSuccessResponse {
21
+ success: true;
22
+ }
20
23
  export type CreateImageBatchResponse = CreateImageBatchSuccessResponse | CreateImageErrorResponse;
21
24
  export type CreateImageResponse = CreateImageSuccessResponse | CreateImageErrorResponse;
25
+ export type DeleteImageResponse = DeleteImageSuccessResponse | CreateImageErrorResponse;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@html-css-to-image/client",
3
- "version": "0.3.0",
3
+ "version": "0.5.0",
4
4
  "type": "module",
5
5
  "description": "Lightweight TypeScript client for the HTML/CSS to Image API. Generate images from HTML/CSS, URLs, or templates in your TypeScript or JavaScript projects.",
6
6
  "main": "dist/index.js",