feat(api): add xCenter, yCenter, and anchorPoint parameters for overlay positioning

Author: manu4543

src/resources/helper.ts

@@ -314,16 +314,25 @@ function processOverlay(overlay: Transformation['overlay']): string | undefined
     entries.push(`lm-${overlay.layerMode}`);
   }
 
-  const { x, y, focus } = position;
+  const { x, y, xCenter, yCenter, focus, anchorPoint } = position;
   if (x) {
     entries.push(`lx-${x}`);
   }
   if (y) {
     entries.push(`ly-${y}`);
   }
+  if (xCenter) {
+    entries.push(`lxc-${xCenter}`);
+  }
+  if (yCenter) {
+    entries.push(`lyc-${yCenter}`);
+  }
   if (focus) {
     entries.push(`lfo-${focus}`);
   }
+  if (anchorPoint) {
+    entries.push(`lap-${anchorPoint}`);
+  }
 
   const { start, end, duration } = timing;
   if (start) {

tests/custom-tests/url-generation/overlay.test.ts

@@ -434,6 +434,30 @@ describe('Overlay Transformation Test Cases', function () {
       `https://ik.imagekit.io/test_url_endpoint/tr:l-image,i-displacement-map.png,lm-displace,lx-50,ly-50,l-end/base-image.jpg`,
     );
   });
+
+  it('should generate URL with xCenter, yCenter and anchorPoint top_left', function () {
+    const url = client.helper.buildSrc({
+      transformationPosition: 'path',
+      urlEndpoint: 'https://ik.imagekit.io/test_url_endpoint',
+      src: '/base-image.jpg',
+      transformation: [
+        {
+          overlay: {
+            type: 'image',
+            input: 'logo.png',
+            position: {
+              xCenter: 100,
+              yCenter: 200,
+              anchorPoint: 'top_left',
+            },
+          },
+        },
+      ],
+    });
+    expect(url).toBe(
+      `https://ik.imagekit.io/test_url_endpoint/tr:l-image,i-logo.png,lxc-100,lyc-200,lap-top_left,l-end/base-image.jpg`,
+    );
+  });
 });
 
 describe('Overlay encoding test cases', function () {
@@ -720,3 +744,5 @@ describe('Overlay encoding test cases', function () {
     expect(url).toBe(`https://ik.imagekit.io/demo/sample.jpg?tr=l-text,i-Minimal%20Text,l-end`);
   });
 });
+
+