tunecamp 1.0.0

package/dist/tools/generate-sea-pair.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * Tunecamp SEA Pair Generator
+ * Generates a GunDB SEA (Secure Encryption Algorithm) key pair for authentication
+ *
+ * Usage:
+ *   npx ts-node src/tools/generate-sea-pair.ts [options]
+ *
+ * Examples:
+ *   npx ts-node src/tools/generate-sea-pair.ts
+ *   npx ts-node src/tools/generate-sea-pair.ts --output ./gundb-keypair.json
+ */
+export {};
+//# sourceMappingURL=generate-sea-pair.d.ts.map

package/dist/tools/generate-sea-pair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-sea-pair.d.ts","sourceRoot":"","sources":["../../src/tools/generate-sea-pair.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG"}

package/dist/tools/generate-sea-pair.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+/**
+ * Tunecamp SEA Pair Generator
+ * Generates a GunDB SEA (Secure Encryption Algorithm) key pair for authentication
+ *
+ * Usage:
+ *   npx ts-node src/tools/generate-sea-pair.ts [options]
+ *
+ * Examples:
+ *   npx ts-node src/tools/generate-sea-pair.ts
+ *   npx ts-node src/tools/generate-sea-pair.ts --output ./gundb-keypair.json
+ */
+import Gun from 'gun';
+import SEA from 'gun/sea.js';
+import fs from 'fs';
+import path from 'path';
+const DEFAULT_OUTPUT_FILE = './gundb-keypair.json';
+/**
+ * Generate SEA key pair
+ */
+async function generateSEAPair() {
+    // Initialize Gun to get SEA
+    const gun = Gun();
+    // Wait for SEA to be ready
+    await new Promise(resolve => setTimeout(resolve, 500));
+    // Generate pair
+    return new Promise((resolve, reject) => {
+        SEA.pair((data) => {
+            if (!data || !data.pub || !data.priv || !data.epub || !data.epriv) {
+                reject(new Error('Failed to generate SEA pair'));
+                return;
+            }
+            resolve(data);
+        });
+    });
+}
+/**
+ * Main CLI
+ */
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log(`
+Tunecamp SEA Pair Generator
+
+Generates a GunDB SEA (Secure Encryption Algorithm) key pair for secure authentication.
+This pair allows you to write to your private GunDB space instead of public space.
+
+Usage:
+  npx ts-node src/tools/generate-sea-pair.ts [options]
+
+Options:
+  --output <file>   Output file path (default: ./gundb-keypair.json)
+  --help, -h        Show this help message
+
+Examples:
+  npx ts-node src/tools/generate-sea-pair.ts
+  npx ts-node src/tools/generate-sea-pair.ts --output ./my-keypair.json
+
+Security Notes:
+  - Keep this file secure and never commit it to version control
+  - Add gundb-keypair.json to your .gitignore
+  - This pair gives full access to your private GunDB space
+  - If compromised, generate a new pair and update your configuration
+`);
+        process.exit(0);
+    }
+    const outputIndex = args.indexOf('--output');
+    const outputFile = outputIndex >= 0 && args[outputIndex + 1]
+        ? args[outputIndex + 1]
+        : DEFAULT_OUTPUT_FILE;
+    try {
+        console.log('\n🔑 Tunecamp SEA Pair Generator');
+        console.log('================================\n');
+        console.log('Generating SEA key pair...');
+        const pair = await generateSEAPair();
+        // Create output object with metadata
+        const output = {
+            generated: new Date().toISOString(),
+            pub: pair.pub,
+            priv: pair.priv,
+            epub: pair.epub,
+            epriv: pair.epriv,
+            note: 'Keep this file secure! Never commit it to version control.',
+        };
+        // Ensure directory exists
+        const outputDir = path.dirname(outputFile);
+        if (outputDir !== '.' && !fs.existsSync(outputDir)) {
+            fs.mkdirSync(outputDir, { recursive: true });
+        }
+        // Write to file
+        fs.writeFileSync(outputFile, JSON.stringify(output, null, 2));
+        console.log(`\n✅ SEA pair generated successfully!`);
+        console.log(`\n📁 Saved to: ${path.resolve(outputFile)}`);
+        console.log(`\n📋 Public Key (pub): ${pair.pub.substring(0, 20)}...`);
+        console.log(`\n⚠️  Security Reminders:`);
+        console.log(`   - Add ${path.basename(outputFile)} to your .gitignore`);
+        console.log(`   - Keep this file secure and private`);
+        console.log(`   - Use this pair with generate-codes.ts for private code storage`);
+        console.log(`\n💡 Next steps:`);
+        console.log(`   Use this pair with generate-codes.ts:`);
+        console.log(`   npx ts-node src/tools/generate-codes.ts <release-slug> --keypair ${outputFile}`);
+        process.exit(0);
+    }
+    catch (error) {
+        console.error('\n❌ Error generating SEA pair:', error.message);
+        process.exit(1);
+    }
+}
+main().catch(console.error);
+//# sourceMappingURL=generate-sea-pair.js.map

package/dist/tools/generate-sea-pair.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Type definitions for Tunecamp
+ */
+export interface CatalogConfig {
+    title: string;
+    description?: string;
+    url?: string;
+    basePath?: string;
+    theme?: string;
+    language?: string;
+    headerImage?: string;
+    customFont?: string;
+    customCSS?: string;
+    labelMode?: boolean;
+    podcast?: PodcastConfig;
+    metadata?: Record<string, any>;
+}
+export interface PodcastConfig {
+    enabled?: boolean;
+    title?: string;
+    description?: string;
+    author?: string;
+    email?: string;
+    category?: string;
+    image?: string;
+    explicit?: boolean;
+}
+export interface ArtistConfig {
+    name: string;
+    bio?: string;
+    photo?: string;
+    links?: ArtistLink[];
+    donationLinks?: DonationLink[];
+    slug?: string;
+    metadata?: Record<string, any>;
+}
+export interface DonationLink {
+    platform: string;
+    url: string;
+    description?: string;
+}
+export interface ArtistLink {
+    [platform: string]: string;
+}
+export type DownloadMode = 'free' | 'paycurtain' | 'codes' | 'none';
+export type LicenseType = 'copyright' | 'cc-by' | 'cc-by-sa' | 'cc-by-nc' | 'cc-by-nc-sa' | 'cc-by-nc-nd' | 'cc-by-nd' | 'public-domain';
+export interface UnlockCodesConfig {
+    enabled: boolean;
+    namespace?: string;
+    peers?: string[];
+}
+export interface ReleaseConfig {
+    title: string;
+    date: string;
+    description?: string;
+    cover?: string;
+    download?: DownloadMode;
+    unlockCodes?: UnlockCodesConfig;
+    price?: number;
+    paypalLink?: string;
+    stripeLink?: string;
+    license?: LicenseType;
+    genres?: string[];
+    credits?: Credit[];
+    unlisted?: boolean;
+    artistSlug?: string;
+    metadata?: Record<string, any>;
+}
+export interface Credit {
+    role: string;
+    name: string;
+}
+export interface TrackConfig {
+    file: string;
+    title?: string;
+    description?: string;
+    metadata?: Record<string, any>;
+}
+export interface TrackMetadata {
+    file: string;
+    filename: string;
+    title: string;
+    artist?: string;
+    album?: string;
+    year?: number;
+    track?: number;
+    duration?: number;
+    format?: string;
+    bitrate?: number;
+    sampleRate?: number;
+    description?: string;
+    genre?: string[];
+}
+export interface Release {
+    config: ReleaseConfig;
+    tracks: TrackMetadata[];
+    coverPath?: string;
+    path: string;
+    slug: string;
+}
+export interface Catalog {
+    config: CatalogConfig;
+    artist?: ArtistConfig;
+    artists?: ArtistConfig[];
+    releases: Release[];
+}
+export interface BuildOptions {
+    inputDir: string;
+    outputDir: string;
+    theme?: string;
+    basePath?: string;
+    verbose?: boolean;
+}
+export interface GeneratorOptions extends BuildOptions {
+    watch?: boolean;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for Tunecamp
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/utils/audioUtils.d.ts

@@ -0,0 +1,9 @@
+import { TrackMetadata } from '../types/index.js';
+/**
+ * Audio file utilities
+ */
+export declare function readAudioMetadata(filePath: string): Promise<TrackMetadata>;
+export declare function formatDuration(seconds?: number): string;
+export declare function formatFileSize(bytes?: number): string;
+export declare function getAudioFormat(filename: string): string;
+//# sourceMappingURL=audioUtils.d.ts.map

package/dist/utils/audioUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioUtils.d.ts","sourceRoot":"","sources":["../../src/utils/audioUtils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;GAEG;AAEH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA4BhF;AAED,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAarD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAavD"}

package/dist/utils/audioUtils.js

@@ -0,0 +1,67 @@
+import { parseFile } from 'music-metadata';
+import path from 'path';
+/**
+ * Audio file utilities
+ */
+export async function readAudioMetadata(filePath) {
+    try {
+        const metadata = await parseFile(filePath);
+        const filename = path.basename(filePath);
+        return {
+            file: filePath,
+            filename,
+            title: metadata.common.title || filename.replace(/\.[^.]+$/, ''),
+            artist: metadata.common.artist,
+            album: metadata.common.album,
+            year: metadata.common.year,
+            track: metadata.common.track.no ?? undefined,
+            duration: metadata.format.duration,
+            format: metadata.format.container,
+            bitrate: metadata.format.bitrate,
+            sampleRate: metadata.format.sampleRate,
+            genre: metadata.common.genre,
+        };
+    }
+    catch (error) {
+        // Fallback if metadata reading fails
+        const filename = path.basename(filePath);
+        return {
+            file: filePath,
+            filename,
+            title: filename.replace(/\.[^.]+$/, ''),
+        };
+    }
+}
+export function formatDuration(seconds) {
+    if (!seconds)
+        return '0:00';
+    const mins = Math.floor(seconds / 60);
+    const secs = Math.floor(seconds % 60);
+    return `${mins}:${secs.toString().padStart(2, '0')}`;
+}
+export function formatFileSize(bytes) {
+    if (!bytes)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB'];
+    let size = bytes;
+    let unitIndex = 0;
+    while (size >= 1024 && unitIndex < units.length - 1) {
+        size /= 1024;
+        unitIndex++;
+    }
+    return `${size.toFixed(1)} ${units[unitIndex]}`;
+}
+export function getAudioFormat(filename) {
+    const ext = path.extname(filename).toLowerCase().slice(1);
+    const formats = {
+        'mp3': 'MP3',
+        'flac': 'FLAC',
+        'ogg': 'OGG Vorbis',
+        'wav': 'WAV',
+        'm4a': 'M4A/AAC',
+        'aac': 'AAC',
+        'opus': 'OPUS',
+    };
+    return formats[ext] || ext.toUpperCase();
+}
+//# sourceMappingURL=audioUtils.js.map

package/dist/utils/audioUtils.js.map

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

package/dist/utils/configUtils.d.ts

@@ -0,0 +1,11 @@
+import { CatalogConfig, ArtistConfig, ReleaseConfig } from '../types/index.js';
+/**
+ * Configuration file utilities
+ */
+export declare function readYamlFile<T>(filePath: string): Promise<T | null>;
+export declare function readCatalogConfig(directory: string): Promise<CatalogConfig>;
+export declare function readArtistConfig(directory: string): Promise<ArtistConfig | null>;
+export declare function readReleaseConfig(directory: string): Promise<ReleaseConfig | null>;
+export declare function validateCatalogConfig(config: CatalogConfig): void;
+export declare function validateReleaseConfig(config: ReleaseConfig): void;
+//# sourceMappingURL=configUtils.d.ts.map

package/dist/utils/configUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configUtils.d.ts","sourceRoot":"","sources":["../../src/utils/configUtils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAG/E;;GAEG;AAEH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAOzE;AAED,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CASjF;AAED,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAGtF;AAED,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CASxF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAIjE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAYjE"}

package/dist/utils/configUtils.js

@@ -0,0 +1,50 @@
+import { parse as parseYaml } from 'yaml';
+import { readFile, fileExists } from './fileUtils.js';
+import path from 'path';
+/**
+ * Configuration file utilities
+ */
+export async function readYamlFile(filePath) {
+    if (!(await fileExists(filePath))) {
+        return null;
+    }
+    const content = await readFile(filePath);
+    return parseYaml(content);
+}
+export async function readCatalogConfig(directory) {
+    const configPath = path.join(directory, 'catalog.yaml');
+    const config = await readYamlFile(configPath);
+    if (!config || !config.title) {
+        throw new Error(`Invalid or missing catalog.yaml in ${directory}`);
+    }
+    return config;
+}
+export async function readArtistConfig(directory) {
+    const configPath = path.join(directory, 'artist.yaml');
+    return await readYamlFile(configPath);
+}
+export async function readReleaseConfig(directory) {
+    const configPath = path.join(directory, 'release.yaml');
+    const config = await readYamlFile(configPath);
+    if (config && !config.title) {
+        throw new Error(`Release config missing title in ${directory}`);
+    }
+    return config;
+}
+export function validateCatalogConfig(config) {
+    if (!config.title) {
+        throw new Error('Catalog config must have a title');
+    }
+}
+export function validateReleaseConfig(config) {
+    if (!config.title) {
+        throw new Error('Release config must have a title');
+    }
+    if (!config.date) {
+        throw new Error('Release config must have a date');
+    }
+    if (config.download === 'paycurtain' && !config.price) {
+        throw new Error('Release with paycurtain download mode must have a price');
+    }
+}
+//# sourceMappingURL=configUtils.js.map

package/dist/utils/configUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configUtils.js","sourceRoot":"","sources":["../../src/utils/configUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;GAEG;AAEH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,QAAgB;IACpD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,SAAS,CAAC,OAAO,CAAM,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAiB;IACvD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAgB,UAAU,CAAC,CAAC;IAE7D,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,sCAAsC,SAAS,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,SAAiB;IACtD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACvD,OAAO,MAAM,YAAY,CAAe,UAAU,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAiB;IACvD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAgB,UAAU,CAAC,CAAC;IAE7D,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,mCAAmC,SAAS,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAqB;IACzD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAqB;IACzD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,YAAY,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC"}

package/dist/utils/fileUtils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * File utility functions
+ */
+export declare function findAudioFiles(directory: string): Promise<string[]>;
+export declare function findImageFiles(directory: string, name?: string): Promise<string[]>;
+export declare function findCover(directory: string): Promise<string | undefined>;
+export declare function ensureDir(dir: string): Promise<void>;
+export declare function copyFile(src: string, dest: string): Promise<void>;
+export declare function readFile(filePath: string): Promise<string>;
+export declare function writeFile(filePath: string, content: string): Promise<void>;
+export declare function fileExists(filePath: string): Promise<boolean>;
+export declare function createSlug(text: string): string;
+export declare function getRelativePath(from: string, to: string): string;
+//# sourceMappingURL=fileUtils.d.ts.map

package/dist/utils/fileUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileUtils.d.ts","sourceRoot":"","sources":["../../src/utils/fileUtils.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAWzE;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAaxF;AAED,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAa9E;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvE;AAED,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhE;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/utils/fileUtils.js

@@ -0,0 +1,73 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { glob } from 'glob';
+/**
+ * File utility functions
+ */
+export async function findAudioFiles(directory) {
+    const audioExtensions = ['mp3', 'flac', 'ogg', 'wav', 'm4a', 'aac', 'opus'];
+    const pattern = `**/*.{${audioExtensions.join(',')}}`;
+    const files = await glob(pattern, {
+        cwd: directory,
+        absolute: false,
+        nodir: true,
+    });
+    return files.sort();
+}
+export async function findImageFiles(directory, name) {
+    const imageExtensions = ['jpg', 'jpeg', 'png', 'gif', 'webp'];
+    const pattern = name
+        ? `**/${name}.{${imageExtensions.join(',')}}`
+        : `**/*.{${imageExtensions.join(',')}}`;
+    const files = await glob(pattern, {
+        cwd: directory,
+        absolute: false,
+        nodir: true,
+    });
+    return files;
+}
+export async function findCover(directory) {
+    const coverNames = ['cover', 'artwork', 'folder', 'album'];
+    for (const name of coverNames) {
+        const covers = await findImageFiles(directory, name);
+        if (covers.length > 0) {
+            return covers[0];
+        }
+    }
+    // Fallback to any image in the directory
+    const images = await findImageFiles(directory);
+    return images[0];
+}
+export async function ensureDir(dir) {
+    await fs.ensureDir(dir);
+}
+export async function copyFile(src, dest) {
+    await fs.ensureDir(path.dirname(dest));
+    await fs.copy(src, dest);
+}
+export async function readFile(filePath) {
+    return await fs.readFile(filePath, 'utf-8');
+}
+export async function writeFile(filePath, content) {
+    await fs.ensureDir(path.dirname(filePath));
+    await fs.writeFile(filePath, content, 'utf-8');
+}
+export async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function createSlug(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+export function getRelativePath(from, to) {
+    return path.relative(from, to).replace(/\\/g, '/');
+}
+//# sourceMappingURL=fileUtils.js.map

package/dist/utils/fileUtils.js.map

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

package/examples/artist-free/README.md

@@ -0,0 +1,36 @@
+# Example: Artist with Free Downloads
+
+This example shows a simple artist catalog with free downloads.
+
+## Structure
+
+```
+artist-free/
+├── catalog.yaml      # Main catalog config
+├── artist.yaml       # Artist information
+└── releases/
+    └── debut-album/
+        ├── release.yaml   # Release config
+        ├── cover.jpg      # Album artwork (add your own)
+        └── tracks/
+            ├── 01-track-one.mp3
+            ├── 02-track-two.mp3
+            └── 03-track-three.mp3
+```
+
+## Features
+
+- Free downloads for all tracks
+- Artist bio and social links
+- Album metadata and credits
+- Genre tags
+
+## Building
+
+```bash
+tunecamp build ./examples/artist-free -o ./output
+```
+
+## Notes
+
+This example doesn't include actual audio files. Add your own MP3/FLAC files to the `tracks/` directory and cover art as `cover.jpg` and header image.

package/examples/artist-paycurtain/README.md

@@ -0,0 +1,49 @@
+# Artist Paycurtain Example
+
+This example demonstrates how to use TuneCamp with the honor system payment model.
+
+## Features Demonstrated
+
+- **Paycurtain Mode**: Honor system where users can download for free but are encouraged to support the artist
+- **Payment Links**: PayPal and Stripe integration
+- **License System**: Creative Commons licensing
+- **Donation Links**: Multiple donation platforms for artist support
+
+## Configuration
+
+### Catalog Configuration
+- Basic catalog setup with theme selection
+
+### Artist Configuration
+- Artist bio and social links
+- Multiple donation platforms (PayPal, Ko-fi, Patreon)
+
+### Release Configuration
+- Paycurtain mode with suggested price
+- Payment links for PayPal and Stripe
+- Creative Commons license (CC BY-NC)
+- Genre and credit information
+
+## How It Works
+
+1. **Honor System**: Users can download tracks for free, but the interface encourages support
+2. **Payment Links**: Direct links to PayPal and Stripe for easy payment
+3. **License Display**: Clear licensing information for each release
+4. **Donation Section**: Additional ways to support the artist
+
+## Building the Example
+
+```bash
+# Build the example
+tunecamp build ./examples/artist-paycurtain --output ./output
+
+# Serve locally
+tunecamp serve ./output --port 3000
+```
+
+## Key Points
+
+- All files are technically downloadable (static site limitation)
+- The paycurtain is more about encouraging support than restricting access
+- Multiple payment options give users flexibility
+- Clear licensing helps with legal compliance

package/examples/label/README.md

@@ -0,0 +1,33 @@
+# Example: Music Label
+
+This example shows a label catalog with multiple artists.
+
+## Structure
+
+```
+label/
+├── catalog.yaml      # Label info
+└── releases/
+    ├── artist-one-album/
+    │   └── release.yaml
+    └── artist-two-ep/
+        └── release.yaml
+```
+
+## Features
+
+- Label-level configuration
+- Multiple artists
+- Mixed download modes
+- Various genres
+
+## Building
+
+```bash
+tunecamp build ./examples/label -o ./output
+```
+
+## Notes
+
+For a label catalog, you don't need an `artist.yaml` at the root. Instead, each release can specify its own artist in the track metadata or release config.
+