npm - @dyanet/nextjs-config-aws - Versions diffs - 1.0.0-beta.1 - Mend

@dyanet/nextjs-config-aws 1.0.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (50) hide show

package/README.md +458 -0
package/dist/cjs/client/env.js +104 -0
package/dist/cjs/client/env.js.map +1 -0
package/dist/cjs/client/index.js +15 -0
package/dist/cjs/client/index.js.map +1 -0
package/dist/cjs/components/index.js +11 -0
package/dist/cjs/components/index.js.map +1 -0
package/dist/cjs/components/public-env-script.js +145 -0
package/dist/cjs/components/public-env-script.js.map +1 -0
package/dist/cjs/index.js +46 -0
package/dist/cjs/index.js.map +1 -0
package/dist/cjs/server/config-provider.js +99 -0
package/dist/cjs/server/config-provider.js.map +1 -0
package/dist/cjs/server/get-config.js +153 -0
package/dist/cjs/server/get-config.js.map +1 -0
package/dist/cjs/server/index.js +17 -0
package/dist/cjs/server/index.js.map +1 -0
package/dist/esm/client/env.js +98 -0
package/dist/esm/client/env.js.map +1 -0
package/dist/esm/client/index.js +8 -0
package/dist/esm/client/index.js.map +1 -0
package/dist/esm/components/index.js +5 -0
package/dist/esm/components/index.js.map +1 -0
package/dist/esm/components/public-env-script.js +107 -0
package/dist/esm/components/public-env-script.js.map +1 -0
package/dist/esm/index.js +15 -0
package/dist/esm/index.js.map +1 -0
package/dist/esm/server/config-provider.js +95 -0
package/dist/esm/server/config-provider.js.map +1 -0
package/dist/esm/server/get-config.js +145 -0
package/dist/esm/server/get-config.js.map +1 -0
package/dist/esm/server/index.js +6 -0
package/dist/esm/server/index.js.map +1 -0
package/dist/types/client/env.d.ts +116 -0
package/dist/types/client/env.d.ts.map +1 -0
package/dist/types/client/index.d.ts +8 -0
package/dist/types/client/index.d.ts.map +1 -0
package/dist/types/components/index.d.ts +5 -0
package/dist/types/components/index.d.ts.map +1 -0
package/dist/types/components/public-env-script.d.ts +91 -0
package/dist/types/components/public-env-script.d.ts.map +1 -0
package/dist/types/index.d.ts +13 -0
package/dist/types/index.d.ts.map +1 -0
package/dist/types/server/config-provider.d.ts +80 -0
package/dist/types/server/config-provider.d.ts.map +1 -0
package/dist/types/server/get-config.d.ts +86 -0
package/dist/types/server/get-config.d.ts.map +1 -0
package/dist/types/server/index.d.ts +6 -0
package/dist/types/server/index.d.ts.map +1 -0
package/package.json +90 -0

package/dist/esm/components/public-env-script.js ADDED Viewed

@@ -0,0 +1,107 @@
+/**
+ * PublicEnvScript - Server component for exposing environment variables to the client.
+ *
+ * This component renders a script tag that injects server-side environment variables
+ * into the client-side JavaScript context, enabling runtime environment variable access
+ * without requiring NEXT_PUBLIC_ prefixes at build time.
+ *
+ * @example
+ * ```tsx
+ * // In your root layout.tsx
+ * import { PublicEnvScript } from '@dyanet/nextjs-config-aws';
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <head>
+ *         <PublicEnvScript
+ *           publicVars={['API_URL', 'APP_NAME']}
+ *           variableName="__ENV"
+ *         />
+ *       </head>
+ *       <body>{children}</body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ */
+import * as React from 'react';
+/**
+ * Filters environment variables based on allowlist or prefix.
+ *
+ * @param env - The environment variables object (typically process.env)
+ * @param publicVars - Optional explicit list of variable names to include
+ * @param publicPrefix - Optional prefix to filter variables
+ * @returns Filtered environment variables object
+ */
+export function filterEnvVars(env, publicVars, publicPrefix) {
+    const result = {};
+    // If explicit allowlist is provided, use it
+    if (publicVars && publicVars.length > 0) {
+        for (const key of publicVars) {
+            const value = env[key];
+            if (value !== undefined) {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    // If prefix is provided, filter by prefix
+    if (publicPrefix) {
+        for (const [key, value] of Object.entries(env)) {
+            if (key.startsWith(publicPrefix) && value !== undefined) {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    // If neither is provided, return empty object (safe default)
+    return result;
+}
+/**
+ * Generates the script content for injecting environment variables.
+ *
+ * @param filteredEnv - The filtered environment variables to expose
+ * @param variableName - The global variable name to use
+ * @returns The script content as a string
+ */
+export function generateScriptContent(filteredEnv, variableName) {
+    const jsonString = JSON.stringify(filteredEnv);
+    return `window.${variableName}=${jsonString};`;
+}
+/**
+ * Server component that renders a script tag exposing environment variables to the client.
+ *
+ * This enables runtime environment variable access in Next.js applications without
+ * requiring NEXT_PUBLIC_ prefixes at build time. The same build artifact can be
+ * deployed to different environments with different configuration.
+ *
+ * Security considerations:
+ * - Only expose variables that are safe for public access
+ * - Use the publicVars allowlist for explicit control
+ * - Never expose secrets, API keys, or sensitive data
+ *
+ * @param props - Component props
+ * @returns A script element with environment variables, or null if no variables to expose
+ */
+export function PublicEnvScript({ publicVars, publicPrefix, variableName = '__ENV', nonce, }) {
+    // Filter environment variables based on allowlist or prefix
+    const filteredEnv = filterEnvVars(process.env, publicVars, publicPrefix);
+    // If no variables to expose, render nothing
+    if (Object.keys(filteredEnv).length === 0) {
+        return null;
+    }
+    // Generate the script content
+    const scriptContent = generateScriptContent(filteredEnv, variableName);
+    // Build script props
+    const scriptProps = {
+        dangerouslySetInnerHTML: { __html: scriptContent },
+    };
+    // Add nonce if provided for CSP compliance
+    if (nonce) {
+        scriptProps.nonce = nonce;
+    }
+    return React.createElement('script', scriptProps);
+}
+export default PublicEnvScript;
+//# sourceMappingURL=public-env-script.js.map

package/dist/esm/components/public-env-script.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"public-env-script.js","sourceRoot":"","sources":["../../../src/components/public-env-script.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAkC/B;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAuC,EACvC,UAAqB,EACrB,YAAqB;IAErB,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,4CAA4C;IAC5C,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACtB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,0CAA0C;IAC1C,IAAI,YAAY,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACtB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6DAA6D;IAC7D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAmC,EACnC,YAAoB;IAEpB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO,UAAU,YAAY,IAAI,UAAU,GAAG,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,UAAU,EACV,YAAY,EACZ,YAAY,GAAG,OAAO,EACtB,KAAK,GACgB;IACrB,4DAA4D;IAC5D,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC,GAAyC,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;IAE/G,4CAA4C;IAC5C,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8BAA8B;IAC9B,MAAM,aAAa,GAAG,qBAAqB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAEvE,qBAAqB;IACrB,MAAM,WAAW,GAAkD;QACjE,uBAAuB,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE;KACnD,CAAC;IAEF,2CAA2C;IAC3C,IAAI,KAAK,EAAE,CAAC;QACV,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED,OAAO,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AACpD,CAAC;AAED,eAAe,eAAe,CAAC"}

package/dist/esm/index.js ADDED Viewed

@@ -0,0 +1,15 @@
+/**
+ * @dyanet/nextjs-config-aws
+ *
+ * Next.js adapter for AWS configuration management.
+ * Provides server-side configuration loading, React context providers,
+ * and runtime environment variable support for Next.js applications.
+ */
+export { ConfigurationError, ValidationError, AWSServiceError, ConfigurationLoadError, MissingConfigurationError, EnvironmentLoader, EnvFileLoader, S3Loader, SecretsManagerLoader, SSMParameterStoreLoader, ConfigManager, ConfigValidationUtil, EnvFileParser, } from '@dyanet/config-aws';
+// Server-side exports
+export { getConfig, clearConfigCache, getConfigCacheSize, invalidateConfig, createConfigProvider, ConfigProvider, useConfig, ConfigContext, } from './server';
+// Components for runtime environment variables
+export { PublicEnvScript, filterEnvVars, generateScriptContent, } from './components';
+// Client-side environment variable access
+export { env, envFrom, getAllEnv, hasEnv } from './client';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,yBAAyB,EACzB,iBAAiB,EACjB,aAAa,EACb,QAAQ,EACR,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EACpB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,sBAAsB;AACtB,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAEhB,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,aAAa,GACd,MAAM,UAAU,CAAC;AAElB,+CAA+C;AAC/C,OAAO,EACL,eAAe,EACf,aAAa,EACb,qBAAqB,GAEtB,MAAM,cAAc,CAAC;AAEtB,0CAA0C;AAC1C,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/esm/server/config-provider.js ADDED Viewed

@@ -0,0 +1,95 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * React context provider for server-side configuration in Next.js applications.
+ * Provides a way to access configuration values in server components.
+ */
+import { createContext, useContext } from 'react';
+/**
+ * Creates a typed configuration provider and hook for accessing configuration
+ * in React server components.
+ *
+ * @example
+ * ```typescript
+ * import { createConfigProvider, getConfig } from '@dyanet/nextjs-config-aws';
+ * import { z } from 'zod';
+ *
+ * const schema = z.object({
+ *   DATABASE_URL: z.string(),
+ *   API_KEY: z.string(),
+ * });
+ *
+ * type AppConfig = z.infer<typeof schema>;
+ *
+ * // Create the provider and hook
+ * const { ConfigProvider, useConfig } = createConfigProvider<AppConfig>();
+ *
+ * // In your layout.tsx (Server Component)
+ * export default async function RootLayout({ children }) {
+ *   const config = await getConfig({ schema });
+ *
+ *   return (
+ *     <html>
+ *       <body>
+ *         <ConfigProvider config={config}>
+ *           {children}
+ *         </ConfigProvider>
+ *       </body>
+ *     </html>
+ *   );
+ * }
+ *
+ * // In a child component
+ * function MyComponent() {
+ *   const config = useConfig();
+ *   return <div>API Key: {config.API_KEY}</div>;
+ * }
+ * ```
+ *
+ * @returns An object containing the ConfigProvider component and useConfig hook
+ */
+export function createConfigProvider() {
+    // Create a context with null as default (will be provided by ConfigProvider)
+    const ConfigContext = createContext(null);
+    /**
+     * Provider component that wraps children with configuration context
+     */
+    function ConfigProvider({ children, config }) {
+        const value = { config };
+        return (_jsx(ConfigContext.Provider, { value: value, children: children }));
+    }
+    /**
+     * Hook to access configuration from the context
+     * @throws Error if used outside of ConfigProvider
+     */
+    function useConfig() {
+        const context = useContext(ConfigContext);
+        if (context === null) {
+            throw new Error('useConfig must be used within a ConfigProvider. ' +
+                'Make sure to wrap your component tree with ConfigProvider.');
+        }
+        return context.config;
+    }
+    return {
+        ConfigProvider,
+        useConfig,
+        ConfigContext,
+    };
+}
+/**
+ * Default configuration context and provider for simple use cases.
+ * For typed configuration, use createConfigProvider<T>() instead.
+ */
+const defaultProvider = createConfigProvider();
+/**
+ * Default ConfigProvider for untyped configuration
+ */
+export const ConfigProvider = defaultProvider.ConfigProvider;
+/**
+ * Default useConfig hook for untyped configuration
+ */
+export const useConfig = defaultProvider.useConfig;
+/**
+ * Default ConfigContext for untyped configuration
+ */
+export const ConfigContext = defaultProvider.ConfigContext;
+//# sourceMappingURL=config-provider.js.map

package/dist/esm/server/config-provider.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"config-provider.js","sourceRoot":"","sources":["../../../src/server/config-provider.tsx"],"names":[],"mappings":";AAAA;;;GAGG;AAEH,OAAc,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAiBzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,UAAU,oBAAoB;IAKlC,6EAA6E;IAC7E,MAAM,aAAa,GAAG,aAAa,CAA+B,IAAI,CAAC,CAAC;IAExE;;OAEG;IACH,SAAS,cAAc,CAAC,EAAE,QAAQ,EAAE,MAAM,EAA0B;QAClE,MAAM,KAAK,GAA0B,EAAE,MAAM,EAAE,CAAC;QAEhD,OAAO,CACL,KAAC,aAAa,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACjC,QAAQ,GACc,CAC1B,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,SAAS,SAAS;QAChB,MAAM,OAAO,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;QAE1C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,kDAAkD;gBAClD,4DAA4D,CAC7D,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC;IAED,OAAO;QACL,cAAc;QACd,SAAS;QACT,aAAa;KACd,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,eAAe,GAAG,oBAAoB,EAA2B,CAAC;AAExE;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC,cAAc,CAAC;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC,aAAa,CAAC"}

package/dist/esm/server/get-config.js ADDED Viewed

@@ -0,0 +1,145 @@
+/**
+ * Server-side configuration loading for Next.js applications.
+ * Provides a cached getConfig() function that uses ConfigManager from @dyanet/config-aws.
+ */
+import { ConfigManager, } from '@dyanet/config-aws';
+/**
+ * Cache storage for configuration
+ * Uses a Map to support multiple cache keys (for different option combinations)
+ */
+const configCache = new Map();
+/**
+ * Track AWS API call counts for testing purposes
+ * @internal
+ */
+let awsApiCallCount = 0;
+/**
+ * Generate a cache key from options
+ * @internal
+ */
+function generateCacheKey(options) {
+    const loaderNames = options.loaders?.map((l) => l.getName()).join(',') ?? '';
+    const precedence = Array.isArray(options.precedence)
+        ? options.precedence.map((p) => `${p.loader}:${p.priority}`).join(',')
+        : options.precedence ?? 'aws-first';
+    return `${loaderNames}|${precedence}`;
+}
+/**
+ * Check if a cache entry is still valid
+ * @internal
+ */
+function isCacheValid(entry) {
+    if (!entry)
+        return false;
+    return Date.now() < entry.expiresAt;
+}
+/**
+ * Load configuration for Next.js server-side use.
+ *
+ * This function provides caching to avoid repeated AWS API calls during request handling.
+ * Configuration is cached based on the loader configuration and precedence strategy.
+ *
+ * @example
+ * ```typescript
+ * import { getConfig, EnvironmentLoader, SecretsManagerLoader } from '@dyanet/nextjs-config-aws';
+ * import { z } from 'zod';
+ *
+ * const schema = z.object({
+ *   DATABASE_URL: z.string(),
+ *   API_KEY: z.string(),
+ * });
+ *
+ * // In a Server Component or API route
+ * export default async function Page() {
+ *   const config = await getConfig({
+ *     schema,
+ *     loaders: [
+ *       new EnvironmentLoader(),
+ *       new SecretsManagerLoader({ secretName: '/my-app/config' }),
+ *     ],
+ *     precedence: 'aws-first',
+ *   });
+ *
+ *   return <div>DB: {config.DATABASE_URL}</div>;
+ * }
+ * ```
+ *
+ * @param options Configuration options
+ * @returns Promise resolving to the validated configuration object
+ */
+export async function getConfig(options = {}) {
+    const { schema, loaders = [], precedence = 'aws-first', cache = true, cacheTTL = 60000, // 1 minute default
+    enableLogging = false, } = options;
+    // Generate cache key
+    const cacheKey = generateCacheKey(options);
+    // Check cache if enabled
+    if (cache) {
+        const cached = configCache.get(cacheKey);
+        if (isCacheValid(cached)) {
+            return cached.config;
+        }
+    }
+    // Increment API call counter (for testing)
+    awsApiCallCount++;
+    // Create ConfigManager with provided options
+    const managerOptions = {
+        loaders,
+        schema,
+        precedence,
+        validateOnLoad: true,
+        enableLogging,
+    };
+    const manager = new ConfigManager(managerOptions);
+    await manager.load();
+    const config = manager.getAll();
+    const loadResult = manager.getLoadResult();
+    // Store in cache if enabled
+    if (cache && loadResult) {
+        const entry = {
+            config,
+            loadResult,
+            expiresAt: Date.now() + cacheTTL,
+        };
+        configCache.set(cacheKey, entry);
+    }
+    return config;
+}
+/**
+ * Clear the configuration cache.
+ * Useful for testing or when configuration needs to be reloaded.
+ */
+export function clearConfigCache() {
+    configCache.clear();
+}
+/**
+ * Get the current cache size.
+ * @returns Number of cached configurations
+ */
+export function getConfigCacheSize() {
+    return configCache.size;
+}
+/**
+ * Get the AWS API call count.
+ * This is primarily for testing the caching behavior.
+ * @internal
+ */
+export function getAwsApiCallCount() {
+    return awsApiCallCount;
+}
+/**
+ * Reset the AWS API call count.
+ * This is primarily for testing the caching behavior.
+ * @internal
+ */
+export function resetAwsApiCallCount() {
+    awsApiCallCount = 0;
+}
+/**
+ * Invalidate a specific cache entry by regenerating with the same options.
+ * @param options The options used to create the cache entry
+ */
+export function invalidateConfig(options) {
+    const cacheKey = generateCacheKey(options);
+    configCache.delete(cacheKey);
+}
+//# sourceMappingURL=get-config.js.map

package/dist/esm/server/get-config.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"get-config.js","sourceRoot":"","sources":["../../../src/server/get-config.ts"],"names":[],"mappings":"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"}

package/dist/esm/server/index.js ADDED Viewed

@@ -0,0 +1,6 @@
+/**
+ * Server-side exports for Next.js configuration management.
+ */
+export { getConfig, clearConfigCache, getConfigCacheSize, invalidateConfig, } from './get-config';
+export { createConfigProvider, ConfigProvider, useConfig, ConfigContext, } from './config-provider';
+//# sourceMappingURL=index.js.map

package/dist/esm/server/index.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,GAEjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,aAAa,GACd,MAAM,mBAAmB,CAAC"}

package/dist/types/client/env.d.ts ADDED Viewed

@@ -0,0 +1,116 @@
+/**
+ * Client-side environment variable access for Next.js applications.
+ *
+ * This module provides a function to read runtime environment variables
+ * that were injected by the PublicEnvScript server component.
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ *
+ * import { env } from '@dyanet/nextjs-config-aws/client';
+ *
+ * function MyComponent() {
+ *   const apiUrl = env('API_URL');
+ *   const appName = env('APP_NAME', 'Default App');
+ *
+ *   return <div>API: {apiUrl}, App: {appName}</div>;
+ * }
+ * ```
+ */
+/**
+ * Type declaration for the global window object with environment variables.
+ */
+declare global {
+    interface Window {
+        __ENV?: Record<string, string>;
+        [key: string]: unknown;
+    }
+}
+/**
+ * Retrieves a runtime environment variable value.
+ *
+ * This function reads from the global window object where environment
+ * variables were injected by the PublicEnvScript component.
+ *
+ * @param key - The environment variable name
+ * @returns The value of the environment variable, or undefined if not found
+ *
+ * @example
+ * ```ts
+ * const apiUrl = env('API_URL');
+ * if (apiUrl) {
+ *   // Use the API URL
+ * }
+ * ```
+ */
+export declare function env(key: string): string | undefined;
+/**
+ * Retrieves a runtime environment variable value with a default.
+ *
+ * @param key - The environment variable name
+ * @param defaultValue - The default value to return if the variable is not found
+ * @returns The value of the environment variable, or the default value
+ *
+ * @example
+ * ```ts
+ * const apiUrl = env('API_URL', 'http://localhost:3000');
+ * // apiUrl is guaranteed to be a string
+ * ```
+ */
+export declare function env<T>(key: string, defaultValue: T): string | T;
+/**
+ * Retrieves a runtime environment variable from a custom variable name.
+ *
+ * Use this when you've configured PublicEnvScript with a custom variableName.
+ *
+ * @param variableName - The global variable name to read from
+ * @param key - The environment variable name
+ * @returns The value of the environment variable, or undefined if not found
+ *
+ * @example
+ * ```ts
+ * // If PublicEnvScript was configured with variableName="__MY_ENV"
+ * const apiUrl = envFrom('__MY_ENV', 'API_URL');
+ * ```
+ */
+export declare function envFrom(variableName: string, key: string): string | undefined;
+/**
+ * Retrieves a runtime environment variable from a custom variable name with a default.
+ *
+ * @param variableName - The global variable name to read from
+ * @param key - The environment variable name
+ * @param defaultValue - The default value to return if the variable is not found
+ * @returns The value of the environment variable, or the default value
+ */
+export declare function envFrom<T>(variableName: string, key: string, defaultValue: T): string | T;
+/**
+ * Gets all runtime environment variables.
+ *
+ * @param variableName - The global variable name to read from (default: '__ENV')
+ * @returns A copy of all environment variables
+ *
+ * @example
+ * ```ts
+ * const allEnv = getAllEnv();
+ * console.log(allEnv); // { API_URL: '...', APP_NAME: '...' }
+ * ```
+ */
+export declare function getAllEnv(variableName?: string): Record<string, string>;
+/**
+ * Checks if a runtime environment variable exists.
+ *
+ * @param key - The environment variable name
+ * @param variableName - The global variable name to read from (default: '__ENV')
+ * @returns True if the variable exists, false otherwise
+ *
+ * @example
+ * ```ts
+ * if (hasEnv('FEATURE_FLAG')) {
+ *   // Feature is enabled
+ * }
+ * ```
+ */
+export declare function hasEnv(key: string, variableName?: string): boolean;
+export default env;
+//# sourceMappingURL=env.d.ts.map

package/dist/types/client/env.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/client/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB;CACF;AA2BD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;AAgBjE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/E;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;AAgB3F;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,YAAY,GAAE,MAA8B,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE9F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,MAA8B,GAAG,OAAO,CAGzF;AAED,eAAe,GAAG,CAAC"}

package/dist/types/client/index.d.ts ADDED Viewed

@@ -0,0 +1,8 @@
+/**
+ * Client-side exports for Next.js configuration management.
+ *
+ * These utilities are designed for use in client components ('use client')
+ * to access runtime environment variables injected by PublicEnvScript.
+ */
+export { env, envFrom, getAllEnv, hasEnv } from './env';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/client/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC"}

package/dist/types/components/index.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+/**
+ * Client-side components for Next.js configuration management.
+ */
+export { PublicEnvScript, filterEnvVars, generateScriptContent, type PublicEnvScriptProps, } from './public-env-script';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC"}

package/dist/types/components/public-env-script.d.ts ADDED Viewed

@@ -0,0 +1,91 @@
+/**
+ * PublicEnvScript - Server component for exposing environment variables to the client.
+ *
+ * This component renders a script tag that injects server-side environment variables
+ * into the client-side JavaScript context, enabling runtime environment variable access
+ * without requiring NEXT_PUBLIC_ prefixes at build time.
+ *
+ * @example
+ * ```tsx
+ * // In your root layout.tsx
+ * import { PublicEnvScript } from '@dyanet/nextjs-config-aws';
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <head>
+ *         <PublicEnvScript
+ *           publicVars={['API_URL', 'APP_NAME']}
+ *           variableName="__ENV"
+ *         />
+ *       </head>
+ *       <body>{children}</body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ */
+import * as React from 'react';
+/**
+ * Props for the PublicEnvScript component.
+ */
+export interface PublicEnvScriptProps {
+    /**
+     * Explicit list of environment variable names to expose to the client.
+     * Only variables in this list will be included in the output.
+     * Takes precedence over publicPrefix if both are provided.
+     */
+    publicVars?: string[];
+    /**
+     * Prefix to filter environment variables.
+     * Only variables starting with this prefix will be included.
+     * The prefix is NOT stripped from the variable names in the output.
+     * @example 'PUBLIC_' will include PUBLIC_API_URL, PUBLIC_APP_NAME, etc.
+     */
+    publicPrefix?: string;
+    /**
+     * The global variable name used to expose environment variables on the client.
+     * @default '__ENV'
+     */
+    variableName?: string;
+    /**
+     * CSP nonce for script tag compliance with Content Security Policy.
+     * If provided, adds a nonce attribute to the script tag.
+     */
+    nonce?: string;
+}
+/**
+ * Filters environment variables based on allowlist or prefix.
+ *
+ * @param env - The environment variables object (typically process.env)
+ * @param publicVars - Optional explicit list of variable names to include
+ * @param publicPrefix - Optional prefix to filter variables
+ * @returns Filtered environment variables object
+ */
+export declare function filterEnvVars(env: Record<string, string | undefined>, publicVars?: string[], publicPrefix?: string): Record<string, string>;
+/**
+ * Generates the script content for injecting environment variables.
+ *
+ * @param filteredEnv - The filtered environment variables to expose
+ * @param variableName - The global variable name to use
+ * @returns The script content as a string
+ */
+export declare function generateScriptContent(filteredEnv: Record<string, string>, variableName: string): string;
+/**
+ * Server component that renders a script tag exposing environment variables to the client.
+ *
+ * This enables runtime environment variable access in Next.js applications without
+ * requiring NEXT_PUBLIC_ prefixes at build time. The same build artifact can be
+ * deployed to different environments with different configuration.
+ *
+ * Security considerations:
+ * - Only expose variables that are safe for public access
+ * - Use the publicVars allowlist for explicit control
+ * - Never expose secrets, API keys, or sensitive data
+ *
+ * @param props - Component props
+ * @returns A script element with environment variables, or null if no variables to expose
+ */
+export declare function PublicEnvScript({ publicVars, publicPrefix, variableName, nonce, }: PublicEnvScriptProps): React.ReactElement | null;
+export default PublicEnvScript;
+//# sourceMappingURL=public-env-script.d.ts.map

package/dist/types/components/public-env-script.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"public-env-script.d.ts","sourceRoot":"","sources":["../../../src/components/public-env-script.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA0BxB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,YAAY,EAAE,MAAM,GACnB,MAAM,CAGR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,EAC9B,UAAU,EACV,YAAY,EACZ,YAAsB,EACtB,KAAK,GACN,EAAE,oBAAoB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAuBlD;AAED,eAAe,eAAe,CAAC"}

package/dist/types/index.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+/**
+ * @dyanet/nextjs-config-aws
+ *
+ * Next.js adapter for AWS configuration management.
+ * Provides server-side configuration loading, React context providers,
+ * and runtime environment variable support for Next.js applications.
+ */
+export type { ConfigLoader, ConfigLoaderResult, ConfigManagerOptions, LoaderPrecedence, VerboseOptions, PrecedenceStrategy, ConfigLoadResult, ConfigSourceInfo, Logger, EnvironmentLoaderConfig, EnvFileLoaderConfig, S3LoaderConfig, SecretsManagerLoaderConfig, SSMParameterStoreLoaderConfig, } from '@dyanet/config-aws';
+export { ConfigurationError, ValidationError, AWSServiceError, ConfigurationLoadError, MissingConfigurationError, EnvironmentLoader, EnvFileLoader, S3Loader, SecretsManagerLoader, SSMParameterStoreLoader, ConfigManager, ConfigValidationUtil, EnvFileParser, } from '@dyanet/config-aws';
+export { getConfig, clearConfigCache, getConfigCacheSize, invalidateConfig, type NextConfigOptions, createConfigProvider, ConfigProvider, useConfig, ConfigContext, } from './server';
+export { PublicEnvScript, filterEnvVars, generateScriptContent, type PublicEnvScriptProps, } from './components';
+export { env, envFrom, getAllEnv, hasEnv } from './client';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,MAAM,EACN,uBAAuB,EACvB,mBAAmB,EACnB,cAAc,EACd,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,yBAAyB,EACzB,iBAAiB,EACjB,aAAa,EACb,QAAQ,EACR,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EACpB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,aAAa,GACd,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}