lt-open-data-sdk 1.0.0

package/dist/cli/index.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+/**
+ * lt-gen CLI - Generate TypeScript definitions from Spinta API metadata
+ *
+ * Usage:
+ *   npx lt-gen <namespace> [options]
+ *
+ * Examples:
+ *   npx lt-gen datasets/gov/ivpk/adk
+ *   npx lt-gen datasets/gov/ivpk/adk --output ./types/adk.d.ts
+ *   npx lt-gen datasets/gov/ivpk/adk --base-url https://get.data.gov.lt
+ *
+ * Options:
+ *   --output, -o   Output file path (default: stdout)
+ *   --base-url     Base URL for the API (default: https://get.data.gov.lt)
+ *   --help, -h     Show help
+ */
+import { writeFileSync } from 'fs';
+import { SpintaClient } from '../client/SpintaClient.js';
+import { crawlNamespace, fetchAllModelsMetadata } from './crawler.js';
+import { generateDeclarationFile } from './generator.js';
+import { modelPathToInterfaceName } from './typeMapper.js';
+function parseArgs(args) {
+    const options = {
+        namespace: '',
+        output: undefined,
+        baseUrl: 'https://get.data.gov.lt',
+        help: false,
+    };
+    let skipNext = false;
+    for (const [index, arg] of args.entries()) {
+        if (skipNext) {
+            skipNext = false;
+            continue;
+        }
+        if (arg === '--help' || arg === '-h') {
+            options.help = true;
+        }
+        else if (arg === '--output' || arg === '-o') {
+            const nextArg = args[index + 1];
+            if (nextArg !== undefined) {
+                options.output = nextArg;
+                skipNext = true;
+            }
+        }
+        else if (arg === '--base-url') {
+            const nextArg = args[index + 1];
+            if (nextArg !== undefined) {
+                options.baseUrl = nextArg;
+                skipNext = true;
+            }
+        }
+        else if (!arg.startsWith('-') && options.namespace === '') {
+            options.namespace = arg;
+        }
+    }
+    return options;
+}
+function showHelp() {
+    console.log(`
+lt-gen - Generate TypeScript definitions from Spinta API metadata
+
+Usage:
+  lt-gen <namespace> [options]
+
+Arguments:
+  namespace        Namespace path to generate types for (e.g., datasets/gov/ivpk/adk)
+
+Options:
+  --output, -o     Output file path (default: stdout)
+  --base-url       Base URL for the API (default: https://get.data.gov.lt)
+  --help, -h       Show this help message
+
+Examples:
+  lt-gen datasets/gov/ivpk/adk
+  lt-gen datasets/gov/ivpk/adk -o ./types/adk.d.ts
+  lt-gen datasets/gov/ivpk/adk --base-url https://get-test.data.gov.lt
+`);
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const options = parseArgs(args);
+    if (options.help || options.namespace === '') {
+        showHelp();
+        process.exit(options.help ? 0 : 1);
+    }
+    console.error(`🔍 Discovering models in ${options.namespace}...`);
+    const client = new SpintaClient({ baseUrl: options.baseUrl });
+    try {
+        // Crawl namespace to find all models
+        const modelPaths = await crawlNamespace(client, options.namespace);
+        if (modelPaths.length === 0) {
+            console.error(`⚠️  No models found in namespace: ${options.namespace}`);
+            process.exit(1);
+        }
+        console.error(`📦 Found ${String(modelPaths.length)} model(s):`);
+        for (const path of modelPaths) {
+            console.error(`   - ${modelPathToInterfaceName(path)} (${path})`);
+        }
+        // Fetch metadata for all models
+        console.error(`\n📥 Fetching model metadata...`);
+        const metadata = await fetchAllModelsMetadata(client, modelPaths);
+        // Generate declaration file
+        console.error(`\n📝 Generating TypeScript definitions...`);
+        const output = generateDeclarationFile(metadata, options.namespace);
+        // Write output
+        if (options.output !== undefined) {
+            writeFileSync(options.output, output, 'utf-8');
+            console.error(`\n✅ Written to ${options.output}`);
+        }
+        else {
+            console.log(output);
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(`\n❌ Error: ${errorMessage}`);
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    console.error(errorMessage);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/typeMapper.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Type mapper for converting Spinta types to TypeScript types
+ *
+ * Based on duomenu-tipai.rst.txt documentation
+ */
+/**
+ * Map a Spinta type to its TypeScript equivalent
+ *
+ * @param spintaType - The type string from Spinta model metadata
+ * @returns TypeScript type as a string
+ */
+export declare function mapSpintaType(spintaType: string): string;
+/**
+ * Check if a Spinta type is required
+ */
+export declare function isRequired(spintaType: string): boolean;
+/**
+ * Convert a model path to a TypeScript interface name
+ * Adds namespace prefix to avoid collisions
+ *
+ * @example
+ * 'datasets/gov/ivpk/adk/Dataset' → 'GovIvpkAdk_Dataset'
+ */
+export declare function modelPathToInterfaceName(modelPath: string): string;
+/**
+ * Convert a property name to a safe TypeScript property name
+ * Handles special characters like @lt for language codes
+ */
+export declare function sanitizePropertyName(name: string): string;
+/**
+ * Generate JSDoc comment from title and description
+ */
+export declare function generateJsDoc(title?: string, description?: string): string;
+//# sourceMappingURL=typeMapper.d.ts.map

package/dist/cli/typeMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeMapper.d.ts","sourceRoot":"","sources":["../../src/cli/typeMapper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA0FxD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAiBlE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAwB1E"}

package/dist/cli/typeMapper.js

@@ -0,0 +1,150 @@
+/**
+ * Type mapper for converting Spinta types to TypeScript types
+ *
+ * Based on duomenu-tipai.rst.txt documentation
+ */
+/**
+ * Map a Spinta type to its TypeScript equivalent
+ *
+ * @param spintaType - The type string from Spinta model metadata
+ * @returns TypeScript type as a string
+ */
+export function mapSpintaType(spintaType) {
+    // Handle parameterized types like geometry(point, 4326)
+    const baseType = spintaType.split('(')[0]?.trim().toLowerCase() ?? '';
+    switch (baseType) {
+        // Numeric types
+        case 'integer':
+        case 'number':
+            return 'number';
+        // Text types
+        case 'string':
+        case 'text':
+            return 'string';
+        // Boolean
+        case 'boolean':
+            return 'boolean';
+        // Temporal types - return string since ISO 8601 format
+        case 'date':
+        case 'datetime':
+        case 'time':
+        case 'temporal':
+            return 'string';
+        // Geometry - WKT string format
+        case 'geometry':
+        case 'spatial':
+            return 'string';
+        // Reference - can be string ID or object depending on query
+        // Using union as per user feedback - runtime behavior varies
+        case 'ref':
+            return 'string | { _id: string }';
+        // Back reference (array of refs)
+        case 'backref':
+            return 'Array<string | { _id: string }>';
+        // Generic reference (polymorphic)
+        case 'generic':
+            return '{ object_model: string; object_id: string }';
+        // File types
+        case 'file':
+        case 'image':
+            return '{ _id: string; name: string; type: string; size?: number }';
+        // Binary data (base64 encoded)
+        case 'binary':
+            return 'string';
+        // URL/URI types
+        case 'url':
+        case 'uri':
+            return 'string';
+        // Money
+        case 'money':
+            return 'string | number';
+        // Composite types
+        case 'object':
+            return 'Record<string, unknown>';
+        case 'array':
+            return 'unknown[]';
+        // Required modifier - strip it
+        case 'required':
+            return 'unknown';
+        // Absent (deleted property)
+        case 'absent':
+            return 'never';
+        // Empty type
+        case '':
+            return 'unknown';
+        // Unknown type - fallback
+        default:
+            // Check if it's a required variant
+            if (spintaType.includes('required')) {
+                const cleanType = spintaType.replace(/\s*required\s*/i, '').trim();
+                return mapSpintaType(cleanType);
+            }
+            return 'unknown';
+    }
+}
+/**
+ * Check if a Spinta type is required
+ */
+export function isRequired(spintaType) {
+    return spintaType.toLowerCase().includes('required');
+}
+/**
+ * Convert a model path to a TypeScript interface name
+ * Adds namespace prefix to avoid collisions
+ *
+ * @example
+ * 'datasets/gov/ivpk/adk/Dataset' → 'GovIvpkAdk_Dataset'
+ */
+export function modelPathToInterfaceName(modelPath) {
+    const parts = modelPath.split('/');
+    const modelName = parts[parts.length - 1] ?? modelPath;
+    // Skip 'datasets' prefix if present
+    const namespaceParts = parts.slice(0, -1).filter((p) => p !== 'datasets');
+    if (namespaceParts.length === 0) {
+        return modelName;
+    }
+    // Capitalize first letter of each namespace part
+    const prefix = namespaceParts
+        .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
+        .join('');
+    return `${prefix}_${modelName}`;
+}
+/**
+ * Convert a property name to a safe TypeScript property name
+ * Handles special characters like @lt for language codes
+ */
+export function sanitizePropertyName(name) {
+    // Handle language suffix @lt, @en, etc.
+    if (name.includes('@')) {
+        const parts = name.split('@');
+        const baseName = parts[0] ?? '';
+        const lang = parts[1] ?? '';
+        return `${baseName}_${lang}`;
+    }
+    // Replace any invalid characters
+    return name.replace(/[^a-zA-Z0-9_]/g, '_');
+}
+/**
+ * Generate JSDoc comment from title and description
+ */
+export function generateJsDoc(title, description) {
+    if (title === undefined && description === undefined) {
+        return '';
+    }
+    const lines = ['/**'];
+    if (title !== undefined) {
+        lines.push(` * ${title}`);
+    }
+    if (description !== undefined) {
+        if (title !== undefined) {
+            lines.push(' *');
+        }
+        // Handle multi-line descriptions
+        for (const line of description.split('\n')) {
+            lines.push(` * ${line.trim()}`);
+        }
+    }
+    lines.push(' */');
+    return lines.join('\n');
+}
+//# sourceMappingURL=typeMapper.js.map

package/dist/cli/typeMapper.js.map

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

package/dist/client/SpintaClient.d.ts

@@ -0,0 +1,168 @@
+/**
+ * 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 type { ClientConfig, SpintaObject, SpintaResponse } from './types.js';
+import type { QueryBuilder } from '../builder/QueryBuilder.js';
+export declare class SpintaClient {
+    private readonly baseUrl;
+    private readonly tokenCache;
+    constructor(config?: ClientConfig);
+    /**
+     * Build headers for API requests
+     * Refreshes token if needed before each request
+     */
+    private getHeaders;
+    /**
+     * Make an HTTP request to the API
+     */
+    private request;
+    /**
+     * 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-...');
+     */
+    getOne<T>(model: string, id: string): Promise<T & SpintaObject>;
+    /**
+     * 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);
+     */
+    getAll<T>(model: string, query?: QueryBuilder<T>): Promise<(T & SpintaObject)[]>;
+    /**
+     * 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
+     */
+    getAllRaw<T>(model: string, query?: QueryBuilder<T>): Promise<SpintaResponse<T>>;
+    /**
+     * 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);
+     * }
+     */
+    stream<T>(model: string, query?: QueryBuilder<T>): AsyncGenerator<T & SpintaObject, void, 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);
+     */
+    count<T>(model: string, query?: QueryBuilder<T>): Promise<number>;
+    /**
+     * 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);
+     *   }
+     * }
+     */
+    listNamespace(namespace: string): Promise<NamespaceItem[]>;
+    /**
+     * 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}`);
+     * }
+     * ```
+     */
+    discoverModels(namespace: string): Promise<DiscoveredModel[]>;
+}
+/** Discovered model from namespace traversal */
+export interface DiscoveredModel {
+    /** Full model path (e.g., 'datasets/gov/rc/ar/savivaldybe/Savivaldybe') */
+    path: string;
+    /** Human-readable title from API metadata */
+    title?: string;
+    /** Parent namespace path */
+    namespace: string;
+}
+/** Namespace item type (transformed) */
+interface NamespaceItem {
+    _id: string;
+    _type: 'ns' | 'model';
+    title?: string;
+}
+export {};
+//# sourceMappingURL=SpintaClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SpintaClient.d.ts","sourceRoot":"","sources":["../../src/client/SpintaClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EAEf,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAY/D,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAEnC,MAAM,GAAE,YAAiB;IAgBrC;;;OAGG;YACW,UAAU;IAaxB;;OAEG;YACW,OAAO;IAarB;;;;;;;;;OASG;IACG,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,YAAY,CAAC;IAKrE;;;;;;;;;;;;;;;OAeG;IACG,MAAM,CAAC,CAAC,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,EAAE,CAAC;IAKhC;;;;;;;;OAQG;IACG,SAAS,CAAC,CAAC,EACf,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAM7B;;;;;;;;;;;;;;;;;;;;OAoBG;IACI,MAAM,CAAC,CAAC,EACb,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,cAAc,CAAC,CAAC,GAAG,YAAY,EAAE,IAAI,EAAE,SAAS,CAAC;IA0BpD;;;;;;;;;;OAUG;IACG,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAcvE;;;;;;;;;;;;;;;OAeG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAoBhE;;;;;;;;;;;;;;;;;;OAkBG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAuBpE;AAED,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAcD,wCAAwC;AACxC,UAAU,aAAa;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}