@questpie/admin 1.1.1 → 3.0.0

package/dist/server/modules/admin/collections/assets.mjs

@@ -0,0 +1,71 @@
+import { collection as collection$1 } from "../factories.mjs";
+import { starterModule } from "questpie";
+
+//#region src/server/modules/admin/collections/assets.ts
+/**
+* Admin-configured Assets Collection
+*
+* Extends the starter assets collection with admin UI configuration:
+* - Admin panel metadata (label, icon, group)
+* - List view with file preview, metadata columns
+* - Form view with file info sidebar, dimensions, and metadata sections
+*
+* @see account.ts for explanation of the collection().merge().set() pattern.
+* stateKey mapping: admin=".admin()", adminList=".list()", adminForm=".form()"
+*/
+const adminAssetsCollection = collection$1("assets").merge(starterModule.collections.assets).admin(({ c }) => ({
+	label: { key: "defaults.assets.label" },
+	icon: c.icon("ph:image"),
+	description: { key: "defaults.assets.description" },
+	group: "administration"
+})).list(({ v, f, a }) => v.collectionTable({
+	columns: [
+		"preview",
+		"filename",
+		"mimeType",
+		"size"
+	],
+	searchable: ["filename", f.alt],
+	defaultSort: {
+		field: "createdAt",
+		direction: "desc"
+	},
+	actions: {
+		header: {
+			primary: [],
+			secondary: []
+		},
+		row: [a.delete],
+		bulk: [a.deleteMany]
+	}
+})).form(({ v, f }) => v.collectionForm({
+	sidebar: {
+		position: "right",
+		fields: [{
+			type: "section",
+			label: { key: "defaults.assets.sections.fileInfo" },
+			fields: [
+				"preview",
+				"filename",
+				"mimeType",
+				"size",
+				"visibility"
+			]
+		}]
+	},
+	fields: [{
+		type: "section",
+		label: { key: "defaults.assets.sections.dimensions" },
+		layout: "grid",
+		columns: 2,
+		fields: [f.width, f.height]
+	}, {
+		type: "section",
+		label: { key: "defaults.assets.sections.metadata" },
+		fields: [f.alt, f.caption]
+	}]
+}));
+var assets_default = adminAssetsCollection;
+
+//#endregion
+export { assets_default as default };

package/dist/server/modules/admin/collections/session.d.mts

@@ -0,0 +1,69 @@
+import * as questpie_shared42 from "questpie/shared";
+import * as questpie328 from "questpie";
+import * as drizzle_orm_pg_core106 from "drizzle-orm/pg-core";
+import * as drizzle_orm65 from "drizzle-orm";
+import * as questpie_src_server_modules_core_fields_email_js8 from "questpie/src/server/modules/core/fields/email.js";
+import * as questpie_src_server_modules_core_fields_json_js8 from "questpie/src/server/modules/core/fields/json.js";
+
+//#region src/server/modules/admin/collections/session.d.ts
+declare const _default: questpie328.CollectionBuilder<questpie_shared42.Override<questpie328.EmptyCollectionState<"session", undefined, {
+  readonly text: typeof questpie328.text;
+  readonly textarea: typeof questpie328.textarea;
+  readonly email: typeof questpie_src_server_modules_core_fields_email_js8.email;
+  readonly url: typeof questpie328.url;
+  readonly number: typeof questpie328.number;
+  readonly boolean: typeof questpie328.boolean;
+  readonly date: typeof questpie328.date;
+  readonly datetime: typeof questpie328.datetime;
+  readonly time: typeof questpie328.time;
+  readonly select: typeof questpie328.select;
+  readonly upload: typeof questpie328.upload;
+  readonly relation: typeof questpie328.relation;
+  readonly object: typeof questpie328.object;
+  readonly json: typeof questpie_src_server_modules_core_fields_json_js8.json;
+  readonly from: typeof questpie328.from;
+}>, {
+  name: "session";
+  fields: Record<string, any> & {
+    readonly userId: drizzle_orm65.NotNull<drizzle_orm_pg_core106.PgVarcharBuilder<[string, ...string[]]>>;
+    readonly token: drizzle_orm65.NotNull<drizzle_orm_pg_core106.PgVarcharBuilder<[string, ...string[]]>>;
+    readonly expiresAt: drizzle_orm65.NotNull<drizzle_orm_pg_core106.PgTimestampBuilder>;
+    readonly ipAddress: drizzle_orm_pg_core106.PgVarcharBuilder<[string, ...string[]]>;
+    readonly userAgent: drizzle_orm_pg_core106.PgVarcharBuilder<[string, ...string[]]>;
+    readonly impersonatedBy: drizzle_orm_pg_core106.PgVarcharBuilder<[string, ...string[]]>;
+  };
+  virtuals: undefined;
+  relations: Record<string, questpie328.RelationConfig>;
+  indexes: Record<string, any>;
+  title: "token";
+  options: questpie328.CollectionOptions & {
+    timestamps: true;
+  };
+  hooks: Record<string, any>;
+  access: Record<string, any>;
+  searchable: undefined;
+  fieldDefinitions: {
+    readonly userId: questpie328.Field<Omit<questpie328.TextFieldState, "notNull" | "column"> & {
+      notNull: true;
+      column: drizzle_orm65.NotNull<drizzle_orm_pg_core106.PgVarcharBuilder<[string, ...string[]]>>;
+    }>;
+    readonly token: questpie328.Field<Omit<questpie328.TextFieldState, "notNull" | "column"> & {
+      notNull: true;
+      column: drizzle_orm65.NotNull<drizzle_orm_pg_core106.PgVarcharBuilder<[string, ...string[]]>>;
+    }>;
+    readonly expiresAt: questpie328.Field<Omit<questpie328.DatetimeFieldState, "notNull" | "column"> & {
+      notNull: true;
+      column: drizzle_orm65.NotNull<drizzle_orm_pg_core106.PgTimestampBuilder>;
+    }>;
+    readonly ipAddress: questpie328.FieldWithMethods<questpie328.TextFieldState, questpie328.TextFieldMethods>;
+    readonly userAgent: questpie328.FieldWithMethods<questpie328.TextFieldState, questpie328.TextFieldMethods>;
+    readonly impersonatedBy: questpie328.FieldWithMethods<questpie328.TextFieldState, questpie328.TextFieldMethods>;
+  };
+  upload: undefined;
+  output: {};
+}> & Record<"admin", {
+  hidden: boolean;
+  audit: boolean;
+}>>;
+//#endregion
+export { _default };

package/dist/server/modules/admin/collections/session.mjs

@@ -0,0 +1,15 @@
+import { collection, starterModule } from "questpie";
+
+//#region src/server/modules/admin/collections/session.ts
+/**
+* Hidden session collection — internal auth collection, not shown in admin sidebar.
+*
+* @see account.ts for explanation of the collection().merge().set() pattern.
+*/
+var session_default = collection("session").merge(starterModule.collections.session).set("admin", {
+	hidden: true,
+	audit: false
+});
+
+//#endregion
+export { session_default as default };

package/dist/server/modules/admin/collections/user.d.mts

@@ -0,0 +1,85 @@
+import * as questpie_shared44 from "questpie/shared";
+import * as questpie383 from "questpie";
+import * as drizzle_orm_pg_core121 from "drizzle-orm/pg-core";
+import * as drizzle_orm77 from "drizzle-orm";
+
+//#region src/server/modules/admin/collections/user.d.ts
+
+/**
+ * Admin-configured User Collection
+ *
+ * Extends the starter user collection with full admin UI configuration:
+ * - Admin panel metadata (label, icon, group)
+ * - List view with table columns, search, and actions
+ * - Form view with tabbed layout (profile + security)
+ * - Custom actions: create user, reset password
+ *
+ * @see account.ts for explanation of the collection().merge().set() pattern.
+ * stateKey mapping: admin=".admin()", adminList=".list()", adminForm=".form()", adminActions=".actions()"
+ */
+declare const adminUserCollection: questpie383.CollectionBuilder<questpie_shared44.Override<{
+  name: "user";
+  fields: Record<string, never>;
+  localized: [];
+  virtuals: undefined;
+  relations: Record<string, never>;
+  indexes: Record<string, never>;
+  title: undefined;
+  options: Record<string, never>;
+  hooks: Record<string, never>;
+  access: Record<string, never>;
+  searchable: undefined;
+  validation: undefined;
+  output: undefined;
+  upload: undefined;
+  fieldDefinitions: Record<string, never>;
+  "~questpieApp": undefined;
+}, {
+  name: "user";
+  fields: Record<string, never> & {
+    readonly name: drizzle_orm77.NotNull<drizzle_orm_pg_core121.PgVarcharBuilder<[string, ...string[]]>>;
+    readonly email: drizzle_orm77.NotNull<drizzle_orm_pg_core121.PgVarcharBuilder<[string, ...string[]]>>;
+    readonly emailVerified: drizzle_orm77.NotNull<drizzle_orm_pg_core121.PgBooleanBuilder>;
+    readonly image: drizzle_orm_pg_core121.PgVarcharBuilder<[string, ...string[]]>;
+    readonly role: drizzle_orm_pg_core121.PgVarcharBuilder<[string, ...string[]]>;
+    readonly banned: drizzle_orm77.HasDefault<drizzle_orm_pg_core121.PgBooleanBuilder>;
+    readonly banReason: drizzle_orm_pg_core121.PgVarcharBuilder<[string, ...string[]]>;
+    readonly banExpires: drizzle_orm_pg_core121.PgTimestampBuilder;
+  };
+  virtuals: undefined;
+  relations: Record<string, never> & Record<string, questpie383.RelationConfig>;
+  indexes: Record<string, never> & Record<string, any>;
+  title: "name";
+  options: Record<string, never> & {
+    timestamps: true;
+  };
+  hooks: Record<string, any>;
+  access: Record<string, any>;
+  searchable: undefined;
+  fieldDefinitions: {
+    readonly name: questpie383.Field<Omit<questpie383.TextFieldState, "notNull" | "column"> & {
+      notNull: true;
+      column: drizzle_orm77.NotNull<drizzle_orm_pg_core121.PgVarcharBuilder<[string, ...string[]]>>;
+    }>;
+    readonly email: questpie383.Field<Omit<questpie383.EmailFieldState, "notNull" | "column"> & {
+      notNull: true;
+      column: drizzle_orm77.NotNull<drizzle_orm_pg_core121.PgVarcharBuilder<[string, ...string[]]>>;
+    }>;
+    readonly emailVerified: questpie383.Field<Omit<questpie383.BooleanFieldState, "notNull" | "column"> & {
+      notNull: true;
+      column: drizzle_orm77.NotNull<drizzle_orm_pg_core121.PgBooleanBuilder>;
+    }>;
+    readonly image: questpie383.FieldWithMethods<questpie383.UrlFieldState, questpie383.UrlFieldMethods>;
+    readonly role: questpie383.FieldWithMethods<questpie383.TextFieldState, questpie383.TextFieldMethods>;
+    readonly banned: questpie383.Field<Omit<questpie383.BooleanFieldState, "column" | "hasDefault"> & {
+      hasDefault: true;
+      column: drizzle_orm77.HasDefault<drizzle_orm_pg_core121.PgBooleanBuilder>;
+    }>;
+    readonly banReason: questpie383.FieldWithMethods<questpie383.TextFieldState, questpie383.TextFieldMethods>;
+    readonly banExpires: questpie383.FieldWithMethods<questpie383.DatetimeFieldState, questpie383.DatetimeFieldMethods>;
+  };
+  upload: undefined;
+  output: {};
+}>>;
+//#endregion
+export { adminUserCollection };

package/dist/server/modules/admin/collections/user.mjs

@@ -0,0 +1,204 @@
+import { collection as collection$1 } from "../factories.mjs";
+import { starterModule } from "questpie";
+
+//#region src/server/modules/admin/collections/user.ts
+/**
+* Admin-configured User Collection
+*
+* Extends the starter user collection with full admin UI configuration:
+* - Admin panel metadata (label, icon, group)
+* - List view with table columns, search, and actions
+* - Form view with tabbed layout (profile + security)
+* - Custom actions: create user, reset password
+*
+* @see account.ts for explanation of the collection().merge().set() pattern.
+* stateKey mapping: admin=".admin()", adminList=".list()", adminForm=".form()", adminActions=".actions()"
+*/
+const adminUserCollection = collection$1("user").merge(starterModule.collections.user).admin(({ c }) => ({
+	label: { key: "defaults.users.label" },
+	icon: c.icon("ph:users"),
+	description: { key: "defaults.users.description" },
+	group: "administration"
+})).list(({ v, f, a }) => v.collectionTable({
+	columns: [
+		f.name,
+		f.email,
+		f.role,
+		f.banned
+	],
+	searchable: [f.name, f.email],
+	defaultSort: {
+		field: f.name,
+		direction: "asc"
+	},
+	actions: {
+		header: {
+			primary: [],
+			secondary: []
+		},
+		row: [a.delete],
+		bulk: [a.deleteMany]
+	}
+})).form(({ v, f }) => v.collectionForm({
+	sidebar: {
+		position: "right",
+		fields: [
+			f.image,
+			f.role,
+			f.emailVerified
+		]
+	},
+	fields: [{
+		type: "tabs",
+		tabs: [{
+			id: "profile",
+			label: { key: "defaults.users.tabs.profile" },
+			fields: [{
+				type: "section",
+				label: { key: "defaults.users.sections.basicInfo" },
+				layout: "grid",
+				columns: 2,
+				fields: [f.name, {
+					field: f.email,
+					readOnly: ({ data }) => Boolean(data?.id)
+				}]
+			}]
+		}, {
+			id: "security",
+			label: { key: "defaults.users.tabs.security" },
+			fields: [{
+				type: "section",
+				label: { key: "defaults.users.sections.accessControl" },
+				fields: [
+					f.banned,
+					{
+						field: f.banReason,
+						hidden: ({ data }) => !data?.banned
+					},
+					{
+						field: f.banExpires,
+						hidden: ({ data }) => !data?.banned
+					}
+				]
+			}]
+		}]
+	}]
+})).actions(({ a, c, f }) => ({
+	builtin: [
+		a.save(),
+		a.delete(),
+		a.deleteMany(),
+		a.duplicate()
+	],
+	custom: [a.headerAction({
+		id: "createUser",
+		label: { key: "defaults.users.actions.createUser.label" },
+		icon: c.icon("ph:user-plus"),
+		form: {
+			title: { key: "defaults.users.actions.createUser.title" },
+			description: { key: "defaults.users.actions.createUser.description" },
+			submitLabel: { key: "defaults.users.actions.createUser.submit" },
+			fields: {
+				name: f.text().label({ key: "defaults.users.fields.name.label" }).required(),
+				email: f.email().label({ key: "defaults.users.fields.email.label" }).required(),
+				password: f.text().label({ key: "defaults.users.actions.createUser.fields.password.label" }).required().admin({
+					type: "password",
+					autoComplete: "new-password"
+				}),
+				role: f.select([{
+					value: "admin",
+					label: { key: "defaults.users.fields.role.options.admin" }
+				}, {
+					value: "user",
+					label: { key: "defaults.users.fields.role.options.user" }
+				}]).label({ key: "defaults.users.fields.role.label" }).default("user")
+			}
+		},
+		handler: async ({ data, auth, session }) => {
+			const authApi = auth?.api;
+			if (!authApi?.createUser) return {
+				type: "error",
+				toast: { message: "Auth admin API is not configured. Cannot create user." }
+			};
+			const token = session?.session?.token;
+			const headers = token ? new Headers({ authorization: `Bearer ${token}` }) : void 0;
+			const result = await authApi.createUser({
+				body: {
+					email: String(data.email || ""),
+					password: String(data.password || ""),
+					name: String(data.name || ""),
+					role: data.role ? String(data.role) : void 0
+				},
+				...headers ? { headers } : {}
+			});
+			const createdUserId = result?.user?.id;
+			const createdUserEmail = result?.user?.email;
+			if (!createdUserId) return {
+				type: "error",
+				toast: { message: "Failed to create user" }
+			};
+			return {
+				type: "success",
+				toast: { message: `User ${createdUserEmail || ""} created successfully` },
+				effects: {
+					invalidate: ["user"],
+					redirect: `/admin/collections/user/${createdUserId}`
+				}
+			};
+		}
+	}), a.action({
+		id: "resetPassword",
+		label: { key: "defaults.users.actions.resetPassword.label" },
+		icon: c.icon("ph:key"),
+		variant: "outline",
+		form: {
+			title: { key: "defaults.users.actions.resetPassword.title" },
+			description: { key: "defaults.users.actions.resetPassword.description" },
+			submitLabel: { key: "defaults.users.actions.resetPassword.submit" },
+			fields: {
+				newPassword: f.text().label({ key: "defaults.users.actions.resetPassword.fields.newPassword.label" }).required().admin({
+					type: "password",
+					autoComplete: "new-password"
+				}),
+				confirmPassword: f.text().label({ key: "defaults.users.actions.resetPassword.fields.confirmPassword.label" }).required().admin({
+					type: "password",
+					autoComplete: "new-password"
+				})
+			}
+		},
+		handler: async ({ data, itemId, auth, session }) => {
+			if (!itemId) return {
+				type: "error",
+				toast: { message: "User ID is required" }
+			};
+			const newPassword = String(data.newPassword || "");
+			if (newPassword !== String(data.confirmPassword || "")) return {
+				type: "error",
+				toast: { message: "Passwords do not match" }
+			};
+			const authApi = auth?.api;
+			if (!authApi?.setUserPassword) return {
+				type: "error",
+				toast: { message: "Auth admin API is not configured. Cannot reset password." }
+			};
+			const token = session?.session?.token;
+			const headers = token ? new Headers({ authorization: `Bearer ${token}` }) : void 0;
+			await authApi.setUserPassword({
+				body: {
+					userId: itemId,
+					newPassword
+				},
+				...headers ? { headers } : {}
+			});
+			return {
+				type: "success",
+				toast: { message: "Password reset successfully" },
+				effects: { invalidate: ["user"] }
+			};
+		}
+	})]
+}));
+var user_default = adminUserCollection;
+
+//#endregion
+export { user_default as default };

package/dist/server/modules/admin/collections/verification.d.mts

@@ -0,0 +1,63 @@
+import * as questpie_shared43 from "questpie/shared";
+import * as questpie360 from "questpie";
+import * as drizzle_orm_pg_core115 from "drizzle-orm/pg-core";
+import * as drizzle_orm71 from "drizzle-orm";
+import * as questpie_src_server_modules_core_fields_email_js9 from "questpie/src/server/modules/core/fields/email.js";
+import * as questpie_src_server_modules_core_fields_json_js9 from "questpie/src/server/modules/core/fields/json.js";
+
+//#region src/server/modules/admin/collections/verification.d.ts
+declare const _default: questpie360.CollectionBuilder<questpie_shared43.Override<questpie360.EmptyCollectionState<"verification", undefined, {
+  readonly text: typeof questpie360.text;
+  readonly textarea: typeof questpie360.textarea;
+  readonly email: typeof questpie_src_server_modules_core_fields_email_js9.email;
+  readonly url: typeof questpie360.url;
+  readonly number: typeof questpie360.number;
+  readonly boolean: typeof questpie360.boolean;
+  readonly date: typeof questpie360.date;
+  readonly datetime: typeof questpie360.datetime;
+  readonly time: typeof questpie360.time;
+  readonly select: typeof questpie360.select;
+  readonly upload: typeof questpie360.upload;
+  readonly relation: typeof questpie360.relation;
+  readonly object: typeof questpie360.object;
+  readonly json: typeof questpie_src_server_modules_core_fields_json_js9.json;
+  readonly from: typeof questpie360.from;
+}>, {
+  name: "verification";
+  fields: Record<string, any> & {
+    readonly identifier: drizzle_orm71.NotNull<drizzle_orm_pg_core115.PgVarcharBuilder<[string, ...string[]]>>;
+    readonly value: drizzle_orm71.NotNull<drizzle_orm_pg_core115.PgVarcharBuilder<[string, ...string[]]>>;
+    readonly expiresAt: drizzle_orm71.NotNull<drizzle_orm_pg_core115.PgTimestampBuilder>;
+  };
+  virtuals: undefined;
+  relations: Record<string, questpie360.RelationConfig>;
+  indexes: Record<string, any>;
+  title: "identifier";
+  options: questpie360.CollectionOptions & {
+    timestamps: true;
+  };
+  hooks: Record<string, any>;
+  access: Record<string, any>;
+  searchable: undefined;
+  fieldDefinitions: {
+    readonly identifier: questpie360.Field<Omit<questpie360.TextFieldState, "notNull" | "column"> & {
+      notNull: true;
+      column: drizzle_orm71.NotNull<drizzle_orm_pg_core115.PgVarcharBuilder<[string, ...string[]]>>;
+    }>;
+    readonly value: questpie360.Field<Omit<questpie360.TextFieldState, "notNull" | "column"> & {
+      notNull: true;
+      column: drizzle_orm71.NotNull<drizzle_orm_pg_core115.PgVarcharBuilder<[string, ...string[]]>>;
+    }>;
+    readonly expiresAt: questpie360.Field<Omit<questpie360.DatetimeFieldState, "notNull" | "column"> & {
+      notNull: true;
+      column: drizzle_orm71.NotNull<drizzle_orm_pg_core115.PgTimestampBuilder>;
+    }>;
+  };
+  upload: undefined;
+  output: {};
+}> & Record<"admin", {
+  hidden: boolean;
+  audit: boolean;
+}>>;
+//#endregion
+export { _default };

package/dist/server/modules/admin/collections/verification.mjs

@@ -0,0 +1,15 @@
+import { collection, starterModule } from "questpie";
+
+//#region src/server/modules/admin/collections/verification.ts
+/**
+* Hidden verification collection — internal auth collection, not shown in admin sidebar.
+*
+* @see account.ts for explanation of the collection().merge().set() pattern.
+*/
+var verification_default = collection("verification").merge(starterModule.collections.verification).set("admin", {
+	hidden: true,
+	audit: false
+});
+
+//#endregion
+export { verification_default as default };

package/dist/server/modules/admin/components/badge.d.mts

@@ -0,0 +1,10 @@
+import { ComponentDefinition } from "../../../augmentation/views.mjs";
+import "../../../augmentation.mjs";
+
+//#region src/server/modules/admin/components/badge.d.ts
+declare const _default: ComponentDefinition<string, {
+  text: string;
+  color?: string;
+}>;
+//#endregion
+export { _default };

package/dist/server/modules/admin/components/badge.mjs

@@ -0,0 +1,10 @@
+import { component } from "../../../registry-helpers.mjs";
+
+//#region src/server/modules/admin/components/badge.ts
+/**
+* Badge component — renders a status badge with label and variant.
+*/
+var badge_default = component("badge");
+
+//#endregion
+export { badge_default as default };

package/dist/server/modules/admin/components/icon.d.mts

@@ -0,0 +1,9 @@
+import { ComponentDefinition } from "../../../augmentation/views.mjs";
+import "../../../augmentation.mjs";
+
+//#region src/server/modules/admin/components/icon.d.ts
+declare const _default: ComponentDefinition<string, string | {
+  name: string;
+}>;
+//#endregion
+export { _default };

package/dist/server/modules/admin/components/icon.mjs

@@ -0,0 +1,11 @@
+import { component } from "../../../registry-helpers.mjs";
+
+//#region src/server/modules/admin/components/icon.ts
+/**
+* Icon component — renders an icon from the Iconify registry.
+* Accepts a string shorthand (`"ph:users"`) or object form (`{ name: "ph:users" }`).
+*/
+var icon_default = component("icon");
+
+//#endregion
+export { icon_default as default };

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

@@ -0,0 +1,34 @@
+import { adminConfig } from "../../../augmentation/index.mjs";
+
+//#region src/server/modules/admin/config/admin.ts
+/**
+* Default admin config from the admin module.
+* Defines an "administration" section with users and assets.
+* Other modules (audit, etc.) can add items to this section via sectionId.
+*/
+var admin_default = adminConfig({ sidebar: {
+	sections: [{
+		id: "administration",
+		title: { key: "defaults.sidebar.administration" }
+	}],
+	items: [{
+		sectionId: "administration",
+		type: "collection",
+		collection: "user",
+		icon: {
+			type: "icon",
+			props: { name: "ph:users" }
+		}
+	}, {
+		sectionId: "administration",
+		type: "collection",
+		collection: "assets",
+		icon: {
+			type: "icon",
+			props: { name: "ph:image" }
+		}
+	}]
+} });
+
+//#endregion
+export { admin_default as default };