# List available product packages
npm view @zerobias-org/product-bundle --json

# Create module with Yeoman generator
yo @auditmation/hub-module
# Follow prompts to configure module

# Sync package metadata
npm run sync-meta

# Generate TypeScript types from API specification
npm run clean && npm run generate

# Transpile TypeScript (compile without linting)
npm run transpile

# Full build (lint + compile + bundle)
npm run build

# Clean build artifacts
npm run clean

# Validate OpenAPI specification
npx swagger-cli validate api.yml

# Check for common API spec issues
grep -E "describe[A-Z]" api.yml  # Should return nothing
grep "nullable:" api.yml          # Should return nothing
grep -E "'40[0-9]'|'50[0-9]'" api.yml  # Should return nothing

# Lint API specification (if configured)
npm run lint:api

# Run all tests
npm test

# Run only unit tests
npm test -- test/unit

# Run only integration tests
npm run test:integration

# Run with coverage
npm test -- --coverage

# Lint source code
npm run lint:src

# Auto-fix linting issues
npm run lint:src -- --fix

# Type check without building
npx tsc --noEmit

# Install dependencies
npm install

# Lock dependencies for npm package
npm run shrinkwrap

# Check for outdated packages
npm outdated

# Audit for security issues
npm audit

# Check for generated inline types (should be none)
grep -r "InlineResponse\|InlineRequestBody" generated/

# Verify no Promise<any> in source
grep "Promise<any>" src/*.ts

# Check for environment variables in source (forbidden)
grep "process.env" src/*.ts  # Should only be in test/Common.ts

# Validate connectionState has expiresIn
grep "expiresIn:" connectionState.yml || grep "baseConnectionState" connectionState.yml

# Module commands (from package.json)
npm run build         # Full build pipeline
npm run clean         # Remove build artifacts
npm run generate      # Generate types from API spec
npm run transpile     # Compile TypeScript only
npm run lint:src      # Lint source files
npm run lint:api      # Lint API specification
npm run test          # Run tests
npm run shrinkwrap    # Lock dependencies
npm run sync-meta     # Sync package metadata

yq eval '.paths.*.*.responses.*.content.*.schema | select(has("properties"))' api.yml
# Should only return business object schemas, not wrapper schemas

nested_schemas=$(yq eval '.components.schemas[] | .. | select(type == "string" and test("#/components/schemas/")) | capture("#/components/schemas/(?<schema>.+)").schema' api.yml | sort -u)

endpoint_schemas=$(yq eval '.paths.*.*.responses.*.content.*.schema["$ref"]' api.yml | grep -o '[^/]*$' | sort -u)

prop_count=$(yq eval ".components.schemas.User.properties | length" api.yml)

#!/bin/bash
# check-tools.sh

echo "Checking required tools..."

command -v node >/dev/null 2>&1 || { echo "❌ Node.js not installed"; exit 1; }
command -v npm >/dev/null 2>&1 || { echo "❌ npm not installed"; exit 1; }
command -v yo >/dev/null 2>&1 || { echo "❌ Yeoman not installed"; exit 1; }
command -v java >/dev/null 2>&1 || { echo "❌ Java not installed"; exit 1; }
command -v yq >/dev/null 2>&1 || { echo "❌ yq not installed"; exit 1; }
command -v jq >/dev/null 2>&1 || { echo "❌ jq not installed"; exit 1; }

echo "✅ All required tools installed"

npm install -g swagger-cli

# Mac
brew install yq

# Linux
wget https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64 -O /usr/local/bin/yq
chmod +x /usr/local/bin/yq

npm install -g yo

# Install Java 11 or newer from https://adoptium.net/
# Verify: java -version

## Prerequisites

Verify tools are available:
- See tool-requirements skill for installation

## Validation

Run validation commands:
- See tool-requirements skill for validation scripts