@logosdx/hooks 1.0.0-beta.3 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,75 @@
 # @logosdx/hooks
 
+## 1.0.0
+
+### Major Changes
+
+- 2f9c85c: ## Breaking Changes
+
+  ### API verbs renamed
+
+  Methods renamed to distinguish from Observer (`on`/`emit`):
+
+  | Before                       | After                                  |
+  | ---------------------------- | -------------------------------------- |
+  | `engine.on(name, cb)`        | `engine.add(name, cb, options?)`       |
+  | `engine.once(name, cb)`      | `engine.add(name, cb, { once: true })` |
+  | `engine.emit(name, ...args)` | `engine.run(name, ...args)`            |
+
+  ### Callback signature changed
+
+  Callbacks now receive spread args with ctx as the last parameter instead of a context object:
+
+  **Before:**
+
+  ```ts
+  hooks.on("beforeRequest", async (ctx) => {
+    const [url, opts] = ctx.args;
+    ctx.setArgs([url, { ...opts, cache: "no-store" }]);
+  });
+  ```
+
+  **After:**
+
+  ```ts
+  hooks.add("beforeRequest", (url, opts, ctx) => {
+    ctx.args(url, { ...opts, cache: "no-store" });
+  });
+  ```
+
+  ### Context methods replaced
+
+  | Before                 | After                                                 |
+  | ---------------------- | ----------------------------------------------------- |
+  | `ctx.args` (property)  | `ctx.args(...)` (method — replaces args)              |
+  | `ctx.setArgs([...])`   | `ctx.args(...)` (spread, no array wrapper)            |
+  | `ctx.setResult(value)` | `return ctx.returns(value)`                           |
+  | `ctx.returnEarly()`    | `return ctx.args(...)` or `return ctx.returns(value)` |
+
+  ### Return type renamed
+
+  `EmitResult` → `RunResult`, `earlyReturn` → `returned`:
+
+  ```ts
+  // Before
+  const { args, result, earlyReturn } = await hooks.emit("hook", data);
+  // After
+  const { args, result, returned } = await hooks.run("hook", data);
+  ```
+
+  ## Added
+
+  - `feat(hooks):` Sync execution via `runSync()` and `wrapSync()` for non-async hook chains
+  - `feat(hooks):` Priority ordering — `add(name, cb, { priority: -10 })`, lower runs first
+  - `feat(hooks):` `times` option — run a callback N times then auto-remove
+  - `feat(hooks):` Per-request ephemeral hooks via `RunOptions.append`
+  - `feat(hooks):` `HookContext` is now a class (exported for `instanceof` checks)
+
+### Patch Changes
+
+- Updated dependencies [879cea2]
+  - @logosdx/utils@6.1.0
+
 ## 1.0.0-beta.3
 
 ### Major Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logosdx/hooks",
-  "version": "1.0.0-beta.3",
+  "version": "1.0.0",
   "description": "A lightweight, type-safe hook system for extending function behavior",
   "license": "BSD-3-Clause",
   "homepage": "https://logosdx.dev/",
@@ -38,6 +38,6 @@
   "unpkg": "./dist/browser/bundle.js",
   "jsdelivr": "./dist/browser/bundle.js",
   "dependencies": {
-    "@logosdx/utils": "^6.1.0-beta.1"
+    "@logosdx/utils": "^6.1.0"
   }
 }