@bratislava/ginis-sdk 2.1.3 → 2.2.1

package/README.md

@@ -10,7 +10,7 @@ A small wrapper for most commonly used requests towards the GINIS system. Made t
 
 ## Using the library
 
-To understand how the structure of `Ginis` and `urls` part of the config relates to the GINIS system, read the [GINIS section](https://bratislava.github.io/GINIS) of our documentation site.
+To understand how the structure of `Ginis` and `urls` part of the config relates to the GINIS system, read the [GINIS section](./docs/GINIS.md) of our documentation site.
 
 You'll need the GINIS credentials. If interacting with the Bratislava deployment, you also need to be connected through VPN or on internal network.
 

package/dist/index.d.ts

@@ -191,7 +191,7 @@ declare const najdiEsuSchema: z.ZodObject<{
     Aktivita: z.ZodString;
 }, z.core.$strip>;
 declare const najdiEsuResponseSchema: z.ZodObject<{
-    'Najdi-esu': z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodDefault<z.ZodArray<z.ZodObject<{
+    'Najdi-esu': z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodObject<{
         'Id-esu': z.ZodString;
         'Typ-esu': z.ZodOptional<z.ZodString>;
         Nazev: z.ZodOptional<z.ZodString>;
@@ -262,7 +262,7 @@ declare const detailElPodaniResponseSchema: z.ZodObject<{
         'Spis-znacka': z.ZodOptional<z.ZodString>;
         Znacka: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
-    'Navazany-dokument': z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodDefault<z.ZodArray<z.ZodObject<{
+    'Navazany-dokument': z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodObject<{
         'Id-dokumentu': z.ZodString;
         Vec: z.ZodOptional<z.ZodString>;
         'Spis-znacka': z.ZodOptional<z.ZodString>;
@@ -506,7 +506,7 @@ declare const detailDokumentuResponseSchema$1: z.ZodObject<{
         'Datum-doruceni': z.ZodOptional<z.ZodString>;
         'Id-ds-odesilatele': z.ZodString;
     }, z.core.$strip>>;
-    'Historie-dokumentu': z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodDefault<z.ZodArray<z.ZodObject<{
+    'Historie-dokumentu': z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodObject<{
         'Id-dokumentu': z.ZodString;
         'Text-zmeny': z.ZodOptional<z.ZodString>;
         Poznamka: z.ZodOptional<z.ZodString>;
@@ -552,7 +552,7 @@ declare const detailDokumentuResponseSchema$1: z.ZodObject<{
         'Poradove-cislo-spisu': z.ZodString;
         'Doplnek-cj': z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
-    'Ssl-obsah-spis': z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodDefault<z.ZodArray<z.ZodObject<{
+    'Ssl-obsah-spis': z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodObject<{
         'Id-spisu': z.ZodString;
         'Id-vlozeneho-dokumentu': z.ZodString;
         'Poradove-cislo': z.ZodOptional<z.ZodString>;
@@ -580,7 +580,7 @@ declare const detailDokumentuResponseSchema$1: z.ZodObject<{
         'Id-zpusob-vyrizeni': z.ZodOptional<z.ZodString>;
         'Doplnek-cj': z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
-    'Prilohy-dokumentu': z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodDefault<z.ZodArray<z.ZodObject<{
+    'Prilohy-dokumentu': z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodObject<{
         'Poradove-cislo': z.ZodString;
         Titulek: z.ZodOptional<z.ZodString>;
         Popis: z.ZodOptional<z.ZodString>;
@@ -597,13 +597,13 @@ declare const detailDokumentuResponseSchema$1: z.ZodObject<{
         'Kategorie-prilohy-txt': z.ZodOptional<z.ZodString>;
         'Priznak-souboru-ro': z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>>;
-    'Souvisejici-dokumenty': z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodDefault<z.ZodArray<z.ZodObject<{
+    'Souvisejici-dokumenty': z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodObject<{
         'Typ-vazby': z.ZodString;
         'Id-dokumentu': z.ZodString;
         Poznamka: z.ZodOptional<z.ZodString>;
         'Id-agendy': z.ZodString;
     }, z.core.$strip>>>>;
-    Spisovna: z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodDefault<z.ZodArray<z.ZodObject<{
+    Spisovna: z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodObject<{
         'Stav-ulozeni-kod': z.ZodString;
         'Stav-ulozeni': z.ZodString;
         'Datum-skartace': z.ZodOptional<z.ZodString>;
@@ -704,7 +704,7 @@ declare const stavPrehleduSchema: z.ZodObject<{
     'Radku-celkem': z.ZodString;
 }, z.core.$strip>;
 declare const prehledDokumentuResponseSchema: z.ZodObject<{
-    'Prehled-dokumentu': z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodDefault<z.ZodArray<z.ZodObject<{
+    'Prehled-dokumentu': z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodObject<{
         'Id-dokumentu': z.ZodString;
         'Id-spisu': z.ZodString;
         'Priznak-spisu': z.ZodString;
@@ -995,7 +995,7 @@ declare const detailDokumentuResponseSchema: z.ZodObject<{
         'Celkova-castka-sml': z.ZodOptional<z.ZodString>;
         'Mena-sml': z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
-    'Soubory-dokumentu': z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodDefault<z.ZodArray<z.ZodObject<{
+    'Soubory-dokumentu': z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodObject<{
         'Id-souboru': z.ZodString;
         Nazev: z.ZodString;
         Velikost: z.ZodOptional<z.ZodString>;
@@ -1003,7 +1003,7 @@ declare const detailDokumentuResponseSchema: z.ZodObject<{
         Poznamka: z.ZodOptional<z.ZodString>;
         'Priznak-podpis': z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>>;
-    'Protistrany-sml': z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodDefault<z.ZodArray<z.ZodObject<{
+    'Protistrany-sml': z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodObject<{
         'Typ-protistrany': z.ZodOptional<z.ZodString>;
         Subjekt: z.ZodOptional<z.ZodString>;
         'Nazev-sub': z.ZodOptional<z.ZodString>;
@@ -1040,7 +1040,27 @@ declare const nacistSouborResponseSchema: z.ZodObject<{
 }, z.core.$strip>;
 type UdeNacistSouborNacistSoubor = z.infer<typeof nacistSouborSchema>;
 type UdeNacistSouborResponse = z.infer<typeof nacistSouborResponseSchema>;
+type UdeNacistSouborStream = Readable & {
+    response: Promise<UdeNacistSouborResponse>;
+};
 declare function nacistSoubor(this: Ginis, bodyObj: UdeNacistSouborRequest): Promise<UdeNacistSouborResponse>;
+/**
+ * Streaming variant downloading files from GINIS UDE (Úřední deska) service.
+ *
+ * **Why this exists:** The non-streaming version loads the entire SOAP XML
+ * response into memory, parses it with xml2js, then base64-decodes the file.
+ * For large files (50-200+ MB) this causes memory spikes of several GB
+ * (the base64 string + parsed object + decoded buffer all coexist in memory).
+ *
+ * `UdeNacistSouborResponse` is exposed via a promise in `response` attribute.
+ * The attribute `Data` in the response will always have value "placeholder",
+ * as the actual data will be available in the readable stream instead.
+ *
+ * @param bodyObj - Request parameters. See `UdeNacistSouborRequest` type for details.
+ * @returns Stream of decoded binary data with response data available in `response` attribute.
+ * @throws {GinisError} on network errors, SOAP faults, or malformed responses.
+ */
+declare function nacistSouborStream(this: Ginis, bodyObj: UdeNacistSouborRequest): Promise<UdeNacistSouborStream>;
 
 /**
  * Full docs: https://robot.gordic.cz/xrg/Default.html?c=OpenMethodDetail&moduleName=UDE&version=390&methodName=seznam-dokumentu&type=request
@@ -1121,7 +1141,7 @@ declare const dokumentySchema: z.ZodObject<{
     'Datum-zmeny': z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 declare const seznamDokumentuResponseSchema: z.ZodObject<{
-    'Seznam-dokumentu': z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodDefault<z.ZodArray<z.ZodObject<{
+    'Seznam-dokumentu': z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodObject<{
         'Id-zaznamu': z.ZodString;
         Stav: z.ZodOptional<z.ZodString>;
         Kategorie: z.ZodString;
@@ -1164,11 +1184,11 @@ declare const seznamDokumentuResponseSchema: z.ZodObject<{
         'Celkova-castka-sml': z.ZodOptional<z.ZodString>;
         'Mena-sml': z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>>;
-    'Sejmute-dokumenty': z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodDefault<z.ZodArray<z.ZodObject<{
+    'Sejmute-dokumenty': z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodObject<{
         'Id-zaznamu': z.ZodOptional<z.ZodString>;
         'Datum-zmeny': z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>>;
-    'Zrusene-dokumenty': z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodDefault<z.ZodArray<z.ZodObject<{
+    'Zrusene-dokumenty': z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodObject<{
         'Id-zaznamu': z.ZodOptional<z.ZodString>;
         'Datum-zmeny': z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>>;
@@ -1194,7 +1214,7 @@ declare const seznamKategoriiSchema: z.ZodObject<{
     'Pocet-archiv': z.ZodString;
 }, z.core.$strip>;
 declare const seznamKategoriiResponseSchema: z.ZodObject<{
-    'Seznam-kategorii': z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodDefault<z.ZodArray<z.ZodObject<{
+    'Seznam-kategorii': z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodObject<{
         'Id-kategorie': z.ZodString;
         Nazev: z.ZodOptional<z.ZodString>;
         'Pocet-vyveseno': z.ZodString;
@@ -1208,6 +1228,7 @@ declare function seznamKategorii(this: Ginis, bodyObj: UdeSeznamKategoriiRequest
 declare const _default: {
     detailDokumentu: typeof detailDokumentu;
     nacistSoubor: typeof nacistSoubor;
+    nacistSouborStream: typeof nacistSouborStream;
     seznamDokumentu: typeof seznamDokumentu;
     seznamDokumentuFilterArchiv: typeof seznamDokumentuFilterArchiv;
     seznamKategorii: typeof seznamKategorii;
@@ -1267,4 +1288,4 @@ declare class GinisError extends Error {
     constructor(message: string, axiosError?: AxiosError);
 }
 
-export { type GinDetailFunkcnihoMistaDetailFunkcnihoMista, type GinDetailFunkcnihoMistaRequest, type GinDetailFunkcnihoMistaResponse, type GinDetailReferentaDetailReferenta, type GinDetailReferentaRequest, type GinDetailReferentaResponse, type GinEditEsuRequestVytvorEsu, type GinEditEsuResponse, type GinEditEsuVytvorEsu, type GinNajdiEsuNajdiEsuItem, type GinNajdiEsuRequest, type GinNajdiEsuResponse, Ginis, type GinisConfig, GinisError, type PodDetailElPodaniDetailElPodani, type PodDetailElPodaniNavazanyDokumentItem, type PodDetailElPodaniRequest, type PodDetailElPodaniResponse, type SslDetailDokumentuCjDokumentu, type SslDetailDokumentuDoruceni, type SslDetailDokumentuEDoruceni, type SslDetailDokumentuHistorieDokumentuItem, type SslDetailDokumentuPrilohyDokumentuItem, type SslDetailDokumentuRequest, type SslDetailDokumentuResponse, type SslDetailDokumentuSouvisejiciDokumentyItem, type SslDetailDokumentuSpisovnaItem, type SslDetailDokumentuSslDokument, type SslDetailDokumentuSslObsahSpisItem, type SslDetailDokumentuSslSpis, type SslDetailDokumentuVlozenoDoSpisu, type SslDetailDokumentuWflDokument, type SslNastavitVlastnostDokumentuNastavitVlastnostDokumentu, type SslNastavitVlastnostDokumentuRequest, type SslNastavitVlastnostDokumentuResponse, type SslPrehledDokumentuPrehledDokumentuItem, type SslPrehledDokumentuRequest, type SslPrehledDokumentuRequestRizeniPrehledu, type SslPrehledDokumentuResponse, type SslPrehledDokumentuStavPrehledu, type SslPridatSouborPridatSoubor, type SslPridatSouborRequest, type SslPridatSouborResponse, type SslPrideleniPrideleni, type SslPrideleniRequest, type SslPrideleniResponse, type SslZalozCjRequest, type SslZalozCjResponse, type SslZalozCjZalozCj, type SslZalozPisemnostRequestDoruceni, type SslZalozPisemnostRequestSslDokument, type SslZalozPisemnostRequestWflDokument, type SslZalozPisemnostResponse, type SslZalozPisemnostZalozPisemnost, type SslZalozitVlastnostDokumentuRequest, type SslZalozitVlastnostDokumentuResponse, type SslZalozitVlastnostDokumentuZalozitVlastnostDokumentu, type UdeDetailDokumentuDetailDokumentu, type UdeDetailDokumentuProtistranySmlItem, type UdeDetailDokumentuRequest, type UdeDetailDokumentuResponse, type UdeDetailDokumentuSouboryDokumentuItem, type UdeNacistSouborNacistSoubor, type UdeNacistSouborRequest, type UdeNacistSouborResponse, type UdeSeznamDokumentuRequest, type UdeSeznamDokumentuResponse, type UdeSeznamDokumentuSejmuteDokumentyItem, type UdeSeznamDokumentuSeznamDokumentuItem, type UdeSeznamDokumentuZruseneDokumentyItem, type UdeSeznamKategoriiRequest, type UdeSeznamKategoriiResponse, type UdeSeznamKategoriiSeznamKategoriiItem };
+export { type GinDetailFunkcnihoMistaDetailFunkcnihoMista, type GinDetailFunkcnihoMistaRequest, type GinDetailFunkcnihoMistaResponse, type GinDetailReferentaDetailReferenta, type GinDetailReferentaRequest, type GinDetailReferentaResponse, type GinEditEsuRequestVytvorEsu, type GinEditEsuResponse, type GinEditEsuVytvorEsu, type GinNajdiEsuNajdiEsuItem, type GinNajdiEsuRequest, type GinNajdiEsuResponse, Ginis, type GinisConfig, GinisError, type PodDetailElPodaniDetailElPodani, type PodDetailElPodaniNavazanyDokumentItem, type PodDetailElPodaniRequest, type PodDetailElPodaniResponse, type SslDetailDokumentuCjDokumentu, type SslDetailDokumentuDoruceni, type SslDetailDokumentuEDoruceni, type SslDetailDokumentuHistorieDokumentuItem, type SslDetailDokumentuPrilohyDokumentuItem, type SslDetailDokumentuRequest, type SslDetailDokumentuResponse, type SslDetailDokumentuSouvisejiciDokumentyItem, type SslDetailDokumentuSpisovnaItem, type SslDetailDokumentuSslDokument, type SslDetailDokumentuSslObsahSpisItem, type SslDetailDokumentuSslSpis, type SslDetailDokumentuVlozenoDoSpisu, type SslDetailDokumentuWflDokument, type SslNastavitVlastnostDokumentuNastavitVlastnostDokumentu, type SslNastavitVlastnostDokumentuRequest, type SslNastavitVlastnostDokumentuResponse, type SslPrehledDokumentuPrehledDokumentuItem, type SslPrehledDokumentuRequest, type SslPrehledDokumentuRequestRizeniPrehledu, type SslPrehledDokumentuResponse, type SslPrehledDokumentuStavPrehledu, type SslPridatSouborPridatSoubor, type SslPridatSouborRequest, type SslPridatSouborResponse, type SslPrideleniPrideleni, type SslPrideleniRequest, type SslPrideleniResponse, type SslZalozCjRequest, type SslZalozCjResponse, type SslZalozCjZalozCj, type SslZalozPisemnostRequestDoruceni, type SslZalozPisemnostRequestSslDokument, type SslZalozPisemnostRequestWflDokument, type SslZalozPisemnostResponse, type SslZalozPisemnostZalozPisemnost, type SslZalozitVlastnostDokumentuRequest, type SslZalozitVlastnostDokumentuResponse, type SslZalozitVlastnostDokumentuZalozitVlastnostDokumentu, type UdeDetailDokumentuDetailDokumentu, type UdeDetailDokumentuProtistranySmlItem, type UdeDetailDokumentuRequest, type UdeDetailDokumentuResponse, type UdeDetailDokumentuSouboryDokumentuItem, type UdeNacistSouborNacistSoubor, type UdeNacistSouborRequest, type UdeNacistSouborResponse, type UdeNacistSouborStream, type UdeSeznamDokumentuRequest, type UdeSeznamDokumentuResponse, type UdeSeznamDokumentuSejmuteDokumentyItem, type UdeSeznamDokumentuSeznamDokumentuItem, type UdeSeznamDokumentuZruseneDokumentyItem, type UdeSeznamKategoriiRequest, type UdeSeznamKategoriiResponse, type UdeSeznamKategoriiSeznamKategoriiItem };

package/dist/index.js

@@ -43,6 +43,8 @@ var import_zod = require("zod");
 
 // src/utils/api.ts
 var import_axios = __toESM(require("axios"));
+var import_stream = require("stream");
+var import_consumers = require("stream/consumers");
 
 // src/utils/errors.ts
 var GinisError = class extends Error {
@@ -77,7 +79,7 @@ async function makeAxiosRequest(axiosConfig, url, body, debug) {
     responseAxios = await import_axios.default.post(url, body, requestConfig);
   } catch (error) {
     if (!(0, import_axios.isAxiosError)(error)) {
-      throw makeResponseDetailError(error);
+      throw await makeResponseDetailError(error);
     }
     if (debug) {
       console.log("########### GINIS ERROR RESPONSE ###########");
@@ -86,7 +88,7 @@ async function makeAxiosRequest(axiosConfig, url, body, debug) {
       console.log("data: ", error.response?.data);
       console.log("########### GINIS RESPONSE END ###########");
     }
-    throw makeResponseDetailError(error, error.response?.data);
+    throw await makeResponseDetailError(error, error.response?.data);
   }
   if (debug) {
     console.log("########### GINIS RESPONSE ###########");
@@ -97,27 +99,36 @@ async function makeAxiosRequest(axiosConfig, url, body, debug) {
   }
   return responseAxios;
 }
-function makeResponseDetailError(error, responseData = null) {
+async function makeResponseDetailError(error, responseData = null) {
   if (!(error instanceof Error)) {
     return new GinisError(
       "Non-error passed to throwErrorFaultDetail in ginis-sdk. This should never happen."
     );
   }
-  const errorDetail = responseData != null && typeof responseData === "string" ? `${error.message}\r
-Error response details: ${responseData}` : error.message;
+  const responseText = await (async () => {
+    if (responseData instanceof import_stream.Readable) {
+      return await (0, import_consumers.text)(responseData);
+    }
+    if (typeof responseData === "string") {
+      return responseData;
+    }
+    return null;
+  })();
+  const errorDetail = responseText ? `${error.message}\r
+Error response details: ${responseText}` : error.message;
   if ((0, import_axios.isAxiosError)(error)) {
     return new GinisError(errorDetail, error);
   }
   return new GinisError(errorDetail);
 }
 
-// src/utils/request-util.ts
-var import_stream = require("stream");
+// src/utils/request-utils.ts
+var import_stream2 = require("stream");
 var import_xml2js = require("xml2js");
-function createXmlRequestConfig(requestName2, requestNamespace2) {
+function createXmlRequestConfig(requestName3, requestNamespace3) {
   return {
     headers: {
-      SOAPAction: `${requestNamespace2}/${requestName2}`,
+      SOAPAction: `${requestNamespace3}/${requestName3}`,
       "Content-Type": "text/xml; charset=utf-8"
     }
   };
@@ -170,13 +181,13 @@ function createXmlRequestBody(config, requestInfo) {
   </s:Body>
 </s:Envelope>`.replaceAll(/\s*(<[^>]+>)\s*/g, "$1");
 }
-async function extractResponseJson(responseXml, requestName2, responseSchema) {
+async function extractResponseJson(responseXml, requestName3, responseSchema) {
   try {
     const response = await (0, import_xml2js.parseStringPromise)(responseXml, {
       explicitArray: false,
       ignoreAttrs: true
     });
-    const xrgContent = response?.["s:Envelope"]?.["s:Body"]?.[`${requestName2}Response`]?.[`${requestName2}Result`]?.Xrg;
+    const xrgContent = response?.["s:Envelope"]?.["s:Body"]?.[`${requestName3}Response`]?.[`${requestName3}Result`]?.Xrg;
     return responseSchema.parse(xrgContent === "" ? {} : xrgContent);
   } catch (error) {
     const message = error instanceof Error ? `: ${error.toString()}` : "";
@@ -184,10 +195,10 @@ async function extractResponseJson(responseXml, requestName2, responseSchema) {
 Response: ${responseXml}`);
   }
 }
-function createMultipartRequestConfig(requestName2, requestNamespace2, boundary, requestContentId) {
+function createMultipartRequestConfig(requestName3, requestNamespace3, boundary, requestContentId) {
   return {
     headers: {
-      SOAPAction: `${requestNamespace2}/${requestName2}`,
+      SOAPAction: `${requestNamespace3}/${requestName3}`,
       "Content-Type": `multipart/related;type="application/xop+xml";boundary="${boundary}";start="<${requestContentId}>";start-info="text/xml"`,
       "MIME-version": "1.0"
     }
@@ -213,7 +224,7 @@ Content-Type: application/octet-stream\r
 `;
   const closingBoundary = `\r
 --${boundary}--`;
-  const requestBody = new import_stream.PassThrough();
+  const requestBody = new import_stream2.PassThrough();
   requestBody.write(mainRequest);
   fileStream.pipe(requestBody, { end: false });
   fileStream.on("end", () => {
@@ -221,7 +232,7 @@ Content-Type: application/octet-stream\r
   });
   return requestBody;
 }
-async function extractMultipartResponseJson(responseString, requestName2, responseSchema) {
+async function extractMultipartResponseJson(responseString, requestName3, responseSchema) {
   const startTag = "<s:Envelope";
   const endTag = "</s:Envelope>";
   let responseXml;
@@ -237,7 +248,7 @@ async function extractMultipartResponseJson(responseString, requestName2, respon
 Response: ${responseString}`
     );
   }
-  return await extractResponseJson(responseXml, requestName2, responseSchema);
+  return await extractResponseJson(responseXml, requestName3, responseSchema);
 }
 
 // src/api/gin/Detail-funkcniho-mista.ts
@@ -279,22 +290,24 @@ var detailFunkcnihoMistaResponseSchema = import_zod.z.object({
 });
 async function detailFunkcnihoMista(bodyObj) {
   const url = this.config.urls.gin;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing GIN url in GINIS config");
-  const requestName2 = "Detail-funkcniho-mista";
-  const requestNamespace2 = "http://www.gordic.cz/svc/xrg-gin/v_1.0.0.0";
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing GIN url in GINIS config");
+  }
+  const requestName3 = "Detail-funkcniho-mista";
+  const requestNamespace3 = "http://www.gordic.cz/svc/xrg-gin/v_1.0.0.0";
   const response = await makeAxiosRequest(
-    createXmlRequestConfig(requestName2, requestNamespace2),
+    createXmlRequestConfig(requestName3, requestNamespace3),
     url,
     createXmlRequestBody(this.config, {
-      name: requestName2,
-      namespace: requestNamespace2,
+      name: requestName3,
+      namespace: requestNamespace3,
       xrgNamespace: "http://www.gordic.cz/xrg/gin/detail-funkcniho-mista/request/v_1.0.0.0",
       paramsBodies: [bodyObj],
       paramOrders: detailFunkcnihoMistaParamOrders
     }),
     this.config.debug
   );
-  return await extractResponseJson(response.data, requestName2, detailFunkcnihoMistaResponseSchema);
+  return await extractResponseJson(response.data, requestName3, detailFunkcnihoMistaResponseSchema);
 }
 
 // src/api/gin/Detail-referenta.ts
@@ -347,22 +360,24 @@ var detailReferentaResponseSchema = import_zod2.z.object({
 });
 async function detailReferenta(bodyObj) {
   const url = this.config.urls.gin;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing GIN url in GINIS config");
-  const requestName2 = "Detail-referenta";
-  const requestNamespace2 = "http://www.gordic.cz/svc/xrg-gin/v_1.0.0.0";
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing GIN url in GINIS config");
+  }
+  const requestName3 = "Detail-referenta";
+  const requestNamespace3 = "http://www.gordic.cz/svc/xrg-gin/v_1.0.0.0";
   const response = await makeAxiosRequest(
-    createXmlRequestConfig(requestName2, requestNamespace2),
+    createXmlRequestConfig(requestName3, requestNamespace3),
     url,
     createXmlRequestBody(this.config, {
-      name: requestName2,
-      namespace: requestNamespace2,
+      name: requestName3,
+      namespace: requestNamespace3,
       xrgNamespace: "http://www.gordic.cz/xrg/gin/detail-referenta/request/v_1.0.0.0",
       paramsBodies: [bodyObj],
       paramOrders: detailReferentaParamOrders
     }),
     this.config.debug
   );
-  return await extractResponseJson(response.data, requestName2, detailReferentaResponseSchema);
+  return await extractResponseJson(response.data, requestName3, detailReferentaResponseSchema);
 }
 
 // src/api/gin/Edit-esu.ts
@@ -436,22 +451,24 @@ var editEsuResponseSchema = import_zod3.z.object({
 });
 async function editEsu(bodyObj) {
   const url = this.config.urls.gin;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing GIN url in GINIS config");
-  const requestName2 = "Edit-esu";
-  const requestNamespace2 = "http://www.gordic.cz/svc/xrg-gin/v_1.0.0.0";
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing GIN url in GINIS config");
+  }
+  const requestName3 = "Edit-esu";
+  const requestNamespace3 = "http://www.gordic.cz/svc/xrg-gin/v_1.0.0.0";
   const response = await makeAxiosRequest(
-    createXmlRequestConfig(requestName2, requestNamespace2),
+    createXmlRequestConfig(requestName3, requestNamespace3),
     url,
     createXmlRequestBody(this.config, {
-      name: requestName2,
-      namespace: requestNamespace2,
+      name: requestName3,
+      namespace: requestNamespace3,
       xrgNamespace: "http://www.gordic.cz/xrg/gin/esu/vytvor-esu/request/v_1.0.0.0",
       paramsBodies: [bodyObj],
       paramOrders: editEsuParamOrders
     }),
     this.config.debug
   );
-  return await extractResponseJson(response.data, requestName2, editEsuResponseSchema);
+  return await extractResponseJson(response.data, requestName3, editEsuResponseSchema);
 }
 
 // src/api/gin/Najdi-esu.ts
@@ -461,7 +478,9 @@ var import_zod5 = require("zod");
 var import_zod4 = require("zod");
 function coercedArray(schema) {
   return import_zod4.z.preprocess((val) => {
-    if (val === void 0 || Array.isArray(val)) return val;
+    if (val === void 0 || Array.isArray(val)) {
+      return val;
+    }
     return schema.safeParse(val).success ? [val] : val;
   }, import_zod4.z.array(schema).default([]));
 }
@@ -556,22 +575,24 @@ var najdiEsuResponseSchema = import_zod5.z.object({
 });
 async function najdiEsu(requestNajdiEsu, requestRizeniPrehledu) {
   const url = this.config.urls.gin;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing GIN url in GINIS config");
-  const requestName2 = "Najdi-esu";
-  const requestNamespace2 = "http://www.gordic.cz/svc/xrg-gin/v_1.0.0.0";
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing GIN url in GINIS config");
+  }
+  const requestName3 = "Najdi-esu";
+  const requestNamespace3 = "http://www.gordic.cz/svc/xrg-gin/v_1.0.0.0";
   const response = await makeAxiosRequest(
-    createXmlRequestConfig(requestName2, requestNamespace2),
+    createXmlRequestConfig(requestName3, requestNamespace3),
     url,
     createXmlRequestBody(this.config, {
-      name: requestName2,
-      namespace: requestNamespace2,
+      name: requestName3,
+      namespace: requestNamespace3,
       xrgNamespace: "http://www.gordic.cz/xrg/gin/esu/najdi-esu/request/v_1.0.0.0",
       paramsBodies: [requestNajdiEsu, requestRizeniPrehledu],
       paramOrders: najdiEsuParamOrders
     }),
     this.config.debug
   );
-  return await extractResponseJson(response.data, requestName2, najdiEsuResponseSchema);
+  return await extractResponseJson(response.data, requestName3, najdiEsuResponseSchema);
 }
 
 // src/api/gin/index.ts
@@ -622,22 +643,24 @@ var detailElPodaniResponseSchema = import_zod6.z.object({
 });
 async function detailElPodani(bodyObj) {
   const url = this.config.urls.pod;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing POD url in GINIS config");
-  const requestName2 = "Detail-el-podani";
-  const requestNamespace2 = "http://www.gordic.cz/svc/xrg-pod/v_1.0.0.0";
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing POD url in GINIS config");
+  }
+  const requestName3 = "Detail-el-podani";
+  const requestNamespace3 = "http://www.gordic.cz/svc/xrg-pod/v_1.0.0.0";
   const response = await makeAxiosRequest(
-    createXmlRequestConfig(requestName2, requestNamespace2),
+    createXmlRequestConfig(requestName3, requestNamespace3),
     url,
     createXmlRequestBody(this.config, {
-      name: requestName2,
-      namespace: requestNamespace2,
+      name: requestName3,
+      namespace: requestNamespace3,
       xrgNamespace: "http://www.gordic.cz/xrg/pod/detail-el-podani/request/v_1.0.0.0",
       paramsBodies: [bodyObj],
       paramOrders: detailElPodaniParamOrders
     }),
     this.config.debug
   );
-  return await extractResponseJson(response.data, requestName2, detailElPodaniResponseSchema);
+  return await extractResponseJson(response.data, requestName3, detailElPodaniResponseSchema);
 }
 
 // src/api/pod/index.ts
@@ -845,22 +868,24 @@ var detailDokumentuResponseSchema = import_zod7.z.object({
 });
 async function detailDokumentu(bodyObj) {
   const url = this.config.urls.ssl;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
-  const requestName2 = "Detail-dokumentu";
-  const requestNamespace2 = "http://www.gordic.cz/svc/xrg-ssl/v_1.0.0.0";
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
+  }
+  const requestName3 = "Detail-dokumentu";
+  const requestNamespace3 = "http://www.gordic.cz/svc/xrg-ssl/v_1.0.0.0";
   const response = await makeAxiosRequest(
-    createXmlRequestConfig(requestName2, requestNamespace2),
+    createXmlRequestConfig(requestName3, requestNamespace3),
     url,
     createXmlRequestBody(this.config, {
-      name: requestName2,
-      namespace: requestNamespace2,
+      name: requestName3,
+      namespace: requestNamespace3,
       xrgNamespace: "http://www.gordic.cz/xrg/ssl/wfl-dokument/detail-dokumentu/request/v_1.0.0.0",
       paramsBodies: [bodyObj],
       paramOrders: detailDokumentuParamOrders
     }),
     this.config.debug
   );
-  return await extractResponseJson(response.data, requestName2, detailDokumentuResponseSchema);
+  return await extractResponseJson(response.data, requestName3, detailDokumentuResponseSchema);
 }
 
 // src/api/ssl/Nastavit-vlastnost-dokumentu.ts
@@ -897,15 +922,17 @@ var nastavitVlastnostDokumentuResponseSchema = import_zod8.z.object({
 });
 async function nastavitVlastnostDokumentu(bodyObj) {
   const url = this.config.urls.ssl;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
-  const requestName2 = "Nastavit-vlastnost-dokumentu";
-  const requestNamespace2 = "http://www.gordic.cz/svc/xrg-ssl/v_1.0.0.0";
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
+  }
+  const requestName3 = "Nastavit-vlastnost-dokumentu";
+  const requestNamespace3 = "http://www.gordic.cz/svc/xrg-ssl/v_1.0.0.0";
   const response = await makeAxiosRequest(
-    createXmlRequestConfig(requestName2, requestNamespace2),
+    createXmlRequestConfig(requestName3, requestNamespace3),
     url,
     createXmlRequestBody(this.config, {
-      name: requestName2,
-      namespace: requestNamespace2,
+      name: requestName3,
+      namespace: requestNamespace3,
       xrgNamespace: "http://www.gordic.cz/xrg/ssl/wfl-dokument/nastavit-vlastnost-dokumentu/request/v_1.0.0.0",
       paramsBodies: [bodyObj],
       paramOrders: nastavitVlastnostDokumentuParamOrders
@@ -914,7 +941,7 @@ async function nastavitVlastnostDokumentu(bodyObj) {
   );
   return await extractResponseJson(
     response.data,
-    requestName2,
+    requestName3,
     nastavitVlastnostDokumentuResponseSchema
   );
 }
@@ -1012,26 +1039,28 @@ var prehledDokumentuResponseSchema = import_zod9.z.object({
 });
 async function prehledDokumentu(requestPrehledDokumentu, requestRizeniPrehledu) {
   const url = this.config.urls.ssl;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
-  const requestName2 = "Prehled-dokumentu";
-  const requestNamespace2 = "http://www.gordic.cz/svc/xrg-ssl/v_1.0.0.0";
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
+  }
+  const requestName3 = "Prehled-dokumentu";
+  const requestNamespace3 = "http://www.gordic.cz/svc/xrg-ssl/v_1.0.0.0";
   const response = await makeAxiosRequest(
-    createXmlRequestConfig(requestName2, requestNamespace2),
+    createXmlRequestConfig(requestName3, requestNamespace3),
     url,
     createXmlRequestBody(this.config, {
-      name: requestName2,
-      namespace: requestNamespace2,
+      name: requestName3,
+      namespace: requestNamespace3,
       xrgNamespace: "http://www.gordic.cz/xrg/ssl/wfl-dokument/prehled-dokumentu/request/v_1.0.0.0",
       paramsBodies: [requestPrehledDokumentu, requestRizeniPrehledu],
       paramOrders: prehledDokumentuParamOrders
     }),
     this.config.debug
   );
-  return await extractResponseJson(response.data, requestName2, prehledDokumentuResponseSchema);
+  return await extractResponseJson(response.data, requestName3, prehledDokumentuResponseSchema);
 }
 
 // src/api/ssl/Pridat-soubor.ts
-var import_stream2 = require("stream");
+var import_stream3 = require("stream");
 var import_uuid = require("uuid");
 var import_zod10 = require("zod");
 var pridatSouborRequestProperties = [
@@ -1066,7 +1095,9 @@ var requestNamespace = "http://www.gordic.cz/svc/xrg-ssl/v_1.0.0.0";
 var requestXrgNamespace = "http://www.gordic.cz/xrg/ssl/wfl-dokument/pridat-soubor/request/v_1.0.0.0";
 async function pridatSoubor(bodyObj) {
   const url = this.config.urls.ssl;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
+  }
   const requestInfo = {
     name: requestName,
     namespace: requestNamespace,
@@ -1085,14 +1116,16 @@ async function pridatSoubor(bodyObj) {
 async function pridatSouborMtom(bodyObj, fileStream) {
   let fileContent = fileStream;
   if (!fileContent) {
-    fileContent = new import_stream2.Readable({
+    fileContent = new import_stream3.Readable({
       read() {
         this.push(null);
       }
     });
   }
   const url = this.config.urls.ssl_mtom;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
+  }
   const requestInfo = {
     name: requestName,
     namespace: requestNamespace,
@@ -1151,22 +1184,24 @@ var prideleniResponseSchema = import_zod11.z.object({
 });
 async function prideleni(bodyObj) {
   const url = this.config.urls.ssl;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
-  const requestName2 = "Prideleni";
-  const requestNamespace2 = "http://www.gordic.cz/svc/xrg-ssl/v_1.0.0.0";
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
+  }
+  const requestName3 = "Prideleni";
+  const requestNamespace3 = "http://www.gordic.cz/svc/xrg-ssl/v_1.0.0.0";
   const response = await makeAxiosRequest(
-    createXmlRequestConfig(requestName2, requestNamespace2),
+    createXmlRequestConfig(requestName3, requestNamespace3),
     url,
     createXmlRequestBody(this.config, {
-      name: requestName2,
-      namespace: requestNamespace2,
+      name: requestName3,
+      namespace: requestNamespace3,
       xrgNamespace: "http://www.gordic.cz/xrg/ssl/wfl-dokument/prideleni/request/v_1.0.0.0",
       paramsBodies: [bodyObj],
       paramOrders: prideleniParamOrders
     }),
     this.config.debug
   );
-  return await extractResponseJson(response.data, requestName2, prideleniResponseSchema);
+  return await extractResponseJson(response.data, requestName3, prideleniResponseSchema);
 }
 
 // src/api/ssl/Zaloz-cj.ts
@@ -1191,22 +1226,24 @@ var zalozCjResponseSchema = import_zod12.z.object({
 });
 async function zalozCj(bodyObj) {
   const url = this.config.urls.ssl;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
-  const requestName2 = "Zaloz-cj";
-  const requestNamespace2 = "http://www.gordic.cz/svc/xrg-ssl/v_1.0.0.0";
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
+  }
+  const requestName3 = "Zaloz-cj";
+  const requestNamespace3 = "http://www.gordic.cz/svc/xrg-ssl/v_1.0.0.0";
   const response = await makeAxiosRequest(
-    createXmlRequestConfig(requestName2, requestNamespace2),
+    createXmlRequestConfig(requestName3, requestNamespace3),
     url,
     createXmlRequestBody(this.config, {
-      name: requestName2,
-      namespace: requestNamespace2,
+      name: requestName3,
+      namespace: requestNamespace3,
       xrgNamespace: "http://www.gordic.cz/xrg/ssl/wfl-dokument/zaloz-cj/request/v_1.0.0.0",
       paramsBodies: [bodyObj],
       paramOrders: zalozCjParamOrders
     }),
     this.config.debug
   );
-  return await extractResponseJson(response.data, requestName2, zalozCjResponseSchema);
+  return await extractResponseJson(response.data, requestName3, zalozCjResponseSchema);
 }
 
 // src/api/ssl/Zaloz-pisemnost.ts
@@ -1278,22 +1315,24 @@ var zalozPisemnostResponseSchema = import_zod13.z.object({
 });
 async function zalozPisemnost(requestWflDokument, requestDoruceni, requestSslDokument) {
   const url = this.config.urls.ssl;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
-  const requestName2 = "Zaloz-pisemnost";
-  const requestNamespace2 = "http://www.gordic.cz/svc/xrg-ssl/v_1.0.0.0";
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
+  }
+  const requestName3 = "Zaloz-pisemnost";
+  const requestNamespace3 = "http://www.gordic.cz/svc/xrg-ssl/v_1.0.0.0";
   const response = await makeAxiosRequest(
-    createXmlRequestConfig(requestName2, requestNamespace2),
+    createXmlRequestConfig(requestName3, requestNamespace3),
     url,
     createXmlRequestBody(this.config, {
-      name: requestName2,
-      namespace: requestNamespace2,
+      name: requestName3,
+      namespace: requestNamespace3,
       xrgNamespace: "http://www.gordic.cz/xrg/ssl/wfl-dokument/zaloz-pisemnost/request/v_1.0.0.0",
       paramsBodies: [requestWflDokument, requestDoruceni, requestSslDokument],
       paramOrders: prehledDokumentuParamOrders2
     }),
     this.config.debug
   );
-  return await extractResponseJson(response.data, requestName2, zalozPisemnostResponseSchema);
+  return await extractResponseJson(response.data, requestName3, zalozPisemnostResponseSchema);
 }
 
 // src/api/ssl/Zalozit-vlastnost-dokumentu.ts
@@ -1322,15 +1361,17 @@ var zalozitVlastnostDokumentuResponseSchema = import_zod14.z.object({
 });
 async function zalozitVlastnostDokumentu(bodyObj) {
   const url = this.config.urls.ssl;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
-  const requestName2 = "Zalozit-vlastnost-dokumentu";
-  const requestNamespace2 = "http://www.gordic.cz/svc/xrg-ssl/v_1.0.0.0";
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing SSL url in GINIS config");
+  }
+  const requestName3 = "Zalozit-vlastnost-dokumentu";
+  const requestNamespace3 = "http://www.gordic.cz/svc/xrg-ssl/v_1.0.0.0";
   const response = await makeAxiosRequest(
-    createXmlRequestConfig(requestName2, requestNamespace2),
+    createXmlRequestConfig(requestName3, requestNamespace3),
     url,
     createXmlRequestBody(this.config, {
-      name: requestName2,
-      namespace: requestNamespace2,
+      name: requestName3,
+      namespace: requestNamespace3,
       xrgNamespace: "http://www.gordic.cz/xrg/ssl/wfl-dokument/zalozit-vlastnost-dokumentu/request/v_1.0.0.0",
       paramsBodies: [bodyObj],
       paramOrders: zalozitVlastnostDokumentuParamOrders
@@ -1339,7 +1380,7 @@ async function zalozitVlastnostDokumentu(bodyObj) {
   );
   return await extractResponseJson(
     response.data,
-    requestName2,
+    requestName3,
     zalozitVlastnostDokumentuResponseSchema
   );
 }
@@ -1491,26 +1532,217 @@ var detailDokumentuResponseSchema2 = import_zod15.z.object({
 });
 async function detailDokumentu2(bodyObj) {
   const url = this.config.urls.ude;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing UDE url in GINIS config");
-  const requestName2 = "Detail-dokumentu";
-  const requestNamespace2 = "http://www.gordic.cz/svc/xrg-ude/v_1.0.0.0";
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing UDE url in GINIS config");
+  }
+  const requestName3 = "Detail-dokumentu";
+  const requestNamespace3 = "http://www.gordic.cz/svc/xrg-ude/v_1.0.0.0";
   const response = await makeAxiosRequest(
-    createXmlRequestConfig(requestName2, requestNamespace2),
+    createXmlRequestConfig(requestName3, requestNamespace3),
     url,
     createXmlRequestBody(this.config, {
-      name: requestName2,
-      namespace: requestNamespace2,
+      name: requestName3,
+      namespace: requestNamespace3,
       xrgNamespace: "http://www.gordic.cz/xrg/ude/detail-dokumentu/request/v_1.0.0.0",
       paramsBodies: [bodyObj],
       paramOrders: detailDokumentuParamOrders2
     }),
     this.config.debug
   );
-  return await extractResponseJson(response.data, requestName2, detailDokumentuResponseSchema2);
+  return await extractResponseJson(response.data, requestName3, detailDokumentuResponseSchema2);
 }
 
 // src/api/ude/Nacist-soubor.ts
+var import_stream5 = require("stream");
 var import_zod16 = require("zod");
+
+// src/utils/stream-utils.ts
+var import_stream4 = require("stream");
+var DATA_OPEN = "<Data>";
+var DATA_CLOSE = "</Data>";
+var DATA_PLACEHOLDER = `${DATA_OPEN}placeholder${DATA_CLOSE}`;
+var XmlBase64DataStreamParser = class extends import_stream4.Transform {
+  responseValidation;
+  resolveResponse;
+  rejectResponse;
+  responseSettled = false;
+  /** Parsed response payload resolved when stream parsing/validation completes. */
+  response;
+  /** Accumulates XML bytes before <Data> — only a few hundred bytes. */
+  headerBuf = "";
+  /**
+   * Holds the last 6 chars of each data chunk. This is needed because
+   * `</Data>` (7 chars) could be split across two HTTP chunks — without
+   * this buffer we might accidentally decode part of the closing tag as base64.
+   */
+  dataTailBuf = "";
+  /**
+   * Holds 0-3 leftover base64 characters between chunks. Base64 decoding
+   * requires input lengths that are multiples of 4, so any remainder from
+   * the previous chunk is prepended to the next one.
+   */
+  base64Rem = "";
+  /**
+   * A lightweight copy of the full XML response with the huge base64 content
+   * replaced by `<Data>placeholder</Data>`. Used in `_flush` for zod validation
+   * of the SOAP envelope structure without holding the actual file data in memory.
+   */
+  skeleton = "";
+  state = "header";
+  constructor(config) {
+    super();
+    this.responseValidation = config.responseValidation;
+    this.response = new Promise((resolve, reject) => {
+      this.resolveResponse = resolve;
+      this.rejectResponse = reject;
+    });
+  }
+  _transform(chunk, _encoding, callback) {
+    try {
+      const str = chunk.toString("utf-8");
+      if (this.state === "header") {
+        this.handleHeader(str);
+      } else if (this.state === "data") {
+        this.handleData(str);
+      } else {
+        this.handleTail(str);
+      }
+      callback();
+    } catch (error) {
+      callback(error instanceof Error ? error : new Error(String(error)));
+    }
+  }
+  /**
+   * Called when the input stream ends. Validates the skeleton XML via
+   * `extractResponseJson` using configured `requestName` and `responseSchema`
+   * from constructor config. If the SOAP envelope is malformed, contains a
+   * fault, or is missing required fields, the stream emits an error.
+   *
+   * Validation runs _after_ all data chunks have been pushed but _before_
+   * the 'end' event — so the consumer's error handler will fire if it fails.
+   */
+  _flush(callback) {
+    if (this.state === "data") {
+      const error = new GinisError("Response stream ended before </Data> was found");
+      this.setResponseError(error);
+      callback(error);
+      return;
+    }
+    if (this.state === "header") {
+      this.skeleton = this.headerBuf;
+    }
+    extractResponseJson(
+      this.skeleton,
+      this.responseValidation.requestName,
+      this.responseValidation.responseSchema
+    ).then((parsedResponse) => {
+      this.setResponseValue(parsedResponse);
+      callback();
+    }).catch((error) => {
+      const responseError = error instanceof Error ? error : new GinisError(String(error));
+      this.setResponseError(responseError);
+      callback(responseError);
+    });
+  }
+  _destroy(error, callback) {
+    if (error) {
+      this.setResponseError(error);
+    }
+    callback(error);
+  }
+  /**
+   * Accumulates the XML header. Once `<Data>` is found, saves everything
+   * before it to the skeleton (with a placeholder instead of actual base64),
+   * emits `'ready'` so the outer function knows data is flowing, and
+   * transitions to the `data` state.
+   */
+  handleHeader(str) {
+    this.headerBuf += str;
+    const dataOpenIndex = this.headerBuf.indexOf(DATA_OPEN);
+    if (dataOpenIndex === -1) {
+      return;
+    }
+    const afterData = this.headerBuf.substring(dataOpenIndex + DATA_OPEN.length);
+    this.skeleton = this.headerBuf.substring(0, dataOpenIndex) + DATA_PLACEHOLDER;
+    this.headerBuf = "";
+    this.state = "data";
+    this.emit("ready");
+    if (afterData.length > 0) {
+      this.handleData(afterData);
+    }
+  }
+  /**
+   * Processes a chunk of base64 text from inside `<Data>...</Data>`.
+   * Prepends the previous tail buffer and checks for the closing tag.
+   * When `</Data>` is found, appends the trailing XML to the skeleton
+   * and transitions to the `tail` state.
+   */
+  handleData(str) {
+    const combined = this.dataTailBuf + str;
+    const dataCloseIndex = combined.indexOf(DATA_CLOSE);
+    if (dataCloseIndex !== -1) {
+      this.decodeBase64(combined.substring(0, dataCloseIndex));
+      this.flushBase64();
+      this.dataTailBuf = "";
+      this.skeleton += combined.substring(dataCloseIndex + DATA_CLOSE.length);
+      this.state = "tail";
+      return;
+    }
+    const tailSize = DATA_CLOSE.length - 1;
+    if (combined.length > tailSize) {
+      this.decodeBase64(combined.substring(0, combined.length - tailSize));
+      this.dataTailBuf = combined.substring(combined.length - tailSize);
+    } else {
+      this.dataTailBuf = combined;
+    }
+  }
+  /**
+   * Collects the closing XML tags after `</Data>` into the skeleton.
+   * These are only a few bytes, and are needed for zod validation in `_flush`.
+   */
+  handleTail(str) {
+    this.skeleton += str;
+  }
+  /**
+   * Decodes a chunk of base64 text to binary and pushes it downstream.
+   * Only decodes up to the last multiple-of-4 boundary; leftover chars
+   * (0-3) are saved in `base64Rem` and prepended to the next chunk.
+   */
+  decodeBase64(str) {
+    if (str.length === 0) {
+      return;
+    }
+    const full = this.base64Rem + str;
+    const aligned = full.length - full.length % 4;
+    if (aligned > 0) {
+      this.push(Buffer.from(full.substring(0, aligned), "base64"));
+    }
+    this.base64Rem = full.substring(aligned);
+  }
+  /** Decodes and pushes any remaining base64 chars (final padding). */
+  flushBase64() {
+    if (this.base64Rem.length > 0) {
+      this.push(Buffer.from(this.base64Rem, "base64"));
+      this.base64Rem = "";
+    }
+  }
+  setResponseValue(value) {
+    if (this.responseSettled) {
+      return;
+    }
+    this.responseSettled = true;
+    this.resolveResponse(value);
+  }
+  setResponseError(error) {
+    if (this.responseSettled) {
+      return;
+    }
+    this.responseSettled = true;
+    this.rejectResponse(error);
+  }
+};
+
+// src/api/ude/Nacist-soubor.ts
 var nacistSouborRequestProperties = ["Id-souboru"];
 var nacistSouborParamOrders = [
   {
@@ -1537,18 +1769,21 @@ var nacistSouborResponseSchema = import_zod16.z.object({
    */
   "Nacist-soubor": nacistSouborSchema.optional()
 });
+var requestName2 = "Nacist-soubor";
+var requestNamespace2 = "http://www.gordic.cz/svc/xrg-ude/v_1.0.0.0";
+var requestXrgNamespace2 = "http://www.gordic.cz/xrg/ude/nacist-soubor/request/v_1.0.0.0";
 async function nacistSoubor(bodyObj) {
   const url = this.config.urls.ude;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing UDE url in GINIS config");
-  const requestName2 = "Nacist-soubor";
-  const requestNamespace2 = "http://www.gordic.cz/svc/xrg-ude/v_1.0.0.0";
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing UDE url in GINIS config");
+  }
   const response = await makeAxiosRequest(
     createXmlRequestConfig(requestName2, requestNamespace2),
     url,
     createXmlRequestBody(this.config, {
       name: requestName2,
       namespace: requestNamespace2,
-      xrgNamespace: "http://www.gordic.cz/xrg/ude/nacist-soubor/request/v_1.0.0.0",
+      xrgNamespace: requestXrgNamespace2,
       paramsBodies: [bodyObj],
       paramOrders: nacistSouborParamOrders
     }),
@@ -1556,6 +1791,37 @@ async function nacistSoubor(bodyObj) {
   );
   return await extractResponseJson(response.data, requestName2, nacistSouborResponseSchema);
 }
+async function nacistSouborStream(bodyObj) {
+  const url = this.config.urls.ude;
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing UDE url in GINIS config");
+  }
+  const response = await makeAxiosRequest(
+    { ...createXmlRequestConfig(requestName2, requestNamespace2), responseType: "stream" },
+    url,
+    createXmlRequestBody(this.config, {
+      name: requestName2,
+      namespace: requestNamespace2,
+      xrgNamespace: requestXrgNamespace2,
+      paramsBodies: [bodyObj],
+      paramOrders: nacistSouborParamOrders
+    }),
+    this.config.debug
+  );
+  const parser = new XmlBase64DataStreamParser({
+    responseValidation: {
+      requestName: requestName2,
+      responseSchema: nacistSouborResponseSchema
+    }
+  });
+  (0, import_stream5.pipeline)(response.data, parser, (error) => {
+    if (error && !parser.destroyed) {
+      parser.destroy(error instanceof Error ? error : new Error(String(error)));
+    }
+  });
+  parser.response.catch(() => void 0);
+  return parser;
+}
 
 // src/api/ude/Seznam-dokumentu.ts
 var import_lodash = require("lodash");
@@ -1753,22 +2019,24 @@ var seznamDokumentuResponseSchema = import_zod17.z.object({
 });
 async function seznamDokumentu(bodyObj) {
   const url = this.config.urls.ude;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing UDE url in GINIS config");
-  const requestName2 = "Seznam-dokumentu";
-  const requestNamespace2 = "http://www.gordic.cz/svc/xrg-ude/v_1.0.0.0";
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing UDE url in GINIS config");
+  }
+  const requestName3 = "Seznam-dokumentu";
+  const requestNamespace3 = "http://www.gordic.cz/svc/xrg-ude/v_1.0.0.0";
   const response = await makeAxiosRequest(
-    createXmlRequestConfig(requestName2, requestNamespace2),
+    createXmlRequestConfig(requestName3, requestNamespace3),
     url,
     createXmlRequestBody(this.config, {
-      name: requestName2,
-      namespace: requestNamespace2,
+      name: requestName3,
+      namespace: requestNamespace3,
       xrgNamespace: "http://www.gordic.cz/xrg/ude/seznam-dokumentu/request/v_1.0.0.0",
       paramsBodies: [bodyObj],
       paramOrders: seznamDokumentuParamOrders
     }),
     this.config.debug
   );
-  return await extractResponseJson(response.data, requestName2, seznamDokumentuResponseSchema);
+  return await extractResponseJson(response.data, requestName3, seznamDokumentuResponseSchema);
 }
 function getRecordIdsWithLatestArchiveDate(records) {
   let latestDate = null;
@@ -1871,28 +2139,31 @@ var seznamKategoriiResponseSchema = import_zod18.z.object({
 });
 async function seznamKategorii(bodyObj) {
   const url = this.config.urls.ude;
-  if (!url) throw new GinisError("GINIS SDK Error: Missing UDE url in GINIS config");
-  const requestName2 = "Seznam-kategorii";
-  const requestNamespace2 = "http://www.gordic.cz/svc/xrg-ude/v_1.0.0.0";
+  if (!url) {
+    throw new GinisError("GINIS SDK Error: Missing UDE url in GINIS config");
+  }
+  const requestName3 = "Seznam-kategorii";
+  const requestNamespace3 = "http://www.gordic.cz/svc/xrg-ude/v_1.0.0.0";
   const response = await makeAxiosRequest(
-    createXmlRequestConfig(requestName2, requestNamespace2),
+    createXmlRequestConfig(requestName3, requestNamespace3),
     url,
     createXmlRequestBody(this.config, {
-      name: requestName2,
-      namespace: requestNamespace2,
+      name: requestName3,
+      namespace: requestNamespace3,
       xrgNamespace: "http://www.gordic.cz/xrg/ude/seznam-kategorii/request/v_1.0.0.0",
       paramsBodies: [bodyObj],
       paramOrders: seznamKategoriiParamOrders
     }),
     this.config.debug
   );
-  return await extractResponseJson(response.data, requestName2, seznamKategoriiResponseSchema);
+  return await extractResponseJson(response.data, requestName3, seznamKategoriiResponseSchema);
 }
 
 // src/api/ude/index.ts
 var ude_default = {
   detailDokumentu: detailDokumentu2,
   nacistSoubor,
+  nacistSouborStream,
   seznamDokumentu,
   seznamDokumentuFilterArchiv,
   seznamKategorii

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bratislava/ginis-sdk",
-  "version": "2.1.3",
+  "version": "2.2.1",
   "description": "A small wrapper for most commonly used requests towards the Bratislava GINIS system",
   "main": "dist/index.js",
   "files": [
@@ -32,58 +32,42 @@
   },
   "homepage": "https://github.com/bratislava/ginis-sdk#readme",
   "devDependencies": {
-    "@babel/core": "^7.29.0",
-    "@babel/preset-env": "^7.29.0",
-    "@babel/preset-typescript": "^7.28.5",
-    "@darraghor/eslint-plugin-nestjs-typed": "^7.1.19",
-    "@eslint/js": "^9.39.2",
-    "@eslint/json": "^0.14.0",
-    "@eslint/markdown": "^7.5.1",
-    "@types/eslint-config-prettier": "^6.11.3",
-    "@types/eslint-plugin-security": "^3.0.1",
-    "@types/jest": "^30.0.0",
-    "@types/lodash": "^4.17.23",
-    "@types/xml2js": "^0.4.14",
-    "@typescript-eslint/eslint-plugin": "^8.55.0",
-    "@typescript-eslint/parser": "^8.55.0",
-    "babel-jest": "^30.2.0",
-    "dotenv": "^17.2.4",
-    "eslint": "^9.39.2",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-eslint-comments": "^3.2.0",
-    "eslint-plugin-jest": "^29.13.0",
-    "eslint-plugin-jest-async": "^1.0.3",
-    "eslint-plugin-no-unsanitized": "^4.1.4",
-    "eslint-plugin-node": "^11.1.0",
-    "eslint-plugin-security": "^3.0.1",
-    "eslint-plugin-simple-import-sort": "^12.1.1",
-    "eslint-plugin-sonarjs": "^3.0.6",
-    "eslint-plugin-xss": "^0.1.12",
-    "jest": "^30.2.0",
-    "jiti": "^2.6.1",
-    "prettier": "^3.8.1",
-    "ts-jest": "^29.4.6",
-    "ts-loader": "^9.5.4",
-    "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.55.0"
+    "@babel/core": "7.29.7",
+    "@babel/preset-env": "7.29.7",
+    "@babel/preset-typescript": "7.29.7",
+    "@bratislava/eslint-config": "0.17.0",
+    "@types/jest": "30.0.0",
+    "@types/lodash": "4.17.24",
+    "@types/xml2js": "0.4.14",
+    "babel-jest": "30.4.1",
+    "dotenv": "17.4.2",
+    "eslint": "9.39.5",
+    "jest": "30.4.2",
+    "jiti": "2.7.0",
+    "prettier": "3.9.6",
+    "ts-jest": "29.4.12",
+    "ts-loader": "9.6.2",
+    "tsup": "8.5.1",
+    "typescript": "5.9.3"
   },
   "overrides": {
-    "glob": "^11.1.0"
+    "esbuild": "0.28.1",
+    "glob": "13.0.6",
+    "minimatch": "10.2.4"
   },
   "engines": {
     "node": ">=20.9.x",
     "npm": ">=10.2.x"
   },
   "dependencies": {
-    "axios": "^1.13.5",
-    "lodash": "^4.17.23",
-    "uuid": "^11.1.0",
-    "xml2js": "^0.6.2",
-    "zod": "^4.3.6"
+    "axios": "1.18.1",
+    "lodash": "4.18.1",
+    "uuid": "11.1.1",
+    "xml2js": "0.6.2",
+    "zod": "4.4.3"
   },
   "volta": {
-    "node": "22.14.0",
-    "npm": "11.1.0"
+    "node": "24.16.0",
+    "npm": "11.13.0"
   }
 }