@geekmidas/cli 1.0.2 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/cli",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "CLI tools for building Lambda handlers, server applications, and generating OpenAPI specs",
   "private": false,
   "type": "module",
@@ -56,8 +56,8 @@
     "@geekmidas/constructs": "~1.0.0",
     "@geekmidas/envkit": "~1.0.0",
     "@geekmidas/errors": "~1.0.0",
-    "@geekmidas/logger": "~1.0.0",
-    "@geekmidas/schema": "~1.0.0"
+    "@geekmidas/schema": "~1.0.0",
+    "@geekmidas/logger": "~1.0.0"
   },
   "devDependencies": {
     "@types/lodash.kebabcase": "^4.1.9",
@@ -67,7 +67,7 @@
     "typescript": "^5.8.2",
     "vitest": "^3.2.4",
     "zod": "~4.1.13",
-    "@geekmidas/testkit": "1.0.0"
+    "@geekmidas/testkit": "1.0.1"
   },
   "peerDependencies": {
     "@geekmidas/telescope": "~1.0.0"

package/src/deploy/SSMStateProvider.ts

@@ -12,6 +12,7 @@ import {
 	ParameterNotFound,
 	PutParameterCommand,
 	SSMClient,
+	type SSMClientConfig,
 } from '@aws-sdk/client-ssm';
 import type { AwsRegion, StateProvider } from './StateProvider';
 import type { DokployStageState } from './state';
@@ -19,8 +20,12 @@ import type { DokployStageState } from './state';
 export interface SSMStateProviderOptions {
 	/** Workspace name (used in parameter path) */
 	workspaceName: string;
-	/** AWS region (required) */
-	region: AwsRegion;
+	/** AWS region */
+	region?: AwsRegion;
+	/** AWS credentials (optional - uses default credential chain if not provided) */
+	credentials?: SSMClientConfig['credentials'];
+	/** Custom endpoint (for LocalStack or other S3-compatible services) */
+	endpoint?: string;
 }
 
 /**
@@ -30,14 +35,22 @@ export interface SSMStateProviderOptions {
  * Parameter path: /gkm/{workspaceName}/{stage}/state
  */
 export class SSMStateProvider implements StateProvider {
-	private readonly client: SSMClient;
-	private readonly workspaceName: string;
+	constructor(
+		readonly workspaceName: string,
+		private readonly client: SSMClient,
+	) {}
 
-	constructor(options: SSMStateProviderOptions) {
-		this.workspaceName = options.workspaceName;
-		this.client = new SSMClient({
+	/**
+	 * Create an SSMStateProvider with a new SSMClient.
+	 */
+	static create(options: SSMStateProviderOptions): SSMStateProvider {
+		const client = new SSMClient({
 			region: options.region,
+			credentials: options.credentials,
+			endpoint: options.endpoint,
 		});
+
+		return new SSMStateProvider(options.workspaceName, client);
 	}
 
 	/**

package/src/deploy/StateProvider.ts

@@ -158,7 +158,7 @@ export async function createStateProvider(
 		const { CachedStateProvider } = await import('./CachedStateProvider');
 
 		const local = new LocalStateProvider(workspaceRoot);
-		const ssm = new SSMStateProvider({
+		const ssm = SSMStateProvider.create({
 			workspaceName,
 			region: (config as SSMStateConfig).region,
 		});

package/src/deploy/__tests__/CachedStateProvider.spec.ts

@@ -36,6 +36,7 @@ describe('CachedStateProvider', () => {
 			const state: DokployStageState = {
 				provider: 'dokploy',
 				stage: 'production',
+				projectId: 'proj_test',
 				environmentId: 'env_123',
 				applications: { api: 'local_app' },
 				services: {},
@@ -58,6 +59,7 @@ describe('CachedStateProvider', () => {
 			const state: DokployStageState = {
 				provider: 'dokploy',
 				stage: 'production',
+				projectId: 'proj_test',
 				environmentId: 'env_123',
 				applications: { api: 'remote_app' },
 				services: {},
@@ -96,6 +98,7 @@ describe('CachedStateProvider', () => {
 			const state: DokployStageState = {
 				provider: 'dokploy',
 				stage: 'production',
+				projectId: 'proj_test',
 				environmentId: 'env_123',
 				applications: { api: 'app_123' },
 				services: {},
@@ -120,6 +123,7 @@ describe('CachedStateProvider', () => {
 			const remoteState: DokployStageState = {
 				provider: 'dokploy',
 				stage: 'production',
+				projectId: 'proj_test',
 				environmentId: 'env_123',
 				applications: { api: 'remote_app' },
 				services: {},
@@ -155,6 +159,7 @@ describe('CachedStateProvider', () => {
 			const localState: DokployStageState = {
 				provider: 'dokploy',
 				stage: 'production',
+				projectId: 'proj_test',
 				environmentId: 'env_123',
 				applications: { api: 'local_app' },
 				services: {},
@@ -190,6 +195,7 @@ describe('CachedStateProvider', () => {
 			const localState: DokployStageState = {
 				provider: 'dokploy',
 				stage: 'production',
+				projectId: 'proj_test',
 				environmentId: 'env_123',
 				applications: { api: 'local_app' },
 				services: {},
@@ -198,6 +204,7 @@ describe('CachedStateProvider', () => {
 			const remoteState: DokployStageState = {
 				provider: 'dokploy',
 				stage: 'production',
+				projectId: 'proj_test',
 				environmentId: 'env_123',
 				applications: { api: 'remote_app' },
 				services: {},

package/src/deploy/__tests__/LocalStateProvider.spec.ts

@@ -29,6 +29,7 @@ describe('LocalStateProvider', () => {
 			const stateData: DokployStageState = {
 				provider: 'dokploy',
 				stage: 'production',
+				projectId: 'proj_test',
 				environmentId: 'env_123',
 				applications: { api: 'app_123' },
 				services: { postgresId: 'pg_123' },
@@ -62,6 +63,7 @@ describe('LocalStateProvider', () => {
 			const state: DokployStageState = {
 				provider: 'dokploy',
 				stage: 'staging',
+				projectId: 'proj_test',
 				environmentId: 'env_456',
 				applications: {},
 				services: {},
@@ -81,6 +83,7 @@ describe('LocalStateProvider', () => {
 			const state: DokployStageState = {
 				provider: 'dokploy',
 				stage: 'staging',
+				projectId: 'proj_test',
 				environmentId: 'env_456',
 				applications: {},
 				services: {},
@@ -98,6 +101,7 @@ describe('LocalStateProvider', () => {
 			const state: DokployStageState = {
 				provider: 'dokploy',
 				stage: 'production',
+				projectId: 'proj_test',
 				environmentId: 'env_123',
 				applications: { api: 'app_123', web: 'app_456' },
 				services: { postgresId: 'pg_123', redisId: 'redis_123' },

package/src/deploy/__tests__/SSMStateProvider.spec.ts

@@ -44,14 +44,8 @@ describe('SSMStateProvider', () => {
 			},
 		});
 
-		provider = new SSMStateProvider({
-			workspaceName,
-			region: 'us-east-1',
-		});
-
-		// Override the client's endpoint for localstack
-		// @ts-expect-error - accessing private property for testing
-		provider.client = client;
+		// Create provider with injected client
+		provider = new SSMStateProvider(workspaceName, client);
 	});
 
 	afterEach(async () => {
@@ -70,6 +64,19 @@ describe('SSMStateProvider', () => {
 		client.destroy();
 	});
 
+	describe('static create', () => {
+		it('should create provider with options', () => {
+			const provider = SSMStateProvider.create({
+				workspaceName: 'my-workspace',
+				region: 'us-west-2',
+				endpoint: LOCALSTACK_ENDPOINT,
+			});
+
+			expect(provider).toBeInstanceOf(SSMStateProvider);
+			expect(provider.workspaceName).toBe('my-workspace');
+		});
+	});
+
 	describe('read', () => {
 		it('should return null when parameter does not exist', async () => {
 			const state = await provider.read('nonexistent-stage');
@@ -80,6 +87,7 @@ describe('SSMStateProvider', () => {
 			const stateData: DokployStageState = {
 				provider: 'dokploy',
 				stage: testStage,
+				projectId: 'proj_test',
 				environmentId: 'env_123',
 				applications: { api: 'app_123' },
 				services: { postgresId: 'pg_123' },
@@ -105,6 +113,7 @@ describe('SSMStateProvider', () => {
 			const state: DokployStageState = {
 				provider: 'dokploy',
 				stage: testStage,
+				projectId: 'proj_test',
 				environmentId: 'env_123',
 				applications: { api: 'app_123' },
 				services: {},
@@ -128,6 +137,7 @@ describe('SSMStateProvider', () => {
 			const state1: DokployStageState = {
 				provider: 'dokploy',
 				stage: testStage,
+				projectId: 'proj_test',
 				environmentId: 'env_123',
 				applications: { api: 'app_old' },
 				services: {},
@@ -137,6 +147,7 @@ describe('SSMStateProvider', () => {
 			const state2: DokployStageState = {
 				provider: 'dokploy',
 				stage: testStage,
+				projectId: 'proj_test',
 				environmentId: 'env_123',
 				applications: { api: 'app_new' },
 				services: {},
@@ -161,6 +172,7 @@ describe('SSMStateProvider', () => {
 			const state: DokployStageState = {
 				provider: 'dokploy',
 				stage: testStage,
+				projectId: 'proj_test',
 				environmentId: 'env_123',
 				applications: {},
 				services: {},

package/src/deploy/__tests__/dns-verification.spec.ts

@@ -44,7 +44,7 @@ describe('verifyDnsRecords', () => {
 
 	beforeEach(() => {
 		vi.clearAllMocks();
-		state = createEmptyState('production', 'env-123');
+		state = createEmptyState('production', 'proj_test', 'env-123');
 		console.log = vi.fn();
 	});
 

package/src/deploy/__tests__/env-resolver.spec.ts

@@ -53,7 +53,7 @@ describe('generateSecret', () => {
 describe('getOrGenerateSecret', () => {
 	it('should return existing secret if already stored', () => {
 		const state: DokployStageState = {
-			...createEmptyState('production', 'env-123'),
+			...createEmptyState('production', 'proj_test', 'env-123'),
 			generatedSecrets: {
 				api: { BETTER_AUTH_SECRET: 'existing-secret-123' },
 			},
@@ -64,7 +64,7 @@ describe('getOrGenerateSecret', () => {
 	});
 
 	it('should generate and store new secret if not exists', () => {
-		const state = createEmptyState('production', 'env-123');
+		const state = createEmptyState('production', 'proj_test', 'env-123');
 
 		const result = getOrGenerateSecret(state, 'api', 'BETTER_AUTH_SECRET');
 
@@ -73,7 +73,7 @@ describe('getOrGenerateSecret', () => {
 	});
 
 	it('should generate different secrets for different apps', () => {
-		const state = createEmptyState('production', 'env-123');
+		const state = createEmptyState('production', 'proj_test', 'env-123');
 
 		const apiSecret = getOrGenerateSecret(state, 'api', 'BETTER_AUTH_SECRET');
 		const authSecret = getOrGenerateSecret(state, 'auth', 'BETTER_AUTH_SECRET');
@@ -84,7 +84,7 @@ describe('getOrGenerateSecret', () => {
 	});
 
 	it('should generate different secrets for different secret names', () => {
-		const state = createEmptyState('production', 'env-123');
+		const state = createEmptyState('production', 'proj_test', 'env-123');
 
 		const secret1 = getOrGenerateSecret(state, 'api', 'SECRET_ONE');
 		const secret2 = getOrGenerateSecret(state, 'api', 'SECRET_TWO');
@@ -93,7 +93,7 @@ describe('getOrGenerateSecret', () => {
 	});
 
 	it('should return same secret on subsequent calls', () => {
-		const state = createEmptyState('production', 'env-123');
+		const state = createEmptyState('production', 'proj_test', 'env-123');
 
 		const first = getOrGenerateSecret(state, 'api', 'BETTER_AUTH_SECRET');
 		const second = getOrGenerateSecret(state, 'api', 'BETTER_AUTH_SECRET');
@@ -181,7 +181,7 @@ describe('resolveEnvVar', () => {
 		app: createApp(),
 		appName: 'api',
 		stage: 'production',
-		state: createEmptyState('production', 'env-123'),
+		state: createEmptyState('production', 'proj_test', 'env-123'),
 		appHostname: 'api.example.com',
 		frontendUrls: [],
 		...overrides,
@@ -253,7 +253,7 @@ describe('resolveEnvVar', () => {
 	});
 
 	it('should resolve BETTER_AUTH_SECRET by generating and storing secret', () => {
-		const state = createEmptyState('production', 'env-123');
+		const state = createEmptyState('production', 'proj_test', 'env-123');
 		const context = createContext({ state, appName: 'auth' });
 
 		const secret = resolveEnvVar('BETTER_AUTH_SECRET', context);
@@ -362,7 +362,7 @@ describe('resolveEnvVars', () => {
 		},
 		appName: 'api',
 		stage: 'production',
-		state: createEmptyState('production', 'env-123'),
+		state: createEmptyState('production', 'proj_test', 'env-123'),
 		appHostname: 'api.example.com',
 		frontendUrls: ['https://web.example.com'],
 		...overrides,
@@ -449,7 +449,7 @@ describe('validateEnvVars', () => {
 		},
 		appName: 'api',
 		stage: 'production',
-		state: createEmptyState('production', 'env-123'),
+		state: createEmptyState('production', 'proj_test', 'env-123'),
 		appHostname: 'api.example.com',
 		frontendUrls: [],
 		...overrides,