@ecommy/connector-core
v0.2.0
Published
Connector core infra — EcommyConnector base, 6-state lifecycle FSM (O133), ingest envelope, manifest interpreter (O130), ecommy-connector CLI (O131), SSOT-codegen types. Phase A = READ-ONLY ingest.
Readme
@ecommy/connector-core
The foundation every Ecommy connector is built on. Shared, provider-agnostic
infra: the EcommyConnector base class, the 6-state lifecycle FSM (O133), the
ingest envelope, the low-code manifest interpreter (O130), catalog helpers,
SSOT-generated types, and the ecommy-connector scaffolding CLI (O131).
Phase A is READ-ONLY ingest: connectors fetch/receive provider data and emit
source-shape IngestEnvelope records; canonical normalisation happens downstream.
Install
npm install @ecommy/connector-core # see docs/connectors/CONSUMER.md for the registry/token setupUse
import {
EcommyConnector,
parseManifest,
type ConnectorContext,
type IngestEnvelope,
} from "@ecommy/connector-core";You normally install a connector package (e.g. @ecommy/connector-shopify),
which pulls this in transitively. Build a brand-new connector as its own package:
ecommy-connector init --source <name> --mode <code|manifest>Full guide: docs/connectors/CONSUMER.md.
