@gzl10/nexus-sdk 0.14.0 → 0.15.0

package/dist/{chunk-BFKHCXTE.js → chunk-E7K3RKDO.js}

@@ -443,6 +443,7 @@ function createMasterSelect(config) {
   const {
     label,
     master,
+    defaultValue,
     hint,
     required,
     nullable,
@@ -454,6 +455,7 @@ function createMasterSelect(config) {
   return {
     label,
     input: "select",
+    defaultValue,
     hint,
     required: required ?? false,
     db: {
@@ -505,6 +507,26 @@ function useTextareaField(config) {
   };
 }
 
+// src/fields/code.ts
+function useCodeField(config) {
+  const { label, hint, required, nullable, defaultValue, language, placeholder, meta, ...overrides } = config;
+  return {
+    label,
+    input: "code",
+    hint,
+    required: required ?? false,
+    defaultValue,
+    placeholder,
+    db: {
+      type: "text",
+      nullable: nullable ?? !required
+    },
+    ...language ? { inputProps: { language } } : {},
+    meta,
+    ...overrides
+  };
+}
+
 // src/fields/json.ts
 function useJsonField(config) {
   const { label, hint, required, nullable, meta, ...overrides } = config;
@@ -717,6 +739,150 @@ function useTagsField(config) {
   };
 }
 
+// src/fields/name.ts
+function useNameField(config) {
+  const {
+    size = 100,
+    unique = false,
+    placeholder,
+    hint,
+    validation,
+    disabled,
+    meta,
+    ...overrides
+  } = config ?? {};
+  return {
+    label: { en: "Name", es: "Nombre" },
+    input: "text",
+    hint,
+    required: true,
+    disabled,
+    placeholder,
+    db: {
+      type: "string",
+      size,
+      nullable: false,
+      index: unique,
+      unique
+    },
+    validation: {
+      min: 1,
+      max: size,
+      ...validation
+    },
+    meta: {
+      sortable: true,
+      searchable: true,
+      ...meta
+    },
+    ...overrides
+  };
+}
+
+// src/fields/description.ts
+function useDescriptionField(config) {
+  const {
+    mode = "textarea",
+    localized = false,
+    searchable,
+    nullable = true,
+    size = 255,
+    meta,
+    ...overrides
+  } = config ?? {};
+  const isLocalized = localized;
+  const input = isLocalized ? "text" : mode;
+  const db = isLocalized ? { type: "json", nullable } : mode === "text" ? { type: "string", size, nullable } : { type: "text", nullable };
+  return {
+    label: { en: "Description", es: "Descripci\xF3n" },
+    input,
+    db,
+    meta: {
+      ...searchable ? { searchable: true } : {},
+      ...meta
+    },
+    ...overrides
+  };
+}
+
+// src/fields/metadata.ts
+function useMetadataField(config) {
+  const { hint, meta, ...overrides } = config ?? {};
+  return {
+    label: { en: "Metadata", es: "Metadatos" },
+    input: "json",
+    hint,
+    hidden: true,
+    db: { type: "json", nullable: true },
+    meta: {
+      exportable: false,
+      showInDisplay: false,
+      ...meta
+    },
+    ...overrides
+  };
+}
+
+// src/fields/enabled.ts
+function useEnabledField(config) {
+  const { searchable, meta, ...overrides } = config ?? {};
+  return {
+    label: { en: "Enabled", es: "Habilitado" },
+    input: "switch",
+    defaultValue: true,
+    db: {
+      type: "boolean",
+      nullable: false,
+      default: true
+    },
+    meta: {
+      ...searchable ? { searchable: true } : {},
+      ...meta
+    },
+    ...overrides
+  };
+}
+
+// src/fields/public.ts
+function usePublicField(config) {
+  const { hint, searchable, meta, ...overrides } = config;
+  return {
+    label: { en: "Public", es: "P\xFAblico" },
+    input: "switch",
+    hint,
+    defaultValue: false,
+    db: {
+      type: "boolean",
+      nullable: false,
+      default: false
+    },
+    meta: {
+      ...searchable ? { searchable: true } : {},
+      ...meta
+    },
+    ...overrides
+  };
+}
+
+// src/fields/expires-at.ts
+function useExpiresAtField(config) {
+  const { required, nullable = true, meta, ...overrides } = config ?? {};
+  return {
+    label: { en: "Expires", es: "Expira" },
+    input: "datetime",
+    ...required ? { required: true } : {},
+    db: {
+      type: "datetime",
+      nullable
+    },
+    meta: {
+      sortable: true,
+      ...meta
+    },
+    ...overrides
+  };
+}
+
 // src/fields/common.ts
 var idField = useIdField("ulid");
 var userIdField = {
@@ -799,6 +965,7 @@ export {
   useUrlField,
   useSelectField,
   useTextareaField,
+  useCodeField,
   useJsonField,
   useDatetimeField,
   useNumberField,
@@ -809,6 +976,12 @@ export {
   useCheckboxField,
   usePasswordField,
   useTagsField,
+  useNameField,
+  useDescriptionField,
+  useMetadataField,
+  useEnabledField,
+  usePublicField,
+  useExpiresAtField,
   idField,
   userIdField,
   isActiveField,

package/dist/collection/index.d.ts

@@ -1,5 +1,5 @@
-import { L as LocalizedString, b as FieldDefinition } from '../field-D6eIbvjc.js';
-import { s as RolePermission, d as CollectionEntityDefinition, f as DagEntityDefinition, e as EventEntityDefinition } from '../entity-BnVQn6la.js';
+import { L as LocalizedString, b as FieldDefinition } from '../field-KvvQ9oHe.js';
+import { s as RolePermission, d as CollectionEntityDefinition, f as DagEntityDefinition, e as EventEntityDefinition } from '../entity-Bwf8yboo.js';
 import 'knex';
 import 'express';
 import 'pino';

package/dist/collection/index.js

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

package/dist/{entity-BnVQn6la.d.ts → entity-Bwf8yboo.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-D6eIbvjc.js';
+import { L as LocalizedString, b as FieldDefinition, E as EntityIndex, F as FieldCondition } from './field-KvvQ9oHe.js';
 import { Logger } from 'pino';
 
 /**
@@ -303,12 +303,33 @@ type FilterValue = string | number | boolean | null | unknown[] | FilterOperator
 interface EntityQuery {
     page?: number;
     limit?: number;
+    /** Override default max limit (default: 100). Useful for trees, exports, or entities needing larger pages */
+    maxLimit?: number;
     sort?: string;
     order?: 'asc' | 'desc';
     search?: string;
-    /** Filters with optional operators */
+    /**
+     * Filters with optional operators.
+     * All field filters are combined with AND logic.
+     * Use `$or` key for OR logic between field groups:
+     * `{ tenant: 'acme', $or: [{ status: 'active' }, { role: 'admin' }] }`
+     * → tenant = 'acme' AND (status = 'active' OR role = 'admin')
+     */
     filters?: Record<string, unknown>;
 }
+/**
+ * Type-safe query with filters restricted to known entity fields.
+ * Provides autocompletion for filter keys and FilterValue type checking.
+ *
+ * @example
+ * interface User { id: string; name: string; age: number; active: boolean }
+ * const query: TypedEntityQuery<User> = {
+ *   filters: { name: { $contains: 'john' }, age: { $gte: 18 } }
+ * }
+ */
+type TypedEntityQuery<T> = Omit<EntityQuery, 'filters'> & {
+    filters?: Partial<Record<keyof T & string, FilterValue>>;
+};
 /**
  * Database adapter interface for normalized data access.
  *
@@ -906,6 +927,10 @@ interface PageDefinition {
     component?: string;
     /** Standalone pages render with full layout, not as tabs inside ModulePage */
     standalone?: boolean;
+    /** Route meta for the standalone page (auth, guest, permissions) */
+    meta?: Record<string, unknown>;
+    /** Layout for standalone pages: 'admin' (default, sidebar+header), 'public' (header+footer), 'centered' (minimal) */
+    layout?: 'admin' | 'public' | 'centered';
 }
 /**
  * Serializable page definition for API responses.
@@ -925,6 +950,8 @@ interface PageDefinitionDTO {
     widgets?: WidgetDefinition[];
     component?: string;
     standalone?: boolean;
+    meta?: Record<string, unknown>;
+    layout?: 'admin' | 'public' | 'centered';
 }
 
 /**
@@ -1069,7 +1096,7 @@ interface PluginSetupInfo {
 interface PluginManifest {
     /** Plugin npm package name */
     name: string;
-    /** Short code prefix for tables (3-4 uppercase chars) */
+    /** Unique 3-char lowercase plugin identifier (e.g. 'tag', 'lnk', 'ait') */
     code: string;
     /** Display label (singular) */
     label: LocalizedString;
@@ -1077,6 +1104,8 @@ interface PluginManifest {
     labelPlural?: LocalizedString;
     /** Iconify MDI icon */
     icon?: string;
+    /** Absolute path to plugin image file. Auto-detected from image.png if present. */
+    image?: string;
     /** Category for sidebar grouping */
     category: Category;
     /** Plugin version following SemVer */
@@ -1087,7 +1116,7 @@ interface PluginManifest {
     modules: ModuleManifest[];
     /** Other plugin package names that must be loaded before this one */
     dependencies?: string[];
-    /** Other plugin package names that should be loaded before this one if present (soft dependency) */
+    /** Other plugin package names that should be loaded before this one if present */
     optionalDependencies?: string[];
     /** Environment variables required or used by this plugin */
     envVars?: PluginEnvVar[];
@@ -1133,6 +1162,9 @@ interface RateLimitOptions {
     windowMs?: number;
     max?: number;
     message?: string;
+    skipSuccessfulRequests?: boolean;
+    skipFailedRequests?: boolean;
+    keyGenerator?: (req: any) => string;
 }
 /**
  * Middleware factories available in module context.
@@ -1152,6 +1184,27 @@ interface EventEmitterLike {
     once: (event: string, listener: (...args: unknown[]) => void) => this;
     onAny?: (listener: (event: string, ...args: unknown[]) => void) => this;
 }
+/**
+ * Semantic event API for cross-module communication.
+ * Wraps the raw EventEmitter2 with explicit intent patterns.
+ *
+ * - notify: fire-and-forget, errors in listeners do not propagate
+ * - query: request data from 0..N responders, returns flat array
+ * - command: request action from 0..1 handler, returns first result
+ */
+interface ContextEvents {
+    /** Fire-and-forget. Errors in listeners are caught and logged, never thrown. */
+    notify(event: string, payload?: unknown): void;
+    /** Request data from 0..N listeners. Returns flat array of all responses. */
+    query<T = unknown>(event: string, payload?: unknown): Promise<T[]>;
+    /** Request action from 0..1 handler. Returns first defined response or undefined. */
+    command<T = unknown>(event: string, payload?: unknown): Promise<T | undefined>;
+    on(event: string, listener: (...args: unknown[]) => unknown): void;
+    off(event: string, listener: (...args: unknown[]) => unknown): void;
+    once(event: string, listener: (...args: unknown[]) => unknown): void;
+    /** Subscribe to all events. Useful for cross-cutting concerns like webhooks and audit. */
+    onAny(listener: (event: string, ...args: unknown[]) => void): void;
+}
 /**
  * Cryptographic utilities for password handling and symmetric encryption.
  */
@@ -1315,6 +1368,8 @@ interface PluginOpsContext {
  */
 interface DbContext {
     knex: Knex;
+    /** Resolve table name with plugin prefix. Identity for core modules. */
+    t: (name: string) => string;
     adapter: DatabaseAdapter;
     schema: SchemaAdapter;
     addTimestamps: (table: Knex.CreateTableBuilder, db: Knex) => void;
@@ -1376,6 +1431,8 @@ interface EngineContext {
     getSubjectForTable: (table: string) => string | undefined;
     hasModule: (name: string) => boolean;
     hasPlugin: (name: string) => boolean;
+    getPluginByCode: (code: string) => PluginManifest | undefined;
+    hasPluginByCode: (code: string) => boolean;
 }
 /**
  * Services registry namespace.
@@ -1413,6 +1470,8 @@ interface ModuleContext {
     engine: EngineContext;
     services: ServicesContext;
     adapters: AdaptersContext;
+    /** Semantic event API for cross-module communication (notify/query/command). */
+    events: ContextEvents;
     createRouter: () => Router;
 }
 /**
@@ -1703,14 +1762,10 @@ interface CollectionEntityDefinition extends BaseEntityDefinition {
  * Singleton entity - stores a single record in the shared single_records table.
  * When scopeField is set, operates in scoped mode (multiple records keyed by scope).
  */
-interface SingleEntityDefinition {
+interface SingleEntityDefinition extends Pick<BaseEntityDefinition, 'label' | 'labelPlural' | 'icon' | 'fields' | 'casl' | 'public' | 'routePrefix' | 'order' | 'hidden' | 'hooks' | 'realtime'> {
     type: 'single' | 'config';
     /** Unique key in single_records table */
     key: string;
-    label: LocalizedString;
-    labelPlural?: LocalizedString;
-    icon?: string;
-    fields: Record<string, FieldDefinition>;
     /** Default values applied when the setting is first accessed */
     defaults?: Record<string, unknown>;
     /** Scope field name for multi-record mode (absorbed from ConfigEntityDefinition) */
@@ -1719,16 +1774,8 @@ interface SingleEntityDefinition {
     timestamps?: boolean;
     /** Enable audit fields (created_by, updated_by) */
     audit?: boolean;
-    casl?: EntityCaslConfig;
-    /** If true, all endpoints are publicly accessible without authentication (default-deny) */
-    public?: boolean;
-    routePrefix?: string;
-    actions?: EntityAction[];
-    /** Lifecycle hooks factory. Called with ModuleContext at service creation time. */
-    hooks?: (ctx: ModuleContext) => EntityServiceHooks;
-    order?: number;
-    /** Real-time mode: 'live' (push), 'sync' (bidirectional), or false (default) */
-    realtime?: RealtimeMode;
+    /** Custom actions */
+    actions?: ActionDefinition[];
 }
 /**
  * Seed data configuration for reference/tree/dag entities.
@@ -1862,6 +1909,8 @@ interface ComputedEntityDefinition {
     realtime?: RealtimeMode;
     /** Auto-refresh interval in ms. Frontend polls data at this rate when the entity tab is active. */
     refreshInterval?: number;
+    /** Pre-compute cache on startup. Useful for expensive computed entities. */
+    warmCache?: boolean;
 }
 /**
  * View entity - read-only database view or projection.
@@ -1902,4 +1951,4 @@ type TempEntityDefinition = Omit<CollectionEntityDefinition, 'type'> & {
  */
 type EntityDefinition = CollectionEntityDefinition | SingleEntityDefinition | ExternalEntityDefinition | VirtualEntityDefinition | ComputedEntityDefinition | ViewEntityDefinition | ReferenceEntityDefinition | TreeEntityDefinition | DagEntityDefinition | EventEntityDefinition;
 
-export { type ExternalEntityDefinition as $, type AbilityLike as A, type BatchProgressEvent as B, type ConfirmConfig as C, type DisplayMode as D, type EntityType as E, type ForbiddenErrorInstance as F, type SchemaColumnInfo as G, type SchemaColumnBuilder as H, type SchemaTableBuilder as I, type SchemaForeignKeyBuilder as J, type SchemaAlterTableBuilder as K, type SchemaAdapter as L, type ModuleAbilities as M, type ModuleRequirements as N, type ActionDefinition as O, type PostActionPipeline as P, type PostAction as Q, type RealtimeMode as R, type SingleEntityDefinition as S, type TreeEntityDefinition as T, type ConfirmationType as U, type ViewEntityDefinition as V, type EntityAction as W, type SeedConfig as X, type ReferenceEntityDefinition as Y, type RetentionPolicy as Z, type TempRetentionPolicy as _, type Category as a, type PluginConfigField as a$, type VirtualEntityDefinition as a0, type ConfigEntityDefinition as a1, type TempEntityDefinition as a2, type SharedEntityProperties as a3, type BaseEntityService as a4, type CollectionEntityService as a5, type TempEntityService as a6, type EventEntityService as a7, type SingleEntityService as a8, type ConfigEntityService as a9, type ContextSocket as aA, type ContextEventsHub as aB, type ContextHelpers as aC, type EntityHandler as aD, type EntityController as aE, type CoreContext as aF, type DbContext as aG, type RuntimeContext as aH, type ConfigContext as aI, type EngineContext as aJ, type ServicesContext as aK, type AdaptersContext as aL, type ModuleContext as aM, type HttpMethod as aN, type RouteParameterDefinition as aO, type RouteResponseDefinition as aP, type CustomRouteDefinition as aQ, type CacheOptions as aR, type CacheStats as aS, type ManagedCache as aT, type ScopedCacheManager as aU, type CacheManagerContract as aV, type CategoryMeta as aW, type ActionInjection as aX, type ModuleManifest as aY, type AppManifest as aZ, type PluginEnvVar as a_, type ReferenceEntityService as aa, type ViewEntityService as ab, type ComputedEntityService as ac, type ExternalEntityService as ad, type VirtualEntityService as ae, type TreeNode as af, type TreeEntityService as ag, type DagEntityService as ah, type ActionEntityService as ai, type EntityServiceHooks as aj, type CreateEntityServiceOptions as ak, type BaseRolesService as al, type BaseUsersService as am, type SendMailOptions as an, type SendMailResult as ao, type BaseMailService as ap, type LoggerReporter as aq, type CoreServices as ar, type ValidationSchema as as, type ValidateSchemas as at, type RateLimitOptions as au, type ModuleMiddlewares as av, type EventEmitterLike as aw, type ContextCrypto as ax, type SocketIOServer as ay, type SocketIOBroadcastOperator as az, type PageDefinitionDTO as b, type PluginConfigSchema as b0, type PluginSetupInfo as b1, type PluginManifest as b2, type RegisterPluginOptions as b3, CATEGORIES as b4, CATEGORY_ORDER as b5, type PageType as b6, type WidgetLayout as b7, type WidgetDefinition as b8, type PageDefinition as b9, DEFAULT_TENANT_ID as ba, entityRoom as bb, type EntityChangePayload as bc, type EntityRealtimeEvents as bd, type EntityRealtimeEmits as be, type BridgeTarget as bf, type BridgeRule as bg, type EntityDefinition as c, type CollectionEntityDefinition as d, type EventEntityDefinition as e, type DagEntityDefinition as f, type ComputedEntityDefinition as g, type SSEHelper as h, type SSESender as i, type SSEOptions as j, type BatchLogEntry as k, type BaseAuthRequest as l, type BaseUser as m, type PaginationParams as n, type PaginationParamsWithOffset as o, type PaginatedResult as p, type ValidationDetail as q, type CaslAction as r, type RolePermission as s, type EntityCaslConfig as t, type ForbiddenErrorConstructor as u, type AuthRequest as v, type FilterOperators as w, type FilterValue as x, type EntityQuery as y, type DatabaseAdapter as z };
+export { type RetentionPolicy as $, type ActionDefinition as A, type BatchProgressEvent as B, type ConfirmConfig as C, type DisplayMode as D, type EntityType as E, type ForbiddenErrorInstance as F, type EntityQuery as G, type TypedEntityQuery as H, type DatabaseAdapter as I, type SchemaColumnInfo as J, type SchemaColumnBuilder as K, type SchemaTableBuilder as L, type ModuleContext as M, type SchemaForeignKeyBuilder as N, type SchemaAlterTableBuilder as O, type PostActionPipeline as P, type SchemaAdapter as Q, type RealtimeMode as R, type SingleEntityDefinition as S, type TreeEntityDefinition as T, type ModuleRequirements as U, type ViewEntityDefinition as V, type PostAction as W, type ConfirmationType as X, type EntityAction as Y, type SeedConfig as Z, type ReferenceEntityDefinition as _, type Category as a, type AppManifest as a$, type TempRetentionPolicy as a0, type ExternalEntityDefinition as a1, type VirtualEntityDefinition as a2, type ConfigEntityDefinition as a3, type TempEntityDefinition as a4, type SharedEntityProperties as a5, type BaseEntityService as a6, type CollectionEntityService as a7, type TempEntityService as a8, type EventEntityService as a9, type ContextCrypto as aA, type SocketIOServer as aB, type SocketIOBroadcastOperator as aC, type ContextSocket as aD, type ContextEventsHub as aE, type ContextHelpers as aF, type EntityHandler as aG, type EntityController as aH, type CoreContext as aI, type DbContext as aJ, type RuntimeContext as aK, type ConfigContext as aL, type EngineContext as aM, type ServicesContext as aN, type AdaptersContext as aO, type HttpMethod as aP, type RouteParameterDefinition as aQ, type RouteResponseDefinition as aR, type CustomRouteDefinition as aS, type CacheOptions as aT, type CacheStats as aU, type ManagedCache as aV, type ScopedCacheManager as aW, type CacheManagerContract as aX, type CategoryMeta as aY, type ActionInjection as aZ, type ModuleManifest as a_, type SingleEntityService as aa, type ConfigEntityService as ab, type ReferenceEntityService as ac, type ViewEntityService as ad, type ComputedEntityService as ae, type ExternalEntityService as af, type VirtualEntityService as ag, type TreeNode as ah, type TreeEntityService as ai, type DagEntityService as aj, type ActionEntityService as ak, type EntityServiceHooks as al, type CreateEntityServiceOptions as am, type BaseRolesService as an, type BaseUsersService as ao, type SendMailOptions as ap, type SendMailResult as aq, type BaseMailService as ar, type LoggerReporter as as, type CoreServices as at, type ValidationSchema as au, type ValidateSchemas as av, type RateLimitOptions as aw, type ModuleMiddlewares as ax, type EventEmitterLike as ay, type ContextEvents as az, type PageDefinitionDTO as b, type PluginEnvVar as b0, type PluginConfigField as b1, type PluginConfigSchema as b2, type PluginSetupInfo as b3, type PluginManifest as b4, type RegisterPluginOptions as b5, CATEGORIES as b6, CATEGORY_ORDER as b7, type PageType as b8, type WidgetLayout as b9, type WidgetDefinition as ba, type PageDefinition as bb, DEFAULT_TENANT_ID as bc, entityRoom as bd, type EntityChangePayload as be, type EntityRealtimeEvents as bf, type EntityRealtimeEmits as bg, type BridgeTarget as bh, type BridgeRule as bi, type EntityDefinition as c, type CollectionEntityDefinition as d, type EventEntityDefinition as e, type DagEntityDefinition as f, type ComputedEntityDefinition as g, type SSEHelper as h, type SSESender as i, type SSEOptions as j, type BatchLogEntry as k, type BaseAuthRequest as l, type BaseUser as m, type PaginationParams as n, type PaginationParamsWithOffset as o, type PaginatedResult as p, type ValidationDetail as q, type CaslAction as r, type RolePermission as s, type EntityCaslConfig as t, type AbilityLike as u, type ForbiddenErrorConstructor as v, type ModuleAbilities as w, type AuthRequest as x, type FilterOperators as y, type FilterValue as z };

package/dist/{field-D6eIbvjc.d.ts → field-KvvQ9oHe.d.ts}

@@ -9,10 +9,12 @@
  * // Simple string (backward compatible)
  * label: 'Users'
  *
- * // Multi-language object
+ * // Multi-language object (en is required as fallback)
  * label: { en: 'Users', es: 'Usuarios' }
  */
-type LocalizedString = string | Record<string, string>;
+type LocalizedString = string | ({
+    en: string;
+} & Record<string, string>);
 /**
  * Auth provider information for dynamic login buttons.
  * Plugins register this info so the UI can render buttons without knowing provider details.
@@ -278,6 +280,16 @@ interface FieldMeta {
     showInDisplay?: boolean;
     /** Show in forms. Use 'create'/'edit' for conditional display. Default: true */
     showInForm?: boolean | 'create' | 'edit';
+    /**
+     * Action key to call when a switch/checkbox is toggled instead of doing a direct field update.
+     * The action must be a row-scope action with no `input` fields.
+     * String: same action regardless of new value.
+     * Object: different action per new value (true/false).
+     */
+    toggleAction?: string | {
+        true?: string;
+        false?: string;
+    };
 }
 /**
  * Serializable field condition for dynamic visibility/required/disabled.

package/dist/fields/index.d.ts

@@ -1,4 +1,4 @@
-import { b as FieldDefinition } from '../field-D6eIbvjc.js';
+import { b as FieldDefinition } from '../field-KvvQ9oHe.js';
 import { MasterType } from '../masters/index.js';
 
 /**
@@ -699,6 +699,8 @@ interface MasterSelectConfig {
     };
     /** Master route slug (e.g. 'timezones', 'currencies', 'social-networks') */
     master: MasterType;
+    /** Default value */
+    defaultValue?: string;
     /** Help text shown below the input */
     hint?: string | {
         en: string;
@@ -833,6 +835,58 @@ interface TextareaFieldConfig {
  */
 declare function useTextareaField(config: TextareaFieldConfig & FieldOverrides): FieldDefinition;
 
+/**
+ * Code Field Factory
+ *
+ * Creates code editor fields (YAML, JSON, JavaScript, etc.) with common configuration.
+ */
+
+/**
+ * Configuration for code editor fields.
+ */
+interface CodeFieldConfig {
+    /** Field label (localized) */
+    label: string | {
+        en: string;
+        es?: string;
+    };
+    /** Help text shown below the input */
+    hint?: string | {
+        en: string;
+        es?: string;
+    };
+    /** Is field required? (default: false) */
+    required?: boolean;
+    /** DB nullable (default: true) */
+    nullable?: boolean;
+    /** Default value */
+    defaultValue?: string;
+    /** Code language for syntax highlighting (e.g. 'yaml', 'json', 'javascript') */
+    language?: string;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Metadata overrides */
+    meta?: FieldDefinition['meta'];
+}
+/**
+ * Create a code editor field with syntax highlighting.
+ *
+ * @example
+ * ```typescript
+ * compose_yaml: useCodeField({
+ *   label: { en: 'Compose YAML', es: 'YAML de Compose' },
+ *   required: true,
+ *   language: 'yaml'
+ * })
+ *
+ * config_json: useCodeField({
+ *   label: { en: 'Configuration', es: 'Configuración' },
+ *   language: 'json'
+ * })
+ * ```
+ */
+declare function useCodeField(config: CodeFieldConfig & FieldOverrides): FieldDefinition;
+
 /**
  * JSON Field Factory
  *
@@ -1325,9 +1379,215 @@ interface TagsFieldConfig {
 declare function useTagsField(config: TagsFieldConfig & FieldOverrides): FieldDefinition;
 
 /**
- * Common Field Definitions
+ * Name Field Factory
+ *
+ * Creates standard name text fields with sortable/searchable defaults.
+ */
+
+interface NameFieldConfig extends FieldOverrides {
+    /** Max string size (default: 100) */
+    size?: number;
+    /** Unique constraint — also enables index (default: false) */
+    unique?: boolean;
+    /** Placeholder text */
+    placeholder?: string | {
+        en: string;
+        es?: string;
+    };
+    /** Help text shown below the input */
+    hint?: string | {
+        en: string;
+        es?: string;
+    };
+    /** Custom validation rules (merged with auto-generated min/max) */
+    validation?: FieldDefinition['validation'];
+    /** Disabled field (default: false) */
+    disabled?: boolean;
+    /** Metadata overrides (merged with sortable+searchable defaults) */
+    meta?: FieldDefinition['meta'];
+}
+/**
+ * Create a name field with standard defaults.
+ *
+ * Defaults: label Name/Nombre, required, nullable:false, size:100,
+ * meta: sortable+searchable, validation: min:1 max:size.
+ *
+ * @example
+ * ```typescript
+ * // Default name field
+ * name: useNameField()
+ *
+ * // Large unique name
+ * name: useNameField({ size: 255, unique: true })
+ *
+ * // Role name with pattern
+ * name: useNameField({ size: 50, unique: true, disabled: true, validation: { pattern: '^[A-Z_]+$' } })
+ * ```
+ */
+declare function useNameField(config?: NameFieldConfig): FieldDefinition;
+
+/**
+ * Description Field Factory
+ *
+ * Creates description fields in textarea, text, or localized (json) mode.
+ */
+
+interface DescriptionFieldConfig extends FieldOverrides {
+    /** Input mode (default: 'textarea') */
+    mode?: 'textarea' | 'text';
+    /** Store as JSON for localized content (default: false). Forces input to 'text' */
+    localized?: boolean;
+    /** Enable searchable meta (default: false) */
+    searchable?: boolean;
+    /** DB nullable (default: true) */
+    nullable?: boolean;
+    /** String size for text mode (default: 255). Ignored in textarea/localized mode */
+    size?: number;
+    /** Metadata overrides */
+    meta?: FieldDefinition['meta'];
+}
+/**
+ * Create a description field with standard defaults.
+ *
+ * @example
+ * ```typescript
+ * // Default textarea
+ * description: useDescriptionField()
+ *
+ * // Searchable textarea
+ * description: useDescriptionField({ searchable: true })
+ *
+ * // Localized (stored as JSON)
+ * description: useDescriptionField({ localized: true })
+ *
+ * // Single-line text with custom size
+ * description: useDescriptionField({ mode: 'text', size: 500 })
+ * ```
+ */
+declare function useDescriptionField(config?: DescriptionFieldConfig): FieldDefinition;
+
+/**
+ * Metadata Field Factory
+ *
+ * Creates hidden JSON metadata fields for extensibility.
+ */
+
+interface MetadataFieldConfig extends FieldOverrides {
+    /** Help text shown below the input */
+    hint?: string | {
+        en: string;
+        es?: string;
+    };
+    /** Metadata overrides (merged with exportable:false, showInDisplay:false) */
+    meta?: FieldDefinition['meta'];
+}
+/**
+ * Create a metadata JSON field with standard hidden defaults.
+ *
+ * @example
+ * ```typescript
+ * // Standard hidden metadata
+ * metadata: useMetadataField()
+ *
+ * // With hint for forms
+ * metadata: useMetadataField({ hint: 'Additional driver configuration' })
+ * ```
+ */
+declare function useMetadataField(config?: MetadataFieldConfig): FieldDefinition;
+
+/**
+ * Enabled Field Factory
+ *
+ * Creates boolean switch fields for enabling/disabling functionality.
+ */
+
+interface EnabledFieldConfig extends FieldOverrides {
+    /** Enable searchable meta (default: false) */
+    searchable?: boolean;
+    /** Metadata overrides */
+    meta?: FieldDefinition['meta'];
+}
+/**
+ * Create an enabled/disabled switch field with default true.
+ *
+ * Semantics: operational toggle (on/off). For record state use isActiveField preset.
+ *
+ * @example
+ * ```typescript
+ * enabled: useEnabledField()
+ * is_enabled: useEnabledField({ searchable: true })
+ * ```
+ */
+declare function useEnabledField(config?: EnabledFieldConfig): FieldDefinition;
+
+/**
+ * Public Field Factory
+ *
+ * Creates boolean switch fields for public/private visibility.
+ */
+
+interface PublicFieldConfig extends FieldOverrides {
+    /** Help text explaining what "public" means for this entity (required) */
+    hint: string | {
+        en: string;
+        es?: string;
+    };
+    /** Enable searchable meta (default: false) */
+    searchable?: boolean;
+    /** Metadata overrides */
+    meta?: FieldDefinition['meta'];
+}
+/**
+ * Create a public/private switch field with default false.
+ *
+ * hint is required because "public" means different things per entity.
+ *
+ * @example
+ * ```typescript
+ * is_public: usePublicField({
+ *   hint: { en: 'Allow unauthenticated access', es: 'Permitir acceso sin autenticación' }
+ * })
+ *
+ * is_public: usePublicField({
+ *   hint: { en: 'Visible to all users', es: 'Visible para todos' },
+ *   searchable: true
+ * })
+ * ```
+ */
+declare function usePublicField(config: PublicFieldConfig): FieldDefinition;
+
+/**
+ * Expires At Field Factory
+ *
+ * Creates datetime fields for expiration/TTL patterns.
+ */
+
+interface ExpiresAtFieldConfig extends FieldOverrides {
+    /** Is field required? (default: false) */
+    required?: boolean;
+    /** DB nullable (default: true) */
+    nullable?: boolean;
+    /** Metadata overrides (merged with sortable default) */
+    meta?: FieldDefinition['meta'];
+}
+/**
+ * Create an expiration datetime field.
+ *
+ * @example
+ * ```typescript
+ * // Optional expiration (PATs, notifications)
+ * expires_at: useExpiresAtField()
+ *
+ * // Required expiration (refresh tokens)
+ * expires_at: useExpiresAtField({ required: true, nullable: false })
+ * ```
+ */
+declare function useExpiresAtField(config?: ExpiresAtFieldConfig): FieldDefinition;
+
+/**
+ * Field Presets
  *
- * Pre-configured field definitions for common use cases.
+ * Ready-to-use FieldDefinition constants for common use cases.
  * These fields have their `name` assigned from the key when used.
  */
 
@@ -1351,7 +1611,7 @@ declare const isActiveField: FieldDefinition;
 declare const orderField: FieldDefinition;
 
 /**
- * Pre-configured field sets for common entity patterns.
+ * Preset Sets — groups of related field presets for common entity patterns.
  * Use with spread operator or composeFields().
  *
  * @example
@@ -1367,4 +1627,4 @@ declare const auditFields: Record<string, FieldDefinition>;
 /** deleted_at for soft-delete pattern */
 declare const softDeleteFields: Record<string, FieldDefinition>;
 
-export { type CheckboxFieldConfig, type ColorFieldConfig, type DatetimeFieldConfig, type EmailFieldConfig, type FieldOverrides, type FileFieldConfig, type FileSize, type IconFieldConfig, type IdFieldConfig, type IdType, type ImageFieldConfig, type JsonFieldConfig, type LocalizedFieldConfig, type MasterSelectConfig, type MultiFileFieldConfig, type MultiImageFieldConfig, type NumberFieldConfig, type PasswordFieldConfig, type PatternIdConfig, type RelationSelectConfig, type SelectOption, type StaticSelectConfig, type SwitchFieldConfig, type TagsFieldConfig, type TextFieldConfig, type TextUniqueFieldConfig, type TextareaFieldConfig, type UrlFieldConfig, auditFields, idField, isActiveField, orderField, parseFileSize, softDeleteFields, timestampFields, useCheckboxField, useColorField, useDatetimeField, useEmailField, useFileField, useIconField, useIdField, useImageField, useJsonField, useLocalizedField, useMultiFileField, useMultiImageField, useNumberField, usePasswordField, useSelectField, useSwitchField, useTagsField, useTextField, useTextUniqueField, useTextareaField, useUrlField, userIdField };
+export { type CheckboxFieldConfig, type CodeFieldConfig, type ColorFieldConfig, type DatetimeFieldConfig, type DescriptionFieldConfig, type EmailFieldConfig, type EnabledFieldConfig, type ExpiresAtFieldConfig, type FieldOverrides, type FileFieldConfig, type FileSize, type IconFieldConfig, type IdFieldConfig, type IdType, type ImageFieldConfig, type JsonFieldConfig, type LocalizedFieldConfig, type MasterSelectConfig, type MetadataFieldConfig, type MultiFileFieldConfig, type MultiImageFieldConfig, type NameFieldConfig, type NumberFieldConfig, type PasswordFieldConfig, type PatternIdConfig, type PublicFieldConfig, type RelationSelectConfig, type SelectOption, type StaticSelectConfig, type SwitchFieldConfig, type TagsFieldConfig, type TextFieldConfig, type TextUniqueFieldConfig, type TextareaFieldConfig, type UrlFieldConfig, auditFields, idField, isActiveField, orderField, parseFileSize, softDeleteFields, timestampFields, useCheckboxField, useCodeField, useColorField, useDatetimeField, useDescriptionField, useEmailField, useEnabledField, useExpiresAtField, useFileField, useIconField, useIdField, useImageField, useJsonField, useLocalizedField, useMetadataField, useMultiFileField, useMultiImageField, useNameField, useNumberField, usePasswordField, usePublicField, useSelectField, useSwitchField, useTagsField, useTextField, useTextUniqueField, useTextareaField, useUrlField, userIdField };

package/dist/fields/index.js

@@ -7,19 +7,26 @@ import {
   softDeleteFields,
   timestampFields,
   useCheckboxField,
+  useCodeField,
   useColorField,
   useDatetimeField,
+  useDescriptionField,
   useEmailField,
+  useEnabledField,
+  useExpiresAtField,
   useFileField,
   useIconField,
   useIdField,
   useImageField,
   useJsonField,
   useLocalizedField,
+  useMetadataField,
   useMultiFileField,
   useMultiImageField,
+  useNameField,
   useNumberField,
   usePasswordField,
+  usePublicField,
   useSelectField,
   useSwitchField,
   useTagsField,
@@ -28,7 +35,7 @@ import {
   useTextareaField,
   useUrlField,
   userIdField
-} from "../chunk-BFKHCXTE.js";
+} from "../chunk-E7K3RKDO.js";
 export {
   auditFields,
   idField,
@@ -38,19 +45,26 @@ export {
   softDeleteFields,
   timestampFields,
   useCheckboxField,
+  useCodeField,
   useColorField,
   useDatetimeField,
+  useDescriptionField,
   useEmailField,
+  useEnabledField,
+  useExpiresAtField,
   useFileField,
   useIconField,
   useIdField,
   useImageField,
   useJsonField,
   useLocalizedField,
+  useMetadataField,
   useMultiFileField,
   useMultiImageField,
+  useNameField,
   useNumberField,
   usePasswordField,
+  usePublicField,
   useSelectField,
   useSwitchField,
   useTagsField,

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 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, E as EntityType, D as DisplayMode, R as RealtimeMode, a as Category, b as PageDefinitionDTO, c as EntityDefinition, d as CollectionEntityDefinition, e as EventEntityDefinition, V as ViewEntityDefinition, T as TreeEntityDefinition, f as DagEntityDefinition, S as SingleEntityDefinition, g as ComputedEntityDefinition } from './entity-BnVQn6la.js';
-export { A as AbilityLike, O as ActionDefinition, ai as ActionEntityService, aX as ActionInjection, aL as AdaptersContext, aZ as AppManifest, v as AuthRequest, l as BaseAuthRequest, a4 as BaseEntityService, ap as BaseMailService, al as BaseRolesService, m as BaseUser, am as BaseUsersService, k as BatchLogEntry, B as BatchProgressEvent, bg as BridgeRule, bf as BridgeTarget, b4 as CATEGORIES, b5 as CATEGORY_ORDER, aV as CacheManagerContract, aR as CacheOptions, aS as CacheStats, r as CaslAction, aW as CategoryMeta, a5 as CollectionEntityService, ac as ComputedEntityService, aI as ConfigContext, a1 as ConfigEntityDefinition, a9 as ConfigEntityService, U as ConfirmationType, ax as ContextCrypto, aB as ContextEventsHub, aC as ContextHelpers, aA as ContextSocket, aF as CoreContext, ar as CoreServices, ak as CreateEntityServiceOptions, aQ as CustomRouteDefinition, ba as DEFAULT_TENANT_ID, ah as DagEntityService, z as DatabaseAdapter, aG as DbContext, aJ as EngineContext, W as EntityAction, t as EntityCaslConfig, bc as EntityChangePayload, aE as EntityController, aD as EntityHandler, y as EntityQuery, be as EntityRealtimeEmits, bd as EntityRealtimeEvents, aj as EntityServiceHooks, aw as EventEmitterLike, a7 as EventEntityService, $ as ExternalEntityDefinition, ad as ExternalEntityService, w as FilterOperators, x as FilterValue, u as ForbiddenErrorConstructor, F as ForbiddenErrorInstance, aN as HttpMethod, aq as LoggerReporter, aT as ManagedCache, M as ModuleAbilities, aM as ModuleContext, aY as ModuleManifest, av as ModuleMiddlewares, N as ModuleRequirements, b9 as PageDefinition, b6 as PageType, p as PaginatedResult, n as PaginationParams, o as PaginationParamsWithOffset, a$ as PluginConfigField, b0 as PluginConfigSchema, a_ as PluginEnvVar, b2 as PluginManifest, b1 as PluginSetupInfo, Q as PostAction, au as RateLimitOptions, Y as ReferenceEntityDefinition, aa as ReferenceEntityService, b3 as RegisterPluginOptions, Z as RetentionPolicy, s as RolePermission, aO as RouteParameterDefinition, aP as RouteResponseDefinition, aH as RuntimeContext, h as SSEHelper, j as SSEOptions, i as SSESender, L as SchemaAdapter, K as SchemaAlterTableBuilder, H as SchemaColumnBuilder, G as SchemaColumnInfo, J as SchemaForeignKeyBuilder, I as SchemaTableBuilder, aU as ScopedCacheManager, X as SeedConfig, an as SendMailOptions, ao as SendMailResult, aK as ServicesContext, a3 as SharedEntityProperties, a8 as SingleEntityService, az as SocketIOBroadcastOperator, ay as SocketIOServer, a2 as TempEntityDefinition, a6 as TempEntityService, _ as TempRetentionPolicy, ag as TreeEntityService, af as TreeNode, at as ValidateSchemas, q as ValidationDetail, as as ValidationSchema, ab as ViewEntityService, a0 as VirtualEntityDefinition, ae as VirtualEntityService, b8 as WidgetDefinition, b7 as WidgetLayout, bb as entityRoom } from './entity-BnVQn6la.js';
-import { L as LocalizedString, I as InputType, F as FieldCondition, a as FieldMeta, b as FieldDefinition } from './field-D6eIbvjc.js';
-export { A as AuthProviderInfo, c as AuthProviderService, C as ConditionalBoolean, D as DbType, E as EntityIndex, d as FieldDbConfig, h as FieldOptions, e as FieldRelation, i as FieldStorageConfig, f as FieldValidationConfig, g as getCountLabel, j as refOptions, r as resolveLocalized } from './field-D6eIbvjc.js';
+import { C as ConfirmConfig, P as PostActionPipeline, E as EntityType, D as DisplayMode, R as RealtimeMode, a as Category, b as PageDefinitionDTO, c as EntityDefinition, d as CollectionEntityDefinition, e as EventEntityDefinition, V as ViewEntityDefinition, T as TreeEntityDefinition, f as DagEntityDefinition, S as SingleEntityDefinition, g as ComputedEntityDefinition, A as ActionDefinition, M as ModuleContext } from './entity-Bwf8yboo.js';
+export { u as AbilityLike, ak as ActionEntityService, aZ as ActionInjection, aO as AdaptersContext, a$ as AppManifest, x as AuthRequest, l as BaseAuthRequest, a6 as BaseEntityService, ar as BaseMailService, an as BaseRolesService, m as BaseUser, ao as BaseUsersService, k as BatchLogEntry, B as BatchProgressEvent, bi as BridgeRule, bh as BridgeTarget, b6 as CATEGORIES, b7 as CATEGORY_ORDER, aX as CacheManagerContract, aT as CacheOptions, aU as CacheStats, r as CaslAction, aY as CategoryMeta, a7 as CollectionEntityService, ae as ComputedEntityService, aL as ConfigContext, a3 as ConfigEntityDefinition, ab as ConfigEntityService, X as ConfirmationType, aA as ContextCrypto, az as ContextEvents, aE as ContextEventsHub, aF as ContextHelpers, aD as ContextSocket, aI as CoreContext, at as CoreServices, am as CreateEntityServiceOptions, aS as CustomRouteDefinition, bc as DEFAULT_TENANT_ID, aj as DagEntityService, I as DatabaseAdapter, aJ as DbContext, aM as EngineContext, Y as EntityAction, t as EntityCaslConfig, be as EntityChangePayload, aH as EntityController, aG as EntityHandler, G as EntityQuery, bg as EntityRealtimeEmits, bf as EntityRealtimeEvents, al as EntityServiceHooks, ay as EventEmitterLike, a9 as EventEntityService, a1 as ExternalEntityDefinition, af as ExternalEntityService, y as FilterOperators, z as FilterValue, v as ForbiddenErrorConstructor, F as ForbiddenErrorInstance, aP as HttpMethod, as as LoggerReporter, aV as ManagedCache, w as ModuleAbilities, a_ as ModuleManifest, ax as ModuleMiddlewares, U as ModuleRequirements, bb as PageDefinition, b8 as PageType, p as PaginatedResult, n as PaginationParams, o as PaginationParamsWithOffset, b1 as PluginConfigField, b2 as PluginConfigSchema, b0 as PluginEnvVar, b4 as PluginManifest, b3 as PluginSetupInfo, W as PostAction, aw as RateLimitOptions, _ as ReferenceEntityDefinition, ac as ReferenceEntityService, b5 as RegisterPluginOptions, $ as RetentionPolicy, s as RolePermission, aQ as RouteParameterDefinition, aR as RouteResponseDefinition, aK as RuntimeContext, h as SSEHelper, j as SSEOptions, i as SSESender, Q as SchemaAdapter, O as SchemaAlterTableBuilder, K as SchemaColumnBuilder, J as SchemaColumnInfo, N as SchemaForeignKeyBuilder, L as SchemaTableBuilder, aW as ScopedCacheManager, Z as SeedConfig, ap as SendMailOptions, aq as SendMailResult, aN as ServicesContext, a5 as SharedEntityProperties, aa as SingleEntityService, aC as SocketIOBroadcastOperator, aB as SocketIOServer, a4 as TempEntityDefinition, a8 as TempEntityService, a0 as TempRetentionPolicy, ai as TreeEntityService, ah as TreeNode, H as TypedEntityQuery, av as ValidateSchemas, q as ValidationDetail, au as ValidationSchema, ad as ViewEntityService, a2 as VirtualEntityDefinition, ag as VirtualEntityService, ba as WidgetDefinition, b9 as WidgetLayout, bd as entityRoom } from './entity-Bwf8yboo.js';
+import { L as LocalizedString, I as InputType, F as FieldCondition, a as FieldMeta, b as FieldDefinition } from './field-KvvQ9oHe.js';
+export { A as AuthProviderInfo, c as AuthProviderService, C as ConditionalBoolean, D as DbType, E as EntityIndex, d as FieldDbConfig, h as FieldOptions, e as FieldRelation, i as FieldStorageConfig, f as FieldValidationConfig, g as getCountLabel, j as refOptions, r as resolveLocalized } from './field-KvvQ9oHe.js';
 import 'pino';
 
 /** Webhook configuration record */
@@ -249,6 +250,8 @@ interface PluginDTO {
     label: LocalizedString;
     labelPlural?: LocalizedString;
     icon?: string;
+    /** URL to plugin image (served by backend) */
+    image?: string;
     category?: Category;
     version: string;
     description: LocalizedString;
@@ -309,6 +312,68 @@ interface CombinedManifestDTO {
     /** Current tenant ID for this server instance */
     tenantId: string;
 }
+/**
+ * Public capabilities response.
+ *
+ * Exposed without authentication so clients can discover
+ * which plugins are available before the user logs in.
+ *
+ * @remarks
+ * Returned by `GET /system/capabilities` (public, no auth required).
+ * The `plugins` array contains 3-char plugin codes (e.g. `'ntf'`, `'cpl'`).
+ * Extensible — future fields (locales, feature flags) can be added
+ * without breaking changes.
+ *
+ * @example
+ * ```json
+ * { "version": "0.14.0", "plugins": ["ntf", "cpl", "cht", "sch"] }
+ * ```
+ */
+interface CapabilitiesDTO {
+    /** Backend package version (semver) */
+    version: string;
+    /** 3-char codes of registered plugins */
+    plugins: string[];
+}
+
+/** Status of a ticket as seen by the end user */
+type TicketStatus = 'pending' | 'in_progress' | 'resolved' | 'rejected';
+/** Data submitted by a user to create a new ticket */
+interface TicketSubmission {
+    title: string;
+    description: string;
+    category?: string;
+    priority?: string;
+    submitter?: string;
+}
+/** Ticket as returned to the submitter (simplified view) */
+interface TicketItem {
+    id: string;
+    title: string;
+    status: TicketStatus;
+    category: string;
+    created_at: string;
+    updated_at: string;
+}
+/** Result of a successful ticket submission */
+interface TicketResult {
+    id: string;
+    status: TicketStatus;
+}
+/**
+ * Generic ticket provider interface.
+ * Plugins implement this to bridge Nexus with an external task tracker.
+ */
+interface TicketProvider {
+    /** Submit a new ticket */
+    submit(data: TicketSubmission): Promise<TicketResult>;
+    /** List tickets for a specific submitter */
+    list(submitter: string): Promise<TicketItem[]>;
+    /** Verify the connection to the external service */
+    testConnection(): Promise<boolean>;
+    /** Whether the provider is currently available */
+    isAvailable(): boolean;
+}
 
 /**
  * Type guards and utilities for EntityDefinitions
@@ -577,7 +642,7 @@ declare function assertAllowedDomain(email: string, allowedDomainsJson: string |
  * Official Nexus plugins maintained by the core team.
  * Used by the backend to populate the plugin store.
  */
-declare const OFFICIAL_PLUGINS: readonly ["@gzl10/nexus-plugin-ai", "@gzl10/nexus-plugin-baserow", "@gzl10/nexus-plugin-charts", "@gzl10/nexus-plugin-cms", "@gzl10/nexus-plugin-docker", "@gzl10/nexus-plugin-dropbox", "@gzl10/nexus-plugin-github-auth", "@gzl10/nexus-plugin-google-auth", "@gzl10/nexus-plugin-google-drive", "@gzl10/nexus-plugin-headscale", "@gzl10/nexus-plugin-links", "@gzl10/nexus-plugin-microsoft-auth", "@gzl10/nexus-plugin-n8n", "@gzl10/nexus-plugin-notion", "@gzl10/nexus-plugin-oidc-server", "@gzl10/nexus-plugin-opnsense", "@gzl10/nexus-plugin-pocketid", "@gzl10/nexus-plugin-prisma", "@gzl10/nexus-plugin-tags", "@gzl10/nexus-plugin-uptime"];
+declare const OFFICIAL_PLUGINS: readonly ["@gzl10/nexus-plugin-ai", "@gzl10/nexus-plugin-auth-providers", "@gzl10/nexus-plugin-baserow", "@gzl10/nexus-plugin-charts", "@gzl10/nexus-plugin-cms", "@gzl10/nexus-plugin-compliance", "@gzl10/nexus-plugin-docker", "@gzl10/nexus-plugin-dropbox", "@gzl10/nexus-plugin-google-drive", "@gzl10/nexus-plugin-headscale", "@gzl10/nexus-plugin-importer", "@gzl10/nexus-plugin-links", "@gzl10/nexus-plugin-n8n", "@gzl10/nexus-plugin-notifications", "@gzl10/nexus-plugin-notion", "@gzl10/nexus-plugin-oidc-server", "@gzl10/nexus-plugin-opnsense", "@gzl10/nexus-plugin-plane", "@gzl10/nexus-plugin-prisma", "@gzl10/nexus-plugin-remote", "@gzl10/nexus-plugin-schedules", "@gzl10/nexus-plugin-scim", "@gzl10/nexus-plugin-tags", "@gzl10/nexus-plugin-uptime", "@gzl10/nexus-plugin-webhooks"];
 type OfficialPluginName = typeof OFFICIAL_PLUGINS[number];
 
 /**
@@ -605,6 +670,27 @@ declare function assertNever(value: never, message?: string): never;
  * )
  */
 declare function composeFields(...fieldSets: Record<string, FieldDefinition>[]): Record<string, FieldDefinition>;
+/**
+ * Define an action with typed input and output.
+ * Provides type safety for the handler while returning a standard ActionDefinition
+ * that is assignable to ActionDefinition[] arrays.
+ *
+ * @example
+ * interface SendEmailInput { to: string; subject: string; body: string }
+ * interface SendEmailOutput { messageId: string }
+ *
+ * const sendEmail = defineAction<SendEmailInput, SendEmailOutput>({
+ *   key: 'send-email',
+ *   label: 'Send Email',
+ *   handler: async (ctx, input) => {
+ *     // input is typed as SendEmailInput
+ *     return { messageId: '123' }
+ *   }
+ * })
+ */
+declare function defineAction<TInput = unknown, TOutput = unknown>(action: Omit<ActionDefinition, 'handler'> & {
+    handler?: (ctx: ModuleContext, input: TInput, req?: Request, res?: Response) => Promise<TOutput>;
+}): ActionDefinition;
 
 interface ValidationError {
     field: string;
@@ -638,4 +724,4 @@ type KnexCreateTableBuilder = Knex.CreateTableBuilder;
 type KnexAlterTableBuilder = Knex.AlterTableBuilder;
 type KnexTransaction = Knex.Transaction;
 
-export { type ActionDefinitionDTO, type AuthorizationParams, Category, CollectionEntityDefinition, type CombinedManifestDTO, ComputedEntityDefinition, ConfirmConfig, type CreateWebhookInput, type CreateWebhookResponse, DagEntityDefinition, DisplayMode, type DomainFilterOptions, type DomainFilterResult, EntityDefinition, type EntityDefinitionDTO, EntityType, EventEntityDefinition, FieldCondition, FieldDefinition, type FieldDefinitionDTO, FieldMeta, type IdTokenClaims, InputType, type KnexAlterTableBuilder, type KnexCreateTableBuilder, type KnexTransaction, LocalizedString, type ManifestDTO, type ModuleDTO, type NonPersistentEntityDefinition, OFFICIAL_PLUGINS, type OfficialPluginName, type OidcClient, type OidcDiscoveryDocument, type OidcState, type OidcTokens, type OidcUserInfo, PageDefinitionDTO, type PersistentEntityDefinition, type PluginActionResult, type PluginDTO, type PluginSetupInfoDTO, type PluginStateDTO, PostActionPipeline, RealtimeMode, type SessionResult, SingleEntityDefinition, type StateManager, type TokenExchangeParams, type TokenValidationConfig, TreeEntityDefinition, type UpdateWebhookInput, type ValidationError, type ValidationResult, ViewEntityDefinition, type Webhook, type WebhookDelivery, assertAllowedDomain, assertNever, checkAllowedDomain, composeFields, createOidcClient, createStateManager, getEntityName, getEntitySubject, getOidcClient, hasTable, isPersistentEntity, isSingletonEntity, validateEntityDefinition };
+export { ActionDefinition, type ActionDefinitionDTO, type AuthorizationParams, type CapabilitiesDTO, Category, CollectionEntityDefinition, type CombinedManifestDTO, ComputedEntityDefinition, ConfirmConfig, type CreateWebhookInput, type CreateWebhookResponse, DagEntityDefinition, DisplayMode, type DomainFilterOptions, type DomainFilterResult, EntityDefinition, type EntityDefinitionDTO, EntityType, EventEntityDefinition, FieldCondition, FieldDefinition, type FieldDefinitionDTO, FieldMeta, type IdTokenClaims, InputType, type KnexAlterTableBuilder, type KnexCreateTableBuilder, type KnexTransaction, LocalizedString, type ManifestDTO, ModuleContext, type ModuleDTO, type NonPersistentEntityDefinition, OFFICIAL_PLUGINS, type OfficialPluginName, type OidcClient, type OidcDiscoveryDocument, type OidcState, type OidcTokens, type OidcUserInfo, PageDefinitionDTO, type PersistentEntityDefinition, type PluginActionResult, type PluginDTO, type PluginSetupInfoDTO, type PluginStateDTO, PostActionPipeline, RealtimeMode, type SessionResult, SingleEntityDefinition, type StateManager, type TicketItem, type TicketProvider, type TicketResult, type TicketStatus, type TicketSubmission, type TokenExchangeParams, type TokenValidationConfig, TreeEntityDefinition, type UpdateWebhookInput, type ValidationError, type ValidationResult, ViewEntityDefinition, type Webhook, type WebhookDelivery, assertAllowedDomain, assertNever, checkAllowedDomain, composeFields, createOidcClient, createStateManager, defineAction, getEntityName, getEntitySubject, getOidcClient, hasTable, isPersistentEntity, isSingletonEntity, validateEntityDefinition };

package/dist/index.js

@@ -229,25 +229,30 @@ function assertAllowedDomain(email, allowedDomainsJson, errorClass = Error) {
 // src/plugins/official-plugins.ts
 var OFFICIAL_PLUGINS = [
   "@gzl10/nexus-plugin-ai",
+  "@gzl10/nexus-plugin-auth-providers",
   "@gzl10/nexus-plugin-baserow",
   "@gzl10/nexus-plugin-charts",
   "@gzl10/nexus-plugin-cms",
+  "@gzl10/nexus-plugin-compliance",
   "@gzl10/nexus-plugin-docker",
   "@gzl10/nexus-plugin-dropbox",
-  "@gzl10/nexus-plugin-github-auth",
-  "@gzl10/nexus-plugin-google-auth",
   "@gzl10/nexus-plugin-google-drive",
   "@gzl10/nexus-plugin-headscale",
+  "@gzl10/nexus-plugin-importer",
   "@gzl10/nexus-plugin-links",
-  "@gzl10/nexus-plugin-microsoft-auth",
   "@gzl10/nexus-plugin-n8n",
+  "@gzl10/nexus-plugin-notifications",
   "@gzl10/nexus-plugin-notion",
   "@gzl10/nexus-plugin-oidc-server",
   "@gzl10/nexus-plugin-opnsense",
-  "@gzl10/nexus-plugin-pocketid",
+  "@gzl10/nexus-plugin-plane",
   "@gzl10/nexus-plugin-prisma",
+  "@gzl10/nexus-plugin-remote",
+  "@gzl10/nexus-plugin-schedules",
+  "@gzl10/nexus-plugin-scim",
   "@gzl10/nexus-plugin-tags",
-  "@gzl10/nexus-plugin-uptime"
+  "@gzl10/nexus-plugin-uptime",
+  "@gzl10/nexus-plugin-webhooks"
 ];
 
 // src/utils.ts
@@ -258,6 +263,9 @@ function assertNever(value, message) {
 function composeFields(...fieldSets) {
   return Object.assign({}, ...fieldSets);
 }
+function defineAction(action) {
+  return action;
+}
 
 // src/validation.ts
 var NO_TABLE_TYPES = /* @__PURE__ */ new Set(["computed"]);
@@ -309,6 +317,7 @@ export {
   composeFields,
   createOidcClient,
   createStateManager,
+  defineAction,
   entityRoom,
   getCountLabel,
   getEntityName,

package/dist/masters/index.d.ts

@@ -9,9 +9,5 @@
 type MasterType = string;
 /** Predefined master type slugs included with Nexus */
 declare const PREDEFINED_MASTER_TYPES: readonly ["currencies", "languages", "timezones", "social-networks", "genders", "marital-statuses", "education-levels", "industries", "company-types", "units", "product-categories", "phone-prefixes", "document-types"];
-/** @deprecated Use MasterType instead */
-type MasterSlug = string;
-/** @deprecated Use PREDEFINED_MASTER_TYPES instead */
-declare const MASTER_SLUGS: readonly ["currencies", "languages", "timezones", "social-networks", "genders", "marital-statuses", "education-levels", "industries", "company-types", "units", "product-categories", "phone-prefixes", "document-types"];
 
-export { MASTER_SLUGS, type MasterSlug, type MasterType, PREDEFINED_MASTER_TYPES };
+export { type MasterType, PREDEFINED_MASTER_TYPES };

package/dist/masters/index.js

@@ -14,8 +14,6 @@ var PREDEFINED_MASTER_TYPES = [
   "phone-prefixes",
   "document-types"
 ];
-var MASTER_SLUGS = PREDEFINED_MASTER_TYPES;
 export {
-  MASTER_SLUGS,
   PREDEFINED_MASTER_TYPES
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gzl10/nexus-sdk",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "SDK types for creating Nexus plugins and modules",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,7 +37,7 @@
     "module"
   ],
   "dependencies": {
-    "jose": "^5.0.0",
+    "jose": "^6.0.0",
     "ofetch": "^1.4.0"
   },
   "author": "Gonzalo Díez <gonzalo@gzl10.com>",
@@ -59,8 +59,7 @@
     "@types/express": "^5.0.2",
     "express": "^5.0.1",
     "knex": "^3.1.0",
-    "pino": "^9.6.0",
-    "tsup": "^8.4.0"
+    "pino": "^9.6.0"
   },
   "peerDependencies": {
     "express": "^5.0.1",