enlace 0.0.1-beta.20 → 0.0.1-beta.21

package/README.md

@@ -561,6 +561,26 @@ trigger({
 | Both | `['custom']` | `['extra']` | `['custom', 'extra']` |
 | Neither | - | - | `['posts']` (auto) |
 
+### Manual Tag Invalidation
+
+Use `invalidateTags` to manually trigger cache invalidation and refetch queries:
+
+```typescript
+import { invalidateTags } from "enlace/hook";
+
+// Invalidate all queries tagged with 'posts'
+invalidateTags(["posts"]);
+
+// Invalidate multiple tags
+invalidateTags(["posts", "users"]);
+```
+
+This is useful when you need to refresh data outside of the normal mutation flow, such as:
+
+- After receiving a WebSocket message
+- After a background sync
+- After external state changes
+
 ### Disable Auto-Revalidation
 
 ```typescript

package/dist/hook/index.d.mts

@@ -217,4 +217,22 @@ type NextEnlaceHook<TSchema, TDefaultError = unknown> = {
  */
 declare function enlaceHookNext<TSchema = unknown, TDefaultError = unknown>(baseUrl: string, defaultOptions?: EnlaceOptions, hookOptions?: NextHookOptions): NextEnlaceHook<TSchema, TDefaultError>;
 
-export { type AnyReactRequestOptions, type ApiClient, type EnlaceHook, type EnlaceHookOptions, HTTP_METHODS, type HookState, type NextEnlaceHook, type NextHookOptions, type PollingInterval, type PollingIntervalFn, type PollingIntervalValue, type QueryFn, type ReactRequestOptionsBase, type SelectorFn, type TrackedCall, type UseEnlaceQueryOptions, type UseEnlaceQueryResult, type UseEnlaceSelectorResult, enlaceHookNext, enlaceHookReact };
+/**
+ * Manually invalidate cache entries and trigger refetch for queries matching the specified tags.
+ *
+ * @param tags - Array of cache tags to invalidate
+ *
+ * @example
+ * ```ts
+ * import { invalidateTags } from 'enlace/hook';
+ *
+ * // Invalidate all queries tagged with 'posts'
+ * invalidateTags(['posts']);
+ *
+ * // Invalidate multiple tags
+ * invalidateTags(['posts', 'users']);
+ * ```
+ */
+declare function invalidateTags(tags: string[]): void;
+
+export { type AnyReactRequestOptions, type ApiClient, type EnlaceHook, type EnlaceHookOptions, HTTP_METHODS, type HookState, type NextEnlaceHook, type NextHookOptions, type PollingInterval, type PollingIntervalFn, type PollingIntervalValue, type QueryFn, type ReactRequestOptionsBase, type SelectorFn, type TrackedCall, type UseEnlaceQueryOptions, type UseEnlaceQueryResult, type UseEnlaceSelectorResult, enlaceHookNext, enlaceHookReact, invalidateTags };

package/dist/hook/index.d.ts

@@ -217,4 +217,22 @@ type NextEnlaceHook<TSchema, TDefaultError = unknown> = {
  */
 declare function enlaceHookNext<TSchema = unknown, TDefaultError = unknown>(baseUrl: string, defaultOptions?: EnlaceOptions, hookOptions?: NextHookOptions): NextEnlaceHook<TSchema, TDefaultError>;
 
-export { type AnyReactRequestOptions, type ApiClient, type EnlaceHook, type EnlaceHookOptions, HTTP_METHODS, type HookState, type NextEnlaceHook, type NextHookOptions, type PollingInterval, type PollingIntervalFn, type PollingIntervalValue, type QueryFn, type ReactRequestOptionsBase, type SelectorFn, type TrackedCall, type UseEnlaceQueryOptions, type UseEnlaceQueryResult, type UseEnlaceSelectorResult, enlaceHookNext, enlaceHookReact };
+/**
+ * Manually invalidate cache entries and trigger refetch for queries matching the specified tags.
+ *
+ * @param tags - Array of cache tags to invalidate
+ *
+ * @example
+ * ```ts
+ * import { invalidateTags } from 'enlace/hook';
+ *
+ * // Invalidate all queries tagged with 'posts'
+ * invalidateTags(['posts']);
+ *
+ * // Invalidate multiple tags
+ * invalidateTags(['posts', 'users']);
+ * ```
+ */
+declare function invalidateTags(tags: string[]): void;
+
+export { type AnyReactRequestOptions, type ApiClient, type EnlaceHook, type EnlaceHookOptions, HTTP_METHODS, type HookState, type NextEnlaceHook, type NextHookOptions, type PollingInterval, type PollingIntervalFn, type PollingIntervalValue, type QueryFn, type ReactRequestOptionsBase, type SelectorFn, type TrackedCall, type UseEnlaceQueryOptions, type UseEnlaceQueryResult, type UseEnlaceSelectorResult, enlaceHookNext, enlaceHookReact, invalidateTags };

package/dist/hook/index.js

@@ -24,7 +24,8 @@ var hook_exports = {};
 __export(hook_exports, {
   HTTP_METHODS: () => HTTP_METHODS,
   enlaceHookNext: () => enlaceHookNext,
-  enlaceHookReact: () => enlaceHookReact
+  enlaceHookReact: () => enlaceHookReact,
+  invalidateTags: () => invalidateTags
 });
 module.exports = __toCommonJS(hook_exports);
 

package/dist/hook/index.mjs

@@ -586,5 +586,6 @@ function enlaceHookNext(baseUrl, defaultOptions = {}, hookOptions = {}) {
 export {
   HTTP_METHODS,
   enlaceHookNext,
-  enlaceHookReact
+  enlaceHookReact,
+  invalidateTags
 };

package/dist/index.d.mts

@@ -97,6 +97,4 @@ type NextRequestOptionsBase = ReactRequestOptionsBase & {
 
 declare function enlaceNext<TSchema = unknown, TDefaultError = unknown>(baseUrl: string, defaultOptions?: EnlaceOptions | null, nextOptions?: NextOptions): unknown extends TSchema ? WildcardClient<NextRequestOptionsBase> : EnlaceClient<TSchema, TDefaultError, NextRequestOptionsBase>;
 
-declare function invalidateTags(tags: string[]): void;
-
-export { type NextOptions, type NextRequestOptionsBase, enlaceNext, invalidateTags };
+export { type NextOptions, type NextRequestOptionsBase, enlaceNext };

package/dist/index.d.ts

@@ -97,6 +97,4 @@ type NextRequestOptionsBase = ReactRequestOptionsBase & {
 
 declare function enlaceNext<TSchema = unknown, TDefaultError = unknown>(baseUrl: string, defaultOptions?: EnlaceOptions | null, nextOptions?: NextOptions): unknown extends TSchema ? WildcardClient<NextRequestOptionsBase> : EnlaceClient<TSchema, TDefaultError, NextRequestOptionsBase>;
 
-declare function invalidateTags(tags: string[]): void;
-
-export { type NextOptions, type NextRequestOptionsBase, enlaceNext, invalidateTags };
+export { type NextOptions, type NextRequestOptionsBase, enlaceNext };

package/dist/index.js

@@ -21,8 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
-  enlaceNext: () => enlaceNext,
-  invalidateTags: () => invalidateTags
+  enlaceNext: () => enlaceNext
 });
 module.exports = __toCommonJS(src_exports);
 __reExport(src_exports, require("enlace-core"), module.exports);
@@ -98,23 +97,3 @@ function enlaceNext(baseUrl, defaultOptions = {}, nextOptions = {}) {
     executeNextFetch
   );
 }
-
-// src/react/cache.ts
-var cache = /* @__PURE__ */ new Map();
-function clearCacheByTags(tags) {
-  cache.forEach((entry) => {
-    const hasMatch = entry.tags.some((tag) => tags.includes(tag));
-    if (hasMatch) {
-      entry.timestamp = 0;
-      delete entry.promise;
-      entry.subscribers.forEach((cb) => cb());
-    }
-  });
-}
-
-// src/react/revalidator.ts
-var listeners = /* @__PURE__ */ new Set();
-function invalidateTags(tags) {
-  clearCacheByTags(tags);
-  listeners.forEach((listener) => listener(tags));
-}

package/dist/index.mjs

@@ -76,27 +76,6 @@ function enlaceNext(baseUrl, defaultOptions = {}, nextOptions = {}) {
     executeNextFetch
   );
 }
-
-// src/react/cache.ts
-var cache = /* @__PURE__ */ new Map();
-function clearCacheByTags(tags) {
-  cache.forEach((entry) => {
-    const hasMatch = entry.tags.some((tag) => tags.includes(tag));
-    if (hasMatch) {
-      entry.timestamp = 0;
-      delete entry.promise;
-      entry.subscribers.forEach((cb) => cb());
-    }
-  });
-}
-
-// src/react/revalidator.ts
-var listeners = /* @__PURE__ */ new Set();
-function invalidateTags(tags) {
-  clearCacheByTags(tags);
-  listeners.forEach((listener) => listener(tags));
-}
 export {
-  enlaceNext,
-  invalidateTags
+  enlaceNext
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "enlace",
-  "version": "0.0.1-beta.20",
+  "version": "0.0.1-beta.21",
   "license": "MIT",
   "repository": {
     "type": "git",