div#navbar img
{
    height: 20px;
}

table th{
    text-align: left;
}

/* 
** Allows dropdown to be sticky and hide other menu items on scroll and hover
*/

#navigation-items button{
    position: sticky; 
    top: 20px;
    box-shadow: 0 -10px 5px 25px rgb(var(--background-light))
}

#navigation-items button:is(.dark *){
    box-shadow: 0 -10px 5px 25px rgb(var(--background-dark));
}

#navigation-items button:hover{
    background-color: rgb(var(--gray-100));
}

#navigation-items button:hover:is(.dark *){
    background-color: rgb(var(--gray-800));
}

#!/usr/bin/env node

const fs = require('fs');
const path = require('path');
const https = require('https');
const http = require('http');

/**
 * Downloads an OpenAPI specification from a URL and saves it to the specified location
 * @param {string} url - The URL of the OpenAPI specification
 * @param {string} category - The category name (e.g., 'hris')
 */
function downloadOAS(url, category) {
    // Create the directory structure
    const outputFilename = category + '.json';
    const outputDir = path.join(category, 'api-reference');
    ensureDirectoryExists(outputDir);

    const outputPath = path.join(outputDir, outputFilename);

    console.log(`Downloading OpenAPI spec from: ${url}`);
    console.log(`Saving to: ${outputPath}`);

    // Determine if we need http or https
    const client = url.startsWith('https') ? https : http;
    
    // Set up request options with headers
    const options = {
        headers: {
            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36',
            'Accept': 'application/json'
        }
    };

    // Create a file stream to save the downloaded content
    const fileStream = fs.createWriteStream(outputPath);

    // Download the file
    const request = client.get(url, options, (response) => {
        // Check if the request was successful        
        if (response.statusCode !== 200) {
            console.error(`Failed to download: ${response.statusCode} ${response.statusMessage}`);
            fileStream.close();
            fs.unlinkSync(outputPath); // Remove the file if download failed
            process.exit(1);
            return;
        }

        // Pipe the response to the file
        response.pipe(fileStream);

        // Handle completion
        fileStream.on('finish', () => {
            fileStream.close();
            console.log('Download completed successfully');

            // Validate the downloaded JSON
            try {
                const jsonContent = fs.readFileSync(outputPath, 'utf8');
                JSON.parse(jsonContent);
                console.log('OpenAPI specification is valid JSON');
            } catch (error) {
                console.error('Downloaded file is not valid JSON:', error.message);
                process.exit(1);
            }
        });
    });

    // Handle errors
    request.on('error', (error) => {
        console.error('Error downloading file:', error.message);
        fileStream.close();
        fs.unlinkSync(outputPath); // Remove the file if download failed
        process.exit(1);
    });

    fileStream.on('error', (error) => {
        console.error('Error writing file:', error.message);
        process.exit(1);
    });
}

/**
 * Ensures that a directory exists, creating it if necessary
 * @param {string} dirPath - The directory path to check/create
 */
function ensureDirectoryExists(dirPath) {
    if (!fs.existsSync(dirPath)) {
        fs.mkdirSync(dirPath, { recursive: true });
        console.log(`Created directory: ${dirPath}`);
    }
}

// Main execution
if (process.argv.length < 4) {
    console.error('Usage: node download-oas.js <url> <category>');
    console.error('Example: node download-oas.js https://example.com/api.json hris');
    process.exit(1);
}

const url = process.argv[2];
const category = process.argv[3];

downloadOAS(url, category); 

#!/usr/bin/env node

/**
 * OpenAPI Specification to MDX Converter
 * 
 * This script converts an OpenAPI specification JSON file to MDX files organized by tags.
 * 
 * Example usage:
 *   node scripts/oas-to-mdx.js path/to/openapi.json output/directory
 *   
 * Arguments:
 *   1. Path to OpenAPI JSON file (required)
 *   2. Output directory (optional, defaults to 'test')
 */

const fs = require('fs');
const path = require('path');

// Function to create directory if it doesn't exist
function ensureDirectoryExists(dirPath) {
  if (!fs.existsSync(dirPath)) {
    fs.mkdirSync(dirPath, { recursive: true });
  }
}

// Function to convert camelCase or snake_case to kebab-case
function toKebabCase(str) {
  return str
    .replace(/([a-z])([A-Z])/g, '$1-$2')  // Convert camelCase to kebab-case
    .replace(/_/g, '-')                   // Convert snake_case to kebab-case
    .replace(/\s+/g, '-')                 // Convert spaces to dashes
    .replace(/[^a-zA-Z0-9-]/g, '')        // Remove special characters
    .toLowerCase();                       // Convert to lowercase
}

// Function to generate a descriptive filename based on the operation
function generateFilename(method, pathUrl, operation) {
  // Use the summary if available, otherwise fall back to the current naming scheme
  if (operation.summary) {
    return `${toKebabCase(operation.summary)}.mdx`;
  }

  // Fallback to the current method-based naming if no summary exists
  const pathSegments = pathUrl.split('/').filter(Boolean);
  const lastSegment = pathSegments[pathSegments.length - 1];
  
  // Check if the last segment is a parameter
  const isParameter = lastSegment && lastSegment.startsWith('{');
  
  // If it's a parameter, use the previous segment as the resource
  const resourceSegment = isParameter 
    ? pathSegments[pathSegments.length - 2] || 'resource'
    : lastSegment || 'resource';
  
  // Clean up the resource name
  const resource = resourceSegment.replace(/[{}]/g, '');
  
  // Determine the action based on the HTTP method
  let action;
  switch (method.toLowerCase()) {
    case 'get':
      action = isParameter ? 'get' : 'list';
      break;
    case 'post':
      action = 'create';
      break;
    case 'put':
    case 'patch':
      action = 'update';
      break;
    case 'delete':
      action = 'delete';
      break;
    default:
      action = method.toLowerCase();
  }
  
  return `${action}-${toKebabCase(resource)}.mdx`;
}

// Function to generate MDX content
function generateMdxContent(method, pathUrl, operation) {
  // START:Generate the header
  let content = `---
openapi: "${method.toLowerCase()} ${pathUrl}"`;

  // Add warning icon for deprecated operations
  if (operation.deprecated) {
    content += `
icon: "circle-exclamation"`;
  }

  content += `
---`;
  // END:Generate the header

  // Add warning block for deprecated operations
  if (operation.deprecated) {
    content += `

<Warning>
  **This endpoint is deprecated**   <Icon icon="triangle-exclamation" color="#fbbf24" size={19} />
</Warning>`;
  }

  return content;
}

// Main function to process the OpenAPI JSON
function processOpenApiJson(jsonFilePath, outputBasePath = 'test') {
  // Read and parse the JSON file
  const jsonData = JSON.parse(fs.readFileSync(jsonFilePath, 'utf8'));
  const { paths } = jsonData;

  // Process each path and method
  for (const [pathUrl, pathItem] of Object.entries(paths)) {
    for (const [method, operation] of Object.entries(pathItem)) {
      if (['get', 'post', 'put', 'delete', 'patch'].includes(method.toLowerCase())) {
        const { tags = [] } = operation;
        
        // Skip if no tags
        if (!tags.length) continue;
        
        // Determine the folder structure based on tags
        let folderPath = outputBasePath;
        
        // First tag is the parent folder, subsequent tags are subfolders
        for (let i = 0; i < tags.length; i++) {
          const tagFolder = toKebabCase(tags[i]);
          folderPath = path.join(folderPath, tagFolder);
        }
        
        // Create the folder if it doesn't exist
        ensureDirectoryExists(folderPath);
        
        // Generate a descriptive filename
        const fileName = generateFilename(method, pathUrl, operation);
        
        // Generate the MDX content with potential warning block
        const mdxContent = generateMdxContent(method, pathUrl, operation);
        
        // Write the MDX file
        const filePath = path.join(folderPath, fileName);
        fs.writeFileSync(filePath, mdxContent);
        
        console.log(`Created: ${filePath}`);
      }
    }
  }
}

// Check if a file path was provided
if (process.argv.length < 3) {
  console.error('Please provide the path to the OpenAPI JSON file');
  process.exit(1);
}

const jsonFilePath = process.argv[2];
const outputBasePath = process.argv[3] || 'test';

// Process the JSON file
processOpenApiJson(jsonFilePath, outputBasePath);
console.log('MDX generation complete!'); 

#!/usr/bin/env node

/**
 * OpenAPI Documentation Updater
 * 
 * Example usage:
 *   Process all categories:
 *     node scripts/update-oas-docs.js
 *   
 *   Process specific category:
 *     node scripts/update-oas-docs.js hris
 *   
 *   Process specific category with custom URL:
 *     node scripts/update-oas-docs.js hris https://example.com/custom-spec.json
 */

const { execSync } = require('child_process');
const path = require('path');
const fs = require('fs');
const { CATEGORIES } = require('./config');

// Hardcoded base URL for OpenAPI specifications
const BASE_OAS_URL = 'https://api.eu1.stackone.com/oas/';

/**
 * Downloads an OpenAPI spec and generates MDX files from it
 * @param {string} category - The category name (e.g., 'hris')
 * @param {string} customUrl - Optional custom URL to override the base URL + category
 */
function updateOASDocs(category, customUrl = null) {
  try {
    console.log(`=== Processing OpenAPI spec for ${category} ===`);
    
    // Determine the URL to use
    const url = customUrl || `${BASE_OAS_URL}${category}.json`;
    console.log(`Using URL: ${url}`);
    
    // Step 1: Delete existing files from the api-reference folder
    const apiRefPath = path.join(category, 'api-reference');
    console.log(`\n--- Cleaning existing API reference files ---`);
    if (fs.existsSync(apiRefPath)) {
      const files = fs.readdirSync(apiRefPath);
      for (const file of files) {
        const filePath = path.join(apiRefPath, file);
        if (fs.lstatSync(filePath).isFile()) {
          fs.unlinkSync(filePath);
          console.log(`Deleted: ${filePath}`);
        }
      }
    } else {
      fs.mkdirSync(apiRefPath, { recursive: true });
      console.log(`Created directory: ${apiRefPath}`);
    }
    
    // Step 2: Download the OpenAPI spec
    console.log(`\n--- Downloading OpenAPI spec ---`);
    execSync(`node scripts/download-oas.js "${url}" "${category}"`, { stdio: 'inherit' });
    
    // Step 3: Generate MDX files from the downloaded spec
    console.log(`\n--- Generating MDX files ---`);
    const jsonPath = path.join(category, 'api-reference', `${category}.json`);
    const outputPath = path.join(category, 'api-reference');
    execSync(`node scripts/oas-to-mdx.js "${jsonPath}" "${outputPath}"`, { stdio: 'inherit' });
    
    console.log(`\n=== Processing complete for ${category} ===`);
  } catch (error) {
    console.error(`Error processing OpenAPI spec: ${error.message}`);
    process.exit(1);
  }
}

// Main execution
if (process.argv.length < 3) {
  // No category specified - process all categories
  console.log('No category specified - processing all categories\n');
  for (const category of CATEGORIES) {
    updateOASDocs(category);
  }
} else {
  // Process specific category
  const category = process.argv[2];
  const customUrl = process.argv[3] || null;
  updateOASDocs(category, customUrl);
} 

const CATEGORIES = [
    'hris',
    'ats',
    'crm',
    'marketing',
    'documents',
    'lms',
    'iam',
    'screening',
];

module.exports = {
    CATEGORIES
}; 

#!/usr/bin/env node

const fs = require('fs');
const path = require('path');
const { CATEGORIES } = require('./config');

/**
 * Reads and parses a JSON file
 * @param {string} filePath - Path to the JSON file
 * @returns {Object} Parsed JSON content
 */
function readJsonFile(filePath) {
    try {
        const content = fs.readFileSync(filePath, 'utf8');
        return JSON.parse(content);
    } catch (error) {
        console.error(`Error reading ${filePath}:`, error.message);
        return null;
    }
}

/**
 * Creates navigation structure from OpenAPI spec
 * @param {Object} oas - The OpenAPI spec
 * @param {string} category - The API category
 * @returns {Array} Navigation structure
 */
function createNavigationFromSpec(oas, category) {
    const paths = oas.paths || {};
    const groupedByTags = {};

    // Collect operations by tags, using tags as subfolders
    Object.entries(paths).forEach(([path, methods]) => {
        Object.values(methods).forEach(operation => {
            if (!operation.summary || !operation.tags?.[0]) return;
            
            const [mainTag, ...subTags] = operation.tags;
            
            if (!groupedByTags[mainTag]) {
                groupedByTags[mainTag] = {
                    topLevel: [],
                    subGroups: {}
                };
            }

            // Create path using tags as subfolders
            const mainFolder = mainTag.toLowerCase().replace(/\s+/g, '-');
            const subFolder = subTags[0] ? `/${subTags[0].toLowerCase().replace(/\s+/g, '-')}` : '';
            const pageName = operation.summary.toLowerCase().replace(/\s+/g, '-').replace(/[^a-z0-9-]/g, '');
            const page = `${category}/api-reference/${mainFolder}${subFolder}/${pageName}`;
            
            // If there's a second tag, use it as a subgroup
            if (subTags[0]) {
                const subTag = subTags[0];
                if (!groupedByTags[mainTag].subGroups[subTag]) {
                    groupedByTags[mainTag].subGroups[subTag] = [];
                }
                groupedByTags[mainTag].subGroups[subTag].push(page);
            } else {
                // No subTag, add to top level
                groupedByTags[mainTag].topLevel.push(page);
            }
        });
    });

    // Create the final structure maintaining original order of everything
    return Object.entries(groupedByTags)
        .map(([tag, content]) => {
            const group = {
                group: tag,
                pages: content.topLevel
            };

            // Add subgroups if they exist
            if (Object.keys(content.subGroups).length > 0) {
                group.pages.push(...Object.entries(content.subGroups)
                    .map(([subTag, pages]) => ({
                        group: subTag,
                        pages: pages
                    }))
                );
            }

            return group;
        });
}

/**
 * Collects all MDX files in a directory recursively
 * @param {string} dir - Directory to scan
 * @param {string} category - The API category for path construction
 * @returns {Set} Set of file paths relative to the category
 */
function collectMdxFiles(dir, category) {
    const files = new Set();
    const baseDir = path.join(__dirname, '..', category, 'api-reference');
    
    function scan(directory) {
        const entries = fs.readdirSync(directory, { withFileTypes: true });
        
        entries.forEach(entry => {
            const fullPath = path.join(directory, entry.name);
            if (entry.isDirectory()) {
                scan(fullPath);
            } else if (entry.name.endsWith('.mdx')) {
                // Convert full path to relative path matching our navigation format
                const relativePath = path.relative(baseDir, fullPath);
                const navigationPath = `${category}/api-reference/${relativePath.replace(/\.mdx$/, '')}`;
                files.add(navigationPath);
            }
        });
    }

    if (fs.existsSync(dir)) {
        scan(dir);
    }
    
    return files;
}

/**
 * Collects all pages from navigation structure
 * @param {Array} navigationItems - The navigation items
 * @returns {Set} Set of page paths
 */
function collectNavigationPages(navigationItems) {
    const pages = new Set();

    function collect(items) {
        items.forEach(item => {
            if (typeof item === 'string') {
                pages.add(item);
            } else if (item.pages) {
                collect(item.pages);
            }
        });
    }

    navigationItems.forEach(item => {
        if (item.pages) {
            collect(item.pages);
        }
    });

    return pages;
}

/**
 * Validates that all pages in the navigation structure exist as files
 * and checks for extra files not in navigation
 * @param {Array} navigationItems - The navigation items to validate
 * @param {string} baseDir - The base directory to check files against
 * @param {string} category - The API category being processed
 * @returns {Object} Object containing missing and extra files
 */
function validateNavigation(navigationItems, baseDir, category) {
    const missingFiles = [];
    
    function checkPages(pages) {
        pages.forEach(page => {
            if (typeof page === 'string') {
                // Check if the MDX file exists
                const filePath = path.join(baseDir, `${page}.mdx`);
                if (!fs.existsSync(filePath)) {
                    missingFiles.push(page);
                }
            } else if (page.group && page.pages) {
                // Recursively check pages in subgroups
                checkPages(page.pages);
            }
        });
    }

    navigationItems.forEach(item => {
        if (item.pages) {
            checkPages(item.pages);
        }
    });

    // Check for extra files
    const actualFiles = collectMdxFiles(path.join(baseDir, category, 'api-reference'), category);
    const navigationPages = collectNavigationPages(navigationItems);
    const extraFiles = [...actualFiles].filter(file => !navigationPages.has(file));

    return { missingFiles, extraFiles };
}

/**
 * Updates docs.json with API reference navigation
 */
function updateDocsNavigation() {
    const docsNavPath = path.join(__dirname, '../docs.json');
    const docsNav = readJsonFile(docsNavPath);

    if (!docsNav || !docsNav.navigation) {
        console.error('Invalid docs.json structure: missing navigation');
        return;
    }

    // Find the "Unified APIs" tab
    const unifiedApisTab = docsNav.navigation.tabs?.find(tab => tab.tab === 'Unified APIs');
    if (!unifiedApisTab) {
        console.error('Could not find Unified APIs tab');
        return;
    }

    let hasMissingFiles = false;
    const updatedDropdowns = [...(unifiedApisTab.dropdowns || [])];

    // Process each category
    CATEGORIES.forEach(category => {
        // Read the category-specific OpenAPI spec from the correct location
        const oasPath = path.join(__dirname, `../${category}/api-reference/${category}.json`);
        const oas = readJsonFile(oasPath);

        if (!oas) {
            console.warn(`Warning: Could not read OpenAPI spec for ${category}`);
            return;
        }

        // Generate navigation structure directly from OpenAPI spec
        const items = createNavigationFromSpec(oas, category);
        
        // Validate files
        const { missingFiles, extraFiles } = validateNavigation(items, path.join(__dirname, '..'), category);
        
        if (missingFiles.length > 0) {
            console.error(`Error: Missing files in ${category}:`);
            missingFiles.forEach(file => console.error(`  - ${file}.mdx`));
            hasMissingFiles = true;
            return;
        }

        if (extraFiles.length > 0) {
            console.warn(`Warning: Extra files found in ${category} not included in navigation:`);
            extraFiles.forEach(file => console.warn(`  - ${file}.mdx`));
        }

        // Find or create the dropdown for this category
        let categoryDropdown = updatedDropdowns.find(d => d.dropdown.toLowerCase() === category.toLowerCase());
        if (!categoryDropdown) {
            categoryDropdown = {
                dropdown: category.toUpperCase(),
                groups: []
            };
            updatedDropdowns.push(categoryDropdown);
        }

        // Find or create the API Reference group
        let apiRefGroup = categoryDropdown.groups.find(g => g.group === 'API Reference');
        if (!apiRefGroup) {
            apiRefGroup = {
                group: 'API Reference',
                pages: []
            };
            categoryDropdown.groups.push(apiRefGroup);
        }

        apiRefGroup.pages = items;
    });

    if (hasMissingFiles) {
        console.error('Error: Navigation update aborted due to missing files');
        process.exit(1);
    }

    // Only update if all files exist
    unifiedApisTab.dropdowns = updatedDropdowns;
    fs.writeFileSync(docsNavPath, JSON.stringify(docsNav, null, 2));
    console.log('Successfully updated docs.json');
}

// Run the update
updateDocsNavigation(); 

#!/usr/bin/env node

/**
 * This script installs Git hooks for the project.
 * It copies the pre-commit hook to the .git/hooks directory and makes it executable.
 * 
 * Usage:
 *   node scripts/install-hooks.js
 */

const fs = require('fs');
const path = require('path');
const { execSync } = require('child_process');

// Get the root directory of the Git repository
const gitRoot = execSync('git rev-parse --show-toplevel', { encoding: 'utf8' }).trim();

// Paths for hooks
const hooksDir = path.join(gitRoot, '.git', 'hooks');
const preCommitSource = path.join(gitRoot, 'scripts', 'hooks', 'pre-commit');
const preCommitDest = path.join(hooksDir, 'pre-commit');

// Create hooks directory if it doesn't exist
if (!fs.existsSync(hooksDir)) {
  console.log(`Creating hooks directory: ${hooksDir}`);
  fs.mkdirSync(hooksDir, { recursive: true });
}

// Create scripts/hooks directory if it doesn't exist
const hooksSourceDir = path.join(gitRoot, 'scripts', 'hooks');
if (!fs.existsSync(hooksSourceDir)) {
  console.log(`Creating hooks source directory: ${hooksSourceDir}`);
  fs.mkdirSync(hooksSourceDir, { recursive: true });
}

// Create the pre-commit hook in the scripts/hooks directory
const preCommitContent = `#!/bin/sh

# Pre-commit hook to run wrap-images.js script
# This ensures all images in MDX files are properly wrapped with Frame tags

echo "Running wrap-images script to ensure all images are properly wrapped..."

# Get the directory of the git repository
REPO_ROOT=$(git rev-parse --show-toplevel)

# Get list of staged MDX files
STAGED_MDX_FILES=$(git diff --cached --name-only --diff-filter=ACMR | grep '\\.mdx$' || true)

if [ -z "$STAGED_MDX_FILES" ]; then
    echo "No staged MDX files found. Proceeding with commit..."
    exit 0
fi

# Process each staged MDX file
echo "Processing staged MDX files..."
for file in $STAGED_MDX_FILES; do
    echo "Checking $file"
    node "$REPO_ROOT/scripts/wrap-images.js" "$file"
    
    # Check if the script executed successfully
    if [ $? -ne 0 ]; then
        echo "Error: wrap-images script failed on $file. Aborting commit."
        exit 1
    fi
done

# Check if there are any changes in the staged MDX files after running the script
for file in $STAGED_MDX_FILES; do
    if [ -n "$(git diff --name-only "$file")" ]; then
        echo "Images were wrapped with Frame tags in $file. Please stage these changes and commit again."
        echo "Run 'git add $file' and try committing again."
        exit 1
    fi
done

echo "All images in staged MDX files are properly wrapped. Proceeding with commit..."
exit 0
`;

// Write the pre-commit hook to the scripts/hooks directory
console.log(`Creating pre-commit hook in: ${preCommitSource}`);
fs.writeFileSync(preCommitSource, preCommitContent, { mode: 0o755 });

// Copy the pre-commit hook to the .git/hooks directory
console.log(`Installing pre-commit hook to: ${preCommitDest}`);
fs.copyFileSync(preCommitSource, preCommitDest);

// Make the pre-commit hook executable
console.log('Making pre-commit hook executable');
fs.chmodSync(preCommitDest, 0o755);

console.log('Git hooks installed successfully!');
console.log('The pre-commit hook will now run the wrap-images.js script before each commit.'); 

#!/usr/bin/env node

/**
 * This script finds all .mdx files in the codebase and wraps markdown images
 * with <Frame> tags if they're not already wrapped.
 * 
 * Usage:
 *   node wrap-images.js                  # Process all .mdx files in the codebase
 *   node wrap-images.js path/to/file.mdx # Process a specific file
 *   node wrap-images.js --verbose        # Run with verbose logging
 *   node wrap-images.js path/to/file.mdx --verbose # Process a specific file with verbose logging
 */

const fs = require('fs');
const path = require('path');
const { promisify } = require('util');

const readdir = promisify(fs.readdir);
const readFile = promisify(fs.readFile);
const writeFile = promisify(fs.writeFile);

// Parse command line arguments
const args = process.argv.slice(2);
const verboseMode = args.includes('--verbose');
const fileArg = args.filter(arg => arg !== '--verbose')[0];

// Utility function for verbose logging
function verboseLog(...messages) {
    if (verboseMode) {
        console.log('[VERBOSE]', ...messages);
    }
}

// Regular expression to match markdown image syntax
const imageRegex = /!\[([^\]]*)\]$([^)]*)$/g;

/**
 * Recursively finds all .mdx files in a directory
 * @param {string} dir - Directory to search
 * @returns {Promise<string[]>} - Array of file paths
 */
async function findMdxFiles(dir) {
    const files = [];

    async function traverse(currentDir) {
        try {
            const entries = await readdir(currentDir, { withFileTypes: true });

            for (const entry of entries) {
                const fullPath = path.join(currentDir, entry.name);

                // Skip .git and node_modules directories
                if (entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'node_modules') {
                    await traverse(fullPath);
                } else if (entry.isFile() && entry.name.endsWith('.mdx')) {
                    files.push(fullPath);
                }
            }
        } catch (error) {
            console.error(`Error reading directory ${currentDir}:`, error.message);
        }
    }
    await traverse(dir);
    return files;
}

/**
 * Processes a single .mdx file to wrap images with Frame tags
 * @param {string} filePath - Path to the file
 * @returns {Promise<boolean>} - Whether the file was updated
 */
async function processFile(filePath) {
    try {
        const content = await readFile(filePath, 'utf8');
        verboseLog(`Processing file: ${filePath}`);
        
        // Function to check if an image at a specific position is wrapped in Frame tags
        function isWrappedInFrame(fullContent, matchIndex, matchLength) {
            // Check for <Frame> before the image
            const beforeContent = fullContent.substring(0, matchIndex).trim();
            const hasFrameBefore = beforeContent.endsWith('<Frame>');
            
            // Check for </Frame> after the image
            const afterContent = fullContent.substring(matchIndex + matchLength).trim();
            const hasFrameAfter = afterContent.startsWith('</Frame>');
            
            return hasFrameBefore && hasFrameAfter;
        }
        
        // Find all image matches and replace unwrapped ones
        let lastIndex = 0;
        let match;
        let resultParts = [];
        let unwrappedCount = 0;
        
        while ((match = imageRegex.exec(content)) !== null) {
            const matchIndex = match.index;
            const matchText = match[0];
            const alt = match[1];
            const src = match[2];
            
            // Add content before this match
            resultParts.push(content.substring(lastIndex, matchIndex));
            
            // Check if this image is already wrapped
            if (isWrappedInFrame(content, matchIndex, matchText.length)) {
                verboseLog(`Skipping already wrapped image: ${src}`);
                resultParts.push(matchText);
            } else {
                verboseLog(`Wrapping image: ![${alt}](${src})`);
                // Check if previous content ends with a newline or is empty
                const prevContent = content.substring(0, matchIndex).trim();
                const needsNewline = prevContent.length > 0 && !prevContent.endsWith('\n');
                resultParts.push(`${needsNewline ? '\n' : ''}<Frame>\n${matchText}\n</Frame>`);
                unwrappedCount++;
            }
            
            lastIndex = matchIndex + matchText.length;
        }
        
        // Add any remaining content
        resultParts.push(content.substring(lastIndex));
        
        // If no images were wrapped, we're done
        if (unwrappedCount === 0) {
            console.log(`No unframed images found in ${filePath}`);
            return false;
        }
        
        // Join all parts and write back to the file
        const updatedContent = resultParts.join('');
        await writeFile(filePath, updatedContent, 'utf8');
        console.log(`Updated ${unwrappedCount} images in ${filePath}`);
        return true;
    } catch (error) {
        console.error(`Error processing ${filePath}:`, error.message);
        return false;
    }
}

/**
 * Process a specific file
 * @param {string} filePath - Path to the file
 */
async function processSpecificFile(filePath) {
    try {
        if (!fs.existsSync(filePath)) {
            console.error(`File not found: ${filePath}`);
            process.exit(1);
        }

        if (!filePath.endsWith('.mdx')) {
            console.error(`File is not an MDX file: ${filePath}`);
            process.exit(1);
        }

        console.log(`Processing file: ${filePath}`);
        const wasUpdated = await processFile(filePath);

        console.log(`\nSummary:`);
        console.log(`File ${wasUpdated ? 'was updated' : 'did not need changes'}`);
    } catch (error) {
        console.error(`Error processing specific file:`, error.message);
        process.exit(1);
    }
}

/**
 * Process all MDX files in the codebase
 */
async function processAllFiles() {
    try {
        const rootDir = process.cwd();
        console.log(`Searching for .mdx files in ${rootDir}...`);

        const mdxFiles = await findMdxFiles(rootDir);
        console.log(`Found ${mdxFiles.length} .mdx files`);

        let updatedCount = 0;

        for (const file of mdxFiles) {
            const wasUpdated = await processFile(file);
            if (wasUpdated) {
                updatedCount++;
            }
        }

        console.log(`\nSummary:`);
        console.log(`Total .mdx files: ${mdxFiles.length}`);
        console.log(`Files updated: ${updatedCount}`);
        console.log(`Files with no changes needed: ${mdxFiles.length - updatedCount}`);
    } catch (error) {
        console.error(`Error processing all files:`, error.message);
        process.exit(1);
    }
}

/**
 * Main function
 */
async function main() {
    try {
        if (verboseMode) {
            console.log('Running in verbose mode');
        }

        if (fileArg) {
            await processSpecificFile(path.resolve(process.cwd(), fileArg));
        } else {
            await processAllFiles();
        }
    } catch (error) {
        console.error('Error:', error.message);
        process.exit(1);
    }
}

// Run the script
main(); 

Delete User Completion

basic

The completion was deleted successfully but no content was returned.

Precondition failed: linked account belongs to a disabled integration.

Server error while executing the request.

Stackone

Overview

Welcome to StackOne's Unified API for HRIS, ATS, CRM and more!

Getting Started with StackOne

Connect your Frontend via the StackOne React Hub

Connect your Backend with StackOne

A basic introduction to the dashboard, logging in etc

Dashboard Overview

Browse and take actions on any of the project's linked accounts

Accounts

Get your customer to connect their tool with only a link!

Auth Link

API Keys

Request Logs

Enable, disable and manage integrations for any StackOne Project

Managing Integration

Managing Projects

Webhooks

Managing your Organization

Custom Unified Fields enable users to create and unify bespoke fields to extend the existing Unified API models & resources.

Introduction

Define what source fields, the custom unified field will use for each integration.

Integration Field Mapping

Custom unified fields use an expression language that can be used to create more complex field mappings

Expression language syntax

Outline the list of supported SDKs to use the API with language-native libraries

Postman is a tool that allows developers to send API requests and receive responses to verify whether an API works correctly. This document describes how to use Postman to call the StackOne Unified API.

Using Postman

Using Expand & Include API Parameters

Use filters that are supported by the underlying provider requests

Using the Passthrough (Proxy) query parameters

StackOne Unified API: Error Codes & Resolution Guide

Unified API Error Codes and Troubleshooting  Guide

Making your first API request

Pagination

StackOne Identifiers

Transform HR operations with StackOne's HRIS API, providing intelligent tools for employee management, payroll tracking, and workforce insights across platforms.

Automate bringing users into your application from your customer HRIS

User Syncing from HRIS

Automate the creation and update of employees in your customer's HRIS

Automated Employee Provisioning

Unify and transform recruitment workflows across multiple platforms with StackOne's comprehensive ATS API, enabling data integration, real-time synchronization, and intelligent candidate management.

Learn how StackOne simplifies job board integrations with multiple ATS platforms, reducing custom code and maintenance

Job Board - Easy Apply

Learn how to integrate real-time interview data into your SaaS to deliver intelligent insights and seamlessly sync back to your customers’ ATS

Interview Intelligence

Automated application and candidate screening or scoring (eg. for AI-powered resume scoring).

Automated Application Screening

Learn how to integrate real-time assessment data, AI insights, and ATS syncing to simplify user workflows and improve candidate evaluation

Assessment & Background Checks

Automated candidate screening and scoring to simplify application management and HR decisions

Intelligent Candidate Screening

Accelerate CRM operations with StackOne's Unified API, connecting disparate platforms to unlock intelligent customer data management and real-time insights.

Amplify marketing performance with StackOne's Marketing API, delivering intelligent tools for campaign management, lead tracking, and multi-channel engagement across platforms

Essential details about the StackOne Documents API and its capabilities for organizing, managing, and accessing digital content efficiently within a document management system

Optimize learning management with StackOne's LMS API, delivering powerful tools for content creation, user tracking, and educational process integration across platforms.

Elevate identity security with StackOne's IAM API, providing comprehensive tools for managing user access, roles, and permissions across diverse platforms

The Admin API provides essential tools for managing and interacting with accounts and connectors

LMS

Common Guides

API Reference

Delete User Completion

Authorizations

Headers

Path Parameters

Response