@platformatic/foundation 3.58.1 → 3.60.0

package/index.d.ts

@@ -197,6 +197,7 @@ export declare function generateDashedName (): string
 export declare function isFileAccessible (filename: string, directory?: string): Promise<boolean>
 export declare function createDirectory (path: string, empty?: boolean): Promise<string | undefined>
 export declare function createTemporaryDirectory (prefix: string): Promise<string>
+export declare function createSharedTemporaryDirectory (...segments: string[]): Promise<string>
 export declare function safeRemove (path: string): Promise<void>
 export declare function searchFilesWithExtensions (
   root: string,

package/lib/file-system.js

@@ -1,8 +1,8 @@
 import generateName from 'boring-name-generator'
 import { EventEmitter } from 'node:events'
 import { existsSync } from 'node:fs'
-import { access, glob, mkdir, rm, watch } from 'node:fs/promises'
-import { tmpdir } from 'node:os'
+import { access, chmod, glob, mkdir, rm, watch } from 'node:fs/promises'
+import { platform, tmpdir } from 'node:os'
 import { join, matchesGlob, resolve } from 'node:path'
 import { setTimeout as sleep } from 'node:timers/promises'
 import { PathOptionRequiredError } from './errors.js'
@@ -42,6 +42,27 @@ export async function createTemporaryDirectory (prefix) {
   return createDirectory(directory)
 }
 
+// Directories under os.tmpdir() shared by every user running Platformatic must be
+// writable by all of them, like os.tmpdir() itself. The mode passed to mkdir is
+// masked with the process umask, so chmod each segment explicitly; chmod failures
+// are ignored as the segment might be owned by another user.
+export async function createSharedTemporaryDirectory (...segments) {
+  let directory = tmpdir()
+
+  for (const segment of segments) {
+    directory = join(directory, segment)
+    await mkdir(directory, { recursive: true, maxRetries: 10, retryDelay: 1000 })
+
+    if (platform() !== 'win32') {
+      try {
+        await chmod(directory, 0o1777)
+      } catch {}
+    }
+  }
+
+  return directory
+}
+
 export async function safeRemove (path) {
   let i = 0
   while (i++ < 10) {

package/lib/schema.js

@@ -626,6 +626,35 @@ export const health = {
 
 export const healthWithoutDefaults = removeDefaults(health)
 
+const healthProbeEndpoint = {
+  anyOf: [
+    { type: 'boolean' },
+    {
+      type: 'object',
+      properties: {
+        endpoint: { type: 'string' },
+        success: {
+          type: 'object',
+          properties: {
+            statusCode: { type: 'number' },
+            body: { type: 'string' }
+          },
+          additionalProperties: false
+        },
+        fail: {
+          type: 'object',
+          properties: {
+            statusCode: { type: 'number' },
+            body: { type: 'string' }
+          },
+          additionalProperties: false
+        }
+      },
+      additionalProperties: false
+    }
+  ]
+}
+
 export const openTelemetryExporter = {
   type: 'object',
   properties: {
@@ -784,6 +813,17 @@ export const application = {
     id: {
       type: 'string'
     },
+    enabled: {
+      anyOf: [
+        { type: 'boolean' },
+        { type: 'string' },
+        {
+          type: 'object',
+          additionalProperties: { type: 'boolean' }
+        }
+      ],
+      default: true
+    },
     path: {
       type: 'string',
       // This is required for the resolve command to allow empty paths after environment variable replacement
@@ -1059,7 +1099,32 @@ export const runtimeProperties = {
   },
   health,
   healthProbes: {
-    anyOf: [{ type: 'boolean' }, { type: 'string' }],
+    anyOf: [
+      { type: 'boolean' },
+      { type: 'string' },
+      {
+        type: 'object',
+        properties: {
+          enabled: {
+            anyOf: [
+              {
+                type: 'boolean'
+              },
+              {
+                type: 'string'
+              }
+            ]
+          },
+          hostname: { type: 'string' },
+          port: {
+            anyOf: [{ type: 'integer' }, { type: 'string' }]
+          },
+          readiness: healthProbeEndpoint,
+          liveness: healthProbeEndpoint
+        },
+        additionalProperties: false
+      }
+    ],
     default: true
   },
   undici: {
@@ -1250,65 +1315,13 @@ export const runtimeProperties = {
             default: false,
             description: 'Enable outgoing HTTP client request duration metrics'
           },
-          readiness: {
-            anyOf: [
-              { type: 'boolean' },
-              {
-                type: 'object',
-                properties: {
-                  endpoint: { type: 'string' },
-                  success: {
-                    type: 'object',
-                    properties: {
-                      statusCode: { type: 'number' },
-                      body: { type: 'string' }
-                    },
-                    additionalProperties: false
-                  },
-                  fail: {
-                    type: 'object',
-                    properties: {
-                      statusCode: { type: 'number' },
-                      body: { type: 'string' }
-                    },
-                    additionalProperties: false
-                  }
-                },
-                additionalProperties: false
-              }
-            ]
-          },
-          liveness: {
-            anyOf: [
-              { type: 'boolean' },
-              {
-                type: 'object',
-                properties: {
-                  endpoint: { type: 'string' },
-                  success: {
-                    type: 'object',
-                    properties: {
-                      statusCode: { type: 'number' },
-                      body: { type: 'string' }
-                    },
-                    additionalProperties: false
-                  },
-                  fail: {
-                    type: 'object',
-                    properties: {
-                      statusCode: { type: 'number' },
-                      body: { type: 'string' }
-                    },
-                    additionalProperties: false
-                  }
-                },
-                additionalProperties: false
-              }
-            ]
-          },
+          readiness: healthProbeEndpoint,
+          liveness: healthProbeEndpoint,
           healthChecksTimeouts: {
             anyOf: [{ type: 'integer' }, { type: 'string' }],
-            default: 5000
+            default: 5000,
+            deprecated: true,
+            description: 'Deprecated. Health probe timeout configuration is no longer used.'
           },
           plugins: {
             type: 'array',
@@ -1359,6 +1372,32 @@ export const runtimeProperties = {
             required: ['endpoint'],
             additionalProperties: false
           },
+          opentelemetry: {
+            type: 'object',
+            description: 'Configuration for forwarding user OpenTelemetry metrics to an OTLP endpoint',
+            properties: {
+              enabled: {
+                anyOf: [{ type: 'boolean' }, { type: 'string' }],
+                description: 'Enable or disable OpenTelemetry metrics forwarding'
+              },
+              endpoint: {
+                type: 'string',
+                description: 'OTLP metrics endpoint URL (e.g., http://collector:4318/v1/metrics)'
+              },
+              interval: {
+                anyOf: [{ type: 'integer' }, { type: 'string' }],
+                default: 60000,
+                description: 'Interval in milliseconds between metric forwards'
+              },
+              headers: {
+                type: 'object',
+                additionalProperties: { type: 'string' },
+                description: 'Additional HTTP headers for authentication'
+              }
+            },
+            required: ['endpoint'],
+            additionalProperties: false
+          },
           httpCustomLabels: {
             type: 'array',
             description:
@@ -1518,6 +1557,7 @@ export const runtimeUnwrappablePropertiesList = [
 
 export const applicationsUnwrappablePropertiesList = [
   'id',
+  'enabled',
   'path',
   'config',
   'url',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platformatic/foundation",
-  "version": "3.58.1",
+  "version": "3.60.0",
   "description": "Platformatic Foundation",
   "main": "index.js",
   "types": "index.d.ts",