@things-factory/integration-headless 8.0.39 → 9.0.0-9.0.0-beta.59.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.
Files changed (35) hide show
  1. package/dist-server/engine/index.d.ts +0 -1
  2. package/dist-server/engine/index.js +0 -1
  3. package/dist-server/engine/index.js.map +1 -1
  4. package/dist-server/engine/task/pdf-capture-util.d.ts +1 -1
  5. package/dist-server/engine/task/pdf-capture-util.js +3 -3
  6. package/dist-server/engine/task/pdf-capture-util.js.map +1 -1
  7. package/dist-server/tsconfig.tsbuildinfo +1 -1
  8. package/helps/integration/connector/headless-connector.ja.md +183 -31
  9. package/helps/integration/connector/headless-connector.ko.md +177 -32
  10. package/helps/integration/connector/headless-connector.md +178 -31
  11. package/helps/integration/connector/headless-connector.ms.md +180 -32
  12. package/helps/integration/connector/headless-connector.zh.md +178 -31
  13. package/package.json +6 -6
  14. package/dist-server/engine/connector/headless-connector.d.ts +0 -14
  15. package/dist-server/engine/connector/headless-connector.js +0 -54
  16. package/dist-server/engine/connector/headless-connector.js.map +0 -1
  17. package/dist-server/engine/connector/headless-pool.d.ts +0 -3
  18. package/dist-server/engine/connector/headless-pool.js +0 -63
  19. package/dist-server/engine/connector/headless-pool.js.map +0 -1
  20. package/dist-server/engine/connector/index.d.ts +0 -1
  21. package/dist-server/engine/connector/index.js +0 -4
  22. package/dist-server/engine/connector/index.js.map +0 -1
  23. package/server/engine/connector/headless-connector.ts +0 -68
  24. package/server/engine/connector/headless-pool.ts +0 -69
  25. package/server/engine/connector/index.ts +0 -1
  26. package/server/engine/index.ts +0 -2
  27. package/server/engine/task/headless-pdf-capture-board.ts +0 -182
  28. package/server/engine/task/headless-pdf-capture-markdown.ts +0 -47
  29. package/server/engine/task/headless-pdf-capture.ts +0 -39
  30. package/server/engine/task/headless-pdf-open.ts +0 -98
  31. package/server/engine/task/headless-pdf-save.ts +0 -88
  32. package/server/engine/task/index.ts +0 -9
  33. package/server/engine/task/pdf-capture-util.ts +0 -331
  34. package/server/index.ts +0 -3
  35. package/server/tsconfig.json +0 -10
@@ -1,331 +0,0 @@
1
- import * as ejs from 'ejs'
2
- import { ConnectionManager } from '@things-factory/integration-base'
3
- import { PDFDocument } from 'pdf-lib'
4
- import { Browser, Page } from 'puppeteer'
5
- import { Logger } from 'winston'
6
-
7
- interface StepOptions {
8
- format?: string
9
- width?: string
10
- height?: string
11
- marginTop?: string
12
- marginBottom?: string
13
- marginLeft?: string
14
- marginRight?: string
15
- scale?: number
16
- printBackground?: boolean
17
- landscape?: boolean
18
- preferCSSPageSize?: boolean
19
- }
20
-
21
- interface PDFContext {
22
- domain: any
23
- data: any
24
- logger: Logger
25
- __headless_pdf: any
26
- }
27
-
28
- export class PDFCaptureUtil {
29
- private context: PDFContext
30
- private headlessPool: any
31
-
32
- public browser: Browser | null = null
33
-
34
- constructor(context: PDFContext) {
35
- this.context = context
36
- }
37
-
38
- async initBrowser(connectionName: string) {
39
- const { domain } = this.context
40
- this.headlessPool = ConnectionManager.getConnectionInstanceByName(domain, connectionName)
41
- this.browser = await this.headlessPool.acquire()
42
- }
43
-
44
- async closeBrowser() {
45
- if (this.browser) {
46
- await this.browser.close()
47
- this.headlessPool.release(this.browser)
48
- }
49
- }
50
-
51
- renderTemplate(template: string, data: any): string {
52
- const { logger } = this.context
53
- try {
54
- return ejs.render(template, data)
55
- } catch (error) {
56
- logger.warn(`Template rendering error: ${error.message}`)
57
- return template
58
- }
59
- }
60
-
61
- async generatePDFContent(page: Page, pageOptions: any): Promise<PDFDocument> {
62
- const contentBuffer = await page.pdf(pageOptions)
63
- const contentPdfDoc = await PDFDocument.load(contentBuffer)
64
- return contentPdfDoc
65
- }
66
-
67
- async appendPDFContentToDocument(pdfDoc: PDFDocument, contentPdfDoc: PDFDocument) {
68
- const copiedPages = await pdfDoc.copyPages(contentPdfDoc, contentPdfDoc.getPageIndices())
69
- copiedPages.forEach(page => pdfDoc.addPage(page))
70
- this.context.__headless_pdf.pageCount += copiedPages.length
71
- }
72
-
73
- async processPageAndGeneratePDF(stepOptions: StepOptions, htmlContent: string, page?: Page) {
74
- if (!this.browser) throw new Error('Browser not initialized. Call initBrowser() first.')
75
-
76
- if (!page) {
77
- page = page || (await this.browser.newPage())
78
- }
79
-
80
- if (htmlContent) {
81
- // 페이지 컨텐츠 설정
82
- await page.setContent(htmlContent, { waitUntil: 'networkidle0' }) // HTML 컨텐츠가 완전히 로드될 때까지 대기
83
- }
84
-
85
- // 페이지가 완전히 로드된 후에 워터마크와 머릿글 적용
86
- const { __headless_pdf } = this.context
87
- const { header, footer, watermark, landscape } = __headless_pdf
88
-
89
- if (header || footer || watermark) {
90
- await this.applyHeaderFooterWatermark(page, { header, footer, watermark, landscape, data: __headless_pdf })
91
- }
92
-
93
- const pageOptions = this.buildPageOptions(stepOptions)
94
- const contentPdfDoc = await this.generatePDFContent(page, pageOptions)
95
- await this.appendPDFContentToDocument(__headless_pdf.pdfDoc, contentPdfDoc)
96
- await page.close()
97
- }
98
-
99
- buildPageOptions({
100
- format,
101
- width,
102
- height,
103
- marginTop,
104
- marginBottom,
105
- marginLeft,
106
- marginRight,
107
- scale,
108
- printBackground,
109
- landscape,
110
- preferCSSPageSize
111
- }: StepOptions): any {
112
- if (preferCSSPageSize) {
113
- width = undefined
114
- height = undefined
115
- }
116
-
117
- return {
118
- format,
119
- width,
120
- height,
121
- margin: {
122
- top: marginTop,
123
- right: marginRight,
124
- bottom: marginBottom,
125
- left: marginLeft
126
- },
127
- scale,
128
- printBackground,
129
- landscape,
130
- displayHeaderFooter: false,
131
- preferCSSPageSize
132
- }
133
- }
134
-
135
- async applyHeaderFooterWatermark(
136
- page: Page,
137
- {
138
- header,
139
- footer,
140
- watermark,
141
- landscape,
142
- data
143
- }: { header: string; footer: string; watermark: string; landscape: boolean; data: any }
144
- ) {
145
- await page.evaluate(
146
- ({ header, footer, watermark, landscape, data }) => {
147
- const setPositioning = (element: HTMLElement, position: 'header' | 'footer') => {
148
- element.style.position = 'fixed'
149
- element.style.left = '0'
150
- element.style.width = '100%'
151
- element.style.textAlign = 'center'
152
- element.style.fontSize = '12px'
153
- element.style.margin = '0'
154
- element.style.padding = '0'
155
- element.style.zIndex = '1000'
156
-
157
- if (position === 'header') {
158
- element.style.top = '0'
159
- } else if (position === 'footer') {
160
- element.style.bottom = '0'
161
- }
162
- }
163
-
164
- if (header) {
165
- const headerElement = document.createElement('div')
166
- headerElement.innerHTML = header
167
- setPositioning(headerElement, 'header')
168
- document.body.appendChild(headerElement)
169
- }
170
-
171
- if (footer) {
172
- const footerElement = document.createElement('div')
173
- footerElement.innerHTML = footer
174
- setPositioning(footerElement, 'footer')
175
- document.body.appendChild(footerElement)
176
- }
177
-
178
- if (watermark) {
179
- const watermarkElement = document.createElement('div')
180
- watermarkElement.innerHTML = watermark
181
- watermarkElement.style.position = 'fixed'
182
- watermarkElement.style.top = landscape ? '40%' : '50%'
183
- watermarkElement.style.left = '50%'
184
- watermarkElement.style.transform = 'translate(-50%, -50%) rotate(-45deg)'
185
- watermarkElement.style.opacity = '0.2'
186
- watermarkElement.style.fontSize = '50px'
187
- watermarkElement.style.color = 'red'
188
- watermarkElement.style.pointerEvents = 'none'
189
- watermarkElement.style.zIndex = '9999'
190
- document.body.appendChild(watermarkElement)
191
- }
192
- },
193
- {
194
- header: header && this.renderTemplate(header, data),
195
- footer: footer && this.renderTemplate(footer, data),
196
- watermark: watermark && this.renderTemplate(watermark, data),
197
- landscape,
198
- data
199
- }
200
- )
201
- }
202
-
203
- /**
204
- * Generates a PDF buffer for the last page.
205
- * @param stepOptions - Options used for generating the PDF.
206
- * @param htmlContent - HTML content to be converted to PDF.
207
- * @returns {Promise<Uint8Array>} - The generated PDF as a buffer.
208
- */
209
- async generateLastPageBuffer(stepOptions: StepOptions, htmlContent: string): Promise<Uint8Array> {
210
- if (!this.browser) throw new Error('Browser not initialized. Call initBrowser() first.')
211
-
212
- const page = await this.browser.newPage()
213
-
214
- // 페이지에 HTML 콘텐츠를 설정합니다.
215
- await page.setContent(htmlContent, { waitUntil: 'networkidle0' })
216
-
217
- // 페이지가 완전히 로드된 후에 워터마크와 머릿글 적용
218
- const { __headless_pdf } = this.context
219
- const { header, footer, watermark, landscape } = __headless_pdf
220
-
221
- if (header || footer || watermark) {
222
- await this.applyHeaderFooterWatermark(page, { header, footer, watermark, landscape, data: __headless_pdf })
223
- }
224
-
225
- // 페이지 옵션 설정
226
- const pageOptions = this.buildPageOptions(stepOptions)
227
-
228
- // PDF를 생성하고 버퍼를 반환합니다.
229
- const lastPageBuffer = await page.pdf(pageOptions)
230
-
231
- // 페이지 닫기
232
- await page.close()
233
-
234
- return lastPageBuffer
235
- }
236
- }
237
-
238
- export function getCommonParameterSpec() {
239
- return [
240
- {
241
- type: 'scenario-step-input',
242
- name: 'accessor',
243
- label: 'accessor'
244
- },
245
- {
246
- type: 'select',
247
- name: 'format',
248
- label: 'page-format',
249
- property: {
250
- options: [
251
- { display: '', value: '' },
252
- { display: 'A4', value: 'A4' },
253
- { display: 'A3', value: 'A3' },
254
- { display: 'Letter', value: 'Letter' },
255
- { display: 'Legal', value: 'Legal' }
256
- ]
257
- },
258
- description: 'Select the paper format for the PDF'
259
- },
260
- {
261
- type: 'string',
262
- name: 'width',
263
- label: 'page-width',
264
- placeholder: '(e.g., "8.5in", "21cm", "600px")',
265
- description: 'Specify the width of the page (e.g., "8.5in", "21cm", "600px")'
266
- },
267
- {
268
- type: 'string',
269
- name: 'height',
270
- label: 'page-height',
271
- placeholder: '(e.g., "11in", "29.7cm", "800px")',
272
- description: 'Specify the height of the page (e.g., "11in", "29.7cm", "800px")'
273
- },
274
- {
275
- type: 'string',
276
- name: 'marginTop',
277
- label: 'page-margin-top',
278
- placeholder: '(e.g., "0.5in", "1cm", "100px")',
279
- description: 'Set the top margin for the page'
280
- },
281
- {
282
- type: 'string',
283
- name: 'marginBottom',
284
- label: 'page-margin-bottom',
285
- placeholder: '(e.g., "0.5in", "1cm", "100px")',
286
- description: 'Set the bottom margin for the page'
287
- },
288
- {
289
- type: 'string',
290
- name: 'marginLeft',
291
- label: 'page-margin-left',
292
- placeholder: '(e.g., "0.5in", "1cm", "100px")',
293
- description: 'Set the left margin for the page'
294
- },
295
- {
296
- type: 'string',
297
- name: 'marginRight',
298
- label: 'page-margin-right',
299
- placeholder: '(e.g., "0.5in", "1cm", "100px")',
300
- description: 'Set the right margin for the page'
301
- },
302
- {
303
- type: 'number',
304
- name: 'scale',
305
- label: 'page-scale',
306
- defaultValue: 1,
307
- description: 'Set the scale of the page content (default is 1)'
308
- },
309
- {
310
- type: 'boolean',
311
- name: 'printBackground',
312
- label: 'print-background',
313
- defaultValue: true,
314
- description: 'Include background graphics when printing the page'
315
- },
316
- {
317
- type: 'boolean',
318
- name: 'landscape',
319
- label: 'landscape',
320
- defaultValue: false,
321
- description: 'Print the PDF in landscape orientation'
322
- },
323
- {
324
- type: 'boolean',
325
- name: 'preferCSSPageSize',
326
- label: 'prefer-css-page-size',
327
- defaultValue: false,
328
- description: 'Whether to prefer the CSS-defined page size over the given width and height'
329
- }
330
- ]
331
- }
package/server/index.ts DELETED
@@ -1,3 +0,0 @@
1
- import './engine'
2
-
3
- export * from './engine/task'
@@ -1,10 +0,0 @@
1
- {
2
- "extends": "../../tsconfig-base.json",
3
- "compilerOptions": {
4
- "strict": false,
5
- "module": "commonjs",
6
- "outDir": "../dist-server",
7
- "baseUrl": "./"
8
- },
9
- "include": ["./**/*"]
10
- }