@rippling/rippling-sdk 0.2.0-alpha.49 → 0.2.0-alpha.51

package/src/lib/manifest/custom-object.ts

@@ -301,7 +301,7 @@ export interface CustomObjectProps {
  * `owner_role`, `created_by`, and `last_modified_by` (all `Employee` references),
  * plus `name`, `created_at`, `updated_at`, `external_id`, and `id`. For any
  * "the employee responsible for this record" semantics, consider using
- * `owner_role` rather than adding a new {@link LookupField} targeting `'role'`.
+ * `owner_role` rather than adding a new {@link LookupField} targeting `'Employee'`.
  * `owner_role` drives Rippling's record-level permissions, so a parallel field
  * can fragment ownership and complicate the permission story.
  */

package/src/lib/manifest/existing-manifest-context.ts

@@ -417,11 +417,9 @@ export class ExistingManifestContext {
     return this.getOrLoad(cacheKey, () => {
       const customObject = this.loadCustomObject(customObjectApiName);
       this.loadPageLayoutDependencies(customObjectApiName, component);
-      return CustomObjectPageLayout._fromExistingComponent(customObject, component, (fieldApiName) => {
-        const fieldComponent = this.findFieldComponent(customObjectApiName, fieldApiName);
-        const sectionId = fieldComponent?.['section'];
-        return typeof sectionId === 'string' ? sectionId : undefined;
-      });
+      return CustomObjectPageLayout._fromExistingComponent(customObject, component, (fieldApiName) =>
+        this.fieldSectionIdForField(customObjectApiName, fieldApiName),
+      );
     });
   }
 
@@ -522,6 +520,12 @@ export class ExistingManifestContext {
     return matches[0] as Record<string, any>;
   }
 
+  private fieldSectionIdForField(customObjectApiName: string, fieldApiName: string): string | undefined {
+    const field = this.findFieldComponent(customObjectApiName, fieldApiName);
+    const section = field?.['section'];
+    return typeof section === 'string' && section.length > 0 ? section : undefined;
+  }
+
   private loadFieldReferenceComponent(component: Record<string, any>): Field {
     const cacheKey = this.cacheKey(
       'CUSTOM_OBJECT_FIELD_REF',
@@ -670,7 +674,8 @@ export class ExistingManifestContext {
     if (field == null || typeof field !== 'object') return;
     const record = field as Record<string, any>;
     const fieldSection = record['fieldSection'] ?? record['field_section'];
-    const fieldApiName = record['fieldRqlName'] ?? record['field_rql_name'];
+    const fieldApiName =
+      record['fieldRqlName'] ?? record['field_rql_name'] ?? record['apiName'] ?? record['api_name'];
     if (typeof fieldSection === 'string') {
       const fieldLabel = typeof fieldApiName === 'string' ? ` ${fieldApiName}` : '';
       this.loadRequiredFieldSection(

package/src/lib/manifest/field.ts

@@ -721,7 +721,7 @@ export class FileField extends Field {
 export interface LookupFieldProps extends CommonFieldProps {
   /**
    * The object this field points to. Pass a live {@link CustomObject} instance,
-   * or a raw api_name string for native Rippling models (e.g. `'role'`).
+   * or a raw api_name string for native Rippling models (e.g. `'Employee'`).
    *
    * Required.
    */
@@ -744,11 +744,11 @@ export interface LookupFieldProps extends CommonFieldProps {
  *
  * @remarks
  * **For "the employee responsible for this record" semantics, consider the built-in
- * `owner_role` standard field instead of a new `LookupField` to `'role'`.** Every
+ * `owner_role` standard field instead of a new `LookupField` to `'Employee'`.** Every
  * `CustomObject` ships with `owner_role` (an Employee reference) plus `created_by`
  * and `last_modified_by`. `owner_role` drives Rippling's record-level permissions,
  * so a parallel custom employee field can fragment ownership and complicate the
- * permission story. Consider a new `LookupField` to `'role'` when you need a
+ * permission story. Consider a new `LookupField` to `'Employee'` when you need a
  * *second*, non-owner employee reference (e.g. an "approver", a "manager on record").
  */
 export class LookupField extends Field {

package/src/lib/manifest/index.ts

@@ -35,28 +35,55 @@ export {
   type AddPageLayoutFieldsOptions,
   type AddPageLayoutSectionOptions,
   type AddPageLayoutTabOptions,
+  type BlueprintKey,
+  type CanvasCompositionId,
+  type CanvasSection,
+  type CustomObjectCustomSectionComponentKey,
   type CustomObjectPageLayoutLoadFromExistingOptions,
   type CustomObjectPageLayoutProps,
+  type CustomSection,
   type CustomTab,
+  type FieldMovementOption,
+  type FieldRqlName,
   type FieldsSection,
   type HeaderEdits,
+  type HeaderButtonKey,
+  type HeaderFieldKey,
+  type JsonObject,
+  type JsonPrimitive,
+  type JsonValue,
+  type LayoutApiName,
   type NewHeaderField,
+  type ObjectRqlName,
   type PageLayoutDeletionIdentifier,
   type PageLayoutMutationPosition,
   type PageLayoutSection,
+  type PageLayoutSectionOptions,
   type PageLayoutTab,
+  type RelatedFieldSection,
+  type RelatedObjectRqlName,
+  type RelatedObjectSection,
   type RemoveHeaderFieldOptions,
   type RemovePageLayoutFieldOptions,
   type RemovePageLayoutSectionOptions,
   type RemovePageLayoutTabOptions,
+  type ReportsSection,
+  type ReportsSectionItem,
+  type ResizableLayoutPosition,
   type SectionField,
+  type SectionFieldDefaultValue,
+  type SectionFieldInput,
   type SectionFieldOptions,
   type SectionFieldRef,
   type SectionFieldsLayout,
+  type SectionKey,
+  type SectionMovementOption,
   type SystemHeaderFieldEdit,
   type SystemSectionEdit,
   type SystemTabEdit,
+  type TabKey,
   type TabEdits,
+  type TabLayout,
   type TabWithSections,
   type VisibilityCondition,
   type VisibilityConditions,