@oronts/vendure-data-hub-plugin 0.1.0 → 0.1.2

package/dist/dashboard/constants/ui-config.ts

@@ -0,0 +1,139 @@
+/**
+ * Polling intervals in milliseconds for real-time data updates.
+ * These values balance responsiveness with server load.
+ */
+export const POLLING_INTERVALS = {
+    /** Queue status polling: 5 seconds */
+    QUEUES: 5000,
+    /** Pipeline runs list polling: 5 seconds */
+    PIPELINE_RUNS: 5000,
+    /** Individual run details polling: 3 seconds (more frequent for active monitoring) */
+    PIPELINE_RUN_DETAILS: 3000,
+    /** Run errors list polling: 5 seconds */
+    RUN_ERRORS: 5000,
+    /** Analytics data polling: 10 seconds */
+    ANALYTICS: 10000,
+    /** Log entries polling: 30 seconds */
+    LOGS: 30000,
+    /** Live log streaming polling: 3 seconds */
+    LIVE_LOGS: 3000,
+    /** Error audit data polling: 10 seconds */
+    ERROR_AUDITS: 10000,
+    /** Default polling interval: 5 seconds */
+    DEFAULT: 5000,
+    /** Active run monitoring polling: 2 seconds (most frequent for real-time feedback) */
+    ACTIVE_RUN: 2000,
+    /** Events list polling: 5 seconds */
+    EVENTS: 5000,
+    /** Queue consumers polling: 5 seconds */
+    CONSUMERS: 5000,
+} as const;
+
+export const UI_LIMITS = {
+    MAX_PREVIEW_ROWS: 100,
+    MAX_LOG_ENTRIES: 1000,
+    TRUNCATE_LENGTH: 50,
+    PREVIEW_ROW_LIMIT: 10,
+    SAMPLE_VALUES_LIMIT: 3,
+    CELL_TRUNCATE_LIMIT: 50,
+    REALTIME_LOG_LIMIT: 50,
+    TIMELINE_LIMIT: 20,
+    /** Max records shown in test result tables */
+    TABLE_PREVIEW_ROWS: 20,
+    /** Max columns shown in test result tables */
+    TABLE_PREVIEW_COLUMNS: 8,
+    /** Max records shown in before/after diff views */
+    DIFF_PREVIEW_RECORDS: 5,
+    /** Max sample values shown in column analysis */
+    COLUMN_SAMPLE_VALUES: 5,
+} as const;
+
+export const BATCH_SIZES = {
+    IMPORT_DEFAULT: 100,
+    EXPORT_DEFAULT: 1000,
+} as const;
+
+export const QUERY_LIMITS = {
+    /** Maximum items when fetching "all" records (safety limit to prevent memory issues) */
+    ALL_ITEMS: 999,
+    /** Maximum secrets to fetch in a single list query */
+    SECRETS_LIST: 200,
+    /** Default limit for export queries */
+    EXPORT_DEFAULT: 10000,
+    /** Default page size for paginated lists */
+    PAGINATION_DEFAULT: 10,
+} as const;
+
+export const CACHE_TIMES = {
+    /** Adapter catalog cache duration: 5 minutes */
+    ADAPTER_CATALOG: 5 * 60 * 1000,
+    /** Vendure schema cache duration: 10 minutes */
+    VENDURE_SCHEMAS: 10 * 60 * 1000,
+} as const;
+
+export const EDITOR_HEIGHTS = {
+    VISUAL: '600px',
+    SIMPLE: '500px',
+} as const;
+
+export const PIPELINE_STATUS = {
+    PUBLISHED: 'PUBLISHED',
+    REVIEW: 'REVIEW',
+    DRAFT: 'DRAFT',
+    ARCHIVED: 'ARCHIVED',
+} as const;
+
+/** UI-only: maps pipeline status to Shadcn badge variant for CSS styling. Not a config fallback. */
+const PIPELINE_STATUS_VARIANTS = {
+    PUBLISHED: 'default',
+    REVIEW: 'outline',
+    DRAFT: 'secondary',
+    ARCHIVED: 'destructive',
+} as const;
+
+export type PipelineStatus = keyof typeof PIPELINE_STATUS_VARIANTS;
+export type BadgeVariant = typeof PIPELINE_STATUS_VARIANTS[PipelineStatus];
+
+export function getStatusBadgeVariant(status: string): BadgeVariant {
+    return PIPELINE_STATUS_VARIANTS[status as PipelineStatus] ?? 'secondary';
+}
+
+/** UI-only: maps run status to Shadcn badge variant for CSS styling. Not a config fallback. */
+const RUN_STATUS_VARIANTS: Record<string, string> = {
+    COMPLETED: 'default',
+    RUNNING: 'outline',
+    PENDING: 'secondary',
+    PAUSED: 'outline',
+    FAILED: 'destructive',
+    CANCELLED: 'secondary',
+    CANCEL_REQUESTED: 'secondary',
+    TIMEOUT: 'destructive',
+};
+
+export function getRunStatusBadgeVariant(status: string): string {
+    return RUN_STATUS_VARIANTS[status] ?? 'secondary';
+}
+
+/** UI-only: maps operator names to placeholder text for input fields. Not a config fallback. */
+const OPERATOR_PLACEHOLDERS: Record<string, string> = {
+    in: 'JSON array, e.g. ["A","B"]',
+    regex: 'regex pattern',
+    default: 'value',
+} as const;
+
+export function getOperatorPlaceholder(operator: string): string {
+    return OPERATOR_PLACEHOLDERS[operator.toLowerCase()] ?? OPERATOR_PLACEHOLDERS.default;
+}
+
+
+/**
+ * Filter dropdown sentinel values.
+ * Used for filter select components where "All" represents no filter applied.
+ * Note: For form field empty states, use SENTINEL_VALUES from sentinel-values.ts.
+ */
+export const FILTER_VALUES = {
+    /** Represents "All" or no filter - maps to empty string when querying */
+    ALL: '__all__',
+} as const;
+
+export const CONNECTION_DEFAULT_TYPE = 'HTTP';

package/dist/dashboard/constants/ui-dimensions.ts

@@ -0,0 +1,145 @@
+/**
+ * Debounce delays in milliseconds for various input validations.
+ * Standard delay of 300ms balances responsiveness with avoiding excessive re-validation.
+ */
+export const DEBOUNCE_DELAYS = {
+    /** JSON validation debounce: 300ms */
+    JSON_VALIDATION: 300,
+    /** Form field validation debounce: 300ms */
+    FORM_VALIDATION: 300,
+    /** Default debounce delay: 300ms */
+    DEFAULT: 300,
+} as const;
+
+export const COMPONENT_HEIGHTS = {
+    DIALOG_MAX_LG: 'max-h-[85vh]',
+    DIALOG_MAX_MD: 'max-h-[80vh]',
+    DIALOG_MAX_SM: 'max-h-[60vh]',
+    SCROLL_AREA_LG: 'max-h-[600px]',
+    SCROLL_AREA_MD: 'max-h-[400px]',
+    SCROLL_AREA_SM: 'max-h-[300px]',
+    SCROLL_AREA_XS: 'max-h-[200px]',
+    SCROLL_AREA_XXS: 'max-h-[120px]',
+    CHART_MD: 'h-[500px]',
+    EDITOR_PANE_MD: 'h-[400px]',
+    LIST_PANE_SM: 'h-[200px]',
+    LIST_PANE_MD: 'h-[300px]',
+    WIZARD_PANE_MD: 'h-[500px]',
+    CODE_EDITOR_MIN: 'min-h-[260px]',
+    CODE_DISPLAY_MIN: 'min-h-[200px]',
+    CODE_BLOCK_MIN: 'min-h-[160px]',
+    CODE_BLOCK_XS: 'min-h-[100px]',
+    CODE_BLOCK_SM: 'min-h-[120px]',
+    CODE_BLOCK_MD: 'min-h-[140px]',
+    FORMULA_HELP_SCROLL: 'h-[200px]',
+} as const;
+
+export const COMPONENT_WIDTHS = {
+    DRAWER_LG: 'w-[540px]',
+    DRAWER_MD: 'w-[400px]',
+    SELECT_SM: 'w-[250px]',
+    SELECT_XS: 'w-[160px]',
+    TABLE_CELL_MAX_LG: 'max-w-[640px]',
+    TABLE_CELL_MAX_SM: 'max-w-[300px]',
+    TABLE_HEADER_MIN: 'min-w-[120px]',
+    NODE_MIN: 'min-w-[150px]',
+    TYPECAST_SELECT: 'w-32',
+    LOGIC_SELECT: 'w-20',
+    OPERATOR_SELECT: 'w-32',
+    AGGREGATION_SELECT: 'w-28',
+    ALIAS_INPUT: 'w-32',
+} as const;
+
+export const ICON_SIZES = {
+    XS: 'w-3 h-3',
+    SM: 'w-4 h-4',
+    MD: 'w-5 h-5',
+    LG: 'w-6 h-6',
+    XL: 'w-8 h-8',
+    XXL: 'w-10 h-10',
+    HERO: 'w-12 h-12',
+} as const;
+
+export const NODE_DIMENSIONS = {
+    MIN_WIDTH: 'min-w-[180px]',
+    HANDLE_SIZE: '!w-3 !h-3',
+    ICON_SM: 'w-4 h-4',
+} as const;
+
+/**
+ * File dropzone dimensions
+ */
+export const DROPZONE_DIMENSIONS = {
+    ICON_DEFAULT: 'w-12 h-12',
+    ICON_COMPACT: 'w-8 h-8',
+    PADDING_DEFAULT: 'p-12',
+    PADDING_COMPACT: 'p-6',
+    FILE_ICON_DEFAULT: 'w-10 h-10',
+    FILE_ICON_COMPACT: 'w-8 h-8',
+} as const;
+
+/**
+ * Wizard progress bar styles
+ */
+export const PROGRESS_BAR_STYLES = {
+    ACTIVE: 'bg-primary text-primary-foreground',
+    COMPLETED: 'bg-green-100 text-green-700 dark:bg-green-900/30 dark:text-green-400',
+    PENDING: 'text-muted-foreground hover:bg-muted',
+} as const;
+
+export const SKELETON_WIDTHS = [80, 120, 100, 140] as const;
+
+/**
+ * Panel widths for drawers and side panels
+ */
+export const PANEL_WIDTHS = {
+    PROPERTIES_DEFAULT: '420px',
+    NODE_PALETTE: 'w-[260px]',
+    MAX_VW: '90vw',
+} as const;
+
+/**
+ * Dialog content dimensions
+ */
+export const DIALOG_DIMENSIONS = {
+    MAX_WIDTH_2XL: 'max-w-2xl',
+    MAX_WIDTH_4XL: 'max-w-4xl',
+    MAX_HEIGHT_80VH: 'max-h-[80vh]',
+    MAX_HEIGHT_85VH: 'max-h-[85vh]',
+} as const;
+
+/**
+ * Select component widths
+ */
+export const SELECT_WIDTHS = {
+    TRIGGER_TYPE: 'w-[180px]',
+    PROVIDER: 'w-[220px]',
+    CONNECTION_TYPE: 'w-[250px]',
+    RUN_STATUS: 'w-[160px]',
+    ADAPTER_SELECTOR: 'w-[400px]',
+} as const;
+
+/**
+ * Scroll area heights
+ */
+export const SCROLL_HEIGHTS = {
+    PROPERTIES_PANEL: 'h-[calc(100vh-80px)]',
+    NODE_PALETTE: 'h-full',
+    REALTIME_LOGS: 'max-h-[600px]',
+    DRY_RUN_RESULTS: 'max-h-[300px]',
+    VALIDATION_PANEL: 'max-h-[60vh]',
+} as const;
+
+/**
+ * Text area heights
+ */
+export const TEXTAREA_HEIGHTS = {
+    CODE_EXPORT_MIN: 'min-h-[200px]',
+    CODE_EXPORT_MAX: 'max-h-[400px]',
+    ADAPTER_SCHEMA: 'min-h-[160px]',
+} as const;
+
+/**
+ * Default number of items to display per page in paginated lists.
+ */
+export const ITEMS_PER_PAGE = 20;

package/dist/dashboard/constants/ui-states.ts

@@ -0,0 +1,28 @@
+/**
+ * Dashboard UI state constants
+ */
+
+/** Pipeline editor panel types */
+export const PIPELINE_EDITOR_PANEL = {
+    STEPS: 'steps',
+    TRIGGERS: 'triggers',
+    SETTINGS: 'settings',
+} as const;
+export type PipelineEditorPanel = typeof PIPELINE_EDITOR_PANEL[keyof typeof PIPELINE_EDITOR_PANEL];
+
+/** Component panel variants */
+export const PANEL_VARIANT = {
+    PANEL: 'panel',
+    EDITOR: 'editor',
+    MODAL: 'modal',
+} as const;
+/** Test/connection status states */
+export const TEST_STATUS = {
+    IDLE: 'idle',
+    TESTING: 'testing',
+    SUCCESS: 'success',
+    ERROR: 'error',
+    WARNING: 'warning',
+} as const;
+
+export { CHECKPOINT_STRATEGY } from '../../shared/constants';

package/dist/dashboard/constants/ui-types.ts

@@ -0,0 +1,85 @@
+/** Diff change types */
+export const DIFF_TYPE = {
+    ADDED: 'ADDED',
+    REMOVED: 'REMOVED',
+    CHANGED: 'CHANGED',
+    UNCHANGED: 'UNCHANGED',
+} as const;
+
+/** Trend directions for stat cards */
+export const TREND_DIRECTION = {
+    UP: 'UP',
+    DOWN: 'DOWN',
+} as const;
+
+/** Move direction for reordering items */
+export const MOVE_DIRECTION = {
+    UP: 'UP',
+    DOWN: 'DOWN',
+} as const;
+
+export type MoveDirection = typeof MOVE_DIRECTION[keyof typeof MOVE_DIRECTION];
+
+/** Loading state types */
+export const LOADING_STATE_TYPE = {
+    SPINNER: 'SPINNER',
+    TABLE: 'TABLE',
+    FORM: 'FORM',
+    CARD: 'CARD',
+    LIST: 'LIST',
+} as const;
+
+/** Secret provider types */
+export const SECRET_PROVIDER = {
+    ENV: 'ENV',
+    INLINE: 'INLINE',
+    EXTERNAL: 'EXTERNAL',
+} as const;
+
+/** Revision types */
+export const REVISION_TYPE = {
+    PUBLISHED: 'PUBLISHED',
+    DRAFT: 'DRAFT',
+} as const;
+
+/** Field types for operator schema fields */
+export const FIELD_TYPE = {
+    JSON: 'json',
+    OBJECT: 'object',
+    ARRAY: 'array',
+    SELECT: 'select',
+    NUMBER: 'number',
+    BOOLEAN: 'boolean',
+    STRING: 'string',
+    PASSWORD: 'password',
+    TEXT: 'text',
+    SECRET: 'secret',
+    CONNECTION: 'connection',
+    TEXTAREA: 'textarea',
+    CODE: 'code',
+    EXPRESSION: 'expression',
+    CRON: 'cron',
+    DATE: 'date',
+    DATETIME: 'datetime',
+    FILE: 'file',
+    ENTITY: 'entity',
+    FIELD: 'field',
+    MAPPING: 'mapping',
+    MULTISELECT: 'multiselect',
+    EMAIL: 'email',
+    URL: 'url',
+    INT: 'int',
+    FLOAT: 'float',
+} as const;
+
+/** UI adapter categories for pipeline organization */
+export const UI_ADAPTER_CATEGORY = {
+    SOURCES: 'SOURCES',
+    TRANSFORMS: 'TRANSFORMS',
+    VALIDATION: 'VALIDATION',
+    ROUTING: 'ROUTING',
+    DESTINATIONS: 'DESTINATIONS',
+    FEEDS: 'FEEDS',
+    EXPORTS: 'EXPORTS',
+    SINKS: 'SINKS',
+} as const;

package/dist/dashboard/constants/validation-patterns.ts

@@ -0,0 +1,26 @@
+/**
+ * Dashboard Validation Patterns
+ *
+ * Re-exports shared validation utilities and adds dashboard-specific
+ * error messages for form validation.
+ */
+
+import {
+    ERROR_MESSAGES as SHARED_ERROR_MESSAGES,
+} from '../../shared';
+
+export const ERROR_MESSAGES = {
+    ...SHARED_ERROR_MESSAGES,
+    INVALID_MAPPING_JSON: 'Invalid mapping JSON',
+    NAME_REQUIRED: 'Name is required',
+    CODE_REQUIRED: 'Code is required',
+    CODE_PATTERN: 'Must start with a letter and contain only letters, numbers, hyphens, and underscores',
+    CONNECTION_TYPE_REQUIRED: 'Connection type is required',
+    PROVIDER_REQUIRED: 'Provider is required',
+    ENV_VAR_NAME_REQUIRED: 'Environment variable name is required',
+    SECRET_VALUE_REQUIRED: 'Secret value is required when creating a new secret',
+    ENV_VAR_FORMAT: 'Environment variable names should be uppercase with underscores (e.g., MY_API_KEY)',
+    MIN_LENGTH_2: 'Must be at least 2 characters',
+    BRANCH_NAME_EMPTY: 'Branch name cannot be empty',
+    DUPLICATE_BRANCH_NAMES: 'Branch names must be unique',
+} as const;