@perpetualsystems/connector-registry 202605.30.1

package/dist/build-entry.d.ts

@@ -0,0 +1,6 @@
+/** Build-time exports for scripts and CI (not required at runtime in simba). */
+export { buildConnectorRegistryManifest, connectorKindFromPackageName, DEFAULT_CONNECTORS_ECR_REGISTRY, defaultRepoRoot, discoverConnectorPackageNames, loadConnectorHandler, readConnectorPackageVersion, readPerpetualRegistryMetadata, resolveConnectorsEcrRegistry, resolveEcrImageUrl, settingsSchemaFromZod, type PerpetualRegistryMetadata, } from "./build-registry.js";
+export { calVerBaseFromDate, nextRegistryCalVerVersion, } from "./calver.js";
+export { assertEcrImageUrlImmutable, assertSettingsSchemaInlined, validateConnectorRegistry, } from "./validate.js";
+export { connectorRegistryEntrySchema, connectorRegistryManifestSchema, createConnectorRegistry, DRAFT_07_SCHEMA_URI, parseConnectorRegistryManifest, type ConnectorRegistry, type ConnectorRegistryEntry, type ConnectorRegistryManifest, } from "./schemas.js";
+//# sourceMappingURL=build-entry.d.ts.map

package/dist/build-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-entry.d.ts","sourceRoot":"","sources":["../src/build-entry.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,EAC5B,+BAA+B,EAC/B,eAAe,EACf,6BAA6B,EAC7B,oBAAoB,EACpB,2BAA2B,EAC3B,6BAA6B,EAC7B,4BAA4B,EAC5B,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,yBAAyB,GAC/B,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,uBAAuB,EACvB,mBAAmB,EACnB,8BAA8B,EAC9B,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,GAC/B,MAAM,cAAc,CAAA"}

package/dist/build-entry.js

@@ -0,0 +1,6 @@
+/** Build-time exports for scripts and CI (not required at runtime in simba). */
+export { buildConnectorRegistryManifest, connectorKindFromPackageName, DEFAULT_CONNECTORS_ECR_REGISTRY, defaultRepoRoot, discoverConnectorPackageNames, loadConnectorHandler, readConnectorPackageVersion, readPerpetualRegistryMetadata, resolveConnectorsEcrRegistry, resolveEcrImageUrl, settingsSchemaFromZod, } from "./build-registry.js";
+export { calVerBaseFromDate, nextRegistryCalVerVersion, } from "./calver.js";
+export { assertEcrImageUrlImmutable, assertSettingsSchemaInlined, validateConnectorRegistry, } from "./validate.js";
+export { connectorRegistryEntrySchema, connectorRegistryManifestSchema, createConnectorRegistry, DRAFT_07_SCHEMA_URI, parseConnectorRegistryManifest, } from "./schemas.js";
+//# sourceMappingURL=build-entry.js.map

package/dist/build-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-entry.js","sourceRoot":"","sources":["../src/build-entry.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,EAC5B,+BAA+B,EAC/B,eAAe,EACf,6BAA6B,EAC7B,oBAAoB,EACpB,2BAA2B,EAC3B,6BAA6B,EAC7B,4BAA4B,EAC5B,kBAAkB,EAClB,qBAAqB,GAEtB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,uBAAuB,EACvB,mBAAmB,EACnB,8BAA8B,GAI/B,MAAM,cAAc,CAAA"}

package/dist/build-registry.d.ts

@@ -0,0 +1,36 @@
+import { type AnyConnectorHandler } from "@perpetualsystems/connector-sdk";
+import { z } from "zod";
+import { type ConnectorRegistryManifest } from "./schemas.js";
+export declare const defaultRepoRoot: string;
+declare const perpetualRegistrySchema: z.ZodObject<{
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    iconUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    displayName: string;
+    iconUrl?: string | undefined;
+    description?: string | undefined;
+}, {
+    displayName: string;
+    iconUrl?: string | undefined;
+    description?: string | undefined;
+}>;
+export type PerpetualRegistryMetadata = z.infer<typeof perpetualRegistrySchema>;
+/** Default Perpetual connectors ECR registry (override with CONNECTORS_ECR_REGISTRY). */
+export declare const DEFAULT_CONNECTORS_ECR_REGISTRY = "718287746078.dkr.ecr.us-east-2.amazonaws.com";
+export declare function readConnectorPackageVersion(packageName: string, repoRoot?: string): Promise<string>;
+export declare function discoverConnectorPackageNames(repoRoot?: string): Promise<string[]>;
+export declare function connectorKindFromPackageName(packageName: string): string;
+export declare function resolveConnectorsEcrRegistry(): string;
+export declare function resolveEcrImageUrl(args: {
+    packageName: string;
+    connectorKind: string;
+    connectorVersion: string;
+    registry?: string;
+}): string;
+export declare function readPerpetualRegistryMetadata(packageName: string, repoRoot?: string): Promise<PerpetualRegistryMetadata>;
+export declare function settingsSchemaFromZod(config: z.ZodType): Record<string, unknown>;
+export declare function loadConnectorHandler(packageName: string, repoRoot?: string): Promise<AnyConnectorHandler>;
+export declare function buildConnectorRegistryManifest(repoRoot?: string): Promise<ConnectorRegistryManifest>;
+export {};
+//# sourceMappingURL=build-registry.d.ts.map

package/dist/build-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-registry.d.ts","sourceRoot":"","sources":["../src/build-registry.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,cAAc,CAAA;AAErB,eAAO,MAAM,eAAe,QAAkC,CAAA;AAQ9D,QAAA,MAAM,uBAAuB;;;;;;;;;;;;EAI3B,CAAA;AAEF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE/E,yFAAyF;AACzF,eAAO,MAAM,+BAA+B,iDACI,CAAA;AAIhD,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,MAAwB,GACjC,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,6BAA6B,CACjD,QAAQ,GAAE,MAAwB,GACjC,OAAO,CAAC,MAAM,EAAE,CAAC,CA6BnB;AAED,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKxE;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAKrD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,GAAG,MAAM,CAUT;AAED,wBAAsB,6BAA6B,CACjD,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,MAAwB,GACjC,OAAO,CAAC,yBAAyB,CAAC,CAapC;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,CAAC,CAAC,OAAO,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAED,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,MAAwB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CA6B9B;AAED,wBAAsB,8BAA8B,CAClD,QAAQ,GAAE,MAAwB,GACjC,OAAO,CAAC,yBAAyB,CAAC,CAkCpC"}

package/dist/build-registry.js

@@ -0,0 +1,147 @@
+import { readdir, readFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { isStreamingConnectorHandler, } from "@perpetualsystems/connector-sdk";
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { connectorRegistryManifestSchema, DRAFT_07_SCHEMA_URI, } from "./schemas.js";
+const packageDir = dirname(fileURLToPath(import.meta.url));
+export const defaultRepoRoot = resolve(packageDir, "../../..");
+const PUBLISH_EXCLUDED_PACKAGES = new Set([
+    "connector-sdk",
+    "connector-cli",
+    "connector-registry",
+]);
+const perpetualRegistrySchema = z.object({
+    displayName: z.string().min(1),
+    description: z.string().optional(),
+    iconUrl: z.string().url().optional(),
+});
+/** Default Perpetual connectors ECR registry (override with CONNECTORS_ECR_REGISTRY). */
+export const DEFAULT_CONNECTORS_ECR_REGISTRY = "718287746078.dkr.ecr.us-east-2.amazonaws.com";
+const CONNECTOR_PACKAGE_SUFFIX = "-connector";
+export async function readConnectorPackageVersion(packageName, repoRoot = defaultRepoRoot) {
+    const raw = await readFile(join(repoRoot, "packages", packageName, "package.json"), "utf8");
+    const pkg = JSON.parse(raw);
+    const version = pkg.version?.trim();
+    if (!version) {
+        throw new Error(`packages/${packageName}/package.json: version is required`);
+    }
+    if (/^latest$/i.test(version)) {
+        throw new Error(`packages/${packageName}/package.json: version must not be "latest"`);
+    }
+    return version;
+}
+export async function discoverConnectorPackageNames(repoRoot = defaultRepoRoot) {
+    const packagesDir = join(repoRoot, "packages");
+    const names = await readdir(packagesDir);
+    const publishable = [];
+    for (const name of names.sort()) {
+        if (PUBLISH_EXCLUDED_PACKAGES.has(name)) {
+            continue;
+        }
+        const packageJsonPath = join(packagesDir, name, "package.json");
+        try {
+            const raw = await readFile(packageJsonPath, "utf8");
+            const pkg = JSON.parse(raw);
+            if (pkg.perpetualRegistry) {
+                publishable.push(name);
+            }
+        }
+        catch {
+            // not a connector package
+        }
+    }
+    if (publishable.length === 0) {
+        throw new Error("No publishable connector packages found (add perpetualRegistry to package.json)");
+    }
+    return publishable;
+}
+export function connectorKindFromPackageName(packageName) {
+    if (packageName.endsWith(CONNECTOR_PACKAGE_SUFFIX)) {
+        return packageName.slice(0, -CONNECTOR_PACKAGE_SUFFIX.length);
+    }
+    return packageName;
+}
+export function resolveConnectorsEcrRegistry() {
+    return (process.env.CONNECTORS_ECR_REGISTRY?.replace(/\/$/, "") ??
+        DEFAULT_CONNECTORS_ECR_REGISTRY);
+}
+export function resolveEcrImageUrl(args) {
+    const kindFromPackage = connectorKindFromPackageName(args.packageName);
+    if (args.connectorKind !== kindFromPackage) {
+        throw new Error(`Connector id "${args.connectorKind}" must match package name "${args.packageName}" (expected id "${kindFromPackage}")`);
+    }
+    const registry = args.registry ?? resolveConnectorsEcrRegistry();
+    return `${registry}/perpetual-connectors/${args.connectorKind}:${args.connectorVersion}`;
+}
+export async function readPerpetualRegistryMetadata(packageName, repoRoot = defaultRepoRoot) {
+    const raw = await readFile(join(repoRoot, "packages", packageName, "package.json"), "utf8");
+    const pkg = JSON.parse(raw);
+    const parsed = perpetualRegistrySchema.safeParse(pkg.perpetualRegistry);
+    if (!parsed.success) {
+        throw new Error(`packages/${packageName}/package.json perpetualRegistry: ${parsed.error.message}`);
+    }
+    return parsed.data;
+}
+export function settingsSchemaFromZod(config) {
+    const generated = zodToJsonSchema(config, {
+        $refStrategy: "none",
+    });
+    const { definitions: _definitions, $ref: _ref, ...schema } = generated;
+    return {
+        ...schema,
+        $schema: DRAFT_07_SCHEMA_URI,
+    };
+}
+export async function loadConnectorHandler(packageName, repoRoot = defaultRepoRoot) {
+    const entryPath = join(repoRoot, "packages", packageName, "dist/index.js");
+    const mod = (await import(pathToFileURL(entryPath).href));
+    const connector = mod.connector;
+    if (!connector?.id || !connector.config) {
+        throw new Error(`${packageName} must export \`connector\` from definePollingConnector(...) or defineStreamingConnector(...)`);
+    }
+    if (isStreamingConnectorHandler(connector)) {
+        if (!connector.lagUnit) {
+            throw new Error(`${packageName} streaming connector must declare lagUnit`);
+        }
+        return connector;
+    }
+    if (!("state" in connector) || !connector.state) {
+        throw new Error(`${packageName} polling connector must export state schema from definePollingConnector(...)`);
+    }
+    return connector;
+}
+export async function buildConnectorRegistryManifest(repoRoot = defaultRepoRoot) {
+    const packageNames = await discoverConnectorPackageNames(repoRoot);
+    const connectors = [];
+    for (const packageName of packageNames) {
+        const [handler, metadata, connectorVersion] = await Promise.all([
+            loadConnectorHandler(packageName, repoRoot),
+            readPerpetualRegistryMetadata(packageName, repoRoot),
+            readConnectorPackageVersion(packageName, repoRoot),
+        ]);
+        connectors.push({
+            kind: handler.id,
+            displayName: metadata.displayName,
+            connectorType: isStreamingConnectorHandler(handler)
+                ? "streaming"
+                : "polling",
+            ...(isStreamingConnectorHandler(handler)
+                ? { lagUnit: handler.lagUnit }
+                : {}),
+            ecrImageUrl: resolveEcrImageUrl({
+                packageName,
+                connectorKind: handler.id,
+                connectorVersion,
+            }),
+            ...(metadata.description !== undefined
+                ? { description: metadata.description }
+                : {}),
+            ...(metadata.iconUrl !== undefined ? { iconUrl: metadata.iconUrl } : {}),
+            settingsSchema: settingsSchemaFromZod(handler.config),
+        });
+    }
+    return connectorRegistryManifestSchema.parse({ connectors });
+}
+//# sourceMappingURL=build-registry.js.map

package/dist/build-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-registry.js","sourceRoot":"","sources":["../src/build-registry.ts"],"names":[],"mappings":"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"}

package/dist/bundled-manifest.d.ts

@@ -0,0 +1,6 @@
+import { type ConnectorRegistry, type ConnectorRegistryManifest } from "./schemas.js";
+/** Manifest JSON shipped in the published package (`dist/manifest.json`). */
+export declare function getBundledConnectorRegistryManifest(): ConnectorRegistryManifest;
+/** Built-in connector lookup from the bundled manifest. */
+export declare function getBundledConnectorRegistry(): ConnectorRegistry;
+//# sourceMappingURL=bundled-manifest.d.ts.map

package/dist/bundled-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-manifest.d.ts","sourceRoot":"","sources":["../src/bundled-manifest.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAG/B,MAAM,cAAc,CAAA;AAUrB,6EAA6E;AAC7E,wBAAgB,mCAAmC,IAAI,yBAAyB,CAM/E;AAED,2DAA2D;AAC3D,wBAAgB,2BAA2B,IAAI,iBAAiB,CAO/D"}

package/dist/bundled-manifest.js

@@ -0,0 +1,23 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { connectorRegistryManifestSchema, createConnectorRegistry, } from "./schemas.js";
+const manifestPath = join(dirname(fileURLToPath(import.meta.url)), "manifest.json");
+let cachedManifest;
+let cachedRegistry;
+/** Manifest JSON shipped in the published package (`dist/manifest.json`). */
+export function getBundledConnectorRegistryManifest() {
+    if (!cachedManifest) {
+        const raw = readFileSync(manifestPath, "utf8");
+        cachedManifest = connectorRegistryManifestSchema.parse(JSON.parse(raw));
+    }
+    return cachedManifest;
+}
+/** Built-in connector lookup from the bundled manifest. */
+export function getBundledConnectorRegistry() {
+    if (!cachedRegistry) {
+        cachedRegistry = createConnectorRegistry(getBundledConnectorRegistryManifest());
+    }
+    return cachedRegistry;
+}
+//# sourceMappingURL=bundled-manifest.js.map

package/dist/bundled-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-manifest.js","sourceRoot":"","sources":["../src/bundled-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAGL,+BAA+B,EAC/B,uBAAuB,GACxB,MAAM,cAAc,CAAA;AAErB,MAAM,YAAY,GAAG,IAAI,CACvB,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EACvC,eAAe,CAChB,CAAA;AAED,IAAI,cAAqD,CAAA;AACzD,IAAI,cAA6C,CAAA;AAEjD,6EAA6E;AAC7E,MAAM,UAAU,mCAAmC;IACjD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;QAC9C,cAAc,GAAG,+BAA+B,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;IACzE,CAAC;IACD,OAAO,cAAc,CAAA;AACvB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,2BAA2B;IACzC,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,cAAc,GAAG,uBAAuB,CACtC,mCAAmC,EAAE,CACtC,CAAA;IACH,CAAC;IACD,OAAO,cAAc,CAAA;AACvB,CAAC"}

package/dist/calver.d.ts

@@ -0,0 +1,20 @@
+/**
+ * CalVer npm versions for @perpetualsystems/connector-registry.
+ *
+ * Format: `YYYYMM.D.S` as semver major.minor.patch where YYYYMM is UTC year+month,
+ * D is the UTC calendar day (1–31), and S is the same-day publish sequence (1–99).
+ * Example: `202605.27.1` = 2026-05-27, first publish that UTC day.
+ */
+export type ParsedRegistryCalVer = {
+    year: number;
+    month: number;
+    day: number;
+    seq: number;
+};
+export declare function parseRegistryCalVerVersion(version: string): ParsedRegistryCalVer | null;
+/** Publish on a UTC day; `seq` defaults to 1 (first publish that day). */
+export declare function formatRegistryCalVer(now?: Date, seq?: number): string;
+/** First publish on a UTC day (`YYYYMM.D.1`). */
+export declare function calVerBaseFromDate(now?: Date): string;
+export declare function nextRegistryCalVerVersion(currentVersion: string, now?: Date): string;
+//# sourceMappingURL=calver.d.ts.map

package/dist/calver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calver.d.ts","sourceRoot":"","sources":["../src/calver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAMD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,GACd,oBAAoB,GAAG,IAAI,CAqB7B;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,GAAG,OAAa,EAAE,GAAG,SAAI,GAAG,MAAM,CAYtE;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,GAAG,OAAa,GAAG,MAAM,CAE3D;AAED,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,MAAM,EACtB,GAAG,OAAa,GACf,MAAM,CAiBR"}

package/dist/calver.js

@@ -0,0 +1,57 @@
+/**
+ * CalVer npm versions for @perpetualsystems/connector-registry.
+ *
+ * Format: `YYYYMM.D.S` as semver major.minor.patch where YYYYMM is UTC year+month,
+ * D is the UTC calendar day (1–31), and S is the same-day publish sequence (1–99).
+ * Example: `202605.27.1` = 2026-05-27, first publish that UTC day.
+ */
+function yearMonthKey(year, month) {
+    return year * 100 + month;
+}
+export function parseRegistryCalVerVersion(version) {
+    const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(version);
+    if (!match) {
+        return null;
+    }
+    const major = Number(match[1]);
+    const day = Number(match[2]);
+    const seq = Number(match[3]);
+    if (major < 200001 || day < 1 || day > 31 || seq < 1 || seq > 99) {
+        return null;
+    }
+    const month = major % 100;
+    const year = Math.floor(major / 100);
+    if (month < 1 || month > 12) {
+        return null;
+    }
+    return { year, month, day, seq };
+}
+/** Publish on a UTC day; `seq` defaults to 1 (first publish that day). */
+export function formatRegistryCalVer(now = new Date(), seq = 1) {
+    const year = now.getUTCFullYear();
+    const month = now.getUTCMonth() + 1;
+    const day = now.getUTCDate();
+    if (seq < 1 || seq > 99) {
+        throw new Error(`Registry CalVer sequence must be 1–99 (got ${seq} for ${year}-${month}-${day} UTC)`);
+    }
+    return `${yearMonthKey(year, month)}.${day}.${seq}`;
+}
+/** First publish on a UTC day (`YYYYMM.D.1`). */
+export function calVerBaseFromDate(now = new Date()) {
+    return formatRegistryCalVer(now, 1);
+}
+export function nextRegistryCalVerVersion(currentVersion, now = new Date()) {
+    const year = now.getUTCFullYear();
+    const month = now.getUTCMonth() + 1;
+    const day = now.getUTCDate();
+    const parsed = parseRegistryCalVerVersion(currentVersion);
+    if (parsed && parsed.year === year && parsed.month === month && parsed.day === day) {
+        const nextSeq = parsed.seq + 1;
+        if (nextSeq > 99) {
+            throw new Error(`Registry CalVer: exceeded 99 publishes on ${year}-${month}-${day} UTC`);
+        }
+        return formatRegistryCalVer(now, nextSeq);
+    }
+    return formatRegistryCalVer(now, 1);
+}
+//# sourceMappingURL=calver.js.map

package/dist/calver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calver.js","sourceRoot":"","sources":["../src/calver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,SAAS,YAAY,CAAC,IAAY,EAAE,KAAa;IAC/C,OAAO,IAAI,GAAG,GAAG,GAAG,KAAK,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,OAAe;IAEf,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAE5B,IAAI,KAAK,GAAG,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,EAAE,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,EAAE,EAAE,CAAC;QACjE,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,GAAG,GAAG,CAAA;IACzB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAA;IACpC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;AAClC,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,oBAAoB,CAAC,GAAG,GAAG,IAAI,IAAI,EAAE,EAAE,GAAG,GAAG,CAAC;IAC5D,MAAM,IAAI,GAAG,GAAG,CAAC,cAAc,EAAE,CAAA;IACjC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;IACnC,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,EAAE,CAAA;IAE5B,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,8CAA8C,GAAG,QAAQ,IAAI,IAAI,KAAK,IAAI,GAAG,OAAO,CACrF,CAAA;IACH,CAAC;IAED,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,IAAI,GAAG,EAAE,CAAA;AACrD,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,kBAAkB,CAAC,GAAG,GAAG,IAAI,IAAI,EAAE;IACjD,OAAO,oBAAoB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;AACrC,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,cAAsB,EACtB,GAAG,GAAG,IAAI,IAAI,EAAE;IAEhB,MAAM,IAAI,GAAG,GAAG,CAAC,cAAc,EAAE,CAAA;IACjC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;IACnC,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,EAAE,CAAA;IAC5B,MAAM,MAAM,GAAG,0BAA0B,CAAC,cAAc,CAAC,CAAA;IAEzD,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,IAAI,MAAM,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;QACnF,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,CAAA;QAC9B,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,6CAA6C,IAAI,IAAI,KAAK,IAAI,GAAG,MAAM,CACxE,CAAA;QACH,CAAC;QACD,OAAO,oBAAoB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;IAED,OAAO,oBAAoB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;AACrC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { getBundledConnectorRegistry, getBundledConnectorRegistryManifest, } from "./bundled-manifest.js";
+export { type ConnectorRegistry, type ConnectorRegistryEntry, type ConnectorRegistryManifest, connectorRegistryEntrySchema, connectorRegistryManifestSchema, createConnectorRegistry, DRAFT_07_SCHEMA_URI, parseConnectorRegistryManifest, } from "./schemas.js";
+export { assertEcrImageUrlImmutable, assertSettingsSchemaInlined, validateConnectorRegistry, } from "./validate.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,mCAAmC,GACpC,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,4BAA4B,EAC5B,+BAA+B,EAC/B,uBAAuB,EACvB,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { getBundledConnectorRegistry, getBundledConnectorRegistryManifest, } from "./bundled-manifest.js";
+export { connectorRegistryEntrySchema, connectorRegistryManifestSchema, createConnectorRegistry, DRAFT_07_SCHEMA_URI, parseConnectorRegistryManifest, } from "./schemas.js";
+export { assertEcrImageUrlImmutable, assertSettingsSchemaInlined, validateConnectorRegistry, } from "./validate.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,mCAAmC,GACpC,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAIL,4BAA4B,EAC5B,+BAA+B,EAC/B,uBAAuB,EACvB,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,eAAe,CAAA"}

package/dist/manifest.json

@@ -0,0 +1,183 @@
+{
+  "connectors": [
+    {
+      "kind": "atlassian-org-audit",
+      "displayName": "Atlassian Organization Audit",
+      "ecrImageUrl": "718287746078.dkr.ecr.us-east-2.amazonaws.com/perpetual-connectors/atlassian-org-audit:0.0.1",
+      "connectorType": "polling",
+      "settingsSchema": {
+        "type": "object",
+        "properties": {
+          "orgId": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "orgId"
+        ],
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      },
+      "description": "Polls Atlassian organization audit log (events-stream). Requires Atlassian Access/Guard and an organization admin API key."
+    },
+    {
+      "kind": "azure-event-hub",
+      "displayName": "Azure Event Hubs",
+      "ecrImageUrl": "718287746078.dkr.ecr.us-east-2.amazonaws.com/perpetual-connectors/azure-event-hub:0.0.1",
+      "connectorType": "streaming",
+      "lagUnit": "milliseconds",
+      "settingsSchema": {
+        "type": "object",
+        "properties": {
+          "eventHubName": {
+            "type": "string",
+            "minLength": 1
+          },
+          "consumerGroup": {
+            "type": "string",
+            "default": "$Default"
+          }
+        },
+        "required": [
+          "eventHubName"
+        ],
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      },
+      "description": "Consume events from an Azure Event Hub with S3 checkpoints"
+    },
+    {
+      "kind": "bitwarden",
+      "displayName": "Bitwarden",
+      "ecrImageUrl": "718287746078.dkr.ecr.us-east-2.amazonaws.com/perpetual-connectors/bitwarden:0.0.1",
+      "connectorType": "polling",
+      "settingsSchema": {
+        "type": "object",
+        "properties": {
+          "region": {
+            "type": "string",
+            "enum": [
+              "global",
+              "eu"
+            ]
+          }
+        },
+        "required": [
+          "region"
+        ],
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      },
+      "description": "Poll Bitwarden organization event logs via the Public API"
+    },
+    {
+      "kind": "gcp-pubsub",
+      "displayName": "Google Cloud Pub/Sub",
+      "ecrImageUrl": "718287746078.dkr.ecr.us-east-2.amazonaws.com/perpetual-connectors/gcp-pubsub:0.0.1",
+      "connectorType": "streaming",
+      "lagUnit": "milliseconds",
+      "settingsSchema": {
+        "type": "object",
+        "properties": {
+          "projectId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "subscriptionId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "serviceAccountEmail": {
+            "type": "string",
+            "format": "email"
+          },
+          "maxMessages": {
+            "type": "integer",
+            "exclusiveMinimum": 0
+          },
+          "maxBytes": {
+            "type": "integer",
+            "exclusiveMinimum": 0
+          }
+        },
+        "required": [
+          "projectId",
+          "subscriptionId",
+          "serviceAccountEmail"
+        ],
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      },
+      "description": "Consume messages from a GCP Pub/Sub subscription"
+    },
+    {
+      "kind": "one-password",
+      "displayName": "1Password",
+      "ecrImageUrl": "718287746078.dkr.ecr.us-east-2.amazonaws.com/perpetual-connectors/one-password:0.0.1",
+      "connectorType": "polling",
+      "settingsSchema": {
+        "type": "object",
+        "properties": {
+          "region": {
+            "type": "string",
+            "enum": [
+              "us",
+              "eu",
+              "ca"
+            ]
+          },
+          "signinAttempts": {
+            "type": "boolean",
+            "default": true
+          },
+          "itemUsages": {
+            "type": "boolean",
+            "default": true
+          },
+          "auditEvents": {
+            "type": "boolean",
+            "default": true
+          }
+        },
+        "required": [
+          "region"
+        ],
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      },
+      "description": "Polls 1Password Events API v2 for sign-in attempts, item usages, and audit events."
+    },
+    {
+      "kind": "slack-audit",
+      "displayName": "Slack Audit Logs",
+      "ecrImageUrl": "718287746078.dkr.ecr.us-east-2.amazonaws.com/perpetual-connectors/slack-audit:0.0.1",
+      "connectorType": "polling",
+      "settingsSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      },
+      "description": "Enterprise Grid audit logs via Slack Audit API. Requires auditlogs:read OAuth user token."
+    },
+    {
+      "kind": "test-fixture",
+      "displayName": "Test Fixture",
+      "ecrImageUrl": "718287746078.dkr.ecr.us-east-2.amazonaws.com/perpetual-connectors/test-fixture:0.0.1",
+      "connectorType": "polling",
+      "settingsSchema": {
+        "type": "object",
+        "properties": {
+          "label": {
+            "type": "string",
+            "default": "fixture"
+          }
+        },
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      },
+      "description": "Internal noop connector for registry pipeline validation (dev only)"
+    }
+  ]
+}

package/dist/schemas.d.ts

@@ -0,0 +1,94 @@
+import { z } from "zod";
+export declare const DRAFT_07_SCHEMA_URI = "http://json-schema.org/draft-07/schema#";
+export declare const CONNECTOR_REGISTRY_S3_PREFIX = "connectors";
+export declare const connectorRegistryEntrySchema: z.ZodObject<{
+    kind: z.ZodString;
+    displayName: z.ZodString;
+    ecrImageUrl: z.ZodString;
+    connectorType: z.ZodDefault<z.ZodEnum<["polling", "streaming"]>>;
+    lagUnit: z.ZodOptional<z.ZodEnum<["milliseconds", "messages"]>>;
+    settingsSchema: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnknown>, Record<string, unknown>, Record<string, unknown>>;
+    iconUrl: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: string;
+    displayName: string;
+    ecrImageUrl: string;
+    connectorType: "polling" | "streaming";
+    settingsSchema: Record<string, unknown>;
+    lagUnit?: "milliseconds" | "messages" | undefined;
+    iconUrl?: string | undefined;
+    description?: string | undefined;
+}, {
+    kind: string;
+    displayName: string;
+    ecrImageUrl: string;
+    settingsSchema: Record<string, unknown>;
+    connectorType?: "polling" | "streaming" | undefined;
+    lagUnit?: "milliseconds" | "messages" | undefined;
+    iconUrl?: string | undefined;
+    description?: string | undefined;
+}>;
+export declare const connectorRegistryManifestSchema: z.ZodObject<{
+    connectors: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        displayName: z.ZodString;
+        ecrImageUrl: z.ZodString;
+        connectorType: z.ZodDefault<z.ZodEnum<["polling", "streaming"]>>;
+        lagUnit: z.ZodOptional<z.ZodEnum<["milliseconds", "messages"]>>;
+        settingsSchema: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnknown>, Record<string, unknown>, Record<string, unknown>>;
+        iconUrl: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: string;
+        displayName: string;
+        ecrImageUrl: string;
+        connectorType: "polling" | "streaming";
+        settingsSchema: Record<string, unknown>;
+        lagUnit?: "milliseconds" | "messages" | undefined;
+        iconUrl?: string | undefined;
+        description?: string | undefined;
+    }, {
+        kind: string;
+        displayName: string;
+        ecrImageUrl: string;
+        settingsSchema: Record<string, unknown>;
+        connectorType?: "polling" | "streaming" | undefined;
+        lagUnit?: "milliseconds" | "messages" | undefined;
+        iconUrl?: string | undefined;
+        description?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    connectors: {
+        kind: string;
+        displayName: string;
+        ecrImageUrl: string;
+        connectorType: "polling" | "streaming";
+        settingsSchema: Record<string, unknown>;
+        lagUnit?: "milliseconds" | "messages" | undefined;
+        iconUrl?: string | undefined;
+        description?: string | undefined;
+    }[];
+}, {
+    connectors: {
+        kind: string;
+        displayName: string;
+        ecrImageUrl: string;
+        settingsSchema: Record<string, unknown>;
+        connectorType?: "polling" | "streaming" | undefined;
+        lagUnit?: "milliseconds" | "messages" | undefined;
+        iconUrl?: string | undefined;
+        description?: string | undefined;
+    }[];
+}>;
+export type ConnectorRegistryEntry = z.infer<typeof connectorRegistryEntrySchema>;
+export type ConnectorRegistryManifest = z.infer<typeof connectorRegistryManifestSchema>;
+/** Lookup API for built-in connector catalog entries. */
+export interface ConnectorRegistry {
+    get(kind: string): ConnectorRegistryEntry | undefined;
+    list(): ConnectorRegistryEntry[];
+    has(kind: string): boolean;
+}
+export declare function parseConnectorRegistryManifest(body: string): ConnectorRegistryManifest;
+export declare function createConnectorRegistry(manifest: ConnectorRegistryManifest): ConnectorRegistry;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,mBAAmB,4CAA4C,CAAA;AAE5E,eAAO,MAAM,4BAA4B,eAAe,CAAA;AAUxD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;EASvC,CAAA;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE1C,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AACjF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,+BAA+B,CACvC,CAAA;AAED,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAAA;IACrD,IAAI,IAAI,sBAAsB,EAAE,CAAA;IAChC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3B;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,GACX,yBAAyB,CAG3B;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,yBAAyB,GAClC,iBAAiB,CASnB"}

package/dist/schemas.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+export const DRAFT_07_SCHEMA_URI = "http://json-schema.org/draft-07/schema#";
+export const CONNECTOR_REGISTRY_S3_PREFIX = "connectors";
+const jsonSchemaObjectSchema = z
+    .record(z.string(), z.unknown())
+    .refine((value) => typeof value === "object" && value !== null && !Array.isArray(value), { message: "settingsSchema must be a JSON object" });
+export const connectorRegistryEntrySchema = z.object({
+    kind: z.string().min(1),
+    displayName: z.string().min(1),
+    ecrImageUrl: z.string().min(1),
+    connectorType: z.enum(["polling", "streaming"]).default("polling"),
+    lagUnit: z.enum(["milliseconds", "messages"]).optional(),
+    settingsSchema: jsonSchemaObjectSchema,
+    iconUrl: z.string().url().optional(),
+    description: z.string().optional(),
+});
+export const connectorRegistryManifestSchema = z.object({
+    connectors: z.array(connectorRegistryEntrySchema).min(1),
+});
+export function parseConnectorRegistryManifest(body) {
+    const json = JSON.parse(body);
+    return connectorRegistryManifestSchema.parse(json);
+}
+export function createConnectorRegistry(manifest) {
+    const byKind = new Map(manifest.connectors.map((entry) => [entry.kind, entry]));
+    return {
+        get: (kind) => byKind.get(kind),
+        list: () => [...byKind.values()],
+        has: (kind) => byKind.has(kind),
+    };
+}
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,mBAAmB,GAAG,yCAAyC,CAAA;AAE5E,MAAM,CAAC,MAAM,4BAA4B,GAAG,YAAY,CAAA;AAExD,MAAM,sBAAsB,GAAG,CAAC;KAC7B,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;KAC/B,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACtE,EAAE,OAAO,EAAE,sCAAsC,EAAE,CACpD,CAAA;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAClE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxD,cAAc,EAAE,sBAAsB;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACpC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACzD,CAAC,CAAA;AAcF,MAAM,UAAU,8BAA8B,CAC5C,IAAY;IAEZ,MAAM,IAAI,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACtC,OAAO,+BAA+B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACpD,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,QAAmC;IAEnC,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CACxD,CAAA;IACD,OAAO;QACL,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QAC/B,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAChC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;KAChC,CAAA;AACH,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,5 @@
+import { type ConnectorRegistryManifest } from "./schemas.js";
+export declare function assertSettingsSchemaInlined(schema: unknown, path?: string): void;
+export declare function assertEcrImageUrlImmutable(ecrImageUrl: string): void;
+export declare function validateConnectorRegistry(registry: ConnectorRegistryManifest): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,yBAAyB,EAE/B,MAAM,cAAc,CAAA;AAErB,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,OAAO,EACf,IAAI,SAAmB,GACtB,IAAI,CAsBN;AAED,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CASpE;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,yBAAyB,GAClC,IAAI,CAkCN"}

package/dist/validate.js

@@ -0,0 +1,53 @@
+import { DRAFT_07_SCHEMA_URI, } from "./schemas.js";
+export function assertSettingsSchemaInlined(schema, path = "settingsSchema") {
+    if (schema === null || typeof schema !== "object") {
+        return;
+    }
+    if (Array.isArray(schema)) {
+        for (const [index, item] of schema.entries()) {
+            assertSettingsSchemaInlined(item, `${path}[${index}]`);
+        }
+        return;
+    }
+    const record = schema;
+    if ("$ref" in record) {
+        throw new Error(`${path} must not contain $ref (settings schemas must be inlined): ${String(record.$ref)}`);
+    }
+    for (const [key, value] of Object.entries(record)) {
+        assertSettingsSchemaInlined(value, `${path}.${key}`);
+    }
+}
+export function assertEcrImageUrlImmutable(ecrImageUrl) {
+    if (/:latest$/i.test(ecrImageUrl)) {
+        throw new Error(`ecrImageUrl must not use the "latest" tag: ${ecrImageUrl}`);
+    }
+    if (!/\.dkr\.ecr\.[a-z0-9-]+\.amazonaws\.com\/.+:.+$/i.test(ecrImageUrl)) {
+        throw new Error(`ecrImageUrl must be a full ECR URI with an immutable tag or digest: ${ecrImageUrl}`);
+    }
+}
+export function validateConnectorRegistry(registry) {
+    if (registry.connectors.length === 0) {
+        throw new Error("registry must include at least one connector");
+    }
+    const kinds = new Set();
+    for (const entry of registry.connectors) {
+        if (kinds.has(entry.kind)) {
+            throw new Error(`duplicate connector kind: ${entry.kind}`);
+        }
+        kinds.add(entry.kind);
+        assertEcrImageUrlImmutable(entry.ecrImageUrl);
+        if (entry.settingsSchema.$schema !== DRAFT_07_SCHEMA_URI) {
+            throw new Error(`settingsSchema for ${entry.kind} must set $schema to ${DRAFT_07_SCHEMA_URI}`);
+        }
+        assertSettingsSchemaInlined(entry.settingsSchema);
+        if (entry.connectorType === "streaming") {
+            if (!entry.lagUnit) {
+                throw new Error(`streaming connector ${entry.kind} must declare lagUnit in registry`);
+            }
+        }
+        else if (entry.lagUnit !== undefined) {
+            throw new Error(`polling connector ${entry.kind} must not declare lagUnit in registry`);
+        }
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,GACpB,MAAM,cAAc,CAAA;AAErB,MAAM,UAAU,2BAA2B,CACzC,MAAe,EACf,IAAI,GAAG,gBAAgB;IAEvB,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClD,OAAM;IACR,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7C,2BAA2B,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,CAAA;QACxD,CAAC;QACD,OAAM;IACR,CAAC;IAED,MAAM,MAAM,GAAG,MAAiC,CAAA;IAChD,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,8DAA8D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAC3F,CAAA;IACH,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,2BAA2B,CAAC,KAAK,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAA;IACtD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,WAAmB;IAC5D,IAAI,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,8CAA8C,WAAW,EAAE,CAAC,CAAA;IAC9E,CAAC;IACD,IAAI,CAAC,iDAAiD,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CACb,uEAAuE,WAAW,EAAE,CACrF,CAAA;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,QAAmC;IAEnC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IACjE,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAC/B,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QAC5D,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAErB,0BAA0B,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QAE7C,IAAI,KAAK,CAAC,cAAc,CAAC,OAAO,KAAK,mBAAmB,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CACb,sBAAsB,KAAK,CAAC,IAAI,wBAAwB,mBAAmB,EAAE,CAC9E,CAAA;QACH,CAAC;QAED,2BAA2B,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;QAEjD,IAAI,KAAK,CAAC,aAAa,KAAK,WAAW,EAAE,CAAC;YACxC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CACb,uBAAuB,KAAK,CAAC,IAAI,mCAAmC,CACrE,CAAA;YACH,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACb,qBAAqB,KAAK,CAAC,IAAI,uCAAuC,CACvE,CAAA;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@perpetualsystems/connector-registry",
+  "version": "202605.30.1",
+  "description": "Built-in connector catalog manifest for Perpetual management plane",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./build": {
+      "types": "./dist/build-entry.d.ts",
+      "import": "./dist/build-entry.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/perpetualsystems/connectors.git"
+  },
+  "scripts": {
+    "build": "tsc && tsc -p tsconfig.build-tools.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@perpetualsystems/connector-sdk": "workspace:*",
+    "@types/node": "^22.15.21",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
+    "zod-to-json-schema": "^3.24.5"
+  }
+}