updated file naming semantics

simstudioai · waleedlatif1 · Apr 7, 2026 · Apr 6, 2026 · Apr 6, 2026 · Apr 6, 2026
commit d3fcf04958a02f04a5356a426dc2a7281df007d1
diff --git a/.agents/skills/add-trigger/SKILL.md b/.agents/skills/add-trigger/SKILL.md
@@ -24,12 +24,13 @@ apps/sim/triggers/{service}/
 ├── {event_b}.ts          # Secondary trigger (no dropdown)
 └── webhook.ts            # Generic webhook trigger (optional, for "all events")
 
-apps/sim/lib/webhooks/providers/
-├── {service}.ts           # Provider handler (auth, formatInput, matchEvent, subscriptions)
-├── types.ts               # WebhookProviderHandler interface
-├── utils.ts               # Shared helpers (createHmacVerifier, verifyTokenAuth, skipByEventTypes)
-├── subscription-utils.ts  # Shared subscription helpers (getProviderConfig, getNotificationUrl)
-└── registry.ts            # Handler map + default handler
+apps/sim/lib/webhooks/
+├── provider-subscription-utils.ts  # Shared subscription helpers (getProviderConfig, getNotificationUrl)
+├── providers/
+│   ├── {service}.ts       # Provider handler (auth, formatInput, matchEvent, subscriptions)
+│   ├── types.ts           # WebhookProviderHandler interface
+│   ├── utils.ts           # Shared helpers (createHmacVerifier, verifyTokenAuth, skipByEventTypes)
+│   └── registry.ts        # Handler map + default handler
 ```
 
 ## Step 1: Create `utils.ts`
@@ -267,7 +268,7 @@ If they differ: the tag dropdown shows fields that don't exist, or actual data h
 If the service API supports programmatic webhook creation, implement `createSubscription` and `deleteSubscription` on the handler. The orchestration layer calls these automatically — **no code touches `route.ts`, `provider-subscriptions.ts`, or `deploy.ts`**.
 
 ```typescript
-import { getNotificationUrl, getProviderConfig } from '@/lib/webhooks/providers/subscription-utils'
+import { getNotificationUrl, getProviderConfig } from '@/lib/webhooks/provider-subscription-utils'
 import type { DeleteSubscriptionContext, SubscriptionContext, SubscriptionResult } from '@/lib/webhooks/providers/types'
 
 export const {service}Handler: WebhookProviderHandler = {

diff --git a/.agents/skills/validate-trigger/SKILL.md b/.agents/skills/validate-trigger/SKILL.md
@@ -31,7 +31,7 @@ Also read for reference:
 ```
 apps/sim/lib/webhooks/providers/types.ts            # WebhookProviderHandler interface
 apps/sim/lib/webhooks/providers/utils.ts            # Shared helpers (createHmacVerifier, etc.)
-apps/sim/lib/webhooks/providers/subscription-utils.ts  # Subscription helpers
+apps/sim/lib/webhooks/provider-subscription-utils.ts    # Subscription helpers
 apps/sim/lib/webhooks/processor.ts                  # Central webhook processor
 ```
 

diff --git a/.claude/commands/add-trigger.md b/.claude/commands/add-trigger.md
@@ -24,12 +24,13 @@ apps/sim/triggers/{service}/
 ├── {event_b}.ts          # Secondary trigger (no dropdown)
 └── webhook.ts            # Generic webhook trigger (optional, for "all events")
 
-apps/sim/lib/webhooks/providers/
-├── {service}.ts           # Provider handler (auth, formatInput, matchEvent, subscriptions)
-├── types.ts               # WebhookProviderHandler interface
-├── utils.ts               # Shared helpers (createHmacVerifier, verifyTokenAuth, skipByEventTypes)
-├── subscription-utils.ts  # Shared subscription helpers (getProviderConfig, getNotificationUrl)
-└── registry.ts            # Handler map + default handler
+apps/sim/lib/webhooks/
+├── provider-subscription-utils.ts  # Shared subscription helpers (getProviderConfig, getNotificationUrl)
+├── providers/
+│   ├── {service}.ts       # Provider handler (auth, formatInput, matchEvent, subscriptions)
+│   ├── types.ts           # WebhookProviderHandler interface
+│   ├── utils.ts           # Shared helpers (createHmacVerifier, verifyTokenAuth, skipByEventTypes)
+│   └── registry.ts        # Handler map + default handler
 ```
 
 ## Step 1: Create `utils.ts`
@@ -267,7 +268,7 @@ If they differ: the tag dropdown shows fields that don't exist, or actual data h
 If the service API supports programmatic webhook creation, implement `createSubscription` and `deleteSubscription` on the handler. The orchestration layer calls these automatically — **no code touches `route.ts`, `provider-subscriptions.ts`, or `deploy.ts`**.
 
 ```typescript
-import { getNotificationUrl, getProviderConfig } from '@/lib/webhooks/providers/subscription-utils'
+import { getNotificationUrl, getProviderConfig } from '@/lib/webhooks/provider-subscription-utils'
 import type { DeleteSubscriptionContext, SubscriptionContext, SubscriptionResult } from '@/lib/webhooks/providers/types'
 
 export const {service}Handler: WebhookProviderHandler = {

diff --git a/.claude/commands/validate-trigger.md b/.claude/commands/validate-trigger.md
@@ -31,7 +31,7 @@ Also read for reference:
 ```
 apps/sim/lib/webhooks/providers/types.ts            # WebhookProviderHandler interface
 apps/sim/lib/webhooks/providers/utils.ts            # Shared helpers (createHmacVerifier, etc.)
-apps/sim/lib/webhooks/providers/subscription-utils.ts  # Subscription helpers
+apps/sim/lib/webhooks/provider-subscription-utils.ts    # Subscription helpers
 apps/sim/lib/webhooks/processor.ts                  # Central webhook processor
 ```
 

diff --git a/apps/sim/lib/webhooks/providers/salesforce.ts b/apps/sim/lib/webhooks/providers/salesforce.ts
@@ -9,7 +9,37 @@ import type {
   WebhookProviderHandler,
 } from '@/lib/webhooks/providers/types'
 import { verifyTokenAuth } from '@/lib/webhooks/providers/utils'
-import { extractSalesforceObjectTypeFromPayload } from '@/lib/webhooks/salesforce-payload-utils'
+
+export function extractSalesforceObjectTypeFromPayload(
+  body: Record<string, unknown>
+): string | undefined {
+  const direct =
+    (typeof body.objectType === 'string' && body.objectType) ||
+    (typeof body.sobjectType === 'string' && body.sobjectType) ||
+    undefined
+  if (direct) {
+    return direct
+  }
+
+  const attrs = body.attributes as Record<string, unknown> | undefined
+  if (typeof attrs?.type === 'string') {
+    return attrs.type
+  }
+
+  const record = body.record
+  if (record && typeof record === 'object' && !Array.isArray(record)) {
+    const r = record as Record<string, unknown>
+    if (typeof r.sobjectType === 'string') {
+      return r.sobjectType
+    }
+    const ra = r.attributes as Record<string, unknown> | undefined
+    if (typeof ra?.type === 'string') {
+      return ra.type
+    }
+  }
+
+  return undefined
+}
 
 const logger = createLogger('WebhookProvider:Salesforce')
 

diff --git a/apps/sim/lib/webhooks/providers/types.ts b/apps/sim/lib/webhooks/providers/types.ts
@@ -115,10 +115,10 @@ export interface WebhookProviderHandler {
   /** Custom error response when queuing fails. Return null for default 500. */
   formatQueueErrorResponse?(): NextResponse | null
 
-  /** Custom input preparation. Replaces the standard `formatWebhookInput` call when defined. */
+  /** Custom input preparation. When defined, replaces the default pass-through of the raw body. */
   formatInput?(ctx: FormatInputContext): Promise<FormatInputResult>
 
-  /** Called when standard `formatWebhookInput` returns null. Return skip message or null to proceed. */
+  /** Called when input is null after formatting. Return skip message or null to proceed. */
   handleEmptyInput?(requestId: string): { message: string } | null
 
   /** Post-process input to handle file uploads before execution. */

diff --git a/apps/sim/lib/webhooks/salesforce-payload-utils.ts b/apps/sim/lib/webhooks/salesforce-payload-utils.ts
diff --git a/apps/sim/triggers/salesforce/utils.ts b/apps/sim/triggers/salesforce/utils.ts
@@ -1,4 +1,4 @@
-import { extractSalesforceObjectTypeFromPayload } from '@/lib/webhooks/salesforce-payload-utils'
+import { extractSalesforceObjectTypeFromPayload } from '@/lib/webhooks/providers/salesforce'
 import type { SubBlockConfig } from '@/blocks/types'
 import type { TriggerOutput } from '@/triggers/types'