@contractspec/example.integration-stripe 3.7.7 → 3.7.10

package/src/index.ts

@@ -1,6 +1,7 @@
 export * from './blueprint';
 export * from './connection.sample';
 export { default as example } from './example';
+export * from './integration';
 export * from './integration-stripe.feature';
 export * from './tenant';
 export * from './workflow';

package/src/integration-stripe.feature.ts

@@ -1,4 +1,6 @@
 import { defineFeature } from '@contractspec/lib.contracts-spec';
+import { StripePaymentsIntegrationSpec } from './integration';
+import { collectPaymentWorkflow } from './workflow';
 
 export const IntegrationStripeFeature = defineFeature({
 	meta: {
@@ -14,12 +16,18 @@ export const IntegrationStripeFeature = defineFeature({
 	},
 
 	integrations: [
-		{ key: 'integration-stripe.integration.psp', version: '1.0.0' },
+		{
+			key: StripePaymentsIntegrationSpec.meta.key,
+			version: StripePaymentsIntegrationSpec.meta.version,
+		},
 	],
 
-	workflows: [{ key: 'integration-stripe.workflow.payment', version: '1.0.0' }],
-
-	policies: [{ key: 'integration-stripe.policy.payments', version: '1.0.0' }],
+	workflows: [
+		{
+			key: collectPaymentWorkflow.meta.key,
+			version: collectPaymentWorkflow.meta.version,
+		},
+	],
 
 	docs: [
 		'docs.examples.integration-stripe',

package/src/integration.ts

@@ -0,0 +1,79 @@
+import { defineIntegration } from '@contractspec/lib.contracts-spec/integrations/spec';
+import {
+	OwnersEnum,
+	StabilityEnum,
+	TagsEnum,
+} from '@contractspec/lib.contracts-spec/ownership';
+import { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';
+
+const StripeConfigModel = defineSchemaModel({
+	name: 'StripePaymentsIntegrationConfig',
+	description: 'Managed configuration required to connect a Stripe account.',
+	fields: {
+		accountId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		webhookEndpoint: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false,
+		},
+	},
+});
+
+const StripeSecretModel = defineSchemaModel({
+	name: 'StripePaymentsIntegrationSecret',
+	description: 'Secret material stored out-of-band for the Stripe provider.',
+	fields: {
+		apiKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		webhookSecret: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false,
+		},
+	},
+});
+
+export const StripePaymentsIntegrationSpec = defineIntegration({
+	meta: {
+		key: 'integration-stripe.integration.psp',
+		version: '1.0.0',
+		title: 'Stripe Payments Integration',
+		description:
+			'Integration contract for managed or BYOK Stripe card processing.',
+		domain: 'payments',
+		category: 'payments',
+		owners: [OwnersEnum.PlatformCore],
+		tags: [TagsEnum.Marketplace, 'stripe', 'payments'],
+		stability: StabilityEnum.Experimental,
+	},
+	supportedModes: ['managed', 'byok'],
+	capabilities: {
+		provides: [{ key: 'payments.psp', version: '1.0.0' }],
+	},
+	configSchema: {
+		schema: StripeConfigModel,
+		example: {
+			accountId: 'acct_demo_artisan',
+			webhookEndpoint: 'https://pay.artisanos.dev/webhooks/stripe',
+		},
+	},
+	secretSchema: {
+		schema: StripeSecretModel,
+		example: {
+			apiKey: 'sk_live_redacted',
+			webhookSecret: 'whsec_redacted',
+		},
+	},
+	healthCheck: {
+		method: 'ping',
+		timeoutMs: 5000,
+	},
+	docsUrl: 'https://docs.stripe.com',
+	constraints: {
+		rateLimit: {
+			rpm: 1000,
+		},
+	},
+	byokSetup: {
+		setupInstructions:
+			'Create a restricted API key and webhook endpoint, then bind the secret reference to the tenant connection.',
+		requiredScopes: ['charges:write', 'customers:read', 'webhooks:write'],
+	},
+});

package/src/workflow.ts

@@ -3,11 +3,11 @@ import {
 	StabilityEnum,
 	TagsEnum,
 } from '@contractspec/lib.contracts-spec/ownership';
-import type { WorkflowSpec } from '@contractspec/lib.contracts-spec/workflow/spec';
+import { defineWorkflow } from '@contractspec/lib.contracts-spec/workflow';
 
-export const collectPaymentWorkflow: WorkflowSpec = {
+export const collectPaymentWorkflow = defineWorkflow({
 	meta: {
-		key: 'artisan.payments.collectPayment',
+		key: 'integration-stripe.workflow.payment',
 		version: '1.0.0',
 		title: 'Collect Card Payment',
 		description:
@@ -50,4 +50,4 @@ export const collectPaymentWorkflow: WorkflowSpec = {
 			{ from: 'charge', to: 'confirm', condition: 'output.success === true' },
 		],
 	},
-};
+});