@soda-gql/babel-transformer 0.2.0

package/dist/index.d.mts

@@ -0,0 +1,205 @@
+import { GqlCallFragment, GqlCallOperation, GqlDefinitionMetadata, PluginError } from "@soda-gql/plugin-common";
+import { Result } from "neverthrow";
+import * as t from "@babel/types";
+import { Expression } from "@babel/types";
+import { types as types$1 } from "@babel/core";
+import { CanonicalId, createCanonicalTracker } from "@soda-gql/common";
+import { NodePath } from "@babel/traverse";
+import { BuilderArtifact, BuilderArtifactElement, GraphqlSystemIdentifyHelper } from "@soda-gql/builder";
+import { ResolvedSodaGqlConfig } from "@soda-gql/config";
+
+//#region packages/babel-transformer/src/ast/metadata.d.ts
+type GqlDefinitionMetadataMap = WeakMap<types$1.CallExpression, GqlDefinitionMetadata>;
+type CanonicalTrackerFactory = typeof createCanonicalTracker;
+type CollectArgs = {
+  readonly programPath: NodePath<types$1.Program>;
+  readonly filename: string;
+  readonly createTracker?: CanonicalTrackerFactory;
+};
+declare const collectGqlDefinitionMetadata: ({
+  programPath,
+  filename,
+  createTracker
+}: CollectArgs) => GqlDefinitionMetadataMap;
+//#endregion
+//#region packages/babel-transformer/src/ast/analysis.d.ts
+type ArtifactLookup = (canonicalId: CanonicalId) => BuilderArtifactElement | undefined;
+type BabelGqlCallFragment = GqlCallFragment & {
+  readonly nodePath: NodePath<types$1.CallExpression>;
+};
+type BabelGqlCallOperation = GqlCallOperation & {
+  readonly nodePath: NodePath<types$1.CallExpression>;
+};
+type BabelGqlCall = BabelGqlCallFragment | BabelGqlCallOperation;
+type ExtractGqlCallArgs = {
+  readonly nodePath: NodePath<types$1.CallExpression>;
+  readonly filename: string;
+  readonly metadata: GqlDefinitionMetadataMap;
+  readonly getArtifact: ArtifactLookup;
+};
+declare const extractGqlCall: ({
+  nodePath,
+  filename,
+  metadata,
+  getArtifact
+}: ExtractGqlCallArgs) => Result<BabelGqlCall, PluginError>;
+//#endregion
+//#region packages/babel-transformer/src/ast/ast.d.ts
+declare const buildLiteralFromValue: (value: unknown) => Result<Expression, PluginError>;
+declare const clone: <T extends t.Node>(node: T) => T;
+declare const cloneCallExpression: (node: t.CallExpression) => t.CallExpression;
+declare const stripTypeAnnotations: (node: t.Node) => void;
+declare const buildObjectExpression: <K extends string>(properties: Record<K, t.Expression | t.PatternLike>) => t.ObjectExpression;
+//#endregion
+//#region packages/babel-transformer/src/ast/imports.d.ts
+/**
+ * Ensure that the gqlRuntime require exists in the program for CJS output.
+ * Injects: const __soda_gql_runtime = require("@soda-gql/runtime");
+ */
+declare const ensureGqlRuntimeRequire: (programPath: NodePath<types$1.Program>) => void;
+/**
+ * Ensure that the gqlRuntime import exists in the program.
+ * gqlRuntime is always imported from @soda-gql/runtime.
+ */
+declare const ensureGqlRuntimeImport: (programPath: NodePath<types$1.Program>) => void;
+/**
+ * Remove the graphql-system import (runtimeModule) and gql-related exports from the program.
+ * After transformation, gqlRuntime is imported from @soda-gql/runtime instead,
+ * so the original graphql-system import should be completely removed.
+ *
+ * This handles both ESM imports and CommonJS require() statements.
+ */
+declare const removeGraphqlSystemImports: (programPath: NodePath<types$1.Program>, graphqlSystemIdentifyHelper: GraphqlSystemIdentifyHelper, filename: string) => void;
+//#endregion
+//#region packages/babel-transformer/src/ast/runtime.d.ts
+declare const buildFragmentRuntimeCall: ({
+  artifact
+}: BabelGqlCallFragment & {
+  filename: string;
+}) => Result<types$1.Expression, PluginError>;
+declare const buildOperationRuntimeComponents: ({
+  artifact
+}: BabelGqlCallOperation & {
+  filename: string;
+}) => Result<{
+  referenceCall: types$1.Expression;
+  runtimeCall: types$1.Expression;
+}, PluginError>;
+//#endregion
+//#region packages/babel-transformer/src/ast/transformer.d.ts
+type TransformCallExpressionArgs = {
+  readonly callPath: NodePath<types$1.CallExpression>;
+  readonly filename: string;
+  readonly metadata: GqlDefinitionMetadataMap;
+  readonly getArtifact: ArtifactLookup;
+};
+type TransformCallExpressionResult = {
+  readonly transformed: false;
+} | {
+  readonly transformed: true;
+  readonly runtimeCall?: types$1.Expression;
+};
+declare const transformCallExpression: ({
+  callPath,
+  filename,
+  metadata,
+  getArtifact
+}: TransformCallExpressionArgs) => Result<TransformCallExpressionResult, PluginError>;
+declare const insertRuntimeCalls: (programPath: NodePath<types$1.Program>, runtimeCalls: readonly types$1.Expression[]) => void;
+//#endregion
+//#region packages/babel-transformer/src/transform.d.ts
+/**
+ * Options for creating a transformer.
+ */
+type TransformOptions = {
+  /** Resolved soda-gql configuration */
+  config: ResolvedSodaGqlConfig;
+  /** Pre-built artifact from the builder */
+  artifact: BuilderArtifact;
+  /** Whether to generate source maps */
+  sourceMap?: boolean;
+};
+/**
+ * Input for the transform function.
+ */
+type TransformInput = {
+  /** Source code to transform */
+  sourceCode: string;
+  /** Path to the source file */
+  sourcePath: string;
+  /** Input source map from previous transformer (JSON string) */
+  inputSourceMap?: string;
+};
+/**
+ * Output from the transform function.
+ */
+type TransformOutput = {
+  /** Whether any transformation was performed */
+  transformed: boolean;
+  /** The transformed source code (or original if no transformation) */
+  sourceCode: string;
+  /** Source map JSON, if source map generation was enabled */
+  sourceMap?: string;
+};
+/**
+ * Transformer interface (matches swc-transformer).
+ */
+interface Transformer {
+  transform(input: TransformInput): TransformOutput;
+}
+/**
+ * Create a transformer instance.
+ *
+ * @param options - Transform options including config and artifact
+ * @returns A transformer that can transform source files
+ */
+declare const createBabelTransformer: (options: TransformOptions) => Transformer;
+/**
+ * Transform a single source file (one-shot).
+ *
+ * For transforming multiple files, use createBabelTransformer() to reuse the artifact.
+ *
+ * @param input - Transform input including source, path, artifact, and config
+ * @returns Transform output
+ */
+declare const transform: (input: TransformInput & {
+  artifact: BuilderArtifact;
+  config: ResolvedSodaGqlConfig;
+  sourceMap?: boolean;
+}) => TransformOutput;
+//#endregion
+//#region packages/babel-transformer/src/types.d.ts
+/**
+ * Context for transforming a program.
+ */
+type TransformProgramContext = {
+  readonly filename: string;
+  readonly artifactLookup: (id: CanonicalId) => BuilderArtifactElement | undefined;
+};
+/**
+ * Result of a transform pass.
+ */
+type TransformPassResult = {
+  readonly transformed: boolean;
+  readonly runtimeArtifacts?: ReadonlyArray<unknown>;
+};
+//#endregion
+//#region packages/babel-transformer/src/transformer.d.ts
+/**
+ * Creates a Babel transformer with a single transform() method.
+ * This matches the pattern used in the TypeScript plugin.
+ */
+declare const createTransformer: ({
+  programPath,
+  types,
+  config
+}: {
+  readonly programPath: NodePath<types$1.Program>;
+  readonly types: typeof types$1;
+  readonly config: ResolvedSodaGqlConfig;
+}) => {
+  transform: (context: TransformProgramContext) => TransformPassResult;
+};
+//#endregion
+export { ArtifactLookup, BabelGqlCall, BabelGqlCallFragment, BabelGqlCallOperation, ExtractGqlCallArgs, GqlDefinitionMetadataMap, type TransformInput, type TransformOptions, type TransformOutput, type TransformPassResult, type TransformProgramContext, type Transformer, buildFragmentRuntimeCall, buildLiteralFromValue, buildObjectExpression, buildOperationRuntimeComponents, clone, cloneCallExpression, collectGqlDefinitionMetadata, createBabelTransformer, createTransformer, ensureGqlRuntimeImport, ensureGqlRuntimeRequire, extractGqlCall, insertRuntimeCalls, removeGraphqlSystemImports, stripTypeAnnotations, transform, transformCallExpression };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/ast/metadata.ts","../src/ast/analysis.ts","../src/ast/ast.ts","../src/ast/imports.ts","../src/ast/runtime.ts","../src/ast/transformer.ts","../src/transform.ts","../src/types.ts","../src/transformer.ts"],"sourcesContent":[],"mappings":"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"}