@platformatic/globals 3.55.0 → 3.56.0

package/README.md

@@ -1,6 +1,6 @@
 # @platformatic/globals
 
-Platformatic Globals exports a single function to get the Platformatic Global object inside a runtime with full typings experience
+Platformatic Globals exports access to Platformatic runtime APIs.
 
 ## Install
 
@@ -11,11 +11,16 @@ npm install @platformatic/globals
 ## Usage
 
 ```ts
-import { getGlobal } from '@platformatic/globals'
+import { getApplicationId, getCapability, getClosing, getMessaging } from '@platformatic/globals'
 
-const platformatic = getGlobal()
+const applicationId = getApplicationId()
+const capability = getCapability()
+const closing = getClosing()
+const messaging = getMessaging()
 ```
 
+Direct access through the legacy global object is still supported for compatibility, but deprecated. Use the typed getters instead.
+
 ## License
 
 Apache 2.0

package/lib/index.d.ts

@@ -1,19 +1,47 @@
+import { type TracerProvider } from '@opentelemetry/api'
+import * as Client from '@platformatic/prom-client'
 import { AsyncLocalStorage } from 'node:async_hooks'
 import { type EventEmitter } from 'node:events'
 import { type Level, type Logger } from 'pino'
-import * as Client from '@platformatic/prom-client'
 
-export type Handler = ((data: any) => any) | ((data: any) => Promise<any>)
+export type Handler = (data: any, context?: Record<string, any>) => any | Promise<any>
 
 export interface InvalidateHttpCacheOptions {
   keys?: string[]
   tags?: string[]
 }
 
+export interface HealthSignal {
+  type: string
+  value?: any
+  description?: string
+  timestamp?: number
+}
+
+export interface SharedContext {
+  get (): any
+  update (contextUpdate: object, options?: { overwrite?: boolean }): any
+}
+
+export type Management = Record<string, (...args: any[]) => any>
+
+export interface GlobalGetterOptions {
+  throwOnMissing?: boolean
+}
+
+export interface RequiredGlobalGetterOptions {
+  throwOnMissing?: true
+}
+
+export interface OptionalGlobalGetterOptions {
+  throwOnMissing: false
+}
+
 // This is purposely a copy of the one in @platformatic/itc to avoid the dependency
 export interface ITC {
   send (message: string, data: any, options?: Record<string, any>): Promise<any>
   notify (message: string, data: any, options?: Record<string, any>): void
+  process (message: string, data: any, context?: Record<string, any>): Promise<any>
   handle (message: string, handler: Handler): void
   getHandler (message: string): Handler | undefined
   listen (): void
@@ -21,26 +49,37 @@ export interface ITC {
 }
 
 export interface MessagingApi {
-  send (name: string, message: string, data: any, options?: Record<string, any>): Promise<any>
-  notify (name: string, message: string, data: any): void
+  send (name: string, message: string, data?: any, options?: Record<string, any>): Promise<any>
+  notify (name: string, message: string, data?: any, options?: Record<string, any>): void
   handle (message: string, handler: Handler): void
+  handle (handlers: Record<string, Handler>): void
+}
+
+export interface PlatformaticEvents extends EventEmitter {
+  emitAndNotify: EventEmitter['emit']
 }
 
 export interface PlatformaticGlobal {
   // Runtime
   isBuilding: boolean
   executable: string
+  runtimeId: number
+  nextVersion: { major: number, minor?: number }
+  exitOnUnhandledErrors: boolean
+  reuseTcpPorts: boolean
 
   // Service configuration
   host: string
   port: number
+  additionalServerOptions: object
+  telemetryConfig: object
   config: object
   applicationId: string
   workerId: number | string
   root: string
   isEntrypoint: boolean
-  basePath: string
-  runtimeBasePath: string
+  basePath: string | null
+  runtimeBasePath: string | null
   wantsAbsoluteUrls: boolean
 
   // Logging
@@ -54,10 +93,20 @@ export interface PlatformaticGlobal {
     registry: Client.Registry
   }
   clientSpansAls: InstanceType<typeof AsyncLocalStorage>
+  interceptors: Record<string, any>
+  valkeyClients: Map<string, any>
 
   // Caching
+  onHttpCacheRequest (key: string): void
   onHttpCacheHit (key: string): void
   onHttpCacheMiss (key: string): void
+  onHttpStatsFree (url: string, value: number): void
+  onHttpStatsConnected (url: string, value: number): void
+  onHttpStatsPending (url: string, value: number): void
+  onHttpStatsQueued (url: string, value: number): void
+  onHttpStatsRunning (url: string, value: number): void
+  onHttpStatsSize (url: string, value: number): void
+  onActiveResourcesEventLoop (value: number): void
   invalidateHttpCache (options: InvalidateHttpCacheOptions): void
 
   // Setters
@@ -80,13 +129,171 @@ export interface PlatformaticGlobal {
       | Promise<{ status: boolean; statusCode?: number; body?: string }>
   ): void
 
-  events: EventEmitter & { emitAndNotify: EventEmitter['emit'] }
+  events: PlatformaticEvents
   itc: ITC
   messaging: MessagingApi
+  capability: object
+  closing: boolean
+  sharedContext: SharedContext
+  management: Management
+  sendHealthSignal (signal: HealthSignal): Promise<void>
+  telemetryReady: Promise<void>
+  tracerProvider: TracerProvider
+  notifyConfig (config: object): void
 }
 
 /** @deprecated Use `PlatformaticGlobal` instead. */
 export type PlatformaticGlobalInterface = PlatformaticGlobal
 
 export declare function getGlobal<T extends {}> (): (PlatformaticGlobal & T) | undefined
+export declare function updateGlobals (updates: Partial<PlatformaticGlobal>): PlatformaticGlobal
+export declare function removeGlobals (fields: string[]): PlatformaticGlobal | undefined
+export declare function hasField (name: string): boolean
+export declare function isBuilding (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['isBuilding']
+export declare function isBuilding (options: OptionalGlobalGetterOptions): PlatformaticGlobal['isBuilding'] | undefined
+export declare function isBuilding (options: GlobalGetterOptions): PlatformaticGlobal['isBuilding'] | undefined
+export declare function getExecutable (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['executable']
+export declare function getExecutable (options: OptionalGlobalGetterOptions): PlatformaticGlobal['executable'] | undefined
+export declare function getExecutable (options: GlobalGetterOptions): PlatformaticGlobal['executable'] | undefined
+export declare function getRuntimeId (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['runtimeId']
+export declare function getRuntimeId (options: OptionalGlobalGetterOptions): PlatformaticGlobal['runtimeId'] | undefined
+export declare function getRuntimeId (options: GlobalGetterOptions): PlatformaticGlobal['runtimeId'] | undefined
+export declare function getNextVersion (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['nextVersion']
+export declare function getNextVersion (options: OptionalGlobalGetterOptions): PlatformaticGlobal['nextVersion'] | undefined
+export declare function getNextVersion (options: GlobalGetterOptions): PlatformaticGlobal['nextVersion'] | undefined
+export declare function getExitOnUnhandledErrors (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['exitOnUnhandledErrors']
+export declare function getExitOnUnhandledErrors (options: OptionalGlobalGetterOptions): PlatformaticGlobal['exitOnUnhandledErrors'] | undefined
+export declare function getExitOnUnhandledErrors (options: GlobalGetterOptions): PlatformaticGlobal['exitOnUnhandledErrors'] | undefined
+export declare function getReuseTcpPorts (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['reuseTcpPorts']
+export declare function getReuseTcpPorts (options: OptionalGlobalGetterOptions): PlatformaticGlobal['reuseTcpPorts'] | undefined
+export declare function getReuseTcpPorts (options: GlobalGetterOptions): PlatformaticGlobal['reuseTcpPorts'] | undefined
+export declare function getHost (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['host']
+export declare function getHost (options: OptionalGlobalGetterOptions): PlatformaticGlobal['host'] | undefined
+export declare function getHost (options: GlobalGetterOptions): PlatformaticGlobal['host'] | undefined
+export declare function getPort (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['port']
+export declare function getPort (options: OptionalGlobalGetterOptions): PlatformaticGlobal['port'] | undefined
+export declare function getPort (options: GlobalGetterOptions): PlatformaticGlobal['port'] | undefined
+export declare function getAdditionalServerOptions (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['additionalServerOptions']
+export declare function getAdditionalServerOptions (options: OptionalGlobalGetterOptions): PlatformaticGlobal['additionalServerOptions'] | undefined
+export declare function getAdditionalServerOptions (options: GlobalGetterOptions): PlatformaticGlobal['additionalServerOptions'] | undefined
+export declare function getTelemetryConfig (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['telemetryConfig']
+export declare function getTelemetryConfig (options: OptionalGlobalGetterOptions): PlatformaticGlobal['telemetryConfig'] | undefined
+export declare function getTelemetryConfig (options: GlobalGetterOptions): PlatformaticGlobal['telemetryConfig'] | undefined
+export declare function getConfig (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['config']
+export declare function getConfig (options: OptionalGlobalGetterOptions): PlatformaticGlobal['config'] | undefined
+export declare function getConfig (options: GlobalGetterOptions): PlatformaticGlobal['config'] | undefined
+export declare function getApplicationId (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['applicationId']
+export declare function getApplicationId (options: OptionalGlobalGetterOptions): PlatformaticGlobal['applicationId'] | undefined
+export declare function getApplicationId (options: GlobalGetterOptions): PlatformaticGlobal['applicationId'] | undefined
+export declare function getWorkerId (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['workerId']
+export declare function getWorkerId (options: OptionalGlobalGetterOptions): PlatformaticGlobal['workerId'] | undefined
+export declare function getWorkerId (options: GlobalGetterOptions): PlatformaticGlobal['workerId'] | undefined
+export declare function getRoot (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['root']
+export declare function getRoot (options: OptionalGlobalGetterOptions): PlatformaticGlobal['root'] | undefined
+export declare function getRoot (options: GlobalGetterOptions): PlatformaticGlobal['root'] | undefined
+export declare function isEntrypoint (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['isEntrypoint']
+export declare function isEntrypoint (options: OptionalGlobalGetterOptions): PlatformaticGlobal['isEntrypoint'] | undefined
+export declare function isEntrypoint (options: GlobalGetterOptions): PlatformaticGlobal['isEntrypoint'] | undefined
+export declare function getBasePath (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['basePath']
+export declare function getBasePath (options: OptionalGlobalGetterOptions): PlatformaticGlobal['basePath'] | undefined
+export declare function getBasePath (options: GlobalGetterOptions): PlatformaticGlobal['basePath'] | undefined
+export declare function getRuntimeBasePath (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['runtimeBasePath']
+export declare function getRuntimeBasePath (options: OptionalGlobalGetterOptions): PlatformaticGlobal['runtimeBasePath'] | undefined
+export declare function getRuntimeBasePath (options: GlobalGetterOptions): PlatformaticGlobal['runtimeBasePath'] | undefined
+export declare function getWantsAbsoluteUrls (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['wantsAbsoluteUrls']
+export declare function getWantsAbsoluteUrls (options: OptionalGlobalGetterOptions): PlatformaticGlobal['wantsAbsoluteUrls'] | undefined
+export declare function getWantsAbsoluteUrls (options: GlobalGetterOptions): PlatformaticGlobal['wantsAbsoluteUrls'] | undefined
+export declare function getLogger (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['logger']
+export declare function getLogger (options: OptionalGlobalGetterOptions): PlatformaticGlobal['logger'] | undefined
+export declare function getLogger (options: GlobalGetterOptions): PlatformaticGlobal['logger'] | undefined
+export declare function getLogLevel (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['logLevel']
+export declare function getLogLevel (options: OptionalGlobalGetterOptions): PlatformaticGlobal['logLevel'] | undefined
+export declare function getLogLevel (options: GlobalGetterOptions): PlatformaticGlobal['logLevel'] | undefined
+export declare function getInterceptLogging (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['interceptLogging']
+export declare function getInterceptLogging (options: OptionalGlobalGetterOptions): PlatformaticGlobal['interceptLogging'] | undefined
+export declare function getInterceptLogging (options: GlobalGetterOptions): PlatformaticGlobal['interceptLogging'] | undefined
+export declare function getPrometheus (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['prometheus']
+export declare function getPrometheus (options: OptionalGlobalGetterOptions): PlatformaticGlobal['prometheus'] | undefined
+export declare function getPrometheus (options: GlobalGetterOptions): PlatformaticGlobal['prometheus'] | undefined
+export declare function getClientSpansAls (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['clientSpansAls']
+export declare function getClientSpansAls (options: OptionalGlobalGetterOptions): PlatformaticGlobal['clientSpansAls'] | undefined
+export declare function getClientSpansAls (options: GlobalGetterOptions): PlatformaticGlobal['clientSpansAls'] | undefined
+export declare function getInterceptors (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['interceptors']
+export declare function getInterceptors (options: OptionalGlobalGetterOptions): PlatformaticGlobal['interceptors'] | undefined
+export declare function getInterceptors (options: GlobalGetterOptions): PlatformaticGlobal['interceptors'] | undefined
+export declare function getValkeyClients (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['valkeyClients']
+export declare function getValkeyClients (options: OptionalGlobalGetterOptions): PlatformaticGlobal['valkeyClients'] | undefined
+export declare function getValkeyClients (options: GlobalGetterOptions): PlatformaticGlobal['valkeyClients'] | undefined
+export declare function getOnHttpCacheRequest (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['onHttpCacheRequest']
+export declare function getOnHttpCacheRequest (options: OptionalGlobalGetterOptions): PlatformaticGlobal['onHttpCacheRequest'] | undefined
+export declare function getOnHttpCacheRequest (options: GlobalGetterOptions): PlatformaticGlobal['onHttpCacheRequest'] | undefined
+export declare function getOnHttpCacheHit (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['onHttpCacheHit']
+export declare function getOnHttpCacheHit (options: OptionalGlobalGetterOptions): PlatformaticGlobal['onHttpCacheHit'] | undefined
+export declare function getOnHttpCacheHit (options: GlobalGetterOptions): PlatformaticGlobal['onHttpCacheHit'] | undefined
+export declare function getOnHttpCacheMiss (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['onHttpCacheMiss']
+export declare function getOnHttpCacheMiss (options: OptionalGlobalGetterOptions): PlatformaticGlobal['onHttpCacheMiss'] | undefined
+export declare function getOnHttpCacheMiss (options: GlobalGetterOptions): PlatformaticGlobal['onHttpCacheMiss'] | undefined
+export declare function getOnHttpStatsFree (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['onHttpStatsFree']
+export declare function getOnHttpStatsFree (options: OptionalGlobalGetterOptions): PlatformaticGlobal['onHttpStatsFree'] | undefined
+export declare function getOnHttpStatsFree (options: GlobalGetterOptions): PlatformaticGlobal['onHttpStatsFree'] | undefined
+export declare function getOnHttpStatsConnected (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['onHttpStatsConnected']
+export declare function getOnHttpStatsConnected (options: OptionalGlobalGetterOptions): PlatformaticGlobal['onHttpStatsConnected'] | undefined
+export declare function getOnHttpStatsConnected (options: GlobalGetterOptions): PlatformaticGlobal['onHttpStatsConnected'] | undefined
+export declare function getOnHttpStatsPending (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['onHttpStatsPending']
+export declare function getOnHttpStatsPending (options: OptionalGlobalGetterOptions): PlatformaticGlobal['onHttpStatsPending'] | undefined
+export declare function getOnHttpStatsPending (options: GlobalGetterOptions): PlatformaticGlobal['onHttpStatsPending'] | undefined
+export declare function getOnHttpStatsQueued (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['onHttpStatsQueued']
+export declare function getOnHttpStatsQueued (options: OptionalGlobalGetterOptions): PlatformaticGlobal['onHttpStatsQueued'] | undefined
+export declare function getOnHttpStatsQueued (options: GlobalGetterOptions): PlatformaticGlobal['onHttpStatsQueued'] | undefined
+export declare function getOnHttpStatsRunning (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['onHttpStatsRunning']
+export declare function getOnHttpStatsRunning (options: OptionalGlobalGetterOptions): PlatformaticGlobal['onHttpStatsRunning'] | undefined
+export declare function getOnHttpStatsRunning (options: GlobalGetterOptions): PlatformaticGlobal['onHttpStatsRunning'] | undefined
+export declare function getOnHttpStatsSize (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['onHttpStatsSize']
+export declare function getOnHttpStatsSize (options: OptionalGlobalGetterOptions): PlatformaticGlobal['onHttpStatsSize'] | undefined
+export declare function getOnHttpStatsSize (options: GlobalGetterOptions): PlatformaticGlobal['onHttpStatsSize'] | undefined
+export declare function getOnActiveResourcesEventLoop (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['onActiveResourcesEventLoop']
+export declare function getOnActiveResourcesEventLoop (options: OptionalGlobalGetterOptions): PlatformaticGlobal['onActiveResourcesEventLoop'] | undefined
+export declare function getOnActiveResourcesEventLoop (options: GlobalGetterOptions): PlatformaticGlobal['onActiveResourcesEventLoop'] | undefined
+export declare function getInvalidateHttpCache (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['invalidateHttpCache']
+export declare function getInvalidateHttpCache (options: OptionalGlobalGetterOptions): PlatformaticGlobal['invalidateHttpCache'] | undefined
+export declare function getInvalidateHttpCache (options: GlobalGetterOptions): PlatformaticGlobal['invalidateHttpCache'] | undefined
+export declare const setBasePath: PlatformaticGlobal['setBasePath']
+export declare const setOpenapiSchema: PlatformaticGlobal['setOpenapiSchema']
+export declare const setGraphqlSchema: PlatformaticGlobal['setGraphqlSchema']
+export declare const setConnectionString: PlatformaticGlobal['setConnectionString']
+export declare const setCustomHealthCheck: PlatformaticGlobal['setCustomHealthCheck']
+export declare const setCustomReadinessCheck: PlatformaticGlobal['setCustomReadinessCheck']
+export declare function getEvents (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['events']
+export declare function getEvents (options: OptionalGlobalGetterOptions): PlatformaticGlobal['events'] | undefined
+export declare function getEvents (options: GlobalGetterOptions): PlatformaticGlobal['events'] | undefined
+export declare function getITC (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['itc']
+export declare function getITC (options: OptionalGlobalGetterOptions): PlatformaticGlobal['itc'] | undefined
+export declare function getITC (options: GlobalGetterOptions): PlatformaticGlobal['itc'] | undefined
+export declare function getMessaging (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['messaging']
+export declare function getMessaging (options: OptionalGlobalGetterOptions): PlatformaticGlobal['messaging'] | undefined
+export declare function getMessaging (options: GlobalGetterOptions): PlatformaticGlobal['messaging'] | undefined
+export declare function getCapability (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['capability']
+export declare function getCapability (options: OptionalGlobalGetterOptions): PlatformaticGlobal['capability'] | undefined
+export declare function getCapability (options: GlobalGetterOptions): PlatformaticGlobal['capability'] | undefined
+export declare function getClosing (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['closing']
+export declare function getClosing (options: OptionalGlobalGetterOptions): PlatformaticGlobal['closing'] | undefined
+export declare function getClosing (options: GlobalGetterOptions): PlatformaticGlobal['closing'] | undefined
+export declare function getSharedContext (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['sharedContext']
+export declare function getSharedContext (options: OptionalGlobalGetterOptions): PlatformaticGlobal['sharedContext'] | undefined
+export declare function getSharedContext (options: GlobalGetterOptions): PlatformaticGlobal['sharedContext'] | undefined
+export declare function getManagement (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['management']
+export declare function getManagement (options: OptionalGlobalGetterOptions): PlatformaticGlobal['management'] | undefined
+export declare function getManagement (options: GlobalGetterOptions): PlatformaticGlobal['management'] | undefined
+export declare function getSendHealthSignal (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['sendHealthSignal']
+export declare function getSendHealthSignal (options: OptionalGlobalGetterOptions): PlatformaticGlobal['sendHealthSignal'] | undefined
+export declare function getSendHealthSignal (options: GlobalGetterOptions): PlatformaticGlobal['sendHealthSignal'] | undefined
+export declare function getTelemetryReady (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['telemetryReady']
+export declare function getTelemetryReady (options: OptionalGlobalGetterOptions): PlatformaticGlobal['telemetryReady'] | undefined
+export declare function getTelemetryReady (options: GlobalGetterOptions): PlatformaticGlobal['telemetryReady'] | undefined
+export declare function getTracerProvider (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['tracerProvider']
+export declare function getTracerProvider (options: OptionalGlobalGetterOptions): PlatformaticGlobal['tracerProvider'] | undefined
+export declare function getTracerProvider (options: GlobalGetterOptions): PlatformaticGlobal['tracerProvider'] | undefined
+export declare function getNotifyConfig (options?: RequiredGlobalGetterOptions): PlatformaticGlobal['notifyConfig']
+export declare function getNotifyConfig (options: OptionalGlobalGetterOptions): PlatformaticGlobal['notifyConfig'] | undefined
+export declare function getNotifyConfig (options: GlobalGetterOptions): PlatformaticGlobal['notifyConfig'] | undefined
 export default getGlobal

package/lib/index.js

@@ -1,5 +1,258 @@
+export const kFields = Symbol.for('plt.globals.fields')
+
+function getField (name, options) {
+  const { throwOnMissing = true } = options ?? {}
+
+  if (throwOnMissing && !globalThis.platformatic?.[kFields]?.has(name)) {
+    throw new Error(`globalThis.platformatic.${name} is not available`)
+  }
+
+  return globalThis.platformatic?.[name]
+}
+
 export function getGlobal () {
   return globalThis.platformatic
 }
 
+export function updateGlobals (updates) {
+  globalThis.platformatic ??= {}
+  globalThis.platformatic[kFields] ??= new Set()
+
+  for (const [key, value] of Object.entries(updates)) {
+    globalThis.platformatic[key] = value
+    globalThis.platformatic[kFields].add(key)
+  }
+
+  return globalThis.platformatic
+}
+
+export function removeGlobals (fields) {
+  if (!globalThis.platformatic?.[kFields]) {
+    return globalThis.platformatic
+  }
+
+  for (const field of fields) {
+    delete globalThis.platformatic[field]
+    globalThis.platformatic[kFields].delete(field)
+  }
+
+  return globalThis.platformatic
+}
+
+export function hasField (name) {
+  return globalThis.platformatic?.[kFields]?.has(name) ?? false
+}
+
+export function isBuilding (options) {
+  return getField('isBuilding', options)
+}
+
+export function getExecutable (options) {
+  return getField('executable', options)
+}
+
+export function getRuntimeId (options) {
+  return getField('runtimeId', options)
+}
+
+export function getNextVersion (options) {
+  return getField('nextVersion', options)
+}
+
+export function getExitOnUnhandledErrors (options) {
+  return getField('exitOnUnhandledErrors', options)
+}
+
+export function getReuseTcpPorts (options) {
+  return getField('reuseTcpPorts', options)
+}
+
+export function getHost (options) {
+  return getField('host', options)
+}
+
+export function getPort (options) {
+  return getField('port', options)
+}
+
+export function getAdditionalServerOptions (options) {
+  return getField('additionalServerOptions', options)
+}
+
+export function getTelemetryConfig (options) {
+  return getField('telemetryConfig', options)
+}
+
+export function getConfig (options) {
+  return getField('config', options)
+}
+
+export function getApplicationId (options) {
+  return getField('applicationId', options)
+}
+
+export function getWorkerId (options) {
+  return getField('workerId', options)
+}
+
+export function getRoot (options) {
+  return getField('root', options)
+}
+
+export function isEntrypoint (options) {
+  return getField('isEntrypoint', options)
+}
+
+export function getBasePath (options) {
+  return getField('basePath', options)
+}
+
+export function getRuntimeBasePath (options) {
+  return getField('runtimeBasePath', options)
+}
+
+export function getWantsAbsoluteUrls (options) {
+  return getField('wantsAbsoluteUrls', options)
+}
+
+export function getLogger (options) {
+  return getField('logger', options)
+}
+
+export function getLogLevel (options) {
+  return getField('logLevel', options)
+}
+
+export function getInterceptLogging (options) {
+  return getField('interceptLogging', options)
+}
+
+export function getPrometheus (options) {
+  return getField('prometheus', options)
+}
+
+export function getClientSpansAls (options) {
+  return getField('clientSpansAls', options)
+}
+
+export function getInterceptors (options) {
+  return getField('interceptors', options)
+}
+
+export function getValkeyClients (options) {
+  return getField('valkeyClients', options)
+}
+
+export function getOnHttpCacheRequest (options) {
+  return getField('onHttpCacheRequest', options)
+}
+
+export function getOnHttpCacheHit (options) {
+  return getField('onHttpCacheHit', options)
+}
+
+export function getOnHttpCacheMiss (options) {
+  return getField('onHttpCacheMiss', options)
+}
+
+export function getOnHttpStatsFree (options) {
+  return getField('onHttpStatsFree', options)
+}
+
+export function getOnHttpStatsConnected (options) {
+  return getField('onHttpStatsConnected', options)
+}
+
+export function getOnHttpStatsPending (options) {
+  return getField('onHttpStatsPending', options)
+}
+
+export function getOnHttpStatsQueued (options) {
+  return getField('onHttpStatsQueued', options)
+}
+
+export function getOnHttpStatsRunning (options) {
+  return getField('onHttpStatsRunning', options)
+}
+
+export function getOnHttpStatsSize (options) {
+  return getField('onHttpStatsSize', options)
+}
+
+export function getOnActiveResourcesEventLoop (options) {
+  return getField('onActiveResourcesEventLoop', options)
+}
+
+export function getInvalidateHttpCache (options) {
+  return getField('invalidateHttpCache', options)
+}
+
+export function setBasePath (...args) {
+  return getField('setBasePath')(...args)
+}
+
+export function setOpenapiSchema (...args) {
+  return getField('setOpenapiSchema')(...args)
+}
+
+export function setGraphqlSchema (...args) {
+  return getField('setGraphqlSchema')(...args)
+}
+
+export function setConnectionString (...args) {
+  return getField('setConnectionString')(...args)
+}
+
+export function setCustomHealthCheck (...args) {
+  return getField('setCustomHealthCheck')(...args)
+}
+
+export function setCustomReadinessCheck (...args) {
+  return getField('setCustomReadinessCheck')(...args)
+}
+
+export function getEvents (options) {
+  return getField('events', options)
+}
+
+export function getITC (options) {
+  return getField('itc', options)
+}
+
+export function getMessaging (options) {
+  return getField('messaging', options)
+}
+
+export function getCapability (options) {
+  return getField('capability', options)
+}
+
+export function getClosing (options) {
+  return getField('closing', options)
+}
+
+export function getSharedContext (options) {
+  return getField('sharedContext', options)
+}
+
+export function getManagement (options) {
+  return getField('management', options)
+}
+
+export function getSendHealthSignal (options) {
+  return getField('sendHealthSignal', options)
+}
+
+export function getTelemetryReady (options) {
+  return getField('telemetryReady', options)
+}
+
+export function getTracerProvider (options) {
+  return getField('tracerProvider', options)
+}
+
+export function getNotifyConfig (options) {
+  return getField('notifyConfig', options)
+}
+
 export default getGlobal

package/package.json

@@ -1,10 +1,16 @@
 {
   "name": "@platformatic/globals",
-  "version": "3.55.0",
+  "version": "3.56.0",
   "description": "Platformatic Global Object Getter",
   "type": "module",
   "main": "./lib/index.js",
-  "exports": "./lib/index.js",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js",
+      "require": "./lib/index.js"
+    }
+  },
   "types": "./lib/index.d.ts",
   "repository": {
     "type": "git",
@@ -25,6 +31,7 @@
     "typescript": "^5.7.3"
   },
   "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
     "@platformatic/prom-client": "^1.0.0",
     "pino": "^9.9.0"
   },