@korioinc/next-conf 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Korio Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,90 @@
+# @korioinc/next-conf
+
+Configuration management system for Next.js applications.
+
+## Installation
+
+```bash
+pnpm add @korioinc/next-conf
+```
+
+## Features
+
+- **Centralized Configuration**: Manage all app configurations in one place
+- **Type-safe**: Full TypeScript support with autocompletion
+- **Environment-aware**: Different configs for development/production
+- **Plugin System**: Extensible plugin architecture
+- **Next.js Optimized**: Built specifically for Next.js applications
+
+## Usage
+
+### Basic Setup
+
+Create a `next-kit.config.ts` file in your project root:
+
+```typescript
+import { defineConfig } from '@korioinc/next-conf';
+
+export default defineConfig({
+  app: {
+    name: 'My App',
+    description: 'My awesome Next.js app',
+  },
+  api: {
+    baseUrl: process.env.NEXT_PUBLIC_API_URL || 'https://api.example.com',
+    timeout: 30000,
+  },
+  cookie: {
+    accessTokenName: '_at',
+    refreshTokenName: '_rt',
+  },
+  auth: {
+    redirectPath: '/dashboard',
+    loginPath: '/login',
+  },
+});
+```
+
+### Using Configuration
+
+```typescript
+import { getConfig } from '@korioinc/next-conf';
+
+// In your components or API routes
+const config = getConfig();
+console.log(config.app.name); // "My App"
+```
+
+### Plugin System
+
+```typescript
+import { defineConfig } from '@korioinc/next-conf';
+import { myPlugin } from '@korioinc/next-conf/plugin';
+
+export default defineConfig({
+  // Your config
+}, {
+  plugins: [myPlugin()],
+});
+```
+
+## Configuration Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `app.name` | `string` | Application name |
+| `app.description` | `string` | Application description |
+| `api.baseUrl` | `string` | API base URL |
+| `api.timeout` | `number` | Request timeout in ms |
+| `cookie.accessTokenName` | `string` | Access token cookie name |
+| `cookie.refreshTokenName` | `string` | Refresh token cookie name |
+| `auth.redirectPath` | `string` | Post-login redirect path |
+| `auth.loginPath` | `string` | Login page path |
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

package/dist/core/config.default.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Default configuration export
+ * This file is used as a fallback when no user configuration exists
+ */
+import type { NextCoreConfig } from '../types.js';
+declare const config: NextCoreConfig;
+export default config;
+//# sourceMappingURL=config.default.d.ts.map

package/dist/core/config.default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.default.d.ts","sourceRoot":"","sources":["../../src/core/config.default.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,QAAA,MAAM,MAAM,EAAE,cAAmB,CAAC;AAElC,eAAe,MAAM,CAAC"}

package/dist/core/config.default.js

@@ -0,0 +1,2 @@
+const config = {};
+export default config;

package/dist/core/defaults.d.ts

@@ -0,0 +1,3 @@
+import type { NextCoreConfig } from '../types.js';
+export declare const defaultConfig: Required<NextCoreConfig>;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/core/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/core/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,cAAc,CAwClD,CAAC"}

package/dist/core/defaults.js

@@ -0,0 +1,37 @@
+export const defaultConfig = {
+    // Analytics
+    analytics: {
+        gaId: undefined,
+        gtmId: undefined,
+        adsensePublisherId: undefined,
+    },
+    // API Configuration
+    api: {
+        baseUrl: 'http://localhost',
+        timeout: 10000, // 10 seconds
+        headers: {},
+    },
+    // Cookie Configuration
+    cookie: {
+        accessTokenName: '_at',
+        domain: undefined,
+        maxAge: 3 * 24 * 60 * 60, // 3 days in seconds
+    },
+    // Auth Routing Configuration
+    auth: {
+        // 로그인한 사용자가 접근할 수 없는 경로들 (로그인 상태에서 homeUrl로 리다이렉트)
+        restrictedPaths: ['/accounts/login', '/accounts/register', /^\/accounts\/login\/oauth\/[^/]+$/],
+        // 로그인이 필요한 보호된 경로들 (비로그인 상태에서 loginUrl로 리다이렉트)
+        requiredPaths: ['/accounts/profile', '/accounts/settings'],
+        // 로그인이 필요할 때 리다이렉트할 경로
+        loginUrl: '/accounts/login',
+        // 이미 로그인한 사용자가 제한된 경로 접근 시 리다이렉트할 경로
+        homeUrl: '/',
+    },
+    // Storage Configuration
+    storage: {
+        name: 'app-storage',
+        storeName: 'default-store',
+        driver: undefined, // Will use localforage default priority
+    },
+};

package/dist/core/get-config.d.ts

@@ -0,0 +1,9 @@
+import type { NextCoreConfig } from '../types.js';
+/**
+ * Get the merged configuration
+ * This function merges user configuration with defaults
+ *
+ * @returns Configuration with all required properties
+ */
+export declare function getConfig(): NextCoreConfig;
+//# sourceMappingURL=get-config.d.ts.map

package/dist/core/get-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-config.d.ts","sourceRoot":"","sources":["../../src/core/get-config.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAqBlD;;;;;GAKG;AACH,wBAAgB,SAAS,IAAI,cAAc,CAQ1C"}

package/dist/core/get-config.js

@@ -0,0 +1,37 @@
+/**
+ * Configuration loader using static imports
+ * Clean implementation without @ts-ignore
+ */
+// Import user configuration via a stable specifier that our plugin aliases
+// This avoids relying on relative aliasing which can break under Turbopack
+import userConfig from '@korioinc/next-conf/src/core/config.default';
+import { defaultConfig } from './defaults.js';
+// Merge helper that ignores empty-string overrides
+function mergeIgnoringEmptyStrings(defaults, overrides) {
+    if (!overrides)
+        return { ...defaults };
+    const result = { ...defaults };
+    for (const [key, value] of Object.entries(overrides)) {
+        if (value === undefined || value === null)
+            continue;
+        if (typeof value === 'string' && value.trim() === '')
+            continue;
+        result[key] = value;
+    }
+    return result;
+}
+/**
+ * Get the merged configuration
+ * This function merges user configuration with defaults
+ *
+ * @returns Configuration with all required properties
+ */
+export function getConfig() {
+    return {
+        analytics: mergeIgnoringEmptyStrings(defaultConfig.analytics ?? {}, userConfig?.analytics),
+        api: mergeIgnoringEmptyStrings(defaultConfig.api ?? {}, userConfig?.api),
+        cookie: mergeIgnoringEmptyStrings(defaultConfig.cookie ?? {}, userConfig?.cookie),
+        auth: mergeIgnoringEmptyStrings(defaultConfig.auth ?? {}, userConfig?.auth),
+        storage: mergeIgnoringEmptyStrings(defaultConfig.storage ?? {}, userConfig?.storage),
+    };
+}

package/dist/core/index.d.ts

@@ -0,0 +1,2 @@
+export { getConfig } from './get-config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

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

package/dist/core/index.js

@@ -0,0 +1 @@
+export { getConfig } from './get-config.js';

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { getConfig } from './core/get-config.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+// Core configuration functions
+export { getConfig } from './core/get-config.js';
+// Type definitions
+export * from './types.js';

package/dist/plugin/index.d.ts

@@ -0,0 +1,3 @@
+export { withNextKitConf } from './with-config.js';
+export type { WithConfigOptions } from './with-config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/plugin/index.js

@@ -0,0 +1 @@
+export { withNextKitConf } from './with-config.js';

package/dist/plugin/with-config.d.ts

@@ -0,0 +1,24 @@
+import type { NextConfig } from 'next';
+export interface WithConfigOptions {
+    configFileName?: string;
+}
+/**
+ * Next.js configuration plugin that injects webpack aliases
+ * Maps the default config to the actual user config file
+ *
+ * @param nextConfig - The existing Next.js configuration
+ * @param options - Plugin options
+ * @returns Enhanced Next.js configuration with alias injection
+ *
+ * @example
+ * ```typescript
+ * // next.config.ts
+ * import { withNextKitConf } from '@korioinc/next-conf/plugin';
+ *
+ * export default withNextKitConf({
+ *   // your existing config
+ * });
+ * ```
+ */
+export declare function withNextKitConf(nextConfig?: NextConfig, options?: WithConfigOptions): NextConfig;
+//# sourceMappingURL=with-config.d.ts.map

package/dist/plugin/with-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-config.d.ts","sourceRoot":"","sources":["../../src/plugin/with-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AA2BvC,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,UAAU,GAAE,UAAe,EAAE,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAwDxG"}

package/dist/plugin/with-config.js

@@ -0,0 +1,64 @@
+import * as path from 'path';
+/**
+ * Next.js configuration plugin that injects webpack aliases
+ * Maps the default config to the actual user config file
+ *
+ * @param nextConfig - The existing Next.js configuration
+ * @param options - Plugin options
+ * @returns Enhanced Next.js configuration with alias injection
+ *
+ * @example
+ * ```typescript
+ * // next.config.ts
+ * import { withNextKitConf } from '@korioinc/next-conf/plugin';
+ *
+ * export default withNextKitConf({
+ *   // your existing config
+ * });
+ * ```
+ */
+export function withNextKitConf(nextConfig = {}, options = {}) {
+    const { configFileName = 'next-kit.config.ts' } = options;
+    return {
+        ...nextConfig,
+        // Turbopack configuration for development
+        turbopack: {
+            ...nextConfig.turbopack,
+            resolveAlias: {
+                ...nextConfig.turbopack?.resolveAlias,
+                // Map config.default to the user config using a project-relative specifier
+                // Turbopack prefers specifiers (./foo.ts) over absolute file paths
+                '@korioinc/next-conf/dist/core/config.default.js': configFileName.startsWith('.') || configFileName.startsWith('/') ? configFileName : `./${configFileName}`,
+                '@korioinc/next-conf/src/core/config.default.ts': configFileName.startsWith('.') || configFileName.startsWith('/') ? configFileName : `./${configFileName}`,
+                '@korioinc/next-conf/src/core/config.default': configFileName.startsWith('.') || configFileName.startsWith('/') ? configFileName : `./${configFileName}`,
+            },
+        },
+        // Webpack configuration for production builds
+        webpack: (config, options) => {
+            // Initialize resolve.alias if it doesn't exist
+            config.resolve = config.resolve || {};
+            config.resolve.alias = config.resolve.alias || {};
+            // Map the default config to the actual user config file
+            // This allows clean static imports without any @ts-ignore
+            const cwd = options?.dir || process.cwd();
+            const userConfigPath = path.resolve(cwd, configFileName);
+            // Map package paths used by this package
+            const newConfigPaths = [
+                '@korioinc/next-conf/dist/core/config.default',
+                '@korioinc/next-conf/src/core/config.default',
+                path.resolve(cwd, 'node_modules/@korioinc/next-conf/dist/core/config.default'),
+            ];
+            const allPaths = [...newConfigPaths];
+            allPaths.forEach((defaultPath) => {
+                if (config.resolve?.alias) {
+                    config.resolve.alias[defaultPath] = userConfigPath;
+                }
+            });
+            // Call the original webpack function if it exists
+            if (typeof nextConfig.webpack === 'function') {
+                return nextConfig.webpack(config, options);
+            }
+            return config;
+        },
+    };
+}

package/dist/types.d.ts

@@ -0,0 +1,29 @@
+export interface NextCoreConfig {
+    analytics?: {
+        gaId?: string;
+        gtmId?: string;
+        adsensePublisherId?: string;
+    };
+    api?: {
+        baseUrl?: string;
+        timeout?: number;
+        headers?: Record<string, string>;
+    };
+    cookie?: {
+        accessTokenName?: string;
+        domain?: string;
+        maxAge?: number;
+    };
+    auth?: {
+        restrictedPaths?: (string | RegExp)[];
+        requiredPaths?: (string | RegExp)[];
+        loginUrl?: string;
+        homeUrl?: string;
+    };
+    storage?: {
+        name?: string;
+        storeName?: string;
+        driver?: string | string[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAE7B,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC;IAGF,GAAG,CAAC,EAAE;QACJ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC;IAGF,MAAM,CAAC,EAAE;QACP,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAGF,IAAI,CAAC,EAAE;QAEL,eAAe,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;QAEtC,aAAa,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;QAEpC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAElB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAGF,OAAO,CAAC,EAAE;QAER,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;KAC5B,CAAC;CACH"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@korioinc/next-conf",
+  "version": "1.0.0",
+  "description": "Configuration management for Next.js applications",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin/index.d.ts",
+      "import": "./dist/plugin/index.js",
+      "default": "./dist/plugin/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json -w",
+    "test": "vitest",
+    "lint": "eslint . --max-warnings 0",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "next": ">=15"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.18.1",
+    "typescript": "^5.9.2",
+    "vitest": "^2.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/korioinc/korio-nextjs-kit.git",
+    "directory": "packages/conf"
+  },
+  "author": "Korio Inc.",
+  "license": "MIT"
+}