@donotdev/core 0.0.14 → 0.0.16

package/server.d.ts

@@ -2,8 +2,6 @@ import * as React from 'react';
 import { ReactNode, ComponentType } from 'react';
 export { ReactNode } from 'react';
 import * as v from 'valibot';
-export * from '@donotdev/schemas/server';
-export { global } from '@donotdev/schemas/server';
 
 // Types
 
@@ -13367,5 +13365,465 @@ declare namespace index_d {
   export type { index_d_DateFormatOptions as DateFormatOptions, index_d_DateFormatPreset as DateFormatPreset, index_d_ErrorHandlerConfig as ErrorHandlerConfig, index_d_ErrorHandlerFunction as ErrorHandlerFunction, index_d_HandleErrorOptions as HandleErrorOptions };
 }
 
-export { AUTH_EVENTS, AUTH_PARTNERS, AUTH_PARTNER_STATE, AuthUserSchema, BILLING_EVENTS, BREAKPOINT_RANGES, BREAKPOINT_THRESHOLDS, COMMON_TIER_CONFIGS, CONFIDENCE_LEVELS, CONSENT_CATEGORY, CONTEXTS, CheckoutSessionMetadataSchema, CreateCheckoutSessionRequestSchema, CreateCheckoutSessionResponseSchema, CustomClaimsSchema, DEFAULT_ENTITY_ACCESS, DEFAULT_ERROR_MESSAGES, DEFAULT_LAYOUT_PRESET, DEFAULT_SUBSCRIPTION, DENSITY, DoNotDevError, ENVIRONMENTS, EntityHookError, FEATURES, FEATURE_CONSENT_MATRIX, FEATURE_STATUS, FIREBASE_ERROR_MAP, FIRESTORE_ID_PATTERN, GITHUB_PERMISSION_LEVELS, LAYOUT_PRESET, OAUTH_EVENTS, OAUTH_PARTNERS, PARTNER_ICONS, PAYLOAD_EVENTS, PERMISSIONS, PLATFORMS, PWA_ASSET_TYPES, PWA_DISPLAY_MODES, ProductDeclarationSchema, ProductDeclarationsSchema, ROUTE_SOURCES, STORAGE_SCOPES, STORAGE_TYPES, STRIPE_EVENTS, STRIPE_MODES, SUBSCRIPTION_DURATIONS, SUBSCRIPTION_STATUS, SUBSCRIPTION_TIERS, index_d as ServerUtils, SingletonManager, StripeBackConfigSchema, StripeFrontConfigSchema, StripePaymentSchema, StripeSubscriptionSchema, SubscriptionClaimsSchema, SubscriptionDataSchema, USER_ROLES, UserSubscriptionSchema, WebhookEventSchema, addMonths, addYears, calculateSubscriptionEndDate, captureErrorToSentry, checkGitHubAccessSchema, commonErrorCodeMappings, compactToISOString, createAsyncSingleton, createDefaultSubscriptionClaims, createDefaultUserProfile, createEntitySchema, createErrorHandler, createMetadata, createMethodProxy, createSingleton, createSingletonWithParams, deleteEntitySchema, detectErrorSource, disconnectOAuthSchema, exchangeTokenSchema, filterVisibleFields, formatDate, formatRelativeTime, generateCodeChallenge, generateCodeVerifier, generatePKCEPair, getBreakpointFromWidth, getBreakpointUtils, getConnectionsSchema, getCurrentTimestamp, getEntitySchema, getVisibleFields, getWeekFromISOString, githubPermissionSchema, githubRepoConfigSchema, grantGitHubAccessSchema, handleError, hasRoleAccess, hasTierAccess, isAuthPartnerId, isBreakpoint, isCompactDateString, isFieldVisible, isOAuthPartnerId, isPKCESupported, isoToCompactString, lazyImport, listEntitiesSchema, mapToDoNotDevError, maybeTranslate, normalizeToISOString, overrideFeatures, overridePaymentModes, overridePermissions, overrideSubscriptionStatus, overrideSubscriptionTiers, overrideUserRoles, parseDate, parseDateToNoonUTC, parseISODate, parseServerCookie, refreshTokenSchema, revokeGitHubAccessSchema, showNotification, timestampToISOString, toDateOnly, toISOString, translateArray, translateArrayRange, translateArrayWithIndices, translateObjectArray, updateEntitySchema, updateMetadata, validateAuthPartners, validateAuthSchemas, validateAuthUser, validateBillingSchemas, validateCheckoutSessionMetadata, validateCodeChallenge, validateCodeVerifier, validateCreateCheckoutSessionRequest, validateCreateCheckoutSessionResponse, validateCustomClaims, validateEnvVar, validateMetadata, validateOAuthPartners, validateStripeBackConfig, validateStripeFrontConfig, validateSubscriptionClaims, validateSubscriptionData, validateUrl, validateUserSubscription, validateWebhookEvent, withErrorHandling, withGracefulDegradation };
-export type { AccountLinkResult, AccountLinkingInfo, AdminCheckHookResult, AdminClaims, AggregateConfig, AggregateFilterOperator, AggregateOperation, AggregateRequest, AggregateResponse, ApiResponse, AppConfig, AppCookieCategories, AppMetadata, AppProvidersProps, AssetsPluginConfig, AttemptRecord, AuthAPI, AuthActions, AuthConfig, AuthContextValue, AuthCoreHookResult, AuthError, AuthEventData, AuthEventKey, AuthEventName, AuthMethod, AuthPartner, AuthPartnerButton, AuthPartnerHookResult, AuthPartnerId, AuthPartnerResult, AuthPartnerState, AuthProvider, AuthProviderProps, AuthRedirectHookResult, AuthRedirectOperation, AuthRedirectOptions, AuthResult, AuthState, AuthStateStore, AuthStatus, AuthTokenHookResult, AuthUser, BaseActions, BaseCredentials, BaseDocument, BaseEntityFields, BasePartnerState, BaseState, BaseStoreActions, BaseStoreState, BaseUserProfile, BasicUserInfo, BillingAPI, BillingAdapter, BillingErrorCode, BillingEvent, BillingEventData, BillingEventKey, BillingEventName, BillingProvider, BillingProviderConfig, BillingRedirectOperation, Breakpoint, BreakpointUtils, BusinessEntity, CachedError, CanAPI, CheckGitHubAccessRequest, CheckoutMode, CheckoutOptions, CheckoutSessionMetadata, ColumnDef, CommonSubscriptionFeatures, CommonTranslations, ConfidenceLevel, ConsentAPI, ConsentActions, ConsentCategory, ConsentState, Context, CookieOptions, CreateCheckoutSessionRequest, CreateCheckoutSessionResponse, CreateEntityData, CreateEntityRequest, CreateEntityResponse, CrudAPI, CrudConfig, CustomClaims, CustomStoreConfig, DateFormatOptions, DateFormatPreset, DateValue, DeleteEntityRequest, DeleteEntityResponse, Density, DnDevLayoutProps, DnDevOverride, DndevFrameworkConfig, DoNotDevCookieCategories, DynamicFormRule, Editable, EffectiveConnectionType, EmailVerificationHookResult, EmailVerificationStatus, Entity, EntityAccessConfig, EntityAccessDefaults, EntityField, EntityHookErrors, EntityMetadata, EntityTemplateProps, EntityTranslations, EnvironmentMode, ErrorCode, ErrorHandlerConfig, ErrorHandlerFunction, ErrorSeverity, ErrorSource, ExchangeTokenParams, ExchangeTokenRequest, FaviconConfig, Feature, FeatureAccessHookResult, FeatureConsentRequirement, FeatureHookResult, FeatureId, FeatureName, FeatureStatus, FeaturesConfig, FeaturesPluginConfig, FeaturesRequiringAnyConsent, FeaturesRequiringConsent, FeaturesWithoutConsent, FieldCondition, FieldType, FieldTypeToValue, FileAsset, FirebaseCallOptions, FirebaseConfig, FirestoreTimestamp, FirestoreUniqueConstraintValidator, FooterConfig, FooterZoneConfig, FormConfig, FormStep, FunctionCallConfig, FunctionCallContext, FunctionCallOptions, FunctionCallResult, FunctionClient, FunctionClientFactoryOptions, FunctionDefaults, FunctionEndpoint, FunctionError, FunctionLoader, FunctionMemory, FunctionMeta, FunctionPlatform, FunctionResponse, FunctionSchema, FunctionSchemas, FunctionSystem, FunctionTrigger, FunctionsConfig, GetCustomClaimsResponse, GetEntityData, GetEntityRequest, GetEntityResponse, GetUserAuthStatusResponse, GitHubPermission, GitHubRepoConfig, GrantGitHubAccessRequest, GroupByDefinition, HandleErrorOptions, HeaderZoneConfig, I18nConfig, I18nPluginConfig, I18nProviderProps, ID, INetworkManager, IStorageManager, IStorageStrategy, Invoice, InvoiceItem, LanguageInfo, LayoutConfig, LayoutInput, LayoutPreset, LegalCompanyInfo, LegalConfig, LegalContactInfo, LegalDirectorInfo, LegalHostingInfo, LegalJurisdictionInfo, LegalSectionsConfig, LegalWebsiteInfo, ListEntitiesRequest, ListEntitiesResponse, ListEntityData, ListOptions, ListResponse, LoadingActions, LoadingState, MergedBarConfig, MetricDefinition, MobileBehaviorConfig, ModalActions, ModalState, MutationResponse, NavigationRoute, NetworkCheckConfig, NetworkConnectionType, NetworkReconnectCallback, NetworkState, NetworkStatus, NetworkStatusHookResult, OAuthAPI, OAuthApiRequestOptions, OAuthCallbackHookResult, OAuthConnection, OAuthConnectionInfo, OAuthConnectionRequest, OAuthConnectionStatus, OAuthCredentials, OAuthEventData, OAuthEventKey, OAuthEventName, OAuthPartner, OAuthPartnerButton, OAuthPartnerHookResult, OAuthPartnerId, OAuthPartnerResult, OAuthPartnerState, OAuthPurpose, OAuthRedirectOperation, OAuthRefreshRequest, OAuthRefreshResponse, OAuthResult, OAuthStoreActions, OAuthStoreState, Observable, OrderByClause, PWAAssetType, PWADisplayMode, PWAPluginConfig, PageAuth, PageMeta, PaginationOptions, PartnerButton, PartnerConnectionState, PartnerIconId, PartnerId, PartnerResult, PartnerType, PayloadCacheEventData, PayloadDocument, PayloadDocumentEventData, PayloadEventKey, PayloadEventName, PayloadGlobalEventData, PayloadMediaEventData, PayloadPageRegenerationEventData, PayloadRequest, PayloadUserEventData, PaymentEventData, PaymentMethod, PaymentMethodType, PaymentMode, Permission, Picture, Platform, PresetConfig, PresetRegistry, ProcessPaymentSuccessRequest, ProcessPaymentSuccessResponse, ProductDeclaration, ProviderInstances, QueryConfig, RateLimitConfig, RateLimitManager, RateLimitResult, RateLimitState, RateLimiter, ReadCallback, RedirectOperation, RedirectOverlayActions, RedirectOverlayConfig, RedirectOverlayPhase, RedirectOverlayState, Reference, RefreshSubscriptionRequest, RefreshSubscriptionResponse, RemoveCustomClaimsResponse, ResolvedLayoutConfig, RevokeGitHubAccessRequest, RouteMeta, RouteSource, RoutesPluginConfig, SEOConfig, SchemaMetadata, SetCustomClaimsResponse, SidebarZoneConfig, SlotContent, StorageOptions, StorageScope, StorageType, Store, StoreApi, StripeBackConfig, StripeCheckoutRequest, StripeCheckoutResponse, StripeCheckoutSessionEventData, StripeConfig, StripeCustomer, StripeCustomerEventData, StripeEventData, StripeEventKey, StripeEventName, StripeFrontConfig, StripeInvoice, StripeInvoiceEventData, StripePayment, StripePaymentIntentEventData, StripePaymentMethod, StripePrice, StripeProduct, StripeProvider, StripeSubscription, StripeSubscriptionData, StripeWebhookEvent, StripeWebhookEventData, Subscription, SubscriptionClaims, SubscriptionConfig, SubscriptionData, SubscriptionDuration, SubscriptionEventData, SubscriptionHookResult, SubscriptionInfo, SubscriptionStatus, SubscriptionTier, SupportedLanguage, ThemeActions, ThemeInfo, ThemeMode, ThemeState, ThemesPluginConfig, TierAccessHookResult, Timestamp, TokenInfo, TokenResponse, TokenState, TokenStatus, TranslationOptions, TranslationResource, UIFieldOptions, UniqueConstraintValidator, UnsubscribeFn, UpdateEntityData, UpdateEntityRequest, UpdateEntityResponse, UseFunctionsMutationOptions, UseFunctionsQueryOptions, UseTranslationOptionsEnhanced, UserContext, UserProfile, UserProviderData, UserRole, UserSubscription, ValidationRules, ValueTypeForField, Visibility, WebhookEvent, WebhookEventData, WhereClause, WhereOperator, WithMetadata, dndevSchema };
+/**
+ * @fileoverview Unified Schema Generation
+ * @description Creates Valibot schemas from entity definitions with visibility metadata.
+ *
+ * Entity → Schema (with visibility) → Used everywhere (frontend + backend)
+ *
+ * Isomorphic code (works in both client and server environments).
+ *
+ * @version 0.0.2
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+
+/**
+ * Valibot schema with visibility metadata attached
+ */
+interface SchemaWithVisibility extends v.BaseSchema<unknown, unknown, v.BaseIssue<unknown>> {
+    visibility?: Visibility;
+}
+/**
+ * Operation-specific schemas generated from entity
+ */
+interface OperationSchemas {
+    /** Create: excludes technical fields, enforces required */
+    create: dndevSchema<unknown>;
+    /** Draft: excludes technical fields, all optional except status='draft' */
+    draft: dndevSchema<unknown>;
+    /** Update: excludes technical fields, all optional */
+    update: dndevSchema<unknown>;
+    /** Get: includes all fields with visibility metadata */
+    get: dndevSchema<unknown>;
+    /** List: optimized for admin table (uses listFields) */
+    list: dndevSchema<unknown>;
+    /** ListCard: optimized for public cards (uses listCardFields, falls back to listFields) */
+    listCard: dndevSchema<unknown>;
+    /** Delete: just { id: string } */
+    delete: dndevSchema<unknown>;
+}
+/**
+ * Creates all operation-specific schemas from an entity definition
+ *
+ * Each schema field has `.visibility` attached for backend filtering.
+ *
+ * @param entity - Entity definition
+ * @returns Operation-specific schemas with visibility metadata
+ *
+ * @example
+ * ```typescript
+ * const schemas = createSchemas(carEntity);
+ * // schemas.create - for creating documents
+ * // schemas.draft - for saving incomplete
+ * // schemas.update - for partial updates
+ * // schemas.get - for reading (includes technical fields)
+ * // schemas.list - array of get
+ * // schemas.delete - just { id }
+ * ```
+ */
+declare function createSchemas(entity: Entity): OperationSchemas;
+
+/**
+ * @fileoverview Schema enhancement utility
+ * @description Enhances a Valibot schema with additional metadata
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+
+/**
+ * Enhances a Valibot schema with additional metadata.
+ *
+ * @param schema - The base Valibot schema
+ * @param metadata - The metadata to attach
+ * @returns The enhanced schema
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+declare function enhanceSchema<T>(schema: v.BaseSchema<unknown, T, v.BaseIssue<unknown>>, metadata: SchemaMetadata): dndevSchema<T>;
+
+/**
+ * @fileoverview Schema type generation utility
+ * @description Creates Valibot schemas via registry - extensible for custom types
+ *
+ * @version 0.0.2
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+
+/**
+ * Schema generator function type
+ */
+type CustomSchemaGenerator = (field: EntityField<FieldType>) => v.BaseSchema<unknown, unknown, v.BaseIssue<unknown>> | null;
+/**
+ * Register a schema generator for a field type
+ */
+declare function registerSchemaGenerator(type: string, generator: CustomSchemaGenerator): void;
+/**
+ * Check if a schema generator is registered
+ */
+declare function hasCustomSchemaGenerator(type: string): boolean;
+/**
+ * Get all registered schema types
+ */
+declare function getRegisteredSchemaTypes(): string[];
+/**
+ * Clear all schema generators (testing)
+ */
+declare function clearSchemaGenerators(): void;
+/**
+ * Get Valibot schema for an entity field
+ *
+ * Priority order:
+ * 1. field.validation?.schema (custom schema defined directly in entity)
+ * 2. Registry lookup (built-in or registered custom types)
+ * 3. Fallback to v.unknown() for unregistered types
+ */
+declare function getSchemaType(field: EntityField<FieldType>): v.BaseSchema<unknown, unknown, v.BaseIssue<unknown>>;
+
+/**
+ * Recursively validates that all string values that look like potential dates
+ * within an object adhere to the ISO 8601 format (YYYY-MM-DDTHH:mm:ss.sssZ).
+ *
+ * @param data - The object or data structure to validate
+ * @param {string} [currentPath=''] - Internal tracking of the object path for error messages
+ * @throws Error if any string resembling a date is not in the correct ISO format
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+declare function validateDates(data: Record<string, any> | any[], currentPath?: string): void;
+
+/**
+ * Validates a document against the schema, including uniqueness and custom validations.
+ * @param schema - The enhanced schema.
+ * @param data - The document data.
+ * @param operation - 'create' or 'update'.
+ * @param currentDocId - Optional current document ID for update operations.
+ * @throws DoNotDevError if validation fails.
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+declare function validateDocument<T>(schema: dndevSchema<T>, data: Record<string, any>, operation: 'create' | 'update', currentDocId?: string): Promise<void>;
+
+/**
+ * @fileoverview Unique field validation utility
+ * @description Validates uniqueness constraints for schema fields
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+
+/**
+ * Registers a validator for uniqueness constraints
+ *
+ * @param validator - The validator implementation
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+declare function registerUniqueConstraintValidator(validator: UniqueConstraintValidator): void;
+/**
+ * Validates unique fields for a document across environments.
+ *
+ * @param schema - The Valibot schema with metadata.
+ * @param data - The document data.
+ * @param currentDocId - Optional ID of the current document (for updates).
+ * @throws Error if a unique constraint is violated.
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+declare function validateUniqueFields<T>(schema: dndevSchema<T>, data: Record<string, any>, currentDocId?: string): Promise<void>;
+
+/**
+ * @fileoverview Schema Utilities
+ * @description Common utility functions for working with schemas. Provides helper functions for schema metadata checking and manipulation.
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+
+/**
+ * Checks if an object has schema metadata (works with Valibot schemas)
+ *
+ * @param obj - The object to check
+ * @returns Whether the object has schema metadata
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+declare function hasMetadata(obj: unknown): obj is dndevSchema<unknown>;
+/**
+ * Gets the collection name from a schema
+ *
+ * @param schema - The schema to get the collection name from
+ * @returns The collection name
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+declare function getCollectionName(schema: dndevSchema<unknown>): string;
+
+/**
+ * @fileoverview The 4 Field Families
+ * @description Every entity in the framework is composed of 4 families
+ *
+ * ## The 4 Families
+ *
+ * ```
+ * Entity = Technical Fields + Status Field + User Fields (Framework Types or Custom Types)
+ * ```
+ *
+ * ### Family 1: TECHNICAL_FIELDS (Backend-Generated)
+ * **Members**: `id`, `createdAt`, `updatedAt`, `createdById`, `updatedById`
+ *
+ * **Rules**:
+ * - ✓ Always present (framework adds automatically)
+ * - ✗ Users cannot set (stripped from submissions)
+ * - ✓ Read-only in edit forms
+ * - ✓ Auto-generated by server
+ *
+ * ### Family 2: STATUS_FIELD (Lifecycle Management)
+ * **Member**: `status`
+ *
+ * **Default Values**: `'draft'`, `'available'`, `'deleted'`
+ *
+ * **Rules**:
+ * - ✓ Always present (framework adds)
+ * - ✓ Users must set value
+ * - ✓ Users can add custom values (`'reserved'`, `'sold'`)
+ * - ✗ Cannot remove default values
+ * - ✓ Draft mode (`status === 'draft'`) relaxes validation
+ *
+ * ### Family 3: FRAMEWORK_TYPES (~30 Built-in)
+ * **Available Types**:
+ * - Text: `text`, `textarea`, `email`, `tel`, `url`, `password`
+ * - Numbers: `number`, `range`
+ * - Dates: `date`, `datetime-local`, `time`, `timestamp`
+ * - Choices: `select`, `multiselect`, `radio`, `checkbox`, `combobox`, `switch`
+ * - Media: `image`, `images`, `file`
+ * - Special: `reference`, `geopoint`, `address`, `map`
+ *
+ * ### Family 4: CUSTOM_TYPES (User-Registered)
+ * **What**: Custom field types registered via `registerFieldType()`
+ *
+ * **Examples**: `repairOperations`, `ratp`, custom widgets
+ *
+ * ## Complete Example
+ *
+ * ```typescript
+ * import { defineEntity } from '@donotdev/core';
+ * import { registerFieldType } from '@donotdev/crud';
+ *
+ * // Register custom type (Family 4)
+ * registerFieldType('repairOperations', {
+ *   schema: (field) => v.array(v.object({ operation: v.string(), cost: v.number() })),
+ *   component: RepairOperationsField
+ * });
+ *
+ * // Define entity
+ * const carEntity = defineEntity({
+ *   name: 'Car',
+ *   collection: 'cars',
+ *   fields: {
+ *     // User fields using FRAMEWORK_TYPES (Family 3)
+ *     make: { type: 'text', validation: { required: true } },
+ *     year: { type: 'number' },
+ *     images: { type: 'images' },
+ *     fuelType: { type: 'select', validation: { options: [...] } },
+ *
+ *     // User field using CUSTOM_TYPES (Family 4)
+ *     repairs: { type: 'repairOperations', visibility: 'admin' },
+ *
+ *     // Extend STATUS_FIELD (Family 2)
+ *     status: {
+ *       validation: {
+ *         options: [
+ *           { value: 'reserved', label: 'Reserved' },
+ *           { value: 'sold', label: 'Sold' }
+ *         ]
+ *       }
+ *     }
+ *
+ *     // TECHNICAL_FIELDS (Family 1) auto-added by framework
+ *   }
+ * });
+ * ```
+ *
+ * **Result**:
+ * - Family 1 (Technical): `id`, `createdAt`, `updatedAt`, `createdById`, `updatedById`
+ * - Family 2 (Status): `status` with `draft/available/deleted/reserved/sold`
+ * - User fields: `make`, `year`, `images`, `fuelType`, `repairs`
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+
+/**
+ * Type-safe base fields that all entities inherit
+ * Each field has its specific type for proper TypeScript inference
+ */
+interface TypedBaseFields {
+    id: EntityField<'text'>;
+    createdAt: EntityField<'timestamp'>;
+    updatedAt: EntityField<'timestamp'>;
+    createdById: EntityField<'reference'>;
+    updatedById: EntityField<'reference'>;
+    status: EntityField<'select'>;
+}
+/**
+ * Default status options for draft/publish/delete workflow
+ * Framework provides 'draft', 'available', 'deleted' - consumers can extend
+ * Labels use translation keys (dndev:status.*) for i18n support
+ */
+declare const DEFAULT_STATUS_OPTIONS: readonly [{
+    readonly value: "draft";
+    readonly label: "dndev:status.draft";
+}, {
+    readonly value: "available";
+    readonly label: "dndev:status.available";
+}, {
+    readonly value: "deleted";
+    readonly label: "dndev:status.deleted";
+}];
+/**
+ * Default status value for new documents (published by default)
+ */
+declare const DEFAULT_STATUS_VALUE: "available";
+/**
+ * Statuses that are hidden from non-admin users
+ */
+declare const HIDDEN_STATUSES: readonly ["draft", "deleted"];
+/**
+ * Fields that are TRULY backend-generated (cannot be set by user)
+ * These are stripped from create operations - backend creates them automatically
+ *
+ * @category Field Families
+ * @constant BACKEND_GENERATED_FIELD_NAMES
+ */
+declare const BACKEND_GENERATED_FIELD_NAMES: readonly ["id", "createdAt", "updatedAt", "createdById", "updatedById"];
+/**
+ * List of technical field names that are auto-generated by the backend
+ * Includes backend-generated fields + status field
+ *
+ * These fields are optional in create schemas (backend creates them automatically).
+ * They can be updated in update operations if provided.
+ *
+ * **Note**: Status is included here for visibility/editability logic but is NOT stripped
+ * from form submissions since users MUST set it. Use BACKEND_GENERATED_FIELD_NAMES for stripping.
+ *
+ * @category Field Families
+ * @constant TECHNICAL_FIELD_NAMES
+ */
+declare const TECHNICAL_FIELD_NAMES: readonly ["id", "createdAt", "updatedAt", "createdById", "updatedById", "status"];
+/**
+ * TypeScript Helper Types for Field Families
+ * @category Field Families
+ */
+/** Type for backend-generated field names */
+type BackendGeneratedField = (typeof BACKEND_GENERATED_FIELD_NAMES)[number];
+/** Type for the status field */
+type StatusField = 'status';
+/** Type for all technical field names */
+type TechnicalField = (typeof TECHNICAL_FIELD_NAMES)[number];
+/**
+ * Type guard to check if a field name is a framework-managed field
+ * @param fieldName - Field name to check
+ * @returns True if field is in TECHNICAL_FIELD_NAMES
+ *
+ * @example
+ * ```typescript
+ * if (isFrameworkField('status')) {
+ *   // Field is framework-managed (cannot remove)
+ * }
+ * ```
+ */
+declare function isFrameworkField(fieldName: string): fieldName is TechnicalField;
+/**
+ * Type guard to check if a field is backend-generated
+ * @param fieldName - Field name to check
+ * @returns True if field is auto-generated by backend
+ *
+ * @example
+ * ```typescript
+ * if (isBackendGeneratedField('createdAt')) {
+ *   // Field is backend-generated (should be stripped on create)
+ * }
+ * ```
+ */
+declare function isBackendGeneratedField(fieldName: string): fieldName is BackendGeneratedField;
+declare const baseFields: TypedBaseFields;
+
+/**
+ * Defines an entity with validation and default configuration
+ *
+ * Automatically adds technical fields (`id`, `createdAt`, `updatedAt`, `createdById`, `updatedById`)
+ * with `visibility: 'technical'`. User-defined technical fields are merged with defaults, allowing
+ * customization (e.g., `editable: 'admin'`, custom `label`, additional `validation`).
+ *
+ * @param entity - The business entity definition
+ * @returns The validated and configured entity
+ *
+ * @example
+ * ```typescript
+ * export const productEntity = defineEntity({
+ *   name: 'Product',
+ *   collection: 'products',
+ *   fields: {
+ *     name: {
+ *       type: 'text',
+ *       visibility: 'user',
+ *       validation: { required: true, minLength: 3 }
+ *     },
+ *     // Customize technical field (optional)
+ *     createdAt: {
+ *       editable: 'admin',
+ *       label: 'Created Date'
+ *     }
+ *   },
+ *   // Override access defaults (optional)
+ *   access: { create: 'guest' }  // Public inquiry form
+ * });
+ * ```
+ *
+ * **Technical Fields:**
+ * - Automatically added: `id`, `createdAt`, `updatedAt`, `createdById`, `updatedById`, `status`
+ * - Default: `visibility: 'technical'`, read-only in edit forms
+ * - Customizable: Can override `editable`, `label`, `hint`, `validation` (merged with defaults)
+ *
+ * **Access Configuration:**
+ * - Defaults: `{ read: 'guest', create: 'admin', update: 'admin', delete: 'admin' }`
+ * - Uses role hierarchy: guest (0) < user (1) < admin (2) < super (3)
+ * - Override individual operations: `access: { create: 'guest' }` for public forms
+ * - Field visibility still applies for sensitive data filtering
+ *
+ * **Status Field (Draft/Publish/Delete):**
+ * - Auto-added with `visibility: 'admin'` and options: `['draft', 'available', 'deleted']`
+ * - Default value: `'available'` (new documents are published by default)
+ * - `draft` and `deleted` statuses hidden from non-admin users (server-side filtering)
+ * - `validation.required` on other fields only enforced when status !== 'draft'
+ * - Extend options: `status: { validation: { options: [{ value: 'sold', label: 'sold' }] } }`
+ * - Hide field: `status: { visibility: 'technical' }` if you don't want it in forms
+ *
+ * **Dropdown Options Format:**
+ * - For `select`, `multiselect`, and `radio` field types, options must be defined in `validation.options`
+ * - Options must be an array of objects with `value` (string) and `label` (string)
+ * - Labels can use i18n keys (e.g., `'entities.product.status.active'`) for translation
+ *
+ * @version 0.0.2
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+declare function defineEntity(entity: BusinessEntity): Entity;
+
+export { AUTH_EVENTS, AUTH_PARTNERS, AUTH_PARTNER_STATE, AuthUserSchema, BACKEND_GENERATED_FIELD_NAMES, BILLING_EVENTS, BREAKPOINT_RANGES, BREAKPOINT_THRESHOLDS, COMMON_TIER_CONFIGS, CONFIDENCE_LEVELS, CONSENT_CATEGORY, CONTEXTS, CheckoutSessionMetadataSchema, CreateCheckoutSessionRequestSchema, CreateCheckoutSessionResponseSchema, CustomClaimsSchema, DEFAULT_ENTITY_ACCESS, DEFAULT_ERROR_MESSAGES, DEFAULT_LAYOUT_PRESET, DEFAULT_STATUS_OPTIONS, DEFAULT_STATUS_VALUE, DEFAULT_SUBSCRIPTION, DENSITY, DoNotDevError, ENVIRONMENTS, EntityHookError, FEATURES, FEATURE_CONSENT_MATRIX, FEATURE_STATUS, FIREBASE_ERROR_MAP, FIRESTORE_ID_PATTERN, GITHUB_PERMISSION_LEVELS, HIDDEN_STATUSES, LAYOUT_PRESET, OAUTH_EVENTS, OAUTH_PARTNERS, PARTNER_ICONS, PAYLOAD_EVENTS, PERMISSIONS, PLATFORMS, PWA_ASSET_TYPES, PWA_DISPLAY_MODES, ProductDeclarationSchema, ProductDeclarationsSchema, ROUTE_SOURCES, STORAGE_SCOPES, STORAGE_TYPES, STRIPE_EVENTS, STRIPE_MODES, SUBSCRIPTION_DURATIONS, SUBSCRIPTION_STATUS, SUBSCRIPTION_TIERS, index_d as ServerUtils, SingletonManager, StripeBackConfigSchema, StripeFrontConfigSchema, StripePaymentSchema, StripeSubscriptionSchema, SubscriptionClaimsSchema, SubscriptionDataSchema, TECHNICAL_FIELD_NAMES, USER_ROLES, UserSubscriptionSchema, WebhookEventSchema, addMonths, addYears, baseFields, calculateSubscriptionEndDate, captureErrorToSentry, checkGitHubAccessSchema, clearSchemaGenerators, commonErrorCodeMappings, compactToISOString, createAsyncSingleton, createDefaultSubscriptionClaims, createDefaultUserProfile, createEntitySchema, createErrorHandler, createMetadata, createMethodProxy, createSchemas, createSingleton, createSingletonWithParams, defineEntity, deleteEntitySchema, detectErrorSource, disconnectOAuthSchema, enhanceSchema, exchangeTokenSchema, filterVisibleFields, formatDate, formatRelativeTime, generateCodeChallenge, generateCodeVerifier, generatePKCEPair, getBreakpointFromWidth, getBreakpointUtils, getCollectionName, getConnectionsSchema, getCurrentTimestamp, getEntitySchema, getRegisteredSchemaTypes, getSchemaType, getVisibleFields, getWeekFromISOString, githubPermissionSchema, githubRepoConfigSchema, grantGitHubAccessSchema, handleError, hasCustomSchemaGenerator, hasMetadata, hasRoleAccess, hasTierAccess, isAuthPartnerId, isBackendGeneratedField, isBreakpoint, isCompactDateString, isFieldVisible, isFrameworkField, isOAuthPartnerId, isPKCESupported, isoToCompactString, lazyImport, listEntitiesSchema, mapToDoNotDevError, maybeTranslate, normalizeToISOString, overrideFeatures, overridePaymentModes, overridePermissions, overrideSubscriptionStatus, overrideSubscriptionTiers, overrideUserRoles, parseDate, parseDateToNoonUTC, parseISODate, parseServerCookie, refreshTokenSchema, registerSchemaGenerator, registerUniqueConstraintValidator, revokeGitHubAccessSchema, showNotification, timestampToISOString, toDateOnly, toISOString, translateArray, translateArrayRange, translateArrayWithIndices, translateObjectArray, updateEntitySchema, updateMetadata, validateAuthPartners, validateAuthSchemas, validateAuthUser, validateBillingSchemas, validateCheckoutSessionMetadata, validateCodeChallenge, validateCodeVerifier, validateCreateCheckoutSessionRequest, validateCreateCheckoutSessionResponse, validateCustomClaims, validateDates, validateDocument, validateEnvVar, validateMetadata, validateOAuthPartners, validateStripeBackConfig, validateStripeFrontConfig, validateSubscriptionClaims, validateSubscriptionData, validateUniqueFields, validateUrl, validateUserSubscription, validateWebhookEvent, withErrorHandling, withGracefulDegradation };
+export type { AccountLinkResult, AccountLinkingInfo, AdminCheckHookResult, AdminClaims, AggregateConfig, AggregateFilterOperator, AggregateOperation, AggregateRequest, AggregateResponse, ApiResponse, AppConfig, AppCookieCategories, AppMetadata, AppProvidersProps, AssetsPluginConfig, AttemptRecord, AuthAPI, AuthActions, AuthConfig, AuthContextValue, AuthCoreHookResult, AuthError, AuthEventData, AuthEventKey, AuthEventName, AuthMethod, AuthPartner, AuthPartnerButton, AuthPartnerHookResult, AuthPartnerId, AuthPartnerResult, AuthPartnerState, AuthProvider, AuthProviderProps, AuthRedirectHookResult, AuthRedirectOperation, AuthRedirectOptions, AuthResult, AuthState, AuthStateStore, AuthStatus, AuthTokenHookResult, AuthUser, BackendGeneratedField, BaseActions, BaseCredentials, BaseDocument, BaseEntityFields, BasePartnerState, BaseState, BaseStoreActions, BaseStoreState, BaseUserProfile, BasicUserInfo, BillingAPI, BillingAdapter, BillingErrorCode, BillingEvent, BillingEventData, BillingEventKey, BillingEventName, BillingProvider, BillingProviderConfig, BillingRedirectOperation, Breakpoint, BreakpointUtils, BusinessEntity, CachedError, CanAPI, CheckGitHubAccessRequest, CheckoutMode, CheckoutOptions, CheckoutSessionMetadata, ColumnDef, CommonSubscriptionFeatures, CommonTranslations, ConfidenceLevel, ConsentAPI, ConsentActions, ConsentCategory, ConsentState, Context, CookieOptions, CreateCheckoutSessionRequest, CreateCheckoutSessionResponse, CreateEntityData, CreateEntityRequest, CreateEntityResponse, CrudAPI, CrudConfig, CustomClaims, CustomSchemaGenerator, CustomStoreConfig, DateFormatOptions, DateFormatPreset, DateValue, DeleteEntityRequest, DeleteEntityResponse, Density, DnDevLayoutProps, DnDevOverride, DndevFrameworkConfig, DoNotDevCookieCategories, DynamicFormRule, Editable, EffectiveConnectionType, EmailVerificationHookResult, EmailVerificationStatus, Entity, EntityAccessConfig, EntityAccessDefaults, EntityField, EntityHookErrors, EntityMetadata, EntityTemplateProps, EntityTranslations, EnvironmentMode, ErrorCode, ErrorHandlerConfig, ErrorHandlerFunction, ErrorSeverity, ErrorSource, ExchangeTokenParams, ExchangeTokenRequest, FaviconConfig, Feature, FeatureAccessHookResult, FeatureConsentRequirement, FeatureHookResult, FeatureId, FeatureName, FeatureStatus, FeaturesConfig, FeaturesPluginConfig, FeaturesRequiringAnyConsent, FeaturesRequiringConsent, FeaturesWithoutConsent, FieldCondition, FieldType, FieldTypeToValue, FileAsset, FirebaseCallOptions, FirebaseConfig, FirestoreTimestamp, FirestoreUniqueConstraintValidator, FooterConfig, FooterZoneConfig, FormConfig, FormStep, FunctionCallConfig, FunctionCallContext, FunctionCallOptions, FunctionCallResult, FunctionClient, FunctionClientFactoryOptions, FunctionDefaults, FunctionEndpoint, FunctionError, FunctionLoader, FunctionMemory, FunctionMeta, FunctionPlatform, FunctionResponse, FunctionSchema, FunctionSchemas, FunctionSystem, FunctionTrigger, FunctionsConfig, GetCustomClaimsResponse, GetEntityData, GetEntityRequest, GetEntityResponse, GetUserAuthStatusResponse, GitHubPermission, GitHubRepoConfig, GrantGitHubAccessRequest, GroupByDefinition, HandleErrorOptions, HeaderZoneConfig, I18nConfig, I18nPluginConfig, I18nProviderProps, ID, INetworkManager, IStorageManager, IStorageStrategy, Invoice, InvoiceItem, LanguageInfo, LayoutConfig, LayoutInput, LayoutPreset, LegalCompanyInfo, LegalConfig, LegalContactInfo, LegalDirectorInfo, LegalHostingInfo, LegalJurisdictionInfo, LegalSectionsConfig, LegalWebsiteInfo, ListEntitiesRequest, ListEntitiesResponse, ListEntityData, ListOptions, ListResponse, LoadingActions, LoadingState, MergedBarConfig, MetricDefinition, MobileBehaviorConfig, ModalActions, ModalState, MutationResponse, NavigationRoute, NetworkCheckConfig, NetworkConnectionType, NetworkReconnectCallback, NetworkState, NetworkStatus, NetworkStatusHookResult, OAuthAPI, OAuthApiRequestOptions, OAuthCallbackHookResult, OAuthConnection, OAuthConnectionInfo, OAuthConnectionRequest, OAuthConnectionStatus, OAuthCredentials, OAuthEventData, OAuthEventKey, OAuthEventName, OAuthPartner, OAuthPartnerButton, OAuthPartnerHookResult, OAuthPartnerId, OAuthPartnerResult, OAuthPartnerState, OAuthPurpose, OAuthRedirectOperation, OAuthRefreshRequest, OAuthRefreshResponse, OAuthResult, OAuthStoreActions, OAuthStoreState, Observable, OperationSchemas, OrderByClause, PWAAssetType, PWADisplayMode, PWAPluginConfig, PageAuth, PageMeta, PaginationOptions, PartnerButton, PartnerConnectionState, PartnerIconId, PartnerId, PartnerResult, PartnerType, PayloadCacheEventData, PayloadDocument, PayloadDocumentEventData, PayloadEventKey, PayloadEventName, PayloadGlobalEventData, PayloadMediaEventData, PayloadPageRegenerationEventData, PayloadRequest, PayloadUserEventData, PaymentEventData, PaymentMethod, PaymentMethodType, PaymentMode, Permission, Picture, Platform, PresetConfig, PresetRegistry, ProcessPaymentSuccessRequest, ProcessPaymentSuccessResponse, ProductDeclaration, ProviderInstances, QueryConfig, RateLimitConfig, RateLimitManager, RateLimitResult, RateLimitState, RateLimiter, ReadCallback, RedirectOperation, RedirectOverlayActions, RedirectOverlayConfig, RedirectOverlayPhase, RedirectOverlayState, Reference, RefreshSubscriptionRequest, RefreshSubscriptionResponse, RemoveCustomClaimsResponse, ResolvedLayoutConfig, RevokeGitHubAccessRequest, RouteMeta, RouteSource, RoutesPluginConfig, SEOConfig, SchemaMetadata, SchemaWithVisibility, SetCustomClaimsResponse, SidebarZoneConfig, SlotContent, StatusField, StorageOptions, StorageScope, StorageType, Store, StoreApi, StripeBackConfig, StripeCheckoutRequest, StripeCheckoutResponse, StripeCheckoutSessionEventData, StripeConfig, StripeCustomer, StripeCustomerEventData, StripeEventData, StripeEventKey, StripeEventName, StripeFrontConfig, StripeInvoice, StripeInvoiceEventData, StripePayment, StripePaymentIntentEventData, StripePaymentMethod, StripePrice, StripeProduct, StripeProvider, StripeSubscription, StripeSubscriptionData, StripeWebhookEvent, StripeWebhookEventData, Subscription, SubscriptionClaims, SubscriptionConfig, SubscriptionData, SubscriptionDuration, SubscriptionEventData, SubscriptionHookResult, SubscriptionInfo, SubscriptionStatus, SubscriptionTier, SupportedLanguage, TechnicalField, ThemeActions, ThemeInfo, ThemeMode, ThemeState, ThemesPluginConfig, TierAccessHookResult, Timestamp, TokenInfo, TokenResponse, TokenState, TokenStatus, TranslationOptions, TranslationResource, TypedBaseFields, UIFieldOptions, UniqueConstraintValidator, UnsubscribeFn, UpdateEntityData, UpdateEntityRequest, UpdateEntityResponse, UseFunctionsMutationOptions, UseFunctionsQueryOptions, UseTranslationOptionsEnhanced, UserContext, UserProfile, UserProviderData, UserRole, UserSubscription, ValidationRules, ValueTypeForField, Visibility, WebhookEvent, WebhookEventData, WhereClause, WhereOperator, WithMetadata, dndevSchema };