@stonyx/cron 0.2.1-beta.0 → 0.2.1-beta.2

package/.claude/testing.md

@@ -0,0 +1,85 @@
+# Testing Guidelines
+
+## Testing Guidelines
+
+### Test Structure
+Tests are located in `stonyx-cron/test/unit/` and use QUnit modules:
+
+```javascript
+import QUnit from 'qunit';
+import sinon from 'sinon';
+import { setupIntegrationTests } from "stonyx/test-helpers";
+
+const { module, test } = QUnit;
+
+module('[Unit] Cron', function (hooks) {
+  setupIntegrationTests(hooks);
+
+  let cron, clock;
+
+  hooks.beforeEach(function () {
+    clock = sinon.useFakeTimers({ shouldAdvanceTime: false });
+    cron = new Cron();
+  });
+
+  hooks.afterEach(function () {
+    sinon.restore();
+  });
+
+  test('test description', async function (assert) {
+    // Test implementation
+  });
+});
+```
+
+### Fake Timers Pattern (CRITICAL)
+**Always use fake timers for time-based tests:**
+
+```javascript
+// Setup in beforeEach
+clock = sinon.useFakeTimers({ shouldAdvanceTime: false });
+
+// Advance time synchronously
+clock.tick(5000);  // Advance 5 seconds
+
+// For async operations, use tickAsync
+clock.tick(5000);
+await clock.tickAsync(0);  // Process async callbacks
+
+// Cleanup in afterEach
+sinon.restore();
+```
+
+**Why `shouldAdvanceTime: false`?**
+Prevents real time from interfering with fake time, ensuring deterministic tests.
+
+### Spies & Stubs Patterns
+```javascript
+// Spy on function calls
+const cb = sinon.spy();
+cron.register('job1', cb, 5);
+assert.ok(cb.calledOnce, 'Callback executed once');
+
+// Stub methods
+const stub = sinon.stub().rejects(new Error('boom'));
+cron.register('jobErr', stub, 1);
+
+// Spy on existing methods
+const logSpy = sinon.spy(log, 'cron');
+cron.log('test message');
+assert.ok(logSpy.calledOnce, 'Log called');
+```
+
+### Test Coverage Expectations
+Tests should cover:
+- Job registration and execution
+- Rescheduling behavior
+- Unregistration
+- Error handling
+- Configuration-driven logging
+- Edge cases (empty heap, multiple jobs, etc.)
+
+### Running Tests
+```bash
+pnpm test  # Runs: stonyx test
+```

package/.git/config

@@ -9,7 +9,7 @@
 [gc]
 	auto = 0
 [http "https://github.com/"]
-	extraheader = AUTHORIZATION: basic eC1hY2Nlc3MtdG9rZW46Z2hzX3ZlU0VYM1FDZkhtbWl4bU1kRDlBRVRBTjBDUW5HQzBPVUxScg==
+	extraheader = AUTHORIZATION: basic eC1hY2Nlc3MtdG9rZW46Z2hwX2hBdU5WbnJNcml2bktkZTlmaU80WW9lZk9QenZtdTFiUWtQNA==
 [branch "main"]
 	remote = origin
 	merge = refs/heads/main

package/.github/workflows/publish.yml

@@ -1,6 +1,8 @@
 name: Publish to NPM
 
 on:
+  repository_dispatch:
+    types: [cascade-publish]
   workflow_dispatch:
     inputs:
       version-type:
@@ -17,10 +19,14 @@ on:
         type: string
   pull_request:
     types: [opened, synchronize, reopened]
-    branches: [main, dev]
+    branches: [main]
   push:
     branches: [main]
 
+concurrency:
+  group: ${{ github.event_name == 'repository_dispatch' && 'cascade-update' || format('publish-{0}', github.ref) }}
+  cancel-in-progress: false
+
 permissions:
   contents: write
   id-token: write
@@ -28,8 +34,18 @@ permissions:
 
 jobs:
   publish:
+    if: "!contains(github.event.head_commit.message, '[skip ci]')"
     uses: abofs/stonyx-workflows/.github/workflows/npm-publish.yml@main
     with:
       version-type: ${{ github.event.inputs.version-type }}
       custom-version: ${{ github.event.inputs.custom-version }}
+      cascade-source: ${{ github.event.client_payload.source_package || '' }}
+    secrets: inherit
+
+  cascade:
+    needs: publish
+    uses: abofs/stonyx-workflows/.github/workflows/cascade.yml@main
+    with:
+      package-name: ${{ needs.publish.outputs.package-name }}
+      published-version: ${{ needs.publish.outputs.published-version }}
     secrets: inherit

package/README.md

@@ -31,7 +31,7 @@ When a job is executed, its next trigger time is updated, and it is re-inserted
 |  `register`  | `key: string, callback: Function, interval: number, runOnInit?: boolean` | Register a new job with a given interval in seconds. If `runOnInit` is true, the job runs immediately upon registration. |
 | `unregister` |                               `key: string`                              | Remove a previously registered job.                                                                                      |
 
-> All other methods and classes (like `MinHeap`) are used internally and are not intended for direct use.
+> `MinHeap` is also exported as a public subpath (`@stonyx/cron/min-heap`) and can be imported directly for advanced usage.
 
 ## Configuration
 

package/package.json

@@ -3,8 +3,8 @@
   "keywords": [
     "stonyx-module"
   ],
-  "version": "0.2.1-beta.0",
-  "description": "",
+  "version": "0.2.1-beta.2",
+  "description": "Cron/job scheduler for Stonyx framework",
   "main": "src/main.js",
   "type": "module",
   "files": [
@@ -32,14 +32,14 @@
   },
   "homepage": "https://github.com/abofs/stonyx-cron#readme",
   "devDependencies": {
-    "@stonyx/utils": "^0.2.2",
+    "@stonyx/utils": "0.2.3-beta.3",
     "qunit": "^2.24.1",
     "sinon": "^21.0.0"
   },
   "dependencies": {
-    "stonyx": "^0.2.2"
+    "stonyx": "0.2.3-beta.1"
   },
   "scripts": {
-    "test": "qunit --require ./stonyx-bootstrap.cjs"
+    "test": "stonyx test"
   }
 }

package/pnpm-lock.yaml

@@ -9,12 +9,12 @@ importers:
   .:
     dependencies:
       stonyx:
-        specifier: ^0.2.2
-        version: 0.2.2
+        specifier: 0.2.3-beta.1
+        version: 0.2.3-beta.1
     devDependencies:
       '@stonyx/utils':
-        specifier: ^0.2.2
-        version: 0.2.2
+        specifier: 0.2.3-beta.3
+        version: 0.2.3-beta.3
       qunit:
         specifier: ^2.24.1
         version: 2.25.0
@@ -33,8 +33,8 @@ packages:
   '@sinonjs/samsam@8.0.3':
     resolution: {integrity: sha512-hw6HbX+GyVZzmaYNh82Ecj1vdGZrqVIn/keDTg63IgAwiQPO+xCz99uG6Woqgb4tM0mUiFENKZ4cqd7IX94AXQ==}
 
-  '@stonyx/utils@0.2.2':
-    resolution: {integrity: sha512-z/pDbX3QPeVJ3kFpU1rQURj3+BLwvGkLHVJiSckmjaBZ/vQIZzaerkf6BTZnHbSmQuUwO0lFzJRwlKOTIaXp0g==}
+  '@stonyx/utils@0.2.3-beta.3':
+    resolution: {integrity: sha512-CLmz/DPgNWU7IXJYQXzmAdph65iapp6mHnvKZQULrd6IdKPGb6KlVMVL29yuyXg0fOapkkoPV4Xf6PmksSE8bw==}
 
   call-bind-apply-helpers@1.0.2:
     resolution: {integrity: sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==}
@@ -164,8 +164,9 @@ packages:
   sinon@21.0.1:
     resolution: {integrity: sha512-Z0NVCW45W8Mg5oC/27/+fCqIHFnW8kpkFOq0j9XJIev4Ld0mKmERaZv5DMLAb9fGCevjKwaEeIQz5+MBXfZcDw==}
 
-  stonyx@0.2.2:
-    resolution: {integrity: sha512-X37/2R2YklI+CX4wKHckPg2pFmOL1hk0CwOMvn7E00sE+8JjhmbHvAeTI+0t50kufBsXKREPX3FBHVUd4Yi4Fw==}
+  stonyx@0.2.3-beta.1:
+    resolution: {integrity: sha512-WdMFVHASjPAdZFMVrZ8rHj/7A0onfVUigLLiNrlYHKZFtnxXV9KibQgXlEFEzY6M9z5o0I/bycOqaBWZvjcCfw==}
+    hasBin: true
 
   supports-color@7.2.0:
     resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==}
@@ -204,7 +205,7 @@ snapshots:
       '@sinonjs/commons': 3.0.1
       type-detect: 4.1.0
 
-  '@stonyx/utils@0.2.2': {}
+  '@stonyx/utils@0.2.3-beta.3': {}
 
   call-bind-apply-helpers@1.0.2:
     dependencies:
@@ -342,7 +343,7 @@ snapshots:
       diff: 8.0.3
       supports-color: 7.2.0
 
-  stonyx@0.2.2:
+  stonyx@0.2.3-beta.1:
     dependencies:
       node-chronicle: 0.2.0
 

package/stonyx-bootstrap.cjs

@@ -1,9 +0,0 @@
-/**
- * commonJS Bootstrap loading - Stonyx must be loaded first, prior to the rest of the application
- */
-const { default:Stonyx } = require('stonyx');
-const { default:config } = require('./config/environment.js');
-
-new Stonyx(config, __dirname);
-
-module.exports = Stonyx;