From 23047e3e98fdafd278f960c037b8f92ea02fbd03 Mon Sep 17 00:00:00 2001 From: Johanan Ottensooser Date: Thu, 18 Sep 2025 17:17:56 -0700 Subject: [PATCH] Update scaffolds and specs for core package architecture MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Update connector scaffold to use @connector-factory/core with ApiConnectorBase - Fix scaffold structure to use domain delegation pattern and Jest testing - Update API specification to document core package architecture properly - Update pipeline scaffold to match actual hubspot-to-clickhouse patterns - Change all GitHub references from "514-labs/factory" to "514-labs/registry" - Add proper dependencies and build configurations to scaffolds 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude --- .../app/api/registry/contents/route.ts | 4 +- .../[language]/[implementation]/page.tsx | 4 +- .../app/docs/connectors/creating/page.tsx | 12 +- .../app/docs/connectors/quickstart/page.tsx | 4 +- .../app/docs/pipelines/creating/page.tsx | 4 +- .../[language]/[implementation]/page.tsx | 2 +- apps/registry-docs/app/registry.json/route.ts | 4 +- apps/registry-docs/components/site-header.tsx | 2 +- apps/registry-docs/content/docs/api.mdx | 2 +- apps/registry-docs/content/docs/create.mdx | 16 +- .../content/docs/creating-connectors.mdx | 4 +- .../content/docs/introduction.mdx | 2 +- .../registry-docs/content/docs/quickstart.mdx | 4 +- .../content/docs/specifications/api.mdx | 233 ++++++++++++++---- apps/registry-docs/public/openapi.yaml | 2 +- connector-registry/_scaffold/python.json | 2 +- connector-registry/_scaffold/typescript.json | 143 ++++++++--- .../hubspot/v3/514-labs/_meta/connector.json | 2 +- pipeline-registry/_scaffold/python.json | 2 +- pipeline-registry/_scaffold/typescript.json | 88 +++++-- .../_meta/pipeline.json | 2 +- .../hubspot-to-clickhouse/_meta/pipeline.json | 2 +- 22 files changed, 393 insertions(+), 147 deletions(-) diff --git a/apps/registry-docs/app/api/registry/contents/route.ts b/apps/registry-docs/app/api/registry/contents/route.ts index 8a1a711d..c54e7cb7 100644 --- a/apps/registry-docs/app/api/registry/contents/route.ts +++ b/apps/registry-docs/app/api/registry/contents/route.ts @@ -31,7 +31,7 @@ export async function GET() { const providerBaseUrl = provider.meta?.registryUrl ?? c.root.meta?.registryUrl ?? - `https://github.com/514-labs/factory/tree/main/connector-registry/${c.connectorId}/${version}/${provider.authorId}`; + `https://github.com/514-labs/registry/tree/main/connector-registry/${c.connectorId}/${version}/${provider.authorId}`; const githubUrl = impl.implementation === "default" @@ -84,7 +84,7 @@ export async function GET() { const providerBaseUrl = p.root.meta?.registryUrl ?? - `https://github.com/514-labs/factory/tree/main/pipeline-registry/${p.pipelineId}/${version}/${provider.authorId}`; + `https://github.com/514-labs/registry/tree/main/pipeline-registry/${p.pipelineId}/${version}/${provider.authorId}`; const githubUrl = impl.implementation === "default" diff --git a/apps/registry-docs/app/connectors/[connector]/[version]/[creator]/[language]/[implementation]/page.tsx b/apps/registry-docs/app/connectors/[connector]/[version]/[creator]/[language]/[implementation]/page.tsx index d6f09ef7..37b96783 100644 --- a/apps/registry-docs/app/connectors/[connector]/[version]/[creator]/[language]/[implementation]/page.tsx +++ b/apps/registry-docs/app/connectors/[connector]/[version]/[creator]/[language]/[implementation]/page.tsx @@ -98,7 +98,7 @@ export default async function ConnectorImplementationPage({ const registryUrl = provider.meta?.registryUrl ?? meta?.registryUrl ?? - `https://github.com/514-labs/factory/tree/main/connector-registry/${connector}/${version}/${creator}`; + `https://github.com/514-labs/registry/tree/main/connector-registry/${connector}/${version}/${creator}`; // Get issue URL for current language/implementation const issueValue = provider.meta?.issues?.[implEntry.language]; @@ -107,7 +107,7 @@ export default async function ConnectorImplementationPage({ ? issueValue : issueValue && typeof issueValue === "object" ? (issueValue[implEntry.implementation] ?? issueValue["default"]) - : `https://github.com/514-labs/factory/issues`; + : `https://github.com/514-labs/registry/issues`; // Build lists and navigation helpers const getProviderVersion = (pPath: string): string => diff --git a/apps/registry-docs/app/docs/connectors/creating/page.tsx b/apps/registry-docs/app/docs/connectors/creating/page.tsx index 0fcce0be..9c159074 100644 --- a/apps/registry-docs/app/docs/connectors/creating/page.tsx +++ b/apps/registry-docs/app/docs/connectors/creating/page.tsx @@ -13,8 +13,8 @@ export default function CreatingConnectorsPage() {

1. Clone the repository

Clone the factory repository to your local machine:

-        {`git clone https://github.com/514-labs/factory.git
-cd factory`}
+        {`git clone https://github.com/514-labs/registry.git
+cd registry`}

2. Generate a connector scaffold

@@ -180,18 +180,18 @@ pnpm validate:schemas`}

8. Share your connector

Open a pull request to the{" "} - - factory repository + + registry repository {" "} to share your connector with the community. Mention the connector{" "} - + Issue {" "} in the PR description.

- If you built your connector outside the factory monorepo, you'll need to + If you built your connector outside the registry monorepo, you'll need to add it to the monorepo's registry directory with all required metadata (defined in `connector-registry/_scaffold`).

diff --git a/apps/registry-docs/app/docs/connectors/quickstart/page.tsx b/apps/registry-docs/app/docs/connectors/quickstart/page.tsx index a662637d..dc898504 100644 --- a/apps/registry-docs/app/docs/connectors/quickstart/page.tsx +++ b/apps/registry-docs/app/docs/connectors/quickstart/page.tsx @@ -16,8 +16,8 @@ export default function ConnectorQuickstartPage() {

1. Clone the Repository

-        {`git clone https://github.com/514-labs/factory.git
-cd factory`}
+        {`git clone https://github.com/514-labs/registry.git
+cd registry`}

2. Generate Your Connector

diff --git a/apps/registry-docs/app/docs/pipelines/creating/page.tsx b/apps/registry-docs/app/docs/pipelines/creating/page.tsx index c4d30c68..4e0626ac 100644 --- a/apps/registry-docs/app/docs/pipelines/creating/page.tsx +++ b/apps/registry-docs/app/docs/pipelines/creating/page.tsx @@ -29,8 +29,8 @@ export default function CreatingPipelinesPage() {

1. Clone the Repository

-        {`git clone https://github.com/514-labs/factory.git
-cd factory`}
+        {`git clone https://github.com/514-labs/registry.git
+cd registry`}

2. Generate Pipeline Scaffold

diff --git a/apps/registry-docs/app/pipelines/[pipeline]/[version]/[creator]/[language]/[implementation]/page.tsx b/apps/registry-docs/app/pipelines/[pipeline]/[version]/[creator]/[language]/[implementation]/page.tsx index cbf04cf6..cdc21e13 100644 --- a/apps/registry-docs/app/pipelines/[pipeline]/[version]/[creator]/[language]/[implementation]/page.tsx +++ b/apps/registry-docs/app/pipelines/[pipeline]/[version]/[creator]/[language]/[implementation]/page.tsx @@ -88,7 +88,7 @@ export default async function PipelineImplementationPage({ // URLs const registryUrl = meta?.registryUrl ?? - `https://github.com/514-labs/factory/tree/main/pipeline-registry/${pipeline}/${version}/${creator}`; + `https://github.com/514-labs/registry/tree/main/pipeline-registry/${pipeline}/${version}/${creator}`; // Build lists and navigation helpers const getProviderVersion = (pPath: string): string => diff --git a/apps/registry-docs/app/registry.json/route.ts b/apps/registry-docs/app/registry.json/route.ts index 7d2c3a40..655bf0ca 100644 --- a/apps/registry-docs/app/registry.json/route.ts +++ b/apps/registry-docs/app/registry.json/route.ts @@ -28,7 +28,7 @@ export async function GET() { const providerBaseUrl = provider.meta?.registryUrl ?? c.root.meta?.registryUrl ?? - `https://github.com/514-labs/factory/tree/main/connector-registry/${c.connectorId}/${version}/${provider.authorId}`; + `https://github.com/514-labs/registry/tree/main/connector-registry/${c.connectorId}/${version}/${provider.authorId}`; const githubUrl = impl.implementation === "default" @@ -73,7 +73,7 @@ export async function GET() { const providerBaseUrl = p.root.meta?.registryUrl ?? - `https://github.com/514-labs/factory/tree/main/pipeline-registry/${p.pipelineId}/${version}/${provider.authorId}`; + `https://github.com/514-labs/registry/tree/main/pipeline-registry/${p.pipelineId}/${version}/${provider.authorId}`; const githubUrl = impl.implementation === "default" diff --git a/apps/registry-docs/components/site-header.tsx b/apps/registry-docs/components/site-header.tsx index e7cd619f..e577b062 100644 --- a/apps/registry-docs/components/site-header.tsx +++ b/apps/registry-docs/components/site-header.tsx @@ -46,7 +46,7 @@ export async function SiteHeader() {