@alanizcreative/formation-static 1.3.0-beta.29

package/lib/wordpress/wordpressDataNormal.js

@@ -0,0 +1 @@
+import{parse}from"@wordpress/block-serialization-spec-parser";import{normalizeContentType}from"../utils/contentType/contentType.js";import{getObjectKeys}from"../utils/object/objectUtils.js";import{getStoreItem,setStoreItem}from"../store/store.js";import{isString,isStringStrict}from"../utils/string/string.js";import{isArrayStrict}from"../utils/array/array.js";import{isObjectStrict}from"../utils/object/object.js";import{isNumber}from"../utils/number/number.js";import{config}from"../config/config.js";const normalRoutes=new Map([["page","pages"],["post","posts"],["taxonomy","taxonomies"],["category","categories"],["tag","tags"],["attachment","media"],["nav_menu","menus"],["nav_menu_item","menu-items"]]),normalMetaKeys=new Map,menusById=new Map,excludeProps=["_links","auto_add"],getTaxonomy=id=>{const taxonomy=getStoreItem("taxonomies")[id],{title:title="",slug:slug="",contentTypes:contentTypes=[]}=isObjectStrict(taxonomy)?taxonomy:{};return{id:id,title:title,slug:slug,contentTypes:contentTypes}},normalizeFile=file=>{const{url:url,filename:filename,alt:alt,width:width,height:height,filesizeInBytes:filesizeInBytes,subtype:subtype,mime:mime,sizes:sizes}=file;let s;if(isObjectStrict(sizes)){s={};for(const[,value]of Object.entries(sizes)){const{width:width,source_url:src}=value;let{url:url}=value;isStringStrict(src)&&(url=src),isNumber(width)&&isStringStrict(url)&&(s[width]=url)}}return{url:isString(url)?url:"",name:isString(filename)?filename:"",alt:isString(alt)?alt:"",width:isNumber(width)?width:0,height:isNumber(height)?height:0,size:isNumber(filesizeInBytes)?filesizeInBytes:0,format:"jpeg"===subtype?"jpg":subtype,type:mime,sizes:s}},normalizeEmbedded=(value,item,newItem)=>{getObjectKeys(value).forEach((k=>{const embeds=value[k];isArrayStrict(embeds)&&("author"===k&&embeds.forEach((embed=>{if(!isObjectStrict(embed))return;const{id:id,name:name,url:url,description:description,link:link,slug:slug}=embed;item.author===id&&(newItem.author={id:id.toString(),name:name,url:url,description:description,link:link,slug:slug})})),"up"===k&&embeds.forEach((embed=>{if(!isObjectStrict(embed))return;const{id:id,title:parentTitle,name:name,type:type,taxonomy:taxonomy,slug:slug}=embed;if(item.parent!==id)return;let title="";isString(parentTitle?.rendered)&&(title=parentTitle.rendered),isString(name)&&(title=name),newItem.parent={id:id.toString(),contentType:isString(taxonomy)?"term":type,title:title,slug:slug}})),"wp:featuredmedia"===k&&embeds.forEach((embed=>{if(!isObjectStrict(embed))return;const{id:id,source_url:url,media_details:details,mime_type:mimeType,alt_text:alt}=embed;if(!isObjectStrict(details))return;const{file:file,filesize:filesize,width:width,height:height,sizes:sizes}=details;item.featured_media===id&&(newItem.featured_media=normalizeFile({url:url,filename:file?.split("/").pop(),alt:alt,width:width,height:height,filesizeInBytes:filesize,subtype:mimeType?.split("/").pop(),mime:mimeType,sizes:sizes}))})),"wp:term"===k&&embeds.forEach((embed=>{isArrayStrict(embed)&&embed.forEach((e=>{if(!isObjectStrict(e))return;const{id:id,link:link,name:name,slug:slug,taxonomy:taxonomy=""}=e;let taxonomyLookup=taxonomy;"category"===taxonomy&&(taxonomyLookup="categories"),"post_tag"===taxonomy&&(taxonomyLookup="tags");const itemTaxonomy=newItem[taxonomyLookup]??item[taxonomyLookup];isArrayStrict(itemTaxonomy)&&(newItem[taxonomyLookup]=itemTaxonomy.map((taxonomyId=>taxonomyId!==id?taxonomyId:{id:id.toString(),link:link,title:name,slug:slug,contentType:"term",taxonomy:getTaxonomy(taxonomy)})))}))})))}))},normalizeBlocks=blocks=>{const newItems=[];return blocks.forEach((block=>{const{blockName:blockName,attrs:attrs,innerBlocks:innerBlocks}=block,contentType=blockName;if(!isStringStrict(contentType))return;const{attributeIsItem:attributeIsItem}=attrs,attrItemArr=(isStringStrict(attributeIsItem)?attributeIsItem:"").split(","),attrItemExists=attrItemArr.length>0;for(const[key,value]of Object.entries(attrs))if(isObjectStrict(value)){if(attrItemExists&&attrItemArr.includes(key)){const itemValue=normalizeItem(value);itemValue.content=void 0,attrs[key]=itemValue}isStringStrict(value.mime)&&(attrs[key]=normalizeFile(value))}const newItem={contentType:contentType,...attrs},renderType=config.renderTypes[contentType];return isString(renderType)&&(newItem.renderType=renderType),isArrayStrict(innerBlocks)&&(newItem.content=normalizeBlocks(innerBlocks)),newItems.push(newItem)})),newItems},normalizeItem=item=>{const newItem={};for(const[key,value]of Object.entries(item)){if(excludeProps.includes(key))continue;let val=value,k=key;const isObj=isObjectStrict(value),isStr=isStringStrict(value);if("id"!==key&&"object_id"!==k||(val=value?.toString()),"type"===key&&isStr)newItem.contentType=normalizeContentType(value),isString(config.renderTypes[value])&&(newItem.renderType=config.renderTypes[value]);else{if("types"===key&&(k="contentTypes"),isObj){const{rendered:rendered}=value;isString(rendered)&&(val=rendered)}if("name"===key&&(k="title"),"_embedded"===key&&isObj)normalizeEmbedded(value,item,newItem);else{if(isStringStrict(val)){if("excerpt"===key&&(val=val.replace(/<[^>]*>|\[.*?\]/g,"").trim()),"content"===key){const normalVal=normalizeBlocks(parse(val));val=normalVal.length>0?normalVal:val}"taxonomy"===key&&(newItem.contentType="term",val=getTaxonomy(val))}if("meta"===key&&isObj)for(const[metaKey,metaValue]of Object.entries(val)){newItem[normalMetaKeys.get(metaKey)??metaKey]=metaValue}else{if("media_details"===k&&isObj){const valObj=val,valFull=valObj.sizes?.full,sourceUrl=item.source_url,mimeType=item.mime_type;val=normalizeFile({url:sourceUrl,filename:sourceUrl?.split("/").pop(),alt:item.alt_text,width:valFull?.width,height:valFull?.height,filesizeInBytes:valObj.filesize,subtype:mimeType?.split("/")[1],mime:mimeType,sizes:valObj.sizes})}newItem[k]=val}}}}return newItem},normalizeWordPressMenuItems=items=>{const itemsObj=Object.fromEntries(items.map((item=>[item.id,item])));menusById.clear(),items.forEach((item=>{const{id:id="",title:title="",menu_order:menu_order=0,menus:menus=0,parent:parent}=item,hasMenuOrder=isNumber(menu_order);if(hasMenuOrder&&isObjectStrict(itemsObj[parent])&&(null==itemsObj[parent].children&&(itemsObj[parent].children=[]),itemsObj[parent].children.push({id:id,menu_order:menu_order,title:title})),hasMenuOrder&&isNumber(menus)&&0===parent){const menuId=menus.toString();null==menusById.get(menuId)&&menusById.set(menuId,[]),menusById.get(menuId)?.push({id:id,menu_order:menu_order,title:title})}}));const newItems=[];for(const[id,obj]of Object.entries(itemsObj)){const{url:url="",title:title="",attr_title:attr_title="",description:description="",contentType:contentType="",children:children=[],object:object="",object_id:object_id="",target:target="",classes:classes=[],xfn:xfn=[],meta:meta=[]}=obj;if(!isString(url)||!isStringStrict(title))continue;const isCustom="custom"===contentType,newItem={id:id,title:title,attr_title:attr_title,description:description,target:target,classes:classes,xfn:xfn,meta:meta};if(!isCustom&&isStringStrict(object)&&isStringStrict(object_id)){const isTerm="taxonomy"===contentType,internalLink={contentType:isTerm?"term":object,id:object_id,slug:url.split("/").filter(Boolean).pop()};isTerm&&(internalLink.taxonomy=getTaxonomy(object)),newItem.link=url,newItem.internalLink=internalLink}if(isCustom){url.startsWith("http")&&!url.startsWith(config.env.prodUrl)?newItem.externalLink=url:newItem.link=url}isArrayStrict(children)&&(newItem.children=children.sort(((a,b)=>a.menu_order-b.menu_order))),newItems.push(newItem)}return newItems},normalizeWordPressMenus=menus=>{const newMenus=[];return menus.forEach((menu=>{const{id:id="",title:title="",description:description="",locations:locations=[],meta:meta=[]}=menu,newMenu={id:id,title:title,description:description,meta:meta,location:locations,items:menusById.get(id)?.sort(((a,b)=>a.menu_order-b.menu_order))??[]};newMenus.push(newMenu)})),newMenus},normalizeWordPressData=(data,route,_newData=[])=>isArrayStrict(data)?("taxonomies"===route&&(data=Object.entries(data[0]).map((([key,value])=>({id:key,type:"taxonomy",...value})))),data.forEach((item=>{isObjectStrict(item)&&_newData.push(normalizeItem(item))})),"taxonomies"===route&&_newData.forEach((item=>{setStoreItem("taxonomies",item,item.id)})),_newData):[];export{normalizeWordPressData,normalizeWordPressMenuItems,normalizeWordPressMenus,normalRoutes,normalMetaKeys};

package/lib/wordpress/wordpressDataTypes.d.ts

@@ -0,0 +1,206 @@
+import type { Generic, GenericStrings } from '../global/globalTypes.js';
+import type { NavigationItem } from '../components/Navigation/NavigationTypes.js';
+import type { RenderServerlessData, RenderPreviewData, RenderItem, RenderDataMeta } from '../render/renderTypes.js';
+export type WordPressDataParams = Record<string, string | number | boolean>;
+export interface WordPressDataError {
+    code?: string;
+    message?: string;
+    data?: {
+        status?: number;
+        params?: GenericStrings;
+        details?: Generic;
+    };
+}
+export type WordPressDataStatus = 'publish' | 'draft' | 'future' | 'pending' | 'private' | 'trash' | 'auto-draft' | 'inherit';
+export interface WordPressDataRendered {
+    rendered?: string;
+}
+export interface WordPressDataRenderedProtected {
+    rendered?: string;
+    protected?: boolean;
+}
+export interface WordPressDataMenuChild extends NavigationItem {
+    menu_order: number;
+}
+export interface WordPressDataMenuItem extends RenderItem {
+    children?: WordPressDataMenuChild[];
+}
+export interface WordPressDataMenu extends RenderItem {
+    name?: string;
+    locations?: string[];
+}
+export interface WordPressDataAuthor {
+    id: number;
+    name?: string;
+    url?: string;
+    description?: string;
+    link?: string;
+    slug?: string;
+}
+export interface WordPressDataMediaDetails {
+    width?: number;
+    height?: number;
+    filesize?: number;
+    file?: string;
+    sizes?: Record<string, WordPressDataMediaSize>;
+}
+export interface WordPressDataMediaSize {
+    source_url?: string;
+    mime_type?: string;
+    file?: string;
+    filesize?: number;
+    width?: number;
+    height?: number;
+}
+export interface WordPressDataFeaturedMedia {
+    id: number;
+    source_url?: string;
+    alt_text?: string;
+    caption?: WordPressDataRendered;
+    media_type?: string;
+    mime_type?: string;
+    media_details?: WordPressDataMediaDetails;
+}
+export interface WordPressDataTerm {
+    id: number;
+    link?: string;
+    name?: string;
+    slug?: string;
+    taxonomy?: string;
+}
+export interface WordPressDataAttachment {
+    id: number;
+    source_url?: string;
+    title?: WordPressDataRendered;
+    media_type?: string;
+    mime_type?: string;
+}
+export interface WordPressDataParent {
+    id: number;
+    title?: WordPressDataRendered;
+    excerpt?: WordPressDataRendered;
+    slug?: string;
+    type?: string;
+    link?: string;
+    author?: number;
+    featured_media?: number;
+    name?: string;
+    taxonomy?: string;
+}
+export interface WordPressDataEmbedded {
+    author?: WordPressDataAuthor[];
+    up?: WordPressDataParent[];
+    'wp:featuredmedia'?: WordPressDataFeaturedMedia[];
+    'wp:attachment'?: WordPressDataAttachment[];
+    'wp:term'?: WordPressDataTerm[][];
+}
+export interface WordPressDataLink {
+    href: string;
+    name?: string;
+    templated?: boolean;
+    count?: number;
+    taxonomy?: string;
+    embeddable?: boolean;
+}
+export interface WordPressDataLinks {
+    self: WordPressDataLink[];
+    collection: WordPressDataLink[];
+    about: WordPressDataLink[];
+    'version-history': WordPressDataLink[];
+    'wp:attachment': WordPressDataLink[];
+    'wp:term': WordPressDataLink[];
+    curies: WordPressDataLink[];
+}
+export interface WordPressDataFileSize {
+    height?: number;
+    width?: number;
+    url?: string;
+    source_url?: string;
+    orientation?: string;
+}
+export interface WordPressDataFile {
+    contentType?: string;
+    id?: number;
+    title?: string;
+    filename?: string;
+    url?: string;
+    link?: string;
+    alt?: string;
+    author?: string;
+    description?: string;
+    caption?: string;
+    name?: string;
+    status?: string;
+    uploadedTo?: number;
+    date?: string;
+    modified?: string;
+    menuOrder?: number;
+    mime?: string;
+    type?: string;
+    subtype?: string;
+    icon?: string;
+    dateFormatted?: string;
+    nonces?: {
+        update: string;
+        delete: string;
+        edit: string;
+    };
+    editLink?: string;
+    meta?: boolean;
+    authorName?: string;
+    authorLink?: string;
+    filesizeInBytes?: number;
+    filesizeHumanReadable?: string;
+    context?: string;
+    height?: number;
+    width?: number;
+    orientation?: string;
+    sizes?: Record<string, WordPressDataFileSize>;
+}
+export interface WordPressDataMeta extends Generic {
+    footnotes?: string;
+}
+export interface WordPressDataItem extends Partial<WordPressDataFeaturedMedia>, Generic {
+    id?: number;
+    date?: string;
+    date_gmt?: string;
+    guid?: WordPressDataRendered;
+    modified?: string;
+    modified_gmt?: string;
+    slug?: string;
+    status?: WordPressDataStatus;
+    type?: string;
+    link?: string;
+    title?: WordPressDataRendered;
+    content?: WordPressDataRenderedProtected;
+    excerpt?: WordPressDataRenderedProtected;
+    author?: number;
+    featured_media?: number;
+    parent?: number;
+    menu_order?: number;
+    comment_status?: string;
+    ping_status?: string;
+    sticky?: boolean;
+    template?: string;
+    format?: string;
+    meta?: WordPressDataMeta;
+    categories?: number[];
+    tags?: number[];
+    class_list?: string[];
+    taxonomy?: string;
+    name?: string;
+    _links?: WordPressDataLinks;
+    _embedded?: WordPressDataEmbedded;
+}
+export interface WordPressDataArgs {
+    key: string;
+    route: string;
+    params?: WordPressDataParams;
+    meta?: RenderDataMeta;
+    fetcher?: typeof fetch;
+    options?: RequestInit;
+}
+export interface AllWordPressDataArgs {
+    serverlessData?: RenderServerlessData;
+    previewData?: RenderPreviewData;
+}

package/lib/wordpress/wordpressDataTypes.js

@@ -0,0 +1 @@
+export{};

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@alanizcreative/formation-static",
+  "version": "1.3.0-beta.29",
+  "description": "Foundation and utilities to build static sites using local JSON files, Contentful, or WordPress",
+  "main": "./lib/config/config.js",
+  "packageManager": "pnpm@10.6.2",
+  "type": "module",
+  "files": [
+    "./lib",
+    "./cjs"
+  ],
+  "exports": {
+    "./*": {
+      "import": "./lib/*",
+      "require": "./cjs/*"
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build:lib": "npx tsc --project tsconfig.build.json",
+    "build:cjs": "npx tsc --project tsconfig.build.json --moduleResolution node --module commonjs --esModuleInterop --outDir cjs/",
+    "build": "pnpm build:lib && pnpm build:cjs && node scripts/packageFile.js && pnpm minify",
+    "minify": "find lib cjs -name \"*.js\" -exec terser {} -o {} --compress \\;",
+    "test": "vitest --run --reporter verbose --coverage",
+    "lint": "npx eslint .",
+    "release": "release-it",
+    "release:beta": "release-it --preRelease=beta"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/galaniz/formation-static.git"
+  },
+  "bugs": {
+    "url": "https://github.com/galaniz/formation-static/issues"
+  },
+  "homepage": "https://github.com/galaniz/formation-static#readme",
+  "author": "Graciela Alaniz (https://alanizcreative.com/)",
+  "license": "MIT",
+  "devDependencies": {
+    "@cloudflare/workers-types": "4.20250310.0",
+    "@types/contentful-resolve-response": "^0.1.33",
+    "@types/node": "^22.13.10",
+    "@types/uuid": "^10.0.0",
+    "@types/wordpress__block-serialization-spec-parser": "^3.1.3",
+    "@vitest/coverage-v8": "^3.0.8",
+    "eslint": "9.22.0",
+    "memfs": "4.17.0",
+    "release-it": "^18.1.2",
+    "terser": "5.37.0",
+    "typescript": "^5.8.2",
+    "typescript-eslint": "8.26.1",
+    "vitest": "^3.0.8"
+  },
+  "dependencies": {
+    "uuid": "^11.1.0"
+  },
+  "peerDependencies": {
+    "@wordpress/block-serialization-spec-parser": "^5.11.0",
+    "contentful-resolve-response": "^1.9.0",
+    "sharp": "0.33.5"
+  },
+  "peerDependenciesMeta": {
+    "@wordpress/block-serialization-spec-parser": {
+      "optional": true
+    },
+    "contentful-resolve-response": {
+      "optional": true
+    },
+    "sharp": {
+      "optional": true
+    }
+  },
+  "release-it": {
+    "git": {
+      "requireCommits": true,
+      "commitMessage": "chore: release ${version} [ci skip]"
+    },
+    "github": {
+      "release": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}