@contractspec/example.integration-stripe 3.7.7 → 3.7.10

package/dist/index.js

@@ -1,11 +1,65 @@
 // @bun
-// 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",
@@ -13,9 +67,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" }]
@@ -50,21 +104,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",
@@ -163,10 +292,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"
@@ -225,63 +361,12 @@ var artisanStripeTenantConfig = {
   },
   notes: "Stripe connection bound for production payments."
 };
-
-// src/workflow.ts
-import {
-  OwnersEnum as OwnersEnum2,
-  StabilityEnum as StabilityEnum2,
-  TagsEnum as TagsEnum2
-} from "@contractspec/lib.contracts-spec/ownership";
-var collectPaymentWorkflow = {
-  meta: {
-    key: "artisan.payments.collectPayment",
-    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
-  },
-  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" }
-    ]
-  }
-};
 export {
   stripeLiveConnection,
   example_default as example,
   collectPaymentWorkflow,
   artisanStripeTenantConfig,
   artisanStripeBlueprint,
+  StripePaymentsIntegrationSpec,
   IntegrationStripeFeature
 };

package/dist/integration-stripe.feature.js

@@ -1,4 +1,133 @@
 // @bun
+// 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({
@@ -13,10 +142,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/integration.d.ts

@@ -0,0 +1 @@
+export declare const StripePaymentsIntegrationSpec: import("@contractspec/lib.contracts-spec/integrations/spec").IntegrationSpec;

package/dist/integration.js

@@ -0,0 +1,79 @@
+// @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"]
+  }
+});
+export {
+  StripePaymentsIntegrationSpec
+};

package/dist/node/blueprint.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,13 +103,12 @@ 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."
-};
+});
 export {
   artisanStripeBlueprint
 };

package/dist/node/connection.sample.js

@@ -1,10 +1,86 @@
+// 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",