@nextsparkjs/core 0.1.0-beta.69 → 0.1.0-beta.70

package/dist/lib/entities/schema-generator.d.ts

@@ -1,80 +0,0 @@
-/**
- * Schema Auto-Generation System
- *
- * Automatically generates Zod validation schemas from entity field definitions.
- * Supports create, update, and response schemas with child entities.
- */
-import { z } from 'zod';
-import type { EntityConfig } from './types';
-export interface SchemaGenerationOptions {
-    includeReadOnly?: boolean;
-    includeChildEntities?: boolean;
-    customValidation?: Record<string, z.ZodSchema>;
-    strict?: boolean;
-}
-export interface GeneratedSchemas {
-    create: z.ZodSchema;
-    update: z.ZodSchema;
-    response: z.ZodSchema;
-    list: z.ZodSchema;
-    childSchemas?: Record<string, z.ZodSchema>;
-}
-/**
- * Generate all schemas for an entity
- */
-export declare function generateEntitySchemas(entityConfig: EntityConfig, options?: SchemaGenerationOptions): GeneratedSchemas;
-/**
- * Generate TypeScript types from schemas
- */
-export declare function generateTypeScriptTypes(entityConfig: EntityConfig, schemas: GeneratedSchemas): string;
-/**
- * Validate data against entity schema
- */
-export declare function validateEntityData(entityConfig: EntityConfig, data: unknown, schemaType?: 'create' | 'update' | 'response', options?: SchemaGenerationOptions): {
-    success: true;
-    data: unknown;
-} | {
-    success: false;
-    errors: z.ZodError;
-};
-/**
- * Generate schema documentation in markdown format
- */
-export declare function generateSchemaDocumentation(entityConfig: EntityConfig): string;
-export interface BuilderValidationResult {
-    valid: boolean;
-    errors: string[];
-    warnings: string[];
-}
-/**
- * Validate an EntityConfig that has builder.enabled = true
- * Ensures required fields exist for page builder functionality
- */
-export declare function validateBuilderEntityConfig(entityConfig: EntityConfig): BuilderValidationResult;
-/**
- * Validate TaxonomiesConfig
- */
-export declare function validateTaxonomiesConfig(entityConfig: EntityConfig): BuilderValidationResult;
-/**
- * Get all entities with builder.enabled from a registry
- */
-export declare function getBuilderEntities(registry: Record<string, EntityConfig>): EntityConfig[];
-/**
- * Get the effective basePath for an entity
- * Reads from access.basePath (new) with fallback to builder.public.basePath (deprecated)
- */
-export declare function getEntityBasePath(entity: EntityConfig): string | undefined;
-/**
- * Match a URL path to an entity based on access.basePath
- * Uses longest-match strategy to handle nested paths
- *
- * @param path - The URL path to match (e.g., '/blog/my-post', '/about')
- * @param registry - Entity registry to search
- * @returns Match result with entity, slug, and optional isArchive flag
- */
-export declare function matchPathToEntity(path: string, registry: Record<string, EntityConfig>): {
-    entity: EntityConfig;
-    slug: string;
-    isArchive?: boolean;
-} | null;
-//# sourceMappingURL=schema-generator.d.ts.map

package/dist/lib/entities/schema-generator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema-generator.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/schema-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,YAAY,EAAsC,MAAM,SAAS,CAAA;AAE/E,MAAM,WAAW,uBAAuB;IACtC,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAA;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,CAAC,CAAC,SAAS,CAAA;IACnB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAA;IACnB,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAA;IACrB,IAAI,EAAE,CAAC,CAAC,SAAS,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAA;CAC3C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CA+FlB;AA2vBD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAeR;AASD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,OAAO,EACb,UAAU,GAAE,QAAQ,GAAG,QAAQ,GAAG,UAAqB,EACvD,OAAO,GAAE,uBAA4B,GACpC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAA;CAAE,CAW3E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,YAAY,GACzB,MAAM,CAyCR;AAMD,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAOD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,YAAY,GAAG,uBAAuB,CAsE/F;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,YAAY,GAAG,uBAAuB,CA6C5F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GACrC,YAAY,EAAE,CAIhB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAE1E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GACrC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAuCpE"}

package/dist/lib/entities/serialization.d.ts

@@ -1,18 +0,0 @@
-import type { EntityConfig, ChildEntityDefinition } from './types';
-export interface SerializableEntityConfig extends Omit<EntityConfig, 'icon' | 'i18n'> {
-    iconName: string;
-    i18nFallbackLocale: string;
-}
-export interface SerializableChildEntityConfig extends Omit<ChildEntityDefinition, 'icon' | 'i18n'> {
-    iconName: string;
-    i18nFallbackLocale: string;
-}
-export type SerializableConfig = SerializableEntityConfig | SerializableChildEntityConfig;
-export declare function serializeEntityConfig(config: EntityConfig): SerializableEntityConfig;
-export declare function serializeChildEntityConfig(config: ChildEntityDefinition): SerializableChildEntityConfig;
-export declare function serializeConfig(config: EntityConfig | ChildEntityDefinition): SerializableConfig;
-export declare function deserializeEntityConfig(config: SerializableEntityConfig): EntityConfig;
-export declare function deserializeChildEntityConfig(config: SerializableChildEntityConfig): ChildEntityDefinition;
-export declare function serializeEntities(entities: (EntityConfig | ChildEntityDefinition)[]): SerializableConfig[];
-export declare function deserializeEntities(entities: SerializableConfig[]): (EntityConfig | ChildEntityDefinition)[];
-//# sourceMappingURL=serialization.d.ts.map

package/dist/lib/entities/serialization.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/serialization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAsC,MAAM,SAAS,CAAA;AAItG,MAAM,WAAW,wBAAyB,SAAQ,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IACnF,QAAQ,EAAE,MAAM,CAAA;IAChB,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,6BAA8B,SAAQ,IAAI,CAAC,qBAAqB,EAAE,MAAM,GAAG,MAAM,CAAC;IACjG,QAAQ,EAAE,MAAM,CAAA;IAChB,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,GAAG,6BAA6B,CAAA;AAUzF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,wBAAwB,CAYpF;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,qBAAqB,GAAG,6BAA6B,CAQvG;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,qBAAqB,GAAG,kBAAkB,CAMhG;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,wBAAwB,GAAG,YAAY,CAYtF;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,6BAA6B,GAAG,qBAAqB,CAQzG;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,CAAC,YAAY,GAAG,qBAAqB,CAAC,EAAE,GAAG,kBAAkB,EAAE,CAE1G;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,CAAC,YAAY,GAAG,qBAAqB,CAAC,EAAE,CAQ5G"}

package/dist/lib/entities/system-fields.d.ts

@@ -1,56 +0,0 @@
-/**
- * System Fields Configuration
- *
- * These fields are implicit in ALL entities and should NEVER be declared
- * in entity field configurations. They are:
- * - Always present in database tables
- * - Always returned in API responses
- * - Always available for sorting
- * - Shown in metadata sections of detail views
- * - Never shown in forms (managed by database)
- */
-import type { EntityField } from './types';
-/**
- * All system field names that are implicit in every entity
- */
-export declare const SYSTEM_FIELD_NAMES: readonly ["id", "createdAt", "updatedAt", "userId", "teamId"];
-export type SystemFieldName = (typeof SYSTEM_FIELD_NAMES)[number];
-/**
- * Fields that are implicitly available for sorting even if not in config
- */
-export declare const IMPLICIT_SORTABLE_FIELDS: readonly ["createdAt", "updatedAt"];
-export type ImplicitSortableField = (typeof IMPLICIT_SORTABLE_FIELDS)[number];
-/**
- * Virtual field definitions for createdAt/updatedAt
- * Used by frontend components to render these fields consistently
- */
-export declare const SYSTEM_TIMESTAMP_FIELDS: EntityField[];
-/**
- * Check if a field name is a system field
- */
-export declare function isSystemField(fieldName: string): boolean;
-/**
- * Check if a field name is an implicit timestamp field
- */
-export declare function isImplicitTimestampField(fieldName: string): boolean;
-/**
- * Get system timestamp field definition by name
- * Returns the field definition if found, null otherwise
- */
-export declare function getSystemTimestampField(fieldName: string): EntityField | null;
-/**
- * Builder-specific system fields (conditional)
- * These are only valid for entities with builder.enabled = true
- */
-export declare const BUILDER_SYSTEM_FIELD_NAMES: readonly ["blocks"];
-export type BuilderSystemFieldName = (typeof BUILDER_SYSTEM_FIELD_NAMES)[number];
-/**
- * Virtual field definition for blocks (builder entities only)
- * This field is automatically available for entities with builder.enabled = true
- */
-export declare const BUILDER_BLOCKS_FIELD: EntityField;
-/**
- * Check if a field is a builder-specific system field
- */
-export declare function isBuilderSystemField(fieldName: string): boolean;
-//# sourceMappingURL=system-fields.d.ts.map

package/dist/lib/entities/system-fields.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"system-fields.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/system-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C;;GAEG;AACH,eAAO,MAAM,kBAAkB,+DAAgE,CAAA;AAE/F,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjE;;GAEG;AACH,eAAO,MAAM,wBAAwB,qCAAsC,CAAA;AAE3E,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7E;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,WAAW,EAqChD,CAAA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAE7E;AAMD;;;GAGG;AACH,eAAO,MAAM,0BAA0B,qBAAsB,CAAA;AAE7D,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAkBlC,CAAA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE/D"}

package/dist/lib/entities/testing.d.ts

@@ -1,79 +0,0 @@
-/**
- * Entity System Testing Utilities
- *
- * Comprehensive testing utilities for the WordPress-like Entity System.
- * Includes mock generators, test helpers, and validation utilities.
- */
-import type { EntityConfig, EntityField, PlanType, UserFlag } from './types';
-import type { UserRole } from '../../types/user.types';
-/**
- * Generate mock entity configuration for testing
- */
-export declare function createMockEntityConfig(overrides?: Partial<EntityConfig>): EntityConfig;
-/**
- * Generate mock entity data for testing
- */
-export declare function createMockEntityData(entityConfig: EntityConfig, count?: number): Record<string, unknown>[];
-/**
- * Generate mock value for a specific field
- */
-export declare function generateMockFieldValue(field: EntityField): unknown;
-/**
- * Create mock user for testing permissions
- */
-export declare function createMockUser(role?: UserRole, plan?: PlanType, flags?: UserFlag[]): {
-    id: string;
-    role: any;
-    plan: PlanType;
-    flags: UserFlag[];
-    email: string;
-};
-/**
- * Test entity configuration validation
- */
-export declare function validateEntityConfig(config: EntityConfig): {
-    valid: boolean;
-    errors: string[];
-};
-/**
- * Test entity access system (permission system removed)
- */
-export declare function testEntityAccess(entityConfig: EntityConfig): {
-    passed: boolean;
-    results: Array<{
-        test: string;
-        passed: boolean;
-        message: string;
-    }>;
-};
-/**
- * Performance test for entity operations
- */
-export declare function performanceTestEntity(entityConfig: EntityConfig, operations?: Array<'create' | 'read' | 'update' | 'delete'>): Promise<{
-    operation: string;
-    averageTime: number;
-    minTime: number;
-    maxTime: number;
-    iterations: number;
-}[]>;
-/**
- * Integration test for complete entity workflow
- */
-export declare function integrationTestEntity(entityConfig: EntityConfig): Promise<{
-    passed: boolean;
-    steps: Array<{
-        step: string;
-        passed: boolean;
-        duration: number;
-        error?: string;
-    }>;
-}>;
-/**
- * Clean up test entities from registry
- */
-export declare function cleanupTestEntities(): void;
-/**
- * Generate comprehensive test report
- */
-export declare function generateTestReport(entityConfig: EntityConfig, validationResults: ReturnType<typeof validateEntityConfig>, accessResults: ReturnType<typeof testEntityAccess>, integrationResults: Awaited<ReturnType<typeof integrationTestEntity>>): string;
-//# sourceMappingURL=testing.d.ts.map

package/dist/lib/entities/testing.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/testing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,QAAQ,EACT,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAKtD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,YAAY,CAwF1F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAkB7G;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAoDlE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,GAAE,QAAmB,EACzB,IAAI,GAAE,QAAiB,EACvB,KAAK,GAAE,QAAQ,EAAO;;;;;;EASvB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA8C/F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,YAAY,GAAG;IAC5D,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,OAAO,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;KAChB,CAAC,CAAA;CACH,CAiCA;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,YAAY,EAC1B,UAAU,GAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAA0C,GAClG,OAAO,CAAC;IACT,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;CACnB,EAAE,CAAC,CA+CH;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC;IAC/E,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,OAAO,CAAA;QACf,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAC,CAAA;CACH,CAAC,CAqFD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAkB1C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,YAAY,EAC1B,iBAAiB,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,EAC1D,aAAa,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EAClD,kBAAkB,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,GACpE,MAAM,CA6DR"}