@scoutflo/topology-contracts 0.5.1 → 0.6.1

package/README.md

@@ -5,10 +5,17 @@ Pure shared topology vocabulary and Zod boundary schemas for Scoutflo topology w
 This package owns:
 
 - topology provider constants and explicit compatibility aliases;
-- AWS, Kubernetes, and integration topology family constants;
+- AWS, Kubernetes, integration, and GitHub account topology family constants;
+- GitHub account source-sync source-type constants;
 - source-sync capability, intent, scope, completeness, warning, and candidate DTO schemas;
 - topology correlation rule metadata and candidate DTO schemas;
-- small topology resource and relation vocabulary constants useful at contract boundaries.
+- Gateway/Mongo-aligned topology resource and relation vocabulary constants useful at contract boundaries.
+
+Canonical topology resource and relation constants mirror stable persisted Scoutflo ontology values. Source-sync family constants remain separate and may use provider/source-specific family names such as AWS scan families.
+
+GitHub source-sync vocabulary currently covers only the account/App installation node (`account` family and `github_account` source type). Repository inventory and repository relationship vocabulary are intentionally not exported yet.
+
+Provider constants are shared vocabulary, not a source-sync capability registry. Values such as `pagerduty` and `correlation` may be valid persisted providers without implying that the source-sync registry can run them.
 
 Gateway remains the runtime authority for provider discovery, credential resolution, dry-run/apply, lifecycle, reconciliation, persistence, audit, provider clients, source-specific payload parsing, and topology correlation rule execution.
 

package/dist/src/families/github.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const GITHUB_TOPOLOGY_FAMILY: {
+    readonly ACCOUNT: "account";
+};
+export declare const GITHUB_TOPOLOGY_FAMILY_VALUES: readonly ["account"];
+export declare const githubTopologyFamilySchema: z.ZodEnum<["account"]>;
+export type GithubTopologyFamily = z.infer<typeof githubTopologyFamilySchema>;
+export declare const GITHUB_TOPOLOGY_SOURCE_TYPE: {
+    readonly ACCOUNT: "github_account";
+};
+export declare const GITHUB_TOPOLOGY_SOURCE_TYPE_VALUES: readonly ["github_account"];
+export declare const githubTopologySourceTypeSchema: z.ZodEnum<["github_account"]>;
+export type GithubTopologySourceType = z.infer<typeof githubTopologySourceTypeSchema>;

package/dist/src/families/github.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.githubTopologySourceTypeSchema = exports.GITHUB_TOPOLOGY_SOURCE_TYPE_VALUES = exports.GITHUB_TOPOLOGY_SOURCE_TYPE = exports.githubTopologyFamilySchema = exports.GITHUB_TOPOLOGY_FAMILY_VALUES = exports.GITHUB_TOPOLOGY_FAMILY = void 0;
+const zod_1 = require("zod");
+exports.GITHUB_TOPOLOGY_FAMILY = {
+    ACCOUNT: 'account',
+};
+exports.GITHUB_TOPOLOGY_FAMILY_VALUES = [
+    exports.GITHUB_TOPOLOGY_FAMILY.ACCOUNT,
+];
+exports.githubTopologyFamilySchema = zod_1.z.enum(exports.GITHUB_TOPOLOGY_FAMILY_VALUES);
+exports.GITHUB_TOPOLOGY_SOURCE_TYPE = {
+    ACCOUNT: 'github_account',
+};
+exports.GITHUB_TOPOLOGY_SOURCE_TYPE_VALUES = [
+    exports.GITHUB_TOPOLOGY_SOURCE_TYPE.ACCOUNT,
+];
+exports.githubTopologySourceTypeSchema = zod_1.z.enum(exports.GITHUB_TOPOLOGY_SOURCE_TYPE_VALUES);
+//# sourceMappingURL=github.js.map

package/dist/src/families/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../../src/families/github.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAEX,QAAA,sBAAsB,GAAG;IACpC,OAAO,EAAE,SAAS;CACV,CAAC;AAEE,QAAA,6BAA6B,GAAG;IAC3C,8BAAsB,CAAC,OAAO;CACtB,CAAC;AAEE,QAAA,0BAA0B,GAAG,OAAC,CAAC,IAAI,CAAC,qCAA6B,CAAC,CAAC;AAInE,QAAA,2BAA2B,GAAG;IACzC,OAAO,EAAE,gBAAgB;CACjB,CAAC;AAEE,QAAA,kCAAkC,GAAG;IAChD,mCAA2B,CAAC,OAAO;CAC3B,CAAC;AAEE,QAAA,8BAA8B,GAAG,OAAC,CAAC,IAAI,CAAC,0CAAkC,CAAC,CAAC"}

package/dist/src/families/index.d.ts

@@ -2,5 +2,6 @@ import { z } from 'zod';
 export * from './aws';
 export * from './kubernetes';
 export * from './integrations';
-export declare const topologyFamilySchema: z.ZodUnion<[z.ZodEnum<["account", "vpc", "subnet", "ec2_instance", "rds_instance", "s3_bucket", "eks_cluster"]>, z.ZodEnum<["cluster", "namespace", "deployment", "statefulset", "daemonset", "job", "cronjob", "service"]>, z.ZodEnum<["integration_resource"]>]>;
+export * from './github';
+export declare const topologyFamilySchema: z.ZodUnion<[z.ZodEnum<["account", "vpc", "subnet", "ec2_instance", "rds_instance", "s3_bucket", "eks_cluster"]>, z.ZodEnum<["cluster", "namespace", "deployment", "statefulset", "daemonset", "job", "cronjob", "service"]>, z.ZodEnum<["integration_resource"]>, z.ZodEnum<["account"]>]>;
 export type TopologyFamily = z.infer<typeof topologyFamilySchema>;

package/dist/src/families/index.js

@@ -17,14 +17,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.topologyFamilySchema = void 0;
 const zod_1 = require("zod");
 const aws_1 = require("./aws");
+const github_1 = require("./github");
 const integrations_1 = require("./integrations");
 const kubernetes_1 = require("./kubernetes");
 __exportStar(require("./aws"), exports);
 __exportStar(require("./kubernetes"), exports);
 __exportStar(require("./integrations"), exports);
+__exportStar(require("./github"), exports);
 exports.topologyFamilySchema = zod_1.z.union([
     aws_1.awsTopologyFamilySchema,
     kubernetes_1.kubernetesTopologyFamilySchema,
     integrations_1.integrationTopologyFamilySchema,
+    github_1.githubTopologyFamilySchema,
 ]);
 //# sourceMappingURL=index.js.map

package/dist/src/families/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/families/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,6BAAwB;AACxB,+BAAgD;AAChD,iDAAiE;AACjE,6CAA8D;AAE9D,wCAAsB;AACtB,+CAA6B;AAC7B,iDAA+B;AAElB,QAAA,oBAAoB,GAAG,OAAC,CAAC,KAAK,CAAC;IAC1C,6BAAuB;IACvB,2CAA8B;IAC9B,8CAA+B;CAChC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/families/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,6BAAwB;AACxB,+BAAgD;AAChD,qCAAsD;AACtD,iDAAiE;AACjE,6CAA8D;AAE9D,wCAAsB;AACtB,+CAA6B;AAC7B,iDAA+B;AAC/B,2CAAyB;AAEZ,QAAA,oBAAoB,GAAG,OAAC,CAAC,KAAK,CAAC;IAC1C,6BAAuB;IACvB,2CAA8B;IAC9B,8CAA+B;IAC/B,mCAA0B;CAC3B,CAAC,CAAC"}