@paddle/paddle-node-sdk 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -12,6 +12,14 @@ When we make [non-breaking changes](https://developer.paddle.com/api-reference/a
 
 This means when upgrading minor versions of the SDK, you may notice type errors. You can safely ignore these or fix by adding additional type guards.
 
+## 1.4.0 - 2024-06-20
+
+### Added
+
+- Added a new option to change the logging level of the SDK. You can now set the logging level to `verbose`, `warn`, `error` or `none`. The default logging level is `verbose`.
+
+---
+
 ## 1.3.0 - 2024-04-18
 
 ### Changed

package/LICENSE

@@ -175,18 +175,7 @@
 
    END OF TERMS AND CONDITIONS
 
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2024 Paddle.com Market Limited
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -1,5 +1,11 @@
 # Paddle Node.js SDK
 
+[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/paddlehq/paddle-node-sdk/build-test.yml)](https://github.com/PaddleHQ/paddle-node-sdk/actions/workflows/build-test.yml?query=branch%3Amain)
+[![NPM Version](https://img.shields.io/npm/v/%40paddle%2Fpaddle-node-sdk)](https://www.npmjs.com/package/@paddle/paddle-node-sdk?activeTab=versions)
+[![NPM Downloads](https://img.shields.io/npm/dm/%40paddle%2Fpaddle-node-sdk)](https://www.npmjs.com/package/@paddle/paddle-node-sdk)
+[![GitHub License](https://img.shields.io/github/license/paddlehq/paddle-node-sdk)](https://github.com/PaddleHQ/paddle-node-sdk/blob/main/LICENSE)
+
+
 [Paddle Billing](https://www.paddle.com/billing?utm_source=dx&utm_medium=paddle-node-sdk) is a complete digital product sales and subscription management platform, designed for modern software businesses. It helps you increase your revenue, retain customers, and scale your operations.
 
 This is a [Node.js](https://nodejs.org/) SDK that you can use to integrate Paddle Billing with applications written in server-side JavaScript.
@@ -45,6 +51,7 @@ You can also pass an environment to work with the sandbox:
 ```typescript
 const paddle = new Paddle('API_KEY', {
   environment: Environment.production, // or Environment.sandbox for accessing sandbox API
+  logLevel: 'verbose' // or 'error' for less verbose logging
 })
 ```
 

package/dist/cjs/index.js

@@ -14,9 +14,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Paddle = exports.SDK_VERSION = exports.ApiError = exports.Environment = void 0;
+exports.Paddle = exports.SDK_VERSION = exports.ApiError = exports.LogLevel = exports.Environment = void 0;
 var internal_1 = require("./internal");
 Object.defineProperty(exports, "Environment", { enumerable: true, get: function () { return internal_1.Environment; } });
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return internal_1.LogLevel; } });
 Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return internal_1.ApiError; } });
 var version_1 = require("./version");
 Object.defineProperty(exports, "SDK_VERSION", { enumerable: true, get: function () { return version_1.SDK_VERSION; } });

package/dist/cjs/internal/api/client.js

@@ -20,11 +20,14 @@ const environment_1 = require("./environment");
 const node_crypto_1 = require("node:crypto");
 const logger_1 = require("../base/logger");
 const case_helpers_1 = require("./case-helpers");
+const log_level_1 = require("./log-level");
 class Client {
     constructor(apiKey, options) {
+        var _a;
         this.apiKey = apiKey;
         this.options = options;
         this.baseUrl = this.getBaseUrl(this.options.environment);
+        logger_1.Logger.logLevel = (_a = this.options.logLevel) !== null && _a !== void 0 ? _a : log_level_1.LogLevel.verbose;
     }
     getBaseUrl(environment) {
         const urlBasedOnEnv = constants_1.API_ENVIRONMENT_TO_BASE_URL_MAP[environment !== null && environment !== void 0 ? environment : environment_1.Environment.production];

package/dist/cjs/internal/api/index.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertToSnakeCase = exports.Environment = void 0;
+exports.LogLevel = exports.convertToSnakeCase = exports.Environment = void 0;
 var environment_1 = require("./environment");
 Object.defineProperty(exports, "Environment", { enumerable: true, get: function () { return environment_1.Environment; } });
 var case_helpers_1 = require("./case-helpers");
 Object.defineProperty(exports, "convertToSnakeCase", { enumerable: true, get: function () { return case_helpers_1.convertToSnakeCase; } });
+var log_level_1 = require("./log-level");
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return log_level_1.LogLevel; } });

package/dist/cjs/internal/api/log-level.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogLevel = void 0;
+var LogLevel;
+(function (LogLevel) {
+    LogLevel["verbose"] = "verbose";
+    LogLevel["warn"] = "warn";
+    LogLevel["error"] = "error";
+    LogLevel["none"] = "none";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));

package/dist/cjs/internal/base/logger.js

@@ -1,15 +1,34 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Logger = void 0;
+const api_1 = require("../api");
 class Logger {
+    static shouldLog(level) {
+        switch (Logger.logLevel) {
+            case api_1.LogLevel.verbose:
+                return level !== api_1.LogLevel.none;
+            case api_1.LogLevel.warn:
+                return level === api_1.LogLevel.warn || level === api_1.LogLevel.error;
+            case api_1.LogLevel.error:
+                return level === api_1.LogLevel.error;
+            default:
+                return false;
+        }
+    }
     static log(...args) {
-        console.log('[Paddle] [LOG]', ...args);
+        if (Logger.shouldLog(api_1.LogLevel.verbose)) {
+            console.log('[Paddle] [LOG]', ...args);
+        }
     }
     static warn(...args) {
-        console.warn('[Paddle] [WARN]', ...args);
+        if (Logger.shouldLog(api_1.LogLevel.warn)) {
+            console.warn('[Paddle] [WARN]', ...args);
+        }
     }
     static error(...args) {
-        console.error('[Paddle] [ERROR]', ...args);
+        if (Logger.shouldLog(api_1.LogLevel.error)) {
+            console.error('[Paddle] [ERROR]', ...args);
+        }
     }
     static logRequest(method, url, headers) {
         Logger.log('[Request]', method, url, 'Transaction ID:', headers['X-Transaction-ID']);

package/dist/cjs/paddle.js

@@ -10,6 +10,7 @@ class Paddle {
     constructor(apiKey, options) {
         this.defaultPaddleOptions = {
             environment: internal_1.Environment.production,
+            logLevel: internal_1.LogLevel.verbose,
         };
         this.client = new client_1.Client(apiKey, options ? Object.assign(Object.assign({}, this.defaultPaddleOptions), options) : Object.assign({}, this.defaultPaddleOptions));
         this.products = new resources_1.ProductsResource(this.client);

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = '1.3.0';
+exports.SDK_VERSION = '1.4.0';

package/dist/esm/index.js

@@ -1,4 +1,4 @@
-export { Environment, ApiError } from './internal';
+export { Environment, LogLevel, ApiError } from './internal';
 export { SDK_VERSION } from './version';
 export { Paddle } from './paddle';
 export * from './entities';

package/dist/esm/internal/api/client.js

@@ -14,11 +14,14 @@ import { Environment } from './environment';
 import { randomUUID } from 'node:crypto';
 import { Logger } from '../base/logger';
 import { convertToSnakeCase } from './case-helpers';
+import { LogLevel } from './log-level';
 export class Client {
     constructor(apiKey, options) {
+        var _a;
         this.apiKey = apiKey;
         this.options = options;
         this.baseUrl = this.getBaseUrl(this.options.environment);
+        Logger.logLevel = (_a = this.options.logLevel) !== null && _a !== void 0 ? _a : LogLevel.verbose;
     }
     getBaseUrl(environment) {
         const urlBasedOnEnv = API_ENVIRONMENT_TO_BASE_URL_MAP[environment !== null && environment !== void 0 ? environment : Environment.production];

package/dist/esm/internal/api/index.js

@@ -1,2 +1,3 @@
 export { Environment } from './environment';
 export { convertToSnakeCase } from './case-helpers';
+export { LogLevel } from './log-level';

package/dist/esm/internal/api/log-level.js

@@ -0,0 +1,7 @@
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel["verbose"] = "verbose";
+    LogLevel["warn"] = "warn";
+    LogLevel["error"] = "error";
+    LogLevel["none"] = "none";
+})(LogLevel || (LogLevel = {}));

package/dist/esm/internal/base/logger.js

@@ -1,12 +1,31 @@
+import { LogLevel } from '../api';
 export class Logger {
+    static shouldLog(level) {
+        switch (Logger.logLevel) {
+            case LogLevel.verbose:
+                return level !== LogLevel.none;
+            case LogLevel.warn:
+                return level === LogLevel.warn || level === LogLevel.error;
+            case LogLevel.error:
+                return level === LogLevel.error;
+            default:
+                return false;
+        }
+    }
     static log(...args) {
-        console.log('[Paddle] [LOG]', ...args);
+        if (Logger.shouldLog(LogLevel.verbose)) {
+            console.log('[Paddle] [LOG]', ...args);
+        }
     }
     static warn(...args) {
-        console.warn('[Paddle] [WARN]', ...args);
+        if (Logger.shouldLog(LogLevel.warn)) {
+            console.warn('[Paddle] [WARN]', ...args);
+        }
     }
     static error(...args) {
-        console.error('[Paddle] [ERROR]', ...args);
+        if (Logger.shouldLog(LogLevel.error)) {
+            console.error('[Paddle] [ERROR]', ...args);
+        }
     }
     static logRequest(method, url, headers) {
         Logger.log('[Request]', method, url, 'Transaction ID:', headers['X-Transaction-ID']);

package/dist/esm/paddle.js

@@ -1,12 +1,13 @@
 import { Client } from './internal/api/client';
 import { AddressesResource, AdjustmentsResource, BusinessesResource, CustomersResource, DiscountsResource, EventTypesResource, NotificationSettingsResource, NotificationsResource, PricesResource, PricingPreviewResource, ProductsResource, ReportsResource, SubscriptionsResource, TransactionsResource, } from './resources';
-import { Environment } from './internal';
+import { Environment, LogLevel } from './internal';
 import { EventsResource } from './resources/events';
 import { Webhooks } from './notifications';
 export class Paddle {
     constructor(apiKey, options) {
         this.defaultPaddleOptions = {
             environment: Environment.production,
+            logLevel: LogLevel.verbose,
         };
         this.client = new Client(apiKey, options ? Object.assign(Object.assign({}, this.defaultPaddleOptions), options) : Object.assign({}, this.defaultPaddleOptions));
         this.products = new ProductsResource(this.client);

package/dist/esm/version.js

@@ -1 +1 @@
-export const SDK_VERSION = '1.3.0';
+export const SDK_VERSION = '1.4.0';

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export { Environment, ApiError, type PaddleOptions } from './internal';
+export { Environment, LogLevel, ApiError, type PaddleOptions } from './internal';
 export { SDK_VERSION } from './version';
 export { Paddle } from './paddle';
 export * from './entities';

package/dist/types/internal/api/index.d.ts

@@ -1,2 +1,3 @@
 export { Environment } from './environment';
 export { convertToSnakeCase } from './case-helpers';
+export { LogLevel } from './log-level';

package/dist/types/internal/api/log-level.d.ts

@@ -0,0 +1,6 @@
+export declare enum LogLevel {
+    verbose = "verbose",
+    warn = "warn",
+    error = "error",
+    none = "none"
+}

package/dist/types/internal/base/logger.d.ts

@@ -1,6 +1,9 @@
 import { type Response } from 'node-fetch';
+import { LogLevel } from '../api';
 type LogInputProps = Array<string | undefined | null>;
 export declare class Logger {
+    static logLevel: LogLevel;
+    private static shouldLog;
     static log(...args: LogInputProps): void;
     static warn(...args: LogInputProps): void;
     static error(...args: LogInputProps): void;

package/dist/types/internal/types/config.d.ts

@@ -1,4 +1,5 @@
-import { type Environment } from '../api';
+import { type Environment, type LogLevel } from '../api';
 export interface PaddleOptions {
     environment?: Environment;
+    logLevel?: LogLevel;
 }

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.3.0";
+export declare const SDK_VERSION = "1.4.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paddle/paddle-node-sdk",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "A Node.js SDK that you can use to integrate Paddle Billing with applications written in server-side JavaScript.",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",