Repository Name: @beautinique/packages
Version: 1.0.0
License: MIT
Author: Nageshwar Pawar
Repository: https://github.com/Nageshwar1997/BQ-Packages
Package Registry: npm (scoped under @beautinique)
Current Branch: main
Node.js Requirement: >=24
npm Requirement: >=11
Module Type: ESM ("type": "module")

This is a private TypeScript monorepo that houses reusable packages for the Beautinique ecosystem. It provides tooling for scaffolding new packages and publishing them to npm via an interactive CLI.

BQ-Packages/
├── .git/
├── .gitignore
├── .prettierignore
├── .prettierrc
├── CHANGELOG.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── SECURITY.md
├── package.json
├── package-lock.json
├── node_modules/
├── configs/
│   ├── eslint/
│   │   ├── eslint.base.config.mjs
│   │   ├── eslint.backend.config.mjs
│   │   ├── eslint.frontend.config.mjs
│   │   └── eslint.shared.config.mjs
│   ├── tsconfig/
│   │   ├── tsconfig.base.json
│   │   ├── tsconfig.backend.json
│   │   ├── tsconfig.frontend.json
│   │   └── tsconfig.shared.json
│   └── tsup/
│       ├── tsup.base.config.ts
│       ├── tsup.backend.config.ts
│       ├── tsup.frontend.config.ts
│       └── tsup.shared.config.ts
├── scripts/
│   ├── create-package/
│   │   ├── constants.mjs
│   │   ├── index.mjs
│   │   ├── metadata.mjs
│   │   ├── package.mjs
│   │   ├── prompts.mjs
│   │   ├── template.mjs
│   │   ├── utils.mjs
│   │   ├── validators.mjs
│   │   └── generators/
│   │       ├── copy-template.mjs
│   │       ├── eslint.mjs
│   │       ├── generate-package.mjs
│   │       ├── package-json.mjs
│   │       ├── readme.mjs
│   │       ├── tsconfig.mjs
│   │       └── tsup.mjs
│   └── clean.mjs
│   └── package-publisher/
│       ├── index.mjs
│       ├── auth.mjs
│       ├── batch-operation.mjs
│       ├── color.mjs
│       ├── constants.mjs
│       ├── dependency-sort.mjs
│       ├── errors.mjs
│       ├── metadata.mjs
│       ├── npm.mjs
│       ├── package.mjs
│       ├── package-selection.mjs
│       ├── package-status.mjs
│       ├── paths.mjs
│       ├── prompts.mjs
│       ├── publish.mjs
│       ├── reporter.mjs
│       ├── republish.mjs
│       ├── table.mjs
│       ├── types.mjs
│       ├── utils.mjs
│       ├── validators.mjs
│       └── version.mjs
└── templates/
    ├── backend/
    │   └── template.json
    ├── base/
    │   └── src/
    │       └── index.ts
    ├── frontend/
    │   └── template.json
    └── shared/
        └── template.json

All workspace packages extend from these shared configs instead of duplicating them.

Ignored paths: node_modules, dist, dist-ssr, coverage, *.d.ts, *.min.js, *.tsbuildinfo.

This is an interactive CLI (node ./scripts/create-package/index.mjs) that scaffolds a new package in packages/{shared,backend,frontend}/.

1. Prompt Template — Select shared, backend, or frontend
2. Prompt Package Name — Must match /^[a-z][a-z0-9-]*$/
3. Prompt Description — 10–150 chars, must contain letter/number
4. Prompt Keywords — 1–10 keywords, each 2–30 chars, comma-separated
5. Confirm — Summary of all inputs
6. Load Template — Reads templates/{type}/template.json
7. Build Metadata — Constructs scoped name, directories, config references
8. Check Exists — Prevents overwriting existing packages
9. Create Directory — Creates packages/{type}/{name}/
10. Copy Base Template — Copies templates/base/src/index.ts
11. Generate Files — Writes package.json, README.md, tsconfig.json, eslint.config.mjs, tsup.config.ts

templates/base/src/index.ts contains a single empty export:

export {};

This is a full interactive CLI (node ./scripts/package-publisher/index.mjs) that manages npm publishing workflow for the entire monorepo. It runs an infinite loop until the user exits.

Defines frozen constants for actions, version types (patch/minor/major/custom), exit codes, package statuses, summary labels, batch labels, dependency types/scopes, and table alignments.

JSDoc type definitions for:

• PublishConfig (access: 'public')
• Dependency (name, version, type, scope)
• WorkspacePackage (packageType, workspaceName, directory)
• PackageJson (name, version, dependencies, devDependencies, peerDependencies, optionalDependencies, publishConfig)
• PublishPackageMetadata (full runtime metadata with status)
• TableColumn (key, title, align)

Custom error classes extending CliError:

• CliError — base
• AuthenticationError
• ValidationError
• VersionError
• PublishError
• JsonError

Wraps picocolors into semantic color functions: success (green), warning (yellow), error (red), info (cyan), heading (bold), dim, muted (gray).

Abstraction layer over npm CLI:

• whoami() — returns current npm user or null
• getPackageInfo(name) — fetches published version from npm (handles 404)
• login() — interactive npm login
• logout() — interactive npm logout
• publish(directory, version) / republish(directory, version) — handles prerelease dist-tags automatically

• readJson / writeJson — JSON file I/O with indentation preservation
• pathExists — fs.access check
• runCommand — exec with Windows shell escaping
• runInteractiveCommand — spawn with stdio: inherit (for login/logout/npm publish)

• validateVersion — ensures string is valid semver
• calculateVersion — computes next version (patch/minor/major/custom)
• updatePackageVersion — patches package.json while preserving indent and trailing newline

• getDependencyScope — INTERNAL if scoped under @beautinique, else EXTERNAL
• getDependencies — collects all dependency types from package.json
• getPackageMetadata — builds full PublishPackageMetadata including status
• getPackagesMetadata — fetches metadata for all workspace packages

• findPackages() — enumerates all packages/*/*/ directories, returns sorted WorkspacePackage[]
• findPackage(workspaceName) — finds a single workspace package by name

• getPackage(filter) — prompts single selection from filtered packages
• getSelectedPackages(filter) — prompts multi-selection
• getPackages(filter) — returns all matching without prompt

Displays a formatted table of all packages (workspace, npm name, local version, remote version, status) plus a summary count.

Uses inquirer to build prompts for:

• Action selection menu (with dynamic Login/Logout)
• Package selection (single / multi)
• Version strategy selection (patch/minor/major/custom)
• Custom version input (live semver validation)
• Publish/republish confirmation dialogs

• validateRequiredFiles — ensures package.json and README.md exist
• validatePublishVersion — local > remote for republish; valid for new publish
• validatePublished — ensures package is already on npm
• validatePublishConfig — requires publishConfig.access === "public"

• publishNewPackage — validates, confirms, publishes
• publishPackages — sorts by dependency order, confirms, batch publishes
• Sorts packages so dependencies are published before dependents

• republishPackage — selects version strategy, calculates next, confirms, republishes
• republishPackages — batch republish with dependency ordering
• Rollback safety: If republish fails, restores the original version in package.json

Generic batch runner with:

• Success/failure counting
• Continue-on-error behavior
• Summary reporting

Topological sort of packages by internal dependencies. Detects circular dependencies. Ensures dependencies are processed before dependents.

Console output helpers: reportSection, reportDivider, reportInfo, reportSuccess, reportWarning, reportError, reportTable, reportSummary.

Custom table renderer supporting left/center/right alignment, bold headers, colored first column, and separator rows.

Defines ROOT_DIRECTORY (cwd), PACKAGES_DIRECTORY, and helpers for package.json / README.md paths.

• ensureLoggedIn() — throws if not authenticated
• ensureLoggedOut() — throws if already authenticated

Each template defines a template.json that maps the package type to its config files:

Base template (templates/base/src/index.ts): A single export {}; line that serves as the starting point for every new package.

• Print width: 100
• Tab width: 2 (spaces)
• Semi: true, single quotes, trailing commas: all
• End of line: LF
• Bracket spacing: true, bracket same line: false
• Arrow parens: always

Ignores node_modules, dist, dist-ssr, build, out, coverage, *.min.js, .pnpm-store, .turbo.

Ignores node_modules, build outputs, coverage, *.tsbuildinfo, logs, .env, IDE files (.vscode partial, .idea/), OS files (.DS_Store, Thumbs.db), .pnpm-store, .turbo, *.min.js, temp/runtime files.

• Branch: test/v1
• Status: Clean working tree, up to date with remote
• Recent commits:
  • 8920174 feat: enhance README generation with additional sections
  • 14eea23 chore: update license from ISC to MIT
  • e211fa5 feat: update package versions and enhance summary reporting
  • 75acebd feat: enhance table formatting with color coding
  • 4e54f1c feat: enhance user prompts with improved formatting
  • Plus 10 more earlier commits covering validation, batch operations, color utilities, and error handling

Root (BQ-Packages)
├── configs/          ← Shared toolchain configs (ESLint, TS, Tsup)
├── scripts/
│   ├── clean.mjs  ← Scaffold clean dist and unnecessary files
│   ├── create-package/  ← Scaffold new packages
│   │   └── generators/  ← File generators (json, ts, eslint, tsup, readme)
│   └── package-publisher/ ← npm publish/republish CLI
│       ├── npm.mjs          ← npm CLI wrapper
│       ├── version.mjs      ← semver calculation + file patching
│       ├── metadata.mjs     ← workspace discovery + package metadata
│       ├── dependency-sort.mjs ← topological sort
│       ├── publish.mjs / republish.mjs ← publish workflows
│       ├── batch-operation.mjs ← concurrent batch runner
│       ├── reporter.mjs / table.mjs / color.mjs ← terminal UI
│       ├── prompts.mjs / package-selection.mjs ← inquirer flows
│       └── validators.mjs / auth.mjs / paths.mjs ← helpers
└── templates/
    ├── base/                ← Shared src/ starter
    ├── shared/backend/frontend ← Type-specific template configs

The repository is well-architected with clear separation of concerns: configuration files are centralized in configs/, package scaffolding is isolated in scripts/create-package/, and the entire publishing workflow is encapsulated in scripts/package-publisher/. Templates decouple package structure from generation logic.