@griddo/cx 11.7.7-rc.0 → 11.7.7-rc.3

package/build/types/api.d.ts

@@ -0,0 +1,142 @@
+import type { Domains, Robots, Settings } from "./global";
+import type { APIPageObject } from "./pages";
+import type { Site } from "./sites";
+import type { Core, Fields } from "@griddo/core";
+/** EndSiteRender Body */
+export type EndSiteRenderBody = {
+    /** Site hashes to publish. */
+    publishHashes: Array<string>;
+    /** Current site hash. */
+    siteHash: string | null;
+    /**  Site hashes to unpublish. */
+    unpublishHashes: Array<string>;
+    /**  Page ids that publish */
+    publishPagesIds: Array<number>;
+};
+/** ReferenceField Body */
+export interface ReferenceFieldBody {
+    mode?: "auto" | "manual" | "navigation";
+    order?: string;
+    sources?: Array<Fields.Source<unknown>>;
+    quantity?: number;
+    filter?: Array<unknown>;
+    fullRelations?: boolean;
+    allLanguages?: boolean;
+    fixed?: Array<number>;
+    referenceId?: number;
+}
+/** Describes an item in a sitemap. */
+interface SitemapItem {
+    /** The URL of the page. */
+    loc: string;
+    /** The date the page was last modified. */
+    lastmod: string;
+    /** The priority of the page. */
+    priority: number;
+}
+/** Describes a URL. */
+interface URL {
+    /** The path of the URL. */
+    path: string;
+    /** The domain of the URL. */
+    domain: string;
+    /** The home of the URL. */
+    home: string;
+}
+/** Describes the items returned by a sitemap response. */
+export type SitemapItems = Record<string, Array<SitemapItem>>;
+/** Describes the response object returned by a Griddo ReferenceField. */
+export type ReferenceFieldResponse = Fields.QueriedData<unknown>;
+/** Describes the response object returned by socials from Griddo. */
+export type SocialsResponse = Record<Core.SocialName, string>;
+/** Describes the response object returned by post search info post. */
+export type PostSearchInfoResponse = {
+    code: number;
+    message: string;
+};
+/** Describes the response object returned by a sitemap. */
+export interface SitemapAPIResponse {
+    /** Number of items */
+    totalItems: number;
+    /** Page id */
+    page: number;
+    /** Item response by API */
+    items: SitemapItems;
+    /** Url  */
+    url: URL;
+}
+/** Descripbes Language responses from Griddo API. */
+export interface LanguagesResponse {
+    /** Total of languages */
+    totalItems: number;
+    /** Array of languages objects */
+    items: Array<Core.SiteLanguage>;
+}
+/** Describes common props for api responses. */
+export interface APIRequest {
+    /** The URL of the API endpoint. */
+    endpoint: string;
+    /** The parameters to be sent in the request body. */
+    body?: any;
+    /** Reference id to manage cache between renders. */
+    cacheKey?: string;
+    /** Number of connection attempts (in case it fails on the first attempt). */
+    attempt?: number;
+    /**
+     * Headers for the post api fetch
+     * @shame any
+     * @todo type this correctly from axios types
+     */
+    headers?: any;
+    useApiCacheDir?: boolean;
+}
+/** Type with the POST request properties. */
+export interface PostAPI extends Omit<APIRequest, "headers"> {
+    headers?: {
+        lang?: number;
+    } & Record<string, unknown>;
+}
+/** Type with the GET request properties. */
+export type GetAPI = APIRequest;
+/** Type with the PUT request properties. */
+export type PutAPI = APIRequest;
+/** Response type for the start render API call */
+export interface StartPageRenderResponse {
+    /** Site hashes to publish */
+    publishIds: Array<number>;
+    /** Current site hash */
+    siteHash: string | null;
+    /** Site hashes to unpublish */
+    unpublishHashes: Array<string>;
+}
+/** Response type for the end render API call */
+export interface EndPageInfoResponse {
+    /** Response code */
+    code: number;
+    /** Response message */
+    message: string;
+}
+/** Response type for the embedding answer in the ai search feature  */
+export type PostEmbeddingsResponse = string;
+/** Describes a response type for GET all sites */
+export type AllSitesReponse = Array<Site>;
+/** Describes a response type for GET one page */
+export type PageResponse = APIPageObject;
+/** All types for the API response used in the api functions get, put, post */
+export type APIResponses = Domains | Robots | Settings | AllSitesReponse | Site | LanguagesResponse | StartPageRenderResponse | SitemapAPIResponse | SocialsResponse | PageResponse | EndPageInfoResponse | ReferenceFieldResponse | PostSearchInfoResponse | PostSearchInfoResponse | PostEmbeddingsResponse;
+export interface ShowApiErrorOptions {
+    callInfo: Record<string, any>;
+}
+export interface BuildMetaData {
+    buildProcessData: Record<string, EndSiteRenderBody>;
+    createdPages: Array<number>;
+    sitesToPublish: Array<Site>;
+}
+export interface Auth {
+    Authorization: string;
+    "Cache-Control": string;
+}
+export interface AuthHeaders extends Auth {
+    lang?: string;
+}
+export {};

package/build/types/global.d.ts

@@ -0,0 +1,84 @@
+import type { EndSiteRenderBody } from "./api";
+import type { Site } from "./sites";
+import type { Core, Fields } from "@griddo/core";
+interface Settings {
+    apiVersion?: string;
+    avoidCanonicalsOnSitemaps?: boolean;
+    avoidDebugMetas?: boolean;
+    avoidHrefLangsOnCanonicals?: boolean;
+    avoidHrefLangXDefault?: boolean;
+    avoidSelfReferenceCanonicals?: boolean;
+    cloudinaryName?: string;
+    forceMenuLinksLanguage?: boolean;
+    globalLogoBig?: string;
+    globalLogoMini?: string;
+    lastDBCheckVersion?: string;
+    schemasTimestamp?: string;
+    schemasVersion?: string;
+    showBasicMetaRobots?: boolean;
+    siteLogoBig?: string;
+    siteLogoMini?: string;
+    skipReviewOnPublish?: boolean;
+    useMetaTitle?: boolean;
+    useMetaKeywords?: boolean;
+    welcomeText1?: string;
+    welcomeText2?: string;
+}
+type Petition = Record<string, unknown>;
+interface PostSearchInfoProps {
+    title?: string;
+    description: string | null | undefined;
+    image: string | null | undefined;
+    pageId?: number;
+    siteId: number;
+    content: string;
+    languageId?: number;
+    template?: string | null | number;
+    url?: string;
+}
+interface FetchDataProps {
+    page: Core.Page;
+    component: {
+        data?: Fields.Reference<unknown>;
+    };
+    /** Reference id to manage cache between renders. */
+    cacheKey: string;
+}
+type Domain = {
+    id: number;
+    slug: string;
+    url: string;
+};
+type Domains = Array<Domain>;
+/** Describes the type of build process data object. */
+type BuildProcessData = Record<string, EndSiteRenderBody>;
+type Robot = {
+    path: string;
+    content: string;
+};
+type Robots = Array<Robot>;
+interface RenderInfo {
+    buildProcessData: BuildProcessData;
+    createdPages: Array<number>;
+    sitesToPublish: Array<Site>;
+}
+type LifeCycleSteps = Array<(...args: Array<unknown>) => unknown | Promise<unknown>>;
+type LifeCyclesNames = "Init" | "Prepare" | "Restore" | "Data" | "SSG" | "Relocation" | "Meta" | "Archive" | "Clean" | "Close" | "HealthCheck" | "Close" | "__DEBUG__";
+type PlaceholderPath = "__exports" | "__cache" | "__cx" | "__ssg" | "__components" | "__root" | "__exports_dist" | "__cx_dist";
+interface CXConfig {
+    proDomain: string;
+    griddoVersion: string;
+    buildReportFileName: string;
+    paths: (domain?: string) => Record<PlaceholderPath, string>;
+}
+interface AIEmbeddingsResponse {
+    code: number;
+    message: string;
+}
+interface Artifacts {
+    disposables: Array<string>;
+    cacheables: Array<string>;
+    initials: Array<string>;
+    archivables: Array<string>;
+}
+export type { AIEmbeddingsResponse, Artifacts, BuildProcessData, CXConfig, Domain, Domains, FetchDataProps, LifeCyclesNames, Petition, PlaceholderPath, PostSearchInfoProps, RenderInfo, Robot, Robots, Settings, LifeCycleSteps, };

package/build/types/navigation.d.ts

@@ -0,0 +1,28 @@
+/** Describes a Griddo Header */
+export type Header = {
+    component: "Header";
+    id: number;
+    isDefault: boolean;
+    language: number;
+    navigationLanguages: Array<{
+        navigationId: number;
+    }>;
+    setAsDefault: boolean;
+    theme: null | string;
+    title: string;
+    type: "header";
+};
+/** Describes a Griddo Footer */
+export type Footer = {
+    component: "Footer";
+    id: number;
+    isDefault: boolean;
+    language: number;
+    navigationLanguages: Array<{
+        navigationId: number;
+    }>;
+    setAsDefault: boolean;
+    theme: null | string;
+    title: string;
+    type: "header";
+};

package/build/types/pages.d.ts

@@ -0,0 +1,144 @@
+import type { SocialsResponse } from "./api";
+import type { Settings } from "./global";
+import type { Site } from "./sites";
+import type { Core, Fields } from "@griddo/core";
+export type APIPageObject = Core.Page & {
+    id: number;
+} & {
+    header: number | null;
+    footer: number | null;
+};
+export type CleanPage = Core.Page & {
+    isRoot: boolean;
+    defaultLang?: Core.SiteLanguage | undefined;
+};
+export type RenderPage = Core.Page & {
+    isRoot?: boolean;
+    multiPageElements: MultiPageElements;
+    defaultLang?: Core.SiteLanguage;
+    header: number;
+    footer: number;
+    id: number;
+    path: string;
+    component: "Page";
+    template_id: string;
+    mode: "list";
+};
+export type GriddoSinglePage = Core.Page & {
+    defaultLang?: Core.SiteLanguage;
+};
+export type GriddoListPage = Core.Page & {
+    page: APIPageObject;
+    pages: Array<Array<Fields.QueriedDataItem>>;
+    isRoot?: boolean;
+    defaultLang?: Core.SiteLanguage;
+    template: {
+        [key: string]: unknown;
+        type: "template";
+        templateType: string;
+        activeSectionSlug: string;
+        activeSectionBase: string;
+    };
+    totalQueriedItems: Array<Fields.QueriedDataItem>;
+};
+export type GriddoMultiPage = Core.Page & {
+    header: number | null;
+    footer: number | null;
+    isRoot?: boolean;
+    multiPageElements: MultiPageElements;
+    defaultLang?: Core.SiteLanguage | undefined;
+};
+export interface AdditionalInfo {
+    baseUrl: string;
+    cloudinaryName?: string;
+    griddoVersion: string;
+    instance?: string;
+    publicBaseUrl: string;
+    siteLangs: Array<Core.SiteLanguage>;
+    siteMetadata: Site["siteMetadata"];
+    siteSlug: string;
+    socials: SocialsResponse;
+    siteOptions: Pick<Settings, "useMetaTitle" | "useMetaKeywords" | "showBasicMetaRobots" | "avoidHrefLangsOnCanonicals" | "avoidSelfReferenceCanonicals" | "avoidHrefLangXDefault" | "avoidDebugMetas">;
+    siteScript: string;
+    theme: string;
+}
+export interface PageAdditionalInfo extends AdditionalInfo {
+    navigations: {
+        header: Record<string, unknown> | null;
+        footer: Record<string, unknown> | null;
+    };
+}
+export type MultiPageElement = {
+    component: string;
+    title: string | Required<Fields.Heading>;
+    elements: Array<Record<string, unknown>>;
+    componentModules: Array<Record<string, unknown>>;
+    sectionSlug: string;
+    metaTitle: string;
+    metaDescription: string;
+};
+export type MultiPageElements = Array<MultiPageElement>;
+/**
+ * Gatsby page object format.
+ */
+export type GriddoPageObject = {
+    matchPath?: string;
+    path: string;
+    /** Page size in bytes */
+    size?: number;
+    context: {
+        cloudinaryName?: string;
+        footer: Record<string, unknown> | null;
+        fullPath: Core.Page["fullPath"];
+        griddoVersion: string;
+        renderDate: string;
+        header: Record<string, unknown> | null;
+        id?: number;
+        languageId: number;
+        locale?: string;
+        openGraph: {
+            description?: string;
+            image?: string | null;
+            title?: string;
+            twitterImage?: string | null;
+            type: "website";
+        };
+        pageMetadata: {
+            canonical?: string | undefined;
+            description?: string;
+            follow?: "follow" | "nofollow";
+            index: "index" | "noindex";
+            locale?: string;
+            metaKeywords?: string;
+            metasAdvanced?: string;
+            pageLanguages?: Core.Page["pageLanguages"];
+            title?: string;
+            translate?: "notranslate" | "";
+            url?: string;
+        };
+        siteMetadata: Site["siteMetadata"];
+        theme: string;
+        title: string;
+        siteLangs: Array<Core.SiteLanguage>;
+        siteOptions: AdditionalInfo["siteOptions"];
+        siteScript: string;
+        socials: SocialsResponse;
+        page: GriddoSinglePage | GriddoListPage | GriddoMultiPage;
+    };
+};
+export interface Dimensions {
+    values: Record<string, string> | null;
+    contentSelect?: "group" | "individual" | null;
+    groupSelect?: string;
+    dimensionsSelect?: Array<string>;
+}
+export interface GatsbyPageTemplateProps extends Omit<GriddoPageObject, "context"> {
+    pageContext: GriddoPageObject["context"] & {
+        page: Core.Page;
+    };
+    location: {
+        pathname: string;
+        search: string;
+        hash: string;
+    };
+}

package/build/types/sites.d.ts

@@ -0,0 +1,57 @@
+import type { SocialsResponse } from "./api";
+import type { Footer, Header } from "./navigation";
+import type { Core } from "@griddo/core";
+/**
+ * Describes a Griddo site object from API.
+ * This takes some type props from Core.Site.
+ */
+export interface Site extends Required<Pick<Core.Site, "bigAvatar" | "favicon" | "home" | "id" | "isPublished" | "timezone" | "thumbnail" | "theme" | "socials" | "slug" | "smallAvatar" | "modified" | "name" | "siteMetadata">> {
+    author: string;
+    deleted: number;
+    domains: Array<Record<string, string>>;
+    footers: Array<Footer>;
+    hash: string | null;
+    headers: Array<Header>;
+    languages: Array<Core.SiteLanguage>;
+    languageSites: Array<number>;
+    navigationModules: {
+        header?: string;
+        footer?: string;
+    } | null;
+    /**
+     * Array of all pages (from day 0): published, unpublished and deleted
+     * If you want the real used pages use this endpoint: `/site/:site/pages`
+     * `select/site/33/pages` -> [{id,label}, {id,label}, {id,label}] // array of published, pending, unpublished... page objects
+     * `select/site/33/pages?liveStatus=active` -> // array of publishedpage objects
+     */
+    pages: Array<number>;
+    onlinePages: Array<number>;
+    changedPages: Array<number>;
+    published: string;
+    rendering: boolean;
+    renderingHours: number;
+    shouldBeUpdated: boolean;
+    siteScript: string;
+    smallAvatar: string;
+    updated: boolean;
+    pagesStatus: {
+        active: Array<number>;
+        uploadPending: Array<number>;
+        offlinePending: Array<number>;
+        offline: Array<number>;
+        deleted: Array<number>;
+    };
+}
+export interface SiteData {
+    siteInfo: Site;
+    validPagesIds: Array<number>;
+    siteHash: string | null;
+    unpublishHashes: Array<string>;
+    siteLangs: Array<Core.SiteLanguage>;
+    defaultLang: Core.SiteLanguage | undefined;
+    headers: Array<Header>;
+    footers: Array<Footer>;
+    socials: SocialsResponse;
+}
+export type SiteHash = string | null;
+export type HashSites = Record<string, number | string>;

package/build/types/templates.d.ts

@@ -0,0 +1,8 @@
+import type { Core, Fields } from "@griddo/core";
+/** Describes a template object from a Griddo Page */
+export type Template = Core.Page["template"];
+/** Describes a template with a ReferenceField data */
+export type TemplateWithReferenceField = Template & {
+    queriedItems?: Fields.QueriedData<unknown>;
+    itemsPerPage?: number;
+};