Merge pull request #118 from aspose-pdf-cloud/develop

update to 25.3

Author: boiledgas

.devcontainer/devcontainer.json

@@ -0,0 +1,23 @@
+{
+	"name": "Node.js & TypeScript",
+	"image": "mcr.microsoft.com/devcontainers/typescript-node:1-22-bookworm",
+	"postCreateCommand": "npm install --no-bin-links",
+	"workspaceFolder": "/SDKs/Node.JS",
+	"workspaceMount": "source=${localWorkspaceFolder},target=/SDKs/Node.JS,type=bind,consistency=cached",
+	"customizations": {
+		"vscode": {
+			"settings": {
+				"mochaExplorer.files": "test/*.ts",
+				"mochaExplorer.require": "ts-node/register",	
+				"mochaExplorer.timeout": 60000
+			},
+			"extensions": [
+				"hbenl.vscode-mocha-test-adapter"
+			]
+		}
+	},
+	"mounts": [
+		"source=${localWorkspaceFolder}/../../Settings,target=/Settings,type=bind,consistency=cached"
+	]
+
+}

README.md

@@ -30,8 +30,9 @@ XLS, XLSX, PPTX, DOC, DOCX, MobiXML, JPEG, EMF, PNG, BMP, GIF, TIFF, Text
 ## Read PDF Formats
 MHT, PCL, PS, XSLFO, MD
 
-## Enhancements in Version 25.2
+## Enhancements in Version 25.3
 - A new version of Aspose.PDF Cloud was prepared using the latest version of Aspose.PDF for .NET.
+
 ## Installation
 
 ### NPM

UsesCases/Split/splitPages.js

@@ -0,0 +1,52 @@
+import credentials from "../../../Credentials/credentials.json"  with { type: "json" };
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { PdfApi } from "../../src/api/api.js";
+
+const configParams = {
+    LOCAL_FOLDER: "C:\\Samples\\",
+    PDF_DOCUMENT_NAME: "sample.pdf",
+};
+
+const pdfApi = new PdfApi(credentials.id, credentials.key);
+
+const pdfSplitter = {
+    async uploadDocument () {
+        const fileNamePath = path.join(configParams.LOCAL_FOLDER, configParams.PDF_DOCUMENT_NAME);
+        const pdfFileData = await fs.readFile(fileNamePath);
+        await pdfApi.uploadFile(configParams.PDF_DOCUMENT_NAME, pdfFileData);
+        console.log("Source document uploaded!");
+        },
+    
+    async downloadPages (pageHref, index) {
+            const changedPdfData = await pdfApi.downloadFile(pageHref);
+            const filePath = path.join(configParams.LOCAL_FOLDER, 'Page_' + index +'_' +  pageHref);
+            await fs.writeFile(filePath, changedPdfData.body);
+            console.log("Downloaded: " + filePath);
+        },
+
+    async splitPages () {
+        const resultPages = await pdfApi.postSplitDocument(configParams.PDF_DOCUMENT_NAME, "pdf");
+
+        if (resultPages.body.code == 200 && resultPages.body.result.documents) {
+            resultPages.body.result.documents.forEach(async (docPage, index) => {
+                await this.downloadPages(docPage.href, index);
+            })
+        }
+        else
+            console.error("Unexpected error : can't get splitted documents!!!");
+    },
+
+    
+}
+
+async function main() {
+    try {
+        await pdfSplitter.uploadDocument();
+        await pdfSplitter.splitPages();
+    } catch (error) {
+        console.error("Error:", error.message);
+    }
+}
+
+main();

UsesCases/Split/splitRange.js

@@ -0,0 +1,65 @@
+import credentials from "../../../Credentials/credentials.json"  with { type: "json" };
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { PdfApi } from "../../src/api/api.js";
+import { SplitRangePdfOptions } from "../../src/models/splitRangePdfOptions.js";
+import { PageRange } from "../../src/models/pageRange.js";
+
+const configParams = {
+    LOCAL_FOLDER: "C:\\Samples\\",
+    PDF_DOCUMENT_NAME: "sample.pdf",
+};
+
+const range_1 = new PageRange();
+range_1.from = 1;
+range_1.to = 3;
+
+const range_2 = new PageRange();
+range_2.from = 4;
+range_2.to = 7;
+
+const splitRangesArray = new SplitRangePdfOptions();
+splitRangesArray.pageRanges = [ range_1, range_2 ];
+
+const pdfApi = new PdfApi(credentials.id, credentials.key);
+
+const pdfSplitter = {
+    async uploadDocument () {
+        const fileNamePath = path.join(configParams.LOCAL_FOLDER, configParams.PDF_DOCUMENT_NAME);
+        const pdfFileData = await fs.readFile(fileNamePath);
+        await pdfApi.uploadFile(configParams.PDF_DOCUMENT_NAME, pdfFileData);
+        console.log("Source document uploaded!");
+        },
+    
+    async downloadPages (pageHref, index) {
+            const changedPdfData = await pdfApi.downloadFile(pageHref);
+            const filePath = path.join(configParams.LOCAL_FOLDER, 'Page_' + index +'_' +  pageHref);
+            await fs.writeFile(filePath, changedPdfData.body);
+            console.log("Downloaded: " + filePath);
+        },
+
+    async splitRanges () {
+        const resultPages = await pdfApi.postSplitRangePdfDocument(configParams.PDF_DOCUMENT_NAME, splitRangesArray);
+
+        if (resultPages.body.code == 200 && resultPages.body.result.documents) {
+            resultPages.body.result.documents.forEach(async (docPage, index) => {
+                await this.downloadPages(docPage.href, index);
+            })
+        }
+        else
+            console.error("Unexpected error : can't get splitted documents!!!");
+    },
+
+    
+}
+
+async function main() {
+    try {
+        await pdfSplitter.uploadDocument();
+        await pdfSplitter.splitRanges();
+    } catch (error) {
+        console.error("Error:", error.message);
+    }
+}
+
+main();

package-lock.json

@@ -1,6 +1,6 @@
 {
     "name": "asposepdfcloud",
-    "version": "25.2.0",
+    "version": "25.3.0",
     "description": "Aspose.PDF Cloud is a REST API for creating and editing PDF files. Most popular features proposed by Aspose.PDF Cloud: PDF to Word, Convert PDF to Image, Merge PDF, Split PDF, Add Images to PDF, Rotate PDF. It can also be used to convert PDF files to different formats like DOC, HTML, XPS, TIFF and many more. Aspose.PDF Cloud gives you control: create PDFs from scratch or from HTML, XML, template, database, XPS or an image. Render PDFs to image formats such as JPEG, PNG, GIF, BMP, TIFF and many others. Aspose.PDF Cloud helps you manipulate elements of a PDF file like text, annotations, watermarks, signatures, bookmarks, stamps and so on. Its REST API also allows you to manage PDF pages by using features like merging, splitting, and inserting. Add images to a PDF file or convert PDF pages to images.",
     "homepage": "https://products.aspose.cloud/pdf/cloud",
     "author": {

package.json

@@ -95,7 +95,7 @@ async function invokeApiMethodInternal(requestOptions: request.Options, confgura
     //headers
     sa.set("User-Agent", "pdf nodejs sdk");
     sa.set("x-aspose-client", "nodejs sdk");  
-    sa.set("x-aspose-client-version", "25.2.0");
+    sa.set("x-aspose-client-version", "25.3.0");
 
     if (!requestOptions.headers) {
         requestOptions.headers = {};

src/requestHelper.ts

@@ -278,7 +278,7 @@ describe("Images Tests", () => {
 
             it("should return response with code 200", async () => {
 
-                return BaseTest.getPdfApi().getImagesExtractSvg("Alfa.pdf", pageNumber, null, BaseTest.remoteTempFolder, null)
+                return BaseTest.getPdfApi().getImagesExtractSvg("alfa.pdf", pageNumber, null, BaseTest.remoteTempFolder, null)
                     .then((result) => {
                         assert.equal(result.response.statusCode, 200);
                         assert.equal(13, result.body.list.length);

test/testImages.ts

@@ -1,10 +1,10 @@
-{
-    "ambientDependencies": {
-        "core-js": "registry:dt/core-js#0.0.0+20160317120654",
-        "node": "registry:dt/node#4.0.0+20160423143914"
-    },
-    "dependencies": {
-        "bluebird": "registry:npm/bluebird#3.3.4+20160515010139",
-        "request": "registry:npm/request#2.69.0+20160304121250"
-    }
+{
+    "ambientDependencies": {
+        "core-js": "registry:dt/core-js#0.0.0+20160317120654",
+        "node": "registry:dt/node#4.0.0+20160423143914"
+    },
+    "dependencies": {
+        "bluebird": "registry:npm/bluebird#3.3.4+20160515010139",
+        "request": "registry:npm/request#2.69.0+20160304121250"
+    }
 }