@nordcraft/core 1.0.74 → 1.0.76

package/dist/types.d.ts

@@ -6,14 +6,14 @@ export type FormulaHandlerV2<R = unknown> = (args: Record<string, unknown>, ctx:
     env: ToddleEnv;
 }) => R | null;
 export type ActionHandlerV2 = (args: Record<string, unknown>, ctx: {
-    triggerActionEvent: (trigger: string, data: any, event?: Event) => void;
+    triggerActionEvent: (trigger: string, data: any, event?: Nullable<Event>) => void;
     root: Document | ShadowRoot;
-}, event?: Event) => void | (() => void) | Promise<void> | Promise<() => void>;
+}, event?: Nullable<Event>) => void | (() => void) | Promise<void> | Promise<() => void>;
 export type ActionHandler<Args = unknown[]> = (args: Args, ctx: {
-    triggerActionEvent: (trigger: string, data: any, event?: Event) => void;
+    triggerActionEvent: (trigger: string, data: any, event?: Nullable<Event>) => void;
     env: ToddleEnv;
     abortSignal: AbortSignal;
-}, event?: Event) => void;
+}, event?: Nullable<Event>) => void;
 export type FormulaHandler<T = void> = (args: unknown[], ctx: {
     component: Component;
     data: ComponentData;
@@ -22,20 +22,20 @@ export type FormulaHandler<T = void> = (args: unknown[], ctx: {
 }) => T | null;
 interface PluginActionBase {
     name: string;
-    description?: string;
-    arguments?: Array<{
+    description?: Nullable<string>;
+    arguments?: Nullable<Array<{
         name: string;
         formula: Formula;
-    }> | null;
-    events?: Record<string, {
+    }>>;
+    events?: Nullable<Record<string, {
         dummyEvent?: any;
-    }>;
-    variableArguments: boolean | null;
+    }>>;
+    variableArguments: Nullable<boolean>;
 }
 export interface PluginActionV2 extends PluginActionBase {
     handler: ActionHandlerV2;
     version: 2;
-    exported?: boolean;
+    exported?: Nullable<boolean>;
 }
 export interface LegacyPluginAction extends PluginActionBase {
     handler: string;
@@ -92,15 +92,16 @@ export interface Comment {
     text: string;
 }
 export interface NordcraftMetadata {
-    '@nordcraft/metadata'?: {
-        comments: Record<string, Comment & {
+    '@nordcraft/metadata'?: Nullable<{
+        comments: Nullable<Partial<Record<string, Comment & {
             index: number;
-        }> | null;
-    } | null;
+        }>>>;
+    }>;
 }
 export type RequireFields<T, K extends keyof T> = Omit<T, K> & {
     [P in K]-?: NonNullable<T[P]>;
 };
+export type Nullable<T> = T | null | undefined;
 export type NestedOmit<Schema, Path extends string> = Path extends `${infer Head}.${infer Tail}` ? Head extends keyof Schema ? {
     [K in keyof Schema]: K extends Head ? NestedOmit<Schema[K], Tail> : Schema[K];
 } : Schema : Omit<Schema, Path>;

package/dist/utils/collections.d.ts

@@ -1,3 +1,4 @@
+import type { Nullable } from '../types';
 export declare const isObject: (input: any) => input is Record<string, any>;
 export declare const mapObject: <T, T2>(object: Record<string, T>, f: (kv: [string, T]) => [string, T2]) => Record<string, T2>;
 export declare const mapValues: <T, T2>(object: Record<string, T>, f: (value: T) => T2) => Record<string, T2>;
@@ -18,4 +19,4 @@ export declare function get<T = any>(collection: T, [head, ...rest]: string[]):
 export declare const set: <T = unknown>(collection: T, key: (string | number)[], value: any) => T;
 export declare const sortObjectEntries: <T>(object: Record<string, T>, f: (kv: [string, T]) => string | number | boolean, ascending?: boolean) => [string, T][];
 export declare const easySort: <T>(collection: T[], f: (item: T) => string | number | boolean, ascending?: boolean) => T[];
-export declare const deepSortObject: (obj: any) => any[] | Record<string, any> | null | undefined;
+export declare const deepSortObject: (obj: any) => Nullable<any[] | Record<string, any>>;

package/dist/utils/collections.js.map

@@ -1 +1 @@
-{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../src/utils/collections.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../src/utils/collections.ts"],"names":[],"mappings":"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"}

package/dist/utils/getNodeSelector.d.ts

@@ -1,12 +1,13 @@
 import { type StyleVariant } from '../styling/variantSelector';
+import type { Nullable } from '../types';
 type NodeSelectorOptions = {
     componentName: string;
-    nodeId: string | undefined;
-    variant?: StyleVariant;
+    nodeId: Nullable<string>;
+    variant?: Nullable<StyleVariant>;
 } | {
     componentName?: never;
     nodeId?: never;
-    variant?: StyleVariant;
+    variant?: Nullable<StyleVariant>;
 };
 export declare function getNodeSelector(path: string, { componentName, nodeId, variant }?: NodeSelectorOptions): string;
 export {};

package/dist/utils/getNodeSelector.js.map

@@ -1 +1 @@
-{"version":3,"file":"getNodeSelector.js","sourceRoot":"","sources":["../../src/utils/getNodeSelector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAqB,MAAM,4BAA4B,CAAA;AAc/E,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,GAAwB,EAAE,EACpD;IACR,IAAI,QAAQ,GAAG,aAAa,IAAI,IAAI,CAAA;IACpC,IAAI,aAAa,EAAE,CAAC;QAClB,QAAQ,IAAI,IAAI,aAAa,EAAE,CAAA;IACjC,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,QAAQ,IAAI,MAAM,MAAM,EAAE,CAAA;IAC5B,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,IAAI,eAAe,CAAC,OAAO,CAAC,CAAA;IACtC,CAAC;IAED,OAAO,QAAQ,CAAA;AAAA,CAChB"}
+{"version":3,"file":"getNodeSelector.js","sourceRoot":"","sources":["../../src/utils/getNodeSelector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAqB,MAAM,4BAA4B,CAAA;AAe/E,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,GAAwB,EAAE,EACpD;IACR,IAAI,QAAQ,GAAG,aAAa,IAAI,IAAI,CAAA;IACpC,IAAI,aAAa,EAAE,CAAC;QAClB,QAAQ,IAAI,IAAI,aAAa,EAAE,CAAA;IACjC,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,QAAQ,IAAI,MAAM,MAAM,EAAE,CAAA;IAC5B,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,IAAI,eAAe,CAAC,OAAO,CAAC,CAAA;IACtC,CAAC;IAED,OAAO,QAAQ,CAAA;AAAA,CAChB"}

package/package.json

@@ -10,6 +10,9 @@
 "watch": "tsgo -w"
 },
 "files": ["dist", "src"],
+"dependencies": {
+"zod": "4.2.1"
+},
 "main": "dist/index.js",
-"version": "1.0.74"
+"version": "1.0.76"
 }

package/src/api/LegacyToddleApi.ts

@@ -4,6 +4,7 @@ import {
   getFormulasInAction,
   getFormulasInFormula,
 } from '../formula/formulaUtils'
+import type { Nullable } from '../types'
 import { isDefined } from '../utils/util'
 import { type LegacyComponentAPI } from './apiTypes'
 
@@ -29,7 +30,7 @@ export class LegacyToddleApi<Handler> {
       return this._apiReferences
     }
     const apis = new Set<string>()
-    const visitFormulaReference = (formula?: Formula | null) => {
+    const visitFormulaReference = (formula?: Nullable<Formula>) => {
       if (!isDefined(formula)) {
         return
       }

package/src/api/ToddleApiV2.ts

@@ -6,6 +6,7 @@ import {
   getFormulasInAction,
   getFormulasInFormula,
 } from '../formula/formulaUtils'
+import type { Nullable } from '../types'
 import { isDefined } from '../utils/util'
 import { HttpMethodsWithAllowedBody } from './api'
 import { type ApiRequest } from './apiTypes'
@@ -32,7 +33,7 @@ export class ToddleApiV2<Handler> implements ApiRequest {
       return this._apiReferences
     }
     const apis = new Set<string>()
-    const visitFormulaReference = (formula?: Formula | null) => {
+    const visitFormulaReference = (formula?: Nullable<Formula>) => {
       if (!isDefined(formula)) {
         return
       }

package/src/api/api.ts

@@ -1,5 +1,6 @@
 import type { Formula, FormulaContext } from '../formula/formula'
 import { applyFormula } from '../formula/formula'
+import type { Nullable } from '../types'
 import { omitKeys, sortObjectEntries } from '../utils/collections'
 import { hash } from '../utils/hash'
 import { isDefined, isObject, toBoolean } from '../utils/util'
@@ -31,7 +32,7 @@ export const createApiRequest = <Handler>({
 }: {
   api: ApiRequest | ToddleApiV2<Handler>
   formulaContext: FormulaContext
-  baseUrl?: string
+  baseUrl?: Nullable<string>
   defaultHeaders: Headers | undefined
 }) => {
   const url = getUrl(api, formulaContext, baseUrl)
@@ -47,7 +48,7 @@ export const createApiRequest = <Handler>({
 export const getUrl = (
   api: ApiBase,
   formulaContext: FormulaContext,
-  baseUrl?: string,
+  baseUrl?: Nullable<string>,
 ): URL => {
   let urlPathname = ''
   let urlQueryParams = new URLSearchParams()
@@ -57,7 +58,7 @@ export const getUrl = (
     const urlInput = typeof url === 'number' ? String(url) : url
     try {
       // Try to parse the URL to extract potential path and query parameters
-      parsedUrl = new URL(urlInput, baseUrl)
+      parsedUrl = new URL(urlInput, baseUrl ?? undefined)
       urlPathname = parsedUrl.pathname
       urlQueryParams = parsedUrl.searchParams
       // eslint-disable-next-line no-empty
@@ -77,13 +78,13 @@ export const getUrl = (
   const hashString =
     typeof hash === 'string' && hash.length > 0 ? `#${hash}` : ''
   if (parsedUrl) {
-    const combinedUrl = new URL(parsedUrl.origin, baseUrl)
+    const combinedUrl = new URL(parsedUrl.origin, baseUrl ?? undefined)
     combinedUrl.pathname = path
     combinedUrl.search = queryParams.toString()
     combinedUrl.hash = hashString
     return combinedUrl
   } else {
-    return new URL(`${path}${queryString}${hashString}`, baseUrl)
+    return new URL(`${path}${queryString}${hashString}`, baseUrl ?? undefined)
   }
 }
 
@@ -224,7 +225,7 @@ export const getBaseUrl = ({
   url,
 }: {
   origin: string
-  url?: string
+  url?: Nullable<string>
 }) =>
   !isDefined(url) || url === '' || url.startsWith('/') ? origin + url : url
 
@@ -254,13 +255,13 @@ export const isApiError = ({
   apiName: string
   response: {
     ok: boolean
-    status?: number
-    headers?: Record<string, string> | null
+    status?: Nullable<number>
+    headers?: Nullable<Record<string, string>>
     body: unknown
   }
   formulaContext: FormulaContext
   performance: ApiPerformance
-  errorFormula?: { formula: Formula } | null
+  errorFormula?: Nullable<{ formula: Formula }>
 }) => {
   const errorFormulaRes = errorFormula
     ? applyFormula(errorFormula.formula, {

package/src/api/apiTypes.ts

@@ -1,27 +1,27 @@
 import type { EventModel } from '../component/component.types'
 import type { Formula } from '../formula/formula'
-import type { NordcraftMetadata } from '../types'
+import type { NordcraftMetadata, Nullable } from '../types'
 
 export type ComponentAPI = LegacyComponentAPI | ApiRequest
 
 export interface LegacyComponentAPI {
   name: string
   type: 'REST'
-  autoFetch?: Formula | null
-  url?: Formula
-  path?: { formula: Formula }[]
-  proxy?: boolean
-  queryParams?: Record<string, { name: string; formula: Formula }>
-  headers?: Record<string, Formula> | Formula
-  method?: 'GET' | 'POST' | 'DELETE' | 'PUT'
-  body?: Formula
-  auth?: {
+  autoFetch?: Nullable<Formula>
+  url?: Nullable<Formula>
+  path?: Nullable<{ formula: Formula }[]>
+  proxy?: Nullable<boolean>
+  queryParams?: Nullable<Record<string, { name: string; formula: Formula }>>
+  headers?: Nullable<Record<string, Formula> | Formula>
+  method?: Nullable<'GET' | 'POST' | 'DELETE' | 'PUT'>
+  body?: Nullable<Formula>
+  auth?: Nullable<{
     type: 'Bearer id_token' | 'Bearer access_token'
-  }
-  throttle?: number | null
-  debounce?: number | null
-  onCompleted: EventModel | null
-  onFailed: EventModel | null
+  }>
+  throttle?: Nullable<number>
+  debounce?: Nullable<number>
+  onCompleted?: Nullable<EventModel>
+  onFailed?: Nullable<EventModel>
   version?: never
 }
 
@@ -53,59 +53,60 @@ export type ApiParserMode =
   | 'blob'
 
 export interface ApiBase extends NordcraftMetadata {
-  url?: Formula | null
-  path?: Record<string, { formula: Formula; index: number }> | null
-  queryParams?: Record<
-    string,
-    // The enabled formula is used to determine if the query parameter should be included in the request or not
-    { formula: Formula; enabled?: Formula | null }
-  > | null
+  url?: Nullable<Formula>
+  path?: Nullable<Record<string, { formula: Formula; index: number }>>
+  queryParams?: Nullable<
+    Record<
+      string,
+      // The enabled formula is used to determine if the query parameter should be included in the request or not
+      { formula: Formula; enabled?: Nullable<Formula> }
+    >
+  >
   // hash is relevant for redirects and rewrites, but not for API calls
-  hash?: { formula: Formula } | null
+  hash?: Nullable<{ formula: Formula }>
 }
 
 export interface ApiRequest extends ApiBase {
   version: 2
   name: string
   type: 'http' | 'ws' // The structure for web sockets might look different
-  autoFetch?: Formula | null
-  headers?: Record<
-    string,
-    { formula: Formula; enabled?: Formula | null }
-  > | null
-  method?: ApiMethod | null
-  body?: Formula | null
+  autoFetch?: Nullable<Formula>
+  headers?: Nullable<
+    Record<string, { formula: Formula; enabled?: Nullable<Formula> }>
+  >
+  method?: Nullable<ApiMethod>
+  body?: Nullable<Formula>
   // inputs for an API request
-  inputs: Record<string, { formula: Formula | null }>
-  service?: string | null
-  servicePath?: string | null
-  server?: {
+  inputs: Record<string, { formula: Nullable<Formula> }>
+  service?: Nullable<string>
+  servicePath?: Nullable<string>
+  server?: Nullable<{
     // We should only accept server side proxy requests if proxy is defined
-    proxy?: {
+    proxy?: Nullable<{
       enabled: { formula: Formula }
       // Allow replacing template values in the body of a proxied request
       // This is useful for cases where the body should include an http only cookie for instance
-      useTemplatesInBody?: { formula: Formula } | null
-    } | null
-    ssr?: {
+      useTemplatesInBody?: Nullable<{ formula: Formula }>
+    }>
+    ssr?: Nullable<{
       // We should only fetch a request server side during SSR if this is true
       // it should probably be true by default for autofetch APIs
       // During SSR we will only fetch autoFetch requests
-      enabled?: { formula: Formula } | null
-    } | null
-  } | null
-  client?: {
-    debounce?: { formula: Formula } | null
-    onCompleted?: EventModel | null
-    onFailed?: EventModel | null
-    onMessage?: EventModel | null
+      enabled?: Nullable<{ formula: Formula }>
+    }>
+  }>
+  client?: Nullable<{
+    debounce?: Nullable<{ formula: Formula }>
+    onCompleted?: Nullable<EventModel>
+    onFailed?: Nullable<EventModel>
+    onMessage?: Nullable<EventModel>
     // parserMode is used to determine how the response should be handled
     // auto: The response will be handled based on the content type of the response
     // stream: The response will be handled as a stream
     parserMode: ApiParserMode
     // Whether to include credentials (cookies) in the request or not. Default is 'same-origin'
-    credentials?: 'include' | 'same-origin' | 'omit' | null
-  } | null
+    credentials?: Nullable<'include' | 'same-origin' | 'omit'>
+  }>
   // Shared logic for client/server 👇
   // The user could distinguish using an environment
   // variable e.g. IS_SERVER when they declare the formula
@@ -113,41 +114,43 @@ export interface ApiRequest extends ApiBase {
   // Rules for redirecting the user to a different page
   // These rules will run both on server+client - mostly used for 401 response -> 302 redirect
   // We allow multiple rules since it makes it easier to setup multiple conditions/redirect locations
-  redirectRules?: Record<
-    string,
-    {
-      // The formula will receive the response from the server including a status code
-      // A redirect response will be returned if the formula returns a valid url
-      formula: Formula
-      // The status code used in the redirect response. Only relevant server side
-      statusCode?: RedirectStatusCode | null
-      index: number
-    }
-  > | null
+  redirectRules?: Nullable<
+    Record<
+      string,
+      {
+        // The formula will receive the response from the server including a status code
+        // A redirect response will be returned if the formula returns a valid url
+        formula: Formula
+        // The status code used in the redirect response. Only relevant server side
+        statusCode?: Nullable<RedirectStatusCode>
+        index: number
+      }
+    >
+  >
   // Formula for determining whether the response is an error or not. Receives the API response + status code/headers as input
   // The response is considered an error if the formula returns true
   // Default behavior is to check if the status code is 400 or higher
-  isError?: { formula: Formula } | null
+  isError?: Nullable<{ formula: Formula }>
   // Formula for determining when the request should time out
-  timeout?: { formula: Formula } | null
+  timeout?: Nullable<{ formula: Formula }>
 }
 
 export interface ApiStatus {
   data: unknown
   isLoading: boolean
   error: unknown
-  response?: {
-    status?: number
-    headers?: Record<string, string> | null
-    performance?: ApiPerformance
-    debug?: null | unknown
-  }
+  response?: Nullable<{
+    status?: Nullable<number>
+    headers?: Nullable<Record<string, string>>
+    performance?: Nullable<ApiPerformance>
+    debug?: Nullable<unknown>
+  }>
 }
 
 export interface ApiPerformance {
-  requestStart: number | null
-  responseStart: number | null
-  responseEnd: number | null
+  requestStart?: Nullable<number>
+  responseStart?: Nullable<number>
+  responseEnd?: Nullable<number>
 }
 
 export interface ToddleRequestInit extends RequestInit {

package/src/api/headers.ts

@@ -1,16 +1,18 @@
+import type { Nullable } from '../types'
+
 /**
  * Checks if a header is a json (content-type) header
  * Also supports edge cases like application/vnd.api+json and application/vnd.contentful.delivery.v1+json
  * See https://jsonapi.org/#mime-types
  */
-export const isJsonHeader = (header?: string | null) => {
+export const isJsonHeader = (header?: Nullable<string>) => {
   if (typeof header !== 'string') {
     return false
   }
   return /^application\/(json|.*\+json)/.test(header)
 }
 
-export const isTextHeader = (header?: string | null) => {
+export const isTextHeader = (header?: Nullable<string>) => {
   if (typeof header !== 'string') {
     return false
   }
@@ -19,21 +21,21 @@ export const isTextHeader = (header?: string | null) => {
   )
 }
 
-export const isEventStreamHeader = (header?: string | null) => {
+export const isEventStreamHeader = (header?: Nullable<string>) => {
   if (typeof header !== 'string') {
     return false
   }
   return /^text\/event-stream/.test(header)
 }
 
-export const isJsonStreamHeader = (header?: string | null) => {
+export const isJsonStreamHeader = (header?: Nullable<string>) => {
   if (typeof header !== 'string') {
     return false
   }
   return /^(application\/stream\+json|application\/x-ndjson)/.test(header)
 }
 
-export const isImageHeader = (header?: string | null) => {
+export const isImageHeader = (header?: Nullable<string>) => {
   if (typeof header !== 'string') {
     return false
   }

package/src/component/ToddleComponent.ts

@@ -69,11 +69,11 @@ export class ToddleComponent<Handler> {
           globalFormulas: this.globalFormulas,
         }),
       )
-      Object.values(component.nodes).forEach(
+      Object.values(component.nodes ?? {}).forEach(
         visitNode(node.package ?? packageName),
       )
     }
-    Object.values(this.nodes).forEach(visitNode())
+    Object.values(this.nodes ?? {}).forEach(visitNode())
     return [...components.values()]
   }
 

package/src/component/actionUtils.ts

@@ -1,9 +1,9 @@
-import type { LegacyPluginAction, PluginActionV2 } from '../types'
+import type { LegacyPluginAction, Nullable, PluginActionV2 } from '../types'
 import { isDefined } from '../utils/util'
 import type { ActionModel } from './component.types'
 
 export function* getActionsInAction(
-  action: ActionModel | null,
+  action: Nullable<ActionModel>,
   path: (string | number)[] = [],
 ): Generator<[(string | number)[], ActionModel]> {
   if (!isDefined(action)) {
@@ -32,6 +32,7 @@ export function* getActionsInAction(
       break
     case 'Custom':
     case undefined:
+    case null:
       for (const [eventKey, event] of Object.entries(action.events ?? {})) {
         for (const [key, a] of Object.entries(event?.actions ?? {})) {
           yield* getActionsInAction(a, [