trilium-api 1.0.1 → 1.0.2

package/src/demo-mapper.ts

@@ -1,166 +0,0 @@
-/**
- * Demo script for the Note Mapper
- *
- * This demonstrates how to use TriliumMapper to map Trilium notes
- * to strongly-typed objects.
- *
- * Usage:
- *   pnpm tsx src/demo-mapper.ts
- *
- * With a real Trilium instance:
- *   TRILIUM_API_KEY=your-token pnpm tsx src/demo-mapper.ts
- */
-
-import { TriliumMapper, transforms, type TriliumNote } from './client.js';
-
-console.log('Note Mapper Demo');
-console.log('='.repeat(50));
-console.log();
-
-// Define a sample blog post type
-interface BlogPost {
-  id: string;
-  title: string;
-  slug: string;
-  status: 'draft' | 'published' | 'archived';
-  wordCount: number;
-  tags: string[];
-  publishedAt: Date | null;
-  readTimeMinutes: number;
-}
-
-// Create a mapper configuration
-const blogMapper = new TriliumMapper<BlogPost>({
-  // Simple property mapping
-  id: 'note.noteId',
-  title: 'note.title',
-
-  // Required label
-  slug: { from: '#slug', required: true },
-
-  // Label with default value
-  status: { from: '#status', default: 'draft' },
-
-  // Label with transform
-  wordCount: { from: '#wordCount', transform: transforms.number, default: 0 },
-
-  // Label with array transform
-  tags: { from: '#tags', transform: transforms.commaSeparated, default: [] },
-
-  // Label with date transform
-  publishedAt: { from: '#publishedAt', transform: transforms.date, default: null },
-
-  // Computed value based on other fields
-  readTimeMinutes: {
-    computed: (partial) => Math.ceil((partial.wordCount || 0) / 200),
-  },
-});
-
-// Create sample Trilium notes (simulating API response)
-const sampleNotes: TriliumNote[] = [
-  {
-    noteId: 'note1',
-    title: 'Getting Started with TypeScript',
-    type: 'text',
-    mime: 'text/html',
-    isProtected: false,
-    blobId: 'blob1',
-    dateCreated: '2024-01-15T10:00:00.000Z',
-    dateModified: '2024-01-20T15:30:00.000Z',
-    utcDateCreated: '2024-01-15T10:00:00.000Z',
-    utcDateModified: '2024-01-20T15:30:00.000Z',
-    attributes: [
-      { attributeId: 'attr1', noteId: 'note1', type: 'label', name: 'slug', value: 'getting-started-typescript', isInheritable: false },
-      { attributeId: 'attr2', noteId: 'note1', type: 'label', name: 'status', value: 'published', isInheritable: false },
-      { attributeId: 'attr3', noteId: 'note1', type: 'label', name: 'wordCount', value: '1500', isInheritable: false },
-      { attributeId: 'attr4', noteId: 'note1', type: 'label', name: 'tags', value: 'typescript,programming,tutorial', isInheritable: false },
-      { attributeId: 'attr5', noteId: 'note1', type: 'label', name: 'publishedAt', value: '2024-01-20', isInheritable: false },
-    ],
-  },
-  {
-    noteId: 'note2',
-    title: 'Advanced Patterns in Node.js',
-    type: 'text',
-    mime: 'text/html',
-    isProtected: false,
-    blobId: 'blob2',
-    dateCreated: '2024-02-01T09:00:00.000Z',
-    dateModified: '2024-02-05T14:00:00.000Z',
-    utcDateCreated: '2024-02-01T09:00:00.000Z',
-    utcDateModified: '2024-02-05T14:00:00.000Z',
-    attributes: [
-      { attributeId: 'attr6', noteId: 'note2', type: 'label', name: 'slug', value: 'advanced-nodejs-patterns', isInheritable: false },
-      { attributeId: 'attr7', noteId: 'note2', type: 'label', name: 'status', value: 'draft', isInheritable: false },
-      { attributeId: 'attr8', noteId: 'note2', type: 'label', name: 'wordCount', value: '2400', isInheritable: false },
-      { attributeId: 'attr9', noteId: 'note2', type: 'label', name: 'tags', value: 'nodejs,javascript,backend', isInheritable: false },
-    ],
-  },
-  {
-    noteId: 'note3',
-    title: 'Quick Tips for VS Code',
-    type: 'text',
-    mime: 'text/html',
-    isProtected: false,
-    blobId: 'blob3',
-    dateCreated: '2024-03-01T11:00:00.000Z',
-    dateModified: '2024-03-01T11:30:00.000Z',
-    utcDateCreated: '2024-03-01T11:00:00.000Z',
-    utcDateModified: '2024-03-01T11:30:00.000Z',
-    attributes: [
-      { attributeId: 'attr10', noteId: 'note3', type: 'label', name: 'slug', value: 'vscode-tips', isInheritable: false },
-      // No status - will use default 'draft'
-      // No wordCount - will use default 0
-      // No tags - will use default []
-    ],
-  },
-];
-
-console.log('Mapper Configuration:');
-console.log('-'.repeat(50));
-console.log(`
-const blogMapper = new TriliumMapper<BlogPost>({
-  id: 'note.noteId',
-  title: 'note.title',
-  slug: { from: '#slug', required: true },
-  status: { from: '#status', default: 'draft' },
-  wordCount: { from: '#wordCount', transform: transforms.number, default: 0 },
-  tags: { from: '#tags', transform: transforms.commaSeparated, default: [] },
-  publishedAt: { from: '#publishedAt', transform: transforms.date, default: null },
-  readTimeMinutes: {
-    computed: (partial) => Math.ceil((partial.wordCount || 0) / 200),
-  },
-});
-`);
-
-console.log('Mapping Results:');
-console.log('-'.repeat(50));
-
-// Map all notes
-const blogPosts = blogMapper.map(sampleNotes);
-
-for (const post of blogPosts) {
-  console.log();
-  console.log(`Title: ${post.title}`);
-  console.log(`  ID: ${post.id}`);
-  console.log(`  Slug: ${post.slug}`);
-  console.log(`  Status: ${post.status}`);
-  console.log(`  Word Count: ${post.wordCount}`);
-  console.log(`  Tags: [${post.tags.join(', ')}]`);
-  console.log(`  Published: ${post.publishedAt?.toISOString() || 'Not published'}`);
-  console.log(`  Read Time: ${post.readTimeMinutes} min`);
-}
-
-console.log();
-console.log('='.repeat(50));
-console.log();
-
-// Demonstrate single note mapping
-console.log('Single Note Mapping:');
-console.log('-'.repeat(50));
-console.log('const singlePost = blogMapper.map(notes[0]);');
-const singlePost = blogMapper.map(sampleNotes[0]!);
-console.log('Result:', JSON.stringify(singlePost, null, 2));
-console.log();
-
-console.log('='.repeat(50));
-console.log('Demo completed!');

package/src/demo-search.ts

@@ -1,108 +0,0 @@
-/**
- * Demo script for the Search Query Builder
- *
- * This demonstrates how to use buildSearchQuery to construct
- * type-safe Trilium search queries.
- *
- * Usage:
- *   pnpm tsx src/demo-search.ts
- */
-
-import { buildSearchQuery } from './mapper.js';
-
-console.log('Search Query Builder Demo');
-console.log('='.repeat(50));
-console.log();
-
-// Simple label search
-console.log('1. Simple label search:');
-console.log('   Code: buildSearchQuery({ "#blog": true })');
-console.log('   Result:', buildSearchQuery({ '#blog': true }));
-console.log();
-
-// Label with value
-console.log('2. Label with value:');
-console.log('   Code: buildSearchQuery({ "#status": "published" })');
-console.log('   Result:', buildSearchQuery({ '#status': 'published' }));
-console.log();
-
-// Label absence check
-console.log('3. Label absence check:');
-console.log('   Code: buildSearchQuery({ "#draft": false })');
-console.log('   Result:', buildSearchQuery({ '#draft': false }));
-console.log();
-
-// Comparison operators
-console.log('4. Comparison operators:');
-console.log('   Code: buildSearchQuery({ "#wordCount": { value: 1000, operator: ">=" } })');
-console.log('   Result:', buildSearchQuery({ '#wordCount': { value: 1000, operator: '>=' } }));
-console.log();
-
-// Note properties
-console.log('5. Note properties:');
-console.log('   Code: buildSearchQuery({ "note.type": "text", title: { value: "Blog", operator: "*=" } })');
-console.log(
-  '   Result:',
-  buildSearchQuery({ 'note.type': 'text', title: { value: 'Blog', operator: '*=' } })
-);
-console.log();
-
-// Relations
-console.log('6. Relations:');
-console.log('   Code: buildSearchQuery({ "~author": "John" })');
-console.log('   Result:', buildSearchQuery({ '~author': 'John' }));
-console.log();
-
-// AND conditions
-console.log('7. AND conditions:');
-console.log('   Code: buildSearchQuery({ AND: [{ "#blog": true }, { "#published": true }] })');
-console.log('   Result:', buildSearchQuery({ AND: [{ '#blog': true }, { '#published': true }] }));
-console.log();
-
-// OR conditions
-console.log('8. OR conditions:');
-console.log('   Code: buildSearchQuery({ OR: [{ "#status": "published" }, { "#status": "featured" }] })');
-console.log(
-  '   Result:',
-  buildSearchQuery({ OR: [{ '#status': 'published' }, { '#status': 'featured' }] })
-);
-console.log();
-
-// Complex nested conditions
-console.log('9. Complex nested conditions:');
-const complexQuery = {
-  AND: [
-    { '#blog': true },
-    {
-      OR: [{ '#status': 'published' }, { '#status': 'featured' }],
-    },
-    { '#wordCount': { value: 500, operator: '>=' as const } },
-  ],
-};
-console.log('   Code: buildSearchQuery({');
-console.log('     AND: [');
-console.log('       { "#blog": true },');
-console.log('       { OR: [{ "#status": "published" }, { "#status": "featured" }] },');
-console.log('       { "#wordCount": { value: 500, operator: ">=" } }');
-console.log('     ]');
-console.log('   })');
-console.log('   Result:', buildSearchQuery(complexQuery));
-console.log();
-
-// NOT conditions
-console.log('10. NOT conditions:');
-console.log('   Code: buildSearchQuery({ NOT: { "#archived": true } })');
-console.log('   Result:', buildSearchQuery({ NOT: { '#archived': true } }));
-console.log();
-
-// Multiple conditions (implicit AND)
-console.log('11. Multiple conditions (implicit AND):');
-console.log('   Code: buildSearchQuery({ "#blog": true, "#published": true, "note.type": "text" })');
-console.log(
-  '   Result:',
-  buildSearchQuery({ '#blog': true, '#published': true, 'note.type': 'text' })
-);
-console.log();
-
-console.log('='.repeat(50));
-console.log('Demo completed!');

package/src/demo.ts

@@ -1,126 +0,0 @@
-/**
- * Demo script to test connecting to a local Trilium instance
- *
- * Usage:
- *   pnpm tsx src/demo.ts
- *
- * Make sure to set your ETAPI token below or via environment variable:
- *   TRILIUM_API_KEY=your-token pnpm tsx src/demo.ts
- */
-
-import { createTriliumClient, type TriliumNote } from './client.js';
-
-const TRILIUM_URL = process.env.TRILIUM_URL || 'http://localhost:8080';
-const TRILIUM_API_KEY = process.env.TRILIUM_API_KEY || 'YOUR_ETAPI_TOKEN_HERE';
-const MAX_DEPTH = parseInt(process.env.MAX_DEPTH || '3', 10);
-
-type Client = ReturnType<typeof createTriliumClient>;
-
-async function printNoteTree(
-    client: Client,
-    noteId: string,
-    depth: number = 0,
-    prefix: string = '',
-    isLast: boolean = true
-): Promise<void> {
-    if (depth > MAX_DEPTH) {
-        console.log(`${prefix}${isLast ? '└── ' : '├── '}...`);
-        return;
-    }
-
-    const { data: note, error } = await client.GET('/notes/{noteId}', {
-        params: { path: { noteId } },
-    });
-
-    if (error || !note) {
-        console.log(`${prefix}${isLast ? '└── ' : '├── '}[Error fetching note]`);
-        return;
-    }
-
-    const icon = getTypeIcon(note.type);
-    const connector = depth === 0 ? '' : isLast ? '└── ' : '├── ';
-    console.log(`${prefix}${connector}${icon} ${note.title || '(untitled)'}`);
-
-    const childIds = note.childNoteIds || [];
-    if (childIds.length === 0) return;
-
-    const newPrefix = depth === 0 ? '' : prefix + (isLast ? '    ' : '│   ');
-
-    for (let i = 0; i < childIds.length; i++) {
-        const childId = childIds[i];
-        if (!childId) continue;
-        const isLastChild = i === childIds.length - 1;
-        await printNoteTree(client, childId, depth + 1, newPrefix, isLastChild);
-    }
-}
-
-function getTypeIcon(type: TriliumNote['type']): string {
-    switch (type) {
-        case 'text':
-            return '📄';
-        case 'code':
-            return '💻';
-        case 'image':
-            return '🖼️';
-        case 'search':
-            return '🔍';
-        case 'book':
-            return '📚';
-        case 'noteMap':
-            return '🗺️';
-        case 'mermaid':
-            return '📊';
-        case 'webView':
-            return '🌐';
-        case 'launcher':
-            return '🚀';
-        case 'doc':
-            return '📝';
-        case 'contentWidget':
-            return '🧩';
-        case 'relationMap':
-            return '🔗';
-        case 'render':
-            return '⚡';
-        case 'file':
-            return '📎';
-        default:
-            return '📁';
-    }
-}
-
-async function main() {
-    console.log('🔌 Connecting to Trilium at:', TRILIUM_URL);
-    console.log();
-
-    const client = createTriliumClient({
-        baseUrl: TRILIUM_URL,
-        apiKey: TRILIUM_API_KEY,
-    });
-
-    // Get app info
-    const { data: appInfo, error: appError } = await client.GET('/app-info');
-
-    if (appError) {
-        console.error('❌ Failed to connect:', appError);
-        console.error('\nMake sure:');
-        console.error('  1. Trilium is running at', TRILIUM_URL);
-        console.error('  2. Your ETAPI token is correct');
-        console.error('  3. ETAPI is enabled in Trilium settings');
-        process.exit(1);
-    }
-
-    console.log('✅ Connected to Trilium', appInfo?.appVersion);
-    console.log();
-
-    // Print tree view
-    console.log(`📂 Note Tree (max depth: ${MAX_DEPTH}):`);
-    console.log('─'.repeat(40));
-    await printNoteTree(client, 'root');
-    console.log('─'.repeat(40));
-
-    console.log();
-    console.log('🎉 Done! Set MAX_DEPTH env var to see more levels.');
-}
-
-main().catch(console.error);

package/src/index.ts

@@ -1,35 +0,0 @@
-// Main exports for the Trilium API client
-export { 
-  createTriliumClient, 
-  default as createClient,
-  // Mapper utilities
-  TriliumMapper,
-  buildSearchQuery,
-  transforms,
-} from './client.js';
-
-// Re-export types
-export type {
-  TriliumNote,
-  TriliumBranch,
-  TriliumAttribute,
-  TriliumAttachment,
-  TriliumAppInfo,
-  TriliumClientConfig,
-  paths,
-  components,
-  // Mapper types
-  MappingConfig,
-  FieldMapping,
-  TransformFunction,
-  ComputedFunction,
-  TriliumSearchHelpers,
-  TriliumSearchConditions,
-  TriliumSearchLogical,
-  ComparisonOperator,
-  ConditionValue,
-  SearchValue,
-} from './client.js';
-
-// Re-export generated types for advanced usage
-export type { operations } from './generated/trilium.js';