studiograph 1.0.0

package/dist/services/assets/local.js

@@ -0,0 +1,161 @@
+/**
+ * Local filesystem asset backend
+ *
+ * Stores assets in .studiograph/assets/ directory
+ */
+import { existsSync, mkdirSync, writeFileSync, readdirSync, unlinkSync, statSync } from 'fs';
+import { join, dirname, relative } from 'path';
+import { getMediaType } from './base.js';
+export class LocalAssetBackend {
+    basePath;
+    constructor(basePath) {
+        this.basePath = basePath;
+        this.ensureBaseDirectory();
+    }
+    /**
+     * Ensure base directory exists
+     */
+    ensureBaseDirectory() {
+        if (!existsSync(this.basePath)) {
+            mkdirSync(this.basePath, { recursive: true });
+        }
+    }
+    /**
+     * Get full file path for a key
+     */
+    getFilePath(key) {
+        return join(this.basePath, key);
+    }
+    /**
+     * Upload asset to local filesystem
+     */
+    async upload(key, buffer, contentType) {
+        const filePath = this.getFilePath(key);
+        const dir = dirname(filePath);
+        // Ensure directory exists
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Write file
+        writeFileSync(filePath, buffer);
+        // Get file size
+        const stats = statSync(filePath);
+        const filename = key.split('/').pop() || key;
+        // Generate relative path for markdown
+        // For local files, we use relative paths from workspace root
+        const relativePath = relative(process.cwd(), filePath);
+        return {
+            filename,
+            size: stats.size,
+            contentType,
+            url: `file:///${filePath}`, // Local file URL
+            path: relativePath, // Relative path for markdown
+            mediaType: getMediaType(contentType),
+        };
+    }
+    /**
+     * List assets with a given prefix
+     */
+    async list(prefix) {
+        const dirPath = this.getFilePath(prefix);
+        if (!existsSync(dirPath)) {
+            return [];
+        }
+        const assets = [];
+        try {
+            const files = readdirSync(dirPath);
+            for (const file of files) {
+                const filePath = join(dirPath, file);
+                const stats = statSync(filePath);
+                // Skip directories
+                if (stats.isDirectory()) {
+                    continue;
+                }
+                const key = join(prefix, file);
+                const filename = file;
+                const relativePath = relative(process.cwd(), filePath);
+                // Try to detect content type from filename
+                const ext = filename.split('.').pop()?.toLowerCase() || '';
+                const contentType = this.guessContentType(ext);
+                assets.push({
+                    filename,
+                    size: stats.size,
+                    contentType,
+                    url: `file:///${filePath}`,
+                    path: relativePath,
+                    mediaType: getMediaType(contentType),
+                });
+            }
+        }
+        catch (error) {
+            // Directory doesn't exist or can't be read
+            return [];
+        }
+        return assets;
+    }
+    /**
+     * Delete a single asset
+     */
+    async delete(key) {
+        const filePath = this.getFilePath(key);
+        if (!existsSync(filePath)) {
+            throw new Error(`Asset not found: ${key}`);
+        }
+        unlinkSync(filePath);
+    }
+    /**
+     * Delete all assets with a given prefix
+     */
+    async deleteAll(prefix) {
+        const dirPath = this.getFilePath(prefix);
+        if (!existsSync(dirPath)) {
+            return 0;
+        }
+        let count = 0;
+        try {
+            const files = readdirSync(dirPath);
+            for (const file of files) {
+                const filePath = join(dirPath, file);
+                const stats = statSync(filePath);
+                // Only delete files, not directories
+                if (!stats.isDirectory()) {
+                    unlinkSync(filePath);
+                    count++;
+                }
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to delete assets: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+        return count;
+    }
+    /**
+     * Check if an asset exists
+     */
+    async exists(key) {
+        const filePath = this.getFilePath(key);
+        return existsSync(filePath);
+    }
+    /**
+     * Guess content type from file extension
+     */
+    guessContentType(ext) {
+        const contentTypes = {
+            png: 'image/png',
+            jpg: 'image/jpeg',
+            jpeg: 'image/jpeg',
+            gif: 'image/gif',
+            webp: 'image/webp',
+            svg: 'image/svg+xml',
+            mp4: 'video/mp4',
+            mov: 'video/quicktime',
+            webm: 'video/webm',
+            mp3: 'audio/mpeg',
+            wav: 'audio/wav',
+            pdf: 'application/pdf',
+            zip: 'application/zip',
+        };
+        return contentTypes[ext] || 'application/octet-stream';
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/services/assets/local.js.map

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

package/dist/services/assets/r2.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Cloudflare R2 asset backend
+ *
+ * S3-compatible object storage with zero egress fees
+ */
+import type { AssetBackend, AssetInfo, R2Config } from './base.js';
+export declare class R2AssetBackend implements AssetBackend {
+    private client;
+    private bucket;
+    private publicUrl;
+    constructor(config: R2Config);
+    /**
+     * Upload asset to R2
+     */
+    upload(key: string, buffer: Buffer, contentType: string): Promise<AssetInfo>;
+    /**
+     * List assets with a given prefix
+     */
+    list(prefix: string): Promise<AssetInfo[]>;
+    /**
+     * Delete a single asset
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Delete all assets with a given prefix
+     */
+    deleteAll(prefix: string): Promise<number>;
+    /**
+     * Check if an asset exists
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * Guess content type from file extension
+     */
+    private guessContentType;
+}

package/dist/services/assets/r2.js

@@ -0,0 +1,182 @@
+/**
+ * Cloudflare R2 asset backend
+ *
+ * S3-compatible object storage with zero egress fees
+ */
+import { S3Client, PutObjectCommand, ListObjectsV2Command, DeleteObjectCommand, DeleteObjectsCommand, HeadObjectCommand, } from '@aws-sdk/client-s3';
+import { getMediaType } from './base.js';
+export class R2AssetBackend {
+    client;
+    bucket;
+    publicUrl;
+    constructor(config) {
+        this.bucket = config.bucket;
+        this.publicUrl = config.publicUrl.replace(/\/+$/, ''); // Remove trailing slashes
+        // Create S3 client configured for R2
+        this.client = new S3Client({
+            region: 'auto',
+            endpoint: `https://${config.accountId}.r2.cloudflarestorage.com`,
+            credentials: {
+                accessKeyId: config.accessKeyId,
+                secretAccessKey: config.secretAccessKey,
+            },
+        });
+    }
+    /**
+     * Upload asset to R2
+     */
+    async upload(key, buffer, contentType) {
+        try {
+            await this.client.send(new PutObjectCommand({
+                Bucket: this.bucket,
+                Key: key,
+                Body: buffer,
+                ContentType: contentType,
+                CacheControl: 'public, max-age=31536000, immutable', // Cache for 1 year
+            }));
+            const filename = key.split('/').pop() || key;
+            const url = `${this.publicUrl}/${key}`;
+            return {
+                filename,
+                size: buffer.length,
+                contentType,
+                url,
+                path: url, // For R2, use full URL in markdown
+                mediaType: getMediaType(contentType),
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to upload to R2: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * List assets with a given prefix
+     */
+    async list(prefix) {
+        try {
+            const response = await this.client.send(new ListObjectsV2Command({
+                Bucket: this.bucket,
+                Prefix: prefix,
+            }));
+            const assets = [];
+            for (const obj of response.Contents || []) {
+                if (!obj.Key)
+                    continue;
+                // Skip if it's a "directory" (ends with /)
+                if (obj.Key.endsWith('/'))
+                    continue;
+                const filename = obj.Key.split('/').pop() || obj.Key;
+                // Skip if filename contains additional slashes (nested directories)
+                const relativePath = obj.Key.replace(prefix, '');
+                if (relativePath.includes('/'))
+                    continue;
+                const url = `${this.publicUrl}/${obj.Key}`;
+                // Try to get content type from metadata
+                let contentType = 'application/octet-stream';
+                try {
+                    const headResponse = await this.client.send(new HeadObjectCommand({
+                        Bucket: this.bucket,
+                        Key: obj.Key,
+                    }));
+                    contentType = headResponse.ContentType || contentType;
+                }
+                catch {
+                    // If HEAD fails, guess from extension
+                    const ext = filename.split('.').pop()?.toLowerCase() || '';
+                    contentType = this.guessContentType(ext);
+                }
+                assets.push({
+                    filename,
+                    size: obj.Size || 0,
+                    contentType,
+                    url,
+                    path: url,
+                    mediaType: getMediaType(contentType),
+                });
+            }
+            return assets;
+        }
+        catch (error) {
+            throw new Error(`Failed to list assets from R2: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Delete a single asset
+     */
+    async delete(key) {
+        try {
+            await this.client.send(new DeleteObjectCommand({
+                Bucket: this.bucket,
+                Key: key,
+            }));
+        }
+        catch (error) {
+            throw new Error(`Failed to delete from R2: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Delete all assets with a given prefix
+     */
+    async deleteAll(prefix) {
+        try {
+            // First, list all objects with the prefix
+            const response = await this.client.send(new ListObjectsV2Command({
+                Bucket: this.bucket,
+                Prefix: prefix,
+            }));
+            const objects = response.Contents || [];
+            if (objects.length === 0) {
+                return 0;
+            }
+            // Delete all objects
+            await this.client.send(new DeleteObjectsCommand({
+                Bucket: this.bucket,
+                Delete: {
+                    Objects: objects.map(obj => ({ Key: obj.Key })),
+                    Quiet: true,
+                },
+            }));
+            return objects.length;
+        }
+        catch (error) {
+            throw new Error(`Failed to delete assets from R2: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Check if an asset exists
+     */
+    async exists(key) {
+        try {
+            await this.client.send(new HeadObjectCommand({
+                Bucket: this.bucket,
+                Key: key,
+            }));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Guess content type from file extension
+     */
+    guessContentType(ext) {
+        const contentTypes = {
+            png: 'image/png',
+            jpg: 'image/jpeg',
+            jpeg: 'image/jpeg',
+            gif: 'image/gif',
+            webp: 'image/webp',
+            svg: 'image/svg+xml',
+            mp4: 'video/mp4',
+            mov: 'video/quicktime',
+            webm: 'video/webm',
+            mp3: 'audio/mpeg',
+            wav: 'audio/wav',
+            pdf: 'application/pdf',
+            zip: 'application/zip',
+        };
+        return contentTypes[ext] || 'application/octet-stream';
+    }
+}
+//# sourceMappingURL=r2.js.map

package/dist/services/assets/r2.js.map

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

package/dist/services/csv-service.d.ts

@@ -0,0 +1,36 @@
+/**
+ * CSV Service
+ *
+ * Parses, stringifies, validates, and filters CSV data for dataset entities.
+ * Uses csv-parse and csv-stringify for reliable CSV handling.
+ */
+import type { ColumnDefinition, DatasetRow } from '../core/validation.js';
+export interface DatasetFilter {
+    [column: string]: string | number | boolean | {
+        gte?: any;
+        lte?: any;
+        contains?: string;
+    };
+}
+export declare class CSVService {
+    /**
+     * Parse CSV text into typed rows using the declared schema.
+     * Returns an empty array for CSV with headers only (no data rows).
+     */
+    parseRows(csvText: string, schema: ColumnDefinition[]): DatasetRow[];
+    /**
+     * Stringify rows back to CSV text (header row + data rows).
+     */
+    stringifyRows(rows: DatasetRow[], schema: ColumnDefinition[]): string;
+    /**
+     * Validate and coerce a raw string record against the schema.
+     * Throws on missing required fields or type coercion failure.
+     */
+    validateRow(row: Record<string, string>, schema: ColumnDefinition[]): DatasetRow;
+    /**
+     * Filter rows using a DatasetFilter.
+     * Supports equality, { gte, lte } for numbers/dates, { contains } for strings.
+     */
+    filterRows(rows: DatasetRow[], filter: DatasetFilter): DatasetRow[];
+    private coerceValue;
+}

package/dist/services/csv-service.js

@@ -0,0 +1,143 @@
+/**
+ * CSV Service
+ *
+ * Parses, stringifies, validates, and filters CSV data for dataset entities.
+ * Uses csv-parse and csv-stringify for reliable CSV handling.
+ */
+import { parse } from 'csv-parse/sync';
+import { stringify } from 'csv-stringify/sync';
+export class CSVService {
+    /**
+     * Parse CSV text into typed rows using the declared schema.
+     * Returns an empty array for CSV with headers only (no data rows).
+     */
+    parseRows(csvText, schema) {
+        const trimmed = csvText.trim();
+        if (!trimmed) {
+            return [];
+        }
+        const records = parse(trimmed, {
+            columns: true,
+            skip_empty_lines: true,
+            trim: true,
+        });
+        return records.map(record => this.validateRow(record, schema));
+    }
+    /**
+     * Stringify rows back to CSV text (header row + data rows).
+     */
+    stringifyRows(rows, schema) {
+        const columns = schema.map(col => col.name);
+        if (rows.length === 0) {
+            return columns.join(',') + '\n';
+        }
+        return stringify(rows, {
+            header: true,
+            columns,
+            cast: {
+                boolean: (value) => String(value),
+            },
+        });
+    }
+    /**
+     * Validate and coerce a raw string record against the schema.
+     * Throws on missing required fields or type coercion failure.
+     */
+    validateRow(row, schema) {
+        const result = {};
+        for (const col of schema) {
+            const raw = row[col.name];
+            if (raw === undefined || raw === null || raw === '') {
+                if (col.required) {
+                    throw new Error(`Missing required field: ${col.name}`);
+                }
+                result[col.name] = null;
+                continue;
+            }
+            result[col.name] = this.coerceValue(raw, col);
+        }
+        return result;
+    }
+    /**
+     * Filter rows using a DatasetFilter.
+     * Supports equality, { gte, lte } for numbers/dates, { contains } for strings.
+     */
+    filterRows(rows, filter) {
+        return rows.filter(row => {
+            for (const [column, condition] of Object.entries(filter)) {
+                const value = row[column];
+                if (typeof condition === 'object' && condition !== null) {
+                    const { gte, lte, contains } = condition;
+                    if (contains !== undefined) {
+                        if (typeof value !== 'string' || !value.includes(contains)) {
+                            return false;
+                        }
+                    }
+                    if (gte !== undefined) {
+                        if (value === null || value === undefined)
+                            return false;
+                        if (typeof value === 'string' && typeof gte === 'string') {
+                            if (value < gte)
+                                return false;
+                        }
+                        else {
+                            if (value < gte)
+                                return false;
+                        }
+                    }
+                    if (lte !== undefined) {
+                        if (value === null || value === undefined)
+                            return false;
+                        if (typeof value === 'string' && typeof lte === 'string') {
+                            if (value > lte)
+                                return false;
+                        }
+                        else {
+                            if (value > lte)
+                                return false;
+                        }
+                    }
+                }
+                else {
+                    // Equality check
+                    if (value !== condition) {
+                        return false;
+                    }
+                }
+            }
+            return true;
+        });
+    }
+    coerceValue(raw, col) {
+        switch (col.type) {
+            case 'number': {
+                const n = Number(raw);
+                if (isNaN(n)) {
+                    throw new Error(`Invalid number value for column "${col.name}": ${raw}`);
+                }
+                return n;
+            }
+            case 'boolean': {
+                const lower = raw.toLowerCase();
+                if (lower === 'true' || lower === '1' || lower === 'yes')
+                    return true;
+                if (lower === 'false' || lower === '0' || lower === 'no')
+                    return false;
+                throw new Error(`Invalid boolean value for column "${col.name}": ${raw}`);
+            }
+            case 'date': {
+                // Store dates as ISO string; validate that the value is parseable
+                const d = new Date(raw);
+                if (isNaN(d.getTime())) {
+                    throw new Error(`Invalid date value for column "${col.name}": ${raw}`);
+                }
+                // Return the original date string (YYYY-MM-DD) rather than converting to full ISO
+                return raw;
+            }
+            case 'string':
+            default:
+                return raw;
+        }
+    }
+}
+//# sourceMappingURL=csv-service.js.map

package/dist/services/csv-service.js.map

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

package/dist/services/git.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Git service for Studiograph
+ *
+ * Handles Git operations with transaction-based commits,
+ * proper user attribution, and security.
+ */
+export interface GitUser {
+    id: string;
+    name: string;
+    email: string;
+}
+export interface GitChange {
+    operation: 'create' | 'update' | 'delete';
+    filePath: string;
+    entityType: string;
+    entityId: string;
+}
+export interface GitCommit {
+    hash: string;
+    author: {
+        name: string;
+        email: string;
+    };
+    timestamp: number;
+    message: string;
+}
+export declare class GitService {
+    private repoPath;
+    constructor(repoPath: string);
+    /**
+     * Ensure the repo path exists and is a directory
+     */
+    private ensureValidPath;
+    /**
+     * Initialize Git repository if not already initialized
+     */
+    private initializeIfNeeded;
+    /**
+     * Check if repository has any commits
+     */
+    hasCommits(): boolean;
+    /**
+     * Get current branch name
+     */
+    getCurrentBranch(): string;
+    /**
+     * Create a transaction for batched commits
+     */
+    createTransaction(): GitTransaction;
+    /**
+     * Get commit history
+     */
+    getHistory(limit?: number): GitCommit[];
+    /**
+     * Get file history for a specific file
+     */
+    getFileHistory(filePath: string, limit?: number): GitCommit[];
+    /**
+     * Get current status (modified, added, deleted files)
+     */
+    getStatus(): {
+        modified: string[];
+        added: string[];
+        deleted: string[];
+        untracked: string[];
+    };
+    /**
+     * Check if there are uncommitted changes
+     */
+    hasUncommittedChanges(): boolean;
+}
+/**
+ * Transaction class for batched Git commits
+ */
+export declare class GitTransaction {
+    private repoPath;
+    private changes;
+    constructor(repoPath: string);
+    /**
+     * Add a change to this transaction
+     */
+    add(change: GitChange): void;
+    /**
+     * Get all changes in this transaction
+     */
+    getChanges(): GitChange[];
+    /**
+     * Commit all changes in this transaction
+     */
+    commit(user: GitUser, message?: string): Promise<void>;
+    /**
+     * Generate commit message from changes
+     */
+    private generateMessage;
+    /**
+     * Rollback all changes (git reset)
+     */
+    rollback(): Promise<void>;
+}