lt-open-data-sdk 1.0.0

package/dist/client/SpintaClient.js

@@ -0,0 +1,262 @@
+/**
+ * SpintaClient - HTTP client for the Lithuanian Open Data API (data.gov.lt)
+ *
+ * @example
+ * ```typescript
+ * import { SpintaClient, QueryBuilder } from 'lt-data-sdk';
+ *
+ * const client = new SpintaClient();
+ *
+ * // Get all items (single page - uses limit from query or API default)
+ * const cities = await client.getAll('datasets/gov/example/City');
+ *
+ * // Stream all items with automatic pagination
+ * for await (const city of client.stream('datasets/gov/example/City')) {
+ *   console.log(city.name);
+ * }
+ *
+ * // With query builder
+ * const query = new QueryBuilder()
+ *   .select('name', 'population')
+ *   .filter(f => f.field('population').gt(100000))
+ *   .limit(100);
+ *
+ * const largeCities = await client.getAll('datasets/gov/example/City', query);
+ * ```
+ */
+import { TokenCache } from './auth.js';
+import { handleErrorResponse } from './errors.js';
+/** Default configuration values */
+const DEFAULT_BASE_URL = 'https://get.data.gov.lt';
+const DEFAULT_AUTH_URL = 'https://put.data.gov.lt';
+const DEFAULT_SCOPES = [
+    'spinta_getone',
+    'spinta_getall',
+    'spinta_search',
+    'spinta_changes',
+];
+export class SpintaClient {
+    baseUrl;
+    tokenCache;
+    constructor(config = {}) {
+        this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, '');
+        // Initialize token cache only if credentials are provided
+        if (config.clientId !== undefined && config.clientSecret !== undefined) {
+            this.tokenCache = new TokenCache(config.authUrl ?? DEFAULT_AUTH_URL, config.clientId, config.clientSecret, config.scopes ?? DEFAULT_SCOPES);
+        }
+        else {
+            this.tokenCache = null;
+        }
+    }
+    /**
+     * Build headers for API requests
+     * Refreshes token if needed before each request
+     */
+    async getHeaders() {
+        const headers = {
+            Accept: 'application/json',
+        };
+        if (this.tokenCache !== null) {
+            const token = await this.tokenCache.getToken();
+            headers.Authorization = `Bearer ${token}`;
+        }
+        return headers;
+    }
+    /**
+     * Make an HTTP request to the API
+     */
+    async request(path, query = '') {
+        const url = `${this.baseUrl}${path}${query}`;
+        const headers = await this.getHeaders();
+        const response = await fetch(url, { headers });
+        if (!response.ok) {
+            await handleErrorResponse(response);
+        }
+        return response.json();
+    }
+    /**
+     * Get a single object by its UUID
+     *
+     * @param model - Full model path (e.g., 'datasets/gov/example/City')
+     * @param id - Object UUID
+     * @returns The object with metadata
+     *
+     * @example
+     * const city = await client.getOne('datasets/gov/example/City', 'abc123-...');
+     */
+    async getOne(model, id) {
+        const path = `/${model}/${id}`;
+        return this.request(path);
+    }
+    /**
+     * Get objects from a model (single page only)
+     *
+     * **Note**: This fetches ONE page of results based on the limit in your query
+     * (or the API's default limit). It does NOT download all records.
+     * For large datasets, use `stream()` which handles pagination automatically.
+     *
+     * @param model - Full model path (e.g., 'datasets/gov/example/City')
+     * @param query - Optional query builder for filtering, sorting, limiting
+     * @returns Array of objects with metadata (unwrapped from _data)
+     *
+     * @example
+     * // Get first 100 cities
+     * const query = new QueryBuilder().limit(100);
+     * const cities = await client.getAll('datasets/gov/example/City', query);
+     */
+    async getAll(model, query) {
+        const response = await this.getAllRaw(model, query);
+        return response._data;
+    }
+    /**
+     * Get raw response with metadata (includes _type, _page info)
+     *
+     * Use this when you need pagination info or the response type.
+     *
+     * @param model - Full model path
+     * @param query - Optional query builder
+     * @returns Full Spinta response with _data array and _page info
+     */
+    async getAllRaw(model, query) {
+        const path = `/${model}`;
+        const queryString = query?.toQueryString() ?? '';
+        return this.request(path, queryString);
+    }
+    /**
+     * Stream all objects with automatic pagination
+     *
+     * Implements an async iterator that automatically fetches subsequent pages
+     * using the `_page.next` token. Validates token before each page fetch to
+     * avoid mid-stream auth failures on large datasets.
+     *
+     * @param model - Full model path
+     * @param query - Optional query builder (should include limit for page size)
+     * @yields Objects one at a time with metadata
+     *
+     * @example
+     * // Stream all cities with a filter
+     * const query = new QueryBuilder()
+     *   .filter(f => f.field('population').gt(10000))
+     *   .limit(1000); // Page size
+     *
+     * for await (const city of client.stream('datasets/gov/example/City', query)) {
+     *   console.log(city.name);
+     * }
+     */
+    async *stream(model, query) {
+        const path = `/${model}`;
+        const baseQuery = query?.toQueryString() ?? '';
+        let pageToken;
+        do {
+            // Build query with page token if we have one
+            let queryString = baseQuery;
+            if (pageToken !== undefined) {
+                const separator = baseQuery !== '' ? '&' : '?';
+                queryString = `${baseQuery}${separator}page("${pageToken}")`;
+            }
+            // Fetch page (getHeaders validates token before each request)
+            const response = await this.request(path, queryString);
+            // Yield each item
+            for (const item of response._data) {
+                yield item;
+            }
+            // Get next page token
+            pageToken = response._page?.next;
+        } while (pageToken !== undefined);
+    }
+    /**
+     * Count objects matching a query
+     *
+     * @param model - Full model path
+     * @param query - Optional query builder for filtering (sort/select are ignored)
+     * @returns Number of matching objects
+     *
+     * @example
+     * const query = new QueryBuilder().filter(f => f.field('population').gt(100000));
+     * const count = await client.count('datasets/gov/example/City', query);
+     */
+    async count(model, query) {
+        const path = `/${model}`;
+        // Build count query
+        let queryString = query?.toQueryString() ?? '';
+        const separator = queryString !== '' ? '&' : '?';
+        queryString = `${queryString}${separator}count()`;
+        const response = await this.request(path, queryString);
+        const countValue = response._data[0];
+        return countValue['count()'];
+    }
+    /**
+     * List contents of a namespace
+     *
+     * @param namespace - Namespace path (e.g., 'datasets/gov/ivpk')
+     * @returns Array of namespace items (sub-namespaces and models)
+     *
+     * @example
+     * const items = await client.listNamespace('datasets/gov/ivpk');
+     * for (const item of items) {
+     *   if (item._type === 'ns') {
+     *     console.log('Namespace:', item._id);
+     *   } else {
+     *     console.log('Model:', item._id);
+     *   }
+     * }
+     */
+    async listNamespace(namespace) {
+        const path = `/${namespace}/:ns`;
+        const response = await this.request(path);
+        // Transform API response to NamespaceItem format
+        // API returns: { name: "path/:ns" or "path/Model", title, description }
+        return response._data.map((item) => {
+            const isNamespace = item.name.endsWith('/:ns');
+            const cleanPath = isNamespace
+                ? item.name.slice(0, -4) // Remove '/:ns' suffix
+                : item.name;
+            return {
+                _id: cleanPath,
+                _type: isNamespace ? 'ns' : 'model',
+                title: item.title,
+            };
+        });
+    }
+    /**
+     * Discover all models within a namespace (recursively)
+     *
+     * Traverses the namespace hierarchy and returns all model paths found.
+     * Useful for exploring what data is available in a given area.
+     *
+     * @param namespace - Starting namespace path (e.g., 'datasets/gov/rc')
+     * @returns Array of discovered models with path and title
+     *
+     * @example
+     * ```typescript
+     * // Find all models in the Registry Centre
+     * const models = await client.discoverModels('datasets/gov/rc');
+     * console.log(`Found ${models.length} models`);
+     * for (const model of models) {
+     *   console.log(`- ${model.title ?? model.path}`);
+     * }
+     * ```
+     */
+    async discoverModels(namespace) {
+        const models = [];
+        const traverse = async (ns) => {
+            const items = await this.listNamespace(ns);
+            for (const item of items) {
+                if (item._type === 'model') {
+                    models.push({
+                        path: item._id,
+                        title: item.title,
+                        namespace: ns,
+                    });
+                }
+                else {
+                    // Recurse into sub-namespace
+                    await traverse(item._id);
+                }
+            }
+        };
+        await traverse(namespace);
+        return models;
+    }
+}
+//# sourceMappingURL=SpintaClient.js.map

package/dist/client/SpintaClient.js.map

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

package/dist/client/auth.d.ts

@@ -0,0 +1,31 @@
+/**
+ * OAuth token management for Spinta API
+ */
+/**
+ * Token cache for managing OAuth tokens
+ */
+export declare class TokenCache {
+    private cachedToken;
+    private readonly authUrl;
+    private readonly clientId;
+    private readonly clientSecret;
+    private readonly scopes;
+    constructor(authUrl: string, clientId: string, clientSecret: string, scopes: readonly string[]);
+    /**
+     * Check if current token is valid (exists and not near expiry)
+     */
+    isValid(): boolean;
+    /**
+     * Get current token, fetching or refreshing if needed
+     */
+    getToken(): Promise<string>;
+    /**
+     * Fetch a new token from the auth server
+     */
+    private refresh;
+    /**
+     * Clear the cached token (useful for logout or forced refresh)
+     */
+    clear(): void;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/client/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/client/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,WAAW,CAA4B;IAE/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;gBAGzC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,SAAS,MAAM,EAAE;IAQ3B;;OAEG;IACH,OAAO,IAAI,OAAO;IAQlB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAajC;;OAEG;YACW,OAAO;IAyCrB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/client/auth.js

@@ -0,0 +1,96 @@
+/**
+ * OAuth token management for Spinta API
+ */
+import { AuthenticationError } from './errors.js';
+/** Buffer time before token expiry to trigger refresh (5 minutes) */
+const EXPIRY_BUFFER_MS = 5 * 60 * 1000;
+/**
+ * Token cache for managing OAuth tokens
+ */
+export class TokenCache {
+    cachedToken = null;
+    authUrl;
+    clientId;
+    clientSecret;
+    scopes;
+    constructor(authUrl, clientId, clientSecret, scopes) {
+        this.authUrl = authUrl;
+        this.clientId = clientId;
+        this.clientSecret = clientSecret;
+        this.scopes = scopes;
+    }
+    /**
+     * Check if current token is valid (exists and not near expiry)
+     */
+    isValid() {
+        if (this.cachedToken === null) {
+            return false;
+        }
+        // Check if token expires in less than buffer time
+        return Date.now() < this.cachedToken.expiresAt - EXPIRY_BUFFER_MS;
+    }
+    /**
+     * Get current token, fetching or refreshing if needed
+     */
+    async getToken() {
+        if (!this.isValid()) {
+            await this.refresh();
+        }
+        // After refresh, cachedToken is guaranteed to be set
+        if (this.cachedToken === null) {
+            throw new AuthenticationError('Failed to obtain access token');
+        }
+        return this.cachedToken.accessToken;
+    }
+    /**
+     * Fetch a new token from the auth server
+     */
+    async refresh() {
+        const url = `${this.authUrl}/auth/token`;
+        // Create Basic auth header
+        const credentials = Buffer.from(`${this.clientId}:${this.clientSecret}`).toString('base64');
+        const body = new URLSearchParams({
+            grant_type: 'client_credentials',
+            scope: this.scopes.join(' '),
+        });
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                Authorization: `Basic ${credentials}`,
+                'Content-Type': 'application/x-www-form-urlencoded',
+            },
+            body: body.toString(),
+        });
+        if (!response.ok) {
+            let errorMessage = 'Failed to obtain access token';
+            try {
+                const errorBody = await response.json();
+                if (isOAuthErrorResponse(errorBody) && typeof errorBody.error_description === 'string') {
+                    errorMessage = errorBody.error_description;
+                }
+            }
+            catch {
+                // Ignore JSON parse errors
+            }
+            throw new AuthenticationError(errorMessage, response.status);
+        }
+        const data = (await response.json());
+        this.cachedToken = {
+            accessToken: data.access_token,
+            expiresAt: Date.now() + data.expires_in * 1000,
+        };
+    }
+    /**
+     * Clear the cached token (useful for logout or forced refresh)
+     */
+    clear() {
+        this.cachedToken = null;
+    }
+}
+/**
+ * Type guard for OAuth error response
+ */
+function isOAuthErrorResponse(value) {
+    return typeof value === 'object' && value !== null;
+}
+//# sourceMappingURL=auth.js.map

package/dist/client/auth.js.map

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

package/dist/client/errors.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Custom error classes for Spinta API errors
+ */
+import type { SpintaErrorResponse } from './types.js';
+/**
+ * Base error class for Spinta-related errors
+ */
+export declare class SpintaError extends Error {
+    readonly status: number;
+    readonly body: SpintaErrorResponse | null;
+    constructor(message: string, status: number, body?: SpintaErrorResponse | null);
+}
+/**
+ * Authentication error (401/403)
+ */
+export declare class AuthenticationError extends SpintaError {
+    constructor(message?: string, status?: number, body?: SpintaErrorResponse | null);
+}
+/**
+ * Resource not found error (404)
+ */
+export declare class NotFoundError extends SpintaError {
+    constructor(message?: string, body?: SpintaErrorResponse | null);
+}
+/**
+ * Validation error (400) - usually bad query parameters
+ */
+export declare class ValidationError extends SpintaError {
+    constructor(message?: string, body?: SpintaErrorResponse | null);
+}
+/**
+ * Parse error response body and throw appropriate error
+ */
+export declare function handleErrorResponse(response: Response): Promise<never>;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAC;gBAErC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,mBAAmB,GAAG,IAAW;CASrF;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,OAAO,SAA0B,EAAE,MAAM,SAAM,EAAE,IAAI,GAAE,mBAAmB,GAAG,IAAW;CAIrG;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;gBAChC,OAAO,SAAuB,EAAE,IAAI,GAAE,mBAAmB,GAAG,IAAW;CAIpF;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,SAAqB,EAAE,IAAI,GAAE,mBAAmB,GAAG,IAAW;CAIlF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAyB5E"}

package/dist/client/errors.js

@@ -0,0 +1,73 @@
+/**
+ * Custom error classes for Spinta API errors
+ */
+/**
+ * Base error class for Spinta-related errors
+ */
+export class SpintaError extends Error {
+    status;
+    body;
+    constructor(message, status, body = null) {
+        super(message);
+        this.name = 'SpintaError';
+        this.status = status;
+        this.body = body;
+        // Maintains proper stack trace for where error was thrown (V8 only)
+        Error.captureStackTrace(this, SpintaError);
+    }
+}
+/**
+ * Authentication error (401/403)
+ */
+export class AuthenticationError extends SpintaError {
+    constructor(message = 'Authentication failed', status = 401, body = null) {
+        super(message, status, body);
+        this.name = 'AuthenticationError';
+    }
+}
+/**
+ * Resource not found error (404)
+ */
+export class NotFoundError extends SpintaError {
+    constructor(message = 'Resource not found', body = null) {
+        super(message, 404, body);
+        this.name = 'NotFoundError';
+    }
+}
+/**
+ * Validation error (400) - usually bad query parameters
+ */
+export class ValidationError extends SpintaError {
+    constructor(message = 'Validation error', body = null) {
+        super(message, 400, body);
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Parse error response body and throw appropriate error
+ */
+export async function handleErrorResponse(response) {
+    let body = null;
+    try {
+        const text = await response.text();
+        if (text !== '') {
+            body = JSON.parse(text);
+        }
+    }
+    catch {
+        // Ignore JSON parse errors
+    }
+    const message = body?.message ?? body?.errors?.[0]?.message ?? response.statusText;
+    switch (response.status) {
+        case 400:
+            throw new ValidationError(message, body);
+        case 401:
+        case 403:
+            throw new AuthenticationError(message, response.status, body);
+        case 404:
+            throw new NotFoundError(message, body);
+        default:
+            throw new SpintaError(message, response.status, body);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/client/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpB,MAAM,CAAS;IACf,IAAI,CAA6B;IAEjD,YAAY,OAAe,EAAE,MAAc,EAAE,OAAmC,IAAI;QAClF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,oEAAoE;QACpE,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC7C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,OAAO,GAAG,uBAAuB,EAAE,MAAM,GAAG,GAAG,EAAE,OAAmC,IAAI;QAClG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C,YAAY,OAAO,GAAG,oBAAoB,EAAE,OAAmC,IAAI;QACjF,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,YAAY,OAAO,GAAG,kBAAkB,EAAE,OAAmC,IAAI;QAC/E,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAAkB;IAC1D,IAAI,IAAI,GAA+B,IAAI,CAAC;IAE5C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YAChB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAwB,CAAC;QACjD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;IAC7B,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,QAAQ,CAAC,UAAU,CAAC;IAEnF,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;QACxB,KAAK,GAAG;YACN,MAAM,IAAI,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3C,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,MAAM,IAAI,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAChE,KAAK,GAAG;YACN,MAAM,IAAI,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACzC;YACE,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC"}

package/dist/client/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * SpintaClient module - HTTP client for Lithuanian Open Data API
+ */
+export { SpintaClient } from './SpintaClient.js';
+export type { DiscoveredModel } from './SpintaClient.js';
+export { SpintaError, AuthenticationError, NotFoundError, ValidationError, } from './errors.js';
+export type { ClientConfig, SpintaObject, SpintaResponse, PageInfo, TokenResponse, CachedToken, CountResponse, SpintaErrorResponse, NamespaceItem, NamespaceResponse, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,aAAa,EACb,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,6 @@
+/**
+ * SpintaClient module - HTTP client for Lithuanian Open Data API
+ */
+export { SpintaClient } from './SpintaClient.js';
+export { SpintaError, AuthenticationError, NotFoundError, ValidationError, } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/client/types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Type definitions for the SpintaClient module
+ */
+/** OAuth token response from Spinta auth endpoint */
+export interface TokenResponse {
+    access_token: string;
+    token_type: string;
+    expires_in: number;
+    scope?: string;
+}
+/** Cached token with expiry tracking */
+export interface CachedToken {
+    accessToken: string;
+    expiresAt: number;
+}
+/** Client configuration options */
+export interface ClientConfig {
+    /**
+     * Base URL for the Spinta API
+     * @default 'https://get.data.gov.lt'
+     */
+    baseUrl?: string;
+    /**
+     * OAuth client ID for authenticated requests
+     * If not provided, only public data can be accessed
+     */
+    clientId?: string;
+    /**
+     * OAuth client secret for authenticated requests
+     */
+    clientSecret?: string;
+    /**
+     * Auth server URL (different from data server for data.gov.lt)
+     * @default 'https://put.data.gov.lt'
+     */
+    authUrl?: string;
+    /**
+     * OAuth scopes to request
+     * @default ['spinta_getone', 'spinta_getall', 'spinta_search', 'spinta_changes']
+     */
+    scopes?: string[];
+}
+/** Spinta object base metadata */
+export interface SpintaObject {
+    _id: string;
+    _type: string;
+    _revision?: string;
+    _txn?: string;
+}
+/** Page information for pagination */
+export interface PageInfo {
+    /**
+     * Base64-encoded token for the next page
+     * If undefined, there are no more pages
+     */
+    next?: string;
+}
+/**
+ * Response wrapper from Spinta getall endpoints
+ * Use `getAllRaw()` to get this structure, or `getAll()` for just the data array
+ */
+export interface SpintaResponse<T> {
+    _type: string;
+    _data: (T & SpintaObject)[];
+    _page?: PageInfo;
+}
+/** Response from count queries */
+export interface CountResponse {
+    _type: string;
+    _data: [{
+        'count()': number;
+    }];
+}
+/** Spinta error response structure */
+export interface SpintaErrorResponse {
+    type?: string;
+    code?: string;
+    message?: string;
+    errors?: {
+        type?: string;
+        code?: string;
+        context?: Record<string, unknown>;
+        message?: string;
+    }[];
+}
+/** Namespace item from /:ns endpoint */
+export interface NamespaceItem {
+    _id: string;
+    _type: 'ns' | 'model';
+    title?: string;
+}
+/** Namespace listing response */
+export interface NamespaceResponse {
+    _data: NamespaceItem[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,kCAAkC;AAClC,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,sCAAsC;AACtC,MAAM,WAAW,QAAQ;IACvB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChC;AAED,sCAAsC;AACtC,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;CACL;AAED,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,iCAAiC;AACjC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB"}

package/dist/client/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for the SpintaClient module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}