doc-detective-common 4.0.0-beta.0-dev.4 → 4.0.0-beta.0-dev.5

package/src/schemas/build/saveCookie_v3.schema.json

@@ -1,149 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "saveCookie",
-  "description": "Save a specific browser cookie to a file or environment variable for later reuse.",
-  "anyOf": [
-    {
-      "$ref": "#/components/schemas/string"
-    },
-    {
-      "$ref": "#/components/schemas/object"
-    }
-  ],
-  "components": {
-    "schemas": {
-      "string": {
-        "type": "string",
-        "title": "Cookie name",
-        "description": "Name of the specific cookie to save. Will be saved to a default file path or environment variable.",
-        "pattern": "^[A-Za-z0-9_./\\-]+$",
-        "transform": [
-          "trim"
-        ]
-      },
-      "object": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "$schema": {
-            "description": "Optional self-describing schema URI for linters",
-            "type": "string",
-            "format": "uri-reference"
-          },
-          "name": {
-            "type": "string",
-            "title": "Cookie name",
-            "description": "Name of the specific cookie to save.",
-            "pattern": "^[A-Za-z0-9_.-]+$",
-            "transform": [
-              "trim"
-            ]
-          },
-          "variable": {
-            "type": "string",
-            "title": "Environment variable name",
-            "description": "Environment variable name to store the cookie as JSON string.",
-            "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
-            "transform": [
-              "trim"
-            ]
-          },
-          "path": {
-            "type": "string",
-            "title": "Cookie file path",
-            "description": "File path to save the cookie, relative to directory. Uses Netscape cookie format.",
-            "transform": [
-              "trim"
-            ]
-          },
-          "directory": {
-            "type": "string",
-            "title": "Directory path",
-            "description": "Directory to save the cookie file. If not specified, uses output directory.",
-            "transform": [
-              "trim"
-            ]
-          },
-          "overwrite": {
-            "type": "boolean",
-            "title": "Overwrite existing file",
-            "description": "Whether to overwrite existing cookie file.",
-            "default": false
-          },
-          "domain": {
-            "type": "string",
-            "title": "Cookie domain",
-            "description": "Specific domain to filter the cookie by (optional).",
-            "transform": [
-              "trim"
-            ]
-          }
-        },
-        "required": [
-          "name"
-        ],
-        "anyOf": [
-          {
-            "required": [
-              "path"
-            ],
-            "not": {
-              "required": [
-                "variable"
-              ]
-            }
-          },
-          {
-            "required": [
-              "variable"
-            ],
-            "not": {
-              "anyOf": [
-                {
-                  "required": [
-                    "path"
-                  ]
-                },
-                {
-                  "required": [
-                    "directory"
-                  ]
-                }
-              ]
-            }
-          }
-        ],
-        "title": "Save cookie (detailed)"
-      }
-    }
-  },
-  "examples": [
-    "session_token",
-    "test_env_cookie",
-    {
-      "name": "auth_cookie",
-      "path": "auth-cookie.txt"
-    },
-    {
-      "name": "session_token",
-      "variable": "SESSION_TOKEN"
-    },
-    {
-      "name": "test_cookie",
-      "path": "test-cookie.txt",
-      "overwrite": true
-    },
-    {
-      "name": "user_session",
-      "path": "user-session.txt",
-      "directory": "./test-data",
-      "overwrite": true
-    },
-    {
-      "name": "login_token",
-      "path": "login-token.txt",
-      "domain": "app.example.com"
-    }
-  ],
-  "$id": "/home/runner/work/doc-detective/doc-detective/src/common/src/schemas/src_schemas/saveCookie_v3.schema.json"
-}

package/src/schemas/build/saveScreenshot_v2.schema.json

@@ -1,150 +0,0 @@
-{
-  "title": "saveScreenshot",
-  "type": "object",
-  "description": "Takes a screenshot in PNG format.",
-  "properties": {
-    "id": {
-      "type": "string",
-      "description": "ID of the step."
-    },
-    "description": {
-      "type": "string",
-      "description": "Description of the step."
-    },
-    "action": {
-      "type": "string",
-      "const": "saveScreenshot",
-      "description": "The action to perform."
-    },
-    "path": {
-      "type": "string",
-      "description": "File path of the PNG file, relative to `directory`. If not specified, the file name is the ID of the step.",
-      "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)"
-    },
-    "directory": {
-      "type": "string",
-      "description": "Directory of the PNG file. If the directory doesn't exist, creates the directory."
-    },
-    "maxVariation": {
-      "type": "number",
-      "description": "Allowed variation in percentage of pixels between the new screenshot and the existing screenshot at `path`. If the difference between the new screenshot and the existing screenshot is greater than `maxVariation`, the step fails. If a screenshot doesn't exist at `path`, this value is ignored.",
-      "default": 5,
-      "minimum": 0,
-      "maximum": 100
-    },
-    "overwrite": {
-      "type": "string",
-      "description": "If `true`, overwrites the existing screenshot at `path` if it exists.\nIf `byVariation`, overwrites the existing screenshot at `path` if the difference between the new screenshot and the existing screenshot is greater than `maxVariation`.",
-      "enum": [
-        "true",
-        "false",
-        "byVariation"
-      ],
-      "default": "false"
-    },
-    "crop": {
-      "type": "object",
-      "description": "Crops the screenshot.",
-      "properties": {
-        "selector": {
-          "type": "string",
-          "description": "Selector of the element to crop the image to."
-        },
-        "padding": {
-          "oneOf": [
-            {
-              "type": "number",
-              "description": "Padding in pixels to add to the bounds of the element.",
-              "minimum": 0
-            },
-            {
-              "type": "object",
-              "properties": {
-                "top": {
-                  "type": "number",
-                  "minimum": 0
-                },
-                "right": {
-                  "type": "number",
-                  "minimum": 0
-                },
-                "bottom": {
-                  "type": "number",
-                  "minimum": 0
-                },
-                "left": {
-                  "type": "number",
-                  "minimum": 0
-                }
-              }
-            }
-          ]
-        }
-      },
-      "required": [
-        "selector"
-      ],
-      "additionalProperties": false
-    }
-  },
-  "dynamicDefaults": {
-    "id": "uuid"
-  },
-  "required": [
-    "action"
-  ],
-  "additionalProperties": false,
-  "examples": [
-    {
-      "action": "saveScreenshot"
-    },
-    {
-      "action": "saveScreenshot",
-      "path": "results.png"
-    },
-    {
-      "action": "saveScreenshot",
-      "path": "results.png",
-      "directory": "static/images"
-    },
-    {
-      "action": "saveScreenshot",
-      "path": "results.png",
-      "directory": "static/images",
-      "maxVariation": 10,
-      "overwrite": "byVariation"
-    },
-    {
-      "action": "saveScreenshot",
-      "path": "results.png",
-      "directory": "static/images",
-      "crop": {
-        "selector": "#element"
-      }
-    },
-    {
-      "action": "saveScreenshot",
-      "path": "results.png",
-      "directory": "static/images",
-      "crop": {
-        "selector": "#element",
-        "padding": 10
-      }
-    },
-    {
-      "action": "saveScreenshot",
-      "path": "results.png",
-      "directory": "static/images",
-      "crop": {
-        "selector": "#element",
-        "padding": {
-          "top": 10,
-          "right": 20,
-          "bottom": 30,
-          "left": 40
-        }
-      }
-    }
-  ],
-  "$id": "/home/runner/work/doc-detective/doc-detective/src/common/src/schemas/src_schemas/saveScreenshot_v2.schema.json"
-}

package/src/schemas/build/screenshot_v3.schema.json

@@ -1,250 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "screenshot",
-  "description": "Takes a screenshot in PNG format.",
-  "anyOf": [
-    {
-      "$ref": "#/components/schemas/path"
-    },
-    {
-      "$ref": "#/components/schemas/object"
-    },
-    {
-      "type": "boolean",
-      "title": "Capture screenshot",
-      "description": "If `true`, captures a screenshot. If `false`, doesn't capture a screenshot."
-    }
-  ],
-  "components": {
-    "schemas": {
-      "path": {
-        "title": "Screenshot (simple)",
-        "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
-        "type": "string",
-        "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
-        "transform": [
-          "trim"
-        ]
-      },
-      "object": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "path": {
-            "$ref": "#/components/schemas/path"
-          },
-          "directory": {
-            "type": "string",
-            "description": "Directory of the PNG file. If the directory doesn't exist, creates the directory.",
-            "transform": [
-              "trim"
-            ]
-          },
-          "maxVariation": {
-            "type": "number",
-            "description": "Allowed variation in percentage of pixels between the new screenshot and the existing screenshot at `path`. If the difference between the new screenshot and the existing screenshot is greater than `maxVariation`, the step fails. If a screenshot doesn't exist at `path`, this value is ignored.",
-            "default": 0.05,
-            "minimum": 0,
-            "maximum": 1
-          },
-          "overwrite": {
-            "type": "string",
-            "description": "If `true`, overwrites the existing screenshot at `path` if it exists.\nIf `aboveVariation`, overwrites the existing screenshot at `path` if the difference between the new screenshot and the existing screenshot is greater than `maxVariation`.",
-            "enum": [
-              "true",
-              "false",
-              "aboveVariation"
-            ],
-            "default": "aboveVariation"
-          },
-          "crop": {
-            "anyOf": [
-              {
-                "title": "Crop by element (simple)",
-                "type": "string",
-                "description": "Display text or selector of the element to screenshot."
-              },
-              {
-                "$ref": "#/components/schemas/crop_element"
-              }
-            ]
-          },
-          "sourceIntegration": {
-            "description": "Information about the source integration for this screenshot, enabling upload of changed files back to the source CMS. Set automatically during test resolution for files from integrations.",
-            "$ref": "/home/runner/work/doc-detective/doc-detective/src/common/src/schemas/build/sourceIntegration_v3.schema.json#"
-          }
-        },
-        "title": "Capture screenshot (detailed)"
-      },
-      "crop_element": {
-        "title": "Crop by element (detailed)",
-        "type": "object",
-        "description": "Crop the screenshot to a specific element.",
-        "additionalProperties": false,
-        "anyOf": [
-          {
-            "required": [
-              "selector"
-            ]
-          },
-          {
-            "required": [
-              "elementText"
-            ]
-          },
-          {
-            "required": [
-              "elementId"
-            ]
-          },
-          {
-            "required": [
-              "elementTestId"
-            ]
-          },
-          {
-            "required": [
-              "elementClass"
-            ]
-          },
-          {
-            "required": [
-              "elementAttribute"
-            ]
-          },
-          {
-            "required": [
-              "elementAria"
-            ]
-          }
-        ],
-        "properties": {
-          "elementText": {
-            "type": "string",
-            "description": "Display text of the element to screenshot."
-          },
-          "selector": {
-            "type": "string",
-            "description": "Selector of the element to screenshot."
-          },
-          "elementId": {
-            "type": "string",
-            "description": "ID attribute of the element to find. Supports exact match or regex pattern using /pattern/ syntax."
-          },
-          "elementTestId": {
-            "type": "string",
-            "description": "data-testid attribute of the element to find. Supports exact match or regex pattern using /pattern/ syntax."
-          },
-          "elementClass": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              }
-            ],
-            "description": "Class or array of classes that the element must have. Each class supports exact match or regex pattern using /pattern/ syntax. Element must have all specified classes."
-          },
-          "elementAttribute": {
-            "type": "object",
-            "description": "Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence.",
-            "additionalProperties": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "number"
-                },
-                {
-                  "type": "boolean"
-                }
-              ]
-            }
-          },
-          "elementAria": {
-            "type": "string",
-            "description": "Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax."
-          },
-          "padding": {
-            "anyOf": [
-              {
-                "title": "Padding (simple)",
-                "type": "number",
-                "description": "Padding in pixels to add to the bounds of the element.",
-                "minimum": 0
-              },
-              {
-                "$ref": "#/components/schemas/padding"
-              }
-            ]
-          }
-        }
-      },
-      "padding": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "top": {
-            "type": "number",
-            "minimum": 0
-          },
-          "right": {
-            "type": "number",
-            "minimum": 0
-          },
-          "bottom": {
-            "type": "number",
-            "minimum": 0
-          },
-          "left": {
-            "type": "number",
-            "minimum": 0
-          }
-        },
-        "title": "Padding (detailed)",
-        "description": "Padding in pixels to add to the bounds of the element."
-      }
-    }
-  },
-  "examples": [
-    true,
-    "image.png",
-    "static/images/image.png",
-    "/User/manny/projects/doc-detective/static/images/image.png",
-    {
-      "path": "image.png",
-      "directory": "static/images",
-      "maxVariation": 0.1,
-      "overwrite": "aboveVariation",
-      "crop": "#elementToScreenshot"
-    },
-    {
-      "path": "image.png",
-      "directory": "static/images",
-      "maxVariation": 0.1,
-      "overwrite": "aboveVariation"
-    },
-    {
-      "path": "image.png",
-      "directory": "static/images",
-      "maxVariation": 0.1,
-      "overwrite": "aboveVariation",
-      "crop": {
-        "selector": "#elementToScreenshot",
-        "elementText": "Element text",
-        "padding": {
-          "top": 0,
-          "right": 0,
-          "bottom": 0,
-          "left": 0
-        }
-      }
-    }
-  ],
-  "$id": "/home/runner/work/doc-detective/doc-detective/src/common/src/schemas/src_schemas/screenshot_v3.schema.json"
-}

package/src/schemas/build/setVariables_v2.schema.json

@@ -1,39 +0,0 @@
-{
-  "title": "setVariables",
-  "type": "object",
-  "description": "Load environment variables from a `.env` file.",
-  "properties": {
-    "id": {
-      "type": "string",
-      "description": "ID of the step."
-    },
-    "description": {
-      "type": "string",
-      "description": "Description of the step."
-    },
-    "action": {
-      "type": "string",
-      "const": "setVariables",
-      "description": "Action to perform."
-    },
-    "path": {
-      "type": "string",
-      "description": "Path to the `.env` file."
-    }
-  },
-  "dynamicDefaults": {
-    "id": "uuid"
-  },
-  "required": [
-    "action",
-    "path"
-  ],
-  "additionalProperties": false,
-  "examples": [
-    {
-      "action": "setVariables",
-      "path": ".env"
-    }
-  ],
-  "$id": "/home/runner/work/doc-detective/doc-detective/src/common/src/schemas/src_schemas/setVariables_v2.schema.json"
-}

package/src/schemas/build/sourceIntegration_v3.schema.json

@@ -1,51 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "sourceIntegration",
-  "description": "Information about the source integration for a file, enabling upload of changed files back to the source CMS.",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "type",
-    "integrationName"
-  ],
-  "properties": {
-    "type": {
-      "type": "string",
-      "description": "The type of integration. Currently supported: 'heretto'. Additional types may be added in the future.",
-      "enum": [
-        "heretto"
-      ]
-    },
-    "integrationName": {
-      "type": "string",
-      "description": "The name of the integration configuration in the config file. Used to look up authentication credentials."
-    },
-    "fileId": {
-      "type": "string",
-      "description": "The unique identifier (UUID) of the file in the source CMS. If not provided, the file will be looked up by path."
-    },
-    "filePath": {
-      "type": "string",
-      "description": "The path of the file in the source CMS. Used for lookup if fileId is not available."
-    },
-    "contentPath": {
-      "type": "string",
-      "description": "The local path to the file that references this source. Used for resolving relative paths."
-    }
-  },
-  "examples": [
-    {
-      "type": "heretto",
-      "integrationName": "my-heretto",
-      "fileId": "8f3ed200-cbba-11e1-ac51-c82a1446d15c",
-      "filePath": "/db/organizations/example/repositories/docs/images/screenshot.png"
-    },
-    {
-      "type": "heretto",
-      "integrationName": "my-heretto",
-      "filePath": "images/screenshot.png",
-      "contentPath": "/tmp/doc-detective/heretto_abc123/topic.dita"
-    }
-  ],
-  "$id": "/home/runner/work/doc-detective/doc-detective/src/common/src/schemas/src_schemas/sourceIntegration_v3.schema.json"
-}