@htlkg/data 0.0.14 → 0.0.15

package/src/mutations/productInstances/productInstances.ts

@@ -0,0 +1,280 @@
+/**
+ * ProductInstance Mutation Functions
+ *
+ * Provides mutation functions for creating, updating, and deleting product instances.
+ * Product instances represent enabled products for a specific brand with their configuration.
+ */
+
+import type { ProductInstance } from "@htlkg/core/types";
+import { getClientUser } from "@htlkg/core/auth";
+import { getCurrentTimestamp } from "@htlkg/core/utils";
+import { AppError } from "@htlkg/core/errors";
+
+/**
+ * Get current user identifier for audit trails
+ * Uses getClientUser() and returns email or username, falling back to "system"
+ */
+async function getUserIdentifier(fallback = "system"): Promise<string> {
+	try {
+		const user = await getClientUser();
+		if (user) {
+			return user.email || user.username || fallback;
+		}
+		return fallback;
+	} catch {
+		return fallback;
+	}
+}
+
+/**
+ * Input type for creating a product instance
+ */
+export interface CreateProductInstanceInput {
+	productId: string;
+	brandId: string;
+	accountId: string;
+	productName: string;
+	enabled: boolean;
+	config?: Record<string, any>;
+	version?: string;
+	lastUpdated?: string;
+	updatedBy?: string;
+}
+
+/**
+ * Input type for updating a product instance
+ */
+export interface UpdateProductInstanceInput {
+	id: string;
+	enabled?: boolean;
+	config?: Record<string, any>;
+	version?: string;
+	lastUpdated?: string;
+	updatedBy?: string;
+}
+
+/**
+ * Create a new product instance
+ *
+ * @example
+ * ```typescript
+ * import { createProductInstance } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const instance = await createProductInstance(client, {
+ *   productId: 'product-123',
+ *   brandId: 'brand-456',
+ *   accountId: 'account-789',
+ *   enabled: true,
+ *   config: { apiKey: 'xxx', maxRequests: 100 }
+ * });
+ * ```
+ */
+export async function createProductInstance<TClient = any>(
+	client: TClient,
+	input: CreateProductInstanceInput,
+): Promise<ProductInstance | null> {
+	try {
+		// Build input - manually construct to avoid Vue Proxy issues
+		const createInput: any = {
+			productId: input.productId,
+			productName: input.productName,
+			brandId: input.brandId,
+			accountId: input.accountId,
+			enabled: input.enabled,
+			version: input.version,
+			lastUpdated: input.lastUpdated || getCurrentTimestamp(),
+			updatedBy: input.updatedBy || await getUserIdentifier(),
+		};
+
+		// AWSJSON type requires JSON STRING
+		if (input.config) {
+			// Double stringify: first to strip Vue Proxy, second to create JSON string
+			createInput.config = JSON.stringify(JSON.parse(JSON.stringify(input.config)));
+		}
+
+		console.log("[createProductInstance] Config as string:", createInput.config);
+		console.log("[createProductInstance] Config type:", typeof createInput.config);
+
+		const { data, errors } = await (client as any).models.ProductInstance.create(createInput);
+
+		if (errors) {
+			console.error("[createProductInstance] GraphQL errors:", errors);
+			throw new AppError(
+				"Failed to create product instance",
+				"PRODUCT_INSTANCE_CREATE_ERROR",
+				500,
+				{ errors }
+			);
+		}
+
+		return data as ProductInstance;
+	} catch (error) {
+		console.error("[createProductInstance] Error creating product instance:", error);
+		if (error instanceof AppError) {
+			throw error;
+		}
+		throw new AppError(
+			"Failed to create product instance",
+			"PRODUCT_INSTANCE_CREATE_ERROR",
+			500,
+			{ originalError: error }
+		);
+	}
+}
+
+/**
+ * Update an existing product instance
+ *
+ * @example
+ * ```typescript
+ * import { updateProductInstance } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const instance = await updateProductInstance(client, {
+ *   id: 'instance-123',
+ *   enabled: false,
+ *   config: { apiKey: 'new-key', maxRequests: 200 }
+ * });
+ * ```
+ */
+export async function updateProductInstance<TClient = any>(
+	client: TClient,
+	input: UpdateProductInstanceInput,
+): Promise<ProductInstance | null> {
+	try {
+		// Add timestamp and user metadata if not provided
+		// Convert config from Vue Proxy to plain object
+		const updateInput: any = {
+			...input,
+			lastUpdated: input.lastUpdated || getCurrentTimestamp(),
+			updatedBy: input.updatedBy || await getUserIdentifier(),
+		};
+
+		// AWSJSON type requires JSON STRING
+		if (input.config) {
+			updateInput.config = JSON.stringify(JSON.parse(JSON.stringify(input.config)));
+		}
+
+		const { data, errors } = await (client as any).models.ProductInstance.update(updateInput);
+
+		if (errors) {
+			console.error("[updateProductInstance] GraphQL errors:", errors);
+			throw new AppError(
+				"Failed to update product instance",
+				"PRODUCT_INSTANCE_UPDATE_ERROR",
+				500,
+				{ errors }
+			);
+		}
+
+		return data as ProductInstance;
+	} catch (error) {
+		console.error("[updateProductInstance] Error updating product instance:", error);
+		if (error instanceof AppError) {
+			throw error;
+		}
+		throw new AppError(
+			"Failed to update product instance",
+			"PRODUCT_INSTANCE_UPDATE_ERROR",
+			500,
+			{ originalError: error }
+		);
+	}
+}
+
+/**
+ * Delete a product instance
+ *
+ * @example
+ * ```typescript
+ * import { deleteProductInstance } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * await deleteProductInstance(client, 'instance-123');
+ * ```
+ */
+export async function deleteProductInstance<TClient = any>(
+	client: TClient,
+	id: string,
+): Promise<boolean> {
+	try {
+		const { errors } = await (client as any).models.ProductInstance.delete({ id });
+
+		if (errors) {
+			console.error("[deleteProductInstance] GraphQL errors:", errors);
+			throw new AppError(
+				"Failed to delete product instance",
+				"PRODUCT_INSTANCE_DELETE_ERROR",
+				500,
+				{ errors }
+			);
+		}
+
+		return true;
+	} catch (error) {
+		console.error("[deleteProductInstance] Error deleting product instance:", error);
+		if (error instanceof AppError) {
+			throw error;
+		}
+		throw new AppError(
+			"Failed to delete product instance",
+			"PRODUCT_INSTANCE_DELETE_ERROR",
+			500,
+			{ originalError: error }
+		);
+	}
+}
+
+/**
+ * Toggle the enabled status of a product instance
+ *
+ * @example
+ * ```typescript
+ * import { toggleProductInstanceEnabled } from '@htlkg/data/mutations';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const instance = await toggleProductInstanceEnabled(client, 'instance-123', true);
+ * ```
+ */
+export async function toggleProductInstanceEnabled<TClient = any>(
+	client: TClient,
+	id: string,
+	enabled: boolean,
+): Promise<ProductInstance | null> {
+	try {
+		const { data, errors } = await (client as any).models.ProductInstance.update({
+			id,
+			enabled,
+			lastUpdated: getCurrentTimestamp(),
+			updatedBy: await getUserIdentifier(),
+		});
+
+		if (errors) {
+			console.error("[toggleProductInstanceEnabled] GraphQL errors:", errors);
+			throw new AppError(
+				"Failed to toggle product instance",
+				"PRODUCT_INSTANCE_TOGGLE_ERROR",
+				500,
+				{ errors }
+			);
+		}
+
+		return data as ProductInstance;
+	} catch (error) {
+		console.error("[toggleProductInstanceEnabled] Error toggling product instance:", error);
+		if (error instanceof AppError) {
+			throw error;
+		}
+		throw new AppError(
+			"Failed to toggle product instance",
+			"PRODUCT_INSTANCE_TOGGLE_ERROR",
+			500,
+			{ originalError: error }
+		);
+	}
+}