@party-stack/salesforce-ontology 0.4.0 → 0.4.2

package/README.md

@@ -10,27 +10,23 @@ import {
     createSalesforceOntologyRoute,
 } from "@party-stack/salesforce-ontology";
 
-const installation =
-    await createSalesforceBackendInstallation({
-        instanceUrl:
-            "https://example.my.salesforce.com",
-        apiVersion: "65.0",
-        runtime,
-        connections: {
-            oauth: {
-                clientId,
-                redirectUrl:
-                    "http://localhost:1717/oauth/callback",
-            },
+const installation = await createSalesforceBackendInstallation({
+    instanceUrl: "https://example.my.salesforce.com",
+    apiVersion: "65.0",
+    runtime,
+    connections: {
+        oauth: {
+            clientId,
+            redirectUrl: "http://localhost:1717/oauth/callback",
         },
-        routes: [
-            createSalesforceOntologyRoute({
-                ontologyId:
-                    "salesforce:task-manager",
-                ir: generatedOntology,
-            }),
-        ],
-    });
+    },
+    routes: [
+        createSalesforceOntologyRoute({
+            ontologyId: "salesforce:task-manager",
+            ir: generatedOntology,
+        }),
+    ],
+});
 ```
 
 The connection adapter uses `@party-stack/oauth`, persists refresh tokens
@@ -43,9 +39,7 @@ token-provider/egress agnostic.
 Consumer projects can export a standard Party Stack pull configuration:
 
 ```ts
-import {
-    createSalesforceOntologyPullConfig,
-} from "@party-stack/salesforce-ontology/config";
+import { createSalesforceOntologyPullConfig } from "@party-stack/salesforce-ontology/config";
 
 export default createSalesforceOntologyPullConfig({
     instanceUrl,
@@ -53,12 +47,8 @@ export default createSalesforceOntologyPullConfig({
     ontologyId: "salesforce:task-manager",
     objectTypeNames: ["Task", "User"],
     flowActionTypeNames: ["Create_Task_Flow"],
-    standardActionTypeNames: [
-        "confirmSalesMeeting",
-    ],
-    standardQueryFunctionTypeNames: [
-        "getAvailableMeetingTimes",
-    ],
+    standardActionTypeNames: ["confirmSalesMeeting"],
+    standardQueryFunctionTypeNames: ["getAvailableMeetingTimes"],
     crudActionTypes: [
         {
             objectType: "Task",
@@ -79,6 +69,7 @@ normal `src/ontology/ontology.ts` consumed by
 `createSalesforceOntologyRoute({ ir })`.
 
 See `apps/salesforce-task-manager` for a real-org example.
+
 # salesforce-ontology
 
 Salesforce backend adapters for Party Stack LiveOntology.
@@ -86,9 +77,9 @@ Salesforce backend adapters for Party Stack LiveOntology.
 ## Runtime adapter
 
 ```ts
+import { createLiveOntology } from "@party-stack/ontology";
 import { createSalesforceClient } from "@party-stack/salesforce-client";
 import { createSalesforceOntologyBackend } from "@party-stack/salesforce-ontology";
-import { createLiveOntology } from "@party-stack/ontology";
 
 // jsforce-backed client; supply your own token (no OAuth ownership here)
 const client = createSalesforceClient({
@@ -106,8 +97,8 @@ const ontology = await createLiveOntology({
 ## Metadata adapter
 
 ```ts
-import { createSalesforceMetaOntologyBackendAdapter } from "@party-stack/salesforce-ontology/meta";
 import { createMetaLiveOntology } from "@party-stack/ontology";
+import { createSalesforceMetaOntologyBackendAdapter } from "@party-stack/salesforce-ontology/meta";
 
 const meta = await createMetaLiveOntology({
     backend: () =>

package/lib/actionMetadata.d.ts

@@ -1,17 +1,19 @@
-import type { SalesforceCrudOperation } from "./utils/ids.js";
+import { SalesforceCrudOperation } from "./utils/ids.js";
+//#region src/actionMetadata.d.ts
 export type SalesforceActionMetadata = {
-    kind: "flow";
-    apiName: string;
+  kind: "flow";
+  apiName: string;
 } | {
-    kind: "standard";
-    apiName: string;
+  kind: "standard";
+  apiName: string;
 } | {
-    kind: "crud";
-    objectType: string;
-    operation: SalesforceCrudOperation;
+  kind: "crud";
+  objectType: string;
+  operation: SalesforceCrudOperation;
 };
 export declare function salesforceActionMeta(metadata: SalesforceActionMetadata): Record<string, unknown>;
 export declare function getSalesforceActionMetadata(actionType: {
-    meta?: Record<string, unknown>;
+  meta?: Record<string, unknown>;
 }): SalesforceActionMetadata | undefined;
+//#endregion
 //# sourceMappingURL=actionMetadata.d.ts.map

package/lib/actionMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actionMetadata.d.ts","sourceRoot":"","sources":["../src/actionMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAE9D,MAAM,MAAM,wBAAwB,GAC9B;IACI,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB,GACD;IACI,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACnB,GACD;IACI,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,uBAAuB,CAAC;CACtC,CAAC;AAER,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,wBAAwB,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GAAG,wBAAwB,GAAG,SAAS,CAkCvC"}
+{"version":3,"file":"actionMetadata.d.ts","names":[],"sources":["../src/actionMetadata.ts"],"mappings":";;YAEY;EAEF;EACA;;EAGA;EACA;;EAGA;EACA;EACA,WAAW;;wBAGL,qBAAqB,UAAU,2BAA2B;wBAI1D,4BAA4B;EACxC,OAAO;IACP"}

package/lib/actionMetadata.js

@@ -1,33 +1,22 @@
-export function salesforceActionMeta(metadata) {
-    return { salesforce: metadata };
+//#region src/actionMetadata.ts
+function salesforceActionMeta(metadata) {
+	return { salesforce: metadata };
 }
-export function getSalesforceActionMetadata(actionType) {
-    const value = actionType.meta?.salesforce;
-    if (typeof value !== "object" ||
-        value === null ||
-        Array.isArray(value)) {
-        return undefined;
-    }
-    const metadata = value;
-    if ((metadata.kind === "flow" ||
-        metadata.kind === "standard") &&
-        typeof metadata.apiName === "string") {
-        return {
-            kind: metadata.kind,
-            apiName: metadata.apiName,
-        };
-    }
-    if (metadata.kind === "crud" &&
-        typeof metadata.objectType === "string" &&
-        (metadata.operation === "create" ||
-            metadata.operation === "update" ||
-            metadata.operation === "delete")) {
-        return {
-            kind: "crud",
-            objectType: metadata.objectType,
-            operation: metadata.operation,
-        };
-    }
-    return undefined;
+function getSalesforceActionMetadata(actionType) {
+	const value = actionType.meta?.salesforce;
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return;
+	const metadata = value;
+	if ((metadata.kind === "flow" || metadata.kind === "standard") && typeof metadata.apiName === "string") return {
+		kind: metadata.kind,
+		apiName: metadata.apiName
+	};
+	if (metadata.kind === "crud" && typeof metadata.objectType === "string" && (metadata.operation === "create" || metadata.operation === "update" || metadata.operation === "delete")) return {
+		kind: "crud",
+		objectType: metadata.objectType,
+		operation: metadata.operation
+	};
 }
+//#endregion
+export { getSalesforceActionMetadata, salesforceActionMeta };
+
 //# sourceMappingURL=actionMetadata.js.map

package/lib/actionMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"actionMetadata.js","sourceRoot":"","sources":["../src/actionMetadata.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,oBAAoB,CAChC,QAAkC;IAElC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,UAE3C;IACG,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1C,IACI,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACtB,CAAC;QACC,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,MAAM,QAAQ,GAAG,KAAgC,CAAC;IAClD,IACI,CAAC,QAAQ,CAAC,IAAI,KAAK,MAAM;QACrB,QAAQ,CAAC,IAAI,KAAK,UAAU,CAAC;QACjC,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,EACtC,CAAC;QACC,OAAO;YACH,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;SAC5B,CAAC;IACN,CAAC;IACD,IACI,QAAQ,CAAC,IAAI,KAAK,MAAM;QACxB,OAAO,QAAQ,CAAC,UAAU,KAAK,QAAQ;QACvC,CAAC,QAAQ,CAAC,SAAS,KAAK,QAAQ;YAC5B,QAAQ,CAAC,SAAS,KAAK,QAAQ;YAC/B,QAAQ,CAAC,SAAS,KAAK,QAAQ,CAAC,EACtC,CAAC;QACC,OAAO;YACH,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,SAAS,EAAE,QAAQ,CAAC,SAAS;SAChC,CAAC;IACN,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC"}
+{"version":3,"file":"actionMetadata.js","names":[],"sources":["../src/actionMetadata.ts"],"sourcesContent":["import type { SalesforceCrudOperation } from \"./utils/ids.js\";\n\nexport type SalesforceActionMetadata =\n    | {\n          kind: \"flow\";\n          apiName: string;\n      }\n    | {\n          kind: \"standard\";\n          apiName: string;\n      }\n    | {\n          kind: \"crud\";\n          objectType: string;\n          operation: SalesforceCrudOperation;\n      };\n\nexport function salesforceActionMeta(metadata: SalesforceActionMetadata): Record<string, unknown> {\n    return { salesforce: metadata };\n}\n\nexport function getSalesforceActionMetadata(actionType: {\n    meta?: Record<string, unknown>;\n}): SalesforceActionMetadata | undefined {\n    const value = actionType.meta?.salesforce;\n    if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n        return undefined;\n    }\n    const metadata = value as Record<string, unknown>;\n    if ((metadata.kind === \"flow\" || metadata.kind === \"standard\") && typeof metadata.apiName === \"string\") {\n        return {\n            kind: metadata.kind,\n            apiName: metadata.apiName,\n        };\n    }\n    if (\n        metadata.kind === \"crud\" &&\n        typeof metadata.objectType === \"string\" &&\n        (metadata.operation === \"create\" ||\n            metadata.operation === \"update\" ||\n            metadata.operation === \"delete\")\n    ) {\n        return {\n            kind: \"crud\",\n            objectType: metadata.objectType,\n            operation: metadata.operation,\n        };\n    }\n    return undefined;\n}\n"],"mappings":";AAiBA,SAAgB,qBAAqB,UAA6D;CAC9F,OAAO,EAAE,YAAY,SAAS;AAClC;AAEA,SAAgB,4BAA4B,YAEH;CACrC,MAAM,QAAQ,WAAW,MAAM;CAC/B,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GAClE;CAEJ,MAAM,WAAW;CACjB,KAAK,SAAS,SAAS,UAAU,SAAS,SAAS,eAAe,OAAO,SAAS,YAAY,UAC1F,OAAO;EACH,MAAM,SAAS;EACf,SAAS,SAAS;CACtB;CAEJ,IACI,SAAS,SAAS,UAClB,OAAO,SAAS,eAAe,aAC9B,SAAS,cAAc,YACpB,SAAS,cAAc,YACvB,SAAS,cAAc,WAE3B,OAAO;EACH,MAAM;EACN,YAAY,SAAS;EACrB,WAAW,SAAS;CACxB;AAGR"}

package/lib/adapter/convertLoadSubsetOptions.d.ts

@@ -1,18 +1,20 @@
 import { LoadSubsetOptions } from "@tanstack/db";
+//#region src/adapter/convertLoadSubsetOptions.d.ts
 export type CompiledSoqlFilter = {
-    clause?: string;
-    alwaysFalse: boolean;
+  clause?: string;
+  alwaysFalse: boolean;
 };
 export declare function serializeSoqlLiteral(value: unknown): string;
 export declare function isAlwaysFalseFilter(filter: CompiledSoqlFilter | undefined): boolean;
 export declare function convertLoadSubsetFilter(filter: LoadSubsetOptions["where"]): CompiledSoqlFilter | undefined;
 export declare function convertLoadSubsetOrderBy(orderBy: LoadSubsetOptions["orderBy"]): string | undefined;
 export declare function buildSoqlQuery(opts: {
-    objectType: string;
-    selectedProperties: string[];
-    where?: CompiledSoqlFilter;
-    orderBy?: string;
-    limit?: number;
-    offset?: number;
+  objectType: string;
+  selectedProperties: string[];
+  where?: CompiledSoqlFilter;
+  orderBy?: string;
+  limit?: number;
+  offset?: number;
 }): string;
+//#endregion
 //# sourceMappingURL=convertLoadSubsetOptions.d.ts.map

package/lib/adapter/convertLoadSubsetOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convertLoadSubsetOptions.d.ts","sourceRoot":"","sources":["../../src/adapter/convertLoadSubsetOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,iBAAiB,EAAgD,MAAM,cAAc,CAAC;AAK1G,MAAM,MAAM,kBAAkB,GAAG;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACxB,CAAC;AAuDF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA6B3D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,GAAG,OAAO,CAEnF;AAoBD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,kBAAkB,GAAG,SAAS,CA4D1G;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAOlG;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAkBT"}
+{"version":3,"file":"convertLoadSubsetOptions.d.ts","names":[],"sources":["../../src/adapter/convertLoadSubsetOptions.ts"],"mappings":";;YAKY;EACR;EACA;;wBAwDY,qBAAqB;wBA+BrB,oBAAoB,QAAQ;wBAsB5B,wBAAwB,QAAQ,6BAA6B;wBA8D7D,yBAAyB,SAAS;wBASlC,eAAe;EAC3B;EACA;EACA,QAAQ;EACR;EACA;EACA"}

package/lib/adapter/convertLoadSubsetOptions.js

@@ -1,190 +1,127 @@
 import { parseOrderByExpression, parseWhereExpression } from "@tanstack/db";
 import { Temporal } from "temporal-polyfill";
+//#region src/adapter/convertLoadSubsetOptions.ts
 const ALWAYS_FALSE = "__ALWAYS_FALSE__";
 function quoteIdentifier(identifier) {
-    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(identifier)) {
-        throw new Error(`Invalid Salesforce identifier "${identifier}".`);
-    }
-    return identifier;
+	if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(identifier)) throw new Error(`Invalid Salesforce identifier "${identifier}".`);
+	return identifier;
 }
 function fieldPathToSoql(fieldPath) {
-    if (fieldPath.length === 0) {
-        throw new Error("Empty field path.");
-    }
-    return fieldPath.map((segment) => quoteIdentifier(String(segment))).join(".");
+	if (fieldPath.length === 0) throw new Error("Empty field path.");
+	return fieldPath.map((segment) => quoteIdentifier(String(segment))).join(".");
 }
 function escapeSoqlString(value) {
-    let escaped = "";
-    for (const character of value) {
-        switch (character) {
-            case "\\":
-                escaped += "\\\\";
-                break;
-            case "'":
-                escaped += "\\'";
-                break;
-            case "\b":
-                escaped += "\\b";
-                break;
-            case "\f":
-                escaped += "\\f";
-                break;
-            case "\n":
-                escaped += "\\n";
-                break;
-            case "\r":
-                escaped += "\\r";
-                break;
-            case "\t":
-                escaped += "\\t";
-                break;
-            default: {
-                const codePoint = character.codePointAt(0);
-                if (codePoint < 0x20 || codePoint === 0x7f) {
-                    throw new Error(`Cannot serialize control character U+${codePoint.toString(16).padStart(4, "0")} to SOQL.`);
-                }
-                escaped += character;
-            }
-        }
-    }
-    return escaped;
+	let escaped = "";
+	for (const character of value) switch (character) {
+		case "\\":
+			escaped += "\\\\";
+			break;
+		case "'":
+			escaped += "\\'";
+			break;
+		case "\b":
+			escaped += "\\b";
+			break;
+		case "\f":
+			escaped += "\\f";
+			break;
+		case "\n":
+			escaped += "\\n";
+			break;
+		case "\r":
+			escaped += "\\r";
+			break;
+		case "	":
+			escaped += "\\t";
+			break;
+		default: {
+			const codePoint = character.codePointAt(0);
+			if (codePoint < 32 || codePoint === 127) throw new Error(`Cannot serialize control character U+${codePoint.toString(16).padStart(4, "0")} to SOQL.`);
+			escaped += character;
+		}
+	}
+	return escaped;
 }
-export function serializeSoqlLiteral(value) {
-    if (value === null || value === undefined) {
-        return "null";
-    }
-    if (typeof value === "boolean") {
-        return value ? "true" : "false";
-    }
-    if (typeof value === "number") {
-        if (!Number.isFinite(value)) {
-            throw new Error(`Cannot serialize non-finite number ${value} to SOQL.`);
-        }
-        return String(value);
-    }
-    if (typeof value === "bigint") {
-        return String(value);
-    }
-    if (value instanceof Date) {
-        return value.toISOString();
-    }
-    if (value instanceof Temporal.Instant) {
-        return value.toString();
-    }
-    if (value instanceof Temporal.PlainDate || value instanceof Temporal.PlainDateTime) {
-        return value.toString();
-    }
-    if (typeof value === "string") {
-        return `'${escapeSoqlString(value)}'`;
-    }
-    throw new Error(`Unsupported SOQL literal type: ${typeof value}`);
+function serializeSoqlLiteral(value) {
+	if (value === null || value === void 0) return "null";
+	if (typeof value === "boolean") return value ? "true" : "false";
+	if (typeof value === "number") {
+		if (!Number.isFinite(value)) throw new Error(`Cannot serialize non-finite number ${value} to SOQL.`);
+		return String(value);
+	}
+	if (typeof value === "bigint") return String(value);
+	if (value instanceof Date) return value.toISOString();
+	if (value instanceof Temporal.Instant) return value.toString();
+	if (value instanceof Temporal.PlainDate || value instanceof Temporal.PlainDateTime) return value.toString();
+	if (typeof value === "string") return `'${escapeSoqlString(value)}'`;
+	throw new Error(`Unsupported SOQL literal type: ${typeof value}`);
 }
-export function isAlwaysFalseFilter(filter) {
-    return Boolean(filter?.alwaysFalse);
+function isAlwaysFalseFilter(filter) {
+	return Boolean(filter?.alwaysFalse);
 }
 function convertInFilter(fieldOrValue, valuesOrField) {
-    if (!Array.isArray(valuesOrField)) {
-        throw new Error("Expected the second inArray argument to be an array or field path");
-    }
-    if (!Array.isArray(fieldOrValue)) {
-        return fieldOrValue == null
-            ? ALWAYS_FALSE
-            : `${fieldPathToSoql(valuesOrField)} INCLUDES (${serializeSoqlLiteral(fieldOrValue)})`;
-    }
-    const literals = valuesOrField
-        .filter((entry) => entry !== null && entry !== undefined)
-        .map(serializeSoqlLiteral);
-    if (literals.length === 0)
-        return ALWAYS_FALSE;
-    return `${fieldPathToSoql(fieldOrValue)} IN (${literals.join(", ")})`;
+	if (!Array.isArray(valuesOrField)) throw new Error("Expected the second inArray argument to be an array or field path");
+	if (!Array.isArray(fieldOrValue)) return fieldOrValue == null ? ALWAYS_FALSE : `${fieldPathToSoql(valuesOrField)} INCLUDES (${serializeSoqlLiteral(fieldOrValue)})`;
+	const literals = valuesOrField.filter((entry) => entry !== null && entry !== void 0).map(serializeSoqlLiteral);
+	if (literals.length === 0) return ALWAYS_FALSE;
+	return `${fieldPathToSoql(fieldOrValue)} IN (${literals.join(", ")})`;
 }
-export function convertLoadSubsetFilter(filter) {
-    if (!filter)
-        return undefined;
-    const compiled = parseWhereExpression(filter, {
-        handlers: {
-            and: (...filters) => {
-                if (filters.includes(ALWAYS_FALSE))
-                    return ALWAYS_FALSE;
-                const clauses = filters.filter((clause) => clause.length > 0);
-                if (clauses.length === 0)
-                    return "";
-                if (clauses.length === 1)
-                    return clauses[0];
-                return `(${clauses.join(" AND ")})`;
-            },
-            or: (...filters) => {
-                if (filters.every((clause) => clause === ALWAYS_FALSE))
-                    return ALWAYS_FALSE;
-                const clauses = filters.filter((clause) => clause !== ALWAYS_FALSE && clause.length > 0);
-                if (clauses.length === 0)
-                    return "";
-                if (clauses.length === 1)
-                    return clauses[0];
-                return `(${clauses.join(" OR ")})`;
-            },
-            not: (inner) => {
-                if (inner === ALWAYS_FALSE)
-                    return "";
-                if (!inner)
-                    return ALWAYS_FALSE;
-                return `(NOT ${inner})`;
-            },
-            eq: (field, value) => value == null
-                ? `${fieldPathToSoql(field)} = null`
-                : `${fieldPathToSoql(field)} = ${serializeSoqlLiteral(value)}`,
-            gt: (field, value) => value == null
-                ? ALWAYS_FALSE
-                : `${fieldPathToSoql(field)} > ${serializeSoqlLiteral(value)}`,
-            gte: (field, value) => value == null
-                ? ALWAYS_FALSE
-                : `${fieldPathToSoql(field)} >= ${serializeSoqlLiteral(value)}`,
-            lt: (field, value) => value == null
-                ? ALWAYS_FALSE
-                : `${fieldPathToSoql(field)} < ${serializeSoqlLiteral(value)}`,
-            lte: (field, value) => value == null
-                ? ALWAYS_FALSE
-                : `${fieldPathToSoql(field)} <= ${serializeSoqlLiteral(value)}`,
-            isUndefined: (field) => `${fieldPathToSoql(field)} = null`,
-            in: convertInFilter,
-            like: (field, value) => value === "%" ? "" : `${fieldPathToSoql(field)} LIKE ${serializeSoqlLiteral(value)}`,
-            ilike: (field, value) => 
-            // Salesforce LIKE is case-insensitive for most text fields.
-            value === "%" ? "" : `${fieldPathToSoql(field)} LIKE ${serializeSoqlLiteral(value)}`,
-        },
-    }) ?? undefined;
-    if (compiled === undefined)
-        return undefined;
-    if (compiled === ALWAYS_FALSE) {
-        return { alwaysFalse: true };
-    }
-    return { clause: compiled || undefined, alwaysFalse: false };
+function convertLoadSubsetFilter(filter) {
+	if (!filter) return void 0;
+	const compiled = parseWhereExpression(filter, { handlers: {
+		and: (...filters) => {
+			if (filters.includes(ALWAYS_FALSE)) return ALWAYS_FALSE;
+			const clauses = filters.filter((clause) => clause.length > 0);
+			if (clauses.length === 0) return "";
+			if (clauses.length === 1) return clauses[0];
+			return `(${clauses.join(" AND ")})`;
+		},
+		or: (...filters) => {
+			if (filters.every((clause) => clause === ALWAYS_FALSE)) return ALWAYS_FALSE;
+			const clauses = filters.filter((clause) => clause !== ALWAYS_FALSE && clause.length > 0);
+			if (clauses.length === 0) return "";
+			if (clauses.length === 1) return clauses[0];
+			return `(${clauses.join(" OR ")})`;
+		},
+		not: (inner) => {
+			if (inner === ALWAYS_FALSE) return "";
+			if (!inner) return ALWAYS_FALSE;
+			return `(NOT ${inner})`;
+		},
+		eq: (field, value) => value == null ? `${fieldPathToSoql(field)} = null` : `${fieldPathToSoql(field)} = ${serializeSoqlLiteral(value)}`,
+		gt: (field, value) => value == null ? ALWAYS_FALSE : `${fieldPathToSoql(field)} > ${serializeSoqlLiteral(value)}`,
+		gte: (field, value) => value == null ? ALWAYS_FALSE : `${fieldPathToSoql(field)} >= ${serializeSoqlLiteral(value)}`,
+		lt: (field, value) => value == null ? ALWAYS_FALSE : `${fieldPathToSoql(field)} < ${serializeSoqlLiteral(value)}`,
+		lte: (field, value) => value == null ? ALWAYS_FALSE : `${fieldPathToSoql(field)} <= ${serializeSoqlLiteral(value)}`,
+		isUndefined: (field) => `${fieldPathToSoql(field)} = null`,
+		in: convertInFilter,
+		like: (field, value) => value === "%" ? "" : `${fieldPathToSoql(field)} LIKE ${serializeSoqlLiteral(value)}`,
+		ilike: (field, value) => value === "%" ? "" : `${fieldPathToSoql(field)} LIKE ${serializeSoqlLiteral(value)}`
+	} }) ?? void 0;
+	if (compiled === void 0) return void 0;
+	if (compiled === ALWAYS_FALSE) return { alwaysFalse: true };
+	return {
+		clause: compiled || void 0,
+		alwaysFalse: false
+	};
 }
-export function convertLoadSubsetOrderBy(orderBy) {
-    if (!orderBy)
-        return undefined;
-    const fields = parseOrderByExpression(orderBy).map((ordering) => {
-        const field = fieldPathToSoql(ordering.field);
-        return `${field} ${ordering.direction.toUpperCase()}`;
-    });
-    return fields.length > 0 ? fields.join(", ") : undefined;
+function convertLoadSubsetOrderBy(orderBy) {
+	if (!orderBy) return void 0;
+	const fields = parseOrderByExpression(orderBy).map((ordering) => {
+		return `${fieldPathToSoql(ordering.field)} ${ordering.direction.toUpperCase()}`;
+	});
+	return fields.length > 0 ? fields.join(", ") : void 0;
 }
-export function buildSoqlQuery(opts) {
-    const objectType = quoteIdentifier(opts.objectType);
-    const select = opts.selectedProperties.map(quoteIdentifier).join(", ");
-    const clauses = [`SELECT ${select} FROM ${objectType}`];
-    if (opts.where?.clause) {
-        clauses.push(`WHERE ${opts.where.clause}`);
-    }
-    if (opts.orderBy) {
-        clauses.push(`ORDER BY ${opts.orderBy}`);
-    }
-    if (opts.limit !== undefined) {
-        clauses.push(`LIMIT ${Math.max(0, Math.trunc(opts.limit))}`);
-    }
-    if (opts.offset !== undefined && opts.offset > 0) {
-        clauses.push(`OFFSET ${Math.max(0, Math.trunc(opts.offset))}`);
-    }
-    return clauses.join(" ");
+function buildSoqlQuery(opts) {
+	const objectType = quoteIdentifier(opts.objectType);
+	const clauses = [`SELECT ${opts.selectedProperties.map(quoteIdentifier).join(", ")} FROM ${objectType}`];
+	if (opts.where?.clause) clauses.push(`WHERE ${opts.where.clause}`);
+	if (opts.orderBy) clauses.push(`ORDER BY ${opts.orderBy}`);
+	if (opts.limit !== void 0) clauses.push(`LIMIT ${Math.max(0, Math.trunc(opts.limit))}`);
+	if (opts.offset !== void 0 && opts.offset > 0) clauses.push(`OFFSET ${Math.max(0, Math.trunc(opts.offset))}`);
+	return clauses.join(" ");
 }
+//#endregion
+export { buildSoqlQuery, convertLoadSubsetFilter, convertLoadSubsetOrderBy, isAlwaysFalseFilter, serializeSoqlLiteral };
+
 //# sourceMappingURL=convertLoadSubsetOptions.js.map

package/lib/adapter/convertLoadSubsetOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"convertLoadSubsetOptions.js","sourceRoot":"","sources":["../../src/adapter/convertLoadSubsetOptions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"convertLoadSubsetOptions.js","names":[],"sources":["../../src/adapter/convertLoadSubsetOptions.ts"],"sourcesContent":["import { FieldPath, LoadSubsetOptions, parseOrderByExpression, parseWhereExpression } from \"@tanstack/db\";\nimport { Temporal } from \"temporal-polyfill\";\n\nconst ALWAYS_FALSE = \"__ALWAYS_FALSE__\";\n\nexport type CompiledSoqlFilter = {\n    clause?: string;\n    alwaysFalse: boolean;\n};\n\nfunction quoteIdentifier(identifier: string): string {\n    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(identifier)) {\n        throw new Error(`Invalid Salesforce identifier \"${identifier}\".`);\n    }\n    return identifier;\n}\n\nfunction fieldPathToSoql(fieldPath: FieldPath): string {\n    if (fieldPath.length === 0) {\n        throw new Error(\"Empty field path.\");\n    }\n    return fieldPath.map((segment) => quoteIdentifier(String(segment))).join(\".\");\n}\n\nfunction escapeSoqlString(value: string): string {\n    let escaped = \"\";\n    for (const character of value) {\n        switch (character) {\n            case \"\\\\\":\n                escaped += \"\\\\\\\\\";\n                break;\n            case \"'\":\n                escaped += \"\\\\'\";\n                break;\n            case \"\\b\":\n                escaped += \"\\\\b\";\n                break;\n            case \"\\f\":\n                escaped += \"\\\\f\";\n                break;\n            case \"\\n\":\n                escaped += \"\\\\n\";\n                break;\n            case \"\\r\":\n                escaped += \"\\\\r\";\n                break;\n            case \"\\t\":\n                escaped += \"\\\\t\";\n                break;\n            default: {\n                const codePoint = character.codePointAt(0)!;\n                if (codePoint < 0x20 || codePoint === 0x7f) {\n                    throw new Error(\n                        `Cannot serialize control character U+${codePoint.toString(16).padStart(4, \"0\")} to SOQL.`\n                    );\n                }\n                escaped += character;\n            }\n        }\n    }\n    return escaped;\n}\n\nexport function serializeSoqlLiteral(value: unknown): string {\n    if (value === null || value === undefined) {\n        return \"null\";\n    }\n    if (typeof value === \"boolean\") {\n        return value ? \"true\" : \"false\";\n    }\n    if (typeof value === \"number\") {\n        if (!Number.isFinite(value)) {\n            throw new Error(`Cannot serialize non-finite number ${value} to SOQL.`);\n        }\n        return String(value);\n    }\n    if (typeof value === \"bigint\") {\n        return String(value);\n    }\n    if (value instanceof Date) {\n        return value.toISOString();\n    }\n    if (value instanceof Temporal.Instant) {\n        return value.toString();\n    }\n    if (value instanceof Temporal.PlainDate || value instanceof Temporal.PlainDateTime) {\n        return value.toString();\n    }\n    if (typeof value === \"string\") {\n        return `'${escapeSoqlString(value)}'`;\n    }\n    throw new Error(`Unsupported SOQL literal type: ${typeof value}`);\n}\n\nexport function isAlwaysFalseFilter(filter: CompiledSoqlFilter | undefined): boolean {\n    return Boolean(filter?.alwaysFalse);\n}\n\nfunction convertInFilter(fieldOrValue: unknown, valuesOrField: unknown): string {\n    if (!Array.isArray(valuesOrField)) {\n        throw new Error(\"Expected the second inArray argument to be an array or field path\");\n    }\n\n    if (!Array.isArray(fieldOrValue)) {\n        return fieldOrValue == null\n            ? ALWAYS_FALSE\n            : `${fieldPathToSoql(valuesOrField as FieldPath)} INCLUDES (${serializeSoqlLiteral(fieldOrValue)})`;\n    }\n\n    const literals = (valuesOrField as unknown[])\n        .filter((entry) => entry !== null && entry !== undefined)\n        .map(serializeSoqlLiteral);\n    if (literals.length === 0) return ALWAYS_FALSE;\n    return `${fieldPathToSoql(fieldOrValue as FieldPath)} IN (${literals.join(\", \")})`;\n}\n\nexport function convertLoadSubsetFilter(filter: LoadSubsetOptions[\"where\"]): CompiledSoqlFilter | undefined {\n    if (!filter) return undefined;\n\n    const compiled =\n        parseWhereExpression<string>(filter, {\n            handlers: {\n                and: (...filters: string[]) => {\n                    if (filters.includes(ALWAYS_FALSE)) return ALWAYS_FALSE;\n                    const clauses = filters.filter((clause) => clause.length > 0);\n                    if (clauses.length === 0) return \"\";\n                    if (clauses.length === 1) return clauses[0]!;\n                    return `(${clauses.join(\" AND \")})`;\n                },\n                or: (...filters: string[]) => {\n                    if (filters.every((clause) => clause === ALWAYS_FALSE)) return ALWAYS_FALSE;\n                    const clauses = filters.filter((clause) => clause !== ALWAYS_FALSE && clause.length > 0);\n                    if (clauses.length === 0) return \"\";\n                    if (clauses.length === 1) return clauses[0]!;\n                    return `(${clauses.join(\" OR \")})`;\n                },\n                not: (inner: string) => {\n                    if (inner === ALWAYS_FALSE) return \"\";\n                    if (!inner) return ALWAYS_FALSE;\n                    return `(NOT ${inner})`;\n                },\n                eq: (field: FieldPath, value) =>\n                    value == null\n                        ? `${fieldPathToSoql(field)} = null`\n                        : `${fieldPathToSoql(field)} = ${serializeSoqlLiteral(value)}`,\n                gt: (field: FieldPath, value) =>\n                    value == null\n                        ? ALWAYS_FALSE\n                        : `${fieldPathToSoql(field)} > ${serializeSoqlLiteral(value)}`,\n                gte: (field: FieldPath, value) =>\n                    value == null\n                        ? ALWAYS_FALSE\n                        : `${fieldPathToSoql(field)} >= ${serializeSoqlLiteral(value)}`,\n                lt: (field: FieldPath, value) =>\n                    value == null\n                        ? ALWAYS_FALSE\n                        : `${fieldPathToSoql(field)} < ${serializeSoqlLiteral(value)}`,\n                lte: (field: FieldPath, value) =>\n                    value == null\n                        ? ALWAYS_FALSE\n                        : `${fieldPathToSoql(field)} <= ${serializeSoqlLiteral(value)}`,\n                isUndefined: (field: FieldPath) => `${fieldPathToSoql(field)} = null`,\n                in: convertInFilter,\n                like: (field: FieldPath, value: string) =>\n                    value === \"%\" ? \"\" : `${fieldPathToSoql(field)} LIKE ${serializeSoqlLiteral(value)}`,\n                ilike: (field: FieldPath, value: string) =>\n                    // Salesforce LIKE is case-insensitive for most text fields.\n                    value === \"%\" ? \"\" : `${fieldPathToSoql(field)} LIKE ${serializeSoqlLiteral(value)}`,\n            },\n        }) ?? undefined;\n\n    if (compiled === undefined) return undefined;\n    if (compiled === ALWAYS_FALSE) {\n        return { alwaysFalse: true };\n    }\n    return { clause: compiled || undefined, alwaysFalse: false };\n}\n\nexport function convertLoadSubsetOrderBy(orderBy: LoadSubsetOptions[\"orderBy\"]): string | undefined {\n    if (!orderBy) return undefined;\n    const fields = parseOrderByExpression(orderBy).map((ordering) => {\n        const field = fieldPathToSoql(ordering.field);\n        return `${field} ${ordering.direction.toUpperCase()}`;\n    });\n    return fields.length > 0 ? fields.join(\", \") : undefined;\n}\n\nexport function buildSoqlQuery(opts: {\n    objectType: string;\n    selectedProperties: string[];\n    where?: CompiledSoqlFilter;\n    orderBy?: string;\n    limit?: number;\n    offset?: number;\n}): string {\n    const objectType = quoteIdentifier(opts.objectType);\n    const select = opts.selectedProperties.map(quoteIdentifier).join(\", \");\n    const clauses = [`SELECT ${select} FROM ${objectType}`];\n\n    if (opts.where?.clause) {\n        clauses.push(`WHERE ${opts.where.clause}`);\n    }\n    if (opts.orderBy) {\n        clauses.push(`ORDER BY ${opts.orderBy}`);\n    }\n    if (opts.limit !== undefined) {\n        clauses.push(`LIMIT ${Math.max(0, Math.trunc(opts.limit))}`);\n    }\n    if (opts.offset !== undefined && opts.offset > 0) {\n        clauses.push(`OFFSET ${Math.max(0, Math.trunc(opts.offset))}`);\n    }\n    return clauses.join(\" \");\n}\n"],"mappings":"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"}

package/lib/adapter/createSalesforceOntologyBackendAdapter.d.ts

@@ -1,20 +1,22 @@
-import { type OntologyBackendAdapter, type OntologyBackendAdapterProvider, type OntologyIR } from "@party-stack/ontology";
-import { type SalesforceClient } from "@party-stack/salesforce-client";
-import { type SubscribeToSalesforceChangeEvents } from "./objectCollectionOptions.js";
+import { SubscribeToSalesforceChangeEvents } from "./objectCollectionOptions.js";
+import { SalesforceClient } from "@party-stack/salesforce-client";
+import { OntologyBackendAdapter, OntologyBackendAdapterProvider, OntologyIR } from "@party-stack/ontology";
+//#region src/adapter/createSalesforceOntologyBackendAdapter.d.ts
 export declare function createSalesforceOntologyBackendAdapter(opts: {
-    client: SalesforceClient;
-    ir: OntologyIR;
-    subscribeToChangeEvents?: SubscribeToSalesforceChangeEvents;
-    live?: boolean;
+  client: SalesforceClient;
+  ir: OntologyIR;
+  subscribeToChangeEvents?: SubscribeToSalesforceChangeEvents;
+  live?: boolean;
 }): OntologyBackendAdapter;
 export type CreateSalesforceOntologyBackendOptions<Context extends Record<string, unknown> = Record<string, unknown>> = ({
-    client: SalesforceClient;
-    subscribeToChangeEvents?: SubscribeToSalesforceChangeEvents;
+  client: SalesforceClient;
+  subscribeToChangeEvents?: SubscribeToSalesforceChangeEvents;
 } | {
-    createClient: (ir: OntologyIR, context: Context) => SalesforceClient | Promise<SalesforceClient>;
-    subscribeToChangeEvents?: SubscribeToSalesforceChangeEvents;
+  createClient: (ir: OntologyIR, context: Context) => SalesforceClient | Promise<SalesforceClient>;
+  subscribeToChangeEvents?: SubscribeToSalesforceChangeEvents;
 }) & {
-    live?: boolean;
+  live?: boolean;
 };
 export declare function createSalesforceOntologyBackend<Context extends Record<string, unknown> = Record<string, unknown>>(opts: CreateSalesforceOntologyBackendOptions<Context>): OntologyBackendAdapterProvider<Context>;
+//#endregion
 //# sourceMappingURL=createSalesforceOntologyBackendAdapter.d.ts.map