@xylex-group/athena 3.0.2 → 3.0.3

package/dist/{types-BaAMXCqK.d.ts → types-D6tZ9aoq.d.ts}

@@ -54,6 +54,21 @@ interface GeneratorOutputTargets {
 }
 type GeneratorOutputPreset = 'legacy' | 'athena-direct';
 type GeneratorOutputFormat = 'define-model' | 'table-builder';
+/**
+ * How existing database/registry artifacts are handled on regenerate.
+ *
+ * - `merge` (default): additive smart merge — append missing imports/keys, preserve custom code
+ * - `skip`: never rewrite existing files (legacy protect behavior)
+ * - `overwrite`: always replace with pure generated content
+ */
+type GeneratorArtifactWritePolicy = 'merge' | 'skip' | 'overwrite';
+/**
+ * Per-kind write policy for protected generator artifacts.
+ */
+interface GeneratorArtifactWriteConfig {
+    database?: GeneratorArtifactWritePolicy;
+    registry?: GeneratorArtifactWritePolicy;
+}
 /**
  * Output configuration including dynamic placeholder aliases.
  */
@@ -62,6 +77,7 @@ interface GeneratorOutputConfig {
     preset?: GeneratorOutputPreset;
     targets?: Partial<GeneratorOutputTargets>;
     placeholderMap?: Record<string, string>;
+    artifactWrite?: GeneratorArtifactWriteConfig;
 }
 /**
  * Normalized output configuration with defaults applied.
@@ -71,6 +87,10 @@ interface NormalizedGeneratorOutputConfig {
     preset: GeneratorOutputPreset;
     targets: GeneratorOutputTargets;
     placeholderMap: Record<string, string>;
+    artifactWrite: {
+        database: GeneratorArtifactWritePolicy;
+        registry: GeneratorArtifactWritePolicy;
+    };
 }
 /**
  * Schemas selected for PostgreSQL introspection. Strings may be comma-separated
@@ -215,13 +235,26 @@ interface RunGeneratorResult extends GeneratedArtifacts {
     configPath: string;
     config: NormalizedAthenaGeneratorConfig;
     writtenFiles: string[];
+    writtenDetails: WrittenGeneratedArtifact[];
     skippedFiles: SkippedGeneratedArtifact[];
 }
-type SkippedGeneratedArtifactReason = 'protected-existing-file';
+type SkippedGeneratedArtifactReason = 'protected-existing-file' | 'merge-conflict' | 'merge-lint-failed' | 'merge-unparseable' | 'already-current';
+type WrittenGeneratedArtifactReason = 'created' | 'overwritten' | 'merged';
 interface SkippedGeneratedArtifact {
     kind: GeneratorArtifactKind;
     path: string;
     reason: SkippedGeneratedArtifactReason;
+    detail?: string;
+    preservedCustom?: string[];
+    conflicts?: string[];
+    lintErrors?: string[];
+}
+interface WrittenGeneratedArtifact {
+    kind: GeneratorArtifactKind;
+    path: string;
+    reason: WrittenGeneratedArtifactReason;
+    added?: string[];
+    preservedCustom?: string[];
 }
 
 export type { AthenaGeneratorConfig as A, GeneratedArtifacts as G, LoadGeneratorConfigOptions as L, NormalizedAthenaGeneratorConfig as N, RunGeneratorOptions as R, SkippedGeneratedArtifact as S, LoadedGeneratorConfig as a, GeneratorProviderConfig as b, GeneratorExperimentalFlags as c, RunGeneratorResult as d, GeneratedArtifact as e, GeneratorArtifactKind as f, GeneratorFeatureFlags as g, GeneratorFilterConfig as h, GeneratorInternalConfig as i, GeneratorNamingConfig as j, GeneratorOutputConfig as k, GeneratorOutputFormat as l, GeneratorOutputPreset as m, GeneratorOutputTargets as n, GeneratorSchemaSelection as o, GeneratorTableSelection as p, NamingStyle as q, NormalizedGeneratorFilterConfig as r, NormalizedGeneratorOutputConfig as s, SkippedGeneratedArtifactReason as t };

package/dist/{types-BBm-kEBL.d.cts → types-DFr2cL1N.d.cts}

@@ -54,6 +54,21 @@ interface GeneratorOutputTargets {
 }
 type GeneratorOutputPreset = 'legacy' | 'athena-direct';
 type GeneratorOutputFormat = 'define-model' | 'table-builder';
+/**
+ * How existing database/registry artifacts are handled on regenerate.
+ *
+ * - `merge` (default): additive smart merge — append missing imports/keys, preserve custom code
+ * - `skip`: never rewrite existing files (legacy protect behavior)
+ * - `overwrite`: always replace with pure generated content
+ */
+type GeneratorArtifactWritePolicy = 'merge' | 'skip' | 'overwrite';
+/**
+ * Per-kind write policy for protected generator artifacts.
+ */
+interface GeneratorArtifactWriteConfig {
+    database?: GeneratorArtifactWritePolicy;
+    registry?: GeneratorArtifactWritePolicy;
+}
 /**
  * Output configuration including dynamic placeholder aliases.
  */
@@ -62,6 +77,7 @@ interface GeneratorOutputConfig {
     preset?: GeneratorOutputPreset;
     targets?: Partial<GeneratorOutputTargets>;
     placeholderMap?: Record<string, string>;
+    artifactWrite?: GeneratorArtifactWriteConfig;
 }
 /**
  * Normalized output configuration with defaults applied.
@@ -71,6 +87,10 @@ interface NormalizedGeneratorOutputConfig {
     preset: GeneratorOutputPreset;
     targets: GeneratorOutputTargets;
     placeholderMap: Record<string, string>;
+    artifactWrite: {
+        database: GeneratorArtifactWritePolicy;
+        registry: GeneratorArtifactWritePolicy;
+    };
 }
 /**
  * Schemas selected for PostgreSQL introspection. Strings may be comma-separated
@@ -215,13 +235,26 @@ interface RunGeneratorResult extends GeneratedArtifacts {
     configPath: string;
     config: NormalizedAthenaGeneratorConfig;
     writtenFiles: string[];
+    writtenDetails: WrittenGeneratedArtifact[];
     skippedFiles: SkippedGeneratedArtifact[];
 }
-type SkippedGeneratedArtifactReason = 'protected-existing-file';
+type SkippedGeneratedArtifactReason = 'protected-existing-file' | 'merge-conflict' | 'merge-lint-failed' | 'merge-unparseable' | 'already-current';
+type WrittenGeneratedArtifactReason = 'created' | 'overwritten' | 'merged';
 interface SkippedGeneratedArtifact {
     kind: GeneratorArtifactKind;
     path: string;
     reason: SkippedGeneratedArtifactReason;
+    detail?: string;
+    preservedCustom?: string[];
+    conflicts?: string[];
+    lintErrors?: string[];
+}
+interface WrittenGeneratedArtifact {
+    kind: GeneratorArtifactKind;
+    path: string;
+    reason: WrittenGeneratedArtifactReason;
+    added?: string[];
+    preservedCustom?: string[];
 }
 
 export type { AthenaGeneratorConfig as A, GeneratedArtifacts as G, LoadGeneratorConfigOptions as L, NormalizedAthenaGeneratorConfig as N, RunGeneratorOptions as R, SkippedGeneratedArtifact as S, LoadedGeneratorConfig as a, GeneratorProviderConfig as b, GeneratorExperimentalFlags as c, RunGeneratorResult as d, GeneratedArtifact as e, GeneratorArtifactKind as f, GeneratorFeatureFlags as g, GeneratorFilterConfig as h, GeneratorInternalConfig as i, GeneratorNamingConfig as j, GeneratorOutputConfig as k, GeneratorOutputFormat as l, GeneratorOutputPreset as m, GeneratorOutputTargets as n, GeneratorSchemaSelection as o, GeneratorTableSelection as p, NamingStyle as q, NormalizedGeneratorFilterConfig as r, NormalizedGeneratorOutputConfig as s, SkippedGeneratedArtifactReason as t };

package/package.json

@@ -218,5 +218,5 @@
       ]
     }
   },
-  "version": "3.0.2"
+  "version": "3.0.3"
 }