@intentius/chant-lexicon-aws 0.1.1 → 0.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-aws",
-  "version": "0.1.1",
+  "version": "0.1.8",
   "description": "AWS CloudFormation lexicon for chant — declarative IaC in TypeScript",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -36,18 +36,18 @@
     "./types": "./dist/types/index.d.ts"
   },
   "scripts": {
-    "generate": "bun run src/codegen/generate-cli.ts",
-    "bundle": "bun run src/package-cli.ts",
-    "validate": "bun run src/validate-cli.ts",
-    "docs": "bun run src/codegen/docs-cli.ts",
-    "prepack": "bun run generate && bun run bundle && bun run validate"
+    "generate": "tsx src/codegen/generate-cli.ts",
+    "bundle": "tsx src/package-cli.ts",
+    "validate": "tsx src/validate-cli.ts",
+    "docs": "tsx src/codegen/docs-cli.ts",
+    "prepack": "npm run generate && npm run bundle && npm run validate"
   },
   "dependencies": {
     "fflate": "^0.8.2",
     "js-yaml": "^4.1.0"
   },
   "devDependencies": {
-    "@intentius/chant": "0.1.1",
+    "@intentius/chant": "*",
     "typescript": "^5.9.3"
   },
   "peerDependencies": {

package/src/actions/actions.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { S3Actions } from "./s3";
 import { LambdaActions } from "./lambda";
 import { DynamoDBActions } from "./dynamodb";

package/src/codegen/__snapshots__/snapshot.test.ts.snap

@@ -1,6 +1,24 @@
-// Bun Snapshot v1, https://bun.sh/docs/test/snapshots
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
 
-exports[`snapshot tests Bucket lexicon entry 1`] = `
+exports[`snapshot tests > Bucket .d.ts class declaration 1`] = `
+"export declare class Bucket {
+  constructor(props: {
+    /** A name for the bucket. */
+    BucketName: string;
+    /** The Amazon Resource Name (ARN) of the bucket. */
+    Arn?: string;
+    /** Specifies default encryption for a bucket. */
+    BucketEncryption?: Bucket_BucketEncryption;
+    /** An arbitrary set of tags (key-value pairs) for this S3 bucket. */
+    Tags?: Bucket_Tag[];
+    /** Enables multiple versions of all objects in this bucket. */
+    VersioningConfiguration?: Bucket_VersioningConfiguration;
+  }, attributes?: CFResourceAttributes);
+  readonly Arn: string;
+}"
+`;
+
+exports[`snapshot tests > Bucket lexicon entry 1`] = `
 {
   "attrs": {
     "Arn": "Arn",
@@ -24,7 +42,29 @@ exports[`snapshot tests Bucket lexicon entry 1`] = `
 }
 `;
 
-exports[`snapshot tests Function lexicon entry 1`] = `
+exports[`snapshot tests > Function .d.ts class declaration 1`] = `
+"export declare class Function {
+  constructor(props: {
+    /** The code for the function. */
+    Code: Function_Code;
+    /** The ARN of the function's execution role. */
+    Role: string;
+    /** The ARN of the function. */
+    Arn?: string;
+    /** The name of the Lambda function. */
+    FunctionName?: string;
+    /** The name of the method within your code that Lambda calls to run your function. */
+    Handler?: string;
+    /** The amount of memory available to the function at runtime. */
+    MemorySize?: number;
+    /** The identifier of the function's runtime. */
+    Runtime?: "java17" | "java21" | "nodejs18.x" | "nodejs20.x" | "python3.11" | "python3.12";
+  }, attributes?: CFResourceAttributes);
+  readonly Arn: string;
+}"
+`;
+
+exports[`snapshot tests > Function lexicon entry 1`] = `
 {
   "attrs": {
     "Arn": "Arn",
@@ -76,7 +116,7 @@ exports[`snapshot tests Function lexicon entry 1`] = `
 }
 `;
 
-exports[`snapshot tests Role lexicon entry 1`] = `
+exports[`snapshot tests > Role lexicon entry 1`] = `
 {
   "attrs": {
     "Arn": "Arn",
@@ -98,7 +138,7 @@ exports[`snapshot tests Role lexicon entry 1`] = `
 }
 `;
 
-exports[`snapshot tests generated resource names 1`] = `
+exports[`snapshot tests > generated resource names 1`] = `
 [
   "Api",
   "Api_Auth",
@@ -155,43 +195,3 @@ exports[`snapshot tests generated resource names 1`] = `
   "VpcConfig",
 ]
 `;
-
-exports[`snapshot tests Bucket .d.ts class declaration 1`] = `
-"export declare class Bucket {
-  constructor(props: {
-    /** A name for the bucket. */
-    BucketName: string;
-    /** The Amazon Resource Name (ARN) of the bucket. */
-    Arn?: string;
-    /** Specifies default encryption for a bucket. */
-    BucketEncryption?: Bucket_BucketEncryption;
-    /** An arbitrary set of tags (key-value pairs) for this S3 bucket. */
-    Tags?: Bucket_Tag[];
-    /** Enables multiple versions of all objects in this bucket. */
-    VersioningConfiguration?: Bucket_VersioningConfiguration;
-  }, attributes?: CFResourceAttributes);
-  readonly Arn: string;
-}"
-`;
-
-exports[`snapshot tests Function .d.ts class declaration 1`] = `
-"export declare class Function {
-  constructor(props: {
-    /** The code for the function. */
-    Code: Function_Code;
-    /** The ARN of the function's execution role. */
-    Role: string;
-    /** The ARN of the function. */
-    Arn?: string;
-    /** The name of the Lambda function. */
-    FunctionName?: string;
-    /** The name of the method within your code that Lambda calls to run your function. */
-    Handler?: string;
-    /** The amount of memory available to the function at runtime. */
-    MemorySize?: number;
-    /** The identifier of the function's runtime. */
-    Runtime?: "java17" | "java21" | "nodejs18.x" | "nodejs20.x" | "python3.11" | "python3.12";
-  }, attributes?: CFResourceAttributes);
-  readonly Arn: string;
-}"
-`;

package/src/codegen/docs-links.test.ts

@@ -1,9 +1,9 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { existsSync, readdirSync, readFileSync } from "fs";
 import { join, basename } from "path";
 
-const docsDir = join(import.meta.dir, "..", "..", "docs", "src", "content", "docs");
-const docsSource = join(import.meta.dir, "docs.ts");
+const docsDir = join(import.meta.dirname, "..", "..", "docs", "src", "content", "docs");
+const docsSource = join(import.meta.dirname, "docs.ts");
 const docsExist = existsSync(docsDir);
 
 /**

package/src/codegen/docs.ts

@@ -488,12 +488,16 @@ When you need to split resources into a separate CloudFormation template, the le
         title: "Nested Stacks",
         sidebar: false,
         description: "Splitting resources into child CloudFormation templates with automatic cross-stack reference wiring",
-        content: `CloudFormation nested stacks (\`AWS::CloudFormation::Stack\`) let you decompose large templates into smaller, reusable child templates. The AWS lexicon's \`nestedStack()\` function references a **child project directory** — a subdirectory that builds independently to a valid CloudFormation template.
+        content: `import Diagram from '../../components/Diagram.astro';
+
+CloudFormation nested stacks (\`AWS::CloudFormation::Stack\`) let you decompose large templates into smaller, reusable child templates. The AWS lexicon's \`nestedStack()\` function references a **child project directory** — a subdirectory that builds independently to a valid CloudFormation template.
 
 :::caution[Consider alternatives first]
-Nested stacks add deployment complexity: child templates must be uploaded to S3, rollbacks are all-or-nothing at the parent level, drift detection doesn't recurse into children, and debugging failures requires drilling into child stack events. For most projects, [flat composites](../composites/) are simpler. Nested stacks are supported for specific cases — exceeding CloudFormation's 500-resource limit or packaging reusable infrastructure as a black box — but are not the recommended default.
+Nested stacks add deployment complexity: child templates must be uploaded to S3, rollbacks are all-or-nothing at the parent level, drift detection doesn't recurse into children, and debugging failures requires drilling into child stack events. For splitting a large project into separately-deployed pieces, prefer [Multi-Stack Projects](/chant/guide/multi-stack/) — each \`src/\` subdirectory becomes an independent stack with no parent orchestration and no S3 upload step. Nested stacks are supported for specific cases — exceeding CloudFormation's 500-resource limit inside a single deployable unit, or packaging reusable infrastructure for other teams to deploy as a black box — but are not the recommended default.
 :::
 
+<Diagram name="nested-stacks" alt="Parent and child project source directories producing separate CloudFormation templates, both uploaded to S3" caption="Nested stack source layout and output" />
+
 ## Project structure
 
 A nested stack is a child project — a subdirectory with its own resource files and explicit \`stackOutput()\` declarations:
@@ -611,14 +615,15 @@ Three lint rules help catch common nested stack issues:
 
 ## When to use nested stacks
 
-**Prefer flat composites** for most projects. Composites expand into a single template, deploy atomically, and are simpler to debug.
+Most splitting use cases are better served by other mechanisms:
 
-**Use nested stacks only when:**
-- Your template exceeds CloudFormation's 500-resource limit
-- You're packaging reusable infrastructure for other teams to deploy as a black box
-- You need independent update/rollback boundaries (rare — this usually means the resources should be separate stacks entirely)
+- **Splitting a large project into separately-deployed pieces** → [Multi-Stack Projects](/chant/guide/multi-stack/). Organize \`src/\` into subdirectories — each becomes an independent stack, deployed on its own, with cross-stack references resolved via standard CloudFormation \`Export\`/\`ImportValue\`. No parent template, no S3 upload of children, no \`TemplateBasePath\` parameter.
+- **Reusing resource patterns within a single template** → [Composites](../composites/). Composites expand into the same template and deploy atomically — they're about DRY, not splitting.
 
-See [Composites](../composites/) for the flat composite approach.`,
+**Use nested stacks only when:**
+- A single deployable unit exceeds CloudFormation's 500-resource limit
+- You're packaging reusable infrastructure for other teams to consume as a black box (the parent-child relationship is load-bearing)
+- You need an orchestrator parent that coordinates child lifecycles via CloudFormation Parameters and Outputs specifically`,
       },
       {
         slug: "lint-rules",
@@ -902,10 +907,10 @@ The \`plugins\` array accepts relative paths. Each plugin module should export a
 
 \`\`\`bash
 cd examples/lambda-function
-bun install
+npm install
 chant build    # produces CloudFormation JSON
 chant lint     # runs lint rules
-bun test       # runs the example's tests
+npx vitest run    # run the tests
 \`\`\`
 
 ## Lambda Function

package/src/codegen/generate-cli.ts

@@ -1,6 +1,6 @@
-#!/usr/bin/env bun
+#!/usr/bin/env tsx
 /**
- * Thin entry point for `bun run generate` in lexicon-aws.
+ * Thin entry point for `npm run generate` in lexicon-aws.
  */
 import { generate, writeGeneratedFiles } from "./generate";
 import { dirname } from "path";

package/src/codegen/generate.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { generate, writeGeneratedFiles } from "./generate";
 import { NamingStrategy } from "./naming";
 import { samResources } from "./sam";

package/src/codegen/idempotency.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { generate } from "./generate";
 import { loadSchemaFixtures } from "../testdata/load-fixtures";
 

package/src/codegen/package.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { packageLexicon } from "./package";
 import { validateManifest } from "@intentius/chant/lexicon-schema";
 

package/src/codegen/package.ts

@@ -3,9 +3,8 @@
  * with AWS-specific manifest building and skill collection.
  */
 
-import { createRequire } from "module";
 import { readFileSync } from "fs";
-const require = createRequire(import.meta.url);
+import { awsPlugin } from "../plugin";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 import type { IntrinsicDef } from "@intentius/chant/lexicon";
@@ -43,8 +42,6 @@ export async function packageLexicon(opts: PackageOptions = {}): Promise<Package
 
       buildManifest: (_genResult) => {
         // Lazy-import to avoid circular dependency
-        const { awsPlugin } = require("../plugin");
-
         const intrinsics: IntrinsicDef[] = (awsPlugin.intrinsics?.() ?? []).map(
           (i: { name: string; description: string }) => ({
             name: i.name,
@@ -73,9 +70,7 @@ export async function packageLexicon(opts: PackageOptions = {}): Promise<Package
 
       srcDir: pkgDir,
 
-      collectSkills: () => {
-        const { awsPlugin } = require("../plugin");
-        const skillDefs = awsPlugin.skills?.() ?? [];
+      collectSkills: () => {        const skillDefs = awsPlugin.skills?.() ?? [];
         return collectSkills(skillDefs);
       },
 

package/src/codegen/snapshot.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { generate } from "./generate";
 import { loadSchemaFixtures } from "../testdata/load-fixtures";
 

package/src/codegen/typecheck.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { typecheckDTS } from "./typecheck";
 
 describe("typecheckDTS", () => {

package/src/composites/composites.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect, beforeEach } from "bun:test";
+import { describe, test, expect, beforeEach } from "vitest";
 import { expandComposite, CompositeRegistry, isCompositeInstance } from "@intentius/chant";
 import { AttrRef } from "@intentius/chant/attrref";
 import { LambdaFunction, LambdaNode, LambdaPython, NodeLambda, PythonLambda } from "./lambda-function";
@@ -14,6 +14,8 @@ import { FargateAlb } from "./fargate-alb";
 import { AlbShared } from "./alb-shared";
 import { FargateService } from "./fargate-service";
 import { RdsInstance } from "./rds-instance";
+import { Ec2InstanceRole } from "./ec2-instance-role";
+import { MinimalVpc } from "./minimal-vpc";
 
 const baseProps = {
   name: "TestFunc",
@@ -865,3 +867,66 @@ describe("per-member defaults", () => {
     expect(funcPropsA.Timeout).toBe(funcPropsB.Timeout);
   });
 });
+
+describe("Ec2InstanceRole", () => {
+  test("returns role and instanceProfile members", () => {
+    const instance = Ec2InstanceRole({});
+    expect(instance.role).toBeDefined();
+    expect(instance.instanceProfile).toBeDefined();
+    expect(Object.keys(instance.members)).toEqual(["role", "instanceProfile"]);
+  });
+
+  test("role has EC2 trust policy", () => {
+    const instance = Ec2InstanceRole({});
+    const roleProps = (instance.role as any).props;
+    expect(roleProps.AssumeRolePolicyDocument.Statement[0].Principal.Service).toBe("ec2.amazonaws.com");
+  });
+
+  test("ManagedPolicyArns are passed through", () => {
+    const arn = "arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore";
+    const instance = Ec2InstanceRole({ ManagedPolicyArns: [arn] });
+    const roleProps = (instance.role as any).props;
+    expect(roleProps.ManagedPolicyArns).toContain(arn);
+  });
+
+  test("expandComposite produces 2 entries", () => {
+    const expanded = expandComposite("myRole", Ec2InstanceRole({}));
+    expect(expanded.size).toBe(2);
+    expect(expanded.has("myRoleRole")).toBe(true);
+    expect(expanded.has("myRoleInstanceProfile")).toBe(true);
+  });
+});
+
+describe("MinimalVpc", () => {
+  test("returns 8 members", () => {
+    const instance = MinimalVpc({});
+    expect(Object.keys(instance.members)).toEqual([
+      "vpc", "subnet", "igw", "igwAttachment", "routeTable", "defaultRoute", "subnetRta", "securityGroup",
+    ]);
+  });
+
+  test("subnet uses Select/GetAZs for AZ (not a plain string)", () => {
+    const instance = MinimalVpc({});
+    const subnetProps = (instance.subnet as any).props;
+    expect(typeof subnetProps.AvailabilityZone).not.toBe("string");
+  });
+
+  test("vpc cidr defaults to 10.0.0.0/24", () => {
+    const instance = MinimalVpc({});
+    const vpcProps = (instance.vpc as any).props;
+    expect(vpcProps.CidrBlock).toBe("10.0.0.0/24");
+  });
+
+  test("custom cidr is respected", () => {
+    const instance = MinimalVpc({ cidr: "192.168.0.0/16", subnetCidr: "192.168.1.0/24" });
+    const vpcProps = (instance.vpc as any).props;
+    const subnetProps = (instance.subnet as any).props;
+    expect(vpcProps.CidrBlock).toBe("192.168.0.0/16");
+    expect(subnetProps.CidrBlock).toBe("192.168.1.0/24");
+  });
+
+  test("expandComposite produces 8 entries", () => {
+    const expanded = expandComposite("net", MinimalVpc({}));
+    expect(expanded.size).toBe(8);
+  });
+});

package/src/composites/ec2-instance-role.ts

@@ -0,0 +1,39 @@
+import { Composite, mergeDefaults } from "@intentius/chant";
+import { Role, InstanceProfile } from "../generated";
+import { Ref } from "../intrinsics";
+
+export interface Ec2InstanceRoleProps {
+  ManagedPolicyArns?: string[];
+  Policies?: ConstructorParameters<typeof Role>[0]["Policies"];
+  defaults?: {
+    role?: Partial<ConstructorParameters<typeof Role>[0]>;
+    instanceProfile?: Partial<ConstructorParameters<typeof InstanceProfile>[0]>;
+  };
+}
+
+const EC2_ASSUME_ROLE = {
+  Version: "2012-10-17" as const,
+  Statement: [
+    {
+      Effect: "Allow" as const,
+      Principal: { Service: "ec2.amazonaws.com" },
+      Action: "sts:AssumeRole",
+    },
+  ],
+};
+
+export const Ec2InstanceRole = Composite<Ec2InstanceRoleProps>((props) => {
+  const { defaults } = props;
+
+  const role = new Role(mergeDefaults({
+    AssumeRolePolicyDocument: EC2_ASSUME_ROLE,
+    ManagedPolicyArns: props.ManagedPolicyArns ?? [],
+    Policies: props.Policies ?? [],
+  }, defaults?.role));
+
+  const instanceProfile = new InstanceProfile(mergeDefaults({
+    Roles: [Ref(role)],
+  }, defaults?.instanceProfile));
+
+  return { role, instanceProfile };
+}, "Ec2InstanceRole");

package/src/composites/fargate-service.ts

@@ -12,6 +12,7 @@ import {
   TaskDefinition_KeyValuePair,
   TaskDefinition_EFSVolumeConfiguration,
   TaskDefinition_Volume,
+  TaskDefinition_Ulimit,
   TargetGroup,
   ListenerRule,
   ListenerRule_Action,
@@ -74,6 +75,9 @@ export interface FargateServiceProps {
   privateSubnetIds: string[];
   healthCheckPath?: string;
 
+  // Ulimits (container-level)
+  ulimits?: Array<{ name: string; softLimit: number; hardLimit: number }>;
+
   // IAM
   ManagedPolicyArns?: string[];
   Policies?: InstanceType<typeof Role_Policy>[];
@@ -175,6 +179,11 @@ export const FargateService = Composite<FargateServiceProps>((props) => {
     Environment: environmentVars.length > 0 ? environmentVars : undefined,
     Command: props.command,
     MountPoints: allMountPoints.length > 0 ? allMountPoints : undefined,
+    Ulimits: props.ulimits?.map(u => new TaskDefinition_Ulimit({
+      Name: u.name,
+      SoftLimit: u.softLimit,
+      HardLimit: u.hardLimit,
+    })),
   });
 
   // Task definition

package/src/composites/index.ts

@@ -26,3 +26,9 @@ export { RdsInstance, RdsInstance as RdsPostgres } from "./rds-instance";
 export type { RdsInstanceProps, RdsInstanceProps as RdsPostgresProps } from "./rds-instance";
 export { EfsWithAccessPoint } from "./efs-with-access-point";
 export type { EfsWithAccessPointProps } from "./efs-with-access-point";
+export { SolrFargateService } from "./solr-fargate-service";
+export type { SolrFargateServiceProps } from "./solr-fargate-service";
+export { Ec2InstanceRole } from "./ec2-instance-role";
+export type { Ec2InstanceRoleProps } from "./ec2-instance-role";
+export { MinimalVpc } from "./minimal-vpc";
+export type { MinimalVpcProps } from "./minimal-vpc";

package/src/composites/lambda-function.ts

@@ -1,5 +1,6 @@
 import { Composite, withDefaults, mergeDefaults } from "@intentius/chant";
 import { Role, Function, Function_VpcConfig, Role_Policy } from "../generated";
+import { Sub } from "../intrinsics";
 
 const lambdaTrustPolicy = {
   Version: "2012-10-17" as const,
@@ -18,7 +19,7 @@ const VPC_ACCESS_ARN =
   "arn:aws:iam::aws:policy/service-role/AWSLambdaVPCAccessExecutionRole";
 
 export interface LambdaFunctionProps {
-  name: string;
+  name: string | ReturnType<typeof Sub>;
   Runtime: string;
   Handler: string;
   Code: ConstructorParameters<typeof Function>[0]["Code"];

package/src/composites/minimal-vpc.ts

@@ -0,0 +1,71 @@
+import { Composite, mergeDefaults } from "@intentius/chant";
+import {
+  Vpc,
+  Subnet,
+  InternetGateway,
+  VPCGatewayAttachment,
+  RouteTable,
+  EC2Route,
+  SubnetRouteTableAssociation,
+  SecurityGroup,
+} from "../generated";
+import { Select, GetAZs } from "../intrinsics";
+
+export interface MinimalVpcProps {
+  cidr?: string;
+  subnetCidr?: string;
+  defaults?: {
+    vpc?: Partial<ConstructorParameters<typeof Vpc>[0]>;
+    subnet?: Partial<ConstructorParameters<typeof Subnet>[0]>;
+    securityGroup?: Partial<ConstructorParameters<typeof SecurityGroup>[0]>;
+  };
+}
+
+export const MinimalVpc = Composite<MinimalVpcProps>((props) => {
+  const { defaults } = props;
+  const cidr = props.cidr ?? "10.0.0.0/24";
+  const subnetCidr = props.subnetCidr ?? "10.0.0.0/25";
+
+  const vpc = new Vpc(mergeDefaults({
+    CidrBlock: cidr,
+    EnableDnsHostnames: true,
+    EnableDnsSupport: true,
+  }, defaults?.vpc));
+
+  const subnet = new Subnet(mergeDefaults({
+    VpcId: vpc.VpcId,
+    CidrBlock: subnetCidr,
+    AvailabilityZone: Select(0, GetAZs("")),
+    MapPublicIpOnLaunch: true,
+  }, defaults?.subnet));
+
+  const igw = new InternetGateway({});
+
+  const igwAttachment = new VPCGatewayAttachment({
+    VpcId: vpc.VpcId,
+    InternetGatewayId: igw.InternetGatewayId,
+  });
+
+  const routeTable = new RouteTable({ VpcId: vpc.VpcId });
+
+  const defaultRoute = new EC2Route(
+    {
+      RouteTableId: routeTable.RouteTableId,
+      DestinationCidrBlock: "0.0.0.0/0",
+      GatewayId: igw.InternetGatewayId,
+    },
+    { DependsOn: [igwAttachment] },
+  );
+
+  const subnetRta = new SubnetRouteTableAssociation({
+    SubnetId: subnet.SubnetId,
+    RouteTableId: routeTable.RouteTableId,
+  });
+
+  const securityGroup = new SecurityGroup(mergeDefaults({
+    GroupDescription: "MinimalVpc default security group",
+    VpcId: vpc.VpcId,
+  }, defaults?.securityGroup));
+
+  return { vpc, subnet, igw, igwAttachment, routeTable, defaultRoute, subnetRta, securityGroup };
+}, "MinimalVpc");

package/src/composites/solr-fargate-service.ts

@@ -0,0 +1,42 @@
+import { Composite } from "@intentius/chant";
+import { FargateService, FargateServiceProps } from "./fargate-service";
+
+export interface SolrFargateServiceProps extends FargateServiceProps {
+  /**
+   * JVM heap size passed as SOLR_HEAP. Defaults to 45% of task memory.
+   * Examples: "1843m", "4g". Must not exceed 50% of task memory.
+   */
+  solrHeap?: string;
+  /**
+   * GC tuning string passed as GC_TUNE.
+   * Default: "-XX:+UseG1GC -XX:MaxGCPauseMillis=200"
+   */
+  gcOpts?: string;
+}
+
+export const SolrFargateService = Composite<SolrFargateServiceProps>((props) => {
+  const memoryMb = parseInt(props.memory ?? "4096");
+  const solrHeap = props.solrHeap ?? `${Math.floor(memoryMb * 0.45)}m`;
+  const gcOpts = props.gcOpts ?? "-XX:+UseG1GC -XX:MaxGCPauseMillis=200";
+
+  // Solr env defaults — user-supplied environment entries override these
+  const solrEnv: Record<string, string> = {
+    SOLR_HEAP: solrHeap,
+    GC_TUNE: gcOpts,
+    SOLR_OPTS: "-XX:-UseLargePages",
+    ...props.environment,
+  };
+
+  // Solr-specific ulimit default — user-supplied ulimits override
+  const solrUlimits = props.ulimits ?? [
+    { name: "nofile", softLimit: 65535, hardLimit: 65535 },
+  ];
+
+  return FargateService({
+    containerPort: 8983,
+    healthCheckPath: "/solr/admin/info/health",
+    ...props,
+    environment: solrEnv,
+    ulimits: solrUlimits,
+  });
+}, "SolrFargateService");

package/src/coverage.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { existsSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";

package/src/default-tags.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { DECLARABLE_MARKER } from "@intentius/chant/declarable";
 import { defaultTags, isDefaultTags, DEFAULT_TAGS_MARKER } from "./default-tags";