@questpie/admin 1.1.1 → 3.0.0

package/dist/server/modules/admin-preferences/collections/saved-views.d.mts

@@ -0,0 +1,99 @@
+import { FilterOperator, FilterRule, SortConfig, ViewConfiguration } from "../../../../shared/types/saved-views.types.mjs";
+import * as questpie_shared15 from "questpie/shared";
+import * as questpie80 from "questpie";
+import * as drizzle_orm_pg_core22 from "drizzle-orm/pg-core";
+import * as drizzle_orm5 from "drizzle-orm";
+import * as questpie_src_server_modules_core_fields_email_js2 from "questpie/src/server/modules/core/fields/email.js";
+import * as questpie_src_server_modules_core_fields_json_js2 from "questpie/src/server/modules/core/fields/json.js";
+
+//#region src/server/modules/admin-preferences/collections/saved-views.d.ts
+
+/**
+ * Admin Saved Views Collection
+ *
+ * Stores user-specific view configurations for collection lists.
+ * Each view can contain:
+ * - Filter rules (field/operator/value combinations)
+ * - Sort configuration (field/direction)
+ * - Visible columns selection
+ *
+ * @example
+ * ```ts
+ * import { runtimeConfig } from "questpie";
+ * import { adminModule } from "@questpie/admin/server";
+ *
+ * export default runtimeConfig({
+ *   modules: [adminModule],
+ *   // ...
+ * });
+ *
+ * // Access saved views
+ * const views = await app.collections.admin_saved_views.find({
+ *   where: { collectionName: "posts", userId: currentUser.id }
+ * });
+ * ```
+ */
+declare const savedViewsCollection: questpie80.CollectionBuilder<questpie_shared15.Override<questpie_shared15.Override<questpie80.EmptyCollectionState<"admin_saved_views", undefined, {
+  readonly text: typeof questpie80.text;
+  readonly textarea: typeof questpie80.textarea;
+  readonly email: typeof questpie_src_server_modules_core_fields_email_js2.email;
+  readonly url: typeof questpie80.url;
+  readonly number: typeof questpie80.number;
+  readonly boolean: typeof questpie80.boolean;
+  readonly date: typeof questpie80.date;
+  readonly datetime: typeof questpie80.datetime;
+  readonly time: typeof questpie80.time;
+  readonly select: typeof questpie80.select;
+  readonly upload: typeof questpie80.upload;
+  readonly relation: typeof questpie80.relation;
+  readonly object: typeof questpie80.object;
+  readonly json: typeof questpie_src_server_modules_core_fields_json_js2.json;
+  readonly from: typeof questpie80.from;
+}>, {
+  fields: {
+    readonly userId: drizzle_orm5.NotNull<drizzle_orm_pg_core22.PgVarcharBuilder<[string, ...string[]]>>;
+    readonly collectionName: drizzle_orm5.NotNull<drizzle_orm_pg_core22.PgVarcharBuilder<[string, ...string[]]>>;
+    readonly name: drizzle_orm5.NotNull<drizzle_orm_pg_core22.PgVarcharBuilder<[string, ...string[]]>>;
+    readonly configuration: drizzle_orm5.NotNull<drizzle_orm_pg_core22.PgJsonbBuilder>;
+    readonly isDefault: drizzle_orm5.HasDefault<drizzle_orm_pg_core22.PgBooleanBuilder>;
+  };
+  localized: readonly string[];
+  fieldDefinitions: {
+    readonly userId: questpie80.Field<Omit<questpie80.TextFieldState, "notNull" | "column"> & {
+      notNull: true;
+      column: drizzle_orm5.NotNull<drizzle_orm_pg_core22.PgVarcharBuilder<[string, ...string[]]>>;
+    } & {
+      label: questpie_shared15.I18nText;
+    }>;
+    readonly collectionName: questpie80.Field<Omit<questpie80.TextFieldState, "notNull" | "column"> & {
+      notNull: true;
+      column: drizzle_orm5.NotNull<drizzle_orm_pg_core22.PgVarcharBuilder<[string, ...string[]]>>;
+    } & {
+      label: questpie_shared15.I18nText;
+    }>;
+    readonly name: questpie80.Field<Omit<questpie80.TextFieldState, "notNull" | "column"> & {
+      notNull: true;
+      column: drizzle_orm5.NotNull<drizzle_orm_pg_core22.PgVarcharBuilder<[string, ...string[]]>>;
+    } & {
+      label: questpie_shared15.I18nText;
+    }>;
+    readonly configuration: questpie80.Field<Omit<questpie80.JsonFieldState, "notNull" | "column"> & {
+      notNull: true;
+      column: drizzle_orm5.NotNull<drizzle_orm_pg_core22.PgJsonbBuilder>;
+    } & {
+      label: questpie_shared15.I18nText;
+    }>;
+    readonly isDefault: questpie80.Field<Omit<questpie80.BooleanFieldState, "column" | "hasDefault"> & {
+      hasDefault: true;
+      column: drizzle_orm5.HasDefault<drizzle_orm_pg_core22.PgBooleanBuilder>;
+    } & {
+      label: questpie_shared15.I18nText;
+    }>;
+  };
+}>, {
+  options: {
+    timestamps: true;
+  };
+}>>;
+//#endregion
+export { savedViewsCollection };

package/dist/server/modules/admin-preferences/collections/saved-views.mjs

@@ -0,0 +1,38 @@
+import { collection } from "questpie";
+
+//#region src/server/modules/admin-preferences/collections/saved-views.ts
+/**
+* Admin Saved Views Collection
+*
+* Stores user-specific view configurations for collection lists.
+* Each view can contain:
+* - Filter rules (field/operator/value combinations)
+* - Sort configuration (field/direction)
+* - Visible columns selection
+*
+* @example
+* ```ts
+* import { runtimeConfig } from "questpie";
+* import { adminModule } from "@questpie/admin/server";
+*
+* export default runtimeConfig({
+*   modules: [adminModule],
+*   // ...
+* });
+*
+* // Access saved views
+* const views = await app.collections.admin_saved_views.find({
+*   where: { collectionName: "posts", userId: currentUser.id }
+* });
+* ```
+*/
+const savedViewsCollection = collection("admin_saved_views").fields(({ f }) => ({
+	userId: f.text(255).required().label("User ID"),
+	collectionName: f.text(255).required().label("Collection Name"),
+	name: f.text(255).required().label("Name"),
+	configuration: f.json().required().label("Configuration"),
+	isDefault: f.boolean().default(false).label("Is Default")
+})).options({ timestamps: true });
+
+//#endregion
+export { savedViewsCollection };

package/dist/server/modules/audit/.generated/module.d.mts

@@ -0,0 +1,60 @@
+import { auditLogCollection } from "../collections/audit-log.mjs";
+import { auditCleanupJob } from "../jobs/audit-cleanup.mjs";
+import * as questpie55 from "questpie";
+
+//#region src/server/modules/audit/.generated/module.d.ts
+interface AuditCollections {
+  auditLogCollection: typeof auditLogCollection;
+}
+interface AuditJobs {
+  auditCleanup: typeof auditCleanupJob;
+}
+declare const _module: {
+  name: "questpie-audit";
+  collections: AuditCollections;
+  jobs: AuditJobs;
+  globals: {};
+  routes: {};
+  messages: {};
+  services: {};
+  emails: {};
+  migrations: readonly [];
+  seeds: readonly [];
+  fieldTypes: {};
+  views: {};
+  components: {};
+  blocks: {};
+  config: {
+    admin: {
+      sidebar: {
+        items: {
+          sectionId: string;
+          type: "collection";
+          collection: "admin_audit_log";
+          icon: {
+            type: string;
+            props: {
+              name: string;
+            };
+          };
+        }[];
+      };
+    };
+    app: {
+      hooks: {
+        collections: {
+          afterChange: (ctx: questpie55.GlobalCollectionHookContext) => Promise<void>;
+          afterDelete: (ctx: questpie55.GlobalCollectionHookContext) => Promise<void>;
+          afterTransition: (ctx: questpie55.GlobalCollectionTransitionHookContext) => Promise<void>;
+        };
+        globals: {
+          afterChange: (ctx: questpie55.GlobalGlobalHookContext) => Promise<void>;
+          afterTransition: (ctx: questpie55.GlobalGlobalTransitionHookContext) => Promise<void>;
+        };
+      };
+    };
+  };
+};
+type AuditModule = typeof _module;
+//#endregion
+export { AuditModule, _module };

package/dist/server/modules/audit/.generated/module.mjs

@@ -0,0 +1,30 @@
+import { auditLogCollection } from "../collections/audit-log.mjs";
+import { auditCleanupJob } from "../jobs/audit-cleanup.mjs";
+import admin_default from "../config/admin.mjs";
+import app_default from "../config/app.mjs";
+
+//#region src/server/modules/audit/.generated/module.ts
+const _module = {
+	name: "questpie-audit",
+	collections: { auditLogCollection },
+	jobs: { auditCleanup: auditCleanupJob },
+	globals: {},
+	routes: {},
+	messages: {},
+	services: {},
+	emails: {},
+	migrations: [],
+	seeds: [],
+	fieldTypes: {},
+	views: {},
+	components: {},
+	blocks: {},
+	config: {
+		admin: admin_default,
+		app: app_default
+	}
+};
+var module_default = _module;
+
+//#endregion
+export { module_default as default };

package/dist/server/modules/audit/collections/audit-log.d.mts

@@ -0,0 +1,214 @@
+import * as questpie_shared0 from "questpie/shared";
+import * as questpie16 from "questpie";
+import * as drizzle_orm_pg_core0 from "drizzle-orm/pg-core";
+import * as drizzle_orm0 from "drizzle-orm";
+import * as questpie_src_server_modules_core_fields_email_js0 from "questpie/src/server/modules/core/fields/email.js";
+import * as questpie_src_server_modules_core_fields_json_js0 from "questpie/src/server/modules/core/fields/json.js";
+import * as questpie_src_server_fields_operators_builtin_js0 from "questpie/src/server/fields/operators/builtin.js";
+
+//#region src/server/modules/audit/collections/audit-log.d.ts
+
+/**
+ * Audit Log Collection
+ *
+ * Stores audit trail entries for all mutations across collections and globals.
+ * Automatically populated by global hooks registered via the audit module.
+ *
+ * Access:
+ * - create/delete: system mode only
+ * - update: disallowed
+ * - read: allowed (for admin UI display)
+ */
+declare const auditLogCollection: questpie16.CollectionBuilder<questpie_shared0.Override<questpie_shared0.Override<questpie_shared0.Override<questpie_shared0.Override<questpie_shared0.Override<questpie16.EmptyCollectionState<"admin_audit_log", undefined, {
+  readonly text: typeof questpie16.text;
+  readonly textarea: typeof questpie16.textarea;
+  readonly email: typeof questpie_src_server_modules_core_fields_email_js0.email;
+  readonly url: typeof questpie16.url;
+  readonly number: typeof questpie16.number;
+  readonly boolean: typeof questpie16.boolean;
+  readonly date: typeof questpie16.date;
+  readonly datetime: typeof questpie16.datetime;
+  readonly time: typeof questpie16.time;
+  readonly select: typeof questpie16.select;
+  readonly upload: typeof questpie16.upload;
+  readonly relation: typeof questpie16.relation;
+  readonly object: typeof questpie16.object;
+  readonly json: typeof questpie_src_server_modules_core_fields_json_js0.json;
+  readonly from: typeof questpie16.from;
+}>, {
+  fields: {
+    readonly action: drizzle_orm0.NotNull<drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>>;
+    readonly resourceType: drizzle_orm0.NotNull<drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>>;
+    readonly resource: drizzle_orm0.NotNull<drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>>;
+    readonly resourceId: drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>;
+    readonly resourceLabel: drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>;
+    readonly userId: drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>;
+    readonly userName: drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>;
+    readonly locale: drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>;
+    readonly changes: drizzle_orm_pg_core0.PgJsonbBuilder;
+    readonly metadata: drizzle_orm_pg_core0.PgJsonbBuilder;
+    readonly title: drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>;
+  };
+  localized: readonly string[];
+  fieldDefinitions: {
+    /** Action performed: create, update, delete, transition, custom */
+    readonly action: questpie16.Field<Omit<questpie16.TextFieldState, "notNull" | "column"> & {
+      notNull: true;
+      column: drizzle_orm0.NotNull<drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>>;
+    } & {
+      label: questpie_shared0.I18nText;
+    }>;
+    /** Resource type: collection, global, auth, system, custom */
+    readonly resourceType: questpie16.Field<Omit<questpie16.TextFieldState, "notNull" | "column"> & {
+      notNull: true;
+      column: drizzle_orm0.NotNull<drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>>;
+    } & {
+      label: questpie_shared0.I18nText;
+    }>;
+    /** Resource slug (collection/global name) */
+    readonly resource: questpie16.Field<Omit<questpie16.TextFieldState, "notNull" | "column"> & {
+      notNull: true;
+      column: drizzle_orm0.NotNull<drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>>;
+    } & {
+      label: questpie_shared0.I18nText;
+    }>;
+    /** ID of the specific record (null for globals) */
+    readonly resourceId: questpie16.Field<questpie16.DefaultFieldState & {
+      type: "text";
+      data: string;
+      column: drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>;
+      operators: typeof questpie_src_server_fields_operators_builtin_js0.stringOps;
+    } & {
+      label: questpie_shared0.I18nText;
+    }>;
+    /** Denormalized display label for the affected record */
+    readonly resourceLabel: questpie16.Field<questpie16.DefaultFieldState & {
+      type: "text";
+      data: string;
+      column: drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>;
+      operators: typeof questpie_src_server_fields_operators_builtin_js0.stringOps;
+    } & {
+      label: questpie_shared0.I18nText;
+    }>;
+    /** User who performed the action */
+    readonly userId: questpie16.Field<questpie16.DefaultFieldState & {
+      type: "text";
+      data: string;
+      column: drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>;
+      operators: typeof questpie_src_server_fields_operators_builtin_js0.stringOps;
+    } & {
+      label: questpie_shared0.I18nText;
+    }>;
+    /** Denormalized user display name */
+    readonly userName: questpie16.Field<questpie16.DefaultFieldState & {
+      type: "text";
+      data: string;
+      column: drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>;
+      operators: typeof questpie_src_server_fields_operators_builtin_js0.stringOps;
+    } & {
+      label: questpie_shared0.I18nText;
+    }>;
+    /** Locale context of the operation */
+    readonly locale: questpie16.Field<questpie16.DefaultFieldState & {
+      type: "text";
+      data: string;
+      column: drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>;
+      operators: typeof questpie_src_server_fields_operators_builtin_js0.stringOps;
+    } & {
+      label: questpie_shared0.I18nText;
+    }>;
+    /** Field-level diffs: { field: { from, to } } or null */
+    readonly changes: questpie16.Field<questpie16.DefaultFieldState & {
+      type: "json";
+      data: questpie16.JsonValue;
+      column: drizzle_orm_pg_core0.PgJsonbBuilder;
+      operators: typeof questpie_src_server_fields_operators_builtin_js0.basicOps;
+    } & {
+      label: questpie_shared0.I18nText;
+    }>;
+    /** Extra context metadata */
+    readonly metadata: questpie16.Field<questpie16.DefaultFieldState & {
+      type: "json";
+      data: questpie16.JsonValue;
+      column: drizzle_orm_pg_core0.PgJsonbBuilder;
+      operators: typeof questpie_src_server_fields_operators_builtin_js0.basicOps;
+    } & {
+      label: questpie_shared0.I18nText;
+    }>;
+    /** Human-readable title: "User Action ResourceType 'ResourceLabel'" */
+    readonly title: questpie16.Field<questpie16.DefaultFieldState & {
+      type: "text";
+      data: string;
+      column: drizzle_orm_pg_core0.PgVarcharBuilder<[string, ...string[]]>;
+      operators: typeof questpie_src_server_fields_operators_builtin_js0.stringOps;
+    } & {
+      label: questpie_shared0.I18nText;
+    }>;
+  };
+}>, {
+  options: {
+    timestamps: true;
+  };
+}>, {
+  indexes: drizzle_orm_pg_core0.IndexBuilder[];
+}>, {
+  access: Record<string, any>;
+}> & Record<"admin", {
+  label: {
+    key: string;
+  };
+  icon: {
+    type: string;
+    props: {
+      name: string;
+    };
+  };
+  description: {
+    key: string;
+  };
+  group: string;
+  audit: false;
+}>, {
+  title: "title";
+}> & Record<"adminList", {
+  view: string;
+  columns: string[];
+  searchable: string[];
+  defaultSort: {
+    field: string;
+    direction: "desc";
+  };
+  actions: {
+    header: {
+      primary: never[];
+      secondary: never[];
+    };
+    row: never[];
+    bulk: never[];
+  };
+}> & Record<"adminForm", {
+  view: string;
+  fields: ({
+    type: "section";
+    label: {
+      key: string;
+    };
+    layout: "grid";
+    columns: number;
+    fields: {
+      field: string;
+    }[];
+  } | {
+    type: "section";
+    label: {
+      key: string;
+    };
+    fields: {
+      field: string;
+    }[];
+    layout?: undefined;
+    columns?: undefined;
+  })[];
+}>>;
+//#endregion
+export { auditLogCollection };

package/dist/server/modules/audit/collections/audit-log.mjs

@@ -0,0 +1,107 @@
+import { collection } from "questpie";
+import { index } from "drizzle-orm/pg-core";
+
+//#region src/server/modules/audit/collections/audit-log.ts
+/**
+* The collection slug used by the audit log.
+* Exported so hooks and jobs can reference the collection dynamically
+* instead of hardcoding the name.
+*/
+const AUDIT_LOG_COLLECTION = "admin_audit_log";
+/**
+* Audit Log Collection
+*
+* Stores audit trail entries for all mutations across collections and globals.
+* Automatically populated by global hooks registered via the audit module.
+*
+* Access:
+* - create/delete: system mode only
+* - update: disallowed
+* - read: allowed (for admin UI display)
+*/
+const auditLogCollection = collection(AUDIT_LOG_COLLECTION).fields(({ f }) => ({
+	action: f.text(50).required().label("Action"),
+	resourceType: f.text(50).required().label("Resource Type"),
+	resource: f.text(255).required().label("Resource"),
+	resourceId: f.text(255).label("Resource ID"),
+	resourceLabel: f.text(500).label("Resource Label"),
+	userId: f.text(255).label("User ID"),
+	userName: f.text(255).label("User Name"),
+	locale: f.text(10).label("Locale"),
+	changes: f.json().label("Changes"),
+	metadata: f.json().label("Metadata"),
+	title: f.text(1e3).label("Title")
+})).options({ timestamps: true }).indexes(({ table }) => [
+	index("audit_log_resource_type_idx").on(table.resource, table.resourceType),
+	index("audit_log_user_id_idx").on(table.userId),
+	index("audit_log_created_at_idx").on(table.createdAt),
+	index("audit_log_resource_id_idx").on(table.resource, table.resourceId)
+]).access({
+	create: false,
+	update: false,
+	delete: false,
+	read: true
+}).set("admin", {
+	label: { key: "audit.collection.label" },
+	icon: {
+		type: "icon",
+		props: { name: "ph:clock-counter-clockwise" }
+	},
+	description: { key: "audit.collection.description" },
+	group: "administration",
+	audit: false
+}).title(({ f }) => f.title).set("adminList", {
+	view: "collection-table",
+	columns: [
+		"title",
+		"userName",
+		"createdAt"
+	],
+	searchable: ["title", "userName"],
+	defaultSort: {
+		field: "createdAt",
+		direction: "desc"
+	},
+	actions: {
+		header: {
+			primary: [],
+			secondary: []
+		},
+		row: [],
+		bulk: []
+	}
+}).set("adminForm", {
+	view: "collection-form",
+	fields: [
+		{
+			type: "section",
+			label: { key: "audit.sections.event" },
+			layout: "grid",
+			columns: 2,
+			fields: [
+				{ field: "title" },
+				{ field: "action" },
+				{ field: "resourceType" },
+				{ field: "resource" },
+				{ field: "resourceId" },
+				{ field: "resourceLabel" },
+				{ field: "locale" }
+			]
+		},
+		{
+			type: "section",
+			label: { key: "audit.sections.user" },
+			layout: "grid",
+			columns: 2,
+			fields: [{ field: "userId" }, { field: "userName" }]
+		},
+		{
+			type: "section",
+			label: { key: "audit.sections.changes" },
+			fields: [{ field: "changes" }, { field: "metadata" }]
+		}
+	]
+});
+
+//#endregion
+export { AUDIT_LOG_COLLECTION, auditLogCollection };

package/dist/server/modules/audit/config/admin.mjs

@@ -0,0 +1,21 @@
+import { adminConfig } from "../../../augmentation/index.mjs";
+import { AUDIT_LOG_COLLECTION } from "../collections/audit-log.mjs";
+
+//#region src/server/modules/audit/config/admin.ts
+/**
+* Admin config from the audit module.
+* Adds audit log to the "administration" sidebar section
+* and provides a timeline dashboard widget.
+*/
+var admin_default = adminConfig({ sidebar: { items: [{
+	sectionId: "administration",
+	type: "collection",
+	collection: AUDIT_LOG_COLLECTION,
+	icon: {
+		type: "icon",
+		props: { name: "ph:clipboard-text" }
+	}
+}] } });
+
+//#endregion
+export { admin_default as default };