refactor(examples): author metadata via defineX factories (#2035)

Migrates every example authoring file across crm/showcase/todo from bare
output-type literals (`: Page`, `: UI.ActionInput`, …) to the corresponding
defineX factory. The factory accepts input-shape config and validates each
definition at module load, so a malformed metadata object now fails loudly at
authoring time instead of silently passing as `any` (#2023).

Covers 36 files / 16 domains — including files the *.{domain}.ts filename scan
missed (reports/index.ts, actions/index.ts, security/sales-roles.ts, …), which
the new lint guard surfaced.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: os-zhuang

examples/app-crm/src/actions/convert-lead.action.ts

@@ -1,12 +1,12 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 
-import type * as UI from '@objectstack/spec/ui';
+import { defineAction } from '@objectstack/spec/ui';
 
 /**
  * Row-level action on crm_lead — launches the Convert Lead screen flow wizard.
  * Shown as a button in the lead list row menu and in the lead record header.
  */
-export const ConvertLeadAction: UI.ActionInput = {
+export const ConvertLeadAction = defineAction({
   name: 'crm_convert_lead',
   label: 'Convert Lead',
   icon: 'ArrowRightCircle',
@@ -20,4 +20,4 @@ export const ConvertLeadAction: UI.ActionInput = {
   // hitting the flow's "already converted" guard screen. The flow keeps that
   // guard as a server-side backstop.
   visible: 'record.status != "converted"',
-};
+});

examples/app-crm/src/actions/park-lead.action.ts

@@ -1,6 +1,6 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 
-import type * as UI from '@objectstack/spec/ui';
+import { defineAction } from '@objectstack/spec/ui';
 
 /**
  * Row-level action on crm_lead — reassign the lead's owner.
@@ -11,7 +11,7 @@ import type * as UI from '@objectstack/spec/ui';
  * UndoManager — Ctrl+Z works too). Prompts for the new owner via one param
  * (pre-filled with "Triage Queue").
  */
-export const ParkLeadAction: UI.ActionInput = {
+export const ParkLeadAction = defineAction({
   name: 'crm_park_lead',
   label: 'Reassign Lead',
   icon: 'UserPlus',
@@ -32,4 +32,4 @@ export const ParkLeadAction: UI.ActionInput = {
   ],
   undoable: true,
   successMessage: 'Lead reassigned.',
-};
+});

examples/app-crm/src/analytics/crm.cube.ts

@@ -1,12 +1,12 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 
-import type { Cube } from '@objectstack/spec/data';
+import { defineCube } from '@objectstack/spec/data';
 
 /**
  * Opportunity Pipeline Cube — revenue metrics broken down by stage,
  * owner, and account for the CRM sales dashboard.
  */
-export const PipelineCube: Cube = {
+export const PipelineCube = defineCube({
   name: 'crm_pipeline',
   title: 'CRM Pipeline',
   description: 'Revenue and deal-count analytics across the sales pipeline.',
@@ -71,12 +71,12 @@ export const PipelineCube: Cube = {
     every: '1 hour',
   },
   public: false,
-};
+});
 
 /**
  * Lead funnel cube — conversion metrics from lead to opportunity.
  */
-export const LeadFunnelCube: Cube = {
+export const LeadFunnelCube = defineCube({
   name: 'crm_lead_funnel',
   title: 'CRM Lead Funnel',
   description: 'Lead volume and conversion rate analytics.',
@@ -119,4 +119,4 @@ export const LeadFunnelCube: Cube = {
     every: '30 minutes',
   },
   public: false,
-};
+});

examples/app-crm/src/connectors/crm-connectors.ts

@@ -1,12 +1,12 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 
-import type { ConnectorInput } from '@objectstack/spec/integration';
+import { defineConnector } from '@objectstack/spec/integration';
 
 /**
  * HubSpot connector — sync contacts and deals bi-directionally.
  * Uses OAuth2 for authentication; actual credentials come from environment.
  */
-export const HubSpotConnector: ConnectorInput = {
+export const HubSpotConnector = defineConnector({
   name: 'hubspot_crm',
   label: 'HubSpot CRM',
   type: 'saas',
@@ -86,12 +86,12 @@ export const HubSpotConnector: ConnectorInput = {
   requestTimeoutMs: 30000,
   status: 'inactive',
   enabled: true,
-};
+});
 
 /**
  * Slack connector — post notifications to channels.
  */
-export const SlackConnector: ConnectorInput = {
+export const SlackConnector = defineConnector({
   name: 'slack_notifications',
   label: 'Slack',
   type: 'api',
@@ -123,4 +123,4 @@ export const SlackConnector: ConnectorInput = {
   },
   status: 'inactive',
   enabled: true,
-};
+});

examples/app-crm/src/data/crm-mappings.ts

@@ -1,12 +1,12 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 
-import type { Mapping } from '@objectstack/spec/data';
+import { defineMapping } from '@objectstack/spec/data';
 
 /**
  * CSV import mapping for bulk lead upload.
  * Maps common CRM export column names to crm_lead fields.
  */
-export const LeadCsvImportMapping: Mapping = {
+export const LeadCsvImportMapping = defineMapping({
   name: 'csv_import_leads',
   label: 'CSV Import: Leads',
   sourceFormat: 'csv',
@@ -51,12 +51,12 @@ export const LeadCsvImportMapping: Mapping = {
   ],
   errorPolicy: 'skip',
   batchSize: 500,
-};
+});
 
 /**
  * JSON import mapping for contact sync from external systems (HubSpot, etc.).
  */
-export const ContactJsonSyncMapping: Mapping = {
+export const ContactJsonSyncMapping = defineMapping({
   name: 'json_sync_contacts',
   label: 'JSON Sync: Contacts from HubSpot',
   sourceFormat: 'json',
@@ -72,4 +72,4 @@ export const ContactJsonSyncMapping: Mapping = {
   ],
   errorPolicy: 'skip',
   batchSize: 250,
-};
+});

examples/app-crm/src/datasources/crm.datasource.ts

@@ -1,12 +1,12 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 
-import type { DatasourceInput } from '@objectstack/spec/data';
+import { defineDatasource } from '@objectstack/spec/data';
 
 /**
  * Primary CRM datasource — in-memory SQLite for the example.
  * In production, swap `driver` to 'postgres' and supply real `config`.
  */
-export const CrmDatasource: DatasourceInput = {
+export const CrmDatasource = defineDatasource({
   name: 'crm_primary',
   label: 'CRM Primary Database',
   driver: 'sqlite',
@@ -18,12 +18,12 @@ export const CrmDatasource: DatasourceInput = {
     max: 5,
   },
   active: true,
-};
+});
 
 /**
  * Read-replica for analytics queries — demonstrates datasource routing.
  */
-export const CrmAnalyticsDatasource: DatasourceInput = {
+export const CrmAnalyticsDatasource = defineDatasource({
   name: 'crm_analytics',
   label: 'CRM Analytics Read Replica',
   driver: 'sqlite',
@@ -32,4 +32,4 @@ export const CrmAnalyticsDatasource: DatasourceInput = {
     readOnly: true,
   },
   active: true,
-};
+});

examples/app-crm/src/emails/deal-won.email.ts

@@ -1,12 +1,12 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 
-import type { EmailTemplateDefinitionInput } from '@objectstack/spec/system';
+import { defineEmailTemplateDefinition } from '@objectstack/spec/system';
 
 /**
  * Sent when an opportunity moves to Closed Won.
  * Referenced by the `notify_owner_deal_won` workflow action.
  */
-export const DealWonEmail: EmailTemplateDefinitionInput = {
+export const DealWonEmail = defineEmailTemplateDefinition({
   name: 'crm.deal_won',
   label: 'Deal Won — Owner Congrats',
   category: 'workflow',
@@ -33,4 +33,4 @@ Nice work!`,
   ],
   active: true,
   description: 'Internal congrats email fired by the High-Value Deal workflow when stage = Closed Won.',
-};
+});

examples/app-crm/src/emails/lead-follow-up.email.ts

@@ -1,12 +1,12 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 
-import type { EmailTemplateDefinitionInput } from '@objectstack/spec/system';
+import { defineEmailTemplateDefinition } from '@objectstack/spec/system';
 
 /**
  * Follow-up nudge sent by the Stale Opportunity workflow when no
  * activity has been logged on a Lead for the configured threshold.
  */
-export const LeadFollowUpEmail: EmailTemplateDefinitionInput = {
+export const LeadFollowUpEmail = defineEmailTemplateDefinition({
   name: 'crm.lead_followup',
   label: 'Lead — Follow-Up Reminder',
   category: 'notification',
@@ -35,4 +35,4 @@ Follow up: {{lead_url}}`,
   ],
   active: true,
   description: 'Internal reminder fired by the Stale Opportunity workflow.',
-};
+});

examples/app-crm/src/emails/welcome.email.ts

@@ -1,12 +1,12 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 
-import type { EmailTemplateDefinitionInput } from '@objectstack/spec/system';
+import { defineEmailTemplateDefinition } from '@objectstack/spec/system';
 
 /**
  * Welcome email sent to a Contact after it's added to the CRM.
  * Demonstrates marketing-category templates with a clear CTA.
  */
-export const WelcomeEmail: EmailTemplateDefinitionInput = {
+export const WelcomeEmail = defineEmailTemplateDefinition({
   name: 'crm.welcome',
   label: 'Welcome — New Contact',
   category: 'marketing',
@@ -36,4 +36,4 @@ Open your portal: {{portal_url}}`,
   replyTo: 'support@acme.example',
   active: true,
   description: 'Marketing welcome email sent on contact creation.',
-};
+});

examples/app-crm/src/extensions/contact.extension.ts

@@ -1,13 +1,13 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 
-import type { ObjectExtensionInput } from '@objectstack/spec/data';
+import { defineObjectExtension } from '@objectstack/spec/data';
 
 /**
  * Extends the built-in crm_contact object with social-media fields.
  * Demonstrates ObjectExtension — additive fields without re-declaring the
  * whole object schema.
  */
-export const ContactExtension: ObjectExtensionInput = {
+export const ContactExtension = defineObjectExtension({
   extend: 'crm_contact',
   label: 'Contact (CRM Extended)',
   fields: {
@@ -35,4 +35,4 @@ export const ContactExtension: ObjectExtensionInput = {
     },
   },
   priority: 210,
-};
+});