@contractspec/lib.contracts 1.44.1 → 1.45.0

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

@@ -1,4 +1,4 @@
-import * as z$1 from "zod";
+import * as z$2 from "zod";
 
 //#region src/workspace-config/contractsrc-schema.ts
 /**
@@ -11,7 +11,7 @@ import * as z$1 from "zod";
 * Schema output format for code generation.
 * Controls how imported/generated schemas are written.
 */
-const SchemaFormatSchema = z$1.enum([
+const SchemaFormatSchema = z$2.enum([
 	"contractspec",
 	"zod",
 	"json-schema",
@@ -20,55 +20,55 @@ const SchemaFormatSchema = z$1.enum([
 /**
 * 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([
+const OpenApiSourceConfigSchema = z$2.object({
+	name: z$2.string(),
+	url: z$2.url().optional(),
+	file: z$2.string().optional(),
+	syncMode: z$2.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([
+	tags: z$2.array(z$2.string()).optional(),
+	exclude: z$2.array(z$2.string()).optional(),
+	include: z$2.array(z$2.string()).optional(),
+	prefix: z$2.string().optional(),
+	defaultStability: z$2.enum([
 		"experimental",
 		"beta",
 		"stable",
 		"deprecated"
 	]).optional(),
-	defaultAuth: z$1.enum([
+	defaultAuth: z$2.enum([
 		"anonymous",
 		"user",
 		"admin"
 	]).optional(),
-	defaultOwners: z$1.array(z$1.string()).optional(),
+	defaultOwners: z$2.array(z$2.string()).optional(),
 	schemaFormat: SchemaFormatSchema.default("contractspec")
 });
-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()
+const OpenApiExportConfigSchema = z$2.object({
+	outputPath: z$2.string().default("./openapi.json"),
+	format: z$2.enum(["json", "yaml"]).default("json"),
+	title: z$2.string().optional(),
+	version: z$2.string().optional(),
+	description: z$2.string().optional(),
+	servers: z$2.array(z$2.object({
+		url: z$2.string(),
+		description: z$2.string().optional()
 	})).optional()
 });
 /**
 * OpenAPI configuration section.
 */
-const OpenApiConfigSchema = z$1.object({
-	sources: z$1.array(OpenApiSourceConfigSchema).optional(),
+const OpenApiConfigSchema = z$2.object({
+	sources: z$2.array(OpenApiSourceConfigSchema).optional(),
 	export: OpenApiExportConfigSchema.optional()
 });
 /**
 * Grouping strategy for organizing specs.
 */
-const GroupingStrategySchema = z$1.enum([
+const GroupingStrategySchema = z$2.enum([
 	"by-tag",
 	"by-owner",
 	"by-domain",
@@ -80,21 +80,21 @@ const GroupingStrategySchema = z$1.enum([
 /**
 * Grouping rule configuration.
 */
-const GroupingRuleSchema = z$1.object({
+const GroupingRuleSchema = z$2.object({
 	strategy: GroupingStrategySchema,
-	urlPathLevel: z$1.number().optional(),
-	pattern: z$1.string().optional()
+	urlPathLevel: z$2.number().optional(),
+	pattern: z$2.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),
+const FolderConventionsSchema = z$2.object({
+	models: z$2.string().default("models"),
+	operations: z$2.string().default("operations/commands|queries"),
+	events: z$2.string().default("events"),
+	presentations: z$2.string().default("presentations"),
+	forms: z$2.string().default("forms"),
+	groupByFeature: z$2.boolean().default(true),
 	operationsGrouping: GroupingRuleSchema.optional(),
 	modelsGrouping: GroupingRuleSchema.optional(),
 	eventsGrouping: GroupingRuleSchema.optional()
@@ -102,40 +102,40 @@ const FolderConventionsSchema = z$1.object({
 /**
 * 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)
+const PrCommentConfigSchema = z$2.object({
+	enabled: z$2.boolean().default(true),
+	template: z$2.enum(["minimal", "detailed"]).default("detailed"),
+	updateExisting: z$2.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)
+const CheckRunConfigSchema = z$2.object({
+	enabled: z$2.boolean().default(true),
+	name: z$2.string().default("ContractSpec Impact"),
+	failOnBreaking: z$2.boolean().default(true),
+	failOnChanges: z$2.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()
+const ImpactConfigSchema = z$2.object({
+	baseline: z$2.string().default("default-branch"),
+	include: z$2.array(z$2.string()).optional(),
+	exclude: z$2.array(z$2.string()).optional()
 });
 /**
 * CI/CD configuration section.
 */
-const CiConfigSchema = z$1.object({
-	checks: z$1.array(z$1.string()).default([
+const CiConfigSchema = z$2.object({
+	checks: z$2.array(z$2.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),
+	skipChecks: z$2.array(z$2.string()).optional(),
+	failOnWarnings: z$2.boolean().default(false),
+	uploadSarif: z$2.boolean().default(true),
 	prComment: PrCommentConfigSchema.optional(),
 	checkRun: CheckRunConfigSchema.optional(),
 	impact: ImpactConfigSchema.optional()
@@ -143,24 +143,24 @@ const CiConfigSchema = z$1.object({
 /**
 * 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)
+const ExternalWorkspaceSchema = z$2.object({
+	alias: z$2.string(),
+	submodule: z$2.string(),
+	packages: z$2.array(z$2.string()).optional(),
+	autoResolve: z$2.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)
+const MetaRepoConfigSchema = z$2.object({
+	activeScope: z$2.string().optional(),
+	externalWorkspaces: z$2.array(ExternalWorkspaceSchema).optional(),
+	crossWorkspaceSearch: z$2.boolean().default(false)
 });
 /**
 * Supported formatter tools.
 */
-const FormatterTypeSchema = z$1.enum([
+const FormatterTypeSchema = z$2.enum([
 	"prettier",
 	"eslint",
 	"biome",
@@ -170,17 +170,17 @@ const FormatterTypeSchema = z$1.enum([
 /**
 * Formatter configuration for code generation.
 */
-const FormatterConfigSchema = z$1.object({
-	enabled: z$1.boolean().default(true),
+const FormatterConfigSchema = z$2.object({
+	enabled: z$2.boolean().default(true),
 	type: FormatterTypeSchema.optional(),
-	command: z$1.string().optional(),
-	args: z$1.array(z$1.string()).optional(),
-	timeout: z$1.number().default(3e4)
+	command: z$2.string().optional(),
+	args: z$2.array(z$2.string()).optional(),
+	timeout: z$2.number().default(3e4)
 });
 /**
 * Rule severity levels (inspired by ESLint).
 */
-const RuleSeveritySchema = z$1.enum([
+const RuleSeveritySchema = z$2.enum([
 	"off",
 	"warn",
 	"error"
@@ -188,7 +188,7 @@ const RuleSeveritySchema = z$1.enum([
 /**
 * Contract kinds for per-kind rule overrides.
 */
-const SpecKindSchema = z$1.enum([
+const SpecKindSchema = z$2.enum([
 	"operation",
 	"event",
 	"presentation",
@@ -203,7 +203,7 @@ const SpecKindSchema = z$1.enum([
 /**
 * Available lint rules with their severity.
 */
-const LintRulesSchema = z$1.object({
+const LintRulesSchema = z$2.object({
 	"require-acceptance": RuleSeveritySchema.optional(),
 	"require-examples": RuleSeveritySchema.optional(),
 	"require-stability": RuleSeveritySchema.optional(),
@@ -220,36 +220,36 @@ const LintRulesSchema = z$1.object({
 /**
 * Full rules configuration with global defaults and per-kind overrides.
 */
-const RulesConfigSchema = z$1.object({
+const RulesConfigSchema = z$2.object({
 	defaults: LintRulesSchema.optional(),
-	overrides: z$1.record(SpecKindSchema, LintRulesSchema).optional()
+	overrides: z$2.record(SpecKindSchema, LintRulesSchema).optional()
 });
 /**
 * Full ContractSpec configuration schema (.contractsrc.json).
 */
-const ContractsrcSchema = z$1.object({
-	aiProvider: z$1.enum([
+const ContractsrcSchema = z$2.object({
+	aiProvider: z$2.enum([
 		"claude",
 		"openai",
 		"ollama",
 		"custom"
 	]).default("claude"),
-	aiModel: z$1.string().optional(),
-	agentMode: z$1.enum([
+	aiModel: z$2.string().optional(),
+	agentMode: z$2.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"),
+	customEndpoint: z$2.url().nullable().optional(),
+	customApiKey: z$2.string().nullable().optional(),
+	outputDir: z$2.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(),
+	defaultOwners: z$2.array(z$2.string()).default([]),
+	defaultTags: z$2.array(z$2.string()).default([]),
+	packages: z$2.array(z$2.string()).optional(),
+	excludePackages: z$2.array(z$2.string()).optional(),
+	recursive: z$2.boolean().optional(),
 	openapi: OpenApiConfigSchema.optional(),
 	ci: CiConfigSchema.optional(),
 	metaRepo: MetaRepoConfigSchema.optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.contracts",
-  "version": "1.44.1",
+  "version": "1.45.0",
   "description": "Core contract specification definitions and runtime",
   "keywords": [
     "contractspec",
@@ -22,33 +22,34 @@
     "lint": "bun lint:fix",
     "lint:fix": "eslint src --fix",
     "lint:check": "eslint src",
-    "test": "bun run"
+    "test": "bun test"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.44.1",
-    "@contractspec/tool.typescript": "1.44.1",
+    "@contractspec/tool.tsdown": "1.45.0",
+    "@contractspec/tool.typescript": "1.45.0",
     "@types/express": "^5.0.3",
     "@types/turndown": "^5.0.6",
     "tsdown": "^0.18.3",
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@pothos/core": "^4.9.1",
-    "@pothos/plugin-complexity": "^4.1.2",
-    "@pothos/plugin-dataloader": "^4.4.2",
-    "@pothos/plugin-prisma": "^4.14.0",
-    "@pothos/plugin-relay": "^4.4.3",
-    "@pothos/plugin-tracing": "^1.1.2",
     "@aws-sdk/client-secrets-manager": "^3.958.0",
     "@aws-sdk/client-sqs": "^3.958.0",
+    "@contractspec/lib.logger": "1.45.0",
+    "@contractspec/lib.schema": "1.45.0",
     "@elevenlabs/elevenlabs-js": "^2.27.0",
     "@google-cloud/secret-manager": "^6.1.1",
     "@google-cloud/storage": "^7.18.0",
-    "@contractspec/lib.logger": "1.44.1",
-    "@contractspec/lib.schema": "1.44.1",
     "@mistralai/mistralai": "^1.11.0",
     "@modelcontextprotocol/sdk": "^1.24.3",
+    "@pothos/core": "^4.9.1",
+    "@pothos/plugin-complexity": "^4.1.2",
+    "@pothos/plugin-dataloader": "^4.4.2",
+    "@pothos/plugin-prisma": "^4.14.0",
+    "@pothos/plugin-relay": "^4.4.3",
+    "@pothos/plugin-tracing": "^1.1.2",
     "@qdrant/js-client-rest": "^1.16.2",
+    "compare-versions": "^6.1.1",
     "googleapis": "^169.0.0",
     "mcp-handler": "^1.0.4",
     "postmark": "^4.0.4",
@@ -150,6 +151,12 @@
     "./docs/tech/vscode-extension.docblock": "./dist/docs/tech/vscode-extension.docblock.js",
     "./docs/types": "./dist/docs/types.js",
     "./events": "./dist/events.js",
+    "./examples": "./dist/examples/index.js",
+    "./examples/docs/examples.docblock": "./dist/examples/docs/examples.docblock.js",
+    "./examples/registry": "./dist/examples/registry.js",
+    "./examples/schema": "./dist/examples/schema.js",
+    "./examples/types": "./dist/examples/types.js",
+    "./examples/validation": "./dist/examples/validation.js",
     "./experiments/docs/experiments.docblock": "./dist/experiments/docs/experiments.docblock.js",
     "./experiments/evaluator": "./dist/experiments/evaluator.js",
     "./experiments/spec": "./dist/experiments/spec.js",