fireberry-api-client 1.0.0-beta.2 → 1.0.0-beta.2.1

package/dist/index.d.cts

@@ -148,7 +148,14 @@ interface FireberryField {
     maxLength?: number;
     /** Precision for number fields */
     precision?: number;
-    /** Related object ID for lookup fields */
+    /**
+     * Related object type ID for lookup fields.
+     * Only populated when getFields is called with includeLookupRelations: true
+     */
+    relatedObjectType?: number;
+    /**
+     * @deprecated Use `relatedObjectType` instead. This was never populated by the API.
+     */
     relatedObjectId?: string;
 }
 /**
@@ -223,16 +230,31 @@ declare class MetadataAPI {
      * Gets all fields for a specific object type
      *
      * @param objectType - The object type ID (e.g., '1' for Account)
-     * @param signal - Optional AbortSignal for cancellation
+     * @param options - Optional settings
+     * @param options.includeLookupRelations - If true, fetches related object types for lookup fields (requires additional API call)
+     * @param options.signal - Optional AbortSignal for cancellation
      * @returns List of fields with metadata
      *
      * @example
      * ```typescript
      * const result = await client.metadata.getFields('1');
      * console.log(result.fields); // [{ fieldName: 'accountid', label: 'Account ID', ... }, ...]
+     *
+     * // With lookup relations
+     * const result = await client.metadata.getFields('1', { includeLookupRelations: true });
+     * console.log(result.fields.find(f => f.fieldName === 'primarycontactid')?.relatedObjectType); // 2
      * ```
      */
-    getFields(objectType: string | number, signal?: AbortSignal): Promise<GetFieldsResult>;
+    getFields(objectType: string | number, options?: {
+        includeLookupRelations?: boolean;
+        signal?: AbortSignal;
+    } | AbortSignal): Promise<GetFieldsResult>;
+    /**
+     * Fetches related object types for lookup fields using the query endpoint.
+     * The query endpoint returns Columns metadata with fieldobjecttype even without records.
+     * Excludes fields that cause API errors (e.g., deletedby, deletedon).
+     */
+    private fetchLookupRelations;
     /**
      * Gets all possible values for a dropdown field
      *

package/dist/index.d.ts

@@ -148,7 +148,14 @@ interface FireberryField {
     maxLength?: number;
     /** Precision for number fields */
     precision?: number;
-    /** Related object ID for lookup fields */
+    /**
+     * Related object type ID for lookup fields.
+     * Only populated when getFields is called with includeLookupRelations: true
+     */
+    relatedObjectType?: number;
+    /**
+     * @deprecated Use `relatedObjectType` instead. This was never populated by the API.
+     */
     relatedObjectId?: string;
 }
 /**
@@ -223,16 +230,31 @@ declare class MetadataAPI {
      * Gets all fields for a specific object type
      *
      * @param objectType - The object type ID (e.g., '1' for Account)
-     * @param signal - Optional AbortSignal for cancellation
+     * @param options - Optional settings
+     * @param options.includeLookupRelations - If true, fetches related object types for lookup fields (requires additional API call)
+     * @param options.signal - Optional AbortSignal for cancellation
      * @returns List of fields with metadata
      *
      * @example
      * ```typescript
      * const result = await client.metadata.getFields('1');
      * console.log(result.fields); // [{ fieldName: 'accountid', label: 'Account ID', ... }, ...]
+     *
+     * // With lookup relations
+     * const result = await client.metadata.getFields('1', { includeLookupRelations: true });
+     * console.log(result.fields.find(f => f.fieldName === 'primarycontactid')?.relatedObjectType); // 2
      * ```
      */
-    getFields(objectType: string | number, signal?: AbortSignal): Promise<GetFieldsResult>;
+    getFields(objectType: string | number, options?: {
+        includeLookupRelations?: boolean;
+        signal?: AbortSignal;
+    } | AbortSignal): Promise<GetFieldsResult>;
+    /**
+     * Fetches related object types for lookup fields using the query endpoint.
+     * The query endpoint returns Columns metadata with fieldobjecttype even without records.
+     * Excludes fields that cause API errors (e.g., deletedby, deletedon).
+     */
+    private fetchLookupRelations;
     /**
      * Gets all possible values for a dropdown field
      *

package/dist/index.js

@@ -12,6 +12,7 @@ var __export = (target, all) => {
 var excludedFields_exports = {};
 __export(excludedFields_exports, {
   EXCLUDED_FIELDS_FOR_STAR_QUERY: () => EXCLUDED_FIELDS_FOR_STAR_QUERY,
+  EXCLUDED_LOOKUP_FIELDS: () => EXCLUDED_LOOKUP_FIELDS,
   getExcludedFieldsForStarQuery: () => getExcludedFieldsForStarQuery,
   isExcludedFromStarQuery: () => isExcludedFromStarQuery
 });
@@ -24,7 +25,7 @@ function getExcludedFieldsForStarQuery(objectType) {
   const objectTypeStr = String(objectType);
   return EXCLUDED_FIELDS_FOR_STAR_QUERY[objectTypeStr] || [];
 }
-var EXCLUDED_FIELDS_FOR_STAR_QUERY;
+var EXCLUDED_FIELDS_FOR_STAR_QUERY, EXCLUDED_LOOKUP_FIELDS;
 var init_excludedFields = __esm({
   "src/constants/excludedFields.ts"() {
     EXCLUDED_FIELDS_FOR_STAR_QUERY = {
@@ -41,6 +42,7 @@ var init_excludedFields = __esm({
       "117": ["deletedon", "deletedby"]
       // Landing Page
     };
+    EXCLUDED_LOOKUP_FIELDS = ["deletedby", "deletedon"];
   }
 });
 
@@ -520,6 +522,13 @@ var FIELD_TYPE_MAPPINGS = {
 };
 
 // src/api/metadata.ts
+init_excludedFields();
+var ENDPOINTS = {
+  OBJECTS: "/metadata/records",
+  FIELDS: (objectType) => `/metadata/records/${objectType}/fields`,
+  FIELD_VALUES: (objectType, fieldName) => `/metadata/records/${objectType}/fields/${fieldName}/values`,
+  QUERY: "/api/query"
+};
 var MetadataAPI = class {
   constructor(client) {
     this.client = client;
@@ -543,7 +552,7 @@ var MetadataAPI = class {
     }
     const response = await this.client.request({
       method: "GET",
-      endpoint: "/metadata/records",
+      endpoint: ENDPOINTS.OBJECTS,
       signal
     });
     const result = {
@@ -558,30 +567,55 @@ var MetadataAPI = class {
    * Gets all fields for a specific object type
    *
    * @param objectType - The object type ID (e.g., '1' for Account)
-   * @param signal - Optional AbortSignal for cancellation
+   * @param options - Optional settings
+   * @param options.includeLookupRelations - If true, fetches related object types for lookup fields (requires additional API call)
+   * @param options.signal - Optional AbortSignal for cancellation
    * @returns List of fields with metadata
    *
    * @example
    * ```typescript
    * const result = await client.metadata.getFields('1');
    * console.log(result.fields); // [{ fieldName: 'accountid', label: 'Account ID', ... }, ...]
+   *
+   * // With lookup relations
+   * const result = await client.metadata.getFields('1', { includeLookupRelations: true });
+   * console.log(result.fields.find(f => f.fieldName === 'primarycontactid')?.relatedObjectType); // 2
    * ```
    */
-  async getFields(objectType, signal) {
+  async getFields(objectType, options) {
     const objectTypeStr = String(objectType);
-    const cached = this.client.getCached("fields", objectTypeStr);
-    if (cached) {
-      return cached;
+    const opts = options instanceof AbortSignal ? { signal: options, includeLookupRelations: false } : { signal: options?.signal, includeLookupRelations: options?.includeLookupRelations };
+    if (!opts.includeLookupRelations) {
+      const cached = this.client.getCached("fields", objectTypeStr);
+      if (cached) {
+        return cached;
+      }
     }
     const response = await this.client.request({
       method: "GET",
-      endpoint: `/metadata/records/${objectTypeStr}/fields`,
-      signal
+      endpoint: ENDPOINTS.FIELDS(objectTypeStr),
+      signal: opts.signal
     });
-    const fields = (response.data || []).map((field) => ({
+    let fields = (response.data || []).map((field) => ({
       ...field,
       fieldType: FIELD_TYPE_MAPPINGS[field.systemFieldTypeId] || field.systemFieldTypeId
     }));
+    if (opts.includeLookupRelations) {
+      const lookupFields = fields.filter(
+        (field) => field.systemFieldTypeId === FIELD_TYPE_IDS.LOOKUP
+      );
+      if (lookupFields.length > 0) {
+        const lookupRelations = await this.fetchLookupRelations(
+          objectTypeStr,
+          lookupFields.map((f) => f.fieldName),
+          opts.signal
+        );
+        fields = fields.map((field) => ({
+          ...field,
+          relatedObjectType: lookupRelations.get(field.fieldName)
+        }));
+      }
+    }
     const result = {
       objectTypeId: objectTypeStr,
       fields,
@@ -591,6 +625,40 @@ var MetadataAPI = class {
     this.client.setCache("fields", objectTypeStr, result);
     return result;
   }
+  /**
+   * Fetches related object types for lookup fields using the query endpoint.
+   * The query endpoint returns Columns metadata with fieldobjecttype even without records.
+   * Excludes fields that cause API errors (e.g., deletedby, deletedon).
+   */
+  async fetchLookupRelations(objectType, lookupFieldNames, signal) {
+    const relations = /* @__PURE__ */ new Map();
+    const queryableFields = lookupFieldNames.filter(
+      (fieldName) => !EXCLUDED_LOOKUP_FIELDS.includes(fieldName)
+    );
+    if (queryableFields.length === 0) {
+      return relations;
+    }
+    const response = await this.client.request({
+      method: "POST",
+      endpoint: ENDPOINTS.QUERY,
+      body: {
+        objecttype: objectType,
+        fields: queryableFields.join(","),
+        query: "",
+        page_size: 1,
+        page_number: 1,
+        show_real_value: 0
+      },
+      signal
+    });
+    const columns = response.data?.Columns || [];
+    for (const column of columns) {
+      if (column.fieldobjecttype !== null && column.fieldobjecttype !== void 0) {
+        relations.set(column.fieldname, column.fieldobjecttype);
+      }
+    }
+    return relations;
+  }
   /**
    * Gets all possible values for a dropdown field
    *
@@ -617,7 +685,7 @@ var MetadataAPI = class {
     }
     const response = await this.client.request({
       method: "GET",
-      endpoint: `/metadata/records/${objectTypeStr}/fields/${fieldName}/values`,
+      endpoint: ENDPOINTS.FIELD_VALUES(objectTypeStr, fieldName),
       signal
     });
     const result = {