cube-js/cube · error · Error

TranspileYaml native implementation not found!

Error message

TranspileYaml native implementation not found!

What it means

Capability guard in transpileYaml (cubejs-backend-native): the loaded native module lacks a transpileYaml export, so YAML data model transpilation is unavailable. This is the fallback-build path where the native binary was substituted with a stub without that function.

Source

Thrown at packages/cubejs-backend-native/js/index.ts:527

export const transpileJs = async (transpileRequests: TransformConfig[]): Promise<TransformResponse[]> => {
  const native = loadNative();

  if (native.transpileJs) {
    return native.transpileJs(transpileRequests);
  }

  throw new Error('TranspileJs native implementation not found!');
};

export const transpileYaml = async (transpileRequests: TransformConfig[]): Promise<TransformResponse[]> => {
  const native = loadNative();

  if (native.transpileYaml) {
    return native.transpileYaml(transpileRequests);
  }

  throw new Error('TranspileYaml native implementation not found!');
};

export interface PyConfiguration {
  repositoryFactory?: (ctx: unknown) => Promise<unknown>,
  logger?: (msg: string, params: Record<string, any>) => void,
  checkAuth?: (req: unknown, authorization: string) => Promise<{ 'security_context'?: unknown }>
  extendContext?: (req: unknown) => Promise<unknown>
  queryRewrite?: (query: unknown, ctx: unknown) => Promise<unknown>
  contextToApiScopes?: () => Promise<string[]>
  scheduledRefreshContexts?: (ctx: unknown) => Promise<string[]>
  scheduledRefreshTimeZones?: (ctx: unknown) => Promise<string[]>
  contextToGroups?: (ctx: unknown) => Promise<string[]>
}

function simplifyExpressRequest(req: ExpressRequest) {
  // Req is a large object, let's simplify it
  // Important: Dont pass circular references
  return {

View on GitHub (pinned to 7d981676b3)

Solutions

  1. Use a build of cubejs-backend-native that includes native transpileYaml support for your platform.
  2. If YAML models are not needed, avoid triggering YAML transpilation.
  3. Consult the package README on supported architectures and install the matching prebuilt binary.
Defensive patterns

Strategy: fallback

When it happens

Trigger: Thrown at packages/cubejs-backend-native/js/index.ts:527 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of cube-js/cube@7d981676b3 (2026-09-02). Data as JSON: /api/errors/837139b114ebe3dc. Report an issue: GitHub.