@loftisland-oss/ssm-loader 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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,150 @@
+# @loftisland-oss/ssm-loader
+
+AWS Systems Manager Parameter Store 값을 `process.env`로 로드하는 작은 라이브러리입니다.
+JS/TS, CJS/ESM 모두에서 그대로 사용할 수 있습니다.
+
+두 가지 사용 패턴을 지원합니다.
+
+1. **경로(prefix) 기반** — `/prod/my-service/`처럼 특정 경로로 시작하는 파라미터를 전부 가져옵니다.
+2. **이름 직접 지정** — 파라미터 이름을 하나 이상 직접 지정해서 가져옵니다.
+
+두 패턴은 함께 사용할 수도 있습니다.
+
+## 설치
+
+```bash
+npm install @loftisland-oss/ssm-loader
+```
+
+`@aws-sdk/client-ssm`은 이 패키지의 `dependencies`에 포함되어 있어 별도로 설치할 필요가 없습니다.
+
+## 사용법
+
+### 1. 경로 prefix로 전부 가져오기
+
+```ts
+import { loadSsmConfig } from '@loftisland-oss/ssm-loader';
+
+await loadSsmConfig({
+  paths: { path: '/prod/my-service/' },
+});
+
+// /prod/my-service/DB_HOST -> process.env.DB_HOST
+// /prod/my-service/DB_PORT -> process.env.DB_PORT
+```
+
+하위 경로까지 재귀적으로 가져오려면 `recursive: true`를 사용하세요.
+
+```ts
+await loadSsmConfig({
+  paths: { path: '/prod/my-service/', recursive: true },
+});
+```
+
+### 2. 파라미터 이름을 직접 지정해서 가져오기
+
+```ts
+await loadSsmConfig({
+  names: ['/prod/my-service/DB_HOST', '/prod/my-service/API_KEY'],
+});
+
+// process.env.DB_HOST, process.env.API_KEY 로 설정됩니다 (이름의 마지막 "/" 구간이 키가 됩니다)
+```
+
+env 키를 직접 지정하고 싶다면:
+
+```ts
+await loadSsmConfig({
+  names: [
+    { name: '/prod/my-service/DB_HOST', envKey: 'DATABASE_HOST' },
+    '/prod/my-service/API_KEY',
+  ],
+});
+```
+
+### 두 패턴 함께 사용
+
+```ts
+await loadSsmConfig({
+  paths: { path: '/prod/my-service/' },
+  names: ['/shared/API_KEY'],
+});
+```
+
+### 개발 환경에서 SSM 호출 생략하기
+
+기존 코드의 "dev면 SSM 건너뛰고 .env 사용" 패턴은 `skip` 옵션으로 그대로 구현할 수 있습니다.
+
+```ts
+const DEV_ENVS = ['development', 'dev'];
+
+await loadSsmConfig({
+  skip: DEV_ENVS.includes(process.env.NODE_ENV ?? ''),
+  paths: { path: '/prod/my-service/' },
+});
+```
+
+### NestJS Logger 등 커스텀 로거 사용하기
+
+기본적으로 `console`을 사용하는 로거가 내장되어 있습니다. NestJS의 `Logger` 등 자체 로거를 쓰려면
+`log(message)` / `error(message)` 를 가진 객체를 넘기면 됩니다.
+
+```ts
+import { Logger } from '@nestjs/common';
+import { loadSsmConfig } from '@loftisland-oss/ssm-loader';
+
+const logger = new Logger('SSM');
+
+await loadSsmConfig({
+  logger,
+  paths: { path: '/prod/my-service/' },
+});
+```
+
+로그를 완전히 끄고 싶다면 `logger: null`을 전달하세요.
+
+### JavaScript (CommonJS)에서 사용하기
+
+```js
+const { loadSsmConfig } = require('@loftisland-oss/ssm-loader');
+
+loadSsmConfig({ paths: { path: '/prod/my-service/' } }).then(() => {
+  console.log(process.env.DB_HOST);
+});
+```
+
+## API
+
+### `loadSsmConfig(options): Promise<{ values: Record<string, string>; count: number }>`
+
+| 옵션 | 타입 | 기본값 | 설명 |
+| --- | --- | --- | --- |
+| `paths` | `ByPathSource \| ByPathSource[]` | - | 경로 prefix로 파라미터를 가져옵니다 |
+| `names` | `Array<string \| ByNameSource>` | - | 파라미터 이름을 직접 지정합니다 |
+| `region` | `string` | `AWS_REGION` env → `"ap-northeast-2"` | AWS 리전 |
+| `client` | `SSMClient` | 새로 생성 | 기존 `SSMClient` 재사용 (테스트/커스텀 자격증명용) |
+| `withDecryption` | `boolean` | `true` | `SecureString` 복호화 여부 |
+| `setEnv` | `boolean` | `true` | 결과를 `process.env`에 반영할지 여부 |
+| `overrideExisting` | `boolean` | `true` | 이미 설정된 env 키를 덮어쓸지 여부 |
+| `skip` | `boolean` | `false` | `true`면 SSM 호출 없이 빈 결과 반환 |
+| `logger` | `SimpleLogger \| null` | 내장 콘솔 로거 | 커스텀 로거, `null`이면 로그 비활성화 |
+
+`ByPathSource`
+
+| 필드 | 타입 | 기본값 | 설명 |
+| --- | --- | --- | --- |
+| `path` | `string` | - | 파라미터 경로 prefix |
+| `recursive` | `boolean` | `false` | 하위 경로까지 재귀적으로 조회 |
+| `stripPrefix` | `boolean` | `true` | 결과 키에서 `path` prefix를 제거할지 여부 |
+| `transformKey` | `(key: string) => string` | - | 최종 키 변환 함수 |
+
+`ByNameSource`
+
+| 필드 | 타입 | 기본값 | 설명 |
+| --- | --- | --- | --- |
+| `name` | `string` | - | 파라미터 전체 이름 |
+| `envKey` | `string` | 이름의 마지막 `/` 구간 | 결과에 사용할 env 키 |
+
+## 라이선스
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,142 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  defaultLogger: () => defaultLogger,
+  loadSsmConfig: () => loadSsmConfig
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/loader.ts
+var import_client_ssm = require("@aws-sdk/client-ssm");
+
+// src/logger.ts
+var defaultLogger = {
+  log: (message) => console.log(`[aws-ssm-loader] ${message}`),
+  error: (message) => console.error(`[aws-ssm-loader] ${message}`)
+};
+
+// src/loader.ts
+var MAX_NAMES_PER_REQUEST = 10;
+function chunk(items, size) {
+  const chunks = [];
+  for (let i = 0; i < items.length; i += size) {
+    chunks.push(items.slice(i, i + size));
+  }
+  return chunks;
+}
+function deriveKeyFromPath(paramName, source) {
+  let key = source.stripPrefix === false ? paramName : paramName.replace(source.path, "");
+  if (key.startsWith("/")) key = key.slice(1);
+  return source.transformKey ? source.transformKey(key) : key;
+}
+function deriveKeyFromName(paramName, source) {
+  if (source.envKey) return source.envKey;
+  const segments = paramName.split("/").filter(Boolean);
+  return segments[segments.length - 1] ?? paramName;
+}
+async function fetchByPath(client, source, withDecryption) {
+  const result = {};
+  let nextToken;
+  do {
+    const response = await client.send(
+      new import_client_ssm.GetParametersByPathCommand({
+        Path: source.path,
+        WithDecryption: withDecryption,
+        Recursive: source.recursive ?? false,
+        NextToken: nextToken
+      })
+    );
+    for (const param of response.Parameters ?? []) {
+      if (!param.Name || param.Value === void 0) continue;
+      const key = deriveKeyFromPath(param.Name, source);
+      if (key) result[key] = param.Value;
+    }
+    nextToken = response.NextToken;
+  } while (nextToken);
+  return result;
+}
+async function fetchByNames(client, sources, withDecryption, logger) {
+  const result = {};
+  const byName = new Map(sources.map((source) => [source.name, source]));
+  for (const names of chunk(sources.map((source) => source.name), MAX_NAMES_PER_REQUEST)) {
+    const response = await client.send(
+      new import_client_ssm.GetParametersCommand({ Names: names, WithDecryption: withDecryption })
+    );
+    for (const param of response.Parameters ?? []) {
+      if (!param.Name || param.Value === void 0) continue;
+      const source = byName.get(param.Name);
+      if (!source) continue;
+      result[deriveKeyFromName(param.Name, source)] = param.Value;
+    }
+    if (response.InvalidParameters?.length) {
+      logger?.error(`Invalid SSM parameter name(s): ${response.InvalidParameters.join(", ")}`);
+    }
+  }
+  return result;
+}
+async function loadSsmConfig(options = {}) {
+  const logger = options.logger === null ? null : options.logger ?? defaultLogger;
+  if (options.skip) {
+    logger?.log("Skipped loading SSM parameters (skip=true)");
+    return { values: {}, count: 0 };
+  }
+  const pathSources = options.paths ? Array.isArray(options.paths) ? options.paths : [options.paths] : [];
+  const nameSources = (options.names ?? []).map(
+    (entry) => typeof entry === "string" ? { name: entry } : entry
+  );
+  if (pathSources.length === 0 && nameSources.length === 0) {
+    throw new Error('loadSsmConfig requires at least one of "paths" or "names".');
+  }
+  const region = options.region ?? process.env.AWS_REGION ?? "ap-northeast-2";
+  const client = options.client ?? new import_client_ssm.SSMClient({ region });
+  const withDecryption = options.withDecryption ?? true;
+  const setEnv = options.setEnv ?? true;
+  const overrideExisting = options.overrideExisting ?? true;
+  try {
+    const values = {};
+    for (const source of pathSources) {
+      Object.assign(values, await fetchByPath(client, source, withDecryption));
+    }
+    if (nameSources.length > 0) {
+      Object.assign(values, await fetchByNames(client, nameSources, withDecryption, logger));
+    }
+    if (setEnv) {
+      for (const [key, value] of Object.entries(values)) {
+        if (overrideExisting || process.env[key] === void 0) {
+          process.env[key] = value;
+        }
+      }
+    }
+    logger?.log(`Loaded ${Object.keys(values).length} parameter(s) from SSM`);
+    return { values, count: Object.keys(values).length };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    logger?.error(`Failed to load SSM config: ${message}`);
+    throw error;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defaultLogger,
+  loadSsmConfig
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/loader.ts","../src/logger.ts"],"sourcesContent":["export { loadSsmConfig } from './loader.js';\nexport { defaultLogger } from './logger.js';\nexport type {\n  ByNameSource,\n  ByPathSource,\n  LoadSsmConfigOptions,\n  LoadSsmConfigResult,\n  SimpleLogger,\n} from './types.js';\n","import { GetParametersByPathCommand, GetParametersCommand, SSMClient } from '@aws-sdk/client-ssm';\nimport { defaultLogger } from './logger.js';\nimport type {\n  ByNameSource,\n  ByPathSource,\n  LoadSsmConfigOptions,\n  LoadSsmConfigResult,\n  SimpleLogger,\n} from './types.js';\n\nconst MAX_NAMES_PER_REQUEST = 10;\n\nfunction chunk<T>(items: T[], size: number): T[][] {\n  const chunks: T[][] = [];\n  for (let i = 0; i < items.length; i += size) {\n    chunks.push(items.slice(i, i + size));\n  }\n  return chunks;\n}\n\nfunction deriveKeyFromPath(paramName: string, source: ByPathSource): string {\n  let key = source.stripPrefix === false ? paramName : paramName.replace(source.path, '');\n  if (key.startsWith('/')) key = key.slice(1);\n  return source.transformKey ? source.transformKey(key) : key;\n}\n\nfunction deriveKeyFromName(paramName: string, source: ByNameSource): string {\n  if (source.envKey) return source.envKey;\n  const segments = paramName.split('/').filter(Boolean);\n  return segments[segments.length - 1] ?? paramName;\n}\n\nasync function fetchByPath(\n  client: SSMClient,\n  source: ByPathSource,\n  withDecryption: boolean,\n): Promise<Record<string, string>> {\n  const result: Record<string, string> = {};\n  let nextToken: string | undefined;\n\n  do {\n    const response = await client.send(\n      new GetParametersByPathCommand({\n        Path: source.path,\n        WithDecryption: withDecryption,\n        Recursive: source.recursive ?? false,\n        NextToken: nextToken,\n      }),\n    );\n\n    for (const param of response.Parameters ?? []) {\n      if (!param.Name || param.Value === undefined) continue;\n      const key = deriveKeyFromPath(param.Name, source);\n      if (key) result[key] = param.Value;\n    }\n\n    nextToken = response.NextToken;\n  } while (nextToken);\n\n  return result;\n}\n\nasync function fetchByNames(\n  client: SSMClient,\n  sources: ByNameSource[],\n  withDecryption: boolean,\n  logger: SimpleLogger | null,\n): Promise<Record<string, string>> {\n  const result: Record<string, string> = {};\n  const byName = new Map(sources.map((source) => [source.name, source]));\n\n  for (const names of chunk(sources.map((source) => source.name), MAX_NAMES_PER_REQUEST)) {\n    const response = await client.send(\n      new GetParametersCommand({ Names: names, WithDecryption: withDecryption }),\n    );\n\n    for (const param of response.Parameters ?? []) {\n      if (!param.Name || param.Value === undefined) continue;\n      const source = byName.get(param.Name);\n      if (!source) continue;\n      result[deriveKeyFromName(param.Name, source)] = param.Value;\n    }\n\n    if (response.InvalidParameters?.length) {\n      logger?.error(`Invalid SSM parameter name(s): ${response.InvalidParameters.join(', ')}`);\n    }\n  }\n\n  return result;\n}\n\n/**\n * Load AWS SSM Parameter Store values, optionally assigning them onto process.env.\n *\n * Supports two source patterns, usable together:\n *  - `paths`: fetch everything under a path prefix (GetParametersByPath)\n *  - `names`: fetch one or more explicit parameter names (GetParameters)\n */\nexport async function loadSsmConfig(\n  options: LoadSsmConfigOptions = {},\n): Promise<LoadSsmConfigResult> {\n  const logger = options.logger === null ? null : options.logger ?? defaultLogger;\n\n  if (options.skip) {\n    logger?.log('Skipped loading SSM parameters (skip=true)');\n    return { values: {}, count: 0 };\n  }\n\n  const pathSources: ByPathSource[] = options.paths\n    ? Array.isArray(options.paths)\n      ? options.paths\n      : [options.paths]\n    : [];\n\n  const nameSources: ByNameSource[] = (options.names ?? []).map((entry) =>\n    typeof entry === 'string' ? { name: entry } : entry,\n  );\n\n  if (pathSources.length === 0 && nameSources.length === 0) {\n    throw new Error('loadSsmConfig requires at least one of \"paths\" or \"names\".');\n  }\n\n  const region = options.region ?? process.env.AWS_REGION ?? 'ap-northeast-2';\n  const client = options.client ?? new SSMClient({ region });\n  const withDecryption = options.withDecryption ?? true;\n  const setEnv = options.setEnv ?? true;\n  const overrideExisting = options.overrideExisting ?? true;\n\n  try {\n    const values: Record<string, string> = {};\n\n    for (const source of pathSources) {\n      Object.assign(values, await fetchByPath(client, source, withDecryption));\n    }\n\n    if (nameSources.length > 0) {\n      Object.assign(values, await fetchByNames(client, nameSources, withDecryption, logger));\n    }\n\n    if (setEnv) {\n      for (const [key, value] of Object.entries(values)) {\n        if (overrideExisting || process.env[key] === undefined) {\n          process.env[key] = value;\n        }\n      }\n    }\n\n    logger?.log(`Loaded ${Object.keys(values).length} parameter(s) from SSM`);\n\n    return { values, count: Object.keys(values).length };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger?.error(`Failed to load SSM config: ${message}`);\n    throw error;\n  }\n}\n","import type { SimpleLogger } from './types.js';\n\nexport const defaultLogger: SimpleLogger = {\n  log: (message) => console.log(`[aws-ssm-loader] ${message}`),\n  error: (message) => console.error(`[aws-ssm-loader] ${message}`),\n};\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,63 @@
+import { SSMClient } from '@aws-sdk/client-ssm';
+
+interface SimpleLogger {
+    log(message: string): void;
+    error(message: string): void;
+}
+/** Fetch every parameter under a path prefix, e.g. "/prod/my-service/". */
+interface ByPathSource {
+    /** Parameter Store path prefix. Trailing slash recommended. */
+    path: string;
+    /** Also fetch parameters under nested sub-paths. Default: false. */
+    recursive?: boolean;
+    /** Strip the `path` prefix from the derived env key. Default: true. */
+    stripPrefix?: boolean;
+    /** Transform the derived key (after prefix stripping) before it is used. */
+    transformKey?: (key: string) => string;
+}
+/** Fetch one explicit parameter by its full name. */
+interface ByNameSource {
+    /** Full Parameter Store name, e.g. "/prod/my-service/DB_HOST". */
+    name: string;
+    /** Env var key to assign. Defaults to the last "/"-separated segment of `name`. */
+    envKey?: string;
+}
+interface LoadSsmConfigOptions {
+    /** AWS region. Defaults to process.env.AWS_REGION, then "ap-northeast-2". */
+    region?: string;
+    /** Reuse an existing SSMClient instead of creating a new one (e.g. for testing or custom credentials). */
+    client?: SSMClient;
+    /** Decrypt SecureString parameters. Default: true. */
+    withDecryption?: boolean;
+    /** Assign resolved values onto process.env. Default: true. */
+    setEnv?: boolean;
+    /** When setting process.env, override keys that are already set. Default: true. */
+    overrideExisting?: boolean;
+    /** Skip fetching entirely and return an empty result (e.g. for local/dev environments). */
+    skip?: boolean;
+    /** Custom logger, or `null` to disable logging. Defaults to a console-based logger. */
+    logger?: SimpleLogger | null;
+    /** One or more path prefixes to fetch recursively via GetParametersByPath. */
+    paths?: ByPathSource | ByPathSource[];
+    /** Explicit parameter names to fetch via GetParameters. Strings are shorthand for `{ name }`. */
+    names?: Array<string | ByNameSource>;
+}
+interface LoadSsmConfigResult {
+    /** Env-key -> value map of every parameter that was resolved. */
+    values: Record<string, string>;
+    /** Number of parameters resolved. */
+    count: number;
+}
+
+/**
+ * Load AWS SSM Parameter Store values, optionally assigning them onto process.env.
+ *
+ * Supports two source patterns, usable together:
+ *  - `paths`: fetch everything under a path prefix (GetParametersByPath)
+ *  - `names`: fetch one or more explicit parameter names (GetParameters)
+ */
+declare function loadSsmConfig(options?: LoadSsmConfigOptions): Promise<LoadSsmConfigResult>;
+
+declare const defaultLogger: SimpleLogger;
+
+export { type ByNameSource, type ByPathSource, type LoadSsmConfigOptions, type LoadSsmConfigResult, type SimpleLogger, defaultLogger, loadSsmConfig };

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+import { SSMClient } from '@aws-sdk/client-ssm';
+
+interface SimpleLogger {
+    log(message: string): void;
+    error(message: string): void;
+}
+/** Fetch every parameter under a path prefix, e.g. "/prod/my-service/". */
+interface ByPathSource {
+    /** Parameter Store path prefix. Trailing slash recommended. */
+    path: string;
+    /** Also fetch parameters under nested sub-paths. Default: false. */
+    recursive?: boolean;
+    /** Strip the `path` prefix from the derived env key. Default: true. */
+    stripPrefix?: boolean;
+    /** Transform the derived key (after prefix stripping) before it is used. */
+    transformKey?: (key: string) => string;
+}
+/** Fetch one explicit parameter by its full name. */
+interface ByNameSource {
+    /** Full Parameter Store name, e.g. "/prod/my-service/DB_HOST". */
+    name: string;
+    /** Env var key to assign. Defaults to the last "/"-separated segment of `name`. */
+    envKey?: string;
+}
+interface LoadSsmConfigOptions {
+    /** AWS region. Defaults to process.env.AWS_REGION, then "ap-northeast-2". */
+    region?: string;
+    /** Reuse an existing SSMClient instead of creating a new one (e.g. for testing or custom credentials). */
+    client?: SSMClient;
+    /** Decrypt SecureString parameters. Default: true. */
+    withDecryption?: boolean;
+    /** Assign resolved values onto process.env. Default: true. */
+    setEnv?: boolean;
+    /** When setting process.env, override keys that are already set. Default: true. */
+    overrideExisting?: boolean;
+    /** Skip fetching entirely and return an empty result (e.g. for local/dev environments). */
+    skip?: boolean;
+    /** Custom logger, or `null` to disable logging. Defaults to a console-based logger. */
+    logger?: SimpleLogger | null;
+    /** One or more path prefixes to fetch recursively via GetParametersByPath. */
+    paths?: ByPathSource | ByPathSource[];
+    /** Explicit parameter names to fetch via GetParameters. Strings are shorthand for `{ name }`. */
+    names?: Array<string | ByNameSource>;
+}
+interface LoadSsmConfigResult {
+    /** Env-key -> value map of every parameter that was resolved. */
+    values: Record<string, string>;
+    /** Number of parameters resolved. */
+    count: number;
+}
+
+/**
+ * Load AWS SSM Parameter Store values, optionally assigning them onto process.env.
+ *
+ * Supports two source patterns, usable together:
+ *  - `paths`: fetch everything under a path prefix (GetParametersByPath)
+ *  - `names`: fetch one or more explicit parameter names (GetParameters)
+ */
+declare function loadSsmConfig(options?: LoadSsmConfigOptions): Promise<LoadSsmConfigResult>;
+
+declare const defaultLogger: SimpleLogger;
+
+export { type ByNameSource, type ByPathSource, type LoadSsmConfigOptions, type LoadSsmConfigResult, type SimpleLogger, defaultLogger, loadSsmConfig };

package/dist/index.js

@@ -0,0 +1,114 @@
+// src/loader.ts
+import { GetParametersByPathCommand, GetParametersCommand, SSMClient } from "@aws-sdk/client-ssm";
+
+// src/logger.ts
+var defaultLogger = {
+  log: (message) => console.log(`[aws-ssm-loader] ${message}`),
+  error: (message) => console.error(`[aws-ssm-loader] ${message}`)
+};
+
+// src/loader.ts
+var MAX_NAMES_PER_REQUEST = 10;
+function chunk(items, size) {
+  const chunks = [];
+  for (let i = 0; i < items.length; i += size) {
+    chunks.push(items.slice(i, i + size));
+  }
+  return chunks;
+}
+function deriveKeyFromPath(paramName, source) {
+  let key = source.stripPrefix === false ? paramName : paramName.replace(source.path, "");
+  if (key.startsWith("/")) key = key.slice(1);
+  return source.transformKey ? source.transformKey(key) : key;
+}
+function deriveKeyFromName(paramName, source) {
+  if (source.envKey) return source.envKey;
+  const segments = paramName.split("/").filter(Boolean);
+  return segments[segments.length - 1] ?? paramName;
+}
+async function fetchByPath(client, source, withDecryption) {
+  const result = {};
+  let nextToken;
+  do {
+    const response = await client.send(
+      new GetParametersByPathCommand({
+        Path: source.path,
+        WithDecryption: withDecryption,
+        Recursive: source.recursive ?? false,
+        NextToken: nextToken
+      })
+    );
+    for (const param of response.Parameters ?? []) {
+      if (!param.Name || param.Value === void 0) continue;
+      const key = deriveKeyFromPath(param.Name, source);
+      if (key) result[key] = param.Value;
+    }
+    nextToken = response.NextToken;
+  } while (nextToken);
+  return result;
+}
+async function fetchByNames(client, sources, withDecryption, logger) {
+  const result = {};
+  const byName = new Map(sources.map((source) => [source.name, source]));
+  for (const names of chunk(sources.map((source) => source.name), MAX_NAMES_PER_REQUEST)) {
+    const response = await client.send(
+      new GetParametersCommand({ Names: names, WithDecryption: withDecryption })
+    );
+    for (const param of response.Parameters ?? []) {
+      if (!param.Name || param.Value === void 0) continue;
+      const source = byName.get(param.Name);
+      if (!source) continue;
+      result[deriveKeyFromName(param.Name, source)] = param.Value;
+    }
+    if (response.InvalidParameters?.length) {
+      logger?.error(`Invalid SSM parameter name(s): ${response.InvalidParameters.join(", ")}`);
+    }
+  }
+  return result;
+}
+async function loadSsmConfig(options = {}) {
+  const logger = options.logger === null ? null : options.logger ?? defaultLogger;
+  if (options.skip) {
+    logger?.log("Skipped loading SSM parameters (skip=true)");
+    return { values: {}, count: 0 };
+  }
+  const pathSources = options.paths ? Array.isArray(options.paths) ? options.paths : [options.paths] : [];
+  const nameSources = (options.names ?? []).map(
+    (entry) => typeof entry === "string" ? { name: entry } : entry
+  );
+  if (pathSources.length === 0 && nameSources.length === 0) {
+    throw new Error('loadSsmConfig requires at least one of "paths" or "names".');
+  }
+  const region = options.region ?? process.env.AWS_REGION ?? "ap-northeast-2";
+  const client = options.client ?? new SSMClient({ region });
+  const withDecryption = options.withDecryption ?? true;
+  const setEnv = options.setEnv ?? true;
+  const overrideExisting = options.overrideExisting ?? true;
+  try {
+    const values = {};
+    for (const source of pathSources) {
+      Object.assign(values, await fetchByPath(client, source, withDecryption));
+    }
+    if (nameSources.length > 0) {
+      Object.assign(values, await fetchByNames(client, nameSources, withDecryption, logger));
+    }
+    if (setEnv) {
+      for (const [key, value] of Object.entries(values)) {
+        if (overrideExisting || process.env[key] === void 0) {
+          process.env[key] = value;
+        }
+      }
+    }
+    logger?.log(`Loaded ${Object.keys(values).length} parameter(s) from SSM`);
+    return { values, count: Object.keys(values).length };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    logger?.error(`Failed to load SSM config: ${message}`);
+    throw error;
+  }
+}
+export {
+  defaultLogger,
+  loadSsmConfig
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/loader.ts","../src/logger.ts"],"sourcesContent":["import { GetParametersByPathCommand, GetParametersCommand, SSMClient } from '@aws-sdk/client-ssm';\nimport { defaultLogger } from './logger.js';\nimport type {\n  ByNameSource,\n  ByPathSource,\n  LoadSsmConfigOptions,\n  LoadSsmConfigResult,\n  SimpleLogger,\n} from './types.js';\n\nconst MAX_NAMES_PER_REQUEST = 10;\n\nfunction chunk<T>(items: T[], size: number): T[][] {\n  const chunks: T[][] = [];\n  for (let i = 0; i < items.length; i += size) {\n    chunks.push(items.slice(i, i + size));\n  }\n  return chunks;\n}\n\nfunction deriveKeyFromPath(paramName: string, source: ByPathSource): string {\n  let key = source.stripPrefix === false ? paramName : paramName.replace(source.path, '');\n  if (key.startsWith('/')) key = key.slice(1);\n  return source.transformKey ? source.transformKey(key) : key;\n}\n\nfunction deriveKeyFromName(paramName: string, source: ByNameSource): string {\n  if (source.envKey) return source.envKey;\n  const segments = paramName.split('/').filter(Boolean);\n  return segments[segments.length - 1] ?? paramName;\n}\n\nasync function fetchByPath(\n  client: SSMClient,\n  source: ByPathSource,\n  withDecryption: boolean,\n): Promise<Record<string, string>> {\n  const result: Record<string, string> = {};\n  let nextToken: string | undefined;\n\n  do {\n    const response = await client.send(\n      new GetParametersByPathCommand({\n        Path: source.path,\n        WithDecryption: withDecryption,\n        Recursive: source.recursive ?? false,\n        NextToken: nextToken,\n      }),\n    );\n\n    for (const param of response.Parameters ?? []) {\n      if (!param.Name || param.Value === undefined) continue;\n      const key = deriveKeyFromPath(param.Name, source);\n      if (key) result[key] = param.Value;\n    }\n\n    nextToken = response.NextToken;\n  } while (nextToken);\n\n  return result;\n}\n\nasync function fetchByNames(\n  client: SSMClient,\n  sources: ByNameSource[],\n  withDecryption: boolean,\n  logger: SimpleLogger | null,\n): Promise<Record<string, string>> {\n  const result: Record<string, string> = {};\n  const byName = new Map(sources.map((source) => [source.name, source]));\n\n  for (const names of chunk(sources.map((source) => source.name), MAX_NAMES_PER_REQUEST)) {\n    const response = await client.send(\n      new GetParametersCommand({ Names: names, WithDecryption: withDecryption }),\n    );\n\n    for (const param of response.Parameters ?? []) {\n      if (!param.Name || param.Value === undefined) continue;\n      const source = byName.get(param.Name);\n      if (!source) continue;\n      result[deriveKeyFromName(param.Name, source)] = param.Value;\n    }\n\n    if (response.InvalidParameters?.length) {\n      logger?.error(`Invalid SSM parameter name(s): ${response.InvalidParameters.join(', ')}`);\n    }\n  }\n\n  return result;\n}\n\n/**\n * Load AWS SSM Parameter Store values, optionally assigning them onto process.env.\n *\n * Supports two source patterns, usable together:\n *  - `paths`: fetch everything under a path prefix (GetParametersByPath)\n *  - `names`: fetch one or more explicit parameter names (GetParameters)\n */\nexport async function loadSsmConfig(\n  options: LoadSsmConfigOptions = {},\n): Promise<LoadSsmConfigResult> {\n  const logger = options.logger === null ? null : options.logger ?? defaultLogger;\n\n  if (options.skip) {\n    logger?.log('Skipped loading SSM parameters (skip=true)');\n    return { values: {}, count: 0 };\n  }\n\n  const pathSources: ByPathSource[] = options.paths\n    ? Array.isArray(options.paths)\n      ? options.paths\n      : [options.paths]\n    : [];\n\n  const nameSources: ByNameSource[] = (options.names ?? []).map((entry) =>\n    typeof entry === 'string' ? { name: entry } : entry,\n  );\n\n  if (pathSources.length === 0 && nameSources.length === 0) {\n    throw new Error('loadSsmConfig requires at least one of \"paths\" or \"names\".');\n  }\n\n  const region = options.region ?? process.env.AWS_REGION ?? 'ap-northeast-2';\n  const client = options.client ?? new SSMClient({ region });\n  const withDecryption = options.withDecryption ?? true;\n  const setEnv = options.setEnv ?? true;\n  const overrideExisting = options.overrideExisting ?? true;\n\n  try {\n    const values: Record<string, string> = {};\n\n    for (const source of pathSources) {\n      Object.assign(values, await fetchByPath(client, source, withDecryption));\n    }\n\n    if (nameSources.length > 0) {\n      Object.assign(values, await fetchByNames(client, nameSources, withDecryption, logger));\n    }\n\n    if (setEnv) {\n      for (const [key, value] of Object.entries(values)) {\n        if (overrideExisting || process.env[key] === undefined) {\n          process.env[key] = value;\n        }\n      }\n    }\n\n    logger?.log(`Loaded ${Object.keys(values).length} parameter(s) from SSM`);\n\n    return { values, count: Object.keys(values).length };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger?.error(`Failed to load SSM config: ${message}`);\n    throw error;\n  }\n}\n","import type { SimpleLogger } from './types.js';\n\nexport const defaultLogger: SimpleLogger = {\n  log: (message) => console.log(`[aws-ssm-loader] ${message}`),\n  error: (message) => console.error(`[aws-ssm-loader] ${message}`),\n};\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@loftisland-oss/ssm-loader",
+  "version": "0.1.0",
+  "description": "Load AWS Systems Manager Parameter Store values into process.env — by path prefix or by explicit parameter names. Works from both JS and TS, CJS and ESM.",
+  "keywords": [
+    "aws",
+    "ssm",
+    "parameter-store",
+    "env",
+    "config",
+    "dotenv",
+    "systems-manager"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@aws-sdk/client-ssm": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.4.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}