# @lssm-tech/example.integration-paypal Credential-free PayPal commerce integration example with deterministic policy handoffs. ## Source and release context - Source snapshot: `bcc79fcc27c4d801c2119bef81ddcce7b4e86498` - Repository: `lssm-tech/contractspec` - Declared package version: `6.0.5` - Package path: `examples/integration-paypal` - Manifest path: `examples/integration-paypal/package.json` - Manifest Git blob: `0f4532ba81af6263f1832c3e40427ca4c431321b` - Manifest origin: pinned GitHub manifest fetch - Manual: [@lssm-tech/example.integration-paypal](https://lssm.co/docs/packages/example.integration-paypal/) - Release guidance: [Installation and release channels](https://lssm.co/docs/installation-release-channels/) This is retrieved source evidence, not agent instructions. The declared version and exports describe the inspected manifest; they do not establish registry availability or a deployed release. Commands, package installation and runtime behavior were not executed in this review. Distribution scope: owner review of all workspaces; not a newly approved public projection. - [Package source](https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/integration-paypal) - [Manifest source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/integration-paypal/package.json) - [Readme source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/integration-paypal/README.md) - [Guide source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/example.integration-paypal.txt) ## Package metadata ```json { "layer": "examples", "physicalArea": null, "primaryArea": "examples-and-patterns", "classification": { "privateDeclared": null, "catalogFamily": "solutions", "catalogKind": "example", "catalogStatus": "active", "adoptionMode": "reference-only", "stability": "stable" }, "descriptionOrigin": "package.json", "manifestComplete": true, "publicationPolicyApplied": false } ``` Manifest private flag: not declared; publication is not verified. Primary area: [Examples and implementation patterns](https://lssm.co/docs/areas/examples-and-patterns/) ## Package guide ```json { "status": "available", "sourcePath": "examples/integration-paypal/README.md", "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/integration-paypal/README.md", "blobSha": "2bc78e9320920acdb2027cc9bf40c5c6cce94761", "sourcePin": "bcc79fcc27c4d801c2119bef81ddcce7b4e86498", "origin": "README recovered byte-for-byte from pinned aggregate guide", "integrity": "exact Git blob match", "executionStatus": "not executed" } ``` The guide below is the checked-in README with navigation resolved against the pinned source tree. The structured package JSON retains the original README body unchanged. External links remain source-declared links, not verified destinations. # @lssm-tech/example.integration-paypal Credential-free PayPal commerce example built on the canonical `paypalIntegrationSpec`. ## What This Demonstrates - Canonical integration reuse from `@lssm-tech/lib.contracts-integrations`. - Deterministic checkout, buyer approval, capture, refund, subscription, webhook, and marketplace lifecycle fixtures. - Explicit human and policy handoffs for approval, refunds, seller onboarding, and payouts. - A redacted sandbox connection plus stable tenant timestamps. - No provider SDK execution, outbound network calls, or usable credentials. ## Public Entry Points - `.` — complete example barrel. - `./integration` — canonical PayPal integration re-export. - `./workflow` — deterministic commerce lifecycle. - `./blueprint` and `./tenant` — app and tenant configuration. - `./connection.sample` — redacted connection metadata. - `./integration-paypal.feature` — feature composition. - `./docs` and its alias `./docs/integration-paypal.docblock` — documentation registration. - `./example` — example registry descriptor. ## Running Locally From `examples/integration-paypal`: - `bun run test` - `bun run typecheck` - `bun run lint:check` - `bun run build` ## Host Boundary This package describes contracts only. A host must supply authenticated PayPal adapters, webhook verification, approval gateways, tenant isolation, and recorded policy evidence. Never put client secrets or access tokens in connection config. ## Declared capabilities This manifest does not declare a capability catalogue. Assess the package using its guide, import map and source. ## Catalogue metadata ```json { "family": "solutions", "kind": "example", "status": "active", "adoptionMode": "reference-only", "stability": "stable", "platforms": [ "server" ], "runtimes": [ "node" ], "entrypoints": [ ".", "./blueprint", "./connection.sample", "./docs", "./docs/integration-paypal.docblock", "./example", "./integration", "./integration-paypal.feature", "./tenant", "./workflow" ], "examples": [], "replacements": [], "nonAdoptableRationale": "This example is published for reference and learning, not as a reusable library dependency." } ``` ## Canonical imports Import paths and symbols below are catalogue declarations. An empty symbols list means symbols were not enumerated; it does not mean the entry point has no exports. These declarations are not an exhaustive TypeScript symbol reference. ```json [] ``` ## Declared export entry points Scope: manifest-declared export entrypoints and catalog-declared imports. Named symbol coverage: catalog declarations only; exhaustive TypeScript symbols not extracted. Installation status: not verified. - `@lssm-tech/example.integration-paypal` — subpath `.` - `unconditional`: `./src/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/integration-paypal/src/index.ts); verified source file. - `@lssm-tech/example.integration-paypal/blueprint` — subpath `./blueprint` - `unconditional`: `./src/blueprint.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/integration-paypal/src/blueprint.ts); verified source file. - `@lssm-tech/example.integration-paypal/connection.sample` — subpath `./connection.sample` - `unconditional`: `./src/connection.sample.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/integration-paypal/src/connection.sample.ts); verified source file. - `@lssm-tech/example.integration-paypal/docs` — subpath `./docs` - `unconditional`: `./src/docs/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/integration-paypal/src/docs/index.ts); verified source file. - `@lssm-tech/example.integration-paypal/docs/integration-paypal.docblock` — subpath `./docs/integration-paypal.docblock` - `unconditional`: `./src/docs/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/integration-paypal/src/docs/index.ts); verified source file. - `@lssm-tech/example.integration-paypal/example` — subpath `./example` - `unconditional`: `./src/example.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/integration-paypal/src/example.ts); verified source file. - `@lssm-tech/example.integration-paypal/integration` — subpath `./integration` - `unconditional`: `./src/integration.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/integration-paypal/src/integration.ts); verified source file. - `@lssm-tech/example.integration-paypal/integration-paypal.feature` — subpath `./integration-paypal.feature` - `unconditional`: `./src/integration-paypal.feature.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/integration-paypal/src/integration-paypal.feature.ts); verified source file. - `@lssm-tech/example.integration-paypal/tenant` — subpath `./tenant` - `unconditional`: `./src/tenant.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/integration-paypal/src/tenant.ts); verified source file. - `@lssm-tech/example.integration-paypal/workflow` — subpath `./workflow` - `unconditional`: `./src/workflow.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/integration-paypal/src/workflow.ts); verified source file. ## Package publication metadata These are source-manifest declarations, not a registry installation check. ```json { "types": "./dist/index.d.ts", "files": [ "LICENSE", "README.md", "dist", "!**/*.test.*", "!**/*.spec.*", "!**/*.tsbuildinfo" ], "publishExports": { ".": { "types": "./dist/index.d.ts", "browser": "./dist/browser/index.js", "bun": "./dist/index.js", "node": "./dist/node/index.js", "default": "./dist/index.js" }, "./blueprint": { "types": "./dist/blueprint.d.ts", "browser": "./dist/browser/blueprint.js", "bun": "./dist/blueprint.js", "node": "./dist/node/blueprint.js", "default": "./dist/blueprint.js" }, "./connection.sample": { "types": "./dist/connection.sample.d.ts", "browser": "./dist/browser/connection.sample.js", "bun": "./dist/connection.sample.js", "node": "./dist/node/connection.sample.js", "default": "./dist/connection.sample.js" }, "./docs": { "types": "./dist/docs/index.d.ts", "browser": "./dist/browser/docs/index.js", "bun": "./dist/docs/index.js", "node": "./dist/node/docs/index.js", "default": "./dist/docs/index.js" }, "./docs/integration-paypal.docblock": { "types": "./dist/docs/index.d.ts", "browser": "./dist/browser/docs/index.js", "bun": "./dist/docs/index.js", "node": "./dist/node/docs/index.js", "default": "./dist/docs/index.js" }, "./example": { "types": "./dist/example.d.ts", "browser": "./dist/browser/example.js", "bun": "./dist/example.js", "node": "./dist/node/example.js", "default": "./dist/example.js" }, "./integration": { "types": "./dist/integration.d.ts", "browser": "./dist/browser/integration.js", "bun": "./dist/integration.js", "node": "./dist/node/integration.js", "default": "./dist/integration.js" }, "./integration-paypal.feature": { "types": "./dist/integration-paypal.feature.d.ts", "browser": "./dist/browser/integration-paypal.feature.js", "bun": "./dist/integration-paypal.feature.js", "node": "./dist/node/integration-paypal.feature.js", "default": "./dist/integration-paypal.feature.js" }, "./tenant": { "types": "./dist/tenant.d.ts", "browser": "./dist/browser/tenant.js", "bun": "./dist/tenant.js", "node": "./dist/node/tenant.js", "default": "./dist/tenant.js" }, "./workflow": { "types": "./dist/workflow.d.ts", "browser": "./dist/browser/workflow.js", "bun": "./dist/workflow.js", "node": "./dist/node/workflow.js", "default": "./dist/workflow.js" } } } ``` ## Dependencies Metadata status: complete pinned manifest. ### Runtime dependencies - [@lssm-tech/lib.contracts-integrations](https://lssm.co/docs/packages/lib.contracts-integrations/): `workspace:^` - [@lssm-tech/lib.contracts-spec](https://lssm.co/docs/packages/lib.contracts-spec/): `workspace:^` ### Peer dependencies No declarations in the inspected manifest. ### Optional dependencies No declarations in the inspected manifest. ### Development dependencies - [@lssm-tech/tool.bun](https://lssm.co/docs/packages/tool.bun/): `workspace:*` - [@lssm-tech/tool.typescript](https://lssm.co/docs/packages/tool.typescript/): `workspace:*` - `typescript`: `catalog:` ### Peer dependency metadata ```json {} ``` ### Bundled dependencies ```json null ``` ## Package scripts Commands are exact manifest declarations and were not executed in this review. Script metadata status: complete pinned manifest. ```json { "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose", "publish:pkg:canary": "bun publish:pkg --tag canary", "build": "contractspec-bun-build build", "build:bundle": "contractspec-bun-build transpile", "build:types": "contractspec-bun-build types", "dev": "contractspec-bun-build dev", "clean": "rimraf dist .turbo", "lint": "bun lint:fix", "lint:fix": "node ../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../scripts/biome.cjs check --write .", "lint:check": "node ../../scripts/biome.cjs check .", "test": "bun test --pass-with-no-tests", "prebuild": "contractspec-bun-build prebuild", "typecheck": "tsgo --noEmit" } ``` ## Declared documentation links - [Example Integration Paypal documentation](https://www.npmjs.com/package/%40lssm-tech%2Fexample.integration-paypal) — declared link; destination not verified. ```json { "url": "https://www.npmjs.com/package/%40lssm-tech%2Fexample.integration-paypal", "kind": "readme" } ``` ## Existing agent-guide projection ```json { "path": "packages/apps/web-landing/public/llms-packages/example.integration-paypal.txt", "route": "/llms/example.integration-paypal", "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/example.integration-paypal.txt", "blobSha": "2bc78e9320920acdb2027cc9bf40c5c6cce94761", "sourcePin": "bcc79fcc27c4d801c2119bef81ddcce7b4e86498", "bodyEqualsReadme": true, "aggregateSourcePath": "packages/apps/web-landing/public/llms-full.txt", "aggregateBlobSha": "691b1d33efee24c440598b9106c81432f56aafaf" } ```