@empire-builder-kit/containers 0.0.1-alpha.4 → 0.0.1-alpha.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Empire Builder Kit Contributors
+
+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/dist/generators/service/files-go/infra/service.ts.template

@@ -0,0 +1,59 @@
+export interface Register<%= className %>ServiceArgs {
+  cluster: sst.aws.Cluster;
+  domain?: string | { name: string };
+  environment?: Record<string, string>;
+  link?: any[];
+  publicLoadBalancer?: boolean;
+}
+
+// Go service runs a static binary — no node/curl in the runtime image,
+// so the Docker HEALTHCHECK is omitted here and the load balancer's
+// target-group health check on `/health` gates traffic instead. Add a
+// HEALTHCHECK back in Dockerfile + pass `health` here explicitly if you
+// need task-level health visibility in ECS.
+export function register<%= className %>Service({
+  cluster,
+  domain,
+  environment = {},
+  link = [],
+  publicLoadBalancer = false,
+}: Register<%= className %>ServiceArgs) {
+  const service = new sst.aws.Service('<%= projectName %>', {
+    cluster,
+    image: {
+      context: './apps/service/<%= name %>',
+      dockerfile: 'Dockerfile',
+    },
+    dev: {
+      command: 'pnpm nx run <%= projectName %>:dev',
+      directory: '../../..',
+      url: 'http://127.0.0.1:3000',
+    },
+    environment: {
+      PORT: '3000',
+      SERVICE_NAME: '<%= className %>Service',
+      SERVICE_VERSION: '0.0.1',
+      ...environment,
+    },
+    link,
+    logging: {
+      retention: '1 month',
+    },
+    serviceRegistry: {
+      port: 3000,
+    },
+    loadBalancer: {
+      public: publicLoadBalancer,
+      ...(domain ? { domain } : {}),
+      rules: [{ listen: '80/http', forward: '3000/http' }],
+      health: {
+        '3000/http': {
+          path: '/health',
+          successCodes: '200-399',
+        },
+      },
+    },
+  });
+
+  return { service };
+}

package/dist/generators/service/files-python/infra/service.ts.template

@@ -0,0 +1,68 @@
+export interface Register<%= className %>ServiceArgs {
+  cluster: sst.aws.Cluster;
+  domain?: string | { name: string };
+  environment?: Record<string, string>;
+  link?: any[];
+  publicLoadBalancer?: boolean;
+}
+
+// Python service uses `python -c` for the Docker HEALTHCHECK — the
+// runtime image already has python + stdlib `urllib.request`, so no
+// extra system package is needed. The load balancer's target-group
+// health check on `/health` still gates traffic independently.
+export function register<%= className %>Service({
+  cluster,
+  domain,
+  environment = {},
+  link = [],
+  publicLoadBalancer = false,
+}: Register<%= className %>ServiceArgs) {
+  const service = new sst.aws.Service('<%= projectName %>', {
+    cluster,
+    image: {
+      context: './apps/service/<%= name %>',
+      dockerfile: 'Dockerfile',
+    },
+    dev: {
+      command: 'pnpm nx run <%= projectName %>:dev',
+      directory: '../../..',
+      url: 'http://127.0.0.1:3000',
+    },
+    environment: {
+      PORT: '3000',
+      SERVICE_NAME: '<%= className %>Service',
+      SERVICE_VERSION: '0.0.1',
+      ...environment,
+    },
+    health: {
+      command: [
+        'CMD-SHELL',
+        'python -c "import urllib.request,sys;sys.exit(0 if urllib.request.urlopen(\'http://127.0.0.1:3000/health\',timeout=2).status<400 else 1)"',
+      ],
+      interval: '30 seconds',
+      timeout: '5 seconds',
+      retries: 3,
+      startPeriod: '10 seconds',
+    },
+    link,
+    logging: {
+      retention: '1 month',
+    },
+    serviceRegistry: {
+      port: 3000,
+    },
+    loadBalancer: {
+      public: publicLoadBalancer,
+      ...(domain ? { domain } : {}),
+      rules: [{ listen: '80/http', forward: '3000/http' }],
+      health: {
+        '3000/http': {
+          path: '/health',
+          successCodes: '200-399',
+        },
+      },
+    },
+  });
+
+  return { service };
+}

package/dist/generators/service/files-rust/infra/service.ts.template

@@ -0,0 +1,59 @@
+export interface Register<%= className %>ServiceArgs {
+  cluster: sst.aws.Cluster;
+  domain?: string | { name: string };
+  environment?: Record<string, string>;
+  link?: any[];
+  publicLoadBalancer?: boolean;
+}
+
+// Rust service runs a native binary inside debian-slim — no node/curl in
+// the runtime image, so the Docker HEALTHCHECK is omitted here and the
+// load balancer's target-group health check on `/health` gates traffic
+// instead. Add a HEALTHCHECK back in Dockerfile + pass `health` here
+// explicitly if you need task-level health visibility in ECS.
+export function register<%= className %>Service({
+  cluster,
+  domain,
+  environment = {},
+  link = [],
+  publicLoadBalancer = false,
+}: Register<%= className %>ServiceArgs) {
+  const service = new sst.aws.Service('<%= projectName %>', {
+    cluster,
+    image: {
+      context: './apps/service/<%= name %>',
+      dockerfile: 'Dockerfile',
+    },
+    dev: {
+      command: 'pnpm nx run <%= projectName %>:dev',
+      directory: '../../..',
+      url: 'http://127.0.0.1:3000',
+    },
+    environment: {
+      PORT: '3000',
+      SERVICE_NAME: '<%= className %>Service',
+      SERVICE_VERSION: '0.0.1',
+      ...environment,
+    },
+    link,
+    logging: {
+      retention: '1 month',
+    },
+    serviceRegistry: {
+      port: 3000,
+    },
+    loadBalancer: {
+      public: publicLoadBalancer,
+      ...(domain ? { domain } : {}),
+      rules: [{ listen: '80/http', forward: '3000/http' }],
+      health: {
+        '3000/http': {
+          path: '/health',
+          successCodes: '200-399',
+        },
+      },
+    },
+  });
+
+  return { service };
+}

package/dist/generators/service/files-typescript/src/main.ts.template

@@ -31,7 +31,7 @@ const server = createServer((request, response) => {
   const ctx = createRequestContext({
     app: '<%= app %>',
     operation: `${method} ${url}`,
-    stage: process.env.SST_STAGE ?? process.env.EBK_STAGE ?? 'dev',
+    stage: process.env.SST_STAGE ?? process.env.EBK_STAGE ?? 'development',
   });
 
   logger.info('request received', {

package/dist/generators/task/files-go/infra/task.ts.template

@@ -0,0 +1,38 @@
+export interface Register<%= className %>TaskArgs {
+  cluster: sst.aws.Cluster;
+  environment?: Record<string, string>;
+  link?: any[];
+}
+
+// ECS task (not a long-running service) — runs once per trigger, no health
+// endpoint required. Runtime-agnostic SST wrapper; the Dockerfile decides
+// whether the workload is Rust, Go, Python, or Node.
+export function register<%= className %>Task({
+  cluster,
+  environment = {},
+  link = [],
+}: Register<%= className %>TaskArgs) {
+  const task = new sst.aws.Task('<%= projectName %>', {
+    cluster,
+    image: {
+      context: './apps/task/<%= name %>',
+      dockerfile: 'Dockerfile',
+    },
+    dev: {
+      command: 'pnpm nx run <%= projectName %>:dev',
+      directory: '../../..',
+    },
+    environment: {
+      TASK_NAME: '<%= className %>Task',
+      TASK_VERSION: '0.0.1',
+      TASK_TRIGGER: 'manual',
+      ...environment,
+    },
+    link,
+    logging: {
+      retention: '1 month',
+    },
+  });
+
+  return { task };
+}

package/dist/generators/task/files-python/infra/task.ts.template

@@ -0,0 +1,38 @@
+export interface Register<%= className %>TaskArgs {
+  cluster: sst.aws.Cluster;
+  environment?: Record<string, string>;
+  link?: any[];
+}
+
+// ECS task (not a long-running service) — runs once per trigger, no health
+// endpoint required. Runtime-agnostic SST wrapper; the Dockerfile decides
+// whether the workload is Rust, Go, Python, or Node.
+export function register<%= className %>Task({
+  cluster,
+  environment = {},
+  link = [],
+}: Register<%= className %>TaskArgs) {
+  const task = new sst.aws.Task('<%= projectName %>', {
+    cluster,
+    image: {
+      context: './apps/task/<%= name %>',
+      dockerfile: 'Dockerfile',
+    },
+    dev: {
+      command: 'pnpm nx run <%= projectName %>:dev',
+      directory: '../../..',
+    },
+    environment: {
+      TASK_NAME: '<%= className %>Task',
+      TASK_VERSION: '0.0.1',
+      TASK_TRIGGER: 'manual',
+      ...environment,
+    },
+    link,
+    logging: {
+      retention: '1 month',
+    },
+  });
+
+  return { task };
+}

package/dist/generators/task/files-rust/infra/task.ts.template

@@ -0,0 +1,38 @@
+export interface Register<%= className %>TaskArgs {
+  cluster: sst.aws.Cluster;
+  environment?: Record<string, string>;
+  link?: any[];
+}
+
+// ECS task (not a long-running service) — runs once per trigger, no health
+// endpoint required. Runtime-agnostic SST wrapper; the Dockerfile decides
+// whether the workload is Rust, Go, Python, or Node.
+export function register<%= className %>Task({
+  cluster,
+  environment = {},
+  link = [],
+}: Register<%= className %>TaskArgs) {
+  const task = new sst.aws.Task('<%= projectName %>', {
+    cluster,
+    image: {
+      context: './apps/task/<%= name %>',
+      dockerfile: 'Dockerfile',
+    },
+    dev: {
+      command: 'pnpm nx run <%= projectName %>:dev',
+      directory: '../../..',
+    },
+    environment: {
+      TASK_NAME: '<%= className %>Task',
+      TASK_VERSION: '0.0.1',
+      TASK_TRIGGER: 'manual',
+      ...environment,
+    },
+    link,
+    logging: {
+      retention: '1 month',
+    },
+  });
+
+  return { task };
+}

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@empire-builder-kit/containers",
-  "version": "0.0.1-alpha.4",
+  "version": "0.0.1-alpha.5",
+  "license": "MIT",
   "publishConfig": {
     "access": "public",
-    "provenance": true
+    "provenance": false
   },
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -89,4 +90,4 @@
     "url": "https://github.com/LukasGuptaLeary/empire-builder-kit/issues"
   },
   "homepage": "https://github.com/LukasGuptaLeary/empire-builder-kit#readme"
-}
+}