ksef-client-ts 0.2.0 → 0.4.0

package/dist/index.d.ts

@@ -77,7 +77,18 @@ declare class DefaultAuthManager implements AuthManager {
 }
 
 interface KSeFClientOptions {
+    /**
+     * Target KSeF environment. Defaults to `'TEST'` when neither `environment`
+     * nor `baseUrl` is specified.
+     */
     environment?: EnvironmentName;
+    /**
+     * Custom base URL for the KSeF API. Overrides the URL from `environment`.
+     *
+     * **Warning:** When `baseUrl` is set without `environment`, the test environment
+     * guard is bypassed — test data APIs will not be blocked. Set `environment`
+     * explicitly alongside `baseUrl` if the guard is needed.
+     */
     baseUrl?: string;
     baseQrUrl?: string;
     lighthouseUrl?: string;
@@ -97,6 +108,7 @@ interface ResolvedOptions {
     apiVersion: string;
     timeout: number;
     customHeaders: Record<string, string>;
+    environmentName?: EnvironmentName;
 }
 declare function resolveOptions(options?: KSeFClientOptions): ResolvedOptions;
 
@@ -613,6 +625,11 @@ interface BatchPartSendingInfo {
     metadata: FileMetadata;
     ordinalNumber: number;
 }
+interface BatchPartStreamSendingInfo {
+    dataStream: ReadableStream<Uint8Array>;
+    metadata: FileMetadata;
+    ordinalNumber: number;
+}
 
 interface SessionsFilter {
     referenceNumber?: string;
@@ -1622,6 +1639,72 @@ interface QrCodeOptions {
     errorCorrectionLevel?: 'L' | 'M' | 'Q' | 'H';
 }
 
+declare const SystemCode: {
+    readonly FA_2: "FA (2)";
+    readonly FA_3: "FA (3)";
+    readonly PEF_3: "PEF (3)";
+    readonly PEF_KOR_3: "PEF_KOR (3)";
+    readonly FA_RR_1: "FA_RR (1)";
+};
+type SystemCode = (typeof SystemCode)[keyof typeof SystemCode];
+declare const FORM_CODES: {
+    readonly FA_2: {
+        readonly systemCode: "FA (2)";
+        readonly schemaVersion: "1-0E";
+        readonly value: "FA";
+    };
+    readonly FA_3: {
+        readonly systemCode: "FA (3)";
+        readonly schemaVersion: "1-0E";
+        readonly value: "FA";
+    };
+    readonly PEF_3: {
+        readonly systemCode: "PEF (3)";
+        readonly schemaVersion: "2-1";
+        readonly value: "PEF";
+    };
+    readonly PEF_KOR_3: {
+        readonly systemCode: "PEF_KOR (3)";
+        readonly schemaVersion: "2-1";
+        readonly value: "PEF";
+    };
+    readonly FA_RR_1_LEGACY: {
+        readonly systemCode: "FA_RR (1)";
+        readonly schemaVersion: "1-0E";
+        readonly value: "RR";
+    };
+    readonly FA_RR_1_TRANSITION: {
+        readonly systemCode: "FA_RR (1)";
+        readonly schemaVersion: "1-1E";
+        readonly value: "RR";
+    };
+    readonly FA_RR_1: {
+        readonly systemCode: "FA_RR (1)";
+        readonly schemaVersion: "1-1E";
+        readonly value: "FA_RR";
+    };
+};
+type OnlineSessionFormCode = (typeof FORM_CODES)[keyof typeof FORM_CODES];
+type BatchSessionFormCode = typeof FORM_CODES.FA_2 | typeof FORM_CODES.FA_3 | typeof FORM_CODES.FA_RR_1_LEGACY | typeof FORM_CODES.FA_RR_1_TRANSITION | typeof FORM_CODES.FA_RR_1;
+declare const INVOICE_TYPES_BY_SYSTEM_CODE: Record<SystemCode, readonly InvoiceType[]>;
+declare const FORM_CODE_KEYS: Record<string, FormCode>;
+
+/**
+ * Returns the default FormCode constant for a given SystemCode.
+ * For FA_RR_1, returns the current variant (schemaVersion 1-1E, value FA_RR).
+ */
+declare function getFormCode(systemCode: SystemCode): FormCode;
+/**
+ * Matches a raw FormCode from an API response to the closest typed constant.
+ * Returns the raw object unchanged if no exact match is found.
+ */
+declare function parseFormCode(raw: FormCode): FormCode;
+/**
+ * Validates whether a FormCode is valid for the given session type.
+ * Batch sessions do not support PEF or PEF_KOR document types.
+ */
+declare function validateFormCodeForSession(formCode: FormCode, sessionType: 'online' | 'batch'): boolean;
+
 declare class AuthService {
     private readonly restClient;
     constructor(restClient: RestClient);
@@ -1654,6 +1737,12 @@ declare class BatchSessionService {
     constructor(restClient: RestClient);
     openSession(request: OpenBatchSessionRequest, upoVersion?: UpoVersion | string): Promise<OpenBatchSessionResponse>;
     sendParts(openResponse: OpenBatchSessionResponse, parts: BatchPartSendingInfo[]): Promise<void>;
+    /**
+     * Upload parts sequentially (not in parallel) because each part uses a
+     * streaming body (`duplex: 'half'`). Parallel streaming uploads can cause
+     * backpressure issues and exceed memory limits for large payloads.
+     */
+    sendPartsWithStream(openResponse: OpenBatchSessionResponse, parts: BatchPartStreamSendingInfo[]): Promise<void>;
     closeSession(batchRef: string): Promise<void>;
 }
 
@@ -1751,7 +1840,9 @@ declare class PeppolService {
 
 declare class TestDataService {
     private readonly restClient;
-    constructor(restClient: RestClient);
+    private readonly environmentName?;
+    constructor(restClient: RestClient, environmentName?: EnvironmentName);
+    private ensureTestEnvironment;
     createSubject(request: SubjectCreateRequest): Promise<void>;
     removeSubject(request: SubjectRemoveRequest): Promise<void>;
     createPerson(request: PersonCreateRequest): Promise<void>;
@@ -1872,6 +1963,56 @@ declare class AuthorizationPermissionGrantBuilder {
     build(): GrantPermissionsAuthorizationRequest;
 }
 
+/** Maximum size of a single unencrypted batch part (100 MB). */
+declare const BATCH_MAX_PART_SIZE = 100000000;
+/** Maximum total unencrypted ZIP size (5 GB). */
+declare const BATCH_MAX_TOTAL_SIZE = 5000000000;
+/** Maximum number of batch parts allowed by KSeF API. */
+declare const BATCH_MAX_PARTS = 50;
+interface BatchFileBuildOptions {
+    /** Max unencrypted part size in bytes. Default: 100 MB. */
+    maxPartSize?: number;
+}
+interface BatchFileBuildResult {
+    /** Metadata for OpenBatchSessionRequest.batchFile. */
+    batchFile: BatchFileInfo;
+    /** Encrypted parts ready for upload, indexed 0..N-1. */
+    encryptedParts: Uint8Array[];
+}
+interface BatchStreamBuildResult {
+    /** Metadata for OpenBatchSessionRequest.batchFile. */
+    batchFile: BatchFileInfo;
+    /** Stream-based encrypted parts ready for upload. */
+    streamParts: BatchPartStreamSendingInfo[];
+}
+/**
+ * Splits a ZIP file into parts, encrypts each part, and computes
+ * all SHA-256 hashes required by the KSeF batch API.
+ */
+declare class BatchFileBuilder {
+    /**
+     * Build batch file metadata and encrypted parts from a raw ZIP.
+     *
+     * @param zipBytes - Unencrypted ZIP data
+     * @param encryptFn - AES-256-CBC encryption function (called per part)
+     * @param options - Optional configuration
+     */
+    static build(zipBytes: Uint8Array, encryptFn: (part: Uint8Array) => Uint8Array, options?: BatchFileBuildOptions): BatchFileBuildResult;
+    /**
+     * Stream-based variant: two-pass build from a stream factory.
+     *
+     * Pass 1: consume stream to compute ZIP hash.
+     * Pass 2: re-create stream, split into parts, encrypt each, compute per-part metadata.
+     *
+     * @param zipStreamFactory - Factory that creates a fresh ReadableStream of the ZIP data
+     * @param zipSize - Total ZIP byte size (from fs.stat or known in advance)
+     * @param encryptStreamFn - Stream-to-stream AES-256-CBC encryption function
+     * @param hashStreamFn - Stream-to-FileMetadata hashing function
+     * @param options - Optional configuration
+     */
+    static buildFromStream(zipStreamFactory: () => ReadableStream<Uint8Array>, zipSize: number, encryptStreamFn: (stream: ReadableStream<Uint8Array>) => ReadableStream<Uint8Array>, hashStreamFn: (stream: ReadableStream<Uint8Array>) => Promise<FileMetadata>, options?: BatchFileBuildOptions): Promise<BatchStreamBuildResult>;
+}
+
 declare class CertificateFetcher {
     private readonly restClient;
     private symmetricKeyPem;
@@ -1900,6 +2041,11 @@ declare class CryptographyService {
     init(): Promise<void>;
     /** Encrypt with AES-256-CBC (PKCS7 padding is automatic in Node). */
     encryptAES256(content: Uint8Array, key: Uint8Array, iv: Uint8Array): Uint8Array;
+    /**
+     * Encrypt with AES-256-CBC as a streaming transform.
+     * Returns a ReadableStream that yields encrypted chunks as the input is read.
+     */
+    encryptAES256Stream(input: ReadableStream<Uint8Array>, key: Uint8Array, iv: Uint8Array): ReadableStream<Uint8Array>;
     /** Decrypt with AES-256-CBC. */
     decryptAES256(content: Uint8Array, key: Uint8Array, iv: Uint8Array): Uint8Array;
     /**
@@ -1923,6 +2069,8 @@ declare class CryptographyService {
     encryptKsefToken(token: string, challengeTimestamp: string): Uint8Array;
     /** Compute SHA-256 hash (base64) and byte length. */
     getFileMetadata(file: Uint8Array): FileMetadata;
+    /** Compute SHA-256 hash (base64) and byte length from a ReadableStream. */
+    getFileMetadataFromStream(stream: ReadableStream<Uint8Array>): Promise<FileMetadata>;
     /** Generate an RSA-2048 CSR (PKCS#10, DER) and return it together with the private key PEM. */
     generateCsrRsa(fields: X500NameFields): Promise<CsrResult>;
     /** Generate an ECDSA P-256 CSR (PKCS#10, DER) and return it together with the private key PEM. */
@@ -1979,6 +2127,20 @@ declare class Pkcs12Loader {
     static load(p12: Buffer | Uint8Array, password: string): Pkcs12Result;
 }
 
+interface AuthTokenRequestXmlOptions {
+    challenge: string;
+    contextIdentifier: ContextIdentifier;
+    subjectIdentifierType?: XadesSubjectIdentifierType;
+}
+/**
+ * Build an unsigned KSeF auth token request XML document.
+ *
+ * Supports all four context identifier types: Nip, InternalId, NipVatUe, PeppolId.
+ * The returned XML is ready for external signing (e.g. HSM, EPUAP, smart cards)
+ * or can be signed internally via {@link SignatureService.sign}.
+ */
+declare function buildUnsignedAuthTokenRequestXml(options: AuthTokenRequestXmlOptions): string;
+
 declare class VerificationLinkService {
     private readonly baseQrUrl;
     constructor(baseQrUrl: string);
@@ -2003,6 +2165,71 @@ declare class QrCodeService {
     static generateResult(url: string, options?: QrCodeOptions): Promise<QrCodeResult>;
 }
 
+interface ZipEntryInput {
+    fileName: string;
+    content: Buffer | Uint8Array;
+}
+interface UnzipOptions {
+    maxFiles?: number;
+    maxTotalUncompressedSize?: number;
+    maxFileUncompressedSize?: number;
+    maxCompressionRatio?: number | null;
+}
+declare function createZip(entries: ZipEntryInput[]): Promise<Buffer>;
+declare function unzip(buffer: Buffer, options?: UnzipOptions): Promise<Map<string, Buffer>>;
+
+type UpoContextId = {
+    kind: 'Nip';
+    nip: string;
+} | {
+    kind: 'IdWewnetrzny';
+    idWewnetrzny: string;
+} | {
+    kind: 'IdZlozonyVatUE';
+    idZlozonyVatUE: string;
+} | {
+    kind: 'IdDostawcyUslugPeppol';
+    idDostawcyUslugPeppol: string;
+};
+type UpoAuthProof = {
+    kind: 'NumerReferencyjnyTokenaKSeF';
+    numerReferencyjnyTokenaKSeF: string;
+} | {
+    kind: 'SkrotDokumentuUwierzytelniajacego';
+    skrotDokumentuUwierzytelniajacego: string;
+};
+interface UpoUwierzytelnienie {
+    idKontekstu: UpoContextId;
+    proof: UpoAuthProof;
+}
+interface UpoOpisPotwierdzenia {
+    strona: number;
+    liczbaStron: number;
+    zakresDokumentowOd: number;
+    zakresDokumentowDo: number;
+    calkowitaLiczbaDokumentow: number;
+}
+interface UpoDokument {
+    nipSprzedawcy: string;
+    numerKSeFDokumentu: string;
+    numerFaktury: string;
+    dataWystawieniaFaktury: string;
+    dataPrzeslaniaDokumentu: string;
+    dataNadaniaNumeruKSeF: string;
+    skrotDokumentu: string;
+    trybWysylki: string;
+}
+interface UpoPotwierdzenie {
+    nazwaPodmiotuPrzyjmujacego: string;
+    numerReferencyjnySesji: string;
+    uwierzytelnienie: UpoUwierzytelnienie;
+    opisPotwierdzenia?: UpoOpisPotwierdzenia;
+    nazwaStrukturyLogicznej: string;
+    kodFormularza: string;
+    dokumenty: UpoDokument[];
+}
+declare function parseUpoXml(xml: string | Buffer): UpoPotwierdzenie;
+
 interface PollOptions {
     intervalMs?: number;
     maxAttempts?: number;
@@ -2014,6 +2241,7 @@ interface OnlineSessionHandle {
     sendInvoice(invoiceXml: string | Uint8Array): Promise<string>;
     close(): Promise<void>;
     waitForUpo(options?: PollOptions): Promise<UpoInfo>;
+    waitForUpoParsed(options?: PollOptions): Promise<ParsedUpoInfo>;
 }
 interface UpoInfo {
     pages: Array<{
@@ -2024,10 +2252,17 @@ interface UpoInfo {
     successfulInvoiceCount?: number;
     failedInvoiceCount?: number;
 }
+interface ParsedUpoInfo extends UpoInfo {
+    parsed: UpoPotwierdzenie[];
+}
 interface BatchUploadResult {
     sessionRef: string;
     upo: UpoInfo;
 }
+interface ParsedBatchUploadResult {
+    sessionRef: string;
+    upo: ParsedUpoInfo;
+}
 interface ExportResult {
     parts: Array<{
         ordinalNumber: number;
@@ -2041,10 +2276,14 @@ interface ExportResult {
     invoiceCount: number;
     isTruncated: boolean;
     permanentStorageHwmDate?: string;
+    lastPermanentStorageDate?: string;
 }
 interface ExportDownloadResult extends ExportResult {
     decryptedParts: Uint8Array[];
 }
+interface ExportExtractedResult extends ExportResult {
+    files: Map<string, Buffer>;
+}
 
 declare function pollUntil<T>(action: () => Promise<T>, condition: (result: T) => boolean, options?: PollOptions & {
     description?: string;
@@ -2090,11 +2329,16 @@ interface BatchUploadOptions {
     formCode?: FormCode;
     upoVersion?: UpoVersion | string;
     pollOptions?: PollOptions;
+    /** Max unencrypted part size in bytes. Default: 100 MB. */
+    maxPartSize?: number;
+    /** Pass-through to KSeF API. */
+    offlineMode?: boolean;
 }
-interface BatchPart {
-    data: ArrayBuffer;
-}
-declare function uploadBatch(client: KSeFClient, zipParts: BatchPart[], totalFileSize: number, totalFileHash: string, options?: BatchUploadOptions): Promise<BatchUploadResult>;
+declare function uploadBatch(client: KSeFClient, zipData: Uint8Array, options?: BatchUploadOptions): Promise<BatchUploadResult>;
+
+declare function uploadBatchStream(client: KSeFClient, zipStreamFactory: () => ReadableStream<Uint8Array>, zipSize: number, options?: BatchUploadOptions): Promise<BatchUploadResult>;
+declare function uploadBatchStreamParsed(client: KSeFClient, zipStreamFactory: () => ReadableStream<Uint8Array>, zipSize: number, options?: BatchUploadOptions): Promise<ParsedBatchUploadResult>;
+declare function uploadBatchParsed(client: KSeFClient, zipData: Uint8Array, options?: BatchUploadOptions): Promise<ParsedBatchUploadResult>;
 
 interface ExportOptions {
     onlyMetadata?: boolean;
@@ -2103,10 +2347,63 @@ interface ExportOptions {
 interface ExportAndDownloadOptions extends ExportOptions {
     /** Custom fetch function for downloading parts (defaults to global fetch). */
     transport?: typeof fetch;
+    /** When true, concatenate and extract the ZIP, returning named files. */
+    extract?: boolean;
+    /** Options for ZIP extraction safety limits (only used when extract is true). */
+    unzipOptions?: UnzipOptions;
 }
 declare function exportInvoices(client: KSeFClient, filters: InvoiceQueryFilters, options?: ExportOptions): Promise<ExportResult>;
+declare function exportAndDownload(client: KSeFClient, filters: InvoiceQueryFilters, options: ExportAndDownloadOptions & {
+    extract: true;
+}): Promise<ExportExtractedResult>;
 declare function exportAndDownload(client: KSeFClient, filters: InvoiceQueryFilters, options?: ExportAndDownloadOptions): Promise<ExportDownloadResult>;
 
+type ContinuationPoints = Record<string, string | undefined>;
+declare function updateContinuationPoint(points: ContinuationPoints, subjectType: string, pkg: Pick<InvoiceExportPackage, 'isTruncated' | 'lastPermanentStorageDate' | 'permanentStorageHwmDate'>): void;
+declare function getEffectiveStartDate(points: ContinuationPoints, subjectType: string, windowFrom: string): string;
+declare function deduplicateByKsefNumber<T extends {
+    ksefNumber: string;
+}>(entries: T[]): T[];
+
+interface HwmStore {
+    load(): Promise<ContinuationPoints>;
+    save(points: ContinuationPoints): Promise<void>;
+}
+declare class InMemoryHwmStore implements HwmStore {
+    private points;
+    load(): Promise<ContinuationPoints>;
+    save(points: ContinuationPoints): Promise<void>;
+}
+declare class FileHwmStore implements HwmStore {
+    private readonly filePath;
+    constructor(filePath: string);
+    load(): Promise<ContinuationPoints>;
+    save(points: ContinuationPoints): Promise<void>;
+}
+
+interface IncrementalExportOptions {
+    subjectType: InvoiceSubjectType;
+    windowFrom: string;
+    windowTo: string;
+    continuationPoints: ContinuationPoints;
+    maxIterations?: number;
+    filtersFactory?: (from: string, to: string) => InvoiceQueryFilters;
+    pollOptions?: PollOptions;
+    onlyMetadata?: boolean;
+    transport?: typeof fetch;
+    store?: HwmStore;
+    onIterationComplete?: (iteration: number, result: ExportResult) => void;
+}
+interface IncrementalExportResult {
+    referenceNumbers: string[];
+    /** Deduplicated invoice metadata. Empty until P3.2 (UPO Parsing) integrates metadata extraction. */
+    invoices: InvoiceMetadata[];
+    decryptedParts: Uint8Array[];
+    continuationPoints: ContinuationPoints;
+    iterationCount: number;
+}
+declare function incrementalExportAndDownload(client: KSeFClient, options: IncrementalExportOptions): Promise<IncrementalExportResult>;
+
 interface AuthResult {
     accessToken: string;
     accessTokenValidUntil: string;
@@ -2137,6 +2434,14 @@ interface Pkcs12AuthOptions {
 }
 declare function authenticateWithToken(client: KSeFClient, options: TokenAuthOptions): Promise<AuthResult>;
 declare function authenticateWithCertificate(client: KSeFClient, options: CertificateAuthOptions): Promise<AuthResult>;
+interface ExternalSignatureAuthOptions {
+    contextIdentifier: ContextIdentifier;
+    signXml: (unsignedXml: string) => Promise<string> | string;
+    verifyCertificateChain?: boolean;
+    enforceXadesCompliance?: boolean;
+    pollOptions?: PollOptions;
+}
+declare function authenticateWithExternalSignature(client: KSeFClient, options: ExternalSignatureAuthOptions): Promise<AuthResult>;
 declare function authenticateWithPkcs12(client: KSeFClient, options: Pkcs12AuthOptions): Promise<AuthResult>;
 
-export { ActiveSessionsService, type AllowedIps, type AmountType, type ApiErrorResponse, type ApiRateLimitValuesOverride, type ApiRateLimitsOverride, type AttachmentPermissionGrantRequest, type AttachmentPermissionRevokeRequest, type AuthChallengeResponse, type AuthKsefTokenRequest, AuthKsefTokenRequestBuilder, type AuthManager, type AuthResult, AuthService, type AuthSessionInfo, type AuthTokenRequest, AuthTokenRequestBuilder, type AuthenticationInitResponse, type AuthenticationKsefToken, type AuthenticationListResponse, type AuthenticationMethod, type AuthenticationMethodInfo, type AuthenticationMethodInfoCategory, type AuthenticationOperationStatusResponse, type AuthenticationTokenRefreshResponse, type AuthenticationTokensResponse, type AuthorizationGrant, AuthorizationPermissionGrantBuilder, type AuthorizationPolicy, Base64String, type BatchFileInfo, type BatchFilePartInfo, type BatchPart, type BatchPartSendingInfo, type BatchSessionContextLimitsOverride, type BatchSessionEffectiveContextLimits, BatchSessionService, type BatchUploadOptions, type BatchUploadResult, type BlockContextAuthenticationRequest, type BuyerIdentifierType, CERTIFICATE_NAME_MAX_LENGTH, CERTIFICATE_NAME_MIN_LENGTH, CertificateApiService, type CertificateAuthOptions, type CertificateEffectiveSubjectLimits, type CertificateEnrollmentDataResponse, type CertificateEnrollmentStatusResponse, CertificateFetcher, CertificateFingerprint, type CertificateLimit, type CertificateLimitsResponse, type CertificateListItem, CertificateName, type CertificateRevocationReason, CertificateService, type CertificateStatus, type CertificateSubjectIdentifier, type CertificateSubjectIdentifierType, type CertificateSubjectLimitsOverride, type CertificateType, type ContextIdentifier, type ContextIdentifierType, type CryptoEncryptionMethod, CryptographyService, type CsrResult, DefaultAuthManager, ENFORCE_XADES_COMPLIANCE, type EffectiveApiRateLimitValues, type EffectiveApiRateLimits, type EffectiveContextLimits, type EffectiveSubjectLimits, type EncryptionData, type EncryptionInfo, type EnrollCertificateRequest, type EnrollCertificateResponse, type EnrollmentEffectiveSubjectLimits, type EnrollmentSubjectLimitsOverride, type EntityAuthorizationGrant, type EntityAuthorizationPermissionType, type EntityAuthorizationPermissionsSubjectIdentifierType, type EntityAuthorizationSubjectIdentifier, type EntityAuthorizationsAuthorIdentifier, type EntityAuthorizationsAuthorIdentifierType, type EntityAuthorizationsAuthorizedEntityIdentifier, type EntityAuthorizationsAuthorizedEntityIdentifierType, type EntityAuthorizationsAuthorizingEntityIdentifier, type EntityAuthorizationsAuthorizingEntityIdentifierType, type EntityAuthorizationsQueryType, type EntityByFingerprintDetails, type EntityDetails, type EntityPermission, EntityPermissionGrantBuilder, type EntityPermissionItem, type EntityPermissionItemType, type EntityPermissionsContextIdentifier, type EntityPermissionsContextIdentifierType, type EntityRole, type EntityRoleType, type EntityRolesParentEntityIdentifier, type EntityRolesParentEntityIdentifierType, type EntitySubjectByFingerprintDetailsType, type EntitySubjectByIdentifierDetailsType, type EntitySubjectDetailsType, type EntitySubjectIdentifier, Environment, type EnvironmentConfig, type EnvironmentName, type EuEntityAdministrationContextIdentifier, type EuEntityAdministrationPermissionsContextIdentifierType, type EuEntityAdministrationPermissionsSubjectIdentifierType, type EuEntityAdministrationSubjectIdentifier, type EuEntityDetails, type EuEntityPermission, type EuEntityPermissionSubjectDetails, type EuEntityPermissionSubjectDetailsType, type EuEntityPermissionType, type EuEntityPermissionsAuthorIdentifier, type EuEntityPermissionsAuthorIdentifierType, type EuEntityPermissionsQueryPermissionType, type EuEntityPermissionsSubjectIdentifier, type EuEntityPermissionsSubjectIdentifierType, type ExceptionDetails, type ExportAndDownloadOptions, type ExportDownloadResult, type ExportOptions, type ExportResult, type FileMetadata, type ForbiddenProblemDetails, type ForbiddenReasonCode, type FormCode, type FormType, type GrantPermissionsAuthorizationRequest, type GrantPermissionsEntityRequest, type GrantPermissionsEuEntityAdminRequest, type GrantPermissionsEuEntityRepresentativeRequest, type GrantPermissionsEuEntityRequest, type GrantPermissionsIndirectRequest, type GrantPermissionsPersonRequest, type GrantPermissionsSubunitRequest, type HttpMethod, type IdDocument, type IndirectPermissionType, type IndirectPermissionsSubjectIdentifier, type IndirectPermissionsSubjectIdentifierType, type IndirectPermissionsTargetIdentifier, type IndirectPermissionsTargetIdentifierType, InternalId, InvoiceDownloadService, type InvoiceExportPackage, type InvoiceExportPackagePart, type InvoiceExportRequest, type InvoiceExportStatusResponse, type InvoiceMetadata, type InvoiceMetadataAuthorizedSubject, type InvoiceMetadataBuyer, type InvoiceMetadataBuyerIdentifier, type InvoiceMetadataSeller, type InvoiceMetadataThirdSubject, type InvoiceMetadataThirdSubjectIdentifier, type InvoicePermissionType, type InvoiceQueryAmount, type InvoiceQueryBuyerIdentifier, type InvoiceQueryDateRange, type InvoiceQueryDateType, InvoiceQueryFilterBuilder, type InvoiceQueryFilters, type InvoiceStatusInfo, type InvoiceSubjectType, type InvoiceType, type InvoicingMode, Ip4Address, Ip4Mask, Ip4Range, KSEF_FEATURE_HEADER, KSeFApiError, KSeFAuthStatusError, KSeFClient, type KSeFClientOptions, KSeFError, KSeFForbiddenError, KSeFRateLimitError, KSeFSessionExpiredError, KSeFUnauthorizedError, KSeFValidationError, type KsefMessagesResponse, KsefNumber, KsefNumberV35, KsefNumberV36, type KsefStatusResponse, type KsefSystemStatus, type KsefTokenPermissionType, type KsefTokenRequest, type KsefTokenResponse, type KsefTokenStatus, type LighthouseMessage, LighthouseService, LimitsService, Nip, NipVatUe, type OnlineSessionContextLimitsOverride, type OnlineSessionEffectiveContextLimits, type OnlineSessionHandle, OnlineSessionService, type OpenBatchSessionRequest, type OpenBatchSessionResponse, type OpenOnlineSessionOptions, type OpenOnlineSessionRequest, type OpenOnlineSessionResponse, type OperationResponse, type OperationStatusInfo, PERMISSION_DESCRIPTION_MAX_LENGTH, PERMISSION_DESCRIPTION_MIN_LENGTH, type PagedAuthorizationsResponse, type PagedPermissionsResponse, type PagedRolesResponse, type PartUploadRequest, PeppolId, type PeppolProvider, PeppolService, type PermissionState, type PermissionSubjectIdentifierType, type PermissionWithDelegate, type PermissionsAttachmentAllowedResponse, type PermissionsEuEntityDetails, type PermissionsOperationStatusResponse, PermissionsService, type PermissionsSubjectEntityByFingerprintDetails, type PermissionsSubjectEntityByIdentifierDetails, type PermissionsSubjectEntityDetails, type PermissionsSubjectPersonByFingerprintDetails, type PermissionsSubjectPersonDetails, type PersonByFingerprintWithIdentifierDetails, type PersonByFingerprintWithoutIdentifierDetails, type PersonByIdentifierDetails, type PersonCreateRequest, type PersonIdentifier, type PersonIdentifierType, type PersonPermission, PersonPermissionGrantBuilder, type PersonPermissionSubjectDetails, type PersonPermissionType, type PersonPermissionsAuthorIdentifier, type PersonPermissionsAuthorIdentifierType, type PersonPermissionsAuthorizedIdentifier, type PersonPermissionsAuthorizedIdentifierType, type PersonPermissionsContextIdentifier, type PersonPermissionsContextIdentifierType, type PersonPermissionsQueryType, type PersonPermissionsTargetIdentifier, type PersonPermissionsTargetIdentifierType, type PersonRemoveRequest, type PersonSubjectByFingerprintDetailsType, type PersonSubjectDetailsType, type PersonSubjectIdentifier, type PersonalPermission, type PersonalPermissionScopeType, type PersonalPermissionsAuthorizedIdentifier, type PersonalPermissionsAuthorizedIdentifierType, type PersonalPermissionsContextIdentifier, type PersonalPermissionsContextIdentifierType, type PersonalPermissionsTargetIdentifier, type PersonalPermissionsTargetIdentifierType, Pesel, type Pkcs12AuthOptions, Pkcs12Loader, type Pkcs12Result, type PollOptions, type PresignedUrlPolicy, type PublicKeyCertificate, type PublicKeyCertificateUsage, type QRCodeContextIdentifierType, type QrCodeOptions, type QrCodeResult, QrCodeService, type QueryAuthorizationsGrantsRequest, type QueryCertificatesRequest, type QueryCertificatesResponse, type QueryEntitiesGrantsRequest, type QueryEntitiesRolesRequest, type QueryEuEntitiesGrantsRequest, type QueryInvoicesMetadataResponse, type QueryKsefTokensOptions, type QueryKsefTokensResponse, type QueryPeppolProvidersResponse, type QueryPersonalGrantsRequest, type QueryPersonsGrantsRequest, type QuerySubordinateEntitiesRolesRequest, type QuerySubunitsGrantsRequest, type QueryTokensResponseItem, REQUIRED_CHALLENGE_LENGTH, type RateLimitConfig, RateLimitPolicy, ReferenceNumber, type ResolvedOptions, RestClient, RestRequest, type RestResponse, type RetrieveCertificatesListItem, type RetrieveCertificatesRequest, type RetrieveCertificatesResponse, type RetryPolicy, type RevokeCertificateRequest, RouteBuilder, Routes, SUBUNIT_NAME_MAX_LENGTH, SUBUNIT_NAME_MIN_LENGTH, type SelfSignedCertificateResult, type SendAndCloseOptions, type SendInvoiceRequest, type SendInvoiceResponse, type SessionInvoiceStatusResponse, type SessionInvoicesResponse, type SessionStatus, type SessionStatusResponse, SessionStatusService, type SessionType, type SessionsFilter, type SessionsQueryResponse, type SessionsQueryResponseItem, type SetRateLimitsRequest, type SetSessionLimitsRequest, type SetSubjectLimitsRequest, Sha256Base64, SignatureService, type SortOrder, type StatusInfo, type SubjectCreateRequest, type SubjectRemoveRequest, type SubjectType, type SubordinateEntityRole, type SubordinateEntityRoleType, type SubordinateRoleSubordinateEntityIdentifier, type SubordinateRoleSubordinateEntityIdentifierType, type Subunit, type SubunitPermission, type SubunitPermissionScope, type SubunitPermissionsAuthorIdentifier, type SubunitPermissionsAuthorIdentifierType, type SubunitPermissionsAuthorizedIdentifier, type SubunitPermissionsContextIdentifier, type SubunitPermissionsContextIdentifierType, type SubunitPermissionsSubjectIdentifier, type SubunitPermissionsSubjectIdentifierType, type SubunitPermissionsSubunitIdentifier, type SubunitPermissionsSubunitIdentifierType, type TestDataAuthenticationContextIdentifier, type TestDataAuthenticationContextIdentifierType, type TestDataAuthorizedIdentifier, type TestDataAuthorizedIdentifierType, type TestDataContextIdentifier, type TestDataContextIdentifierType, type TestDataPermission, type TestDataPermissionType, type TestDataPermissionsGrantRequest, type TestDataPermissionsRevokeRequest, TestDataService, type ThirdSubjectIdentifierType, type TokenAuthOptions, type TokenAuthorIdentifier, type TokenAuthorIdentifierType, type TokenContextIdentifier, type TokenContextIdentifierType, type TokenInfo, TokenService, type TokenStatusResponse, type TransportFn, type UnauthorizedProblemDetails, type UnblockContextAuthenticationRequest, type UpoInfo, type UpoPage, type UpoResponse, type UpoResult, UpoVersion, UpoVersion as UpoVersionType, type ValidationDetail, VatUe, VerificationLinkService, type X500NameFields, type XadesSubjectIdentifierType, authenticateWithCertificate, authenticateWithPkcs12, authenticateWithToken, calculateBackoff, defaultPresignedUrlPolicy, defaultRateLimitPolicy, defaultRetryPolicy, defaultTransport, exportAndDownload, exportInvoices, isRetryableError, isRetryableStatus, isValidBase64, isValidCertificateFingerprint, isValidCertificateName, isValidInternalId, isValidIp4Address, isValidKsefNumber, isValidKsefNumberV35, isValidKsefNumberV36, isValidNip, isValidNipVatUe, isValidPeppolId, isValidPesel, isValidReferenceNumber, isValidSha256Base64, isValidVatUe, openOnlineSession, openSendAndClose, parseRetryAfter, pollUntil, resolveOptions, sleep, uploadBatch, validatePresignedUrl };
+export { ActiveSessionsService, type AllowedIps, type AmountType, type ApiErrorResponse, type ApiRateLimitValuesOverride, type ApiRateLimitsOverride, type AttachmentPermissionGrantRequest, type AttachmentPermissionRevokeRequest, type AuthChallengeResponse, type AuthKsefTokenRequest, AuthKsefTokenRequestBuilder, type AuthManager, type AuthResult, AuthService, type AuthSessionInfo, type AuthTokenRequest, AuthTokenRequestBuilder, type AuthTokenRequestXmlOptions, type AuthenticationInitResponse, type AuthenticationKsefToken, type AuthenticationListResponse, type AuthenticationMethod, type AuthenticationMethodInfo, type AuthenticationMethodInfoCategory, type AuthenticationOperationStatusResponse, type AuthenticationTokenRefreshResponse, type AuthenticationTokensResponse, type AuthorizationGrant, AuthorizationPermissionGrantBuilder, type AuthorizationPolicy, BATCH_MAX_PARTS, BATCH_MAX_PART_SIZE, BATCH_MAX_TOTAL_SIZE, Base64String, type BatchFileBuildOptions, type BatchFileBuildResult, BatchFileBuilder, type BatchFileInfo, type BatchFilePartInfo, type BatchPartSendingInfo, type BatchPartStreamSendingInfo, type BatchSessionContextLimitsOverride, type BatchSessionEffectiveContextLimits, type BatchSessionFormCode, BatchSessionService, type BatchStreamBuildResult, type BatchUploadOptions, type BatchUploadResult, type BlockContextAuthenticationRequest, type BuyerIdentifierType, CERTIFICATE_NAME_MAX_LENGTH, CERTIFICATE_NAME_MIN_LENGTH, CertificateApiService, type CertificateAuthOptions, type CertificateEffectiveSubjectLimits, type CertificateEnrollmentDataResponse, type CertificateEnrollmentStatusResponse, CertificateFetcher, CertificateFingerprint, type CertificateLimit, type CertificateLimitsResponse, type CertificateListItem, CertificateName, type CertificateRevocationReason, CertificateService, type CertificateStatus, type CertificateSubjectIdentifier, type CertificateSubjectIdentifierType, type CertificateSubjectLimitsOverride, type CertificateType, type ContextIdentifier, type ContextIdentifierType, type ContinuationPoints, type CryptoEncryptionMethod, CryptographyService, type CsrResult, DefaultAuthManager, ENFORCE_XADES_COMPLIANCE, type EffectiveApiRateLimitValues, type EffectiveApiRateLimits, type EffectiveContextLimits, type EffectiveSubjectLimits, type EncryptionData, type EncryptionInfo, type EnrollCertificateRequest, type EnrollCertificateResponse, type EnrollmentEffectiveSubjectLimits, type EnrollmentSubjectLimitsOverride, type EntityAuthorizationGrant, type EntityAuthorizationPermissionType, type EntityAuthorizationPermissionsSubjectIdentifierType, type EntityAuthorizationSubjectIdentifier, type EntityAuthorizationsAuthorIdentifier, type EntityAuthorizationsAuthorIdentifierType, type EntityAuthorizationsAuthorizedEntityIdentifier, type EntityAuthorizationsAuthorizedEntityIdentifierType, type EntityAuthorizationsAuthorizingEntityIdentifier, type EntityAuthorizationsAuthorizingEntityIdentifierType, type EntityAuthorizationsQueryType, type EntityByFingerprintDetails, type EntityDetails, type EntityPermission, EntityPermissionGrantBuilder, type EntityPermissionItem, type EntityPermissionItemType, type EntityPermissionsContextIdentifier, type EntityPermissionsContextIdentifierType, type EntityRole, type EntityRoleType, type EntityRolesParentEntityIdentifier, type EntityRolesParentEntityIdentifierType, type EntitySubjectByFingerprintDetailsType, type EntitySubjectByIdentifierDetailsType, type EntitySubjectDetailsType, type EntitySubjectIdentifier, Environment, type EnvironmentConfig, type EnvironmentName, type EuEntityAdministrationContextIdentifier, type EuEntityAdministrationPermissionsContextIdentifierType, type EuEntityAdministrationPermissionsSubjectIdentifierType, type EuEntityAdministrationSubjectIdentifier, type EuEntityDetails, type EuEntityPermission, type EuEntityPermissionSubjectDetails, type EuEntityPermissionSubjectDetailsType, type EuEntityPermissionType, type EuEntityPermissionsAuthorIdentifier, type EuEntityPermissionsAuthorIdentifierType, type EuEntityPermissionsQueryPermissionType, type EuEntityPermissionsSubjectIdentifier, type EuEntityPermissionsSubjectIdentifierType, type ExceptionDetails, type ExportAndDownloadOptions, type ExportDownloadResult, type ExportExtractedResult, type ExportOptions, type ExportResult, type ExternalSignatureAuthOptions, FORM_CODES, FORM_CODE_KEYS, FileHwmStore, type FileMetadata, type ForbiddenProblemDetails, type ForbiddenReasonCode, type FormCode, type FormType, type GrantPermissionsAuthorizationRequest, type GrantPermissionsEntityRequest, type GrantPermissionsEuEntityAdminRequest, type GrantPermissionsEuEntityRepresentativeRequest, type GrantPermissionsEuEntityRequest, type GrantPermissionsIndirectRequest, type GrantPermissionsPersonRequest, type GrantPermissionsSubunitRequest, type HttpMethod, type HwmStore, INVOICE_TYPES_BY_SYSTEM_CODE, type IdDocument, InMemoryHwmStore, type IncrementalExportOptions, type IncrementalExportResult, type IndirectPermissionType, type IndirectPermissionsSubjectIdentifier, type IndirectPermissionsSubjectIdentifierType, type IndirectPermissionsTargetIdentifier, type IndirectPermissionsTargetIdentifierType, InternalId, InvoiceDownloadService, type InvoiceExportPackage, type InvoiceExportPackagePart, type InvoiceExportRequest, type InvoiceExportStatusResponse, type InvoiceMetadata, type InvoiceMetadataAuthorizedSubject, type InvoiceMetadataBuyer, type InvoiceMetadataBuyerIdentifier, type InvoiceMetadataSeller, type InvoiceMetadataThirdSubject, type InvoiceMetadataThirdSubjectIdentifier, type InvoicePermissionType, type InvoiceQueryAmount, type InvoiceQueryBuyerIdentifier, type InvoiceQueryDateRange, type InvoiceQueryDateType, InvoiceQueryFilterBuilder, type InvoiceQueryFilters, type InvoiceStatusInfo, type InvoiceSubjectType, type InvoiceType, type InvoicingMode, Ip4Address, Ip4Mask, Ip4Range, KSEF_FEATURE_HEADER, KSeFApiError, KSeFAuthStatusError, KSeFClient, type KSeFClientOptions, KSeFError, KSeFForbiddenError, KSeFRateLimitError, KSeFSessionExpiredError, KSeFUnauthorizedError, KSeFValidationError, type KsefMessagesResponse, KsefNumber, KsefNumberV35, KsefNumberV36, type KsefStatusResponse, type KsefSystemStatus, type KsefTokenPermissionType, type KsefTokenRequest, type KsefTokenResponse, type KsefTokenStatus, type LighthouseMessage, LighthouseService, LimitsService, Nip, NipVatUe, type OnlineSessionContextLimitsOverride, type OnlineSessionEffectiveContextLimits, type OnlineSessionFormCode, type OnlineSessionHandle, OnlineSessionService, type OpenBatchSessionRequest, type OpenBatchSessionResponse, type OpenOnlineSessionOptions, type OpenOnlineSessionRequest, type OpenOnlineSessionResponse, type OperationResponse, type OperationStatusInfo, PERMISSION_DESCRIPTION_MAX_LENGTH, PERMISSION_DESCRIPTION_MIN_LENGTH, type PagedAuthorizationsResponse, type PagedPermissionsResponse, type PagedRolesResponse, type ParsedBatchUploadResult, type ParsedUpoInfo, type PartUploadRequest, PeppolId, type PeppolProvider, PeppolService, type PermissionState, type PermissionSubjectIdentifierType, type PermissionWithDelegate, type PermissionsAttachmentAllowedResponse, type PermissionsEuEntityDetails, type PermissionsOperationStatusResponse, PermissionsService, type PermissionsSubjectEntityByFingerprintDetails, type PermissionsSubjectEntityByIdentifierDetails, type PermissionsSubjectEntityDetails, type PermissionsSubjectPersonByFingerprintDetails, type PermissionsSubjectPersonDetails, type PersonByFingerprintWithIdentifierDetails, type PersonByFingerprintWithoutIdentifierDetails, type PersonByIdentifierDetails, type PersonCreateRequest, type PersonIdentifier, type PersonIdentifierType, type PersonPermission, PersonPermissionGrantBuilder, type PersonPermissionSubjectDetails, type PersonPermissionType, type PersonPermissionsAuthorIdentifier, type PersonPermissionsAuthorIdentifierType, type PersonPermissionsAuthorizedIdentifier, type PersonPermissionsAuthorizedIdentifierType, type PersonPermissionsContextIdentifier, type PersonPermissionsContextIdentifierType, type PersonPermissionsQueryType, type PersonPermissionsTargetIdentifier, type PersonPermissionsTargetIdentifierType, type PersonRemoveRequest, type PersonSubjectByFingerprintDetailsType, type PersonSubjectDetailsType, type PersonSubjectIdentifier, type PersonalPermission, type PersonalPermissionScopeType, type PersonalPermissionsAuthorizedIdentifier, type PersonalPermissionsAuthorizedIdentifierType, type PersonalPermissionsContextIdentifier, type PersonalPermissionsContextIdentifierType, type PersonalPermissionsTargetIdentifier, type PersonalPermissionsTargetIdentifierType, Pesel, type Pkcs12AuthOptions, Pkcs12Loader, type Pkcs12Result, type PollOptions, type PresignedUrlPolicy, type PublicKeyCertificate, type PublicKeyCertificateUsage, type QRCodeContextIdentifierType, type QrCodeOptions, type QrCodeResult, QrCodeService, type QueryAuthorizationsGrantsRequest, type QueryCertificatesRequest, type QueryCertificatesResponse, type QueryEntitiesGrantsRequest, type QueryEntitiesRolesRequest, type QueryEuEntitiesGrantsRequest, type QueryInvoicesMetadataResponse, type QueryKsefTokensOptions, type QueryKsefTokensResponse, type QueryPeppolProvidersResponse, type QueryPersonalGrantsRequest, type QueryPersonsGrantsRequest, type QuerySubordinateEntitiesRolesRequest, type QuerySubunitsGrantsRequest, type QueryTokensResponseItem, REQUIRED_CHALLENGE_LENGTH, type RateLimitConfig, RateLimitPolicy, ReferenceNumber, type ResolvedOptions, RestClient, RestRequest, type RestResponse, type RetrieveCertificatesListItem, type RetrieveCertificatesRequest, type RetrieveCertificatesResponse, type RetryPolicy, type RevokeCertificateRequest, RouteBuilder, Routes, SUBUNIT_NAME_MAX_LENGTH, SUBUNIT_NAME_MIN_LENGTH, type SelfSignedCertificateResult, type SendAndCloseOptions, type SendInvoiceRequest, type SendInvoiceResponse, type SessionInvoiceStatusResponse, type SessionInvoicesResponse, type SessionStatus, type SessionStatusResponse, SessionStatusService, type SessionType, type SessionsFilter, type SessionsQueryResponse, type SessionsQueryResponseItem, type SetRateLimitsRequest, type SetSessionLimitsRequest, type SetSubjectLimitsRequest, Sha256Base64, SignatureService, type SortOrder, type StatusInfo, type SubjectCreateRequest, type SubjectRemoveRequest, type SubjectType, type SubordinateEntityRole, type SubordinateEntityRoleType, type SubordinateRoleSubordinateEntityIdentifier, type SubordinateRoleSubordinateEntityIdentifierType, type Subunit, type SubunitPermission, type SubunitPermissionScope, type SubunitPermissionsAuthorIdentifier, type SubunitPermissionsAuthorIdentifierType, type SubunitPermissionsAuthorizedIdentifier, type SubunitPermissionsContextIdentifier, type SubunitPermissionsContextIdentifierType, type SubunitPermissionsSubjectIdentifier, type SubunitPermissionsSubjectIdentifierType, type SubunitPermissionsSubunitIdentifier, type SubunitPermissionsSubunitIdentifierType, SystemCode, type TestDataAuthenticationContextIdentifier, type TestDataAuthenticationContextIdentifierType, type TestDataAuthorizedIdentifier, type TestDataAuthorizedIdentifierType, type TestDataContextIdentifier, type TestDataContextIdentifierType, type TestDataPermission, type TestDataPermissionType, type TestDataPermissionsGrantRequest, type TestDataPermissionsRevokeRequest, TestDataService, type ThirdSubjectIdentifierType, type TokenAuthOptions, type TokenAuthorIdentifier, type TokenAuthorIdentifierType, type TokenContextIdentifier, type TokenContextIdentifierType, type TokenInfo, TokenService, type TokenStatusResponse, type TransportFn, type UnauthorizedProblemDetails, type UnblockContextAuthenticationRequest, type UnzipOptions, type UpoAuthProof, type UpoContextId, type UpoDokument, type UpoInfo, type UpoOpisPotwierdzenia, type UpoPage, type UpoPotwierdzenie, type UpoResponse, type UpoResult, type UpoUwierzytelnienie, UpoVersion, UpoVersion as UpoVersionType, type ValidationDetail, VatUe, VerificationLinkService, type X500NameFields, type XadesSubjectIdentifierType, type ZipEntryInput, authenticateWithCertificate, authenticateWithExternalSignature, authenticateWithPkcs12, authenticateWithToken, buildUnsignedAuthTokenRequestXml, calculateBackoff, createZip, deduplicateByKsefNumber, defaultPresignedUrlPolicy, defaultRateLimitPolicy, defaultRetryPolicy, defaultTransport, exportAndDownload, exportInvoices, getEffectiveStartDate, getFormCode, incrementalExportAndDownload, isRetryableError, isRetryableStatus, isValidBase64, isValidCertificateFingerprint, isValidCertificateName, isValidInternalId, isValidIp4Address, isValidKsefNumber, isValidKsefNumberV35, isValidKsefNumberV36, isValidNip, isValidNipVatUe, isValidPeppolId, isValidPesel, isValidReferenceNumber, isValidSha256Base64, isValidVatUe, openOnlineSession, openSendAndClose, parseFormCode, parseRetryAfter, parseUpoXml, pollUntil, resolveOptions, sleep, unzip, updateContinuationPoint, uploadBatch, uploadBatchParsed, uploadBatchStream, uploadBatchStreamParsed, validateFormCodeForSession, validatePresignedUrl };