@cmssy/core 9.10.0 → 10.1.0

package/dist/locale-XintNd0n.d.ts

@@ -0,0 +1,52 @@
+import { F as FetchLike, R as RetryPolicy } from './content-client-D0EdiqbQ.js';
+import { CmssyClientConfig, CmssyLocaleContext } from '@cmssy/types';
+
+interface GraphqlRequestOptions {
+    fetch?: FetchLike;
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+    /**
+     * Route through the org-scoped public delivery path instead of the base
+     * `/graphql` endpoint. Set for unauthenticated public queries so the backend
+     * resolves the workspace from the URL rather than a global slug lookup.
+     */
+    public?: boolean;
+    /**
+     * Retry transient HTTP failures (429/503, honoring Retry-After). Off by
+     * default: this function also carries mutations (auth, cart, checkout),
+     * which must never be blind-retried. Read-only callers opt in with `{}`.
+     */
+    retry?: RetryPolicy | false;
+}
+declare function graphqlRequest<T>(config: CmssyClientConfig, query: string, variables: Record<string, unknown>, options?: GraphqlRequestOptions, label?: string): Promise<T>;
+
+/**
+ * Rewrites an internal href to carry the active locale as a path prefix.
+ * External hrefs, fragments and relative paths are returned untouched. Already
+ * prefixed hrefs are normalized so the prefix never doubles.
+ */
+declare function localizeHref(href: string, locale: CmssyLocaleContext): string;
+/**
+ * Builds the href that switches the current `pathname` to `target` locale,
+ * preserving the rest of the path. Used by a language switcher.
+ */
+declare function buildLocaleSwitchHref(target: string, pathname: string, locale: CmssyLocaleContext): string;
+/**
+ * Rewrites every `<a href>` inside an HTML string with {@link localizeHref}.
+ * For rich-text content stored in CMS blocks where links are raw markup.
+ */
+declare function localizeHtmlLinks(html: string, locale: CmssyLocaleContext): string;
+
+declare const CMSSY_LOCALE_HEADER = "x-cmssy-locale";
+declare function localeForPathname(config: CmssyClientConfig, pathname: string): Promise<string>;
+declare function splitCmssyLocale(config: CmssyClientConfig, path: string[] | undefined): Promise<{
+    locale: string;
+    path: string[] | undefined;
+}>;
+/**
+ * Resolve the locale a path asks for. The prefix IS the language, so a routed
+ * path is all it takes - no request, no headers, static-safe.
+ */
+declare function localeForPath(config: CmssyClientConfig, path: string | string[]): Promise<string>;
+
+export { CMSSY_LOCALE_HEADER as C, type GraphqlRequestOptions as G, localeForPath as a, buildLocaleSwitchHref as b, localeForPathname as c, localizeHtmlLinks as d, graphqlRequest as g, localizeHref as l, splitCmssyLocale as s };

package/dist/locale-rhYcXU5z.d.cts

@@ -0,0 +1,52 @@
+import { F as FetchLike, R as RetryPolicy } from './content-client-D0EdiqbQ.cjs';
+import { CmssyClientConfig, CmssyLocaleContext } from '@cmssy/types';
+
+interface GraphqlRequestOptions {
+    fetch?: FetchLike;
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+    /**
+     * Route through the org-scoped public delivery path instead of the base
+     * `/graphql` endpoint. Set for unauthenticated public queries so the backend
+     * resolves the workspace from the URL rather than a global slug lookup.
+     */
+    public?: boolean;
+    /**
+     * Retry transient HTTP failures (429/503, honoring Retry-After). Off by
+     * default: this function also carries mutations (auth, cart, checkout),
+     * which must never be blind-retried. Read-only callers opt in with `{}`.
+     */
+    retry?: RetryPolicy | false;
+}
+declare function graphqlRequest<T>(config: CmssyClientConfig, query: string, variables: Record<string, unknown>, options?: GraphqlRequestOptions, label?: string): Promise<T>;
+
+/**
+ * Rewrites an internal href to carry the active locale as a path prefix.
+ * External hrefs, fragments and relative paths are returned untouched. Already
+ * prefixed hrefs are normalized so the prefix never doubles.
+ */
+declare function localizeHref(href: string, locale: CmssyLocaleContext): string;
+/**
+ * Builds the href that switches the current `pathname` to `target` locale,
+ * preserving the rest of the path. Used by a language switcher.
+ */
+declare function buildLocaleSwitchHref(target: string, pathname: string, locale: CmssyLocaleContext): string;
+/**
+ * Rewrites every `<a href>` inside an HTML string with {@link localizeHref}.
+ * For rich-text content stored in CMS blocks where links are raw markup.
+ */
+declare function localizeHtmlLinks(html: string, locale: CmssyLocaleContext): string;
+
+declare const CMSSY_LOCALE_HEADER = "x-cmssy-locale";
+declare function localeForPathname(config: CmssyClientConfig, pathname: string): Promise<string>;
+declare function splitCmssyLocale(config: CmssyClientConfig, path: string[] | undefined): Promise<{
+    locale: string;
+    path: string[] | undefined;
+}>;
+/**
+ * Resolve the locale a path asks for. The prefix IS the language, so a routed
+ * path is all it takes - no request, no headers, static-safe.
+ */
+declare function localeForPath(config: CmssyClientConfig, path: string | string[]): Promise<string>;
+
+export { CMSSY_LOCALE_HEADER as C, type GraphqlRequestOptions as G, localeForPath as a, buildLocaleSwitchHref as b, localeForPathname as c, localizeHtmlLinks as d, graphqlRequest as g, localizeHref as l, splitCmssyLocale as s };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cmssy/core",
-  "version": "9.10.0",
-  "description": "Framework-agnostic cmssy client: content, commerce, config, editor protocol. No React, no Next.",
+  "version": "10.1.0",
+  "description": "Framework-agnostic cmssy gateway: GraphQL client, block/field system, editor protocol. No React, no Next.",
   "keywords": [
     "cmssy",
     "cms",
@@ -27,6 +27,16 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "import": "./dist/internal.js",
+      "require": "./dist/internal.cjs"
+    },
+    "./internal/locale": {
+      "types": "./dist/internal/locale.d.ts",
+      "import": "./dist/internal/locale.js",
+      "require": "./dist/internal/locale.cjs"
+    },
     "./testing": {
       "types": "./dist/testing.d.ts",
       "import": "./dist/testing.js",