react-semaphor 0.1.487 → 0.1.488

package/dist/types/data-app-sdk.d.ts

@@ -15331,6 +15331,7 @@ declare const matrixExecutionShape: {
             failures: z.ZodReadonly<z.ZodArray<z.ZodObject<{
                 code: z.ZodEnum<["invalid_request", "unsupported_capability", "stale_cursor", "forbidden", "budget_exceeded", "source_truncated", "execution_failed", "cancelled"]>;
                 message: z.ZodString;
+                detail: z.ZodOptional<z.ZodString>;
                 retryable: z.ZodBoolean;
                 scope: z.ZodUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"operation">;
@@ -15358,6 +15359,7 @@ declare const matrixExecutionShape: {
                     requestId: string;
                 };
                 retryable: boolean;
+                detail?: string | undefined;
             }, {
                 code: "invalid_request" | "unsupported_capability" | "stale_cursor" | "forbidden" | "budget_exceeded" | "source_truncated" | "execution_failed" | "cancelled";
                 message: string;
@@ -15368,6 +15370,7 @@ declare const matrixExecutionShape: {
                     requestId: string;
                 };
                 retryable: boolean;
+                detail?: string | undefined;
             }>, "many">>;
         }, "strict", z.ZodTypeAny, {
             queryIdentity: string;
@@ -15576,6 +15579,7 @@ declare const matrixExecutionShape: {
                     requestId: string;
                 };
                 retryable: boolean;
+                detail?: string | undefined;
             }[];
         }, {
             queryIdentity: string;
@@ -15784,6 +15788,7 @@ declare const matrixExecutionShape: {
                     requestId: string;
                 };
                 retryable: boolean;
+                detail?: string | undefined;
             }[];
         }>, {
             queryIdentity: string;
@@ -15992,6 +15997,7 @@ declare const matrixExecutionShape: {
                     requestId: string;
                 };
                 retryable: boolean;
+                detail?: string | undefined;
             }[];
         }, {
             queryIdentity: string;
@@ -16200,6 +16206,7 @@ declare const matrixExecutionShape: {
                     requestId: string;
                 };
                 retryable: boolean;
+                detail?: string | undefined;
             }[];
         }>;
     }, "strict", z.ZodTypeAny, {
@@ -16411,6 +16418,7 @@ declare const matrixExecutionShape: {
                     requestId: string;
                 };
                 retryable: boolean;
+                detail?: string | undefined;
             }[];
         };
     }, {
@@ -16622,6 +16630,7 @@ declare const matrixExecutionShape: {
                     requestId: string;
                 };
                 retryable: boolean;
+                detail?: string | undefined;
             }[];
         };
     }>>;
@@ -16630,6 +16639,7 @@ declare const matrixExecutionShape: {
         matrixFailure: z.ZodOptional<z.ZodObject<{
             code: z.ZodEnum<["invalid_request", "unsupported_capability", "stale_cursor", "forbidden", "budget_exceeded", "source_truncated", "execution_failed", "cancelled"]>;
             message: z.ZodString;
+            detail: z.ZodOptional<z.ZodString>;
             retryable: z.ZodBoolean;
             scope: z.ZodUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"operation">;
@@ -16657,6 +16667,7 @@ declare const matrixExecutionShape: {
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }, {
             code: "invalid_request" | "unsupported_capability" | "stale_cursor" | "forbidden" | "budget_exceeded" | "source_truncated" | "execution_failed" | "cancelled";
             message: string;
@@ -16667,12 +16678,14 @@ declare const matrixExecutionShape: {
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }>>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         rowLimitExceeded: z.ZodBoolean;
         matrixFailure: z.ZodOptional<z.ZodObject<{
             code: z.ZodEnum<["invalid_request", "unsupported_capability", "stale_cursor", "forbidden", "budget_exceeded", "source_truncated", "execution_failed", "cancelled"]>;
             message: z.ZodString;
+            detail: z.ZodOptional<z.ZodString>;
             retryable: z.ZodBoolean;
             scope: z.ZodUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"operation">;
@@ -16700,6 +16713,7 @@ declare const matrixExecutionShape: {
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }, {
             code: "invalid_request" | "unsupported_capability" | "stale_cursor" | "forbidden" | "budget_exceeded" | "source_truncated" | "execution_failed" | "cancelled";
             message: string;
@@ -16710,12 +16724,14 @@ declare const matrixExecutionShape: {
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }>>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         rowLimitExceeded: z.ZodBoolean;
         matrixFailure: z.ZodOptional<z.ZodObject<{
             code: z.ZodEnum<["invalid_request", "unsupported_capability", "stale_cursor", "forbidden", "budget_exceeded", "source_truncated", "execution_failed", "cancelled"]>;
             message: z.ZodString;
+            detail: z.ZodOptional<z.ZodString>;
             retryable: z.ZodBoolean;
             scope: z.ZodUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"operation">;
@@ -16743,6 +16759,7 @@ declare const matrixExecutionShape: {
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }, {
             code: "invalid_request" | "unsupported_capability" | "stale_cursor" | "forbidden" | "budget_exceeded" | "source_truncated" | "execution_failed" | "cancelled";
             message: string;
@@ -16753,6 +16770,7 @@ declare const matrixExecutionShape: {
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }>>;
     }, z.ZodTypeAny, "passthrough">>;
 };
@@ -27178,6 +27196,8 @@ declare const matrixResultSchema: z.ZodObject<{
         failures: z.ZodReadonly<z.ZodArray<z.ZodObject<{
             code: z.ZodEnum<["invalid_request", "unsupported_capability", "stale_cursor", "forbidden", "budget_exceeded", "source_truncated", "execution_failed", "cancelled"]>;
             message: z.ZodString;
+            /** Technical cause for dashboard owners; never shown as the primary copy. */
+            detail: z.ZodOptional<z.ZodString>;
             retryable: z.ZodBoolean;
             scope: z.ZodUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"operation">;
@@ -27205,6 +27225,7 @@ declare const matrixResultSchema: z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }, {
             code: "invalid_request" | "unsupported_capability" | "stale_cursor" | "forbidden" | "budget_exceeded" | "source_truncated" | "execution_failed" | "cancelled";
             message: string;
@@ -27215,6 +27236,7 @@ declare const matrixResultSchema: z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }>, "many">>;
     }, "strict", z.ZodTypeAny, {
         queryIdentity: string;
@@ -27423,6 +27445,7 @@ declare const matrixResultSchema: z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }[];
     }, {
         queryIdentity: string;
@@ -27631,6 +27654,7 @@ declare const matrixResultSchema: z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }[];
     }>, {
         queryIdentity: string;
@@ -27839,6 +27863,7 @@ declare const matrixResultSchema: z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }[];
     }, {
         queryIdentity: string;
@@ -28047,6 +28072,7 @@ declare const matrixResultSchema: z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }[];
     }>;
 }, "strict", z.ZodTypeAny, {
@@ -28258,6 +28284,7 @@ declare const matrixResultSchema: z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }[];
     };
 }, {
@@ -28469,6 +28496,7 @@ declare const matrixResultSchema: z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }[];
     };
 }>;
@@ -31112,6 +31140,8 @@ declare const matrixWindowSchema: z.ZodEffects<z.ZodObject<{
     failures: z.ZodReadonly<z.ZodArray<z.ZodObject<{
         code: z.ZodEnum<["invalid_request", "unsupported_capability", "stale_cursor", "forbidden", "budget_exceeded", "source_truncated", "execution_failed", "cancelled"]>;
         message: z.ZodString;
+        /** Technical cause for dashboard owners; never shown as the primary copy. */
+        detail: z.ZodOptional<z.ZodString>;
         retryable: z.ZodBoolean;
         scope: z.ZodUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"operation">;
@@ -31139,6 +31169,7 @@ declare const matrixWindowSchema: z.ZodEffects<z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     }, {
         code: "invalid_request" | "unsupported_capability" | "stale_cursor" | "forbidden" | "budget_exceeded" | "source_truncated" | "execution_failed" | "cancelled";
         message: string;
@@ -31149,6 +31180,7 @@ declare const matrixWindowSchema: z.ZodEffects<z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     }>, "many">>;
 }, "strict", z.ZodTypeAny, {
     queryIdentity: string;
@@ -31357,6 +31389,7 @@ declare const matrixWindowSchema: z.ZodEffects<z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     }[];
 }, {
     queryIdentity: string;
@@ -31565,6 +31598,7 @@ declare const matrixWindowSchema: z.ZodEffects<z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     }[];
 }>, {
     queryIdentity: string;
@@ -31773,6 +31807,7 @@ declare const matrixWindowSchema: z.ZodEffects<z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     }[];
 }, {
     queryIdentity: string;
@@ -31981,6 +32016,7 @@ declare const matrixWindowSchema: z.ZodEffects<z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     }[];
 }>;
 

package/dist/types/main.d.ts

@@ -10375,6 +10375,8 @@ export declare type ExportDataPayload = {
     sql: string;
 };
 
+declare type ExportDownloadOutcome = 'opened' | 'denied';
+
 export declare class ExportError extends Error {
     readonly status: number;
     readonly details?: ExportApiError | undefined;
@@ -10436,20 +10438,25 @@ export declare interface ExportJobStatus {
 }
 
 /**
- * Individual export notification item.
+ * One background export. Visual reference: semaphor-app /design/export-tray.
  *
- * Shows different UI based on export status:
- * - In Progress: Progress bar with percentage
- * - Completed: Download button with file size
- * - Failed: Error message with dismiss option
+ * A row is a status dot, the title, one metadata line and one text action.
+ * At rest the metadata line shows only the time; rows and size disclose on
+ * hover or focus, in the same gesture that reveals Remove. A ready export
+ * always offers Download; the link is resolved on click when it is missing.
  */
-export declare function ExportNotificationItem({ export: exp, onRemove, }: ExportNotificationItemProps): JSX.Element;
+export declare function ExportNotificationItem({ export: exp, onRemove, onDownload, }: ExportNotificationItemProps): JSX.Element;
 
 declare interface ExportNotificationItemProps {
     /** The export data to display */
     export: ActiveExport;
     /** Called when user clicks dismiss/remove */
     onRemove?: (id: string) => void;
+    /**
+     * Opens the file, resolving a fresh signed link first when the row holds
+     * none. Resolves 'denied' when the link could not be signed.
+     */
+    onDownload?: (exp: ActiveExport) => Promise<ExportDownloadOutcome>;
 }
 
 /**
@@ -11639,6 +11646,8 @@ declare type MatrixFailure = z.infer<typeof matrixFailureSchema>;
 declare const matrixFailureSchema: z.ZodObject<{
     code: z.ZodEnum<["invalid_request", "unsupported_capability", "stale_cursor", "forbidden", "budget_exceeded", "source_truncated", "execution_failed", "cancelled"]>;
     message: z.ZodString;
+    /** Technical cause for dashboard owners; never shown as the primary copy. */
+    detail: z.ZodOptional<z.ZodString>;
     retryable: z.ZodBoolean;
     scope: z.ZodUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"operation">;
@@ -11666,6 +11675,7 @@ declare const matrixFailureSchema: z.ZodObject<{
         requestId: string;
     };
     retryable: boolean;
+    detail?: string | undefined;
 }, {
     code: "invalid_request" | "unsupported_capability" | "stale_cursor" | "forbidden" | "budget_exceeded" | "source_truncated" | "execution_failed" | "cancelled";
     message: string;
@@ -11676,6 +11686,7 @@ declare const matrixFailureSchema: z.ZodObject<{
         requestId: string;
     };
     retryable: boolean;
+    detail?: string | undefined;
 }>;
 
 declare type MatrixField = z.infer<typeof matrixFieldSchema>;
@@ -14392,6 +14403,8 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         failures: z.ZodReadonly<z.ZodArray<z.ZodObject<{
             code: z.ZodEnum<["invalid_request", "unsupported_capability", "stale_cursor", "forbidden", "budget_exceeded", "source_truncated", "execution_failed", "cancelled"]>;
             message: z.ZodString;
+            /** Technical cause for dashboard owners; never shown as the primary copy. */
+            detail: z.ZodOptional<z.ZodString>;
             retryable: z.ZodBoolean;
             scope: z.ZodUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"operation">;
@@ -14419,6 +14432,7 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }, {
             code: "invalid_request" | "unsupported_capability" | "stale_cursor" | "forbidden" | "budget_exceeded" | "source_truncated" | "execution_failed" | "cancelled";
             message: string;
@@ -14429,6 +14443,7 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }>, "many">>;
     }, "strict", z.ZodTypeAny, {
         queryIdentity: string;
@@ -14637,6 +14652,7 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }[];
     }, {
         queryIdentity: string;
@@ -14845,6 +14861,7 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }[];
     }>, {
         queryIdentity: string;
@@ -15053,6 +15070,7 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }[];
     }, {
         queryIdentity: string;
@@ -15261,6 +15279,7 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }[];
     }>;
 }, "strict", z.ZodTypeAny, {
@@ -15472,6 +15491,7 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }[];
     };
 }, {
@@ -15683,6 +15703,7 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }[];
     };
 }>, z.ZodObject<{
@@ -15690,6 +15711,8 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
     failure: z.ZodObject<{
         code: z.ZodEnum<["invalid_request", "unsupported_capability", "stale_cursor", "forbidden", "budget_exceeded", "source_truncated", "execution_failed", "cancelled"]>;
         message: z.ZodString;
+        /** Technical cause for dashboard owners; never shown as the primary copy. */
+        detail: z.ZodOptional<z.ZodString>;
         retryable: z.ZodBoolean;
         scope: z.ZodUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"operation">;
@@ -15717,6 +15740,7 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     }, {
         code: "invalid_request" | "unsupported_capability" | "stale_cursor" | "forbidden" | "budget_exceeded" | "source_truncated" | "execution_failed" | "cancelled";
         message: string;
@@ -15727,6 +15751,7 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     }>;
 }, "strict", z.ZodTypeAny, {
     status: "failed";
@@ -15740,6 +15765,7 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     };
 }, {
     status: "failed";
@@ -15753,6 +15779,7 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     };
 }>]>, {
     status: "partial" | "success";
@@ -15963,6 +15990,7 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }[];
     };
 } | {
@@ -15977,6 +16005,7 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     };
 }, {
     status: "partial" | "success";
@@ -16187,6 +16216,7 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
                 requestId: string;
             };
             retryable: boolean;
+            detail?: string | undefined;
         }[];
     };
 } | {
@@ -16201,6 +16231,7 @@ declare const matrixWindowOutcomeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     };
 }>;
 
@@ -18835,6 +18866,8 @@ declare const matrixWindowSchema: z.ZodEffects<z.ZodObject<{
     failures: z.ZodReadonly<z.ZodArray<z.ZodObject<{
         code: z.ZodEnum<["invalid_request", "unsupported_capability", "stale_cursor", "forbidden", "budget_exceeded", "source_truncated", "execution_failed", "cancelled"]>;
         message: z.ZodString;
+        /** Technical cause for dashboard owners; never shown as the primary copy. */
+        detail: z.ZodOptional<z.ZodString>;
         retryable: z.ZodBoolean;
         scope: z.ZodUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"operation">;
@@ -18862,6 +18895,7 @@ declare const matrixWindowSchema: z.ZodEffects<z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     }, {
         code: "invalid_request" | "unsupported_capability" | "stale_cursor" | "forbidden" | "budget_exceeded" | "source_truncated" | "execution_failed" | "cancelled";
         message: string;
@@ -18872,6 +18906,7 @@ declare const matrixWindowSchema: z.ZodEffects<z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     }>, "many">>;
 }, "strict", z.ZodTypeAny, {
     queryIdentity: string;
@@ -19080,6 +19115,7 @@ declare const matrixWindowSchema: z.ZodEffects<z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     }[];
 }, {
     queryIdentity: string;
@@ -19288,6 +19324,7 @@ declare const matrixWindowSchema: z.ZodEffects<z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     }[];
 }>, {
     queryIdentity: string;
@@ -19496,6 +19533,7 @@ declare const matrixWindowSchema: z.ZodEffects<z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     }[];
 }, {
     queryIdentity: string;
@@ -19704,6 +19742,7 @@ declare const matrixWindowSchema: z.ZodEffects<z.ZodObject<{
             requestId: string;
         };
         retryable: boolean;
+        detail?: string | undefined;
     }[];
 }>;
 

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.487",
+  "version": "0.1.488",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",