arkgate 4.8.23 → 4.8.25

package/dist/types-Ik_OakcI.d.ts

@@ -1,183 +0,0 @@
-import { a as ArkConfigRule, f as ArkConfigLayer, A as ArkConfig } from './configTypes-Bbf_MFGe.js';
-
-/**
- * Policy types for the Ark kernel.
- *
- * Policies allow declaring architectural rules that can be checked at runtime.
- * Supports both hard policies (must never be violated) and soft policies (warnings).
- */
-type PolicySeverity = 'hard' | 'soft';
-type PolicyEnforcementMode = 'runtime' | 'static' | 'runtime-and-static' | 'advisory';
-/**
- * Represents a single violation of a policy.
- */
-interface PolicyViolation {
-    /** Name of the policy that was violated */
-    policyName: string;
-    /** Severity level of the policy */
-    severity: PolicySeverity;
-    /** Human-readable explanation of the violation */
-    message: string;
-    /** Optional additional structured details */
-    details?: unknown;
-}
-/**
- * A Policy defines a rule that can be evaluated against a context.
- *
- * @template Context - The shape of data the policy evaluates (e.g. { registry, events })
- */
-interface Policy<Context = unknown> {
-    /** Unique name of the policy (used in violations and reporting) */
-    readonly name: string;
-    /** Whether this is a hard rule (enforced strictly) or soft (advisory) */
-    readonly severity: PolicySeverity;
-    /** Optional tags for policy classification (e.g. 'layer', 'naming') */
-    readonly tags?: readonly string[];
-    readonly owner?: string;
-    readonly version?: string;
-    readonly rationale?: string;
-    readonly enforcementMode?: PolicyEnforcementMode;
-    readonly deprecated?: boolean | string;
-    readonly replacedBy?: string;
-    /**
-     * Evaluates the policy against the given context.
-     * Return true / [] for pass, false / single violation / array for failure.
-     */
-    check(context: Context): boolean | PolicyViolation | PolicyViolation[];
-}
-
-/**
- * Core domain primitives for Ark.
- * These types are the foundation for all governance concepts.
- */
-/**
- * Semantic intent names follow a convention:
- * - Domain.* for domain events and entities
- * - Application.* for use-cases / orchestration
- * - Adapter.* for integration points
- * - Workflow.* for sagas and processes
- * - Job.* for background jobs and scheduling
- * - Presentation.* for UI/API adapters
- * - Reporting.* for read models and projections
- * - Metadata.* for extensibility contracts
- * - Security.* / Audit.* / Observability.* for cross-cutting kernel concerns
- * - Kernel.* for Ark-owned governance signals
- */
-type IntentName = `Domain.${string}` | `Application.${string}` | `Adapter.${string}` | `Workflow.${string}` | `Job.${string}` | `Presentation.${string}` | `Reporting.${string}` | `Metadata.${string}` | `Security.${string}` | `Audit.${string}` | `Observability.${string}` | `Kernel.${string}`;
-type CorrelationId = string;
-interface EventMetadata {
-    occurredAt: string;
-    source: string;
-    kernelInstanceId?: string;
-    eventVersion?: string;
-    schemaVersion?: string;
-    allowInterception?: boolean;
-    interceptions?: Array<{
-        interceptorId: string;
-        timestamp: string;
-    }>;
-    correlationId?: CorrelationId;
-    causationId?: string;
-    traceId?: string;
-    spanId?: string;
-    parentSpanId?: string;
-    [key: string]: unknown;
-}
-interface DomainEvent<Name extends IntentName = IntentName, Payload = unknown> {
-    intent: Name;
-    payload: Payload;
-    metadata: EventMetadata;
-}
-
-/**
- * Intent-specific types for the Ark kernel.
- *
- * Intents provide semantic naming for every important concept in the system
- * (domain events, application operations, adapters, workflows).
- */
-
-/**
- * An IntentCreator is a callable that creates a strongly-typed DomainEvent
- * when invoked with a payload.
- *
- * It also carries the semantic `name`.
- *
- * @example
- * const OrderPlaced = defineIntent<'Domain.Order.OrderPlaced', { orderId: string }>('Domain.Order.OrderPlaced');
- * const event = OrderPlaced({ orderId: 'o-1' });
- */
-interface IntentCreator<Name extends IntentName, Payload = unknown> {
-    /**
-     * Creates a DomainEvent for this intent.
-     */
-    (payload: Payload): DomainEvent<Name, Payload>;
-    /**
-     * The fully-qualified semantic name of the intent (e.g. "Domain.Order.OrderPlaced").
-     */
-    readonly name: Name;
-}
-/** Kind of relationship between two intents. */
-type IntentRelationshipKind = 'dependsOn' | 'produces';
-/**
- * Relationship declarations between intents.
- * Used for dependency analysis and graph generation.
- */
-interface IntentRelationship {
-    from: string;
-    to: string;
-    kind: IntentRelationshipKind;
-}
-
-/**
- * Architecture layer profiles.
- *
- * A profile turns semantic names such as `Domain.Order.Placed` into governed
- * layer names and dependency rules.
- */
-
-interface ArchitectureLayer {
-    name: string;
-    prefixes: string[];
-    /**
-     * Custom matcher for teams whose intent names don't follow prefix conventions.
-     * Checked before any prefix matching, in layer declaration order. A layer may
-     * use `match` alone (with `prefixes: []`), prefixes alone, or both.
-     */
-    match?: (name: string) => boolean;
-    description?: string;
-    trustBoundary?: 'public' | 'auth' | 'admin' | 'internal';
-    owners?: string[];
-    order?: number;
-}
-type ArchitectureRule = ArkConfigRule;
-interface ArchitectureProfile {
-    name: string;
-    layers: ArchitectureLayer[];
-    rules: ArchitectureRule[];
-    resolveLayer(name: string): string | undefined;
-}
-interface CreateArchitectureProfileOptions {
-    name: string;
-    layers: ArchitectureLayer[];
-    rules?: ArchitectureRule[];
-}
-interface CreateArchitectureProfileFromArkConfigOptions {
-    /** Runtime profile name. Default: config.name or "ark.config.json". */
-    name?: string;
-}
-type ArchitectureLayerConfig = ArkConfigLayer;
-type ArkCheckConfig = Omit<ArkConfig, '$schema' | 'schemaVersion' | 'rules'> & {
-    $schema?: string;
-    schemaVersion?: ArkConfig['schemaVersion'];
-    rules?: ArchitectureRule[];
-};
-interface CreateElevenLayerArkConfigOptions {
-    /** Source root used in generated file patterns. Default: "src". */
-    rootDir?: string;
-    /** Include entries for ark-check. Default: [rootDir]. */
-    include?: string[];
-    /** Mark generated layers optional. Default: true. */
-    optionalLayers?: boolean;
-}
-
-export type { ArchitectureLayer as A, CreateArchitectureProfileFromArkConfigOptions as C, DomainEvent as D, EventMetadata as E, IntentName as I, PolicyViolation as P, ArchitectureLayerConfig as a, ArchitectureProfile as b, ArchitectureRule as c, ArkCheckConfig as d, CreateArchitectureProfileOptions as e, CreateElevenLayerArkConfigOptions as f, PolicySeverity as g, PolicyEnforcementMode as h, Policy as i, IntentCreator as j, IntentRelationship as k, CorrelationId as l, IntentRelationshipKind as m };