Not found time.Time when generating module

[fkdp06]

Hi I have a question. After I upgraded wails from v2.8.1 to v2.13.0 and then run the command wails generate module I receive the following warnings in the terminal:

KnownStructs: di_plus.ServiceProvider   mods.AddContactForm     mods.AddNoteForm        mods.BootstrapInitForm  mods.BootstrapInitResult        mods.ContactItem        mods.ContactListItem    mods.ContactQueryForm   mods.EditContactForm    mods.EditNoteForm  mods.IdForm     mods.NoteItem   mods.NoteListItem       mods.NoteQueryForm      mods.UserSettingsForm
Not found: time.Time

Please note Not found: time.Time at the end.

I have the following example of the go struct:

type ContactListItem struct {
	IdItem
	AuditedItem
	ArchivableItem
	Name          string     `json:"name"`
	Description   string     `json:"description"`
	LastNoteDated *time.Time `json:"lastNoteDated"`
	AvgScore      *int       `json:"avgScore"`
}

And the TS result is:

export class ContactListItem {
	    id: string;
	    // Go type: time
	    createdTime: any;
	    // Go type: time
	    updatedTime: any;
	    archived: boolean;
	    name: string;
	    description: string;
	    // Go type: time
	    lastNoteDated?: any;
	    avgScore?: number;
	
	    static createFrom(source: any = {}) {
	        return new ContactListItem(source);
	    }
	
	    constructor(source: any = {}) {
	        if ('string' === typeof source) source = JSON.parse(source);
	        this.id = source["id"];
	        this.createdTime = this.convertValues(source["createdTime"], null);
	        this.updatedTime = this.convertValues(source["updatedTime"], null);
	        this.archived = source["archived"];
	        this.name = source["name"];
	        this.description = source["description"];
	        this.lastNoteDated = this.convertValues(source["lastNoteDated"], null);
	        this.avgScore = source["avgScore"];
	    }
	
		convertValues(a: any, classs: any, asMap: boolean = false): any {
		    if (!a) {
		        return a;
		    }
		    if (a.slice && a.map) {
		        return (a as any[]).map(elem => this.convertValues(elem, classs));
		    } else if ("object" === typeof a) {
		        if (asMap) {
		            for (const key of Object.keys(a)) {
		                a[key] = new classs(a[key]);
		            }
		            return a;
		        }
		        return new classs(a);
		    }
		    return a;
		}
	}

I have found there was a change to use Date instead of any but I see that is not working. Is there anything else needs to be configured, or maybe it's not an issue? But so far it would be nice to have Date instead of any.

Thank you.

wails doctor

Wails

┌───────────────────┐
| Version | v2.13.0 |
└───────────────────┘

System

┌───────────────────────────────────────────────────────────────────────┐
| OS | Windows 10 Home |
| Version | 2009 (Build: 26100) |
| ID | 24H2 |
| Branding | Windows 11 Home |
| Go Version | go1.26.5 |
| Platform | windows |
| Architecture | amd64 |
| CPU | Intel(R) Core(TM) i3-8100 CPU @ 3.60GHz |
| GPU | NVIDIA GeForce GT 1030 (NVIDIA) - Driver: 32.0.15.6094 |
| Memory | 24GB |
└───────────────────────────────────────────────────────────────────────┘

Dependencies

┌───────────────────────────────────────────────────────┐
| Dependency | Package Name | Status | Version |
| WebView2 | N/A | Installed | 147.0.3912.72 |
| Nodejs | N/A | Installed | 24.18.0 |
| npm | N/A | Installed | 11.18.0 |
| *upx | N/A | Available | |
| *nsis | N/A | Available | |
| |
└─────────────── * - Optional Dependency ───────────────┘

Diagnosis

Optional package(s) installation details:

• upx : Available at https://upx.github.io/
• nsis : More info at https://wails.io/docs/guides/windows-installer/

SUCCESS Your system is ready for Wails development!

[darekwojciechowski]

That line isn't an error — it's the binding generator telling you it has no dedicated TypeScript model for time.Time, so it falls back to any. That's exactly what you see in the output: // Go type: time and the field typed as any. Your module still generates fine.

The reason is time.Time is a struct from the standard library, not one of your own types, so Wails doesn't emit a class for it — it just can't map it to a named TS type and prints "Not found" while scanning. Nothing is broken.

At runtime a *time.Time comes across as a JSON string (RFC3339, like "2026-07-22T10:00:00Z"), so if you want a real type instead of any, treat it as a string on the TS side:

lastNoteDated?: string;

and parse it with new Date(lastNoteDated) where you need a Date. So the warning is safe to ignore; the only thing to decide is whether you'd rather hand-type those fields as string than leave them any.

[fkdp06]

Hasn't it been solved with this PR #5257 (comment) ? I am wondering why it's not a Date?

[darekwojciechowski]

Yeah, so #5257 never actually landed — it got closed, not merged. The reviewer's point was that it'd be Date in name only: time.Time still comes over as an RFC3339 string, so calling it Date kinda lies about what you actually get at runtime (and it broke interface mode too).

What shipped instead is a --time-type flag (string | Date), defaulting to string. That any is just the fallback when nothing matches. Want a real type? Regen with:

wails generate module --time-type Date

Peek at wails generate module --help to make sure it's on your version. Heads up though — even with Date, the value's still a string on the wire, so you gotta new Date(...) it yourself. The flag types the field, doesn't convert anything.

[rakeshutekar]

Nothing is broken — that message is a debug println, not an error, and time.Time isn't special-cased at all in v2. Here's the exact path it takes.

Why you get any

time.Time is a struct, so it lands in the struct branch of the field walker:

// v2/internal/typescriptify/typescriptify.go
} else if field.Type.Kind() == reflect.Struct {
    ...
    isKnownType := t.KnownStructs.Contains(getStructFQN(field.Type.String()))
    if !isKnownType {
        println("KnownStructs:", t.KnownStructs.Join("\t"))
        println("Not found:", getStructFQN(field.Type.String()))
    }
    builder.AddStructField(jsonFieldName, field, !isKnownType)

KnownStructs only contains the structs Wails collected from your bindings — mods.ContactItem, mods.NoteItem and so on. time.Time lives in the standard library and was never bound, so it isn't in that set, isKnownType is false, and the third argument (isAnyType) becomes true.

That flag is what produces your output:

func (t *typeScriptClassBuilder) addField(fld, fldType string, isAnyType bool) {
    ...
    if isAnyType {
        fldType = strings.Split(fldType, ".")[0]
        t.fields = append(t.fields, fmt.Sprint(t.indent, "// Go type: ", fldType, "\n", t.indent, fld, ": any;"))

The strings.Split(fldType, ".")[0] is also why the comment reads // Go type: time rather than time.Time. So the Not found: line and the any field are the same event — the generic "unknown struct" fallback — and it would fire identically for any non-bound struct type.

Getting Date (or string) in v2

The field walker checks for type overrides before it reaches the struct branch:

if fldOpts.TSTransform != "" {
    err = builder.AddSimpleField(jsonFieldName, field, fldOpts)
} else if _, isEnum := t.enums[field.Type]; isEnum {
    ...
} else if fldOpts.TSType != "" {
    err = builder.AddSimpleField(jsonFieldName, field, fldOpts)
} else if field.Type.Kind() == reflect.Struct {

and those options come from struct tags:

const (
    tsTransformTag = "ts_transform"
    tsType         = "ts_type"
)

opts := TypeOptions{TSTransform: field.Tag.Get(tsTransformTag), TSType: field.Tag.Get(tsType)}

So tag the fields. Since encoding/json marshals time.Time to an RFC 3339 string, the most truthful mapping is:

type ContactListItem struct {
    IdItem
    AuditedItem
    ArchivableItem
    Name          string     `json:"name"`
    Description   string     `json:"description"`
    LastNoteDated *time.Time `json:"lastNoteDated" ts_type:"string"`
    AvgScore      *int       `json:"avgScore"`
}

If you'd rather have a real Date object on the frontend, add a transform — __VALUE__ is substituted with the source expression:

LastNoteDated *time.Time `json:"lastNoteDated" ts_type:"Date" ts_transform:"new Date(__VALUE__)"`

That yields lastNoteDated?: Date; with new Date(source["lastNoteDated"]) in the constructor, instead of the convertValues(..., null) call you're seeing now.

One thing to watch: createdTime and updatedTime come from your embedded AuditedItem, so the tags have to go on the fields inside that struct, not on ContactListItem.

Why you couldn't find a global switch

There is a helper that would do this once for every time.Time:

// ManageType can define custom options for fields of a specified type.
//
// This can be used instead of setting ts_type and ts_transform for all fields of a certain type.
func (t *TypeScriptify) ManageType(fld interface{}, opts TypeOptions) *TypeScriptify {

but it's a method on the TypeScriptify value inside v2/internal/typescriptify, and wails generate module doesn't expose a hook to call it. So per-field tags are the only route from the CLI in v2.

About the change you found

The move to emit a proper time type is a v3 change — v3's generator has a dedicated path for it (v3/internal/generator/collect/special.go) rather than routing time.Time through the unknown-struct fallback. It isn't backported to v2, which is why upgrading from 2.8.1 to 2.13.0 didn't change the behaviour.