@seshuk/payload-plugin-openapi 0.2.3 → 1.0.0-beta.2

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 { entityToJSONSchema } from 'payload'\nimport type { Block, Field, SanitizedConfig, SchemaVariant } from 'payload'\n\nimport { makeT } from '@/shared/translations/index.js'\nimport type { BuildContext, Entity, IDType, Schema } 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}): Schema => {\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 Schema\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 = ({ schema, fields, ctx }: { schema: Schema; fields: Field[]; ctx: BuildContext }): 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 Schema\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 Schema).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 Schema\n  if (isPlainObject(properties) && 'relationTo' in properties && Array.isArray(required)) {\n    ;(node as Schema).required = required.map((r: string) => (r === 'collectionSlug' ? 'relationTo' : r))\n  }\n  for (const value of Object.values(node)) fixPolymorphicJoinRequired(value)\n}\n\nconst markLocalizedFields = ({ schema, fields, ctx }: { schema: Schema; fields: Field[]; ctx: BuildContext }): 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 Schema\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: Schema, 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: Schema): Schema => ({\n  ...schema,\n  properties: { ...schema.properties },\n  required: Array.isArray(schema.required) ? [...schema.required] : schema.required,\n})\n\nexport interface EntitySchemas {\n  read: Schema\n  create: Schema\n  update: Schema\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): Schema => {\n  const schema = toComponentSchema({ config, source: stripInterfaceName(block), idType: 'text' })\n  const blockType: Schema = { 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

package/dist/server/spec/fields.js

@@ -0,0 +1,47 @@
+const isHiddenField = (field) => "hidden" in field && field.hidden === true;
+const AUTH_FIELDS = /* @__PURE__ */ new Set([
+	"salt",
+	"hash",
+	"password",
+	"resetPasswordToken",
+	"resetPasswordExpiration",
+	"loginAttempts",
+	"lockUntil",
+	"sessions"
+]);
+const hasName = (field) => "name" in field && typeof field.name === "string";
+const flattenFields = (fields) => {
+	const out = [];
+	for (const field of fields) {
+		if (field.type === "ui") continue;
+		if (field.type === "row" || field.type === "collapsible") {
+			out.push(...flattenFields(field.fields));
+			continue;
+		}
+		if (field.type === "tabs") {
+			for (const tab of field.tabs) {
+				const tabName = hasName(tab) ? tab.name : void 0;
+				if (tabName) out.push({
+					type: "group",
+					name: tabName,
+					fields: tab.fields
+				});
+				else out.push(...flattenFields(tab.fields));
+			}
+			continue;
+		}
+		if (field.type === "group" && !hasName(field)) {
+			out.push(...flattenFields(field.fields));
+			continue;
+		}
+		out.push(field);
+	}
+	return out;
+};
+const exposableFields = (fields) => flattenFields(fields).filter((field) => {
+	const name = "name" in field ? field.name : void 0;
+	return Boolean(name) && !isHiddenField(field) && !AUTH_FIELDS.has(name);
+});
+export { AUTH_FIELDS, exposableFields, flattenFields, isHiddenField };
+
+//# sourceMappingURL=fields.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","names":[],"sources":["../../../src/server/spec/fields.ts"],"sourcesContent":["import type { Field, NamedTab } from 'payload'\n\nexport const isHiddenField = (field: Field): boolean => 'hidden' in field && field.hidden === true\n\nexport const AUTH_FIELDS = new Set([\n  'salt',\n  'hash',\n  'password',\n  'resetPasswordToken',\n  'resetPasswordExpiration',\n  'loginAttempts',\n  'lockUntil',\n  'sessions',\n])\n\nconst hasName = (field: object): boolean => 'name' in field && typeof (field as { name?: unknown }).name === 'string'\n\nexport const flattenFields = (fields: Field[]): Field[] => {\n  const out: Field[] = []\n  for (const field of fields) {\n    if (field.type === 'ui') continue\n\n    if (field.type === 'row' || field.type === 'collapsible') {\n      out.push(...flattenFields(field.fields))\n      continue\n    }\n\n    if (field.type === 'tabs') {\n      for (const tab of field.tabs) {\n        const tabName = hasName(tab) ? (tab as NamedTab).name : undefined\n        if (tabName) {\n          out.push({ type: 'group', name: tabName, fields: tab.fields } as unknown as Field)\n        } else {\n          out.push(...flattenFields(tab.fields))\n        }\n      }\n      continue\n    }\n\n    if (field.type === 'group' && !hasName(field)) {\n      out.push(...flattenFields(field.fields))\n      continue\n    }\n\n    out.push(field)\n  }\n  return out\n}\n\nexport const exposableFields = (fields: Field[]): Field[] =>\n  flattenFields(fields).filter((field) => {\n    const name = 'name' in field ? (field as { name?: string }).name : undefined\n    return Boolean(name) && !isHiddenField(field) && !AUTH_FIELDS.has(name as string)\n  })\n"],"mappings":"AAEA,MAAa,iBAAiB,UAA0B,YAAY,SAAS,MAAM,WAAW;AAE9F,MAAa,8BAAc,IAAI,IAAI;CACjC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAM,WAAW,UAA2B,UAAU,SAAS,OAAQ,MAA6B,SAAS;AAE7G,MAAa,iBAAiB,WAA6B;CACzD,MAAM,MAAe,CAAC;CACtB,KAAK,MAAM,SAAS,QAAQ;EAC1B,IAAI,MAAM,SAAS,MAAM;EAEzB,IAAI,MAAM,SAAS,SAAS,MAAM,SAAS,eAAe;GACxD,IAAI,KAAK,GAAG,cAAc,MAAM,MAAM,CAAC;GACvC;EACF;EAEA,IAAI,MAAM,SAAS,QAAQ;GACzB,KAAK,MAAM,OAAO,MAAM,MAAM;IAC5B,MAAM,UAAU,QAAQ,GAAG,IAAK,IAAiB,OAAO,KAAA;IACxD,IAAI,SACF,IAAI,KAAK;KAAE,MAAM;KAAS,MAAM;KAAS,QAAQ,IAAI;IAAO,CAAqB;SAEjF,IAAI,KAAK,GAAG,cAAc,IAAI,MAAM,CAAC;GAEzC;GACA;EACF;EAEA,IAAI,MAAM,SAAS,WAAW,CAAC,QAAQ,KAAK,GAAG;GAC7C,IAAI,KAAK,GAAG,cAAc,MAAM,MAAM,CAAC;GACvC;EACF;EAEA,IAAI,KAAK,KAAK;CAChB;CACA,OAAO;AACT;AAEA,MAAa,mBAAmB,WAC9B,cAAc,MAAM,CAAC,CAAC,QAAQ,UAAU;CACtC,MAAM,OAAO,UAAU,QAAS,MAA4B,OAAO,KAAA;CACnE,OAAO,QAAQ,IAAI,KAAK,CAAC,cAAc,KAAK,KAAK,CAAC,YAAY,IAAI,IAAc;AAClF,CAAC"}

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

@@ -0,0 +1,16 @@
+import { OperationKind, ResolvedFilters } from "../../shared/types/index.js";
+import { SanitizedCollectionConfig, SanitizedGlobalConfig } from "payload";
+import { PathsObject } from "@scalar/openapi-types/3.2";
+export declare const shouldIncludeCollection: (collection: SanitizedCollectionConfig, filters: ResolvedFilters) => boolean;
+export declare const shouldIncludeGlobal: (global: SanitizedGlobalConfig, filters: ResolvedFilters) => boolean;
+export declare const PLUGIN_KEY = "x-payload-plugin";
+export declare const operationPlugin: (operation: unknown, plugin: string | undefined) => string | undefined;
+export declare const stripPluginKeys: (paths: PathsObject) => PathsObject;
+export declare const filterOperations: ({ paths, slug, kind, plugin, filters }: {
+  paths: PathsObject;
+  slug?: string;
+  kind: OperationKind;
+  plugin?: string;
+  filters: ResolvedFilters;
+}) => Promise<PathsObject>;
+//# sourceMappingURL=filters.d.ts.map

package/dist/server/spec/filters.js

@@ -0,0 +1,102 @@
+const SYSTEM_COLLECTIONS = /* @__PURE__ */ new Set([
+	"payload-jobs",
+	"payload-locked-documents",
+	"payload-preferences",
+	"payload-migrations",
+	"payload-kv",
+	"payload-llm-instructions",
+	"payload-query-presets"
+]);
+const SYSTEM_GLOBALS = /* @__PURE__ */ new Set(["payload-jobs-stats"]);
+const HTTP_METHODS = [
+	"get",
+	"post",
+	"patch",
+	"put",
+	"delete"
+];
+const matchesEntity = (matcher, { slug, kind }) => {
+	if (typeof matcher === "string") return matcher === slug;
+	if (matcher instanceof RegExp) return matcher.test(slug);
+	return matcher.kind === kind && matcher.slug === slug;
+};
+const anyMatch = (matchers, entity) => matchers.some((m) => matchesEntity(m, entity));
+const isHiddenCollection = (collection) => {
+	if (collection.hidden === true) return true;
+	const hidden = collection.admin?.hidden;
+	if (typeof hidden === "function") try {
+		return hidden({ user: null }) === true;
+	} catch {
+		return false;
+	}
+	return hidden === true;
+};
+const passesIncludeExclude = (entity, filters) => {
+	if (filters.include.length > 0 && !anyMatch(filters.include, entity)) return false;
+	if (anyMatch(filters.exclude, entity)) return false;
+	return true;
+};
+const shouldIncludeCollection = (collection, filters) => {
+	const { slug } = collection;
+	if (SYSTEM_COLLECTIONS.has(slug) && !filters.includeSystem) return false;
+	if (!filters.includeHidden && isHiddenCollection(collection)) return false;
+	return passesIncludeExclude({
+		slug,
+		kind: "collection"
+	}, filters);
+};
+const shouldIncludeGlobal = (global, filters) => {
+	if (SYSTEM_GLOBALS.has(global.slug) && !filters.includeSystem) return false;
+	return passesIncludeExclude({
+		slug: global.slug,
+		kind: "global"
+	}, filters);
+};
+const ruleMatchesMethod = (rule, method) => {
+	if (rule.method === void 0) return true;
+	return Array.isArray(rule.method) ? rule.method.includes(method) : rule.method === method;
+};
+const matchesOptional = (matcher, value) => {
+	if (matcher === void 0) return true;
+	if (value === void 0) return false;
+	return matcher instanceof RegExp ? matcher.test(value) : matcher === value;
+};
+const ruleMatches = (rule, { method, slug, kind, path, plugin }) => ruleMatchesMethod(rule, method) && matchesOptional(rule.slug, slug) && matchesOptional(rule.plugin, plugin) && (rule.kind === void 0 || rule.kind === kind) && (rule.path === void 0 || rule.path.test(path));
+const PLUGIN_KEY = "x-payload-plugin";
+const operationPlugin = (operation, plugin) => {
+	const marked = operation?.[PLUGIN_KEY];
+	return plugin ?? (typeof marked === "string" ? marked : void 0);
+};
+const stripPluginKeys = (paths) => {
+	for (const item of Object.values(paths)) for (const method of HTTP_METHODS) delete item[method]?.[PLUGIN_KEY];
+	return paths;
+};
+const isOperationExcluded = async (filters, op) => {
+	for (const rule of filters.excludeOperations) if (typeof rule === "function" ? await rule(op) === true : ruleMatches(rule, op)) return true;
+	return false;
+};
+const filterOperations = async ({ paths, slug, kind, plugin, filters }) => {
+	if (filters.excludeOperations.length === 0) return paths;
+	for (const [path, item] of Object.entries(paths)) {
+		if (!item) continue;
+		let remaining = 0;
+		const ops = item;
+		for (const method of HTTP_METHODS) {
+			if (!ops[method]) continue;
+			const op = {
+				method,
+				path,
+				slug,
+				kind,
+				plugin: operationPlugin(ops[method], plugin)
+			};
+			if (await isOperationExcluded(filters, op)) delete ops[method];
+			else remaining += 1;
+		}
+		if (remaining === 0) delete paths[path];
+	}
+	return paths;
+};
+export { PLUGIN_KEY, filterOperations, operationPlugin, shouldIncludeCollection, shouldIncludeGlobal, stripPluginKeys };
+
+//# sourceMappingURL=filters.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filters.js","names":[],"sources":["../../../src/server/spec/filters.ts"],"sourcesContent":["import type { PathsObject } from '@scalar/openapi-types/3.2'\nimport type { SanitizedCollectionConfig, SanitizedGlobalConfig } from 'payload'\n\nimport type {\n  EntityKind,\n  EntityMatcher,\n  HttpMethod,\n  OperationContext,\n  OperationKind,\n  OperationRule,\n  ResolvedFilters,\n} from '@/shared/types/index.js'\n\nconst SYSTEM_COLLECTIONS = new Set([\n  'payload-jobs',\n  'payload-locked-documents',\n  'payload-preferences',\n  'payload-migrations',\n  'payload-kv',\n  'payload-llm-instructions',\n  'payload-query-presets',\n])\n\nconst SYSTEM_GLOBALS = new Set(['payload-jobs-stats'])\n\nconst HTTP_METHODS: HttpMethod[] = ['get', 'post', 'patch', 'put', 'delete']\n\ninterface EntityRef {\n  slug: string\n  kind: EntityKind\n}\n\nconst matchesEntity = (matcher: EntityMatcher, { slug, kind }: EntityRef): boolean => {\n  if (typeof matcher === 'string') return matcher === slug\n  if (matcher instanceof RegExp) return matcher.test(slug)\n  return matcher.kind === kind && matcher.slug === slug\n}\n\nconst anyMatch = (matchers: EntityMatcher[], entity: EntityRef): boolean =>\n  matchers.some((m) => matchesEntity(m, entity))\n\nconst isHiddenCollection = (collection: SanitizedCollectionConfig): boolean => {\n  if ((collection as { hidden?: unknown }).hidden === true) return true\n  const hidden = collection.admin?.hidden\n  if (typeof hidden === 'function') {\n    try {\n      return hidden({ user: null } as never) === true\n    } catch {\n      return false\n    }\n  }\n  return hidden === true\n}\n\nconst passesIncludeExclude = (entity: EntityRef, filters: ResolvedFilters): boolean => {\n  if (filters.include.length > 0 && !anyMatch(filters.include, entity)) return false\n  if (anyMatch(filters.exclude, entity)) return false\n  return true\n}\n\nexport const shouldIncludeCollection = (collection: SanitizedCollectionConfig, filters: ResolvedFilters): boolean => {\n  const { slug } = collection\n  if (SYSTEM_COLLECTIONS.has(slug) && !filters.includeSystem) return false\n  if (!filters.includeHidden && isHiddenCollection(collection)) return false\n  return passesIncludeExclude({ slug, kind: 'collection' }, filters)\n}\n\nexport const shouldIncludeGlobal = (global: SanitizedGlobalConfig, filters: ResolvedFilters): boolean => {\n  if (SYSTEM_GLOBALS.has(global.slug) && !filters.includeSystem) return false\n  return passesIncludeExclude({ slug: global.slug, kind: 'global' }, filters)\n}\n\nconst ruleMatchesMethod = (rule: OperationRule, method: HttpMethod): boolean => {\n  if (rule.method === undefined) return true\n  return Array.isArray(rule.method) ? rule.method.includes(method) : rule.method === method\n}\n\nconst matchesOptional = (matcher: string | RegExp | undefined, value: string | undefined): boolean => {\n  if (matcher === undefined) return true\n  if (value === undefined) return false\n  return matcher instanceof RegExp ? matcher.test(value) : matcher === value\n}\n\nconst ruleMatches = (rule: OperationRule, { method, slug, kind, path, plugin }: OperationContext): boolean =>\n  ruleMatchesMethod(rule, method) &&\n  matchesOptional(rule.slug, slug) &&\n  matchesOptional(rule.plugin, plugin) &&\n  (rule.kind === undefined || rule.kind === kind) &&\n  (rule.path === undefined || rule.path.test(path))\n\nexport const PLUGIN_KEY = 'x-payload-plugin'\n\nexport const operationPlugin = (operation: unknown, plugin: string | undefined): string | undefined => {\n  const marked = (operation as Record<string, unknown> | undefined)?.[PLUGIN_KEY]\n  return plugin ?? (typeof marked === 'string' ? marked : undefined)\n}\n\nexport const stripPluginKeys = (paths: PathsObject): PathsObject => {\n  for (const item of Object.values(paths)) {\n    for (const method of HTTP_METHODS)\n      delete (item as Record<HttpMethod, Record<string, unknown> | undefined>)[method]?.[PLUGIN_KEY]\n  }\n  return paths\n}\n\nconst isOperationExcluded = async (filters: ResolvedFilters, op: OperationContext): Promise<boolean> => {\n  for (const rule of filters.excludeOperations) {\n    if (typeof rule === 'function' ? (await rule(op)) === true : ruleMatches(rule, op)) return true\n  }\n  return false\n}\n\nexport const filterOperations = async ({\n  paths,\n  slug,\n  kind,\n  plugin,\n  filters,\n}: {\n  paths: PathsObject\n  slug?: string\n  kind: OperationKind\n  plugin?: string\n  filters: ResolvedFilters\n}): Promise<PathsObject> => {\n  if (filters.excludeOperations.length === 0) return paths\n\n  for (const [path, item] of Object.entries(paths)) {\n    if (!item) continue\n    let remaining = 0\n    const ops = item as Record<HttpMethod, unknown>\n    for (const method of HTTP_METHODS) {\n      if (!ops[method]) continue\n      const op = { method, path, slug, kind, plugin: operationPlugin(ops[method], plugin) }\n      if (await isOperationExcluded(filters, op)) {\n        delete ops[method]\n      } else {\n        remaining += 1\n      }\n    }\n    if (remaining === 0) delete paths[path]\n  }\n  return paths\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,11 @@
+import { BuildContext } from "../../shared/types/index.js";
+import { SanitizedCollectionConfig } from "payload";
+import { PathsObject, SchemaObject } from "@scalar/openapi-types/3.2";
+export declare const applyHierarchy: ({ collection, base, paths, schemas, ctx }: {
+  collection: SanitizedCollectionConfig;
+  base: string;
+  paths: PathsObject;
+  schemas: Record<string, SchemaObject>;
+  ctx: BuildContext;
+}) => void;
+//# sourceMappingURL=hierarchy.d.ts.map

package/dist/server/spec/hierarchy.js

@@ -0,0 +1,43 @@
+import { createSchemaName, querySchemaName, updateSchemaName } from "./names.js";
+import { makeT } from "../../shared/translations/index.js";
+const applyHierarchy = ({ collection, base, paths, schemas, ctx }) => {
+	const { hierarchy } = collection;
+	if (!hierarchy) return;
+	const t = makeT(ctx.i18n);
+	const pathFields = {
+		[hierarchy.slugPathFieldName]: t("schemaHierarchySlugPath"),
+		[hierarchy.titlePathFieldName]: t("schemaHierarchyTitlePath")
+	};
+	const propertiesOf = (name) => {
+		const schema = schemas[name];
+		return typeof schema === "object" ? schema.properties : void 0;
+	};
+	const read = propertiesOf(base);
+	for (const [name, description] of Object.entries(pathFields)) {
+		const current = read?.[name];
+		if (read && typeof current === "object") read[name] = {
+			...current,
+			readOnly: true,
+			description
+		};
+		for (const other of [
+			createSchemaName(base),
+			updateSchemaName(base),
+			querySchemaName(base)
+		]) delete propertiesOf(other)?.[name];
+	}
+	const param = {
+		name: "computeHierarchyPaths",
+		in: "query",
+		description: t("paramComputeHierarchyPaths", {
+			slugPath: hierarchy.slugPathFieldName,
+			titlePath: hierarchy.titlePathFieldName
+		}),
+		schema: { type: "boolean" }
+	};
+	const route = `${ctx.apiRoute}/${collection.slug}`;
+	for (const op of [paths[route]?.get, paths[`${route}/{id}`]?.get]) op?.parameters?.push(param);
+};
+export { applyHierarchy };
+
+//# sourceMappingURL=hierarchy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.js","names":[],"sources":["../../../src/server/spec/hierarchy.ts"],"sourcesContent":["import type { OperationObject, ParameterObject, PathsObject, SchemaObject } from '@scalar/openapi-types/3.2'\nimport type { SanitizedCollectionConfig } from 'payload'\n\nimport { createSchemaName, querySchemaName, updateSchemaName } from '@/server/spec/names.js'\nimport { makeT } from '@/shared/translations/index.js'\nimport type { BuildContext } from '@/shared/types/index.js'\n\nexport const applyHierarchy = ({\n  collection,\n  base,\n  paths,\n  schemas,\n  ctx,\n}: {\n  collection: SanitizedCollectionConfig\n  base: string\n  paths: PathsObject\n  schemas: Record<string, SchemaObject>\n  ctx: BuildContext\n}): void => {\n  const { hierarchy } = collection\n  if (!hierarchy) return\n  const t = makeT(ctx.i18n)\n  const pathFields = {\n    [hierarchy.slugPathFieldName]: t('schemaHierarchySlugPath'),\n    [hierarchy.titlePathFieldName]: t('schemaHierarchyTitlePath'),\n  }\n\n  const propertiesOf = (name: string) => {\n    const schema = schemas[name]\n    return typeof schema === 'object' ? schema.properties : undefined\n  }\n  const read = propertiesOf(base)\n  for (const [name, description] of Object.entries(pathFields)) {\n    const current = read?.[name]\n    if (read && typeof current === 'object') read[name] = { ...current, readOnly: true, description }\n    for (const other of [createSchemaName(base), updateSchemaName(base), querySchemaName(base)]) {\n      delete propertiesOf(other)?.[name]\n    }\n  }\n\n  const param: ParameterObject = {\n    name: 'computeHierarchyPaths',\n    in: 'query',\n    description: t('paramComputeHierarchyPaths', {\n      slugPath: hierarchy.slugPathFieldName,\n      titlePath: hierarchy.titlePathFieldName,\n    }),\n    schema: { type: 'boolean' },\n  }\n  const route = `${ctx.apiRoute}/${collection.slug}`\n  for (const op of [paths[route]?.get, paths[`${route}/{id}`]?.get] as (OperationObject | undefined)[]) {\n    op?.parameters?.push(param)\n  }\n}\n"],"mappings":";;AAOA,MAAa,kBAAkB,EAC7B,YACA,MACA,OACA,SACA,UAOU;CACV,MAAM,EAAE,cAAc;CACtB,IAAI,CAAC,WAAW;CAChB,MAAM,IAAI,MAAM,IAAI,IAAI;CACxB,MAAM,aAAa;GAChB,UAAU,oBAAoB,EAAE,yBAAyB;GACzD,UAAU,qBAAqB,EAAE,0BAA0B;CAC9D;CAEA,MAAM,gBAAgB,SAAiB;EACrC,MAAM,SAAS,QAAQ;EACvB,OAAO,OAAO,WAAW,WAAW,OAAO,aAAa,KAAA;CAC1D;CACA,MAAM,OAAO,aAAa,IAAI;CAC9B,KAAK,MAAM,CAAC,MAAM,gBAAgB,OAAO,QAAQ,UAAU,GAAG;EAC5D,MAAM,UAAU,OAAO;EACvB,IAAI,QAAQ,OAAO,YAAY,UAAU,KAAK,QAAQ;GAAE,GAAG;GAAS,UAAU;GAAM;EAAY;EAChG,KAAK,MAAM,SAAS;GAAC,iBAAiB,IAAI;GAAG,iBAAiB,IAAI;GAAG,gBAAgB,IAAI;EAAC,GACxF,OAAO,aAAa,KAAK,CAAC,GAAG;CAEjC;CAEA,MAAM,QAAyB;EAC7B,MAAM;EACN,IAAI;EACJ,aAAa,EAAE,8BAA8B;GAC3C,UAAU,UAAU;GACpB,WAAW,UAAU;EACvB,CAAC;EACD,QAAQ,EAAE,MAAM,UAAU;CAC5B;CACA,MAAM,QAAQ,GAAG,IAAI,SAAS,GAAG,WAAW;CAC5C,KAAK,MAAM,MAAM,CAAC,MAAM,MAAM,EAAE,KAAK,MAAM,GAAG,MAAM,OAAO,EAAE,GAAG,GAC9D,IAAI,YAAY,KAAK,KAAK;AAE9B"}

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

@@ -10,5 +10,5 @@ export declare const populateSchemaName: (base: string) => string;
 export declare const joinsSchemaName: (base: string) => string;
 export declare const refTo: (name: string) => string;
 type JsonValue = Record<string, unknown> | unknown[] | string | number | boolean | null;
-export declare const rewriteRefs: (node: JsonValue, blockSlugs?: Set<string>) => JsonValue;
-export {};
+export declare const rewriteRefs: (node: JsonValue, blockSlugs?: Set<string>, defs?: Map<string, unknown>) => JsonValue;
+//# sourceMappingURL=names.d.ts.map

package/dist/server/spec/names.js

@@ -0,0 +1,43 @@
+import { upperFirst } from "../../shared/utils.js";
+const schemaName = (slug) => upperFirst(slug.replace(/-([a-z])/g, (_, c) => c.toUpperCase()));
+const blockSchemaName = (slug) => {
+	const stripped = slug.replace(/^block[-_]?/i, "").replace(/[-_]?block$/i, "");
+	return `Block${schemaName(stripped || slug)}`;
+};
+const globalSchemaName = (slug) => `Global${schemaName(slug)}`;
+const listSchemaName = (base) => `${base}List`;
+const createSchemaName = (base) => `${base}Create`;
+const updateSchemaName = (base) => `${base}Update`;
+const querySchemaName = (base) => `${base}QueryOperations`;
+const selectSchemaName = (base) => `${base}Select`;
+const populateSchemaName = (base) => `${base}Populate`;
+const joinsSchemaName = (base) => `${base}Joins`;
+const refTo = (name) => `#/components/schemas/${name}`;
+const REF = /^#\/(?:definitions|\$defs|components\/schemas)\/(.+)$/;
+const findBlockSlug = (name, blockSlugs) => [...blockSlugs].find((s) => s === name || schemaName(s) === schemaName(name));
+const normalizeRef = (ref, blockSlugs) => {
+	const match = REF.exec(ref);
+	if (!match) return ref;
+	const captured = match[1];
+	const blockSlug = findBlockSlug(captured, blockSlugs);
+	if (blockSlug) return `#/components/schemas/${blockSchemaName(blockSlug)}`;
+	return `#/components/schemas/${schemaName(captured)}`;
+};
+const rewriteRefs = (node, blockSlugs = /* @__PURE__ */ new Set(), defs = /* @__PURE__ */ new Map()) => {
+	if (Array.isArray(node)) return node.map((item) => rewriteRefs(item, blockSlugs, defs));
+	if (node && typeof node === "object") {
+		const { $ref, ...rest } = node;
+		const name = typeof $ref === "string" ? REF.exec($ref)?.[1] : void 0;
+		if (name && defs.has(name) && !findBlockSlug(name, blockSlugs)) return rewriteRefs({
+			...defs.get(name),
+			...rest
+		}, blockSlugs, defs);
+		const out = {};
+		for (const [key, value] of Object.entries(node)) out[key] = key === "$ref" && typeof value === "string" ? normalizeRef(value, blockSlugs) : rewriteRefs(value, blockSlugs, defs);
+		return out;
+	}
+	return node;
+};
+export { blockSchemaName, createSchemaName, globalSchemaName, joinsSchemaName, listSchemaName, populateSchemaName, querySchemaName, refTo, rewriteRefs, schemaName, selectSchemaName, updateSchemaName };
+
+//# sourceMappingURL=names.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","names":[],"sources":["../../../src/server/spec/names.ts"],"sourcesContent":["import { upperFirst } from '@/shared/utils.js'\n\nexport const schemaName = (slug: string): string =>\n  upperFirst(slug.replace(/-([a-z])/g, (_, c: string) => c.toUpperCase()))\n\nexport const blockSchemaName = (slug: string): string => {\n  const stripped = slug.replace(/^block[-_]?/i, '').replace(/[-_]?block$/i, '')\n  return `Block${schemaName(stripped || slug)}`\n}\n\nexport const globalSchemaName = (slug: string): string => `Global${schemaName(slug)}`\n\nexport const listSchemaName = (base: string): string => `${base}List`\nexport const createSchemaName = (base: string): string => `${base}Create`\nexport const updateSchemaName = (base: string): string => `${base}Update`\nexport const querySchemaName = (base: string): string => `${base}QueryOperations`\nexport const selectSchemaName = (base: string): string => `${base}Select`\nexport const populateSchemaName = (base: string): string => `${base}Populate`\nexport const joinsSchemaName = (base: string): string => `${base}Joins`\n\nexport const refTo = (name: string): string => `#/components/schemas/${name}`\n\ntype JsonValue = Record<string, unknown> | unknown[] | string | number | boolean | null\n\nconst REF = /^#\\/(?:definitions|\\$defs|components\\/schemas)\\/(.+)$/\n\nconst findBlockSlug = (name: string, blockSlugs: Set<string>): string | undefined =>\n  [...blockSlugs].find((s) => s === name || schemaName(s) === schemaName(name))\n\nconst normalizeRef = (ref: string, blockSlugs: Set<string>): string => {\n  const match = REF.exec(ref)\n  if (!match) return ref\n  const captured = match[1]!\n  const blockSlug = findBlockSlug(captured, blockSlugs)\n  if (blockSlug) return `#/components/schemas/${blockSchemaName(blockSlug)}`\n  return `#/components/schemas/${schemaName(captured)}`\n}\n\nexport const rewriteRefs = (\n  node: JsonValue,\n  blockSlugs: Set<string> = new Set(),\n  defs: Map<string, unknown> = new Map(),\n): JsonValue => {\n  if (Array.isArray(node)) return node.map((item) => rewriteRefs(item as JsonValue, blockSlugs, defs))\n  if (node && typeof node === 'object') {\n    const { $ref, ...rest } = node\n    const name = typeof $ref === 'string' ? REF.exec($ref)?.[1] : undefined\n    if (name && defs.has(name) && !findBlockSlug(name, blockSlugs)) {\n      return rewriteRefs({ ...(defs.get(name) as Record<string, unknown>), ...rest }, blockSlugs, defs)\n    }\n    const out: Record<string, unknown> = {}\n    for (const [key, value] of Object.entries(node)) {\n      out[key] =\n        key === '$ref' && typeof value === 'string'\n          ? normalizeRef(value, blockSlugs)\n          : rewriteRefs(value as JsonValue, blockSlugs, defs)\n    }\n    return out\n  }\n  return node\n}\n"],"mappings":";AAEA,MAAa,cAAc,SACzB,WAAW,KAAK,QAAQ,cAAc,GAAG,MAAc,EAAE,YAAY,CAAC,CAAC;AAEzE,MAAa,mBAAmB,SAAyB;CACvD,MAAM,WAAW,KAAK,QAAQ,gBAAgB,EAAE,CAAC,CAAC,QAAQ,gBAAgB,EAAE;CAC5E,OAAO,QAAQ,WAAW,YAAY,IAAI;AAC5C;AAEA,MAAa,oBAAoB,SAAyB,SAAS,WAAW,IAAI;AAElF,MAAa,kBAAkB,SAAyB,GAAG,KAAK;AAChE,MAAa,oBAAoB,SAAyB,GAAG,KAAK;AAClE,MAAa,oBAAoB,SAAyB,GAAG,KAAK;AAClE,MAAa,mBAAmB,SAAyB,GAAG,KAAK;AACjE,MAAa,oBAAoB,SAAyB,GAAG,KAAK;AAClE,MAAa,sBAAsB,SAAyB,GAAG,KAAK;AACpE,MAAa,mBAAmB,SAAyB,GAAG,KAAK;AAEjE,MAAa,SAAS,SAAyB,wBAAwB;AAIvE,MAAM,MAAM;AAEZ,MAAM,iBAAiB,MAAc,eACnC,CAAC,GAAG,UAAU,CAAC,CAAC,MAAM,MAAM,MAAM,QAAQ,WAAW,CAAC,MAAM,WAAW,IAAI,CAAC;AAE9E,MAAM,gBAAgB,KAAa,eAAoC;CACrE,MAAM,QAAQ,IAAI,KAAK,GAAG;CAC1B,IAAI,CAAC,OAAO,OAAO;CACnB,MAAM,WAAW,MAAM;CACvB,MAAM,YAAY,cAAc,UAAU,UAAU;CACpD,IAAI,WAAW,OAAO,wBAAwB,gBAAgB,SAAS;CACvE,OAAO,wBAAwB,WAAW,QAAQ;AACpD;AAEA,MAAa,eACX,MACA,6BAA0B,IAAI,IAAI,GAClC,uBAA6B,IAAI,IAAI,MACvB;CACd,IAAI,MAAM,QAAQ,IAAI,GAAG,OAAO,KAAK,KAAK,SAAS,YAAY,MAAmB,YAAY,IAAI,CAAC;CACnG,IAAI,QAAQ,OAAO,SAAS,UAAU;EACpC,MAAM,EAAE,MAAM,GAAG,SAAS;EAC1B,MAAM,OAAO,OAAO,SAAS,WAAW,IAAI,KAAK,IAAI,CAAC,GAAG,KAAK,KAAA;EAC9D,IAAI,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,cAAc,MAAM,UAAU,GAC3D,OAAO,YAAY;GAAE,GAAI,KAAK,IAAI,IAAI;GAA+B,GAAG;EAAK,GAAG,YAAY,IAAI;EAElG,MAAM,MAA+B,CAAC;EACtC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,GAC5C,IAAI,OACF,QAAQ,UAAU,OAAO,UAAU,WAC/B,aAAa,OAAO,UAAU,IAC9B,YAAY,OAAoB,YAAY,IAAI;EAExD,OAAO;CACT;CACA,OAAO;AACT"}

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

@@ -0,0 +1,57 @@
+import { BuildContext, Entity } from "../../shared/types/index.js";
+import { Field } from "payload";
+import { ParameterObject, SchemaObject } from "@scalar/openapi-types/3.2";
+export declare const buildSelectSchema: ({ fields, ctx }: {
+  fields: Field[];
+  ctx: BuildContext;
+}) => SchemaObject;
+export declare const buildPopulateSchema: ({ fields, ctx }: {
+  fields: Field[];
+  ctx: BuildContext;
+}) => SchemaObject | undefined;
+export declare const buildJoinsSchema: ({ fields, ctx }: {
+  fields: Field[];
+  ctx: BuildContext;
+}) => SchemaObject | undefined;
+export interface ParamSchemas {
+  select: SchemaObject;
+  populate?: SchemaObject;
+  joins?: SchemaObject;
+}
+export declare const buildParamSchemas: ({ fields, ctx }: {
+  fields: Field[];
+  ctx: BuildContext;
+}) => ParamSchemas;
+export declare const collectionHasFilters: (fields: Field[]) => boolean;
+export declare const buildQueryOperationsSchema: ({ base, fields, ctx }: {
+  base: string;
+  fields: Field[];
+  ctx: BuildContext;
+}) => SchemaObject;
+export interface ReadParamRefs {
+  select: boolean;
+  populate: boolean;
+  joins: boolean;
+}
+export declare const commonReadParams: ({ base, ctx, refs }: {
+  base: string;
+  ctx: BuildContext;
+  refs: ReadParamRefs;
+}) => ParameterObject[];
+export type WriteOperation = 'create' | 'update' | 'updateByID' | 'delete' | 'duplicate' | 'globalUpdate';
+export declare const writeParams: ({ base, entity, ctx, refs, operation }: {
+  base: string;
+  entity: Entity;
+  ctx: BuildContext;
+  refs: ReadParamRefs;
+  operation: WriteOperation;
+}) => ParameterObject[];
+export declare const validateParams: (ctx: BuildContext) => ParameterObject[];
+export declare const whereParam: (base: string) => ParameterObject;
+export declare const buildListParams: ({ base, fields, ctx, refs }: {
+  base: string;
+  fields: Field[];
+  ctx: BuildContext;
+  refs: ReadParamRefs;
+}) => ParameterObject[];
+//# sourceMappingURL=params.d.ts.map