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

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,12 @@
+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 filterOperations: ({ paths, slug, kind, filters }: {
+  paths: PathsObject;
+  slug?: string;
+  kind: OperationKind;
+  filters: ResolvedFilters;
+}) => Promise<PathsObject>;
+//# sourceMappingURL=filters.d.ts.map

package/dist/server/spec/filters.js

@@ -0,0 +1,91 @@
+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 ruleMatchesSlug = (rule, slug) => {
+	if (rule.slug === void 0) return true;
+	if (slug === void 0) return false;
+	return rule.slug instanceof RegExp ? rule.slug.test(slug) : rule.slug === slug;
+};
+const ruleMatches = (rule, { method, slug, kind, path }) => ruleMatchesMethod(rule, method) && ruleMatchesSlug(rule, slug) && (rule.kind === void 0 || rule.kind === kind) && (rule.path === void 0 || rule.path.test(path));
+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, 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;
+			if (await isOperationExcluded(filters, {
+				method,
+				path,
+				slug,
+				kind
+			})) delete ops[method];
+			else remaining += 1;
+		}
+		if (remaining === 0) delete paths[path];
+	}
+	return paths;
+};
+export { filterOperations, shouldIncludeCollection, shouldIncludeGlobal };
+
+//# 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 ruleMatchesSlug = (rule: OperationRule, slug: string | undefined): boolean => {\n  if (rule.slug === undefined) return true\n  if (slug === undefined) return false\n  return rule.slug instanceof RegExp ? rule.slug.test(slug) : rule.slug === slug\n}\n\nconst ruleMatches = (rule: OperationRule, { method, slug, kind, path }: OperationContext): boolean =>\n  ruleMatchesMethod(rule, method) &&\n  ruleMatchesSlug(rule, slug) &&\n  (rule.kind === undefined || rule.kind === kind) &&\n  (rule.path === undefined || rule.path.test(path))\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  filters,\n}: {\n  paths: PathsObject\n  slug?: string\n  kind: OperationKind\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      if (await isOperationExcluded(filters, { method, path, slug, kind })) {\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,38 @@
+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 read = schemas[base]?.properties;
+	for (const [name, description] of Object.entries(pathFields)) {
+		if (read?.[name]) read[name] = {
+			...read[name],
+			readOnly: true,
+			description
+		};
+		for (const other of [
+			createSchemaName(base),
+			updateSchemaName(base),
+			querySchemaName(base)
+		]) delete schemas[other]?.properties?.[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 read = schemas[base]?.properties\n  for (const [name, description] of Object.entries(pathFields)) {\n    if (read?.[name]) read[name] = { ...read[name], readOnly: true, description }\n    for (const other of [createSchemaName(base), updateSchemaName(base), querySchemaName(base)]) {\n      delete schemas[other]?.properties?.[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,OAAO,QAAQ,KAAK,EAAE;CAC5B,KAAK,MAAM,CAAC,MAAM,gBAAgB,OAAO,QAAQ,UAAU,GAAG;EAC5D,IAAI,OAAO,OAAO,KAAK,QAAQ;GAAE,GAAG,KAAK;GAAO,UAAU;GAAM;EAAY;EAC5E,KAAK,MAAM,SAAS;GAAC,iBAAiB,IAAI;GAAG,iBAAiB,IAAI;GAAG,gBAAgB,IAAI;EAAC,GACxF,OAAO,QAAQ,MAAM,EAAE,aAAa;CAExC;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