@fern-api/go-dynamic-snippets 1.49.5 → 1.49.7

package/dist/index.d.cts

@@ -27,6 +27,57 @@ declare class DynamicTypeInstantiationMapper {
     private convertLiteralToOptionalPrimitive;
     private convertDiscriminatedUnion;
     private getBaseFields;
+    /**
+     * Returns the wire values of the union base properties that the Go model generator drops as
+     * top-level struct fields when `dedupeUnionBaseProperties` is enabled — mirroring the model's
+     * `unionInheritedBasePropertyNames` so the snippet and the generated model dedupe an identical
+     * set.
+     *
+     * The decision has a language-agnostic core and a thin Go-specific widening, exactly as in the
+     * model:
+     *   - Core: the IR marks (in `DiscriminatedUnionType.inheritedBaseProperties`, the dynamic-IR
+     *     mirror of `UnionTypeDeclaration.inheritedBaseProperties`) the base properties every
+     *     `samePropertiesAsObject` variant redeclares with a structurally-equal type. This is the
+     *     shared source of truth, so the decision is not re-derived per language.
+     *   - Go-render widening: Go additionally dedupes a base property that every variant redeclares
+     *     with a Go-RENDER-equivalent type (e.g. `list`/`set` both render `[]T`, `optional`/`nullable`
+     *     both `*T`) even though the IR's conservative structural equality left it unmarked; the
+     *     delegating getter still compiles, so the top-level field is safe to drop.
+     *
+     * Literal base properties are always kept at the union root (they render as `<Name>()` methods,
+     * not delegatable fields), matching the model. Base properties that a variant does not carry, or
+     * that a variant redeclares with a different Go getter type, keep their top-level field and must
+     * still be set at the union root, so they are excluded here.
+     *
+     * To stay in lockstep with the model, base<->variant properties are matched by Go field name (not
+     * wire value) via {@link getObjectExportedProperties}, and compared through
+     * {@link getGoGetterTypeString} — the single comparison primitive that renders a getter's Go type
+     * including the `getters-pass-by-value` `*`-stripping the model applies. Both the structural-core
+     * and the widening path route through it, so the two generators cannot drift.
+     */
+    private getDedupedBasePropertyWireValues;
+    /**
+     * Collects the properties an object exports, keyed by Go field name, following its `extends` chain
+     * (matching the model's `objectExportedProperties`). Extended properties are collected first so a
+     * property declared directly on the object overrides one inherited via `extends`, exactly as the
+     * model does. Empty for anything that does not resolve to an object.
+     */
+    private getObjectExportedProperties;
+    /**
+     * Renders the Go type a getter for `typeReference` would return, so two references can be compared
+     * for Go-getter-type equality. This is the single comparison primitive the dedupe decision uses,
+     * mirroring the model's `processTypeFieldForOptional`:
+     *   - the type mapper collapses Go-render-equivalent shapes (`list`/`set` -> `[]T`,
+     *     `optional`/`nullable` -> `*T`), and
+     *   - when `getters-pass-by-value` is enabled the model returns the DEREFERENCED type for an
+     *     optional/nullable field, so we render the unwrapped type here to match. Without this the
+     *     snippet would keep a base field the model dropped under that config, re-introducing drift.
+     *
+     * `packageName`/`importPath` are arbitrary: the result is only ever compared against another
+     * string produced by this same method, so any consistent values work, and rendering against a
+     * throwaway file means it never registers imports on real output.
+     */
+    private getGoGetterTypeString;
     private convertObject;
     private convertEnum;
     private getEnumValueName;

package/dist/index.d.ts

@@ -27,6 +27,57 @@ declare class DynamicTypeInstantiationMapper {
     private convertLiteralToOptionalPrimitive;
     private convertDiscriminatedUnion;
     private getBaseFields;
+    /**
+     * Returns the wire values of the union base properties that the Go model generator drops as
+     * top-level struct fields when `dedupeUnionBaseProperties` is enabled — mirroring the model's
+     * `unionInheritedBasePropertyNames` so the snippet and the generated model dedupe an identical
+     * set.
+     *
+     * The decision has a language-agnostic core and a thin Go-specific widening, exactly as in the
+     * model:
+     *   - Core: the IR marks (in `DiscriminatedUnionType.inheritedBaseProperties`, the dynamic-IR
+     *     mirror of `UnionTypeDeclaration.inheritedBaseProperties`) the base properties every
+     *     `samePropertiesAsObject` variant redeclares with a structurally-equal type. This is the
+     *     shared source of truth, so the decision is not re-derived per language.
+     *   - Go-render widening: Go additionally dedupes a base property that every variant redeclares
+     *     with a Go-RENDER-equivalent type (e.g. `list`/`set` both render `[]T`, `optional`/`nullable`
+     *     both `*T`) even though the IR's conservative structural equality left it unmarked; the
+     *     delegating getter still compiles, so the top-level field is safe to drop.
+     *
+     * Literal base properties are always kept at the union root (they render as `<Name>()` methods,
+     * not delegatable fields), matching the model. Base properties that a variant does not carry, or
+     * that a variant redeclares with a different Go getter type, keep their top-level field and must
+     * still be set at the union root, so they are excluded here.
+     *
+     * To stay in lockstep with the model, base<->variant properties are matched by Go field name (not
+     * wire value) via {@link getObjectExportedProperties}, and compared through
+     * {@link getGoGetterTypeString} — the single comparison primitive that renders a getter's Go type
+     * including the `getters-pass-by-value` `*`-stripping the model applies. Both the structural-core
+     * and the widening path route through it, so the two generators cannot drift.
+     */
+    private getDedupedBasePropertyWireValues;
+    /**
+     * Collects the properties an object exports, keyed by Go field name, following its `extends` chain
+     * (matching the model's `objectExportedProperties`). Extended properties are collected first so a
+     * property declared directly on the object overrides one inherited via `extends`, exactly as the
+     * model does. Empty for anything that does not resolve to an object.
+     */
+    private getObjectExportedProperties;
+    /**
+     * Renders the Go type a getter for `typeReference` would return, so two references can be compared
+     * for Go-getter-type equality. This is the single comparison primitive the dedupe decision uses,
+     * mirroring the model's `processTypeFieldForOptional`:
+     *   - the type mapper collapses Go-render-equivalent shapes (`list`/`set` -> `[]T`,
+     *     `optional`/`nullable` -> `*T`), and
+     *   - when `getters-pass-by-value` is enabled the model returns the DEREFERENCED type for an
+     *     optional/nullable field, so we render the unwrapped type here to match. Without this the
+     *     snippet would keep a base field the model dropped under that config, re-introducing drift.
+     *
+     * `packageName`/`importPath` are arbitrary: the result is only ever compared against another
+     * string produced by this same method, so any consistent values work, and rendering against a
+     * throwaway file means it never registers imports on real output.
+     */
+    private getGoGetterTypeString;
     private convertObject;
     private convertEnum;
     private getEnumValueName;