@rovela-ai/sdk 0.4.1 → 0.4.2

package/dist/media/server/r2-client.js

@@ -0,0 +1,76 @@
+/**
+ * @rovela-ai/sdk/media/server/r2-client
+ *
+ * S3-compatible client for Cloudflare R2 storage.
+ * Server-side only - do not import in client components.
+ */
+import { S3Client } from '@aws-sdk/client-s3';
+import { requireMediaConfig } from '../config';
+// =============================================================================
+// Client Instance Management
+// =============================================================================
+/** Cached S3 client instance */
+let cachedClient = null;
+/** Cached config used to create the client */
+let cachedConfigHash = null;
+/**
+ * Create a hash of the config for cache invalidation
+ */
+function hashConfig(config) {
+    return `${config.accountId}:${config.bucketName}:${config.accessKeyId.slice(0, 8)}`;
+}
+/**
+ * Get or create the S3 client for R2.
+ * Caches the client instance for reuse.
+ */
+export function getR2Client(config) {
+    const resolvedConfig = config || requireMediaConfig();
+    const configHash = hashConfig(resolvedConfig);
+    // Return cached client if config hasn't changed
+    if (cachedClient && cachedConfigHash === configHash) {
+        return cachedClient;
+    }
+    // Create new client
+    cachedClient = new S3Client({
+        region: 'auto',
+        endpoint: `https://${resolvedConfig.accountId}.r2.cloudflarestorage.com`,
+        credentials: {
+            accessKeyId: resolvedConfig.accessKeyId,
+            secretAccessKey: resolvedConfig.secretAccessKey,
+        },
+    });
+    cachedConfigHash = configHash;
+    return cachedClient;
+}
+/**
+ * Clear the cached client (useful for testing)
+ */
+export function clearR2ClientCache() {
+    cachedClient = null;
+    cachedConfigHash = null;
+}
+// =============================================================================
+// Bucket Operations
+// =============================================================================
+/**
+ * Get the configured bucket name
+ */
+export function getBucketName(config) {
+    const resolvedConfig = config || requireMediaConfig();
+    return resolvedConfig.bucketName;
+}
+/**
+ * Get the public URL base for the bucket
+ */
+export function getPublicUrlBase(config) {
+    const resolvedConfig = config || requireMediaConfig();
+    return resolvedConfig.publicUrl;
+}
+/**
+ * Get the store ID for path prefixing
+ */
+export function getStoreId(config) {
+    const resolvedConfig = config || requireMediaConfig();
+    return resolvedConfig.storeId;
+}
+//# sourceMappingURL=r2-client.js.map

package/dist/media/server/r2-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2-client.js","sourceRoot":"","sources":["../../../src/media/server/r2-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAE9C,gFAAgF;AAChF,6BAA6B;AAC7B,gFAAgF;AAEhF,gCAAgC;AAChC,IAAI,YAAY,GAAoB,IAAI,CAAA;AAExC,8CAA8C;AAC9C,IAAI,gBAAgB,GAAkB,IAAI,CAAA;AAE1C;;GAEG;AACH,SAAS,UAAU,CAAC,MAA0B;IAC5C,OAAO,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAA;AACrF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAA2B;IACrD,MAAM,cAAc,GAAG,MAAM,IAAI,kBAAkB,EAAE,CAAA;IACrD,MAAM,UAAU,GAAG,UAAU,CAAC,cAAc,CAAC,CAAA;IAE7C,gDAAgD;IAChD,IAAI,YAAY,IAAI,gBAAgB,KAAK,UAAU,EAAE,CAAC;QACpD,OAAO,YAAY,CAAA;IACrB,CAAC;IAED,oBAAoB;IACpB,YAAY,GAAG,IAAI,QAAQ,CAAC;QAC1B,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,WAAW,cAAc,CAAC,SAAS,2BAA2B;QACxE,WAAW,EAAE;YACX,WAAW,EAAE,cAAc,CAAC,WAAW;YACvC,eAAe,EAAE,cAAc,CAAC,eAAe;SAChD;KACF,CAAC,CAAA;IAEF,gBAAgB,GAAG,UAAU,CAAA;IAE7B,OAAO,YAAY,CAAA;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,YAAY,GAAG,IAAI,CAAA;IACnB,gBAAgB,GAAG,IAAI,CAAA;AACzB,CAAC;AAED,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAA2B;IACvD,MAAM,cAAc,GAAG,MAAM,IAAI,kBAAkB,EAAE,CAAA;IACrD,OAAO,cAAc,CAAC,UAAU,CAAA;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA2B;IAC1D,MAAM,cAAc,GAAG,MAAM,IAAI,kBAAkB,EAAE,CAAA;IACrD,OAAO,cAAc,CAAC,SAAS,CAAA;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAA2B;IACpD,MAAM,cAAc,GAAG,MAAM,IAAI,kBAAkB,EAAE,CAAA;IACrD,OAAO,cAAc,CAAC,OAAO,CAAA;AAC/B,CAAC"}

package/dist/media/types.d.ts

@@ -0,0 +1,316 @@
+/**
+ * @rovela-ai/sdk/media/types
+ *
+ * TypeScript type definitions for media upload functionality.
+ * Supports product images, category covers, and variant swatches.
+ */
+/**
+ * R2/S3 storage configuration
+ */
+export interface MediaStorageConfig {
+    /** Cloudflare account ID (for R2) */
+    accountId: string;
+    /** S3-compatible access key */
+    accessKeyId: string;
+    /** S3-compatible secret key */
+    secretAccessKey: string;
+    /** Bucket name */
+    bucketName: string;
+    /** Public URL for accessing uploaded files */
+    publicUrl: string;
+    /** Store ID for path prefixing */
+    storeId: string;
+}
+/**
+ * Upload constraints configuration
+ */
+export interface UploadConfig {
+    /** Maximum file size in bytes (default: 10MB) */
+    maxSizeBytes: number;
+    /** Allowed MIME types */
+    allowedTypes: string[];
+    /** Maximum files for batch uploads */
+    maxFiles: number;
+}
+/**
+ * Default upload configuration (image-only).
+ *
+ * Used by single-image surfaces (logos, category covers, variant swatches)
+ * where accepting video would break downstream rendering. DO NOT widen this
+ * to include video MIMEs — use `DEFAULT_MEDIA_UPLOAD_CONFIG` for surfaces
+ * that legitimately accept both kinds.
+ */
+export declare const DEFAULT_UPLOAD_CONFIG: UploadConfig;
+/**
+ * Allowed video MIME types across the platform.
+ * MP4 (H.264) is the universal baseline; WebM and QuickTime/MOV are accepted
+ * because browsers + iOS export them natively. Other formats are rejected.
+ */
+export declare const VIDEO_MIME_TYPES: readonly ["video/mp4", "video/webm", "video/quicktime"];
+/**
+ * Default media upload configuration (images + videos).
+ *
+ * Used by product galleries and any surface where merchants legitimately
+ * upload either kind. 100MB cap is the platform-wide ceiling.
+ */
+export declare const DEFAULT_MEDIA_UPLOAD_CONFIG: UploadConfig;
+/**
+ * Detect whether a URL points at a video asset by file extension.
+ * Used by gallery components to decide between `<img>` and `<video>` rendering.
+ */
+export declare function isVideoUrl(url: string): boolean;
+/**
+ * Detect whether a MIME type is a video.
+ */
+export declare function isVideoMime(mime: string): boolean;
+/**
+ * Folder types for organizing uploads
+ */
+export type MediaFolder = 'products' | 'categories' | 'variants' | 'general';
+/**
+ * Request to generate a presigned upload URL
+ */
+export interface PresignedUrlRequest {
+    /** Original filename (used for extension) */
+    filename: string;
+    /** MIME type of the file */
+    contentType: string;
+    /** Target folder for organization */
+    folder: MediaFolder;
+    /** Optional entity ID (productId, categoryId, etc.) */
+    entityId?: string;
+}
+/**
+ * Response containing presigned URL details
+ */
+export interface PresignedUrlResponse {
+    /** Presigned PUT URL for uploading */
+    uploadUrl: string;
+    /** Final public URL after upload completes */
+    publicUrl: string;
+    /** Generated unique key/path in storage */
+    key: string;
+    /** URL expiration timestamp */
+    expiresAt: Date;
+}
+/**
+ * Upload progress information
+ */
+export interface UploadProgress {
+    /** Bytes uploaded so far */
+    loaded: number;
+    /** Total bytes to upload */
+    total: number;
+    /** Progress percentage (0-100) */
+    percentage: number;
+}
+/**
+ * Status of an upload operation
+ */
+export type UploadStatus = 'idle' | 'preparing' | 'uploading' | 'success' | 'error';
+/**
+ * Result of a completed upload
+ */
+export interface UploadResult {
+    /** Whether upload succeeded */
+    success: boolean;
+    /** Final public URL (only if success) */
+    url?: string;
+    /** Original filename */
+    filename: string;
+    /** File size in bytes */
+    size: number;
+    /** MIME type */
+    contentType: string;
+    /** Error message (only if failed) */
+    error?: string;
+}
+/**
+ * State for tracking an upload in progress
+ */
+export interface UploadState {
+    /** Current status */
+    status: UploadStatus;
+    /** Progress information (during upload) */
+    progress: UploadProgress | null;
+    /** Result (after completion) */
+    result: UploadResult | null;
+    /** Error message (if failed) */
+    error: string | null;
+}
+/**
+ * API request body for presign endpoint
+ */
+export interface PresignApiRequest {
+    filename: string;
+    contentType: string;
+    folder: MediaFolder;
+    entityId?: string;
+}
+/**
+ * API response from presign endpoint
+ */
+export interface PresignApiResponse {
+    success: boolean;
+    data?: PresignedUrlResponse;
+    error?: string;
+}
+/**
+ * API request body for delete endpoint
+ */
+export interface DeleteApiRequest {
+    /** URL or key of the file to delete */
+    url: string;
+}
+/**
+ * API response from delete endpoint
+ */
+export interface DeleteApiResponse {
+    success: boolean;
+    error?: string;
+}
+/**
+ * Standard API error response
+ */
+export interface MediaApiError {
+    success: false;
+    error: string;
+    code?: string;
+}
+/**
+ * Options for useUpload hook
+ */
+export interface UseUploadOptions {
+    /** Target folder for uploads */
+    folder: MediaFolder;
+    /** Associated entity ID */
+    entityId?: string;
+    /** Upload configuration overrides */
+    config?: Partial<UploadConfig>;
+    /** Callback when upload completes */
+    onSuccess?: (result: UploadResult) => void;
+    /** Callback when upload fails */
+    onError?: (error: string) => void;
+    /** Callback for progress updates */
+    onProgress?: (progress: UploadProgress) => void;
+}
+/**
+ * Return type of useUpload hook
+ */
+export interface UseUploadReturn {
+    /** Upload a single file */
+    upload: (file: File) => Promise<UploadResult>;
+    /** Upload multiple files */
+    uploadMultiple: (files: File[]) => Promise<UploadResult[]>;
+    /** Current upload status */
+    status: UploadStatus;
+    /** Current progress (if uploading) */
+    progress: UploadProgress | null;
+    /** Whether currently uploading */
+    isUploading: boolean;
+    /** Current error (if any) */
+    error: string | null;
+    /** Reset state to idle */
+    reset: () => void;
+}
+/**
+ * Props for DropZone component
+ */
+export interface DropZoneProps {
+    /** Called when files are dropped/selected */
+    onFiles: (files: File[]) => void;
+    /** Whether to accept multiple files */
+    multiple?: boolean;
+    /** Accepted file types (MIME) */
+    accept?: string[];
+    /** Maximum file size in bytes */
+    maxSize?: number;
+    /** Whether the dropzone is disabled */
+    disabled?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+    /** Custom content inside dropzone */
+    children?: React.ReactNode;
+}
+/**
+ * Props for ImageUpload component
+ */
+export interface ImageUploadProps {
+    /** Current image URL (null if no image) */
+    value: string | null;
+    /** Called when image changes (updates local state) */
+    onChange: (url: string | null) => void;
+    /** Called to persist image to database (for auto-save in edit mode) */
+    onSave?: (url: string | null) => Promise<void>;
+    /** Target folder for uploads */
+    folder: MediaFolder;
+    /** Associated entity ID */
+    entityId?: string;
+    /** Maximum file size in MB */
+    maxSizeMB?: number;
+    /** Whether upload is disabled */
+    disabled?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+    /** Placeholder text when no image */
+    placeholder?: string;
+    /** Aspect ratio for preview (e.g., "1/1", "16/9") */
+    aspectRatio?: string;
+}
+/**
+ * Props for ImageGalleryUpload component. Images via `value`/`onChange`,
+ * videos via `videos`/`onVideosChange` — separate setters mirror the data
+ * model (`products.images` + `products.videos` as separate jsonb columns).
+ * The component renders them in a single combined gallery; drag-to-reorder
+ * works across the boundary and re-splits into the two arrays on drop.
+ */
+export interface ImageGalleryUploadProps {
+    /** Current array of image URLs */
+    value: string[];
+    /** Called when images change (updates local state) */
+    onChange: (urls: string[]) => void;
+    /** Current array of video URLs (optional — image-only callers can omit) */
+    videos?: string[];
+    /** Called when videos change (optional — paired with `videos`) */
+    onVideosChange?: (urls: string[]) => void;
+    /**
+     * Called to persist media to the database after a change. Receives
+     * BOTH arrays so a single transaction can save the new state. Note: the
+     * older single-arg signature `(urls) => Promise<void>` is structurally
+     * compatible — TypeScript permits ignoring extra args — so callers that
+     * don't care about videos still type-check.
+     */
+    onSave?: (images: string[], videos: string[]) => Promise<void>;
+    /** Target folder for uploads */
+    folder: MediaFolder;
+    /** Associated entity ID */
+    entityId?: string;
+    /** Maximum number of media items allowed (images + videos combined) */
+    maxImages?: number;
+    /** Maximum file size in MB (default 100, covers the platform-wide video cap) */
+    maxSizeMB?: number;
+    /** Whether upload is disabled */
+    disabled?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * File validation result
+ */
+export interface FileValidation {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Validate a file against upload constraints
+ */
+export declare function validateFile(file: File, config?: UploadConfig): FileValidation;
+/**
+ * Get file extension from filename
+ */
+export declare function getFileExtension(filename: string): string;
+/**
+ * Generate a unique filename with timestamp and random suffix
+ */
+export declare function generateUniqueFilename(originalFilename: string): string;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/media/types.js

@@ -0,0 +1,95 @@
+/**
+ * @rovela-ai/sdk/media/types
+ *
+ * TypeScript type definitions for media upload functionality.
+ * Supports product images, category covers, and variant swatches.
+ */
+/**
+ * Default upload configuration (image-only).
+ *
+ * Used by single-image surfaces (logos, category covers, variant swatches)
+ * where accepting video would break downstream rendering. DO NOT widen this
+ * to include video MIMEs — use `DEFAULT_MEDIA_UPLOAD_CONFIG` for surfaces
+ * that legitimately accept both kinds.
+ */
+export const DEFAULT_UPLOAD_CONFIG = {
+    maxSizeBytes: 10 * 1024 * 1024, // 10MB
+    allowedTypes: ['image/jpeg', 'image/png', 'image/webp', 'image/gif'],
+    maxFiles: 10,
+};
+/**
+ * Allowed video MIME types across the platform.
+ * MP4 (H.264) is the universal baseline; WebM and QuickTime/MOV are accepted
+ * because browsers + iOS export them natively. Other formats are rejected.
+ */
+export const VIDEO_MIME_TYPES = ['video/mp4', 'video/webm', 'video/quicktime'];
+/**
+ * Default media upload configuration (images + videos).
+ *
+ * Used by product galleries and any surface where merchants legitimately
+ * upload either kind. 100MB cap is the platform-wide ceiling.
+ */
+export const DEFAULT_MEDIA_UPLOAD_CONFIG = {
+    maxSizeBytes: 100 * 1024 * 1024, // 100MB
+    allowedTypes: [
+        'image/jpeg',
+        'image/png',
+        'image/webp',
+        'image/gif',
+        ...VIDEO_MIME_TYPES,
+    ],
+    maxFiles: 10,
+};
+/**
+ * Detect whether a URL points at a video asset by file extension.
+ * Used by gallery components to decide between `<img>` and `<video>` rendering.
+ */
+export function isVideoUrl(url) {
+    // Strip query string + fragment so e.g. signed URLs still match
+    const path = url.split('?')[0].split('#')[0].toLowerCase();
+    return path.endsWith('.mp4') || path.endsWith('.webm') || path.endsWith('.mov');
+}
+/**
+ * Detect whether a MIME type is a video.
+ */
+export function isVideoMime(mime) {
+    return mime.startsWith('video/');
+}
+/**
+ * Validate a file against upload constraints
+ */
+export function validateFile(file, config = DEFAULT_UPLOAD_CONFIG) {
+    // Check file size
+    if (file.size > config.maxSizeBytes) {
+        const maxMB = Math.round(config.maxSizeBytes / (1024 * 1024));
+        return {
+            valid: false,
+            error: `File size exceeds ${maxMB}MB limit`,
+        };
+    }
+    // Check file type
+    if (!config.allowedTypes.includes(file.type)) {
+        return {
+            valid: false,
+            error: `File type ${file.type} is not allowed`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Get file extension from filename
+ */
+export function getFileExtension(filename) {
+    const parts = filename.split('.');
+    return parts.length > 1 ? parts.pop().toLowerCase() : '';
+}
+/**
+ * Generate a unique filename with timestamp and random suffix
+ */
+export function generateUniqueFilename(originalFilename) {
+    const ext = getFileExtension(originalFilename);
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).substring(2, 8);
+    return ext ? `${timestamp}_${random}.${ext}` : `${timestamp}_${random}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/media/types.js.map

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

package/dist/products/api/categories.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @rovela/sdk/products/api/categories
+ *
+ * API route handler for categories endpoint.
+ * Provides GET /api/categories with hierarchical structure.
+ *
+ * Usage in Next.js App Router:
+ * ```typescript
+ * // app/api/categories/route.ts
+ * export { GET } from '@rovela/sdk/products/api'
+ * ```
+ */
+import { NextResponse } from 'next/server';
+import { findCategories } from '../../core/db/queries';
+export interface CategoriesApiResponse {
+    data: Awaited<ReturnType<typeof findCategories>>;
+}
+export interface CategoriesApiError {
+    error: string;
+    code: string;
+}
+/**
+ * GET /api/categories
+ *
+ * Returns all categories for the current tenant, ordered by sort order.
+ * Categories include parentId for building hierarchical navigation.
+ */
+export declare function GET(): Promise<NextResponse<CategoriesApiResponse | CategoriesApiError>>;
+//# sourceMappingURL=categories.d.ts.map

package/dist/products/api/categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../../src/products/api/categories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAMtD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAA;CACjD;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb;AAMD;;;;;GAKG;AACH,wBAAsB,GAAG,IAAI,OAAO,CAClC,YAAY,CAAC,qBAAqB,GAAG,kBAAkB,CAAC,CACzD,CA6BA"}

package/dist/products/api/categories.js

@@ -0,0 +1,46 @@
+/**
+ * @rovela/sdk/products/api/categories
+ *
+ * API route handler for categories endpoint.
+ * Provides GET /api/categories with hierarchical structure.
+ *
+ * Usage in Next.js App Router:
+ * ```typescript
+ * // app/api/categories/route.ts
+ * export { GET } from '@rovela/sdk/products/api'
+ * ```
+ */
+import { NextResponse } from 'next/server';
+import { findCategories } from '../../core/db/queries';
+// =============================================================================
+// Handler
+// =============================================================================
+/**
+ * GET /api/categories
+ *
+ * Returns all categories for the current tenant, ordered by sort order.
+ * Categories include parentId for building hierarchical navigation.
+ */
+export async function GET() {
+    try {
+        const categories = await findCategories();
+        return NextResponse.json({
+            data: categories,
+        });
+    }
+    catch (error) {
+        console.error('[Categories API] Error:', error);
+        // Handle tenant not set error gracefully
+        if (error instanceof Error && error.message.includes('Tenant ID not set')) {
+            return NextResponse.json({
+                error: 'Store not configured. Please set TENANT_ID environment variable.',
+                code: 'TENANT_NOT_SET',
+            }, { status: 500 });
+        }
+        return NextResponse.json({
+            error: 'Failed to fetch categories',
+            code: 'INTERNAL_ERROR',
+        }, { status: 500 });
+    }
+}
+//# sourceMappingURL=categories.js.map

package/dist/products/api/categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../../src/products/api/categories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAetD,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG;IAGvB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,cAAc,EAAE,CAAA;QAEzC,OAAO,YAAY,CAAC,IAAI,CAAC;YACvB,IAAI,EAAE,UAAU;SACjB,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAA;QAE/C,yCAAyC;QACzC,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAC1E,OAAO,YAAY,CAAC,IAAI,CACtB;gBACE,KAAK,EAAE,kEAAkE;gBACzE,IAAI,EAAE,gBAAgB;aACvB,EACD,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAA;QACH,CAAC;QAED,OAAO,YAAY,CAAC,IAAI,CACtB;YACE,KAAK,EAAE,4BAA4B;YACnC,IAAI,EAAE,gBAAgB;SACvB,EACD,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/products/api/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @rovela/sdk/products/api
+ *
+ * API route handlers for product-related endpoints.
+ *
+ * Usage in Next.js App Router:
+ * ```typescript
+ * // app/api/products/route.ts
+ * export { GET as getProducts } from '@rovela/sdk/products/api'
+ *
+ * // app/api/products/[slug]/route.ts
+ * export { getProduct as GET } from '@rovela/sdk/products/api'
+ *
+ * // app/api/categories/route.ts
+ * export { getCategories as GET } from '@rovela/sdk/products/api'
+ * ```
+ */
+export { GET as getProducts } from './products';
+export type { ProductsApiResponse, ProductsApiError } from './products';
+export { GET as getProduct } from './product';
+export type { ProductApiResponse, ProductApiError } from './product';
+export { GET as getCategories } from './categories';
+export type { CategoriesApiResponse, CategoriesApiError } from './categories';
+//# sourceMappingURL=index.d.ts.map

package/dist/products/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/products/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,YAAY,CAAA;AAC/C,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAGvE,OAAO,EAAE,GAAG,IAAI,UAAU,EAAE,MAAM,WAAW,CAAA;AAC7C,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAGpE,OAAO,EAAE,GAAG,IAAI,aAAa,EAAE,MAAM,cAAc,CAAA;AACnD,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA"}

package/dist/products/api/index.js

@@ -0,0 +1,24 @@
+/**
+ * @rovela/sdk/products/api
+ *
+ * API route handlers for product-related endpoints.
+ *
+ * Usage in Next.js App Router:
+ * ```typescript
+ * // app/api/products/route.ts
+ * export { GET as getProducts } from '@rovela/sdk/products/api'
+ *
+ * // app/api/products/[slug]/route.ts
+ * export { getProduct as GET } from '@rovela/sdk/products/api'
+ *
+ * // app/api/categories/route.ts
+ * export { getCategories as GET } from '@rovela/sdk/products/api'
+ * ```
+ */
+// Products list handler
+export { GET as getProducts } from './products';
+// Single product handler
+export { GET as getProduct } from './product';
+// Categories handler
+export { GET as getCategories } from './categories';
+//# sourceMappingURL=index.js.map

package/dist/products/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/products/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,wBAAwB;AACxB,OAAO,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,YAAY,CAAA;AAG/C,yBAAyB;AACzB,OAAO,EAAE,GAAG,IAAI,UAAU,EAAE,MAAM,WAAW,CAAA;AAG7C,qBAAqB;AACrB,OAAO,EAAE,GAAG,IAAI,aAAa,EAAE,MAAM,cAAc,CAAA"}