@rippling/rippling-sdk 0.2.0-alpha.41 → 0.2.0-alpha.43

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

@@ -10,6 +10,7 @@ import { ManifestFunction } from './manifest-function';
 import { Rule } from './rule';
 import { SduiPage } from './sdui-page';
 import { Validation } from './validation';
+import { requireObjectComponentField, requireStringComponentField } from './_existing-component-fields';
 
 export interface ExistingManifest {
   metadata?: Record<string, any>;
@@ -316,37 +317,52 @@ export class ExistingManifestContext {
   }
 
   private loadCategoryComponent(component: Record<string, any>): Category {
-    const cacheKey = this.cacheKey('CUSTOM_CATEGORY', component['api_name']);
+    const apiName = requireStringComponentField(component, 'api_name', Category.componentType);
+    const cacheKey = this.cacheKey('CUSTOM_CATEGORY', apiName);
     return this.getOrLoad(cacheKey, () =>
       Category._fromExistingComponent(this.getManifestBuilder(), component),
     );
   }
 
   private loadCustomObjectComponent(component: Record<string, any>): CustomObject {
-    const cacheKey = this.cacheKey('CUSTOM_OBJECT', component['api_name']);
+    const customObjectApiName = requireStringComponentField(
+      component,
+      'api_name',
+      CustomObject.componentType,
+    );
+    const cacheKey = this.cacheKey('CUSTOM_OBJECT', customObjectApiName);
     return this.getOrLoad(cacheKey, () => {
       return CustomObject._fromExistingComponent(this.getManifestBuilder(), component, (categoryApiName) =>
-        this.hasComponent('CUSTOM_CATEGORY', (c) => c['api_name'] === categoryApiName) ?
-          this.loadCategory(categoryApiName)
-        : categoryApiName,
+        this.loadRequiredCategoryForCustomObject(categoryApiName, customObjectApiName),
       );
     });
   }
 
   private loadFieldSectionComponent(component: Record<string, any>): CustomObjectFieldSection {
-    const cacheKey = this.cacheKey(
-      'CUSTOM_OBJECT_FIELD_SECTION',
-      `${component['model_name']}.${component['section_id']}`,
+    const modelName = requireStringComponentField(
+      component,
+      'model_name',
+      CustomObjectFieldSection.componentType,
     );
+    const sectionId = requireStringComponentField(
+      component,
+      'section_id',
+      CustomObjectFieldSection.componentType,
+    );
+    const cacheKey = this.cacheKey('CUSTOM_OBJECT_FIELD_SECTION', `${modelName}.${sectionId}`);
     return this.getOrLoad(cacheKey, () => {
-      const customObject = this.loadCustomObject(component['model_name']);
+      const customObject = this.loadCustomObject(modelName);
       return CustomObjectFieldSection._fromExistingComponent(customObject, component);
     });
   }
 
   private loadFieldComponent(component: Record<string, any>): Field {
-    const customObjectApiName = component['custom_object_api_name'];
-    const fieldApiName = component['field_api_name'];
+    const customObjectApiName = requireStringComponentField(
+      component,
+      'custom_object_api_name',
+      Field.componentType,
+    );
+    const fieldApiName = requireStringComponentField(component, 'field_api_name', Field.componentType);
     if (component['is_standard'] === true) {
       this.loadCustomObject(customObjectApiName);
       return this.loadFieldReferenceComponent(component);
@@ -357,7 +373,11 @@ export class ExistingManifestContext {
       const customObject = this.loadCustomObject(customObjectApiName);
       const sectionId = component['section'];
       if (typeof sectionId === 'string') {
-        this.loadFieldSectionIfPresent(customObjectApiName, sectionId);
+        this.loadRequiredFieldSection(
+          customObjectApiName,
+          sectionId,
+          `CUSTOM_OBJECT_FIELD ${customObjectApiName}.${fieldApiName}`,
+        );
       }
       this.loadFieldRelationshipDependencies(component);
       return Field._fromExistingComponent(customObject, component);
@@ -365,12 +385,14 @@ export class ExistingManifestContext {
   }
 
   private loadListViewComponent(component: Record<string, any>): ListViewDef {
-    const cacheKey = this.cacheKey(
-      'CUSTOM_OBJECT_LIST_VIEW',
-      `${component['object_rql_name']}.${component['view_id']}`,
+    const customObjectApiName = requireStringComponentField(
+      component,
+      'object_rql_name',
+      ListViewDef.componentType,
     );
+    const viewId = requireStringComponentField(component, 'view_id', ListViewDef.componentType);
+    const cacheKey = this.cacheKey('CUSTOM_OBJECT_LIST_VIEW', `${customObjectApiName}.${viewId}`);
     return this.getOrLoad(cacheKey, () => {
-      const customObjectApiName = component['object_rql_name'];
       const customObject = this.loadCustomObject(customObjectApiName);
       return ListViewDef._fromExistingComponent(customObject, component, (fieldApiName) =>
         this.loadFieldByObjectAndApi(customObjectApiName, fieldApiName),
@@ -379,12 +401,18 @@ export class ExistingManifestContext {
   }
 
   private loadPageLayoutComponent(component: Record<string, any>): CustomObjectPageLayout {
-    const cacheKey = this.cacheKey(
-      'CUSTOM_OBJECT_PAGE_LAYOUT',
-      component['layout_id'] ?? `${component['object_rql_name']}.${component['api_name']}`,
+    const layoutId = requireStringComponentField(
+      component,
+      'layout_id',
+      CustomObjectPageLayout.componentType,
+    );
+    const customObjectApiName = requireStringComponentField(
+      component,
+      'object_rql_name',
+      CustomObjectPageLayout.componentType,
     );
+    const cacheKey = this.cacheKey('CUSTOM_OBJECT_PAGE_LAYOUT', layoutId);
     return this.getOrLoad(cacheKey, () => {
-      const customObjectApiName = component['object_rql_name'];
       const customObject = this.loadCustomObject(customObjectApiName);
       this.loadPageLayoutDependencies(customObjectApiName, component);
       return CustomObjectPageLayout._fromExistingComponent(customObject, component);
@@ -392,12 +420,14 @@ export class ExistingManifestContext {
   }
 
   private loadValidationComponent(component: Record<string, any>): Validation {
-    const cacheKey = this.cacheKey(
-      'CUSTOM_OBJECT_VALIDATION_RULE',
-      `${component['model_rql_name']}.${component['rule_id']}`,
+    const customObjectApiName = requireStringComponentField(
+      component,
+      'model_rql_name',
+      Validation.componentType,
     );
+    const ruleId = requireStringComponentField(component, 'rule_id', Validation.componentType);
+    const cacheKey = this.cacheKey('CUSTOM_OBJECT_VALIDATION_RULE', `${customObjectApiName}.${ruleId}`);
     return this.getOrLoad(cacheKey, () => {
-      const customObjectApiName = component['model_rql_name'];
       const customObject = this.loadCustomObject(customObjectApiName);
       return Validation._fromExistingComponent(customObject, component, (fieldApiName) =>
         this.loadFieldByObjectAndApi(customObjectApiName, fieldApiName),
@@ -406,12 +436,10 @@ export class ExistingManifestContext {
   }
 
   private loadRuleComponent(component: Record<string, any>): Rule {
-    const cacheKey = this.cacheKey(
-      'CUSTOM_OBJECT_RECORD_TRIGGERED_FLOW',
-      `${component['model_rql_name']}.${component['flow_id']}`,
-    );
+    const customObjectApiName = requireStringComponentField(component, 'model_rql_name', Rule.componentType);
+    const flowId = requireStringComponentField(component, 'flow_id', Rule.componentType);
+    const cacheKey = this.cacheKey('CUSTOM_OBJECT_RECORD_TRIGGERED_FLOW', `${customObjectApiName}.${flowId}`);
     return this.getOrLoad(cacheKey, () => {
-      const customObjectApiName = component['model_rql_name'];
       const customObject = this.loadCustomObject(customObjectApiName);
       return Rule._fromExistingComponent(customObject, component, (fieldApiName) =>
         this.loadFieldByObjectAndApi(customObjectApiName, fieldApiName),
@@ -420,25 +448,26 @@ export class ExistingManifestContext {
   }
 
   private loadFunctionComponent(component: Record<string, any>): ManifestFunction {
-    const cacheKey = this.cacheKey('FUNCTION', component['api_name']);
+    const apiName = requireStringComponentField(component, 'api_name', ManifestFunction.componentType);
+    const cacheKey = this.cacheKey('FUNCTION', apiName);
     return this.getOrLoad(cacheKey, () =>
       ManifestFunction._fromExistingComponent(this.getManifestBuilder(), component),
     );
   }
 
   private loadSduiPageComponent(component: Record<string, any>): SduiPage {
-    const cacheKey = this.cacheKey('SDUI_PAGE', component['sdui_page_id']);
+    const sduiPageId = requireStringComponentField(component, 'sdui_page_id', SduiPage.componentType);
+    const cacheKey = this.cacheKey('SDUI_PAGE', sduiPageId);
     return this.getOrLoad(cacheKey, () => {
       return SduiPage._fromExistingComponent(this.getManifestBuilder(), component, (functionApiName) =>
-        this.hasComponent('FUNCTION', (c) => c['api_name'] === functionApiName) ?
-          this.loadFunction(functionApiName)
-        : functionApiName,
+        this.loadRequiredFunctionForSduiPage(functionApiName, component),
       );
     });
   }
 
   private loadAppComponent(component: Record<string, any>): App {
-    const cacheKey = this.cacheKey('CUSTOM_APP', component['api_name']);
+    const apiName = requireStringComponentField(component, 'api_name', App.componentType);
+    const cacheKey = this.cacheKey('CUSTOM_APP', apiName);
     return this.getOrLoad(cacheKey, () => {
       this.loadAppDependencies(component);
       return App._fromExistingComponent(this.getManifestBuilder(), component);
@@ -495,13 +524,48 @@ export class ExistingManifestContext {
     return this.getOrLoad(cacheKey, () => Field._referenceFromExistingComponent(component));
   }
 
+  private loadRequiredCategoryForCustomObject(
+    categoryApiName: string,
+    customObjectApiName: string,
+  ): Category {
+    const component = this.ofType('CUSTOM_CATEGORY').find(
+      (candidate) => candidate['api_name'] === categoryApiName,
+    );
+    if (component == null) {
+      throw new Error(
+        `CUSTOM_OBJECT ${customObjectApiName} references CUSTOM_CATEGORY ${categoryApiName}, ` +
+          'but that category component is not present. Pass the full existing component extraction ' +
+          'to ManifestBuilder.loadFromExistingJson(...).',
+      );
+    }
+    return this.loadCategoryComponent(component);
+  }
+
+  private loadRequiredFunctionForSduiPage(
+    functionApiName: string,
+    component: Record<string, any>,
+  ): ManifestFunction {
+    const sduiPageId = component['sdui_page_id'] ?? 'unknown';
+    const functionComponent = this.ofType('FUNCTION').find(
+      (candidate) => candidate['api_name'] === functionApiName,
+    );
+    if (functionComponent == null) {
+      throw new Error(
+        `SDUI_PAGE ${sduiPageId} references FUNCTION ${functionApiName}, ` +
+          'but that function component is not present. Pass the full existing component extraction ' +
+          'to ManifestBuilder.loadFromExistingJson(...).',
+      );
+    }
+    return this.loadFunctionComponent(functionComponent);
+  }
+
   private loadSyntheticFieldReference(customObjectApiName: string, fieldApiName: string): Field {
     const cacheKey = this.cacheKey('CUSTOM_OBJECT_FIELD_REF', `${customObjectApiName}.${fieldApiName}`);
     return this.getOrLoad(cacheKey, () => Field._syntheticReference(customObjectApiName, fieldApiName));
   }
 
   private loadFieldRelationshipDependencies(component: Record<string, any>): void {
-    const dataType = component['data_type'] ?? {};
+    const dataType = requireObjectComponentField(component, 'data_type', Field.componentType);
     const targetApiName = dataType['og_model_rql_name'];
     if (
       typeof targetApiName === 'string' &&
@@ -600,8 +664,17 @@ export class ExistingManifestContext {
     }
     if (field == null || typeof field !== 'object') return;
     const record = field as Record<string, any>;
-    this.loadFieldSectionIfPresent(customObjectApiName, record['fieldSection'] ?? record['field_section']);
-    this.loadFieldDependencyIfString(customObjectApiName, record['fieldRqlName'] ?? record['field_rql_name']);
+    const fieldSection = record['fieldSection'] ?? record['field_section'];
+    const fieldApiName = record['fieldRqlName'] ?? record['field_rql_name'];
+    if (typeof fieldSection === 'string') {
+      const fieldLabel = typeof fieldApiName === 'string' ? ` ${fieldApiName}` : '';
+      this.loadRequiredFieldSection(
+        customObjectApiName,
+        fieldSection,
+        `CUSTOM_OBJECT_PAGE_LAYOUT field${fieldLabel} on ${customObjectApiName}`,
+      );
+    }
+    this.loadFieldDependencyIfString(customObjectApiName, fieldApiName);
   }
 
   private loadFieldDependencyIfString(customObjectApiName: string, fieldApiName: unknown): void {
@@ -620,6 +693,20 @@ export class ExistingManifestContext {
     }
   }
 
+  private loadRequiredFieldSection(customObjectApiName: string, sectionId: string, ownerLabel: string): void {
+    const component = this.ofType('CUSTOM_OBJECT_FIELD_SECTION').find(
+      (candidate) => candidate['model_name'] === customObjectApiName && candidate['section_id'] === sectionId,
+    );
+    if (component == null) {
+      throw new Error(
+        `${ownerLabel} references CUSTOM_OBJECT_FIELD_SECTION ${sectionId}, ` +
+          'but that field section component is not present. Pass the full existing component extraction ' +
+          'to ManifestBuilder.loadFromExistingJson(...).',
+      );
+    }
+    this.loadFieldSectionComponent(component);
+  }
+
   private loadAppDependencies(component: Record<string, any>): void {
     for (const page of component['pages'] ?? []) {
       if (page == null || typeof page !== 'object') continue;

package/src/lib/manifest/field.ts

@@ -9,6 +9,7 @@ import type { CustomObject } from './custom-object';
 import type { CustomObjectFieldSection } from './custom-object-field-section';
 import { getExistingManifestContext, type ExistingManifestContextOptions } from './existing-manifest-context';
 import type { ManifestComponentDeletion } from './manifest-builder';
+import { requireObjectComponentField, requireStringComponentField } from './_existing-component-fields';
 
 export interface CustomObjectFieldDeletionIdentifier {
   customObjectApiName: string;
@@ -124,15 +125,19 @@ class ExistingFieldReference {
     private readonly customObjectApiName: string,
     private readonly component: Record<string, any>,
   ) {
+    requireStringComponentField(component, 'custom_object_api_name', Field.componentType);
+    requireStringComponentField(component, 'field_api_name', Field.componentType);
+    requireStringComponentField(component, 'field_display_name', Field.componentType);
+    requireObjectComponentField(component, 'data_type', Field.componentType);
     this._section = (component['section'] as string | null | undefined) ?? null;
   }
 
   getApiName(): string {
-    return this.component['field_api_name'];
+    return this.component['field_api_name'] as string;
   }
 
   getDisplayName(): string {
-    return this.component['field_display_name'] ?? this.getApiName();
+    return this.component['field_display_name'] as string;
   }
 
   getCustomObjectApiName(): string {
@@ -144,7 +149,7 @@ class ExistingFieldReference {
   }
 
   getDataType(): Readonly<Record<string, any>> {
-    return this.component['data_type'] ?? {};
+    return this.component['data_type'] as Record<string, any>;
   }
 
   isFormula(): boolean {
@@ -270,10 +275,10 @@ export class Field {
   /** @internal Hydrates a custom object field from existing manifest wire JSON. */
   static _fromExistingComponent(customObject: CustomObject, component: Record<string, any>): Field {
     const props: FieldProps = {
-      apiName: component['field_api_name'],
-      displayName: component['field_display_name'] ?? component['field_api_name'],
+      apiName: requireStringComponentField(component, 'field_api_name', Field.componentType),
+      displayName: requireStringComponentField(component, 'field_display_name', Field.componentType),
+      dataType: cloneJson(requireObjectComponentField(component, 'data_type', Field.componentType)),
     };
-    if (component['data_type'] !== undefined) props.dataType = cloneJson(component['data_type'] ?? {});
     if (component['description'] !== undefined) props.description = component['description'];
     if (component['is_required'] !== undefined) props.required = component['is_required'];
     if (component['is_unique'] !== undefined) props.unique = component['is_unique'];
@@ -293,10 +298,13 @@ export class Field {
 
   /** @internal Creates a non-registered reference for standard or external fields. */
   static _referenceFromExistingComponent(component: Record<string, any>): Field {
-    return new ExistingFieldReference(
-      component['custom_object_api_name'],
-      cloneJson(component),
-    ) as unknown as Field;
+    const customObjectApiName = requireStringComponentField(
+      component,
+      'custom_object_api_name',
+      Field.componentType,
+    );
+    requireStringComponentField(component, 'field_api_name', Field.componentType);
+    return new ExistingFieldReference(customObjectApiName, cloneJson(component)) as unknown as Field;
   }
 
   /** @internal Creates a non-registered reference for a known wire field name. */

package/src/lib/manifest/index.ts

@@ -121,6 +121,7 @@ export {
 
 export {
   ListViewDef,
+  type ListViewColumnConfig,
   type ListViewDefLoadFromExistingOptions,
   type ListViewDefProps,
   type ListViewDeletionIdentifier,

package/src/lib/manifest/list-view.ts

@@ -3,12 +3,27 @@ import type { CustomObject } from './custom-object';
 import { getExistingManifestContext, type ExistingManifestContextOptions } from './existing-manifest-context';
 import type { Field } from './field';
 import type { ManifestComponentDeletion } from './manifest-builder';
+import {
+  requireArrayComponentField,
+  requireBooleanComponentField,
+  requireStringComponentField,
+} from './_existing-component-fields';
 
 export interface ListViewDeletionIdentifier {
   viewId: string;
   objectRqlName: string;
 }
 
+/**
+ * Per-column display configuration for a list view.
+ */
+export interface ListViewColumnConfig {
+  /**
+   * Relative display width for this column.
+   */
+  widthRatio: number;
+}
+
 /**
  * Initialization properties for {@link ListViewDef}.
  */
@@ -63,11 +78,14 @@ export interface ListViewDefProps {
    */
   description?: string;
   /**
-   * Per-column configuration overrides (width, visibility, etc.).
+   * Per-column configuration overrides keyed by field API name.
+   *
+   * Only `widthRatio` is currently supported. Presentation hints such as
+   * badge/status rendering are not list-view column config options.
    *
    * Optional. @default `{}`
    */
-  columnConfig?: Record<string, any>;
+  columnConfig?: Record<string, ListViewColumnConfig>;
   /**
    * RQL filter expression to pre-filter records shown in this view
    * (e.g. `'(session_date__c == TODAY())'`).
@@ -134,7 +152,7 @@ export class ListViewDef {
   private readonly _sortOrder: SortOrder | undefined;
   private readonly _objectScope: ObjectScope | undefined;
   private readonly _description: string | undefined;
-  private readonly _columnConfig: Record<string, any> | undefined;
+  private readonly _columnConfig: Record<string, ListViewColumnConfig> | undefined;
   private readonly _rqlFilter: string | undefined;
 
   /**
@@ -178,10 +196,12 @@ export class ListViewDef {
     resolveField: (apiName: string) => Field,
   ): ListViewDef {
     const props: ListViewDefProps = {
-      viewId: component['view_id'],
-      name: component['name'] ?? component['view_id'],
-      fields: (component['fields'] ?? []).map((fieldApiName: string) => resolveField(fieldApiName)),
-      isPublic: Boolean(component['public']),
+      viewId: requireStringComponentField(component, 'view_id', ListViewDef.componentType),
+      name: requireStringComponentField(component, 'name', ListViewDef.componentType),
+      fields: requireArrayComponentField<string>(component, 'fields', ListViewDef.componentType).map(
+        (fieldApiName: string) => resolveField(fieldApiName),
+      ),
+      isPublic: requireBooleanComponentField(component, 'public', ListViewDef.componentType),
     };
     if (component['description'] !== undefined) props.description = component['description'];
     if (component['object_scope'] !== undefined) props.objectScope = component['object_scope'];

package/src/lib/manifest/manifest-function.ts

@@ -1,6 +1,7 @@
 import type { FunctionRuntime } from './_helpers';
 import { getExistingManifestContext, type ExistingManifestContextOptions } from './existing-manifest-context';
 import type { ManifestComponentDeletion, ManifestScope } from './manifest-builder';
+import { requireStringComponentField } from './_existing-component-fields';
 
 /**
  * Initialization properties for {@link ManifestFunction}.
@@ -148,8 +149,8 @@ export class ManifestFunction {
   /** @internal Hydrates a function from existing manifest wire JSON. */
   static _fromExistingComponent(scope: ManifestScope, component: Record<string, any>): ManifestFunction {
     const props: ManifestFunctionProps = {
-      apiName: component['api_name'],
-      name: component['name'] ?? component['api_name'],
+      apiName: requireStringComponentField(component, 'api_name', ManifestFunction.componentType),
+      name: requireStringComponentField(component, 'name', ManifestFunction.componentType),
     };
     if (component['code_draft'] !== undefined) props.code = component['code_draft'];
     if (component['description'] !== undefined) props.description = component['description'];

package/src/lib/manifest/rule.ts

@@ -3,6 +3,7 @@ import type { CustomObject } from './custom-object';
 import { getExistingManifestContext, type ExistingManifestContextOptions } from './existing-manifest-context';
 import type { Field } from './field';
 import type { ManifestComponentDeletion } from './manifest-builder';
+import { requireStringComponentField } from './_existing-component-fields';
 
 export interface RuleDeletionIdentifier {
   flowId: string;
@@ -193,9 +194,9 @@ export class Rule {
     resolveField: (apiName: string) => Field,
   ): Rule {
     const props: RuleProps = {
-      flowId: component['flow_id'],
-      flowName: component['flow_name'] ?? component['flow_id'],
-      triggerType: component['trigger_type'],
+      flowId: requireStringComponentField(component, 'flow_id', Rule.componentType),
+      flowName: requireStringComponentField(component, 'flow_name', Rule.componentType),
+      triggerType: requireStringComponentField(component, 'trigger_type', Rule.componentType) as TriggerType,
       actions: (component['actions'] ?? []).map((action: Record<string, any>): RuleAction => {
         const out: RuleAction = {
           targetField: resolveField(action['target_field']),

package/src/lib/manifest/sdui-page.ts

@@ -1,6 +1,7 @@
 import { getExistingManifestContext, type ExistingManifestContextOptions } from './existing-manifest-context';
 import type { ManifestFunction } from './manifest-function';
 import type { ManifestComponentDeletion, ManifestScope } from './manifest-builder';
+import { requireStringComponentField } from './_existing-component-fields';
 
 /**
  * Initialization properties for {@link SduiPage}.
@@ -101,13 +102,17 @@ export class SduiPage {
   static _fromExistingComponent(
     scope: ManifestScope,
     component: Record<string, any>,
-    resolveFunction: (apiName: string) => ManifestFunction | string,
+    resolveFunction: (apiName: string) => ManifestFunction,
   ): SduiPage {
-    const functionApiName = component['function_api_name'];
+    const functionApiName = requireStringComponentField(
+      component,
+      'function_api_name',
+      SduiPage.componentType,
+    );
     const props: SduiPageProps = {
-      sduiPageId: component['sdui_page_id'],
-      name: component['name'] ?? component['sdui_page_id'],
-      function: typeof functionApiName === 'string' ? resolveFunction(functionApiName) : functionApiName,
+      sduiPageId: requireStringComponentField(component, 'sdui_page_id', SduiPage.componentType),
+      name: requireStringComponentField(component, 'name', SduiPage.componentType),
+      function: resolveFunction(functionApiName),
     };
     if (component['description'] !== undefined) {
       props.description = component['description'];

package/src/lib/manifest/validation.ts

@@ -3,6 +3,7 @@ import type { CustomObject } from './custom-object';
 import { getExistingManifestContext, type ExistingManifestContextOptions } from './existing-manifest-context';
 import type { Field } from './field';
 import type { ManifestComponentDeletion } from './manifest-builder';
+import { requireStringComponentField } from './_existing-component-fields';
 
 export interface ValidationDeletionIdentifier {
   ruleId: string;
@@ -147,13 +148,17 @@ export class Validation {
     resolveField: (apiName: string) => Field,
   ): Validation {
     const props: ValidationProps = {
-      ruleId: component['rule_id'],
-      displayName: component['display_name'] ?? component['rule_id'],
-      rqlFormula: component['rql_formula'] ?? '',
-      errorMessage: component['custom_error_message'] ?? '',
-      state: component['state'],
-      level: component['level'],
-      ruleDescription: component['rule_description'] ?? '',
+      ruleId: requireStringComponentField(component, 'rule_id', Validation.componentType),
+      displayName: requireStringComponentField(component, 'display_name', Validation.componentType),
+      rqlFormula: requireStringComponentField(component, 'rql_formula', Validation.componentType),
+      errorMessage: requireStringComponentField(component, 'custom_error_message', Validation.componentType, {
+        allowEmpty: true,
+      }),
+      state: requireStringComponentField(component, 'state', Validation.componentType) as ValidationState,
+      level: requireStringComponentField(component, 'level', Validation.componentType) as ValidationLevel,
+      ruleDescription: requireStringComponentField(component, 'rule_description', Validation.componentType, {
+        allowEmpty: true,
+      }),
     };
     if (component['field_rql_name'] != null) props.fieldRef = resolveField(component['field_rql_name']);
     return new Validation(customObject, props);

package/src/resources/draft-hires.ts

@@ -123,6 +123,13 @@ export namespace DraftHireCreateParams {
      * Documents to attach to this draft hire
      */
     documents?: Array<DraftHire.Document>;
+
+    /**
+     * Headcount planning info for hiring into a position. If provided, the draft hire
+     * will be linked to the specified open headcount allocation. Requires headcount
+     * planning to be enabled for the company.
+     */
+    headcount_info?: DraftHire.HeadcountInfo;
   }
 
   export namespace DraftHire {
@@ -569,6 +576,18 @@ export namespace DraftHireCreateParams {
        */
       signature_date?: string;
     }
+
+    /**
+     * Headcount planning info for hiring into a position. If provided, the draft hire
+     * will be linked to the specified open headcount allocation. Requires headcount
+     * planning to be enabled for the company.
+     */
+    export interface HeadcountInfo {
+      /**
+       * The Position ID (PID) of the headcount allocation to fill (e.g., PID100615)
+       */
+      position_id: string;
+    }
   }
 }
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.2.0-alpha.41'; // x-release-please-version
+export const VERSION = '0.2.0-alpha.43'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.2.0-alpha.41";
+export declare const VERSION = "0.2.0-alpha.43";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.2.0-alpha.41";
+export declare const VERSION = "0.2.0-alpha.43";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.2.0-alpha.41'; // x-release-please-version
+exports.VERSION = '0.2.0-alpha.43'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.2.0-alpha.41'; // x-release-please-version
+export const VERSION = '0.2.0-alpha.43'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map