postbase 0.1.0

package/.github/workflows/test.yml

@@ -0,0 +1,74 @@
+name: Jest Supertest CI
+
+on:
+  push:
+    branches:
+      - main
+      - develop
+  pull_request:
+    branches:
+      - main
+      - develop
+
+jobs:
+  test:
+    name: Run Jest Supertest Tests
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [24]
+
+    services:
+      postgres:
+        image: postgres
+        env:
+          POSTGRES_USER: testuser
+          POSTGRES_PASSWORD: testpassword
+          POSTGRES_DB: postgres
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    steps:
+      - name: Checkout repository
+        run: |
+          git clone "https://x-access-token:${{ github.token }}@github.com/${{ github.repository }}.git" .
+          git checkout ${{ github.sha }}
+
+      # -------------------------------------------------------
+      # backend/lib/postbase
+      # -------------------------------------------------------
+      - name: "[backend] Install dependencies"
+        run: cd backend/lib/postbase && npm ci
+        env:
+          NODE_OPTIONS: --experimental-vm-modules
+
+      - name: "[backend] Create test database"
+        run: psql -h localhost -U testuser -d postgres -c "CREATE DATABASE postbase_testdb;"
+        env:
+          PGPASSWORD: testpassword
+
+      - name: "[backend] Run migrations"
+        run: cd backend/lib/postbase && npx node-pg-migrate up
+        env:
+          DATABASE_URL: postgresql://testuser:testpassword@localhost:5432/postbase_testdb 
+          TEST_DB_URL: postgresql://testuser:testpassword@localhost:5432/postbase_testdb
+
+      - name: "[backend] Run Jest tests"
+        run: cd backend/lib/postbase && npm test -- --coverage
+        env:
+          NODE_ENV: test
+          NODE_OPTIONS: --experimental-vm-modules
+          DATABASE_URL: postgresql://testuser:testpassword@localhost:5432/postbase_testdb
+          TEST_DB_URL: postgresql://testuser:testpassword@localhost:5432/postbase_testdb
+          PGDATABASE: postbase_testdb
+
+      - name: "[backend] Save coverage report"
+        run: |
+          mkdir -p /tmp/coverage-backend
+          cp -r backend/lib/postbase/coverage/. /tmp/coverage-backend/
+          echo "Coverage saved to runner at /tmp/coverage-backend"

package/CLA.md

@@ -0,0 +1,60 @@
+# Contributor License Agreement (CLA)
+
+Thank you for your interest in contributing to postbase (the "Project"). 
+
+To clarify the intellectual property rights in contributions to the Project, we require all contributors to sign this Contributor License Agreement ("CLA").
+
+## Agreement
+
+By signing this CLA, you agree to the following terms:
+
+### 1. Definitions
+
+- **"You"** means the individual or legal entity making this agreement.
+- **"Contribution"** means any original work of authorship, including any modifications or additions to existing work, that you submit to the Project.
+- **"Submit"** means any form of communication sent to the Project, including but not limited to code, documentation, or other materials submitted via pull request, email, or issue tracker.
+
+### 2. Grant of Copyright License
+
+You hereby grant to Umair Ashraf and to recipients of software distributed by the Project a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevovable copyright license to reproduce, prepare derivative works of, publicly display, publicly perform, sublicense, and distribute your Contributions and such derivative works.
+
+### 3. Grant of Patent License
+
+You hereby grant to Umair Ashraf and to recipients of software distributed by the Project a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the work, where such license applies only to those patent claims licensable by you that are necessarily infringed by your Contribution(s) alone or by combination of your Contribution(s) with the work to which such Contribution(s) was submitted.
+
+### 4. Representations
+
+You represent that:
+
+- You are legally entitled to grant the above licenses.
+- Each of your Contributions is your original creation (or you have rights to submit it under this CLA).
+- Your Contribution submissions include complete details of any third-party license or other restriction of which you are aware.
+- If your employer has rights to intellectual property that you create, you represent that you have received permission to make the Contributions on behalf of that employer, or that your employer has waived such rights.
+
+### 5. Support
+
+You are not expected to provide support for your Contributions, except to the extent you desire to provide support. You may provide support for free, for a fee, or not at all.
+
+### 6. Disclaimer
+
+UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING, YOU PROVIDE YOUR CONTRIBUTIONS ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE.
+
+---
+
+## How to Sign
+
+Please add your name to the [CONTRIBUTORS.md](CONTRIBUTORS.md) file by submitting a pull request with the following information:
+
+    - [Your Full Name], [Email], [Date in YYYY-MM-DD format]
+        - GitHub: @yourusername
+        - Statement: "I agree to the CLA as outlined in CLA.md"
+
+By adding your name to CONTRIBUTORS.md, you certify that you have read and agree to the terms of this CLA.
+
+---
+
+**Note for Corporate Contributors**: If you are contributing on behalf of your employer, your employer must also agree to this CLA. Please have an authorized representative of your employer add the company name and their signature to CONTRIBUTORS.md.
+
+---
+
+**Questions?** Contact umair@ashraf.riamumail.com if you have questions about this CLA.

package/CONTRIBUTORS.md

@@ -0,0 +1,35 @@
+# Contributors
+
+This file lists all contributors who have signed the Contributor License Agreement (CLA) as outlined in [CLA.md](CLA.md).
+
+By adding your name below, you certify that you have read and agree to the terms of the CLA.
+
+---
+
+## Individual Contributors
+
+- [Your Name], [your.email@example.com], 2024-05-10
+  - GitHub: @yourusername
+  - Statement: "I agree to the CLA as outlined in CLA.md"
+
+<!-- Add your entry above this line in alphabetical order by last name -->
+
+---
+
+## Corporate Contributors
+
+Corporate contributors whose employees have contributed to this project:
+
+- **Company Name**, Authorized by: [Representative Name], [Date]
+  - Contact: [email@company.com]
+  - Statement: "On behalf of Company Name, I agree to the CLA as outlined in CLA.md for all contributions made by our employees"
+
+<!-- Add corporate entries above this line in alphabetical order by company name -->
+
+---
+
+## Notes
+
+- Date format: YYYY-MM-DD
+- Please keep entries in alphabetical order by last name (individuals) or company name (corporate)
+- For corporate contributors, all employee contributions fall under the corporate CLA