@aphexcms/cms-core 0.1.1 → 0.1.4

package/dist/utils/image-url.js

@@ -0,0 +1,165 @@
+/**
+ * Helper to extract URL from various image source types
+ * Works with GraphQL responses that include resolved asset data
+ */
+function extractUrl(source) {
+    if (!source)
+        return null;
+    // Direct URL string
+    if (typeof source === 'string') {
+        return source;
+    }
+    // Asset object with url property
+    if (typeof source === 'object' && 'url' in source && source.url) {
+        return source.url;
+    }
+    // ImageValue with resolved asset (from GraphQL)
+    if (typeof source === 'object' && 'asset' in source && source.asset) {
+        // Check if asset is resolved (has url property)
+        if (typeof source.asset === 'object' && 'url' in source.asset) {
+            return source.asset.url;
+        }
+    }
+    return null;
+}
+export class ImageUrlBuilder {
+    _source = null;
+    _options = {};
+    /**
+     * Set the image source
+     */
+    image(source) {
+        this._source = source;
+        return this;
+    }
+    /**
+     * Set width (for future dynamic image rendering)
+     */
+    width(width) {
+        this._options.width = width;
+        return this;
+    }
+    /**
+     * Set height (for future dynamic image rendering)
+     */
+    height(height) {
+        this._options.height = height;
+        return this;
+    }
+    /**
+     * Set both width and height (for future dynamic image rendering)
+     */
+    size(width, height) {
+        this._options.width = width;
+        this._options.height = height;
+        return this;
+    }
+    /**
+     * Set quality (for future dynamic image rendering)
+     */
+    quality(quality) {
+        this._options.quality = Math.max(1, Math.min(100, quality));
+        return this;
+    }
+    /**
+     * Set format (for future dynamic image rendering)
+     */
+    format(format) {
+        this._options.format = format;
+        return this;
+    }
+    /**
+     * Set fit mode (for future dynamic image rendering)
+     */
+    fit(fit) {
+        this._options.fit = fit;
+        return this;
+    }
+    /**
+     * Enable automatic format selection (for future dynamic image rendering)
+     */
+    auto(mode) {
+        this._options.auto = mode;
+        return this;
+    }
+    /**
+     * Build the final URL
+     * Returns /api/assets/{id}?dl=1 which redirects to the actual S3/R2 URL
+     * Transformations (.width(), .quality(), etc) are stored but not yet applied
+     *
+     * For multi-tenant access, use signAssetUrl config to generate signed URLs
+     * TODO: Add dynamic image rendering support
+     */
+    url() {
+        console.log('[ImageUrlBuilder] url() called with source:', JSON.stringify(this._source));
+        if (!this._source) {
+            console.log('[ImageUrlBuilder] No source provided');
+            return null;
+        }
+        // First try to extract a direct URL (if asset was already resolved)
+        const directUrl = extractUrl(this._source);
+        if (directUrl) {
+            console.log('[ImageUrlBuilder] Using direct URL from resolved asset:', directUrl);
+            return directUrl;
+        }
+        // Otherwise, build an API URL from the asset reference
+        let assetId = null;
+        if (typeof this._source === 'string') {
+            console.log('[ImageUrlBuilder] Source is string:', this._source);
+            assetId = this._source;
+        }
+        else if (typeof this._source === 'object') {
+            console.log('[ImageUrlBuilder] Source is object, checking for asset._ref or _ref');
+            if ('asset' in this._source && this._source.asset?._ref) {
+                assetId = this._source.asset._ref;
+                console.log('[ImageUrlBuilder] Found asset._ref:', assetId);
+            }
+            else if ('_ref' in this._source) {
+                assetId = this._source._ref;
+                console.log('[ImageUrlBuilder] Found _ref:', assetId);
+            }
+        }
+        if (!assetId) {
+            console.warn('[ImageUrlBuilder] Could not extract asset ID from source:', this._source);
+            return null;
+        }
+        const finalUrl = `/media/${assetId}/image`;
+        console.log('[ImageUrlBuilder] Building CDN URL:', finalUrl);
+        return finalUrl;
+    }
+    /**
+     * Alias for url()
+     */
+    toString() {
+        return this.url();
+    }
+}
+/**
+ * Factory function to create an image URL builder
+ *
+ * Note: Currently returns direct S3/R2 URLs without transformations.
+ * The baseUrl parameter is accepted for future compatibility but not currently used
+ * since assets already contain their full public URLs.
+ *
+ * For multi-tenant access with API keys, provide a signAssetUrl function:
+ *   const urlFor = imageUrlBuilder({
+ *     signAssetUrl: (assetId) => `/api/assets/${assetId}?token=${generateToken(assetId)}`
+ *   })
+ *
+ * Usage:
+ *   const urlFor = imageUrlBuilder({ baseUrl: 'https://yourdomain.com' })
+ *   const url = urlFor(image).url() // Returns asset.url directly
+ *
+ * Future usage with transformations:
+ *   const url = urlFor(image).width(800).quality(80).url()
+ *   // Will return transformed image once dynamic rendering is implemented
+ */
+export function imageUrlBuilder() {
+    return (source) => {
+        const builder = new ImageUrlBuilder();
+        if (source) {
+            builder.image(source);
+        }
+        return builder;
+    };
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from '../schema-utils/index.js';
+export * from '../field-validation/utils.js';
+export * from './content-hash.js';
+export * from './slug.js';
+export * from './image-url.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/utils/index.ts"],"names":[],"mappings":"AAGA,cAAc,0BAA0B,CAAC;AAGzC,cAAc,8BAA8B,CAAC;AAG7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}

package/{src/utils/index.ts → dist/utils/index.js}

@@ -1,11 +1,8 @@
 // Aphex CMS Utilities
-
 // Schema utilities
 export * from '../schema-utils/index.js';
-
 // Validation utilities
 export * from '../field-validation/utils.js';
-
 // Other utilities
 export * from './content-hash.js';
 export * from './slug.js';

package/dist/utils/slug.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generate a URL-friendly slug from a string
+ * @param text - The text to convert to a slug
+ * @returns A URL-safe slug string
+ */
+export declare function generateSlug(text: string): string;
+/**
+ * Validate if a string is a valid slug
+ * @param slug - The slug to validate
+ * @returns Boolean indicating if the slug is valid
+ */
+export declare function isValidSlug(slug: string): boolean;
+//# sourceMappingURL=slug.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/lib/utils/slug.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAajD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOjD"}

package/dist/utils/slug.js

@@ -0,0 +1,30 @@
+/**
+ * Generate a URL-friendly slug from a string
+ * @param text - The text to convert to a slug
+ * @returns A URL-safe slug string
+ */
+export function generateSlug(text) {
+    if (!text)
+        return '';
+    return (text
+        .toString()
+        .toLowerCase()
+        .trim()
+        // Replace spaces and multiple special characters with single hyphens
+        .replace(/[^a-z0-9]+/g, '-')
+        // Remove leading and trailing hyphens
+        .replace(/^-+|-+$/g, ''));
+}
+/**
+ * Validate if a string is a valid slug
+ * @param slug - The slug to validate
+ * @returns Boolean indicating if the slug is valid
+ */
+export function isValidSlug(slug) {
+    if (!slug)
+        return false;
+    // Valid slug: lowercase letters, numbers, and hyphens only
+    // Cannot start or end with hyphen
+    const slugPattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+    return slugPattern.test(slug);
+}

package/package.json

@@ -1,42 +1,29 @@
 {
 	"name": "@aphexcms/cms-core",
-	"version": "0.1.1",
+	"version": "0.1.4",
 	"description": "Aphex CMS Core - A Sanity-style CMS with ports and adapters architecture",
 	"type": "module",
-	"main": "./src/index.ts",
-	"types": "./src/index.ts",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"svelte": "./dist/index.js",
 	"exports": {
 		".": {
-			"types": "./src/index.ts",
-			"svelte": "./src/index.ts",
-			"default": "./src/index.ts"
+			"types": "./dist/index.d.ts",
+			"svelte": "./dist/index.js",
+			"default": "./dist/index.js"
 		},
 		"./server": {
-			"types": "./src/server/index.ts",
-			"default": "./src/server/index.ts"
+			"types": "./dist/server/index.d.ts",
+			"default": "./dist/server/index.js"
 		},
 		"./client": {
-			"types": "./src/client/index.ts",
-			"default": "./src/client/index.ts"
-		},
-		"./app": {
-			"types": "./src/app.d.ts"
-		}
-	},
-	"typesVersions": {
-		"*": {
-			"app": [
-				"./src/app.d.ts"
-			]
+			"types": "./dist/client/index.d.ts",
+			"default": "./dist/client/index.js"
 		}
 	},
 	"files": [
-		"dist",
-		"src",
-		"package.json",
-		"README.md"
+		"dist"
 	],
-	"svelte": "./src/index.ts",
 	"scripts": {
 		"build": "svelte-package",
 		"check": "svelte-check --tsconfig ./tsconfig.json",

package/src/api/assets.ts

@@ -1,75 +0,0 @@
-// Assets API client - manage uploaded files and images
-import { apiClient } from './client.js';
-import type { Asset } from '../types/asset.js';
-import type { ApiResponse } from './types.js';
-
-export interface AssetFilters {
-	assetType?: 'image' | 'file';
-	mimeType?: string;
-	search?: string;
-	limit?: number;
-	offset?: number;
-}
-
-export interface UpdateAssetData {
-	title?: string;
-	description?: string;
-	alt?: string;
-	creditLine?: string;
-}
-
-export class AssetsApi {
-	/**
-	 * List assets with optional filters
-	 */
-	static async list(filters?: AssetFilters): Promise<ApiResponse<Asset[]>> {
-		const params = new URLSearchParams();
-		if (filters) {
-			Object.entries(filters).forEach(([key, value]) => {
-				if (value !== undefined) {
-					params.append(key, String(value));
-				}
-			});
-		}
-		const query = params.toString();
-		return apiClient.get<Asset[]>(`/assets${query ? `?${query}` : ''}`);
-	}
-
-	/**
-	 * Get asset by ID
-	 */
-	static async getById(id: string): Promise<ApiResponse<Asset>> {
-		return apiClient.get<Asset>(`/assets/${id}`);
-	}
-
-	/**
-	 * Upload a new asset (multipart/form-data)
-	 * Note: Use FormData for file uploads
-	 */
-	static async upload(formData: FormData): Promise<ApiResponse<Asset>> {
-		return apiClient.post<Asset>('/assets', formData);
-	}
-
-	/**
-	 * Update asset metadata
-	 */
-	static async update(id: string, data: UpdateAssetData): Promise<ApiResponse<Asset>> {
-		return apiClient.patch<Asset>(`/assets/${id}`, data);
-	}
-
-	/**
-	 * Delete an asset
-	 */
-	static async delete(id: string): Promise<ApiResponse<{ success: boolean }>> {
-		return apiClient.delete<{ success: boolean }>(`/assets/${id}`);
-	}
-}
-
-// Export convenience functions for direct use
-export const assets = {
-	list: AssetsApi.list.bind(AssetsApi),
-	getById: AssetsApi.getById.bind(AssetsApi),
-	upload: AssetsApi.upload.bind(AssetsApi),
-	update: AssetsApi.update.bind(AssetsApi),
-	delete: AssetsApi.delete.bind(AssetsApi)
-};

package/src/api/client.ts

@@ -1,150 +0,0 @@
-// Base API client with common functionality
-import type { ApiResponse } from './types.js';
-
-// Default configuration
-const DEFAULT_BASE_URL = '/api';
-const DEFAULT_TIMEOUT = 10000; // 10 seconds
-
-export class ApiError extends Error {
-	constructor(
-		public status: number,
-		public response: any,
-		message?: string
-	) {
-		super(message || `API Error: ${status}`);
-		this.name = 'ApiError';
-	}
-}
-
-export class ApiClient {
-	private baseUrl: string;
-	private timeout: number;
-
-	constructor(baseUrl = DEFAULT_BASE_URL, timeout = DEFAULT_TIMEOUT) {
-		this.baseUrl = baseUrl;
-		this.timeout = timeout;
-	}
-
-	/**
-	 * Make HTTP request with proper error handling
-	 */
-	private async request<T>(endpoint: string, options: RequestInit = {}): Promise<ApiResponse<T>> {
-		const url = `${this.baseUrl}${endpoint}`;
-
-		// Set up request with defaults
-		// Don't set Content-Type for FormData (browser will set it with boundary)
-		const headers: Record<string, string> = {};
-		if (!(options.body instanceof FormData)) {
-			headers['Content-Type'] = 'application/json';
-		}
-
-		const requestOptions: RequestInit = {
-			headers: {
-				...headers,
-				...options.headers
-			},
-			...options
-		};
-
-		// Add timeout
-		const controller = new AbortController();
-		const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-		requestOptions.signal = controller.signal;
-
-		try {
-			const response = await fetch(url, requestOptions);
-			clearTimeout(timeoutId);
-
-			const data: ApiResponse<T> = await response.json();
-
-			// Handle HTTP errors
-			if (!response.ok) {
-				throw new ApiError(response.status, data, data.message || data.error);
-			}
-
-			// Handle API-level errors
-			if (!data.success) {
-				throw new ApiError(response.status, data, data.message || data.error);
-			}
-
-			return data;
-		} catch (error) {
-			clearTimeout(timeoutId);
-
-			if (error instanceof ApiError) {
-				throw error;
-			}
-
-			// Handle fetch errors (network, timeout, etc.)
-			throw new ApiError(0, null, error instanceof Error ? error.message : 'Network error');
-		}
-	}
-
-	/**
-	 * GET request
-	 */
-	async get<T>(endpoint: string, params?: Record<string, any>): Promise<ApiResponse<T>> {
-		let url = endpoint;
-
-		if (params) {
-			const searchParams = new URLSearchParams();
-			Object.entries(params).forEach(([key, value]) => {
-				if (value !== undefined && value !== null) {
-					searchParams.append(key, String(value));
-				}
-			});
-
-			if (searchParams.toString()) {
-				url += `?${searchParams.toString()}`;
-			}
-		}
-
-		return this.request<T>(url, { method: 'GET' });
-	}
-
-	/**
-	 * POST request
-	 */
-	async post<T>(endpoint: string, body?: any): Promise<ApiResponse<T>> {
-		return this.request<T>(endpoint, {
-			method: 'POST',
-			// Don't stringify FormData - pass it directly
-			body: body instanceof FormData ? body : body ? JSON.stringify(body) : undefined
-		});
-	}
-
-	/**
-	 * PUT request
-	 */
-	async put<T>(endpoint: string, body?: any): Promise<ApiResponse<T>> {
-		return this.request<T>(endpoint, {
-			method: 'PUT',
-			// Don't stringify FormData - pass it directly
-			body: body instanceof FormData ? body : body ? JSON.stringify(body) : undefined
-		});
-	}
-
-	/**
-	 * DELETE request
-	 */
-	async delete<T>(endpoint: string, body?: any): Promise<ApiResponse<T>> {
-		return this.request<T>(endpoint, {
-			method: 'DELETE',
-			body: body ? JSON.stringify(body) : undefined
-		});
-	}
-
-	/**
-	 * PATCH request
-	 */
-	async patch<T>(endpoint: string, body?: any): Promise<ApiResponse<T>> {
-		return this.request<T>(endpoint, {
-			method: 'PATCH',
-			// Don't stringify FormData - pass it directly
-			body: body instanceof FormData ? body : body ? JSON.stringify(body) : undefined
-		});
-	}
-}
-
-// Export singleton instance
-export const apiClient = new ApiClient();

package/src/api/documents.ts

@@ -1,102 +0,0 @@
-// Documents API client - composable document operations
-import { apiClient } from './client.js';
-import type {
-	Document,
-	DocumentListParams,
-	CreateDocumentData,
-	UpdateDocumentData,
-	ApiResponse
-} from './types.js';
-
-export class DocumentsApi {
-	/**
-	 * List documents with optional filtering
-	 */
-	static async list(params: DocumentListParams = {}): Promise<ApiResponse<Document[]>> {
-		return apiClient.get<Document[]>('/documents', params);
-	}
-
-	/**
-	 * Get document by ID
-	 */
-	static async getById(id: string): Promise<ApiResponse<Document>> {
-		return apiClient.get<Document>(`/documents/${id}`);
-	}
-
-	/**
-	 * Create new document
-	 */
-	static async create(data: CreateDocumentData): Promise<ApiResponse<Document>> {
-		return apiClient.post<Document>('/documents', data);
-	}
-
-	/**
-	 * Update document draft by ID (auto-save)
-	 */
-	static async updateById(id: string, data: UpdateDocumentData): Promise<ApiResponse<Document>> {
-		return apiClient.put<Document>(`/documents/${id}`, data);
-	}
-
-	/**
-	 * Publish document (copy draft -> published)
-	 */
-	static async publish(id: string): Promise<ApiResponse<Document>> {
-		return apiClient.post<Document>(`/documents/${id}/publish`);
-	}
-
-	/**
-	 * Unpublish document (revert to draft only)
-	 */
-	static async unpublish(id: string): Promise<ApiResponse<Document>> {
-		return apiClient.delete<Document>(`/documents/${id}/publish`);
-	}
-
-	/**
-	 * Delete document by ID
-	 */
-	static async deleteById(id: string): Promise<ApiResponse<void>> {
-		return apiClient.delete<void>(`/documents/${id}`);
-	}
-
-	/**
-	 * Get documents by type (convenience method)
-	 */
-	static async getByType(
-		docType: string,
-		params: Omit<DocumentListParams, 'docType'> = {}
-	): Promise<ApiResponse<Document[]>> {
-		return this.list({ ...params, docType });
-	}
-
-	/**
-	 * Get published documents only (convenience method)
-	 */
-	static async getPublished(
-		params: Omit<DocumentListParams, 'status'> = {}
-	): Promise<ApiResponse<Document[]>> {
-		return this.list({ ...params, status: 'published' });
-	}
-
-	/**
-	 * Get draft documents only (convenience method)
-	 */
-	static async getDrafts(
-		params: Omit<DocumentListParams, 'status'> = {}
-	): Promise<ApiResponse<Document[]>> {
-		return this.list({ ...params, status: 'draft' });
-	}
-}
-
-// Export convenience functions for direct use
-export const documents = {
-	list: DocumentsApi.list.bind(DocumentsApi),
-	getById: DocumentsApi.getById.bind(DocumentsApi),
-	create: DocumentsApi.create.bind(DocumentsApi),
-	updateById: DocumentsApi.updateById.bind(DocumentsApi),
-	publish: DocumentsApi.publish.bind(DocumentsApi),
-	unpublish: DocumentsApi.unpublish.bind(DocumentsApi),
-	deleteById: DocumentsApi.deleteById.bind(DocumentsApi),
-	getByType: DocumentsApi.getByType.bind(DocumentsApi),
-	getPublished: DocumentsApi.getPublished.bind(DocumentsApi),
-	getDrafts: DocumentsApi.getDrafts.bind(DocumentsApi)
-};