@xylex-group/athena 1.7.0 → 2.0.0

package/dist/pipeline-C-cN0ACi.d.cts

@@ -0,0 +1,164 @@
+import { a as BackendType, p as IntrospectionSnapshot, o as SchemaIntrospectionProvider } from './types-BnzoaNRC.cjs';
+
+/**
+ * Supported case transformations for generated symbols and path token variants.
+ */
+type NamingStyle = 'preserve' | 'camel' | 'pascal' | 'snake' | 'kebab';
+/**
+ * Naming configuration for generated TypeScript identifiers.
+ */
+interface GeneratorNamingConfig {
+    modelType: NamingStyle;
+    modelConst: NamingStyle;
+    schemaConst: NamingStyle;
+    databaseConst: NamingStyle;
+    registryConst: NamingStyle;
+}
+/**
+ * Stable feature flags for generator output behavior.
+ */
+interface GeneratorFeatureFlags {
+    emitRelations: boolean;
+    emitRegistry: boolean;
+}
+/**
+ * Experimental toggles for optional/forward-compatible generator behavior.
+ */
+interface GeneratorExperimentalFlags {
+    /**
+     * Legacy compatibility toggle from the initial scaffold.
+     * Gateway introspection is now implemented; this flag is retained for additive config compatibility.
+     */
+    postgresGatewayIntrospection: boolean;
+    /**
+     * Enables contract placeholders for future Scylla provider work.
+     */
+    scyllaProviderContracts: boolean;
+}
+/**
+ * Path templates for each generated artifact category.
+ */
+interface GeneratorOutputTargets {
+    model: string;
+    schema: string;
+    database: string;
+    registry: string;
+}
+/**
+ * Output configuration including dynamic placeholder aliases.
+ */
+interface GeneratorOutputConfig {
+    targets: GeneratorOutputTargets;
+    placeholderMap: Record<string, string>;
+}
+/**
+ * Schemas selected for PostgreSQL introspection. Strings may be comma-separated
+ * to support env-driven configs such as `process.env.GENERATOR_SCHEMAS`.
+ */
+type GeneratorSchemaSelection = string | readonly string[];
+/**
+ * Direct PostgreSQL introspection mode (implemented).
+ */
+interface PostgresDirectProviderConfig {
+    kind: 'postgres';
+    mode: 'direct';
+    connectionString: string;
+    database?: string;
+    schemas?: GeneratorSchemaSelection;
+}
+/**
+ * Athena gateway-backed PostgreSQL introspection mode using `/gateway/query`.
+ */
+interface PostgresGatewayProviderConfig {
+    kind: 'postgres';
+    mode: 'gateway';
+    gatewayUrl: string;
+    apiKey: string;
+    database: string;
+    schemas?: GeneratorSchemaSelection;
+    backend?: BackendType;
+}
+/**
+ * Scylla introspection provider contract placeholder (phase-two scaffold).
+ */
+interface ScyllaDirectProviderConfig {
+    kind: 'scylla';
+    mode: 'direct';
+    contactPoints: string[];
+    keyspace: string;
+    datacenter?: string;
+}
+type GeneratorProviderConfig = PostgresDirectProviderConfig | PostgresGatewayProviderConfig | ScyllaDirectProviderConfig;
+/**
+ * Root config contract loaded from `athena.config.ts`.
+ */
+interface AthenaGeneratorConfig {
+    provider: GeneratorProviderConfig;
+    output: GeneratorOutputConfig;
+    naming?: Partial<GeneratorNamingConfig>;
+    features?: Partial<GeneratorFeatureFlags>;
+    experimental?: Partial<GeneratorExperimentalFlags>;
+}
+/**
+ * Normalized generator config with defaults applied.
+ */
+interface NormalizedAthenaGeneratorConfig {
+    provider: GeneratorProviderConfig;
+    output: GeneratorOutputConfig;
+    naming: GeneratorNamingConfig;
+    features: GeneratorFeatureFlags;
+    experimental: GeneratorExperimentalFlags;
+}
+/**
+ * Config loader options for CLI/programmatic usage.
+ */
+interface LoadGeneratorConfigOptions {
+    cwd?: string;
+    configPath?: string;
+}
+/**
+ * Fully loaded config result including resolved file path.
+ */
+interface LoadedGeneratorConfig {
+    configPath: string;
+    config: NormalizedAthenaGeneratorConfig;
+}
+type GeneratorArtifactKind = 'model' | 'schema' | 'database' | 'registry';
+/**
+ * One generated output file.
+ */
+interface GeneratedArtifact {
+    kind: GeneratorArtifactKind;
+    path: string;
+    content: string;
+}
+/**
+ * In-memory generator output payload.
+ */
+interface GeneratedArtifacts {
+    snapshot: IntrospectionSnapshot;
+    files: GeneratedArtifact[];
+}
+/**
+ * Runtime options for executing the generator pipeline.
+ */
+interface RunGeneratorOptions {
+    cwd?: string;
+    configPath?: string;
+    dryRun?: boolean;
+    provider?: SchemaIntrospectionProvider;
+}
+/**
+ * Generator execution result including files written to disk.
+ */
+interface RunGeneratorResult extends GeneratedArtifacts {
+    configPath: string;
+    writtenFiles: string[];
+}
+
+/**
+ * End-to-end generator execution: load config, introspect, render, and optionally write files.
+ */
+declare function runSchemaGenerator(options?: RunGeneratorOptions): Promise<RunGeneratorResult>;
+
+export { type AthenaGeneratorConfig as A, type GeneratedArtifacts as G, type LoadGeneratorConfigOptions as L, type NormalizedAthenaGeneratorConfig as N, type RunGeneratorOptions as R, type LoadedGeneratorConfig as a, type GeneratorProviderConfig as b, type GeneratorExperimentalFlags as c, type GeneratorSchemaSelection as d, type GeneratedArtifact as e, type GeneratorArtifactKind as f, type GeneratorFeatureFlags as g, type GeneratorNamingConfig as h, type GeneratorOutputConfig as i, type GeneratorOutputTargets as j, type NamingStyle as k, type RunGeneratorResult as l, runSchemaGenerator as r };

package/dist/pipeline-CQgV-Yfo.d.ts

@@ -0,0 +1,164 @@
+import { a as BackendType, p as IntrospectionSnapshot, o as SchemaIntrospectionProvider } from './types-BnzoaNRC.js';
+
+/**
+ * Supported case transformations for generated symbols and path token variants.
+ */
+type NamingStyle = 'preserve' | 'camel' | 'pascal' | 'snake' | 'kebab';
+/**
+ * Naming configuration for generated TypeScript identifiers.
+ */
+interface GeneratorNamingConfig {
+    modelType: NamingStyle;
+    modelConst: NamingStyle;
+    schemaConst: NamingStyle;
+    databaseConst: NamingStyle;
+    registryConst: NamingStyle;
+}
+/**
+ * Stable feature flags for generator output behavior.
+ */
+interface GeneratorFeatureFlags {
+    emitRelations: boolean;
+    emitRegistry: boolean;
+}
+/**
+ * Experimental toggles for optional/forward-compatible generator behavior.
+ */
+interface GeneratorExperimentalFlags {
+    /**
+     * Legacy compatibility toggle from the initial scaffold.
+     * Gateway introspection is now implemented; this flag is retained for additive config compatibility.
+     */
+    postgresGatewayIntrospection: boolean;
+    /**
+     * Enables contract placeholders for future Scylla provider work.
+     */
+    scyllaProviderContracts: boolean;
+}
+/**
+ * Path templates for each generated artifact category.
+ */
+interface GeneratorOutputTargets {
+    model: string;
+    schema: string;
+    database: string;
+    registry: string;
+}
+/**
+ * Output configuration including dynamic placeholder aliases.
+ */
+interface GeneratorOutputConfig {
+    targets: GeneratorOutputTargets;
+    placeholderMap: Record<string, string>;
+}
+/**
+ * Schemas selected for PostgreSQL introspection. Strings may be comma-separated
+ * to support env-driven configs such as `process.env.GENERATOR_SCHEMAS`.
+ */
+type GeneratorSchemaSelection = string | readonly string[];
+/**
+ * Direct PostgreSQL introspection mode (implemented).
+ */
+interface PostgresDirectProviderConfig {
+    kind: 'postgres';
+    mode: 'direct';
+    connectionString: string;
+    database?: string;
+    schemas?: GeneratorSchemaSelection;
+}
+/**
+ * Athena gateway-backed PostgreSQL introspection mode using `/gateway/query`.
+ */
+interface PostgresGatewayProviderConfig {
+    kind: 'postgres';
+    mode: 'gateway';
+    gatewayUrl: string;
+    apiKey: string;
+    database: string;
+    schemas?: GeneratorSchemaSelection;
+    backend?: BackendType;
+}
+/**
+ * Scylla introspection provider contract placeholder (phase-two scaffold).
+ */
+interface ScyllaDirectProviderConfig {
+    kind: 'scylla';
+    mode: 'direct';
+    contactPoints: string[];
+    keyspace: string;
+    datacenter?: string;
+}
+type GeneratorProviderConfig = PostgresDirectProviderConfig | PostgresGatewayProviderConfig | ScyllaDirectProviderConfig;
+/**
+ * Root config contract loaded from `athena.config.ts`.
+ */
+interface AthenaGeneratorConfig {
+    provider: GeneratorProviderConfig;
+    output: GeneratorOutputConfig;
+    naming?: Partial<GeneratorNamingConfig>;
+    features?: Partial<GeneratorFeatureFlags>;
+    experimental?: Partial<GeneratorExperimentalFlags>;
+}
+/**
+ * Normalized generator config with defaults applied.
+ */
+interface NormalizedAthenaGeneratorConfig {
+    provider: GeneratorProviderConfig;
+    output: GeneratorOutputConfig;
+    naming: GeneratorNamingConfig;
+    features: GeneratorFeatureFlags;
+    experimental: GeneratorExperimentalFlags;
+}
+/**
+ * Config loader options for CLI/programmatic usage.
+ */
+interface LoadGeneratorConfigOptions {
+    cwd?: string;
+    configPath?: string;
+}
+/**
+ * Fully loaded config result including resolved file path.
+ */
+interface LoadedGeneratorConfig {
+    configPath: string;
+    config: NormalizedAthenaGeneratorConfig;
+}
+type GeneratorArtifactKind = 'model' | 'schema' | 'database' | 'registry';
+/**
+ * One generated output file.
+ */
+interface GeneratedArtifact {
+    kind: GeneratorArtifactKind;
+    path: string;
+    content: string;
+}
+/**
+ * In-memory generator output payload.
+ */
+interface GeneratedArtifacts {
+    snapshot: IntrospectionSnapshot;
+    files: GeneratedArtifact[];
+}
+/**
+ * Runtime options for executing the generator pipeline.
+ */
+interface RunGeneratorOptions {
+    cwd?: string;
+    configPath?: string;
+    dryRun?: boolean;
+    provider?: SchemaIntrospectionProvider;
+}
+/**
+ * Generator execution result including files written to disk.
+ */
+interface RunGeneratorResult extends GeneratedArtifacts {
+    configPath: string;
+    writtenFiles: string[];
+}
+
+/**
+ * End-to-end generator execution: load config, introspect, render, and optionally write files.
+ */
+declare function runSchemaGenerator(options?: RunGeneratorOptions): Promise<RunGeneratorResult>;
+
+export { type AthenaGeneratorConfig as A, type GeneratedArtifacts as G, type LoadGeneratorConfigOptions as L, type NormalizedAthenaGeneratorConfig as N, type RunGeneratorOptions as R, type LoadedGeneratorConfig as a, type GeneratorProviderConfig as b, type GeneratorExperimentalFlags as c, type GeneratorSchemaSelection as d, type GeneratedArtifact as e, type GeneratorArtifactKind as f, type GeneratorFeatureFlags as g, type GeneratorNamingConfig as h, type GeneratorOutputConfig as i, type GeneratorOutputTargets as j, type NamingStyle as k, type RunGeneratorResult as l, runSchemaGenerator as r };

package/dist/react.cjs

@@ -1493,16 +1493,173 @@ function useMutation(options) {
     lastRequest: snapshot.lastRequest
   };
 }
+function resolveGetSession(authClient) {
+  if ("getSession" in authClient && typeof authClient.getSession === "function") {
+    return authClient.getSession;
+  }
+  if ("auth" in authClient && authClient.auth && typeof authClient.auth.getSession === "function") {
+    return authClient.auth.getSession;
+  }
+  throw new Error("useSession requires an auth-capable client (createClient(...).auth or createAuthClient(...))");
+}
+function useSession(authClient, options = {}) {
+  const enabled = options.enabled ?? true;
+  const refetchOnMount = options.refetchOnMount ?? true;
+  const [data, setData] = react.useState(null);
+  const [error, setError] = react.useState(null);
+  const [isPending, setIsPending] = react.useState(enabled);
+  const [isRefetching, setIsRefetching] = react.useState(false);
+  const requestIdRef = react.useRef(0);
+  const mountedRef = react.useRef(true);
+  const dataRef = react.useRef(null);
+  const getSession = resolveGetSession(
+    authClient
+  );
+  react.useEffect(() => {
+    dataRef.current = data;
+  }, [data]);
+  const toFallbackErrorDetails = (code, message, status) => ({
+    code,
+    message,
+    status
+  });
+  const runFetch = react.useCallback(async () => {
+    const requestId = ++requestIdRef.current;
+    const hasData = dataRef.current !== null;
+    if (hasData) {
+      setIsRefetching(true);
+    } else {
+      setIsPending(true);
+    }
+    try {
+      const result = await getSession(options.fetchInput, options.callOptions);
+      if (!mountedRef.current || requestId !== requestIdRef.current) {
+        return null;
+      }
+      if (result.ok) {
+        setData(result.data ?? null);
+        setError(null);
+        return result.data ?? null;
+      }
+      setError(
+        result.errorDetails ?? toFallbackErrorDetails(
+          "UNKNOWN_ERROR",
+          result.error ?? "Failed to fetch session",
+          result.status
+        )
+      );
+      return null;
+    } catch (requestError) {
+      if (!mountedRef.current || requestId !== requestIdRef.current) {
+        return null;
+      }
+      const message = requestError instanceof Error ? requestError.message : "Failed to fetch session";
+      setError(toFallbackErrorDetails("NETWORK_ERROR", message, 0));
+      return null;
+    } finally {
+      if (mountedRef.current && requestId === requestIdRef.current) {
+        setIsPending(false);
+        setIsRefetching(false);
+      }
+    }
+  }, [getSession, options.callOptions, options.fetchInput]);
+  react.useEffect(() => {
+    mountedRef.current = true;
+    if (enabled && refetchOnMount) {
+      void runFetch();
+    } else {
+      setIsPending(false);
+    }
+    return () => {
+      mountedRef.current = false;
+    };
+  }, [enabled, refetchOnMount, runFetch]);
+  const refetch = react.useCallback(async () => {
+    return await runFetch();
+  }, [runFetch]);
+  return {
+    data,
+    error,
+    isPending,
+    isRefetching,
+    refetch
+  };
+}
+
+// src/schema/model-form.ts
+function resolveNullishValue(mode) {
+  if (mode === "undefined") return void 0;
+  if (mode === "null") return null;
+  return "";
+}
+function isRecord3(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isNullableColumn(model, key) {
+  const nullable = model.meta.nullable;
+  return nullable?.[key] === true;
+}
+function toModelFormDefaults(model, values, options) {
+  const source = values;
+  if (!isRecord3(source)) {
+    return {};
+  }
+  const mode = options?.nullishMode ?? "empty-string";
+  const nullishValue = resolveNullishValue(mode);
+  const result = {};
+  for (const [key, value] of Object.entries(source)) {
+    if (value === null && isNullableColumn(model, key)) {
+      result[key] = nullishValue;
+      continue;
+    }
+    result[key] = value;
+  }
+  return result;
+}
+function toModelPayload(model, formValues, options) {
+  const emptyStringAsNull = options?.emptyStringAsNull ?? true;
+  const stripUndefined = options?.stripUndefined ?? true;
+  const result = {};
+  for (const [key, rawValue] of Object.entries(formValues)) {
+    if (rawValue === void 0 && stripUndefined) {
+      continue;
+    }
+    if (emptyStringAsNull && rawValue === "" && isNullableColumn(model, key)) {
+      result[key] = null;
+      continue;
+    }
+    result[key] = rawValue;
+  }
+  return result;
+}
+function createModelFormAdapter(model) {
+  return {
+    model,
+    toDefaults(values, options) {
+      return toModelFormDefaults(model, values, options);
+    },
+    toInsert(values, options) {
+      return toModelPayload(model, values, options);
+    },
+    toUpdate(values, options) {
+      return toModelPayload(model, values, options);
+    }
+  };
+}
 
 exports.AthenaGatewayError = AthenaGatewayError;
 exports.AthenaQueryClient = AthenaQueryClient;
 exports.AthenaQueryClientProvider = AthenaQueryClientProvider;
 exports.attachStateAdapter = attachStateAdapter;
 exports.createAthenaQueryClient = createAthenaQueryClient;
+exports.createModelFormAdapter = createModelFormAdapter;
 exports.isAthenaGatewayError = isAthenaGatewayError;
+exports.toModelFormDefaults = toModelFormDefaults;
+exports.toModelPayload = toModelPayload;
 exports.useAthenaGateway = useAthenaGateway;
 exports.useAthenaQueryClient = useAthenaQueryClient;
 exports.useMutation = useMutation;
 exports.useQuery = useQuery;
+exports.useSession = useSession;
 //# sourceMappingURL=react.cjs.map
 //# sourceMappingURL=react.cjs.map