@crossdelta/infrastructure 0.2.24 → 0.2.25

package/dist/helpers/index.d.ts

@@ -3,6 +3,7 @@ export * from './discover-services';
 export * from './docker-hub-image';
 export * from './droplet-builder';
 export * from './image';
+export * from './otel';
 export * from './service-builder';
 export * from './service-runtime';
 export * from './service-urls';

package/dist/helpers/otel.d.ts

@@ -0,0 +1,62 @@
+import type * as pulumi from '@pulumi/pulumi';
+/**
+ * OpenTelemetry configuration for OTLP export.
+ */
+export interface OtelConfig {
+    /** OTLP endpoint for traces (e.g., https://in-otel.logs.betterstack.com/v1/traces) */
+    tracesEndpoint?: pulumi.Input<string>;
+    /** OTLP endpoint for metrics (e.g., https://in-otel.logs.betterstack.com/v1/metrics) */
+    metricsEndpoint?: pulumi.Input<string>;
+    /** OTLP headers (e.g., "Authorization=Bearer xxx") */
+    headers?: pulumi.Input<string>;
+    /** Deployment environment (e.g., "production", "staging") */
+    environment?: string;
+}
+/**
+ * Builds OpenTelemetry environment variables for a service.
+ *
+ * @param serviceName - Unique service name (e.g., "orderboss-storefront")
+ * @param config - OTel configuration from Pulumi config
+ * @returns Record of environment variables for OTel SDK auto-instrumentation
+ *
+ * @example
+ * ```typescript
+ * const otelConfig = {
+ *   tracesEndpoint: cfg.get('otelTracesEndpoint'),
+ *   metricsEndpoint: cfg.get('otelMetricsEndpoint'),
+ *   headers: cfg.getSecret('otelHeaders'),
+ *   environment: 'production',
+ * }
+ *
+ * const serviceConfig = {
+ *   name: 'orders',
+ *   env: {
+ *     ...buildOtelEnv('orderboss-orders', otelConfig),
+ *     // other env vars
+ *   },
+ * }
+ * ```
+ */
+export declare function buildOtelEnv(serviceName: string, config: OtelConfig): Record<string, pulumi.Input<string>>;
+/**
+ * Creates a function that builds OTel env vars with pre-configured endpoints.
+ * Useful for applying the same OTel config to multiple services.
+ *
+ * @param config - OTel configuration from Pulumi config
+ * @returns Function that takes a service name and returns OTel env vars
+ *
+ * @example
+ * ```typescript
+ * const withOtelEnv = createOtelEnvBuilder({
+ *   tracesEndpoint: cfg.get('otelTracesEndpoint'),
+ *   headers: cfg.getSecret('otelHeaders'),
+ *   environment: getStack(),
+ * })
+ *
+ * // In each service config:
+ * env: {
+ *   ...withOtelEnv('orderboss-orders'),
+ * }
+ * ```
+ */
+export declare function createOtelEnvBuilder(config: OtelConfig): (serviceName: string) => Record<string, pulumi.Input<string>>;