@rippling/rippling-sdk 0.2.0-alpha.84 → 0.2.0-alpha.85

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

@@ -2,43 +2,46 @@
  * Dental Practice Management — patient charts, operatories (chairs), appointments
  * with status, treatment plans, rollups, and an SDUI ObjectListView tab for appointments.
  *
- * 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.
+ *   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
  *
  * 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,
-  type CustomObject,
+  CustomObject,
+  CustomObjectAction,
+  CustomObjectFieldSection,
+  CustomObjectPageLayout,
+  DatetimeField,
+  DateField,
+  EmailField,
+  FormulaField,
+  ListViewDef,
+  LongTextField,
+  LookupField,
   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',
@@ -47,165 +50,477 @@ const manifest = new ManifestBuilder({
 });
 
 const dentalCategory = new Category(manifest, {
-  apiName: toCustomCategoryApiName(DENTAL_CATEGORY_NAME),
+  apiName: 'dental__c',
   name: 'Dental',
   description: 'Patients, chairs, visits, and treatment plans',
 });
 
-const registeredObjects = new Map<string, { object: CustomObject }>();
+// ── 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: '🦷' },
+});
 
-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;
-}
+const patientIdentitySection = new CustomObjectFieldSection(patientObj, {
+  name: 'Demographics',
+  sectionId: 'sec_pt_identity',
+});
 
-const patient = registerManifestCustomObject(manifest, {
-  definition: patientDefinition,
-  category: dentalCategory,
-  resolveCustomObjectTarget,
+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 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,
 });
-registeredObjects.set(patient.definition.apiName, patient);
 
-const provider = registerManifestCustomObject(manifest, {
-  definition: providerDefinition,
+// ── Provider ────────────────────────────────────────────────────────────────
+const providerObj = new CustomObject(manifest, {
+  apiName: 'dental_provider__c',
+  name: 'Provider',
+  pluralLabel: 'Providers',
   category: dentalCategory,
-  resolveCustomObjectTarget,
+  description: 'Clinicians who can be assigned to appointment blocks',
+  icon: { emoji: '🧑‍⚕️' },
 });
-registeredObjects.set(provider.definition.apiName, provider);
 
-const operatory = registerManifestCustomObject(manifest, {
-  definition: operatoryDefinition,
+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,
+});
+
+// ── Operatory (chair) ─────────────────────────────────────────────────────────
+const operatoryObj = new CustomObject(manifest, {
+  apiName: 'dental_operatory__c',
+  name: 'Operatory',
+  pluralLabel: 'Operatories',
   category: dentalCategory,
-  resolveCustomObjectTarget,
+  description: 'A chair, bay, or room you book on the daily board',
+  icon: { emoji: '🪥' },
 });
-registeredObjects.set(operatory.definition.apiName, operatory);
 
-const appointment = registerManifestCustomObject(manifest, {
-  definition: appointmentDefinition,
+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,
+});
+
+// ── Appointment (child of operatory) ─────────────────────────────────────────
+const apptObj = new CustomObject(manifest, {
+  apiName: 'dental_appointment__c',
+  name: 'Appointment',
+  pluralLabel: 'Appointments',
   category: dentalCategory,
-  resolveCustomObjectTarget,
+  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',
 });
-registeredObjects.set(appointment.definition.apiName, appointment);
 
-const treatmentPlan = registerManifestCustomObject(manifest, {
-  definition: treatmentPlanDefinition,
+const apptPatientSection = new CustomObjectFieldSection(apptObj, {
+  name: 'Patient & visit',
+  sectionId: 'sec_appt_patient',
+});
+
+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',
   category: dentalCategory,
-  resolveCustomObjectTarget,
+  description: 'Staged work sequenced for a patient',
+  icon: { emoji: '📋' },
+});
+
+const planLinkSection = new CustomObjectFieldSection(planObj, {
+  name: 'Link',
+  sectionId: 'sec_plan_link',
+});
+
+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,
 });
-registeredObjects.set(treatmentPlan.definition.apiName, treatmentPlan);
 
 // ── Rollups ────────────────────────────────────────────────────────────────
-const apptCountOnOperatory = new SummaryField(operatory.object, {
+const apptCountOnOperatory = new SummaryField(operatoryObj, {
   apiName: 'appointment_count__c',
   displayName: 'Appointments (count)',
-  aggregates: appointment.object.standardFields.name,
+  aggregates: apptPatientRef,
   using: 'COUNT',
-  lookup: appointment.fields.operatory_ref,
+  lookup: apptOperatoryRef,
   description: 'Rows in this operatory (filter by day in the chair board function)',
-  section: operatory.sections.operatory,
+  section: operatorySection,
 });
 
-const planCountOnPatient = new SummaryField(patient.object, {
+const planCountOnPatient = new SummaryField(patientObj, {
   apiName: 'treatment_plan_count__c',
   displayName: 'Treatment plans',
-  aggregates: treatmentPlan.object.standardFields.name,
+  aggregates: planNameField,
   using: 'COUNT',
-  lookup: treatmentPlan.fields.plan_patient_ref,
+  lookup: planPatientRef,
   description: 'Active plans tied to the chart',
-  section: patient.sections.clinical,
+  section: patientClinicalSection,
 });
 
-// ── Validations & defaults ────────────────────────────────────────────────
-defineTypedValidation(appointment, {
+// ── Validations & defaults ──────────────────────────────────────────────────
+new Validation(apptObj, {
   ruleId: 'dental_appt_duration_positive',
   displayName: 'Duration must be positive',
-  whenInvalid: (c) => c.lte(c.fields.duration_minutes, 0),
+  rqlFormula: '(duration_minutes__c <= 0)',
   errorMessage: 'Duration must be at least 1 minute.',
   ruleDescription: 'Blocks empty or zero chair blocks',
   state: 'ACTIVE',
   level: 'FIELD',
-  field: 'duration_minutes',
+  fieldRef: apptDurationMins,
 });
 
-defineTypedRule(appointment, {
+new Rule(apptObj, {
   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: (rules) => [rules.setField('appointment_status').toValue('Scheduled')],
+  actions: [{ targetField: apptStatusField, fixedValue: 'Scheduled' }],
 });
 
 // ── List views ─────────────────────────────────────────────────────────────
-defineTypedListView(patient, {
+new ListViewDef(patientObj, {
   viewId: 'view_dental_all_patients',
   name: 'All patients',
   description: 'Full chart list with plan counts',
-  fields: ['name', 'date_of_birth', 'phone', 'active_patient', 'patient_label', planCountOnPatient],
+  fields: [
+    'name',
+    patientDobField,
+    patientPhoneField,
+    patientActiveField,
+    patientLabelField,
+    planCountOnPatient,
+  ],
   orderBy: 'name',
   sortOrder: 'ASC',
   isPublic: true,
   objectScope: 'all',
 });
 
-defineTypedListView(provider, {
+new ListViewDef(providerObj, {
   viewId: 'view_dental_providers',
   name: 'All providers',
   description: 'Provider directory with appointment booking fields',
-  fields: ['name', 'provider_status', 'booking_status', 'next_available_days'],
+  fields: [
+    providerNameField,
+    providerStatusField,
+    providerBookingStatusField,
+    providerNextAvailableDaysField,
+  ],
   orderBy: 'name',
   sortOrder: 'ASC',
   isPublic: true,
   objectScope: 'all',
 });
 
-defineTypedListView(operatory, {
+new ListViewDef(operatoryObj, {
   viewId: 'view_dental_all_operatories',
   name: 'All operatories',
   description: 'Chairs and daily volume rollups',
-  fields: ['name', 'room_code', apptCountOnOperatory],
+  fields: [opNameField, opCodeField, apptCountOnOperatory],
   orderBy: 'name',
   sortOrder: 'ASC',
   isPublic: true,
   objectScope: 'all',
 });
 
-defineTypedListView(appointment, {
+new ListViewDef(apptObj, {
   viewId: 'view_dental_appointments_all',
   name: 'All appointments',
   description: 'Chronological board with chair and status',
   fields: [
     'name',
-    'operatory_ref',
-    'start_time',
-    'duration_minutes',
-    'patient_ref',
-    'provider_ref',
-    'visit_type',
-    'appointment_status',
-    'board_label',
+    apptOperatoryRef,
+    apptStartField,
+    apptDurationMins,
+    apptPatientRef,
+    apptProviderRef,
+    apptVisitTypeField,
+    apptStatusField,
+    apptBoardLabel,
   ],
-  orderBy: 'start_time',
+  orderBy: apptStartField,
   sortOrder: 'ASC',
   isPublic: true,
   objectScope: 'all',
 });
 
-defineTypedListView(treatmentPlan, {
+new ListViewDef(planObj, {
   viewId: 'view_dental_treatment_plans',
   name: 'All treatment plans',
   description: 'Case tracking by status',
-  fields: ['name', 'plan_patient_ref', 'plan_status', 'target_completion', 'fee_estimate_cents'],
-  orderBy: 'target_completion',
+  fields: [planNameField, planPatientRef, planStatusField, planTargetField, planFeeCents],
+  orderBy: planTargetField,
   sortOrder: 'ASC',
   isPublic: true,
   objectScope: 'all',
 });
 
-// ── Page layouts ───────────────────────────────────────────────────────────
-defineTypedPageLayout(patient, {
+// ── Page layouts ─────────────────────────────────────────────────────────────
+new CustomObjectPageLayout(patientObj, {
   apiName: 'default',
   name: 'Patient chart',
   layoutId: 'layout_dental_patient',
@@ -219,22 +534,27 @@ defineTypedPageLayout(patient, {
           {
             name: 'Profile',
             type: 'fields_section',
-            section: patient.sections.identity,
+            section: patientIdentitySection,
             fields: [
               { field: 'name', editable: true },
-              'legal_name',
-              'date_of_birth',
-              'phone',
-              'email',
-              'active_patient',
-              'patient_label',
+              patientNameField,
+              patientDobField,
+              patientPhoneField,
+              patientEmailField,
+              patientActiveField,
+              patientLabelField,
             ],
           },
           {
             name: 'Clinical & billing',
             type: 'fields_section',
-            section: patient.sections.clinical,
-            fields: ['allergies_and_alerts', 'insurance_plan', 'chart_summary', planCountOnPatient],
+            section: patientClinicalSection,
+            fields: [
+              patientAllergiesField,
+              patientInsuranceField,
+              patientChartNotesField,
+              planCountOnPatient,
+            ],
           },
         ],
       },
@@ -245,7 +565,7 @@ defineTypedPageLayout(patient, {
   visibilityConditions: {},
 });
 
-defineTypedPageLayout(provider, {
+new CustomObjectPageLayout(providerObj, {
   apiName: 'default',
   name: 'Provider',
   layoutId: 'layout_dental_provider',
@@ -259,12 +579,12 @@ defineTypedPageLayout(provider, {
           {
             name: 'Booking',
             type: 'fields_section',
-            section: provider.sections.provider,
+            section: providerSection,
             fields: [
-              { field: 'name', editable: true },
-              'provider_status',
-              'booking_status',
-              'next_available_days',
+              { field: providerNameField, editable: true },
+              providerStatusField,
+              providerBookingStatusField,
+              providerNextAvailableDaysField,
             ],
           },
         ],
@@ -276,7 +596,7 @@ defineTypedPageLayout(provider, {
   visibilityConditions: {},
 });
 
-defineTypedPageLayout(operatory, {
+new CustomObjectPageLayout(operatoryObj, {
   apiName: 'default',
   name: 'Operatory',
   layoutId: 'layout_dental_operatory',
@@ -290,8 +610,8 @@ defineTypedPageLayout(operatory, {
           {
             name: 'Room',
             type: 'fields_section',
-            section: operatory.sections.operatory,
-            fields: [{ field: 'name', editable: true }, 'room_code', apptCountOnOperatory],
+            section: operatorySection,
+            fields: [{ field: opNameField, editable: true }, opCodeField, apptCountOnOperatory],
           },
         ],
       },
@@ -302,22 +622,23 @@ defineTypedPageLayout(operatory, {
   visibilityConditions: {},
 });
 
-defineTypedCustomObjectActionFromFunctionFile(manifest, appointment, {
+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, {
   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,
-  },
 });
 
-defineTypedPageLayout(appointment, {
+new CustomObjectPageLayout(apptObj, {
   apiName: 'default',
   name: 'Appointment',
   layoutId: 'layout_dental_appointment',
@@ -331,20 +652,20 @@ defineTypedPageLayout(appointment, {
           {
             name: 'Chair & schedule',
             type: 'fields_section',
-            section: appointment.sections.operatory_and_time,
-            fields: [{ field: 'name', editable: true }, 'operatory_ref', 'start_time', 'duration_minutes'],
+            section: apptOperatorySection,
+            fields: [{ field: 'name', editable: true }, apptOperatoryRef, apptStartField, apptDurationMins],
           },
           {
             name: 'Patient & status',
             type: 'fields_section',
-            section: appointment.sections.patient_and_visit,
+            section: apptPatientSection,
             fields: [
-              'patient_ref',
-              'provider_ref',
-              'visit_type',
-              'appointment_status',
-              'board_label',
-              'visit_notes',
+              apptPatientRef,
+              apptProviderRef,
+              apptVisitTypeField,
+              apptStatusField,
+              apptBoardLabel,
+              apptClinicalNotes,
             ],
           },
         ],
@@ -357,7 +678,7 @@ defineTypedPageLayout(appointment, {
   visibilityConditions: {},
 });
 
-defineTypedPageLayout(treatmentPlan, {
+new CustomObjectPageLayout(planObj, {
   apiName: 'default',
   name: 'Treatment plan',
   layoutId: 'layout_dental_treatment_plan',
@@ -371,19 +692,19 @@ defineTypedPageLayout(treatmentPlan, {
           {
             name: 'Patient',
             type: 'fields_section',
-            section: treatmentPlan.sections.link,
-            fields: ['plan_patient_ref'],
+            section: planLinkSection,
+            fields: [planPatientRef],
           },
           {
             name: 'Planned work',
             type: 'fields_section',
-            section: treatmentPlan.sections.plan,
+            section: planBodySection,
             fields: [
-              { field: 'name', editable: true },
-              'plan_status',
-              'target_completion',
-              'procedures_summary',
-              'fee_estimate_cents',
+              { field: planNameField, editable: true },
+              planStatusField,
+              planTargetField,
+              planProceduresField,
+              planFeeCents,
             ],
           },
         ],
@@ -395,12 +716,16 @@ defineTypedPageLayout(treatmentPlan, {
   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;
@@ -409,17 +734,20 @@ function createObjectListPage(props: {
   pageId: string;
   pageName: string;
 }): SduiPage {
-  return defineSduiPageFromFunctionFile(manifest, {
+  const listFn = new ManifestFunction(manifest, {
     apiName: props.functionApiName,
     name: props.functionName,
     description: props.functionDescription,
-    codeDirectory: path.join(__dirname, 'functions'),
-    codeFilename: props.codeFilename,
+    code: loadFunctionCode(props.codeFilename),
     dependencies: sduiObjectListDependencies,
     isAsync: false,
-    pageId: props.pageId,
-    pageName: props.pageName,
-  }).page;
+  });
+
+  return new SduiPage(manifest, {
+    sduiPageId: props.pageId,
+    name: props.pageName,
+    function: listFn,
+  });
 }
 
 const patientListPage = createObjectListPage({