cube-js/cube · error · Error

TranspileJs native implementation not found!

Error message

TranspileJs native implementation not found!

What it means

Capability guard in transpileJs (cubejs-backend-native): the loaded native extension exists but does not export a transpileJs implementation. This occurs with the fallback (pure-JS) build of the native module, which lacks the JS-model transpilation entry point.

Source

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

 * @param transformDataArr Array of data needed to transform raw query results
 * @param rows Array of raw data received from the source DB via driver or reference to native CubeStore response results
 * @param responseData Final combined query result structure without actual data
 * @return {Promise<ArrayBuffer>} ArrayBuffer with json-serialized data which should be directly sent to the client
 */
export const getFinalQueryResultMulti = (transformDataArr: Object[], rows: any[], responseData: Object): Promise<ArrayBuffer> => {
  const native = loadNative();

  return native.getFinalQueryResultMulti(transformDataArr, rows, responseData);
};

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>

View on GitHub (pinned to 7d981676b3)

Solutions

1. Install a platform-specific native build of cubejs-backend-native instead of the fallback build.
2. Check the supported architectures/platforms section of the package README and match your deployment image.
3. Upgrade the package — newer releases ship prebuilt binaries for more platforms.

When it happens

Trigger: Thrown at packages/cubejs-backend-native/js/index.ts:517 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/596318f50d5a58e9. Report an issue: GitHub.