@intentius/chant-lexicon-aws 0.6.0 → 0.8.0

package/dist/nested-stack.d.ts

@@ -0,0 +1,75 @@
+/**
+ * AWS NestedStack — references a child project directory that builds
+ * to an independent CloudFormation template. The parent emits
+ * AWS::CloudFormation::Stack pointing at the child template.
+ *
+ * Cross-stack references are explicit: the child declares `stackOutput()`
+ * exports, and the parent reads them via `nestedStack().outputs.name`.
+ */
+import { type ChildProjectInstance } from "@intentius/chant/child-project";
+import { INTRINSIC_MARKER } from "@intentius/chant/intrinsic";
+/**
+ * Marker symbol for nested stack identification.
+ */
+export declare const NESTED_STACK_MARKER: unique symbol;
+/**
+ * Options for configuring a nested stack.
+ */
+export interface NestedStackOptions {
+    /** Explicit CloudFormation Parameters to pass to the child stack */
+    parameters?: Record<string, unknown>;
+}
+/**
+ * A reference to an output from a nested stack.
+ * Serializes to `{ "Fn::GetAtt": [stackLogicalName, "Outputs.OutputName"] }`.
+ */
+export declare class NestedStackOutputRef {
+    readonly [INTRINSIC_MARKER]: true;
+    readonly stackName: string;
+    readonly outputName: string;
+    constructor(stackName: string, outputName: string);
+    toJSON(): {
+        "Fn::GetAtt": [string, string];
+    };
+}
+/**
+ * Type guard for NestedStackOutputRef.
+ */
+export declare function isNestedStackOutputRef(value: unknown): value is NestedStackOutputRef;
+/**
+ * Extended ChildProjectInstance with AWS-specific marker.
+ */
+export interface NestedStackInstance extends ChildProjectInstance {
+    readonly [NESTED_STACK_MARKER]: true;
+}
+/**
+ * Type guard for NestedStackInstance.
+ */
+export declare function isNestedStackInstance(value: unknown): value is NestedStackInstance;
+/**
+ * Create a nested stack that references a child project directory.
+ *
+ * The child directory must contain its own resource files.
+ * It can be built independently with `chant build`. Cross-stack outputs
+ * are declared in the child via `stackOutput()`.
+ *
+ * @param name - Logical name for the nested stack resource
+ * @param projectPath - Absolute path to the child project directory
+ * @param options - Optional parameters to pass to the child stack
+ * @returns A ChildProjectInstance with an `outputs` proxy for cross-stack refs
+ *
+ * @example
+ * ```ts
+ * const network = _.nestedStack("network", import.meta.dirname + "/network", {
+ *   parameters: { Environment: "prod" },
+ * });
+ *
+ * export const handler = new _.Function({
+ *   vpcConfig: {
+ *     subnetIds: [network.outputs.subnetId],  // cross-stack ref
+ *   },
+ * });
+ * ```
+ */
+export declare function nestedStack(name: string, projectPath: string, options?: NestedStackOptions): NestedStackInstance;
+//# sourceMappingURL=nested-stack.d.ts.map

package/dist/nested-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nested-stack.d.ts","sourceRoot":"","sources":["../src/nested-stack.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAAsC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,QAAQ,CAAC,CAAC,gBAAgB,CAAC,EAAG,IAAI,CAAU;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAKjD,MAAM,IAAI;QAAE,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;CAK7C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAEpF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D,QAAQ,CAAC,CAAC,mBAAmB,CAAC,EAAE,IAAI,CAAC;CACtC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAOlF;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,mBAAmB,CAsBrB"}

package/dist/package-cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env tsx
+export {};
+//# sourceMappingURL=package-cli.d.ts.map

package/dist/package-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-cli.d.ts","sourceRoot":"","sources":["../src/package-cli.ts"],"names":[],"mappings":""}

package/dist/parameter.d.ts

@@ -0,0 +1,14 @@
+import { DECLARABLE_MARKER, type CoreParameter } from "@intentius/chant/declarable";
+export declare class Parameter implements CoreParameter {
+    readonly [DECLARABLE_MARKER]: true;
+    readonly lexicon = "aws";
+    readonly entityType = "AWS::CloudFormation::Parameter";
+    readonly parameterType: string;
+    readonly description?: string;
+    readonly defaultValue?: unknown;
+    constructor(type: string, options?: {
+        description?: string;
+        defaultValue?: unknown;
+    });
+}
+//# sourceMappingURL=parameter.d.ts.map

package/dist/parameter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter.d.ts","sourceRoot":"","sources":["../src/parameter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEpF,qBAAa,SAAU,YAAW,aAAa;IAC7C,QAAQ,CAAC,CAAC,iBAAiB,CAAC,EAAG,IAAI,CAAU;IAC7C,QAAQ,CAAC,OAAO,SAAS;IACzB,QAAQ,CAAC,UAAU,oCAAoC;IACvD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;gBAEpB,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE;CAKrF"}

package/dist/plugin.d.ts

@@ -0,0 +1,9 @@
+import type { LexiconPlugin } from "@intentius/chant/lexicon";
+/**
+ * AWS CloudFormation lexicon plugin.
+ *
+ * Provides serializer, lint rules, template detection,
+ * import parsing, and code generation for AWS CloudFormation.
+ */
+export declare const awsPlugin: LexiconPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAuF,MAAM,0BAA0B,CAAC;AAmBnJ;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,aA2pBvB,CAAC"}

package/dist/pseudo.d.ts

@@ -0,0 +1,17 @@
+import { PseudoParameter } from "@intentius/chant/pseudo-parameter";
+export { PseudoParameter };
+export declare const StackName: PseudoParameter, Region: PseudoParameter, AccountId: PseudoParameter, StackId: PseudoParameter, URLSuffix: PseudoParameter, NoValue: PseudoParameter, NotificationARNs: PseudoParameter, Partition: PseudoParameter;
+/**
+ * AWS namespace containing all pseudo-parameters
+ */
+export declare const AWS: {
+    readonly StackName: PseudoParameter;
+    readonly Region: PseudoParameter;
+    readonly AccountId: PseudoParameter;
+    readonly StackId: PseudoParameter;
+    readonly URLSuffix: PseudoParameter;
+    readonly NoValue: PseudoParameter;
+    readonly NotificationARNs: PseudoParameter;
+    readonly Partition: PseudoParameter;
+};
+//# sourceMappingURL=pseudo.d.ts.map

package/dist/pseudo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pseudo.d.ts","sourceRoot":"","sources":["../src/pseudo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA0B,MAAM,mCAAmC,CAAC;AAE5F,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,eAAO,MAAQ,SAAS,mBAAE,MAAM,mBAAE,SAAS,mBAAE,OAAO,mBAAE,SAAS,mBAAE,OAAO,mBAAE,gBAAgB,mBAAE,SAAS,iBAUjG,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,GAAG;;;;;;;;;CASN,CAAC"}

package/dist/serializer.d.ts

@@ -0,0 +1,6 @@
+import type { Serializer } from "@intentius/chant/serializer";
+/**
+ * AWS CloudFormation serializer implementation
+ */
+export declare const awsSerializer: Serializer;
+//# sourceMappingURL=serializer.d.ts.map

package/dist/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAsC,MAAM,6BAA6B,CAAC;AAqUlG;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,UAoE3B,CAAC"}

package/dist/spec/fetch.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Top-level CloudFormation Registry JSON Schema for a single resource type.
+ */
+export interface CFNSchema {
+    typeName: string;
+    description?: string;
+    properties?: Record<string, SchemaProperty>;
+    definitions?: Record<string, SchemaDefinition>;
+    required?: string[];
+    readOnlyProperties?: string[];
+    createOnlyProperties?: string[];
+    writeOnlyProperties?: string[];
+    primaryIdentifier?: string[];
+    deprecatedProperties?: string[];
+    conditionalCreateOnlyProperties?: string[];
+    replacementStrategy?: string;
+    tagging?: {
+        taggable?: boolean;
+        tagOnCreate?: boolean;
+        tagUpdatable?: boolean;
+        cloudFormationSystemTags?: boolean;
+        tagProperty?: string;
+    };
+    additionalProperties?: boolean;
+}
+/**
+ * A single property in a CloudFormation Registry schema.
+ */
+export interface SchemaProperty {
+    type?: string | string[];
+    description?: string;
+    enum?: string[];
+    $ref?: string;
+    items?: SchemaProperty;
+    properties?: Record<string, SchemaProperty>;
+    oneOf?: unknown[];
+    anyOf?: unknown[];
+    required?: string[];
+    pattern?: string;
+    minLength?: number;
+    maxLength?: number;
+    minimum?: number;
+    maximum?: number;
+    format?: string;
+    const?: unknown;
+    default?: unknown;
+}
+/**
+ * A named type within the definitions section.
+ */
+export interface SchemaDefinition {
+    type?: string | string[];
+    description?: string;
+    enum?: string[];
+    properties?: Record<string, SchemaProperty>;
+    required?: string[];
+    items?: SchemaProperty;
+}
+/**
+ * Fetch the CloudFormation Registry schema zip and extract per-resource JSON schemas.
+ * Returns a Map keyed by typeName (e.g. "AWS::S3::Bucket") to raw JSON bytes.
+ *
+ * Uses a local cache with 24h TTL.
+ */
+export declare function fetchSchemaZip(force?: boolean): Promise<Map<string, Buffer>>;
+/**
+ * Get the cache file path (for testing)
+ */
+export declare function getCachePath(): string;
+/**
+ * Clear the cache (for testing)
+ */
+export declare function clearCache(): void;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/spec/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/spec/fetch.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,+BAA+B,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,wBAAwB,CAAC,EAAE,OAAO,CAAC;QACnC,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAMD;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAMhF;AAuBD;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}

package/dist/spec/parse.d.ts

@@ -0,0 +1,65 @@
+/**
+ * CloudFormation Registry JSON Schema parser.
+ *
+ * Parses each CFNSchema into typed structures suitable for code generation:
+ * resources with properties and attributes, property types from definitions,
+ * and enum types from string enum definitions.
+ */
+import { constraintsIsEmpty as coreConstraintsIsEmpty, type PropertyConstraints } from "@intentius/chant/codegen/json-schema";
+export type { PropertyConstraints } from "@intentius/chant/codegen/json-schema";
+export interface ParsedProperty {
+    name: string;
+    tsType: string;
+    required: boolean;
+    description?: string;
+    enum?: string[];
+    constraints: PropertyConstraints;
+}
+export interface ParsedAttribute {
+    name: string;
+    tsType: string;
+}
+export interface ParsedPropertyType {
+    name: string;
+    specType: string;
+    properties: ParsedProperty[];
+}
+export interface ParsedEnum {
+    name: string;
+    values: string[];
+}
+export interface ParsedResource {
+    typeName: string;
+    properties: ParsedProperty[];
+    attributes: ParsedAttribute[];
+    createOnly: string[];
+    writeOnly: string[];
+    primaryIdentifier: string[];
+    deprecatedProperties: string[];
+    conditionalCreateOnly: string[];
+    replacementStrategy?: "delete_then_create" | "create_then_delete";
+    tagging?: {
+        taggable: boolean;
+        tagOnCreate: boolean;
+        tagUpdatable: boolean;
+    };
+}
+export interface SchemaParseResult {
+    resource: ParsedResource;
+    propertyTypes: ParsedPropertyType[];
+    enums: ParsedEnum[];
+}
+/**
+ * Parse a CloudFormation Registry JSON Schema into typed structures.
+ */
+export declare function parseCFNSchema(data: string | Buffer): SchemaParseResult;
+export declare const constraintsIsEmpty: typeof coreConstraintsIsEmpty;
+/**
+ * Extract short resource name: "AWS::S3::Bucket" → "Bucket"
+ */
+export declare function cfnShortName(typeName: string): string;
+/**
+ * Extract service name: "AWS::S3::Bucket" → "S3"
+ */
+export declare function cfnServiceName(typeName: string): string;
+//# sourceMappingURL=parse.d.ts.map

package/dist/spec/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/spec/parse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAGL,kBAAkB,IAAI,sBAAsB,EAE5C,KAAK,mBAAmB,EAIzB,MAAM,sCAAsC,CAAC;AAG9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAWhF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,mBAAmB,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,mBAAmB,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,CAAC;IAClE,OAAO,CAAC,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE,CAAC;CAC9E;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,aAAa,EAAE,kBAAkB,EAAE,CAAC;IACpC,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,iBAAiB,CA6IvE;AAiBD,eAAO,MAAM,kBAAkB,+BAAyB,CAAC;AAMzD;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvD"}

package/dist/taggable.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared taggable resource lookup — loads from the generated lexicon JSON.
+ *
+ * Lazy-loaded and cached for the lifetime of the process.
+ */
+/**
+ * Load taggable resource types from the lexicon JSON.
+ * Result is cached after first call.
+ */
+export declare function loadTaggableResources(): Set<string>;
+//# sourceMappingURL=taggable.d.ts.map

package/dist/taggable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taggable.d.ts","sourceRoot":"","sources":["../src/taggable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,GAAG,CAAC,MAAM,CAAC,CAqBnD"}