@opsydyn/elysia-spectral 1.5.0 → 1.5.1

package/dist/presets-CCfU_diN.mjs

@@ -0,0 +1,132 @@
+import { t as __exportAll } from "./rolldown-runtime-wcPFST8Q.mjs";
+import { t as recommended } from "./recommended-DgrTqq-3.mjs";
+//#region src/presets/server.ts
+const operationSelector$1 = "$.paths[*][get,put,post,delete,options,head,patch,trace]";
+/**
+* Production API quality preset. Suitable as a CI gate for teams shipping
+* public or internal APIs where contract quality matters.
+*
+* Tightens recommended:
+* - elysia-operation-summary and elysia-operation-tags escalated to error
+* - operation-description, operation-operationId, operation-success-response at warn
+* - oas3-api-servers at warn (servers should be declared in production specs)
+*/
+const server = {
+	extends: [["spectral:oas", "recommended"]],
+	rules: {
+		"oas3-api-servers": "warn",
+		"info-contact": "off",
+		"elysia-operation-summary": {
+			description: "Operations should define a summary for generated docs and clients.",
+			severity: "error",
+			given: operationSelector$1,
+			then: {
+				field: "summary",
+				function: "truthy"
+			}
+		},
+		"elysia-operation-tags": {
+			description: "Operations should declare at least one tag for grouping and downstream tooling.",
+			severity: "error",
+			given: operationSelector$1,
+			then: {
+				field: "tags",
+				function: "schema",
+				functionOptions: { schema: {
+					type: "array",
+					minItems: 1
+				} }
+			}
+		},
+		"operation-description": "warn",
+		"operation-operationId": "warn",
+		"operation-success-response": "warn"
+	}
+};
+//#endregion
+//#region src/presets/strict.ts
+const operationSelector = "$.paths[*][get,put,post,delete,options,head,patch,trace]";
+const isRecord = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+/**
+* Checks that all 4xx/5xx responses declare application/problem+json as
+* their content type, conforming to RFC 9457 Problem Details for HTTP APIs.
+*/
+const checkProblemDetails = (operation) => {
+	if (!isRecord(operation) || !isRecord(operation.responses)) return;
+	const results = [];
+	for (const [statusCode, response] of Object.entries(operation.responses)) {
+		const code = Number(statusCode);
+		if (!Number.isFinite(code) || code < 400) continue;
+		if (!isRecord(response)) continue;
+		const content = response.content;
+		if (!isRecord(content) || !("application/problem+json" in content)) results.push({
+			message: `${statusCode} error response should use "application/problem+json" content type (RFC 9457 Problem Details).`,
+			path: ["responses", statusCode]
+		});
+	}
+	return results.length > 0 ? results : void 0;
+};
+/**
+* Full API governance preset. Suitable for teams with formal API governance
+* requirements, public API programs, or downstream client generation pipelines.
+*
+* Tightens server:
+* - All elysia rules and operation metadata rules escalated to error
+* - info-contact at warn (API ownership should be declared)
+* - oas3-api-servers at error (server declaration is required)
+* - rfc9457-problem-details at warn (error responses should use Problem Details)
+*/
+const strict = {
+	extends: [["spectral:oas", "recommended"]],
+	rules: {
+		"oas3-api-servers": "error",
+		"info-contact": "warn",
+		"elysia-operation-summary": {
+			description: "Operations should define a summary for generated docs and clients.",
+			severity: "error",
+			given: operationSelector,
+			then: {
+				field: "summary",
+				function: "truthy"
+			}
+		},
+		"elysia-operation-tags": {
+			description: "Operations should declare at least one tag for grouping and downstream tooling.",
+			severity: "error",
+			given: operationSelector,
+			then: {
+				field: "tags",
+				function: "schema",
+				functionOptions: { schema: {
+					type: "array",
+					minItems: 1
+				} }
+			}
+		},
+		"operation-description": "error",
+		"operation-operationId": "error",
+		"operation-success-response": "error",
+		"rfc9457-problem-details": {
+			description: "Error responses (4xx, 5xx) should use RFC 9457 Problem Details (application/problem+json).",
+			message: "{{error}}",
+			severity: "warn",
+			given: operationSelector,
+			then: { function: checkProblemDetails }
+		}
+	}
+};
+//#endregion
+//#region src/presets/index.ts
+var presets_exports = /* @__PURE__ */ __exportAll({
+	presets: () => presets,
+	recommended: () => recommended,
+	server: () => server,
+	strict: () => strict
+});
+const presets = {
+	recommended,
+	server,
+	strict
+};
+//#endregion
+export { server as i, presets_exports as n, strict as r, presets as t };

package/dist/recommended-DgrTqq-3.mjs

@@ -0,0 +1,40 @@
+//#region src/presets/recommended.ts
+const operationSelector = "$.paths[*][get,put,post,delete,options,head,patch,trace]";
+/**
+* Baseline quality preset. Equivalent to the package default ruleset.
+*
+* - Extends spectral:oas/recommended
+* - elysia-operation-summary and elysia-operation-tags at warn
+* - oas3-api-servers and info-contact disabled (local-dev friendly)
+*/
+const recommended = {
+	extends: [["spectral:oas", "recommended"]],
+	rules: {
+		"oas3-api-servers": "off",
+		"info-contact": "off",
+		"elysia-operation-summary": {
+			description: "Operations should define a summary for generated docs and clients.",
+			severity: "warn",
+			given: operationSelector,
+			then: {
+				field: "summary",
+				function: "truthy"
+			}
+		},
+		"elysia-operation-tags": {
+			description: "Operations should declare at least one tag for grouping and downstream tooling.",
+			severity: "warn",
+			given: operationSelector,
+			then: {
+				field: "tags",
+				function: "schema",
+				functionOptions: { schema: {
+					type: "array",
+					minItems: 1
+				} }
+			}
+		}
+	}
+};
+//#endregion
+export { recommended as t };

package/dist/rolldown-runtime-wcPFST8Q.mjs

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll as t };

package/dist/ruleset-load-error-CogUOC7W.mjs

@@ -0,0 +1,10 @@
+//#region src/core/ruleset-load-error.ts
+var RulesetLoadError = class extends Error {
+	constructor(message, options) {
+		super(message);
+		this.name = "RulesetLoadError";
+		if (options?.cause !== void 0) this.cause = options.cause;
+	}
+};
+//#endregion
+export { RulesetLoadError as t };