@simplysf/simply-sobject-core 0.2.0

package/README.md

@@ -0,0 +1,63 @@
+# @simplysf/simply-sobject-core
+
+[![NPM](https://img.shields.io/npm/v/@simplysf/simply-sobject-core?label=@simplysf/simply-sobject-core)](https://npmjs.com/@simplysf/simply-sobject-core) [![Downloads/week](https://img.shields.io/npm/dw/@simplysf/simply-sobject-core.svg)](https://npmjs.com/@simplysf/simply-sobject-core) [![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://raw.githubusercontent.com/SimplySF/simply-node/main/LICENSE.txt)
+
+Field history object derivation/filtering and relationship-field discovery. This is not a Salesforce CLI plugin — it's the library layer behind [`@simplysf/simply-sobject`](https://github.com/SimplySF/simply-plugins/tree/main/packages/simply-sobject)'s field-history and backup commands, published separately so it can be imported directly by anything that wants the same logic (an editor extension, a CI job, a script) without pulling in the CLI framework.
+
+## Install
+
+```bash
+npm install @simplysf/simply-sobject-core
+```
+
+Requires Node.js `>=22` and either `"type": "module"` or a dynamic `import()` — this package ships ESM only.
+
+## API
+
+Everything below is exported from the package root. Removing or renaming an export is a breaking change; see [`src/index.ts`](src/index.ts).
+
+| Export                                                                                                       | Description                                                                                                                   |
+| ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------- |
+| `getHistoryObjectName(sobject)`                                                                              | Derives a field history object's API name for a tracked sobject (e.g. `Account` → `AccountHistory`).                          |
+| `getParentIdField(sobject)`                                                                                  | Derives a field history object's lookup field back to its parent record.                                                      |
+| `buildWhereClause(filter, parentFieldName, soqlFilterableFields)`                                            | Builds a SOQL WHERE clause from the SOQL-filterable subset of a filter tree.                                                  |
+| `recordMatchesClientFilters(record, filter, parentFieldName, soqlFilterableFields)`                          | Evaluates the non-SOQL-filterable subset of a filter tree against a queried record.                                           |
+| `discoverRelationshipFields(connection, fields)`                                                             | Discovers identifying-field relationship paths (e.g. `RecordType.Name`) for an SObject's describe result.                     |
+| `buildFieldHistorySchemaReportHtml(options)`                                                                 | Pure function: renders a self-contained HTML report of field-history-tracked objects/fields.                                  |
+| `FilterConditionSchema`, `FilterGroupSchema`, `FilterConfigSchema`                                           | zod schemas for parsing/validating a filter tree (the JSON shape `simply sobject history` commands' `--filter` flag accepts). |
+| `FilterCondition`, `FilterGroup`, `FilterConfig`, `FieldHistorySchemaEntry`, `GroupedFieldHistorySchemaData` | Supporting types.                                                                                                             |
+
+```ts
+import { getHistoryObjectName, getParentIdField } from '@simplysf/simply-sobject-core';
+
+getHistoryObjectName('Opportunity'); // 'OpportunityFieldHistory'
+getParentIdField('My_Object__c'); // 'ParentId'
+```
+
+```ts
+import { FilterConfigSchema, buildWhereClause, recordMatchesClientFilters } from '@simplysf/simply-sobject-core';
+
+const filter = FilterConfigSchema.parse(JSON.parse(rawJson));
+const whereClause = buildWhereClause(filter, 'AccountId', new Set(['AccountId', 'CreatedDate']));
+// ...run the query, then for each returned record:
+const included = recordMatchesClientFilters(record, filter, 'AccountId', new Set(['AccountId', 'CreatedDate']));
+```
+
+```ts
+import { discoverRelationshipFields } from '@simplysf/simply-sobject-core';
+
+const describeResult = await connection.describe('Account');
+const relationshipPaths = await discoverRelationshipFields(connection, describeResult.fields);
+```
+
+## Issues
+
+Please report any issues at https://github.com/SimplySF/simply-node/issues
+
+## Contributing
+
+This package is part of the [`@simplysf/simply`](https://github.com/SimplySF/simply-node) monorepo. See [CONTRIBUTING.md](CONTRIBUTING.md) for what's specific to this package, and the repo's [root CONTRIBUTING.md](https://github.com/SimplySF/simply-node/blob/main/CONTRIBUTING.md) for repo structure, setup, commit conventions, and how to submit a pull request. Please also read our [Code of Conduct](https://github.com/SimplySF/simply-node/blob/main/CODE_OF_CONDUCT.md).
+
+## License
+
+Licensed under the [Apache-2.0](https://raw.githubusercontent.com/SimplySF/simply-node/main/LICENSE.txt) license.

package/lib/fieldHistory.d.ts

@@ -0,0 +1,43 @@
+import type { FilterGroup } from './schemas/history/filterConfig.js';
+/**
+ * Derive the field history object's API name for an sobject. Opportunity is a special case —
+ * its history object is `OpportunityFieldHistory`, not `OpportunityHistory`.
+ *
+ * @param sobject - The tracked sobject's API name.
+ * @returns The corresponding field history object's API name.
+ */
+export declare function getHistoryObjectName(sobject: string): string;
+/**
+ * Derive the field history object's lookup field back to the parent record.
+ *
+ * @param sobject - The tracked sobject's API name.
+ * @returns The field history object's lookup field name (e.g. `AccountId`, `ParentId`).
+ */
+export declare function getParentIdField(sobject: string): string;
+/**
+ * Build a SOQL WHERE clause from the subset of a filter tree that references SOQL-filterable
+ * fields. Conditions on any other field are left for {@link recordMatchesClientFilters} to
+ * apply after the query runs.
+ *
+ * @param node - The filter tree (or subtree) to build a clause from.
+ * @param parentFieldName - The history object's real parent lookup field, substituted for the
+ * `'ParentId'` placeholder.
+ * @param soqlFilterableFields - Fields that can be safely pushed into the SOQL WHERE clause;
+ * conditions on any other field are omitted here.
+ * @returns The WHERE clause body (no leading `WHERE`), or `''` if nothing was filterable.
+ */
+export declare function buildWhereClause(node: FilterGroup | undefined, parentFieldName: string, soqlFilterableFields: ReadonlySet<string>): string;
+/**
+ * Evaluate whether a queried record satisfies the parts of a filter tree that reference fields
+ * *not* covered by the SOQL WHERE clause (e.g. OldValue/NewValue). Conditions on SOQL-filterable
+ * fields are treated as already satisfied, since the query itself enforced them.
+ *
+ * @param record - The queried record to test.
+ * @param node - The filter tree (or subtree) to evaluate.
+ * @param parentFieldName - The history object's real parent lookup field, substituted for the
+ * `'ParentId'` placeholder.
+ * @param soqlFilterableFields - Fields already enforced by the SOQL WHERE clause; conditions on
+ * these fields are treated as satisfied without re-checking.
+ * @returns Whether `record` satisfies the non-SOQL-filterable parts of `node`.
+ */
+export declare function recordMatchesClientFilters(record: Record<string, string>, node: FilterGroup | undefined, parentFieldName: string, soqlFilterableFields: ReadonlySet<string>): boolean;

package/lib/fieldHistory.js

@@ -0,0 +1,187 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Derive the field history object's API name for an sobject. Opportunity is a special case —
+ * its history object is `OpportunityFieldHistory`, not `OpportunityHistory`.
+ *
+ * @param sobject - The tracked sobject's API name.
+ * @returns The corresponding field history object's API name.
+ */
+export function getHistoryObjectName(sobject) {
+    if (sobject === 'Opportunity') {
+        return 'OpportunityFieldHistory';
+    }
+    if (sobject.endsWith('__c')) {
+        return `${sobject.slice(0, -3)}__History`;
+    }
+    return `${sobject}History`;
+}
+/**
+ * Derive the field history object's lookup field back to the parent record.
+ *
+ * @param sobject - The tracked sobject's API name.
+ * @returns The field history object's lookup field name (e.g. `AccountId`, `ParentId`).
+ */
+export function getParentIdField(sobject) {
+    if (sobject === 'Opportunity') {
+        return 'OpportunityId';
+    }
+    if (sobject.endsWith('__c')) {
+        return 'ParentId';
+    }
+    return `${sobject}Id`;
+}
+/** Type guard distinguishing a nested {@link FilterGroup} from a leaf {@link FilterCondition}. */
+function isFilterGroup(filter) {
+    return 'logic' in filter;
+}
+/**
+ * @param field - The filter's configured field name; `'ParentId'` is a placeholder for the
+ * history object's actual parent lookup field.
+ * @param parentFieldName - The history object's real parent lookup field (e.g. `AccountId`).
+ * @returns `parentFieldName` if `field` is the `'ParentId'` placeholder, otherwise `field` as-is.
+ */
+function resolveFieldName(field, parentFieldName) {
+    return field === 'ParentId' ? parentFieldName : field;
+}
+/**
+ * @param operator - The filter condition's operator.
+ * @param value - The filter condition's configured value.
+ * @param isDateField - Whether the field being compared is a date/datetime field (affects string
+ * quoting, since date literals shouldn't be quoted).
+ * @returns The value formatted as a SOQL literal, ready to interpolate into a WHERE clause.
+ */
+function formatSoqlValue(operator, value, isDateField) {
+    if (operator === 'IN' || operator === 'NOT IN') {
+        const values = Array.isArray(value) ? value : [value];
+        return `(${values.map((v) => (typeof v === 'string' ? `'${v}'` : String(v))).join(',')})`;
+    }
+    if (typeof value === 'string' && !isDateField) {
+        return `'${value}'`;
+    }
+    return String(value);
+}
+/**
+ * Build a SOQL WHERE clause from the subset of a filter tree that references SOQL-filterable
+ * fields. Conditions on any other field are left for {@link recordMatchesClientFilters} to
+ * apply after the query runs.
+ *
+ * @param node - The filter tree (or subtree) to build a clause from.
+ * @param parentFieldName - The history object's real parent lookup field, substituted for the
+ * `'ParentId'` placeholder.
+ * @param soqlFilterableFields - Fields that can be safely pushed into the SOQL WHERE clause;
+ * conditions on any other field are omitted here.
+ * @returns The WHERE clause body (no leading `WHERE`), or `''` if nothing was filterable.
+ */
+export function buildWhereClause(node, parentFieldName, soqlFilterableFields) {
+    if (!node || node.filters.length === 0) {
+        return '';
+    }
+    const clause = node.filters
+        .map((filter) => {
+        if (isFilterGroup(filter)) {
+            const nested = buildWhereClause(filter, parentFieldName, soqlFilterableFields);
+            return nested ? `(${nested})` : '';
+        }
+        const field = resolveFieldName(filter.field, parentFieldName);
+        if (!soqlFilterableFields.has(field)) {
+            return '';
+        }
+        const value = formatSoqlValue(filter.operator, filter.value, field === 'CreatedDate');
+        return `${field} ${filter.operator} ${value}`;
+    })
+        .filter((part) => part.length > 0)
+        .join(` ${node.logic} `);
+    return clause;
+}
+/**
+ * @param pattern - A SOQL `LIKE` pattern (`%` as the wildcard).
+ * @returns An equivalent `RegExp` source string, with regex metacharacters escaped and `%`
+ * translated to `.*`.
+ */
+function escapeLikePattern(pattern) {
+    return pattern.replace(/[.*+?^${}()|[\]\\]/g, '\\$&').replace(/%/g, '.*');
+}
+/**
+ * @param recordValue - The record's (string-valued) field value.
+ * @param filterValue - The filter condition's configured value.
+ * @param operator - The filter condition's operator.
+ * @returns Whether the comparison holds. Numeric-looking values are compared numerically.
+ */
+function compareValues(recordValue, filterValue, operator) {
+    if (operator === 'IN' || operator === 'NOT IN') {
+        const values = Array.isArray(filterValue) ? filterValue : [filterValue];
+        const isMember = values.some((value) => String(value) === recordValue);
+        return operator === 'IN' ? isMember : !isMember;
+    }
+    if (operator === 'LIKE') {
+        return new RegExp(`^${escapeLikePattern(String(filterValue))}$`).test(recordValue ?? '');
+    }
+    // record values are always strings (queryRecords() normalizes both the REST and Bulk API
+    // paths to strings), so numeric/date comparisons need explicit coercion back to numbers —
+    // otherwise e.g. "9" > "10" would be true, and "5" === 5 would never match.
+    const numericRecord = recordValue !== undefined && recordValue !== '' ? Number(recordValue) : NaN;
+    const numericFilter = typeof filterValue === 'number' ? filterValue : Number(filterValue);
+    const bothNumeric = !Number.isNaN(numericRecord) && !Number.isNaN(numericFilter);
+    const left = bothNumeric ? numericRecord : (recordValue ?? '');
+    const right = bothNumeric ? numericFilter : String(filterValue);
+    switch (operator) {
+        case '=':
+            return left === right;
+        case '!=':
+            return left !== right;
+        case '>':
+            return left > right;
+        case '<':
+            return left < right;
+        case '>=':
+            return left >= right;
+        case '<=':
+            return left <= right;
+        default:
+            return false;
+    }
+}
+/**
+ * Evaluate whether a queried record satisfies the parts of a filter tree that reference fields
+ * *not* covered by the SOQL WHERE clause (e.g. OldValue/NewValue). Conditions on SOQL-filterable
+ * fields are treated as already satisfied, since the query itself enforced them.
+ *
+ * @param record - The queried record to test.
+ * @param node - The filter tree (or subtree) to evaluate.
+ * @param parentFieldName - The history object's real parent lookup field, substituted for the
+ * `'ParentId'` placeholder.
+ * @param soqlFilterableFields - Fields already enforced by the SOQL WHERE clause; conditions on
+ * these fields are treated as satisfied without re-checking.
+ * @returns Whether `record` satisfies the non-SOQL-filterable parts of `node`.
+ */
+export function recordMatchesClientFilters(record, node, parentFieldName, soqlFilterableFields) {
+    if (!node || node.filters.length === 0) {
+        return true;
+    }
+    const matches = (filter) => {
+        if (isFilterGroup(filter)) {
+            return recordMatchesClientFilters(record, filter, parentFieldName, soqlFilterableFields);
+        }
+        const field = resolveFieldName(filter.field, parentFieldName);
+        if (soqlFilterableFields.has(field)) {
+            return true;
+        }
+        return compareValues(record[field], filter.value, filter.operator);
+    };
+    return node.logic === 'AND' ? node.filters.every(matches) : node.filters.some(matches);
+}
+//# sourceMappingURL=fieldHistory.js.map

package/lib/fieldHistory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldHistory.js","sourceRoot":"","sources":["../src/fieldHistory.ts"],"names":[],"mappings":"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"}

package/lib/fieldHistorySchemaReportTemplate.d.ts

@@ -0,0 +1,26 @@
+/** A single field-history-tracked field, as rendered in the report. */
+export type FieldHistorySchemaEntry = {
+    objectName: string;
+    objectApiName: string;
+    fieldName: string;
+    fieldApiName: string;
+    managedPackageNamespace: string;
+    packageName: string;
+};
+/** Tracked fields, grouped by owning package (namespace/subscriber package name, or `'Local (Unpackaged)'`). */
+export type GroupedFieldHistorySchemaData = Map<string, FieldHistorySchemaEntry[]>;
+/**
+ * Render a complete, self-contained HTML report of field-history-tracked objects/fields, grouped
+ * by owning package, with each package section collapsible and a client-side search box for
+ * filtering objects/fields across all packages.
+ *
+ * @param options.username - The org username the report was generated against.
+ * @param options.reportDate - The report generation date/time, displayed as-is.
+ * @param options.groupedData - The tracked fields to render, grouped by package.
+ * @returns The rendered HTML document.
+ */
+export declare function buildFieldHistorySchemaReportHtml(options: {
+    username: string;
+    reportDate: string;
+    groupedData: GroupedFieldHistorySchemaData;
+}): string;

package/lib/fieldHistorySchemaReportTemplate.js

@@ -0,0 +1,108 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { BADGE_CSS, COLLAPSIBLE_SECTION_CSS, createReportHandlebars, renderReportPage } from '@simplysf/simply-report';
+const handlebars = createReportHandlebars();
+const fieldRowSource = `
+<tr class="field-row">
+  <td><strong>{{objectName}}</strong><br><small>{{objectApiName}}</small></td>
+  <td><strong>{{fieldName}}</strong><br><small>{{fieldApiName}}</small></td>
+  <td>
+    {{#unless (eq managedPackageNamespace "N/A")}}<span class="badge badge-ns">{{managedPackageNamespace}}</span>{{/unless}}
+    <span class="badge">{{packageName}}</span>
+  </td>
+</tr>`;
+const packageSectionSource = `
+<div class="package-section" data-package="{{name}}">
+  <h2>Package: {{name}}</h2>
+  <details>
+    <summary>Tracked Fields ({{fields.length}})</summary>
+    <div class="content">
+      <table>
+        <thead><tr><th>Object</th><th>Field</th><th>Details</th></tr></thead>
+        <tbody>{{#each fields}}{{> fieldRow}}{{/each}}</tbody>
+      </table>
+    </div>
+  </details>
+</div>`;
+const reportSource = renderReportPage({
+    title: 'Field History Tracking Report',
+    css: [
+        COLLAPSIBLE_SECTION_CSS,
+        '  table { width: 100%; border-collapse: collapse; margin-top: 10px; font-size: 0.9em; }',
+        '  th, td { border: 1px solid #ddd; padding: 10px; text-align: left; }',
+        '  th { background-color: #f8f9fa; position: sticky; top: 0; }',
+        '  tr:hover { background-color: #f5f5f5; }',
+        BADGE_CSS,
+        '  .badge-ns { background-color: #3498db; }',
+        '  .search-container { margin-bottom: 20px; position: sticky; top: 10px; z-index: 100; }',
+        '  input[type="text"] { padding: 12px; width: 100%; max-width: 400px; border: 2px solid #3498db; border-radius: 6px; box-shadow: 0 2px 4px rgba(0,0,0,0.1); }',
+    ].join('\n'),
+    body: `  <h1>Field History Tracking Report</h1>
+  <p>Org: <strong>{{username}}</strong> | Tracked Fields: {{fieldCount}} | Generated: {{reportDate}}</p>
+  <div class="search-container">
+    <input type="text" id="searchInput" onkeyup="filterFields()" placeholder="Search objects or fields across all packages...">
+  </div>
+  {{#each packages}}{{> packageSection}}{{/each}}`,
+    script: `    function filterFields() {
+      const input = document.getElementById("searchInput");
+      const filter = input.value.toUpperCase();
+      const sections = document.querySelectorAll(".package-section");
+      sections.forEach(section => {
+        let sectionHasVisibleRows = false;
+        const rows = section.querySelectorAll(".field-row");
+        const details = section.querySelector("details");
+
+        rows.forEach(row => {
+          const text = row.textContent || row.innerText;
+          if (text.toUpperCase().indexOf(filter) > -1) {
+            row.style.display = "";
+            sectionHasVisibleRows = true;
+          } else {
+            row.style.display = "none";
+          }
+        });
+
+        section.style.display = sectionHasVisibleRows ? "" : "none";
+        if (filter && sectionHasVisibleRows) {
+          details.open = true;
+        } else if (!filter) {
+          details.open = false;
+        }
+      });
+    }`,
+});
+handlebars.registerPartial('fieldRow', fieldRowSource);
+handlebars.registerPartial('packageSection', packageSectionSource);
+const renderReport = handlebars.compile(reportSource);
+/**
+ * Render a complete, self-contained HTML report of field-history-tracked objects/fields, grouped
+ * by owning package, with each package section collapsible and a client-side search box for
+ * filtering objects/fields across all packages.
+ *
+ * @param options.username - The org username the report was generated against.
+ * @param options.reportDate - The report generation date/time, displayed as-is.
+ * @param options.groupedData - The tracked fields to render, grouped by package.
+ * @returns The rendered HTML document.
+ */
+export function buildFieldHistorySchemaReportHtml(options) {
+    const { username, reportDate, groupedData } = options;
+    const packages = [...groupedData.keys()]
+        .sort()
+        .map((name) => ({ name, fields: groupedData.get(name) ?? [] }));
+    const fieldCount = packages.reduce((sum, pkg) => sum + pkg.fields.length, 0);
+    return renderReport({ username, reportDate, fieldCount, packages });
+}
+//# sourceMappingURL=fieldHistorySchemaReportTemplate.js.map

package/lib/fieldHistorySchemaReportTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldHistorySchemaReportTemplate.js","sourceRoot":"","sources":["../src/fieldHistorySchemaReportTemplate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAevH,MAAM,UAAU,GAAG,sBAAsB,EAAE,CAAC;AAE5C,MAAM,cAAc,GAAG;;;;;;;;MAQjB,CAAC;AAEP,MAAM,oBAAoB,GAAG;;;;;;;;;;;;OAYtB,CAAC;AAER,MAAM,YAAY,GAAG,gBAAgB,CAAC;IACpC,KAAK,EAAE,+BAA+B;IACtC,GAAG,EAAE;QACH,uBAAuB;QACvB,yFAAyF;QACzF,uEAAuE;QACvE,+DAA+D;QAC/D,2CAA2C;QAC3C,SAAS;QACT,4CAA4C;QAC5C,yFAAyF;QACzF,8JAA8J;KAC/J,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,IAAI,EAAE;;;;;kDAK0C;IAChD,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;MA0BJ;CACL,CAAC,CAAC;AAEH,UAAU,CAAC,eAAe,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;AACvD,UAAU,CAAC,eAAe,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,CAAC;AAEnE,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AAQtD;;;;;;;;;GASG;AACH,MAAM,UAAU,iCAAiC,CAAC,OAIjD;IACC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEtD,MAAM,QAAQ,GAAqB,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;SACvD,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IAElE,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAE7E,OAAO,YAAY,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,4 @@
+export { getHistoryObjectName, getParentIdField, buildWhereClause, recordMatchesClientFilters, } from './fieldHistory.js';
+export { buildFieldHistorySchemaReportHtml, type FieldHistorySchemaEntry, type GroupedFieldHistorySchemaData, } from './fieldHistorySchemaReportTemplate.js';
+export { discoverRelationshipFields } from './relationshipFields.js';
+export { FilterConditionSchema, FilterGroupSchema, FilterConfigSchema, type FilterCondition, type FilterGroup, type FilterConfig, } from './schemas/history/filterConfig.js';

package/lib/index.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Everything exported from this file is this package's public API and is semver-covered: adding an
+// export is a minor/patch change, but removing or renaming one is breaking. `test/index.test.ts`
+// pins the exported-key list down so an accidental removal fails a test instead of silently shipping
+// in a patch release. See docs/design/0029-simply-sobject-core.md for why this package is split out
+// from `@simplysf/simply-sobject` (the CLI) rather than being one more relative import inside it.
+export { getHistoryObjectName, getParentIdField, buildWhereClause, recordMatchesClientFilters, } from './fieldHistory.js';
+export { buildFieldHistorySchemaReportHtml, } from './fieldHistorySchemaReportTemplate.js';
+export { discoverRelationshipFields } from './relationshipFields.js';
+export { FilterConditionSchema, FilterGroupSchema, FilterConfigSchema, } from './schemas/history/filterConfig.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,mGAAmG;AACnG,iGAAiG;AACjG,qGAAqG;AACrG,oGAAoG;AACpG,kGAAkG;AAElG,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iCAAiC,GAGlC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,GAInB,MAAM,mCAAmC,CAAC"}

package/lib/relationshipFields.d.ts

@@ -0,0 +1,18 @@
+import type { Connection } from '@salesforce/core';
+type SObjectField = Awaited<ReturnType<Connection['describe']>>['fields'][number];
+/**
+ * Given an SObject's describe fields, discover the identifying fields of every parent it
+ * references through a single-target lookup or master-detail relationship, and return them as
+ * dot-notation relationship paths ready to add to a SOQL field list (e.g. `RecordTypeId` ->
+ * `RecordType.Name`, `RecordType.DeveloperName`).
+ *
+ * Describe calls for each distinct target object are deduplicated and fetched concurrently;
+ * `Connection#describe` already memoizes per-instance, so repeat calls for the same object name
+ * (including calls made elsewhere on the same connection) are cheap.
+ *
+ * @param connection - The org connection to describe relationship targets with.
+ * @param fields - The describe fields of the SObject being backed up.
+ * @returns Dot-notation relationship field paths, in no particular order.
+ */
+export declare function discoverRelationshipFields(connection: Connection, fields: SObjectField[]): Promise<string[]>;
+export {};

package/lib/relationshipFields.js

@@ -0,0 +1,64 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @param field - A field from an SObject describe result.
+ * @returns Whether `field` is a single-target lookup/master-detail field that can be safely
+ * expanded into a dot-notation relationship path. Polymorphic references (e.g. `OwnerId`, which
+ * can point at `User` or `Group`) are excluded, since a single dotted path can't reliably select
+ * fields across more than one possible target type.
+ */
+function isExpandableReferenceField(field) {
+    return field.type === 'reference' && Boolean(field.relationshipName) && field.referenceTo?.length === 1;
+}
+/**
+ * @param targetDescribe - The describe result of a relationship field's target SObject.
+ * @returns The target object's identifying field names: whichever field is flagged as its name
+ * field (e.g. `Name`), plus `DeveloperName` when present. For `RecordType`, this yields `Name`
+ * and `DeveloperName`; for most other objects, just `Name`.
+ */
+function identifyingFieldNames(targetDescribe) {
+    return targetDescribe.fields
+        .filter((field) => field.nameField || field.name === 'DeveloperName')
+        .map((field) => field.name);
+}
+/**
+ * Given an SObject's describe fields, discover the identifying fields of every parent it
+ * references through a single-target lookup or master-detail relationship, and return them as
+ * dot-notation relationship paths ready to add to a SOQL field list (e.g. `RecordTypeId` ->
+ * `RecordType.Name`, `RecordType.DeveloperName`).
+ *
+ * Describe calls for each distinct target object are deduplicated and fetched concurrently;
+ * `Connection#describe` already memoizes per-instance, so repeat calls for the same object name
+ * (including calls made elsewhere on the same connection) are cheap.
+ *
+ * @param connection - The org connection to describe relationship targets with.
+ * @param fields - The describe fields of the SObject being backed up.
+ * @returns Dot-notation relationship field paths, in no particular order.
+ */
+export async function discoverRelationshipFields(connection, fields) {
+    const referenceFields = fields.filter(isExpandableReferenceField);
+    const targetObjectNames = [...new Set(referenceFields.map((field) => field.referenceTo[0]))];
+    const targetDescribes = await Promise.all(targetObjectNames.map(async (objectName) => [objectName, await connection.describe(objectName)]));
+    const describeByObjectName = new Map(targetDescribes);
+    return referenceFields.flatMap((field) => {
+        const targetDescribe = describeByObjectName.get(field.referenceTo[0]);
+        if (!targetDescribe) {
+            return [];
+        }
+        return identifyingFieldNames(targetDescribe).map((fieldName) => `${field.relationshipName}.${fieldName}`);
+    });
+}
+//# sourceMappingURL=relationshipFields.js.map

package/lib/relationshipFields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationshipFields.js","sourceRoot":"","sources":["../src/relationshipFields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH;;;;;;GAMG;AACH,SAAS,0BAA0B,CAAC,KAAmB;IACrD,OAAO,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,MAAM,KAAK,CAAC,CAAC;AAC1G,CAAC;AAED;;;;;GAKG;AACH,SAAS,qBAAqB,CAAC,cAA2D;IACxF,OAAO,cAAc,CAAC,MAAM;SACzB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC;SACpE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,UAAsB,EAAE,MAAsB;IAC7F,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAElE,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9F,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,GAAG,CACvC,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,MAAM,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAU,CAAC,CAC1G,CAAC;IACF,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;IAEtD,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACvC,MAAM,cAAc,GAAG,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,WAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QAEvE,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,qBAAqB,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,gBAAiB,IAAI,SAAS,EAAE,CAAC,CAAC;IAC7G,CAAC,CAAC,CAAC;AACL,CAAC"}

package/lib/schemas/history/filterConfig.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+/** A single leaf filter condition: `field <operator> value`. */
+export declare const FilterConditionSchema: z.ZodObject<{
+    field: z.ZodString;
+    operator: z.ZodEnum<{
+        "=": "=";
+        "!=": "!=";
+        ">": ">";
+        "<": "<";
+        ">=": ">=";
+        "<=": "<=";
+        IN: "IN";
+        "NOT IN": "NOT IN";
+        LIKE: "LIKE";
+    }>;
+    value: z.ZodUnknown;
+}, z.core.$strip>;
+/** A parsed, validated filter condition. */
+export type FilterCondition = z.infer<typeof FilterConditionSchema>;
+/** A group of filter conditions (and/or nested groups) combined with `AND`/`OR` logic. */
+export type FilterGroup = {
+    logic: 'AND' | 'OR';
+    filters: Array<FilterCondition | FilterGroup>;
+};
+export declare const FilterGroupSchema: z.ZodType<FilterGroup>;
+/** The top-level shape of the JSON config file consumed by `simply sobject history` commands' `--filter`. */
+export type FilterConfig = FilterGroup;
+/** Schema for {@link FilterConfig}. */
+export declare const FilterConfigSchema: z.ZodType<FilterGroup, unknown, z.core.$ZodTypeInternals<FilterGroup, unknown>>;

package/lib/schemas/history/filterConfig.js

@@ -0,0 +1,32 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { z } from 'zod';
+/** A single leaf filter condition: `field <operator> value`. */
+export const FilterConditionSchema = z.object({
+    field: z.string(),
+    operator: z.enum(['=', '!=', '>', '<', '>=', '<=', 'IN', 'NOT IN', 'LIKE']),
+    value: z.unknown(),
+});
+// Filter groups nest arbitrarily (a group's `filters` array can itself contain groups), so the
+// schema has to reference itself. z.lazy() defers evaluation of the inner schema until it's
+// actually used, which is what makes the self-reference possible.
+export const FilterGroupSchema = z.lazy(() => z.object({
+    logic: z.enum(['AND', 'OR', 'and', 'or']).transform((value) => value.toUpperCase()),
+    filters: z.array(z.union([FilterConditionSchema, FilterGroupSchema])),
+}));
+/** Schema for {@link FilterConfig}. */
+export const FilterConfigSchema = FilterGroupSchema;
+//# sourceMappingURL=filterConfig.js.map

package/lib/schemas/history/filterConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterConfig.js","sourceRoot":"","sources":["../../../src/schemas/history/filterConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gEAAgE;AAChE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3E,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;CACnB,CAAC,CAAC;AAWH,+FAA+F;AAC/F,4FAA4F;AAC5F,kEAAkE;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAA2B,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CACnE,CAAC,CAAC,MAAM,CAAC;IACP,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAkB,CAAC;IACnG,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,CAAC,CAAC;CACtE,CAAC,CACH,CAAC;AAKF,uCAAuC;AACvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC"}

package/package.json

@@ -0,0 +1,134 @@
+{
+  "name": "@simplysf/simply-sobject-core",
+  "description": "Field history object derivation/filtering and relationship-field discovery — the library layer behind @simplysf/simply-sobject, published separately for direct consumption (e.g. editor tooling, CI scripts) without the CLI framework",
+  "version": "0.2.0",
+  "author": "@ClayChipps",
+  "homepage": "https://github.com/SimplySF/simply-node",
+  "bugs": "https://github.com/SimplySF/simply-node/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SimplySF/simply-node",
+    "directory": "packages/simply-sobject-core"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "files": [
+    "/lib"
+  ],
+  "keywords": [
+    "force",
+    "salesforce",
+    "sfdx",
+    "salesforcedx",
+    "sfdx-plugin",
+    "sf-plugin",
+    "sf",
+    "sobject"
+  ],
+  "license": "Apache-2.0",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    }
+  },
+  "type": "module",
+  "dependencies": {
+    "@salesforce/core": "^8.30.0",
+    "@simplysf/simply-report": "workspace:^1.0.4",
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.10",
+    "vitest": "^4.1.10"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "wireit",
+    "compile": "wireit",
+    "fix-license": "eslint src test --fix --rule \"header/header: [2]\"",
+    "format": "wireit",
+    "lint": "wireit",
+    "test": "wireit",
+    "test:coverage": "vitest run --coverage --project simply-sobject-core",
+    "test:only": "wireit",
+    "test:watch": "vitest watch --project simply-sobject-core"
+  },
+  "wireit": {
+    "build": {
+      "dependencies": [
+        "compile",
+        "lint"
+      ]
+    },
+    "compile": {
+      "command": "tsc -p . --pretty --incremental",
+      "files": [
+        "src/**/*.ts",
+        "**/tsconfig.json",
+        "../../tsconfig.json"
+      ],
+      "output": [
+        "lib/**",
+        "*.tsbuildinfo"
+      ],
+      "clean": "if-file-deleted"
+    },
+    "format": {
+      "command": "prettier --write \"+(src|test)/**/*.+(ts|js|json)\"",
+      "files": [
+        "src/**/*.ts",
+        "test/**/*.ts",
+        ".prettier*"
+      ],
+      "output": []
+    },
+    "lint": {
+      "command": "eslint src test --color --cache --cache-location .eslintcache",
+      "files": [
+        "src/**/*.ts",
+        "test/**/*.ts",
+        "**/.eslint*",
+        "**/tsconfig.json",
+        "../../eslint.config.mjs",
+        "../../tsconfig.json"
+      ],
+      "output": []
+    },
+    "test": {
+      "dependencies": [
+        "test:compile",
+        "test:only",
+        "lint"
+      ]
+    },
+    "test:compile": {
+      "command": "tsc -p \"./test\" --pretty",
+      "files": [
+        "test/**/*.ts",
+        "**/tsconfig.json",
+        "../../tsconfig.json"
+      ],
+      "output": []
+    },
+    "test:only": {
+      "command": "vitest run --project simply-sobject-core",
+      "env": {
+        "FORCE_COLOR": "2"
+      },
+      "files": [
+        "test/**/*.ts",
+        "src/**/*.ts",
+        "**/tsconfig.json",
+        "../../tsconfig.json",
+        "vitest.config.ts"
+      ],
+      "output": []
+    }
+  }
+}