@gscdump/engine 1.4.0 → 1.4.1

package/dist/_chunks/errors.d.mts

@@ -1,115 +0,0 @@
-type EngineErrorKind = 'analyzer-not-found' | 'analyzer-capability-missing' | 'invalid-sql-literal' | 'placeholder-arity-mismatch' | 'invalid-search-types' | 'attached-table-missing' | 'manifest-cas-exhausted' | 'invalid-snapshot-filename' | 'unsupported-snapshot-index-version' | 'invalid-schema-identifier' | 'invalid-year-month' | 'missing-attach-url' | 'manifest-cas-round-lost' | 'iceberg-table-op-failed' | 'sink-table-flush-failed' | 'rollup-build-failed' | 'lock-acquire-timeout';
-type EngineError = {
-  kind: 'analyzer-not-found';
-  tool: string;
-  message: string;
-} | {
-  kind: 'analyzer-capability-missing';
-  tool: string;
-  missing: readonly string[];
-  message: string;
-} | {
-  kind: 'invalid-sql-literal';
-  message: string;
-} | {
-  kind: 'placeholder-arity-mismatch';
-  message: string;
-} | {
-  kind: 'invalid-search-types';
-  message: string;
-  cause?: unknown;
-} | {
-  kind: 'attached-table-missing';
-  missing: readonly string[];
-  message: string;
-} | {
-  kind: 'manifest-cas-exhausted';
-  message: string;
-  siteId: string;
-  table: string;
-  attempts: number;
-} | {
-  kind: 'invalid-snapshot-filename';
-  message: string;
-  fileName: string;
-} | {
-  kind: 'unsupported-snapshot-index-version';
-  message: string;
-  version: unknown;
-} | {
-  kind: 'invalid-schema-identifier';
-  message: string;
-  schema: string;
-} | {
-  kind: 'invalid-year-month';
-  message: string;
-  value: string;
-} | {
-  kind: 'missing-attach-url';
-  message: string;
-  fileName: string;
-} | {
-  kind: 'manifest-cas-round-lost';
-  message: string;
-  siteId: string;
-  table: string;
-  attempt: number;
-} | {
-  kind: 'iceberg-table-op-failed';
-  message: string;
-  op: 'create' | 'drop';
-  table: string;
-  cause?: unknown;
-} | {
-  kind: 'sink-table-flush-failed';
-  message: string;
-  table: string;
-  cause?: unknown;
-} | {
-  kind: 'rollup-build-failed';
-  message: string;
-  id: string;
-  cause?: unknown;
-} | {
-  kind: 'lock-acquire-timeout';
-  message: string;
-  scope: string;
-  timeoutMs: number;
-};
-declare const engineErrors: {
-  readonly analyzerNotFound: (tool: string) => EngineError;
-  readonly analyzerCapabilityMissing: (tool: string, missing: readonly string[]) => EngineError;
-  readonly nonFiniteNumberLiteral: (value: number) => EngineError;
-  readonly controlCharsInLiteral: () => EngineError;
-  readonly uninlinableLiteralType: (type: string) => EngineError;
-  readonly morePlaceholdersThanParams: (have: number) => EngineError;
-  readonly dollarPlaceholderOutOfRange: (n: number, have: number) => EngineError;
-  readonly mixedPlaceholderStyles: () => EngineError;
-  readonly unusedParams: (unused: number) => EngineError;
-  readonly searchTypesNotArray: () => EngineError;
-  readonly unknownSearchType: (value: unknown) => EngineError;
-  readonly searchTypesMissingWeb: () => EngineError;
-  readonly attachedTableMissing: (missing: readonly string[]) => EngineError;
-  readonly manifestCasExhausted: (siteId: string, table: string, attempts: number) => EngineError;
-  readonly invalidSnapshotFilename: (fileName: string) => EngineError;
-  readonly unsupportedSnapshotIndexVersion: (version: unknown) => EngineError;
-  readonly invalidSchemaIdentifier: (schema: string) => EngineError;
-  readonly invalidYearMonth: (value: string) => EngineError;
-  readonly missingAttachUrl: (fileName: string) => EngineError;
-  readonly manifestCasRoundLost: (siteId: string, table: string, attempt: number) => EngineError;
-  readonly icebergTableOpFailed: (op: 'create' | 'drop', table: string, cause: unknown) => EngineError;
-  readonly sinkTableFlushFailed: (table: string, cause: unknown) => EngineError;
-  readonly rollupBuildFailed: (id: string, cause: unknown) => EngineError;
-  readonly lockAcquireTimeout: (scope: string, timeoutMs: number) => EngineError;
-};
-declare function isEngineError(value: unknown): value is EngineError;
-/**
- * Re-raises an `EngineError` value as a generic `Error`, stashing the union under
- * `.engineError` for stack-walking. Used by the throwing wrappers over the
- * `Result`-returning cores whose original throws were bare `Error`s (the SQL
- * binder, sync-config). Modules that historically threw a *named* class
- * (`AnalyzerCapabilityError`, `AttachedTableMissingError`) provide their own
- * mapper so the class identity callers match on is preserved.
- */
-declare function engineErrorToException(error: EngineError): Error;
-export { EngineError, EngineErrorKind, engineErrorToException, engineErrors, isEngineError };

package/dist/_chunks/index.d.mts

@@ -1,53 +0,0 @@
-import { AnalysisParams } from "./analysis-types.mjs";
-type WindowPreset = 'last-7d' | 'last-28d' | 'last-30d' | 'last-90d' | 'last-180d' | 'last-365d' | 'mtd' | 'ytd' | 'custom';
-type ComparisonMode = 'none' | 'prev-period' | 'yoy';
-interface ResolveWindowOptions {
-  preset: WindowPreset;
-  comparison?: ComparisonMode;
-  anchor?: string;
-  start?: string;
-  end?: string;
-}
-interface ResolvedWindow {
-  start: string;
-  end: string;
-  days: number;
-  comparison?: {
-    start: string;
-    end: string;
-  };
-}
-interface AnalysisPeriod {
-  startDate: string;
-  endDate: string;
-}
-interface ComparisonPeriod {
-  current: AnalysisPeriod;
-  previous: AnalysisPeriod;
-}
-declare function defaultEndDate(): string;
-declare function periodOf(params: AnalysisParams): AnalysisPeriod;
-declare function comparisonOf(params: AnalysisParams): ComparisonPeriod;
-declare function resolveWindow(opts: ResolveWindowOptions): ResolvedWindow;
-interface PadTimeseriesOptions<T> {
-  /** ISO date (YYYY-MM-DD), inclusive lower bound. */
-  startDate: string;
-  /** ISO date (YYYY-MM-DD), inclusive upper bound. */
-  endDate: string;
-  /**
-   * Row to insert for missing dates. Defaults to `{ clicks: 0, impressions: 0, ctr: 0, position: 0 }`.
-   * The `date` field is set automatically.
-   */
-  fill?: Omit<T, 'date'>;
-  /** Row-field that carries the ISO date. Defaults to `date`. */
-  dateKey?: string;
-}
-type DateRowShape = Record<string, unknown> & {
-  date?: unknown;
-};
-/**
- * Pad rows so every calendar day in `[startDate, endDate]` appears at least
- * once. Existing dates keep all their rows (grouped timeseries safe).
- */
-declare function padTimeseries<T extends DateRowShape = DateRowShape>(rows: readonly T[], options: PadTimeseriesOptions<T>): T[];
-export { AnalysisPeriod, ComparisonMode, ComparisonPeriod, PadTimeseriesOptions, ResolveWindowOptions, ResolvedWindow, WindowPreset, comparisonOf, defaultEndDate, padTimeseries, periodOf, resolveWindow };