@questpie/admin 1.1.1 → 3.0.0

package/dist/server/fields/rich-text.d.mts

@@ -0,0 +1,68 @@
+import { DefaultFieldState, Field } from "questpie";
+import { PgJsonbBuilder } from "drizzle-orm/pg-core";
+
+//#region src/server/fields/rich-text.d.ts
+
+/**
+ * TipTap node type.
+ * Represents a single node in the document tree.
+ */
+interface TipTapNode {
+  type: string;
+  attrs?: Record<string, any>;
+  content?: TipTapNode[];
+  marks?: Array<{
+    type: string;
+    attrs?: Record<string, any>;
+  }>;
+  text?: string;
+}
+/**
+ * TipTap document structure.
+ * Root node always has type "doc".
+ */
+interface TipTapDocument {
+  type: "doc";
+  content?: TipTapNode[];
+}
+/**
+ * Rich text field metadata - augmentable by external packages.
+ *
+ * @example Admin augmentation:
+ * ```ts
+ * declare module "@questpie/admin/server" {
+ *   interface RichTextFieldMeta {
+ *     admin?: {
+ *       placeholder?: string;
+ *       showCharacterCount?: boolean;
+ *     }
+ *   }
+ * }
+ * ```
+ */
+interface RichTextFieldMeta {
+  /** Phantom property to prevent interface collapse - enables module augmentation */
+  _?: never;
+}
+/**
+ * Available rich text editor features.
+ */
+type RichTextFeature = "bold" | "italic" | "underline" | "strike" | "code" | "subscript" | "superscript" | "heading" | "bulletList" | "orderedList" | "taskList" | "blockquote" | "codeBlock" | "horizontalRule" | "link" | "image" | "table" | "textAlign" | "textColor" | "highlight" | "mention";
+/**
+ * Rich text field factory.
+ * Creates a TipTap-based rich text editor field.
+ *
+ * @example
+ * ```ts
+ * // In collection fields callback:
+ * content: f.richText().required().localized()
+ * ```
+ */
+type RichTextFieldState = DefaultFieldState & {
+  type: "richText";
+  data: TipTapDocument;
+  column: PgJsonbBuilder;
+};
+declare function richText(): Field<RichTextFieldState>;
+//#endregion
+export { RichTextFeature, RichTextFieldMeta, RichTextFieldState, TipTapDocument, TipTapNode, richText };

package/dist/server/fields/rich-text.mjs

@@ -0,0 +1,147 @@
+import { z } from "zod";
+import { field, fieldType, isNotNull, isNull, jsonb, sql } from "questpie";
+
+//#region src/server/fields/rich-text.ts
+/**
+* Get operators for rich text field.
+* Provides text search within the JSON structure.
+*/
+function getRichTextOperators() {
+	return {
+		column: {
+			contains: (col, value) => {
+				return sql`EXISTS (
+					SELECT 1 FROM jsonb_array_elements_text(
+						jsonb_path_query_array(${col}, '$..text')
+					) AS t
+					WHERE t ILIKE ${"%" + value + "%"}
+				)`;
+			},
+			isEmpty: (col) => sql`(
+					${col} IS NULL 
+					OR ${col} = '{"type":"doc"}'::jsonb 
+					OR ${col} = '{"type":"doc","content":[]}'::jsonb
+					OR NOT EXISTS (
+						SELECT 1 FROM jsonb_array_elements_text(
+							jsonb_path_query_array(${col}, '$..text')
+						) AS t
+						WHERE length(trim(t)) > 0
+					)
+				)`,
+			isNotEmpty: (col) => sql`(
+					${col} IS NOT NULL 
+					AND ${col} != '{"type":"doc"}'::jsonb 
+					AND ${col} != '{"type":"doc","content":[]}'::jsonb
+					AND EXISTS (
+						SELECT 1 FROM jsonb_array_elements_text(
+							jsonb_path_query_array(${col}, '$..text')
+						) AS t
+						WHERE length(trim(t)) > 0
+					)
+				)`,
+			isNull: (col) => isNull(col),
+			isNotNull: (col) => isNotNull(col)
+		},
+		jsonb: {
+			contains: (col, value, ctx) => {
+				const path = ctx.jsonbPath?.join(",") ?? "";
+				return sql`EXISTS (
+					SELECT 1 FROM jsonb_array_elements_text(
+						jsonb_path_query_array(${col}#>'{${sql.raw(path)}}', '$..text')
+					) AS t
+					WHERE t ILIKE ${"%" + value + "%"}
+				)`;
+			},
+			isEmpty: (col, _value, ctx) => {
+				const path = ctx.jsonbPath?.join(",") ?? "";
+				return sql`(
+					${col}#>'{${sql.raw(path)}}' IS NULL 
+					OR ${col}#>'{${sql.raw(path)}}' = '{"type":"doc"}'::jsonb
+				)`;
+			},
+			isNotEmpty: (col, _value, ctx) => {
+				const path = ctx.jsonbPath?.join(",") ?? "";
+				return sql`(
+					${col}#>'{${sql.raw(path)}}' IS NOT NULL 
+					AND ${col}#>'{${sql.raw(path)}}' != '{"type":"doc"}'::jsonb
+				)`;
+			},
+			isNull: (col, _value, ctx) => {
+				const path = ctx.jsonbPath?.join(",") ?? "";
+				return sql`${col}#>'{${sql.raw(path)}}' IS NULL`;
+			},
+			isNotNull: (col, _value, ctx) => {
+				const path = ctx.jsonbPath?.join(",") ?? "";
+				return sql`${col}#>'{${sql.raw(path)}}' IS NOT NULL`;
+			}
+		}
+	};
+}
+/**
+* Create a rich text field.
+*
+* @example
+* ```ts
+* content: f.richText().required().localized()
+* ```
+*/
+/**
+* Rich text field runtime state factory.
+* Shared between the legacy `richText()` function and the new `richTextFieldType`.
+*/
+function createRichTextState() {
+	return {
+		type: "richText",
+		columnFactory: (name) => jsonb(name),
+		schemaFactory: () => {
+			const nodeSchema = z.lazy(() => z.object({
+				type: z.string(),
+				attrs: z.record(z.string(), z.any()).optional(),
+				content: z.array(nodeSchema).optional(),
+				marks: z.array(z.object({
+					type: z.string(),
+					attrs: z.record(z.string(), z.any()).optional()
+				})).optional(),
+				text: z.string().optional()
+			}));
+			return z.object({
+				type: z.literal("doc"),
+				content: z.array(nodeSchema).optional()
+			});
+		},
+		operatorSet: {
+			jsonbCast: null,
+			column: getRichTextOperators().column
+		},
+		metadataFactory: (state) => ({
+			type: "richText",
+			label: state.label,
+			description: state.description,
+			required: state.notNull ?? false,
+			localized: state.localized ?? false,
+			readOnly: state.input === false ? true : void 0,
+			writeOnly: state.output === false ? true : void 0,
+			meta: state.extensions?.admin
+		}),
+		notNull: false,
+		hasDefault: false,
+		localized: false,
+		virtual: false,
+		input: true,
+		output: true,
+		isArray: false
+	};
+}
+function richText() {
+	return field(createRichTextState());
+}
+/**
+* Rich text field type definition (v3 API).
+*
+* Use this with the `fieldType()` discovery system instead of the
+* legacy `richText()` factory function.
+*/
+const richTextFieldType = fieldType("richText", { create: createRichTextState });
+
+//#endregion
+export { richText };

package/dist/server/i18n/index.mjs

@@ -0,0 +1,43 @@
+import { messages } from "./messages/index.mjs";
+
+//#region src/server/i18n/index.ts
+/**
+* Server-Side Admin i18n Messages
+*
+* These messages are served to the admin client via the getAdminTranslations RPC function.
+* The client fetches translations for its current UI locale.
+*
+* @example
+* ```ts
+* // Server: messages are stored here
+* // Client: fetches via client.routes.getAdminTranslations({ locale: "sk" })
+* ```
+*/
+const adminMessagesEN = messages.en;
+const adminMessagesSK = messages.sk;
+messages.cs;
+messages.de;
+messages.fr;
+messages.es;
+messages.pt;
+messages.pl;
+/**
+* Get admin messages for a specific locale.
+* Falls back to English if locale not found.
+*
+* @param locale - Locale code (e.g., "en", "sk")
+* @returns Messages for the locale
+*/
+function getAdminMessagesForLocale(locale) {
+	return messages[locale] ?? messages.en ?? {};
+}
+/**
+* Get list of supported admin UI locales.
+* These are locales that have message files.
+*/
+function getSupportedAdminLocales() {
+	return Object.keys(messages);
+}
+
+//#endregion
+export { getAdminMessagesForLocale, getSupportedAdminLocales };