@party-stack/salesforce-ontology 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Robert Fidler
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,114 @@
+# salesforce-ontology
+
+Salesforce connection, installation, metadata, and runtime ontology adapters.
+
+## Installation
+
+```ts
+import {
+    createSalesforceBackendInstallation,
+    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",
+            },
+        },
+        routes: [
+            createSalesforceOntologyRoute({
+                ontologyId:
+                    "salesforce:task-manager",
+                ir: generatedOntology,
+            }),
+        ],
+    });
+```
+
+The connection adapter uses `@party-stack/oauth`, persists refresh tokens
+through the selected runtime, and applies authentication through
+`ConnectionEgress`. The Salesforce client and ontology backends remain
+token-provider/egress agnostic.
+
+## Pull configuration
+
+Consumer projects can export a standard Party Stack pull configuration:
+
+```ts
+import {
+    createSalesforceOntologyPullConfig,
+} from "@party-stack/salesforce-ontology/config";
+
+export default createSalesforceOntologyPullConfig({
+    instanceUrl,
+    apiVersion: "65.0",
+    ontologyId: "salesforce:task-manager",
+    objectTypeNames: ["Task", "User"],
+    actionTypeNames: [],
+    connection: {
+        oauth: {
+            clientId,
+            redirectUrl,
+        },
+    },
+});
+```
+
+Running `ontology pull` opens the Salesforce metadata ontology and emits the
+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.
+
+## Runtime adapter
+
+```ts
+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({
+    instanceUrl: process.env.SALESFORCE_INSTANCE_URL!,
+    apiVersion: "61.0",
+    tokenProvider: async () => process.env.SALESFORCE_ACCESS_TOKEN!,
+});
+
+const ontology = await createLiveOntology({
+    ir,
+    backend: createSalesforceOntologyBackend({ client }),
+});
+```
+
+## Metadata adapter
+
+```ts
+import { createSalesforceMetaOntologyBackendAdapter } from "@party-stack/salesforce-ontology/meta";
+import { createMetaLiveOntology } from "@party-stack/ontology";
+
+const meta = await createMetaLiveOntology({
+    backend: () =>
+        createSalesforceMetaOntologyBackendAdapter({
+            client,
+            objectTypeNames: ["Account", "Contact"],
+        }),
+});
+```
+
+## Scope
+
+- sObject describe → object/link metadata
+- Active autolaunched Flows → action metadata and invocation
+- SOQL-backed object collections
+- No CDC live sync, Files attachments, Apex actions, or query functions in this slice

package/lib/adapter/convertLoadSubsetOptions.d.ts

@@ -0,0 +1,18 @@
+import { LoadSubsetOptions } from "@tanstack/db";
+export type CompiledSoqlFilter = {
+    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;
+}): string;
+//# sourceMappingURL=convertLoadSubsetOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"convertLoadSubsetOptions.d.ts","sourceRoot":"","sources":["../../src/adapter/convertLoadSubsetOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,iBAAiB,EAGpB,MAAM,cAAc,CAAC;AAKtB,MAAM,MAAM,kBAAkB,GAAG;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACxB,CAAC;AAoBF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA6B3D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,GAAG,OAAO,CAEnF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,kBAAkB,GAAG,SAAS,CA8D1G;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"}

package/lib/adapter/convertLoadSubsetOptions.js

@@ -0,0 +1,144 @@
+import { parseOrderByExpression, parseWhereExpression, } from "@tanstack/db";
+import { Temporal } from "temporal-polyfill";
+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;
+}
+function fieldPathToSoql(fieldPath) {
+    if (fieldPath.length === 0) {
+        throw new Error("Empty field path.");
+    }
+    return fieldPath.map((segment) => quoteIdentifier(String(segment))).join(".");
+}
+function escapeSoqlString(value) {
+    return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
+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}`);
+}
+export function isAlwaysFalseFilter(filter) {
+    return Boolean(filter?.alwaysFalse);
+}
+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)}`,
+            isNull: (field) => `${fieldPathToSoql(field)} = null`,
+            in: (field, values) => {
+                const literals = values
+                    .filter((entry) => entry !== null && entry !== undefined)
+                    .map(serializeSoqlLiteral);
+                if (literals.length === 0)
+                    return ALWAYS_FALSE;
+                return `${fieldPathToSoql(field)} IN (${literals.join(", ")})`;
+            },
+            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 };
+}
+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;
+}
+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(" ");
+}
+//# sourceMappingURL=convertLoadSubsetOptions.js.map

package/lib/adapter/convertLoadSubsetOptions.js.map

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=convertLoadSubsetOptions.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"convertLoadSubsetOptions.test.d.ts","sourceRoot":"","sources":["../../src/adapter/convertLoadSubsetOptions.test.ts"],"names":[],"mappings":""}

package/lib/adapter/convertLoadSubsetOptions.test.js

@@ -0,0 +1,54 @@
+import { eq, gt, IR, lt } from "@tanstack/db";
+import { Temporal } from "temporal-polyfill";
+import { describe, expect, it } from "vitest";
+import { buildSoqlQuery, convertLoadSubsetFilter, isAlwaysFalseFilter, serializeSoqlLiteral, } from "./convertLoadSubsetOptions.js";
+describe("serializeSoqlLiteral", () => {
+    it("escapes strings and serializes temporal values", () => {
+        expect(serializeSoqlLiteral("O'Brien")).toBe("'O\\'Brien'");
+        expect(serializeSoqlLiteral(true)).toBe("true");
+        expect(serializeSoqlLiteral(Temporal.PlainDate.from("2026-08-06"))).toBe("2026-08-06");
+        expect(serializeSoqlLiteral(Temporal.Instant.from("2026-08-06T12:00:00Z"))).toBe("2026-08-06T12:00:00Z");
+    });
+});
+describe("convertLoadSubsetFilter", () => {
+    it("converts equality and null checks", () => {
+        expect(convertLoadSubsetFilter(eq(new IR.PropRef(["Name"]), "Acme"))).toEqual({
+            clause: "Name = 'Acme'",
+            alwaysFalse: false,
+        });
+        expect(convertLoadSubsetFilter(eq(new IR.PropRef(["DeletedDate"]), null))).toEqual({
+            clause: "DeletedDate = null",
+            alwaysFalse: false,
+        });
+    });
+    it("treats null range comparisons as always false", () => {
+        const filter = convertLoadSubsetFilter(lt(new IR.PropRef(["Amount"]), null));
+        expect(isAlwaysFalseFilter(filter)).toBe(true);
+    });
+    it("serializes Temporal values", () => {
+        const filter = convertLoadSubsetFilter(gt(new IR.PropRef(["CreatedDate"]), Temporal.Instant.from("2026-07-27T12:00:00Z")));
+        expect(filter).toEqual({
+            clause: "CreatedDate > 2026-07-27T12:00:00Z",
+            alwaysFalse: false,
+        });
+    });
+});
+describe("buildSoqlQuery", () => {
+    it("builds SELECT/FROM/WHERE/ORDER BY/LIMIT/OFFSET queries", () => {
+        expect(buildSoqlQuery({
+            objectType: "Account",
+            selectedProperties: ["Id", "Name"],
+            where: { clause: "Name = 'Acme'", alwaysFalse: false },
+            orderBy: "Name ASC",
+            limit: 50,
+            offset: 10,
+        })).toBe("SELECT Id, Name FROM Account WHERE Name = 'Acme' ORDER BY Name ASC LIMIT 50 OFFSET 10");
+    });
+    it("rejects unsafe identifiers", () => {
+        expect(() => buildSoqlQuery({
+            objectType: "Account; DROP TABLE",
+            selectedProperties: ["Id"],
+        })).toThrow(/Invalid Salesforce identifier/);
+    });
+});
+//# sourceMappingURL=convertLoadSubsetOptions.test.js.map

package/lib/adapter/convertLoadSubsetOptions.test.js.map

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

package/lib/adapter/createSalesforceOntologyBackendAdapter.d.ts

@@ -0,0 +1,13 @@
+import { type OntologyBackendAdapter, type OntologyBackendAdapterProvider, type OntologyIR } from "@party-stack/ontology";
+import { type SalesforceClient } from "@party-stack/salesforce-client";
+export declare function createSalesforceOntologyBackendAdapter(opts: {
+    client: SalesforceClient;
+    ir: OntologyIR;
+}): OntologyBackendAdapter;
+export type CreateSalesforceOntologyBackendOptions<Context extends Record<string, unknown> = Record<string, unknown>> = {
+    client: SalesforceClient;
+} | {
+    createClient: (ir: OntologyIR, context: Context) => SalesforceClient | Promise<SalesforceClient>;
+};
+export declare function createSalesforceOntologyBackend<Context extends Record<string, unknown> = Record<string, unknown>>(opts: CreateSalesforceOntologyBackendOptions<Context>): OntologyBackendAdapterProvider<Context>;
+//# sourceMappingURL=createSalesforceOntologyBackendAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createSalesforceOntologyBackendAdapter.d.ts","sourceRoot":"","sources":["../../src/adapter/createSalesforceOntologyBackendAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,sBAAsB,EAC3B,KAAK,8BAA8B,EACnC,KAAK,UAAU,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAqC3F,wBAAgB,sCAAsC,CAAC,IAAI,EAAE;IACzD,MAAM,EAAE,gBAAgB,CAAC;IACzB,EAAE,EAAE,UAAU,CAAC;CAClB,GAAG,sBAAsB,CAqEzB;AAED,MAAM,MAAM,sCAAsC,CAC9C,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAE/D;IACI,MAAM,EAAE,gBAAgB,CAAC;CAC5B,GACD;IACI,YAAY,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,KAAK,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACpG,CAAC;AAER,wBAAgB,+BAA+B,CAC3C,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,IAAI,EAAE,sCAAsC,CAAC,OAAO,CAAC,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAMhG"}

package/lib/adapter/createSalesforceOntologyBackendAdapter.js

@@ -0,0 +1,90 @@
+import { NonRetryableError, } from "@party-stack/ontology";
+import { SalesforceApiError } from "@party-stack/salesforce-client";
+import { getSalesforceFlowApiNameFromActionType } from "../meta/convertMetaActionType.js";
+import { objectCollectionOptions } from "./objectCollectionOptions.js";
+import { createSalesforceCodec } from "./salesforceCodec.js";
+function isNonRetryableSalesforceError(error) {
+    if (!(error instanceof SalesforceApiError)) {
+        return false;
+    }
+    if (error.statusCode === 400 || error.statusCode === 403 || error.statusCode === 404) {
+        return true;
+    }
+    const code = error.errorCode?.toUpperCase();
+    return (code === "INVALID_INPUT" ||
+        code === "REQUIRED_FIELD_MISSING" ||
+        code === "FIELD_CUSTOM_VALIDATION_EXCEPTION" ||
+        code === "INSUFFICIENT_ACCESS" ||
+        code === "INSUFFICIENT_ACCESS_OR_READONLY" ||
+        code === "NOT_FOUND");
+}
+function invalidateEditedCollections(objects) {
+    for (const collection of Object.values(objects)) {
+        const utils = collection.utils;
+        utils?.invalidate?.();
+    }
+}
+export function createSalesforceOntologyBackendAdapter(opts) {
+    const codec = createSalesforceCodec(opts.ir);
+    return {
+        name: "salesforce",
+        getCollectionOptions: (objectType) => {
+            const objectTypeDef = opts.ir.objectTypes.find((candidate) => candidate.name === objectType);
+            if (!objectTypeDef) {
+                throw new Error(`Unknown Salesforce object type "${objectType}".`);
+            }
+            return objectCollectionOptions({
+                client: opts.client,
+                objectType,
+                primaryKeyProperty: objectTypeDef.primaryKey,
+                selectedProperties: objectTypeDef.properties.map((property) => property.name),
+                decodeObject: (object) => codec.decodeObject(objectType, object),
+            });
+        },
+        applyAction: async (name, parameters, live) => {
+            const actionType = opts.ir.actionTypes.find((candidate) => candidate.name === name);
+            if (!actionType) {
+                throw new NonRetryableError(`Unknown Salesforce action type "${name}".`);
+            }
+            const parameterTypes = new Map(actionType.parameters.map((parameter) => [parameter.name, parameter.type]));
+            const requestParameters = {};
+            for (const [parameterName, value] of Object.entries(parameters)) {
+                if (value === undefined)
+                    continue;
+                const parameterType = parameterTypes.get(parameterName);
+                requestParameters[parameterName] = parameterType
+                    ? codec.encodeValue(parameterType, value)
+                    : value;
+            }
+            const flowApiName = getSalesforceFlowApiNameFromActionType(actionType);
+            let results;
+            try {
+                results = await opts.client.invokeFlowAction(flowApiName, [requestParameters]);
+            }
+            catch (error) {
+                if (isNonRetryableSalesforceError(error)) {
+                    throw new NonRetryableError(error instanceof Error ? error.message : "Salesforce Flow invocation failed.", { cause: error });
+                }
+                throw error;
+            }
+            const result = results[0];
+            if (!result) {
+                throw new Error(`Salesforce Flow "${flowApiName}" returned no results.`);
+            }
+            if (!result.isSuccess) {
+                const message = result.errors?.map((entry) => entry.message).filter(Boolean).join("; ") ||
+                    `Salesforce Flow "${flowApiName}" failed.`;
+                throw new NonRetryableError(message);
+            }
+            invalidateEditedCollections(live.objects);
+        },
+        runQueryFunction: (name) => Promise.reject(new Error(`Salesforce ontology adapter cannot run query function type "${name}". Query functions are not supported in this slice.`)),
+    };
+}
+export function createSalesforceOntologyBackend(opts) {
+    return async (ir, context) => createSalesforceOntologyBackendAdapter({
+        ir,
+        client: "client" in opts ? opts.client : await opts.createClient(ir, context),
+    });
+}
+//# sourceMappingURL=createSalesforceOntologyBackendAdapter.js.map

package/lib/adapter/createSalesforceOntologyBackendAdapter.js.map

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

package/lib/adapter/createSalesforceOntologyBackendAdapter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=createSalesforceOntologyBackendAdapter.test.d.ts.map

package/lib/adapter/createSalesforceOntologyBackendAdapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSalesforceOntologyBackendAdapter.test.d.ts","sourceRoot":"","sources":["../../src/adapter/createSalesforceOntologyBackendAdapter.test.ts"],"names":[],"mappings":""}

package/lib/adapter/createSalesforceOntologyBackendAdapter.test.js

@@ -0,0 +1,142 @@
+import { NonRetryableError, o } from "@party-stack/ontology";
+import { SalesforceApiError } from "@party-stack/salesforce-client";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { createSalesforceOntologyBackend, createSalesforceOntologyBackendAdapter, } from "./createSalesforceOntologyBackendAdapter.js";
+describe("createSalesforceOntologyBackendAdapter", () => {
+    const ir = {
+        types: [],
+        objectTypes: [
+            {
+                name: "Account",
+                displayName: "Account",
+                pluralDisplayName: "Accounts",
+                primaryKey: "Id",
+                properties: [
+                    { name: "Id", displayName: "Id", type: o.string({}) },
+                    { name: "Name", displayName: "Name", type: o.string({}) },
+                ],
+            },
+        ],
+        linkTypes: [],
+        actionTypes: [
+            {
+                name: "Create_Account",
+                displayName: "Create Account",
+                parameters: [
+                    {
+                        name: "accountName",
+                        displayName: "Account Name",
+                        type: o.string({}),
+                    },
+                ],
+                logic: [],
+            },
+        ],
+        queryFunctionTypes: [],
+    };
+    // Preserve the Flow API name via the meta id convention at runtime.
+    ir.actionTypes[0].id = "salesforce:flow:Create_Account";
+    const invokeFlowAction = vi.fn();
+    const query = vi.fn();
+    const queryMore = vi.fn();
+    const invalidate = vi.fn();
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    function createAdapter() {
+        return createSalesforceOntologyBackendAdapter({
+            ir,
+            client: {
+                instanceUrl: "https://example.my.salesforce.com",
+                apiVersion: "61.0",
+                tokenProvider: () => "token",
+                fetch: vi.fn(),
+                connection: {},
+                request: vi.fn(),
+                describeGlobal: vi.fn(),
+                describeSObject: vi.fn(),
+                query,
+                queryMore,
+                createRecord: vi.fn(),
+                updateRecord: vi.fn(),
+                deleteRecord: vi.fn(),
+                subscribeToChangeEvents: vi.fn(),
+                listFlowActions: vi.fn(),
+                describeFlowAction: vi.fn(),
+                invokeFlowAction,
+            },
+        });
+    }
+    it("invokes Flows by API name and invalidates collections on success", async () => {
+        invokeFlowAction.mockResolvedValue([
+            {
+                isSuccess: true,
+                outputValues: { Flow__InterviewStatus: "Finished" },
+            },
+        ]);
+        const adapter = createAdapter();
+        await adapter.applyAction("Create_Account", { accountName: "Acme" }, {
+            objects: {
+                Account: {
+                    utils: { invalidate },
+                },
+            },
+        });
+        expect(invokeFlowAction).toHaveBeenCalledWith("Create_Account", [
+            { accountName: "Acme" },
+        ]);
+        expect(invalidate).toHaveBeenCalledOnce();
+    });
+    it("maps validation failures to NonRetryableError", async () => {
+        invokeFlowAction.mockRejectedValue(new SalesforceApiError("Required fields are missing", {
+            statusCode: 400,
+            errorCode: "REQUIRED_FIELD_MISSING",
+        }));
+        const adapter = createAdapter();
+        await expect(adapter.applyAction("Create_Account", {}, { objects: {} })).rejects.toBeInstanceOf(NonRetryableError);
+    });
+    it("maps unsuccessful Flow results to NonRetryableError", async () => {
+        invokeFlowAction.mockResolvedValue([
+            {
+                isSuccess: false,
+                errors: [{ message: "Flow failed validation" }],
+            },
+        ]);
+        const adapter = createAdapter();
+        await expect(adapter.applyAction("Create_Account", { accountName: "Acme" }, { objects: {} })).rejects.toEqual(expect.objectContaining({
+            name: "NonRetryableError",
+            message: "Flow failed validation",
+        }));
+    });
+    it("rejects query functions", async () => {
+        const adapter = createAdapter();
+        await expect(adapter.runQueryFunction("currentUser", {}, { objects: {} })).rejects.toThrow(/cannot run query function/);
+    });
+    it("creates a provider that builds adapters from a client factory", async () => {
+        const provider = createSalesforceOntologyBackend({
+            createClient: () => ({
+                instanceUrl: "https://example.my.salesforce.com",
+                apiVersion: "61.0",
+                tokenProvider: () => "token",
+                fetch: vi.fn(),
+                connection: {},
+                request: vi.fn(),
+                describeGlobal: vi.fn(),
+                describeSObject: vi.fn(),
+                query,
+                queryMore,
+                createRecord: vi.fn(),
+                updateRecord: vi.fn(),
+                deleteRecord: vi.fn(),
+                subscribeToChangeEvents: vi.fn(),
+                listFlowActions: vi.fn(),
+                describeFlowAction: vi.fn(),
+                invokeFlowAction,
+            }),
+        });
+        const adapter = await provider(ir, {});
+        expect(adapter.name).toBe("salesforce");
+        expect(adapter.getCollectionOptions("Account").syncMode).toBe("on-demand");
+    });
+});
+//# sourceMappingURL=createSalesforceOntologyBackendAdapter.test.js.map