@interfere/types 9.0.3-canary.0 → 9.0.3-canary.2

package/dist/sdk/runtime.d.cts

@@ -1,12 +1,31 @@
 import { z } from "zod";
 
 //#region src/sdk/runtime.d.ts
-declare const envSchema: z.ZodNullable<z.ZodEnum<{
-  development: "development";
-  preview: "preview";
-  production: "production";
-}>>;
+declare const envSchema: z.ZodNullable<z.ZodString>;
 type Env = z.infer<typeof envSchema>;
+/**
+ * Fallback environment when nothing is configured. `development` (not
+ * `production`, which is what Sentry defaults to) because the collector has
+ * an always-on per-surface environment filter — an unconfigured run is far
+ * more likely a developer's laptop than a real deploy, so a filtered-by-default
+ * label keeps local noise out of product data. A real deploy sets one of the
+ * higher-precedence signals below.
+ */
+declare const DEFAULT_ENVIRONMENT = "development";
+/**
+ * Resolve the deployment environment using a precedence chain modelled on
+ * Sentry's: an explicit value (init option) wins, then a dedicated
+ * `INTERFERE_ENVIRONMENT`, then platform signals (`VERCEL_ENV`), then
+ * `NODE_ENV` as a last-resort fallback, then {@link DEFAULT_ENVIRONMENT}.
+ *
+ * `NODE_ENV` is deliberately last: it's a build-mode flag (staging, preview,
+ * and prod all ship `NODE_ENV=production`), not a deploy-environment
+ * identifier. The dedicated var is the real abstraction.
+ */
+declare function resolveEnvironment(opts?: {
+  readonly explicit?: string | null | undefined;
+  readonly env?: Record<string, string | undefined>;
+}): string;
 declare const runtimeSchema: z.ZodNullable<z.ZodEnum<{
   browser: "browser";
   edge: "edge";
@@ -16,7 +35,6 @@ type Runtime = z.infer<typeof runtimeSchema>;
 declare function inferRuntime(options?: {
   readonly nextRuntime?: unknown;
 }): Runtime;
-declare function normalizeEnv(value: unknown): Env;
+declare function normalizeEnv(value: unknown): string | null;
 //#endregion
-export { Env, Runtime, envSchema, inferRuntime, normalizeEnv, runtimeSchema };
-//# sourceMappingURL=runtime.d.cts.map
+export { DEFAULT_ENVIRONMENT, Env, Runtime, envSchema, inferRuntime, normalizeEnv, resolveEnvironment, runtimeSchema };

package/dist/sdk/runtime.d.mts

@@ -1,12 +1,31 @@
 import { z } from "zod";
 
 //#region src/sdk/runtime.d.ts
-declare const envSchema: z.ZodNullable<z.ZodEnum<{
-  development: "development";
-  preview: "preview";
-  production: "production";
-}>>;
+declare const envSchema: z.ZodNullable<z.ZodString>;
 type Env = z.infer<typeof envSchema>;
+/**
+ * Fallback environment when nothing is configured. `development` (not
+ * `production`, which is what Sentry defaults to) because the collector has
+ * an always-on per-surface environment filter — an unconfigured run is far
+ * more likely a developer's laptop than a real deploy, so a filtered-by-default
+ * label keeps local noise out of product data. A real deploy sets one of the
+ * higher-precedence signals below.
+ */
+declare const DEFAULT_ENVIRONMENT = "development";
+/**
+ * Resolve the deployment environment using a precedence chain modelled on
+ * Sentry's: an explicit value (init option) wins, then a dedicated
+ * `INTERFERE_ENVIRONMENT`, then platform signals (`VERCEL_ENV`), then
+ * `NODE_ENV` as a last-resort fallback, then {@link DEFAULT_ENVIRONMENT}.
+ *
+ * `NODE_ENV` is deliberately last: it's a build-mode flag (staging, preview,
+ * and prod all ship `NODE_ENV=production`), not a deploy-environment
+ * identifier. The dedicated var is the real abstraction.
+ */
+declare function resolveEnvironment(opts?: {
+  readonly explicit?: string | null | undefined;
+  readonly env?: Record<string, string | undefined>;
+}): string;
 declare const runtimeSchema: z.ZodNullable<z.ZodEnum<{
   browser: "browser";
   edge: "edge";
@@ -16,7 +35,6 @@ type Runtime = z.infer<typeof runtimeSchema>;
 declare function inferRuntime(options?: {
   readonly nextRuntime?: unknown;
 }): Runtime;
-declare function normalizeEnv(value: unknown): Env;
+declare function normalizeEnv(value: unknown): string | null;
 //#endregion
-export { Env, Runtime, envSchema, inferRuntime, normalizeEnv, runtimeSchema };
-//# sourceMappingURL=runtime.d.mts.map
+export { DEFAULT_ENVIRONMENT, Env, Runtime, envSchema, inferRuntime, normalizeEnv, resolveEnvironment, runtimeSchema };

package/dist/sdk/runtime.mjs

@@ -1,2 +1 @@
-import{z}from"zod";const envSchema=z.enum([`development`,`preview`,`production`]).nullable().meta({id:`Environment`,title:`Environment`,description:`Deployment environment the SDK is running in.`}),runtimeSchema=z.enum([`browser`,`node`,`edge`]).nullable().meta({id:`Runtime`,title:`Runtime`,description:`JavaScript runtime the SDK is running in.`});function inferRuntime(options){return typeof window<`u`&&typeof document<`u`&&typeof navigator<`u`?`browser`:typeof globalThis.EdgeRuntime==`string`||options?.nextRuntime===`edge`?`edge`:typeof process<`u`&&typeof process.versions?.node==`string`?`node`:null}function normalizeEnv(value){if(typeof value!=`string`)return null;let env=value.toLowerCase();return envSchema.safeParse(env).success?env:null}export{envSchema,inferRuntime,normalizeEnv,runtimeSchema};
-//# sourceMappingURL=runtime.mjs.map
+import{z}from"zod";const envSchema=z.string().min(1).nullable().meta({id:`Environment`,title:`Environment`,description:"Deployment environment the SDK is running in. Free-form label (e.g. `production`, `preview`, `staging`, `development`)."}),DEFAULT_ENVIRONMENT=`development`,ENVIRONMENT_ENV_VARS=[`INTERFERE_ENVIRONMENT`,`VERCEL_ENV`,`NODE_ENV`];function resolveEnvironment(opts){let env=opts?.env??{},explicit=normalizeEnv(opts?.explicit);if(explicit)return explicit;for(let key of ENVIRONMENT_ENV_VARS){let value=normalizeEnv(env[key]);if(value)return value}return DEFAULT_ENVIRONMENT}const runtimeSchema=z.enum([`browser`,`node`,`edge`]).nullable().meta({id:`Runtime`,title:`Runtime`,description:`JavaScript runtime the SDK is running in.`});function inferRuntime(options){return typeof window<`u`&&typeof document<`u`&&typeof navigator<`u`?`browser`:typeof globalThis.EdgeRuntime==`string`||options?.nextRuntime===`edge`?`edge`:typeof process<`u`&&typeof process.versions?.node==`string`?`node`:null}function normalizeEnv(value){if(typeof value!=`string`)return null;let env=value.trim().toLowerCase();return env.length>0?env:null}export{DEFAULT_ENVIRONMENT,envSchema,inferRuntime,normalizeEnv,resolveEnvironment,runtimeSchema};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interfere/types",
-  "version": "9.0.3-canary.0",
+  "version": "9.0.3-canary.2",
   "license": "MIT",
   "description": "TypeScript & Zod types for Interfere",
   "keywords": [
@@ -15,7 +15,7 @@
   "author": "Interfere <support@interfere.com> (https://interfere.com)",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/interfere-inc/interfere.git",
+    "url": "git+https://interfere.ghe.com/interfere/interfere.git",
     "directory": "src/packages/public/types"
   },
   "files": [
@@ -38,17 +38,6 @@
         "default": "./dist/data/*.cjs"
       }
     },
-    "#auth/*": {
-      "monorepo": "./src/auth/*.ts",
-      "import": {
-        "types": "./dist/auth/*.d.mts",
-        "default": "./dist/auth/*.mjs"
-      },
-      "require": {
-        "types": "./dist/auth/*.d.cts",
-        "default": "./dist/auth/*.cjs"
-      }
-    },
     "#sdk/*": {
       "monorepo": "./src/sdk/*.ts",
       "import": {
@@ -84,17 +73,6 @@
         "default": "./dist/data/*.cjs"
       }
     },
-    "./auth/*": {
-      "monorepo": "./src/auth/*.ts",
-      "import": {
-        "types": "./dist/auth/*.d.mts",
-        "default": "./dist/auth/*.mjs"
-      },
-      "require": {
-        "types": "./dist/auth/*.d.cts",
-        "default": "./dist/auth/*.cjs"
-      }
-    },
     "./sdk/plugins/*": {
       "monorepo": "./src/sdk/plugins/*.ts",
       "import": {
@@ -168,7 +146,7 @@
   "scripts": {
     "build": "tsdown",
     "test": "vitest run",
-    "typecheck": "tsgo --noEmit --incremental"
+    "typecheck": "tsgo --noEmit"
   },
   "dependencies": {
     "zod": "^4.4.3"
@@ -176,10 +154,10 @@
   "devDependencies": {
     "@interfere/test-utils": "^9.0.0",
     "@interfere/typescript-config": "^9.0.0",
-    "@types/node": "^24.12.0",
-    "@typescript/native-preview": "7.0.0-dev.20260522.1",
-    "@vitest/coverage-v8": "^4.1.6",
-    "tsdown": "^0.22.0",
-    "vitest": "^4.1.6"
+    "@types/node": "^25.9.3",
+    "@typescript/native-preview": "7.0.0-dev.20260617.2",
+    "@vitest/coverage-v8": "4.1.9",
+    "tsdown": "^0.22.2",
+    "vitest": "4.1.9"
   }
 }