@venizia/ignis 0.3.3 → 0.3.5

package/dist/vulcan-preset/app/files/.configs/builders/Dockerfile

@@ -0,0 +1,64 @@
+# {{app}}: a compiled IGNIS binary on Alpine. Build from the project root:
+#   docker build -f {{appPath}}/.configs/builders/Dockerfile -t {{app}} \
+#     --build-arg APP_BUILD_COMMIT="$(git rev-parse HEAD)" \
+#     --build-arg APP_BUILD_BRANCH="$(git rev-parse --abbrev-ref HEAD)" .
+# The whole project is the build context (trimmed by the root .dockerignore), because the preset
+# cannot know which workspace packages the app imports. List them by hand for better layer caching.
+
+FROM docker.io/oven/bun:1.4.3-alpine AS base
+
+# A private npm mirror, if the build has no access to the public registry.
+ARG BUN_CONFIG_REGISTRY=
+ENV BUN_CONFIG_REGISTRY=${BUN_CONFIG_REGISTRY}
+
+WORKDIR /home/bun/project
+RUN chown bun:bun /home/bun/project
+USER bun
+
+# -------------------------------------------------------------------------------
+# Build stage: install the workspace, compile the app to dist/bin
+# -------------------------------------------------------------------------------
+FROM base AS builder
+
+# The image has no .git, so the build stamp reads the commit and the branch from these. A build
+# without the commit stops here: an image must always say which commit it runs.
+ARG APP_BUILD_COMMIT=
+ARG APP_BUILD_BRANCH=
+ARG APP_BUILD_VERSION=
+RUN test -n "$APP_BUILD_COMMIT" || { echo "Pass --build-arg APP_BUILD_COMMIT=\$(git rev-parse HEAD)" >&2; exit 1; }
+
+COPY --chown=bun . .
+# A .env in the context puts its secrets in the layer above: refuse the build and name the files.
+RUN leaked="$(find . -name '.env*' ! -name '.env.example' -not -path '*/node_modules/*')"; \
+    if [ -n "$leaked" ]; then \
+      echo "Secrets in the build context: $leaked - add **/.env and **/.env.* to the root .dockerignore" >&2; \
+      exit 1; \
+    fi
+RUN bun install --frozen-lockfile --ignore-scripts
+
+WORKDIR /home/bun/project/{{appPath}}
+# Alpine is musl: the binary targets bun-linux-<arch>-musl, for the architecture the image builds on.
+RUN BUN_TARGET="bun-linux-$([ "$(uname -m)" = aarch64 ] && echo arm64 || echo x64)-musl" bun run compile
+
+# -------------------------------------------------------------------------------
+# Production stage: the binary alone
+# -------------------------------------------------------------------------------
+FROM docker.io/alpine:3.21 AS production
+
+ARG APP_BUILD_COMMIT=
+LABEL org.opencontainers.image.revision="${APP_BUILD_COMMIT}"
+
+# A Bun binary links libstdc++ and libgcc dynamically on musl.
+COPY --from=builder /usr/lib/libstdc++.so.6* /usr/lib/
+COPY --from=builder /usr/lib/libgcc_s.so.1* /usr/lib/
+RUN addgroup -S app && adduser -S app -G app
+
+WORKDIR /home/app
+USER app
+
+COPY --from=builder --chown=app /home/bun/project/{{appPath}}/dist/bin ./bin
+
+ENV HOST=0.0.0.0 PORT={{devPort}}
+EXPOSE {{devPort}}
+
+CMD ["./bin"]

package/dist/vulcan-preset/app/files/.configs/builders/compile.ts

@@ -0,0 +1,10 @@
+import { BunCompiler } from '@venizia/dev-configs/compilers';
+import { IgnisArtifactsPlugin } from '@venizia/ignis-boot/bun';
+import { BuildInfoStamp } from '@venizia/ignis-boot/build-info';
+
+await BunCompiler.compile({
+  entrypoint: './src/index.ts',
+  outfile: './dist/bin',
+  plugins: [IgnisArtifactsPlugin.create()],
+  define: await BuildInfoStamp.define(),
+});

package/dist/vulcan-preset/{files → app/files}/src/application.ts

@@ -1,5 +1,7 @@
 import { ApiReferenceComponent, BaseApplication, type IApplicationInfo } from '@venizia/ignis';
 import AutoArtifacts from '@venizia/ignis-boot/auto';
+import { LoggerFactory } from '@venizia/ignis-helpers';
+import { WinstonLogger } from '@venizia/ignis-helpers/winston';
 import packageJson from '../package.json';
 
 export class Application extends BaseApplication {
@@ -22,6 +24,10 @@ export class Application extends BaseApplication {
   setupMiddlewares() {}
 }
 
+// A compiled binary cannot load the default provider at run time; only a class reference carries it into the bundle.
+// It is registered before the application below is built, because building it already logs.
+LoggerFactory.use({ provider: WinstonLogger });
+
 export const application = new Application({
   scope: 'Application',
   config: {

package/dist/vulcan-preset/{files → app/files}/src/index.ts

@@ -1,6 +1,8 @@
+import { BuildInfoStamp } from '@venizia/ignis-boot/build-info';
 import { application } from '#src/application';
 
 const main = async () => {
+  await BuildInfoStamp.register();
   application.init();
   await application.start();
 };

package/dist/vulcan-preset/app/files/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json.schemastore.org/tsconfig",
+  "extends": "@venizia/dev-configs/tsconfig.common.json",
+  "compilerOptions": {
+    "module": "preserve",
+    "moduleResolution": "bundler",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "useDefineForClassFields": false
+  },
+  "include": [
+    "src",
+    ".configs/builders"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}

package/dist/vulcan-preset/{preset.json → app/preset.json}

@@ -14,9 +14,9 @@
   "dependencies": {
     "@hono/zod-openapi": "^1.6.3",
     "@scalar/hono-api-reference": "^0.11.16",
-    "@venizia/ignis": "0.3.3",
-    "@venizia/ignis-boot": "0.3.3",
-    "@venizia/ignis-helpers": "0.3.3",
+    "@venizia/ignis": "0.3.5",
+    "@venizia/ignis-boot": "0.3.4",
+    "@venizia/ignis-helpers": "0.3.4",
     "hono": "^4.13.7",
     "winston": "^3.19.0",
     "winston-daily-rotate-file": "^5.0.0",
@@ -24,7 +24,7 @@
   },
   "devDependencies": {
     "@types/bun": "^1.4.1",
-    "@venizia/dev-configs": "0.3.3",
+    "@venizia/dev-configs": "0.3.4",
     "eslint": "^10.10.0",
     "oxfmt": "0.73.0",
     "oxlint": "1.88.0",
@@ -33,13 +33,13 @@
   },
   "peers": {},
   "scripts": {
-    "dev": "NODE_ENV=development bun run src/index.ts",
-    "start": "NODE_ENV=production bun run dist/index.js",
-    "build": "tsc -p tsconfig.json",
+    "server:dev": "NODE_ENV=development bun run src/index.ts",
+    "compile": "bun .configs/builders/compile.ts",
     "typecheck": "bun check",
-    "lint": "sh scripts/lint.sh",
-    "lint:fix": "sh scripts/lint.sh --fix",
-    "test": "bun test"
+    "lint": "devz lint",
+    "lint:fix": "devz lint --fix",
+    "test": "bun test",
+    "clean": "devz clean"
   },
   "checks": [
     "typecheck",

package/dist/vulcan-preset/lib/files/.configs/formatters/oxfmt.config.mts

@@ -0,0 +1,4 @@
+import { defineConfig } from 'oxfmt';
+import { oxfmtConfigs } from '@venizia/dev-configs/formatters';
+
+export default defineConfig(oxfmtConfigs);

package/dist/vulcan-preset/lib/files/.configs/lints/eslint.config.mjs

@@ -0,0 +1,4 @@
+import { houseConfigs } from '@venizia/dev-configs/linters';
+
+// oxlint (oxlint.config.mts) runs every other rule; ESLint runs the naming convention and the house rules.
+export default houseConfigs;

package/dist/vulcan-preset/lib/files/.configs/lints/oxlint.config.mts

@@ -0,0 +1,4 @@
+import { defineConfig } from 'oxlint';
+import { oxlintConfigs } from '@venizia/dev-configs/linters/oxlint';
+
+export default defineConfig(oxlintConfigs);

package/dist/vulcan-preset/lib/files/src/index.ts

@@ -0,0 +1 @@
+export * from '#src/services/greeting.service';

package/dist/vulcan-preset/lib/files/src/services/greeting.service.test.ts

@@ -0,0 +1,8 @@
+import { describe, expect, test } from 'bun:test';
+import { GreetingService } from '#src/services/greeting.service';
+
+describe('GreetingService', () => {
+  test('greets by name', () => {
+    expect(new GreetingService().greet({ name: 'IGNIS' })).toBe('Hello, IGNIS!');
+  });
+});

package/dist/vulcan-preset/lib/files/src/services/greeting.service.ts

@@ -0,0 +1,12 @@
+import { BaseService } from '@venizia/ignis';
+
+// A backend app binds it like its own services: `this.service(GreetingService)` in its application.
+export class GreetingService extends BaseService {
+  constructor() {
+    super({ scope: GreetingService.name });
+  }
+
+  greet(opts: { name: string }): string {
+    return `Hello, ${opts.name}!`;
+  }
+}

package/dist/vulcan-preset/{files → lib/files}/tsconfig.json

@@ -2,8 +2,8 @@
   "$schema": "http://json.schemastore.org/tsconfig",
   "extends": "@venizia/dev-configs/tsconfig.common.json",
   "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": "src",
+    "module": "preserve",
+    "moduleResolution": "bundler",
     "experimentalDecorators": true,
     "emitDecoratorMetadata": true,
     "useDefineForClassFields": false

package/dist/vulcan-preset/lib/preset.json

@@ -0,0 +1,45 @@
+{
+  "presetVersion": 1,
+  "summary": "A shared IGNIS library: services other backend apps import (exports to src, #src imports).",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/bun": "^1.4.1",
+    "@venizia/dev-configs": "0.3.4",
+    "@venizia/ignis": "0.3.5",
+    "eslint": "^10.10.0",
+    "oxfmt": "0.73.0",
+    "oxlint": "1.88.0",
+    "oxlint-tsgolint": "7.0.2004",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "@venizia/ignis": "0.3.5"
+  },
+  "scripts": {
+    "typecheck": "bun check",
+    "lint": "devz lint",
+    "lint:fix": "devz lint --fix",
+    "test": "bun test",
+    "clean": "devz clean"
+  },
+  "checks": [
+    "typecheck",
+    "lint",
+    "test"
+  ],
+  "imports": {
+    "#src/*.json": "./src/*.json",
+    "#src/*": "./src/*.js"
+  },
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "files": "./files",
+  "atlas": [
+    {
+      "name": "ignis",
+      "repo": "VENIZIA-AI/ignis",
+      "ref": "develop"
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venizia/ignis",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "High-performance TypeScript server infrastructure combining LoopBack 4 enterprise architecture (decorator-based DI, repository pattern, component system) with Hono speed (~140k req/s). Features auto-generated OpenAPI docs, Drizzle ORM type-safe SQL, JWT/Basic authentication, Casbin authorization, convention-based bootstrapping, and pluggable components for health checks, Swagger UI, mail, Socket.IO, and static assets. Built for Bun and Node.js.",
   "keywords": [
     "access-control",
@@ -191,18 +191,19 @@
   },
   "sideEffects": false,
   "vulcan": {
-    "preset": "./dist/vulcan-preset/preset.json"
+    "preset": "./dist/vulcan-preset/app/preset.json",
+    "lib": "./dist/vulcan-preset/lib/preset.json"
   },
   "scripts": {
     "force-update": "sh ./scripts/force-update.sh",
     "prepublishOnly": "make rebuild"
   },
   "dependencies": {
-    "@venizia/ignis-connectors": "0.3.3",
-    "@venizia/ignis-filter": "0.3.3",
-    "@venizia/ignis-helpers": "0.3.3",
-    "@venizia/ignis-inversion": "0.3.4",
-    "@venizia/ignis-kernel": "0.3.3",
+    "@venizia/ignis-connectors": "0.3.4",
+    "@venizia/ignis-filter": "0.3.4",
+    "@venizia/ignis-helpers": "0.3.4",
+    "@venizia/ignis-inversion": "0.3.5",
+    "@venizia/ignis-kernel": "0.3.4",
     "reflect-metadata": "^0.2.2"
   },
   "peerDependencies": {
@@ -306,8 +307,8 @@
     "@types/bun": "^1.4.1",
     "@types/nodemailer": "^8.0.1",
     "@types/pg": "^8.23.1",
-    "@venizia/dev-configs": "0.3.3",
-    "@venizia/ignis-boot": "0.3.3",
+    "@venizia/dev-configs": "0.3.4",
+    "@venizia/ignis-boot": "0.3.4",
     "casbin": "^5.51.1",
     "eslint": "^10.10.0",
     "meilisearch": "^0.60.0",

package/dist/vulcan-preset/files/README.md

@@ -1,5 +0,0 @@
-# {{app}}
-
-The {{app}} backend of {{project}}, built on IGNIS.
-
-`bun run dev` serves `http://localhost:{{devPort}}/api/hello`.

package/dist/vulcan-preset/files/scripts/lint.sh

@@ -1,17 +0,0 @@
-#!/usr/bin/env sh
-# Lint this app with oxlint, eslint and oxfmt. `sh scripts/lint.sh` checks; `--fix` fixes.
-set -eu
-cd "$(dirname "$0")/.."
-
-FILES='**/*.{ts,tsx,mts,js,mjs}'
-ESLINT_CACHE='--cache --cache-location node_modules/.cache/eslint/'
-
-if [ "${1:-}" = "--fix" ]; then
-  oxlint -c .configs/oxlint.config.mts --fix
-  eslint -c .configs/eslint.config.mjs $ESLINT_CACHE --fix .
-  oxfmt -c .configs/oxfmt.config.mts "$FILES"
-else
-  oxlint -c .configs/oxlint.config.mts --deny-warnings
-  eslint -c .configs/eslint.config.mjs $ESLINT_CACHE .
-  oxfmt -c .configs/oxfmt.config.mts --check "$FILES"
-fi