katanakit-js 2.2.1 → 2.12.9

package/dist/adapters/nuxt/nuxt.service.js

@@ -1,7 +1,24 @@
+import { createRequire } from "node:module";
+let cachedCreateError;
+function tryLoadH3CreateError() {
+    if (cachedCreateError !== undefined)
+        return cachedCreateError;
+    try {
+        const require = createRequire(import.meta.url);
+        const h3 = require("h3");
+        cachedCreateError = typeof h3.createError === "function" ? h3.createError : null;
+    }
+    catch {
+        cachedCreateError = null;
+    }
+    return cachedCreateError;
+}
 /**
  * Unwraps a KatanaKit Safe Result, throwing an H3-compatible error on failure.
  * Returns the data directly on success.
  *
+ * Prefers `h3.createError` when available so Nuxt/H3 status codes work correctly.
+ *
  * @param result - The Safe Result from `useFetch`, `useGet`, `usePost`, etc.
  * @param context - Optional context prefix for the error message.
  * @returns The data from the result.
@@ -10,12 +27,12 @@
  * @example
  * ```ts
  * // server/api/pokemon/[id].ts
- * import { useGet } from "katanakit-js";
+ * import { useGetApi } from "katanakit-js";
  * import { useUnwrap } from "katanakit-js/adapters/nuxt";
  *
  * export default defineEventHandler(async (event) => {
  *   const id = getRouterParam(event, "id");
- *   const result = await useGet("pokeapi", "pokemonById", { params: { id } });
+ *   const result = await useGetApi("pokeapi", "pokemonById", { params: { id } });
  *   return useUnwrap(result, `Pokemon ${id}`);
  * });
  * ```
@@ -26,8 +43,6 @@ export function useUnwrap(result, context) {
     }
     const message = context ? `${context}: ${result.error.message}` : result.error.message;
     const statusCode = result.error.status || 500;
-    // Dynamic import to avoid hard dependency on h3.
-    // Consumers must have h3 installed (it comes with Nuxt).
     throw createH3Error(statusCode, message);
 }
 /**
@@ -41,11 +56,11 @@ export function useUnwrap(result, context) {
  * @example
  * ```ts
  * // server/api/users.ts
- * import { useGet } from "katanakit-js";
+ * import { useGetApi } from "katanakit-js";
  * import { useSafeResponse } from "katanakit-js/adapters/nuxt";
  *
  * export default defineEventHandler(async () => {
- *   const result = await useGet("api", "users");
+ *   const result = await useGetApi("api", "users");
  *   return useSafeResponse(result);
  * });
  * ```
@@ -74,11 +89,11 @@ export function useSafeResponse(result) {
  * @example
  * ```ts
  * // server/api/products.ts
- * import { useFetch } from "katanakit-js";
+ * import { useFetchApi } from "katanakit-js";
  * import { useEventResponse } from "katanakit-js/adapters/nuxt";
  *
  * export default defineEventHandler(async (event) => {
- *   const result = await useFetch("shop", "products");
+ *   const result = await useFetchApi("shop", "products");
  *   return useEventResponse(event, result);
  * });
  * ```
@@ -94,11 +109,20 @@ export function useEventResponse(event, result) {
         status: result.error.status,
     };
 }
-// Internal helper: creates an error that looks like an H3 error.
-// We don't import h3 directly to avoid a hard peer dependency.
+/**
+ * Creates an error that H3/Nuxt recognize (statusCode / statusMessage).
+ * Uses `h3.createError` when the peer is installed; otherwise brands a plain Error.
+ */
 function createH3Error(statusCode, message) {
+    const createError = tryLoadH3CreateError();
+    if (createError) {
+        return createError({ statusCode, statusMessage: message, message });
+    }
     const error = new Error(message);
     error.statusCode = statusCode;
+    error.status = statusCode;
+    error.statusMessage = message;
+    error.name = "H3Error";
     return error;
 }
 //# sourceMappingURL=nuxt.service.js.map

package/dist/adapters/nuxt/nuxt.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"nuxt.service.js","sourceRoot":"","sources":["../../../src/adapters/nuxt/nuxt.service.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,SAAS,CAAI,MAAsB,EAAE,OAAgB;IACpE,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,MAAM,CAAC,IAAI,CAAC;IACpB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;IAEvF,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC;IAE9C,iDAAiD;IACjD,yDAAyD;IACzD,MAAM,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,eAAe,CAAI,MAAsB;IAKxD,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACrD,CAAC;IAED,OAAO;QACN,IAAI,EAAE,IAAI;QACV,KAAK,EAAE;YACN,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;YAC7B,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;SAC3B;QACD,EAAE,EAAE,KAAK;KACT,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB,CAC/B,KAAgD,EAChD,MAAsB;IAEtB,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;QAChC,OAAO,MAAM,CAAC,IAAI,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC;IACvD,OAAO;QACN,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;QAC3B,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;KAC3B,CAAC;AACH,CAAC;AAED,iEAAiE;AACjE,+DAA+D;AAC/D,SAAS,aAAa,CAAC,UAAkB,EAAE,OAAe;IACzD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAmC,CAAC;IACnE,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC;IAC9B,OAAO,KAAK,CAAC;AACd,CAAC"}
+{"version":3,"file":"nuxt.service.js","sourceRoot":"","sources":["../../../src/adapters/nuxt/nuxt.service.ts"],"names":[],"mappings":"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"}

package/dist/adapters/vue/vue.service.d.ts

@@ -14,14 +14,17 @@ export interface KatanaFetchState<T> {
     refetch: () => Promise<void>;
 }
 /**
- * Vue 3 composable that wraps KatanaKit's `useGet` with the reactivity system.
+ * Vue 3 composable that wraps KatanaKit's HTTP GET with the reactivity system.
  * It bridges the Safe Result pattern to idiomatic Vue state (`data`, `error`,
  * `loading`) and never throws on HTTP errors.
  *
+ * Stale responses are ignored via a request version counter and AbortController.
+ * In-flight requests are aborted on unmount when `onUnmounted` is available.
+ *
  * When `options` is a Vue `Ref`, the request re-runs automatically whenever the
  * ref changes (deep watch), so URL params or query params can drive refetching.
  *
- * @param apiName - Name of the registered API (see `useInit`).
+ * @param apiName - Name of the registered API (see `useInitApis`).
  * @param endpointName - Name of the endpoint inside that API.
  * @param options - Optional `UrlOptions` (path/query params), plain or reactive.
  * @returns Reactive `{ data, error, loading, refetch }`.

package/dist/adapters/vue/vue.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vue.service.d.ts","sourceRoot":"","sources":["../../../src/adapters/vue/vue.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,QAAQ,EAAE,KAAK,GAAG,EAAiC,MAAM,KAAK,CAAC;AAGpF,OAAO,KAAK,EAAE,QAAQ,EAAe,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IAClC,sDAAsD;IACtD,IAAI,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACpB,0DAA0D;IAC1D,KAAK,EAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC5B,sCAAsC;IACtC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACtB,oCAAoC;IACpC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC/B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,GAC5B,gBAAgB,CAAC,CAAC,CAAC,CA6BrB"}
+{"version":3,"file":"vue.service.d.ts","sourceRoot":"","sources":["../../../src/adapters/vue/vue.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,QAAQ,EAAe,KAAK,GAAG,EAAiC,MAAM,KAAK,CAAC;AAGjG,OAAO,KAAK,EAAE,QAAQ,EAAe,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IAClC,sDAAsD;IACtD,IAAI,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACpB,0DAA0D;IAC1D,KAAK,EAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC5B,sCAAsC;IACtC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACtB,oCAAoC;IACpC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC/B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,GAC5B,gBAAgB,CAAC,CAAC,CAAC,CAmErB"}

package/dist/adapters/vue/vue.service.js

@@ -1,14 +1,17 @@
-import { isRef, ref, shallowRef, unref, watch } from "vue";
-import { useGet } from "../../core/services/http.service.js";
+import { isRef, onUnmounted, ref, shallowRef, unref, watch } from "vue";
+import { useFetch } from "../../core/services/http.service.js";
 /**
- * Vue 3 composable that wraps KatanaKit's `useGet` with the reactivity system.
+ * Vue 3 composable that wraps KatanaKit's HTTP GET with the reactivity system.
  * It bridges the Safe Result pattern to idiomatic Vue state (`data`, `error`,
  * `loading`) and never throws on HTTP errors.
  *
+ * Stale responses are ignored via a request version counter and AbortController.
+ * In-flight requests are aborted on unmount when `onUnmounted` is available.
+ *
  * When `options` is a Vue `Ref`, the request re-runs automatically whenever the
  * ref changes (deep watch), so URL params or query params can drive refetching.
  *
- * @param apiName - Name of the registered API (see `useInit`).
+ * @param apiName - Name of the registered API (see `useInitApis`).
  * @param endpointName - Name of the endpoint inside that API.
  * @param options - Optional `UrlOptions` (path/query params), plain or reactive.
  * @returns Reactive `{ data, error, loading, refetch }`.
@@ -28,21 +31,52 @@ export function useKatanaFetch(apiName, endpointName, options) {
     const data = shallowRef(null);
     const error = ref(null);
     const loading = ref(true);
+    let requestVersion = 0;
+    let activeController = null;
+    let disposed = false;
     const refetch = async () => {
+        const version = ++requestVersion;
+        activeController?.abort();
+        const controller = new AbortController();
+        activeController = controller;
         loading.value = true;
         error.value = null;
-        const result = await useGet(apiName, endpointName, unref(options));
+        const result = await useFetch(apiName, endpointName, {
+            method: "GET",
+            urlOptions: unref(options),
+            signal: controller.signal,
+        });
+        if (disposed || version !== requestVersion) {
+            return;
+        }
         if (result.ok) {
             data.value = result.data;
+            error.value = null;
         }
         else {
-            error.value = result.error;
+            // Ignore abort errors from superseded / unmounted requests.
+            const aborted = controller.signal.aborted || /abort/i.test(result.error.message);
+            if (!aborted) {
+                error.value = result.error;
+            }
         }
         loading.value = false;
     };
     // Refetch automatically when a reactive options ref changes.
     if (isRef(options)) {
-        watch(options, refetch, { deep: true });
+        watch(options, () => {
+            void refetch();
+        }, { deep: true });
+    }
+    // Dispose on unmount when running inside a component setup.
+    try {
+        onUnmounted(() => {
+            disposed = true;
+            activeController?.abort();
+        });
+    }
+    catch {
+        // Outside of a component setup context — skip lifecycle hook.
     }
     // Initial fetch on setup.
     void refetch();

package/dist/adapters/vue/vue.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"vue.service.js","sourceRoot":"","sources":["../../../src/adapters/vue/vue.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAA2B,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC;AAEpF,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AAiB7D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,cAAc,CAC7B,OAAe,EACf,YAAoB,EACpB,OAA8B;IAE9B,MAAM,IAAI,GAAG,UAAU,CAAW,IAAI,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,GAAG,CAAkB,IAAI,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;IAE1B,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACzC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;QACrB,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;QAEnB,MAAM,MAAM,GAAmB,MAAM,MAAM,CAAI,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAEtF,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;QAC1B,CAAC;aAAM,CAAC;YACP,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC5B,CAAC;QAED,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC,CAAC;IAEF,6DAA6D;IAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACpB,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,0BAA0B;IAC1B,KAAK,OAAO,EAAE,CAAC;IAEf,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"vue.service.js","sourceRoot":"","sources":["../../../src/adapters/vue/vue.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAiB,WAAW,EAAY,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC;AAEjG,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAiB/D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,cAAc,CAC7B,OAAe,EACf,YAAoB,EACpB,OAA8B;IAE9B,MAAM,IAAI,GAAG,UAAU,CAAW,IAAI,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,GAAG,CAAkB,IAAI,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;IAE1B,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,gBAAgB,GAA2B,IAAI,CAAC;IACpD,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACzC,MAAM,OAAO,GAAG,EAAE,cAAc,CAAC;QACjC,gBAAgB,EAAE,KAAK,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,gBAAgB,GAAG,UAAU,CAAC;QAE9B,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;QACrB,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;QAEnB,MAAM,MAAM,GAAmB,MAAM,QAAQ,CAAI,OAAO,EAAE,YAAY,EAAE;YACvE,MAAM,EAAE,KAAK;YACb,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC;YAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;SACzB,CAAC,CAAC;QAEH,IAAI,QAAQ,IAAI,OAAO,KAAK,cAAc,EAAE,CAAC;YAC5C,OAAO;QACR,CAAC;QAED,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;YACzB,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;aAAM,CAAC;YACP,4DAA4D;YAC5D,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjF,IAAI,CAAC,OAAO,EAAE,CAAC;gBACd,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YAC5B,CAAC;QACF,CAAC;QAED,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC,CAAC;IAEF,6DAA6D;IAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACpB,KAAK,CACJ,OAAO,EACP,GAAG,EAAE;YACJ,KAAK,OAAO,EAAE,CAAC;QAChB,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACd,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,IAAI,CAAC;QACJ,WAAW,CAAC,GAAG,EAAE;YAChB,QAAQ,GAAG,IAAI,CAAC;YAChB,gBAAgB,EAAE,KAAK,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACR,8DAA8D;IAC/D,CAAC;IAED,0BAA0B;IAC1B,KAAK,OAAO,EAAE,CAAC;IAEf,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC"}

package/dist/config/index.d.ts

@@ -1,3 +1,4 @@
-export { type SeoMeta, useGenerateMetaTags, useHeadTags, useRssHeadLink, useTitle, } from "./seo.service.js";
+export type { SeoArrayable, SeoBooleanable, SeoMeta, SeoMetaArticle, SeoMetaFlat, SeoMetaInput, SeoOgImageObject, SeoRobotsObject, SeoTagNode, SeoTagResult, SeoTagsResult, UseSeoMetaBase, UseSeoMetaOptions, } from "./seo.service.js";
+export { useApplySeoTag, useGenerateMetaTags, useHeadTags, useRssHeadLink, useSeoMeta, useSeoTag, useSeoTags, useTitle, } from "./seo.service.js";
 export { type SiteConfig, siteConfig } from "./site.config.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,OAAO,EACZ,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,QAAQ,GACR,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,YAAY,EACZ,cAAc,EACd,OAAO,EACP,cAAc,EACd,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,iBAAiB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,UAAU,EACV,SAAS,EACT,UAAU,EACV,QAAQ,GACR,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/config/index.js

@@ -1,3 +1,3 @@
-export { useGenerateMetaTags, useHeadTags, useRssHeadLink, useTitle, } from "./seo.service.js";
+export { useApplySeoTag, useGenerateMetaTags, useHeadTags, useRssHeadLink, useSeoMeta, useSeoTag, useSeoTags, useTitle, } from "./seo.service.js";
 export { siteConfig } from "./site.config.js";
 //# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,QAAQ,GACR,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAmB,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAeA,OAAO,EACN,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,UAAU,EACV,SAAS,EACT,UAAU,EACV,QAAQ,GACR,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAmB,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/config/seo-meta.types.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Slim SEO types: typical HTML meta + Open Graph (Facebook) only.
+ * CamelCase keys map to `<title>` / `<meta>` / `<link rel="canonical">`.
+ *
+ * Naming cheat-sheet for {@link UseSeoMetaOptions}:
+ * - `site` = base URL (`https://example.com`)
+ * - `siteTitle` = brand / site name (`"My Site"`)
+ * - `title` = **page** document title (`"Blog Post"` → often `"Blog Post | My Site"`)
+ */
+export type SeoBooleanable = boolean | "true" | "false" | "" | 0 | 1;
+export type SeoArrayable<T> = T | readonly T[];
+/** Open Graph image (string URL or object). */
+export interface SeoOgImageObject {
+    url?: string;
+    secureUrl?: string;
+    type?: "image/jpeg" | "image/gif" | "image/png" | "image/webp" | "image/avif" | string;
+    width?: string | number;
+    height?: string | number;
+    alt?: string;
+}
+/** Robots as string or simple object. */
+export interface SeoRobotsObject {
+    index?: SeoBooleanable;
+    follow?: SeoBooleanable;
+    noindex?: SeoBooleanable;
+    nofollow?: SeoBooleanable;
+    none?: SeoBooleanable;
+    noarchive?: SeoBooleanable;
+    nosnippet?: SeoBooleanable;
+}
+/** Article Open Graph extensions (`og:type=article`). */
+export interface SeoMetaArticle {
+    articleAuthor?: readonly string[];
+    articleModifiedTime?: string;
+    articlePublishedTime?: string;
+    articleSection?: string;
+    articleTag?: readonly string[];
+}
+/**
+ * Flat meta: HTML head essentials + Facebook Open Graph.
+ */
+export interface SeoMetaFlat extends SeoMetaArticle {
+    /**
+     * Page document title → `<title>`.
+     * Not the site brand (`siteTitle`). When both differ, the helper usually
+     * renders `"Page | Brand"`.
+     */
+    title?: string;
+    /**
+     * Page summary → `<meta name="description">`.
+     * Prefer this for the page; use `ogDescription` only to override the share preview.
+     */
+    description?: string;
+    /** Meta keywords (legacy; optional). */
+    keywords?: string;
+    /** Meta author. */
+    author?: string;
+    /**
+     * Explicit canonical URL → `<link rel="canonical">`.
+     * Prefer this over `url` when you know the preferred address.
+     */
+    canonical?: string;
+    /**
+     * Absolute page URL. Fallback for canonical / `og:url` when those are omitted
+     * (resolution order: `ogUrl` → `canonical` → `url` → `site`).
+     */
+    url?: string;
+    charset?: "utf-8" | string;
+    viewport?: string | Record<string, string | number | undefined>;
+    robots?: "noindex, nofollow" | "index, follow" | string | SeoRobotsObject;
+    /**
+     * Open Graph page URL (`og:url`).
+     * Falls back to `canonical` → `url` → `site`.
+     */
+    ogUrl?: string;
+    /**
+     * Open Graph title (`og:title`). Defaults to the resolved page `title` when omitted.
+     */
+    ogTitle?: string;
+    /**
+     * Open Graph description (`og:description`). Defaults to `description` when omitted.
+     */
+    ogDescription?: string;
+    ogType?: "website" | "article" | "profile" | string;
+    ogLocale?: string;
+    /**
+     * Open Graph site name (`og:site_name`). Defaults to `siteTitle` when omitted.
+     */
+    ogSiteName?: string;
+    ogImage?: string | SeoArrayable<SeoOgImageObject>;
+    ogImageUrl?: string;
+    ogImageSecureUrl?: string;
+    ogImageType?: string;
+    ogImageWidth?: string | number;
+    ogImageHeight?: string | number;
+    ogImageAlt?: string;
+}
+/** Flat meta input (all keys optional / nullable). */
+export type SeoMetaInput = {
+    [K in keyof SeoMetaFlat]?: SeoMetaFlat[K] | null;
+};
+/** Site + HTML + OG fields in one object (before Omit). */
+export type UseSeoMetaBase = SeoMetaInput & {
+    /**
+     * Site origin / base URL (no trailing slash), e.g. `"https://example.com"`.
+     * Not a title — used for canonical, OG, RSS, and JSON-LD defaults.
+     */
+    site?: string;
+    /**
+     * Site brand / product name (e.g. `"KatanaKit"`).
+     * Distinct from page {@link SeoMetaFlat.title}.
+     * Used as `<title>` suffix (`"Page | Brand"`), `og:site_name`, and RSS feed name.
+     */
+    siteTitle?: string;
+    /** Language code (e.g. `"en"`, `"es-ES"`). */
+    lang?: string;
+    rss?: Partial<{
+        enabled: boolean;
+        path: string;
+        title?: string;
+        description?: string;
+        limit: number;
+    }>;
+    seo?: Partial<{
+        noindex: boolean;
+        canonical: boolean;
+        openGraph: boolean;
+        jsonLd: boolean;
+    }>;
+    nav?: Array<{
+        label: string;
+        href: string;
+        external?: boolean;
+    }>;
+};
+/**
+ * Public options for {@link useSeoMeta}.
+ * Only HTML + Open Graph (+ site fields). Omit keys you do not want in the type.
+ *
+ * @example
+ * ```ts
+ * // site = URL, siteTitle = brand, title = this page
+ * useSeoMeta({
+ *   site: "https://katanakit.dev",
+ *   siteTitle: "KatanaKit",
+ *   title: "Getting started", // → <title>Getting started | KatanaKit</title>
+ *   description: "…",
+ *   ogImage: "/og.png",
+ * } satisfies UseSeoMetaOptions);
+ *
+ * useSeoMeta({ title: "Home" } as UseSeoMetaOptions<"rss" | "nav">);
+ * ```
+ */
+export type UseSeoMetaOptions<OmitKeys extends keyof UseSeoMetaBase = never> = Omit<UseSeoMetaBase, OmitKeys>;
+/**
+ * Legacy page meta. Prefer {@link UseSeoMetaOptions}.
+ * @deprecated
+ */
+export interface SeoMeta {
+    title: string;
+    description?: string;
+    canonical?: string;
+    url?: string;
+    ogImage?: string;
+    ogType?: "website" | "article" | "profile";
+    publishedTime?: string;
+    modifiedTime?: string;
+    author?: string;
+    tags?: string[];
+    noindex?: boolean;
+}
+export interface SeoTagNode {
+    tag: "title" | "meta" | "link" | "script";
+    attrs?: Record<string, string>;
+    text?: string;
+}
+//# sourceMappingURL=seo-meta.types.d.ts.map

package/dist/config/seo-meta.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-meta.types.d.ts","sourceRoot":"","sources":["../../src/config/seo-meta.types.ts"],"names":[],"mappings":"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"}

package/dist/config/seo-meta.types.js

@@ -0,0 +1,11 @@
+/**
+ * Slim SEO types: typical HTML meta + Open Graph (Facebook) only.
+ * CamelCase keys map to `<title>` / `<meta>` / `<link rel="canonical">`.
+ *
+ * Naming cheat-sheet for {@link UseSeoMetaOptions}:
+ * - `site` = base URL (`https://example.com`)
+ * - `siteTitle` = brand / site name (`"My Site"`)
+ * - `title` = **page** document title (`"Blog Post"` → often `"Blog Post | My Site"`)
+ */
+export {};
+//# sourceMappingURL=seo-meta.types.js.map

package/dist/config/seo-meta.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-meta.types.js","sourceRoot":"","sources":["../../src/config/seo-meta.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/config/seo.service.d.ts

@@ -1,72 +1,55 @@
-import type { SiteConfig } from "./site.config.js";
+import type { SeoMeta, SeoMetaInput, SeoTagNode, UseSeoMetaBase, UseSeoMetaOptions } from "./seo-meta.types.js";
+import { type SiteConfig } from "./site.config.js";
+export type { SeoArrayable, SeoBooleanable, SeoMeta, SeoMetaArticle, SeoMetaFlat, SeoMetaInput, SeoOgImageObject, SeoRobotsObject, SeoTagNode, UseSeoMetaBase, UseSeoMetaOptions, } from "./seo-meta.types.js";
 /**
- * SEO meta tag configuration for a single page.
+ * Result of {@link useSeoMeta}: `html` / `tags` for the head, plus **one**
+ * flat object of resolved fields (site + HTML + OG). No duplicate
+ * `title` / `meta.title` / `config.title`.
+ *
+ * - `title` = document title (page)
+ * - `siteTitle` = brand / site name
+ * - `html` / `tags` = what you inject into `<head>`
  */
-export interface SeoMeta {
-    /** Page title (will be suffixed with site title). */
-    title: string;
-    /** Page description (falls back to site description). */
-    description?: string;
-    /** Canonical URL (absolute). If omitted, derived from `url`. */
-    canonical?: string;
-    /** Page URL (absolute, e.g. "https://example.com/blog/post/"). */
-    url?: string;
-    /** OG image URL (absolute). Falls back to site config. */
-    ogImage?: string;
-    /** Content type: "website" | "article" | "profile" (default: "website"). */
-    ogType?: "website" | "article" | "profile";
-    /** Article published date (ISO string, for og:type=article). */
-    publishedTime?: string;
-    /** Article modified date (ISO string, for og:type=article). */
-    modifiedTime?: string;
-    /** Article author (for og:type=article). */
-    author?: string;
-    /** Article tags (for og:type=article). */
-    tags?: string[];
-    /** Whether to add noindex (default: false). */
-    noindex?: boolean;
-}
+export type SeoTagResult = UseSeoMetaOptions & {
+    html: string;
+    tags: SeoTagNode[];
+    jsonLd?: Record<string, unknown>;
+};
+/** @deprecated Use {@link SeoTagResult}. */
+export type SeoTagsResult = SeoTagResult;
 /**
- * Generates all `<head>` meta tags for SEO, Open Graph, Twitter Card,
- * canonical URL, and JSON-LD structured data.
- *
- * @param config - Site-wide configuration.
- * @param meta - Page-specific meta.
- * @returns HTML string of meta tags to inject in `<head>`.
+ * SEO helper: one flat object in → one flat object out (+ html/tags).
  *
  * @example
- * ```astro
- * ---
- * import { siteConfig } from "@/config/site.config";
- * import { useGenerateMetaTags } from "@/config/seo.service";
- *
- * const metaTags = useGenerateMetaTags(siteConfig, {
- *   title: "My Blog Post",
- *   description: "A great post about TypeScript",
- *   url: "https://example.com/blog/my-post/",
- *   ogType: "article",
- *   publishedTime: "2024-01-15T00:00:00Z",
+ * ```ts
+ * const seo = useSeoMeta({
+ *   site: "https://example.com",
+ *   siteTitle: "My Site",
+ *   title: "Home",
+ *   description: "…",
+ *   ogImage: "https://example.com/image.png",
  * });
- * ---
- * <head>
- *   <Fragment set:html={metaTags} />
- * </head>
+ * // seo.title, seo.site, seo.ogImage — once each
+ * // seo.html / seo.tags — head injection
  * ```
  */
-export declare function useGenerateMetaTags(config: SiteConfig, meta: SeoMeta): string;
+export declare function useSeoMeta<OmitKeys extends keyof UseSeoMetaBase = never>(opts: UseSeoMetaOptions<OmitKeys>, defaults?: SiteConfig): SeoTagResult;
 /**
- * Generates a `<title>` tag string.
+ * @deprecated Prefer {@link useSeoMeta} with a unified flat object.
+ * Legacy: `useSeoTag(siteConfig, { title, description, ... })`.
  */
-export declare function useTitle(config: SiteConfig, pageTitle?: string): string;
+export declare function useSeoTag(config: SiteConfig, meta: SeoMeta): SeoTagResult;
+/** @deprecated Prefer {@link useSeoMeta}. */
+export declare const useSeoTags: typeof useSeoTag;
 /**
- * Generates the RSS `<link>` tag for the `<head>`.
+ * Applies tags from a {@link SeoTagResult} into `document.head` (Vanilla / SPA).
+ * No-op when `document` is unavailable (SSR).
  */
+export declare function useApplySeoTag(seo: SeoTagResult, head?: ParentNode | null): void;
+/** HTML string of meta tags (no RSS). Prefer {@link useSeoMeta}. */
+export declare function useGenerateMetaTags(config: SiteConfig, meta: SeoMeta): string;
+export declare function useTitle(config: SiteConfig, pageTitle?: string): string;
 export declare function useRssHeadLink(config: SiteConfig): string;
-/**
- * Generates all default `<head>` meta tags for a page (title, description,
- * canonical, OG, Twitter, JSON-LD, RSS link).
- *
- * Convenience wrapper around `useGenerateMetaTags` + `useRssHeadLink`.
- */
-export declare function useHeadTags(config: SiteConfig, meta: SeoMeta): string;
+/** Full `<head>` HTML (meta + RSS). Accepts legacy {@link SeoMeta} or flat {@link SeoMetaInput}. */
+export declare function useHeadTags(config: SiteConfig, meta: SeoMeta | SeoMetaInput): string;
 //# sourceMappingURL=seo.service.d.ts.map

package/dist/config/seo.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seo.service.d.ts","sourceRoot":"","sources":["../../src/config/seo.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,OAAO;IACvB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3C,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAmG7E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAKvE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAKzD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAIrE"}
+{"version":3,"file":"seo.service.d.ts","sourceRoot":"","sources":["../../src/config/seo.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,OAAO,EACP,YAAY,EAGZ,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEpF,YAAY,EACX,YAAY,EACZ,cAAc,EACd,OAAO,EACP,cAAc,EACd,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,cAAc,EACd,iBAAiB,GACjB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC;AAEzC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,QAAQ,SAAS,MAAM,cAAc,GAAG,KAAK,EACvE,IAAI,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EACjC,QAAQ,GAAE,UAA8B,GACtC,YAAY,CA6Cd;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,YAAY,CAEzE;AAED,6CAA6C;AAC7C,eAAO,MAAM,UAAU,kBAAY,CAAC;AAgEpC;;;GAGG;AACH,wBAAgB,cAAc,CAC7B,GAAG,EAAE,YAAY,EACjB,IAAI,GAAE,UAAU,GAAG,IAA6D,GAC9E,IAAI,CAoBN;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAM7E;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAKvE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAGzD;AAED,oGAAoG;AACpG,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,YAAY,GAAG,MAAM,CAKpF"}