@object-ui/core 3.3.0 → 3.3.1

package/src/protocols/SharingProtocol.ts

@@ -1,185 +0,0 @@
-/**
- * ObjectUI
- * Copyright (c) 2024-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-/**
- * @object-ui/core - Sharing Protocol Bridge
- *
- * Converts spec-aligned SharingConfig and EmbedConfig schemas into
- * runtime-usable configurations. Provides embed code generation and
- * configuration validation.
- *
- * @module protocols/SharingProtocol
- * @packageDocumentation
- */
-
-import type { SharingConfig, EmbedConfig } from '@object-ui/types';
-
-// ============================================================================
-// Resolved Types
-// ============================================================================
-
-/** Fully resolved sharing configuration. */
-export interface ResolvedSharingConfig {
-  enabled: boolean;
-  publicLink?: string;
-  password?: string;
-  allowedDomains: string[];
-  expiresAt?: string;
-  allowAnonymous: boolean;
-}
-
-/** Fully resolved embed configuration. */
-export interface ResolvedEmbedConfig {
-  enabled: boolean;
-  allowedOrigins: string[];
-  width: string;
-  height: string;
-  showHeader: boolean;
-  showNavigation: boolean;
-  responsive: boolean;
-}
-
-/** Validation result for sharing configuration. */
-export interface SharingValidationResult {
-  valid: boolean;
-  errors: string[];
-}
-
-// ============================================================================
-// Sharing Config Resolution
-// ============================================================================
-
-/**
- * Resolve a sharing configuration by applying spec defaults.
- *
- * @param config - Partial SharingConfig from the spec
- * @returns Fully resolved sharing configuration
- */
-export function resolveSharingConfig(config: Partial<SharingConfig>): ResolvedSharingConfig {
-  return {
-    enabled: config.enabled ?? false,
-    publicLink: config.publicLink,
-    password: config.password,
-    allowedDomains: config.allowedDomains ?? [],
-    expiresAt: config.expiresAt,
-    allowAnonymous: config.allowAnonymous ?? false,
-  };
-}
-
-// ============================================================================
-// Embed Config Resolution
-// ============================================================================
-
-/**
- * Resolve an embed configuration by applying spec defaults.
- *
- * @param config - Partial EmbedConfig from the spec
- * @returns Fully resolved embed configuration
- */
-export function resolveEmbedConfig(config: Partial<EmbedConfig>): ResolvedEmbedConfig {
-  return {
-    enabled: config.enabled ?? false,
-    allowedOrigins: config.allowedOrigins ?? [],
-    width: config.width ?? '100%',
-    height: config.height ?? '600px',
-    showHeader: config.showHeader ?? true,
-    showNavigation: config.showNavigation ?? false,
-    responsive: config.responsive ?? true,
-  };
-}
-
-// ============================================================================
-// Embed Code Generation
-// ============================================================================
-
-/**
- * Generate an HTML iframe embed snippet from an EmbedConfig and URL.
- *
- * @param config - EmbedConfig from the spec
- * @param url - The URL to embed
- * @returns HTML string containing an iframe element
- */
-export function generateEmbedCode(config: EmbedConfig, url: string): string {
-  const resolved = resolveEmbedConfig(config);
-  const sanitizedUrl = escapeHtmlAttr(url);
-  const title = 'Embedded content';
-
-  const parts = [
-    `<iframe`,
-    `  src="${sanitizedUrl}"`,
-    `  width="${escapeHtmlAttr(resolved.width)}"`,
-    `  height="${escapeHtmlAttr(resolved.height)}"`,
-    `  title="${title}"`,
-    `  frameborder="0"`,
-    `  allowfullscreen`,
-  ];
-
-  if (resolved.responsive) {
-    parts.push(`  style="max-width: 100%; border: none;"`);
-  } else {
-    parts.push(`  style="border: none;"`);
-  }
-
-  parts.push(`></iframe>`);
-
-  return parts.join('\n');
-}
-
-/**
- * Escape a string for safe use in an HTML attribute value.
- */
-function escapeHtmlAttr(value: string): string {
-  return value
-    .replace(/&/g, '&amp;')
-    .replace(/"/g, '&quot;')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;');
-}
-
-// ============================================================================
-// Sharing Config Validation
-// ============================================================================
-
-/**
- * Validate a sharing configuration and return any errors.
- *
- * @param config - SharingConfig to validate
- * @returns Validation result with `valid` flag and error messages
- */
-export function validateSharingConfig(config: SharingConfig): SharingValidationResult {
-  const errors: string[] = [];
-
-  if (config.enabled && !config.publicLink) {
-    errors.push('A public link is required when sharing is enabled.');
-  }
-
-  if (config.expiresAt) {
-    const expiryDate = new Date(config.expiresAt);
-    if (isNaN(expiryDate.getTime())) {
-      errors.push('expiresAt must be a valid ISO 8601 date string.');
-    }
-  }
-
-  if (config.allowedDomains) {
-    for (const domain of config.allowedDomains) {
-      if (!domain || domain.trim().length === 0) {
-        errors.push('allowedDomains contains an empty or whitespace-only entry.');
-        break;
-      }
-    }
-  }
-
-  if (config.password !== undefined && config.password.length === 0) {
-    errors.push('Password must not be an empty string when provided.');
-  }
-
-  return {
-    valid: errors.length === 0,
-    errors,
-  };
-}

package/src/protocols/index.ts

@@ -1,13 +0,0 @@
-/**
- * ObjectUI
- * Copyright (c) 2024-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-export * from './DndProtocol.js';
-export * from './KeyboardProtocol.js';
-export * from './NotificationProtocol.js';
-export * from './ResponsiveProtocol.js';
-export * from './SharingProtocol.js';

package/src/query/__tests__/query-ast.test.ts

@@ -1,211 +0,0 @@
-/**
- * @object-ui/core - Query AST Builder Tests
- */
-
-import { describe, it, expect } from 'vitest';
-import { QueryASTBuilder } from '../query-ast';
-import type { QuerySchema } from '@object-ui/types';
-
-describe('QueryASTBuilder', () => {
-  const builder = new QueryASTBuilder();
-
-  describe('Basic Query Building', () => {
-    it('should build simple SELECT query', () => {
-      const query: QuerySchema = {
-        object: 'users',
-        fields: ['id', 'name', 'email'],
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.select.type).toBe('select');
-      expect(ast.select.fields).toHaveLength(3);
-      expect(ast.from.table).toBe('users');
-    });
-
-    it('should build SELECT * when no fields specified', () => {
-      const query: QuerySchema = {
-        object: 'users',
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.select.fields).toHaveLength(1);
-      expect(ast.select.fields[0]).toMatchObject({
-        type: 'field',
-        name: '*',
-      });
-    });
-
-    it('should build query with WHERE clause', () => {
-      const query: QuerySchema = {
-        object: 'users',
-        fields: ['id', 'name'],
-        filter: {
-          conditions: [
-            {
-              field: 'status',
-              operator: 'equals',
-              value: 'active',
-            },
-          ],
-        },
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.where).toBeDefined();
-      expect(ast.where?.type).toBe('where');
-      expect(ast.where?.condition.type).toBe('operator');
-    });
-
-    it('should build query with ORDER BY', () => {
-      const query: QuerySchema = {
-        object: 'users',
-        fields: ['id', 'name'],
-        sort: [
-          { field: 'created_at', order: 'desc' },
-          { field: 'name', order: 'asc' },
-        ],
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.order_by).toBeDefined();
-      expect(ast.order_by?.fields).toHaveLength(2);
-      expect(ast.order_by?.fields[0].direction).toBe('desc');
-    });
-
-    it('should build query with LIMIT and OFFSET', () => {
-      const query: QuerySchema = {
-        object: 'users',
-        fields: ['id', 'name'],
-        limit: 10,
-        offset: 20,
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.limit).toBeDefined();
-      expect(ast.limit?.value).toBe(10);
-      expect(ast.offset).toBeDefined();
-      expect(ast.offset?.value).toBe(20);
-    });
-  });
-
-  describe('Advanced Query Building', () => {
-    it('should build query with JOIN', () => {
-      const query: QuerySchema = {
-        object: 'users',
-        fields: ['id', 'name', 'orders.total'],
-        joins: [
-          {
-            type: 'left',
-            object: 'orders',
-            on: {
-              local_field: 'id',
-              foreign_field: 'user_id',
-            },
-          },
-        ],
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.joins).toBeDefined();
-      expect(ast.joins).toHaveLength(1);
-      expect(ast.joins?.[0].join_type).toBe('left');
-      expect(ast.joins?.[0].table).toBe('orders');
-    });
-
-    it('should build query with aggregations', () => {
-      const query: QuerySchema = {
-        object: 'orders',
-        aggregations: [
-          {
-            function: 'count',
-            alias: 'total_count',
-          },
-          {
-            function: 'sum',
-            field: 'amount',
-            alias: 'total_amount',
-          },
-        ],
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.select.fields).toHaveLength(2);
-      expect(ast.select.fields[0]).toMatchObject({
-        type: 'aggregate',
-        function: 'count',
-        alias: 'total_count',
-      });
-    });
-
-    it('should build query with GROUP BY', () => {
-      const query: QuerySchema = {
-        object: 'orders',
-        fields: ['user_id'],
-        group_by: ['user_id'],
-        aggregations: [
-          {
-            function: 'count',
-            alias: 'order_count',
-          },
-        ],
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.group_by).toBeDefined();
-      expect(ast.group_by?.fields).toHaveLength(1);
-      expect(ast.group_by?.fields[0]).toMatchObject({
-        type: 'field',
-        name: 'user_id',
-      });
-    });
-  });
-
-  describe('Complex Filters', () => {
-    it('should build query with nested AND/OR filters', () => {
-      const query: QuerySchema = {
-        object: 'users',
-        filter: {
-          operator: 'and',
-          conditions: [
-            {
-              field: 'status',
-              operator: 'equals',
-              value: 'active',
-            },
-          ],
-          groups: [
-            {
-              operator: 'or',
-              conditions: [
-                {
-                  field: 'role',
-                  operator: 'equals',
-                  value: 'admin',
-                },
-                {
-                  field: 'role',
-                  operator: 'equals',
-                  value: 'moderator',
-                },
-              ],
-            },
-          ],
-        },
-      };
-
-      const ast = builder.build(query);
-
-      expect(ast.where).toBeDefined();
-      expect(ast.where?.condition.operator).toBe('and');
-      expect(ast.where?.condition.operands.length).toBeGreaterThan(0);
-    });
-  });
-});

package/src/query/__tests__/window-functions.test.ts

@@ -1,275 +0,0 @@
-/**
- * ObjectUI
- * Copyright (c) 2024-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-/**
- * @object-ui/core - Window Function Tests
- * 
- * Tests for ObjectStack Spec v2.0.1 window function support
- */
-
-import { describe, it, expect } from 'vitest';
-import { QueryASTBuilder } from '../query-ast';
-import type { WindowNode, WindowFunction } from '@object-ui/types';
-
-describe('QueryASTBuilder - Window Functions', () => {
-  const builder = new QueryASTBuilder();
-
-  describe('buildWindow', () => {
-    it('should build a simple row_number window function', () => {
-      const config = {
-        function: 'row_number' as WindowFunction,
-        alias: 'row_num',
-        partitionBy: ['department'],
-        orderBy: [{ field: 'salary', direction: 'desc' as const }],
-      };
-
-      // @ts-expect-error - testing private method
-      const result: WindowNode = builder.buildWindow(config);
-
-      expect(result).toMatchObject({
-        type: 'window',
-        function: 'row_number',
-        alias: 'row_num',
-      });
-
-      expect(result.partitionBy).toHaveLength(1);
-      expect(result.partitionBy![0]).toMatchObject({
-        type: 'field',
-        name: 'department',
-      });
-
-      expect(result.orderBy).toHaveLength(1);
-      expect(result.orderBy![0]).toMatchObject({
-        field: { type: 'field', name: 'salary' },
-        direction: 'desc',
-      });
-    });
-
-    it('should build a rank window function with multiple partition fields', () => {
-      const config = {
-        function: 'rank' as WindowFunction,
-        alias: 'rank_val',
-        partitionBy: ['department', 'location'],
-        orderBy: [
-          { field: 'performance_score', direction: 'desc' as const },
-          { field: 'tenure_years', direction: 'desc' as const },
-        ],
-      };
-
-      // @ts-expect-error - testing private method
-      const result: WindowNode = builder.buildWindow(config);
-
-      expect(result).toMatchObject({
-        type: 'window',
-        function: 'rank',
-        alias: 'rank_val',
-      });
-
-      expect(result.partitionBy).toHaveLength(2);
-      expect(result.orderBy).toHaveLength(2);
-    });
-
-    it('should build a lag window function with offset and default value', () => {
-      const config = {
-        function: 'lag' as WindowFunction,
-        field: 'revenue',
-        alias: 'prev_month_revenue',
-        partitionBy: ['product_id'],
-        orderBy: [{ field: 'month', direction: 'asc' as const }],
-        offset: 1,
-        defaultValue: 0,
-      };
-
-      // @ts-expect-error - testing private method
-      const result: WindowNode = builder.buildWindow(config);
-
-      expect(result).toMatchObject({
-        type: 'window',
-        function: 'lag',
-        alias: 'prev_month_revenue',
-        offset: 1,
-      });
-
-      expect(result.field).toMatchObject({
-        type: 'field',
-        name: 'revenue',
-      });
-
-      expect(result.defaultValue).toMatchObject({
-        type: 'literal',
-        value: 0,
-        data_type: 'number',
-      });
-    });
-
-    it('should build a lead window function', () => {
-      const config = {
-        function: 'lead' as WindowFunction,
-        field: 'sales',
-        alias: 'next_day_sales',
-        orderBy: [{ field: 'date', direction: 'asc' as const }],
-        offset: 1,
-      };
-
-      // @ts-expect-error - testing private method
-      const result: WindowNode = builder.buildWindow(config);
-
-      expect(result).toMatchObject({
-        type: 'window',
-        function: 'lead',
-        alias: 'next_day_sales',
-        offset: 1,
-      });
-    });
-
-    it('should build aggregate window functions (sum, avg, count)', () => {
-      const sumConfig = {
-        function: 'sum' as WindowFunction,
-        field: 'amount',
-        alias: 'running_total',
-        orderBy: [{ field: 'date', direction: 'asc' as const }],
-        frame: {
-          unit: 'rows' as const,
-          start: 'unbounded_preceding' as const,
-          end: 'current_row' as const,
-        },
-      };
-
-      // @ts-expect-error - testing private method
-      const result: WindowNode = builder.buildWindow(sumConfig);
-
-      expect(result).toMatchObject({
-        type: 'window',
-        function: 'sum',
-        alias: 'running_total',
-      });
-
-      expect(result.field).toMatchObject({
-        type: 'field',
-        name: 'amount',
-      });
-
-      expect(result.frame).toEqual({
-        unit: 'rows',
-        start: 'unbounded_preceding',
-        end: 'current_row',
-      });
-    });
-
-    it('should build first_value window function', () => {
-      const config = {
-        function: 'first_value' as WindowFunction,
-        field: 'price',
-        alias: 'first_price',
-        partitionBy: ['product_category'],
-        orderBy: [{ field: 'created_at', direction: 'asc' as const }],
-      };
-
-      // @ts-expect-error - testing private method
-      const result: WindowNode = builder.buildWindow(config);
-
-      expect(result).toMatchObject({
-        type: 'window',
-        function: 'first_value',
-        alias: 'first_price',
-      });
-    });
-
-    it('should build last_value window function', () => {
-      const config = {
-        function: 'last_value' as WindowFunction,
-        field: 'status',
-        alias: 'latest_status',
-        partitionBy: ['customer_id'],
-        orderBy: [{ field: 'updated_at', direction: 'desc' as const }],
-      };
-
-      // @ts-expect-error - testing private method
-      const result: WindowNode = builder.buildWindow(config);
-
-      expect(result).toMatchObject({
-        type: 'window',
-        function: 'last_value',
-        alias: 'latest_status',
-      });
-    });
-
-    it('should handle window function without partition by', () => {
-      const config = {
-        function: 'row_number' as WindowFunction,
-        alias: 'global_row_num',
-        orderBy: [{ field: 'created_at', direction: 'asc' as const }],
-      };
-
-      // @ts-expect-error - testing private method
-      const result: WindowNode = builder.buildWindow(config);
-
-      expect(result.partitionBy).toBeUndefined();
-      expect(result.orderBy).toBeDefined();
-    });
-
-    it('should handle window function with frame specification', () => {
-      const config = {
-        function: 'avg' as WindowFunction,
-        field: 'temperature',
-        alias: 'moving_avg_3days',
-        orderBy: [{ field: 'date', direction: 'asc' as const }],
-        frame: {
-          unit: 'rows' as const,
-          start: { type: 'preceding' as const, offset: 2 },
-          end: 'current_row' as const,
-        },
-      };
-
-      // @ts-expect-error - testing private method
-      const result: WindowNode = builder.buildWindow(config);
-
-      expect(result.frame).toEqual({
-        unit: 'rows',
-        start: { type: 'preceding', offset: 2 },
-        end: 'current_row',
-      });
-    });
-
-    it('should build dense_rank window function', () => {
-      const config = {
-        function: 'dense_rank' as WindowFunction,
-        alias: 'dense_rank_val',
-        partitionBy: ['team'],
-        orderBy: [{ field: 'score', direction: 'desc' as const }],
-      };
-
-      // @ts-expect-error - testing private method
-      const result: WindowNode = builder.buildWindow(config);
-
-      expect(result).toMatchObject({
-        type: 'window',
-        function: 'dense_rank',
-        alias: 'dense_rank_val',
-      });
-    });
-
-    it('should build percent_rank window function', () => {
-      const config = {
-        function: 'percent_rank' as WindowFunction,
-        alias: 'percentile',
-        partitionBy: ['class'],
-        orderBy: [{ field: 'exam_score', direction: 'desc' as const }],
-      };
-
-      // @ts-expect-error - testing private method
-      const result: WindowNode = builder.buildWindow(config);
-
-      expect(result).toMatchObject({
-        type: 'window',
-        function: 'percent_rank',
-        alias: 'percentile',
-      });
-    });
-  });
-});

package/src/query/index.ts

@@ -1,7 +0,0 @@
-/**
- * @object-ui/core - Query Module
- * 
- * Phase 3.3: Query AST builder and utilities
- */
-
-export * from './query-ast.js';