@jars-lt/sdk 1.1.0 → 1.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +37 -2
- package/dist/index.d.ts +74 -17
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +18 -6
- package/dist/index.js.map +1 -1
- package/package.json +10 -9
- package/.turbo/turbo-build.log +0 -5
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @jars-lt/sdk
|
|
2
2
|
|
|
3
|
-
Official Node.js SDK for [JARS.LT](https://jars.lt) -
|
|
3
|
+
Official Node.js SDK for [JARS.LT](https://jars.lt) - Baltic Company Registry API (Lithuania, Estonia, Latvia)
|
|
4
4
|
|
|
5
5
|
## Installation
|
|
6
6
|
|
|
@@ -57,15 +57,28 @@ const client = new JarsClient({
|
|
|
57
57
|
|
|
58
58
|
### Search Companies
|
|
59
59
|
|
|
60
|
-
Search for
|
|
60
|
+
Search for companies by name or code. Use the `country` option for Estonian (`ee`) or Latvian (`lv`) companies:
|
|
61
61
|
|
|
62
62
|
```typescript
|
|
63
|
+
// Lithuanian companies (default)
|
|
63
64
|
const results = await client.searchCompanies({
|
|
64
65
|
q: 'Maxima',
|
|
65
66
|
limit: 10,
|
|
66
67
|
offset: 0
|
|
67
68
|
});
|
|
68
69
|
|
|
70
|
+
// Estonian companies
|
|
71
|
+
const eeResults = await client.searchCompanies({
|
|
72
|
+
q: 'Bolt',
|
|
73
|
+
country: 'ee'
|
|
74
|
+
});
|
|
75
|
+
|
|
76
|
+
// Latvian companies
|
|
77
|
+
const lvResults = await client.searchCompanies({
|
|
78
|
+
q: 'ELKO',
|
|
79
|
+
country: 'lv'
|
|
80
|
+
});
|
|
81
|
+
|
|
69
82
|
console.log(`Found ${results.total} companies`);
|
|
70
83
|
results.results.forEach(company => {
|
|
71
84
|
console.log(`${company.name} (${company.code})`);
|
|
@@ -77,8 +90,15 @@ results.results.forEach(company => {
|
|
|
77
90
|
Retrieve detailed information about a specific company:
|
|
78
91
|
|
|
79
92
|
```typescript
|
|
93
|
+
// Lithuanian company
|
|
80
94
|
const company = await client.getCompany('111111111');
|
|
81
95
|
|
|
96
|
+
// Estonian company
|
|
97
|
+
const eeCompany = await client.getCompany('14532901', { country: 'ee' });
|
|
98
|
+
|
|
99
|
+
// Latvian company
|
|
100
|
+
const lvCompany = await client.getCompany('40003129564', { country: 'lv' });
|
|
101
|
+
|
|
82
102
|
console.log(company.name);
|
|
83
103
|
console.log(company.address);
|
|
84
104
|
console.log(company.status);
|
|
@@ -192,6 +212,21 @@ const plan: SubscriptionPlan = usage.plan; // 'FREE' | 'STARTER' | 'PROFESSIONAL
|
|
|
192
212
|
|
|
193
213
|
## Advanced Usage
|
|
194
214
|
|
|
215
|
+
### Country-Specific Base URLs
|
|
216
|
+
|
|
217
|
+
You can use country-specific API domains that default to the corresponding country:
|
|
218
|
+
|
|
219
|
+
```typescript
|
|
220
|
+
// api.jars.lt — Lithuanian data (default)
|
|
221
|
+
const ltClient = new JarsClient({ apiKey: 'key', baseURL: 'https://api.jars.lt/api/v1' });
|
|
222
|
+
|
|
223
|
+
// api.jars.ee — Estonian data by default
|
|
224
|
+
const eeClient = new JarsClient({ apiKey: 'key', baseURL: 'https://api.jars.ee/api/v1' });
|
|
225
|
+
|
|
226
|
+
// api.jars.lv — Latvian data by default
|
|
227
|
+
const lvClient = new JarsClient({ apiKey: 'key', baseURL: 'https://api.jars.lv/api/v1' });
|
|
228
|
+
```
|
|
229
|
+
|
|
195
230
|
### Custom Axios Configuration
|
|
196
231
|
|
|
197
232
|
The SDK uses axios internally. You can access the underlying axios instance if needed:
|
package/dist/index.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { Company, SubscriptionPlan, WorkdayCheckResponse, AddWorkdaysResponse, NormalizeAddressResponse, Invoice } from '@jars-lt/types';
|
|
1
|
+
import { Company, CompanyCountry, SubscriptionPlan, WorkdayCheckResponse, AddWorkdaysResponse, NormalizeAddressResponse, Invoice } from '@jars-lt/types';
|
|
2
2
|
/**
|
|
3
3
|
* Configuration options for JARS.LT client
|
|
4
4
|
*/
|
|
@@ -14,10 +14,11 @@ export interface JarsClientConfig {
|
|
|
14
14
|
* Search results response
|
|
15
15
|
*/
|
|
16
16
|
export interface SearchCompaniesResponse {
|
|
17
|
-
|
|
17
|
+
companies: Company[];
|
|
18
18
|
total: number;
|
|
19
19
|
limit: number;
|
|
20
20
|
offset: number;
|
|
21
|
+
country?: CompanyCountry;
|
|
21
22
|
}
|
|
22
23
|
/**
|
|
23
24
|
* Address search results
|
|
@@ -100,28 +101,47 @@ export interface UsageResponse {
|
|
|
100
101
|
export interface CompanyFinancialsData {
|
|
101
102
|
companyCode: string;
|
|
102
103
|
year: number;
|
|
103
|
-
periodStart
|
|
104
|
-
periodEnd
|
|
104
|
+
periodStart?: string;
|
|
105
|
+
periodEnd?: string;
|
|
105
106
|
reportDate?: string;
|
|
106
107
|
balance?: {
|
|
107
108
|
equity?: number;
|
|
108
109
|
longTermAssets?: number;
|
|
109
110
|
shortTermAssets?: number;
|
|
110
111
|
liabilities?: number;
|
|
112
|
+
longTermLiabilities?: number;
|
|
113
|
+
shortTermLiabilities?: number;
|
|
111
114
|
totalAssets?: number;
|
|
115
|
+
issuedCapital?: number;
|
|
116
|
+
cash?: number;
|
|
117
|
+
retainedEarnings?: number;
|
|
112
118
|
};
|
|
113
119
|
profitLoss?: {
|
|
114
120
|
revenue?: number;
|
|
115
121
|
profitBeforeTax?: number;
|
|
116
122
|
netProfit?: number;
|
|
123
|
+
employeeExpense?: number;
|
|
124
|
+
depreciation?: number;
|
|
125
|
+
};
|
|
126
|
+
employees?: number;
|
|
127
|
+
consolidated?: boolean;
|
|
128
|
+
audited?: boolean;
|
|
129
|
+
category?: string;
|
|
130
|
+
real?: {
|
|
131
|
+
revenue?: number;
|
|
132
|
+
profitBeforeTax?: number;
|
|
133
|
+
netProfit?: number;
|
|
134
|
+
equity?: number;
|
|
135
|
+
liabilities?: number;
|
|
136
|
+
totalAssets?: number;
|
|
117
137
|
};
|
|
118
138
|
templateId?: string;
|
|
119
139
|
templateName?: string;
|
|
120
140
|
standardId?: string;
|
|
121
141
|
standardName?: string;
|
|
122
|
-
dataDate
|
|
123
|
-
createdAt
|
|
124
|
-
updatedAt
|
|
142
|
+
dataDate?: string;
|
|
143
|
+
createdAt?: string;
|
|
144
|
+
updatedAt?: string;
|
|
125
145
|
}
|
|
126
146
|
/**
|
|
127
147
|
* Company financials response
|
|
@@ -129,8 +149,33 @@ export interface CompanyFinancialsData {
|
|
|
129
149
|
export interface CompanyFinancialsResponse {
|
|
130
150
|
companyCode: string;
|
|
131
151
|
companyName: string;
|
|
152
|
+
country?: CompanyCountry;
|
|
132
153
|
financials: CompanyFinancialsData[];
|
|
133
154
|
availableYears: number[];
|
|
155
|
+
inflation?: {
|
|
156
|
+
baseYear: number;
|
|
157
|
+
latestYear: number;
|
|
158
|
+
latestIndex: number;
|
|
159
|
+
};
|
|
160
|
+
}
|
|
161
|
+
/**
|
|
162
|
+
* Latest financials summary (returned with company details).
|
|
163
|
+
* LT returns full CompanyFinancialsData, EE/LV return a normalized summary.
|
|
164
|
+
*/
|
|
165
|
+
export interface LatestFinancialsSummary {
|
|
166
|
+
year: number;
|
|
167
|
+
revenue?: number | null;
|
|
168
|
+
profit?: number | null;
|
|
169
|
+
assets?: number | null;
|
|
170
|
+
equity?: number | null;
|
|
171
|
+
employees?: number | null;
|
|
172
|
+
[key: string]: unknown;
|
|
173
|
+
}
|
|
174
|
+
/**
|
|
175
|
+
* Company detail response (includes latest financials)
|
|
176
|
+
*/
|
|
177
|
+
export interface CompanyDetailResponse extends Company {
|
|
178
|
+
latestFinancials: LatestFinancialsSummary | null;
|
|
134
179
|
}
|
|
135
180
|
/**
|
|
136
181
|
* Invoices list response
|
|
@@ -149,9 +194,9 @@ export declare class JarsAPIError extends Error {
|
|
|
149
194
|
/**
|
|
150
195
|
* Official JARS.LT API Client
|
|
151
196
|
*
|
|
152
|
-
* Supports
|
|
197
|
+
* Supports Lithuanian, Estonian and Latvian company registries.
|
|
153
198
|
* Default country depends on the base URL: api.jars.lt defaults to Lithuania,
|
|
154
|
-
* api.jars.ee defaults to Estonia.
|
|
199
|
+
* api.jars.ee defaults to Estonia, api.jars.lv defaults to Latvia.
|
|
155
200
|
*
|
|
156
201
|
* @example
|
|
157
202
|
* ```typescript
|
|
@@ -167,7 +212,10 @@ export declare class JarsAPIError extends Error {
|
|
|
167
212
|
* // Search Estonian companies
|
|
168
213
|
* const eeCompanies = await client.searchCompanies({ q: 'Bolt', country: 'ee' });
|
|
169
214
|
*
|
|
170
|
-
* //
|
|
215
|
+
* // Search Latvian companies
|
|
216
|
+
* const lvCompanies = await client.searchCompanies({ q: 'ELKO', country: 'lv' });
|
|
217
|
+
*
|
|
218
|
+
* // Or use country-specific base URLs
|
|
171
219
|
* const eeClient = new JarsClient({
|
|
172
220
|
* apiKey: 'your_api_key_here',
|
|
173
221
|
* baseURL: 'https://api.jars.ee/api/v1'
|
|
@@ -184,7 +232,7 @@ export declare class JarsClient {
|
|
|
184
232
|
* @param params.q - Search query (company name or code)
|
|
185
233
|
* @param params.limit - Number of results (max: 100, default: 20)
|
|
186
234
|
* @param params.offset - Skip results (default: 0)
|
|
187
|
-
* @param params.country - Country: "lt" (Lithuania)
|
|
235
|
+
* @param params.country - Country: "lt" (Lithuania), "ee" (Estonia) or "lv" (Latvia). Default depends on base URL domain.
|
|
188
236
|
* @returns Search results with companies
|
|
189
237
|
*
|
|
190
238
|
* @example
|
|
@@ -194,20 +242,23 @@ export declare class JarsClient {
|
|
|
194
242
|
*
|
|
195
243
|
* // Search Estonian companies
|
|
196
244
|
* const eeResults = await client.searchCompanies({ q: 'Bolt', country: 'ee' });
|
|
245
|
+
*
|
|
246
|
+
* // Search Latvian companies
|
|
247
|
+
* const lvResults = await client.searchCompanies({ q: 'ELKO', country: 'lv' });
|
|
197
248
|
* ```
|
|
198
249
|
*/
|
|
199
250
|
searchCompanies(params: {
|
|
200
251
|
q: string;
|
|
201
252
|
limit?: number;
|
|
202
253
|
offset?: number;
|
|
203
|
-
country?: 'lt' | 'ee';
|
|
254
|
+
country?: 'lt' | 'ee' | 'lv';
|
|
204
255
|
}): Promise<SearchCompaniesResponse>;
|
|
205
256
|
/**
|
|
206
257
|
* Get company details by company code
|
|
207
258
|
*
|
|
208
259
|
* @param code - Company registration code
|
|
209
260
|
* @param options - Optional parameters
|
|
210
|
-
* @param options.country - Country: "lt" (Lithuania)
|
|
261
|
+
* @param options.country - Country: "lt" (Lithuania), "ee" (Estonia) or "lv" (Latvia). Default depends on base URL domain.
|
|
211
262
|
* @returns Company details
|
|
212
263
|
*
|
|
213
264
|
* @example
|
|
@@ -217,11 +268,14 @@ export declare class JarsClient {
|
|
|
217
268
|
*
|
|
218
269
|
* // Estonian company
|
|
219
270
|
* const eeCompany = await client.getCompany('14532901', { country: 'ee' });
|
|
271
|
+
*
|
|
272
|
+
* // Latvian company
|
|
273
|
+
* const lvCompany = await client.getCompany('40003129564', { country: 'lv' });
|
|
220
274
|
* ```
|
|
221
275
|
*/
|
|
222
276
|
getCompany(code: string, options?: {
|
|
223
|
-
country?: 'lt' | 'ee';
|
|
224
|
-
}): Promise<
|
|
277
|
+
country?: 'lt' | 'ee' | 'lv';
|
|
278
|
+
}): Promise<CompanyDetailResponse>;
|
|
225
279
|
/**
|
|
226
280
|
* Get company financial reports (balance sheet + P&L)
|
|
227
281
|
*
|
|
@@ -229,7 +283,7 @@ export declare class JarsClient {
|
|
|
229
283
|
* @param params - Optional parameters
|
|
230
284
|
* @param params.year - Specific year to fetch (optional, returns all years if not specified)
|
|
231
285
|
* @param params.limit - Maximum number of years to return (default: 10, max: 50)
|
|
232
|
-
* @param params.country - Country: "lt" (Lithuania)
|
|
286
|
+
* @param params.country - Country: "lt" (Lithuania), "ee" (Estonia) or "lv" (Latvia). Default depends on base URL domain.
|
|
233
287
|
* @returns Financial reports with balance sheet and P&L data
|
|
234
288
|
*
|
|
235
289
|
* @example
|
|
@@ -242,12 +296,15 @@ export declare class JarsClient {
|
|
|
242
296
|
*
|
|
243
297
|
* // Estonian company financials
|
|
244
298
|
* const eeFinancials = await client.getCompanyFinancials('14532901', { country: 'ee' });
|
|
299
|
+
*
|
|
300
|
+
* // Latvian company financials
|
|
301
|
+
* const lvFinancials = await client.getCompanyFinancials('40003129564', { country: 'lv' });
|
|
245
302
|
* ```
|
|
246
303
|
*/
|
|
247
304
|
getCompanyFinancials(code: string, params?: {
|
|
248
305
|
year?: number;
|
|
249
306
|
limit?: number;
|
|
250
|
-
country?: 'lt' | 'ee';
|
|
307
|
+
country?: 'lt' | 'ee' | 'lv';
|
|
251
308
|
}): Promise<CompanyFinancialsResponse>;
|
|
252
309
|
/**
|
|
253
310
|
* Search for addresses (streets, settlements, municipalities)
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -34,9 +34,9 @@ exports.JarsAPIError = JarsAPIError;
|
|
|
34
34
|
/**
|
|
35
35
|
* Official JARS.LT API Client
|
|
36
36
|
*
|
|
37
|
-
* Supports
|
|
37
|
+
* Supports Lithuanian, Estonian and Latvian company registries.
|
|
38
38
|
* Default country depends on the base URL: api.jars.lt defaults to Lithuania,
|
|
39
|
-
* api.jars.ee defaults to Estonia.
|
|
39
|
+
* api.jars.ee defaults to Estonia, api.jars.lv defaults to Latvia.
|
|
40
40
|
*
|
|
41
41
|
* @example
|
|
42
42
|
* ```typescript
|
|
@@ -52,7 +52,10 @@ exports.JarsAPIError = JarsAPIError;
|
|
|
52
52
|
* // Search Estonian companies
|
|
53
53
|
* const eeCompanies = await client.searchCompanies({ q: 'Bolt', country: 'ee' });
|
|
54
54
|
*
|
|
55
|
-
* //
|
|
55
|
+
* // Search Latvian companies
|
|
56
|
+
* const lvCompanies = await client.searchCompanies({ q: 'ELKO', country: 'lv' });
|
|
57
|
+
*
|
|
58
|
+
* // Or use country-specific base URLs
|
|
56
59
|
* const eeClient = new JarsClient({
|
|
57
60
|
* apiKey: 'your_api_key_here',
|
|
58
61
|
* baseURL: 'https://api.jars.ee/api/v1'
|
|
@@ -88,7 +91,7 @@ class JarsClient {
|
|
|
88
91
|
* @param params.q - Search query (company name or code)
|
|
89
92
|
* @param params.limit - Number of results (max: 100, default: 20)
|
|
90
93
|
* @param params.offset - Skip results (default: 0)
|
|
91
|
-
* @param params.country - Country: "lt" (Lithuania)
|
|
94
|
+
* @param params.country - Country: "lt" (Lithuania), "ee" (Estonia) or "lv" (Latvia). Default depends on base URL domain.
|
|
92
95
|
* @returns Search results with companies
|
|
93
96
|
*
|
|
94
97
|
* @example
|
|
@@ -98,6 +101,9 @@ class JarsClient {
|
|
|
98
101
|
*
|
|
99
102
|
* // Search Estonian companies
|
|
100
103
|
* const eeResults = await client.searchCompanies({ q: 'Bolt', country: 'ee' });
|
|
104
|
+
*
|
|
105
|
+
* // Search Latvian companies
|
|
106
|
+
* const lvResults = await client.searchCompanies({ q: 'ELKO', country: 'lv' });
|
|
101
107
|
* ```
|
|
102
108
|
*/
|
|
103
109
|
async searchCompanies(params) {
|
|
@@ -109,7 +115,7 @@ class JarsClient {
|
|
|
109
115
|
*
|
|
110
116
|
* @param code - Company registration code
|
|
111
117
|
* @param options - Optional parameters
|
|
112
|
-
* @param options.country - Country: "lt" (Lithuania)
|
|
118
|
+
* @param options.country - Country: "lt" (Lithuania), "ee" (Estonia) or "lv" (Latvia). Default depends on base URL domain.
|
|
113
119
|
* @returns Company details
|
|
114
120
|
*
|
|
115
121
|
* @example
|
|
@@ -119,6 +125,9 @@ class JarsClient {
|
|
|
119
125
|
*
|
|
120
126
|
* // Estonian company
|
|
121
127
|
* const eeCompany = await client.getCompany('14532901', { country: 'ee' });
|
|
128
|
+
*
|
|
129
|
+
* // Latvian company
|
|
130
|
+
* const lvCompany = await client.getCompany('40003129564', { country: 'lv' });
|
|
122
131
|
* ```
|
|
123
132
|
*/
|
|
124
133
|
async getCompany(code, options) {
|
|
@@ -132,7 +141,7 @@ class JarsClient {
|
|
|
132
141
|
* @param params - Optional parameters
|
|
133
142
|
* @param params.year - Specific year to fetch (optional, returns all years if not specified)
|
|
134
143
|
* @param params.limit - Maximum number of years to return (default: 10, max: 50)
|
|
135
|
-
* @param params.country - Country: "lt" (Lithuania)
|
|
144
|
+
* @param params.country - Country: "lt" (Lithuania), "ee" (Estonia) or "lv" (Latvia). Default depends on base URL domain.
|
|
136
145
|
* @returns Financial reports with balance sheet and P&L data
|
|
137
146
|
*
|
|
138
147
|
* @example
|
|
@@ -145,6 +154,9 @@ class JarsClient {
|
|
|
145
154
|
*
|
|
146
155
|
* // Estonian company financials
|
|
147
156
|
* const eeFinancials = await client.getCompanyFinancials('14532901', { country: 'ee' });
|
|
157
|
+
*
|
|
158
|
+
* // Latvian company financials
|
|
159
|
+
* const lvFinancials = await client.getCompanyFinancials('40003129564', { country: 'lv' });
|
|
148
160
|
* ```
|
|
149
161
|
*/
|
|
150
162
|
async getCompanyFinancials(code, params) {
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA,kDAAyD;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@jars-lt/sdk",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.2",
|
|
4
4
|
"description": "Official Node.js SDK for JARS.LT API - Lithuanian and Estonian Company Registry",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -11,6 +11,12 @@
|
|
|
11
11
|
"require": "./dist/index.js"
|
|
12
12
|
}
|
|
13
13
|
},
|
|
14
|
+
"scripts": {
|
|
15
|
+
"build": "tsc",
|
|
16
|
+
"dev": "tsc --watch",
|
|
17
|
+
"clean": "rm -rf dist",
|
|
18
|
+
"prepublishOnly": "pnpm build"
|
|
19
|
+
},
|
|
14
20
|
"keywords": [
|
|
15
21
|
"jars",
|
|
16
22
|
"lithuania",
|
|
@@ -25,16 +31,11 @@
|
|
|
25
31
|
"license": "MIT",
|
|
26
32
|
"homepage": "https://jars.lt",
|
|
27
33
|
"dependencies": {
|
|
28
|
-
"
|
|
29
|
-
"
|
|
34
|
+
"@jars-lt/types": "workspace:^",
|
|
35
|
+
"axios": "^1.13.5"
|
|
30
36
|
},
|
|
31
37
|
"devDependencies": {
|
|
32
38
|
"@types/node": "^20.19.33",
|
|
33
39
|
"typescript": "^5.3.3"
|
|
34
|
-
},
|
|
35
|
-
"scripts": {
|
|
36
|
-
"build": "tsc",
|
|
37
|
-
"dev": "tsc --watch",
|
|
38
|
-
"clean": "rm -rf dist"
|
|
39
40
|
}
|
|
40
|
-
}
|
|
41
|
+
}
|