@danceroutine/tango-openapi 0.1.0 → 1.0.0

package/dist/generators-JMALItMS.js

@@ -0,0 +1,346 @@
+import { __export } from "./chunk-BkvOhyD0.js";
+import { generateSchemaFromModel, generateSchemaFromZod } from "./schema-D3ybOrpr.js";
+import { z } from "zod";
+
+//#region src/generators/spec/generateOpenAPISpec.ts
+const JSON_CONTENT_TYPE = "application/json";
+function toOpenAPIModel(metadata) {
+	return {
+		name: metadata.name,
+		fields: Object.fromEntries(metadata.fields.map((field) => [field.name, {
+			type: field.type,
+			nullable: field.notNull !== true,
+			default: field.default,
+			primaryKey: field.primaryKey
+		}]))
+	};
+}
+function normalizePath(path) {
+	const trimmed = path.trim();
+	if (!trimmed) throw new Error("OpenAPI paths must not be empty.");
+	if (/(^|\/):/.test(trimmed)) throw new Error(`OpenAPI paths must use {param} syntax, received '${trimmed}'.`);
+	const withLeadingSlash = trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+	if (withLeadingSlash === "/") return "/";
+	return withLeadingSlash.replace(/\/+$/g, "");
+}
+function joinPath(base, segment) {
+	const normalizedSegment = segment.replace(/^\/+|\/+$/g, "");
+	return base === "/" ? `/${normalizedSegment}` : `${base}/${normalizedSegment}`;
+}
+function toMethodKey(method) {
+	return method.toLowerCase();
+}
+function isReferenceObject(value) {
+	return typeof value === "object" && value !== null && typeof value.$ref === "string";
+}
+function isZodSchema(value) {
+	return value instanceof z.ZodType;
+}
+function toSchema(value) {
+	if (isReferenceObject(value)) return value;
+	if (isZodSchema(value)) return generateSchemaFromZod(value);
+	return value;
+}
+function arraySchema(items) {
+	return {
+		type: "array",
+		items
+	};
+}
+function paginatedResultsSchema(items) {
+	return {
+		type: "object",
+		properties: {
+			count: { type: "integer" },
+			next: { type: "string" },
+			previous: { type: "string" },
+			results: arraySchema(items)
+		},
+		required: ["count", "results"]
+	};
+}
+function jsonResponse(description, schema) {
+	return schema ? {
+		description,
+		content: { [JSON_CONTENT_TYPE]: { schema } }
+	} : { description };
+}
+function jsonRequestBody(schema, required = true) {
+	return {
+		required,
+		content: { [JSON_CONTENT_TYPE]: { schema } }
+	};
+}
+function withOverride(operation, override, fallbackTags) {
+	if (!override) return operation;
+	const nextOperation = {
+		...operation,
+		summary: override.summary ?? operation.summary,
+		description: override.description ?? operation.description,
+		tags: override.tags ?? operation.tags ?? fallbackTags,
+		parameters: override.parameters ?? operation.parameters,
+		requestBody: override.requestBody ? jsonRequestBody(toSchema(override.requestBody.schema), override.requestBody.required ?? true) : operation.requestBody,
+		responses: operation.responses
+	};
+	if (override.responses) {
+		nextOperation.responses = Object.fromEntries(Object.entries(override.responses).map(([status, response]) => {
+			return [status, jsonResponse(response.description, response.schema ? toSchema(response.schema) : undefined)];
+		}));
+		return nextOperation;
+	}
+	if (override.responseSchema || override.responseStatus || override.responseDescription) {
+		const status = override.responseStatus ?? "200";
+		nextOperation.responses = { [status]: jsonResponse(override.responseDescription ?? "Successful response", override.responseSchema ? toSchema(override.responseSchema) : undefined) };
+	}
+	return nextOperation;
+}
+function ensurePath(paths, path) {
+	const existing = paths[path];
+	if (existing) return existing;
+	const created = {};
+	paths[path] = created;
+	return created;
+}
+function setOperation(paths, path, method, operation) {
+	const pathItem = ensurePath(paths, path);
+	pathItem[toMethodKey(method)] = operation;
+}
+function buildListParameters(searchFields, orderingFields, usesDefaultOffsetPagination) {
+	const parameters = [];
+	if (usesDefaultOffsetPagination) parameters.push({
+		name: "limit",
+		in: "query",
+		schema: { type: "integer" }
+	}, {
+		name: "offset",
+		in: "query",
+		schema: { type: "integer" }
+	});
+	if (searchFields.length > 0) parameters.push({
+		name: "search",
+		in: "query",
+		schema: { type: "string" }
+	});
+	if (orderingFields.length > 0) parameters.push({
+		name: "ordering",
+		in: "query",
+		schema: { type: "string" }
+	});
+	return parameters;
+}
+function buildPathParameter(name) {
+	return {
+		name,
+		in: "path",
+		required: true,
+		schema: { type: "string" }
+	};
+}
+function stringifyFields(fields) {
+	return fields.map(String);
+}
+function titleize(input) {
+	return input.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[-_]+/g, " ").trim().replace(/\b\w/g, (char) => char.toUpperCase());
+}
+function validateGenericDetailPath(detailPath, lookupParam) {
+	if (!detailPath.includes(`{${lookupParam}}`)) throw new Error(`GenericAPIView detail paths must include '{${lookupParam}}', received '${detailPath}'.`);
+}
+function ensureModelSchema(schemas, metadata) {
+	schemas[metadata.name] = generateSchemaFromModel(toOpenAPIModel(metadata));
+}
+function registerViewSetDescriptor(paths, schemas, descriptor) {
+	const metadata = descriptor.resource.describeOpenAPI();
+	const modelName = metadata.model.metadata.name;
+	const tags = descriptor.tags ?? [modelName];
+	const collectionPath = normalizePath(descriptor.basePath);
+	const detailPath = collectionPath === "/" ? "/{id}" : `${collectionPath}/{id}`;
+	const readSchema = toSchema(metadata.outputSchema);
+	const writeSchema = toSchema(metadata.createSchema);
+	const updateSchema = toSchema(metadata.updateSchema);
+	ensureModelSchema(schemas, metadata.model.metadata);
+	const listOperation = withOverride({
+		summary: `List ${modelName}s`,
+		tags,
+		parameters: buildListParameters(stringifyFields(metadata.searchFields), stringifyFields(metadata.orderingFields), metadata.usesDefaultOffsetPagination),
+		responses: { "200": jsonResponse("Successful response", metadata.usesDefaultOffsetPagination ? paginatedResultsSchema(readSchema) : undefined) }
+	}, undefined, tags);
+	setOperation(paths, collectionPath, "GET", listOperation);
+	setOperation(paths, collectionPath, "POST", {
+		summary: `Create ${modelName}`,
+		tags,
+		requestBody: jsonRequestBody(writeSchema),
+		responses: { "201": jsonResponse("Created", readSchema) }
+	});
+	setOperation(paths, detailPath, "GET", {
+		summary: `Get ${modelName}`,
+		tags,
+		parameters: [buildPathParameter("id")],
+		responses: {
+			"200": jsonResponse("Successful response", readSchema),
+			"404": { description: "Not found" }
+		}
+	});
+	const updateResponses = {
+		"200": jsonResponse("Updated", readSchema),
+		"404": { description: "Not found" }
+	};
+	setOperation(paths, detailPath, "PUT", {
+		summary: `Update ${modelName}`,
+		tags,
+		parameters: [buildPathParameter("id")],
+		requestBody: jsonRequestBody(updateSchema),
+		responses: updateResponses
+	});
+	setOperation(paths, detailPath, "PATCH", {
+		summary: `Update ${modelName}`,
+		tags,
+		parameters: [buildPathParameter("id")],
+		requestBody: jsonRequestBody(updateSchema),
+		responses: updateResponses
+	});
+	setOperation(paths, detailPath, "DELETE", {
+		summary: `Delete ${modelName}`,
+		tags,
+		parameters: [buildPathParameter("id")],
+		responses: {
+			"204": { description: "Deleted" },
+			"404": { description: "Not found" }
+		}
+	});
+	for (const action of metadata.actions) {
+		const actionPath = action.scope === "detail" ? joinPath(detailPath, action.path) : joinPath(collectionPath, action.path);
+		const baseOperation = {
+			summary: titleize(action.name),
+			tags,
+			...action.scope === "detail" ? { parameters: [buildPathParameter("id")] } : {},
+			responses: { "200": { description: "Successful response" } }
+		};
+		const override = descriptor.actions?.[action.name];
+		for (const method of action.methods) setOperation(paths, actionPath, method, withOverride(baseOperation, override, tags));
+	}
+}
+function registerGenericDescriptor(paths, schemas, descriptor) {
+	if (!descriptor.collectionPath && !descriptor.detailPath) throw new Error("GenericAPIView OpenAPI descriptors require at least one of collectionPath or detailPath.");
+	const metadata = descriptor.resource.describeOpenAPI();
+	const modelName = metadata.model.metadata.name;
+	const tags = descriptor.tags ?? [modelName];
+	const readSchema = toSchema(metadata.outputSchema);
+	const writeSchema = toSchema(metadata.createSchema);
+	const updateSchema = toSchema(metadata.updateSchema);
+	const allowed = new Set(metadata.allowedMethods);
+	ensureModelSchema(schemas, metadata.model.metadata);
+	if (descriptor.collectionPath) {
+		const collectionPath = normalizePath(descriptor.collectionPath);
+		if (allowed.has("GET")) setOperation(paths, collectionPath, "GET", withOverride({
+			summary: `List ${modelName}s`,
+			tags,
+			parameters: buildListParameters(stringifyFields(metadata.searchFields), stringifyFields(metadata.orderingFields), metadata.usesDefaultOffsetPagination),
+			responses: { "200": jsonResponse("Successful response", metadata.usesDefaultOffsetPagination ? paginatedResultsSchema(readSchema) : undefined) }
+		}, descriptor.methods?.GET, tags));
+		if (allowed.has("POST")) setOperation(paths, collectionPath, "POST", withOverride({
+			summary: `Create ${modelName}`,
+			tags,
+			requestBody: jsonRequestBody(writeSchema),
+			responses: { "201": jsonResponse("Created", readSchema) }
+		}, descriptor.methods?.POST, tags));
+	}
+	if (descriptor.detailPath) {
+		const detailPath = normalizePath(descriptor.detailPath);
+		validateGenericDetailPath(detailPath, metadata.lookupParam);
+		const detailParameters = [buildPathParameter(metadata.lookupParam)];
+		if (allowed.has("GET")) setOperation(paths, detailPath, "GET", withOverride({
+			summary: `Get ${modelName}`,
+			tags,
+			parameters: detailParameters,
+			responses: {
+				"200": jsonResponse("Successful response", readSchema),
+				"404": { description: "Not found" }
+			}
+		}, descriptor.methods?.GET, tags));
+		if (allowed.has("PUT")) setOperation(paths, detailPath, "PUT", withOverride({
+			summary: `Update ${modelName}`,
+			tags,
+			parameters: detailParameters,
+			requestBody: jsonRequestBody(updateSchema),
+			responses: {
+				"200": jsonResponse("Updated", readSchema),
+				"404": { description: "Not found" }
+			}
+		}, descriptor.methods?.PUT, tags));
+		if (allowed.has("PATCH")) setOperation(paths, detailPath, "PATCH", withOverride({
+			summary: `Update ${modelName}`,
+			tags,
+			parameters: detailParameters,
+			requestBody: jsonRequestBody(updateSchema),
+			responses: {
+				"200": jsonResponse("Updated", readSchema),
+				"404": { description: "Not found" }
+			}
+		}, descriptor.methods?.PATCH, tags));
+		if (allowed.has("DELETE")) setOperation(paths, detailPath, "DELETE", withOverride({
+			summary: `Delete ${modelName}`,
+			tags,
+			parameters: detailParameters,
+			responses: {
+				"204": { description: "Deleted" },
+				"404": { description: "Not found" }
+			}
+		}, descriptor.methods?.DELETE, tags));
+	}
+}
+function registerAPIViewDescriptor(paths, descriptor) {
+	const path = normalizePath(descriptor.path);
+	const allowed = new Set(descriptor.resource.getAllowedMethods());
+	const methods = Object.entries(descriptor.methods);
+	for (const [method, override] of methods) {
+		if (!allowed.has(method)) throw new Error(`APIView method '${method}' is not implemented on ${descriptor.resource.constructor.name}.`);
+		setOperation(paths, path, method, withOverride({
+			summary: `${method} ${titleize(descriptor.resource.constructor.name.replace(/APIView$/, ""))}`.trim(),
+			responses: { [override.responseStatus ?? "200"]: jsonResponse(override.responseDescription ?? "Successful response", override.responseSchema ? toSchema(override.responseSchema) : undefined) }
+		}, override, descriptor.tags ?? [descriptor.resource.constructor.name.replace(/APIView$/, "") || "APIView"]));
+	}
+}
+function generateOpenAPISpec(config) {
+	const paths = {};
+	const schemas = {};
+	for (const resource of config.resources ?? []) registerDescriptor(paths, schemas, resource);
+	return {
+		openapi: "3.1.0",
+		info: {
+			title: config.title,
+			version: config.version,
+			description: config.description
+		},
+		servers: config.servers,
+		paths,
+		components: { schemas }
+	};
+}
+function registerDescriptor(paths, schemas, descriptor) {
+	if (descriptor.kind === "viewset") {
+		registerViewSetDescriptor(paths, schemas, descriptor);
+		return;
+	}
+	if (descriptor.kind === "generic") {
+		registerGenericDescriptor(paths, schemas, descriptor);
+		return;
+	}
+	registerAPIViewDescriptor(paths, descriptor);
+}
+
+//#endregion
+//#region src/generators/spec/index.ts
+var spec_exports = {};
+__export(spec_exports, { generateOpenAPISpec: () => generateOpenAPISpec });
+
+//#endregion
+//#region src/generators/index.ts
+var generators_exports = {};
+__export(generators_exports, {
+	generateOpenAPISpec: () => generateOpenAPISpec,
+	spec: () => spec_exports
+});
+
+//#endregion
+export { generateOpenAPISpec, generators_exports, spec_exports };
+//# sourceMappingURL=generators-JMALItMS.js.map

package/dist/generators-JMALItMS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generators-JMALItMS.js","names":["metadata: ResourceModelMetadata","path: string","base: string","segment: string","method: HttpMethod","value: unknown","value: z.ZodType | SchemaObject | ReferenceObject","items: SchemaObject | ReferenceObject","description: string","schema?: SchemaObject | ReferenceObject","schema: SchemaObject | ReferenceObject","required: boolean","operation: OperationObject","override: OpenAPIOperationOverride | undefined","fallbackTags: string[]","nextOperation: OperationObject","paths: Record<string, PathItemObject>","created: PathItemObject","searchFields: readonly string[]","orderingFields: readonly string[]","usesDefaultOffsetPagination: boolean","parameters: ParameterObject[]","name: string","fields: readonly unknown[]","input: string","detailPath: string","lookupParam: string","schemas: Record<string, SchemaObject>","descriptor: OpenAPIViewSetDescriptor","baseOperation: OperationObject","descriptor: OpenAPIGenericAPIViewDescriptor","descriptor: OpenAPIAPIViewDescriptor","config: OpenAPIGeneratorConfig","descriptor: OpenAPIResourceDescriptor"],"sources":["../src/generators/spec/generateOpenAPISpec.ts","../src/generators/spec/index.ts","../src/generators/index.ts"],"sourcesContent":["import { z } from 'zod';\nimport { generateSchemaFromModel, generateSchemaFromZod } from '../../mappers/schema';\nimport type {\n    OpenAPIAPIViewDescriptor,\n    OpenAPIGeneratorConfig,\n    OpenAPIGenericAPIViewDescriptor,\n    OpenAPIOperationOverride,\n    OpenAPIResourceDescriptor,\n    OpenAPIViewSetDescriptor,\n    OpenAPISpec,\n    OperationObject,\n    ParameterObject,\n    PathItemObject,\n    ReferenceObject,\n    RequestBodyObject,\n    ResponseObject,\n    SchemaObject,\n} from '../../domain';\n\nconst JSON_CONTENT_TYPE = 'application/json';\nconst HTTP_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'] as const;\ntype HttpMethod = (typeof HTTP_METHODS)[number];\ntype PathMethodKey = Lowercase<HttpMethod>;\n\ntype ResourceModelMetadata = {\n    name: string;\n    fields: Array<{\n        name: string;\n        type: string;\n        notNull?: boolean;\n        default?: unknown;\n        primaryKey?: boolean;\n    }>;\n};\n\nfunction toOpenAPIModel(metadata: ResourceModelMetadata) {\n    return {\n        name: metadata.name,\n        fields: Object.fromEntries(\n            metadata.fields.map((field) => [\n                field.name,\n                {\n                    type: field.type,\n                    nullable: field.notNull !== true,\n                    default: field.default,\n                    primaryKey: field.primaryKey,\n                },\n            ])\n        ),\n    };\n}\n\nfunction normalizePath(path: string): string {\n    const trimmed = path.trim();\n    if (!trimmed) {\n        throw new Error('OpenAPI paths must not be empty.');\n    }\n    if (/(^|\\/):/.test(trimmed)) {\n        throw new Error(`OpenAPI paths must use {param} syntax, received '${trimmed}'.`);\n    }\n\n    const withLeadingSlash = trimmed.startsWith('/') ? trimmed : `/${trimmed}`;\n    if (withLeadingSlash === '/') {\n        return '/';\n    }\n\n    return withLeadingSlash.replace(/\\/+$/g, '');\n}\n\nfunction joinPath(base: string, segment: string): string {\n    const normalizedSegment = segment.replace(/^\\/+|\\/+$/g, '');\n    return base === '/' ? `/${normalizedSegment}` : `${base}/${normalizedSegment}`;\n}\n\nfunction toMethodKey(method: HttpMethod): PathMethodKey {\n    return method.toLowerCase() as PathMethodKey;\n}\n\nfunction isReferenceObject(value: unknown): value is ReferenceObject {\n    return typeof value === 'object' && value !== null && typeof (value as { $ref?: unknown }).$ref === 'string';\n}\n\nfunction isZodSchema(value: unknown): value is z.ZodType {\n    // oxlint-disable-next-line eslint-js/no-restricted-syntax\n    return value instanceof z.ZodType;\n}\n\nfunction toSchema(value: z.ZodType | SchemaObject | ReferenceObject): SchemaObject | ReferenceObject {\n    if (isReferenceObject(value)) {\n        return value;\n    }\n    if (isZodSchema(value)) {\n        return generateSchemaFromZod(value);\n    }\n    return value;\n}\n\nfunction arraySchema(items: SchemaObject | ReferenceObject): SchemaObject {\n    return {\n        type: 'array',\n        items,\n    };\n}\n\nfunction paginatedResultsSchema(items: SchemaObject | ReferenceObject): SchemaObject {\n    return {\n        type: 'object',\n        properties: {\n            count: { type: 'integer' },\n            next: { type: 'string' },\n            previous: { type: 'string' },\n            results: arraySchema(items),\n        },\n        required: ['count', 'results'],\n    };\n}\n\nfunction jsonResponse(description: string, schema?: SchemaObject | ReferenceObject): ResponseObject {\n    return schema\n        ? {\n              description,\n              content: {\n                  [JSON_CONTENT_TYPE]: {\n                      schema,\n                  },\n              },\n          }\n        : { description };\n}\n\nfunction jsonRequestBody(schema: SchemaObject | ReferenceObject, required: boolean = true): RequestBodyObject {\n    return {\n        required,\n        content: {\n            [JSON_CONTENT_TYPE]: {\n                schema,\n            },\n        },\n    };\n}\n\nfunction withOverride(\n    operation: OperationObject,\n    override: OpenAPIOperationOverride | undefined,\n    fallbackTags: string[]\n): OperationObject {\n    if (!override) {\n        return operation;\n    }\n\n    const nextOperation: OperationObject = {\n        ...operation,\n        summary: override.summary ?? operation.summary,\n        description: override.description ?? operation.description,\n        tags: override.tags ?? operation.tags ?? fallbackTags,\n        parameters: override.parameters ?? operation.parameters,\n        requestBody: override.requestBody\n            ? jsonRequestBody(toSchema(override.requestBody.schema), override.requestBody.required ?? true)\n            : operation.requestBody,\n        responses: operation.responses,\n    };\n\n    if (override.responses) {\n        nextOperation.responses = Object.fromEntries(\n            Object.entries(override.responses).map(([status, response]) => {\n                return [\n                    status,\n                    jsonResponse(response.description, response.schema ? toSchema(response.schema) : undefined),\n                ];\n            })\n        );\n        return nextOperation;\n    }\n\n    if (override.responseSchema || override.responseStatus || override.responseDescription) {\n        const status = override.responseStatus ?? '200';\n        nextOperation.responses = {\n            [status]: jsonResponse(\n                override.responseDescription ?? 'Successful response',\n                override.responseSchema ? toSchema(override.responseSchema) : undefined\n            ),\n        };\n    }\n\n    return nextOperation;\n}\n\nfunction ensurePath(paths: Record<string, PathItemObject>, path: string): PathItemObject {\n    const existing = paths[path];\n    if (existing) {\n        return existing;\n    }\n\n    const created: PathItemObject = {};\n    paths[path] = created;\n    return created;\n}\n\nfunction setOperation(\n    paths: Record<string, PathItemObject>,\n    path: string,\n    method: HttpMethod,\n    operation: OperationObject\n): void {\n    const pathItem = ensurePath(paths, path);\n    pathItem[toMethodKey(method)] = operation;\n}\n\nfunction buildListParameters(\n    searchFields: readonly string[],\n    orderingFields: readonly string[],\n    usesDefaultOffsetPagination: boolean\n): ParameterObject[] {\n    const parameters: ParameterObject[] = [];\n\n    if (usesDefaultOffsetPagination) {\n        parameters.push(\n            {\n                name: 'limit',\n                in: 'query',\n                schema: { type: 'integer' },\n            },\n            {\n                name: 'offset',\n                in: 'query',\n                schema: { type: 'integer' },\n            }\n        );\n    }\n\n    if (searchFields.length > 0) {\n        parameters.push({\n            name: 'search',\n            in: 'query',\n            schema: { type: 'string' },\n        });\n    }\n\n    if (orderingFields.length > 0) {\n        parameters.push({\n            name: 'ordering',\n            in: 'query',\n            schema: { type: 'string' },\n        });\n    }\n\n    return parameters;\n}\n\nfunction buildPathParameter(name: string): ParameterObject {\n    return {\n        name,\n        in: 'path',\n        required: true,\n        schema: { type: 'string' },\n    };\n}\n\nfunction stringifyFields(fields: readonly unknown[]): string[] {\n    return fields.map(String);\n}\n\nfunction titleize(input: string): string {\n    return input\n        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')\n        .replace(/[-_]+/g, ' ')\n        .trim()\n        .replace(/\\b\\w/g, (char) => char.toUpperCase());\n}\n\nfunction validateGenericDetailPath(detailPath: string, lookupParam: string): void {\n    if (!detailPath.includes(`{${lookupParam}}`)) {\n        throw new Error(`GenericAPIView detail paths must include '{${lookupParam}}', received '${detailPath}'.`);\n    }\n}\n\nfunction ensureModelSchema(schemas: Record<string, SchemaObject>, metadata: ResourceModelMetadata): void {\n    schemas[metadata.name] = generateSchemaFromModel(toOpenAPIModel(metadata));\n}\n\nfunction registerViewSetDescriptor(\n    paths: Record<string, PathItemObject>,\n    schemas: Record<string, SchemaObject>,\n    descriptor: OpenAPIViewSetDescriptor\n): void {\n    const metadata = descriptor.resource.describeOpenAPI();\n    const modelName = metadata.model.metadata.name;\n    const tags = descriptor.tags ?? [modelName];\n    const collectionPath = normalizePath(descriptor.basePath);\n    const detailPath = collectionPath === '/' ? '/{id}' : `${collectionPath}/{id}`;\n    const readSchema = toSchema(metadata.outputSchema);\n    const writeSchema = toSchema(metadata.createSchema);\n    const updateSchema = toSchema(metadata.updateSchema);\n\n    ensureModelSchema(schemas, metadata.model.metadata);\n\n    const listOperation = withOverride(\n        {\n            summary: `List ${modelName}s`,\n            tags,\n            parameters: buildListParameters(\n                stringifyFields(metadata.searchFields),\n                stringifyFields(metadata.orderingFields),\n                metadata.usesDefaultOffsetPagination\n            ),\n            responses: {\n                '200': jsonResponse(\n                    'Successful response',\n                    metadata.usesDefaultOffsetPagination ? paginatedResultsSchema(readSchema) : undefined\n                ),\n            },\n        },\n        undefined,\n        tags\n    );\n\n    setOperation(paths, collectionPath, 'GET', listOperation);\n    setOperation(paths, collectionPath, 'POST', {\n        summary: `Create ${modelName}`,\n        tags,\n        requestBody: jsonRequestBody(writeSchema),\n        responses: {\n            '201': jsonResponse('Created', readSchema),\n        },\n    });\n    setOperation(paths, detailPath, 'GET', {\n        summary: `Get ${modelName}`,\n        tags,\n        parameters: [buildPathParameter('id')],\n        responses: {\n            '200': jsonResponse('Successful response', readSchema),\n            '404': { description: 'Not found' },\n        },\n    });\n    const updateResponses = {\n        '200': jsonResponse('Updated', readSchema),\n        '404': { description: 'Not found' },\n    };\n    setOperation(paths, detailPath, 'PUT', {\n        summary: `Update ${modelName}`,\n        tags,\n        parameters: [buildPathParameter('id')],\n        requestBody: jsonRequestBody(updateSchema),\n        responses: updateResponses,\n    });\n    setOperation(paths, detailPath, 'PATCH', {\n        summary: `Update ${modelName}`,\n        tags,\n        parameters: [buildPathParameter('id')],\n        requestBody: jsonRequestBody(updateSchema),\n        responses: updateResponses,\n    });\n    setOperation(paths, detailPath, 'DELETE', {\n        summary: `Delete ${modelName}`,\n        tags,\n        parameters: [buildPathParameter('id')],\n        responses: {\n            '204': { description: 'Deleted' },\n            '404': { description: 'Not found' },\n        },\n    });\n\n    for (const action of metadata.actions) {\n        const actionPath =\n            action.scope === 'detail' ? joinPath(detailPath, action.path) : joinPath(collectionPath, action.path);\n        const baseOperation: OperationObject = {\n            summary: titleize(action.name),\n            tags,\n            ...(action.scope === 'detail' ? { parameters: [buildPathParameter('id')] } : {}),\n            responses: {\n                '200': { description: 'Successful response' },\n            },\n        };\n\n        const override = descriptor.actions?.[action.name];\n        for (const method of action.methods) {\n            setOperation(paths, actionPath, method, withOverride(baseOperation, override, tags));\n        }\n    }\n}\n\nfunction registerGenericDescriptor(\n    paths: Record<string, PathItemObject>,\n    schemas: Record<string, SchemaObject>,\n    descriptor: OpenAPIGenericAPIViewDescriptor\n): void {\n    if (!descriptor.collectionPath && !descriptor.detailPath) {\n        throw new Error('GenericAPIView OpenAPI descriptors require at least one of collectionPath or detailPath.');\n    }\n\n    const metadata = descriptor.resource.describeOpenAPI();\n    const modelName = metadata.model.metadata.name;\n    const tags = descriptor.tags ?? [modelName];\n    const readSchema = toSchema(metadata.outputSchema);\n    const writeSchema = toSchema(metadata.createSchema);\n    const updateSchema = toSchema(metadata.updateSchema);\n    const allowed = new Set(metadata.allowedMethods);\n\n    ensureModelSchema(schemas, metadata.model.metadata);\n\n    if (descriptor.collectionPath) {\n        const collectionPath = normalizePath(descriptor.collectionPath);\n        if (allowed.has('GET')) {\n            setOperation(\n                paths,\n                collectionPath,\n                'GET',\n                withOverride(\n                    {\n                        summary: `List ${modelName}s`,\n                        tags,\n                        parameters: buildListParameters(\n                            stringifyFields(metadata.searchFields),\n                            stringifyFields(metadata.orderingFields),\n                            metadata.usesDefaultOffsetPagination\n                        ),\n                        responses: {\n                            '200': jsonResponse(\n                                'Successful response',\n                                metadata.usesDefaultOffsetPagination ? paginatedResultsSchema(readSchema) : undefined\n                            ),\n                        },\n                    },\n                    descriptor.methods?.GET,\n                    tags\n                )\n            );\n        }\n\n        if (allowed.has('POST')) {\n            setOperation(\n                paths,\n                collectionPath,\n                'POST',\n                withOverride(\n                    {\n                        summary: `Create ${modelName}`,\n                        tags,\n                        requestBody: jsonRequestBody(writeSchema),\n                        responses: {\n                            '201': jsonResponse('Created', readSchema),\n                        },\n                    },\n                    descriptor.methods?.POST,\n                    tags\n                )\n            );\n        }\n    }\n\n    if (descriptor.detailPath) {\n        const detailPath = normalizePath(descriptor.detailPath);\n        validateGenericDetailPath(detailPath, metadata.lookupParam);\n        const detailParameters = [buildPathParameter(metadata.lookupParam)];\n\n        if (allowed.has('GET')) {\n            setOperation(\n                paths,\n                detailPath,\n                'GET',\n                withOverride(\n                    {\n                        summary: `Get ${modelName}`,\n                        tags,\n                        parameters: detailParameters,\n                        responses: {\n                            '200': jsonResponse('Successful response', readSchema),\n                            '404': { description: 'Not found' },\n                        },\n                    },\n                    descriptor.methods?.GET,\n                    tags\n                )\n            );\n        }\n\n        if (allowed.has('PUT')) {\n            setOperation(\n                paths,\n                detailPath,\n                'PUT',\n                withOverride(\n                    {\n                        summary: `Update ${modelName}`,\n                        tags,\n                        parameters: detailParameters,\n                        requestBody: jsonRequestBody(updateSchema),\n                        responses: {\n                            '200': jsonResponse('Updated', readSchema),\n                            '404': { description: 'Not found' },\n                        },\n                    },\n                    descriptor.methods?.PUT,\n                    tags\n                )\n            );\n        }\n\n        if (allowed.has('PATCH')) {\n            setOperation(\n                paths,\n                detailPath,\n                'PATCH',\n                withOverride(\n                    {\n                        summary: `Update ${modelName}`,\n                        tags,\n                        parameters: detailParameters,\n                        requestBody: jsonRequestBody(updateSchema),\n                        responses: {\n                            '200': jsonResponse('Updated', readSchema),\n                            '404': { description: 'Not found' },\n                        },\n                    },\n                    descriptor.methods?.PATCH,\n                    tags\n                )\n            );\n        }\n\n        if (allowed.has('DELETE')) {\n            setOperation(\n                paths,\n                detailPath,\n                'DELETE',\n                withOverride(\n                    {\n                        summary: `Delete ${modelName}`,\n                        tags,\n                        parameters: detailParameters,\n                        responses: {\n                            '204': { description: 'Deleted' },\n                            '404': { description: 'Not found' },\n                        },\n                    },\n                    descriptor.methods?.DELETE,\n                    tags\n                )\n            );\n        }\n    }\n}\n\nfunction registerAPIViewDescriptor(paths: Record<string, PathItemObject>, descriptor: OpenAPIAPIViewDescriptor): void {\n    const path = normalizePath(descriptor.path);\n    const allowed = new Set(descriptor.resource.getAllowedMethods());\n    const methods = Object.entries(descriptor.methods) as Array<[HttpMethod, OpenAPIOperationOverride]>;\n\n    for (const [method, override] of methods) {\n        if (!allowed.has(method)) {\n            throw new Error(\n                `APIView method '${method}' is not implemented on ${descriptor.resource.constructor.name}.`\n            );\n        }\n\n        setOperation(\n            paths,\n            path,\n            method,\n            withOverride(\n                {\n                    summary:\n                        `${method} ${titleize(descriptor.resource.constructor.name.replace(/APIView$/, ''))}`.trim(),\n                    responses: {\n                        [(override.responseStatus ?? '200') as string]: jsonResponse(\n                            override.responseDescription ?? 'Successful response',\n                            override.responseSchema ? toSchema(override.responseSchema) : undefined\n                        ),\n                    },\n                },\n                override,\n                descriptor.tags ?? [descriptor.resource.constructor.name.replace(/APIView$/, '') || 'APIView']\n            )\n        );\n    }\n}\n\n/**\n * Build an OpenAPI 3.1 document from Tango resource configuration.\n */\nexport function generateOpenAPISpec(config: OpenAPIGeneratorConfig): OpenAPISpec {\n    const paths: Record<string, PathItemObject> = {};\n    const schemas: Record<string, SchemaObject> = {};\n\n    for (const resource of config.resources ?? []) {\n        registerDescriptor(paths, schemas, resource);\n    }\n\n    return {\n        openapi: '3.1.0',\n        info: {\n            title: config.title,\n            version: config.version,\n            description: config.description,\n        },\n        servers: config.servers,\n        paths,\n        components: {\n            schemas,\n        },\n    };\n}\n\nfunction registerDescriptor(\n    paths: Record<string, PathItemObject>,\n    schemas: Record<string, SchemaObject>,\n    descriptor: OpenAPIResourceDescriptor\n): void {\n    if (descriptor.kind === 'viewset') {\n        registerViewSetDescriptor(paths, schemas, descriptor);\n        return;\n    }\n\n    if (descriptor.kind === 'generic') {\n        registerGenericDescriptor(paths, schemas, descriptor);\n        return;\n    }\n\n    registerAPIViewDescriptor(paths, descriptor);\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { generateOpenAPISpec } from './generateOpenAPISpec';\n","/**\n * Domain boundary barrel: exposes namespaced exports for Django-style drill-down\n * imports and curated flat exports for TS-native ergonomics.\n */\n\nexport * as spec from './spec/index';\nexport { generateOpenAPISpec } from './spec/index';\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -5,7 +5,7 @@
 export * as domain from './domain/index';
 export * as generators from './generators/index';
 export * as mappers from './mappers/index';
-export { VERSION as version } from './version';
-export type { OpenAPIGeneratorConfig, OpenAPIModel, OpenAPIModelFieldMeta, OpenAPIOptions, OpenAPISpec, ViewSetLike, } from './domain/index';
+export type { OpenAPIAPIViewDescriptor, OpenAPIGeneratorConfig, OpenAPIModel, OpenAPIModelFieldMeta, OpenAPIOptions, OpenAPIOperationOverride, OpenAPIResponseOverride, OpenAPIResourceDescriptor, OpenAPISchemaInput, OpenAPISpec, OpenAPIGenericAPIViewDescriptor, OpenAPIViewSetDescriptor, } from './domain/index';
+export { describeAPIView, describeGenericAPIView, describeViewSet } from './domain/index';
 export { generateOpenAPISpec } from './generators/index';
-export { generateSchemaFromModel, mapTypeToOpenAPI } from './mappers/index';
+export { generateSchemaFromModel, generateSchemaFromZod, mapTypeToOpenAPI } from './mappers/index';

package/dist/index.js

@@ -1,11 +1,6 @@
-import { generateSchemaFromModel, mapTypeToOpenAPI } from "./schema-DVxdID48.js";
-import { domain_exports } from "./domain-Cufz6y1q.js";
-import { generateOpenAPISpec, generators_exports } from "./generators-Bvwyyja4.js";
-import { mappers_exports } from "./mappers-CIfnOwl2.js";
+import { describeAPIView, describeGenericAPIView, describeViewSet, domain_exports } from "./domain-B-7sApJT.js";
+import { generateSchemaFromModel, generateSchemaFromZod, mapTypeToOpenAPI } from "./schema-D3ybOrpr.js";
+import { generateOpenAPISpec, generators_exports } from "./generators-JMALItMS.js";
+import { mappers_exports } from "./mappers-bmN95TGV.js";
 
-//#region src/version.ts
-const VERSION = "0.1.0";
-
-//#endregion
-export { domain_exports as domain, generateOpenAPISpec, generateSchemaFromModel, generators_exports as generators, mapTypeToOpenAPI, mappers_exports as mappers, VERSION as version };
-//# sourceMappingURL=index.js.map
+export { describeAPIView, describeGenericAPIView, describeViewSet, domain_exports as domain, generateOpenAPISpec, generateSchemaFromModel, generateSchemaFromZod, generators_exports as generators, mapTypeToOpenAPI, mappers_exports as mappers };

package/dist/mappers/index.d.ts

@@ -3,4 +3,4 @@
  * imports and curated flat exports for TS-native ergonomics.
  */
 export * as schema from './schema/index';
-export { generateSchemaFromModel, mapTypeToOpenAPI } from './schema/index';
+export { generateSchemaFromModel, generateSchemaFromZod, mapTypeToOpenAPI } from './schema/index';

package/dist/mappers/index.js

@@ -1,4 +1,4 @@
-import { generateSchemaFromModel, mapTypeToOpenAPI, schema_exports } from "../schema-DVxdID48.js";
-import "../mappers-CIfnOwl2.js";
+import { generateSchemaFromModel, generateSchemaFromZod, mapTypeToOpenAPI, schema_exports } from "../schema-D3ybOrpr.js";
+import "../mappers-bmN95TGV.js";
 
-export { generateSchemaFromModel, mapTypeToOpenAPI, schema_exports as schema };
+export { generateSchemaFromModel, generateSchemaFromZod, mapTypeToOpenAPI, schema_exports as schema };

package/dist/mappers/schema/generateSchemaFromModel.d.ts

@@ -1,2 +1,5 @@
 import type { OpenAPIModel, SchemaObject } from '../../domain';
+/**
+ * Derive an OpenAPI schema object from Tango model metadata.
+ */
 export declare function generateSchemaFromModel(model: OpenAPIModel): SchemaObject;

package/dist/mappers/schema/generateSchemaFromZod.d.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+import type { SchemaObject } from '../../domain';
+/**
+ * Derive an OpenAPI-compatible schema object from a Zod schema.
+ */
+export declare function generateSchemaFromZod(schema: z.ZodType): SchemaObject;

package/dist/mappers/schema/index.d.ts

@@ -2,4 +2,5 @@
  * Domain boundary barrel: centralizes this subdomain's public contract.
  */
 export { generateSchemaFromModel } from './generateSchemaFromModel';
+export { generateSchemaFromZod } from './generateSchemaFromZod';
 export { mapTypeToOpenAPI } from './mapTypeToOpenAPI';

package/dist/mappers/schema/mapTypeToOpenAPI.d.ts

@@ -1 +1,4 @@
+/**
+ * Map Tango field types to OpenAPI scalar/object type names.
+ */
 export declare function mapTypeToOpenAPI(type: string): string;

package/dist/mappers-bmN95TGV.js

@@ -0,0 +1,15 @@
+import { __export } from "./chunk-BkvOhyD0.js";
+import { generateSchemaFromModel, generateSchemaFromZod, mapTypeToOpenAPI, schema_exports } from "./schema-D3ybOrpr.js";
+
+//#region src/mappers/index.ts
+var mappers_exports = {};
+__export(mappers_exports, {
+	generateSchemaFromModel: () => generateSchemaFromModel,
+	generateSchemaFromZod: () => generateSchemaFromZod,
+	mapTypeToOpenAPI: () => mapTypeToOpenAPI,
+	schema: () => schema_exports
+});
+
+//#endregion
+export { mappers_exports };
+//# sourceMappingURL=mappers-bmN95TGV.js.map

package/dist/{mappers-CIfnOwl2.js.map → mappers-bmN95TGV.js.map}

@@ -1 +1 @@
-{"version":3,"file":"mappers-CIfnOwl2.js","names":[],"sources":["../src/mappers/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: exposes namespaced exports for Django-style drill-down\n * imports and curated flat exports for TS-native ergonomics.\n */\n\nexport * as schema from './schema/index';\nexport { generateSchemaFromModel, mapTypeToOpenAPI } from './schema/index';\n"],"mappings":""}
+{"version":3,"file":"mappers-bmN95TGV.js","names":[],"sources":["../src/mappers/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: exposes namespaced exports for Django-style drill-down\n * imports and curated flat exports for TS-native ergonomics.\n */\n\nexport * as schema from './schema/index';\nexport { generateSchemaFromModel, generateSchemaFromZod, mapTypeToOpenAPI } from './schema/index';\n"],"mappings":""}

package/dist/{schema-DVxdID48.js → schema-D3ybOrpr.js}

@@ -1,14 +1,6 @@
+import { __export } from "./chunk-BkvOhyD0.js";
+import { z } from "zod";
 
-//#region rolldown:runtime
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-};
-
-//#endregion
 //#region src/mappers/schema/mapTypeToOpenAPI.ts
 function mapTypeToOpenAPI(type) {
 	const typeMap = {
@@ -47,14 +39,29 @@ function generateSchemaFromModel(model) {
 	};
 }
 
+//#endregion
+//#region src/mappers/schema/generateSchemaFromZod.ts
+function stripDialect(schema) {
+	if (Array.isArray(schema)) return schema.map((entry) => stripDialect(entry));
+	if (schema && typeof schema === "object") {
+		const input = schema;
+		return Object.fromEntries(Object.entries(input).filter(([key]) => key !== "$schema").map(([key, value]) => [key, stripDialect(value)]));
+	}
+	return schema;
+}
+function generateSchemaFromZod(schema) {
+	return stripDialect(z.toJSONSchema(schema));
+}
+
 //#endregion
 //#region src/mappers/schema/index.ts
 var schema_exports = {};
 __export(schema_exports, {
 	generateSchemaFromModel: () => generateSchemaFromModel,
+	generateSchemaFromZod: () => generateSchemaFromZod,
 	mapTypeToOpenAPI: () => mapTypeToOpenAPI
 });
 
 //#endregion
-export { __export, generateSchemaFromModel, mapTypeToOpenAPI, schema_exports };
-//# sourceMappingURL=schema-DVxdID48.js.map
+export { generateSchemaFromModel, generateSchemaFromZod, mapTypeToOpenAPI, schema_exports };
+//# sourceMappingURL=schema-D3ybOrpr.js.map

package/dist/schema-D3ybOrpr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-D3ybOrpr.js","names":["type: string","typeMap: Record<string, string>","model: OpenAPIModel","properties: Record<string, SchemaObject>","required: string[]","schema: unknown","schema: z.ZodType"],"sources":["../src/mappers/schema/mapTypeToOpenAPI.ts","../src/mappers/schema/generateSchemaFromModel.ts","../src/mappers/schema/generateSchemaFromZod.ts","../src/mappers/schema/index.ts"],"sourcesContent":["/**\n * Map Tango field types to OpenAPI scalar/object type names.\n */\nexport function mapTypeToOpenAPI(type: string): string {\n    const typeMap: Record<string, string> = {\n        string: 'string',\n        number: 'number',\n        boolean: 'boolean',\n        date: 'string',\n        serial: 'integer',\n        int: 'integer',\n        bigint: 'integer',\n        text: 'string',\n        bool: 'boolean',\n        uuid: 'string',\n        jsonb: 'object',\n        timestamptz: 'string',\n    };\n\n    return typeMap[type] || 'string';\n}\n","import type { OpenAPIModel, SchemaObject } from '../../domain';\nimport { mapTypeToOpenAPI } from './mapTypeToOpenAPI';\n\n/**\n * Derive an OpenAPI schema object from Tango model metadata.\n */\nexport function generateSchemaFromModel(model: OpenAPIModel): SchemaObject {\n    const properties: Record<string, SchemaObject> = {};\n    const required: string[] = [];\n\n    for (const [name, meta] of Object.entries(model.fields)) {\n        properties[name] = {\n            type: mapTypeToOpenAPI(meta.type),\n            description: meta.description,\n        };\n\n        if (!meta.nullable && meta.default === undefined && !meta.primaryKey) {\n            required.push(name);\n        }\n    }\n\n    return {\n        type: 'object',\n        properties,\n        required: required.length > 0 ? required : undefined,\n    };\n}\n","import { z } from 'zod';\nimport type { SchemaObject } from '../../domain';\n\nfunction stripDialect(schema: unknown): unknown {\n    if (Array.isArray(schema)) {\n        return schema.map((entry) => stripDialect(entry));\n    }\n\n    if (schema && typeof schema === 'object') {\n        const input = schema as Record<string, unknown>;\n        return Object.fromEntries(\n            Object.entries(input)\n                .filter(([key]) => key !== '$schema')\n                .map(([key, value]) => [key, stripDialect(value)])\n        );\n    }\n\n    return schema;\n}\n\n/**\n * Derive an OpenAPI-compatible schema object from a Zod schema.\n */\nexport function generateSchemaFromZod(schema: z.ZodType): SchemaObject {\n    return stripDialect(z.toJSONSchema(schema)) as SchemaObject;\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { generateSchemaFromModel } from './generateSchemaFromModel';\nexport { generateSchemaFromZod } from './generateSchemaFromZod';\nexport { mapTypeToOpenAPI } from './mapTypeToOpenAPI';\n"],"mappings":";;;;AAGO,SAAS,iBAAiBA,MAAsB;CACnD,MAAMC,UAAkC;EACpC,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,MAAM;EACN,QAAQ;EACR,KAAK;EACL,QAAQ;EACR,MAAM;EACN,MAAM;EACN,MAAM;EACN,OAAO;EACP,aAAa;CAChB;AAED,QAAO,QAAQ,SAAS;AAC3B;;;;ACdM,SAAS,wBAAwBC,OAAmC;CACvE,MAAMC,aAA2C,CAAE;CACnD,MAAMC,WAAqB,CAAE;AAE7B,MAAK,MAAM,CAAC,MAAM,KAAK,IAAI,OAAO,QAAQ,MAAM,OAAO,EAAE;AACrD,aAAW,QAAQ;GACf,MAAM,iBAAiB,KAAK,KAAK;GACjC,aAAa,KAAK;EACrB;AAED,OAAK,KAAK,YAAY,KAAK,YAAY,cAAc,KAAK,WACtD,UAAS,KAAK,KAAK;CAE1B;AAED,QAAO;EACH,MAAM;EACN;EACA,UAAU,SAAS,SAAS,IAAI,WAAW;CAC9C;AACJ;;;;ACvBD,SAAS,aAAaC,QAA0B;AAC5C,KAAI,MAAM,QAAQ,OAAO,CACrB,QAAO,OAAO,IAAI,CAAC,UAAU,aAAa,MAAM,CAAC;AAGrD,KAAI,iBAAiB,WAAW,UAAU;EACtC,MAAM,QAAQ;AACd,SAAO,OAAO,YACV,OAAO,QAAQ,MAAM,CAChB,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,UAAU,CACpC,IAAI,CAAC,CAAC,KAAK,MAAM,KAAK,CAAC,KAAK,aAAa,MAAM,AAAC,EAAC,CACzD;CACJ;AAED,QAAO;AACV;AAKM,SAAS,sBAAsBC,QAAiC;AACnE,QAAO,aAAa,EAAE,aAAa,OAAO,CAAC;AAC9C"}