# Decorators

:::callout{theme="success"}
The following documentation is specific to TypeScript v1 functions. For more [robust capabilities](../language-feature-support/index.md#typescript-v1-vs-typescript-v2), including support for Ontology SDK and configurable resource requests, we recommend [migrating to TypeScript v2](../typescript-v2-migration/index.md).
:::

[TypeScript ↗](https://www.typescriptlang.org/docs/handbook/basic-types.html) functions are declared as methods of a [TypeScript class ↗](https://www.typescriptlang.org/docs/handbook/classes.html). There are a few requirements for a function to be discovered and published:

* The method must be `public`
* The class the method belongs to must be exported from the `functions-typescript/src/index.ts` file
* The method must be decorated with one of the following decorators imported from the `@foundry/functions-api` package:
  * `@Function()` for generic functions.
  * [`@OntologyEditFunction()`](../api-ontology-edits/index.md) for functions that will back an Action.
    * Object provenance information may be optionally specified with the `@Edits([object type])` decorator when using the [`@OntologyEditFunction()`](../api-ontology-edits/index.md) method.
    * Object provenance information will be inferred on a best-efforts basis using the static analysis of code if the `@Edits([object type])` decorator is absent.
  * [`@Query({ apiName: "userDefinedAPIName"})`](../query-functions/index.md) for read-only queries that you want to execute through [Foundry API](../../api/general/overview/introduction/index.md). This decorator should not be used in addition to the `@Function` decorator; it should be used on its own.

Here are examples of functions that are correctly exported in this way:

```typescript
import { Function, OntologyEditFunction, Query, Integer, Edits } from "@foundry/functions-api";
import { Employee, Objects, ObjectSet } from "@foundry/ontology-api";

export class MyUsefulFunctions {
    @Function()
    public incrementNumber(x: Integer): Integer {
        return x + 1;
    }

    @Edits(Employee)
    @OntologyEditFunction()
    public updateName(employee: Employee, newName: string): void {
        employee.firstName = newName;
    }

    @Query({ apiName: "getEmployeesByName" })
    public async getEmployeesByName(name: string): Promise<ObjectSet<Employee>> {
        return Objects.search().employee().filter(employee => employee.firstName.exactMatch(name));
    }
}
```

Any method that is private or not decorated with the relevant decorations will not be published to the function registry. This allows users to create helper functions and utilities for reuse or organization.

:::callout{theme="warning" title="Republishing"}
Each function in a TypeScript repository is uniquely defined by its class name and method name—if you change the name of the class or method, the function will be published under a new identifier.
:::