feat(db): add FunctionService for function versioning

[koxudaxi]

TL;DR

Added a new FunctionService class to manage function registration, versioning, and retrieval.

What changed?

Created a new file cloud/db/services/functions.ts that implements a FunctionService class with the following capabilities:

• registerOrGet: Registers a new function or retrieves an existing one, with automatic versioning logic
• getEnvironmentContext: Retrieves environment, project, and organization context
• getByHash: Retrieves a function by its hash within an environment
• getById: Retrieves a function by its ID
• list: Lists functions with filtering options for name, tags, and pagination

The service handles versioning automatically by:

• Starting at version 1.0 for new functions
• Incrementing the major version when the function signature changes
• Incrementing the minor version when only the implementation changes

How to test?

1. Create a new function using the registerOrGet method:

   const functionService = new FunctionService(db);
   const result = await Effect.runPromise(
     functionService.registerOrGet({
       code: "function example() { return 'hello'; }",
       hash: "abc123",
       signature: "function example(): string",
       signatureHash: "def456",
       name: "example"
     }, { environmentId: "env_123", projectId: "proj_456", organizationId: "org_789" })
   );

2. Retrieve a function by hash:

   const func = await Effect.runPromise(
     functionService.getByHash("abc123", "env_123")
   );

3. Test versioning by registering the same function with different implementations.

Why make this change?

This service provides a structured way to manage function registration with proper versioning semantics. It ensures that:

1. Functions are uniquely identified by their hash within an environment
2. Version numbers follow semantic versioning principles based on signature changes
3. Race conditions are handled properly using database transactions
4. Functions can be easily queried with various filters

The implementation uses Effect.js for error handling and provides clear error types for different failure scenarios.

[willbakst]

Merge activity

• Jan 6, 2:57 AM UTC: @willbakst merged this pull request with Graphite.