@worktif/runtime 0.3.0-edge.0

package/out/dist/bin/templates/runtime-web/purenow-basic/README.md

@@ -0,0 +1,118 @@
+# {{projectName}}
+
+A serverless web application powered by [Purenow](https://github.com/worktif/purenow).
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js >= 18.0.0
+- AWS CLI configured with credentials
+- Yarn or npm
+
+### Installation
+
+Install dependencies:
+
+```bash
+npm install
+# or
+yarn install
+```
+
+### Development
+
+Start the local development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+```
+
+The application will be available at `http://localhost:3000`.
+
+### Building
+
+Build all targets (React, Lambda, CDK):
+
+```bash
+npm run build
+# or
+yarn build
+```
+
+### Deployment
+
+Deploy to AWS:
+
+```bash
+# Deploy to dev stage (default)
+npm run deploy:dev
+
+# Deploy to staging
+npm run deploy:staging
+
+# Deploy to production
+npm run deploy:prod
+```
+
+### Environment Diagnostics
+
+Check your development environment and project configuration:
+
+```bash
+npm run doctor
+# or
+yarn doctor
+```
+
+### Project Information
+
+Display version and configuration information:
+
+```bash
+npm run info
+# or
+yarn info
+```
+
+## Project Structure
+
+```
+.
+├── src/
+│   ├── index.tsx          # Application entry point
+│   ├── App.tsx            # Root component
+│   ├── routes.tsx         # Route configuration
+│   └── pages/             # Page components
+│       ├── HomePage.tsx
+│       └── AboutPage.tsx
+├── public/
+│   └── index.html         # HTML template
+├── purenow.config.ts      # Purenow configuration
+├── tsconfig.json          # TypeScript configuration
+└── package.json           # Project dependencies
+
+```
+
+## Configuration
+
+Edit `purenow.config.ts` to customize:
+
+- Project name
+- Deployment stages (dev, staging, prod)
+- AWS regions and profiles
+- Custom domains
+- Feature flags (SEO, manifest, warmup)
+
+## Learn More
+
+- [Purenow Documentation](https://github.com/worktif/purenow)
+- [React Router v7](https://reactrouter.com/)
+- [AWS Lambda](https://aws.amazon.com/lambda/)
+- [AWS CDK](https://aws.amazon.com/cdk/)
+
+## License
+
+Elastic License 2.0

package/out/dist/bin/templates/runtime-web/purenow-basic/gitignore.template

@@ -0,0 +1,64 @@
+# Purenow build outputs
+out/
+dist/
+build/
+.logs/
+.serverless/
+
+# AWS CDK
+cdk.out/
+cdk.context.json
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Dependencies
+node_modules/
+.pnp
+.pnp.js
+
+# Testing
+coverage/
+.nyc_output/
+
+# Production
+/build
+
+# Misc
+.DS_Store
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# TypeScript
+*.tsbuildinfo
+.tsbuildinfo
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+Thumbs.db
+.Spotlight-V100
+.Trashes
+
+# Temporary files
+.tmp/
+tmp/
+temp/
+
+# Cache
+.cache/
+.parcel-cache/
+.eslintcache
+.stylelintcache

package/out/dist/bin/templates/runtime-web/purenow-basic/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Serverless web runtime powered by Purenow",
+  "scripts": {
+    "dev": "purenow dev",
+    "build": "purenow build",
+    "deploy": "purenow deploy",
+    "deploy:dev": "purenow deploy --stage dev",
+    "deploy:staging": "purenow deploy --stage staging",
+    "deploy:prod": "purenow deploy --stage prod",
+    "doctor": "purenow doctor",
+    "info": "purenow info"
+  },
+  "dependencies": {
+    "@worktif/purenow": "^0.3.0-edge.0",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
+    "react-router": "^7.7.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.29",
+    "@types/react": "^19.1.6",
+    "@types/react-dom": "^19.1.6",
+    "typescript": "^5.8.2",
+    "tsx": "^4.21.0",
+    "aws-cdk-lib": "^2.172.0",
+    "constructs": "^10.4.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/out/dist/bin/templates/runtime-web/purenow-basic/purenow.config.ts

@@ -0,0 +1,105 @@
+/*
+ * Elastic License 2.0
+ * Copyright (C) 2025–present Raman Marozau, Work Target Insight Function. All rights reserved.
+ * Contact: raman@worktif.com
+ *
+ * This file is part of the Licensed Work: worktif.purenow.cdk <worktif_purenow_cdk>.
+ * Use of this software is governed by the Elastic License 2.0; see the LICENSE file
+ * or https://www.elastic.co/licensing/elastic-license for details.
+ *
+ * Re-licensing notice:
+ *   This file was previously distributed under the Business Source License 1.1 (BUSL-1.1).
+ *   As of 2025-09-22, it is re-licensed under Elastic License 2.0.
+ *
+ * SPDX-License-Identifier: Elastic-2.0
+ */
+
+import { PurenowCliConfig } from '@worktif/purenow';
+
+/**
+ * Purenow CLI Configuration
+ *
+ * This file defines the configuration for your Purenow application,
+ * including deployment stages, paths, and feature flags.
+ */
+const config: PurenowCliConfig = {
+  /**
+   * Project name used for AWS resource naming
+   */
+  projectName: '{{PROJECT_NAME}}',
+
+  /**
+   * Deployment stages configuration
+   * Each stage can have its own AWS region, profile, and domain settings
+   * Note: Region is resolved from AWS SDK default provider chain (env vars, ~/.aws/config)
+   * The awsRegion value here is used as a fallback if no region is configured
+   */
+  stages: [
+    {
+      name: 'dev',
+      awsRegion: '{{REGION}}', // Fallback region if not configured in AWS
+      awsProfile: 'default', // Optional: AWS CLI profile name
+      // domain: 'example.com', // Optional: Custom domain
+      // subdomain: 'dev', // Optional: Subdomain prefix
+    },
+    {
+      name: 'staging',
+      awsRegion: 'us-east-1', // Fallback region if not configured in AWS
+      awsProfile: 'default',
+      // domain: 'example.com',
+      // subdomain: 'staging',
+    },
+    {
+      name: 'prod',
+      awsRegion: 'us-east-1', // Fallback region if not configured in AWS
+      awsProfile: 'default',
+      // domain: 'example.com',
+      // subdomain: 'www',
+    },
+  ],
+
+  /**
+   * Project paths configuration
+   */
+  paths: {
+    srcDir: 'src',
+    reactEntry: 'src/index.tsx',
+    outDir: 'out/dist',
+    cdkDir: 'cdk', // Optional: CDK infrastructure directory
+  },
+
+  /**
+   * Infrastructure mode
+   * - 'cdk': Use AWS CDK for infrastructure (recommended)
+   * - 'auto': Automatic infrastructure management
+   */
+  infraMode: 'cdk',
+
+  /**
+   * Optional feature flags
+   */
+  features: {
+    /**
+     * Enable SEO metadata storage in DynamoDB
+     */
+    enableSeo: false,
+
+    /**
+     * Enable web app manifest generation
+     */
+    enableManifest: true,
+
+    /**
+     * Enable Lambda warmup to reduce cold starts
+     */
+    enableWarmup: false,
+
+    /**
+     * A configuration setting that determines whether the cache should be cleared on deployment.
+     * When set to true, the cache will be cleared every time a deployment occurs.
+     */
+    clearCacheOnDeploy: true,
+  },
+};
+
+export default config;

package/out/dist/bin/templates/runtime-web/purenow-basic/src/app.tsx

@@ -0,0 +1,35 @@
+/*
+ * Elastic License 2.0
+ * Copyright (C) 2025–present Raman Marozau, Work Target Insight Function. All rights reserved.
+ * Contact: raman@worktif.com
+ *
+ * This file is part of the Licensed Work: worktif.purenow.cdk <worktif_purenow_cdk>.
+ * Use of this software is governed by the Elastic License 2.0; see the LICENSE file
+ * or https://www.elastic.co/licensing/elastic-license for details.
+ *
+ * Re-licensing notice:
+ *   This file was previously distributed under the Business Source License 1.1 (BUSL-1.1).
+ *   As of 2025-09-22, it is re-licensed under Elastic License 2.0.
+ *
+ * SPDX-License-Identifier: Elastic-2.0
+ */
+
+import * as React from 'react';
+import { PurenowRouterProvider } from '@worktif/purenow';
+
+interface AppProps {
+  router: any;
+}
+
+/**
+ * Root application component that wraps the router provider
+ */
+const App: React.FC<AppProps> = ({ router }) => {
+  return (
+    <div className="app">
+      <PurenowRouterProvider router={router}/>
+    </div>
+  );
+};
+
+export default App;

package/out/dist/bin/templates/runtime-web/purenow-basic/src/handlers/users/index.ts

@@ -0,0 +1,17 @@
+/*
+ * Elastic License 2.0
+ * Copyright (C) 2025–present Raman Marozau, Work Target Insight Function. All rights reserved.
+ * Contact: raman@worktif.com
+ *
+ * This file is part of the Licensed Work: React Serverless <react-serverless>.
+ * Use of this software is governed by the Elastic License 2.0; see the LICENSE file
+ * or https://www.elastic.co/licensing/elastic-license for details.
+ *
+ * Re-licensing notice:
+ *   This file was previously distributed under the Business Source License 1.1 (BUSL-1.1).
+ *   As of 2025-09-15, it is re-licensed under Elastic License 2.0.
+ *
+ * SPDX-License-Identifier: Elastic-2.0
+ */
+
+export * from './users.handlers';

package/out/dist/bin/templates/runtime-web/purenow-basic/src/handlers/users/users.handlers.ts

@@ -0,0 +1,222 @@
+/*
+ * Elastic License 2.0
+ * Copyright (C) 2025–present Raman Marozau, Work Target Insight Function. All rights reserved.
+ * Contact: raman@worktif.com
+ *
+ * This file is part of the Licensed Work: worktif.purenow.cdk <worktif_purenow_cdk>.
+ * Use of this software is governed by the Elastic License 2.0; see the LICENSE file
+ * or https://www.elastic.co/licensing/elastic-license for details.
+ *
+ * SPDX-License-Identifier: Elastic-2.0
+ */
+
+import { LambdaDefinition } from '@worktif/purenow';
+
+import { UsersService } from '../../services/users.service';
+
+
+/**
+ * Create User Handler
+ *
+ * Creates a new user via POST /api/users
+ *
+ * Request body:
+ * ```json
+ * {
+ *   "email": "user@example.com",
+ *   "name": "John Doe",
+ *   "password": "securepassword123"
+ * }
+ * ```
+ */
+export const createUserHandler: LambdaDefinition = {
+  id: 'create',
+  ties: [UsersService],
+  handler: (deps) => async (event: any, context: any) => {
+    try {
+      const body = JSON.parse(event.body || '{}');
+      const { email, name, password } = body;
+
+      if (!email || !name || !password) {
+        return {
+          statusCode: 400,
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ error: 'Email, name, and password are required' }),
+        };
+      }
+
+      const user = await (deps as { usersService: UsersService }).usersService.createUser({ email, name, password });
+
+      return {
+        statusCode: 201,
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(user),
+      };
+    } catch (error) {
+      return {
+        statusCode: 500,
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          error: 'User creation failed',
+          message: error instanceof Error ? error.message : 'Unknown error',
+        }),
+      };
+    }
+  },
+  http: {
+    method: 'POST',
+    path: '/api/users',
+    auth: 'none',
+    cors: true,
+  },
+};
+
+/**
+ * Get User Handler
+ *
+ * Retrieves a user by ID via GET /api/users/{id}
+ */
+export const getUserHandler: LambdaDefinition = {
+  id: 'get',
+  ties: [UsersService],
+  handler: (deps) => async (event: any, context: any) => {
+    try {
+      const userId = event.pathParameters?.id;
+
+      if (!userId) {
+        return {
+          statusCode: 400,
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ error: 'User ID is required' }),
+        };
+      }
+
+      const user = await (deps as { usersService: UsersService }).usersService.getUser(userId);
+
+      if (!user) {
+        return {
+          statusCode: 404,
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ error: 'User not found' }),
+        };
+      }
+
+      return {
+        statusCode: 200,
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(user),
+      };
+    } catch (error) {
+      return {
+        statusCode: 500,
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          error: 'Failed to retrieve user',
+          message: error instanceof Error ? error.message : 'Unknown error',
+        }),
+      };
+    }
+  },
+  http: {
+    method: 'GET',
+    path: '/api/users/{id}',
+    auth: 'jwt',
+    cors: true,
+  },
+};
+
+/**
+ * Update User Handler
+ *
+ * Updates a user via PUT /api/users/{id}
+ */
+export const updateUserHandler: LambdaDefinition = {
+  id: 'update',
+  ties: [UsersService],
+  handler: (deps) => async (event: any, context: any) => {
+    try {
+      const userId = event.pathParameters?.id;
+      const body = JSON.parse(event.body || '{}');
+
+      if (!userId) {
+        return {
+          statusCode: 400,
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ error: 'User ID is required' }),
+        };
+      }
+
+      const user = await (deps as { usersService: UsersService }).usersService.updateUser(userId, body);
+
+      return {
+        statusCode: 200,
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(user),
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'Unknown error';
+      const statusCode = message === 'User not found' ? 404 : 500;
+
+      return {
+        statusCode,
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          error: statusCode === 404 ? 'User not found' : 'Failed to update user',
+          message,
+        }),
+      };
+    }
+  },
+  http: {
+    method: 'PUT',
+    path: '/api/users/{id}',
+    auth: 'jwt',
+    cors: true,
+  },
+};
+
+/**
+ * Delete User Handler
+ *
+ * Deletes a user via DELETE /api/users/{id}
+ */
+export const deleteUserHandler: LambdaDefinition = {
+  id: 'delete',
+  ties: [UsersService],
+  handler: (deps) => async (event: any, context: any) => {
+    try {
+      const userId = event.pathParameters?.id;
+
+      if (!userId) {
+        return {
+          statusCode: 400,
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ error: 'User ID is required' }),
+        };
+      }
+
+      await (deps as { usersService: UsersService }).usersService.deleteUser(userId);
+
+      return {
+        statusCode: 204,
+        headers: { 'Content-Type': 'application/json' },
+        body: '',
+      };
+    } catch (error) {
+      return {
+        statusCode: 500,
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          error: 'Failed to delete user',
+          message: error instanceof Error ? error.message : 'Unknown error',
+        }),
+      };
+    }
+  },
+  http: {
+    method: 'DELETE',
+    path: '/api/users/{id}',
+    auth: 'jwt',
+    cors: true,
+  },
+};

package/out/dist/bin/templates/runtime-web/purenow-basic/src/index.tsx

@@ -0,0 +1,71 @@
+/*
+ * Elastic License 2.0
+ * Copyright (C) 2025–present Raman Marozau, Work Target Insight Function. All rights reserved.
+ * Contact: raman@worktif.com
+ *
+ * This file is part of the Licensed Work: worktif.purenow.cdk <worktif_purenow_cdk>.
+ * Use of this software is governed by the Elastic License 2.0; see the LICENSE file
+ * or https://www.elastic.co/licensing/elastic-license for details.
+ *
+ * SPDX-License-Identifier: Elastic-2.0
+ */
+
+/**
+ * Runtime Web Core Example Application
+ *
+ * This is the main entry point for the example application.
+ * It demonstrates how to configure and use the Runtime Web Core layer.
+ */
+
+import * as React from 'react';
+import { ErrorBoundary, pureweb, purenowRouter, Stage } from '@worktif/purenow';
+
+// Import Ties classes
+import { UsersTies } from './ties';
+
+// Import Lambda handlers
+import { createUserHandler, deleteUserHandler, getUserHandler, updateUserHandler } from './handlers/users';
+
+import App from './App';
+
+// Router
+import { routes } from './routes';
+
+
+/**
+ * Start the application
+ *
+ * The purenow() function automatically detects the execution context:
+ * - Browser: Hydrates React app with client-side routing
+ * - Lambda: Executes handlers with DI injection
+ * - CDK: Synthesizes CloudFormation templates
+ */
+pureweb({
+  // React application factory
+  app: ({ router }: any) => <App router={router}/>,
+
+  // Router instance
+  // @ts-ignore
+  router: purenowRouter({
+    router: routes,
+    defaults: {
+      HydrateFallback: () => <div>Loading...</div>,
+      errorBoundary: <ErrorBoundary>asd</ErrorBoundary>,
+    },
+  }),
+
+  // Service name (used for AWS resource naming)
+  serviceName: 'runtime-web-example',
+
+  // Deployment stage
+  stage: 'dev' as Stage,
+
+  // Microservice registry
+  register: {
+    // Users microservice
+    users: {
+      ties: [UsersTies],
+      lambdas: [createUserHandler, getUserHandler, updateUserHandler, deleteUserHandler],
+    },
+  },
+});