@profoundlogic/codermake 1.0.0

package/dist/makefiles/ibmi.mk

@@ -0,0 +1,188 @@
+######
+# IBM i build rules and recipe utilities
+# For local builds on IBM i PASE
+######
+
+######
+# Bail out if required environment variables are not set properly.
+######
+ifeq (,$(BUILD_LIBRARY))
+  $(error Required variable BUILD_LIBRARY is not set.)
+endif
+ifneq (1,$(words [$(BUILD_LIBRARY)]))
+  $(error BUILD_LIBRARY variable is not set correctly. Set to a valid library name and try again)
+endif
+
+######
+# Output library.
+######
+LIBRARY := $(BUILD_LIBRARY)
+LIBRARY_PATH := /qsys.lib/$(LIBRARY).lib
+
+######
+# Shell configuration.
+######
+export QIBM_MULTI_THREADED := Y
+SHELL := /usr/bin/qsh
+MKDIR := /QOpenSys/usr/bin/mkdir
+
+######
+# Utility to create a source member from IFS source.
+# $(1) = IFS file path (source type is derived from file extension)
+# $(2) = source file name (e.g., qddssrc, qrpglesrc)
+######
+define CREATE_SOURCE_MEMBER
+test -e $(LIBRARY_PATH)/$(2).file || system "crtsrcpf file($(LIBRARY)/$(2))"
+test -e $(LIBRARY_PATH)/$(2).file/$(basename $(notdir $(1))).mbr || system "addpfm file($(LIBRARY)/$(2)) mbr($(basename $(notdir $(1)))) srctype($(subst .,,$(suffix $(1))))"
+cat '$(1)' | Rfile -Qw '$(LIBRARY)/$(2)($(basename $(notdir $(1))))'
+endef
+
+######
+# Utility to build an object via CL commands in a separate file.
+# $(1) = Object path
+# $(2) = Command file path
+######
+define BUILD_FROM_CL_FILE
+rm -rf '$(1)'
+export LIBRARY=$(LIBRARY)
+export NAME=$(basename $(notdir $(1)))
+(
+  $(SET_LIBL)
+  echo "$(file < $(2))" | while IFS= read -r line; do
+    system "$$line"
+  done
+) || (rm -rf '$(1)'; exit 1)
+endef
+
+######
+# Utility to output "Creating X..." message and redirect recipe output to log file.
+######
+define SETUP_LOG
+@echo "Creating $(1)"
+touch -C 1208 'tmp/logs/$(1).log'
+exec > 'tmp/logs/$(1).log' 2>&1
+endef
+
+######
+# Prerun actions.
+######
+$(info ===)
+$(info Target library: $(LIBRARY))
+$(info ===)
+
+######
+# Library creation target
+######
+$(LIBRARY_PATH):
+	$(call SETUP_LOG,$(notdir $@))
+	system "crtlib $(LIBRARY) *test aut(*use) crtaut(*use)"
+
+######
+# Recipe utilities (callable functions for preprocessor-generated rules)
+######
+
+# Build RPGLE program (bound)
+define BUILD_RPGLE_PGM
+$(call SETUP_LOG,$(notdir $@))
+$(SET_LIBL)
+system "crtbndrpg pgm($(LIBRARY)/$(basename $(@F))) srcstmf('$<') incdir('src') tgtccsid(*job) output(*print) dbgview(*all)"
+endef
+
+# Build SQL RPGLE program
+define BUILD_SQLRPGLE_PGM
+$(call SETUP_LOG,$(notdir $@))
+$(SET_LIBL)
+system "crtsqlrpgi obj($(LIBRARY)/$(basename $(@F))) objtype(*pgm) srcstmf('$<') cvtccsid(*job) output(*print) rpgppopt(*lvl1) compileopt('incdir(''src'') tgtccsid(*job) output(*print)') dbgview(*source)"
+endef
+
+# Build RPGLE module
+define BUILD_RPGLE_MODULE
+$(call SETUP_LOG,$(notdir $@))
+$(SET_LIBL)
+system "crtrpgmod module($(LIBRARY)/$(basename $(@F))) srcstmf('$<') incdir('src') tgtccsid(*job) output(*print) dbgview(*all)"
+endef
+
+# Build SQL RPGLE module
+define BUILD_SQLRPGLE_MODULE
+$(call SETUP_LOG,$(notdir $@))
+$(SET_LIBL)
+system "crtsqlrpgi obj($(LIBRARY)/$(basename $(@F))) objtype(*module) srcstmf('$<') cvtccsid(*job) output(*print) rpgppopt(*lvl1) compileopt('incdir(''src'') tgtccsid(*job) output(*print)') dbgview(*source)"
+endef
+
+# Build program from modules
+define BUILD_MODULE_TO_PGM
+$(call SETUP_LOG,$(notdir $@))
+$(SET_LIBL)
+system "crtpgm pgm($(LIBRARY)/$(basename $(@F))) module($(foreach m,$(filter %.module,$^),$(basename $(notdir $(m)))))"
+endef
+
+# Build service program from modules
+define BUILD_MODULE_TO_SRVPGM
+$(call SETUP_LOG,$(notdir $@))
+$(SET_LIBL)
+system "crtsrvpgm srvpgm($(LIBRARY)/$(basename $(@F))) module($(foreach m,$(filter %.module,$^),$(basename $(notdir $(m))))) export(*srcfile) srcstmf('$(filter %.exports,$^)')"
+endef
+
+# Build display file
+define BUILD_DSPF_TO_FILE
+$(call SETUP_LOG,$(notdir $@))
+$(call CREATE_SOURCE_MEMBER,$<,qddssrc)
+$(SET_LIBL)
+system "crtdspf file($(LIBRARY)/$(basename $(@F))) srcfile($(LIBRARY)/qddssrc)"
+endef
+
+# Build display file from RDF (Rich Display File) JSON
+define BUILD_RDF_TO_FILE
+$(call SETUP_LOG,$(notdir $@))
+node '$(CODERMAKE_PACKAGE_DIR)/bin/rdf-to-dds.js' '$<' 'tmp/$(basename $(@F)).dspf'
+$(call CREATE_SOURCE_MEMBER,tmp/$(basename $(@F)).dspf,qddssrc)
+$(SET_LIBL)
+system "crtdspf file($(LIBRARY)/$(basename $(@F))) srcfile($(LIBRARY)/qddssrc) enhdsp(*yes)"
+rm -f 'tmp/$(basename $(@F)).dspf'
+endef
+
+# Build physical file
+define BUILD_PF_TO_FILE
+$(call SETUP_LOG,$(notdir $@))
+$(call CREATE_SOURCE_MEMBER,$<,qddssrc)
+$(SET_LIBL)
+system "crtpf file($(LIBRARY)/$(basename $(@F))) srcfile($(LIBRARY)/qddssrc) aut(*change)"
+endef
+
+# Build logical file
+define BUILD_LF_TO_FILE
+$(call SETUP_LOG,$(notdir $@))
+$(call CREATE_SOURCE_MEMBER,$<,qddssrc)
+$(SET_LIBL)
+system "crtlf file($(LIBRARY)/$(basename $(@F))) srcfile($(LIBRARY)/qddssrc)"
+endef
+
+# Build message file from CL commands
+define BUILD_MSGF
+$(call SETUP_LOG,$(notdir $@))
+$(call BUILD_FROM_CL_FILE,$@,$<)
+endef
+
+# Build binding directory from CL commands
+define BUILD_BNDDIR
+$(call SETUP_LOG,$(notdir $@))
+$(call BUILD_FROM_CL_FILE,$@,$<)
+endef
+
+# Build menu from display file and message file
+define BUILD_MENU
+$(call SETUP_LOG,$(notdir $@))
+$(SET_LIBL)
+system "crtmnu menu($(LIBRARY)/$(basename $(@F))) type(*dspf) dspf($(basename $(notdir $(filter %.file,$^)))) msgf($(basename $(notdir $(filter %.msgf,$^)))) cmdlin(*none) dspkey(*no)"
+endef
+
+######
+# Platform-specific clean
+######
+.PHONY: platform-clean
+platform-clean:
+	@if [ -n "$(TARGETS)" ] && [ -d $(LIBRARY_PATH) ]; then
+	  for target in $(TARGETS); do
+	    rm -rf "$$target"
+	  done
+	fi

package/dist/makefiles/unix.mk

@@ -0,0 +1,288 @@
+######
+# Unix-like build rules and recipe utilities
+# For remote builds from Linux, macOS, FreeBSD, etc. to IBM i via SSH
+######
+
+######
+# Bail out if required environment variables are not set properly.
+######
+ifeq (,$(IBMI_BUILD_LIBRARY))
+  $(error Required variable IBMI_BUILD_LIBRARY is not set.)
+endif
+ifneq (1,$(words [$(IBMI_BUILD_LIBRARY)]))
+  $(error IBMI_BUILD_LIBRARY variable is not set correctly. Set to a valid library name and try again.)
+endif
+ifeq (,$(IBMI_HOST))
+  $(warning Warning: Required variable IBMI_HOST is not set.)
+endif
+ifeq (,$(IBMI_USER))
+  $(warning Warning: Required variable IBMI_USER is not set.)
+endif
+
+######
+# Output library.
+######
+LIBRARY := $(IBMI_BUILD_LIBRARY)
+LIBRARY_PATH := /qsys.lib/$(LIBRARY).lib
+
+######
+# Shell configuration.
+######
+SHELL := /bin/bash
+QSHELL := /usr/bin/qsh -e
+MKDIR := mkdir
+
+######
+# SSH configuration for IBM i connectivity.
+######
+SSH := ssh -C \
+  -o PasswordAuthentication=no \
+  -o StrictHostKeyChecking=no \
+  -o UserKnownHostsFile=tmp/known_hosts \
+  -o ControlMaster=auto \
+  -o ControlPath=$(CODERMAKE_RULES_DIR)/ssh-%C \
+  -o ControlPersist=10m \
+  -o ServerAliveInterval=60 \
+  -o ServerAliveCountMax=3
+ifdef IBMI_KEY
+	SSH := $(SSH) -i $(IBMI_KEY)
+endif
+SSH := $(SSH) $(IBMI_USER)@$(IBMI_HOST)
+
+######
+# Utility to upload a source member to IBM i from a local file.
+# $(1) = local file path (source type is derived from file extension)
+# $(2) = source file name (e.g., qddssrc, qrpglesrc)
+######
+define CREATE_SOURCE_MEMBER
+$(SSH) $(QSHELL) <<'EOF'
+  if [ ! -e '$(LIBRARY_PATH)/$(2).file' ]; then
+    system "crtsrcpf file($(LIBRARY)/$(2))"
+  fi
+  if [ ! -e '$(LIBRARY_PATH)/$(2).file/$(basename $(notdir $(1))).mbr' ]; then
+    system "addpfm file($(LIBRARY)/$(2)) mbr($(basename $(notdir $(1)))) srctype($(subst .,,$(suffix $(1))))"
+  fi
+EOF
+cat '$(1)' | $(SSH) "$(QSHELL) -c 'Rfile -Qw \"$(LIBRARY)/$(2)($(basename $(notdir $(1))))\"'"
+endef
+
+######
+# Utility to build an object via CL commands in a separate file.
+# $(1) = Target path
+# $(2) = Command file path
+######
+define BUILD_FROM_CL_FILE
+$(call REMOTE_BUILD,$(2), \
+  rm -rf '$(LIBRARY_PATH)/$(notdir $(1))' && \
+  export LIBRARY=$(LIBRARY) && \
+  export NAME=$(basename $(notdir $(1))) && \
+  ( \
+    echo "$(file < $<)" | while IFS= read -r line; do \
+      system "$$line"; \
+    done \
+  ) || (rm -rf '$(LIBRARY_PATH)/$(notdir $(1))'; exit 1) \
+)
+endef
+
+######
+# Utility to output "Creating X..." message and redirect recipe output to log file.
+######
+define SETUP_LOG
+@echo "Creating $(1)"
+exec > 'tmp/logs/$(1).log' 2>&1
+endef
+
+######
+# Reusable utility for remote builds via SSH.
+# Handles the complete pattern of:
+# 1. Creating an uncompressed tar archive of source files locally (preserving paths)
+# 2. Creating a temporary directory on IBM i and uploading the tar
+# 3. Extracting the tar (recreating directory structure), then executing build command with library list set
+# 4. Cleaning up temp directories (local and remote) and propagating exit codes
+#
+# $(1) = space-separated list of local files to upload
+# $(2) = build command to execute (typically a 'system' command)
+#
+# Files are archived with their full paths, so 'src/myfile.rpgle' will extract to
+# '$$REMOTE_DIR/src/myfile.rpgle' on the remote system.
+#
+# Build command runs with current directory set to the remote temp directory.
+######
+define REMOTE_BUILD
+TAR_FILE=tmp/codermake_$$(uuidgen).tar
+tar -cf "$$TAR_FILE" $(1)
+REMOTE_DIR=/tmp/codermake_$$(uuidgen)
+$(SSH) "$(QSHELL) -c 'mkdir $$REMOTE_DIR'"
+EXIT_CODE=0
+(
+  cat "$$TAR_FILE" | $(SSH) "cat > '$$REMOTE_DIR/sources.tar'" && \
+  $(SSH) "REMOTE_DIR=$$REMOTE_DIR $(QSHELL)" <<'EOF'
+    cd $$REMOTE_DIR
+    tar -xf sources.tar
+    cd $$REMOTE_DIR
+    $(SET_LIBL)
+    $(2)
+EOF
+) || EXIT_CODE=$$?
+rm -f "$$TAR_FILE"
+$(SSH) "REMOTE_DIR=$$REMOTE_DIR $(QSHELL) -c 'rm -rf $$REMOTE_DIR'"
+if [ $$EXIT_CODE -ne 0 ]; then
+  exit $$EXIT_CODE
+fi
+endef
+
+######
+# Prerun actions.
+######
+$(info ===)
+$(info Target IBM i: $(IBMI_HOST))
+$(info Target library: $(LIBRARY))
+$(info Build user: $(IBMI_USER))
+$(info ===)
+$(shell mkdir -p build)
+
+######
+# Library creation target
+######
+build/$(LIBRARY).lib:
+	$(call SETUP_LOG,$(notdir $@))
+	$(SSH) "test -e $(LIBRARY_PATH) || system \"crtlib $(LIBRARY) *test aut(*use) crtaut(*use)\""
+	touch '$@'
+
+######
+# Recipe utilities (callable functions for preprocessor-generated rules)
+######
+
+# Build RPGLE program (bound)
+define BUILD_RPGLE_PGM
+$(call SETUP_LOG,$(notdir $@))
+$(call REMOTE_BUILD,$(filter-out build/%,$^),system "crtbndrpg pgm($(LIBRARY)/$(basename $(@F))) srcstmf('$<') incdir('.') tgtccsid(*job) output(*print) dbgview(*all)")
+touch '$@'
+endef
+
+# Build SQL RPGLE program
+define BUILD_SQLRPGLE_PGM
+$(call SETUP_LOG,$(notdir $@))
+$(call REMOTE_BUILD,$(filter-out build/%,$^),system "crtsqlrpgi obj($(LIBRARY)/$(basename $(@F))) objtype(*pgm) srcstmf('$<') cvtccsid(*job) output(*print) rpgppopt(*lvl1) compileopt('incdir(''.'') tgtccsid(*job) output(*print)') dbgview(*source)")
+touch '$@'
+endef
+
+# Build RPGLE module
+define BUILD_RPGLE_MODULE
+$(call SETUP_LOG,$(notdir $@))
+$(call REMOTE_BUILD,$(filter-out build/%,$^),system "crtrpgmod module($(LIBRARY)/$(basename $(@F))) srcstmf('$<') incdir('.') tgtccsid(*job) output(*print) dbgview(*all)")
+touch '$@'
+endef
+
+# Build SQL RPGLE module
+define BUILD_SQLRPGLE_MODULE
+$(call SETUP_LOG,$(notdir $@))
+$(call REMOTE_BUILD,$(filter-out build/%,$^),system "crtsqlrpgi obj($(LIBRARY)/$(basename $(@F))) objtype(*module) srcstmf('$<') cvtccsid(*job) output(*print) rpgppopt(*lvl1) compileopt('incdir(''.'') tgtccsid(*job) output(*print)') dbgview(*source)")
+touch '$@'
+endef
+
+# Build program from modules
+define BUILD_MODULE_TO_PGM
+$(call SETUP_LOG,$(notdir $@))
+$(SSH) $(QSHELL) <<'EOF'
+  $(SET_LIBL)
+  system "crtpgm pgm($(LIBRARY)/$(basename $(@F))) module($(foreach m,$(filter %.module,$^),$(basename $(notdir $(m)))))"
+EOF
+touch '$@'
+endef
+
+# Build service program from modules
+define BUILD_MODULE_TO_SRVPGM
+$(call SETUP_LOG,$(notdir $@))
+$(call REMOTE_BUILD,$(filter-out build/%,$^),system "crtsrvpgm srvpgm($(LIBRARY)/$(basename $(@F))) module($(foreach m,$(filter %.module,$^),$(basename $(notdir $(m))))) export(*srcfile) srcstmf('$(filter %.exports,$^)')")
+touch '$@'
+endef
+
+# Build display file
+define BUILD_DSPF_TO_FILE
+$(call SETUP_LOG,$(notdir $@))
+$(call CREATE_SOURCE_MEMBER,$<,qddssrc)
+$(SSH) $(QSHELL) <<'EOF'
+  $(SET_LIBL)
+  system "crtdspf file($(LIBRARY)/$(basename $(@F))) srcfile($(LIBRARY)/qddssrc)"
+EOF
+touch '$@'
+endef
+
+# Build display file from RDF (Rich Display File) JSON
+define BUILD_RDF_TO_FILE
+$(call SETUP_LOG,$(notdir $@))
+node '$(CODERMAKE_PACKAGE_DIR)/bin/rdf-to-dds.js' '$<' 'tmp/$(basename $(@F)).dspf'
+$(call CREATE_SOURCE_MEMBER,tmp/$(basename $(@F)).dspf,qddssrc)
+$(SSH) $(QSHELL) <<'EOF'
+  $(SET_LIBL)
+  system "crtdspf file($(LIBRARY)/$(basename $(@F))) srcfile($(LIBRARY)/qddssrc) enhdsp(*yes)"
+EOF
+rm -f 'tmp/$(basename $(@F)).dspf'
+touch '$@'
+endef
+
+# Build physical file
+define BUILD_PF_TO_FILE
+$(call SETUP_LOG,$(notdir $@))
+$(call CREATE_SOURCE_MEMBER,$<,qddssrc)
+$(SSH) $(QSHELL) <<'EOF'
+  $(SET_LIBL)
+  system "crtpf file($(LIBRARY)/$(basename $(@F))) srcfile($(LIBRARY)/qddssrc)"
+EOF
+touch '$@'
+endef
+
+# Build logical file
+define BUILD_LF_TO_FILE
+$(call SETUP_LOG,$(notdir $@))
+$(call CREATE_SOURCE_MEMBER,$<,qddssrc)
+$(SSH) $(QSHELL) <<'EOF'
+  $(SET_LIBL)
+  system "crtlf file($(LIBRARY)/$(basename $(@F))) srcfile($(LIBRARY)/qddssrc)"
+EOF
+touch '$@'
+endef
+
+# Build message file from CL commands
+define BUILD_MSGF
+$(call SETUP_LOG,$(notdir $@))
+$(call BUILD_FROM_CL_FILE,$@,$<)
+touch '$@'
+endef
+
+# Build binding directory from CL commands
+define BUILD_BNDDIR
+$(call SETUP_LOG,$(notdir $@))
+$(call BUILD_FROM_CL_FILE,$@,$<)
+touch '$@'
+endef
+
+# Build menu from display file and message file
+define BUILD_MENU
+$(call SETUP_LOG,$(notdir $@))
+$(SSH) $(QSHELL) <<'EOF'
+  $(SET_LIBL)
+  system "crtmnu menu($(LIBRARY)/$(basename $(@F))) type(*dspf) dspf($(basename $(notdir $(filter %.file,$^)))) msgf($(basename $(notdir $(filter %.msgf,$^)))) cmdlin(*none) dspkey(*no)"
+EOF
+touch '$@'
+endef
+
+######
+# Platform-specific clean
+######
+.PHONY: platform-clean
+platform-clean:
+	@rm -rf build/*
+	rm -rf tmp/logs
+	rm -rf tmp/codermake_*.tar
+	@CLEAN_TARGETS="$(notdir $(TARGETS))"
+	if [ -n "$$CLEAN_TARGETS" ]; then
+	  $(SSH) $(QSHELL) <<EOF
+	    if [ -d $(LIBRARY_PATH) ]; then
+	      for target in $$CLEAN_TARGETS; do
+	        rm -rf "$(LIBRARY_PATH)/\$$target"
+	      done
+	    fi
+	EOF
+	fi

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@profoundlogic/codermake",
+  "version": "1.0.0",
+  "description": "Make wrapper framework for IBM i development that simplifies build rules",
+  "main": "dist/bin/index.js",
+  "type": "module",
+  "bin": {
+    "codermake": "dist/bin/index.js"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "test": "npm run test:unit && npm run test:integration",
+    "test:unit": "node --test test/unit/**/*.test.js",
+    "test:integration": "CODERMAKE_E2E_TEST=true node --test --test-concurrency=1 test/integration/**/*.test.js",
+    "build": "node scripts/build.js",
+    "clean": "rm -rf dist/",
+    "test:dist": "npm run build && npm run test:dist:unit && npm run test:dist:integration",
+    "test:dist:unit": "node --test dist/test/unit/**/*.test.js",
+    "test:dist:integration": "CODERMAKE_E2E_TEST=true node --test --test-concurrency=1 dist/test/integration/**/*.test.js",
+    "lint": "eslint . --ignore-pattern dist/",
+    "start": "./bin/index.js",
+    "prepublishOnly": "npm run lint && npm test && npm run build && npm run test:dist"
+  },
+  "author": "Profound Logic Software",
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "devDependencies": {
+    "dotenv": "^16.4.7",
+    "eslint": "^9.39.1",
+    "javascript-obfuscator": "^5.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/bin/",
+    "dist/lib/",
+    "dist/makefiles/",
+    "README.md",
+    "LICENSE.txt"
+  ]
+}