@pdfme/common 0.0.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 (108) hide show
  1. package/README.md +5 -0
  2. package/dist/cjs/__tests__/dynamicTemplate.test.js +275 -0
  3. package/dist/cjs/__tests__/dynamicTemplate.test.js.map +1 -0
  4. package/dist/cjs/__tests__/expression.test.js +474 -0
  5. package/dist/cjs/__tests__/expression.test.js.map +1 -0
  6. package/dist/cjs/__tests__/helper.test.js +647 -0
  7. package/dist/cjs/__tests__/helper.test.js.map +1 -0
  8. package/dist/cjs/__tests__/pluginRegistry.test.js +83 -0
  9. package/dist/cjs/__tests__/pluginRegistry.test.js.map +1 -0
  10. package/dist/cjs/src/constants.js +27 -0
  11. package/dist/cjs/src/constants.js.map +1 -0
  12. package/dist/cjs/src/dynamicTemplate.js +284 -0
  13. package/dist/cjs/src/dynamicTemplate.js.map +1 -0
  14. package/dist/cjs/src/expression.js +463 -0
  15. package/dist/cjs/src/expression.js.map +1 -0
  16. package/dist/cjs/src/helper.js +217 -0
  17. package/dist/cjs/src/helper.js.map +1 -0
  18. package/dist/cjs/src/index.js +42 -0
  19. package/dist/cjs/src/index.js.map +1 -0
  20. package/dist/cjs/src/pluginRegistry.js +33 -0
  21. package/dist/cjs/src/pluginRegistry.js.map +1 -0
  22. package/dist/cjs/src/schema.js +190 -0
  23. package/dist/cjs/src/schema.js.map +1 -0
  24. package/dist/cjs/src/types.js +3 -0
  25. package/dist/cjs/src/types.js.map +1 -0
  26. package/dist/cjs/src/version.js +5 -0
  27. package/dist/cjs/src/version.js.map +1 -0
  28. package/dist/esm/__tests__/dynamicTemplate.test.js +240 -0
  29. package/dist/esm/__tests__/dynamicTemplate.test.js.map +1 -0
  30. package/dist/esm/__tests__/expression.test.js +472 -0
  31. package/dist/esm/__tests__/expression.test.js.map +1 -0
  32. package/dist/esm/__tests__/helper.test.js +612 -0
  33. package/dist/esm/__tests__/helper.test.js.map +1 -0
  34. package/dist/esm/__tests__/pluginRegistry.test.js +81 -0
  35. package/dist/esm/__tests__/pluginRegistry.test.js.map +1 -0
  36. package/dist/esm/src/constants.js +24 -0
  37. package/dist/esm/src/constants.js.map +1 -0
  38. package/dist/esm/src/dynamicTemplate.js +280 -0
  39. package/dist/esm/src/dynamicTemplate.js.map +1 -0
  40. package/dist/esm/src/expression.js +426 -0
  41. package/dist/esm/src/expression.js.map +1 -0
  42. package/dist/esm/src/helper.js +193 -0
  43. package/dist/esm/src/helper.js.map +1 -0
  44. package/dist/esm/src/index.js +8 -0
  45. package/dist/esm/src/index.js.map +1 -0
  46. package/dist/esm/src/pluginRegistry.js +29 -0
  47. package/dist/esm/src/pluginRegistry.js.map +1 -0
  48. package/dist/esm/src/schema.js +187 -0
  49. package/dist/esm/src/schema.js.map +1 -0
  50. package/dist/esm/src/types.js +2 -0
  51. package/dist/esm/src/types.js.map +1 -0
  52. package/dist/esm/src/version.js +2 -0
  53. package/dist/esm/src/version.js.map +1 -0
  54. package/dist/node/__tests__/dynamicTemplate.test.js +275 -0
  55. package/dist/node/__tests__/dynamicTemplate.test.js.map +1 -0
  56. package/dist/node/__tests__/expression.test.js +474 -0
  57. package/dist/node/__tests__/expression.test.js.map +1 -0
  58. package/dist/node/__tests__/helper.test.js +647 -0
  59. package/dist/node/__tests__/helper.test.js.map +1 -0
  60. package/dist/node/__tests__/pluginRegistry.test.js +83 -0
  61. package/dist/node/__tests__/pluginRegistry.test.js.map +1 -0
  62. package/dist/node/src/constants.js +27 -0
  63. package/dist/node/src/constants.js.map +1 -0
  64. package/dist/node/src/dynamicTemplate.js +284 -0
  65. package/dist/node/src/dynamicTemplate.js.map +1 -0
  66. package/dist/node/src/expression.js +463 -0
  67. package/dist/node/src/expression.js.map +1 -0
  68. package/dist/node/src/helper.js +217 -0
  69. package/dist/node/src/helper.js.map +1 -0
  70. package/dist/node/src/index.js +42 -0
  71. package/dist/node/src/index.js.map +1 -0
  72. package/dist/node/src/pluginRegistry.js +33 -0
  73. package/dist/node/src/pluginRegistry.js.map +1 -0
  74. package/dist/node/src/schema.js +190 -0
  75. package/dist/node/src/schema.js.map +1 -0
  76. package/dist/node/src/types.js +3 -0
  77. package/dist/node/src/types.js.map +1 -0
  78. package/dist/node/src/version.js +5 -0
  79. package/dist/node/src/version.js.map +1 -0
  80. package/dist/types/__tests__/dynamicTemplate.test.d.ts +1 -0
  81. package/dist/types/__tests__/expression.test.d.ts +1 -0
  82. package/dist/types/__tests__/helper.test.d.ts +1 -0
  83. package/dist/types/__tests__/pluginRegistry.test.d.ts +1 -0
  84. package/dist/types/src/constants.d.ts +20 -0
  85. package/dist/types/src/dynamicTemplate.d.ts +15 -0
  86. package/dist/types/src/expression.d.ts +6 -0
  87. package/dist/types/src/helper.d.ts +35 -0
  88. package/dist/types/src/index.d.ts +9 -0
  89. package/dist/types/src/pluginRegistry.d.ts +5 -0
  90. package/dist/types/src/schema.d.ts +820 -0
  91. package/dist/types/src/types.d.ts +181 -0
  92. package/dist/types/src/version.d.ts +1 -0
  93. package/eslint.config.mjs +22 -0
  94. package/package.json +84 -0
  95. package/set-version.js +31 -0
  96. package/src/constants.ts +30 -0
  97. package/src/dynamicTemplate.ts +349 -0
  98. package/src/expression.ts +460 -0
  99. package/src/helper.ts +284 -0
  100. package/src/index.ts +136 -0
  101. package/src/pluginRegistry.ts +30 -0
  102. package/src/schema.ts +223 -0
  103. package/src/types.ts +198 -0
  104. package/src/version.ts +1 -0
  105. package/tsconfig.cjs.json +10 -0
  106. package/tsconfig.esm.json +11 -0
  107. package/tsconfig.json +6 -0
  108. package/tsconfig.node.json +11 -0
@@ -0,0 +1,460 @@
1
+ import * as acorn from 'acorn';
2
+ import type { Node as AcornNode, Identifier, Property } from 'estree';
3
+ import type { SchemaPageArray } from './types.js';
4
+
5
+ const expressionCache = new Map<string, (context: Record<string, unknown>) => unknown>();
6
+ const parseDataCache = new Map<string, Record<string, unknown>>();
7
+
8
+ const parseData = (data: Record<string, unknown>): Record<string, unknown> => {
9
+ const key = JSON.stringify(data);
10
+ if (parseDataCache.has(key)) {
11
+ return parseDataCache.get(key)!;
12
+ }
13
+
14
+ const parsed = Object.fromEntries(
15
+ Object.entries(data).map(([key, value]) => {
16
+ if (typeof value === 'string') {
17
+ try {
18
+ const parsedValue = JSON.parse(value) as unknown;
19
+ return [key, parsedValue];
20
+ } catch {
21
+ return [key, value];
22
+ }
23
+ }
24
+ return [key, value];
25
+ }),
26
+ );
27
+
28
+ parseDataCache.set(key, parsed);
29
+ return parsed;
30
+ };
31
+
32
+ const padZero = (num: number): string => String(num).padStart(2, '0');
33
+
34
+ const formatDate = (date: Date): string =>
35
+ `${date.getFullYear()}/${padZero(date.getMonth() + 1)}/${padZero(date.getDate())}`;
36
+
37
+ const formatDateTime = (date: Date): string =>
38
+ `${formatDate(date)} ${padZero(date.getHours())}:${padZero(date.getMinutes())}`;
39
+
40
+ // Safe assign function that prevents prototype pollution
41
+ const safeAssign = (
42
+ target: Record<string, unknown>,
43
+ ...sources: Array<Record<string, unknown> | null | undefined>
44
+ ): Record<string, unknown> => {
45
+ if (target == null) {
46
+ throw new TypeError('Cannot convert undefined or null to object');
47
+ }
48
+
49
+ const to = { ...target };
50
+
51
+ for (const source of sources) {
52
+ if (source != null) {
53
+ for (const key in source) {
54
+ // Skip prototype pollution keys
55
+ if (key === '__proto__' || key === 'constructor' || key === 'prototype') {
56
+ continue;
57
+ }
58
+ // Only copy own properties
59
+ if (Object.prototype.hasOwnProperty.call(source, key)) {
60
+ to[key] = source[key];
61
+ }
62
+ }
63
+ }
64
+ }
65
+
66
+ return to;
67
+ };
68
+
69
+ // Create a safe copy of Object with dangerous methods excluded
70
+ const safeObject = {
71
+ keys: Object.keys,
72
+ values: Object.values,
73
+ entries: Object.entries,
74
+ fromEntries: Object.fromEntries,
75
+ is: Object.is,
76
+ hasOwnProperty: Object.hasOwnProperty,
77
+ assign: safeAssign, // Safe version of Object.assign
78
+ // The following methods are excluded due to security concerns:
79
+ // - Side effects: create, freeze, seal (can still be used for attacks)
80
+ // - Prototype access: getOwnPropertyDescriptor, getPrototypeOf, setPrototypeOf,
81
+ // defineProperty, defineProperties, getOwnPropertyNames, getOwnPropertySymbols
82
+ };
83
+
84
+ const allowedGlobals: Record<string, unknown> = {
85
+ Math,
86
+ String,
87
+ Number,
88
+ Boolean,
89
+ Array,
90
+ Object: safeObject,
91
+ Date,
92
+ JSON,
93
+ isNaN,
94
+ parseFloat,
95
+ parseInt,
96
+ decodeURI,
97
+ decodeURIComponent,
98
+ encodeURI,
99
+ encodeURIComponent,
100
+ };
101
+
102
+ const validateAST = (node: AcornNode): void => {
103
+ switch (node.type) {
104
+ case 'Literal':
105
+ case 'Identifier':
106
+ break;
107
+ case 'BinaryExpression':
108
+ case 'LogicalExpression': {
109
+ const binaryNode = node;
110
+ validateAST(binaryNode.left);
111
+ validateAST(binaryNode.right);
112
+ break;
113
+ }
114
+ case 'UnaryExpression': {
115
+ const unaryNode = node;
116
+ validateAST(unaryNode.argument);
117
+ break;
118
+ }
119
+ case 'ConditionalExpression': {
120
+ const condNode = node;
121
+ validateAST(condNode.test);
122
+ validateAST(condNode.consequent);
123
+ validateAST(condNode.alternate);
124
+ break;
125
+ }
126
+ case 'MemberExpression': {
127
+ const memberNode = node;
128
+ validateAST(memberNode.object);
129
+ if (memberNode.computed) {
130
+ validateAST(memberNode.property);
131
+ } else {
132
+ const propName = (memberNode.property as Identifier).name;
133
+ if (['constructor', '__proto__', 'prototype'].includes(propName)) {
134
+ throw new Error('Access to prohibited property');
135
+ }
136
+ // Block prototype pollution methods
137
+ if (['__defineGetter__', '__defineSetter__', '__lookupGetter__', '__lookupSetter__'].includes(propName)) {
138
+ throw new Error(`Access to prohibited method: ${propName}`);
139
+ }
140
+ const prohibitedMethods = ['toLocaleString', 'valueOf'];
141
+ if (typeof propName === 'string' && prohibitedMethods.includes(propName)) {
142
+ throw new Error(`Access to prohibited method: ${propName}`);
143
+ }
144
+ }
145
+ break;
146
+ }
147
+ case 'CallExpression': {
148
+ const callNode = node;
149
+ validateAST(callNode.callee);
150
+ callNode.arguments.forEach(validateAST);
151
+ break;
152
+ }
153
+ case 'ArrayExpression': {
154
+ const arrayNode = node;
155
+ arrayNode.elements.forEach((elem) => {
156
+ if (elem) validateAST(elem);
157
+ });
158
+ break;
159
+ }
160
+ case 'ObjectExpression': {
161
+ const objectNode = node;
162
+ objectNode.properties.forEach((prop) => {
163
+ const propNode = prop as Property;
164
+ validateAST(propNode.key);
165
+ validateAST(propNode.value);
166
+ });
167
+ break;
168
+ }
169
+ case 'ArrowFunctionExpression': {
170
+ const arrowFuncNode = node;
171
+ arrowFuncNode.params.forEach((param) => {
172
+ if (param.type !== 'Identifier') {
173
+ throw new Error('Only identifier parameters are supported in arrow functions');
174
+ }
175
+ validateAST(param);
176
+ });
177
+ validateAST(arrowFuncNode.body);
178
+ break;
179
+ }
180
+ default:
181
+ throw new Error(`Unsupported syntax in placeholder: ${node.type}`);
182
+ }
183
+ };
184
+
185
+ const evaluateAST = (node: AcornNode, context: Record<string, unknown>): unknown => {
186
+ switch (node.type) {
187
+ case 'Literal': {
188
+ const literalNode = node;
189
+ return literalNode.value;
190
+ }
191
+ case 'Identifier': {
192
+ const idNode = node;
193
+ if (Object.prototype.hasOwnProperty.call(context, idNode.name)) {
194
+ return context[idNode.name];
195
+ } else if (Object.prototype.hasOwnProperty.call(allowedGlobals, idNode.name)) {
196
+ return allowedGlobals[idNode.name];
197
+ } else {
198
+ throw new Error(`Undefined variable: ${idNode.name}`);
199
+ }
200
+ }
201
+ case 'BinaryExpression': {
202
+ const binaryNode = node;
203
+ const left = evaluateAST(binaryNode.left, context) as number;
204
+ const right = evaluateAST(binaryNode.right, context) as number;
205
+ switch (binaryNode.operator) {
206
+ case '+':
207
+ return left + right;
208
+ case '-':
209
+ return left - right;
210
+ case '*':
211
+ return left * right;
212
+ case '/':
213
+ return left / right;
214
+ case '%':
215
+ return left % right;
216
+ case '**':
217
+ return left ** right;
218
+ case '==':
219
+ return left == right;
220
+ case '!=':
221
+ return left != right;
222
+ case '===':
223
+ return left === right;
224
+ case '!==':
225
+ return left !== right;
226
+ case '<':
227
+ return left < right;
228
+ case '>':
229
+ return left > right;
230
+ case '<=':
231
+ return left <= right;
232
+ case '>=':
233
+ return left >= right;
234
+ default:
235
+ throw new Error(`Unsupported operator: ${binaryNode.operator}`);
236
+ }
237
+ }
238
+ case 'LogicalExpression': {
239
+ const logicalNode = node;
240
+ const leftLogical = evaluateAST(logicalNode.left, context);
241
+ const rightLogical = evaluateAST(logicalNode.right, context);
242
+ switch (logicalNode.operator) {
243
+ case '&&':
244
+ return leftLogical && rightLogical;
245
+ case '||':
246
+ return leftLogical || rightLogical;
247
+ default:
248
+ throw new Error(`Unsupported operator: ${logicalNode.operator}`);
249
+ }
250
+ }
251
+ case 'UnaryExpression': {
252
+ const unaryNode = node;
253
+ const arg = evaluateAST(unaryNode.argument, context) as number;
254
+ switch (unaryNode.operator) {
255
+ case '+':
256
+ return +arg;
257
+ case '-':
258
+ return -arg;
259
+ case '!':
260
+ return !arg;
261
+ default:
262
+ throw new Error(`Unsupported operator: ${unaryNode.operator}`);
263
+ }
264
+ }
265
+ case 'ConditionalExpression': {
266
+ const condNode = node;
267
+ const test = evaluateAST(condNode.test, context);
268
+ return test
269
+ ? evaluateAST(condNode.consequent, context)
270
+ : evaluateAST(condNode.alternate, context);
271
+ }
272
+ case 'MemberExpression': {
273
+ const memberNode = node;
274
+ const obj = evaluateAST(memberNode.object, context) as Record<string, unknown>;
275
+ let prop: string | number;
276
+ if (memberNode.computed) {
277
+ prop = evaluateAST(memberNode.property, context) as string | number;
278
+ } else {
279
+ prop = (memberNode.property as Identifier).name;
280
+ }
281
+ if (typeof prop === 'string' || typeof prop === 'number') {
282
+ if (typeof prop === 'string' && ['constructor', '__proto__', 'prototype'].includes(prop)) {
283
+ throw new Error('Access to prohibited property');
284
+ }
285
+ // Block prototype pollution methods
286
+ if (typeof prop === 'string' && ['__defineGetter__', '__defineSetter__', '__lookupGetter__', '__lookupSetter__'].includes(prop)) {
287
+ throw new Error(`Access to prohibited method: ${prop}`);
288
+ }
289
+ return obj[prop];
290
+ } else {
291
+ throw new Error('Invalid property access');
292
+ }
293
+ }
294
+ case 'CallExpression': {
295
+ const callNode = node;
296
+ const callee = evaluateAST(callNode.callee, context);
297
+ const args = callNode.arguments.map((argNode) => evaluateAST(argNode, context));
298
+ if (typeof callee === 'function') {
299
+ if (callNode.callee.type === 'MemberExpression') {
300
+ const memberExpr = callNode.callee;
301
+ const obj = evaluateAST(memberExpr.object, context);
302
+ if (
303
+ obj !== null &&
304
+ (typeof obj === 'object' ||
305
+ typeof obj === 'number' ||
306
+ typeof obj === 'string' ||
307
+ typeof obj === 'boolean')
308
+ ) {
309
+ return callee.call(obj, ...args);
310
+ } else {
311
+ throw new Error('Invalid object in member function call');
312
+ }
313
+ } else {
314
+ // Use a type assertion to tell TypeScript this is a safe function call
315
+ return (callee as (...args: unknown[]) => unknown)(...args);
316
+ }
317
+ } else {
318
+ throw new Error('Attempted to call a non-function');
319
+ }
320
+ }
321
+ case 'ArrowFunctionExpression': {
322
+ const arrowFuncNode = node;
323
+ const params = arrowFuncNode.params.map((param) => (param as Identifier).name);
324
+ const body = arrowFuncNode.body;
325
+
326
+ return (...args: unknown[]) => {
327
+ const newContext = { ...context };
328
+ params.forEach((param, index) => {
329
+ newContext[param] = args[index];
330
+ });
331
+ return evaluateAST(body, newContext);
332
+ };
333
+ }
334
+ case 'ArrayExpression': {
335
+ const arrayNode = node;
336
+ return arrayNode.elements.map((elem) => (elem ? evaluateAST(elem, context) : null));
337
+ }
338
+ case 'ObjectExpression': {
339
+ const objectNode = node;
340
+ const objResult: Record<string, unknown> = {};
341
+ objectNode.properties.forEach((prop) => {
342
+ const propNode = prop as Property;
343
+ let key: string;
344
+ if (propNode.key.type === 'Identifier') {
345
+ key = propNode.key.name;
346
+ } else {
347
+ const evaluatedKey = evaluateAST(propNode.key, context);
348
+ if (typeof evaluatedKey !== 'string' && typeof evaluatedKey !== 'number') {
349
+ throw new Error('Object property keys must be strings or numbers');
350
+ }
351
+ key = String(evaluatedKey);
352
+ }
353
+ const value = evaluateAST(propNode.value, context);
354
+ objResult[key] = value;
355
+ });
356
+ return objResult;
357
+ }
358
+ default:
359
+ throw new Error(`Unsupported syntax in placeholder: ${node.type}`);
360
+ }
361
+ };
362
+
363
+ const evaluatePlaceholders = (arg: {
364
+ content: string;
365
+ context: Record<string, unknown>;
366
+ }): string => {
367
+ const { content, context } = arg;
368
+
369
+ let resultContent = '';
370
+ let index = 0;
371
+
372
+ while (index < content.length) {
373
+ const startIndex = content.indexOf('{', index);
374
+ if (startIndex === -1) {
375
+ resultContent += content.slice(index);
376
+ break;
377
+ }
378
+
379
+ resultContent += content.slice(index, startIndex);
380
+ let braceCount = 1;
381
+ let endIndex = startIndex + 1;
382
+
383
+ while (endIndex < content.length && braceCount > 0) {
384
+ if (content[endIndex] === '{') {
385
+ braceCount++;
386
+ } else if (content[endIndex] === '}') {
387
+ braceCount--;
388
+ }
389
+ endIndex++;
390
+ }
391
+
392
+ if (braceCount === 0) {
393
+ const code = content.slice(startIndex + 1, endIndex - 1).trim();
394
+
395
+ if (expressionCache.has(code)) {
396
+ const evalFunc = expressionCache.get(code)!;
397
+ try {
398
+ const value = evalFunc(context);
399
+ resultContent += String(value);
400
+ } catch {
401
+ resultContent += content.slice(startIndex, endIndex);
402
+ }
403
+ } else {
404
+ try {
405
+ const ast = acorn.parseExpressionAt(code, 0, { ecmaVersion: 'latest' }) as AcornNode;
406
+ validateAST(ast);
407
+ const evalFunc = (ctx: Record<string, unknown>) => evaluateAST(ast, ctx);
408
+ expressionCache.set(code, evalFunc);
409
+ const value = evalFunc(context);
410
+ resultContent += String(value);
411
+ } catch {
412
+ resultContent += content.slice(startIndex, endIndex);
413
+ }
414
+ }
415
+
416
+ index = endIndex;
417
+ } else {
418
+ throw new Error('Invalid placeholder');
419
+ }
420
+ }
421
+
422
+ return resultContent;
423
+ };
424
+
425
+ export const replacePlaceholders = (arg: {
426
+ content: string;
427
+ variables: Record<string, unknown>;
428
+ schemas: SchemaPageArray;
429
+ }): string => {
430
+ const { content, variables, schemas } = arg;
431
+ if (!content || typeof content !== 'string' || !content.includes('{') || !content.includes('}')) {
432
+ return content;
433
+ }
434
+
435
+ const date = new Date();
436
+ const formattedDate = formatDate(date);
437
+ const formattedDateTime = formatDateTime(date);
438
+
439
+ const data = {
440
+ ...Object.fromEntries(
441
+ schemas.flat().map((schema) => [schema.name, schema.readOnly ? schema.content || '' : '']),
442
+ ),
443
+ ...variables,
444
+ };
445
+ const parsedInput = parseData(data);
446
+
447
+ const context: Record<string, unknown> = {
448
+ date: formattedDate,
449
+ dateTime: formattedDateTime,
450
+ ...parsedInput,
451
+ };
452
+
453
+ Object.entries(context).forEach(([key, value]) => {
454
+ if (typeof value === 'string' && value.includes('{') && value.includes('}')) {
455
+ context[key] = evaluatePlaceholders({ content: value, context });
456
+ }
457
+ });
458
+
459
+ return evaluatePlaceholders({ content, context });
460
+ };