stonyx 0.2.2 → 0.2.3-alpha.0

package/.github/workflows/ci.yml

@@ -26,7 +26,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v3
         with:
-          node-version: 22.18.0
+          node-version: 24.13.0
           cache: 'pnpm'
 
       - name: Install dependencies

package/.github/workflows/publish.yml

@@ -0,0 +1,143 @@
+name: Publish to NPM
+
+on:
+  # Manual trigger (kept for flexibility)
+  workflow_dispatch:
+    inputs:
+      version-type:
+        description: 'Version type'
+        required: true
+        type: choice
+        options:
+          - alpha
+          - patch
+          - minor
+          - major
+      custom-version:
+        description: 'Custom version (optional, overrides version-type)'
+        required: false
+        type: string
+
+  # Auto-publish alpha on PR
+  pull_request:
+    types: [opened, synchronize, reopened]
+    branches: [main, dev]
+
+  # Auto-publish stable on merge to main
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  id-token: write  # Required for npm provenance
+  pull-requests: write  # For PR comments
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+          # For PR events, check out the PR branch
+          ref: ${{ github.event_name == 'pull_request' && github.head_ref || github.ref }}
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: 24.13.0
+          cache: 'pnpm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run tests
+        run: pnpm test
+
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      # Determine version type based on trigger
+      - name: Determine version bump type
+        id: version-type
+        run: |
+          if [ "${{ github.event_name }}" = "pull_request" ]; then
+            echo "type=alpha" >> $GITHUB_OUTPUT
+          elif [ "${{ github.event_name }}" = "push" ]; then
+            echo "type=patch" >> $GITHUB_OUTPUT
+          elif [ "${{ github.event.inputs.custom-version }}" != "" ]; then
+            echo "type=custom" >> $GITHUB_OUTPUT
+          else
+            echo "type=${{ github.event.inputs.version-type }}" >> $GITHUB_OUTPUT
+          fi
+
+      # Version bumping
+      - name: Bump version (custom)
+        if: steps.version-type.outputs.type == 'custom'
+        run: pnpm version ${{ github.event.inputs.custom-version }} --no-git-tag-version
+
+      - name: Bump version (alpha)
+        if: steps.version-type.outputs.type == 'alpha'
+        run: pnpm version prerelease --preid=alpha --no-git-tag-version
+
+      - name: Bump version (patch/minor/major)
+        if: steps.version-type.outputs.type == 'patch' || steps.version-type.outputs.type == 'minor' || steps.version-type.outputs.type == 'major'
+        run: pnpm version ${{ steps.version-type.outputs.type }} --no-git-tag-version
+
+      - name: Get package version
+        id: package-version
+        run: echo "version=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT
+
+      # Publishing
+      - name: Publish to NPM (alpha)
+        if: contains(steps.package-version.outputs.version, 'alpha')
+        run: pnpm publish --tag alpha --access public --no-git-checks
+
+      - name: Publish to NPM (stable)
+        if: "!contains(steps.package-version.outputs.version, 'alpha')"
+        run: pnpm publish --access public
+
+      # Only commit and tag for stable releases (push to main or manual stable)
+      - name: Commit version bump and create tag
+        if: github.event_name == 'push' || (github.event_name == 'workflow_dispatch' && !contains(steps.package-version.outputs.version, 'alpha'))
+        run: |
+          git add package.json
+          git commit -m "chore: release v${{ steps.package-version.outputs.version }}"
+          git tag v${{ steps.package-version.outputs.version }}
+          git push origin main --tags
+
+      - name: Create GitHub Release
+        if: github.event_name == 'push' || (github.event_name == 'workflow_dispatch' && !contains(steps.package-version.outputs.version, 'alpha'))
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: v${{ steps.package-version.outputs.version }}
+          release_name: v${{ steps.package-version.outputs.version }}
+          draft: false
+          prerelease: false
+
+      # Add PR comment with alpha version info
+      - name: Comment on PR with alpha version
+        if: github.event_name == 'pull_request'
+        uses: actions/github-script@v6
+        with:
+          script: |
+            const version = '${{ steps.package-version.outputs.version }}';
+            const packageName = require('./package.json').name;
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: `## 🚀 Alpha Version Published\n\n**Version:** \`${version}\`\n\n**Install:**\n\`\`\`bash\npnpm add ${packageName}@${version}\n# or\npnpm add ${packageName}@alpha  # latest alpha\n\`\`\`\n\nThis alpha version is now available for testing!`
+            });

package/README.md

@@ -90,6 +90,33 @@ cron.register('exampleJob', async () => console.log('Job executed!'), 5, true);
 
 ---
 
+### **[@stonyx/events](https://github.com/abofs/stonyx-events)**
+
+Lightweight pub/sub event system for application-wide event handling.
+
+```js
+import Events from '@stonyx/events';
+
+const events = new Events();
+
+// Register available events
+events.setup(['userLogin', 'userLogout', 'dataChange']);
+
+// Subscribe to events
+events.subscribe('userLogin', (user) => {
+  console.log(`${user.name} logged in`);
+});
+
+// Emit events
+events.emit('userLogin', { name: 'Alice' });
+```
+
+* Singleton pattern for shared event bus
+* Async support with error isolation
+* Type-safe event registration
+
+---
+
 ### **[@stonyx/rest-server](https://github.com/abofs/stonyx-rest-server)**
 
 Dynamic REST server module with auto-route registration.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stonyx",
-  "version": "0.2.2",
+  "version": "0.2.3-alpha.0",
   "description": "Base stonyx framework module",
   "main": "main.js",
   "type": "module",
@@ -14,6 +14,9 @@
     "type": "git",
     "url": "git+https://github.com/abofs/stonyx.git"
   },
+  "publishConfig": {
+    "provenance": true
+  },
   "author": "Stone Costa",
   "license": "Apache-2.0",
   "contributors": [