@lssm/lib.contracts 1.41.1 → 1.42.2

package/dist/workspace-config/contractsrc-schema.js

@@ -0,0 +1,247 @@
+import * as z$1 from "zod";
+
+//#region src/workspace-config/contractsrc-schema.ts
+/**
+* ContractSpec configuration schema definitions.
+*
+* These schemas define the structure of .contractsrc.json files
+* and are shared across CLI tools and libraries.
+*/
+/**
+* OpenAPI source configuration for import/sync/validate operations.
+*/
+const OpenApiSourceConfigSchema = z$1.object({
+	name: z$1.string(),
+	url: z$1.url().optional(),
+	file: z$1.string().optional(),
+	syncMode: z$1.enum([
+		"import",
+		"sync",
+		"validate"
+	]).default("validate"),
+	tags: z$1.array(z$1.string()).optional(),
+	exclude: z$1.array(z$1.string()).optional(),
+	include: z$1.array(z$1.string()).optional(),
+	prefix: z$1.string().optional(),
+	defaultStability: z$1.enum([
+		"experimental",
+		"beta",
+		"stable",
+		"deprecated"
+	]).optional(),
+	defaultAuth: z$1.enum([
+		"anonymous",
+		"user",
+		"admin"
+	]).optional(),
+	defaultOwners: z$1.array(z$1.string()).optional()
+});
+const OpenApiExportConfigSchema = z$1.object({
+	outputPath: z$1.string().default("./openapi.json"),
+	format: z$1.enum(["json", "yaml"]).default("json"),
+	title: z$1.string().optional(),
+	version: z$1.string().optional(),
+	description: z$1.string().optional(),
+	servers: z$1.array(z$1.object({
+		url: z$1.string(),
+		description: z$1.string().optional()
+	})).optional()
+});
+/**
+* OpenAPI configuration section.
+*/
+const OpenApiConfigSchema = z$1.object({
+	sources: z$1.array(OpenApiSourceConfigSchema).optional(),
+	export: OpenApiExportConfigSchema.optional()
+});
+/**
+* Grouping strategy for organizing specs.
+*/
+const GroupingStrategySchema = z$1.enum([
+	"by-tag",
+	"by-owner",
+	"by-domain",
+	"by-url-path-single",
+	"by-url-path-multi",
+	"by-feature",
+	"none"
+]);
+/**
+* Grouping rule configuration.
+*/
+const GroupingRuleSchema = z$1.object({
+	strategy: GroupingStrategySchema,
+	urlPathLevel: z$1.number().optional(),
+	pattern: z$1.string().optional()
+});
+/**
+* Output directory conventions for generated specs.
+*/
+const FolderConventionsSchema = z$1.object({
+	models: z$1.string().default("models"),
+	operations: z$1.string().default("operations/commands|queries"),
+	events: z$1.string().default("events"),
+	presentations: z$1.string().default("presentations"),
+	forms: z$1.string().default("forms"),
+	groupByFeature: z$1.boolean().default(true),
+	operationsGrouping: GroupingRuleSchema.optional(),
+	modelsGrouping: GroupingRuleSchema.optional(),
+	eventsGrouping: GroupingRuleSchema.optional()
+});
+/**
+* PR comment configuration for CI/CD.
+*/
+const PrCommentConfigSchema = z$1.object({
+	enabled: z$1.boolean().default(true),
+	template: z$1.enum(["minimal", "detailed"]).default("detailed"),
+	updateExisting: z$1.boolean().default(true)
+});
+/**
+* GitHub check run configuration for CI/CD.
+*/
+const CheckRunConfigSchema = z$1.object({
+	enabled: z$1.boolean().default(true),
+	name: z$1.string().default("ContractSpec Impact"),
+	failOnBreaking: z$1.boolean().default(true),
+	failOnChanges: z$1.boolean().default(false)
+});
+/**
+* Impact detection configuration for CI/CD.
+*/
+const ImpactConfigSchema = z$1.object({
+	baseline: z$1.string().default("default-branch"),
+	include: z$1.array(z$1.string()).optional(),
+	exclude: z$1.array(z$1.string()).optional()
+});
+/**
+* CI/CD configuration section.
+*/
+const CiConfigSchema = z$1.object({
+	checks: z$1.array(z$1.string()).default([
+		"structure",
+		"integrity",
+		"deps"
+	]),
+	skipChecks: z$1.array(z$1.string()).optional(),
+	failOnWarnings: z$1.boolean().default(false),
+	uploadSarif: z$1.boolean().default(true),
+	prComment: PrCommentConfigSchema.optional(),
+	checkRun: CheckRunConfigSchema.optional(),
+	impact: ImpactConfigSchema.optional()
+});
+/**
+* External workspace reference for cross-workspace dependencies in meta-repos.
+*/
+const ExternalWorkspaceSchema = z$1.object({
+	alias: z$1.string(),
+	submodule: z$1.string(),
+	packages: z$1.array(z$1.string()).optional(),
+	autoResolve: z$1.boolean().default(true)
+});
+/**
+* Meta-repo configuration section.
+*/
+const MetaRepoConfigSchema = z$1.object({
+	activeScope: z$1.string().optional(),
+	externalWorkspaces: z$1.array(ExternalWorkspaceSchema).optional(),
+	crossWorkspaceSearch: z$1.boolean().default(false)
+});
+/**
+* Rule severity levels (inspired by ESLint).
+*/
+const RuleSeveritySchema = z$1.enum([
+	"off",
+	"warn",
+	"error"
+]);
+/**
+* Contract kinds for per-kind rule overrides.
+*/
+const SpecKindSchema = z$1.enum([
+	"operation",
+	"event",
+	"presentation",
+	"feature",
+	"workflow",
+	"data-view",
+	"migration",
+	"telemetry",
+	"experiment",
+	"app-config"
+]);
+/**
+* Available lint rules with their severity.
+*/
+const LintRulesSchema = z$1.object({
+	"require-acceptance": RuleSeveritySchema.optional(),
+	"require-examples": RuleSeveritySchema.optional(),
+	"require-stability": RuleSeveritySchema.optional(),
+	"require-owners-format": RuleSeveritySchema.optional(),
+	"event-past-tense": RuleSeveritySchema.optional(),
+	"no-todo": RuleSeveritySchema.optional(),
+	"workflow-transitions": RuleSeveritySchema.optional(),
+	"telemetry-privacy": RuleSeveritySchema.optional(),
+	"experiment-allocation": RuleSeveritySchema.optional(),
+	"app-config-appid": RuleSeveritySchema.optional(),
+	"app-config-capabilities": RuleSeveritySchema.optional(),
+	"data-view-fields": RuleSeveritySchema.optional()
+});
+/**
+* Full rules configuration with global defaults and per-kind overrides.
+*/
+const RulesConfigSchema = z$1.object({
+	defaults: LintRulesSchema.optional(),
+	overrides: z$1.record(SpecKindSchema, LintRulesSchema).optional()
+});
+/**
+* Full ContractSpec configuration schema (.contractsrc.json).
+*/
+const ContractsrcSchema = z$1.object({
+	aiProvider: z$1.enum([
+		"claude",
+		"openai",
+		"ollama",
+		"custom"
+	]).default("claude"),
+	aiModel: z$1.string().optional(),
+	agentMode: z$1.enum([
+		"simple",
+		"cursor",
+		"claude-code",
+		"openai-codex"
+	]).default("simple"),
+	customEndpoint: z$1.url().nullable().optional(),
+	customApiKey: z$1.string().nullable().optional(),
+	outputDir: z$1.string().default("./src"),
+	conventions: FolderConventionsSchema,
+	defaultOwners: z$1.array(z$1.string()).default([]),
+	defaultTags: z$1.array(z$1.string()).default([]),
+	packages: z$1.array(z$1.string()).optional(),
+	excludePackages: z$1.array(z$1.string()).optional(),
+	recursive: z$1.boolean().optional(),
+	openapi: OpenApiConfigSchema.optional(),
+	ci: CiConfigSchema.optional(),
+	metaRepo: MetaRepoConfigSchema.optional(),
+	rules: RulesConfigSchema.optional()
+});
+/**
+* Default configuration values.
+*/
+const DEFAULT_CONTRACTSRC = {
+	aiProvider: "claude",
+	agentMode: "simple",
+	outputDir: "./src",
+	conventions: {
+		models: "models",
+		operations: "interactions/commands|queries",
+		events: "events",
+		presentations: "presentations",
+		forms: "forms",
+		groupByFeature: true
+	},
+	defaultOwners: [],
+	defaultTags: []
+};
+
+//#endregion
+export { CheckRunConfigSchema, CiConfigSchema, ContractsrcSchema, DEFAULT_CONTRACTSRC, ExternalWorkspaceSchema, FolderConventionsSchema, GroupingRuleSchema, GroupingStrategySchema, ImpactConfigSchema, LintRulesSchema, MetaRepoConfigSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema, PrCommentConfigSchema, RuleSeveritySchema, RulesConfigSchema, SpecKindSchema };

package/dist/workspace-config/index.d.ts

@@ -0,0 +1,2 @@
+import { ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventions, FolderConventionsSchema, OpenApiConfig, OpenApiConfigSchema, OpenApiExportConfig, OpenApiExportConfigSchema, OpenApiSourceConfig, OpenApiSourceConfigSchema } from "./contractsrc-schema.js";
+export { type ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, type FolderConventions, FolderConventionsSchema, type OpenApiConfig, OpenApiConfigSchema, type OpenApiExportConfig, OpenApiExportConfigSchema, type OpenApiSourceConfig, OpenApiSourceConfigSchema };

package/dist/workspace-config/index.js

@@ -0,0 +1,3 @@
+import { ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventionsSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema } from "./contractsrc-schema.js";
+
+export { ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventionsSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema };