@supernova-studio/client 0.59.17 → 0.59.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supernova-studio/client",
-  "version": "0.59.17",
+  "version": "0.59.19",
   "description": "Supernova Data Models",
   "source": "src/index.ts",
   "main": "dist/index.js",

package/src/api/dto/elements/documentation/page-actions-v2.ts

@@ -7,6 +7,7 @@ import {
   DTOMoveDocumentationPageInputV2,
   DTORestoreDocumentationGroupInput,
   DTORestoreDocumentationPageInput,
+  DTOUpdateDocumentationPageDocumentInputV2,
   DTOUpdateDocumentationPageInputV2,
 } from "./page-v2";
 
@@ -28,6 +29,11 @@ export const DTODocumentationPageUpdateActionOutputV2 = z.object({
   output: SuccessPayload,
 });
 
+export const DTODocumentationPageUpdateDocumentActionOutputV2 = z.object({
+  type: z.literal("DocumentationPageUpdateDocument"),
+  output: SuccessPayload,
+});
+
 export const DTODocumentationPageMoveActionOutputV2 = z.object({
   type: z.literal("DocumentationPageMove"),
   output: SuccessPayload,
@@ -60,6 +66,9 @@ export const DTODocumentationPageApprovalStateChangeActionOutput = z.object({
 
 export type DTODocumentationPageCreateActionOutputV2 = z.infer<typeof DTODocumentationPageCreateActionOutputV2>;
 export type DTODocumentationPageUpdateActionOutputV2 = z.infer<typeof DTODocumentationPageUpdateActionOutputV2>;
+export type DTODocumentationPageUpdateDocumentActionOutputV2 = z.infer<
+  typeof DTODocumentationPageUpdateDocumentActionOutputV2
+>;
 export type DTODocumentationPageMoveActionOutputV2 = z.infer<typeof DTODocumentationPageMoveActionOutputV2>;
 export type DTODocumentationPageDuplicateActionOutputV2 = z.infer<typeof DTODocumentationPageDuplicateActionOutputV2>;
 export type DTODocumentationPageDeleteActionOutputV2 = z.infer<typeof DTODocumentationPageDeleteActionOutputV2>;
@@ -82,6 +91,11 @@ export const DTODocumentationPageUpdateActionInputV2 = z.object({
   input: DTOUpdateDocumentationPageInputV2,
 });
 
+export const DTODocumentationPageUpdateDocumentActionInputV2 = z.object({
+  type: z.literal("DocumentationPageUpdateDocument"),
+  input: DTOUpdateDocumentationPageDocumentInputV2,
+});
+
 export const DTODocumentationPageMoveActionInputV2 = z.object({
   type: z.literal("DocumentationPageMove"),
   input: DTOMoveDocumentationPageInputV2,
@@ -114,6 +128,9 @@ export const DTODocumentationPageApprovalStateChangeActionInput = z.object({
 
 export type DTODocumentationPageCreateActionInputV2 = z.infer<typeof DTODocumentationPageCreateActionInputV2>;
 export type DTODocumentationPageUpdateActionInputV2 = z.infer<typeof DTODocumentationPageUpdateActionInputV2>;
+export type DTODocumentationPageUpdateDocumentActionInputV2 = z.infer<
+  typeof DTODocumentationPageUpdateDocumentActionInputV2
+>;
 export type DTODocumentationPageMoveActionInputV2 = z.infer<typeof DTODocumentationPageMoveActionInputV2>;
 export type DTODocumentationPageDuplicateActionInputV2 = z.infer<typeof DTODocumentationPageDuplicateActionInputV2>;
 export type DTODocumentationPageDeleteActionInputV2 = z.infer<typeof DTODocumentationPageDeleteActionInputV2>;

package/src/api/dto/elements/documentation/page-v2.ts

@@ -1,4 +1,4 @@
-import { DocumentationPageApprovalState } from "@supernova-studio/model";
+import { DocumentationPageApprovalState, DocumentationPageContentItem } from "@supernova-studio/model";
 import { z } from "zod";
 import { DTODocumentationPageApprovalState } from "../../documentation";
 import { DTODocumentationDraftState } from "./draft-state";
@@ -64,7 +64,7 @@ export const DTOCreateDocumentationPageInputV2 = z.object({
 });
 
 export const DTOUpdateDocumentationPageInputV2 = z.object({
-  // Identifier of the group to update
+  // Identifier of the page to update
   id: z.string(),
 
   // Page properties
@@ -72,6 +72,14 @@ export const DTOUpdateDocumentationPageInputV2 = z.object({
   configuration: DTODocumentationItemConfigurationV2.partial().optional(),
 });
 
+export const DTOUpdateDocumentationPageDocumentInputV2 = z.object({
+  // Identifier of the page to update
+  id: z.string(),
+
+  // Page properties
+  documentItems: z.array(DocumentationPageContentItem),
+});
+
 export const DTOMoveDocumentationPageInputV2 = z.object({
   // Identifier of the group to update
   id: z.string(),
@@ -115,6 +123,7 @@ export const DTODocumentationPageApprovalStateChangeInput = z.object({
 
 export type DTOCreateDocumentationPageInputV2 = z.infer<typeof DTOCreateDocumentationPageInputV2>;
 export type DTOUpdateDocumentationPageInputV2 = z.infer<typeof DTOUpdateDocumentationPageInputV2>;
+export type DTOUpdateDocumentationPageDocumentInputV2 = z.infer<typeof DTOUpdateDocumentationPageDocumentInputV2>;
 export type DTOMoveDocumentationPageInputV2 = z.infer<typeof DTOMoveDocumentationPageInputV2>;
 export type DTODuplicateDocumentationPageInputV2 = z.infer<typeof DTODuplicateDocumentationPageInputV2>;
 export type DTODeleteDocumentationPageInputV2 = z.infer<typeof DTODeleteDocumentationPageInputV2>;

package/src/api/dto/elements/elements-action-v2.ts

@@ -32,6 +32,8 @@ import {
   DTODocumentationPageRestoreActionOutput,
   DTODocumentationPageUpdateActionInputV2,
   DTODocumentationPageUpdateActionOutputV2,
+  DTODocumentationPageUpdateDocumentActionInputV2,
+  DTODocumentationPageUpdateDocumentActionOutputV2,
 } from "./documentation/page-actions-v2";
 import {
   DTOFigmaNodeRenderActionInput,
@@ -48,6 +50,7 @@ export const DTOElementActionOutput = z.discriminatedUnion("type", [
   // Documentation pages
   DTODocumentationPageCreateActionOutputV2,
   DTODocumentationPageUpdateActionOutputV2,
+  DTODocumentationPageUpdateDocumentActionOutputV2,
   DTODocumentationPageMoveActionOutputV2,
   DTODocumentationPageDuplicateActionOutputV2,
   DTODocumentationPageDeleteActionOutputV2,
@@ -84,6 +87,7 @@ export const DTOElementActionInput = z
     // Documentation pages
     DTODocumentationPageCreateActionInputV2,
     DTODocumentationPageUpdateActionInputV2,
+    DTODocumentationPageUpdateDocumentActionInputV2,
     DTODocumentationPageMoveActionInputV2,
     DTODocumentationPageDuplicateActionInputV2,
     DTODocumentationPageDeleteActionInputV2,

package/src/utils/index.ts

@@ -1,3 +1,4 @@
 export * from "./figma";
 export * from "./hash";
 export * from "./query";
+export * from "./redirect-validation";

package/src/utils/redirect-validation.ts

@@ -0,0 +1,76 @@
+export const exhaustiveInvalidUriPaths = {
+  emptyPath: "",
+  spacesInPath: "/invalid path/with spaces",
+  specialCharacter1: "/path/with|invalid>characters",
+  specialCharacter2: "/path/with<invalid*characters",
+  specialCharacter3: "/path/{invalid}?characters",
+  consecutiveSlashes: "/path//with///too/many/slashes",
+  unencodedPercent: "/path/with/unencoded%percent",
+  unencodedSpaces: "/path/with unencoded spaces",
+  fragmentIdentifier: "/path/with#fragment",
+  queryParameters: "/path/with?query=parameter",
+  nullCharacter: "/path/with/\u0000nullcharacter",
+  onlySlash: "/",
+  controlCharacter: "/path/with/control\0character",
+  extremelyLongPath: "/" + "a".repeat(2047),
+  invalidStartCharacter: "///path/starting/with/slashes",
+  invalidStartCharacterColon: ":/path/starting/with/colon",
+  invalidTrailingDot: "/path/ending/with/dot.",
+  invalidPercentEncoding1: "/path/with/%2",
+  invalidPercentEncoding2: "/path/with/%ZZ",
+  invalidPercentEncoding3: "/path/with/%G1",
+  reservedCharacter1: "/path/with?<reserved>",
+  reservedCharacter2: '/path/with/"quotes"',
+  reservedCharacter3: "/path/with/[brackets]",
+  reservedCharacter4: "/path/with/\\backslashes",
+  nonAscii1: "/path/with/你好",
+  nonAscii2: "/path/with/emoji/😃",
+  mixedEncodingPath: "/path/%41A%42B%C3%28",
+  directoryTraversal1: "/path/../../etc/passwd",
+  directoryTraversal2: "/path/./././",
+};
+
+type ValidationErrorReason = "TooLong" | "InvalidURI" | "Empty" | "ContainsQuery" | "ContainsFragment";
+
+export function isValidRedirectPath(path: string): { isValid: boolean; reason: ValidationErrorReason | undefined } {
+  const trimmedPath = path.toLowerCase().trim();
+  const url = "https://www.example.com" + trimmedPath;
+  if (url.length > 2048) {
+    return {
+      isValid: false,
+      reason: "TooLong",
+    };
+  }
+  if (trimmedPath === "") {
+    return {
+      isValid: false,
+      reason: "Empty",
+    };
+  }
+  if (url === "/") {
+    return {
+      isValid: false,
+      reason: "Empty",
+    };
+  }
+
+  if (url.includes("?")) {
+    return {
+      isValid: false,
+      reason: "ContainsQuery",
+    };
+  }
+  if (url.includes("#")) {
+    return {
+      isValid: false,
+      reason: "ContainsFragment",
+    };
+  }
+
+  const regex = /^\/[A-Za-z0-9_-]+(\/[A-Za-z0-9_-]+)*$/;
+  const isValid = regex.test(trimmedPath);
+  return {
+    isValid: regex.test(trimmedPath),
+    reason: !isValid ? "InvalidURI" : undefined,
+  };
+}