integration.providers-impls
Integration provider implementations for email, payments, storage, and more
@lssm-tech/integration.providers-implsbun add @lssm-tech/integration.providers-implsManifest declarations describe the current workspace; they do not verify registry publication or runtime execution.
Package guide
Website: https://contractspec.io
Compatibility facade and all-provider factory for ContractSpec provider implementations.
What It Provides
- Layer: integration.
- Consumers: bundles, apps, and modules that still need the broad compatibility surface or the all-provider factory.
- Targeted provider implementation packages now own the concrete domains, such as
@lssm-tech/integration.provider-email,@lssm-tech/integration.provider-payments,@lssm-tech/integration.provider-voice, and@lssm-tech/integration.provider-project-management. - Governed scraping, research, browser automation, and residential proxy adapters are canonical in
@lssm-tech/integration.provider-web-accessand re-exported from./web-access. - Related ContractSpec packages include
@lssm-tech/integration.runtime,@lssm-tech/lib.contracts-integrations,@lssm-tech/lib.contracts-spec,@lssm-tech/tool.bun, and@lssm-tech/tool.typescript.
Installation
npm install @lssm-tech/integration.providers-impls
or
bun add @lssm-tech/integration.providers-impls
Usage
Prefer a targeted package when you only need one provider domain:
import { GmailInboundProvider } from '@lssm-tech/integration.provider-email/impls/gmail-inbound';
import { StripePaymentsProvider } from '@lssm-tech/integration.provider-payments/impls/stripe-payments';
import { TavilyAdapter } from '@lssm-tech/integration.provider-web-access';Existing imports from @lssm-tech/integration.providers-impls and its ./impls/* subpaths remain supported as compatibility re-exports. Keep using this package for IntegrationProviderFactory or when you intentionally need the broad composition surface.
FullEnrich remains canonical in this package until the repository integration dependency-governance source rule explicitly permits the aggregator-to-provider edge. This defers only physical extraction: the API, secret-reference factory, webhook helpers, error normalization, and hosted-MCP descriptor remain available from ./impls/fullenrich-sales-intelligence*.
Communication Coverage
IntegrationProviderFactory now covers the main OSS communication paths directly:
createEmailInboundProvider(...)for Gmail thread/message synccreateEmailOutboundProvider(...)for Gmail and Postmark deliverycreateSmsProvider(...)for Twilio SMScreateMessagingProvider(...)for Telegram, WhatsApp Meta, and WhatsApp Twilio
Architecture
src/analytics.ts,src/calendar.ts,src/database.ts,src/email.ts,src/embedding.ts, and the other domain files are compatibility re-exports to targeted packages.src/impls/provider-factory.tsowns the all-provider factory and imports targeted packages.src/impls/composio-*owns the cross-domain Composio fallback/proxy surface.src/impls/*provider implementation files are compatibility re-exports to targeted packages.src/index.tsis the root public barrel and package entrypoint.
Targeted Packages
@lssm-tech/integration.provider-analytics@lssm-tech/integration.provider-calendar@lssm-tech/integration.provider-database@lssm-tech/integration.provider-email@lssm-tech/integration.provider-embedding@lssm-tech/integration.provider-health@lssm-tech/integration.provider-llm@lssm-tech/integration.provider-meeting-recorder@lssm-tech/integration.provider-messaging@lssm-tech/integration.provider-openbanking@lssm-tech/integration.provider-payments@lssm-tech/integration.provider-project-management@lssm-tech/integration.provider-instagram@lssm-tech/integration.provider-sms@lssm-tech/integration.provider-storage@lssm-tech/integration.provider-tiktok@lssm-tech/integration.provider-vector-store@lssm-tech/integration.provider-voice@lssm-tech/integration.provider-web-access@lssm-tech/integration.provider-x@lssm-tech/integration.provider-youtube
Social providers
The social provider facade exposes namespaced social.youtube, social.tiktok, social.instagram, and social.x targeted packages. They support only accounts that explicitly connect through official APIs; they do not provide scraping, cookie authentication, unapproved public-account discovery, or write effects. Vendor MCP is unavailable until a provider documents an endpoint and an integrator configures its authenticated connection.
createOfficialSocialTrackingSources composes the four official tracking adapters with opaque credential resolvers. Applications can pass those sources to the social tracking runtime, then add an approved connector or the runtime's tenant-opt-in public metadata source without coupling provider packages to one another.
Public Entry Points
- Export
.resolves through./src/index.ts. - Export
./analyticsresolves through./src/analytics.ts. - Export
./calendarresolves through./src/calendar.ts. - Export
./databaseresolves through./src/database.ts. - Export
./emailresolves through./src/email.ts. - Export
./embeddingresolves through./src/embedding.ts. - Export
./healthresolves through./src/health.ts. - Export
./web-accessresolves through./src/web-access.tsand remains a compatibility re-export of the targeted web-access package. - Export
./implsresolves through./src/impls/index.ts. - Export
./impls/pioneer-airesolves through./src/impls/pioneer-ai.ts. - Export
./impls/slng-voiceresolves through./src/impls/slng-voice.ts. - Export
./impls/async-event-queueresolves through./src/impls/async-event-queue.ts. - Export
./impls/composio-fallback-resolverresolves through./src/impls/composio-fallback-resolver.ts. - The package publishes 81 total export subpaths; keep docs aligned with
package.json.
Local Commands
bun run dev— contractspec-bun-build devbun run build— contractspec-bun-build buildbun run test— bun testbun run lint— bun lint:fixbun run lint:check— biome check .bun run lint:fix— biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .bun run typecheck— tsgo --noEmitbun run publish:pkg— bun publish --tolerate-republish --ignore-scripts --verbosebun run publish:pkg:canary— bun publish:pkg --tag canarybun run clean— rimraf dist .turbobun run build:bundle— contractspec-bun-build transpilebun run build:types— contractspec-bun-build typesbun run prebuild— contractspec-bun-build prebuild
Recent Updates
- Missing dependencies (thanks to knip).
- Replace eslint+prettier by biomejs to optimize speed.
- Resolve lint, build, and type errors across nine packages.
- Resolve lint, build, and test failures across voice, workspace, library, and composio.
- Composio.
- Normalize formatting across contracts-integrations, composio, and observability.
Notes
- Every implementation must satisfy a contract from
contracts-integrations. - Never import from apps or bundles.
- Secrets must flow through
@lssm-tech/integration.runtime; never hard-code credentials. - Composio fallback is opt-in; existing code paths are unchanged when config is absent.
- Composio proxy adapters must not leak Composio-specific types into domain interfaces.
@lssm-tech/integration.provider-pioneer-aifor mock-first Pioneer AI self-improvement job/evaluation integration.
Sales intelligence compatibility adapters
./impls/fullenrich-sales-intelligenceexports a mockable FullEnrich adapter for credits, API-key validation, search, lookup, async enrichment starts, webhook normalization, and remote MCP metadata. The adapter accepts an injected transport so tests never call live provider APIs and redacts API keys, tokens, emails, and phone-like fields from normalized output../impls/sillage-sales-intelligenceexports a fail-closed Sillage adapter that returns/throwsSILLAGE_VENDOR_DOCS_REQUIRED. It performs no network call until official vendor docs or confirmed schemas are available.
The @lssm-tech/integration.providers-impls/builder-execution entry collects the existing Codex and OpenCode Go execution constants, preflight checks, and receipt constructors. It forwards the canonical provider implementations and leaves execution settings and approval policy with the caller.
Relationships
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
32 declarations
@lssm-tech/integration.provider-analyticsworkspace:^
Read the package manual ↗@lssm-tech/integration.provider-calendarworkspace:^
Read the package manual ↗@lssm-tech/integration.provider-databaseworkspace:^
Read the package manual ↗@lssm-tech/integration.provider-emailworkspace:^
Read the package manual ↗@lssm-tech/integration.provider-embeddingworkspace:^
Read the package manual ↗@lssm-tech/integration.provider-healthworkspace:^
Read the package manual ↗
Declared capabilities
Integration provider implementations for email, payments, storage, and more
Collect the existing canonical Codex and OpenCode Go execution adapters without changing execution policy.
Scripts
publish:pkgbun publish --tolerate-republish --ignore-scripts --verbosepublish:pkg:canarybun publish:pkg --tag canarybuildcontractspec-bun-build buildbuild:bundlecontractspec-bun-build transpilebuild:typescontractspec-bun-build typesdevcontractspec-bun-build devcleanrimraf dist .turbolintbun lint:fixlint:fixnode ../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../scripts/biome.cjs check --write .lint:checknode ../../../scripts/biome.cjs check .testbun testprebuildcontractspec-bun-build prebuildtypechecktsgo --noEmit