@jars-lt/sdk 1.0.2 → 1.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,5 @@
+
+
+> @jars-lt/sdk@1.0.3 build /Users/sasha/Sites/jars-lt/packages/sdk
+> tsc
+

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Company, SubscriptionPlan, WorkdayCheckResponse, AddWorkdaysResponse } from '@jars-lt/types';
+import { Company, SubscriptionPlan, WorkdayCheckResponse, AddWorkdaysResponse, NormalizeAddressResponse, Invoice } from '@jars-lt/types';
 /**
  * Configuration options for JARS.LT client
  */
@@ -94,6 +94,50 @@ export interface UsageResponse {
     rateLimit: number;
     webhooksEnabled: boolean;
 }
+/**
+ * Company financial report data
+ */
+export interface CompanyFinancialsData {
+    companyCode: string;
+    year: number;
+    periodStart: string;
+    periodEnd: string;
+    reportDate?: string;
+    balance?: {
+        equity?: number;
+        longTermAssets?: number;
+        shortTermAssets?: number;
+        liabilities?: number;
+        totalAssets?: number;
+    };
+    profitLoss?: {
+        revenue?: number;
+        profitBeforeTax?: number;
+        netProfit?: number;
+    };
+    templateId?: string;
+    templateName?: string;
+    standardId?: string;
+    standardName?: string;
+    dataDate: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Company financials response
+ */
+export interface CompanyFinancialsResponse {
+    companyCode: string;
+    companyName: string;
+    financials: CompanyFinancialsData[];
+    availableYears: number[];
+}
+/**
+ * Invoices list response
+ */
+export interface InvoicesListResponse {
+    invoices: Invoice[];
+}
 /**
  * API Error
  */
@@ -105,6 +149,10 @@ export declare class JarsAPIError extends Error {
 /**
  * Official JARS.LT API Client
  *
+ * Supports both Lithuanian and Estonian company registries.
+ * Default country depends on the base URL: api.jars.lt defaults to Lithuania,
+ * api.jars.ee defaults to Estonia.
+ *
  * @example
  * ```typescript
  * import { JarsClient } from '@jars-lt/sdk';
@@ -113,11 +161,17 @@ export declare class JarsAPIError extends Error {
  *   apiKey: 'your_api_key_here'
  * });
  *
- * // Search companies
- * const companies = await client.searchCompanies({ q: 'UAB Maxima' });
+ * // Search Lithuanian companies
+ * const ltCompanies = await client.searchCompanies({ q: 'UAB Maxima' });
  *
- * // Get company by code
- * const company = await client.getCompany('111111111');
+ * // Search Estonian companies
+ * const eeCompanies = await client.searchCompanies({ q: 'Bolt', country: 'ee' });
+ *
+ * // Or use api.jars.ee as base URL for Estonian defaults
+ * const eeClient = new JarsClient({
+ *   apiKey: 'your_api_key_here',
+ *   baseURL: 'https://api.jars.ee/api/v1'
+ * });
  * ```
  */
 export declare class JarsClient {
@@ -130,37 +184,71 @@ export declare class JarsClient {
      * @param params.q - Search query (company name or code)
      * @param params.limit - Number of results (max: 100, default: 20)
      * @param params.offset - Skip results (default: 0)
+     * @param params.country - Country: "lt" (Lithuania) or "ee" (Estonia). Default depends on base URL domain.
      * @returns Search results with companies
      *
      * @example
      * ```typescript
-     * const results = await client.searchCompanies({
-     *   q: 'Maxima',
-     *   limit: 10
-     * });
-     * console.log(results.total); // Total matching companies
-     * console.log(results.results); // Array of companies
+     * // Search Lithuanian companies
+     * const results = await client.searchCompanies({ q: 'Maxima', limit: 10 });
+     *
+     * // Search Estonian companies
+     * const eeResults = await client.searchCompanies({ q: 'Bolt', country: 'ee' });
      * ```
      */
     searchCompanies(params: {
         q: string;
         limit?: number;
         offset?: number;
+        country?: 'lt' | 'ee';
     }): Promise<SearchCompaniesResponse>;
     /**
      * Get company details by company code
      *
-     * @param code - Company code (9 digits)
+     * @param code - Company registration code
+     * @param options - Optional parameters
+     * @param options.country - Country: "lt" (Lithuania) or "ee" (Estonia). Default depends on base URL domain.
      * @returns Company details
      *
      * @example
      * ```typescript
+     * // Lithuanian company
      * const company = await client.getCompany('111111111');
-     * console.log(company.name); // Company name
-     * console.log(company.address); // Company address
+     *
+     * // Estonian company
+     * const eeCompany = await client.getCompany('14532901', { country: 'ee' });
+     * ```
+     */
+    getCompany(code: string, options?: {
+        country?: 'lt' | 'ee';
+    }): Promise<Company>;
+    /**
+     * Get company financial reports (balance sheet + P&L)
+     *
+     * @param code - Company registration code
+     * @param params - Optional parameters
+     * @param params.year - Specific year to fetch (optional, returns all years if not specified)
+     * @param params.limit - Maximum number of years to return (default: 10, max: 50)
+     * @param params.country - Country: "lt" (Lithuania) or "ee" (Estonia). Default depends on base URL domain.
+     * @returns Financial reports with balance sheet and P&L data
+     *
+     * @example
+     * ```typescript
+     * // Get all available financial reports
+     * const financials = await client.getCompanyFinancials('111111111');
+     *
+     * // Get specific year
+     * const financials2024 = await client.getCompanyFinancials('111111111', { year: 2024 });
+     *
+     * // Estonian company financials
+     * const eeFinancials = await client.getCompanyFinancials('14532901', { country: 'ee' });
      * ```
      */
-    getCompany(code: string): Promise<Company>;
+    getCompanyFinancials(code: string, params?: {
+        year?: number;
+        limit?: number;
+        country?: 'lt' | 'ee';
+    }): Promise<CompanyFinancialsResponse>;
     /**
      * Search for addresses (streets, settlements, municipalities)
      * Supports multi-word search (e.g., "kaunas basanavi")
@@ -247,6 +335,79 @@ export declare class JarsClient {
      * ```
      */
     addWorkdays(date: string, days: number): Promise<AddWorkdaysResponse>;
+    /**
+     * Normalize an arbitrary address string to structured components
+     * Supports fuzzy matching for typos (1-2 character edits)
+     *
+     * @param address - Address string in any format (e.g., "vilnus gedimino 15")
+     * @param limit - Maximum number of results (default: 5, max: 20)
+     * @returns Normalized address results with confidence scores
+     *
+     * @example
+     * ```typescript
+     * // Normalize with typos
+     * const result = await client.normalizeAddress('gedimno pr 28 vilnus');
+     * console.log(result.results[0].formatted); // "Gedimino pr. 28, Vilnius, Vilniaus m. sav., LT-01103"
+     * console.log(result.results[0].confidence); // 0.87
+     * console.log(result.results[0].components.street); // { code: 105641, name: "Gedimino", ... }
+     *
+     * // With building number
+     * const result2 = await client.normalizeAddress('kaunas laisves al 20a');
+     * console.log(result2.results[0].components.building); // { number: "20A", postalCode: "LT-44291" }
+     * ```
+     */
+    normalizeAddress(address: string, limit?: number): Promise<NormalizeAddressResponse>;
+    /**
+     * List all invoices for the authenticated user
+     * Note: Invoice requests do not count towards your monthly API quota
+     *
+     * @returns List of invoices
+     *
+     * @example
+     * ```typescript
+     * const { invoices } = await client.listInvoices();
+     * for (const invoice of invoices) {
+     *   console.log(invoice.number, invoice.status, invoice.total / 100);
+     * }
+     * ```
+     */
+    listInvoices(): Promise<InvoicesListResponse>;
+    /**
+     * Get a specific invoice by ID
+     * Note: Invoice requests do not count towards your monthly API quota
+     *
+     * @param invoiceId - Stripe invoice ID (e.g., "in_1abc123")
+     * @returns Invoice details
+     *
+     * @example
+     * ```typescript
+     * const invoice = await client.getInvoice('in_1abc123');
+     * console.log(invoice.number); // "INV-0091"
+     * console.log(invoice.total / 100); // 9.99
+     * console.log(invoice.customerName); // "UAB Example"
+     * ```
+     */
+    getInvoice(invoiceId: string): Promise<Invoice>;
+    /**
+     * Download invoice in UBL XML format (Peppol BIS Billing 3.0)
+     * The UBL format is compliant with European e-invoicing standard EN 16931
+     * Note: Invoice requests do not count towards your monthly API quota
+     *
+     * @param invoiceId - Stripe invoice ID (e.g., "in_1abc123")
+     * @returns UBL XML string
+     *
+     * @example
+     * ```typescript
+     * const xml = await client.getInvoiceUbl('in_1abc123');
+     * // Save to file
+     * fs.writeFileSync('invoice.xml', xml);
+     *
+     * // Or parse for processing
+     * const parser = new DOMParser();
+     * const doc = parser.parseFromString(xml, 'text/xml');
+     * ```
+     */
+    getInvoiceUbl(invoiceId: string): Promise<string>;
 }
 export * from '@jars-lt/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -34,6 +34,10 @@ exports.JarsAPIError = JarsAPIError;
 /**
  * Official JARS.LT API Client
  *
+ * Supports both Lithuanian and Estonian company registries.
+ * Default country depends on the base URL: api.jars.lt defaults to Lithuania,
+ * api.jars.ee defaults to Estonia.
+ *
  * @example
  * ```typescript
  * import { JarsClient } from '@jars-lt/sdk';
@@ -42,11 +46,17 @@ exports.JarsAPIError = JarsAPIError;
  *   apiKey: 'your_api_key_here'
  * });
  *
- * // Search companies
- * const companies = await client.searchCompanies({ q: 'UAB Maxima' });
+ * // Search Lithuanian companies
+ * const ltCompanies = await client.searchCompanies({ q: 'UAB Maxima' });
+ *
+ * // Search Estonian companies
+ * const eeCompanies = await client.searchCompanies({ q: 'Bolt', country: 'ee' });
  *
- * // Get company by code
- * const company = await client.getCompany('111111111');
+ * // Or use api.jars.ee as base URL for Estonian defaults
+ * const eeClient = new JarsClient({
+ *   apiKey: 'your_api_key_here',
+ *   baseURL: 'https://api.jars.ee/api/v1'
+ * });
  * ```
  */
 class JarsClient {
@@ -78,16 +88,16 @@ class JarsClient {
      * @param params.q - Search query (company name or code)
      * @param params.limit - Number of results (max: 100, default: 20)
      * @param params.offset - Skip results (default: 0)
+     * @param params.country - Country: "lt" (Lithuania) or "ee" (Estonia). Default depends on base URL domain.
      * @returns Search results with companies
      *
      * @example
      * ```typescript
-     * const results = await client.searchCompanies({
-     *   q: 'Maxima',
-     *   limit: 10
-     * });
-     * console.log(results.total); // Total matching companies
-     * console.log(results.results); // Array of companies
+     * // Search Lithuanian companies
+     * const results = await client.searchCompanies({ q: 'Maxima', limit: 10 });
+     *
+     * // Search Estonian companies
+     * const eeResults = await client.searchCompanies({ q: 'Bolt', country: 'ee' });
      * ```
      */
     async searchCompanies(params) {
@@ -97,18 +107,48 @@ class JarsClient {
     /**
      * Get company details by company code
      *
-     * @param code - Company code (9 digits)
+     * @param code - Company registration code
+     * @param options - Optional parameters
+     * @param options.country - Country: "lt" (Lithuania) or "ee" (Estonia). Default depends on base URL domain.
      * @returns Company details
      *
      * @example
      * ```typescript
+     * // Lithuanian company
      * const company = await client.getCompany('111111111');
-     * console.log(company.name); // Company name
-     * console.log(company.address); // Company address
+     *
+     * // Estonian company
+     * const eeCompany = await client.getCompany('14532901', { country: 'ee' });
+     * ```
+     */
+    async getCompany(code, options) {
+        const response = await this.client.get(`/companies/${code}`, { params: options });
+        return response.data;
+    }
+    /**
+     * Get company financial reports (balance sheet + P&L)
+     *
+     * @param code - Company registration code
+     * @param params - Optional parameters
+     * @param params.year - Specific year to fetch (optional, returns all years if not specified)
+     * @param params.limit - Maximum number of years to return (default: 10, max: 50)
+     * @param params.country - Country: "lt" (Lithuania) or "ee" (Estonia). Default depends on base URL domain.
+     * @returns Financial reports with balance sheet and P&L data
+     *
+     * @example
+     * ```typescript
+     * // Get all available financial reports
+     * const financials = await client.getCompanyFinancials('111111111');
+     *
+     * // Get specific year
+     * const financials2024 = await client.getCompanyFinancials('111111111', { year: 2024 });
+     *
+     * // Estonian company financials
+     * const eeFinancials = await client.getCompanyFinancials('14532901', { country: 'ee' });
      * ```
      */
-    async getCompany(code) {
-        const response = await this.client.get(`/companies/${code}`);
+    async getCompanyFinancials(code, params) {
+        const response = await this.client.get(`/companies/${code}/financials`, { params });
         return response.data;
     }
     /**
@@ -208,6 +248,91 @@ class JarsClient {
         const response = await this.client.get('/workdays/add', { params: { date, days } });
         return response.data;
     }
+    /**
+     * Normalize an arbitrary address string to structured components
+     * Supports fuzzy matching for typos (1-2 character edits)
+     *
+     * @param address - Address string in any format (e.g., "vilnus gedimino 15")
+     * @param limit - Maximum number of results (default: 5, max: 20)
+     * @returns Normalized address results with confidence scores
+     *
+     * @example
+     * ```typescript
+     * // Normalize with typos
+     * const result = await client.normalizeAddress('gedimno pr 28 vilnus');
+     * console.log(result.results[0].formatted); // "Gedimino pr. 28, Vilnius, Vilniaus m. sav., LT-01103"
+     * console.log(result.results[0].confidence); // 0.87
+     * console.log(result.results[0].components.street); // { code: 105641, name: "Gedimino", ... }
+     *
+     * // With building number
+     * const result2 = await client.normalizeAddress('kaunas laisves al 20a');
+     * console.log(result2.results[0].components.building); // { number: "20A", postalCode: "LT-44291" }
+     * ```
+     */
+    async normalizeAddress(address, limit) {
+        const response = await this.client.post('/addresses/normalize', { address, limit });
+        return response.data;
+    }
+    /**
+     * List all invoices for the authenticated user
+     * Note: Invoice requests do not count towards your monthly API quota
+     *
+     * @returns List of invoices
+     *
+     * @example
+     * ```typescript
+     * const { invoices } = await client.listInvoices();
+     * for (const invoice of invoices) {
+     *   console.log(invoice.number, invoice.status, invoice.total / 100);
+     * }
+     * ```
+     */
+    async listInvoices() {
+        const response = await this.client.get('/invoices');
+        return response.data;
+    }
+    /**
+     * Get a specific invoice by ID
+     * Note: Invoice requests do not count towards your monthly API quota
+     *
+     * @param invoiceId - Stripe invoice ID (e.g., "in_1abc123")
+     * @returns Invoice details
+     *
+     * @example
+     * ```typescript
+     * const invoice = await client.getInvoice('in_1abc123');
+     * console.log(invoice.number); // "INV-0091"
+     * console.log(invoice.total / 100); // 9.99
+     * console.log(invoice.customerName); // "UAB Example"
+     * ```
+     */
+    async getInvoice(invoiceId) {
+        const response = await this.client.get(`/invoices/${invoiceId}`);
+        return response.data;
+    }
+    /**
+     * Download invoice in UBL XML format (Peppol BIS Billing 3.0)
+     * The UBL format is compliant with European e-invoicing standard EN 16931
+     * Note: Invoice requests do not count towards your monthly API quota
+     *
+     * @param invoiceId - Stripe invoice ID (e.g., "in_1abc123")
+     * @returns UBL XML string
+     *
+     * @example
+     * ```typescript
+     * const xml = await client.getInvoiceUbl('in_1abc123');
+     * // Save to file
+     * fs.writeFileSync('invoice.xml', xml);
+     *
+     * // Or parse for processing
+     * const parser = new DOMParser();
+     * const doc = parser.parseFromString(xml, 'text/xml');
+     * ```
+     */
+    async getInvoiceUbl(invoiceId) {
+        const response = await this.client.get(`/invoices/${invoiceId}/ubl`);
+        return response.data;
+    }
 }
 exports.JarsClient = JarsClient;
 // Re-export types from @jars-lt/types for convenience

package/dist/index.js.map

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

package/example.ts

@@ -6,7 +6,7 @@
  * 2. Run: tsx example.ts
  */
 
-import { JarsClient, JarsAPIError } from './src/index';
+import { JarsClient, JarsAPIError, NormalizedAddress } from './src/index';
 
 async function main() {
   // Initialize client with API key from environment
@@ -78,6 +78,60 @@ async function main() {
         console.log(`  ... and ${location.streets.length - 3} more`);
       }
     }
+    console.log();
+
+    // Example 6: Check if a date is a workday
+    console.log('📅 Checking workdays...');
+    const today = new Date().toISOString().split('T')[0];
+    const workdayCheck = await client.checkWorkday(today);
+    console.log(`Date: ${workdayCheck.date} (${workdayCheck.dayOfWeek})`);
+    console.log(`Is workday: ${workdayCheck.isWorkday}`);
+    console.log(`Is weekend: ${workdayCheck.isWeekend}`);
+    console.log(`Is holiday: ${workdayCheck.isHoliday}`);
+    if (workdayCheck.holidayName) {
+      console.log(`Holiday: ${workdayCheck.holidayName}`);
+    }
+    console.log();
+
+    // Example 7: Check a Lithuanian holiday (Christmas)
+    console.log('🎄 Checking Christmas 2024...');
+    const christmas = await client.checkWorkday('2024-12-25');
+    console.log(`Date: ${christmas.date} (${christmas.dayOfWeek})`);
+    console.log(`Is workday: ${christmas.isWorkday}`);
+    console.log(`Is holiday: ${christmas.isHoliday}`);
+    if (christmas.holidayName) {
+      console.log(`Holiday: ${christmas.holidayName}`);
+    }
+    console.log();
+
+    // Example 8: Add workdays to a date
+    console.log('➕ Adding workdays...');
+    const addResult = await client.addWorkdays(today, 5);
+    console.log(`Start date: ${addResult.startDate}`);
+    console.log(`Workdays added: ${addResult.workdaysAdded}`);
+    console.log(`Result date: ${addResult.resultDate}`);
+    console.log(`Result is workday: ${addResult.resultIsWorkday}`);
+    console.log();
+
+    // Example 9: Normalize address with fuzzy matching
+    console.log('🏠 Normalizing address (with typos)...');
+    const normalized = await client.normalizeAddress('gedimno pr 28 vilnus', 3);
+    console.log(`Query: "${normalized.query}"`);
+    console.log(`Parsed tokens: ${normalized.parsed.tokens.join(', ')}`);
+    if (normalized.parsed.building) {
+      console.log(`Detected building: ${normalized.parsed.building}`);
+    }
+    console.log(`Found ${normalized.results.length} results:`);
+    normalized.results.forEach((result: NormalizedAddress, i: number) => {
+      console.log(`  ${i + 1}. ${result.formatted}`);
+      console.log(`     Confidence: ${(result.confidence * 100).toFixed(0)}%`);
+      if (result.components.building) {
+        console.log(`     Building: ${result.components.building.number}`);
+      }
+      if (result.components.postalCode) {
+        console.log(`     Postal: ${result.components.postalCode}`);
+      }
+    });
   } catch (error) {
     if (error instanceof JarsAPIError) {
       console.error('❌ API Error:', error.message);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jars-lt/sdk",
-  "version": "1.0.2",
-  "description": "Official Node.js SDK for JARS.LT API - Lithuanian Company Registry",
+  "version": "1.1.0",
+  "description": "Official Node.js SDK for JARS.LT API - Lithuanian and Estonian Company Registry",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -11,15 +11,11 @@
       "require": "./dist/index.js"
     }
   },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "clean": "rm -rf dist",
-    "prepublishOnly": "pnpm build"
-  },
   "keywords": [
     "jars",
     "lithuania",
+    "estonia",
+    "baltic",
     "company-registry",
     "api",
     "sdk",
@@ -29,11 +25,16 @@
   "license": "MIT",
   "homepage": "https://jars.lt",
   "dependencies": {
-    "@jars-lt/types": "^1.0.0",
-    "axios": "^1.6.2"
+    "axios": "^1.13.5",
+    "@jars-lt/types": "^1.1.0"
   },
   "devDependencies": {
-    "@types/node": "^20.10.0",
+    "@types/node": "^20.19.33",
     "typescript": "^5.3.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
   }
-}
+}