@rizom/brain 0.2.0-alpha.149 → 0.2.0-alpha.151

package/dist/interfaces.d.ts

@@ -1,7 +1,5 @@
-import { z } from 'zod/v4';
-import { RouteDefinition, RouteDefinitionInput } from '@rizom/site';
-export { EntityDisplayEntry, NavigationItem, NavigationSlot, RouteDefinition, RouteDefinitionInput, SectionDefinition } from '@rizom/site';
-
+import { z } from "zod/v4";
+//#region ../../shell/templates/src/permission-service.d.ts
 /**
  * User permission level schema
  */
@@ -14,11 +12,11 @@ declare const UserPermissionLevelSchema: z.ZodType<UserPermissionLevel, UserPerm
  */
 type EntityActionRequiredLevel = "never" | UserPermissionLevel;
 interface EntityActionPolicyRule {
-    create?: EntityActionRequiredLevel | undefined;
-    update?: EntityActionRequiredLevel | undefined;
-    delete?: EntityActionRequiredLevel | undefined;
-    extract?: EntityActionRequiredLevel | undefined;
-    publish?: EntityActionRequiredLevel | undefined;
+  create?: EntityActionRequiredLevel | undefined;
+  update?: EntityActionRequiredLevel | undefined;
+  delete?: EntityActionRequiredLevel | undefined;
+  extract?: EntityActionRequiredLevel | undefined;
+  publish?: EntityActionRequiredLevel | undefined;
 }
 type EntityActionPolicyRuleInput = EntityActionPolicyRule;
 type EntityActionPolicyConfigInput = Record<string, EntityActionPolicyRuleInput>;
@@ -26,25 +24,26 @@ type EntityActionPolicyConfigInput = Record<string, EntityActionPolicyRuleInput>
  * Generic interface for items with visibility
  */
 interface WithVisibility {
-    visibility?: UserPermissionLevel;
+  visibility?: UserPermissionLevel;
 }
 /**
  * Permission rule for pattern-based permission matching
  */
 interface PermissionRule {
-    pattern: string;
-    level: UserPermissionLevel;
+  pattern: string;
+  level: UserPermissionLevel;
 }
 /**
  * Configuration for the permission system
  */
 interface PermissionConfig {
-    anchors?: string[];
-    trusted?: string[];
-    rules?: PermissionRule[];
-    entityActions?: EntityActionPolicyConfigInput;
+  anchors?: string[];
+  trusted?: string[];
+  rules?: PermissionRule[];
+  entityActions?: EntityActionPolicyConfigInput;
 }
-
+//#endregion
+//#region ../../shell/plugins/src/contracts/metadata.d.ts
 /**
  * Best-effort extension metadata carried across public DTO boundaries.
  *
@@ -53,93 +52,172 @@ interface PermissionConfig {
  * schema and keep this bag only as optional extension data.
  */
 declare const ExtensionMetadataSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-
-declare const MessageResponseSchema: z.ZodUnion<[
-    z.ZodObject<{
-        success: z.ZodBoolean;
-        data: z.ZodOptional<z.ZodUnknown>;
-        error: z.ZodOptional<z.ZodString>;
-    }>,
-    z.ZodObject<{
-        noop: z.ZodLiteral<true>;
-    }>
-]>;
+//#endregion
+//#region ../../shell/plugins/src/contracts/messaging.d.ts
+declare const MessageResponseSchema: z.ZodUnion<[z.ZodObject<{
+  success: z.ZodBoolean;
+  data: z.ZodOptional<z.ZodUnknown>;
+  error: z.ZodOptional<z.ZodString>;
+}>, z.ZodObject<{
+  noop: z.ZodLiteral<true>;
+}>]>;
 type MessageResponse<T = unknown> = ({
-    success: boolean;
-    error?: string | undefined;
+  success: boolean;
+  error?: string | undefined;
 } & {
-    data?: T | undefined;
+  data?: T | undefined;
 }) | {
-    noop: true;
+  noop: true;
 };
 declare const BaseMessageSchema: z.ZodObject<{
-    id: z.ZodString;
-    timestamp: z.ZodString;
-    type: z.ZodString;
-    source: z.ZodString;
-    target: z.ZodOptional<z.ZodString>;
-    metadata: z.ZodOptional<typeof ExtensionMetadataSchema>;
+  id: z.ZodString;
+  timestamp: z.ZodString;
+  type: z.ZodString;
+  source: z.ZodString;
+  target: z.ZodOptional<z.ZodString>;
+  metadata: z.ZodOptional<typeof ExtensionMetadataSchema>;
 }>;
 type BaseMessage = z.output<typeof BaseMessageSchema>;
 type MessageWithPayload<T = unknown> = BaseMessage & {
-    payload: T;
+  payload: T;
 };
 interface MessageSendOptions {
-    target?: string;
-    metadata?: z.output<typeof ExtensionMetadataSchema>;
-    broadcast?: boolean;
+  target?: string;
+  metadata?: z.output<typeof ExtensionMetadataSchema>;
+  broadcast?: boolean;
 }
 interface MessageSendRequest<T = unknown> extends MessageSendOptions {
-    type: string;
-    payload: T;
+  type: string;
+  payload: T;
 }
 type MessageSender<T = unknown, R = unknown> = (request: MessageSendRequest<T>) => Promise<MessageResponse<R>>;
 interface MessageContext {
-    userId?: string;
-    channelId?: string;
-    messageId?: string;
-    timestamp?: string;
-    interfaceType?: string;
-    userPermissionLevel?: UserPermissionLevel;
-    threadId?: string;
-}
-
+  userId?: string;
+  channelId?: string;
+  messageId?: string;
+  timestamp?: string;
+  interfaceType?: string;
+  userPermissionLevel?: UserPermissionLevel;
+  threadId?: string;
+}
+//#endregion
+//#region ../site/src/index.d.ts
+/** Navigation slot types exposed to authored routes and generated entity routes. */
+type NavigationSlot = "primary" | "secondary";
+/** Display and behavior metadata for an entity type. */
+interface EntityDisplayEntry {
+  label: string;
+  pluralName?: string | undefined;
+  /** Layout name for this entity type's generated routes (defaults to "default"). */
+  layout?: string | undefined;
+  /** Enable pagination for list pages. */
+  paginate?: boolean | undefined;
+  /** Items per page (default: 10). */
+  pageSize?: number | undefined;
+  navigation?: {
+    show?: boolean | undefined;
+    slot?: NavigationSlot | undefined;
+    priority?: number | undefined;
+  } | undefined;
+}
+interface SectionDefinitionInput {
+  id: string;
+  template: string;
+  content?: unknown;
+  dataQuery?: {
+    entityType?: string | undefined;
+    template?: string | undefined;
+    query?: Record<string, unknown> | undefined;
+    [key: string]: unknown;
+  } | undefined;
+  order?: number | undefined;
+}
+type SectionDefinition = SectionDefinitionInput;
+interface NavigationMetadataInput {
+  show?: boolean | undefined;
+  label?: string | undefined;
+  slot?: NavigationSlot | undefined;
+  priority?: number | undefined;
+}
+interface NavigationMetadata {
+  show: boolean;
+  label?: string | undefined;
+  slot: NavigationSlot;
+  priority: number;
+}
+interface RouteDefinitionInput {
+  id: string;
+  path: string;
+  title?: string | undefined;
+  /** Bare display label without any page suffix. */
+  pageLabel?: string | undefined;
+  description?: string | undefined;
+  sections?: SectionDefinitionInput[] | undefined;
+  layout?: string | undefined;
+  fullscreen?: boolean | undefined;
+  pluginId?: string | undefined;
+  sourceEntityType?: string | undefined;
+  external?: boolean | undefined;
+  navigation?: NavigationMetadataInput | undefined;
+}
+interface RouteDefinition {
+  id: string;
+  path: string;
+  title: string;
+  pageLabel?: string | undefined;
+  description: string;
+  sections: SectionDefinition[];
+  layout: string;
+  fullscreen?: boolean | undefined;
+  pluginId?: string | undefined;
+  sourceEntityType?: string | undefined;
+  external?: boolean | undefined;
+  navigation?: NavigationMetadata | undefined;
+}
+interface NavigationItem {
+  label: string;
+  href: string;
+  priority: number;
+}
+//#endregion
+//#region ../../shared/site-composition/src/routes.d.ts
 /** Navigation slot types. */
 declare const NavigationSlots: readonly ["primary", "secondary"];
 /** Route definition schema. */
 declare const RouteDefinitionSchema: z.ZodType<RouteDefinition, RouteDefinitionInput>;
 interface RegisterRoutesPayload {
-    routes: RouteDefinition[];
-    pluginId: string;
+  routes: RouteDefinition[];
+  pluginId: string;
 }
 interface UnregisterRoutesPayload {
-    paths?: string[] | undefined;
-    pluginId?: string | undefined;
+  paths?: string[] | undefined;
+  pluginId?: string | undefined;
 }
 interface ListRoutesPayload {
-    pluginId?: string | undefined;
+  pluginId?: string | undefined;
 }
 interface GetRoutePayload {
-    path: string;
+  path: string;
 }
 /** Message payload schemas for route operations. */
 declare const RegisterRoutesPayloadSchema: z.ZodType<RegisterRoutesPayload>;
 declare const UnregisterRoutesPayloadSchema: z.ZodType<UnregisterRoutesPayload>;
 declare const ListRoutesPayloadSchema: z.ZodType<ListRoutesPayload>;
 declare const GetRoutePayloadSchema: z.ZodType<GetRoutePayload>;
-
+//#endregion
+//#region ../../shell/plugins/src/types/api-routes.d.ts
 declare const apiRouteDefinitionSchema: z.ZodObject<{
-    path: z.ZodString;
-    method: z.ZodDefault<z.ZodEnum<{
-        GET: "GET";
-        POST: "POST";
-        PUT: "PUT";
-        DELETE: "DELETE";
-    }>>;
-    tool: z.ZodString;
-    public: z.ZodDefault<z.ZodBoolean>;
-    successRedirect: z.ZodOptional<z.ZodString>;
-    errorRedirect: z.ZodOptional<z.ZodString>;
+  path: z.ZodString;
+  method: z.ZodDefault<z.ZodEnum<{
+    GET: "GET";
+    POST: "POST";
+    PUT: "PUT";
+    DELETE: "DELETE";
+  }>>;
+  tool: z.ZodString;
+  public: z.ZodDefault<z.ZodBoolean>;
+  successRedirect: z.ZodOptional<z.ZodString>;
+  errorRedirect: z.ZodOptional<z.ZodString>;
 }>;
 type ApiRouteDefinition = z.output<typeof apiRouteDefinitionSchema>;
 /**
@@ -147,91 +225,92 @@ type ApiRouteDefinition = z.output<typeof apiRouteDefinitionSchema>;
  * Returned by Shell.getPluginApiRoutes()
  */
 interface RegisteredApiRoute {
-    /** The plugin that registered this route */
-    pluginId: string;
-    /** Full path including /api/{pluginId} prefix */
-    fullPath: string;
-    /** The original route definition */
-    definition: ApiRouteDefinition;
-}
-
+  /** The plugin that registered this route */
+  pluginId: string;
+  /** Full path including /api/{pluginId} prefix */
+  fullPath: string;
+  /** The original route definition */
+  definition: ApiRouteDefinition;
+}
+//#endregion
+//#region ../../shell/plugins/src/types/web-routes.d.ts
 declare const WebRouteMethods: readonly ["GET", "POST", "PUT", "DELETE", "OPTIONS"];
 type WebRouteMethod = (typeof WebRouteMethods)[number];
 type WebRouteHandler = (request: Request) => Response | Promise<Response>;
 interface WebRouteDefinition {
-    /** Absolute mounted path (e.g. "/cms" or "/cms-config") */
-    path: string;
-    /** HTTP method */
-    method?: WebRouteMethod;
-    /** Allow unauthenticated access */
-    public?: boolean;
-    /** Request handler */
-    handler: WebRouteHandler;
+  /** Absolute mounted path (e.g. "/cms" or "/cms-config") */
+  path: string;
+  /** HTTP method */
+  method?: WebRouteMethod;
+  /** Allow unauthenticated access */
+  public?: boolean;
+  /** Request handler */
+  handler: WebRouteHandler;
 }
 interface RegisteredWebRoute {
-    /** The plugin that registered this route */
-    pluginId: string;
-    /** The mounted path */
-    fullPath: string;
-    /** The original route definition */
-    definition: WebRouteDefinition;
-}
-
+  /** The plugin that registered this route */
+  pluginId: string;
+  /** The mounted path */
+  fullPath: string;
+  /** The original route definition */
+  definition: WebRouteDefinition;
+}
+//#endregion
+//#region ../../shell/plugins/src/manager/daemon-types.d.ts
 /**
  * Daemon health status schema
  */
 declare const DaemonHealthSchema: z.ZodObject<{
-    status: z.ZodEnum<{
-        healthy: "healthy";
-        warning: "warning";
-        error: "error";
-        unknown: "unknown";
-    }>;
-    message: z.ZodOptional<z.ZodString>;
-    lastCheck: z.ZodOptional<z.ZodDate>;
-    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  status: z.ZodEnum<{
+    healthy: "healthy";
+    warning: "warning";
+    error: "error";
+    unknown: "unknown";
+  }>;
+  message: z.ZodOptional<z.ZodString>;
+  lastCheck: z.ZodOptional<z.ZodDate>;
+  details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }>;
 type DaemonHealth = z.output<typeof DaemonHealthSchema>;
 /**
  * Daemon status info schema for validation
  */
 declare const DaemonStatusInfoSchema: z.ZodObject<{
-    name: z.ZodString;
-    pluginId: z.ZodString;
-    status: z.ZodString;
-    health: z.ZodOptional<typeof DaemonHealthSchema>;
+  name: z.ZodString;
+  pluginId: z.ZodString;
+  status: z.ZodString;
+  health: z.ZodOptional<typeof DaemonHealthSchema>;
 }>;
 type DaemonStatusInfo = z.output<typeof DaemonStatusInfoSchema>;
 /**
  * Daemon interface for long-running interface processes
  */
 interface Daemon {
-    /**
-     * Start the daemon - called when plugin is initialized
-     */
-    start: () => Promise<void>;
-    /**
-     * Stop the daemon - called when plugin is unloaded/shutdown
-     */
-    stop: () => Promise<void>;
-    /**
-     * Optional health check - called periodically to monitor daemon health
-     */
-    healthCheck?: () => Promise<DaemonHealth>;
+  /**
+   * Start the daemon - called when plugin is initialized
+   */
+  start: () => Promise<void>;
+  /**
+   * Stop the daemon - called when plugin is unloaded/shutdown
+   */
+  stop: () => Promise<void>;
+  /**
+   * Optional health check - called periodically to monitor daemon health
+   */
+  healthCheck?: () => Promise<DaemonHealth>;
 }
 /**
  * Information about a registered daemon
  */
 interface DaemonInfo {
-    name: string;
-    daemon: Daemon;
-    pluginId: string;
-    status: "stopped" | "starting" | "running" | "stopping" | "error";
-    health?: DaemonHealth;
-    error?: Error;
-    startedAt?: Date;
-    stoppedAt?: Date;
-}
-
-export { BaseMessageSchema, GetRoutePayloadSchema, ListRoutesPayloadSchema, MessageResponseSchema, NavigationSlots, RegisterRoutesPayloadSchema, RouteDefinitionSchema, UnregisterRoutesPayloadSchema, UserPermissionLevelSchema };
-export type { ApiRouteDefinition, BaseMessage, Daemon, DaemonHealth, DaemonInfo, DaemonStatusInfo, MessageContext, MessageResponse, MessageSendOptions, MessageSender, MessageWithPayload, PermissionConfig, PermissionRule, RegisteredApiRoute, RegisteredWebRoute, UserPermissionLevel, WebRouteDefinition, WebRouteHandler, WebRouteMethod, WithVisibility };
+  name: string;
+  daemon: Daemon;
+  pluginId: string;
+  status: "stopped" | "starting" | "running" | "stopping" | "error";
+  health?: DaemonHealth;
+  error?: Error;
+  startedAt?: Date;
+  stoppedAt?: Date;
+}
+//#endregion
+export { type ApiRouteDefinition, type BaseMessage, BaseMessageSchema, type Daemon, type DaemonHealth, type DaemonInfo, type DaemonStatusInfo, type EntityDisplayEntry, GetRoutePayloadSchema, ListRoutesPayloadSchema, type MessageContext, type MessageResponse, MessageResponseSchema, type MessageSendOptions, type MessageSender, type MessageWithPayload, type NavigationItem, type NavigationSlot, NavigationSlots, type PermissionConfig, type PermissionRule, RegisterRoutesPayloadSchema, type RegisteredApiRoute, type RegisteredWebRoute, type RouteDefinition, type RouteDefinitionInput, RouteDefinitionSchema, type SectionDefinition, UnregisterRoutesPayloadSchema, type UserPermissionLevel, UserPermissionLevelSchema, type WebRouteDefinition, type WebRouteHandler, type WebRouteMethod, type WithVisibility };