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

package/README.md

@@ -1,15 +1,15 @@
 # @dyanet/nextjs-config-aws
 
-Next.js adapter for AWS configuration management. A thin wrapper around [@dyanet/config-aws](../config-aws) that provides server-side configuration loading, React context providers, and runtime environment variable support.
+Next.js adapter for AWS configuration management. A thin wrapper around [@dyanet/config-aws](../config-aws) that provides server-side configuration loading, runtime environment variables, and automatic environment detection.
 
 ## Features
 
-- **Server Components** - Load configuration in Server Components and API routes
+- **Simplified API** - Just `getConfig()`, `PublicEnvScript`, and `env()` - no loader complexity
+- **Automatic Environment Detection** - Configures itself based on NODE_ENV
 - **Runtime Environment Variables** - Deploy the same build to different environments
 - **Caching** - Avoid repeated AWS API calls during request handling
-- **React Context** - Share configuration across your component tree
 - **Type Safety** - Full TypeScript support with Zod schema validation
-- **AWS Services** - Load configuration from Secrets Manager, SSM Parameter Store, S3
+- **AWS Services** - Load configuration from Secrets Manager and SSM Parameter Store
 
 ## Installation
 
@@ -32,9 +32,6 @@ npm install @aws-sdk/client-secrets-manager
 # For SSM Parameter Store
 npm install @aws-sdk/client-ssm
 
-# For S3
-npm install @aws-sdk/client-s3
-
 # For schema validation
 npm install zod
 ```
@@ -45,7 +42,27 @@ npm install zod
 
 ```typescript
 // app/page.tsx (Server Component)
-import { getConfig, EnvironmentLoader, SecretsManagerLoader } from '@dyanet/nextjs-config-aws';
+import { getConfig } from '@dyanet/nextjs-config-aws';
+import { z } from 'zod';
+
+const schema = z.object({
+  DATABASE_URL: z.string(),
+  API_KEY: z.string(),
+});
+
+export default async function Page() {
+  // Minimal usage - auto-detects environment
+  const config = await getConfig({ schema });
+
+  return <div>Connected to: {config.DATABASE_URL}</div>;
+}
+```
+
+### With AWS Secrets Manager
+
+```typescript
+// app/page.tsx
+import { getConfig } from '@dyanet/nextjs-config-aws';
 import { z } from 'zod';
 
 const schema = z.object({
@@ -56,11 +73,10 @@ const schema = z.object({
 export default async function Page() {
   const config = await getConfig({
     schema,
-    loaders: [
-      new EnvironmentLoader(),
-      new SecretsManagerLoader({ secretName: '/my-app/config' }),
-    ],
-    precedence: 'aws-first',
+    aws: { 
+      secretName: '/my-app/config',
+      region: 'us-east-1'  // Optional, defaults to AWS_REGION env var
+    },
   });
 
   return <div>Connected to: {config.DATABASE_URL}</div>;
@@ -101,37 +117,43 @@ export function ClientComponent() {
 }
 ```
 
-## Server-Side API
+## Environment Detection
 
-### getConfig()
+The library automatically configures itself based on `NODE_ENV`:
+
+| Environment | Env Vars | .env Files | AWS Sources |
+|-------------|----------|------------|-------------|
+| development | ✓ | .env.local, .env | Only if `forceAwsInDev: true` |
+| production  | ✓ | .env | ✓ (if configured) |
+| test        | ✓ | ✗ | ✗ |
 
-Load configuration in Server Components, API routes, or server actions:
+### Override Environment Detection
 
 ```typescript
-import { getConfig, EnvironmentLoader, SecretsManagerLoader } from '@dyanet/nextjs-config-aws';
-import { z } from 'zod';
+const config = await getConfig({
+  schema,
+  environment: 'production',  // Force production behavior
+});
+```
 
-const schema = z.object({
-  DATABASE_URL: z.string(),
-  API_KEY: z.string(),
-  PORT: z.coerce.number().default(3000),
+### Force AWS in Development
+
+```typescript
+const config = await getConfig({
+  schema,
+  aws: { secretName: '/my-app/config' },
+  forceAwsInDev: true,  // Load from AWS even in development
 });
+```
 
-// In a Server Component
-export default async function Page() {
-  const config = await getConfig({
-    schema,
-    loaders: [
-      new EnvironmentLoader({ prefix: 'APP_' }),
-      new SecretsManagerLoader({ secretName: '/my-app/secrets' }),
-    ],
-    precedence: 'aws-first',
-    cache: true,        // Enable caching (default: true)
-    cacheTTL: 60000,    // Cache for 1 minute (default)
-  });
+## API Reference
 
-  return <div>{config.DATABASE_URL}</div>;
-}
+### getConfig()
+
+Load configuration in Server Components, API routes, or server actions.
+
+```typescript
+import { getConfig } from '@dyanet/nextjs-config-aws';
 ```
 
 #### Options
@@ -139,103 +161,55 @@ export default async function Page() {
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
 | `schema` | `ZodType<T>` | `undefined` | Zod schema for validation |
-| `loaders` | `ConfigLoader[]` | `[]` | Array of configuration loaders |
-| `precedence` | `PrecedenceStrategy` | `'aws-first'` | Precedence strategy |
+| `aws.secretName` | `string` | `undefined` | AWS Secrets Manager secret name |
+| `aws.ssmPrefix` | `string` | `undefined` | AWS SSM Parameter Store path prefix |
+| `aws.region` | `string` | `AWS_REGION` | AWS region for all service calls |
+| `environment` | `'development' \| 'production' \| 'test'` | auto-detect | Override environment detection |
+| `forceAwsInDev` | `boolean` | `false` | Load from AWS in development mode |
 | `cache` | `boolean` | `true` | Enable caching |
 | `cacheTTL` | `number` | `60000` | Cache TTL in milliseconds |
-| `enableLogging` | `boolean` | `false` | Enable logging |
 
-### Cache Management
+#### Examples
 
 ```typescript
-import { clearConfigCache, getConfigCacheSize, invalidateConfig } from '@dyanet/nextjs-config-aws';
-
-// Clear all cached configurations
-clearConfigCache();
-
-// Get number of cached configurations
-const size = getConfigCacheSize();
+// Minimal - just schema
+const config = await getConfig({ schema });
 
-// Invalidate a specific configuration
-invalidateConfig({ loaders: [...], precedence: 'aws-first' });
-```
-
-### createConfigProvider()
-
-Create a typed React context provider for sharing configuration:
-
-```typescript
-// lib/config.ts
-import { createConfigProvider, getConfig } from '@dyanet/nextjs-config-aws';
-import { z } from 'zod';
-
-const schema = z.object({
-  DATABASE_URL: z.string(),
-  API_KEY: z.string(),
+// With AWS Secrets Manager
+const config = await getConfig({
+  schema,
+  aws: { secretName: '/my-app/secrets' }
 });
 
-export type AppConfig = z.infer<typeof schema>;
-
-// Create typed provider and hook
-export const { ConfigProvider, useConfig } = createConfigProvider<AppConfig>();
-export { schema };
-```
-
-```tsx
-// app/layout.tsx
-import { ConfigProvider, schema } from '@/lib/config';
-import { getConfig, EnvironmentLoader } from '@dyanet/nextjs-config-aws';
-
-export default async function RootLayout({ children }) {
-  const config = await getConfig({
-    schema,
-    loaders: [new EnvironmentLoader()],
-  });
-
-  return (
-    <html>
-      <body>
-        <ConfigProvider config={config}>
-          {children}
-        </ConfigProvider>
-      </body>
-    </html>
-  );
-}
-```
-
-```tsx
-// app/components/my-component.tsx
-'use client';
+// With SSM Parameter Store
+const config = await getConfig({
+  schema,
+  aws: { ssmPrefix: '/my-app/config' }
+});
 
-import { useConfig } from '@/lib/config';
+// Both AWS sources
+const config = await getConfig({
+  schema,
+  aws: { 
+    secretName: '/my-app/secrets',
+    ssmPrefix: '/my-app/config',
+    region: 'us-west-2'
+  }
+});
 
-export function MyComponent() {
-  const config = useConfig();
-  return <div>API Key: {config.API_KEY}</div>;
-}
+// Disable caching
+const config = await getConfig({
+  schema,
+  cache: false
+});
 ```
 
-## Runtime Environment Variables
-
 ### PublicEnvScript
 
-Server component that injects environment variables into the client:
+Server component that injects environment variables into the client.
 
 ```tsx
 import { PublicEnvScript } from '@dyanet/nextjs-config-aws';
-
-// In your root layout
-<PublicEnvScript
-  publicVars={['API_URL', 'APP_NAME']}  // Explicit allowlist
-  variableName="__ENV"                   // Global variable name (default)
-  nonce={cspNonce}                       // CSP nonce (optional)
-/>
-
-// Or use prefix filtering
-<PublicEnvScript
-  publicPrefix="PUBLIC_"                 // Include all PUBLIC_* vars
-/>
 ```
 
 #### Props
@@ -249,28 +223,47 @@ import { PublicEnvScript } from '@dyanet/nextjs-config-aws';
 
 **Security Note:** Only expose variables that are safe for public access. Never expose secrets, API keys, or sensitive data.
 
-### Client-Side Access
+```tsx
+// Explicit allowlist
+<PublicEnvScript publicVars={['API_URL', 'APP_NAME']} />
+
+// Prefix filtering
+<PublicEnvScript publicPrefix="PUBLIC_" />
+
+// With CSP nonce
+<PublicEnvScript publicVars={['API_URL']} nonce={cspNonce} />
+```
+
+### env()
+
+Access runtime environment variables on the client.
 
 ```typescript
 'use client';
 
-import { env, envFrom, getAllEnv, hasEnv } from '@dyanet/nextjs-config-aws';
+import { env } from '@dyanet/nextjs-config-aws';
+```
 
+```typescript
 // Get a variable (returns undefined if not found)
 const apiUrl = env('API_URL');
 
 // Get with default value
 const appName = env('APP_NAME', 'My App');
+```
 
-// Get from custom variable name
-const customVar = envFrom('__MY_ENV', 'API_URL');
-
-// Get all variables
-const allEnv = getAllEnv();
+### Error Handling
 
-// Check if variable exists
-if (hasEnv('FEATURE_FLAG')) {
-  // Feature is enabled
+```typescript
+import { ConfigurationError, ValidationError } from '@dyanet/nextjs-config-aws';
+
+try {
+  const config = await getConfig({ schema });
+} catch (error) {
+  if (error instanceof ValidationError) {
+    console.error('Validation failed:', error.message);
+    // error.message includes the invalid/missing key names
+  }
 }
 ```
 
@@ -280,7 +273,7 @@ if (hasEnv('FEATURE_FLAG')) {
 
 ```tsx
 // app/dashboard/page.tsx
-import { getConfig, EnvironmentLoader, SSMParameterStoreLoader } from '@dyanet/nextjs-config-aws';
+import { getConfig } from '@dyanet/nextjs-config-aws';
 import { z } from 'zod';
 
 const schema = z.object({
@@ -291,10 +284,7 @@ const schema = z.object({
 export default async function DashboardPage() {
   const config = await getConfig({
     schema,
-    loaders: [
-      new EnvironmentLoader(),
-      new SSMParameterStoreLoader({ parameterPath: '/app/config' }),
-    ],
+    aws: { ssmPrefix: '/app/config' },
   });
 
   return (
@@ -311,7 +301,7 @@ export default async function DashboardPage() {
 ```typescript
 // app/api/config/route.ts
 import { NextResponse } from 'next/server';
-import { getConfig, EnvironmentLoader } from '@dyanet/nextjs-config-aws';
+import { getConfig } from '@dyanet/nextjs-config-aws';
 import { z } from 'zod';
 
 const schema = z.object({
@@ -320,10 +310,7 @@ const schema = z.object({
 });
 
 export async function GET() {
-  const config = await getConfig({
-    schema,
-    loaders: [new EnvironmentLoader()],
-  });
+  const config = await getConfig({ schema });
 
   return NextResponse.json({
     version: config.API_VERSION,
@@ -338,7 +325,7 @@ export async function GET() {
 // app/actions.ts
 'use server';
 
-import { getConfig, SecretsManagerLoader } from '@dyanet/nextjs-config-aws';
+import { getConfig } from '@dyanet/nextjs-config-aws';
 import { z } from 'zod';
 
 const schema = z.object({
@@ -348,7 +335,7 @@ const schema = z.object({
 export async function fetchData() {
   const config = await getConfig({
     schema,
-    loaders: [new SecretsManagerLoader({ secretName: '/app/secrets' })],
+    aws: { secretName: '/app/secrets' },
   });
 
   const response = await fetch('https://api.example.com/data', {
@@ -365,7 +352,7 @@ export async function fetchData() {
 
 ```typescript
 // pages/dashboard.tsx
-import { getConfig, EnvironmentLoader } from '@dyanet/nextjs-config-aws';
+import { getConfig } from '@dyanet/nextjs-config-aws';
 import { z } from 'zod';
 import type { GetServerSideProps } from 'next';
 
@@ -374,10 +361,7 @@ const schema = z.object({
 });
 
 export const getServerSideProps: GetServerSideProps = async () => {
-  const config = await getConfig({
-    schema,
-    loaders: [new EnvironmentLoader()],
-  });
+  const config = await getConfig({ schema });
 
   return {
     props: {
@@ -396,7 +380,7 @@ export default function Dashboard({ apiUrl }: { apiUrl: string }) {
 ```typescript
 // pages/api/config.ts
 import type { NextApiRequest, NextApiResponse } from 'next';
-import { getConfig, EnvironmentLoader } from '@dyanet/nextjs-config-aws';
+import { getConfig } from '@dyanet/nextjs-config-aws';
 import { z } from 'zod';
 
 const schema = z.object({
@@ -404,48 +388,38 @@ const schema = z.object({
 });
 
 export default async function handler(req: NextApiRequest, res: NextApiResponse) {
-  const config = await getConfig({
-    schema,
-    loaders: [new EnvironmentLoader()],
-  });
+  const config = await getConfig({ schema });
 
   res.json({ version: config.APP_VERSION });
 }
 ```
 
-## Re-exported Types
+## Advanced Usage
 
-All types from `@dyanet/config-aws` are re-exported:
+For advanced use cases such as custom loaders, direct AWS SDK integration, or fine-grained control over configuration loading, import from `@dyanet/config-aws` directly:
 
 ```typescript
 import {
-  // Loaders
+  ConfigManager,
   EnvironmentLoader,
   EnvFileLoader,
-  S3Loader,
   SecretsManagerLoader,
   SSMParameterStoreLoader,
-  
-  // ConfigManager
-  ConfigManager,
-  
-  // Error classes
-  ConfigurationError,
-  ValidationError,
-  AWSServiceError,
-  ConfigurationLoadError,
-  MissingConfigurationError,
-  
-  // Utilities
-  ConfigValidationUtil,
-  EnvFileParser,
-  
-  // Types
-  ConfigLoader,
-  ConfigManagerOptions,
-  LoaderPrecedence,
-  VerboseOptions,
-} from '@dyanet/nextjs-config-aws';
+  S3Loader,
+} from '@dyanet/config-aws';
+
+const manager = new ConfigManager({
+  loaders: [
+    new EnvironmentLoader({ prefix: 'APP_' }),
+    new EnvFileLoader({ paths: ['.env.local', '.env'] }),
+    new SecretsManagerLoader({ secretName: '/my-app/config' }),
+  ],
+  schema: mySchema,
+  precedence: 'aws-first',
+});
+
+await manager.load();
+const config = manager.getAll();
 ```
 
 ## Related Packages

package/dist/cjs/client/env.js

@@ -5,11 +5,19 @@
  * This module provides a function to read runtime environment variables
  * that were injected by the PublicEnvScript server component.
  *
+ * @remarks
+ * This is part of the simplified Next.js API. For advanced configuration loading
+ * with custom loaders or direct AWS SDK integration, import from `@dyanet/config-aws` directly:
+ *
+ * ```typescript
+ * import { ConfigManager, EnvironmentLoader } from '@dyanet/config-aws';
+ * ```
+ *
  * @example
  * ```tsx
  * 'use client';
  *
- * import { env } from '@dyanet/nextjs-config-aws/client';
+ * import { env } from '@dyanet/nextjs-config-aws';
  *
  * function MyComponent() {
  *   const apiUrl = env('API_URL');

package/dist/cjs/client/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../src/client/env.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;AA0EH,kBASC;AAgCD,0BASC;AAcD,8BAEC;AAgBD,wBAGC;AAnJD;;GAEG;AACH,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAEtC;;;;;GAKG;AACH,SAAS,YAAY,CAAC,eAAuB,qBAAqB;IAChE,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,kDAAkD;QAClD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IACpC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,OAAO,MAAgC,CAAC;IAC1C,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAoCD;;GAEG;AACH,SAAgB,GAAG,CAAI,GAAW,EAAE,YAAgB;IAClD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAE1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AA6BD;;GAEG;AACH,SAAgB,OAAO,CAAI,YAAoB,EAAE,GAAW,EAAE,YAAgB;IAC5E,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAE1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,SAAS,CAAC,eAAuB,qBAAqB;IACpE,OAAO,EAAE,GAAG,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,MAAM,CAAC,GAAW,EAAE,eAAuB,qBAAqB;IAC9E,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC1C,OAAO,GAAG,IAAI,MAAM,CAAC;AACvB,CAAC;AAED,kBAAe,GAAG,CAAC"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../src/client/env.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;AA0EH,kBASC;AAgCD,0BASC;AAcD,8BAEC;AAgBD,wBAGC;AAnJD;;GAEG;AACH,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAEtC;;;;;GAKG;AACH,SAAS,YAAY,CAAC,eAAuB,qBAAqB;IAChE,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,kDAAkD;QAClD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IACpC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,OAAO,MAAgC,CAAC;IAC1C,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAoCD;;GAEG;AACH,SAAgB,GAAG,CAAI,GAAW,EAAE,YAAgB;IAClD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAE1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AA6BD;;GAEG;AACH,SAAgB,OAAO,CAAI,YAAoB,EAAE,GAAW,EAAE,YAAgB;IAC5E,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAE1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,SAAS,CAAC,eAAuB,qBAAqB;IACpE,OAAO,EAAE,GAAG,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,MAAM,CAAC,GAAW,EAAE,eAAuB,qBAAqB;IAC9E,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC1C,OAAO,GAAG,IAAI,MAAM,CAAC;AACvB,CAAC;AAED,kBAAe,GAAG,CAAC"}

package/dist/cjs/components/public-env-script.js

@@ -6,6 +6,10 @@
  * into the client-side JavaScript context, enabling runtime environment variable access
  * without requiring NEXT_PUBLIC_ prefixes at build time.
  *
+ * @remarks
+ * This is part of the simplified Next.js API. For advanced configuration loading
+ * with custom loaders or direct AWS SDK integration, import from `@dyanet/config-aws` directly.
+ *
  * @example
  * ```tsx
  * // In your root layout.tsx

package/dist/cjs/components/public-env-script.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-env-script.js","sourceRoot":"","sources":["../../../src/components/public-env-script.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CH,sCA8BC;AASD,sDAMC;AAiBD,0CA4BC;AApID,6CAA+B;AAkC/B;;;;;;;GAOG;AACH,SAAgB,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,SAAgB,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,SAAgB,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,kBAAe,eAAe,CAAC"}
+{"version":3,"file":"public-env-script.js","sourceRoot":"","sources":["../../../src/components/public-env-script.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CH,sCA8BC;AASD,sDAMC;AAiBD,0CA4BC;AApID,6CAA+B;AAkC/B;;;;;;;GAOG;AACH,SAAgB,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,SAAgB,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,SAAgB,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,kBAAe,eAAe,CAAC"}

package/dist/cjs/index.js

@@ -3,44 +3,62 @@
  * @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.
+ * Provides a simplified, opinionated API for loading configuration
+ * with automatic environment detection and AWS integration.
+ *
+ * @example
+ * ```typescript
+ * // Server-side configuration loading
+ * import { getConfig } from '@dyanet/nextjs-config-aws';
+ *
+ * const config = await getConfig({
+ *   schema: mySchema,
+ *   aws: { secretName: '/myapp/config' }
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Runtime environment variables for client
+ * // In layout.tsx (server component)
+ * import { PublicEnvScript } from '@dyanet/nextjs-config-aws';
+ *
+ * <PublicEnvScript publicVars={['API_URL', 'APP_NAME']} />
+ *
+ * // In client component
+ * import { env } from '@dyanet/nextjs-config-aws';
+ *
+ * const apiUrl = env('API_URL');
+ * ```
+ *
+ * @remarks
+ * For advanced loader access, custom loaders, or direct AWS SDK integration,
+ * import from `@dyanet/config-aws` directly:
+ *
+ * ```typescript
+ * import {
+ *   ConfigManager,
+ *   EnvironmentLoader,
+ *   SecretsManagerLoader,
+ *   SSMParameterStoreLoader,
+ * } from '@dyanet/config-aws';
+ * ```
+ *
+ * @packageDocumentation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasEnv = exports.getAllEnv = exports.envFrom = exports.env = exports.generateScriptContent = exports.filterEnvVars = exports.PublicEnvScript = exports.ConfigContext = exports.useConfig = exports.ConfigProvider = exports.createConfigProvider = exports.invalidateConfig = exports.getConfigCacheSize = exports.clearConfigCache = exports.getConfig = exports.EnvFileParser = exports.ConfigValidationUtil = exports.ConfigManager = exports.SSMParameterStoreLoader = exports.SecretsManagerLoader = exports.S3Loader = exports.EnvFileLoader = exports.EnvironmentLoader = exports.MissingConfigurationError = exports.ConfigurationLoadError = exports.AWSServiceError = exports.ValidationError = exports.ConfigurationError = void 0;
+exports.env = exports.PublicEnvScript = exports.getConfig = exports.ValidationError = exports.ConfigurationError = void 0;
+// Error classes for error handling
 var config_aws_1 = require("@dyanet/config-aws");
 Object.defineProperty(exports, "ConfigurationError", { enumerable: true, get: function () { return config_aws_1.ConfigurationError; } });
 Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return config_aws_1.ValidationError; } });
-Object.defineProperty(exports, "AWSServiceError", { enumerable: true, get: function () { return config_aws_1.AWSServiceError; } });
-Object.defineProperty(exports, "ConfigurationLoadError", { enumerable: true, get: function () { return config_aws_1.ConfigurationLoadError; } });
-Object.defineProperty(exports, "MissingConfigurationError", { enumerable: true, get: function () { return config_aws_1.MissingConfigurationError; } });
-Object.defineProperty(exports, "EnvironmentLoader", { enumerable: true, get: function () { return config_aws_1.EnvironmentLoader; } });
-Object.defineProperty(exports, "EnvFileLoader", { enumerable: true, get: function () { return config_aws_1.EnvFileLoader; } });
-Object.defineProperty(exports, "S3Loader", { enumerable: true, get: function () { return config_aws_1.S3Loader; } });
-Object.defineProperty(exports, "SecretsManagerLoader", { enumerable: true, get: function () { return config_aws_1.SecretsManagerLoader; } });
-Object.defineProperty(exports, "SSMParameterStoreLoader", { enumerable: true, get: function () { return config_aws_1.SSMParameterStoreLoader; } });
-Object.defineProperty(exports, "ConfigManager", { enumerable: true, get: function () { return config_aws_1.ConfigManager; } });
-Object.defineProperty(exports, "ConfigValidationUtil", { enumerable: true, get: function () { return config_aws_1.ConfigValidationUtil; } });
-Object.defineProperty(exports, "EnvFileParser", { enumerable: true, get: function () { return config_aws_1.EnvFileParser; } });
-// Server-side exports
+// Server-side configuration loading
 var server_1 = require("./server");
 Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return server_1.getConfig; } });
-Object.defineProperty(exports, "clearConfigCache", { enumerable: true, get: function () { return server_1.clearConfigCache; } });
-Object.defineProperty(exports, "getConfigCacheSize", { enumerable: true, get: function () { return server_1.getConfigCacheSize; } });
-Object.defineProperty(exports, "invalidateConfig", { enumerable: true, get: function () { return server_1.invalidateConfig; } });
-Object.defineProperty(exports, "createConfigProvider", { enumerable: true, get: function () { return server_1.createConfigProvider; } });
-Object.defineProperty(exports, "ConfigProvider", { enumerable: true, get: function () { return server_1.ConfigProvider; } });
-Object.defineProperty(exports, "useConfig", { enumerable: true, get: function () { return server_1.useConfig; } });
-Object.defineProperty(exports, "ConfigContext", { enumerable: true, get: function () { return server_1.ConfigContext; } });
-// Components for runtime environment variables
+// Component for runtime environment variables
 var components_1 = require("./components");
 Object.defineProperty(exports, "PublicEnvScript", { enumerable: true, get: function () { return components_1.PublicEnvScript; } });
-Object.defineProperty(exports, "filterEnvVars", { enumerable: true, get: function () { return components_1.filterEnvVars; } });
-Object.defineProperty(exports, "generateScriptContent", { enumerable: true, get: function () { return components_1.generateScriptContent; } });
 // Client-side environment variable access
 var client_1 = require("./client");
 Object.defineProperty(exports, "env", { enumerable: true, get: function () { return client_1.env; } });
-Object.defineProperty(exports, "envFrom", { enumerable: true, get: function () { return client_1.envFrom; } });
-Object.defineProperty(exports, "getAllEnv", { enumerable: true, get: function () { return client_1.getAllEnv; } });
-Object.defineProperty(exports, "hasEnv", { enumerable: true, get: function () { return client_1.hasEnv; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAoBH,iDAc4B;AAb1B,gHAAA,kBAAkB,OAAA;AAClB,6GAAA,eAAe,OAAA;AACf,6GAAA,eAAe,OAAA;AACf,oHAAA,sBAAsB,OAAA;AACtB,uHAAA,yBAAyB,OAAA;AACzB,+GAAA,iBAAiB,OAAA;AACjB,2GAAA,aAAa,OAAA;AACb,sGAAA,QAAQ,OAAA;AACR,kHAAA,oBAAoB,OAAA;AACpB,qHAAA,uBAAuB,OAAA;AACvB,2GAAA,aAAa,OAAA;AACb,kHAAA,oBAAoB,OAAA;AACpB,2GAAA,aAAa,OAAA;AAGf,sBAAsB;AACtB,mCAUkB;AAThB,mGAAA,SAAS,OAAA;AACT,0GAAA,gBAAgB,OAAA;AAChB,4GAAA,kBAAkB,OAAA;AAClB,0GAAA,gBAAgB,OAAA;AAEhB,8GAAA,oBAAoB,OAAA;AACpB,wGAAA,cAAc,OAAA;AACd,mGAAA,SAAS,OAAA;AACT,uGAAA,aAAa,OAAA;AAGf,+CAA+C;AAC/C,2CAKsB;AAJpB,6GAAA,eAAe,OAAA;AACf,2GAAA,aAAa,OAAA;AACb,mHAAA,qBAAqB,OAAA;AAIvB,0CAA0C;AAC1C,mCAA2D;AAAlD,6FAAA,GAAG,OAAA;AAAE,iGAAA,OAAO,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,gGAAA,MAAM,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;;;AAEH,mCAAmC;AACnC,iDAAyE;AAAhE,gHAAA,kBAAkB,OAAA;AAAE,6GAAA,eAAe,OAAA;AAE5C,oCAAoC;AACpC,mCAA6D;AAApD,mGAAA,SAAS,OAAA;AAElB,8CAA8C;AAC9C,2CAA0E;AAAjE,6GAAA,eAAe,OAAA;AAExB,0CAA0C;AAC1C,mCAA+B;AAAtB,6FAAA,GAAG,OAAA"}