api/spec/packages/aip/src/shared/request.tsp

import "@typespec/rest";

namespace Shared;

@doc("{name} create request.", T)
@friendlyName("Create{name}Request", T)
@withVisibility(Lifecycle.Create)
model CreateRequest<T extends {}> is DefaultKeyVisibility<T, Lifecycle.Read>;

// Supports visibility filtering for models with nested fields.
@doc("{name} create request.", T)
@friendlyName("Create{name}Request", T)
model CreateRequestNested<T extends {}>
  is FilterVisibility<
    DefaultKeyVisibility<T, Lifecycle.Read>,
    #{ all: #[Lifecycle.Create] },
    "Create{name}"
  >;

@doc("{name} upsert request.", T)
@friendlyName("Upsert{name}Request", T)
@withVisibility(Lifecycle.Create, Lifecycle.Update)
model UpsertRequest<T extends {}> is DefaultKeyVisibility<T, Lifecycle.Read>;

@doc("{name} update request.", T)
@friendlyName("Update{name}Request", T)
@withVisibility(Lifecycle.Update)
model UpdateRequest<T extends {}>
  is OptionalProperties<UpdateableProperties<DefaultKeyVisibility<
    T,
    Lifecycle.Read
  >>>;

// Supports visibility filtering for models with nested fields.
@doc("{name} update request.", T)
@friendlyName("Update{name}Request", T)
model UpdateRequestNested<T extends {}>
  is FilterVisibility<
    DefaultKeyVisibility<T, Lifecycle.Read>,
    #{ all: #[Lifecycle.Update] },
    "Update{name}"
  >;