@ketrics/sdk-backend 0.3.0 → 0.5.0

package/dist/pdf.d.ts

@@ -0,0 +1,268 @@
+/**
+ * PDF SDK Types
+ *
+ * Type definitions for PDF file reading, creation, and modification in tenant applications.
+ */
+/**
+ * Standard page sizes
+ */
+export type PdfPageSize = 'A4' | 'Letter' | 'Legal' | 'Tabloid' | 'A3' | 'A5';
+/**
+ * Standard PDF fonts
+ */
+export type PdfStandardFont = 'Courier' | 'CourierBold' | 'CourierBoldOblique' | 'CourierOblique' | 'Helvetica' | 'HelveticaBold' | 'HelveticaBoldOblique' | 'HelveticaOblique' | 'TimesRoman' | 'TimesRomanBold' | 'TimesRomanBoldItalic' | 'TimesRomanItalic' | 'Symbol' | 'ZapfDingbats';
+/**
+ * RGB color (values 0-1)
+ */
+export interface PdfRgbColor {
+    r: number;
+    g: number;
+    b: number;
+}
+/**
+ * Options for drawing text
+ */
+export interface PdfDrawTextOptions {
+    /** X coordinate */
+    x?: number;
+    /** Y coordinate */
+    y?: number;
+    /** Font size */
+    size?: number;
+    /** Font to use */
+    font?: PdfEmbeddedFont;
+    /** Text color */
+    color?: PdfRgbColor;
+    /** Rotation in degrees */
+    rotate?: number;
+    /** Opacity (0-1) */
+    opacity?: number;
+    /** Line height for multiline text */
+    lineHeight?: number;
+    /** Maximum width for text wrapping */
+    maxWidth?: number;
+}
+/**
+ * Options for drawing rectangles
+ */
+export interface PdfDrawRectOptions {
+    /** X coordinate */
+    x: number;
+    /** Y coordinate */
+    y: number;
+    /** Width */
+    width: number;
+    /** Height */
+    height: number;
+    /** Fill color */
+    color?: PdfRgbColor;
+    /** Border color */
+    borderColor?: PdfRgbColor;
+    /** Border width */
+    borderWidth?: number;
+    /** Opacity (0-1) */
+    opacity?: number;
+    /** Rotation in degrees */
+    rotate?: number;
+}
+/**
+ * Options for drawing lines
+ */
+export interface PdfDrawLineOptions {
+    /** Start point */
+    start: {
+        x: number;
+        y: number;
+    };
+    /** End point */
+    end: {
+        x: number;
+        y: number;
+    };
+    /** Line thickness */
+    thickness?: number;
+    /** Line color */
+    color?: PdfRgbColor;
+    /** Opacity (0-1) */
+    opacity?: number;
+}
+/**
+ * Options for drawing circles
+ */
+export interface PdfDrawCircleOptions {
+    /** Center X coordinate */
+    x: number;
+    /** Center Y coordinate */
+    y: number;
+    /** Radius */
+    radius: number;
+    /** Fill color */
+    color?: PdfRgbColor;
+    /** Border color */
+    borderColor?: PdfRgbColor;
+    /** Border width */
+    borderWidth?: number;
+    /** Opacity (0-1) */
+    opacity?: number;
+}
+/**
+ * Options for drawing images
+ */
+export interface PdfDrawImageOptions {
+    /** X coordinate */
+    x?: number;
+    /** Y coordinate */
+    y?: number;
+    /** Width (scales image) */
+    width?: number;
+    /** Height (scales image) */
+    height?: number;
+    /** Rotation in degrees */
+    rotate?: number;
+    /** Opacity (0-1) */
+    opacity?: number;
+}
+/**
+ * Embedded image in PDF
+ */
+export interface PdfEmbeddedImage {
+    /** Original image width */
+    readonly width: number;
+    /** Original image height */
+    readonly height: number;
+    /** Scale image by factor */
+    scale(factor: number): {
+        width: number;
+        height: number;
+    };
+    /** Scale image to fit within bounds */
+    scaleToFit(width: number, height: number): {
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Embedded font in PDF
+ */
+export interface PdfEmbeddedFont {
+    /** Font name */
+    readonly name: string;
+    /** Calculate width of text at given size */
+    widthOfTextAtSize(text: string, size: number): number;
+    /** Get font height at given size */
+    heightAtSize(size: number): number;
+}
+/**
+ * PDF Page Interface
+ *
+ * Represents a single page in a PDF document.
+ */
+export interface IPdfPage {
+    /** Page width in points */
+    readonly width: number;
+    /** Page height in points */
+    readonly height: number;
+    /** Get page dimensions */
+    getSize(): {
+        width: number;
+        height: number;
+    };
+    /** Set page dimensions */
+    setSize(width: number, height: number): void;
+    /** Draw text on the page */
+    drawText(text: string, options?: PdfDrawTextOptions): Promise<void>;
+    /** Draw a rectangle */
+    drawRectangle(options: PdfDrawRectOptions): void;
+    /** Draw a line */
+    drawLine(options: PdfDrawLineOptions): void;
+    /** Draw a circle */
+    drawCircle(options: PdfDrawCircleOptions): void;
+    /** Draw an embedded image */
+    drawImage(image: PdfEmbeddedImage, options?: PdfDrawImageOptions): void;
+}
+/**
+ * PDF Document Interface
+ *
+ * Main container for pages in a PDF file.
+ */
+export interface IPdfDocument {
+    /** Get total page count */
+    getPageCount(): number;
+    /** Get all pages */
+    getPages(): IPdfPage[];
+    /** Get page by index (0-based) */
+    getPage(index: number): IPdfPage;
+    /** Add a new page */
+    addPage(size?: PdfPageSize | [number, number]): IPdfPage;
+    /** Insert a page at index */
+    insertPage(index: number, size?: PdfPageSize | [number, number]): IPdfPage;
+    /** Remove a page by index */
+    removePage(index: number): void;
+    /** Copy pages from another document */
+    copyPages(sourceDoc: IPdfDocument, pageIndices: number[]): Promise<IPdfPage[]>;
+    /** Embed a PNG image */
+    embedPng(imageData: Buffer | Uint8Array): Promise<PdfEmbeddedImage>;
+    /** Embed a JPG image */
+    embedJpg(imageData: Buffer | Uint8Array): Promise<PdfEmbeddedImage>;
+    /** Embed a custom font */
+    embedFont(fontData: Buffer | Uint8Array): Promise<PdfEmbeddedFont>;
+    /** Embed a standard font */
+    embedStandardFont(font: PdfStandardFont): Promise<PdfEmbeddedFont>;
+    /** Set document title */
+    setTitle(title: string): void;
+    /** Set document author */
+    setAuthor(author: string): void;
+    /** Set document subject */
+    setSubject(subject: string): void;
+    /** Set document keywords */
+    setKeywords(keywords: string[]): void;
+    /** Set document creator */
+    setCreator(creator: string): void;
+    /** Set document producer */
+    setProducer(producer: string): void;
+    /** Get document title */
+    getTitle(): string | undefined;
+    /** Get document author */
+    getAuthor(): string | undefined;
+    /** Get document subject */
+    getSubject(): string | undefined;
+    /** Get document keywords */
+    getKeywords(): string | undefined;
+    /** Get document creator */
+    getCreator(): string | undefined;
+    /** Get document producer */
+    getProducer(): string | undefined;
+    /** Write document to buffer */
+    toBuffer(): Promise<Buffer>;
+}
+/**
+ * PDF Manager Interface
+ *
+ * Static class interface for reading and creating PDF files.
+ */
+export interface PdfManager {
+    /**
+     * Read a PDF file from a buffer
+     *
+     * @param buffer - Buffer containing PDF file data
+     * @returns Parsed PDF document
+     * @throws PdfParseError if file cannot be parsed
+     */
+    read(buffer: Buffer): Promise<IPdfDocument>;
+    /**
+     * Create a new empty PDF document
+     *
+     * @returns New empty PDF document
+     */
+    create(): Promise<IPdfDocument>;
+    /**
+     * Create an RGB color object
+     *
+     * @param r - Red component (0-1)
+     * @param g - Green component (0-1)
+     * @param b - Blue component (0-1)
+     * @returns RGB color object
+     */
+    rgb(r: number, g: number, b: number): PdfRgbColor;
+}
+//# sourceMappingURL=pdf.d.ts.map

package/dist/pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../src/pdf.ts"],"names":[],"mappings":"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"}

package/dist/pdf.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * PDF SDK Types
+ *
+ * Type definitions for PDF file reading, creation, and modification in tenant applications.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=pdf.js.map

package/dist/pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.js","sourceRoot":"","sources":["../src/pdf.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ketrics/sdk-backend",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Ketrics SDK for backend tenant application code (VM sandbox)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,7 +24,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ketrics/cl-ketrics-mvp.git",
+    "url": "https://github.com/ketrics/cl-ketrics.git",
     "directory": "ketrics-sdk-backend"
   },
   "devDependencies": {