feat!: API refactor (#138)

Author: dnys1

examples/gemini/celest/functions/gemini.dart

@@ -6,9 +6,10 @@ import 'dart:convert';
 import 'package:celest/celest.dart';
 import 'package:google_generative_ai/google_generative_ai.dart';
 
-import '../resources.dart';
+import '../generated/resources.dart';
 
 /// Returns a list of available models.
+@cloud
 Future<List<String>> availableModels() async => _availableModels;
 
 /// The list of available models.
@@ -22,10 +23,11 @@ const _availableModels = [
 /// Prompts the Gemini [modelName] with the given [prompt] and [parameters].
 ///
 /// Returns the generated text.
+@cloud
 Future<String> generateContent({
   required String modelName,
   required String prompt,
-  @Env.geminiApiKey required String apiKey,
+  @env.geminiApiKey required String apiKey,
 }) async {
   if (!_availableModels.contains(modelName)) {
     throw BadRequestException('Invalid model: $modelName');
@@ -45,7 +47,7 @@ Future<String> generateContent({
       print('Selected answer: $text');
       return text;
     case _:
-      throw InternalServerException('Failed to generate content');
+      throw InternalServerError('Failed to generate content');
   }
 }
 

examples/gemini/celest/generated/README.md

@@ -0,0 +1,9 @@
+# Generated Celest code
+
+This directory contains code generated by the Celest CLI to assist in building
+your backend.
+
+This code can be safely checked into version control, but it should not be
+modified directly.
+
+It is planned to replace this directory with macros when they become stable.

examples/gemini/celest/resources.dart …s/gemini/celest/generated/resources.dartexamples/gemini/celest/resources.dart renamed to examples/gemini/celest/generated/resources.dart examples/gemini/celest/resources.dart renamed to examples/gemini/celest/generated/resources.dart

@@ -6,9 +6,9 @@ library;
 
 import 'package:celest/celest.dart';
 
-@Deprecated('Use `Env` instead.')
-typedef env = Env;
+@Deprecated('Use `env` instead.')
+typedef Env = env;
 
-abstract final class Env {
+abstract final class env {
   static const geminiApiKey = EnvironmentVariable(name: r'GEMINI_API_KEY');
 }

examples/gemini/celest/lib/src/client/functions.dart

@@ -31,9 +31,8 @@ class CelestFunctionsGemini {
         throw Serializers.instance.deserialize<BadRequestException>($details);
       case r'UnauthorizedException':
         throw Serializers.instance.deserialize<UnauthorizedException>($details);
-      case r'InternalServerException':
-        throw Serializers.instance
-            .deserialize<InternalServerException>($details);
+      case r'InternalServerError':
+        throw Serializers.instance.deserialize<InternalServerError>($details);
       case r'SerializationException':
         throw Serializers.instance
             .deserialize<SerializationException>($details);
@@ -56,7 +55,7 @@ class CelestFunctionsGemini {
           case 400:
             throw BadRequestException($code);
           case _:
-            throw InternalServerException($code);
+            throw InternalServerError($code);
         }
     }
   }

examples/gemini/celest/lib/src/client/serializers.dart

@@ -16,10 +16,10 @@ void initSerializers() {
     },
   ));
   Serializers.instance
-      .put(Serializer.define<InternalServerException, Map<String, Object?>>(
+      .put(Serializer.define<InternalServerError, Map<String, Object?>>(
     serialize: ($value) => {r'message': $value.message},
     deserialize: ($serialized) {
-      return InternalServerException(($serialized[r'message'] as String));
+      return InternalServerError(($serialized[r'message'] as String));
     },
   ));
   Serializers.instance

examples/openai/celest/functions/open_ai.dart

@@ -8,7 +8,7 @@ import 'package:celest_backend/models.dart';
 import 'package:chat_gpt_sdk/chat_gpt_sdk.dart';
 import 'package:chat_gpt_sdk/src/model/chat_complete/response/chat_choice.dart';
 
-import '../resources.dart';
+import '../generated/resources.dart';
 
 /// Creates an instance of the OpenAI client.
 OpenAI _createOpenAI(String token) => OpenAI.instance.build(
@@ -18,6 +18,7 @@ OpenAI _createOpenAI(String token) => OpenAI.instance.build(
     );
 
 /// Returns a list of available models.
+@cloud
 Future<List<String>> availableModels() async => _availableModels;
 
 /// The list of available models.
@@ -32,11 +33,12 @@ const _availableModels = [
 /// Prompts the GPT [model] with the given [prompt] and [parameters].
 ///
 /// Returns the generated text.
+@cloud
 Future<String> openAIRequest({
   required String model,
   required String prompt,
   ModelParameters parameters = const ModelParameters(),
-  @Env.openAiToken required String openAiToken,
+  @env.openAiToken required String openAiToken,
 }) async {
   final openAI = _createOpenAI(openAiToken);
 
@@ -63,7 +65,7 @@ Future<String> openAIRequest({
     case ChatCTResponse(choices: [ChatChoice(:final message?), ...]):
       return message.content.trim();
     default:
-      throw InternalServerException(
+      throw InternalServerError(
         "Couldn't complete request. Please try again later.",
       );
   }

examples/openai/celest/generated/README.md

@@ -0,0 +1,9 @@
+# Generated Celest code
+
+This directory contains code generated by the Celest CLI to assist in building
+your backend.
+
+This code can be safely checked into version control, but it should not be
+modified directly.
+
+It is planned to replace this directory with macros when they become stable.

examples/openai/celest/resources.dart …s/openai/celest/generated/resources.dartexamples/openai/celest/resources.dart renamed to examples/openai/celest/generated/resources.dart examples/openai/celest/resources.dart renamed to examples/openai/celest/generated/resources.dart

@@ -6,9 +6,9 @@ library;
 
 import 'package:celest/celest.dart';
 
-@Deprecated('Use `Env` instead.')
-typedef env = Env;
+@Deprecated('Use `env` instead.')
+typedef Env = env;
 
-abstract final class Env {
+abstract final class env {
   static const openAiToken = EnvironmentVariable(name: r'OPEN_AI_TOKEN');
 }

examples/openai/celest/lib/client.dart

@@ -16,15 +16,12 @@ import 'src/client/serializers.dart';
 final Celest celest = Celest();
 
 enum CelestEnvironment {
-  local,
-  production;
+  local;
 
   Uri get baseUri => switch (this) {
         local => kIsWeb || !_$io.Platform.isAndroid
             ? Uri.parse('http://localhost:7777')
             : Uri.parse('http://10.0.2.2:7777'),
-        production =>
-          Uri.parse('https://openai-example-xmfv-v76lntiq7q-wn.a.run.app'),
       };
 }
 

examples/openai/celest/lib/src/client/functions.dart

@@ -30,9 +30,8 @@ class CelestFunctionsOpenAi {
         throw Serializers.instance.deserialize<BadRequestException>($details);
       case r'UnauthorizedException':
         throw Serializers.instance.deserialize<UnauthorizedException>($details);
-      case r'InternalServerException':
-        throw Serializers.instance
-            .deserialize<InternalServerException>($details);
+      case r'InternalServerError':
+        throw Serializers.instance.deserialize<InternalServerError>($details);
       case r'SerializationException':
         throw Serializers.instance
             .deserialize<SerializationException>($details);
@@ -41,7 +40,7 @@ class CelestFunctionsOpenAi {
           case 400:
             throw BadRequestException($code);
           case _:
-            throw InternalServerException($code);
+            throw InternalServerError($code);
         }
     }
   }