fireberry-api-client 1.0.0-beta.1

package/dist/sdk/index.js

@@ -0,0 +1,1022 @@
+// src/utils/queryBuilder.ts
+function escapeQueryValue(value) {
+  if (!value) {
+    return "";
+  }
+  let escaped = value.replace(/\\/g, "\\\\");
+  escaped = escaped.replace(/\(/g, "\\(");
+  escaped = escaped.replace(/\)/g, "\\)");
+  escaped = escaped.replace(/\bor\b/gi, "\\or");
+  escaped = escaped.replace(/\band\b/gi, "\\and");
+  return escaped;
+}
+function sanitizeQuery(query) {
+  if (!query) {
+    return "";
+  }
+  query = query.replace(
+    /\(\s*([a-zA-Z0-9_]+)\s+(is-null|is-not-null)\s*\)/g,
+    "($1 __SPECIAL_OPERATOR__$2)"
+  );
+  query = query.replace(
+    /\(\s*([a-zA-Z0-9_]+)\s+(start-with|not-start-with)\s+([^)]+)\s*\)/g,
+    "($1 __TEXT_OPERATOR__$2 $3)"
+  );
+  query = query.replace(
+    /\(\s*([a-zA-Z0-9_]+(?:field|Field|system|System)[0-9]*)\s+(?!__SPECIAL_OPERATOR__|__TEXT_OPERATOR__)([^()<>=!]+)\s*\)/g,
+    "($1 = $2)"
+  );
+  query = query.replace(
+    /\(\s*([a-zA-Z0-9_]+)\s+(?!__SPECIAL_OPERATOR__|__TEXT_OPERATOR__|<=|>=|!=|<|>|=\s)([^()<>]+)\s*\)/g,
+    "($1 = $2)"
+  );
+  query = query.replace(/__SPECIAL_OPERATOR__/g, "");
+  query = query.replace(/__TEXT_OPERATOR__/g, "");
+  query = query.replace(/\(\s*(?:<=|>=|!=|<|>|=)\s*\)/g, "");
+  query = query.replace(/\(\s*(?:start-with|not-start-with)\s*\)/gi, "");
+  query = query.replace(/\(\s*(?:and|or)\s*\)/gi, "");
+  query = query.replace(/\(\s*\)/g, "");
+  query = query.replace(/^\s*(and|or)\s*/gi, "");
+  query = query.replace(/\s*(and|or)\s*$/gi, "");
+  const nestedPattern = /\(\s*\(([^()]+)\)\s*\)/g;
+  while (nestedPattern.test(query)) {
+    query = query.replace(nestedPattern, "($1)");
+  }
+  query = query.replace(/\s+/g, " ");
+  return query.trim();
+}
+var QueryBuilder = class {
+  conditions = [];
+  joinOperators = [];
+  currentField = null;
+  selectedFields = [];
+  objectTypeId = null;
+  sortByField = null;
+  sortDirection = "desc";
+  limitValue = null;
+  pageNumber = 1;
+  showRealValueFlag = true;
+  client = null;
+  /**
+   * Creates a new QueryBuilder
+   * @param client - Optional FireberryClient for executing queries
+   */
+  constructor(client) {
+    this.client = client ?? null;
+  }
+  /**
+   * Sets the object type for the query
+   * @param objectType - Object type ID (e.g., '1' for Account)
+   */
+  objectType(objectType) {
+    this.objectTypeId = String(objectType);
+    return this;
+  }
+  /**
+   * Adds fields to select
+   * @param fields - Field names to select
+   */
+  select(...fields) {
+    this.selectedFields.push(...fields);
+    return this;
+  }
+  /**
+   * Starts a new WHERE condition
+   * @param field - Field name to filter on
+   */
+  where(field) {
+    this.currentField = field;
+    return this.createConditionBuilder();
+  }
+  /**
+   * Adds an AND logical operator
+   */
+  and() {
+    if (this.conditions.length > 0) {
+      this.joinOperators.push("and");
+    }
+    return this;
+  }
+  /**
+   * Adds an OR logical operator
+   */
+  or() {
+    if (this.conditions.length > 0) {
+      this.joinOperators.push("or");
+    }
+    return this;
+  }
+  /**
+   * Sets the sort field and direction
+   * @param field - Field to sort by
+   * @param direction - Sort direction ('asc' or 'desc')
+   */
+  sortBy(field, direction = "desc") {
+    this.sortByField = field;
+    this.sortDirection = direction;
+    return this;
+  }
+  /**
+   * Sets the maximum number of records to return
+   * @param count - Maximum record count
+   */
+  limit(count) {
+    this.limitValue = count;
+    return this;
+  }
+  /**
+   * Sets the page number for pagination
+   * @param page - Page number (1-based)
+   */
+  page(page) {
+    this.pageNumber = page;
+    return this;
+  }
+  /**
+   * Controls whether to show real values (labels) for dropdown fields
+   * @param show - Whether to show real values (default: true)
+   */
+  showRealValue(show) {
+    this.showRealValueFlag = show;
+    return this;
+  }
+  /**
+   * Builds the query string from conditions
+   * @returns The built query string
+   */
+  build() {
+    if (this.conditions.length === 0) {
+      return "";
+    }
+    const parts = [];
+    for (let i = 0; i < this.conditions.length; i++) {
+      const condition = this.conditions[i];
+      let conditionStr;
+      if (condition.operator === "is-null" || condition.operator === "is-not-null") {
+        conditionStr = `(${condition.field} ${condition.operator})`;
+      } else {
+        const escapedValue = escapeQueryValue(condition.value || "");
+        conditionStr = `(${condition.field} ${condition.operator} ${escapedValue})`;
+      }
+      parts.push(conditionStr);
+      if (i < this.joinOperators.length) {
+        parts.push(this.joinOperators[i]);
+      }
+    }
+    return parts.join(" ");
+  }
+  /**
+   * Returns the selected fields array
+   * Useful for inspecting the query configuration
+   */
+  getFields() {
+    return [...this.selectedFields];
+  }
+  /**
+   * Converts the query builder state to a payload compatible with @fireberry/sdk
+   *
+   * @returns Object with `fields` (comma-separated string) and `query` (filter string)
+   *
+   * @example
+   * ```typescript
+   * import FireberryClientSDK from '@fireberry/sdk/client';
+   * import { QueryBuilder } from 'fireberry-api-client';
+   *
+   * const sdk = new FireberryClientSDK();
+   * await sdk.initializeContext();
+   *
+   * const payload = new QueryBuilder()
+   *   .select('accountid', 'accountname')
+   *   .where('statuscode').equals('1')
+   *   .toSDKPayload();
+   *
+   * // Use with SDK
+   * const results = await sdk.api.query(1, payload);
+   * ```
+   */
+  toSDKPayload() {
+    const payload = {
+      fields: this.selectedFields.length > 0 ? this.selectedFields.join(",") : "*",
+      query: this.build()
+    };
+    if (this.limitValue !== null) {
+      payload.page_size = this.limitValue;
+    }
+    if (this.pageNumber > 1) {
+      payload.page_number = this.pageNumber;
+    }
+    return payload;
+  }
+  /**
+   * Executes the query (requires client to be set)
+   * @param signal - Optional AbortSignal for cancellation
+   * @returns Query results
+   */
+  async execute(signal) {
+    if (!this.client) {
+      throw new Error("QueryBuilder requires a client to execute queries. Pass a FireberryClient to the constructor.");
+    }
+    if (!this.objectTypeId) {
+      throw new Error("Object type is required. Use .objectType() before executing.");
+    }
+    const queryOptions = {
+      objectType: this.objectTypeId,
+      fields: this.selectedFields.length > 0 ? this.selectedFields : ["*"],
+      query: this.build(),
+      showRealValue: this.showRealValueFlag
+    };
+    if (this.sortByField) {
+      queryOptions.sortBy = this.sortByField;
+      queryOptions.sortType = this.sortDirection;
+    }
+    if (this.limitValue !== null) {
+      queryOptions.limit = this.limitValue;
+    }
+    if (this.pageNumber > 1) {
+      queryOptions.page = this.pageNumber;
+    }
+    if (signal) {
+      queryOptions.signal = signal;
+    }
+    return this.client.query(queryOptions);
+  }
+  /**
+   * Creates a condition builder for the current field
+   */
+  createConditionBuilder() {
+    const field = this.currentField;
+    return {
+      equals: (value) => {
+        this.addCondition(field, "=", String(value));
+        return this;
+      },
+      notEquals: (value) => {
+        this.addCondition(field, "!=", String(value));
+        return this;
+      },
+      lessThan: (value) => {
+        this.addCondition(field, "<", String(value));
+        return this;
+      },
+      greaterThan: (value) => {
+        this.addCondition(field, ">", String(value));
+        return this;
+      },
+      lessThanOrEqual: (value) => {
+        this.addCondition(field, "<=", String(value));
+        return this;
+      },
+      greaterThanOrEqual: (value) => {
+        this.addCondition(field, ">=", String(value));
+        return this;
+      },
+      contains: (value) => {
+        this.addCondition(field, "start-with", `%${value}`);
+        return this;
+      },
+      notContains: (value) => {
+        this.addCondition(field, "not-start-with", `%${value}`);
+        return this;
+      },
+      startsWith: (value) => {
+        this.addCondition(field, "start-with", value);
+        return this;
+      },
+      notStartsWith: (value) => {
+        this.addCondition(field, "not-start-with", value);
+        return this;
+      },
+      isNull: () => {
+        this.addCondition(field, "is-null");
+        return this;
+      },
+      isNotNull: () => {
+        this.addCondition(field, "is-not-null");
+        return this;
+      }
+    };
+  }
+  /**
+   * Adds a condition to the query
+   */
+  addCondition(field, operator, value) {
+    this.conditions.push({ field, operator, value });
+    this.currentField = null;
+  }
+};
+
+// src/utils/fieldMapping.ts
+var SPECIAL_LABEL_FIELD_MAPPINGS = {
+  objectid: "objecttitle",
+  lastactionid: "lastactiontitle",
+  wfruleid: "rulename",
+  // Object 55 (Workflow Rules)
+  noteid: "subject"
+  // Object 7 (Note) - noteid maps to subject
+};
+var EXCLUDED_ID_FIELDS = [
+  "businessunitid",
+  // → businessunitidname (not businessunitname)
+  "crmuserid",
+  // → no name field exists
+  "languageid"
+  // → languageidname (not languagename)
+];
+var EXCLUDED_CODE_FIELDS = [
+  "duplicaterecordcode"
+  // → duplicaterecordcodename (not duplicaterecord)
+];
+var FIELDS_WITHOUT_LABEL_FIELD = [
+  "systemfieldid",
+  // Object 73 - no name field exists
+  "fieldobjecttype",
+  // Object 73 - base field doesn't exist, only *name exists
+  "invoiceid",
+  // Objects 78, 81 - no name field exists
+  "calllogid",
+  // Object 100 - no name field exists (primary key)
+  "attendanceclockid",
+  // Object 101 - no name field exists (primary key)
+  "activitylogid",
+  // Object 102 - no name field exists (primary key)
+  "conversationid",
+  // Object 104 - no name field exists (primary key)
+  "texttemplateid",
+  // Text Template - no name field exists (primary key)
+  "smstemplateid",
+  // Object 110 - no name field exists (primary key)
+  "deletedby",
+  // Object 7 - no name field exists
+  "recordid",
+  // Object 7 - no name field exists
+  "objecttypecode"
+  // Object 7 - no name field exists
+];
+var OBJECT_TYPE_OVERRIDES = {
+  // CRM Orders (13) - uses *idname and *codename patterns
+  13: {
+    excludedIdFields: ["ownerid", "accountid", "printtemplateid", "pcfaccountid"],
+    excludedCodeFields: [
+      "rounddiscountcode",
+      "taxincludecode",
+      "currencycode",
+      "transmissioncode",
+      "creditrejectioncode1",
+      "creditrejectioncode2",
+      "apartmentcode1",
+      "apartmentcode2",
+      "restrictioncode1",
+      "restrictioncode2",
+      "casescode1",
+      "casescode2",
+      "returncode1",
+      "returncode2",
+      "statuscode"
+    ]
+  },
+  // Products (14)
+  14: {
+    excludedCodeFields: ["categorycode"]
+    // → categoryname (not category)
+  },
+  // CRM Order Items (17) - uses *idname pattern
+  17: {
+    excludedIdFields: ["crmorderid", "productid", "ownerid"]
+  },
+  // Email Templates (20)
+  20: {
+    excludedIdFields: ["mdobjectid"]
+  },
+  // Print Templates (27)
+  27: {
+    excludedIdFields: ["mdobjectid"]
+  },
+  // System Fields (73) - uses *idname pattern
+  73: {
+    excludedIdFields: ["mdobjectid", "ownerid"]
+  },
+  // Invoices (78) - uses *codename and *idname patterns extensively
+  78: {
+    excludedIdFields: [
+      "crmorderid",
+      "invoicereceiptid",
+      "accountid",
+      "ownerid",
+      "invoicerenoid"
+    ],
+    excludedCodeFields: [
+      "taxincludecode",
+      "depositcode",
+      "rounddiscountcode",
+      "currencycode",
+      "statecode",
+      "invoicetypecode"
+    ]
+  },
+  // Invoice No (81) - uses *codename and *idname patterns extensively
+  81: {
+    excludedIdFields: [
+      "ownerid",
+      "invoicecreditid",
+      "crmorderid",
+      "invoicereceiptid",
+      "invoicedeliveryid",
+      "accountid"
+    ],
+    excludedCodeFields: ["currencycode", "rounddiscountcode", "statecode", "taxincludecode"]
+  },
+  // Invoice Draft (82) - uses *codename and *idname patterns extensively
+  82: {
+    excludedIdFields: ["accountid", "crmorderid", "ownerid", "invoicerenoid"],
+    excludedCodeFields: ["taxincludecode", "statecode", "rounddiscountcode", "currencycode"]
+  },
+  // Invoice Receipt (83) - uses *codename and *idname patterns
+  83: {
+    excludedIdFields: ["invoicenoid", "crmorderid", "ownerid", "accountid"],
+    excludedCodeFields: ["statecode", "currencycode"]
+  },
+  // Invoice Tax Receipt (84) - uses *codename and *idname patterns
+  84: {
+    excludedIdFields: ["crmorderid", "ownerid", "invoicecreditid", "accountid"],
+    excludedCodeFields: ["rounddiscountcode", "statecode", "taxincludecode", "currencycode"]
+  },
+  // Invoice Credit (85) - uses *codename and *idname patterns
+  85: {
+    excludedIdFields: ["ownerid", "crmorderid", "accountid"],
+    excludedCodeFields: ["taxincludecode", "rounddiscountcode", "currencycode", "statecode"]
+  },
+  // Invoice (86) - uses *codename and *idname patterns
+  86: {
+    excludedIdFields: ["accountid", "ownerid", "crmorderid"],
+    excludedCodeFields: ["statecode", "rounddiscountcode", "currencycode", "taxincludecode"]
+  },
+  // Call Log (100) - uses *idname pattern
+  100: {
+    excludedIdFields: ["contactid", "leadid", "accountid", "ownerid"]
+  },
+  // Attendance Clock (101) - uses *idname pattern
+  101: {
+    excludedIdFields: ["ownerid"]
+  },
+  // Activity Log (102) - uses *idname and *codename patterns
+  102: {
+    excludedIdFields: ["contactid", "ownerid"],
+    excludedCodeFields: ["objecttypecode", "typecode", "resultcode"]
+  },
+  // Conversation (104) - uses *idname pattern
+  104: {
+    excludedIdFields: ["leadid", "ownerid", "contactid", "accountid"]
+  },
+  // Text Template (106) - uses *idname pattern
+  106: {
+    excludedIdFields: ["ownerid"]
+  },
+  // SMS Template (110) - uses *idname pattern
+  110: {
+    excludedIdFields: ["ownerid"]
+  }
+};
+function getLabelFieldForField(fieldName, objectType) {
+  if (SPECIAL_LABEL_FIELD_MAPPINGS[fieldName]) {
+    return SPECIAL_LABEL_FIELD_MAPPINGS[fieldName];
+  }
+  if (FIELDS_WITHOUT_LABEL_FIELD.includes(fieldName)) {
+    return "";
+  }
+  if (/^customobject\d+id$/.test(fieldName)) {
+    return "name";
+  }
+  if (fieldName.startsWith("pcf")) {
+    return `${fieldName}name`;
+  }
+  const objectTypeNum = typeof objectType === "string" ? parseInt(objectType, 10) : objectType;
+  const overrides = OBJECT_TYPE_OVERRIDES[objectTypeNum] || null;
+  const isCustomObject = objectTypeNum >= 1e3;
+  const customObjectExclusions = isCustomObject ? ["ownerid"] : [];
+  const excludedCodeFields = [
+    ...EXCLUDED_CODE_FIELDS,
+    ...overrides?.excludedCodeFields || []
+  ];
+  const excludedIdFields = [
+    ...EXCLUDED_ID_FIELDS,
+    ...overrides?.excludedIdFields || [],
+    ...customObjectExclusions
+  ];
+  if (fieldName.endsWith("code") && !excludedCodeFields.includes(fieldName)) {
+    return fieldName.slice(0, -4);
+  }
+  if (fieldName.endsWith("id") && !excludedIdFields.includes(fieldName)) {
+    return fieldName.slice(0, -2) + "name";
+  }
+  return `${fieldName}name`;
+}
+
+// src/constants/objectIds.ts
+var OBJECT_ID_MAP = {
+  1: "accountid",
+  2: "contactid",
+  3: "leadid",
+  4: "opportunityid",
+  5: "casesid",
+  6: "activityid",
+  7: "noteid",
+  8: "competitorid",
+  9: "crmuserid",
+  10: "taskid",
+  13: "crmorderid",
+  14: "productid",
+  17: "crmorderitemid",
+  20: "emailtemplateid",
+  23: "businessunitid",
+  27: "printtemplateid",
+  28: "contractid",
+  33: "accountproductid",
+  46: "projectid",
+  67: "campaignid",
+  76: "articleid",
+  86: "invoiceid",
+  101: "attendanceclockid",
+  102: "activitylogid",
+  104: "conversationid",
+  114: "calendarresourceid"
+};
+function getObjectIdFieldName(objectTypeId) {
+  const objectTypeNum = typeof objectTypeId === "string" ? parseInt(objectTypeId, 10) : objectTypeId;
+  if (OBJECT_ID_MAP[objectTypeNum]) {
+    return OBJECT_ID_MAP[objectTypeNum];
+  }
+  if (objectTypeNum >= 1e3) {
+    return `customobject${objectTypeNum}id`;
+  }
+  return "id";
+}
+
+// src/constants/objectNames.ts
+var OBJECT_NAME_MAP = {
+  1: "accountname",
+  // Account
+  2: "fullname",
+  // Contact
+  3: "fullname",
+  // Lead
+  4: "name",
+  // Opportunity
+  5: "title",
+  // Case
+  6: "subject",
+  // Activity
+  7: "subject",
+  // Note
+  8: "name",
+  // Competitor
+  9: "fullname",
+  // CRM User
+  10: "subject",
+  // Task
+  13: "name",
+  // CRM Order
+  14: "productname",
+  // Product
+  17: "productname",
+  // CRM Order Item
+  20: "name",
+  // Email Template
+  23: "name",
+  // Business Unit
+  27: "name",
+  // Print Template
+  28: "name",
+  // Contract
+  33: "productname",
+  // Account Product
+  46: "name",
+  // Project
+  67: "name",
+  // Campaign
+  76: "title",
+  // Article
+  86: "name",
+  // Invoice
+  101: "name",
+  // Attendance Clock
+  102: "subject",
+  // Activity Log
+  104: "subject",
+  // Conversation
+  114: "name"
+  // Calendar Resource
+};
+function getNameFieldByObjectType(objectTypeId) {
+  const objectTypeNum = typeof objectTypeId === "string" ? parseInt(objectTypeId, 10) : objectTypeId;
+  if (OBJECT_NAME_MAP[objectTypeNum]) {
+    return OBJECT_NAME_MAP[objectTypeNum];
+  }
+  if (objectTypeNum >= 1e3) {
+    return "name";
+  }
+  return "name";
+}
+
+// src/constants/excludedFields.ts
+var EXCLUDED_FIELDS_FOR_STAR_QUERY = {
+  "7": ["deletedon", "deletedby"],
+  // Note
+  "8": ["deletedon", "deletedby"],
+  // Competitor
+  "114": ["deletedon", "deletedby"],
+  // Calendar Resource
+  "115": ["deletedon", "deletedby"],
+  // Customer Journey
+  "116": ["deletedon", "deletedby"],
+  // Profile
+  "117": ["deletedon", "deletedby"]
+  // Landing Page
+};
+function getExcludedFieldsForStarQuery(objectType) {
+  const objectTypeStr = String(objectType);
+  return EXCLUDED_FIELDS_FOR_STAR_QUERY[objectTypeStr] || [];
+}
+
+// src/constants/fieldTypes.ts
+var FIELD_TYPE_IDS = {
+  DROPDOWN: "b4919f2e-2996-48e4-a03c-ba39fb64386c",
+  LOOKUP: "a8fcdf65-91bc-46fd-82f6-1234758345a1",
+  EMAIL: "c713d2f7-8fa9-43c3-8062-f07486eaf567",
+  TEXT: "a1e7ed6f-5083-477b-b44c-9943a6181359",
+  URL: "c820d32f-44df-4c2a-9c1e-18734e864fd5",
+  LONG_TEXT: "80108f9d-1e75-40fa-9fa9-02be4ddc1da1",
+  DATETIME: "ce972d02-5013-46d4-9d1d-f09df1ac346a",
+  DATE: "83bf530c-e04c-462b-9ffc-a46f750fc072",
+  HTML: "ed2ad39d-32fc-4585-8f5b-2e93463f050a",
+  TELEPHONE: "3f62f67a-1cee-403a-bec6-aa02a9804edb",
+  NUMERIC: "6a34bfe3-fece-4da1-9136-a7b1e5ae3319"
+};
+var FIELD_TYPE_MAPPINGS = {
+  [FIELD_TYPE_IDS.DROPDOWN]: "Dropdown",
+  [FIELD_TYPE_IDS.EMAIL]: "Email",
+  [FIELD_TYPE_IDS.TEXT]: "Text",
+  [FIELD_TYPE_IDS.LOOKUP]: "Lookup",
+  [FIELD_TYPE_IDS.URL]: "URL",
+  [FIELD_TYPE_IDS.LONG_TEXT]: "Long Text",
+  [FIELD_TYPE_IDS.DATETIME]: "DateTime",
+  [FIELD_TYPE_IDS.DATE]: "Date",
+  [FIELD_TYPE_IDS.HTML]: "HTML",
+  [FIELD_TYPE_IDS.TELEPHONE]: "Telephone",
+  [FIELD_TYPE_IDS.NUMERIC]: "Number"
+};
+
+// src/utils/fieldTypes.ts
+function isDropdownField(systemFieldTypeId) {
+  return systemFieldTypeId === FIELD_TYPE_IDS.DROPDOWN;
+}
+function isLookupField(systemFieldTypeId) {
+  return systemFieldTypeId === FIELD_TYPE_IDS.LOOKUP;
+}
+function isDropdownOrLookupField(systemFieldTypeId) {
+  return isDropdownField(systemFieldTypeId) || isLookupField(systemFieldTypeId);
+}
+
+// src/sdk/index.ts
+var SDKQueryBuilder = class {
+  builder;
+  objectTypeId;
+  sdk;
+  selectedFields = [];
+  pageSizeValue;
+  pageNum = 1;
+  constructor(sdk, objectType) {
+    this.sdk = sdk;
+    this.objectTypeId = objectType;
+    this.builder = new QueryBuilder();
+  }
+  /**
+   * Select fields to return
+   * @param fields - Field names to include in results
+   */
+  select(...fields) {
+    this.selectedFields.push(...fields);
+    return this;
+  }
+  /**
+   * Select fields with their label fields automatically included
+   * Useful for dropdown and lookup fields where you want both ID and display value
+   * @param fields - Field names to include
+   */
+  selectWithLabels(...fields) {
+    const objectType = typeof this.objectTypeId === "string" ? parseInt(this.objectTypeId, 10) : this.objectTypeId;
+    for (const field of fields) {
+      if (!this.selectedFields.includes(field)) {
+        this.selectedFields.push(field);
+      }
+      const labelField = getLabelFieldForField(field, objectType);
+      if (labelField && !this.selectedFields.includes(labelField)) {
+        this.selectedFields.push(labelField);
+      }
+    }
+    return this;
+  }
+  /**
+   * Start a WHERE condition
+   * @param field - Field name to filter on
+   */
+  where(field) {
+    const innerBuilder = this.builder.where(field);
+    return {
+      equals: (value) => {
+        innerBuilder.equals(value);
+        return this;
+      },
+      notEquals: (value) => {
+        innerBuilder.notEquals(value);
+        return this;
+      },
+      lessThan: (value) => {
+        innerBuilder.lessThan(value);
+        return this;
+      },
+      greaterThan: (value) => {
+        innerBuilder.greaterThan(value);
+        return this;
+      },
+      lessThanOrEqual: (value) => {
+        innerBuilder.lessThanOrEqual(value);
+        return this;
+      },
+      greaterThanOrEqual: (value) => {
+        innerBuilder.greaterThanOrEqual(value);
+        return this;
+      },
+      contains: (value) => {
+        innerBuilder.contains(value);
+        return this;
+      },
+      notContains: (value) => {
+        innerBuilder.notContains(value);
+        return this;
+      },
+      startsWith: (value) => {
+        innerBuilder.startsWith(value);
+        return this;
+      },
+      notStartsWith: (value) => {
+        innerBuilder.notStartsWith(value);
+        return this;
+      },
+      isNull: () => {
+        innerBuilder.isNull();
+        return this;
+      },
+      isNotNull: () => {
+        innerBuilder.isNotNull();
+        return this;
+      }
+    };
+  }
+  /**
+   * Add AND logical operator
+   */
+  and() {
+    this.builder.and();
+    return this;
+  }
+  /**
+   * Add OR logical operator
+   */
+  or() {
+    this.builder.or();
+    return this;
+  }
+  /**
+   * Set page size for pagination
+   * @param size - Number of records per page
+   */
+  pageSize(size) {
+    this.pageSizeValue = size;
+    return this;
+  }
+  /**
+   * Set page number for pagination
+   * @param page - Page number (1-based)
+   */
+  page(page) {
+    this.pageNum = page;
+    return this;
+  }
+  /**
+   * Build the query payload without executing
+   * Useful if you want to modify the payload before sending
+   */
+  toQueryPayload() {
+    const payload = {
+      fields: this.selectedFields.length > 0 ? this.selectedFields.join(",") : "*",
+      query: this.builder.build()
+    };
+    if (this.pageSizeValue !== void 0) {
+      payload.page_size = this.pageSizeValue;
+    }
+    if (this.pageNum > 1) {
+      payload.page_number = this.pageNum;
+    }
+    return payload;
+  }
+  /**
+   * Execute the query via the SDK
+   */
+  async execute() {
+    const payload = this.toQueryPayload();
+    return this.sdk.query(this.objectTypeId, payload);
+  }
+};
+function createSDKQueryBuilder(sdk) {
+  const api = "api" in sdk ? sdk.api : sdk;
+  return (objectType) => new SDKQueryBuilder(api, objectType);
+}
+var EnhancedSDK = class _EnhancedSDK {
+  sdk;
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  /**
+   * Create an EnhancedSDK wrapper around an existing SDK instance
+   * The SDK should already be initialized with context
+   *
+   * @param sdk - Initialized Fireberry SDK client
+   */
+  static create(sdk) {
+    return new _EnhancedSDK(sdk);
+  }
+  /**
+   * Get the current context (user and record info)
+   */
+  get context() {
+    return this.sdk.context;
+  }
+  /**
+   * Get the underlying SDK API for direct access
+   */
+  get api() {
+    return this.sdk.api;
+  }
+  /**
+   * Get the current user ID from context
+   */
+  get userId() {
+    return this.context?.user?.id;
+  }
+  /**
+   * Get the current user's full name from context
+   */
+  get userFullName() {
+    return this.context?.user?.fullName;
+  }
+  /**
+   * Get the current record ID from context
+   */
+  get recordId() {
+    return this.context?.record?.id;
+  }
+  /**
+   * Get the current record's object type from context
+   */
+  get recordType() {
+    return this.context?.record?.type;
+  }
+  /**
+   * Start building a query for an object type
+   *
+   * @param objectType - Object type ID (e.g., 1 for Account, 2 for Contact)
+   * @returns SDKQueryBuilder for fluent query construction
+   *
+   * @example
+   * ```typescript
+   * const results = await enhanced
+   *   .query(1)
+   *   .select('accountid', 'accountname')
+   *   .where('ownerid').equals(enhanced.userId)
+   *   .execute();
+   * ```
+   */
+  query(objectType) {
+    return new SDKQueryBuilder(this.sdk.api, objectType);
+  }
+  /**
+   * Get the primary key field name for an object type
+   *
+   * @param objectType - Object type ID
+   * @returns Primary key field name (e.g., 'accountid' for type 1)
+   *
+   * @example
+   * ```typescript
+   * const idField = enhanced.getIdField(1); // 'accountid'
+   * const idField = enhanced.getIdField(2); // 'contactid'
+   * ```
+   */
+  getIdField(objectType) {
+    return getObjectIdFieldName(objectType);
+  }
+  /**
+   * Get the display name field for an object type
+   *
+   * @param objectType - Object type ID
+   * @returns Name field (e.g., 'accountname' for type 1, 'fullname' for type 2)
+   *
+   * @example
+   * ```typescript
+   * const nameField = enhanced.getNameField(1); // 'accountname'
+   * const nameField = enhanced.getNameField(2); // 'fullname'
+   * ```
+   */
+  getNameField(objectType) {
+    return getNameFieldByObjectType(objectType);
+  }
+  /**
+   * Get the label field for a dropdown or lookup field
+   *
+   * @param fieldName - API field name
+   * @param objectType - Object type ID
+   * @returns Label field name, or empty string if not applicable
+   *
+   * @example
+   * ```typescript
+   * const labelField = enhanced.getLabelField('statuscode', 1); // 'status'
+   * const labelField = enhanced.getLabelField('ownerid', 1);    // 'ownername'
+   * ```
+   */
+  getLabelField(fieldName, objectType) {
+    return getLabelFieldForField(fieldName, objectType);
+  }
+  /**
+   * Get fields that should be excluded from * (star) queries for an object type
+   * Some fields cause API errors when included in broad queries
+   *
+   * @param objectType - Object type ID
+   * @returns Array of field names to exclude
+   */
+  getExcludedFields(objectType) {
+    return getExcludedFieldsForStarQuery(objectType);
+  }
+  /**
+   * Expand field list to include label fields for dropdowns and lookups
+   *
+   * @param fields - Original field list
+   * @param objectType - Object type ID
+   * @returns Expanded field list with label fields
+   *
+   * @example
+   * ```typescript
+   * const fields = enhanced.expandFieldsWithLabels(['statuscode', 'ownerid'], 1);
+   * // Returns: ['statuscode', 'status', 'ownerid', 'ownername']
+   * ```
+   */
+  expandFieldsWithLabels(fields, objectType) {
+    const result = [];
+    for (const field of fields) {
+      if (!result.includes(field)) {
+        result.push(field);
+      }
+      const labelField = getLabelFieldForField(field, objectType);
+      if (labelField && !result.includes(labelField)) {
+        result.push(labelField);
+      }
+    }
+    return result;
+  }
+  /**
+   * Create a record
+   *
+   * @param objectType - Object type ID
+   * @param data - Record data
+   */
+  create(objectType, data) {
+    return this.sdk.api.create(objectType, data);
+  }
+  /**
+   * Update a record
+   *
+   * @param objectType - Object type ID
+   * @param recordId - Record ID to update
+   * @param data - Updated field values
+   */
+  update(objectType, recordId, data) {
+    return this.sdk.api.update(objectType, recordId, data);
+  }
+  /**
+   * Delete a record
+   *
+   * @param objectType - Object type ID
+   * @param recordId - Record ID to delete
+   */
+  delete(objectType, recordId) {
+    return this.sdk.api.delete(objectType, recordId);
+  }
+  /**
+   * Clean up the underlying SDK
+   */
+  destroy() {
+    this.sdk.destroy();
+  }
+};
+
+export { EXCLUDED_FIELDS_FOR_STAR_QUERY, EnhancedSDK, FIELD_TYPE_IDS, FIELD_TYPE_MAPPINGS, OBJECT_ID_MAP, OBJECT_NAME_MAP, QueryBuilder, SDKQueryBuilder, createSDKQueryBuilder, escapeQueryValue, getExcludedFieldsForStarQuery, getLabelFieldForField, getNameFieldByObjectType, getObjectIdFieldName, isDropdownField, isDropdownOrLookupField, isLookupField, sanitizeQuery };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map