@gzl10/nexus-sdk 0.17.0 → 0.18.0

package/dist/{chunk-UBKKV4XF.js → chunk-WHLUKKQO.js}

@@ -617,6 +617,7 @@ function useLocalizedField(config) {
     input: "text",
     hint,
     required,
+    defaultValue: {},
     db: {
       type: "json",
       nullable: !required

package/dist/collection/index.d.ts

@@ -1,5 +1,5 @@
-import { L as LocalizedString, b as FieldDefinition } from '../field-ByR7eH7v.js';
-import { d as CollectionEntityDefinition, f as DagEntityDefinition, e as EventEntityDefinition, aK as RolePermission } from '../entity-DkGTh6I1.js';
+import { L as LocalizedString, b as FieldDefinition } from '../field-Bs1fIux8.js';
+import { d as CollectionEntityDefinition, f as DagEntityDefinition, e as EventEntityDefinition, aK as RolePermission } from '../entity-B5WrLI1H.js';
 import 'knex';
 import 'express';
 import 'pino';

package/dist/collection/index.js

@@ -17,7 +17,7 @@ import {
   useTextareaField,
   useUrlField,
   userIdField
-} from "../chunk-UBKKV4XF.js";
+} from "../chunk-WHLUKKQO.js";
 
 // src/collection/helpers.ts
 var polymorphicCaslPermissions = {

package/dist/{entity-DkGTh6I1.d.ts → entity-B5WrLI1H.d.ts}

@@ -1,6 +1,6 @@
 import { Knex } from 'knex';
 import { Request, Router, RequestHandler, Response } from 'express';
-import { L as LocalizedString, b as FieldDefinition, E as EntityIndex, F as FieldCondition } from './field-ByR7eH7v.js';
+import { L as LocalizedString, b as FieldDefinition, j as LocaleConfig, E as EntityIndex, F as FieldCondition } from './field-Bs1fIux8.js';
 import { Logger } from 'pino';
 
 /**
@@ -1385,6 +1385,8 @@ interface DbContext {
     getPagination: (query?: EntityQuery) => PaginationParamsWithOffset;
     buildPaginatedResult: <T>(items: T[], total: number, pagination: PaginationParamsWithOffset) => PaginatedResult<T>;
     getKnex: (adapter?: string) => Knex;
+    /** Run full seed for a module (manifest seed + entity auto-seed). Injected from db layer. */
+    seedModule: (mod: ModuleManifest) => Promise<boolean>;
 }
 /**
  * Runtime namespace.
@@ -1475,6 +1477,8 @@ interface ModuleContext {
     /** Semantic event API for cross-module communication (notify/query/command). */
     events: ContextEvents;
     createRouter: () => Router;
+    /** Supported locales for the platform */
+    locales: LocaleConfig[];
 }
 /**
  * HTTP method for custom routes
@@ -1519,6 +1523,86 @@ interface CustomRouteDefinition {
     operationId?: string;
     tags?: string[];
 }
+/**
+ * Seed context passed to onSeed hook.
+ * Provides typed helpers for seeding data without direct DB access.
+ *
+ * Note: masters.register() is lazy (data flushed after onSeed completes).
+ * All other methods (roles.add, users.add, plugin().entity().upsert, raw) are eager.
+ */
+interface SeedContext {
+    /** Register master reference data. Lazy: flushed after onSeed completes. */
+    masters: {
+        register(type: string, entries: Array<{
+            code: string;
+            label: string | {
+                en?: string;
+                es?: string;
+                [key: string]: string | undefined;
+            };
+            order?: number;
+            is_active?: boolean;
+            metadata?: Record<string, unknown>;
+        }>, options?: {
+            seed?: 'if-empty' | 'always';
+        }): void;
+    };
+    /**
+     * Add roles to the system. Eager: inserts immediately. Idempotent by name.
+     *
+     * Optional `permissions` map assigns CASL abilities to the role.
+     * Keys are subject names (case-insensitive: 'masters' = 'Masters').
+     * Values are action arrays.
+     *
+     * Core subjects: Masters, Users, Roles, Auth, Mail, Storage, System.
+     * Plugin subjects: documented in each plugin's llms.txt.
+     *
+     * @example
+     * ```typescript
+     * await seed.roles.add({
+     *   name: 'SALES',
+     *   description: { en: 'Sales team' },
+     *   permissions: {
+     *     'masters': ['read'],
+     *     'contacts': ['read', 'create', 'update'],
+     *   }
+     * })
+     * ```
+     */
+    roles: {
+        add(role: {
+            name: string;
+            description?: string | {
+                en?: string;
+                es?: string;
+                [key: string]: string | undefined;
+            };
+            is_system?: boolean;
+            /** CASL permissions. Keys: subject (case-insensitive). Values: action arrays. */
+            permissions?: Record<string, Array<'read' | 'create' | 'update' | 'delete' | 'manage' | 'execute'>>;
+        }): Promise<void>;
+    };
+    /** Add users to the system. Eager: inserts immediately. Idempotent by email. */
+    users: {
+        add(user: {
+            email: string;
+            password: string;
+            name?: string;
+            type?: 'human' | 'bot' | 'service';
+            roles?: string[];
+        }): Promise<void>;
+    };
+    /** Access plugin entities for seeding. Resolves table prefix automatically. */
+    plugin(name: string): {
+        entity(name: string): {
+            upsert(data: Record<string, unknown>[], options?: {
+                key?: string;
+            }): Promise<number>;
+        };
+    };
+    /** Raw table insert (escape hatch). Returns number of rows inserted. */
+    raw(table: string, data: Record<string, unknown> | Record<string, unknown>[]): Promise<number>;
+}
 
 /**
  * Entity definition types - discriminated union for all entity types
@@ -1693,10 +1777,16 @@ interface BaseEntityDefinition {
     order?: number;
     /** UI display mode */
     displayMode?: DisplayMode;
+    /** Restrict available display modes. If omitted, auto-detected from entity config. */
+    availableDisplayModes?: DisplayMode[];
     /** Field name to group by in board/list/masonry displays */
     groupBy?: string;
     /** Field name for secondary grouping (collapsible) */
     subgroupBy?: string;
+    /** Explicit list of fields eligible for grouping. If omitted, auto-detected from field input types. */
+    groupableFields?: string[];
+    /** Subset of groupableFields where drag between board columns is allowed. Default: all groupable. */
+    columnDragFields?: string[];
     /** Date field for calendar start (enables calendar display) */
     calendarFrom?: string;
     /** Date field for calendar end (range display) */
@@ -1959,4 +2049,4 @@ type TempEntityDefinition = Omit<CollectionEntityDefinition, 'type'> & {
  */
 type EntityDefinition = CollectionEntityDefinition | SingleEntityDefinition | ExternalEntityDefinition | VirtualEntityDefinition | ComputedEntityDefinition | ViewEntityDefinition | ReferenceEntityDefinition | TreeEntityDefinition | DagEntityDefinition | EventEntityDefinition;
 
-export { type CreateEntityServiceOptions as $, type ActionDefinition as A, type BaseAuthRequest as B, type ConfirmConfig as C, type DisplayMode as D, type EntityType as E, type CacheStats as F, type CaslAction as G, type CategoryMeta as H, type CollectionEntityService as I, type ComputedEntityService as J, type ConfigContext as K, type ConfigEntityDefinition as L, type ModuleContext as M, type ConfigEntityService as N, type ConfirmationType as O, type PostActionPipeline as P, type ContextCrypto as Q, type RealtimeMode as R, type SingleEntityDefinition as S, type TreeEntityDefinition as T, type ContextEvents as U, type ViewEntityDefinition as V, type ContextEventsHub as W, type ContextHelpers as X, type ContextSocket as Y, type CoreContext as Z, type CoreServices as _, type Category as a, type ServicesContext as a$, type CustomRouteDefinition as a0, DEFAULT_TENANT_ID as a1, type DagEntityService as a2, type DatabaseAdapter as a3, type DbContext as a4, type EngineContext as a5, type EntityAction as a6, type EntityCaslConfig as a7, type EntityChangePayload as a8, type EntityController as a9, type PluginConfigSchema as aA, type PluginEnvVar as aB, type PluginManifest as aC, type PluginSetupInfo as aD, type PostAction as aE, type RateLimitOptions as aF, type ReferenceEntityDefinition as aG, type ReferenceEntityService as aH, type RegisterPluginOptions as aI, type RetentionPolicy as aJ, type RolePermission as aK, type RouteParameterDefinition as aL, type RouteResponseDefinition as aM, type RuntimeContext as aN, type SSEHelper as aO, type SSEOptions as aP, type SSESender as aQ, type SchemaAdapter as aR, type SchemaAlterTableBuilder as aS, type SchemaColumnBuilder as aT, type SchemaColumnInfo as aU, type SchemaForeignKeyBuilder as aV, type SchemaTableBuilder as aW, type ScopedCacheManager as aX, type SeedConfig as aY, type SendMailOptions as aZ, type SendMailResult as a_, type EntityHandler as aa, type EntityQuery as ab, type EntityRealtimeEmits as ac, type EntityRealtimeEvents as ad, type EntityServiceHooks as ae, type EventEmitterLike as af, type EventEntityService as ag, type ExternalEntityDefinition as ah, type ExternalEntityService as ai, type FilterOperators as aj, type FilterValue as ak, type ForbiddenErrorConstructor as al, type ForbiddenErrorInstance as am, type HttpMethod as an, type LoggerReporter as ao, type ManagedCache as ap, type ModuleAbilities as aq, type ModuleManifest as ar, type ModuleMiddlewares as as, type ModuleRequirements as at, type PageDefinition as au, type PageType as av, type PaginatedResult as aw, type PaginationParams as ax, type PaginationParamsWithOffset as ay, type PluginConfigField as az, type PageDefinitionDTO as b, type SharedEntityProperties as b0, type SingleEntityService as b1, type SocketIOBroadcastOperator as b2, type SocketIOServer as b3, type TempEntityDefinition as b4, type TempEntityService as b5, type TempRetentionPolicy as b6, type TreeEntityService as b7, type TreeNode as b8, type TypedEntityQuery as b9, type ValidateSchemas as ba, type ValidationDetail as bb, type ValidationSchema as bc, type ViewEntityService as bd, type VirtualEntityDefinition as be, type VirtualEntityService as bf, type WidgetDefinition as bg, type WidgetLayout as bh, entityRoom as bi, type ComputedEntityDefinition as c, type CollectionEntityDefinition as d, type EventEntityDefinition as e, type DagEntityDefinition as f, type EntityDefinition as g, type AbilityLike as h, type ActionEntityService as i, type ActionInjection as j, type AdaptersContext as k, type AppManifest as l, type AuthRequest as m, type BaseEntityService as n, type BaseMailService as o, type BaseRolesService as p, type BaseUser as q, type BaseUsersService as r, type BatchLogEntry as s, type BatchProgressEvent as t, type BridgeRule as u, type BridgeTarget as v, CATEGORIES as w, CATEGORY_ORDER as x, type CacheManagerContract as y, type CacheOptions as z };
+export { type CreateEntityServiceOptions as $, type ActionDefinition as A, type BaseAuthRequest as B, type ConfirmConfig as C, type DisplayMode as D, type EntityType as E, type CacheStats as F, type CaslAction as G, type CategoryMeta as H, type CollectionEntityService as I, type ComputedEntityService as J, type ConfigContext as K, type ConfigEntityDefinition as L, type ModuleContext as M, type ConfigEntityService as N, type ConfirmationType as O, type PostActionPipeline as P, type ContextCrypto as Q, type RealtimeMode as R, type SingleEntityDefinition as S, type TreeEntityDefinition as T, type ContextEvents as U, type ViewEntityDefinition as V, type ContextEventsHub as W, type ContextHelpers as X, type ContextSocket as Y, type CoreContext as Z, type CoreServices as _, type Category as a, type SendMailResult as a$, type CustomRouteDefinition as a0, DEFAULT_TENANT_ID as a1, type DagEntityService as a2, type DatabaseAdapter as a3, type DbContext as a4, type EngineContext as a5, type EntityAction as a6, type EntityCaslConfig as a7, type EntityChangePayload as a8, type EntityController as a9, type PluginConfigSchema as aA, type PluginEnvVar as aB, type PluginManifest as aC, type PluginSetupInfo as aD, type PostAction as aE, type RateLimitOptions as aF, type ReferenceEntityDefinition as aG, type ReferenceEntityService as aH, type RegisterPluginOptions as aI, type RetentionPolicy as aJ, type RolePermission as aK, type RouteParameterDefinition as aL, type RouteResponseDefinition as aM, type RuntimeContext as aN, type SSEHelper as aO, type SSEOptions as aP, type SSESender as aQ, type SchemaAdapter as aR, type SchemaAlterTableBuilder as aS, type SchemaColumnBuilder as aT, type SchemaColumnInfo as aU, type SchemaForeignKeyBuilder as aV, type SchemaTableBuilder as aW, type ScopedCacheManager as aX, type SeedConfig as aY, type SeedContext as aZ, type SendMailOptions as a_, type EntityHandler as aa, type EntityQuery as ab, type EntityRealtimeEmits as ac, type EntityRealtimeEvents as ad, type EntityServiceHooks as ae, type EventEmitterLike as af, type EventEntityService as ag, type ExternalEntityDefinition as ah, type ExternalEntityService as ai, type FilterOperators as aj, type FilterValue as ak, type ForbiddenErrorConstructor as al, type ForbiddenErrorInstance as am, type HttpMethod as an, type LoggerReporter as ao, type ManagedCache as ap, type ModuleAbilities as aq, type ModuleManifest as ar, type ModuleMiddlewares as as, type ModuleRequirements as at, type PageDefinition as au, type PageType as av, type PaginatedResult as aw, type PaginationParams as ax, type PaginationParamsWithOffset as ay, type PluginConfigField as az, type PageDefinitionDTO as b, type ServicesContext as b0, type SharedEntityProperties as b1, type SingleEntityService as b2, type SocketIOBroadcastOperator as b3, type SocketIOServer as b4, type TempEntityDefinition as b5, type TempEntityService as b6, type TempRetentionPolicy as b7, type TreeEntityService as b8, type TreeNode as b9, type TypedEntityQuery as ba, type ValidateSchemas as bb, type ValidationDetail as bc, type ValidationSchema as bd, type ViewEntityService as be, type VirtualEntityDefinition as bf, type VirtualEntityService as bg, type WidgetDefinition as bh, type WidgetLayout as bi, entityRoom as bj, type ComputedEntityDefinition as c, type CollectionEntityDefinition as d, type EventEntityDefinition as e, type DagEntityDefinition as f, type EntityDefinition as g, type AbilityLike as h, type ActionEntityService as i, type ActionInjection as j, type AdaptersContext as k, type AppManifest as l, type AuthRequest as m, type BaseEntityService as n, type BaseMailService as o, type BaseRolesService as p, type BaseUser as q, type BaseUsersService as r, type BatchLogEntry as s, type BatchProgressEvent as t, type BridgeRule as u, type BridgeTarget as v, CATEGORIES as w, CATEGORY_ORDER as x, type CacheManagerContract as y, type CacheOptions as z };

package/dist/{field-ByR7eH7v.d.ts → field-Bs1fIux8.d.ts}

@@ -15,6 +15,19 @@
 type LocalizedString = string | ({
     en: string;
 } & Record<string, string>);
+/** Configuration for a supported locale */
+interface LocaleConfig {
+    /** ISO 639-1 code (e.g. 'en', 'es', 'fr') */
+    code: string;
+    /** Human-readable label (e.g. 'English', 'Español') */
+    label: string;
+    /** Is this the fallback locale? Only one should be true. Default: false */
+    fallback?: boolean;
+}
+/** Default supported locales — used when no config is provided */
+declare const DEFAULT_LOCALES: LocaleConfig[];
+/** Get the fallback locale code from a locales array */
+declare function getFallbackLocale(locales: LocaleConfig[]): string;
 /**
  * Auth provider information for dynamic login buttons.
  * Plugins register this info so the UI can render buttons without knowing provider details.
@@ -63,7 +76,7 @@ interface AuthProviderService {
  * @param locale - The target locale (e.g., 'en', 'es')
  * @returns The resolved string for the given locale
  */
-declare function resolveLocalized(value: LocalizedString | undefined, locale: string): string;
+declare function resolveLocalized(value: LocalizedString | undefined, locale: string, fallback?: string): string;
 /**
  * Gets the appropriate label based on count (pluralization).
  * Returns labelPlural for count !== 1, label otherwise.
@@ -375,4 +388,4 @@ declare function refOptions(module: string, entityOrLabel?: string, labelField?:
     labelField: string;
 };
 
-export { type AuthProviderInfo as A, type ConditionalBoolean as C, type DbType as D, type EntityIndex as E, type FieldCondition as F, type InputType as I, type LocalizedString as L, type FieldMeta as a, type FieldDefinition as b, type AuthProviderService as c, type FieldDbConfig as d, type FieldOptions as e, type FieldRelation as f, type FieldStorageConfig as g, type FieldValidationConfig as h, getCountLabel as i, resolveLocalized as j, refOptions as r };
+export { type AuthProviderInfo as A, type ConditionalBoolean as C, DEFAULT_LOCALES as D, type EntityIndex as E, type FieldCondition as F, type InputType as I, type LocalizedString as L, type FieldMeta as a, type FieldDefinition as b, type AuthProviderService as c, type DbType as d, type FieldDbConfig as e, type FieldOptions as f, type FieldRelation as g, type FieldStorageConfig as h, type FieldValidationConfig as i, type LocaleConfig as j, getCountLabel as k, getFallbackLocale as l, resolveLocalized as m, refOptions as r };

package/dist/fields/index.d.ts

@@ -1,4 +1,4 @@
-import { b as FieldDefinition } from '../field-ByR7eH7v.js';
+import { b as FieldDefinition } from '../field-Bs1fIux8.js';
 import { MasterType } from '../masters/index.js';
 
 /**

package/dist/fields/index.js

@@ -35,7 +35,7 @@ import {
   useTextareaField,
   useUrlField,
   userIdField
-} from "../chunk-UBKKV4XF.js";
+} from "../chunk-WHLUKKQO.js";
 export {
   auditFields,
   idField,

package/dist/index.d.ts

@@ -2,10 +2,10 @@ import { Knex } from 'knex';
 export { Knex } from 'knex';
 import { Request, Response } from 'express';
 export { CookieOptions, NextFunction, Request, RequestHandler, Response, Router } from 'express';
-import { C as ConfirmConfig, P as PostActionPipeline, a as Category, E as EntityType, D as DisplayMode, R as RealtimeMode, b as PageDefinitionDTO, c as ComputedEntityDefinition, d as CollectionEntityDefinition, e as EventEntityDefinition, V as ViewEntityDefinition, T as TreeEntityDefinition, f as DagEntityDefinition, g as EntityDefinition, S as SingleEntityDefinition, A as ActionDefinition, M as ModuleContext } from './entity-DkGTh6I1.js';
-export { h as AbilityLike, i as ActionEntityService, j as ActionInjection, k as AdaptersContext, l as AppManifest, m as AuthRequest, B as BaseAuthRequest, n as BaseEntityService, o as BaseMailService, p as BaseRolesService, q as BaseUser, r as BaseUsersService, s as BatchLogEntry, t as BatchProgressEvent, u as BridgeRule, v as BridgeTarget, w as CATEGORIES, x as CATEGORY_ORDER, y as CacheManagerContract, z as CacheOptions, F as CacheStats, G as CaslAction, H as CategoryMeta, I as CollectionEntityService, J as ComputedEntityService, K as ConfigContext, L as ConfigEntityDefinition, N as ConfigEntityService, O as ConfirmationType, Q as ContextCrypto, U as ContextEvents, W as ContextEventsHub, X as ContextHelpers, Y as ContextSocket, Z as CoreContext, _ as CoreServices, $ as CreateEntityServiceOptions, a0 as CustomRouteDefinition, a1 as DEFAULT_TENANT_ID, a2 as DagEntityService, a3 as DatabaseAdapter, a4 as DbContext, a5 as EngineContext, a6 as EntityAction, a7 as EntityCaslConfig, a8 as EntityChangePayload, a9 as EntityController, aa as EntityHandler, ab as EntityQuery, ac as EntityRealtimeEmits, ad as EntityRealtimeEvents, ae as EntityServiceHooks, af as EventEmitterLike, ag as EventEntityService, ah as ExternalEntityDefinition, ai as ExternalEntityService, aj as FilterOperators, ak as FilterValue, al as ForbiddenErrorConstructor, am as ForbiddenErrorInstance, an as HttpMethod, ao as LoggerReporter, ap as ManagedCache, aq as ModuleAbilities, ar as ModuleManifest, as as ModuleMiddlewares, at as ModuleRequirements, au as PageDefinition, av as PageType, aw as PaginatedResult, ax as PaginationParams, ay as PaginationParamsWithOffset, az as PluginConfigField, aA as PluginConfigSchema, aB as PluginEnvVar, aC as PluginManifest, aD as PluginSetupInfo, aE as PostAction, aF as RateLimitOptions, aG as ReferenceEntityDefinition, aH as ReferenceEntityService, aI as RegisterPluginOptions, aJ as RetentionPolicy, aK as RolePermission, aL as RouteParameterDefinition, aM as RouteResponseDefinition, aN as RuntimeContext, aO as SSEHelper, aP as SSEOptions, aQ as SSESender, aR as SchemaAdapter, aS as SchemaAlterTableBuilder, aT as SchemaColumnBuilder, aU as SchemaColumnInfo, aV as SchemaForeignKeyBuilder, aW as SchemaTableBuilder, aX as ScopedCacheManager, aY as SeedConfig, aZ as SendMailOptions, a_ as SendMailResult, a$ as ServicesContext, b0 as SharedEntityProperties, b1 as SingleEntityService, b2 as SocketIOBroadcastOperator, b3 as SocketIOServer, b4 as TempEntityDefinition, b5 as TempEntityService, b6 as TempRetentionPolicy, b7 as TreeEntityService, b8 as TreeNode, b9 as TypedEntityQuery, ba as ValidateSchemas, bb as ValidationDetail, bc as ValidationSchema, bd as ViewEntityService, be as VirtualEntityDefinition, bf as VirtualEntityService, bg as WidgetDefinition, bh as WidgetLayout, bi as entityRoom } from './entity-DkGTh6I1.js';
-import { L as LocalizedString, F as FieldCondition, I as InputType, a as FieldMeta, b as FieldDefinition } from './field-ByR7eH7v.js';
-export { A as AuthProviderInfo, c as AuthProviderService, C as ConditionalBoolean, D as DbType, E as EntityIndex, d as FieldDbConfig, e as FieldOptions, f as FieldRelation, g as FieldStorageConfig, h as FieldValidationConfig, i as getCountLabel, r as refOptions, j as resolveLocalized } from './field-ByR7eH7v.js';
+import { C as ConfirmConfig, P as PostActionPipeline, a as Category, E as EntityType, D as DisplayMode, R as RealtimeMode, b as PageDefinitionDTO, c as ComputedEntityDefinition, d as CollectionEntityDefinition, e as EventEntityDefinition, V as ViewEntityDefinition, T as TreeEntityDefinition, f as DagEntityDefinition, g as EntityDefinition, S as SingleEntityDefinition, A as ActionDefinition, M as ModuleContext } from './entity-B5WrLI1H.js';
+export { h as AbilityLike, i as ActionEntityService, j as ActionInjection, k as AdaptersContext, l as AppManifest, m as AuthRequest, B as BaseAuthRequest, n as BaseEntityService, o as BaseMailService, p as BaseRolesService, q as BaseUser, r as BaseUsersService, s as BatchLogEntry, t as BatchProgressEvent, u as BridgeRule, v as BridgeTarget, w as CATEGORIES, x as CATEGORY_ORDER, y as CacheManagerContract, z as CacheOptions, F as CacheStats, G as CaslAction, H as CategoryMeta, I as CollectionEntityService, J as ComputedEntityService, K as ConfigContext, L as ConfigEntityDefinition, N as ConfigEntityService, O as ConfirmationType, Q as ContextCrypto, U as ContextEvents, W as ContextEventsHub, X as ContextHelpers, Y as ContextSocket, Z as CoreContext, _ as CoreServices, $ as CreateEntityServiceOptions, a0 as CustomRouteDefinition, a1 as DEFAULT_TENANT_ID, a2 as DagEntityService, a3 as DatabaseAdapter, a4 as DbContext, a5 as EngineContext, a6 as EntityAction, a7 as EntityCaslConfig, a8 as EntityChangePayload, a9 as EntityController, aa as EntityHandler, ab as EntityQuery, ac as EntityRealtimeEmits, ad as EntityRealtimeEvents, ae as EntityServiceHooks, af as EventEmitterLike, ag as EventEntityService, ah as ExternalEntityDefinition, ai as ExternalEntityService, aj as FilterOperators, ak as FilterValue, al as ForbiddenErrorConstructor, am as ForbiddenErrorInstance, an as HttpMethod, ao as LoggerReporter, ap as ManagedCache, aq as ModuleAbilities, ar as ModuleManifest, as as ModuleMiddlewares, at as ModuleRequirements, au as PageDefinition, av as PageType, aw as PaginatedResult, ax as PaginationParams, ay as PaginationParamsWithOffset, az as PluginConfigField, aA as PluginConfigSchema, aB as PluginEnvVar, aC as PluginManifest, aD as PluginSetupInfo, aE as PostAction, aF as RateLimitOptions, aG as ReferenceEntityDefinition, aH as ReferenceEntityService, aI as RegisterPluginOptions, aJ as RetentionPolicy, aK as RolePermission, aL as RouteParameterDefinition, aM as RouteResponseDefinition, aN as RuntimeContext, aO as SSEHelper, aP as SSEOptions, aQ as SSESender, aR as SchemaAdapter, aS as SchemaAlterTableBuilder, aT as SchemaColumnBuilder, aU as SchemaColumnInfo, aV as SchemaForeignKeyBuilder, aW as SchemaTableBuilder, aX as ScopedCacheManager, aY as SeedConfig, aZ as SeedContext, a_ as SendMailOptions, a$ as SendMailResult, b0 as ServicesContext, b1 as SharedEntityProperties, b2 as SingleEntityService, b3 as SocketIOBroadcastOperator, b4 as SocketIOServer, b5 as TempEntityDefinition, b6 as TempEntityService, b7 as TempRetentionPolicy, b8 as TreeEntityService, b9 as TreeNode, ba as TypedEntityQuery, bb as ValidateSchemas, bc as ValidationDetail, bd as ValidationSchema, be as ViewEntityService, bf as VirtualEntityDefinition, bg as VirtualEntityService, bh as WidgetDefinition, bi as WidgetLayout, bj as entityRoom } from './entity-B5WrLI1H.js';
+import { L as LocalizedString, F as FieldCondition, I as InputType, a as FieldMeta, b as FieldDefinition } from './field-Bs1fIux8.js';
+export { A as AuthProviderInfo, c as AuthProviderService, C as ConditionalBoolean, D as DEFAULT_LOCALES, d as DbType, E as EntityIndex, e as FieldDbConfig, f as FieldOptions, g as FieldRelation, h as FieldStorageConfig, i as FieldValidationConfig, j as LocaleConfig, k as getCountLabel, l as getFallbackLocale, r as refOptions, m as resolveLocalized } from './field-Bs1fIux8.js';
 import 'pino';
 
 /** Webhook configuration record */
@@ -178,10 +178,9 @@ interface EntityDefinitionDTO {
         label: string;
     }>;
     /** Fields eligible for grouping (select, boolean, relation, tags) */
-    groupableFields?: Array<{
-        value: string;
-        label: string;
-    }>;
+    groupableFields?: string[];
+    /** Subset of groupableFields where drag between board columns is allowed (default: all) */
+    columnDragFields?: string[];
     /** Default groupBy field from entity definition */
     groupBy?: string;
     /** Default subgroupBy field from entity definition */
@@ -336,6 +335,12 @@ interface CapabilitiesDTO {
     version: string;
     /** 3-char codes of registered plugins */
     plugins: string[];
+    /** Supported locales for the platform */
+    locales: Array<{
+        code: string;
+        label: string;
+        fallback?: boolean;
+    }>;
 }
 
 /** Status of a ticket as seen by the end user */

package/dist/index.js

@@ -1,8 +1,15 @@
 // src/types/localization.ts
-function resolveLocalized(value, locale) {
+var DEFAULT_LOCALES = [
+  { code: "en", label: "English", fallback: true },
+  { code: "es", label: "Espa\xF1ol" }
+];
+function getFallbackLocale(locales) {
+  return locales.find((l) => l.fallback)?.code ?? "en";
+}
+function resolveLocalized(value, locale, fallback = "en") {
   if (!value) return "";
   if (typeof value === "string") return value;
-  return value[locale] || value["en"] || Object.values(value)[0] || "";
+  return value[locale] || value[fallback] || Object.values(value)[0] || "";
 }
 function getCountLabel(label, labelPlural, count, locale) {
   const resolved = count === 1 ? label : labelPlural || label;
@@ -312,6 +319,7 @@ function validateEntityDefinition(def) {
 export {
   CATEGORIES,
   CATEGORY_ORDER,
+  DEFAULT_LOCALES,
   DEFAULT_TENANT_ID,
   OFFICIAL_PLUGINS,
   assertAllowedDomain,
@@ -325,6 +333,7 @@ export {
   getCountLabel,
   getEntityName,
   getEntitySubject,
+  getFallbackLocale,
   getOidcClient,
   hasTable,
   isPersistentEntity,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gzl10/nexus-sdk",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "SDK types for creating Nexus plugins and modules",
   "type": "module",
   "main": "./dist/index.js",