@imagekit/nodejs 7.0.1

package/internal/utils/values.mjs

@@ -0,0 +1,94 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { ImageKitError } from "../../core/error.mjs";
+// https://url.spec.whatwg.org/#url-scheme-string
+const startsWithSchemeRegexp = /^[a-z][a-z0-9+.-]*:/i;
+export const isAbsoluteURL = (url) => {
+    return startsWithSchemeRegexp.test(url);
+};
+export let isArray = (val) => ((isArray = Array.isArray), isArray(val));
+export let isReadonlyArray = isArray;
+/** Returns an object if the given value isn't an object, otherwise returns as-is */
+export function maybeObj(x) {
+    if (typeof x !== 'object') {
+        return {};
+    }
+    return x ?? {};
+}
+// https://stackoverflow.com/a/34491287
+export function isEmptyObj(obj) {
+    if (!obj)
+        return true;
+    for (const _k in obj)
+        return false;
+    return true;
+}
+// https://eslint.org/docs/latest/rules/no-prototype-builtins
+export function hasOwn(obj, key) {
+    return Object.prototype.hasOwnProperty.call(obj, key);
+}
+export function isObj(obj) {
+    return obj != null && typeof obj === 'object' && !Array.isArray(obj);
+}
+export const ensurePresent = (value) => {
+    if (value == null) {
+        throw new ImageKitError(`Expected a value to be given but received ${value} instead.`);
+    }
+    return value;
+};
+export const validatePositiveInteger = (name, n) => {
+    if (typeof n !== 'number' || !Number.isInteger(n)) {
+        throw new ImageKitError(`${name} must be an integer`);
+    }
+    if (n < 0) {
+        throw new ImageKitError(`${name} must be a positive integer`);
+    }
+    return n;
+};
+export const coerceInteger = (value) => {
+    if (typeof value === 'number')
+        return Math.round(value);
+    if (typeof value === 'string')
+        return parseInt(value, 10);
+    throw new ImageKitError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+};
+export const coerceFloat = (value) => {
+    if (typeof value === 'number')
+        return value;
+    if (typeof value === 'string')
+        return parseFloat(value);
+    throw new ImageKitError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+};
+export const coerceBoolean = (value) => {
+    if (typeof value === 'boolean')
+        return value;
+    if (typeof value === 'string')
+        return value === 'true';
+    return Boolean(value);
+};
+export const maybeCoerceInteger = (value) => {
+    if (value == null) {
+        return undefined;
+    }
+    return coerceInteger(value);
+};
+export const maybeCoerceFloat = (value) => {
+    if (value == null) {
+        return undefined;
+    }
+    return coerceFloat(value);
+};
+export const maybeCoerceBoolean = (value) => {
+    if (value == null) {
+        return undefined;
+    }
+    return coerceBoolean(value);
+};
+export const safeJSON = (text) => {
+    try {
+        return JSON.parse(text);
+    }
+    catch (err) {
+        return undefined;
+    }
+};
+//# sourceMappingURL=values.mjs.map

package/internal/utils/values.mjs.map

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

package/internal/utils.d.mts

@@ -0,0 +1,7 @@
+export * from "./utils/values.mjs";
+export * from "./utils/base64.mjs";
+export * from "./utils/env.mjs";
+export * from "./utils/log.mjs";
+export * from "./utils/uuid.mjs";
+export * from "./utils/sleep.mjs";
+//# sourceMappingURL=utils.d.mts.map

package/internal/utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../src/internal/utils.ts"],"names":[],"mappings":""}

package/internal/utils.d.ts

@@ -0,0 +1,7 @@
+export * from "./utils/values.js";
+export * from "./utils/base64.js";
+export * from "./utils/env.js";
+export * from "./utils/log.js";
+export * from "./utils/uuid.js";
+export * from "./utils/sleep.js";
+//# sourceMappingURL=utils.d.ts.map

package/internal/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/internal/utils.ts"],"names":[],"mappings":""}

package/internal/utils.js

@@ -0,0 +1,11 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("./tslib.js");
+tslib_1.__exportStar(require("./utils/values.js"), exports);
+tslib_1.__exportStar(require("./utils/base64.js"), exports);
+tslib_1.__exportStar(require("./utils/env.js"), exports);
+tslib_1.__exportStar(require("./utils/log.js"), exports);
+tslib_1.__exportStar(require("./utils/uuid.js"), exports);
+tslib_1.__exportStar(require("./utils/sleep.js"), exports);
+//# sourceMappingURL=utils.js.map

package/internal/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/internal/utils.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,4DAA+B;AAC/B,4DAA+B;AAC/B,yDAA4B;AAC5B,yDAA4B;AAC5B,0DAA6B;AAC7B,2DAA8B"}

package/internal/utils.mjs

@@ -0,0 +1,8 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./utils/values.mjs";
+export * from "./utils/base64.mjs";
+export * from "./utils/env.mjs";
+export * from "./utils/log.mjs";
+export * from "./utils/uuid.mjs";
+export * from "./utils/sleep.mjs";
+//# sourceMappingURL=utils.mjs.map

package/internal/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../src/internal/utils.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/lib/crypto-utils.d.mts

@@ -0,0 +1,16 @@
+/**
+ * Simple synchronous crypto utilities for ImageKit SDK
+ *
+ * This module provides HMAC-SHA1 functionality using Node.js crypto module.
+ * URL signing is only supported in Node.js runtime.
+ */
+/**
+ * Creates an HMAC-SHA1 hash using Node.js crypto module
+ *
+ * @param key - The secret key for HMAC generation
+ * @param data - The data to be signed
+ * @returns Hex-encoded HMAC-SHA1 hash
+ * @throws ImageKitError if crypto module is not available or operation fails
+ */
+export declare function createHmacSha1(key: string, data: string): string;
+//# sourceMappingURL=crypto-utils.d.mts.map

package/lib/crypto-utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-utils.d.mts","sourceRoot":"","sources":["../src/lib/crypto-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBhE"}

package/lib/crypto-utils.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Simple synchronous crypto utilities for ImageKit SDK
+ *
+ * This module provides HMAC-SHA1 functionality using Node.js crypto module.
+ * URL signing is only supported in Node.js runtime.
+ */
+/**
+ * Creates an HMAC-SHA1 hash using Node.js crypto module
+ *
+ * @param key - The secret key for HMAC generation
+ * @param data - The data to be signed
+ * @returns Hex-encoded HMAC-SHA1 hash
+ * @throws ImageKitError if crypto module is not available or operation fails
+ */
+export declare function createHmacSha1(key: string, data: string): string;
+//# sourceMappingURL=crypto-utils.d.ts.map

package/lib/crypto-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-utils.d.ts","sourceRoot":"","sources":["../src/lib/crypto-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBhE"}

package/lib/crypto-utils.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Simple synchronous crypto utilities for ImageKit SDK
+ *
+ * This module provides HMAC-SHA1 functionality using Node.js crypto module.
+ * URL signing is only supported in Node.js runtime.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHmacSha1 = createHmacSha1;
+const error_1 = require("../core/error.js");
+/**
+ * Creates an HMAC-SHA1 hash using Node.js crypto module
+ *
+ * @param key - The secret key for HMAC generation
+ * @param data - The data to be signed
+ * @returns Hex-encoded HMAC-SHA1 hash
+ * @throws ImageKitError if crypto module is not available or operation fails
+ */
+function createHmacSha1(key, data) {
+    let crypto;
+    try {
+        crypto = require('crypto');
+    }
+    catch (err) {
+        throw new error_1.ImageKitError('URL signing requires Node.js crypto module which is not available in this runtime. ' +
+            'Please use Node.js environment for URL signing functionality.');
+    }
+    try {
+        return crypto.createHmac('sha1', key).update(data, 'utf8').digest('hex');
+    }
+    catch (error) {
+        throw new error_1.ImageKitError(`Failed to generate HMAC-SHA1 signature: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+//# sourceMappingURL=crypto-utils.js.map

package/lib/crypto-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-utils.js","sourceRoot":"","sources":["../src/lib/crypto-utils.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAYH,wCAmBC;AA7BD,4CAA8C;AAE9C;;;;;;;GAOG;AACH,SAAgB,cAAc,CAAC,GAAW,EAAE,IAAY;IACtD,IAAI,MAAW,CAAC;IAEhB,IAAI,CAAC;QACH,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,qBAAa,CACrB,qFAAqF;YACnF,+DAA+D,CAClE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,qBAAa,CACrB,2CAA2C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CACtG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/lib/crypto-utils.mjs

@@ -0,0 +1,32 @@
+/**
+ * Simple synchronous crypto utilities for ImageKit SDK
+ *
+ * This module provides HMAC-SHA1 functionality using Node.js crypto module.
+ * URL signing is only supported in Node.js runtime.
+ */
+import { ImageKitError } from "../core/error.mjs";
+/**
+ * Creates an HMAC-SHA1 hash using Node.js crypto module
+ *
+ * @param key - The secret key for HMAC generation
+ * @param data - The data to be signed
+ * @returns Hex-encoded HMAC-SHA1 hash
+ * @throws ImageKitError if crypto module is not available or operation fails
+ */
+export function createHmacSha1(key, data) {
+    let crypto;
+    try {
+        crypto = require('crypto');
+    }
+    catch (err) {
+        throw new ImageKitError('URL signing requires Node.js crypto module which is not available in this runtime. ' +
+            'Please use Node.js environment for URL signing functionality.');
+    }
+    try {
+        return crypto.createHmac('sha1', key).update(data, 'utf8').digest('hex');
+    }
+    catch (error) {
+        throw new ImageKitError(`Failed to generate HMAC-SHA1 signature: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+//# sourceMappingURL=crypto-utils.mjs.map

package/lib/crypto-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-utils.mjs","sourceRoot":"","sources":["../src/lib/crypto-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;OAEI,EAAE,aAAa,EAAE;AAExB;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,IAAY;IACtD,IAAI,MAAW,CAAC;IAEhB,IAAI,CAAC;QACH,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,aAAa,CACrB,qFAAqF;YACnF,+DAA+D,CAClE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,aAAa,CACrB,2CAA2C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CACtG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/lib/serialization-utils.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Serialize upload options to handle proper formatting for ImageKit backend API.
+ * Special cases handled:
+ * - tags: converted to comma-separated string
+ * - responseFields: converted to comma-separated string
+ * - extensions: JSON stringified
+ * - customMetadata: JSON stringified
+ * - transformation: JSON stringified
+ */
+export declare function serializeUploadOptions(uploadOptions: Record<string, any>): Record<string, any>;
+//# sourceMappingURL=serialization-utils.d.mts.map

package/lib/serialization-utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization-utils.d.mts","sourceRoot":"","sources":["../src/lib/serialization-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAgC9F"}

package/lib/serialization-utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Serialize upload options to handle proper formatting for ImageKit backend API.
+ * Special cases handled:
+ * - tags: converted to comma-separated string
+ * - responseFields: converted to comma-separated string
+ * - extensions: JSON stringified
+ * - customMetadata: JSON stringified
+ * - transformation: JSON stringified
+ */
+export declare function serializeUploadOptions(uploadOptions: Record<string, any>): Record<string, any>;
+//# sourceMappingURL=serialization-utils.d.ts.map

package/lib/serialization-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization-utils.d.ts","sourceRoot":"","sources":["../src/lib/serialization-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAgC9F"}

package/lib/serialization-utils.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeUploadOptions = serializeUploadOptions;
+/**
+ * Serialize upload options to handle proper formatting for ImageKit backend API.
+ * Special cases handled:
+ * - tags: converted to comma-separated string
+ * - responseFields: converted to comma-separated string
+ * - extensions: JSON stringified
+ * - customMetadata: JSON stringified
+ * - transformation: JSON stringified
+ */
+function serializeUploadOptions(uploadOptions) {
+    const serialized = { ...uploadOptions };
+    for (const key in serialized) {
+        if (key && serialized[key] !== undefined) {
+            const value = serialized[key];
+            if (key === 'tags' && Array.isArray(value)) {
+                // Tags should be comma-separated string
+                serialized[key] = value.join(',');
+            }
+            else if (key === 'responseFields' && Array.isArray(value)) {
+                // Response fields should be comma-separated string
+                serialized[key] = value.join(',');
+            }
+            else if (key === 'extensions' && Array.isArray(value)) {
+                // Extensions should be JSON stringified
+                serialized[key] = JSON.stringify(value);
+            }
+            else if (key === 'customMetadata' &&
+                typeof value === 'object' &&
+                !Array.isArray(value) &&
+                value !== null) {
+                // Custom metadata should be JSON stringified
+                serialized[key] = JSON.stringify(value);
+            }
+            else if (key === 'transformation' && typeof value === 'object' && value !== null) {
+                // Transformation should be JSON stringified
+                serialized[key] = JSON.stringify(value);
+            }
+        }
+    }
+    return serialized;
+}
+//# sourceMappingURL=serialization-utils.js.map

package/lib/serialization-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization-utils.js","sourceRoot":"","sources":["../src/lib/serialization-utils.ts"],"names":[],"mappings":";;AASA,wDAgCC;AAzCD;;;;;;;;GAQG;AACH,SAAgB,sBAAsB,CAAC,aAAkC;IACvE,MAAM,UAAU,GAAwB,EAAE,GAAG,aAAa,EAAE,CAAC;IAE7D,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YAE9B,IAAI,GAAG,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,wCAAwC;gBACxC,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpC,CAAC;iBAAM,IAAI,GAAG,KAAK,gBAAgB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5D,mDAAmD;gBACnD,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpC,CAAC;iBAAM,IAAI,GAAG,KAAK,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxD,wCAAwC;gBACxC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC1C,CAAC;iBAAM,IACL,GAAG,KAAK,gBAAgB;gBACxB,OAAO,KAAK,KAAK,QAAQ;gBACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBACrB,KAAK,KAAK,IAAI,EACd,CAAC;gBACD,6CAA6C;gBAC7C,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC1C,CAAC;iBAAM,IAAI,GAAG,KAAK,gBAAgB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnF,4CAA4C;gBAC5C,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/lib/serialization-utils.mjs

@@ -0,0 +1,42 @@
+/**
+ * Serialize upload options to handle proper formatting for ImageKit backend API.
+ * Special cases handled:
+ * - tags: converted to comma-separated string
+ * - responseFields: converted to comma-separated string
+ * - extensions: JSON stringified
+ * - customMetadata: JSON stringified
+ * - transformation: JSON stringified
+ */
+export function serializeUploadOptions(uploadOptions) {
+    const serialized = { ...uploadOptions };
+    for (const key in serialized) {
+        if (key && serialized[key] !== undefined) {
+            const value = serialized[key];
+            if (key === 'tags' && Array.isArray(value)) {
+                // Tags should be comma-separated string
+                serialized[key] = value.join(',');
+            }
+            else if (key === 'responseFields' && Array.isArray(value)) {
+                // Response fields should be comma-separated string
+                serialized[key] = value.join(',');
+            }
+            else if (key === 'extensions' && Array.isArray(value)) {
+                // Extensions should be JSON stringified
+                serialized[key] = JSON.stringify(value);
+            }
+            else if (key === 'customMetadata' &&
+                typeof value === 'object' &&
+                !Array.isArray(value) &&
+                value !== null) {
+                // Custom metadata should be JSON stringified
+                serialized[key] = JSON.stringify(value);
+            }
+            else if (key === 'transformation' && typeof value === 'object' && value !== null) {
+                // Transformation should be JSON stringified
+                serialized[key] = JSON.stringify(value);
+            }
+        }
+    }
+    return serialized;
+}
+//# sourceMappingURL=serialization-utils.mjs.map

package/lib/serialization-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization-utils.mjs","sourceRoot":"","sources":["../src/lib/serialization-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,aAAkC;IACvE,MAAM,UAAU,GAAwB,EAAE,GAAG,aAAa,EAAE,CAAC;IAE7D,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YAE9B,IAAI,GAAG,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,wCAAwC;gBACxC,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpC,CAAC;iBAAM,IAAI,GAAG,KAAK,gBAAgB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5D,mDAAmD;gBACnD,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpC,CAAC;iBAAM,IAAI,GAAG,KAAK,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxD,wCAAwC;gBACxC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC1C,CAAC;iBAAM,IACL,GAAG,KAAK,gBAAgB;gBACxB,OAAO,KAAK,KAAK,QAAQ;gBACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBACrB,KAAK,KAAK,IAAI,EACd,CAAC;gBACD,6CAA6C;gBAC7C,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC1C,CAAC;iBAAM,IAAI,GAAG,KAAK,gBAAgB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnF,4CAA4C;gBAC5C,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/lib/transformation-utils.d.mts

@@ -0,0 +1,18 @@
+import type { SrcOptions } from "../resources/shared.mjs";
+/**
+ * Supported transformations mapping
+ * {@link https://imagekit.io/docs/transformations}
+ */
+export declare const supportedTransforms: {
+    [key: string]: string;
+};
+declare const _default: {
+    addAsQueryParameter: (options: SrcOptions) => boolean;
+    getTransformKey: (transform: string) => string;
+    getChainTransformDelimiter: () => string;
+    getTransformDelimiter: () => string;
+    getTransformKeyValueDelimiter: () => string;
+};
+export default _default;
+export declare const safeBtoa: (str: string) => string;
+//# sourceMappingURL=transformation-utils.d.mts.map

package/lib/transformation-utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformation-utils.d.mts","sourceRoot":"","sources":["../src/lib/transformation-utils.ts"],"names":[],"mappings":"OAGO,KAAK,EAAE,UAAU,EAA0B;AASlD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAyExD,CAAC;;mCAG+B,UAAU,KAAG,OAAO;iCAGb,MAAM,KAAG,MAAM;sCAOZ,MAAM;iCAGX,MAAM;yCAGE,MAAM;;AAjBpD,wBAoBE;AAEF,eAAO,MAAM,QAAQ,GAAa,KAAK,MAAM,KAAG,MAG/C,CAAC"}

package/lib/transformation-utils.d.ts

@@ -0,0 +1,18 @@
+import type { SrcOptions } from "../resources/shared.js";
+/**
+ * Supported transformations mapping
+ * {@link https://imagekit.io/docs/transformations}
+ */
+export declare const supportedTransforms: {
+    [key: string]: string;
+};
+declare const _default: {
+    addAsQueryParameter: (options: SrcOptions) => boolean;
+    getTransformKey: (transform: string) => string;
+    getChainTransformDelimiter: () => string;
+    getTransformDelimiter: () => string;
+    getTransformKeyValueDelimiter: () => string;
+};
+export default _default;
+export declare const safeBtoa: (str: string) => string;
+//# sourceMappingURL=transformation-utils.d.ts.map

package/lib/transformation-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformation-utils.d.ts","sourceRoot":"","sources":["../src/lib/transformation-utils.ts"],"names":[],"mappings":"OAGO,KAAK,EAAE,UAAU,EAA0B;AASlD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAyExD,CAAC;;mCAG+B,UAAU,KAAG,OAAO;iCAGb,MAAM,KAAG,MAAM;sCAOZ,MAAM;iCAGX,MAAM;yCAGE,MAAM;;AAjBpD,wBAoBE;AAEF,eAAO,MAAM,QAAQ,GAAa,KAAK,MAAM,KAAG,MAG/C,CAAC"}

package/lib/transformation-utils.js

@@ -0,0 +1,110 @@
+"use strict";
+// Transformation utilities ported from JavaScript SDK
+// This file is in src/lib/ to avoid conflicts with generated code
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeBtoa = exports.supportedTransforms = void 0;
+const base64_1 = require("../internal/utils/base64.js");
+const QUERY_TRANSFORMATION_POSITION = 'query';
+const PATH_TRANSFORMATION_POSITION = 'path';
+const CHAIN_TRANSFORM_DELIMITER = ':';
+const TRANSFORM_DELIMITER = ',';
+const TRANSFORM_KEY_VALUE_DELIMITER = '-';
+/**
+ * Supported transformations mapping
+ * {@link https://imagekit.io/docs/transformations}
+ */
+exports.supportedTransforms = {
+    // Basic sizing & layout
+    width: 'w',
+    height: 'h',
+    aspectRatio: 'ar',
+    background: 'bg',
+    border: 'b',
+    crop: 'c',
+    cropMode: 'cm',
+    dpr: 'dpr',
+    focus: 'fo',
+    quality: 'q',
+    x: 'x',
+    xCenter: 'xc',
+    y: 'y',
+    yCenter: 'yc',
+    format: 'f',
+    videoCodec: 'vc',
+    audioCodec: 'ac',
+    radius: 'r',
+    rotation: 'rt',
+    blur: 'bl',
+    named: 'n',
+    defaultImage: 'di',
+    flip: 'fl',
+    original: 'orig',
+    startOffset: 'so',
+    endOffset: 'eo',
+    duration: 'du',
+    streamingResolutions: 'sr',
+    // AI & advanced effects
+    grayscale: 'e-grayscale',
+    aiUpscale: 'e-upscale',
+    aiRetouch: 'e-retouch',
+    aiVariation: 'e-genvar',
+    aiDropShadow: 'e-dropshadow',
+    aiChangeBackground: 'e-changebg',
+    aiRemoveBackground: 'e-bgremove',
+    aiRemoveBackgroundExternal: 'e-removedotbg',
+    aiEdit: 'e-edit',
+    contrastStretch: 'e-contrast',
+    shadow: 'e-shadow',
+    sharpen: 'e-sharpen',
+    unsharpMask: 'e-usm',
+    gradient: 'e-gradient',
+    // Other flags & finishing
+    progressive: 'pr',
+    lossless: 'lo',
+    colorProfile: 'cp',
+    metadata: 'md',
+    opacity: 'o',
+    trim: 't',
+    zoom: 'z',
+    page: 'pg',
+    // Text overlay transformations
+    fontSize: 'fs',
+    fontFamily: 'ff',
+    fontColor: 'co',
+    innerAlignment: 'ia',
+    padding: 'pa',
+    alpha: 'al',
+    typography: 'tg',
+    lineHeight: 'lh',
+    // Subtitles transformations
+    fontOutline: 'fol',
+    fontShadow: 'fsh',
+    // Raw pass-through
+    raw: 'raw',
+};
+exports.default = {
+    addAsQueryParameter: (options) => {
+        return options.transformationPosition === QUERY_TRANSFORMATION_POSITION;
+    },
+    getTransformKey: function (transform) {
+        if (!transform) {
+            return '';
+        }
+        return exports.supportedTransforms[transform] || exports.supportedTransforms[transform.toLowerCase()] || '';
+    },
+    getChainTransformDelimiter: function () {
+        return CHAIN_TRANSFORM_DELIMITER;
+    },
+    getTransformDelimiter: function () {
+        return TRANSFORM_DELIMITER;
+    },
+    getTransformKeyValueDelimiter: function () {
+        return TRANSFORM_KEY_VALUE_DELIMITER;
+    },
+};
+const safeBtoa = function (str) {
+    // Use the SDK's built-in base64 utility that properly handles different runtimes
+    return (0, base64_1.toBase64)(str);
+};
+exports.safeBtoa = safeBtoa;
+//# sourceMappingURL=transformation-utils.js.map

package/lib/transformation-utils.js.map

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