@geekmidas/envkit 0.0.8 → 0.1.0

package/dist/SnifferEnvironmentParser.mjs

@@ -1,4 +1,4 @@
-import { ConfigParser } from "./EnvironmentParser-STvN_RCc.mjs";
+import { ConfigParser } from "./EnvironmentParser-c06agx31.mjs";
 import { z } from "zod/v4";
 
 //#region src/SnifferEnvironmentParser.ts

package/dist/SnifferEnvironmentParser.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"SnifferEnvironmentParser.mjs","names":["schema: z.ZodType","name: string","result: Record<string, unknown>","builder: (get: EnvFetcher) => TReturn","config: T","result: EmptyObject"],"sources":["../src/SnifferEnvironmentParser.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport {\n  ConfigParser,\n  type EmptyObject,\n  type EnvFetcher,\n} from './EnvironmentParser';\n\n/**\n * A specialized EnvironmentParser for build-time analysis that tracks\n * which environment variables are accessed without requiring actual values.\n *\n * Unlike the regular EnvironmentParser, the sniffer:\n * - Always returns mock values from .parse() and .safeParse()\n * - Never throws validation errors\n * - Tracks all accessed environment variable names\n *\n * This allows service registration to succeed during build-time analysis\n * even when environment variables are not set.\n *\n * @example\n * ```typescript\n * const sniffer = new SnifferEnvironmentParser();\n * await service.register(sniffer); // Always succeeds\n * const envVars = sniffer.getEnvironmentVariables(); // ['DATABASE_URL', 'API_KEY']\n * ```\n */\nexport class SnifferEnvironmentParser<\n  T extends EmptyObject = EmptyObject,\n> {\n  private readonly accessedVars: Set<string> = new Set();\n\n  /**\n   * Wraps a Zod schema to always return mock values.\n   * This ensures .parse() and .safeParse() never fail.\n   */\n  private wrapSchema = (schema: z.ZodType, name: string): z.ZodType => {\n    return new Proxy(schema, {\n      get: (target, prop) => {\n        if (prop === 'parse') {\n          return () => this.getMockValue(target);\n        }\n\n        if (prop === 'safeParse') {\n          return () => ({\n            success: true as const,\n            data: this.getMockValue(target),\n          });\n        }\n\n        const originalProp = target[prop as keyof typeof target];\n        if (typeof originalProp === 'function') {\n          return (...args: any[]) => {\n            const result = originalProp.apply(target, args);\n            if (result && typeof result === 'object' && 'parse' in result) {\n              return this.wrapSchema(result, name);\n            }\n            return result;\n          };\n        }\n\n        return originalProp;\n      },\n    });\n  };\n\n  /**\n   * Returns a mock value based on the Zod schema type.\n   */\n  private getMockValue(schema: z.ZodType): unknown {\n    // Return type-appropriate mock values\n    if (schema instanceof z.ZodString) return '';\n    if (schema instanceof z.ZodNumber) return 0;\n    if (schema instanceof z.ZodBoolean) return false;\n    if (schema instanceof z.ZodArray) return [];\n    if (schema instanceof z.ZodOptional) return undefined;\n    if (schema instanceof z.ZodNullable) return null;\n\n    // For object schemas, build mock object from shape\n    if (schema instanceof z.ZodObject && schema.shape) {\n      const result: Record<string, unknown> = {};\n      for (const [key, value] of Object.entries(schema.shape)) {\n        if (value instanceof z.ZodType) {\n          result[key] = this.getMockValue(value);\n        }\n      }\n      return result;\n    }\n\n    return '';\n  }\n\n  /**\n   * Creates a proxied Zod getter that tracks environment variable access.\n   */\n  private getZodGetter = (name: string) => {\n    this.accessedVars.add(name);\n\n    return new Proxy(\n      { ...z },\n      {\n        get: (target, prop) => {\n          // @ts-ignore\n          const value = target[prop];\n\n          if (typeof value === 'function') {\n            return (...args: any[]) => {\n              const schema = value(...args);\n              return this.wrapSchema(schema, name);\n            };\n          }\n\n          if (value && typeof value === 'object') {\n            return new Proxy(value, {\n              get: (nestedTarget, nestedProp) => {\n                const nestedValue =\n                  nestedTarget[nestedProp as keyof typeof nestedTarget];\n                if (typeof nestedValue === 'function') {\n                  return (...args: any[]) => {\n                    const schema = nestedValue(...args);\n                    return this.wrapSchema(schema, name);\n                  };\n                }\n                return nestedValue;\n              },\n            });\n          }\n\n          return value;\n        },\n      },\n    );\n  };\n\n  /**\n   * Creates a ConfigParser that will return mock values when parsed.\n   */\n  create<TReturn extends EmptyObject>(\n    builder: (get: EnvFetcher) => TReturn,\n  ): ConfigParser<TReturn> {\n    const config = builder(this.getZodGetter);\n    return new SnifferConfigParser(config, this.accessedVars);\n  }\n\n  /**\n   * Returns all environment variable names that were accessed.\n   */\n  getEnvironmentVariables(): string[] {\n    return Array.from(this.accessedVars).sort();\n  }\n}\n\n/**\n * A ConfigParser that always succeeds with mock values.\n */\nclass SnifferConfigParser<TResponse extends EmptyObject> extends ConfigParser<TResponse> {\n  parse(): any {\n    return this.parseWithMocks(this.getConfig());\n  }\n\n  private getConfig(): TResponse {\n    // Access the private config via any cast\n    return (this as any).config;\n  }\n\n  private parseWithMocks<T>(config: T): any {\n    const result: EmptyObject = {};\n\n    if (config && typeof config !== 'object') {\n      return config;\n    }\n\n    for (const key in config) {\n      const schema = config[key];\n\n      if (schema instanceof z.ZodType) {\n        // Use safeParse which will return mock values from our wrapped schema\n        const parsed = schema.safeParse(undefined);\n        result[key] = parsed.success ? parsed.data : this.getDefaultForSchema(schema);\n      } else if (schema && typeof schema === 'object') {\n        result[key] = this.parseWithMocks(schema as EmptyObject);\n      }\n    }\n\n    return result;\n  }\n\n  private getDefaultForSchema(schema: z.ZodType): unknown {\n    if (schema instanceof z.ZodString) return '';\n    if (schema instanceof z.ZodNumber) return 0;\n    if (schema instanceof z.ZodBoolean) return false;\n    if (schema instanceof z.ZodArray) return [];\n    if (schema instanceof z.ZodOptional) return undefined;\n    if (schema instanceof z.ZodNullable) return null;\n\n    if (schema instanceof z.ZodObject && schema.shape) {\n      const result: Record<string, unknown> = {};\n      for (const [key, value] of Object.entries(schema.shape)) {\n        if (value instanceof z.ZodType) {\n          result[key] = this.getDefaultForSchema(value);\n        }\n      }\n      return result;\n    }\n\n    return '';\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"SnifferEnvironmentParser.mjs","names":["schema: z.ZodType","name: string","result: Record<string, unknown>","builder: (get: EnvFetcher) => TReturn","config: T","result: EmptyObject"],"sources":["../src/SnifferEnvironmentParser.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport {\n  ConfigParser,\n  type EmptyObject,\n  type EnvFetcher,\n} from './EnvironmentParser';\n\n/**\n * A specialized EnvironmentParser for build-time analysis that tracks\n * which environment variables are accessed without requiring actual values.\n *\n * Unlike the regular EnvironmentParser, the sniffer:\n * - Always returns mock values from .parse() and .safeParse()\n * - Never throws validation errors\n * - Tracks all accessed environment variable names\n *\n * This allows service registration to succeed during build-time analysis\n * even when environment variables are not set.\n *\n * @example\n * ```typescript\n * const sniffer = new SnifferEnvironmentParser();\n * await service.register(sniffer); // Always succeeds\n * const envVars = sniffer.getEnvironmentVariables(); // ['DATABASE_URL', 'API_KEY']\n * ```\n */\nexport class SnifferEnvironmentParser<T extends EmptyObject = EmptyObject> {\n  private readonly accessedVars: Set<string> = new Set();\n\n  /**\n   * Wraps a Zod schema to always return mock values.\n   * This ensures .parse() and .safeParse() never fail.\n   */\n  private wrapSchema = (schema: z.ZodType, name: string): z.ZodType => {\n    return new Proxy(schema, {\n      get: (target, prop) => {\n        if (prop === 'parse') {\n          return () => this.getMockValue(target);\n        }\n\n        if (prop === 'safeParse') {\n          return () => ({\n            success: true as const,\n            data: this.getMockValue(target),\n          });\n        }\n\n        const originalProp = target[prop as keyof typeof target];\n        if (typeof originalProp === 'function') {\n          return (...args: any[]) => {\n            const result = originalProp.apply(target, args);\n            if (result && typeof result === 'object' && 'parse' in result) {\n              return this.wrapSchema(result, name);\n            }\n            return result;\n          };\n        }\n\n        return originalProp;\n      },\n    });\n  };\n\n  /**\n   * Returns a mock value based on the Zod schema type.\n   */\n  private getMockValue(schema: z.ZodType): unknown {\n    // Return type-appropriate mock values\n    if (schema instanceof z.ZodString) return '';\n    if (schema instanceof z.ZodNumber) return 0;\n    if (schema instanceof z.ZodBoolean) return false;\n    if (schema instanceof z.ZodArray) return [];\n    if (schema instanceof z.ZodOptional) return undefined;\n    if (schema instanceof z.ZodNullable) return null;\n\n    // For object schemas, build mock object from shape\n    if (schema instanceof z.ZodObject && schema.shape) {\n      const result: Record<string, unknown> = {};\n      for (const [key, value] of Object.entries(schema.shape)) {\n        if (value instanceof z.ZodType) {\n          result[key] = this.getMockValue(value);\n        }\n      }\n      return result;\n    }\n\n    return '';\n  }\n\n  /**\n   * Creates a proxied Zod getter that tracks environment variable access.\n   */\n  private getZodGetter = (name: string) => {\n    this.accessedVars.add(name);\n\n    return new Proxy(\n      { ...z },\n      {\n        get: (target, prop) => {\n          // @ts-ignore\n          const value = target[prop];\n\n          if (typeof value === 'function') {\n            return (...args: any[]) => {\n              const schema = value(...args);\n              return this.wrapSchema(schema, name);\n            };\n          }\n\n          if (value && typeof value === 'object') {\n            return new Proxy(value, {\n              get: (nestedTarget, nestedProp) => {\n                const nestedValue =\n                  nestedTarget[nestedProp as keyof typeof nestedTarget];\n                if (typeof nestedValue === 'function') {\n                  return (...args: any[]) => {\n                    const schema = nestedValue(...args);\n                    return this.wrapSchema(schema, name);\n                  };\n                }\n                return nestedValue;\n              },\n            });\n          }\n\n          return value;\n        },\n      },\n    );\n  };\n\n  /**\n   * Creates a ConfigParser that will return mock values when parsed.\n   */\n  create<TReturn extends EmptyObject>(\n    builder: (get: EnvFetcher) => TReturn,\n  ): ConfigParser<TReturn> {\n    const config = builder(this.getZodGetter);\n    return new SnifferConfigParser(config, this.accessedVars);\n  }\n\n  /**\n   * Returns all environment variable names that were accessed.\n   */\n  getEnvironmentVariables(): string[] {\n    return Array.from(this.accessedVars).sort();\n  }\n}\n\n/**\n * A ConfigParser that always succeeds with mock values.\n */\nclass SnifferConfigParser<\n  TResponse extends EmptyObject,\n> extends ConfigParser<TResponse> {\n  parse(): any {\n    return this.parseWithMocks(this.getConfig());\n  }\n\n  private getConfig(): TResponse {\n    // Access the private config via any cast\n    return (this as any).config;\n  }\n\n  private parseWithMocks<T>(config: T): any {\n    const result: EmptyObject = {};\n\n    if (config && typeof config !== 'object') {\n      return config;\n    }\n\n    for (const key in config) {\n      const schema = config[key];\n\n      if (schema instanceof z.ZodType) {\n        // Use safeParse which will return mock values from our wrapped schema\n        const parsed = schema.safeParse(undefined);\n        result[key] = parsed.success\n          ? parsed.data\n          : this.getDefaultForSchema(schema);\n      } else if (schema && typeof schema === 'object') {\n        result[key] = this.parseWithMocks(schema as EmptyObject);\n      }\n    }\n\n    return result;\n  }\n\n  private getDefaultForSchema(schema: z.ZodType): unknown {\n    if (schema instanceof z.ZodString) return '';\n    if (schema instanceof z.ZodNumber) return 0;\n    if (schema instanceof z.ZodBoolean) return false;\n    if (schema instanceof z.ZodArray) return [];\n    if (schema instanceof z.ZodOptional) return undefined;\n    if (schema instanceof z.ZodNullable) return null;\n\n    if (schema instanceof z.ZodObject && schema.shape) {\n      const result: Record<string, unknown> = {};\n      for (const [key, value] of Object.entries(schema.shape)) {\n        if (value instanceof z.ZodType) {\n          result[key] = this.getDefaultForSchema(value);\n        }\n      }\n      return result;\n    }\n\n    return '';\n  }\n}\n"],"mappings":"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"}

package/dist/SstEnvironmentBuilder-BuFw1hCe.cjs

@@ -0,0 +1,125 @@
+const require_EnvironmentBuilder = require('./EnvironmentBuilder-W2wku49g.cjs');
+
+//#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["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";
+	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 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.SSTSecret]: secretResolver,
+	[ResourceType.SSTBucket]: bucketResolver,
+	[ResourceType.SSTFunction]: noopResolver,
+	[ResourceType.SSTPostgres]: postgresResolver,
+	[ResourceType.SSTApiGatewayV2]: noopResolver,
+	[ResourceType.SnsTopic]: topicResolver
+};
+/**
+* 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 require_EnvironmentBuilder.EnvironmentBuilder(record, mergedResolvers, options);
+	}
+	/**
+	* Build environment variables from the input record.
+	*
+	* @returns A record of environment variables
+	*/
+	build() {
+		return this.builder.build();
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'ResourceType', {
+  enumerable: true,
+  get: function () {
+    return ResourceType;
+  }
+});
+Object.defineProperty(exports, 'SstEnvironmentBuilder', {
+  enumerable: true,
+  get: function () {
+    return SstEnvironmentBuilder;
+  }
+});
+Object.defineProperty(exports, 'sstResolvers', {
+  enumerable: true,
+  get: function () {
+    return sstResolvers;
+  }
+});
+//# sourceMappingURL=SstEnvironmentBuilder-BuFw1hCe.cjs.map

package/dist/SstEnvironmentBuilder-BuFw1hCe.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SstEnvironmentBuilder-BuFw1hCe.cjs","names":["name: string","value: SecretValue","key: string","value: PostgresValue","value: BucketValue","value: SnsTopicValue","sstResolvers: Resolvers","record: TRecord","additionalResolvers?: CustomResolvers<TRecord>","options?: EnvironmentBuilderOptions","mergedResolvers: Resolvers","EnvironmentBuilder"],"sources":["../src/SstEnvironmentBuilder.ts"],"sourcesContent":["import {\n  type EnvRecord,\n  EnvironmentBuilder,\n  type EnvironmentBuilderOptions,\n  type EnvironmentResolver,\n  type InputValue,\n  type 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  // Legacy format (dot notation)\n  ApiGatewayV2 = 'sst.aws.ApiGatewayV2',\n  Postgres = 'sst.aws.Postgres',\n  Function = 'sst.aws.Function',\n  Bucket = 'sst.aws.Bucket',\n  Vpc = 'sst.aws.Vpc',\n  Secret = 'sst.sst.Secret',\n\n  // Modern format (colon notation)\n  SSTSecret = 'sst:sst:Secret',\n  SSTFunction = 'sst:sst:Function',\n  SSTApiGatewayV2 = 'sst:aws:ApiGatewayV2',\n  SSTPostgres = 'sst:aws:Postgres',\n  SSTBucket = 'sst:aws:Bucket',\n  SnsTopic = 'sst:aws:SnsTopic',\n}\n\n/**\n * AWS API Gateway V2 resource type.\n * Represents an HTTP/WebSocket API.\n */\nexport type ApiGatewayV2 = {\n  type: ResourceType.ApiGatewayV2 | ResourceType.SSTApiGatewayV2;\n  url: 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  type: ResourceType.Postgres | ResourceType.SSTPostgres;\n  database: string;\n  host: string;\n  password: string;\n  port: number;\n  username: string;\n};\n\n/**\n * AWS Lambda Function resource type.\n */\nexport type Function = {\n  type: ResourceType.Function | ResourceType.SSTFunction;\n  name: string;\n};\n\n/**\n * AWS S3 Bucket resource type.\n */\nexport type Bucket = {\n  type: ResourceType.Bucket | ResourceType.SSTBucket;\n  name: string;\n};\n\n/**\n * AWS VPC (Virtual Private Cloud) resource type.\n */\nexport type Vpc = {\n  type: ResourceType.Vpc;\n  bastion: string;\n};\n\n/**\n * Secret resource type for storing sensitive values.\n */\nexport type Secret = {\n  type: ResourceType.Secret | ResourceType.SSTSecret;\n  value: string;\n};\n\n/**\n * AWS SNS Topic resource type.\n */\nexport type SnsTopic = {\n  type: ResourceType.SnsTopic;\n  arn: string;\n};\n\n/**\n * Union type of all supported SST resource types.\n */\nexport type SstResource =\n  | ApiGatewayV2\n  | Postgres\n  | Function\n  | Bucket\n  | Vpc\n  | Secret\n  | SnsTopic;\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'>;\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  [name]: value.value,\n});\n\nconst postgresResolver = (key: string, value: PostgresValue) => ({\n  [`${key}Name`]: value.database,\n  [`${key}Host`]: value.host,\n  [`${key}Password`]: value.password,\n  [`${key}Port`]: value.port,\n  [`${key}Username`]: value.username,\n});\n\nconst bucketResolver = (name: string, value: BucketValue) => ({\n  [`${name}Name`]: value.name,\n});\n\nconst topicResolver = (name: string, value: SnsTopicValue) => ({\n  [`${name}Arn`]: value.arn,\n});\n\nconst noopResolver = () => ({});\n\n/**\n * Pre-configured resolvers for all SST resource types.\n */\nexport const sstResolvers: Resolvers = {\n  // Legacy format\n  [ResourceType.ApiGatewayV2]: noopResolver,\n  [ResourceType.Function]: noopResolver,\n  [ResourceType.Vpc]: noopResolver,\n  [ResourceType.Secret]: secretResolver,\n  [ResourceType.Postgres]: postgresResolver,\n  [ResourceType.Bucket]: bucketResolver,\n\n  // Modern format\n  [ResourceType.SSTSecret]: secretResolver,\n  [ResourceType.SSTBucket]: bucketResolver,\n  [ResourceType.SSTFunction]: noopResolver,\n  [ResourceType.SSTPostgres]: postgresResolver,\n  [ResourceType.SSTApiGatewayV2]: noopResolver,\n  [ResourceType.SnsTopic]: topicResolver,\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  [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  AllTypeValues<TRecord>,\n  SstResourceTypeString\n>;\n\n/**\n * For a given type value, finds the corresponding value type (without `type` key).\n */\ntype ValueForType<\n  TRecord extends Record<string, InputValue>,\n  TType extends string,\n> = {\n  [K in keyof TRecord]: TRecord[K] extends { type: TType }\n    ? OmitType<TRecord[K]>\n    : 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  CustomTypeValues<TRecord> extends never\n    ? Resolvers | undefined\n    : {\n        [TType in CustomTypeValues<TRecord>]: EnvironmentResolver<\n          ValueForType<TRecord, TType>\n        >;\n      };\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  TRecord extends Record<string, SstResource | InputValue | string>,\n> {\n  private readonly builder: EnvironmentBuilder<\n    Record<string, InputValue>,\n    Resolvers\n  >;\n\n  /**\n   * Create a new SST environment builder.\n   *\n   * @param record - Object containing SST resources, custom resources, and/or string values\n   * @param additionalResolvers - Optional custom resolvers (typed based on custom types in record)\n   * @param options - Optional configuration options\n   */\n  constructor(\n    record: TRecord,\n    additionalResolvers?: CustomResolvers<TRecord>,\n    options?: EnvironmentBuilderOptions,\n  ) {\n    // Merge resolvers with custom ones taking precedence\n    const mergedResolvers: Resolvers = additionalResolvers\n      ? { ...sstResolvers, ...additionalResolvers }\n      : sstResolvers;\n\n    this.builder = new EnvironmentBuilder(\n      record as Record<string, InputValue>,\n      mergedResolvers,\n      options,\n    );\n  }\n\n  /**\n   * Build environment variables from the input record.\n   *\n   * @returns A record of environment variables\n   */\n  build(): EnvRecord {\n    return this.builder.build();\n  }\n}\n\n// Re-export useful types\nexport { environmentCase } from './EnvironmentBuilder';\nexport type {\n  EnvRecord,\n  EnvValue,\n  EnvironmentBuilderOptions,\n} from './EnvironmentBuilder';\n"],"mappings":";;;;;;;AAaA,IAAY,wDAAL;AAEL;AACA;AACA;AACA;AACA;AACA;AAGA;AACA;AACA;AACA;AACA;AACA;;AACD;AA8FD,MAAM,iBAAiB,CAACA,MAAcC,WAAwB,GAC3D,OAAO,MAAM,MACf;AAED,MAAM,mBAAmB,CAACC,KAAaC,WAA0B;GAC7D,EAAE,IAAI,QAAQ,MAAM;GACpB,EAAE,IAAI,QAAQ,MAAM;GACpB,EAAE,IAAI,YAAY,MAAM;GACxB,EAAE,IAAI,QAAQ,MAAM;GACpB,EAAE,IAAI,YAAY,MAAM;AAC3B;AAED,MAAM,iBAAiB,CAACH,MAAcI,WAAwB,IAC1D,EAAE,KAAK,QAAQ,MAAM,KACxB;AAED,MAAM,gBAAgB,CAACJ,MAAcK,WAA0B,IAC3D,EAAE,KAAK,OAAO,MAAM,IACvB;AAED,MAAM,eAAe,OAAO,CAAE;;;;AAK9B,MAAaC,eAA0B;EAEpC,aAAa,eAAe;EAC5B,aAAa,WAAW;EACxB,aAAa,MAAM;EACnB,aAAa,SAAS;EACtB,aAAa,WAAW;EACxB,aAAa,SAAS;EAGtB,aAAa,YAAY;EACzB,aAAa,YAAY;EACzB,aAAa,cAAc;EAC3B,aAAa,cAAc;EAC3B,aAAa,kBAAkB;EAC/B,aAAa,WAAW;AAC1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqFD,IAAa,wBAAb,MAEE;CACA,AAAiB;;;;;;;;CAYjB,YACEC,QACAC,qBACAC,SACA;EAEA,MAAMC,kBAA6B,sBAC/B;GAAE,GAAG;GAAc,GAAG;EAAqB,IAC3C;AAEJ,OAAK,UAAU,IAAIC,8CACjB,QACA,iBACA;CAEH;;;;;;CAOD,QAAmB;AACjB,SAAO,KAAK,QAAQ,OAAO;CAC5B;AACF"}

package/dist/SstEnvironmentBuilder-CjURMGjW.d.mts

@@ -0,0 +1,177 @@
+import { EnvRecord, EnvironmentBuilderOptions, EnvironmentResolver, InputValue, Resolvers } from "./EnvironmentBuilder-DHfDXJUm.mjs";
+
+//#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",
+  SSTSecret = "sst:sst:Secret",
+  SSTFunction = "sst:sst:Function",
+  SSTApiGatewayV2 = "sst:aws:ApiGatewayV2",
+  SSTPostgres = "sst:aws:Postgres",
+  SSTBucket = "sst:aws:Bucket",
+  SnsTopic = "sst:aws:SnsTopic",
+}
+/**
+ * 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;
+};
+/**
+ * Union type of all supported SST resource types.
+ */
+type SstResource = ApiGatewayV2 | Postgres | Function | Bucket | Vpc | Secret | SnsTopic;
+/**
+ * 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
+export { ApiGatewayV2, Bucket, Function, Postgres, ResourceProcessor, ResourceType, Secret, SnsTopic, SstEnvironmentBuilder, SstResource, Vpc, sstResolvers };
+//# sourceMappingURL=SstEnvironmentBuilder-CjURMGjW.d.mts.map

package/dist/SstEnvironmentBuilder-D4oSo_KX.d.cts

@@ -0,0 +1,177 @@
+import { EnvRecord, EnvironmentBuilderOptions, EnvironmentResolver, InputValue, Resolvers } from "./EnvironmentBuilder-Xuf2Dd9u.cjs";
+
+//#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",
+  SSTSecret = "sst:sst:Secret",
+  SSTFunction = "sst:sst:Function",
+  SSTApiGatewayV2 = "sst:aws:ApiGatewayV2",
+  SSTPostgres = "sst:aws:Postgres",
+  SSTBucket = "sst:aws:Bucket",
+  SnsTopic = "sst:aws:SnsTopic",
+}
+/**
+ * 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;
+};
+/**
+ * Union type of all supported SST resource types.
+ */
+type SstResource = ApiGatewayV2 | Postgres | Function | Bucket | Vpc | Secret | SnsTopic;
+/**
+ * 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
+export { ApiGatewayV2, Bucket, Function, Postgres, ResourceProcessor, ResourceType, Secret, SnsTopic, SstEnvironmentBuilder, SstResource, Vpc, sstResolvers };
+//# sourceMappingURL=SstEnvironmentBuilder-D4oSo_KX.d.cts.map

package/dist/SstEnvironmentBuilder-DEa3lTUB.mjs

@@ -0,0 +1,108 @@
+import { EnvironmentBuilder } from "./EnvironmentBuilder-DfmYRBm-.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["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";
+	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 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.SSTSecret]: secretResolver,
+	[ResourceType.SSTBucket]: bucketResolver,
+	[ResourceType.SSTFunction]: noopResolver,
+	[ResourceType.SSTPostgres]: postgresResolver,
+	[ResourceType.SSTApiGatewayV2]: noopResolver,
+	[ResourceType.SnsTopic]: topicResolver
+};
+/**
+* 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
+export { ResourceType, SstEnvironmentBuilder, sstResolvers };
+//# sourceMappingURL=SstEnvironmentBuilder-DEa3lTUB.mjs.map