@geekmidas/envkit 1.0.4 → 1.0.5

package/dist/sst.d.cts

@@ -1,8 +1,188 @@
-import { EnvRecord, EnvValue, EnvironmentBuilderOptions, environmentCase } from "./EnvironmentBuilder-Xuf2Dd9u.cjs";
-import { ApiGatewayV2, Bucket, Dynamo, Function, Postgres, ResourceProcessor, ResourceType, Secret, SnsTopic, SstEnvironmentBuilder, SstResource, Vpc, sstResolvers } from "./SstEnvironmentBuilder-Dc9nOuuK.cjs";
+import { EnvRecord, EnvValue, EnvironmentBuilderOptions, EnvironmentResolver, InputValue, Resolvers, environmentCase } from "./EnvironmentBuilder-CNgcdzSR.cjs";
 
-//#region src/sst.d.ts
+//#region src/SstEnvironmentBuilder.d.ts
 
+/**
+ * Enumeration of supported SST (Serverless Stack Toolkit) resource types.
+ * Used to identify and process different AWS and SST resources.
+ */
+declare enum ResourceType {
+  ApiGatewayV2 = "sst.aws.ApiGatewayV2",
+  Postgres = "sst.aws.Postgres",
+  Function = "sst.aws.Function",
+  Bucket = "sst.aws.Bucket",
+  Vpc = "sst.aws.Vpc",
+  Secret = "sst.sst.Secret",
+  Dynamo = "sst.aws.Dynamo",
+  SSTSecret = "sst:sst:Secret",
+  SSTFunction = "sst:sst:Function",
+  SSTApiGatewayV2 = "sst:aws:ApiGatewayV2",
+  SSTPostgres = "sst:aws:Postgres",
+  SSTBucket = "sst:aws:Bucket",
+  SnsTopic = "sst:aws:SnsTopic",
+  SSTDynamo = "sst:aws:Dynamo",
+}
+/**
+ * AWS API Gateway V2 resource type.
+ * Represents an HTTP/WebSocket API.
+ */
+type ApiGatewayV2 = {
+  type: ResourceType.ApiGatewayV2 | ResourceType.SSTApiGatewayV2;
+  url: string;
+};
+/**
+ * PostgreSQL database resource type.
+ * Contains all connection details needed to connect to the database.
+ */
+type Postgres = {
+  type: ResourceType.Postgres | ResourceType.SSTPostgres;
+  database: string;
+  host: string;
+  password: string;
+  port: number;
+  username: string;
+};
+/**
+ * AWS Lambda Function resource type.
+ */
+type Function = {
+  type: ResourceType.Function | ResourceType.SSTFunction;
+  name: string;
+};
+/**
+ * AWS S3 Bucket resource type.
+ */
+type Bucket = {
+  type: ResourceType.Bucket | ResourceType.SSTBucket;
+  name: string;
+};
+/**
+ * AWS VPC (Virtual Private Cloud) resource type.
+ */
+type Vpc = {
+  type: ResourceType.Vpc;
+  bastion: string;
+};
+/**
+ * Secret resource type for storing sensitive values.
+ */
+type Secret = {
+  type: ResourceType.Secret | ResourceType.SSTSecret;
+  value: string;
+};
+/**
+ * AWS SNS Topic resource type.
+ */
+type SnsTopic = {
+  type: ResourceType.SnsTopic;
+  arn: string;
+};
+/**
+ * AWS DynamoDB Table resource type.
+ */
+type Dynamo = {
+  type: ResourceType.Dynamo | ResourceType.SSTDynamo;
+  name: string;
+};
+/**
+ * Union type of all supported SST resource types.
+ */
+type SstResource = ApiGatewayV2 | Postgres | Function | Bucket | Vpc | Secret | SnsTopic | Dynamo;
+/**
+ * Function type for processing a specific resource type into environment variables.
+ *
+ * @template K - The specific resource type (without `type` key)
+ * @param name - The resource name
+ * @param value - The resource value (without `type` key)
+ * @returns Object mapping environment variable names to values
+ */
+type ResourceProcessor<K> = (name: string, value: K) => EnvRecord;
+/**
+ * Pre-configured resolvers for all SST resource types.
+ */
+declare const sstResolvers: Resolvers;
+/**
+ * All known SST resource type strings.
+ */
+type SstResourceTypeString = `${ResourceType}`;
+/**
+ * Extracts the `type` string value from an input value.
+ */
+type ExtractType<T> = T extends {
+  type: infer U extends string;
+} ? U : never;
+/**
+ * Removes the `type` key from an object type.
+ */
+type OmitType<T> = T extends {
+  type: string;
+} ? Omit<T, 'type'> : never;
+/**
+ * Extracts all unique `type` values from a record (excluding plain strings).
+ */
+type AllTypeValues<TRecord extends Record<string, InputValue>> = { [K in keyof TRecord]: ExtractType<TRecord[K]> }[keyof TRecord];
+/**
+ * Extracts only the custom (non-SST) type values from a record.
+ */
+type CustomTypeValues<TRecord extends Record<string, InputValue>> = Exclude<AllTypeValues<TRecord>, SstResourceTypeString>;
+/**
+ * For a given type value, finds the corresponding value type (without `type` key).
+ */
+type ValueForType<TRecord extends Record<string, InputValue>, TType extends string> = { [K in keyof TRecord]: TRecord[K] extends {
+  type: TType;
+} ? OmitType<TRecord[K]> : never }[keyof TRecord];
+/**
+ * Generates typed resolvers for custom (non-SST) types in the input record.
+ */
+type CustomResolvers<TRecord extends Record<string, InputValue>> = CustomTypeValues<TRecord> extends never ? Resolvers | undefined : { [TType in CustomTypeValues<TRecord>]: EnvironmentResolver<ValueForType<TRecord, TType>> };
+/**
+ * SST-specific environment builder with built-in resolvers for all known
+ * SST resource types.
+ *
+ * Wraps the generic EnvironmentBuilder with pre-configured SST resolvers.
+ *
+ * @template TRecord - The input record type for type inference
+ *
+ * @example
+ * ```typescript
+ * const env = new SstEnvironmentBuilder({
+ *   database: { type: 'sst:aws:Postgres', host: '...', ... },
+ *   apiKey: { type: 'sst:sst:Secret', value: 'secret' },
+ *   appName: 'my-app',
+ * }).build();
+ *
+ * // With custom resolvers (typed based on input)
+ * const env = new SstEnvironmentBuilder(
+ *   {
+ *     database: postgresResource,
+ *     custom: { type: 'my-custom' as const, data: 'foo' },
+ *   },
+ *   {
+ *     // TypeScript requires 'my-custom' resolver with typed value
+ *     'my-custom': (key, value) => ({ [`${key}Data`]: value.data }),
+ *   }
+ * ).build();
+ * ```
+ */
+declare class SstEnvironmentBuilder<TRecord extends Record<string, SstResource | InputValue | string>> {
+  private readonly builder;
+  /**
+   * Create a new SST environment builder.
+   *
+   * @param record - Object containing SST resources, custom resources, and/or string values
+   * @param additionalResolvers - Optional custom resolvers (typed based on custom types in record)
+   * @param options - Optional configuration options
+   */
+  constructor(record: TRecord, additionalResolvers?: CustomResolvers<TRecord>, options?: EnvironmentBuilderOptions);
+  /**
+   * Build environment variables from the input record.
+   *
+   * @returns A record of environment variables
+   */
+  build(): EnvRecord;
+}
+//#endregion
+//#region src/sst.d.ts
 /**
  * @deprecated Use `new SstEnvironmentBuilder(record).build()` instead.
  *
@@ -25,6 +205,7 @@ declare function normalizeResourceEnv(record: Record<string, SstResource | strin
  */
 type Resource = SstResource;
 //# sourceMappingURL=sst.d.ts.map
+
 //#endregion
 export { ApiGatewayV2, Bucket, Dynamo, EnvRecord, EnvValue, EnvironmentBuilderOptions, Function, Postgres, Resource, ResourceProcessor, ResourceType, Secret, SnsTopic, SstEnvironmentBuilder, SstResource, Vpc, environmentCase, normalizeResourceEnv, sstResolvers };
 //# sourceMappingURL=sst.d.cts.map

package/dist/sst.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"sst.d.cts","names":[],"sources":["../src/sst.ts"],"sourcesContent":[],"mappings":";;;;;AAiDA;;;;;;AAES;AAQT;;;;;;;;;iBAVgB,oBAAA,SACP,eAAe,wBACrB,2CAA2C;;;;KAQlC,QAAA,GAAW"}
+{"version":3,"file":"sst.d.cts","names":[],"sources":["../src/SstEnvironmentBuilder.ts","../src/sst.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/sst.d.mts

@@ -1,8 +1,188 @@
-import { EnvRecord, EnvValue, EnvironmentBuilderOptions, environmentCase } from "./EnvironmentBuilder-jF-b7WQg.mjs";
-import { ApiGatewayV2, Bucket, Dynamo, Function, Postgres, ResourceProcessor, ResourceType, Secret, SnsTopic, SstEnvironmentBuilder, SstResource, Vpc, sstResolvers } from "./SstEnvironmentBuilder-BRAcRQp2.mjs";
+import { EnvRecord, EnvValue, EnvironmentBuilderOptions, EnvironmentResolver, InputValue, Resolvers, environmentCase } from "./EnvironmentBuilder-DHfDXJUm.mjs";
 
-//#region src/sst.d.ts
+//#region src/SstEnvironmentBuilder.d.ts
 
+/**
+ * Enumeration of supported SST (Serverless Stack Toolkit) resource types.
+ * Used to identify and process different AWS and SST resources.
+ */
+declare enum ResourceType {
+  ApiGatewayV2 = "sst.aws.ApiGatewayV2",
+  Postgres = "sst.aws.Postgres",
+  Function = "sst.aws.Function",
+  Bucket = "sst.aws.Bucket",
+  Vpc = "sst.aws.Vpc",
+  Secret = "sst.sst.Secret",
+  Dynamo = "sst.aws.Dynamo",
+  SSTSecret = "sst:sst:Secret",
+  SSTFunction = "sst:sst:Function",
+  SSTApiGatewayV2 = "sst:aws:ApiGatewayV2",
+  SSTPostgres = "sst:aws:Postgres",
+  SSTBucket = "sst:aws:Bucket",
+  SnsTopic = "sst:aws:SnsTopic",
+  SSTDynamo = "sst:aws:Dynamo",
+}
+/**
+ * AWS API Gateway V2 resource type.
+ * Represents an HTTP/WebSocket API.
+ */
+type ApiGatewayV2 = {
+  type: ResourceType.ApiGatewayV2 | ResourceType.SSTApiGatewayV2;
+  url: string;
+};
+/**
+ * PostgreSQL database resource type.
+ * Contains all connection details needed to connect to the database.
+ */
+type Postgres = {
+  type: ResourceType.Postgres | ResourceType.SSTPostgres;
+  database: string;
+  host: string;
+  password: string;
+  port: number;
+  username: string;
+};
+/**
+ * AWS Lambda Function resource type.
+ */
+type Function = {
+  type: ResourceType.Function | ResourceType.SSTFunction;
+  name: string;
+};
+/**
+ * AWS S3 Bucket resource type.
+ */
+type Bucket = {
+  type: ResourceType.Bucket | ResourceType.SSTBucket;
+  name: string;
+};
+/**
+ * AWS VPC (Virtual Private Cloud) resource type.
+ */
+type Vpc = {
+  type: ResourceType.Vpc;
+  bastion: string;
+};
+/**
+ * Secret resource type for storing sensitive values.
+ */
+type Secret = {
+  type: ResourceType.Secret | ResourceType.SSTSecret;
+  value: string;
+};
+/**
+ * AWS SNS Topic resource type.
+ */
+type SnsTopic = {
+  type: ResourceType.SnsTopic;
+  arn: string;
+};
+/**
+ * AWS DynamoDB Table resource type.
+ */
+type Dynamo = {
+  type: ResourceType.Dynamo | ResourceType.SSTDynamo;
+  name: string;
+};
+/**
+ * Union type of all supported SST resource types.
+ */
+type SstResource = ApiGatewayV2 | Postgres | Function | Bucket | Vpc | Secret | SnsTopic | Dynamo;
+/**
+ * Function type for processing a specific resource type into environment variables.
+ *
+ * @template K - The specific resource type (without `type` key)
+ * @param name - The resource name
+ * @param value - The resource value (without `type` key)
+ * @returns Object mapping environment variable names to values
+ */
+type ResourceProcessor<K> = (name: string, value: K) => EnvRecord;
+/**
+ * Pre-configured resolvers for all SST resource types.
+ */
+declare const sstResolvers: Resolvers;
+/**
+ * All known SST resource type strings.
+ */
+type SstResourceTypeString = `${ResourceType}`;
+/**
+ * Extracts the `type` string value from an input value.
+ */
+type ExtractType<T> = T extends {
+  type: infer U extends string;
+} ? U : never;
+/**
+ * Removes the `type` key from an object type.
+ */
+type OmitType<T> = T extends {
+  type: string;
+} ? Omit<T, 'type'> : never;
+/**
+ * Extracts all unique `type` values from a record (excluding plain strings).
+ */
+type AllTypeValues<TRecord extends Record<string, InputValue>> = { [K in keyof TRecord]: ExtractType<TRecord[K]> }[keyof TRecord];
+/**
+ * Extracts only the custom (non-SST) type values from a record.
+ */
+type CustomTypeValues<TRecord extends Record<string, InputValue>> = Exclude<AllTypeValues<TRecord>, SstResourceTypeString>;
+/**
+ * For a given type value, finds the corresponding value type (without `type` key).
+ */
+type ValueForType<TRecord extends Record<string, InputValue>, TType extends string> = { [K in keyof TRecord]: TRecord[K] extends {
+  type: TType;
+} ? OmitType<TRecord[K]> : never }[keyof TRecord];
+/**
+ * Generates typed resolvers for custom (non-SST) types in the input record.
+ */
+type CustomResolvers<TRecord extends Record<string, InputValue>> = CustomTypeValues<TRecord> extends never ? Resolvers | undefined : { [TType in CustomTypeValues<TRecord>]: EnvironmentResolver<ValueForType<TRecord, TType>> };
+/**
+ * SST-specific environment builder with built-in resolvers for all known
+ * SST resource types.
+ *
+ * Wraps the generic EnvironmentBuilder with pre-configured SST resolvers.
+ *
+ * @template TRecord - The input record type for type inference
+ *
+ * @example
+ * ```typescript
+ * const env = new SstEnvironmentBuilder({
+ *   database: { type: 'sst:aws:Postgres', host: '...', ... },
+ *   apiKey: { type: 'sst:sst:Secret', value: 'secret' },
+ *   appName: 'my-app',
+ * }).build();
+ *
+ * // With custom resolvers (typed based on input)
+ * const env = new SstEnvironmentBuilder(
+ *   {
+ *     database: postgresResource,
+ *     custom: { type: 'my-custom' as const, data: 'foo' },
+ *   },
+ *   {
+ *     // TypeScript requires 'my-custom' resolver with typed value
+ *     'my-custom': (key, value) => ({ [`${key}Data`]: value.data }),
+ *   }
+ * ).build();
+ * ```
+ */
+declare class SstEnvironmentBuilder<TRecord extends Record<string, SstResource | InputValue | string>> {
+  private readonly builder;
+  /**
+   * Create a new SST environment builder.
+   *
+   * @param record - Object containing SST resources, custom resources, and/or string values
+   * @param additionalResolvers - Optional custom resolvers (typed based on custom types in record)
+   * @param options - Optional configuration options
+   */
+  constructor(record: TRecord, additionalResolvers?: CustomResolvers<TRecord>, options?: EnvironmentBuilderOptions);
+  /**
+   * Build environment variables from the input record.
+   *
+   * @returns A record of environment variables
+   */
+  build(): EnvRecord;
+}
+//#endregion
+//#region src/sst.d.ts
 /**
  * @deprecated Use `new SstEnvironmentBuilder(record).build()` instead.
  *
@@ -25,6 +205,7 @@ declare function normalizeResourceEnv(record: Record<string, SstResource | strin
  */
 type Resource = SstResource;
 //# sourceMappingURL=sst.d.ts.map
+
 //#endregion
 export { ApiGatewayV2, Bucket, Dynamo, EnvRecord, EnvValue, EnvironmentBuilderOptions, Function, Postgres, Resource, ResourceProcessor, ResourceType, Secret, SnsTopic, SstEnvironmentBuilder, SstResource, Vpc, environmentCase, normalizeResourceEnv, sstResolvers };
 //# sourceMappingURL=sst.d.mts.map

package/dist/sst.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"sst.d.mts","names":[],"sources":["../src/sst.ts"],"sourcesContent":[],"mappings":";;;;;AAiDA;;;;;;AAES;AAQT;;;;;;;;;iBAVgB,oBAAA,SACP,eAAe,wBACrB,2CAA2C;;;;KAQlC,QAAA,GAAW"}
+{"version":3,"file":"sst.d.mts","names":[],"sources":["../src/SstEnvironmentBuilder.ts","../src/sst.ts"],"sourcesContent":[],"mappings":";;;;;;AAaA;AAwBA;AAAwB,aAxBZ,YAAA;EAwBY,YACjB,GAAA,sBAAa;EAAY,QAAG,GAAA,kBAAa;EAAe,QAAA,GAAA,kBAAA;EAQnD,MAAA,GAAA,gBAAQ;EAAA,GAAA,GAAA,aAAA;EAAA,MACb,GAAA,gBAAa;EAAQ,MAAG,GAAA,gBAAa;EAAW,SAAA,GAAA,gBAAA;EAW3C,WAAQ,GAAA,kBAAA;EAAA,eAAA,GAAA,sBAAA;EAAA,WACb,GAAA,kBAAa;EAAQ,SAAG,GAAA,gBAAa;EAAW,QAAA,GAAA,kBAAA;EAO3C,SAAM,GAAA,gBAAA;;;;AACiC;AAOnD;AAQY,KA7CA,YAAA,GA6CM;EAAA,IAAA,EA5CX,YAAA,CAAa,YA4CF,GA5CiB,YAAA,CAAa,eA4C9B;EAAA,GACX,EAAA,MAAA;CAAmB;AAAyB;AAOnD;AAQA;;AACO,KArDK,QAAA,GAqDQ;EAAM,IAAG,EApDtB,YAAA,CAAa,QAoDsB,GApDX,YAAA,CAAa,WAoDF;EAAS,QAAA,EAAA,MAAA;EAOvC,IAAA,EAAA,MAAA;EAAW,QAAA,EAAA,MAAA;EAAA,IACpB,EAAA,MAAA;EAAY,QACZ,EAAA,MAAA;CAAQ;;;;AAKR,KAvDS,QAAA,GAuDT;EAAQ,IACR,EAvDI,YAAA,CAAa,QAuDjB,GAvD4B,YAAA,CAAa,WAuDzC;EAAM,IAAA,EAAA,MAAA;AAiBT,CAAA;;;;AAAwE,KAjE5D,MAAA,GAiE4D;EAiC3D,IAAA,EAjGN,YAAA,CAAa,MAmHnB,GAnH4B,YAAA,CAAa,SAmHzC;EAKI,IAAA,EAAA,MAAA;AAAuC,CAAA;;;;AAKwB,KAtHxD,GAAA,GAsHwD;EAK/D,IAAA,EA1HE,YAAA,CAAa,GA0HP;EAAA,OAAA,EAAA,MAAA;CAAA;;;AAAuC;AAK/C,KAxHO,MAAA,GAwHM;EAAA,IAAA,EAvHX,YAAA,CAAa,MAuHF,GAvHW,YAAA,CAAa,SAuHxB;EAAA,KAAgC,EAAA,MAAA;CAAU;;;;AACrC,KAjHX,QAAA,GAiHW;EAAW,IAC1B,EAjHD,YAAA,CAAa,QAiHZ;EAAO,GAAA,EAAA,MAAA;AAAA,CAAA;;;;AAMA,KAhHH,MAAA,GAgHG;EAAO,IAArB,EA/GM,YAAA,CAAa,MA+GnB,GA/G4B,YAAA,CAAa,SA+GzC;EAAa,IACb,EAAA,MAAA;CAAqB;AAFqD;AAAA;;AAS3C,KAhHpB,WAAA,GACT,YA+G6B,GA9G7B,QA8G6B,GA7G7B,QA6G6B,GA5G7B,MA4G6B,GA3G7B,GA2G6B,GA1G7B,MA0G6B,GAzG7B,QAyG6B,GAxG7B,MAwG6B;;;;;;;;;AAMxB,KA7FI,iBA6FJ,CAAA,CAAA,CAAA,GAAA,CAAA,IAAA,EAAA,MAAA,EAAA,KAAA,EA7FiD,CA6FjD,EAAA,GA7FuD,SA6FvD;AAAO;AAAA;;AAKqC,cAjEvC,YAiEuC,EAjEzB,SAiEyB;;;;KA1C/C,qBAAA,GA4CD,GA5C4B,YA4C5B,EAAA;;;;KAvCC,WA0CsB,CAAA,CAAA,CAAA,GA1CL,CA0CK,SAAA;EAAK,IAA3B,EAAA,KAAA,WAAA,MAAA;CAAY,GA1CkD,CA0ClD,GADyB,KAAA;AAAmB;AAkC7D;;KAtEK,QAuE2B,CAAA,CAAA,CAAA,GAvEb,CAuEa,SAAA;EAAW,IAAG,EAAA,MAAA;CAAU,GAvER,IAuE/B,CAvEoC,CAuEpC,EAAA,MAAA,CAAA,GAAA,KAAA;;;;KAlEZ,aAmFO,CAAA,gBAnFuB,MAmFvB,CAAA,MAAA,EAnFsC,UAmFtC,CAAA,CAAA,GAAA,QAmBF,MArGG,OAqGH,GArGa,WAqGb,CArGyB,OAqGzB,CArGiC,CAqGjC,CAAA,CAAA,EAAS,CAAA,MApGX,OAoGW,CAAA;;;;AC/PnB,KDgKK,gBChKW,CAAA,gBDgKsB,MChKF,CAAA,MAAA,EDgKiB,UChKjB,CAAA,CAAA,GDgKgC,OChKhC,CDiKnC,aCjKmC,CDiKrB,OCjKqB,CAAA,EDkKnC,qBClKmC,CAAA;;;;KDwK/B,YCtKyC,CAAA,gBDuK7B,MCvK6B,CAAA,MAAA,EDuKd,UCvKc,CAAA,EAAA,cAAA,MAAA,CAAA,GAAA,QAA3C,MD0KU,OC1KV,GD0KoB,OC1KpB,CD0K4B,CC1K5B,CAAA,SAAA;EAAM,IAAA,ED0KyC,KC1KzC;AAQG,CAAA,GDmKR,QCnKgB,CDmKP,OCnKO,CDmKC,CCnKE,CAAA,CAAA,GAAA,KAAW,SDqK1B;;;;KAKH,gCAAgC,eAAe,eACnD,iBAAiB,yBACd,oCAEU,iBAAiB,WAAW,oBACrC,aAAa,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAiCd,sCACI,eAAe,cAAc;;;;;;;;;sBAepC,+BACc,gBAAgB,oBAC5B;;;;;;WAmBF;;;;AA3QV;;;;AAC+D;AAQ/D;;;;AACuD;AAWvD;;;;AACuD;AAOvD;AAAkB,iBCjBF,oBAAA,CDiBE,MAAA,EChBT,MDgBS,CAAA,MAAA,EChBM,WDgBN,GAAA,MAAA,CAAA,CAAA,ECff,MDee,CAAA,MAAA,EAAA,MAAA,GAAA,MAAA,GAAA,OAAA,GCf4B,MDe5B,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA;;;AACiC;AAOvC,KCfA,QAAA,GAAW,WDgBH;AAOpB"}

package/dist/sst.mjs

@@ -1,6 +1,114 @@
-import { environmentCase } from "./EnvironmentBuilder-BSuHZm0y.mjs";
-import { ResourceType, SstEnvironmentBuilder, sstResolvers } from "./SstEnvironmentBuilder-DOu4dVPL.mjs";
+import { EnvironmentBuilder, environmentCase } from "./EnvironmentBuilder-CFen3oIg.mjs";
 
+//#region src/SstEnvironmentBuilder.ts
+/**
+* Enumeration of supported SST (Serverless Stack Toolkit) resource types.
+* Used to identify and process different AWS and SST resources.
+*/
+let ResourceType = /* @__PURE__ */ function(ResourceType$1) {
+	ResourceType$1["ApiGatewayV2"] = "sst.aws.ApiGatewayV2";
+	ResourceType$1["Postgres"] = "sst.aws.Postgres";
+	ResourceType$1["Function"] = "sst.aws.Function";
+	ResourceType$1["Bucket"] = "sst.aws.Bucket";
+	ResourceType$1["Vpc"] = "sst.aws.Vpc";
+	ResourceType$1["Secret"] = "sst.sst.Secret";
+	ResourceType$1["Dynamo"] = "sst.aws.Dynamo";
+	ResourceType$1["SSTSecret"] = "sst:sst:Secret";
+	ResourceType$1["SSTFunction"] = "sst:sst:Function";
+	ResourceType$1["SSTApiGatewayV2"] = "sst:aws:ApiGatewayV2";
+	ResourceType$1["SSTPostgres"] = "sst:aws:Postgres";
+	ResourceType$1["SSTBucket"] = "sst:aws:Bucket";
+	ResourceType$1["SnsTopic"] = "sst:aws:SnsTopic";
+	ResourceType$1["SSTDynamo"] = "sst:aws:Dynamo";
+	return ResourceType$1;
+}({});
+const secretResolver = (name, value) => ({ [name]: value.value });
+const postgresResolver = (key, value) => ({
+	[`${key}Name`]: value.database,
+	[`${key}Host`]: value.host,
+	[`${key}Password`]: value.password,
+	[`${key}Port`]: value.port,
+	[`${key}Username`]: value.username
+});
+const bucketResolver = (name, value) => ({ [`${name}Name`]: value.name });
+const topicResolver = (name, value) => ({ [`${name}Arn`]: value.arn });
+const dynamoResolver = (name, value) => ({ [`${name}Name`]: value.name });
+const noopResolver = () => ({});
+/**
+* Pre-configured resolvers for all SST resource types.
+*/
+const sstResolvers = {
+	[ResourceType.ApiGatewayV2]: noopResolver,
+	[ResourceType.Function]: noopResolver,
+	[ResourceType.Vpc]: noopResolver,
+	[ResourceType.Secret]: secretResolver,
+	[ResourceType.Postgres]: postgresResolver,
+	[ResourceType.Bucket]: bucketResolver,
+	[ResourceType.Dynamo]: dynamoResolver,
+	[ResourceType.SSTSecret]: secretResolver,
+	[ResourceType.SSTBucket]: bucketResolver,
+	[ResourceType.SSTFunction]: noopResolver,
+	[ResourceType.SSTPostgres]: postgresResolver,
+	[ResourceType.SSTApiGatewayV2]: noopResolver,
+	[ResourceType.SnsTopic]: topicResolver,
+	[ResourceType.SSTDynamo]: dynamoResolver
+};
+/**
+* SST-specific environment builder with built-in resolvers for all known
+* SST resource types.
+*
+* Wraps the generic EnvironmentBuilder with pre-configured SST resolvers.
+*
+* @template TRecord - The input record type for type inference
+*
+* @example
+* ```typescript
+* const env = new SstEnvironmentBuilder({
+*   database: { type: 'sst:aws:Postgres', host: '...', ... },
+*   apiKey: { type: 'sst:sst:Secret', value: 'secret' },
+*   appName: 'my-app',
+* }).build();
+*
+* // With custom resolvers (typed based on input)
+* const env = new SstEnvironmentBuilder(
+*   {
+*     database: postgresResource,
+*     custom: { type: 'my-custom' as const, data: 'foo' },
+*   },
+*   {
+*     // TypeScript requires 'my-custom' resolver with typed value
+*     'my-custom': (key, value) => ({ [`${key}Data`]: value.data }),
+*   }
+* ).build();
+* ```
+*/
+var SstEnvironmentBuilder = class {
+	builder;
+	/**
+	* Create a new SST environment builder.
+	*
+	* @param record - Object containing SST resources, custom resources, and/or string values
+	* @param additionalResolvers - Optional custom resolvers (typed based on custom types in record)
+	* @param options - Optional configuration options
+	*/
+	constructor(record, additionalResolvers, options) {
+		const mergedResolvers = additionalResolvers ? {
+			...sstResolvers,
+			...additionalResolvers
+		} : sstResolvers;
+		this.builder = new EnvironmentBuilder(record, mergedResolvers, options);
+	}
+	/**
+	* Build environment variables from the input record.
+	*
+	* @returns A record of environment variables
+	*/
+	build() {
+		return this.builder.build();
+	}
+};
+
+//#endregion
 //#region src/sst.ts
 /**
 * @deprecated Use `new SstEnvironmentBuilder(record).build()` instead.

package/dist/sst.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"sst.mjs","names":["record: Record<string, SstResource | string>"],"sources":["../src/sst.ts"],"sourcesContent":["// Re-export everything from SstEnvironmentBuilder\n\n// Re-export types from EnvironmentBuilder\nexport type {\n\tEnvironmentBuilderOptions,\n\tEnvRecord,\n\tEnvValue,\n} from './EnvironmentBuilder';\n\n// Re-export environmentCase from EnvironmentBuilder\nexport { environmentCase } from './EnvironmentBuilder';\nexport {\n\ttype ApiGatewayV2,\n\ttype Bucket,\n\ttype Dynamo,\n\ttype Function,\n\ttype Postgres,\n\ttype ResourceProcessor,\n\tResourceType,\n\ttype Secret,\n\ttype SnsTopic,\n\tSstEnvironmentBuilder,\n\ttype SstResource,\n\tsstResolvers,\n\ttype Vpc,\n} from './SstEnvironmentBuilder';\n\n// Import for deprecated function\nimport {\n\tSstEnvironmentBuilder,\n\ttype SstResource,\n} from './SstEnvironmentBuilder';\n\n/**\n * @deprecated Use `new SstEnvironmentBuilder(record).build()` instead.\n *\n * Normalizes SST resources and plain strings into environment variables.\n * Processes resources based on their type and converts names to environment case.\n *\n * @param record - Object containing resources and/or string values\n * @returns Normalized environment variables object\n *\n * @example\n * // Old usage (deprecated):\n * normalizeResourceEnv({ database: postgresResource })\n *\n * // New usage:\n * new SstEnvironmentBuilder({ database: postgresResource }).build()\n */\nexport function normalizeResourceEnv(\n\trecord: Record<string, SstResource | string>,\n): Record<string, string | number | boolean | Record<string, unknown>> {\n\treturn new SstEnvironmentBuilder(record).build();\n}\n\n// Keep Resource type as deprecated alias for backwards compatibility\n/**\n * @deprecated Use `SstResource` instead.\n */\nexport type Resource = SstResource;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAiDA,SAAgB,qBACfA,QACsE;AACtE,QAAO,IAAI,sBAAsB,QAAQ,OAAO;AAChD"}
+{"version":3,"file":"sst.mjs","names":["name: string","value: SecretValue","key: string","value: PostgresValue","value: BucketValue","value: SnsTopicValue","value: DynamoValue","sstResolvers: Resolvers","record: TRecord","additionalResolvers?: CustomResolvers<TRecord>","options?: EnvironmentBuilderOptions","mergedResolvers: Resolvers","record: Record<string, SstResource | string>"],"sources":["../src/SstEnvironmentBuilder.ts","../src/sst.ts"],"sourcesContent":["import {\n\tEnvironmentBuilder,\n\ttype EnvironmentBuilderOptions,\n\ttype EnvironmentResolver,\n\ttype EnvRecord,\n\ttype InputValue,\n\ttype Resolvers,\n} from './EnvironmentBuilder';\n\n/**\n * Enumeration of supported SST (Serverless Stack Toolkit) resource types.\n * Used to identify and process different AWS and SST resources.\n */\nexport enum ResourceType {\n\t// Legacy format (dot notation)\n\tApiGatewayV2 = 'sst.aws.ApiGatewayV2',\n\tPostgres = 'sst.aws.Postgres',\n\tFunction = 'sst.aws.Function',\n\tBucket = 'sst.aws.Bucket',\n\tVpc = 'sst.aws.Vpc',\n\tSecret = 'sst.sst.Secret',\n\tDynamo = 'sst.aws.Dynamo',\n\n\t// Modern format (colon notation)\n\tSSTSecret = 'sst:sst:Secret',\n\tSSTFunction = 'sst:sst:Function',\n\tSSTApiGatewayV2 = 'sst:aws:ApiGatewayV2',\n\tSSTPostgres = 'sst:aws:Postgres',\n\tSSTBucket = 'sst:aws:Bucket',\n\tSnsTopic = 'sst:aws:SnsTopic',\n\tSSTDynamo = 'sst:aws:Dynamo',\n}\n\n/**\n * AWS API Gateway V2 resource type.\n * Represents an HTTP/WebSocket API.\n */\nexport type ApiGatewayV2 = {\n\ttype: ResourceType.ApiGatewayV2 | ResourceType.SSTApiGatewayV2;\n\turl: string;\n};\n\n/**\n * PostgreSQL database resource type.\n * Contains all connection details needed to connect to the database.\n */\nexport type Postgres = {\n\ttype: ResourceType.Postgres | ResourceType.SSTPostgres;\n\tdatabase: string;\n\thost: string;\n\tpassword: string;\n\tport: number;\n\tusername: string;\n};\n\n/**\n * AWS Lambda Function resource type.\n */\nexport type Function = {\n\ttype: ResourceType.Function | ResourceType.SSTFunction;\n\tname: string;\n};\n\n/**\n * AWS S3 Bucket resource type.\n */\nexport type Bucket = {\n\ttype: ResourceType.Bucket | ResourceType.SSTBucket;\n\tname: string;\n};\n\n/**\n * AWS VPC (Virtual Private Cloud) resource type.\n */\nexport type Vpc = {\n\ttype: ResourceType.Vpc;\n\tbastion: string;\n};\n\n/**\n * Secret resource type for storing sensitive values.\n */\nexport type Secret = {\n\ttype: ResourceType.Secret | ResourceType.SSTSecret;\n\tvalue: string;\n};\n\n/**\n * AWS SNS Topic resource type.\n */\nexport type SnsTopic = {\n\ttype: ResourceType.SnsTopic;\n\tarn: string;\n};\n\n/**\n * AWS DynamoDB Table resource type.\n */\nexport type Dynamo = {\n\ttype: ResourceType.Dynamo | ResourceType.SSTDynamo;\n\tname: string;\n};\n\n/**\n * Union type of all supported SST resource types.\n */\nexport type SstResource =\n\t| ApiGatewayV2\n\t| Postgres\n\t| Function\n\t| Bucket\n\t| Vpc\n\t| Secret\n\t| SnsTopic\n\t| Dynamo;\n\n// Value types without the `type` key (for resolver parameters)\ntype SecretValue = Omit<Secret, 'type'>;\ntype PostgresValue = Omit<Postgres, 'type'>;\ntype BucketValue = Omit<Bucket, 'type'>;\ntype SnsTopicValue = Omit<SnsTopic, 'type'>;\ntype DynamoValue = Omit<Dynamo, 'type'>;\n\n/**\n * Function type for processing a specific resource type into environment variables.\n *\n * @template K - The specific resource type (without `type` key)\n * @param name - The resource name\n * @param value - The resource value (without `type` key)\n * @returns Object mapping environment variable names to values\n */\nexport type ResourceProcessor<K> = (name: string, value: K) => EnvRecord;\n\n// SST Resource Resolvers (receive values without `type` key)\n\nconst secretResolver = (name: string, value: SecretValue) => ({\n\t[name]: value.value,\n});\n\nconst postgresResolver = (key: string, value: PostgresValue) => ({\n\t[`${key}Name`]: value.database,\n\t[`${key}Host`]: value.host,\n\t[`${key}Password`]: value.password,\n\t[`${key}Port`]: value.port,\n\t[`${key}Username`]: value.username,\n});\n\nconst bucketResolver = (name: string, value: BucketValue) => ({\n\t[`${name}Name`]: value.name,\n});\n\nconst topicResolver = (name: string, value: SnsTopicValue) => ({\n\t[`${name}Arn`]: value.arn,\n});\n\nconst dynamoResolver = (name: string, value: DynamoValue) => ({\n\t[`${name}Name`]: value.name,\n});\n\nconst noopResolver = () => ({});\n\n/**\n * Pre-configured resolvers for all SST resource types.\n */\nexport const sstResolvers: Resolvers = {\n\t// Legacy format\n\t[ResourceType.ApiGatewayV2]: noopResolver,\n\t[ResourceType.Function]: noopResolver,\n\t[ResourceType.Vpc]: noopResolver,\n\t[ResourceType.Secret]: secretResolver,\n\t[ResourceType.Postgres]: postgresResolver,\n\t[ResourceType.Bucket]: bucketResolver,\n\t[ResourceType.Dynamo]: dynamoResolver,\n\n\t// Modern format\n\t[ResourceType.SSTSecret]: secretResolver,\n\t[ResourceType.SSTBucket]: bucketResolver,\n\t[ResourceType.SSTFunction]: noopResolver,\n\t[ResourceType.SSTPostgres]: postgresResolver,\n\t[ResourceType.SSTApiGatewayV2]: noopResolver,\n\t[ResourceType.SnsTopic]: topicResolver,\n\t[ResourceType.SSTDynamo]: dynamoResolver,\n};\n\n/**\n * All known SST resource type strings.\n */\ntype SstResourceTypeString = `${ResourceType}`;\n\n/**\n * Extracts the `type` string value from an input value.\n */\ntype ExtractType<T> = T extends { type: infer U extends string } ? U : never;\n\n/**\n * Removes the `type` key from an object type.\n */\ntype OmitType<T> = T extends { type: string } ? Omit<T, 'type'> : never;\n\n/**\n * Extracts all unique `type` values from a record (excluding plain strings).\n */\ntype AllTypeValues<TRecord extends Record<string, InputValue>> = {\n\t[K in keyof TRecord]: ExtractType<TRecord[K]>;\n}[keyof TRecord];\n\n/**\n * Extracts only the custom (non-SST) type values from a record.\n */\ntype CustomTypeValues<TRecord extends Record<string, InputValue>> = Exclude<\n\tAllTypeValues<TRecord>,\n\tSstResourceTypeString\n>;\n\n/**\n * For a given type value, finds the corresponding value type (without `type` key).\n */\ntype ValueForType<\n\tTRecord extends Record<string, InputValue>,\n\tTType extends string,\n> = {\n\t[K in keyof TRecord]: TRecord[K] extends { type: TType }\n\t\t? OmitType<TRecord[K]>\n\t\t: never;\n}[keyof TRecord];\n\n/**\n * Generates typed resolvers for custom (non-SST) types in the input record.\n */\ntype CustomResolvers<TRecord extends Record<string, InputValue>> =\n\tCustomTypeValues<TRecord> extends never\n\t\t? Resolvers | undefined\n\t\t: {\n\t\t\t\t[TType in CustomTypeValues<TRecord>]: EnvironmentResolver<\n\t\t\t\t\tValueForType<TRecord, TType>\n\t\t\t\t>;\n\t\t\t};\n\n/**\n * SST-specific environment builder with built-in resolvers for all known\n * SST resource types.\n *\n * Wraps the generic EnvironmentBuilder with pre-configured SST resolvers.\n *\n * @template TRecord - The input record type for type inference\n *\n * @example\n * ```typescript\n * const env = new SstEnvironmentBuilder({\n *   database: { type: 'sst:aws:Postgres', host: '...', ... },\n *   apiKey: { type: 'sst:sst:Secret', value: 'secret' },\n *   appName: 'my-app',\n * }).build();\n *\n * // With custom resolvers (typed based on input)\n * const env = new SstEnvironmentBuilder(\n *   {\n *     database: postgresResource,\n *     custom: { type: 'my-custom' as const, data: 'foo' },\n *   },\n *   {\n *     // TypeScript requires 'my-custom' resolver with typed value\n *     'my-custom': (key, value) => ({ [`${key}Data`]: value.data }),\n *   }\n * ).build();\n * ```\n */\nexport class SstEnvironmentBuilder<\n\tTRecord extends Record<string, SstResource | InputValue | string>,\n> {\n\tprivate readonly builder: EnvironmentBuilder<\n\t\tRecord<string, InputValue>,\n\t\tResolvers\n\t>;\n\n\t/**\n\t * Create a new SST environment builder.\n\t *\n\t * @param record - Object containing SST resources, custom resources, and/or string values\n\t * @param additionalResolvers - Optional custom resolvers (typed based on custom types in record)\n\t * @param options - Optional configuration options\n\t */\n\tconstructor(\n\t\trecord: TRecord,\n\t\tadditionalResolvers?: CustomResolvers<TRecord>,\n\t\toptions?: EnvironmentBuilderOptions,\n\t) {\n\t\t// Merge resolvers with custom ones taking precedence\n\t\tconst mergedResolvers: Resolvers = additionalResolvers\n\t\t\t? { ...sstResolvers, ...additionalResolvers }\n\t\t\t: sstResolvers;\n\n\t\tthis.builder = new EnvironmentBuilder(\n\t\t\trecord as Record<string, InputValue>,\n\t\t\tmergedResolvers,\n\t\t\toptions,\n\t\t);\n\t}\n\n\t/**\n\t * Build environment variables from the input record.\n\t *\n\t * @returns A record of environment variables\n\t */\n\tbuild(): EnvRecord {\n\t\treturn this.builder.build();\n\t}\n}\n\nexport type {\n\tEnvironmentBuilderOptions,\n\tEnvRecord,\n\tEnvValue,\n} from './EnvironmentBuilder';\n// Re-export useful types\nexport { environmentCase } from './EnvironmentBuilder';\n","// Re-export everything from SstEnvironmentBuilder\n\n// Re-export types from EnvironmentBuilder\nexport type {\n\tEnvironmentBuilderOptions,\n\tEnvRecord,\n\tEnvValue,\n} from './EnvironmentBuilder';\n\n// Re-export environmentCase from EnvironmentBuilder\nexport { environmentCase } from './EnvironmentBuilder';\nexport {\n\ttype ApiGatewayV2,\n\ttype Bucket,\n\ttype Dynamo,\n\ttype Function,\n\ttype Postgres,\n\ttype ResourceProcessor,\n\tResourceType,\n\ttype Secret,\n\ttype SnsTopic,\n\tSstEnvironmentBuilder,\n\ttype SstResource,\n\tsstResolvers,\n\ttype Vpc,\n} from './SstEnvironmentBuilder';\n\n// Import for deprecated function\nimport {\n\tSstEnvironmentBuilder,\n\ttype SstResource,\n} from './SstEnvironmentBuilder';\n\n/**\n * @deprecated Use `new SstEnvironmentBuilder(record).build()` instead.\n *\n * Normalizes SST resources and plain strings into environment variables.\n * Processes resources based on their type and converts names to environment case.\n *\n * @param record - Object containing resources and/or string values\n * @returns Normalized environment variables object\n *\n * @example\n * // Old usage (deprecated):\n * normalizeResourceEnv({ database: postgresResource })\n *\n * // New usage:\n * new SstEnvironmentBuilder({ database: postgresResource }).build()\n */\nexport function normalizeResourceEnv(\n\trecord: Record<string, SstResource | string>,\n): Record<string, string | number | boolean | Record<string, unknown>> {\n\treturn new SstEnvironmentBuilder(record).build();\n}\n\n// Keep Resource type as deprecated alias for backwards compatibility\n/**\n * @deprecated Use `SstResource` instead.\n */\nexport type Resource = SstResource;\n"],"mappings":";;;;;;;AAaA,IAAY,wDAAL;AAEN;AACA;AACA;AACA;AACA;AACA;AACA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;;AACA;AAwGD,MAAM,iBAAiB,CAACA,MAAcC,WAAwB,GAC5D,OAAO,MAAM,MACd;AAED,MAAM,mBAAmB,CAACC,KAAaC,WAA0B;GAC9D,EAAE,IAAI,QAAQ,MAAM;GACpB,EAAE,IAAI,QAAQ,MAAM;GACpB,EAAE,IAAI,YAAY,MAAM;GACxB,EAAE,IAAI,QAAQ,MAAM;GACpB,EAAE,IAAI,YAAY,MAAM;AAC1B;AAED,MAAM,iBAAiB,CAACH,MAAcI,WAAwB,IAC3D,EAAE,KAAK,QAAQ,MAAM,KACvB;AAED,MAAM,gBAAgB,CAACJ,MAAcK,WAA0B,IAC5D,EAAE,KAAK,OAAO,MAAM,IACtB;AAED,MAAM,iBAAiB,CAACL,MAAcM,WAAwB,IAC3D,EAAE,KAAK,QAAQ,MAAM,KACvB;AAED,MAAM,eAAe,OAAO,CAAE;;;;AAK9B,MAAaC,eAA0B;EAErC,aAAa,eAAe;EAC5B,aAAa,WAAW;EACxB,aAAa,MAAM;EACnB,aAAa,SAAS;EACtB,aAAa,WAAW;EACxB,aAAa,SAAS;EACtB,aAAa,SAAS;EAGtB,aAAa,YAAY;EACzB,aAAa,YAAY;EACzB,aAAa,cAAc;EAC3B,aAAa,cAAc;EAC3B,aAAa,kBAAkB;EAC/B,aAAa,WAAW;EACxB,aAAa,YAAY;AAC1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqFD,IAAa,wBAAb,MAEE;CACD,AAAiB;;;;;;;;CAYjB,YACCC,QACAC,qBACAC,SACC;EAED,MAAMC,kBAA6B,sBAChC;GAAE,GAAG;GAAc,GAAG;EAAqB,IAC3C;AAEH,OAAK,UAAU,IAAI,mBAClB,QACA,iBACA;CAED;;;;;;CAOD,QAAmB;AAClB,SAAO,KAAK,QAAQ,OAAO;CAC3B;AACD;;;;;;;;;;;;;;;;;;;;AClQD,SAAgB,qBACfC,QACsE;AACtE,QAAO,IAAI,sBAAsB,QAAQ,OAAO;AAChD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/envkit",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "private": false,
   "type": "module",
   "exports": {
@@ -42,8 +42,9 @@
     "zod": "~4.1.13"
   },
   "devDependencies": {
-    "@types/lodash.set": "~4.3.9",
     "@types/lodash.get": "~4.4.9",
-    "@types/lodash.snakecase": "~4.1.9"
+    "@types/lodash.set": "~4.3.9",
+    "@types/lodash.snakecase": "~4.1.9",
+    "@types/node": "~22.0.0"
   }
 }

package/src/SnifferEnvironmentParser.ts

@@ -26,10 +26,12 @@ import {
  */
 export class SnifferEnvironmentParser<_T extends EmptyObject = EmptyObject> {
 	private readonly accessedVars: Set<string> = new Set();
+	private readonly optionalVars: Set<string> = new Set();
 
 	/**
 	 * Wraps a Zod schema to always return mock values.
 	 * This ensures .parse() and .safeParse() never fail.
+	 * Also detects when .optional() or .default() is called to track optional vars.
 	 */
 	private wrapSchema = (schema: z.ZodType, name: string): z.ZodType => {
 		return new Proxy(schema, {
@@ -45,6 +47,11 @@ export class SnifferEnvironmentParser<_T extends EmptyObject = EmptyObject> {
 					});
 				}
 
+				// Detect .optional() or .default() — mark the variable as optional
+				if (prop === 'optional' || prop === 'default') {
+					this.optionalVars.add(name);
+				}
+
 				const originalProp = target[prop as keyof typeof target];
 				if (typeof originalProp === 'function') {
 					return (...args: any[]) => {
@@ -141,9 +148,24 @@ export class SnifferEnvironmentParser<_T extends EmptyObject = EmptyObject> {
 
 	/**
 	 * Returns all environment variable names that were accessed.
+	 *
+	 * @param opts.markOptional - When true, optional variables (those accessed
+	 *   via `.optional()` or `.default()`) are suffixed with `?` (e.g. `PORT?`).
 	 */
-	getEnvironmentVariables(): string[] {
-		return Array.from(this.accessedVars).sort();
+	getEnvironmentVariables(opts?: { markOptional?: boolean }): string[] {
+		const vars = Array.from(this.accessedVars).sort();
+		if (!opts?.markOptional) return vars;
+		return vars.map((name) =>
+			this.optionalVars.has(name) ? `${name}?` : name,
+		);
+	}
+
+	/**
+	 * Returns all environment variable names that were accessed via
+	 * `.optional()` or `.default()` — i.e. variables that are not required.
+	 */
+	getOptionalVariables(): string[] {
+		return Array.from(this.optionalVars).sort();
 	}
 }
 
@@ -212,8 +234,13 @@ class SnifferConfigParser<
  * Result of sniffing with fire-and-forget handling.
  */
 export interface SniffResult {
-	/** Environment variables that were accessed during sniffing */
+	/** All environment variable names that were accessed during sniffing */
 	envVars: string[];
+	/**
+	 * Subset of envVars that are optional (accessed via `.optional()` or
+	 * `.default()`). These do not need to be present for the app to start.
+	 */
+	optionalEnvVars: string[];
 	/** Error thrown during sniffing (env vars may still be captured) */
 	error?: Error;
 	/** Unhandled promise rejections captured during sniffing */
@@ -300,6 +327,7 @@ export async function sniffWithFireAndForget(
 
 	return {
 		envVars: sniffer.getEnvironmentVariables(),
+		optionalEnvVars: sniffer.getOptionalVariables(),
 		error,
 		unhandledRejections,
 	};