@moatless/ledgit-client 0.2.0

package/dist/client.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Ledgit API Client
+ *
+ * Company is derived from the JWT token, not passed in requests.
+ */
+import { type BinaryDownloadResult } from "@moatless/api-client";
+import type { JournalEntry, Document, FiscalYear, LedgerAccount } from "@moatless/bookkeeping-types";
+import type { LedgitClientConfig, CompanyInfo, CompanyWithInbox, CreateCompanyRequest, CreateJournalEntryRequest, FileUploadOptions, InboxItem } from "./types";
+export declare class LedgitClient {
+    private readonly httpClient;
+    constructor(config: LedgitClientConfig);
+    /**
+     * Make a raw GET request
+     */
+    private get;
+    /**
+     * Make a raw POST request
+     */
+    private post;
+    /**
+     * Make a raw DELETE request
+     */
+    private delete;
+    /**
+     * Get company information (derived from token)
+     */
+    getCompanyInfo(): Promise<CompanyInfo>;
+    /**
+     * Create/register a company and enable inbox email
+     * Returns company info with the generated inbox email address
+     */
+    createCompany(data: CreateCompanyRequest): Promise<CompanyWithInbox>;
+    /**
+     * Get all journal entries, optionally filtered by fiscal year
+     */
+    getJournalEntries(fiscalYear?: string): Promise<JournalEntry[]>;
+    /**
+     * Create a new journal entry
+     */
+    createJournalEntry(entry: CreateJournalEntryRequest): Promise<JournalEntry>;
+    /**
+     * Get all inbox items with their documents
+     * @param options.includeDeleted - Include items marked for deletion
+     */
+    getInbox(options?: {
+        includeDeleted?: boolean;
+    }): Promise<InboxItem[]>;
+    /**
+     * Download a file from an inbox item
+     * @param emailId The inbox item/email ID
+     * @param filename The filename to download
+     */
+    downloadInboxFile(emailId: string, filename: string): Promise<BinaryDownloadResult>;
+    /**
+     * Upload a document to the inbox
+     */
+    uploadDocument(options: FileUploadOptions): Promise<Document>;
+    /**
+     * Delete a document from the inbox
+     * @deprecated Use deleteInboxItem instead
+     */
+    deleteDocument(documentId: string): Promise<void>;
+    /**
+     * Mark an inbox item for deletion (soft delete)
+     * The item will be permanently deleted after the retention period.
+     */
+    deleteInboxItem(itemId: string): Promise<void>;
+    /**
+     * Get all fiscal years
+     */
+    getFiscalYears(): Promise<FiscalYear[]>;
+    /**
+     * Get the chart of accounts
+     */
+    getChartOfAccounts(): Promise<LedgerAccount[]>;
+}

package/dist/client.js

@@ -0,0 +1,154 @@
+/**
+ * Ledgit API Client
+ *
+ * Company is derived from the JWT token, not passed in requests.
+ */
+import { HttpClient, TokenBucketRateLimiter, validate, } from "@moatless/api-client";
+import { LEDGIT_CONFIG } from "./config";
+import { CompanyInfoResponseSchema, CreateCompanyResponseSchema, JournalEntriesResponseSchema, JournalEntryResponseSchema, DocumentResponseSchema, FiscalYearsResponseSchema, LedgerAccountsResponseSchema, InboxResponseSchema, } from "./schemas";
+export class LedgitClient {
+    httpClient;
+    constructor(config) {
+        const rateLimiter = new TokenBucketRateLimiter(LEDGIT_CONFIG.RATE_LIMITER_CONFIG);
+        const baseUrl = config.baseUrl ?? LEDGIT_CONFIG.API_BASE_URL;
+        this.httpClient = new HttpClient({
+            baseUrl,
+            getAccessToken: config.getAccessToken,
+            rateLimiter,
+            timeout: LEDGIT_CONFIG.TIMEOUT_MS,
+            defaultHeaders: {
+                Accept: "application/json",
+            },
+            silent: config.silent,
+        });
+    }
+    /**
+     * Make a raw GET request
+     */
+    async get(path) {
+        return this.httpClient.get(path);
+    }
+    /**
+     * Make a raw POST request
+     */
+    async post(path, body) {
+        return this.httpClient.post(path, body);
+    }
+    /**
+     * Make a raw DELETE request
+     */
+    async delete(path) {
+        return this.httpClient.delete(path);
+    }
+    // ============================================================================
+    // Company Information
+    // ============================================================================
+    /**
+     * Get company information (derived from token)
+     */
+    async getCompanyInfo() {
+        const raw = await this.get("/api/company");
+        const response = validate(CompanyInfoResponseSchema, raw, "CompanyInfoResponse");
+        return response.data;
+    }
+    /**
+     * Create/register a company and enable inbox email
+     * Returns company info with the generated inbox email address
+     */
+    async createCompany(data) {
+        const raw = await this.post("/api/company", data);
+        const response = validate(CreateCompanyResponseSchema, raw, "CreateCompanyResponse");
+        return response.data;
+    }
+    // ============================================================================
+    // Journal Entries
+    // ============================================================================
+    /**
+     * Get all journal entries, optionally filtered by fiscal year
+     */
+    async getJournalEntries(fiscalYear) {
+        const query = fiscalYear ? `?fiscalYear=${fiscalYear}` : "";
+        const raw = await this.get(`/api/journal-entries${query}`);
+        const response = validate(JournalEntriesResponseSchema, raw, "JournalEntriesResponse");
+        return response.data;
+    }
+    /**
+     * Create a new journal entry
+     */
+    async createJournalEntry(entry) {
+        const raw = await this.post("/api/journal-entries", entry);
+        const response = validate(JournalEntryResponseSchema, raw, "JournalEntryResponse");
+        return response.data;
+    }
+    // ============================================================================
+    // Inbox / Documents
+    // ============================================================================
+    /**
+     * Get all inbox items with their documents
+     * @param options.includeDeleted - Include items marked for deletion
+     */
+    async getInbox(options) {
+        const query = options?.includeDeleted ? "?includeDeleted=true" : "";
+        const raw = await this.get(`/api/inbox${query}`);
+        const response = validate(InboxResponseSchema, raw, "InboxResponse");
+        return response.data;
+    }
+    /**
+     * Download a file from an inbox item
+     * @param emailId The inbox item/email ID
+     * @param filename The filename to download
+     */
+    async downloadInboxFile(emailId, filename) {
+        return this.httpClient.downloadBinary(`/api/inbox/${emailId}/${filename}`);
+    }
+    /**
+     * Upload a document to the inbox
+     */
+    async uploadDocument(options) {
+        const formData = new FormData();
+        const file = options.file instanceof Blob ? options.file : new Blob([options.file]);
+        formData.append("file", file, options.filename);
+        if (options.metadata) {
+            formData.append("metadata", JSON.stringify(options.metadata));
+        }
+        const raw = await this.httpClient.uploadFormData("/api/inbox", formData);
+        const response = validate(DocumentResponseSchema, raw, "DocumentResponse");
+        return response.data;
+    }
+    /**
+     * Delete a document from the inbox
+     * @deprecated Use deleteInboxItem instead
+     */
+    async deleteDocument(documentId) {
+        await this.delete(`/api/inbox/${documentId}`);
+    }
+    /**
+     * Mark an inbox item for deletion (soft delete)
+     * The item will be permanently deleted after the retention period.
+     */
+    async deleteInboxItem(itemId) {
+        await this.delete(`/api/inbox/${itemId}`);
+    }
+    // ============================================================================
+    // Fiscal Years
+    // ============================================================================
+    /**
+     * Get all fiscal years
+     */
+    async getFiscalYears() {
+        const raw = await this.get("/api/fiscal-years");
+        const response = validate(FiscalYearsResponseSchema, raw, "FiscalYearsResponse");
+        return response.data;
+    }
+    // ============================================================================
+    // Chart of Accounts
+    // ============================================================================
+    /**
+     * Get the chart of accounts
+     */
+    async getChartOfAccounts() {
+        const raw = await this.get("/api/accounts");
+        const response = validate(LedgerAccountsResponseSchema, raw, "LedgerAccountsResponse");
+        return response.data;
+    }
+}

package/dist/config.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Ledgit API configuration
+ */
+export declare const LEDGIT_CONFIG: {
+    /**
+     * Base URL for the Ledgit API.
+     * Can be overridden via environment variable LEDGIT_API_URL
+     */
+    readonly API_BASE_URL: string;
+    /**
+     * API version prefix
+     */
+    readonly API_VERSION: "v1";
+    /**
+     * Rate limiter configuration
+     * Ledgit API has generous rate limits
+     */
+    readonly RATE_LIMITER_CONFIG: {
+        readonly maxTokens: 20;
+        readonly refillIntervalMs: 500;
+        readonly refillAmount: 2;
+    };
+    /**
+     * Request timeout in milliseconds (2 minutes)
+     */
+    readonly TIMEOUT_MS: 120000;
+};

package/dist/config.js

@@ -0,0 +1,27 @@
+/**
+ * Ledgit API configuration
+ */
+export const LEDGIT_CONFIG = {
+    /**
+     * Base URL for the Ledgit API.
+     * Can be overridden via environment variable LEDGIT_API_URL
+     */
+    API_BASE_URL: process.env.LEDGIT_API_URL ?? "https://api.ledgit.se",
+    /**
+     * API version prefix
+     */
+    API_VERSION: "v1",
+    /**
+     * Rate limiter configuration
+     * Ledgit API has generous rate limits
+     */
+    RATE_LIMITER_CONFIG: {
+        maxTokens: 20,
+        refillIntervalMs: 500,
+        refillAmount: 2,
+    },
+    /**
+     * Request timeout in milliseconds (2 minutes)
+     */
+    TIMEOUT_MS: 120000,
+};

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { LedgitClient } from "./client";
+export { LEDGIT_CONFIG } from "./config";
+export type { LedgitClientConfig, CompanyInfo, CompanyWithInbox, CreateCompanyRequest, CreateJournalEntryRequest, DocumentUploadMetadata, FileUploadOptions, ApiResponse, PaginatedApiResponse, InboxItem, } from "./types";
+export type { JournalEntry, JournalLine, JournalEntrySeries, JournalEntryStatus, MoneyAmount, Document, DocumentKind, DocumentStatus, DocumentMoneyAmount, TaxDetail, FiscalYear, LedgerAccount, } from "@moatless/bookkeeping-types";
+export { JournalEntrySchema, DocumentSchema, FiscalYearSchema, LedgerAccountSchema, CompanyInfoSchema, CompanyWithInboxSchema, InboxItemSchema, InboxResponseSchema, } from "./schemas";

package/dist/index.js

@@ -0,0 +1,6 @@
+// Client
+export { LedgitClient } from "./client";
+// Configuration
+export { LEDGIT_CONFIG } from "./config";
+// Schemas (for consumers who want to do their own validation)
+export { JournalEntrySchema, DocumentSchema, FiscalYearSchema, LedgerAccountSchema, CompanyInfoSchema, CompanyWithInboxSchema, InboxItemSchema, InboxResponseSchema, } from "./schemas";

package/dist/schemas.d.ts

@@ -0,0 +1,605 @@
+/**
+ * Zod schemas for Ledgit API validation
+ */
+import { z } from "zod";
+export declare const JournalEntrySchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    series: z.ZodOptional<z.ZodEnum<{
+        A: "A";
+        B: "B";
+        C: "C";
+        D: "D";
+        E: "E";
+        I: "I";
+        M: "M";
+    }>>;
+    entryNumber: z.ZodNumber;
+    entryDate: z.ZodString;
+    description: z.ZodString;
+    status: z.ZodEnum<{
+        DRAFT: "DRAFT";
+        POSTED: "POSTED";
+    }>;
+    currency: z.ZodString;
+    externalId: z.ZodOptional<z.ZodString>;
+    totalDebit: z.ZodObject<{
+        amount: z.ZodNumber;
+        currency: z.ZodString;
+        originalAmount: z.ZodOptional<z.ZodNumber>;
+        originalCurrency: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    totalCredit: z.ZodObject<{
+        amount: z.ZodNumber;
+        currency: z.ZodString;
+        originalAmount: z.ZodOptional<z.ZodNumber>;
+        originalCurrency: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    lines: z.ZodArray<z.ZodObject<{
+        lineNumber: z.ZodNumber;
+        account: z.ZodString;
+        debit: z.ZodObject<{
+            amount: z.ZodNumber;
+            currency: z.ZodString;
+            originalAmount: z.ZodOptional<z.ZodNumber>;
+            originalCurrency: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        credit: z.ZodObject<{
+            amount: z.ZodNumber;
+            currency: z.ZodString;
+            originalAmount: z.ZodOptional<z.ZodNumber>;
+            originalCurrency: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        memo: z.ZodOptional<z.ZodString>;
+        taxCode: z.ZodOptional<z.ZodString>;
+        costCenter: z.ZodOptional<z.ZodString>;
+        ledgerAccountName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    postedAt: z.ZodOptional<z.ZodString>;
+    errorMessage: z.ZodOptional<z.ZodString>;
+    postingCheckpoint: z.ZodOptional<z.ZodString>;
+    voucherNumber: z.ZodOptional<z.ZodNumber>;
+    voucherSeriesCode: z.ZodOptional<z.ZodString>;
+    fortnoxFileId: z.ZodOptional<z.ZodString>;
+    sourceIntegration: z.ZodOptional<z.ZodEnum<{
+        fortnox: "fortnox";
+        bokio: "bokio";
+        ledgit: "ledgit";
+    }>>;
+    sourceSyncedAt: z.ZodOptional<z.ZodString>;
+    reversingEntryExternalId: z.ZodOptional<z.ZodString>;
+    reversedByEntryExternalId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const DocumentSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        RECEIPT: "RECEIPT";
+        SUPPLIER_INVOICE: "SUPPLIER_INVOICE";
+        CUSTOMER_INVOICE: "CUSTOMER_INVOICE";
+        TRAKTAMENTE: "TRAKTAMENTE";
+        EMAIL: "EMAIL";
+        OTHER: "OTHER";
+    }>;
+    status: z.ZodEnum<{
+        DRAFT: "DRAFT";
+        POSTED: "POSTED";
+        REVIEWED: "REVIEWED";
+        READY_TO_EXPORT: "READY_TO_EXPORT";
+        EXPORTED: "EXPORTED";
+        ERROR: "ERROR";
+        DISCARDED: "DISCARDED";
+    }>;
+    fileName: z.ZodString;
+    mimeType: z.ZodString;
+    documentDate: z.ZodOptional<z.ZodString>;
+    documentNumber: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    counterparty: z.ZodOptional<z.ZodString>;
+    totalAmount: z.ZodOptional<z.ZodObject<{
+        amount: z.ZodString;
+        currency: z.ZodString;
+    }, z.core.$strip>>;
+    totalTaxAmount: z.ZodOptional<z.ZodObject<{
+        amount: z.ZodString;
+        currency: z.ZodString;
+    }, z.core.$strip>>;
+    subTotal: z.ZodOptional<z.ZodObject<{
+        amount: z.ZodString;
+        currency: z.ZodString;
+    }, z.core.$strip>>;
+    taxDetails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        rate: z.ZodNumber;
+        amount: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    dueDate: z.ZodOptional<z.ZodString>;
+    currencyRate: z.ZodOptional<z.ZodNumber>;
+    vendorTaxId: z.ZodOptional<z.ZodString>;
+    interpretationError: z.ZodOptional<z.ZodString>;
+    sourceIntegration: z.ZodOptional<z.ZodEnum<{
+        fortnox: "fortnox";
+        bokio: "bokio";
+        ledgit: "ledgit";
+    }>>;
+    sourceId: z.ZodOptional<z.ZodString>;
+    uploadedAt: z.ZodOptional<z.ZodString>;
+    interpretedAt: z.ZodOptional<z.ZodString>;
+    senderEmail: z.ZodOptional<z.ZodString>;
+    senderName: z.ZodOptional<z.ZodString>;
+    emailSubject: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const FiscalYearSchema: z.ZodObject<{
+    name: z.ZodString;
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+    status: z.ZodEnum<{
+        OPEN: "OPEN";
+        CLOSED: "CLOSED";
+    }>;
+    externalId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const LedgerAccountSchema: z.ZodObject<{
+    code: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const CompanyInfoSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    organizationNumber: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodObject<{
+        street: z.ZodOptional<z.ZodString>;
+        zipCode: z.ZodOptional<z.ZodString>;
+        city: z.ZodOptional<z.ZodString>;
+        country: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    inboxEmail: z.ZodOptional<z.ZodString>;
+    inboxEmailEnabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const CompanyWithInboxSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    organizationNumber: z.ZodOptional<z.ZodString>;
+    inboxEmail: z.ZodString;
+    inboxEmailEnabled: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const CompanyInfoResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        organizationNumber: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodObject<{
+            street: z.ZodOptional<z.ZodString>;
+            zipCode: z.ZodOptional<z.ZodString>;
+            city: z.ZodOptional<z.ZodString>;
+            country: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        inboxEmail: z.ZodOptional<z.ZodString>;
+        inboxEmailEnabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    success: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const CreateCompanyResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        organizationNumber: z.ZodOptional<z.ZodString>;
+        inboxEmail: z.ZodString;
+        inboxEmailEnabled: z.ZodBoolean;
+    }, z.core.$strip>;
+    success: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const JournalEntriesResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        series: z.ZodOptional<z.ZodEnum<{
+            A: "A";
+            B: "B";
+            C: "C";
+            D: "D";
+            E: "E";
+            I: "I";
+            M: "M";
+        }>>;
+        entryNumber: z.ZodNumber;
+        entryDate: z.ZodString;
+        description: z.ZodString;
+        status: z.ZodEnum<{
+            DRAFT: "DRAFT";
+            POSTED: "POSTED";
+        }>;
+        currency: z.ZodString;
+        externalId: z.ZodOptional<z.ZodString>;
+        totalDebit: z.ZodObject<{
+            amount: z.ZodNumber;
+            currency: z.ZodString;
+            originalAmount: z.ZodOptional<z.ZodNumber>;
+            originalCurrency: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        totalCredit: z.ZodObject<{
+            amount: z.ZodNumber;
+            currency: z.ZodString;
+            originalAmount: z.ZodOptional<z.ZodNumber>;
+            originalCurrency: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        lines: z.ZodArray<z.ZodObject<{
+            lineNumber: z.ZodNumber;
+            account: z.ZodString;
+            debit: z.ZodObject<{
+                amount: z.ZodNumber;
+                currency: z.ZodString;
+                originalAmount: z.ZodOptional<z.ZodNumber>;
+                originalCurrency: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            credit: z.ZodObject<{
+                amount: z.ZodNumber;
+                currency: z.ZodString;
+                originalAmount: z.ZodOptional<z.ZodNumber>;
+                originalCurrency: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            memo: z.ZodOptional<z.ZodString>;
+            taxCode: z.ZodOptional<z.ZodString>;
+            costCenter: z.ZodOptional<z.ZodString>;
+            ledgerAccountName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        postedAt: z.ZodOptional<z.ZodString>;
+        errorMessage: z.ZodOptional<z.ZodString>;
+        postingCheckpoint: z.ZodOptional<z.ZodString>;
+        voucherNumber: z.ZodOptional<z.ZodNumber>;
+        voucherSeriesCode: z.ZodOptional<z.ZodString>;
+        fortnoxFileId: z.ZodOptional<z.ZodString>;
+        sourceIntegration: z.ZodOptional<z.ZodEnum<{
+            fortnox: "fortnox";
+            bokio: "bokio";
+            ledgit: "ledgit";
+        }>>;
+        sourceSyncedAt: z.ZodOptional<z.ZodString>;
+        reversingEntryExternalId: z.ZodOptional<z.ZodString>;
+        reversedByEntryExternalId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        page: z.ZodNumber;
+        pageSize: z.ZodNumber;
+        totalItems: z.ZodNumber;
+        totalPages: z.ZodNumber;
+    }, z.core.$strip>;
+    success: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const JournalEntryResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        series: z.ZodOptional<z.ZodEnum<{
+            A: "A";
+            B: "B";
+            C: "C";
+            D: "D";
+            E: "E";
+            I: "I";
+            M: "M";
+        }>>;
+        entryNumber: z.ZodNumber;
+        entryDate: z.ZodString;
+        description: z.ZodString;
+        status: z.ZodEnum<{
+            DRAFT: "DRAFT";
+            POSTED: "POSTED";
+        }>;
+        currency: z.ZodString;
+        externalId: z.ZodOptional<z.ZodString>;
+        totalDebit: z.ZodObject<{
+            amount: z.ZodNumber;
+            currency: z.ZodString;
+            originalAmount: z.ZodOptional<z.ZodNumber>;
+            originalCurrency: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        totalCredit: z.ZodObject<{
+            amount: z.ZodNumber;
+            currency: z.ZodString;
+            originalAmount: z.ZodOptional<z.ZodNumber>;
+            originalCurrency: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        lines: z.ZodArray<z.ZodObject<{
+            lineNumber: z.ZodNumber;
+            account: z.ZodString;
+            debit: z.ZodObject<{
+                amount: z.ZodNumber;
+                currency: z.ZodString;
+                originalAmount: z.ZodOptional<z.ZodNumber>;
+                originalCurrency: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            credit: z.ZodObject<{
+                amount: z.ZodNumber;
+                currency: z.ZodString;
+                originalAmount: z.ZodOptional<z.ZodNumber>;
+                originalCurrency: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            memo: z.ZodOptional<z.ZodString>;
+            taxCode: z.ZodOptional<z.ZodString>;
+            costCenter: z.ZodOptional<z.ZodString>;
+            ledgerAccountName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        postedAt: z.ZodOptional<z.ZodString>;
+        errorMessage: z.ZodOptional<z.ZodString>;
+        postingCheckpoint: z.ZodOptional<z.ZodString>;
+        voucherNumber: z.ZodOptional<z.ZodNumber>;
+        voucherSeriesCode: z.ZodOptional<z.ZodString>;
+        fortnoxFileId: z.ZodOptional<z.ZodString>;
+        sourceIntegration: z.ZodOptional<z.ZodEnum<{
+            fortnox: "fortnox";
+            bokio: "bokio";
+            ledgit: "ledgit";
+        }>>;
+        sourceSyncedAt: z.ZodOptional<z.ZodString>;
+        reversingEntryExternalId: z.ZodOptional<z.ZodString>;
+        reversedByEntryExternalId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    success: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const DocumentsResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            RECEIPT: "RECEIPT";
+            SUPPLIER_INVOICE: "SUPPLIER_INVOICE";
+            CUSTOMER_INVOICE: "CUSTOMER_INVOICE";
+            TRAKTAMENTE: "TRAKTAMENTE";
+            EMAIL: "EMAIL";
+            OTHER: "OTHER";
+        }>;
+        status: z.ZodEnum<{
+            DRAFT: "DRAFT";
+            POSTED: "POSTED";
+            REVIEWED: "REVIEWED";
+            READY_TO_EXPORT: "READY_TO_EXPORT";
+            EXPORTED: "EXPORTED";
+            ERROR: "ERROR";
+            DISCARDED: "DISCARDED";
+        }>;
+        fileName: z.ZodString;
+        mimeType: z.ZodString;
+        documentDate: z.ZodOptional<z.ZodString>;
+        documentNumber: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        counterparty: z.ZodOptional<z.ZodString>;
+        totalAmount: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+        }, z.core.$strip>>;
+        totalTaxAmount: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+        }, z.core.$strip>>;
+        subTotal: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+        }, z.core.$strip>>;
+        taxDetails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            rate: z.ZodNumber;
+            amount: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        dueDate: z.ZodOptional<z.ZodString>;
+        currencyRate: z.ZodOptional<z.ZodNumber>;
+        vendorTaxId: z.ZodOptional<z.ZodString>;
+        interpretationError: z.ZodOptional<z.ZodString>;
+        sourceIntegration: z.ZodOptional<z.ZodEnum<{
+            fortnox: "fortnox";
+            bokio: "bokio";
+            ledgit: "ledgit";
+        }>>;
+        sourceId: z.ZodOptional<z.ZodString>;
+        uploadedAt: z.ZodOptional<z.ZodString>;
+        interpretedAt: z.ZodOptional<z.ZodString>;
+        senderEmail: z.ZodOptional<z.ZodString>;
+        senderName: z.ZodOptional<z.ZodString>;
+        emailSubject: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        page: z.ZodNumber;
+        pageSize: z.ZodNumber;
+        totalItems: z.ZodNumber;
+        totalPages: z.ZodNumber;
+    }, z.core.$strip>;
+    success: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const DocumentResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        kind: z.ZodEnum<{
+            RECEIPT: "RECEIPT";
+            SUPPLIER_INVOICE: "SUPPLIER_INVOICE";
+            CUSTOMER_INVOICE: "CUSTOMER_INVOICE";
+            TRAKTAMENTE: "TRAKTAMENTE";
+            EMAIL: "EMAIL";
+            OTHER: "OTHER";
+        }>;
+        status: z.ZodEnum<{
+            DRAFT: "DRAFT";
+            POSTED: "POSTED";
+            REVIEWED: "REVIEWED";
+            READY_TO_EXPORT: "READY_TO_EXPORT";
+            EXPORTED: "EXPORTED";
+            ERROR: "ERROR";
+            DISCARDED: "DISCARDED";
+        }>;
+        fileName: z.ZodString;
+        mimeType: z.ZodString;
+        documentDate: z.ZodOptional<z.ZodString>;
+        documentNumber: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        counterparty: z.ZodOptional<z.ZodString>;
+        totalAmount: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+        }, z.core.$strip>>;
+        totalTaxAmount: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+        }, z.core.$strip>>;
+        subTotal: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+        }, z.core.$strip>>;
+        taxDetails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            rate: z.ZodNumber;
+            amount: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        dueDate: z.ZodOptional<z.ZodString>;
+        currencyRate: z.ZodOptional<z.ZodNumber>;
+        vendorTaxId: z.ZodOptional<z.ZodString>;
+        interpretationError: z.ZodOptional<z.ZodString>;
+        sourceIntegration: z.ZodOptional<z.ZodEnum<{
+            fortnox: "fortnox";
+            bokio: "bokio";
+            ledgit: "ledgit";
+        }>>;
+        sourceId: z.ZodOptional<z.ZodString>;
+        uploadedAt: z.ZodOptional<z.ZodString>;
+        interpretedAt: z.ZodOptional<z.ZodString>;
+        senderEmail: z.ZodOptional<z.ZodString>;
+        senderName: z.ZodOptional<z.ZodString>;
+        emailSubject: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    success: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const FiscalYearsResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        startDate: z.ZodString;
+        endDate: z.ZodString;
+        status: z.ZodEnum<{
+            OPEN: "OPEN";
+            CLOSED: "CLOSED";
+        }>;
+        externalId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    success: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const LedgerAccountsResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    success: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const InboxItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    documents: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            RECEIPT: "RECEIPT";
+            SUPPLIER_INVOICE: "SUPPLIER_INVOICE";
+            CUSTOMER_INVOICE: "CUSTOMER_INVOICE";
+            TRAKTAMENTE: "TRAKTAMENTE";
+            EMAIL: "EMAIL";
+            OTHER: "OTHER";
+        }>;
+        status: z.ZodEnum<{
+            DRAFT: "DRAFT";
+            POSTED: "POSTED";
+            REVIEWED: "REVIEWED";
+            READY_TO_EXPORT: "READY_TO_EXPORT";
+            EXPORTED: "EXPORTED";
+            ERROR: "ERROR";
+            DISCARDED: "DISCARDED";
+        }>;
+        fileName: z.ZodString;
+        mimeType: z.ZodString;
+        documentDate: z.ZodOptional<z.ZodString>;
+        documentNumber: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        counterparty: z.ZodOptional<z.ZodString>;
+        totalAmount: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+        }, z.core.$strip>>;
+        totalTaxAmount: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+        }, z.core.$strip>>;
+        subTotal: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+        }, z.core.$strip>>;
+        taxDetails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            rate: z.ZodNumber;
+            amount: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        dueDate: z.ZodOptional<z.ZodString>;
+        currencyRate: z.ZodOptional<z.ZodNumber>;
+        vendorTaxId: z.ZodOptional<z.ZodString>;
+        interpretationError: z.ZodOptional<z.ZodString>;
+        sourceIntegration: z.ZodOptional<z.ZodEnum<{
+            fortnox: "fortnox";
+            bokio: "bokio";
+            ledgit: "ledgit";
+        }>>;
+        sourceId: z.ZodOptional<z.ZodString>;
+        uploadedAt: z.ZodOptional<z.ZodString>;
+        interpretedAt: z.ZodOptional<z.ZodString>;
+        senderEmail: z.ZodOptional<z.ZodString>;
+        senderName: z.ZodOptional<z.ZodString>;
+        emailSubject: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const InboxResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        documents: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                RECEIPT: "RECEIPT";
+                SUPPLIER_INVOICE: "SUPPLIER_INVOICE";
+                CUSTOMER_INVOICE: "CUSTOMER_INVOICE";
+                TRAKTAMENTE: "TRAKTAMENTE";
+                EMAIL: "EMAIL";
+                OTHER: "OTHER";
+            }>;
+            status: z.ZodEnum<{
+                DRAFT: "DRAFT";
+                POSTED: "POSTED";
+                REVIEWED: "REVIEWED";
+                READY_TO_EXPORT: "READY_TO_EXPORT";
+                EXPORTED: "EXPORTED";
+                ERROR: "ERROR";
+                DISCARDED: "DISCARDED";
+            }>;
+            fileName: z.ZodString;
+            mimeType: z.ZodString;
+            documentDate: z.ZodOptional<z.ZodString>;
+            documentNumber: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            counterparty: z.ZodOptional<z.ZodString>;
+            totalAmount: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodString;
+                currency: z.ZodString;
+            }, z.core.$strip>>;
+            totalTaxAmount: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodString;
+                currency: z.ZodString;
+            }, z.core.$strip>>;
+            subTotal: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodString;
+                currency: z.ZodString;
+            }, z.core.$strip>>;
+            taxDetails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                rate: z.ZodNumber;
+                amount: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            dueDate: z.ZodOptional<z.ZodString>;
+            currencyRate: z.ZodOptional<z.ZodNumber>;
+            vendorTaxId: z.ZodOptional<z.ZodString>;
+            interpretationError: z.ZodOptional<z.ZodString>;
+            sourceIntegration: z.ZodOptional<z.ZodEnum<{
+                fortnox: "fortnox";
+                bokio: "bokio";
+                ledgit: "ledgit";
+            }>>;
+            sourceId: z.ZodOptional<z.ZodString>;
+            uploadedAt: z.ZodOptional<z.ZodString>;
+            interpretedAt: z.ZodOptional<z.ZodString>;
+            senderEmail: z.ZodOptional<z.ZodString>;
+            senderName: z.ZodOptional<z.ZodString>;
+            emailSubject: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    success: z.ZodBoolean;
+}, z.core.$strip>;

package/dist/schemas.js

@@ -0,0 +1,177 @@
+/**
+ * Zod schemas for Ledgit API validation
+ */
+import { z } from "zod";
+// Money amount schema
+const MoneyAmountSchema = z.object({
+    amount: z.number(),
+    currency: z.string(),
+    originalAmount: z.number().optional(),
+    originalCurrency: z.string().optional(),
+});
+// Journal line schema
+const JournalLineSchema = z.object({
+    lineNumber: z.number(),
+    account: z.string(),
+    debit: MoneyAmountSchema,
+    credit: MoneyAmountSchema,
+    memo: z.string().optional(),
+    taxCode: z.string().optional(),
+    costCenter: z.string().optional(),
+    ledgerAccountName: z.string().optional(),
+});
+// Journal entry schema
+export const JournalEntrySchema = z.object({
+    id: z.string().optional(),
+    series: z.enum(["A", "B", "C", "D", "E", "I", "M"]).optional(),
+    entryNumber: z.number(),
+    entryDate: z.string(),
+    description: z.string(),
+    status: z.enum(["DRAFT", "POSTED"]),
+    currency: z.string(),
+    externalId: z.string().optional(),
+    totalDebit: MoneyAmountSchema,
+    totalCredit: MoneyAmountSchema,
+    lines: z.array(JournalLineSchema),
+    postedAt: z.string().optional(),
+    errorMessage: z.string().optional(),
+    postingCheckpoint: z.string().optional(),
+    voucherNumber: z.number().optional(),
+    voucherSeriesCode: z.string().optional(),
+    fortnoxFileId: z.string().optional(),
+    sourceIntegration: z.enum(["fortnox", "bokio", "ledgit"]).optional(),
+    sourceSyncedAt: z.string().optional(),
+    reversingEntryExternalId: z.string().optional(),
+    reversedByEntryExternalId: z.string().optional(),
+});
+// Document money amount schema (string-based for precision)
+const DocumentMoneyAmountSchema = z.object({
+    amount: z.string(),
+    currency: z.string(),
+});
+// Tax detail schema
+const TaxDetailSchema = z.object({
+    rate: z.number(),
+    amount: z.string(),
+    description: z.string().optional(),
+});
+// Document schema
+export const DocumentSchema = z.object({
+    kind: z.enum(["RECEIPT", "SUPPLIER_INVOICE", "CUSTOMER_INVOICE", "TRAKTAMENTE", "EMAIL", "OTHER"]),
+    status: z.enum(["DRAFT", "REVIEWED", "READY_TO_EXPORT", "EXPORTED", "ERROR", "DISCARDED", "POSTED"]),
+    fileName: z.string(),
+    mimeType: z.string(),
+    documentDate: z.string().optional(),
+    documentNumber: z.string().optional(),
+    description: z.string().optional(),
+    counterparty: z.string().optional(),
+    totalAmount: DocumentMoneyAmountSchema.optional(),
+    totalTaxAmount: DocumentMoneyAmountSchema.optional(),
+    subTotal: DocumentMoneyAmountSchema.optional(),
+    taxDetails: z.array(TaxDetailSchema).optional(),
+    dueDate: z.string().optional(),
+    currencyRate: z.number().optional(),
+    vendorTaxId: z.string().optional(),
+    interpretationError: z.string().optional(),
+    sourceIntegration: z.enum(["fortnox", "bokio", "ledgit"]).optional(),
+    sourceId: z.string().optional(),
+    uploadedAt: z.string().optional(),
+    interpretedAt: z.string().optional(),
+    // Email-specific fields
+    senderEmail: z.string().optional(),
+    senderName: z.string().optional(),
+    emailSubject: z.string().optional(),
+});
+// Fiscal year schema
+export const FiscalYearSchema = z.object({
+    name: z.string(),
+    startDate: z.string(),
+    endDate: z.string(),
+    status: z.enum(["OPEN", "CLOSED"]),
+    externalId: z.string().optional(),
+});
+// Ledger account schema
+export const LedgerAccountSchema = z.object({
+    code: z.string(),
+    name: z.string(),
+    description: z.string().optional(),
+});
+// Company info schema
+export const CompanyInfoSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    organizationNumber: z.string().optional(),
+    address: z
+        .object({
+        street: z.string().optional(),
+        zipCode: z.string().optional(),
+        city: z.string().optional(),
+        country: z.string().optional(),
+    })
+        .optional(),
+    inboxEmail: z.string().optional(),
+    inboxEmailEnabled: z.boolean().optional(),
+});
+// Company with inbox schema (for createCompany response)
+export const CompanyWithInboxSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    organizationNumber: z.string().optional(),
+    inboxEmail: z.string(),
+    inboxEmailEnabled: z.boolean(),
+});
+// API response schemas
+export const CompanyInfoResponseSchema = z.object({
+    data: CompanyInfoSchema,
+    success: z.boolean(),
+});
+export const CreateCompanyResponseSchema = z.object({
+    data: CompanyWithInboxSchema,
+    success: z.boolean(),
+});
+export const JournalEntriesResponseSchema = z.object({
+    data: z.array(JournalEntrySchema),
+    pagination: z.object({
+        page: z.number(),
+        pageSize: z.number(),
+        totalItems: z.number(),
+        totalPages: z.number(),
+    }),
+    success: z.boolean(),
+});
+export const JournalEntryResponseSchema = z.object({
+    data: JournalEntrySchema,
+    success: z.boolean(),
+});
+export const DocumentsResponseSchema = z.object({
+    data: z.array(DocumentSchema),
+    pagination: z.object({
+        page: z.number(),
+        pageSize: z.number(),
+        totalItems: z.number(),
+        totalPages: z.number(),
+    }),
+    success: z.boolean(),
+});
+export const DocumentResponseSchema = z.object({
+    data: DocumentSchema,
+    success: z.boolean(),
+});
+export const FiscalYearsResponseSchema = z.object({
+    data: z.array(FiscalYearSchema),
+    success: z.boolean(),
+});
+export const LedgerAccountsResponseSchema = z.object({
+    data: z.array(LedgerAccountSchema),
+    success: z.boolean(),
+});
+// Inbox item schema
+export const InboxItemSchema = z.object({
+    id: z.string(),
+    documents: z.array(DocumentSchema),
+});
+// Inbox response schema
+export const InboxResponseSchema = z.object({
+    data: z.array(InboxItemSchema),
+    success: z.boolean(),
+});

package/dist/types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Ledgit API types
+ */
+import type { JournalEntry, Document, FiscalYear, LedgerAccount } from "@moatless/bookkeeping-types";
+export type { JournalEntry, Document, FiscalYear, LedgerAccount };
+/**
+ * Client configuration
+ *
+ * Note: Company is derived from the JWT token, not configured here.
+ */
+export interface LedgitClientConfig {
+    /**
+     * Function to get the current access token
+     */
+    getAccessToken: () => Promise<string>;
+    /**
+     * Optional custom base URL (overrides LEDGIT_CONFIG.API_BASE_URL)
+     */
+    baseUrl?: string;
+    /**
+     * Suppress console output
+     */
+    silent?: boolean;
+}
+/**
+ * Company information
+ */
+export interface CompanyInfo {
+    id: string;
+    name: string;
+    organizationNumber?: string;
+    address?: {
+        street?: string;
+        zipCode?: string;
+        city?: string;
+        country?: string;
+    };
+    inboxEmail?: string;
+    inboxEmailEnabled?: boolean;
+}
+/**
+ * Company information with inbox email (returned from createCompany)
+ */
+export interface CompanyWithInbox {
+    id: string;
+    name: string;
+    organizationNumber?: string;
+    inboxEmail: string;
+    inboxEmailEnabled: boolean;
+}
+/**
+ * Create company request
+ */
+export interface CreateCompanyRequest {
+    name: string;
+    organizationNumber: string;
+}
+/**
+ * API response wrapper
+ */
+export interface ApiResponse<T> {
+    data: T;
+    success: boolean;
+}
+/**
+ * Paginated API response
+ */
+export interface PaginatedApiResponse<T> {
+    data: T[];
+    pagination: {
+        page: number;
+        pageSize: number;
+        totalItems: number;
+        totalPages: number;
+    };
+    success: boolean;
+}
+/**
+ * Create journal entry request
+ */
+export interface CreateJournalEntryRequest {
+    series?: string;
+    entryNumber?: number;
+    entryDate: string;
+    description: string;
+    currency?: string;
+    lines: Array<{
+        lineNumber?: number;
+        account: string;
+        debit: {
+            amount: number;
+            currency: string;
+        };
+        credit: {
+            amount: number;
+            currency: string;
+        };
+        memo?: string;
+        taxCode?: string;
+    }>;
+}
+/**
+ * Document upload metadata
+ */
+export interface DocumentUploadMetadata {
+    fileName: string;
+    mimeType?: string;
+    kind?: "RECEIPT" | "SUPPLIER_INVOICE" | "CUSTOMER_INVOICE" | "TRAKTAMENTE" | "OTHER";
+    description?: string;
+    documentDate?: string;
+}
+/**
+ * File upload options
+ */
+export interface FileUploadOptions {
+    file: Blob | ArrayBuffer;
+    filename: string;
+    metadata?: DocumentUploadMetadata;
+}
+/**
+ * Inbox item with documents
+ */
+export interface InboxItem {
+    id: string;
+    documents: Document[];
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,35 @@
+{
+	"name": "@moatless/ledgit-client",
+	"version": "0.2.0",
+	"description": "API client for Ledgit bookkeeping service",
+	"type": "module",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"files": [
+		"dist"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/aorwall/ledgit.git",
+		"directory": "packages/ledgit-client"
+	},
+	"scripts": {
+		"build": "tsc",
+		"dev": "tsc --watch",
+		"type-check": "tsc --noEmit",
+		"test": "bun test",
+		"test:coverage": "bun test --coverage"
+	},
+	"dependencies": {
+		"@moatless/api-client": "workspace:*",
+		"@moatless/bookkeeping-types": "workspace:*",
+		"zod": "^4.1.13"
+	},
+	"devDependencies": {
+		"@types/bun": "latest",
+		"typescript": "^5.8.3"
+	}
+}