@zapier/connectors-dev-config

Zapier's connector policy for @zapier/connectors-dev, shipped as an extends: preset. @zapier/connectors-dev is brand-neutral; this package layers on the Zapier-specific rules and naming the monorepo (and connector-factory) enforce.

Usage

In a repo's connectors-dev.config.ts:

import { defineConnectorsDevConfig } from "@zapier/connectors-dev";

export default defineConnectorsDevConfig({
  extends: ["@zapier/connectors-dev-config"],
});

connectors-dev validate / --fix and scaffold-connector then apply the preset below on top of the builtin rules.

What the preset enforces

• packageNamePattern: "@zapier/{name}-connector" — every connector's package.json name is scoped ({name} is the slug / directory basename). The builtin default is the unscoped {name}-connector.
• license — byte-identical sync of the connector LICENSE (Elastic-2.0) from this package's assets/LICENSE.
• license-value (fixable) — the license value must be Elastic-2.0 in both package.json and the SKILL.md frontmatter. --fix writes both. The brand-neutral builtin skill-license rule only checks the two agree; this pins the value.
• bugs-url (fixable) — package.json bugs must be https://github.com/zapier/connectors/issues, so npm's "Report a bug" link sends users to the connectors catalog's issue tracker. --fix writes the value.
• notice — generates each connector's NOTICE from SKILL.md metadata.title.
• legal — splices the post-H1 disclaimer (SKILL.md + README.md) and the trailing ## Legal section (README.md) from metadata.title.
• folder-name — the connector's directory basename must equal the slug (the {name} segment of its package name): the apps/<slug>/ convention.
• source-url (fixable) — metadata.source must be the connector's canonical GitHub permalink (https://github.com/zapier/connectors/blob/main/apps/<slug>/SKILL.md). --fix rewrites the frontmatter line. The preset drops the brand-neutral builtin source rule (ignoreRules: ["source"]) since this is a strict superset.
• content-hygiene — agent-visible files (SKILL.md, scripts/*.ts, lib/*.ts, references/*.md, evals/evals.json) must not leak absolute filesystem paths (/Users/, C:\Users\), reference the openapi-polished.yaml build artifact, or carry a CODEGEN: polish needed marker. Reports one finding per offending line (with file + line); non-fixable. Zapier-factory-specific, so it lives here rather than in the brand-neutral @zapier/connectors-dev.
• todo-marker — SKILL.md, README.md, and every file under references/ may not carry an unresolved <!-- TODO: ... --> marker — the fill-in-the-blank placeholders scaffold-connector's templates seed for the author. Scoped to those targets rather than every .md in the connector directory so a CHANGELOG.md entry that merely mentions the marker in prose doesn't false-positive. Reports one finding per offending line (with file + line); non-fixable, since a TODO needs a human to resolve.

Each rule is also exported by name (licenseRule, licenseValueRule, bugsUrlRule, noticeRule, legalRule, folderNameRule, sourceUrlRule, contentHygieneRule, todoMarkerRule) for direct reuse or testing.