@seshuk/payload-plugin-openapi 0.2.2 → 1.0.0-beta.1

package/dist/server/spec/components.js

@@ -0,0 +1,265 @@
+import { refTo } from "./names.js";
+const nullableType = (type) => ({ type: [type, "null"] });
+const jsonResponse = (description, schema) => ({
+	description,
+	content: { "application/json": { schema } }
+});
+const jsonOk = (description, schema) => ({ "200": jsonResponse(description, schema) });
+const jsonBody = (schema) => ({
+	required: true,
+	content: { "application/json": { schema } }
+});
+const messageResponse = (description) => jsonOk(description, {
+	type: "object",
+	properties: { message: { type: "string" } }
+});
+const allowed = () => ({ oneOf: [{
+	type: "boolean",
+	enum: [true]
+}, {
+	type: "object",
+	properties: {
+		permission: { type: "boolean" },
+		where: {
+			type: "object",
+			additionalProperties: true
+		}
+	},
+	required: ["permission"]
+}] });
+const docAccessOperation = ({ tag, operationId, operations, bodyRef, errors, t }) => ({
+	tags: [tag],
+	operationId,
+	requestBody: {
+		description: t("docAccessBody"),
+		content: { "application/json": { schema: bodyRef } }
+	},
+	responses: {
+		...jsonOk(t("docAccess"), {
+			type: "object",
+			properties: {
+				...Object.fromEntries(operations.map((op) => [op, allowed()])),
+				fields: { oneOf: [{
+					type: "boolean",
+					enum: [true]
+				}, {
+					type: "object",
+					additionalProperties: true
+				}] }
+			}
+		}),
+		...errorResponses(errors, t)
+	}
+});
+const validateOperation = ({ tag, operationId, parameters, requestBody, errors, security, t }) => ({
+	tags: [tag],
+	operationId,
+	parameters,
+	requestBody: {
+		...requestBody,
+		description: [requestBody.description, t("validateBody")].filter(Boolean).join(" ")
+	},
+	responses: {
+		...jsonOk(t("validateResult"), {
+			type: "object",
+			properties: {
+				valid: { type: "boolean" },
+				errors: {
+					type: "array",
+					items: {
+						type: "object",
+						properties: {
+							message: { type: "string" },
+							path: { type: "string" },
+							label: { oneOf: [{ type: "string" }, {
+								type: "object",
+								additionalProperties: { type: "string" }
+							}] },
+							locale: { type: "string" },
+							tableName: { type: "string" }
+						},
+						required: ["message", "path"]
+					}
+				}
+			},
+			required: ["valid", "errors"]
+		}),
+		...errorResponses(errors, t)
+	},
+	security
+});
+const ERROR_SCHEMA_NAME = "ErrorResponse";
+const ERROR_KEYS = {
+	"400": "error400",
+	"401": "error401",
+	"403": "error403",
+	"404": "error404",
+	"500": "error500"
+};
+const ERRORS = {
+	list: [
+		"400",
+		"403",
+		"500"
+	],
+	read: [
+		"403",
+		"404",
+		"500"
+	],
+	create: [
+		"400",
+		"403",
+		"500"
+	],
+	update: [
+		"400",
+		"403",
+		"404",
+		"500"
+	],
+	delete: [
+		"403",
+		"404",
+		"500"
+	],
+	globalRead: ["403", "500"],
+	globalUpdate: [
+		"400",
+		"403",
+		"500"
+	],
+	login: [
+		"400",
+		"401",
+		"403",
+		"500"
+	],
+	session: ["401", "500"],
+	authAction: [
+		"400",
+		"403",
+		"500"
+	],
+	versionList: [
+		"400",
+		"403",
+		"404",
+		"500"
+	],
+	versionRead: [
+		"403",
+		"404",
+		"500"
+	],
+	versionRestore: [
+		"403",
+		"404",
+		"500"
+	]
+};
+const buildErrorResponseSchema = () => ({
+	type: "object",
+	properties: { errors: {
+		type: "array",
+		items: {
+			type: "object",
+			properties: {
+				message: { type: "string" },
+				name: { type: "string" },
+				field: { type: "string" },
+				data: {
+					type: "object",
+					additionalProperties: true
+				}
+			},
+			required: ["message"]
+		}
+	} },
+	required: ["errors"]
+});
+const errorRef = { $ref: refTo(ERROR_SCHEMA_NAME) };
+const errorContent = (description) => ({
+	description,
+	content: { "application/json": { schema: errorRef } }
+});
+const errorResponses = (codes, t) => {
+	const responses = {};
+	for (const code of codes) responses[code] = errorContent(t(ERROR_KEYS[code]));
+	return responses;
+};
+const buildListEnvelopeSchema = (base) => ({
+	type: "object",
+	properties: {
+		docs: {
+			type: "array",
+			items: { $ref: refTo(base) }
+		},
+		totalDocs: { type: "integer" },
+		limit: { type: "integer" },
+		totalPages: { type: "integer" },
+		page: { type: "integer" },
+		pagingCounter: { type: "integer" },
+		hasPrevPage: { type: "boolean" },
+		hasNextPage: { type: "boolean" },
+		prevPage: nullableType("integer"),
+		nextPage: nullableType("integer")
+	},
+	required: [
+		"docs",
+		"totalDocs",
+		"limit",
+		"totalPages",
+		"page"
+	]
+});
+const uploadRequestBody = ({ bodyRef, fileRequired, t }) => {
+	const fieldsSchemaName = bodyRef.$ref.split("/").pop() ?? "the document";
+	return {
+		required: fileRequired,
+		description: t("uploadBody"),
+		content: {
+			"multipart/form-data": {
+				schema: {
+					type: "object",
+					properties: {
+						file: {
+							type: "string",
+							format: "binary",
+							description: t("uploadFile")
+						},
+						_payload: {
+							allOf: [bodyRef],
+							description: t("uploadPayloadField", { schema: fieldsSchemaName })
+						}
+					},
+					...fileRequired ? { required: ["file"] } : {}
+				},
+				encoding: {
+					file: { contentType: "application/octet-stream" },
+					_payload: { contentType: "application/json" }
+				}
+			},
+			"application/json": { schema: bodyRef }
+		}
+	};
+};
+const SECURITY_SCHEME_NAME = "PayloadToken";
+const INTERACTIVE_SCHEME_NAME = "PayloadLogin";
+const interactiveSecurityScheme = ({ tokenUrl, t }) => ({
+	type: "oauth2",
+	description: t("securityInteractive"),
+	flows: { password: {
+		tokenUrl,
+		scopes: {}
+	} }
+});
+const securityScheme = ({ cookiePrefix, t }) => ({
+	type: "http",
+	scheme: "bearer",
+	bearerFormat: "JWT",
+	description: t("securityBearer", { cookiePrefix })
+});
+export { ERRORS, ERROR_SCHEMA_NAME, INTERACTIVE_SCHEME_NAME, SECURITY_SCHEME_NAME, buildErrorResponseSchema, buildListEnvelopeSchema, docAccessOperation, errorResponses, interactiveSecurityScheme, jsonBody, jsonOk, jsonResponse, messageResponse, nullableType, securityScheme, uploadRequestBody, validateOperation };
+
+//# sourceMappingURL=components.js.map

package/dist/server/spec/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","names":[],"sources":["../../../src/server/spec/components.ts"],"sourcesContent":["import type {\n  OperationObject,\n  ParameterObject,\n  ReferenceObject,\n  RequestBodyObject,\n  ResponseObject,\n  ResponsesObject,\n  SchemaObject,\n  SecurityRequirementObject,\n  SecuritySchemeObject,\n} from '@scalar/openapi-types/3.2'\n\nimport type { Translate } from '@/shared/translations/types.js'\n\nimport { refTo } from './names.js'\n\ntype SchemaOrRef = SchemaObject | ReferenceObject\n\nexport const nullableType = (type: 'integer' | 'string' | 'number' | 'boolean'): SchemaObject => ({\n  type: [type, 'null'],\n})\n\nexport const jsonResponse = (description: string, schema: SchemaOrRef): ResponseObject => ({\n  description,\n  content: { 'application/json': { schema } },\n})\n\nexport const jsonOk = (description: string, schema: SchemaOrRef): ResponsesObject => ({\n  '200': jsonResponse(description, schema),\n})\n\nexport const jsonBody = (schema: SchemaOrRef): RequestBodyObject => ({\n  required: true,\n  content: { 'application/json': { schema } },\n})\n\nexport const messageResponse = (description: string): ResponsesObject =>\n  jsonOk(description, { type: 'object', properties: { message: { type: 'string' } } })\n\nexport type ErrorCode = '400' | '401' | '403' | '404' | '500'\n\nconst allowed = (): SchemaObject => ({\n  oneOf: [\n    { type: 'boolean', enum: [true] },\n    {\n      type: 'object',\n      properties: { permission: { type: 'boolean' }, where: { type: 'object', additionalProperties: true } },\n      required: ['permission'],\n    },\n  ],\n})\n\nexport const docAccessOperation = ({\n  tag,\n  operationId,\n  operations,\n  bodyRef,\n  errors,\n  t,\n}: {\n  tag: string\n  operationId: string\n  operations: string[]\n  bodyRef: ReferenceObject\n  errors: ErrorCode[]\n  t: Translate\n}): OperationObject => ({\n  tags: [tag],\n  operationId,\n  requestBody: { description: t('docAccessBody'), content: { 'application/json': { schema: bodyRef } } },\n  responses: {\n    ...jsonOk(t('docAccess'), {\n      type: 'object',\n      properties: {\n        ...Object.fromEntries(operations.map((op) => [op, allowed()])),\n        fields: {\n          oneOf: [\n            { type: 'boolean', enum: [true] },\n            { type: 'object', additionalProperties: true },\n          ],\n        },\n      },\n    }),\n    ...errorResponses(errors, t),\n  },\n})\n\nexport const validateOperation = ({\n  tag,\n  operationId,\n  parameters,\n  requestBody,\n  errors,\n  security,\n  t,\n}: {\n  tag: string\n  operationId: string\n  parameters: ParameterObject[]\n  requestBody: RequestBodyObject\n  errors: ErrorCode[]\n  security?: SecurityRequirementObject[]\n  t: Translate\n}): OperationObject => ({\n  tags: [tag],\n  operationId,\n  parameters,\n  requestBody: {\n    ...requestBody,\n    description: [requestBody.description, t('validateBody')].filter(Boolean).join(' '),\n  },\n  responses: {\n    ...jsonOk(t('validateResult'), {\n      type: 'object',\n      properties: {\n        valid: { type: 'boolean' },\n        errors: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              message: { type: 'string' },\n              path: { type: 'string' },\n              label: { oneOf: [{ type: 'string' }, { type: 'object', additionalProperties: { type: 'string' } }] },\n              locale: { type: 'string' },\n              tableName: { type: 'string' },\n            },\n            required: ['message', 'path'],\n          },\n        },\n      },\n      required: ['valid', 'errors'],\n    }),\n    ...errorResponses(errors, t),\n  },\n  security,\n})\n\nexport const ERROR_SCHEMA_NAME = 'ErrorResponse'\n\nconst ERROR_KEYS = {\n  '400': 'error400',\n  '401': 'error401',\n  '403': 'error403',\n  '404': 'error404',\n  '500': 'error500',\n} as const\n\nexport const ERRORS = {\n  list: ['400', '403', '500'] as ErrorCode[],\n  read: ['403', '404', '500'] as ErrorCode[],\n  create: ['400', '403', '500'] as ErrorCode[],\n  update: ['400', '403', '404', '500'] as ErrorCode[],\n  delete: ['403', '404', '500'] as ErrorCode[],\n  globalRead: ['403', '500'] as ErrorCode[],\n  globalUpdate: ['400', '403', '500'] as ErrorCode[],\n  login: ['400', '401', '403', '500'] as ErrorCode[],\n  session: ['401', '500'] as ErrorCode[],\n  authAction: ['400', '403', '500'] as ErrorCode[],\n  versionList: ['400', '403', '404', '500'] as ErrorCode[],\n  versionRead: ['403', '404', '500'] as ErrorCode[],\n  versionRestore: ['403', '404', '500'] as ErrorCode[],\n} as const\n\nexport const buildErrorResponseSchema = (): SchemaObject => ({\n  type: 'object',\n  properties: {\n    errors: {\n      type: 'array',\n      items: {\n        type: 'object',\n        properties: {\n          message: { type: 'string' },\n          name: { type: 'string' },\n          field: { type: 'string' },\n          data: { type: 'object', additionalProperties: true },\n        },\n        required: ['message'],\n      },\n    },\n  },\n  required: ['errors'],\n})\n\nconst errorRef: ReferenceObject = { $ref: refTo(ERROR_SCHEMA_NAME) }\n\nconst errorContent = (description: string): ResponseObject => ({\n  description,\n  content: { 'application/json': { schema: errorRef } },\n})\n\nexport const errorResponses = (codes: ErrorCode[], t: Translate): ResponsesObject => {\n  const responses: ResponsesObject = {}\n  for (const code of codes) responses[code] = errorContent(t(ERROR_KEYS[code]))\n  return responses\n}\n\nexport const buildListEnvelopeSchema = (base: string): SchemaObject => ({\n  type: 'object',\n  properties: {\n    docs: { type: 'array', items: { $ref: refTo(base) } },\n    totalDocs: { type: 'integer' },\n    limit: { type: 'integer' },\n    totalPages: { type: 'integer' },\n    page: { type: 'integer' },\n    pagingCounter: { type: 'integer' },\n    hasPrevPage: { type: 'boolean' },\n    hasNextPage: { type: 'boolean' },\n    prevPage: nullableType('integer'),\n    nextPage: nullableType('integer'),\n  },\n  required: ['docs', 'totalDocs', 'limit', 'totalPages', 'page'],\n})\n\nexport const uploadRequestBody = ({\n  bodyRef,\n  fileRequired,\n  t,\n}: {\n  bodyRef: ReferenceObject\n  fileRequired: boolean\n  t: Translate\n}): RequestBodyObject => {\n  const fieldsSchemaName = bodyRef.$ref.split('/').pop() ?? 'the document'\n  return {\n    required: fileRequired,\n    description: t('uploadBody'),\n    content: {\n      'multipart/form-data': {\n        schema: {\n          type: 'object',\n          properties: {\n            file: {\n              type: 'string',\n              format: 'binary',\n              description: t('uploadFile'),\n            },\n            _payload: {\n              allOf: [bodyRef],\n              description: t('uploadPayloadField', { schema: fieldsSchemaName }),\n            },\n          },\n          ...(fileRequired ? { required: ['file'] } : {}),\n        },\n        encoding: {\n          file: { contentType: 'application/octet-stream' },\n          _payload: { contentType: 'application/json' },\n        },\n      },\n      'application/json': { schema: bodyRef },\n    },\n  }\n}\n\nexport const SECURITY_SCHEME_NAME = 'PayloadToken'\nexport const INTERACTIVE_SCHEME_NAME = 'PayloadLogin'\n\nexport const interactiveSecurityScheme = ({\n  tokenUrl,\n  t,\n}: {\n  tokenUrl: string\n  t: Translate\n}): SecuritySchemeObject => ({\n  type: 'oauth2',\n  description: t('securityInteractive'),\n  flows: { password: { tokenUrl, scopes: {} } },\n})\n\nexport const securityScheme = ({ cookiePrefix, t }: { cookiePrefix: string; t: Translate }): SecuritySchemeObject => ({\n  type: 'http',\n  scheme: 'bearer',\n  bearerFormat: 'JWT',\n  description: t('securityBearer', { cookiePrefix }),\n})\n"],"mappings":"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"}

package/dist/{spec → server/spec}/downconvert.d.ts

@@ -1,3 +1,4 @@
-import type { Document } from '@scalar/openapi-types/3.2';
+import { Document } from "@scalar/openapi-types/3.2";
 export declare const toOpenApi31: (doc: Document) => Document;
 export declare const toOpenApi30: (doc: Document) => Document;
+//# sourceMappingURL=downconvert.d.ts.map

package/dist/server/spec/downconvert.js

@@ -0,0 +1,69 @@
+const NULL = "null";
+const UNSUPPORTED_KEYWORDS = [
+	"$schema",
+	"$id",
+	"$comment",
+	"unevaluatedProperties",
+	"patternProperties",
+	"propertyNames"
+];
+const isStringType = (type) => type === "string" || Array.isArray(type) && type.includes("string");
+const downconvertTo30 = (node) => {
+	if (Array.isArray(node)) return node.map(downconvertTo30);
+	if (!node || typeof node !== "object") return node;
+	const out = {};
+	for (const [key, value] of Object.entries(node)) out[key] = downconvertTo30(value);
+	if (isStringType(out.type) && out.contentMediaType === "application/octet-stream") {
+		if (out.format === void 0) out.format = "binary";
+		delete out.contentMediaType;
+	}
+	if (isStringType(out.type) && out.contentEncoding === "base64") {
+		if (out.format === void 0) out.format = "byte";
+		delete out.contentEncoding;
+	}
+	if (Array.isArray(out.type)) {
+		const types = out.type;
+		const nullable = types.includes(NULL);
+		const rest = types.filter((t) => t !== NULL);
+		if (rest.length === 1) {
+			out.type = rest[0];
+			if (nullable) out.nullable = true;
+		} else if (rest.length > 1) {
+			delete out.type;
+			const union = rest.map((type) => nullable ? {
+				type,
+				nullable: true
+			} : { type });
+			if (out.anyOf) out.allOf = [...out.allOf ?? [], { anyOf: union }];
+			else out.anyOf = union;
+		}
+	}
+	if ("const" in out) {
+		out.enum = [out.const];
+		delete out.const;
+	}
+	if (Array.isArray(out.examples)) {
+		const examples = out.examples;
+		if (examples.length > 0) out.example = examples[0];
+		if (examples.length > 1) out["x-examples"] = examples;
+		delete out.examples;
+	}
+	if (Array.isArray(out.required) && out.required.length === 0) delete out.required;
+	for (const keyword of UNSUPPORTED_KEYWORDS) delete out[keyword];
+	return out;
+};
+const toOpenApi31 = (doc) => ({
+	...doc,
+	openapi: "3.1.2",
+	tags: doc.tags?.map(({ kind: _kind, parent: _parent, summary: _summary, ...rest }) => rest)
+});
+const toOpenApi30 = (doc) => {
+	const converted = downconvertTo30(toOpenApi31(doc));
+	converted.openapi = "3.0.4";
+	delete converted.info.summary;
+	delete converted.info.license?.identifier;
+	return converted;
+};
+export { toOpenApi30, toOpenApi31 };
+
+//# sourceMappingURL=downconvert.js.map

package/dist/server/spec/downconvert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"downconvert.js","names":[],"sources":["../../../src/server/spec/downconvert.ts"],"sourcesContent":["import type { Document, TagObject } from '@scalar/openapi-types/3.2'\n\nconst NULL = 'null'\n\nconst UNSUPPORTED_KEYWORDS = [\n  '$schema',\n  '$id',\n  '$comment',\n  'unevaluatedProperties',\n  'patternProperties',\n  'propertyNames',\n]\n\nconst isStringType = (type: unknown): boolean => type === 'string' || (Array.isArray(type) && type.includes('string'))\n\nconst downconvertTo30 = (node: unknown): unknown => {\n  if (Array.isArray(node)) return node.map(downconvertTo30)\n  if (!node || typeof node !== 'object') return node\n\n  const out: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(node as Record<string, unknown>)) {\n    out[key] = downconvertTo30(value)\n  }\n\n  if (isStringType(out.type) && out.contentMediaType === 'application/octet-stream') {\n    if (out.format === undefined) out.format = 'binary'\n    delete out.contentMediaType\n  }\n  if (isStringType(out.type) && out.contentEncoding === 'base64') {\n    if (out.format === undefined) out.format = 'byte'\n    delete out.contentEncoding\n  }\n\n  if (Array.isArray(out.type)) {\n    const types = out.type as string[]\n    const nullable = types.includes(NULL)\n    const rest = types.filter((t) => t !== NULL)\n    if (rest.length === 1) {\n      out.type = rest[0]\n      if (nullable) out.nullable = true\n    } else if (rest.length > 1) {\n      delete out.type\n      const union = rest.map((type) => (nullable ? { type, nullable: true } : { type }))\n      if (out.anyOf) out.allOf = [...((out.allOf as unknown[]) ?? []), { anyOf: union }]\n      else out.anyOf = union\n    }\n  }\n\n  if ('const' in out) {\n    out.enum = [out.const]\n    delete out.const\n  }\n\n  if (Array.isArray(out.examples)) {\n    const examples = out.examples\n    if (examples.length > 0) out.example = examples[0]\n    if (examples.length > 1) out['x-examples'] = examples\n    delete out.examples\n  }\n\n  if (Array.isArray(out.required) && out.required.length === 0) delete out.required\n\n  for (const keyword of UNSUPPORTED_KEYWORDS) delete out[keyword]\n\n  return out\n}\n\nexport const toOpenApi31 = (doc: Document): Document => ({\n  ...doc,\n  openapi: '3.1.2',\n  tags: doc.tags?.map(({ kind: _kind, parent: _parent, summary: _summary, ...rest }: TagObject) => rest),\n})\n\nexport const toOpenApi30 = (doc: Document): Document => {\n  const converted = downconvertTo30(toOpenApi31(doc)) as Document\n  converted.openapi = '3.0.4'\n  delete converted.info.summary\n  delete converted.info.license?.identifier\n  return converted\n}\n"],"mappings":"AAEA,MAAM,OAAO;AAEb,MAAM,uBAAuB;CAC3B;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAM,gBAAgB,SAA2B,SAAS,YAAa,MAAM,QAAQ,IAAI,KAAK,KAAK,SAAS,QAAQ;AAEpH,MAAM,mBAAmB,SAA2B;CAClD,IAAI,MAAM,QAAQ,IAAI,GAAG,OAAO,KAAK,IAAI,eAAe;CACxD,IAAI,CAAC,QAAQ,OAAO,SAAS,UAAU,OAAO;CAE9C,MAAM,MAA+B,CAAC;CACtC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAA+B,GACvE,IAAI,OAAO,gBAAgB,KAAK;CAGlC,IAAI,aAAa,IAAI,IAAI,KAAK,IAAI,qBAAqB,4BAA4B;EACjF,IAAI,IAAI,WAAW,KAAA,GAAW,IAAI,SAAS;EAC3C,OAAO,IAAI;CACb;CACA,IAAI,aAAa,IAAI,IAAI,KAAK,IAAI,oBAAoB,UAAU;EAC9D,IAAI,IAAI,WAAW,KAAA,GAAW,IAAI,SAAS;EAC3C,OAAO,IAAI;CACb;CAEA,IAAI,MAAM,QAAQ,IAAI,IAAI,GAAG;EAC3B,MAAM,QAAQ,IAAI;EAClB,MAAM,WAAW,MAAM,SAAS,IAAI;EACpC,MAAM,OAAO,MAAM,QAAQ,MAAM,MAAM,IAAI;EAC3C,IAAI,KAAK,WAAW,GAAG;GACrB,IAAI,OAAO,KAAK;GAChB,IAAI,UAAU,IAAI,WAAW;EAC/B,OAAO,IAAI,KAAK,SAAS,GAAG;GAC1B,OAAO,IAAI;GACX,MAAM,QAAQ,KAAK,KAAK,SAAU,WAAW;IAAE;IAAM,UAAU;GAAK,IAAI,EAAE,KAAK,CAAE;GACjF,IAAI,IAAI,OAAO,IAAI,QAAQ,CAAC,GAAK,IAAI,SAAuB,CAAC,GAAI,EAAE,OAAO,MAAM,CAAC;QAC5E,IAAI,QAAQ;EACnB;CACF;CAEA,IAAI,WAAW,KAAK;EAClB,IAAI,OAAO,CAAC,IAAI,KAAK;EACrB,OAAO,IAAI;CACb;CAEA,IAAI,MAAM,QAAQ,IAAI,QAAQ,GAAG;EAC/B,MAAM,WAAW,IAAI;EACrB,IAAI,SAAS,SAAS,GAAG,IAAI,UAAU,SAAS;EAChD,IAAI,SAAS,SAAS,GAAG,IAAI,gBAAgB;EAC7C,OAAO,IAAI;CACb;CAEA,IAAI,MAAM,QAAQ,IAAI,QAAQ,KAAK,IAAI,SAAS,WAAW,GAAG,OAAO,IAAI;CAEzE,KAAK,MAAM,WAAW,sBAAsB,OAAO,IAAI;CAEvD,OAAO;AACT;AAEA,MAAa,eAAe,SAA6B;CACvD,GAAG;CACH,SAAS;CACT,MAAM,IAAI,MAAM,KAAK,EAAE,MAAM,OAAO,QAAQ,SAAS,SAAS,UAAU,GAAG,WAAsB,IAAI;AACvG;AAEA,MAAa,eAAe,QAA4B;CACtD,MAAM,YAAY,gBAAgB,YAAY,GAAG,CAAC;CAClD,UAAU,UAAU;CACpB,OAAO,UAAU,KAAK;CACtB,OAAO,UAAU,KAAK,SAAS;CAC/B,OAAO;AACT"}

package/dist/server/spec/entitySchemas.d.ts

@@ -0,0 +1,16 @@
+import { BuildContext, Entity } from "../../shared/types/index.js";
+import { Block, SanitizedConfig } from "payload";
+import { SchemaObject } from "@scalar/openapi-types/3.2";
+export declare const resolveLocalizedStrings: (value: unknown, ctx: BuildContext) => unknown;
+export interface EntitySchemas {
+  read: SchemaObject;
+  create: SchemaObject;
+  update: SchemaObject;
+}
+export declare const buildEntitySchemas: ({ entity, config, ctx }: {
+  entity: Entity;
+  config: SanitizedConfig;
+  ctx: BuildContext;
+}) => Promise<EntitySchemas>;
+export declare const buildBlockSchema: (block: Block, config: SanitizedConfig) => SchemaObject;
+//# sourceMappingURL=entitySchemas.d.ts.map

package/dist/server/spec/entitySchemas.js

@@ -0,0 +1,207 @@
+import { deepMerge, isPlainObject } from "../../shared/utils.js";
+import { rewriteRefs } from "./names.js";
+import { makeT } from "../../shared/translations/index.js";
+import { AUTH_FIELDS, flattenFields } from "./fields.js";
+import { entityToJSONSchema } from "payload";
+import { getTranslation } from "@payloadcms/translations";
+const READ_HIDDEN_FIELDS = /* @__PURE__ */ new Set([...AUTH_FIELDS, "collection"]);
+const stripInterfaceName = (entity) => {
+	const { interfaceName: _omit, ...rest } = entity;
+	return rest;
+};
+const toComponentSchema = ({ config, source, idType, defs = /* @__PURE__ */ new Map(), variant }) => {
+	const jsonSchema = entityToJSONSchema(config, source, defs, idType, /* @__PURE__ */ new Set(), void 0, void 0, void 0, variant);
+	const blockSlugs = new Set((config.blocks ?? []).map((b) => b.slug));
+	const schema = rewriteRefs(jsonSchema, blockSlugs, defs);
+	delete schema.title;
+	return schema;
+};
+const fieldOpenapi = (field) => {
+	const meta = field.custom?.openapi;
+	return isPlainObject(meta) ? meta : void 0;
+};
+const isLocaleKeyed = (value, ctx) => {
+	if (!isPlainObject(value)) return false;
+	const keys = Object.keys(value);
+	return keys.length > 0 && keys.every((k) => ctx.locales.includes(k)) && Object.values(value).every((v) => typeof v === "string");
+};
+const LOCALIZABLE_KEYS = /* @__PURE__ */ new Set([
+	"description",
+	"title",
+	"summary"
+]);
+const resolveTextValue = (value, ctx) => {
+	if (typeof value === "function") try {
+		const result = value({
+			t: ctx.i18n.t,
+			i18n: ctx.i18n
+		});
+		return typeof result === "string" && result.length > 0 ? result : void 0;
+	} catch {
+		return;
+	}
+	if (isLocaleKeyed(value, ctx)) return getTranslation(value, ctx.i18n);
+};
+const resolveLocalizedStrings = (value, ctx) => {
+	if (!isPlainObject(value)) return value;
+	const out = {};
+	for (const [k, v] of Object.entries(value)) {
+		if (LOCALIZABLE_KEYS.has(k)) {
+			const resolved = resolveTextValue(v, ctx);
+			if (resolved !== void 0) out[k] = resolved;
+			else if (typeof v !== "function") out[k] = resolveLocalizedStrings(v, ctx);
+			continue;
+		}
+		out[k] = resolveLocalizedStrings(v, ctx);
+	}
+	return out;
+};
+const applyFieldOverrides = ({ schema, fields, ctx }) => {
+	if (!schema.properties) return;
+	for (const field of flattenFields(fields)) {
+		const name = "name" in field ? field.name : void 0;
+		const override = fieldOpenapi(field);
+		if (!name || !override) continue;
+		const current = schema.properties[name];
+		if (isPlainObject(current)) {
+			const resolved = resolveLocalizedStrings(override, ctx);
+			schema.properties[name] = deepMerge(current, resolved);
+		}
+	}
+};
+const isRef = (value) => isPlainObject(value) && typeof value.$ref === "string";
+const isBlockBranch = (branch) => {
+	if (isRef(branch)) return branch.$ref.startsWith("#/components/schemas/Block");
+	return isPlainObject(branch) && isPlainObject(branch.properties) && "blockType" in branch.properties;
+};
+const addBlockDiscriminators = (node) => {
+	if (Array.isArray(node)) {
+		for (const item of node) addBlockDiscriminators(item);
+		return;
+	}
+	if (!isPlainObject(node)) return;
+	const oneOf = node.oneOf;
+	if (Array.isArray(oneOf) && oneOf.length > 0 && oneOf.every(isBlockBranch)) node.discriminator = { propertyName: "blockType" };
+	for (const value of Object.values(node)) addBlockDiscriminators(value);
+};
+const fixPolymorphicJoinRequired = (node) => {
+	if (Array.isArray(node)) {
+		for (const item of node) fixPolymorphicJoinRequired(item);
+		return;
+	}
+	if (!isPlainObject(node)) return;
+	const { properties, required } = node;
+	if (isPlainObject(properties) && "relationTo" in properties && Array.isArray(required)) node.required = required.map((r) => r === "collectionSlug" ? "relationTo" : r);
+	for (const value of Object.values(node)) fixPolymorphicJoinRequired(value);
+};
+const markLocalizedFields = ({ schema, fields, ctx }) => {
+	if (!schema.properties || ctx.locales.length === 0) return;
+	for (const field of flattenFields(fields)) {
+		if (!("localized" in field) || !field.localized) continue;
+		const name = "name" in field ? field.name : void 0;
+		if (!name || !(name in schema.properties)) continue;
+		const single = schema.properties[name];
+		schema.properties[name] = { oneOf: [single, {
+			type: "object",
+			description: makeT(ctx.i18n)("schemaPerLocale"),
+			properties: Object.fromEntries(ctx.locales.map((l) => [l, single]))
+		}] };
+	}
+};
+const removeProps = (schema, names) => {
+	if (!schema.properties) return;
+	for (const name of names) delete schema.properties[name];
+	if (Array.isArray(schema.required)) {
+		const drop = new Set(names);
+		schema.required = schema.required.filter((r) => !drop.has(r));
+	}
+};
+const isConstantDeny = (access) => {
+	if (typeof access !== "function" || access.length > 0) return false;
+	try {
+		return access() === false;
+	} catch {
+		return false;
+	}
+};
+const deniedWrites = (fields, operation) => flattenFields(fields).filter((field) => "name" in field && "access" in field && isConstantDeny(field.access?.[operation])).map((field) => field.name);
+const cloneSchema = (schema) => ({
+	...schema,
+	properties: { ...schema.properties },
+	required: Array.isArray(schema.required) ? [...schema.required] : schema.required
+});
+const buildEntitySchemas = async ({ entity, config, ctx }) => {
+	const source = stripInterfaceName(entity);
+	const defs = /* @__PURE__ */ new Map();
+	const idType = ctx.defaultIDType;
+	const read = toComponentSchema({
+		config,
+		source,
+		idType,
+		defs
+	});
+	const write = toComponentSchema({
+		config,
+		source,
+		idType,
+		defs,
+		variant: "input"
+	});
+	const isAuth = "auth" in entity && Boolean(entity.auth);
+	for (const schema of [read, write]) {
+		if (isAuth) removeProps(schema, READ_HIDDEN_FIELDS);
+		applyFieldOverrides({
+			schema,
+			fields: entity.fields,
+			ctx
+		});
+		addBlockDiscriminators(schema);
+	}
+	fixPolymorphicJoinRequired(read);
+	const create = cloneSchema(write);
+	if (isAuth && create.properties) {
+		create.properties.password = { type: "string" };
+		create.required = [.../* @__PURE__ */ new Set([...create.required ?? [], "password"])];
+	}
+	removeProps(create, deniedWrites(entity.fields, "create"));
+	const update = cloneSchema(write);
+	removeProps(update, deniedWrites(entity.fields, "update"));
+	delete update.required;
+	if (update.properties) delete update.properties.id;
+	if (isAuth && update.properties) update.properties.password = { type: "string" };
+	markLocalizedFields({
+		schema: read,
+		fields: entity.fields,
+		ctx
+	});
+	return {
+		read,
+		create,
+		update
+	};
+};
+const buildBlockSchema = (block, config) => {
+	const schema = toComponentSchema({
+		config,
+		source: stripInterfaceName(block),
+		idType: "text"
+	});
+	const blockType = {
+		type: "string",
+		enum: [block.slug]
+	};
+	const properties = {
+		...schema.properties,
+		blockType
+	};
+	const required = [.../* @__PURE__ */ new Set(["blockType", ...schema.required ?? []])];
+	return {
+		...schema,
+		type: "object",
+		properties,
+		required
+	};
+};
+export { buildBlockSchema, buildEntitySchemas, resolveLocalizedStrings };
+
+//# sourceMappingURL=entitySchemas.js.map

package/dist/server/spec/entitySchemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitySchemas.js","names":[],"sources":["../../../src/server/spec/entitySchemas.ts"],"sourcesContent":["import { getTranslation } from '@payloadcms/translations'\nimport type { SchemaObject } from '@scalar/openapi-types/3.2'\nimport { entityToJSONSchema } from 'payload'\nimport type { Block, Field, SanitizedConfig, SchemaVariant } from 'payload'\n\nimport { makeT } from '@/shared/translations/index.js'\nimport type { BuildContext, Entity, IDType } from '@/shared/types/index.js'\nimport { deepMerge, isPlainObject } from '@/shared/utils.js'\n\nimport { AUTH_FIELDS, flattenFields } from './fields.js'\nimport { rewriteRefs } from './names.js'\n\nconst READ_HIDDEN_FIELDS = new Set<string>([...AUTH_FIELDS, 'collection'])\n\nconst stripInterfaceName = <T>(entity: T): T => {\n  const { interfaceName: _omit, ...rest } = entity as T & { interfaceName?: string }\n  return rest as T\n}\n\nconst toComponentSchema = ({\n  config,\n  source,\n  idType,\n  defs = new Map(),\n  variant,\n}: {\n  config: SanitizedConfig\n  source: Entity | Block\n  idType: IDType\n  defs?: Map<string, unknown>\n  variant?: SchemaVariant\n}): SchemaObject => {\n  const jsonSchema = entityToJSONSchema(\n    config,\n    source as never,\n    defs as never,\n    idType,\n    new Set(),\n    undefined,\n    undefined,\n    undefined,\n    variant,\n  )\n  const blockSlugs = new Set((config.blocks ?? []).map((b) => b.slug))\n  const schema = rewriteRefs(jsonSchema as never, blockSlugs, defs) as unknown as SchemaObject\n  delete schema.title\n  return schema\n}\n\nconst fieldOpenapi = (field: Field): Record<string, unknown> | undefined => {\n  const meta = (field as { custom?: { openapi?: unknown } }).custom?.openapi\n  return isPlainObject(meta) ? meta : undefined\n}\n\nconst isLocaleKeyed = (value: unknown, ctx: BuildContext): value is Record<string, string> => {\n  if (!isPlainObject(value)) return false\n  const keys = Object.keys(value)\n  return (\n    keys.length > 0 &&\n    keys.every((k) => ctx.locales.includes(k)) &&\n    Object.values(value).every((v) => typeof v === 'string')\n  )\n}\n\nconst LOCALIZABLE_KEYS = new Set(['description', 'title', 'summary'])\n\nconst resolveTextValue = (value: unknown, ctx: BuildContext): string | undefined => {\n  if (typeof value === 'function') {\n    try {\n      const result = (value as (args: { t: unknown; i18n: unknown }) => unknown)({ t: ctx.i18n.t, i18n: ctx.i18n })\n      return typeof result === 'string' && result.length > 0 ? result : undefined\n    } catch {\n      return undefined\n    }\n  }\n  if (isLocaleKeyed(value, ctx)) return getTranslation(value, ctx.i18n)\n  return undefined\n}\n\nexport const resolveLocalizedStrings = (value: unknown, ctx: BuildContext): unknown => {\n  if (!isPlainObject(value)) return value\n  const out: Record<string, unknown> = {}\n  for (const [k, v] of Object.entries(value)) {\n    if (LOCALIZABLE_KEYS.has(k)) {\n      const resolved = resolveTextValue(v, ctx)\n      if (resolved !== undefined) out[k] = resolved\n      else if (typeof v !== 'function') out[k] = resolveLocalizedStrings(v, ctx)\n      continue\n    }\n    out[k] = resolveLocalizedStrings(v, ctx)\n  }\n  return out\n}\n\nconst applyFieldOverrides = ({\n  schema,\n  fields,\n  ctx,\n}: {\n  schema: SchemaObject\n  fields: Field[]\n  ctx: BuildContext\n}): void => {\n  if (!schema.properties) return\n  for (const field of flattenFields(fields)) {\n    const name = 'name' in field ? field.name : undefined\n    const override = fieldOpenapi(field)\n    if (!name || !override) continue\n    const current = schema.properties[name]\n    if (isPlainObject(current)) {\n      const resolved = resolveLocalizedStrings(override, ctx) as Record<string, unknown>\n      schema.properties[name] = deepMerge(current, resolved) as SchemaObject\n    }\n  }\n}\n\nconst isRef = (value: unknown): value is { $ref: string } => isPlainObject(value) && typeof value.$ref === 'string'\n\nconst isBlockBranch = (branch: unknown): boolean => {\n  if (isRef(branch)) return branch.$ref.startsWith('#/components/schemas/Block')\n  return isPlainObject(branch) && isPlainObject(branch.properties) && 'blockType' in branch.properties\n}\n\nconst addBlockDiscriminators = (node: unknown): void => {\n  if (Array.isArray(node)) {\n    for (const item of node) addBlockDiscriminators(item)\n    return\n  }\n  if (!isPlainObject(node)) return\n  const oneOf = node.oneOf\n  if (Array.isArray(oneOf) && oneOf.length > 0 && oneOf.every(isBlockBranch)) {\n    ;(node as SchemaObject).discriminator = { propertyName: 'blockType' }\n  }\n  for (const value of Object.values(node)) addBlockDiscriminators(value)\n}\n\nconst fixPolymorphicJoinRequired = (node: unknown): void => {\n  if (Array.isArray(node)) {\n    for (const item of node) fixPolymorphicJoinRequired(item)\n    return\n  }\n  if (!isPlainObject(node)) return\n  const { properties, required } = node as SchemaObject\n  if (isPlainObject(properties) && 'relationTo' in properties && Array.isArray(required)) {\n    ;(node as SchemaObject).required = required.map((r: string) => (r === 'collectionSlug' ? 'relationTo' : r))\n  }\n  for (const value of Object.values(node)) fixPolymorphicJoinRequired(value)\n}\n\nconst markLocalizedFields = ({\n  schema,\n  fields,\n  ctx,\n}: {\n  schema: SchemaObject\n  fields: Field[]\n  ctx: BuildContext\n}): void => {\n  if (!schema.properties || ctx.locales.length === 0) return\n  for (const field of flattenFields(fields)) {\n    if (!('localized' in field) || !field.localized) continue\n    const name = 'name' in field ? field.name : undefined\n    if (!name || !(name in schema.properties)) continue\n    const single = schema.properties[name] as SchemaObject\n    schema.properties[name] = {\n      oneOf: [\n        single,\n        {\n          type: 'object',\n          description: makeT(ctx.i18n)('schemaPerLocale'),\n          properties: Object.fromEntries(ctx.locales.map((l) => [l, single])),\n        },\n      ],\n    }\n  }\n}\n\nconst removeProps = (schema: SchemaObject, names: Iterable<string>): void => {\n  if (!schema.properties) return\n  for (const name of names) delete schema.properties[name]\n  if (Array.isArray(schema.required)) {\n    const drop = new Set(names)\n    schema.required = schema.required.filter((r: string) => !drop.has(r))\n  }\n}\n\nconst isConstantDeny = (access: unknown): boolean => {\n  if (typeof access !== 'function' || access.length > 0) return false\n  try {\n    return access() === false\n  } catch {\n    return false\n  }\n}\n\nconst deniedWrites = (fields: Field[], operation: 'create' | 'update'): string[] =>\n  flattenFields(fields)\n    .filter((field) => 'name' in field && 'access' in field && isConstantDeny(field.access?.[operation]))\n    .map((field) => (field as { name: string }).name)\n\nconst cloneSchema = (schema: SchemaObject): SchemaObject => ({\n  ...schema,\n  properties: { ...schema.properties },\n  required: Array.isArray(schema.required) ? [...schema.required] : schema.required,\n})\n\nexport interface EntitySchemas {\n  read: SchemaObject\n  create: SchemaObject\n  update: SchemaObject\n}\n\nexport const buildEntitySchemas = async ({\n  entity,\n  config,\n  ctx,\n}: {\n  entity: Entity\n  config: SanitizedConfig\n  ctx: BuildContext\n}): Promise<EntitySchemas> => {\n  const source = stripInterfaceName(entity)\n  const defs = new Map<string, unknown>()\n  const idType = ctx.defaultIDType\n  const read = toComponentSchema({ config, source, idType, defs })\n  const write = toComponentSchema({ config, source, idType, defs, variant: 'input' })\n  const isAuth = 'auth' in entity && Boolean(entity.auth)\n\n  for (const schema of [read, write]) {\n    if (isAuth) removeProps(schema, READ_HIDDEN_FIELDS)\n    applyFieldOverrides({ schema, fields: entity.fields, ctx })\n    addBlockDiscriminators(schema)\n  }\n  fixPolymorphicJoinRequired(read)\n\n  const create = cloneSchema(write)\n  if (isAuth && create.properties) {\n    create.properties.password = { type: 'string' }\n    create.required = [...new Set([...(create.required ?? []), 'password'])]\n  }\n\n  removeProps(create, deniedWrites(entity.fields, 'create'))\n\n  const update = cloneSchema(write)\n  removeProps(update, deniedWrites(entity.fields, 'update'))\n  delete update.required\n  if (update.properties) delete update.properties.id\n  if (isAuth && update.properties) {\n    update.properties.password = { type: 'string' }\n  }\n\n  markLocalizedFields({ schema: read, fields: entity.fields, ctx })\n\n  return { read, create, update }\n}\n\nexport const buildBlockSchema = (block: Block, config: SanitizedConfig): SchemaObject => {\n  const schema = toComponentSchema({ config, source: stripInterfaceName(block), idType: 'text' })\n  const blockType: SchemaObject = { type: 'string', enum: [block.slug] }\n  const properties = { ...schema.properties, blockType }\n  const required = [...new Set(['blockType', ...(schema.required ?? [])])]\n  return { ...schema, type: 'object', properties, required }\n}\n"],"mappings":"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"}

package/dist/{spec → server/spec}/fields.d.ts

@@ -1,5 +1,6 @@
-import type { Field } from 'payload';
+import { Field } from "payload";
 export declare const isHiddenField: (field: Field) => boolean;
 export declare const AUTH_FIELDS: Set<string>;
 export declare const flattenFields: (fields: Field[]) => Field[];
 export declare const exposableFields: (fields: Field[]) => Field[];
+//# sourceMappingURL=fields.d.ts.map