@kerekit/magyar-posta-partner-extra 0.1.0

package/.nvmrc

@@ -0,0 +1 @@
+v24

package/dist/main.d.ts

@@ -0,0 +1,10 @@
+export type ZipCode = {
+    city: string;
+    code: string;
+    timeWindowId: string;
+};
+export declare function zipCodes(): Promise<{
+    timestamp: Date;
+    zipCodes: ZipCode[];
+}>;
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,wBAAsB,QAAQ;;cAmBnB,OAAO,EAAE;GAGnB"}

package/dist/main.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zipCodes = zipCodes;
+const fast_xml_parser_1 = require("fast-xml-parser");
+const ROOT = 'http://httpmegosztas.posta.hu/PartnerExtra/Out';
+const xmlParser = new fast_xml_parser_1.XMLParser({
+    attributeNamePrefix: '@',
+    ignoreAttributes: false,
+    parseAttributeValue: false,
+    parseTagValue: false,
+});
+async function zipCodes() {
+    const url = `${ROOT}/ZipCodes.xml`;
+    const res = await fetch(url);
+    if (!res.ok) {
+        throw new Error(`Request to URL ${url} failed with HTTP status ${res.status}`);
+    }
+    const body = await res.text();
+    const xml = xmlParser.parse(body);
+    const timestampStr = xml.zipCodes['@timestamp'];
+    const timestamp = new Date(timestampStr);
+    if (isNaN(timestamp.getTime())) {
+        throw new Error(`Invalid timestamp: ${timestampStr}`);
+    }
+    const data = {
+        timestamp,
+        zipCodes: xml.zipCodes.zipCode.map((zipCode) => ({
+            city: zipCode.city,
+            code: zipCode.Code,
+            timeWindowId: zipCode.TimeWindowID,
+        })),
+    };
+    return data;
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";;AAiBA,4BAsBC;AAvCD,qDAA2C;AAE3C,MAAM,IAAI,GAAG,gDAAgD,CAAA;AAE7D,MAAM,SAAS,GAAG,IAAI,2BAAS,CAAC;IAC9B,mBAAmB,EAAG,GAAG;IACzB,gBAAgB,EAAE,KAAK;IACvB,mBAAmB,EAAE,KAAK;IAC1B,aAAa,EAAE,KAAK;CACrB,CAAC,CAAA;AAQK,KAAK,UAAU,QAAQ;IAC5B,MAAM,GAAG,GAAG,GAAG,IAAI,eAAe,CAAA;IAClC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IAC5B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,4BAA4B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;IAChF,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;IAC7B,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACjC,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;IAC/C,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,CAAA;IACxC,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,sBAAsB,YAAY,EAAE,CAAC,CAAA;IACvD,CAAC;IACD,MAAM,IAAI,GAAG;QACX,SAAS;QACT,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAY,EAAE,EAAE,CAAC,CAAC;YACpD,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC,CAAc;KACjB,CAAA;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@kerekit/magyar-posta-partner-extra",
+  "version": "0.1.0",
+  "description": "Library for fetching data from Magyar Posta Partner Extra service",
+  "main": "dist/main.js",
+  "types": "dist/main.d.ts",
+  "author": "Márton Tamás <marton.tamas@webhelyesarcu.hu>",
+  "license": "ISC",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2",
+    "vitest": "^4.1.9"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "fast-xml-parser": "^5.9.3"
+  }
+}

package/src/main.ts

@@ -0,0 +1,40 @@
+import { XMLParser } from 'fast-xml-parser'
+
+const ROOT = 'http://httpmegosztas.posta.hu/PartnerExtra/Out'
+
+const xmlParser = new XMLParser({
+  attributeNamePrefix : '@',
+  ignoreAttributes: false,
+  parseAttributeValue: false,
+  parseTagValue: false,
+})
+
+export type ZipCode = {
+  city: string
+  code: string
+  timeWindowId: string
+}
+
+export async function zipCodes() {
+  const url = `${ROOT}/ZipCodes.xml`
+  const res = await fetch(url)
+  if (!res.ok) {
+    throw new Error(`Request to URL ${url} failed with HTTP status ${res.status}`)
+  }
+  const body = await res.text()
+  const xml = xmlParser.parse(body)
+  const timestampStr = xml.zipCodes['@timestamp']
+  const timestamp = new Date(timestampStr)
+  if (isNaN(timestamp.getTime())) {
+    throw new Error(`Invalid timestamp: ${timestampStr}`)
+  }
+  const data = {
+    timestamp,
+    zipCodes: xml.zipCodes.zipCode.map((zipCode: any) => ({
+      city: zipCode.city,
+      code: zipCode.Code,
+      timeWindowId: zipCode.TimeWindowID,
+    })) as ZipCode[],
+  }
+  return data
+}

package/test/zipCodes.test.js

@@ -0,0 +1,26 @@
+import { describe, it, expect, beforeAll } from 'vitest'
+import posta from '../dist/main.js'
+
+describe('zipCodes', async () => {
+  let timestamp
+  let zipCodes
+
+  beforeAll(async () => {
+    ({ timestamp, zipCodes } = await posta.zipCodes())
+  })
+
+  test('Has valid timestamp', () => {
+    expect(timestamp).toBeInstanceOf(Date)
+    expect(timestamp.getTime()).not.toBeNaN()
+  })
+
+  test('Has valid zipCode objects', () => {
+    for (const zipCode of zipCodes) {
+      expect(zipCode.city).toBeTypeOf('string')
+      expect(zipCode.city).toBeTruthy()
+      expect(zipCode.code).toBeTypeOf('string')
+      expect(zipCode.code).toBeTruthy()
+      expect(zipCode.timeWindowId).toBeTypeOf('string')
+    }
+  })
+})

package/tsconfig.json

@@ -0,0 +1,32 @@
+{
+  "compilerOptions": {
+    "rootDir": "./src",
+    "outDir": "./dist",
+
+    "module": "nodenext",
+    "target": "esnext",
+    "lib": ["esnext"],
+    "types": ["node"],
+
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+
+    "noImplicitReturns": true,
+    "noImplicitOverride": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noPropertyAccessFromIndexSignature": true,
+
+    "strict": true,
+    "jsx": "react-jsx",
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "skipLibCheck": true
+  }
+}