@epostak/sdk 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,473 @@
+export type InvoiceResponseCode = "AP" | "RE" | "UQ";
+export type WebhookEvent = "document.created" | "document.sent" | "document.received" | "document.validated";
+export type DocumentDirection = "inbound" | "outbound";
+export type ConvertDirection = "json_to_ubl" | "ubl_to_json";
+export type InboxStatus = "RECEIVED" | "ACKNOWLEDGED";
+export interface LineItem {
+    description: string;
+    quantity: number;
+    /** UN/CEFACT unit code, e.g. HUR = hours, C62 = pieces, KGM = kg */
+    unit?: string;
+    unitPrice: number;
+    /** VAT rate in percent, e.g. 23 */
+    vatRate: number;
+    /** Optional discount in percent */
+    discount?: number;
+}
+export interface LineItemResponse {
+    description: string;
+    quantity: number;
+    unit?: string;
+    unitPrice: number;
+    vatRate: number;
+    vatCategory?: string;
+    lineTotal: number;
+}
+export interface PartyAddress {
+    street?: string;
+    city?: string;
+    zip?: string;
+    country?: string;
+}
+export interface Party {
+    name?: string;
+    ico?: string;
+    dic?: string;
+    icDph?: string;
+    address?: PartyAddress;
+    peppolId?: string;
+}
+export interface SendDocumentJsonRequest {
+    receiverPeppolId: string;
+    invoiceNumber?: string;
+    issueDate?: string;
+    dueDate?: string;
+    currency?: string;
+    note?: string;
+    iban?: string;
+    paymentMethod?: string;
+    variableSymbol?: string;
+    buyerReference?: string;
+    receiverName?: string;
+    receiverIco?: string;
+    receiverDic?: string;
+    receiverIcDph?: string;
+    receiverAddress?: string;
+    receiverCountry?: string;
+    items: LineItem[];
+}
+export interface SendDocumentXmlRequest {
+    receiverPeppolId: string;
+    xml: string;
+}
+export type SendDocumentRequest = SendDocumentJsonRequest | SendDocumentXmlRequest;
+export interface SendDocumentResponse {
+    documentId: string;
+    messageId: string;
+    status: "SENT";
+}
+export interface UpdateDocumentRequest {
+    invoiceNumber?: string;
+    issueDate?: string;
+    dueDate?: string | null;
+    currency?: string;
+    note?: string | null;
+    iban?: string | null;
+    variableSymbol?: string | null;
+    buyerReference?: string | null;
+    receiverName?: string;
+    receiverIco?: string | null;
+    receiverDic?: string | null;
+    receiverIcDph?: string | null;
+    receiverAddress?: string | null;
+    receiverCountry?: string | null;
+    receiverPeppolId?: string | null;
+    items?: LineItem[];
+}
+export interface DocumentTotals {
+    withoutVat: number;
+    vat: number;
+    withVat: number;
+}
+/** Document as returned by the API (same shape for sent and received). */
+export interface InboxDocument {
+    id: string;
+    number: string;
+    status: string;
+    direction: DocumentDirection;
+    docType: string;
+    issueDate: string;
+    dueDate: string | null;
+    currency: string;
+    supplier: Party;
+    customer: Party;
+    lines: LineItemResponse[];
+    totals: DocumentTotals;
+    peppolMessageId: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface InboxListParams {
+    offset?: number;
+    limit?: number;
+    status?: InboxStatus;
+    /** ISO 8601 timestamp — only return documents created after this date */
+    since?: string;
+}
+export interface InboxListResponse {
+    documents: InboxDocument[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface InboxDocumentDetailResponse {
+    document: InboxDocument;
+    /** UBL XML content, null if not available */
+    payload: string | null;
+}
+export interface AcknowledgeResponse {
+    documentId: string;
+    status: "ACKNOWLEDGED";
+    acknowledgedAt: string;
+}
+export interface InboxAllParams {
+    offset?: number;
+    limit?: number;
+    status?: InboxStatus;
+    /** ISO 8601 timestamp — only return documents created after this date */
+    since?: string;
+    /** Filter to a specific firm UUID */
+    firm_id?: string;
+}
+export interface InboxAllDocument {
+    firm_id: string;
+    firm_name: string | null;
+    id: string;
+    number: string | null;
+    status: string;
+    direction: string;
+    doc_type: string;
+    issue_date: string | null;
+    due_date: string | null;
+    currency: string;
+    supplier: {
+        name: string | null;
+        ico: string | null;
+        peppol_id: string | null;
+    };
+    customer: {
+        name: string | null;
+        ico: string | null;
+        peppol_id: string | null;
+    };
+    totals: {
+        without_vat: number | null;
+        vat: number | null;
+        with_vat: number | null;
+    };
+    peppol_message_id: string | null;
+    created_at: string;
+}
+export interface InboxAllResponse {
+    documents: InboxAllDocument[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface StatusHistoryEntry {
+    status: string;
+    timestamp: string;
+    detail: string | null;
+}
+export interface DocumentStatusResponse {
+    id: string;
+    status: string;
+    documentType: string | null;
+    senderPeppolId: string | null;
+    receiverPeppolId: string | null;
+    statusHistory: StatusHistoryEntry[];
+    validationResult: Record<string, unknown> | null;
+    deliveredAt: string | null;
+    acknowledgedAt: string | null;
+    invoiceResponseStatus: InvoiceResponseCode | null;
+    as4MessageId: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DocumentEvidenceResponse {
+    documentId: string;
+    as4Receipt: Record<string, unknown> | null;
+    mlrDocument: Record<string, unknown> | null;
+    invoiceResponse: {
+        status: InvoiceResponseCode | null;
+        document: Record<string, unknown>;
+    } | null;
+    deliveredAt: string | null;
+    sentAt: string | null;
+}
+export interface InvoiceRespondRequest {
+    /** AP = accepted, RE = rejected, UQ = under query */
+    status: InvoiceResponseCode;
+    note?: string;
+}
+export interface InvoiceRespondResponse {
+    documentId: string;
+    responseStatus: InvoiceResponseCode;
+    respondedAt: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    warnings: string[];
+    /** Generated UBL XML, only present for JSON mode requests */
+    ubl: string | null;
+}
+export interface PreflightRequest {
+    receiverPeppolId: string;
+    documentTypeId?: string;
+}
+export interface PreflightResult {
+    receiverPeppolId: string;
+    registered: boolean;
+    supportsDocumentType: boolean;
+    smpUrl: string | null;
+}
+export interface ConvertRequest {
+    direction: ConvertDirection;
+    /** JSON document data (for json_to_ubl) */
+    data?: Record<string, unknown>;
+    /** UBL XML string (for ubl_to_json) */
+    xml?: string;
+}
+export interface ConvertResult {
+    direction: ConvertDirection;
+    /** UBL XML string for json_to_ubl, parsed object for ubl_to_json */
+    result: string | Record<string, unknown>;
+}
+export interface SmpParticipantCapability {
+    documentTypeId: string;
+    processId: string;
+    transportProfile: string;
+}
+export interface PeppolParticipant {
+    peppolId: string;
+    name: string | null;
+    country: string | null;
+    capabilities: SmpParticipantCapability[];
+}
+export interface DirectorySearchParams {
+    q?: string;
+    country?: string;
+    page?: number;
+    page_size?: number;
+}
+export interface DirectoryEntry {
+    peppolId: string;
+    name: string;
+    country: string;
+    registeredAt: string | null;
+}
+export interface DirectorySearchResult {
+    results: DirectoryEntry[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+export interface CompanyLookup {
+    ico: string;
+    name: string;
+    dic: string | null;
+    icDph: string | null;
+    address?: PartyAddress;
+    peppolId: string | null;
+}
+export interface FirmSummary {
+    id: string;
+    name: string;
+    ico: string | null;
+    peppolId: string | null;
+    peppolStatus: string;
+}
+export interface FirmPeppolIdentifier {
+    scheme: string;
+    identifier: string;
+}
+export interface FirmDetail extends FirmSummary {
+    dic: string | null;
+    icDph: string | null;
+    address?: PartyAddress;
+    peppolIdentifiers: FirmPeppolIdentifier[];
+    createdAt: string;
+}
+export interface FirmsListResponse {
+    firms: FirmSummary[];
+}
+export interface FirmDocumentsParams {
+    offset?: number;
+    limit?: number;
+    direction?: DocumentDirection;
+}
+export interface PeppolIdentifierResponse {
+    peppolId: string;
+    scheme: string;
+    identifier: string;
+    registeredAt: string;
+}
+export interface AssignFirmRequest {
+    /** Slovak ICO (8 digits) */
+    ico: string;
+}
+export interface AssignFirmResponse {
+    firm: {
+        id: string;
+        name: string | null;
+        ico: string | null;
+        peppol_id: string | null;
+        peppol_status: string;
+    };
+    status: "active";
+}
+export interface BatchAssignFirmsRequest {
+    /** Array of Slovak ICOs (8 digits each, max 50) */
+    icos: string[];
+}
+export interface BatchAssignFirmResult {
+    ico: string;
+    firm?: {
+        id: string;
+        name: string | null;
+        ico: string | null;
+        peppol_id: string | null;
+        peppol_status: string;
+    };
+    status?: "active" | "already_assigned";
+    error?: string;
+    message?: string;
+}
+export interface BatchAssignFirmsResponse {
+    results: BatchAssignFirmResult[];
+}
+export interface CreateWebhookRequest {
+    url: string;
+    events?: WebhookEvent[];
+}
+export interface UpdateWebhookRequest {
+    url?: string;
+    events?: WebhookEvent[];
+    isActive?: boolean;
+}
+export interface Webhook {
+    id: string;
+    url: string;
+    events: WebhookEvent[];
+    isActive: boolean;
+    createdAt: string;
+}
+export interface WebhookDetail extends Webhook {
+    /** HMAC-SHA256 signing secret — only returned on creation */
+    secret?: string;
+}
+export interface WebhookDelivery {
+    id: string;
+    webhookId: string;
+    event: string;
+    status: string;
+    attempts: number;
+    responseStatus: number | null;
+    createdAt: string;
+}
+export interface WebhookWithDeliveries extends Webhook {
+    deliveries: WebhookDelivery[];
+}
+export interface WebhookListResponse {
+    data: Webhook[];
+}
+export interface WebhookQueueParams {
+    /** Max items to return (1–100, default 20) */
+    limit?: number;
+    /** Filter by event type, e.g. 'document.received' */
+    event_type?: string;
+}
+export interface WebhookQueueItem {
+    id: string;
+    type: string;
+    created_at: string;
+    payload: Record<string, unknown>;
+}
+export interface WebhookQueueResponse {
+    items: WebhookQueueItem[];
+    has_more: boolean;
+}
+export interface WebhookQueueAllParams {
+    /** Max items to return (1–500, default 100) */
+    limit?: number;
+    /** ISO 8601 timestamp — only return events created after this date */
+    since?: string;
+}
+export interface WebhookQueueAllEvent {
+    event_id: string;
+    firm_id: string;
+    event: string;
+    payload: Record<string, unknown>;
+    created_at: string;
+}
+export interface WebhookQueueAllResponse {
+    events: WebhookQueueAllEvent[];
+    count: number;
+}
+export interface StatisticsParams {
+    from?: string;
+    to?: string;
+}
+export interface Statistics {
+    period: {
+        from: string;
+        to: string;
+    };
+    outbound: {
+        total: number;
+        delivered: number;
+        failed: number;
+    };
+    inbound: {
+        total: number;
+        acknowledged: number;
+        pending: number;
+    };
+}
+export interface Account {
+    firm: {
+        name: string;
+        ico: string | null;
+        peppolId: string | null;
+        peppolStatus: string;
+    };
+    plan: {
+        name: string;
+        status: "active" | "expired";
+    };
+    usage: {
+        outbound: number;
+        inbound: number;
+    };
+}
+export interface ExtractResult {
+    extraction: Record<string, unknown>;
+    ubl_xml: string;
+    confidence: number;
+    file_name: string;
+}
+export interface BatchExtractItem {
+    file_name: string;
+    extraction?: Record<string, unknown>;
+    ubl_xml?: string;
+    confidence?: string;
+    error?: string;
+}
+export interface BatchExtractResult {
+    batch_id: string;
+    total: number;
+    successful: number;
+    failed: number;
+    results: BatchExtractItem[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Shared primitives
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Error thrown when an API request fails.
+ */
+export declare class EPostakError extends Error {
+    /** HTTP status code */
+    status: number;
+    /** Machine-readable error code from the API */
+    code?: string;
+    /** Additional error details (validation messages, etc.) */
+    details?: unknown;
+    constructor(status: number, body: Record<string, unknown>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEN,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAuB1D"}

package/dist/utils/errors.js

@@ -0,0 +1,32 @@
+/**
+ * Error thrown when an API request fails.
+ */
+export class EPostakError extends Error {
+    /** HTTP status code */
+    status;
+    /** Machine-readable error code from the API */
+    code;
+    /** Additional error details (validation messages, etc.) */
+    details;
+    constructor(status, body) {
+        const errorObj = body?.error;
+        const errorObjMap = errorObj !== null && typeof errorObj === "object"
+            ? errorObj
+            : null;
+        const msg = typeof errorObj === "string"
+            ? errorObj
+            : errorObjMap && "message" in errorObjMap
+                ? String(errorObjMap.message)
+                : "API request failed";
+        super(msg);
+        this.name = "EPostakError";
+        this.status = status;
+        if (errorObjMap) {
+            if ("code" in errorObjMap)
+                this.code = String(errorObjMap.code);
+            if ("details" in errorObjMap)
+                this.details = errorObjMap.details;
+        }
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,uBAAuB;IACvB,MAAM,CAAS;IACf,+CAA+C;IAC/C,IAAI,CAAU;IACd,2DAA2D;IAC3D,OAAO,CAAW;IAElB,YAAY,MAAc,EAAE,IAA6B;QACvD,MAAM,QAAQ,GAAG,IAAI,EAAE,KAAK,CAAC;QAC7B,MAAM,WAAW,GACf,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAC/C,CAAC,CAAE,QAAoC;YACvC,CAAC,CAAC,IAAI,CAAC;QAEX,MAAM,GAAG,GACP,OAAO,QAAQ,KAAK,QAAQ;YAC1B,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,WAAW,IAAI,SAAS,IAAI,WAAW;gBACvC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC;gBAC7B,CAAC,CAAC,oBAAoB,CAAC;QAE7B,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,MAAM,IAAI,WAAW;gBAAE,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAChE,IAAI,SAAS,IAAI,WAAW;gBAAE,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;QACnE,CAAC;IACH,CAAC;CACF"}

package/dist/utils/request.d.ts

@@ -0,0 +1,28 @@
+export interface ClientConfig {
+    baseUrl: string;
+    apiKey: string;
+    firmId: string | undefined;
+}
+export declare class BaseResource {
+    protected config: ClientConfig;
+    constructor(config: ClientConfig);
+    protected request<T>(method: string, path: string, body?: unknown, options?: {
+        headers?: Record<string, string>;
+        rawResponse?: boolean;
+    }): Promise<T>;
+}
+/**
+ * Build a query string from a params object, skipping undefined values.
+ * Number values are coerced to strings automatically.
+ */
+export declare function buildQuery(params: Record<string, string | number | undefined>): string;
+/**
+ * Core fetch wrapper used by all resource methods.
+ * Handles auth headers, JSON serialisation, FormData pass-through, and error
+ * normalisation.
+ */
+export declare function request<T>(baseUrl: string, apiKey: string, firmId: string | undefined, method: string, path: string, body?: unknown, options?: {
+    headers?: Record<string, string>;
+    rawResponse?: boolean;
+}): Promise<T>;
+//# sourceMappingURL=request.d.ts.map

package/dist/utils/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/utils/request.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,qBAAa,YAAY;IACX,SAAS,CAAC,MAAM,EAAE,YAAY;gBAApB,MAAM,EAAE,YAAY;IAE1C,SAAS,CAAC,OAAO,CAAC,CAAC,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GACpE,OAAO,CAAC,CAAC,CAAC;CAWd;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAClD,MAAM,CAOR;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACpE,OAAO,CAAC,CAAC,CAAC,CAsDZ"}

package/dist/utils/request.js

@@ -0,0 +1,79 @@
+import { EPostakError } from "./errors.js";
+export class BaseResource {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    request(method, path, body, options) {
+        return request(this.config.baseUrl, this.config.apiKey, this.config.firmId, method, path, body, options);
+    }
+}
+/**
+ * Build a query string from a params object, skipping undefined values.
+ * Number values are coerced to strings automatically.
+ */
+export function buildQuery(params) {
+    const qs = new URLSearchParams();
+    for (const [key, val] of Object.entries(params)) {
+        if (val !== undefined)
+            qs.set(key, String(val));
+    }
+    const s = qs.toString();
+    return s ? `?${s}` : "";
+}
+/**
+ * Core fetch wrapper used by all resource methods.
+ * Handles auth headers, JSON serialisation, FormData pass-through, and error
+ * normalisation.
+ */
+export async function request(baseUrl, apiKey, firmId, method, path, body, options) {
+    const headers = {
+        Authorization: `Bearer ${apiKey}`,
+        ...options?.headers,
+    };
+    if (firmId) {
+        headers["X-Firm-Id"] = firmId;
+    }
+    if (body !== undefined && !(body instanceof FormData)) {
+        headers["Content-Type"] = "application/json";
+    }
+    let fetchBody = null;
+    if (body instanceof FormData) {
+        fetchBody = body;
+    }
+    else if (body !== undefined) {
+        fetchBody = JSON.stringify(body);
+    }
+    let res;
+    try {
+        res = await fetch(`${baseUrl}${path}`, {
+            method,
+            headers,
+            body: fetchBody,
+        });
+    }
+    catch (err) {
+        throw new EPostakError(0, {
+            error: err instanceof Error ? err.message : "Network error",
+        });
+    }
+    if (!res.ok) {
+        let errorBody = {};
+        try {
+            errorBody = (await res.json());
+        }
+        catch {
+            errorBody = { error: res.statusText };
+        }
+        throw new EPostakError(res.status, errorBody);
+    }
+    if (options?.rawResponse) {
+        return res;
+    }
+    // Handle 204 No Content (e.g. DELETE ack, batch-ack)
+    if (res.status === 204 || res.headers.get("content-length") === "0") {
+        return undefined;
+    }
+    return res.json();
+}
+//# sourceMappingURL=request.js.map

package/dist/utils/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/utils/request.ts"],"names":[],"mappings":"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"}