gae

Overview ¶

Package gae provides a Google Cloud Datastore session store for scs (alexedwards/scs/v2). It stores session data in Datastore with automatic expiration cleanup.

Usage ¶

client, _ := datastore.NewClient(ctx, projectID)
sessionStore := gae.NewGCDSessionStore(client, "", time.Hour) // cleanup every hour
session := scs.New()
session.Store = sessionStore

Datastore Kind ¶

Sessions are stored with the kind "AuthSession" and the following properties:

• Token: string (used as key name)
• ExpiresAt: time.Time (indexed for cleanup queries)
• Data: []byte (session data, noindex)

Namespacing ¶

The store supports Datastore namespaces for multi-tenant applications:

sessionStore := gae.NewGCDSessionStore(client, "tenant-123", time.Hour)

Package gae provides a Google Cloud Datastore implementation of the UsersService. It is designed for deployment on Google Cloud Platform and supports multi-tenancy through Datastore namespaces.

Datastore Kind ¶

Users are stored with the kind "User" and the following properties:

• id: string (used as key name, not stored as property)
• created_at, updated_at: timestamps
• name, description, email, image_url: strings
• tags: []string (noindex)
• extras: Struct (noindex, for app-specific data)

Namespacing ¶

The service supports Datastore namespaces for multi-tenant applications. Pass a namespace to NewUsersService to isolate data between tenants:

userService := gae.NewUsersService(client, "tenant-123")

Generated Code ¶

This package uses protoc-gen-dal-datastore generated code:

• UserDatastore: Datastore entity model
• UserDatastoreToUser/UserToUserDatastore: conversion functions
• UserDatastoreDAL: data access layer with CRUD operations

Usage ¶

client, _ := datastore.NewClient(ctx, projectID)
userService := gae.NewUsersService(client, "")  // default namespace
resp, err := userService.CreateUser(ctx, &v1.CreateUserRequest{
    User: &v1.User{Name: "John Doe", Email: "john@example.com"},
})