@domainlang/language 0.1.20

package/out/sdk/patterns.js

@@ -0,0 +1,123 @@
+/**
+ * Integration Patterns - Type-safe constants for DDD integration patterns.
+ *
+ * Use these constants instead of magic strings when checking relationship patterns.
+ *
+ * @example
+ * ```typescript
+ * import { Pattern } from '../sdk/patterns.js';
+ *
+ * // Instead of: hasPattern('SK') or hasPattern('SharedKernel')
+ * // Use:
+ * if (relationship.hasPattern(Pattern.SharedKernel)) {
+ *     // ...
+ * }
+ * ```
+ */
+/**
+ * Integration pattern abbreviations as used in the grammar.
+ * These are the canonical abbreviations recognized by DomainLang.
+ */
+export const Pattern = {
+    // Upstream patterns (provider side)
+    /** Open Host Service - exposes a clean API for consumers */
+    OHS: 'OHS',
+    /** Published Language - shared data format/protocol */
+    PL: 'PL',
+    // Downstream patterns (consumer side)
+    /** Conformist - accepts upstream model without translation */
+    CF: 'CF',
+    /** Anti-Corruption Layer - translates upstream model */
+    ACL: 'ACL',
+    // Mutual patterns (both sides)
+    /** Shared Kernel - shared code/model ownership */
+    SK: 'SK',
+    /** Partnership - coordinated development */
+    P: 'P',
+    // Relationship types
+    /** Customer/Supplier - negotiated contract */
+    CustomerSupplier: 'Customer/Supplier',
+    /** Separate Ways - no integration */
+    SeparateWays: 'Separate Ways',
+    /** Big Ball of Mud - legacy or unstructured */
+    BigBallOfMud: 'Big Ball of Mud',
+};
+/**
+ * Full names for integration patterns.
+ * Used when patterns are spelled out in documentation blocks.
+ */
+export const PatternFullName = {
+    OHS: 'OpenHostService',
+    PL: 'PublishedLanguage',
+    CF: 'Conformist',
+    ACL: 'AntiCorruptionLayer',
+    SK: 'SharedKernel',
+    P: 'Partnership',
+};
+/**
+ * Mapping from abbreviations to full names and vice versa.
+ */
+export const PatternAliases = {
+    // Abbreviation -> [abbreviation, fullName]
+    OHS: ['OHS', 'OpenHostService'],
+    PL: ['PL', 'PublishedLanguage'],
+    CF: ['CF', 'Conformist'],
+    ACL: ['ACL', 'AntiCorruptionLayer'],
+    SK: ['SK', 'SharedKernel'],
+    P: ['P', 'Partnership'],
+    // Full names map to same
+    OpenHostService: ['OHS', 'OpenHostService'],
+    PublishedLanguage: ['PL', 'PublishedLanguage'],
+    Conformist: ['CF', 'Conformist'],
+    AntiCorruptionLayer: ['ACL', 'AntiCorruptionLayer'],
+    SharedKernel: ['SK', 'SharedKernel'],
+    Partnership: ['P', 'Partnership'],
+};
+/**
+ * Checks if a pattern string matches any of the expected aliases.
+ * Handles both abbreviations and full names case-insensitively.
+ *
+ * @param actual - Pattern string from the AST
+ * @param expected - Pattern to match (abbreviation or full name)
+ * @returns true if patterns match
+ */
+export function matchesPattern(actual, expected) {
+    const normalizedActual = actual.trim();
+    const aliases = PatternAliases[expected];
+    if (aliases) {
+        return aliases.some(alias => alias.toLowerCase() === normalizedActual.toLowerCase());
+    }
+    // Fallback: direct comparison
+    return normalizedActual.toLowerCase() === expected.toLowerCase();
+}
+/**
+ * Patterns that are typically on the upstream (provider) side.
+ */
+export const UpstreamPatterns = ['OHS', 'OpenHostService', 'PL', 'PublishedLanguage'];
+/**
+ * Patterns that are typically on the downstream (consumer) side.
+ */
+export const DownstreamPatterns = ['CF', 'Conformist', 'ACL', 'AntiCorruptionLayer'];
+/**
+ * Patterns that require mutual/bidirectional relationships.
+ */
+export const MutualPatterns = ['SK', 'SharedKernel', 'P', 'Partnership'];
+/**
+ * Checks if a pattern is typically an upstream pattern.
+ */
+export function isUpstreamPattern(pattern) {
+    return UpstreamPatterns.some(p => matchesPattern(pattern, p));
+}
+/**
+ * Checks if a pattern is typically a downstream pattern.
+ */
+export function isDownstreamPattern(pattern) {
+    return DownstreamPatterns.some(p => matchesPattern(pattern, p));
+}
+/**
+ * Checks if a pattern requires bidirectional relationships.
+ */
+export function isMutualPattern(pattern) {
+    return MutualPatterns.some(p => matchesPattern(pattern, p));
+}
+//# sourceMappingURL=patterns.js.map

package/out/sdk/patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.js","sourceRoot":"","sources":["../../src/sdk/patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACnB,oCAAoC;IACpC,4DAA4D;IAC5D,GAAG,EAAE,KAAK;IACV,uDAAuD;IACvD,EAAE,EAAE,IAAI;IAER,sCAAsC;IACtC,8DAA8D;IAC9D,EAAE,EAAE,IAAI;IACR,wDAAwD;IACxD,GAAG,EAAE,KAAK;IAEV,+BAA+B;IAC/B,kDAAkD;IAClD,EAAE,EAAE,IAAI;IACR,4CAA4C;IAC5C,CAAC,EAAE,GAAG;IAEN,qBAAqB;IACrB,8CAA8C;IAC9C,gBAAgB,EAAE,mBAAmB;IACrC,qCAAqC;IACrC,YAAY,EAAE,eAAe;IAC7B,+CAA+C;IAC/C,YAAY,EAAE,iBAAiB;CACzB,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,GAAG,EAAE,iBAAiB;IACtB,EAAE,EAAE,mBAAmB;IACvB,EAAE,EAAE,YAAY;IAChB,GAAG,EAAE,qBAAqB;IAC1B,EAAE,EAAE,cAAc;IAClB,CAAC,EAAE,aAAa;CACV,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAsC;IAC7D,2CAA2C;IAC3C,GAAG,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAC/B,EAAE,EAAE,CAAC,IAAI,EAAE,mBAAmB,CAAC;IAC/B,EAAE,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC;IACxB,GAAG,EAAE,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACnC,EAAE,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC;IAC1B,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,CAAC;IAEvB,yBAAyB;IACzB,eAAe,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAC3C,iBAAiB,EAAE,CAAC,IAAI,EAAE,mBAAmB,CAAC;IAC9C,UAAU,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC;IAChC,mBAAmB,EAAE,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACnD,YAAY,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC;IACpC,WAAW,EAAE,CAAC,GAAG,EAAE,aAAa,CAAC;CACpC,CAAC;AASF;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,QAAgB;IAC3D,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAEzC,IAAI,OAAO,EAAE,CAAC;QACV,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CACxB,KAAK,CAAC,WAAW,EAAE,KAAK,gBAAgB,CAAC,WAAW,EAAE,CACzD,CAAC;IACN,CAAC;IAED,8BAA8B;IAC9B,OAAO,gBAAgB,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,WAAW,EAAE,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAsB,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,mBAAmB,CAAC,CAAC;AAEzG;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAsB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,qBAAqB,CAAC,CAAC;AAExG;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAsB,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;AAE5F;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC7C,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IAC/C,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC3C,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/out/sdk/query.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Query and QueryBuilder implementation for the Model Query SDK.
+ * Provides fluent, lazy evaluation of model queries.
+ */
+import type { LangiumDocument, URI } from 'langium';
+import type { BoundedContext, Domain, Model, Relationship } from '../generated/ast.js';
+import type { DomainLangServices } from '../domain-lang-module.js';
+import type { Query } from './types.js';
+/**
+ * Creates a Query instance from a Model node.
+ * Zero-copy operation for already-linked AST (used in LSP/validation).
+ *
+ * Automatically augments the AST with resolved properties on first access.
+ *
+ * @param model - Root Model node
+ * @returns Query interface for model traversal
+ */
+export declare function fromModel(model: Model): Query;
+/**
+ * Creates a Query instance from a LangiumDocument.
+ * Zero-copy operation for already-linked AST (used in LSP providers).
+ *
+ * Automatically augments the AST with resolved properties on first access.
+ *
+ * @param document - LangiumDocument containing a Model
+ * @returns Query interface for model traversal
+ */
+export declare function fromDocument(document: LangiumDocument<Model>): Query;
+/**
+ * Creates a Query instance from DomainLangServices and document URI.
+ * Zero-copy operation for already-linked AST (used when only services available).
+ *
+ * Automatically augments the AST with resolved properties on first access.
+ *
+ * @param services - DomainLangServices instance
+ * @param documentUri - URI of the document to query
+ * @returns Query interface for model traversal
+ * @throws Error if document not found or not a Model
+ */
+export declare function fromServices(services: DomainLangServices, documentUri: URI): Query;
+/**
+ * Augments BoundedContext instances with SDK-resolved properties.
+ * Called during model loading to enrich the AST.
+ *
+ * Properties use natural names (not sdk* prefix) per PRS:
+ * "Properties are discoverable in IDE autocomplete. The SDK enriches the AST
+ * during load, so `bc.classification` just works—no imports needed."
+ *
+ * Note: We use getters to avoid computing values until accessed.
+ * Note: We use Object.defineProperty to avoid modifying the original interface.
+ *
+ * @param bc - BoundedContext to augment
+ */
+export declare function augmentBoundedContext(bc: BoundedContext): void;
+/**
+ * Augments Domain instances with SDK-resolved properties.
+ * Called during model loading to enrich the AST.
+ *
+ * Only includes properties that add value beyond direct AST access:
+ * - fqn: computed qualified name
+ * - hasType: helper method
+ *
+ * Direct access (no augmentation needed):
+ * - domain.description
+ * - domain.vision
+ * - domain.type?.ref
+ *
+ * @param domain - Domain to augment
+ */
+export declare function augmentDomain(domain: Domain): void;
+/**
+ * Augments Relationship instances with SDK helper methods.
+ * Called during model loading to enrich the AST.
+ *
+ * @param rel - Relationship to augment
+ * @param containingBc - BoundedContext containing this relationship (for 'this' resolution)
+ */
+export declare function augmentRelationship(rel: Relationship, containingBc?: BoundedContext): void;
+/**
+ * Augments all AST nodes in a model with SDK-resolved properties.
+ *
+ * This function walks the entire AST and adds lazy getters for resolved
+ * properties like `effectiveClassification`, `effectiveTeam`, etc.
+ *
+ * Idempotent - safe to call multiple times on the same model.
+ * Automatically called by `fromModel()`, `fromDocument()`, and `fromServices()`.
+ *
+ * @param model - Root Model node to augment
+ */
+export declare function augmentModel(model: Model): void;