@objectstack/platform-objects 4.0.5 → 4.1.1

package/dist/audit/index.mjs

@@ -7,10 +7,62 @@ var SysAuditLog = ObjectSchema.create({
   pluralLabel: "Audit Logs",
   icon: "scroll-text",
   isSystem: true,
+  managedBy: "append-only",
   description: "Immutable audit trail for platform events",
   displayNameField: "action",
   titleFormat: "{action} \xB7 {object_name}",
   compactLayout: ["created_at", "action", "object_name", "record_id", "user_id"],
+  listViews: {
+    recent: {
+      type: "grid",
+      name: "recent",
+      label: "Recent",
+      data: { provider: "object", object: "sys_audit_log" },
+      columns: ["created_at", "action", "object_name", "record_id", "user_id"],
+      sort: [{ field: "created_at", order: "desc" }],
+      pagination: { pageSize: 50 },
+      emptyState: { title: "No audit events", message: "Activity will appear here as users interact with the platform." }
+    },
+    writes_only: {
+      type: "grid",
+      name: "writes_only",
+      label: "Writes",
+      data: { provider: "object", object: "sys_audit_log" },
+      columns: ["created_at", "action", "object_name", "record_id", "user_id"],
+      filter: [{ field: "action", operator: "in", value: ["create", "update", "delete", "restore"] }],
+      sort: [{ field: "created_at", order: "desc" }],
+      pagination: { pageSize: 50 }
+    },
+    auth_events: {
+      type: "grid",
+      name: "auth_events",
+      label: "Auth",
+      data: { provider: "object", object: "sys_audit_log" },
+      columns: ["created_at", "action", "user_id"],
+      filter: [{ field: "action", operator: "in", value: ["login", "logout", "permission_change"] }],
+      sort: [{ field: "created_at", order: "desc" }],
+      pagination: { pageSize: 50 }
+    },
+    config_changes: {
+      type: "grid",
+      name: "config_changes",
+      label: "Config",
+      data: { provider: "object", object: "sys_audit_log" },
+      columns: ["created_at", "action", "object_name", "user_id"],
+      filter: [{ field: "action", operator: "in", value: ["config_change", "export", "import"] }],
+      sort: [{ field: "created_at", order: "desc" }],
+      pagination: { pageSize: 50 }
+    },
+    all_events: {
+      type: "grid",
+      name: "all_events",
+      label: "All",
+      data: { provider: "object", object: "sys_audit_log" },
+      columns: ["created_at", "action", "object_name", "record_id", "user_id"],
+      sort: [{ field: "created_at", order: "desc" }],
+      pagination: { pageSize: 100 }
+    }
+  },
   fields: {
     // ── Event ────────────────────────────────────────────────────
     created_at: Field.datetime({
@@ -135,6 +187,7 @@ var SysPresence = ObjectSchema.create({
   pluralLabel: "Presences",
   icon: "wifi",
   isSystem: true,
+  managedBy: "append-only",
   description: "Real-time user presence and activity tracking",
   titleFormat: "{user_id} ({status})",
   compactLayout: ["user_id", "status", "last_seen"],
@@ -225,6 +278,7 @@ var SysActivity = ObjectSchema.create({
   pluralLabel: "Activities",
   icon: "activity",
   isSystem: true,
+  managedBy: "append-only",
   description: "Recent activity stream entries (lightweight, denormalized)",
   displayNameField: "summary",
   titleFormat: "{type} \xB7 {summary}",
@@ -366,6 +420,7 @@ var SysComment = ObjectSchema.create({
   pluralLabel: "Comments",
   icon: "message-square",
   isSystem: true,
+  managedBy: "platform",
   description: "Threaded comments attached to records via thread_id",
   displayNameField: "body",
   titleFormat: "{author_name}: {body}",
@@ -481,7 +536,1368 @@ var SysComment = ObjectSchema.create({
     clone: false
   }
 });
+var SysAttachment = ObjectSchema.create({
+  name: "sys_attachment",
+  label: "Attachment",
+  pluralLabel: "Attachments",
+  icon: "paperclip",
+  isSystem: true,
+  managedBy: "platform",
+  description: "Polymorphic link between a sys_file and any other record",
+  titleFormat: "{file_name} \u2192 {parent_object}/{parent_id}",
+  compactLayout: ["created_at", "parent_object", "file_name", "mime_type", "size"],
+  fields: {
+    id: Field.text({
+      label: "Attachment ID",
+      required: true,
+      readonly: true,
+      group: "System"
+    }),
+    // ── Parent (polymorphic) ────────────────────────────────────
+    parent_object: Field.text({
+      label: "Parent Object",
+      required: true,
+      searchable: true,
+      maxLength: 128,
+      description: "Short object name of the attached-to record (e.g. account, lead)",
+      group: "Parent"
+    }),
+    parent_id: Field.text({
+      label: "Parent Record",
+      required: true,
+      searchable: true,
+      maxLength: 64,
+      description: "Primary key of the attached-to record",
+      group: "Parent"
+    }),
+    // ── File reference ──────────────────────────────────────────
+    file_id: Field.lookup("sys_file", {
+      label: "File",
+      required: true,
+      description: "The sys_file storage entry being attached",
+      group: "File"
+    }),
+    file_name: Field.text({
+      label: "File Name",
+      required: false,
+      searchable: true,
+      maxLength: 255,
+      description: "Denormalised copy of sys_file.name for fast list rendering",
+      group: "File"
+    }),
+    mime_type: Field.text({
+      label: "MIME Type",
+      required: false,
+      maxLength: 128,
+      group: "File"
+    }),
+    size: Field.number({
+      label: "Size (bytes)",
+      required: false,
+      group: "File"
+    }),
+    // ── Sharing ────────────────────────────────────────────────
+    share_type: Field.select(
+      ["viewer", "collaborator", "inferred"],
+      {
+        label: "Share Type",
+        defaultValue: "viewer",
+        description: "viewer | collaborator | inferred (inherited from parent record)",
+        group: "Sharing"
+      }
+    ),
+    visibility: Field.select(
+      ["internal", "all_users", "shared_users"],
+      {
+        label: "Visibility",
+        defaultValue: "internal",
+        group: "Sharing"
+      }
+    ),
+    // ── Authoring ──────────────────────────────────────────────
+    uploaded_by: Field.lookup("sys_user", {
+      label: "Uploaded By",
+      required: false,
+      group: "System"
+    }),
+    description: Field.textarea({
+      label: "Description",
+      required: false,
+      maxLength: 1024,
+      group: "File"
+    }),
+    created_at: Field.datetime({
+      label: "Created At",
+      required: true,
+      defaultValue: "NOW()",
+      readonly: true,
+      group: "System"
+    }),
+    updated_at: Field.datetime({
+      label: "Updated At",
+      required: false,
+      group: "System"
+    })
+  },
+  indexes: [
+    { fields: ["parent_object", "parent_id", "created_at"] },
+    { fields: ["file_id"] },
+    { fields: ["uploaded_by"] }
+  ],
+  enable: {
+    trackHistory: false,
+    searchable: true,
+    apiEnabled: true,
+    trash: true,
+    mru: false,
+    clone: false
+  }
+});
+var SysNotification = ObjectSchema.create({
+  name: "sys_notification",
+  label: "Notification",
+  pluralLabel: "Notifications",
+  icon: "bell",
+  isSystem: true,
+  managedBy: "system",
+  description: "Per-user notification inbox entries",
+  displayNameField: "title",
+  titleFormat: "{title}",
+  compactLayout: ["title", "type", "is_read", "created_at"],
+  listViews: {
+    unread: {
+      type: "grid",
+      name: "unread",
+      label: "Unread",
+      data: { provider: "object", object: "sys_notification" },
+      columns: ["type", "title", "recipient_id", "created_at"],
+      filter: [
+        { field: "recipient_id", operator: "equals", value: "{current_user_id}" },
+        { field: "is_read", operator: "equals", value: false }
+      ],
+      sort: [{ field: "created_at", order: "desc" }],
+      pagination: { pageSize: 50 },
+      emptyState: { title: "Inbox zero", message: "No unread notifications." }
+    },
+    mine: {
+      type: "grid",
+      name: "mine",
+      label: "Mine",
+      data: { provider: "object", object: "sys_notification" },
+      columns: ["type", "title", "is_read", "created_at"],
+      filter: [{ field: "recipient_id", operator: "equals", value: "{current_user_id}" }],
+      sort: [{ field: "created_at", order: "desc" }],
+      pagination: { pageSize: 50 }
+    },
+    all_notifications: {
+      type: "grid",
+      name: "all_notifications",
+      label: "All",
+      data: { provider: "object", object: "sys_notification" },
+      columns: ["type", "title", "recipient_id", "is_read", "created_at"],
+      sort: [{ field: "created_at", order: "desc" }],
+      pagination: { pageSize: 100 }
+    }
+  },
+  fields: {
+    id: Field.text({
+      label: "Notification ID",
+      required: true,
+      readonly: true,
+      group: "System"
+    }),
+    // ── Routing ──────────────────────────────────────────────────
+    recipient_id: Field.lookup("sys_user", {
+      label: "Recipient",
+      required: true,
+      searchable: true,
+      description: "User the notification is delivered to",
+      group: "Routing"
+    }),
+    // ── Content ──────────────────────────────────────────────────
+    type: Field.select(
+      ["mention", "assignment", "comment_reply", "lead_converted", "task_due", "system"],
+      {
+        label: "Type",
+        required: true,
+        defaultValue: "system",
+        description: "Notification category \u2014 drives icon + sort priority",
+        group: "Content"
+      }
+    ),
+    title: Field.text({
+      label: "Title",
+      required: true,
+      maxLength: 255,
+      searchable: true,
+      group: "Content"
+    }),
+    body: Field.textarea({
+      label: "Body",
+      required: false,
+      description: "Optional secondary text (one-line summary)",
+      group: "Content"
+    }),
+    // ── Source linkage ───────────────────────────────────────────
+    source_object: Field.text({
+      label: "Source Object",
+      required: false,
+      maxLength: 100,
+      description: "Object name of the related record (e.g. lead, opportunity)",
+      group: "Source"
+    }),
+    source_id: Field.text({
+      label: "Source Record",
+      required: false,
+      maxLength: 100,
+      description: "Record id within source_object",
+      group: "Source"
+    }),
+    url: Field.url({
+      label: "Deep Link",
+      required: false,
+      description: "Optional URL to navigate to when clicked",
+      group: "Source"
+    }),
+    actor_id: Field.lookup("sys_user", {
+      label: "Actor",
+      required: false,
+      description: "User who caused the notification (mentioner, assigner)",
+      group: "Source"
+    }),
+    actor_name: Field.text({
+      label: "Actor Name",
+      required: false,
+      group: "Source"
+    }),
+    // ── Read state ───────────────────────────────────────────────
+    is_read: Field.boolean({
+      label: "Read",
+      defaultValue: false,
+      description: "True once recipient acknowledges",
+      group: "State"
+    }),
+    read_at: Field.datetime({
+      label: "Read At",
+      required: false,
+      group: "State"
+    }),
+    // ── Lifecycle ────────────────────────────────────────────────
+    created_at: Field.datetime({
+      label: "Created At",
+      required: true,
+      defaultValue: "NOW()",
+      readonly: true,
+      group: "System"
+    }),
+    updated_at: Field.datetime({
+      label: "Updated At",
+      required: false,
+      group: "System"
+    })
+  },
+  indexes: [
+    { fields: ["recipient_id", "is_read", "created_at"] },
+    { fields: ["recipient_id", "created_at"] },
+    { fields: ["source_object", "source_id"] }
+  ]
+});
+var SysEmail = ObjectSchema.create({
+  name: "sys_email",
+  label: "Email",
+  pluralLabel: "Emails",
+  icon: "mail",
+  isSystem: true,
+  managedBy: "append-only",
+  description: "Outbound email delivery log",
+  displayNameField: "subject",
+  titleFormat: "{subject}",
+  compactLayout: ["subject", "to", "status", "sent_at"],
+  fields: {
+    id: Field.text({
+      label: "Email ID",
+      required: true,
+      readonly: true,
+      group: "System"
+    }),
+    // ── Envelope ─────────────────────────────────────────────────
+    message_id: Field.text({
+      label: "Message-ID",
+      required: false,
+      maxLength: 255,
+      description: "RFC-5322 Message-ID assigned by the transport",
+      group: "Envelope"
+    }),
+    from_address: Field.text({
+      label: "From",
+      required: true,
+      maxLength: 320,
+      searchable: true,
+      group: "Envelope"
+    }),
+    to_addresses: Field.text({
+      label: "To",
+      required: true,
+      maxLength: 4e3,
+      searchable: true,
+      description: "Comma-separated recipient addresses",
+      group: "Envelope"
+    }),
+    cc_addresses: Field.text({
+      label: "Cc",
+      required: false,
+      maxLength: 4e3,
+      group: "Envelope"
+    }),
+    bcc_addresses: Field.text({
+      label: "Bcc",
+      required: false,
+      maxLength: 4e3,
+      group: "Envelope"
+    }),
+    reply_to: Field.text({
+      label: "Reply-To",
+      required: false,
+      maxLength: 320,
+      group: "Envelope"
+    }),
+    // ── Content ──────────────────────────────────────────────────
+    subject: Field.text({
+      label: "Subject",
+      required: true,
+      maxLength: 998,
+      searchable: true,
+      group: "Content"
+    }),
+    body_text: Field.textarea({
+      label: "Body (text)",
+      required: false,
+      searchable: true,
+      group: "Content"
+    }),
+    body_html: Field.textarea({
+      label: "Body (HTML)",
+      required: false,
+      group: "Content"
+    }),
+    // ── Delivery state ───────────────────────────────────────────
+    status: Field.select(
+      ["queued", "sent", "failed"],
+      {
+        label: "Status",
+        required: true,
+        defaultValue: "queued",
+        description: "Lifecycle state \u2014 queued by IEmailService.send before transport call",
+        group: "State"
+      }
+    ),
+    error: Field.textarea({
+      label: "Error",
+      required: false,
+      description: "Transport error message when status=failed",
+      group: "State"
+    }),
+    attempt_count: Field.number({
+      label: "Attempts",
+      required: false,
+      defaultValue: 0,
+      description: "Number of delivery attempts performed by the service",
+      group: "State"
+    }),
+    sent_at: Field.datetime({
+      label: "Sent At",
+      required: false,
+      description: 'Set when status transitions to "sent"',
+      group: "State"
+    }),
+    // ── Source linkage ───────────────────────────────────────────
+    related_object: Field.text({
+      label: "Related Object",
+      required: false,
+      maxLength: 100,
+      description: "Object name of the related record (e.g. lead, opportunity)",
+      group: "Source"
+    }),
+    related_id: Field.text({
+      label: "Related Record",
+      required: false,
+      maxLength: 100,
+      description: "Record id within related_object",
+      group: "Source"
+    }),
+    sent_by: Field.lookup("sys_user", {
+      label: "Sent By",
+      required: false,
+      group: "Source"
+    }),
+    // ── Lifecycle ────────────────────────────────────────────────
+    created_at: Field.datetime({
+      label: "Created At",
+      required: true,
+      defaultValue: "NOW()",
+      readonly: true,
+      group: "System"
+    }),
+    updated_at: Field.datetime({
+      label: "Updated At",
+      required: false,
+      group: "System"
+    })
+  },
+  indexes: [
+    { fields: ["status", "created_at"] },
+    { fields: ["related_object", "related_id"] },
+    { fields: ["sent_by"] }
+  ]
+});
+var SysEmailTemplate = ObjectSchema.create({
+  name: "sys_email_template",
+  label: "Email Template",
+  pluralLabel: "Email Templates",
+  icon: "mail",
+  isSystem: true,
+  managedBy: "config",
+  description: "Outbound email template (subject + body + variables) resolved by name+locale",
+  displayNameField: "label",
+  titleFormat: "{label}",
+  compactLayout: ["name", "label", "category", "locale", "active"],
+  fields: {
+    id: Field.text({
+      label: "ID",
+      required: true,
+      readonly: true,
+      group: "System"
+    }),
+    // ── Identity ─────────────────────────────────────────────────
+    name: Field.text({
+      label: "Name",
+      required: true,
+      maxLength: 128,
+      description: "Dotted snake_case identifier (e.g. auth.password_reset)",
+      group: "Identity"
+    }),
+    label: Field.text({
+      label: "Label",
+      required: true,
+      maxLength: 200,
+      description: "Human-readable name shown in Studio",
+      group: "Identity"
+    }),
+    category: Field.select(
+      ["auth", "notification", "workflow", "marketing", "custom"],
+      {
+        label: "Category",
+        required: true,
+        defaultValue: "custom",
+        group: "Identity"
+      }
+    ),
+    locale: Field.text({
+      label: "Locale",
+      required: true,
+      defaultValue: "en-US",
+      maxLength: 16,
+      description: "BCP-47 locale tag (en-US, zh-CN, \u2026)",
+      group: "Identity"
+    }),
+    description: Field.textarea({
+      label: "Description",
+      required: false,
+      group: "Identity"
+    }),
+    // ── Content ──────────────────────────────────────────────────
+    subject: Field.text({
+      label: "Subject",
+      required: true,
+      maxLength: 500,
+      description: "Subject template; supports {{var.path}} placeholders",
+      group: "Content"
+    }),
+    body_html: Field.textarea({
+      label: "HTML Body",
+      required: true,
+      description: "HTML body template; supports {{var.path}} placeholders",
+      group: "Content"
+    }),
+    body_text: Field.textarea({
+      label: "Plain Text Body",
+      required: false,
+      description: "Optional plain-text alternative (auto-derived from HTML when blank)",
+      group: "Content"
+    }),
+    // ── Envelope overrides ───────────────────────────────────────
+    from_name: Field.text({
+      label: "From Name",
+      required: false,
+      maxLength: 200,
+      group: "Envelope"
+    }),
+    from_address: Field.text({
+      label: "From Address",
+      required: false,
+      maxLength: 255,
+      group: "Envelope"
+    }),
+    reply_to: Field.text({
+      label: "Reply-To",
+      required: false,
+      maxLength: 255,
+      group: "Envelope"
+    }),
+    // ── Lifecycle ────────────────────────────────────────────────
+    active: Field.boolean({
+      label: "Active",
+      required: true,
+      defaultValue: true,
+      group: "Lifecycle"
+    }),
+    is_system: Field.boolean({
+      label: "System Template",
+      required: false,
+      defaultValue: false,
+      readonly: true,
+      description: "Provided by a plugin / platform; tenants may edit but should not delete",
+      group: "Lifecycle"
+    }),
+    /**
+     * Variables declared by the template author. Stored as JSON text
+     * (array of {name,type,required,description}). Used by the Studio
+     * authoring UI to render form hints and by sendTemplate() to
+     * validate required vars at runtime.
+     */
+    variables_json: Field.textarea({
+      label: "Variables (JSON)",
+      required: false,
+      description: "JSON array of {name,type,required,description}",
+      group: "Lifecycle"
+    }),
+    created_at: Field.datetime({
+      label: "Created At",
+      required: true,
+      defaultValue: "NOW()",
+      readonly: true,
+      group: "System"
+    }),
+    updated_at: Field.datetime({ label: "Updated At", required: false, group: "System" })
+  },
+  indexes: [
+    { fields: ["name", "locale"], unique: true },
+    { fields: ["category"] },
+    { fields: ["active"] }
+  ]
+});
+var SysSavedReport = ObjectSchema.create({
+  name: "sys_saved_report",
+  label: "Saved Report",
+  pluralLabel: "Saved Reports",
+  icon: "bar-chart",
+  isSystem: true,
+  managedBy: "platform",
+  description: "Persisted ObjectQL report definition \u2014 re-runnable and schedulable",
+  displayNameField: "name",
+  titleFormat: "{name}",
+  compactLayout: ["name", "object_name", "format", "owner_id", "updated_at"],
+  fields: {
+    id: Field.text({
+      label: "Report ID",
+      required: true,
+      readonly: true,
+      group: "System"
+    }),
+    name: Field.text({
+      label: "Name",
+      required: true,
+      maxLength: 200,
+      searchable: true,
+      group: "Definition"
+    }),
+    description: Field.textarea({
+      label: "Description",
+      required: false,
+      group: "Definition"
+    }),
+    object_name: Field.text({
+      label: "Object",
+      required: true,
+      maxLength: 100,
+      description: "Short object name the report queries",
+      group: "Definition"
+    }),
+    query_json: Field.textarea({
+      label: "Query",
+      required: true,
+      description: "ObjectQL query envelope \u2014 { filter, fields, orderBy, limit, groupBy }",
+      group: "Definition"
+    }),
+    format: Field.select(
+      ["csv", "json", "html_table"],
+      {
+        label: "Format",
+        required: true,
+        defaultValue: "csv",
+        description: "Rendering used by IReportService.run() and email digests",
+        group: "Definition"
+      }
+    ),
+    owner_id: Field.lookup("sys_user", {
+      label: "Owner",
+      required: false,
+      description: "User that owns the report definition (drives sharing)",
+      group: "Provenance"
+    }),
+    last_run_at: Field.datetime({
+      label: "Last Run",
+      required: false,
+      description: "Stamped by IReportService.run() on successful execution",
+      group: "State"
+    }),
+    last_row_count: Field.number({
+      label: "Last Row Count",
+      required: false,
+      group: "State"
+    }),
+    created_at: Field.datetime({
+      label: "Created At",
+      required: true,
+      defaultValue: "NOW()",
+      readonly: true,
+      group: "System"
+    }),
+    updated_at: Field.datetime({
+      label: "Updated At",
+      required: false,
+      group: "System"
+    })
+  },
+  indexes: [
+    { fields: ["object_name"] },
+    { fields: ["owner_id"] },
+    { fields: ["name"] }
+  ]
+});
+var SysReportSchedule = ObjectSchema.create({
+  name: "sys_report_schedule",
+  label: "Report Schedule",
+  pluralLabel: "Report Schedules",
+  icon: "clock",
+  isSystem: true,
+  managedBy: "platform",
+  description: "Recurring delivery of a sys_saved_report via email",
+  titleFormat: "{report_id} \u2192 {recipients}",
+  compactLayout: ["report_id", "recipients", "interval_minutes", "active", "next_run_at"],
+  fields: {
+    id: Field.text({
+      label: "Schedule ID",
+      required: true,
+      readonly: true,
+      group: "System"
+    }),
+    report_id: Field.lookup("sys_saved_report", {
+      label: "Report",
+      required: true,
+      group: "Schedule"
+    }),
+    name: Field.text({
+      label: "Name",
+      required: false,
+      maxLength: 200,
+      description: "Optional label for the digest \u2014 used in the email subject",
+      group: "Schedule"
+    }),
+    interval_minutes: Field.number({
+      label: "Interval (minutes)",
+      required: false,
+      defaultValue: 1440,
+      description: "How often to send (1440 = daily, 10080 = weekly)",
+      group: "Schedule"
+    }),
+    cron_expression: Field.text({
+      label: "Cron Expression",
+      required: false,
+      maxLength: 100,
+      description: "Optional 5/6-field cron \u2014 overrides interval_minutes when present",
+      group: "Schedule"
+    }),
+    timezone: Field.text({
+      label: "Timezone",
+      required: false,
+      maxLength: 64,
+      defaultValue: "UTC",
+      group: "Schedule"
+    }),
+    active: Field.boolean({
+      label: "Active",
+      required: true,
+      defaultValue: true,
+      group: "Schedule"
+    }),
+    recipients: Field.text({
+      label: "Recipients",
+      required: true,
+      maxLength: 4e3,
+      description: "Comma-separated email addresses",
+      group: "Delivery"
+    }),
+    format: Field.select(
+      ["csv", "html_table"],
+      {
+        label: "Format",
+        required: false,
+        defaultValue: "html_table",
+        description: "Render format \u2014 csv is attached, html_table is inlined",
+        group: "Delivery"
+      }
+    ),
+    subject_template: Field.text({
+      label: "Subject Template",
+      required: false,
+      maxLength: 200,
+      description: "Email subject; {{name}} / {{date}} / {{rows}} are substituted",
+      group: "Delivery"
+    }),
+    owner_id: Field.lookup("sys_user", {
+      label: "Owner",
+      required: false,
+      group: "Provenance"
+    }),
+    next_run_at: Field.datetime({
+      label: "Next Run",
+      required: false,
+      description: "Dispatcher loads schedules where next_run_at <= now",
+      group: "State"
+    }),
+    last_sent_at: Field.datetime({
+      label: "Last Sent",
+      required: false,
+      group: "State"
+    }),
+    last_status: Field.select(
+      ["ok", "failed", "skipped"],
+      {
+        label: "Last Status",
+        required: false,
+        group: "State"
+      }
+    ),
+    last_error: Field.textarea({
+      label: "Last Error",
+      required: false,
+      group: "State"
+    }),
+    created_at: Field.datetime({
+      label: "Created At",
+      required: true,
+      defaultValue: "NOW()",
+      readonly: true,
+      group: "System"
+    }),
+    updated_at: Field.datetime({
+      label: "Updated At",
+      required: false,
+      group: "System"
+    })
+  },
+  indexes: [
+    // Hot path for the dispatch loop.
+    { fields: ["active", "next_run_at"] },
+    { fields: ["report_id"] },
+    { fields: ["owner_id"] }
+  ]
+});
+var SysApprovalProcess = ObjectSchema.create({
+  name: "sys_approval_process",
+  label: "Approval Process",
+  pluralLabel: "Approval Processes",
+  icon: "check-square",
+  isSystem: true,
+  managedBy: "config",
+  // Authoring an approval process requires a visual step designer that
+  // doesn't yet exist — the embedded `definition_json` textarea would
+  // force admins to hand-write a multi-page ApprovalProcess envelope.
+  // Suppress generic CRUD until the designer lands. Real authoring path:
+  // call `defineApprovalProcess({...})` in code and seed via the
+  // approvals service (`POST /api/v1/approvals/processes`) or commit the
+  // definition as a fixture. Editing existing rows (e.g. toggling
+  // `active`) is also suppressed for now because the same textarea would
+  // appear; use the service API or a future designer instead.
+  userActions: { create: false, edit: false, delete: false, import: false },
+  description: "Persisted approval process definition. Authored via defineApprovalProcess() in code; visual designer is on the roadmap.",
+  displayNameField: "name",
+  titleFormat: "{label}",
+  compactLayout: ["name", "object_name", "active", "updated_at"],
+  listViews: {
+    active: {
+      type: "grid",
+      name: "active",
+      label: "Active",
+      data: { provider: "object", object: "sys_approval_process" },
+      columns: ["label", "object_name", "active", "updated_at"],
+      filter: [{ field: "active", operator: "equals", value: true }],
+      sort: [{ field: "label", order: "asc" }],
+      pagination: { pageSize: 50 }
+    },
+    inactive: {
+      type: "grid",
+      name: "inactive",
+      label: "Inactive",
+      data: { provider: "object", object: "sys_approval_process" },
+      columns: ["label", "object_name", "active", "updated_at"],
+      filter: [{ field: "active", operator: "equals", value: false }],
+      sort: [{ field: "label", order: "asc" }],
+      pagination: { pageSize: 50 }
+    },
+    by_object: {
+      type: "grid",
+      name: "by_object",
+      label: "By Object",
+      data: { provider: "object", object: "sys_approval_process" },
+      columns: ["object_name", "label", "active", "updated_at"],
+      sort: [{ field: "object_name", order: "asc" }, { field: "label", order: "asc" }],
+      grouping: { fields: [{ field: "object_name", order: "asc", collapsed: false }] },
+      pagination: { pageSize: 100 }
+    },
+    all_processes: {
+      type: "grid",
+      name: "all_processes",
+      label: "All",
+      data: { provider: "object", object: "sys_approval_process" },
+      columns: ["label", "object_name", "active", "updated_at"],
+      sort: [{ field: "label", order: "asc" }],
+      pagination: { pageSize: 50 }
+    }
+  },
+  fields: {
+    id: Field.text({ label: "Process ID", required: true, readonly: true, group: "System" }),
+    name: Field.text({
+      label: "Name",
+      required: true,
+      maxLength: 100,
+      description: "Unique snake_case name \u2014 referenced by submitters and audit rows",
+      group: "Definition"
+    }),
+    label: Field.text({
+      label: "Display Label",
+      required: true,
+      maxLength: 200,
+      group: "Definition"
+    }),
+    object_name: Field.text({
+      label: "Object",
+      required: true,
+      maxLength: 100,
+      description: "Short object name this process governs",
+      group: "Definition"
+    }),
+    description: Field.textarea({ label: "Description", required: false, group: "Definition" }),
+    active: Field.boolean({
+      label: "Active",
+      required: true,
+      defaultValue: false,
+      description: "Only active processes are dispatched on submission",
+      group: "Definition"
+    }),
+    definition_json: Field.textarea({
+      label: "Definition",
+      required: true,
+      description: "Serialised ApprovalProcess JSON (see @objectstack/spec/automation/approval)",
+      group: "Definition"
+    }),
+    created_at: Field.datetime({
+      label: "Created At",
+      required: true,
+      defaultValue: "NOW()",
+      readonly: true,
+      group: "System"
+    }),
+    updated_at: Field.datetime({ label: "Updated At", required: false, group: "System" })
+  },
+  indexes: [
+    { fields: ["name"], unique: true },
+    { fields: ["object_name"] },
+    { fields: ["active", "object_name"] }
+  ]
+});
+var SysApprovalRequest = ObjectSchema.create({
+  name: "sys_approval_request",
+  label: "Approval Request",
+  pluralLabel: "Approval Requests",
+  icon: "inbox",
+  isSystem: true,
+  managedBy: "system",
+  description: "Live approval instance tracked per submission",
+  displayNameField: "id",
+  titleFormat: "{process_name} \xB7 {record_id}",
+  compactLayout: ["process_name", "object_name", "record_id", "status", "current_step", "submitter_id", "updated_at"],
+  // Curated built-in list views — render as segmented tabs in the console.
+  // Filters use {current_user_id} substitution wired by the console.
+  listViews: {
+    my_pending: {
+      type: "grid",
+      name: "my_pending",
+      label: "My Pending",
+      data: { provider: "object", object: "sys_approval_request" },
+      columns: ["process_name", "object_name", "record_id", "current_step", "submitter_id", "updated_at"],
+      filter: [
+        { field: "status", operator: "equals", value: "pending" },
+        { field: "pending_approvers", operator: "contains", value: "{current_user_id}" }
+      ],
+      sort: [{ field: "updated_at", order: "desc" }],
+      pagination: { pageSize: 25 },
+      emptyState: { title: "No pending approvals", message: "You're all caught up." }
+    },
+    submitted_by_me: {
+      type: "grid",
+      name: "submitted_by_me",
+      label: "I Submitted",
+      data: { provider: "object", object: "sys_approval_request" },
+      columns: ["process_name", "object_name", "record_id", "status", "current_step", "updated_at"],
+      filter: [{ field: "submitter_id", operator: "equals", value: "{current_user_id}" }],
+      sort: [{ field: "updated_at", order: "desc" }],
+      pagination: { pageSize: 25 }
+    },
+    completed: {
+      type: "grid",
+      name: "completed",
+      label: "Completed",
+      data: { provider: "object", object: "sys_approval_request" },
+      columns: ["process_name", "object_name", "record_id", "status", "submitter_id", "completed_at"],
+      filter: [{ field: "status", operator: "in", value: ["approved", "rejected", "recalled"] }],
+      sort: [{ field: "completed_at", order: "desc" }],
+      pagination: { pageSize: 25 }
+    },
+    all_requests: {
+      type: "grid",
+      name: "all_requests",
+      label: "All",
+      data: { provider: "object", object: "sys_approval_request" },
+      columns: ["process_name", "object_name", "record_id", "status", "current_step", "submitter_id", "updated_at"],
+      sort: [{ field: "updated_at", order: "desc" }],
+      pagination: { pageSize: 50 }
+    }
+  },
+  fields: {
+    id: Field.text({ label: "Request ID", required: true, readonly: true, group: "System" }),
+    organization_id: Field.lookup("sys_organization", {
+      label: "Organization",
+      required: false,
+      group: "System",
+      description: "Tenant that owns this approval request (propagated from submitter context)"
+    }),
+    process_name: Field.text({
+      label: "Process",
+      required: true,
+      maxLength: 100,
+      description: "sys_approval_process.name this request was opened against",
+      group: "Target"
+    }),
+    object_name: Field.text({
+      label: "Object",
+      required: true,
+      maxLength: 100,
+      group: "Target"
+    }),
+    record_id: Field.text({
+      label: "Record ID",
+      required: true,
+      maxLength: 100,
+      group: "Target"
+    }),
+    submitter_id: Field.lookup("sys_user", {
+      label: "Submitter",
+      required: false,
+      group: "Target"
+    }),
+    submitter_comment: Field.textarea({
+      label: "Submitter Comment",
+      required: false,
+      group: "Target"
+    }),
+    status: Field.select(
+      ["pending", "approved", "rejected", "recalled"],
+      {
+        label: "Status",
+        required: true,
+        defaultValue: "pending",
+        description: "Lifecycle state of the request",
+        group: "State"
+      }
+    ),
+    current_step: Field.text({
+      label: "Current Step",
+      required: false,
+      maxLength: 100,
+      description: "Machine name of the step awaiting approval",
+      group: "State"
+    }),
+    current_step_index: Field.number({
+      label: "Current Step Index",
+      required: false,
+      defaultValue: 0,
+      group: "State"
+    }),
+    pending_approvers: Field.textarea({
+      label: "Pending Approvers",
+      required: false,
+      description: "Comma-separated user ids who can act on the current step",
+      group: "State"
+    }),
+    payload_json: Field.textarea({
+      label: "Snapshot",
+      required: false,
+      description: "Record snapshot at submission time",
+      group: "State"
+    }),
+    completed_at: Field.datetime({
+      label: "Completed At",
+      required: false,
+      group: "State"
+    }),
+    created_at: Field.datetime({
+      label: "Created At",
+      required: true,
+      defaultValue: "NOW()",
+      readonly: true,
+      group: "System"
+    }),
+    updated_at: Field.datetime({ label: "Updated At", required: false, group: "System" })
+  },
+  indexes: [
+    // Look up "is there a pending request for this record?" — common
+    // guard on submit and on edit-while-locked checks.
+    { fields: ["object_name", "record_id"] },
+    { fields: ["status", "object_name"] },
+    // "My approvals" inbox — pending_approvers is a CSV string so this
+    // index only helps with status pre-filtering; the engine does a
+    // post-filter substring match per row.
+    { fields: ["status", "updated_at"] },
+    { fields: ["submitter_id", "status"] }
+  ]
+});
+var SysApprovalAction = ObjectSchema.create({
+  name: "sys_approval_action",
+  label: "Approval Action",
+  pluralLabel: "Approval Actions",
+  icon: "check-circle",
+  isSystem: true,
+  managedBy: "append-only",
+  description: "Append-only audit trail for approval actions",
+  displayNameField: "id",
+  titleFormat: "{action} \xB7 {step_name}",
+  compactLayout: ["request_id", "step_name", "action", "actor_id", "created_at"],
+  listViews: {
+    recent: {
+      type: "grid",
+      name: "recent",
+      label: "Recent",
+      data: { provider: "object", object: "sys_approval_action" },
+      columns: ["created_at", "request_id", "step_name", "action", "actor_id", "comment"],
+      sort: [{ field: "created_at", order: "desc" }],
+      pagination: { pageSize: 50 },
+      emptyState: { title: "No approval actions yet", message: "Actions are logged automatically when approvals progress." }
+    },
+    by_actor: {
+      type: "grid",
+      name: "by_actor",
+      label: "By Actor",
+      data: { provider: "object", object: "sys_approval_action" },
+      columns: ["actor_id", "created_at", "request_id", "step_name", "action"],
+      sort: [{ field: "actor_id", order: "asc" }, { field: "created_at", order: "desc" }],
+      grouping: { fields: [{ field: "actor_id", order: "asc", collapsed: false }] },
+      pagination: { pageSize: 100 }
+    },
+    all_actions: {
+      type: "grid",
+      name: "all_actions",
+      label: "All",
+      data: { provider: "object", object: "sys_approval_action" },
+      columns: ["created_at", "request_id", "step_name", "action", "actor_id", "comment"],
+      sort: [{ field: "created_at", order: "desc" }],
+      pagination: { pageSize: 100 }
+    }
+  },
+  fields: {
+    id: Field.text({ label: "Action ID", required: true, readonly: true, group: "System" }),
+    organization_id: Field.lookup("sys_organization", {
+      label: "Organization",
+      required: false,
+      group: "System",
+      description: "Tenant that owns this action (mirrors the parent request)"
+    }),
+    request_id: Field.lookup("sys_approval_request", {
+      label: "Request",
+      required: true,
+      group: "Target"
+    }),
+    step_name: Field.text({
+      label: "Step",
+      required: false,
+      maxLength: 100,
+      description: "Machine name of the step at the time of the action",
+      group: "Target"
+    }),
+    step_index: Field.number({
+      label: "Step Index",
+      required: false,
+      group: "Target"
+    }),
+    action: Field.select(
+      ["submit", "approve", "reject", "recall", "escalate"],
+      {
+        label: "Action",
+        required: true,
+        group: "Action"
+      }
+    ),
+    actor_id: Field.lookup("sys_user", {
+      label: "Actor",
+      required: false,
+      group: "Action"
+    }),
+    comment: Field.textarea({ label: "Comment", required: false, group: "Action" }),
+    created_at: Field.datetime({
+      label: "Created At",
+      required: true,
+      defaultValue: "NOW()",
+      readonly: true,
+      group: "System"
+    })
+  },
+  indexes: [
+    { fields: ["request_id", "created_at"] },
+    { fields: ["request_id", "step_index", "action"] }
+  ]
+});
+var SysJob = ObjectSchema.create({
+  name: "sys_job",
+  label: "Background Job",
+  pluralLabel: "Background Jobs",
+  icon: "clock",
+  isSystem: true,
+  managedBy: "system",
+  description: "Catalogue of registered background jobs",
+  displayNameField: "name",
+  titleFormat: "{name}",
+  compactLayout: ["name", "schedule_type", "active", "last_run_at", "last_status"],
+  fields: {
+    id: Field.text({ label: "Job ID", required: true, readonly: true, group: "System" }),
+    name: Field.text({
+      label: "Job Name",
+      required: true,
+      maxLength: 255,
+      searchable: true,
+      description: "Unique job identifier (snake_case)",
+      group: "Identity"
+    }),
+    schedule_type: Field.select(["cron", "interval", "once"], {
+      label: "Schedule Type",
+      required: true,
+      group: "Schedule"
+    }),
+    schedule_expression: Field.text({
+      label: "Expression",
+      required: false,
+      maxLength: 200,
+      description: "Cron expression / interval ms / ISO datetime",
+      group: "Schedule"
+    }),
+    timezone: Field.text({
+      label: "Timezone",
+      required: false,
+      maxLength: 100,
+      group: "Schedule"
+    }),
+    active: Field.boolean({
+      label: "Active",
+      required: true,
+      defaultValue: true,
+      description: "Whether the scheduler is currently running this job",
+      group: "State"
+    }),
+    last_run_at: Field.datetime({ label: "Last Run At", required: false, group: "State" }),
+    last_status: Field.select(
+      ["success", "failed", "timeout", "running"],
+      { label: "Last Status", required: false, group: "State" }
+    ),
+    last_error: Field.textarea({ label: "Last Error", required: false, group: "State" }),
+    run_count: Field.number({ label: "Run Count", required: false, defaultValue: 0, group: "State" }),
+    failure_count: Field.number({ label: "Failure Count", required: false, defaultValue: 0, group: "State" }),
+    created_at: Field.datetime({
+      label: "Created At",
+      required: true,
+      defaultValue: "NOW()",
+      readonly: true,
+      group: "System"
+    }),
+    updated_at: Field.datetime({ label: "Updated At", required: false, group: "System" })
+  },
+  indexes: [
+    { fields: ["name"], unique: true },
+    { fields: ["active"] }
+  ]
+});
+var SysJobRun = ObjectSchema.create({
+  name: "sys_job_run",
+  label: "Job Run",
+  pluralLabel: "Job Runs",
+  icon: "play",
+  isSystem: true,
+  managedBy: "append-only",
+  description: "Background job execution audit trail",
+  displayNameField: "job_name",
+  titleFormat: "{job_name} @ {started_at}",
+  compactLayout: ["job_name", "status", "started_at", "duration_ms", "attempt"],
+  fields: {
+    id: Field.text({ label: "Run ID", required: true, readonly: true, group: "System" }),
+    job_name: Field.text({
+      label: "Job",
+      required: true,
+      maxLength: 255,
+      searchable: true,
+      group: "Identity"
+    }),
+    status: Field.select(
+      ["running", "success", "failed", "timeout"],
+      { label: "Status", required: true, defaultValue: "running", group: "State" }
+    ),
+    started_at: Field.datetime({ label: "Started At", required: true, group: "State" }),
+    completed_at: Field.datetime({ label: "Completed At", required: false, group: "State" }),
+    duration_ms: Field.number({ label: "Duration (ms)", required: false, group: "State" }),
+    attempt: Field.number({
+      label: "Attempt",
+      required: false,
+      defaultValue: 1,
+      description: "1 for first run, >1 for retries/replays",
+      group: "State"
+    }),
+    trigger: Field.select(
+      ["schedule", "manual", "replay"],
+      { label: "Trigger", required: false, defaultValue: "schedule", group: "State" }
+    ),
+    error: Field.textarea({ label: "Error", required: false, group: "State" }),
+    created_at: Field.datetime({
+      label: "Created At",
+      required: true,
+      defaultValue: "NOW()",
+      readonly: true,
+      group: "System"
+    })
+  },
+  indexes: [
+    { fields: ["job_name", "started_at"] },
+    { fields: ["status", "started_at"] }
+  ]
+});
+var SysJobQueue = ObjectSchema.create({
+  name: "sys_job_queue",
+  label: "Job Queue Message",
+  pluralLabel: "Job Queue Messages",
+  icon: "inbox",
+  isSystem: true,
+  managedBy: "system",
+  description: "Durable job/message queue including dead letters",
+  displayNameField: "queue",
+  titleFormat: "{queue} #{id}",
+  compactLayout: ["queue", "status", "attempts", "scheduled_for", "last_error"],
+  fields: {
+    id: Field.text({ label: "Message ID", required: true, readonly: true, group: "System" }),
+    queue: Field.text({
+      label: "Queue",
+      required: true,
+      maxLength: 255,
+      searchable: true,
+      description: "Logical queue name (snake_case)",
+      group: "Identity"
+    }),
+    idempotency_key: Field.text({
+      label: "Idempotency Key",
+      required: false,
+      maxLength: 255,
+      description: "Deduplication key within (queue, window)",
+      group: "Identity"
+    }),
+    payload_json: Field.textarea({
+      label: "Payload (JSON)",
+      required: false,
+      description: "Serialized message body",
+      group: "Content"
+    }),
+    metadata_json: Field.textarea({
+      label: "Metadata (JSON)",
+      required: false,
+      description: "Serialized metadata bag (tenant_id, source_record, ...)",
+      group: "Content"
+    }),
+    status: Field.select(
+      ["pending", "running", "completed", "failed", "dlq"],
+      {
+        label: "Status",
+        required: true,
+        defaultValue: "pending",
+        description: "Lifecycle state",
+        group: "State"
+      }
+    ),
+    priority: Field.number({
+      label: "Priority",
+      required: false,
+      defaultValue: 100,
+      description: "Lower = higher priority",
+      group: "Schedule"
+    }),
+    attempts: Field.number({ label: "Attempts", required: false, defaultValue: 0, group: "State" }),
+    max_attempts: Field.number({ label: "Max Attempts", required: false, defaultValue: 3, group: "State" }),
+    backoff_type: Field.select(
+      ["fixed", "exponential"],
+      { label: "Backoff", required: false, defaultValue: "exponential", group: "Schedule" }
+    ),
+    backoff_delay_ms: Field.number({
+      label: "Backoff Base (ms)",
+      required: false,
+      defaultValue: 1e3,
+      group: "Schedule"
+    }),
+    backoff_max_delay_ms: Field.number({
+      label: "Backoff Cap (ms)",
+      required: false,
+      group: "Schedule"
+    }),
+    scheduled_for: Field.datetime({
+      label: "Scheduled For",
+      required: false,
+      description: "Earliest time a worker may lease this message",
+      group: "Schedule"
+    }),
+    locked_by: Field.text({
+      label: "Locked By",
+      required: false,
+      maxLength: 255,
+      description: "Worker id holding the lease",
+      group: "Lease"
+    }),
+    locked_until: Field.datetime({
+      label: "Locked Until",
+      required: false,
+      description: "Lease expiry; if past, another worker may claim",
+      group: "Lease"
+    }),
+    last_error: Field.textarea({ label: "Last Error", required: false, group: "State" }),
+    completed_at: Field.datetime({ label: "Completed At", required: false, group: "State" }),
+    created_at: Field.datetime({
+      label: "Created At",
+      required: true,
+      defaultValue: "NOW()",
+      readonly: true,
+      group: "System"
+    }),
+    updated_at: Field.datetime({ label: "Updated At", required: false, group: "System" })
+  },
+  indexes: [
+    { fields: ["queue", "status", "scheduled_for"] },
+    { fields: ["idempotency_key", "queue"] },
+    { fields: ["status"] }
+  ]
+});
 
-export { SysActivity, SysAuditLog, SysComment, SysPresence };
+export { SysActivity, SysApprovalAction, SysApprovalProcess, SysApprovalRequest, SysAttachment, SysAuditLog, SysComment, SysEmail, SysEmailTemplate, SysJob, SysJobQueue, SysJobRun, SysNotification, SysPresence, SysReportSchedule, SysSavedReport };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map