feat(ci): add PostgreSQL extension builds for Linux, macOS, and Windows

Add a postgres-build matrix job that compiles the PostgreSQL extension
for 5 platform/arch combinations (linux-x86_64, linux-arm64,
macos-arm64, macos-x86_64, windows-x86_64) and includes them as
release assets. Add postgres-package Makefile target and Windows
platform support (PG_EXTENSION_LIB, -lpostgres linking).

Author: andinux

.github/workflows/main.yml

@@ -265,10 +265,77 @@ jobs:
           docker cp test/postgresql cloudsync-postgres:/tmp/cloudsync/test/postgresql
           docker exec cloudsync-postgres psql -U postgres -d postgres -f /tmp/cloudsync/test/postgresql/full_test.sql
 
+  postgres-build:
+    runs-on: ${{ matrix.os }}
+    name: postgresql-${{ matrix.name }}-${{ matrix.arch }} build
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-22.04
+            arch: x86_64
+            name: linux
+          - os: ubuntu-22.04-arm
+            arch: arm64
+            name: linux
+          - os: macos-15
+            arch: arm64
+            name: macos
+          - os: macos-13
+            arch: x86_64
+            name: macos
+          - os: windows-2022
+            arch: x86_64
+            name: windows
+
+    steps:
+
+      - uses: actions/checkout@v4.2.2
+        with:
+          submodules: true
+
+      - name: linux install postgresql dev headers
+        if: matrix.name == 'linux'
+        run: |
+          sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
+          curl -fsSL https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/postgresql.gpg
+          sudo apt-get update
+          sudo apt-get install -y postgresql-server-dev-17
+
+      - name: macos install postgresql
+        if: matrix.name == 'macos'
+        run: brew install postgresql@17
+
+      - uses: msys2/setup-msys2@v2.27.0
+        if: matrix.name == 'windows'
+        with:
+          msystem: ucrt64
+          install: mingw-w64-ucrt-x86_64-gcc make mingw-w64-ucrt-x86_64-postgresql
+
+      - name: build and package postgresql extension (linux)
+        if: matrix.name == 'linux'
+        run: make postgres-package
+
+      - name: build and package postgresql extension (macos)
+        if: matrix.name == 'macos'
+        run: make postgres-package PG_CONFIG=$(brew --prefix postgresql@17)/bin/pg_config
+
+      - name: build and package postgresql extension (windows)
+        if: matrix.name == 'windows'
+        shell: msys2 {0}
+        run: make postgres-package
+
+      - uses: actions/upload-artifact@v4.6.2
+        with:
+          name: cloudsync-postgresql-${{ matrix.name }}-${{ matrix.arch }}
+          path: dist/postgresql/
+          if-no-files-found: error
+
   release:
     runs-on: ubuntu-22.04
     name: release
-    needs: [build, postgres-test]
+    needs: [build, postgres-test, postgres-build]
     if: github.ref == 'refs/heads/main'
 
     env:

docker/Makefile.postgresql

@@ -14,6 +14,17 @@ PG_INCLUDEDIR := $(shell $(PG_CONFIG) --includedir-server 2>/dev/null)
 EXTENSION = cloudsync
 EXTVERSION = 1.0
 
+# Platform-specific PostgreSQL settings
+ifeq ($(OS),Windows_NT)
+    PG_EXTENSION_LIB = $(EXTENSION).dll
+    PG_CFLAGS = -Wall -Wextra -Wno-unused-parameter -std=c11 -O2
+    PG_LDFLAGS = -shared -L$(shell $(PG_CONFIG) --libdir) -lpostgres
+else
+    PG_EXTENSION_LIB = $(EXTENSION).so
+    PG_CFLAGS = -fPIC -Wall -Wextra -Wno-unused-parameter -std=c11 -O2
+    PG_LDFLAGS = -shared
+endif
+
 # Source files - core platform-agnostic code
 PG_CORE_SRC = \
 	src/cloudsync.c \
@@ -38,23 +49,24 @@ PG_OBJS = $(PG_ALL_SRC:.c=.o)
 # Compiler flags
 # Define POSIX macros as compiler flags to ensure they're defined before any includes
 PG_CPPFLAGS = -I$(PG_INCLUDEDIR) -Isrc -Isrc/postgresql -Imodules/fractional-indexing -DCLOUDSYNC_POSTGRESQL_BUILD -D_POSIX_C_SOURCE=200809L -D_GNU_SOURCE
-PG_CFLAGS = -fPIC -Wall -Wextra -Wno-unused-parameter -std=c11 -O2
 PG_DEBUG ?= 0
 ifeq ($(PG_DEBUG),1)
+ifeq ($(OS),Windows_NT)
+PG_CFLAGS = -Wall -Wextra -Wno-unused-parameter -std=c11 -g -O0 -fno-omit-frame-pointer
+else
 PG_CFLAGS = -fPIC -Wall -Wextra -Wno-unused-parameter -std=c11 -g -O0 -fno-omit-frame-pointer
 endif
-PG_LDFLAGS = -shared
+endif
 
 # Output files
-PG_EXTENSION_SO = $(EXTENSION).so
 PG_EXTENSION_SQL = src/postgresql/$(EXTENSION)--$(EXTVERSION).sql
 PG_EXTENSION_CONTROL = docker/postgresql/$(EXTENSION).control
 
 # ============================================================================
 # PostgreSQL Build Targets
 # ============================================================================
 
-.PHONY: postgres-check postgres-build postgres-install postgres-clean postgres-test \
+.PHONY: postgres-check postgres-build postgres-install postgres-package postgres-clean postgres-test \
         postgres-docker-build postgres-docker-build-asan postgres-docker-run postgres-docker-run-asan postgres-docker-stop postgres-docker-rebuild \
         postgres-docker-debug-build postgres-docker-debug-run postgres-docker-debug-rebuild \
         postgres-docker-shell postgres-dev-rebuild postgres-help unittest-pg \
@@ -78,16 +90,16 @@ postgres-build: postgres-check
 		echo "  CC $$src"; \
 		$(CC) $(PG_CPPFLAGS) $(PG_CFLAGS) -c $$src -o $${src%.c}.o || exit 1; \
 	done
-	@echo "Linking $(PG_EXTENSION_SO)..."
-	$(CC) $(PG_LDFLAGS) -o $(PG_EXTENSION_SO) $(PG_OBJS)
-	@echo "Build complete: $(PG_EXTENSION_SO)"
+	@echo "Linking $(PG_EXTENSION_LIB)..."
+	$(CC) $(PG_LDFLAGS) -o $(PG_EXTENSION_LIB) $(PG_OBJS)
+	@echo "Build complete: $(PG_EXTENSION_LIB)"
 
 # Install extension to PostgreSQL
 postgres-install: postgres-build
 	@echo "Installing CloudSync extension to PostgreSQL..."
 	@echo "Installing shared library to $(PG_PKGLIBDIR)/"
 	install -d $(PG_PKGLIBDIR)
-	install -m 755 $(PG_EXTENSION_SO) $(PG_PKGLIBDIR)/
+	install -m 755 $(PG_EXTENSION_LIB) $(PG_PKGLIBDIR)/
 	@echo "Installing SQL script to $(PG_SHAREDIR)/extension/"
 	install -d $(PG_SHAREDIR)/extension
 	install -m 644 $(PG_EXTENSION_SQL) $(PG_SHAREDIR)/extension/
@@ -98,10 +110,21 @@ postgres-install: postgres-build
 	@echo "To use the extension, run in psql:"
 	@echo "  CREATE EXTENSION $(EXTENSION);"
 
+# Package extension files for distribution
+PG_DIST_DIR = dist/postgresql
+
+postgres-package: postgres-build
+	@echo "Packaging PostgreSQL extension..."
+	@mkdir -p $(PG_DIST_DIR)
+	cp $(PG_EXTENSION_LIB) $(PG_DIST_DIR)/
+	cp $(PG_EXTENSION_SQL) $(PG_DIST_DIR)/
+	cp $(PG_EXTENSION_CONTROL) $(PG_DIST_DIR)/
+	@echo "Package ready in $(PG_DIST_DIR)/"
+
 # Clean PostgreSQL build artifacts
 postgres-clean:
 	@echo "Cleaning PostgreSQL build artifacts..."
-	rm -f $(PG_OBJS) $(PG_EXTENSION_SO)
+	rm -f $(PG_OBJS) $(PG_EXTENSION_LIB)
 	@echo "Clean complete"
 
 # Test extension (requires running PostgreSQL)

src/cloudsync.h

@@ -18,7 +18,7 @@
 extern "C" {
 #endif
 
-#define CLOUDSYNC_VERSION                       "0.9.202"
+#define CLOUDSYNC_VERSION                       "0.9.203"
 #define CLOUDSYNC_MAX_TABLENAME_LEN             512
 
 #define CLOUDSYNC_VALUE_NOTSET                  -1