@rivascva/dt-idl 1.1.166 → 1.1.169

package/.github/workflows/deploy-db.yaml

@@ -0,0 +1,24 @@
+name: Deploy DB
+
+on:
+  push:
+    paths: ['supabase/**']
+    branches: [main]
+  workflow_dispatch:
+    # allows manual runs
+
+jobs:
+  migrate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: supabase/setup-cli@v1
+        with:
+          version: latest
+      - run: supabase link --project-ref ${{ secrets.SUPABASE_PROJECT_REF }}
+        env:
+          SUPABASE_ACCESS_TOKEN: ${{ secrets.SUPABASE_ACCESS_TOKEN }}
+      - run: supabase db push
+        env:
+          SUPABASE_ACCESS_TOKEN: ${{ secrets.SUPABASE_ACCESS_TOKEN }}
+          SUPABASE_DB_PASSWORD: ${{ secrets.SUPABASE_DB_PASSWORD }}

package/.github/workflows/{publish.yaml → publish-npm.yaml}

@@ -1,4 +1,4 @@
-name: Publish
+name: Publish NPM
 
 on:
   push:

package/.vscode/settings.json

@@ -1,9 +1,6 @@
 {
   "editor.defaultFormatter": "esbenp.prettier-vscode",
   "editor.formatOnSave": true,
-  "editor.codeActionsOnSave": {
-    "source.fixAll": "explicit"
-  },
   "editor.detectIndentation": false,
   "editor.tabSize": 2,
   "files.insertFinalNewline": true,

package/Makefile

@@ -7,3 +7,9 @@ lint:
 
 format:
 	golangci-lint run ./... --fix
+
+db-start:
+	supabase start
+
+db-stop:
+	supabase stop

package/README.md

@@ -4,7 +4,7 @@ The API language for all Dream Trade microservices.
 
 [![NPM Version](https://img.shields.io/npm/v/@rivascva/dt-idl.svg?style=flat)](https://www.npmjs.com/package/@rivascva/dt-idl)
 
-## Setup
+## Setup Project
 
 ### 1. Install `mise`
 
@@ -60,15 +60,40 @@ go mod tidy
 npm install
 ```
 
+## Setup Database
+
+### 1. Install Docker Desktop
+
+- Follow the official Docker installation [page](https://www.docker.com/products/docker-desktop)
+
+### 2. Configure Supabase
+
+- Login to your Supabase account
+
+```bash
+supabase login
+```
+
+- Link the Supabase project
+
+```bash
+supabase link
+```
+
+> Select the "DreamTrade" project when prompted
+
 ### Common Scripts
 
 - `npm run lint` - Lints all typescript files
 - `npm run check` - Checks the syntax of all typescript files
 - `npm run gen` - Generates typescript service clients
+- `make db-start` - Starts the local Supabase database
+- `make db-stop` - Stops the local Supabase database
 
 ### Deployments
 
-Any merge to `main` with changes to the `ts/*` and `go/*` directory will trigger an automatic deployment to `npm`
+- Any merge to `main` with changes to the `ts/*` and `go/*` directory will trigger an automatic deployment to `npm`
+- Any merge to `main` with changes to the `supabase/*` directory will trigger an automatic deployment to the remote database
 
 ### Go Package
 

package/dist/index.d.ts

@@ -1150,6 +1150,15 @@ interface operations$2 {
                     "application/json": components$2["schemas"]["Order"];
                 };
             };
+            /** @description Accepted */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": Record<string, never>;
+                };
+            };
             400: components$2["responses"]["BadRequest"];
             404: components$2["responses"]["NotFound"];
             500: components$2["responses"]["InternalServerError"];

package/go/redis/baserdb.go

@@ -13,12 +13,10 @@ import (
 type RDB interface {
 	// NewRDB creates a new redis database from the parent database.
 	NewRDB(database string) RDB
-	// Set sets the value for the given key.
-	Set(ctx context.Context, key string, value any) error
-	// MSet sets the values for the given entries of key-value pairs.
-	MSet(ctx context.Context, entries map[string]any) error
-	// SetWithExpiration sets the value for the given key with an expiration time.
-	SetWithExpiration(ctx context.Context, key string, value any, expiration time.Duration) error
+	// Set sets the value for the given key with the given expiration.
+	Set(ctx context.Context, key string, value any, expiration time.Duration) error
+	// MSet sets the values for the given entries of key-value pairs with the given expiration.
+	MSet(ctx context.Context, entries map[string]any, expiration time.Duration) error
 	// Get gets the value for the given key. It unmarshals the value into the given destination.
 	Get(ctx context.Context, key string, dest any) error
 	// MGet gets the values for the given keys. It unmarshals the values into the given destinations in the same order as the keys.
@@ -54,7 +52,7 @@ func (r *BaseRDB) NewRDB(database string) RDB {
 	}
 }
 
-func (r *BaseRDB) Set(ctx context.Context, key string, value any) error {
+func (r *BaseRDB) Set(ctx context.Context, key string, value any, expiration time.Duration) error {
 	// marshal the value into a JSON byte array
 	bytes, err := json.Marshal(value)
 	if err != nil {
@@ -62,7 +60,7 @@ func (r *BaseRDB) Set(ctx context.Context, key string, value any) error {
 	}
 
 	// set the value in the redis client
-	err = r.client.Set(ctx, FormatKey(r.database, key), bytes, 0).Err()
+	err = r.client.Set(ctx, FormatKey(r.database, key), bytes, expiration).Err()
 	if err != nil {
 		return fmt.Errorf("failed to set the value in the redis client: %w", err)
 	}
@@ -70,39 +68,29 @@ func (r *BaseRDB) Set(ctx context.Context, key string, value any) error {
 	return nil
 }
 
-func (r *BaseRDB) MSet(ctx context.Context, entries map[string]any) error {
-	// format the entries
-	args := make([]any, 0, len(entries)*2)
+func (r *BaseRDB) MSet(ctx context.Context, entries map[string]any, expiration time.Duration) error {
+	// check that there are entries to set
+	if len(entries) == 0 {
+		return fmt.Errorf("there are no entries to set")
+	}
+
+	// build a flat list of arguments for the lua script: [k1, v1, k2, v2, ..., expire_sec]
+	// the last element is the TTL in seconds. Zero or negative expire means no TTL.
+	scriptArgs := make([]any, 0, (len(entries)*2)+1)
 	for key, value := range entries {
 		bytes, err := json.Marshal(value)
 		if err != nil {
 			return fmt.Errorf("failed to marshal the value for key %s: %w", key, err)
 		}
-		args = append(args, FormatKey(r.database, key), bytes)
+		scriptArgs = append(scriptArgs, FormatKey(r.database, key), bytes)
 	}
+	scriptArgs = append(scriptArgs, int(expiration.Seconds()))
 
-	// set the entries in the redis client
-	err := r.client.MSet(ctx, args...).Err()
+	// run the lua script
+	err := MSetWithExpireScript.Run(ctx, r.client, []string{}, scriptArgs...).Err()
 	if err != nil {
 		return fmt.Errorf("failed to set the entries in the redis client: %w", err)
 	}
-
-	return nil
-}
-
-func (r *BaseRDB) SetWithExpiration(ctx context.Context, key string, value any, expiration time.Duration) error {
-	// marshal the value into a JSON byte array
-	bytes, err := json.Marshal(value)
-	if err != nil {
-		return fmt.Errorf("failed to marshal the value: %w", err)
-	}
-
-	// set the value in the redis client
-	err = r.client.Set(ctx, FormatKey(r.database, key), bytes, expiration).Err()
-	if err != nil {
-		return fmt.Errorf("failed to set the value in the redis client: %w", err)
-	}
-
 	return nil
 }
 

package/go/redis/models.go

@@ -1,6 +1,25 @@
 package redis
 
-import "errors"
+import (
+	"errors"
+
+	goredis "github.com/redis/go-redis/v9"
+)
 
 // ErrNotFound is returned when a value is not found in the redis database.
 var ErrNotFound = errors.New("value not found in the redis database")
+
+// MSetWithExpireScript is a local lua script that sets the value for the given key with the given expiration.
+var MSetWithExpireScript = goredis.NewScript(`
+local n = #ARGV - 1
+if n < 1 then return 'OK' end
+local expire = tonumber(ARGV[#ARGV])
+for i = 1, n, 2 do
+  if expire > 0 then
+    redis.call('SET', ARGV[i], ARGV[i+1], 'EX', expire)
+  else
+    redis.call('SET', ARGV[i], ARGV[i+1])
+  end
+end
+return 'OK'
+`)

package/mise.toml

@@ -3,3 +3,4 @@ go = "1.23"
 node = "22"
 pre-commit = "4.0"
 golangci-lint = "2.1"
+supabase = "2.78.1"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rivascva/dt-idl",
-  "version": "1.1.166",
+  "version": "1.1.169",
   "description": "Dream Trade - Interface Definition Language",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",

package/services/dt-trade-service.yaml

@@ -168,6 +168,12 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Order'
+        202:
+          description: Accepted
+          content:
+            application/json:
+              schema:
+                type: object
         400:
           $ref: '#/components/responses/BadRequest'
         404:

package/supabase/config.toml

@@ -0,0 +1,388 @@
+# For detailed configuration reference documentation, visit:
+# https://supabase.com/docs/guides/local-development/cli/config
+# A string used to distinguish different Supabase projects on the same host. Defaults to the
+# working directory name when running `supabase init`.
+project_id = "dt-idl"
+
+[api]
+enabled = true
+# Port to use for the API URL.
+port = 54321
+# Schemas to expose in your API. Tables, views and stored procedures in this schema will get API
+# endpoints. `public` and `graphql_public` schemas are included by default.
+schemas = ["public", "graphql_public"]
+# Extra schemas to add to the search_path of every request.
+extra_search_path = ["public", "extensions"]
+# The maximum number of rows returns from a view, table, or stored procedure. Limits payload size
+# for accidental or malicious requests.
+max_rows = 1000
+
+[api.tls]
+# Enable HTTPS endpoints locally using a self-signed certificate.
+enabled = false
+# Paths to self-signed certificate pair.
+# cert_path = "../certs/my-cert.pem"
+# key_path = "../certs/my-key.pem"
+
+[db]
+# Port to use for the local database URL.
+port = 54322
+# Port used by db diff command to initialize the shadow database.
+shadow_port = 54320
+# Maximum amount of time to wait for health check when starting the local database.
+health_timeout = "2m"
+# The database major version to use. This has to be the same as your remote database's. Run `SHOW
+# server_version;` on the remote database to check.
+major_version = 17
+
+[db.pooler]
+enabled = false
+# Port to use for the local connection pooler.
+port = 54329
+# Specifies when a server connection can be reused by other clients.
+# Configure one of the supported pooler modes: `transaction`, `session`.
+pool_mode = "transaction"
+# How many server connections to allow per user/database pair.
+default_pool_size = 20
+# Maximum number of client connections allowed.
+max_client_conn = 100
+
+# [db.vault]
+# secret_key = "env(SECRET_VALUE)"
+
+[db.migrations]
+# If disabled, migrations will be skipped during a db push or reset.
+enabled = true
+# Specifies an ordered list of schema files that describe your database.
+# Supports glob patterns relative to supabase directory: "./schemas/*.sql"
+schema_paths = []
+
+[db.seed]
+# If enabled, seeds the database after migrations during a db reset.
+enabled = true
+# Specifies an ordered list of seed files to load during db reset.
+# Supports glob patterns relative to supabase directory: "./seeds/*.sql"
+sql_paths = ["./seed.sql"]
+
+[db.network_restrictions]
+# Enable management of network restrictions.
+enabled = false
+# List of IPv4 CIDR blocks allowed to connect to the database.
+# Defaults to allow all IPv4 connections. Set empty array to block all IPs.
+allowed_cidrs = ["0.0.0.0/0"]
+# List of IPv6 CIDR blocks allowed to connect to the database.
+# Defaults to allow all IPv6 connections. Set empty array to block all IPs.
+allowed_cidrs_v6 = ["::/0"]
+
+# Uncomment to reject non-secure connections to the database.
+# [db.ssl_enforcement]
+# enabled = true
+
+[realtime]
+enabled = true
+# Bind realtime via either IPv4 or IPv6. (default: IPv4)
+# ip_version = "IPv6"
+# The maximum length in bytes of HTTP request headers. (default: 4096)
+# max_header_length = 4096
+
+[studio]
+enabled = true
+# Port to use for Supabase Studio.
+port = 54323
+# External URL of the API server that frontend connects to.
+api_url = "http://127.0.0.1"
+# OpenAI API Key to use for Supabase AI in the Supabase Studio.
+openai_api_key = "env(OPENAI_API_KEY)"
+
+# Email testing server. Emails sent with the local dev setup are not actually sent - rather, they
+# are monitored, and you can view the emails that would have been sent from the web interface.
+[inbucket]
+enabled = true
+# Port to use for the email testing server web interface.
+port = 54324
+# Uncomment to expose additional ports for testing user applications that send emails.
+# smtp_port = 54325
+# pop3_port = 54326
+# admin_email = "admin@email.com"
+# sender_name = "Admin"
+
+[storage]
+enabled = true
+# The maximum file size allowed (e.g. "5MB", "500KB").
+file_size_limit = "50MiB"
+
+# Uncomment to configure local storage buckets
+# [storage.buckets.images]
+# public = false
+# file_size_limit = "50MiB"
+# allowed_mime_types = ["image/png", "image/jpeg"]
+# objects_path = "./images"
+
+# Allow connections via S3 compatible clients
+[storage.s3_protocol]
+enabled = true
+
+# Image transformation API is available to Supabase Pro plan.
+# [storage.image_transformation]
+# enabled = true
+
+# Store analytical data in S3 for running ETL jobs over Iceberg Catalog
+# This feature is only available on the hosted platform.
+[storage.analytics]
+enabled = false
+max_namespaces = 5
+max_tables = 10
+max_catalogs = 2
+
+# Analytics Buckets is available to Supabase Pro plan.
+# [storage.analytics.buckets.my-warehouse]
+
+# Store vector embeddings in S3 for large and durable datasets
+# This feature is only available on the hosted platform.
+[storage.vector]
+enabled = false
+max_buckets = 10
+max_indexes = 5
+
+# Vector Buckets is available to Supabase Pro plan.
+# [storage.vector.buckets.documents-openai]
+
+[auth]
+enabled = true
+# The base URL of your website. Used as an allow-list for redirects and for constructing URLs used
+# in emails.
+site_url = "http://127.0.0.1:3000"
+# A list of *exact* URLs that auth providers are permitted to redirect to post authentication.
+additional_redirect_urls = ["https://127.0.0.1:3000"]
+# How long tokens are valid for, in seconds. Defaults to 3600 (1 hour), maximum 604,800 (1 week).
+jwt_expiry = 3600
+# JWT issuer URL. If not set, defaults to the local API URL (http://127.0.0.1:<port>/auth/v1).
+# jwt_issuer = ""
+# Path to JWT signing key. DO NOT commit your signing keys file to git.
+# signing_keys_path = "./signing_keys.json"
+# If disabled, the refresh token will never expire.
+enable_refresh_token_rotation = true
+# Allows refresh tokens to be reused after expiry, up to the specified interval in seconds.
+# Requires enable_refresh_token_rotation = true.
+refresh_token_reuse_interval = 10
+# Allow/disallow new user signups to your project.
+enable_signup = true
+# Allow/disallow anonymous sign-ins to your project.
+enable_anonymous_sign_ins = false
+# Allow/disallow testing manual linking of accounts
+enable_manual_linking = false
+# Passwords shorter than this value will be rejected as weak. Minimum 6, recommended 8 or more.
+minimum_password_length = 6
+# Passwords that do not meet the following requirements will be rejected as weak. Supported values
+# are: `letters_digits`, `lower_upper_letters_digits`, `lower_upper_letters_digits_symbols`
+password_requirements = ""
+
+[auth.rate_limit]
+# Number of emails that can be sent per hour. Requires auth.email.smtp to be enabled.
+email_sent = 2
+# Number of SMS messages that can be sent per hour. Requires auth.sms to be enabled.
+sms_sent = 30
+# Number of anonymous sign-ins that can be made per hour per IP address. Requires enable_anonymous_sign_ins = true.
+anonymous_users = 30
+# Number of sessions that can be refreshed in a 5 minute interval per IP address.
+token_refresh = 150
+# Number of sign up and sign-in requests that can be made in a 5 minute interval per IP address (excludes anonymous users).
+sign_in_sign_ups = 30
+# Number of OTP / Magic link verifications that can be made in a 5 minute interval per IP address.
+token_verifications = 30
+# Number of Web3 logins that can be made in a 5 minute interval per IP address.
+web3 = 30
+
+# Configure one of the supported captcha providers: `hcaptcha`, `turnstile`.
+# [auth.captcha]
+# enabled = true
+# provider = "hcaptcha"
+# secret = ""
+
+[auth.email]
+# Allow/disallow new user signups via email to your project.
+enable_signup = true
+# If enabled, a user will be required to confirm any email change on both the old, and new email
+# addresses. If disabled, only the new email is required to confirm.
+double_confirm_changes = true
+# If enabled, users need to confirm their email address before signing in.
+enable_confirmations = false
+# If enabled, users will need to reauthenticate or have logged in recently to change their password.
+secure_password_change = false
+# Controls the minimum amount of time that must pass before sending another signup confirmation or password reset email.
+max_frequency = "1s"
+# Number of characters used in the email OTP.
+otp_length = 6
+# Number of seconds before the email OTP expires (defaults to 1 hour).
+otp_expiry = 3600
+
+# Use a production-ready SMTP server
+# [auth.email.smtp]
+# enabled = true
+# host = "smtp.sendgrid.net"
+# port = 587
+# user = "apikey"
+# pass = "env(SENDGRID_API_KEY)"
+# admin_email = "admin@email.com"
+# sender_name = "Admin"
+
+# Uncomment to customize email template
+# [auth.email.template.invite]
+# subject = "You have been invited"
+# content_path = "./supabase/templates/invite.html"
+
+# Uncomment to customize notification email template
+# [auth.email.notification.password_changed]
+# enabled = true
+# subject = "Your password has been changed"
+# content_path = "./templates/password_changed_notification.html"
+
+[auth.sms]
+# Allow/disallow new user signups via SMS to your project.
+enable_signup = false
+# If enabled, users need to confirm their phone number before signing in.
+enable_confirmations = false
+# Template for sending OTP to users
+template = "Your code is {{ .Code }}"
+# Controls the minimum amount of time that must pass before sending another sms otp.
+max_frequency = "5s"
+
+# Use pre-defined map of phone number to OTP for testing.
+# [auth.sms.test_otp]
+# 4152127777 = "123456"
+
+# Configure logged in session timeouts.
+# [auth.sessions]
+# Force log out after the specified duration.
+# timebox = "24h"
+# Force log out if the user has been inactive longer than the specified duration.
+# inactivity_timeout = "8h"
+
+# This hook runs before a new user is created and allows developers to reject the request based on the incoming user object.
+# [auth.hook.before_user_created]
+# enabled = true
+# uri = "pg-functions://postgres/auth/before-user-created-hook"
+
+# This hook runs before a token is issued and allows you to add additional claims based on the authentication method used.
+# [auth.hook.custom_access_token]
+# enabled = true
+# uri = "pg-functions://<database>/<schema>/<hook_name>"
+
+# Configure one of the supported SMS providers: `twilio`, `twilio_verify`, `messagebird`, `textlocal`, `vonage`.
+[auth.sms.twilio]
+enabled = false
+account_sid = ""
+message_service_sid = ""
+# DO NOT commit your Twilio auth token to git. Use environment variable substitution instead:
+auth_token = "env(SUPABASE_AUTH_SMS_TWILIO_AUTH_TOKEN)"
+
+# Multi-factor-authentication is available to Supabase Pro plan.
+[auth.mfa]
+# Control how many MFA factors can be enrolled at once per user.
+max_enrolled_factors = 10
+
+# Control MFA via App Authenticator (TOTP)
+[auth.mfa.totp]
+enroll_enabled = false
+verify_enabled = false
+
+# Configure MFA via Phone Messaging
+[auth.mfa.phone]
+enroll_enabled = false
+verify_enabled = false
+otp_length = 6
+template = "Your code is {{ .Code }}"
+max_frequency = "5s"
+
+# Configure MFA via WebAuthn
+# [auth.mfa.web_authn]
+# enroll_enabled = true
+# verify_enabled = true
+
+# Use an external OAuth provider. The full list of providers are: `apple`, `azure`, `bitbucket`,
+# `discord`, `facebook`, `github`, `gitlab`, `google`, `keycloak`, `linkedin_oidc`, `notion`, `twitch`,
+# `twitter`, `x`, `slack`, `spotify`, `workos`, `zoom`.
+[auth.external.apple]
+enabled = false
+client_id = ""
+# DO NOT commit your OAuth provider secret to git. Use environment variable substitution instead:
+secret = "env(SUPABASE_AUTH_EXTERNAL_APPLE_SECRET)"
+# Overrides the default auth redirectUrl.
+redirect_uri = ""
+# Overrides the default auth provider URL. Used to support self-hosted gitlab, single-tenant Azure,
+# or any other third-party OIDC providers.
+url = ""
+# If enabled, the nonce check will be skipped. Required for local sign in with Google auth.
+skip_nonce_check = false
+# If enabled, it will allow the user to successfully authenticate when the provider does not return an email address.
+email_optional = false
+
+# Allow Solana wallet holders to sign in to your project via the Sign in with Solana (SIWS, EIP-4361) standard.
+# You can configure "web3" rate limit in the [auth.rate_limit] section and set up [auth.captcha] if self-hosting.
+[auth.web3.solana]
+enabled = false
+
+# Use Firebase Auth as a third-party provider alongside Supabase Auth.
+[auth.third_party.firebase]
+enabled = false
+# project_id = "my-firebase-project"
+
+# Use Auth0 as a third-party provider alongside Supabase Auth.
+[auth.third_party.auth0]
+enabled = false
+# tenant = "my-auth0-tenant"
+# tenant_region = "us"
+
+# Use AWS Cognito (Amplify) as a third-party provider alongside Supabase Auth.
+[auth.third_party.aws_cognito]
+enabled = false
+# user_pool_id = "my-user-pool-id"
+# user_pool_region = "us-east-1"
+
+# Use Clerk as a third-party provider alongside Supabase Auth.
+[auth.third_party.clerk]
+enabled = false
+# Obtain from https://clerk.com/setup/supabase
+# domain = "example.clerk.accounts.dev"
+
+# OAuth server configuration
+[auth.oauth_server]
+# Enable OAuth server functionality
+enabled = false
+# Path for OAuth consent flow UI
+authorization_url_path = "/oauth/consent"
+# Allow dynamic client registration
+allow_dynamic_registration = false
+
+[edge_runtime]
+enabled = true
+# Supported request policies: `oneshot`, `per_worker`.
+# `per_worker` (default) — enables hot reload during local development.
+# `oneshot` — fallback mode if hot reload causes issues (e.g. in large repos or with symlinks).
+policy = "per_worker"
+# Port to attach the Chrome inspector for debugging edge functions.
+inspector_port = 8083
+# The Deno major version to use.
+deno_version = 2
+
+# [edge_runtime.secrets]
+# secret_key = "env(SECRET_VALUE)"
+
+[analytics]
+enabled = true
+port = 54327
+# Configure one of the supported backends: `postgres`, `bigquery`.
+backend = "postgres"
+
+# Experimental features may be deprecated any time
+[experimental]
+# Configures Postgres storage engine to use OrioleDB (S3)
+orioledb_version = ""
+# Configures S3 bucket URL, eg. <bucket_name>.s3-<region>.amazonaws.com
+s3_host = "env(S3_HOST)"
+# Configures S3 bucket region, eg. us-east-1
+s3_region = "env(S3_REGION)"
+# Configures AWS_ACCESS_KEY_ID for S3 bucket
+s3_access_key = "env(S3_ACCESS_KEY)"
+# Configures AWS_SECRET_ACCESS_KEY for S3 bucket
+s3_secret_key = "env(S3_SECRET_KEY)"

package/supabase/migrations/20260314064047_initial_setup.sql

@@ -0,0 +1,39 @@
+-- Custom Functions
+
+CREATE OR REPLACE FUNCTION trigger_date_updated()
+RETURNS TRIGGER AS $$
+BEGIN
+  NEW.date_updated = now();
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+-- Users Table
+
+CREATE TABLE users (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    email TEXT NOT NULL UNIQUE,
+    name TEXT NOT NULL,
+    country TEXT NOT NULL,
+    image_url TEXT NULL,
+    platform TEXT NULL,
+    app_version TEXT NULL,
+    fcm_token TEXT NULL,
+    date_created TIMESTAMPTZ DEFAULT now() NOT NULL,
+    date_updated TIMESTAMPTZ DEFAULT now() NOT NULL
+);
+
+CREATE TRIGGER update_date_updated BEFORE UPDATE ON users FOR EACH ROW EXECUTE PROCEDURE trigger_date_updated();
+
+-- Refresh Tokens Table
+
+CREATE TABLE refresh_tokens (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    user_id UUID REFERENCES users(id) NOT NULL,
+    token TEXT NOT NULL,
+    date_created TIMESTAMPTZ DEFAULT now() NOT NULL,
+    date_updated TIMESTAMPTZ DEFAULT now() NOT NULL,
+    date_expired TIMESTAMPTZ NOT NULL
+);
+
+CREATE TRIGGER update_date_updated BEFORE UPDATE ON refresh_tokens FOR EACH ROW EXECUTE PROCEDURE trigger_date_updated();

package/supabase/migrations/20260318024829_setup_trade_service.sql

@@ -0,0 +1,57 @@
+-- Portfolios Table
+
+CREATE TABLE portfolios (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    user_id UUID NOT NULL,
+    type TEXT NOT NULL,
+    cash FLOAT NOT NULL,
+    favorite_symbols TEXT[] NOT NULL,
+    date_created TIMESTAMPTZ DEFAULT now() NOT NULL,
+    date_updated TIMESTAMPTZ DEFAULT now() NOT NULL
+);
+
+CREATE TRIGGER update_date_updated BEFORE UPDATE ON portfolios FOR EACH ROW EXECUTE PROCEDURE trigger_date_updated();
+
+-- Orders Table
+
+CREATE TABLE orders (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    portfolio_id UUID REFERENCES portfolios(id) NOT NULL,
+    type TEXT NOT NULL,
+    symbol TEXT NOT NULL,
+    shares INTEGER NOT NULL,
+    target_price FLOAT NOT NULL,
+    final_price FLOAT NULL,
+    date_executed TIMESTAMPTZ NULL,
+    date_created TIMESTAMPTZ DEFAULT now() NOT NULL,
+    date_updated TIMESTAMPTZ DEFAULT now() NOT NULL
+);
+
+CREATE TRIGGER update_date_updated BEFORE UPDATE ON orders FOR EACH ROW EXECUTE PROCEDURE trigger_date_updated();
+
+-- Holdings Table
+
+CREATE TABLE holdings (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    portfolio_id UUID REFERENCES portfolios(id) NOT NULL,
+    symbol TEXT NOT NULL,
+    shares INTEGER NOT NULL,
+    average_price FLOAT NOT NULL,
+    date_created TIMESTAMPTZ DEFAULT now() NOT NULL,
+    date_updated TIMESTAMPTZ DEFAULT now() NOT NULL
+);
+
+CREATE TRIGGER update_date_updated BEFORE UPDATE ON holdings FOR EACH ROW EXECUTE PROCEDURE trigger_date_updated();
+
+-- Portfolio History Values Table
+
+CREATE TABLE portfolio_history_values (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    portfolio_id UUID REFERENCES portfolios(id) NOT NULL,
+    cash FLOAT NOT NULL,
+    total_value FLOAT NOT NULL,
+    date_created TIMESTAMPTZ DEFAULT now() NOT NULL,
+    date_updated TIMESTAMPTZ DEFAULT now() NOT NULL
+);
+
+CREATE TRIGGER update_date_updated BEFORE UPDATE ON portfolio_history_values FOR EACH ROW EXECUTE PROCEDURE trigger_date_updated();

package/supabase/seed.sql

@@ -0,0 +1,34 @@
+INSERT INTO users (id, email, name, country) VALUES
+    ('99999999-9999-9999-9999-999999999999', 'sam.smith@example.com', 'Sam Smith', 'USA'),
+    ('88888888-8888-8888-8888-888888888888', 'jane.doe@example.com', 'Jane Doe', 'MEX');
+
+INSERT INTO portfolios (id, user_id, type, cash, favorite_symbols) VALUES
+    ('99999999-9999-9999-9999-999999999999', '99999999-9999-9999-9999-999999999999', 'PERSONAL', 50000, ARRAY['AAPL', 'MSFT']),
+    ('88888888-8888-8888-8888-888888888888', '88888888-8888-8888-8888-888888888888', 'PERSONAL', 50000, ARRAY['GOOGL', 'AMZN']);
+
+INSERT INTO orders (portfolio_id, type, symbol, shares, target_price, final_price, date_executed) VALUES
+    ('99999999-9999-9999-9999-999999999999', 'BUY_MARKET', 'AAPL', 10, 95.10, 95.15, now()),
+    ('99999999-9999-9999-9999-999999999999', 'BUY_MARKET', 'MSFT', 35, 115.20, NULL, NULL),
+    ('88888888-8888-8888-8888-888888888888', 'BUY_MARKET', 'MSFT', 35, 115.20, 115.25, now()),
+    ('88888888-8888-8888-8888-888888888888', 'BUY_MARKET', 'AAPL', 10, 95.10, NULL, NULL);
+
+INSERT INTO holdings (portfolio_id, symbol, shares, average_price) VALUES
+    ('99999999-9999-9999-9999-999999999999', 'AAPL', 10, 95.15),
+    ('88888888-8888-8888-8888-888888888888', 'MSFT', 35, 115.25);
+
+INSERT INTO portfolio_history_values (portfolio_id, cash, total_value, date_created, date_updated) VALUES
+    ('99999999-9999-9999-9999-999999999999', 1200, 35000, now() - interval '150 minutes', now() - interval '150 minutes'),
+    ('99999999-9999-9999-9999-999999999999', 2400, 40000, now() - interval '135 minutes', now() - interval '135 minutes'),
+    ('99999999-9999-9999-9999-999999999999', 3600, 45000, now() - interval '120 minutes', now() - interval '120 minutes'),
+    ('99999999-9999-9999-9999-999999999999', 3600, 42500, now() - interval '105 minutes', now() - interval '105 minutes'),
+    ('99999999-9999-9999-9999-999999999999', 3600, 39000, now() - interval '90 minutes', now() - interval '90 minutes'),
+    ('99999999-9999-9999-9999-999999999999', 3000, 43000, now() - interval '75 minutes', now() - interval '75 minutes'),
+    ('99999999-9999-9999-9999-999999999999', 3200, 48000, now() - interval '60 minutes', now() - interval '60 minutes'),
+    ('99999999-9999-9999-9999-999999999999', 3200, 47000, now() - interval '45 minutes', now() - interval '45 minutes'),
+    ('99999999-9999-9999-9999-999999999999', 2700, 52000, now() - interval '30 minutes', now() - interval '30 minutes'),
+    ('99999999-9999-9999-9999-999999999999', 2700, 52500, now() - interval '15 minutes', now() - interval '15 minutes'),
+    ('88888888-8888-8888-8888-888888888888', 2500, 32000, now() - interval '75 minutes', now() - interval '75 minutes'),
+    ('88888888-8888-8888-8888-888888888888', 1500, 28000, now() - interval '60 minutes', now() - interval '60 minutes'),
+    ('88888888-8888-8888-8888-888888888888', 1400, 25000, now() - interval '45 minutes', now() - interval '45 minutes'),
+    ('88888888-8888-8888-8888-888888888888', 1200, 22000, now() - interval '30 minutes', now() - interval '30 minutes'),
+    ('88888888-8888-8888-8888-888888888888', 1000, 20000, now() - interval '15 minutes', now() - interval '15 minutes');

package/ts/services/dt-trade-service.ts

@@ -467,6 +467,15 @@ export interface operations {
                     "application/json": components["schemas"]["Order"];
                 };
             };
+            /** @description Accepted */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": Record<string, never>;
+                };
+            };
             400: components["responses"]["BadRequest"];
             404: components["responses"]["NotFound"];
             500: components["responses"]["InternalServerError"];