@xylex-group/athena 3.0.3 → 3.3.0

package/dist/pipeline-BnRKO_Pd.d.cts

@@ -0,0 +1,93 @@
+import { b as GeneratorProviderConfig, a as LoadedGeneratorConfig, R as RunGeneratorOptions, d as RunGeneratorResult } from './types-D-Am7YSd.cjs';
+
+type GeneratorConfigFileAction = 'created' | 'updated' | 'unchanged' | 'skipped';
+type GeneratorConfigProviderMode = 'direct' | 'gateway' | 'auto';
+interface EnsureGeneratorConfigFileOptions {
+    cwd?: string;
+    /** Explicit path relative to cwd or absolute. Defaults to discovered path or `athena.config.ts`. */
+    configPath?: string;
+    /** Provider mode preference when creating a new file. */
+    mode?: GeneratorConfigProviderMode;
+    /**
+     * Discover live schemas and auto-fill `provider.schemas`.
+     * Defaults to true.
+     */
+    discoverSchemas?: boolean;
+    /**
+     * When false, never write to disk (report would-be action only).
+     * Defaults to false.
+     */
+    dryRun?: boolean;
+    /**
+     * When true, rewrite the full modern template even if a file already exists.
+     * Defaults to false (intelligent surgical update only).
+     */
+    force?: boolean;
+    /**
+     * Pre-resolved provider used for schema discovery (avoids re-normalizing).
+     */
+    provider?: GeneratorProviderConfig;
+    /**
+     * Optional pre-loaded config (skips a second disk load).
+     */
+    loaded?: LoadedGeneratorConfig;
+    /**
+     * Explicit schemas to write when discovery is disabled or fails.
+     */
+    schemas?: readonly string[];
+}
+interface EnsureGeneratorConfigFileResult {
+    action: GeneratorConfigFileAction;
+    path: string;
+    absolutePath: string;
+    content?: string;
+    schemas: string[];
+    changes: string[];
+    mode: 'direct' | 'gateway';
+    reason?: string;
+}
+type DetectedMode = 'direct' | 'gateway';
+/**
+ * Picks a provider mode from env when the caller did not force one.
+ * Prefers direct when a connection string is present; otherwise gateway.
+ */
+declare function detectGeneratorProviderMode(preferred?: GeneratorConfigProviderMode): DetectedMode;
+/**
+ * Renders a modern, typed `athena.config.ts` using `defineGeneratorConfig` + `generatorEnv`.
+ * Secrets stay env-backed so gateway and direct modes both work without hardcoding keys.
+ */
+declare function renderGeneratorConfigFile(options: {
+    mode: DetectedMode;
+    schemas?: readonly string[];
+}): string;
+/**
+ * Updates only the `schemas:` value inside an existing TypeScript config source.
+ * Supports:
+ * - `schemas: ["public", "athena"]`
+ * - `schemas: generatorEnv.list("...", { default: ["public"] })`
+ *
+ * Returns undefined when the file cannot be updated surgically (caller may full-render).
+ */
+declare function patchSchemasInConfigSource(source: string, schemas: readonly string[]): string | undefined;
+/**
+ * Creates or intelligently updates `athena.config.ts`.
+ *
+ * Intelligence rules:
+ * - missing file → write modern direct/gateway template with env-backed secrets
+ * - existing file + force → full rewrite
+ * - existing file → only patch `provider.schemas` when auto-fill finds new values
+ * - skip write when content/schemas already match (no churn, safe for typecheck CI)
+ * - never removes user-listed schemas that discovery did not return
+ * - gateway mode uses the same template surface as direct (generatorEnv for url/key)
+ */
+declare function ensureGeneratorConfigFile(options?: EnsureGeneratorConfigFileOptions): Promise<EnsureGeneratorConfigFileResult>;
+
+/**
+ * End-to-end generator execution: load config, introspect, render, and optionally write files.
+ *
+ * When `writeConfig` is enabled (default), also ensures `athena.config.ts` exists and
+ * auto-fills discovered schemas without clobbering custom config fields.
+ */
+declare function runSchemaGenerator(options?: RunGeneratorOptions): Promise<RunGeneratorResult>;
+
+export { type EnsureGeneratorConfigFileOptions as E, type GeneratorConfigFileAction as G, type EnsureGeneratorConfigFileResult as a, type GeneratorConfigProviderMode as b, renderGeneratorConfigFile as c, detectGeneratorProviderMode as d, ensureGeneratorConfigFile as e, patchSchemasInConfigSource as p, runSchemaGenerator as r };

package/dist/pipeline-sWCmlFqu.d.ts

@@ -0,0 +1,93 @@
+import { b as GeneratorProviderConfig, a as LoadedGeneratorConfig, R as RunGeneratorOptions, d as RunGeneratorResult } from './types-BDX8zS7w.js';
+
+type GeneratorConfigFileAction = 'created' | 'updated' | 'unchanged' | 'skipped';
+type GeneratorConfigProviderMode = 'direct' | 'gateway' | 'auto';
+interface EnsureGeneratorConfigFileOptions {
+    cwd?: string;
+    /** Explicit path relative to cwd or absolute. Defaults to discovered path or `athena.config.ts`. */
+    configPath?: string;
+    /** Provider mode preference when creating a new file. */
+    mode?: GeneratorConfigProviderMode;
+    /**
+     * Discover live schemas and auto-fill `provider.schemas`.
+     * Defaults to true.
+     */
+    discoverSchemas?: boolean;
+    /**
+     * When false, never write to disk (report would-be action only).
+     * Defaults to false.
+     */
+    dryRun?: boolean;
+    /**
+     * When true, rewrite the full modern template even if a file already exists.
+     * Defaults to false (intelligent surgical update only).
+     */
+    force?: boolean;
+    /**
+     * Pre-resolved provider used for schema discovery (avoids re-normalizing).
+     */
+    provider?: GeneratorProviderConfig;
+    /**
+     * Optional pre-loaded config (skips a second disk load).
+     */
+    loaded?: LoadedGeneratorConfig;
+    /**
+     * Explicit schemas to write when discovery is disabled or fails.
+     */
+    schemas?: readonly string[];
+}
+interface EnsureGeneratorConfigFileResult {
+    action: GeneratorConfigFileAction;
+    path: string;
+    absolutePath: string;
+    content?: string;
+    schemas: string[];
+    changes: string[];
+    mode: 'direct' | 'gateway';
+    reason?: string;
+}
+type DetectedMode = 'direct' | 'gateway';
+/**
+ * Picks a provider mode from env when the caller did not force one.
+ * Prefers direct when a connection string is present; otherwise gateway.
+ */
+declare function detectGeneratorProviderMode(preferred?: GeneratorConfigProviderMode): DetectedMode;
+/**
+ * Renders a modern, typed `athena.config.ts` using `defineGeneratorConfig` + `generatorEnv`.
+ * Secrets stay env-backed so gateway and direct modes both work without hardcoding keys.
+ */
+declare function renderGeneratorConfigFile(options: {
+    mode: DetectedMode;
+    schemas?: readonly string[];
+}): string;
+/**
+ * Updates only the `schemas:` value inside an existing TypeScript config source.
+ * Supports:
+ * - `schemas: ["public", "athena"]`
+ * - `schemas: generatorEnv.list("...", { default: ["public"] })`
+ *
+ * Returns undefined when the file cannot be updated surgically (caller may full-render).
+ */
+declare function patchSchemasInConfigSource(source: string, schemas: readonly string[]): string | undefined;
+/**
+ * Creates or intelligently updates `athena.config.ts`.
+ *
+ * Intelligence rules:
+ * - missing file → write modern direct/gateway template with env-backed secrets
+ * - existing file + force → full rewrite
+ * - existing file → only patch `provider.schemas` when auto-fill finds new values
+ * - skip write when content/schemas already match (no churn, safe for typecheck CI)
+ * - never removes user-listed schemas that discovery did not return
+ * - gateway mode uses the same template surface as direct (generatorEnv for url/key)
+ */
+declare function ensureGeneratorConfigFile(options?: EnsureGeneratorConfigFileOptions): Promise<EnsureGeneratorConfigFileResult>;
+
+/**
+ * End-to-end generator execution: load config, introspect, render, and optionally write files.
+ *
+ * When `writeConfig` is enabled (default), also ensures `athena.config.ts` exists and
+ * auto-fills discovered schemas without clobbering custom config fields.
+ */
+declare function runSchemaGenerator(options?: RunGeneratorOptions): Promise<RunGeneratorResult>;
+
+export { type EnsureGeneratorConfigFileOptions as E, type GeneratorConfigFileAction as G, type EnsureGeneratorConfigFileResult as a, type GeneratorConfigProviderMode as b, renderGeneratorConfigFile as c, detectGeneratorProviderMode as d, ensureGeneratorConfigFile as e, patchSchemasInConfigSource as p, runSchemaGenerator as r };

package/dist/{proxy-request-headers-m4D2Tduy.d.ts → proxy-request-headers-CttlcuRb.d.ts}

@@ -1,4 +1,4 @@
-import { I as EnvLike } from './athena-request-headers-C7Jy-c_D.js';
+import { E as EnvLike } from './athena-auth-url-C1FbVmN6.js';
 
 /**
  * Request header / Next.js helpers used by middleware and RSC session loaders.

package/dist/{proxy-request-headers-DGxdoyA0.d.cts → proxy-request-headers-pIBSn1Fw.d.cts}

@@ -1,4 +1,4 @@
-import { I as EnvLike } from './athena-request-headers-DujFFyMU.cjs';
+import { E as EnvLike } from './athena-auth-url-C1FbVmN6.cjs';
 
 /**
  * Request header / Next.js helpers used by middleware and RSC session loaders.