@interfere/types 10.4.0 → 10.5.0

package/dist/sdk/log-sourcing.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const require_sdk_runtime=require("./runtime.cjs");let zod=require("zod");const LOG_SOURCING_ENV_VAR=`INTERFERE_LOG_SOURCING`,LOG_SOURCING_GLOBAL=`__INTERFERE_LOG_SOURCING__`,logSourcingModeSchema=zod.z.enum([`sdk`,`drain`]);function resolveLogSourcingMode(opts){let injected=logSourcingModeSchema.safeParse(require_sdk_runtime.normalizeEnv(opts?.injected));if(injected.success)return injected.data;let fromEnv=logSourcingModeSchema.safeParse(require_sdk_runtime.normalizeEnv(opts?.env?.[LOG_SOURCING_ENV_VAR]));return fromEnv.success?fromEnv.data:`sdk`}function readLogSourcingMode(env=require_sdk_runtime.readProcessEnv()){let scope=globalThis,injected=`__INTERFERE_LOG_SOURCING__`in scope?scope[LOG_SOURCING_GLOBAL]:void 0;return resolveLogSourcingMode({env,injected:typeof injected==`string`?injected:void 0})}exports.DEFAULT_LOG_SOURCING_MODE=`sdk`,exports.LOG_SOURCING_ENV_VAR=LOG_SOURCING_ENV_VAR,exports.LOG_SOURCING_GLOBAL=LOG_SOURCING_GLOBAL,exports.logSourcingModeSchema=logSourcingModeSchema,exports.readLogSourcingMode=readLogSourcingMode,exports.resolveLogSourcingMode=resolveLogSourcingMode;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const require_sdk_runtime=require("./runtime.cjs");let zod=require("zod");const LOG_SOURCING_GLOBAL=`__INTERFERE_LOG_SOURCING__`,logSourcingModeSchema=zod.z.enum([`sdk`,`drain`]);function resolveLogSourcingMode(injected){let parsed=logSourcingModeSchema.safeParse(require_sdk_runtime.normalizeEnv(injected));return parsed.success?parsed.data:`sdk`}function readLogSourcingMode(){let scope=globalThis;return resolveLogSourcingMode(`__INTERFERE_LOG_SOURCING__`in scope?scope[LOG_SOURCING_GLOBAL]:void 0)}exports.DEFAULT_LOG_SOURCING_MODE=`sdk`,exports.LOG_SOURCING_GLOBAL=LOG_SOURCING_GLOBAL,exports.logSourcingModeSchema=logSourcingModeSchema,exports.readLogSourcingMode=readLogSourcingMode,exports.resolveLogSourcingMode=resolveLogSourcingMode;

package/dist/sdk/log-sourcing.d.cts

@@ -1,6 +1,5 @@
 import { z } from "zod";
 //#region src/sdk/log-sourcing.d.ts
-export declare const LOG_SOURCING_ENV_VAR = "INTERFERE_LOG_SOURCING";
 /**
  * Global stamped into the server bundle at build time (via `withInterfere`'s
  * value-injection loader) from the surface's remote config. Read at cold
@@ -23,9 +22,8 @@ export declare const logSourcingModeSchema: z.ZodEnum<{
  */
 export type LogSourcingMode = z.infer<typeof logSourcingModeSchema>;
 export declare const DEFAULT_LOG_SOURCING_MODE = "sdk";
-export declare function resolveLogSourcingMode(opts?: {
-  readonly injected?: string | null | undefined;
-  readonly env?: Record<string, string | undefined> | undefined;
-}): "drain" | "sdk";
-export declare function readLogSourcingMode(env?: Record<string, string | undefined> | undefined): "drain" | "sdk";
+/** The build-injected surface configuration wins; otherwise {@link DEFAULT_LOG_SOURCING_MODE}. */
+export declare function resolveLogSourcingMode(injected?: unknown): "drain" | "sdk";
+/** Reads the build-injected {@link LOG_SOURCING_GLOBAL} global. */
+export declare function readLogSourcingMode(): "drain" | "sdk";
 //#endregion

package/dist/sdk/log-sourcing.d.mts

@@ -1,6 +1,5 @@
 import { z } from "zod";
 //#region src/sdk/log-sourcing.d.ts
-export declare const LOG_SOURCING_ENV_VAR = "INTERFERE_LOG_SOURCING";
 /**
  * Global stamped into the server bundle at build time (via `withInterfere`'s
  * value-injection loader) from the surface's remote config. Read at cold
@@ -23,9 +22,8 @@ export declare const logSourcingModeSchema: z.ZodEnum<{
  */
 export type LogSourcingMode = z.infer<typeof logSourcingModeSchema>;
 export declare const DEFAULT_LOG_SOURCING_MODE = "sdk";
-export declare function resolveLogSourcingMode(opts?: {
-  readonly injected?: string | null | undefined;
-  readonly env?: Record<string, string | undefined> | undefined;
-}): "drain" | "sdk";
-export declare function readLogSourcingMode(env?: Record<string, string | undefined> | undefined): "drain" | "sdk";
+/** The build-injected surface configuration wins; otherwise {@link DEFAULT_LOG_SOURCING_MODE}. */
+export declare function resolveLogSourcingMode(injected?: unknown): "drain" | "sdk";
+/** Reads the build-injected {@link LOG_SOURCING_GLOBAL} global. */
+export declare function readLogSourcingMode(): "drain" | "sdk";
 //#endregion

package/dist/sdk/log-sourcing.mjs

@@ -1 +1 @@
-import{normalizeEnv,readProcessEnv}from"./runtime.mjs";import{z}from"zod";const LOG_SOURCING_ENV_VAR=`INTERFERE_LOG_SOURCING`,LOG_SOURCING_GLOBAL=`__INTERFERE_LOG_SOURCING__`,logSourcingModeSchema=z.enum([`sdk`,`drain`]),DEFAULT_LOG_SOURCING_MODE=`sdk`;function resolveLogSourcingMode(opts){let injected=logSourcingModeSchema.safeParse(normalizeEnv(opts?.injected));if(injected.success)return injected.data;let fromEnv=logSourcingModeSchema.safeParse(normalizeEnv(opts?.env?.[LOG_SOURCING_ENV_VAR]));return fromEnv.success?fromEnv.data:`sdk`}function readLogSourcingMode(env=readProcessEnv()){let scope=globalThis,injected=`__INTERFERE_LOG_SOURCING__`in scope?scope[LOG_SOURCING_GLOBAL]:void 0;return resolveLogSourcingMode({env,injected:typeof injected==`string`?injected:void 0})}export{DEFAULT_LOG_SOURCING_MODE,LOG_SOURCING_ENV_VAR,LOG_SOURCING_GLOBAL,logSourcingModeSchema,readLogSourcingMode,resolveLogSourcingMode};
+import{normalizeEnv}from"./runtime.mjs";import{z}from"zod";const LOG_SOURCING_GLOBAL=`__INTERFERE_LOG_SOURCING__`,logSourcingModeSchema=z.enum([`sdk`,`drain`]),DEFAULT_LOG_SOURCING_MODE=`sdk`;function resolveLogSourcingMode(injected){let parsed=logSourcingModeSchema.safeParse(normalizeEnv(injected));return parsed.success?parsed.data:`sdk`}function readLogSourcingMode(){let scope=globalThis;return resolveLogSourcingMode(`__INTERFERE_LOG_SOURCING__`in scope?scope[LOG_SOURCING_GLOBAL]:void 0)}export{DEFAULT_LOG_SOURCING_MODE,LOG_SOURCING_GLOBAL,logSourcingModeSchema,readLogSourcingMode,resolveLogSourcingMode};

package/dist/sdk/server-tracing.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const require_sdk_runtime=require("./runtime.cjs");let zod=require("zod");const SERVER_TRACING_ENV_VAR=`INTERFERE_SERVER_TRACING`,SERVER_TRACING_GLOBAL=`__INTERFERE_SERVER_TRACING__`,serverTracingModeSchema=zod.z.enum([`full`,`drain`]),DEFAULT_SERVER_TRACING_MODE=`full`;function resolveServerTracingMode(opts){let injected=serverTracingModeSchema.safeParse(require_sdk_runtime.normalizeEnv(opts?.injected));if(injected.success)return injected.data;let fromEnv=serverTracingModeSchema.safeParse(require_sdk_runtime.normalizeEnv(opts?.env?.[SERVER_TRACING_ENV_VAR]));return fromEnv.success?fromEnv.data:DEFAULT_SERVER_TRACING_MODE}function readServerTracingMode(env=require_sdk_runtime.readProcessEnv()){let scope=globalThis,injected=`__INTERFERE_SERVER_TRACING__`in scope?scope[SERVER_TRACING_GLOBAL]:void 0;return resolveServerTracingMode({env,injected:typeof injected==`string`?injected:void 0})}exports.DEFAULT_SERVER_TRACING_MODE=DEFAULT_SERVER_TRACING_MODE,exports.SERVER_TRACING_ENV_VAR=SERVER_TRACING_ENV_VAR,exports.SERVER_TRACING_GLOBAL=SERVER_TRACING_GLOBAL,exports.readServerTracingMode=readServerTracingMode,exports.resolveServerTracingMode=resolveServerTracingMode,exports.serverTracingModeSchema=serverTracingModeSchema;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const require_sdk_runtime=require("./runtime.cjs");let zod=require("zod");const SERVER_TRACING_GLOBAL=`__INTERFERE_SERVER_TRACING__`,serverTracingModeSchema=zod.z.enum([`full`,`drain`]),DEFAULT_SERVER_TRACING_MODE=`full`;function resolveServerTracing(opts){let parsed=serverTracingModeSchema.safeParse(require_sdk_runtime.normalizeEnv(opts?.injected)),env=opts?.env??require_sdk_runtime.readProcessEnv();return{mode:parsed.success?parsed.data:DEFAULT_SERVER_TRACING_MODE,vercel:!!require_sdk_runtime.normalizeEnv(env?.VERCEL)}}function readServerTracing(env=require_sdk_runtime.readProcessEnv()){let scope=globalThis;return resolveServerTracing({env,injected:`__INTERFERE_SERVER_TRACING__`in scope?scope[SERVER_TRACING_GLOBAL]:void 0})}exports.DEFAULT_SERVER_TRACING_MODE=DEFAULT_SERVER_TRACING_MODE,exports.SERVER_TRACING_GLOBAL=SERVER_TRACING_GLOBAL,exports.VERCEL_EXPORT_TIMEOUT_MS=2e3,exports.readServerTracing=readServerTracing,exports.resolveServerTracing=resolveServerTracing,exports.serverTracingModeSchema=serverTracingModeSchema;

package/dist/sdk/server-tracing.d.cts

@@ -1,6 +1,5 @@
 import { z } from "zod";
 //#region src/sdk/server-tracing.d.ts
-export declare const SERVER_TRACING_ENV_VAR = "INTERFERE_SERVER_TRACING";
 /**
  * Global stamped into the server bundle at build time (via `withInterfere`'s
  * value-injection loader) from the surface's remote config. Read at cold
@@ -22,19 +21,24 @@ export declare const serverTracingModeSchema: z.ZodEnum<{
  */
 export type ServerTracingMode = z.infer<typeof serverTracingModeSchema>;
 export declare const DEFAULT_SERVER_TRACING_MODE = "full";
+/** Per-attempt and flush ceiling for direct exports on Vercel, where a flush holds the invocation open. */
+export declare const VERCEL_EXPORT_TIMEOUT_MS = 2000;
 /**
- * Resolve the server tracing mode: the build-injected value wins, then the
- * `INTERFERE_SERVER_TRACING` env var, then {@link DEFAULT_SERVER_TRACING_MODE}.
- * Unrecognised values fall through to the next source.
+ * Resolve the server tracing mode from the build-injected surface
+ * configuration alone; unrecognised or absent values resolve to
+ * {@link DEFAULT_SERVER_TRACING_MODE}. `vercel` reports whether `VERCEL` is
+ * set, which callers use to cap direct export timeouts.
  */
-export declare function resolveServerTracingMode(opts?: {
-  readonly injected?: string | null | undefined;
+export declare function resolveServerTracing(opts?: {
+  readonly injected?: unknown;
   readonly env?: Record<string, string | undefined> | undefined;
-}): "drain" | "full";
-/**
- * Server-runtime convenience over {@link resolveServerTracingMode}: reads the
- * build-injected {@link SERVER_TRACING_GLOBAL} global and falls back to
- * `process.env`. Zero-touch — no code option required.
- */
-export declare function readServerTracingMode(env?: Record<string, string | undefined> | undefined): "drain" | "full";
+}): {
+  mode: "drain" | "full";
+  vercel: boolean;
+};
+/** Reads the build-injected {@link SERVER_TRACING_GLOBAL} global and `process.env`. */
+export declare function readServerTracing(env?: Record<string, string | undefined> | undefined): {
+  mode: "drain" | "full";
+  vercel: boolean;
+};
 //#endregion

package/dist/sdk/server-tracing.d.mts

@@ -1,6 +1,5 @@
 import { z } from "zod";
 //#region src/sdk/server-tracing.d.ts
-export declare const SERVER_TRACING_ENV_VAR = "INTERFERE_SERVER_TRACING";
 /**
  * Global stamped into the server bundle at build time (via `withInterfere`'s
  * value-injection loader) from the surface's remote config. Read at cold
@@ -22,19 +21,24 @@ export declare const serverTracingModeSchema: z.ZodEnum<{
  */
 export type ServerTracingMode = z.infer<typeof serverTracingModeSchema>;
 export declare const DEFAULT_SERVER_TRACING_MODE = "full";
+/** Per-attempt and flush ceiling for direct exports on Vercel, where a flush holds the invocation open. */
+export declare const VERCEL_EXPORT_TIMEOUT_MS = 2000;
 /**
- * Resolve the server tracing mode: the build-injected value wins, then the
- * `INTERFERE_SERVER_TRACING` env var, then {@link DEFAULT_SERVER_TRACING_MODE}.
- * Unrecognised values fall through to the next source.
+ * Resolve the server tracing mode from the build-injected surface
+ * configuration alone; unrecognised or absent values resolve to
+ * {@link DEFAULT_SERVER_TRACING_MODE}. `vercel` reports whether `VERCEL` is
+ * set, which callers use to cap direct export timeouts.
  */
-export declare function resolveServerTracingMode(opts?: {
-  readonly injected?: string | null | undefined;
+export declare function resolveServerTracing(opts?: {
+  readonly injected?: unknown;
   readonly env?: Record<string, string | undefined> | undefined;
-}): "drain" | "full";
-/**
- * Server-runtime convenience over {@link resolveServerTracingMode}: reads the
- * build-injected {@link SERVER_TRACING_GLOBAL} global and falls back to
- * `process.env`. Zero-touch — no code option required.
- */
-export declare function readServerTracingMode(env?: Record<string, string | undefined> | undefined): "drain" | "full";
+}): {
+  mode: "drain" | "full";
+  vercel: boolean;
+};
+/** Reads the build-injected {@link SERVER_TRACING_GLOBAL} global and `process.env`. */
+export declare function readServerTracing(env?: Record<string, string | undefined> | undefined): {
+  mode: "drain" | "full";
+  vercel: boolean;
+};
 //#endregion

package/dist/sdk/server-tracing.mjs

@@ -1 +1 @@
-import{normalizeEnv,readProcessEnv}from"./runtime.mjs";import{z}from"zod";const SERVER_TRACING_ENV_VAR=`INTERFERE_SERVER_TRACING`,SERVER_TRACING_GLOBAL=`__INTERFERE_SERVER_TRACING__`,serverTracingModeSchema=z.enum([`full`,`drain`]),DEFAULT_SERVER_TRACING_MODE=`full`;function resolveServerTracingMode(opts){let injected=serverTracingModeSchema.safeParse(normalizeEnv(opts?.injected));if(injected.success)return injected.data;let fromEnv=serverTracingModeSchema.safeParse(normalizeEnv(opts?.env?.[SERVER_TRACING_ENV_VAR]));return fromEnv.success?fromEnv.data:DEFAULT_SERVER_TRACING_MODE}function readServerTracingMode(env=readProcessEnv()){let scope=globalThis,injected=`__INTERFERE_SERVER_TRACING__`in scope?scope[SERVER_TRACING_GLOBAL]:void 0;return resolveServerTracingMode({env,injected:typeof injected==`string`?injected:void 0})}export{DEFAULT_SERVER_TRACING_MODE,SERVER_TRACING_ENV_VAR,SERVER_TRACING_GLOBAL,readServerTracingMode,resolveServerTracingMode,serverTracingModeSchema};
+import{normalizeEnv,readProcessEnv}from"./runtime.mjs";import{z}from"zod";const SERVER_TRACING_GLOBAL=`__INTERFERE_SERVER_TRACING__`,serverTracingModeSchema=z.enum([`full`,`drain`]),DEFAULT_SERVER_TRACING_MODE=`full`,VERCEL_EXPORT_TIMEOUT_MS=2e3;function resolveServerTracing(opts){let parsed=serverTracingModeSchema.safeParse(normalizeEnv(opts?.injected)),env=opts?.env??readProcessEnv();return{mode:parsed.success?parsed.data:DEFAULT_SERVER_TRACING_MODE,vercel:!!normalizeEnv(env?.VERCEL)}}function readServerTracing(env=readProcessEnv()){let scope=globalThis;return resolveServerTracing({env,injected:`__INTERFERE_SERVER_TRACING__`in scope?scope[SERVER_TRACING_GLOBAL]:void 0})}export{DEFAULT_SERVER_TRACING_MODE,SERVER_TRACING_GLOBAL,VERCEL_EXPORT_TIMEOUT_MS,readServerTracing,resolveServerTracing,serverTracingModeSchema};

package/dist/sdk/service-name.d.cts

@@ -1,7 +1,7 @@
 //#region src/sdk/service-name.d.ts
 /**
  * Global a build stamps into the page with the default OTel `service.name`
- * (the Vite plugin derives it from the package name). The kernel reads it
+ * (the build integrations derive it from the package name). The kernel reads it
  * when `init()` is called without `serviceName`; an explicit value wins.
  */
 export declare const SERVICE_NAME_GLOBAL = "__INTERFERE_SERVICE_NAME__";

package/dist/sdk/service-name.d.mts

@@ -1,7 +1,7 @@
 //#region src/sdk/service-name.d.ts
 /**
  * Global a build stamps into the page with the default OTel `service.name`
- * (the Vite plugin derives it from the package name). The kernel reads it
+ * (the build integrations derive it from the package name). The kernel reads it
  * when `init()` is called without `serviceName`; an explicit value wins.
  */
 export declare const SERVICE_NAME_GLOBAL = "__INTERFERE_SERVICE_NAME__";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interfere/types",
-  "version": "10.4.0",
+  "version": "10.5.0",
   "description": "TypeScript & Zod types for Interfere",
   "keywords": [
     "logging",