@rippling/rippling-sdk 0.2.0-alpha.82 → 0.2.0-alpha.83

package/examples/manifest/dental-practice-management/dental-practice-management.ts

@@ -2,46 +2,43 @@
  * Dental Practice Management — patient charts, operatories (chairs), appointments
  * with status, treatment plans, rollups, and an SDUI ObjectListView tab for appointments.
  *
- *   dental_patient__c        ← chart: demographics, allergies, notes
- *   dental_provider__c       ← providers selectable for appointments
- *   dental_operatory__c      ← chair / room (parent for same-day board rollups)
- *   dental_appointment__c   ← child of operatory; patient lookup, time, status, visit type
- *   dental_treatment_plan__c ← child of patient; plan status, procedures, estimates
+ * This example demonstrates the typed custom-object schema layer under
+ * `@rippling/rippling-sdk/core/platform/custom-objects` and then compiles those
+ * structural definitions back into the existing manifest class model.
  *
  * Run:
  *   yarn tsn examples/manifest/dental-practice-management/dental-practice-management.ts \
  *       > examples/manifest/dental-practice-management/manifest.json
  */
 
-import * as fs from 'node:fs';
 import * as path from 'node:path';
+import { toCustomCategoryApiName } from '@rippling/rippling-sdk/core/platform/custom-objects';
+import {
+  defineSduiPageFromFunctionFile,
+  defineTypedCustomObjectActionFromFunctionFile,
+  defineTypedListView,
+  defineTypedPageLayout,
+  defineTypedRule,
+  defineTypedValidation,
+  registerManifestCustomObject,
+} from '@rippling/rippling-sdk/core/platform/manifest/custom-objects';
 import {
   App,
-  BooleanField,
   Category,
-  CustomObject,
-  CustomObjectAction,
-  CustomObjectFieldSection,
-  CustomObjectPageLayout,
-  DatetimeField,
-  DateField,
-  EmailField,
-  FormulaField,
-  ListViewDef,
-  LongTextField,
-  LookupField,
+  type CustomObject,
   ManifestBuilder,
-  ManifestFunction,
-  NumberField,
-  ParentChildField,
-  PhoneField,
-  Rule,
-  RadioField,
   SduiPage,
   SummaryField,
-  TextField,
-  Validation,
 } from '@rippling/rippling-sdk/lib/manifest';
+import {
+  appointmentDefinition,
+  DENTAL_CATEGORY_NAME,
+  operatoryDefinition,
+  patientDefinition,
+  providerDefinition,
+  treatmentPlanDefinition,
+} from './schema';
+
 const manifest = new ManifestBuilder({
   key: 'dental_practice_management',
   name: 'Dental Practice Management',
@@ -50,477 +47,165 @@ const manifest = new ManifestBuilder({
 });
 
 const dentalCategory = new Category(manifest, {
-  apiName: 'dental__c',
+  apiName: toCustomCategoryApiName(DENTAL_CATEGORY_NAME),
   name: 'Dental',
   description: 'Patients, chairs, visits, and treatment plans',
 });
 
-// ── Patient (chart) ─────────────────────────────────────────────────────────
-const patientObj = new CustomObject(manifest, {
-  apiName: 'dental_patient__c',
-  name: 'Patient',
-  pluralLabel: 'Patients',
-  category: dentalCategory,
-  description: 'Clinical chart, demographics, and care preferences',
-  icon: { emoji: '🦷' },
-});
-
-const patientIdentitySection = new CustomObjectFieldSection(patientObj, {
-  name: 'Demographics',
-  sectionId: 'sec_pt_identity',
-});
-
-const patientClinicalSection = new CustomObjectFieldSection(patientObj, {
-  name: 'Clinical',
-  sectionId: 'sec_pt_clinical',
-});
-
-const patientNameField = new TextField(patientObj, {
-  apiName: 'legal_name__c',
-  displayName: 'Full legal name',
-  description: 'Full legal name field',
-  required: true,
-  maxLength: 160,
-  section: patientIdentitySection,
-});
-
-const patientDobField = new DateField(patientObj, {
-  apiName: 'date_of_birth__c',
-  displayName: 'Date of birth',
-  description: 'Date of birth field',
-  section: patientIdentitySection,
-});
-
-const patientPhoneField = new PhoneField(patientObj, {
-  apiName: 'phone__c',
-  displayName: 'Phone',
-  description: 'Phone field',
-  section: patientIdentitySection,
-});
-
-const patientEmailField = new EmailField(patientObj, {
-  apiName: 'email__c',
-  displayName: 'Email',
-  description: 'Email field',
-  unique: true,
-  section: patientIdentitySection,
-});
-
-const patientActiveField = new BooleanField(patientObj, {
-  apiName: 'active_patient__c',
-  displayName: 'Active patient',
-  description: 'Whether the patient is currently active in the practice',
-  required: true,
-  section: patientIdentitySection,
-});
-
-const patientAllergiesField = new LongTextField(patientObj, {
-  apiName: 'allergies_and_alerts__c',
-  displayName: 'Allergies & medical alerts',
-  maxLength: 2000,
-  description: 'Drug allergies, bisphosphonates, anticoagulants, latex, etc.',
-  section: patientClinicalSection,
-});
-
-const patientInsuranceField = new TextField(patientObj, {
-  apiName: 'insurance_plan__c',
-  displayName: 'Insurance / payer',
-  description: 'Insurance / payer field',
-  maxLength: 120,
-  section: patientClinicalSection,
-});
-
-const patientChartNotesField = new LongTextField(patientObj, {
-  apiName: 'chart_summary__c',
-  displayName: 'Chart summary & preferences',
-  maxLength: 4000,
-  description: 'Narrative, anxiety notes, perio class, last prophy, family history',
-  section: patientClinicalSection,
-});
+const registeredObjects = new Map<string, { object: CustomObject }>();
 
-const patientLabelField = new FormulaField(patientObj, {
-  apiName: 'patient_label__c',
-  displayName: 'Chart label',
-  fieldType: 'TEXT',
-  maxLength: 220,
-  formula: "CONCATENATE(legal_name__c, ' (b. ', YEAR(date_of_birth__c), ')')",
-  description: 'Quick list label (name and birth year)',
-  section: patientIdentitySection,
-});
+function resolveCustomObjectTarget(apiName: string): CustomObject {
+  const target = registeredObjects.get(apiName);
+  if (target == null) {
+    throw new Error(`Custom object target "${apiName}" must be registered before dependents.`);
+  }
+  return target.object;
+}
 
-// ── Provider ────────────────────────────────────────────────────────────────
-const providerObj = new CustomObject(manifest, {
-  apiName: 'dental_provider__c',
-  name: 'Provider',
-  pluralLabel: 'Providers',
+const patient = registerManifestCustomObject(manifest, {
+  definition: patientDefinition,
   category: dentalCategory,
-  description: 'Clinicians who can be assigned to appointment blocks',
-  icon: { emoji: '🧑‍⚕️' },
-});
-
-const providerSection = new CustomObjectFieldSection(providerObj, {
-  name: 'Provider',
-  sectionId: 'sec_provider_info',
-});
-
-const providerNameField = providerObj.standardFields.name;
-
-const providerStatusField = new RadioField(providerObj, {
-  apiName: 'provider_status__c',
-  displayName: 'Status',
-  description: 'Whether this provider is active in the practice',
-  options: ['Active', 'On leave', 'Inactive'],
-  required: true,
-  section: providerSection,
-});
-
-const providerBookingStatusField = new RadioField(providerObj, {
-  apiName: 'booking_status__c',
-  displayName: 'Booking status',
-  description: 'Whether scheduling should offer this provider for new appointments',
-  options: ['Open', 'Limited', 'Closed'],
-  required: true,
-  section: providerSection,
-});
-
-const providerNextAvailableDaysField = new NumberField(providerObj, {
-  apiName: 'next_available_days__c',
-  displayName: 'Next available (days)',
-  description: 'Estimated days until this provider has an open appointment slot',
-  decimalPlaces: 0,
-  required: true,
-  section: providerSection,
+  resolveCustomObjectTarget,
 });
+registeredObjects.set(patient.definition.apiName, patient);
 
-// ── Operatory (chair) ─────────────────────────────────────────────────────────
-const operatoryObj = new CustomObject(manifest, {
-  apiName: 'dental_operatory__c',
-  name: 'Operatory',
-  pluralLabel: 'Operatories',
+const provider = registerManifestCustomObject(manifest, {
+  definition: providerDefinition,
   category: dentalCategory,
-  description: 'A chair, bay, or room you book on the daily board',
-  icon: { emoji: '🪥' },
-});
-
-const operatorySection = new CustomObjectFieldSection(operatoryObj, {
-  name: 'Operatory',
-  sectionId: 'sec_op_info',
-});
-
-const opNameField = operatoryObj.standardFields.name;
-
-const opCodeField = new TextField(operatoryObj, {
-  apiName: 'room_code__c',
-  displayName: 'Room code',
-  maxLength: 20,
-  description: 'Short code for whiteboards and schedules',
-  section: operatorySection,
+  resolveCustomObjectTarget,
 });
+registeredObjects.set(provider.definition.apiName, provider);
 
-// ── Appointment (child of operatory) ─────────────────────────────────────────
-const apptObj = new CustomObject(manifest, {
-  apiName: 'dental_appointment__c',
-  name: 'Appointment',
-  pluralLabel: 'Appointments',
+const operatory = registerManifestCustomObject(manifest, {
+  definition: operatoryDefinition,
   category: dentalCategory,
-  description: 'Chair booking with visit type and real-time visit status',
-  icon: { emoji: '📅' },
-});
-
-const apptOperatorySection = new CustomObjectFieldSection(apptObj, {
-  name: 'Operatory & time',
-  sectionId: 'sec_appt_op',
-});
-
-const apptPatientSection = new CustomObjectFieldSection(apptObj, {
-  name: 'Patient & visit',
-  sectionId: 'sec_appt_patient',
+  resolveCustomObjectTarget,
 });
+registeredObjects.set(operatory.definition.apiName, operatory);
 
-const apptOperatoryRef = new ParentChildField(apptObj, {
-  apiName: 'operatory_ref__c',
-  displayName: 'Operatory (chair)',
-  target: operatoryObj,
-  relatedDataLabel: 'Appointments',
-  parentChildType: 'PRIMARY',
-  enableParentOwnerInheritance: false,
-  description: 'Which chair or bay this visit is booked on',
-  section: apptOperatorySection,
-});
-
-const apptStartField = new DatetimeField(apptObj, {
-  apiName: 'start_time__c',
-  displayName: 'Start (local)',
-  required: true,
-  description: 'Planned or actual start; board sorts by this',
-  section: apptOperatorySection,
-});
-
-const apptDurationMins = new NumberField(apptObj, {
-  apiName: 'duration_minutes__c',
-  displayName: 'Duration (minutes)',
-  required: true,
-  decimalPlaces: 0,
-  description: 'Expected chair time for the procedure block',
-  section: apptOperatorySection,
-});
-
-const apptPatientRef = new LookupField(apptObj, {
-  apiName: 'patient_ref__c',
-  displayName: 'Patient',
-  target: patientObj,
-  relatedDataLabel: 'Appointments',
-  required: true,
-  lookup_filter_rql_condition: '(active_patient__c == True)',
-  description: 'Chart to open for this visit (active patients only)',
-  section: apptPatientSection,
-});
-
-const apptProviderRef = new LookupField(apptObj, {
-  apiName: 'provider_ref__c',
-  displayName: 'Provider',
-  target: providerObj,
-  relatedDataLabel: 'Appointments',
-  required: true,
-  lookup_filter_rql_condition:
-    "((provider_status__c IN ['Active']) AND (next_available_days__c <= 14) AND (booking_status__c NOT_IN ['Closed']))",
-  description: 'Provider assigned to this visit (active and bookable within two weeks)',
-  section: apptPatientSection,
-});
-
-const apptVisitTypeField = new RadioField(apptObj, {
-  apiName: 'visit_type__c',
-  displayName: 'Visit type',
-  description: 'Visit type field',
-  options: [
-    'New patient exam',
-    'Periodic / recall exam',
-    'Prophy / cleaning',
-    'Restorative',
-    'Endodontic',
-    'Perio / SRP',
-    'Oral surgery / extraction',
-    'Orthodontic',
-    'Emergency / pain',
-    'Other',
-  ],
-  required: true,
-  section: apptPatientSection,
-});
-
-const apptStatusField = new RadioField(apptObj, {
-  apiName: 'appointment_status__c',
-  displayName: 'Visit status',
-  options: ['Scheduled', 'Checked in', 'In treatment', 'Completed', 'Cancelled', 'No-show'],
-  required: true,
-  description: 'Front-desk and clinical workflow status',
-  section: apptPatientSection,
-});
-
-const apptClinicalNotes = new LongTextField(apptObj, {
-  apiName: 'visit_notes__c',
-  displayName: 'Visit notes',
-  maxLength: 4000,
-  description: 'Chairside notes for this block (sync with EDR as needed)',
-  section: apptPatientSection,
-});
-
-const apptBoardLabel = new FormulaField(apptObj, {
-  apiName: 'board_label__c',
-  displayName: 'Board label',
-  description: 'Board label field',
-  fieldType: 'TEXT',
-  maxLength: 260,
-  formula: "CONCATENATE(visit_type__c, ' · ', appointment_status__c)",
-  section: apptPatientSection,
-});
-
-// ── Treatment plan (child of patient) ─────────────────────────────────────────
-const planObj = new CustomObject(manifest, {
-  apiName: 'dental_treatment_plan__c',
-  name: 'Treatment plan',
-  pluralLabel: 'Treatment plans',
+const appointment = registerManifestCustomObject(manifest, {
+  definition: appointmentDefinition,
   category: dentalCategory,
-  description: 'Staged work sequenced for a patient',
-  icon: { emoji: '📋' },
-});
-
-const planLinkSection = new CustomObjectFieldSection(planObj, {
-  name: 'Link',
-  sectionId: 'sec_plan_link',
+  resolveCustomObjectTarget,
 });
+registeredObjects.set(appointment.definition.apiName, appointment);
 
-const planBodySection = new CustomObjectFieldSection(planObj, {
-  name: 'Plan',
-  sectionId: 'sec_plan_body',
-});
-
-const planNameField = planObj.standardFields.name;
-
-const planPatientRef = new ParentChildField(planObj, {
-  apiName: 'plan_patient_ref__c',
-  displayName: 'Patient',
-  target: patientObj,
-  relatedDataLabel: 'Treatment plans',
-  parentChildType: 'PRIMARY',
-  enableParentOwnerInheritance: false,
-  description: 'Which chart owns this plan',
-  section: planLinkSection,
-});
-
-const planStatusField = new RadioField(planObj, {
-  apiName: 'plan_status__c',
-  displayName: 'Status',
-  description: 'Status field',
-  options: ['Draft', 'Presented', 'Accepted', 'In progress', 'Completed', 'Declined / on hold'],
-  required: true,
-  section: planBodySection,
-});
-
-const planTargetField = new DateField(planObj, {
-  apiName: 'target_completion__c',
-  displayName: 'Target completion',
-  description: 'Goal to finish or next review',
-  section: planBodySection,
-});
-
-const planProceduresField = new LongTextField(planObj, {
-  apiName: 'procedures_summary__c',
-  displayName: 'Procedures & sequence',
-  maxLength: 8000,
-  description: 'Tooth numbers, codes, and staging',
-  section: planBodySection,
-});
-
-const planFeeCents = new NumberField(planObj, {
-  apiName: 'fee_estimate_cents__c',
-  displayName: 'Fee estimate (cents)',
-  decimalPlaces: 0,
-  description: 'Rough office fee total for planning; adjust per office policy',
-  section: planBodySection,
+const treatmentPlan = registerManifestCustomObject(manifest, {
+  definition: treatmentPlanDefinition,
+  category: dentalCategory,
+  resolveCustomObjectTarget,
 });
+registeredObjects.set(treatmentPlan.definition.apiName, treatmentPlan);
 
 // ── Rollups ────────────────────────────────────────────────────────────────
-const apptCountOnOperatory = new SummaryField(operatoryObj, {
+const apptCountOnOperatory = new SummaryField(operatory.object, {
   apiName: 'appointment_count__c',
   displayName: 'Appointments (count)',
-  aggregates: apptPatientRef,
+  aggregates: appointment.object.standardFields.name,
   using: 'COUNT',
-  lookup: apptOperatoryRef,
+  lookup: appointment.fields.operatory_ref,
   description: 'Rows in this operatory (filter by day in the chair board function)',
-  section: operatorySection,
+  section: operatory.sections.operatory,
 });
 
-const planCountOnPatient = new SummaryField(patientObj, {
+const planCountOnPatient = new SummaryField(patient.object, {
   apiName: 'treatment_plan_count__c',
   displayName: 'Treatment plans',
-  aggregates: planNameField,
+  aggregates: treatmentPlan.object.standardFields.name,
   using: 'COUNT',
-  lookup: planPatientRef,
+  lookup: treatmentPlan.fields.plan_patient_ref,
   description: 'Active plans tied to the chart',
-  section: patientClinicalSection,
+  section: patient.sections.clinical,
 });
 
-// ── Validations & defaults ──────────────────────────────────────────────────
-new Validation(apptObj, {
+// ── Validations & defaults ────────────────────────────────────────────────
+defineTypedValidation(appointment, {
   ruleId: 'dental_appt_duration_positive',
   displayName: 'Duration must be positive',
-  rqlFormula: '(duration_minutes__c <= 0)',
+  whenInvalid: (c) => c.lte(c.fields.duration_minutes, 0),
   errorMessage: 'Duration must be at least 1 minute.',
   ruleDescription: 'Blocks empty or zero chair blocks',
   state: 'ACTIVE',
   level: 'FIELD',
-  fieldRef: apptDurationMins,
+  field: 'duration_minutes',
 });
 
-new Rule(apptObj, {
+defineTypedRule(appointment, {
   flowId: 'dental_default_appt_status',
   flowName: 'Default visit status to Scheduled',
   triggerType: 'CREATE',
   description: 'New bookings start as Scheduled unless the team changes it',
-  actions: [{ targetField: apptStatusField, fixedValue: 'Scheduled' }],
+  actions: (rules) => [rules.setField('appointment_status').toValue('Scheduled')],
 });
 
 // ── List views ─────────────────────────────────────────────────────────────
-new ListViewDef(patientObj, {
+defineTypedListView(patient, {
   viewId: 'view_dental_all_patients',
   name: 'All patients',
   description: 'Full chart list with plan counts',
-  fields: [
-    'name',
-    patientDobField,
-    patientPhoneField,
-    patientActiveField,
-    patientLabelField,
-    planCountOnPatient,
-  ],
+  fields: ['name', 'date_of_birth', 'phone', 'active_patient', 'patient_label', planCountOnPatient],
   orderBy: 'name',
   sortOrder: 'ASC',
   isPublic: true,
   objectScope: 'all',
 });
 
-new ListViewDef(providerObj, {
+defineTypedListView(provider, {
   viewId: 'view_dental_providers',
   name: 'All providers',
   description: 'Provider directory with appointment booking fields',
-  fields: [
-    providerNameField,
-    providerStatusField,
-    providerBookingStatusField,
-    providerNextAvailableDaysField,
-  ],
+  fields: ['name', 'provider_status', 'booking_status', 'next_available_days'],
   orderBy: 'name',
   sortOrder: 'ASC',
   isPublic: true,
   objectScope: 'all',
 });
 
-new ListViewDef(operatoryObj, {
+defineTypedListView(operatory, {
   viewId: 'view_dental_all_operatories',
   name: 'All operatories',
   description: 'Chairs and daily volume rollups',
-  fields: [opNameField, opCodeField, apptCountOnOperatory],
+  fields: ['name', 'room_code', apptCountOnOperatory],
   orderBy: 'name',
   sortOrder: 'ASC',
   isPublic: true,
   objectScope: 'all',
 });
 
-new ListViewDef(apptObj, {
+defineTypedListView(appointment, {
   viewId: 'view_dental_appointments_all',
   name: 'All appointments',
   description: 'Chronological board with chair and status',
   fields: [
     'name',
-    apptOperatoryRef,
-    apptStartField,
-    apptDurationMins,
-    apptPatientRef,
-    apptProviderRef,
-    apptVisitTypeField,
-    apptStatusField,
-    apptBoardLabel,
+    'operatory_ref',
+    'start_time',
+    'duration_minutes',
+    'patient_ref',
+    'provider_ref',
+    'visit_type',
+    'appointment_status',
+    'board_label',
   ],
-  orderBy: apptStartField,
+  orderBy: 'start_time',
   sortOrder: 'ASC',
   isPublic: true,
   objectScope: 'all',
 });
 
-new ListViewDef(planObj, {
+defineTypedListView(treatmentPlan, {
   viewId: 'view_dental_treatment_plans',
   name: 'All treatment plans',
   description: 'Case tracking by status',
-  fields: [planNameField, planPatientRef, planStatusField, planTargetField, planFeeCents],
-  orderBy: planTargetField,
+  fields: ['name', 'plan_patient_ref', 'plan_status', 'target_completion', 'fee_estimate_cents'],
+  orderBy: 'target_completion',
   sortOrder: 'ASC',
   isPublic: true,
   objectScope: 'all',
 });
 
-// ── Page layouts ─────────────────────────────────────────────────────────────
-new CustomObjectPageLayout(patientObj, {
+// ── Page layouts ───────────────────────────────────────────────────────────
+defineTypedPageLayout(patient, {
   apiName: 'default',
   name: 'Patient chart',
   layoutId: 'layout_dental_patient',
@@ -534,27 +219,22 @@ new CustomObjectPageLayout(patientObj, {
           {
             name: 'Profile',
             type: 'fields_section',
-            section: patientIdentitySection,
+            section: patient.sections.identity,
             fields: [
               { field: 'name', editable: true },
-              patientNameField,
-              patientDobField,
-              patientPhoneField,
-              patientEmailField,
-              patientActiveField,
-              patientLabelField,
+              'legal_name',
+              'date_of_birth',
+              'phone',
+              'email',
+              'active_patient',
+              'patient_label',
             ],
           },
           {
             name: 'Clinical & billing',
             type: 'fields_section',
-            section: patientClinicalSection,
-            fields: [
-              patientAllergiesField,
-              patientInsuranceField,
-              patientChartNotesField,
-              planCountOnPatient,
-            ],
+            section: patient.sections.clinical,
+            fields: ['allergies_and_alerts', 'insurance_plan', 'chart_summary', planCountOnPatient],
           },
         ],
       },
@@ -565,7 +245,7 @@ new CustomObjectPageLayout(patientObj, {
   visibilityConditions: {},
 });
 
-new CustomObjectPageLayout(providerObj, {
+defineTypedPageLayout(provider, {
   apiName: 'default',
   name: 'Provider',
   layoutId: 'layout_dental_provider',
@@ -579,12 +259,12 @@ new CustomObjectPageLayout(providerObj, {
           {
             name: 'Booking',
             type: 'fields_section',
-            section: providerSection,
+            section: provider.sections.provider,
             fields: [
-              { field: providerNameField, editable: true },
-              providerStatusField,
-              providerBookingStatusField,
-              providerNextAvailableDaysField,
+              { field: 'name', editable: true },
+              'provider_status',
+              'booking_status',
+              'next_available_days',
             ],
           },
         ],
@@ -596,7 +276,7 @@ new CustomObjectPageLayout(providerObj, {
   visibilityConditions: {},
 });
 
-new CustomObjectPageLayout(operatoryObj, {
+defineTypedPageLayout(operatory, {
   apiName: 'default',
   name: 'Operatory',
   layoutId: 'layout_dental_operatory',
@@ -610,8 +290,8 @@ new CustomObjectPageLayout(operatoryObj, {
           {
             name: 'Room',
             type: 'fields_section',
-            section: operatorySection,
-            fields: [{ field: opNameField, editable: true }, opCodeField, apptCountOnOperatory],
+            section: operatory.sections.operatory,
+            fields: [{ field: 'name', editable: true }, 'room_code', apptCountOnOperatory],
           },
         ],
       },
@@ -622,23 +302,22 @@ new CustomObjectPageLayout(operatoryObj, {
   visibilityConditions: {},
 });
 
-const completeVisitFn = new ManifestFunction(manifest, {
-  apiName: 'dental_complete_visit_fn',
-  name: 'completeVisit',
-  description: 'Detail-view action that completes an appointment and drafts follow-up treatment',
-  code: fs.readFileSync(path.join(__dirname, 'functions', 'complete-visit.ts'), 'utf-8'),
-  dependencies: { '@rippling/rippling-sdk': '^0.2.0-alpha.65' },
-  isAsync: false,
-});
-
-new CustomObjectAction(apptObj, {
+defineTypedCustomObjectActionFromFunctionFile(manifest, appointment, {
   actionId: 'action_dental_complete_visit',
   name: 'Complete visit',
-  function: completeVisitFn,
   visibilityPreferences: ['DETAIL_VIEW'],
+  function: {
+    apiName: 'dental_complete_visit_fn',
+    name: 'completeVisit',
+    description: 'Detail-view action that completes an appointment and drafts follow-up treatment',
+    codeDirectory: path.join(__dirname, 'functions'),
+    codeFilename: 'complete-visit.ts',
+    dependencies: { '@rippling/rippling-sdk': '^0.2.0-alpha.65' },
+    isAsync: false,
+  },
 });
 
-new CustomObjectPageLayout(apptObj, {
+defineTypedPageLayout(appointment, {
   apiName: 'default',
   name: 'Appointment',
   layoutId: 'layout_dental_appointment',
@@ -652,20 +331,20 @@ new CustomObjectPageLayout(apptObj, {
           {
             name: 'Chair & schedule',
             type: 'fields_section',
-            section: apptOperatorySection,
-            fields: [{ field: 'name', editable: true }, apptOperatoryRef, apptStartField, apptDurationMins],
+            section: appointment.sections.operatory_and_time,
+            fields: [{ field: 'name', editable: true }, 'operatory_ref', 'start_time', 'duration_minutes'],
           },
           {
             name: 'Patient & status',
             type: 'fields_section',
-            section: apptPatientSection,
+            section: appointment.sections.patient_and_visit,
             fields: [
-              apptPatientRef,
-              apptProviderRef,
-              apptVisitTypeField,
-              apptStatusField,
-              apptBoardLabel,
-              apptClinicalNotes,
+              'patient_ref',
+              'provider_ref',
+              'visit_type',
+              'appointment_status',
+              'board_label',
+              'visit_notes',
             ],
           },
         ],
@@ -678,7 +357,7 @@ new CustomObjectPageLayout(apptObj, {
   visibilityConditions: {},
 });
 
-new CustomObjectPageLayout(planObj, {
+defineTypedPageLayout(treatmentPlan, {
   apiName: 'default',
   name: 'Treatment plan',
   layoutId: 'layout_dental_treatment_plan',
@@ -692,19 +371,19 @@ new CustomObjectPageLayout(planObj, {
           {
             name: 'Patient',
             type: 'fields_section',
-            section: planLinkSection,
-            fields: [planPatientRef],
+            section: treatmentPlan.sections.link,
+            fields: ['plan_patient_ref'],
           },
           {
             name: 'Planned work',
             type: 'fields_section',
-            section: planBodySection,
+            section: treatmentPlan.sections.plan,
             fields: [
-              { field: planNameField, editable: true },
-              planStatusField,
-              planTargetField,
-              planProceduresField,
-              planFeeCents,
+              { field: 'name', editable: true },
+              'plan_status',
+              'target_completion',
+              'procedures_summary',
+              'fee_estimate_cents',
             ],
           },
         ],
@@ -716,16 +395,12 @@ new CustomObjectPageLayout(planObj, {
   visibilityConditions: {},
 });
 
-// ── SDUI object-list tabs ───────────────────────────────────────────────────
+// ── SDUI object-list tabs ─────────────────────────────────────────────────
 const sduiObjectListDependencies = {
   '@rippling/rippling-sdk': '^0.2.0-alpha.65',
   '@rippling/pebble-sdui-web': '^0.9.2',
 };
 
-function loadFunctionCode(filename: string): string {
-  return fs.readFileSync(path.join(__dirname, 'functions', filename), 'utf-8');
-}
-
 function createObjectListPage(props: {
   codeFilename: string;
   functionApiName: string;
@@ -734,20 +409,17 @@ function createObjectListPage(props: {
   pageId: string;
   pageName: string;
 }): SduiPage {
-  const listFn = new ManifestFunction(manifest, {
+  return defineSduiPageFromFunctionFile(manifest, {
     apiName: props.functionApiName,
     name: props.functionName,
     description: props.functionDescription,
-    code: loadFunctionCode(props.codeFilename),
+    codeDirectory: path.join(__dirname, 'functions'),
+    codeFilename: props.codeFilename,
     dependencies: sduiObjectListDependencies,
     isAsync: false,
-  });
-
-  return new SduiPage(manifest, {
-    sduiPageId: props.pageId,
-    name: props.pageName,
-    function: listFn,
-  });
+    pageId: props.pageId,
+    pageName: props.pageName,
+  }).page;
 }
 
 const patientListPage = createObjectListPage({