@credibledata/cred-cli 0.0.103 → 0.0.105

package/src/commands/materialization/listindexes.ts

@@ -1,69 +0,0 @@
-import { IndexesApi } from "../../client/api";
-import { Configuration } from "../../client/configuration";
-import { ClientConfiguration } from "../../clientconfiguration";
-import { logger } from "../../logger";
-import {
-   prettifyJson,
-   printOutError,
-   parsePaginationParams,
-   extractTotalCount,
-} from "../../utils";
-
-const indexesApi = new IndexesApi(new Configuration());
-
-/**
- * List the dimensional search indexes bound to a package version (the per-`#(index)`
- * serving anchors). Each entry prints its `status` and, when FAILED, the `error`;
- * plus the serving `rowCount`, `lastIndexedAt`, freshness policy, and the
- * `stale`/`staleReasons` triple — so a failing or stale index is diagnosable
- * from the CLI. The total available count is logged to stderr.
- */
-export async function listIndexes(
-   controlPlane: string,
-   packagePath: string,
-   versionId: string,
-   debug: boolean,
-   page?: string | number,
-   pageSize?: string | number,
-) {
-   const clientConfig = new ClientConfiguration();
-   const organizationName = clientConfig.getOrganization();
-   const environmentName = clientConfig.getProject();
-
-   if (!clientConfig.doesConfigExists()) {
-      logger.error("Please, make sure that you are logged in");
-      return;
-   }
-
-   if (!environmentName) {
-      logger.error("Please, make sure to set an environment");
-      return;
-   }
-
-   try {
-      const packageName = packagePath.replace("/", "");
-      const { limit, offset } = parsePaginationParams(page, pageSize);
-      const response = await indexesApi.listIndexes(
-         organizationName,
-         environmentName,
-         packageName,
-         versionId,
-         limit,
-         offset,
-         {
-            baseURL: controlPlane,
-            headers: clientConfig.getHeaders(),
-         },
-      );
-
-      const totalCount = extractTotalCount(response.headers);
-      if (totalCount !== undefined) {
-         logger.info(`Total indexes available: ${totalCount}`);
-      }
-
-      console.log(prettifyJson(response.data));
-   } catch (e) {
-      logger.error("Failed to list indexes");
-      printOutError(e, debug);
-   }
-}

package/src/commands/materialization/listmaterializations.ts

@@ -1,53 +0,0 @@
-import { MaterializationsApi } from "../../client/api";
-import { Configuration } from "../../client/configuration";
-import { ClientConfiguration } from "../../clientconfiguration";
-import { logger } from "../../logger";
-import { prettifyJson, printOutError } from "../../utils";
-
-const materializationsApi = new MaterializationsApi(new Configuration());
-
-/**
- * List the Malloy Persistence materializations bound to a package version.
- * Each materialization prints its `status` and, when FAILED, the `error`
- * explaining why the build failed (e.g. a warehouse permission denial) — so a
- * failing materialization is diagnosable from the CLI without opening the app.
- */
-export async function listMaterializations(
-   controlPlane: string,
-   packagePath: string,
-   versionId: string,
-   debug: boolean,
-) {
-   const clientConfig = new ClientConfiguration();
-   const organizationName = clientConfig.getOrganization();
-   const environmentName = clientConfig.getProject();
-
-   if (!clientConfig.doesConfigExists()) {
-      logger.error("Please, make sure that you are logged in");
-      return;
-   }
-
-   if (!environmentName) {
-      logger.error("Please, make sure to set an environment");
-      return;
-   }
-
-   try {
-      const packageName = packagePath.replace("/", "");
-      const response = await materializationsApi.listMaterializations(
-         organizationName,
-         environmentName,
-         packageName,
-         versionId,
-         {
-            baseURL: controlPlane,
-            headers: clientConfig.getHeaders(),
-         },
-      );
-
-      console.log(prettifyJson(response.data));
-   } catch (e) {
-      logger.error("Failed to list materializations");
-      printOutError(e, debug);
-   }
-}

package/src/commands/materialization/listpreaggregates.ts

@@ -1,74 +0,0 @@
-import { PreaggregatesApi } from "../../client/api";
-import { Configuration } from "../../client/configuration";
-import { ClientConfiguration } from "../../clientconfiguration";
-import { logger } from "../../logger";
-import {
-   prettifyJson,
-   printOutError,
-   parsePaginationParams,
-   extractTotalCount,
-} from "../../utils";
-
-const preaggregatesApi = new PreaggregatesApi(new Configuration());
-
-/**
- * List the pre-aggregated measures of a package version (one entry per `#@ preaggregate`
- * measure). Each entry prints its `status` and, when FAILED, the `error`; plus the
- * `grainDimensions` it is rolled up to, the serving `rowCount`, `lastBuiltAt`, freshness
- * policy, and the `stale`/`staleReasons` triple. `--source` narrows to the measures of one
- * authored source. The total available count is logged to stderr.
- *
- * <p>One rollup table can serve several measures, so entries here outnumber the tables
- * behind them: the measure is what a modeler wrote, and it is the unit this lists.
- */
-export async function listPreaggregates(
-   controlPlane: string,
-   packagePath: string,
-   versionId: string,
-   sourceName: string | undefined,
-   debug: boolean,
-   page?: string | number,
-   pageSize?: string | number,
-) {
-   const clientConfig = new ClientConfiguration();
-   const organizationName = clientConfig.getOrganization();
-   const environmentName = clientConfig.getProject();
-
-   if (!clientConfig.doesConfigExists()) {
-      logger.error("Please, make sure that you are logged in");
-      return;
-   }
-
-   if (!environmentName) {
-      logger.error("Please, make sure to set an environment");
-      return;
-   }
-
-   try {
-      const packageName = packagePath.replace("/", "");
-      const { limit, offset } = parsePaginationParams(page, pageSize);
-      const response = await preaggregatesApi.listPreaggregates(
-         organizationName,
-         environmentName,
-         packageName,
-         versionId,
-         sourceName,
-         limit,
-         offset,
-         {
-            baseURL: controlPlane,
-            headers: clientConfig.getHeaders(),
-         },
-      );
-
-      const totalCount = extractTotalCount(response.headers);
-      if (totalCount !== undefined) {
-         logger.info(`Total pre-aggregations available: ${totalCount}`);
-      }
-
-      console.log(prettifyJson(response.data));
-   } catch (e) {
-      logger.error("Failed to list pre-aggregations");
-      printOutError(e, debug);
-   }
-}

package/src/commands/materialization/listruns.ts

@@ -1,77 +0,0 @@
-import { RunsApi } from "../../client/api";
-import { Configuration } from "../../client/configuration";
-import { ClientConfiguration } from "../../clientconfiguration";
-import { logger } from "../../logger";
-import {
-   prettifyJson,
-   printOutError,
-   parsePaginationParams,
-   extractTotalCount,
-} from "../../utils";
-
-const runsApi = new RunsApi(new Configuration());
-
-/**
- * List the build/refresh runs for a package (most recent first). Runs are one
- * package-scoped resource spanning both families — materialized sources and
- * dimensional indexes. Optional filters narrow the list: `versionId` limits to
- * the runs that impacted a version; `sourceName`/`dimension`/`measure` limit to runs
- * targeting a specific unit (Phase C per-unit dispatch). Each run prints its
- * `status`, `trigger`, `buildNumber`, target scope, and, when failed, its
- * `error`. The per-unit build-plan graph is available via `cred get run`.
- */
-export async function listRuns(
-   controlPlane: string,
-   packagePath: string,
-   versionId: string | undefined,
-   debug: boolean,
-   sourceName?: string,
-   dimension?: string,
-   measure?: string,
-   page?: string | number,
-   pageSize?: string | number,
-) {
-   const clientConfig = new ClientConfiguration();
-   const organizationName = clientConfig.getOrganization();
-   const environmentName = clientConfig.getProject();
-
-   if (!clientConfig.doesConfigExists()) {
-      logger.error("Please, make sure that you are logged in");
-      return;
-   }
-
-   if (!environmentName) {
-      logger.error("Please, make sure to set an environment");
-      return;
-   }
-
-   try {
-      const packageName = packagePath.replace("/", "");
-      const { limit, offset } = parsePaginationParams(page, pageSize);
-      const response = await runsApi.listRuns(
-         organizationName,
-         environmentName,
-         packageName,
-         versionId,
-         sourceName,
-         measure,
-         dimension,
-         limit,
-         offset,
-         {
-            baseURL: controlPlane,
-            headers: clientConfig.getHeaders(),
-         },
-      );
-
-      const totalCount = extractTotalCount(response.headers);
-      if (totalCount !== undefined) {
-         logger.info(`Total runs available: ${totalCount}`);
-      }
-
-      console.log(prettifyJson(response.data));
-   } catch (e) {
-      logger.error("Failed to list runs");
-      printOutError(e, debug);
-   }
-}

package/src/commands/materialization/rerun.ts

@@ -1,123 +0,0 @@
-import { RunsApi, CreateRunRequest } from "../../client/api";
-import { Configuration } from "../../client/configuration";
-import { ClientConfiguration } from "../../clientconfiguration";
-import { logger } from "../../logger";
-import { getConfirmation, prettifyJson, printOutError } from "../../utils";
-
-const runsApi = new RunsApi(new Configuration());
-
-export interface RerunScope {
-   source?: string;
-   dimension?: string;
-   measure?: string;
-   modelFile?: string;
-   includeUpstream?: boolean;
-}
-
-/**
- * Trigger an on-demand run (rebuild/refresh) for a package version. With no
- * scope selectors this is a full run: re-materialize every persist source and
- * rebuild every indexed dimension. The optional `--source` / `--dimension` /
- * `--measure` / `--model-file` selectors narrow it to a single unit (Phase C
- * per-unit dispatch); `--measure` rebuilds the rollup serving that
- * pre-aggregated measure, and fails when the measure is declared at more than
- * one grain (pass `--source` to disambiguate); `--include-upstream` additionally force-rebuilds the target's
- * upstream persisted closure. Prints the started run (poll it with
- * `cred get run <package> <runId>`).
- */
-export async function rerun(
-   controlPlane: string,
-   packagePath: string,
-   versionId: string,
-   scope: RerunScope,
-   debug: boolean,
-   autoConfirm: boolean,
-) {
-   const clientConfig = new ClientConfiguration();
-   const organizationName = clientConfig.getOrganization();
-   const environmentName = clientConfig.getProject();
-
-   if (!clientConfig.doesConfigExists()) {
-      logger.error("Please, make sure that you are logged in");
-      return;
-   }
-
-   if (!environmentName) {
-      logger.error("Please, make sure to set an environment");
-      return;
-   }
-
-   if (!versionId) {
-      logger.error("Please provide a version ID");
-      return;
-   }
-
-   // Caught here rather than at the server so the message can name the flags. A
-   // source may carry a dimension and a measure of the same name, so which one
-   // you pass decides what gets rebuilt — there is no safe default.
-   if (scope.dimension && scope.measure) {
-      logger.error(
-         "--dimension and --measure both narrow a run to one field; pass only one",
-      );
-      return;
-   }
-
-   const packageName = packagePath.replace("/", "");
-
-   const request: CreateRunRequest = { versionId };
-   if (scope.source) request.sourceName = scope.source;
-   if (scope.dimension) request.dimension = scope.dimension;
-   if (scope.measure) request.measure = scope.measure;
-   if (scope.modelFile) request.modelFilePath = scope.modelFile;
-   if (scope.includeUpstream) request.includeUpstream = true;
-
-   const targetLabel = describeScope(scope);
-
-   if (!autoConfirm) {
-      const confirmation = await getConfirmation(
-         `Trigger a run for ${packageName}/${versionId} (${targetLabel})?`,
-      );
-      if (!confirmation) {
-         return;
-      }
-   }
-
-   logger.info(`Starting run for ${packageName}/${versionId} (${targetLabel})`);
-   try {
-      const response = await runsApi.createRun(
-         organizationName,
-         environmentName,
-         packageName,
-         request,
-         {
-            baseURL: controlPlane,
-            headers: clientConfig.getHeaders(),
-         },
-      );
-
-      console.log(prettifyJson(response.data));
-   } catch (e) {
-      logger.error("Failed to start run");
-      printOutError(e, debug);
-   }
-}
-
-function describeScope(scope: RerunScope): string {
-   const parts: string[] = [];
-   if (scope.source) parts.push(`source=${scope.source}`);
-   if (scope.dimension) parts.push(`dimension=${scope.dimension}`);
-   if (scope.measure) parts.push(`measure=${scope.measure}`);
-   if (scope.modelFile) parts.push(`modelFile=${scope.modelFile}`);
-   if (parts.length === 0) {
-      return "full run — all sources, indexes and pre-aggregations";
-   }
-   if (scope.includeUpstream) parts.push("includeUpstream");
-   const scoped = `scoped: ${parts.join(", ")}`;
-   // A measure names a COLUMN in a rollup table, and the whole table is what
-   // gets rebuilt — so `measure=revenue` alone understates what the caller is
-   // agreeing to. This string is the confirmation prompt, so the sibling
-   // measures have to be named as consequences before the y/n, not after.
-   return scope.measure
-      ? `${scoped} — rebuilds the measure's whole rollup table, and so every measure declared at the same grain`
-      : scoped;
-}