@forjacms/client 1.7.0 → 1.7.3

package/README.md

@@ -130,6 +130,62 @@ const privacy = await forja.legal.getBySlug('privacy-policy');
 const consent = await forja.legal.getCookieConsent();
 ```
 
+## Site Locales
+
+`SiteLocaleResponse` is the canonical shape returned by every endpoint that
+lists or resolves the locales configured for a site. Pinning this contract
+here because consumers have drifted in the past (inventing a `text_direction`
+field, expecting a top-level `id`, treating `url_prefix` as required).
+
+**Example payload:**
+
+```json
+{
+  "site_id": "550e8400-e29b-41d4-a716-446655440000",
+  "locale_id": "660e8400-e29b-41d4-a716-446655440000",
+  "is_default": true,
+  "is_active": true,
+  "url_prefix": null,
+  "created_at": "2024-01-15T10:30:00Z",
+  "code": "en",
+  "name": "English",
+  "native_name": "English",
+  "direction": "ltr"
+}
+```
+
+**Identity.** The natural key is the composite `(site_id, locale_id)`. There
+is no top-level `id` — a locale can be attached to many sites, and a site
+can carry many locales.
+
+**Field reference:**
+
+| Field         | Type                  | Notes                                                                                                   |
+| ------------- | --------------------- | ------------------------------------------------------------------------------------------------------- |
+| `site_id`     | UUID                  | Composite-key half #1.                                                                                  |
+| `locale_id`   | UUID                  | Composite-key half #2.                                                                                  |
+| `is_default`  | boolean               | Exactly one row per site has this `true`.                                                               |
+| `is_active`   | boolean               | Configured-but-not-served when `false`. Consumers usually filter to `is_active = true`.                 |
+| `url_prefix`  | string \| null        | Path segment selecting this locale. Nullable; the default locale conventionally has none.               |
+| `created_at`  | ISO-8601 (UTC)        | When the assignment was created.                                                                        |
+| `code`        | string                | BCP-47 (e.g. `"en"`, `"de-AT"`), denormalised from the `locales` row.                                   |
+| `name`        | string                | English-language label (e.g. `"English"`), denormalised.                                                |
+| `native_name` | string \| null        | Locale's own name (e.g. `"Deutsch"`), denormalised. Nullable for locales without a defined native form. |
+| `direction`   | `"ltr"` \| `"rtl"`    | Text direction. **The field is `direction` — NOT `text_direction`.**                                    |
+
+**Denormalisation rationale.** `code`, `name`, `native_name`, and `direction`
+live on the `locales` table but are inlined into the response so a consumer
+can render a locale switcher without a second round-trip. The trade-off is
+deliberate: assignment-rate-of-change is much lower than read-rate.
+
+**Anti-patterns to avoid in consumers:**
+
+- ❌ Renaming `direction` → `text_direction` (the upstream name wins).
+- ❌ Expecting a top-level `id` (use the `(site_id, locale_id)` composite).
+- ❌ Treating `url_prefix` as required (it's nullable; the default locale typically has none).
+
+See [issue #742](https://github.com/dominikdorfstetter/forja/issues/742) for the canonical-contract discussion.
+
 ## Pagination
 
 All paginated responses include helpers for navigating pages:

package/dist/angular/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../client-FailsuXv.cjs`);let t=require(`@angular/core`);const n=new t.InjectionToken(`ForjaClient`);function r(r){return(0,t.makeEnvironmentProviders)([{provide:n,useFactory:()=>new e.t(r)}])}function i(){return(0,t.inject)(n)}function a(e){let n=(0,t.signal)(void 0),r=(0,t.signal)(!0),i=(0,t.signal)(null),a=()=>{r.set(!0),i.set(null),e().then(e=>n.set(e)).catch(e=>i.set(e instanceof Error?e:Error(String(e)))).finally(()=>r.set(!1))};return a(),{value:n.asReadonly(),isLoading:r.asReadonly(),error:i.asReadonly(),reload:a}}exports.FORJA_CLIENT=n,exports.forjaResource=a,exports.injectForja=i,exports.provideForja=r;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../client-DVY5u6LJ.cjs`);let t=require(`@angular/core`);const n=new t.InjectionToken(`ForjaClient`);function r(r){return(0,t.makeEnvironmentProviders)([{provide:n,useFactory:()=>new e.t(r)}])}function i(){return(0,t.inject)(n)}function a(e){let n=(0,t.signal)(void 0),r=(0,t.signal)(!0),i=(0,t.signal)(null),a=()=>{r.set(!0),i.set(null),e().then(e=>n.set(e)).catch(e=>i.set(e instanceof Error?e:Error(String(e)))).finally(()=>r.set(!1))};return a(),{value:n.asReadonly(),isLoading:r.asReadonly(),error:i.asReadonly(),reload:a}}exports.FORJA_CLIENT=n,exports.forjaResource=a,exports.injectForja=i,exports.provideForja=r;

package/dist/angular/index.d.cts

@@ -1,4 +1,4 @@
-import { N as ForjaClientConfig, t as ForjaClient } from "../client-CvbFQ08l.cjs";
+import { N as ForjaClientConfig, t as ForjaClient } from "../client-CUbs1rkJ.cjs";
 import { EnvironmentProviders, InjectionToken, Signal } from "@angular/core";
 
 //#region src/angular/provider.d.ts

package/dist/angular/index.d.mts

@@ -1,4 +1,4 @@
-import { N as ForjaClientConfig, t as ForjaClient } from "../client-BTbTifpr.mjs";
+import { N as ForjaClientConfig, t as ForjaClient } from "../client-HGIKi26O.mjs";
 import { EnvironmentProviders, InjectionToken, Signal } from "@angular/core";
 
 //#region src/angular/provider.d.ts

package/dist/angular/index.mjs

@@ -1 +1 @@
-import{t as e}from"../client-C-2JZF6o.mjs";import{InjectionToken as t,inject as n,makeEnvironmentProviders as r,signal as i}from"@angular/core";const a=new t(`ForjaClient`);function o(t){return r([{provide:a,useFactory:()=>new e(t)}])}function s(){return n(a)}function c(e){let t=i(void 0),n=i(!0),r=i(null),a=()=>{n.set(!0),r.set(null),e().then(e=>t.set(e)).catch(e=>r.set(e instanceof Error?e:Error(String(e)))).finally(()=>n.set(!1))};return a(),{value:t.asReadonly(),isLoading:n.asReadonly(),error:r.asReadonly(),reload:a}}export{a as FORJA_CLIENT,c as forjaResource,s as injectForja,o as provideForja};
+import{t as e}from"../client-CWajZ1IX.mjs";import{InjectionToken as t,inject as n,makeEnvironmentProviders as r,signal as i}from"@angular/core";const a=new t(`ForjaClient`);function o(t){return r([{provide:a,useFactory:()=>new e(t)}])}function s(){return n(a)}function c(e){let t=i(void 0),n=i(!0),r=i(null),a=()=>{n.set(!0),r.set(null),e().then(e=>t.set(e)).catch(e=>r.set(e instanceof Error?e:Error(String(e)))).finally(()=>n.set(!1))};return a(),{value:t.asReadonly(),isLoading:n.asReadonly(),error:r.asReadonly(),reload:a}}export{a as FORJA_CLIENT,c as forjaResource,s as injectForja,o as provideForja};

package/dist/{client-BTbTifpr.d.mts → client-CUbs1rkJ.d.cts}

@@ -120,6 +120,18 @@ interface BlogDetailResponse extends BlogResponse {
   documents: BlogDocumentResponse[];
   og_image_url: string | null;
 }
+/**
+ * Options for blog detail lookups (`get`, `getBySlug`). The list shape
+ * does not yet carry `localizations[]` so the resolver only applies to
+ * the detail endpoint — list canonicalization is tracked separately.
+ */
+interface BlogDetailParams {
+  /**
+   * Optional locale code (e.g. `"en"`). When set, `localizations[]`
+   * collapses to one resolved entry. See ADR 0002.
+   */
+  locale?: string;
+}
 interface PageListItem {
   id: string;
   route: string;
@@ -281,6 +293,12 @@ interface AnalyticsPageParams {
   startDate?: string;
   endDate?: string;
 }
+interface SkillLocalizationResponse {
+  id: string;
+  locale_id: string;
+  name: string;
+  description: string | null;
+}
 interface SkillResponse {
   id: string;
   name: string;
@@ -288,6 +306,19 @@ interface SkillResponse {
   category: SkillCategory | null;
   icon: string | null;
   proficiency_level: number | null;
+  /**
+   * Per-locale display names. Empty array when no localizations exist
+   * (never null / missing). Clients pick the matching locale and fall
+   * back per their own rules.
+   */
+  localizations: SkillLocalizationResponse[];
+}
+interface CvEntryLocalizationResponse {
+  id: string;
+  locale_id: string;
+  position: string;
+  description: string | null;
+  achievements: unknown | null;
 }
 interface CvEntryResponse {
   id: string;
@@ -302,9 +333,52 @@ interface CvEntryResponse {
   display_order: number;
   created_at: string;
   updated_at: string;
+  /**
+   * Per-locale position + description. Empty array when no localizations
+   * exist (never null / missing).
+   */
+  localizations: CvEntryLocalizationResponse[];
+  /**
+   * Skill IDs linked to this CV entry. Empty array when no skills are
+   * linked (never null / missing).
+   */
+  skill_ids: string[];
+}
+/** Pagination, search, and locale-resolver params for skill listings. */
+interface SkillListParams extends SearchablePaginationParams {
+  /**
+   * Optional locale code (e.g. `"en"`). When set, each skill's
+   * `localizations` array collapses to one entry resolved by the server's
+   * fallback chain. See ADR 0002.
+   */
+  locale?: string;
+}
+/** Options for skill detail lookups (`getSkill`, `getSkillBySlug`). */
+interface SkillDetailParams {
+  /**
+   * Optional locale code. When set, `localizations` collapses to one
+   * resolved entry. See ADR 0002.
+   */
+  locale?: string;
 }
 interface CvEntryParams extends SearchablePaginationParams {
   entryType?: CvEntryType;
+  /**
+   * Optional locale code (e.g. `"en"`, `"de-AT"`). When set, each entry's
+   * `localizations` array collapses to one entry resolved by the server's
+   * fallback chain. Omit to receive every localization.
+   *
+   * See ADR 0002 (`docs/adr/0002-locale-resolver.md`).
+   */
+  locale?: string;
+}
+/** Options for CV-entry detail lookups (`getEntry`). */
+interface CvEntryDetailParams {
+  /**
+   * Optional locale code. When set, `localizations` collapses to one
+   * resolved entry. See ADR 0002.
+   */
+  locale?: string;
 }
 interface LegalDocumentResponse {
   id: string;
@@ -327,6 +401,19 @@ interface LegalDocumentDetailResponse {
   created_at: string;
   updated_at: string;
 }
+/**
+ * Options for legal-document detail lookups (`getBySlug`, `getDetail`).
+ * The list shape (`LegalDocumentResponse`) does not yet carry
+ * `localizations[]` — tracked separately.
+ */
+interface LegalDetailParams {
+  /**
+   * Optional locale code (e.g. `"en"`). When set, `localizations[]`
+   * (and `doc_localizations[]` on the full-detail endpoint) collapses
+   * to one resolved entry. See ADR 0002.
+   */
+  locale?: string;
+}
 interface LegalGroupResponse {
   id: string;
   cookie_name: string;
@@ -410,7 +497,16 @@ interface SocialLinkResponse {
 }
 /** Link type for project resources (repository, demo, docs, etc.). */
 type ProjectLinkType = 'repository' | 'demo' | 'documentation' | 'website' | 'other';
-/** Project summary for list views. */
+/** Localized content for a project. */
+interface ProjectLocalizationResponse {
+  id: string;
+  locale_id: string;
+  title: string;
+  short_description: string | null;
+  description: string | null;
+}
+/** Project summary for list views. Always carries `localizations` — empty
+ *  array when the project has none, never `null` or missing. */
 interface ProjectResponse {
   id: string;
   slug: string;
@@ -423,14 +519,9 @@ interface ProjectResponse {
   published_at: string | null;
   created_at: string;
   updated_at: string;
-}
-/** Localized content for a project. */
-interface ProjectLocalizationResponse {
-  id: string;
-  locale_id: string;
-  title: string;
-  short_description: string | null;
-  description: string | null;
+  /** Skill IDs linked to the project. Always present — empty array when none. */
+  skill_ids: string[];
+  localizations: ProjectLocalizationResponse[];
 }
 /** External link attached to a project. */
 interface ProjectLinkResponse {
@@ -447,12 +538,11 @@ interface ProjectMediaResponse {
   display_order: number;
   is_cover: boolean;
 }
-/** Full project detail including localizations, links, and media. */
+/** Full project detail. Inherits `skill_ids` and `localizations` from
+ *  {@link ProjectResponse}; adds links, media, and relation id sets. */
 interface ProjectDetailResponse extends ProjectResponse {
-  localizations: ProjectLocalizationResponse[];
   links: ProjectLinkResponse[];
   media: ProjectMediaResponse[];
-  skill_ids: string[];
   cv_entry_ids: string[];
 }
 /** Pagination and filter params for project listings. */
@@ -463,33 +553,79 @@ interface ProjectListParams extends PaginationParams {
   sortDir?: 'asc' | 'desc';
   /** Filter to featured projects only. */
   isFeatured?: boolean;
+  /**
+   * Optional locale code (e.g. `"en"`, `"de-AT"`). When set, each project's
+   * `localizations` array collapses to one entry resolved by the server's
+   * fallback chain (requested → site default → first available). Omit to
+   * receive every localization, which is the existing default.
+   *
+   * See ADR 0002 (`docs/adr/0002-locale-resolver.md`).
+   */
+  locale?: string;
 }
+/** Options for project detail lookups (`get`, `getBySlug`). */
+interface ProjectDetailParams {
+  /**
+   * Optional locale code. When set, `localizations` collapses to one entry
+   * resolved by the server's fallback chain. See ADR 0002.
+   */
+  locale?: string;
+}
+/**
+ * The set of HTTP status codes a Forja redirect may use.
+ *
+ * Pinned by issue #743. The same domain is enforced server-side by the
+ * `validate_redirect_status_code` DTO validator and the
+ * `chk_redirect_status_code` DB CHECK constraint, so consumers may rely
+ * on this value without runtime coercion.
+ */
+type RedirectStatusCode = 301 | 302 | 307 | 308;
 /** A URL redirect rule. */
 interface RedirectResponse {
   id: string;
   site_id: string;
   source_path: string;
   destination_path: string;
-  status_code: number;
+  status_code: RedirectStatusCode;
   is_active: boolean;
   description: string | null;
   created_at: string;
   updated_at: string;
 }
-/** Result of a redirect path lookup. */
+/**
+ * Result of a redirect path lookup.
+ *
+ * Returned with HTTP 200 by `GET /sites/{site_id}/redirects/lookup` on
+ * match. No-match is signalled by **404** (RFC 7807 ProblemDetails) —
+ * never a 200 with a null body, never a `{ redirects: [] }` list.
+ */
 interface RedirectLookupResponse {
   destination_path: string;
-  status_code: number;
+  status_code: RedirectStatusCode;
 }
 /** A locale configured for a site. */
 interface SiteLocaleResponse {
+  /** Composite-key half #1 — which site this assignment belongs to. */
+  site_id: string;
+  /** Composite-key half #2 — which locale is attached. */
   locale_id: string;
+  /** BCP-47 code, denormalised from `locales.code`. */
   code: string;
+  /** English-language label, denormalised from `locales.name`. */
   name: string;
+  /** Locale's own name, denormalised from `locales.native_name`. */
   native_name: string | null;
   direction: 'ltr' | 'rtl';
+  /** Exactly one row per site has this set to `true`. */
   is_default: boolean;
+  /** Configured-but-not-served when `false`. Consumers usually filter to `true`. */
   is_active: boolean;
+  /**
+   * Path segment selecting this locale. `null` for the default locale
+   * (served at the site root without a prefix).
+   */
+  url_prefix: string | null;
+  created_at: string;
 }
 /** Media item summary for list views (lighter than full MediaResponse). */
 interface MediaListItem {
@@ -770,7 +906,7 @@ declare class BlogsResource {
    * }
    * ```
    */
-  getBySlug(slug: string): Promise<BlogDetailResponse | null>;
+  getBySlug(slug: string, params?: BlogDetailParams): Promise<BlogDetailResponse | null>;
   /**
    * Fetch a blog post's full detail by its UUID.
    *
@@ -784,7 +920,7 @@ declare class BlogsResource {
    * const blog = await forja.blogs.get('550e8400-e29b-41d4-a716-446655440000');
    * ```
    */
-  get(idOrSlug: string): Promise<BlogDetailResponse | null>;
+  get(idOrSlug: string, params?: BlogDetailParams): Promise<BlogDetailResponse | null>;
   /**
    * Fetch the site's RSS feed as raw XML.
    *
@@ -822,7 +958,7 @@ declare class CvResource {
    * const programming = skills.data.filter(s => s.category === 'Programming');
    * ```
    */
-  listSkills(params?: SearchablePaginationParams): Promise<PaginatedResult<SkillResponse>>;
+  listSkills(params?: SkillListParams): Promise<PaginatedResult<SkillResponse>>;
   /**
    * Fetch a skill by its UUID.
    *
@@ -831,7 +967,7 @@ declare class CvResource {
    * @param id - The skill's UUID.
    * @returns The skill, or `null` if not found.
    */
-  getSkill(id: string): Promise<SkillResponse | null>;
+  getSkill(id: string, params?: SkillDetailParams): Promise<SkillResponse | null>;
   /**
    * Fetch a skill by its URL slug.
    *
@@ -846,7 +982,7 @@ declare class CvResource {
    * if (ts) console.log(`${ts.name}: level ${ts.proficiency_level}`);
    * ```
    */
-  getSkillBySlug(slug: string): Promise<SkillResponse | null>;
+  getSkillBySlug(slug: string, params?: SkillDetailParams): Promise<SkillResponse | null>;
   /**
    * Fetch a paginated list of CV entries (work, education, certifications, etc.).
    *
@@ -863,6 +999,25 @@ declare class CvResource {
    * ```
    */
   listEntries(params?: CvEntryParams): Promise<PaginatedResult<CvEntryResponse>>;
+  /**
+   * Fetch a CV entry by its UUID.
+   *
+   * **Endpoint:** `GET /cv/{id}`
+   *
+   * @param id - The CV entry's UUID.
+   * @param params - Optional locale resolver per ADR 0002.
+   * @returns The CV entry, or `null` if not found.
+   *
+   * @example
+   * ```ts
+   * // All localizations (default)
+   * const entry = await forja.cv.getEntry('entry-uuid');
+   *
+   * // Single-locale collapse
+   * const enEntry = await forja.cv.getEntry('entry-uuid', { locale: 'en' });
+   * ```
+   */
+  getEntry(id: string, params?: CvEntryDetailParams): Promise<CvEntryResponse | null>;
 }
 //#endregion
 //#region src/resources/forms.d.ts
@@ -1029,7 +1184,7 @@ declare class LegalResource {
    * }
    * ```
    */
-  getBySlug(slug: string): Promise<LegalDocumentDetailResponse | null>;
+  getBySlug(slug: string, params?: LegalDetailParams): Promise<LegalDocumentDetailResponse | null>;
   /**
    * Fetch the cookie consent document with its consent groups and items.
    *
@@ -1093,7 +1248,7 @@ declare class LegalResource {
    * }
    * ```
    */
-  getDetail(id: string): Promise<LegalDocumentFullDetailResponse | null>;
+  getDetail(id: string, params?: LegalDetailParams): Promise<LegalDocumentFullDetailResponse | null>;
   /**
    * Fetch the version history of a legal document.
    *
@@ -1291,6 +1446,19 @@ interface PageListParams extends SearchablePaginationParams {
   /** Exclude pages with this status. */
   excludeStatus?: string;
 }
+/**
+ * Options for page-detail lookups (`getDetail`). The list shape
+ * (`PageResponse`) does not carry `localizations[]` today — adding it is
+ * tracked as a separate canonicalization gap; until then the resolver
+ * applies only to the detail endpoint.
+ */
+interface PageDetailParams {
+  /**
+   * Optional locale code (e.g. `"en"`). When set, `localizations[]`
+   * collapses to one resolved entry. See ADR 0002.
+   */
+  locale?: string;
+}
 /**
  * CMS page operations.
  *
@@ -1337,6 +1505,25 @@ declare class PagesResource {
    * ```
    */
   getByRoute(route: string): Promise<PageDetailResponse | null>;
+  /**
+   * Fetch a page's full detail (content localizations + computed OG image).
+   *
+   * **Endpoint:** `GET /pages/{id}/detail`
+   *
+   * @param id - The page's UUID.
+   * @param params - Optional locale resolver (ADR 0002).
+   * @returns The page detail, or `null` if not found.
+   *
+   * @example
+   * ```ts
+   * // Every localization (admin/editor use case)
+   * const detail = await forja.pages.getDetail('page-uuid');
+   *
+   * // Server-side rendering — single locale
+   * const en = await forja.pages.getDetail('page-uuid', { locale: 'en' });
+   * ```
+   */
+  getDetail(id: string, params?: PageDetailParams): Promise<PageDetailResponse | null>;
   /**
    * Fetch all sections for a page.
    *
@@ -1438,7 +1625,7 @@ declare class ProjectsResource {
    * }
    * ```
    */
-  get(id: string): Promise<ProjectDetailResponse | null>;
+  get(id: string, params?: ProjectDetailParams): Promise<ProjectDetailResponse | null>;
   /**
    * Fetch a project by its URL slug.
    *
@@ -1452,7 +1639,7 @@ declare class ProjectsResource {
    * const project = await forja.projects.getBySlug('forja-cms');
    * ```
    */
-  getBySlug(slug: string): Promise<ProjectResponse | null>;
+  getBySlug(slug: string, params?: ProjectDetailParams): Promise<ProjectResponse | null>;
 }
 //#endregion
 //#region src/resources/redirects.d.ts

package/dist/client-CWajZ1IX.mjs

@@ -0,0 +1 @@
+var e=class extends Error{constructor(e,t){super(e),this.code=t,this.name=`ForjaError`}},t=class extends e{constructor(e=`Invalid or missing API key`){super(e,`AUTH_ERROR`),this.name=`ForjaAuthError`}},n=class extends e{constructor(e=`Insufficient permissions`){super(e,`PERMISSION_ERROR`),this.name=`ForjaPermissionError`}},r=class extends e{constructor(e=`Resource not found`){super(e,`NOT_FOUND`),this.name=`ForjaNotFoundError`}},i=class extends e{constructor(e=`Rate limit exceeded`,t){super(e,`RATE_LIMIT`),this.retryAfter=t,this.name=`ForjaRateLimitError`}},a=class extends e{constructor(e=`Validation error`,t){super(e,`VALIDATION_ERROR`),this.details=t,this.name=`ForjaValidationError`}},o=class extends e{constructor(e=`Internal server error`,t=500){super(e,`SERVER_ERROR`),this.status=t,this.name=`ForjaServerError`}},s=class extends e{constructor(e=`Network error`,t){super(e,`NETWORK_ERROR`),this.cause=t,this.name=`ForjaNetworkError`}};function c(e,t,n){let r=e.replace(/\/+$/,``),i=t.startsWith(`/`)?t:`/${t}`,a=new URL(`${r}${i}`);if(n)for(let[e,t]of Object.entries(n))t!==void 0&&a.searchParams.set(e,t);return a.toString()}function l(e){let t={};for(let[n,r]of Object.entries(e))r!=null&&(t[u(n)]=String(r));return t}function u(e){return e.replace(/[A-Z]/g,e=>`_${e.toLowerCase()}`)}async function d(e){let s;try{let t=await e.json();s=t.detail||t.message||t.title||e.statusText}catch{s=e.statusText}switch(e.status){case 401:throw new t(s);case 403:throw new n(s);case 404:throw new r(s);case 422:throw new a(s);case 429:{let t=e.headers.get(`retry-after`);throw new i(s,t?parseInt(t,10):void 0)}default:throw e.status,new o(s,e.status)}}function f(e){let t=e.fetch??globalThis.fetch,n=e.baseUrl.replace(/\/+$/,``),r={"X-API-Key":e.apiKey,"Content-Type":`application/json`};e.siteDomain&&(r[`X-Site-Domain`]=e.siteDomain);async function i(e,i,a,o){let l=c(n,i,a),u;try{u=await t(l,{method:e,headers:r,body:o===void 0?void 0:JSON.stringify(o)})}catch(e){throw new s(`Failed to connect to the Forja API`,e instanceof Error?e:void 0)}return u.ok?u:d(u)}return{get:(e,t)=>i(`GET`,e,t).then(e=>e.json()),getText:(e,t)=>i(`GET`,e,t).then(e=>e.text()),post:(e,t)=>i(`POST`,e,void 0,t).then(e=>e.json()),delete:e=>i(`DELETE`,e).then(()=>void 0)}}function p(e,t,n){return{data:e,meta:t,async fetchNext(){if(t.page>=t.total_pages)return null;let e=await n(t.page+1);return p(e.data,e.meta,n)},async fetchAll(){let r=[...e],i=t.page;for(;i<t.total_pages;){i++;let e=await n(i);r.push(...e.data)}return r},async*[Symbol.asyncIterator](){yield{data:e,meta:t};let r=t.page;for(;r<t.total_pages;)r++,yield await n(r)}}}var m=class{constructor(e,t){this.http=e,this.siteId=t}async trackPageview(e){return this.http.post(`/sites/${this.siteId}/analytics/pageview`,e)}async getReport(e){let t=e?l({days:e.days,top_n:e.topN,start_date:e.startDate,end_date:e.endDate}):void 0;return this.http.get(`/sites/${this.siteId}/analytics/report`,t)}async getPageAnalytics(e){let t=l({path:e.path,days:e.days,start_date:e.startDate,end_date:e.endDate});return this.http.get(`/sites/${this.siteId}/analytics/report/page`,t)}},h=class{constructor(e,t){this.http=e,this.siteId=t}async listPublished(e){let t=e?l(e):void 0,n=e?.localeId?{locale_id:e.localeId}:{},r=async e=>this.http.get(`/sites/${this.siteId}/blogs/published`,{...t,...n,page:String(e)}),i=await r(e?.page??1);return p(i.data,i.meta,r)}async listByCategory(e,t){let n=t?l(t):void 0,r=t?.localeId?{locale_id:t.localeId}:{},i=async t=>this.http.get(`/sites/${this.siteId}/blogs/published/category/${encodeURIComponent(e)}`,{...n,...r,page:String(t)}),a=await i(t?.page??1);return p(a.data,a.meta,i)}async listFeatured(e){return this.http.get(`/sites/${this.siteId}/blogs/featured`,e?.limit===void 0?void 0:{limit:String(e.limit)})}async listSimilar(e,t){return this.http.get(`/sites/${this.siteId}/blogs/${encodeURIComponent(e)}/similar`,t?.limit===void 0?void 0:{limit:String(t.limit)})}async getBySlug(e,t){try{let n=`/blogs/${(await this.http.get(`/sites/${this.siteId}/blogs/by-slug/${encodeURIComponent(e)}`)).id}/detail`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}async get(e,t){try{let n=`/blogs/${encodeURIComponent(e)}/detail`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}async rss(){return this.http.getText(`/sites/${this.siteId}/feed.rss`)}},g=class{constructor(e,t){this.http=e,this.siteId=t}async listSkills(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/skills`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async getSkill(e,t){try{let n=`/skills/${encodeURIComponent(e)}`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}async getSkillBySlug(e,t){try{let n=`/skills/by-slug/${encodeURIComponent(e)}`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}async listEntries(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/cv`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async getEntry(e,t){try{let n=`/cv/${encodeURIComponent(e)}`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}},_=class{constructor(e){this.http=e}async getForm(e,t){let n=t?.locale?{locale:t.locale}:void 0;return this.http.get(`/public/forms/${encodeURIComponent(e)}`,n)}async submitForm(e,t,n={}){return this.http.post(`/public/forms/${encodeURIComponent(e)}/submit`,{data:t,consent_given:n.consentGiven??!1,bot_protection_token:n.botProtectionToken})}async lookupSubmission(e){return this.http.post(`/public/submissions/lookup`,{reference_code:e})}async getSubmission(e){return this.http.get(`/public/submissions/${encodeURIComponent(e)}`)}async deleteSubmission(e){return this.http.delete(`/public/submissions/${encodeURIComponent(e)}`)}};const v=/^[A-Za-z0-9._%+\-]+@[A-Za-z0-9.\-]+\.[A-Za-z]{2,}$/;function y(e,t){let n={};for(let r of e.fields){let e=t[r.label],i=b(r,e);i&&(n[r.label]=i)}return n}function b(e,t){let n=t,r=n==null||typeof n==`string`&&n===``||Array.isArray(n)&&n.length===0;if((e.is_required||e.validation.required)&&r)return`${e.label} is required`;if(r)return null;switch(e.field_type){case`text`:case`textarea`:case`custom`:if(typeof n!=`string`)return`Must be a string`;if(e.validation.min_length!==void 0&&n.length<e.validation.min_length)return`Must be at least ${e.validation.min_length} characters`;if(e.validation.max_length!==void 0&&n.length>e.validation.max_length)return`Must be at most ${e.validation.max_length} characters`;if(e.validation.pattern)try{if(!new RegExp(e.validation.pattern).test(n))return`Value does not match the required pattern`}catch{return`Field has an invalid validation pattern`}return null;case`email`:return typeof n==`string`?v.test(n)?null:`Invalid email format`:`Must be a string`;case`number`:{let t=typeof n==`number`?n:Number(n);return Number.isNaN(t)?`Must be a number`:e.validation.min!==void 0&&t<e.validation.min?`Must be at least ${e.validation.min}`:e.validation.max!==void 0&&t>e.validation.max?`Must be at most ${e.validation.max}`:null}case`date`:return typeof n!=`string`||Number.isNaN(Date.parse(n))&&!/^\d{4}-\d{2}-\d{2}$/.test(n)?`Invalid date format`:null;case`select`:case`radio`:case`checkbox`:return null}}var x=class{constructor(e,t){this.http=e,this.siteId=t}async list(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/legal`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async get(e){try{return await this.http.get(`/legal/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getBySlug(e,t){try{let n=`/sites/${this.siteId}/legal/by-slug/${encodeURIComponent(e)}`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}async getCookieConsent(){try{return await this.http.get(`/sites/${this.siteId}/legal/cookie-consent`)}catch(e){if(e instanceof r)return null;throw e}}async getGroups(e){return this.http.get(`/legal/${encodeURIComponent(e)}/groups`)}async getGroupItems(e){return this.http.get(`/legal/groups/${encodeURIComponent(e)}/items`)}async getDetail(e,t){try{let n=`/legal/${encodeURIComponent(e)}/detail`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}async listVersions(e){return this.http.get(`/legal/${encodeURIComponent(e)}/versions`)}},S=class{constructor(e,t){this.http=e,this.siteId=t}async list(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/media`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async get(e){try{return await this.http.get(`/media/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}},C=class{constructor(e,t){this.http=e,this.siteId=t}async listMenus(){return this.http.get(`/sites/${this.siteId}/menus`)}async getMenu(e){try{return await this.http.get(`/menus/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getMenuBySlug(e){try{return await this.http.get(`/sites/${this.siteId}/menus/slug/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getTree(e,t){return this.http.get(`/menus/${encodeURIComponent(e)}/tree`,t?.locale?{locale:t.locale}:void 0)}async listItems(e){return this.http.get(`/menus/${encodeURIComponent(e)}/items`)}async getItem(e){try{return await this.http.get(`/navigation/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}},w=class{constructor(e,t){this.http=e,this.siteId=t}async list(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/pages`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async getByRoute(e){let t=e.startsWith(`/`)?e.slice(1):e;try{return await this.http.get(`/sites/${this.siteId}/pages/by-route/${encodeURIComponent(t)}`)}catch(e){if(e instanceof r)return null;throw e}}async getDetail(e,t){try{let n=`/pages/${encodeURIComponent(e)}/detail`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}async getSections(e){return this.http.get(`/pages/${encodeURIComponent(e)}/sections`)}async getSectionLocalizations(e){return this.http.get(`/pages/sections/${encodeURIComponent(e)}/localizations`)}async getPageSectionLocalizations(e){return this.http.get(`/pages/${encodeURIComponent(e)}/sections/localizations`)}},T=class{constructor(e,t){this.http=e,this.siteId=t}async listPublished(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/projects/public`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async get(e,t){try{let n=`/projects/${encodeURIComponent(e)}`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}async getBySlug(e,t){try{let n=`/sites/${this.siteId}/projects/by-slug/${encodeURIComponent(e)}`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}},E=class{constructor(e,t){this.http=e,this.siteId=t}async lookup(e){try{return await this.http.get(`/sites/${this.siteId}/redirects/lookup`,{path:e})}catch(e){if(e instanceof r)return null;throw e}}},D=class{constructor(e,t){this.http=e,this.siteId=t}async get(){return this.http.get(`/sites/${this.siteId}`)}async listLocales(){return this.http.get(`/sites/${this.siteId}/locales`)}async getCodeInjection(){let e=await this.http.get(`/sites/${this.siteId}/settings`);return{code_injection_head:e.code_injection_head??``,code_injection_footer:e.code_injection_footer??``}}},O=class{constructor(e,t){this.http=e,this.siteId=t}async list(){return this.http.get(`/sites/${this.siteId}/social`)}},k=class{constructor(e,t){this.http=e,this.siteId=t}async listTags(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/tags`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async listCategories(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/categories`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async getCategoriesWithBlogCounts(){return this.http.get(`/sites/${this.siteId}/categories/blog-counts`)}async getContentTags(e){return this.http.get(`/content/${encodeURIComponent(e)}/tags`)}async getContentCategories(e){return this.http.get(`/content/${encodeURIComponent(e)}/categories`)}async getTag(e){try{return await this.http.get(`/tags/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getTagBySlug(e){try{return await this.http.get(`/tags/by-slug/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getCategory(e){try{return await this.http.get(`/categories/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getCategoryChildren(e){return this.http.get(`/categories/${encodeURIComponent(e)}/children`)}},A=class{constructor(e){let t=f(e);this.blogs=new h(t,e.siteId),this.pages=new w(t,e.siteId),this.navigation=new C(t,e.siteId),this.taxonomy=new k(t,e.siteId),this.analytics=new m(t,e.siteId),this.cv=new g(t,e.siteId),this.legal=new x(t,e.siteId),this.projects=new T(t,e.siteId),this.redirects=new E(t,e.siteId),this.site=new D(t,e.siteId),this.media=new S(t,e.siteId),this.social=new O(t,e.siteId),this.forms=new _(t)}};export{s as a,i as c,e as i,o as l,y as n,r as o,t as r,n as s,A as t,a as u};

package/dist/client-DVY5u6LJ.cjs

@@ -0,0 +1 @@
+var e=class extends Error{constructor(e,t){super(e),this.code=t,this.name=`ForjaError`}},t=class extends e{constructor(e=`Invalid or missing API key`){super(e,`AUTH_ERROR`),this.name=`ForjaAuthError`}},n=class extends e{constructor(e=`Insufficient permissions`){super(e,`PERMISSION_ERROR`),this.name=`ForjaPermissionError`}},r=class extends e{constructor(e=`Resource not found`){super(e,`NOT_FOUND`),this.name=`ForjaNotFoundError`}},i=class extends e{constructor(e=`Rate limit exceeded`,t){super(e,`RATE_LIMIT`),this.retryAfter=t,this.name=`ForjaRateLimitError`}},a=class extends e{constructor(e=`Validation error`,t){super(e,`VALIDATION_ERROR`),this.details=t,this.name=`ForjaValidationError`}},o=class extends e{constructor(e=`Internal server error`,t=500){super(e,`SERVER_ERROR`),this.status=t,this.name=`ForjaServerError`}},s=class extends e{constructor(e=`Network error`,t){super(e,`NETWORK_ERROR`),this.cause=t,this.name=`ForjaNetworkError`}};function c(e,t,n){let r=e.replace(/\/+$/,``),i=t.startsWith(`/`)?t:`/${t}`,a=new URL(`${r}${i}`);if(n)for(let[e,t]of Object.entries(n))t!==void 0&&a.searchParams.set(e,t);return a.toString()}function l(e){let t={};for(let[n,r]of Object.entries(e))r!=null&&(t[u(n)]=String(r));return t}function u(e){return e.replace(/[A-Z]/g,e=>`_${e.toLowerCase()}`)}async function d(e){let s;try{let t=await e.json();s=t.detail||t.message||t.title||e.statusText}catch{s=e.statusText}switch(e.status){case 401:throw new t(s);case 403:throw new n(s);case 404:throw new r(s);case 422:throw new a(s);case 429:{let t=e.headers.get(`retry-after`);throw new i(s,t?parseInt(t,10):void 0)}default:throw e.status,new o(s,e.status)}}function f(e){let t=e.fetch??globalThis.fetch,n=e.baseUrl.replace(/\/+$/,``),r={"X-API-Key":e.apiKey,"Content-Type":`application/json`};e.siteDomain&&(r[`X-Site-Domain`]=e.siteDomain);async function i(e,i,a,o){let l=c(n,i,a),u;try{u=await t(l,{method:e,headers:r,body:o===void 0?void 0:JSON.stringify(o)})}catch(e){throw new s(`Failed to connect to the Forja API`,e instanceof Error?e:void 0)}return u.ok?u:d(u)}return{get:(e,t)=>i(`GET`,e,t).then(e=>e.json()),getText:(e,t)=>i(`GET`,e,t).then(e=>e.text()),post:(e,t)=>i(`POST`,e,void 0,t).then(e=>e.json()),delete:e=>i(`DELETE`,e).then(()=>void 0)}}function p(e,t,n){return{data:e,meta:t,async fetchNext(){if(t.page>=t.total_pages)return null;let e=await n(t.page+1);return p(e.data,e.meta,n)},async fetchAll(){let r=[...e],i=t.page;for(;i<t.total_pages;){i++;let e=await n(i);r.push(...e.data)}return r},async*[Symbol.asyncIterator](){yield{data:e,meta:t};let r=t.page;for(;r<t.total_pages;)r++,yield await n(r)}}}var m=class{constructor(e,t){this.http=e,this.siteId=t}async trackPageview(e){return this.http.post(`/sites/${this.siteId}/analytics/pageview`,e)}async getReport(e){let t=e?l({days:e.days,top_n:e.topN,start_date:e.startDate,end_date:e.endDate}):void 0;return this.http.get(`/sites/${this.siteId}/analytics/report`,t)}async getPageAnalytics(e){let t=l({path:e.path,days:e.days,start_date:e.startDate,end_date:e.endDate});return this.http.get(`/sites/${this.siteId}/analytics/report/page`,t)}},h=class{constructor(e,t){this.http=e,this.siteId=t}async listPublished(e){let t=e?l(e):void 0,n=e?.localeId?{locale_id:e.localeId}:{},r=async e=>this.http.get(`/sites/${this.siteId}/blogs/published`,{...t,...n,page:String(e)}),i=await r(e?.page??1);return p(i.data,i.meta,r)}async listByCategory(e,t){let n=t?l(t):void 0,r=t?.localeId?{locale_id:t.localeId}:{},i=async t=>this.http.get(`/sites/${this.siteId}/blogs/published/category/${encodeURIComponent(e)}`,{...n,...r,page:String(t)}),a=await i(t?.page??1);return p(a.data,a.meta,i)}async listFeatured(e){return this.http.get(`/sites/${this.siteId}/blogs/featured`,e?.limit===void 0?void 0:{limit:String(e.limit)})}async listSimilar(e,t){return this.http.get(`/sites/${this.siteId}/blogs/${encodeURIComponent(e)}/similar`,t?.limit===void 0?void 0:{limit:String(t.limit)})}async getBySlug(e,t){try{let n=`/blogs/${(await this.http.get(`/sites/${this.siteId}/blogs/by-slug/${encodeURIComponent(e)}`)).id}/detail`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}async get(e,t){try{let n=`/blogs/${encodeURIComponent(e)}/detail`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}async rss(){return this.http.getText(`/sites/${this.siteId}/feed.rss`)}},g=class{constructor(e,t){this.http=e,this.siteId=t}async listSkills(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/skills`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async getSkill(e,t){try{let n=`/skills/${encodeURIComponent(e)}`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}async getSkillBySlug(e,t){try{let n=`/skills/by-slug/${encodeURIComponent(e)}`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}async listEntries(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/cv`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async getEntry(e,t){try{let n=`/cv/${encodeURIComponent(e)}`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}},_=class{constructor(e){this.http=e}async getForm(e,t){let n=t?.locale?{locale:t.locale}:void 0;return this.http.get(`/public/forms/${encodeURIComponent(e)}`,n)}async submitForm(e,t,n={}){return this.http.post(`/public/forms/${encodeURIComponent(e)}/submit`,{data:t,consent_given:n.consentGiven??!1,bot_protection_token:n.botProtectionToken})}async lookupSubmission(e){return this.http.post(`/public/submissions/lookup`,{reference_code:e})}async getSubmission(e){return this.http.get(`/public/submissions/${encodeURIComponent(e)}`)}async deleteSubmission(e){return this.http.delete(`/public/submissions/${encodeURIComponent(e)}`)}};const v=/^[A-Za-z0-9._%+\-]+@[A-Za-z0-9.\-]+\.[A-Za-z]{2,}$/;function y(e,t){let n={};for(let r of e.fields){let e=t[r.label],i=b(r,e);i&&(n[r.label]=i)}return n}function b(e,t){let n=t,r=n==null||typeof n==`string`&&n===``||Array.isArray(n)&&n.length===0;if((e.is_required||e.validation.required)&&r)return`${e.label} is required`;if(r)return null;switch(e.field_type){case`text`:case`textarea`:case`custom`:if(typeof n!=`string`)return`Must be a string`;if(e.validation.min_length!==void 0&&n.length<e.validation.min_length)return`Must be at least ${e.validation.min_length} characters`;if(e.validation.max_length!==void 0&&n.length>e.validation.max_length)return`Must be at most ${e.validation.max_length} characters`;if(e.validation.pattern)try{if(!new RegExp(e.validation.pattern).test(n))return`Value does not match the required pattern`}catch{return`Field has an invalid validation pattern`}return null;case`email`:return typeof n==`string`?v.test(n)?null:`Invalid email format`:`Must be a string`;case`number`:{let t=typeof n==`number`?n:Number(n);return Number.isNaN(t)?`Must be a number`:e.validation.min!==void 0&&t<e.validation.min?`Must be at least ${e.validation.min}`:e.validation.max!==void 0&&t>e.validation.max?`Must be at most ${e.validation.max}`:null}case`date`:return typeof n!=`string`||Number.isNaN(Date.parse(n))&&!/^\d{4}-\d{2}-\d{2}$/.test(n)?`Invalid date format`:null;case`select`:case`radio`:case`checkbox`:return null}}var x=class{constructor(e,t){this.http=e,this.siteId=t}async list(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/legal`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async get(e){try{return await this.http.get(`/legal/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getBySlug(e,t){try{let n=`/sites/${this.siteId}/legal/by-slug/${encodeURIComponent(e)}`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}async getCookieConsent(){try{return await this.http.get(`/sites/${this.siteId}/legal/cookie-consent`)}catch(e){if(e instanceof r)return null;throw e}}async getGroups(e){return this.http.get(`/legal/${encodeURIComponent(e)}/groups`)}async getGroupItems(e){return this.http.get(`/legal/groups/${encodeURIComponent(e)}/items`)}async getDetail(e,t){try{let n=`/legal/${encodeURIComponent(e)}/detail`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}async listVersions(e){return this.http.get(`/legal/${encodeURIComponent(e)}/versions`)}},S=class{constructor(e,t){this.http=e,this.siteId=t}async list(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/media`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async get(e){try{return await this.http.get(`/media/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}},C=class{constructor(e,t){this.http=e,this.siteId=t}async listMenus(){return this.http.get(`/sites/${this.siteId}/menus`)}async getMenu(e){try{return await this.http.get(`/menus/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getMenuBySlug(e){try{return await this.http.get(`/sites/${this.siteId}/menus/slug/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getTree(e,t){return this.http.get(`/menus/${encodeURIComponent(e)}/tree`,t?.locale?{locale:t.locale}:void 0)}async listItems(e){return this.http.get(`/menus/${encodeURIComponent(e)}/items`)}async getItem(e){try{return await this.http.get(`/navigation/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}},w=class{constructor(e,t){this.http=e,this.siteId=t}async list(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/pages`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async getByRoute(e){let t=e.startsWith(`/`)?e.slice(1):e;try{return await this.http.get(`/sites/${this.siteId}/pages/by-route/${encodeURIComponent(t)}`)}catch(e){if(e instanceof r)return null;throw e}}async getDetail(e,t){try{let n=`/pages/${encodeURIComponent(e)}/detail`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}async getSections(e){return this.http.get(`/pages/${encodeURIComponent(e)}/sections`)}async getSectionLocalizations(e){return this.http.get(`/pages/sections/${encodeURIComponent(e)}/localizations`)}async getPageSectionLocalizations(e){return this.http.get(`/pages/${encodeURIComponent(e)}/sections/localizations`)}},T=class{constructor(e,t){this.http=e,this.siteId=t}async listPublished(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/projects/public`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async get(e,t){try{let n=`/projects/${encodeURIComponent(e)}`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}async getBySlug(e,t){try{let n=`/sites/${this.siteId}/projects/by-slug/${encodeURIComponent(e)}`;return t?.locale?await this.http.get(n,{locale:t.locale}):await this.http.get(n)}catch(e){if(e instanceof r)return null;throw e}}},E=class{constructor(e,t){this.http=e,this.siteId=t}async lookup(e){try{return await this.http.get(`/sites/${this.siteId}/redirects/lookup`,{path:e})}catch(e){if(e instanceof r)return null;throw e}}},D=class{constructor(e,t){this.http=e,this.siteId=t}async get(){return this.http.get(`/sites/${this.siteId}`)}async listLocales(){return this.http.get(`/sites/${this.siteId}/locales`)}async getCodeInjection(){let e=await this.http.get(`/sites/${this.siteId}/settings`);return{code_injection_head:e.code_injection_head??``,code_injection_footer:e.code_injection_footer??``}}},O=class{constructor(e,t){this.http=e,this.siteId=t}async list(){return this.http.get(`/sites/${this.siteId}/social`)}},k=class{constructor(e,t){this.http=e,this.siteId=t}async listTags(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/tags`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async listCategories(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/categories`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async getCategoriesWithBlogCounts(){return this.http.get(`/sites/${this.siteId}/categories/blog-counts`)}async getContentTags(e){return this.http.get(`/content/${encodeURIComponent(e)}/tags`)}async getContentCategories(e){return this.http.get(`/content/${encodeURIComponent(e)}/categories`)}async getTag(e){try{return await this.http.get(`/tags/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getTagBySlug(e){try{return await this.http.get(`/tags/by-slug/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getCategory(e){try{return await this.http.get(`/categories/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getCategoryChildren(e){return this.http.get(`/categories/${encodeURIComponent(e)}/children`)}},A=class{constructor(e){let t=f(e);this.blogs=new h(t,e.siteId),this.pages=new w(t,e.siteId),this.navigation=new C(t,e.siteId),this.taxonomy=new k(t,e.siteId),this.analytics=new m(t,e.siteId),this.cv=new g(t,e.siteId),this.legal=new x(t,e.siteId),this.projects=new T(t,e.siteId),this.redirects=new E(t,e.siteId),this.site=new D(t,e.siteId),this.media=new S(t,e.siteId),this.social=new O(t,e.siteId),this.forms=new _(t)}};Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,`c`,{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return e}}),Object.defineProperty(exports,`l`,{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return A}}),Object.defineProperty(exports,`u`,{enumerable:!0,get:function(){return a}});

package/dist/{client-CvbFQ08l.d.cts → client-HGIKi26O.d.mts}

@@ -120,6 +120,18 @@ interface BlogDetailResponse extends BlogResponse {
   documents: BlogDocumentResponse[];
   og_image_url: string | null;
 }
+/**
+ * Options for blog detail lookups (`get`, `getBySlug`). The list shape
+ * does not yet carry `localizations[]` so the resolver only applies to
+ * the detail endpoint — list canonicalization is tracked separately.
+ */
+interface BlogDetailParams {
+  /**
+   * Optional locale code (e.g. `"en"`). When set, `localizations[]`
+   * collapses to one resolved entry. See ADR 0002.
+   */
+  locale?: string;
+}
 interface PageListItem {
   id: string;
   route: string;
@@ -281,6 +293,12 @@ interface AnalyticsPageParams {
   startDate?: string;
   endDate?: string;
 }
+interface SkillLocalizationResponse {
+  id: string;
+  locale_id: string;
+  name: string;
+  description: string | null;
+}
 interface SkillResponse {
   id: string;
   name: string;
@@ -288,6 +306,19 @@ interface SkillResponse {
   category: SkillCategory | null;
   icon: string | null;
   proficiency_level: number | null;
+  /**
+   * Per-locale display names. Empty array when no localizations exist
+   * (never null / missing). Clients pick the matching locale and fall
+   * back per their own rules.
+   */
+  localizations: SkillLocalizationResponse[];
+}
+interface CvEntryLocalizationResponse {
+  id: string;
+  locale_id: string;
+  position: string;
+  description: string | null;
+  achievements: unknown | null;
 }
 interface CvEntryResponse {
   id: string;
@@ -302,9 +333,52 @@ interface CvEntryResponse {
   display_order: number;
   created_at: string;
   updated_at: string;
+  /**
+   * Per-locale position + description. Empty array when no localizations
+   * exist (never null / missing).
+   */
+  localizations: CvEntryLocalizationResponse[];
+  /**
+   * Skill IDs linked to this CV entry. Empty array when no skills are
+   * linked (never null / missing).
+   */
+  skill_ids: string[];
+}
+/** Pagination, search, and locale-resolver params for skill listings. */
+interface SkillListParams extends SearchablePaginationParams {
+  /**
+   * Optional locale code (e.g. `"en"`). When set, each skill's
+   * `localizations` array collapses to one entry resolved by the server's
+   * fallback chain. See ADR 0002.
+   */
+  locale?: string;
+}
+/** Options for skill detail lookups (`getSkill`, `getSkillBySlug`). */
+interface SkillDetailParams {
+  /**
+   * Optional locale code. When set, `localizations` collapses to one
+   * resolved entry. See ADR 0002.
+   */
+  locale?: string;
 }
 interface CvEntryParams extends SearchablePaginationParams {
   entryType?: CvEntryType;
+  /**
+   * Optional locale code (e.g. `"en"`, `"de-AT"`). When set, each entry's
+   * `localizations` array collapses to one entry resolved by the server's
+   * fallback chain. Omit to receive every localization.
+   *
+   * See ADR 0002 (`docs/adr/0002-locale-resolver.md`).
+   */
+  locale?: string;
+}
+/** Options for CV-entry detail lookups (`getEntry`). */
+interface CvEntryDetailParams {
+  /**
+   * Optional locale code. When set, `localizations` collapses to one
+   * resolved entry. See ADR 0002.
+   */
+  locale?: string;
 }
 interface LegalDocumentResponse {
   id: string;
@@ -327,6 +401,19 @@ interface LegalDocumentDetailResponse {
   created_at: string;
   updated_at: string;
 }
+/**
+ * Options for legal-document detail lookups (`getBySlug`, `getDetail`).
+ * The list shape (`LegalDocumentResponse`) does not yet carry
+ * `localizations[]` — tracked separately.
+ */
+interface LegalDetailParams {
+  /**
+   * Optional locale code (e.g. `"en"`). When set, `localizations[]`
+   * (and `doc_localizations[]` on the full-detail endpoint) collapses
+   * to one resolved entry. See ADR 0002.
+   */
+  locale?: string;
+}
 interface LegalGroupResponse {
   id: string;
   cookie_name: string;
@@ -410,7 +497,16 @@ interface SocialLinkResponse {
 }
 /** Link type for project resources (repository, demo, docs, etc.). */
 type ProjectLinkType = 'repository' | 'demo' | 'documentation' | 'website' | 'other';
-/** Project summary for list views. */
+/** Localized content for a project. */
+interface ProjectLocalizationResponse {
+  id: string;
+  locale_id: string;
+  title: string;
+  short_description: string | null;
+  description: string | null;
+}
+/** Project summary for list views. Always carries `localizations` — empty
+ *  array when the project has none, never `null` or missing. */
 interface ProjectResponse {
   id: string;
   slug: string;
@@ -423,14 +519,9 @@ interface ProjectResponse {
   published_at: string | null;
   created_at: string;
   updated_at: string;
-}
-/** Localized content for a project. */
-interface ProjectLocalizationResponse {
-  id: string;
-  locale_id: string;
-  title: string;
-  short_description: string | null;
-  description: string | null;
+  /** Skill IDs linked to the project. Always present — empty array when none. */
+  skill_ids: string[];
+  localizations: ProjectLocalizationResponse[];
 }
 /** External link attached to a project. */
 interface ProjectLinkResponse {
@@ -447,12 +538,11 @@ interface ProjectMediaResponse {
   display_order: number;
   is_cover: boolean;
 }
-/** Full project detail including localizations, links, and media. */
+/** Full project detail. Inherits `skill_ids` and `localizations` from
+ *  {@link ProjectResponse}; adds links, media, and relation id sets. */
 interface ProjectDetailResponse extends ProjectResponse {
-  localizations: ProjectLocalizationResponse[];
   links: ProjectLinkResponse[];
   media: ProjectMediaResponse[];
-  skill_ids: string[];
   cv_entry_ids: string[];
 }
 /** Pagination and filter params for project listings. */
@@ -463,33 +553,79 @@ interface ProjectListParams extends PaginationParams {
   sortDir?: 'asc' | 'desc';
   /** Filter to featured projects only. */
   isFeatured?: boolean;
+  /**
+   * Optional locale code (e.g. `"en"`, `"de-AT"`). When set, each project's
+   * `localizations` array collapses to one entry resolved by the server's
+   * fallback chain (requested → site default → first available). Omit to
+   * receive every localization, which is the existing default.
+   *
+   * See ADR 0002 (`docs/adr/0002-locale-resolver.md`).
+   */
+  locale?: string;
 }
+/** Options for project detail lookups (`get`, `getBySlug`). */
+interface ProjectDetailParams {
+  /**
+   * Optional locale code. When set, `localizations` collapses to one entry
+   * resolved by the server's fallback chain. See ADR 0002.
+   */
+  locale?: string;
+}
+/**
+ * The set of HTTP status codes a Forja redirect may use.
+ *
+ * Pinned by issue #743. The same domain is enforced server-side by the
+ * `validate_redirect_status_code` DTO validator and the
+ * `chk_redirect_status_code` DB CHECK constraint, so consumers may rely
+ * on this value without runtime coercion.
+ */
+type RedirectStatusCode = 301 | 302 | 307 | 308;
 /** A URL redirect rule. */
 interface RedirectResponse {
   id: string;
   site_id: string;
   source_path: string;
   destination_path: string;
-  status_code: number;
+  status_code: RedirectStatusCode;
   is_active: boolean;
   description: string | null;
   created_at: string;
   updated_at: string;
 }
-/** Result of a redirect path lookup. */
+/**
+ * Result of a redirect path lookup.
+ *
+ * Returned with HTTP 200 by `GET /sites/{site_id}/redirects/lookup` on
+ * match. No-match is signalled by **404** (RFC 7807 ProblemDetails) —
+ * never a 200 with a null body, never a `{ redirects: [] }` list.
+ */
 interface RedirectLookupResponse {
   destination_path: string;
-  status_code: number;
+  status_code: RedirectStatusCode;
 }
 /** A locale configured for a site. */
 interface SiteLocaleResponse {
+  /** Composite-key half #1 — which site this assignment belongs to. */
+  site_id: string;
+  /** Composite-key half #2 — which locale is attached. */
   locale_id: string;
+  /** BCP-47 code, denormalised from `locales.code`. */
   code: string;
+  /** English-language label, denormalised from `locales.name`. */
   name: string;
+  /** Locale's own name, denormalised from `locales.native_name`. */
   native_name: string | null;
   direction: 'ltr' | 'rtl';
+  /** Exactly one row per site has this set to `true`. */
   is_default: boolean;
+  /** Configured-but-not-served when `false`. Consumers usually filter to `true`. */
   is_active: boolean;
+  /**
+   * Path segment selecting this locale. `null` for the default locale
+   * (served at the site root without a prefix).
+   */
+  url_prefix: string | null;
+  created_at: string;
 }
 /** Media item summary for list views (lighter than full MediaResponse). */
 interface MediaListItem {
@@ -770,7 +906,7 @@ declare class BlogsResource {
    * }
    * ```
    */
-  getBySlug(slug: string): Promise<BlogDetailResponse | null>;
+  getBySlug(slug: string, params?: BlogDetailParams): Promise<BlogDetailResponse | null>;
   /**
    * Fetch a blog post's full detail by its UUID.
    *
@@ -784,7 +920,7 @@ declare class BlogsResource {
    * const blog = await forja.blogs.get('550e8400-e29b-41d4-a716-446655440000');
    * ```
    */
-  get(idOrSlug: string): Promise<BlogDetailResponse | null>;
+  get(idOrSlug: string, params?: BlogDetailParams): Promise<BlogDetailResponse | null>;
   /**
    * Fetch the site's RSS feed as raw XML.
    *
@@ -822,7 +958,7 @@ declare class CvResource {
    * const programming = skills.data.filter(s => s.category === 'Programming');
    * ```
    */
-  listSkills(params?: SearchablePaginationParams): Promise<PaginatedResult<SkillResponse>>;
+  listSkills(params?: SkillListParams): Promise<PaginatedResult<SkillResponse>>;
   /**
    * Fetch a skill by its UUID.
    *
@@ -831,7 +967,7 @@ declare class CvResource {
    * @param id - The skill's UUID.
    * @returns The skill, or `null` if not found.
    */
-  getSkill(id: string): Promise<SkillResponse | null>;
+  getSkill(id: string, params?: SkillDetailParams): Promise<SkillResponse | null>;
   /**
    * Fetch a skill by its URL slug.
    *
@@ -846,7 +982,7 @@ declare class CvResource {
    * if (ts) console.log(`${ts.name}: level ${ts.proficiency_level}`);
    * ```
    */
-  getSkillBySlug(slug: string): Promise<SkillResponse | null>;
+  getSkillBySlug(slug: string, params?: SkillDetailParams): Promise<SkillResponse | null>;
   /**
    * Fetch a paginated list of CV entries (work, education, certifications, etc.).
    *
@@ -863,6 +999,25 @@ declare class CvResource {
    * ```
    */
   listEntries(params?: CvEntryParams): Promise<PaginatedResult<CvEntryResponse>>;
+  /**
+   * Fetch a CV entry by its UUID.
+   *
+   * **Endpoint:** `GET /cv/{id}`
+   *
+   * @param id - The CV entry's UUID.
+   * @param params - Optional locale resolver per ADR 0002.
+   * @returns The CV entry, or `null` if not found.
+   *
+   * @example
+   * ```ts
+   * // All localizations (default)
+   * const entry = await forja.cv.getEntry('entry-uuid');
+   *
+   * // Single-locale collapse
+   * const enEntry = await forja.cv.getEntry('entry-uuid', { locale: 'en' });
+   * ```
+   */
+  getEntry(id: string, params?: CvEntryDetailParams): Promise<CvEntryResponse | null>;
 }
 //#endregion
 //#region src/resources/forms.d.ts
@@ -1029,7 +1184,7 @@ declare class LegalResource {
    * }
    * ```
    */
-  getBySlug(slug: string): Promise<LegalDocumentDetailResponse | null>;
+  getBySlug(slug: string, params?: LegalDetailParams): Promise<LegalDocumentDetailResponse | null>;
   /**
    * Fetch the cookie consent document with its consent groups and items.
    *
@@ -1093,7 +1248,7 @@ declare class LegalResource {
    * }
    * ```
    */
-  getDetail(id: string): Promise<LegalDocumentFullDetailResponse | null>;
+  getDetail(id: string, params?: LegalDetailParams): Promise<LegalDocumentFullDetailResponse | null>;
   /**
    * Fetch the version history of a legal document.
    *
@@ -1291,6 +1446,19 @@ interface PageListParams extends SearchablePaginationParams {
   /** Exclude pages with this status. */
   excludeStatus?: string;
 }
+/**
+ * Options for page-detail lookups (`getDetail`). The list shape
+ * (`PageResponse`) does not carry `localizations[]` today — adding it is
+ * tracked as a separate canonicalization gap; until then the resolver
+ * applies only to the detail endpoint.
+ */
+interface PageDetailParams {
+  /**
+   * Optional locale code (e.g. `"en"`). When set, `localizations[]`
+   * collapses to one resolved entry. See ADR 0002.
+   */
+  locale?: string;
+}
 /**
  * CMS page operations.
  *
@@ -1337,6 +1505,25 @@ declare class PagesResource {
    * ```
    */
   getByRoute(route: string): Promise<PageDetailResponse | null>;
+  /**
+   * Fetch a page's full detail (content localizations + computed OG image).
+   *
+   * **Endpoint:** `GET /pages/{id}/detail`
+   *
+   * @param id - The page's UUID.
+   * @param params - Optional locale resolver (ADR 0002).
+   * @returns The page detail, or `null` if not found.
+   *
+   * @example
+   * ```ts
+   * // Every localization (admin/editor use case)
+   * const detail = await forja.pages.getDetail('page-uuid');
+   *
+   * // Server-side rendering — single locale
+   * const en = await forja.pages.getDetail('page-uuid', { locale: 'en' });
+   * ```
+   */
+  getDetail(id: string, params?: PageDetailParams): Promise<PageDetailResponse | null>;
   /**
    * Fetch all sections for a page.
    *
@@ -1438,7 +1625,7 @@ declare class ProjectsResource {
    * }
    * ```
    */
-  get(id: string): Promise<ProjectDetailResponse | null>;
+  get(id: string, params?: ProjectDetailParams): Promise<ProjectDetailResponse | null>;
   /**
    * Fetch a project by its URL slug.
    *
@@ -1452,7 +1639,7 @@ declare class ProjectsResource {
    * const project = await forja.projects.getBySlug('forja-cms');
    * ```
    */
-  getBySlug(slug: string): Promise<ProjectResponse | null>;
+  getBySlug(slug: string, params?: ProjectDetailParams): Promise<ProjectResponse | null>;
 }
 //#endregion
 //#region src/resources/redirects.d.ts

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./client-FailsuXv.cjs`);function t(e){return{head:e.code_injection_head,footer:e.code_injection_footer}}exports.ForjaAuthError=e.r,exports.ForjaClient=e.t,exports.ForjaError=e.i,exports.ForjaNetworkError=e.a,exports.ForjaNotFoundError=e.o,exports.ForjaPermissionError=e.s,exports.ForjaRateLimitError=e.c,exports.ForjaServerError=e.l,exports.ForjaValidationError=e.u,exports.renderCodeInjection=t,exports.validateSubmission=e.n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./client-DVY5u6LJ.cjs`);function t(e){return{head:e.code_injection_head,footer:e.code_injection_footer}}exports.ForjaAuthError=e.r,exports.ForjaClient=e.t,exports.ForjaError=e.i,exports.ForjaNetworkError=e.a,exports.ForjaNotFoundError=e.o,exports.ForjaPermissionError=e.s,exports.ForjaRateLimitError=e.c,exports.ForjaServerError=e.l,exports.ForjaValidationError=e.u,exports.renderCodeInjection=t,exports.validateSubmission=e.n;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { $ as NavigationTree, A as CvEntryResponse, At as TranslationStatus, B as LegalGroupResponse, C as BlogResponse, Ct as SkillCategory, D as CodeInjection, Dt as TopContentItem, E as CategoryWithCountResponse, Et as TagResponse, F as LegalDocType, G as LocalizationResponse, H as LegalItemResponse, I as LegalDocumentDetailResponse, J as MediaResponse, K as MediaListItem, L as LegalDocumentFullDetailResponse, M as DocumentLocalizationResponse, N as ForjaClientConfig, O as ContentStatus, Ot as TrackPageviewRequest, P as LegalDocLocalizationResponse, Q as NavigationMenuResponse, R as LegalDocumentResponse, S as BlogListItem, St as SiteResponse, T as CategoryTree, Tt as SocialLinkResponse, U as LegalVersionResponse, V as LegalGroupWithItems, W as LocaleFilterParams, X as NavigationItemLocalizationResponse, Y as MediaVariantResponse, Z as NavigationItemResponse, _ as AnalyticsPageParams, _t as ReferrerItem, a as FormFieldValidation, at as Paginated, b as BlogDetailResponse, bt as SectionType, c as PublicFormDefinition, ct as ProjectDetailResponse, d as SubmitFormOptions, dt as ProjectListParams, et as PageDetailResponse, f as ValidationErrorMap, ft as ProjectLocalizationResponse, g as AnalyticsPageDetailResponse, gt as RedirectResponse, h as PaginatedResult, ht as RedirectLookupResponse, i as FormFieldType, it as PageType, j as CvEntryType, jt as TrendDataPoint, k as CvEntryParams, kt as TrackPageviewResponse, l as SelfServiceLookup, lt as ProjectLinkResponse, m as HttpClient, mt as ProjectResponse, n as FormBotProtection, nt as PageResponse, o as FormSubmitData, ot as PaginationMeta, p as validateSubmission, pt as ProjectMediaResponse, q as MediaListParams, r as FormFieldDefinition, rt as PageSectionResponse, s as FormSubmitResponse, st as PaginationParams, t as ForjaClient, tt as PageListItem, u as SelfServiceSubmission, ut as ProjectLinkType, v as AnalyticsReportParams, vt as SearchablePaginationParams, w as CategoryResponse, wt as SkillResponse, x as BlogDocumentResponse, xt as SiteLocaleResponse, y as AnalyticsReportResponse, yt as SectionLocalizationResponse, z as LegalDocumentWithGroups } from "./client-CvbFQ08l.cjs";
+import { $ as NavigationTree, A as CvEntryResponse, At as TranslationStatus, B as LegalGroupResponse, C as BlogResponse, Ct as SkillCategory, D as CodeInjection, Dt as TopContentItem, E as CategoryWithCountResponse, Et as TagResponse, F as LegalDocType, G as LocalizationResponse, H as LegalItemResponse, I as LegalDocumentDetailResponse, J as MediaResponse, K as MediaListItem, L as LegalDocumentFullDetailResponse, M as DocumentLocalizationResponse, N as ForjaClientConfig, O as ContentStatus, Ot as TrackPageviewRequest, P as LegalDocLocalizationResponse, Q as NavigationMenuResponse, R as LegalDocumentResponse, S as BlogListItem, St as SiteResponse, T as CategoryTree, Tt as SocialLinkResponse, U as LegalVersionResponse, V as LegalGroupWithItems, W as LocaleFilterParams, X as NavigationItemLocalizationResponse, Y as MediaVariantResponse, Z as NavigationItemResponse, _ as AnalyticsPageParams, _t as ReferrerItem, a as FormFieldValidation, at as Paginated, b as BlogDetailResponse, bt as SectionType, c as PublicFormDefinition, ct as ProjectDetailResponse, d as SubmitFormOptions, dt as ProjectListParams, et as PageDetailResponse, f as ValidationErrorMap, ft as ProjectLocalizationResponse, g as AnalyticsPageDetailResponse, gt as RedirectResponse, h as PaginatedResult, ht as RedirectLookupResponse, i as FormFieldType, it as PageType, j as CvEntryType, jt as TrendDataPoint, k as CvEntryParams, kt as TrackPageviewResponse, l as SelfServiceLookup, lt as ProjectLinkResponse, m as HttpClient, mt as ProjectResponse, n as FormBotProtection, nt as PageResponse, o as FormSubmitData, ot as PaginationMeta, p as validateSubmission, pt as ProjectMediaResponse, q as MediaListParams, r as FormFieldDefinition, rt as PageSectionResponse, s as FormSubmitResponse, st as PaginationParams, t as ForjaClient, tt as PageListItem, u as SelfServiceSubmission, ut as ProjectLinkType, v as AnalyticsReportParams, vt as SearchablePaginationParams, w as CategoryResponse, wt as SkillResponse, x as BlogDocumentResponse, xt as SiteLocaleResponse, y as AnalyticsReportResponse, yt as SectionLocalizationResponse, z as LegalDocumentWithGroups } from "./client-CUbs1rkJ.cjs";
 
 //#region src/code-injection.d.ts
 /**

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as NavigationTree, A as CvEntryResponse, At as TranslationStatus, B as LegalGroupResponse, C as BlogResponse, Ct as SkillCategory, D as CodeInjection, Dt as TopContentItem, E as CategoryWithCountResponse, Et as TagResponse, F as LegalDocType, G as LocalizationResponse, H as LegalItemResponse, I as LegalDocumentDetailResponse, J as MediaResponse, K as MediaListItem, L as LegalDocumentFullDetailResponse, M as DocumentLocalizationResponse, N as ForjaClientConfig, O as ContentStatus, Ot as TrackPageviewRequest, P as LegalDocLocalizationResponse, Q as NavigationMenuResponse, R as LegalDocumentResponse, S as BlogListItem, St as SiteResponse, T as CategoryTree, Tt as SocialLinkResponse, U as LegalVersionResponse, V as LegalGroupWithItems, W as LocaleFilterParams, X as NavigationItemLocalizationResponse, Y as MediaVariantResponse, Z as NavigationItemResponse, _ as AnalyticsPageParams, _t as ReferrerItem, a as FormFieldValidation, at as Paginated, b as BlogDetailResponse, bt as SectionType, c as PublicFormDefinition, ct as ProjectDetailResponse, d as SubmitFormOptions, dt as ProjectListParams, et as PageDetailResponse, f as ValidationErrorMap, ft as ProjectLocalizationResponse, g as AnalyticsPageDetailResponse, gt as RedirectResponse, h as PaginatedResult, ht as RedirectLookupResponse, i as FormFieldType, it as PageType, j as CvEntryType, jt as TrendDataPoint, k as CvEntryParams, kt as TrackPageviewResponse, l as SelfServiceLookup, lt as ProjectLinkResponse, m as HttpClient, mt as ProjectResponse, n as FormBotProtection, nt as PageResponse, o as FormSubmitData, ot as PaginationMeta, p as validateSubmission, pt as ProjectMediaResponse, q as MediaListParams, r as FormFieldDefinition, rt as PageSectionResponse, s as FormSubmitResponse, st as PaginationParams, t as ForjaClient, tt as PageListItem, u as SelfServiceSubmission, ut as ProjectLinkType, v as AnalyticsReportParams, vt as SearchablePaginationParams, w as CategoryResponse, wt as SkillResponse, x as BlogDocumentResponse, xt as SiteLocaleResponse, y as AnalyticsReportResponse, yt as SectionLocalizationResponse, z as LegalDocumentWithGroups } from "./client-BTbTifpr.mjs";
+import { $ as NavigationTree, A as CvEntryResponse, At as TranslationStatus, B as LegalGroupResponse, C as BlogResponse, Ct as SkillCategory, D as CodeInjection, Dt as TopContentItem, E as CategoryWithCountResponse, Et as TagResponse, F as LegalDocType, G as LocalizationResponse, H as LegalItemResponse, I as LegalDocumentDetailResponse, J as MediaResponse, K as MediaListItem, L as LegalDocumentFullDetailResponse, M as DocumentLocalizationResponse, N as ForjaClientConfig, O as ContentStatus, Ot as TrackPageviewRequest, P as LegalDocLocalizationResponse, Q as NavigationMenuResponse, R as LegalDocumentResponse, S as BlogListItem, St as SiteResponse, T as CategoryTree, Tt as SocialLinkResponse, U as LegalVersionResponse, V as LegalGroupWithItems, W as LocaleFilterParams, X as NavigationItemLocalizationResponse, Y as MediaVariantResponse, Z as NavigationItemResponse, _ as AnalyticsPageParams, _t as ReferrerItem, a as FormFieldValidation, at as Paginated, b as BlogDetailResponse, bt as SectionType, c as PublicFormDefinition, ct as ProjectDetailResponse, d as SubmitFormOptions, dt as ProjectListParams, et as PageDetailResponse, f as ValidationErrorMap, ft as ProjectLocalizationResponse, g as AnalyticsPageDetailResponse, gt as RedirectResponse, h as PaginatedResult, ht as RedirectLookupResponse, i as FormFieldType, it as PageType, j as CvEntryType, jt as TrendDataPoint, k as CvEntryParams, kt as TrackPageviewResponse, l as SelfServiceLookup, lt as ProjectLinkResponse, m as HttpClient, mt as ProjectResponse, n as FormBotProtection, nt as PageResponse, o as FormSubmitData, ot as PaginationMeta, p as validateSubmission, pt as ProjectMediaResponse, q as MediaListParams, r as FormFieldDefinition, rt as PageSectionResponse, s as FormSubmitResponse, st as PaginationParams, t as ForjaClient, tt as PageListItem, u as SelfServiceSubmission, ut as ProjectLinkType, v as AnalyticsReportParams, vt as SearchablePaginationParams, w as CategoryResponse, wt as SkillResponse, x as BlogDocumentResponse, xt as SiteLocaleResponse, y as AnalyticsReportResponse, yt as SectionLocalizationResponse, z as LegalDocumentWithGroups } from "./client-HGIKi26O.mjs";
 
 //#region src/code-injection.d.ts
 /**

package/dist/index.mjs

@@ -1 +1 @@
-import{a as e,c as t,i as n,l as r,n as i,o as a,r as o,s,t as c,u as l}from"./client-C-2JZF6o.mjs";function u(e){return{head:e.code_injection_head,footer:e.code_injection_footer}}export{o as ForjaAuthError,c as ForjaClient,n as ForjaError,e as ForjaNetworkError,a as ForjaNotFoundError,s as ForjaPermissionError,t as ForjaRateLimitError,r as ForjaServerError,l as ForjaValidationError,u as renderCodeInjection,i as validateSubmission};
+import{a as e,c as t,i as n,l as r,n as i,o as a,r as o,s,t as c,u as l}from"./client-CWajZ1IX.mjs";function u(e){return{head:e.code_injection_head,footer:e.code_injection_footer}}export{o as ForjaAuthError,c as ForjaClient,n as ForjaError,e as ForjaNetworkError,a as ForjaNotFoundError,s as ForjaPermissionError,t as ForjaRateLimitError,r as ForjaServerError,l as ForjaValidationError,u as renderCodeInjection,i as validateSubmission};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forjacms/client",
-  "version": "1.7.0",
+  "version": "1.7.3",
   "description": "Typed TypeScript SDK for the Forja CMS content API",
   "author": "Dominik Dorfstetter <dominik@dorfstetter.at>",
   "main": "dist/index.cjs",
@@ -66,7 +66,7 @@
     "@angular/core": "^21.2.9",
     "@vitest/coverage-v8": "^4.0.18",
     "rxjs": "^7.8.2",
-    "tsdown": "^0.21.4",
+    "tsdown": "^0.22.0",
     "typescript": "^6.0.2",
     "vitest": "^4.0.18",
     "zone.js": "^0.16.1"

package/dist/client-C-2JZF6o.mjs

@@ -1 +0,0 @@
-var e=class extends Error{constructor(e,t){super(e),this.code=t,this.name=`ForjaError`}},t=class extends e{constructor(e=`Invalid or missing API key`){super(e,`AUTH_ERROR`),this.name=`ForjaAuthError`}},n=class extends e{constructor(e=`Insufficient permissions`){super(e,`PERMISSION_ERROR`),this.name=`ForjaPermissionError`}},r=class extends e{constructor(e=`Resource not found`){super(e,`NOT_FOUND`),this.name=`ForjaNotFoundError`}},i=class extends e{constructor(e=`Rate limit exceeded`,t){super(e,`RATE_LIMIT`),this.retryAfter=t,this.name=`ForjaRateLimitError`}},a=class extends e{constructor(e=`Validation error`,t){super(e,`VALIDATION_ERROR`),this.details=t,this.name=`ForjaValidationError`}},o=class extends e{constructor(e=`Internal server error`,t=500){super(e,`SERVER_ERROR`),this.status=t,this.name=`ForjaServerError`}},s=class extends e{constructor(e=`Network error`,t){super(e,`NETWORK_ERROR`),this.cause=t,this.name=`ForjaNetworkError`}};function c(e,t,n){let r=e.replace(/\/+$/,``),i=t.startsWith(`/`)?t:`/${t}`,a=new URL(`${r}${i}`);if(n)for(let[e,t]of Object.entries(n))t!==void 0&&a.searchParams.set(e,t);return a.toString()}function l(e){let t={};for(let[n,r]of Object.entries(e))r!=null&&(t[u(n)]=String(r));return t}function u(e){return e.replace(/[A-Z]/g,e=>`_${e.toLowerCase()}`)}async function d(e){let s;try{let t=await e.json();s=t.detail||t.message||t.title||e.statusText}catch{s=e.statusText}switch(e.status){case 401:throw new t(s);case 403:throw new n(s);case 404:throw new r(s);case 422:throw new a(s);case 429:{let t=e.headers.get(`retry-after`);throw new i(s,t?parseInt(t,10):void 0)}default:throw e.status,new o(s,e.status)}}function f(e){let t=e.fetch??globalThis.fetch,n=e.baseUrl.replace(/\/+$/,``),r={"X-API-Key":e.apiKey,"Content-Type":`application/json`};e.siteDomain&&(r[`X-Site-Domain`]=e.siteDomain);async function i(e,i,a,o){let l=c(n,i,a),u;try{u=await t(l,{method:e,headers:r,body:o===void 0?void 0:JSON.stringify(o)})}catch(e){throw new s(`Failed to connect to the Forja API`,e instanceof Error?e:void 0)}return u.ok?u:d(u)}return{get:(e,t)=>i(`GET`,e,t).then(e=>e.json()),getText:(e,t)=>i(`GET`,e,t).then(e=>e.text()),post:(e,t)=>i(`POST`,e,void 0,t).then(e=>e.json()),delete:e=>i(`DELETE`,e).then(()=>void 0)}}function p(e,t,n){return{data:e,meta:t,async fetchNext(){if(t.page>=t.total_pages)return null;let e=await n(t.page+1);return p(e.data,e.meta,n)},async fetchAll(){let r=[...e],i=t.page;for(;i<t.total_pages;){i++;let e=await n(i);r.push(...e.data)}return r},async*[Symbol.asyncIterator](){yield{data:e,meta:t};let r=t.page;for(;r<t.total_pages;)r++,yield await n(r)}}}var m=class{constructor(e,t){this.http=e,this.siteId=t}async trackPageview(e){return this.http.post(`/sites/${this.siteId}/analytics/pageview`,e)}async getReport(e){let t=e?l({days:e.days,top_n:e.topN,start_date:e.startDate,end_date:e.endDate}):void 0;return this.http.get(`/sites/${this.siteId}/analytics/report`,t)}async getPageAnalytics(e){let t=l({path:e.path,days:e.days,start_date:e.startDate,end_date:e.endDate});return this.http.get(`/sites/${this.siteId}/analytics/report/page`,t)}},h=class{constructor(e,t){this.http=e,this.siteId=t}async listPublished(e){let t=e?l(e):void 0,n=e?.localeId?{locale_id:e.localeId}:{},r=async e=>this.http.get(`/sites/${this.siteId}/blogs/published`,{...t,...n,page:String(e)}),i=await r(e?.page??1);return p(i.data,i.meta,r)}async listByCategory(e,t){let n=t?l(t):void 0,r=t?.localeId?{locale_id:t.localeId}:{},i=async t=>this.http.get(`/sites/${this.siteId}/blogs/published/category/${encodeURIComponent(e)}`,{...n,...r,page:String(t)}),a=await i(t?.page??1);return p(a.data,a.meta,i)}async listFeatured(e){return this.http.get(`/sites/${this.siteId}/blogs/featured`,e?.limit===void 0?void 0:{limit:String(e.limit)})}async listSimilar(e,t){return this.http.get(`/sites/${this.siteId}/blogs/${encodeURIComponent(e)}/similar`,t?.limit===void 0?void 0:{limit:String(t.limit)})}async getBySlug(e){try{let t=await this.http.get(`/sites/${this.siteId}/blogs/by-slug/${encodeURIComponent(e)}`);return await this.http.get(`/blogs/${t.id}/detail`)}catch(e){if(e instanceof r)return null;throw e}}async get(e){try{return await this.http.get(`/blogs/${encodeURIComponent(e)}/detail`)}catch(e){if(e instanceof r)return null;throw e}}async rss(){return this.http.getText(`/sites/${this.siteId}/feed.rss`)}},g=class{constructor(e,t){this.http=e,this.siteId=t}async listSkills(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/skills`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async getSkill(e){try{return await this.http.get(`/skills/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getSkillBySlug(e){try{return await this.http.get(`/skills/by-slug/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async listEntries(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/cv`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}},_=class{constructor(e){this.http=e}async getForm(e,t){let n=t?.locale?{locale:t.locale}:void 0;return this.http.get(`/public/forms/${encodeURIComponent(e)}`,n)}async submitForm(e,t,n={}){return this.http.post(`/public/forms/${encodeURIComponent(e)}/submit`,{data:t,consent_given:n.consentGiven??!1,bot_protection_token:n.botProtectionToken})}async lookupSubmission(e){return this.http.post(`/public/submissions/lookup`,{reference_code:e})}async getSubmission(e){return this.http.get(`/public/submissions/${encodeURIComponent(e)}`)}async deleteSubmission(e){return this.http.delete(`/public/submissions/${encodeURIComponent(e)}`)}};const v=/^[A-Za-z0-9._%+\-]+@[A-Za-z0-9.\-]+\.[A-Za-z]{2,}$/;function y(e,t){let n={};for(let r of e.fields){let e=t[r.label],i=b(r,e);i&&(n[r.label]=i)}return n}function b(e,t){let n=t,r=n==null||typeof n==`string`&&n===``||Array.isArray(n)&&n.length===0;if((e.is_required||e.validation.required)&&r)return`${e.label} is required`;if(r)return null;switch(e.field_type){case`text`:case`textarea`:case`custom`:if(typeof n!=`string`)return`Must be a string`;if(e.validation.min_length!==void 0&&n.length<e.validation.min_length)return`Must be at least ${e.validation.min_length} characters`;if(e.validation.max_length!==void 0&&n.length>e.validation.max_length)return`Must be at most ${e.validation.max_length} characters`;if(e.validation.pattern)try{if(!new RegExp(e.validation.pattern).test(n))return`Value does not match the required pattern`}catch{return`Field has an invalid validation pattern`}return null;case`email`:return typeof n==`string`?v.test(n)?null:`Invalid email format`:`Must be a string`;case`number`:{let t=typeof n==`number`?n:Number(n);return Number.isNaN(t)?`Must be a number`:e.validation.min!==void 0&&t<e.validation.min?`Must be at least ${e.validation.min}`:e.validation.max!==void 0&&t>e.validation.max?`Must be at most ${e.validation.max}`:null}case`date`:return typeof n!=`string`||Number.isNaN(Date.parse(n))&&!/^\d{4}-\d{2}-\d{2}$/.test(n)?`Invalid date format`:null;case`select`:case`radio`:case`checkbox`:return null}}var x=class{constructor(e,t){this.http=e,this.siteId=t}async list(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/legal`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async get(e){try{return await this.http.get(`/legal/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getBySlug(e){try{return await this.http.get(`/sites/${this.siteId}/legal/by-slug/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getCookieConsent(){try{return await this.http.get(`/sites/${this.siteId}/legal/cookie-consent`)}catch(e){if(e instanceof r)return null;throw e}}async getGroups(e){return this.http.get(`/legal/${encodeURIComponent(e)}/groups`)}async getGroupItems(e){return this.http.get(`/legal/groups/${encodeURIComponent(e)}/items`)}async getDetail(e){try{return await this.http.get(`/legal/${encodeURIComponent(e)}/detail`)}catch(e){if(e instanceof r)return null;throw e}}async listVersions(e){return this.http.get(`/legal/${encodeURIComponent(e)}/versions`)}},S=class{constructor(e,t){this.http=e,this.siteId=t}async list(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/media`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async get(e){try{return await this.http.get(`/media/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}},C=class{constructor(e,t){this.http=e,this.siteId=t}async listMenus(){return this.http.get(`/sites/${this.siteId}/menus`)}async getMenu(e){try{return await this.http.get(`/menus/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getMenuBySlug(e){try{return await this.http.get(`/sites/${this.siteId}/menus/slug/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getTree(e,t){return this.http.get(`/menus/${encodeURIComponent(e)}/tree`,t?.locale?{locale:t.locale}:void 0)}async listItems(e){return this.http.get(`/menus/${encodeURIComponent(e)}/items`)}async getItem(e){try{return await this.http.get(`/navigation/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}},w=class{constructor(e,t){this.http=e,this.siteId=t}async list(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/pages`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async getByRoute(e){let t=e.startsWith(`/`)?e.slice(1):e;try{return await this.http.get(`/sites/${this.siteId}/pages/by-route/${encodeURIComponent(t)}`)}catch(e){if(e instanceof r)return null;throw e}}async getSections(e){return this.http.get(`/pages/${encodeURIComponent(e)}/sections`)}async getSectionLocalizations(e){return this.http.get(`/pages/sections/${encodeURIComponent(e)}/localizations`)}async getPageSectionLocalizations(e){return this.http.get(`/pages/${encodeURIComponent(e)}/sections/localizations`)}},T=class{constructor(e,t){this.http=e,this.siteId=t}async listPublished(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/projects/public`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async get(e){try{return await this.http.get(`/projects/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getBySlug(e){try{return await this.http.get(`/sites/${this.siteId}/projects/by-slug/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}},E=class{constructor(e,t){this.http=e,this.siteId=t}async lookup(e){try{return await this.http.get(`/sites/${this.siteId}/redirects/lookup`,{path:e})}catch(e){if(e instanceof r)return null;throw e}}},D=class{constructor(e,t){this.http=e,this.siteId=t}async get(){return this.http.get(`/sites/${this.siteId}`)}async listLocales(){return this.http.get(`/sites/${this.siteId}/locales`)}async getCodeInjection(){let e=await this.http.get(`/sites/${this.siteId}/settings`);return{code_injection_head:e.code_injection_head??``,code_injection_footer:e.code_injection_footer??``}}},O=class{constructor(e,t){this.http=e,this.siteId=t}async list(){return this.http.get(`/sites/${this.siteId}/social`)}},k=class{constructor(e,t){this.http=e,this.siteId=t}async listTags(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/tags`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async listCategories(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/categories`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async getCategoriesWithBlogCounts(){return this.http.get(`/sites/${this.siteId}/categories/blog-counts`)}async getContentTags(e){return this.http.get(`/content/${encodeURIComponent(e)}/tags`)}async getContentCategories(e){return this.http.get(`/content/${encodeURIComponent(e)}/categories`)}async getTag(e){try{return await this.http.get(`/tags/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getTagBySlug(e){try{return await this.http.get(`/tags/by-slug/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getCategory(e){try{return await this.http.get(`/categories/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getCategoryChildren(e){return this.http.get(`/categories/${encodeURIComponent(e)}/children`)}},A=class{constructor(e){let t=f(e);this.blogs=new h(t,e.siteId),this.pages=new w(t,e.siteId),this.navigation=new C(t,e.siteId),this.taxonomy=new k(t,e.siteId),this.analytics=new m(t,e.siteId),this.cv=new g(t,e.siteId),this.legal=new x(t,e.siteId),this.projects=new T(t,e.siteId),this.redirects=new E(t,e.siteId),this.site=new D(t,e.siteId),this.media=new S(t,e.siteId),this.social=new O(t,e.siteId),this.forms=new _(t)}};export{s as a,i as c,e as i,o as l,y as n,r as o,t as r,n as s,A as t,a as u};

package/dist/client-FailsuXv.cjs

@@ -1 +0,0 @@
-var e=class extends Error{constructor(e,t){super(e),this.code=t,this.name=`ForjaError`}},t=class extends e{constructor(e=`Invalid or missing API key`){super(e,`AUTH_ERROR`),this.name=`ForjaAuthError`}},n=class extends e{constructor(e=`Insufficient permissions`){super(e,`PERMISSION_ERROR`),this.name=`ForjaPermissionError`}},r=class extends e{constructor(e=`Resource not found`){super(e,`NOT_FOUND`),this.name=`ForjaNotFoundError`}},i=class extends e{constructor(e=`Rate limit exceeded`,t){super(e,`RATE_LIMIT`),this.retryAfter=t,this.name=`ForjaRateLimitError`}},a=class extends e{constructor(e=`Validation error`,t){super(e,`VALIDATION_ERROR`),this.details=t,this.name=`ForjaValidationError`}},o=class extends e{constructor(e=`Internal server error`,t=500){super(e,`SERVER_ERROR`),this.status=t,this.name=`ForjaServerError`}},s=class extends e{constructor(e=`Network error`,t){super(e,`NETWORK_ERROR`),this.cause=t,this.name=`ForjaNetworkError`}};function c(e,t,n){let r=e.replace(/\/+$/,``),i=t.startsWith(`/`)?t:`/${t}`,a=new URL(`${r}${i}`);if(n)for(let[e,t]of Object.entries(n))t!==void 0&&a.searchParams.set(e,t);return a.toString()}function l(e){let t={};for(let[n,r]of Object.entries(e))r!=null&&(t[u(n)]=String(r));return t}function u(e){return e.replace(/[A-Z]/g,e=>`_${e.toLowerCase()}`)}async function d(e){let s;try{let t=await e.json();s=t.detail||t.message||t.title||e.statusText}catch{s=e.statusText}switch(e.status){case 401:throw new t(s);case 403:throw new n(s);case 404:throw new r(s);case 422:throw new a(s);case 429:{let t=e.headers.get(`retry-after`);throw new i(s,t?parseInt(t,10):void 0)}default:throw e.status,new o(s,e.status)}}function f(e){let t=e.fetch??globalThis.fetch,n=e.baseUrl.replace(/\/+$/,``),r={"X-API-Key":e.apiKey,"Content-Type":`application/json`};e.siteDomain&&(r[`X-Site-Domain`]=e.siteDomain);async function i(e,i,a,o){let l=c(n,i,a),u;try{u=await t(l,{method:e,headers:r,body:o===void 0?void 0:JSON.stringify(o)})}catch(e){throw new s(`Failed to connect to the Forja API`,e instanceof Error?e:void 0)}return u.ok?u:d(u)}return{get:(e,t)=>i(`GET`,e,t).then(e=>e.json()),getText:(e,t)=>i(`GET`,e,t).then(e=>e.text()),post:(e,t)=>i(`POST`,e,void 0,t).then(e=>e.json()),delete:e=>i(`DELETE`,e).then(()=>void 0)}}function p(e,t,n){return{data:e,meta:t,async fetchNext(){if(t.page>=t.total_pages)return null;let e=await n(t.page+1);return p(e.data,e.meta,n)},async fetchAll(){let r=[...e],i=t.page;for(;i<t.total_pages;){i++;let e=await n(i);r.push(...e.data)}return r},async*[Symbol.asyncIterator](){yield{data:e,meta:t};let r=t.page;for(;r<t.total_pages;)r++,yield await n(r)}}}var m=class{constructor(e,t){this.http=e,this.siteId=t}async trackPageview(e){return this.http.post(`/sites/${this.siteId}/analytics/pageview`,e)}async getReport(e){let t=e?l({days:e.days,top_n:e.topN,start_date:e.startDate,end_date:e.endDate}):void 0;return this.http.get(`/sites/${this.siteId}/analytics/report`,t)}async getPageAnalytics(e){let t=l({path:e.path,days:e.days,start_date:e.startDate,end_date:e.endDate});return this.http.get(`/sites/${this.siteId}/analytics/report/page`,t)}},h=class{constructor(e,t){this.http=e,this.siteId=t}async listPublished(e){let t=e?l(e):void 0,n=e?.localeId?{locale_id:e.localeId}:{},r=async e=>this.http.get(`/sites/${this.siteId}/blogs/published`,{...t,...n,page:String(e)}),i=await r(e?.page??1);return p(i.data,i.meta,r)}async listByCategory(e,t){let n=t?l(t):void 0,r=t?.localeId?{locale_id:t.localeId}:{},i=async t=>this.http.get(`/sites/${this.siteId}/blogs/published/category/${encodeURIComponent(e)}`,{...n,...r,page:String(t)}),a=await i(t?.page??1);return p(a.data,a.meta,i)}async listFeatured(e){return this.http.get(`/sites/${this.siteId}/blogs/featured`,e?.limit===void 0?void 0:{limit:String(e.limit)})}async listSimilar(e,t){return this.http.get(`/sites/${this.siteId}/blogs/${encodeURIComponent(e)}/similar`,t?.limit===void 0?void 0:{limit:String(t.limit)})}async getBySlug(e){try{let t=await this.http.get(`/sites/${this.siteId}/blogs/by-slug/${encodeURIComponent(e)}`);return await this.http.get(`/blogs/${t.id}/detail`)}catch(e){if(e instanceof r)return null;throw e}}async get(e){try{return await this.http.get(`/blogs/${encodeURIComponent(e)}/detail`)}catch(e){if(e instanceof r)return null;throw e}}async rss(){return this.http.getText(`/sites/${this.siteId}/feed.rss`)}},g=class{constructor(e,t){this.http=e,this.siteId=t}async listSkills(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/skills`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async getSkill(e){try{return await this.http.get(`/skills/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getSkillBySlug(e){try{return await this.http.get(`/skills/by-slug/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async listEntries(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/cv`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}},_=class{constructor(e){this.http=e}async getForm(e,t){let n=t?.locale?{locale:t.locale}:void 0;return this.http.get(`/public/forms/${encodeURIComponent(e)}`,n)}async submitForm(e,t,n={}){return this.http.post(`/public/forms/${encodeURIComponent(e)}/submit`,{data:t,consent_given:n.consentGiven??!1,bot_protection_token:n.botProtectionToken})}async lookupSubmission(e){return this.http.post(`/public/submissions/lookup`,{reference_code:e})}async getSubmission(e){return this.http.get(`/public/submissions/${encodeURIComponent(e)}`)}async deleteSubmission(e){return this.http.delete(`/public/submissions/${encodeURIComponent(e)}`)}};const v=/^[A-Za-z0-9._%+\-]+@[A-Za-z0-9.\-]+\.[A-Za-z]{2,}$/;function y(e,t){let n={};for(let r of e.fields){let e=t[r.label],i=b(r,e);i&&(n[r.label]=i)}return n}function b(e,t){let n=t,r=n==null||typeof n==`string`&&n===``||Array.isArray(n)&&n.length===0;if((e.is_required||e.validation.required)&&r)return`${e.label} is required`;if(r)return null;switch(e.field_type){case`text`:case`textarea`:case`custom`:if(typeof n!=`string`)return`Must be a string`;if(e.validation.min_length!==void 0&&n.length<e.validation.min_length)return`Must be at least ${e.validation.min_length} characters`;if(e.validation.max_length!==void 0&&n.length>e.validation.max_length)return`Must be at most ${e.validation.max_length} characters`;if(e.validation.pattern)try{if(!new RegExp(e.validation.pattern).test(n))return`Value does not match the required pattern`}catch{return`Field has an invalid validation pattern`}return null;case`email`:return typeof n==`string`?v.test(n)?null:`Invalid email format`:`Must be a string`;case`number`:{let t=typeof n==`number`?n:Number(n);return Number.isNaN(t)?`Must be a number`:e.validation.min!==void 0&&t<e.validation.min?`Must be at least ${e.validation.min}`:e.validation.max!==void 0&&t>e.validation.max?`Must be at most ${e.validation.max}`:null}case`date`:return typeof n!=`string`||Number.isNaN(Date.parse(n))&&!/^\d{4}-\d{2}-\d{2}$/.test(n)?`Invalid date format`:null;case`select`:case`radio`:case`checkbox`:return null}}var x=class{constructor(e,t){this.http=e,this.siteId=t}async list(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/legal`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async get(e){try{return await this.http.get(`/legal/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getBySlug(e){try{return await this.http.get(`/sites/${this.siteId}/legal/by-slug/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getCookieConsent(){try{return await this.http.get(`/sites/${this.siteId}/legal/cookie-consent`)}catch(e){if(e instanceof r)return null;throw e}}async getGroups(e){return this.http.get(`/legal/${encodeURIComponent(e)}/groups`)}async getGroupItems(e){return this.http.get(`/legal/groups/${encodeURIComponent(e)}/items`)}async getDetail(e){try{return await this.http.get(`/legal/${encodeURIComponent(e)}/detail`)}catch(e){if(e instanceof r)return null;throw e}}async listVersions(e){return this.http.get(`/legal/${encodeURIComponent(e)}/versions`)}},S=class{constructor(e,t){this.http=e,this.siteId=t}async list(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/media`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async get(e){try{return await this.http.get(`/media/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}},C=class{constructor(e,t){this.http=e,this.siteId=t}async listMenus(){return this.http.get(`/sites/${this.siteId}/menus`)}async getMenu(e){try{return await this.http.get(`/menus/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getMenuBySlug(e){try{return await this.http.get(`/sites/${this.siteId}/menus/slug/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getTree(e,t){return this.http.get(`/menus/${encodeURIComponent(e)}/tree`,t?.locale?{locale:t.locale}:void 0)}async listItems(e){return this.http.get(`/menus/${encodeURIComponent(e)}/items`)}async getItem(e){try{return await this.http.get(`/navigation/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}},w=class{constructor(e,t){this.http=e,this.siteId=t}async list(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/pages`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async getByRoute(e){let t=e.startsWith(`/`)?e.slice(1):e;try{return await this.http.get(`/sites/${this.siteId}/pages/by-route/${encodeURIComponent(t)}`)}catch(e){if(e instanceof r)return null;throw e}}async getSections(e){return this.http.get(`/pages/${encodeURIComponent(e)}/sections`)}async getSectionLocalizations(e){return this.http.get(`/pages/sections/${encodeURIComponent(e)}/localizations`)}async getPageSectionLocalizations(e){return this.http.get(`/pages/${encodeURIComponent(e)}/sections/localizations`)}},T=class{constructor(e,t){this.http=e,this.siteId=t}async listPublished(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/projects/public`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async get(e){try{return await this.http.get(`/projects/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getBySlug(e){try{return await this.http.get(`/sites/${this.siteId}/projects/by-slug/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}},E=class{constructor(e,t){this.http=e,this.siteId=t}async lookup(e){try{return await this.http.get(`/sites/${this.siteId}/redirects/lookup`,{path:e})}catch(e){if(e instanceof r)return null;throw e}}},D=class{constructor(e,t){this.http=e,this.siteId=t}async get(){return this.http.get(`/sites/${this.siteId}`)}async listLocales(){return this.http.get(`/sites/${this.siteId}/locales`)}async getCodeInjection(){let e=await this.http.get(`/sites/${this.siteId}/settings`);return{code_injection_head:e.code_injection_head??``,code_injection_footer:e.code_injection_footer??``}}},O=class{constructor(e,t){this.http=e,this.siteId=t}async list(){return this.http.get(`/sites/${this.siteId}/social`)}},k=class{constructor(e,t){this.http=e,this.siteId=t}async listTags(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/tags`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async listCategories(e){let t=e?l(e):void 0,n=async e=>this.http.get(`/sites/${this.siteId}/categories`,{...t,page:String(e)}),r=await n(e?.page??1);return p(r.data,r.meta,n)}async getCategoriesWithBlogCounts(){return this.http.get(`/sites/${this.siteId}/categories/blog-counts`)}async getContentTags(e){return this.http.get(`/content/${encodeURIComponent(e)}/tags`)}async getContentCategories(e){return this.http.get(`/content/${encodeURIComponent(e)}/categories`)}async getTag(e){try{return await this.http.get(`/tags/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getTagBySlug(e){try{return await this.http.get(`/tags/by-slug/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getCategory(e){try{return await this.http.get(`/categories/${encodeURIComponent(e)}`)}catch(e){if(e instanceof r)return null;throw e}}async getCategoryChildren(e){return this.http.get(`/categories/${encodeURIComponent(e)}/children`)}},A=class{constructor(e){let t=f(e);this.blogs=new h(t,e.siteId),this.pages=new w(t,e.siteId),this.navigation=new C(t,e.siteId),this.taxonomy=new k(t,e.siteId),this.analytics=new m(t,e.siteId),this.cv=new g(t,e.siteId),this.legal=new x(t,e.siteId),this.projects=new T(t,e.siteId),this.redirects=new E(t,e.siteId),this.site=new D(t,e.siteId),this.media=new S(t,e.siteId),this.social=new O(t,e.siteId),this.forms=new _(t)}};Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,`c`,{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return e}}),Object.defineProperty(exports,`l`,{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return A}}),Object.defineProperty(exports,`u`,{enumerable:!0,get:function(){return a}});