@trokky/client 2.0.3

package/dist/cache/manager.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Cache Manager
+ * Simple in-memory cache with TTL support
+ */
+export declare class CacheManager {
+    private defaultMaxAge;
+    private cache;
+    private cleanupInterval;
+    constructor(defaultMaxAge?: number);
+    /**
+     * Get cached data
+     */
+    get<T>(key: string): T | null;
+    /**
+     * Set cached data with optional TTL
+     */
+    set<T>(key: string, data: T, maxAge?: number): void;
+    /**
+     * Delete cached data
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all cached data
+     */
+    clear(): void;
+    /**
+     * Check if key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Get cache size
+     */
+    size(): number;
+    /**
+     * Generate cache key for API requests
+     */
+    generateKey(endpoint: string, params?: any): string;
+    /**
+     * Remove expired entries
+     */
+    private cleanup;
+    /**
+     * Destroy cache manager and cleanup interval
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/cache/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/cache/manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,qBAAa,YAAY;IAIX,OAAO,CAAC,aAAa;IAHjC,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,eAAe,CAA8B;gBAEjC,aAAa,GAAE,MAAe;IAOlD;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAa7B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAUnD;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,MAAM;IAcnD;;OAEG;IACH,OAAO,CAAC,OAAO;IAUf;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB"}

package/dist/cache/manager.js

@@ -0,0 +1,100 @@
+/**
+ * Cache Manager
+ * Simple in-memory cache with TTL support
+ */
+export class CacheManager {
+    constructor(defaultMaxAge = 300000) {
+        this.defaultMaxAge = defaultMaxAge;
+        this.cache = new Map();
+        this.cleanupInterval = null;
+        // Start cleanup every minute
+        this.cleanupInterval = setInterval(() => {
+            this.cleanup();
+        }, 60000);
+    }
+    /**
+     * Get cached data
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return null;
+        // Check if expired
+        if (Date.now() - entry.timestamp > entry.maxAge) {
+            this.cache.delete(key);
+            return null;
+        }
+        return entry.data;
+    }
+    /**
+     * Set cached data with optional TTL
+     */
+    set(key, data, maxAge) {
+        const entry = {
+            data,
+            timestamp: Date.now(),
+            maxAge: maxAge || this.defaultMaxAge
+        };
+        this.cache.set(key, entry);
+    }
+    /**
+     * Delete cached data
+     */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /**
+     * Clear all cached data
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Check if key exists and is not expired
+     */
+    has(key) {
+        return this.get(key) !== null;
+    }
+    /**
+     * Get cache size
+     */
+    size() {
+        return this.cache.size;
+    }
+    /**
+     * Generate cache key for API requests
+     */
+    generateKey(endpoint, params) {
+        const base = endpoint.replace(/^\/+|\/+$/g, ''); // Remove leading/trailing slashes
+        if (!params)
+            return base;
+        // Sort params for consistent keys
+        const sortedParams = Object.keys(params)
+            .sort()
+            .map(key => `${key}=${JSON.stringify(params[key])}`)
+            .join('&');
+        return `${base}?${sortedParams}`;
+    }
+    /**
+     * Remove expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        for (const [key, entry] of this.cache.entries()) {
+            if (now - entry.timestamp > entry.maxAge) {
+                this.cache.delete(key);
+            }
+        }
+    }
+    /**
+     * Destroy cache manager and cleanup interval
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        this.clear();
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/cache/manager.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Trokky Client CLI
+ * Command-line tool for generating types and test data
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/cli/index.js

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+/**
+ * Trokky Client CLI
+ * Command-line tool for generating types and test data
+ */
+import { program } from 'commander';
+import { TypeGenerator, generateTypesFromPath } from '../generator/index.js';
+import { DocumentGenerator } from '../generator/document-generator.js';
+// Types command
+program
+    .command('generate-types')
+    .description('Generate TypeScript types from Trokky schemas')
+    .option('-p, --schema-path <path>', 'Local path to schemas directory (e.g., ../cms/schemas)')
+    .option('-u, --schema-url <url>', 'Schema URL to fetch from (alternative to --schema-path)')
+    .option('-o, --output-dir <dir>', 'Output directory for generated types', './src/types/trokky')
+    .option('-n, --namespace <name>', 'TypeScript namespace', 'Trokky')
+    .option('-e, --extension <ext>', 'File extension (ts|d.ts)', 'ts')
+    .option('--no-validation', 'Skip validation schema generation')
+    .option('-t, --auth-token <token>', 'Authentication token (for --schema-url)')
+    .option('--username <username>', 'Username for authentication (for --schema-url)')
+    .option('--password <password>', 'Password for authentication (for --schema-url)')
+    .action(async (options) => {
+    try {
+        // Prefer local schema path over URL
+        if (options.schemaPath) {
+            console.log(`Reading schemas from: ${options.schemaPath}`);
+            await generateTypesFromPath({
+                schemaPath: options.schemaPath,
+                outputDir: options.outputDir,
+                namespace: options.namespace,
+                fileExtension: options.extension,
+                includeValidation: options.validation
+            });
+        }
+        else if (options.schemaUrl) {
+            console.log(`Fetching schemas from: ${options.schemaUrl}`);
+            const generatorOptions = {
+                schemaUrl: options.schemaUrl,
+                outputDir: options.outputDir,
+                namespace: options.namespace,
+                fileExtension: options.extension,
+                includeValidation: options.validation,
+                authToken: options.authToken,
+                username: options.username,
+                password: options.password
+            };
+            const generator = new TypeGenerator(generatorOptions);
+            await generator.generateFromUrl();
+        }
+        else {
+            console.error('Error: Please provide either --schema-path or --schema-url');
+            console.log('\nExamples:');
+            console.log('  npx trokky-client generate-types --schema-path ../cms/schemas -o ./src/types/cms');
+            console.log('  npx trokky-client generate-types --schema-url http://localhost:3000/api/collections -o ./src/types/cms');
+            process.exit(1);
+        }
+        console.log('TypeScript types generated successfully!');
+        console.log(`Output: ${options.outputDir}`);
+    }
+    catch (error) {
+        console.error('Failed to generate types:', error);
+        process.exit(1);
+    }
+});
+// Documents command
+program
+    .command('generate-documents')
+    .description('Generate test documents with faker.js')
+    .option('-u, --schema-url <url>', 'Schema URL to fetch from')
+    .option('-o, --output-dir <dir>', 'Output directory for generated documents', './generated')
+    .option('-c, --count <number>', 'Number of documents per schema', '10')
+    .option('-l, --locale <locale>', 'Faker locale', 'en')
+    .option('-s, --seed <number>', 'Random seed for consistent generation')
+    .option('-f, --format <format>', 'Output format (json|typescript|both)', 'json')
+    .option('--no-references', 'Skip reference field generation')
+    .action(async (options) => {
+    try {
+        const generatorOptions = {
+            schemaUrl: options.schemaUrl,
+            outputDir: options.outputDir,
+            count: parseInt(options.count),
+            locale: options.locale,
+            seed: options.seed ? parseInt(options.seed) : undefined,
+            format: options.format,
+            generateReferences: options.references
+        };
+        const generator = new DocumentGenerator(generatorOptions);
+        const documents = await generator.generateFromUrl();
+        console.log('✅ Test documents generated successfully!');
+        console.log(`📊 Generated collections:`);
+        for (const [collection, docs] of Object.entries(documents)) {
+            console.log(`   • ${collection}: ${docs.length} documents`);
+        }
+    }
+    catch (error) {
+        console.error('❌ Failed to generate documents:', error);
+        process.exit(1);
+    }
+});
+// Combined command
+program
+    .command('generate-all')
+    .description('Generate both types and test documents')
+    .option('-u, --schema-url <url>', 'Schema URL to fetch from')
+    .option('--types-dir <dir>', 'Types output directory', './src/types/trokky')
+    .option('--docs-dir <dir>', 'Documents output directory', './generated')
+    .option('-c, --count <number>', 'Number of documents per schema', '10')
+    .option('-l, --locale <locale>', 'Faker locale', 'en')
+    .option('-s, --seed <number>', 'Random seed for consistent generation')
+    .action(async (options) => {
+    try {
+        console.log('🚀 Generating TypeScript types...');
+        // Generate types
+        const typeGenerator = new TypeGenerator({
+            schemaUrl: options.schemaUrl,
+            outputDir: options.typesDir,
+            namespace: 'Trokky',
+            fileExtension: 'ts',
+            includeValidation: true
+        });
+        await typeGenerator.generateFromUrl();
+        console.log('✅ Types generated!');
+        console.log('🚀 Generating test documents...');
+        // Generate documents
+        const docGenerator = new DocumentGenerator({
+            schemaUrl: options.schemaUrl,
+            outputDir: options.docsDir,
+            count: parseInt(options.count),
+            locale: options.locale,
+            seed: options.seed ? parseInt(options.seed) : undefined,
+            format: 'both',
+            generateReferences: true
+        });
+        const documents = await docGenerator.generateFromUrl();
+        console.log('✅ Everything generated successfully!');
+        console.log('\n📋 Summary:');
+        console.log(`   📁 Types: ${options.typesDir}`);
+        console.log(`   📁 Documents: ${options.docsDir}`);
+        console.log(`   📊 Collections: ${Object.keys(documents).length}`);
+        for (const [collection, docs] of Object.entries(documents)) {
+            console.log(`      • ${collection}: ${docs.length} documents`);
+        }
+    }
+    catch (error) {
+        console.error('❌ Failed to generate:', error);
+        process.exit(1);
+    }
+});
+// Version and help
+program
+    .version('0.1.0')
+    .description('Trokky Client CLI - Generate types and test data from schemas');
+// Parse arguments
+program.parse();
+// Show help if no command provided
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}
+//# 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/client.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Main Trokky Client
+ * High-level client that orchestrates all SDK functionality
+ */
+import { HttpClient } from './http/client.js';
+import { CacheManager } from './cache/manager.js';
+import { DocumentClient } from './document/client.js';
+import { MediaHelper } from './media/helper.js';
+import { ShortcodeResolver } from './shortcodes/resolver.js';
+import { QueryBuilder, SingletonBuilder } from './query/builder.js';
+import { ImageUrlBuilder } from './media/url-builder.js';
+import type { ClientConfig, AuthConfig, AuthTokens, QueryOptions, DocumentResult, CollectionResult, MediaResult, BaseDocument, MediaFieldValue } from './types/index.js';
+export declare class TrokkyClient {
+    readonly http: HttpClient;
+    readonly cache: CacheManager;
+    readonly documents: DocumentClient;
+    readonly media: MediaHelper;
+    readonly shortcodes: ShortcodeResolver;
+    constructor(config: ClientConfig);
+    /**
+     * Authenticate with username and password
+     */
+    authenticate(credentials: AuthConfig): Promise<AuthTokens>;
+    /**
+     * Refresh authentication token
+     */
+    refreshAuth(): Promise<AuthTokens>;
+    /**
+     * Logout and clear tokens
+     */
+    logout(): Promise<void>;
+    /**
+     * Check if client is authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Get current authentication tokens
+     */
+    getTokens(): AuthTokens | null;
+    /**
+     * Set authentication tokens
+     */
+    setTokens(tokens: AuthTokens): void;
+    /**
+     * Set API token for authentication (alternative to JWT)
+     */
+    setApiToken(token: string): void;
+    /**
+     * Get current API token
+     */
+    getApiToken(): string | null;
+    /**
+     * Clear API token
+     */
+    clearApiToken(): void;
+    /**
+     * Get document by ID
+     */
+    getDocument<T extends BaseDocument>(type: string, id: string, useCache?: boolean): Promise<DocumentResult<T>>;
+    /**
+     * Query documents
+     */
+    queryDocuments<T extends BaseDocument>(type: string, options?: QueryOptions, useCache?: boolean): Promise<CollectionResult<T>>;
+    /**
+     * Create new document
+     */
+    createDocument<T extends BaseDocument>(type: string, data: Omit<T, '_id' | '_type' | '_createdAt' | '_updatedAt' | '_version'>): Promise<DocumentResult<T>>;
+    /**
+     * Update document
+     */
+    updateDocument<T extends BaseDocument>(type: string, id: string, data: Partial<Omit<T, '_id' | '_type' | '_createdAt' | '_updatedAt' | '_version'>>): Promise<DocumentResult<T>>;
+    /**
+     * Replace document
+     */
+    replaceDocument<T extends BaseDocument>(type: string, id: string, data: Omit<T, '_id' | '_type' | '_createdAt' | '_updatedAt' | '_version'>): Promise<DocumentResult<T>>;
+    /**
+     * Delete document
+     */
+    deleteDocument(type: string, id: string): Promise<void>;
+    /**
+     * Search documents
+     */
+    searchDocuments<T extends BaseDocument>(type: string, searchTerm: string, fields?: string[], options?: Omit<QueryOptions, 'filter'>): Promise<CollectionResult<T>>;
+    /**
+     * Count documents
+     */
+    countDocuments(type: string, filter?: Record<string, any>): Promise<number>;
+    /**
+     * Check if document exists
+     */
+    documentExists(type: string, id: string): Promise<boolean>;
+    /**
+     * Upload file
+     */
+    uploadFile(file: File | Buffer, filename?: string): Promise<MediaResult>;
+    /**
+     * Get media by ID
+     */
+    getMedia(id: string): Promise<MediaResult>;
+    /**
+     * Delete media
+     */
+    deleteMedia(id: string): Promise<void>;
+    /**
+     * List API tokens
+     */
+    listApiTokens(): Promise<any>;
+    /**
+     * Create API token
+     */
+    createApiToken(data: any): Promise<any>;
+    /**
+     * Get API token by ID
+     */
+    getApiTokenById(id: string): Promise<any>;
+    /**
+     * Update API token
+     */
+    updateApiToken(id: string, data: any): Promise<any>;
+    /**
+     * Delete API token
+     */
+    deleteApiToken(id: string): Promise<void>;
+    /**
+     * Resolve shortcodes in content to HTML
+     * Converts environment-agnostic shortcodes to actual HTML for display
+     */
+    resolveContent(content: string): string;
+    /**
+     * Check if content contains shortcodes
+     */
+    hasShortcodes(content: string): boolean;
+    /**
+     * Extract media dependencies from content
+     * Useful for preloading or understanding content requirements
+     */
+    extractContentMedia(content: string): import("./index.js").TrokkyImageShortcode[];
+    /**
+     * Preload all media in content for faster rendering
+     */
+    preloadContentMedia(content: string): Promise<void>;
+    /**
+     * Test API connection
+     */
+    ping(): Promise<{
+        status: string;
+        timestamp: string;
+    }>;
+    /**
+     * Get API health status
+     */
+    health(): Promise<{
+        status: string;
+        services: Record<string, string>;
+    }>;
+    /**
+     * Clear client cache
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+    };
+    /**
+     * Destroy client and cleanup resources
+     */
+    destroy(): void;
+    /**
+     * Start a fluent query for a collection type
+     *
+     * @example
+     * ```typescript
+     * const articles = await client
+     *   .from('article')
+     *   .published()
+     *   .expand('category')
+     *   .sort({ _createdAt: 'desc' })
+     *   .limit(10)
+     *   .fetch()
+     * ```
+     */
+    from<T extends BaseDocument = BaseDocument>(type: string): QueryBuilder<T>;
+    /**
+     * Fetch a singleton document (e.g., homepage, settings)
+     *
+     * @example
+     * ```typescript
+     * const homepage = await client.singleton('homepage').fetch()
+     * const settings = await client.singleton('settings', 'site-settings').fetch()
+     * ```
+     */
+    singleton<T extends BaseDocument = BaseDocument>(type: string, id?: string): SingletonBuilder<T>;
+    /**
+     * Create an image URL builder for a media field
+     *
+     * @example
+     * ```typescript
+     * const url = client.imageUrl(article.featuredImage)
+     *   .width(800)
+     *   .height(400)
+     *   .format('webp')
+     *   .url()
+     * ```
+     */
+    imageUrl(source: MediaFieldValue | string | null | undefined): ImageUrlBuilder;
+    /**
+     * Create a reusable image URL builder factory
+     *
+     * @example
+     * ```typescript
+     * const urlFor = client.createImageUrlBuilder()
+     * const url = urlFor(article.image).width(800).url()
+     * ```
+     */
+    createImageUrlBuilder(options?: {
+        proxyPath?: string;
+    }): (source: MediaFieldValue | string | null | undefined) => ImageUrlBuilder;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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