@contractspec/example.integration-stripe 3.7.6 → 3.7.10

package/dist/browser/index.js

@@ -1,10 +1,64 @@
-// src/blueprint.ts
+// src/workflow.ts
 import {
   OwnersEnum,
   StabilityEnum,
   TagsEnum
 } from "@contractspec/lib.contracts-spec/ownership";
-var artisanStripeBlueprint = {
+import { defineWorkflow } from "@contractspec/lib.contracts-spec/workflow";
+var collectPaymentWorkflow = defineWorkflow({
+  meta: {
+    key: "integration-stripe.workflow.payment",
+    version: "1.0.0",
+    title: "Collect Card Payment",
+    description: "Charge a customer using the tenant Stripe connection and record settlement details.",
+    domain: "payments",
+    owners: [OwnersEnum.PlatformCore],
+    tags: [TagsEnum.Marketplace, "stripe"],
+    stability: StabilityEnum.Experimental
+  },
+  definition: {
+    entryStepId: "prepare",
+    steps: [
+      {
+        id: "prepare",
+        type: "automation",
+        label: "Prepare charge parameters",
+        action: {
+          operation: { key: "payments.prepareCharge", version: "1.0.0" }
+        }
+      },
+      {
+        id: "charge",
+        type: "automation",
+        label: "Charge card via Stripe",
+        action: {
+          operation: { key: "payments.stripe.chargeCard", version: "1.0.0" }
+        }
+      },
+      {
+        id: "confirm",
+        type: "automation",
+        label: "Confirm settlement",
+        action: {
+          operation: { key: "payments.recordSettlement", version: "1.0.0" }
+        }
+      }
+    ],
+    transitions: [
+      { from: "prepare", to: "charge" },
+      { from: "charge", to: "confirm", condition: "output.success === true" }
+    ]
+  }
+});
+
+// src/blueprint.ts
+import { defineAppConfig } from "@contractspec/lib.contracts-spec/app-config/spec";
+import {
+  OwnersEnum as OwnersEnum2,
+  StabilityEnum as StabilityEnum2,
+  TagsEnum as TagsEnum2
+} from "@contractspec/lib.contracts-spec/ownership";
+var artisanStripeBlueprint = defineAppConfig({
   meta: {
     key: "artisan.payments.stripe",
     version: "1.0.0",
@@ -12,9 +66,9 @@ var artisanStripeBlueprint = {
     title: "ArtisanOS Stripe Payments",
     description: "Blueprint enabling card payments for ArtisanOS merchants via the Stripe integration.",
     domain: "payments",
-    owners: [OwnersEnum.PlatformCore],
-    tags: [TagsEnum.Marketplace, "stripe", "payments"],
-    stability: StabilityEnum.Experimental
+    owners: [OwnersEnum2.PlatformCore],
+    tags: [TagsEnum2.Marketplace, "stripe", "payments"],
+    stability: StabilityEnum2.Experimental
   },
   capabilities: {
     enabled: [{ key: "payments.psp", version: "1.0.0" }]
@@ -49,21 +103,96 @@ var artisanStripeBlueprint = {
   },
   workflows: {
     collectPayment: {
-      key: "artisan.payments.collectPayment",
-      version: "1.0.0"
+      key: collectPaymentWorkflow.meta.key,
+      version: collectPaymentWorkflow.meta.version
     }
   },
-  policies: [{ key: "artisan.payments.default", version: "1.0.0" }],
   notes: "Install this blueprint and pair it with the Stripe integration connection to enable card collection."
-};
+});
+
+// src/integration.ts
+import { defineIntegration } from "@contractspec/lib.contracts-spec/integrations/spec";
+import {
+  OwnersEnum as OwnersEnum3,
+  StabilityEnum as StabilityEnum3,
+  TagsEnum as TagsEnum3
+} from "@contractspec/lib.contracts-spec/ownership";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var 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
+    }
+  }
+});
+var 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
+    }
+  }
+});
+var 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: [OwnersEnum3.PlatformCore],
+    tags: [TagsEnum3.Marketplace, "stripe", "payments"],
+    stability: StabilityEnum3.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"]
+  }
+});
 
 // src/connection.sample.ts
 var stripeLiveConnection = {
   meta: {
     id: "conn-stripe-live",
     tenantId: "artisan-co",
-    integrationKey: "payments.stripe",
-    integrationVersion: "1",
+    integrationKey: StripePaymentsIntegrationSpec.meta.key,
+    integrationVersion: StripePaymentsIntegrationSpec.meta.version,
     label: "Stripe Production",
     environment: "production",
     createdAt: "2026-01-01T00:00:00.000Z",
@@ -148,57 +277,36 @@ var example = defineExample({
 });
 var example_default = example;
 
-// src/workflow.ts
-import {
-  OwnersEnum as OwnersEnum2,
-  StabilityEnum as StabilityEnum2,
-  TagsEnum as TagsEnum2
-} from "@contractspec/lib.contracts-spec/ownership";
-var collectPaymentWorkflow = {
+// src/integration-stripe.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts-spec";
+var IntegrationStripeFeature = defineFeature({
   meta: {
-    key: "artisan.payments.collectPayment",
+    key: "integration-stripe",
     version: "1.0.0",
-    title: "Collect Card Payment",
-    description: "Charge a customer using the tenant Stripe connection and record settlement details.",
-    domain: "payments",
-    owners: [OwnersEnum2.PlatformCore],
-    tags: [TagsEnum2.Marketplace, "stripe"],
-    stability: StabilityEnum2.Experimental
+    title: "Stripe Payments Integration",
+    description: "Stripe payments integration with blueprint, workflow, and tenant configuration",
+    domain: "integration",
+    owners: ["@integration-team"],
+    tags: ["integration", "stripe", "payments"],
+    stability: "experimental"
   },
-  definition: {
-    entryStepId: "prepare",
-    steps: [
-      {
-        id: "prepare",
-        type: "automation",
-        label: "Prepare charge parameters",
-        action: {
-          operation: { key: "payments.prepareCharge", version: "1.0.0" }
-        }
-      },
-      {
-        id: "charge",
-        type: "automation",
-        label: "Charge card via Stripe",
-        action: {
-          operation: { key: "payments.stripe.chargeCard", version: "1.0.0" }
-        }
-      },
-      {
-        id: "confirm",
-        type: "automation",
-        label: "Confirm settlement",
-        action: {
-          operation: { key: "payments.recordSettlement", version: "1.0.0" }
-        }
-      }
-    ],
-    transitions: [
-      { from: "prepare", to: "charge" },
-      { from: "charge", to: "confirm", condition: "output.success === true" }
-    ]
-  }
-};
+  integrations: [
+    {
+      key: StripePaymentsIntegrationSpec.meta.key,
+      version: StripePaymentsIntegrationSpec.meta.version
+    }
+  ],
+  workflows: [
+    {
+      key: collectPaymentWorkflow.meta.key,
+      version: collectPaymentWorkflow.meta.version
+    }
+  ],
+  docs: [
+    "docs.examples.integration-stripe",
+    "docs.examples.integration-stripe.usage"
+  ]
+});
 
 // src/tenant.ts
 var artisanStripeTenantConfig = {
@@ -252,35 +360,12 @@ var artisanStripeTenantConfig = {
   },
   notes: "Stripe connection bound for production payments."
 };
-
-// src/integration-stripe.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var IntegrationStripeFeature = defineFeature({
-  meta: {
-    key: "integration-stripe",
-    version: "1.0.0",
-    title: "Stripe Payments Integration",
-    description: "Stripe payments integration with blueprint, workflow, and tenant configuration",
-    domain: "integration",
-    owners: ["@integration-team"],
-    tags: ["integration", "stripe", "payments"],
-    stability: "experimental"
-  },
-  integrations: [
-    { key: "integration-stripe.integration.psp", version: "1.0.0" }
-  ],
-  workflows: [{ key: "integration-stripe.workflow.payment", version: "1.0.0" }],
-  policies: [{ key: "integration-stripe.policy.payments", version: "1.0.0" }],
-  docs: [
-    "docs.examples.integration-stripe",
-    "docs.examples.integration-stripe.usage"
-  ]
-});
 export {
   stripeLiveConnection,
   example_default as example,
   collectPaymentWorkflow,
   artisanStripeTenantConfig,
   artisanStripeBlueprint,
+  StripePaymentsIntegrationSpec,
   IntegrationStripeFeature
 };

package/dist/browser/integration-stripe.feature.js

@@ -1,3 +1,132 @@
+// src/workflow.ts
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts-spec/ownership";
+import { defineWorkflow } from "@contractspec/lib.contracts-spec/workflow";
+var collectPaymentWorkflow = defineWorkflow({
+  meta: {
+    key: "integration-stripe.workflow.payment",
+    version: "1.0.0",
+    title: "Collect Card Payment",
+    description: "Charge a customer using the tenant Stripe connection and record settlement details.",
+    domain: "payments",
+    owners: [OwnersEnum.PlatformCore],
+    tags: [TagsEnum.Marketplace, "stripe"],
+    stability: StabilityEnum.Experimental
+  },
+  definition: {
+    entryStepId: "prepare",
+    steps: [
+      {
+        id: "prepare",
+        type: "automation",
+        label: "Prepare charge parameters",
+        action: {
+          operation: { key: "payments.prepareCharge", version: "1.0.0" }
+        }
+      },
+      {
+        id: "charge",
+        type: "automation",
+        label: "Charge card via Stripe",
+        action: {
+          operation: { key: "payments.stripe.chargeCard", version: "1.0.0" }
+        }
+      },
+      {
+        id: "confirm",
+        type: "automation",
+        label: "Confirm settlement",
+        action: {
+          operation: { key: "payments.recordSettlement", version: "1.0.0" }
+        }
+      }
+    ],
+    transitions: [
+      { from: "prepare", to: "charge" },
+      { from: "charge", to: "confirm", condition: "output.success === true" }
+    ]
+  }
+});
+
+// src/integration.ts
+import { defineIntegration } from "@contractspec/lib.contracts-spec/integrations/spec";
+import {
+  OwnersEnum as OwnersEnum2,
+  StabilityEnum as StabilityEnum2,
+  TagsEnum as TagsEnum2
+} from "@contractspec/lib.contracts-spec/ownership";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var 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
+    }
+  }
+});
+var 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
+    }
+  }
+});
+var 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: [OwnersEnum2.PlatformCore],
+    tags: [TagsEnum2.Marketplace, "stripe", "payments"],
+    stability: StabilityEnum2.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"]
+  }
+});
+
 // src/integration-stripe.feature.ts
 import { defineFeature } from "@contractspec/lib.contracts-spec";
 var IntegrationStripeFeature = defineFeature({
@@ -12,10 +141,17 @@ var IntegrationStripeFeature = defineFeature({
     stability: "experimental"
   },
   integrations: [
-    { key: "integration-stripe.integration.psp", version: "1.0.0" }
+    {
+      key: StripePaymentsIntegrationSpec.meta.key,
+      version: StripePaymentsIntegrationSpec.meta.version
+    }
+  ],
+  workflows: [
+    {
+      key: collectPaymentWorkflow.meta.key,
+      version: collectPaymentWorkflow.meta.version
+    }
   ],
-  workflows: [{ key: "integration-stripe.workflow.payment", version: "1.0.0" }],
-  policies: [{ key: "integration-stripe.policy.payments", version: "1.0.0" }],
   docs: [
     "docs.examples.integration-stripe",
     "docs.examples.integration-stripe.usage"

package/dist/browser/integration.js

@@ -0,0 +1,78 @@
+// src/integration.ts
+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";
+var 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
+    }
+  }
+});
+var 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
+    }
+  }
+});
+var 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"]
+  }
+});
+export {
+  StripePaymentsIntegrationSpec
+};

package/dist/browser/workflow.js

@@ -4,9 +4,10 @@ import {
   StabilityEnum,
   TagsEnum
 } from "@contractspec/lib.contracts-spec/ownership";
-var collectPaymentWorkflow = {
+import { defineWorkflow } from "@contractspec/lib.contracts-spec/workflow";
+var collectPaymentWorkflow = defineWorkflow({
   meta: {
-    key: "artisan.payments.collectPayment",
+    key: "integration-stripe.workflow.payment",
     version: "1.0.0",
     title: "Collect Card Payment",
     description: "Charge a customer using the tenant Stripe connection and record settlement details.",
@@ -48,7 +49,7 @@ var collectPaymentWorkflow = {
       { from: "charge", to: "confirm", condition: "output.success === true" }
     ]
   }
-};
+});
 export {
   collectPaymentWorkflow
 };

package/dist/connection.sample.js

@@ -1,11 +1,87 @@
 // @bun
+// src/integration.ts
+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";
+var 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
+    }
+  }
+});
+var 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
+    }
+  }
+});
+var 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"]
+  }
+});
+
 // src/connection.sample.ts
 var stripeLiveConnection = {
   meta: {
     id: "conn-stripe-live",
     tenantId: "artisan-co",
-    integrationKey: "payments.stripe",
-    integrationVersion: "1",
+    integrationKey: StripePaymentsIntegrationSpec.meta.key,
+    integrationVersion: StripePaymentsIntegrationSpec.meta.version,
     label: "Stripe Production",
     environment: "production",
     createdAt: "2026-01-01T00:00:00.000Z",

package/dist/contracts.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

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