@nan0web/release 1.0.3 → 3.1.1

package/types/domain/SpecCommand.d.ts

@@ -0,0 +1,17 @@
+export default class SpecCommand extends ModelAsApp {
+    static version: {
+        help: string;
+        default: string;
+    };
+    static UI: {
+        title: string;
+        help: string;
+    };
+    /**
+     * @param {Partial<SpecCommand>} [data]
+     * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options]
+     */
+    constructor(data?: Partial<SpecCommand>, options?: Partial<import("@nan0web/ui").ModelAsAppOptions>);
+    /** @type {string} Release version filter */ version: string;
+}
+import { ModelAsApp } from '@nan0web/ui';

package/types/domain/StatusCommand.d.ts

@@ -0,0 +1,7 @@
+export default class StatusCommand extends ModelAsApp {
+    static UI: {
+        title: string;
+        help: string;
+    };
+}
+import { ModelAsApp } from '@nan0web/ui';

package/types/index.d.ts

@@ -1,3 +1,11 @@
+export { ReleaseApp } from "./domain/App.js";
+export { default as InitCommand } from "./domain/InitCommand.js";
+export { default as CheckCommand } from "./domain/CheckCommand.js";
+export { default as CloseCommand } from "./domain/CloseCommand.js";
+export { default as DepsCommand } from "./domain/DepsCommand.js";
+export { default as PublishCommand } from "./domain/PublishCommand.js";
+export { default as SpecCommand } from "./domain/SpecCommand.js";
+export { default as StatusCommand } from "./domain/StatusCommand.js";
 import Release from './Release.js';
 import ReleaseDocument from './Release/Document.js';
 import Person from './Release/Person.js';

package/types/ui/cli/index.d.ts

@@ -0,0 +1 @@
+export {};

package/types/utils/runSpawn.d.ts

@@ -0,0 +1 @@
+export {};

package/src/Team.js

@@ -1,35 +0,0 @@
-import { HumanName, HumanGender, HumanContact } from '@nan0web/verse'
-
-class Person {
-	/** @type {HumanName} */
-	name
-	/** @type {HumanGender} */
-	gender
-	/** @type {HumanContact[]} */
-	contacts
-
-	constructor(name) {
-		this.name = new HumanName(name)
-		this.gender = new HumanGender(-1)
-		this.contacts = []
-	}
-}
-
-class CLevelTeam {
-	static name = 'C Level'
-	static ceo = new Person(['Yaroslav', 'Wise'])
-	static cfo = new Person(['Chingis'])
-}
-
-class UXTeam {
-	static name = 'UX'
-	static designer = new Person(['Taras', 'Shevchenko'])
-}
-
-class Company {
-	static name = 'NaN•Web'
-	static c = CLevelTeam
-	static ux = UXTeam
-}
-
-export default Company

package/src/cli/index.js

@@ -1,9 +0,0 @@
-/**
- * Export the UI‑CLI based release CLI.
- *
- * @module release/cli
- */
-
-import createReleaseCLI from '../ui/cli/ReleaseCLi.js'
-
-export default createReleaseCLI

package/src/co/AppCommandOptions.js

@@ -1,25 +0,0 @@
-export default class AppCommandOptions {
-	/** @type {boolean} */
-	webui = false
-	/** @type {boolean} */
-	json = false
-	/** @type {boolean} */
-	quiet = false
-	/** @type {string} */
-	releaseDir = './releases'
-	/** @type {boolean} */
-	write = false
-	/** @type {string} */
-	user = 'anonymous'
-	/** @type {boolean} */
-	ignoreFailTests = false
-	/** @type {boolean} */
-	full = false
-
-	/**
-	 * @param {Object} input
-	 */
-	constructor(input = {}) {
-		Object.assign(this, input)
-	}
-}

package/src/commands/CloseCommand.js

@@ -1,67 +0,0 @@
-import { OutputMessage } from '@nan0web/co'
-import Command from './Command.js'
-import process from 'node:process'
-import Scanner from '../Release/Scanner.js'
-
-class CloseBody {
-	static version = { help: 'Release version', defaultValue: '' }
-	/** @type {string} */
-	version = ''
-	constructor({ version = '' } = {}) {
-		this.version = String(version)
-	}
-}
-
-export default class CloseCommand extends Command {
-	static name = 'close'
-	static help = 'Close a release and move tests to src/'
-	static Body = CloseBody
-
-	/** @param {Partial<Command> & { body?: Partial<CloseBody> }} [input={}] */
-	constructor(input = {}) {
-		super(input)
-		this.body = new CloseBody(/** @type {*} */ (input))
-	}
-
-	async *run() {
-		const v = this.body.version || ''
-
-		yield new OutputMessage(`🛜 nan0release close ${v || 'all'}`)
-
-		const scanner = new Scanner(process.cwd())
-		const specs = scanner.findSpecs(v)
-
-		if (specs.length === 0) {
-			yield new OutputMessage(`No pending specs found for version ${v || 'all'}`)
-			return
-		}
-
-		yield new OutputMessage(`Running ${specs.length} pending specs...`)
-
-		const files = specs.map((s) => s.path)
-		await this._run('node', ['--test', ...files], 'Cannot close: Specs failed')
-
-		yield new OutputMessage(`✅ Specs passed. Closing...`)
-
-		let movedCount = 0
-		const { renameSync, mkdirSync } = await import('node:fs')
-		const { join, dirname } = await import('node:path')
-
-		for (const spec of specs) {
-			const relativePath = spec.path.substring(process.cwd().length + 1)
-			const destRelative = relativePath
-				.replace(/^releases\//, 'src/releases/')
-				.replace('.spec.js', '.test.js')
-			const destPath = join(process.cwd(), destRelative)
-
-			mkdirSync(dirname(destPath), { recursive: true })
-			renameSync(spec.path, destPath)
-			movedCount++
-		}
-
-		yield new OutputMessage({
-			content: [`✅ Successfully closed ${movedCount} specs and moved to src/releases/`],
-			type: OutputMessage.TYPES.SUCCESS,
-		})
-	}
-}

package/src/commands/Command.js

@@ -1,48 +0,0 @@
-import DBFS from '@nan0web/db-fs'
-import { OutputMessage } from '@nan0web/co'
-import Logger from '@nan0web/log'
-import { runSpawn } from '@nan0web/test'
-import { UiMessage } from '@nan0web/ui'
-
-/** @typedef {import("@nan0web/test/types/exec/runSpawn").SpawnResult} SpawnResult */
-
-export default class Command extends UiMessage {
-	/** @type {DBFS} */
-	fs
-	/** @type {Logger} */
-	logger
-
-	/**
-	 * @param {Partial<UiMessage> & {  }} [input={}]
-	 */
-	constructor(input = {}) {
-		super(input)
-		const { fs, logger } = UiMessage.parseBody(input, this.Body)
-		this.fs = fs ?? DBFS.from({})
-		this.logger = Logger.from(logger ?? {})
-	}
-	get Body() {
-		return /** @type {typeof Command} */ (this.constructor).Body
-	}
-	/**
-	 * Run the command.
-	 * @param {string} cmd
-	 * @param {string[]} [args=[]]
-	 * @param {string} [fail=""]
-	 * @returns {Promise<SpawnResult>}
-	 * @throws {Error}
-	 */
-	async _run(cmd, args = [], fail = '') {
-		const result = await runSpawn(cmd, args)
-		if (0 !== result.code) {
-			this.logger.error(result.error)
-			throw new Error(fail)
-		}
-		return result
-	}
-
-	/** @returns {AsyncGenerator<OutputMessage>} */
-	async *run() {
-		throw new Error('Must be extended')
-	}
-}

package/src/commands/DepsCommand.js

@@ -1,143 +0,0 @@
-/**
- * DepsCommand – Message‑based version of the old `DepsCommand`.
- *
- * Checks and optionally fixes workspace / link dependencies.
- *
- * Body schema:
- *   fix – boolean – whether to apply fixes (default: false)
- *
- * @module release/commands/DepsCommand
- */
-
-import { Message, OutputMessage } from '@nan0web/co'
-
-import Command from './Command.js'
-
-class DepsBody {
-	/** @type {boolean} */
-	fix = false
-	static fix = {
-		help: 'Apply fixes automatically',
-		defaultValue: false,
-	}
-	/** @type {boolean} */
-	latest = false
-	static latest = {
-		help: 'Update @nan0web packages to the latests available versions',
-		defaultValue: false,
-	}
-	constructor(input = {}) {
-		const { fix = this.fix, latest = this.latest } = Message.parseBody(input, DepsBody)
-		this.fix = Boolean(fix)
-		this.latest = Boolean(latest)
-	}
-}
-
-export default class DepsCommand extends Command {
-	static name = 'deps'
-	static help = 'Dependencies manager'
-	static Body = DepsBody
-	/** @type {DepsBody} */
-	body
-
-	/** @param {Partial<DepsBody>} [input={}] */
-	constructor(input = {}) {
-		super({})
-		this.body = Command.parseBody(input, DepsBody)
-	}
-
-	/**
-	 * @param {DepsCommand} [msg]
-	 * @returns {AsyncGenerator<OutputMessage>}
-	 */
-	async *run(msg = new DepsCommand()) {
-		const pkg = await this.fs.loadDocument('package.json', {})
-		yield new OutputMessage(['Loaded package.json', JSON.stringify(pkg).length + ' bytes'])
-		const deps = {
-			devDependencies: pkg?.devDependencies ?? {},
-			dependencies: pkg?.dependencies ?? {},
-			peerDependencies: pkg?.peerDependencies ?? {},
-		}
-		const fixes = new Map()
-		const fails = new Set()
-
-		const isLocal = (ver) =>
-			['workspace:', 'link:'].some((p) => String(ver).toLowerCase().startsWith(p))
-
-		const changes = new Map()
-
-		for (const [group, map] of Object.entries(deps)) {
-			yield new OutputMessage(`${group} (${Object.keys(map).length} items)`)
-			for (const [dep, ver] of Object.entries(map ?? {})) {
-				if (isLocal(ver) || msg.body.latest) {
-					const result = await this._run(
-						'npm',
-						['info', dep, '--json'],
-						'Cannot retrieve npm package info',
-					)
-					try {
-						const data = JSON.parse(result.text)
-						if (data.version) {
-							fixes.set(dep, data.version)
-							yield new OutputMessage({
-								content: [`  ${dep}: ${ver} → ${data.version}`],
-								type: OutputMessage.TYPES.WARNING,
-							})
-						} else {
-							fails.add(dep)
-							yield new OutputMessage({
-								content: [`  ${dep}: 404 — not found`],
-								type: OutputMessage.TYPES.ERROR,
-							})
-						}
-					} catch (/** @type {any} */ err) {
-						yield new OutputMessage(err)
-					}
-				} else {
-					yield new OutputMessage({
-						content: [`  ${dep}: ${ver}`],
-						type: OutputMessage.TYPES.SUCCESS,
-					})
-				}
-			}
-		}
-
-		if (fails.size) {
-			yield new OutputMessage(
-				new Error(`Some dependencies are not yet published on npm: ${[...fails].join(', ')}`),
-			)
-			return
-		}
-
-		if ((msg.body.fix || msg.body.latest) && fixes.size) {
-			for (const [dep, ver] of fixes) {
-				// naive fix – replace in package.json
-				const args = ['install']
-				if (pkg.devDependencies?.[dep]) {
-					pkg.devDependencies[dep] = ver
-					args.push('--save-dev')
-				}
-				if (pkg.dependencies?.[dep]) pkg.dependencies[dep] = ver
-				args.push(dep + '@latest')
-				if (msg.body.latest) {
-					yield new OutputMessage([`Installing dependency`])
-					await this._run('npm', args)
-				}
-				changes.set(dep, `${dep}: ${ver}`)
-				yield new OutputMessage({
-					content: [`Fixed ${dep} → ${ver}`],
-					type: OutputMessage.TYPES.SUCCESS,
-				})
-			}
-			await this.fs.saveDocument('package.json', pkg)
-			yield new OutputMessage({
-				content: [`Fixes saved (${changes.size} changes)`],
-				type: OutputMessage.TYPES.SUCCESS,
-			})
-			yield new OutputMessage({ content: ['Dependencies fixed'] })
-		} else {
-			yield new OutputMessage(`Run with --fix to apply ${fixes.size} available fixes`)
-			yield new OutputMessage({ content: ['Dependencies check completed'] })
-		}
-	}
-}

package/src/commands/InitCommand.js

@@ -1,57 +0,0 @@
-import { OutputMessage } from '@nan0web/co'
-import Command from './Command.js'
-import process from 'node:process'
-
-class InitBody {
-	static version = { help: 'Release version', defaultValue: '' }
-	/** @type {string} */
-	version = ''
-	constructor({ version = '' } = {}) {
-		this.version = String(version)
-	}
-}
-
-export default class InitCommand extends Command {
-	static name = 'init'
-	static help = 'Initialize a new release structure'
-	static Body = InitBody
-
-	/** @param {Partial<Command> & { body?: Partial<InitBody> }} [input={}] */
-	constructor(input = {}) {
-		super(input)
-		this.body = new InitBody(/** @type {*} */ (input))
-	}
-
-	async *run() {
-		let v = this.body.version
-		if (!v) {
-			throw new Error('Version is required (e.g. --version=1.0.0 or --version=v1.0.0)')
-		}
-		if (!v.startsWith('v')) v = 'v' + v
-
-		const parts = v.replace('v', '').split('.')
-		const major = parts[0] || '0'
-		const minor = parts[1] || '0'
-
-		const { mkdirSync, writeFileSync } = await import('node:fs')
-		const { join } = await import('node:path')
-
-		const dir = join(process.cwd(), 'releases', major, minor, v)
-		mkdirSync(dir, { recursive: true })
-
-		const taskPath = join(dir, 'task.md')
-		writeFileSync(taskPath, `# Release ${v}\n\n- [ ] Task 1`, 'utf8')
-
-		const specPath = join(dir, 'test.spec.js')
-		writeFileSync(
-			specPath,
-			`import test from 'node:test'\nimport assert from 'node:assert'\n\ntest('Sample spec', () => {\n\tassert.ok(true)\n})\n`,
-			'utf8',
-		)
-
-		yield new OutputMessage({
-			content: [`✅ Initialized release ${v} in ${dir}`],
-			type: OutputMessage.TYPES.SUCCESS,
-		})
-	}
-}

package/src/commands/PublishCommand.js

@@ -1,105 +0,0 @@
-/**
- * PublishCommand – Message‑based version of the old `PublishCommand`.
- *
- * Publishes the current package to NPM and creates a Git tag.
- *
- * Body schema:
- *   major | minor | patch – optional version bump flag.
- *
- * @module release/commands/PublishCommand
- */
-
-import { Message, OutputMessage } from '@nan0web/co'
-
-import Command from './Command.js'
-
-class PublishBody {
-	static major = { help: 'Bump major version', defaultValue: false }
-	static minor = { help: 'Bump minor version', defaultValue: false }
-	static patch = { help: 'Bump patch version', defaultValue: false }
-
-	/** @type {boolean} */
-	major = false
-	/** @type {boolean} */
-	minor = false
-	/** @type {boolean} */
-	patch = false
-
-	constructor({ major = false, minor = false, patch = false } = {}) {
-		this.major = Boolean(major)
-		this.minor = Boolean(minor)
-		this.patch = Boolean(patch)
-	}
-}
-
-export default class PublishCommand extends Command {
-	static name = 'publish'
-	static help = 'Publish npm packages'
-	static Body = PublishBody
-
-	/** @type {PublishBody} */
-	body
-
-	/** @param {Partial<Command> & { body?: Partial<PublishBody> }} [input={}] */
-	constructor(input = {}) {
-		super(input)
-		const { body = new PublishBody() } = Message.parseBody(input, PublishBody)
-		this.body = new PublishBody(body)
-	}
-
-	/** @returns {AsyncGenerator<OutputMessage>} */
-	async *run() {
-		const bump = this.body.major
-			? 'major'
-			: this.body.minor
-				? 'minor'
-				: this.body.patch
-					? 'patch'
-					: null
-		if (bump) {
-			await this._run('npm', ['version', bump], 'Failed to bump version')
-		}
-		const pkg = await this.fs.loadDocument('package.json', {})
-		const tag = `v${pkg.version}`
-
-		yield new OutputMessage(`🛜 nan0release: publishing @${pkg.name}@${pkg.version}`)
-
-		await this._run('git', ['diff', '--quiet'], 'Uncommitted changes found')
-
-		await this._run('git', ['pull'], 'Failed to pull latest changes')
-		await this._run('npm', ['run', 'clean'], 'Clean failed')
-		await this._run('npm', ['run', 'build'], 'Build failed')
-		await this._run('npm', ['test'], 'Tests failed')
-
-		return
-
-		const tagsResult = await this._run('git', ['tag'], 'Failed to get tags')
-		const tags = tagsResult.text.split('\n').filter(Boolean)
-
-		if (!tags.includes(tag)) {
-			await this._run(
-				'git',
-				['tag', '-a', tag, '-m', `Release ${pkg.version}`],
-				'Tag creation failed',
-			)
-			yield new OutputMessage({
-				content: [`Tag ${tag} created`],
-				type: OutputMessage.TYPES.SUCCESS,
-			})
-		} else {
-			yield new OutputMessage({
-				content: [`Tag ${tag} already exists`],
-				type: OutputMessage.TYPES.WARNING,
-			})
-		}
-
-		await this._run('npm', ['publish', '--access', 'public'], 'Publish to npm failed')
-		await this._run('git', ['push', 'origin', 'main', '--no-verify'], 'Git push failed')
-		await this._run('git', ['push', 'origin', '--tags', '--no-verify'], 'Tag push failed')
-
-		yield new OutputMessage({
-			content: [`${pkg.name}@${pkg.version} published.`],
-			type: OutputMessage.TYPES.SUCCESS,
-		})
-	}
-}

package/src/commands/SpecCommand.js

@@ -1,41 +0,0 @@
-import { OutputMessage } from '@nan0web/co'
-import Command from './Command.js'
-import process from 'node:process'
-import Scanner from '../Release/Scanner.js'
-
-class SpecBody {
-	static version = { help: 'Release version filter', defaultValue: '' }
-	/** @type {string} */
-	version = ''
-	constructor({ version = '' } = {}) {
-		this.version = String(version)
-	}
-}
-
-export default class SpecCommand extends Command {
-	static name = 'spec'
-	static help = 'Run spec testing for the active release'
-	static Body = SpecBody
-
-	/** @param {Partial<Command> & { body?: Partial<SpecBody> }} [input={}] */
-	constructor(input = {}) {
-		super(input)
-		this.body = new SpecBody(/** @type {*} */ (input))
-	}
-
-	async *run() {
-		yield new OutputMessage(`🛜 nan0release spec ${this.body.version || 'all'}`)
-		const scanner = new Scanner(process.cwd())
-		const specs = scanner.findSpecs(this.body.version)
-		if (specs.length === 0) {
-			yield new OutputMessage(`No specs found.`)
-			return
-		}
-		const files = specs.map((s) => s.path)
-		await this._run('node', ['--test', ...files], 'Specs failed')
-		yield new OutputMessage({
-			content: [`✅ Specs passed`],
-			type: OutputMessage.TYPES.SUCCESS,
-		})
-	}
-}

package/src/commands/StatusCommand.js

@@ -1,26 +0,0 @@
-import { OutputMessage } from '@nan0web/co'
-import Command from './Command.js'
-import process from 'node:process'
-import Scanner from '../Release/Scanner.js'
-
-export default class StatusCommand extends Command {
-	static name = 'status'
-	static help = 'Show release status'
-
-	constructor(input = {}) {
-		super(input)
-		this.body = {}
-	}
-
-	async *run() {
-		const scanner = new Scanner(process.cwd())
-		const statuses = scanner.status()
-
-		yield new OutputMessage(`🛜 nan0release status`)
-		for (const st of statuses) {
-			yield new OutputMessage(
-				`${st.version.padEnd(10)} | ${st.state.padEnd(6)} | Specs: ${st.specs.length}, Tests: ${st.tests.length}`,
-			)
-		}
-	}
-}

package/src/db/ReleaseDB.js

@@ -1,54 +0,0 @@
-import DBFS from '@nan0web/db-fs'
-
-/**
- * ReleaseDB – thin wrapper around DBFS that adds a convenient `releases`
- * getter returning all release directories discovered under the root.
- *
- * The underlying DBFS stores a `Map` called `data` where each key is a
- * relative file path (e.g. "1/0/v1.0.0/release.js").
- */
-class ReleaseDB extends DBFS {
-	/**
-	 * @param {string} uri
-	 * @returns {ReleaseDB}
-	 */
-	extract(uri) {
-		return new ReleaseDB(super.extract(uri))
-	}
-	/**
-	 * @param {string} version
-	 * @returns {ReleaseDB}
-	 */
-	extractVersion(version) {
-		const found = version.match(/^v(\d+)\.(\d+)\.(\d+)$/)
-		if (!found) {
-			throw new Error('Incorrect version')
-		}
-		const arr = version.slice(1).split('.')
-		const path = [arr[0], arr[1], version, ''].join('/')
-		return ReleaseDB.from(this.extract(path))
-	}
-	/**
-	 * @returns {Array<string>} List of discovered release root paths
-	 */
-	get releases() {
-		const paths = new Set()
-		for (const key of this.data.keys()) {
-			// Expected structure: major/minor/vX.Y.Z/…
-			const parts = key.split('/')
-			if (parts.length > 2 && /^\d+$/.test(parts[0]) && /^\d+$/.test(parts[1])) {
-				paths.add(`${parts[0]}/${parts[1]}/${parts[2]}`)
-			}
-		}
-		return Array.from(paths)
-	}
-	/**
-	 * @param {object} input
-	 * @returns {ReleaseDB}
-	 */
-	static from(input) {
-		if (input instanceof ReleaseDB) return input
-		return new ReleaseDB(input)
-	}
-}
-export default ReleaseDB