fix: SLS Framework types

Author: ServerlessLife

src/frameworks/slsFramework.ts

@@ -3,7 +3,7 @@ import * as path from 'path';
 import { EsBuildOptions, LambdaResource } from '../types/resourcesDiscovery.js';
 import { constants } from 'fs';
 import { findPackageJson } from '../utils/findPackageJson.js';
-import type Serverless from 'serverless';
+import type { Serverless } from './slsFrameworkTypes.js';
 import { IFramework } from './iFrameworks.js';
 import { LldConfigBase } from '../types/lldConfig.js';
 import { Logger } from '../logger.js';

src/frameworks/slsFrameworkTypes.ts

@@ -0,0 +1,54 @@
+/**
+ * Mock types for the Serverless Framework.
+ * Used when the 'serverless' package is not installed (e.g. optional/peer dependency).
+ * Mirrors @types/serverless shapes used by this project.
+ */
+
+/**
+ * Service instance shape (matches Service class in @types/serverless).
+ * This project only supports handler-based functions; functions is typed accordingly so no cast is needed.
+ */
+export interface ServerlessService {
+  custom: Record<string, any>;
+  plugins: string[];
+  functions?: Record<string, ServerlessFunctionDefinitionHandler>;
+}
+
+/**
+ * Base function definition (matches Serverless.FunctionDefinition in @types/serverless).
+ */
+export interface ServerlessFunctionDefinitionBase {
+  name?: string;
+  package?: Record<string, any>;
+  reservedConcurrency?: number;
+  runtime?: string;
+  timeout?: number;
+  memorySize?: number;
+  environment?: Record<string, string>;
+  events?: unknown[];
+  tags?: Record<string, string>;
+  [key: string]: any;
+}
+
+/**
+ * Handler-based function (matches Serverless.FunctionDefinitionHandler).
+ */
+export interface ServerlessFunctionDefinitionHandler extends ServerlessFunctionDefinitionBase {
+  handler: string;
+}
+
+/**
+ * Serverless instance (matches Serverless class in @types/serverless).
+ * The real class is loaded dynamically; this type describes the shape we use.
+ */
+export interface Serverless {
+  service: ServerlessService;
+  init(): Promise<void>;
+  run(): Promise<void>;
+}
+
+/** Namespace for Serverless.FunctionDefinitionHandler (used in slsFramework cast). */
+// eslint-disable-next-line @typescript-eslint/no-namespace -- needed for Serverless.FunctionDefinitionHandler with no slsFramework changes
+export namespace Serverless {
+  export type FunctionDefinitionHandler = ServerlessFunctionDefinitionHandler;
+}