esender-email-editor 1.0.3 → 1.1.2

package/dist/index.d.ts

@@ -23,6 +23,7 @@ interface TemplateDocument {
     _id: string;
     userId: string;
     projectId: string;
+    templateId?: string;
     HTML: string;
     JSON: unknown;
     createdAt?: string;
@@ -34,8 +35,45 @@ interface TemplateApiResponse {
     template?: TemplateDocument;
 }
 
+/**
+ * Editor event callbacks exposed to consumers via <Package />.
+ *
+ * Internal components reach these through `useEditorEvents()` instead of
+ * prop-drilling. Callbacks are stored in a ref so re-renders never re-fire
+ * subscribers, and a no-op fallback is returned when a callback is unset —
+ * call sites don't need to null-check.
+ */
+interface MediaUploadEvent {
+    url: string;
+    /** Original File object the user picked, if available. */
+    file?: File;
+    /** Raw API response body, untyped — varies by backend. */
+    response?: unknown;
+}
+interface SaveEvent {
+    projectId: string;
+    templateId?: string;
+    /** API response body from the save call. */
+    response: unknown;
+}
+interface LoadEvent {
+    projectId: string;
+    templateId?: string;
+    /** API response body from the load call. */
+    response: unknown;
+}
+interface EditorEventCallbacks {
+    onSave?: (event: SaveEvent) => void;
+    onLoad?: (event: LoadEvent) => void;
+    onTemplateChange?: (json: unknown) => void;
+    onHtmlExport?: (html: string) => void;
+    onMediaUpload?: (event: MediaUploadEvent) => void;
+}
+
 interface SaveTemplateOptions {
     projectId: string;
+    /** Provide to update an existing template instead of creating a new one. */
+    templateId?: string;
 }
 interface LoadTemplateOptions {
     projectId: string;
@@ -48,7 +86,8 @@ interface EditorHandle {
     loadJson: (json: string, raw?: boolean) => void;
     /**
      * Export the current editor state (HTML + JSON) and persist it to the
-     * eSender template API. apiKey comes from the Package's prop.
+     * template API. apiKey comes from the Package's prop. Pass `templateId` to
+     * update an existing template.
      */
     saveTemplate: (options: SaveTemplateOptions) => Promise<TemplateApiResponse>;
     /**
@@ -57,10 +96,10 @@ interface EditorHandle {
      */
     loadTemplate: (options: LoadTemplateOptions) => Promise<TemplateApiResponse>;
 }
-interface PackageProps {
+interface PackageProps extends EditorEventCallbacks {
     apiKey: string;
     /**
-     * @deprecated The new eSender license flow does not use projectId. Kept for
+     * @deprecated The license flow does not use projectId. Kept for
      * backwards-compatible prop signatures during the migration. Ignored at runtime.
      */
     projectId?: string;
@@ -71,4 +110,4 @@ interface PackageProps {
 declare const Package: React.ForwardRefExoticComponent<PackageProps & React.RefAttributes<EditorHandle>>;
 
 export { Package, Package as default };
-export type { EditorHandle, LicenseError, LicenseErrorCode, LoadTemplateOptions, PackageProps, RefreshTokenResponse, SaveTemplateOptions, TemplateApiResponse, TemplateDocument, VerifyLicenseResponse };
+export type { EditorEventCallbacks, EditorHandle, LicenseError, LicenseErrorCode, LoadEvent, LoadTemplateOptions, MediaUploadEvent, PackageProps, RefreshTokenResponse, SaveEvent, SaveTemplateOptions, TemplateApiResponse, TemplateDocument, VerifyLicenseResponse };