@focus-reactive/payload-plugin-translator 0.1.0

package/dist/server/shared/access/AnyAccessGuard.js

@@ -0,0 +1,9 @@
+/**
+ * Default access guard that allows all requests
+ */ export class AnyAccessGuard {
+    async check() {
+        return true;
+    }
+}
+
+//# sourceMappingURL=AnyAccessGuard.js.map

package/dist/server/shared/access/AnyAccessGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/shared/access/AnyAccessGuard.ts"],"sourcesContent":["import type { AccessGuard } from './types'\n\n/**\n * Default access guard that allows all requests\n */\nexport class AnyAccessGuard implements AccessGuard {\n  async check(): Promise<boolean> {\n    return true\n  }\n}\n"],"names":["AnyAccessGuard","check"],"mappings":"AAEA;;CAEC,GACD,OAAO,MAAMA;IACX,MAAMC,QAA0B;QAC9B,OAAO;IACT;AACF"}

package/dist/server/shared/access/handler.d.ts

@@ -0,0 +1,8 @@
+import { Payload } from 'payload';
+/**
+ * Base handler interface for all feature handlers
+ */
+export interface Handler<TInput, TOutput> {
+    handle(payload: Payload, input: TInput): Promise<TOutput>;
+}
+//# sourceMappingURL=handler.d.ts.map

package/dist/server/shared/access/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/access/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC;;GAEG;AACH,MAAM,WAAW,OAAO,CAAC,MAAM,EAAE,OAAO;IACtC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC1D"}

package/dist/server/shared/access/handler.js

@@ -0,0 +1,5 @@
+/**
+ * Base handler interface for all feature handlers
+ */ export { };
+
+//# sourceMappingURL=handler.js.map

package/dist/server/shared/access/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/shared/access/handler.ts"],"sourcesContent":["import { Payload } from 'payload'\n\n/**\n * Base handler interface for all feature handlers\n */\nexport interface Handler<TInput, TOutput> {\n  handle(payload: Payload, input: TInput): Promise<TOutput>\n}\n"],"names":[],"mappings":"AAEA;;CAEC,GACD,WAEC"}

package/dist/server/shared/access/index.d.ts

@@ -0,0 +1,4 @@
+export type { AccessGuard, AccessGuardRequest } from './types';
+export { AnyAccessGuard } from './AnyAccessGuard';
+export type { Handler } from './handler';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/shared/access/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/access/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA"}

package/dist/server/shared/access/index.js

@@ -0,0 +1,3 @@
+export { AnyAccessGuard } from './AnyAccessGuard';
+
+//# sourceMappingURL=index.js.map

package/dist/server/shared/access/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/shared/access/index.ts"],"sourcesContent":["export type { AccessGuard, AccessGuardRequest } from './types'\nexport { AnyAccessGuard } from './AnyAccessGuard'\nexport type { Handler } from './handler'\n"],"names":["AnyAccessGuard"],"mappings":"AACA,SAASA,cAAc,QAAQ,mBAAkB"}

package/dist/server/shared/access/types.d.ts

@@ -0,0 +1,2 @@
+export type { AccessGuard, AccessGuardRequest } from '../../../types/AccessGuard';
+//# sourceMappingURL=types.d.ts.map

package/dist/server/shared/access/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/access/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/server/shared/access/types.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=types.js.map

package/dist/server/shared/access/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/shared/access/types.ts"],"sourcesContent":["export type { AccessGuard, AccessGuardRequest } from '../../../types/AccessGuard'\n"],"names":[],"mappings":"AAAA,WAAiF"}

package/dist/server/shared/field-config/getFieldConfig.d.ts

@@ -0,0 +1,21 @@
+import type { Field } from 'payload';
+import type { FieldTranslationConfig } from './types';
+/**
+ * Extract translation configuration from a Payload field.
+ *
+ * @param field - The Payload field to extract config from
+ * @returns The translation configuration, or empty object if not defined
+ */
+export declare function getFieldTranslationConfig(field: Field): FieldTranslationConfig;
+/**
+ * @deprecated Use `getFieldTranslationConfig` instead
+ */
+export declare const getTranslateKitFieldConfig: typeof getFieldTranslationConfig;
+/**
+ * Check if a field should be excluded from translation.
+ *
+ * @param field - The Payload field to check
+ * @returns true if the field has `translateKit.exclude: true`
+ */
+export declare function isFieldExcludedFromTranslation(field: Field): boolean;
+//# sourceMappingURL=getFieldConfig.d.ts.map

package/dist/server/shared/field-config/getFieldConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFieldConfig.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/field-config/getFieldConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAGrD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,GAAG,sBAAsB,CAY9E;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,kCAA4B,CAAA;AAEnE;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEpE"}

package/dist/server/shared/field-config/getFieldConfig.js

@@ -0,0 +1,29 @@
+import { TRANSLATE_KIT_CUSTOM_KEY } from './types';
+/**
+ * Extract translation configuration from a Payload field.
+ *
+ * @param field - The Payload field to extract config from
+ * @returns The translation configuration, or empty object if not defined
+ */ export function getFieldTranslationConfig(field) {
+    if (!field.custom || typeof field.custom !== 'object') {
+        return {};
+    }
+    const config = field.custom[TRANSLATE_KIT_CUSTOM_KEY];
+    if (!config || typeof config !== 'object') {
+        return {};
+    }
+    return config;
+}
+/**
+ * @deprecated Use `getFieldTranslationConfig` instead
+ */ export const getTranslateKitFieldConfig = getFieldTranslationConfig;
+/**
+ * Check if a field should be excluded from translation.
+ *
+ * @param field - The Payload field to check
+ * @returns true if the field has `translateKit.exclude: true`
+ */ export function isFieldExcludedFromTranslation(field) {
+    return getFieldTranslationConfig(field).exclude === true;
+}
+
+//# sourceMappingURL=getFieldConfig.js.map

package/dist/server/shared/field-config/getFieldConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/shared/field-config/getFieldConfig.ts"],"sourcesContent":["import type { Field } from 'payload'\n\nimport type { FieldTranslationConfig } from './types'\nimport { TRANSLATE_KIT_CUSTOM_KEY } from './types'\n\n/**\n * Extract translation configuration from a Payload field.\n *\n * @param field - The Payload field to extract config from\n * @returns The translation configuration, or empty object if not defined\n */\nexport function getFieldTranslationConfig(field: Field): FieldTranslationConfig {\n  if (!field.custom || typeof field.custom !== 'object') {\n    return {}\n  }\n\n  const config = (field.custom as Record<string, unknown>)[TRANSLATE_KIT_CUSTOM_KEY]\n\n  if (!config || typeof config !== 'object') {\n    return {}\n  }\n\n  return config as FieldTranslationConfig\n}\n\n/**\n * @deprecated Use `getFieldTranslationConfig` instead\n */\nexport const getTranslateKitFieldConfig = getFieldTranslationConfig\n\n/**\n * Check if a field should be excluded from translation.\n *\n * @param field - The Payload field to check\n * @returns true if the field has `translateKit.exclude: true`\n */\nexport function isFieldExcludedFromTranslation(field: Field): boolean {\n  return getFieldTranslationConfig(field).exclude === true\n}\n"],"names":["TRANSLATE_KIT_CUSTOM_KEY","getFieldTranslationConfig","field","custom","config","getTranslateKitFieldConfig","isFieldExcludedFromTranslation","exclude"],"mappings":"AAGA,SAASA,wBAAwB,QAAQ,UAAS;AAElD;;;;;CAKC,GACD,OAAO,SAASC,0BAA0BC,KAAY;IACpD,IAAI,CAACA,MAAMC,MAAM,IAAI,OAAOD,MAAMC,MAAM,KAAK,UAAU;QACrD,OAAO,CAAC;IACV;IAEA,MAAMC,SAAS,AAACF,MAAMC,MAAM,AAA4B,CAACH,yBAAyB;IAElF,IAAI,CAACI,UAAU,OAAOA,WAAW,UAAU;QACzC,OAAO,CAAC;IACV;IAEA,OAAOA;AACT;AAEA;;CAEC,GACD,OAAO,MAAMC,6BAA6BJ,0BAAyB;AAEnE;;;;;CAKC,GACD,OAAO,SAASK,+BAA+BJ,KAAY;IACzD,OAAOD,0BAA0BC,OAAOK,OAAO,KAAK;AACtD"}

package/dist/server/shared/field-config/getFieldConfig.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getFieldConfig.test.d.ts.map

package/dist/server/shared/field-config/getFieldConfig.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFieldConfig.test.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/field-config/getFieldConfig.test.ts"],"names":[],"mappings":""}

package/dist/server/shared/field-config/getFieldConfig.test.js

@@ -0,0 +1,74 @@
+import { describe, it, expect } from 'vitest';
+import { getTranslateKitFieldConfig, isFieldExcludedFromTranslation } from './getFieldConfig';
+describe('getTranslateKitFieldConfig', () => {
+    it('returns empty object when field has no custom property', () => {
+        const field = { name: 'title', type: 'text' };
+        expect(getTranslateKitFieldConfig(field)).toEqual({});
+    });
+    it('returns empty object when custom is not an object', () => {
+        const field = { name: 'title', type: 'text', custom: 'string' };
+        expect(getTranslateKitFieldConfig(field)).toEqual({});
+    });
+    it('returns empty object when translateKit key is missing', () => {
+        const field = { name: 'title', type: 'text', custom: { other: true } };
+        expect(getTranslateKitFieldConfig(field)).toEqual({});
+    });
+    it('returns empty object when translateKit is not an object', () => {
+        const field = { name: 'title', type: 'text', custom: { translateKit: 'string' } };
+        expect(getTranslateKitFieldConfig(field)).toEqual({});
+    });
+    it('returns config when translateKit is defined', () => {
+        const field = {
+            name: 'sku',
+            type: 'text',
+            custom: { translateKit: { exclude: true } },
+        };
+        expect(getTranslateKitFieldConfig(field)).toEqual({ exclude: true });
+    });
+    it('returns config with exclude: false', () => {
+        const field = {
+            name: 'title',
+            type: 'text',
+            custom: { translateKit: { exclude: false } },
+        };
+        expect(getTranslateKitFieldConfig(field)).toEqual({ exclude: false });
+    });
+});
+describe('isFieldExcludedFromTranslation', () => {
+    it('returns false when field has no custom property', () => {
+        const field = { name: 'title', type: 'text' };
+        expect(isFieldExcludedFromTranslation(field)).toBe(false);
+    });
+    it('returns false when translateKit is not defined', () => {
+        const field = { name: 'title', type: 'text', custom: { other: true } };
+        expect(isFieldExcludedFromTranslation(field)).toBe(false);
+    });
+    it('returns false when exclude is not defined', () => {
+        const field = { name: 'title', type: 'text', custom: { translateKit: {} } };
+        expect(isFieldExcludedFromTranslation(field)).toBe(false);
+    });
+    it('returns false when exclude is false', () => {
+        const field = {
+            name: 'title',
+            type: 'text',
+            custom: { translateKit: { exclude: false } },
+        };
+        expect(isFieldExcludedFromTranslation(field)).toBe(false);
+    });
+    it('returns true when exclude is true', () => {
+        const field = {
+            name: 'sku',
+            type: 'text',
+            custom: { translateKit: { exclude: true } },
+        };
+        expect(isFieldExcludedFromTranslation(field)).toBe(true);
+    });
+    it('returns false when exclude is truthy but not true', () => {
+        const field = {
+            name: 'sku',
+            type: 'text',
+            custom: { translateKit: { exclude: 1 } },
+        };
+        expect(isFieldExcludedFromTranslation(field)).toBe(false);
+    });
+});

package/dist/server/shared/field-config/index.d.ts

@@ -0,0 +1,4 @@
+export { getFieldTranslationConfig, getTranslateKitFieldConfig, isFieldExcludedFromTranslation } from './getFieldConfig';
+export { TRANSLATE_KIT_CUSTOM_KEY } from './types';
+export type { FieldTranslationConfig, TranslateKitFieldConfig } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/shared/field-config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/field-config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAA;AACxH,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAClD,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA"}

package/dist/server/shared/field-config/index.js

@@ -0,0 +1,4 @@
+export { getFieldTranslationConfig, getTranslateKitFieldConfig, isFieldExcludedFromTranslation } from './getFieldConfig';
+export { TRANSLATE_KIT_CUSTOM_KEY } from './types';
+
+//# sourceMappingURL=index.js.map

package/dist/server/shared/field-config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/shared/field-config/index.ts"],"sourcesContent":["export { getFieldTranslationConfig, getTranslateKitFieldConfig, isFieldExcludedFromTranslation } from './getFieldConfig'\nexport { TRANSLATE_KIT_CUSTOM_KEY } from './types'\nexport type { FieldTranslationConfig, TranslateKitFieldConfig } from './types'\n"],"names":["getFieldTranslationConfig","getTranslateKitFieldConfig","isFieldExcludedFromTranslation","TRANSLATE_KIT_CUSTOM_KEY"],"mappings":"AAAA,SAASA,yBAAyB,EAAEC,0BAA0B,EAAEC,8BAA8B,QAAQ,mBAAkB;AACxH,SAASC,wBAAwB,QAAQ,UAAS"}

package/dist/server/shared/field-config/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Configuration options for field translation customization.
+ * These options are set via the field's `custom` property.
+ *
+ * @example
+ * ```ts
+ * {
+ *   name: 'sku',
+ *   type: 'text',
+ *   localized: true,
+ *   custom: {
+ *     translateKit: {
+ *       exclude: true,
+ *     },
+ *   },
+ * }
+ * ```
+ */
+export interface FieldTranslationConfig {
+    /**
+     * When true, this field will be excluded from translation.
+     * The field value will not be sent to the translation provider.
+     *
+     * Useful for fields that contain non-translatable content like:
+     * - SKU codes
+     * - Technical identifiers
+     * - Numeric values that should remain unchanged
+     */
+    exclude?: boolean;
+}
+/**
+ * @deprecated Use `FieldTranslationConfig` instead
+ */
+export type TranslateKitFieldConfig = FieldTranslationConfig;
+/**
+ * Key used to store TranslateKit configuration in field.custom
+ */
+export declare const TRANSLATE_KIT_CUSTOM_KEY: "translateKit";
+//# sourceMappingURL=types.d.ts.map

package/dist/server/shared/field-config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/field-config/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,CAAA;AAE5D;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAG,cAAuB,CAAA"}

package/dist/server/shared/field-config/types.js

@@ -0,0 +1,22 @@
+/**
+ * Configuration options for field translation customization.
+ * These options are set via the field's `custom` property.
+ *
+ * @example
+ * ```ts
+ * {
+ *   name: 'sku',
+ *   type: 'text',
+ *   localized: true,
+ *   custom: {
+ *     translateKit: {
+ *       exclude: true,
+ *     },
+ *   },
+ * }
+ * ```
+ */ /**
+ * Key used to store TranslateKit configuration in field.custom
+ */ export const TRANSLATE_KIT_CUSTOM_KEY = 'translateKit';
+
+//# sourceMappingURL=types.js.map

package/dist/server/shared/field-config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/shared/field-config/types.ts"],"sourcesContent":["/**\n * Configuration options for field translation customization.\n * These options are set via the field's `custom` property.\n *\n * @example\n * ```ts\n * {\n *   name: 'sku',\n *   type: 'text',\n *   localized: true,\n *   custom: {\n *     translateKit: {\n *       exclude: true,\n *     },\n *   },\n * }\n * ```\n */\nexport interface FieldTranslationConfig {\n  /**\n   * When true, this field will be excluded from translation.\n   * The field value will not be sent to the translation provider.\n   *\n   * Useful for fields that contain non-translatable content like:\n   * - SKU codes\n   * - Technical identifiers\n   * - Numeric values that should remain unchanged\n   */\n  exclude?: boolean\n}\n\n/**\n * @deprecated Use `FieldTranslationConfig` instead\n */\nexport type TranslateKitFieldConfig = FieldTranslationConfig\n\n/**\n * Key used to store TranslateKit configuration in field.custom\n */\nexport const TRANSLATE_KIT_CUSTOM_KEY = 'translateKit' as const\n"],"names":["TRANSLATE_KIT_CUSTOM_KEY"],"mappings":"AAAA;;;;;;;;;;;;;;;;;CAiBC,GAmBD;;CAEC,GACD,OAAO,MAAMA,2BAA2B,eAAuB"}

package/dist/server/shared/guards/collection-guards.d.ts

@@ -0,0 +1,7 @@
+import type { CollectionConfig, SanitizedCollectionConfig } from 'payload';
+/**
+ * Checks if a collection has drafts enabled.
+ * Handles both CollectionConfig and SanitizedCollectionConfig.
+ */
+export declare function collectionHasDrafts(collection: CollectionConfig | SanitizedCollectionConfig): boolean;
+//# sourceMappingURL=collection-guards.d.ts.map

package/dist/server/shared/guards/collection-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-guards.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/guards/collection-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AAW1E;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,gBAAgB,GAAG,yBAAyB,GAAG,OAAO,CAOrG"}

package/dist/server/shared/guards/collection-guards.js

@@ -0,0 +1,16 @@
+/**
+ * Type guard: Checks if versions config is an object (not boolean).
+ */ function isVersionsObject(versions) {
+    return typeof versions === 'object' && versions !== null;
+}
+/**
+ * Checks if a collection has drafts enabled.
+ * Handles both CollectionConfig and SanitizedCollectionConfig.
+ */ export function collectionHasDrafts(collection) {
+    const { versions } = collection;
+    if (!versions) return false;
+    if (!isVersionsObject(versions)) return false;
+    return 'drafts' in versions && Boolean(versions.drafts);
+}
+
+//# sourceMappingURL=collection-guards.js.map

package/dist/server/shared/guards/collection-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/shared/guards/collection-guards.ts"],"sourcesContent":["import type { CollectionConfig, SanitizedCollectionConfig } from 'payload'\n\ntype VersionsConfig = CollectionConfig['versions']\n\n/**\n * Type guard: Checks if versions config is an object (not boolean).\n */\nfunction isVersionsObject(versions: VersionsConfig): versions is Exclude<VersionsConfig, boolean | undefined> {\n  return typeof versions === 'object' && versions !== null\n}\n\n/**\n * Checks if a collection has drafts enabled.\n * Handles both CollectionConfig and SanitizedCollectionConfig.\n */\nexport function collectionHasDrafts(collection: CollectionConfig | SanitizedCollectionConfig): boolean {\n  const { versions } = collection\n\n  if (!versions) return false\n  if (!isVersionsObject(versions)) return false\n\n  return 'drafts' in versions && Boolean(versions.drafts)\n}\n"],"names":["isVersionsObject","versions","collectionHasDrafts","collection","Boolean","drafts"],"mappings":"AAIA;;CAEC,GACD,SAASA,iBAAiBC,QAAwB;IAChD,OAAO,OAAOA,aAAa,YAAYA,aAAa;AACtD;AAEA;;;CAGC,GACD,OAAO,SAASC,oBAAoBC,UAAwD;IAC1F,MAAM,EAAEF,QAAQ,EAAE,GAAGE;IAErB,IAAI,CAACF,UAAU,OAAO;IACtB,IAAI,CAACD,iBAAiBC,WAAW,OAAO;IAExC,OAAO,YAAYA,YAAYG,QAAQH,SAASI,MAAM;AACxD"}

package/dist/server/shared/guards/field-guards.d.ts

@@ -0,0 +1,37 @@
+import type { Field, RichTextField, TabsField, TextareaField, TextField } from 'payload';
+/** Translatable field types that contain text content */
+export type TranslatableField = RichTextField | TextareaField | TextField;
+/**
+ * Type guard: Checks if a field contains translatable text content (text, textarea, richText).
+ */
+export declare function isTranslatableField(field: Field): field is TranslatableField;
+/**
+ * Type guard: Checks if a field has the `localized` property set to true.
+ */
+export declare function isLocalizedField(field: Field): field is Field & {
+    localized: true;
+};
+/**
+ * Type guard: Checks if a field is a relationship or upload field (should be skipped).
+ */
+export declare function isRelationshipField(field: Field): field is Field & {
+    relationTo: unknown;
+};
+/**
+ * Type guard: Checks if a field is a tabs field.
+ */
+export declare function isTabsField(field: Field): field is TabsField;
+/**
+ * Type guard: Checks if value is a block item (has blockType property).
+ */
+export declare function isBlockItem(value: unknown): value is Record<string, unknown> & {
+    blockType: string;
+};
+/**
+ * Type guard: Checks if value has a fields array property.
+ * Works with Field, Tab, or any object with fields.
+ */
+export declare function hasFields(value: unknown): value is {
+    fields: Field[];
+};
+//# sourceMappingURL=field-guards.d.ts.map

package/dist/server/shared/guards/field-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-guards.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/guards/field-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAIxF,yDAAyD;AACzD,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,aAAa,GAAG,SAAS,CAAA;AAEzE;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,IAAI,iBAAiB,CAE5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,IAAI,KAAK,GAAG;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE,CAEnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,IAAI,KAAK,GAAG;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,CAE1F;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,IAAI,SAAS,CAE5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAEpG;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,MAAM,EAAE,KAAK,EAAE,CAAA;CAAE,CAEtE"}

package/dist/server/shared/guards/field-guards.js

@@ -0,0 +1,34 @@
+import { isObject } from '../utils';
+/**
+ * Type guard: Checks if a field contains translatable text content (text, textarea, richText).
+ */ export function isTranslatableField(field) {
+    return field.type === 'text' || field.type === 'textarea' || field.type === 'richText';
+}
+/**
+ * Type guard: Checks if a field has the `localized` property set to true.
+ */ export function isLocalizedField(field) {
+    return 'localized' in field && field.localized === true;
+}
+/**
+ * Type guard: Checks if a field is a relationship or upload field (should be skipped).
+ */ export function isRelationshipField(field) {
+    return 'relationTo' in field && field.relationTo !== undefined;
+}
+/**
+ * Type guard: Checks if a field is a tabs field.
+ */ export function isTabsField(field) {
+    return field.type === 'tabs';
+}
+/**
+ * Type guard: Checks if value is a block item (has blockType property).
+ */ export function isBlockItem(value) {
+    return isObject(value) && 'blockType' in value && typeof value.blockType === 'string';
+}
+/**
+ * Type guard: Checks if value has a fields array property.
+ * Works with Field, Tab, or any object with fields.
+ */ export function hasFields(value) {
+    return isObject(value) && 'fields' in value && Array.isArray(value.fields);
+}
+
+//# sourceMappingURL=field-guards.js.map

package/dist/server/shared/guards/field-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/shared/guards/field-guards.ts"],"sourcesContent":["import type { Field, RichTextField, TabsField, TextareaField, TextField } from 'payload'\n\nimport { isObject } from '../utils'\n\n/** Translatable field types that contain text content */\nexport type TranslatableField = RichTextField | TextareaField | TextField\n\n/**\n * Type guard: Checks if a field contains translatable text content (text, textarea, richText).\n */\nexport function isTranslatableField(field: Field): field is TranslatableField {\n  return field.type === 'text' || field.type === 'textarea' || field.type === 'richText'\n}\n\n/**\n * Type guard: Checks if a field has the `localized` property set to true.\n */\nexport function isLocalizedField(field: Field): field is Field & { localized: true } {\n  return 'localized' in field && field.localized === true\n}\n\n/**\n * Type guard: Checks if a field is a relationship or upload field (should be skipped).\n */\nexport function isRelationshipField(field: Field): field is Field & { relationTo: unknown } {\n  return 'relationTo' in field && field.relationTo !== undefined\n}\n\n/**\n * Type guard: Checks if a field is a tabs field.\n */\nexport function isTabsField(field: Field): field is TabsField {\n  return field.type === 'tabs'\n}\n\n/**\n * Type guard: Checks if value is a block item (has blockType property).\n */\nexport function isBlockItem(value: unknown): value is Record<string, unknown> & { blockType: string } {\n  return isObject(value) && 'blockType' in value && typeof value.blockType === 'string'\n}\n\n/**\n * Type guard: Checks if value has a fields array property.\n * Works with Field, Tab, or any object with fields.\n */\nexport function hasFields(value: unknown): value is { fields: Field[] } {\n  return isObject(value) && 'fields' in value && Array.isArray(value.fields)\n}\n"],"names":["isObject","isTranslatableField","field","type","isLocalizedField","localized","isRelationshipField","relationTo","undefined","isTabsField","isBlockItem","value","blockType","hasFields","Array","isArray","fields"],"mappings":"AAEA,SAASA,QAAQ,QAAQ,WAAU;AAKnC;;CAEC,GACD,OAAO,SAASC,oBAAoBC,KAAY;IAC9C,OAAOA,MAAMC,IAAI,KAAK,UAAUD,MAAMC,IAAI,KAAK,cAAcD,MAAMC,IAAI,KAAK;AAC9E;AAEA;;CAEC,GACD,OAAO,SAASC,iBAAiBF,KAAY;IAC3C,OAAO,eAAeA,SAASA,MAAMG,SAAS,KAAK;AACrD;AAEA;;CAEC,GACD,OAAO,SAASC,oBAAoBJ,KAAY;IAC9C,OAAO,gBAAgBA,SAASA,MAAMK,UAAU,KAAKC;AACvD;AAEA;;CAEC,GACD,OAAO,SAASC,YAAYP,KAAY;IACtC,OAAOA,MAAMC,IAAI,KAAK;AACxB;AAEA;;CAEC,GACD,OAAO,SAASO,YAAYC,KAAc;IACxC,OAAOX,SAASW,UAAU,eAAeA,SAAS,OAAOA,MAAMC,SAAS,KAAK;AAC/E;AAEA;;;CAGC,GACD,OAAO,SAASC,UAAUF,KAAc;IACtC,OAAOX,SAASW,UAAU,YAAYA,SAASG,MAAMC,OAAO,CAACJ,MAAMK,MAAM;AAC3E"}

package/dist/server/shared/guards/field-guards.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=field-guards.test.d.ts.map

package/dist/server/shared/guards/field-guards.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-guards.test.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/guards/field-guards.test.ts"],"names":[],"mappings":""}

package/dist/server/shared/guards/field-guards.test.js

@@ -0,0 +1,166 @@
+import { describe, it, expect } from 'vitest';
+import { isTranslatableField, isLocalizedField, isRelationshipField, isTabsField, isBlockItem, hasFields, } from './field-guards';
+describe('field-guards', () => {
+    describe('isTranslatableField', () => {
+        it('returns true for text field', () => {
+            const field = { name: 'title', type: 'text' };
+            expect(isTranslatableField(field)).toBe(true);
+        });
+        it('returns true for textarea field', () => {
+            const field = { name: 'description', type: 'textarea' };
+            expect(isTranslatableField(field)).toBe(true);
+        });
+        it('returns true for richText field', () => {
+            const field = { name: 'content', type: 'richText' };
+            expect(isTranslatableField(field)).toBe(true);
+        });
+        it('returns false for select field', () => {
+            const field = { name: 'status', type: 'select', options: ['draft', 'published'] };
+            expect(isTranslatableField(field)).toBe(false);
+        });
+        it('returns false for number field', () => {
+            const field = { name: 'price', type: 'number' };
+            expect(isTranslatableField(field)).toBe(false);
+        });
+        it('returns false for checkbox field', () => {
+            const field = { name: 'active', type: 'checkbox' };
+            expect(isTranslatableField(field)).toBe(false);
+        });
+        it('returns false for date field', () => {
+            const field = { name: 'createdAt', type: 'date' };
+            expect(isTranslatableField(field)).toBe(false);
+        });
+        it('returns false for email field', () => {
+            const field = { name: 'email', type: 'email' };
+            expect(isTranslatableField(field)).toBe(false);
+        });
+        it('returns false for relationship field', () => {
+            const field = { name: 'author', type: 'relationship', relationTo: 'users' };
+            expect(isTranslatableField(field)).toBe(false);
+        });
+        it('returns false for upload field', () => {
+            const field = { name: 'image', type: 'upload', relationTo: 'media' };
+            expect(isTranslatableField(field)).toBe(false);
+        });
+        it('returns false for array field', () => {
+            const field = { name: 'items', type: 'array', fields: [] };
+            expect(isTranslatableField(field)).toBe(false);
+        });
+        it('returns false for group field', () => {
+            const field = { name: 'meta', type: 'group', fields: [] };
+            expect(isTranslatableField(field)).toBe(false);
+        });
+        it('returns false for blocks field', () => {
+            const field = { name: 'layout', type: 'blocks', blocks: [] };
+            expect(isTranslatableField(field)).toBe(false);
+        });
+    });
+    describe('isLocalizedField', () => {
+        it('returns true for field with localized: true', () => {
+            const field = { name: 'title', type: 'text', localized: true };
+            expect(isLocalizedField(field)).toBe(true);
+        });
+        it('returns false for field with localized: false', () => {
+            const field = { name: 'title', type: 'text', localized: false };
+            expect(isLocalizedField(field)).toBe(false);
+        });
+        it('returns false for field without localized property', () => {
+            const field = { name: 'title', type: 'text' };
+            expect(isLocalizedField(field)).toBe(false);
+        });
+        it('works with different field types', () => {
+            const textField = { name: 'title', type: 'text', localized: true };
+            const numberField = { name: 'price', type: 'number', localized: true };
+            const selectField = { name: 'status', type: 'select', options: [], localized: true };
+            expect(isLocalizedField(textField)).toBe(true);
+            expect(isLocalizedField(numberField)).toBe(true);
+            expect(isLocalizedField(selectField)).toBe(true);
+        });
+    });
+    describe('isRelationshipField', () => {
+        it('returns true for relationship field', () => {
+            const field = { name: 'author', type: 'relationship', relationTo: 'users' };
+            expect(isRelationshipField(field)).toBe(true);
+        });
+        it('returns true for upload field (has relationTo)', () => {
+            const field = { name: 'image', type: 'upload', relationTo: 'media' };
+            expect(isRelationshipField(field)).toBe(true);
+        });
+        it('returns true for relationship with multiple collections', () => {
+            const field = { name: 'ref', type: 'relationship', relationTo: ['users', 'posts'] };
+            expect(isRelationshipField(field)).toBe(true);
+        });
+        it('returns false for text field', () => {
+            const field = { name: 'title', type: 'text' };
+            expect(isRelationshipField(field)).toBe(false);
+        });
+        it('returns false for array field', () => {
+            const field = { name: 'items', type: 'array', fields: [] };
+            expect(isRelationshipField(field)).toBe(false);
+        });
+    });
+    describe('isTabsField', () => {
+        it('returns true for tabs field', () => {
+            const field = {
+                type: 'tabs',
+                tabs: [{ name: 'general', label: 'General', fields: [] }],
+            };
+            expect(isTabsField(field)).toBe(true);
+        });
+        it('returns false for group field', () => {
+            const field = { name: 'meta', type: 'group', fields: [] };
+            expect(isTabsField(field)).toBe(false);
+        });
+        it('returns false for text field', () => {
+            const field = { name: 'title', type: 'text' };
+            expect(isTabsField(field)).toBe(false);
+        });
+    });
+    describe('isBlockItem', () => {
+        it('returns true for object with blockType string', () => {
+            expect(isBlockItem({ blockType: 'hero' })).toBe(true);
+            expect(isBlockItem({ blockType: 'content', title: 'Hello' })).toBe(true);
+        });
+        it('returns false for object without blockType', () => {
+            expect(isBlockItem({ title: 'Hello' })).toBe(false);
+            expect(isBlockItem({})).toBe(false);
+        });
+        it('returns false for object with non-string blockType', () => {
+            expect(isBlockItem({ blockType: 123 })).toBe(false);
+            expect(isBlockItem({ blockType: null })).toBe(false);
+            expect(isBlockItem({ blockType: undefined })).toBe(false);
+        });
+        it('returns false for non-objects', () => {
+            expect(isBlockItem(null)).toBe(false);
+            expect(isBlockItem(undefined)).toBe(false);
+            expect(isBlockItem('string')).toBe(false);
+            expect(isBlockItem(123)).toBe(false);
+            expect(isBlockItem([])).toBe(false);
+        });
+    });
+    describe('hasFields', () => {
+        it('returns true for object with fields array', () => {
+            expect(hasFields({ fields: [] })).toBe(true);
+            expect(hasFields({ fields: [{ name: 'title', type: 'text' }] })).toBe(true);
+        });
+        it('returns true for Field objects with fields', () => {
+            const groupField = { name: 'meta', type: 'group', fields: [] };
+            expect(hasFields(groupField)).toBe(true);
+        });
+        it('returns false for object without fields', () => {
+            expect(hasFields({ name: 'title' })).toBe(false);
+            expect(hasFields({})).toBe(false);
+        });
+        it('returns false for object with non-array fields', () => {
+            expect(hasFields({ fields: 'not-array' })).toBe(false);
+            expect(hasFields({ fields: {} })).toBe(false);
+            expect(hasFields({ fields: null })).toBe(false);
+        });
+        it('returns false for non-objects', () => {
+            expect(hasFields(null)).toBe(false);
+            expect(hasFields(undefined)).toBe(false);
+            expect(hasFields('string')).toBe(false);
+            expect(hasFields(123)).toBe(false);
+        });
+    });
+});

package/dist/server/shared/guards/index.d.ts

@@ -0,0 +1,4 @@
+export type { TranslatableField } from './field-guards';
+export { isTranslatableField, isLocalizedField, isRelationshipField, isTabsField, isBlockItem, hasFields, } from './field-guards';
+export { collectionHasDrafts } from './collection-guards';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/shared/guards/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/shared/guards/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,SAAS,GACV,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/server/shared/guards/index.js

@@ -0,0 +1,4 @@
+export { isTranslatableField, isLocalizedField, isRelationshipField, isTabsField, isBlockItem, hasFields } from './field-guards';
+export { collectionHasDrafts } from './collection-guards';
+
+//# sourceMappingURL=index.js.map

package/dist/server/shared/guards/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/shared/guards/index.ts"],"sourcesContent":["export type { TranslatableField } from './field-guards'\nexport {\n  isTranslatableField,\n  isLocalizedField,\n  isRelationshipField,\n  isTabsField,\n  isBlockItem,\n  hasFields,\n} from './field-guards'\nexport { collectionHasDrafts } from './collection-guards'\n"],"names":["isTranslatableField","isLocalizedField","isRelationshipField","isTabsField","isBlockItem","hasFields","collectionHasDrafts"],"mappings":"AACA,SACEA,mBAAmB,EACnBC,gBAAgB,EAChBC,mBAAmB,EACnBC,WAAW,EACXC,WAAW,EACXC,SAAS,QACJ,iBAAgB;AACvB,SAASC,mBAAmB,QAAQ,sBAAqB"}