@aetherionfw/core 1.1.0 → 1.1.1

package/README.md

@@ -0,0 +1,46 @@
+# @aetherionfw/core
+
+> Core decorators, metadata registry, and runtime for the Aetherion Serverless Framework.
+
+Aetherion is a modern, TypeScript-first serverless framework designed to bring the developer experience of frameworks like NestJS to AWS serverless architectures using CDKTF.
+
+## Overview
+
+This package provides the core building blocks for your Aetherion applications:
+
+- **Decorators**: `@LambdaController`, `@Route`, `@Infra`, `@Module`, `@Injectable`
+- **Metadata Registry**: Centralized reflection metadata storage that bridges the gap between your application code and your infrastructure definition.
+- **Dependency Injection**: A lightweight, fast injector for managing services and dependencies.
+- **Adapters**: The runtime adapter that translates API Gateway events into your controller methods.
+
+## Installation
+
+```bash
+npm install @aetherionfw/core
+```
+
+## Usage
+
+```typescript
+import { LambdaController, Route, Handle } from '@aetherionfw/core';
+
+@LambdaController({
+  lambdaName: 'users-api',
+  apiGateway: 'main-api'
+})
+export class UserController {
+  @Handle()
+  @Route({ method: 'GET', path: '/users' })
+  async getUsers() {
+    return { users: [] };
+  }
+}
+```
+
+## Documentation
+
+For full documentation, visit [https://github.com/CrisD3v/Aetherion-framework](https://github.com/CrisD3v/Aetherion-framework).
+
+## License
+
+MIT

package/dist/config/defineConfig.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Aetherion deployment environment configuration.
+ */
+export interface AetherionConfig {
+    /**
+     * AWS account ID where the infrastructure will be deployed.
+     * Can be hardcoded or read from an environment variable:
+     * @example accountId: process.env.AWS_ACCOUNT_ID!
+     */
+    accountId: string;
+    /**
+     * AWS region for deployment.
+     * @example region: 'us-east-1'
+     */
+    region: string;
+    /**
+     * AWS CLI profile name to use for local credentials.
+     * Maps to the profile in `~/.aws/credentials`.
+     * When deploying from CI/CD, leave undefined and use IAM roles or env vars instead.
+     * @example profile: 'my-dev-profile'
+     */
+    profile?: string;
+}
+/**
+ * Define the Aetherion deployment configuration.
+ * This function provides full type-safety and IDE autocompletion.
+ *
+ * @example
+ * ```typescript
+ * // aetherion.config.ts
+ * import { defineConfig } from '@aetherionfw/core';
+ *
+ * export default defineConfig({
+ *   accountId: process.env.AWS_ACCOUNT_ID!,
+ *   region: process.env.AWS_REGION ?? 'us-east-1',
+ *   profile: process.env.AWS_PROFILE ?? 'default',
+ * });
+ * ```
+ */
+export declare function defineConfig(config: AetherionConfig): AetherionConfig;

package/dist/config/defineConfig.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineConfig = defineConfig;
+/**
+ * Define the Aetherion deployment configuration.
+ * This function provides full type-safety and IDE autocompletion.
+ *
+ * @example
+ * ```typescript
+ * // aetherion.config.ts
+ * import { defineConfig } from '@aetherionfw/core';
+ *
+ * export default defineConfig({
+ *   accountId: process.env.AWS_ACCOUNT_ID!,
+ *   region: process.env.AWS_REGION ?? 'us-east-1',
+ *   profile: process.env.AWS_PROFILE ?? 'default',
+ * });
+ * ```
+ */
+function defineConfig(config) {
+    return config;
+}

package/dist/index.d.ts

@@ -8,3 +8,4 @@ export * from './decorators/use-middlewares.decorator';
 export * from './di/Injector';
 export * from './adapter/interfaces';
 export * from './adapter/lambda-adapter';
+export * from './config/defineConfig';

package/dist/index.js

@@ -24,3 +24,4 @@ __exportStar(require("./decorators/use-middlewares.decorator"), exports);
 __exportStar(require("./di/Injector"), exports);
 __exportStar(require("./adapter/interfaces"), exports);
 __exportStar(require("./adapter/lambda-adapter"), exports);
+__exportStar(require("./config/defineConfig"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aetherionfw/core",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Core decorators and runtime for Aetherion Framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,6 +21,11 @@
   ],
   "author": "CrisD3v",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/CrisD3v/Aetherion-framework.git",
+    "directory": "packages/core"
+  },
   "scripts": {
     "build": "tsc",
     "clean": "rm -rf dist"