@contractspec/lib.contracts-transformers 3.7.10 → 3.7.12

package/dist/browser/index.js

@@ -2358,6 +2358,62 @@ async function parseOpenApi(source, options = {}) {
   const doc = parseOpenApiString(content, format);
   return parseOpenApiDocument(doc, options);
 }
+// src/openapi/index.ts
+var tech_contracts_openapi_import_DocBlocks = [
+  {
+    id: "docs.tech.contracts.openapi-import",
+    title: "OpenAPI Import (OpenAPI 3.1) to ContractSpec",
+    summary: "Import OpenAPI specifications into ContractSpec models, or generate pure Zod/JSON-Schema/GraphQL representations.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/tech/contracts/openapi-import",
+    tags: ["contracts", "openapi", "import", "codegen"],
+    body: `## OpenAPI Import (OpenAPI 3.1)
+
+### Purpose
+
+Import external API definitions into your codebase. Supports both one-time scaffolding and multi-format generation for integration.
+
+### Modes
+
+#### 1. ContractSpec Scaffolding (Default)
+
+Generates standard \`defineSchemaModel\` definitions for full ContractSpec integration.
+
+\`\`\`bash
+contractspec openapi import --file api.json --output ./src/contracts
+\`\`\`
+
+#### 2. Multi-Format Generation
+
+Generate schemas in specific formats for direct use in other parts of your stack (adapters, UI, etc.).
+
+- **Zod**: Pure Zod schemas (\`z.object(...)\`).
+- **GraphQL**: GraphQL SDL type definitions.
+- **JSON Schema**: Standard JSON Schema objects.
+
+\`\`\`bash
+# Generate Zod schemas suitable for runtime validation
+contractspec openapi import --file api.json --output ./src/zod --schema-format zod
+\`\`\`
+
+### Library API
+
+- Function: \`importFromOpenApi(doc, options)\`
+- Location: \`@contractspec/lib.contracts-transformers/openapi\`
+- Options:
+  - \`schemaFormat\`: 'contractspec' | 'zod' | 'json-schema' | 'graphql'
+  - \`prefix\`: Prefix for model names
+  - \`tags\`: Filter by OpenAPI tags
+
+### CLI
+
+\`\`\`bash
+contractspec openapi import --file <path-or-url> --output <dir> [--schema-format <format>]
+\`\`\`
+`
+  }
+];
 export {
   toValidIdentifier,
   toSpecKey,
@@ -2370,6 +2426,7 @@ export {
   toHttpMethod,
   toFileName,
   toCamelCase,
+  tech_contracts_openapi_import_DocBlocks,
   schemaModelToJsonSchema,
   parseOpenApiString,
   parseOpenApiDocument,

package/dist/browser/openapi/index.js

@@ -2359,11 +2359,68 @@ async function parseOpenApi(source, options = {}) {
   const doc = parseOpenApiString(content, format);
   return parseOpenApiDocument(doc, options);
 }
+// src/openapi/index.ts
+var tech_contracts_openapi_import_DocBlocks = [
+  {
+    id: "docs.tech.contracts.openapi-import",
+    title: "OpenAPI Import (OpenAPI 3.1) to ContractSpec",
+    summary: "Import OpenAPI specifications into ContractSpec models, or generate pure Zod/JSON-Schema/GraphQL representations.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/tech/contracts/openapi-import",
+    tags: ["contracts", "openapi", "import", "codegen"],
+    body: `## OpenAPI Import (OpenAPI 3.1)
+
+### Purpose
+
+Import external API definitions into your codebase. Supports both one-time scaffolding and multi-format generation for integration.
+
+### Modes
+
+#### 1. ContractSpec Scaffolding (Default)
+
+Generates standard \`defineSchemaModel\` definitions for full ContractSpec integration.
+
+\`\`\`bash
+contractspec openapi import --file api.json --output ./src/contracts
+\`\`\`
+
+#### 2. Multi-Format Generation
+
+Generate schemas in specific formats for direct use in other parts of your stack (adapters, UI, etc.).
+
+- **Zod**: Pure Zod schemas (\`z.object(...)\`).
+- **GraphQL**: GraphQL SDL type definitions.
+- **JSON Schema**: Standard JSON Schema objects.
+
+\`\`\`bash
+# Generate Zod schemas suitable for runtime validation
+contractspec openapi import --file api.json --output ./src/zod --schema-format zod
+\`\`\`
+
+### Library API
+
+- Function: \`importFromOpenApi(doc, options)\`
+- Location: \`@contractspec/lib.contracts-transformers/openapi\`
+- Options:
+  - \`schemaFormat\`: 'contractspec' | 'zod' | 'json-schema' | 'graphql'
+  - \`prefix\`: Prefix for model names
+  - \`tags\`: Filter by OpenAPI tags
+
+### CLI
+
+\`\`\`bash
+contractspec openapi import --file <path-or-url> --output <dir> [--schema-format <format>]
+\`\`\`
+`
+  }
+];
 export {
   toSchemaName,
   toRestPath,
   toOperationId,
   toHttpMethod,
+  tech_contracts_openapi_import_DocBlocks,
   schemaModelToJsonSchema,
   parseOpenApiString,
   parseOpenApiDocument,

package/dist/index.js

@@ -2359,6 +2359,62 @@ async function parseOpenApi(source, options = {}) {
   const doc = parseOpenApiString(content, format);
   return parseOpenApiDocument(doc, options);
 }
+// src/openapi/index.ts
+var tech_contracts_openapi_import_DocBlocks = [
+  {
+    id: "docs.tech.contracts.openapi-import",
+    title: "OpenAPI Import (OpenAPI 3.1) to ContractSpec",
+    summary: "Import OpenAPI specifications into ContractSpec models, or generate pure Zod/JSON-Schema/GraphQL representations.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/tech/contracts/openapi-import",
+    tags: ["contracts", "openapi", "import", "codegen"],
+    body: `## OpenAPI Import (OpenAPI 3.1)
+
+### Purpose
+
+Import external API definitions into your codebase. Supports both one-time scaffolding and multi-format generation for integration.
+
+### Modes
+
+#### 1. ContractSpec Scaffolding (Default)
+
+Generates standard \`defineSchemaModel\` definitions for full ContractSpec integration.
+
+\`\`\`bash
+contractspec openapi import --file api.json --output ./src/contracts
+\`\`\`
+
+#### 2. Multi-Format Generation
+
+Generate schemas in specific formats for direct use in other parts of your stack (adapters, UI, etc.).
+
+- **Zod**: Pure Zod schemas (\`z.object(...)\`).
+- **GraphQL**: GraphQL SDL type definitions.
+- **JSON Schema**: Standard JSON Schema objects.
+
+\`\`\`bash
+# Generate Zod schemas suitable for runtime validation
+contractspec openapi import --file api.json --output ./src/zod --schema-format zod
+\`\`\`
+
+### Library API
+
+- Function: \`importFromOpenApi(doc, options)\`
+- Location: \`@contractspec/lib.contracts-transformers/openapi\`
+- Options:
+  - \`schemaFormat\`: 'contractspec' | 'zod' | 'json-schema' | 'graphql'
+  - \`prefix\`: Prefix for model names
+  - \`tags\`: Filter by OpenAPI tags
+
+### CLI
+
+\`\`\`bash
+contractspec openapi import --file <path-or-url> --output <dir> [--schema-format <format>]
+\`\`\`
+`
+  }
+];
 export {
   toValidIdentifier,
   toSpecKey,
@@ -2371,6 +2427,7 @@ export {
   toHttpMethod,
   toFileName,
   toCamelCase,
+  tech_contracts_openapi_import_DocBlocks,
   schemaModelToJsonSchema,
   parseOpenApiString,
   parseOpenApiDocument,

package/dist/node/index.js

@@ -2358,6 +2358,62 @@ async function parseOpenApi(source, options = {}) {
   const doc = parseOpenApiString(content, format);
   return parseOpenApiDocument(doc, options);
 }
+// src/openapi/index.ts
+var tech_contracts_openapi_import_DocBlocks = [
+  {
+    id: "docs.tech.contracts.openapi-import",
+    title: "OpenAPI Import (OpenAPI 3.1) to ContractSpec",
+    summary: "Import OpenAPI specifications into ContractSpec models, or generate pure Zod/JSON-Schema/GraphQL representations.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/tech/contracts/openapi-import",
+    tags: ["contracts", "openapi", "import", "codegen"],
+    body: `## OpenAPI Import (OpenAPI 3.1)
+
+### Purpose
+
+Import external API definitions into your codebase. Supports both one-time scaffolding and multi-format generation for integration.
+
+### Modes
+
+#### 1. ContractSpec Scaffolding (Default)
+
+Generates standard \`defineSchemaModel\` definitions for full ContractSpec integration.
+
+\`\`\`bash
+contractspec openapi import --file api.json --output ./src/contracts
+\`\`\`
+
+#### 2. Multi-Format Generation
+
+Generate schemas in specific formats for direct use in other parts of your stack (adapters, UI, etc.).
+
+- **Zod**: Pure Zod schemas (\`z.object(...)\`).
+- **GraphQL**: GraphQL SDL type definitions.
+- **JSON Schema**: Standard JSON Schema objects.
+
+\`\`\`bash
+# Generate Zod schemas suitable for runtime validation
+contractspec openapi import --file api.json --output ./src/zod --schema-format zod
+\`\`\`
+
+### Library API
+
+- Function: \`importFromOpenApi(doc, options)\`
+- Location: \`@contractspec/lib.contracts-transformers/openapi\`
+- Options:
+  - \`schemaFormat\`: 'contractspec' | 'zod' | 'json-schema' | 'graphql'
+  - \`prefix\`: Prefix for model names
+  - \`tags\`: Filter by OpenAPI tags
+
+### CLI
+
+\`\`\`bash
+contractspec openapi import --file <path-or-url> --output <dir> [--schema-format <format>]
+\`\`\`
+`
+  }
+];
 export {
   toValidIdentifier,
   toSpecKey,
@@ -2370,6 +2426,7 @@ export {
   toHttpMethod,
   toFileName,
   toCamelCase,
+  tech_contracts_openapi_import_DocBlocks,
   schemaModelToJsonSchema,
   parseOpenApiString,
   parseOpenApiDocument,

package/dist/node/openapi/index.js

@@ -2359,11 +2359,68 @@ async function parseOpenApi(source, options = {}) {
   const doc = parseOpenApiString(content, format);
   return parseOpenApiDocument(doc, options);
 }
+// src/openapi/index.ts
+var tech_contracts_openapi_import_DocBlocks = [
+  {
+    id: "docs.tech.contracts.openapi-import",
+    title: "OpenAPI Import (OpenAPI 3.1) to ContractSpec",
+    summary: "Import OpenAPI specifications into ContractSpec models, or generate pure Zod/JSON-Schema/GraphQL representations.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/tech/contracts/openapi-import",
+    tags: ["contracts", "openapi", "import", "codegen"],
+    body: `## OpenAPI Import (OpenAPI 3.1)
+
+### Purpose
+
+Import external API definitions into your codebase. Supports both one-time scaffolding and multi-format generation for integration.
+
+### Modes
+
+#### 1. ContractSpec Scaffolding (Default)
+
+Generates standard \`defineSchemaModel\` definitions for full ContractSpec integration.
+
+\`\`\`bash
+contractspec openapi import --file api.json --output ./src/contracts
+\`\`\`
+
+#### 2. Multi-Format Generation
+
+Generate schemas in specific formats for direct use in other parts of your stack (adapters, UI, etc.).
+
+- **Zod**: Pure Zod schemas (\`z.object(...)\`).
+- **GraphQL**: GraphQL SDL type definitions.
+- **JSON Schema**: Standard JSON Schema objects.
+
+\`\`\`bash
+# Generate Zod schemas suitable for runtime validation
+contractspec openapi import --file api.json --output ./src/zod --schema-format zod
+\`\`\`
+
+### Library API
+
+- Function: \`importFromOpenApi(doc, options)\`
+- Location: \`@contractspec/lib.contracts-transformers/openapi\`
+- Options:
+  - \`schemaFormat\`: 'contractspec' | 'zod' | 'json-schema' | 'graphql'
+  - \`prefix\`: Prefix for model names
+  - \`tags\`: Filter by OpenAPI tags
+
+### CLI
+
+\`\`\`bash
+contractspec openapi import --file <path-or-url> --output <dir> [--schema-format <format>]
+\`\`\`
+`
+  }
+];
 export {
   toSchemaName,
   toRestPath,
   toOperationId,
   toHttpMethod,
+  tech_contracts_openapi_import_DocBlocks,
   schemaModelToJsonSchema,
   parseOpenApiString,
   parseOpenApiDocument,

package/dist/openapi/index.d.ts

@@ -2,6 +2,7 @@
  * OpenAPI transformation module.
  * Import/export between ContractSpec and OpenAPI 3.x.
  */
+import type { DocBlock } from '@contractspec/lib.contracts-spec/docs';
 export { createSpecDiff, type DiffOptions, diffAll, diffSpecs, diffSpecVsOperation, formatDiffChanges, } from './differ';
 export { type ContractSpecRegistries, contractSpecToJson, contractSpecToYaml, defaultRestPath, exportContractSpec, openApiForRegistry, openApiToJson, openApiToYaml, } from './exporter';
 export * from './exporter/index';
@@ -9,3 +10,4 @@ export { importFromOpenApi, importOperation } from './importer';
 export { detectFormat, detectVersion, parseOpenApi, parseOpenApiDocument, parseOpenApiString, } from './parser';
 export { type GeneratedModel, generateImports, generateSchemaModelCode, getScalarType, jsonSchemaToType, type SchemaField, type TypescriptType, } from './schema-converter';
 export type { ContractSpecOpenApiDocument, HttpMethod, OpenApiDocument, OpenApiExportOptions, OpenApiOperation, OpenApiParameter, OpenApiParseOptions, OpenApiSchema, OpenApiServer, OpenApiSource, OpenApiTransportHints, OpenApiVersion, ParameterLocation, ParsedOperation, ParsedParameter, ParseResult, } from './types';
+export declare const tech_contracts_openapi_import_DocBlocks: DocBlock[];

package/dist/openapi/index.js

@@ -2360,11 +2360,68 @@ async function parseOpenApi(source, options = {}) {
   const doc = parseOpenApiString(content, format);
   return parseOpenApiDocument(doc, options);
 }
+// src/openapi/index.ts
+var tech_contracts_openapi_import_DocBlocks = [
+  {
+    id: "docs.tech.contracts.openapi-import",
+    title: "OpenAPI Import (OpenAPI 3.1) to ContractSpec",
+    summary: "Import OpenAPI specifications into ContractSpec models, or generate pure Zod/JSON-Schema/GraphQL representations.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/tech/contracts/openapi-import",
+    tags: ["contracts", "openapi", "import", "codegen"],
+    body: `## OpenAPI Import (OpenAPI 3.1)
+
+### Purpose
+
+Import external API definitions into your codebase. Supports both one-time scaffolding and multi-format generation for integration.
+
+### Modes
+
+#### 1. ContractSpec Scaffolding (Default)
+
+Generates standard \`defineSchemaModel\` definitions for full ContractSpec integration.
+
+\`\`\`bash
+contractspec openapi import --file api.json --output ./src/contracts
+\`\`\`
+
+#### 2. Multi-Format Generation
+
+Generate schemas in specific formats for direct use in other parts of your stack (adapters, UI, etc.).
+
+- **Zod**: Pure Zod schemas (\`z.object(...)\`).
+- **GraphQL**: GraphQL SDL type definitions.
+- **JSON Schema**: Standard JSON Schema objects.
+
+\`\`\`bash
+# Generate Zod schemas suitable for runtime validation
+contractspec openapi import --file api.json --output ./src/zod --schema-format zod
+\`\`\`
+
+### Library API
+
+- Function: \`importFromOpenApi(doc, options)\`
+- Location: \`@contractspec/lib.contracts-transformers/openapi\`
+- Options:
+  - \`schemaFormat\`: 'contractspec' | 'zod' | 'json-schema' | 'graphql'
+  - \`prefix\`: Prefix for model names
+  - \`tags\`: Filter by OpenAPI tags
+
+### CLI
+
+\`\`\`bash
+contractspec openapi import --file <path-or-url> --output <dir> [--schema-format <format>]
+\`\`\`
+`
+  }
+];
 export {
   toSchemaName,
   toRestPath,
   toOperationId,
   toHttpMethod,
+  tech_contracts_openapi_import_DocBlocks,
   schemaModelToJsonSchema,
   parseOpenApiString,
   parseOpenApiDocument,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.contracts-transformers",
-  "version": "3.7.10",
+  "version": "3.7.12",
   "description": "Contract format transformations: import/export between ContractSpec and external formats (OpenAPI, AsyncAPI, etc.)",
   "keywords": [
     "contractspec",
@@ -27,17 +27,17 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts-spec": "4.1.2",
-    "@contractspec/lib.schema": "3.7.8",
+    "@contractspec/lib.contracts-spec": "5.0.0",
+    "@contractspec/lib.schema": "3.7.10",
     "compare-versions": "^6.1.1",
     "openapi-types": "^12.1.3",
     "yaml": "^2.7.1",
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.8",
+    "@contractspec/tool.typescript": "3.7.9",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.8"
+    "@contractspec/tool.bun": "3.7.9"
   },
   "types": "./dist/index.d.ts",
   "files": [