@htlkg/data 0.0.15 → 0.0.16

package/src/queries/index.ts

@@ -43,3 +43,12 @@ export {
 
 // Server-side query helpers
 export { executeServerQuery, executePublicQuery } from "./server-helpers";
+
+// SystemSettings queries
+export {
+	getSystemSettings,
+	getSoftDeleteRetentionDays,
+	checkRestoreEligibility,
+	SYSTEM_SETTINGS_KEY,
+	DEFAULT_SOFT_DELETE_RETENTION_DAYS,
+} from "./systemSettings";

package/src/queries/systemSettings.ts

@@ -0,0 +1,115 @@
+/**
+ * SystemSettings Query Functions
+ *
+ * Provides query functions for fetching system settings from the GraphQL API.
+ */
+
+import type { SystemSettings } from "@htlkg/core/types";
+
+/** Default retention days if no settings exist */
+export const DEFAULT_SOFT_DELETE_RETENTION_DAYS = 30;
+
+/** The key used for global system settings */
+export const SYSTEM_SETTINGS_KEY = "GLOBAL";
+
+/**
+ * Get system settings
+ *
+ * @example
+ * ```typescript
+ * import { getSystemSettings } from '@htlkg/data/queries';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const settings = await getSystemSettings(client);
+ * ```
+ */
+export async function getSystemSettings<TClient = any>(
+	client: TClient,
+): Promise<SystemSettings | null> {
+	try {
+		const { data, errors } = await (client as any).models.SystemSettings.get({
+			key: SYSTEM_SETTINGS_KEY,
+		});
+
+		if (errors) {
+			console.error("[getSystemSettings] GraphQL errors:", errors);
+			return null;
+		}
+
+		return data as SystemSettings;
+	} catch (error) {
+		console.error("[getSystemSettings] Error fetching system settings:", error);
+		throw error;
+	}
+}
+
+/**
+ * Get the soft delete retention days from system settings
+ * Returns the default (30 days) if settings don't exist
+ *
+ * @example
+ * ```typescript
+ * import { getSoftDeleteRetentionDays } from '@htlkg/data/queries';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const days = await getSoftDeleteRetentionDays(client);
+ * ```
+ */
+export async function getSoftDeleteRetentionDays<TClient = any>(
+	client: TClient,
+): Promise<number> {
+	const settings = await getSystemSettings(client);
+	return settings?.softDeleteRetentionDays ?? DEFAULT_SOFT_DELETE_RETENTION_DAYS;
+}
+
+/**
+ * Check if a soft-deleted item can still be restored based on retention period
+ *
+ * @param deletedAt - The ISO date string when the item was deleted
+ * @param retentionDays - Number of days items can be restored
+ * @returns Object with canRestore flag and daysRemaining/daysExpired
+ */
+export function checkRestoreEligibility(
+	deletedAt: string | undefined | null,
+	retentionDays: number,
+): {
+	canRestore: boolean;
+	daysRemaining: number;
+	daysExpired: number;
+	expiresAt: Date | null;
+} {
+	if (!deletedAt) {
+		return {
+			canRestore: false,
+			daysRemaining: 0,
+			daysExpired: 0,
+			expiresAt: null,
+		};
+	}
+
+	const deletedDate = new Date(deletedAt);
+	const expiresAt = new Date(deletedDate);
+	expiresAt.setDate(expiresAt.getDate() + retentionDays);
+
+	const now = new Date();
+	const msRemaining = expiresAt.getTime() - now.getTime();
+	const daysRemaining = Math.ceil(msRemaining / (1000 * 60 * 60 * 24));
+
+	if (daysRemaining <= 0) {
+		return {
+			canRestore: false,
+			daysRemaining: 0,
+			daysExpired: Math.abs(daysRemaining),
+			expiresAt,
+		};
+	}
+
+	return {
+		canRestore: true,
+		daysRemaining,
+		daysExpired: 0,
+		expiresAt,
+	};
+}