@party-stack/salesforce-ontology 0.4.2 → 0.5.0

package/README.md

@@ -1,38 +1,65 @@
 # salesforce-ontology
 
-Salesforce connection, installation, metadata, and runtime ontology adapters.
+Salesforce service integration, metadata, and ontology backends.
 
-## Installation
+## Saved connections and native backends
 
 ```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,
-        }),
-    ],
-});
+import { makeConnectManager } from "@party-stack/connect";
+import { makeSalesforceServiceConnector } from "@party-stack/salesforce-ontology";
+import { makeSalesforceBackend } from "@party-stack/salesforce-ontology/connect";
+
+const connect =
+    yield *
+    makeConnectManager({
+        services: [
+            {
+                connector: makeSalesforceServiceConnector({ loginUrl }),
+                instances: [
+                    {
+                        id: "salesforce",
+                        title: "Salesforce",
+                        instanceUrl,
+                        OAuthApplications: [
+                            {
+                                id: clientId,
+                                title: "My app",
+                                clientId,
+                                redirectUrl,
+                                flow: "authorization-code",
+                            },
+                        ],
+                    },
+                ],
+            },
+        ],
+    });
+const access =
+    yield *
+    connect.connections.acquire({
+        objectType: "OAuthConnection",
+        id: connectionId,
+    });
+const backend =
+    yield *
+    makeSalesforceBackend({
+        instanceUrl: access.serviceInstance.instanceUrl,
+        apiVersion: "65.0",
+        egress: access.egress,
+        ir: generatedOntology,
+        context: { user: access.userId },
+    });
 ```
 
-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.
+`makeConnectManager` requires `Runtime` and `Scope`. It owns the saved connection
+inventory, credential refresh and maintenance. Acquiring a connection creates
+scoped authenticated I/O. Each request reads current credentials; an OAuth 401
+can request one coordinated refresh and retry.
+
+Mount the public Connect ontology on `makeOntologyServer`, then use
+`createAuthenticationClient(...).oauth(...).signIn()` from a browser event handler.
+Serve acquired data backends through other routes on the same server. The
+Salesforce task manager uses that arrangement in a SharedWorker.
 
 ## Pull configuration
 
@@ -64,50 +91,16 @@ export default createSalesforceOntologyPullConfig({
 });
 ```
 
-Running `ontology pull` opens the Salesforce metadata ontology and emits the
-normal `src/ontology/ontology.ts` consumed by
-`createSalesforceOntologyRoute({ ir })`.
+Running `ontology pull` acquires the native Salesforce metadata backend and emits
+`src/ontology/ontology.ts`. It uses the same Connect manager and acquires only authenticated metadata I/O; it does not open a data replica or UI collection.
 
 See `apps/salesforce-task-manager` for a real-org example.
 
-# salesforce-ontology
-
-Salesforce backend adapters for Party Stack LiveOntology.
+## Metadata backend
 
-## Runtime adapter
-
-```ts
-import { createLiveOntology } from "@party-stack/ontology";
-import { createSalesforceClient } from "@party-stack/salesforce-client";
-import { createSalesforceOntologyBackend } from "@party-stack/salesforce-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 { createMetaLiveOntology } from "@party-stack/ontology";
-import { createSalesforceMetaOntologyBackendAdapter } from "@party-stack/salesforce-ontology/meta";
-
-const meta = await createMetaLiveOntology({
-    backend: () =>
-        createSalesforceMetaOntologyBackendAdapter({
-            client,
-            objectTypeNames: ["Account", "Contact"],
-        }),
-});
-```
+`makeSalesforceMetadataBackend({ instanceUrl, apiVersion, egress, ...options })`
+from the `connect` export acquires metadata directly. The lower-level adapter
+constructors remain available for callers supplying their own Salesforce client.
 
 Unscoped object/action queries load Salesforce catalog summaries only.
 Queries using `eq` or `inArray` on `name` push down to the direct describe

package/lib/adapter/backend.d.ts

@@ -0,0 +1,15 @@
+import { SalesforceClient } from "@party-stack/salesforce-client";
+import { ActionReceipt, OntologyBackendService } from "@party-stack/ontology-backend";
+import { OntologyIR } from "@party-stack/ontology-spec";
+//#region src/adapter/backend.d.ts
+/** Native protocol binding. It never acquires private TanStack collections. */
+export declare function makeSalesforceBackend(options: {
+  readonly client: SalesforceClient;
+  readonly ir: OntologyIR;
+  readonly context?: Record<string, unknown>;
+  readonly decodeObject: (objectType: string, object: Record<string, unknown>) => Record<string, unknown>;
+  readonly submitAction: (name: string, parameters: Record<string, unknown>, client: SalesforceClient) => Promise<Pick<ActionReceipt, "affected" | "affectedComplete">>;
+  readonly runQueryFunction: (name: string, parameters: Record<string, unknown>, client: SalesforceClient) => Promise<unknown>;
+}): OntologyBackendService;
+//#endregion
+//# sourceMappingURL=backend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","names":[],"sources":["../../src/adapter/backend.ts"],"mappings":";;;;;wBAgBgB,sBAAsB;WACzB,QAAQ;WACR,IAAI;WACJ,UAAU;WACV,eAAe,oBAAoB,QAAQ,4BAA4B;WACvE,eACL,cACA,YAAY,yBACZ,QAAQ,qBACP,QAAQ,KAAK;WACT,mBACL,cACA,YAAY,yBACZ,QAAQ,qBACP;IACL"}

package/lib/adapter/backend.js

@@ -0,0 +1,94 @@
+import { quoteSoqlIdentifier, serializeSoqlLiteral } from "./soql.js";
+import { searchSalesforceObjects } from "./salesforceObjectSearch.js";
+import { Effect, Redacted, Schema } from "effect";
+import { BackendError, classifyBackendFailure, makeOntologyBackend } from "@party-stack/ontology-backend";
+import { compileObjectSubset, objectSubset } from "@party-stack/ontology-backend/subset";
+import { QuerySchema } from "@party-stack/ontology-storage";
+import { isField } from "@party-stack/ontology-storage/tables";
+//#region src/adapter/backend.ts
+const KeySchema = Schema.Union([Schema.String, Schema.Finite]);
+/** Native protocol binding. It never acquires private TanStack collections. */
+function makeSalesforceBackend(options) {
+	const failure = classifyBackendFailure;
+	const clientFor = (signal) => options.client.withSignal?.(signal) ?? options.client;
+	return makeOntologyBackend({
+		ir: options.ir,
+		context: options.context,
+		name: "salesforce",
+		sourceId: `salesforce:${options.client.instanceUrl}`,
+		supportsIdempotency: false,
+		loadSubset: Effect.fn("Salesforce.loadSubset")(function* (request) {
+			const subset = yield* compileObjectSubset(options.ir, request, options.context);
+			yield* Effect.annotateCurrentSpan("objectType", subset.objectType);
+			yield* Schema.decodeUnknownEffect(QuerySchema)(subset.query ?? {}).pipe(Effect.mapError((cause) => new BackendError({
+				operation: "salesforce.loadSubset",
+				kind: "InvalidRequest",
+				message: "Invalid subset query.",
+				retryable: false,
+				cause: Redacted.make(cause)
+			})));
+			const definition = options.ir.objectTypes.find((type) => type.name === subset.objectType);
+			if (!definition) return yield* new BackendError({
+				operation: "salesforce.loadSubset",
+				kind: "InvalidRequest",
+				message: "Unknown Salesforce object type.",
+				retryable: false
+			});
+			const predicate = subset.query?.where;
+			const candidates = predicate?.op === "in" && isField(predicate.left) && predicate.left.path.length === 1 && predicate.left.path[0] === definition.primaryKey ? predicate.values : predicate?.op === "eq" && isField(predicate.left) && predicate.left.path.length === 1 && predicate.left.path[0] === definition.primaryKey && !isField(predicate.right) ? [predicate.right] : void 0;
+			const keys = candidates?.every(Schema.is(KeySchema)) ? candidates : void 0;
+			const values = yield* Effect.tryPromise({
+				try: (signal) => searchSalesforceObjects(options.client, subset.objectType, [.../* @__PURE__ */ new Set([definition.primaryKey, ...definition.properties.map((p) => p.name)])], {
+					signal,
+					where: keys ? {
+						alwaysFalse: keys.length === 0,
+						clause: `${quoteSoqlIdentifier(definition.primaryKey)} IN (${[...new Set(keys)].map(serializeSoqlLiteral).join(", ")})`
+					} : void 0
+				}, (value) => options.decodeObject(subset.objectType, value)),
+				catch: (cause) => failure("salesforce.loadSubset", cause)
+			});
+			return {
+				rows: yield* Effect.forEach(values, (value) => Schema.decodeUnknownEffect(KeySchema)(value[definition.primaryKey]).pipe(Effect.map((key) => ({
+					key,
+					value
+				})), Effect.mapError((cause) => new BackendError({
+					operation: "salesforce.loadSubset",
+					kind: "InvalidResponse",
+					message: "Salesforce returned an invalid row identity.",
+					retryable: false,
+					cause: Redacted.make(cause)
+				})))),
+				fulfilledSubset: objectSubset(subset.objectType, { where: subset.query?.where }),
+				fetchedRows: values.length,
+				complete: true
+			};
+		}),
+		applyAction: Effect.fn("Salesforce.applyAction")(function* (invocation) {
+			if (invocation.attachmentUploads?.length) return yield* new BackendError({
+				operation: "salesforce.applyAction",
+				kind: "NotImplemented",
+				message: "Salesforce attachment uploads are not supported.",
+				retryable: false
+			});
+			const targets = yield* Effect.tryPromise({
+				try: (signal) => options.submitAction(invocation.name, invocation.parameters, clientFor(signal)),
+				catch: (cause) => failure("salesforce.applyAction", cause)
+			});
+			return {
+				operationId: invocation.id,
+				outcome: "committed",
+				...targets
+			};
+		}),
+		queryFunction: Effect.fn("Salesforce.queryFunction")(function* (name, parameters) {
+			return yield* Effect.tryPromise({
+				try: (signal) => options.runQueryFunction(name, parameters, clientFor(signal)),
+				catch: (cause) => failure("salesforce.queryFunction", cause)
+			});
+		})
+	});
+}
+//#endregion
+export { makeSalesforceBackend };
+
+//# sourceMappingURL=backend.js.map

package/lib/adapter/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","names":[],"sources":["../../src/adapter/backend.ts"],"sourcesContent":["import { makeOntologyBackend } from \"@party-stack/ontology-backend\";\nimport { BackendError, classifyBackendFailure } from \"@party-stack/ontology-backend\";\nimport { compileObjectSubset, objectSubset } from \"@party-stack/ontology-backend/subset\";\nimport { QuerySchema } from \"@party-stack/ontology-storage\";\nimport { isField } from \"@party-stack/ontology-storage/tables\";\nimport { Effect, Schema, Redacted } from \"effect\";\nimport { searchSalesforceObjects } from \"./salesforceObjectSearch.js\";\nimport { quoteSoqlIdentifier, serializeSoqlLiteral } from \"./soql.js\";\nimport type { ActionRequest, ActionReceipt, OntologyBackendService } from \"@party-stack/ontology-backend\";\nimport type { OntologyIR } from \"@party-stack/ontology-spec\";\nimport type { ObjectSubset } from \"@party-stack/ontology-spec/query\";\nimport type { SalesforceClient } from \"@party-stack/salesforce-client\";\n\nconst KeySchema = Schema.Union([Schema.String, Schema.Finite]);\n\n/** Native protocol binding. It never acquires private TanStack collections. */\nexport function makeSalesforceBackend(options: {\n    readonly client: SalesforceClient;\n    readonly ir: OntologyIR;\n    readonly context?: Record<string, unknown>;\n    readonly decodeObject: (objectType: string, object: Record<string, unknown>) => Record<string, unknown>;\n    readonly submitAction: (\n        name: string,\n        parameters: Record<string, unknown>,\n        client: SalesforceClient\n    ) => Promise<Pick<ActionReceipt, \"affected\" | \"affectedComplete\">>;\n    readonly runQueryFunction: (\n        name: string,\n        parameters: Record<string, unknown>,\n        client: SalesforceClient\n    ) => Promise<unknown>;\n}): OntologyBackendService {\n    const failure = classifyBackendFailure;\n    const clientFor = (signal: AbortSignal) => options.client.withSignal?.(signal) ?? options.client;\n    return makeOntologyBackend({\n        ir: options.ir,\n        context: options.context,\n        name: \"salesforce\",\n        sourceId: `salesforce:${options.client.instanceUrl}`,\n        supportsIdempotency: false,\n        loadSubset: Effect.fn(\"Salesforce.loadSubset\")(function* (request: ObjectSubset) {\n            const subset = yield* compileObjectSubset(options.ir, request, options.context);\n            yield* Effect.annotateCurrentSpan(\"objectType\", subset.objectType);\n            yield* Schema.decodeUnknownEffect(QuerySchema)(subset.query ?? {}).pipe(\n                Effect.mapError(\n                    (cause) =>\n                        new BackendError({\n                            operation: \"salesforce.loadSubset\",\n                            kind: \"InvalidRequest\",\n                            message: \"Invalid subset query.\",\n                            retryable: false,\n                            cause: Redacted.make(cause),\n                        })\n                )\n            );\n            const definition = options.ir.objectTypes.find((type) => type.name === subset.objectType);\n            if (!definition)\n                return yield* new BackendError({\n                    operation: \"salesforce.loadSubset\",\n                    kind: \"InvalidRequest\",\n                    message: \"Unknown Salesforce object type.\",\n                    retryable: false,\n                });\n            const predicate = subset.query?.where;\n            const candidates =\n                predicate?.op === \"in\" &&\n                isField(predicate.left) &&\n                predicate.left.path.length === 1 &&\n                predicate.left.path[0] === definition.primaryKey\n                    ? predicate.values\n                    : predicate?.op === \"eq\" &&\n                        isField(predicate.left) &&\n                        predicate.left.path.length === 1 &&\n                        predicate.left.path[0] === definition.primaryKey &&\n                        !isField(predicate.right)\n                      ? [predicate.right]\n                      : undefined;\n            const keys = candidates?.every(Schema.is(KeySchema))\n                ? (candidates as readonly (string | number)[])\n                : undefined;\n            const values = yield* Effect.tryPromise({\n                try: (signal) =>\n                    searchSalesforceObjects(\n                        options.client,\n                        subset.objectType,\n                        [...new Set([definition.primaryKey, ...definition.properties.map((p) => p.name)])],\n                        {\n                            signal,\n                            where: keys\n                                ? {\n                                      alwaysFalse: keys.length === 0,\n                                      clause: `${quoteSoqlIdentifier(definition.primaryKey)} IN (${[\n                                          ...new Set(keys),\n                                      ]\n                                          .map(serializeSoqlLiteral)\n                                          .join(\", \")})`,\n                                  }\n                                : undefined,\n                        },\n                        (value) => options.decodeObject(subset.objectType, value)\n                    ),\n                catch: (cause) => failure(\"salesforce.loadSubset\", cause),\n            });\n            const rows = yield* Effect.forEach(values, (value) =>\n                Schema.decodeUnknownEffect(KeySchema)(value[definition.primaryKey]).pipe(\n                    Effect.map((key) => ({ key, value })),\n                    Effect.mapError(\n                        (cause) =>\n                            new BackendError({\n                                operation: \"salesforce.loadSubset\",\n                                kind: \"InvalidResponse\",\n                                message: \"Salesforce returned an invalid row identity.\",\n                                retryable: false,\n                                cause: Redacted.make(cause),\n                            })\n                    )\n                )\n            );\n            // Only primary-key predicates are pushed down. The shared engine\n            // evaluates residual conditions and windows over this completed region.\n            return {\n                rows,\n                fulfilledSubset: objectSubset(subset.objectType, { where: subset.query?.where }),\n                fetchedRows: values.length,\n                complete: true,\n            };\n        }),\n        applyAction: Effect.fn(\"Salesforce.applyAction\")(function* (invocation: ActionRequest) {\n            if (invocation.attachmentUploads?.length)\n                return yield* new BackendError({\n                    operation: \"salesforce.applyAction\",\n                    kind: \"NotImplemented\",\n                    message: \"Salesforce attachment uploads are not supported.\",\n                    retryable: false,\n                });\n            const targets = yield* Effect.tryPromise({\n                try: (signal) =>\n                    options.submitAction(invocation.name, invocation.parameters, clientFor(signal)),\n                catch: (cause) => failure(\"salesforce.applyAction\", cause),\n            });\n            return {\n                operationId: invocation.id,\n                outcome: \"committed\",\n                ...targets,\n            } satisfies ActionReceipt;\n        }),\n        queryFunction: Effect.fn(\"Salesforce.queryFunction\")(function* (\n            name: string,\n            parameters: Record<string, unknown>\n        ) {\n            return yield* Effect.tryPromise({\n                try: (signal) => options.runQueryFunction(name, parameters, clientFor(signal)),\n                catch: (cause) => failure(\"salesforce.queryFunction\", cause),\n            });\n        }),\n        // The client's CDC API cannot yet report stream health/reconnect gaps.\n        // Callers can configure Replica polling; this binding does not enable it automatically.\n    });\n}\n"],"mappings":"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"}

package/lib/adapter/index.d.ts

@@ -1,5 +1,3 @@
-import { CompiledSoqlFilter, buildSoqlQuery, convertLoadSubsetFilter, convertLoadSubsetOrderBy, isAlwaysFalseFilter, serializeSoqlLiteral } from "./convertLoadSubsetOptions.js";
-import { ObjectCollectionConfig, ObjectCollectionOpts, ObjectCollectionUtils, SubscribeToSalesforceChangeEvents, objectCollectionOptions } from "./objectCollectionOptions.js";
-import { CreateSalesforceOntologyBackendOptions, createSalesforceOntologyBackend, createSalesforceOntologyBackendAdapter } from "./createSalesforceOntologyBackendAdapter.js";
+import { makeSalesforceOntologyBackend } from "./makeSalesforceOntologyBackend.js";
 import { SalesforceCodec, createSalesforceCodec } from "./salesforceCodec.js";
-export { CompiledSoqlFilter, CreateSalesforceOntologyBackendOptions, ObjectCollectionConfig, ObjectCollectionOpts, ObjectCollectionUtils, SalesforceCodec, SubscribeToSalesforceChangeEvents, buildSoqlQuery, convertLoadSubsetFilter, convertLoadSubsetOrderBy, createSalesforceCodec, createSalesforceOntologyBackend, createSalesforceOntologyBackendAdapter, isAlwaysFalseFilter, objectCollectionOptions, serializeSoqlLiteral };
+export { SalesforceCodec, createSalesforceCodec, makeSalesforceOntologyBackend };

package/lib/adapter/index.js

@@ -1,5 +1,3 @@
-import { buildSoqlQuery, convertLoadSubsetFilter, convertLoadSubsetOrderBy, isAlwaysFalseFilter, serializeSoqlLiteral } from "./convertLoadSubsetOptions.js";
-import { objectCollectionOptions } from "./objectCollectionOptions.js";
 import { createSalesforceCodec } from "./salesforceCodec.js";
-import { createSalesforceOntologyBackend, createSalesforceOntologyBackendAdapter } from "./createSalesforceOntologyBackendAdapter.js";
-export { buildSoqlQuery, convertLoadSubsetFilter, convertLoadSubsetOrderBy, createSalesforceCodec, createSalesforceOntologyBackend, createSalesforceOntologyBackendAdapter, isAlwaysFalseFilter, objectCollectionOptions, serializeSoqlLiteral };
+import { makeSalesforceOntologyBackend } from "./makeSalesforceOntologyBackend.js";
+export { createSalesforceCodec, makeSalesforceOntologyBackend };

package/lib/adapter/makeSalesforceOntologyBackend.d.ts

@@ -0,0 +1,12 @@
+import { SalesforceClient } from "@party-stack/salesforce-client";
+import { Effect } from "effect";
+import { BackendError } from "@party-stack/ontology-backend";
+import { OntologyIR } from "@party-stack/ontology-spec";
+//#region src/adapter/makeSalesforceOntologyBackend.d.ts
+export declare const makeSalesforceOntologyBackend: (opts: {
+  client: SalesforceClient;
+  ir: OntologyIR;
+  context?: Record<string, unknown>;
+}) => Effect.Effect<import("@party-stack/ontology-backend").OntologyBackendService, BackendError<"InvalidConfiguration">, never>;
+//#endregion
+//# sourceMappingURL=makeSalesforceOntologyBackend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"makeSalesforceOntologyBackend.d.ts","names":[],"sources":["../../src/adapter/makeSalesforceOntologyBackend.ts"],"mappings":";;;;;qBAoFa,gCAA6B;EAC9B,QAAA;EACJ,IAAA;EACM,UAAA;MA2KZ,OAAA,+CAAA,wBAAA"}

package/lib/adapter/makeSalesforceOntologyBackend.js

@@ -0,0 +1,186 @@
+import { getSalesforceActionMetadata } from "../actionMetadata.js";
+import { makeSalesforceBackend } from "./backend.js";
+import { createSalesforceCodec } from "./salesforceCodec.js";
+import { Effect, Redacted, Schema } from "effect";
+import { BackendError, classifyBackendFailure } from "@party-stack/ontology-backend";
+//#region src/adapter/makeSalesforceOntologyBackend.ts
+const ProviderIssue = Schema.Struct({
+	statusCode: Schema.optional(Schema.String),
+	message: Schema.optional(Schema.String),
+	fields: Schema.optional(Schema.Array(Schema.String))
+});
+const SaveResult = Schema.Struct({
+	success: Schema.Boolean,
+	id: Schema.optional(Schema.String),
+	errors: Schema.Array(ProviderIssue)
+});
+const InvocableResults = Schema.Array(Schema.Struct({
+	isSuccess: Schema.Boolean,
+	errors: Schema.optional(Schema.NullOr(Schema.Array(ProviderIssue))),
+	outputValues: Schema.optional(Schema.NullOr(Schema.Record(Schema.String, Schema.Unknown)))
+}));
+const rejected = (operation, kind, message) => new BackendError({
+	operation,
+	kind,
+	message,
+	retryable: false,
+	actionOutcome: "not-committed"
+});
+const invalidResponse = (operation, cause) => new BackendError({
+	operation,
+	kind: "InvalidResponse",
+	message: "Salesforce returned an invalid response.",
+	retryable: false,
+	actionOutcome: "unknown",
+	cause: Redacted.make(cause)
+});
+function response(schema, value, operation) {
+	try {
+		return Schema.decodeUnknownSync(schema)(value);
+	} catch (cause) {
+		throw invalidResponse(operation, cause);
+	}
+}
+function providerRejection(operation, errors) {
+	const classified = classifyBackendFailure(operation, { errorCode: errors[0]?.statusCode });
+	const kind = classified.kind === "Unavailable" ? "ValidationFailed" : classified.kind;
+	return new BackendError({
+		operation,
+		kind,
+		message: kind === "ValidationFailed" ? "Submission failed validation." : classified.message,
+		retryable: kind === "RateLimited",
+		actionOutcome: "not-committed",
+		issues: kind === "ValidationFailed" ? errors.flatMap((error) => error.message ? [{
+			message: error.message,
+			category: "custom",
+			source: "submission",
+			messageSource: "configured"
+		}] : []) : void 0,
+		cause: Redacted.make(errors)
+	});
+}
+function assertSaveSucceeded(value) {
+	const result = response(SaveResult, value, "salesforce.applyAction");
+	if (!result.success) throw providerRejection("salesforce.applyAction", result.errors);
+	return result;
+}
+function invocableResult(value, operation) {
+	const results = response(InvocableResults, value, operation);
+	if (results.length !== 1) throw invalidResponse(operation);
+	const result = results[0];
+	if (!result.isSuccess) throw providerRejection(operation, result.errors ?? []);
+	return result;
+}
+const makeSalesforceOntologyBackend = Effect.fn("Salesforce.makeBackend")(function* (opts) {
+	const context = opts.context ?? {};
+	const codec = yield* Effect.try({
+		try: () => createSalesforceCodec(opts.ir),
+		catch: (cause) => new BackendError({
+			operation: "salesforce.open",
+			kind: "InvalidConfiguration",
+			retryable: false,
+			message: "Invalid Salesforce definition.",
+			cause: Redacted.make(cause)
+		})
+	});
+	const encodeInvocableParameter = (type, value) => {
+		if (type.kind === "optional") return encodeInvocableParameter(type.value.type, value);
+		if (type.kind === "list" && Array.isArray(value)) return value.map((entry) => codec.encodeValue(type.value.elementType, entry));
+		return codec.encodeValue(type, value);
+	};
+	async function submitAction(name, parameters, client = opts.client) {
+		const actionType = opts.ir.actionTypes.find((candidate) => candidate.name === name);
+		if (!actionType) throw rejected("salesforce.applyAction", "InvalidRequest", `Unknown Salesforce action type "${name}".`);
+		const requestParameters = {};
+		try {
+			const parameterTypes = new Map(actionType.parameters.map((parameter) => [parameter.name, parameter.type]));
+			for (const [parameterName, value] of Object.entries(parameters)) {
+				if (value === void 0) continue;
+				const parameterType = parameterTypes.get(parameterName);
+				requestParameters[parameterName] = parameterType ? encodeInvocableParameter(parameterType, value) : value;
+			}
+		} catch (cause) {
+			throw new BackendError({
+				operation: "salesforce.applyAction",
+				kind: "InvalidRequest",
+				retryable: false,
+				actionOutcome: "not-committed",
+				message: "Invalid action parameters.",
+				cause: Redacted.make(cause)
+			});
+		}
+		const metadata = getSalesforceActionMetadata(actionType);
+		if (!metadata) throw rejected("salesforce.applyAction", "InvalidConfiguration", `Salesforce action type "${name}" is missing Salesforce metadata.`);
+		if (metadata.kind === "crud") {
+			if (metadata.operation === "create") {
+				const result = assertSaveSucceeded(await client.createRecord(metadata.objectType, requestParameters));
+				return {
+					affected: [{
+						objectType: metadata.objectType,
+						...result.id ? { keys: [result.id] } : {}
+					}],
+					affectedComplete: false
+				};
+			}
+			const recordId = requestParameters.recordId;
+			if (typeof recordId !== "string" || recordId.length === 0) throw rejected("salesforce.applyAction", "InvalidRequest", `Salesforce ${metadata.operation} action requires recordId.`);
+			if (metadata.operation === "update") {
+				const fields = Object.fromEntries(Object.entries(requestParameters).filter(([parameterName]) => parameterName !== "recordId"));
+				assertSaveSucceeded(await client.updateRecord(metadata.objectType, recordId, fields));
+				return {
+					affected: [{
+						objectType: metadata.objectType,
+						keys: [recordId]
+					}],
+					affectedComplete: false
+				};
+			}
+			assertSaveSucceeded(await client.deleteRecord(metadata.objectType, recordId));
+			return {
+				affected: [{
+					objectType: metadata.objectType,
+					keys: [recordId]
+				}],
+				affectedComplete: false
+			};
+		}
+		const actionApiName = metadata.apiName;
+		let results;
+		try {
+			results = metadata.kind === "standard" ? await client.invokeStandardAction(actionApiName, [requestParameters]) : await client.invokeFlowAction(actionApiName, [requestParameters]);
+		} catch (error) {
+			throw classifyBackendFailure("salesforce.applyAction", error);
+		}
+		invocableResult(results, "salesforce.applyAction");
+		return { affected: opts.ir.objectTypes.map((type) => ({ objectType: type.name })) };
+	}
+	async function runQueryFunction(name, parameters, client = opts.client) {
+		const queryFunction = opts.ir.queryFunctionTypes.find((candidate) => candidate.name === name);
+		if (!queryFunction) throw rejected("salesforce.queryFunction", "InvalidRequest", `Unknown Salesforce query function type "${name}".`);
+		const parameterTypes = new Map(queryFunction.parameters.map((parameter) => [parameter.name, parameter.type]));
+		const requestParameters = {};
+		for (const [parameterName, value] of Object.entries(parameters)) {
+			if (value === void 0) continue;
+			const parameterType = parameterTypes.get(parameterName);
+			requestParameters[parameterName] = parameterType ? encodeInvocableParameter(parameterType, value) : value;
+		}
+		const result = invocableResult(await client.invokeStandardAction(name, [requestParameters]), "salesforce.queryFunction");
+		try {
+			return codec.decodeValue(queryFunction.returnType, result.outputValues ?? {});
+		} catch (cause) {
+			throw invalidResponse("salesforce.queryFunction", cause);
+		}
+	}
+	return makeSalesforceBackend({
+		client: opts.client,
+		context,
+		ir: opts.ir,
+		decodeObject: (objectType, object) => codec.decodeObject(objectType, object),
+		submitAction,
+		runQueryFunction
+	});
+});
+//#endregion
+export { makeSalesforceOntologyBackend };
+
+//# sourceMappingURL=makeSalesforceOntologyBackend.js.map

package/lib/adapter/makeSalesforceOntologyBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeSalesforceOntologyBackend.js","names":[],"sources":["../../src/adapter/makeSalesforceOntologyBackend.ts"],"sourcesContent":["import { BackendError, classifyBackendFailure } from \"@party-stack/ontology-backend\";\nimport { type SalesforceClient } from \"@party-stack/salesforce-client\";\nimport { Effect, Redacted, Schema } from \"effect\";\nimport { getSalesforceActionMetadata } from \"../actionMetadata.js\";\nimport { makeSalesforceBackend } from \"./backend.js\";\nimport { createSalesforceCodec } from \"./salesforceCodec.js\";\nimport type { ActionReceipt } from \"@party-stack/ontology-backend\";\nimport type { OntologyIR } from \"@party-stack/ontology-spec\";\n\nconst ProviderIssue = Schema.Struct({\n    statusCode: Schema.optional(Schema.String),\n    message: Schema.optional(Schema.String),\n    fields: Schema.optional(Schema.Array(Schema.String)),\n});\nconst SaveResult = Schema.Struct({\n    success: Schema.Boolean,\n    id: Schema.optional(Schema.String),\n    errors: Schema.Array(ProviderIssue),\n});\nconst InvocableResults = Schema.Array(\n    Schema.Struct({\n        isSuccess: Schema.Boolean,\n        errors: Schema.optional(Schema.NullOr(Schema.Array(ProviderIssue))),\n        outputValues: Schema.optional(Schema.NullOr(Schema.Record(Schema.String, Schema.Unknown))),\n    })\n);\nconst rejected = (operation: string, kind: BackendError[\"kind\"], message: string) =>\n    new BackendError({ operation, kind, message, retryable: false, actionOutcome: \"not-committed\" });\nconst invalidResponse = (operation: string, cause?: unknown) =>\n    new BackendError({\n        operation,\n        kind: \"InvalidResponse\",\n        message: \"Salesforce returned an invalid response.\",\n        retryable: false,\n        actionOutcome: \"unknown\",\n        cause: Redacted.make(cause),\n    });\nfunction response<A>(schema: Schema.Decoder<A>, value: unknown, operation: string): A {\n    try {\n        return Schema.decodeUnknownSync(schema)(value);\n    } catch (cause) {\n        throw invalidResponse(operation, cause);\n    }\n}\nfunction providerRejection(operation: string, errors: readonly (typeof ProviderIssue.Type)[]): BackendError {\n    const classified = classifyBackendFailure(operation, { errorCode: errors[0]?.statusCode });\n    const kind = classified.kind === \"Unavailable\" ? \"ValidationFailed\" : classified.kind;\n    return new BackendError({\n        operation,\n        kind,\n        message: kind === \"ValidationFailed\" ? \"Submission failed validation.\" : classified.message,\n        retryable: kind === \"RateLimited\",\n        actionOutcome: \"not-committed\",\n        issues:\n            kind === \"ValidationFailed\"\n                ? errors.flatMap((error) =>\n                      error.message\n                          ? [\n                                {\n                                    message: error.message,\n                                    category: \"custom\" as const,\n                                    source: \"submission\" as const,\n                                    messageSource: \"configured\" as const,\n                                },\n                            ]\n                          : []\n                  )\n                : undefined,\n        cause: Redacted.make(errors),\n    });\n}\nfunction assertSaveSucceeded(value: unknown) {\n    const result = response(SaveResult, value, \"salesforce.applyAction\");\n    if (!result.success) throw providerRejection(\"salesforce.applyAction\", result.errors);\n    return result;\n}\nfunction invocableResult(value: unknown, operation: string) {\n    const results = response(InvocableResults, value, operation);\n    if (results.length !== 1) throw invalidResponse(operation);\n    const result = results[0]!;\n    if (!result.isSuccess) throw providerRejection(operation, result.errors ?? []);\n    return result;\n}\n\nexport const makeSalesforceOntologyBackend = Effect.fn(\"Salesforce.makeBackend\")(function* (opts: {\n    client: SalesforceClient;\n    ir: OntologyIR;\n    context?: Record<string, unknown>;\n}) {\n    const context = opts.context ?? {};\n    const codec = yield* Effect.try({\n        try: () => createSalesforceCodec(opts.ir),\n        catch: (cause) =>\n            new BackendError({\n                operation: \"salesforce.open\",\n                kind: \"InvalidConfiguration\",\n                retryable: false,\n                message: \"Invalid Salesforce definition.\",\n                cause: Redacted.make(cause),\n            }),\n    });\n    const encodeInvocableParameter = (\n        type: Parameters<typeof codec.encodeValue>[0],\n        value: unknown\n    ): unknown => {\n        if (type.kind === \"optional\") {\n            return encodeInvocableParameter(type.value.type, value);\n        }\n        if (type.kind === \"list\" && Array.isArray(value)) {\n            return value.map((entry) => codec.encodeValue(type.value.elementType, entry));\n        }\n        return codec.encodeValue(type, value);\n    };\n\n    async function submitAction(\n        name: string,\n        parameters: Record<string, unknown>,\n        client: SalesforceClient = opts.client\n    ): Promise<Pick<ActionReceipt, \"affected\" | \"affectedComplete\">> {\n        const actionType = opts.ir.actionTypes.find((candidate) => candidate.name === name);\n        if (!actionType) {\n            throw rejected(\n                \"salesforce.applyAction\",\n                \"InvalidRequest\",\n                `Unknown Salesforce action type \"${name}\".`\n            );\n        }\n\n        const requestParameters: Record<string, unknown> = {};\n        try {\n            const parameterTypes = new Map(\n                actionType.parameters.map((parameter) => [parameter.name, parameter.type])\n            );\n            for (const [parameterName, value] of Object.entries(parameters)) {\n                if (value === undefined) continue;\n                const parameterType = parameterTypes.get(parameterName);\n                requestParameters[parameterName] = parameterType\n                    ? encodeInvocableParameter(parameterType, value)\n                    : value;\n            }\n        } catch (cause) {\n            throw new BackendError({\n                operation: \"salesforce.applyAction\",\n                kind: \"InvalidRequest\",\n                retryable: false,\n                actionOutcome: \"not-committed\",\n                message: \"Invalid action parameters.\",\n                cause: Redacted.make(cause),\n            });\n        }\n\n        const metadata = getSalesforceActionMetadata(actionType);\n        if (!metadata) {\n            throw rejected(\n                \"salesforce.applyAction\",\n                \"InvalidConfiguration\",\n                `Salesforce action type \"${name}\" is missing Salesforce metadata.`\n            );\n        }\n        if (metadata.kind === \"crud\") {\n            if (metadata.operation === \"create\") {\n                const result = assertSaveSucceeded(\n                    await client.createRecord(metadata.objectType, requestParameters)\n                );\n                return {\n                    affected: [\n                        { objectType: metadata.objectType, ...(result.id ? { keys: [result.id] } : {}) },\n                    ],\n                    affectedComplete: false,\n                };\n            }\n            const recordId = requestParameters.recordId;\n            if (typeof recordId !== \"string\" || recordId.length === 0) {\n                throw rejected(\n                    \"salesforce.applyAction\",\n                    \"InvalidRequest\",\n                    `Salesforce ${metadata.operation} action requires recordId.`\n                );\n            }\n            if (metadata.operation === \"update\") {\n                const fields = Object.fromEntries(\n                    Object.entries(requestParameters).filter(\n                        ([parameterName]) => parameterName !== \"recordId\"\n                    )\n                );\n                const result = await client.updateRecord(metadata.objectType, recordId, fields);\n                assertSaveSucceeded(result);\n                return {\n                    affected: [{ objectType: metadata.objectType, keys: [recordId] }],\n                    affectedComplete: false,\n                };\n            }\n            assertSaveSucceeded(await client.deleteRecord(metadata.objectType, recordId));\n            return {\n                affected: [{ objectType: metadata.objectType, keys: [recordId] }],\n                affectedComplete: false,\n            };\n        }\n\n        const actionApiName = metadata.apiName;\n\n        let results;\n        try {\n            results =\n                metadata.kind === \"standard\"\n                    ? await client.invokeStandardAction(actionApiName, [requestParameters])\n                    : await client.invokeFlowAction(actionApiName, [requestParameters]);\n        } catch (error) {\n            throw classifyBackendFailure(\"salesforce.applyAction\", error);\n        }\n\n        invocableResult(results, \"salesforce.applyAction\");\n\n        // Flows and standard actions can modify records outside their inputs.\n        return { affected: opts.ir.objectTypes.map((type) => ({ objectType: type.name })) };\n    }\n\n    async function runQueryFunction(\n        name: string,\n        parameters: Record<string, unknown>,\n        client: SalesforceClient = opts.client\n    ): Promise<unknown> {\n        const queryFunction = opts.ir.queryFunctionTypes.find((candidate) => candidate.name === name);\n        if (!queryFunction) {\n            throw rejected(\n                \"salesforce.queryFunction\",\n                \"InvalidRequest\",\n                `Unknown Salesforce query function type \"${name}\".`\n            );\n        }\n        const parameterTypes = new Map(\n            queryFunction.parameters.map((parameter) => [parameter.name, parameter.type])\n        );\n        const requestParameters: Record<string, unknown> = {};\n        for (const [parameterName, value] of Object.entries(parameters)) {\n            if (value === undefined) continue;\n            const parameterType = parameterTypes.get(parameterName);\n            requestParameters[parameterName] = parameterType\n                ? encodeInvocableParameter(parameterType, value)\n                : value;\n        }\n        const results = await client.invokeStandardAction(name, [requestParameters]);\n        const result = invocableResult(results, \"salesforce.queryFunction\");\n        try {\n            return codec.decodeValue(queryFunction.returnType, result.outputValues ?? {});\n        } catch (cause) {\n            throw invalidResponse(\"salesforce.queryFunction\", cause);\n        }\n    }\n\n    return makeSalesforceBackend({\n        client: opts.client,\n        context,\n        ir: opts.ir,\n        decodeObject: (objectType, object) => codec.decodeObject(objectType, object),\n        submitAction,\n        runQueryFunction,\n    });\n});\n"],"mappings":"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"}

package/lib/adapter/salesforceCodec.d.ts

@@ -1,4 +1,4 @@
-import { OntologyIR, TypeDef } from "@party-stack/ontology";
+import { OntologyIR, TypeDef } from "@party-stack/ontology-spec";
 //#region src/adapter/salesforceCodec.d.ts
 type SalesforceObjectRecord = Record<string, unknown>;
 export interface SalesforceCodec {

package/lib/adapter/salesforceCodec.js.map

@@ -1 +1 @@
-{"version":3,"file":"salesforceCodec.js","names":[],"sources":["../../src/adapter/salesforceCodec.ts"],"sourcesContent":["import { Temporal } from \"temporal-polyfill\";\nimport type { ObjectTypeDef, OntologyIR, TypeDef } from \"@party-stack/ontology\";\n\ntype SalesforceObjectRecord = Record<string, unknown>;\n\nexport interface SalesforceCodec {\n    decodeObject: (objectType: string, object: SalesforceObjectRecord) => SalesforceObjectRecord;\n    decodeValue: (type: TypeDef, value: unknown) => unknown;\n    encodeValue: (type: TypeDef, value: unknown) => unknown;\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n    return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction stripAttributes(object: SalesforceObjectRecord): SalesforceObjectRecord {\n    const { attributes, ...rest } = object;\n    void attributes;\n    return rest;\n}\n\nexport function createSalesforceCodec(ir: OntologyIR): SalesforceCodec {\n    const objectTypes = new Map(ir.objectTypes.map((objectType) => [objectType.name, objectType]));\n    const namedTypes = new Map(ir.types.map((type) => [type.name, type.type]));\n\n    const resolveType = (type: TypeDef, seen = new Set<string>()): TypeDef => {\n        if (type.kind !== \"ref\") {\n            return type;\n        }\n\n        const name = type.value.name;\n        if (seen.has(name)) {\n            throw new Error(`Circular ontology type reference \"${name}\".`);\n        }\n\n        const resolved = namedTypes.get(name);\n        if (!resolved) {\n            throw new Error(`Unknown ontology type reference \"${name}\".`);\n        }\n\n        return resolveType(resolved, new Set([...seen, name]));\n    };\n\n    const decodeValue = (type: TypeDef, value: unknown): unknown => {\n        const resolvedType = resolveType(type);\n\n        if (value === undefined || value === null) {\n            if (resolvedType.kind === \"optional\") {\n                return undefined;\n            }\n            return value;\n        }\n\n        switch (resolvedType.kind) {\n            case \"string\":\n                return value;\n            case \"boolean\":\n                return typeof value === \"string\" ? value === \"true\" : value;\n            case \"integer\":\n            case \"float\":\n            case \"double\":\n                return typeof value === \"string\" ? Number(value) : value;\n            case \"date\":\n                return typeof value === \"string\" ? Temporal.PlainDate.from(value) : value;\n            case \"timestamp\":\n                if (typeof value === \"string\") {\n                    // Salesforce datetime wire format is typically ISO-8601.\n                    return Temporal.Instant.from(\n                        value.endsWith(\"Z\") || value.includes(\"+\") ? value : `${value}Z`\n                    );\n                }\n                if (typeof value === \"number\") return Temporal.Instant.fromEpochMilliseconds(value);\n                return value;\n            case \"geopoint\":\n                return decodeGeoPoint(value);\n            case \"objectReference\":\n                return value;\n            case \"list\":\n                if (typeof value === \"string\") {\n                    // Multipicklist values are semicolon-delimited.\n                    return value\n                        .split(\";\")\n                        .filter((entry) => entry.length > 0)\n                        .map((item) => decodeValue(resolvedType.value.elementType, item));\n                }\n                return Array.isArray(value)\n                    ? value.map((item) => decodeValue(resolvedType.value.elementType, item))\n                    : value;\n            case \"map\":\n                if (!isPlainObject(value)) {\n                    return value;\n                }\n                return Object.fromEntries(\n                    Object.entries(value).map(([key, entryValue]) => [\n                        decodeValue(resolvedType.value.keyType, key),\n                        decodeValue(resolvedType.value.valueType, entryValue),\n                    ])\n                );\n            case \"struct\":\n                if (!isPlainObject(value)) {\n                    return value;\n                }\n                return Object.fromEntries(\n                    Object.entries(stripAttributes(value)).map(([key, entryValue]) => {\n                        const field = resolvedType.value.fields.find((candidate) => candidate.name === key);\n                        return [key, field ? decodeValue(field.type, entryValue) : entryValue];\n                    })\n                );\n            case \"optional\":\n                return decodeValue(resolvedType.value.type, value);\n            case \"attachment\":\n            case \"union\":\n            case \"result\":\n            case \"unknown\":\n                return value;\n            case \"ref\":\n                return decodeValue(resolveType(resolvedType), value);\n        }\n    };\n\n    const encodeValue = (type: TypeDef, value: unknown): unknown => {\n        const resolvedType = resolveType(type);\n\n        if (value === undefined || value === null) {\n            return null;\n        }\n\n        switch (resolvedType.kind) {\n            case \"string\":\n            case \"boolean\":\n            case \"integer\":\n            case \"float\":\n            case \"double\":\n            case \"objectReference\":\n            case \"unknown\":\n                return value;\n            case \"date\":\n                if (value instanceof Temporal.PlainDate) return value.toString();\n                if (value instanceof Date) return value.toISOString().slice(0, 10);\n                return value;\n            case \"timestamp\":\n                if (value instanceof Temporal.Instant) return value.toString();\n                if (value instanceof Date) return value.toISOString();\n                return value;\n            case \"geopoint\":\n                return encodeGeoPoint(value);\n            case \"list\":\n                if (!Array.isArray(value)) return value;\n                // Multipicklist wire format uses semicolon delimiters for string lists.\n                if (resolvedType.value.elementType.kind === \"string\") {\n                    return value\n                        .map((item) => encodeValue(resolvedType.value.elementType, item))\n                        .filter((item): item is string | number | boolean => {\n                            return (\n                                typeof item === \"string\" ||\n                                typeof item === \"number\" ||\n                                typeof item === \"boolean\"\n                            );\n                        })\n                        .join(\";\");\n                }\n                return value.map((item) => encodeValue(resolvedType.value.elementType, item));\n            case \"map\":\n                if (!isPlainObject(value)) return value;\n                return Object.fromEntries(\n                    Object.entries(value).map(([key, entryValue]) => [\n                        encodeValue(resolvedType.value.keyType, key),\n                        encodeValue(resolvedType.value.valueType, entryValue),\n                    ])\n                );\n            case \"struct\":\n                if (!isPlainObject(value)) return value;\n                return Object.fromEntries(\n                    Object.entries(value).map(([key, entryValue]) => {\n                        const field = resolvedType.value.fields.find((candidate) => candidate.name === key);\n                        return [key, field ? encodeValue(field.type, entryValue) : entryValue];\n                    })\n                );\n            case \"optional\":\n                return encodeValue(resolvedType.value.type, value);\n            case \"attachment\":\n            case \"union\":\n            case \"result\":\n                return value;\n            case \"ref\":\n                return encodeValue(resolveType(resolvedType), value);\n        }\n    };\n\n    const decodeObjectType = (\n        objectType: ObjectTypeDef,\n        object: SalesforceObjectRecord\n    ): SalesforceObjectRecord => {\n        const cleaned = stripAttributes(object);\n        return Object.fromEntries(\n            objectType.properties.map((property) => [\n                property.name,\n                decodeValue(property.type, cleaned[property.name]),\n            ])\n        );\n    };\n\n    return {\n        decodeObject: (objectTypeName, object) => {\n            const objectType = objectTypes.get(objectTypeName);\n            if (!objectType) {\n                throw new Error(`Unknown object type \"${objectTypeName}\".`);\n            }\n            return decodeObjectType(objectType, object);\n        },\n        decodeValue,\n        encodeValue,\n    };\n}\n\nfunction decodeGeoPoint(value: unknown): unknown {\n    if (isPlainObject(value)) {\n        const lat = value.latitude ?? value.lat;\n        const lon = value.longitude ?? value.lon;\n        if (typeof lat === \"number\" && typeof lon === \"number\") {\n            return { lat, lon };\n        }\n    }\n    return value;\n}\n\nfunction encodeGeoPoint(value: unknown): unknown {\n    if (isPlainObject(value) && typeof value.lat === \"number\" && typeof value.lon === \"number\") {\n        return {\n            latitude: value.lat,\n            longitude: value.lon,\n        };\n    }\n    return value;\n}\n"],"mappings":"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"}
+{"version":3,"file":"salesforceCodec.js","names":[],"sources":["../../src/adapter/salesforceCodec.ts"],"sourcesContent":["import { Temporal } from \"temporal-polyfill\";\nimport type { ObjectTypeDef, OntologyIR, TypeDef } from \"@party-stack/ontology-spec\";\n\ntype SalesforceObjectRecord = Record<string, unknown>;\n\nexport interface SalesforceCodec {\n    decodeObject: (objectType: string, object: SalesforceObjectRecord) => SalesforceObjectRecord;\n    decodeValue: (type: TypeDef, value: unknown) => unknown;\n    encodeValue: (type: TypeDef, value: unknown) => unknown;\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n    return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction stripAttributes(object: SalesforceObjectRecord): SalesforceObjectRecord {\n    const { attributes, ...rest } = object;\n    void attributes;\n    return rest;\n}\n\nexport function createSalesforceCodec(ir: OntologyIR): SalesforceCodec {\n    const objectTypes = new Map(ir.objectTypes.map((objectType) => [objectType.name, objectType]));\n    const namedTypes = new Map(ir.types.map((type) => [type.name, type.type]));\n\n    const resolveType = (type: TypeDef, seen = new Set<string>()): TypeDef => {\n        if (type.kind !== \"ref\") {\n            return type;\n        }\n\n        const name = type.value.name;\n        if (seen.has(name)) {\n            throw new Error(`Circular ontology type reference \"${name}\".`);\n        }\n\n        const resolved = namedTypes.get(name);\n        if (!resolved) {\n            throw new Error(`Unknown ontology type reference \"${name}\".`);\n        }\n\n        return resolveType(resolved, new Set([...seen, name]));\n    };\n\n    const decodeValue = (type: TypeDef, value: unknown): unknown => {\n        const resolvedType = resolveType(type);\n\n        if (value === undefined || value === null) {\n            if (resolvedType.kind === \"optional\") {\n                return undefined;\n            }\n            return value;\n        }\n\n        switch (resolvedType.kind) {\n            case \"string\":\n                return value;\n            case \"boolean\":\n                return typeof value === \"string\" ? value === \"true\" : value;\n            case \"integer\":\n            case \"float\":\n            case \"double\":\n                return typeof value === \"string\" ? Number(value) : value;\n            case \"date\":\n                return typeof value === \"string\" ? Temporal.PlainDate.from(value) : value;\n            case \"timestamp\":\n                if (typeof value === \"string\") {\n                    // Salesforce datetime wire format is typically ISO-8601.\n                    return Temporal.Instant.from(\n                        value.endsWith(\"Z\") || value.includes(\"+\") ? value : `${value}Z`\n                    );\n                }\n                if (typeof value === \"number\") return Temporal.Instant.fromEpochMilliseconds(value);\n                return value;\n            case \"geopoint\":\n                return decodeGeoPoint(value);\n            case \"objectReference\":\n                return value;\n            case \"list\":\n                if (typeof value === \"string\") {\n                    // Multipicklist values are semicolon-delimited.\n                    return value\n                        .split(\";\")\n                        .filter((entry) => entry.length > 0)\n                        .map((item) => decodeValue(resolvedType.value.elementType, item));\n                }\n                return Array.isArray(value)\n                    ? value.map((item) => decodeValue(resolvedType.value.elementType, item))\n                    : value;\n            case \"map\":\n                if (!isPlainObject(value)) {\n                    return value;\n                }\n                return Object.fromEntries(\n                    Object.entries(value).map(([key, entryValue]) => [\n                        decodeValue(resolvedType.value.keyType, key),\n                        decodeValue(resolvedType.value.valueType, entryValue),\n                    ])\n                );\n            case \"struct\":\n                if (!isPlainObject(value)) {\n                    return value;\n                }\n                return Object.fromEntries(\n                    Object.entries(stripAttributes(value)).map(([key, entryValue]) => {\n                        const field = resolvedType.value.fields.find((candidate) => candidate.name === key);\n                        return [key, field ? decodeValue(field.type, entryValue) : entryValue];\n                    })\n                );\n            case \"optional\":\n                return decodeValue(resolvedType.value.type, value);\n            case \"attachment\":\n            case \"union\":\n            case \"result\":\n            case \"unknown\":\n                return value;\n            case \"ref\":\n                return decodeValue(resolveType(resolvedType), value);\n        }\n    };\n\n    const encodeValue = (type: TypeDef, value: unknown): unknown => {\n        const resolvedType = resolveType(type);\n\n        if (value === undefined || value === null) {\n            return null;\n        }\n\n        switch (resolvedType.kind) {\n            case \"string\":\n            case \"boolean\":\n            case \"integer\":\n            case \"float\":\n            case \"double\":\n            case \"objectReference\":\n            case \"unknown\":\n                return value;\n            case \"date\":\n                if (value instanceof Temporal.PlainDate) return value.toString();\n                if (value instanceof Date) return value.toISOString().slice(0, 10);\n                return value;\n            case \"timestamp\":\n                if (value instanceof Temporal.Instant) return value.toString();\n                if (value instanceof Date) return value.toISOString();\n                return value;\n            case \"geopoint\":\n                return encodeGeoPoint(value);\n            case \"list\":\n                if (!Array.isArray(value)) return value;\n                // Multipicklist wire format uses semicolon delimiters for string lists.\n                if (resolvedType.value.elementType.kind === \"string\") {\n                    return value\n                        .map((item) => encodeValue(resolvedType.value.elementType, item))\n                        .filter((item): item is string | number | boolean => {\n                            return (\n                                typeof item === \"string\" ||\n                                typeof item === \"number\" ||\n                                typeof item === \"boolean\"\n                            );\n                        })\n                        .join(\";\");\n                }\n                return value.map((item) => encodeValue(resolvedType.value.elementType, item));\n            case \"map\":\n                if (!isPlainObject(value)) return value;\n                return Object.fromEntries(\n                    Object.entries(value).map(([key, entryValue]) => [\n                        encodeValue(resolvedType.value.keyType, key),\n                        encodeValue(resolvedType.value.valueType, entryValue),\n                    ])\n                );\n            case \"struct\":\n                if (!isPlainObject(value)) return value;\n                return Object.fromEntries(\n                    Object.entries(value).map(([key, entryValue]) => {\n                        const field = resolvedType.value.fields.find((candidate) => candidate.name === key);\n                        return [key, field ? encodeValue(field.type, entryValue) : entryValue];\n                    })\n                );\n            case \"optional\":\n                return encodeValue(resolvedType.value.type, value);\n            case \"attachment\":\n            case \"union\":\n            case \"result\":\n                return value;\n            case \"ref\":\n                return encodeValue(resolveType(resolvedType), value);\n        }\n    };\n\n    const decodeObjectType = (\n        objectType: ObjectTypeDef,\n        object: SalesforceObjectRecord\n    ): SalesforceObjectRecord => {\n        const cleaned = stripAttributes(object);\n        return Object.fromEntries(\n            objectType.properties.map((property) => [\n                property.name,\n                decodeValue(property.type, cleaned[property.name]),\n            ])\n        );\n    };\n\n    return {\n        decodeObject: (objectTypeName, object) => {\n            const objectType = objectTypes.get(objectTypeName);\n            if (!objectType) {\n                throw new Error(`Unknown object type \"${objectTypeName}\".`);\n            }\n            return decodeObjectType(objectType, object);\n        },\n        decodeValue,\n        encodeValue,\n    };\n}\n\nfunction decodeGeoPoint(value: unknown): unknown {\n    if (isPlainObject(value)) {\n        const lat = value.latitude ?? value.lat;\n        const lon = value.longitude ?? value.lon;\n        if (typeof lat === \"number\" && typeof lon === \"number\") {\n            return { lat, lon };\n        }\n    }\n    return value;\n}\n\nfunction encodeGeoPoint(value: unknown): unknown {\n    if (isPlainObject(value) && typeof value.lat === \"number\" && typeof value.lon === \"number\") {\n        return {\n            latitude: value.lat,\n            longitude: value.lon,\n        };\n    }\n    return value;\n}\n"],"mappings":"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"}