@salesforce/afv-skills 1.29.0 → 1.30.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -0
- package/package.json +1 -1
- package/skills/agentforce-architecture-analyze/README.md +2 -8
- package/skills/agentforce-architecture-analyze/SKILL.md +2 -2
- package/skills/agentforce-architecture-analyze/references/contract.json +4 -4
- package/skills/agentforce-architecture-analyze/references/soql_fields.md +1 -1
- package/skills/data360-activate/README.md +0 -1
- package/skills/data360-activate/SKILL.md +0 -2
- package/skills/data360-connect/README.md +0 -2
- package/skills/data360-connect/SKILL.md +0 -2
- package/skills/data360-harmonize/SKILL.md +0 -1
- package/skills/data360-orchestrate/README.md +0 -7
- package/skills/data360-orchestrate/SKILL.md +0 -2
- package/skills/data360-prepare/README.md +0 -1
- package/skills/data360-prepare/SKILL.md +0 -1
- package/skills/data360-query/README.md +0 -1
- package/skills/data360-query/SKILL.md +0 -1
- package/skills/data360-segment/README.md +0 -1
- package/skills/data360-segment/SKILL.md +0 -2
- package/skills/experience-cms-brand-apply/SKILL.md +47 -16
- package/skills/experience-lwc-generate/README.md +3 -2
- package/skills/experience-lwc-generate/references/async-notification-patterns.md +1 -1
- package/skills/experience-lwc-generate/references/component-patterns.md +3 -3
- package/skills/experience-lwc-generate/references/flow-integration-guide.md +1 -1
- package/skills/experience-lwc-generate/references/lwc-best-practices.md +4 -4
- package/skills/experience-lwc-generate/references/scoring-and-testing.md +1 -1
- package/skills/experience-lwc-generate/references/state-management.md +2 -2
- package/skills/experience-lwc-generate/references/triangle-pattern.md +3 -3
- package/skills/experience-lwc-generate/scripts/post-tool-validate.py +2 -2
- package/skills/experience-lwc-generate/scripts/template_validator.py +1 -1
- package/skills/external-diagram-mermaid-generate/README.md +2 -2
- package/skills/external-diagram-mermaid-generate/SKILL.md +1 -3
- package/skills/external-diagram-mermaid-generate/assets/agentforce/agent-flow.md +4 -4
- package/skills/external-diagram-mermaid-generate/assets/architecture/system-landscape.md +1 -1
- package/skills/external-diagram-mermaid-generate/assets/datamodel/b2b-commerce-erd.md +3 -3
- package/skills/external-diagram-mermaid-generate/assets/datamodel/campaigns-erd.md +1 -1
- package/skills/external-diagram-mermaid-generate/assets/datamodel/consent-erd.md +2 -2
- package/skills/external-diagram-mermaid-generate/assets/datamodel/files-erd.md +2 -2
- package/skills/external-diagram-mermaid-generate/assets/datamodel/forecasting-erd.md +2 -2
- package/skills/external-diagram-mermaid-generate/assets/datamodel/fsl-erd.md +2 -2
- package/skills/external-diagram-mermaid-generate/assets/datamodel/party-model-erd.md +1 -1
- package/skills/external-diagram-mermaid-generate/assets/datamodel/quote-order-erd.md +3 -3
- package/skills/external-diagram-mermaid-generate/assets/datamodel/revenue-cloud-erd.md +2 -2
- package/skills/external-diagram-mermaid-generate/assets/datamodel/sales-cloud-erd.md +1 -1
- package/skills/external-diagram-mermaid-generate/assets/datamodel/salesforce-erd.md +1 -1
- package/skills/external-diagram-mermaid-generate/assets/datamodel/scheduler-erd.md +2 -2
- package/skills/external-diagram-mermaid-generate/assets/datamodel/service-cloud-erd.md +3 -3
- package/skills/external-diagram-mermaid-generate/assets/datamodel/territory-management-erd.md +1 -1
- package/skills/external-diagram-mermaid-generate/assets/integration/api-sequence.md +1 -1
- package/skills/external-diagram-mermaid-generate/assets/oauth/authorization-code-pkce.md +1 -1
- package/skills/external-diagram-mermaid-generate/assets/oauth/authorization-code.md +1 -1
- package/skills/external-diagram-mermaid-generate/assets/oauth/client-credentials.md +1 -1
- package/skills/external-diagram-mermaid-generate/assets/oauth/device-authorization.md +2 -2
- package/skills/external-diagram-mermaid-generate/assets/oauth/jwt-bearer.md +2 -2
- package/skills/external-diagram-mermaid-generate/assets/oauth/refresh-token.md +1 -1
- package/skills/external-diagram-mermaid-generate/assets/oauth/user-agent-social-sign-on.md +2 -2
- package/skills/external-diagram-mermaid-generate/assets/role-hierarchy/user-hierarchy.md +1 -1
- package/skills/external-diagram-mermaid-generate/references/color-palette.md +13 -13
- package/skills/external-diagram-mermaid-generate/references/diagram-conventions.md +5 -5
- package/skills/external-diagram-mermaid-generate/references/erd-conventions.md +1 -1
- package/skills/external-diagram-mermaid-generate/references/mermaid-styling.md +2 -2
- package/skills/external-diagram-mermaid-generate/references/preview-guide.md +1 -1
- package/skills/external-diagram-mermaid-generate/references/usage-examples.md +9 -9
- package/skills/external-diagram-mermaid-generate/scripts/README.md +1 -1
- package/skills/integration-connectivity-connected-app-configure/README.md +4 -5
- package/skills/integration-connectivity-connected-app-configure/SKILL.md +2 -2
- package/skills/integration-connectivity-connected-app-configure/references/example-usage.md +7 -7
- package/skills/integration-connectivity-connected-app-configure/references/migration-guide.md +1 -1
- package/skills/integration-connectivity-connected-app-configure/references/oauth-flows-reference.md +1 -1
- package/skills/integration-connectivity-connected-app-configure/references/testing-validation-guide.md +3 -3
- package/skills/integration-connectivity-generate/README.md +1 -1
- package/skills/integration-connectivity-generate/SKILL.md +6 -0
- package/skills/integration-connectivity-generate/assets/callouts/rest-queueable-callout.cls +1 -1
- package/skills/integration-connectivity-generate/assets/external-services/external-service-operations.md +1 -1
- package/skills/integration-connectivity-generate/assets/soap/wsdl2apex-guide.md +1 -1
- package/skills/integration-connectivity-generate/references/callout-patterns.md +4 -0
- package/skills/integration-connectivity-generate/references/cdc-guide.md +2 -2
- package/skills/integration-connectivity-generate/references/event-driven-architecture-guide.md +5 -5
- package/skills/integration-connectivity-generate/references/event-patterns.md +3 -2
- package/skills/integration-connectivity-generate/references/external-services-guide.md +4 -1
- package/skills/integration-connectivity-generate/references/messaging-api-v2.md +2 -2
- package/skills/integration-connectivity-generate/references/named-credentials-automation.md +1 -1
- package/skills/integration-connectivity-generate/references/named-credentials-guide.md +12 -2
- package/skills/integration-connectivity-generate/references/platform-events-guide.md +3 -3
- package/skills/integration-connectivity-generate/references/rest-callout-patterns.md +1 -1
- package/skills/integration-connectivity-generate/references/scoring-rubric.md +1 -1
- package/skills/integration-connectivity-generate/references/security-best-practices.md +5 -2
- package/skills/integration-connectivity-generate/scripts/configure-named-credential.sh +16 -5
- package/skills/integration-connectivity-generate/scripts/set-api-credential.sh +11 -2
- package/skills/integration-connectivity-generate/scripts/suggest_credential_setup.py +4 -3
- package/skills/integration-connectivity-generate/scripts/validate_integration.py +1 -1
- package/skills/omnistudio-callable-apex-generate/README.md +1 -5
- package/skills/omnistudio-callable-apex-generate/SKILL.md +14 -4
- package/skills/omnistudio-callable-apex-generate/assets/pattern_callable_vanilla.cls +8 -1
- package/skills/omnistudio-callable-apex-generate/examples/Test_VlocityOpenInterface2Conversion/TRANSCRIPT.md +1 -1
- package/skills/omnistudio-callable-apex-generate/examples/Test_VlocityOpenInterfaceConversion/TRANSCRIPT.md +1 -1
- package/skills/omnistudio-datamapper-generate/SKILL.md +1 -1
- package/skills/omnistudio-datamapper-generate/assets/completion-summary-template.md +2 -2
- package/skills/omnistudio-datamapper-generate/references/best-practices.md +9 -9
- package/skills/omnistudio-datamapper-generate/references/naming-conventions.md +6 -6
- package/skills/omnistudio-datapacks-deploy/README.md +1 -1
- package/skills/omnistudio-datapacks-deploy/examples/business-internet-plus-bundle/deploy-business-internet-plus-bundle.yaml +1 -1
- package/skills/omnistudio-dependencies-analyze/SKILL.md +12 -5
- package/skills/omnistudio-dependencies-analyze/references/dependency-patterns.md +9 -9
- package/skills/omnistudio-dependencies-analyze/references/namespace-guide.md +1 -1
- package/skills/omnistudio-epc-catalog-generate/README.md +1 -1
- package/skills/omnistudio-flexcard-generate/SKILL.md +11 -4
- package/skills/omnistudio-flexcard-generate/references/best-practices.md +6 -6
- package/skills/omnistudio-flexcard-generate/references/data-binding-guide.md +9 -9
- package/skills/omnistudio-integration-procedure-generate/SKILL.md +9 -1
- package/skills/omnistudio-integration-procedure-generate/references/element-types.md +3 -3
- package/skills/omnistudio-omniscript-generate/SKILL.md +2 -2
- package/skills/omnistudio-omniscript-generate/references/best-practices.md +1 -1
- package/skills/omnistudio-omniscript-generate/scripts/check-duplicate-omniscript.sh +8 -0
- package/skills/omnistudio-omniscript-generate/scripts/deploy-omniscript.sh +8 -0
- package/skills/platform-apex-logs-debug/README.md +2 -2
- package/skills/platform-apex-logs-debug/references/cli-commands.md +2 -2
- package/skills/platform-apex-logs-debug/references/debug-log-reference.md +16 -16
- package/skills/platform-apex-logs-debug/references/log-analysis-tools.md +2 -2
- package/skills/platform-apex-test-run/README.md +1 -1
- package/skills/platform-apex-test-run/references/test-fix-loop.md +2 -2
- package/skills/platform-apex-test-run/references/testing-best-practices.md +3 -3
- package/skills/platform-data-manage/README.md +4 -4
- package/skills/platform-data-manage/references/bulk-testing-example.md +1 -1
- package/skills/platform-data-manage/references/crud-workflow-example.md +2 -2
- package/skills/platform-data-manage/references/orchestration.md +6 -6
- package/skills/platform-flexipage-generate/SKILL.md +281 -346
- package/skills/platform-flexipage-generate/references/cli_commands.md +39 -0
- package/skills/platform-flexipage-generate/references/flexipage_fieldSection.md +162 -0
- package/skills/platform-flexipage-generate/references/flexipage_richText.md +84 -0
- package/skills/platform-flexipage-generate/references/identifiers_and_regions.md +167 -0
- package/skills/platform-flexipage-generate/references/mcp_action_examples.md +104 -0
- package/skills/platform-flexipage-generate/references/record_flexipage_dynamicHighlights.md +119 -0
- package/skills/platform-flexipage-generate/references/xml_rules.md +335 -0
- package/skills/platform-flexipage-generate/scripts/resolve-component-instructions.sh +42 -0
- package/skills/platform-flexipage-generate/scripts/scan-lwc-components.sh +113 -0
- package/skills/platform-metadata-deploy/README.md +2 -2
- package/skills/platform-metadata-deploy/references/agent-deployment-guide.md +2 -2
- package/skills/platform-metadata-deploy/references/deployment-workflows.md +16 -16
- package/skills/platform-metadata-deploy/references/orchestration.md +3 -3
- package/skills/platform-metadata-deploy/references/trigger-deployment-safety.md +2 -2
- package/skills/platform-models-api-configure/SKILL.md +140 -0
- package/skills/platform-models-api-configure/scripts/get-orgjwt.sh +48 -0
- package/skills/platform-policy-rule-generate/SKILL.md +260 -0
- package/skills/platform-policy-rule-generate/references/deploy-errors.md +54 -0
- package/skills/platform-policy-rule-generate/references/fixtures-index.md +29 -0
- package/skills/platform-policy-rule-generate/references/policy-schema-full.md +250 -0
- package/skills/platform-policy-rule-generate/references/templates-access.md +132 -0
- package/skills/platform-policy-rule-generate/references/templates-advanced.md +58 -0
- package/skills/platform-policy-rule-generate/references/templates-record.md +75 -0
- package/skills/platform-policy-rule-generate/references/templates-transform.md +70 -0
- package/skills/platform-policy-rule-generate/references/templates.md +10 -0
- package/skills/platform-policy-rule-generate/references/ui-compatibility.md +142 -0
- package/skills/platform-soql-query/README.md +1 -1
- package/skills/platform-soql-query/SKILL.md +1 -1
- package/skills/platform-soql-query/references/anti-patterns.md +1 -1
- package/skills/platform-soql-query/references/field-coverage-rules.md +1 -1
- package/skills/platform-soql-query/references/query-optimization.md +1 -1
- package/skills/platform-soql-query/scripts/post-tool-validate.py +3 -3
- package/skills/data360-activate/CREDITS.md +0 -5
- package/skills/data360-connect/CREDITS.md +0 -5
- package/skills/data360-harmonize/CREDITS.md +0 -3
- package/skills/data360-orchestrate/CREDITS.md +0 -15
- package/skills/data360-orchestrate/UPSTREAM.md +0 -45
- package/skills/data360-prepare/CREDITS.md +0 -7
- package/skills/data360-query/CREDITS.md +0 -7
- package/skills/data360-segment/CREDITS.md +0 -3
- package/skills/experience-lwc-generate/CREDITS.md +0 -5
- package/skills/external-diagram-mermaid-generate/CREDITS.md +0 -46
- package/skills/external-diagram-visual-generate/CREDITS.md +0 -80
- package/skills/external-diagram-visual-generate/README.md +0 -83
- package/skills/external-diagram-visual-generate/SKILL.md +0 -207
- package/skills/external-diagram-visual-generate/assets/architecture/integration-flow.md +0 -55
- package/skills/external-diagram-visual-generate/assets/erd/core-objects.md +0 -131
- package/skills/external-diagram-visual-generate/assets/erd/custom-objects.md +0 -60
- package/skills/external-diagram-visual-generate/assets/lwc/dashboard-card.md +0 -45
- package/skills/external-diagram-visual-generate/assets/lwc/data-table.md +0 -57
- package/skills/external-diagram-visual-generate/assets/lwc/record-form.md +0 -60
- package/skills/external-diagram-visual-generate/assets/review/apex-review.md +0 -57
- package/skills/external-diagram-visual-generate/assets/review/lwc-review.md +0 -48
- package/skills/external-diagram-visual-generate/references/architect-aesthetic-guide.md +0 -257
- package/skills/external-diagram-visual-generate/references/examples-index.md +0 -35
- package/skills/external-diagram-visual-generate/references/gemini-cli-setup.md +0 -65
- package/skills/external-diagram-visual-generate/references/interview-questions.md +0 -529
- package/skills/external-diagram-visual-generate/references/iteration-workflow.md +0 -173
- package/skills/external-diagram-visual-generate/scripts/check-prerequisites.sh +0 -101
- package/skills/external-diagram-visual-generate/scripts/generate_image.py +0 -243
- package/skills/integration-connectivity-connected-app-configure/CREDITS.md +0 -3
- package/skills/integration-connectivity-generate/CREDITS.md +0 -5
- package/skills/omnistudio-callable-apex-generate/CREDITS.md +0 -9
- package/skills/omnistudio-datamapper-generate/CREDITS.md +0 -5
- package/skills/omnistudio-datapacks-deploy/CREDITS.md +0 -5
- package/skills/omnistudio-dependencies-analyze/CREDITS.md +0 -5
- package/skills/omnistudio-epc-catalog-generate/CREDITS.md +0 -14
- package/skills/omnistudio-flexcard-generate/CREDITS.md +0 -5
- package/skills/omnistudio-integration-procedure-generate/CREDITS.md +0 -5
- package/skills/omnistudio-omniscript-generate/CREDITS.md +0 -5
- package/skills/platform-apex-generate/CREDITS.md +0 -5
- package/skills/platform-apex-logs-debug/CREDITS.md +0 -22
- package/skills/platform-apex-test-generate/CREDITS.md +0 -5
- package/skills/platform-apex-test-run/CREDITS.md +0 -22
- package/skills/platform-data-manage/CREDITS.md +0 -5
- package/skills/platform-metadata-deploy/CREDITS.md +0 -25
- package/skills/platform-soql-query/CREDITS.md +0 -21
- /package/skills/omnistudio-callable-apex-generate/examples/Test_VlocityOpenInterfaceConversion/{MyCustomVlocityOpenInterface2.cls → MyCustomClass.cls} +0 -0
|
@@ -23,21 +23,21 @@ This skill helps you create and manage:
|
|
|
23
23
|
|
|
24
24
|
### Create a Connected App
|
|
25
25
|
|
|
26
|
-
```
|
|
26
|
+
```text
|
|
27
27
|
Use the integration-connectivity-connected-app-configure skill to create a Connected App named "MyIntegration"
|
|
28
28
|
with API and RefreshToken scopes for server-to-server integration.
|
|
29
29
|
```
|
|
30
30
|
|
|
31
31
|
### Create an External Client App
|
|
32
32
|
|
|
33
|
-
```
|
|
33
|
+
```text
|
|
34
34
|
Use the integration-connectivity-connected-app-configure skill to create an External Client App named
|
|
35
35
|
"MobileApp" for a mobile application with PKCE enabled.
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
### Review Existing Apps
|
|
39
39
|
|
|
40
|
-
```
|
|
40
|
+
```text
|
|
41
41
|
Use the integration-connectivity-connected-app-configure skill to review and score my existing Connected Apps
|
|
42
42
|
for security best practices.
|
|
43
43
|
```
|
|
@@ -70,7 +70,7 @@ for security best practices.
|
|
|
70
70
|
|
|
71
71
|
## Directory Structure
|
|
72
72
|
|
|
73
|
-
```
|
|
73
|
+
```text
|
|
74
74
|
integration-connectivity-connected-app-configure/
|
|
75
75
|
├── skills/
|
|
76
76
|
│ └── integration-connectivity-connected-app-configure/
|
|
@@ -96,4 +96,3 @@ integration-connectivity-connected-app-configure/
|
|
|
96
96
|
## Dependencies
|
|
97
97
|
|
|
98
98
|
- **platform-metadata-deploy**: For deploying apps to orgs
|
|
99
|
-
- **sf-metadata**: For creating related metadata (Named Credentials)
|
|
@@ -85,7 +85,7 @@ Read the appropriate template before generating — do not build from scratch:
|
|
|
85
85
|
| `assets/eca-policies.xml` | ECA configurable policies |
|
|
86
86
|
|
|
87
87
|
If you need source-controlled ECA OAuth security metadata, retrieve it from an org first and treat the retrieved file as the schema source of truth:
|
|
88
|
-
```
|
|
88
|
+
```sh
|
|
89
89
|
sf project retrieve start --metadata ExtlClntAppOauthSecuritySettings:<AppName> --target-org <alias>
|
|
90
90
|
```
|
|
91
91
|
|
|
@@ -172,7 +172,7 @@ When finishing, confirm and report in this order:
|
|
|
172
172
|
5. **Next deployment / testing step**
|
|
173
173
|
|
|
174
174
|
Suggested output shape:
|
|
175
|
-
```
|
|
175
|
+
```text
|
|
176
176
|
App: <name>
|
|
177
177
|
Type: Connected App | External Client App
|
|
178
178
|
Flow: <oauth flow>
|
|
@@ -6,7 +6,7 @@ Real-world examples of using the integration-connectivity-connected-app-configur
|
|
|
6
6
|
## Example 1: Create a Basic API Integration Connected App
|
|
7
7
|
|
|
8
8
|
**Request**:
|
|
9
|
-
```
|
|
9
|
+
```text
|
|
10
10
|
Use the integration-connectivity-connected-app-configure skill to create a Connected App named "DataSyncIntegration"
|
|
11
11
|
for syncing data with our external ERP system. It needs API access and refresh tokens.
|
|
12
12
|
Contact email: admin@company.com
|
|
@@ -42,7 +42,7 @@ Contact email: admin@company.com
|
|
|
42
42
|
## Example 2: Create a JWT Bearer App for CI/CD
|
|
43
43
|
|
|
44
44
|
**Request**:
|
|
45
|
-
```
|
|
45
|
+
```text
|
|
46
46
|
Create a Connected App for our CI/CD pipeline using JWT Bearer flow.
|
|
47
47
|
Name it "GitHubActionsDeployment" and use certificate "GH_Actions_Cert".
|
|
48
48
|
```
|
|
@@ -77,7 +77,7 @@ Name it "GitHubActionsDeployment" and use certificate "GH_Actions_Cert".
|
|
|
77
77
|
## Example 3: Create a Mobile App with External Client App
|
|
78
78
|
|
|
79
79
|
**Request**:
|
|
80
|
-
```
|
|
80
|
+
```text
|
|
81
81
|
Create an External Client App for our mobile app "FieldServiceMobile".
|
|
82
82
|
It needs PKCE enabled, refresh tokens, and should be packageable for distribution.
|
|
83
83
|
```
|
|
@@ -134,7 +134,7 @@ sf project retrieve start \
|
|
|
134
134
|
## Example 4: Review Existing Connected Apps
|
|
135
135
|
|
|
136
136
|
**Request**:
|
|
137
|
-
```
|
|
137
|
+
```text
|
|
138
138
|
Review and score my existing Connected Apps for security best practices.
|
|
139
139
|
```
|
|
140
140
|
|
|
@@ -145,7 +145,7 @@ Review and score my existing Connected Apps for security best practices.
|
|
|
145
145
|
4. Generate report
|
|
146
146
|
|
|
147
147
|
**Sample Report**:
|
|
148
|
-
```
|
|
148
|
+
```text
|
|
149
149
|
📊 CONNECTED APP SECURITY REVIEW
|
|
150
150
|
════════════════════════════════════════════════════════════════
|
|
151
151
|
|
|
@@ -180,7 +180,7 @@ LegacyERPConnector:
|
|
|
180
180
|
## Example 5: Migrate Connected App to External Client App
|
|
181
181
|
|
|
182
182
|
**Request**:
|
|
183
|
-
```
|
|
183
|
+
```text
|
|
184
184
|
Migrate our "SalesPortal" Connected App to an External Client App for better security.
|
|
185
185
|
```
|
|
186
186
|
|
|
@@ -191,7 +191,7 @@ Migrate our "SalesPortal" Connected App to an External Client App for better sec
|
|
|
191
191
|
4. Provide migration checklist
|
|
192
192
|
|
|
193
193
|
**Output**:
|
|
194
|
-
```
|
|
194
|
+
```text
|
|
195
195
|
📦 MIGRATION PLAN: SalesPortal → External Client App
|
|
196
196
|
════════════════════════════════════════════════════════════════
|
|
197
197
|
|
|
@@ -234,7 +234,7 @@ Client Credentials flow still requires post-deployment admin validation. Even wi
|
|
|
234
234
|
|
|
235
235
|
### Minimal ECA (API Integration)
|
|
236
236
|
|
|
237
|
-
```
|
|
237
|
+
```text
|
|
238
238
|
Files:
|
|
239
239
|
├── externalClientApps/MyApp.eca-meta.xml
|
|
240
240
|
├── extlClntAppOauthSettings/MyApp.ecaOauth-meta.xml
|
|
@@ -246,7 +246,7 @@ PKCE: false (confidential client)
|
|
|
246
246
|
|
|
247
247
|
### Mobile App ECA (PKCE)
|
|
248
248
|
|
|
249
|
-
```
|
|
249
|
+
```text
|
|
250
250
|
Files:
|
|
251
251
|
├── externalClientApps/MobileApp.eca-meta.xml
|
|
252
252
|
├── extlClntAppOauthSettings/MobileApp.ecaOauth-meta.xml
|
|
@@ -259,7 +259,7 @@ Callback: com.example.app://oauth/callback
|
|
|
259
259
|
|
|
260
260
|
### Server-to-Server ECA
|
|
261
261
|
|
|
262
|
-
```
|
|
262
|
+
```text
|
|
263
263
|
Files:
|
|
264
264
|
├── externalClientApps/ServiceApp.eca-meta.xml
|
|
265
265
|
├── extlClntAppOauthSettings/ServiceApp.ecaOauth-meta.xml
|
|
@@ -189,3 +189,9 @@ When this skill completes an integration task, it produces:
|
|
|
189
189
|
| 90–107 | good design with some hardening left |
|
|
190
190
|
| 72–89 | workable but needs architectural review |
|
|
191
191
|
| < 72 | unsafe / incomplete for deployment |
|
|
192
|
+
|
|
193
|
+
---
|
|
194
|
+
|
|
195
|
+
## Pre-Delivery Checklist
|
|
196
|
+
|
|
197
|
+
- [ ] Never hardcode credentials — all secrets stored in Named Credentials or External Credentials
|
|
@@ -182,7 +182,7 @@ public with sharing class {{ServiceName}}QueueableCallout implements Queueable,
|
|
|
182
182
|
* @param recordId Salesforce record ID
|
|
183
183
|
*/
|
|
184
184
|
private void deleteExternalRecord(Id recordId) {
|
|
185
|
-
//
|
|
185
|
+
// DELIBERATE: per-record query acceptable at BATCH_SIZE=10; refactor to bulk query if increasing batch size
|
|
186
186
|
{{ObjectName}} record = [
|
|
187
187
|
SELECT External_Id__c
|
|
188
188
|
FROM {{ObjectName}}
|
|
@@ -8,7 +8,7 @@ External Services in Salesforce auto-generate Apex classes from OpenAPI specific
|
|
|
8
8
|
|
|
9
9
|
When you register an External Service named `MyAPI`, Salesforce generates:
|
|
10
10
|
|
|
11
|
-
```
|
|
11
|
+
```text
|
|
12
12
|
ExternalService.MyAPI - Main service class
|
|
13
13
|
ExternalService.MyAPI_operationName_Request - Request wrapper for each operation
|
|
14
14
|
ExternalService.MyAPI_operationName_Response - Response wrapper for each operation
|
|
@@ -43,7 +43,7 @@ Salesforce WSDL2Apex has limitations. Check for:
|
|
|
43
43
|
|
|
44
44
|
For a WSDL defining `CustomerService` with operation `getCustomer`:
|
|
45
45
|
|
|
46
|
-
```
|
|
46
|
+
```text
|
|
47
47
|
AsyncCustomerService.cls - Async version of service
|
|
48
48
|
CustomerService.cls - Main stub class with methods
|
|
49
49
|
GetCustomerRequest.cls - Request wrapper
|
|
@@ -409,6 +409,8 @@ Headers: Idempotency-Key: {{recordId}}-{{timestamp}}
|
|
|
409
409
|
|
|
410
410
|
### WSDL2Apex Process
|
|
411
411
|
|
|
412
|
+
**Reference**: `assets/soap/wsdl2apex-guide.md`
|
|
413
|
+
|
|
412
414
|
SOAP integrations in Salesforce use WSDL2Apex to auto-generate Apex classes from WSDL files.
|
|
413
415
|
|
|
414
416
|
#### Step-by-Step Process
|
|
@@ -660,6 +662,8 @@ public with sharing class SoapQueueableCallout implements Queueable, Database.Al
|
|
|
660
662
|
|
|
661
663
|
### Error Handling Patterns
|
|
662
664
|
|
|
665
|
+
**Template**: `assets/callouts/http-response-handler.cls`
|
|
666
|
+
|
|
663
667
|
```apex
|
|
664
668
|
try {
|
|
665
669
|
HttpResponse res = makeCallout();
|
|
@@ -7,7 +7,7 @@ Change Data Capture publishes change events for Salesforce records, enabling nea
|
|
|
7
7
|
|
|
8
8
|
## How CDC Works
|
|
9
9
|
|
|
10
|
-
```
|
|
10
|
+
```text
|
|
11
11
|
┌─────────────────────────────────────────────────────────────────┐
|
|
12
12
|
│ CHANGE DATA CAPTURE FLOW │
|
|
13
13
|
├─────────────────────────────────────────────────────────────────┤
|
|
@@ -124,7 +124,7 @@ trigger AccountCDC on AccountChangeEvent (after insert) {
|
|
|
124
124
|
|
|
125
125
|
### External (CometD)
|
|
126
126
|
|
|
127
|
-
```
|
|
127
|
+
```text
|
|
128
128
|
Channel: /data/AccountChangeEvent
|
|
129
129
|
```
|
|
130
130
|
|
package/skills/integration-connectivity-generate/references/event-driven-architecture-guide.md
CHANGED
|
@@ -60,7 +60,7 @@ The Pub/Sub API is the **recommended mechanism for external consumers** subscrib
|
|
|
60
60
|
|
|
61
61
|
### External Consumer Architecture
|
|
62
62
|
|
|
63
|
-
```
|
|
63
|
+
```text
|
|
64
64
|
Salesforce Org
|
|
65
65
|
└── Platform Event / CDC Event
|
|
66
66
|
└── Pub/Sub API (gRPC endpoint)
|
|
@@ -106,7 +106,7 @@ Salesforce Event Relays forward Platform Events to AWS EventBridge, enabling clo
|
|
|
106
106
|
|
|
107
107
|
### Architecture
|
|
108
108
|
|
|
109
|
-
```
|
|
109
|
+
```text
|
|
110
110
|
Salesforce Platform Event
|
|
111
111
|
└── Event Relay Definition (Metadata)
|
|
112
112
|
└── AWS EventBridge Partner Event Source
|
|
@@ -156,7 +156,7 @@ For organizations needing long-retention, high-throughput event streaming beyond
|
|
|
156
156
|
|
|
157
157
|
### Integration Pattern
|
|
158
158
|
|
|
159
|
-
```
|
|
159
|
+
```text
|
|
160
160
|
Salesforce → Platform Event → Apex/Flow subscriber → Heroku Kafka producer
|
|
161
161
|
└── Consumer Group A (analytics)
|
|
162
162
|
└── Consumer Group B (data lake)
|
|
@@ -187,7 +187,7 @@ For scenarios requiring high-volume data push to external systems:
|
|
|
187
187
|
|
|
188
188
|
### Recommended Pattern: Middleware + Platform Events
|
|
189
189
|
|
|
190
|
-
```
|
|
190
|
+
```text
|
|
191
191
|
Salesforce Record Change
|
|
192
192
|
└── After-Save Flow / Trigger
|
|
193
193
|
└── Publish Platform Event (lightweight payload)
|
|
@@ -255,7 +255,7 @@ List<EventBusSubscriber> subs = [
|
|
|
255
255
|
|
|
256
256
|
## Summary: EDA Decision Tree
|
|
257
257
|
|
|
258
|
-
```
|
|
258
|
+
```text
|
|
259
259
|
Need real-time data sync?
|
|
260
260
|
├── YES → Is consumer external?
|
|
261
261
|
│ ├── YES → Pub/Sub API + Platform Events (or CDC for record changes)
|
|
@@ -191,6 +191,7 @@ OrderStatusPublisher.publishEvents(events);
|
|
|
191
191
|
### Event Subscriber Trigger
|
|
192
192
|
|
|
193
193
|
**Template**: `assets/platform-events/event-subscriber-trigger.trigger`
|
|
194
|
+
**Template**: `assets/platform-events/event-subscriber-action.cls`
|
|
194
195
|
|
|
195
196
|
#### Standard Volume Subscriber
|
|
196
197
|
|
|
@@ -534,7 +535,7 @@ public static void handleUpdate(OpportunityChangeEvent event, List<String> chang
|
|
|
534
535
|
|
|
535
536
|
### Decision Matrix
|
|
536
537
|
|
|
537
|
-
```
|
|
538
|
+
```text
|
|
538
539
|
┌───────────────────────────────────────────────────────────────────────┐
|
|
539
540
|
│ WHEN TO USE PLATFORM EVENTS vs CHANGE DATA CAPTURE │
|
|
540
541
|
├───────────────────────────────────────────────────────────────────────┤
|
|
@@ -816,7 +817,7 @@ EventBus.publish(event);
|
|
|
816
817
|
|
|
817
818
|
### 3. Using Platform Events for Synchronous-Style Flow Orchestration
|
|
818
819
|
|
|
819
|
-
```
|
|
820
|
+
```javascript
|
|
820
821
|
// ❌ WRONG: Using events to simulate synchronous request/response
|
|
821
822
|
Flow A → Publish "Request" Event → Subscriber triggers Flow B → Publish "Response" Event → ???
|
|
822
823
|
```
|
|
@@ -7,7 +7,7 @@ External Services in Salesforce automatically generate Apex classes from OpenAPI
|
|
|
7
7
|
|
|
8
8
|
## How It Works
|
|
9
9
|
|
|
10
|
-
```
|
|
10
|
+
```text
|
|
11
11
|
┌─────────────────────────────────────────────────────────────────┐
|
|
12
12
|
│ EXTERNAL SERVICE FLOW │
|
|
13
13
|
├─────────────────────────────────────────────────────────────────┤
|
|
@@ -43,6 +43,9 @@ External Services in Salesforce automatically generate Apex classes from OpenAPI
|
|
|
43
43
|
|
|
44
44
|
### Via Metadata API
|
|
45
45
|
|
|
46
|
+
**Template**: `assets/external-services/openapi-registration.externalServiceRegistration-meta.xml`
|
|
47
|
+
**Reference**: `assets/external-services/external-service-operations.md`
|
|
48
|
+
|
|
46
49
|
```xml
|
|
47
50
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
48
51
|
<ExternalServiceRegistration xmlns="http://soap.sforce.com/2006/04/metadata">
|
|
@@ -7,7 +7,7 @@ This guide covers building custom clients for Messaging for In-App and Web (MIAW
|
|
|
7
7
|
|
|
8
8
|
## Overview
|
|
9
9
|
|
|
10
|
-
```
|
|
10
|
+
```text
|
|
11
11
|
┌─────────────────────────────────────────────────────────────────────────┐
|
|
12
12
|
│ MIAW CUSTOM CLIENT ARCHITECTURE │
|
|
13
13
|
├─────────────────────────────────────────────────────────────────────────┤
|
|
@@ -47,7 +47,7 @@ This guide covers building custom clients for Messaging for In-App and Web (MIAW
|
|
|
47
47
|
|
|
48
48
|
### Embedded Service Deployment
|
|
49
49
|
|
|
50
|
-
```
|
|
50
|
+
```text
|
|
51
51
|
Setup → Embedded Service Deployments → New Deployment
|
|
52
52
|
├─ Type: Messaging for In-App and Web
|
|
53
53
|
├─ Channel: Web
|
|
@@ -11,7 +11,7 @@ This guide explains how to automate Named Credential configuration using the int
|
|
|
11
11
|
|
|
12
12
|
Enhanced Named Credentials = **External Credential** + **Named Credential** + **Endpoint Security**
|
|
13
13
|
|
|
14
|
-
```
|
|
14
|
+
```text
|
|
15
15
|
External Credential (stores the API key securely)
|
|
16
16
|
↓
|
|
17
17
|
Named Credential (references the External Credential)
|
|
@@ -20,7 +20,7 @@ Named Credentials provide secure storage of authentication credentials and endpo
|
|
|
20
20
|
- Permission Set-based access control
|
|
21
21
|
- More secure and flexible
|
|
22
22
|
|
|
23
|
-
```
|
|
23
|
+
```text
|
|
24
24
|
┌─────────────────────────────────────────────────────────────────┐
|
|
25
25
|
│ CREDENTIAL ARCHITECTURE (API 61+) │
|
|
26
26
|
├─────────────────────────────────────────────────────────────────┤
|
|
@@ -46,6 +46,9 @@ Named Credentials provide secure storage of authentication credentials and endpo
|
|
|
46
46
|
|
|
47
47
|
### 1. OAuth 2.0 Client Credentials
|
|
48
48
|
|
|
49
|
+
**Template**: `assets/named-credentials/oauth-client-credentials.namedCredential-meta.xml`
|
|
50
|
+
**Template**: `assets/external-credentials/oauth-external-credential.externalCredential-meta.xml`
|
|
51
|
+
|
|
49
52
|
**Use Case**: Server-to-server integration without user context
|
|
50
53
|
|
|
51
54
|
```apex
|
|
@@ -63,6 +66,9 @@ req.setMethod('GET');
|
|
|
63
66
|
|
|
64
67
|
### 2. OAuth 2.0 JWT Bearer
|
|
65
68
|
|
|
69
|
+
**Template**: `assets/named-credentials/oauth-jwt-bearer.namedCredential-meta.xml`
|
|
70
|
+
**Template**: `assets/external-credentials/jwt-external-credential.externalCredential-meta.xml`
|
|
71
|
+
|
|
66
72
|
**Use Case**: Certificate-based server-to-server auth
|
|
67
73
|
|
|
68
74
|
**Prerequisites**:
|
|
@@ -78,6 +84,8 @@ req.setMethod('GET');
|
|
|
78
84
|
|
|
79
85
|
### 3. Certificate-Based (Mutual TLS)
|
|
80
86
|
|
|
87
|
+
**Template**: `assets/named-credentials/certificate-auth.namedCredential-meta.xml`
|
|
88
|
+
|
|
81
89
|
**Use Case**: High-security integrations requiring client certificate
|
|
82
90
|
|
|
83
91
|
**Setup**:
|
|
@@ -88,6 +96,8 @@ req.setMethod('GET');
|
|
|
88
96
|
|
|
89
97
|
### 4. Basic Auth / API Key
|
|
90
98
|
|
|
99
|
+
**Template**: `assets/named-credentials/custom-auth.namedCredential-meta.xml`
|
|
100
|
+
|
|
91
101
|
**Use Case**: Simple APIs, internal systems
|
|
92
102
|
|
|
93
103
|
**Pattern for API Key**:
|
|
@@ -134,7 +144,7 @@ public class ExternalServiceCallout {
|
|
|
134
144
|
|
|
135
145
|
### Pattern 2: Multiple Environments
|
|
136
146
|
|
|
137
|
-
```
|
|
147
|
+
```text
|
|
138
148
|
Named Credentials:
|
|
139
149
|
├── MyAPI_Dev → https://api-dev.example.com
|
|
140
150
|
├── MyAPI_UAT → https://api-uat.example.com
|
|
@@ -60,7 +60,7 @@ Platform Events enable event-driven architecture in Salesforce. They provide a s
|
|
|
60
60
|
|
|
61
61
|
### File Location
|
|
62
62
|
|
|
63
|
-
```
|
|
63
|
+
```text
|
|
64
64
|
force-app/main/default/objects/Order_Update_Event__e/Order_Update_Event__e.object-meta.xml
|
|
65
65
|
```
|
|
66
66
|
|
|
@@ -125,7 +125,7 @@ trigger OrderUpdateSubscriber on Order_Update_Event__e (after insert) {
|
|
|
125
125
|
|
|
126
126
|
External systems can subscribe using CometD streaming:
|
|
127
127
|
|
|
128
|
-
```
|
|
128
|
+
```text
|
|
129
129
|
/event/Order_Update_Event__e
|
|
130
130
|
```
|
|
131
131
|
|
|
@@ -268,7 +268,7 @@ WHERE Topic = 'Order_Update_Event__e'
|
|
|
268
268
|
|
|
269
269
|
Use CometD client to connect to Streaming API:
|
|
270
270
|
|
|
271
|
-
```
|
|
271
|
+
```text
|
|
272
272
|
Endpoint: /cometd/62.0
|
|
273
273
|
Channel: /event/Order_Update_Event__e
|
|
274
274
|
```
|
|
@@ -21,7 +21,7 @@ This guide covers patterns for making HTTP callouts from Salesforce Apex to exte
|
|
|
21
21
|
- Background processing
|
|
22
22
|
- Long-running operations
|
|
23
23
|
|
|
24
|
-
```
|
|
24
|
+
```text
|
|
25
25
|
┌─────────────────────────────────────────────────────────────────┐
|
|
26
26
|
│ CALLOUT CONTEXT DECISION │
|
|
27
27
|
├─────────────────────────────────────────────────────────────────┤
|
|
@@ -38,7 +38,7 @@ req.setEndpoint('https://api.example.com');
|
|
|
38
38
|
|
|
39
39
|
Request only necessary scopes:
|
|
40
40
|
|
|
41
|
-
```
|
|
41
|
+
```text
|
|
42
42
|
✅ read:orders write:orders
|
|
43
43
|
❌ admin:* read:* write:*
|
|
44
44
|
```
|
|
@@ -54,7 +54,7 @@ Request only necessary scopes:
|
|
|
54
54
|
|
|
55
55
|
For mobile or SPA clients:
|
|
56
56
|
|
|
57
|
-
```
|
|
57
|
+
```text
|
|
58
58
|
Use Authorization Code with PKCE, not Implicit flow
|
|
59
59
|
```
|
|
60
60
|
|
|
@@ -62,6 +62,9 @@ Use Authorization Code with PKCE, not Implicit flow
|
|
|
62
62
|
|
|
63
63
|
### Remote Site Settings
|
|
64
64
|
|
|
65
|
+
**Template**: `assets/endpoint-security/example.remoteSite-meta.xml`
|
|
66
|
+
**Template**: `assets/endpoint-security/example.cspTrustedSite-meta.xml`
|
|
67
|
+
|
|
65
68
|
- Only allow necessary domains
|
|
66
69
|
- Don't use wildcard domains
|
|
67
70
|
- Review and audit regularly
|
|
@@ -72,6 +72,12 @@ EXTERNAL_CREDENTIAL_NAME=$1
|
|
|
72
72
|
PRINCIPAL_NAME=$2
|
|
73
73
|
ORG_ALIAS=$3
|
|
74
74
|
|
|
75
|
+
# Validate EXTERNAL_CREDENTIAL_NAME for SOQL safety
|
|
76
|
+
if [[ ! "$EXTERNAL_CREDENTIAL_NAME" =~ ^[a-zA-Z0-9_]+$ ]]; then
|
|
77
|
+
echo -e "${RED}ERROR: Invalid credential name '$EXTERNAL_CREDENTIAL_NAME'. Only alphanumeric and underscores allowed.${NC}" >&2
|
|
78
|
+
exit 1
|
|
79
|
+
fi
|
|
80
|
+
|
|
75
81
|
# Validate sf CLI is installed
|
|
76
82
|
if ! command -v sf &> /dev/null; then
|
|
77
83
|
echo -e "${RED}Error: Salesforce CLI (sf) is not installed${NC}"
|
|
@@ -138,10 +144,16 @@ fi
|
|
|
138
144
|
echo -e "${GREEN}✓ API key received${NC}"
|
|
139
145
|
echo ""
|
|
140
146
|
|
|
147
|
+
# Escape single quotes to prevent Apex injection
|
|
148
|
+
API_KEY_ESCAPED="${API_KEY//\'/\\\'}"
|
|
149
|
+
EXTERNAL_CREDENTIAL_NAME_ESCAPED="${EXTERNAL_CREDENTIAL_NAME//\'/\\\'}"
|
|
150
|
+
PRINCIPAL_NAME_ESCAPED="${PRINCIPAL_NAME//\'/\\\'}"
|
|
151
|
+
|
|
141
152
|
# Generate Apex code to configure credential
|
|
142
153
|
echo -e "${BLUE}► Generating Apex code to configure credential...${NC}"
|
|
143
154
|
|
|
144
155
|
TEMP_APEX=$(mktemp /tmp/set-credential-XXXXXX.apex)
|
|
156
|
+
trap 'rm -f "$TEMP_APEX"' EXIT
|
|
145
157
|
|
|
146
158
|
cat > "$TEMP_APEX" << EOF
|
|
147
159
|
// Auto-generated by configure-named-credential.sh
|
|
@@ -151,14 +163,14 @@ cat > "$TEMP_APEX" << EOF
|
|
|
151
163
|
ConnectApi.CredentialInput newCredentials = new ConnectApi.CredentialInput();
|
|
152
164
|
|
|
153
165
|
// Specify the External Credential
|
|
154
|
-
newCredentials.externalCredential = '$
|
|
166
|
+
newCredentials.externalCredential = '$EXTERNAL_CREDENTIAL_NAME_ESCAPED';
|
|
155
167
|
|
|
156
168
|
// Set authentication protocol
|
|
157
169
|
newCredentials.authenticationProtocol = ConnectApi.CredentialAuthenticationProtocol.Custom;
|
|
158
170
|
|
|
159
171
|
// Define the principal
|
|
160
172
|
newCredentials.principalType = ConnectApi.CredentialPrincipalType.NamedPrincipal;
|
|
161
|
-
newCredentials.principalName = '$
|
|
173
|
+
newCredentials.principalName = '$PRINCIPAL_NAME_ESCAPED';
|
|
162
174
|
|
|
163
175
|
// Create credentials map
|
|
164
176
|
Map<String, ConnectApi.CredentialValueInput> creds = new Map<String, ConnectApi.CredentialValueInput>();
|
|
@@ -166,7 +178,7 @@ Map<String, ConnectApi.CredentialValueInput> creds = new Map<String, ConnectApi.
|
|
|
166
178
|
// Create API key parameter
|
|
167
179
|
ConnectApi.CredentialValueInput apiKeyParam = new ConnectApi.CredentialValueInput();
|
|
168
180
|
apiKeyParam.encrypted = true; // Required for security
|
|
169
|
-
apiKeyParam.value = '$
|
|
181
|
+
apiKeyParam.value = '$API_KEY_ESCAPED';
|
|
170
182
|
|
|
171
183
|
// Add to credentials map
|
|
172
184
|
creds.put('apiKey', apiKeyParam);
|
|
@@ -230,7 +242,6 @@ else
|
|
|
230
242
|
echo -e "${YELLOW}Apex execution output:${NC}"
|
|
231
243
|
echo "$APEX_RESULT"
|
|
232
244
|
echo ""
|
|
233
|
-
echo -e "${YELLOW}
|
|
234
|
-
echo "Review the file and run manually if needed"
|
|
245
|
+
echo -e "${YELLOW}Re-run this script to retry.${NC}"
|
|
235
246
|
exit 1
|
|
236
247
|
fi
|
|
@@ -45,6 +45,12 @@ SETTING_NAME=$1
|
|
|
45
45
|
API_KEY=$2
|
|
46
46
|
ORG_ALIAS=$3
|
|
47
47
|
|
|
48
|
+
# Validate SETTING_NAME to prevent SOQL injection
|
|
49
|
+
if [[ ! "$SETTING_NAME" =~ ^[a-zA-Z0-9_]+$ ]]; then
|
|
50
|
+
echo -e "${RED}Error: Invalid setting name '$SETTING_NAME'. Only alphanumeric and underscores allowed.${NC}" >&2
|
|
51
|
+
exit 1
|
|
52
|
+
fi
|
|
53
|
+
|
|
48
54
|
# If API key is "-", prompt securely
|
|
49
55
|
if [ "$API_KEY" = "-" ]; then
|
|
50
56
|
echo -e "${YELLOW}Enter API key (input hidden):${NC}"
|
|
@@ -58,6 +64,9 @@ if [ -z "$API_KEY" ]; then
|
|
|
58
64
|
exit 1
|
|
59
65
|
fi
|
|
60
66
|
|
|
67
|
+
# Escape single quotes in API_KEY for safe interpolation
|
|
68
|
+
API_KEY_ESCAPED="${API_KEY//\'/\\\'}"
|
|
69
|
+
|
|
61
70
|
# Validate org
|
|
62
71
|
echo -e "${BLUE}Validating org connection...${NC}"
|
|
63
72
|
if ! sf org display --target-org "$ORG_ALIAS" &> /dev/null; then
|
|
@@ -120,7 +129,7 @@ if [ -z "$EXISTING_ID" ]; then
|
|
|
120
129
|
echo -e "${BLUE}Creating new credential record...${NC}"
|
|
121
130
|
sf data create record \
|
|
122
131
|
--sobject API_Credentials__c \
|
|
123
|
-
--values "Name='$SETTING_NAME' API_Key__c='$
|
|
132
|
+
--values "Name='$SETTING_NAME' API_Key__c='$API_KEY_ESCAPED'" \
|
|
124
133
|
--target-org "$ORG_ALIAS"
|
|
125
134
|
echo -e "${GREEN}✓ Credential created${NC}"
|
|
126
135
|
else
|
|
@@ -128,7 +137,7 @@ else
|
|
|
128
137
|
sf data update record \
|
|
129
138
|
--sobject API_Credentials__c \
|
|
130
139
|
--record-id "$EXISTING_ID" \
|
|
131
|
-
--values "API_Key__c='$
|
|
140
|
+
--values "API_Key__c='$API_KEY_ESCAPED'" \
|
|
132
141
|
--target-org "$ORG_ALIAS"
|
|
133
142
|
echo -e "${GREEN}✓ Credential updated${NC}"
|
|
134
143
|
fi
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env python3
|
|
2
2
|
"""
|
|
3
|
-
Credential Setup Suggestion Hook for
|
|
3
|
+
Credential Setup Suggestion Hook for integration-connectivity-generate
|
|
4
4
|
|
|
5
5
|
Detects when credential metadata files are created and suggests
|
|
6
6
|
running the appropriate automation scripts.
|
|
@@ -19,6 +19,7 @@ import os
|
|
|
19
19
|
import re
|
|
20
20
|
import sys
|
|
21
21
|
from pathlib import Path
|
|
22
|
+
from typing import Optional
|
|
22
23
|
|
|
23
24
|
# File pattern matchers
|
|
24
25
|
PATTERNS = {
|
|
@@ -82,7 +83,7 @@ SCRIPT_RECOMMENDATIONS = {
|
|
|
82
83
|
}
|
|
83
84
|
|
|
84
85
|
|
|
85
|
-
def detect_file_type(file_path: str) -> str
|
|
86
|
+
def detect_file_type(file_path: str) -> Optional[str]:
|
|
86
87
|
"""Detect the credential file type from the file path."""
|
|
87
88
|
filename = os.path.basename(file_path)
|
|
88
89
|
|
|
@@ -204,7 +205,7 @@ def generate_suggestion_message(file_type: str, cred_name: str, file_context: di
|
|
|
204
205
|
if file_context.get('has_oauth'):
|
|
205
206
|
lines.extend([
|
|
206
207
|
'',
|
|
207
|
-
'⚠️ OAuth detected: Consider using /
|
|
208
|
+
'⚠️ OAuth detected: Consider using /integration-connectivity-connected-app-configure to',
|
|
208
209
|
' create the Connected App for this credential.',
|
|
209
210
|
])
|
|
210
211
|
|