soothe-client-typescript/Makefile at main · mirasoth/soothe-client-typescript · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
# Makefile for @mirasoth/soothe-client
#
# Common developer and release tasks. Run `make help` to list targets.

SHELL := /bin/bash

PKG_NAME    := $(shell node -p "require('./package.json').name")
PKG_VERSION := $(shell node -p "require('./package.json').version")

.DEFAULT_GOAL := help

# ---------------------------------------------------------------------------
# Help
# ---------------------------------------------------------------------------

.PHONY: help
help: ## Show this help message
	@echo "$(PKG_NAME)@$(PKG_VERSION)"
	@echo ""
	@echo "Usage: make <target>"
	@echo ""
	@echo "Targets:"
	@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z_-]+:.*?## / {printf "  \033[36m%-20s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)

# ---------------------------------------------------------------------------
# Install / clean
# ---------------------------------------------------------------------------

.PHONY: install
install: ## Install dependencies (npm ci if lockfile present)
	@if [ -f package-lock.json ]; then npm ci; else npm install; fi

.PHONY: clean
clean: ## Remove build artifacts
	rm -rf dist

.PHONY: distclean
distclean: clean ## Remove build artifacts and node_modules
	rm -rf node_modules

# ---------------------------------------------------------------------------
# Build / typecheck
# ---------------------------------------------------------------------------

.PHONY: build
build: ## Compile to dist/ (ESM + CJS + .d.ts)
	npm run build

.PHONY: typecheck
typecheck: ## Run tsc --noEmit
	npm run typecheck

# ---------------------------------------------------------------------------
# Format / lint
# ---------------------------------------------------------------------------

.PHONY: format
format: ## Format source and tests with Prettier
	npm run format

.PHONY: format-check
format-check: ## Check formatting (for CI)
	npm run format:check

.PHONY: lint
lint: ## Lint source and tests with ESLint
	npm run lint

.PHONY: lint-fix
lint-fix: ## Auto-fix lint issues and re-format
	npm run lint:fix

# ---------------------------------------------------------------------------
# Test
# ---------------------------------------------------------------------------

.PHONY: test
test: ## Run unit tests
	npm test

.PHONY: test-watch
test-watch: ## Run tests in watch mode
	npm run test:watch

.PHONY: test-integration
test-integration: ## Run integration tests (requires running daemon)
	npm run test:integration

# ---------------------------------------------------------------------------
# Pre-publish verification
# ---------------------------------------------------------------------------

.PHONY: verify
verify: clean install typecheck build test pack-check ## Full pre-publish verification suite
	@echo ""
	@echo "✓ All verification checks passed for $(PKG_NAME)@$(PKG_VERSION)"
	@echo "  Next: make publish-dry  (inspect tarball)"
	@echo "        make publish      (publish to npm)"

.PHONY: pack-check
pack-check: ## Show tarball contents that would be published
	@echo ">>> Tarball contents for $(PKG_NAME)@$(PKG_VERSION):"
	@npm pack --dry-run

.PHONY: publish-check
publish-check: ## Verify npm login and scope access
	@echo ">>> npm user:"
	@npm whoami
	@echo ">>> @mirasoth scope access:"
	@npm access list packages @mirasoth 2>&1 || echo "  (no packages yet, or no access)"

# ---------------------------------------------------------------------------
# Publish
# ---------------------------------------------------------------------------

.PHONY: publish-dry
publish-dry: build ## Dry-run npm publish (no upload)
	npm publish --dry-run

# OTP can be passed as: make publish OTP=123456
OTP ?=

.PHONY: publish
publish: verify ## Publish to npm (use: make publish OTP=123456 if 2FA enabled)
	@echo ">>> Publishing $(PKG_NAME)@$(PKG_VERSION) to npm..."
	@if [ -n "$(OTP)" ]; then \
		npm publish --otp=$(OTP); \
	else \
		npm publish; \
	fi

.PHONY: version-patch
version-patch: ## Bump patch version (0.1.0 -> 0.1.1) and tag
	npm version patch

.PHONY: version-minor
version-minor: ## Bump minor version (0.1.0 -> 0.2.0) and tag
	npm version minor

.PHONY: version-major
version-major: ## Bump major version (0.1.0 -> 1.0.0) and tag
	npm version major