@dpayglobal/dpay-node-sdk 0.1.0

package/dist/testing.js

@@ -0,0 +1,54 @@
+import { ApiResponse, phpJsonEncode } from './chunk-SPQCX4N4.js';
+
+// src/testing.ts
+var MockHttpClient = class {
+  /** Every request the SDK made, in order. */
+  requests = [];
+  queued = [];
+  /** Queues a prepared response. */
+  queue(response) {
+    this.queued.push(response);
+  }
+  /** Queues a JSON response, encoded the same way the SDK encodes bodies. */
+  queueJson(status, body, headers = {}) {
+    this.queue(
+      new ApiResponse(status, { "content-type": "application/json", ...headers }, phpJsonEncode(body))
+    );
+  }
+  /** Queues a plain text response. */
+  queueText(status, body, headers = {}) {
+    this.queue(new ApiResponse(status, headers, body));
+  }
+  request(request) {
+    this.requests.push(request);
+    const response = this.queued.shift();
+    if (response === void 0) return Promise.reject(new Error("MockHttpClient queue is empty"));
+    return Promise.resolve(response);
+  }
+  /** The most recent request. Throws when nothing was recorded. */
+  get lastRequest() {
+    const request = this.requests.at(-1);
+    if (request === void 0) throw new Error("No requests recorded");
+    return request;
+  }
+  /** The most recent request body, decoded. Throws when it was not a JSON object. */
+  get lastRequestBody() {
+    const body = this.lastRequest.body;
+    let decoded = null;
+    if (body !== null) {
+      try {
+        decoded = JSON.parse(body);
+      } catch {
+        decoded = null;
+      }
+    }
+    if (typeof decoded !== "object" || decoded === null || Array.isArray(decoded)) {
+      throw new Error("Last request has no JSON object body");
+    }
+    return decoded;
+  }
+};
+
+export { MockHttpClient };
+//# sourceMappingURL=testing.js.map
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing.ts"],"names":[],"mappings":";;;AAKO,IAAM,iBAAN,MAA2C;AAAA;AAAA,EAEvC,WAAyB,EAAC;AAAA,EAClB,SAAwB,EAAC;AAAA;AAAA,EAG1C,MAAM,QAAA,EAA6B;AACjC,IAAA,IAAA,CAAK,MAAA,CAAO,KAAK,QAAQ,CAAA;AAAA,EAC3B;AAAA;AAAA,EAGA,SAAA,CAAU,MAAA,EAAgB,IAAA,EAAe,OAAA,GAA4C,EAAC,EAAS;AAC7F,IAAA,IAAA,CAAK,KAAA;AAAA,MACH,IAAI,WAAA,CAAY,MAAA,EAAQ,EAAE,cAAA,EAAgB,kBAAA,EAAoB,GAAG,OAAA,EAAQ,EAAG,aAAA,CAAc,IAAI,CAAC;AAAA,KACjG;AAAA,EACF;AAAA;AAAA,EAGA,SAAA,CAAU,MAAA,EAAgB,IAAA,EAAc,OAAA,GAA4C,EAAC,EAAS;AAC5F,IAAA,IAAA,CAAK,MAAM,IAAI,WAAA,CAAY,MAAA,EAAQ,OAAA,EAAS,IAAI,CAAC,CAAA;AAAA,EACnD;AAAA,EAEA,QAAQ,OAAA,EAA2C;AACjD,IAAA,IAAA,CAAK,QAAA,CAAS,KAAK,OAAO,CAAA;AAC1B,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,MAAA,CAAO,KAAA,EAAM;AACnC,IAAA,IAAI,QAAA,KAAa,QAAW,OAAO,OAAA,CAAQ,OAAO,IAAI,KAAA,CAAM,+BAA+B,CAAC,CAAA;AAC5F,IAAA,OAAO,OAAA,CAAQ,QAAQ,QAAQ,CAAA;AAAA,EACjC;AAAA;AAAA,EAGA,IAAI,WAAA,GAA0B;AAC5B,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,QAAA,CAAS,EAAA,CAAG,EAAE,CAAA;AACnC,IAAA,IAAI,OAAA,KAAY,MAAA,EAAW,MAAM,IAAI,MAAM,sBAAsB,CAAA;AACjE,IAAA,OAAO,OAAA;AAAA,EACT;AAAA;AAAA,EAGA,IAAI,eAAA,GAA2C;AAC7C,IAAA,MAAM,IAAA,GAAO,KAAK,WAAA,CAAY,IAAA;AAC9B,IAAA,IAAI,OAAA,GAAmB,IAAA;AACvB,IAAA,IAAI,SAAS,IAAA,EAAM;AACjB,MAAA,IAAI;AACF,QAAA,OAAA,GAAU,IAAA,CAAK,MAAM,IAAI,CAAA;AAAA,MAC3B,CAAA,CAAA,MAAQ;AACN,QAAA,OAAA,GAAU,IAAA;AAAA,MACZ;AAAA,IACF;AACA,IAAA,IAAI,OAAO,YAAY,QAAA,IAAY,OAAA,KAAY,QAAQ,KAAA,CAAM,OAAA,CAAQ,OAAO,CAAA,EAAG;AAC7E,MAAA,MAAM,IAAI,MAAM,sCAAsC,CAAA;AAAA,IACxD;AACA,IAAA,OAAO,OAAA;AAAA,EACT;AACF","file":"testing.js","sourcesContent":["import { ApiResponse } from './http/types.js'\nimport type { ApiRequest, HttpClient } from './http/types.js'\nimport { phpJsonEncode } from './internal/php.js'\n\n/** In-memory transport for testing an integration without network access. */\nexport class MockHttpClient implements HttpClient {\n  /** Every request the SDK made, in order. */\n  readonly requests: ApiRequest[] = []\n  private readonly queued: ApiResponse[] = []\n\n  /** Queues a prepared response. */\n  queue(response: ApiResponse): void {\n    this.queued.push(response)\n  }\n\n  /** Queues a JSON response, encoded the same way the SDK encodes bodies. */\n  queueJson(status: number, body: unknown, headers: Readonly<Record<string, string>> = {}): void {\n    this.queue(\n      new ApiResponse(status, { 'content-type': 'application/json', ...headers }, phpJsonEncode(body)),\n    )\n  }\n\n  /** Queues a plain text response. */\n  queueText(status: number, body: string, headers: Readonly<Record<string, string>> = {}): void {\n    this.queue(new ApiResponse(status, headers, body))\n  }\n\n  request(request: ApiRequest): Promise<ApiResponse> {\n    this.requests.push(request)\n    const response = this.queued.shift()\n    if (response === undefined) return Promise.reject(new Error('MockHttpClient queue is empty'))\n    return Promise.resolve(response)\n  }\n\n  /** The most recent request. Throws when nothing was recorded. */\n  get lastRequest(): ApiRequest {\n    const request = this.requests.at(-1)\n    if (request === undefined) throw new Error('No requests recorded')\n    return request\n  }\n\n  /** The most recent request body, decoded. Throws when it was not a JSON object. */\n  get lastRequestBody(): Record<string, unknown> {\n    const body = this.lastRequest.body\n    let decoded: unknown = null\n    if (body !== null) {\n      try {\n        decoded = JSON.parse(body)\n      } catch {\n        decoded = null\n      }\n    }\n    if (typeof decoded !== 'object' || decoded === null || Array.isArray(decoded)) {\n      throw new Error('Last request has no JSON object body')\n    }\n    return decoded as Record<string, unknown>\n  }\n}\n"]}

package/dist/types-CGcSNriz.d.cts

@@ -0,0 +1,48 @@
+/** A single outbound HTTP request built by the SDK. */
+interface ApiRequest {
+    readonly method: 'GET' | 'POST';
+    readonly url: string;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body: string | null;
+    readonly signal?: AbortSignal;
+}
+/** A raw HTTP response handed back to the SDK. */
+declare class ApiResponse {
+    readonly status: number;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body: string;
+    constructor(status: number, headers: Readonly<Record<string, string>>, body: string);
+    /**
+     * Retrieve the response header value by name, performing a case-insensitive lookup.
+     * Returns `null` if the header was not present in the response.
+     */
+    getHeader(name: string): string | null;
+    /**
+     * Attempt to decode the response body as JSON, returning the parsed value if it is a
+     * plain object or array, or `null` if the body is not valid JSON or the parsed value
+     * is a primitive (string, number, boolean, null).
+     */
+    decodeJson(): unknown;
+}
+/**
+ * Transport contract. Replace the default implementation to add proxying,
+ * retries or request recording in tests.
+ *
+ * Critical invariant: the `request()` method must resolve to an `ApiResponse` for
+ * every response the server actually sent, including 4xx and 5xx status codes.
+ * It must reject with an error only when no response was obtained at all—that is,
+ * for a genuine transport failure such as a connection reset, timeout, or abort.
+ *
+ * If your implementation rejects on 4xx or 5xx responses, the SDK will be unable
+ * to map the status code to its typed error classes, and the SDK's error handling
+ * will break silently.
+ */
+interface HttpClient {
+    /**
+     * Execute an HTTP request and return the server's response. Must resolve with
+     * an `ApiResponse` for every response, and reject only on transport failure.
+     */
+    request(request: ApiRequest): Promise<ApiResponse>;
+}
+
+export { ApiResponse as A, type HttpClient as H, type ApiRequest as a };

package/dist/types-CGcSNriz.d.ts

@@ -0,0 +1,48 @@
+/** A single outbound HTTP request built by the SDK. */
+interface ApiRequest {
+    readonly method: 'GET' | 'POST';
+    readonly url: string;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body: string | null;
+    readonly signal?: AbortSignal;
+}
+/** A raw HTTP response handed back to the SDK. */
+declare class ApiResponse {
+    readonly status: number;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body: string;
+    constructor(status: number, headers: Readonly<Record<string, string>>, body: string);
+    /**
+     * Retrieve the response header value by name, performing a case-insensitive lookup.
+     * Returns `null` if the header was not present in the response.
+     */
+    getHeader(name: string): string | null;
+    /**
+     * Attempt to decode the response body as JSON, returning the parsed value if it is a
+     * plain object or array, or `null` if the body is not valid JSON or the parsed value
+     * is a primitive (string, number, boolean, null).
+     */
+    decodeJson(): unknown;
+}
+/**
+ * Transport contract. Replace the default implementation to add proxying,
+ * retries or request recording in tests.
+ *
+ * Critical invariant: the `request()` method must resolve to an `ApiResponse` for
+ * every response the server actually sent, including 4xx and 5xx status codes.
+ * It must reject with an error only when no response was obtained at all—that is,
+ * for a genuine transport failure such as a connection reset, timeout, or abort.
+ *
+ * If your implementation rejects on 4xx or 5xx responses, the SDK will be unable
+ * to map the status code to its typed error classes, and the SDK's error handling
+ * will break silently.
+ */
+interface HttpClient {
+    /**
+     * Execute an HTTP request and return the server's response. Must resolve with
+     * an `ApiResponse` for every response, and reject only on transport failure.
+     */
+    request(request: ApiRequest): Promise<ApiResponse>;
+}
+
+export { ApiResponse as A, type HttpClient as H, type ApiRequest as a };

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@dpayglobal/dpay-node-sdk",
+  "version": "0.1.0",
+  "description": "Official dpay.pl Node.js SDK",
+  "license": "Apache-2.0",
+  "author": "dpay <kontakt@dpay.pl>",
+  "homepage": "https://dpay.pl",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dpayglobal/dpay-node-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/dpayglobal/dpay-node-sdk/issues"
+  },
+  "keywords": ["dpay", "payments", "blik", "cards", "sdk", "platnosci"],
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./testing": {
+      "import": {
+        "types": "./dist/testing.d.ts",
+        "default": "./dist/testing.js"
+      },
+      "require": {
+        "types": "./dist/testing.d.cts",
+        "default": "./dist/testing.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist", "README.md", "CHANGELOG.md", "LICENSE"],
+  "dependencies": {},
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.0",
+    "@biomejs/biome": "^1.9.0",
+    "@types/node": "^22.0.0",
+    "publint": "^0.3.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome check .",
+    "format": "biome check --write .",
+    "package:check": "npm run build && publint && attw --pack . --profile node16",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}