Skip to content

The open-source full-stack studio for Opus 5.5 motion video. Reverse engineering for any video. Code video with HTML: recreate, edit and render. BYOA + BYOK · Motion.md · Images, Video, Music & Voice.

2.1 KB
Raw Blame
import { useCallback } from "react";
import type { DomEditSelection } from "../components/editor/domEditingTypes";
import { getStudioSaveErrorMessage, trackStudioSaveFailure } from "../utils/studioSaveDiagnostics";
import type { CommitMutation, CommitMutationOptions } from "./gsapScriptCommitTypes";

type TrackGsapSaveFailure = (
  error: unknown,
  selection: DomEditSelection,
  mutation: Record<string, unknown>,
  label?: string,
) => void;

function getGsapMutationType(mutation: Record<string, unknown>): string {
  return typeof mutation.type === "string" ? mutation.type : "gsap";
}

export function useGsapSaveFailureTelemetry(activeCompPath: string | null): TrackGsapSaveFailure {
  return useCallback(
    (error, selection, mutation, label) => {
      trackStudioSaveFailure({
        source: "gsap_commit",
        error,
        filePath: selection.sourceFile ?? activeCompPath ?? "index.html",
        mutationType: getGsapMutationType(mutation),
        label,
        targetId: selection.id,
        targetSelector: selection.selector,
        targetSourceFile: selection.sourceFile,
      });
    },
    [activeCompPath],
  );
}

export function useSafeGsapCommitMutation(
  commitMutation: CommitMutation,
  trackGsapSaveFailure: TrackGsapSaveFailure,
  showToast?: (message: string, tone?: "error" | "info") => void,
) {
  return useCallback(
    (
      selection: DomEditSelection,
      mutation: Record<string, unknown>,
      options: CommitMutationOptions,
    ): Promise<void> =>
      // Return the chain so awaiting consumers (gesture commit, enable-keyframes)
      // run their post-actions AFTER the server save settles, not immediately.
      // The `.catch` handles the failure (toast + telemetry) and resolves the
      // chain, so awaiters see a settled (success-after-handled) promise rather
      // than an unhandled rejection.
      commitMutation(selection, mutation, options).catch((error) => {
        trackGsapSaveFailure(error, selection, mutation, options.label);
        showToast?.(`Couldn't save animation: ${getStudioSaveErrorMessage(error)}`, "error");
      }),
    [commitMutation, trackGsapSaveFailure, showToast],
  );
}