@contractspec/example.integration-stripe 1.57.0 → 1.58.0

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,QAAQ,CAAC"}

package/dist/index.js

@@ -1,8 +1,262 @@
-import { artisanStripeBlueprint } from "./blueprint.js";
-import { stripeLiveConnection } from "./connection.sample.js";
-import example from "./example.js";
-import { collectPaymentWorkflow } from "./workflow.js";
-import { artisanStripeTenantConfig } from "./tenant.js";
-import "./docs/index.js";
-
-export { artisanStripeBlueprint, artisanStripeTenantConfig, collectPaymentWorkflow, example, stripeLiveConnection };
+// @bun
+// src/blueprint.ts
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts/ownership";
+var artisanStripeBlueprint = {
+  meta: {
+    key: "artisan.payments.stripe",
+    version: "1.0.0",
+    appId: "artisan",
+    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
+  },
+  capabilities: {
+    enabled: [{ key: "payments.psp", version: "1.0.0" }]
+  },
+  integrationSlots: [
+    {
+      slotId: "primary-payments",
+      requiredCategory: "payments",
+      allowedModes: ["managed", "byok"],
+      requiredCapabilities: [{ key: "payments.psp", version: "1.0.0" }],
+      required: true,
+      description: "Primary card processor slot. Bind the tenant Stripe connection here."
+    }
+  ],
+  branding: {
+    appNameKey: "artisan.payments.appName",
+    assets: [
+      { type: "logo", url: "https://cdn.artisanos.dev/branding/logo.png" },
+      {
+        type: "favicon",
+        url: "https://cdn.artisanos.dev/branding/favicon.ico"
+      }
+    ],
+    colorTokens: {
+      primary: "colors.brand.primary",
+      secondary: "colors.brand.secondary"
+    }
+  },
+  translationCatalog: {
+    key: "artisan.payments.catalog",
+    version: "1.0.0"
+  },
+  workflows: {
+    collectPayment: {
+      key: "artisan.payments.collectPayment",
+      version: "1.0.0"
+    }
+  },
+  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/connection.sample.ts
+var stripeLiveConnection = {
+  meta: {
+    id: "conn-stripe-live",
+    tenantId: "artisan-co",
+    integrationKey: "payments.stripe",
+    integrationVersion: "1",
+    label: "Stripe Production",
+    environment: "production",
+    createdAt: "2026-01-01T00:00:00.000Z",
+    updatedAt: "2026-01-01T00:00:00.000Z"
+  },
+  ownershipMode: "managed",
+  config: {
+    accountId: "acct_xxx"
+  },
+  secretProvider: "vault",
+  secretRef: "vault://integrations/artisan-co/conn-stripe-live",
+  status: "connected"
+};
+
+// src/docs/integration-stripe.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.integration-stripe",
+    title: "Integration Example \u2014 Stripe Payments",
+    summary: "How to wire IntegrationSpec/TenantAppConfig + blueprint + workflow to enable Stripe-backed payments.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/integration-stripe",
+    tags: ["stripe", "payments", "integrations", "example"],
+    body: `## Included
+- App blueprint enabling \`payments.psp\` capability.
+- Workflow invoking Stripe operations (prepare \u2192 charge \u2192 confirm).
+- Tenant app config binding workflow to an IntegrationConnection.
+
+## Notes
+- Secrets live in secret providers; connection config is non-secret.
+- Use \`ctx.resolvedAppConfig\` in operation executors to access integrations, branding, and translations.`
+  },
+  {
+    id: "docs.examples.integration-stripe.usage",
+    title: "Stripe Integration Example \u2014 Usage",
+    summary: "How to use the blueprint, workflow, and tenant config together.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/integration-stripe/usage",
+    tags: ["stripe", "usage"],
+    body: `## Usage
+1) Register the blueprint + workflow + catalog in your registry.
+2) Persist an IntegrationConnection (see connection sample).
+3) Bind the tenant app config to the connection.
+
+## Guardrails
+- Never log secrets.
+- Keep payment semantics spec-defined; gate breaking changes behind flags.`
+  }
+];
+registerDocBlocks(blocks);
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "integration-stripe",
+    version: "1.0.0",
+    title: "Integration \u2014 Stripe Payments",
+    description: "Wire AppBlueprint + Workflow + TenantAppConfig to enable Stripe-backed payments (spec-first integration pattern).",
+    kind: "integration",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["stripe", "payments", "integration", "blueprint", "workflow"]
+  },
+  docs: {
+    rootDocId: "docs.examples.integration-stripe",
+    usageDocId: "docs.examples.integration-stripe.usage"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.integration-stripe",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ["markdown", "specs"] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+
+// src/workflow.ts
+import {
+  OwnersEnum as OwnersEnum2,
+  StabilityEnum as StabilityEnum2,
+  TagsEnum as TagsEnum2
+} from "@contractspec/lib.contracts/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" }
+    ]
+  }
+};
+
+// src/tenant.ts
+var artisanStripeTenantConfig = {
+  meta: {
+    id: "tenant-config-artisan-stripe",
+    tenantId: "artisan-co",
+    appId: "artisan",
+    blueprintName: "artisan.payments.stripe",
+    blueprintVersion: "1.0.0",
+    environment: "production",
+    version: "1.0.0",
+    status: "published",
+    createdAt: new Date().toISOString(),
+    updatedAt: new Date().toISOString()
+  },
+  integrations: [
+    {
+      slotId: "primary-payments",
+      connectionId: "conn-stripe-live",
+      scope: {
+        workflows: ["collectPayment"],
+        operations: ["payments.stripe.chargeCard"]
+      }
+    }
+  ],
+  knowledge: [],
+  locales: {
+    defaultLocale: "en",
+    enabledLocales: ["en", "fr"]
+  },
+  translationOverrides: {
+    entries: [
+      {
+        key: "artisan.payments.appName",
+        locale: "en",
+        value: "Artisan Payments Portal"
+      }
+    ]
+  },
+  branding: {
+    appName: { en: "Artisan Payments Portal" },
+    assets: [
+      { type: "logo", url: "https://tenant.artisanos.dev/logo.png" },
+      { type: "logo-dark", url: "https://tenant.artisanos.dev/logo-dark.png" }
+    ],
+    colors: {
+      primary: "#F97316",
+      secondary: "#1F2937"
+    },
+    customDomain: "pay.artisanos.dev"
+  },
+  notes: "Stripe connection bound for production payments."
+};
+export {
+  stripeLiveConnection,
+  example_default as example,
+  collectPaymentWorkflow,
+  artisanStripeTenantConfig,
+  artisanStripeBlueprint
+};

package/dist/node/blueprint.js

@@ -0,0 +1,61 @@
+// src/blueprint.ts
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts/ownership";
+var artisanStripeBlueprint = {
+  meta: {
+    key: "artisan.payments.stripe",
+    version: "1.0.0",
+    appId: "artisan",
+    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
+  },
+  capabilities: {
+    enabled: [{ key: "payments.psp", version: "1.0.0" }]
+  },
+  integrationSlots: [
+    {
+      slotId: "primary-payments",
+      requiredCategory: "payments",
+      allowedModes: ["managed", "byok"],
+      requiredCapabilities: [{ key: "payments.psp", version: "1.0.0" }],
+      required: true,
+      description: "Primary card processor slot. Bind the tenant Stripe connection here."
+    }
+  ],
+  branding: {
+    appNameKey: "artisan.payments.appName",
+    assets: [
+      { type: "logo", url: "https://cdn.artisanos.dev/branding/logo.png" },
+      {
+        type: "favicon",
+        url: "https://cdn.artisanos.dev/branding/favicon.ico"
+      }
+    ],
+    colorTokens: {
+      primary: "colors.brand.primary",
+      secondary: "colors.brand.secondary"
+    }
+  },
+  translationCatalog: {
+    key: "artisan.payments.catalog",
+    version: "1.0.0"
+  },
+  workflows: {
+    collectPayment: {
+      key: "artisan.payments.collectPayment",
+      version: "1.0.0"
+    }
+  },
+  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

@@ -0,0 +1,23 @@
+// src/connection.sample.ts
+var stripeLiveConnection = {
+  meta: {
+    id: "conn-stripe-live",
+    tenantId: "artisan-co",
+    integrationKey: "payments.stripe",
+    integrationVersion: "1",
+    label: "Stripe Production",
+    environment: "production",
+    createdAt: "2026-01-01T00:00:00.000Z",
+    updatedAt: "2026-01-01T00:00:00.000Z"
+  },
+  ownershipMode: "managed",
+  config: {
+    accountId: "acct_xxx"
+  },
+  secretProvider: "vault",
+  secretRef: "vault://integrations/artisan-co/conn-stripe-live",
+  status: "connected"
+};
+export {
+  stripeLiveConnection
+};

package/dist/node/docs/index.js

@@ -0,0 +1,39 @@
+// src/docs/integration-stripe.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.integration-stripe",
+    title: "Integration Example — Stripe Payments",
+    summary: "How to wire IntegrationSpec/TenantAppConfig + blueprint + workflow to enable Stripe-backed payments.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/integration-stripe",
+    tags: ["stripe", "payments", "integrations", "example"],
+    body: `## Included
+- App blueprint enabling \`payments.psp\` capability.
+- Workflow invoking Stripe operations (prepare → charge → confirm).
+- Tenant app config binding workflow to an IntegrationConnection.
+
+## Notes
+- Secrets live in secret providers; connection config is non-secret.
+- Use \`ctx.resolvedAppConfig\` in operation executors to access integrations, branding, and translations.`
+  },
+  {
+    id: "docs.examples.integration-stripe.usage",
+    title: "Stripe Integration Example — Usage",
+    summary: "How to use the blueprint, workflow, and tenant config together.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/integration-stripe/usage",
+    tags: ["stripe", "usage"],
+    body: `## Usage
+1) Register the blueprint + workflow + catalog in your registry.
+2) Persist an IntegrationConnection (see connection sample).
+3) Bind the tenant app config to the connection.
+
+## Guardrails
+- Never log secrets.
+- Keep payment semantics spec-defined; gate breaking changes behind flags.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/node/docs/integration-stripe.docblock.js

@@ -0,0 +1,39 @@
+// src/docs/integration-stripe.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.integration-stripe",
+    title: "Integration Example — Stripe Payments",
+    summary: "How to wire IntegrationSpec/TenantAppConfig + blueprint + workflow to enable Stripe-backed payments.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/integration-stripe",
+    tags: ["stripe", "payments", "integrations", "example"],
+    body: `## Included
+- App blueprint enabling \`payments.psp\` capability.
+- Workflow invoking Stripe operations (prepare → charge → confirm).
+- Tenant app config binding workflow to an IntegrationConnection.
+
+## Notes
+- Secrets live in secret providers; connection config is non-secret.
+- Use \`ctx.resolvedAppConfig\` in operation executors to access integrations, branding, and translations.`
+  },
+  {
+    id: "docs.examples.integration-stripe.usage",
+    title: "Stripe Integration Example — Usage",
+    summary: "How to use the blueprint, workflow, and tenant config together.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/integration-stripe/usage",
+    tags: ["stripe", "usage"],
+    body: `## Usage
+1) Register the blueprint + workflow + catalog in your registry.
+2) Persist an IntegrationConnection (see connection sample).
+3) Bind the tenant app config to the connection.
+
+## Guardrails
+- Never log secrets.
+- Keep payment semantics spec-defined; gate breaking changes behind flags.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/node/example.js

@@ -0,0 +1,33 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "integration-stripe",
+    version: "1.0.0",
+    title: "Integration — Stripe Payments",
+    description: "Wire AppBlueprint + Workflow + TenantAppConfig to enable Stripe-backed payments (spec-first integration pattern).",
+    kind: "integration",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["stripe", "payments", "integration", "blueprint", "workflow"]
+  },
+  docs: {
+    rootDocId: "docs.examples.integration-stripe",
+    usageDocId: "docs.examples.integration-stripe.usage"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.integration-stripe",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ["markdown", "specs"] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};