@izak0s/mplusqapi-node 1.1.0 → 1.1.1

package/README.md

@@ -177,22 +177,28 @@ The same field name (e.g. `priceIncl`) can be a `string` on one type and a `numb
 
 ### Dates
 
-`SoapMplusDateTime` response fields are deserialized to `Date` objects. Pass `Date` objects for request fields that accept dates.
+The API has two date structs, handled differently:
 
-The API sends/expects **wall-clock** date structs (year/mon/day/hour/min/sec) with no embedded offset on date-only fields. These are interpreted in the client's configured `timezone` (default `Europe/Amsterdam`) when converting to/from JS `Date` (which is an absolute UTC instant):
+**`SoapMplusDateTime`** (full timestamp) — carries its own UTC offset (`timezone`, in minutes). Deserialized to an exact `Date` using that offset, independent of host or config:
 
 ```typescript
-const client = new MplusKassaClient({ /* ...host/port/auth... */, timezone: 'Europe/Amsterdam' });
+// struct { year:2026, mon:6, day:12, hour:13, min:45, sec:30, timezone:120 }
+// -> 2026-06-12T11:45:30.000Z   (exact instant; +120 min == +02:00)
+```
+
+If a `SoapMplusDateTime` ever omits its offset, the client's configured `timezone` (default `Europe/Amsterdam`) is used as a fallback to interpret the wall-clock. The configured zone is also used when **serializing** outbound timestamps (to fill `timezone`/`isdst`).
 
-// financialDate "2018-06-18" deserializes to midnight Amsterdam time,
-// i.e. the instant 2018-06-17T22:00:00.000Z (summer, +02:00).
-// Print it in the configured zone to see the intended calendar date:
-console.log(order.financialDate?.toLocaleDateString('nl-NL', { timeZone: 'Europe/Amsterdam' }));
+**`SoapMplusDate`** (calendar date, e.g. `financialDate`) — has only day/mon/year, no time and no offset. Deserialized to **UTC midnight**, so it reads as the intended calendar date with no off-by-one:
+
+```typescript
+// struct { year:2018, mon:6, day:18 }  ->  2018-06-18T00:00:00.000Z
+order.financialDate?.toISOString().slice(0, 10);   // '2018-06-18'
+order.financialDate?.getUTCDate();                 // 18
 ```
 
-A `Date` logged directly prints in UTC, so a local midnight shows as `...T22:00:00.000Z` the previous day — that's correct, just rendered in UTC. Format with the matching `timeZone` to avoid confusion.
+> Read date-only fields with the **UTC** accessors (`getUTCFullYear/Month/Date`) or `.toISOString().slice(0, 10)` — not `getDate()`/`toLocaleDateString()`, which shift by your host's zone. When **sending** a date-only field, build a UTC-midnight `Date`: `new Date('2018-06-18')` or `new Date(Date.UTC(y, m - 1, d))`.
 
-> **Note:** the timezone is process-wide — constructing multiple clients with different `timezone` values in one process is not supported. `setTimeZone(tz)` / `getTimeZone()` are also exported for direct control.
+> **Note:** the configured `timezone` is process-wide — constructing multiple clients with different `timezone` values in one process is not supported. `setTimeZone(tz)` / `getTimeZone()` are also exported for direct control.
 
 ### List fields
 
@@ -279,7 +285,7 @@ npm version patch   # or minor / major — bumps package.json, commits, tags
 git push --follow-tags
 ```
 
-The tag triggers `.github/workflows/publish.yml`: gate on `npm run check`, publish to npm via [trusted publishing](https://docs.npmjs.com/trusted-publishers) (OIDC, no token), and create a GitHub release with generated notes. The workflow refuses to publish if the tag doesn't match `package.json`.
+The tag triggers `.github/workflows/publish.yml`: it first runs the full CI workflow (lint, build, type-check, tests across the Node matrix, pack check) as a gate, then — only if CI passes — publishes to npm via [trusted publishing](https://docs.npmjs.com/trusted-publishers) (OIDC, no token) and creates a GitHub release with generated notes. The workflow refuses to publish if the tag doesn't match `package.json`.
 
 ### Run the example
 

package/dist/index.js

@@ -218,30 +218,26 @@ function serializeDateTime(elemName, value) {
   return `<${NS_PREFIX}:${elemName}><${NS_PREFIX}:sec>${p.sec}</${NS_PREFIX}:sec><${NS_PREFIX}:min>${p.min}</${NS_PREFIX}:min><${NS_PREFIX}:hour>${p.hour}</${NS_PREFIX}:hour><${NS_PREFIX}:day>${p.day}</${NS_PREFIX}:day><${NS_PREFIX}:mon>${p.mon}</${NS_PREFIX}:mon><${NS_PREFIX}:year>${p.year}</${NS_PREFIX}:year><${NS_PREFIX}:isdst>${isDstAt(value.getTime(), tz)}</${NS_PREFIX}:isdst><${NS_PREFIX}:timezone>${tzOffset}</${NS_PREFIX}:timezone></${NS_PREFIX}:${elemName}>`;
 }
 function serializeDate(elemName, value) {
-  const p = zonedPartsOf(value, activeTimeZone);
-  return `<${NS_PREFIX}:${elemName}><${NS_PREFIX}:day>${p.day}</${NS_PREFIX}:day><${NS_PREFIX}:mon>${p.mon}</${NS_PREFIX}:mon><${NS_PREFIX}:year>${p.year}</${NS_PREFIX}:year></${NS_PREFIX}:${elemName}>`;
+  return `<${NS_PREFIX}:${elemName}><${NS_PREFIX}:day>${value.getUTCDate()}</${NS_PREFIX}:day><${NS_PREFIX}:mon>${value.getUTCMonth() + 1}</${NS_PREFIX}:mon><${NS_PREFIX}:year>${value.getUTCFullYear()}</${NS_PREFIX}:year></${NS_PREFIX}:${elemName}>`;
 }
 function deserializeDateTime(obj) {
-  return zonedToUtc(
-    Number(obj["year"]),
-    Number(obj["mon"]),
-    Number(obj["day"]),
-    Number(obj["hour"]),
-    Number(obj["min"]),
-    Number(obj["sec"]),
-    activeTimeZone
-  );
+  const year = Number(obj["year"]);
+  const mon = Number(obj["mon"]);
+  const day = Number(obj["day"]);
+  const hour = Number(obj["hour"]);
+  const min = Number(obj["min"]);
+  const sec = Number(obj["sec"]);
+  const tzRaw = obj["timezone"];
+  if (tzRaw !== void 0 && tzRaw !== null && tzRaw !== "") {
+    const offsetMin = Number(tzRaw);
+    if (!Number.isNaN(offsetMin)) {
+      return new Date(Date.UTC(year, mon - 1, day, hour, min, sec) - offsetMin * 6e4);
+    }
+  }
+  return zonedToUtc(year, mon, day, hour, min, sec, activeTimeZone);
 }
 function deserializeDate(obj) {
-  return zonedToUtc(
-    Number(obj["year"]),
-    Number(obj["mon"]),
-    Number(obj["day"]),
-    0,
-    0,
-    0,
-    activeTimeZone
-  );
+  return new Date(Date.UTC(Number(obj["year"]), Number(obj["mon"]) - 1, Number(obj["day"])));
 }
 function toArray(val) {
   if (val === void 0 || val === null) return [];

package/dist/index.mjs

@@ -172,30 +172,26 @@ function serializeDateTime(elemName, value) {
   return `<${NS_PREFIX}:${elemName}><${NS_PREFIX}:sec>${p.sec}</${NS_PREFIX}:sec><${NS_PREFIX}:min>${p.min}</${NS_PREFIX}:min><${NS_PREFIX}:hour>${p.hour}</${NS_PREFIX}:hour><${NS_PREFIX}:day>${p.day}</${NS_PREFIX}:day><${NS_PREFIX}:mon>${p.mon}</${NS_PREFIX}:mon><${NS_PREFIX}:year>${p.year}</${NS_PREFIX}:year><${NS_PREFIX}:isdst>${isDstAt(value.getTime(), tz)}</${NS_PREFIX}:isdst><${NS_PREFIX}:timezone>${tzOffset}</${NS_PREFIX}:timezone></${NS_PREFIX}:${elemName}>`;
 }
 function serializeDate(elemName, value) {
-  const p = zonedPartsOf(value, activeTimeZone);
-  return `<${NS_PREFIX}:${elemName}><${NS_PREFIX}:day>${p.day}</${NS_PREFIX}:day><${NS_PREFIX}:mon>${p.mon}</${NS_PREFIX}:mon><${NS_PREFIX}:year>${p.year}</${NS_PREFIX}:year></${NS_PREFIX}:${elemName}>`;
+  return `<${NS_PREFIX}:${elemName}><${NS_PREFIX}:day>${value.getUTCDate()}</${NS_PREFIX}:day><${NS_PREFIX}:mon>${value.getUTCMonth() + 1}</${NS_PREFIX}:mon><${NS_PREFIX}:year>${value.getUTCFullYear()}</${NS_PREFIX}:year></${NS_PREFIX}:${elemName}>`;
 }
 function deserializeDateTime(obj) {
-  return zonedToUtc(
-    Number(obj["year"]),
-    Number(obj["mon"]),
-    Number(obj["day"]),
-    Number(obj["hour"]),
-    Number(obj["min"]),
-    Number(obj["sec"]),
-    activeTimeZone
-  );
+  const year = Number(obj["year"]);
+  const mon = Number(obj["mon"]);
+  const day = Number(obj["day"]);
+  const hour = Number(obj["hour"]);
+  const min = Number(obj["min"]);
+  const sec = Number(obj["sec"]);
+  const tzRaw = obj["timezone"];
+  if (tzRaw !== void 0 && tzRaw !== null && tzRaw !== "") {
+    const offsetMin = Number(tzRaw);
+    if (!Number.isNaN(offsetMin)) {
+      return new Date(Date.UTC(year, mon - 1, day, hour, min, sec) - offsetMin * 6e4);
+    }
+  }
+  return zonedToUtc(year, mon, day, hour, min, sec, activeTimeZone);
 }
 function deserializeDate(obj) {
-  return zonedToUtc(
-    Number(obj["year"]),
-    Number(obj["mon"]),
-    Number(obj["day"]),
-    0,
-    0,
-    0,
-    activeTimeZone
-  );
+  return new Date(Date.UTC(Number(obj["year"]), Number(obj["mon"]) - 1, Number(obj["day"])));
 }
 function toArray(val) {
   if (val === void 0 || val === null) return [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@izak0s/mplusqapi-node",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "TypeScript client for the MplusKASSA SOAP API",
   "homepage": "https://github.com/izak0s/mplusqapi-node#readme",
   "bugs": {